zen-gitsync 2.18.7 → 2.18.9

package/src/ui/server/routes/workbench/chatPrompts.test.js

@@ -0,0 +1,114 @@
+// Copyright 2026 xz333221
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// 「和 g ai 对话时固定注入的两块提示词」的拼装与取数口径。
+//
+// 这个能力是**纯 prompt 注入**的：没有按钮、没有状态、界面上看不出对错。
+// 改 agentChat.js / runExternalTurn.js 的人（哪怕只是把一段挪个位置）会无声地把它弄掉，
+// 而用户只会觉得"模型今天不太听话"。所以口径在这一层逐条钉住，注入点那条链路由
+// agentChatShared.test.js 跑真实 runAgentTurn 验（见那里的"用户固定提示词"用例）。
+//
+// 注意：必须在 import 之前把 USERPROFILE/HOME 指到沙箱 —— chatPrompts.js 会连带
+// 加载 configManager 与 orchestratorStore，它们按 home 定位 ~/.zen-gitsync。
+// 本文件里的用例全部走注入口（不读真实配置），沙箱只是防"哪天有人加了真实读取"。
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { mkdtempSync } from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+
+const SANDBOX = mkdtempSync(path.join(os.tmpdir(), 'zen-chat-prompts-'))
+process.env.USERPROFILE = SANDBOX
+process.env.HOME = SANDBOX
+delete process.env.HOMEDRIVE
+delete process.env.HOMEPATH
+
+const { buildChatPromptSection, resolveChatPromptSection } = await import('./chatPrompts.js')
+
+// ── 拼装（纯函数）─────────────────────────────────────────
+
+test('两块都没配 → 空串（调用方据此完全跳过注入，连一节标题都不出现）', () => {
+  assert.equal(buildChatPromptSection({}), '')
+  assert.equal(buildChatPromptSection({ gaiPrompt: '', dispatchPrompt: '' }), '')
+  // 只有空白也算没配 —— 用户清空后留下一堆换行，不该在提示词里留一节空标题
+  assert.equal(buildChatPromptSection({ gaiPrompt: '   \n\n ', dispatchPrompt: '\t' }), '')
+})
+
+test('两块都在 → 各带自己的小标题，g ai 那段在前', () => {
+  const out = buildChatPromptSection({ gaiPrompt: '回答用中文', dispatchPrompt: '改完就提交' })
+  assert.match(out, /### g ai 默认提示词\n回答用中文/)
+  assert.match(out, /### 派发任务的提示词（与工作台派发任务时附加的是同一份）\n改完就提交/)
+  assert.ok(out.indexOf('回答用中文') < out.indexOf('改完就提交'), 'g ai 那段必须在前')
+})
+
+test('只配一块 → 只出那一块（另一块不留空标题）', () => {
+  const onlyGai = buildChatPromptSection({ gaiPrompt: '回答用中文' })
+  assert.match(onlyGai, /### g ai 默认提示词/)
+  assert.doesNotMatch(onlyGai, /### 派发任务的提示词/)
+
+  const onlyDispatch = buildChatPromptSection({ dispatchPrompt: '改完就提交' })
+  assert.match(onlyDispatch, /### 派发任务的提示词/)
+  assert.doesNotMatch(onlyDispatch, /### g ai 默认提示词/)
+})
+
+test('正文前后空白被裁掉，中间原样保留（用户排版不被破坏）', () => {
+  const out = buildChatPromptSection({ gaiPrompt: '\n\n第一段\n\n第二段\n\n' })
+  assert.match(out, /### g ai 默认提示词\n第一段\n\n第二段$/)
+})
+
+test('英文界面走英文标题（与系统提示词同一套 locale 判定）', () => {
+  const out = buildChatPromptSection({ gaiPrompt: 'answer in Chinese', locale: 'en-US' })
+  assert.match(out, /### g ai default prompt/)
+  assert.match(out, /Standing instructions|Settings/)
+})
+
+test('非字符串入参不炸（手改配置塞了数字 / 对象）', () => {
+  assert.equal(buildChatPromptSection({ gaiPrompt: 42, dispatchPrompt: {} }), '')
+})
+
+// ── 取数 ────────────────────────────────────────────────
+
+test('两块分别来自两处：g ai 默认提示词取 config，派发提示词取 orchestrator', async () => {
+  const seenCwd = []
+  const out = await resolveChatPromptSection({
+    cwd: 'D:\\ws\\alpha',
+    loadAgentPrompt: async () => '回答用中文',
+    loadDispatchPrompt: async (cwd) => { seenCwd.push(cwd); return '改完就提交' },
+  })
+  assert.match(out, /回答用中文/)
+  assert.match(out, /改完就提交/)
+  assert.deepEqual(seenCwd, ['D:\\ws\\alpha'], '派发提示词必须按本轮 cwd 解析（项目级那条靠它生效）')
+})
+
+test('取数抛错一律当"没配"，绝不把整轮对话打挂', async () => {
+  const both = await resolveChatPromptSection({
+    loadAgentPrompt: async () => { throw new Error('config.json 坏了') },
+    loadDispatchPrompt: async () => { throw new Error('orchestrator.json 坏了') },
+  })
+  assert.equal(both, '', '两边都挂 = 不注入')
+
+  // 一边挂另一边照常：坏的那份不该连累好的那份
+  const half = await resolveChatPromptSection({
+    loadAgentPrompt: async () => '回答用中文',
+    loadDispatchPrompt: async () => { throw new Error('orchestrator.json 坏了') },
+  })
+  assert.match(half, /回答用中文/)
+  assert.doesNotMatch(half, /### 派发任务的提示词/)
+})
+
+test('返回值是字符串而不是 undefined（调用方直接拼进 system，undefined 会印出字面量）', async () => {
+  const out = await resolveChatPromptSection({ loadAgentPrompt: async () => '', loadDispatchPrompt: async () => '' })
+  assert.equal(typeof out, 'string')
+  assert.equal(out, '')
+})

package/src/ui/server/routes/workbench/executorModels.js

@@ -25,7 +25,7 @@
 //
 // 这里把「读三个配置文件」这件事收口成一个模块，让前端能在选择器里直接显示。
 //
-// ── 三家配置文件的形状（这是本模块存在的全部理由）────────────────────────
+// ── 四家配置文件的形状（这是本模块存在的全部理由）────────────────────────
 //
 //   claude   ~/.claude/settings.json         JSON。模型在 env 里，且有**别名两层**：
 //            ANTHROPIC_DEFAULT_SONNET_MODEL 是 CLI 认识的名字
@@ -48,6 +48,10 @@
 //            variant（截图里那个蓝色的 max）在同文件的顶层 variant 表里。
 //            两处都没有才算"没指定"，返回值里用 source 区分（config / state）。
 //
+//   codebuddy ~/.codebuddy/settings.json      JSON。顶层 `model` 字符串
+//            （--settings '{"model":"..."}' 的落盘处；没写过就是没配，
+//             CLI 用自己的内置默认 —— 那种情况下这里如实报 null）。
+//
 // ── 三条必须守住的底线 ──────────────────────────────────────────────────────
 //
 // 1. **纯只读**：只 fs.readFile，一个字节都不写。改用户 CLI 的配置是绝对禁区。
@@ -257,25 +261,42 @@ function detectOpencode(cfgJson, stateJson) {
   return detectOpencodeConfig(cfgJson) || detectOpencodeState(stateJson);
 }
 
+/**
+ * codebuddy：~/.codebuddy/settings.json 的顶层 model。
+ *
+ * 与另三家一个重要差别：codebuddy **没有"第二处"**—— TUI 里选的模型会写回
+ * settings.json（`codebuddy config set -g model <id>`），不存在 opencode 那种
+ * "选择躺在 state 里、配置是空的"分裂。所以读一个文件就够。
+ * 没配 → null：CLI 有自己的内置默认（init 事件里能看到，如 fast-model），
+ * 但那是 CLI 的默认而不是用户的设置，按本模块的底线不猜、不报。
+ */
+function detectCodebuddy(json) {
+  const raw = json && json.model;
+  if (typeof raw === 'string' && raw.trim()) {
+    return { model: raw.trim(), display: null, provider: null, source: 'config' };
+  }
+  return null;
+}
+
 function escapeRe(s) {
   return String(s).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
 
 /**
- * 探测三个执行器当前配置的模型。
+ * 探测四个执行器当前配置的模型。
  *
  * @param {object} [opts]
  * @param {string} [opts.homeDir] 测试沙箱用（默认 os.homedir()）
- * @returns {Promise<{ claude: object|null, codex: object|null, opencode: object|null }>}
+ * @returns {Promise<{ claude: object|null, codex: object|null, opencode: object|null, codebuddy: object|null }>}
  *          每项 `{ model, display, provider, source }`；该执行器没配模型时为 null。
  *          source = 'config'（配置文件里写死的）| 'state'（CLI 自己记的"上次用的"）。
  *
- * 三路并发、互不阻塞：任何一个配置文件读失败都只让**它自己**变成 null。
+ * 四路并发、互不阻塞：任何一个配置文件读失败都只让**它自己**变成 null。
  */
 export async function detectExecutorModels({ homeDir } = {}) {
   const home = homeDir || os.homedir();
 
-  const [claudeRaw, codexRaw, opencodeJsonRaw, opencodeJsoncRaw, opencodeStateRaw] = await Promise.all([
+  const [claudeRaw, codexRaw, opencodeJsonRaw, opencodeJsoncRaw, opencodeStateRaw, codebuddyRaw] = await Promise.all([
     readTextOrNull(path.join(home, '.claude', 'settings.json')),
     readTextOrNull(path.join(home, '.codex', 'config.toml')),
     // .json 优先（标准名），.jsonc 兜底。opencode 两个都认。
@@ -283,6 +304,8 @@ export async function detectExecutorModels({ homeDir } = {}) {
     readTextOrNull(path.join(home, '.config', 'opencode', 'opencode.jsonc')),
     // TUI 的"最近使用"（不写回配置文件，见 detectOpencodeState 的注释）
     readTextOrNull(path.join(home, '.local', 'state', 'opencode', 'model.json')),
+    // CodeBuddy Code CLI（与 WorkBuddy 桌面版共用的配置目录）
+    readTextOrNull(path.join(home, '.codebuddy', 'settings.json')),
   ]);
 
   const pickJson = (raw) => {
@@ -295,6 +318,7 @@ export async function detectExecutorModels({ homeDir } = {}) {
   // 于是注释里写的"jsonc 兜底"是死代码 —— 只写了 .jsonc 的机器永远显示未配置。
   const opencodeCfg = pickJson(opencodeJsonRaw) || pickJson(opencodeJsoncRaw);
   const opencodeState = pickJson(opencodeStateRaw);
+  const codebuddyCfg = pickJson(codebuddyRaw);
 
   return {
     claude: claudeCfg && typeof claudeCfg.env === 'object' && claudeCfg.env
@@ -302,6 +326,7 @@ export async function detectExecutorModels({ homeDir } = {}) {
       : null,
     codex: codexRaw ? detectCodex(codexRaw) : null,
     opencode: detectOpencode(opencodeCfg, opencodeState),
+    codebuddy: detectCodebuddy(codebuddyCfg),
   };
 }
 

package/src/ui/server/routes/workbench/executorModels.test.js

@@ -121,12 +121,14 @@ const CODEX_TOML = [
   'model = "inner-model"',
 ].join('\n')
 const OPENCODE_JSONC = '{\n  // 注释\n  "model": "anthropic/claude-x",\n}'
+const CODEBUDDY_JSON = JSON.stringify({ model: 'deepseek-v4-1-flash-260910' })
 
-test('detectExecutorModels: 三家配置齐全时各自读出模型', async () => {
+test('detectExecutorModels: 四家配置齐全时各自读出模型', async () => {
   const home = await makeHome({
     '.claude/settings.json': CLAUDE_JSON,
     '.codex/config.toml': CODEX_TOML,
     '.config/opencode/opencode.jsonc': OPENCODE_JSONC,
+    '.codebuddy/settings.json': CODEBUDDY_JSON,
   })
   const out = await detectExecutorModels({ homeDir: home })
 
@@ -141,6 +143,15 @@ test('detectExecutorModels: 三家配置齐全时各自读出模型', async () =
   assert.deepEqual(out.opencode, {
     model: 'anthropic/claude-x', display: null, provider: null, source: 'config',
   })
+  // codebuddy：一个文件一处键，没有"第二来源"（TUI 选择会写回 settings.json）
+  assert.deepEqual(out.codebuddy, {
+    model: 'deepseek-v4-1-flash-260910', display: null, provider: null, source: 'config',
+  })
+})
+
+test('detectExecutorModels: codebuddy 没配 model 时为 null（CLI 内置默认不冒名）', async () => {
+  const home = await makeHome({ '.codebuddy/settings.json': '{"theme":"dark"}' })
+  assert.equal((await detectExecutorModels({ homeDir: home })).codebuddy, null)
 })
 
 test('detectExecutorModels: 只有 .jsonc 时 opencode 仍读得到 [回归]', async () => {
@@ -254,10 +265,10 @@ test('detectExecutorModels: claude 显式 ANTHROPIC_MODEL 优先于档位别名'
   })
 })
 
-test('detectExecutorModels: 一个配置文件都没有时三项全 null 且不抛', async () => {
+test('detectExecutorModels: 一个配置文件都没有时四项全 null 且不抛', async () => {
   const home = await makeHome()
   const out = await detectExecutorModels({ homeDir: home })
-  assert.deepEqual(out, { claude: null, codex: null, opencode: null })
+  assert.deepEqual(out, { claude: null, codex: null, opencode: null, codebuddy: null })
 })
 
 test('detectExecutorModels: 配置残缺/是目录/内容不是 JSON 时只让自己变 null', async () => {
@@ -265,9 +276,10 @@ test('detectExecutorModels: 配置残缺/是目录/内容不是 JSON 时只让
     '.claude/settings.json': '{ 这不是 JSON', // 解析失败 → null
     '.codex/config.toml': '# 只有注释，没有 model\n', // 无 model → null
     '.config/opencode/opencode.json': '{"model":""}', // 空串 → null
+    '.codebuddy/settings.json': '{"model":123}', // 非字符串 → null
   })
   const out = await detectExecutorModels({ homeDir: home })
-  assert.deepEqual(out, { claude: null, codex: null, opencode: null })
+  assert.deepEqual(out, { claude: null, codex: null, opencode: null, codebuddy: null })
 })
 
 test('detectExecutorModels: 返回值里绝不出现任何密钥', async () => {

package/src/ui/server/routes/workbench/index.js

@@ -1660,7 +1660,7 @@ export function registerWorkbenchRoutes({
    * 无参数、服务端不算缓存：三个文件都很小，每次实读比让前端踩脏缓存划算；
    * 前端那边（stores/toolsStore）自己按分钟级 TTL + 并发去重压请求频率。
    * 返回值里某项为 null = 那个 CLI 没在配置里写模型，前端照实显示「未在配置中指定」。
-   * key 恒为 claude / codex / opencode 三个，与 TASK_EXECUTOR_OPTIONS 对齐。
+   * key 恒为 claude / codex / opencode / codebuddy 四个，与 TASK_EXECUTOR_OPTIONS 对齐。
    */
   app.get('/api/workbench/executor-models', asyncRoute(async (_req, res) => {
     const detected = await detectExecutorModels();

package/src/ui/server/routes/workbench/jobActivity.js

@@ -216,7 +216,7 @@ export function jobDurationMs(job) {
 }
 
 /**
- * 本轮跑的是哪个执行器（`claude` | `opencode` | `codex`）。
+ * 本轮跑的是哪个执行器（`claude` | `opencode` | `codex` | `codebuddy`）。
  *
  * 只在**认出是已知执行器**时才回值：job.agent 来自 jobs.json（会被手工编辑、也读过
  * 别实例写的旧记录），回一个前端不认识的字符串只会让卡片上的图标位空着或显示错品牌。
@@ -224,10 +224,10 @@ export function jobDurationMs(job) {
  * 猜错的执行器比不显示更糟。
  *
  * 这里**刻意不 import taskRunner 的 TASK_EXECUTORS**：taskRunner 拉起进程、依赖一堆
- * 运行时模块，而本模块被 projectRegistry（5s 轮询的看板）直接引用，没必要为了三个
+ * 运行时模块，而本模块被 projectRegistry（5s 轮询的看板）直接引用，没必要为了四个
  * 字符串把整条执行链拖进来。新增执行器时这里和 taskRunner 一起改。
  */
-const KNOWN_EXECUTORS = ['claude', 'opencode', 'codex'];
+const KNOWN_EXECUTORS = ['claude', 'opencode', 'codex', 'codebuddy'];
 
 export function jobAgent(job) {
   const v = job && typeof job.agent === 'string' ? job.agent.trim().toLowerCase() : '';

package/src/ui/server/routes/workbench/jobActivity.test.js

@@ -181,6 +181,7 @@ test('jobAgent：认识的执行器原样返回', () => {
   assert.equal(jobAgent({ agent: 'claude' }), 'claude');
   assert.equal(jobAgent({ agent: 'opencode' }), 'opencode');
   assert.equal(jobAgent({ agent: 'codex' }), 'codex');
+  assert.equal(jobAgent({ agent: 'codebuddy' }), 'codebuddy');
 });
 
 test('jobAgent：大小写与首尾空白归一后再认（jobs.json 会被手工编辑）', () => {

package/src/ui/server/routes/workbench/runExternalTurn.js

@@ -23,18 +23,22 @@
 //
 // ⚠️ 两条不重复实现的红线（本仓库 agentParity.test.js 就是为这类分叉立的规矩）：
 //   1. **spawn 与协议解析一律复用 taskRunner.js**，绝不在这里再写一份。
-//      `createClaudeEventHandler` / `createOpencodeEventHandler` / `createCodexEventHandler`
+//      `createClaudeEventHandler` / `createOpencodeEventHandler` /
+//      `createCodexEventHandler` / `createCodebuddyEventHandler`
 //      的签名是 `(job, appendOutput, appendThinking, toolCalls)` —— 回调早已抽象好，
 //      这里只是换一组回调（推 SSE 而不是推工作台面板），所以适配层能很薄。
 //   2. **权限档不在这里决定**。taskRunner 的 launcher 已经带死了各自的档位
 //      （claude: --permission-mode bypassPermissions --dangerously-skip-permissions；
-//        opencode: --auto；codex: --dangerously-bypass-approvals-and-sandbox），
-//      与工作台任务执行保持一致。要改档位请改 launcher，别在这儿加参数。
+//        opencode: --auto；codex: --dangerously-bypass-approvals-and-sandbox；
+//        codebuddy: -y），与工作台任务执行保持一致。要改档位请改 launcher，别在这儿加参数。
 //
-// 关于 headless 权限（2026-09-28 实测，三家在非交互下的真实行为）：
+// 关于 headless 权限（2026-09-28 实测，三家在非交互下的真实行为；codebuddy 2026-10-12 补测）：
 //   claude   默认档也能跑，但不放开会挡住写操作；工作台那套是 bypassPermissions。
 //   codex    默认档是只读沙箱（写文件被拦），所以要 --dangerously-bypass-...
 //   opencode **不给 --auto 会卡死**（在等一个永远不会有人回答的交互式批准）。
+//   codebuddy 不给 -y 时写操作被拦（init 事件回传 permissionMode 可验证）；
+//             另外它每次运行自带引擎服务器，默认端口 62443 会被 WorkBuddy
+//             桌面版占着，所以 launcher 固定传 --port 0 让 OS 选空闲端口。
 //   这正是 AgentView 里没有终端、没人能点"允许"所决定的 —— 必须预设档位。
 
 import { spawn, execFile } from 'child_process';
@@ -42,27 +46,19 @@ import { logger } from './shared.js';
 import { engineLabel } from './agentEngines.js';
 import {
   createToolCallTracker,
-  createClaudeEventHandler,
-  createOpencodeEventHandler,
-  createCodexEventHandler,
-  launchClaudeInNewWindow,
-  launchOpencodeRun,
-  launchCodexExec,
+  EXECUTOR_LAUNCHERS,
+  EXECUTOR_HANDLERS,
 } from './taskRunner.js';
 
-/** 引擎 → spawn 实现。复用 taskRunner，不另写（见文件头红线 1）。 */
-export const ENGINE_LAUNCHERS = {
-  claude: launchClaudeInNewWindow,
-  opencode: launchOpencodeRun,
-  codex: launchCodexExec,
-};
+/**
+ * 引擎 → spawn 实现。直接复用 taskRunner 的运行时分发表（EXECUTOR_LAUNCHERS）——
+ * 不在这里另抄一张表：那张表已经是"执行器 → launcher"的唯一真相源，抄一份就等于
+ * 给未来某次"加了第五家只改了一处"埋雷。别名导出只为保持本模块对外的旧名字。
+ */
+export const ENGINE_LAUNCHERS = EXECUTOR_LAUNCHERS;
 
-/** 引擎 → NDJSON 事件处理器工厂。同样复用 taskRunner。 */
-export const ENGINE_HANDLERS = {
-  claude: createClaudeEventHandler,
-  opencode: createOpencodeEventHandler,
-  codex: createCodexEventHandler,
-};
+/** 引擎 → NDJSON 事件处理器工厂。同上，复用 taskRunner 的 EXECUTOR_HANDLERS。 */
+export const ENGINE_HANDLERS = EXECUTOR_HANDLERS;
 
 /** 输出片段最长保留多少字符（与前端 MAX_LOG_DISPLAY 的口径一致，防止会话文件膨胀） */
 const MAX_ACCUM = 400_000;
@@ -90,7 +86,7 @@ function killChildTree(child) {
  *
  * @param {object}   args
  * @param {object}   args.session        会话记录（会被就地更新：messages / engineSessionId）
- * @param {string}   args.engine         'claude' | 'opencode' | 'codex'
+ * @param {string}   args.engine         'claude' | 'opencode' | 'codex' | 'codebuddy'
  * @param {string}   args.userMessage    用户这一轮说的话
  * @param {string}   args.cwd            工作目录
  * @param {string}   [args.promptPrefix] 拼在用户消息**前面**的工作区状态块（见 agentRoutes）
@@ -275,8 +271,9 @@ export async function runExternalTurn({
     });
   }
 
-  // 续聊标识：三家字段名不同（claude session_id / opencode sessionID / codex thread_id），
-  // 但 taskRunner 的 handler 已经统一落到 job.claudeSessionId 上，这里只做搬运。
+  // 续聊标识：各家字段名不同（claude session_id / opencode sessionID / codex thread_id /
+  // codebuddy session_id），但 taskRunner 的 handler 已经统一落到 job.claudeSessionId 上，
+  // 这里只做搬运。
   if (job.claudeSessionId) session.engineSessionId = job.claudeSessionId;
 
   send({ type: 'done', content: aborted ? `${text}\n\n[已停止]` : text });

package/src/ui/server/routes/workbench/runExternalTurn.test.js

@@ -127,6 +127,40 @@ test('codex:exec --json → 同一组事件（item.* 分派）', async () => {
   assert.equal(session.engineSessionId, 'th-1');
 });
 
+test('codebuddy:stream-json → 同一组事件（协议与 claude 对齐，特有事件被忽略）', async () => {
+  // 样例取自 2026-10-12 实测（CLI 2.164.0）：init 带 session_id / apiKeySource，
+  // 工具调用是"tool_use(running) → user(tool_result)"两条，另有 system/status、
+  // ai-title 两个 cbc 特有事件必须被无视。
+  const lines = [
+    JSON.stringify({ type: 'system', subtype: 'init', session_id: 'cbc-sess-1', apiKeySource: 'www.workbuddy.cn', model: 'fast-model', permissionMode: 'bypassPermissions' }),
+    JSON.stringify({ type: 'system', subtype: 'status', status: 'compacting', session_id: 'cbc-sess-1' }),
+    JSON.stringify({ type: 'assistant', message: { content: [{ type: 'text', text: '读一下' }] } }),
+    JSON.stringify({ type: 'assistant', message: { content: [{ type: 'tool_use', id: 'tu-1', name: 'Read', input: { file_path: 'a.txt' } }] } }),
+    JSON.stringify({ type: 'user', message: { content: [{ type: 'tool_result', tool_use_id: 'tu-1', content: [{ type: 'text', text: 'hello' }] }] } }),
+    JSON.stringify({ type: 'ai-title', title: '读文件' }),
+    JSON.stringify({ type: 'assistant', message: { content: [{ type: 'text', text: '完了' }] } }),
+    JSON.stringify({ type: 'result', subtype: 'success', is_error: false, session_id: 'cbc-sess-1' }),
+  ];
+  const session = baseSession();
+  const c = collector();
+  await runExternalTurn({
+    session, engine: 'codebuddy', userMessage: '读 a.txt', cwd: 'D:/ws',
+    send: c.send,
+    launchers: { codebuddy: async () => ({ pid: 4242, child: fakeChild(lines) }) },
+  });
+
+  assert.equal(c.of('content').map(e => e.delta).join(''), '读一下完了');
+  const starts = c.of('tool_call_start');
+  assert.equal(starts.length, 1);
+  assert.equal(starts[0].toolCallId, 'tu-1');
+  assert.equal(starts[0].name, 'Read');
+  assert.match(String(c.of('tool_result')[0].result), /hello/);
+  assert.equal(c.of('error').length, 0);
+  assert.equal(c.of('done').length, 1);
+  // 续聊标识搬运：cbc 的 session_id → session.engineSessionId（--resume 用）
+  assert.equal(session.engineSessionId, 'cbc-sess-1');
+});
+
 test('非 JSON 行（CLI 的告警）原样贴出来，不当成事件丢掉', async () => {
   const session = baseSession();
   const c = collector();