@tencent-ai/agent-harness 0.2.0-beta.3 → 0.2.0-beta.4

package/cli/product.selfhosted.json

@@ -1,364 +1 @@
-{
-  "agents": [
-    {
-      "name": "cli",
-      "instructions": "cli-agent-prompt",
-      "description": "cli agent",
-      "models": [
-        "codewise-chat"
-      ],
-      "modelTags": [
-        "craft"
-      ],
-      "commands": [
-        "init",
-        "compact",
-        "statusline",
-        "insights"
-      ],
-      "tools": [
-        "Agent",
-        "Read",
-        "Write",
-        "Edit",
-        "Bash",
-        "PowerShell",
-        "Glob",
-        "Grep",
-        "EnterPlanMode",
-        "ExitPlanMode",
-        "TaskCreate",
-        "TaskGet",
-        "TaskUpdate",
-        "TaskList",
-        "WebFetch",
-        "WebSearch",
-        "TaskStop",
-        "TaskOutput",
-        "Skill",
-        "AskUserQuestion",
-        "AskUserForStructuredInput",
-        "StructuredOutput",
-        "ToolSearch",
-        "DeferExecuteTool",
-        "SendMessage",
-        "SendUserMessage",
-        "TeamCreate",
-        "TeamDelete",
-        "NotebookEdit",
-        "LSP",
-        "EnterWorktree",
-        "LeaveWorktree",
-        "CronCreate",
-        "CronDelete",
-        "CronList",
-        "DelegateTool",
-        "WeChatReply",
-        "WeComReply",
-        "PushNotification",
-        "ReportFindings",
-        "ComputerUse",
-        "ListMcpResources",
-        "ReadMcpResource",
-        "WaitForMcpServers",
-        "Workflow",
-        "Monitor",
-        "REPL",
-        "A2AGetAgentCard",
-        "A2ASendMessage",
-        "A2AGetTask",
-        "A2ACancelTask"
-      ],
-      "tags": [
-        "cli",
-        "default",
-        "model:craft"
-      ]
-    },
-    {
-      "name": "general-purpose",
-      "instructions": "cli-agent-prompt",
-      "description": "general-purpose agent",
-      "tools": [
-        "Read",
-        "Write",
-        "Edit",
-        "Bash",
-        "PowerShell",
-        "Glob",
-        "Grep",
-        "TaskCreate",
-        "TaskGet",
-        "TaskUpdate",
-        "TaskList",
-        "WebFetch",
-        "WebSearch",
-        "TaskStop",
-        "TaskOutput",
-        "Skill",
-        "AskUserQuestion",
-        "AskUserForStructuredInput",
-        "ToolSearch",
-        "DeferExecuteTool",
-        "StructuredOutput",
-        "SendMessage",
-        "SendUserMessage",
-        "NotebookEdit",
-        "LSP",
-        "ComputerUse",
-        "ImageGen",
-        "ImageEdit",
-        "Artifact",
-        "ArtifactControl",
-        "ListMcpResources",
-        "ReadMcpResource",
-        "WaitForMcpServers",
-        "REPL"
-      ],
-      "tags": [
-        "cli",
-        "general-purpose"
-      ]
-    },
-    {
-      "name": "compact",
-      "instructions": "compact-agent-prompt",
-      "description": "compact agent",
-      "tools": [
-        "Read"
-      ],
-      "commands": [
-        "_compact"
-      ],
-      "tags": [
-        "cli",
-        "compact"
-      ]
-    },
-    {
-      "name": "contextSummary",
-      "instructions": "context-summary-agent-prompt",
-      "description": "Context summary agent for conversation compaction and max-token recovery",
-      "tools": [],
-      "tags": [
-        "cli",
-        "contextSummary"
-      ]
-    },
-    {
-      "name": "contentAnalyzer",
-      "instructions": "content-analyzer-agent-instructions",
-      "description": "content analyzer agent",
-      "tags": [
-        "cli",
-        "content-analyzer"
-      ],
-      "tools": []
-    },
-    {
-      "name": "terminalTitleGenerator",
-      "instructions": "terminal-title-generator-instructions",
-      "description": "Generate terminal window titles from conversation topics.",
-      "tags": [
-        "cli",
-        "terminal-title-generator"
-      ],
-      "tools": []
-    },
-    {
-      "name": "promptSuggestion",
-      "instructions": "prompt-suggestion-instructions",
-      "description": "Suggest the user's next prompt after a conversation turn.",
-      "tags": [
-        "cli",
-        "prompt-suggestion"
-      ],
-      "tools": []
-    },
-    {
-      "name": "memorySelector",
-      "instructions": "memory-selector-instructions",
-      "description": "Select relevant memories for the current query.",
-      "models": [
-        "lite"
-      ],
-      "tags": [
-        "cli",
-        "memory-selector"
-      ],
-      "tools": []
-    },
-    {
-      "name": "summaryGenerator",
-      "instructions": "summary-generator-instructions",
-      "description": "Generate session summaries from conversation content.",
-      "tags": [
-        "cli",
-        "summary-generator"
-      ],
-      "tools": []
-    },
-    {
-      "name": "autoModeClassifier",
-      "instructions": "auto-mode-classifier-instructions",
-      "description": "Classify auto mode tool permission risk.",
-      "models": [
-        "lite"
-      ],
-      "tags": [
-        "cli",
-        "auto-mode-classifier"
-      ],
-      "tools": []
-    },
-    {
-      "name": "promptHookEvaluator",
-      "instructions": "prompt-hook-evaluator-instructions",
-      "description": "Evaluates prompt hooks using LLM to determine if conditions are met",
-      "models": [
-        "lite"
-      ],
-      "tags": [
-        "cli",
-        "prompt-hook-evaluator"
-      ],
-      "tools": []
-    },
-    {
-      "name": "insightsAnalyzer",
-      "instructions": "base-agent-instructions",
-      "description": "Analyzes user usage data facets for the /insights command",
-      "tags": [
-        "cli",
-        "insights-analyzer"
-      ],
-      "tools": []
-    },
-    {
-      "name": "agentInstructions",
-      "instructions": "agent-instructions",
-      "description": "generating agent instructions",
-      "tags": [
-        "cli",
-        "agent-instructions"
-      ],
-      "tools": []
-    },
-    {
-      "name": "statusline-setup",
-      "instructions": "agent-statusline-instructions",
-      "description": "Use this agent to configure the user's Codebuddy Code status line setting.",
-      "tools": [
-        "Read",
-        "Write",
-        "Edit",
-        "ToolSearch",
-        "DeferExecuteTool"
-      ],
-      "asTool": true,
-      "tags": [
-        "cli",
-        "sub-agent"
-      ]
-    },
-    {
-      "name": "Explore",
-      "instructions": "agent-explore-instructions",
-      "description": "Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (eg. \"src/components/**/*.tsx\"), search code for keywords (eg. \"API endpoints\"), or answer questions about the codebase (eg. \"how do API endpoints work?\"). When calling this agent, specify the desired thoroughness level: \"quick\" for basic searches, \"medium\" for moderate exploration, or \"very thorough\" for comprehensive analysis across multiple locations and naming conventions.",
-      "models": [
-        "lite"
-      ],
-      "tools": [
-        "Read",
-        "Bash",
-        "PowerShell",
-        "Glob",
-        "Grep",
-        "TaskCreate",
-        "TaskGet",
-        "TaskUpdate",
-        "TaskList",
-        "WebFetch",
-        "WebSearch",
-        "Skill",
-        "SendMessage",
-        "SendUserMessage",
-        "ToolSearch",
-        "DeferExecuteTool"
-      ],
-      "asTool": true,
-      "tags": [
-        "cli",
-        "sub-agent"
-      ]
-    },
-    {
-      "name": "Plan",
-      "instructions": "agent-plan-instructions",
-      "description": "Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a multi-step task before writing code. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs. Read-only: it designs but does not modify files or exit plan mode; the caller reviews the plan and implements it.",
-      "tools": [
-        "Read",
-        "Bash",
-        "PowerShell",
-        "Glob",
-        "Grep",
-        "TaskCreate",
-        "TaskGet",
-        "TaskUpdate",
-        "TaskList",
-        "WebFetch",
-        "WebSearch",
-        "Skill",
-        "ToolSearch",
-        "DeferExecuteTool",
-        "TeamCreate",
-        "TeamDelete",
-        "SendMessage",
-        "SendUserMessage"
-      ],
-      "asTool": true,
-      "tags": [
-        "cli",
-        "sub-agent"
-      ]
-    }
-  ],
-  "models": [
-    {
-      "credits": "x0.01 credits",
-      "id": "codewise-chat",
-      "name": "Codewise-Chat",
-      "vendor": "tencent",
-      "maxOutputTokens": 8192,
-      "maxInputTokens": 128000,
-      "supportsToolCall": true,
-      "supportsImages": false,
-      "disabledMultimodal": true,
-      "maxAllowedSize": 56000
-    }
-  ],
-  "links": {
-    "officialWebsite": "https://copilot.tencent.com/cli",
-    "helpDocument": "https://copilot.tencent.com/docs/cli",
-    "issueFeedback": "https://cnb.cool/codebuddy/codebuddy-code/-/issues",
-    "issueCreation": "https://cnb.cool/codebuddy/codebuddy-code/-/issues/new",
-    "mcpHelpDocument": "https://copilot.tencent.com/docs/cli/mcp",
-    "hooksHelpDocument": "https://copilot.tencent.com/docs/cli/hooks",
-    "sandboxHelpDocument": "https://copilot.tencent.com/docs/cli/bash-sandboxing",
-    "upgradeUrl": ""
-  },
-  "productFeatures": {
-    "BillingNotice": false,
-    "ShareLink": true,
-    "Artifact": true,
-    "CodeAdoptionRate": false,
-    "CloudAgentsSmartMerge": true,
-    "CustomModelsJSON": true,
-    "CustomModelIdPrefix": true,
-    "DeferToolLoading": true,
-    "ScheduledTasks": true,
-    "SkipToolCallSupportCheck": true
-  },
-  "commit": "5fdb0502c8031c71fd947c537235505bdae49eec",
-  "date": "2026-09-28T07:49:01.677Z"
-}
+{"agents":[{"name":"cli","instructions":"cli-agent-prompt","description":"cli agent","models":["codewise-chat"],"modelTags":["craft"],"commands":["init","compact","statusline","insights"],"tools":["Agent","Read","Write","Edit","Bash","PowerShell","Glob","Grep","EnterPlanMode","ExitPlanMode","TaskCreate","TaskGet","TaskUpdate","TaskList","WebFetch","WebSearch","TaskStop","TaskOutput","Skill","AskUserQuestion","AskUserForStructuredInput","StructuredOutput","ToolSearch","DeferExecuteTool","SendMessage","SendUserMessage","TeamCreate","TeamDelete","NotebookEdit","LSP","EnterWorktree","LeaveWorktree","CronCreate","CronDelete","CronList","DelegateTool","WeChatReply","WeComReply","PushNotification","ReportFindings","ComputerUse","ListMcpResources","ReadMcpResource","WaitForMcpServers","Workflow","Monitor","REPL","A2AGetAgentCard","A2ASendMessage","A2AGetTask","A2ACancelTask"],"tags":["cli","default","model:craft"]},{"name":"general-purpose","instructions":"cli-agent-prompt","description":"general-purpose agent","tools":["Read","Write","Edit","Bash","PowerShell","Glob","Grep","TaskCreate","TaskGet","TaskUpdate","TaskList","WebFetch","WebSearch","TaskStop","TaskOutput","Skill","AskUserQuestion","AskUserForStructuredInput","ToolSearch","DeferExecuteTool","StructuredOutput","SendMessage","SendUserMessage","NotebookEdit","LSP","ComputerUse","ImageGen","ImageEdit","Artifact","ArtifactControl","ListMcpResources","ReadMcpResource","WaitForMcpServers","REPL"],"tags":["cli","general-purpose"]},{"name":"compact","instructions":"compact-agent-prompt","description":"compact agent","tools":["Read"],"commands":["_compact"],"tags":["cli","compact"]},{"name":"contextSummary","instructions":"context-summary-agent-prompt","description":"Context summary agent for conversation compaction and max-token recovery","tools":[],"tags":["cli","contextSummary"]},{"name":"contentAnalyzer","instructions":"content-analyzer-agent-instructions","description":"content analyzer agent","tags":["cli","content-analyzer"],"tools":[]},{"name":"terminalTitleGenerator","instructions":"terminal-title-generator-instructions","description":"Generate terminal window titles from conversation topics.","tags":["cli","terminal-title-generator"],"tools":[]},{"name":"promptSuggestion","instructions":"prompt-suggestion-instructions","description":"Suggest the user's next prompt after a conversation turn.","tags":["cli","prompt-suggestion"],"tools":[]},{"name":"memorySelector","instructions":"memory-selector-instructions","description":"Select relevant memories for the current query.","models":["lite"],"tags":["cli","memory-selector"],"tools":[]},{"name":"summaryGenerator","instructions":"summary-generator-instructions","description":"Generate session summaries from conversation content.","tags":["cli","summary-generator"],"tools":[]},{"name":"autoModeClassifier","instructions":"auto-mode-classifier-instructions","description":"Classify auto mode tool permission risk.","models":["lite"],"tags":["cli","auto-mode-classifier"],"tools":[]},{"name":"promptHookEvaluator","instructions":"prompt-hook-evaluator-instructions","description":"Evaluates prompt hooks using LLM to determine if conditions are met","models":["lite"],"tags":["cli","prompt-hook-evaluator"],"tools":[]},{"name":"insightsAnalyzer","instructions":"base-agent-instructions","description":"Analyzes user usage data facets for the /insights command","tags":["cli","insights-analyzer"],"tools":[]},{"name":"agentInstructions","instructions":"agent-instructions","description":"generating agent instructions","tags":["cli","agent-instructions"],"tools":[]},{"name":"statusline-setup","instructions":"agent-statusline-instructions","description":"Use this agent to configure the user's Codebuddy Code status line setting.","tools":["Read","Write","Edit","ToolSearch","DeferExecuteTool"],"asTool":true,"tags":["cli","sub-agent"]},{"name":"Explore","instructions":"agent-explore-instructions","description":"Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (eg. \"src/components/**/*.tsx\"), search code for keywords (eg. \"API endpoints\"), or answer questions about the codebase (eg. \"how do API endpoints work?\"). When calling this agent, specify the desired thoroughness level: \"quick\" for basic searches, \"medium\" for moderate exploration, or \"very thorough\" for comprehensive analysis across multiple locations and naming conventions.","models":["lite"],"tools":["Read","Bash","PowerShell","Glob","Grep","TaskCreate","TaskGet","TaskUpdate","TaskList","WebFetch","WebSearch","Skill","SendMessage","SendUserMessage","ToolSearch","DeferExecuteTool"],"asTool":true,"tags":["cli","sub-agent"]},{"name":"Plan","instructions":"agent-plan-instructions","description":"Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a multi-step task before writing code. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs. Read-only: it designs but does not modify files or exit plan mode; the caller reviews the plan and implements it.","tools":["Read","Bash","PowerShell","Glob","Grep","TaskCreate","TaskGet","TaskUpdate","TaskList","WebFetch","WebSearch","Skill","ToolSearch","DeferExecuteTool","TeamCreate","TeamDelete","SendMessage","SendUserMessage"],"asTool":true,"tags":["cli","sub-agent"]}],"models":[{"credits":"x0.01 credits","id":"codewise-chat","name":"Codewise-Chat","vendor":"tencent","maxOutputTokens":8192,"maxInputTokens":128000,"supportsToolCall":true,"supportsImages":false,"disabledMultimodal":true,"maxAllowedSize":56000}],"links":{"officialWebsite":"https://copilot.tencent.com/cli","helpDocument":"https://copilot.tencent.com/docs/cli","issueFeedback":"https://cnb.cool/codebuddy/codebuddy-code/-/issues","issueCreation":"https://cnb.cool/codebuddy/codebuddy-code/-/issues/new","mcpHelpDocument":"https://copilot.tencent.com/docs/cli/mcp","hooksHelpDocument":"https://copilot.tencent.com/docs/cli/hooks","sandboxHelpDocument":"https://copilot.tencent.com/docs/cli/bash-sandboxing","upgradeUrl":""},"productFeatures":{"BillingNotice":false,"ShareLink":true,"Artifact":true,"CodeAdoptionRate":false,"CloudAgentsSmartMerge":true,"CustomModelsJSON":true,"CustomModelIdPrefix":true,"DeferToolLoading":true,"ScheduledTasks":true,"SkipToolCallSupportCheck":true},"commit":"c209d15bb4897f91f06d884723baf7cdefb01bff","date":"2026-09-29T02:49:53.555Z"}

package/docs/acp-v2.md

@@ -59,6 +59,25 @@ response commit 是接受边界。仅在 commit 前取消该 JSON-RPC request
 新轮使用自己的 requestId 和取消信号；旧轮的取消不能使新轮直接变成 `cancelled`。
 terminal `usage` 是 Session 累计快照，取消前后数值相同不代表新轮继承了取消状态。
 
+### 用量与费用
+
+| 字段 | 含义 |
+| --- | --- |
+| `usage_update.used / size` | 当前上下文占用与模型上下文预算，不是本轮消耗。预算未知时不发送该更新。 |
+| `usage_update.cost` | 会话累计费用；`currency: "credits"` 表示 Credits，`amount: 0` 是有效值。 |
+| `usage_update._meta.usage` | 单次模型请求的用量，保留服务端原始 token、cache、`credit` 等字段及零值。没有原始数据时仅提供已记录的 token 计数，不推算费用。 |
+| `state_update: idle` 的 `usage` | 会话累计 token 快照，不是当前 turn 的增量。 |
+
+带有 `_meta.usage` 的更新同时携带 `codebuddy.ai/requestId`（所属轮次）和
+`codebuddy.ai/messageId`（模型请求身份）。一次 turn 可以包含多个模型请求；reasoning、
+完整消息和历史回放可能再次携带同一请求的用量。客户端应按会话、轮次和模型请求 ID
+更新记录，再汇总当前 turn，不能逐帧相加。Subagent 使用
+`codebuddy.ai/subagent.sessionId` 区分会话，`codebuddy.ai/rootRequestId` 关联根轮次。
+
+`session/resume` 回放保留这些身份，最后的累计快照不携带 `_meta.usage`。
+客户端应在 `resume()` 返回时结束本次回放累加，不能等下一条实时 prompt 再收尾，
+也不能把累计费用覆盖到最后一个历史 turn。历史回放不生成前台 `idle` 事件。
+
 不存在 `session_end` update。Client 只能依据 terminal `state_update` 结束 turn。技术故障遵循
 [错误处理](errors.md)中的生命周期，包括自定义 terminal stop reason `_codebuddy.ai/error`。
 

package/docs/client.md

@@ -77,6 +77,13 @@ client.on('session/request_permission', (request, context) =>
 `void | Promise<void>`；各 listener 都会被调用并等待完成，一个 listener 失败不会阻止
 同一通知的其他 listener。
 
+沙箱审批的展示信息位于 `request.subject.toolCall._meta`（先确认 `subject.type === 'tool_call'`），
+包括 `codebuddy.ai/sandboxIntercept`、`interceptType`、`target`、`operation`、`description`、
+`sandboxRuleContext` 和 `bulkDeleteInfo` 等 `codebuddy.ai/` 字段。沙箱命令的“本次会话内允许”
+只作用于当前会话的同一命令和工作目录。若含 `codebuddy.ai/fileApprovalScope`，客户端应显示其目录、
+操作与会话有效期；用户明确确认该范围后才返回 `optionId: 'allow_directory'`。
+它不会出现在通用选项列表里，普通“允许本次”或自动选择选项不能登记目录授权。
+
 通知可以在连接前后订阅，只接收注册后的事件。反向请求每个方法只允许一个回答者，也可以在
 连接后注册；请求到达时使用当时的 handler。权限请求缺少 handler 时返回 ACP 的取消结果。
 若声明 `capabilities.elicitation.form` 或 `url`，必须在 `connect` 前注册

package/docs/product.md

@@ -282,6 +282,10 @@ broker boundary 内捕获当前 secret-free Account binding，不让 Client 在
 完全缺省（显式 `null` 也非法），不能把企业 Product 提交给个人 account state。bearer token 不在 binding
 中，因此同一 binding 下的 token refresh 不改变 Product。
 
+排队及等待旧任务结束期间，Client 可通过 `$/cancel_request` 取消 provision；取消会释放等待，保留原有
+Account/Product。提交已经开始时会完成提交和通知，再释放串行门。排队的读取请求也可以独立取消，
+不会终止其他请求的提交。Client 超时后应发送取消通知，并重新读取 Product 确认最终状态。
+
 `expectedGeneration` 和 `expectedRevision` 必须同时取自最近一次 `product/read` 或 provision result。
 前者覆盖 private Product execution 代际，后者覆盖 ready/unavailable、freshness、公开 projection
 和 Account binding invalidation 在内的完整 resource 版本。过期写入返回

package/docs/protocol.md

@@ -77,7 +77,9 @@ await client.session.compact({ sessionId });
 
 ### 输入与附件
 
-Prompt 接受 ACP content，包括 text、image、resource 与 resource_link。Agent 历史使用 SDK 原生消息 item；回放再投影为 ACP v2。资源 URI、显示名称、MIME 类型和受支持的 badge 语义会保留。原始二进制字节不会被拼成普通文本发送给模型。
+Prompt 接受 ACP content，包括 text、image、resource 与 resource_link。普通 text 中的 `@browser:session`、`@skill:name`、文件路径和 slash 文本在实时回显与历史回放时保持为文本，由客户端解释。Harness 不从文本拼写推断资源引用；旧历史中没有资源元数据的 badge 也按文本返回。
+
+显式的 resource_link、image、resource 会保留资源 URI、显示名称、MIME 类型和内容。原始二进制字节不会被拼成普通文本发送给模型。内部上下文与系统提示仍按现有规则隐藏。
 
 调用方应保留结构化 content，而不是提前把附件转成说明文本。UI 应根据 content 类型显示附件和 badge。