@luchenglong/cli-bridge 0.0.0-stage → 0.2.2

package/dynamic/mimo.host.template.mjs

@@ -0,0 +1,169 @@
+// dynamic/mimo.host.template.mjs — mimo 动态沙箱宿主模板（cordis_define code.host 源）。
+//
+// 构建（node scripts/build.mjs --only=mimo）把 core/bridge-kit.mjs 与
+// providers/mimo.mjs 分别内联进下方两个占位标记行（各占一行、行内仅此标记），
+// 生成 dynamic/mimo.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('mimo', snap)
+//    推给家级灯（旧 mimoCollector 服务名在 keystone 里保留别名）；动态形态不宣告
+//    mode（旧语义：普通模式灯仅在调用 mimo 时临时显示）。
+//  - mimo-desktop 在沙箱的形态（契约 §9）：无 fs 发现 desktop-api.json，且多数沙箱
+//    无 fetch —— 描述符 preflight 直接 abort 为 DESKTOP_UNREACHABLE 并提示改用
+//    backend=mimocode（旧仓返回 DESKTOP_UNSUPPORTED 的替代；语义升级，Lead 定案）。
+//    宿主若注入了 globalThis.fetch 且给出 MIMO_DESKTOP_PORT/MIMO_DESKTOP_TOKEN env，
+//    委托 execute 仍可走通（fetch 路径全部 typeof 守卫）。
+//  - mimo_settings 在沙箱不持久化（无 nodeFs → 描述符回显语义；旧 dynamic echo 形态）。
+//  - exe 解析（旧动态候选无 existsSync 校验，盲取候选 [0] 易 spawn 失败）：升级走
+//    agy 模板同款链路 —— MIMO_BIN/MIMO_CLI env > subprocess.resolveExecutable(PATH)。
+/*__KIT__*/
+/*__PROVIDER__*/
+/*__SCHED__*/
+
+return {
+  inject: ['tools', 'subprocess', 'systemPrompt', 'timer'],
+  apply(ctx) {
+    // 调度门禁（0.2.0）：设置面板关掉 mimo → 本形态不注册工具/政策段；fail-open。
+    if (!isBridgeEnabled('mimo', SCHED_ALL_IDS)) return
+    const subprocess = ctx.subprocess
+    const planMode = ctx.get('planMode')
+    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('mimo', snapshot); return }
+      } catch (e) { /* fall through to legacy alias */ }
+      try {
+        const legacy = ctx.get('mimoCollector')
+        if (legacy && typeof legacy.mergeSnapshot === 'function') legacy.mergeSnapshot(snapshot)
+      } catch (e) { /* 灯数据尽力而为 */ }
+    }
+
+    // exe：MIMO_BIN/MIMO_CLI env > PATH 查找 mimo（subprocess.resolveExecutable）。
+    // mimo-desktop 后端不 spawn：返回占位字符串让 kit 直达 delegates→execute/preflight。
+    async function resolveExe(backend, signal) {
+      if (backend === 'mimo-desktop') return 'mimo'
+      const bin = env.MIMO_BIN || env.MIMO_CLI || ''
+      if (bin) {
+        if (/\.(mjs|cjs|js)$/i.test(bin) && typeof process !== 'undefined' && process.execPath) return [process.execPath, bin]
+        return bin
+      }
+      return await subprocess.resolveExecutable('mimo', undefined, signal)
+    }
+
+    // 旧仓 CWD_FALLBACK 硬编码机器绝对路径；新语义：MIMO_MCP_CWD > MIMO_BRIDGE_CWD >
+    // workspaceRoot > process.cwd > '.'（沙箱无 process.cwd 可用时以 '.' 兜底）。
+    function getCwdFallback() {
+      if (env.MIMO_MCP_CWD) return String(env.MIMO_MCP_CWD)
+      if (env.MIMO_BRIDGE_CWD) return String(env.MIMO_BRIDGE_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 '.'
+    }
+
+    // 预选链（沙箱无 fs 读设置文件）：env MIMO_BRIDGE_BACKEND / MIMO_BACKEND。
+    function getPreferredBackend() {
+      return env.MIMO_BRIDGE_BACKEND || env.MIMO_BACKEND || null
+    }
+
+    function planActiveFor(exec) {
+      try {
+        if (planMode && exec && exec.agent) {
+          const st = planMode.get(exec.agent)
+          return !!(st && st.active)
+        }
+      } catch (e) {}
+      return false
+    }
+
+    provider.attach({ ctx, subprocess, resolveExe, getCwdFallback, getPreferredBackend, planActiveFor, 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) }
+    }))
+    // mimo_settings：沙箱无 nodeFs → 描述符内部自动降级为回显（不持久化）。
+    // render 适配：harness 契约是 render(args, value)，extraTools[].render 是
+    // renderSettings(value) 单参 —— 直接透传会把 args 当 value（渲染全空）。
+    for (const et of provider.extraTools) {
+      harness.registerTool(ctx, harness.defineTool({
+        name: et.name,
+        description: et.description,
+        parameters: et.inputSchema,
+        output: { schema: OUTPUT_SCHEMA, render: function (args, value) { return et.render ? et.render(value) : renderResult(value, provider) } },
+        execute: function (args, exec) { return et.logic(args, exec) }
+      }))
+    }
+
+    // 浏览器指示灯轮询的 RPC 面（旧 dynamic/handle('mimo_status') 语义）。
+    harness.handle('mimo_status', function () { return provider.statusToolLogic({}) })
+
+    // 旧 policy 文案 verbatim（提示词连续性红线）。
+    const policyText = [
+      'mimo-first execution policy (Xiaomi MiMo: MiMoCode CLI or MiMo Desktop client).',
+      '',
+      'Local backends (selectable in settings: backend = mimocode | mimo-desktop):',
+      '- mimocode (default): local `mimo` CLI (MiMoCode). Full DSH control (--dangerously-skip-permissions, never prompts).',
+      '- mimo-desktop: Xiaomi MiMo Desktop client local API (running Desktop app; uses its login/model/session UI).',
+      '',
+      'By default, dispatch runs in the background and returns a jobId immediately; collect via job_output and watch live progress via mimo_status.',
+      '',
+      'Decision table for tool selection:',
+      '- Single read/glob/grep or short (<30s) command -> Native tools.',
+      '- Implementing, editing, refactoring, debugging, builds, multi-file investigation -> mimo_run.',
+      '- Follow-ups on the same topic -> mimo_continue (with latest=true or sessionId; context is preserved).',
+      '- Final build/test verification of mimo output -> Native tools.',
+      '- Plan / read-only analysis -> mimo_run with mode=plan.',
+      '- Desktop-native work (Desktop session UI, shared Desktop login/model) -> prefer backend=mimo-desktop (or preselect it in settings).',
+      '',
+      'Backend preselection (settings):',
+      '- Default backend is configured OUT-OF-BAND (plugin config.backend / env MIMO_BRIDGE_BACKEND / settings file).',
+      '- Per-call `backend` argument overrides the default only when necessary.',
+      '- Do NOT invent a backend every call — use the preselected default.',
+      '',
+      'Context protocol (one topic = one mimo session):',
+      '- First dispatch on a topic: compact CONTEXT preamble (point to paths, do not paste file contents).',
+      '- Follow-ups: call mimo_continue and state only what is new.',
+      '',
+      'Execution & Fallback protocol:',
+      '- Dispatch defaults to background=true. Collect via job_output.',
+      '- On rate-limit/network/auth failure, a confirmation dialog offers DSH-local fallback.',
+      '- If result has fallback=true (status FALLBACK_TO_DSH), finish with native tools and NEVER call mimo again for this task.',
+      '- Never loop mimo calls; never ask mimo to call back into DSH.'
+    ].join('\n')
+
+    ctx.systemPrompt.section({
+      name: 'mimo:policy',
+      order: (typeof ctx.systemPrompt.getSectionOrder === 'function' ? ctx.systemPrompt.getSectionOrder('TOOL_SUBAGENT') : 2800) + 10,
+      text: policyText
+    })
+  }
+}

package/home-plugin/cli-bridge-indicator/cordis.patch.yml

@@ -0,0 +1,31 @@
+# CLI Bridge — bundle 补丁层（单一入口）
+#
+# 本文件由 DSH 插件系统在安装后自动作为 profile 的 bundle 层挂载：
+#   dsh plugin --profile web add @luchenglong/cli-bridge      (npm registry)
+#   dsh plugin --profile web add <本地包路径>                  (本地安装)
+# 声明位置: 主包 package.json 的 dsh.bundle.patch。
+#
+# 三个旧包（agy-first-bridge / codebuddy-first-bridge / mimo-first-bridge）
+# 各自的 bundle patch 在这里收敛为一行：
+#   - host 半：裸包名 '@luchenglong/cli-bridge' 经主包 package.json main 解析
+#     → home-plugin/cli-bridge-indicator/lib/index.mjs（多 provider 状态收集器）。
+#   - client 半（浏览器）：主包 package.json 的 dsh.client 声明被宿主
+#     client-modules 自动纳入花名册，无需单独一行。
+#     【红线契约】lib/client.js 的 __ModuleLoader__.load({ id }) 必须 === 包名
+#     "@luchenglong/cli-bridge"（scoped 名整体即 id；官方与社区 scoped 插件同机制），
+#     否则 arrive() 抛 'loaded without registering' 并使整屏插件页崩溃
+#     （agy v1.6.1 / codebuddy v1.1.8 / mimo 同款历史事故）。
+#   - agent preset 声明：不再走 bundle patch 内联行（@deepseek-ai/dsh-agent-preset
+#     包 0.1.7-alpha.1 才存在，旧 loader 对导入失败是致命的）。改由指示灯 host 半
+#     在 apply() 里 ctx.inject(['agentPresets']) 向注册表登记三个 preset
+#     （cordis-agy / codebuddy-first / cordis-mimo；旧 DSH 上注入器挂起零副作用）。
+#     定义与 legacy YAML 同源：lib/preset-declarations.mjs 直接 import
+#     preset/<dir>/plugin-list.mjs（buildPlugins(meta) 一份源两用），
+#     {__jsExpr} 字面量原样透传给注册器 —— 不存在第二个生成器。
+#
+# 机器特定配置请写在用户层补丁
+#   Windows: %APPDATA%\DSH Desktop\dsh-home\cordis.patch.yml
+# 的同 id 行里 — 用户层后应用，按行 id 整体覆盖本行 config。
+- insert:
+    - id: cli-bridge-indicator
+      name: '@luchenglong/cli-bridge'