@tencent-ai/agent-sdk 0.3.154 → 0.3.157

package/cli/CHANGELOG.md

@@ -7,6 +7,49 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.98.1] - 2026-05-25
+
+### 🐛 修复
+
+- **重发 v2.98.0 失败的发版流水线**：v2.98.0 因 agent-cli publish 流水线 OOM 未能成功发布到 npm，本次以 v2.98.1 补发，内容与 v2.98.0 完全等价，请直接升级到 v2.98.1。 #43079
+- **CI：修复 agent-cli publish 流水线 OOM**：调高 `yarn build` 阶段 Node 堆内存上限（`NODE_OPTIONS=--max-old-space-size=8192`），解决正式发版流水线在打包阶段被 OOM Killer 终止的问题。 #43079
+
+## [2.98.0] - 2026-05-24
+
+### 🎉 新功能
+
+- **OpenTelemetry 自定义上报（traces）**：支持通过 OTel 标准环境变量将内部 traces 上报到自有 Collector。启用开关 `CODEBUDDY_CODE_ENABLE_TELEMETRY=1`（兼容 legacy 别名 `CLAUDE_CODE_ENABLE_TELEMETRY`），支持 `OTEL_EXPORTER_OTLP_ENDPOINT` / `OTEL_EXPORTER_OTLP_HEADERS` / `OTEL_SERVICE_NAME` 等标准变量。详见 `docs/monitoring.md`。 #41061
+- **沙箱生态资产目录白名单**：沙箱安全策略默认允许 WorkBuddy 生态资产目录和跨平台技能目录写入，减少插件、技能与连接器的访问受限问题。 #42876
+
+### 🔧 功能改进
+
+- **自动压缩窗口提升**：未配置 `maxInputTokens` 的模型，默认 auto-compact 窗口从 100k 提升到 200k token，clamp 范围 `[100k, 1M]` 保持不变。
+- **Hooks 注入 agent_id / agent_type**：所有 hook 事件 payload 补齐触发源标识，方便用户在全局 hook 里区分主会话与子 agent。 #42872
+- **Hook 去重精细化**：解决"同事件触发两次"问题。新增 `sourceId` 维度参与 dedupe key 计算；settings 跨 scope 同一 command 折叠成一份，不同插件 / 子 agent scope 各自保留一份。 #42872
+- **多源 hook 命中可观测**：同一事件命中 ≥ 2 条不同 hook 时，日志列出所有命中命令，方便自查冲突。
+- **CLI 文档补齐**：新增 `monitoring.md` 与 `codebuddy-dir.md`，完成 v2.96.1 ~ v2.97.5 共 7 个版本 release notes 的中英文同步与导航更新。
+
+### 🐛 修复
+
+- **后台 Bash 僵尸进程**：修复 `nohup` 等后台命令残留僵尸进程的问题。stdout/stderr 改为直接写文件 fd，不再依赖父进程 pipe；新增 50MB 输出看门狗（`CODEBUDDY_BASH_BG_MAX_OUTPUT_BYTES` 可调）和 `CODEBUDDY_BASH_BG_PIPE_MODE=1` 回滚开关；session 切换/退出时清理输出文件。 #42870
+- **官方 Copilot 网关保留 thinking 字段**：修复 `auto` 模型开启思考后，请求发往官方网关时 thinking 字段被过早清理的问题。 #41543
+- **压缩类型透传**：修复自动压缩与手动 `/compact` 在 ACP `_meta` 中无法区分的问题，新增 `compactType` 透传。 #41540
+- **进程终止可靠性**：修复 `dispose()` 后 `kill()` 被 `_disposed` 标志拦截、以及 `disposeAll()` exit 事件路由丢失导致 `wait()` 挂死的问题。
+
+## [2.97.5] - 2026-05-22
+
+### 🐛 修复
+
+- **专家团：修复多类卡死/无产物/异常结束问题**：本次集中修复了 4.22.x ~ 4.24.0 用户在使用专家团（包括"腾讯自选股"、"一人公司"、"专业文档生成"、"深度研究"等）时反馈的多种异常：任务异常结束无任何产物输出；子成员任务已完成但主会话卡在"思考中"无响应；专家团运行中途自行结束、制品丢失。根因覆盖 team-lead inbox 调度、成员身份解析、并发 spawn 时序、shutdown 协调等多条链路。
+- **Team：修复成员 task 已完成时 team-lead 发起 shutdown 后无回应**：成员已 `completed` 后，team-lead 调用 `SendMessage(type=shutdown_request)`，旧路径直接经 `mailbox.send` 写出 `shutdown_response`，绕过了 `SendMessage` 工具的 `handleShutdownResponse`，导致 lead 端 `ShutdownCoordinator` 永远收不到 fulfillResponse、Mode B 队列等待 `agent_end` 触发 dispatch 形成竞态。现在在 `startTeamLeadInboxPolling` 回调入口识别 `shutdown_response` 短路：调 `ShutdownCoordinator.fulfillResponse` 解锁 lead 等待，从 `TeamMemberRegistry` 摘除成员（兜底），不注入主 agent 会话、不入队 RichMessageQueue
+- **Team：修复并发 spawn 时 SendMessage 找不到对端导致消息丢失**：在主 lead 短时间内并发拉起多个成员的场景下，旧逻辑"先校验 recipient 存在再投递"会直接报错 `Recipient not found`；现对齐 "writeToMailbox first, resolve later" 策略：`resolveRecipient` 命中失败时降级一次 `TeamManager.refreshFromDisk()`，即便仍未注册也直接写入 inbox 文件并附 `notice` 字段提示
+- **Team：修复成员会话被错误认定为 team-lead，导致 inbox `from` 字段串号**：respawn 出来的成员 session 在某些边界下 `session.meta` 尚未持久化，`teamContext` 写不回，旧逻辑会把成员发出的全部消息标成 `team-lead`；现强制 materialise `session.meta`，`SendMessage` lead 分支额外校验 `session.id === team.leadSessionId`，成员 sender 解析在 in-process miss 时回落 `TeamMemberRegistry`
+- **Team：修复同毫秒并发 shutdown_request 的 ID 冲突**：lead 向多成员并行发起 shutdown 时，旧 `shutdown-${Date.now()}` 在同一 ms 内会撞 ID，第二个 pending 直接覆盖第一个；现改为 `shutdown-${recipient}-${Date.now()}-${rand}`
+- **Team：补齐进程退出时的 session-team 清理兜底**：`TeamManager` 维护本会话创建的 team 集合，进程退出时通过 `Promise.allSettled` 并发清理 `~/.codebuddy/teams/<name>/` 与 task 目录，避免长期累积污染；仅清理本进程显式创建的 team，绝不动其他会话遗留目录
+- **Agent：新增环境变量隐藏并禁用 Fork subagent**：修复线上观察到 fork subagent 递归派生导致请求量爆炸（单日 3141 条，teammate 编号涨到 fork-56）。当环境变量 `CODEBUDDY_DISABLE_FORK_SUBAGENT` 为 truthy 值时，工具描述层自动隐藏 fork-mode 段落；运行时层通过统一的 `shouldApplyForkSpecialization()` helper 在三处入口（AgentTool / AgentTask.setupPhase / AgentTask.setupSubAgentSession）一致判定，禁用时跳过 fork 特殊化；模型若仍传 `subagent_type='fork'` 会优先匹配用户自定义同名 agent，未定义则改写为 `general-purpose`，避免 "Task agent fork is not available" 报错
+- **User-Agent 头部修复**：修复 HTTP `User-Agent` 头部在缺少 `productName` 时回退到固定字符串 `WorkBuddy/unknown` 的问题，避免污染下游统计；现仅在 `productName` 存在时拼入产品名段
+
+
 ## [2.97.4] - 2026-05-21
 
 ### 🔧 功能改进