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