@tencent-ai/codebuddy-code 2.110.0-next.4c26008.202606252235 → 2.111.0

package/dist/web-ui/docs/en/cli/interactive-mode.md

@@ -18,16 +18,16 @@
 | `Ctrl+O`                                   | Toggle verbose output                                                                    | Display detailed tool usage and execution information      | ✅ Supported      |
 | `Ctrl+R`                                   | Reverse search command history                                                           | Interactive search of previous commands                    | ✅ Supported      |
 | `Ctrl+V` (macOS/Linux) or `Alt+V` (Windows) | Paste text or image from clipboard; on Windows, `Alt+V` is recommended for a more reliable experience when pasting large blocks of text | Paste text, image, or image file path                      | ✅ Supported      |
-| `Up/Down Arrow Keys`                       | Navigate command history                                                                 | Recall previous inputs                                     | ✅ Supported      |
+| `Up/Down Arrow Keys`                       | Navigate command history                                                                 | Recall previous inputs; when queued messages exist, `Up` will prioritize pulling queued messages back to the input box for editing | ✅ Supported      |
 | `Esc` + `Esc`                              | Rewind code/conversation                                                                 | Restore code and/or conversation to previous state (requires pressing ESC twice consecutively when the input box is empty) | ✅ Supported      |
 | `Tab`                                      | Toggle thinking mode                                                                     | Switch between thinking on and thinking off                | ✅ Supported      |
-| `Shift+Tab` (macOS/Linux) or `Alt+M` (Windows) | Toggle permission mode                                                                   | Cycle between `default`, `bypassPermissions`, `acceptEdits`, `auto` (when available), `plan`, `delegate` | ✅ Supported      |
+| `Shift+Tab` (all platforms, Windows also supports `Alt+M`) | Toggle permission mode                                                                   | Cycle between `default`, `bypassPermissions`, `acceptEdits`, `auto` (when available), `plan`, `delegate` | ✅ Supported      |
 | `Option+P` (macOS) or `Alt+P` (Windows/Linux) | Switch model                                                                             | Quickly open model selection panel                         | ✅ Supported      |
 
 > **Notes:**
 > - `Esc` + `Esc` rewind functionality is now supported: when the input box is empty, pressing the ESC key twice consecutively activates the `/rewind` feature, allowing you to quickly revert code or conversation to a previous state
 > - `Tab` key in CodeBuddy Code is primarily used for auto-completion, with partial support for thinking mode toggle
-> - `Shift+Tab` (macOS/Linux) or `Alt+M` (Windows) is used to toggle permission modes. The current cycle order is: `default → bypassPermissions → acceptEdits → auto (when available) → plan → delegate`. `dontAsk` is not in the keyboard cycle; it must be entered via `--permission-mode dontAsk` or settings. Note: On Windows, you must use `Alt+M`; `Shift+Tab` does not work
+> - `Shift+Tab` is used to toggle permission modes (all platforms, Windows also supports `Alt+M` as an alias). The current cycle order is: `default → bypassPermissions → acceptEdits → auto (when available) → plan → delegate`. `dontAsk` is not in the keyboard cycle; it must be entered via `--permission-mode dontAsk` or settings. Customizable via `~/.codebuddy/keybindings.json`
 
 ### Multi-line Input
 
@@ -122,6 +122,14 @@ CodeBuddy Code maintains command history for the current session:
 * Navigate using Up/Down arrow keys (see keyboard shortcuts above)
 * **Note**: History expansion (`!`) is disabled by default
 
+### Editing Queued Messages
+
+When the Agent is responding, messages you type and submit will enter a queue, displayed above the input box. At this point, if the input box is empty, pressing the `Up` arrow key will pull queued messages back to the input box for continued editing (multiple queued messages are merged in send order, joined by newlines):
+
+* When the input box is empty and there are editable queued messages, a "Press ↑ to edit queued messages" prompt will be displayed
+* System-injected queue items (async task notifications, channel messages, teammate messages, etc.) will not be pulled back to the input box and will remain in the queue for automatic processing
+* If you are already using `Up`/`Down` to browse history, the arrow keys will continue to navigate history and will not interrupt
+
 ### Reverse Search with Ctrl+R
 
 Press `Ctrl+R` to interactively search your command history:
@@ -153,7 +161,7 @@ To run a command in the background, you can:
 
 **Key features:**
 
-* Output is buffered and CodeBuddy can retrieve it using the BashOutput tool
+* Output is buffered and CodeBuddy can retrieve it using the TaskOutput tool
 * Background tasks have unique IDs for tracking and output retrieval
 * Background tasks are automatically cleaned up when CodeBuddy Code exits
 
@@ -192,14 +200,14 @@ CodeBuddy Code supports multiple permission modes to control how tool usage is a
 
 | Mode                       | Description                                                              | Toggle Shortcut     |
 | :------------------------- | :----------------------------------------------------------------------- | :------------------ |
-| **Normal Mode (Default)**  | Asks for confirmation of tool usage based on permission rules            | `Shift+Tab` (macOS/Linux) / `Alt+M` (Windows) |
-| **Auto-Accept Edits Mode** | Automatically approves file editing operations (Edit/Write), other tools still require confirmation | `Shift+Tab` (macOS/Linux) / `Alt+M` (Windows) |
-| **Skip Permissions Mode**  | Bypasses all permission checks. Recommended for use only in sandboxes without internet access | `Shift+Tab` (macOS/Linux) / `Alt+M` (Windows) |
-| **Plan Mode**              | AI will formulate a plan and wait for approval before execution          | `Shift+Tab` (macOS/Linux) / `Alt+M` (Windows) |
+| **Normal Mode (Default)**  | Asks for confirmation of tool usage based on permission rules            | `Shift+Tab` |
+| **Auto-Accept Edits Mode** | Automatically approves file editing operations (Edit/Write), other tools still require confirmation | `Shift+Tab` |
+| **Skip Permissions Mode**  | Bypasses all permission checks. Recommended for use only in sandboxes without internet access | `Shift+Tab` |
+| **Plan Mode**              | AI will formulate a plan and wait for approval before execution          | `Shift+Tab` |
 
 ### Toggling Permission Modes
 
-* Use `Shift+Tab` (macOS/Linux) or `Alt+M` (Windows) to switch between modes. **Note: Windows users must use `Alt+M`**
+* Use `Shift+Tab` to switch between modes (all platforms, Windows also supports `Alt+M` as an alias). Customizable via `~/.codebuddy/keybindings.json`
 * Specify startup mode using the `--permission-mode` command line argument:
   ```bash
   codebuddy --permission-mode acceptEdits

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

@@ -71,7 +71,7 @@ Available in the `Chat` context:
 | `chat:cancel` | Escape | Cancel current input, or interrupt the current foreground request |
 | `chat:submit` | Enter | Send message |
 | `chat:killAgents` | Ctrl+X Ctrl+K | Kill all background agents |
-| `chat:cycleMode` | Shift+Tab* | Cycle permission mode |
+| `chat:cycleMode` | Shift+Tab (Windows also supports Alt+M) | Cycle permission mode |
 | `chat:modelPicker` | Meta+P | Open model picker |
 | `chat:thinkingToggle` | Meta+T | Toggle extended thinking |
 | `chat:undo` | Ctrl+_, Ctrl+Shift+- | Undo |
@@ -79,7 +79,7 @@ Available in the `Chat` context:
 | `chat:stash` | Ctrl+S | Stash current input |
 | `chat:imagePaste` | Ctrl+V (Windows: Alt+V) | Paste image |
 
-\*On Windows without VT mode (Node <24.2.0/<22.17.0, Bun <1.2.23), defaults to Meta+M.
+\*All platforms use Shift+Tab as the primary shortcut. On Windows, Alt+M is also available as an alias for terminals that do not support Shift+Tab.
 
 ### Autocomplete Actions
 

package/dist/web-ui/docs/en/cli/permission-modes.md

@@ -66,7 +66,8 @@ Notes:
 
 - `auto` only appears in the cycle when available in the current environment
 - `dontAsk` is **not** in the keyboard cycle; it can only be entered via CLI, settings, or SDK / IDE control signals
-- On Windows, use `Alt+M` to trigger the same logic
+- On Windows, both `Shift+Tab` and `Alt+M` can trigger this (`Alt+M` is a compatibility alias)
+- You can customize the shortcut via `~/.codebuddy/keybindings.json`
 
 ### Status Bar Indicator
 

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

@@ -198,7 +198,7 @@ codebuddy -p "Add unit tests for all files in the services directory" -y
 #### Permissions and Modes
 | Shortcut | Function |
 |--------|------|
-| `Shift+Tab` (macOS/Linux) or `Alt+M` (Windows) | Toggle permission mode (default → bypass → accept → plan) |
+| `Shift+Tab` (Windows also supports `Alt+M`) | Toggle permission mode (default → bypass → accept → plan) |
 
 #### Editing Features
 | Shortcut | Function |
@@ -213,15 +213,14 @@ codebuddy -p "Add unit tests for all files in the services directory" -y
 #### Panel Operations
 | Shortcut | Function |
 |--------|------|
-| `↑/↓` | Navigate options in panel |
+| `↑/↓` or `j/k` | Navigate options in panel (Vim-style supported) |
 | `Enter` | Select current item |
 | `Space` | Toggle selection (multi-select panels) |
-| `k` | Terminate selected background task |
+| `x` | Terminate selected background task |
 
 #### Special Functions
 | Shortcut | Function |
 |--------|------|
-| `j/k` | Vim-style up/down navigation (supported in some panels) |
 | `Ctrl+O` | View thinking details panel |
 
 When the terminal displays a "Thinking" indicator, you can use `Ctrl+O` to open the full reasoning content, and press `Ctrl+O` again to exit.

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

@@ -2,21 +2,25 @@
 
 Release notes for CodeBuddy Code, covering feature updates and improvements for end users.
 
-## About Release Notes
+## 📖 About Release Notes
 
 Release Notes document user-visible changes in each version, including:
-- New Features
-- Improvements
-- Bug Fixes
+- ✨ New Features
+- 🔧 Improvements
+- 🐛 Bug Fixes
 
 Difference from CHANGELOG.md:
 - **Release Notes**: User-facing, emphasizing feature value and user experience
 - **CHANGELOG**: Developer-facing, recording technical details and code changes
 
-## Version History
+## 📋 Version History
 
 <!-- New versions are automatically added here -->
 
+- [v2.110.0](./v2.110.0.md) - 2026-06-25
+- [v2.109.3](./v2.109.3.md) - 2026-06-23
+- [v2.109.2](./v2.109.2.md) - 2026-06-23
+- [v2.109.1](./v2.109.1.md) - 2026-06-21
 - [v2.109.0](./v2.109.0.md) - 2026-06-19
 
 - [v2.108.2](./v2.108.2.md) - 2026-06-18

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

@@ -0,0 +1,21 @@
+# 🚀 CodeBuddy Code v2.109.1 Release
+
+## 📦 Version Information
+
+| Component | Version |
+|------|------|
+| CodeBuddy Code CLI | v2.109.1 |
+| Agent SDK JS | v0.3.187 |
+| Agent SDK Python | v0.3.186 |
+
+## 🐛 Bug Fixes
+
+- **Model selection fallback logic optimization**: Fixed an issue where Compact compression and sub-agents incorrectly fell back to the first item in the model list when matching failed, now trusting user selection and falling back to the current main model
+- **Model display name matching**: Model availability check now supports matching by display name, resolving failures when passing display names via `--model`
+- **Channel source telemetry completeness**: Fixed missing `downloadChannel` common parameter in standard and model telemetry, ensuring channel package download data can be attributed by source
+
+## 📝 Documentation Updates
+
+- **Prewarm process documentation**: Added Prewarm process usage guide documentation
+- **Release Notes archive**: Synced 13 release notes from v2.106.0 to v2.109.0
+- **Incremental documentation translation**: Updated English translations for 8 documents including CLI reference, environment variables, permission modes, and settings

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

@@ -0,0 +1,21 @@
+# 🚀 CodeBuddy Code v2.109.2 Release
+
+## 📦 Version Information
+
+| Component | Version |
+|------|------|
+| CodeBuddy Code CLI | v2.109.2 |
+| Agent SDK JS | v0.3.188 |
+| Agent SDK Python | v0.3.187 |
+
+## 🔧 Improvements
+
+- **More prominent Auto mode prompt**: The status prompt color for auto permission mode has been changed to warning color, consistent with don't-ask mode, better reminding users they are in a high-permission mode
+- **Telemetry common parameter completion**: QIMEI36 is now passed through in CLI runtime launched by WorkBuddy Desktop, completing common parameters for conversation, plugin status, and enterprise policy telemetry, improving data completeness
+
+## 🐛 Bug Fixes
+
+- **Expert team plan mode permission state loss**: Fixed plan mode permission state saving logic in expert team scenarios, ensuring `prePlanPermissionMode` is correctly saved when a session starts directly in Plan mode
+- **Stop Hook false trigger continuation**: Fixed prompt-type Stop hook incorrectly triggering agent continuation when conditions are not met; the agent now correctly stops as expected
+- **MCP OAuth token exchange failure**: Fixed an issue where some servers lost the `resource` parameter during the token exchange phase, preventing login completion even after successful authorization
+- **Prewarm session missing built-in tools**: Fixed missing built-in tools (file rendering, built-in browser automation, etc.) in sessions when process prewarming is enabled. The standby phase no longer prematurely initializes the connection proxy with an empty configuration, avoiding contamination of the subsequent tool index

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

@@ -0,0 +1,23 @@
+# 🚀 CodeBuddy Code v2.109.3 Release
+
+## 📦 Version Information
+
+| Component | Version |
+|------|------|
+| CodeBuddy Code CLI | v2.109.3 |
+| Agent SDK JS | v0.3.189 |
+| Agent SDK Python | v0.3.188 |
+
+## ✨ New Features
+
+- **Prompt Stop Hook supports continueOnBlock**: Added `continueOnBlock` configuration option. When set to `true`, prompt-type Stop hooks can drive the Agent to continue working when conditions are not met, achieving a continuous work effect similar to `/goal`
+
+## 🐛 Bug Fixes
+
+- **Login link display optimization**: Fixed a timing issue with login page URL link display, ensuring users can see a copyable login link before the browser opens
+- **Checkpoint recovery**: Fixed an issue where v1 version files were incorrectly skipped and not restored when reverting to an earlier checkpoint
+- **MCP configuration loading**: Fixed local `.mcp.json` being incorrectly ignored in headless/server mode; now only uses the specified MCP servers when `--strict-mcp-config` is explicitly passed
+- **Session title recovery**: Fixed issues with duplicate title extraction or stale placeholder titles after resuming image-type sessions, preventing old titles from being abnormally overwritten
+- **MCP connection idempotency**: Fixed an issue where concurrent/repeated connections to the same connection proxy caused it to be misjudged as disconnected (because the underlying transport was already started), resulting in temporary loss of tools from connected services
+- **Prewarm process CLI argument loss**: Fixed an issue where CLI configurations like `--model` / `--effort` / `--settings` were silently discarded after a prewarmed process was activated; now subscribes to configuration change streams for automatic re-parsing and refresh
+- **Permission mode race condition fix**: Fixed permission mode being incorrectly overwritten in Desktop sidecar mode, preventing read-only tools from triggering permission deadlocks in Expert scenarios

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

@@ -0,0 +1,39 @@
+# 🚀 CodeBuddy Code v2.110.0 Release
+
+## 📦 Version Information
+
+| Component | Version |
+|------|------|
+| CodeBuddy Code CLI | v2.110.0 |
+| Agent SDK JS | v0.3.190 |
+| Agent SDK Python | v0.3.189 |
+
+## ✨ New Features
+
+### Five New Slash Commands
+
+This release adds 5 practical slash commands covering common development scenarios such as code review, verification, and debugging:
+
+- **`/simplify`** — Reviews and cleans up changed code from four perspectives: reusability, simplification, efficiency, and abstraction levels, helping you keep code concise
+- **`/code-review`** — Reviews correctness bugs and code quality issues in the current diff, supports `--fix` for automatic fixes and `--comment` to post PR comments directly
+- **`/verify`** — Verifies that code changes work as expected, automatically runs tests and build checks to ensure changes don't break existing functionality
+- **`/copy`** — Copies the most recent AI response to the system clipboard, supports specifying the Nth response via parameter for quick content reference
+- **`/debug`** — Enables debug logging with one command to help diagnose abnormal issues encountered during sessions
+
+## 🔧 Improvements
+
+- **Tool name matching**: Tool name matching now supports case-insensitive comparison. When the model returns a tool name with inconsistent casing compared to the registered name (e.g., `Powershell` vs `PowerShell`), the engineering layer automatically falls back to matching, avoiding tool call failures
+- **Windows Git Bash hint**: On Windows platforms, a Git Bash syntax hint is appended to the Bash tool description, guiding the model to use POSIX shell syntax (`/dev/null` instead of `NUL`, `$VAR` instead of `%VAR%`), improving Windows user experience
+- **Permission mode copy**: Added UI text for "Auto" and "Do Not Disturb" permission modes with clearer and more intuitive descriptions
+
+## 🐛 Bug Fixes
+
+- **ACP conversation rendering**: Fixed an issue where the client didn't display subsequent content after conversation completion when the model had returned final text but streaming body was missing
+- **Background task notifications**: Fixed background task completion notifications not being forwarded to the client in ACP modes like WorkBuddy / Web UI; background command results now display correctly after execution
+- **Log completeness**: Fixed buffered log loss when headless mode is terminated by signals, ensuring `~/.codebuddy/logs` is fully flushed on all exit paths
+- **MCP tool hook interception**: Fixed PreToolUse hook not taking effect for MCP tool calls; deny rules now correctly block MCP tool execution
+- **Plugin Hook type support**: Fixed prompt/agent/http type hooks in plugin `hooks.json` being silently discarded; plugins can now correctly declare all 4 hook types
+- **Session title generation**: Fixed sessions permanently having no title after the first title generation failure; now retries on user submissions until generation succeeds, and already generated or user-customized titles are no longer abnormally overwritten
+- **Telemetry reporting**: Fixed request chain IDs being short-circuited by stale state during tool call continuations, causing traces to miss subsequent model turns after tool call nodes
+- **Session run state**: Fixed late-arriving end signals from previous turns potentially clearing new turn run state when queue or team messages follow in quick succession, preventing loading state disappearance or subsequent response stalls
+- **Canvas terminal stability**: Fixed terminal content going blank after switching views on the canvas page; terminal state is now fully preserved across view switches

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

@@ -51,6 +51,11 @@ These commands are used to manage your CodeBuddy Code sessions. Here is the curr
 | `/reload-plugins` | | ✅ Supported | Reload all plugins (Skills, Agents, Hooks, MCP/LSP servers, etc.) without restarting. |
 | `/skills` | | ✅ Supported | View all currently loaded Skills, including user-level, project-level, and plugin-level Skills, and display estimated token count. See [Skills Documentation](skills.md) for details. |
 | `/insights` | | ✅ Supported | Generate AI-driven usage insight reports, analyzing your CodeBuddy Code usage patterns, interaction style, project domains, friction points, and other dimensions, generating an HTML report viewable in the browser. |
+| `/simplify` | `[target]` | ✅ Supported | Clean up changed code without altering behavior. Automatically launches 4 parallel Agents to review code from four perspectives: reuse, simplification, efficiency, and abstraction levels, then consolidates and applies fixes. Only performs quality cleanup, not correctness bug finding (use `/code-review` for that). |
+| `/code-review` | `[--fix] [--comment] [target]` | ✅ Supported | Review the current diff for correctness bugs and code quality issues. Supports `--fix` to automatically fix found issues, `--comment` to publish findings as PR inline comments. Findings are sorted by severity and include file, line number, severity level, and fix suggestions. |
+| `/verify` | `[description]` | ✅ Supported | Verify that code changes work as expected. Automatically identifies change types, runs relevant test suites, build checks, and type checks, reports test results and flags failures or warnings. |
+| `/copy` | `[N]` | ✅ Supported | Copy the most recent AI response to the system clipboard. Optional parameter N specifies which response (1 = most recent, 2 = second most recent, and so on). Also writes to a temporary file `/tmp/codebuddy/response.md` as backup. |
+| `/debug` | `[issue description]` | ✅ Supported | Enable debug logging and help diagnose session issues. Automatically reads the tail of the current session's debug log (last 20 lines). If debug logging is not enabled, it is automatically turned on. Analyzes errors and warnings in the log and provides fix suggestions. |
 
 description: "Run unit tests for my project and report results."
 argument-hint: "[test-file]"

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

@@ -138,6 +138,99 @@ npm config get registry
 
 If you regularly use a third-party mirror, you can temporarily specify the official registry in the update command without modifying the global configuration.
 
+### npm Install Succeeds but Old Version Still Executes
+
+**Symptom**: `npm install -g @tencent-ai/codebuddy-code@latest` shows installation success, but `codebuddy --version` still shows the old version.
+
+**Cause**: Multiple `codebuddy` executables exist on the system, and the terminal finds the old version first. Common scenarios:
+
+- Installed via both npm and Homebrew simultaneously, with Homebrew version having higher priority
+- Switched Node versions using nvm; the new version was installed under a different Node version's bin directory
+- Leftover old native binary files on the system (`~/.local/bin/codebuddy`)
+- Multiple paths in PATH containing different versions of `codebuddy`
+
+**Troubleshooting steps**:
+
+```bash
+# 1. Confirm which codebuddy is actually being executed
+which codebuddy
+# Or view all matches
+which -a codebuddy
+
+# 2. Confirm npm global installation path
+npm prefix -g
+# npm-installed codebuddy is under $(npm prefix -g)/bin/
+
+# 3. Compare paths
+# If the path from "which codebuddy" ≠ $(npm prefix -g)/bin/codebuddy,
+# it means the terminal is not executing the npm-installed version
+```
+
+**Solutions**:
+
+**Case 1: Both Homebrew and npm installed**
+
+Homebrew's `/opt/homebrew/bin` (macOS Apple Silicon) or `/usr/local/bin` (Intel Mac) typically has higher priority in PATH than npm's global directory.
+
+```bash
+# Option A: Keep only one installation method (recommended)
+brew uninstall codebuddy-code          # Uninstall Homebrew version, use npm version
+# Or
+npm uninstall -g @tencent-ai/codebuddy-code  # Uninstall npm version, use Homebrew version
+brew upgrade codebuddy-code
+
+# Option B: Keep both installations but specify priority
+# Adjust PATH order in ~/.zshrc or ~/.bashrc, placing the npm path first:
+export PATH="$(npm prefix -g)/bin:$PATH"
+```
+
+**Case 2: nvm Node version switch**
+
+npm global packages are installed under the current Node version's directory. After switching Node versions, global packages installed under previous versions are unavailable.
+
+```bash
+# Check current Node version
+node -v
+
+# Reinstall under the current version
+npm install -g @tencent-ai/codebuddy-code@latest
+
+# Or switch back to the Node version used during installation
+nvm use <version-used-during-installation>
+```
+
+**Case 3: Leftover old native binary files**
+
+```bash
+# Check if a native binary version exists
+ls -la ~/.local/bin/codebuddy
+
+# If it exists and is not needed, delete it
+rm ~/.local/bin/codebuddy
+```
+
+**Case 4: Shell cached old path**
+
+Some shells cache command paths. After installing a new version, you need to refresh the cache:
+
+```bash
+hash -r                    # bash / zsh clear command cache
+# Or simply restart the terminal
+```
+
+**Quick verification**:
+
+```bash
+# One command to complete troubleshooting
+echo "Execution path: $(which codebuddy)" && \
+echo "Current version: $(codebuddy --version 2>/dev/null || echo 'not found')" && \
+echo "npm install path: $(npm prefix -g)/bin/codebuddy" && \
+echo "npm version: $(cat "$(npm prefix -g)/lib/node_modules/@tencent-ai/codebuddy-code/package.json" 2>/dev/null | grep '"version"' || echo 'not installed via npm')" && \
+echo "All codebuddy: $(which -a codebuddy 2>/dev/null || where codebuddy 2>/dev/null)"
+```
+
+If the issue persists after troubleshooting, please submit the output of the above commands to the [Issues page](https://cnb.cool/codebuddy/codebuddy-code/-/issues).
+
 ---
 
 ## Migrating from Claude Code