dsh-mcp 1.0.0

package/src/client/locales.ts

@@ -0,0 +1,152 @@
+/** Copy dictionaries for the MCP server management Settings section. */
+
+/** Simplified Chinese dictionary and key source of truth. */
+export const zh = {
+  nav: 'MCP',
+  loading: '正在读取 MCP 服务器…',
+  loadError: '暂时无法读取 MCP 服务器。',
+  retry: '重试',
+  empty: '还没有配置 MCP 服务器。',
+  addServer: '添加服务器',
+  serverName: '服务器名称（serverName）',
+  serverNameHint: '工具将以 mcp__<serverName>__<tool> 命名；1-32 位字母、数字、下划线或连字符',
+  transport: '传输方式',
+  transportStdio: 'stdio（本地子进程）',
+  transportHttp: 'streamable-http（远程服务）',
+  enabled: '启用',
+  disable: '禁用',
+  command: '命令',
+  commandPlaceholder: '例如 npx',
+  args: '参数',
+  argsPlaceholder: '每行一个参数',
+  cwd: '工作目录',
+  cwdPlaceholder: '留空继承 Host 工作目录',
+  url: '服务器 URL',
+  urlPlaceholder: '例如 http://localhost:3000/mcp',
+  headers: '请求头',
+  headersPlaceholder: '每行一个 "名称: 值"',
+  envVars: '环境变量',
+  envHint: '注入到 stdio 子进程；标记为 secret 的值写入凭据文档，不在此明文保存',
+  envName: '变量名',
+  envValue: '值',
+  envSecret: 'secret',
+  envSecretHint: '值只写，保存后不可见；留空表示保留原值',
+  addEnvVar: '添加环境变量',
+  removeEnvVar: '移除该变量',
+  toolCallTimeoutMs: '工具调用超时（毫秒）',
+  failOnStartupError: '启动连接失败时拒绝挂载',
+  statusMounting: '连接中',
+  statusLive: '已连接',
+  statusFailed: '挂载失败',
+  statusStopped: '未启用',
+  toolCount: '工具',
+  edit: '编辑',
+  test: '测试连接',
+  testRunning: '正在测试…',
+  testOk: '连接成功',
+  testFail: '连接失败',
+  testUnknown: '未知结果',
+  save: '保存',
+  saving: '保存中…',
+  cancel: '取消',
+  remove: '删除',
+  removeConfirm: '确定删除该服务器？',
+  removing: '删除中…',
+  failureTitle: '操作失败',
+  serverNameConflict: 'serverName 已被其他服务器使用',
+  notFound: '服务器不存在',
+  invalidSpec: '配置不合法',
+  mountFailed: '挂载失败',
+  backToList: '返回列表',
+  editTitle: '编辑服务器',
+  newTitle: '新建服务器',
+  toolsTitle: '工具控制',
+  toolsModeLabel: '注入模式',
+  toolsModeFull: '全量注入（每轮注入所有启用的 MCP 工具）',
+  toolsModeSearch: '按需检索（仅注入常用/检索到的工具，省 token）',
+  toolsHintSearch: '按需模式：模型需要某 MCP 工具时会调用 mcp_tool_search 检索并自动注入当前对话。',
+  toolsHintFull: '全量模式：下方开关控制每个 MCP 工具是否注入模型请求。',
+  toolsLoading: '正在读取工具列表…',
+  toolsEmpty: '（暂无 MCP 工具）',
+  refresh: '刷新',
+  refreshing: '刷新中…',
+  toolsExpand: '展开工具',
+  toolsCollapse: '收起工具',
+} satisfies Record<string, string>
+
+/** MCP settings locale key union. */
+export type McpSettingsLocaleKey = keyof typeof zh
+
+/** English dictionary checked against the Chinese key set. */
+export const en = {
+  nav: 'MCP',
+  loading: 'Reading MCP servers…',
+  loadError: 'MCP servers are temporarily unavailable.',
+  retry: 'Retry',
+  empty: 'No MCP servers are configured yet.',
+  addServer: 'Add server',
+  serverName: 'Server name (serverName)',
+  serverNameHint: 'Tools appear as mcp__<serverName>__<tool>; 1-32 letters, digits, underscores, or hyphens',
+  transport: 'Transport',
+  transportStdio: 'stdio (local child process)',
+  transportHttp: 'streamable-http (remote service)',
+  enabled: 'Enabled',
+  disable: 'Disable',
+  command: 'Command',
+  commandPlaceholder: 'e.g. npx',
+  args: 'Arguments',
+  argsPlaceholder: 'One argument per line',
+  cwd: 'Working directory',
+  cwdPlaceholder: 'Leave empty to inherit the Host working directory',
+  url: 'Server URL',
+  urlPlaceholder: 'e.g. http://localhost:3000/mcp',
+  headers: 'Headers',
+  headersPlaceholder: 'One "Name: value" per line',
+  envVars: 'Environment variables',
+  envHint: 'Injected into the stdio child; secret values are stored in the credentials document, never shown here',
+  envName: 'Name',
+  envValue: 'Value',
+  envSecret: 'secret',
+  envSecretHint: 'Write-only; a blank value keeps the stored one',
+  addEnvVar: 'Add environment variable',
+  removeEnvVar: 'Remove this variable',
+  toolCallTimeoutMs: 'Tool-call timeout (ms)',
+  failOnStartupError: 'Reject the mount when the startup connection fails',
+  statusMounting: 'Connecting',
+  statusLive: 'Connected',
+  statusFailed: 'Mount failed',
+  statusStopped: 'Disabled',
+  toolCount: 'tools',
+  edit: 'Edit',
+  test: 'Test connection',
+  testRunning: 'Testing…',
+  testOk: 'Connection succeeded',
+  testFail: 'Connection failed',
+  testUnknown: 'Unknown result',
+  save: 'Save',
+  saving: 'Saving…',
+  cancel: 'Cancel',
+  remove: 'Delete',
+  removeConfirm: 'Delete this server?',
+  removing: 'Deleting…',
+  failureTitle: 'Operation failed',
+  serverNameConflict: 'serverName is already used by another server',
+  notFound: 'Server not found',
+  invalidSpec: 'Invalid configuration',
+  mountFailed: 'Mount failed',
+  backToList: 'Back to list',
+  editTitle: 'Edit server',
+  newTitle: 'New server',
+  toolsTitle: 'Tool control',
+  toolsModeLabel: 'Injection mode',
+  toolsModeFull: 'Full injection (every enabled MCP tool each request)',
+  toolsModeSearch: 'On-demand search (inject only resident/hot tools, saves tokens)',
+  toolsHintSearch: 'On-demand mode: the model calls mcp_tool_search to discover and hot-inject MCP tools.',
+  toolsHintFull: 'Full mode: the switches below control which MCP tools are injected each request.',
+  toolsLoading: 'Reading tool list…',
+  toolsEmpty: '(no MCP tools)',
+  refresh: 'Refresh',
+  refreshing: 'Refreshing…',
+  toolsExpand: 'Expand tools',
+  toolsCollapse: 'Collapse tools',
+} satisfies Record<McpSettingsLocaleKey, string>

package/src/client/mcp-store.ts

@@ -0,0 +1,249 @@
+/**
+ * MCP settings page store: the server list projection, the editing draft, and
+ * the transient probe outcome. All Remote traffic happens in the apply-world
+ * inject callbacks; the store only mirrors their results so components stay
+ * pure presentational.
+ */
+import { defineStore, type EngineStoreHandle } from '@deepseek-ai/dsh-client-runtime/client'
+import type {
+  McpEnvVarInput, McpProbeView, McpServerId, McpServerInput, McpServerView, McpTransportKind,
+} from './types.ts'
+
+/** One env row in the editor. */
+export interface McpEnvRowDraft {
+  /** Stable row key for React lists. */
+  readonly key: string
+  readonly name: string
+  readonly secret: boolean
+  /** Editor text; a blank secret value keeps the stored one on save. */
+  readonly value: string
+  /** Whether a stored value exists (secret rows render write-only). */
+  readonly configured: boolean
+}
+
+/** One server being edited. */
+export interface McpDraft {
+  /** Existing server id; null creates a new server. */
+  readonly id: McpServerId | null
+  readonly serverName: string
+  readonly transport: McpTransportKind
+  readonly enabled: boolean
+  readonly command: string
+  /** Arguments as newline-separated editor text. */
+  readonly argsText: string
+  readonly cwd: string
+  readonly url: string
+  /** Headers as "Name: value" lines. */
+  readonly headersText: string
+  readonly env: readonly McpEnvRowDraft[]
+  /** Timeout as editor text; blank falls back to the default. */
+  readonly toolCallTimeoutMs: string
+  readonly failOnStartupError: boolean
+}
+
+/** The transient probe outcome of the current draft. */
+export interface McpTestOutcome {
+  readonly probe: McpProbeView
+  readonly elapsedMs: number
+}
+
+/** Page-level state mirroring Remote results and the current editing session. */
+export interface McpManagerUiState {
+  loadState: 'loading' | 'ready' | 'error'
+  servers: readonly McpServerView[]
+  /** Draft being edited; null renders the server list. */
+  draft: McpDraft | null
+  /** Verb of the current in-flight Remote operation. */
+  busy: 'save' | 'remove' | null
+  testRunning: boolean
+  test: McpTestOutcome | null
+}
+
+/** Declared mutation surface for the page. */
+type McpManagerActions = {
+  setLoadState: (draft: McpManagerUiState, state: McpManagerUiState['loadState']) => void
+  setServers: (draft: McpManagerUiState, servers: readonly McpServerView[]) => void
+  beginCreate: (draft: McpManagerUiState) => void
+  beginEdit: (draft: McpManagerUiState, server: McpServerView) => void
+  cancelEdit: (draft: McpManagerUiState) => void
+  updateDraft: (draft: McpManagerUiState, patch: Partial<McpDraft>) => void
+  setBusy: (draft: McpManagerUiState, busy: 'save' | 'remove' | null) => void
+  setTestRunning: (draft: McpManagerUiState, running: boolean) => void
+  setTest: (draft: McpManagerUiState, test: McpTestOutcome | null) => void
+}
+
+/** Default tool-call timeout when the editor leaves it blank (ms). */
+export const DEFAULT_TOOL_CALL_TIMEOUT_MS = 60_000
+
+let envRowSeq = 0
+
+/** A fresh env row key for React identity. */
+function nextEnvRowKey(): string {
+  envRowSeq += 1
+  return `env-${envRowSeq}`
+}
+
+/** A fresh empty env row for the editor. */
+export function createEnvRowDraft(): McpEnvRowDraft {
+  return { key: nextEnvRowKey(), name: '', secret: false, value: '', configured: false }
+}
+
+/** Build an empty create draft. */
+export function emptyDraft(): McpDraft {
+  return {
+    id: null,
+    serverName: '',
+    transport: 'stdio',
+    enabled: true,
+    command: '',
+    argsText: '',
+    cwd: '',
+    url: '',
+    headersText: '',
+    env: [],
+    toolCallTimeoutMs: String(DEFAULT_TOOL_CALL_TIMEOUT_MS),
+    failOnStartupError: false,
+  }
+}
+
+/** Build an edit draft from a stored server view. */
+export function draftFromServer(server: McpServerView): McpDraft {
+  return {
+    id: server.id,
+    serverName: server.serverName,
+    transport: server.transport,
+    enabled: server.enabled,
+    command: server.command,
+    argsText: server.args.join('\n'),
+    cwd: server.cwd,
+    url: server.url,
+    headersText: server.headers.map(header => `${header.name}: ${header.value}`).join('\n'),
+    env: server.env.map(entry => ({
+      key: nextEnvRowKey(),
+      name: entry.name,
+      secret: entry.secret,
+      value: '',
+      configured: entry.configured,
+    })),
+    toolCallTimeoutMs: String(server.toolCallTimeoutMs),
+    failOnStartupError: server.failOnStartupError,
+  }
+}
+
+/** Parse newline-separated lines into trimmed non-empty arguments. */
+function parseLines(text: string): string[] {
+  return text.split('\n').map(line => line.trim()).filter(line => line.length > 0)
+}
+
+/** Parse "Name: value" header lines; malformed lines are dropped. */
+function parseHeaders(text: string): Array<{ name: string; value: string }> {
+  const headers: Array<{ name: string; value: string }> = []
+  for (const line of parseLines(text)) {
+    const separator = line.indexOf(':')
+    if (separator <= 0) continue
+    const name = line.slice(0, separator).trim()
+    const value = line.slice(separator + 1).trim()
+    if (name.length > 0) headers.push({ name, value })
+  }
+  return headers
+}
+
+/** Parse the timeout text; blank or invalid falls back to the default. */
+function parseTimeout(text: string): number {
+  const value = Number(text)
+  return Number.isInteger(value) && value > 0 ? value : DEFAULT_TOOL_CALL_TIMEOUT_MS
+}
+
+/** The Remote submission derived from the current draft. */
+export interface McpSubmission {
+  readonly server: McpServerInput
+  readonly env: readonly McpEnvVarInput[]
+}
+
+/**
+ * Convert the editing draft into the Remote upsert/test payload. A blank
+ * secret value submits no value, which keeps the stored secret on upsert.
+ */
+export function draftToSubmission(draft: McpDraft): McpSubmission {
+  return {
+    server: {
+      serverName: draft.serverName.trim(),
+      transport: draft.transport,
+      enabled: draft.enabled,
+      command: draft.command.trim(),
+      args: parseLines(draft.argsText),
+      cwd: draft.cwd.trim(),
+      url: draft.url.trim(),
+      headers: parseHeaders(draft.headersText),
+      toolCallTimeoutMs: parseTimeout(draft.toolCallTimeoutMs),
+      failOnStartupError: draft.failOnStartupError,
+    },
+    env: draft.env.map(row => ({
+      name: row.name.trim(),
+      secret: row.secret,
+      ...row.secret && row.value.trim().length === 0 ? {} : { value: row.value },
+    })),
+  }
+}
+
+/** Map a Remote failure code to a locale key for user-facing copy. */
+export function failureLocaleKey(code: string): string {
+  switch (code) {
+    case 'MCP_SERVER_NAME_CONFLICT': return 'serverNameConflict'
+    case 'MCP_SERVER_NOT_FOUND': return 'notFound'
+    case 'MCP_INVALID_SPEC': return 'invalidSpec'
+    case 'MCP_MOUNT_FAILED': return 'mountFailed'
+    default: return 'failureTitle'
+  }
+}
+
+/**
+ * Declares the MCP management page state and write surface.
+ * @returns the store handle.
+ */
+export function createMcpManagerStore(): EngineStoreHandle<McpManagerUiState, McpManagerActions> {
+  return defineStore({
+    init: (): McpManagerUiState => ({
+      loadState: 'loading',
+      servers: [],
+      draft: null,
+      busy: null,
+      testRunning: false,
+      test: null,
+    }),
+    actions: {
+      setLoadState: (d, state) => {
+        d.loadState = state
+      },
+      setServers: (d, servers) => {
+        d.servers = servers
+      },
+      beginCreate: (d) => {
+        d.draft = emptyDraft()
+        d.test = null
+      },
+      beginEdit: (d, server) => {
+        d.draft = draftFromServer(server)
+        d.test = null
+      },
+      cancelEdit: (d) => {
+        d.draft = null
+        d.test = null
+        d.busy = null
+      },
+      updateDraft: (d, patch) => {
+        if (d.draft === null) return
+        d.draft = { ...d.draft, ...patch }
+      },
+      setBusy: (d, busy) => {
+        d.busy = busy
+      },
+      setTestRunning: (d, running) => {
+        d.testRunning = running
+      },
+      setTest: (d, test) => {
+        d.test = test
+      },
+    },
+  })
+}