@tencent-ai/codebuddy-code 2.67.0 → 2.68.0

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

@@ -0,0 +1,17 @@
+# 🚀 CodeBuddy Code v2.51.1 Release
+
+## 🔧 Improvements
+
+- **Ctrl+N/P Key Mapping**: Added support for Ctrl+N/Ctrl+P as alternatives to ↓/↑ arrow keys, working across all scenarios including input fields, selection menus, and confirmation panels, providing a smoother experience for users accustomed to Emacs keybindings
+- **Loading State Token Display Optimization**: Fixed the issue where token count displayed as 0 while the main agent waited for a subagent; now correctly shows real-time streaming token changes. Both subagent and Team member progress rows support real-time streaming token display
+- **Session-Level Permission Sync**: When selecting "Don't ask again for this session" during sub-agent execution, the permission is now synced to the main session and all sub-agents, avoiding repeated permission confirmation prompts
+- **MCP Connection Timeout Protection**: Added timeout mechanism for MCP server connection waits, preventing indefinite hangs in headless mode when a server is unresponsive
+- **Team Notification Optimization**: Refactored background task completion notifications to use a mailbox-based delayed deduplication mechanism, preventing duplicate notifications from interrupting conversation flow; fixed queue messages losing sender identity
+- **New Model Support**: Added GPT-5.3-Codex model configuration
+- **Agent Teams Setting Display**: Agent Teams default state in the settings panel now correctly displays as enabled
+
+## 🐛 Bug Fixes
+
+- **Custom Commands Override Built-in Commands**: Fixed the issue where custom slash commands and Skills could not override built-in commands with the same name; now correctly follows project-level > user-level > built-in priority order
+- **Startup UI Rendering**: Fixed welcome Banner duplicate rendering and the display issue where the trust dialog overlapped with Banner content
+- **Background Task Query**: Fixed the "not found" error when querying via TaskOutput after a background Agent was launched

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.51.2 Release
+
+## 🔧 Improvements
+
+- **New Model Support**: Added Gemini 3.0 Pro and Gemini 3.0 Flash model configurations. You can now use these two latest-generation Google models in the model selector, enjoying stronger reasoning capabilities and faster response speeds

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

@@ -0,0 +1,30 @@
+# 🚀 CodeBuddy Code v2.52.0 Release
+
+## ✨ New Features
+
+### Team View Switching
+
+Quickly switch between different team member views using arrow keys. Press `↓` to enter switching mode, `←/→` to select a member, and `Enter` to confirm and switch to that member's view, allowing you to check conversation history and work progress in real time. The highlight preview and input box border color automatically sync when switching, keeping you informed of each member's work status at all times.
+
+### Headless Mode
+
+Added a lightweight headless build (45% smaller in size), supporting `--print`, `--serve`, and `--acp` for quick startup, ideal for CI/CD pipelines and automation integration scenarios.
+
+## 🔧 Improvements
+
+- **Major Startup Performance Boost**: Optimized the startup flow, reducing Application.start() time by 96% and memory usage by 31%, delivering a much smoother startup experience
+- **Bun Native Optimization**: Replaced third-party dependencies (PTY, glob, semver, etc.) with Bun native APIs, improving runtime performance
+- **Dependency Reduction**: Removed unused dependencies to reduce installation size
+- **Authentication Timing Fix**: Ensured authentication completes before API calls, eliminating occasional 401 errors during cold starts
+- **Model Sorting Optimization**: Adjusted default model priority order for the China edition, making commonly used models easier to select
+- **Command Execution Stability**: Optimized command execution and environment initialization flow, reducing execution interruptions under abnormal conditions
+- **Authentication Experience Enhancement**: Improved the robustness of the API Key Helper token acquisition process, enhancing authentication flow stability
+- **Error Handling Upgrade**: Upgraded error handling from string matching to custom error classes, improving error identification reliability
+- **Stream Timeout Auto-Retry**: Automatically retries when model streaming responses time out, requiring no manual intervention. Supports customizing timeout duration via the `CODEBUDDY_STREAM_TIMEOUT` environment variable
+- **Command Suggestion Filtering**: Skills that cannot be invoked directly no longer appear in the slash command suggestion list, keeping the menu clean
+
+## 🐛 Bug Fixes
+
+- **Team Member Tool Permission Confirmation**: Fixed an issue where team members would skip permission confirmation when executing tools. Team members now correctly inherit the main Agent's permission mode; the permission confirmation dialog displays the member's name and dedicated color for easy identification
+- **Plugin MCP Configuration Compatibility**: Fixed an issue where plugin `.mcp.json` did not support flat format. Both wrapped format and flat format are now supported
+- **Team Member Status Display**: Fixed an issue where team members were incorrectly marked as failed due to the cleanup process after successfully completing tasks. Completed members now correctly display their completion status

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

@@ -0,0 +1,28 @@
+# 🚀 CodeBuddy Code v2.52.1 Release
+
+## 🔧 Improvements
+
+### Startup & Stability
+
+- **Instant Version Query**: `cbc -v` / `cbc --version` no longer triggers the full initialization process, significantly improving response speed
+- **Pipe Environment Compatibility**: Subcommands no longer wait for stdin input in non-TTY environments, preventing process hangs
+- **Authentication Timeout Protection**: Authentication initialization automatically times out when the network is unreachable, preventing the CLI from waiting indefinitely
+
+### Team Member Switching Experience
+
+- **Instant Switching**: Use left/right arrow keys to instantly switch team member views without pressing Enter, making the operation smoother
+- **Quick Enter/Exit**: Press the down arrow key to enter selection mode with @main selected by default; press the up arrow key or Esc to exit
+- **Input History Isolation**: History navigation and member selection mode no longer interfere with each other; clearing the input box automatically exits history navigation
+
+### SDK Improvements
+
+- **Python SDK MCP Server Simplification**: Server objects can now be passed directly without manually constructing a dictionary
+- **JS SDK Executable Configuration**: Custom CLI executable file paths and arguments are now supported via `executable` and `executableArgs`
+- **Internal Request Header Filtering**: Internal request headers can be cleaned up via the `CODEBUDDY_SKIP_INTERNAL_HEADERS` environment variable to avoid interfering with third-party API gateways
+
+## 🐛 Bug Fixes
+
+- **Skill Loading**: Fixed an issue where Skills from plugins occasionally failed to load, ensuring correct initialization order
+- **Skill Invocation**: Fixed an issue where Skills with `user-invocable: false` could not be automatically invoked by the model
+- **Team Member Colors**: Fixed duplicate color index assignment when generating Team members concurrently
+- **Sub-agent Concurrency Stability**: Fixed MaxListenersExceededWarning caused by a large number of concurrent sub-agents

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

@@ -0,0 +1,12 @@
+# 🚀 CodeBuddy Code v2.52.2 Release
+
+## 🔧 Improvements
+
+- **Custom Token Authentication**: Supports recognizing custom-token authentication configuration from the ACC_PRODUCT_CONFIG environment variable; fixed an authentication fallback issue when the configuration was loaded but synchronization had not yet completed
+- **Session Loading Performance Optimization**: The `/resume` command now uses parallel reads when loading historical sessions, reducing wait time
+- **Plugin Loading Speedup**: Parallelized the plugin loading process, improving startup speed by several times in multi-plugin scenarios
+
+## 🐛 Bug Fixes
+
+- **/doctor Command**: Fixed an issue where a null session could cause a property access error
+- **SDK Python Build Script**: Updated the goreleaser output directory path to match headless build artifact naming; removed unused imports

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

@@ -0,0 +1,13 @@
+# 🚀 CodeBuddy Code v2.52.3 Release
+
+## 🔧 Improvements
+
+- **Gemini Image Generation Models**: Added three new image generation models — Gemini-3.0-Pro-Image, Gemini-3.1-Flash-Image, and Gemini-2.5-Flash-Image — supporting both text-to-image and image-to-image generation
+- **Ctrl+D Exit Optimization**: Ctrl+D now only triggers the double-press exit flow when the input box is empty and there is no ongoing conversation, preventing accidental exits
+- **Windows Shell Compatibility**: Fixed Shell path selection logic and shell snapshot functionality on Windows, ensuring Git Bash is preferred; improved configuration file detection and encoding handling; correctly identifies non-POSIX shells such as fish and tcsh
+- **MCP Configuration Enhancement**: The `--mcp-config` parameter now supports both file paths and direct JSON format; MCP servers with non-project scope skip the approval check, reducing unnecessary confirmation prompts
+- **Dependency Upgrade**: Upgraded OpenAI Agents SDK to 0.5.2 and OpenAI SDK to v6
+
+## 🐛 Bug Fixes
+
+- **Plugin List Display**: Fixed an issue where plugin skills failed to load correctly after cache clearing

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

@@ -0,0 +1,27 @@
+# 🚀 CodeBuddy Code v2.52.4 Release
+
+## 🔧 Improvements
+
+### First Token Timeout Detection
+
+Added a timeout detection mechanism for the first response data after a request is sent. The connection is automatically disconnected and retried upon timeout, preventing prolonged unresponsive waits. The stream data monitoring interval has been reduced from 10 seconds to 1 second, improving the detection speed of abnormal connections. Custom timeout durations can be configured via the `CODEBUDDY_STREAM_TIMEOUT_MS` and `CODEBUDDY_FIRST_TOKEN_TIMEOUT_MS` environment variables.
+
+### Request Compression
+
+Added support for gzip compression of API request bodies, reducing network bandwidth consumption and improving response speed on slow networks.
+
+- **CLI Subcommand Aliases**: Added `ls` shorthand aliases for `mcp list`, `sandbox list`, and `marketplace list`; added `-g/--global` option for `config remove` and `config add`
+- **macOS Code Signing**: Fixed an issue on macOS 26+ where missing TeamIdentifier caused the system to terminate multiple running instances
+- **MCP Tool Hooks Fix**: Resolved an issue where PreToolUse/PostToolUse hooks for MCP tools failed to trigger correctly
+- **Tool Call Truncation Retry**: Optimized the retry mechanism for tool call parameters truncated due to model output exceeding limits, improving retry success rate
+- **Hook Permission Prompt Optimization**: When a PreToolUse Hook returns an ask decision, the decision reason is now displayed as a warning in the permission confirmation dialog
+- **Paste Behavior Optimization**: Pasting text content no longer automatically detects whether it is an image path and converts it; pasted text is always inserted as-is
+- **Shell Configuration Unification**: Removed support for PowerShell and CMD, requiring Windows users to use Git Bash
+- **Model Upgrade**: Upgraded the Gemini Pro model from version 3.0 to version 3.1
+
+## 🐛 Bug Fixes
+
+- **Input History Navigation**: Fixed an issue where pressing the up arrow to browse history would stop scrolling after reaching an entry starting with `/`
+- **Tool Permission Denial Rendering**: Fixed an issue where tool calls could not be properly rendered in the UI when rejected by PreToolUse hooks or permission rules
+- **Command Parsing**: Fixed an issue where the Bash tool failed to correctly identify the command root when the command contained undefined environment variables
+- **Subcommand Routing**: Fixed incorrect routing paths when invoking subcommands using aliases

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

@@ -0,0 +1,21 @@
+# 🚀 CodeBuddy Code v2.52.5 Release
+
+## 🔧 Improvements
+
+### Image History Optimization
+
+Image data in conversation history is now deduplicated and stored via BlobStore. Only the most recent N turns retain full image data, while earlier turns are automatically replaced with text placeholders, significantly reducing context token consumption. When the same image is read multiple times within the same conversation turn, a reference prompt is returned instead of resending the full data.
+
+### Theme System Refactoring
+
+Expanded the theme color system to support semantic colors (such as success, warning, error, info, etc.) with enhanced terminal color compatibility. Added ChalkFactory for intelligent terminal capability detection, automatic color level adaptation, and support for color-blind-friendly themes.
+
+- **Gzip Compression Compatibility Fix**: Fixed an issue where request bodies were incorrectly compressed during enterprise address login; gzip compression is now only enabled in SaaS and iOA environments
+- **Custom Model URL Handling**: Automatically appends the `/chat/completions` suffix to custom model URLs, so users no longer need to manually construct the full path
+- **Bash Timeout Configuration**: Supports dynamic configuration of the Bash tool timeout via settings env
+
+## 🐛 Bug Fixes
+
+- **Hooks Command Execution**: Fixed an issue where hook commands containing quotes, such as `node -e "..."`, failed to execute
+- **Logout Race Condition Fix**: Fixed an issue where async operations were not terminated in time during logout, causing the session to be written back
+- **Conversation Compression Identifier Correction**: Fixed an issue where the conversation identity was misidentified after async context compression, ensuring compressed messages are correctly attributed to the main conversation

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

@@ -0,0 +1,7 @@
+# 🚀 CodeBuddy Code v2.52.6 Release
+
+## 🔧 Improvements
+
+- **Model Request Logging Enhancement**: Added comprehensive request lifecycle logging, covering key events including request sending, first token arrival, streaming progress, completion/error/timeout, enabling quick issue identification via requestId and agent name
+- **Runtime Warning Elimination**: Fixed the MaxListenersExceededWarning that appeared during long conversations by implementing a unified abort controller management utility, improving stability in long sessions
+- **Hook Message Rendering Enhancement**: Hook messages now display different icons and colors based on execution status (success/blocked/warning/error), with support for expanding/collapsing to view detailed content, improving readability

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

@@ -0,0 +1,29 @@
+# 🚀 CodeBuddy Code v2.53.0 Release
+
+## ✨ New Features
+
+### WeCom Remote Control
+
+Support remote control of CLI via WeCom (WeChat Work), enabling task dispatching and result pushing from mobile devices. Manage your development tasks anytime, anywhere from your phone, no longer limited to operating in front of a terminal.
+
+## 🔧 Improvements
+
+- **MCP Dynamic Tool Updates**: Support `tools/list_changed` notifications from MCP servers, automatically refreshing the tool list when changes occur without requiring a restart or manual reconnection
+- **Reasoning Effort Configuration**: Added a Reasoning Effort setting in the /config panel, supporting five levels: auto/low/medium/high/xhigh, to customize model reasoning depth
+- **Status Bar Enhancement**: Added session name, permission mode, context window usage, and other fields with multi-line rendering support and style optimizations
+- **LSP Server Lazy Loading**: LSP servers now use lazy loading by default, starting only on first use to reduce resource consumption at startup
+- **Error Tracking Enhancement**: WebSearch and ImageGen tools now include requestId in error messages when API calls fail, making it easier to diagnose issues
+- **Non-Interactive Mode Optimization**: Improved prompt messages when tool permissions are denied in print mode, providing clear bypass instructions
+- **File Auto-Completion Refresh**: Fixed an issue where newly added files were not suggested when typing `@`; the file list cache now automatically refreshes after expiration
+- **Skill Tool Result Optimization**: Improved result message formatting after Skill and slash command execution for clearer output
+- **Hook Input Processor**: Added `HookInputProcessor` extension point to support injecting context fields before Hook execution
+- **ACP Error Handling**: Improved error message transmission in ACP mode, allowing clients to receive more detailed error status codes
+
+## 🐛 Bug Fixes
+
+- **Conversation History Restoration**: Fixed an issue where context before compaction was lost when resuming a session after executing compact
+- **Team Abort Signal Isolation**: Sub-agents no longer listen to the main Session's abort signal, preventing internal operations from accidentally killing Teammates
+- **Tool Confirmation Dialog Conflict**: Fixed an issue where confirmation dialogs overlapped when multiple Teammates requested permissions simultaneously
+- **Message Delivery Reliability**: Optimized Teammate message delivery retry mechanism; messages remain unread when the recipient is not ready, waiting for the next polling cycle
+- **Idle Wake-Up Mechanism**: Teammates now automatically wake up the Agent upon receiving messages while idle, instead of getting stuck in the queue
+- **Global Lock Timeout**: Added a 30-second timeout protection for the tool approval global lock to prevent deadlocks

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

@@ -0,0 +1,26 @@
+# 🚀 CodeBuddy Code v2.54.0 Release
+
+## ✨ New Features
+
+### Skills Nested Subdirectories
+
+Skills can now be organized using subdirectories within the `.codebuddy/skills/` directory. Nested Skills automatically generate colon-delimited qualified names (e.g., `category:skill-name`), and short name matching is also supported, making Skills management more flexible and organized.
+
+## 🔧 Improvements
+
+- **Startup optimization**: Eliminated redundant execution during PromptContext initialization; concurrent requests now reuse the same initialization result, improving startup speed
+- **Model selection optimization**: Improved model selection mechanism across different agent modes, enhancing configuration flexibility
+- **MCP config environment variable expansion**: `${VAR_NAME}` placeholders in MCP server configurations are now automatically replaced with the corresponding environment variable values. Supports command/args/env for stdio and url/headers for SSE/HTTP transports. Missing variables are left as-is with a diagnostic message generated
+- **Context compaction stability**: Fixed an issue where message enqueuing during automatic compaction prevented compaction from executing, and improved robustness of interrupt waiting. Also fixed internal continuation messages displaying incorrectly in the chat UI during compaction
+- **Vim word motion enhancement**: Word motions (w/b/e) in Vim mode and keybindings now correctly support CJK characters, treating each CJK character as an individual word
+- **Gzip compression optimization**: Gzip compression is now automatically skipped when a custom API endpoint is configured or when a model uses a custom URL, preventing request failures caused by third-party services that do not support gzip
+- **Hook output encoding fix**: Fixed garbled error messages from Hook scripts on Chinese Windows systems
+- **/skills panel enhancement**: The Skills panel now also displays custom slash commands, with group headers showing the source directory path. Token counting now only includes the description portion, avoiding misconceptions about context usage
+- **Truncation retry optimization**: When tool call parameters are too long causing output truncation, retry prompts now provide specific splitting suggestions based on tool type. Also fixed a potential infinite retry loop
+- **Remote control stability**: Optimized WebSocket adapter implementation and session handling logic, improving connection stability
+- **Task panel refresh**: Fixed an issue where the task detail view did not refresh when task status was updated
+
+## 🐛 Bug Fixes
+
+- **Plan confirmation dialog**: Fixed the Plan mode exit confirmation dialog incorrectly displaying "Loading plan..." — it now properly loads and shows the Plan content
+- **Custom Agents source display**: Fixed Custom Agents from plugin sources showing `undefined` in the `/context` command

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

@@ -0,0 +1,21 @@
+# 🚀 CodeBuddy Code v2.55.0 Release
+
+## ✨ New Features
+
+### Git Worktree Support
+
+The new Worktree feature allows you to develop in parallel across isolated working directories without interference:
+
+- Use the `--worktree` flag to launch an isolated development environment for safe experimental changes
+- Combine with the `--tmux` flag to run in a dedicated tmux session, ideal for long-running tasks
+- Agents can dynamically create and enter worktrees during a session via the EnterWorktree tool
+- Sub-agent tasks automatically inherit the worktree working directory, ensuring correct file operation paths
+- Supports `WorktreeCreate` and `WorktreeRemove` event hooks for custom VCS integration
+- Automatically detects changes on exit and provides clear action options; worktrees with no changes are cleaned up automatically
+
+## 🔧 Improvements
+
+- **Tool search optimization**: ToolSearch now supports both search and activate modes — search mode displays activated tools and candidates in a layered view, while activate mode enables precise activation by name
+- **Status bar line wrapping**: Long text in the status bar now wraps automatically instead of being truncated
+- **Diff wide character handling**: Fixed inaccurate line wrapping in the Diff view when content contains wide characters such as Chinese text or Emoji
+- **Message identification optimization**: Improved user message identification logic to exclude teammate messages automatically sent by the framework

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

@@ -0,0 +1,13 @@
+# 🚀 CodeBuddy Code v2.55.1 Release
+
+## 🔧 Improvements
+
+- **MCP environment variable defaults**: MCP configuration now supports the `${VAR:-default}` syntax, automatically using the specified default value when an environment variable is not set, simplifying MCP server configuration
+- **Worktree initialization improvements**: Enhanced symlink creation logic with automatic file/directory type detection and conflict handling; improved `.worktreeinclude` file processing for better performance in large repositories
+- **Hooks Windows path compatibility**: Fixed path parsing issues when executing hooks via Git Bash on Windows where backslashes caused failures, now uniformly converting to Unix-style paths
+
+## 🐛 Bug Fixes
+
+- **SDK authentication fix**: Fixed an issue where the authentication URL was incorrectly overwritten during login
+- **Environment configuration protection**: Fixed an issue where network environment settings explicitly configured by users via `.env` or `settings.json` were automatically overridden
+- **SessionStart hook race condition fix**: Fixed an issue where the first message could be processed before the SessionStart hook completed, causing injected context to be lost

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

@@ -0,0 +1,20 @@
+# 🚀 CodeBuddy Code v2.56.0 Release
+
+## ✨ New Features
+
+### Worktree PR Support
+
+Support for creating worktrees from CNB (Code Nebula Buddy) platform PR links, including domains such as cnb.woa.com and cnb.cool. Within a worktree, you can directly perform code review and modifications based on a PR.
+
+## 🔧 Improvements
+
+- **New GPT-5.4 model**: Supports 272K input, 128K output, with reasoning and image capabilities
+- **MCP panel optimization**: Removed borders, grouped server list by configuration source, added diagnostic information display for a cleaner and more intuitive interface
+- **Model compatibility layer**: Added a model compatibility handler that automatically adapts API request format differences for third-party models such as Gemini and Moonshot, reducing manual configuration
+- **Error diagnostics enhancement**: Improved error logging for model requests and SDK Transport, supporting streaming error response body reading and process close reason capture for easier troubleshooting
+- **Tool search optimization**: Split search and activate operations into separate parameters for clearer invocation; unmatched tool names now automatically fall back to fuzzy search
+- **User query identification**: Added tag wrapping for user messages to help models more accurately distinguish actual user queries from system context content
+
+## 📝 Documentation Updates
+
+- **MCP environment variable expansion documentation**: Added documentation for environment variable expansion usage, including syntax descriptions, supported configuration fields, examples, and common use cases

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.56.1 Release
+
+## 🐛 Bug Fixes
+
+- **Conversation Compression Display**: Fixed the completion detection logic for compressed conversation groups by checking for the presence of an assistant reply instead of a fixed message count, preventing abnormal compression state display in edge cases

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

@@ -0,0 +1,32 @@
+# 🚀 CodeBuddy Code v2.57.0 Release
+
+## ✨ New Features
+
+### Remote Gateway (Beta)
+
+A brand-new remote control feature that allows you to remotely access your CodeBuddy Code CLI session from any device via Cloudflare Tunnel. It comes with a full-featured Web UI, including:
+
+- Remote terminal panel with split-screen layout and real-time WebSocket communication
+- Interactive Q&A panel for answering Agent questions directly from the Web UI
+- Visual display of conversation compression and Team progress
+- Secure authentication and multi-client synchronization
+
+### Scheduled Tasks
+
+Create scheduled tasks to let CodeBuddy automatically perform repetitive work on a set schedule. Simply define execution intervals using cron expressions, with support for viewing and canceling created tasks.
+
+## 🔧 Improvements
+
+- **Hook Output Collapse Configuration**: Added the `hookOutputCollapsed` setting, which can be configured via the `/config` panel to control whether Hook output is collapsed by default
+- **First Token Timeout Detection Optimization**: Now detects meaningful model output instead of raw responses, preventing server heartbeats from invalidating timeout detection, with enhanced retry mechanism stability
+- **Sub-agent MCP Inheritance**: Sub-agents can now correctly use MCP server tools configured by the parent agent
+- **Fish Shell Keyboard Compatibility**: Fixed unresponsive key input in Fish shell 3.4+ when used with terminals supporting the Kitty keyboard protocol
+- **Tool Search Parameter Optimization**: Enhanced parameter descriptions to provide better usage guidance
+
+## 🐛 Bug Fixes
+
+- **API Error Response Handling**: Fixed an issue where the UI would freeze when the API returned errors (e.g., rate limiting)
+- **MCP OAuth Authentication**: Fixed OAuth Provider cache lookup failures to ensure a stable and reliable authentication flow
+- **Memory Leak Warning**: Fixed MaxListenersExceededWarning caused by abort listeners exceeding the limit during long-running sessions
+- **Streaming Output Format**: Fixed formatting and completeness issues with JSON output
+- **Hooks Chinese Encoding**: Fixed garbled Chinese characters when Hooks modified tool parameters on Windows

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

@@ -0,0 +1,10 @@
+# 🚀 CodeBuddy Code v2.57.1 Release
+
+## 🔧 Improvements
+
+### Headless Mode Scheduled Task Support
+
+Headless mode now includes the export of scheduled task capabilities. In scripts, SDK, and server-side integration scenarios, you can use scheduled task features more directly, reducing the need for additional wrappers and integration overhead.
+
+- Supports direct access to scheduled task capabilities in headless integration scenarios
+- Brings feature parity between scripts, SDK, and the interactive CLI

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

@@ -0,0 +1,34 @@
+# 🚀 CodeBuddy Code v2.58.0 Release
+
+## ✨ New Features
+
+### WeChat KF & WeCom Remote Gateway
+
+Added support for WeChat KF (WeChat Customer Service) and WeCom (Enterprise WeChat) platform integrations. Supports receiving messages and sending replies via Webhook callbacks. The WeChat KF adapter includes full capabilities: callback signature verification, AES encryption/decryption, sync_msg message polling, and automatic customer service account creation.
+
+## 🔧 Improvements
+
+- **Python SDK Authentication Enhancement**: Added standalone authentication APIs (`authenticate`/`logout`), supporting two-phase login flow; refactored control request mechanism to support request-response matching and timeout handling
+- **Python SDK Type Improvements**: Added type definitions for `McpServerStatus`, `AuthenticateResponse`, `UserInfo`, and more
+- **SDK Error Diagnostics**: Python SDK added startup crash detection and stderr capture; JS SDK improved process exit reason tracking and error type exports
+- **Headless Mode Stability**: Refactored module exports to a three-layer structure, eliminating IoC resolution failures in headless builds
+- **Tunnel Connection Optimization**: Forced HTTP/2 over QUIC for better compatibility; support for detached cloudflared process reuse across sessions; added tunnel-state.json to manage concurrent multi-port tunnels
+- **Plugin Marketplace Auto-Update**: Added enable/disable auto-update toggle on marketplace detail pages; built-in marketplace defaults to enabled, third-party marketplaces default to disabled
+- **Config Cache Isolation**: Fixed an issue where temporary CLI parameters (e.g., `--system-prompt`) would pollute the configuration cache
+- **Web UI Improvements**: History playback now displays images in user messages with zoom-in support; sub-agents support collapse/expand; tool calls are uniformly clickable
+- **Web UI Bun SFE Compatibility**: Support for embedding static files into Bun single-file executables, compatible with resource loading in flat mode
+- **Gateway Command Experience**: Added loading animation when starting the Gateway service to prevent repeated user actions
+- **Task Progress Display**: Optimized text truncation for task and teammate descriptions in the loading-box to prevent overflow from long text
+
+## 🎨 UI Improvements
+
+- **Dark Theme Visual Refinement**: Dimmed and unified border colors of various components in dark mode, making them softer and more natural against dark backgrounds
+
+## 🐛 Bug Fixes
+
+- **Hooks Execution Hang**: Fixed an issue where hook scripts launching background processes caused execution to hang
+- **SubagentStop Hook**: Fixed an issue where `transcript_path` in the callback pointed to a non-existent file
+- **Sub-agent Interaction**: Fixed an issue where `AskUserQuestion` in sub-agents was auto-approved, preventing the question panel from appearing in the main interface
+- **Compact History Chain**: Fixed incomplete context caused by history truncation in the compact agent; corrected grouping errors in scenarios with multiple consecutive assistant messages
+- **Tool Approval Navigation**: Fixed a rendering issue where the input box became invisible after the confirmation dialog disappeared
+- **Model Sync**: Fixed an issue where switching models in Web UI did not synchronize to the CLI

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

@@ -0,0 +1,28 @@
+# 🚀 CodeBuddy Code v2.59.0 Release
+
+## ✨ New Features
+
+### Hook-Driven Worktree Support
+
+Provides isolated workspace capability for non-Git version control systems such as SVN and Perforce. Through the `WorktreeCreate` and `WorktreeRemove` Hook events, you can fully customize the creation and cleanup logic for worktrees, no longer limited to Git repositories:
+
+- Even in a Git repository, if `WorktreeCreate` Hook is configured, the Hook-based approach takes priority
+- Hook-based worktrees always display the keep/delete menu on exit, preventing errors in non-Git projects caused by missing Git commands
+
+### Worktree Base Branch Specification
+
+The `--worktree` parameter now supports using `--worktree-branch <branch>` to specify the base branch:
+
+- Supports both remote branches (`origin/develop`) and local branches (`feature/foo`)
+- Automatically falls back to the remote default branch with a warning when the specified branch does not exist, without interrupting the startup process
+- The `EnterWorktree` tool now supports the `branch` parameter as well
+
+## 🔧 Improvements
+
+- **Plan Mode Approval**: Fixed an issue where the ExitPlanMode tool could not correctly display plan content when approving in the Web UI. Users can now see the complete plan content and permission request list in the approval dialog
+- **Image Read Deduplication**: Fixed an issue where an image at the same path was incorrectly deduplicated after being modified. The system now correctly detects file updates and returns the latest image content
+- **Worktree Hook Compatibility**: Completed the SDK protocol and documentation for `WorktreeCreate` and `WorktreeRemove`, ensuring custom worktree hooks receive full context and can integrate stably
+
+## 🐛 Bug Fixes
+
+- **ACP Connection Cleanup**: Fixed an issue where old connections were not properly cleaned up when starting a new chat, causing broadcast messages to be rendered multiple times

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.6.0 Release
+
+## ✨ New Features
+
+- GPT-5.1 Series Models: Added three new model options - GPT-5.1, GPT-5.1-codex, and GPT-5.1-codex-mini, offering larger context windows (supporting up to 272K tokens input) and enhanced reasoning capabilities, perfect for complex code analysis and long document tasks

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

@@ -0,0 +1,10 @@
+# 🚀 CodeBuddy Code v2.6.1 Release
+
+## 🔧 Improvements and Optimizations
+
+- Error Handling Enhancement: Improved server-side request error handling mechanism, enhancing the accuracy and readability of error messages for more efficient issue troubleshooting
+
+## 🐛 Bug Fixes
+
+- Image Paste Optimization: Optimized clipboard image reading mechanism, improved multi-file paste support, and enhanced the stability and reliability of image pasting
+- Plugin Marketplace Deduplication: Fixed the issue where duplicate entries might appear when loading the plugin marketplace. Now automatically filters marketplaces with the same name and source, improving interface cleanliness

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

@@ -0,0 +1,20 @@
+# 🚀 CodeBuddy Code v2.60.0 Release
+
+## ✨ New Features
+
+### WeCom Bot Remote Control
+
+Supports remotely controlling CodeBuddy Agent via WeCom AI Bot persistent connection — no public IP required. Use the `/wecom-bot` command to quickly connect. The remote control module has also been refactored into an extensible multi-client registration architecture, making it easier to integrate additional IM platforms in the future.
+
+## 🔧 Improvements
+
+- **Custom Model Auth Error Optimization**: When a custom model returns a 401 error, automatic logout is no longer triggered. A targeted API Key check prompt is provided instead. When the specified model does not exist, the list of models available under the current account is automatically displayed.
+- **Resume Session Panel**: The currently active session is highlighted in green with a checkmark, making it easy to identify at a glance.
+- **Web Slash Command Handling**: Removed client-side slash command interception — all command logic is now handled uniformly by the server.
+
+## 🐛 Bug Fixes
+
+- **Image History Restoration**: Fixed a timing issue with image blob reference tracking to ensure correct deduplication of historical images, preventing unresolved blob references from being sent to the model.
+- **Nested Skills Loading**: Fixed an issue where directories containing sub-Skills could not be discovered and loaded. Also increased the scan depth limit to support deeper nested structures.
+- **Skip Internal Request Headers**: Fixed an issue where the `CODEBUDDY_SKIP_INTERNAL_HEADERS` environment variable had no effect, ensuring internal request headers are correctly stripped when connecting to third-party gateways.
+- **Tracing Initialization**: Fixed a "No API key provided for OpenAI tracing exporter" error appearing in some users' terminals.

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

@@ -0,0 +1,29 @@
+# 🚀 CodeBuddy Code v2.61.0 Release
+
+## ✨ New Features
+
+### Memory System Overhaul
+
+- **# Shortcut for Saving Memories**: The `#` shortcut now saves memories to `CODEBUDDY.md`, with support for selecting either Project or User scope, providing more flexible management of personal and project-level preferences.
+- **Auto Memory Independent Control**: A new `/memory` management panel has been added, supporting independent toggling of Auto Memory. It can also be switched via the `/config` panel.
+- **Typed Memory (Experimental)**: Supports 4 structured memory types (`user` / `feedback` / `project` / `reference`) and YAML frontmatter format for more organized memory management.
+- **/memory Command with Arguments**: Supports saving memories directly via command arguments, without needing to navigate to the management page.
+
+## 🔧 Improvements
+
+- **Decoupled Tool Search and Execution**: ToolSearch now returns the full parameter schema for the agent to execute, keeping the context prefix stable to improve KV cache hit rates.
+- **Context Management Optimization**: Lowered the token usage warning threshold so context compression triggers earlier, reducing degradation in conversation quality caused by excessively long contexts.
+- **Shell Performance Optimization**: Optimized the PTY fd leak detection mechanism to avoid blocking the event loop.
+- **WeCom Bot Timeout Fix**: Adopted a two-phase reply mechanism to avoid the 30s streaming timeout issue, allowing long-running Agent tasks to return results correctly.
+- **Web UI Session Sync**: When `/clear` is executed or a new conversation is created in the Web UI, the CLI terminal view refreshes in sync.
+- **File Path Completion**: The Web UI input box now supports `@`-triggered file path completion, automatically adding a space after selection.
+- **Prompt Suggestions**: The Web UI now displays prompt suggestions generated on the CLI side; press Tab to quickly accept them.
+
+## 🐛 Bug Fixes
+
+- **Tool Call Retry**: Fixed an issue where invalid JSON parameters returned by the model caused an immediate 400 error. The model is now informed of the specific JSON parse error and retries automatically.
+- **Sub-agent Hook Isolation**: Skips execution of Stop/UserPromptSubmit hooks for sub-agent sessions to prevent sub-agents from triggering hooks intended only for the main session.
+- **SubagentStop Hook Race Condition Fix**: Prevents duplicate hook triggers caused by concurrent detection paths.
+- **Permission Wildcard Matching**: Fixed an issue where wildcard permission rules such as `Bash(ls *)` failed to match commands containing path arguments.
+- **Web UI Clear Session**: Fixed an abnormal duplicate render loop triggered after `/clear`.
+- **Slash Command Loading**: Fixed an issue where the slash command list could not be loaded when accessed via tunnel.

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.61.1 Release
+
+## 🔧 Improvements
+
+- **SDK Version Update**: Upgraded Agent SDK JS to 0.3.81, keeping the SDK in sync with the CLI version

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

@@ -0,0 +1,6 @@
+# 🚀 CodeBuddy Code v2.61.2 Release
+
+## 🔧 Improvements
+
+- **WeCom AI Bot WebSocket Compatibility**: Migrated WebSocket implementation to the W3C standard API, supporting both Bun and Node.js runtimes for improved cross-platform compatibility
+- **WeCom AI Bot Auto-Connect**: Added `--wecom-bot` startup parameter to automatically connect to WeCom AI Bot on launch, eliminating the need to manually run the `/wecom-bot` command

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

@@ -0,0 +1,13 @@
+# 🚀 CodeBuddy Code v2.61.3 Release
+
+## 🔧 Improvements
+
+- **Improved Startup Stability**: Fixed startup failures caused by authentication initialization timeout and asynchronous initialization of the remote control service during CLI startup, improving cold start success rate
+- **Moonshot Model Compatibility**: Optimized tool message content parsing logic to prevent plain string arrays (such as file path lists) from being incorrectly converted to content blocks, improving tool call stability for Moonshot models
+- **Plugin Update Mechanism Optimization**: Switched to a fetch + reset strategy instead of pull, resolving plugin update failures when the local and remote branches of the plugin Git repository diverge
+- **SDK Interaction Fix**: Fixed an issue where interactive tools (such as AskUserQuestion) were unexpectedly disabled in SDK mode, while ensuring interactive tools are properly disabled in Print mode
+- **Web Search Upgrade**: Migrated to the new search API with optimized response parsing and error handling
+
+## 🐛 Bug Fixes
+
+- **Third-Party API Connection Fix**: Fixed an issue where the Authorization header was incorrectly removed when connecting to third-party APIs using `CODEBUDDY_SKIP_INTERNAL_HEADERS` mode, causing 401 errors. Also filters `x-stainless-*` headers to avoid 400 errors

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

@@ -0,0 +1,21 @@
+# 🚀 CodeBuddy Code v2.62.0 Release
+
+## ✨ New Features
+
+### Delegate Tool Support (Experimental)
+
+Added the DelegateTool, which allows Agents to invoke delegate tools registered by external clients (such as Web UI or IDE plugins) to enable UI querying and UI control capabilities. This provides more flexible extensibility for integrating CodeBuddy Code with external toolchains.
+
+## 🔧 Improvements
+
+- **Remote Control Refactoring**: Unified the `/wecom-bot` command into a general-purpose `/remote-control` command, supporting unified management of multiple long-lived connection clients, with a new interactive UI panel for quick client connection selection
+- **Fast Local Command Execution for Remote Control**: Added a mechanism to quickly detect local commands, avoiding unnecessary waiting prompts for local commands like `/clear` and `/skills`
+- **Enhanced Model Compatibility**: Added an OpenAI model adapter to automatically handle incompatible parameters; the Gemini adapter now includes JSON Schema field cleanup, fixing 400 errors caused by tool parameters
+- **Stream Timeout Optimization**: Adjusted the default stream timeout from 30 seconds to 60 seconds, with new smart detection to prevent completed responses from being incorrectly identified as timed out
+- **Bash Tool Description Optimization**: Provided clearer description examples for complex commands and refined the dangerous command list
+- **Memory Path Structure**: Aligned project memory directories to the standard path structure, fixing incomplete path display in menus
+
+## 🐛 Bug Fixes
+
+- **ACP Session Management**: Fixed an issue where newSession requests reused old sessions by default, switching to an explicit `continue` field to control session reuse behavior
+- **AbortController Leak**: Unified usage of `createAbortController()` to prevent listener accumulation warnings during long sessions

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

@@ -0,0 +1,11 @@
+# 🚀 CodeBuddy Code v2.62.1 Release
+
+## 🔧 Improvements
+
+- **Context Compression Optimization**: Refactored the compression summary injection mechanism so that compressed context is restored in a more structured way, improving context coherence in long conversations. Also raised the auto-compression trigger threshold to reduce unnecessary compression interruptions. The compression process no longer mixes in system rules and memory content, ensuring more accurate summaries
+- **SDK Communication Stability**: Fixed multiple stability issues in the SDK communication layer, including concurrent write interleaving, permission requests hanging after disconnection, and incomplete interrupt responses. The Python SDK enhanced JSON buffer fault tolerance, and the JS SDK improved backpressure handling
+- **WeCom Bot Interaction Experience**: Replaced static text with streaming messages for processing status display, automatically replacing with final results upon completion for a cleaner chat history
+
+## 📝 Documentation Updates
+
+- **WeCom Bot Documentation Navigation**: Unified sidebar titles for related documentation and fixed duplicate entries in the Chinese version

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

@@ -0,0 +1,19 @@
+# 🚀 CodeBuddy Code v2.63.0 Release
+
+## ✨ New Features
+
+### Disable TLS Verification
+
+Support disabling TLS certificate verification for HTTPS requests via a product feature toggle. This is designed for private deployment environments using self-signed certificates or internal CA certificates, allowing connections without additional system certificate configuration.
+
+## 🔧 Improvements
+
+- **Plugin Marketplace Tracking**: Added tracking events for plugin marketplace operations, supporting actions such as marketplace add/remove/refresh, plugin install/uninstall/enable/disable, to help optimize the plugin ecosystem experience
+- **Centrifugo Connection Strategy**: Disabled Centrifugo auto-connection in favor of on-demand manual startup, reducing unnecessary network overhead
+- **Configuration Panel Cleanup**: Removed deprecated Wecom configuration items from the /config panel for a cleaner interface
+
+## 🐛 Bug Fixes
+
+- **Auto-Retry Race Condition Fix**: Fixed an issue where the `agent_end` event was emitted prematurely during network error auto-retry, causing the parent task to incorrectly determine that the sub-agent had failed
+- **Timeout Duration Optimization**: Increased streaming timeout and first-token timeout from 60 seconds to 120 seconds, reducing false disconnections in weak network environments
+- **Context Compression Stability**: Fixed an issue where abort signal cascading during compression caused the session to freeze, improving reliability in long conversation scenarios

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.63.1 Release
+
+## 🐛 Bug Fixes
+
+- **Malformed JSON Context Pollution Fix**: Fixed an issue where retry prompt messages were not cleaned up in time when the AI model occasionally generated malformed tool call parameters. Previously, these prompt messages were repeatedly sent to the model in every subsequent conversation turn, causing context pollution and unnecessary token consumption. After the fix, retry prompts are automatically cleaned up in the next conversation turn, keeping the conversation context clean

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

@@ -0,0 +1,7 @@
+# 🚀 CodeBuddy Code v2.63.2 Release
+
+## 🔧 Improvements
+
+- **Timeout Retry Enhancement**: First-token timeout now supports up to 2 retries with linear delay (2s/4s), improving recovery success rate during network fluctuations
+- **Message Queue Processing**: Fixed an issue where accumulated user messages in the queue could not be processed after timeout error handling, ensuring smooth conversation flow
+- **State Consistency**: Fixed race conditions in state reset logic during error handling, ensuring correctness of retries and queue processing

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

@@ -0,0 +1,6 @@
+# 🚀 CodeBuddy Code v2.63.3 Release
+
+## 🔧 Improvements
+
+- **Subagent Context Compression Fix**: Fixed the issue where subagents could not resume after context compression, ensuring stability for subagent execution in long conversation scenarios
+- **Context Compression Quality Improvement**: Fixed the issue where internal tags might leak into summarized content during compression, improving the accuracy of compressed context