@tencent-ai/agent-harness 0.2.0-beta.7 → 0.2.0-beta.8

package/cli/dist-server/types/node/command/add-dir-command-executor.d.ts

@@ -0,0 +1,11 @@
+import { NavigationManager } from '../navigation';
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class AddDirCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly navigationManager: NavigationManager;
+    protected readonly sessionManager: SessionManager;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/agent-mode-command-executor.d.ts

@@ -0,0 +1,11 @@
+import { NavigationManager } from '../navigation';
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class AgentModeCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly navigationManager: NavigationManager;
+    protected readonly sessionManager: SessionManager;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/agents-command-executor.d.ts

@@ -0,0 +1,9 @@
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class AgentsCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly sessionManager: SessionManager;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/auto-compact-command-executor.d.ts

@@ -0,0 +1,20 @@
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { SettingsManager } from '../settings';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+/**
+ * `/autocompact <auto | 400k | 1m | 400000>` —— 设置自动压缩窗口大小，写入 user settings
+ * 的 `autoCompactWindow`（对齐 Claude Code 的 `/autocompact`）。
+ *
+ * - `auto`：清空 `autoCompactWindow`，回到「跟随模型窗口」
+ * - token 数（支持 1000 进制 k/m 后缀）：写入 clamp 到 [100k, 1M] 后的值
+ * - 无参数：显示当前生效值
+ */
+export declare class AutoCompactCommandExecutor implements CommandExecutor {
+    name: string;
+    autoGenerateHistory: boolean;
+    protected readonly sessionManager: SessionManager;
+    protected readonly settingsManager: SettingsManager;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    private describeCurrent;
+    private output;
+}

package/cli/dist-server/types/node/command/background-command-executor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `/background`（别名 `/bg`）—— 把当前会话搬到后台，前台退出。
+ *
+ * 对照 Claude Code v2.1.216 bundle 559597-559606 / 768141-768163：
+ * - 已经是后台会话 → 等价 detach，不新建
+ * - 持久化关闭 → 拒绝
+ * - 一条消息都还没有 → `Nothing to background yet — send a message first.`
+ * - 成功 → spawn 后打印后续命令提示
+ */
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { type Session } from '../../vendor/cbc-core/node/index.js';
+import { SettingsManager } from '../settings';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class BackgroundCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly sessionManager: SessionManager;
+    protected readonly settingsManager: SettingsManager;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    protected failureMessage(reason: string): string;
+    protected isAgentViewDisabled(): Promise<boolean>;
+    protected isPersistenceDisabled(): Promise<boolean>;
+    protected say(session: Session, text: string): Promise<void>;
+}
+/** `/bg` —— `/background` 的别名（对照 Claude `aliases: ["bg"]`） */
+export declare class BgCommandExecutor extends BackgroundCommandExecutor {
+    name: string;
+}

package/cli/dist-server/types/node/command/bash-command-executor.d.ts

@@ -0,0 +1,62 @@
+import { Event } from '@celljs/core';
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { ShellExecutionHandle, ShellService } from '../shell';
+import type { AnsiOutput } from '../shell/terminal-serializer';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+/**
+ * 交互式 Shell 状态事件
+ */
+export interface InteractiveShellState {
+    /** 是否处于交互式模式 */
+    active: boolean;
+    /** Shell 执行句柄，用于写入数据和获取屏幕内容 */
+    handle?: ShellExecutionHandle;
+    /** 正在执行的命令 */
+    command?: string;
+}
+/**
+ * 交互式 Shell 管理器
+ * 用于在 UI 层和命令执行器之间共享交互式 shell 状态
+ */
+export declare const InteractiveShellManager: unique symbol;
+export interface InteractiveShellManager {
+    /** 当前交互式 shell 状态变化事件 */
+    readonly onStateChange: Event<InteractiveShellState>;
+    /** 获取当前状态 */
+    getState(): InteractiveShellState;
+    /** 设置交互式 shell 状态 */
+    setState(state: InteractiveShellState): void;
+    /** 向当前 shell 写入数据 */
+    write(data: string): void;
+    /** 获取当前屏幕内容（纯文本） */
+    getScreen(): string;
+    /** 获取当前屏幕内容（带颜色） */
+    getColorScreen(): AnsiOutput;
+    /** 调整终端大小 */
+    resize(cols: number, rows: number): void;
+    /** 终止当前进程 */
+    kill(): Promise<void>;
+}
+export declare class InteractiveShellManagerImpl implements InteractiveShellManager {
+    private state;
+    private readonly _onStateChange;
+    readonly onStateChange: Event<InteractiveShellState>;
+    getState(): InteractiveShellState;
+    setState(state: InteractiveShellState): void;
+    write(data: string): void;
+    getScreen(): string;
+    getColorScreen(): AnsiOutput;
+    resize(cols: number, rows: number): void;
+    kill(): Promise<void>;
+}
+export declare class BashCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly shellService: ShellService;
+    protected readonly sessionManager: SessionManager;
+    protected readonly interactiveShellManager: InteractiveShellManager;
+    protected readonly logger: Logger;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/btw-command-executor.d.ts

@@ -0,0 +1,13 @@
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+/**
+ * /btw (By The Way) Command Executor
+ *
+ * Registration only: the TUI routes both bare and inline /btw to BtwPanel.
+ * Tool-enabled tasks are created only by the panel's explicit f action.
+ */
+export declare class BtwCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    execute(_ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/clear-command-executor.d.ts

@@ -0,0 +1,17 @@
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { SessionHookManager, SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class ClearCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly sessionManager: SessionManager;
+    protected readonly sessionHookManager: SessionHookManager;
+    protected readonly logger: Logger;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    /**
+     * Notify ACP clients that session has been reset via session_info_update.
+     * This allows Web UI to update its sessionId and clear chat history.
+     */
+    private notifySessionReset;
+}

package/cli/dist-server/types/node/command/command-manager.d.ts

@@ -0,0 +1,54 @@
+import { Deferred } from '@celljs/core';
+import { Session, SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { type WorkflowRegistry } from '../../workspace/cbc-workflow/lib/node/index.js';
+import { Command, ProductManager } from '../../workspace/product/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { CommandExecuteContext, CommandExecutor, CommandManager } from './command-protocol';
+export declare const FUNCTION_HOOK_COMMAND_TAG = "function-hook-command";
+/** The host owns live commands and tombstones; refresh must not resurrect withdrawn entries. */
+export interface ModsCommandManager extends CommandManager {
+    register(command: Command, executor?: CommandExecutor): Promise<void>;
+    isUnregistered(name: string): boolean;
+}
+export declare class CommandManagerImpl implements CommandManager {
+    protected readonly productManager: ProductManager;
+    protected readonly sessionManager: SessionManager;
+    protected readonly commandExecutors: CommandExecutor[];
+    protected readonly workflowRegistry?: WorkflowRegistry;
+    protected readonly logger?: Logger;
+    protected readyDeferred: Deferred<void>;
+    protected commands: Map<string, Command>;
+    protected commandExecutorMap: Map<string, CommandExecutor>;
+    private readonly registrations;
+    executingCommand: CommandExecuteContext;
+    protected init(): void;
+    private scopedCommands;
+    get(name: string): Promise<Command | undefined>;
+    register(command: Command, executor?: CommandExecutor): Promise<void>;
+    unregister(name: string): Promise<void>;
+    isUnregistered(name: string): boolean;
+    private registeredNonModelCommands;
+    /**
+     * 强制重扫命令源(目前主要是 saved workflow registry)。
+     * `saveAs` 写完文件后调一下,让新工作流的 `/<name>` 立刻可被识别 + 出现在补全里。
+     *
+     * 不重读 ProductManager(那有自己的 subscribe);仅刷"动态可变"的部分。
+     */
+    refresh(): Promise<void>;
+    getAll(): Promise<Command[]>;
+    protected rebuildCommands(): Promise<void>;
+    private injectSavedWorkflowCommands;
+    getNonModelCommands(): Command[];
+    getAllNonModelCommands(): Command[];
+    getEnabledNonModelCommands(): Promise<Command[]>;
+    getCustomCommands(): Promise<Command[]>;
+    getMcpCommands(): Promise<Command[]>;
+    isOverriddenByCustom(name: string): boolean;
+    isLocalCommand(command: string): boolean;
+    parseCommand(input: string): {
+        name: string;
+        args: any[];
+    } | undefined;
+    executeLocalCommand(ctx?: CommandExecuteContext): Promise<void>;
+    finalizeCommandExecution(session: Session, stdout?: string): Promise<void>;
+}

package/cli/dist-server/types/node/command/command-protocol.d.ts

@@ -0,0 +1,106 @@
+import { InputText, Session } from '../../vendor/cbc-core/node/index.js';
+import { Command } from '../../workspace/product/lib/common/index.js';
+export declare const CommandManager: unique symbol;
+export declare const CommandExecutor: unique symbol;
+export declare const CustomCommandRenderer: unique symbol;
+export declare const McpPromptRenderer: unique symbol;
+/**
+ * XML 标签枚举，用于命令序列化和反序列化
+ */
+export { CommandXmlTags } from '../../vendor/cbc-shared/node/index.js';
+export interface CommandManager {
+    get(name: string): Promise<Command | undefined>;
+    register(name: Command): Promise<void>;
+    unregister(name: string): Promise<void>;
+    getAll(): Promise<Command[]>;
+    /**
+     * 重扫命令源(包括 saved workflow registry)。
+     * saveAs 完成 / 用户手动同步 workflows 目录后调用,让 `/<name>` 立刻可用且出现在补全里。
+     */
+    refresh(): Promise<void>;
+    getNonModelCommands(): Command[];
+    /** 获取所有内置命令（包括条件命令，同步），用于命令解析和路由 */
+    getAllNonModelCommands(): Command[];
+    /** 获取所有启用的内置命令（包括条件命令，异步） */
+    getEnabledNonModelCommands(): Promise<Command[]>;
+    getCustomCommands(): Promise<Command[]>;
+    getMcpCommands(): Promise<Command[]>;
+    /** 判断内置命令是否被自定义命令或 Skill 覆盖（同步） */
+    isOverriddenByCustom(name: string): boolean;
+    /** 判断命令是否为内置命令（本地执行的命令） */
+    isLocalCommand(command: string): boolean;
+    parseCommand(input: string): {
+        name: string;
+        args: any[];
+    } | undefined;
+    executeLocalCommand(ctx?: CommandExecuteContext): Promise<void>;
+    finalizeCommandExecution(session: Session, stdout?: string): Promise<void>;
+}
+export interface CommandExecutor {
+    name: string;
+    message?: string;
+    autoGenerateHistory?: boolean;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}
+export interface CustomCommandRenderer {
+    render(command: Command, input: string): Promise<string>;
+    /**
+     * Process markdown content with inline bash execution, argument replacement, and file references.
+     * Pipeline: $ARGUMENTS replacement → !`command` execution → @file reference processing
+     * @param content The markdown content to process
+     * @param args Optional arguments to replace $ARGUMENTS placeholder
+     * @returns The processed content with all substitutions applied
+     */
+    processContent(content: string, args?: string): Promise<string>;
+}
+export interface McpPromptRenderer {
+    render(command: Command, input: string): Promise<string>;
+}
+export interface CommandAction {
+    type: 'start' | 'input' | 'end' | 'cancel';
+    input?: any;
+}
+export interface CommandExecuteContext {
+    name: string;
+    session: Session;
+    args: any[];
+    history?: InputText[];
+    signal?: AbortSignal;
+    /** Timestamp of the originating user message when supplied by an ACP client. */
+    timestamp?: number;
+}
+export interface CommandExecuteResult {
+    stdout?: string;
+    skipRun?: boolean;
+    done: boolean;
+}
+export interface CommandSourceInfo {
+    name: string;
+    message?: string;
+    args: any[];
+}
+export declare const NON_MODEL_COMMANDS: Command[];
+export declare enum LocalCommandNames {
+    Bash = "/bash",
+    Memory = "/memory",
+    Add = "/memory"
+}
+export declare enum CommandNames {
+    Agent = "Agent"
+}
+export declare const CUSTOM_COMMAND_TAG = "custom";
+export declare const MCP_PROMPT_COMMAND_TAG = "mcp-prompt";
+export declare const PLUGIN_TAG = "plugin";
+export declare const SKILL_COMMAND_TAG = "skill";
+/** Saved Dynamic Workflow 注册成 `/<name>` 命令时打的 tag(对齐 CC v2.1 行为)。 */
+export declare const WORKFLOW_COMMAND_TAG = "dynamic-workflow";
+/** Dynamic Workflow 命令描述统一前缀,UI 列表/补全里一眼可识别。 */
+export declare const WORKFLOW_COMMAND_DESC_PREFIX = "[dynamic workflow]";
+/** 带条件启用的内置命令定义 */
+export interface ConditionalCommand {
+    command: Command;
+    /** 异步判断命令是否启用 */
+    isEnabled: () => Promise<boolean>;
+}
+/** 需要条件判断的内置命令 */
+export declare const CONDITIONAL_COMMANDS: ConditionalCommand[];

package/cli/dist-server/types/node/command/config-command-executor.d.ts

@@ -0,0 +1,15 @@
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { NavigationManager } from '../navigation';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class ConfigCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly sessionManager: SessionManager;
+    protected readonly navigationManager: NavigationManager;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    private handleList;
+    private handleGet;
+    private handleSet;
+    private outputResult;
+}

package/cli/dist-server/types/node/command/context-command-executor.d.ts

@@ -0,0 +1,42 @@
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+/**
+ * /context 命令执行器
+ * 计算当前会话的上下文token分布情况
+ */
+export declare class ContextCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    /**
+     * 格式化输出。布局对齐 Claude `/context`：
+     * 分类标题带估算合计（"Estimated usage by category · 33.7k"），与顶行
+     * `realInputTokens` 分开，避免把分项加总误当成上次请求的权威用量。
+     * Skills 单独成行（从 System tools 里划出，避免重复计数）；
+     * Memory / Skills / Agents 默认折叠，`/context all` 展开。
+     *
+     * 顶行 / 矩阵 / Free space 优先 `realInputTokens`，无真实调用时回退 `total`。
+     * 分项行始终是本地粗估；`/context` 本身写入历史后 Messages 会涨，顶行要等下次模型请求才更新。
+     */
+    private formatOutput;
+    private isExpandArg;
+    private formatCollapsedOrExpandedDetails;
+    /**
+     * 按 scope 分组 skills 和 commands
+     */
+    private groupSkillsAndCommandsByScope;
+    /**
+     * 合并矩阵和明细信息，并排显示
+     */
+    private mergeMatrixAndDetails;
+    /**
+     * 创建彩色矩阵显示
+     * @param usedTokens 权威用量（顶行同源）。矩阵填充总量由它决定，各分项只决定
+     *   这些格子的配色比例，避免"顶行 85%而格子只填 23%"的矛盾（#69538）。
+     */
+    private createMatrix;
+    /**
+     * 格式化token数量显示
+     */
+    private formatTokens;
+}

package/cli/dist-server/types/node/command/copy-command-executor.d.ts

@@ -0,0 +1,10 @@
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class CopyCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly sessionManager: SessionManager;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    private run;
+}

package/cli/dist-server/types/node/command/cost-command-executor.d.ts

@@ -0,0 +1,13 @@
+import { ProductManager } from '../../workspace/product/lib/common/index.js';
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { CostService } from '../telemetry';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class CostCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly sessionManager: SessionManager;
+    protected readonly costService: CostService;
+    protected readonly productManager: ProductManager;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/custom-command-renderer.d.ts

@@ -0,0 +1,29 @@
+import { Command } from '../../workspace/product/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { ReferenceService } from '../references';
+import { ShellService } from '../shell/shell-protocol';
+import { CustomCommandRenderer } from './command-protocol';
+/**
+ * Service for rendering custom commands with parameter replacement
+ * Replaces $1, $2, $3, etc. with provided arguments
+ */
+export declare class CustomCommandRendererImpl implements CustomCommandRenderer {
+    protected readonly referenceService: ReferenceService;
+    protected readonly shellService: ShellService;
+    protected readonly logger: Logger;
+    /**
+     * Render custom command prompt with parameter replacement and file references
+     * @param command The command containing prompt template and name
+     * @param input The full input text containing command and arguments
+     * @returns The prompt with parameters replaced and file references processed
+     */
+    render(command: Command, input: string): Promise<string>;
+    /**
+     * Process markdown content with inline bash execution, argument replacement, and file references.
+     * Pipeline: $ARGUMENTS replacement → !`command` execution → @file reference processing
+     */
+    processContent(content: string, args?: string): Promise<string>;
+    private executeInlineBash;
+    private replaceParameters;
+    private extractArguments;
+}

package/cli/dist-server/types/node/command/debug-command-executor.d.ts

@@ -0,0 +1,15 @@
+import { DebugService } from '../debug/debug-protocol';
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class DebugCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly sessionManager: SessionManager;
+    protected readonly debugService: DebugService;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    private run;
+    private isDebugEnabled;
+    private enableDebugLogging;
+    private formatFileSize;
+}

package/cli/dist-server/types/node/command/deep-research-command-executor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * /deep-research <question>
+ *
+ * 单一职责:把 `/deep-research` 命令翻成 `Workflow` 工具调用,启动 builtin "deep-research"
+ * workflow 并立刻返回 runId(workflow 在后台跑,通过 /workflows 看进度)。
+ *
+ * 与 Claude Code 行为对齐:
+ *  - 必须有 question 参数
+ *  - 启动后只返回 ack;run 注册成 BackgroundTask,完成时把报告写进对话流并推 task-notification
+ */
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { type WorkflowManager } from '../../workspace/cbc-workflow/lib/node/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { WorkflowBackgroundTaskTracker } from '../tools/workflow-background-task';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class DeepResearchCommandExecutor implements CommandExecutor {
+    name: string;
+    autoGenerateHistory: boolean;
+    protected readonly logger: Logger;
+    protected readonly sessionManager: SessionManager;
+    protected readonly manager: WorkflowManager;
+    protected readonly workflowBackgroundTaskTracker: WorkflowBackgroundTaskTracker;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    private run;
+    private joinArgs;
+    private appendHistory;
+}

package/cli/dist-server/types/node/command/doctor-command-executor.d.ts

@@ -0,0 +1,7 @@
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class DoctorCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/effort-command-executor.d.ts

@@ -0,0 +1,68 @@
+/**
+ * /effort <level> —— 切换 effort 档位。
+ *
+ * 两类档位：
+ *   - `low` / `medium` / `high` / `xhigh` / `max`:模型 reasoning effort,写会话级
+ *     override(与 ACP thought_level 同一通道),并按当前模型能力校验
+ *   - `ultracode`:开启 workflow 自动编排;后续每轮注入持续提醒
+ *     (由 UltracodeEffortReminderInterceptor 驱动)
+ *
+ * 未识别的 level 直接拒绝,不写入任何状态。
+ *
+ * Reminder 文本通过 PromptManager 从 prompt template 加载:
+ *   - workflow-ultra-effort-enter
+ *   - workflow-ultra-effort-exit ({{previous}}, {{current}})
+ */
+import { PromptManager } from '../../workspace/prompts/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { AcpBroadcastService } from '../acp/acp-protocol';
+import { Session, SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { SettingsManager } from '../settings';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class EffortCommandExecutor implements CommandExecutor {
+    name: string;
+    autoGenerateHistory: boolean;
+    protected readonly logger: Logger;
+    protected readonly sessionManager: SessionManager;
+    protected readonly settingsManager: SettingsManager;
+    protected readonly promptManager: PromptManager;
+    protected readonly acpBroadcastService?: AcpBroadcastService;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    /** Visible-for-testing:argv → level 字符串 */
+    static parseLevel(args: unknown[]): string;
+    /** Visible-for-testing:把 (session, level) → stdout 字符串 + 副作用更新 meta */
+    run(session: Session, level: string): Promise<string>;
+    /**
+     * 把新的 thought_level 同步给正在看该会话的 Web UI 连接。
+     *
+     * TUI 侧改档位只写 session override，不经过 ACP setSessionConfigOption，因此不会
+     * 触发 configChangeEvent，Web UI 的选择器会一直停在旧值（"CLI 里改了、Web UI 还是
+     * 默认思考强度"）。这里主动推一次完整 configOptions 补上这条链路。
+     *
+     * 最佳努力：没有 Web UI 连接时是 no-op；推送失败只告警，不影响命令本身的成功语义
+     * （override 已经生效），所以不 await，避免慢连接拖住命令回显。
+     */
+    private notifyConfigOptionsChanged;
+    /**
+     * 持久化 reasoning effort 到用户全局 settings。写入失败不阻断命令（override 已生效），仅告警。
+     */
+    private persistReasoningEffort;
+    /**
+     * Issue #87437: 解析当前模型支持的档位集合。
+     *
+     * 返回 `levels === undefined` 有两种含义，用 `resolutionFailed` 区分，避免把
+     * "解析失败" 静默当成 "模型不限制档位"：
+     *   - 模型未建模能力（预期）→ resolutionFailed=false
+     *   - 解析异常（容器未装配 / 模型解析回归）→ resolutionFailed=true，usage 会提示
+     */
+    private resolveCurrentModelEfforts;
+    /**
+     * Issue #58743: 解析当前"用户会看到的" effort 档位。
+     *   ultracode > session override.reasoningEffort > merged settings.reasoningEffort
+     * 保持与 EffortPanel 的初始高亮同源，避免同一状态两处出现不同答案。
+     */
+    private resolveEffectiveLevel;
+    private loadTemplate;
+    private fallbackExit;
+    private appendHistory;
+}

package/cli/dist-server/types/node/command/exit-command-executor.d.ts

@@ -0,0 +1,14 @@
+import { CheckpointService } from '../../workspace/cbc-checkpoint/lib/node/index.js';
+import { SessionHookManager } from '../../vendor/cbc-core/node/index.js';
+import { type IWorktreeChangeDetector, type IWorktreeSessionManager } from '../../workspace/cbc-worktree/lib/node/index.js';
+import { type CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class ExitCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly checkpointService: CheckpointService;
+    protected readonly sessionHookManager: SessionHookManager;
+    protected readonly worktreeSessionManager?: IWorktreeSessionManager;
+    protected readonly worktreeChangeDetector?: IWorktreeChangeDetector;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/export-command-executor.d.ts

@@ -0,0 +1,7 @@
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class ExportCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/feedback-command-executor.d.ts

@@ -0,0 +1,9 @@
+import { FeedbackService } from '../feedback';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class FeedbackCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly feedbackService: FeedbackService;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+}

package/cli/dist-server/types/node/command/fork-bg-command-executor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `/fork-bg` —— 把当前会话复制成一个后台会话，**当前会话继续存活**。
+ *
+ * 对照 Claude Code v2.1.216 的 `/fork`（bundle 554633-554640、781588-781613）。
+ * 命名说明：本仓 `/fork` 已经是「前台分支」（与 `/branch` 同一个 executor），
+ * 语义与 Claude 相反。为了不改变既有用户的 `/fork` 行为，后台副本另起名 `/fork-bg`。
+ *
+ * 与 `/background` 的唯一差别就是「原会话是否继续」（design D8）：
+ * - `/background`：前台交出去，自己退出
+ * - `/fork-bg`：副本进后台，父会话原样留在终端
+ */
+import { type Session, SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { SettingsManager } from '../settings';
+import { CommandExecuteContext, CommandExecutor } from './command-protocol';
+export declare class ForkBgCommandExecutor implements CommandExecutor {
+    name: string;
+    message: string;
+    autoGenerateHistory: boolean;
+    protected readonly sessionManager: SessionManager;
+    protected readonly settingsManager: SettingsManager;
+    execute(ctx: CommandExecuteContext): Promise<void>;
+    /** 透传给副本的启动 flag（对照 D8：权限模式 / 模型 / effort / add-dir） */
+    protected inheritFlags(outputStyle?: string): string[];
+    protected restrictedFlag(): string | undefined;
+    protected failureMessage(reason: string): string;
+    protected isAgentViewDisabled(): Promise<boolean>;
+    protected isPersistenceDisabled(): Promise<boolean>;
+    protected say(session: Session, text: string): Promise<void>;
+}