@luchenglong/cli-bridge 0.2.2 → 0.2.3

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/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.3'
 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/opencode.mjs

@@ -0,0 +1,236 @@
+// 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'
+
+export const meta = { id: 'opencode', label: 'OPENCODE', version: '0.2.2' }
+
+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/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.3",
+  "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": {

package/preset/opencode-first/agent.cordis.yml

@@ -0,0 +1,141 @@
+# 生成物 — 由 node scripts/build.mjs 从 preset/opencode-first/plugin-list.mjs 生成，勿手改。
+# legacy 目录形态（$DSH_HOME/.agent-presets/opencode-first/）；新 DSH 走声明制
+# （home-plugin/cli-bridge-indicator/lib/preset-declarations.mjs 直接 import 同一源）。
+- id: persona
+  name: '@deepseek-ai/dsh-persona'
+  config:
+    suffix: 'Your working directory is {{cwd}}.'
+    prefix: 'You are a coding agent powered by the {{model}} model.'
+- id: agent-instructions
+  name: '@deepseek-ai/dsh-agent-instructions'
+  config:
+    maxBytes: 65536
+- id: tool-bash
+  name: '@deepseek-ai/dsh-tool-bash'
+  disabled: !!js 'process.platform === ''win32'''
+- id: tool-pwsh
+  name: '@deepseek-ai/dsh-tool-pwsh'
+  disabled: !!js 'process.platform !== ''win32'''
+- id: tool-fs
+  name: '@deepseek-ai/dsh-tool-fs'
+- id: tool-fs-search
+  name: '@deepseek-ai/dsh-tool-fs-search'
+  config:
+    sampleOverCapGlobResults: false
+- id: tool-jobs
+  name: '@deepseek-ai/dsh-tool-jobs'
+- id: skill-filesystem
+  name: '@deepseek-ai/dsh-skill-filesystem'
+- id: tool-skill
+  name: '@deepseek-ai/dsh-tool-skill'
+- id: command-goal
+  name: '@deepseek-ai/dsh-command-goal'
+- id: tool-goal
+  name: '@deepseek-ai/dsh-tool-goal'
+- id: planning
+  name: 'cordis:group'
+  group: true
+  isolate:
+    planMode: true
+  config:
+    - id: plan-mode
+      name: '@deepseek-ai/dsh-plan-mode'
+      config:
+        section: |
+          You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+
+          Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
+
+          The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+
+          Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+
+          Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+
+          When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
+- id: compaction
+  name: 'cordis:group'
+  group: true
+  isolate:
+    compaction: true
+    toolResultPruner: true
+  config:
+    - id: compaction-basic
+      name: '@deepseek-ai/dsh-compaction-basic'
+    - id: command-compact
+      name: '@deepseek-ai/dsh-command-compact'
+    - id: tool-result-pruner
+      name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+      config:
+        thresholdChars: 8192
+        headChars: 4096
+        tailChars: 1024
+- id: delegation
+  name: 'cordis:group'
+  group: true
+  isolate:
+    workflowEngine: true
+  config:
+    - id: tool-subagent-control
+      name: '@deepseek-ai/dsh-tool-subagent-control'
+    - id: tool-subagent-list-agents
+      name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+    - id: tool-subagent
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: spawn
+        toolName: subagent
+        modelSelectionSettings: true
+        backgroundMode: continuable
+    - id: tool-subagent-fork
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: fork
+        toolName: subagent_fork
+        backgroundMode: continuable
+    - id: tool-subagent-codex
+      name: '@deepseek-ai/dsh-tool-subagent'
+      disabled: true
+      config:
+        provider: codex
+        toolName: subagent_codex
+        backgroundMode: one-shot
+        maxDepth: provider-managed
+    - id: tool-subagent-claude-code
+      name: '@deepseek-ai/dsh-tool-subagent'
+      disabled: true
+      config:
+        provider: claude-code
+        toolName: subagent_claude_code
+        backgroundMode: one-shot
+        maxDepth: provider-managed
+    - id: workflow-ptc
+      name: '@deepseek-ai/dsh-workflow-ptc'
+      config:
+        provider: spawn
+    - id: tool-workflow
+      name: '@deepseek-ai/dsh-tool-workflow'
+    - id: tool-ralph
+      name: '@deepseek-ai/dsh-tool-ralph'
+      disabled: true
+      config:
+        subagentProvider: spawn
+        maxRounds: 64
+- id: tool-ask-user
+  name: '@deepseek-ai/dsh-tool-ask-user'
+- id: tool-todo
+  name: '@deepseek-ai/dsh-tool-todo'
+  config:
+    allowParallelInProgress: true
+- id: tool-web
+  name: '@deepseek-ai/dsh-tool-web'
+  config:
+    fetch: true
+    searchTimeoutMs: 60000
+- id: present
+  name: '@deepseek-ai/dsh-tool-present'
+- id: tool-plugin-manager
+  name: '@deepseek-ai/dsh-plugin-manager/tools'
+  disabled: true
+- id: cli-bridge-opencode
+  name: '@luchenglong/cli-bridge/preset-opencode'