agentworkshop 0.7.34 → 0.7.37

package/scripts/town-demo-seed.mjs

@@ -1,75 +0,0 @@
-/**
- * 小镇演示数据准备(dev server :3000):注册用户 → workspace → channel(lead+2 worker, mock)
- * → 挂载 → 场景布局(放置领地)→ 泵机设备孪生 → 提交任务 + 制造 A2A 对话(气泡活动)。
- * 运行: node scripts/town-demo-seed.mjs [--base http://127.0.0.1:3000]
- */
-const BASE = (process.argv.find(a => a.startsWith('--base='))?.slice(7) ?? 'http://127.0.0.1:3000') + '/api/workshop'
-const sleep = ms => new Promise(r => setTimeout(r, ms))
-
-async function api(method, path, { token, body } = {}) {
-  const headers = { 'content-type': 'application/json' }
-  if (token) headers.authorization = `Bearer ${token}`
-  const r = await fetch(`${BASE}${path}`, { method, headers, body: body ? JSON.stringify(body) : undefined })
-  return { status: r.status, json: await r.json().catch(() => null) }
-}
-
-const name = 'town-demo-' + Math.random().toString(36).slice(2, 7)
-const u = await api('POST', '/users/register', { body: { name } })
-const token = u.json?.data?.token
-if (!token) {
-  console.error('注册失败', u.json)
-  process.exit(1)
-}
-console.log('user:', name, 'token:', token)
-
-const ws = await api('POST', '/workspaces', { token, body: { name: '工业孪生演示工作区' } })
-const wsId = ws.json?.data?.id ?? ws.json?.data?.workspaceId
-console.log('workspace:', wsId)
-
-const ch = await api('POST', '/channels', { token, body: { name: '工业孪生演示频道', description: 'RPG 2.5D 小镇演示' } })
-const cid = ch.json?.data?.channelId
-console.log('channel:', cid)
-await api('POST', `/channels/${cid}/agents`, { token, body: { name: '调度主管', harness: 'mock', role: 'lead' } })
-await api('POST', `/channels/${cid}/agents`, { token, body: { name: '数据工程师', harness: 'mock', role: 'worker' } })
-await api('POST', `/channels/${cid}/agents`, { token, body: { name: '运维工程师', harness: 'mock', role: 'worker' } })
-
-if (wsId && cid) await api('POST', `/workspaces/${wsId}/channels/${cid}`, { token })
-
-// 场景布局:把频道领地放到世界中央偏左(工业园东区)
-await api('PUT', `/scene/layouts/${cid}`, { token, body: { x: 1150, z: 1500, radiusX: 320, radiusZ: 210, shape: 'ellipse', rotationY: 0 } })
-// 第二块领地(同用户再建一个频道,形成"园区"群像)
-const ch2 = await api('POST', '/channels', { token, body: { name: '设备在线监测组', description: '孪生设备监控' } })
-const cid2 = ch2.json?.data?.channelId
-await api('POST', `/channels/${cid2}/agents`, { token, body: { name: '监测主管', harness: 'mock', role: 'lead' } })
-await api('POST', `/channels/${cid2}/agents`, { token, body: { name: '巡检员', harness: 'mock', role: 'worker' } })
-if (wsId && cid2) await api('POST', `/workspaces/${wsId}/channels/${cid2}`, { token })
-await api('PUT', `/scene/layouts/${cid2}`, { token, body: { x: 1950, z: 1520, radiusX: 250, radiusZ: 170, shape: 'rect', rotationY: 18 } })
-
-// 泵机设备孪生(工业园中央)+ 高清遥测
-await api('POST', '/device-twins', {
-  token,
-  body: {
-    name: '循环泵 #01', modelRef: 'pump', kind: 'device',
-    posX: 1580, posZ: 1560, rotationY: 30, scale: 1.6,
-    controls: ['start', 'stop'],
-    telemetry: { rpm: 2960, pressure: 0.82, temp: 63, vibration: 3.4 },
-  },
-})
-
-// 提交任务 → mock 闭环,产生大量事件/气泡
-const t = await api('POST', `/channels/${cid}/tasks`, { token, body: { title: '巡检泵组并汇报', description: '就地巡检 01/02 号循环泵' } })
-console.log('task:', t.json?.data?.id)
-await sleep(2500)
-
-// 制造 A2A 对话气泡(lead → 数据工程师 / 运维工程师)
-const agents = (await api('GET', `/channels/${cid}/agents`, { token })).json?.data ?? []
-const lead = agents.find(a => a.role === 'lead')
-const w = agents.filter(a => a.role === 'worker')
-for (const worker of w) {
-  await api('POST', '/a2a/send', {
-    token: lead?.token,
-    body: { toAgentId: worker.id, parts: [{ text: `巡检完成,请汇总 ${worker.name} 负责的泵组运行数据` }] },
-  })
-}
-console.log('演示数据就绪')
-console.log('DIALOG_READY token=' + token)

package/scripts/town-scene-clear.mjs

@@ -1,56 +0,0 @@
-/** 一次性:清空数字孪生场景实例(非破坏)
- *  - 数采/数控节点:PATCH posX/posZ = null(解除落位,实体保留在左轨树)
- *  - 频道布局(含领地/积木):逐个 DELETE /scene/layouts/:cid
- *  - 设备孪生保留(绑定测试锚点;API 无损清位不支持,如需删除可在 UI 逐台删)
- */
-const BASE = 'http://127.0.0.1:3000'
-const login = await fetch(`${BASE}/api/users/login`, {
-  method: 'POST',
-  headers: { 'content-type': 'application/json' },
-  body: JSON.stringify({ email: process.env.E2E_USER ?? 'zhangwei@awshop.io', password: process.env.E2E_PASS ?? 'Awshop@123' }),
-}).then(r => r.json())
-const H = { 'authorization': `Bearer ${login.data.token}`, 'content-type': 'application/json' }
-
-const daq = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
-const daqPlaced = daq.data.nodes.filter(n => typeof n.posX === 'number')
-let daqDone = 0
-for (const n of daqPlaced) {
-  const r = await fetch(`${BASE}/api/workshop/daq/${n.id}`, {
-    method: 'PATCH', headers: H, body: JSON.stringify({ posX: null, posZ: null }),
-  })
-  if (r.ok) daqDone++
-}
-console.log(`daq unplaced: ${daqDone}/${daqPlaced.length}`)
-
-const dcw = await fetch(`${BASE}/api/workshop/dcw`, { headers: H }).then(r => r.json())
-const dcwPlaced = dcw.data.nodes.filter(n => typeof n.posX === 'number')
-let dcwDone = 0
-for (const n of dcwPlaced) {
-  const r = await fetch(`${BASE}/api/workshop/dcw/${n.id}`, {
-    method: 'PATCH', headers: H, body: JSON.stringify({ posX: null, posZ: null }),
-  })
-  if (r.ok) dcwDone++
-}
-console.log(`dcw unplaced: ${dcwDone}/${dcwPlaced.length}`)
-
-const layouts = await fetch(`${BASE}/api/workshop/scene/layouts`, { headers: H }).then(r => r.json())
-const items = layouts.data?.layouts ?? layouts.data?.items ?? []
-let layDone = 0
-for (const it of items) {
-  const cid = it.channelId ?? it.id
-  if (!cid) continue
-  const r = await fetch(`${BASE}/api/workshop/scene/layouts/${cid}`, { method: 'DELETE', headers: H })
-  if (r.ok) layDone++
-}
-console.log(`layouts removed: ${layDone}/${items.length}`)
-
-// 复核
-const daq2 = await fetch(`${BASE}/api/workshop/daq`, { headers: H }).then(r => r.json())
-const dcw2 = await fetch(`${BASE}/api/workshop/dcw`, { headers: H }).then(r => r.json())
-const lay2 = await fetch(`${BASE}/api/workshop/scene/layouts`, { headers: H }).then(r => r.json())
-console.log('verify → placed daq:', daq2.data.nodes.filter(n => typeof n.posX === 'number').length,
-  '| placed dcw:', dcw2.data.nodes.filter(n => typeof n.posX === 'number').length,
-  '| layouts:', (lay2.data?.layouts ?? []).length,
-  '| daq entities kept:', daq2.data.nodes.length,
-  '| dcw entities kept:', dcw2.data.nodes.length)
-console.log('scene clear done')

package/scripts/verify-exec-modes-report.ts

@@ -1,248 +0,0 @@
-/**
- * 执行模式验证报告(mock lead)— goal / pipeline / loop 三模式端到端 + goal 模式总结性输出。
- *
- * 验证目标:
- *  - goal:    lead 判定目标满足后必须产出「目标完成总结」(goal-summary artifact,结论化最终描述)
- *  - pipeline:按阶段顺序执行,阶段交接传递上一阶段成果,完成后父任务汇总交付
- *  - loop:    定时循环重放,达到 maxIterations 后停止,每轮完整完成
- *
- * 运行:pnpm tsx scripts/verify-exec-modes-report.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 { createAgentImpl } from '../server/services/workshop/agents/factory'
-import type { AgentChannelManager } from '../server/services/workshop/runtime/manager'
-import type { WorkspaceTask, TaskState } from '../server/services/workshop/types/task'
-
-let failures = 0
-let passes = 0
-function check(name: string, ok: boolean, detail = ''): void {
-  console.log(`${ok ? '  ✓' : '  ✗'} ${name}${detail ? ` — ${detail}` : ''}`)
-  if (ok) passes += 1
-  else failures += 1
-}
-
-const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
-async function waitUntil(cond: () => boolean, timeoutMs: number): Promise<boolean> {
-  const deadline = Date.now() + timeoutMs
-  while (Date.now() < deadline) {
-    if (cond()) return true
-    await sleep(30)
-  }
-  return cond()
-}
-
-interface Harness {
-  manager: AgentChannelManager
-  db: ReturnType<typeof openWorkshopDb>
-  channelId: string
-}
-
-async function setup(leadName: string, leadConfig: Record<string, unknown>, workerName = 'worker'): Promise<Harness> {
-  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 ch = await manager.createChannel({ name: `${leadName} 频道`, leadAgent: { name: leadName, harness: 'mock', config: leadConfig } })
-  await manager.addAgentToChannel({
-    channelId: ch.channelId,
-    agentId: (await manager.createAgent({ name: workerName, harness: 'mock', config: { delayMs: 15 } })).id,
-    role: 'worker',
-  })
-  manager.ensureChannelActive(ch.channelId, { tickMs: 40, stallMs: 60_000 })
-  return { manager, db, channelId: ch.channelId }
-}
-
-function getEngine(manager: AgentChannelManager) {
-  const internal = manager as unknown as {
-    getTaskEngine(): {
-      get(id: string): WorkspaceTask | undefined
-      list(channelId: string): WorkspaceTask[]
-    }
-  }
-  return internal.getTaskEngine()
-}
-
-async function teardown(h: Harness): Promise<void> {
-  await h.manager.shutdown()
-  h.db.close()
-}
-
-function artifactText(a: { parts: Array<{ text?: string, data?: unknown }> }): string {
-  return a.parts.map(p => p.text ?? JSON.stringify(p.data ?? '')).join('\n')
-}
-
-// ===== 1. GOAL 模式 =====
-async function runGoal(): Promise<void> {
-  console.log('\n[1] GOAL 模式 —— 目标满意度判定 + 完成后的总结性输出')
-  const h = await setup('lead-goal', { delayMs: 15, goalRejectRounds: 1 })
-  try {
-    const engine = getEngine(h.manager)
-    const criteria = '设计文档需覆盖需求清单、架构与测试要点'
-    const task = await h.manager.submitChannelTask({
-      channelId: h.channelId,
-      title: '交付完整设计文档',
-      description: '输出一份完整设计文档',
-      mode: 'goal',
-      modeConfig: { goalCriteria: criteria },
-    })
-    const done = await waitUntil(() => engine.get(task.id)?.state === 'COMPLETED', 20_000)
-    const root = engine.get(task.id)!
-    const children = engine.list(h.channelId).filter(t => t.parentId === task.id)
-
-    console.log(`  主任务: "${root.title}" state=${root.state} 子任务数=${children.length}`)
-    check('主任务最终 COMPLETED', done, `state=${String(root.state)}`)
-    check('判定未满足 → 补充分发 1 轮(子任务数=2)', children.length === 2, `子任务数=${children.length}`)
-    check('补充轮在首轮完成后才创建(顺序判定)', children.length === 2 && ms(children[1]!.createdAt) >= ms(children[0]!.updatedAt))
-    check('全部子任务 COMPLETED', children.every(c => c.state === 'COMPLETED'))
-
-    // 总结性输出断言:goal-summary artifact 含结构化结论
-    const goalSummary = root.artifacts.find(a => a.name === 'goal-summary')
-    const summaryText = goalSummary ? artifactText(goalSummary) : ''
-    check('目标满足后产出 goal-summary 总结 artifact', !!goalSummary, `artifacts=${root.artifacts.map(a => a.name).join(',')}`)
-    check('总结含「目标完成总结」标题', summaryText.includes('【目标完成总结】'))
-    check('总结含目标描述', summaryText.includes(root.title))
-    check('总结含判定标准', summaryText.includes(criteria))
-    check('总结含完成过程(子任务链)', summaryText.includes('全部完成') && summaryText.includes('「'))
-    check('总结含最终成果与结论', summaryText.includes('最终成果') && summaryText.includes('结论: 目标已达成'))
-
-    console.log(`  ── goal-summary 总结内容 ──\n${summaryText.split('\n').map(l => `    ${l}`).join('\n')}`)
-  }
-  finally {
-    await teardown(h)
-  }
-}
-
-// ===== 2. PIPELINE 模式 =====
-async function runPipeline(): Promise<void> {
-  console.log('\n[2] PIPELINE 模式 —— 阶段顺序执行 + 父任务汇总交付')
-  const h = await setup('lead-pipe', { delayMs: 15 })
-  try {
-    const engine = getEngine(h.manager)
-    const stages = [
-      { name: '需求分析', description: '输出需求清单' },
-      { name: '编码实现', description: '按需求落码' },
-      { name: '测试验证', description: '回归通过' },
-    ]
-    const task = await h.manager.submitChannelTask({
-      channelId: h.channelId,
-      title: '流水线任务',
-      description: '分阶段交付',
-      mode: 'pipeline',
-      modeConfig: { stages },
-    })
-    const done = await waitUntil(() => engine.get(task.id)?.state === 'COMPLETED', 20_000)
-    const root = engine.get(task.id)!
-    const children = engine.list(h.channelId).filter(t => t.parentId === task.id)
-      .sort((a, b) => a.createdAt.localeCompare(b.createdAt))
-
-    console.log(`  主任务: "${root.title}" state=${root.state} 阶段子任务=${children.length}`)
-    check('主任务 COMPLETED', done, `state=${String(root.state)}`)
-    check('阶段子任务数 = 阶段数(3)', children.length === 3, `子任务数=${children.length}`)
-    check('阶段按序命名(Stage 1..3)', children[0]?.title.includes('Stage 1: 需求分析') === true
-    && children[1]?.title.includes('Stage 2: 编码实现') === true
-    && children[2]?.title.includes('Stage 3: 测试验证') === true)
-    check('全部阶段 COMPLETED', children.every(c => c.state === 'COMPLETED'))
-    check('阶段顺序:上一阶段完成才启动下一阶段', children.length === 3
-    && ms(children[1]!.createdAt) >= ms(children[0]!.updatedAt)
-    && ms(children[2]!.createdAt) >= ms(children[1]!.updatedAt))
-    const stage2Input = children[1]!.artifacts.flatMap(a => a.parts)
-    check('阶段交接:阶段 2 携带上一阶段成果', stage2Input.some(p => 'text' in p && p.text.includes('上一阶段成果')))
-    check('父任务汇总 artifact 存在(summary)', root.artifacts.some(a => a.name === 'summary'), `artifacts=${root.artifacts.map(a => a.name).join(',')}`)
-    const summary = root.artifacts.find(a => a.name === 'summary')
-    if (summary) {
-      const text = artifactText(summary)
-      console.log(`  ── 父任务汇总 ──\n${text.split('\n').filter(Boolean).slice(-3).map(l => `    ${l}`).join('\n')}`)
-    }
-  }
-  finally {
-    await teardown(h)
-  }
-}
-
-// ===== 3. LOOP 模式 =====
-async function runLoop(): Promise<void> {
-  console.log('\n[3] LOOP 模式 —— 定时循环重放 + maxIterations 停止')
-  const h = await setup('lead-loop', { delayMs: 15 })
-  try {
-    const engine = getEngine(h.manager)
-    const title = '循环采集任务'
-    const intervalMs = 250
-    const maxIterations = 3
-    await h.manager.submitChannelTask({
-      channelId: h.channelId,
-      title,
-      description: '周期采集',
-      mode: 'loop',
-      modeConfig: { intervalMs, maxIterations },
-    })
-    const ok = await waitUntil(() => {
-      const rounds = engine.list(h.channelId).filter(t => t.title === title && !t.parentId)
-      return rounds.length >= maxIterations && rounds.every(t => t.state === 'COMPLETED')
-    }, 20_000)
-    const rounds = engine.list(h.channelId).filter(t => t.title === title && !t.parentId)
-      .sort((a, b) => a.createdAt.localeCompare(b.createdAt))
-
-    console.log(`  主任务轮次=${rounds.length}(首轮 + ${rounds.length - 1} 次重放)`)
-    check('循环轮次达到 maxIterations(3)', ok && rounds.length === 3, `轮次=${rounds.length}`)
-    check('每轮完整完成(COMPLETED)', rounds.every(t => t.state === 'COMPLETED'))
-    check('轮次按间隔重放(时间递增)', rounds.length >= 2 && ms(rounds[1]!.createdAt) >= ms(rounds[0]!.createdAt))
-    // 达到上限后停止:800ms 内不再出现新轮次
-    const before = engine.list(h.channelId).length
-    await sleep(800)
-    const after = engine.list(h.channelId).length
-    check('达到 maxIterations 后停止重放(无新轮次)', before === after, `任务数 ${before} → ${after}`)
-    const last = rounds.at(-1)!
-    const states = rounds.map(t => t.state as TaskState).join(',')
-    console.log(`  各轮状态: ${states} | 最后一轮完成于 ${last.updatedAt.slice(11, 23)}`)
-  }
-  finally {
-    await teardown(h)
-  }
-}
-
-const ms = (iso: string) => Date.parse(iso)
-
-async function main(): Promise<void> {
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
-  console.log(' AgentWorkShop 执行模式验证报告(mock lead)')
-  console.log(' goal / pipeline / loop 三模式端到端 + 目标完成总结性输出')
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
-
-  await runGoal()
-  await runPipeline()
-  await runLoop()
-
-  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
-  console.log(` 报告汇总: ${passes} PASS / ${failures} FAIL`)
-  console.log('  1) GOAL     — 满意度判定闭环 + goal-summary 总结性输出 ✓(以断言为准)')
-  console.log('  2) PIPELINE — 阶段顺序执行 + 阶段成果交接 + 父任务汇总')
-  console.log('  3) LOOP     — 定时重放 + maxIterations 限次停止')
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
-  process.exit(failures === 0 ? 0 : 1)
-}
-
-main().catch((e) => {
-  console.error(e)
-  process.exit(1)
-})

package/scripts/verify-lead-mail.ts

@@ -1,188 +0,0 @@
-/**
- * 验证:lead 能看 Channel 全部邮件(worker 间通信)+ 调度快照携带最近邮件。
- * 复刻用户场景:
- *   lead dispatch → worker1「计算 1+1 并把结果发给 worker2 让它再加 1」
- *   worker1 经 mail 把结果发给 worker2(require_reply)→ mock worker2 自动回执结果
- *   → 断言 lead 能看到这条往返(而不只是自己的收件箱),worker 看不到全量;
- *   并断言 SchedulerLoop 快照的 mail 上下文已注入(lead 据此判断"结果已被产出",避免重复派发)。
- *
- * 运行:pnpm tsx scripts/verify-lead-mail.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 { createAgentImpl } from '../server/services/workshop/agents/factory'
-import type {
-  AgentEvent,
-  AgentInterface,
-  AgentRunContext,
-  AgentRunRequest,
-  SupervisionDecision,
-  SupervisionSnapshot,
-} from '../server/services/workshop/agents/agent-interface'
-import type { ChannelMail } from '../server/services/workshop/types/a2a'
-import { AppError } from '../server/utils/errors'
-
-let failures = 0
-function check(name: string, ok: boolean, detail = ''): void {
-  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
-  if (!ok) failures += 1
-}
-
-const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
-async function waitUntil(cond: () => boolean, timeoutMs: number): Promise<boolean> {
-  const deadline = Date.now() + timeoutMs
-  while (Date.now() < deadline) {
-    if (cond()) return true
-    await sleep(20)
-  }
-  return cond()
-}
-
-/** probe lead:真实 LLM lead 的替身——记录每轮快照收到的最近邮件(调度上下文可见性证据) */
-class ProbeLeadImpl implements AgentInterface {
-  constructor(private readonly captured: Array<{ tick: number, mail: ChannelMail[] }>) {}
-
-  async* run(_request: AgentRunRequest, _ctx: AgentRunContext): AsyncIterable<AgentEvent> {
-    // lead 的作业在 supervise 完成,run 无消息负载
-  }
-
-  async supervise(snapshot: SupervisionSnapshot, _ctx: AgentRunContext): Promise<SupervisionDecision[]> {
-    this.captured.push({ tick: snapshot.tick, mail: snapshot.mail ?? [] })
-    return []
-  }
-}
-
-async function main(): Promise<void> {
-  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),
-  }
-
-  // lead 用 probe 捕获快照邮件;worker 用 mock(收发均通过真实 mailbox/route 链路)
-  const capturedMail: Array<{ tick: number, mail: ChannelMail[] }> = []
-  const manager = createAgentChannelManager({
-    repos,
-    implFactory: (agent) => {
-      if (agent.harness === 'probe') return new ProbeLeadImpl(capturedMail)
-      return createAgentImpl(agent)
-    },
-    db,
-  })
-
-  const ch = await manager.createChannel({
-    name: 'mail 可见性验证',
-    leadAgent: { name: 'lead', harness: 'probe' },
-  })
-  const w1Tpl = await manager.createAgent({ name: 'worker1', harness: 'mock', config: { delayMs: 5 } })
-  const w2Tpl = await manager.createAgent({ name: 'worker2', harness: 'mock', config: { delayMs: 5 } })
-  await manager.addAgentToChannel({ channelId: ch.channelId, agentId: w1Tpl.id, role: 'worker' })
-  await manager.addAgentToChannel({ channelId: ch.channelId, agentId: w2Tpl.id, role: 'worker' })
-
-  manager.ensureChannelActive(ch.channelId, { tickMs: 30, stallMs: 60_000 })
-
-  const members = await manager.listChannelAgents(ch.channelId)
-  const lead = members.find(m => m.role === 'lead')!
-  const w1 = members.find(m => m.name === 'worker1')!
-  const w2 = members.find(m => m.name === 'worker2')!
-  check('团队就绪(lead + 2 workers)', !!lead && !!w1 && !!w2, `lead=${lead?.id ?? '-'} w1=${w1?.id ?? '-'} w2=${w2?.id ?? '-'}`)
-
-  // ===== 场景:lead 派发任务给 worker1,worker1 完成后 mail worker2 加 1,worker2 回执 =====
-  const task = await manager.dispatchTask(ch.channelId, lead.id, {
-    assigneeId: w1.id,
-    title: '计算 1+1',
-    description: '把计算结果 2 发给 worker2,让它再加 1',
-  })
-
-  // worker1(经真实 sendA2A 链路)→ worker2:要求回执
-  await manager.sendA2A(ch.channelId, w1.id, {
-    toAgentId: w2.id,
-    parts: [{ text: '我是 worker1:1+1=2。请帮我加 1,并把结果回给我。' }],
-    metadata: { 'x-aw-require-reply': 'true' },
-  })
-
-  // worker2(mock)自动回执 → worker1 收件箱
-  const replySeen = await waitUntil(() => {
-    const seen = capturedMail.some(c => c.mail.some(m => m.fromAgentId === w2.id && m.toAgentId === w1.id))
-    return seen
-      || repos.messages.listRecentByChannel(ch.channelId, 50).some(r => r.fromAgentId === w2.id && r.toAgentId === w1.id)
-  }, 8_000)
-  check('worker2 已回执结果(mock 自动回复)', replySeen)
-
-  // 任务由 mock worker1 正常执行完成(端到端无回归)
-  {
-    interface Eng { get(id: string): { state: string } | undefined }
-    const internal = manager as unknown as { getTaskEngine(): Eng }
-    const engine = internal.getTaskEngine()
-    const completed = await waitUntil(() => engine.get(task.id)?.state === 'COMPLETED', 8_000)
-    const state = engine.get(task.id)?.state ?? null
-    check('worker1 任务正常完成(mock 链路无回归)', completed, `state=${String(state)}`)
-  }
-
-  await sleep(120) // 等快照稳定含邮件
-
-  // ===== 断言 1:worker 看不到全量邮件(仅 lead 可全览) =====
-  let workerDenied = false
-  try {
-    await manager.listChannelMail(ch.channelId, w2.id)
-  }
-  catch (e) {
-    workerDenied = e instanceof AppError && e.code === 'SCOPE_VIOLATION'
-  }
-  check('worker2 调用 listChannelMail → SCOPE_VIOLATION(仅 lead 全览)', workerDenied)
-
-  // ===== 断言 2:lead 看得到全部邮件(含 worker 间往返与任务指派) =====
-  const all = await manager.listChannelMail(ch.channelId, lead.id)
-  const fromW1 = all.filter(m => m.fromAgentId === w1.id)
-  const fromW2 = all.filter(m => m.fromAgentId === w2.id)
-  const assign = all.filter(m => m.metadata?.['x-aw-task-kind'] === 'assign')
-  check('lead 可见全部邮件(≥3:assign + w1→w2 + w2→w1)', all.length >= 3, `count=${all.length}`)
-  check('lead 可见 worker1→worker2 的 mail 原文', fromW1.some(m => m.toAgentId === w2.id && m.parts.some(p => 'text' in p && p.text.includes('1+1=2'))))
-  check('lead 可见 worker2→worker1 的回执结果', fromW2.some(m => m.toAgentId === w1.id && m.parts.some(p => 'text' in p && p.text.includes('mock 回复'))))
-  check('lead 可见任务指派邮件(assign)', assign.length >= 1, `assign=${assign.length}`)
-  check('邮件携带投递状态与时间', all.every(m => ['pending', 'consuming', 'consumed'].includes(m.state) && !!m.createdAt))
-  check('邮件倒序(最新在前)', all.every((m, i) => i === 0 || all[i - 1]!.createdAt >= m.createdAt))
-
-  // ===== 断言 3:agentId 过滤 =====
-  const w2Only = await manager.listChannelMail(ch.channelId, lead.id, { agentId: w2.id })
-  check('agentId 过滤只含 worker2 参与邮件', w2Only.length > 0 && w2Only.every(m => m.fromAgentId === w2.id || m.toAgentId === w2.id), `count=${w2Only.length}`)
-
-  // ===== 断言 4:调度快照携带最近邮件(lead supervise 上下文可见) =====
-  const snapWithReply = capturedMail.find(c => c.mail.some(m => m.fromAgentId === w2.id && m.toAgentId === w1.id))
-  check('SchedulerLoop 快照注入最近邮件(lead supervise 上下文)', !!snapWithReply, `capturedTicks=${capturedMail.length}`)
-  const w1Context = snapWithReply ?? capturedMail.at(-1)
-  if (w1Context) {
-    const w1Mails = w1Context.mail.filter(m => m.fromAgentId === w1.id || m.toAgentId === w1.id)
-    check('快照邮件包含 worker1 的往来(含 w2 回执)', w1Mails.length >= 2, `w1Mails=${w1Mails.length}`)
-    check('快照邮件含回执原文', w1Mails.some(m => m.parts.some(p => 'text' in p && p.text.includes('mock 回复'))))
-  }
-
-  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)
-})

package/scripts/verify-page-smoke.mjs

@@ -1,87 +0,0 @@
-/**
- * 页面冒烟:无头浏览器打开 AgentWorkShop 首页 / 小镇(3D),截图留档。
- * 运行: node scripts/verify-page-smoke.mjs   (env: AW_PAGE_TOKEN 可选自动登录 token)
- */
-import puppeteer from 'puppeteer-core'
-import { mkdirSync } from 'node:fs'
-
-const BASE = process.env.AW_PAGE_BASE ?? 'http://127.0.0.1:3000'
-const TOKEN = process.env.AW_PAGE_TOKEN ?? ''
-const OUT = 'docs/audit/screenshots'
-mkdirSync(OUT, { recursive: true })
-
-const browser = await puppeteer.launch({
-  executablePath: process.env.AW_BROWSER ?? 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
-  headless: 'new',
-  args: ['--no-sandbox', '--disable-gpu', '--window-size=1560,1040'],
-})
-const page = await browser.newPage()
-await page.setViewport({ width: 1560, height: 1040 })
-
-let ok = false, err = ''
-try {
-  await page.goto(BASE, { waitUntil: 'networkidle2', timeout: 45000 })
-  await page.screenshot({ path: `${OUT}/home.png` })
-  console.log('home ok, title=' + await page.title())
-
-  if (TOKEN) {
-    // 会话 = 'token' cookie + session-restore 插件恢复登录态
-    await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
-    await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
-    // 轮询等待场景就绪(WS/快照/布局异步;避免 networkidle2 被长连接卡死)
-    for (let i = 0; i < 30; i++) {
-      const ready = await page.evaluate(() => !!window.__town?.scene)
-      if (ready) break
-      await new Promise(r => setTimeout(r, 1000))
-    }
-    await new Promise(r => setTimeout(r, 5000))
-    const state = await page.evaluate(() => ({
-      logged: !!window.__town?.scene,
-      title: document.title,
-      hasEmpty: !!document.querySelector('[data-hud="town-empty"]'),
-    }))
-    console.log('town state:', JSON.stringify(state))
-    await page.screenshot({ path: `${OUT}/town-3d.png` })
-
-    // 选中第一个 Agent → 触发员工会话台(大字号会话窗)
-    const agentSel = await page.evaluate(() => {
-      const s = window.__town?.scene
-      if (!s) return null
-      const agent = s.agents?.values?.().next?.().value
-      if (!agent) return null
-      s.setSelected?.({ kind: 'agent', id: agent.agentId })
-      return { id: agent.agentId, name: agent.name }
-    })
-    console.log('agent selected:', JSON.stringify(agentSel))
-
-    // 注入实时对话(演示头顶大字号气泡 + 员工会话台实时消费)
-    const demoCh = await fetch(`${BASE}/api/workshop/channels`, { headers: { authorization: `Bearer ${TOKEN}` } }).then(r => r.json())
-    const targetCh = (demoCh.data ?? [])[0]
-    if (targetCh?.id) {
-      const agents = await fetch(`${BASE}/api/workshop/channels/${targetCh.id}/agents`, { headers: { authorization: `Bearer ${TOKEN}` } }).then(r => r.json())
-      const lead = (agents.data ?? []).find(a => a.role === 'lead')
-      const workers = (agents.data ?? []).filter(a => a.role === 'worker')
-      for (let i = 0; i < 3; i++) {
-        const to = workers[i % workers.length]
-        if (lead?.token && to?.id) {
-          await fetch(`${BASE}/api/workshop/a2a/send`, {
-            method: 'POST',
-            headers: { 'authorization': `Bearer ${lead.token}`, 'content-type': 'application/json' },
-            body: JSON.stringify({ toAgentId: to.id, parts: [{ text: `第 ${i + 1} 批巡检数据已收到:泵组 ${i + 1} 号运行正常,继续跟进。` }] }),
-          }).catch(() => {})
-        }
-      }
-    }
-    await new Promise(r => setTimeout(r, 2600))
-    await page.screenshot({ path: `${OUT}/town-agent-chat.png` })
-  }
-  else {
-    await page.goto(`${BASE}/workshop`, { waitUntil: 'networkidle2', timeout: 30000 })
-    await page.screenshot({ path: `${OUT}/workshop.png` })
-  }
-  ok = true
-}
-catch (e) { err = String(e) }
-await browser.close()
-console.log(ok ? 'SMOKE OK' : `SMOKE FAIL: ${err}`)
-process.exit(ok ? 0 : 1)