deepseek.rs

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