[kimi-code-watch] 上游 #2633:/tower 多 agent 编排(v0.37.0 候选)

[FinbackYu]

变化摘要

上游合并了 /tower 命令(多 agent 编排:塔台分发任务、协调冲突、指定 reviewer、合并代码),已列入 v0.37.0 候选 changelog(release PR #2932),尚未正式发布。

具体变更

• 上游 PR: feat(agent-core): add tower command to orchestrate multi-agents MoonshotAI/kimi-code#2633 (2026-08-16 合并)
• wire manifest 新增两种持久化记录:tower_mode.enter / tower_mode.exit(记录类型 49 → 51)
• agent.status.updated 事件新增可选字段 towerMode?: boolean(与 swarmMode 同模式)
• 附带两项变化:终端启动时全局搜索索引改为按需加载;agent busy 时输入的 slash 命令改为排队/steer
• 附带机制:Tower worker 可使用 [secondary_model](reviewer 仍用 primary)

影响评估

对 HUD 依赖面无破坏性变化(全部为增量),但有四处需要提前准备:

1. wire 兼容性:HUD reducer 按设计忽略未知记录,tower_mode.enter/exit 不应造成异常——需要用含新记录的 wire fixture 锁定这个行为。
2. 展示缺口(parity 决策):HUD 已用 swarm_mode.enter/exit 渲染 [swarm] badge;Tower 模式运行时 HUD 无任何标识。需要决策是否渲染 [tower] badge。
3. fleet 聚合:Tower worker 在 git worktree 中运行,需要实测它们的 per-agent wire 是否落在 HUD 可见的会话目录里、fleet TPS/TTFT 聚合是否正确计入。
4. 成本显示的 fail-closed 交互:Tower 鼓励配置 secondary_model。若 worker 使用不同 provider,all-agent ledger 变为混合 provider,HUD 的 Session Cost 按设计整体隐藏(KI-6)。Tower 普及后"cost 突然消失"会更常见,需要文档化,或评估分 provider 拆分。

建议操作

• 构造含 tower_mode.enter/tower_mode.exit 的 wire fixture,加入回归测试(预期:忽略,不影响渲染)
• 决策是否在 mode slot 渲染 [tower](对齐 [swarm] 的 reducer 模式)
• 0.37.0 正式发布后实测一次 /tower 运行,检查 fleet 速度聚合与 agent badge 计数
• 评估 secondary_model 混合 provider 场景下 Session Cost 隐藏行为的文档/展示策略

结论

分级:WATCH(v0.37.0 候选内容,尚未正式发布)。无需立即改代码;0.37.0 发布后按 checklist 验证。

[FinbackYu]

提前准备工作已开展（v0.37.0 发布前），进展如下：

已完成

• [tower] badge 已实现并对齐 [swarm] 全链路：wire 归约（tower_mode.enter/exit → towerMode，last-wins）→ 状态持久化/迁移/backfill 投影 → summarizeMetrics 透出 → badges() 渲染。同时支持 wire 归约与 payload.towerMode 双路径。配色暂复用 accent 青色（色板其余槽位被权限/plan 占用，源码注释已说明；要区分色是一行改动）。
• fleet 样式修正：speedSegment 的 multi 判断纳入 towerMode——tower 模式只剩 1 个活跃 worker 时保持 fleet 样式而非回落 solo。
• wire fixture 回归：test/fixtures/wire-events-tower.jsonl（enter→exit 序列）+ test/render-tower.test.mjs（6 测试：badge 出现/消失、payload 路径、与 [swarm] 共存顺序、未知 tower 行不炸、getMetrics 全管道透出、单 worker fleet 样式）。
• Session Cost fail-closed 文档化：KI-6 补充 Tower + secondary_model 混合 provider → cost 整段隐藏属预期行为；README 双语同步。
• fleet 可见性调研（静态推断，结论：无需改代码）：上游 worker 是主 session 内 subagent，wire 落在 <sessionDir>/agents/agent-N/wire.jsonl 与 main 同目录，HUD 的目录约定枚举天然可见；worktree 不是进程 cwd，不影响定位。worker 动态增减对聚合健壮（每帧重扫 + settled 退出计数 + fileId 替换检测）。已知小瑕疵：死 worker bucket 不回收，长会话 state 文件缓慢膨胀（~200B/bucket）。

待 0.37.0 发布后验证

• 实测 /tower 运行：agents/ 目录出现 agent-N wire 且增长、fleet 聚合 ⚡ total t/s (N agents @avg)、resume 后续读不重复计数、动态 spawn/teardown 头数增减无报错
• tower_mode.enter 在 main wire 恰 1 行；teardown 后 /swarm on 互不干扰

全套测试 356/356 通过。改动尚未 commit。

[FinbackYu]

改动已提交到分支 upstream/0.37.0-prep（commit 8aebd94），0.37.0 发布并在本地按上方 checklist 验证通过后再合并 main。

[FinbackYu]

0.37.x 发布日核查结果：/tower 实际未发布，实测 checklist 挂起，prep 保留。

核查发现（对照 0.37.0/0.37.1/0.37.2 三版逐一验证）：

• 上游 #2633 的 merge commit 确实包含在 0.37.x tag 内，tower 代码（packages/agent-core-v2/src/features/tower/）随包分发，wire manifest 中 tower_mode.enter/exit 已是 durable 记录（协议 1.5）
• 但 tower 由 experimental flag tower 门控（towerFeature.ts / towerService.ts / skill 三处 gate），而全仓库（含当前 main）没有任何 registerFlagDefinition 注册该 flag。按 FlagService.explain() 逻辑，未注册 flag 恒为 disabled（连 master env 都无法覆盖）→ 0.37.x 用户无法触发 /tower
• 0.37.0/0.37.1/0.37.2 release notes 均未提及 tower；本地 0.37.2 真实会话 wire 中无 tower_mode.* 记录（唯一命中是工具输出里的文本提及）

结论与处置：

• 功能处于「代码在仓、上架未开」状态，「实测 /tower 运行」checklist 客观上无法执行，保持 open 等待上游正式启用
• prep 分支已改名 upstream/tower-prep（commit 8aebd94 + 479fe1a；原名 upstream/0.37.0-prep 已删除，启用版本未知故不绑版本号）。已核对 prep 实现假设与 0.37.2 实际契约一致（durable 空 payload + AgentStatusUpdated.towerMode 路径），仍然有效
• [kimi-code-watch] 上游 #2969:token_counting 记录转为持久化(v0.37.0 候选) #5（token_counting）已单独验收合并 main 并关闭；本分支上与其重复的 2 个测试文件与 main 内容一致，未来合并不冲突

验收触发条件（任一出现即恢复 checklist）：上游注册 tower flag 定义、release notes 正式宣布 /tower、或真实会话 wire 出现 tower_mode.enter 行。