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

package/dist/modes/interactive/interactive-mode.d.ts

@@ -2,23 +2,31 @@
  * Interactive mode for the coding agent.
  * Handles TUI rendering and user interaction, delegating business logic to AgentSession.
  */
-import type { ThinkingLevel } from "@agent-forge/agent-core";
+import type { AgentMessage, ThinkingLevel } from "@agent-forge/agent-core";
 import { type AuthEvent, type AuthPrompt } from "@agent-forge/ai";
-import type { Api, ImageContent, Model } from "@agent-forge/ai/compat";
-import type { AutocompleteProvider, EditorComponent, Terminal, WheelScrollLines } from "@agent-forge/tui";
+import type { Api, AssistantMessage, ImageContent, Message, Model } from "@agent-forge/ai/compat";
+import type { AutocompleteProvider, EditorComponent, MarkdownTheme, Terminal, WheelScrollLines } from "@agent-forge/tui";
 import { type Component, Container, type TUI, TuiAltScreen, TuiMainScreen } from "@agent-forge/tui";
-import { type AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
+import type { AgentSession, AgentSessionEvent } from "../../core/agent-session.ts";
+import type { AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
 import type { AgentSessionRuntimeDiagnostic } from "../../core/agent-session-services.ts";
+import type { CacheMiss } from "../../core/cache-stats.ts";
 import type { InteractionDialogOptions, InteractionHostV1 } from "../../core/extensions/index.ts";
 import type { ModelAuthRuntime } from "../../core/facade/coding-agent-facade.ts";
 import { type CodingAgentFacadeV1, type CodingAgentRuntimeFacadeV1 } from "../../core/facade/index.ts";
 import { FooterDataProvider } from "../../core/footer-data-provider.ts";
-import { KeybindingsManager } from "../../core/keybindings.ts";
-import type { ThemeMetaV1 } from "../../core/resource-loader.ts";
+import { type AppKeybinding, KeybindingsManager } from "../../core/keybindings.ts";
+import { type MissingSessionCwdError } from "../../core/session-cwd.ts";
+import type { SessionEntry } from "../../core/session-manager.ts";
 import type { FullscreenExitOutput, SettingsManager, TuiMode } from "../../core/settings-manager.ts";
 import type { SourceInfo } from "../../core/source-info.ts";
+import type { ModelCatalogRuntime } from "../../host/model-catalog-refresh.ts";
 import type { MetricsSnapshotV1, ObservabilityMetricsOptions } from "../../plugins/observability-types.ts";
-import { type LatestRelease } from "../../utils/version-check.ts";
+import { Theme } from "../../theme/theme.ts";
+import { InteractiveThemeController } from "../../theme/theme-controller.ts";
+import type { LatestRelease } from "../../utils/version-check.ts";
+import { AssistantMessageComponent } from "./components/assistant-message.ts";
+import type { BashExecutionComponent } from "./components/bash-execution.ts";
 import { CustomEditor } from "./components/custom-editor.ts";
 import type { DialogEditorComponent } from "./components/dialog-editor.ts";
 import type { DialogInputComponent } from "./components/dialog-input.ts";
@@ -26,35 +34,26 @@ import type { DialogSelectorComponent } from "./components/dialog-selector.ts";
 import { FooterComponent } from "./components/footer.ts";
 import type { LoginDialogComponent } from "./components/login-dialog.ts";
 import type { AuthSelectorProvider } from "./components/oauth-selector.ts";
-import { type WorkingIndicatorOptions } from "./components/status-indicator.ts";
+import type { MarkdownTransformer } from "./components/render-types.ts";
+import { type StatusIndicator, type WorkingIndicatorOptions } from "./components/status-indicator.ts";
+import type { ToolExecutionComponent } from "./components/tool-execution.ts";
+import type { ToolRunGroupComponent } from "./components/tool-run-group.ts";
 import * as authFlow from "./interactive-auth.ts";
+import { type CommandHandlersHost } from "./interactive-commands.ts";
 import { type DialogUiHost } from "./interactive-dialog-ui.ts";
+import * as eventsFlow from "./interactive-events.ts";
+import * as lifecycleFlow from "./interactive-lifecycle.ts";
+import * as queuesFlow from "./interactive-queues.ts";
 import * as selectorsFlow from "./interactive-selectors.ts";
-import { type ModelCatalogRuntime } from "./model-catalog-refresh.ts";
-import { Theme } from "./theme/theme.ts";
+import { type StartupBackgroundCheckHost } from "./startup-services.ts";
+export { buildRegisteredThemes } from "./interactive-commands.ts";
 export { mapLegacyDialogResultToOutcome } from "./interactive-dialog-ui.ts";
-/**
- * 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 declare function buildRegisteredThemes(themes: readonly ThemeMetaV1[]): Theme[];
 /**
  * Session read view consumed by formatResumeCommand: the subset of
  * session-manager reads the command needs. Satisfied by the runtime facade
  * (structural) and by real SessionManager instances.
  */
-interface ResumeCommandSessionReads {
+export interface ResumeCommandSessionReads {
     isPersisted(): boolean;
     getSessionFile(): string | undefined;
     usesDefaultSessionDir(): boolean;
@@ -143,9 +142,10 @@ export declare class ProviderFailoverTicker {
     refresh(): void;
     dispose(): void;
 }
-export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHost, selectorsFlow.SelectorsHost {
+export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHost, selectorsFlow.SelectorsHost, StartupBackgroundCheckHost, CommandHandlersHost, queuesFlow.QueuesHost, lifecycleFlow.LifecycleHost, eventsFlow.EventsHost {
     private runtimeHost;
-    private renderer;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    renderer: TuiMainScreen | TuiAltScreen;
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
     ui: TUI;
     private mainScreenRenderState;
@@ -155,8 +155,10 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     private documentContainer;
     private transcriptScrollView;
     private fullscreenLayoutRoot;
-    private pendingMessagesContainer;
-    private statusContainer;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    pendingMessagesContainer: Container;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    statusContainer: Container;
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
     defaultEditor: CustomEditor;
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
@@ -176,8 +178,10 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
      * 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.
      */
-    private failoverTicker;
+    failoverTicker: ProviderFailoverTicker | undefined;
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
     footerContainer: Container;
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
@@ -185,18 +189,23 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
     keybindings: KeybindingsManager;
     private version;
-    private isInitialized;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    isInitialized: boolean;
     private onInputCallback?;
     private pendingUserInputs;
-    private activeStatusIndicator;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    activeStatusIndicator: StatusIndicator | undefined;
     private readonly idleStatus;
     private workingMessage;
-    private workingVisible;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    workingVisible: boolean;
     private workingIndicatorOptions;
     private readonly defaultWorkingMessage;
     private readonly defaultHiddenThinkingLabel;
-    private hiddenThinkingLabel;
-    private lastSigintTime;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    hiddenThinkingLabel: string;
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): double-Ctrl+C exit window. */
+    lastSigintTime: number;
     private lastEscapeTime;
     private changelogMarkdown;
     private startupNoticesShown;
@@ -204,24 +213,41 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     private lastStatusSpacer;
     private lastStatusText;
     private managedToolStatusStarted;
-    private streamingComponent;
-    private streamingMessage;
-    private pendingTools;
-    private activeToolRunGroup;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    streamingComponent: AssistantMessageComponent | undefined;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    streamingMessage: AssistantMessage | undefined;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    pendingTools: Map<string, ToolExecutionComponent>;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    activeToolRunGroup: ToolRunGroupComponent | undefined;
     /** Host-visible for ./interactive-dialog-ui.ts (S5 slice 2). */
     toolOutputExpanded: boolean;
-    private hideThinkingBlock;
-    private outputPad;
-    private readonly mermaidMarkdownTransformer;
-    private unsubscribe?;
-    private signalCleanupHandlers;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    hideThinkingBlock: boolean;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    outputPad: number;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    readonly mermaidMarkdownTransformer: MarkdownTransformer;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    unsubscribe?: () => void;
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4). */
+    signalCleanupHandlers: Array<() => void>;
     private isBashMode;
-    private bashComponent;
-    private pendingBashComponents;
-    private autoCompactionEscapeHandler?;
-    private retryEscapeHandler?;
-    private compactionQueuedMessages;
-    private shutdownRequested;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    bashComponent: BashExecutionComponent | undefined;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    pendingBashComponents: BashExecutionComponent[];
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    autoCompactionEscapeHandler?: () => void;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    retryEscapeHandler?: () => void;
+    /** Host-visible for ./interactive-queues.ts (拆分 slice 3). */
+    compactionQueuedMessages: queuesFlow.CompactionQueuedMessage[];
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4). */
+    shutdownRequested: boolean;
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): reentrancy guard. */
+    isShuttingDown: boolean;
     dialogSelector: DialogSelectorComponent | undefined;
     dialogInput: DialogInputComponent | undefined;
     dialogSelectorReplaced: (() => void) | undefined;
@@ -231,10 +257,13 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     widgetContainerBelow: Container;
     headerContainer: Container;
     builtInHeader: Component | undefined;
-    private options;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    options: InteractiveModeOptions;
     private readonly onRightClickPaste;
-    private themeController;
-    private get session();
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    themeController: InteractiveThemeController;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2): only the curated AgentSessionHostSurface (setTransport) is consumed there. */
+    get session(): AgentSession;
     /**
      * Constructor-injected settings (D-047): the TUI reads settings from the
      * host-provided manager, never from AgentSession. Internal collaboration
@@ -253,26 +282,32 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     private showStartupNoticesIfNeeded;
     private mountInteractiveTui;
     private stopInteractiveTui;
-    private switchTuiMode;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    switchTuiMode(mode: TuiMode, restoreProgress?: boolean, startRenderer?: boolean): boolean;
     init(): Promise<void>;
     /**
      * Update terminal title with session name and cwd.
      */
-    private updateTerminalTitle;
+    updateTerminalTitle(): void;
+    /** Host-visible for ./startup-services.ts. */
+    getVersion(): string;
+    /** Narrow cwd projection for startup background checks (D-048). */
+    getCwd(): string;
+    /** Live initialization read for late-arriving background checks. */
+    hasInitialized(): boolean;
     /**
      * Run the interactive mode. This is the main entry point.
      * Initializes the UI, shows warnings, processes initial messages, and starts the interactive loop.
      */
     run(): Promise<void>;
     private promptWithEmptyReplyRetry;
-    private checkForPackageUpdates;
-    private checkTmuxKeyboardSetup;
     /**
      * Get changelog entries to display on startup.
      * Only shows new entries since last seen version, skips for resumed sessions.
      */
     private getChangelogForDisplay;
-    private getMarkdownThemeWithSettings;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    getMarkdownThemeWithSettings(): MarkdownTheme;
     private formatDisplayPath;
     private formatContextPath;
     private getStartupExpansionState;
@@ -294,21 +329,34 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     findSourceInfoForPath(p: string, sourceInfos: Map<string, SourceInfo>): SourceInfo | undefined;
     formatPathWithSource(p: string, sourceInfo?: SourceInfo): string;
     private formatDiagnostics;
-    private showLoadedResources;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    showLoadedResources(options?: {
+        force?: boolean;
+        showDiagnosticsWhenQuiet?: boolean;
+    }): void;
     private bindCurrentSessionExtensions;
-    private applyFullscreenScrollbarSetting;
-    private applyRuntimeSettings;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    applyFullscreenScrollbarSetting(): void;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    applyRuntimeSettings(): void;
     private rebindCurrentSession;
-    private handleFatalRuntimeError;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    handleFatalRuntimeError(prefix: string, error: unknown): Promise<never>;
     private renderCurrentSessionState;
     /**
      * Get a registered tool definition by name (for custom rendering).
-     */
-    private getRegisteredToolDefinition;
-    private getMarkdownTransformers;
-    private showStatusIndicator;
-    private clearStatusIndicator;
-    private showWorkingStatusIndicator;
+     *
+     * Host-visible for ./interactive-events.ts (拆分 slice 5).
+     */
+    getRegisteredToolDefinition(toolName: string): import("../../core/tools/tool-definition.ts").ToolDefinition<import("@agent-forge/ai").TSchema, unknown, unknown> | undefined;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5). */
+    getMarkdownTransformers(): MarkdownTransformer[];
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    showStatusIndicator(indicator: StatusIndicator): void;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    clearStatusIndicator(kind?: StatusIndicator["kind"]): void;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5): turn_start working indicator. */
+    showWorkingStatusIndicator(): void;
     setWorkingVisible(visible: boolean): void;
     setWorkingIndicator(options?: WorkingIndicatorOptions): void;
     setHiddenThinkingLabel(label?: string): void;
@@ -317,7 +365,8 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
      * through ./interactive-dialog-ui.ts; restores the default when undefined.
      */
     setWorkingMessage(message: string | undefined): void;
-    private resetDialogUI;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    resetDialogUI(): void;
     /**
      * Apply a theme request from the extension UI host (implemented by
      * ./interactive-dialog-ui.ts), keeping the theme controller and settings
@@ -345,7 +394,8 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
      * Show a confirmation dialog for extensions.
      */
     showDialogConfirm(title: string, message: string, opts?: InteractionDialogOptions): Promise<boolean>;
-    private promptForMissingSessionCwd;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    promptForMissingSessionCwd(error: MissingSessionCwdError): Promise<string | undefined>;
     /**
      * Show a text input for extensions.
      */
@@ -385,10 +435,12 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
      */
     private dispatchEditorCommand;
     setEditorText(text: string): void;
+    /** Session subscription; implementation in ./interactive-events.ts (拆分 slice 5). */
     private subscribeToAgent;
-    private handleEvent;
-    /** Extract text content from a user message */
-    private getUserMessageText;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
+    handleEvent(event: AgentSessionEvent): Promise<void>;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
+    getUserMessageText(message: Message): string;
     /** Show a managed-tool status update in the chat. */
     private showManagedToolStatus;
     /**
@@ -398,67 +450,93 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
      * we update the previous status line instead of appending new ones to avoid log spam.
      */
     showStatus(message: string): void;
-    private addMessageToChat;
-    private renderSessionItems;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
+    addMessageToChat(message: AgentMessage, options?: {
+        populateHistory?: boolean;
+    }): void;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
+    renderSessionItems(items: readonly eventsFlow.RenderSessionItem[], options?: {
+        updateFooter?: boolean;
+        populateHistory?: boolean;
+    }): void;
     /**
      * 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.
      */
-    private renderSessionEntries;
+    renderSessionEntries(entries: SessionEntry[], options?: {
+        updateFooter?: boolean;
+        populateHistory?: boolean;
+    }): void;
     /**
      * 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.
      */
-    private addCompactionCostNotice;
-    private static countDroppedThinkingBlocks;
-    private maybeShowThinkingDropNotice;
+    addCompactionCostNotice(notice: eventsFlow.CompactionCostNotice): void;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
+    maybeShowThinkingDropNotice(message: AssistantMessage): void;
     /**
      * 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.
      */
-    private maybeShowCacheMissNotice;
-    private addCacheMissNotice;
+    maybeShowCacheMissNotice(message: AssistantMessage): void;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
+    addCacheMissNotice(miss: CacheMiss): void;
     renderInitialMessages(): void;
     getUserInput(): Promise<string>;
-    private rebuildChatFromMessages;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1); implementation in ./interactive-events.ts (拆分 slice 5). */
+    rebuildChatFromMessages(): void;
+    /** Ctrl+C interrupt/exit grading; implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
     private handleCtrlC;
+    /** Ctrl+D exit on empty editor; implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
     private handleCtrlD;
     /**
      * 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).
      */
-    private isShuttingDown;
     shutdown(options?: {
         fromSignal?: boolean;
     }): Promise<void>;
-    private emergencyTerminalExit;
-    /**
-     * 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.
-     */
-    private uncaughtCrash;
-    private checkShutdownRequested;
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): dead-terminal emergency exit. */
+    emergencyTerminalExit(): never;
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): uncaught-exception crash handler. */
+    uncaughtCrash(error: Error): never;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
+    checkShutdownRequested(): Promise<void>;
+    /** Signal/stderr/uncaught registration; implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
     private registerSignalHandlers;
-    private unregisterSignalHandlers;
+    /** Host-visible for ./interactive-lifecycle.ts (拆分 slice 4): also called by the mode's stop(). */
+    unregisterSignalHandlers(): void;
+    /** Suspend to background (Ctrl+Z); implementation in ./interactive-lifecycle.ts (拆分 slice 4). */
     private handleCtrlZ;
-    private handleFollowUp;
-    private handleDequeue;
-    /** /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. */
+    /**
+     * 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: ResumeCommandSessionReads): string | undefined;
+    /** Follow-up queue entry (Alt+Enter / /queue); implementation in ./interactive-queues.ts (拆分 slice 3). */
+    handleFollowUp(explicitText?: string): Promise<void>;
+    /** Dequeue restore (keybinding / /dequeue); implementation in ./interactive-queues.ts (拆分 slice 3). */
+    handleDequeue(): void;
+    /** /queue command host face (single-entry iron law); implementation in ./interactive-queues.ts (拆分 slice 3). */
     handleQueueCommand(text: string | undefined): Promise<void>;
-    /** /dequeue command host face: restore queued messages back to the editor. */
+    /** /dequeue command host face; implementation in ./interactive-queues.ts (拆分 slice 3). */
     handleDequeueCommand(): void;
-    /** /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(): void;
     /** /editor command host face: edit the current input in an external editor. */
     handleEditorCommand(): Promise<void>;
@@ -472,19 +550,27 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
      * 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.
      */
-    private addToolToRunGroup;
+    addToolToRunGroup(component: ToolExecutionComponent): void;
     /**
      * 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.
      */
-    private noteResultInActiveToolRunGroup;
-    private markActiveToolRunGroupComplete;
+    noteResultInActiveToolRunGroup(isError: boolean): void;
+    /** Host-visible for ./interactive-events.ts (拆分 slice 5); implementation in ./interactive-events.ts. */
+    markActiveToolRunGroupComplete(): void;
     setToolsExpanded(expanded: boolean): void;
     /** Update rendered assistant messages without rebuilding live tool components. */
-    private updateThinkingBlockVisibility;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    updateThinkingBlockVisibility(): void;
     private toggleThinkingBlockVisibility;
     private handleOpenExternalEditor;
     clearEditor(): void;
@@ -495,18 +581,37 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     /**
      * 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.
      */
-    private getAllQueuedMessages;
+    getAllQueuedMessages(): {
+        steering: string[];
+        followUp: string[];
+    };
     /**
      * 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.
      */
     private clearAllQueues;
-    /** 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(): void;
-    private restoreQueuedMessagesToEditor;
-    private queueCompactionMessage;
-    private flushCompactionQueue;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    restoreQueuedMessagesToEditor(options?: {
+        abort?: boolean;
+        /** Interrupt grading (设计 子代理运行时 §4.2): false aborts the turn
+         * without cancelling background agent tasks. */
+        cancelAgentTasks?: boolean;
+        currentText?: string;
+    }): number;
+    /** Host-visible for ./interactive-queues.ts (拆分 slice 3); implementation in ./interactive-queues.ts. */
+    queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2) and ./interactive-events.ts; implementation in ./interactive-queues.ts (拆分 slice 3). */
+    flushCompactionQueue(options?: {
+        willRetry?: boolean;
+    }): Promise<void>;
     /** Move pending bash components from pending area to chat */
     private flushPendingBashComponents;
     disposeActiveSelector(): void;
@@ -519,6 +624,7 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
         focus: Component;
         dispose?: () => void;
     }): void;
+    /** Settings selector; implementation in ./interactive-selectors.ts (拆分 slice 2). */
     showSettingsSelector(): void;
     /** /thinking command entry; implementation in ./interactive-selectors.ts (S5 slice 5). */
     handleThinkingCommand(searchTerm?: string): void;
@@ -548,7 +654,8 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
      * file's binding entry and cached per path — the selector refilters the
      * list on every keystroke.
      */
-    private readSessionSuiteId;
+    /** Host-visible for ./interactive-selectors.ts (拆分 slice 2). */
+    readSessionSuiteId(sessionPath: string): string | undefined;
     /** /suite command entry; implementation in ./interactive-selectors.ts (S5 slice 5). */
     handleSuiteCommand(suiteId?: string): void;
     /** Suite list overlay; implementation in ./interactive-selectors.ts (S5 slice 5). */
@@ -577,23 +684,16 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     showUserMessageSelector(): void;
     /** /clone command entry; implementation in ./interactive-selectors.ts (S5 slice 5). */
     handleCloneCommand(): Promise<void>;
-    /**
-     * 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(): void;
-    /**
-     * 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(): void;
+    /** Tree selector; implementation in ./interactive-selectors.ts (拆分 slice 2). */
     showTreeSelector(initialSelectedId?: string): void;
+    /** Session selector; implementation in ./interactive-selectors.ts (拆分 slice 2). */
     showSessionSelector(): void;
+    /** Queue manager overlay; implementation in ./interactive-selectors.ts (S5 slice 5). Host-visible for ./interactive-queues.ts (拆分 slice 3). */
+    showQueueManagerSelector(): void;
     private handleResumeSession;
     /**
      * Cross-suite resume detection (设计 §10.1 最小可用版): compare the loaded
@@ -603,8 +703,11 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
      * 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.
      */
-    private detectCrossSuiteResume;
+    detectCrossSuiteResume(): void;
     /**
      * Host-visible for ./interactive-auth.ts (D-048): narrow credential/provider
      * auth projection of the session's ModelRuntime through the stable facade.
@@ -685,8 +788,11 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     handleChangelogCommand(): void;
     /**
      * 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.
      */
-    private getAppKeyDisplay;
+    getAppKeyDisplay(action: AppKeybinding): string;
     /**
      * Get capitalized display string for an editor keybinding action.
      */
@@ -696,7 +802,8 @@ export declare class InteractiveMode implements DialogUiHost, authFlow.AuthUiHos
     handleClearCommand(): Promise<void>;
     handleDebugCommand(): void;
     handleArminSaysHi(): void;
-    private handleDaxnuts;
+    /** Host-visible for ./interactive-commands.ts (拆分 slice 1). */
+    handleDaxnuts(): void;
     /** Host-visible for ./interactive-auth.ts (S5 slice 3). */
     checkDaxnutsEasterEgg(model: {
         provider: string;