agentworkshop 0.2.1

package/scripts/e2e-omp-realtime.ts

@@ -0,0 +1,258 @@
+/// <reference types="node" />
+
+/**
+ * 真实 omp harness 实时通信端到端:
+ *  A. 独立进程验证:每个 agent 一个 omp 子进程,PID 互不相同
+ *  B. worker↔lead 触发对话:worker 执行任务中(busy)收到 lead 的 immediate+requireReply 消息
+ *     → steer 注入运行中会话 → worker 以真实 LLM 回执(in_reply_to 关联,内容含所需信息)
+ *  C. lead 响应 worker 消息:空闲 lead 收到 worker 消息 → peerMessageRun 处理并回复
+ *
+ * 运行: npx tsx scripts/e2e-omp-realtime.ts(依赖 PATH 上的 omp 与已配置模型)
+ */
+import type { DatabaseSync } from 'node:sqlite'
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { createChannelRepo } from '../server/services/workshop/db/channel.repo'
+import { createAgentRepo } from '../server/services/workshop/db/agent.repo'
+import { createChannelAgentRepo } from '../server/services/workshop/db/channel-agent.repo'
+import { createTaskRepo } from '../server/services/workshop/db/task.repo'
+import { createMemoryRepo } from '../server/services/workshop/db/memory.repo'
+import { createChannelEventRepo } from '../server/services/workshop/db/channel-event.repo'
+import { createTeamRepo } from '../server/services/workshop/db/team.repo'
+import { createTeamMemberRepo } from '../server/services/workshop/db/team-member.repo'
+import { createMessageRepo } from '../server/services/workshop/db/message.repo'
+import { createSubscriptionRepo } from '../server/services/workshop/db/subscription.repo'
+import { createUserRepo } from '../server/services/workshop/db/user.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'
+
+let failures = 0
+const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
+
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const TIMING = { spawn: 60_000, dialog: 240_000, task: 240_000 }
+
+function makeManager(db: DatabaseSync): AgentChannelManager {
+  return createAgentChannelManager({
+    repos: {
+      channels: createChannelRepo(db),
+      agents: createAgentRepo(db),
+      channelAgents: createChannelAgentRepo(db),
+      messages: createMessageRepo(db),
+      subscriptions: createSubscriptionRepo(db),
+      tasks: createTaskRepo(db),
+      memories: createMemoryRepo(db),
+      users: createUserRepo(db),
+
+      channelEvents: createChannelEventRepo(db),
+      teams: createTeamRepo(db),
+      teamMembers: createTeamMemberRepo(db),
+    },
+    implFactory: createAgentImpl,
+    db,
+  })
+}
+
+/** 内部访问:messages repo(回执断言)+ agentIndex(omp 子进程 PID 验证) */
+interface Internals {
+  deps: { repos: { messages: {
+    listRecentByChannel(channelId: string, limit: number): Array<{ id: string, fromAgentId: string | null, toAgentId: string | null, partsJson: string, metadataJson: string }>
+  } } }
+  agentIndex: Map<string, unknown>
+}
+
+function internalsOf(manager: AgentChannelManager): Internals {
+  return manager as unknown as Internals
+}
+
+interface Msg {
+  id: string
+  from: string | null
+  to: string | null
+  text: string
+  metadata: Record<string, unknown>
+}
+
+function listMessages(manager: AgentChannelManager, channelId: string, limit = 100): Msg[] {
+  return internalsOf(manager).deps.repos.messages.listRecentByChannel(channelId, limit).reverse().map(r => ({
+    id: r.id,
+    from: r.fromAgentId,
+    to: r.toAgentId,
+    text: (JSON.parse(r.partsJson) as Array<{ text?: string }>).map(p => p.text ?? '').join(' '),
+    metadata: JSON.parse(r.metadataJson) as Record<string, unknown>,
+  }))
+}
+
+async function waitForReply(manager: AgentChannelManager, channelId: string, pred: (m: Msg) => boolean, timeoutMs: number): Promise<Msg | null> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    const hit = listMessages(manager, channelId).find(pred)
+    if (hit) return hit
+    await sleep(100)
+  }
+  return listMessages(manager, channelId).find(pred) ?? null
+}
+
+/** 从 AgentRuntime 取其 OmpRpcAgentImpl 的 omp 子进程 PID(duck-typing 内部结构) */
+function ompPidOf(manager: AgentChannelManager, channelId: string, agentId: string): number | null {
+  const runtime = internalsOf(manager).agentIndex.get(`${channelId}\u0000${agentId}`) as unknown as {
+    impl?: { client?: { child?: { pid?: number } } }
+  } | undefined
+  return runtime?.impl?.client?.child?.pid ?? null
+}
+
+async function waitRuntime(manager: AgentChannelManager, agentId: string, timeoutMs: number): Promise<void> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (manager.getChannelAgent(agentId)?.wired) return
+    await sleep(100)
+  }
+}
+
+async function main(): Promise<void> {
+  console.log('━━━ 真实 omp harness:独立进程 + 实时触发对话 ━━━')
+  const db = openWorkshopDb(':memory:')
+  const manager = makeManager(db)
+  try {
+    // 组队:1 lead + 2 workers(全部 omp harness,真实子进程)
+    const ch = await manager.createChannel({
+      name: 'omp-realtime-e2e',
+      leadAgent: { name: 'lead-协调', harness: 'omp', config: { provider: 'zhipu-coding-plan', model: 'glm-5.2' } },
+    })
+    const wA = await manager.createAgent({ name: 'worker-甲', harness: 'omp', config: { provider: 'zhipu-coding-plan', model: 'glm-5.2' } })
+    const wB = await manager.createAgent({ name: 'worker-乙', harness: 'omp', config: { provider: 'zhipu-coding-plan', model: 'glm-5.2' } })
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: wA.id, role: 'worker' })
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: wB.id, role: 'worker' })
+    const members = await manager.listChannelAgents(ch.channelId)
+    const lead = members.find(m => m.role === 'lead')!
+    const workers = members.filter(m => m.role === 'worker')
+
+    // ---- A. 独立进程验证:提交任务触发装配,三个 agent 各起一个 omp 子进程 ----
+    console.log('\n━━━ A. 独立 omp 子进程验证 ━━━')
+    const task = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '环境检查任务',
+      description: 'Use the get_my_task_queue tool to check your task queue, then reply to the lead with a one-line summary using send_message_to_agent (no require_reply needed). Then call complete_task.',
+    })
+    // 等 lead/worker 装配(懒加载由调度触发)
+    for (const m of members) {
+      await waitRuntime(manager, m.id, TIMING.spawn)
+    }
+    // 懒 spawn 时机随 LLM 推进而定:轮询直到至少 2 个成员持有子进程(上限 60s)
+    const spawnDeadline = Date.now() + 60_000
+    let pids = new Map(members.map(m => [m.id, ompPidOf(manager, ch.channelId, m.id)]))
+    while (Date.now() < spawnDeadline && [...pids.values()].filter(p => p !== null).length < 2) {
+      const { promise, resolve } = Promise.withResolvers()
+      setTimeout(resolve, 500)
+      await promise
+      pids = new Map(members.map(m => [m.id, ompPidOf(manager, ch.channelId, m.id)]))
+    }
+    const spawned = members.filter(m => (pids.get(m.id) ?? null) !== null)
+    check('全部成员各自持有 omp 子进程', spawned.length >= 2,
+      `spawned=${spawned.length}/${members.length}(懒加载按需 spawn)`)
+    const distinctPids = [...pids.values()].filter(p => p !== null)
+    check('子进程 PID 互不相同(独立进程隔离)', new Set(distinctPids).size === distinctPids.length,
+      `pids=${distinctPids.join(',')}`)
+
+    // 等任务闭环(真实 LLM,放宽)
+    const engine = (manager as unknown as { getTaskEngine(): { get(id: string): { state: string } | undefined } }).getTaskEngine()
+    const doneAt = Date.now() + TIMING.task
+    while (Date.now() < doneAt && engine.get(task.id)?.state !== 'COMPLETED') {
+      await sleep(500)
+    }
+    check('omp 任务闭环 COMPLETED', engine.get(task.id)?.state === 'COMPLETED',
+      `state=${engine.get(task.id)?.state}`)
+
+    // ---- B. lead ↔ worker-甲 实时触发对话(worker 空闲路径:入队 → peerMessageRun → LLM 回执)----
+    console.log('\n━━━ B. lead→worker 触发对话(真实 LLM 回执)━━━')
+    const m1 = await manager.sendImmediateMessage({
+      channelId: ch.channelId,
+      fromAgentId: lead.id,
+      toAgentId: workers[0].id,
+      parts: [{ text: '请告诉我:2+3 等于几?只需一个数字。' }],
+      requireReply: true,
+    })
+    const r1 = await waitForReply(manager, ch.channelId, x => x.metadata['x-aw-in-reply-to'] === m1.messageId, TIMING.dialog)
+    check('B: worker 真实回执已产生', r1 !== null)
+    if (r1) {
+      check('B: in_reply_to 关联', r1.metadata['x-aw-in-reply-to'] === m1.messageId)
+      check('B: 回复方正确', r1.from === workers[0].id && r1.to === lead.id)
+      check('B: 内容包含答案 5', r1.text.includes('5'), r1.text.slice(0, 80))
+    }
+
+    // ---- C. worker-乙 → lead 触发对话(lead peerMessageRun 路径)----
+    console.log('\n━━━ C. worker→lead 触发对话(lead 响应)━━━')
+    const m2 = await manager.sendImmediateMessage({
+      channelId: ch.channelId,
+      fromAgentId: workers[1].id,
+      toAgentId: lead.id,
+      parts: [{ text: 'lead,我的当前队列里有几个任务?请用数字回答。' }],
+      requireReply: true,
+    })
+    const r2 = await waitForReply(manager, ch.channelId, x => x.metadata['x-aw-in-reply-to'] === m2.messageId, TIMING.dialog)
+    check('C: lead 真实回执已产生', r2 !== null)
+    if (r2) {
+      check('C: in_reply_to 关联', r2.metadata['x-aw-in-reply-to'] === m2.messageId)
+      check('C: 回复方为 lead', r2.from === lead.id && r2.to === workers[1].id)
+      console.log(`  C: lead 回复内容: ${r2.text.slice(0, 120)}`)
+    }
+
+    // ---- D. worker busy 中 steer 注入(worker 执行长任务时 immediate 触发)----
+    console.log('\n━━━ D. worker busy 中 steer 实时注入 ━━━')
+    const longTask = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '长任务:逐步计数',
+      description: 'Slowly count from 1 to 5 in your reasoning, taking your time (a few seconds per step is fine; just think through each number carefully). Then call complete_task with the final count.',
+    })
+    // 等 worker-甲 或 worker-乙 busy(dispatch 后)
+    const busyAt = Date.now() + 30_000
+    let busyId: string | null = null
+    while (Date.now() < busyAt && !busyId) {
+      for (const w of workers) {
+        if (manager.getChannelAgent(w.id)?.runtimeState === 'busy') {
+          busyId = w.id
+          break
+        }
+      }
+      if (!busyId) await sleep(100)
+    }
+    check('D: worker 进入 busy', busyId !== null, busyId ? busyId.slice(0, 8) : 'timeout')
+    if (busyId) {
+      const m3 = await manager.sendImmediateMessage({
+        channelId: ch.channelId,
+        fromAgentId: lead.id,
+        toAgentId: busyId,
+        parts: [{ text: '中途检查:请在你完成当前工作后,告诉我你正在做什么,一句话即可。' }],
+        requireReply: true,
+      })
+      const r3 = await waitForReply(manager, ch.channelId, x => x.metadata['x-aw-in-reply-to'] === m3.messageId, TIMING.dialog)
+      check('D: busy worker 经 steer 注入后回执', r3 !== null)
+      if (r3) {
+        check('D: 回复方正确', r3.from === busyId && r3.to === lead.id)
+        console.log(`  D: worker 回复内容: ${r3.text.slice(0, 120)}`)
+      }
+    }
+
+    const doneAt2 = Date.now() + TIMING.task
+    while (Date.now() < doneAt2 && engine.get(longTask.id)?.state !== 'COMPLETED') {
+      await sleep(500)
+    }
+    check('D: 长任务最终完成', engine.get(longTask.id)?.state === 'COMPLETED',
+      `state=${engine.get(longTask.id)?.state}`)
+  }
+  finally {
+    await manager.shutdown()
+  }
+
+  console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILED`}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('测试异常:', e)
+  process.exit(1)
+})

package/scripts/e2e-omp-workspace.ts

@@ -0,0 +1,180 @@
+/**
+ * 真实 omp harness 场景测试 — tmp 文件夹作为 workspace。
+ *
+ * 场景(简单):
+ *  1. 在 .tmp-omp-e2e/ 建 workspace,放入 input.txt(一段简单内容)
+ *  2. createChannel(workspace=tmp, leadAgent=omp)→ lead 模板 + 克隆实例
+ *  3. createAgent(omp) 模板 → addAgentToChannel 克隆 worker 实例
+ *  4. ensureChannelActive + monitorChannel 挂监控
+ *  5. submitChannelTask:lead 分配,worker 用 omp 原生 read 工具读取 input.txt,回写成果
+ *  6. 监控执行过程(dispatch/working/progress/artifact/completed)
+ *
+ * 运行: npx tsx scripts/e2e-omp-workspace.ts
+ */
+import type { DatabaseSync } from 'node:sqlite'
+import { mkdirSync, writeFileSync, rmSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { createChannelRepo } from '../server/services/workshop/db/channel.repo'
+import { createAgentRepo } from '../server/services/workshop/db/agent.repo'
+import { createChannelAgentRepo } from '../server/services/workshop/db/channel-agent.repo'
+import { createTaskRepo } from '../server/services/workshop/db/task.repo'
+import { createMemoryRepo } from '../server/services/workshop/db/memory.repo'
+import { createChannelEventRepo } from '../server/services/workshop/db/channel-event.repo'
+import { createTeamRepo } from '../server/services/workshop/db/team.repo'
+import { createTeamMemberRepo } from '../server/services/workshop/db/team-member.repo'
+import { createMessageRepo } from '../server/services/workshop/db/message.repo'
+import { createSubscriptionRepo } from '../server/services/workshop/db/subscription.repo'
+import { createAgentChannelManager } from '../server/services/workshop/runtime/manager'
+import type { AgentChannelManager } from '../server/services/workshop/runtime/manager'
+import { createAgentImpl } from '../server/services/workshop/agents/factory'
+import { monitorChannel } from '../server/services/workshop/runtime/monitor'
+
+let failures = 0
+
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+function makeManager(db: DatabaseSync): AgentChannelManager {
+  return createAgentChannelManager({
+    repos: {
+      channels: createChannelRepo(db),
+      agents: createAgentRepo(db),
+      channelAgents: createChannelAgentRepo(db),
+      messages: createMessageRepo(db),
+      subscriptions: createSubscriptionRepo(db),
+      tasks: createTaskRepo(db),
+      memories: createMemoryRepo(db),
+
+      channelEvents: createChannelEventRepo(db),
+      teams: createTeamRepo(db),
+      teamMembers: createTeamMemberRepo(db),
+    },
+    implFactory: createAgentImpl,
+    db,
+  })
+}
+
+const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
+
+async function main(): Promise<void> {
+  console.log('━━━ 真实 omp harness:tmp workspace 任务执行 + 监控 ━━━')
+
+  const ws = resolve(process.cwd(), '.tmp-omp-e2e')
+  mkdirSync(ws, { recursive: true })
+  const payload = '真实场景作业:omp 读取此文件并原样回写成果'
+  writeFileSync(resolve(ws, 'input.txt'), payload, 'utf8')
+
+  const db = openWorkshopDb(':memory:')
+  const manager = makeManager(db)
+  try {
+    // ---- 1. 创建 Channel(tmp workspace + omp lead)----
+    console.log('\n--- 1. 创建 Channel(workspace=tmp)---')
+    const ch = await manager.createChannel({
+      name: 'OMP 真实场景',
+      description: 'tmp workspace 简单作业',
+      workspace: ws,
+      leadAgent: { name: 'lead-主理人', harness: 'omp', config: {} },
+    })
+    check('Channel 创建成功(workspace 生效)', ch.workspace === ws && !!ch.leadAgentId)
+
+    // ---- 2. Agent 模板 → 克隆 worker 实例 ----
+    console.log('\n--- 2. Agent 模板克隆 worker 实例 ---')
+    const workerTpl = await manager.createAgent({ name: 'worker-执行者', harness: 'omp', config: {} })
+    const worker = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: workerTpl.id, role: 'worker' })
+    check('worker 克隆出独立实例 id', worker.id !== workerTpl.id)
+    check('成员结构 1 lead + 1 worker', (await manager.listChannelAgents(ch.channelId)).length === 2)
+
+    // ---- 3. 激活 + 挂监控 ----
+    console.log('\n--- 3. 激活 channel + 挂监控 ---')
+    manager.ensureChannelActive(ch.channelId, { tickMs: 3000, stallMs: 60_000 })
+    const mon = monitorChannel(manager, ch.channelId)
+    check('监控器已启动', mon.events.some(e => e.kind === 'lifecycle'))
+
+    // ---- 4. 提交任务(lead 真实 omp 分配)----
+    console.log('\n--- 4. 提交任务 ---')
+    const task = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '读取并复述 input.txt',
+      description: '读取工作目录里的 input.txt 文件,把内容原样写在任务成果里,然后完成任务。简短回答。',
+    })
+    check('任务已提交(SUBMITTED)', task.state === 'SUBMITTED', `state=${task.state}`)
+    console.log(`  task=${task.id.slice(0, 8)}…`)
+
+    // ---- 5. 监控执行(定向等待主任务 COMPLETED;omp 真实推理,给足时间)----
+    console.log('\n--- 5. 监控执行过程(真实 omp)---')
+    const started = Date.now()
+    const done = await mon.waitFor(e => e.kind === 'task.status' && e.taskId === task.id && e.state === 'COMPLETED', 240_000)
+    const elapsed = ((Date.now() - started) / 1000).toFixed(1)
+    console.log(`  ⏱  耗时 ${elapsed}s`)
+    check('主任务执行完成(COMPLETED)', done !== null)
+
+    const seenAssigned = mon.events.some(e => e.kind === 'task.status' && e.state === 'ASSIGNED')
+    const seenWorking = mon.events.some(e => e.kind === 'task.status' && e.state === 'WORKING')
+    const seenProgress = mon.events.some(e => e.kind === 'task.progress' && e.progress > 0)
+    const seenArtifact = mon.events.some(e => e.kind === 'agent.event' && e.event.kind === 'artifact')
+    const seenBusy = mon.events.some(e => e.kind === 'agent.status' && e.state === 'busy')
+    const seenIdle = mon.events.some(e => e.kind === 'agent.status' && e.state === 'idle')
+    check('监控到任务进入 WORKING', seenWorking)
+    check('监控到进度上报', seenProgress)
+    check('监控到成员 busy → idle', seenBusy && seenIdle)
+    if (!seenAssigned) console.log('  信息:未捕获 ASSIGNED 事件(omp host tool 分发路径可能跳过显式 ASSIGNED 状态事件)')
+    if (!seenArtifact) console.log('  信息:未捕获 artifact 事件(成果可能直接落入任务 artifacts,不经过 agent.event)')
+
+    // ---- 6. 终态校验(成果包含 payload)----
+    const engine = (manager as unknown as {
+      getTaskEngine(): { list(channelId: string): Array<{ id: string, parentId: string | null, state: string, artifacts: Array<{ parts: Array<{ text?: string }> }> }> }
+    }).getTaskEngine()
+    const allTasks = engine.list(ch.channelId)
+    const children = allTasks.filter(t => t.parentId === task.id)
+    const finalTask = allTasks.find(t => t.id === task.id)
+    const artifactTexts = (finalTask?.artifacts ?? []).flatMap(a => a.parts.filter(p => 'text' in p).map(p => (p as { text: string }).text)).join('\n')
+    const childTexts = children.flatMap(c => c.artifacts.flatMap(a => a.parts.filter(p => 'text' in p).map(p => (p as { text: string }).text))).join('\n')
+    check('lead 分配了子任务', children.length >= 1, `子任务=${children.length}`)
+    check('主任务 COMPLETED + 有成果', finalTask?.state === 'COMPLETED' && (finalTask?.artifacts.length ?? 0) > 0, `state=${finalTask?.state} artifacts=${finalTask?.artifacts.length}`)
+    check('成果包含 input.txt 内容(主任务或子任务)', artifactTexts.includes(payload) || childTexts.includes(payload), `parent=${artifactTexts.slice(0, 50)}… | child=${childTexts.slice(0, 50)}…`)
+
+    // ---- 7. 监控时间线 ----
+    console.log('\n--- 监控时间线 ---')
+    console.log(mon.summary())
+    mon.stop()
+
+    // ---- 8. 释放 omp 子进程 ----
+    console.log('\n--- 收尾:卸载 omp 子进程 ---')
+    for (let i = 0; i < 20; i++) {
+      await manager.unloadIdleAgents()
+      if (manager.runtimeStatus().wiredAgents.length === 0) break
+      await sleep(500)
+    }
+    check('完成后卸载(释放 omp 子进程)', manager.runtimeStatus().wiredAgents.length === 0)
+  }
+  finally {
+    await manager.shutdown()
+    db.close()
+    // Windows 收尾竞态:omp 子进程(含终端镜像)可能仍持有 cwd 目录句柄,
+    // 立即 rmSync 会 EPERM —— 带宽限重试,仍失败则告警保留(不掩盖功能断言结果)。
+    for (let attempt = 0; attempt < 5; attempt++) {
+      try {
+        rmSync(ws, { recursive: true, force: true })
+        break
+      }
+      catch {
+        if (attempt === 4) {
+          console.warn(`[e2e-omp-workspace] 临时工作区清理失败(Windows 句柄占用),已保留: ${ws}`)
+          break
+        }
+        await sleep(500)
+      }
+    }
+  }
+
+  console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILED`}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('e2e 异常:', e)
+  process.exit(1)
+})

package/scripts/e2e-parallel-execution.mjs

@@ -0,0 +1,151 @@
+/**
+ * 并行执行机制验证(mock harness,零 token):
+ *  - 一个编组模板(1 lead + 2 worker,mock delayMs=2000 → 单子任务约 6s 可观测窗口)
+ *  - 部署到 2 个 channel;每个 channel 同时提交 2 个任务
+ *  - 250ms 采样任务状态,断言三层并行:
+ *      L1 跨 channel:同一采样轮 A、B 都有子任务 WORKING
+ *      L2 同 channel 内:同一采样轮同 channel 有 ≥2 个子任务 WORKING(两个 worker 并发)
+ *      L3 墙钟:总耗时 << 串行下界(8 个子任务 × 6s)
+ *  - 断言全部任务 COMPLETED,且交付物只出现本 channel 自己成员的 id(不串 channel)
+ *
+ * 用法: node scripts/e2e-parallel-execution.mjs
+ */
+const BASE = 'http://localhost:3000'
+const DELAY_MS = 2000 // mock worker 每段进度间隔 → 单任务 ≈ 3×DELAY_MS
+const TASK_SECONDS = (DELAY_MS * 3) / 1000
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const H = token => ({ 'content-type': 'application/json', 'authorization': `Bearer ${token}` })
+const post = async (url, body, token) => {
+  const res = await fetch(`${BASE}${url}`, { method: 'POST', headers: H(token), body: JSON.stringify(body) })
+  const json = await res.json()
+  if (json.code !== 0) throw new Error(`${url} -> ${json.code} ${json.message}`)
+  return json.data
+}
+const get = async (url, token) => {
+  const res = await fetch(`${BASE}${url}`, { headers: { authorization: `Bearer ${token}` } })
+  const json = await res.json()
+  if (json.code !== 0) throw new Error(`${url} -> ${json.code} ${json.message}`)
+  return json.data
+}
+
+const t0 = Date.now()
+const el = () => ((Date.now() - t0) / 1000).toFixed(1).padStart(5)
+const log = m => console.log(`[${el()}s] ${m}`)
+let failures = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? '✅' : '❌'} ${name}${detail ? ` - ${detail}` : ''}`)
+  if (!ok) failures++
+}
+
+async function main() {
+  // 1. 用户 + 模板 + 编组(1 lead + 2 worker,全 mock)
+  const user = await post('/api/workshop/users/register', { name: `par-mock-${Date.now()}` })
+  const T = user.token
+  const mk = (name, extra = {}) => post('/api/workshop/agents', { name, harness: 'mock', config: { delayMs: DELAY_MS, ...extra } }, T)
+  const leadTpl = await mk('par-lead')
+  const w1Tpl = await mk('par-w1')
+  const w2Tpl = await mk('par-w2')
+  const team = await post('/api/workshop/teams', { name: '并行验证组(mock)' }, T)
+  await post(`/api/workshop/teams/${team.id}/members`, { agentId: leadTpl.id, role: 'lead' }, T)
+  await post(`/api/workshop/teams/${team.id}/members`, { agentId: w1Tpl.id, role: 'worker' }, T)
+  await post(`/api/workshop/teams/${team.id}/members`, { agentId: w2Tpl.id, role: 'worker' }, T)
+  log('编组模板就绪(1 lead + 2 worker,mock)')
+
+  // 2. 两个 channel + 部署同一编组
+  const mkCh = async (label) => {
+    const ch = await post('/api/workshop/channels', { name: `par-${label}` }, T)
+    await post(`/api/workshop/teams/${team.id}/deploy`, { channelId: ch.channelId }, T)
+    const members = await get(`/api/workshop/channels/${ch.channelId}/agents`, T)
+    return { ...ch, label, members }
+  }
+  const chA = await mkCh('A')
+  const chB = await mkCh('B')
+  log(`双 channel 部署完成: A=${chA.channelId.slice(0, 8)}(${chA.members.length} 成员) B=${chB.channelId.slice(0, 8)}(${chB.members.length} 成员)`)
+
+  // 3. 每 channel 同时提交 2 个任务(共 4 个父任务 → 4 个子任务;每 channel 两个 worker 可并发)
+  const submits = []
+  for (const ch of [chA, chB]) {
+    for (const n of [1, 2]) {
+      submits.push(post(`/api/workshop/channels/${ch.channelId}/tasks`, {
+        title: `${ch.label}-任务${n}`,
+        description: `固定场景:mock 剧本执行(${ch.label}-${n})`,
+      }, T).then(t => ({ ch, id: t.id })))
+    }
+  }
+  const submitted = await Promise.all(submits)
+  log(`同时提交 ${submitted.length} 个任务: ` + submitted.map(s => `${s.ch.label}/${s.id.slice(0, 6)}`).join(' '))
+
+  // 4. 采样(250ms):统计每轮各 channel 处于 WORKING 的子任务数
+  const rounds = []
+  const deadline = Date.now() + 120_000
+  let allDone = false
+  while (Date.now() < deadline && !allDone) {
+    const [a, b] = await Promise.all([
+      get(`/api/workshop/channels/${chA.channelId}/tasks`, T),
+      get(`/api/workshop/channels/${chB.channelId}/tasks`, T),
+    ])
+    const workingKids = list => list.filter(t => t.parentId && t.state === 'WORKING').length
+    rounds.push({ at: Date.now() - t0, a: workingKids(a), b: workingKids(b) })
+    const terminal = list => list.length > 0 && list.every(t => ['COMPLETED', 'FAILED', 'CANCELED'].includes(t.state))
+    allDone = terminal(a) && terminal(b) && a.some(t => t.parentId) && b.some(t => t.parentId)
+    if (!allDone) await sleep(250)
+  }
+  const wall = (Date.now() - t0) / 1000
+  log(`两 channel 全部任务终态,墙钟 ${wall.toFixed(1)}s`)
+
+  // 5. 结果
+  const [tasksA, tasksB] = await Promise.all([
+    get(`/api/workshop/channels/${chA.channelId}/tasks`, T),
+    get(`/api/workshop/channels/${chB.channelId}/tasks`, T),
+  ])
+  const full = async list => Promise.all(list.map(t => get('/api/workshop/tasks/' + t.id, T)))
+  const fullA = await full(tasksA)
+  const fullB = await full(tasksB)
+
+  console.log('\n—— 任务树 ——')
+  for (const [k, list] of [['A', fullA], ['B', fullB]]) {
+    for (const t of list) console.log(`  ${k} ${t.id.slice(0, 6)} parent=${(t.parentId ?? '----').slice(0, 6)} ${t.state.padEnd(9)} assignee=${t.assigneeId.slice(0, 6)} "${t.title}"`)
+  }
+
+  // 采样轮压缩打印(只打印有活动的轮次)
+  console.log('\n—— 并发采样(A/B 同时 WORKING 的子任务数) ——')
+  const active = rounds.filter(r => r.a || r.b)
+  console.log('  ' + active.map(r => `${(r.at / 1000).toFixed(1)}s:${r.a}/${r.b}`).join('  '))
+
+  console.log('\n—— 断言 ——')
+  const states = list => list.map(t => t.state)
+  check('A 全部任务 COMPLETED', states(fullA).every(s => s === 'COMPLETED'), states(fullA).join(','))
+  check('B 全部任务 COMPLETED', states(fullB).every(s => s === 'COMPLETED'), states(fullB).join(','))
+  check('A 产生 2 父 + 2 子任务', fullA.length === 4 && fullA.filter(t => t.parentId).length === 2, `${fullA.length} 个`)
+  check('B 产生 2 父 + 2 子任务', fullB.length === 4 && fullB.filter(t => t.parentId).length === 2, `${fullB.length} 个`)
+
+  // L1 跨 channel 并行
+  const crossRounds = rounds.filter(r => r.a > 0 && r.b > 0)
+  check('L1 跨 channel 并行(同一采样轮 A、B 均在执行)', crossRounds.length > 0, `${crossRounds.length} 轮`)
+  // L2 同 channel 内多 worker 并行
+  const intraA = rounds.filter(r => r.a >= 2).length
+  const intraB = rounds.filter(r => r.b >= 2).length
+  check('L2 同 channel 内两 worker 并行', intraA > 0 && intraB > 0, `A ${intraA} 轮 / B ${intraB} 轮`)
+  // L3 墙钟远小于串行下界
+  const serialLower = 4 * TASK_SECONDS
+  check(`L3 墙钟 << 串行下界(${serialLower}s)`, wall < serialLower * 0.75, `实测 ${wall.toFixed(1)}s`)
+  // 峰值并发
+  const peak = Math.max(...rounds.map(r => r.a + r.b))
+  check('峰值并发子任务数 ≥ 3', peak >= 3, `峰值 ${peak}`)
+
+  // 隔离:各 channel 交付物只含自己成员 id
+  const idsOf = ch => new Set(ch.members.map(m => m.agentId))
+  const textOf = list => list.flatMap(t => (t.artifacts ?? []).flatMap(a => a.parts ?? []).map(p => p.text ?? '')).join(' ')
+  const foreign = (list, ownIds, otherCh) => [...idsOf(otherCh)].filter(id => textOf(list).includes(id))
+  check('A 交付物不含 B 成员 id(channel 隔离)', foreign(fullA, idsOf(chA), chB).length === 0, foreign(fullA, idsOf(chA), chB).join(','))
+  check('B 交付物不含 A 成员 id(channel 隔离)', foreign(fullB, idsOf(chB), chA).length === 0, foreign(fullB, idsOf(chB), chA).join(','))
+
+  console.log(failures === 0 ? '\n全部通过 🎉' : `\n${failures} 项失败`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('测试异常:', e)
+  process.exit(1)
+})