@luchenglong/cli-bridge 0.2.2 → 0.2.4

package/dynamic/opencode.host.template.mjs

@@ -0,0 +1,125 @@
+// dynamic/opencode.host.template.mjs — opencode 动态沙箱宿主模板（cordis_define code.host 源）。
+//
+// 构建（node scripts/build.mjs --only=opencode）把 core/bridge-kit.mjs 与
+// providers/opencode.mjs 分别内联进下方两个占位标记行（各占一行、行内仅此标记），
+// 生成 dynamic/opencode.host.js。注意：标记字面量绝不能出现在本注释里 —— 构建做全局
+// 替换，注释中出现同样会被替换成正文代码而炸掉语法。
+// 沙箱纪律（旧仓 dynamic/host.js 头注 verbatim 精神）：
+//  - 禁 import/require、无 TypeScript；无 AbortController/process 裸引用/Buffer/原生
+//    定时器 —— process 只经 typeof 守卫探测；宿主能力全部来自注入的 harness.*/ctx。
+//  - 顶层 return { inject, apply } 为动态宿主约定形态（生成物是 .js/CJS 包装，顶层
+//    return 合法；本模板文件是 .mjs，不要直接 node --check 模板本身，只 check 生成物）。
+//  - 无 ctx.emit：状态经 ctx.get('cliBridgeCollector').mergeSnapshot('opencode', snap)
+//    推给家级灯；动态形态不宣告 mode（旧语义：普通模式灯仅在调用时临时显示）。
+/*__KIT__*/
+/*__PROVIDER__*/
+/*__SCHED__*/
+
+return {
+  inject: ['tools', 'subprocess', 'systemPrompt', 'timer'],
+  apply(ctx) {
+    // 调度门禁（0.2.0）：设置面板关掉 opencode → 本形态不注册工具/政策段；fail-open。
+    if (!isBridgeEnabled('opencode', SCHED_ALL_IDS)) return
+    const subprocess = ctx.subprocess
+    const sandboxPolicy = ctx.get('sandboxPolicy')
+    // 沙箱可能运行在无 process 的环境：typeof 守卫读 env（旧仓 dynamic 的等价面）。
+    const env = (typeof process !== 'undefined' && process.env) ? process.env : {}
+
+    const provider = defineProvider({ env })
+
+    function publish(snapshot) {
+      try {
+        const collector = ctx.get('cliBridgeCollector')
+        if (collector && typeof collector.mergeSnapshot === 'function') { collector.mergeSnapshot('opencode', snapshot); return }
+      } catch (e) { /* fall through to legacy alias */ }
+      try {
+        const legacy = ctx.get('opencodeCollector')
+        if (legacy && typeof legacy.mergeSnapshot === 'function') legacy.mergeSnapshot(snapshot)
+      } catch (e) { /* 灯数据尽力而为 */ }
+    }
+
+    // exe 优先级（与描述符同一套）：env OPENCODE_BIN/OPENCODE_CLI > 桌面版 V2 探测
+    // > PATH 查找 opencode-cli（subprocess.resolveExecutable）。
+    // 二进制名 opencode-cli（V2 桌面版），不做 opencode.exe 兜底（V1/V2 不能并存）。
+    const exeCandidates = resolveExePrefix(env, '')
+    async function resolveExe(backend, signal) {
+      for (const c of exeCandidates) {
+        if (/\.(mjs|cjs|js)$/i.test(c) && typeof process !== 'undefined' && process.execPath) return [process.execPath, c]
+        return c
+      }
+      return await subprocess.resolveExecutable('opencode-cli', undefined, signal)
+    }
+
+    // cwd 兜底：OPENCODE_MCP_CWD > sandboxPolicy.workspaceRoot > process.cwd() > '.'。
+    function getCwdFallback() {
+      if (env.OPENCODE_MCP_CWD) return String(env.OPENCODE_MCP_CWD)
+      if (sandboxPolicy && typeof sandboxPolicy.workspaceRoot === 'string' && sandboxPolicy.workspaceRoot) return sandboxPolicy.workspaceRoot
+      if (typeof process !== 'undefined' && typeof process.cwd === 'function') { try { return process.cwd() } catch (e) {} }
+      return '.'
+    }
+
+    provider.attach({ ctx, subprocess, resolveExe, getCwdFallback, publish })
+
+    const OUTPUT_SCHEMA = { type: 'object', additionalProperties: true }
+
+    harness.registerTool(ctx, harness.defineTool({
+      name: provider.tools.run.name,
+      description: provider.tools.run.description,
+      parameters: provider.tools.run.inputSchema,
+      output: { schema: OUTPUT_SCHEMA, render: function (args, value) { return renderResult(value, provider) } },
+      execute: function (args, exec) { return provider.runToolLogic(args, exec) }
+    }))
+    harness.registerTool(ctx, harness.defineTool({
+      name: provider.tools.continue.name,
+      description: provider.tools.continue.description,
+      parameters: provider.tools.continue.inputSchema,
+      output: { schema: OUTPUT_SCHEMA, render: function (args, value) { return renderResult(value, provider) } },
+      execute: function (args, exec) { return provider.continueToolLogic(args, exec) }
+    }))
+    harness.registerTool(ctx, harness.defineTool({
+      name: provider.tools.status.name,
+      description: provider.tools.status.description,
+      parameters: provider.tools.status.inputSchema,
+      output: { schema: OUTPUT_SCHEMA, render: function (args, value) { return renderStatus(value, provider) } },
+      execute: function (args) { return provider.statusToolLogic(args) }
+    }))
+
+    // 浏览器指示灯轮询的 RPC 面（旧 dynamic/handle('<id>_status') verbatim 语义）。
+    harness.handle('opencode_status', function () { return provider.statusToolLogic({}) })
+
+    const policyText = [
+      'opencode-first execution policy (local opencode CLI bridge).',
+      '',
+      'Local agent CLI "opencode" handles coding tasks under full DSH control (permissions auto-approved, never blocks on a prompt). By default, opencode runs in the background and returns a jobId immediately; collect results via job_output and watch live progress via opencode_status anytime.',
+      '',
+      'Decision table for tool selection:',
+      '- Single read/glob/grep or short (<30s) command -> Native tools.',
+      '- Implementing, editing, refactoring, debugging, builds, multi-file investigation -> opencode_run.',
+      '- Follow-ups on the same topic -> opencode_continue (with latest=true or sessionId; opencode preserves session context).',
+      '- Final build/test verification of opencode output -> Native tools.',
+      '',
+      'Context protocol (one topic = one opencode session):',
+      '- First dispatch on a topic: provide the task with a compact CONTEXT preamble (point to paths, do not paste file contents):',
+      '  CONTEXT: 2-6 lines — goal; repo root; key paths; decisions/constraints; current state.',
+      '  TASK: the complete instruction.',
+      '- Follow-ups: call opencode_continue and state only what is new.',
+      '',
+      'Execution & Fallback protocol:',
+      '- Dispatch defaults to background=true (set background=false only to block). Collect via job_output.',
+      '- On rate-limit or network failure, a confirmation dialog opens in BOTH foreground and background while in flight.',
+      '- If result has fallback=true (status FALLBACK_TO_DSH), the user chose DSH-local: finish with native tools and NEVER call opencode again for this task.',
+      '- Never loop opencode calls; never ask opencode to call back into DSH.',
+      '',
+      'Model & credentials:',
+      '- Prefer a free model for routine work: pass a model id ending in -free (e.g. "opencode/nemotron-3-ultra-free") unless this task genuinely needs a frontier model.',
+      '- Omit the model unless you have a reason: opencode then uses its own configured default (or the one chosen in CLI Bridge settings). Pass model in provider/model form to override.',
+      '- Credentials are owned by opencode, not by this bridge: auth/API-key failures mean the user should run `opencode auth login`. Do not retry in a loop.'
+    ].join('\n')
+
+    ctx.systemPrompt.section({
+      name: 'opencode:policy',
+      order: (typeof ctx.systemPrompt.getSectionOrder === 'function' ? ctx.systemPrompt.getSectionOrder('TOOL_SUBAGENT') : 2800) + 10,
+      text: policyText
+    })
+  }
+}

package/home-plugin/cli-bridge-indicator/lib/index.mjs

@@ -30,7 +30,17 @@ import { settingsView, parseSettingsBody, readSettingsFile, writeSettingsFile, S
 import { declareBridgePresets } from './preset-declarations.mjs'
 
 export const PRESET_TTL_MS = 75000
+/** 运行中/仍在活动的项目的新鲜期（防抖：短暂停顿不该让灯闪）。 */
 export const PROJECT_TTL_MS = 10 * 60 * 1000
+/**
+ * 已完成（running=0 且已有 lastStatus）项目的新鲜期。
+ *
+ * 0.2.1 用单一 10 分钟 TTL 修「一次失败后灯永久挂着」—— 但 10 分钟对于「刚跑完、
+ * 想看到灯灭」来说太长：任务结束后灯要挂满 10 分钟才消失，用户感知是「灯不灭」。
+ * 区分两态：运行中（含短暂间隔）保持长 TTL 防抖；已收口的项目走短 TTL 快速淡出。
+ * 淡出只影响 pill 渲染（stale 项目仍在弹窗里作历史），不丢数据。
+ */
+export const PROJECT_DONE_TTL_MS = 60 * 1000
 export const MAX_PROJECTS = 24
 export const MAX_SESSIONS = 64
 
@@ -50,6 +60,11 @@ export function createIndicatorState(opts) {
   const now = typeof o.now === 'function' ? o.now : Date.now
   const ttlMs = o.ttlMs != null ? o.ttlMs : PRESET_TTL_MS
   const projectTtlMs = o.projectTtlMs != null ? o.projectTtlMs : PROJECT_TTL_MS
+  // doneTtlMs 缺省跟随 projectTtlMs（显式传 projectTtlMs 的测试/调用方同时支配两态，
+  // 否则「传短 TTL 却不生效」会静默坑人）；只有走生产默认值时才取更短的
+  // PROJECT_DONE_TTL_MS（已完成项目快速淡出）。
+  const doneTtlMs = o.doneTtlMs != null ? o.doneTtlMs
+    : (o.projectTtlMs != null ? projectTtlMs : PROJECT_DONE_TTL_MS)
   const staleMs = o.staleMs != null ? o.staleMs : MCP_BRIDGE_STALE_MS
   const ids = Array.isArray(o.ids) && o.ids.length ? o.ids.slice() : PROVIDER_IDS.slice()
   const listPresetSessions = typeof o.listPresetSessions === 'function' ? o.listPresetSessions : null
@@ -183,7 +198,11 @@ export function createIndicatorState(opts) {
     const isStale = (p) => {
       if (p.running > 0) return false
       const at = Number(p.updatedAt) || Number(p.lastAt) || 0
-      return !!at && (t - at) > projectTtlMs
+      if (!at) return false
+      // 已收口（有终态）的项目走短 TTL → 完成后快速淡出；
+      // 仍无终态的（长时间运行中的间隔、或从未跑完）保持长 TTL 防抖。
+      const ttl = p.lastStatus ? doneTtlMs : projectTtlMs
+      return (t - at) > ttl
     }
     // 顶层聚合只看新鲜（未 stale）项目：陈旧历史不再决定灯色（0.2.1 修复「指示灯长期
     // 存在」的服务端半边 —— 客户端半边在 pill 过滤；无新鲜项目时顶层回落 idle）。

package/home-plugin/cli-bridge-indicator/lib/preset-declarations.mjs

@@ -25,7 +25,7 @@ export const PKG_NAME = '@luchenglong/cli-bridge'
 
 // preset 目录名映射（与 scripts/build.mjs 的 PRESET_DIRS 一致；目录名带 -first 后缀是
 // 三个旧包时代的遗留布局，provider id 不带 —— 这里不映射就永远找不到 plugin-list）。
-const PRESET_DIRS = { agy: 'agy-first', codebuddy: 'codebuddy-first', mimo: 'mimo-first' }
+const PRESET_DIRS = { agy: 'agy-first', codebuddy: 'codebuddy-first', mimo: 'mimo-first', opencode: 'opencode-first' }
 
 const HERE = dirname(fileURLToPath(import.meta.url))
 const ROOT = join(HERE, '..', '..', '..')

package/mcp/cli-bridge-mcp.mjs

@@ -28,12 +28,13 @@ import { resolveScheduling } from '../core/scheduling.mjs'
 import * as agyMcp from './providers/agy.mjs'
 import * as codebuddyMcp from './providers/codebuddy.mjs'
 import * as mimoMcp from './providers/mimo.mjs'
+import * as opencodeMcp from './providers/opencode.mjs'
 
 const SERVER_NAME = 'cli-bridge-mcp'
-const SERVER_VERSION = '0.2.2'
+const SERVER_VERSION = '0.2.4'
 const PROTOCOL = '2024-11-05'
 
-const PROVIDERS = [agyMcp, codebuddyMcp, mimoMcp]
+const PROVIDERS = [agyMcp, codebuddyMcp, mimoMcp, opencodeMcp]
 
 function detectHomeDir() {
   if (process.env.DSH_HOME) return process.env.DSH_HOME

package/mcp/providers/agy.mjs

@@ -18,8 +18,9 @@ import { fileURLToPath } from 'node:url'
 
 import defineProvider from '../../providers/agy.mjs'
 import { createStatusEngine, createLineStream, buildMcpBridgePayload, isLimited, renderStatus } from '../../core/bridge-kit.mjs'
+import { packageVersion } from '../version.mjs'
 
-export const meta = { id: 'agy', label: 'AGY', version: '0.2.2' }
+export const meta = { id: 'agy', label: 'AGY', version: packageVersion() }
 
 const QUOTA_SCRIPT_DEFAULT = fileURLToPath(new URL('../../bin/agy-quota.mjs', import.meta.url))
 

package/mcp/providers/codebuddy.mjs

@@ -24,8 +24,9 @@ import { resolve as resolvePath, join as nodePathJoin } from 'node:path'
 
 import defineProvider from '../../providers/codebuddy.mjs'
 import { createStatusEngine, createLineStream, buildMcpBridgePayload, mcpBridgeFileName } from '../../core/bridge-kit.mjs'
+import { packageVersion } from '../version.mjs'
 
-export const meta = { id: 'codebuddy', label: 'CODEBUDDY', version: '0.2.2' }
+export const meta = { id: 'codebuddy', label: 'CODEBUDDY', version: packageVersion() }
 
 const provider = defineProvider({
   env: process.env,

package/mcp/providers/mimo.mjs

@@ -26,8 +26,9 @@ import {
   createStatusEngine, createLineStream, buildMcpBridgePayload,
   fallbackResult, shortLabel, renderStatus
 } from '../../core/bridge-kit.mjs'
+import { packageVersion } from '../version.mjs'
 
-export const meta = { id: 'mimo', label: 'MIMO', version: '0.2.2' }
+export const meta = { id: 'mimo', label: 'MIMO', version: packageVersion() }
 
 const BACKEND_DESKTOP = 'mimo-desktop'
 const SETTINGS_FILE_NAME = 'cli-bridge-settings.json'

package/mcp/providers/opencode.mjs

@@ -0,0 +1,237 @@
+// mcp/providers/opencode.mjs — opencode MCP 工具面（契约 §4）。
+// framing/生命周期归 keystone 统一服务器 mcp/cli-bridge-mcp.mjs。
+//
+// 与 agy 面的结构同构（旧 MCP 语义保持）：直接 spawn opencode(.exe)（win32 用
+// opencode.exe；OPENCODE_BIN 覆盖；.js/.mjs 目标经 process.execPath 包装，供测试
+// fixture 使用）。无 ctx.emit：状态走快照文件 {homeDir}/cli-bridge-mcp-opencode.json
+// （bridge-kit buildMcpBridgePayload + 原子写 tmp→rename；写失败静默）。
+//
+// opencode 无 quota/额度门禁（凭据与额度由 opencode 自身与 provider 决定），
+// 因此本面只有三件套。
+import { spawn as nodeSpawn } from 'node:child_process'
+import { resolve as resolvePath } from 'node:path'
+
+import defineProvider, { resolveExePrefix } from '../../providers/opencode.mjs'
+import { createStatusEngine, createLineStream, buildMcpBridgePayload, isLimited, renderStatus } from '../../core/bridge-kit.mjs'
+import { packageVersion } from '../version.mjs'
+
+export const meta = { id: 'opencode', label: 'OPENCODE', version: packageVersion() }
+
+const provider = defineProvider({
+  env: process.env,
+  process,
+  nodeChild: { spawn: nodeSpawn }
+})
+
+let lastIo = null
+function publishSnapshot(snapshot) {
+  const io = lastIo
+  if (!io) return
+  try {
+    const target = io.path.join(io.homeDir, 'cli-bridge-mcp-opencode.json')
+    const payload = buildMcpBridgePayload(snapshot, process.pid, Date.now())
+    const tmp = target + '.' + process.pid + '.tmp'
+    try { io.fs.mkdirSync(io.path.dirname(target), { recursive: true }) } catch (e) {}
+    io.fs.writeFileSync(tmp, JSON.stringify(payload), 'utf8')
+    io.fs.renameSync(tmp, target)
+  } catch (e) { /* 灯数据尽力而为，绝不影响工具调用 */ }
+}
+// provider.engine 在 attach 后才存在；MCP 形态不 attach，用本模块的 engine。
+const engine = createStatusEngine({ provider, publish: publishSnapshot })
+provider.engine = engine
+
+// ── exe / cwd 解析 ────────────────────────────────────────────────────────────
+// 与描述符同一套优先级（env > 桌面版探测 > PATH 名字）；二进制名 opencode-cli.exe
+// （V2 桌面版），不做 opencode.exe 兜底以免误命中不能并存的另一个版本。
+function exePrefix() {
+  return resolveExePrefix(process.env, '')
+}
+function resolveCwd(a) {
+  if (a && a.cwd) return resolvePath(String(a.cwd))
+  return process.env.OPENCODE_MCP_CWD || process.cwd()
+}
+
+// ── spawn（实时折叠走 bridge-kit 行流）────────────────────────────────────────
+function runOpencode(args) {
+  return new Promise((resolve) => {
+    const built = provider.buildArgv(exePrefix(), args, { planActive: false, defaultMode: 'auto' })
+    const cwd = resolveCwd(args)
+    let child
+    try {
+      child = nodeSpawn(built.argv[0], built.argv.slice(1), { cwd, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true })
+    } catch (e) {
+      resolve({ ok: false, status: 'SPAWN_ERROR', response: '', sessionId: null, durationSeconds: null, numTurns: null, totalTokens: null, exitCode: null, mode: built.mode, backend: null, stderr: String(e && e.message || e) })
+      return
+    }
+    engine.begin(cwd)
+    let out = ''
+    let err = ''
+    let killed = false
+    const timer = setTimeout(() => { killed = true; try { child.kill() } catch (e) {} }, (built.timeoutSec + 60) * 1000)
+    const stream = createLineStream((ln) => {
+      const t = ln.trim()
+      if (!t.startsWith('{')) return
+      try { engine.foldEvent(JSON.parse(t), cwd) } catch (e) {}
+    })
+    child.stdout.on('data', (d) => {
+      out += d
+      if (out.length > 4000000) out = out.slice(-2000000)
+      stream.pushChunk(String(d))
+    })
+    child.stderr.on('data', (d) => { err += d; if (err.length > 1000000) err = err.slice(-500000) })
+    child.on('error', (e) => {
+      clearTimeout(timer)
+      stream.flush()
+      const res = { ok: false, status: 'OPENCODE_UNAVAILABLE', response: '', sessionId: null, durationSeconds: null, numTurns: null, totalTokens: null, exitCode: null, mode: built.mode, backend: null, stderr: 'opencode spawn failed: ' + String(e && e.message || e) }
+      engine.end(res, cwd)
+      resolve(res)
+    })
+    child.on('close', (code) => {
+      clearTimeout(timer)
+      stream.flush()
+      const outcome = { exitCode: killed ? 124 : code }
+      let res = provider.buildResult(provider.parseJson(out), outcome, built.mode, err, out, null)
+      if (killed && !res.ok) {
+        res.status = 'HUNG_TIMEOUT'
+        res.stderr = (res.stderr ? res.stderr + ' ' : '') + '[killed by DSH timeout guard after ' + built.timeoutSec + 's; if this was a long-running script (build/test) raise timeoutSec]'
+      }
+      engine.end(res, cwd)
+      resolve(res)
+    })
+  })
+}
+
+function textResult(res) {
+  if (res.fallback) {
+    return 'opencode unavailable (' + res.reason + '). Use native tools / the local model for this task; do not retry opencode.'
+  }
+  const limited = !res.ok && isLimited(res)
+  const head = 'opencode ' + (res.ok ? 'OK' : 'FAILED') + ' [status=' + res.status +
+    (res.sessionId ? ' session=' + res.sessionId : '') +
+    (res.durationSeconds != null ? ' ' + res.durationSeconds + 's' : '') + ']'
+  let note = ''
+  if (limited) note = '\n\n[Note: this looks like a rate-limit / network failure. Do NOT retry opencode in a loop; finish the task with your own tools, or ask the user.]'
+  const body = res.response || (res.stderr ? '[stderr] ' + res.stderr : (res.rawStdout ? '[raw] ' + res.rawStdout : ''))
+  return head + (body ? '\n\n' + body : '') + note
+}
+
+// ── 工具面 ────────────────────────────────────────────────────────────────────
+const TOOLS = [
+  {
+    name: 'opencode_run',
+    description: 'Dispatch a coding/build/debug/investigation task to the local opencode agent CLI and return its final answer. opencode runs fully non-interactively (permissions auto-approved, never blocks on a prompt). Prefer it for implementation, multi-file edits, refactors and debugging; use your own tools for quick read-only lookups and final build/test verification. While it runs, call opencode_status to watch what opencode is doing live.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        prompt: { type: 'string', description: 'The task instruction for opencode. On first dispatch for a topic, include a compact CONTEXT preamble (goal, repo root, key paths, decisions/constraints; point at paths, do not paste file contents — opencode reads the repo itself). For follow-ups on the same topic, use opencode_continue with latest=true or sessionId (opencode keeps session context; state only what is new).' },
+        model: { type: 'string', description: 'Optional model in provider/model form (e.g. "anthropic/claude-sonnet-4-20250514"). Omit to let opencode use its own configured default.' },
+        agent: { type: 'string', description: 'Optional opencode agent (subagent) name.' },
+        variant: { type: 'string', description: 'Optional provider-specific reasoning variant (e.g. high, max, minimal).' },
+        cwd: { type: 'string', description: 'Working directory for opencode (default: OPENCODE_MCP_CWD or the DSH workspace).' },
+        files: { type: 'array', items: { type: 'string' }, description: 'Optional file paths to attach to the message.' },
+        title: { type: 'string', description: 'Optional session title.' },
+        timeoutSec: { type: 'integer', description: '10-3600, default 600.' },
+        autoApprove: { type: 'boolean', description: 'Default true: pass --auto so opencode never blocks on a permission prompt. Set false to require explicit approval.' }
+      },
+      required: ['prompt']
+    }
+  },
+  {
+    name: 'opencode_continue',
+    description: 'Continue an existing opencode session with a follow-up prompt, reusing opencode context. Pass sessionId from a prior opencode_run result, or set latest=true for the most recent session.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        prompt: { type: 'string', description: 'Follow-up instruction for the ongoing opencode session. State only what is new; opencode preserves its session context.' },
+        sessionId: { type: 'string' },
+        latest: { type: 'boolean', description: 'Continue the most recent opencode session.' },
+        model: { type: 'string' },
+        agent: { type: 'string' },
+        variant: { type: 'string' },
+        cwd: { type: 'string' },
+        files: { type: 'array', items: { type: 'string' } },
+        timeoutSec: { type: 'integer', description: '10-3600, default 600.' },
+        autoApprove: { type: 'boolean' }
+      },
+      required: ['prompt']
+    }
+  },
+  {
+    name: 'opencode_status',
+    description: 'Read a live snapshot of what the local opencode agent is currently doing. Returns one section per project (working directory): running count, the current step (tool name + arguments being executed, or agent_response thinking/typing), the recent step trail (tools executed, done/error), and the last completed run status + session id. Optional cwd filters to a single project. Call this to check on an in-flight opencode_run/opencode_continue without waiting for it to finish.',
+    inputSchema: { type: 'object', properties: { cwd: { type: 'string', description: 'Optional: filter the snapshot to a single project (working directory).' } } }
+  },
+  {
+    name: 'opencode_models',
+    description: 'List the models available to the local opencode CLI (from `opencode models`). Use it to pick a model before opencode_run, or to check which models are free. Prefer a -free model for routine work and reserve paid/frontier models for tasks that genuinely need them. If the CLI is missing or not logged in this returns ok:false with an actionable error — it never invents a model list.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        freeOnly: { type: 'boolean', description: 'Return only free models (id ends with -free).' },
+        provider: { type: 'string', description: 'Optional provider filter, e.g. "opencode" or "opencode-go".' }
+      }
+    }
+  }
+]
+
+export function tools(env) {
+  return TOOLS.map((t) => Object.assign({}, t))
+}
+
+export async function call(name, args, io) {
+  if (io) lastIo = io
+  if (!lastIo) return 'opencode error: MCP io not initialized'
+  const a = args || {}
+  if (name === 'opencode_status') {
+    const snap = engine.statusSnapshot()
+    if (a.cwd) {
+      snap.projects = snap.projects.filter((p) => p.cwd === String(a.cwd))
+      const g = snap.projects[0]
+      if (g) Object.assign(snap, { state: g.state, running: g.running, current: g.current, trail: g.trail, lastStatus: g.lastStatus, lastAt: g.lastAt, lastSessionId: g.lastSessionId, lastBackend: g.lastBackend, fallbackActive: g.fallbackActive, updatedAt: g.updatedAt })
+    }
+    return renderStatus(snap, provider)[0].text
+  }
+  if (name === 'opencode_models') {
+    const res = await provider.listModels(a)
+    if (!res.ok) return 'opencode_models failed: ' + String(res.error || 'unknown')
+    const list = res.models || []
+    if (!list.length) return 'opencode_models: no models matched'
+    const lines = ['opencode models (' + list.length + '):']
+    for (const m of list.slice(0, 40)) lines.push('  ' + m.id + (m.free ? '  [free]' : ''))
+    if (list.length > 40) lines.push('  … and ' + (list.length - 40) + ' more')
+    const free = list.filter((m) => m.free).length
+    lines.push('free: ' + free + ' / ' + list.length)
+    if (a.freeOnly && !free) lines.push('(no free models under this filter)')
+    return lines.join('\n')
+  }
+  if (!a.prompt || !String(a.prompt).trim()) return 'opencode error: prompt is required'
+  const mapped = Object.assign({}, a)
+  if (name === 'opencode_continue') {
+    if (!mapped.sessionId && mapped.latest) mapped.continueLatest = true
+  }
+  const res = await runOpencode(mapped)
+  return textResult(res)
+}
+
+export function check(env) {
+  const ts = tools(env)
+  const names = ts.map((t) => t.name)
+  for (const req of ['opencode_run', 'opencode_continue', 'opencode_status', 'opencode_models']) {
+    if (!names.includes(req)) throw new Error('opencode mcp: missing tool ' + req)
+  }
+  for (const t of ts) {
+    if (!t.name || !t.description || !t.inputSchema || t.inputSchema.type !== 'object') throw new Error('opencode mcp: bad tool def ' + JSON.stringify(t && t.name))
+  }
+  // MCP 面必须覆盖 descriptor 三件套（名字一致，提示词连续性红线）。
+  for (const k of ['run', 'continue', 'status']) {
+    if (!names.includes(provider.tools[k].name)) throw new Error('opencode mcp: tools surface missing descriptor name ' + provider.tools[k].name)
+  }
+  // argv 契约漂移锁（实测 opencode 1.19.0 flag 集）。
+  const b = provider.buildArgv(['opencode'], { prompt: 'x' }, { planActive: false })
+  for (const f of ['run', 'x', '--format', 'json', '--auto']) {
+    if (!b.argv.includes(f)) throw new Error('opencode mcp: argv contract drift: ' + f)
+  }
+  const b2 = provider.buildArgv(['opencode'], { prompt: 'x', autoApprove: false }, { planActive: false })
+  if (b2.argv.includes('--auto')) throw new Error('opencode mcp: autoApprove=false must omit --auto')
+  return true
+}

package/mcp/version.mjs

@@ -0,0 +1,26 @@
+// mcp/version.mjs — MCP 工具面版本号单一来源。
+//
+// 历史问题：四个 provider 的 `meta.version` 与描述符的 `mcp.version` 各自硬编码
+// 版本字面量（共 8 处），每次发布必须手工同步 —— 漏改一处就出现「统一 server 报
+// 0.2.3、provider 面仍报 0.2.2」的自相矛盾输出（0.2.3 发布时即踩到）。
+//
+// 契约 §4 要求 provider version「独立跟随本包」—— 跟随 = 同源派生，不是各处抄写。
+// 这里从包自身的 package.json 读一次，全包共用。失败时抛错而非静默回落：版本号
+// 错误会误导排障，宁可大声失败（红线 7）。
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url))
+let cached = null
+
+export function packageVersion() {
+  if (cached) return cached
+  let parsed
+  try { parsed = JSON.parse(readFileSync(pkgPath, 'utf8')) } catch (e) {
+    throw new Error('mcp/version: cannot read package.json (' + String(e && e.message || e) + ')')
+  }
+  const v = parsed && parsed.version
+  if (typeof v !== 'string' || !v) throw new Error('mcp/version: package.json has no version field')
+  cached = v
+  return v
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@luchenglong/cli-bridge",
-  "version": "0.2.2",
-  "description": "CLI Bridge for DeepSeek Harness (DSH): one package bridging three local coding-CLI agents — agy (Google Antigravity CLI), Tencent CodeBuddy Code, and Xiaomi MiMo (MiMoCode / MiMo Desktop). Each provider keeps its own agent preset (cordis-agy / codebuddy-first / cordis-mimo), tools (agy_run / codebuddy_run / mimo_run + continue + status), rate-limit/network fallback dialog, and zero-dependency MCP server, unified under a single home-level status light, one settings file, and one bundle patch. Merges agy-first-bridge, codebuddy-first-bridge and mimo-first-bridge.",
+  "version": "0.2.4",
+  "description": "CLI Bridge for DeepSeek Harness (DSH): one package bridging four local coding-CLI agents — agy (Google Antigravity CLI), Tencent CodeBuddy Code, Xiaomi MiMo (MiMoCode / MiMo Desktop), and OpenCode. Each provider keeps its own agent preset (cordis-agy / codebuddy-first / cordis-mimo / opencode-first), tools (agy_run / codebuddy_run / mimo_run / opencode_run + continue + status), rate-limit/network fallback dialog, and zero-dependency MCP server, unified under a single home-level status light, one settings file, and one bundle patch. Merges agy-first-bridge, codebuddy-first-bridge and mimo-first-bridge.",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -19,9 +19,11 @@
     "./providers/agy": "./providers/agy.mjs",
     "./providers/codebuddy": "./providers/codebuddy.mjs",
     "./providers/mimo": "./providers/mimo.mjs",
+    "./providers/opencode": "./providers/opencode.mjs",
     "./preset-agy": "./preset/agy-first/cli-bridge.mjs",
     "./preset-codebuddy": "./preset/codebuddy-first/cli-bridge.mjs",
     "./preset-mimo": "./preset/mimo-first/cli-bridge.mjs",
+    "./preset-opencode": "./preset/opencode-first/cli-bridge.mjs",
     "./package.json": "./package.json"
   },
   "dsh": {
@@ -87,3 +89,4 @@
     "url": "https://github.com/new-256/cli-bridge/issues"
   }
 }
+