agentworkshop 0.2.1

package/scripts/test-goal-summary.ts

@@ -0,0 +1,202 @@
+/**
+ * goal 收口总结验证:
+ *  Phase 1(无 LLM,确定性):goal 父任务无总结直接 complete → taskEngine 保底合成
+ *    「目标完成总结」artifact;已有总结(lead 自写)时不重复合成。
+ *  Phase 2(真实 omp):goal 模式全链路 —— lead 按 criteria 判定收口,断言最终
+ *    artifacts 含【目标完成总结】且 goal-summary 事件广播(monitor 可见)。
+ *
+ * 运行: npx tsx scripts/test-goal-summary.ts [--real]
+ */
+import type { DatabaseSync } from 'node:sqlite'
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { createChannelRepo } from '../server/services/workshop/db/channel.repo'
+import { createAgentRepo } from '../server/services/workshop/db/agent.repo'
+import { createChannelAgentRepo } from '../server/services/workshop/db/channel-agent.repo'
+import { createTaskRepo } from '../server/services/workshop/db/task.repo'
+import { createMemoryRepo } from '../server/services/workshop/db/memory.repo'
+import { createChannelEventRepo } from '../server/services/workshop/db/channel-event.repo'
+import { createTeamRepo } from '../server/services/workshop/db/team.repo'
+import { createTeamMemberRepo } from '../server/services/workshop/db/team-member.repo'
+import { createMessageRepo } from '../server/services/workshop/db/message.repo'
+import { createSubscriptionRepo } from '../server/services/workshop/db/subscription.repo'
+import { createAgentChannelManager } from '../server/services/workshop/runtime/manager'
+import type { AgentChannelManager } from '../server/services/workshop/runtime/manager'
+import { createAgentImpl } from '../server/services/workshop/agents/factory'
+import { monitorChannel } from '../server/services/workshop/runtime/monitor'
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = ''): void => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+function makeManager(db: DatabaseSync): AgentChannelManager {
+  return createAgentChannelManager({
+    repos: {
+      channels: createChannelRepo(db),
+      agents: createAgentRepo(db),
+      channelAgents: createChannelAgentRepo(db),
+      messages: createMessageRepo(db),
+      subscriptions: createSubscriptionRepo(db),
+      tasks: createTaskRepo(db),
+      memories: createMemoryRepo(db),
+      channelEvents: createChannelEventRepo(db),
+      teams: createTeamRepo(db),
+      teamMembers: createTeamMemberRepo(db),
+    },
+    implFactory: createAgentImpl,
+    db,
+  })
+}
+
+const engineOf = (manager: AgentChannelManager) => (manager as unknown as {
+  getTaskEngine(): {
+    get(id: string): { state: string, title: string, artifacts: Array<{ name: string, parts: Array<{ text?: string }> }> } | undefined
+    list(channelId: string): Array<{ id: string, state: string, title: string, parentId: string | null }>
+    complete(id: string, artifacts?: unknown[]): unknown
+  }
+}).getTaskEngine()
+
+async function waitTerminal(manager: AgentChannelManager, channelId: string, taskId: string, timeoutMs: number): Promise<string> {
+  const engine = engineOf(manager)
+  const deadline = Date.now() + timeoutMs
+  for (;;) {
+    const t = engine.get(taskId)
+    if (t && ['COMPLETED', 'FAILED', 'CANCELED'].includes(t.state)) return t.state
+    if (Date.now() >= deadline) return t?.state ?? 'MISSING'
+    await new Promise(r => setTimeout(r, 800))
+  }
+}
+
+const hasSummary = (artifacts: Array<{ name: string, parts: Array<{ text?: string }> }>): boolean =>
+  artifacts.some(a => a.name === 'goal-summary' || a.parts.some(p => p.text?.includes('【目标完成总结】')))
+
+// ============ Phase 1:保底合成(确定性,无 LLM/调度器) ============
+async function phase1(): Promise<void> {
+  console.log('\n════════ Phase 1: goal 收口保底合成(无 LLM) ════════')
+  const db = openWorkshopDb(':memory:')
+  const manager = makeManager(db)
+  const eng = engineOf(manager) as unknown as {
+    create(i: { channelId: string, creatorId: string, assigneeId: string, title: string, description?: string }): { id: string }
+    transition(id: string, state: string, by: string): unknown
+    complete(id: string, artifacts?: Array<{ name: string, parts: Array<{ text: string }> }>): unknown
+    get(id: string): { state: string, title: string, artifacts: Array<{ name: string, parts: Array<{ text?: string }> }> } | undefined
+  }
+  try {
+    const ch = await manager.createChannel({ name: 'goal-保底组' })
+    const leadTpl = await manager.createAgent({ name: 'lead-保底', harness: 'mock', config: {} })
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: leadTpl.id, role: 'lead' })
+    // 直建 goal 任务(不经 submitChannelTask,不激活调度器;模式编码与 encodeTaskMode 同构)
+    const goalTask = eng.create({
+      channelId: ch.channelId,
+      creatorId: 'user',
+      assigneeId: leadTpl.id,
+      title: '目标:自我介绍',
+      description: '[mode:goal][criteria:所有成员均已自我介绍并交付介绍文本] 每位成员完成一次自我介绍。',
+    })
+    eng.transition(goalTask.id, 'WORKING', leadTpl.id)
+    eng.complete(goalTask.id)
+    const t1 = eng.get(goalTask.id)
+    check('P1: 无总结收口 → 平台保底合成 goal-summary', t1?.state === 'COMPLETED' && hasSummary(t1?.artifacts ?? []), `state=${t1?.state} artifacts=${t1?.artifacts.length}`)
+    const summaryText = t1?.artifacts.find(a => a.name === 'goal-summary')?.parts[0]?.text ?? ''
+    check('P1: 总结含五段结构(目标/判定标准/完成过程/最终成果/结论)',
+      ['【目标完成总结】', '目标: ', '判定标准: ', '完成过程: ', '最终成果: ', '结论: '].every(k => summaryText.includes(k)))
+    check('P1: 判定标准回填(criteria 来自任务编码)', summaryText.includes('所有成员均已自我介绍并交付介绍文本'))
+
+    // 已有总结时不再重复合成
+    const goal2 = eng.create({
+      channelId: ch.channelId,
+      creatorId: 'user',
+      assigneeId: leadTpl.id,
+      title: '目标:二次验证',
+      description: '[mode:goal][criteria:验证通过] 验证去重。',
+    })
+    eng.transition(goal2.id, 'WORKING', leadTpl.id)
+    eng.complete(goal2.id, [{
+      artifactId: 'lead-written',
+      name: 'goal-summary',
+      parts: [{ text: '【目标完成总结】\n目标: 二次验证\n判定标准: 验证通过\n完成过程: …\n最终成果: lead 自写\n结论: 目标已达成,全部任务完成。' }],
+    }])
+    const t2 = eng.get(goal2.id)
+    const summaries = (t2?.artifacts ?? []).filter(a => a.name === 'goal-summary')
+    check('P1: lead 已自写总结 → 不重复合成', summaries.length === 1, `goal-summary 数=${summaries.length}`)
+    await (manager as unknown as { unloadAll?: () => Promise<void> }).unloadAll?.()
+  }
+  finally {
+    db.close()
+  }
+}
+
+// ============ Phase 2:真实 omp goal 全链路 ============
+async function phase2(): Promise<void> {
+  console.log('\n════════ Phase 2: 真实 omp goal 收口总结(用户场景「你是谁」) ════════')
+  const db = openWorkshopDb(':memory:')
+  const manager = makeManager(db)
+  try {
+    const leadTpl = await manager.createAgent({ name: 'lead-统筹', harness: 'omp', config: {} })
+    const wTpl = await manager.createAgent({ name: 'worker-介绍员', harness: 'omp', config: {} })
+    const ch = await manager.createChannel({ name: 'goal-omp组' })
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: leadTpl.id, role: 'lead' })
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: wTpl.id, role: 'worker' })
+    manager.ensureChannelActive(ch.channelId, { tickMs: 4000, stallMs: 120_000 })
+    const mon = monitorChannel(manager, ch.channelId)
+
+    const goalTask = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '你是谁',
+      description: '团队成员完成自我介绍并交付介绍文本。',
+      mode: 'goal',
+      modeConfig: { goalCriteria: '任务描述中的需求' },
+    })
+    console.log('  goal 任务已提交,等待 lead 判定收口(最长 12 分钟)…')
+    const state = await waitTerminal(manager, ch.channelId, goalTask.id, 720_000)
+    const engine = engineOf(manager)
+    const final = engine.get(goalTask.id)
+    // 诊断:全部任务状态 + 事件时间线(成功失败都打)
+    const allTasks = engine.list(ch.channelId)
+    console.log('  ── 任务状态 ──')
+    for (const t of allTasks) console.log(`  · ${t.id.slice(0, 8)} ${t.state.padEnd(10)} ${t.parentId ? `child-of=${t.parentId.slice(0, 8)} ` : 'parent '}${JSON.stringify(t.title).slice(0, 30)}`)
+    console.log(`  ── 事件时间线(共 ${mon.events.length})──`)
+    for (const e of (mon as unknown as { events: Array<{ at: string, kind: string, state?: string, taskId?: string, agentId?: string, message?: string }> }).events.slice(-40)) {
+      const t = e.at.slice(11, 19)
+      const who = e.agentId ? e.agentId.slice(0, 6) : '-'
+      if (e.kind === 'task.status') console.log(`  [${t}] task ${e.taskId?.slice(0, 6)} → ${e.state} (${who})`)
+      else if (e.kind === 'agent.status') console.log(`  [${t}] agent ${who} → ${e.state}`)
+      else if (e.kind === 'lifecycle') console.log(`  [${t}] lc ${e.message?.slice(0, 60)}`)
+      else if (e.kind === 'agent.event') continue
+      else console.log(`  [${t}] ${e.kind} (${who})`)
+    }
+    check('P2: goal 任务 COMPLETED', state === 'COMPLETED', `state=${state}`)
+    check('P2: 最终 artifacts 含【目标完成总结】', hasSummary(final?.artifacts ?? []), `artifacts=${final?.artifacts.length}`)
+    const summary = final?.artifacts.find(a => a.name === 'goal-summary' || a.parts.some(p => p.text?.includes('【目标完成总结】')))
+    const summaryText = summary?.parts.find(p => p.text?.includes('【目标完成总结】'))?.text
+      ?? summary?.parts.map(p => p.text ?? '').join('\n') ?? ''
+    console.log('  ── 收口总结 ──')
+    console.log(summaryText.split('\n').map(l => `  │ ${l}`).join('\n'))
+    const children = engine.list(ch.channelId).filter(t => t.parentId === goalTask.id)
+    check('P2: 完成过程引用子任务', children.length === 0 || summaryText.includes('完成过程'))
+
+    // goal-summary 事件广播(monitor 时间线可见 → 前端 a2a.artifact 块)
+    const artifactEvents = (mon as unknown as { events: Array<{ kind: string, taskId?: string, agentId?: string }> })
+      .events.filter(e => e.kind === 'task.artifact' || e.kind === 'agent.event')
+    const seenSummaryEvent = JSON.stringify(mon).includes('目标完成总结')
+    check('P2: goal-summary 经事件流广播(时间线可见)', seenSummaryEvent, `events=${mon.events.length}`)
+    mon.stop()
+    await (manager as unknown as { unloadAll?: () => Promise<void> }).unloadAll?.()
+    void artifactEvents
+  }
+  finally {
+    db.close()
+  }
+}
+
+async function main(): Promise<void> {
+  console.log('━━━ goal 收口总结验证(平台保底 + 真实 omp) ━━━')
+  await phase1()
+  if (process.argv.includes('--real')) await phase2()
+  else console.log('\n(未传 --real,跳过 Phase 2 真实 omp;运行: npx tsx scripts/test-goal-summary.ts --real)')
+  console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILURES`}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+void main()

package/scripts/test-harness-liveness.ts

@@ -0,0 +1,109 @@
+/**
+ * 休眠/进程存活探活冒烟测试(node + tsx 直跑,真实子进程)。
+ *
+ * 覆盖(对应「休眠鲁棒性」修复):
+ *  1. isProcessAlive:OS 级 signal-0 探针 —— 存活 true / 死亡 false
+ *  2. OmpRpcClient.reconcile:活客户端不误判;子进程死后 alive 收敛为 false(幂等)
+ *  3. 收敛后 send 失败立即暴露(不死等 60s 命令超时)
+ */
+import { spawn } from 'node:child_process'
+import { isProcessAlive } from '../server/services/workshop/agents/harness-process'
+import { OmpRpcClient } from '../server/services/workshop/agents/adapters/omp-rpc-client'
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
+
+/** 假 harness:启动即输出 ready 帧,然后挂起等待被杀 */
+function spawnFakeHarness(): ReturnType<typeof spawn> {
+  // windowsHide 保证 Windows 下不弹子窗口
+  return spawn(process.execPath, ['-e', `process.stdout.write(JSON.stringify({type:'ready'})+'\\n'); setInterval(()=>{},1000)`], {
+    windowsHide: true,
+    stdio: ['pipe', 'pipe', 'pipe'],
+  })
+}
+
+async function testIsProcessAlive(): Promise<void> {
+  console.log('\n--- 1. isProcessAlive:OS 级存活探针 ---')
+  const child = spawnFakeHarness()
+  await sleep(300)
+  const pid = child.pid!
+  check('存活子进程 → 探针 true', isProcessAlive(pid) === true, `pid=${pid}`)
+  check('非法 pid → false', isProcessAlive(0) === false && isProcessAlive(NaN) === false)
+
+  child.kill('SIGKILL')
+  // 等 OS 回收(window 下短暂存在 zombie 窗口,最多重试 3s)
+  let dead = false
+  for (let i = 0; i < 30 && !dead; i++) {
+    await sleep(100)
+    dead = !isProcessAlive(pid)
+  }
+  check('击杀后探针收敛为 false(≤3s)', dead, `pid=${pid}`)
+}
+
+async function testClientReconcile(): Promise<void> {
+  console.log('\n--- 2. OmpRpcClient.reconcile:死后 alive 收敛 + 幂等 ---')
+  // 注入真实子进程(绕过 start() 的 --mode rpc ready 握手;reconcile 只依赖 child.pid 与 OS 探针)
+  const real = spawnFakeHarness()
+  const client = new OmpRpcClient({}) as unknown as { reconcile(): boolean, alive: boolean, send(c: { type: string, message: string }): Promise<unknown>, [k: string]: unknown }
+  ;(client as unknown as { child: ReturnType<typeof spawn> }).child = real
+  await sleep(300)
+
+  // 活进程:reconcile 不误判
+  check('活客户端 reconcile → true 且 alive 保持', client.reconcile() === true && client.alive === true)
+
+  // 杀进程 → 经 reconcile 探活兜底收敛(自然 exit 事件未被监听,alive 失真 → 探针校准)
+  real.kill('SIGKILL')
+  let converged = false
+  for (let i = 0; i < 30 && !converged; i++) {
+    await sleep(100)
+    converged = !client.reconcile()
+  }
+  check('子进程死后 reconcile 收敛 alive=false(≤3s)', converged)
+
+  // 幂等:再次 reconcile 不抛、状态保持
+  let threw = false
+  try {
+    client.reconcile()
+  }
+  catch {
+    threw = true
+  }
+  check('死后 reconcile 幂等不抛', !threw && client.alive === false)
+
+  // 死客户端上 send 应快速失败(写即错,而非挂 60s 等响应)
+  check('死后 send 立即失败(不死等超时)', await sendFailsFast(client as unknown as OmpRpcClient))
+}
+
+/** 死客户端上 send 应快速失败(写即错,而非挂 60s 等响应) */
+async function sendFailsFast(client: OmpRpcClient): Promise<boolean> {
+  const started = Date.now()
+  try {
+    await client.send({ type: 'prompt', message: 'x' })
+    return false // 不应成功
+  }
+  catch {
+    return Date.now() - started < 10_000
+  }
+}
+
+async function main(): Promise<void> {
+  await testIsProcessAlive()
+  await testClientReconcile()
+
+  console.log('')
+  if (failures === 0) {
+    console.log('ALL PASS')
+    process.exit(0)
+  }
+  else {
+    console.log(`${failures} FAILED`)
+    process.exit(1)
+  }
+}
+
+main()

package/scripts/test-harness-terminal.ts

@@ -0,0 +1,164 @@
+/**
+ * 烟雾测试:harness 终端镜像(omp `--mode rpc-ui`)—— /monitor 终端功能的服务端回路。
+ *
+ * 验证链路:
+ *  1. OmpRpcClient 以 rpc-ui 模式 spawn(ready 握手)
+ *  2. attachTerminalTap 后全部 RPC 帧流入终端会话环形缓冲 + 订阅者广播
+ *  3. prompt → 会话事件(agent_start / message_update / tool_execution_* / agent_end)镜像
+ *  4. sendTerminalInput(空闲 follow_up)→ 新回合被镜像(人类注入)
+ *  5. 真实 HITL:诱导 agent 调 ask 工具 → extension_ui_request 对话框进入 pendingHitl
+ *     → respondTerminalUi(select 应答)→ agent 收到答案继续回合(agent_end)
+ *  6. dispose → 会话标记退出(alive=false,缓冲保留)
+ *
+ * 运行:pnpm tsx scripts/test-harness-terminal.ts(需要 omp CLI + 已配置的模型)
+ */
+import { mkdtempSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { OmpRpcClient } from '../server/services/workshop/agents/adapters/omp-rpc-client'
+import {
+  attachTerminalTap,
+  markTerminalSessionExit,
+  respondTerminalUi,
+  sendTerminalInput,
+  subscribeTerminal,
+  terminalSessionSnapshot,
+} from '../server/services/workshop/agents/harness-terminal'
+import type { TerminalServerMessage } from '../shared/terminal-protocol'
+
+const sleep = (ms: number): Promise<void> => new Promise(r => setTimeout(r, ms))
+
+async function waitUntil(pred: () => boolean, timeoutMs: number, _what: string): Promise<boolean> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (pred()) return true
+    await sleep(200)
+  }
+  return pred()
+}
+
+let failures = 0
+function check(ok: boolean, label: string, detail = ''): void {
+  const mark = ok ? 'PASS' : 'FAIL'
+  if (!ok) failures += 1
+  console.log(`  [${mark}] ${label}${detail ? ` — ${detail}` : ''}`)
+}
+
+function frameTypeCounts(snapshot: ReturnType<typeof terminalSessionSnapshot>): Map<string, number> {
+  const counts = new Map<string, number>()
+  for (const f of snapshot?.replay ?? []) {
+    const t = String(f.frame.type)
+    counts.set(t, (counts.get(t) ?? 0) + 1)
+  }
+  return counts
+}
+
+/** 诊断:打印指定类型帧的关键字段 */
+function dumpFrames(snapshot: ReturnType<typeof terminalSessionSnapshot>, type: string): void {
+  for (const f of snapshot?.replay ?? []) {
+    if (f.frame.type !== type) continue
+    const { id, method, command, success, title, targetId } = f.frame as Record<string, unknown>
+    console.log(`    · seq=${f.seq} ${type} method=${String(method ?? '')} command=${String(command ?? '')} success=${String(success ?? '')} title=${String(title ?? '').slice(0, 50)} targetId=${String(targetId ?? '')} id=${String(id ?? '')}`)
+  }
+}
+
+async function main(): Promise<void> {
+  console.log('== harness-terminal 烟雾测试(rpc-ui)==')
+  const cwd = mkdtempSync(join(tmpdir(), 'aw-terminal-smoke-'))
+
+  // 1. rpc-ui spawn
+  const client = new OmpRpcClient({ command: 'omp', mode: 'rpc-ui', cwd })
+  await client.start()
+  const pid = client.pid ?? -1
+  check(pid > 0, 'omp rpc-ui 子进程启动', `pid=${pid}`)
+
+  // 2. 终端 tap
+  attachTerminalTap(client, {
+    pid,
+    harness: 'omp',
+    agentId: 'smoke-agent',
+    channelId: 'smoke-channel',
+    name: 'smoke-worker',
+    role: 'worker',
+  })
+  const received: TerminalServerMessage[] = []
+  const unsub = subscribeTerminal(pid, m => received.push(m)) ?? (() => {})
+  check(terminalSessionSnapshot(pid) !== null, '终端会话已建立(tap 挂载)')
+
+  // 3. prompt → 会话事件镜像
+  console.log('  … 等待第 1 回合(prompt)')
+  await client.send({ type: 'prompt', message: 'Reply with exactly the single word PONG and nothing else.' })
+  let ok = await waitUntil(() => {
+    const s = terminalSessionSnapshot(pid)
+    return s !== null && s.replay.some(f => f.frame.type === 'agent_end' && f.frame.isTerminal !== false)
+  }, 240_000, 'agent_end')
+  check(ok, '第 1 回合事件镜像至终端(agent_end)')
+
+  const counts1 = frameTypeCounts(terminalSessionSnapshot(pid))
+  check((counts1.get('message_start') ?? 0) > 0, 'message_start 帧已镜像', `count=${counts1.get('message_start') ?? 0}`)
+  check((counts1.get('message_update') ?? 0) > 0, 'message_update(流式 delta)帧已镜像', `count=${counts1.get('message_update') ?? 0}`)
+  check((counts1.get('agent_start') ?? 0) > 0, 'agent_start 帧已镜像')
+
+  // 4. 人类注入(空闲 → follow_up;先等 running 归零再注入,避免排队歧义)
+  console.log('  … 等待回合彻底空闲后注入(follow_up)')
+  await waitUntil(() => terminalSessionSnapshot(pid)?.running === false, 60_000, 'idle')
+  await sendTerminalInput(pid, 'Reply with exactly the single word PONG2 and nothing else.')
+  ok = await waitUntil(() => {
+    const s = terminalSessionSnapshot(pid)
+    const ends = s?.replay.filter(f => f.frame.type === 'agent_end' && f.frame.isTerminal !== false) ?? []
+    return ends.length >= 2
+  }, 240_000, 'second agent_end')
+  check(ok, '人类注入(follow_up)驱动新回合并镜像')
+  const snapshotAfterInput = terminalSessionSnapshot(pid)
+  check(
+    (snapshotAfterInput?.replay.some(f => f.frame.type === '__human_input')) === true,
+    '__human_input 合成帧已入缓冲',
+  )
+  check(
+    received.some(m => m.type === 'term.frames' && m.frames.length > 0),
+    '订阅者收到实时帧广播(term.frames)',
+  )
+
+  // 5. 真实 HITL 回路:诱导 ask → extension_ui_request → 人工应答
+  console.log('  … 等待 HITL 对话框(ask 工具)')
+  await waitUntil(() => terminalSessionSnapshot(pid)?.running === false, 60_000, 'idle')
+  await client.send({
+    type: 'prompt',
+    message: 'Use the ask tool to ask me: "Pick a color" with options Red and Blue. After I answer, reply with exactly the word I chose and nothing else.',
+  })
+  await waitUntil(() => terminalSessionSnapshot(pid)?.hitl != null, 240_000, 'extension_ui_request')
+  const hitl = terminalSessionSnapshot(pid)?.hitl ?? null
+  check(hitl !== null, 'HITL 对话框进入 pending(extension_ui_request 镜像)', hitl ? `method=${hitl.method} options=${JSON.stringify(hitl.options).slice(0, 80)}` : '')
+
+  if (hitl) {
+    respondTerminalUi(pid, { id: hitl.id, value: 'Blue' })
+    console.log('  … 已应答 Blue,等待回合完成')
+    ok = await waitUntil(() => {
+      const s = terminalSessionSnapshot(pid)
+      const ends = s?.replay.filter(f => f.frame.type === 'agent_end' && f.frame.isTerminal !== false) ?? []
+      return terminalSessionSnapshot(pid)?.hitl == null && ends.length >= 3
+    }, 240_000, 'post-answer agent_end')
+    check(ok, 'HITL 应答后回合继续并完成(agent 收到人工答案)')
+    check(terminalSessionSnapshot(pid)?.hitl == null, 'pendingHitl 已清空')
+  }
+
+  // 6. dispose → 退出标记
+  await client.dispose()
+  markTerminalSessionExit(pid, null)
+  const dead = terminalSessionSnapshot(pid)
+  check(dead !== null && dead.alive === false, '会话标记退出(alive=false)')
+  check((dead?.replay.length ?? 0) > 0, '退出后缓冲保留(事后可查看)', `frames=${dead?.replay.length ?? 0}`)
+
+  unsub()
+  const counts = frameTypeCounts(dead)
+  console.log('\n  帧类型分布:', JSON.stringify(Object.fromEntries([...counts.entries()].sort())))
+  dumpFrames(dead, 'extension_ui_request')
+  dumpFrames(dead, 'response')
+  console.log(failures === 0 ? '\n全部通过 ✅' : `\n${failures} 项失败 ❌`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('烟雾测试异常:', err)
+  process.exit(1)
+})

package/scripts/test-header-trail.mjs

@@ -0,0 +1,95 @@
+/**
+ * Header 航迹导航实测(puppeteer-core 驱动 Edge headless):
+ *  - 依次访问 仪表盘 → 运行时监控 → 系统设置 → 仪表盘(重复)
+ *  - 断言:航迹节点按访问顺序累积;重复路径去重后移至末尾;当前页节点高亮
+ *  - 点击旧航点 → 路由返回对应页面;进度线元素存在
+ *  - 截图:亮色/暗色各一张供视觉核验
+ * 运行:node scripts/test-header-trail.mjs
+ */
+import puppeteer from 'puppeteer-core'
+import { mkdirSync } from 'node:fs'
+
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3101'
+const EDGE = process.env.EDGE_PATH ?? 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+let passed = 0, failures = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) passed += 1
+  else failures += 1
+}
+
+async function main() {
+  mkdirSync('data/shots', { recursive: true })
+  const browser = await puppeteer.launch({
+    executablePath: EDGE,
+    headless: 'new',
+    args: ['--no-sandbox', '--disable-gpu', '--window-size=1500,900'],
+    defaultViewport: { width: 1500, height: 900 },
+  })
+  const page = await browser.newPage()
+  page.on('pageerror', e => console.log('  [pageerror]', e.message.slice(0, 160)))
+
+  const goto = async (path) => {
+    await page.goto(`${BASE}${path}`, { waitUntil: 'domcontentloaded' })
+    await sleep(900)
+  }
+  const trailTitles = async () =>
+    page.$$eval('.trail-node', els => els.map(e => e.textContent.replace(/\s+/g, ' ').trim()))
+  const activeTitle = async () =>
+    page.$eval('.trail-node.active', e => e.textContent.replace(/\s+/g, ' ').trim()).catch(() => '(none)')
+
+  // ── 1. 依次访问,航迹累积 ──
+  await goto('/')
+  await goto('/monitor')
+  await goto('/settings')
+  let titles = await trailTitles()
+  check('航迹按访问顺序累积(3 节点)', titles.length === 3, JSON.stringify(titles))
+  check('节点含序号+图标+标题', titles[0]?.includes('01') && titles[0]?.includes('仪表盘'), titles[0] ?? '')
+  check('当前页节点高亮(系统设置)', (await activeTitle()).includes('系统设置'), await activeTitle())
+
+  // ── 2. 重复访问去重移末尾 ──
+  await goto('/')
+  titles = await trailTitles()
+  check('重复路径去重并移至末尾', titles.length === 3 && titles[2]?.includes('仪表盘'), JSON.stringify(titles))
+
+  // ── 3. 点击旧航点返回 ──
+  const nodes = await page.$$('.trail-node')
+  // 点击第 1 个航点(应为 运行时监控)
+  await nodes[0]?.click()
+  await sleep(1200)
+  const url = page.url()
+  check('点击旧航点返回对应页面', url.endsWith('/monitor'), url)
+  check('返回后该节点变为当前高亮', (await activeTitle()).includes('运行时监控'), await activeTitle())
+
+  // ── 4. 进度线元素与 workbench 页兼容 ──
+  check('绘图仪进度线元素存在', (await page.$('.plotter-line')) !== null)
+  await goto('/workshop')
+  await sleep(1200)
+  titles = await trailTitles()
+  check('工作台页入轨(workshop)', titles.some(t => t.includes('Agent 工作台') || t.includes('Agent')), JSON.stringify(titles))
+
+  // ── 5. 视觉核验截图(亮/暗) ──
+  await page.screenshot({ path: 'data/shots/header-trail-light.png' })
+  await page.click('.icon-btn:nth-of-type(1)').catch(() => {})
+  // 用标题定位主题按钮(太阳/月亮)
+  for (const b of await page.$$('.icon-btn')) {
+    const html = await b.evaluate(el => el.innerHTML)
+    if (html.includes('sun-high') || html.includes('moon-stars')) {
+      await b.click()
+      break
+    }
+  }
+  await sleep(600)
+  await page.screenshot({ path: 'data/shots/header-trail-dark.png' })
+
+  await browser.close()
+  console.log(`\n★ 结果: ${passed} passed, ${failures} failed`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('异常:', err.message)
+  process.exit(1)
+})