agentworkshop 0.2.1

package/scripts/test-mock-collab.mjs

@@ -0,0 +1,226 @@
+// -*- coding: utf-8 -*-
+// 多 Agent 实时通信 + FIFO 执行 E2E(mock harness;node scripts/test-mock-collab.mjs)
+//
+// 隔离环境:新建专属 channel(mock lead + 2 名 mock worker),跑完即删。
+// 覆盖:
+//  T1 任务 FIFO 逐条执行 —— HITL 直发 3 个任务给同一 worker:
+//     完成顺序 === 提交顺序;执行严格串行(同一 worker 任意时刻至多 1 个 WORKING);
+//     每任务走完 WORKING→COMPLETED(progress 25/50/75→artifact)。
+//  T2 消息逐条处理 + 逐条回执 —— agent→agent 连发 8 条 requireReply 消息
+//     (含同毫秒突发):每条恰好一条回执(in_reply_to 一一对应),
+//     回执顺序 === 发送顺序(FIFO;rowid 决胜回归)。
+//  T3 实时消息按需获取即时性 —— idle worker 收 immediate 消息:
+//     发送→回执到达时延 < 5s(mailbox 到信唤醒 + 消费循环即时接单)。
+//  T4 lead 调度闭环 —— 常规任务(无 @,默认路由 lead):lead 派发子任务 →
+//     worker 完成 → lead 汇总 → 父任务 COMPLETED(多 Agent 协同全链路)。
+import { env } from 'node:process'
+
+const BASE = env.AW_BASE ?? 'http://127.0.0.1:3002'
+const TOKEN = env.AW_TOKEN ?? 'ut-636e563104b844b591de8aadf6071aea'
+
+let failures = 0
+const check = (name, ok, detail = '') => {
+  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+async function api(method, path, body) {
+  const res = await fetch(BASE + path, {
+    method,
+    headers: { 'authorization': `Bearer ${TOKEN}`, 'content-type': 'application/json' },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const d = await res.json().catch(() => ({}))
+  if (d && typeof d === 'object' && 'code' in d && d.code !== 0 && d.code !== 'ok') {
+    throw new Error(`${method} ${path} -> ${JSON.stringify(d).slice(0, 220)}`)
+  }
+  return d?.data ?? d
+}
+
+/** 轮询直到谓词命中(返回谓词结果)或超时 */
+async function pollUntil(fn, timeoutMs, label) {
+  const t0 = Date.now()
+  for (;;) {
+    const v = await fn().catch(() => null)
+    if (v) return { ok: true, value: v, elapsed: Date.now() - t0 }
+    if (Date.now() - t0 > timeoutMs) return { ok: false, value: null, elapsed: Date.now() - t0, label }
+    await sleep(300)
+  }
+}
+
+/** channel 事件流(按 seq 升序;用于重建时序) */
+async function events(cid, limit = 500) {
+  const d = await api('GET', `/api/workshop/channels/${cid}/events?limit=${limit}`)
+  return d.items ?? []
+}
+
+/** channel 全量消息行(含回执;按 createdAt 升序) */
+async function messages(cid, limit = 400) {
+  const rows = await api('GET', `/api/workshop/channels/${cid}/messages?limit=${limit}`)
+  return Array.isArray(rows) ? rows.slice().sort((a, b) => a.createdAt < b.createdAt ? -1 : a.createdAt > b.createdAt ? 1 : 0) : []
+}
+
+async function main() {
+  // ---- 环境装配:专属 channel + mock lead + 2 mock worker ----
+  const stamp = Date.now().toString(36)
+  const created = await api('POST', '/api/workshop/channels', {
+    name: `fifo-e2e-${stamp}`,
+    description: 'FIFO/实时通信 E2E(自动创建,跑完即删)',
+    leadAgent: { name: 'e2e-lead', harness: 'mock', config: { delayMs: 100 } },
+  })
+  const cid = created.channelId
+  const leadId = created.leadAgentId
+  console.log(`channel=${cid.slice(0, 8)} lead=${leadId.slice(0, 8)}`)
+  try {
+    const w1 = (await api('POST', `/api/workshop/channels/${cid}/agents`, { name: 'e2e-worker-1', harness: 'mock', config: { delayMs: 350 } })).id
+    const w2 = (await api('POST', `/api/workshop/channels/${cid}/agents`, { name: 'e2e-worker-2', harness: 'mock', config: { delayMs: 120 } })).id
+    console.log(`workers: w1=${w1.slice(0, 8)} w2=${w2.slice(0, 8)}`)
+
+    // ================= T1:任务 FIFO 逐条执行 =================
+    console.log('\n--- T1:任务 FIFO 逐条执行(HITL 直发 ×3 → 同一 worker) ---')
+    const markers = ['FIFO-A', 'FIFO-B', 'FIFO-C']
+    const t1 = []
+    for (const m of markers) {
+      // 顺序提交(每个 POST 落库后再发下一个):入队顺序确定 → 完成顺序必须一致
+      const t = await api('POST', `/api/workshop/channels/${cid}/tasks`, {
+        title: `${m} 顺序验证`,
+        description: `${m}:按提交顺序逐条执行`,
+        assigneeId: w1,
+        parts: [{ text: `${m} body` }],
+      })
+      t1.push({ id: t.id, m })
+    }
+    const idByMarker = new Map(t1.map(x => [x.id, x.m]))
+    const allDone = await pollUntil(async () => {
+      const tasks = await api('GET', `/api/workshop/channels/${cid}/tasks`)
+      return t1.every(x => tasks.find(t => t.id === x.id)?.state === 'COMPLETED') || null
+    }, 30_000, 'T1 全部完成')
+    check('T1 三个任务全部 COMPLETED', allDone.ok, `${allDone.elapsed}ms`)
+
+    // 时序重建:task.status 事件按 seq → 完成顺序 + 串行性
+    {
+      const evs = (await events(cid)).filter(e => e.type === 'task.status')
+        .map(e => ({ seq: e.seq, taskId: e.payload?.taskId, state: e.payload?.state }))
+        .filter(x => idByMarker.has(x.taskId))
+      const completionOrder = evs.filter(x => x.state === 'COMPLETED').map(x => idByMarker.get(x.taskId))
+      check('T1 完成顺序 === 提交顺序(A→B→C)', completionOrder.join(',') === markers.join(','), completionOrder.join(','))
+      // 串行:WORKING 区间不重叠 —— WORKING(x) 出现时,前一任务必须已 COMPLETED
+      let prevOpen = null
+      let serial = true
+      for (const x of evs) {
+        if (x.state === 'WORKING') {
+          if (prevOpen) {
+            serial = false
+            break
+          }
+          prevOpen = x.taskId
+        }
+        if (x.state === 'COMPLETED' && prevOpen === x.taskId) prevOpen = null
+      }
+      check('T1 同一 worker 任意时刻至多 1 个任务在执行(严格串行)', serial)
+      // 每任务走过 WORKING
+      for (const x of t1) {
+        check(`T1 ${idByMarker.get(x.id)} 经 WORKING 转移`, evs.some(e => e.taskId === x.id && e.state === 'WORKING'))
+      }
+    }
+
+    // ================= T2:消息逐条处理 + 逐条回执(FIFO) =================
+    console.log('\n--- T2:消息逐条处理 + 逐条回执(连发 8 条 requireReply) ---')
+    const N = 8
+    const sent = []
+    for (let i = 1; i <= N; i++) {
+      // 同步连发(近同毫秒突发;验证 rowid 决胜 FIFO)
+      sent.push(api('POST', `/api/workshop/channels/${cid}/messages`, {
+        toAgentId: w2, fromAgentId: leadId,
+        text: `逐条消息 ${i}/${N}`,
+        priority: 'immediate', requireReply: true,
+      }).then(r => ({ id: r.messageId, i })))
+    }
+    const sentMsgs = await Promise.all(sent)
+    const replySet = new Set(sentMsgs.map(x => x.id))
+    const gotReplies = await pollUntil(async () => {
+      const rows = await messages(cid)
+      const replies = rows.filter(r => r.fromAgentId === w2
+        && r.metadata?.['x-aw-in-reply-to'] && replySet.has(r.metadata['x-aw-in-reply-to']))
+      return replies.length >= N ? replies : null
+    }, 20_000, 'T2 全部回执')
+    check('T2 每条消息恰好收到一条回执(N/N)', gotReplies.ok, `${gotReplies.value?.length ?? 0}/${N}`)
+    {
+      const replies = gotReplies.value ?? []
+      // 并发 POST 的服务器入队顺序 ≠ 客户端编号顺序;FIFO 契约 = 按入队顺序执行。
+      // 以入队时间戳(消息行 createdAt)为基准:回执顺序映射回原消息后单调不减
+      // (同毫秒并列组内任意序均可),跨毫秒组必须升序。
+      const createdAtByMsg = new Map(
+        (await messages(cid))
+          .filter(r => replySet.has(r.id))
+          .map(r => [r.id, r.createdAt]),
+      )
+      const stamps = replies.map(r => createdAtByMsg.get(r.metadata['x-aw-in-reply-to']))
+      const nonDecreasing = stamps.every((v, idx) => idx === 0 || v >= stamps[idx - 1])
+      check('T2 回执顺序与入队时间戳单调一致(FIFO 按入队序;同毫秒并列可任意序)', nonDecreasing, stamps.join(','))
+      // 逐条语义:无重复回执、无遗漏
+      const uniqTargets = new Set(replies.map(r => r.metadata['x-aw-in-reply-to']))
+      check('T2 回执一一对应(无重复/无遗漏)', uniqTargets.size === N && replies.length === N)
+    }
+
+    // ================= T3:实时消息即时性(按需获取) =================
+    console.log('\n--- T3:实时消息按需获取即时性(idle worker,immediate) ---')
+    {
+      const t0 = Date.now()
+      const r = await api('POST', `/api/workshop/channels/${cid}/messages`, {
+        toAgentId: w2, fromAgentId: leadId,
+        text: '实时性探针:请立即回执',
+        priority: 'immediate', requireReply: true,
+      })
+      const probe = await pollUntil(async () => {
+        const rows = await messages(cid)
+        return rows.find(x => x.fromAgentId === w2 && x.metadata?.['x-aw-in-reply-to'] === r.messageId) ?? null
+      }, 10_000, 'T3 回执')
+      const ms = Date.now() - t0
+      check('T3 发送→回执到达(< 5s;mailbox 到信即时唤醒 + 消费循环即时接单)', probe.ok && ms < 5000, `${ms}ms`)
+    }
+
+    // ================= T4:lead 调度闭环(多 Agent 协同) =================
+    console.log('\n--- T4:lead 调度闭环(默认路由 → lead 派发 → worker 完成 → 父任务收口) ---')
+    {
+      const parent = await api('POST', `/api/workshop/channels/${cid}/tasks`, {
+        title: `协同闭环-${stamp}`,
+        description: 'lead 应派发子任务给空闲 worker 并在子任务完成后汇总收口',
+        parts: [{ text: '协同闭环 body' }],
+      })
+      const done = await pollUntil(async () => {
+        const tasks = await api('GET', `/api/workshop/channels/${cid}/tasks`)
+        const st = tasks.find(t => t.id === parent.id)?.state
+        return st === 'COMPLETED' || null
+      }, 40_000, 'T4 父任务 COMPLETED')
+      check('T4 父任务经 lead 调度收口为 COMPLETED', done.ok, `${done.elapsed}ms`)
+      // 派发链路:存在子任务(指派给 worker)且完成
+      const tasks = await api('GET', `/api/workshop/channels/${cid}/tasks`)
+      const children = tasks.filter(t => t.parentId === parent.id)
+      check('T4 lead 派发了子任务且子任务完成', children.length > 0 && children.every(c => c.state === 'COMPLETED'),
+        `children=${children.length}`)
+      // lead 汇总交付物
+      const parentTask = tasks.find(t => t.id === parent.id)
+      check('T4 父任务带汇总交付物(summary)', (parentTask?.artifacts?.length ?? 0) > 0)
+    }
+  }
+  finally {
+    // ---- 清理:删除测试 channel(级联清理 agents/tasks/messages) ----
+    try {
+      await api('DELETE', `/api/workshop/channels/${cid}`)
+      console.log(`\n(测试 channel ${cid.slice(0, 8)} 已删除)`)
+    }
+    catch (err) {
+      console.log(`\n(清理失败,请手动删除 channel ${cid}:${err.message})`)
+    }
+  }
+
+  console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILURE(S)`}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('E2E 异常:', err.message)
+  process.exit(1)
+})

package/scripts/test-modern-render.mjs

@@ -0,0 +1,174 @@
+/**
+ * 现代渲染特性浏览器实测:
+ *  - 注入含围栏代码块的实时消息 → 时间线渲染 .code-block(语言标签+复制按钮)
+ *  - 点击复制 → 剪贴板内容正确 + 按钮反馈
+ *  - stream 气泡 hover 复制按钮存在
+ *  - 滚离底部 → 跳转最新按钮出现并可回底
+ * 运行:node scripts/test-modern-render.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
+}
+
+const api = async (method, path, { body, token } = {}) => {
+  const headers = { 'content-type': 'application/json' }
+  if (token) headers.authorization = `Bearer ${token}`
+  const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+
+async function main() {
+  mkdirSync('data/shots', { recursive: true })
+  const email = `render-${Date.now().toString(36)}@test.local`
+  const reg = await api('POST', '/api/users/register', { body: { name: `render-${Date.now().toString(36)}`, email, password: 'Passw0rd!123' } })
+  const token = reg.data?.token
+
+  // mock lead(自动派发)+ 真实 omp worker:流式产出含围栏代码块的回复
+  const ch = await api('POST', '/api/workshop/channels', {
+    body: { name: 'render-check', leadAgent: { name: 'lead', harness: 'mock' } },
+    token,
+  })
+  const channelId = ch.data.channelId
+  await api('POST', `/api/workshop/channels/${channelId}/agents`, {
+    body: {
+      name: 'demo-worker',
+      harness: 'omp',
+      role: 'worker',
+      config: { provider: 'zhipu-coding-plan', model: 'glm-5-turbo' },
+    },
+    token,
+  })
+  const ws = await api('POST', '/api/workshop/workspaces', { body: { name: 'render-ws' }, token })
+  await api('POST', `/api/workshop/workspaces/${ws.data.id}/channels/${channelId}`, { token })
+  const task = await api('POST', `/api/workshop/channels/${channelId}/tasks`, {
+    body: {
+      title: 'modern-render-check',
+      description: '直接回复(无需任何工具):先用一句话说明 chunk 函数,然后给出 typescript 代码块(用 ```ts 围栏,导出 function chunk<T>(arr: T[], size: number): T[][],实现数组分块),再给一个 ```bash 围栏写 node --test。回复必须包含这两个围栏代码块。',
+    },
+    token,
+  })
+  if (task.code !== 0) throw new Error('任务提交失败: ' + JSON.stringify(task).slice(0, 120))
+
+  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()
+  await page.goto(`${BASE}/workshop`, { waitUntil: 'domcontentloaded' })
+  await sleep(1800)
+  let inConsole = false
+  for (let attempt = 0; attempt < 2 && !inConsole; attempt++) {
+    for (const b of await page.$$('button')) {
+      const txt = (await b.evaluate(el => el.textContent) || '').trim()
+      if (txt.includes('进入控制台')) {
+        await b.click()
+        await sleep(2500)
+        inConsole = page.url().includes('/workshop/w/')
+        break
+      }
+    }
+    if (inConsole) break
+    const emailInput = await page.$('input[type="email"]')
+    if (!emailInput) break
+    await emailInput.type(email, { delay: 8 })
+    const pwd = await page.$('input[type="password"]')
+    await pwd.type('Passw0rd!123', { delay: 8 })
+    for (const b of await page.$$('button')) {
+      const txt = (await b.evaluate(el => el.textContent) || '').trim()
+      if (txt.replace(/\s/g, '') === '登录') {
+        await b.click()
+        break
+      }
+    }
+    await sleep(2200)
+  }
+  check('进入控制台', inConsole)
+  await sleep(2000)
+
+  // 轮询等待流式代码块出现(omp 真实流式;未闭合围栏中途也应安全渲染)
+  const deadline = Date.now() + 240_000
+  let n = await page.evaluate(() => document.querySelectorAll('.code-block').length)
+  while (Date.now() < deadline && n < 2) {
+    await sleep(3000)
+    n = await page.evaluate(() => document.querySelectorAll('.code-block').length)
+  }
+
+  // 代码块渲染断言
+  const codeState = await page.evaluate(() => {
+    const blocks = [...document.querySelectorAll('.code-block')]
+    const first = blocks[0]
+    return {
+      n: blocks.length,
+      lang: first?.querySelector('.code-lang')?.textContent ?? '',
+      copyBtn: Boolean(first?.querySelector('.code-copy')),
+      body: first?.querySelector('pre code')?.textContent ?? '',
+    }
+  })
+  check('围栏代码块渲染(≥2 块)', codeState.n >= 2, `n=${codeState.n}`)
+  check('语言标签', codeState.lang === 'ts', codeState.lang)
+  check('复制按钮存在', codeState.copyBtn)
+  check('代码正文保真', codeState.body.includes('export function chunk'), codeState.body.slice(0, 40))
+
+  // 复制交互:点击 → 剪贴板 → 按钮反馈
+  const clip = await page.evaluate(async () => {
+    const btn = document.querySelector('.code-copy')
+    if (!btn) return null
+    btn.click()
+    await new Promise(r => setTimeout(r, 300))
+    let text
+    try {
+      text = await navigator.clipboard.readText()
+    }
+    catch { text = '(clipboard-read denied)' }
+    return { btnText: btn.textContent, text: text.slice(0, 60) }
+  })
+  check('点击复制 → 按钮反馈"已复制"', clip?.btnText === '已复制', clip?.btnText ?? '')
+  check('剪贴板内容为代码正文', clip?.text.includes('export function chunk') || clip?.text === '(clipboard-read denied)', clip?.text?.slice(0, 40))
+
+  // stream 气泡 hover 复制按钮
+  const bubbleCopy = await page.evaluate(() => Boolean(document.querySelector('.stream-bubble .copy-btn')))
+  check('消息气泡 hover 复制按钮', bubbleCopy)
+
+  // 跳转最新:滚离底部 → 按钮出现 → 点击回底
+  const jump = await page.evaluate(async () => {
+    const scroller = document.querySelector('.scroller')
+    if (!scroller) return { has: false }
+    scroller.scrollTop = 0
+    scroller.dispatchEvent(new Event('scroll'))
+    await new Promise(r => setTimeout(r, 250))
+    const btn = document.querySelector('.jump-latest')
+    const visible = btn && btn.offsetParent !== null
+    if (visible) btn.click()
+    await new Promise(r => setTimeout(r, 300))
+    return {
+      has: visible === true,
+      backToBottom: scroller.scrollHeight - scroller.scrollTop - scroller.clientHeight < 8,
+    }
+  })
+  check('滚离底部出现"最新"按钮', jump.has)
+  check('点击跳转回底', jump.backToBottom)
+
+  await page.screenshot({ path: 'data/shots/modern-render.png' }).catch(() => {})
+  await browser.close()
+
+  await api('DELETE', `/api/workshop/channels/${channelId}`, { token }).catch(() => {})
+  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-omp-terminal.mjs

@@ -0,0 +1,187 @@
+// -*- coding: utf-8 -*-
+// 真实 omp 终端 E2E(node scripts/test-omp-terminal.mjs)
+//
+// 验证 Web 终端原生控制的完整闭环(真 LLM / 真子进程 / 真 WS 双向通道):
+//  T1 任务直发 omp worker → 子进程 lazy spawn → GET terminals 出现会话
+//  T2 终端 WS 连接(agentId 寻址)→ term.init + 实时帧(tool 执行/流式输出)
+//  T3 Web 输入控制:input 帧(follow_up/steer)注入真实会话 → 会话响应新回合
+//  T4 abort 控制:中止运行中回合
+//  T5 任务终态(完成或失败均如实报告;LLM 后端不可用时降级为链路验证)
+import { env } from 'node:process'
+
+const BASE = env.AW_BASE ?? 'http://127.0.0.1:3002'
+const TOKEN = env.AW_TOKEN ?? 'ut-636e563104b844b591de8aadf6071aea'
+const WS_BASE = BASE.replace(/^http/, 'ws')
+
+let failures = 0
+const check = (name, ok, detail = '') => {
+  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+async function api(method, path, body) {
+  const res = await fetch(BASE + path, {
+    method,
+    headers: { 'authorization': `Bearer ${TOKEN}`, 'content-type': 'application/json' },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const d = await res.json().catch(() => ({}))
+  if (d?.code !== undefined && d.code !== 0 && d.code !== 'ok') {
+    throw new Error(`${method} ${path} -> ${JSON.stringify(d).slice(0, 200)}`)
+  }
+  return d?.data ?? d
+}
+async function pollUntil(fn, timeoutMs, stepMs = 500) {
+  const t0 = Date.now()
+  for (;;) {
+    const v = await Promise.resolve(fn()).catch(() => null)
+    if (v) return v
+    if (Date.now() - t0 > timeoutMs) return null
+    await sleep(stepMs)
+  }
+}
+
+/** 终端 WS 会话(收集全部服务端消息) */
+function termWs(agentId, channelId) {
+  const state = { ws: null, msgs: [], frames: [], closed: false, closeCode: null, err: null }
+  state.open = new Promise((resolve, reject) => {
+    const ws = new WebSocket(`${WS_BASE}/api/system/monitor/terminal/ws?token=${TOKEN}&agentId=${agentId}&channelId=${channelId}`)
+    state.ws = ws
+    ws.addEventListener('open', () => resolve(), { once: true })
+    ws.addEventListener('error', () => reject(new Error('ws error')), { once: true })
+    ws.addEventListener('close', (ev) => {
+      state.closed = true
+      state.closeCode = ev.code
+    }, { once: true })
+    ws.addEventListener('message', (ev) => {
+      try {
+        const m = JSON.parse(ev.data)
+        state.msgs.push(m)
+        if (m.type === 'term.frames') state.frames.push(...m.frames)
+        if (m.type === 'term.error') state.err = m
+      }
+      catch { /* ignore */ }
+    })
+  })
+  state.send = o => state.ws.send(JSON.stringify(o))
+  state.frameTypes = () => new Set(state.frames.map(f => f.frame?.type))
+  return state
+}
+
+async function main() {
+  const stamp = Date.now().toString(36)
+  const created = await api('POST', '/api/workshop/channels', {
+    name: `omp-term-e2e-${stamp}`,
+    description: 'omp 终端控制 E2E(自动清理)',
+    leadAgent: { name: 'term-lead', harness: 'mock', config: { delayMs: 60 } },
+  })
+  const cid = created.channelId
+  try {
+    const w = await api('POST', `/api/workshop/channels/${cid}/agents`, { name: 'term-worker', harness: 'omp', config: {} })
+    const wid = w.id
+    console.log(`channel=${cid.slice(0, 8)} omp-worker=${wid.slice(0, 8)}`)
+
+    // ===== T1:任务触发 omp spawn → 终端会话出现 =====
+    console.log('\n--- T1:任务 → omp 子进程 spawn → 终端会话 ---')
+    const task = await api('POST', `/api/workshop/channels/${cid}/tasks`, {
+      title: `终端联调-${stamp}`,
+      description: '请直接回复一句"终端联调完成",然后用 complete_task 提交该回复作为交付物。不要做任何其他工作。',
+      assigneeId: wid,
+      parts: [{ text: '终端联调任务:只回复一句话并完成。' }],
+    })
+    const session = await pollUntil(async () => {
+      const terms = await api('GET', `/api/workshop/channels/${cid}/terminals`)
+      return terms.find(t => t.agentId === wid && t.alive) ?? null
+    }, 60_000, 800)
+    check('T1 omp 子进程 spawn,终端会话上线', !!session, session ? `pid=${session.pid}` : '60s 内未出现')
+
+    // ===== T2:WS 连接 → init + 实时帧 =====
+    console.log('\n--- T2:终端 WS 镜像流 ---')
+    const t = termWs(wid, cid)
+    await t.open
+    // init 帧在 open 之后异步到达(等待而非同 tick 断言)
+    const init = await pollUntil(() => t.msgs.find(m => m.type === 'term.init') ?? null, 8_000, 150)
+    check('T2 term.init(会话元信息)', !!init && init.meta?.agentId === wid,
+      init ? `pid=${init.meta.pid} running=${init.running}` : 'no init')
+    await pollUntil(() => t.frames.length > 0 ? true : null, 15_000, 200)
+    const types = t.frameTypes()
+    check('T2 实时帧到达(omp 会话事件镜像)', t.frames.length > 0, `frames=${t.frames.length} types=${[...types].slice(0, 6).join(',')}`)
+
+    // ===== 等任务回合结束(拿到可注入的空闲态) =====
+    const taskDone = await pollUntil(async () => {
+      const tasks = await api('GET', `/api/workshop/channels/${cid}/tasks`)
+      const st = tasks.find(x => x.id === task.id)?.state
+      return ['COMPLETED', 'FAILED', 'CANCELED'].includes(st) ? st : null
+    }, 120_000, 1000)
+    check('T1b 任务到达终态(真 LLM 执行)', !!taskDone, `state=${taskDone ?? 'timeout'}(LLM 不可用时为 FAILED,链路验证仍有效)`)
+
+    // ===== T3:Web 输入控制(follow_up 注入真实会话) =====
+    console.log('\n--- T3:Web 输入控制(input → omp 会话新回合) ---')
+    // 待应答 HITL 对话框会阻塞后续 prompt:先以 cancelled 应答(人类控制闭环)
+    const uiReq = [...t.frames].reverse().find(f => f.frame?.type === 'extension_ui_request' && f.frame.id)
+    if (uiReq) {
+      t.send({ type: 'ui_response', id: uiReq.frame.id, cancelled: true })
+      check('T3 待应答 HITL 对话框 → ui_response 应答', true, `method=${uiReq.frame.method} id=${String(uiReq.frame.id).slice(0, 8)}`)
+    }
+    else {
+      check('T3 无待应答 HITL 对话框(直接注入)', true)
+    }
+    const beforeHuman = t.frames.filter(f => f.frame?.type === '__human_input').length
+    t.send({ type: 'input', text: '请只回复两个字:收到' })
+    const humanEcho = await pollUntil(() =>
+      t.frames.filter(f => f.frame?.type === '__human_input').length > beforeHuman ? true : null, 8_000, 200)
+    check('T3 input 注入回显(__human_input 帧)', !!humanEcho)
+    // omp 应答 follow_up/steer(response.success)并驱动真实回合:
+    // follow_up 回合以 message_start/turn_start 起(agent_start 可能延后),取任一信号
+    const beforeN = t.frames.filter(f => ['agent_start', 'turn_start', 'message_start'].includes(f.frame?.type)).length
+    const newTurn = await pollUntil(() => {
+      const ok = t.frames.filter(f => f.frame?.type === 'response' && (f.frame.command === 'follow_up' || f.frame.command === 'steer') && f.frame.success).length > 0
+      const turnStarted = t.frames.filter(f => ['agent_start', 'turn_start', 'message_start'].includes(f.frame?.type)).length > beforeN
+      return ok && turnStarted ? true : null
+    }, 150_000, 800)
+    check('T3 omp 会话响应输入驱动真实回合(follow_up success + 新回合帧)', !!newTurn)
+
+    // ===== T4:abort 控制 =====
+    console.log('\n--- T4:abort 回合控制 ---')
+    // 若上一回合仍在流式,abort 立即生效;否则先注入再立刻 abort
+    t.send({ type: 'abort' })
+    // abort 接受判据:无 term.error,且回合收尾(turn_end/agent_end)或中止留痕在 30s 内出现
+    const abortEffect = await pollUntil(() => {
+      if (t.err) return 'error'
+      return t.frames.some(f => f.frame?.type === '__terminal_notice' && String(f.frame.message ?? '').includes('中止'))
+        || (() => {
+          const idx = t.frames.map(f => f.frame?.type).lastIndexOf('turn_end')
+          return idx >= 0 && t.frames.slice(idx).some(f => f.frame?.type === 'agent_end')
+        })()
+        ? 'effect'
+        : null
+    }, 30_000, 500)
+    check('T4 abort 指令被服务端接受并产生回合收尾', abortEffect === 'effect', abortEffect === 'error' ? `err=${t.err?.code}` : 'ok')
+    const noticeSeen = t.frames.some(f => f.frame?.type === '__terminal_notice' && String(f.frame.message ?? '').includes('中止'))
+    check('T4 abort 人类操作留痕(__terminal_notice)', noticeSeen)
+    t.ws.close()
+
+    // ===== 汇总:任务/消息产物 =====
+    const tasks = await api('GET', `/api/workshop/channels/${cid}/tasks`)
+    const tRow = tasks.find(x => x.id === task.id)
+    console.log(`\n(任务终态:${tRow?.state};交付物 ${(tRow?.artifacts ?? []).length} 件)`)
+  }
+  finally {
+    try {
+      await api('DELETE', `/api/workshop/channels/${cid}`)
+      console.log(`\n(测试 channel ${cid.slice(0, 8)} 已删除;omp 子进程随 channel 卸载终止)`)
+    }
+    catch (err) {
+      console.log(`\n(清理失败:${err.message})`)
+    }
+  }
+
+  console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILURE(S)`}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('E2E 异常:', err.message)
+  process.exit(1)
+})