@ai-agent-forge/agent-forge 0.88.1 → 0.88.3

package/dist/modes/interactive/interactive-mode.js

@@ -8,89 +8,53 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { contentText } from "@agent-forge/ai";
 import * as TuiLayouts from "@agent-forge/tui";
-import { CombinedAutocompleteProvider, Container, getCapabilities, hyperlink, Markdown, ProcessTerminal, Spacer, setCapabilityOverrides, setKeybindings, Text, TruncatedText, TuiAltScreen, TuiMainScreen, visibleWidth, } from "@agent-forge/tui";
-import chalk from "chalk";
-import { spawn } from "child_process";
-import { APP_NAME, APP_TITLE, getAgentDir, getDebugLogPath, VERSION } from "../../config.js";
-import { parseSkillBlock } from "../../core/agent-session.js";
-import { SessionImportFileNotFoundError } from "../../core/agent-session-runtime.js";
-import { listAgentSessions, readAgentSession } from "../../core/agent-session-store.js";
-import { CACHE_TTL_MS, collectCacheMisses, computeCacheWaste, detectCacheMiss, } from "../../core/cache-stats.js";
-import { DEFAULT_THINKING_LEVEL, THINKING_LEVEL_OPTIONS } from "../../core/defaults.js";
+import { CombinedAutocompleteProvider, Container, getCapabilities, hyperlink, Markdown, ProcessTerminal, Spacer, setCapabilityOverrides, setKeybindings, Text, TuiAltScreen, TuiMainScreen, } from "@agent-forge/tui";
+import { APP_NAME, APP_TITLE, getAgentDir, VERSION } from "../../config.js";
 import { createCodingAgentFacade, createCodingAgentRuntimeFacade, } from "../../core/facade/index.js";
 import { FooterDataProvider } from "../../core/footer-data-provider.js";
-import { configureHttpDispatcher, formatHttpIdleTimeoutMs } from "../../core/http-dispatcher.js";
+import { configureHttpDispatcher } from "../../core/http-dispatcher.js";
 import { setI18nLanguage, t } from "../../core/i18n/index.js";
 import { KeybindingsManager } from "../../core/keybindings.js";
-import { createCompactionSummaryMessage } from "../../core/messages.js";
-import { DefaultPackageManager } from "../../core/package-manager.js";
-import { formatMissingSessionCwdPrompt, MissingSessionCwdError } from "../../core/session-cwd.js";
-import { SessionManager, sessionEntryToContextMessages } from "../../core/session-manager.js";
+import { formatMissingSessionCwdPrompt } from "../../core/session-cwd.js";
 import { BUILTIN_SLASH_COMMANDS } from "../../core/slash-commands.js";
-import { getUsageCostBreakdown } from "../../core/usage-totals.js";
-import { listSuiteIds, resolveSuiteId, SUITE_ENV_VAR, SUITE_SESSION_ENTRY_TYPE } from "../../profiles/suite-loader.js";
+import { listSuiteIds, resolveSuiteId, SUITE_ENV_VAR, SUITE_SESSION_ENTRY_TYPE } from "../../suites/suite-loader.js";
+import { getEditorTheme, getMarkdownTheme, onThemeChange, setRegisteredThemes, stopThemeWatcher, Theme, theme, } from "../../theme/theme.js";
+import { InteractiveThemeController } from "../../theme/theme-controller.js";
 import { getChangelogPath, getNewEntries, normalizeChangelogLinks, parseChangelog } from "../../utils/changelog.js";
 import { copyToClipboard, readClipboardText } from "../../utils/clipboard.js";
 import { extensionForImageMimeType, readClipboardImage } from "../../utils/clipboard-image.js";
 import { parseGitUrl } from "../../utils/git.js";
 import { openBrowser } from "../../utils/open-browser.js";
-import { killTrackedDetachedChildren } from "../../utils/shell.js";
 import { loadAllHighlightLanguages } from "../../utils/syntax-highlight.js";
 import { ensureTool } from "../../utils/tools-manager.js";
-import { checkForNewVersion } from "../../utils/version-check.js";
-import { AgentsViewComponent } from "./components/agents-view.js";
-import { ArminComponent } from "./components/armin.js";
+import { kickMemoryModelPreheat } from "../memory-preheat.js";
 import { AssistantMessageComponent } from "./components/assistant-message.js";
-import { BashExecutionComponent } from "./components/bash-execution.js";
-import { BranchSummaryMessageComponent } from "./components/branch-summary-message.js";
-import { CompactionSummaryMessageComponent } from "./components/compaction-summary-message.js";
 import { CustomEditor } from "./components/custom-editor.js";
-import { CustomMessageComponent } from "./components/custom-message.js";
-import { DaxnutsComponent } from "./components/daxnuts.js";
 import { DynamicBorder } from "./components/dynamic-border.js";
-import { FooterComponent, formatTokens } from "./components/footer.js";
-import { formatKeyText, keyDisplayText, keyHint, keyText, rawKeyHint } from "./components/keybinding-hints.js";
+import { FooterComponent } from "./components/footer.js";
+import { formatKeyText, keyHint, keyText, rawKeyHint } from "./components/keybinding-hints.js";
 import { createMermaidMarkdownTransformer } from "./components/mermaid.js";
-import { readSessionSuiteIdFromFile, SessionSelectorComponent } from "./components/session-selector.js";
-import { SettingsSelectorComponent } from "./components/settings-selector.js";
-import { SkillInvocationMessageComponent } from "./components/skill-invocation-message.js";
-import { BranchSummaryStatusIndicator, CompactionStatusIndicator, IdleStatus, RetryStatusIndicator, WorkingStatusIndicator, } from "./components/status-indicator.js";
-import { ToolExecutionComponent } from "./components/tool-execution.js";
-import { TreeSelectorComponent } from "./components/tree-selector.js";
-import { UserMessageComponent } from "./components/user-message.js";
-import { WorkflowViewComponent } from "./components/workflow-view.js";
+import { readSessionSuiteIdFromFile } from "./components/session-selector.js";
+import { IdleStatus, WorkingStatusIndicator, } from "./components/status-indicator.js";
 import { editInExternalEditor } from "./external-editor.js";
 import * as authFlow from "./interactive-auth.js";
-import { COMMAND_DISPATCH_ENTRIES, filterCapabilityCommandsForCompletions, matchCommandDispatchEntry, } from "./interactive-commands.js";
+import { buildRegisteredThemes, COMMAND_DISPATCH_ENTRIES, checkDaxnutsEasterEgg, filterCapabilityCommandsForCompletions, getAppKeyDisplay, getEditorKeyDisplay, getPathCommandArgument, handleArminSaysHi, handleBashCommand, handleChangelogCommand, handleCleanSessionsCommand, handleClearCommand, handleCompactCommand, handleCopyCommand, handleDaxnuts, handleDebugCommand, handleExportCommand, handleHelpCommand, handleHotkeysCommand, handleImportCommand, handleMetricsCommand, handleNameCommand, handleReloadCommand, handleSessionCommand, handleStopAgentsCommand, matchCommandDispatchEntry, } from "./interactive-commands.js";
 import { createInteractionHostV1, hideDialogEditor, hideDialogInput, hideDialogSelector, isExpandable, showDialogConfirm, showDialogEditor, showDialogInput, showDialogNotify, showDialogSelector, } from "./interactive-dialog-ui.js";
-import { buildScopeGroups, findSourceInfoForPath, formatContextPath, formatDiagnostics, formatDisplayPath, formatMetricsSnapshot, formatPathWithSource, formatScopeGroups, getCompactPackageSourceLabel, getCompactPathLabel, getDisplaySourceInfo, getScopeGroup, getShortPath, isPackageSource, } from "./interactive-format.js";
-import { createFuzzyAutocompleteItems, formatLoginProviderCompletionDescription, getLoginProviderCompletionOptions, getLoginProviderSearchText, isAnthropicSubscriptionAuthKey, isDeadTerminalError, quoteIfNeeded, } from "./interactive-helpers.js";
+import * as eventsFlow from "./interactive-events.js";
+import { buildScopeGroups, findSourceInfoForPath, formatContextPath, formatDiagnostics, formatDisplayPath, formatPathWithSource, formatScopeGroups, getCompactPackageSourceLabel, getCompactPathLabel, getDisplaySourceInfo, getScopeGroup, getShortPath, isPackageSource, } from "./interactive-format.js";
+import { createFuzzyAutocompleteItems, formatLoginProviderCompletionDescription, getLoginProviderCompletionOptions, getLoginProviderSearchText, isAnthropicSubscriptionAuthKey, quoteIfNeeded, } from "./interactive-helpers.js";
+import * as lifecycleFlow from "./interactive-lifecycle.js";
+import * as queuesFlow from "./interactive-queues.js";
 import * as selectorsFlow from "./interactive-selectors.js";
-import { refreshModelCatalogs } from "./model-catalog-refresh.js";
 import { getModelSearchText } from "./model-search.js";
-import { getAvailableThemes, getEditorTheme, getMarkdownTheme, loadThemeFromPath, onThemeChange, setRegisteredThemes, stopThemeWatcher, Theme, theme, } from "./theme/theme.js";
-import { InteractiveThemeController } from "./theme/theme-controller.js";
+import { startStartupBackgroundChecks } from "./startup-services.js";
+// Re-exported for existing consumers of the interactive mode module; the
+// implementation moved to ./interactive-commands.ts with the command handlers
+// (拆分 slice 1).
+export { buildRegisteredThemes } from "./interactive-commands.js";
 // Re-exported for existing consumers of the interactive mode module; the
 // implementation moved to ./interactive-dialog-ui.ts with the extension UI block.
 export { mapLegacyDialogResultToOutcome } from "./interactive-dialog-ui.js";
-/**
- * Rebuilds real Theme instances from the resource loader's ThemeMetaV1
- * projection for the theme registry (B-S2b v1). Registration points
- * (constructor, runtime session start, reload) need loadable instances —
- * setRegisteredThemes stores what it is given and getThemeByName returns the
- * registered instance first — while the loader surface now projects only
- * metadata. Re-loading is synchronous and deterministic per sourcePath;
- * theme names come from the same JSON the loader parsed, so meta.name ===
- * Theme.name and the registry keeps its own name-filter/dedupe semantics.
- *
- * Contract: a meta without a sourcePath (or one whose file no longer parses)
- * throws — themesOverride host inputs must always carry a loadable
- * sourcePath. This adds one extra parse per theme at registration time
- * (constructor / session start / reload, not per turn).
- */
-export function buildRegisteredThemes(themes) {
-    return themes.map((meta) => loadThemeFromPath(meta.sourcePath));
-}
 class ExpandableText extends Text {
     getCollapsedText;
     getExpandedText;
@@ -103,12 +67,6 @@ class ExpandableText extends Text {
         this.setText(expanded ? this.getExpandedText() : this.getCollapsedText());
     }
 }
-function isCustomSessionEntry(item) {
-    return "type" in item && item.type === "custom";
-}
-function isCompactionCostNotice(item) {
-    return "type" in item && item.type === "compaction_cost";
-}
 // Empty-reply auto-continuation (#5, print-mode parity): sent at most once per
 // submitted turn when the turn ends with an empty assistant reply and the
 // model was neither aborted nor errored. The one-shot budget prevents loops.
@@ -230,6 +188,7 @@ export class ProviderFailoverTicker {
 }
 export class InteractiveMode {
     runtimeHost;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     renderer;
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
     ui;
@@ -240,7 +199,9 @@ export class InteractiveMode {
     documentContainer;
     transcriptScrollView;
     fullscreenLayoutRoot;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     pendingMessagesContainer;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     statusContainer;
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
     defaultEditor;
@@ -261,6 +222,8 @@ export class InteractiveMode {
      * Re-renders the footer once per second while the provider failover breaker is
      * open (§4.7 Phase 3). Optional-typed to match the prototype-based test stubs
      * (constructor always assigns it on real instances).
+     *
+     * Host-visible for ./interactive-events.ts (拆分 slice 5): per-event refresh.
      */
     failoverTicker;
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
@@ -271,17 +234,22 @@ export class InteractiveMode {
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
     keybindings;
     version;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     isInitialized = false;
     onInputCallback;
     pendingUserInputs = [];
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     activeStatusIndicator = undefined;
     idleStatus = new IdleStatus();
     workingMessage = undefined;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     workingVisible = true;
     workingIndicatorOptions = undefined;
     defaultWorkingMessage = t("Working...");
     defaultHiddenThinkingLabel = t("Thinking...");
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     hiddenThinkingLabel = this.defaultHiddenThinkingLabel;
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): double-Ctrl+C exit window. */
     lastSigintTime = 0;
     lastEscapeTime = 0;
     changelogMarkdown = undefined;
@@ -292,37 +260,57 @@ export class InteractiveMode {
     lastStatusText = undefined;
     managedToolStatusStarted = false;
     // Streaming message tracking
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     streamingComponent = undefined;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     streamingMessage = undefined;
     // Tool execution tracking: toolCallId -> component
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     pendingTools = new Map();
+    // D-083 quiet transcript: the tool-run group for the current assistant
+    // turn (one group per message_start; null between turns).
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    activeToolRunGroup = undefined;
     // Tool output expansion state
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
     toolOutputExpanded = false;
     // Thinking block visibility state
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     hideThinkingBlock = false;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     outputPad = 1;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     mermaidMarkdownTransformer = createMermaidMarkdownTransformer({
         getMode: () => this.settingsManager.getMermaidRenderingMode(),
         theme,
     });
     // Agent subscription unsubscribe function
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     unsubscribe;
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4). */
     signalCleanupHandlers = [];
     // Track if editor is in bash mode (text starts with !)
     isBashMode = false;
     // Track current bash execution component
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     bashComponent = undefined;
     // Track pending bash components (shown in pending area, moved to chat on submit)
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     pendingBashComponents = [];
     // Auto-compaction state
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     autoCompactionEscapeHandler;
     // Auto-retry state
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     retryEscapeHandler;
     // Messages queued while compaction is running
+    /** Host-visible for ./interactive-queues.ts (拆分 slice 3). */
     compactionQueuedMessages = [];
     // Shutdown state
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4). */
     shutdownRequested = false;
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): reentrancy guard. */
+    isShuttingDown = false;
     // Extension UI state: host-visible for ./interactive-dialog-ui.ts (S5 slice 2).
     dialogSelector = undefined;
     dialogInput = undefined;
@@ -338,12 +326,15 @@ export class InteractiveMode {
     headerContainer;
     // Built-in header (logo + keybinding hints + changelog)
     builtInHeader = undefined;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     options;
     onRightClickPaste = () => {
         void this.handleRightClickPaste();
     };
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     themeController;
     // Convenience accessors
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2): only the curated AgentSessionHostSurface (setTransport) is consumed there. */
     get session() {
         return this.runtimeHost.session;
     }
@@ -615,6 +606,7 @@ export class InteractiveMode {
         }
         this.ui.stop({ preserveScreen: this.renderer.mode === "fullscreen" });
     }
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     switchTuiMode(mode, restoreProgress = true, startRenderer = true) {
         const previousUi = this.renderer;
         if (mode === previousUi.mode)
@@ -832,46 +824,28 @@ export class InteractiveMode {
             this.ui.terminal.setTitle(`${APP_TITLE} - ${cwdBasename}`);
         }
     }
+    /** Host-visible for ./startup-services.ts. */
+    getVersion() {
+        return this.version;
+    }
+    /** Narrow cwd projection for startup background checks (D-048). */
+    getCwd() {
+        return this.facade.getCwd();
+    }
+    /** Live initialization read for late-arriving background checks. */
+    hasInitialized() {
+        return this.isInitialized;
+    }
     /**
      * Run the interactive mode. This is the main entry point.
      * Initializes the UI, shows warnings, processes initial messages, and starts the interactive loop.
      */
     async run() {
         await this.init();
-        if (!process.env.AGENT_FORGE_OFFLINE) {
-            const controller = new AbortController();
-            const timeout = setTimeout(() => controller.abort(), 15_000);
-            void refreshModelCatalogs(this.facade.getModelCatalog(), controller.signal)
-                .then(() => this.updateAvailableProviderCount())
-                .catch(() => { })
-                .finally(() => clearTimeout(timeout));
-        }
-        // Start version check asynchronously
-        checkForNewVersion(this.version).then((newRelease) => {
-            if (newRelease) {
-                this.showNewVersionNotification(newRelease);
-            }
-        });
-        // Start package update check asynchronously
-        this.checkForPackageUpdates()
-            .then((updates) => {
-            if (updates.length > 0) {
-                this.showPackageUpdateNotification(updates);
-            }
-        })
-            .finally(() => {
-            // On Windows, npm can overwrite the shared console title while checking
-            // extension package versions. Restore the product title after the startup check.
-            if (process.platform === "win32" && this.isInitialized) {
-                this.updateTerminalTitle();
-            }
-        });
-        // Check tmux keyboard setup asynchronously
-        this.checkTmuxKeyboardSetup().then((warning) => {
-            if (warning) {
-                this.showWarning(warning);
-            }
-        });
+        // Fire-and-forget startup background checks (catalog refresh, version
+        // check, package updates, tmux probe); scheduling lives in
+        // ./startup-services.ts.
+        startStartupBackgroundChecks(this);
         // Show startup warnings
         const { migratedProviders, startupDiagnostics, modelFallbackMessage, initialMessage, initialImages, initialMessages, } = this.options;
         for (const diagnostic of startupDiagnostics ?? []) {
@@ -958,64 +932,6 @@ export class InteractiveMode {
         this.showStatus(t("Previous reply was empty, retrying..."));
         await this.facade.prompt(EMPTY_REPLY_RETRY_PROMPT);
     }
-    async checkForPackageUpdates() {
-        if (process.env.AGENT_FORGE_OFFLINE) {
-            return [];
-        }
-        try {
-            const packageManager = new DefaultPackageManager({
-                cwd: this.facade.getCwd(),
-                agentDir: getAgentDir(),
-                settingsManager: this.settingsManager,
-            });
-            const updates = await packageManager.checkForAvailableUpdates();
-            return updates.map((update) => update.displayName);
-        }
-        catch {
-            return [];
-        }
-    }
-    async checkTmuxKeyboardSetup() {
-        if (!process.env.TMUX)
-            return undefined;
-        const runTmuxShow = (option) => {
-            return new Promise((resolve) => {
-                const proc = spawn("tmux", ["show", "-gv", option], {
-                    stdio: ["ignore", "pipe", "ignore"],
-                });
-                let stdout = "";
-                const timer = setTimeout(() => {
-                    proc.kill();
-                    resolve(undefined);
-                }, 2000);
-                proc.stdout?.on("data", (data) => {
-                    stdout += data.toString();
-                });
-                proc.on("error", () => {
-                    clearTimeout(timer);
-                    resolve(undefined);
-                });
-                proc.on("close", (code) => {
-                    clearTimeout(timer);
-                    resolve(code === 0 ? stdout.trim() : undefined);
-                });
-            });
-        };
-        const [extendedKeys, extendedKeysFormat] = await Promise.all([
-            runTmuxShow("extended-keys"),
-            runTmuxShow("extended-keys-format"),
-        ]);
-        // If we couldn't query tmux (timeout, sandbox, etc.), don't warn
-        if (extendedKeys === undefined)
-            return undefined;
-        if (extendedKeys !== "on" && extendedKeys !== "always") {
-            return t("tmux extended-keys is off. Modified Enter keys may not work. Add `set -g extended-keys on` to ~/.tmux.conf and restart tmux.");
-        }
-        if (extendedKeysFormat === "xterm") {
-            return t("tmux extended-keys-format is xterm. Agent Forge works best with csi-u. Add `set -g extended-keys-format csi-u` to ~/.tmux.conf and restart tmux.");
-        }
-        return undefined;
-    }
     /**
      * Get changelog entries to display on startup.
      * Only shows new entries since last seen version, skips for resumed sessions.
@@ -1040,6 +956,7 @@ export class InteractiveMode {
         }
         return undefined;
     }
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     getMarkdownThemeWithSettings() {
         return {
             ...getMarkdownTheme(),
@@ -1097,6 +1014,7 @@ export class InteractiveMode {
     formatDiagnostics(diagnostics, sourceInfos) {
         return formatDiagnostics(diagnostics, sourceInfos);
     }
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     showLoadedResources(options) {
         // Resource rendering is idempotent; chat clears no longer clear this separate container.
         this.loadedResourcesContainer.clear();
@@ -1226,14 +1144,17 @@ export class InteractiveMode {
      */
     async bindCurrentSessionExtensions() {
         await this.session.startSession();
+        kickMemoryModelPreheat(this.session);
         setRegisteredThemes(buildRegisteredThemes(this.facade.getThemes().themes));
         this.setupAutocompleteProvider();
         this.showLoadedResources({ force: false, showDiagnosticsWhenQuiet: true });
         this.showStartupNoticesIfNeeded();
     }
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     applyFullscreenScrollbarSetting() {
         this.transcriptScrollView?.setScrollbar(this.settingsManager.getFullscreenScrollbar());
     }
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     applyRuntimeSettings() {
         setI18nLanguage(this.settingsManager.getUiLanguage());
         setCapabilityOverrides(this.settingsManager.getTerminalCapabilityOverrides());
@@ -1285,6 +1206,7 @@ export class InteractiveMode {
         this.updateEditorBorderColor();
         this.updateTerminalTitle();
     }
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     async handleFatalRuntimeError(prefix, error) {
         const message = error instanceof Error ? error.message : String(error);
         this.showError(`${prefix}: ${message}`);
@@ -1304,19 +1226,24 @@ export class InteractiveMode {
     }
     /**
      * Get a registered tool definition by name (for custom rendering).
+     *
+     * Host-visible for ./interactive-events.ts (拆分 slice 5).
      */
     getRegisteredToolDefinition(toolName) {
-        return this.facade.getToolDefinition(toolName);
+        return eventsFlow.getRegisteredToolDefinition(this, toolName);
     }
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
     getMarkdownTransformers() {
-        return [this.mermaidMarkdownTransformer];
+        return eventsFlow.getMarkdownTransformers(this);
     }
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     showStatusIndicator(indicator) {
         this.activeStatusIndicator?.dispose();
         this.activeStatusIndicator = indicator;
         this.statusContainer.clear();
         this.statusContainer.addChild(indicator);
     }
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     clearStatusIndicator(kind) {
         if (kind && this.activeStatusIndicator?.kind !== kind) {
             return;
@@ -1329,6 +1256,7 @@ export class InteractiveMode {
             this.statusContainer.addChild(this.idleStatus);
         }
     }
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5): turn_start working indicator. */
     showWorkingStatusIndicator() {
         this.showStatusIndicator(new WorkingStatusIndicator(this.ui, this.workingMessage ?? this.defaultWorkingMessage, this.workingIndicatorOptions));
     }
@@ -1373,6 +1301,7 @@ export class InteractiveMode {
             this.activeStatusIndicator.setMessage(message ?? this.defaultWorkingMessage);
         }
     }
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     resetDialogUI() {
         if (this.dialogSelector) {
             this.hideDialogSelector();
@@ -1438,6 +1367,7 @@ export class InteractiveMode {
     async showDialogConfirm(title, message, opts) {
         return showDialogConfirm(this, title, message, opts);
     }
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     async promptForMissingSessionCwd(error) {
         const confirmed = await this.showDialogConfirm("Session cwd not found", formatMissingSessionCwdPrompt(error.issue));
         return confirmed ? error.issue.fallbackCwd : undefined;
@@ -1719,334 +1649,24 @@ export class InteractiveMode {
     setEditorText(text) {
         this.editor.setText(text);
     }
+    // =========================================================================
+    // Agent event bridge and transcript rendering — implementation in
+    // ./interactive-events.ts (拆分 slice 5) behind the EventsHost interface;
+    // same-name delegates keep the rebind/subscribe flow and prototype-level
+    // tests bound to these names. showManagedToolStatus, showStatus, and
+    // getUserInput stay on the mode (startup/footer/main-loop faces).
+    // =========================================================================
+    /** Session subscription; implementation in ./interactive-events.ts (拆分 slice 5). */
     subscribeToAgent() {
-        this.unsubscribe = this.facade.subscribe(async (event) => {
-            await this.handleEvent(event);
-        });
+        eventsFlow.subscribeToAgent(this);
     }
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
     async handleEvent(event) {
-        if (!this.isInitialized) {
-            await this.init();
-        }
-        this.footer.invalidate();
-        // Failover snapshots land as entry_appended events; the ticker decides here
-        // whether the per-second countdown re-render is needed (§4.7 Phase 3).
-        this.failoverTicker?.refresh();
-        switch (event.type) {
-            case "agent_start":
-                this.pendingTools.clear();
-                // Restore main escape handler if retry handler is still active
-                // (retry success event fires later, but we need main handler now)
-                if (this.retryEscapeHandler) {
-                    this.defaultEditor.onEscape = this.retryEscapeHandler;
-                    this.retryEscapeHandler = undefined;
-                }
-                break;
-            case "turn_start":
-                if (this.settingsManager.getShowTerminalProgress()) {
-                    this.ui.terminal.setProgress(true);
-                }
-                if (this.workingVisible) {
-                    if (this.activeStatusIndicator?.kind !== "working") {
-                        this.showWorkingStatusIndicator();
-                    }
-                }
-                else {
-                    this.clearStatusIndicator();
-                }
-                this.ui.requestRender();
-                break;
-            case "queue_update":
-                this.updatePendingMessagesDisplay();
-                this.ui.requestRender();
-                break;
-            case "entry_appended":
-                // Custom entries have no renderer source since the legacy extension
-                // surface was removed; nothing to append to the chat.
-                break;
-            case "session_info_changed":
-                this.updateTerminalTitle();
-                this.footer.invalidate();
-                this.ui.requestRender();
-                break;
-            case "thinking_level_changed":
-                this.footer.invalidate();
-                this.updateEditorBorderColor();
-                break;
-            case "message_start":
-                if (event.message.role === "custom") {
-                    this.addMessageToChat(event.message);
-                    this.ui.requestRender();
-                }
-                else if (event.message.role === "user") {
-                    this.addMessageToChat(event.message);
-                    this.updatePendingMessagesDisplay();
-                    this.ui.requestRender();
-                }
-                else if (event.message.role === "assistant") {
-                    this.streamingComponent = new AssistantMessageComponent(undefined, this.hideThinkingBlock, this.getMarkdownThemeWithSettings(), this.hiddenThinkingLabel, this.outputPad, this.getMarkdownTransformers());
-                    this.streamingMessage = event.message;
-                    this.chatContainer.addChild(this.streamingComponent);
-                    this.streamingComponent.updateContent(this.streamingMessage, true);
-                    this.ui.requestRender();
-                }
-                break;
-            case "message_update":
-                if (this.streamingComponent && event.message.role === "assistant") {
-                    this.streamingMessage = event.message;
-                    this.streamingComponent.updateContent(this.streamingMessage, true);
-                    for (const content of this.streamingMessage.content) {
-                        if (content.type === "toolCall") {
-                            if (!this.pendingTools.has(content.id)) {
-                                const component = new ToolExecutionComponent(content.name, content.id, content.arguments, {
-                                    showImages: this.settingsManager.getShowImages(),
-                                    imageWidthCells: this.settingsManager.getImageWidthCells(),
-                                }, this.getRegisteredToolDefinition(content.name), this.ui, this.facade.getCwd());
-                                component.setExpanded(this.toolOutputExpanded);
-                                this.chatContainer.addChild(component);
-                                this.pendingTools.set(content.id, component);
-                            }
-                            else {
-                                const component = this.pendingTools.get(content.id);
-                                // v8 ignore next -- has() 已确认键存在，get() 恒返回组件
-                                if (component) {
-                                    component.updateArgs(content.arguments);
-                                }
-                            }
-                        }
-                    }
-                    this.ui.requestRender();
-                }
-                break;
-            case "message_end":
-                if (event.message.role === "user")
-                    break;
-                if (this.streamingComponent && event.message.role === "assistant") {
-                    this.streamingMessage = event.message;
-                    let errorMessage;
-                    if (this.streamingMessage.stopReason === "aborted") {
-                        const retryAttempt = this.facade.getRetryAttempt();
-                        errorMessage =
-                            retryAttempt > 0
-                                ? retryAttempt === 1
-                                    ? t("Aborted after {count} retry attempt", { count: retryAttempt })
-                                    : t("Aborted after {count} retry attempts", { count: retryAttempt })
-                                : t("Operation aborted");
-                        this.streamingMessage.errorMessage = errorMessage;
-                    }
-                    this.streamingComponent.updateContent(this.streamingMessage, false);
-                    if (this.streamingMessage.stopReason === "aborted" || this.streamingMessage.stopReason === "error") {
-                        if (!errorMessage) {
-                            errorMessage = this.streamingMessage.errorMessage || t("Error");
-                        }
-                        for (const [, component] of this.pendingTools.entries()) {
-                            component.updateResult({
-                                content: [{ type: "text", text: errorMessage }],
-                                isError: true,
-                            });
-                        }
-                        this.pendingTools.clear();
-                    }
-                    else {
-                        // Args are now complete - trigger diff computation for edit tools
-                        for (const [, component] of this.pendingTools.entries()) {
-                            component.setArgsComplete();
-                        }
-                        this.maybeShowThinkingDropNotice(this.streamingMessage);
-                        this.maybeShowCacheMissNotice(this.streamingMessage);
-                    }
-                    this.streamingComponent = undefined;
-                    this.streamingMessage = undefined;
-                    this.footer.invalidate();
-                }
-                this.ui.requestRender();
-                break;
-            case "bash_execution_update":
-                // The bash execution callback handles TUI output rendering.
-                break;
-            case "tool_execution_start": {
-                let component = this.pendingTools.get(event.toolCallId);
-                if (!component) {
-                    component = new ToolExecutionComponent(event.toolName, event.toolCallId, event.args, {
-                        showImages: this.settingsManager.getShowImages(),
-                        imageWidthCells: this.settingsManager.getImageWidthCells(),
-                    }, this.getRegisteredToolDefinition(event.toolName), this.ui, this.facade.getCwd());
-                    component.setExpanded(this.toolOutputExpanded);
-                    this.chatContainer.addChild(component);
-                    this.pendingTools.set(event.toolCallId, component);
-                }
-                component.markExecutionStarted();
-                this.ui.requestRender();
-                break;
-            }
-            case "tool_execution_update": {
-                const component = this.pendingTools.get(event.toolCallId);
-                if (component) {
-                    component.updateResult({ ...event.partialResult, isError: false }, true);
-                    this.ui.requestRender();
-                }
-                break;
-            }
-            case "tool_execution_end": {
-                const component = this.pendingTools.get(event.toolCallId);
-                if (component) {
-                    component.updateResult({ ...event.result, isError: event.isError });
-                    this.pendingTools.delete(event.toolCallId);
-                    this.ui.requestRender();
-                }
-                break;
-            }
-            case "capability_command_result": {
-                const links = event.result.links?.map((link) => `${link.label}: ${link.url}`) ?? [];
-                const message = [event.result.message, ...links].filter(Boolean).join("\n");
-                if (event.result.status === "error")
-                    this.showError(message);
-                else
-                    this.showStatus(message);
-                this.ui.requestRender();
-                break;
-            }
-            case "agent_end":
-                if (this.settingsManager.getShowTerminalProgress()) {
-                    this.ui.terminal.setProgress(false);
-                }
-                this.clearStatusIndicator("working");
-                if (this.streamingComponent) {
-                    this.chatContainer.removeChild(this.streamingComponent);
-                    this.streamingComponent = undefined;
-                    this.streamingMessage = undefined;
-                }
-                this.pendingTools.clear();
-                this.ui.requestRender();
-                break;
-            case "agent_settled":
-                await this.checkShutdownRequested();
-                break;
-            case "compaction_start": {
-                if (this.settingsManager.getShowTerminalProgress()) {
-                    this.ui.terminal.setProgress(true);
-                }
-                // Keep editor active; submissions are queued during compaction.
-                this.autoCompactionEscapeHandler = this.defaultEditor.onEscape;
-                this.defaultEditor.onEscape = () => {
-                    this.facade.abortCompaction();
-                };
-                this.showStatusIndicator(new CompactionStatusIndicator(this.ui, event.reason));
-                this.ui.requestRender();
-                break;
-            }
-            case "compaction_end": {
-                if (this.settingsManager.getShowTerminalProgress()) {
-                    this.ui.terminal.setProgress(false);
-                }
-                if (this.autoCompactionEscapeHandler) {
-                    this.defaultEditor.onEscape = this.autoCompactionEscapeHandler;
-                    this.autoCompactionEscapeHandler = undefined;
-                }
-                this.clearStatusIndicator("compaction");
-                if (event.aborted) {
-                    if (event.reason === "manual") {
-                        this.showError(t("Compaction cancelled"));
-                    }
-                    else {
-                        this.showStatus(t("Auto-compaction cancelled"));
-                    }
-                }
-                else if (event.result) {
-                    const entries = this.facade.getContextEntries();
-                    if (entries[0]?.type !== "compaction") {
-                        throw new Error(t("Completed compaction is missing from the session context"));
-                    }
-                    this.chatContainer.clear();
-                    // The latest compaction is prepended for model context; append it below at its chronological position.
-                    this.renderSessionEntries(entries.slice(1));
-                    this.addMessageToChat(createCompactionSummaryMessage(event.result.summary, event.result.tokensBefore, new Date().toISOString()));
-                    if (event.result.usage) {
-                        this.addCompactionCostNotice({
-                            type: "compaction_cost",
-                            kind: "compaction",
-                            usage: event.result.usage,
-                        });
-                    }
-                    this.footer.invalidate();
-                }
-                else if (event.errorMessage) {
-                    if (event.reason === "manual") {
-                        this.showError(event.errorMessage);
-                    }
-                    else {
-                        this.chatContainer.addChild(new Spacer(1));
-                        this.chatContainer.addChild(new Text(theme.fg("error", event.errorMessage), 1, 0));
-                    }
-                }
-                void this.flushCompactionQueue({ willRetry: event.willRetry });
-                this.ui.requestRender();
-                break;
-            }
-            case "compaction_skipped": {
-                this.showStatus(t("Auto-compaction skipped: nothing to compact"));
-                this.ui.requestRender();
-                break;
-            }
-            case "auto_retry_start": {
-                // Set up escape to abort retry
-                this.retryEscapeHandler = this.defaultEditor.onEscape;
-                this.defaultEditor.onEscape = () => {
-                    this.facade.abortRetry();
-                };
-                this.showStatusIndicator(new RetryStatusIndicator(this.ui, event.attempt, event.maxAttempts, event.delayMs));
-                this.ui.requestRender();
-                break;
-            }
-            case "auto_retry_end": {
-                // Restore escape handler
-                if (this.retryEscapeHandler) {
-                    this.defaultEditor.onEscape = this.retryEscapeHandler;
-                    this.retryEscapeHandler = undefined;
-                }
-                this.clearStatusIndicator("retry");
-                // Show error only on final failure (success shows normal response)
-                if (!event.success) {
-                    this.showError(t("Retry failed after {count} attempts: {error}", {
-                        count: event.attempt,
-                        error: event.finalError || t("Unknown error"),
-                    }));
-                }
-                this.ui.requestRender();
-                break;
-            }
-            case "summarization_retry_scheduled": {
-                this.showError(event.errorMessage);
-                this.showStatusIndicator(new RetryStatusIndicator(this.ui, event.attempt, event.maxAttempts, event.delayMs));
-                this.ui.requestRender();
-                break;
-            }
-            case "summarization_retry_attempt_start": {
-                this.clearStatusIndicator("retry");
-                if (event.source === "branchSummary") {
-                    this.showStatusIndicator(new BranchSummaryStatusIndicator(this.ui));
-                }
-                else {
-                    this.showStatusIndicator(new CompactionStatusIndicator(this.ui, event.reason));
-                }
-                this.ui.requestRender();
-                break;
-            }
-            case "summarization_retry_finished": {
-                this.clearStatusIndicator("retry");
-                this.ui.requestRender();
-                break;
-            }
-        }
+        return eventsFlow.handleEvent(this, event);
     }
-    /** Extract text content from a user message */
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
     getUserMessageText(message) {
-        if (message.role !== "user")
-            return "";
-        const textBlocks = typeof message.content === "string"
-            ? [{ type: "text", text: message.content }]
-            : message.content.filter((c) => c.type === "text");
-        return textBlocks.map((c) => c.text).join("");
+        return eventsFlow.getUserMessageText(message);
     }
     /** Show a managed-tool status update in the chat. */
     showManagedToolStatus(status) {
@@ -2084,276 +1704,57 @@ export class InteractiveMode {
         this.lastStatusText = text;
         this.ui.requestRender();
     }
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
     addMessageToChat(message, options) {
-        switch (message.role) {
-            case "bashExecution": {
-                const component = new BashExecutionComponent(message.command, this.ui, message.excludeFromContext);
-                if (message.output) {
-                    component.appendOutput(message.output);
-                }
-                component.setComplete(message.exitCode, message.cancelled, message.truncated ? { truncated: true } : undefined, message.fullOutputPath);
-                this.chatContainer.addChild(component);
-                break;
-            }
-            case "custom": {
-                if (message.display) {
-                    const renderer = undefined;
-                    const component = new CustomMessageComponent(message, renderer, this.getMarkdownThemeWithSettings(), this.outputPad);
-                    component.setExpanded(this.toolOutputExpanded);
-                    this.chatContainer.addChild(component);
-                }
-                break;
-            }
-            case "compactionSummary": {
-                this.chatContainer.addChild(new Spacer(1));
-                const component = new CompactionSummaryMessageComponent(message, this.getMarkdownThemeWithSettings());
-                component.setExpanded(this.toolOutputExpanded);
-                this.chatContainer.addChild(component);
-                break;
-            }
-            case "branchSummary": {
-                this.chatContainer.addChild(new Spacer(1));
-                const component = new BranchSummaryMessageComponent(message, this.getMarkdownThemeWithSettings());
-                component.setExpanded(this.toolOutputExpanded);
-                this.chatContainer.addChild(component);
-                break;
-            }
-            case "user": {
-                const textContent = this.getUserMessageText(message);
-                if (textContent) {
-                    if (this.chatContainer.children.length > 0) {
-                        this.chatContainer.addChild(new Spacer(1));
-                    }
-                    const skillBlock = parseSkillBlock(textContent);
-                    if (skillBlock) {
-                        // Render skill block (collapsible)
-                        const component = new SkillInvocationMessageComponent(skillBlock, this.getMarkdownThemeWithSettings());
-                        component.setExpanded(this.toolOutputExpanded);
-                        this.chatContainer.addChild(component);
-                        // Render user message separately if present
-                        if (skillBlock.userMessage) {
-                            this.chatContainer.addChild(new Spacer(1));
-                            const userComponent = new UserMessageComponent(skillBlock.userMessage, this.getMarkdownThemeWithSettings(), this.outputPad, this.getMarkdownTransformers());
-                            this.chatContainer.addChild(userComponent);
-                        }
-                    }
-                    else {
-                        const userComponent = new UserMessageComponent(textContent, this.getMarkdownThemeWithSettings(), this.outputPad, this.getMarkdownTransformers());
-                        this.chatContainer.addChild(userComponent);
-                    }
-                    if (options?.populateHistory) {
-                        this.editor.addToHistory?.(textContent);
-                    }
-                }
-                break;
-            }
-            case "assistant": {
-                const assistantComponent = new AssistantMessageComponent(message, this.hideThinkingBlock, this.getMarkdownThemeWithSettings(), this.hiddenThinkingLabel, this.outputPad, this.getMarkdownTransformers());
-                this.chatContainer.addChild(assistantComponent);
-                break;
-            }
-            case "toolResult": {
-                // Tool results are rendered inline with tool calls, handled separately
-                break;
-            }
-            default: {
-                // v8 ignore next -- exhaustive over AgentMessage roles
-                const _exhaustive = message;
-            }
-        }
+        eventsFlow.addMessageToChat(this, message, options);
     }
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
     renderSessionItems(items, options = {}) {
-        this.pendingTools.clear();
-        const renderedPendingTools = new Map();
-        // Cache-miss notices are not persisted; re-derive them from the full entry
-        // list and re-inject them after the assistant messages that paid for them.
-        const cacheMisses = this.settingsManager.getShowCacheMissNotices()
-            ? collectCacheMisses(this.facade.getEntries(), this.facade.getModelPriceSource())
-            : new Map();
-        if (options.updateFooter) {
-            this.footer.invalidate();
-            this.updateEditorBorderColor();
-        }
-        for (const item of items) {
-            if (isCustomSessionEntry(item)) {
-                // No entry renderer source since the legacy extension surface was
-                // removed; previously renderer-less entries were skipped as well.
-                continue;
-            }
-            if (isCompactionCostNotice(item)) {
-                this.addCompactionCostNotice(item);
-                continue;
-            }
-            const message = item;
-            // Assistant messages need special handling for tool calls
-            if (message.role === "assistant") {
-                this.addMessageToChat(message);
-                // Render tool call components
-                for (const content of message.content) {
-                    if (content.type === "toolCall") {
-                        const component = new ToolExecutionComponent(content.name, content.id, content.arguments, {
-                            showImages: this.settingsManager.getShowImages(),
-                            imageWidthCells: this.settingsManager.getImageWidthCells(),
-                        }, this.getRegisteredToolDefinition(content.name), this.ui, this.facade.getCwd());
-                        component.setExpanded(this.toolOutputExpanded);
-                        this.chatContainer.addChild(component);
-                        if (message.stopReason === "aborted" || message.stopReason === "error") {
-                            let errorMessage;
-                            if (message.stopReason === "aborted") {
-                                const retryAttempt = this.facade.getRetryAttempt();
-                                errorMessage =
-                                    retryAttempt > 0
-                                        ? retryAttempt === 1
-                                            ? t("Aborted after {count} retry attempt", { count: retryAttempt })
-                                            : t("Aborted after {count} retry attempts", { count: retryAttempt })
-                                        : t("Operation aborted");
-                            }
-                            else {
-                                errorMessage = message.errorMessage || t("Error");
-                            }
-                            component.updateResult({ content: [{ type: "text", text: errorMessage }], isError: true });
-                        }
-                        else {
-                            renderedPendingTools.set(content.id, component);
-                        }
-                    }
-                }
-                if (message.stopReason !== "aborted" && message.stopReason !== "error") {
-                    const miss = cacheMisses.get(message);
-                    if (miss)
-                        this.addCacheMissNotice(miss);
-                }
-            }
-            else if (message.role === "toolResult") {
-                // Match tool results to pending tool components
-                const component = renderedPendingTools.get(message.toolCallId);
-                if (component) {
-                    component.updateResult(message);
-                    renderedPendingTools.delete(message.toolCallId);
-                }
-            }
-            else {
-                // All other messages use standard rendering
-                this.addMessageToChat(message, options);
-            }
-        }
-        for (const [toolCallId, component] of renderedPendingTools) {
-            this.pendingTools.set(toolCallId, component);
-        }
-        this.ui.requestRender();
+        eventsFlow.renderSessionItems(this, items, options);
     }
     /**
      * Render session entries to chat. Used for initial load and rebuild after compaction.
      * @param entries Compaction-aware session entries to render
      * @param options.updateFooter Update footer state
      * @param options.populateHistory Add user messages to editor history
+     *
+     * Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in
+     * ./interactive-events.ts.
      */
     renderSessionEntries(entries, options = {}) {
-        const items = entries.flatMap((entry) => {
-            if (entry.type === "custom") {
-                return [entry];
-            }
-            const messages = sessionEntryToContextMessages(entry);
-            if ((entry.type === "compaction" || entry.type === "branch_summary") && entry.usage && messages.length > 0) {
-                return [...messages, { type: "compaction_cost", kind: entry.type, usage: entry.usage }];
-            }
-            return messages;
-        });
-        this.renderSessionItems(items, options);
+        eventsFlow.renderSessionEntries(this, entries, options);
     }
     /**
      * Render billing usage for a compaction or branch summary. The notice is derived
      * from persisted summary usage and is not stored as a separate session entry.
+     *
+     * Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in
+     * ./interactive-events.ts.
      */
     addCompactionCostNotice(notice) {
-        if (!this.settingsManager.getShowCacheMissNotices())
-            return;
-        const { usage } = notice;
-        const tokens = usage.input + usage.output + usage.cacheRead + usage.cacheWrite;
-        const cost = usage.cost.total >= 0.01 ? ` (~$${usage.cost.total.toFixed(2)})` : "";
-        const label = notice.kind === "compaction" ? t("Compaction") : t("Branch summary");
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Text(theme.fg("warning", `${label}: ${t("{tokens} tokens billed{cost}", { tokens: formatTokens(tokens), cost })}`), 1, 0));
-    }
-    static countDroppedThinkingBlocks(message) {
-        let count = 0;
-        for (const diagnostic of message.diagnostics ?? []) {
-            if (diagnostic.type !== "anthropic_input_transformations")
-                continue;
-            const transformations = diagnostic.details?.transformations;
-            if (!Array.isArray(transformations))
-                continue;
-            count += transformations.filter((transformation) => typeof transformation === "object" &&
-                transformation !== null &&
-                transformation.type === "thinking_dropped").length;
-        }
-        return count;
+        eventsFlow.addCompactionCostNotice(this, notice);
     }
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
     maybeShowThinkingDropNotice(message) {
-        if (!this.settingsManager.getShowCacheMissNotices())
-            return;
-        const droppedCount = InteractiveMode.countDroppedThinkingBlocks(message);
-        if (droppedCount === 0)
-            return;
-        let previousDroppedCount = 0;
-        // message_end reaches the UI before the current message is persisted,
-        // so the branch's last assistant message is the previous response.
-        const entries = this.facade.getEntries();
-        for (let i = entries.length - 1; i >= 0; i--) {
-            const entry = entries[i];
-            if (entry.type === "message" && entry.message.role === "assistant") {
-                previousDroppedCount = InteractiveMode.countDroppedThinkingBlocks(entry.message);
-                break;
-            }
-        }
-        if (droppedCount <= previousDroppedCount)
-            return;
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Text(theme.fg("warning", t("Anthropic dropped {count} thinking blocks (details in session)", { count: droppedCount })), 1, 0));
+        eventsFlow.maybeShowThinkingDropNotice(this, message);
     }
     /**
      * Show a transcript notice when a completed assistant message paid for a
      * significant cache miss. Only states observable facts: the miss itself,
      * a model switch, or an idle gap past the cache TTL.
+     *
+     * Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in
+     * ./interactive-events.ts.
      */
     maybeShowCacheMissNotice(message) {
-        if (!this.settingsManager.getShowCacheMissNotices())
-            return;
-        // Entries don't contain `message` yet: message_end fires before persistence.
-        const miss = detectCacheMiss(this.facade.getEntries(), message, this.facade.getModelPriceSource());
-        if (miss)
-            this.addCacheMissNotice(miss);
+        eventsFlow.maybeShowCacheMissNotice(this, message);
     }
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
     addCacheMissNotice(miss) {
-        if (miss.missedTokens < 20_000 && miss.missedCost < 0.1)
-            return;
-        const cost = miss.missedCost >= 0.01 ? ` (~$${miss.missedCost.toFixed(2)})` : "";
-        const reBilled = t("{tokens} tokens re-billed{cost}", { tokens: formatTokens(miss.missedTokens), cost });
-        let label = t("Cache miss");
-        if (miss.modelChanged) {
-            label = t("Cache miss after model switch");
-        }
-        else if (miss.idleMs >= CACHE_TTL_MS) {
-            label = t("Cache miss after {minutes}m idle", { minutes: Math.round(miss.idleMs / 60_000) });
-        }
-        const text = theme.fg("warning", `${label}: ${reBilled}`);
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Text(text, 1, 0));
+        eventsFlow.addCacheMissNotice(this, miss);
     }
     renderInitialMessages() {
-        const entries = this.facade.getContextEntries();
-        this.renderSessionEntries(entries, {
-            updateFooter: true,
-            populateHistory: true,
-        });
-        // Show compaction info if session was compacted
-        const allEntries = this.facade.getEntries();
-        const compactionCount = allEntries.filter((e) => e.type === "compaction").length;
-        if (compactionCount > 0) {
-            this.showStatus(compactionCount === 1
-                ? t("Session compacted {count} time", { count: compactionCount })
-                : t("Session compacted {count} times", { count: compactionCount }));
-        }
+        eventsFlow.renderInitialMessages(this);
     }
     async getUserInput() {
         const queuedInput = this.pendingUserInputs.shift();
@@ -2367,251 +1768,84 @@ export class InteractiveMode {
             };
         });
     }
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1); implementation in ./interactive-events.ts (拆分 slice 5). */
     rebuildChatFromMessages() {
-        this.chatContainer.clear();
-        this.renderSessionEntries(this.facade.getContextEntries());
+        eventsFlow.rebuildChatFromMessages(this);
     }
     // =========================================================================
-    // Key handlers
+    // Exit and signal lifecycle (implementation in ./interactive-lifecycle.ts,
+    // 拆分 slice 4) — same-name delegates keep the editor key wiring, init/stop,
+    // and prototype-level tests bound to these names. The main loop and the TUI
+    // teardown (stop) stay on the mode, as does formatResumeCommand (D-041 §3.5).
     // =========================================================================
+    /** Ctrl+C interrupt/exit grading; implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
     handleCtrlC() {
-        const now = Date.now();
-        if (now - this.lastSigintTime < 500) {
-            void this.shutdown();
-        }
-        else {
-            this.clearEditor();
-            this.lastSigintTime = now;
-        }
+        lifecycleFlow.handleCtrlC(this);
     }
+    /** Ctrl+D exit on empty editor; implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
     handleCtrlD() {
-        // Only called when editor is empty (enforced by CustomEditor)
-        void this.shutdown();
+        lifecycleFlow.handleCtrlD(this);
     }
     /**
      * Gracefully shutdown the agent.
      * Stops the TUI before emitting shutdown events so extension UI cleanup cannot
-     * repaint the final frame while the process is exiting.
+     * repaint the final frame while the process is exiting; implementation in
+     * ./interactive-lifecycle.ts (拆分 slice 4).
      */
-    isShuttingDown = false;
     async shutdown(options) {
-        if (this.isShuttingDown)
-            return;
-        this.isShuttingDown = true;
-        // Keep signal handlers registered until terminal cleanup has completed.
-        // `signal-exit` checks the listener list during the same SIGTERM/SIGHUP
-        // dispatch and re-sends the signal if only its own listeners remain.
-        if (options?.fromSignal) {
-            // Signal-triggered shutdown (SIGTERM/SIGHUP). Emit extension cleanup
-            // (session_shutdown) BEFORE touching the terminal. Extension teardown
-            // such as removing sockets does not write to the tty, so it must not be
-            // skipped if a later terminal-restore write fails on a dead or stalled
-            // terminal. If the terminal is gone, the restore writes below emit EIO,
-            // which the stdout/stderr error handler turns into emergencyTerminalExit;
-            // the render loop is already idle, so this cannot hot-spin (see #4144).
-            await this.runtimeFacade.dispose();
-            this.themeController.disableAutoSync();
-            await this.ui.terminal.drainInput(1000);
-            this.stop();
-            process.exit(0);
-        }
-        // Interactive quit (Ctrl+D, Ctrl+C, /quit, extension shutdown()). Stop the
-        // TUI before emitting shutdown events so extension UI cleanup cannot repaint
-        // the final frame while the process is exiting.
-        // Drain any in-flight Kitty key release events before stopping.
-        // This prevents escape sequences from leaking to the parent shell over slow SSH.
-        this.themeController.disableAutoSync();
-        await this.ui.terminal.drainInput(1000);
-        this.stop();
-        await this.runtimeFacade.dispose();
-        const resumeCommand = formatResumeCommand(this.runtimeFacade);
-        if (resumeCommand) {
-            process.stdout.write(`${chalk.dim(t("To resume this session:"))} ${resumeCommand}\n`);
-        }
-        process.exit(0);
+        return lifecycleFlow.shutdown(this, options);
     }
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): dead-terminal emergency exit. */
     emergencyTerminalExit() {
-        this.isShuttingDown = true;
-        this.unregisterSignalHandlers();
-        killTrackedDetachedChildren();
-        // The terminal is gone. Do not run normal shutdown because TUI and
-        // extension cleanup can write restore sequences and re-trigger EIO.
-        process.exit(129);
+        lifecycleFlow.emergencyTerminalExit(this);
     }
-    /**
-     * Last-resort handler for uncaught exceptions. The TUI puts stdin into raw
-     * mode and hides the cursor; without this handler, an uncaught throw from
-     * anywhere (e.g. an extension's async `ChildProcess.on("exit")` callback)
-     * tears down the process while leaving the terminal in raw mode with no
-     * cursor, requiring `stty sane && reset` to recover.
-     *
-     * Unlike emergencyTerminalExit, the terminal is still alive here, so we
-     * call ui.stop() to restore cooked mode, the cursor, and disable bracketed
-     * paste / Kitty / modifyOtherKeys sequences.
-     */
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): uncaught-exception crash handler. */
     uncaughtCrash(error) {
-        if (this.isShuttingDown) {
-            process.exit(1);
-        }
-        this.isShuttingDown = true;
-        try {
-            this.unregisterSignalHandlers();
-        }
-        catch { }
-        try {
-            killTrackedDetachedChildren();
-        }
-        catch { }
-        try {
-            this.ui.stop();
-        }
-        catch { }
-        console.error(t("{app} exiting due to uncaughtException:", { app: APP_NAME }));
-        console.error(error);
-        process.exit(1);
+        lifecycleFlow.uncaughtCrash(this, error);
     }
-    /**
-     * Check if shutdown was requested and perform shutdown if so.
-     */
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
     async checkShutdownRequested() {
-        if (!this.shutdownRequested)
-            return;
-        await this.shutdown();
+        return lifecycleFlow.checkShutdownRequested(this);
     }
+    /** Signal/stderr/uncaught registration; implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
     registerSignalHandlers() {
-        this.unregisterSignalHandlers();
-        const signals = ["SIGTERM"];
-        if (process.platform !== "win32") {
-            signals.push("SIGHUP");
-        }
-        for (const signal of signals) {
-            const handler = () => {
-                // SIGHUP no longer hard-exits: graceful shutdown emits session_shutdown
-                // first, then attempts terminal restore. A genuinely dead terminal
-                // surfaces as an EIO on the restore writes, which the stdout/stderr
-                // error handler converts into emergencyTerminalExit (see #4144, #5080).
-                killTrackedDetachedChildren();
-                void this.shutdown({ fromSignal: true });
-            };
-            process.prependListener(signal, handler);
-            this.signalCleanupHandlers.push(() => process.off(signal, handler));
-        }
-        const terminalErrorHandler = (error) => {
-            if (isDeadTerminalError(error)) {
-                this.emergencyTerminalExit();
-            }
-            throw error;
-        };
-        process.stdout.on("error", terminalErrorHandler);
-        process.stderr.on("error", terminalErrorHandler);
-        this.signalCleanupHandlers.push(() => process.stdout.off("error", terminalErrorHandler));
-        this.signalCleanupHandlers.push(() => process.stderr.off("error", terminalErrorHandler));
-        // Restore the terminal before the process dies on any uncaught throw.
-        // Without this, an unhandled exception from extension code (or anywhere
-        // in the application) leaves the terminal in raw mode with no cursor.
-        const uncaughtExceptionHandler = (error) => this.uncaughtCrash(error);
-        process.prependListener("uncaughtException", uncaughtExceptionHandler);
-        this.signalCleanupHandlers.push(() => process.off("uncaughtException", uncaughtExceptionHandler));
+        lifecycleFlow.registerSignalHandlers(this);
     }
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): also called by the mode's stop(). */
     unregisterSignalHandlers() {
-        for (const cleanup of this.signalCleanupHandlers) {
-            cleanup();
-        }
-        this.signalCleanupHandlers = [];
+        lifecycleFlow.unregisterSignalHandlers(this);
     }
+    /** Suspend to background (Ctrl+Z); implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
     handleCtrlZ() {
-        if (process.platform === "win32") {
-            this.showStatus(t("Suspend to background is not supported on Windows"));
-            return;
-        }
-        // Keep the event loop alive while suspended. Without this, stopping the TUI
-        // can leave Node with no ref'ed handles, causing the process to exit on fg
-        // before the SIGCONT handler gets a chance to restore the terminal.
-        const suspendKeepAlive = setInterval(() => { }, 2 ** 30);
-        // Ignore SIGINT while suspended so Ctrl+C in the terminal does not
-        // kill the backgrounded process. The handler is removed on resume.
-        const ignoreSigint = () => { };
-        process.on("SIGINT", ignoreSigint);
-        // Set up handler to restore TUI when resumed
-        process.once("SIGCONT", () => {
-            clearInterval(suspendKeepAlive);
-            process.removeListener("SIGINT", ignoreSigint);
-            this.ui.start();
-            this.ui.requestRender(true);
-        });
-        try {
-            // Stop the TUI (restore terminal to normal mode)
-            this.ui.stop();
-            // Send SIGTSTP to process group (pid=0 means all processes in group)
-            process.kill(0, "SIGTSTP");
-        }
-        catch (error) {
-            clearInterval(suspendKeepAlive);
-            process.removeListener("SIGINT", ignoreSigint);
-            throw error;
-        }
+        lifecycleFlow.handleCtrlZ(this);
     }
-    async handleFollowUp(explicitText) {
-        const text = (explicitText ?? this.editor.getExpandedText?.() ?? this.editor.getText()).trim();
-        if (!text)
-            return;
-        // Queue input during compaction (extension commands execute immediately)
-        if (this.facade.isCompacting()) {
-            this.queueCompactionMessage(text, "followUp");
-            return;
-        }
-        // Alt+Enter queues a follow-up message (waits until agent finishes)
-        // This handles extension commands (execute immediately), prompt template expansion, and queueing
-        if (this.facade.isStreaming()) {
-            // An explicit /queue <text> argument must not touch the editor draft.
-            if (explicitText === undefined) {
-                this.editor.addToHistory?.(text);
-                this.editor.setText("");
-            }
-            await this.facade.prompt(text, { streamingBehavior: "followUp" });
-            this.updatePendingMessagesDisplay();
-            this.ui.requestRender();
-        }
-        // If not streaming, Alt+Enter acts like regular Enter (trigger onSubmit)
-        else if (this.editor.onSubmit) {
-            if (explicitText === undefined)
-                this.editor.setText("");
-            this.editor.onSubmit(text);
-        }
+    /**
+     * Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): the function
+     * stays resident in this module (D-041 §3.5 — resume hints are host TUI
+     * behavior, not a facade contract).
+     */
+    formatResumeCommand(session) {
+        return formatResumeCommand(session);
+    }
+    /** Follow-up queue entry (Alt+Enter / /queue); implementation in ./interactive-queues.ts (拆分 slice 3). */
+    handleFollowUp(explicitText) {
+        return queuesFlow.handleFollowUp(this, explicitText);
     }
+    /** Dequeue restore (keybinding / /dequeue); implementation in ./interactive-queues.ts (拆分 slice 3). */
     handleDequeue() {
-        const restored = this.restoreQueuedMessagesToEditor();
-        if (restored === 0) {
-            this.showStatus(t("No queued messages to restore"));
-        }
-        else if (restored === 1) {
-            this.showStatus(t("Restored {count} queued message to editor", { count: restored }));
-        }
-        else {
-            this.showStatus(t("Restored {count} queued messages to editor", { count: restored }));
-        }
+        queuesFlow.handleDequeue(this);
     }
-    /** /queue command host face (single-entry iron law): queues the given text for after the current run. A bare /queue cannot mirror the keybinding — the editor buffer is cleared on submit before the command runs — so it prints usage instead of silently doing nothing. */
+    /** /queue command host face (single-entry iron law); implementation in ./interactive-queues.ts (拆分 slice 3). */
     handleQueueCommand(text) {
-        if (text === undefined || text.trim() === "") {
-            this.showStatus(t("Usage: /queue <text>"));
-            return Promise.resolve();
-        }
-        return this.handleFollowUp(text);
+        return queuesFlow.handleQueueCommand(this, text);
     }
-    /** /dequeue command host face: restore queued messages back to the editor. */
+    /** /dequeue command host face; implementation in ./interactive-queues.ts (拆分 slice 3). */
     handleDequeueCommand() {
-        this.handleDequeue();
+        queuesFlow.handleDequeueCommand(this);
     }
-    /** /queue-list command host face: open the queued-message manager selector. Both queues empty is a status message, not an empty overlay. */
+    /** /queue-list command host face; implementation in ./interactive-queues.ts (拆分 slice 3). */
     handleQueueListCommand() {
-        const steering = this.facade.getSteeringMessages();
-        const followUp = this.facade.getFollowUpMessages();
-        if (steering.length === 0 && followUp.length === 0) {
-            this.showStatus(t("No queued messages to manage"));
-            return;
-        }
-        selectorsFlow.showQueueManagerSelector(this);
+        queuesFlow.handleQueueListCommand(this);
     }
     /** /editor command host face: edit the current input in an external editor. */
     handleEditorCommand() {
@@ -2666,6 +1900,34 @@ export class InteractiveMode {
     toggleToolOutputExpansion() {
         this.setToolsExpanded(!this.toolOutputExpanded);
     }
+    /**
+     * D-083 quiet transcript: mount a tool component into the current
+     * assistant turn's tool-run group (creating the group on first tool of
+     * the turn) instead of the chat container directly. Collapsed groups
+     * render one dim marker line for the whole turn.
+     *
+     * Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in
+     * ./interactive-events.ts.
+     */
+    addToolToRunGroup(component) {
+        eventsFlow.addToolToRunGroup(this, component);
+    }
+    /**
+     * Narrowing-safe faces for the active group inside renderSessionItems:
+     * addToolToRunGroup may (re)assign this.activeToolRunGroup behind the
+     * compiler's back, so group reads go through methods instead of the
+     * narrowed property reference.
+     *
+     * Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in
+     * ./interactive-events.ts.
+     */
+    noteResultInActiveToolRunGroup(isError) {
+        eventsFlow.noteResultInActiveToolRunGroup(this, isError);
+    }
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
+    markActiveToolRunGroupComplete() {
+        eventsFlow.markActiveToolRunGroupComplete(this);
+    }
     setToolsExpanded(expanded) {
         if (expanded === this.toolOutputExpanded)
             return;
@@ -2684,6 +1946,7 @@ export class InteractiveMode {
         this.showStatus(expanded ? t("Tool output: expanded") : t("Tool output: collapsed"));
     }
     /** Update rendered assistant messages without rebuilding live tool components. */
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     updateThinkingBlockVisibility() {
         for (const child of this.chatContainer.children) {
             if (child instanceof AssistantMessageComponent) {
@@ -2771,58 +2034,27 @@ export class InteractiveMode {
     /**
      * Get all queued messages (read-only).
      * Combines session queue and compaction queue.
+     *
+     * Host-visible for ./interactive-queues.ts (拆分 slice 3): the merged read
+     * behind the pending-messages display.
      */
     getAllQueuedMessages() {
-        return {
-            steering: [
-                ...this.facade.getSteeringMessages(),
-                ...this.compactionQueuedMessages.filter((msg) => msg.mode === "steer").map((msg) => msg.text),
-            ],
-            followUp: [
-                ...this.facade.getFollowUpMessages(),
-                ...this.compactionQueuedMessages.filter((msg) => msg.mode === "followUp").map((msg) => msg.text),
-            ],
-        };
+        return queuesFlow.getAllQueuedMessages(this);
     }
     /**
      * Clear all queued messages and return their contents.
-     * Clears both session queue and compaction queue.
+     * Clears both session queue and compaction queue; implementation in
+     * ./interactive-queues.ts (拆分 slice 3). Stays reachable from the mode's
+     * restoreQueuedMessagesToEditor.
      */
     clearAllQueues() {
-        const { steering, followUp } = this.facade.clearQueue();
-        const compactionSteering = this.compactionQueuedMessages
-            .filter((msg) => msg.mode === "steer")
-            .map((msg) => msg.text);
-        const compactionFollowUp = this.compactionQueuedMessages
-            .filter((msg) => msg.mode === "followUp")
-            .map((msg) => msg.text);
-        this.compactionQueuedMessages = [];
-        return {
-            steering: [...steering, ...compactionSteering],
-            followUp: [...followUp, ...compactionFollowUp],
-        };
+        return queuesFlow.clearAllQueues(this);
     }
-    /** Host-visible for ./interactive-selectors.ts (queue manager close path). */
+    /** Host-visible for ./interactive-selectors.ts (queue manager close path) and ./interactive-events.ts (拆分 slice 3); implementation in ./interactive-queues.ts. */
     updatePendingMessagesDisplay() {
-        this.pendingMessagesContainer.clear();
-        const { steering: steeringMessages, followUp: followUpMessages } = this.getAllQueuedMessages();
-        if (steeringMessages.length > 0 || followUpMessages.length > 0) {
-            this.pendingMessagesContainer.addChild(new Spacer(1));
-            for (const message of steeringMessages) {
-                const text = theme.fg("dim", t("Steering: {message}", { message }));
-                this.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0));
-            }
-            for (const message of followUpMessages) {
-                const text = theme.fg("dim", t("Follow-up: {message}", { message }));
-                this.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0));
-            }
-            // The dequeue keybinding's shipped default was cleared (iron law):
-            // /queue's sibling command is the discoverable entry.
-            const dequeueHint = this.getAppKeyDisplay("app.message.dequeue") || "/dequeue";
-            const hintText = theme.fg("dim", t("↳ {key} to edit all queued messages", { key: dequeueHint }));
-            this.pendingMessagesContainer.addChild(new TruncatedText(hintText, 1, 0));
-        }
+        queuesFlow.updatePendingMessagesDisplay(this);
     }
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     restoreQueuedMessagesToEditor(options) {
         const { steering, followUp } = this.clearAllQueues();
         const allQueued = [...steering, ...followUp];
@@ -2846,68 +2078,13 @@ export class InteractiveMode {
         }
         return allQueued.length;
     }
+    /** Host-visible for ./interactive-queues.ts (拆分 slice 3); implementation in ./interactive-queues.ts. */
     queueCompactionMessage(text, mode) {
-        this.compactionQueuedMessages.push({ text, mode });
-        this.editor.addToHistory?.(text);
-        this.editor.setText("");
-        this.updatePendingMessagesDisplay();
-        this.showStatus(t("Queued message for after compaction"));
+        queuesFlow.queueCompactionMessage(this, text, mode);
     }
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2) and ./interactive-events.ts; implementation in ./interactive-queues.ts (拆分 slice 3). */
     async flushCompactionQueue(options) {
-        if (this.compactionQueuedMessages.length === 0) {
-            return;
-        }
-        const queuedMessages = [...this.compactionQueuedMessages];
-        this.compactionQueuedMessages = [];
-        this.updatePendingMessagesDisplay();
-        const restoreQueue = (error) => {
-            this.facade.clearQueue();
-            this.compactionQueuedMessages = queuedMessages;
-            this.updatePendingMessagesDisplay();
-            this.showError(queuedMessages.length > 1
-                ? t("Failed to send queued messages: {error}", {
-                    error: error instanceof Error ? error.message : String(error),
-                })
-                : t("Failed to send queued message: {error}", {
-                    error: error instanceof Error ? error.message : String(error),
-                }));
-        };
-        try {
-            if (options?.willRetry) {
-                // When retry is pending, queue messages for the retry turn
-                for (const message of queuedMessages) {
-                    if (message.mode === "followUp") {
-                        await this.facade.followUp(message.text);
-                    }
-                    else {
-                        await this.facade.steer(message.text);
-                    }
-                }
-                this.updatePendingMessagesDisplay();
-                return;
-            }
-            const [firstPrompt, ...rest] = queuedMessages;
-            // Start a prompt when idle, or queue it into a run still finishing compaction.
-            const promptPromise = this.facade
-                .prompt(firstPrompt.text, { streamingBehavior: firstPrompt.mode })
-                .catch((error) => {
-                restoreQueue(error);
-            });
-            // Queue remaining messages
-            for (const message of rest) {
-                if (message.mode === "followUp") {
-                    await this.facade.followUp(message.text);
-                }
-                else {
-                    await this.facade.steer(message.text);
-                }
-            }
-            this.updatePendingMessagesDisplay();
-            void promptPromise;
-        }
-        catch (error) {
-            restoreQueue(error);
-        }
+        return queuesFlow.flushCompactionQueue(this, options);
     }
     /** Move pending bash components from pending area to chat */
     flushPendingBashComponents() {
@@ -2919,15 +2096,14 @@ export class InteractiveMode {
     }
     // =========================================================================
     // Selectors
-    // Suite/thinking/model/scoped-models/user-message-fork/clone selectors are
-    // implemented in ./interactive-selectors.ts (S5 slice 5) behind the
+    // All selector/view implementations — the S5 slice 5 suite/thinking/model/
+    // scoped-models/user-message-fork/clone selectors and the 拆分 slice 2
+    // settings/workflow/agents/tree/session selectors, resume, and the
+    // startup-suite recovery — live in ./interactive-selectors.ts behind the
     // SelectorsHost interface; same-name delegates below keep the command
     // dispatch and prototype-level tests bound to these names. The selector
-    // infrastructure (showSelector/disposeActiveSelector), the settings/tree/
-    // session selectors, and resume stay on the mode: the settings and tree
-    // selectors assemble from broad private UI state, and the session/resume
-    // path is the documented session-boundary carve-out (SessionManager
-    // manager-level writes plus per-entry display reads).
+    // infrastructure (showSelector/disposeActiveSelector) and the shared
+    // detectCrossSuiteResume helper stay on the mode.
     // =========================================================================
     disposeActiveSelector() {
         const dispose = this.activeSelectorDispose;
@@ -2962,230 +2138,9 @@ export class InteractiveMode {
         this.ui.setFocus(created.focus);
         this.ui.requestRender();
     }
+    /** Settings selector; implementation in ./interactive-selectors.ts (拆分 slice 2). */
     showSettingsSelector() {
-        this.showSelector((done) => {
-            let selector;
-            const defaultProvider = this.settingsManager.getDefaultProvider();
-            const defaultModelId = this.settingsManager.getDefaultModel();
-            const defaultModel = defaultProvider && defaultModelId ? `${defaultProvider}/${defaultModelId}` : t("not set");
-            selector = new SettingsSelectorComponent({
-                defaultModel,
-                currentModel: this.facade.getModel(),
-                availableDefaultModels: this.facade.getAvailableModels(),
-                showImages: this.settingsManager.getShowImages(),
-                imageWidthCells: this.settingsManager.getImageWidthCells(),
-                autoResizeImages: this.settingsManager.getImageAutoResize(),
-                blockImages: this.settingsManager.getBlockImages(),
-                steeringMode: this.facade.getSteeringMode(),
-                followUpMode: this.facade.getFollowUpMode(),
-                transport: this.settingsManager.getTransport(),
-                httpIdleTimeoutMs: this.settingsManager.getHttpIdleTimeoutMs(),
-                thinkingLevel: this.settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL,
-                availableThinkingLevels: [...THINKING_LEVEL_OPTIONS],
-                modelThinkingLevels: this.settingsManager.getAllModelThinkingLevels(),
-                currentTheme: this.themeController.getThemeSelection() || "dark",
-                terminalTheme: this.themeController.getTerminalTheme(),
-                availableThemes: getAvailableThemes(),
-                hideThinkingBlock: this.hideThinkingBlock,
-                mermaidRenderingMode: this.settingsManager.getMermaidRenderingMode(),
-                collapseChangelog: this.settingsManager.getCollapseChangelog(),
-                doubleEscapeAction: this.settingsManager.getDoubleEscapeAction(),
-                uiLanguage: this.settingsManager.getUiLanguage(),
-                treeFilterMode: this.settingsManager.getTreeFilterMode(),
-                showHardwareCursor: this.settingsManager.getShowHardwareCursor(),
-                showCacheMissNotices: this.settingsManager.getShowCacheMissNotices(),
-                editorPaddingX: this.settingsManager.getEditorPaddingX(),
-                outputPad: this.settingsManager.getOutputPad(),
-                autocompleteMaxVisible: this.settingsManager.getAutocompleteMaxVisible(),
-                quietStartup: this.settingsManager.getQuietStartup(),
-                clearOnShrink: this.settingsManager.getClearOnShrink(),
-                showTerminalProgress: this.settingsManager.getShowTerminalProgress(),
-                tuiMode: this.ui.mode,
-                fullscreenExitOutput: this.settingsManager.getFullscreenExitOutput(),
-                fullscreenScrollbar: this.settingsManager.getFullscreenScrollbar(),
-                fullscreenCopyOnSelect: this.settingsManager.getFullscreenCopyOnSelect(),
-                fullscreenWheelScrollLines: this.settingsManager.getFullscreenWheelScrollLines(),
-                warnings: this.settingsManager.getWarnings(),
-            }, {
-                onShowImagesChange: (enabled) => {
-                    this.settingsManager.setShowImages(enabled);
-                    for (const child of this.chatContainer.children) {
-                        if (child instanceof ToolExecutionComponent) {
-                            child.setShowImages(enabled);
-                        }
-                    }
-                },
-                onImageWidthCellsChange: (width) => {
-                    this.settingsManager.setImageWidthCells(width);
-                    for (const child of this.chatContainer.children) {
-                        if (child instanceof ToolExecutionComponent) {
-                            child.setImageWidthCells(width);
-                        }
-                    }
-                },
-                onAutoResizeImagesChange: (enabled) => {
-                    this.settingsManager.setImageAutoResize(enabled);
-                },
-                onBlockImagesChange: (blocked) => {
-                    this.settingsManager.setBlockImages(blocked);
-                },
-                onSteeringModeChange: (mode) => {
-                    this.facade.setSteeringMode(mode);
-                },
-                onFollowUpModeChange: (mode) => {
-                    this.facade.setFollowUpMode(mode);
-                },
-                onTransportChange: (transport) => {
-                    this.settingsManager.setTransport(transport);
-                    this.session.host.setTransport(transport);
-                },
-                onHttpIdleTimeoutMsChange: (timeoutMs) => {
-                    this.settingsManager.setHttpIdleTimeoutMs(timeoutMs);
-                    configureHttpDispatcher(timeoutMs);
-                    this.showStatus(t("HTTP idle timeout: {value}", { value: formatHttpIdleTimeoutMs(timeoutMs) }));
-                },
-                onModelThinkingLevelChange: (provider, modelId, level) => {
-                    this.settingsManager.setModelThinkingLevel(provider, modelId, level);
-                    // If the override is for the current model, apply it to the session too
-                    const current = this.facade.getModel();
-                    if (current && current.provider === provider && current.id === modelId) {
-                        this.facade.setThinkingLevel(level);
-                        this.footer.invalidate();
-                        this.updateEditorBorderColor();
-                    }
-                },
-                onModelThinkingLevelRemove: (provider, modelId) => {
-                    this.settingsManager.removeModelThinkingLevel(provider, modelId);
-                    // If the override was for the current model, revert to global default
-                    const current = this.facade.getModel();
-                    if (current && current.provider === provider && current.id === modelId) {
-                        const globalDefault = this.settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;
-                        this.facade.setThinkingLevel(globalDefault);
-                        this.footer.invalidate();
-                        this.updateEditorBorderColor();
-                    }
-                },
-                onThemeChange: (themeSetting) => {
-                    this.settingsManager.setTheme(themeSetting);
-                    void this.themeController.setThemeSetting(themeSetting);
-                },
-                onThemePreview: (themeName) => this.themeController.preview(themeName),
-                onHideThinkingBlockChange: (hidden) => {
-                    this.hideThinkingBlock = hidden;
-                    this.settingsManager.setHideThinkingBlock(hidden);
-                    this.updateThinkingBlockVisibility();
-                },
-                onMermaidRenderingModeChange: (mode) => {
-                    this.settingsManager.setMermaidRenderingMode(mode);
-                    this.chatContainer.invalidate();
-                    this.ui.requestRender();
-                },
-                onShowCacheMissNoticesChange: (shown) => {
-                    this.settingsManager.setShowCacheMissNotices(shown);
-                    this.rebuildChatFromMessages();
-                },
-                onCollapseChangelogChange: (collapsed) => {
-                    this.settingsManager.setCollapseChangelog(collapsed);
-                },
-                onQuietStartupChange: (enabled) => {
-                    this.settingsManager.setQuietStartup(enabled);
-                },
-                onDoubleEscapeActionChange: (action) => {
-                    this.settingsManager.setDoubleEscapeAction(action);
-                },
-                onUiLanguageChange: (language) => {
-                    this.settingsManager.setUiLanguage(language);
-                    setI18nLanguage(language);
-                    this.ui.requestRender();
-                },
-                onTreeFilterModeChange: (mode) => {
-                    this.settingsManager.setTreeFilterMode(mode);
-                },
-                onShowHardwareCursorChange: (enabled) => {
-                    this.settingsManager.setShowHardwareCursor(enabled);
-                    this.ui.setShowHardwareCursor(enabled);
-                },
-                onEditorPaddingXChange: (padding) => {
-                    this.settingsManager.setEditorPaddingX(padding);
-                    this.defaultEditor.setPaddingX(padding);
-                    if (this.editor !== this.defaultEditor && this.editor.setPaddingX !== undefined) {
-                        this.editor.setPaddingX(padding);
-                    }
-                },
-                onOutputPadChange: (padding) => {
-                    this.settingsManager.setOutputPad(padding);
-                    this.outputPad = padding;
-                    if (this.streamingComponent || this.facade.isStreaming()) {
-                        for (const child of this.chatContainer.children) {
-                            if (child instanceof AssistantMessageComponent ||
-                                child instanceof CustomMessageComponent ||
-                                child instanceof UserMessageComponent) {
-                                child.setOutputPad(padding);
-                            }
-                        }
-                        if (this.streamingComponent) {
-                            this.streamingComponent.setOutputPad(padding);
-                        }
-                        this.ui.requestRender();
-                        return;
-                    }
-                    this.rebuildChatFromMessages();
-                },
-                onAutocompleteMaxVisibleChange: (maxVisible) => {
-                    this.settingsManager.setAutocompleteMaxVisible(maxVisible);
-                    this.defaultEditor.setAutocompleteMaxVisible(maxVisible);
-                    if (this.editor !== this.defaultEditor && this.editor.setAutocompleteMaxVisible !== undefined) {
-                        this.editor.setAutocompleteMaxVisible(maxVisible);
-                    }
-                },
-                onClearOnShrinkChange: (enabled) => {
-                    this.settingsManager.setClearOnShrink(enabled);
-                    this.ui.setClearOnShrink(enabled);
-                    if (!enabled && !this.activeStatusIndicator) {
-                        this.statusContainer.clear();
-                    }
-                },
-                onShowTerminalProgressChange: (enabled) => {
-                    this.settingsManager.setShowTerminalProgress(enabled);
-                },
-                onTuiModeChange: (mode) => {
-                    if (!this.switchTuiMode(mode)) {
-                        selector?.getSettingsList().updateValue("tui-mode", this.ui.mode);
-                        this.showStatus(t("Close active overlays before changing TUI mode"));
-                        return;
-                    }
-                    this.settingsManager.setTuiMode(mode);
-                    if (!this.activeStatusIndicator)
-                        this.statusContainer.clear();
-                    this.showStatus(t("TUI mode: {mode}", { mode }));
-                },
-                onFullscreenExitOutputChange: (output) => {
-                    this.settingsManager.setFullscreenExitOutput(output);
-                },
-                onFullscreenScrollbarChange: (mode) => {
-                    this.settingsManager.setFullscreenScrollbar(mode);
-                    this.applyFullscreenScrollbarSetting();
-                },
-                onFullscreenCopyOnSelectChange: (enabled) => {
-                    this.settingsManager.setFullscreenCopyOnSelect(enabled);
-                    if (this.renderer instanceof TuiAltScreen)
-                        this.renderer.setCopyOnSelect(enabled);
-                },
-                onFullscreenWheelScrollLinesChange: (lines) => {
-                    this.settingsManager.setFullscreenWheelScrollLines(lines);
-                    if (this.renderer instanceof TuiAltScreen)
-                        this.renderer.setWheelScrollLines(lines);
-                },
-                onWarningsChange: (warnings) => {
-                    this.settingsManager.setWarnings(warnings);
-                },
-                onCancel: () => {
-                    done();
-                    this.ui.requestRender();
-                },
-            });
-            return { component: selector, focus: selector.getSettingsList() };
-        });
+        selectorsFlow.showSettingsSelector(this);
     }
     /** /thinking command entry; implementation in ./interactive-selectors.ts (S5 slice 5). */
     handleThinkingCommand(searchTerm) {
@@ -3232,6 +2187,7 @@ export class InteractiveMode {
      * file's binding entry and cached per path — the selector refilters the
      * list on every keystroke.
      */
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
     readSessionSuiteId(sessionPath) {
         this.sessionSuiteIdCache ??= new Map();
         if (this.sessionSuiteIdCache.has(sessionPath))
@@ -3256,36 +2212,12 @@ export class InteractiveMode {
         selectorsFlow.openSuiteListSelector(this, callbacks);
     }
     /**
-     * Interactive recovery for an unresolved startup suite id (设计 §9): pick a
-     * suite, persist it as the project setting, then rebuild the session with
-     * the selected suite via the same /new assembly path. Cancelling keeps the
-     * fallback assembly the runtime started with.
+     * Interactive recovery for an unresolved startup suite id (设计 §9); the
+     * implementation is in ./interactive-selectors.ts (拆分 slice 2). The
+     * startup path on the mode calls this delegate.
      */
     async showStartupSuiteSelector(pending) {
-        const selected = await new Promise((resolve) => {
-            this.openSuiteListSelector({
-                availableSuites: pending.available,
-                note: t('Suite "{id}" was not found. The selected suite applies to the new session.', {
-                    id: pending.requestedId,
-                }),
-                onSelect: (suiteId) => resolve(suiteId),
-                onCancel: () => resolve(undefined),
-            });
-        });
-        if (selected === undefined) {
-            this.showWarning(t('Suite "{id}" was not found — continuing without a suite. Use /suite to choose one.', {
-                id: pending.requestedId,
-            }));
-            return;
-        }
-        this.settingsManager.setProjectSuite(selected);
-        try {
-            await this.runtimeFacade.newSession();
-            this.showStatus(t("Suite set to {id} — new session started", { id: selected }));
-        }
-        catch (error) {
-            await this.handleFatalRuntimeError(t("Failed to create session"), error);
-        }
+        return selectorsFlow.showStartupSuiteSelector(this, pending);
     }
     /** /model command entry; implementation in ./interactive-selectors.ts (S5 slice 5). */
     async handleModelCommand(searchTerm) {
@@ -3350,244 +2282,32 @@ export class InteractiveMode {
     async handleCloneCommand() {
         await selectorsFlow.handleCloneCommand(this);
     }
-    /**
-     * Workflow overlay (§9 L2/L3): read-only panorama + transition log from
-     * `workflow.state`/`workflow.transition` entries. Actions are forwarded to
-     * the editor as reviewable text; the main agent executes them via
-     * workflow_advance (rendering and execution stay separated).
-     */
+    /** Workflow overlay; implementation in ./interactive-selectors.ts (拆分 slice 2). */
     showWorkflowView() {
-        const hasSnapshot = this.facade
-            .getEntries()
-            .some((entry) => entry.type === "custom" && entry.customType === "workflow.state");
-        if (!hasSnapshot) {
-            this.showStatus(t("No workflow in this session"));
-            return;
-        }
-        this.showSelector((done) => {
-            const view = new WorkflowViewComponent({
-                getEntries: () => this.facade.getEntries(),
-                maxRows: Math.max(6, Math.floor(this.ui.terminal.rows / 2)),
-                requestRender: () => this.ui.requestRender(),
-            });
-            view.onClose = done;
-            view.onForwardAction = (text) => {
-                done();
-                this.editor.setText(text);
-                this.ui.requestRender();
-                this.showStatus(t("Workflow action staged — review in the editor and submit"));
-            };
-            return { component: view, focus: view, dispose: () => view.dispose() };
-        });
+        selectorsFlow.showWorkflowView(this);
     }
-    /**
-     * Subagent session browser (/agents): read-only list + detail of this
-     * session's subagent transcripts from the D-060 §3 on-disk store — the same
-     * parent-scoped summary source as the subagent_list model tool (only this
-     * session's children, newest first). Detail entries load lazily per
-     * session; a failed load renders inside the view instead of throwing.
-     */
+    /** Subagent session browser; implementation in ./interactive-selectors.ts (拆分 slice 2). */
     showAgentsView() {
-        const agentDir = getAgentDir();
-        const sessions = listAgentSessions({ agentDir, parentAgentSession: this.facade.getSessionId() });
-        if (sessions.length === 0) {
-            this.showStatus(t("No subagent sessions in this session"));
-            return;
-        }
-        this.showSelector((done) => {
-            const view = new AgentsViewComponent({
-                sessions,
-                loadEntries: (sessionId) => readAgentSession({ agentDir, sessionId }),
-                maxRows: Math.max(6, Math.floor(this.ui.terminal.rows / 2)),
-                requestRender: () => this.ui.requestRender(),
-            });
-            view.onClose = done;
-            return { component: view, focus: view };
-        });
+        selectorsFlow.showAgentsView(this);
     }
+    /** Tree selector; implementation in ./interactive-selectors.ts (拆分 slice 2). */
     showTreeSelector(initialSelectedId) {
-        const tree = this.facade.getTree();
-        const realLeafId = this.facade.getLeafId();
-        const initialFilterMode = this.settingsManager.getTreeFilterMode();
-        if (tree.length === 0) {
-            this.showStatus(t("No entries in session"));
-            return;
-        }
-        this.showSelector((done) => {
-            const selector = new TreeSelectorComponent(tree, realLeafId, this.ui.terminal.rows, async (entryId) => {
-                // Selecting the current leaf is a no-op (already there)
-                if (entryId === this.facade.getLeafId()) {
-                    done();
-                    this.showStatus(t("Already at this point"));
-                    return;
-                }
-                // Ask about summarization
-                done(); // Close selector first
-                // Loop until user makes a complete choice or cancels to tree
-                let wantsSummary = false;
-                let customInstructions;
-                // Check if we should skip the prompt (user preference to always default to no summary)
-                if (!this.settingsManager.getBranchSummarySkipPrompt()) {
-                    while (true) {
-                        const summaryChoice = await this.showDialogSelector(t("Summarize branch?"), [
-                            t("No summary"),
-                            t("Summarize"),
-                            t("Summarize with custom prompt"),
-                        ]);
-                        if (summaryChoice === undefined) {
-                            // User pressed escape - re-show tree selector with same selection
-                            this.showTreeSelector(entryId);
-                            return;
-                        }
-                        wantsSummary = summaryChoice !== t("No summary");
-                        if (summaryChoice === t("Summarize with custom prompt")) {
-                            customInstructions = await this.showDialogEditor(t("Custom summarization instructions"));
-                            if (customInstructions === undefined) {
-                                // User cancelled - loop back to summary selector
-                                continue;
-                            }
-                        }
-                        // User made a complete choice
-                        break;
-                    }
-                }
-                // The user committed to navigating: stop the active response first.
-                // 中断分级：导航清场只停回合，不终止后台子代理（设计 §4.2）。
-                if (this.facade.isStreaming()) {
-                    this.restoreQueuedMessagesToEditor();
-                    await this.facade.abort({ cancelAgentTasks: false });
-                }
-                // Set up escape handler and status indicator if summarizing
-                let showingSummaryIndicator = false;
-                const originalOnEscape = this.defaultEditor.onEscape;
-                if (wantsSummary) {
-                    this.defaultEditor.onEscape = () => {
-                        this.facade.abortBranchSummary();
-                    };
-                    this.chatContainer.addChild(new Spacer(1));
-                    this.showStatusIndicator(new BranchSummaryStatusIndicator(this.ui));
-                    showingSummaryIndicator = true;
-                    this.ui.requestRender();
-                }
-                try {
-                    const result = await this.facade.navigateTree(entryId, {
-                        summarize: wantsSummary,
-                        customInstructions,
-                    });
-                    if (result.aborted) {
-                        // Summarization aborted - re-show tree selector with same selection
-                        this.showStatus(t("Branch summarization cancelled"));
-                        this.showTreeSelector(entryId);
-                        return;
-                    }
-                    if (result.cancelled) {
-                        this.showStatus(t("Navigation cancelled"));
-                        return;
-                    }
-                    // Update UI
-                    this.chatContainer.clear();
-                    this.renderInitialMessages();
-                    if (result.editorText && !this.editor.getText().trim()) {
-                        this.editor.setText(result.editorText);
-                    }
-                    this.showStatus(t("Navigated to selected point"));
-                    void this.flushCompactionQueue({ willRetry: false });
-                }
-                catch (error) {
-                    this.showError(error instanceof Error ? error.message : String(error));
-                }
-                finally {
-                    if (showingSummaryIndicator) {
-                        this.clearStatusIndicator("branchSummary");
-                    }
-                    this.defaultEditor.onEscape = originalOnEscape;
-                }
-            }, () => {
-                done();
-                this.ui.requestRender();
-            }, (entryId, label) => {
-                this.facade.appendLabelChange(entryId, label);
-                this.ui.requestRender();
-            }, initialSelectedId, initialFilterMode);
-            selector.onCopy = async (text) => {
-                if (!text) {
-                    this.showError(t("Selected entry has no text to copy"));
-                    return;
-                }
-                try {
-                    await copyToClipboard(text);
-                    this.showStatus(t("Copied selected message to clipboard"));
-                }
-                catch (error) {
-                    this.showError(error instanceof Error ? error.message : String(error));
-                }
-            };
-            return { component: selector, focus: selector };
-        });
+        selectorsFlow.showTreeSelector(this, initialSelectedId);
     }
+    /** Session selector; implementation in ./interactive-selectors.ts (拆分 slice 2). */
     showSessionSelector() {
-        this.showSelector((done) => {
-            const selector = new SessionSelectorComponent((onProgress, signal) => this.runtimeFacade.listSessions(onProgress, signal), (onProgress, signal) => this.runtimeFacade.listAllSessions(onProgress, signal), async (sessionPath) => {
-                done();
-                await this.handleResumeSession(sessionPath);
-            }, () => {
-                done();
-                this.ui.requestRender();
-            }, () => {
-                void this.shutdown();
-            }, () => this.ui.requestRender(), {
-                renameSession: async (sessionFilePath, nextName) => {
-                    const next = (nextName ?? "").trim();
-                    if (!next)
-                        return;
-                    const mgr = SessionManager.open(sessionFilePath);
-                    mgr.appendSessionInfo(next);
-                },
-                showRenameHint: true,
-                keybindings: this.keybindings,
-                // 会话选择器默认只列当前方案的会话；跨方案会话仅在显式
-                // "show all" 后可见（设计 §10.1）。
-                suiteFilter: {
-                    currentSuiteId: this.getCurrentSessionSuiteId(),
-                    getSessionSuiteId: (session) => this.readSessionSuiteId(session.path),
-                },
-            }, this.runtimeFacade.getSessionFile());
-            return { component: selector, focus: selector };
-        });
+        selectorsFlow.showSessionSelector(this);
     }
+    /** Queue manager overlay; implementation in ./interactive-selectors.ts (S5 slice 5). Host-visible for ./interactive-queues.ts (拆分 slice 3). */
+    showQueueManagerSelector() {
+        selectorsFlow.showQueueManagerSelector(this);
+    }
+    /**
+     * Session resume; implementation in ./interactive-selectors.ts (拆分 slice
+     * 2). Kept as a delegate for the prototype-level test bindings.
+     */
     async handleResumeSession(sessionPath, options) {
-        this.clearStatusIndicator();
-        try {
-            const result = await this.runtimeFacade.switchSession(sessionPath, {
-                withSession: options?.withSession,
-            });
-            if (result.cancelled) {
-                return result;
-            }
-            this.showStatus(t("Resumed session"));
-            this.detectCrossSuiteResume();
-            return result;
-        }
-        catch (error) {
-            if (error instanceof MissingSessionCwdError) {
-                const selectedCwd = await this.promptForMissingSessionCwd(error);
-                if (!selectedCwd) {
-                    this.showStatus(t("Resume cancelled"));
-                    return { cancelled: true };
-                }
-                const result = await this.runtimeFacade.switchSession(sessionPath, {
-                    cwdOverride: selectedCwd,
-                    withSession: options?.withSession,
-                });
-                if (result.cancelled) {
-                    return result;
-                }
-                this.showStatus(t("Resumed session in current cwd"));
-                this.detectCrossSuiteResume();
-                return result;
-            }
-            return this.handleFatalRuntimeError(t("Failed to resume session"), error);
-        }
+        return selectorsFlow.handleResumeSession(this, sessionPath, options);
     }
     /**
      * Cross-suite resume detection (设计 §10.1 最小可用版): compare the loaded
@@ -3597,6 +2317,9 @@ export class InteractiveMode {
      * behavior). On a mismatch, record the fact for later debugging: an info
      * status line plus a `suite_mismatch` custom entry on the session. No
      * context serialization or conversion is attempted.
+     *
+     * Host-visible for ./interactive-selectors.ts (拆分 slice 2): also called
+     * from the startup/resume path on the mode, so it stays here.
      */
     detectCrossSuiteResume() {
         const originalSuiteId = this.getCurrentSessionSuiteId();
@@ -3730,637 +2453,88 @@ export class InteractiveMode {
     // Command handlers
     // =========================================================================
     async handleReloadCommand() {
-        if (this.facade.isStreaming()) {
-            this.showWarning(t("Wait for the current response to finish before reloading."));
-            return;
-        }
-        if (this.facade.isCompacting()) {
-            this.showWarning(t("Wait for compaction to finish before reloading."));
-            return;
-        }
-        this.resetDialogUI();
-        const reloadBox = new Container();
-        const borderColor = (s) => theme.fg("border", s);
-        reloadBox.addChild(new DynamicBorder(borderColor));
-        reloadBox.addChild(new Spacer(1));
-        reloadBox.addChild(new Text(theme.fg("muted", t("Reloading keybindings, skills, prompts, themes, and context files...")), 1, 0));
-        reloadBox.addChild(new Spacer(1));
-        reloadBox.addChild(new DynamicBorder(borderColor));
-        const previousEditor = this.editor;
-        this.editorContainer.clear();
-        this.editorContainer.addChild(reloadBox);
-        this.ui.setFocus(reloadBox);
-        this.ui.requestRender(true);
-        await new Promise((resolve) => process.nextTick(resolve));
-        const dismissReloadBox = (editor) => {
-            this.editorContainer.clear();
-            this.editorContainer.addChild(editor);
-            this.ui.setFocus(editor);
-            this.ui.requestRender();
-        };
-        let chatRestoredBeforeSessionStart = false;
-        let reloadBoxDismissed = false;
-        const restoreChatBeforeSessionStart = () => {
-            if (chatRestoredBeforeSessionStart) {
-                return;
-            }
-            this.hideThinkingBlock = this.settingsManager.getHideThinkingBlock();
-            this.outputPad = this.settingsManager.getOutputPad();
-            this.rebuildChatFromMessages();
-            chatRestoredBeforeSessionStart = true;
-        };
-        try {
-            await this.facade.reload({ beforeSessionStart: restoreChatBeforeSessionStart });
-            restoreChatBeforeSessionStart();
-            this.keybindings.reload();
-            const activeHeader = this.builtInHeader;
-            if (isExpandable(activeHeader)) {
-                activeHeader.setExpanded(this.toolOutputExpanded);
-            }
-            setRegisteredThemes(buildRegisteredThemes(this.facade.getThemes().themes));
-            this.applyRuntimeSettings();
-            await this.themeController.applyFromSettings();
-            this.setupAutocompleteProvider();
-            this.showLoadedResources({
-                force: false,
-                showDiagnosticsWhenQuiet: true,
-            });
-            const modelsJsonError = this.facade.getModelsError();
-            if (modelsJsonError) {
-                this.showError(t("models.json error: {error}", { error: modelsJsonError }));
-            }
-            this.showStatus(t("Reloaded keybindings, skills, prompts, themes, and context files"));
-            dismissReloadBox(this.editor);
-            reloadBoxDismissed = true;
-        }
-        catch (error) {
-            // v8 ignore next -- reloadBoxDismissed 置位后 catch 前无可抛出点，恒走 dismiss 分支
-            if (!reloadBoxDismissed) {
-                dismissReloadBox(previousEditor);
-            }
-            this.showError(t("Reload failed: {error}", { error: error instanceof Error ? error.message : String(error) }));
-        }
+        return handleReloadCommand(this);
     }
     async handleExportCommand(text) {
-        const outputPath = this.getPathCommandArgument(text, "/export");
-        try {
-            if (outputPath?.endsWith(".jsonl")) {
-                const filePath = this.facade.exportToJsonl(outputPath);
-                this.showStatus(t("Session exported to: {path}", { path: filePath }));
-            }
-            else {
-                const filePath = await this.facade.exportToHtml(outputPath, {
-                    themeName: theme.name,
-                });
-                this.showStatus(t("Session exported to: {path}", { path: filePath }));
-            }
-        }
-        catch (error) {
-            this.showError(t("Failed to export session: {error}", {
-                error: error instanceof Error ? error.message : t("Unknown error"),
-            }));
-        }
+        return handleExportCommand(this, text);
     }
+    // biome-ignore lint/correctness/noUnusedPrivateClassMembers: prototype-level test bindings call this delegate; implementation in ./interactive-commands.ts
     getPathCommandArgument(text, command) {
-        if (text === command) {
-            return undefined;
-        }
-        if (!text.startsWith(`${command} `)) {
-            return undefined;
-        }
-        const argsString = text.slice(command.length + 1).trimStart();
-        if (!argsString) {
-            return undefined;
-        }
-        const firstChar = argsString[0];
-        if (firstChar === '"' || firstChar === "'") {
-            const closingQuoteIndex = argsString.indexOf(firstChar, 1);
-            if (closingQuoteIndex < 0) {
-                return undefined;
-            }
-            return argsString.slice(1, closingQuoteIndex);
-        }
-        const firstWhitespaceIndex = argsString.search(/\s/);
-        if (firstWhitespaceIndex < 0) {
-            return argsString;
-        }
-        return argsString.slice(0, firstWhitespaceIndex);
+        return getPathCommandArgument(text, command);
     }
     async handleImportCommand(text) {
-        const inputPath = this.getPathCommandArgument(text, "/import");
-        if (!inputPath) {
-            this.showError(t("Usage: /import <path.jsonl>"));
-            return;
-        }
-        const confirmed = await this.showDialogConfirm(t("Import session"), t("Replace current session with {path}?", { path: inputPath }));
-        if (!confirmed) {
-            this.showStatus(t("Import cancelled"));
-            return;
-        }
-        try {
-            this.clearStatusIndicator();
-            const result = await this.runtimeFacade.importFromJsonl(inputPath);
-            if (result.cancelled) {
-                this.showStatus(t("Import cancelled"));
-                return;
-            }
-            this.showStatus(t("Session imported from: {path}", { path: inputPath }));
-        }
-        catch (error) {
-            if (error instanceof MissingSessionCwdError) {
-                const selectedCwd = await this.promptForMissingSessionCwd(error);
-                if (!selectedCwd) {
-                    this.showStatus(t("Import cancelled"));
-                    return;
-                }
-                const result = await this.runtimeFacade.importFromJsonl(inputPath, selectedCwd);
-                if (result.cancelled) {
-                    this.showStatus(t("Import cancelled"));
-                    return;
-                }
-                this.showStatus(t("Session imported from: {path}", { path: inputPath }));
-                return;
-            }
-            if (error instanceof SessionImportFileNotFoundError) {
-                this.showError(t("Failed to import session: {error}", { error: error.message }));
-                return;
-            }
-            await this.handleFatalRuntimeError(t("Failed to import session"), error);
-        }
+        return handleImportCommand(this, text);
     }
     async handleCopyCommand(options = {}) {
-        if (options.preferSelection &&
-            this.ui instanceof TuiAltScreen &&
-            !this.ui.getCopyOnSelect() &&
-            this.ui.hasActiveSelection()) {
-            await this.ui.copyActiveSelectionToClipboard();
-            return;
-        }
-        const text = this.facade.getLastAssistantText();
-        if (!text) {
-            this.showError(t("No agent messages to copy yet."));
-            return;
-        }
-        try {
-            await copyToClipboard(text);
-            if (options.flashConfirmation && this.ui instanceof TuiAltScreen) {
-                this.ui.flash(t("Copied!"));
-            }
-            else {
-                this.showStatus(t("Copied last agent message to clipboard"));
-            }
-        }
-        catch (error) {
-            this.showError(error instanceof Error ? error.message : String(error));
-        }
+        return handleCopyCommand(this, options);
     }
     handleNameCommand(text) {
-        const name = text.replace(/^\/name\s*/, "").trim();
-        if (!name) {
-            const currentName = this.facade.getSessionName();
-            if (currentName) {
-                this.chatContainer.addChild(new Spacer(1));
-                this.chatContainer.addChild(new Text(theme.fg("dim", t("Session name: {name}", { name: currentName })), 1, 0));
-            }
-            else {
-                this.showWarning(t("Usage: /name <name>"));
-            }
-            this.ui.requestRender();
-            return;
-        }
-        this.facade.setSessionName(name);
-        const sessionName = this.facade.getSessionName();
-        if (sessionName !== name) {
-            this.showWarning(t("Session name was normalized from {from} to {to}", {
-                from: JSON.stringify(name),
-                to: JSON.stringify(sessionName),
-            }));
-        }
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Text(theme.fg("dim", t("Session name set: {name}", { name: sessionName ?? name })), 1, 0));
-        this.ui.requestRender();
+        handleNameCommand(this, text);
     }
     /**
      * 中断分级（设计 子代理运行时 §4.2，2026-10-02）：/stop-agents 的唯一执行
      * 面——终止全部后台子代理（不触当前回合）。Esc 从不做这件事。
      */
     handleStopAgentsCommand() {
-        const active = this.facade.getActiveAgentTaskCount();
-        if (active === 0) {
-            this.showStatus(t("No background subagents running"));
-            return;
-        }
-        this.facade.abortAgentTasks();
-        this.showStatus(active === 1
-            ? t("Terminated {count} background subagent", { count: active })
-            : t("Terminated {count} background subagents", { count: active }));
+        handleStopAgentsCommand(this);
     }
     handleSessionCommand() {
-        const stats = this.facade.getSessionStats();
-        const sessionName = this.facade.getSessionName();
-        const entries = this.facade.getEntries();
-        const cacheWaste = computeCacheWaste(entries, this.facade.getModelPriceSource());
-        // Cost/token totals per provider/model actually used (e.g. OpenRouter `auto`
-        // resolves to a concrete responseModel). Usage without model attribution is
-        // grouped separately so the breakdown reconciles with the session total.
-        const usageBreakdown = getUsageCostBreakdown(entries);
-        let info = `${theme.bold(t("Session Info"))}\n\n`;
-        if (sessionName) {
-            info += `${theme.fg("dim", t("Name:"))} ${sessionName}\n`;
-        }
-        info += `${theme.fg("dim", t("File:"))} ${stats.sessionFile ?? t("In-memory")}\n`;
-        info += `${theme.fg("dim", t("ID:"))} ${stats.sessionId}\n\n`;
-        info += `${theme.bold(t("Messages"))}\n`;
-        info += `${theme.fg("dim", t("Total:"))} ${stats.totalMessages}\n`;
-        info += `${theme.fg("dim", t("User:"))} ${stats.userMessages}\n`;
-        info += `${theme.fg("dim", t("Assistant:"))} ${stats.assistantMessages}\n`;
-        info += `${theme.fg("dim", t("Tools:"))} ${t("{calls} calls, {results} results", {
-            calls: stats.toolCalls,
-            results: stats.toolResults,
-        })}\n\n`;
-        info += `${theme.bold(t("Tokens"))}\n`;
-        // "Input" is the full prompt volume. With cache activity, split it into
-        // cached (served from cache) vs uncached (everything else) - the only
-        // provider-independent split. Cache writes, where reported, are a detail
-        // of the uncached portion.
-        const { input, cacheRead, cacheWrite } = stats.tokens;
-        const promptTokens = input + cacheRead + cacheWrite;
-        info += `${theme.fg("dim", t("Input:"))} ${promptTokens.toLocaleString()}\n`;
-        if (promptTokens > 0 && (cacheRead > 0 || cacheWrite > 0)) {
-            const hitRate = theme.fg("dim", `(${((cacheRead / promptTokens) * 100).toFixed(1)}%)`);
-            info += `  ${theme.fg("dim", t("Cached:"))} ${cacheRead.toLocaleString()} ${hitRate}\n`;
-            const written = cacheWrite > 0
-                ? ` ${theme.fg("dim", t("({count} written to cache)", { count: cacheWrite.toLocaleString() }))}`
-                : "";
-            info += `  ${theme.fg("dim", t("Uncached:"))} ${(input + cacheWrite).toLocaleString()}${written}\n`;
-        }
-        info += `${theme.fg("dim", t("Output:"))} ${stats.tokens.output.toLocaleString()}\n`;
-        info += `${theme.fg("dim", t("Total:"))} ${stats.tokens.total.toLocaleString()}\n`;
-        // 双维度统计（用户裁决 2026-09-25）：总计之外按供应商/模型分桶——缓存读/写、
-        // 命中率、费用逐桶可见。此前该拆分门控在 cost>0 且多桶才渲染，单价为 0 的
-        // 自定义供应商（如自建代理）永远看不到。
-        if (usageBreakdown.length > 0) {
-            info += `\n${theme.bold(t("By Provider/Model"))}\n`;
-            for (const entry of usageBreakdown) {
-                const bucket = entry.totals;
-                const promptBucket = bucket.input + bucket.cacheRead + bucket.cacheWrite;
-                let line = `  ${theme.bold(entry.key)}`;
-                if (promptBucket > 0) {
-                    line += `\n    ${theme.fg("dim", t("Input:"))} ${promptBucket.toLocaleString()}`;
-                    if (bucket.cacheRead > 0 || bucket.cacheWrite > 0) {
-                        const rate = promptBucket > 0 ? ((bucket.cacheRead / promptBucket) * 100).toFixed(1) : "0.0";
-                        line += ` ${theme.fg("dim", t("(cache {rate}%, W {written})", { rate, written: bucket.cacheWrite.toLocaleString() }))}`;
-                    }
-                }
-                if (bucket.output > 0)
-                    line += `\n    ${theme.fg("dim", t("Output:"))} ${bucket.output.toLocaleString()}`;
-                if (entry.cost > 0)
-                    line += ` ${theme.fg("dim", `$${entry.cost.toFixed(3)}`)}`;
-                info += `${line}\n`;
-            }
-        }
-        if (stats.cost > 0 || cacheWaste.missedTokens > 0) {
-            info += `\n${theme.bold(t("Cost"))}\n`;
-            info += `${theme.fg("dim", t("Total:"))} $${stats.cost.toFixed(3)}`;
-            if (usageBreakdown.length > 1) {
-                for (const entry of usageBreakdown) {
-                    info += `\n  ${theme.fg("dim", `${entry.key}:`)} $${entry.cost.toFixed(3)} ${theme.fg("dim", t("({tokens} tokens)", { tokens: formatTokens(entry.tokens) }))}`;
-                }
-            }
-            if (cacheWaste.missedTokens > 0) {
-                const missLabel = cacheWaste.missCount === 1
-                    ? t("{count} miss", { count: cacheWaste.missCount })
-                    : t("{count} misses", { count: cacheWaste.missCount });
-                const detail = t("{tokens} tokens, {misses}", {
-                    tokens: cacheWaste.missedTokens.toLocaleString(),
-                    misses: missLabel,
-                });
-                info +=
-                    cacheWaste.missedCost >= 0.0001
-                        ? `\n${theme.fg("dim", t("Cache Re-billed:"))} $${cacheWaste.missedCost.toFixed(3)} ${theme.fg("dim", `(${detail})`)}`
-                        : `\n${theme.fg("dim", t("Cache Re-billed:"))} ${detail}`;
-            }
-        }
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Text(info, 1, 0));
-        this.ui.requestRender();
+        handleSessionCommand(this);
     }
     handleMetricsCommand(turnsArg) {
-        const provider = this.options.getMetrics;
-        if (!provider) {
-            this.showWarning(t("Metrics are not available: the observability plugin is not mounted in this session"));
-            return;
-        }
-        let windowTurns;
-        if (turnsArg !== undefined) {
-            const parsed = Number.parseInt(turnsArg, 10);
-            if (!Number.isSafeInteger(parsed) || parsed < 1) {
-                this.showWarning(t("Invalid turns: {turns}. Usage: /metrics [turns]", { turns: turnsArg }));
-                return;
-            }
-            windowTurns = parsed;
-        }
-        let snapshot;
-        try {
-            const result = provider({ windowTurns });
-            if (result === undefined) {
-                this.showWarning(t("Metrics are not available: the observability plugin is not mounted in this session"));
-                return;
-            }
-            snapshot = result;
-        }
-        catch (error) {
-            this.showError(error instanceof Error ? error.message : String(error));
-            return;
-        }
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Text(formatMetricsSnapshot(snapshot), 1, 0));
-        this.ui.requestRender();
+        handleMetricsCommand(this, turnsArg);
     }
     handleChangelogCommand() {
-        const changelogPath = getChangelogPath();
-        const allEntries = parseChangelog(changelogPath);
-        const changelogMarkdown = allEntries.length > 0
-            ? allEntries
-                .reverse()
-                .map((e) => normalizeChangelogLinks(e.content, e))
-                .join("\n\n")
-            : t("No changelog entries found.");
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new DynamicBorder());
-        this.chatContainer.addChild(new Text(theme.bold(theme.fg("accent", t("What's New"))), 1, 0));
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Markdown(changelogMarkdown, 1, 1, this.getMarkdownThemeWithSettings()));
-        this.chatContainer.addChild(new DynamicBorder());
-        this.ui.requestRender();
+        handleChangelogCommand(this);
     }
     /**
      * Get capitalized display string for an app keybinding action.
+     *
+     * Host-visible for ./interactive-queues.ts (拆分 slice 3): the dequeue hint
+     * in the pending-messages display.
      */
     getAppKeyDisplay(action) {
-        return keyDisplayText(action);
+        return getAppKeyDisplay(action);
     }
     /**
      * Get capitalized display string for an editor keybinding action.
      */
+    // biome-ignore lint/correctness/noUnusedPrivateClassMembers: thin delegate kept per 拆分计划 rule 2; implementation in ./interactive-commands.ts
     getEditorKeyDisplay(action) {
-        return keyDisplayText(action);
+        return getEditorKeyDisplay(action);
     }
     handleHelpCommand() {
-        const section = (title, rows) => {
-            if (rows.length === 0)
-                return "";
-            let table = `\n**${title}**\n| ${t("Command")} | ${t("Description")} |\n|---------|-------------|\n`;
-            for (const row of rows) {
-                const command = row.hint ? `\`/${row.name} ${row.hint}\`` : `\`/${row.name}\``;
-                table += `| ${command} | ${row.description ?? ""} |\n`;
-            }
-            return table;
-        };
-        const builtinRows = BUILTIN_SLASH_COMMANDS.map((command) => ({
-            name: command.name,
-            hint: command.argumentHint,
-            description: command.description,
-        }));
-        const promptRows = this.facade.getPromptTemplates().map((template) => ({
-            name: template.name,
-            hint: template.argumentHint,
-            description: template.description,
-        }));
-        const skillRows = this.facade.getSkills().skills.map((skill) => ({
-            name: `skill:${skill.name}`,
-            description: skill.description,
-        }));
-        const help = section(t("Built-in commands"), builtinRows) +
-            section(t("Prompt templates"), promptRows) +
-            section(t("Skills"), skillRows) +
-            `\n${t("Type `/` for autocomplete. Use `/hotkeys` for keyboard shortcuts.")}`;
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new DynamicBorder());
-        this.chatContainer.addChild(new Text(theme.bold(theme.fg("accent", t("Available Commands"))), 1, 0));
-        this.chatContainer.addChild(new Markdown(help.trim(), 1, 1, this.getMarkdownThemeWithSettings()));
-        this.chatContainer.addChild(new DynamicBorder());
-        this.ui.requestRender();
+        handleHelpCommand(this);
     }
     handleHotkeysCommand() {
-        // Navigation keybindings
-        const cursorUp = this.getEditorKeyDisplay("tui.editor.cursorUp");
-        const cursorDown = this.getEditorKeyDisplay("tui.editor.cursorDown");
-        const cursorLeft = this.getEditorKeyDisplay("tui.editor.cursorLeft");
-        const cursorRight = this.getEditorKeyDisplay("tui.editor.cursorRight");
-        const cursorWordLeft = this.getEditorKeyDisplay("tui.editor.cursorWordLeft");
-        const cursorWordRight = this.getEditorKeyDisplay("tui.editor.cursorWordRight");
-        const cursorLineStart = this.getEditorKeyDisplay("tui.editor.cursorLineStart");
-        const cursorLineEnd = this.getEditorKeyDisplay("tui.editor.cursorLineEnd");
-        const jumpForward = this.getEditorKeyDisplay("tui.editor.jumpForward");
-        const jumpBackward = this.getEditorKeyDisplay("tui.editor.jumpBackward");
-        const pageUp = this.getEditorKeyDisplay("tui.editor.pageUp");
-        const pageDown = this.getEditorKeyDisplay("tui.editor.pageDown");
-        // Editing keybindings
-        const submit = this.getEditorKeyDisplay("tui.input.submit");
-        const newLine = this.getEditorKeyDisplay("tui.input.newLine");
-        const deleteWordBackward = this.getEditorKeyDisplay("tui.editor.deleteWordBackward");
-        const deleteWordForward = this.getEditorKeyDisplay("tui.editor.deleteWordForward");
-        const deleteToLineStart = this.getEditorKeyDisplay("tui.editor.deleteToLineStart");
-        const deleteToLineEnd = this.getEditorKeyDisplay("tui.editor.deleteToLineEnd");
-        const yank = this.getEditorKeyDisplay("tui.editor.yank");
-        const yankPop = this.getEditorKeyDisplay("tui.editor.yankPop");
-        const undo = this.getEditorKeyDisplay("tui.editor.undo");
-        const tab = this.getEditorKeyDisplay("tui.input.tab");
-        // App keybindings
-        const interrupt = this.getAppKeyDisplay("app.interrupt");
-        const clear = this.getAppKeyDisplay("app.clear");
-        const exit = this.getAppKeyDisplay("app.exit");
-        const suspend = this.getAppKeyDisplay("app.suspend");
-        const cycleThinkingLevel = this.getAppKeyDisplay("app.thinking.cycle");
-        const cycleModelForward = this.getAppKeyDisplay("app.model.cycleForward");
-        const selectModel = this.getAppKeyDisplay("app.model.select");
-        const expandTools = this.getAppKeyDisplay("app.tools.expand");
-        const toggleThinking = this.getAppKeyDisplay("app.thinking.toggle");
-        const externalEditor = this.getAppKeyDisplay("app.editor.external");
-        const cycleModelBackward = this.getAppKeyDisplay("app.model.cycleBackward");
-        const copyMessage = this.getAppKeyDisplay("app.message.copy");
-        const followUp = this.getAppKeyDisplay("app.message.followUp");
-        const dequeue = this.getAppKeyDisplay("app.message.dequeue");
-        const pasteImage = this.getAppKeyDisplay("app.clipboard.pasteImage");
-        // Iron law (2026-10-01): these shipped defaults were cleared in favor of
-        // the /model command; the row only appears when a user re-configures a key.
-        const selectModelRow = selectModel ? `| \`${selectModel}\` | ${t("Open model selector")} |\n` : "";
-        // Iron law (2026-10-02 复审): ctrl+g/ctrl+x stay bound only for the
-        // components without a command channel — the main editor ignores them
-        // (/editor and /copy are its single entries), so the rows say where
-        // each key actually acts.
-        const copyMessageRow = copyMessage ? `| \`${copyMessage}\` | ${t("Copy selection in /tree")} |\n` : "";
-        const externalEditorRow = externalEditor
-            ? `| \`${externalEditor}\` | ${t("External editor (inside dialog inputs)")} |\n`
-            : "";
-        // Iron law (2026-10-01): the message queue is the /queue and /dequeue
-        // commands' feature; rows only appear when a user re-configures a key.
-        const followUpRow = followUp ? `| \`${followUp}\` | ${t("Queue follow-up message")} |\n` : "";
-        const dequeueRow = dequeue ? `| \`${dequeue}\` | ${t("Restore queued messages")} |\n` : "";
-        const cycleThinkingRow = cycleThinkingLevel
-            ? `| \`${cycleThinkingLevel}\` | ${t("Cycle thinking level")} |\n`
-            : "";
-        const cycleModelsRow = cycleModelForward || cycleModelBackward
-            ? `| \`${cycleModelForward}\` / \`${cycleModelBackward}\` | ${t("Cycle models")} |\n`
-            : "";
-        // Suspend has no default key on native Windows; hide the row there.
-        const suspendRow = suspend ? `| \`${suspend}\` | ${t("Suspend to background")} |\n` : "";
-        const hotkeys = `
-**${t("Navigation")}**
-| ${t("Key")} | ${t("Action")} |
-|-----|--------|
-| \`${cursorUp}\` / \`${cursorDown}\` / \`${cursorLeft}\` / \`${cursorRight}\` | ${t("Move cursor / browse history")} |
-| \`${cursorWordLeft}\` / \`${cursorWordRight}\` | ${t("Move by word")} |
-| \`${cursorLineStart}\` | ${t("Start of line")} |
-| \`${cursorLineEnd}\` | ${t("End of line")} |
-| \`${jumpForward}\` | ${t("Jump forward to character")} |
-| \`${jumpBackward}\` | ${t("Jump backward to character")} |
-| \`${pageUp}\` / \`${pageDown}\` | ${t("Scroll by page")} |
-
-**${t("Editing")}**
-| ${t("Key")} | ${t("Action")} |
-|-----|--------|
-| \`${submit}\` | ${t("Send message")} |
-| \`${newLine}\` | ${process.platform === "win32" ? t("New line (Ctrl+Enter on Windows Terminal)") : t("New line")} |
-| \`${deleteWordBackward}\` | ${t("Delete word backwards")} |
-| \`${deleteWordForward}\` | ${t("Delete word forwards")} |
-| \`${deleteToLineStart}\` | ${t("Delete to start of line")} |
-| \`${deleteToLineEnd}\` | ${t("Delete to end of line")} |
-| \`${yank}\` | ${t("Paste the most-recently-deleted text")} |
-| \`${yankPop}\` | ${t("Cycle through the deleted text after pasting")} |
-| \`${undo}\` | ${t("Undo")} |
-
-**${t("Other")}**
-| ${t("Key")} | ${t("Action")} |
-|-----|--------|
-| \`${tab}\` | ${t("Path completion / accept autocomplete")} |
-| \`${interrupt}\` | ${t("Cancel autocomplete / abort streaming")} |
-| \`${clear}\` | ${t("Clear editor (first) / exit (second)")} |
-| \`${exit}\` | ${t("Exit (when editor is empty)")} |
-${suspendRow}${cycleThinkingRow}${cycleModelsRow}${selectModelRow}| \`${expandTools}\` | ${t("Toggle tool output expansion")} |
-| \`${toggleThinking}\` | ${t("Toggle thinking block visibility")} |
-${externalEditorRow}${copyMessageRow}${followUpRow}${dequeueRow}
-| \`${pasteImage}\` | ${t("Paste image or text from clipboard")} |
-| \`/\` | ${t("Slash commands")} |
-| \`!\` | ${t("Run bash command")} |
-| \`!!\` | ${t("Run bash command (excluded from context)")} |
-`;
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new DynamicBorder());
-        this.chatContainer.addChild(new Text(theme.bold(theme.fg("accent", t("Keyboard Shortcuts"))), 1, 0));
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Markdown(hotkeys.trim(), 1, 1, this.getMarkdownThemeWithSettings()));
-        this.chatContainer.addChild(new DynamicBorder());
-        this.ui.requestRender();
+        handleHotkeysCommand(this);
     }
     async handleClearCommand() {
-        this.clearStatusIndicator();
-        try {
-            const result = await this.runtimeFacade.newSession();
-            if (result.cancelled) {
-                return;
-            }
-            this.chatContainer.addChild(new Spacer(1));
-            this.chatContainer.addChild(new Text(`${theme.fg("accent", t("✓ New session started"))}`, 1, 1));
-            this.ui.requestRender();
-        }
-        catch (error) {
-            await this.handleFatalRuntimeError("Failed to create session", error);
-        }
+        return handleClearCommand(this);
     }
     handleDebugCommand() {
-        const width = this.ui.terminal.columns;
-        const height = this.ui.terminal.rows;
-        const allLines = this.ui.render(width);
-        const debugLogPath = getDebugLogPath();
-        const debugData = [
-            t("Debug output at {date}", { date: new Date().toISOString() }),
-            t("Terminal: {columns}x{rows}", { columns: width, rows: height }),
-            t("Total lines: {count}", { count: allLines.length }),
-            "",
-            t("=== All rendered lines with visible widths ==="),
-            ...allLines.map((line, idx) => {
-                const vw = visibleWidth(line);
-                const escaped = JSON.stringify(line);
-                return `[${idx}] (w=${vw}) ${escaped}`;
-            }),
-            "",
-            t("=== Agent messages (JSONL) ==="),
-            ...this.facade
-                .getSessionAPI()
-                .getMessages()
-                .map((msg) => JSON.stringify(msg)),
-            "",
-        ].join("\n");
-        fs.mkdirSync(path.dirname(debugLogPath), { recursive: true });
-        fs.writeFileSync(debugLogPath, debugData);
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new Text(`${theme.fg("accent", t("✓ Debug log written"))}\n${theme.fg("muted", debugLogPath)}`, 1, 1));
-        this.ui.requestRender();
+        handleDebugCommand(this);
     }
     handleArminSaysHi() {
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new ArminComponent(this.ui));
-        this.ui.requestRender();
+        handleArminSaysHi(this);
     }
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
     handleDaxnuts() {
-        this.chatContainer.addChild(new Spacer(1));
-        this.chatContainer.addChild(new DaxnutsComponent(this.ui));
-        this.ui.requestRender();
+        handleDaxnuts(this);
     }
     /** Host-visible for ./interactive-auth.ts (S5 slice 3). */
     checkDaxnutsEasterEgg(model) {
-        if (model.provider === "opencode" && model.id.toLowerCase().includes("kimi-k2.5")) {
-            this.handleDaxnuts();
-        }
+        checkDaxnutsEasterEgg(this, model);
     }
     async handleBashCommand(command, excludeFromContext = false) {
-        // Dispatch the user.bash lifecycle facts, then execute locally.
-        this.facade.emitUserBash(excludeFromContext);
-        // Normal execution path
-        const isDeferred = this.facade.isStreaming();
-        this.bashComponent = new BashExecutionComponent(command, this.ui, excludeFromContext);
-        if (isDeferred) {
-            // Show in pending area when agent is streaming
-            this.pendingMessagesContainer.addChild(this.bashComponent);
-            this.pendingBashComponents.push(this.bashComponent);
-        }
-        else {
-            // Show in chat immediately when agent is idle
-            this.chatContainer.addChild(this.bashComponent);
-        }
-        this.ui.requestRender();
-        try {
-            const result = await this.facade.executeBash(command, (chunk) => {
-                if (this.bashComponent) {
-                    this.bashComponent.appendOutput(chunk);
-                    this.ui.requestRender();
-                }
-            }, { excludeFromContext });
-            if (this.bashComponent) {
-                this.bashComponent.setComplete(result.exitCode, result.cancelled, result.truncated ? { truncated: true, content: result.output } : undefined, result.fullOutputPath);
-            }
-        }
-        catch (error) {
-            if (this.bashComponent) {
-                this.bashComponent.setComplete(undefined, false);
-            }
-            this.showError(t("Bash command failed: {error}", {
-                error: error instanceof Error ? error.message : t("Unknown error"),
-            }));
-        }
-        this.bashComponent = undefined;
-        this.ui.requestRender();
+        await handleBashCommand(this, command, excludeFromContext);
     }
     async handleCompactCommand(customInstructions) {
-        this.clearStatusIndicator();
-        try {
-            await this.facade.compact(customInstructions);
-        }
-        catch {
-            // Ignore, will be emitted as an event
-        }
+        return handleCompactCommand(this, customInstructions);
+    }
+    /** /clean-sessions：会话清理两阶段流程；输出/确认走宿主既有机制（设计 §7）。 */
+    async handleCleanSessionsCommand(arg) {
+        return handleCleanSessionsCommand(this, arg);
     }
     stop(fullscreenExitOutput = this.settingsManager.getFullscreenExitOutput()) {
         this.disposeActiveSelector();