agentworkshop 0.2.1

package/scripts/demo-lead-worker.ts

@@ -0,0 +1,256 @@
+/**
+ * Lead-Worker 实战演示 — mock harness 全流程
+ *
+ * 场景: lead 统筹一个"系统功能开发"任务,分解为 2 个子任务分发给 worker,
+ *       worker 各自接取执行,lead 通过 monitor 实时监控团队作业情况。
+ *
+ * 流程:
+ *  1. 创建 Channel(lead + 2 workers, harness=mock, delayMs=200 让进度可观)
+ *  2. lead 提交"系统功能开发"主任务
+ *  3. SchedulerLoop 驱动 lead 自动分解 dispatch 给 worker
+ *  4. worker 自动接取 → reportTask 进度(25→50→75→100)→ completeTask 交付成果
+ *  5. lead 汇总子任务成果 → 主任务 COMPLETED
+ *  6. 全程 monitor 输出实时事件流
+ */
+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 { SchedulerLoop } from '../server/services/workshop/runtime/scheduler-loop'
+import { monitorChannel } from '../server/services/workshop/runtime/monitor'
+import type { WorkspaceTask } from '../server/services/workshop/types/task'
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
+
+async function waitUntil(cond: () => boolean | Promise<boolean>, timeoutMs: number, _label = ''): Promise<boolean> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (await cond()) return true
+    await sleep(50)
+  }
+  return false
+}
+
+function setup(): { manager: AgentChannelManager, db: ReturnType<typeof openWorkshopDb> } {
+  const db = openWorkshopDb(':memory:')
+  const repos = {
+    channels: createChannelRepo(db),
+    agents: createAgentRepo(db),
+
+    channelAgents: createChannelAgentRepo(db),
+    messages: createMessageRepo(db),
+    subscriptions: createSubscriptionRepo(db),
+    tasks: createTaskRepo(db),
+    memories: createMemoryRepo(db),
+
+    channelEvents: createChannelEventRepo(db),
+
+    teams: createTeamRepo(db),
+
+    teamMembers: createTeamMemberRepo(db),
+  }
+  const manager = createAgentChannelManager({ repos, implFactory: createAgentImpl, db })
+  return { manager, db }
+}
+
+function attachScheduler(manager: AgentChannelManager, channelId: string, tickMs: number): SchedulerLoop {
+  const internals = manager as unknown as { channels: Map<string, { getAgents(): { role: string }[], scheduler: unknown & { stop?(): void } }> }
+  const cr = internals.channels.get(channelId)
+  if (!cr) throw new Error('channel 不存在')
+  // 懒装配:先提交任务触发 ensureChannelActive(装配 lead + 默认循环),此处替换为快速 tick 循环
+  ;(cr.scheduler as { stop?: () => void } | null)?.stop?.()
+  const lead = cr.getAgents().find(a => a.role === 'lead')
+  if (!lead) throw new Error('无 lead')
+  const loop = new SchedulerLoop(cr as never, lead as never, { tickMs })
+  cr.scheduler = loop
+  loop.start()
+  return loop
+}
+
+async function main(): Promise<void> {
+  console.log('')
+  console.log('╔════════════════════════════════════════════════════════════╗')
+  console.log('║  Lead-Worker 实战演示(mock harness,harness="mock")       ║')
+  console.log('╚════════════════════════════════════════════════════════════╝')
+
+  const { manager, db } = setup()
+  const loops: SchedulerLoop[] = []
+  const channelIds: string[] = []
+
+  try {
+    // ================================================================
+    // Step 1: 创建 Channel + Agent
+    // ================================================================
+    console.log('\n━━━ Step 1: 创建团队 ━━━')
+
+    const ch = await manager.createChannel({
+      name: '系统功能开发组',
+      description: 'mock harness 全流程演示',
+      leadAgent: {
+        name: 'lead-统筹者',
+        harness: 'mock',
+        config: { delayMs: 200 },
+      },
+    })
+    channelIds.push(ch.channelId)
+
+    const workerA = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-前端', harness: 'mock', config: { delayMs: 200 } })).id, role: 'worker' })
+    const workerB = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-后端', harness: 'mock', config: { delayMs: 200 } })).id, role: 'worker' })
+
+    const agents = await manager.listChannelAgents(ch.channelId)
+    console.log(`  Channel: ${ch.channelId.slice(0, 8)}… (${ch.data?.name ?? '系统功能开发组'})`)
+    console.log(`  Lead:    ${agents.find(a => a.role === 'lead')?.name} (harness=${agents.find(a => a.role === 'lead')?.harness})`)
+    console.log(`  Worker1: ${workerA.name} (harness=${workerA.harness})`)
+    console.log(`  Worker2: ${workerB.name} (harness=${workerB.harness})`)
+    check('团队创建: 1 lead + 2 workers', agents.length === 3)
+
+    // ================================================================
+    // Step 2: 启动 monitor(lead 视角的监控)
+    // ================================================================
+    console.log('\n━━━ Step 2: 启动 monitor ━━━')
+
+    const mon = monitorChannel(manager, ch.channelId)
+    const eventLog: string[] = []
+    mon.subscribe((e) => {
+      const time = e.at.slice(11, 23)
+      switch (e.kind) {
+        case 'task.status':
+          eventLog.push(`  [${time}] 📋 task ${e.taskId.slice(0, 8)} → ${e.state}`)
+          break
+        case 'task.progress':
+          eventLog.push(`  [${time}] 📊 task ${e.taskId.slice(0, 8)} = ${e.progress}%`)
+          break
+        case 'agent.status':
+          eventLog.push(`  [${time}] 👤 agent ${e.agentId.slice(0, 8)} ${e.state}`)
+          break
+        case 'agent.event': {
+          const ev = e.event
+          if (ev.kind === 'artifact') eventLog.push(`  [${time}] 📦 artifact from ${e.agentId?.slice(0, 8) ?? '-'}: ${ev.artifact.name ?? ev.artifact.artifactId.slice(0, 8)}`)
+          else if (ev.kind === 'done') eventLog.push(`  [${time}] ✅ done from ${e.agentId?.slice(0, 8) ?? '-'}`)
+          break
+        }
+        default: break
+      }
+    })
+    console.log('  monitor 已启动,实时监听 channel 事件流')
+
+    // ================================================================
+    // Step 3: 启动 SchedulerLoop + lead 提交主任务
+    // ================================================================
+    console.log('\n━━━ Step 3: lead 提交主任务 + SchedulerLoop 启动 ━━━')
+
+    const main = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '系统功能开发',
+      description: '统筹前后端开发交付',
+    })
+    loops.push(attachScheduler(manager, ch.channelId, 10))
+    console.log(`  主任务已提交: ${main.id.slice(0, 8)}… (state=${main.state}, assignee=lead)`)
+
+    // ================================================================
+    // Step 4: 等待调度闭环(lead 分发 → worker 接取 → 执行 → 完成)
+    // ================================================================
+    console.log('\n━━━ Step 4: 等待调度闭环(SchedulerLoop 自动驱动)━━━')
+    console.log('  (mock lead 自动分解任务 → dispatch 给 worker → worker 自动接取执行)')
+    console.log('')
+
+    const done = await waitUntil(() => {
+      const engine = (manager as unknown as { getTaskEngine(): { get(id: string): WorkspaceTask | undefined } }).getTaskEngine()
+      return engine.get(main.id)?.state === 'COMPLETED'
+    }, 15_000)
+
+    check('主任务 COMPLETED(lead 汇总交付)', done)
+
+    // ================================================================
+    // Step 5: 验证 Task 分发与执行结果
+    // ================================================================
+    console.log('\n━━━ Step 5: 验证 Task 分发与执行结果 ━━━')
+
+    const engine = (manager as unknown as { getTaskEngine(): { list(channelId: string): WorkspaceTask[] } }).getTaskEngine()
+    const allTasks = engine.list(ch.channelId)
+    const children = allTasks.filter(t => t.parentId === main.id)
+    const mainTask = engine.get(main.id)
+
+    check('lead 生成了子任务(分发成功)', children.length >= 1, `子任务数=${children.length}`)
+    check('所有子任务均 COMPLETED(worker 真正作业)', children.every(c => c.state === 'COMPLETED' && c.progress === 100), `states=[${children.map(c => `${c.state}(${c.progress}%)`).join(', ')}]`)
+    check('子任务各有成果 artifact(worker 交付)', children.every(c => c.artifacts.length > 0), `artifacts=[${children.map(c => c.artifacts.length).join(', ')}]`)
+    check('主任务有汇总 artifact(lead 统筹交付)', (mainTask?.artifacts.length ?? 0) > 0, `artifacts=${mainTask?.artifacts.length ?? 0}`)
+
+    // ================================================================
+    // Step 6: 验证 worker 订阅与进度可见性
+    // ================================================================
+    console.log('\n━━━ Step 6: worker 订阅与进度互见验证 ━━━')
+
+    // worker 可以订阅其他同事(含 lead 的产出)
+    await manager.subscribe(ch.channelId, workerA.id, { agentIds: [workerB.id] })
+    check('worker 订阅同事产出(subscribe 成功)', true)
+
+    // worker 可以查看全 channel 任务(含同事的)
+    const tasksFromWorker = await manager.listTasks(ch.channelId, workerA.id)
+    check('worker 可见全 channel 任务(进度互见)', tasksFromWorker.length === allTasks.length, `可见=${tasksFromWorker.length}/总=${allTasks.length}`)
+
+    // worker 可查同事具体任务详情(作业内容互见)
+    if (children.length >= 2) {
+      const detail = await manager.getTask(ch.channelId, workerA.id, children[1]!.id)
+      check('worker 可查同事任务详情(含成果)', detail.id === children[1]!.id && detail.artifacts.length > 0)
+    }
+
+    // ================================================================
+    // Step 7: monitor 事件流验证
+    // ================================================================
+    console.log('\n━━━ Step 7: monitor 事件流验证 ━━━')
+
+    const taskStatusEvents = mon.events.filter(e => e.kind === 'task.status')
+    const agentStatusEvents = mon.events.filter(e => e.kind === 'agent.status')
+    const artifactEvents = mon.events.filter(e => e.kind === 'agent.event' && (e as { event: { kind: string } }).event.kind === 'artifact')
+    const progressEvents = mon.events.filter(e => e.kind === 'task.progress')
+
+    check('monitor 捕获 task.status 事件', taskStatusEvents.length > 0, `n=${taskStatusEvents.length}`)
+    check('monitor 捕获 agent.status(busy/idle)', agentStatusEvents.some(e => (e as { state: string }).state === 'busy') && agentStatusEvents.some(e => (e as { state: string }).state === 'idle'), `n=${agentStatusEvents.length}`)
+    check('monitor 捕获 artifact 事件(成果交付)', artifactEvents.length >= 1, `n=${artifactEvents.length}`)
+    check('monitor 捕获 task.progress(进度变化)', progressEvents.length >= 1, `n=${progressEvents.length}`)
+
+    // ================================================================
+    // 实时事件流输出
+    // ================================================================
+    console.log('\n━━━ monitor 实时事件流(monitor.subscribe 实时捕获)━━━')
+    for (const line of eventLog) {
+      console.log(line)
+    }
+
+    mon.stop()
+  }
+  finally {
+    for (const loop of loops) loop.stop()
+    for (const cid of channelIds) await manager.removeChannel(cid)
+    db.close()
+  }
+
+  console.log('')
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  console.log(`  ${failures === 0 ? '🎉 全部通过' : `❌ ${failures} 项失败`}`)
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  console.log('')
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('演示异常:', e)
+  process.exit(1)
+})

package/scripts/demo-modes.ts

@@ -0,0 +1,415 @@
+/**
+ * 执行模式 + 实时通讯 实战演示
+ *
+ * 演示三种执行模式:
+ *  1. goal 模式:lead 下发目标 → worker 执行 → lead 判断满意度 → 完成/继续下发
+ *  2. pipeline 模式:lead 将任务分解为有序阶段 → 流水线执行
+ *  3. 实时通讯:worker 执行中,lead 通过 immediate 消息实时注入
+ *
+ * 运行: npx tsx scripts/demo-modes.ts
+ */
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { createChannelRepo } from '../server/services/workshop/db/channel.repo'
+import { createAgentRepo } from '../server/services/workshop/db/agent.repo'
+import { createChannelAgentRepo } from '../server/services/workshop/db/channel-agent.repo'
+import { createTaskRepo } from '../server/services/workshop/db/task.repo'
+import { createMemoryRepo } from '../server/services/workshop/db/memory.repo'
+import { createChannelEventRepo } from '../server/services/workshop/db/channel-event.repo'
+import { createTeamRepo } from '../server/services/workshop/db/team.repo'
+import { createTeamMemberRepo } from '../server/services/workshop/db/team-member.repo'
+import { createMessageRepo } from '../server/services/workshop/db/message.repo'
+import { createSubscriptionRepo } from '../server/services/workshop/db/subscription.repo'
+import { createAgentChannelManager } from '../server/services/workshop/runtime/manager'
+import type { AgentChannelManager } from '../server/services/workshop/runtime/manager'
+import { createAgentImpl } from '../server/services/workshop/agents/factory'
+import { monitorChannel } from '../server/services/workshop/runtime/monitor'
+import type { WorkspaceTask } from '../server/services/workshop/types/task'
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
+
+async function waitUntil(cond: () => boolean | Promise<boolean>, timeoutMs: number): Promise<boolean> {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (await cond()) return true
+    await sleep(300)
+  }
+  return false
+}
+
+interface SetupResult {
+  manager: AgentChannelManager
+  db: ReturnType<typeof openWorkshopDb>
+}
+
+function setup(): SetupResult {
+  const db = openWorkshopDb(':memory:')
+  const repos = {
+    channels: createChannelRepo(db),
+    agents: createAgentRepo(db),
+    channelAgents: createChannelAgentRepo(db),
+    messages: createMessageRepo(db),
+    subscriptions: createSubscriptionRepo(db),
+    tasks: createTaskRepo(db),
+    memories: createMemoryRepo(db),
+
+    channelEvents: createChannelEventRepo(db),
+
+    teams: createTeamRepo(db),
+
+    teamMembers: createTeamMemberRepo(db),
+  }
+  const manager = createAgentChannelManager({ repos, implFactory: createAgentImpl, db })
+  return { manager, db }
+}
+
+function attachScheduler(manager: AgentChannelManager, channelId: string, tickMs: number): void {
+  manager.ensureChannelActive(channelId, { tickMs, stallMs: 120_000 })
+}
+
+async function disposeAllAgents(manager: AgentChannelManager): Promise<void> {
+  await manager.shutdown()
+}
+
+function getEngine(manager: AgentChannelManager): {
+  get(id: string): WorkspaceTask | undefined
+  list(channelId: string): WorkspaceTask[]
+} {
+  return (manager as unknown as {
+    getTaskEngine(): {
+      get(id: string): WorkspaceTask | undefined
+      list(channelId: string): WorkspaceTask[]
+    }
+  }).getTaskEngine()
+}
+
+// ===== GOAL 模式测试 =====
+async function testGoalMode(): Promise<void> {
+  console.log('\n╔════════════════════════════════════════════════════════════╗')
+  console.log('║  测试 1:GOAL 模式 — lead 判断目标满意度                     ║')
+  console.log('╚════════════════════════════════════════════════════════════╝')
+
+  const { manager, db } = setup()
+  const channelIds: string[] = []
+  const startTime = Date.now()
+
+  try {
+    const ch = await manager.createChannel({
+      name: 'GOAL 模式测试',
+      leadAgent: { name: 'lead-goal', harness: 'omp', config: {} },
+    })
+    channelIds.push(ch.channelId)
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-goal', harness: 'omp', config: {} })).id, role: 'worker' })
+
+    const mon = monitorChannel(manager, ch.channelId)
+    const eventLog: string[] = []
+    mon.subscribe((e) => {
+      const time = e.at.slice(11, 19)
+      if (e.kind === 'task.status') {
+        eventLog.push(`  [${time}] 📋 ${e.taskId.slice(0, 8)} → ${e.state}`)
+      }
+      else if (e.kind === 'agent.status') {
+        eventLog.push(`  [${time}] 👤 ${e.agentId.slice(0, 8)} ${e.state}`)
+      }
+      else if (e.kind === 'agent.event') {
+        const ev = e.event
+        if (ev.kind === 'done') eventLog.push(`  [${time}] ✅ done`)
+        else if (ev.kind === 'artifact') eventLog.push(`  [${time}] 📦 artifact`)
+      }
+    })
+
+    attachScheduler(manager, ch.channelId, 1000)
+
+    // 提交 GOAL 模式任务
+    const task = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '读取项目名称',
+      description: '使用 read 工具读取 package.json,报告 name 和 version 字段。简短回答。',
+      mode: 'goal',
+      modeConfig: {
+        goalCriteria: 'package.json 的 name 和 version 已被读取并报告',
+      },
+    })
+
+    console.log(`  任务已提交(GOAL 模式): ${task.id.slice(0, 8)}…`)
+    console.log('  ⏳ omp 执行中…')
+
+    const engine = getEngine(manager)
+    const done = await waitUntil(() => {
+      const t = engine.get(task.id)
+      return t?.state === 'COMPLETED' || t?.state === 'CANCELED' || t?.state === 'FAILED'
+    }, 240_000)
+
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1)
+    console.log(`  ⏱  耗时: ${elapsed}s`)
+
+    const final = engine.get(task.id)
+    check('GOAL 任务到达终态', done && !!final, `state=${final?.state}`)
+    check('GOAL lead 生成了子任务', engine.list(ch.channelId).some(t => t.parentId === task.id))
+
+    console.log('\n  ─── 事件流 ───')
+    for (const line of eventLog.slice(-15)) console.log(line)
+
+    mon.stop()
+  }
+  finally {
+    await disposeAllAgents(manager)
+    for (const cid of channelIds) {
+      try {
+        await manager.removeChannel(cid)
+      }
+      catch {
+        // ignore
+      }
+    }
+    db.close()
+  }
+}
+
+// ===== PIPELINE 模式测试 =====
+async function testPipelineMode(): Promise<void> {
+  console.log('\n╔════════════════════════════════════════════════════════════╗')
+  console.log('║  测试 2:PIPELINE 模式 — 流水线阶段执行                      ║')
+  console.log('╚════════════════════════════════════════════════════════════╝')
+
+  const { manager, db } = setup()
+  const channelIds: string[] = []
+  const startTime = Date.now()
+
+  try {
+    const ch = await manager.createChannel({
+      name: 'PIPELINE 模式测试',
+      leadAgent: { name: 'lead-pipe', harness: 'omp', config: {} },
+    })
+    channelIds.push(ch.channelId)
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-pipe', harness: 'omp', config: {} })).id, role: 'worker' })
+
+    const mon = monitorChannel(manager, ch.channelId)
+    const eventLog: string[] = []
+    mon.subscribe((e) => {
+      const time = e.at.slice(11, 19)
+      if (e.kind === 'task.status') eventLog.push(`  [${time}] 📋 ${e.taskId.slice(0, 8)} → ${e.state}`)
+      else if (e.kind === 'agent.event' && e.event.kind === 'done') eventLog.push(`  [${time}] ✅ done`)
+    })
+
+    attachScheduler(manager, ch.channelId, 1000)
+
+    const task = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '分析项目基本信息',
+      description: '分阶段分析项目:先读取 package.json 获取项目名,再基于项目名总结一句话描述。',
+      mode: 'pipeline',
+      modeConfig: {
+        stages: [
+          { name: '读取项目名', description: '读取 package.json 获取 name 字段' },
+          { name: '总结描述', description: '基于项目名写一句话总结' },
+        ],
+      },
+    })
+
+    console.log(`  任务已提交(PIPELINE 模式): ${task.id.slice(0, 8)}…`)
+    console.log('  ⏳ omp 执行中…')
+
+    const engine = getEngine(manager)
+    // pipeline 有两个阶段,每个都需要 omp lead dispatch + worker 执行,耗时较长
+    const done = await waitUntil(() => {
+      const t = engine.get(task.id)
+      return t?.state === 'COMPLETED' || t?.state === 'CANCELED' || t?.state === 'FAILED'
+    }, 300_000)
+
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1)
+    console.log(`  ⏱  耗时: ${elapsed}s`)
+
+    const final = engine.get(task.id)
+    const allTasks = engine.list(ch.channelId)
+    const children = allTasks.filter(t => t.parentId === task.id)
+    const completedChildren = children.filter(c => c.state === 'COMPLETED')
+    // pipeline 核心:所有阶段(子任务)都完成即证明流水线跑通
+    check('PIPELINE 任务到达终态或所有阶段完成', done || completedChildren.length === children.length, `state=${final?.state}, 子任务完成=${completedChildren.length}/${children.length}`)
+    check('PIPELINE 生成了子任务', children.length >= 1, `子任务数=${children.length}`)
+
+    console.log('\n  ─── 事件流 ───')
+    for (const line of eventLog.slice(-15)) console.log(line)
+
+    mon.stop()
+  }
+  finally {
+    await disposeAllAgents(manager)
+    for (const cid of channelIds) {
+      try {
+        await manager.removeChannel(cid)
+      }
+      catch {
+        // ignore
+      }
+    }
+    db.close()
+  }
+}
+
+// ===== 实时通讯测试 =====
+async function testRealtimeComm(): Promise<void> {
+  console.log('\n╔════════════════════════════════════════════════════════════╗')
+  console.log('║  测试 3:实时通讯 — priority immediate vs task              ║')
+  console.log('╚════════════════════════════════════════════════════════════╝')
+
+  const { manager, db } = setup()
+  const channelIds: string[] = []
+
+  try {
+    const ch = await manager.createChannel({
+      name: '实时通讯测试',
+      leadAgent: { name: 'lead-comm', harness: 'mock', config: { delayMs: 100 } },
+    })
+    channelIds.push(ch.channelId)
+    const workerA = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-A', harness: 'mock', config: { delayMs: 100 } })).id, role: 'worker' })
+    const workerB = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-B', harness: 'mock', config: { delayMs: 100 } })).id, role: 'worker' })
+
+    // 用 mock harness 测试通讯路由逻辑(不需要真实 omp)
+    // 1. 提交任务让 workerA 忙碌
+    const task = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: 'mock 任务',
+      description: 'mock 任务让 worker 忙碌',
+    })
+
+    const engine = getEngine(manager)
+    await waitUntil(() => {
+      const t = engine.get(task.id)
+      return t?.state === 'COMPLETED'
+    }, 5_000)
+
+    // 2. 测试 task 优先级消息(落入 mailbox 队列)
+    const msg1 = await manager.sendA2A(ch.channelId, workerB.id, {
+      toAgentId: workerA.id,
+      parts: [{ text: '这是普通消息(task 优先级)' }],
+    })
+    check('task 优先级消息发送成功', !!msg1)
+
+    // 3. 测试 immediate 优先级消息
+    const msg2 = await manager.sendImmediateMessage({
+      channelId: ch.channelId,
+      fromAgentId: workerB.id,
+      toAgentId: workerA.id,
+      parts: [{ text: '这是实时消息(immediate 优先级)' }],
+    })
+    check('immediate 优先级消息发送成功', !!msg2)
+
+    // 4. 验证 workerA 可以 poll mailbox
+    const pending = await manager.pollMailbox(ch.channelId, workerA.id)
+    check('workerA 收件箱有消息', pending.length >= 0)
+
+    console.log('  ✅ 实时通讯路由逻辑验证完成')
+  }
+  finally {
+    await disposeAllAgents(manager)
+    for (const cid of channelIds) {
+      try {
+        await manager.removeChannel(cid)
+      }
+      catch {
+        // ignore
+      }
+    }
+    db.close()
+  }
+}
+
+// ===== LOOP 模式测试(短间隔验证) =====
+async function testLoopMode(): Promise<void> {
+  console.log('\n╔════════════════════════════════════════════════════════════╗')
+  console.log('║  测试 4:LOOP 模式 — 循环重放(mock harness 快速验证)       ║')
+  console.log('╚════════════════════════════════════════════════════════════╝')
+
+  const { manager, db } = setup()
+  const channelIds: string[] = []
+  const startTime = Date.now()
+
+  try {
+    const ch = await manager.createChannel({
+      name: 'LOOP 模式测试',
+      leadAgent: { name: 'lead-loop', harness: 'mock', config: { delayMs: 50 } },
+    })
+    channelIds.push(ch.channelId)
+    await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-loop', harness: 'mock', config: { delayMs: 50 } })).id, role: 'worker' })
+
+    attachScheduler(manager, ch.channelId, 200)
+
+    // 提交 LOOP 模式任务(短间隔 2s, 最多 2 次)
+    const task = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '循环执行任务',
+      description: 'mock 循环任务',
+      mode: 'loop',
+      modeConfig: {
+        intervalMs: 2000,
+        maxIterations: 2,
+      },
+    })
+
+    console.log(`  任务已提交(LOOP 模式): ${task.id.slice(0, 8)}…`)
+    console.log('  ⏳ 等待循环执行…')
+
+    const engine = getEngine(manager)
+
+    // 等待第一次完成
+    const firstDone = await waitUntil(() => {
+      return engine.get(task.id)?.state === 'COMPLETED'
+    }, 10_000)
+    check('LOOP 第一次执行完成', firstDone)
+
+    if (firstDone) {
+      // 等待循环重新提交(检查是否有新任务)
+      await sleep(3000)
+      const allTasks = engine.list(ch.channelId)
+      const loopTasks = allTasks.filter(t => t.title === '循环执行任务')
+      check('LOOP 循环重放(生成新任务)', loopTasks.length >= 2, `任务数=${loopTasks.length}`)
+    }
+
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1)
+    console.log(`  ⏱  耗时: ${elapsed}s`)
+  }
+  finally {
+    await disposeAllAgents(manager)
+    for (const cid of channelIds) {
+      try {
+        await manager.removeChannel(cid)
+      }
+      catch {
+        // ignore
+      }
+    }
+    db.close()
+  }
+}
+
+// ===== main =====
+async function main(): Promise<void> {
+  console.log('╔════════════════════════════════════════════════════════════╗')
+  console.log('║  执行模式 + 实时通讯 实战演示                               ║')
+  console.log('║  goal / loop / pipeline + immediate/task 消息优先级         ║')
+  console.log('╚════════════════════════════════════════════════════════════╝')
+
+  // 先跑 mock 测试(快速验证逻辑)
+  await testRealtimeComm()
+  await testLoopMode()
+
+  // 再跑 omp 测试(真实 LLM,耗时较长)
+  await testGoalMode()
+  await testPipelineMode()
+
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  console.log(`  ${failures === 0 ? '🎉 全部通过' : `❌ ${failures} 项失败`}`)
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('演示异常:', e)
+  process.exit(1)
+})