@oar-sh/oar 0.9.16 → 0.9.17

package/server/public/app/deepseek-settings-ui.js

@@ -0,0 +1,342 @@
+// Settings → Providers → DeepSeek: the key (written, never read back), the
+// switch, the default model, the commit attribution, the monthly budget for
+// the usage card with its currency, the starting balance its balance bar
+// measures from and, under Advanced, the base URL. The
+// relay discovers the models when a key is saved. Below them, the import of
+// DeepSeek's usage export (two CSV files) for the usage card.
+
+import { importDeepSeekUsageExport as postDeepSeekUsageExport, loadDeepSeekSettings, updateDeepSeekSettings } from './api-client.js';
+import { showTransientRelayNotice } from './store.js';
+
+const DEFAULT_MODEL = 'deepseek-flash';
+const DEFAULT_BASE_URL = 'https://api.deepseek.com';
+
+let updateInFlight = false;
+let inputsDirty = false;
+// The starting balance field was typed in since the tab was filled.
+let startingBalanceEdited = false;
+let state = {
+  configured: false,
+  enabled: false,
+  model: DEFAULT_MODEL,
+  availableModels: [DEFAULT_MODEL, 'deepseek-v4-pro'],
+  baseUrl: DEFAULT_BASE_URL,
+  attribution: 'oar',
+  monthlyBudget: null,
+  // 'USD' or 'CNY'; null for a budget saved before the currency was stored
+  // (the card reads it in the balance's currency), or no budget.
+  monthlyBudgetCurrency: null,
+  startingBalance: null,
+  // What the relay says of the starting balance (for example that a later
+  // top-up has replaced it), or null.
+  startingBalanceNote: null,
+};
+
+const BUDGET_CURRENCIES = ['USD', 'CNY'];
+
+const CONTROL_IDS = [
+  'deepseek-api-key-input',
+  'deepseek-model-select',
+  'deepseek-attribution-select',
+  'deepseek-monthly-budget-input',
+  'deepseek-monthly-budget-currency-select',
+  'deepseek-starting-balance-input',
+  'deepseek-base-url-input',
+  'deepseek-enabled-toggle',
+  'deepseek-save-btn',
+  'deepseek-remove-btn',
+];
+
+function element(id) {
+  return document.getElementById(id);
+}
+
+function ensureInputTracking() {
+  for (const id of ['deepseek-api-key-input', 'deepseek-model-select', 'deepseek-attribution-select', 'deepseek-monthly-budget-input', 'deepseek-monthly-budget-currency-select', 'deepseek-starting-balance-input', 'deepseek-base-url-input']) {
+    const input = element(id);
+    if (!input || input.dataset.deepseekDirtyTracking === '1') continue;
+    input.dataset.deepseekDirtyTracking = '1';
+    input.addEventListener(input.tagName === 'SELECT' ? 'change' : 'input', () => {
+      inputsDirty = true;
+      if (id === 'deepseek-starting-balance-input') startingBalanceEdited = true;
+    });
+  }
+}
+
+function setControlsDisabled(disabled) {
+  for (const id of CONTROL_IDS) {
+    const control = element(id);
+    if (control) control.disabled = disabled;
+  }
+}
+
+function fillModelSelect(select) {
+  const models = Array.from(new Set([state.model, ...state.availableModels].filter(Boolean)));
+  select.innerHTML = '';
+  for (const model of models) {
+    const option = document.createElement('option');
+    option.value = model;
+    option.textContent = model;
+    select.appendChild(option);
+  }
+  select.value = state.model;
+}
+
+export function applyDeepSeekSettingsState(settings = {}, { resetInputs = false } = {}) {
+  ensureInputTracking();
+  const available = Array.isArray(settings?.availableModels)
+    ? settings.availableModels.map((value) => String(value || '').trim()).filter(Boolean)
+    : state.availableModels;
+  state = {
+    configured: settings?.configured === true,
+    enabled: settings?.configured === true && settings?.enabled === true,
+    model: String(settings?.model || state.model || DEFAULT_MODEL).trim() || DEFAULT_MODEL,
+    availableModels: available.length ? available : state.availableModels,
+    baseUrl: String(settings?.baseUrl || DEFAULT_BASE_URL).trim() || DEFAULT_BASE_URL,
+    attribution: settings?.attribution === 'off' ? 'off' : 'oar',
+    monthlyBudget: Number.isFinite(Number(settings?.monthlyBudget)) && Number(settings.monthlyBudget) > 0 ? Number(settings.monthlyBudget) : null,
+    monthlyBudgetCurrency: BUDGET_CURRENCIES.includes(String(settings?.monthlyBudgetCurrency || '').toUpperCase())
+      ? String(settings.monthlyBudgetCurrency).toUpperCase()
+      : null,
+    startingBalance: Number.isFinite(Number(settings?.startingBalance)) && Number(settings.startingBalance) > 0 ? Number(settings.startingBalance) : null,
+    startingBalanceNote: String(settings?.startingBalanceNote || '').trim() || null,
+  };
+  const keepInputs = inputsDirty && !resetInputs;
+  const keyInput = element('deepseek-api-key-input');
+  if (keyInput && !keepInputs) {
+    keyInput.value = '';
+    keyInput.placeholder = state.configured ? 'Saved API key (enter to replace)' : 'DeepSeek API key…';
+  }
+  const modelSelect = element('deepseek-model-select');
+  if (modelSelect && !keepInputs) fillModelSelect(modelSelect);
+  const attributionSelect = element('deepseek-attribution-select');
+  if (attributionSelect && !keepInputs) attributionSelect.value = state.attribution;
+  const budgetInput = element('deepseek-monthly-budget-input');
+  if (budgetInput && !keepInputs) budgetInput.value = state.monthlyBudget === null ? '' : String(state.monthlyBudget);
+  const budgetCurrencySelect = element('deepseek-monthly-budget-currency-select');
+  // A new budget is in dollars unless chosen otherwise; a budget saved
+  // without a currency stays in the balance's until one is chosen.
+  if (budgetCurrencySelect && !keepInputs) budgetCurrencySelect.value = state.monthlyBudgetCurrency || (state.monthlyBudget === null ? 'USD' : '');
+  const startingInput = element('deepseek-starting-balance-input');
+  if (startingInput && !keepInputs) startingInput.value = state.startingBalance === null ? '' : String(state.startingBalance);
+  const startingStatus = element('deepseek-starting-balance-status');
+  if (startingStatus) {
+    startingStatus.textContent = state.startingBalanceNote || '';
+    startingStatus.hidden = !state.startingBalanceNote;
+  }
+  const baseUrlInput = element('deepseek-base-url-input');
+  if (baseUrlInput && !keepInputs) baseUrlInput.value = state.baseUrl === DEFAULT_BASE_URL ? '' : state.baseUrl;
+  if (resetInputs) {
+    inputsDirty = false;
+    startingBalanceEdited = false;
+  }
+  const toggle = element('deepseek-enabled-toggle');
+  if (toggle) {
+    toggle.checked = state.enabled;
+    toggle.disabled = updateInFlight || !state.configured;
+  }
+  const removeButton = element('deepseek-remove-btn');
+  if (removeButton) removeButton.disabled = updateInFlight || !state.configured;
+  const status = element('deepseek-settings-status');
+  if (status) {
+    status.textContent = state.enabled
+      ? 'DeepSeek is enabled. Select DeepSeek in New Chat to use it.'
+      : (state.configured
+          ? 'API key saved but currently disabled. Enable it to allow DeepSeek selection in New Chat.'
+          : 'Not configured. New conversations use GitHub Copilot.');
+    status.dataset.state = state.enabled ? 'active' : (state.configured ? 'saved' : 'unconfigured');
+  }
+  window.syncAutoModelAvailability?.();
+  return state;
+}
+
+export async function refreshDeepSeekSettingsState() {
+  const settings = await loadDeepSeekSettings();
+  if (!settings) return null;
+  return applyDeepSeekSettingsState(settings);
+}
+
+/** Called when the Settings modal opens. */
+export async function syncDeepSeekSettingsInputs() {
+  inputsDirty = false;
+  startingBalanceEdited = false;
+  ensureInputTracking();
+  const status = element('deepseek-settings-status');
+  const settings = await refreshDeepSeekSettingsState();
+  if (!settings && status) {
+    status.textContent = 'Unable to load DeepSeek settings.';
+    status.dataset.state = 'error';
+  }
+}
+
+async function runUpdate(payload, { successText, failureText, resetInputs = false }) {
+  if (updateInFlight) return null;
+  updateInFlight = true;
+  setControlsDisabled(true);
+  try {
+    const result = await updateDeepSeekSettings(payload);
+    if (!result) throw new Error(failureText);
+    applyDeepSeekSettingsState(result, { resetInputs });
+    const text = typeof successText === 'function' ? successText(result) : successText;
+    showTransientRelayNotice(result.warning ? `${text} ${result.warning}` : text, result.warning ? 8000 : 4000);
+    return result;
+  } catch (error) {
+    // A refused key removal (409) names the conversations in its message.
+    alert(error?.message || failureText);
+    return null;
+  } finally {
+    updateInFlight = false;
+    setControlsDisabled(false);
+    applyDeepSeekSettingsState(state);
+  }
+}
+
+export async function saveDeepSeekSettings() {
+  const apiKey = String(element('deepseek-api-key-input')?.value || '').trim();
+  if (!apiKey && !state.configured) {
+    alert('Enter a DeepSeek API key.');
+    return;
+  }
+  const baseUrlText = String(element('deepseek-base-url-input')?.value || '').trim();
+  const budgetText = String(element('deepseek-monthly-budget-input')?.value || '').trim();
+  const monthlyBudget = budgetText ? Number(budgetText) : null;
+  if (budgetText && !(Number.isFinite(monthlyBudget) && monthlyBudget >= 0)) {
+    alert('The monthly budget must be an amount of zero or more, or empty for no budget bar.');
+    return;
+  }
+  const startingText = String(element('deepseek-starting-balance-input')?.value || '').trim();
+  const startingBalance = startingText ? Number(startingText) : null;
+  if (startingText && !(Number.isFinite(startingBalance) && startingBalance >= 0)) {
+    alert('The starting balance must be an amount of zero or more, or empty to measure from the balance after the last top-up.');
+    return;
+  }
+  await runUpdate({
+    apiKey,
+    model: String(element('deepseek-model-select')?.value || state.model || DEFAULT_MODEL),
+    attribution: String(element('deepseek-attribution-select')?.value || state.attribution),
+    // Empty is DeepSeek's own endpoint.
+    baseUrl: baseUrlText || null,
+    // Empty (or zero) is no budget bar on the usage card. The currency goes
+    // with the amount; empty is the balance's currency.
+    monthlyBudget,
+    monthlyBudgetCurrency: String(element('deepseek-monthly-budget-currency-select')?.value || '').trim() || null,
+    // Empty (or zero): the balance bar measures from the balance after the
+    // last top-up the relay has seen (before one, the highest balance read).
+    startingBalance,
+    // Typed in since the tab was filled: only then does the relay set a
+    // starting balance a top-up has replaced anew (the same amount too). The
+    // relay decides "replaced" itself, so a tab opened before a top-up was
+    // seen does not bring the old amount back when another field is saved.
+    startingBalanceEdited,
+    enabled: state.configured ? state.enabled : true,
+  }, {
+    successText: (result) => `DeepSeek settings saved for ${result.model}.`,
+    failureText: 'Failed to save DeepSeek settings.',
+    resetInputs: true,
+  });
+}
+
+export async function toggleDeepSeekProvider(enabled) {
+  if (enabled && !state.configured) {
+    applyDeepSeekSettingsState(state);
+    alert('Save a DeepSeek API key before enabling DeepSeek.');
+    return;
+  }
+  await runUpdate({ enabled: enabled === true }, {
+    successText: (result) => (result.enabled ? 'DeepSeek enabled.' : 'DeepSeek disabled.'),
+    failureText: 'Failed to update the DeepSeek provider.',
+  });
+}
+
+export async function removeDeepSeekSettings() {
+  if (!state.configured) return;
+  if (!confirm('Remove the saved DeepSeek API key?')) return;
+  await runUpdate({ remove: true }, {
+    successText: 'DeepSeek API key removed. New conversations use GitHub Copilot.',
+    failureText: 'Failed to remove DeepSeek settings.',
+    resetInputs: true,
+  });
+}
+
+// The export's times keep its offset: "2026-10-26T00:00:00+01:00" reads
+// "2026-10-26 00:00 (UTC+01:00)".
+function exportTimeLabel(value) {
+  const match = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2})(?::\d{2}(?:\.\d+)?)?(Z|[+-]\d{2}:\d{2})?$/.exec(String(value || ''));
+  if (!match) return String(value || '');
+  const zone = !match[3] || match[3] === 'Z' ? 'UTC' : `UTC${match[3]}`;
+  return `${match[1]} ${match[2]} (${zone})`;
+}
+
+function listText(items) {
+  if (items.length <= 1) return items.join('');
+  return `${items.slice(0, -1).join(', ')} and ${items.at(-1)}`;
+}
+
+/** The import's answer, in the panel. */
+export function deepseekUsageImportSummaryText(summary = {}) {
+  const days = Array.isArray(summary.days) ? summary.days : [];
+  const models = Array.isArray(summary.models) ? summary.models : [];
+  const keys = Array.isArray(summary.keys) ? summary.keys : [];
+  const rows = Number(summary.rows) || 0;
+  const parts = [];
+  if (!rows) {
+    parts.push('Nothing to import: the export has no period that has ended.');
+  } else {
+    const span = days.length > 1 ? `${days[0]} to ${days.at(-1)}` : (days[0] || '');
+    parts.push(`Imported ${rows} row${rows === 1 ? '' : 's'}${span ? ` for ${span}` : ''}${models.length ? `: ${listText(models)}` : ''}.`);
+  }
+  const skipped = Array.isArray(summary.skippedPeriods) ? summary.skippedPeriods.length : 0;
+  if (skipped) parts.push(`${skipped} period${skipped === 1 ? '' : 's'} not ended yet left out.`);
+  const currencies = Array.isArray(summary.currencies) ? summary.currencies : [];
+  const cardCurrency = summary.cardCurrency || '';
+  const exportCurrency = currencies.length ? listText(currencies) : '';
+  if (rows && summary.savedKeyMatched && summary.currencyMatched === false) {
+    parts.push(`The export is in ${exportCurrency || 'another currency'}, the usage card in ${cardCurrency} (the balance's): the card does not use these figures and stays estimated.`);
+  } else if (rows && summary.savedKeyMatched) {
+    const inCurrency = exportCurrency ? ` (${exportCurrency})` : '';
+    const cardNote = !cardCurrency && exportCurrency ? ` It uses them while the balance is in ${exportCurrency}.` : '';
+    parts.push(`The usage card shows the saved key's figures${inCurrency} on the export's days through ${exportTimeLabel(summary.through)}, estimated on the others.${cardNote}`);
+  } else if (rows && summary.savedKeyFp) {
+    parts.push(`The saved key (${summary.savedKeyFp}) is not in this export${keys.length ? `, only ${listText(keys.map((key) => key.keyFp))}` : ''}; the usage card stays estimated.`);
+  } else if (rows) {
+    parts.push('No DeepSeek key is saved: save the key this export belongs to and the usage card shows its figures.');
+  }
+  return parts.join(' ');
+}
+
+let importInFlight = false;
+
+function setImportStatus(text, stateName) {
+  const status = element('deepseek-usage-import-status');
+  if (!status) return;
+  status.textContent = text;
+  status.dataset.state = stateName;
+}
+
+export async function importDeepSeekUsageExport() {
+  if (importInFlight) return null;
+  const amountFile = element('deepseek-usage-amount-input')?.files?.[0] || null;
+  const costFile = element('deepseek-usage-cost-input')?.files?.[0] || null;
+  if (!amountFile || !costFile) {
+    setImportStatus('Choose both files of the export: the amount file and the cost file.', 'error');
+    return null;
+  }
+  const button = element('deepseek-usage-import-btn');
+  importInFlight = true;
+  if (button) button.disabled = true;
+  setImportStatus('Importing…', 'saved');
+  try {
+    const [amount, cost] = await Promise.all([amountFile.text(), costFile.text()]);
+    const result = await postDeepSeekUsageExport({ amount, cost });
+    if (!result?.ok) throw new Error('The relay could not be reached.');
+    const used = result.summary?.savedKeyMatched && result.summary?.currencyMatched !== false;
+    setImportStatus(deepseekUsageImportSummaryText(result.summary), used ? 'active' : 'saved');
+    return result;
+  } catch (error) {
+    setImportStatus(String(error?.message || 'The import failed.'), 'error');
+    return null;
+  } finally {
+    importInFlight = false;
+    if (button) button.disabled = false;
+  }
+}

package/server/public/app/inbox-ui.js

@@ -41,6 +41,10 @@ const drafts = new Map();
 // replaces it; the socket updates single asks in between).
 let sessionAsks = new Map();
 let sessionCardKey = '';
+// Where the Inbox was scrolled when it was last left; the next opening
+// starts there (the first one at the top). The transcript's own scroll
+// height is the transcript's, never the Inbox's.
+let inboxScrollTop = 0;
 
 function readFilter() {
   try {
@@ -90,12 +94,17 @@ function restoreDrafts(host, focusedKey) {
   }
 }
 
-function renderInboxNow() {
+/**
+ * Draws the Inbox into the transcript's place. A re-render keeps the scroll
+ * height; the render that opens the view (`opening`) takes the height the
+ * Inbox had when it was last left, not the one the transcript showed.
+ */
+function renderInboxNow({ opening = false } = {}) {
   if (!inboxActive) return;
   const host = document.getElementById('messages');
   if (!host) return;
   const focused = captureDrafts(host);
-  const top = host.scrollTop;
+  const top = opening ? inboxScrollTop : host.scrollTop;
   host.replaceChildren(renderInbox(document, { relays, filter, now: Date.now(), loading: !loaded }));
   restoreDrafts(host, focused);
   host.scrollTop = top;
@@ -153,6 +162,8 @@ export function noteInboxQuestionsChanged() {
 export function leaveInboxView() {
   const wasActive = inboxActive;
   if (!wasActive) return false;
+  const host = document.getElementById('messages');
+  if (host) inboxScrollTop = Math.max(0, Number(host.scrollTop) || 0);
   inboxActive = false;
   document.body.classList.remove('inbox-view-active');
   document.getElementById('input-area')?.removeAttribute('hidden');
@@ -187,7 +198,7 @@ export async function toggleInboxView() {
     }
   }
   syncInboxBadge();
-  renderInboxNow();
+  renderInboxNow({ opening: true });
   document.getElementById('sidebar')?.classList.remove('open');
   document.getElementById('sidebar-overlay')?.classList.remove('visible');
   await refreshInbox();

package/server/public/app/journal-view.js

@@ -72,6 +72,7 @@ import {
   loadClaudeCloudBranches,
   loadClaudeCloudRepos,
   loadGrokSettings,
+  loadDeepSeekSettings,
   loadOpenAISettings,
 } from './api-client.js';
 import { isSetupRequired, updateProviderReadinessInputs } from './provider-readiness.mjs';
@@ -189,6 +190,7 @@ let newConversationOpenAISettingsCache = null;
 let newConversationClaudeSettingsCache = null;
 let newConversationCursorSettingsCache = null;
 let newConversationGrokSettingsCache = null;
+let newConversationDeepSeekSettingsCache = null;
 let newConversationClaudeCloudSettingsCache = null;
 // Claude Cloud fields of the New Chat modal: what the selected folder's git
 // remote said, and what was written into Repository/Branch from it (so a later
@@ -1237,6 +1239,7 @@ function normalizeNewConversationProviderType(value = '') {
   if (normalized === CLAUDE_CLOUD_PROVIDER) return CLAUDE_CLOUD_PROVIDER;
   if (normalized === 'cursor') return 'cursor';
   if (normalized === 'grok') return 'grok';
+  if (normalized === 'deepseek') return 'deepseek';
   return 'github';
 }
 
@@ -1274,6 +1277,7 @@ function modelMatchesNewConversationProvider(catalog = {}, modelId = '', provide
   const hasClaude = providers.includes('claude');
   const hasCursor = providers.includes('cursor');
   const hasGrok = providers.includes('grok');
+  const hasDeepSeek = providers.includes('deepseek');
   if (wantsOpenAI) {
     if (hasOpenAIByok) return true;
     const settingsModel = String(newConversationOpenAISettingsCache?.model || '').trim();
@@ -1309,16 +1313,26 @@ function modelMatchesNewConversationProvider(catalog = {}, modelId = '', provide
       : [];
     return normalizedModelId === grokModel || grokModels.includes(normalizedModelId);
   }
+  if (normalizedProvider === 'deepseek') {
+    if (hasDeepSeek) return true;
+    const deepseekModel = String(newConversationDeepSeekSettingsCache?.model || '').trim();
+    const deepseekModels = Array.isArray(newConversationDeepSeekSettingsCache?.models)
+      ? newConversationDeepSeekSettingsCache.models.map((entry) => String(entry || '').trim()).filter(Boolean)
+      : [];
+    return normalizedModelId === deepseekModel || deepseekModels.includes(normalizedModelId);
+  }
   const claudeOnly = hasClaude && providers.every((provider) => provider === 'claude');
   if (claudeOnly) return false;
   const cursorOnly = hasCursor && providers.every((provider) => provider === 'cursor');
   if (cursorOnly) return false;
   const grokOnly = hasGrok && providers.every((provider) => provider === 'grok');
   if (grokOnly) return false;
+  const deepseekOnly = hasDeepSeek && providers.every((provider) => provider === 'deepseek');
+  if (deepseekOnly) return false;
   // Should a relay ever tag catalog rows for Claude Cloud, they are no more
   // Copilot's than the other runtimes' rows are.
   const exclusiveOnly = providers.length > 0 && providers.every((provider) => (
-    provider === 'claude' || provider === 'cursor' || provider === 'grok' || provider === CLAUDE_CLOUD_PROVIDER
+    provider === 'claude' || provider === 'cursor' || provider === 'grok' || provider === 'deepseek' || provider === CLAUDE_CLOUD_PROVIDER
   ));
   if (exclusiveOnly) return false;
   return providers.some((provider) => (
@@ -1326,6 +1340,7 @@ function modelMatchesNewConversationProvider(catalog = {}, modelId = '', provide
     && provider !== 'claude'
     && provider !== 'cursor'
     && provider !== 'grok'
+    && provider !== 'deepseek'
     && provider !== CLAUDE_CLOUD_PROVIDER
   )) || !hasOpenAIByok;
 }
@@ -1443,8 +1458,10 @@ async function populateNewConversationReasoningSelect(selectedModel = '') {
     if (optionTitle) option.title = optionTitle;
     select.appendChild(option);
   }
+  // A DeepSeek chat with nothing remembered starts at DeepSeek's own default.
+  const storedEffort = localStorage.getItem(REASONING_STORAGE_KEY);
   const preferred = resolvePreferredReasoningEffort(efforts, [
-    localStorage.getItem(REASONING_STORAGE_KEY),
+    storedEffort || (provider === 'deepseek' ? 'high' : ''),
   ]);
   select.value = preferred || efforts[0];
   select.disabled = false;
@@ -1487,6 +1504,10 @@ function updateNewConversationProviderHelp(provider = 'github') {
     help.textContent = "Grok chats use the host machine's logged-in Grok credentials (grok login or XAI_API_KEY).";
     return;
   }
+  if (normalizedProvider === 'deepseek') {
+    help.textContent = "DeepSeek chats run Claude Code on the relay host against DeepSeek's API, billed to your saved DeepSeek key.";
+    return;
+  }
   help.textContent = 'Copilot models use your GitHub Copilot runtime.';
 }
 
@@ -2094,7 +2115,7 @@ function applyNewConversationSetupState(setupRequired) {
 }
 
 async function openNewConversationModelModal() {
-  const [catalog, settings, claudeSettings, cursorSettings, grokSettings, claudeCloudSettings] = await Promise.all([
+  const [catalog, settings, claudeSettings, cursorSettings, grokSettings, claudeCloudSettings, deepseekSettings] = await Promise.all([
     loadModelCatalog(),
     loadOpenAISettings(),
     loadClaudeSettings(),
@@ -2102,6 +2123,8 @@ async function openNewConversationModelModal() {
     loadGrokSettings(),
     // null on a relay without Claude Cloud: the option is simply not offered.
     loadClaudeCloudSettings(),
+    // The same for a relay without DeepSeek.
+    loadDeepSeekSettings(),
   ]);
   newConversationCatalogCache = catalog || null;
   newConversationOpenAISettingsCache = settings || null;
@@ -2109,6 +2132,7 @@ async function openNewConversationModelModal() {
   newConversationCursorSettingsCache = cursorSettings || null;
   newConversationGrokSettingsCache = grokSettings || null;
   newConversationClaudeCloudSettingsCache = claudeCloudSettings || null;
+  newConversationDeepSeekSettingsCache = deepseekSettings || null;
   // Fresh answers for the readiness question, shared with the empty screen
   // and the composer. With no provider known to be ready the modal opens in
   // its setup state: Settings is the main button, Start stays as "anyway".
@@ -2118,6 +2142,7 @@ async function openNewConversationModelModal() {
     claudeCloud: claudeCloudSettings || null,
     cursor: cursorSettings || null,
     grok: grokSettings || null,
+    deepseek: deepseekSettings || null,
     catalog: catalog || null,
   });
   applyNewConversationSetupState(isSetupRequired(readiness));
@@ -2143,6 +2168,9 @@ async function openNewConversationModelModal() {
     if (grokSettings?.enabled === true) {
       options.push({ value: 'grok', label: 'Grok' });
     }
+    if (deepseekSettings?.enabled === true) {
+      options.push({ value: 'deepseek', label: 'DeepSeek' });
+    }
     providerSelect.innerHTML = '';
     for (const option of options) {
       const entry = document.createElement('option');

package/server/public/app/model-selector-options.mjs

@@ -16,11 +16,13 @@ export function composerPlaceholderFor({ modelId = '', providerType = '' } = {})
     if (provider === 'grok') return 'Message Grok…';
     if (provider === 'openai' || provider === 'openai-byok') return 'Message OpenAI…';
     if (provider === 'cursor') return 'Message Cursor…';
+    if (provider === 'deepseek') return 'Message DeepSeek…';
     return 'Message Copilot…';
   };
   if (!id || id === 'auto') return providerFallback();
   if (id.startsWith('claude-')) return 'Message Claude…';
   if (id.startsWith('grok-')) return 'Message Grok…';
+  if (id.startsWith('deepseek-')) return 'Message DeepSeek…';
   if (id.startsWith('gpt-')) return 'Message GPT…';
   if (id.startsWith('gemini-')) return 'Message Gemini…';
   // Composer is Cursor's house model family.
@@ -65,6 +67,15 @@ export function humanizeModelLabel(modelId = '') {
     const label = words.map((word) => word.text).join(' ');
     return suffixMatch ? `${label} [${suffixMatch[1]}]` : label;
   }
+  // "deepseek-flash" → "DeepSeek Flash", "deepseek-v4-pro" → "DeepSeek V4 Pro".
+  if (/^deepseek-/i.test(text)) {
+    return `DeepSeek ${text
+      .replace(/^deepseek-/i, '')
+      .split('-')
+      .filter(Boolean)
+      .map((part) => (/^v\d/i.test(part) ? part.toUpperCase() : part.charAt(0).toUpperCase() + part.slice(1)))
+      .join(' ')}`;
+  }
   if (/^gemini-/i.test(text)) {
     return text
       .replace(/^gemini-/i, 'Gemini ')

package/server/public/app/model-vision-support.mjs

@@ -14,7 +14,9 @@ const KNOWN_TEXT_ONLY_PATTERNS = [
   /^code-davinci/,
   /^text-davinci/,
   /-instruct-text$/,
+  // DeepSeek's text-only models (deepseek-flash takes images).
   /^deepseek-coder/,
+  /^deepseek-v4-pro/,
   /^qwen[\w.-]*-coder/,
 ];
 

package/server/public/app/no-conversation-state.mjs

@@ -10,7 +10,7 @@
 import { isSetupRequired } from './provider-readiness.mjs';
 
 export const SETUP_HEADING = 'Set up a provider';
-export const SETUP_TEXT = 'Turn on Claude, Cursor, OpenAI or Grok in Settings → Providers, or sign in to the Copilot CLI on the relay host.';
+export const SETUP_TEXT = 'Turn on Claude, Cursor, OpenAI, Grok or DeepSeek in Settings → Providers, or sign in to the Copilot CLI on the relay host.';
 
 const ACTIONS = Object.freeze({
   openSettings: (primary) => ({ id: 'empty-state-open-settings', action: 'open-settings', label: primary ? 'Open Settings' : 'Settings', primary, link: !primary }),