@tencent-ai/agent-sdk 0.3.162 → 0.3.164

package/cli/CHANGELOG.md

@@ -7,6 +7,54 @@ 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
+
+### 🎉 新功能
+
+- **Trace 错误/取消可观测性**：trace 列表新增 `errorCount` / `firstErrorMessage` / `firstErrorWhere` 预览字段，详情页新增按工具/agent 分组的错误总览面板，可一键跳转到首个错误 span。Web UI 顶部新增状态过滤 tab（全部 / 错误 / 运行中 / 已取消 / 成功），列表行错误高亮、Timeline 视图支持「仅错误」筛选，错误信息支持一键复制。
+
+### 🐛 修复
+
+- **X-Agent-Intent 请求头**：修复 ask 模式下上报为 craft 的问题，现从 session 元数据正确读取实际模式。
+- **Trace 拒绝场景 UI 显示空白**：模型在 `finish_reason=tool_calls` 时即结束 trace，远早于用户点击拒绝；导致拒绝路径产生的 cancelled span 无处落盘，trace 页面看不到任何节点。新增 `flushSession` / `recordCancelledToolSpan` 能力，支持三级 fallback（活跃 trace / 已落盘 trace 原子重写）确保 cancelled span 完整持久化。结构化分类按真实拒绝来源（默认拒绝 / 权限拒绝 / 计划拒绝 / 询问取消）写入 `cancel_reason`，trace UI 可据此分组过滤。
+- **同步子 agent 执行时 spinner 异常隐藏**：sub-agent 状态镜像失败时主 session 卡在 idle，但 TaskManager 中仍有运行中任务。loading-box 现以仍在运行的同步任务作为 spinner 兜底依据，与主 session run state 解耦。
+- **拒绝工具调用后协议提示词原样渲染**：识别后端写入 result 的协议级文本（用户拒绝工具调用 / 拒绝退出计划模式两种变体），UI 上替换为简短中文标识，避免奇怪的英文提示泄露给用户。
+- **取消 span 视觉区分**：详情面板将 `status='cancelled'` 的 span 错误信息用中性灰色 banner 展示（而非红色错误样式），避免取消看起来像真实失败。
+
 ## [2.100.2] - 2026-06-01
 
 ### 🐛 修复