@tencent-ai/agent-sdk 0.3.252 → 0.3.253

package/cli/dist-server/types/node/checkpoint/checkpoint-service.d.ts

@@ -1,70 +0,0 @@
-import { Logger } from '@celljs/core';
-import { EventService } from '@genie/telemetry';
-import { type Session } from '../session';
-import { SettingsManager } from '../settings';
-import { type Checkpoint, type CheckpointFileChangeStats, CheckpointService, FileVersionManager, FileVersionStore } from './checkpoint-protocol';
-export declare class CheckpointServiceImpl implements CheckpointService {
-    protected readonly logger: Logger;
-    protected readonly settingsManager: SettingsManager;
-    protected readonly fileVersionStore: FileVersionStore;
-    protected readonly fileVersionManager: FileVersionManager;
-    protected readonly eventService?: EventService;
-    protected init(): void;
-    createCheckpoint(session: Session, options?: {
-        autoAddToHistory?: boolean;
-        messageId?: string;
-        isSnapshotUpdate?: boolean;
-    }): Promise<Checkpoint | undefined>;
-    revertToCheckpoint(session: Session, checkpoint: Checkpoint, scope: import('./checkpoint-protocol.js').RevertScope): Promise<void>;
-    getRewindableCheckpoints(session: Session): Checkpoint[];
-    /**
-     * 按 user 消息 UUID 定位 checkpoint。
-     *
-     * 对齐 Claude Code `rewind_files` 语义：查找该 user 消息**发送之前**的
-     * 文件快照。cbc 中 `createCheckpoint` 是在 user 消息进入历史 + tool 执行**之前**
-     * 拍照，因此 snapshot.messageId === userMessageId 的那份快照恰好是「该 user
-     * 消息发送前」的磁盘状态。
-     *
-     * 严格约束：
-     * 1. userMessageId 必须存在于活跃历史链中（非活跃分支的消息不能作为目标）。
-     * 2. 该消息必须是 real user message（非 assistant / tool_call）。
-     * 3. 必须存在与之关联的 FileHistorySnapshotItem。
-     *
-     * 三条约束任一不满足即返回 undefined，交由上层生成对齐 Claude 的错误文案。
-     */
-    findCheckpointByUserMessageId(session: Session, userMessageId: string): Checkpoint | undefined;
-    hasRewindableCheckpoint(session: Session): boolean;
-    getLatestCheckpoint(session: Session): Checkpoint;
-    shouldSkipCheckpoint(session: Session): Promise<boolean>;
-    compareWithCurrentFiles(session: Session, targetCheckpoint: Checkpoint): Promise<CheckpointFileChangeStats>;
-    private get sessionManager();
-    /**
-     * revert 前强制刷新 session.checkpoint 到最新磁盘文件状态。
-     * 不写入 history（autoAddToHistory=false），仅更新内存中的 version/backup。
-     */
-    private refreshCheckpointBeforeRevert;
-    private revertFiles;
-    private restoreFile;
-    private deleteFile;
-    private fileExists;
-    private updateHistory;
-    private isCheckpointingEnabled;
-    private convertCheckpointToSnapshot;
-    /**
-     * 获取包含 snapshot 的活跃历史记录
-     *
-     * HistoryUtils.getActiveHistory 通过 parentId 链遍历构建活跃历史，
-     * 但 FileHistorySnapshotItem 的 id 是随机 UUID，不在任何 parentId 链上，
-     * 因此不会被 getActiveHistory 收录。
-     *
-     * 本方法在 getActiveHistory 的结果基础上，从 session.history 中找到
-     * 属于活跃对话链的 snapshot（通过 snapshot.messageId 关联用户消息），
-     * 并将它们插入到正确的位置。
-     */
-    private getActiveHistory;
-    /**
-     * 构建 CheckpointInfo 并通过 ACP 广播到所有客户端。
-     * 发送文件列表、changeType 和每个文件的 additions/deletions/diff。
-     */
-    broadcastCheckpointNotification(session: Session, checkpoint: Checkpoint): Promise<void>;
-}

package/cli/dist-server/types/node/checkpoint/file-changes-controller.d.ts

@@ -1,29 +0,0 @@
-/**
- * Internal File Changes Controller
- *
- * 提供 checkpoint 相关的文件变更操作，供 Web UI 内部消费。
- *
- * 端点：
- *   - POST /internal/file-changes/diff         → 获取文件 diff（oldText vs newText）
- *   - POST /internal/file-changes/checkpoints  → 列出可回退的 checkpoint
- *   - POST /internal/file-changes/revert       → 撤回文件变更
- */
-import { Logger } from '@genie/telemetry';
-import { type RevertScope } from './checkpoint-protocol';
-interface DiffRequest {
-    path: string;
-}
-interface RevertRequest {
-    paths?: string[];
-    checkpointId?: string;
-    scope?: RevertScope;
-}
-export declare class FileChangesController {
-    protected readonly logger: Logger;
-    diff(body: DiffRequest): Promise<void>;
-    checkpoints(): Promise<void>;
-    revert(body: RevertRequest): Promise<void>;
-    /** 获取当前活跃 session */
-    private resolveSession;
-}
-export {};

package/cli/dist-server/types/node/checkpoint/file-track-service.d.ts

@@ -1,11 +0,0 @@
-import { Logger } from '@celljs/core';
-import type { Session } from '../session';
-import { CheckpointService, FileTrackService } from './checkpoint-protocol';
-export declare const INITIAL_VERSION = 0;
-export declare class FileTrackServiceImpl implements FileTrackService {
-    protected readonly logger: Logger;
-    protected readonly checkpointService: CheckpointService;
-    protected init(): void;
-    /** 跟踪文件 */
-    trackFile(session: Session, filePath: string): Promise<boolean>;
-}

package/cli/dist-server/types/node/checkpoint/file-version-manager.d.ts

@@ -1,10 +0,0 @@
-import { Logger, Provider } from '@celljs/core';
-import { FileVersion, FileVersionManager, FileVersionStore, FileVersionUpdateStrategy } from './checkpoint-protocol';
-export declare class FileVersionManagerImpl implements FileVersionManager {
-    protected readonly logger: Logger;
-    protected readonly fileVersionStore: FileVersionStore;
-    protected readonly strategyProvider: Provider<FileVersionUpdateStrategy>;
-    protected init(): void;
-    /** 更新文件版本 */
-    update(sessionId: string, fileVersion: FileVersion, isSnapshotUpdate?: boolean): Promise<FileVersion | undefined>;
-}

package/cli/dist-server/types/node/checkpoint/file-version-store.d.ts

@@ -1,9 +0,0 @@
-import { Logger } from '@celljs/core';
-import { type FileVersion, FileVersionStore } from './checkpoint-protocol';
-export declare class FileVersionStoreImpl implements FileVersionStore {
-    protected readonly logger: Logger;
-    protected init(): void;
-    save(sessionId: string, fileVersion: FileVersion): Promise<void>;
-    get(sessionId: string, backupFileName: string): Promise<string | undefined>;
-    cleanup(sessionId: string): Promise<void>;
-}

package/cli/dist-server/types/node/checkpoint/file-version-update-strategies.d.ts

@@ -1,62 +0,0 @@
-import { type FileVersion, FileVersionUpdateStrategy, type FileVersionUpdateStrategyContext } from './checkpoint-protocol';
-/**
- * 初始化策略
- * 优先级: 5 (最高)
- * 条件: 版本号为 0 (首次调用)，说明是新跟踪的文件的 2 种处理
- */
-export declare class InitialVersionStrategy implements FileVersionUpdateStrategy {
-    priority: number;
-    private readonly logger;
-    private readonly fileVersionStore;
-    protected init(): void;
-    matches(context: FileVersionUpdateStrategyContext): boolean;
-    apply(context: FileVersionUpdateStrategyContext): Promise<FileVersion>;
-}
-/**
- * 无变更策略
- * 优先级: 4
- * 条件: 文件不存在 && 备份不存在，说明文件已被删除且没有处理
- */
-export declare class NoChangeStrategy implements FileVersionUpdateStrategy {
-    priority: number;
-    matches(context: FileVersionUpdateStrategyContext): boolean;
-    apply(context: FileVersionUpdateStrategyContext): Promise<FileVersion>;
-}
-/**
- * 文件删除策略
- * 优先级: 3
- * 条件: 文件不存在 && 备份存在，说明文件已被删除
- */
-export declare class FileDeletedStrategy implements FileVersionUpdateStrategy {
-    priority: number;
-    private readonly logger;
-    protected init(): void;
-    matches(context: FileVersionUpdateStrategyContext): boolean;
-    apply(context: FileVersionUpdateStrategyContext): Promise<FileVersion>;
-}
-/**
- * 备份文件创建策略
- * 优先级: 2
- * 条件: 文件存在 && 备份不存在，说明是已跟踪文件重新创建
- */
-export declare class FileCreatedStrategy implements FileVersionUpdateStrategy {
-    priority: number;
-    private readonly logger;
-    private readonly fileVersionStore;
-    protected init(): void;
-    matches(context: FileVersionUpdateStrategyContext): boolean;
-    apply(context: FileVersionUpdateStrategyContext): Promise<FileVersion>;
-}
-/**
- * 文件修改策略
- * 优先级: 1 (最低)
- * 条件: 文件存在 && 备份存在
- */
-export declare class FileModifiedStrategy implements FileVersionUpdateStrategy {
-    priority: number;
-    private readonly logger;
-    private readonly fileVersionStore;
-    protected init(): void;
-    matches(context: FileVersionUpdateStrategyContext): boolean;
-    apply(context: FileVersionUpdateStrategyContext): Promise<FileVersion>;
-}

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

@@ -1,11 +0,0 @@
-import { NavigationManager } from '../navigation';
-import { SessionManager } from '../session';
-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/agents-command-executor.d.ts

@@ -1,9 +0,0 @@
-import { SessionManager } from '../session';
-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

@@ -1,20 +0,0 @@
-import { SessionManager } from '../session';
-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

@@ -1,29 +0,0 @@
-/**
- * `/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 '../session';
-import { type Session } from '../session/session-protocol';
-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/btw-command-executor.d.ts

@@ -1,19 +0,0 @@
-import { CommandExecuteContext, CommandExecutor } from './command-protocol';
-/**
- * /btw (By The Way) Command Executor
- *
- * This is a stub — the actual side question logic is handled entirely by
- * BtwPanel (src/node/ui/input/panel/btw-panel.tsx), which is navigated to
- * directly from use-slash-interceptor.ts.
- *
- * The executor exists only so that CommandManager recognizes "/btw" as a
- * valid local command (commandExecutorMap.has(name) check in parseCommand).
- *
- * autoGenerateHistory = false: /btw messages must NOT enter session history.
- */
-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

@@ -1,17 +0,0 @@
-import { Logger } from '@genie/telemetry';
-import { SessionHookManager, SessionManager } from '../session';
-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/config-command-executor.d.ts

@@ -1,15 +0,0 @@
-import { NavigationManager } from '../navigation';
-import { SessionManager } from '../session';
-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

@@ -1,42 +0,0 @@
-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

@@ -1,10 +0,0 @@
-import { SessionManager } from '../session';
-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

@@ -1,13 +0,0 @@
-import { ProductManager } from '@genie/product';
-import { SessionManager } from '../session';
-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/debug-command-executor.d.ts

@@ -1,15 +0,0 @@
-import { DebugService } from '../debug/debug-protocol';
-import { SessionManager } from '../session';
-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

@@ -1,25 +0,0 @@
-/**
- * /deep-research <question>
- *
- * 单一职责:把 `/deep-research` 命令翻成 `Workflow` 工具调用,启动 builtin "deep-research"
- * workflow 并立刻返回 runId(workflow 在后台跑,通过 /workflows 看进度)。
- *
- * 与 Claude Code 行为对齐:
- *  - 必须有 question 参数
- *  - 启动后只返回 ack(具体报告由 workflow done 时通知)
- */
-import { Logger } from '@genie/telemetry';
-import { SessionManager } from '../session';
-import type { WorkflowManager } from '@genie/cbc-workflow';
-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;
-    execute(ctx: CommandExecuteContext): Promise<void>;
-    private run;
-    private joinArgs;
-    private appendHistory;
-}

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

@@ -1,7 +0,0 @@
-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

@@ -1,46 +0,0 @@
-/**
- * /effort <level> —— 切换 workflow effort level。
- *
- * 单一职责:维护 `session.meta.workflowEffortLevel`,触发 enter/exit reminder 一次性写入历史。
- *
- * 支持的 level:
- *   - `ultracode`:开启;后续每轮注入持续提醒(由 UltracodeEffortReminderInterceptor 驱动)
- *   - `high` / `default` / `off` / `none`:关闭(任意非 ultracode 字符串都视为关闭)
- *
- * Reminder 文本通过 PromptManager 从 prompt template 加载:
- *   - workflow-ultra-effort-enter
- *   - workflow-ultra-effort-exit ({{previous}}, {{current}})
- *
- * 不影响其他 effort 系统(此处仅作 workflow opt-in 开关;model 的 reasoning effort 由别处控制)。
- */
-import { PromptManager } from '@genie/prompts';
-import { Logger } from '@genie/telemetry';
-import { Session, SessionManager } from '../session';
-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;
-    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>;
-    /**
-     * 持久化 reasoning effort 到用户全局 settings。写入失败不阻断命令（override 已生效），仅告警。
-     */
-    private persistReasoningEffort;
-    /**
-     * 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

@@ -1,14 +0,0 @@
-import { CheckpointService } from '../checkpoint';
-import { SessionHookManager } from '../session';
-import { type IWorktreeChangeDetector, type IWorktreeSessionManager } from '../worktree';
-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

@@ -1,7 +0,0 @@
-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

@@ -1,9 +0,0 @@
-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

@@ -1,30 +0,0 @@
-/**
- * `/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 { SessionManager } from '../session';
-import { type Session } from '../session/session-protocol';
-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(): 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>;
-}

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

@@ -1,28 +0,0 @@
-import { Logger } from '@genie/telemetry';
-import { SessionHookManager, SessionManager } from '../session';
-import { CommandExecuteContext, CommandExecutor } from './command-protocol';
-/**
- * /fork 命令执行器
- *
- * 在当前对话位置创建一个分支，复制活跃对话历史到新 session 并自动切换。
- * 参考 Claude Code 的 /branch 命令实现。
- */
-export declare class ForkCommandExecutor 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>;
-    /**
-     * 通知 ACP 客户端 session 已切换
-     */
-    private notifySessionReset;
-}
-/**
- * /branch 命令执行器，与 /fork 功能完全相同
- */
-export declare class BranchCommandExecutor extends ForkCommandExecutor {
-    name: string;
-}

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

@@ -1,50 +0,0 @@
-import { AcpBroadcastService, GoalRecapPayload } from '../acp/acp-protocol';
-import { GoalService } from '../goal';
-import { NavigationManager } from '../navigation';
-import { CommandExecuteContext, CommandExecutor } from './command-protocol';
-/**
- * `/goal` 斜杠命令。
- *
- * 仅做参数派发：
- *   /goal               → 打开 recap 面板（TUI 走 NavigationManager；Web UI ACP
- *                          走 AcpBroadcastService.broadcastGoalRecap）
- *   /goal clear         → goalService.clear
- *   /goal pause         → 已有 goal 则 pause；否则 set("pause")（旧斜杠语义）
- *   /goal resume        → 已有 goal 则 resume；否则 set("resume")
- *   /goal <condition>   → goalService.set
- *
- * 业务逻辑（hook 注册、文案、metric）全部在 GoalService 里。Executor 留得越薄
- * 越容易单测——单测里 mock GoalService 即可断言派发是否正确。
- *
- * 双通道触发理由：TUI 的 NavigationManager 路径是本地 React Ink 路由，根本
- * 不会过 ACP，Web UI 看不见；反过来 Web UI 的 ACP 客户端也不参与 TUI 路由。
- * 两条路径同时触发，对端没连接时 broadcast fan-out 自动空集合跳过，对端连接
- * 时各自打开自己 UI 框架下的面板。
- *
- * Headless / SDK 场景下 NavigationManager 与 AcpBroadcastService 都不可用
- * （`@Optional`），降级走 goalService.show 的纯文本输出，保留兼容。
- */
-export declare class GoalCommandExecutor implements CommandExecutor {
-    name: string;
-    message: string;
-    autoGenerateHistory: boolean;
-    protected readonly goalService: GoalService;
-    protected readonly navigationManager?: NavigationManager;
-    protected readonly acpBroadcastService?: AcpBroadcastService;
-    execute(ctx: CommandExecuteContext): Promise<void>;
-    /** WorkBuddy/unopted ACP keeps the historical `/goal <condition>` parser. */
-    protected supportsPauseResumeCommands(session: CommandExecuteContext['session']): boolean;
-    /**
-     * 同时给 TUI（NavigationManager）和 Web UI（ACP broadcast）发起 recap 面板。
-     *
-     * - TUI 路径：本地路由切换，不依赖 session 数据，直接 navigate 即可，UI 自己从
-     *   GoalService 拉取 active/latest。
-     * - Web UI 路径：ACP 客户端拿不到 GoalService，需要服务端把 recap snapshot
-     *   组装好通过 _meta 推过去。两个路径数据源同一个，行为对齐。
-     *
-     * @returns 是否至少一条通道成功触发（用于 headless 降级判断）。
-     */
-    protected openRecapPanels(session: CommandExecuteContext['session']): Promise<boolean>;
-    /** 把 GoalService 的 active / latest 投影成 ACP recap payload。 */
-    protected buildRecapPayload(session: CommandExecuteContext['session']): GoalRecapPayload;
-}