agentworkshop 0.8.4 → 0.8.5

package/shared/lru.mjs

@@ -1,97 +1,97 @@
-/**
- * 有界 LRU —— 统一替换代码库里「无界 Map」与「超限整体 clear()」两种劣化写法。
- *
- * 现状问题(审计实测):
- *   · `daq-controller.ts` siblingsCache / opsWriteMemo:超限直接 clear() → 瞬时全量缓存穿透,
- *     紧接着的请求全部回源,形成周期性抖动;
- *   · `dcw-controller.ts` opsWriteMemo / `manager.ts` reflectCounts / ownerNameCache:
- *     完全无淘汰,长跑单调增长(ownerNameCache 有 TTL 判定但过期项只被覆盖、从不删除);
- *   · `monitor.ts`、`scene-events` 等处的按 key 节流表同型。
- *
- * 语义:get 命中即提升为最近使用;set 超限逐出最久未用;delete/clear 与 Map 同名。
- * 保持 Map 的迭代顺序语义(插入序 → 访问序),因此 `for (const k of lru.keys())` 仍然可用。
- */
-export class LruMap {
-  /**
-   * @param {number} max 容量上限(≥1)
-   * @param {(key:any, value:any) => void} [onEvict] 逐出回调(可选,用于联动清理外部资源)
-   */
-  constructor(max, onEvict) {
-    if (!Number.isFinite(max) || max < 1) throw new Error('LruMap: max 必须是 ≥1 的数字')
-    this.max = Math.floor(max)
-    this.onEvict = typeof onEvict === 'function' ? onEvict : null
-    /** @type {Map<any, any>} 迭代顺序 = 由旧到新 */
-    this.map = new Map()
-    this.hits = 0
-    this.misses = 0
-    this.evictions = 0
-  }
-
-  get size() { return this.map.size }
-
-  has(key) { return this.map.has(key) }
-
-  get(key) {
-    if (!this.map.has(key)) {
-      this.misses += 1
-      return undefined
-    }
-    // 访问即提升:删了重插(值不变),维持「尾部最新」
-    const v = this.map.get(key)
-    this.map.delete(key)
-    this.map.set(key, v)
-    this.hits += 1
-    return v
-  }
-
-  /** 命中返回值,未命中用 fallback 计算并写入(单一入口,避免各处手写 get/set 样板) */
-  getOrSet(key, fallback) {
-    const hit = this.get(key)
-    if (hit !== undefined) return hit
-    const v = typeof fallback === 'function' ? fallback(key) : fallback
-    this.set(key, v)
-    return v
-  }
-
-  set(key, value) {
-    if (this.map.has(key)) this.map.delete(key)
-    this.map.set(key, value)
-    // while 而非 if:max 被下调或批量写入时可一次收敛
-    while (this.map.size > this.max) {
-      const oldest = this.map.keys().next().value
-      const val = this.map.get(oldest)
-      this.map.delete(oldest)
-      this.evictions += 1
-      this.onEvict?.(oldest, val)
-    }
-    return this
-  }
-
-  delete(key) { return this.map.delete(key) }
-
-  clear() { this.map.clear() }
-
-  keys() { return this.map.keys() }
-
-  values() { return this.map.values() }
-
-  entries() { return this.map.entries() }
-
-  [Symbol.iterator]() { return this.map[Symbol.iterator]() }
-
-  stats() {
-    const total = this.hits + this.misses
-    return {
-      size: this.map.size,
-      max: this.max,
-      hits: this.hits,
-      misses: this.misses,
-      evictions: this.evictions,
-      hitRate: total === 0 ? 0 : Number((this.hits / total).toFixed(4)),
-    }
-  }
-}
-
-export function createLru(max, onEvict) {
-  return new LruMap(max, onEvict)
-}
+/**
+ * 有界 LRU —— 统一替换代码库里「无界 Map」与「超限整体 clear()」两种劣化写法。
+ *
+ * 现状问题(审计实测):
+ *   · `daq-controller.ts` siblingsCache / opsWriteMemo:超限直接 clear() → 瞬时全量缓存穿透,
+ *     紧接着的请求全部回源,形成周期性抖动;
+ *   · `dcw-controller.ts` opsWriteMemo / `manager.ts` reflectCounts / ownerNameCache:
+ *     完全无淘汰,长跑单调增长(ownerNameCache 有 TTL 判定但过期项只被覆盖、从不删除);
+ *   · `monitor.ts`、`scene-events` 等处的按 key 节流表同型。
+ *
+ * 语义:get 命中即提升为最近使用;set 超限逐出最久未用;delete/clear 与 Map 同名。
+ * 保持 Map 的迭代顺序语义(插入序 → 访问序),因此 `for (const k of lru.keys())` 仍然可用。
+ */
+export class LruMap {
+  /**
+   * @param {number} max 容量上限(≥1)
+   * @param {(key:any, value:any) => void} [onEvict] 逐出回调(可选,用于联动清理外部资源)
+   */
+  constructor(max, onEvict) {
+    if (!Number.isFinite(max) || max < 1) throw new Error('LruMap: max 必须是 ≥1 的数字')
+    this.max = Math.floor(max)
+    this.onEvict = typeof onEvict === 'function' ? onEvict : null
+    /** @type {Map<any, any>} 迭代顺序 = 由旧到新 */
+    this.map = new Map()
+    this.hits = 0
+    this.misses = 0
+    this.evictions = 0
+  }
+
+  get size() { return this.map.size }
+
+  has(key) { return this.map.has(key) }
+
+  get(key) {
+    if (!this.map.has(key)) {
+      this.misses += 1
+      return undefined
+    }
+    // 访问即提升:删了重插(值不变),维持「尾部最新」
+    const v = this.map.get(key)
+    this.map.delete(key)
+    this.map.set(key, v)
+    this.hits += 1
+    return v
+  }
+
+  /** 命中返回值,未命中用 fallback 计算并写入(单一入口,避免各处手写 get/set 样板) */
+  getOrSet(key, fallback) {
+    const hit = this.get(key)
+    if (hit !== undefined) return hit
+    const v = typeof fallback === 'function' ? fallback(key) : fallback
+    this.set(key, v)
+    return v
+  }
+
+  set(key, value) {
+    if (this.map.has(key)) this.map.delete(key)
+    this.map.set(key, value)
+    // while 而非 if:max 被下调或批量写入时可一次收敛
+    while (this.map.size > this.max) {
+      const oldest = this.map.keys().next().value
+      const val = this.map.get(oldest)
+      this.map.delete(oldest)
+      this.evictions += 1
+      this.onEvict?.(oldest, val)
+    }
+    return this
+  }
+
+  delete(key) { return this.map.delete(key) }
+
+  clear() { this.map.clear() }
+
+  keys() { return this.map.keys() }
+
+  values() { return this.map.values() }
+
+  entries() { return this.map.entries() }
+
+  [Symbol.iterator]() { return this.map[Symbol.iterator]() }
+
+  stats() {
+    const total = this.hits + this.misses
+    return {
+      size: this.map.size,
+      max: this.max,
+      hits: this.hits,
+      misses: this.misses,
+      evictions: this.evictions,
+      hitRate: total === 0 ? 0 : Number((this.hits / total).toFixed(4)),
+    }
+  }
+}
+
+export function createLru(max, onEvict) {
+  return new LruMap(max, onEvict)
+}

package/tui/README.md

@@ -1,74 +1,74 @@
-# AgentWorkShop TUI —— 终端工作台
-
-与 AgentTeam 交互作业的终端客户端(pi-tui 组件化渲染,与 WebUI 平级的瘦客户端):
-创建/切换 Channel、放置 Agent、发送任务、实时查看执行过程,以及 **HITL 待办
-(omp ask 对话框 / dcw 下发审批)的统一提醒与作答**。
-
-## 启动
-
-```bash
-aw tui                          # 或:pnpm tui / node tui/aw-tui.mjs
-aw tui --url http://127.0.0.1:3000 --token ut-xxxx --channel <名>
-```
-
-- 首次使用交互式登录(邮箱+密码);凭据落 `<配置根>/tui-auth.json`(0600,
-  已 gitignore)。也可用环境变量 `AW_TUI_EMAIL` / `AW_TUI_PASSWORD` 免交互。
-- 需要服务端已运行(`pnpm dev` 或 `aw start`)。
-
-## 界面
-
-```
-┌ 会话时间线(左)                          ┌ 监控面板(右,/monitor 开启)
-│ ◆ 你 消息 · ◆ Agent 回复 · 任务状态行    │ ┌─ 监控 <agent> · 流式中
-├ HITL 作答卡(/hitl <n> 进入作答时出现)
-├ 状态条:频道 · 输入目标 · 成员(忙 n) · HITL 待处理 n · 连接态
-└ 输入框(/ 命令补全 · ↑↓ 历史)
-```
-
-## 交互
-
-- **启动频道选择器**:TUI 就绪后弹出频道列表(↑↓ 移动 · Enter 进入 · Esc 自动进第一个);
-  随时可用 `/channel use`(无参)再次呼出。
-- **Tab 选择对话目标**:呼出成员选择器 —— 选「频道(发布任务)」= 普通文本发布正式任务;
-  选某成员 = 切换为**通信对话**并自动打开其独立监控面板。状态条实时显示当前输入目标。
-- **输入框语义**:普通文本按目标分流(频道 → 任务 / 成员 → 通信);`/task`、`/msg` 可显式指定。
-
-## 命令
-
-| 命令 | 说明 |
-|------|------|
-| `/help` | 命令列表 |
-| `/channels` | 列出我的频道 |
-| `/channel new <名> [--desc …] [--lead <名>]` | 创建频道(可选内联建 lead) |
-| `/channel use [名\|序号]` | 切换频道(无参 = 交互选择器;WS 断点续传) |
-| `/channel add <模板\|名> [--role lead\|worker] [--harness omp] [--config JSON]` | 放置 Agent 实例 |
-| `/agents` | 当前频道成员与实时状态 |
-| `/msg [<agent>] <文本…>` | 发布通信消息(缺省收件人 = 当前目标或 lead) |
-| `/send <agent\|序号> <文本…>` | 向指定 Agent 直发(忙碌时 steer 注入) |
-| `/task <标题…> [--mode goal\|loop\|pipeline] [--assignee <agent>]` | 提交正式任务 |
-| `/tasks` | 任务列表与七态/进度 |
-| `/monitor <agent\|序号\|off>` | 开/关右侧终端镜像(实时执行过程) |
-| `/hitl [序号\|off]` | 待人工处理列表/进入作答/放弃作答 |
-| `/quit` | 退出 |
-
-普通文本 = 向当前频道 lead 发送任务(`priority=task`)。
-
-## HITL 流程(与 WebUI 同一套服务端)
-
-1. Agent 需要人类确认/ask 时,服务端 hitl-registry 登记待办,所有已连接
-   客户端(WebUI 徽标 / TUI 状态条)收到 `hitl.request` 帧 → 提醒亮起。
-2. TUI:`/hitl` 看列表 → `/hitl <序号>` 进入作答卡(自动可配合 `/monitor`
-   观察现场);confirm 输 `y/n`,select 输序号,input/editor 直接输入。
-3. 回车提交 → `POST /api/workshop/hitl/respond` → extension_ui_response
-   直写 omp stdin(或 dcw 审批落定)→ `hitl.resolved` 帧 → 双端提醒消隐。
-4. 无人观看时对话框 park `security.hitl_timeout_ms`(默认 180s,仅零订阅
-   期间倒计时,有人接入终端即暂停;配 0 恢复旧的立即取消行为)。
-
-## 测试
-
-```bash
-node scripts/test-hitl-registry.ts     # 服务端 registry + park 语义(需 tsx)
-node scripts/test-tui-reducers.mjs     # AEP 帧归约
-node scripts/test-tui-commands.mjs     # 命令解析/分发
-node scripts/tui-smoke.mjs             # 无头 e2e(需 dev server 运行)
-```
+# AgentWorkShop TUI —— 终端工作台
+
+与 AgentTeam 交互作业的终端客户端(pi-tui 组件化渲染,与 WebUI 平级的瘦客户端):
+创建/切换 Channel、放置 Agent、发送任务、实时查看执行过程,以及 **HITL 待办
+(omp ask 对话框 / dcw 下发审批)的统一提醒与作答**。
+
+## 启动
+
+```bash
+aw tui                          # 或:pnpm tui / node tui/aw-tui.mjs
+aw tui --url http://127.0.0.1:3000 --token ut-xxxx --channel <名>
+```
+
+- 首次使用交互式登录(邮箱+密码);凭据落 `<配置根>/tui-auth.json`(0600,
+  已 gitignore)。也可用环境变量 `AW_TUI_EMAIL` / `AW_TUI_PASSWORD` 免交互。
+- 需要服务端已运行(`pnpm dev` 或 `aw start`)。
+
+## 界面
+
+```
+┌ 会话时间线(左)                          ┌ 监控面板(右,/monitor 开启)
+│ ◆ 你 消息 · ◆ Agent 回复 · 任务状态行    │ ┌─ 监控 <agent> · 流式中
+├ HITL 作答卡(/hitl <n> 进入作答时出现)
+├ 状态条:频道 · 输入目标 · 成员(忙 n) · HITL 待处理 n · 连接态
+└ 输入框(/ 命令补全 · ↑↓ 历史)
+```
+
+## 交互
+
+- **启动频道选择器**:TUI 就绪后弹出频道列表(↑↓ 移动 · Enter 进入 · Esc 自动进第一个);
+  随时可用 `/channel use`(无参)再次呼出。
+- **Tab 选择对话目标**:呼出成员选择器 —— 选「频道(发布任务)」= 普通文本发布正式任务;
+  选某成员 = 切换为**通信对话**并自动打开其独立监控面板。状态条实时显示当前输入目标。
+- **输入框语义**:普通文本按目标分流(频道 → 任务 / 成员 → 通信);`/task`、`/msg` 可显式指定。
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/help` | 命令列表 |
+| `/channels` | 列出我的频道 |
+| `/channel new <名> [--desc …] [--lead <名>]` | 创建频道(可选内联建 lead) |
+| `/channel use [名\|序号]` | 切换频道(无参 = 交互选择器;WS 断点续传) |
+| `/channel add <模板\|名> [--role lead\|worker] [--harness omp] [--config JSON]` | 放置 Agent 实例 |
+| `/agents` | 当前频道成员与实时状态 |
+| `/msg [<agent>] <文本…>` | 发布通信消息(缺省收件人 = 当前目标或 lead) |
+| `/send <agent\|序号> <文本…>` | 向指定 Agent 直发(忙碌时 steer 注入) |
+| `/task <标题…> [--mode goal\|loop\|pipeline] [--assignee <agent>]` | 提交正式任务 |
+| `/tasks` | 任务列表与七态/进度 |
+| `/monitor <agent\|序号\|off>` | 开/关右侧终端镜像(实时执行过程) |
+| `/hitl [序号\|off]` | 待人工处理列表/进入作答/放弃作答 |
+| `/quit` | 退出 |
+
+普通文本 = 向当前频道 lead 发送任务(`priority=task`)。
+
+## HITL 流程(与 WebUI 同一套服务端)
+
+1. Agent 需要人类确认/ask 时,服务端 hitl-registry 登记待办,所有已连接
+   客户端(WebUI 徽标 / TUI 状态条)收到 `hitl.request` 帧 → 提醒亮起。
+2. TUI:`/hitl` 看列表 → `/hitl <序号>` 进入作答卡(自动可配合 `/monitor`
+   观察现场);confirm 输 `y/n`,select 输序号,input/editor 直接输入。
+3. 回车提交 → `POST /api/workshop/hitl/respond` → extension_ui_response
+   直写 omp stdin(或 dcw 审批落定)→ `hitl.resolved` 帧 → 双端提醒消隐。
+4. 无人观看时对话框 park `security.hitl_timeout_ms`(默认 180s,仅零订阅
+   期间倒计时,有人接入终端即暂停;配 0 恢复旧的立即取消行为)。
+
+## 测试
+
+```bash
+node scripts/test-hitl-registry.ts     # 服务端 registry + park 语义(需 tsx)
+node scripts/test-tui-reducers.mjs     # AEP 帧归约
+node scripts/test-tui-commands.mjs     # 命令解析/分发
+node scripts/tui-smoke.mjs             # 无头 e2e(需 dev server 运行)
+```