@tencent-ai/agent-sdk 0.3.163 → 0.3.164

package/cli/CHANGELOG.md

@@ -7,6 +7,40 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.102.0] - 2026-06-03
+
+### 🎉 新功能
+
+- **后台任务完成主动推送**：`run_in_background` 的 bash / powershell 任务完成、失败或被终止时，会自动以 `<task-notification>` 形式注入对话流，模型在下一轮即可感知，无需再循环调用 `TaskOutput` / `BashOutput` 轮询。
+
+### 🔧 改进
+
+- **后台任务工具描述同步刷新**：bash / powershell 工具说明明确告知"完成会自动收到通知，不要 sleep/poll loop"，引导模型避免无意义的轮询占用 turn。
+- **网页获取体积限制**：远端 API 请求限制最大返回长度为 100K 字符，超过 15K 字符的内容自动触发 AI 摘要处理，降低上下文占用。
+- **网页获取并发竞争策略**：重构 `fetchWithFallback` 方法，由串行改为并发竞争模式 —— 本地 fetch（30s 超时）与远端 API fetch 并发启动，远端在 20s 内成功返回则采用其结果并取消本地请求；远端超时或失败时直接降级到已并发启动的本地 fetch。最坏总耗时从 `20s + 30s` 串行降为 `max(20s, 本地实际耗时)`。
+- **网页获取缓存机制**：fetch 结果缓存 15 分钟，命中缓存直接复用跳过网络请求。
+- **网页获取可观测性增强**：通过 `GalileoService` 上报 `webfetch.complete` / `webfetch.failed` 结构化事件，attribute 包含 source（cache / api / local）、needsSummary、apiStatus / apiContentLength / apiDurationMs、localStatus / localContentLength / localDurationMs、urlHost / urlPath（去除 querystring/hash）、totalDurationMs 等，失败上报到 logError 便于日志告警。
+- **subagent 埋点补全**：chat_message_send、chat_message_response、chat_tool_action 事件新增 `parentConversationId` 字段，与 chat_request_send 保持一致，支持 subagent / team 调用链路追踪。
+- **chat_message_status 关联字段补全**：新增 `rootRequestId`、`parentConversationId`、`agentName`、`agentType` 字段，与其他事件对齐。
+- **辅助功能埋点过滤**：prompt_suggestion、conversation_topic、context_compact 等辅助功能不再上报 chat_message_send / response，避免噪声。
+- **traceId 全链路打通**：ACP agent 生成 traceId 贯穿 Galileo session / tool 上报，便于端到端追踪单次对话请求。
+- **Tool 三件套日志**：新增 Tool start / success / error 独立上报 hook，支持工具维度的耗时与异常分析。
+- **uid resource attribute**：trace 资源属性中注入用户 ID，提升多用户环境下的日志关联能力。
+
+### 🐛 修复
+
+- **macOS 锁屏 / App Nap 唤醒后消息丢失**：长时间锁屏唤醒后，微信长轮询和企业微信群机器人长连接因系统冻结网络栈出现卡死或僵死连接，导致用户感知"消息丢了"。新增长连接活性看门狗，解冻瞬间自动 abort 卡死请求 / 重建 WebSocket，恢复正常收发；daemon 心跳与唤醒检测定时器同步去除 unref，避免被系统冻结后无法恢复。
+- **权限确认框点击后弹框不消失**：在 IDE 集成场景下，TUI 弹出工具权限确认框，按数字键 / 回车批准后弹框停留不关闭、需 ESC 才能关，但任务实际已开始执行。原因是 approve 路径先 await IDE closeTab RPC、再清空 pending$，IDE 慢响应或断连时 await 阻塞导致弹框无法及时关闭；现已调整为先同步关闭弹框再 fire-and-forget 触发 IDE 端清理，恢复点击即关的预期行为。同时移除 `useToolApprovalNavigation` 中针对 `AskUserQuestion` 的 `setImmediate` 包裹（`setAsk` 本身同步），避免 bypassPermissions 模式下 pending$ 二次 next 引发 effect 重入、`AskPanel` 永不挂载的竞态。
+- **企业策略导致创建任务超时**：暂时关闭 CLI 端的企业自定义模型策略与企业技能上传策略，修复其导致的创建任务超时问题。
+- **模型思考强度切换异常**：修复切换到非思考模型后仍可能携带上一轮思考强度的问题，并过滤非法思考强度配置，避免错误值进入最终请求。
+- **team agent respawn 关联字段丢失**：respawn 时恢复 `rootRequestId` 和 `parentConversationId`，修复 `.meta.json` 缺失导致关联字段丢失的问题。
+- **EditTool 创建新文件死循环**：`old_string=''` 且目标文件不存在时跳过 `hasBeenRead` 校验，让 Edit 工具能像 Write 一样创建新文件。修复此前"Edit 报先 Read，Read 又报文件不存在"的死循环。
+- **EditTool 错误信息附带 file_path**：`Edit error` / "File has not been read yet" / "File has been modified since read" 等错误消息现已带上具体文件绝对路径，并行多文件 Edit 失败时模型 / 用户能直接定位是哪个文件出问题，无需再翻 tool_call args。
+
+### 📝 文档更新
+
+- **故障排查文档新增"权限确认框无响应"章节**：在 troubleshooting 中列出 `[Approve]` / `[Reject]` / `[dequeue]` / `[tool-permission]` 关键日志 TAG 与"现象 → 推断"对照表，便于复现 / 定位同类弹框卡死问题。
+
 ## [2.101.0] - 2026-06-02
 
 ### 🎉 新功能