@tencent-ai/agent-sdk 0.3.158 → 0.3.160

package/cli/CHANGELOG.md

@@ -7,6 +7,76 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.100.0] - 2026-05-30
+
+### 🎉 新功能
+
+- **WaitForMcpServers 工具**：新增内置工具，允许模型主动等待正在连接中的 MCP 服务器就绪。当 MCP 服务器尚未完成连接时，可调用此工具等待（最多 5 秒），服务器连接成功后其工具将自动注入工具列表。支持等待指定服务器或全部待连接服务器，返回各服务器的连接状态（已连接/失败/需认证/已禁用/未知）。
+- **安全审查内容剔除**：当模型因安全审查终止本次回答时，本轮已产生的回答与思考内容将从有效会话中剔除，不再回传给后续请求，避免污染上下文；会话历史中以一条安全审查提示占位，重放与展示保持一致。
+
+### 🔧 功能改进
+
+- **ToolSearch 连接提示**：当 MCP 服务器配置存在但尚未连接时，ToolSearch 描述中会显示"This server is still connecting. Call WaitForMcpServers to wait for it."提示，引导模型调用等待工具。
+- **网页获取体积限制**：远端 API 请求限制最大返回长度为 100K 字符，超过 15K 字符的内容自动触发 AI 摘要处理，降低上下文占用。
+- **网页获取并发竞争策略**：重构 `fetchWithFallback` 方法，由串行改为并发竞争模式：
+  1. **同时发起**：本地 fetch（30s 超时）与远端 API fetch 并发启动
+  2. **远端优先**：远端 API 在 20s 内返回成功则采用其结果（已转 markdown，质量更高），同时通过 `AbortSignal` 取消正在进行的本地 fetch
+  3. **自动降级**：远端超时（20s）或失败时，直接 `await` 已并发启动的本地 fetch 结果
+  4. **超时由内层各自负责**：远端 20s、本地 30s 各有内部 deadline，整体最坏耗时由本地兜底（≈30s），无需外层叠加超时
+  消除了原先"远端失败后才启动本地 fetch"的串行延迟，最坏情况总耗时从 `20s + 30s` 降为 `max(20s, 本地实际耗时)`。
+- **网页获取缓存**：fetch 结果缓存 15 分钟，命中缓存时直接复用，跳过网络请求。
+- **网页获取可观测性**：通过 `GalileoService` 上报 `webfetch.complete` / `webfetch.failed` 结构化事件，attribute 包含 `source`、`needsSummary`、`fromCache`、`apiStatus` / `apiContentLength` / `apiDurationMs` / `apiErrorReason`、`localStatus` / `localContentLength` / `localDurationMs`、`contentLength` / `rawContentLength`、`urlHost` / `urlPath`、`totalDurationMs`，失败时上报到 `logError`，便于后台直接基于日志级别配告警。
+- **Bash 沙盒审批模块化**：将沙盒审批弹窗的内部编排逻辑抽离到独立模块，按 SafetyFilter 直通、Bypass 自动放行、UI 上抛三阶段拆分清晰，便于后续扩展与单测覆盖。对外行为完全保持不变（包括敏感命令的人类可读说明、120 秒超时降级、跨子会话回溯主会话等）。
+- **Bash 上下文环境变量透传**：Bash 工具子进程现在会自动透传 `$CODEBUDDY_PROJECT_DIR` / `$CODEBUDDY_SESSION_ID`（以及对应的别名），方便 skill 与用户脚本读取项目上下文，与 hook 环境保持一致。
+- **IOA 模型更新**：新增两款长上下文基础模型，下线 6 款旧版模型，并升级默认推理模型版本。
+
+### 🐛 修复
+
+- **AskUserQuestion 工具确认框**：修复偶发的工具调用永久挂起问题。新增超时兜底（默认 10 分钟）和单 waiter 路由兜底，避免 UI 消息丢失或路由分裂场景下用户回答后工具不返回。
+- **审批弹框队头切换**：修复连续两次审批弹框时第一次的回车按键被新弹框误吃导致"自动通过/拒绝"的问题。新弹框 mount 后引入 80ms 焦点 grace period，期间不消费按键。
+- **ExitPlanMode 误批准**：修复 plan 内容尚未加载完成（界面显示 "Loading plan..."）时用户回车会误批准未阅读 plan 的问题。panel 层在 plan 内容就绪前禁止聚焦。
+- **缓存命中率统计**：修复使用 GLM、DeepSeek 等 OpenAI 兼容协议时缓存命中率被统计为 0 的问题，缓存读取/写入 token 现可在所有支持的协议下正确上报。
+- **内网环境鉴权**：修复在 IOA / 内网环境切换时，API Key 偶发出现鉴权失败（401）的问题；同时优化此类错误的提示，能够区分"内置模型请求路由异常"与"自定义模型密钥配置错误"，给出更准确的排查建议。
+- **MCP 工具图片识别**：修复部分 MCP 工具（如截图类工具）返回的图片无法被模型识别、只收到一段文本的问题，模型现在能够正常"看到"工具返回的图片。
+
+### 📝 文档
+
+- **CLI 文档归档**：完成 v2.99.1 release notes 中英文同步，env-vars.md 增量翻译同步至英文版（新增 `CODEBUDDY_WAIT_FOR_MCP_SERVERS_ENABLED` 环境变量条目），导航三版本（cliConfig / cliConfigCN / cliConfigZh）同步更新。
+
+## [2.99.1] - 2026-05-28
+
+### 🔧 功能改进
+
+- **OTel Span Schema**：新增 `otel-span-schema.ts` 作为 span 名称、属性键、事件名的单一真相源，确保实现与文档一致
+- **细粒度日志开关**：支持 `OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、`OTEL_LOG_TOOL_CONTENT`、`OTEL_LOG_RAW_API_BODIES` 环境变量控制敏感数据记录
+- **Tool Span 增强**：Pre/Post Hook 支持按开关记录工具输入参数和输出内容，带 60KB 截断保护
+- **Trace 可视化**：Web UI TracesView 新增 LLM 调用统计、Cache 命中率、多模型展示等指标
+- **Galileo 监控 hook 解耦**：将 tool 打点逻辑从 trace hook 中拆分为独立的 GalileoToolPreHook / GalileoToolPostHook，职责单一
+- **Agent SLA 全指标补齐 model 维度**：ttfb / streaming / task_total / prompt_build / tool / request / cache 全链路带 model
+- **新增 agent_name / agent_purpose / conversation_request_id 维度**：支持按 agent 类型、场景、请求链路聚合分析
+- **patchName 全局注入**：所有 Galileo 上报自动携带产品 patch 标识
+- **product.json galileo 开关**：三端（主进程 / Renderer / CLI）统一受 galileo.enable 控制
+- **稳定 ACP 会话所有权**：完善 ACP 团队桥接、会话回放与消息 ID 工具的边界处理，避免会话/消息归属错位导致的渲染抖动
+- **会话状态机健壮性**：会话运行状态机移除冗余状态切换，状态推进更稳定
+- **Skill 工具描述格式优化**：将 skill 列表从 XML 标签格式改为 Markdown 列表格式，减少 token 占用
+- **Skill 描述截断阈值调整**：单条 skill 描述上限从 250 字符降至 150 字符
+- **Skill 执行结果优化**：移除工具返回内容中无意义的 `<command-message>/<command-name>/<command-args>` 标签注入
+- **工具搜索**：优化延迟工具列表的提示内容体积，减少大型 MCP 工具集合对上下文的占用
+- **帮助面板**：移除红包封面推广链接
+
+### 🐛 修复
+
+- **延迟工具加载**：修复裸名 MCP 工具通过工具搜索加载后无法正确调用的问题，确保云服务连接等工具可按预期执行
+- **自定义模型移除 extra_vars 透传**：避免把成长计划等内部上报字段透传给客户网关，仅在非自定义模型时合并 providerData
+- **权限错误提示**：修改无权限文件失败时，保留更具体的工具错误详情，减少泛化报错造成的排查成本
+- **会话压缩**：修复 `/clear` 后工程压缩仍可能带入旧会话内容的问题，将 session separator 纳入压缩边界识别
+- **修复 galileo 字段大小写**：product.json 中统一为小写 `galileo`
+
+### 📝 文档
+
+- 更新 monitoring.md，补充完整的环境变量和 span 属性参考
+- 完成 v2.99.0 release notes 中英文同步
+
 ## [2.99.0] - 2026-05-27
 
 ### 🎉 新功能

package/cli/README.md

@@ -1,6 +1,6 @@
 # CodeBuddy Code
 
-> CodeBuddy Code 是腾讯云官方智能编码工具，支持在终端、IDE 及 GitHub 上通过自然语言高效协作与开发。
+> CodeBuddy Code 是腾讯云官方智能编码工具，支持在终端、IDE 及 GitHub 上通过自然语言高效协作与开发。 
 
 ## 快速开始
 
@@ -24,3 +24,5 @@
 ## 相关链接
 - [官方文档](https://cnb.cool/codebuddy/codebuddy-code/-/blob/main/docs)
 - [产品主页](https://cnb.cool/codebuddy/codebuddy-code)
+
+<!-- last reviewed: 2026-05-28 -->