deepseek.rs

  1use anyhow::{Result, anyhow};
  2use collections::{BTreeMap, HashMap};
  3use deepseek::DEEPSEEK_API_URL;
  4
  5use futures::Stream;
  6use futures::{FutureExt, StreamExt, future::BoxFuture, stream::BoxStream};
  7use gpui::{AnyView, App, AsyncApp, Context, Entity, SharedString, Task, Window};
  8use http_client::HttpClient;
  9use language_model::{
 10    ApiKeyState, AuthenticateError, EnvVar, IconOrSvg, LanguageModel, LanguageModelCompletionError,
 11    LanguageModelCompletionEvent, LanguageModelId, LanguageModelName, LanguageModelProvider,
 12    LanguageModelProviderId, LanguageModelProviderName, LanguageModelProviderState,
 13    LanguageModelRequest, LanguageModelToolChoice, LanguageModelToolResultContent,
 14    LanguageModelToolUse, MessageContent, RateLimiter, Role, StopReason, TokenUsage, env_var,
 15};
 16pub use settings::DeepseekAvailableModel as AvailableModel;
 17use settings::{Settings, SettingsStore};
 18use std::pin::Pin;
 19use std::str::FromStr;
 20use std::sync::{Arc, LazyLock};
 21
 22use ui::{ButtonLink, ConfiguredApiCard, List, ListBulletItem, prelude::*};
 23use ui_input::InputField;
 24use util::ResultExt;
 25
 26const PROVIDER_ID: LanguageModelProviderId = LanguageModelProviderId::new("deepseek");
 27const PROVIDER_NAME: LanguageModelProviderName = LanguageModelProviderName::new("DeepSeek");
 28
 29const API_KEY_ENV_VAR_NAME: &str = "DEEPSEEK_API_KEY";
 30static API_KEY_ENV_VAR: LazyLock<EnvVar> = env_var!(API_KEY_ENV_VAR_NAME);
 31
 32#[derive(Default)]
 33struct RawToolCall {
 34    id: String,
 35    name: String,
 36    arguments: String,
 37}
 38
 39#[derive(Default, Clone, Debug, PartialEq)]
 40pub struct DeepSeekSettings {
 41    pub api_url: String,
 42    pub available_models: Vec<AvailableModel>,
 43}
 44pub struct DeepSeekLanguageModelProvider {
 45    http_client: Arc<dyn HttpClient>,
 46    state: Entity<State>,
 47}
 48
 49pub struct State {
 50    api_key_state: ApiKeyState,
 51}
 52
 53impl State {
 54    fn is_authenticated(&self) -> bool {
 55        self.api_key_state.has_key()
 56    }
 57
 58    fn set_api_key(&mut self, api_key: Option<String>, cx: &mut Context<Self>) -> Task<Result<()>> {
 59        let api_url = DeepSeekLanguageModelProvider::api_url(cx);
 60        self.api_key_state
 61            .store(api_url, api_key, |this| &mut this.api_key_state, cx)
 62    }
 63
 64    fn authenticate(&mut self, cx: &mut Context<Self>) -> Task<Result<(), AuthenticateError>> {
 65        let api_url = DeepSeekLanguageModelProvider::api_url(cx);
 66        self.api_key_state
 67            .load_if_needed(api_url, |this| &mut this.api_key_state, cx)
 68    }
 69}
 70
 71impl DeepSeekLanguageModelProvider {
 72    pub fn new(http_client: Arc<dyn HttpClient>, cx: &mut App) -> Self {
 73        let state = cx.new(|cx| {
 74            cx.observe_global::<SettingsStore>(|this: &mut State, cx| {
 75                let api_url = Self::api_url(cx);
 76                this.api_key_state
 77                    .handle_url_change(api_url, |this| &mut this.api_key_state, cx);
 78                cx.notify();
 79            })
 80            .detach();
 81            State {
 82                api_key_state: ApiKeyState::new(Self::api_url(cx), (*API_KEY_ENV_VAR).clone()),
 83            }
 84        });
 85
 86        Self { http_client, state }
 87    }
 88
 89    fn create_language_model(&self, model: deepseek::Model) -> Arc<dyn LanguageModel> {
 90        Arc::new(DeepSeekLanguageModel {
 91            id: LanguageModelId::from(model.id().to_string()),
 92            model,
 93            state: self.state.clone(),
 94            http_client: self.http_client.clone(),
 95            request_limiter: RateLimiter::new(4),
 96        })
 97    }
 98
 99    fn settings(cx: &App) -> &DeepSeekSettings {
100        &crate::AllLanguageModelSettings::get_global(cx).deepseek
101    }
102
103    fn api_url(cx: &App) -> SharedString {
104        let api_url = &Self::settings(cx).api_url;
105        if api_url.is_empty() {
106            DEEPSEEK_API_URL.into()
107        } else {
108            SharedString::new(api_url.as_str())
109        }
110    }
111}
112
113impl LanguageModelProviderState for DeepSeekLanguageModelProvider {
114    type ObservableEntity = State;
115
116    fn observable_entity(&self) -> Option<Entity<Self::ObservableEntity>> {
117        Some(self.state.clone())
118    }
119}
120
121impl LanguageModelProvider for DeepSeekLanguageModelProvider {
122    fn id(&self) -> LanguageModelProviderId {
123        PROVIDER_ID
124    }
125
126    fn name(&self) -> LanguageModelProviderName {
127        PROVIDER_NAME
128    }
129
130    fn icon(&self) -> IconOrSvg {
131        IconOrSvg::Icon(IconName::AiDeepSeek)
132    }
133
134    fn default_model(&self, _cx: &App) -> Option<Arc<dyn LanguageModel>> {
135        Some(self.create_language_model(deepseek::Model::default()))
136    }
137
138    fn default_fast_model(&self, _cx: &App) -> Option<Arc<dyn LanguageModel>> {
139        Some(self.create_language_model(deepseek::Model::default_fast()))
140    }
141
142    fn provided_models(&self, cx: &App) -> Vec<Arc<dyn LanguageModel>> {
143        let mut models = BTreeMap::default();
144
145        models.insert("deepseek-chat", deepseek::Model::Chat);
146        models.insert("deepseek-reasoner", deepseek::Model::Reasoner);
147
148        for available_model in &Self::settings(cx).available_models {
149            models.insert(
150                &available_model.name,
151                deepseek::Model::Custom {
152                    name: available_model.name.clone(),
153                    display_name: available_model.display_name.clone(),
154                    max_tokens: available_model.max_tokens,
155                    max_output_tokens: available_model.max_output_tokens,
156                },
157            );
158        }
159
160        models
161            .into_values()
162            .map(|model| self.create_language_model(model))
163            .collect()
164    }
165
166    fn is_authenticated(&self, cx: &App) -> bool {
167        self.state.read(cx).is_authenticated()
168    }
169
170    fn authenticate(&self, cx: &mut App) -> Task<Result<(), AuthenticateError>> {
171        self.state.update(cx, |state, cx| state.authenticate(cx))
172    }
173
174    fn configuration_view(
175        &self,
176        _target_agent: language_model::ConfigurationViewTargetAgent,
177        window: &mut Window,
178        cx: &mut App,
179    ) -> AnyView {
180        cx.new(|cx| ConfigurationView::new(self.state.clone(), window, cx))
181            .into()
182    }
183
184    fn reset_credentials(&self, cx: &mut App) -> Task<Result<()>> {
185        self.state
186            .update(cx, |state, cx| state.set_api_key(None, cx))
187    }
188}
189
190pub struct DeepSeekLanguageModel {
191    id: LanguageModelId,
192    model: deepseek::Model,
193    state: Entity<State>,
194    http_client: Arc<dyn HttpClient>,
195    request_limiter: RateLimiter,
196}
197
198impl DeepSeekLanguageModel {
199    fn stream_completion(
200        &self,
201        request: deepseek::Request,
202        bypass_rate_limit: bool,
203        cx: &AsyncApp,
204    ) -> BoxFuture<'static, Result<BoxStream<'static, Result<deepseek::StreamResponse>>>> {
205        let http_client = self.http_client.clone();
206
207        let (api_key, api_url) = self.state.read_with(cx, |state, cx| {
208            let api_url = DeepSeekLanguageModelProvider::api_url(cx);
209            (state.api_key_state.key(&api_url), api_url)
210        });
211
212        let future = self.request_limiter.stream_with_bypass(
213            async move {
214                let Some(api_key) = api_key else {
215                    return Err(LanguageModelCompletionError::NoApiKey {
216                        provider: PROVIDER_NAME,
217                    });
218                };
219                let request =
220                    deepseek::stream_completion(http_client.as_ref(), &api_url, &api_key, request);
221                let response = request.await?;
222                Ok(response)
223            },
224            bypass_rate_limit,
225        );
226
227        async move { Ok(future.await?.boxed()) }.boxed()
228    }
229}
230
231impl LanguageModel for DeepSeekLanguageModel {
232    fn id(&self) -> LanguageModelId {
233        self.id.clone()
234    }
235
236    fn name(&self) -> LanguageModelName {
237        LanguageModelName::from(self.model.display_name().to_string())
238    }
239
240    fn provider_id(&self) -> LanguageModelProviderId {
241        PROVIDER_ID
242    }
243
244    fn provider_name(&self) -> LanguageModelProviderName {
245        PROVIDER_NAME
246    }
247
248    fn supports_tools(&self) -> bool {
249        true
250    }
251
252    fn supports_tool_choice(&self, _choice: LanguageModelToolChoice) -> bool {
253        true
254    }
255
256    fn supports_images(&self) -> bool {
257        false
258    }
259
260    fn telemetry_id(&self) -> String {
261        format!("deepseek/{}", self.model.id())
262    }
263
264    fn max_token_count(&self) -> u64 {
265        self.model.max_token_count()
266    }
267
268    fn max_output_tokens(&self) -> Option<u64> {
269        self.model.max_output_tokens()
270    }
271
272    fn count_tokens(
273        &self,
274        request: LanguageModelRequest,
275        cx: &App,
276    ) -> BoxFuture<'static, Result<u64>> {
277        cx.background_spawn(async move {
278            let messages = request
279                .messages
280                .into_iter()
281                .map(|message| tiktoken_rs::ChatCompletionRequestMessage {
282                    role: match message.role {
283                        Role::User => "user".into(),
284                        Role::Assistant => "assistant".into(),
285                        Role::System => "system".into(),
286                    },
287                    content: Some(message.string_contents()),
288                    name: None,
289                    function_call: None,
290                })
291                .collect::<Vec<_>>();
292
293            tiktoken_rs::num_tokens_from_messages("gpt-4", &messages).map(|tokens| tokens as u64)
294        })
295        .boxed()
296    }
297
298    fn stream_completion(
299        &self,
300        request: LanguageModelRequest,
301        cx: &AsyncApp,
302    ) -> BoxFuture<
303        'static,
304        Result<
305            BoxStream<'static, Result<LanguageModelCompletionEvent, LanguageModelCompletionError>>,
306            LanguageModelCompletionError,
307        >,
308    > {
309        let bypass_rate_limit = request.bypass_rate_limit;
310        let request = into_deepseek(request, &self.model, self.max_output_tokens());
311        let stream = self.stream_completion(request, bypass_rate_limit, cx);
312
313        async move {
314            let mapper = DeepSeekEventMapper::new();
315            Ok(mapper.map_stream(stream.await?).boxed())
316        }
317        .boxed()
318    }
319}
320
321pub fn into_deepseek(
322    request: LanguageModelRequest,
323    model: &deepseek::Model,
324    max_output_tokens: Option<u64>,
325) -> deepseek::Request {
326    let is_reasoner = model == &deepseek::Model::Reasoner;
327
328    let mut messages = Vec::new();
329    let mut current_reasoning: Option<String> = None;
330
331    for message in request.messages {
332        for content in message.content {
333            match content {
334                MessageContent::Text(text) => messages.push(match message.role {
335                    Role::User => deepseek::RequestMessage::User { content: text },
336                    Role::Assistant => deepseek::RequestMessage::Assistant {
337                        content: Some(text),
338                        tool_calls: Vec::new(),
339                        reasoning_content: current_reasoning.take(),
340                    },
341                    Role::System => deepseek::RequestMessage::System { content: text },
342                }),
343                MessageContent::Thinking { text, .. } => {
344                    // Accumulate reasoning content for next assistant message
345                    current_reasoning.get_or_insert_default().push_str(&text);
346                }
347                MessageContent::RedactedThinking(_) => {}
348                MessageContent::Image(_) => {}
349                MessageContent::ToolUse(tool_use) => {
350                    let tool_call = deepseek::ToolCall {
351                        id: tool_use.id.to_string(),
352                        content: deepseek::ToolCallContent::Function {
353                            function: deepseek::FunctionContent {
354                                name: tool_use.name.to_string(),
355                                arguments: serde_json::to_string(&tool_use.input)
356                                    .unwrap_or_default(),
357                            },
358                        },
359                    };
360
361                    if let Some(deepseek::RequestMessage::Assistant { tool_calls, .. }) =
362                        messages.last_mut()
363                    {
364                        tool_calls.push(tool_call);
365                    } else {
366                        messages.push(deepseek::RequestMessage::Assistant {
367                            content: None,
368                            tool_calls: vec![tool_call],
369                            reasoning_content: current_reasoning.take(),
370                        });
371                    }
372                }
373                MessageContent::ToolResult(tool_result) => {
374                    match &tool_result.content {
375                        LanguageModelToolResultContent::Text(text) => {
376                            messages.push(deepseek::RequestMessage::Tool {
377                                content: text.to_string(),
378                                tool_call_id: tool_result.tool_use_id.to_string(),
379                            });
380                        }
381                        LanguageModelToolResultContent::Image(_) => {}
382                    };
383                }
384            }
385        }
386    }
387
388    deepseek::Request {
389        model: model.id().to_string(),
390        messages,
391        stream: true,
392        max_tokens: max_output_tokens,
393        temperature: if is_reasoner {
394            None
395        } else {
396            request.temperature
397        },
398        response_format: None,
399        tools: request
400            .tools
401            .into_iter()
402            .map(|tool| deepseek::ToolDefinition::Function {
403                function: deepseek::FunctionDefinition {
404                    name: tool.name,
405                    description: Some(tool.description),
406                    parameters: Some(tool.input_schema),
407                },
408            })
409            .collect(),
410    }
411}
412
413pub struct DeepSeekEventMapper {
414    tool_calls_by_index: HashMap<usize, RawToolCall>,
415}
416
417impl DeepSeekEventMapper {
418    pub fn new() -> Self {
419        Self {
420            tool_calls_by_index: HashMap::default(),
421        }
422    }
423
424    pub fn map_stream(
425        mut self,
426        events: Pin<Box<dyn Send + Stream<Item = Result<deepseek::StreamResponse>>>>,
427    ) -> impl Stream<Item = Result<LanguageModelCompletionEvent, LanguageModelCompletionError>>
428    {
429        events.flat_map(move |event| {
430            futures::stream::iter(match event {
431                Ok(event) => self.map_event(event),
432                Err(error) => vec![Err(LanguageModelCompletionError::from(error))],
433            })
434        })
435    }
436
437    pub fn map_event(
438        &mut self,
439        event: deepseek::StreamResponse,
440    ) -> Vec<Result<LanguageModelCompletionEvent, LanguageModelCompletionError>> {
441        let Some(choice) = event.choices.first() else {
442            return vec![Err(LanguageModelCompletionError::from(anyhow!(
443                "Response contained no choices"
444            )))];
445        };
446
447        let mut events = Vec::new();
448        if let Some(content) = choice.delta.content.clone() {
449            events.push(Ok(LanguageModelCompletionEvent::Text(content)));
450        }
451
452        if let Some(reasoning_content) = choice.delta.reasoning_content.clone() {
453            events.push(Ok(LanguageModelCompletionEvent::Thinking {
454                text: reasoning_content,
455                signature: None,
456            }));
457        }
458
459        if let Some(tool_calls) = choice.delta.tool_calls.as_ref() {
460            for tool_call in tool_calls {
461                let entry = self.tool_calls_by_index.entry(tool_call.index).or_default();
462
463                if let Some(tool_id) = tool_call.id.clone() {
464                    entry.id = tool_id;
465                }
466
467                if let Some(function) = tool_call.function.as_ref() {
468                    if let Some(name) = function.name.clone() {
469                        entry.name = name;
470                    }
471
472                    if let Some(arguments) = function.arguments.clone() {
473                        entry.arguments.push_str(&arguments);
474                    }
475                }
476            }
477        }
478
479        if let Some(usage) = event.usage {
480            events.push(Ok(LanguageModelCompletionEvent::UsageUpdate(TokenUsage {
481                input_tokens: usage.prompt_tokens,
482                output_tokens: usage.completion_tokens,
483                cache_creation_input_tokens: 0,
484                cache_read_input_tokens: 0,
485            })));
486        }
487
488        match choice.finish_reason.as_deref() {
489            Some("stop") => {
490                events.push(Ok(LanguageModelCompletionEvent::Stop(StopReason::EndTurn)));
491            }
492            Some("tool_calls") => {
493                events.extend(self.tool_calls_by_index.drain().map(|(_, tool_call)| {
494                    match serde_json::Value::from_str(&tool_call.arguments) {
495                        Ok(input) => Ok(LanguageModelCompletionEvent::ToolUse(
496                            LanguageModelToolUse {
497                                id: tool_call.id.clone().into(),
498                                name: tool_call.name.as_str().into(),
499                                is_input_complete: true,
500                                input,
501                                raw_input: tool_call.arguments.clone(),
502                                thought_signature: None,
503                            },
504                        )),
505                        Err(error) => Ok(LanguageModelCompletionEvent::ToolUseJsonParseError {
506                            id: tool_call.id.clone().into(),
507                            tool_name: tool_call.name.as_str().into(),
508                            raw_input: tool_call.arguments.into(),
509                            json_parse_error: error.to_string(),
510                        }),
511                    }
512                }));
513
514                events.push(Ok(LanguageModelCompletionEvent::Stop(StopReason::ToolUse)));
515            }
516            Some(stop_reason) => {
517                log::error!("Unexpected DeepSeek stop_reason: {stop_reason:?}",);
518                events.push(Ok(LanguageModelCompletionEvent::Stop(StopReason::EndTurn)));
519            }
520            None => {}
521        }
522
523        events
524    }
525}
526
527struct ConfigurationView {
528    api_key_editor: Entity<InputField>,
529    state: Entity<State>,
530    load_credentials_task: Option<Task<()>>,
531}
532
533impl ConfigurationView {
534    fn new(state: Entity<State>, window: &mut Window, cx: &mut Context<Self>) -> Self {
535        let api_key_editor =
536            cx.new(|cx| InputField::new(window, cx, "sk-00000000000000000000000000000000"));
537
538        cx.observe(&state, |_, _, cx| {
539            cx.notify();
540        })
541        .detach();
542
543        let load_credentials_task = Some(cx.spawn({
544            let state = state.clone();
545            async move |this, cx| {
546                if let Some(task) = Some(state.update(cx, |state, cx| state.authenticate(cx))) {
547                    let _ = task.await;
548                }
549
550                this.update(cx, |this, cx| {
551                    this.load_credentials_task = None;
552                    cx.notify();
553                })
554                .log_err();
555            }
556        }));
557
558        Self {
559            api_key_editor,
560            state,
561            load_credentials_task,
562        }
563    }
564
565    fn save_api_key(&mut self, _: &menu::Confirm, _window: &mut Window, cx: &mut Context<Self>) {
566        let api_key = self.api_key_editor.read(cx).text(cx).trim().to_string();
567        if api_key.is_empty() {
568            return;
569        }
570
571        let state = self.state.clone();
572        cx.spawn(async move |_, cx| {
573            state
574                .update(cx, |state, cx| state.set_api_key(Some(api_key), cx))
575                .await
576        })
577        .detach_and_log_err(cx);
578    }
579
580    fn reset_api_key(&mut self, window: &mut Window, cx: &mut Context<Self>) {
581        self.api_key_editor
582            .update(cx, |editor, cx| editor.set_text("", window, cx));
583
584        let state = self.state.clone();
585        cx.spawn(async move |_, cx| {
586            state
587                .update(cx, |state, cx| state.set_api_key(None, cx))
588                .await
589        })
590        .detach_and_log_err(cx);
591    }
592
593    fn should_render_editor(&self, cx: &mut Context<Self>) -> bool {
594        !self.state.read(cx).is_authenticated()
595    }
596}
597
598impl Render for ConfigurationView {
599    fn render(&mut self, _window: &mut Window, cx: &mut Context<Self>) -> impl IntoElement {
600        let env_var_set = self.state.read(cx).api_key_state.is_from_env_var();
601        let configured_card_label = if env_var_set {
602            format!("API key set in {API_KEY_ENV_VAR_NAME} environment variable")
603        } else {
604            let api_url = DeepSeekLanguageModelProvider::api_url(cx);
605            if api_url == DEEPSEEK_API_URL {
606                "API key configured".to_string()
607            } else {
608                format!("API key configured for {}", api_url)
609            }
610        };
611
612        if self.load_credentials_task.is_some() {
613            div()
614                .child(Label::new("Loading credentials..."))
615                .into_any_element()
616        } else if self.should_render_editor(cx) {
617            v_flex()
618                .size_full()
619                .on_action(cx.listener(Self::save_api_key))
620                .child(Label::new("To use DeepSeek in Zed, you need an API key:"))
621                .child(
622                    List::new()
623                        .child(
624                            ListBulletItem::new("")
625                                .child(Label::new("Get your API key from the"))
626                                .child(ButtonLink::new(
627                                    "DeepSeek console",
628                                    "https://platform.deepseek.com/api_keys",
629                                )),
630                        )
631                        .child(ListBulletItem::new(
632                            "Paste your API key below and hit enter to start using the assistant",
633                        )),
634                )
635                .child(self.api_key_editor.clone())
636                .child(
637                    Label::new(format!(
638                        "You can also set the {API_KEY_ENV_VAR_NAME} environment variable and restart Zed."
639                    ))
640                    .size(LabelSize::Small)
641                    .color(Color::Muted),
642                )
643                .into_any_element()
644        } else {
645            ConfiguredApiCard::new(configured_card_label)
646                .disabled(env_var_set)
647                .on_click(cx.listener(|this, _, window, cx| this.reset_api_key(window, cx)))
648                .into_any_element()
649        }
650    }
651}