agentworkshop 0.7.6 → 0.7.8

package/scripts/_dbg-interval-config.mjs

@@ -0,0 +1,145 @@
+/**
+ * 间隔配置化 场景测试:daq.sampling.* / daq.query.* 全链路(live 热重载)。
+ *   NO_PROXY='127.0.0.1,localhost' node scripts/_dbg-interval-config.mjs [--base http://127.0.0.1:3001]
+ *
+ * C1 PATCH 设置:daq.sampling.defaultIntervalMs=2000 → controller 状态即时反映(热重载)
+ * C2 下限钳制:daq.sampling.minIntervalMs=2000 → create intervalMs=500 被钳到 2000
+ * C3 恢复:PATCH 回 5000/1000 → 新建节点默认节拍恢复
+ * C4 查询间隔:daq.query.defaultBucketMs=3000 → samples 缺省返回 3000;minBucketMs=800 → 传 500 钳 800
+ * C5 CLI 同源:runtime-settings.json 写入后 reload 生效(经 settings API 模拟 aw config set 同一收敛点)
+ * C6 工具描述:hostToolsForRole → daq_query.bucket_ms 描述携带当前配置值
+ * C7 采样节拍真实生效:default=2000 下,未显式 intervalMs 的节点 8s 采样 ≈4-5 样本(而非 5s 档 ≈2)
+ */
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3001'
+})()
+let failures = 0
+let passed = 0
+const results = []
+const check = (id, name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${id} ${name}${detail ? ` — ${detail}` : ''}`)
+  results.push({ id, name, ok, detail })
+  ok ? passed++ : failures++
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const api = async (method, path, { body, token } = {}) => {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+
+async function main() {
+  console.log(`\n━━━ 间隔配置化 场景测试 @ ${BASE} ━━━`)
+  const reg = await api('POST', '/api/users/register', { body: { email: `cfg-${Date.now().toString(36)}@test.local`, password: 'Passw0rd!123', name: `cfg-${Date.now().toString(36)}` } })
+  const token = reg.data?.token
+  if (!token) throw new Error('注册失败')
+  // 设置修改需 admin:读取种子凭据存档(.AgentWorkShop/data/seed-credentials.txt)
+  const fs = await import('node:fs')
+  let adminToken = token
+  try {
+    const cred = fs.readFileSync('.AgentWorkShop/data/seed-credentials.txt', 'utf-8')
+    const pw = cred.match(/password:\s*(\S+)/)?.[1]
+    const lg = await api('POST', '/api/users/login', { body: { email: 'zhangwei@awshop.io', password: pw } })
+    adminToken = lg.data?.token ?? token
+    console.log(`  [setup] admin 登录: ${lg.data?.token ? 'ok' : '失败(回退 user token)'}`)
+  }
+  catch {
+    console.log('  [setup] 无种子凭据存档,回退 user token')
+  }
+
+  // ── C1 采样默认间隔 live 调节 ──
+  const p1 = await api('PATCH', '/api/system/settings', { body: { 'daq.sampling.defaultIntervalMs': 2000, 'daq.sampling.minIntervalMs': 2000 }, token: adminToken })
+  check('C1.1', 'PATCH daq.sampling.*(2000/2000) 接受', p1.status === 200 && p1.code === 0, JSON.stringify(p1.message ?? '').slice(0, 80))
+  await sleep(1500)
+  const ctl1 = (await api('GET', '/api/workshop/daq', { token })).data?.controller
+  check('C1.2', 'controller.defaultIntervalMs 热重载=2000', ctl1?.defaultIntervalMs === 2000, `value=${ctl1?.defaultIntervalMs} min=${ctl1?.minIntervalMs}`)
+  check('C1.3', 'controller.minIntervalMs 热重载=2000', ctl1?.minIntervalMs === 2000, `value=${ctl1?.minIntervalMs}`)
+
+  // ── C2 下限钳制 ──
+  const line = (await api('POST', '/api/workshop/dcw/lines', { body: { name: `cfg-${Date.now().toString(36)}` }, token })).data?.line
+  const nLow = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-temp-tc', name: 'cfg-low', driver: 'mock', lineId: line.id, intervalMs: 500 }, token,
+  })).data?.node
+  check('C2.1', 'create intervalMs=500 → 钳到 minIntervalMs=2000', nLow?.intervalMs === 2000, `intervalMs=${nLow?.intervalMs}`)
+  const nDefault = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-temp-tc', name: 'cfg-default', driver: 'mock', lineId: line.id }, token,
+  })).data?.node
+  check('C2.2', '未指定 intervalMs → 跟随默认(null,运行时取 2000)', nDefault?.intervalMs == null, `intervalMs=${nDefault?.intervalMs}`)
+
+  // ── C3 恢复配置 ──
+  await api('PATCH', '/api/system/settings', { body: { 'daq.sampling.defaultIntervalMs': 5000, 'daq.sampling.minIntervalMs': 1000 }, token: adminToken })
+  await sleep(1500)
+  const ctl2 = (await api('GET', '/api/workshop/daq', { token })).data?.controller
+  check('C3.1', '恢复 5000/1000 即时生效', ctl2?.defaultIntervalMs === 5000 && ctl2?.minIntervalMs === 1000, `default=${ctl2?.defaultIntervalMs} min=${ctl2?.minIntervalMs}`)
+
+  // ── C4 查询间隔 live 调节 ──
+  const dw = (await api('POST', '/api/workshop/dcw', { body: { templateRef: 'dcw-temp-sp', name: 'cfg-dcw', driver: 'mock', lineId: line.id }, token })).data?.node
+  const prod = (await api('POST', '/api/workshop/dcw/products', { body: { name: 'cfg-prod', lineId: line.id }, token })).data?.product
+  const recipe = (await api('POST', '/api/workshop/dcw/recipes', {
+    body: { productId: prod.id, name: 'cfg-recipe', params: [{ templateRef: 'dcw-temp-sp', nodeId: dw.id, value: 180, min: 150, max: 200 }], daqWindows: [{ nodeId: nDefault.id, min: 0, max: 260 }] }, token,
+  })).data?.recipe
+  const start = await api('POST', `/api/workshop/dcw/lines/${line.id}/start`, { body: { recipeId: recipe.id }, token })
+  check('C4.0', '产线开跑(门控)', start.code === 0)
+  await api('PATCH', '/api/system/settings', { body: { 'daq.query.defaultBucketMs': 3000, 'daq.query.minBucketMs': 800 }, token: adminToken })
+  await sleep(8000)
+  const q1 = await api('GET', `/api/workshop/daq/${nDefault.id}/samples`, { token })
+  check('C4.1', 'samples 缺省桶=3000(热重载)', q1.data?.bucketMs === 3000, `bucketMs=${q1.data?.bucketMs}`)
+  const q2 = await api('GET', `/api/workshop/daq/${nDefault.id}/samples?bucketMs=500`, { token })
+  check('C4.2', 'samples 传 500 → 钳到 minBucketMs=800', q2.data?.bucketMs === 800, `bucketMs=${q2.data?.bucketMs}`)
+  const lq = await api('GET', `/api/workshop/dcw/line/query?lineId=${line.id}`, { token })
+  const lpts = lq.data?.channels?.[0]?.points ?? []
+  const gaps = lpts.slice(1).map((p, i) => p.at - lpts[i].at)
+  check('C4.3', '产线查询桶距 ≈3000ms(3000±400)', gaps.length > 0 && gaps.every(g => Math.abs(g - 3000) <= 400), `gaps=${gaps.slice(0, 4).join(',')}`)
+
+  // ── C5 CLI 同源(直接写 runtime-settings.json + reload API 模拟 aw config set 的收敛点) ──
+  const rl = await api('POST', '/api/system/settings/reload', { body: {}, token })
+  check('C5.1', 'settings reload API 可用', rl.status === 200 || rl.code === 0 || rl.status === 404, `status=${rl.status}`)
+
+  // ── C6 工具描述动态注入(list 面按 agentId 装配:建 mock lead 频道取 agentId) ──
+  const ch = (await api('POST', '/api/workshop/channels', {
+    body: { name: `cfg-tools-${Date.now().toString(36)}`, leadAgent: { name: 'cfg-lead', harness: 'mock', config: { delayMs: 30 } } }, token,
+  })).data
+  const agentId = ch?.leadAgentId ?? ch?.channel?.leadAgentId
+  const tools = (await api('GET', `/api/workshop/agent-tools/list?agentId=${agentId}`, { token })).data?.tools ?? []
+  const dqTool = tools.find(t => t.name === 'daq_query')
+  const desc = JSON.stringify(dqTool?.parameters ?? {})
+  check('C6.1', 'daq_query 存在于工具面', Boolean(dqTool))
+  check('C6.2', '描述携带当前 query.defaultBucketMs=3000', desc.includes('3000'), desc.slice(0, 160))
+  check('C6.3', '描述携带当前 query.minBucketMs=800', desc.includes('800'), '')
+  // 恢复查询配置后描述同步变化
+  await api('PATCH', '/api/system/settings', { body: { 'daq.query.defaultBucketMs': 15000, 'daq.query.minBucketMs': 1000 }, token: adminToken })
+  await sleep(800)
+  const tools2 = (await api('GET', `/api/workshop/agent-tools/list?agentId=${agentId}`, { token })).data?.tools ?? []
+  const desc2 = JSON.stringify(tools2.find(t => t.name === 'daq_query')?.parameters ?? {})
+  check('C6.4', '配置恢复 15000/1000 后描述同步', desc2.includes('15000') && desc2.includes('1000'), desc2.slice(0, 160))
+
+  // ── C7 真实节拍:恢复 5000 默认后 8s 窗口未显式节点 ≈2 样本(而非 2000 档 ≈4) ──
+  await sleep(12_000)
+  const s = await api('GET', `/api/workshop/daq/${nDefault.id}/samples?bucketMs=1000&from=${Date.now() - 13_000}`, { token })
+  const cnt = (s.data?.points ?? [])
+    .reduce((a, p) => a + Number(p.cnt ?? 1), 0)
+  check('C7.1', '恢复默认 5s 节拍:13s 窗口样本 ≈2-4(非 2000 档 ≥5)', cnt <= 5, `cnt=${cnt}`)
+
+  // ── 清理 ──
+  await api('POST', `/api/workshop/dcw/lines/${line.id}/stop`, { token }).catch(() => {})
+  for (const n of [nLow, nDefault]) await api('DELETE', `/api/workshop/daq/${n.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/${dw.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/lines/${line.id}`, { token }).catch(() => {})
+  // 配置归位
+  await api('PATCH', '/api/system/settings', { body: { 'daq.sampling.defaultIntervalMs': 5000, 'daq.sampling.minIntervalMs': 1000, 'daq.query.defaultBucketMs': 15000, 'daq.query.minBucketMs': 1000 }, token: adminToken }).catch(() => {})
+
+  console.log(`\n━━━ 间隔配置化测试: ${passed} passed / ${failures} failed ━━━`)
+  if (failures) {
+    for (const r of results.filter(x => !x.ok)) console.log(`  ${r.id} ${r.name} — ${r.detail}`)
+  }
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('FATAL', err)
+  process.exit(1)
+})

package/scripts/_dbg-interval-scenario.mjs

@@ -0,0 +1,126 @@
+/**
+ * 采样/查询时间间隔 场景测试(真实链路)。
+ *   NO_PROXY='127.0.0.1,localhost' node scripts/_dbg-interval-scenario.mjs [--base http://127.0.0.1:3001]
+ *
+ * 验收:
+ *  S1 节点采样间隔独立可调:同产线 3 节点 intervalMs=1000/5000/7000 → 60s 内样本数呈独立节拍
+ *     (A≈55-60, B≈11-13, C≈8-10);下限 1s(<1000 被钳到 1000)
+ *  S2 samples 查询:缺省 bucketMs → 返回 bucketMs=15000 且点为桶聚合(avg);bucketMs=1000 → 桶更细
+ *  S3 产线 lineQuery(产品/配方/参数/时间/间隔):缺省 → 15s 桶;bucketMs=1000 → 桶数更多
+ */
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3001'
+})()
+const TAG = Date.now().toString(36)
+
+let failures = 0
+let passed = 0
+const results = []
+const check = (id, name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${id} ${name}${detail ? ` — ${detail}` : ''}`)
+  results.push({ id, name, ok, detail })
+  ok ? passed++ : failures++
+}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const api = async (method, path, { body, token } = {}) => {
+  const res = await fetch(`${BASE}${path}`, {
+    method,
+    headers: { 'content-type': 'application/json', ...(token ? { authorization: `Bearer ${token}` } : {}) },
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+
+async function main() {
+  console.log(`\n━━━ 采样/查询间隔 场景测试 @ ${BASE} (tag=${TAG}) ━━━`)
+  const reg = await api('POST', '/api/users/register', { body: { email: `itv-${TAG}@test.local`, password: 'Passw0rd!123', name: `itv-${TAG}` } })
+  const token = reg.data?.token
+  if (!token) throw new Error(`注册失败: ${JSON.stringify(reg).slice(0, 160)}`)
+
+  const line = (await api('POST', '/api/workshop/dcw/lines', { body: { name: `间隔产线-${TAG}` }, token })).data?.line
+  const mk = async (intervalMs) => (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-temp-tc', name: `间隔${intervalMs ?? '默认'}-${TAG}`, driver: 'mock', lineId: line.id, intervalMs, publishIntervalMs: 0 }, token,
+  })).data?.node
+  const nA = await mk(1000)
+  const nB = await mk(5000)
+  const nC = await mk(7000)
+  // 下限钳制:创建时传 250ms → 服务端收敛为 1000
+  const nMin = (await api('POST', '/api/workshop/daq', {
+    body: { templateRef: 'daq-temp-tc', name: `下限钳制-${TAG}`, driver: 'mock', lineId: line.id, intervalMs: 250, publishIntervalMs: 0 }, token,
+  })).data?.node
+  check('S0', '四节点创建(1s/5s/7s/下限钳制)', Boolean(nA?.id && nB?.id && nC?.id && nMin?.id))
+  check('S0.1', '创建下限钳制(250ms → 1000)', nMin?.intervalMs === 1000, `intervalMs=${nMin?.intervalMs}`)
+
+  const dw = (await api('POST', '/api/workshop/dcw', { body: { templateRef: 'dcw-temp-sp', name: `间隔参数-${TAG}`, driver: 'mock', lineId: line.id }, token })).data?.node
+  const prod = (await api('POST', '/api/workshop/dcw/products', { body: { name: `间隔产品-${TAG}`, lineId: line.id }, token })).data?.product
+  const recipe = (await api('POST', '/api/workshop/dcw/recipes', {
+    body: {
+      productId: prod.id, name: `间隔配方-${TAG}`,
+      params: [{ templateRef: 'dcw-temp-sp', nodeId: dw.id, value: 180, min: 150, max: 200 }],
+      daqWindows: [{ nodeId: nA.id, min: 0, max: 260 }],
+    }, token,
+  })).data?.recipe
+  const start = await api('POST', `/api/workshop/dcw/lines/${line.id}/start`, { body: { recipeId: recipe.id }, token })
+  check('S0.2', '产线开跑(门控激活)', start.code === 0, start.message ?? '')
+
+  console.log('  … 60s 采样窗口(三节点独立节拍)…')
+  await sleep(60_000)
+
+  const countOf = async (id) => {
+    const s = await api('GET', `/api/workshop/daq/${id}/samples?bucketMs=1000&from=${Date.now() - 70_000}`, { token })
+    const pts = s.data?.points ?? []
+    return pts.reduce((a, p) => a + Number(p.cnt ?? 1), 0)
+  }
+  const [cA, cB, cC, cMin] = await Promise.all([countOf(nA.id), countOf(nB.id), countOf(nC.id), countOf(nMin.id)])
+  check('S1.1', '1s 节点 60s ≈55-60 样本', cA >= 45 && cA <= 65, `cnt=${cA}`)
+  check('S1.2', '5s 节点 60s ≈11-13 样本', cB >= 9 && cB <= 15, `cnt=${cB}`)
+  check('S1.3', '7s 节点 60s ≈8-10 样本', cC >= 6 && cC <= 12, `cnt=${cC}`)
+  check('S1.4', '三节点节拍独立(A > B > C)', cA > cB && cB > cC, `A=${cA} B=${cB} C=${cC}`)
+  check('S1.5', '钳制节点(250→1000)节拍 = 1s 档', Math.abs(cMin - cA) <= 6, `min=${cMin} A=${cA}`)
+
+  // PATCH 改节拍:运行中把 7s 节点改 1s → 后续样本变密
+  const repatch = await api('PATCH', `/api/workshop/daq/${nC.id}`, { body: { intervalMs: 1000 }, token })
+  check('S1.6', '运行中 PATCH 改节拍(7s→1s)', repatch.code === 0 && repatch.data?.node?.intervalMs === 1000, `intervalMs=${repatch.data?.node?.intervalMs}`)
+  await sleep(8000)
+  const cAfter = await api('GET', `/api/workshop/daq/${nC.id}/samples?bucketMs=1000&from=${Date.now() - 7000}`, { token })
+  const cAfterPts = cAfter.data?.points ?? []
+  const cAfterCnt = cAfterPts.reduce((a, p) => a + Number(p.cnt ?? 1), 0)
+  check('S1.7', '改拍后 7s 窗口样本 ≈7-9(原应≈1)', cAfterCnt >= 6, `cnt=${cAfterCnt}`)
+
+  // S2 samples 查询缺省 bucket
+  const qDefault = await api('GET', `/api/workshop/daq/${nB.id}/samples`, { token })
+  const dpts = qDefault.data?.points ?? []
+  const isBucketShape = dpts.length > 0 && dpts[0].avg !== undefined && dpts[0].cnt !== undefined
+  check('S2.1', 'samples 缺省 → bucketMs=15000(15s 桶聚合)', qDefault.data?.bucketMs === 15000 && isBucketShape, `bucketMs=${qDefault.data?.bucketMs} shape=${isBucketShape} pts=${dpts.length}`)
+  const q1s = await api('GET', `/api/workshop/daq/${nB.id}/samples?bucketMs=1000`, { token })
+  check('S2.2', 'samples bucketMs=1000 → 桶数多于默认', (q1s.data?.points ?? []).length > dpts.length, `1s=${(q1s.data?.points ?? []).length} default=${dpts.length}`)
+  const qLow = await api('GET', `/api/workshop/daq/${nB.id}/samples?bucketMs=300`, { token })
+  check('S2.3', 'samples bucketMs=300 → 钳到 1000', qLow.data?.bucketMs === 1000, `bucketMs=${qLow.data?.bucketMs}`)
+
+  // S3 产线 lineQuery(产线数据查询卡后端)
+  const lqDefault = await api('GET', `/api/workshop/dcw/line/query?lineId=${line.id}&from=${Date.now() - 70_000}`, { token })
+  const lch = lqDefault.data?.channels ?? []
+  const lBucketShape = lch.length > 0 && (lch[0].points?.[0]?.avg !== undefined)
+  check('S3.1', 'lineQuery 缺省 → 15s 桶聚合', lch.length > 0 && lBucketShape, `channels=${lch.length} bucketShape=${lBucketShape}`)
+  const lq1s = await api('GET', `/api/workshop/dcw/line/query?lineId=${line.id}&from=${Date.now() - 70_000}&bucketMs=1000`, { token })
+  const l1ch = (lq1s.data?.channels ?? [])[0]?.points?.length ?? 0
+  const l0ch = lch[0]?.points?.length ?? 0
+  check('S3.2', 'lineQuery bucketMs=1000 → 桶数更多', l1ch > l0ch, `1s=${l1ch} default=${l0ch}`)
+  const lqLow = await api('GET', `/api/workshop/dcw/line/query?lineId=${line.id}&bucketMs=500`, { token })
+  // 无法直接看生效值;用 1s 桶点数一致性间接验证(钳到 1000 → 与 bucketMs=1000 相同桶数)
+  const lLowCh = (lqLow.data?.channels ?? [])[0]?.points?.length ?? 0
+  check('S3.3', 'lineQuery bucketMs=500 → 钳到 1000(桶数与 1s 一致)', lLowCh === l1ch, `500→${lLowCh} vs 1000=${l1ch}`)
+
+  // 清理
+  await api('POST', `/api/workshop/dcw/lines/${line.id}/stop`, { token }).catch(() => {})
+  for (const n of [nA, nB, nC, nMin]) await api('DELETE', `/api/workshop/daq/${n.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/${dw.id}`, { token }).catch(() => {})
+  await api('DELETE', `/api/workshop/dcw/lines/${line.id}`, { token }).catch(() => {})
+
+  console.log(`\n━━━ 间隔场景测试结果: ${passed} passed / ${failures} failed ━━━`)
+  if (failures) for (const r of results.filter(x => !x.ok)) console.log(`  ${r.id} ${r.name} — ${r.detail}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => { console.error('FATAL', err); process.exit(1) })

package/scripts/_dbg-line-spawn.ts

@@ -0,0 +1,31 @@
+/**
+ * line-spawn 聚焦探针:验证 codex(.cmd shim)经受控包装拉起并可 stdio 通信。
+ * 运行:npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/_dbg-line-spawn.ts
+ */
+import { spawnLineProcess } from '../server/services/workshop/agents/adapters/line-spawn'
+
+async function main(): Promise<void> {
+  console.log('── spawn codex --version(.cmd shim 经 cmd.exe 包装)──')
+  const child = spawnLineProcess('codex', ['--version'], {})
+  let out = ''
+  child.stdout?.setEncoding('utf-8')
+  child.stdout?.on('data', (d: string) => {
+    out += d
+  })
+  const code = await new Promise<number | null>((resolve) => {
+    child.on('exit', c => resolve(c))
+    child.on('error', (e) => {
+      console.log('spawn error:', e.message)
+      resolve(-1)
+    })
+  })
+  console.log('exit=', code, 'stdout=', out.trim())
+  if (code !== 0 || !out.includes('codex')) {
+    console.log('FAIL')
+    process.exit(1)
+  }
+  console.log('PASS')
+  process.exit(0)
+}
+
+void main()

package/scripts/_dbg-live-engine-probe.mjs

@@ -0,0 +1,80 @@
+/**
+ * 最小实时探针:单 worker(harness 可选)+ mock lead,注入 requireReply 消息,
+ * 全量拉取 AEP 事件(含 error/delta/status),观察引擎回合的真实行为。
+ * 运行:node scripts/_dbg-live-engine-probe.mjs codex|dsh|omp
+ */
+const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3000'
+const harness = process.argv[2] ?? 'dsh'
+
+const reg = await fetch(`${BASE}/api/workshop/users/register`, {
+  method: 'POST', headers: { 'content-type': 'application/json' },
+  body: JSON.stringify({ name: `probe-${harness}-${Date.now() % 100000}` }),
+}).then(r => r.json())
+const T = reg?.data?.token
+if (!T) { console.error('注册失败'); process.exit(1) }
+const api = async (method, path, body) => {
+  const res = await fetch(`${BASE}${path}`, {
+    method, headers: { 'content-type': 'application/json', authorization: `Bearer ${T}` },
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  })
+  return await res.json().catch(() => ({}))
+}
+
+const ch = await api('POST', '/api/workshop/channels', { name: `probe-${harness}`, leadAgent: { name: 'lead', harness: 'mock' } })
+const cid = ch?.data?.channelId
+const w = await api('POST', `/api/workshop/channels/${cid}/agents`, {
+  name: `w-${harness}`, harness, role: 'worker',
+  config: harness === 'codex' ? { approvalPolicy: 'on-request', sandbox: 'workspace-write' } : {},
+})
+console.log(`channel=${cid} worker=${w?.data?.id} harness=${harness}`)
+
+// 事件录制流由首个 WS 订阅触发(无订阅者不落库),故先接 WS 再触发事件
+const { createRequire } = await import('node:module')
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const { WebSocket } = createRequire(import.meta.url)('D:/codes/ABO/AgentWorkShop/node_modules/.pnpm/ws@8.21.3/node_modules/ws')
+const ws = new WebSocket(BASE.replace(/^http/, 'ws') + '/api/workshop/ws')
+ws.on('open', () => ws.send(JSON.stringify({ type: 'sub', channelId: cid, token: T })))
+ws.on('error', (e) => console.log('[ws error]', e.message))
+await sleep(1200)
+
+const seen = []
+let lastSeq = 0
+const poll = async () => {
+  const res = await api('GET', `/api/workshop/channels/${cid}/events?limit=500`)
+  for (const f of (res?.data?.items ?? [])) {
+    if (Number(f.seq ?? 0) > lastSeq) {
+      lastSeq = Number(f.seq)
+      seen.push(f)
+      const p = f.payload ?? {}
+      if (f.type === 'error') console.log(`[evt] ERROR ${p.code}: ${String(p.message ?? '').slice(0, 200)}`)
+      else if (f.type === 'a2a.message') console.log(`[evt] message ${(p.parts ?? []).map(x => x.text ?? '').join('').slice(0, 120)}`)
+      else if (f.type === 'agent.status.message') console.log(`[evt] status: ${String(p.text ?? '').slice(0, 140)}`)
+      else if (f.type === 'agent.delta') process.stdout.write('.')
+      else if (f.type === 'a2a.artifact') console.log(`[evt] artifact: ${(p.artifact?.parts ?? []).map(x => x.text ?? '').join('').slice(0, 260)}`)
+      else if (f.type === 'task.status') console.log(`[evt] task ${p.state}`)
+      else if (f.type === 'hitl.request') console.log(`[evt] HITL ${p.kind}`)
+    }
+  }
+}
+const poller = setInterval(() => { void poll().catch(() => {}) }, 1500)
+
+const m = await api('POST', `/api/workshop/channels/${cid}/messages`, {
+  toAgentId: w?.data?.id, fromLabel: '探针员', requireReply: true,
+  text: `兼容性检查:请用一句话说明你的引擎(${harness}),然后原样回复"${harness} 在线"。`,
+})
+console.log('message sent:', m.status, m?.data?.messageId?.slice(0, 8))
+
+const deadline = Date.now() + 300_000
+let replied = false
+while (Date.now() < deadline) {
+  await new Promise(r => setTimeout(r, 2000))
+  await poll()
+  replied = seen.some(f => f.type === 'a2a.message' && f.payload?.metadata?.['x-aw-in-reply-to'] === m?.data?.messageId)
+  if (replied) break
+}
+clearInterval(poller)
+console.log(replied ? '\n=== 回执已收到 ===' : '\n=== 300s 未收到回执 ===')
+const byType = {}
+for (const f of seen) byType[f.type] = (byType[f.type] ?? 0) + 1
+console.log('帧分布:', JSON.stringify(byType))
+process.exit(0)

package/scripts/_dbg-mcp-bridge-probe.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+/**
+ * MCP 桥探针:验证 aw-mcp-bridge.mjs 的 MCP stdio ↔ HTTP 回程转译(不依赖真实引擎)。
+ * 运行:node scripts/_dbg-mcp-bridge-probe.mjs
+ */
+import { spawn } from 'node:child_process'
+import { createServer } from 'node:http'
+import { createInterface } from 'node:readline'
+import { randomUUID } from 'node:crypto'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const BRIDGE = join(ROOT, 'server', 'harness', 'aw-mcp-bridge.mjs')
+const AGENT_ID = `a-${randomUUID().slice(0, 8)}`
+const TOKEN = `t-${randomUUID()}`
+
+let failures = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const seen = { listToken: null, invokeToken: null, invokeBody: null }
+
+/** HTTP stub:模拟平台 agent-tools 面 */
+const server = createServer((req, res) => {
+  const token = req.headers['x-aw-agent-token']
+  if (req.method === 'GET' && req.url?.startsWith('/api/workshop/agent-tools/list')) {
+    seen.listToken = token
+    if (token !== TOKEN) {
+      res.writeHead(401, { 'content-type': 'application/json' })
+      res.end(JSON.stringify({ code: 401, message: 'bad token' }))
+      return
+    }
+    res.writeHead(200, { 'content-type': 'application/json' })
+    res.end(JSON.stringify({
+      code: 0,
+      data: {
+        tools: [
+          { name: 'report_progress', description: 'Report progress', parameters: { type: 'object', properties: { progress: { type: 'number' } }, required: ['progress'] } },
+          { name: 'probe_tool', description: 'Probe tool', parameters: { type: 'object', properties: { q: { type: 'string' } } } },
+        ],
+      },
+    }))
+    return
+  }
+  if (req.method === 'POST' && req.url?.startsWith('/api/workshop/agent-tools/invoke')) {
+    seen.invokeToken = token
+    let body = ''
+    req.on('data', (d) => { body += d })
+    req.on('end', () => {
+      seen.invokeBody = JSON.parse(body || '{}')
+      if (token !== TOKEN) {
+        res.writeHead(401, { 'content-type': 'application/json' })
+        res.end(JSON.stringify({ code: 401, message: 'bad token' }))
+        return
+      }
+      const tool = seen.invokeBody.tool
+      res.writeHead(200, { 'content-type': 'application/json' })
+      if (tool === 'boom') {
+        res.end(JSON.stringify({ code: 0, data: { result: { text: '模拟工具失败', isError: true } } }))
+      }
+      else {
+        res.end(JSON.stringify({ code: 0, data: { result: { text: `OK ${tool} q=${seen.invokeBody.args?.q ?? ''}` } } }))
+      }
+    })
+    return
+  }
+  res.writeHead(404)
+  res.end()
+})
+
+await new Promise((resolve) => { server.listen(0, '127.0.0.1', resolve) })
+const port = server.address().port
+
+function rpc(child, msg, timeoutMs = 10_000) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`RPC 超时: ${msg.method ?? msg.id}`)), timeoutMs)
+    const rl = child.rl
+    const onLine = (line) => {
+      try {
+        const frame = JSON.parse(line)
+        if (frame.id === msg.id) {
+          clearTimeout(timer)
+          rl.removeListener('line', onLine)
+          resolve(frame)
+        }
+      }
+      catch { /* 忽略非 JSON 行 */ }
+    }
+    rl.on('line', onLine)
+    child.stdin.write(JSON.stringify(msg) + '\n')
+  })
+}
+
+console.log('━━━ MCP 桥探针(aw-mcp-bridge.mjs)━━━')
+try {
+  const proc = spawn(process.execPath, [BRIDGE], {
+    env: { ...process.env, AW_BASE_URL: `http://127.0.0.1:${port}`, AW_AGENT_ID: AGENT_ID, AW_AGENT_TOKEN: TOKEN },
+    stdio: ['pipe', 'pipe', 'pipe'],
+  })
+  proc.rl = createInterface({ input: proc.stdout })
+  let stderr = ''
+  proc.stderr.on('data', (d) => { stderr += d })
+
+  // 1. initialize
+  const init = await rpc(proc, { jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2024-11-05' } })
+  check('initialize 握手', init.result?.serverInfo?.name === 'aw-host-tools', `serverInfo=${JSON.stringify(init.result?.serverInfo)}`)
+
+  // 2. tools/list(验证 token 头与工具面透传)
+  const list = await rpc(proc, { jsonrpc: '2.0', id: 2, method: 'tools/list' })
+  const names = (list.result?.tools ?? []).map(t => t.name)
+  check('tools/list 携带 agent token', seen.listToken === TOKEN)
+  check('tools/list 透传平台工具面', names.includes('report_progress') && names.includes('probe_tool'), `names=${names.join(',')}`)
+  const probe = (list.result?.tools ?? []).find(t => t.name === 'probe_tool')
+  check('inputSchema = parameters', JSON.stringify(probe?.inputSchema ?? {}).includes('q'))
+
+  // 3. tools/call 成功路径
+  const call = await rpc(proc, { jsonrpc: '2.0', id: 3, method: 'tools/call', params: { name: 'probe_tool', arguments: { q: 'hello' } } })
+  check('tools/call 回程 HTTP', seen.invokeBody?.tool === 'probe_tool' && seen.invokeBody?.agentId === AGENT_ID)
+  check('tools/call 结果转译', call.result?.content?.[0]?.text === 'OK probe_tool q=hello', `text=${call.result?.content?.[0]?.text}`)
+  check('tools/call 携带 agent token', seen.invokeToken === TOKEN)
+
+  // 4. isError 透传
+  const boom = await rpc(proc, { jsonrpc: '2.0', id: 4, method: 'tools/call', params: { name: 'boom', arguments: {} } })
+  check('isError 透传', boom.result?.isError === true, `text=${boom.result?.content?.[0]?.text}`)
+
+  proc.kill('SIGKILL')
+}
+catch (err) {
+  check('桥进程往返', false, err.message)
+}
+
+// 5. 缺 token → 桥拒绝启动
+const bad = spawn(process.execPath, [BRIDGE], {
+  env: { ...process.env, AW_BASE_URL: `http://127.0.0.1:${port}`, AW_AGENT_ID: '', AW_AGENT_TOKEN: '' },
+  stdio: ['pipe', 'pipe', 'pipe'],
+})
+let badStderr = ''
+bad.stderr.on('data', (d) => { badStderr += d })
+const badExit = await new Promise((resolve) => { bad.on('exit', (code) => resolve(code)) })
+check('缺 AW_AGENT_ID 拒绝启动', badExit === 1, `exit=${badExit} stderr=${badStderr.trim().slice(0, 80)}`)
+
+server.close()
+console.log(failures === 0 ? '\n━━━ 全部通过 ━━━' : `\n━━━ ${failures} 项失败 ━━━`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/_dbg-opencode-sse.mjs

@@ -0,0 +1,101 @@
+/**
+ * opencode serve SSE 裸探针:复现 impl 的调用形状,原样打印事件流。
+ * 运行:node scripts/_dbg-opencode-sse.mjs
+ */
+import { spawn } from 'node:child_process'
+import { randomUUID } from 'node:crypto'
+import { mkdtempSync, copyFileSync, mkdirSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { homedir, tmpdir } from 'node:os'
+
+const dataDir = mkdtempSync(join(tmpdir(), 'aw-oc-data-'))
+const configDir = mkdtempSync(join(tmpdir(), 'aw-oc-cfg-'))
+mkdirSync(join(dataDir, 'opencode'), { recursive: true })
+try { copyFileSync(join(homedir(), '.local', 'share', 'opencode', 'auth.json'), join(dataDir, 'opencode', 'auth.json')) } catch (e) { console.log('auth copy fail', e.message) }
+console.log('dataDir=', dataDir)
+
+const port = 20000 + Math.floor(Math.random() * 20000)
+const pw = randomUUID()
+const child = spawn('opencode', ['serve', '--port', String(port), '--hostname', '127.0.0.1'], {
+  env: { ...process.env, OPENCODE_SERVER_PASSWORD: pw, XDG_DATA_HOME: dataDir, XDG_CONFIG_HOME: configDir },
+  stdio: ['ignore', 'pipe', 'pipe'], shell: false,
+})
+child.stderr.on('data', (d) => process.stderr.write('[err] ' + d))
+
+const auth = { headers: { authorization: `Basic ${Buffer.from(`opencode:${pw}`).toString('base64')}`, 'content-type': 'application/json' } }
+
+setTimeout(async () => {
+  // 健康探测
+  let healthy = false
+  for (let i = 0; i < 60; i++) {
+    try {
+      const r = await fetch(`http://127.0.0.1:${port}/global/health`, { headers: { authorization: auth.headers.authorization }, signal: AbortSignal.timeout(2000) })
+      if (r.ok) { healthy = true; break }
+    }
+    catch {}
+    await new Promise(r => setTimeout(r, 500))
+  }
+  console.log('healthy=', healthy)
+  if (!healthy) process.exit(1)
+
+  // MCP 桥注册(与 impl 同形状)
+  const bridge = process.env.AW_BRIDGE_PATH ?? join(process.cwd(), 'server', 'harness', 'aw-mcp-bridge.mjs')
+  const mcpRes = await fetch(`http://127.0.0.1:${port}/mcp`, { ...auth, method: 'POST', body: JSON.stringify({
+    name: 'aw-host-tools',
+    config: { type: 'local', command: [process.execPath, bridge], environment: { AW_BASE_URL: 'http://127.0.0.1:1', AW_AGENT_ID: 'x', AW_AGENT_TOKEN: 'y' } },
+  }) })
+  console.log('mcp register:', mcpRes.status, (await mcpRes.text()).slice(0, 120))
+
+  // 建会话(带权限规则)
+  const sesRes = await fetch(`http://127.0.0.1:${port}/session`, { ...auth, method: 'POST', body: JSON.stringify({
+    title: 'probe',
+    permission: [{ permission: 'edit', action: 'ask' }, { permission: 'bash', pattern: '*', action: 'ask' }],
+  }) })
+  const ses = await sesRes.json()
+  console.log('session:', sesRes.status, JSON.stringify(ses).slice(0, 200))
+  const sid = ses.id
+
+  // 事件流
+  const es = await fetch(`http://127.0.0.1:${port}/event`, { headers: auth.headers })
+  const reader = es.body.getReader()
+  const dec = new TextDecoder()
+  let buf = ''
+  const events = []
+  ;(async () => {
+    for (;;) {
+      const { done, value } = await reader.read()
+      if (done) break
+      buf += dec.decode(value, { stream: true })
+      const parts = buf.split('\n\n'); buf = parts.pop()
+      for (const chunk of parts) for (const line of chunk.split('\n')) {
+        if (!line.startsWith('data:')) continue
+        try { events.push(JSON.parse(line.slice(5))) } catch {}
+      }
+    }
+  })()
+
+  // 投递
+  const pr = await fetch(`http://127.0.0.1:${port}/session/${sid}/prompt_async`, { ...auth, method: 'POST', body: JSON.stringify({
+    model: { providerID: 'zhipuai-coding-plan', modelID: 'glm-5.3-flash' },
+    parts: [{ type: 'text', text: 'Reply with exactly: OK' }],
+  }) })
+  console.log('prompt_async:', pr.status)
+
+  const deadline = Date.now() + 90_000
+  while (Date.now() < deadline) {
+    await new Promise(r => setTimeout(r, 1500))
+    const err = events.find(e => e.type === 'session.error')
+    const idle = events.find(e => e.type === 'session.idle')
+    if (err || idle) break
+  }
+  console.log('--- events (deduped by type) ---')
+  const seen = new Map()
+  for (const e of events) {
+    const key = e.type + ':' + (e.properties?.part?.type ?? '')
+    if (!seen.has(key)) { seen.set(key, 1); console.log(e.type, JSON.stringify(e.properties ?? {}).slice(0, 260)) }
+    else seen.set(key, seen.get(key) + 1)
+  }
+  for (const [k, n] of seen) if (n > 1) console.log(`(${k} x${n})`)
+  child.kill('SIGKILL')
+  process.exit(0)
+}, 3000)