agentworkshop 0.7.37 → 0.7.38

package/scripts/.mimosa/hook-state/sess_aeaecb58-8833-4b83-b93c-050467d21e03.mtxwtxme-61028-1f4519fbc4.baseline/461feca1c14a695eb8b0f17a6f95fe97eeceabc0510faaea4ba6d25bde147d8d.source

@@ -0,0 +1,217 @@
+/**
+ * E2E:Lead 执行中自主团队管理(成员 创建/更新/删除 + 孤儿任务回收)。
+ *
+ * 覆盖面:
+ *  1. 工具注入按角色差异化:hostToolsForRole(worker 剔除调度/团队管理;lead 全量含新工具)
+ *  2. 决策路径:mock lead 首个 supervise tick 发 spawn_agent → SchedulerLoop 执行 → 新成员入册
+ *  3. 工具桥路径(与 omp host tool 同源):manager.createTeamMember/updateTeamMember/removeTeamMember
+ *     - 权限:worker 调用 → 403;lead 改/删自己 → 400
+ *     - 事件:AEP agent.member(op=added/updated/removed,by=lead:<id>)广播
+ *  4. 新成员可被调度:queueOverview 可见 → 接收 dispatch → 完成任务
+ *  5. 孤儿任务回收:
+ *     - 排队中(ASSIGNED)成员被移除 → 任务重派给剩余最短队列成员
+ *     - 执行中(WORKING)成员被移除 → 任务 FAILED → 调度循环重试重派 → 最终 COMPLETED
+ */
+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 type { MemberChangeEvent } from '../server/services/workshop/runtime/agent-runtime'
+import { createAgentImpl } from '../server/services/workshop/agents/factory'
+import { hostToolsForRole } from '../server/services/workshop/agents/omp-agent'
+import { AppError } from '../server/utils/errors'
+
+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(50)
+  }
+  return false
+}
+
+function setup(): { manager: AgentChannelManager } {
+  const db = openWorkshopDb(':memory:')
+  const repos = {
+    users: createUserRepo(db),
+    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 }
+}
+
+async function main(): Promise<void> {
+  console.log('== 1. 工具注入按角色差异化 ==')
+  {
+    const leadTools = hostToolsForRole('lead').map(t => t.name)
+    const workerTools = hostToolsForRole('worker').map(t => t.name)
+    check('lead 拥有团队管理三工具', ['create_team_agent', 'update_team_agent', 'remove_team_agent'].every(n => leadTools.includes(n)))
+    check('worker 无团队管理/派发工具', ['create_team_agent', 'update_team_agent', 'remove_team_agent', 'dispatch_task', 'reassign_task'].every(n => !workerTools.includes(n)))
+    check('worker 保留执行/通信/记忆面', ['complete_task', 'report_progress', 'send_message_to_agent', 'search_memory', 'save_memory'].every(n => workerTools.includes(n)))
+    check('lead 保留全量(worker 工具不缺)', workerTools.every(n => leadTools.includes(n)), `lead=${leadTools.length} worker=${workerTools.length}`)
+  }
+
+  console.log('== 2. 决策路径:lead spawn_agent → 新成员入册 ==')
+  const { manager } = setup()
+  const memberEvents: MemberChangeEvent[] = []
+  const leadConfig = {
+    delayMs: 100,
+    // mock lead 首个 supervise tick 的团队管理剧本
+    teamOps: [
+      { kind: 'spawn_agent' as const, name: 'test-writer', harness: 'mock', config: { delayMs: 120 }, reason: '扩容:任务需要专职测试编写' },
+    ],
+  }
+  const { channelId, leadAgentId } = await manager.createChannel({
+    name: 'team-mgmt',
+    leadAgent: { name: 'lead', harness: 'mock', config: leadConfig },
+  })
+  manager.subscribeMemberEvents(channelId, e => memberEvents.push(e))
+  const w1tpl = await manager.createAgent({ name: 'w1', harness: 'mock', config: { delayMs: 120 } })
+  await manager.addAgentToChannel({ channelId, agentId: w1tpl.id, role: 'worker' })
+
+  const task = await manager.submitChannelTask({ channelId, title: '交付一个功能', description: '分解并完成' })
+  const spawned = await waitUntil(async () => (await manager.listChannelAgents(channelId)).some(a => a.name === 'test-writer'), 10_000)
+  check('spawn_agent 决策落地:新成员入册', spawned)
+  const spawnEvt = memberEvents.find(e => e.op === 'added' && e.name === 'test-writer')
+  check('agent.member(added) 事件广播(by=lead:…)', !!spawnEvt && spawnEvt.by === `lead:${leadAgentId}`, JSON.stringify(spawnEvt ?? null))
+  check('新成员为 worker 角色', spawnEvt?.role === 'worker')
+
+  const completed = await waitUntil(async () =>
+    (await manager.listTasks(channelId, leadAgentId!)).find(t => t.id === task.id)?.state === 'COMPLETED', 15_000)
+  check('主任务在新团队配置下正常完成', completed)
+
+  console.log('== 3. 工具桥路径:createTeamMember/updateTeamMember ==')
+  const docWriter = await manager.createTeamMember(channelId, leadAgentId!, {
+    name: 'doc-writer',
+    harness: 'mock',
+    config: { systemPromptPrefix: '你是文档专家', delayMs: 100 },
+    reason: '需要文档专员',
+  })
+  check('createTeamMember 成功返回实例', !!docWriter.id && docWriter.role === 'worker' && docWriter.harness === 'mock')
+  const templates = await manager.listAgents()
+  check('按需落模板(可复用)', templates.some(t => t.name === 'doc-writer'))
+  const renamed = await manager.updateTeamMember(channelId, leadAgentId!, docWriter.id, { name: 'doc-writer-v2', reason: '更名' })
+  check('updateTeamMember 改名生效', renamed.name === 'doc-writer-v2')
+  const updEvt = memberEvents.find(e => e.op === 'updated' && e.agentId === docWriter.id)
+  check('agent.member(updated) 事件广播', !!updEvt && updEvt.name === 'doc-writer-v2')
+
+  console.log('== 4. 权限校验 ==')
+  const workers = (await manager.listChannelAgents(channelId)).filter(a => a.role === 'worker')
+  const anyWorker = workers[0]!
+  let saw403 = false
+  try {
+    await manager.createTeamMember(channelId, anyWorker.id, { name: 'rogue', harness: 'mock' })
+  }
+  catch (err) { saw403 = err instanceof AppError && err.status === 403 }
+  check('worker 调 createTeamMember → 403', saw403)
+  let saw400self = false
+  try {
+    await manager.removeTeamMember(channelId, leadAgentId!, leadAgentId!)
+  }
+  catch (err) { saw400self = err instanceof AppError && err.status === 400 }
+  check('lead 移除自己 → 400', saw400self)
+  let saw400selfUpd = false
+  try {
+    await manager.updateTeamMember(channelId, leadAgentId!, leadAgentId!, { name: 'x' })
+  }
+  catch (err) { saw400selfUpd = err instanceof AppError && err.status === 400 }
+  check('lead 更新自己 → 400', saw400selfUpd)
+
+  console.log('== 5. 新成员可被调度 ==')
+  const testWriter = (await manager.listChannelAgents(channelId)).find(a => a.name === 'test-writer')!
+  const overview = await manager.queueOverview(channelId, leadAgentId!)
+  check('queueOverview 可见新成员', overview.some(o => o.agentId === testWriter.id))
+  // 直接以 lead 身份 dispatch 给新成员(验证完整投递链)
+  const directTask = await manager.dispatchTask(channelId, leadAgentId!, {
+    assigneeId: testWriter.id,
+    title: '编写测试用例',
+    parentTaskId: undefined,
+    description: '为核心模块编写测试',
+  })
+  const directDone = await waitUntil(async () => (await manager.getTask(channelId, leadAgentId!, directTask.id)).state === 'COMPLETED', 10_000)
+  check('新成员接取并完成任务', directDone)
+
+  console.log('== 6. 孤儿任务回收:排队中(ASSIGNED)成员移除 → 重派 ==')
+  // 造一个"排队中"任务:给启用成员连发两个任务(FIFO)——第一个进入 WORKING,
+  // 第二个滞留其信箱 ASSIGNED(排队中,未消费)——随后移除成员经回收路径重派。
+  // (注:新版有"投递失败补偿",向已禁用成员派发会被 DELIVERY_FAILED 拒绝并回收任务,
+  //  因此排队任务只可能存在于"曾可投递但未及消费"的成员队列中)
+  const idleTpl = await manager.createAgent({ name: 'idle-queue', harness: 'mock', config: { delayMs: 100 } })
+  const idleMember = await manager.addAgentToChannel({ channelId, agentId: idleTpl.id, role: 'worker' })
+  await manager.dispatchTask(channelId, leadAgentId!, {
+    assigneeId: idleMember.id,
+    title: '队列首任务',
+    description: '先被消费',
+  })
+  const queuedTask = await manager.dispatchTask(channelId, leadAgentId!, {
+    assigneeId: idleMember.id,
+    title: '排队中的任务',
+    description: '等待回收',
+  })
+  await sleep(200)
+  const queuedState = (await manager.getTask(channelId, leadAgentId!, queuedTask.id)).state
+  check('第二个任务滞留排队(ASSIGNED)', queuedState === 'ASSIGNED', queuedState)
+  const recycle = await manager.removeTeamMember(channelId, leadAgentId!, idleMember.id, '清理闲置成员')
+  check('removeTeamMember 返回回收任务列表', recycle.recycledTasks.includes(queuedTask.id), JSON.stringify(recycle.recycledTasks))
+  const afterTask = await manager.getTask(channelId, leadAgentId!, queuedTask.id)
+  check('排队任务已重派给剩余成员', afterTask.assigneeId !== idleMember.id, `→ ${afterTask.assigneeId.slice(0, 8)}`)
+  const gone = !(await manager.listChannelAgents(channelId)).some(a => a.id === idleMember.id)
+  check('成员已从名册移除', gone)
+  const rmEvt = memberEvents.find(e => e.op === 'removed' && e.agentId === idleMember.id)
+  check('agent.member(removed) 事件广播(含 reason)', !!rmEvt && rmEvt.reason === '清理闲置成员')
+  const recycleDone = await waitUntil(async () => (await manager.getTask(channelId, leadAgentId!, queuedTask.id)).state === 'COMPLETED', 10_000)
+  check('重派任务最终完成(工作不丢失)', recycleDone)
+
+  console.log('== 7. 孤儿任务回收:执行中(WORKING)成员移除 → FAILED → 重试 ==')
+  const slowTpl = await manager.createAgent({ name: 'slow-worker', harness: 'mock', config: { delayMs: 60_000 } })
+  const slowMember = await manager.addAgentToChannel({ channelId, agentId: slowTpl.id, role: 'worker' })
+  const workingTask = await manager.dispatchTask(channelId, leadAgentId!, {
+    assigneeId: slowMember.id,
+    title: '长任务',
+    description: '会被中途裁撤',
+  })
+  const isWorking = await waitUntil(async () => (await manager.getTask(channelId, leadAgentId!, workingTask.id)).state === 'WORKING', 10_000)
+  check('慢 worker 进入 WORKING', isWorking)
+  const recycle2 = await manager.removeTeamMember(channelId, leadAgentId!, slowMember.id, '执行太慢,裁撤')
+  check('执行中任务被回收(转 FAILED 待重试)', recycle2.recycledTasks.includes(workingTask.id))
+  const retryDone = await waitUntil(async () =>
+    (await manager.getTask(channelId, leadAgentId!, workingTask.id)).state === 'COMPLETED', 15_000)
+  const afterRetry = await manager.getTask(channelId, leadAgentId!, workingTask.id)
+  check('调度循环重试重派并最终完成(工作不丢失)', retryDone && afterRetry.assigneeId !== slowMember.id, `state=${afterRetry.state}, retry=${afterRetry.retryCount}`)
+
+  await manager.shutdown()
+  console.log(failures === 0 ? '\n全部通过 🎉' : `\n${failures} 项失败`)
+  process.exit(failures === 0 ? 0 : 1)
+}
+
+main().catch((err) => {
+  console.error('e2e 异常:', err)
+  process.exit(1)
+})

package/scripts/.mimosa/hook-state/sess_aeaecb58-8833-4b83-b93c-050467d21e03.mtxwtxme-61028-1f4519fbc4.baseline/4cfadbda8591f29d5e1e230dc000e701b756e850441b3900fb596a4d2f6e98c2.source

@@ -0,0 +1,301 @@
+/**
+ * ChannelRuntime 路由测试(node + tsx 直跑,无浏览器)。
+ *
+ * 覆盖:
+ *  1. 点对点直投(x-aw-target-agent)
+ *  2. 跨 channel 目标忽略
+ *  3. 任务消息直投 assignee(x-aw-task-kind)
+ *  4. 广播只达订阅者
+ *  5. 无订阅者时广播无投递
+ *  6. 订阅后广播可达
+ *
+ * 使用真实 ChannelRuntime + 真实 Mailbox(:memory:) + 3 个 fake AgentRuntime(仅 getState/enqueue 记录)。
+ */
+import { randomUUID } from 'node:crypto'
+import type { DatabaseSync } from 'node:sqlite'
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import { createMessageRepo } from '../server/services/workshop/db/message.repo'
+import type { MessageRepo } from '../server/services/workshop/db/message.repo'
+import { createSubscriptionRepo } from '../server/services/workshop/db/subscription.repo'
+import { createChannelAgentRepo } from '../server/services/workshop/db/channel-agent.repo'
+import { Mailbox } from '../server/services/workshop/runtime/mailbox'
+import { ChannelRuntime } from '../server/services/workshop/runtime/channel-runtime'
+import type { AgentRuntimeLike, TaskEngine } from '../server/services/workshop/runtime/agent-runtime'
+import type { A2AMessage } from '../server/services/workshop/types/a2a'
+import type { AgentStatusView, AgentTaskQueueView } 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
+  }
+}
+
+/** 落库一个 channel(messages.channel_id / agents.channel_id 外键依赖) */
+function seedChannel(db: DatabaseSync, id: string): void {
+  const now = new Date().toISOString()
+  db.prepare(
+    `INSERT INTO channels (id, name, description, lead_agent_id, enabled, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?)`,
+  ).run(id, id, '', null, 1, now, now)
+}
+
+/** 落库一个 Agent 实例(subscriptions.agent_id 外键依赖 channel_agents.id) */
+function seedAgent(db: DatabaseSync, id: string, channelId: string, role: 'lead' | 'worker'): void {
+  const now = new Date().toISOString()
+  db.prepare(
+    `INSERT INTO channel_agents (id, channel_id, template_id, name, harness, config_json, role, token, enabled, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+  ).run(id, channelId, null, id, 'mock', '{}', role, randomUUID(), 1, now, now)
+}
+
+function mkTask(channelId: string, assigneeId: string, title: string): WorkspaceTask {
+  return {
+    id: randomUUID(),
+    channelId,
+    assigneeId,
+    creatorId: '',
+    title,
+    state: 'ASSIGNED',
+    progress: 0,
+    retryCount: 0,
+    artifacts: [],
+    history: [],
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+  }
+}
+
+/** fake AgentRuntime:仅记录 enqueue,并透过真实 Mailbox 落库 */
+class FakeAgentRuntime implements AgentRuntimeLike {
+  readonly agentId: string
+  readonly role: 'lead' | 'worker'
+  readonly channelId: string
+  received: A2AMessage[] = []
+  readonly mailbox: Mailbox
+
+  constructor(agentId: string, role: 'lead' | 'worker', channelId: string, messages: MessageRepo) {
+    this.agentId = agentId
+    this.role = role
+    this.channelId = channelId
+    this.mailbox = new Mailbox(messages, channelId, agentId, () => {})
+  }
+
+  enqueue(message: A2AMessage): void {
+    this.received.push(message)
+    this.mailbox.enqueue(message)
+  }
+
+  getState(): 'idle' | 'busy' | 'stopped' {
+    return 'idle'
+  }
+
+  wakeMailbox(): void {}
+
+  injectSteer(message: A2AMessage): void {
+    this.enqueue(message)
+  }
+
+  getStatus(): AgentStatusView {
+    return {
+      agentId: this.agentId,
+      channelId: this.channelId,
+      role: this.role,
+      name: this.agentId,
+      state: 'idle',
+      currentTaskId: null,
+      queuedCount: 0,
+      completedCount: 0,
+    }
+  }
+
+  getQueueView(): AgentTaskQueueView {
+    return { agentId: this.agentId, channelId: this.channelId, queued: [], completed: [] }
+  }
+
+  async stop(): Promise<void> {}
+
+  emitExternal(): void {}
+}
+
+function main(): void {
+  const db = openWorkshopDb(':memory:')
+  seedChannel(db, 'ch1')
+  seedAgent(db, 'agentA', 'ch1', 'lead')
+  seedAgent(db, 'agentB', 'ch1', 'worker')
+  seedAgent(db, 'agentC', 'ch1', 'worker')
+  const messages = createMessageRepo(db)
+  const subscriptions = createSubscriptionRepo(db)
+
+  // fake TaskEngine:route 仅调用 get
+  const tasks = new Map<string, WorkspaceTask>()
+  const engine = {
+    get: (taskId: string) => tasks.get(taskId),
+    create: () => {
+      throw new Error('未使用')
+    },
+    dispatch: () => {
+      throw new Error('未使用')
+    },
+    transition: () => {
+      throw new Error('未使用')
+    },
+    applyEvent: () => {},
+    list: () => [] as WorkspaceTask[],
+    complete: () => {
+      throw new Error('未使用')
+    },
+    reassign: () => {
+      throw new Error('未使用')
+    },
+    cancel: () => {
+      throw new Error('未使用')
+    },
+    onChildCompleted: () => {},
+    queueViewOf: () => ({ queued: [], completed: [] }),
+  } as TaskEngine
+
+  const channelId = 'ch1'
+  const cr = new ChannelRuntime(channelId, { taskEngine: engine, subscriptionRepo: subscriptions, channelAgents: createChannelAgentRepo(db) })
+  const a = new FakeAgentRuntime('agentA', 'lead', channelId, messages)
+  const b = new FakeAgentRuntime('agentB', 'worker', channelId, messages)
+  const c = new FakeAgentRuntime('agentC', 'worker', channelId, messages)
+  cr.addAgent(a)
+  cr.addAgent(b)
+  cr.addAgent(c)
+
+  function routeMsg(metadata: Record<string, unknown>): A2AMessage {
+    const msg: A2AMessage = { messageId: randomUUID(), contextId: channelId, role: 'ROLE_USER', parts: [], metadata }
+    cr.route(msg)
+    return msg
+  }
+
+  function clearReceived(): void {
+    a.received = []
+    b.received = []
+    c.received = []
+  }
+
+  console.log('\n--- 基础 ---')
+  check('getAgents 返回 3 个 agent', cr.getAgents().length === 3)
+  check('lead getter 返回 lead agent', cr.lead?.agentId === 'agentA')
+
+  console.log('\n--- 1. 点对点直投 ---')
+  clearReceived()
+  const p2p = routeMsg({ 'x-aw-target-agent': 'agentB', 'x-aw-from-agent': 'agentA' })
+  check('点对点直投:目标收到', b.received.includes(p2p))
+  check('点对点直投:非目标未收到', !a.received.includes(p2p) && !c.received.includes(p2p))
+
+  console.log('\n--- 2. 跨 channel 目标忽略 ---')
+  clearReceived()
+  routeMsg({ 'x-aw-target-agent': 'agentX', 'x-aw-from-agent': 'agentA' })
+  check('跨 channel 目标忽略:无投递', a.received.length === 0 && b.received.length === 0 && c.received.length === 0)
+
+  console.log('\n--- 3. 任务消息直投 assignee ---')
+  const task = mkTask(channelId, 'agentC', '任务C')
+  tasks.set(task.id, task)
+  clearReceived()
+  const assignMsg = routeMsg({ 'x-aw-task-kind': 'assign', 'x-aw-task-id': task.id })
+  check('任务消息直投 assignee', c.received.includes(assignMsg))
+  console.log('\n--- 4. 广播只达订阅者 ---')
+  subscriptions.add(channelId, 'agentA', 'agentB') // A 订阅 B
+  clearReceived()
+  const bcastB = routeMsg({ 'x-aw-from-agent': 'agentB' })
+  check('广播只达订阅者:A 收到', a.received.includes(bcastB))
+  check('广播只达订阅者:B/C 未收到', !b.received.includes(bcastB) && !c.received.includes(bcastB))
+
+  console.log('\n--- 5. 无订阅者时广播无投递 ---')
+  clearReceived()
+  routeMsg({ 'x-aw-from-agent': 'agentC' }) // C 无订阅者
+  console.log('\n--- 6. 订阅后广播可达 ---')
+  subscriptions.add(channelId, 'agentA', 'agentC') // A 订阅 C
+  clearReceived()
+  const bcastC = routeMsg({ 'x-aw-from-agent': 'agentC' })
+  check('订阅后广播可达:A 收到 C 的广播', a.received.includes(bcastC))
+  check('订阅后广播:C 自身未收到', !c.received.includes(bcastC))
+
+  console.log('\n--- 7. 垃圾拦截(无发送人/伪造发送人/无效任务) ---')
+  clearReceived()
+  const noSender = routeMsg({ 'x-aw-target-agent': 'agentB' })
+  check('无发送人消息被拦截', !b.received.includes(noSender))
+  const fakeSender = routeMsg({ 'x-aw-target-agent': 'agentB', 'x-aw-from-agent': 'agentZ' })
+  check('伪造发送人(非成员)消息被拦截', !b.received.includes(fakeSender))
+  routeMsg({ 'x-aw-task-kind': 'assign', 'x-aw-task-id': 'task-not-exist' })
+  check('无效任务消息被拦截', a.received.length === 0 && b.received.length === 0 && c.received.length === 0)
+  const humanMsg = routeMsg({ 'x-aw-target-agent': 'agentB', 'x-aw-from-label': 'tester' })
+  check('人类消息(from-label)放行', b.received.includes(humanMsg))
+
+  console.log('\n--- 真实 Mailbox 持久化 ---')
+  void b.mailbox.peek(10).then(async (peeked) => {
+    const persisted = peeked.find(m => m.metadata?.['x-aw-target-agent'] === 'agentB')
+    check('点对点直投:Mailbox 落库 pending', persisted !== undefined, `peeked ${peeked.length} 条`)
+
+    // ===== 恰好一次认领(steer 注入 / poll_messages 读即取 / 消费循环 dequeue 三方竞争) =====
+    console.log('\n--- 恰好一次认领(原子 claim) ---')
+    // 清空 B 信箱残留(FIFO 顺序干扰):全部认领并消费
+    for (const old of await b.mailbox.peek(50)) {
+      if (b.mailbox.claim(old.messageId)) b.mailbox.markConsumed(old.messageId)
+    }
+    const raceMsg: A2AMessage = {
+      messageId: randomUUID(),
+      contextId: channelId,
+      role: 'ROLE_AGENT',
+      parts: [{ text: 'race' }],
+      metadata: { 'x-aw-target-agent': 'agentB', 'x-aw-from-agent': 'agentA', 'x-aw-msg-priority': 'immediate' },
+    }
+    b.mailbox.enqueue(raceMsg)
+    // 三个竞争方依次认领:只有第一个成功(唯一所有权 → 消息绝不双投)
+    const steerGot = b.mailbox.claim(raceMsg.messageId)
+    const pollGot = b.mailbox.claim(raceMsg.messageId)
+    const dqGot = b.mailbox.claim(raceMsg.messageId)
+    check('首竞争者(steer)认领成功', steerGot === true)
+    check('后到竞争者(poll/dequeue)认领失败', pollGot === false && dqGot === false)
+    // 认领期间消息对 peek 不可见(poll_messages 不会重复取走)
+    const visible = await b.mailbox.peek(10)
+    check('认领期间 peek 不可见', !visible.some(x => x.messageId === raceMsg.messageId))
+    // steer 放弃(deferred)→ requeue 释放回 pending → dequeue 接管
+    check('requeue 释放认领', b.mailbox.requeue(raceMsg.messageId) === true)
+    const taken = await Promise.race([
+      b.mailbox.dequeue(),
+      new Promise<A2AMessage | null>(r => setTimeout(() => r(null), 1000)),
+    ])
+    check('释放后 dequeue 取到消息', taken?.messageId === raceMsg.messageId)
+    // 终态:markConsumed 后 claim 不复活消息
+    b.mailbox.markConsumed(raceMsg.messageId)
+    check('consumed 后 claim 不复活', b.mailbox.claim(raceMsg.messageId) === false)
+
+    // ===== 同毫秒突发 FIFO(rowid 决胜回归) =====
+    // 紧密循环同步入队:大概率全部落在同一毫秒内 → dequeue 顺序必须 === 入队顺序
+    console.log('\n--- 同毫秒突发 FIFO(rowid 决胜) ---')
+    const burst: A2AMessage[] = []
+    for (let i = 0; i < 30; i++) {
+      const m: A2AMessage = {
+        messageId: randomUUID(),
+        contextId: channelId,
+        role: 'ROLE_AGENT',
+        parts: [{ text: `burst-${i}` }],
+        metadata: { 'x-aw-target-agent': 'agentB', 'x-aw-from-agent': 'agentA' },
+      }
+      b.mailbox.enqueue(m)
+      burst.push(m)
+    }
+    const textOf = (m: A2AMessage): string =>
+      (m.parts[0] && 'text' in m.parts[0] ? m.parts[0].text : '') as string
+    const takenOrder: string[] = []
+    for (let i = 0; i < burst.length; i++) {
+      const got = await Promise.race([
+        b.mailbox.dequeue(),
+        new Promise<A2AMessage | null>(r => setTimeout(() => r(null), 1000)),
+      ])
+      if (!got) break
+      takenOrder.push(textOf(got))
+    }
+    const expectOrder = burst.map(textOf)
+    check('30 条同毫秒突发按入队顺序逐条出队(FIFO)', takenOrder.join(',') === expectOrder.join(','),
+      `${takenOrder.length} 条`)
+
+    console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILURE(S)`}`)
+    process.exit(failures === 0 ? 0 : 1)
+  })
+}
+
+main()

package/scripts/.mimosa/hook-state/sess_aeaecb58-8833-4b83-b93c-050467d21e03.mtxwtxme-61028-1f4519fbc4.baseline/50ca2810cf0b248c96948994c0c404531bbad6e553166b6816b3b03bfa0f75d2.source

@@ -0,0 +1,151 @@
+/**
+ * 端到端验证:Agent 模板 → Channel → 克隆实例 → 提交任务 → 监控执行过程。
+ *
+ * 流程:
+ *  1. createAgent(name, harness, config)         → 创建 Agent 模板(可复用)
+ *  2. createChannel({ name, leadAgent })          → 创建 Channel(内部:lead 模板 + 克隆实例)
+ *  3. addAgentToChannel({ channelId, agentId })   → 把 Agent 模板克隆进 Channel(独立身份 id)
+ *  4. ensureChannelActive + submitChannelTask      → 提交任务,lead 调度,worker 执行
+ *  5. monitorChannel → 实时观察 task.status / task.progress / agent.status / agent.event
+ *
+ * 运行: npx tsx scripts/e2e-agent-channel-task.ts
+ */
+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 { 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,
+  })
+}
+
+async function main(): Promise<void> {
+  console.log('━━━ 端到端:Agent 模板 → Channel → 任务执行 → 监控 ━━━')
+  const db = openWorkshopDb(':memory:')
+  const manager = makeManager(db)
+  try {
+    // ---- 1. 创建 Agent 模板(可复用数据结构)----
+    console.log('\n--- 1. 创建 Agent 模板 ---')
+    const workerTpl = await manager.createAgent({
+      name: 'worker-执行者',
+      harness: 'mock',
+      config: { delayMs: 60 },
+    })
+    check('创建 Agent 模板成功', !!workerTpl.id)
+    check('模板无 channel 绑定(纯定义)', workerTpl.instances.length === 0)
+
+    // ---- 2. 创建 Channel(带 lead)----
+    console.log('\n--- 2. 创建 Channel ---')
+    const ch = await manager.createChannel({
+      name: '端到端演示频道',
+      description: 'Agent 模板复用 → Channel 克隆实例 → 任务监控',
+      leadAgent: { name: 'lead-主理人', harness: 'mock', config: { delayMs: 60 } },
+    })
+    check('创建 Channel 成功', !!ch.channelId && !!ch.leadAgentId)
+    check('lead 是独立实例(与 worker 模板 id 不同)', ch.leadAgentId !== workerTpl.id)
+
+    // ---- 3. 把 Agent 模板放入 Channel(克隆独立身份 id)----
+    console.log('\n--- 3. Agent 模板放入 Channel(克隆)---')
+    const worker = await manager.addAgentToChannel({
+      channelId: ch.channelId,
+      agentId: workerTpl.id,
+      role: 'worker',
+    })
+    check('克隆出独立实例 id(≠ 模板 id)', worker.id !== workerTpl.id, `inst=${worker.id.slice(0, 8)} tpl=${workerTpl.id.slice(0, 8)}`)
+    check('实例复制模板 name/harness', worker.name === 'worker-执行者' && worker.harness === 'mock')
+    const members = await manager.listChannelAgents(ch.channelId)
+    check('Channel 成员 = 1 lead + 1 worker', members.length === 2 && members.some(a => a.role === 'lead') && members.some(a => a.role === 'worker'))
+
+    // ---- 4. 激活 channel + 挂监控 ----
+    console.log('\n--- 4. 激活 channel + 挂监控 ---')
+    manager.ensureChannelActive(ch.channelId, { tickMs: 50 })
+    check('channel 已激活', manager.runtimeStatus().activeChannels.includes(ch.channelId))
+    const mon = monitorChannel(manager, ch.channelId)
+    check('监控器已启动', mon.events.some(e => e.kind === 'lifecycle'))
+
+    // ---- 5. 提交任务 ----
+    console.log('\n--- 5. 提交任务 ---')
+    const task = await manager.submitChannelTask({
+      channelId: ch.channelId,
+      title: '端到端验证任务',
+      description: '从模板创建 Agent → 克隆进 Channel → 执行任务',
+    })
+    check('任务已提交(SUBMITTED)', !!task.id && task.state === 'SUBMITTED', `state=${task.state}`)
+
+    // ---- 6. 监控执行过程(等待 COMPLETED)----
+    console.log('\n--- 6. 监控执行过程 ---')
+    const done = await mon.waitFor(e => e.kind === 'task.status' && e.state === 'COMPLETED', 10_000)
+    check('任务执行完成(COMPLETED)', done !== null)
+
+    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')
+    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 seenArtifact = mon.events.some(e => e.kind === 'agent.event' && e.event.kind === 'artifact')
+    const seenProgress = mon.events.some(e => e.kind === 'task.progress' && e.progress > 0)
+    check('监控到成员 busy → idle 状态流转', seenBusy && seenIdle)
+    check('监控到 lead dispatch(ASSIGNED 子任务)', seenAssigned)
+    check('监控到任务进入 WORKING', seenWorking)
+    check('监控到进度上报(progress > 0)', seenProgress)
+    check('监控到产物 artifact 产出', seenArtifact)
+
+    // 终态校验:主任务 COMPLETED + 有汇总成果
+    const finalTask = await manager.getTask(ch.channelId, worker.id, task.id)
+    check('主任务终态 COMPLETED', finalTask?.state === 'COMPLETED', `state=${finalTask?.state}`)
+    check('主任务有成果(artifacts)', (finalTask?.artifacts.length ?? 0) > 0, `n=${finalTask?.artifacts.length}`)
+
+    // ---- 7. 打印监控时间线 ----
+    console.log('\n--- 监控时间线 ---')
+    console.log(mon.summary())
+    mon.stop()
+  }
+  finally {
+    await manager.shutdown()
+    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)
+})