@tencent-ai/agent-sdk 0.3.123 → 0.3.124

package/cli/dist/web-ui/docs/cn/cli/slash-commands.md

@@ -16,6 +16,7 @@ CodeBuddy Code 支持斜杠命令，允许您在聊天中执行特殊操作、
 | `/status` | | ✅ 支持 | 显示当前仓库和会话的状态。 |
 | `/add-dir` | `<path>` | ✅ 支持 | 添加工作目录。指定要添加的目录路径。 |
 | `/agents` | | ✅ 支持 | 管理实验性 AI 智能体 |
+| `/branch` | `[name]` | ✅ 支持 | 在当前对话位置创建一个分支，复制活跃对话历史到新 session 并自动切换。可选指定分支名称。 |
 | `/btw` | `<question>` | ✅ 支持 | 快速提问，不中断当前 Agent 工作流。适用于在 Agent 执行任务时临时提出简短问题，答案基于已有上下文生成。 |
 | `/compact`| | ✅ 支持 | 压缩上下文。 |
 | `/config`| `[list \| get \| set]` | ✅ 支持 | 查看或修改本地配置。不带参数时打开交互式面板，`list` 列出当前设置，`get <key>` 读取设置，`set <key> <value>` 修改设置。 |
@@ -38,6 +39,7 @@ CodeBuddy Code 支持斜杠命令，允许您在聊天中执行特殊操作、
 | `/theme` | | ✅ 支持 | 打开主题选择面板，可选择和预览不同的终端主题(dark、light、colorblind-friendly、ANSI 等）。 |
 | `/export` | | ✅ 支持 | 导出当前对话到文件或剪贴板。 |
 | `/feedback` | | ✅ 支持 | 打开反馈页面，提交 Bug 报告或功能建议。 |
+| `/fork` | `[name]` | ✅ 支持 | 在当前对话位置创建一个分支（`/branch` 的别名）。复制活跃对话历史到新 session 并自动切换，可通过 `/resume` 返回原对话。 |
 | `/resume` | `[list \| session-id]` | ✅ 支持 | 恢复之前的会话。不带参数时打开交互式面板，`list` 列出所有会话，带 session-id 时直接切换到指定会话。 |
 | `/rewind` | | ✅ 支持 | 回退对话到之前的某个消息点，可选择仅回退对话、仅回退代码或同时回退两者。详见 [检查点](checkpointing.md)。 |
 | `/sandbox` | | ✅ 支持 | 管理 Bash 命令沙箱模式，控制命令执行的安全策略。详见 [沙箱文档](bash-sandboxing.md)。 |

package/cli/dist/web-ui/docs/en/cli/cli-reference.md

@@ -31,6 +31,7 @@ Command-line parameters to customize CodeBuddy Code behavior:
 | Parameter                        | Description                                                                                                                       | Example                                                                                            |
 | :------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
 | `--add-dir`                      | Add additional working directories for CodeBuddy to access (validates each path for existence)                                    | `codebuddy --add-dir ../apps ../lib`                                                               |
+| `--agent`                        | Specify the agent name (built-in or custom agent) for the current session, takes priority over the `agent` setting in settings.json | `codebuddy --agent my-reviewer`                                                                    |
 | `--agents`                       | Dynamically define custom [Sub-Agents](./sub-agents.md) via JSON (format described below)                                        | `codebuddy --agents '{"reviewer":{"description":"Review code","prompt":"You are a code reviewer"}}'` |
 | `--allowedTools`                 | List of tools allowed without prompting the user, in addition to [settings.json file](./settings.md)                             | `"Bash(git log:*)" "Bash(git diff:*)" "Read"`                                                      |
 | `--disallowedTools`              | List of tools to disallow, in addition to [settings.json file](./settings.md)                                                    | `"Bash(git log:*)" "Bash(git diff:*)" "Edit"`                                                      |

package/cli/dist/web-ui/docs/en/cli/http-api.md

@@ -273,6 +273,38 @@ Aligned with E2B process.proto, mapping gRPC methods to REST endpoints:
 | GET | `/api/v1/tasks/templates` | Get task templates |
 | POST | `/api/v1/tasks/templates/refresh` | Refresh (trigger AI recommendations) |
 
+### Usage Statistics
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/v1/stats` | Historical usage statistics (across all projects) |
+| GET | `/api/v1/stats/session` | Current session real-time statistics |
+
+### Traces
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/v1/traces` | Get trace list (supports pagination and filtering) |
+| GET | `/api/v1/traces/:traceId` | Get trace details (with spans) |
+| DELETE | `/api/v1/traces` | Clear all traces |
+
+**Traces query parameters**:
+- `?offset=0&limit=50` — Pagination (limit max 200)
+- `?session_id=xxx` — Filter by session ID
+- `?worker_pid=12345` — Specify Worker instance (supports remote proxy)
+- `?worker_pid=all` — Scan all instances
+
+### Scheduled Tasks
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/v1/scheduled-tasks` | Get scheduled task list |
+| POST | `/api/v1/scheduled-tasks` | Create scheduled task |
+| DELETE | `/api/v1/scheduled-tasks/:id` | Delete scheduled task |
+
+**Scheduled task query parameters**:
+- `?sessionId=xxx` — Session ID (required, uses current active session if not provided)
+
 ## Usage Examples
 
 ### Health Check
@@ -514,6 +546,60 @@ curl -X POST http://127.0.0.1:8080/api/v1/settings/permissions/remove \
   -d '{"values": ["Allow: Read(**)"]}'
 ```
 
+### Usage Statistics
+
+```bash
+# Get historical usage statistics (activity heatmap, model/tool usage rankings, consecutive active days, etc.)
+curl http://127.0.0.1:8080/api/v1/stats
+
+# Get current session real-time cost statistics
+curl http://127.0.0.1:8080/api/v1/stats/session
+```
+
+### Traces
+
+```bash
+# Get trace list (paginated)
+curl "http://127.0.0.1:8080/api/v1/traces?offset=0&limit=20"
+
+# Filter by session ID
+curl "http://127.0.0.1:8080/api/v1/traces?session_id=SESSION_ID"
+
+# Get trace details (with all spans)
+curl http://127.0.0.1:8080/api/v1/traces/TRACE_ID
+
+# Get traces from a remote Worker
+curl "http://127.0.0.1:8080/api/v1/traces?worker_pid=12345"
+
+# Clear all traces
+curl -X DELETE http://127.0.0.1:8080/api/v1/traces
+```
+
+### Scheduled Task Management
+
+```bash
+# Get scheduled task list
+curl "http://127.0.0.1:8080/api/v1/scheduled-tasks?sessionId=SESSION_ID"
+
+# Create scheduled task (every 5 minutes)
+curl -X POST http://127.0.0.1:8080/api/v1/scheduled-tasks \
+  -H "Content-Type: application/json" \
+  -d '{"cron": "*/5 * * * *", "prompt": "Check build status", "sessionId": "SESSION_ID"}'
+
+# Create one-time task (every Monday at 9 AM)
+curl -X POST http://127.0.0.1:8080/api/v1/scheduled-tasks \
+  -H "Content-Type: application/json" \
+  -d '{"cron": "0 9 * * 1", "prompt": "Generate weekly report", "recurring": false, "sessionId": "SESSION_ID"}'
+
+# Create durable task (persists after restart)
+curl -X POST http://127.0.0.1:8080/api/v1/scheduled-tasks \
+  -H "Content-Type: application/json" \
+  -d '{"cron": "0 0 * * *", "prompt": "Daily cleanup", "durable": true, "sessionId": "SESSION_ID"}'
+
+# Delete scheduled task
+curl -X DELETE "http://127.0.0.1:8080/api/v1/scheduled-tasks/TASK_ID?sessionId=SESSION_ID"
+```
+
 ## Error Codes
 
 | Error Code | HTTP Status | Description |

package/cli/dist/web-ui/docs/en/cli/release-notes/README.md

@@ -17,6 +17,11 @@ Difference from CHANGELOG.md:
 
 <!-- New versions are automatically added here -->
 
+- [v2.83.1](./v2.83.1.md) - 2026-04-10
+- [v2.83.0](./v2.83.0.md) - 2026-04-10
+- [v2.82.0](./v2.82.0.md) - 2026-04-10
+- [v2.81.2](./v2.81.2.md) - 2026-04-09
+- [v2.81.1](./v2.81.1.md) - 2026-04-08
 - [v2.81.0](./v2.81.0.md) - 2026-04-08
 - [v2.80.0](./v2.80.0.md) - 2026-04-08
 - [v2.79.1](./v2.79.1.md) - 2026-04-07

package/cli/dist/web-ui/docs/en/cli/release-notes/v2.81.1.md

@@ -0,0 +1,14 @@
+# 🚀 CodeBuddy Code v2.81.1 Release
+
+## 🔧 Improvements
+
+- **system-reminder classification system**: Added classification attributes to non-rule type system-reminder tags, enabling precise differentiation and restoration of different system reminder types during context compression, improving conversation continuity
+- **Regex compatibility**: Updated all system-reminder related regular expressions to support the new attribute-bearing tag format, preventing match omissions
+- **PromptManager race condition fix**: Adopted an atomic replacement strategy to fix a race condition in template loading, eliminating occasional system prompt loss after `/clear`
+- **Streaming tool name display**: Real-time display of the currently invoked tool name during model streaming output, making the execution process more transparent
+
+## 📝 Documentation Updates
+
+- **Keyboard shortcuts documentation**: Added keyboard shortcut configuration documentation covering Chinese, English, and Traditional Chinese
+- **Multi-language documentation sync**: Synchronized multi-language versions of environment variables, memory system, settings, and tool reference documentation
+- **Release notes**: Added multi-language release notes for versions v2.79.1, v2.80.0, and v2.81.0

package/cli/dist/web-ui/docs/en/cli/release-notes/v2.81.2.md

@@ -0,0 +1,13 @@
+# 🚀 CodeBuddy Code v2.81.2 Release
+
+## 🔧 Improvements
+
+- **Plugin installation scope selection**: Added scope selection when installing plugins, supporting user-level, project-level, and local-level installation methods. Installed plugins now display corresponding scope labels for easier identification and management
+- **Subagent preamble text hidden**: Descriptive text output by the model before invoking subagents is no longer displayed in the conversation flow, reducing visual noise for a cleaner experience
+- **Line break button optimization**: Removed the redundant line break button on desktop (use Shift+Enter instead), retaining it only on mobile
+- **Single tool connector line optimization**: The left connector line is no longer displayed when a tool group contains only one entry, providing a cleaner visual appearance
+- **Code block style unification**: Unified style handling for code highlighting components, removing excess background color and text shadow
+
+## 🐛 Bug Fixes
+
+- **Settings config file protection**: Fixed an issue where write operations would overwrite the original file when settings.json contained JSON syntax errors, causing configuration loss. The system now detects corrupted state and prevents overwriting

package/cli/dist/web-ui/docs/en/cli/release-notes/v2.82.0.md

@@ -0,0 +1,31 @@
+# 🚀 CodeBuddy Code v2.82.0 Release
+
+## ✨ New Features
+
+### Fork Subagent
+
+The Agent tool now supports Fork mode: when the `subagent_type` parameter is omitted, it automatically creates a background subagent that inherits the parent agent's full context (system prompt, tool set, conversation history). This is ideal for parallel task scenarios that require the current conversation context, without the need to manually pass context information.
+
+### Conversation Branching
+
+Added `/fork` and `/branch` slash commands to support creating branches at the current conversation position. Branches copy the active conversation history to a new session and automatically switch to it. You can return to the original conversation via `/resume` to continue working.
+
+## 🔧 Improvements
+
+- **Memory injection optimization**: Auto Memory context injection moved from the end to the first message, improving prompt cache hit rate; added fallback detection to ensure memory is not lost after resume
+- **SystemReminder streamlining**: Removed TODO-LIST auto-injection logic to reduce unnecessary context usage
+- **Trace logging**: Added traceId/spanId logging at request entry and TraceStartHook for easier troubleshooting of trace-related issues
+- **Plugin agent configuration enhancement**: Agent configuration in plugin `settings.json` is no longer restricted by the enabled state, supporting independent `settings.json` file loading of agent definitions
+- **Settings agent override optimization**: Both `settings.agent` and plugin agents now use patch-in-place to override default agents, keeping agent names unchanged
+- **CLI `--agent` parameter**: Added the `--agent` command-line parameter to directly specify the agent for a session at startup, taking priority over settings configuration
+
+## 🐛 Bug Fixes
+
+- **File lock PID check**: File locks can now be reclaimed immediately after a process crash, no longer requiring a 5-minute timeout
+- **Settings write degradation**: Graceful degradation when file lock acquisition fails, no longer throwing unhandled exceptions
+- **Background session attach**: The `attach` command now prioritizes tracking log output for sessions started with `--bg`
+- **Short command exit**: Commands like `ps/logs/attach/kill` now exit immediately after execution instead of hanging
+- **Headless routing**: Fixed an issue where `--output-format=stream-json` style equal-sign format parameters could not be correctly routed to the headless bundle
+- **MCP OAuth authentication**: Fixed an authentication failure caused by mismatched OAuth callback paths
+- **Bedrock model compatibility**: Fixed an error with the Bedrock ConverseStream API when message content was empty
+- **stream-json error output**: Fixed an issue where exception information polluted the JSON stream in stream-json mode; errors are now output in JSON format

package/cli/dist/web-ui/docs/en/cli/release-notes/v2.83.0.md

@@ -0,0 +1,27 @@
+# 🚀 CodeBuddy Code v2.83.0 Release
+
+## ✨ New Features
+
+### Fork Subagent
+
+When the `subagent_type` parameter is omitted, the Agent tool automatically enters Fork mode, inheriting the parent agent's full context (system prompt, tools, conversation history). This is ideal for parallel tasks that require the current context. It runs synchronously by default; set `run_in_background=true` to switch to background mode.
+
+### Conversation Branching
+
+Added `/fork` and `/branch` slash commands that support creating branches at the current conversation position. The active history is copied to a new session and automatically switched to, making it easy to explore solutions in different directions.
+
+## 🔧 Improvements
+
+- **SendMessage Always Available**: The SendMessage tool is now available in any scenario without waiting for a team to be created
+- **Memory Injection Optimization**: Auto Memory context prompt is now injected into the first message, improving prompt cache hit rate; memory is no longer lost after resume
+- **Plugin Agent Configuration Enhancement**: Plugin agent configuration is no longer restricted by the enabled state, supporting independent settings.json file loading
+- **CLI `--agent` Parameter**: Added the `--agent <agent>` command-line parameter to specify the agent to use at startup
+
+## 🐛 Bug Fixes
+
+- **File Lock Recovery**: File locks are now immediately reclaimed after a process crash, eliminating the need to wait for a 5-minute timeout
+- **Settings Write Stability**: Graceful degradation when file lock acquisition fails, preventing unhandled exceptions
+- **MCP OAuth Authentication**: Fixed an issue where OAuth callback path mismatch caused authentication failure
+- **Bedrock Model Compatibility**: Fixed an issue where Bedrock API returned errors when message content was empty
+- **Headless Routing**: Fixed an issue where equal-sign format parameters (e.g., `--output-format=stream-json`) could not be routed correctly
+- **stream-json Output**: Fixed an issue where error messages polluted the JSON stream in stream-json mode

package/cli/dist/web-ui/docs/en/cli/release-notes/v2.83.1.md

@@ -0,0 +1,10 @@
+# 🚀 CodeBuddy Code v2.83.1 Release
+
+## 🔧 Improvements
+
+- **Deferred Tool Loading Configuration**: Optimized the configuration retrieval for deferred loading tools, ensuring product configuration is fully ready before reading, improving tool loading reliability; ToolSearch and DeferExecuteTool are automatically hidden when global deferred loading is disabled, reducing unnecessary tool list clutter
+
+## 🐛 Bug Fixes
+
+- **MCP Configuration Loading Timing**: Fixed an initialization timing issue with MCP configuration loading in ACP mode (IDE integration), ensuring the configuration takes effect correctly
+- **Trace Initialization Race Condition**: Fixed an issue where the first request in headless/SDK mode could produce empty trace data, ensuring the TracerProvider completes initialization before the first request

package/cli/dist/web-ui/docs/en/cli/slash-commands.md

@@ -16,6 +16,7 @@ These commands are used to manage your CodeBuddy Code sessions. Here is the curr
 | `/status` | | ✅ Supported | Display the status of the current repository and session. |
 | `/add-dir` | `<path>` | ✅ Supported | Add a working directory. Specify the path of the directory to add. |
 | `/agents` | | ✅ Supported | Manage experimental AI agents |
+| `/branch` | `[name]` | ✅ Supported | Create a branch at the current conversation point, copying active conversation history to a new session and automatically switching to it. Optionally specify a branch name. |
 | `/btw` | `<question>` | ✅ Supported | Quick side question without interrupting the current Agent workflow. Useful for asking brief questions while the Agent is executing a task. Answers are generated based on existing context. |
 | `/compact`| | ✅ Supported | Compress context. |
 | `/config`| `[list \| get \| set]` | ✅ Supported | View or modify local configuration. Opens an interactive panel when used without parameters, `list` lists current settings, `get <key>` reads a setting, `set <key> <value>` modifies a setting. |
@@ -38,6 +39,7 @@ These commands are used to manage your CodeBuddy Code sessions. Here is the curr
 | `/theme` | | ✅ Supported | Open the theme selection panel, where you can select and preview different terminal themes (dark, light, colorblind-friendly, ANSI, etc.). |
 | `/export` | | ✅ Supported | Export the current conversation to a file or clipboard. |
 | `/feedback` | | ✅ Supported | Open the feedback page to submit bug reports or feature suggestions. |
+| `/fork` | `[name]` | ✅ Supported | Create a branch at the current conversation point (alias for `/branch`). Copies active conversation history to a new session and automatically switches to it. Use `/resume` to return to the original conversation. |
 | `/resume` | `[list \| session-id]` | ✅ Supported | Resume a previous session. Opens an interactive panel when used without parameters, `list` lists all sessions, or directly switches to the specified session when provided with a session-id. |
 | `/rewind` | | ✅ Supported | Rewind conversation to a previous message point. You can choose to rewind conversation only, code only, or both. See [Checkpointing](checkpointing.md) for details. |
 | `/sandbox` | | ✅ Supported | Manage Bash command sandbox mode and control security policies for command execution. See [Sandbox Documentation](bash-sandboxing.md) for details. |