@tencent-ai/agent-sdk 0.3.206 → 0.3.210

package/cli/CHANGELOG.md

@@ -7,6 +7,67 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.119.3] - 2026-07-12
+
+### 🐛 Bug 修复
+
+- **stdio 模式 initialize 不再被慢 MCP 阻塞**：stdio / stream-json 模式下 `initialize` 握手原会被慢 MCP server 拖住（实测 ~10s）。initialize 只需 models/commands/account 元信息，本不该等 MCP readiness。新增 `configReadyDeferred` + `AgentManager.getInitializeMetadata()`，让 initialize 只等配置解析、不等 agent 注册期的 MCP settle。agent 的 MCP 装配与发消息路径保持不变，仍正确等待 MCP。#67435
+- **预热进程 MCP 加载**：修复预热进程激活后，用户级 MCP 配置（`~/.codebuddy/.mcp.json`）在激活前才落盘时无法加载、其工具进不了 ToolSearch 可用工具列表的问题。激活路径现会重读用户级 MCP 配置，确保待命后新增的 MCP server 正常生效。
+- **网络错误重试**：回滚 #59818 的 `isNetworkError` 包装后网络错误识别改动（相关 PR 存在需要重新评估的副作用），恢复到该 PR 合入前的行为。原 issue #53806 需另行修复。
+
+## [2.119.2] - 2026-07-12
+
+### 🔧 功能改进
+
+- **终端自动重连**：WebSocket 断连后按退避序列自动重连，超过最大次数回退到手动重连。
+- **PTY 流控**：基于 ACK 的流量控制机制，防止高输出场景下 WebSocket 缓冲区溢出。
+- **文件树隐藏文件切换**：支持显示/隐藏 .git、node_modules 等常见隐藏文件。
+- **文件树 Git 状态着色**：文件树节点根据 Git 状态（modified/added/deleted 等）显示对应颜色。
+- **文件树实时监听**：通过 SSE watcher 监听文件系统变化自动刷新文件树。
+- **终端链接增强**：点击目录路径自动在文件树中展开，点击文件路径同时打开编辑器并定位文件树。
+- **Folder 隔离存储**：按工作目录隔离 store 持久化（类似 VSCode workspaceStorage）。
+- **心跳容忍优化**：PTY 心跳改为双层容忍，避免系统休眠唤醒后误杀连接。
+- **zsh 提示符修复**：通过 PROMPT_EOL_MARK 环境变量消除首行 % 标记，替代之前的 exec-replace 方案。
+
+## [2.119.1] - 2026-07-11
+
+### 🐛 Bug 修复
+
+- **自定义模型输出额度**：自定义模型未显式配置最大输出 tokens 时，不再把 catalog 的模型能力上限自动作为每次请求额度。#66582
+- **积分消耗提示失真**：修复多轮对话后积分消耗显示不准确的问题，保留 conversationRequestId 直到响应/持久化路径完成消费。
+- **埋点上报**：统一规范整数字段的上报值，避免 Token 等字段包含小数时导致事件上报失败。
+
+## [2.119.0] - 2026-07-10
+
+### 🎉 新功能
+
+- **插件依赖**：支持 `dependencies` 声明、传递安装与启用、semver tag 解析、跨 marketplace allowlist、依赖冲突诊断和孤立依赖清理。
+- **插件缓存**：新安装的 marketplace 统一落到 `plugins/marketplaces/<marketplace>`，启用/安装插件时物化到 `plugins/cache/<marketplace>/<plugin>/<version>` 并写入 `installed_plugins.json`。
+- **插件能力**：支持插件 `bin/` PATH 注入、兼容的 root/data/project 与 `user_config` 环境、持久化 data 生命周期、`settings.json` allowlist、`defaultEnabled` 和完整目录说明；`themes/` 与 `monitors/` 当前仅记录为 experimental 字段，不加载到运行时。
+
+### 🔧 功能改进
+
+- **Windows 插件性能**：插件 data、MCPB、完整性检查与 Git 探测改用异步文件 I/O，Git/npm 安装不再同步阻塞主线程；MCPB 复用流式 ZIP 解压并将临时归档放入系统临时目录。
+- **Brokered Sandbox Runtime**：为 macOS 沙箱内 Python 和 Node 文件 API 接入 brokered file-token 与 host-op 链路，并新增 Node native addon 支持同步 fs API 消费 sandbox extension token；构建后复用 macOS `codesign-darwin.sh` 签名流程，避免正式发布包遗漏嵌套原生模块签名。
+- **Broker Shell 文件备份**：在 macOS broker shell 的重定向、toybox 写入和 host-op 修改前复用 ModifyBackup 备份链路；并将 `truncate` 纳入 macOS brokered toybox 入口，确保文件截断操作可触发修改前备份链路。
+- **Sandbox Telemetry**：`skipPreExecChecks=true` 下 `ExecPolicy forbidden` 仍会作为安全硬拦在 pre-exec 阶段拒绝命令，并产生 `permissionPath='new'` 与 `reason='forbidden'` 的预期埋点组合。
+- **Deep Research 输出格式化**：Workflow 返回结果从 JSON 结构改为可读的 Markdown 报告，包含摘要、发现、反驳声明和统计信息。
+- **文件撤回防复活**：Web UI 文件变更面板增加 recentlyReverted 机制，防止异步广播将已撤回的文件重新加入列表。
+- **Deferred Tool 解析兼容**：修复 SDK 传入 raw JSON string 时 Zod 校验失败的问题，通过 preprocess 自动解析。
+- **子 Agent 消息隔离**：Detached sub-agent 转发的 usage 消息不再在主对话 UI 中渲染，仅用于 token 消耗追踪。
+- **子 Agent 工具标题前缀**：Web UI 中为子 agent 内部执行的工具调用添加类型前缀显示。
+- **Skill 工具描述优化**：Skill 描述模板增加 deferred tool 优先使用 ToolSearch + DeferExecuteTool 的提示。
+- **Sub-agent 标识修正**：在 sub-agent session 中正确标记 isSubAgent 状态。
+
+### 🐛 Bug 修复
+
+- **提升多轮对话的 prompt 缓存命中率**：修复并行工具调用场景下，同一条工具结果在相邻轮次被组装进模型请求时序列化形态不一致的问题。此前仅对最后一个工具结果做归一化，并行批次中的其余结果要到下一轮才被归一化，导致缓存前缀在该处分叉、后续内容全部 miss。现统一在模型请求前对本轮所有工具结果归一化，缓存前缀不再抖动，多工具/子代理场景的缓存命中率与费用显著改善。
+- **stream-json + `--resume`**：修复 `--input-format stream-json --output-format stream-json -r <sessionId>` 场景下，`initialize` control_response 在 stdout 上被 resume 历史事件抢先写入的排序竞争。原代码在 initialize handler 尚未把响应写完前就 `initializeDeferred.resolve()`，让 resume replay 分支立刻开始把大历史流写到同一条 `process.stdout` 管道；下游（sandbox-proxy）读得慢时 initialize 响应会被卡在几十 KB 的历史事件后面，触发 sandbox-proxy 的 60s `sendControlRequest("initialize")` 超时并放大成 120s+ 的会话唤醒卡顿。改为在 `await initializeHandledPromise` 完成之后再 resolve deferred，保证 initialize 响应一定先落盘 stdout。#63837
+- **工具审批送达**：修复对话之外自动续跑（后台任务完成、错误恢复、定时/渠道触发）的执行撞到高危命令审批时，审批框无法送达客户端、用户确认不了、会话卡在等待授权状态的问题。
+- **认证初始化**：优化 apiKeyHelper 认证慢路径，避免网络配置同步抖动阻塞无头模式认证初始化。
+- **AskUserQuestion 多选回答**：修复多选题同时选择预设项和填写自定义项时，自定义内容覆盖已选项的问题。
+- **PostToolUse 图片结果**：修复 hook 返回附加上下文时破坏 `image_url` 结构化工具结果的问题，避免图片结果降级为文本或丢失。
+
 ## [2.118.2] - 2026-07-09
 
 ### 🐛 Bug 修复

package/cli/builtin/workflows/deep-research.workflow.js

@@ -158,7 +158,7 @@ const scope = await agent(
 )
 const scopeParsed = safeParse(scope, SCOPE_SCHEMA)
 if (!scopeParsed) {
-  return { error: "Scope agent returned no result — cannot decompose the research question." }
+  return "# Deep Research Report\n\n**Error:** Scope agent returned no result — cannot decompose the research question."
 }
 log("Q: " + QUESTION.slice(0, 80) + (QUESTION.length > 80 ? "…" : ""))
 log("Decomposed into " + scopeParsed.angles.length + " angles: " + scopeParsed.angles.map(a => a.label).join(", "))
@@ -309,13 +309,76 @@ const rankedClaims = [...allClaims]
 
 log("Fetched " + allSources.length + " sources → " + allClaims.length + " claims → verifying top " + rankedClaims.length)
 
+// ─── Report formatter: convert structured data to readable Markdown ───
+function formatReport(data) {
+  const lines = []
+  lines.push("# Deep Research Report")
+  lines.push("")
+  lines.push("**Question:** " + data.question)
+  lines.push("")
+
+  if (data.summary) {
+    lines.push("## Summary")
+    lines.push("")
+    lines.push(data.summary)
+    lines.push("")
+  }
+
+  if (data.findings && data.findings.length > 0) {
+    lines.push("## Key Findings")
+    lines.push("")
+    data.findings.forEach(function(f, i) {
+      var conf = f.confidence === 'high' ? '[HIGH]' : f.confidence === 'medium' ? '[MEDIUM]' : '[LOW]'
+      lines.push("### " + (i + 1) + ". " + f.claim)
+      lines.push("")
+      lines.push("- **Confidence:** " + conf + (f.vote ? " (vote: " + f.vote + ")" : ""))
+      if (f.evidence) lines.push("- **Evidence:** " + f.evidence)
+      if (f.sources && f.sources.length > 0) {
+        lines.push("- **Sources:** " + f.sources.join(", "))
+      }
+      lines.push("")
+    })
+  }
+
+  if (data.refuted && data.refuted.length > 0) {
+    lines.push("## Refuted Claims")
+    lines.push("")
+    data.refuted.forEach(function(r) {
+      lines.push("- ~~" + r.claim + "~~ (vote: " + r.vote + ", source: " + r.source + ")")
+    })
+    lines.push("")
+  }
+
+  if (data.caveats) {
+    lines.push("## Caveats")
+    lines.push("")
+    lines.push(data.caveats)
+    lines.push("")
+  }
+
+  if (data.openQuestions && data.openQuestions.length > 0) {
+    lines.push("## Open Questions")
+    lines.push("")
+    data.openQuestions.forEach(function(q) { lines.push("- " + q) })
+    lines.push("")
+  }
+
+  if (data.stats) {
+    var s = data.stats
+    lines.push("---")
+    lines.push("*Stats: " + (s.angles || 0) + " angles, " + (s.sourcesFetched || s.sources || 0) + " sources fetched, " + (s.claimsExtracted || s.claims || 0) + " claims extracted, " + (s.confirmed || 0) + " confirmed, " + (s.killed || 0) + " refuted, " + (s.agentCalls || 0) + " agent calls*")
+  }
+
+  return lines.join("\n")
+}
+
 if (rankedClaims.length === 0) {
-  return {
+  return formatReport({
     question: QUESTION,
     summary: "No claims extracted. " + allSources.length + " sources fetched, all empty/failed. " + dupes.length + " URL dupes, " + budgetDropped.length + " budget-dropped.",
-    findings: [], refuted: [], sources: allSources.map(s => ({ url: s.url, quality: s.sourceQuality })),
-    stats: { angles: scopeParsed.angles.length, sources: allSources.length, claims: 0, dupes: dupes.length },
-  }
+    findings: [], refuted: [],
+    stats: { angles: scopeParsed.angles.length, sources: allSources.length, claims: 0 },
+  })
 }
 
 // ─── Verify: 3-vote adversarial ───
@@ -351,14 +414,13 @@ const killed = voted.filter(c => !c.survives)
 log("Verify done: " + voted.length + " claims → " + confirmed.length + " confirmed, " + killed.length + " killed")
 
 if (confirmed.length === 0) {
-  return {
+  return formatReport({
     question: QUESTION,
     summary: "All " + voted.length + " claims refuted by adversarial verification. Research inconclusive — sources may be low-quality or claims overstated.",
     findings: [],
     refuted: killed.map(c => ({ claim: c.claim, vote: (c.verdicts.length - c.refutedVotes) + "-" + c.refutedVotes, source: c.sourceUrl })),
-    sources: allSources.map(s => ({ url: s.url, quality: s.sourceQuality, claimCount: s.claims.length })),
-    stats: { angles: scopeParsed.angles.length, sources: allSources.length, claims: allClaims.length, verified: voted.length, confirmed: 0, killed: killed.length },
-  }
+    stats: { angles: scopeParsed.angles.length, sources: allSources.length, claims: allClaims.length, confirmed: 0, killed: killed.length },
+  })
 }
 
 // ─── Synthesize ───
@@ -398,22 +460,19 @@ const report = safeParse(reportText, REPORT_SCHEMA)
 if (!report) {
   // Synthesis skipped/errored — salvage the verified claims raw rather
   // than throwing on report.findings and discarding the whole run.
-  return {
+  return formatReport({
     question: QUESTION,
     summary: "Synthesis step was skipped or failed — returning " + confirmed.length + " verified claims unmerged.",
-    findings: [],
-    confirmed: confirmed.map(c => ({ claim: c.claim, source: c.sourceUrl, quote: c.quote, vote: (c.verdicts.length - c.refutedVotes) + "-" + c.refutedVotes })),
+    findings: confirmed.map(c => ({ claim: c.claim, confidence: "medium", sources: [c.sourceUrl], evidence: c.quote, vote: (c.verdicts.length - c.refutedVotes) + "-" + c.refutedVotes })),
     refuted: killed.map(c => ({ claim: c.claim, vote: (c.verdicts.length - c.refutedVotes) + "-" + c.refutedVotes, source: c.sourceUrl })),
-    sources: allSources.map(s => ({ url: s.url, quality: s.sourceQuality, claimCount: s.claims.length })),
-    stats: { angles: scopeParsed.angles.length, sources: allSources.length, claims: allClaims.length, verified: voted.length, confirmed: confirmed.length, killed: killed.length, afterSynthesis: 0 },
-  }
+    stats: { angles: scopeParsed.angles.length, sourcesFetched: allSources.length, claimsExtracted: allClaims.length, confirmed: confirmed.length, killed: killed.length, agentCalls: 1 + scopeParsed.angles.length + allSources.length + (voted.length * VOTES_PER_CLAIM) + 1 },
+  })
 }
 
-return {
+return formatReport({
   question: QUESTION,
   ...report,
   refuted: killed.map(c => ({ claim: c.claim, vote: (c.verdicts.length - c.refutedVotes) + "-" + c.refutedVotes, source: c.sourceUrl })),
-  sources: allSources.map(s => ({ url: s.url, quality: s.sourceQuality, angle: s.angle, claimCount: s.claims.length })),
   stats: {
     angles: scopeParsed.angles.length,
     sourcesFetched: allSources.length,
@@ -422,8 +481,6 @@ return {
     confirmed: confirmed.length,
     killed: killed.length,
     afterSynthesis: report.findings.length,
-    urlDupes: dupes.length,
-    budgetDropped: budgetDropped.length,
     agentCalls: 1 + scopeParsed.angles.length + allSources.length + (voted.length * VOTES_PER_CLAIM) + 1,
   },
-}
+})