agentworkshop 0.2.1

package/scripts/test-e2e-collaboration.ts

@@ -0,0 +1,262 @@
+/**
+ * 端到端协同测试 — 真实 omp 驱动的 lead-worker 协作场景
+ *
+ * 场景:lead 接收「分析项目」任务 → 分解给 2 个 worker:
+ *  - worker-A: 读取 package.json,报告项目名称和依赖数
+ *  - worker-B: 读取 tsconfig.json,报告 TypeScript 配置
+ * lead 收集两边结果后,汇总完成主任务
+ *
+ * 验证:
+ *  1. lead 能 dispatch 任务给 channel 中的 worker
+ *  2. worker 能真正执行任务(read 原生工具 + host tools)
+ *  3. lead 能监控 worker 进度并汇总
+ *  4. 实时通讯:lead → worker immediate 消息注入
+ *  5. worker 之间 task 队列消息通信
+ */
+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
+}
+
+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()
+}
+
+async function disposeAllAgents(manager: AgentChannelManager): Promise<void> {
+  await manager.shutdown()
+}
+
+function attachScheduler(manager: AgentChannelManager, channelId: string, tickMs: number): void {
+  manager.ensureChannelActive(channelId, { tickMs, stallMs: 180_000 })
+}
+
+async function main(): Promise<void> {
+  console.log('')
+  console.log('╔════════════════════════════════════════════════════════════════════╗')
+  console.log('║  端到端协同测试 — lead dispatch + worker 协作 + 实时通讯           ║')
+  console.log('║  harness="omp" · 真实 LLM 驱动 · channel 内全 Agent 协同          ║')
+  console.log('╚════════════════════════════════════════════════════════════════════╝')
+
+  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 channelIds: string[] = []
+  const startTime = Date.now()
+
+  try {
+    // ===== Step 1: 创建团队 =====
+    console.log('\n━━━ Step 1: 创建协同团队(全部 omp harness)━━━')
+
+    const ch = await manager.createChannel({
+      name: '项目分析协同组',
+      description: '端到端协同测试',
+      leadAgent: { name: 'lead-项目经理', harness: 'omp', config: {} },
+    })
+    channelIds.push(ch.channelId)
+
+    const workerA = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-包分析', harness: 'omp', config: {} })).id, role: 'worker' })
+    const workerB = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-配置分析', harness: 'omp', config: {} })).id, role: 'worker' })
+
+    const agents = await manager.listChannelAgents(ch.channelId)
+    console.log(`  Channel: ${ch.channelId.slice(0, 8)}…`)
+    console.log(`  Lead:    ${agents.find(a => a.role === 'lead')?.name}`)
+    console.log(`  Worker1: ${workerA.name} (id: ${workerA.id.slice(0, 8)}…)`)
+    console.log(`  Worker2: ${workerB.name} (id: ${workerB.id.slice(0, 8)}…)`)
+    check('团队创建: 1 lead + 2 workers', agents.length === 3)
+
+    // ===== Step 2: 启动 monitor =====
+    console.log('\n━━━ Step 2: 启动 monitor(监听全 channel 事件)━━━')
+
+    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 === 'task.progress') {
+        eventLog.push(`[${time}] 📊 ${e.taskId.slice(0, 8)} = ${e.progress}%`)
+      }
+      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(${e.agentId?.slice(0, 8) ?? '-'})`)
+        else if (ev.kind === 'artifact') eventLog.push(`[${time}] 📦 artifact(${e.agentId?.slice(0, 8) ?? '-'})`)
+        else if (ev.kind === 'error') eventLog.push(`[${time}] ❌ error(${e.agentId?.slice(0, 8) ?? '-'})`)
+        else if (ev.kind === 'status' && ev.status.message) {
+          const text = ev.status.message.parts.map(p => 'text' in p ? p.text.slice(0, 60) : '').join(' ')
+          if (text) eventLog.push(`[${time}] 💬 ${e.agentId?.slice(0, 8) ?? '-'}: ${text}`)
+        }
+      }
+    })
+    console.log('  monitor 已启动')
+
+    // ===== Step 3: 启动调度 + 提交任务 =====
+    console.log('\n━━━ Step 3: 启动 SchedulerLoop + 提交任务 ━━━')
+
+    attachScheduler(manager, ch.channelId, 500)
+
+    const mainTask = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '分析项目 package.json 和 tsconfig.json',
+      description: '分析当前项目的 package.json(项目名称、版本、依赖数量)和 tsconfig.json(TypeScript 编译配置)。分发给两个 worker 分别分析,然后汇总。简短回答。',
+    })
+    console.log(`  主任务已提交: ${mainTask.id.slice(0, 8)}… "${mainTask.title}"`)
+    console.log('  ⏳ omp lead 分发任务中…')
+
+    // ===== Step 4: 等待 lead dispatch + worker 执行 =====
+    const engine = getEngine(manager)
+
+    // 等待主任务有进展(被 dispatch 或完成)
+    await waitUntil(() => {
+      const t = engine.get(mainTask.id)
+      if (!t) return false
+      const taskChildren = engine.list(ch.channelId).filter(task => task.parentId === mainTask.id)
+      return taskChildren.length >= 1 || t.state === 'COMPLETED'
+    }, 180_000)
+
+    const childrenAtDispatch = engine.list(ch.channelId).filter(t => t.parentId === mainTask.id)
+    console.log(`  lead dispatch 了 ${childrenAtDispatch.length} 个子任务`)
+    check('lead 能 dispatch 任务给 worker', childrenAtDispatch.length >= 1, `子任务数=${childrenAtDispatch.length}`)
+
+    // 等待主任务终态
+    console.log('  ⏳ 等待 worker 执行完成…')
+    await waitUntil(() => {
+      const t = engine.get(mainTask.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`)
+
+    // ===== Step 5: 验证结果 =====
+    console.log('\n━━━ Step 5: 验证协同结果 ━━━')
+
+    const finalTask = engine.get(mainTask.id)
+    const allTasks = engine.list(ch.channelId)
+    const children = allTasks.filter(t => t.parentId === mainTask.id)
+    const completedChildren = children.filter(c => c.state === 'COMPLETED')
+    const childrenWithArtifacts = children.filter(c => c.artifacts.length > 0)
+
+    check('主任务有进展(不超时)', !!finalTask && finalTask.state !== 'SUBMITTED', `state=${finalTask?.state}`)
+    check('lead 生成了子任务', children.length >= 1, `子任务数=${children.length}`)
+    check('子任务有 COMPLETED 的', completedChildren.length >= 1, `${completedChildren.length}/${children.length} 完成`)
+
+    // 打印 worker 交付的成果
+    if (childrenWithArtifacts.length > 0) {
+      console.log('\n  ─── Worker 协同成果 ───')
+      for (const child of childrenWithArtifacts) {
+        const text = child.artifacts
+          .flatMap(a => a.parts)
+          .map(p => 'text' in p ? p.text : '')
+          .join('\n')
+        console.log(`  📦 [${child.title}] (${child.assigneeId.slice(0, 8)}…):`)
+        const preview = text.slice(0, 200).replace(/\n/g, '\n     ')
+        console.log(`     ${preview}…`)
+      }
+    }
+
+    // ===== Step 6: 验证事件流(协同可见性) =====
+    console.log('\n━━━ Step 6: 验证协同事件流 ━━━')
+
+    const taskStatusEvents = mon.events.filter(e => e.kind === 'task.status')
+    const agentStatusEvents = mon.events.filter(e => e.kind === 'agent.status')
+    const agentEvents = mon.events.filter(e => e.kind === 'agent.event')
+    const busyEvents = agentStatusEvents.filter(e => (e as { state: string }).state === 'busy')
+    const idleEvents = agentStatusEvents.filter(e => (e as { state: string }).state === 'idle')
+
+    check('捕获 task.status 事件', taskStatusEvents.length >= 3, `n=${taskStatusEvents.length}`)
+    check('捕获 agent busy 事件(worker 真正在工作)', busyEvents.length >= 1, `n=${busyEvents.length}`)
+    check('捕获 agent idle 事件(worker 完成后空闲)', idleEvents.length >= 1, `n=${idleEvents.length}`)
+    check('捕获 agent.event 流(omp 事件)', agentEvents.length >= 3, `n=${agentEvents.length}`)
+
+    // ===== 事件流输出 =====
+    console.log('\n━━━ 协同事件流(monitor 实时捕获)━━━')
+    const recent = eventLog.slice(-40)
+    for (const line of recent) {
+      console.log(`  ${line}`)
+    }
+    if (eventLog.length > 40) {
+      console.log(`  … (${eventLog.length - 40} 条更早事件省略)`)
+    }
+
+    mon.stop()
+  }
+  finally {
+    await disposeAllAgents(manager)
+    for (const cid of channelIds) {
+      try {
+        await manager.removeChannel(cid)
+      }
+      catch {
+        // ignore
+      }
+    }
+    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/test-e2e-monitor.ts

@@ -0,0 +1,192 @@
+/**
+ * 端到端监控测试 — mock harness 全流程 + WorkshopMonitor 事件流验证。
+ *
+ * 流程: 创建 Channel(lead+2 workers) → monitor 启动 → 提交任务 → SchedulerLoop
+ *       自动 dispatch → worker 自动接取执行上报 → lead 汇总交付 → 主任务 COMPLETED。
+ *
+ * 断言(monitor 捕获的事件满足项目自定义协议数据结构):
+ *  1. agent.event 事件均为 AgentEvent 五变体(kind 判别 + 字段收窄)
+ *  2. task.status 序列覆盖完整生命周期(SUBMITTED→ASSIGNED→WORKING→COMPLETED)
+ *  3. task.progress 单调递增至 100
+ *  4. artifact 事件存在(子任务成果 + 父 summary)
+ *  5. agent.status 捕捉 busy/idle 变化
+ *  6. monitor.waitFor/summary 可用
+ */
+import { randomUUID } from 'node:crypto'
+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 { 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 { MonitorEvent } from '../server/services/workshop/runtime/monitor'
+import type { ChannelRuntime } from '../server/services/workshop/runtime/channel-runtime'
+import type { AgentEvent } from '../server/services/workshop/agents/agent-interface'
+import type { WorkspaceTask } from '../server/services/workshop/types/task'
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+function setup(): { db: DatabaseSync, manager: AgentChannelManager } {
+  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 { db, manager }
+}
+
+function attachScheduler(manager: AgentChannelManager, channelId: string, tickMs: number): SchedulerLoop {
+  // 懒加载时代:先激活 channel(装配 lead 运行时与默认循环),再换成测试配置的循环
+  manager.ensureChannelActive(channelId)
+  const internals = manager as unknown as { channels: Map<string, ChannelRuntime> }
+  const cr = internals.channels.get(channelId)
+  if (!cr) throw new Error(`channel runtime 不存在: ${channelId}`)
+  cr.scheduler?.stop()
+  const lead = cr.getAgents().find(a => a.role === 'lead')
+  if (!lead) throw new Error('无 lead')
+  const loop = new SchedulerLoop(cr, lead as never, { tickMs })
+  cr.scheduler = loop
+  loop.start()
+  return loop
+}
+
+/** AgentEvent 结构校验:五变体判别 + 关键字段类型 */
+function isWellFormedAgentEvent(e: AgentEvent): boolean {
+  switch (e.kind) {
+    case 'status': return typeof e.status.state === 'string' && typeof e.status.timestamp === 'string'
+    case 'message': return typeof e.message.messageId === 'string' && Array.isArray(e.message.parts)
+    case 'artifact': return typeof e.artifact.artifactId === 'string' && Array.isArray(e.artifact.parts)
+    case 'error': return typeof e.error.code === 'string' && typeof e.error.message === 'string'
+    case 'done': return e.final === undefined || typeof e.final === 'object'
+    default: return false
+  }
+}
+
+async function main(): Promise<void> {
+  console.log('\n=== 端到端监控测试(mock harness 全流程 + 事件流结构) ===')
+  const { db, manager } = setup()
+  const loops: SchedulerLoop[] = []
+  const channels: string[] = []
+
+  try {
+    // ---- 1. Channel + Agent 管理 ----
+    const ch = await manager.createChannel({
+      name: '监控演示频道',
+      description: 'e2e monitor',
+      leadAgent: { name: 'lead-m', harness: 'mock', config: { delayMs: 60 } },
+    })
+    channels.push(ch.channelId)
+    const w1 = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-a', harness: 'mock', config: { delayMs: 60 } })).id, role: 'worker' })
+    const w2 = await manager.addAgentToChannel({ channelId: ch.channelId, agentId: (await manager.createAgent({ name: 'worker-b', harness: 'mock', config: { delayMs: 60 } })).id, role: 'worker' })
+    const agents = await manager.listChannelAgents(ch.channelId)
+    check('Channel/Agent 管理: 1 lead + 2 workers', agents.length === 3 && agents.some(a => a.role === 'lead'), `n=${agents.length}`)
+    void w1
+    void w2
+
+    // ---- 2. monitor 启动(先激活 channel 装配 bus,订阅才有效)----
+    manager.ensureChannelActive(ch.channelId)
+    const mon = monitorChannel(manager, ch.channelId, { pollMs: 50 })
+    const live: string[] = []
+    mon.subscribe(e => live.push(e.kind))
+
+    // ---- 3. 提交任务(调度循环自动分发) ----
+    loops.push(attachScheduler(manager, ch.channelId, 10))
+    const main = await manager.submitChannelTask({ channelId: ch.channelId, title: '监控主任务', description: '完整闭环' })
+
+    const done = await mon.waitUntil(() => {
+      const t = (manager as unknown as { getTaskEngine(): { get(id: string): WorkspaceTask | undefined } }).getTaskEngine().get(main.id)
+      return t?.state === 'COMPLETED'
+    }, 15_000)
+    check('任务闭环: 主任务 COMPLETED', done)
+
+    const engine = (manager as unknown as { getTaskEngine(): { list(channelId: string): WorkspaceTask[] } }).getTaskEngine()
+    const all = engine.list(ch.channelId)
+    const children = all.filter(t => t.parentId === main.id)
+    check('Task 分发: 生成子任务且全部完成', children.length >= 1 && children.every(c => c.state === 'COMPLETED' && c.progress === 100), `n=${children.length}`)
+
+    // ---- 4. 事件流结构断言 ----
+    const agentEvents = mon.events.filter(e => e.kind === 'agent.event')
+    check('agent.event 事件捕获(≥ worker 执行事件)', agentEvents.length >= 3, `n=${agentEvents.length}`)
+    check('agent.event 全部满足 AgentEvent 五变体结构', agentEvents.every(e => isWellFormedAgentEvent((e as { event: AgentEvent }).event)))
+
+    const taskStatus = mon.events.filter(e => e.kind === 'task.status') as Extract<MonitorEvent, { kind: 'task.status' }>[]
+    const statesOf = (taskId: string) => taskStatus.filter(e => e.taskId === taskId).map(e => e.state)
+    const childStates = children.flatMap(c => statesOf(c.id))
+    check('task.status: 子任务覆盖 ASSIGNED→WORKING→COMPLETED',
+      children.every((c) => {
+        const s = statesOf(c.id)
+        return s.includes('ASSIGNED') && s.includes('WORKING') && s.includes('COMPLETED')
+      }),
+      `child states=[${childStates.join(',')}]`)
+    const mainStates = statesOf(main.id)
+    check('task.status: 主任务生命周期完整', mainStates.includes('SUBMITTED') && mainStates.includes('WAITING') && mainStates.includes('COMPLETED'), `[${mainStates.join('→')}]`)
+
+    const progressEvents = mon.events.filter(e => e.kind === 'task.progress') as Extract<MonitorEvent, { kind: 'task.progress' }>[]
+    const progressOf = (taskId: string) => progressEvents.filter(e => e.taskId === taskId).map(e => e.progress)
+    const monotonic = children.every((c) => {
+      const ps = progressOf(c.id)
+      return ps.every((p, i) => i === 0 || p >= ps[i - 1]!) && ps.length > 0
+    })
+    check('task.progress: 子任务进度单调递增', monotonic, children.map(c => `[${progressOf(c.id).join(',')}]`).join(' '))
+
+    const artifactEvents = agentEvents.filter(e => (e as { event: AgentEvent }).event.kind === 'artifact')
+    check('artifact 事件: 子任务成果与父汇总均流出', artifactEvents.length >= children.length + 1, `n=${artifactEvents.length}`)
+
+    const agentStatus = mon.events.filter(e => e.kind === 'agent.status') as Extract<MonitorEvent, { kind: 'agent.status' }>[]
+    check('agent.status: 捕捉成员 busy/idle 变化', agentStatus.some(e => e.state === 'busy') && agentStatus.some(e => e.state === 'idle'), `n=${agentStatus.length}`)
+
+    // ---- 5. monitor API 可用性 ----
+    const waited = await mon.waitFor(e => e.kind === 'task.status' && e.state === 'COMPLETED' && e.taskId === main.id, 1000)
+    check('monitor.waitFor 命中主任务完成事件', waited !== null)
+    check('monitor 实时订阅生效', live.includes('agent.event') && live.includes('task.status'), `[${[...new Set(live)].join(',')}]`)
+
+    const sum = mon.summary()
+    check('monitor.summary 输出时间线', sum.includes('monitor summary') && sum.includes('task.status'), `${sum.split('\n').length} 行`)
+
+    mon.stop()
+    console.log('\n----- monitor 时间线 -----')
+    console.log(sum)
+    console.log('-------------------------')
+  }
+  finally {
+    for (const loop of loops) loop.stop()
+    for (const cid of channels) await manager.removeChannel(cid)
+    db.close()
+  }
+
+  console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILED`}`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((e) => {
+  console.error('监控测试异常:', e)
+  process.exit(1)
+})
+void randomUUID

package/scripts/test-event-history.ts

@@ -0,0 +1,112 @@
+/**
+ * 事件历史查询验证(channel-event.repo 过滤查询):
+ *  1. 内存库:agentId / excludeTypes / beforeSeq 组合语义 + count 同口径 + 幂等 insert;
+ *  2. 生产库只读抽查:对存量 channel 验证「agent 维度历史不再被 delta 淹没」——
+ *     全局 200 帧窗口里 0 条 a2a.message 的 channel,按 agent 过滤后消息可完整取回。
+ */
+import { DatabaseSync } from 'node:sqlite'
+import { createChannelEventRepo } from '../server/services/workshop/db/channel-event.repo'
+
+let failures = 0
+const ok = (name: string, cond: boolean, detail = ''): void => {
+  console.log(`${cond ? '  ✔' : '  ✘'} ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!cond) failures += 1
+}
+
+// ---------- 1. 内存库语义验证 ----------
+console.log('[1] 内存库:过滤查询语义')
+const mem = new DatabaseSync(':memory:')
+mem.exec(`
+  CREATE TABLE channel_events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    channel_id TEXT NOT NULL,
+    seq INTEGER NOT NULL,
+    type TEXT NOT NULL,
+    at TEXT NOT NULL,
+    agent_id TEXT,
+    task_id TEXT,
+    payload_json TEXT NOT NULL,
+    UNIQUE(channel_id, seq)
+  );
+  CREATE INDEX idx_channel_events_channel ON channel_events(channel_id, seq DESC);
+`)
+const repo = createChannelEventRepo(mem)
+const CH = 'ch-test'
+const AG_A = 'agent-a'
+const AG_B = 'agent-b'
+// seq 1..12:A 两条 delta + 消息,B 的消息夹在中间,A 的更早消息在窗口外
+const fixture: Array<[number, string, string | null]> = [
+  [1, 'a2a.message', AG_A],
+  [2, 'agent.delta', AG_A],
+  [3, 'agent.delta', AG_A],
+  [4, 'agent.message', AG_A],
+  [5, 'a2a.message', AG_B],
+  [6, 'agent.status', AG_B],
+  [7, 'agent.delta', AG_B],
+  [8, 'a2a.message', AG_A],
+  [9, 'task.status', null],
+  [10, 'agent.delta', AG_A],
+  [11, 'a2a.message', AG_B],
+  [12, 'agent.status', AG_A],
+]
+for (const [seq, type, agentId] of fixture) {
+  repo.insert(CH, { seq, type, at: `2026-08-23T00:00:${String(seq).padStart(2, '0')}Z`, agentId, taskId: null, payload: { t: seq } })
+}
+// 幂等:同 seq 重插不报错不重复
+repo.insert(CH, { seq: 1, type: 'a2a.message', at: 'x', agentId: AG_A, taskId: null, payload: {} })
+ok('insert 幂等(同 seq 重插)', repo.count(CH) === 12, `count=${repo.count(CH)}`)
+
+// agentId 过滤
+const aRecent = repo.listRecent(CH, 10, { agentId: AG_A })
+ok('agentId 过滤仅返回该 agent', aRecent.length === 7 && aRecent.every(e => e.agentId === AG_A), `n=${aRecent.length}`)
+ok('listRecent 正序返回', aRecent[0]!.seq === 1 && aRecent.at(-1)!.seq === 12)
+
+// excludeTypes:剔除 delta 后 A 的历史只剩实质帧
+const aNoDelta = repo.listRecent(CH, 100, { agentId: AG_A, excludeTypes: ['agent.delta'] })
+ok('agentId + excludeTypes 组合', aNoDelta.length === 4 && aNoDelta.every(e => e.type !== 'agent.delta'),
+  `types=[${aNoDelta.map(e => e.type).join(',')}]`)
+
+// count 同口径
+ok('count 尊重过滤条件', repo.count(CH, { agentId: AG_A, excludeTypes: ['agent.delta'] }) === 4)
+
+// beforeSeq 翻页(A 视角:seq < 8 且剔除 delta → 1、4 两帧)
+const aBefore = repo.listBefore(CH, 8, 10, { agentId: AG_A, excludeTypes: ['agent.delta'] })
+ok('listBefore + 过滤组合', aBefore.length === 2 && aBefore.map(e => e.seq).join(',') === '1,4',
+  `seqs=[${aBefore.map(e => e.seq).join(',')}]`)
+
+// 无过滤路径向后兼容(旧签名)
+const plain = repo.listRecent(CH, 3)
+ok('无过滤调用向后兼容', plain.length === 3 && plain.at(-1)!.seq === 12)
+
+// payload 反序列化
+ok('payload JSON 反序列化', aRecent[0]!.payload != null && JSON.stringify(aRecent[0]!.payload).includes('"t"'))
+
+// ---------- 2. 生产库只读抽查 ----------
+console.log('[2] 生产库只读抽查(data/workshop.sqlite)')
+try {
+  const prod = new DatabaseSync('data/workshop.sqlite', { readOnly: true })
+  const prodRepo = createChannelEventRepo(prod)
+  const row = prod.prepare(`SELECT channel_id, MAX(agent_id) ag FROM channel_events WHERE type='a2a.message' AND agent_id IS NOT NULL AND agent_id != '' GROUP BY channel_id ORDER BY COUNT(*) DESC LIMIT 1`).get() as { channel_id: string, ag: string } | undefined
+  if (!row) {
+    console.log('  (生产库无 a2a.message 样本,跳过)')
+  }
+  else {
+    const ch = row.channel_id
+    const totalMsg = (prod.prepare(`SELECT COUNT(*) n FROM channel_events WHERE channel_id=? AND type='a2a.message'`).get(ch) as { n: number }).n
+    // 全局 200 帧窗口(含 delta)里的消息数
+    const winMsg = (prod.prepare(`SELECT COUNT(*) n FROM channel_events WHERE channel_id=? AND seq > (SELECT MAX(seq)-200 FROM channel_events WHERE channel_id=? ) AND type='a2a.message'`).get(ch, ch) as { n: number }).n
+    // agent 维度 + 剔除 delta 的 200 帧
+    const laneList = prodRepo.listRecent(ch, 200, { agentId: row.ag, excludeTypes: ['agent.delta'] })
+    const laneMsg = laneList.filter(e => e.type === 'a2a.message').length
+    console.log(`  channel ${ch.slice(0, 8)} · agent ${row.ag.slice(0, 8)}:`)
+    ok('全局 200 帧窗口被流式帧淹没(复现根因)', winMsg < totalMsg, `窗口内消息 ${winMsg}/${totalMsg}`)
+    ok('agent 维度过滤取回完整消息', laneMsg > winMsg, `lane 内消息 ${laneMsg} > 全局窗口 ${winMsg}`)
+    prod.close()
+  }
+}
+catch (err) {
+  console.log(`  (生产库不可读,跳过:${err instanceof Error ? err.message : String(err)})`)
+}
+
+console.log(failures === 0 ? '\n全部通过 ✔' : `\n${failures} 项失败 ✘`)
+process.exit(failures === 0 ? 0 : 1)