agentworkshop 0.2.1

package/scripts/dev-guard.mjs

@@ -0,0 +1,74 @@
+/**
+ * dev 守卫包装:nuxt dev 的 CLI 父进程(Vite HMR WS 所在)与 nitro worker 都可能被
+ * 审计浏览器频繁开/关触发的陈旧 socket `read ECONNRESET` unhandledRejection 击穿
+ * (nuxt CLI 自带的 pretty 处理器会 log 后退出;worker 默认 throw)。
+ *
+ * 策略:以 `--unhandled-rejections=warn` 重入自身 —— Node 对未处理拒绝只发进程警告,
+ * 不派发 unhandledRejection 事件(任何注册处理器都不会触发 exit),nitro fork 的
+ * worker 继承 execArgv 同享保护。生产构建为单进程 nitro,由 workshop 插件守卫覆盖。
+ *
+ * 配置驱动:开发端口取自共享配置引擎 ——
+ *   config.yml 默认 < data/runtime-settings.json 运行时覆盖 < 环境变量 < CLI 显式参数
+ * 生效优先级:显式 --port/--host > AW_/PORT 环境 > runtime-settings.json > config.yml。
+ */
+if (!process.env.__AW_DEV_GUARD) {
+  const { spawnSync } = await import('node:child_process')
+  const { fileURLToPath } = await import('node:url')
+  const r = spawnSync(
+    process.execPath,
+    ['--unhandled-rejections=warn', ...process.execArgv, fileURLToPath(import.meta.url), ...process.argv.slice(2)],
+    { stdio: 'inherit', env: { ...process.env, __AW_DEV_GUARD: '1' } },
+  )
+  process.exit(r.status ?? 0)
+  throw new Error('unreachable')
+}
+
+console.log('[dev-guard] unhandled-rejections=warn 已启用(dev server 对断连 rejection 免疫)')
+
+const { existsSync, readFileSync } = await import('node:fs')
+const { dirname, resolve } = await import('node:path')
+const { fileURLToPath: u2f } = await import('node:url')
+
+const root = resolve(dirname(u2f(import.meta.url)), '..')
+
+// --- 预载 .env（与 start.mjs 同策略；已导出环境变量优先） ---
+const envPath = new URL('../.env', import.meta.url)
+if (existsSync(envPath)) {
+  for (const line of readFileSync(envPath, 'utf8').split(/\r?\n/)) {
+    const m = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)\s*$/)
+    if (!m || line.trim().startsWith('#')) continue
+    if (process.env[m[1]] === undefined) process.env[m[1]] = m[2]
+  }
+}
+
+// --- 共享配置引擎：计算有效开发端口/主机 ---
+const { loadEffective } = await import('../shared/config/engine.mjs')
+const eff = loadEffective({
+  configPath: resolve(root, 'config.yml'),
+  settingsPath: resolve(root, 'data', 'runtime-settings.json'),
+  env: process.env,
+  mode: 'dev',
+})
+
+// CLI 显式参数（pnpm dev -- --port 8080）优先，直接透传
+const rest = process.argv.slice(2) // ['dev', ...]
+const hasPort = rest.includes('--port') || rest.some(a => a.startsWith('--port='))
+const hasHost = rest.includes('--host') || rest.some(a => a.startsWith('--host='))
+
+const devPort = Number(eff.effective['server.dev.port']) || 3000
+const devHost = String(eff.effective['server.host'] ?? '0.0.0.0')
+const portSource = eff.sources['server.dev.port']
+console.log(`[config] 开发端口 -> ${devPort} (source: ${portSource}${hasPort ? ', CLI 显式覆盖生效' : ''})`)
+
+const inject = [...rest]
+if (!hasPort) inject.push('--port', String(devPort))
+if (!hasHost) inject.push('--host', devHost)
+
+// 把注入参数写入 process.argv（nuxt CLI 启动时读取 slice(2)），保证生效且不影响透传
+process.argv.push(...(inject.length > rest.length ? inject.slice(rest.length) : []))
+
+// nuxt 包 exports 不暴露 ./bin 子路径 → 用文件 URL 直连磁盘 CLI 入口(等效 `nuxt dev`)
+const { pathToFileURL } = await import('node:url')
+const { createRequire } = await import('node:module')
+const binPath = createRequire(import.meta.url).resolve('nuxt/package.json').replace(/package\.json$/, 'bin/nuxt.mjs')
+await import(pathToFileURL(binPath).href)

package/scripts/dev-modbus-simulator.mjs

@@ -0,0 +1,55 @@
+/**
+ * Modbus TCP 从站模拟器 —— 真实驱动的数据源(产线 PLC 仿真)。
+ * 保持寄存器 40001~40008:40001/40002 = float32 大端"熔体压力"(MPa,0.60~1.10 波动),
+ * 40003/40004 = float32"温度"(℃ 165~175)。端口 1502。
+ * 用途:开发/验收环境跑真实 Modbus 驱动链路(非 mock 路径)。
+ */
+import ModbusRTU from 'modbus-serial'
+
+const HOLDING = new Array(100).fill(0)
+let t = 0
+
+function float32BE_WORDS(value) {
+  const buf = Buffer.alloc(4)
+  buf.writeFloatBE(value, 0)
+  // Modbus 保持寄存器按字传输,每字大端:word0 = 高 16 位
+  return [buf.readUInt16BE(0), buf.readUInt16BE(2)]
+}
+
+setInterval(() => {
+  t += 1
+  const pressure = 0.85 + Math.sin(t * 0.05) * 0.12 + (Math.random() - 0.5) * 0.04
+  const temp = 170 + Math.sin(t * 0.03) * 3 + (Math.random() - 0.5) * 1.2
+  const [p0, p1] = float32BE_WORDS(Number(pressure.toFixed(3)))
+  const [t0, t1] = float32BE_WORDS(Number(temp.toFixed(2)))
+  HOLDING[0] = p0
+  HOLDING[1] = p1
+  HOLDING[2] = t0
+  HOLDING[3] = t1
+}, 1000)
+
+// 设定值组(40021+,上位机写入口;模拟器不覆盖,写入即保持 —— 供写控制链路验证)
+const vector = {
+  getHoldingRegister(addr) {
+    return HOLDING[addr] ?? 0
+  },
+  getMultipleHoldingRegisters(addr, length) {
+    return HOLDING.slice(addr, addr + length)
+  },
+  setRegister(addr, value) {
+    HOLDING[addr] = value & 0xFFFF
+  },
+  setMultipleRegisters(addr, values) {
+    for (let i = 0; i < values.length; i++) HOLDING[addr + i] = values[i] & 0xFFFF
+    console.log(`[modbus-sim] 写入保持寄存器 offset=${addr}: ${values.join(',')}`)
+  },
+}
+
+const server = new ModbusRTU.ServerTCP(vector, { host: '0.0.0.0', port: 1502, debug: false })
+server.on('initialized', () => console.log('[modbus-sim] 从站就绪 0.0.0.0:1502(40001 压力 float32 / 40003 温度 float32)'))
+server.on('socket', () => {})
+
+process.on('SIGINT', () => {
+  server.close(() => process.exit(0))
+  setTimeout(() => process.exit(0), 500)
+})

package/scripts/dev-opcua-simulator.mjs

@@ -0,0 +1,57 @@
+/**
+ * OPC UA 模拟器(dev)—— 真实 OPC UA 服务器,供驱动真连测试/演示。
+ * 端点:opc.tcp://127.0.0.1:4840(仅本机回环)
+ * 节点:ns=2;s=AW.Temp(模拟量,周期随机游走)/ ns=2;s=AW.SetTemp(可写设定值)
+ * 注意:自定义命名空间 ns=2(ns=0 标准 / ns=1 服务器内部)
+ */
+import { OPCUAServer, Variant, DataType, StatusCodes } from 'node-opcua'
+
+const PORT = Number(process.env.OPCUA_SIM_PORT ?? 4840)
+
+const server = new OPCUAServer({
+  port: PORT,
+  hostname: '127.0.0.1',
+  buildInfo: { productName: 'AgentWorkShop-OPCUA-Simulator' },
+})
+
+await server.initialize()
+const addressSpace = server.engine.addressSpace
+const ns = addressSpace.registerNamespace('AW-Sim')
+const device = ns.addObject({
+  organizedBy: addressSpace.rootFolder.objects,
+  nodeId: 's=AW.Device',
+  browseName: 'AWDevice',
+})
+const tempVar = ns.addVariable({
+  componentOf: device,
+  nodeId: 's=AW.Temp',
+  browseName: 'Temp',
+  dataType: 'Double',
+  value: new Variant({ dataType: DataType.Double, value: 168.5 }),
+})
+ns.addVariable({
+  componentOf: device,
+  nodeId: 's=AW.SetTemp',
+  browseName: 'SetTemp',
+  dataType: 'Double',
+  value: new Variant({ dataType: DataType.Double, value: 180 }),
+})
+
+await server.start()
+console.log(`[opcua-sim] 端点 opc.tcp://127.0.0.1:${PORT}(AW-Sim 命名空间 ns=${ns.index})`)
+console.log('[opcua-sim] 节点: ns=2;s=AW.Temp(采集) / ns=2;s=AW.SetTemp(设定,可写)')
+
+// Temp 缓慢随机游走(仿真真实过程量)
+let t = 168.5
+setInterval(() => {
+  t += (Math.random() - 0.48) * 0.8
+  t = Math.max(150, Math.min(185, t))
+  tempVar.setValueFromSource({ dataType: DataType.Double, value: Number(t.toFixed(2)) })
+}, 1000)
+
+// 优雅退出
+process.on('SIGINT', async () => {
+  await server.shutdown()
+  process.exit(0)
+})
+void StatusCodes.Good

package/scripts/dev-protocol-simulators.mjs

@@ -0,0 +1,145 @@
+/**
+ * 多协议模拟器(dev)—— MQTT Broker(最小实现)+ HTTP 端点,供驱动真连测试/演示。
+ *   MQTT:mqtt://127.0.0.1:1883  broker 每 2s 发布 aw/sim/temp = {"data":{"temp":…}}
+ *        (基于 mqtt-packet 编解码 —— mqtt.js 客户端同源参考实现;支持 QoS0 + +/# 通配)
+ *   HTTP:http://127.0.0.1:1889/api/value(GET JSON)/ http://127.0.0.1:1889/api/setpoint(POST)
+ * Modbus TCP 模拟器见 dev-modbus-simulator.mjs(1502);OPC UA 见 dev-opcua-simulator.mjs(4840)。
+ */
+import net from 'node:net'
+import http from 'node:http'
+import { createRequire } from 'node:module'
+
+const reqRoot = createRequire(import.meta.url)
+// pnpm 严格布局:mqtt-packet 是 mqtt 的传递依赖,从 mqtt 包入口路径解析
+const reqMqtt = createRequire(reqRoot.resolve('mqtt'))
+const mqttPacket = reqMqtt('mqtt-packet')
+
+/** MQTT 主题过滤匹配(+ 单层 / # 多层) */
+function topicMatch(filter, topic) {
+  const f = filter.split('/')
+  const t = topic.split('/')
+  let i = 0
+  for (; i < f.length; i++) {
+    if (f[i] === '#') return true
+    if (t[i] === undefined) return false
+    if (f[i] !== '+' && f[i] !== t[i]) return false
+  }
+  return i === t.length
+}
+
+const clients = new Set()
+
+function brokerPublish(topic, payload) {
+  const frame = mqttPacket.generate({ cmd: 'publish', topic, payload, qos: 0 })
+  for (const c of clients) {
+    if (c.filters.some(f => topicMatch(f, topic))) {
+      try {
+        c.sock.write(frame)
+      }
+      catch { clients.delete(c) }
+    }
+  }
+}
+
+const mqttServer = net.createServer((sock) => {
+  const client = { sock, filters: [] }
+  clients.add(client)
+  const parser = mqttPacket.parser({ protocolVersion: 4 })
+  sock.on('data', d => parser.parse(d))
+  sock.on('error', () => clients.delete(client))
+  sock.on('close', () => clients.delete(client))
+  parser.on('packet', (packet) => {
+    try {
+      switch (packet.cmd) {
+        case 'connect': {
+          sock.write(mqttPacket.generate({ cmd: 'connack', returnCode: 0, sessionPresent: false }))
+          break
+        }
+        case 'subscribe': {
+          client.filters = packet.subscriptions.map(s => s.topic)
+          sock.write(mqttPacket.generate({
+            cmd: 'suback',
+            messageId: packet.messageId,
+            granted: packet.subscriptions.map(() => 0),
+          }))
+          break
+        }
+        case 'publish': {
+          // 先回确认(QoS1 必须 puback,QoS0 无需),再路由
+          if (packet.qos === 1) {
+            sock.write(mqttPacket.generate({ cmd: 'puback', messageId: packet.messageId }))
+          }
+          brokerPublish(packet.topic, Buffer.from(packet.payload))
+          break
+        }
+        case 'pubrel': {
+          sock.write(mqttPacket.generate({ cmd: 'pubcomp', messageId: packet.messageId }))
+          break
+        }
+        case 'puback': {
+          // 客户端确认我方 QoS1 下行:无需动作
+          break
+        }
+        case 'pingreq': {
+          sock.write(mqttPacket.generate({ cmd: 'pingresp' }))
+          break
+        }
+        case 'disconnect': {
+          sock.end()
+          break
+        }
+      }
+    }
+    catch { /* 单帧异常不断链 */ }
+  })
+})
+mqttServer.listen(Number(process.env.MQTT_SIM_PORT ?? 1883), '127.0.0.1', () => {
+  console.log('[mqtt-sim] broker mqtt://127.0.0.1:1883 就绪(每 2s 发布 aw/sim/temp)')
+})
+
+mqttServer.on('error', (err) => {
+  console.error('[mqtt-sim] server error:', err.message)
+})
+// 周期发布模拟量(供数采驱动订阅)
+let temp = 51.2
+setInterval(() => {
+  temp = Number(Math.max(40, Math.min(60, temp + (Math.random() - 0.48) * 0.6)).toFixed(2))
+  brokerPublish('aw/sim/temp', Buffer.from(JSON.stringify({ data: { temp } })))
+}, 2000)
+
+// ---- HTTP 端点 ----
+const httpServer = http.createServer((req, res) => {
+  let body = ''
+  req.on('data', (c) => {
+    body += c
+  })
+  req.on('end', () => {
+    if (req.method === 'POST' && req.url === '/api/setpoint') {
+      console.log('[http-sim] 收到下发:', body)
+      res.writeHead(200, { 'content-type': 'application/json' })
+      res.end(JSON.stringify({ ok: true, received: JSON.parse(body || '{}') }))
+      return
+    }
+    if (req.url?.startsWith('/api/value')) {
+      res.writeHead(200, { 'content-type': 'application/json' })
+      res.end(JSON.stringify({ code: 0, data: { value: Number((42.5 + (Math.random() - 0.5)).toFixed(2)) } }))
+      return
+    }
+    res.writeHead(404, { 'content-type': 'application/json' })
+    res.end(JSON.stringify({ error: 'not found' }))
+  })
+})
+httpServer.listen(Number(process.env.HTTP_SIM_PORT ?? 1889), '127.0.0.1', () => {
+  console.log('[http-sim] GET http://127.0.0.1:1889/api/value / POST http://127.0.0.1:1889/api/setpoint 就绪')
+})
+
+mqttServer.on('error', err => console.error('[mqtt-sim] server error:', err.message))
+httpServer.on('error', err => console.error('[http-sim] server error:', err.message))
+process.on('unhandledRejection', err => console.error('[sim] unhandledRejection:', err instanceof Error ? err.message : err))
+process.on('uncaughtException', err => console.error('[sim] uncaughtException:', err instanceof Error ? err.message : err))
+
+process.on('SIGINT', () => {
+  mqttServer.close()
+  httpServer.close()
+  process.exit(0)
+})

package/scripts/dev-window.cmd

@@ -0,0 +1,6 @@
+@echo off
+rem AgentWorkShop dev server 常驻窗口(独立于 agent 会话,可随时关闭窗口停止)
+cd /d D:\codes\ABO\AgentWorkShop
+title AW dev server :3000
+npm run dev
+pause

package/scripts/device-line-restore.mjs

@@ -0,0 +1,34 @@
+/** 一次性:重建流延膜产线设备(device-twins 注册表;强杀进程导致的注册表清空后恢复)
+ *  设备 = 模型库实体(挤出机/MD 纵拉机/TD 拉幅机/收卷机/控制台/循环泵),沿 x 轴成线布置。
+ */
+const BASE = 'http://127.0.0.1:3000'
+const login = await fetch(`${BASE}/api/users/login`, {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ email: 'zhangwei@awshop.io', password: 'Awshop@123' }),
+}).then(r => r.json())
+const H = { 'authorization': `Bearer ${login.data.token}`, 'content-type': 'application/json' }
+
+const DEVICES = [
+  { name: '挤出机 L1', modelRef: 'extruder', posX: 1300, posZ: 1100, rotationY: 0 },
+  { name: 'MD 纵拉机 L1', modelRef: 'mdo', posX: 1650, posZ: 1100, rotationY: 0 },
+  { name: 'TD 拉幅机 L1', modelRef: 'tdo', posX: 2000, posZ: 1100, rotationY: 0 },
+  { name: '收卷机 L1', modelRef: 'winder', posX: 2350, posZ: 1100, rotationY: 0 },
+  { name: '控制台 · CON', modelRef: 'device-console', posX: 1300, posZ: 1450, rotationY: 180, controls: ['start', 'stop'] },
+  { name: '循环泵 #01', modelRef: 'pump', posX: 2300, posZ: 1500, rotationY: 30, scale: 1.6, controls: ['start', 'stop'], telemetry: { rpm: 2960, pressure: 0.82, temp: 63, vibration: 3.4 } },
+]
+
+const existing = await fetch(`${BASE}/api/workshop/device-twins`, { headers: H }).then(r => r.json())
+const have = new Set((existing?.data?.twins ?? existing?.data ?? []).map(t => t.name))
+for (const d of DEVICES) {
+  if (have.has(d.name)) {
+    console.log('skip (exists):', d.name)
+    continue
+  }
+  const r = await fetch(`${BASE}/api/workshop/device-twins`, { method: 'POST', headers: H, body: JSON.stringify(d) })
+  const j = await r.json().catch(() => ({}))
+  console.log(r.ok ? 'created:' : 'FAILED:', d.name, r.ok ? j?.data?.twin?.id ?? j?.data?.id ?? '' : JSON.stringify(j).slice(0, 120))
+}
+const after = await fetch(`${BASE}/api/workshop/device-twins`, { headers: H }).then(r => r.json())
+const list = after?.data?.twins ?? after?.data ?? []
+console.log('total twins now:', list.length, '| placed:', list.filter(t => typeof t.posX === 'number').length)

package/scripts/diag-lead-status.ts

@@ -0,0 +1,101 @@
+/**
+ * 诊断:goal 模式下 lead/worker 的 agent.status 事件流(mock)。
+ * 观察 lead 判定完成前后 emit 的状态事件,定位"lead 状态不同步"缺口。
+ */
+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 { createAgentImpl } from '../server/services/workshop/agents/factory'
+
+const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
+async function waitUntil(cond: () => boolean, timeoutMs: number): Promise<boolean> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (cond()) return true
+    await sleep(40)
+  }
+  return false
+}
+
+async function main(): Promise<void> {
+  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 })
+  const events: string[] = []
+
+  const ch = await manager.createChannel({
+    name: 'goal 诊断',
+    leadAgent: { name: 'lead-g', harness: 'mock', config: { delayMs: 10 } },
+  })
+  await manager.addAgentToChannel({
+    channelId: ch.channelId,
+    agentId: (await manager.createAgent({ name: 'w-g', harness: 'mock', config: { delayMs: 10 } })).id,
+    role: 'worker',
+  })
+  manager.ensureChannelActive(ch.channelId, { tickMs: 30, stallMs: 60_000 })
+
+  const unsubAgent = manager.subscribeAgentStatus(ch.channelId, (e) => {
+    events.push(`status ${e.agentId} ${e.state} current=${e.currentTaskId ?? '-'} q=${e.queuedCount ?? 0} c=${e.completedCount ?? 0}`)
+  })
+  const unsubTask = manager.subscribeTaskEvents(ch.channelId, (e) => {
+    events.push(`task   ${e.taskId.slice(0, 8)} state=${e.state ?? '-'} agent=${e.agentId ?? '-'}`)
+  })
+
+  /** 内部访问:类型收窄(公开 API 未暴露 taskEngine)→ 具名接口,供诊断读取任务状态 */
+  interface EngineInternal {
+    get(id: string): { state: string } | undefined
+    list(channelId: string): { id: string, state: string, title: string, parentId?: string }[]
+  }
+  const engine: EngineInternal = (manager as unknown as {
+    getTaskEngine(): EngineInternal
+  }).getTaskEngine()
+
+  const task = await manager.submitChannelTask({
+    channelId: ch.channelId,
+    title: '诊断目标',
+    description: '完成即可',
+    mode: 'goal',
+    modeConfig: { goalCriteria: '完成' },
+  })
+
+  const ok = await waitUntil(() => engine.get(task.id)?.state === 'COMPLETED', 15_000)
+  await sleep(600) // 等可能的后续事件落盘
+  console.log(`goal COMPLETED: ${ok}`)
+  console.log('--- 事件流(按序) ---')
+  for (const e of events) console.log('  ' + e)
+
+  const leadEvents = events.filter(e => e.startsWith('status lead-g'))
+  const workerEvents = events.filter(e => e.startsWith('status w-g'))
+  console.log(`\nlead 状态事件数=${leadEvents.length}`)
+  console.log(`worker 状态事件数=${workerEvents.length}`)
+
+  unsubAgent()
+  unsubTask()
+  await manager.shutdown()
+  db.close()
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})

package/scripts/e2e-a2a-steer-live.mjs

@@ -0,0 +1,193 @@
+/**
+ * A2A steer 注入 仪器化端到端测试(生产服务器 + 真实 omp 子进程)。
+ *
+ * 与朴素版区别:250ms 高频采样 agent 状态与任务状态;
+ * 注入时机由「观测到 worker busy + 子任务 WORKING」触发,确保命中 omp 回合执行中窗口;
+ * 用 DB 行有无作为 steer(进程内注入,不落库)vs mailbox(入队,落库)的判别证据:
+ *  - busy → impl.steer → omp rpc steer 帧 → 不写 messages 表
+ *  - idle → mailbox.enqueue → messages 表出现该 messageId 行
+ *
+ * 用法: node scripts/e2e-a2a-steer-live.mjs [--base http://127.0.0.1:3001]
+ */
+import { DatabaseSync } from 'node:sqlite'
+
+const BASE = (process.argv.find(a => a.startsWith('--base='))?.slice(7) ?? 'http://127.0.0.1:3001') + '/api/workshop'
+
+let pass = 0, fail = 0
+function check(name, ok, detail = '') {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (ok) pass++
+  else fail++
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const t0 = Date.now()
+const ts = () => `+${((Date.now() - t0) / 1000).toFixed(1)}s`
+const timeline = []
+function log(e) {
+  timeline.push(`${ts()} ${e}`)
+  console.log(`  [${ts()}] ${e}`)
+}
+
+async function req(method, path, body) {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: body ? { 'content-type': 'application/json' } : {},
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  return { status: res.status, json: await res.json().catch(() => null) }
+}
+
+function dbHasMessage(messageId) {
+  const db = new DatabaseSync('data/workshop.sqlite', { readOnly: true })
+  try {
+    const row = db.prepare('SELECT state FROM messages WHERE id = ?').get(messageId)
+    return row ?? null
+  }
+  finally { db.close() }
+}
+
+async function main() {
+  console.log('━━━ 1. 搭建 omp channel ━━━')
+  const leadTpl = await req('POST', '/agents', { name: 'live-lead', harness: 'omp' })
+  const workerTpl = await req('POST', '/agents', { name: 'live-worker', harness: 'omp' })
+  const ch = await req('POST', '/channels', { name: 'a2a-steer-live', description: 'live steer e2e' })
+  const channelId = ch.json.data.channelId
+  const lead = await req('POST', `/channels/${channelId}/agents`, { agentId: leadTpl.json.data.id, role: 'lead' })
+  const worker = await req('POST', `/channels/${channelId}/agents`, { agentId: workerTpl.json.data.id, role: 'worker' })
+  const LEAD_ID = lead.json.data.id
+  const WORKER_ID = worker.json.data.id
+  log(`channel=${channelId.slice(0, 8)}… lead=${LEAD_ID.slice(0, 8)}… worker=${WORKER_ID.slice(0, 8)}…`)
+  const cleanup = { channelId, agentIds: [leadTpl.json.data.id, workerTpl.json.data.id] }
+
+  console.log('━━━ 1.5 预热:小任务把 lead/worker 两个 omp 进程拉起(消除 ~55s 冷启动窗口)━━━')
+  const warm = await req('POST', `/channels/${channelId}/tasks`, {
+    title: 'warmup',
+    description: '预热任务:直接完成,无需实际工作。',
+  })
+  const warmDone = await (async () => {
+    for (let i = 0; i < 90; i++) {
+      const { json } = await req('GET', `/tasks/${warm.json.data.id}`)
+      if (['COMPLETED', 'FAILED', 'CANCELED'].includes(json?.data?.state)) return json.data.state
+      await sleep(2000)
+    }
+    return 'timeout'
+  })()
+  log(`warmup ${warmDone}(omp 进程已就绪)`)
+  if (warmDone !== 'COMPLETED') {
+    console.log('  预热未完成,继续尝试真实测试')
+  }
+  const taskResp = await req('POST', `/channels/${channelId}/tasks`, {
+    title: '编写并运行一个 Node 脚本',
+    description: '在工作目录创建 fib.js:实现记忆化 fib(n),写测试断言 fib(10)=55、fib(20)=6765、fib(30)=832040,node 执行测试输出结果,完成后报告路径与输出。',
+  })
+  const taskId = taskResp.json.data.id
+  log(`task 提交: ${taskId.slice(0, 8)}…`)
+
+  // 高频采样:queue(agent 状态)+ tasks(任务状态)
+  let workerBusyAt = null
+  const deadline = Date.now() + 120_000
+  let lastSnap = ''
+  while (Date.now() < deadline) {
+    const q = await req('GET', `/channels/${channelId}/queue`)
+    const w = (q.json.data ?? []).find(a => a.agentId === WORKER_ID)
+    const tl = await req('GET', `/channels/${channelId}/tasks`)
+    const child = (tl.json.data ?? []).find(t => t.parentId === taskId)
+    const snap = `worker=${w?.state ?? '?'} child=${child?.state ?? '-'}`
+    if (snap !== lastSnap) {
+      log(snap)
+      lastSnap = snap
+    }
+    if (w?.state === 'busy' && child?.state === 'WORKING') {
+      workerBusyAt = { agentState: w.state, childId: child.id, childState: child.state }
+      break
+    }
+    await sleep(250)
+  }
+  check('观测到 worker busy + 子任务 WORKING', !!workerBusyAt,
+    workerBusyAt ? `child=${workerBusyAt.childId.slice(0, 8)}…` : '120s 内未出现(检查 omp spawn)')
+
+  if (!workerBusyAt) {
+    await req('DELETE', `/channels/${channelId}`)
+    console.log(`\n━━━ 结果: PASS=${pass} FAIL=${fail} ━━━`)
+    process.exit(1)
+  }
+
+  console.log('━━━ 3. 注入时机已命中:immediate 消息 → omp 进程内 steer ━━━')
+  const tInject = Date.now()
+  const inj = await req('POST', `/channels/${channelId}/messages`, {
+    toAgentId: WORKER_ID,
+    fromAgentId: LEAD_ID,
+    text: '实时插话:请在最终报告里补充一行「已收到实时插话」并给出 fib(10) 的值。继续当前工作不要中断。',
+    priority: 'immediate',
+    requireReply: true,
+  })
+  const apiMs = Date.now() - tInject
+  const messageId = inj.json?.data?.messageId
+  check('immediate API 即时返回', inj.json?.code === 0 && apiMs < 1000, `${apiMs}ms messageId=${messageId?.slice(0, 8)}…`)
+  log(`immediate 注入完成(${apiMs}ms)`)
+
+  // 立即查 DB:无行 = busy 命中 → steer 进程内注入
+  await sleep(300)
+  const dbRow = messageId ? dbHasMessage(messageId) : null
+  check('DB 无 mailbox 行 → 走 steer 进程内注入(非队列)', dbRow === null,
+    dbRow ? `DB 有行 state=${dbRow.state}(走了 mailbox:注入时 worker 非 busy)` : '无行,omp rpc steer 帧已发')
+
+  // 注入后监控:worker 持续执行至子任务终态(不中断)
+  const deadline2 = Date.now() + 240_000
+  let last2 = ''
+  let interrupted = false
+  while (Date.now() < deadline2) {
+    const tl = await req('GET', `/channels/${channelId}/tasks`)
+    const c2 = (tl.json.data ?? []).find(t => t.id === workerBusyAt.childId)
+    if (!c2) break
+    if (c2.state === 'CANCELED' || c2.state === 'FAILED') {
+      interrupted = true
+      break
+    }
+    if (c2.state === 'COMPLETED') break
+    const q = await req('GET', `/channels/${channelId}/queue`)
+    const wState = (q.json.data ?? []).find(a => a.agentId === WORKER_ID)?.state
+    const snap = `worker=${wState} child=${c2.state} progress=${c2.progress ?? 0}`
+    if (snap !== last2) {
+      log(snap)
+      last2 = snap
+    }
+    await sleep(1000)
+  }
+  const finalChild = await req('GET', `/tasks/${workerBusyAt.childId}`)
+  check('注入未中断执行:子任务 COMPLETED', finalChild.json?.data?.state === 'COMPLETED' && !interrupted,
+    `state=${finalChild.json?.data?.state}`)
+
+  console.log('━━━ 4. 回执与收尾 ━━━')
+  // 信息性观察:注入内容是否被模型在同轮引用(LLM 行为,不作硬断言)
+  const arts = finalChild.json?.data?.artifacts ?? []
+  const allText = arts.map(a => a.parts.map(p => p.text ?? '').join('')).join('\n')
+  const markerSeen = allText.includes('已收到实时插话')
+  console.log(`  ${markerSeen ? 'PASS' : 'WARN'}  产出引用了注入内容(同轮可见)${markerSeen ? '' : ' — 模型未在报告中原样复述(取决于 LLM)'}`)
+
+  // requireReply 回执:等 channel 消息历史出现 in_reply_to 关联的 worker→lead 回执(信息性)
+  let reply = null
+  for (let i = 0; i < 30 && !reply; i++) {
+    await sleep(1500)
+    const hist = await req('GET', `/channels/${channelId}/messages?limit=100`)
+    reply = (hist.json?.data ?? []).find(m => m.toAgentId === LEAD_ID && m.metadata?.['x-aw-in-reply-to'] === messageId)
+  }
+  console.log(`  ${reply ? 'PASS' : 'WARN'}  worker 回执(in_reply_to 关联)${reply ? ' — ' + (reply.parts ?? []).map(p => p.text ?? '').join(' ').slice(0, 80) : ' — 未调用回执工具(LLM 行为)'}`)
+
+  // 全员 idle(硬断言)
+  await sleep(2000)
+  const q3 = await req('GET', `/channels/${channelId}/queue`)
+  check('收尾全员 idle', (q3.json.data ?? []).every(a => a.state === 'idle'),
+    JSON.stringify((q3.json.data ?? []).map(a => `${a.name}:${a.state}`)))
+
+  await req('DELETE', `/channels/${channelId}`)
+  for (const id of cleanup.agentIds) await req('DELETE', `/agents/${id}`)
+  console.log(`\n━━━ 时间线 ━━━\n${timeline.join('\n')}`)
+  console.log(`\n━━━ 结果: PASS=${pass} FAIL=${fail} ━━━`)
+  process.exit(fail === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('e2e crashed:', err)
+  process.exit(1)
+})