deepseek.rs

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