dsh-acp-enhanced 0.2.1 → 0.3.0

package/README-en.md

@@ -44,6 +44,14 @@ over the ACP wire.
   `session/list` / `session/delete` manage the thread archive (titled, sorted by last
   activity); live title updates
 
+### Commands
+
+- **Slash commands**: typing `/` reveals the command list (`available_commands_update`):
+  `/status` shows the route and telemetry, `/model` lists or switches the model, everything
+  else (`/compact` `/goal` `/permission` `/plan`…) runs straight through the harness
+  command registry — all executed **without a model turn**; unresolved slashes fall
+  through to the model (the `/skill-name` skill gesture)
+
 ### MCP
 
 - **MCP servers**: `session/new` `mcpServers` mount any MCP server (stdio + streamable

package/README.md

@@ -38,6 +38,13 @@ ACP 线上。
 - **恢复与归档**：`session/load` 恢复历史线程（完整回放）；`session/list` /
   `session/delete` 管理线程归档（带标题、按更新时间排序）；标题实时推送
 
+### 命令
+
+- **Slash 命令**：输入 `/` 即可见命令列表（`available_commands_update`）：`/status`
+  查看路由与遥测、`/model` 列出或切换模型，其余（`/compact` `/goal` `/permission`
+  `/plan`…）直通 harness 命令注册表，全部**不经过模型 turn** 即时执行；未解析的
+  slash 放行给模型（`/skill-name` 技能手势）
+
 ### MCP
 
 - **MCP servers**：`session/new` 的 `mcpServers` 挂载任意 MCP server（stdio +

package/lib/index.js

@@ -43,7 +43,7 @@ import { acpPromptToText, promptHasUnsupportedContent, turnEndToStopReason, usag
 
 export const name = 'acp-enhanced'
 /** The bridge creates and owns agents; every other concern is carried by the composition. */
-export const inject = ['agents', 'llm', 'approval', 'tools']
+export const inject = ['agents', 'llm', 'approval', 'tools', 'commands']
 
 export const Config = Schema.object({
   /** Initial provider route for every created agent. */
@@ -121,6 +121,7 @@ export function apply(ctx, config) {
   const llm = ctx.llm
   const approval = ctx.approval
   const tools = ctx.tools
+  const commands = ctx.commands
   const logger = ctx.logger
   /** The user-questions service (mounted by dsh-base); absent in minimal deployments. */
   const userQuestions = ctx.get('userQuestions')
@@ -1001,6 +1002,94 @@ export function apply(ctx, config) {
     }
   }
 
+  // ── slash commands (adapter built-ins + harness command registry) ────────
+
+  /** Adapter-level commands, always first in the advertised list. */
+  const BUILTIN_COMMANDS = [
+    { name: 'status', description: 'Show session status: model route, context usage, telemetry.' },
+    { name: 'model', description: 'List the model catalog, or switch with /model <provider/model | substring>.' },
+  ]
+
+  /**
+   * Advertise the full command surface for a session as ACP
+   * `available_commands_update`: adapter built-ins plus whatever the harness
+   * command registry (compact/goal/permission/plan/…) serves for the agent.
+   */
+  async function publishCommands(record) {
+    const list = [...BUILTIN_COMMANDS]
+    const seen = new Set(list.map((command) => command.name))
+    try {
+      for (const descriptor of commands.list(record.agent)) {
+        if (seen.has(descriptor.name)) continue
+        seen.add(descriptor.name)
+        list.push({
+          name: descriptor.name,
+          description: descriptor.description,
+          ...descriptor.input === undefined ? {} : { input: descriptor.input },
+        })
+      }
+    } catch (error) {
+      logger.warn(`acp-enhanced: command listing failed: ${String(error)}`)
+    }
+    notify({
+      sessionId: record.agent.session.id,
+      update: { sessionUpdate: 'available_commands_update', availableCommands: list },
+    })
+  }
+
+  /** Text summary of one session: route, turns, last usage telemetry. */
+  async function statusText(record) {
+    const selection = record.selection.current
+    const last = record.lastUsage
+    const lines = [
+      `route: ${selection.provider ?? '?'}/${selection.model ?? '?'}`,
+      `turns: ${record.turnCount}`,
+      ...last === undefined ? [] : [
+        `context: ${last.used}/${last.size}`,
+        `last usage: in ${last.meta.inputTokens ?? '?'} / out ${last.meta.outputTokens ?? '?'} / reasoning ${last.meta.reasoningTokens ?? '?'} tokens, cache hit ${last.meta.cacheHitRate ?? '?'}%, tps ${last.meta.tps ?? '?'}`,
+      ],
+    ]
+    return lines.join('\n')
+  }
+
+  /** The /model command: list the live catalog or switch by exact id/substring. */
+  async function modelCommandText(record, query) {
+    const catalog = await modelCatalog()
+    const current = record.selection.current
+    if (query.trim().length === 0) {
+      const lines = catalog.flatMap((group) => group.models.map((model) => {
+        const mark = `${group.id}/${model.id}` === `${current.provider}/${current.model}` ? '* ' : '  '
+        return `${mark}${group.id}/${model.id}`
+      }))
+      return lines.length > 0 ? lines.join('\n') : 'no models available'
+    }
+    const needle = query.trim().toLowerCase()
+    const matches = catalog.flatMap((group) => group.models.map((model) => ({ provider: group.id, model: model.id })))
+      .filter((candidate) => `${candidate.provider}/${candidate.model}`.toLowerCase().includes(needle) || candidate.model.toLowerCase().includes(needle))
+    if (matches.length === 0) return `no model matches "${query}"`
+    if (matches.length > 1) return `ambiguous: ${matches.map((m) => `${m.provider}/${m.model}`).join(', ')}`
+    await applySelection(record, { provider: matches[0].provider, model: matches[0].model })
+    return `switched to ${matches[0].provider}/${matches[0].model}`
+  }
+
+  /** Refresh every client-visible surface a command may have mutated. */
+  function refreshAfterCommand(record) {
+    const permission = permissionPresets()
+    if (permission !== undefined) {
+      notify({
+        sessionId: record.agent.session.id,
+        update: {
+          sessionUpdate: 'current_mode_update',
+          currentModeId: permission.current(record.agent.session.events),
+        },
+      })
+    }
+    broadcastConfig(record).catch((error) => {
+      logger.warn(`acp-enhanced: config rebroadcast after command failed: ${String(error)}`)
+    })
+    publishCommands(record)
+  }
+
   // ── session records + history replay ─────────────────────────────────────
 
   /** Build the bridge-owned protocol record for a fresh or resumed agent. */
@@ -1238,6 +1327,7 @@ export function apply(ctx, config) {
         const record = makeRecord(handle)
         sessions.set(sessionId, record)
         await syncMcpServers(params.mcpServers, params.cwd)
+        publishCommands(record)
         const permission = permissionPresets()
         return {
           sessionId,
@@ -1299,6 +1389,7 @@ export function apply(ctx, config) {
         // Zed inserts the thread before the load RPC completes; replay the
         // conversation history as notifications so the thread renders.
         await replayHistory(record)
+        publishCommands(record)
         const permission = permissionPresets()
         return {
           ...permission === undefined ? {} : {
@@ -1329,6 +1420,44 @@ export function apply(ctx, config) {
         }
         const text = acpPromptToText(params.prompt)
         if (text.trim().length === 0) throw invalidParams('empty prompt')
+
+        // Adapter-level slash commands never reach the model: /status and
+        // /model are built in, any other registered slash (compact/goal/
+        // permission/plan/…) runs through the harness command registry
+        // without a model turn. An unresolved slash falls through — the
+        // /skill-name gesture is claimed inside the agent's next step.
+        const trimmed = text.trim()
+        const commandMatch = trimmed.match(/^\/(\w[\w-]*)\b/)
+        const respond = (reply) => {
+          notify({
+            sessionId: record.agent.session.id,
+            update: {
+              sessionUpdate: 'agent_message_chunk',
+              messageId: randomUUID(),
+              content: { type: 'text', text: reply },
+            },
+          })
+          return { stopReason: 'end_turn' }
+        }
+        if (commandMatch?.[1] === 'status') return respond(await statusText(record))
+        if (commandMatch?.[1] === 'model') {
+          return respond(await modelCommandText(record, trimmed.slice(commandMatch[0].length).trim()))
+        }
+        if (commandMatch !== null && commandMatch[1] !== undefined) {
+          let execution
+          try {
+            execution = await commands.execute(record.agent, trimmed, new AbortController().signal)
+          } catch (error) {
+            return respond(`⚠ /${commandMatch[1]} failed: ${error.message ?? String(error)}`)
+          }
+          if (execution !== undefined) {
+            const { result } = execution
+            const reply = result.text ?? (result.kind === 'success' ? `/${commandMatch[1]} ✓` : `/${commandMatch[1]} failed`)
+            refreshAfterCommand(record)
+            return respond(result.kind === 'error' ? `⚠ ${reply}` : reply)
+          }
+        }
+
         if (ctx.agents.get(record.agent.id) !== record.agent) {
           throw internalError('prompt was not queued: the agent was disposed outside the bridge')
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-acp-enhanced",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Enhanced ACP server for DeepSeek Harness: block-level streaming, usage/stat telemetry (cache hit rate, token speed, input/output tokens, context length, turns, tool timing), model & reasoning-effort switching, and permission-preset control over the ACP wire (Zed-friendly)",
   "keywords": [
     "dsh",