agentworkshop 0.7.33 → 0.7.37

package/scripts/test-harness-terminal.ts

@@ -1,164 +0,0 @@
-/**
- * 烟雾测试: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

@@ -1,95 +0,0 @@
-/**
- * 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)
-})

package/scripts/test-hitl.ts

@@ -1,360 +0,0 @@
-/**
- * HITL 与成员生命周期 mock 测试:
- *  A. lead 创建团队成员 → 立即装配进 channel 运行时 + DB 同步(无需等首次投递)
- *  B. lead 移除团队成员 → 运行时卸载 + DB 成员行删除 + 一次性模板连带删除
- *  C. 每个 AgentRuntime 独立 stop(HITL 中断):成员保留、可重新装配、lead 停止后自动重激活
- *  D. 任务 HITL:用户可取消(lead/worker 任务均可)+ 重试 FAILED 任务
- *
- * 运行: npx tsx scripts/test-hitl.ts
- */
-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 type { WorkspaceTask } from '../server/services/workshop/types/task'
-import type { SupervisionDecision } from '../server/services/workshop/agents/agent-interface'
-
-let failures = 0
-let testCount = 0
-function check(name: string, ok: boolean, detail = ''): void {
-  testCount += 1
-  console.log(`  ${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`)
-  if (!ok) failures += 1
-}
-
-const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
-
-async function waitUntil(cond: () => boolean | Promise<boolean>, timeoutMs: number): Promise<boolean> {
-  const deadline = Date.now() + timeoutMs
-  while (Date.now() < deadline) {
-    if (await cond()) return true
-    await sleep(40)
-  }
-  return false
-}
-
-interface Harness {
-  manager: AgentChannelManager
-  db: ReturnType<typeof openWorkshopDb>
-}
-
-function setup(): Harness {
-  const db = openWorkshopDb(':memory:')
-  const 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),
-  }
-  const manager = createAgentChannelManager({ repos, implFactory: createAgentImpl, db })
-  return { manager, db }
-}
-
-function getEngine(manager: AgentChannelManager) {
-  return (manager as unknown as {
-    getTaskEngine(): {
-      get(id: string): WorkspaceTask | undefined
-      list(channelId: string): WorkspaceTask[]
-      transition(taskId: string, state: string, by: string): WorkspaceTask
-    }
-  }).getTaskEngine()
-}
-
-function attachScheduler(manager: AgentChannelManager, channelId: string, tickMs = 50): void {
-  manager.ensureChannelActive(channelId, { tickMs, stallMs: 60_000 })
-}
-
-async function cleanup(h: Harness): Promise<void> {
-  await h.manager.shutdown()
-  h.db.close()
-}
-
-// ===== A. lead 建员:立即装配 + DB 同步 =====
-async function testLeadSpawnWiresMember(): Promise<void> {
-  console.log('\n━━━ A. lead 创建成员 → 立即装配 + DB 同步(mock)━━━')
-
-  const h = setup()
-  try {
-    const spawn: SupervisionDecision = {
-      kind: 'spawn_agent',
-      name: 'w2',
-      harness: 'mock',
-      config: { delayMs: 20 },
-      reason: 'lead 扩容测试',
-    }
-    const ch = await h.manager.createChannel({
-      name: '建员装配测试',
-      leadAgent: { name: 'lead', harness: 'mock', config: { delayMs: 20, teamOps: [spawn] } },
-    })
-    await h.manager.addAgentToChannel({
-      channelId: ch.channelId,
-      agentId: (await h.manager.createAgent({ name: 'w1', harness: 'mock', config: { delayMs: 20 } })).id,
-      role: 'worker',
-    })
-    attachScheduler(h.manager, ch.channelId)
-
-    // 首个 supervise tick 触发 spawn_agent → 新成员落库
-    const spawned = await waitUntil(async () => {
-      const members = await h.manager.listChannelAgents(ch.channelId)
-      return members.some(m => m.name === 'w2')
-    }, 5000)
-    check('lead spawn_agent 后成员落库(channel_agents 行)', spawned)
-
-    const w2 = (await h.manager.listChannelAgents(ch.channelId)).find(m => m.name === 'w2')
-    check('DB 成员行包含 w2', !!w2, w2 ? `id=${w2.id.slice(0, 8)}` : '')
-    const w2Detail = w2 ? h.manager.getChannelAgent(w2.id) : undefined
-    check('新成员已装配(立即 wire,无需首次投递)', w2Detail?.wired === true, `wired=${w2Detail?.wired}`)
-
-    // 装配后即可被调度:提交 2 个任务,w2 应实际执行到至少一个
-    const engine = getEngine(h.manager)
-    const t1 = await h.manager.submitChannelTask({ channelId: ch.channelId, title: '任务A' })
-    const t2 = await h.manager.submitChannelTask({ channelId: ch.channelId, title: '任务B' })
-    const allDone = await waitUntil(() =>
-      engine.get(t1.id)?.state === 'COMPLETED' && engine.get(t2.id)?.state === 'COMPLETED', 15_000)
-    check('装配成员可正常承接任务(全部完成)', allDone)
-    const children = engine.list(ch.channelId).filter(t => t.parentId && (t.parentId === t1.id || t.parentId === t2.id))
-    const byW2 = children.filter(t => t.assigneeId === w2?.id)
-    check('w2 实际执行了任务', byW2.length >= 1, `w2 执行 ${byW2.length}/${children.length}`)
-  }
-  finally {
-    await cleanup(h)
-  }
-}
-
-// ===== B. lead 删员:运行时卸载 + DB 删除(成员行 + 一次性模板) =====
-async function testLeadRemoveUnloadsAndDeletes(): Promise<void> {
-  console.log('\n━━━ B. lead 移除成员 → 卸载运行时 + 删除数据库信息(mock)━━━')
-
-  const h = setup()
-  try {
-    const spawn: SupervisionDecision = {
-      kind: 'spawn_agent',
-      name: 'w2',
-      harness: 'mock',
-      config: { delayMs: 20 },
-      reason: '扩容',
-    }
-    const ch = await h.manager.createChannel({
-      name: '删员卸载测试',
-      leadAgent: { name: 'lead', harness: 'mock', config: { delayMs: 20, teamOps: [spawn] } },
-    })
-    const w1 = await h.manager.addAgentToChannel({
-      channelId: ch.channelId,
-      agentId: (await h.manager.createAgent({ name: 'w1', harness: 'mock', config: { delayMs: 20 } })).id,
-      role: 'worker',
-    })
-    attachScheduler(h.manager, ch.channelId)
-
-    await waitUntil(async () => (await h.manager.listChannelAgents(ch.channelId)).some(m => m.name === 'w2'), 5000)
-    const w2 = (await h.manager.listChannelAgents(ch.channelId)).find(m => m.name === 'w2')!
-    // templateId 不经 AgentInfo 暴露,测试直接查库
-    const row = h.db.prepare('SELECT template_id AS templateId FROM channel_agents WHERE id = ?').get(w2.id) as { templateId: string } | undefined
-    const templateId = row?.templateId ?? ''
-    check('w2 模板存在(删除前)', !!templateId && !!h.manager.getAgent(templateId), templateId ? '' : '模板 id 缺失')
-
-    // 等 w2 完成装配
-    await waitUntil(() => h.manager.getChannelAgent(w2.id)?.wired === true, 5000)
-
-    // 模拟 lead remove_agent 决策路径(与 SchedulerLoop.execute remove 同源)
-    const lead = (await h.manager.listChannelAgents(ch.channelId)).find(m => m.role === 'lead')!
-    const result = await h.manager.removeTeamMember(ch.channelId, lead.id, w2.id, 'HITL 测试裁撤')
-    check('移除返回回收任务列表(无在途)', Array.isArray(result.recycledTasks))
-
-    const members = await h.manager.listChannelAgents(ch.channelId)
-    check('成员行已删除(DB)', !members.some(m => m.id === w2.id), `剩余 ${members.length} 人`)
-    check('运行时已卸载(wired=false/无 runtime)', h.manager.getChannelAgent(w2.id) === undefined)
-    check('一次性模板已连带删除(DB)', h.manager.getAgent(templateId) === undefined)
-
-    // 剩余成员仍可正常执行(等一轮调度快照稳定,避开删员与决策竞态窗口)
-    await sleep(250)
-    const engine = getEngine(h.manager)
-    const t = await h.manager.submitChannelTask({ channelId: ch.channelId, title: '删员后任务' })
-    const done = await waitUntil(() => engine.get(t.id)?.state === 'COMPLETED', 15_000)
-    // 根任务 assignee 恒为 lead;校验实际执行的是剩余 worker w1
-    const child = engine.list(ch.channelId).find(c => c.parentId === t.id)
-    check('删员后 channel 仍可正常执行', done && child?.assigneeId === w1.id,
-      `state=${engine.get(t.id)?.state} child=${child?.assigneeId.slice(0, 8)}`)
-  }
-  finally {
-    await cleanup(h)
-  }
-}
-
-// ===== C. 每个 AgentRuntime 独立 stop(HITL 中断) =====
-async function testStopAgentRuntime(): Promise<void> {
-  console.log('\n━━━ C. AgentRuntime 独立 stop(HITL 中断,mock)━━━')
-
-  const h = setup()
-  try {
-    const ch = await h.manager.createChannel({
-      name: '停止运行时测试',
-      leadAgent: { name: 'lead', harness: 'mock', config: { delayMs: 20 } },
-    })
-    const w1 = await h.manager.addAgentToChannel({
-      channelId: ch.channelId,
-      agentId: (await h.manager.createAgent({ name: 'w1', harness: 'mock', config: { delayMs: 30 } })).id,
-      role: 'worker',
-    })
-    attachScheduler(h.manager, ch.channelId)
-    const engine = getEngine(h.manager)
-
-    // worker 忙时 HITL stop
-    await h.manager.submitChannelTask({ channelId: ch.channelId, title: '停止测试任务1' })
-    await waitUntil(() => h.manager.getChannelAgent(w1.id)?.runtimeState === 'busy', 8000)
-    const stopped = await h.manager.stopAgentRuntime(ch.channelId, w1.id, 'test')
-    check('stopAgentRuntime 返回成功', stopped.stopped === true)
-    check('worker 运行时已卸载(detached)', h.manager.getChannelAgent(w1.id)?.wired === false
-    || h.manager.getChannelAgent(w1.id) === undefined)
-    const members = await h.manager.listChannelAgents(ch.channelId)
-    check('worker 成员行保留(interrupt 语义)', members.some(m => m.id === w1.id))
-
-    // 中断后可重新装配执行新任务
-    const t2 = await h.manager.submitChannelTask({ channelId: ch.channelId, title: '停止后重装任务' })
-    const done2 = await waitUntil(() => engine.get(t2.id)?.state === 'COMPLETED', 15_000)
-    check('stop 后新任务自动重新装配并完成', done2, `state=${engine.get(t2.id)?.state}`)
-
-    // lead 停止:调度器随停;下次提交自动重激活
-    const lead = (await h.manager.listChannelAgents(ch.channelId)).find(m => m.role === 'lead')!
-    await h.manager.stopAgentRuntime(ch.channelId, lead.id, 'test')
-    const cr = (h.manager as unknown as { channels: Map<string, { scheduler: unknown }> }).channels.get(ch.channelId)
-    check('lead 停止后调度器已停', cr?.scheduler === null || cr?.scheduler === undefined)
-
-    const t3 = await h.manager.submitChannelTask({ channelId: ch.channelId, title: 'lead 重启后任务' })
-    const done3 = await waitUntil(() => engine.get(t3.id)?.state === 'COMPLETED', 20_000)
-    check('lead 停止后提交任务自动重激活并完成', done3, `state=${engine.get(t3.id)?.state}`)
-  }
-  finally {
-    await cleanup(h)
-  }
-}
-
-// ===== D. 任务 HITL:取消 + 重试(lead 根任务 / worker 子任务均可) =====
-async function testTaskHITL(): Promise<void> {
-  console.log('\n━━━ D. 任务 HITL:用户取消 / 重试(mock)━━━')
-
-  const h = setup()
-  try {
-    const ch = await h.manager.createChannel({
-      name: '任务HITL测试',
-      leadAgent: { name: 'lead', harness: 'mock', config: { delayMs: 20 } },
-    })
-    // 慢 worker:拉开 HITL 操作时间窗,防任务在操作前自然完成(300ms×3 进度 ≈ 1s 一轮)
-    const w1 = await h.manager.addAgentToChannel({
-      channelId: ch.channelId,
-      agentId: (await h.manager.createAgent({ name: 'w1', harness: 'mock', config: { delayMs: 300 } })).id,
-      role: 'worker',
-    })
-    attachScheduler(h.manager, ch.channelId)
-    const engine = getEngine(h.manager)
-    const lead = (await h.manager.listChannelAgents(ch.channelId)).find(m => m.role === 'lead')!
-
-    // 1. lead 根任务取消(HITL):提交后立即取消(SUBMITTED/WORKING/WAITING 均合法,1s 内不会完成)
-    const t1 = await h.manager.submitChannelTask({ channelId: ch.channelId, title: '根任务可取消' })
-    await sleep(150) // 等 lead 接取/派发(快照稳定)
-    const canceledRoot = await h.manager.cancelTask(ch.channelId, lead.id, { taskId: t1.id })
-    check('lead 根任务可被用户取消', canceledRoot.state === 'CANCELED', `state=${canceledRoot.state}`)
-
-    // 2. worker 子任务取消(HITL):子任务执行中取消
-    const t2 = await h.manager.submitChannelTask({ channelId: ch.channelId, title: '子任务可取消' })
-    const child2 = await waitChildOf(h, engine, ch.channelId, t2.id)
-    check('子任务已派发并执行(测试前置)', !!child2 && child2?.state === 'WORKING', `state=${child2?.state}`)
-    const canceledChild = await h.manager.cancelTask(ch.channelId, lead.id, { taskId: child2!.id })
-    check('worker 子任务可被用户取消', canceledChild.state === 'CANCELED', `state=${canceledChild.state}`)
-
-    // 3. FAILED 任务重试(HITL):子任务置 FAILED 后经 retryTask 恢复执行
-    const t3 = await h.manager.submitChannelTask({ channelId: ch.channelId, title: '可重试任务' })
-    const child3 = await waitChildOf(h, engine, ch.channelId, t3.id)
-    check('重试目标已派发(测试前置)', !!child3)
-    engine.transition(child3!.id, 'FAILED', lead.id)
-    check('任务已置 FAILED(测试前置)', engine.get(child3!.id)?.state === 'FAILED')
-    const retried = await h.manager.retryTask(ch.channelId, lead.id, child3!.id)
-    check('retryTask 重新指派(FAILED→ASSIGNED)', retried.state === 'ASSIGNED', `state=${retried.state} assignee=${retried.assigneeId === w1.id ? 'w1' : retried.assigneeId.slice(0, 8)}`)
-    const done = await waitUntil(() => engine.get(child3!.id)?.state === 'COMPLETED', 15_000)
-    check('重试后任务正常完成', done, `state=${engine.get(child3!.id)?.state}`)
-
-    // 4. 非 FAILED 重试拒绝
-    let rejected = false
-    try {
-      await h.manager.retryTask(ch.channelId, lead.id, child3!.id)
-    }
-    catch {
-      rejected = true
-    }
-    check('非 FAILED 任务重试被拒绝(400)', rejected)
-
-    // 5. 无可用 worker 时重试拒绝(移除全部 worker 后)
-    const t4 = await h.manager.submitChannelTask({ channelId: ch.channelId, title: '无人重试任务' })
-    const child4 = await waitChildOf(h, engine, ch.channelId, t4.id)
-    if (child4) engine.transition(child4.id, 'FAILED', lead.id)
-    else engine.transition(t4.id, 'FAILED', lead.id)
-    const allWorkers = (await h.manager.listChannelAgents(ch.channelId)).filter(m => m.role === 'worker')
-    for (const w of allWorkers) {
-      await h.manager.removeTeamMember(ch.channelId, lead.id, w.id, '移除全部 worker')
-    }
-    const failedId = child4?.id ?? t4.id
-    let noWorker = false
-    try {
-      await h.manager.retryTask(ch.channelId, lead.id, failedId)
-    }
-    catch {
-      noWorker = true
-    }
-    check('无可用 worker 时重试返回 NO_WORKER', noWorker)
-  }
-  finally {
-    await cleanup(h)
-  }
-}
-
-/** 等待根任务派发出子任务(返回子任务;超时返回 undefined) */
-async function waitChildOf(
-  h: Harness,
-  engine: ReturnType<typeof getEngine>,
-  channelId: string,
-  rootId: string,
-  timeoutMs = 8000,
-): Promise<WorkspaceTask | undefined> {
-  let child: WorkspaceTask | undefined
-  await waitUntil(() => {
-    child = engine.list(channelId).find(t => t.parentId === rootId && t.state !== 'COMPLETED' && t.state !== 'CANCELED')
-    return !!child
-  }, timeoutMs)
-  return child
-}
-
-async function main(): Promise<void> {
-  console.log('╔══════════════════════════════════════════════════════════════╗')
-  console.log('║  HITL 与成员生命周期验证(mock):建员装配/删员卸载/独立stop/任务控制  ║')
-  console.log('╚══════════════════════════════════════════════════════════════╝')
-
-  await testLeadSpawnWiresMember()
-  await testLeadRemoveUnloadsAndDeletes()
-  await testStopAgentRuntime()
-  await testTaskHITL()
-
-  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
-  console.log(`  ${failures === 0 ? `🎉 全部通过(${testCount} 项检查)` : `❌ ${failures}/${testCount} 项失败`}`)
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
-  process.exit(failures === 0 ? 0 : 1)
-}
-
-main().catch((e) => {
-  console.error('测试异常:', e)
-  process.exit(1)
-})