@luchenglong/cli-bridge 0.0.0-stage → 0.2.3

package/preset/opencode-first/cli-bridge.mjs

@@ -0,0 +1,147 @@
+// preset/opencode-first/cli-bridge.mjs — opencode-first preset 的桥接插件（preset 宿主形态）。
+//
+// PROVIDER-CONTRACT.md §5：本模块只做「宿主接线」——构造描述符、attach、注册三工具、
+// 心跳/事件发布、opencode:policy 提示词段。全部执行/状态语义在
+// providers/opencode.mjs + core/bridge-kit.mjs。
+//
+// preset id 'opencode-first' 由 plugin-list.mjs 单源声明。
+//
+// 本模块是宿主进程内真 ESM：可 import node: 内建与包内相对路径；禁止 import
+// @deepseek-ai/*（解析根够不到 harness 包，历史论证 —— 契约 §8）。
+import { existsSync } from 'node:fs'
+
+import defineProvider, { resolveExePrefix } from '../../providers/opencode.mjs'
+import { renderResult, renderStatus } from '../../core/bridge-kit.mjs'
+import { isBridgeEnabled } from '../../core/scheduling.mjs'
+import { PROVIDER_IDS } from '../../providers/registry.mjs'
+
+export const name = 'cli-bridge-opencode'
+export const inject = ['tools', 'subprocess', 'systemPrompt', 'timer']
+
+const OUTPUT_SCHEMA = { type: 'object', additionalProperties: true }
+
+export function apply(ctx) {
+  // 调度门禁（0.2.0）：用户在设置面板关掉 opencode → 本形态不注册任何工具/政策段/心跳。
+  // 每次会话装配时现读文件（改设置下次会话即生效，无需重启宿主）；fail-open。
+  if (!isBridgeEnabled('opencode', PROVIDER_IDS)) return
+  const subprocess = ctx.subprocess
+  const sandboxPolicy = ctx.get('sandboxPolicy')
+
+  const provider = defineProvider({ process, env: process.env })
+
+  // 状态快照 → 家级灯（keystone 听 'opencode/status'，事件是 app 级广播）。
+  function publish(snapshot) {
+    try { ctx.emit('opencode/status', { snapshot }) } catch (e) { /* ignore */ }
+  }
+
+  // cwd 兜底：显式 cwd 参数 > env OPENCODE_MCP_CWD > 沙箱 workspaceRoot > process.cwd()。
+  function getCwdFallback() {
+    if (process.env.OPENCODE_MCP_CWD) return String(process.env.OPENCODE_MCP_CWD)
+    if (sandboxPolicy && typeof sandboxPolicy.workspaceRoot === 'string' && sandboxPolicy.workspaceRoot) return sandboxPolicy.workspaceRoot
+    return process.cwd()
+  }
+
+  // exe 解析优先级（与描述符 resolveExePrefix 同一套）：
+  //   面板 binPath（getSettings）> env OPENCODE_BIN/OPENCODE_CLI > 桌面版 V2 探测 > PATH。
+  // 二进制名 opencode-cli（V2 桌面版），不做 opencode.exe 兜底（V1/V2 不能并存）。
+  // .js/.mjs 目标经 process.execPath 包装（返回数组前缀，buildArgv 接受）。
+  const binPathSetting = (() => {
+    try {
+      const s = ctx.get && ctx.get('cliBridgeSettings')
+      const v = s && s.opencode ? s.opencode.binPath : ''
+      return typeof v === 'string' ? v : ''
+    } catch (e) { return '' }
+  })()
+  const candidates = resolveExePrefix(process.env, binPathSetting)
+
+  async function resolveExe(backend, signal) {
+    for (const c of candidates) {
+      if (/\.(mjs|cjs|js)$/i.test(c)) return [process.execPath, c]
+      // 绝对路径/已存在的文件直接用（桌面版探测结果）。
+      try { if (existsSync(c)) return c } catch (e) { }
+    }
+    return await subprocess.resolveExecutable('opencode-cli', undefined, signal)
+  }
+
+  provider.attach({ ctx, subprocess, resolveExe, getCwdFallback, publish })
+
+  // 宣告 opencode 优先模式：家级灯据此决定常驻显示（presetActive）。挂载即宣告 +
+  // 每 30s 心跳续租（TTL 75s，契约 §2）。
+  function announceMode() {
+    try {
+      const sid = (ctx.session && ctx.session.id) || ctx.sessionId || null
+      ctx.emit('opencode/mode', sid ? { active: true, sessionId: sid } : { active: true })
+    } catch (e) { /* ignore */ }
+  }
+  announceMode()
+  try { const t = ctx.setInterval ? ctx.setInterval(announceMode, 30000) : null; if (t && ctx.effect) ctx.effect(() => () => { try { t() } catch (e) {} }) } catch (e) {}
+
+  // ── 工具注册（执行进描述符三逻辑）────────────────────────────────────────────
+  ctx.effect(() => ctx.tools.register({
+    name: provider.tools.run.name,
+    description: provider.tools.run.description,
+    parameters: provider.tools.run.inputSchema,
+    output: { schema: OUTPUT_SCHEMA, render: (args, value) => renderResult(value, provider) },
+    execute: (args, exec) => provider.runToolLogic(args, exec)
+  }))
+  ctx.effect(() => ctx.tools.register({
+    name: provider.tools.continue.name,
+    description: provider.tools.continue.description,
+    parameters: provider.tools.continue.inputSchema,
+    output: { schema: OUTPUT_SCHEMA, render: (args, value) => renderResult(value, provider) },
+    execute: (args, exec) => provider.continueToolLogic(args, exec)
+  }))
+  ctx.effect(() => ctx.tools.register({
+    name: provider.tools.status.name,
+    description: provider.tools.status.description,
+    parameters: provider.tools.status.inputSchema,
+    output: { schema: OUTPUT_SCHEMA, render: (args, value) => renderStatus(value, provider) },
+    execute: (args) => provider.statusToolLogic(args)
+  }))
+  for (const et of provider.extraTools || []) {
+    ctx.effect(() => ctx.tools.register({
+      name: et.name,
+      description: et.description,
+      parameters: et.inputSchema,
+      output: { schema: OUTPUT_SCHEMA, render: et.render || ((args, value) => renderResult(value, provider)) },
+      execute: (args, exec) => et.logic(args, exec)
+    }))
+  }
+
+  // policy 段（新 provider 无旧文案可 verbatim 继承；按实测 CLI 能力撰写）。
+  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: call opencode_models (or pass a model id ending in -free, e.g. "opencode/nemotron-3-ultra-free") unless this task genuinely needs a frontier model. Free models are listed first by opencode_models.',
+    '- 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: if a run fails for auth/API-key reasons, tell the user to run `opencode auth login`. Do not retry in a loop.',
+    '- An unknown provider/model surfaces as a run failure, not a silent fallback — use opencode_models to check availability first.'
+  ].join('\n')
+
+  ctx.effect(() => ctx.systemPrompt.section({
+    name: 'opencode:policy',
+    order: (typeof ctx.systemPrompt.getSectionOrder === 'function' ? ctx.systemPrompt.getSectionOrder('TOOL_SUBAGENT') : 2800) + 10,
+    text: policyText
+  }))
+}

package/preset/opencode-first/plugin-list.mjs

@@ -0,0 +1,26 @@
+// preset/opencode-first/plugin-list.mjs — opencode-first 预设的单源插件清单（PROVIDER-CONTRACT §5）。
+//
+// = 官方 standard 基线（standard-base.mjs）+ opencode 桥接行 + persona 差异。
+// preset id 'opencode-first'：本包新增的第四家 CLI，无旧包兼容包袱，故 id 直接用
+// provider id + '-first'（与 codebuddy-first 同构；agy/mimo 的 cordis-* 前缀是旧包
+// 历史遗留，不可套用到新 provider 上）。
+import { standardPluginRows, bridgeRow } from '../standard-base.mjs'
+
+export const meta = {
+  id: 'opencode-first',
+  name: 'OpenCode 执行代理',
+  description: '完整编码 Agent（standard 全部能力），额外提供 opencode_run/opencode_continue 工具并注入"opencode 优先"策略：各种模式下先把实现、编辑、调试、构建、跨文件排查派给本机 opencode CLI（DSH 完全控制、opencode 无提示改文件、默认后台执行），原生工具仅用于只读查询与最终验证。',
+  order: 40
+}
+
+export function buildPlugins(deps) {
+  const rows = standardPluginRows()
+  // persona 段：与三家旧 preset 同构（dsh-persona 要求 prefix 必填 + suffix 可选）。
+  const persona = rows.find((r) => r.id === 'persona')
+  if (persona && persona.config) {
+    persona.config.prefix = 'You are a coding agent powered by the {{model}} model.'
+    persona.config.suffix = 'Your working directory is {{cwd}}.'
+  }
+  rows.push(bridgeRow('opencode', deps && deps.bridgeName))
+  return rows
+}

package/preset/opencode-first/preset.yml

@@ -0,0 +1,3 @@
+name: OpenCode 执行代理
+description: '完整编码 Agent（standard 全部能力），额外提供 opencode_run/opencode_continue 工具并注入"opencode 优先"策略：各种模式下先把实现、编辑、调试、构建、跨文件排查派给本机 opencode CLI（DSH 完全控制、opencode 无提示改文件、默认后台执行），原生工具仅用于只读查询与最终验证。'
+order: 40

package/preset/standard-base.mjs

@@ -0,0 +1,102 @@
+// preset/standard-base.mjs — 官方 standard preset 的忠实移植基线（keystone 单源）。
+//
+// 三个 cli-bridge preset（cordis-agy / codebuddy-first / cordis-mimo）都 = 本基线 +
+// 各自桥接行 + 各自的 persona/门禁差异。基线内容对齐官方 dsh-web-app
+// presets/standard.patch.yml（0.1.7-rc.1）：行序、id、config 逐项一致（上游改版后由
+// test/preset-declaration.test.mjs 与已安装 standard.patch.yml 逐行比对防漂移）。
+//
+// `!!js` 表达式的 JS 字面量等价物是 { __jsExpr: "…" } —— 这是 loader interpolate 的
+// 原生输入形态（agentPresets.register 直接接受，见 codebuddy-first v1.2.0 实测），
+// **不要**把它编译成真函数。
+
+/** YAML `!!js expr` 的 JS 字面量等价物（loader interpolate 的原生输入形态）。 */
+export function jsExpr(expr) {
+  return { __jsExpr: String(expr) }
+}
+
+// 官方 standard preset 的 plan-mode 段全文（0.1.7-rc.1，块标量内容，段间双换行）。
+export const PLAN_MODE_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.',
+].join('\n\n') + '\n'
+
+/**
+ * 官方 standard preset 的插件行表（不含 persona 差异与桥接行）。
+ * persona 行返回【副本】供 provider 修改 prefix/suffix；其余行按原样返回。
+ * @returns {object[]}
+ */
+export function standardPluginRows() {
+  return [
+    { 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: jsExpr("process.platform === 'win32'") },
+    { id: 'tool-pwsh', name: '@deepseek-ai/dsh-tool-pwsh', disabled: jsExpr("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: PLAN_MODE_SECTION } },
+      ],
+    },
+    {
+      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 },
+  ]
+}
+
+/** 桥接行（每个 preset 的唯一增量）。deps.bridgeName 必须等于 package.json 的 exports 子路径。 */
+export function bridgeRow(id, bridgeName) {
+  return { id: 'cli-bridge-' + id, name: bridgeName || ('@luchenglong/cli-bridge/preset-' + id) }
+}