jeopi-cli 16.2.14 → 16.2.17

package/dist/types/modes/controllers/streaming-reveal.d.ts

@@ -0,0 +1,45 @@
+import type { AssistantMessage } from "jeopi-ai";
+import type { AssistantMessageComponent } from "../components/assistant-message";
+export declare const STREAMING_REVEAL_FRAME_MS: number;
+export declare const MIN_STEP = 3;
+export declare const CATCHUP_FRAMES = 8;
+type StreamingRevealComponent = Pick<AssistantMessageComponent, "updateContent">;
+type GraphemeSlicer = (index: number, text: string, units: number) => string;
+type StreamingRevealControllerOptions = {
+    getSmoothStreaming(): boolean;
+    getHideThinkingBlock(): boolean;
+    getProseOnlyThinking(): boolean;
+    requestRender(): void;
+};
+/** Memoizes per-block grapheme counts across reveal ticks. Streaming blocks only
+ *  grow by appending, and an append can only alter the final grapheme cluster of
+ *  the previous text, so only the suffix from that cluster needs re-segmenting. */
+export declare class BlockUnitCounter {
+    #private;
+    count(index: number, text: string): number;
+    reset(): void;
+    /** Slice `text` to its first `units` graphemes. Memoized across reveal ticks:
+     *  streaming blocks grow only by appending and the reveal target advances
+     *  monotonically, so a previously sliced prefix is reused and only the suffix
+     *  from the boundary cluster is re-segmented. Only an exact (text, units) hit
+     *  skips segmentation entirely — an append can extend the boundary cluster, so
+     *  the incremental path still re-segments from that cluster's start. */
+    slice(index: number, text: string, units: number): string;
+}
+export declare function visibleUnits(message: AssistantMessage, hideThinking: boolean, proseOnly?: boolean): number;
+export declare function buildDisplayMessage(target: AssistantMessage, revealed: number, hideThinking: boolean, proseOnly?: boolean, countOf?: (index: number, text: string) => number, sliceOf?: GraphemeSlicer): AssistantMessage;
+export declare function nextStep(backlog: number): number;
+export declare class StreamingRevealController {
+    #private;
+    constructor(options: StreamingRevealControllerOptions);
+    begin(component: StreamingRevealComponent, message: AssistantMessage): void;
+    setTarget(message: AssistantMessage): void;
+    stop(): void;
+    /**
+     * Re-read cached visibility flags (hideThinkingBlock, proseOnlyThinking)
+     * and re-render the current target. Called when the thinking level changes
+     * mid-stream so the reveal controller doesn't keep rendering with stale values.
+     */
+    resyncVisibility(): void;
+}
+export {};

package/dist/types/modes/controllers/tan-command-controller.d.ts

@@ -0,0 +1,6 @@
+import type { InteractiveModeContext } from "../types";
+export declare class TanCommandController {
+    private readonly ctx;
+    constructor(ctx: InteractiveModeContext);
+    start(work: string): Promise<void>;
+}

package/dist/types/modes/controllers/todo-command-controller.d.ts

@@ -0,0 +1,7 @@
+import type { InteractiveModeContext } from "../types";
+export declare class TodoCommandController {
+    #private;
+    private readonly ctx;
+    constructor(ctx: InteractiveModeContext);
+    handleTodoCommand(args: string): Promise<void>;
+}

package/dist/types/modes/controllers/tool-args-reveal.d.ts

@@ -0,0 +1,77 @@
+/** Minimal component surface the reveal pushes frames into. */
+type ToolArgsRevealComponent = {
+    updateArgs(args: unknown, toolCallId?: string): void;
+};
+/** String fields the streamed-args decode reads incrementally for `toolName`. */
+export declare function streamingStringKeysForTool(toolName: string, rawInput: boolean): readonly string[] | undefined;
+type ToolArgsRevealControllerOptions = {
+    getSmoothStreaming(): boolean;
+    requestRender(): void;
+};
+type ToolArgsRevealTarget = {
+    rawInput: boolean;
+    exposeRawPartialJson: boolean;
+    streamingStringKeys?: readonly string[];
+};
+type StreamedToolArgsSource = {
+    /** Custom-tool raw text stream (`customWireName` tools): never JSON-parsed. */
+    rawInput: boolean;
+    /** Provider-parsed arguments, spread UNDER the fresh decode: a dialect
+     *  projector may carry keys a raw re-parse cannot recover, but any key the
+     *  fresh parse does recover wins — provider parses lag the stream by up to
+     *  STREAMING_JSON_PARSE_MIN_GROWTH bytes mid-stream. */
+    fullArgs?: Record<string, unknown>;
+    /** See {@link streamingStringKeysForTool}. */
+    streamingStringKeys?: readonly string[];
+};
+/**
+ * One-shot decode of a streamed tool-call argument buffer into display args —
+ * the same decode the live reveal applies frame-by-frame, for paths that see
+ * the buffer once (transcript rebuilds on theme change, settings, focus
+ * replay). Keeps a rebuilt preview identical to the live preview: parsed
+ * fields come from a fresh parse of the full buffer, `streamingStringKeys`
+ * fields from the incremental string decoder (which also wins ties in the
+ * live path), never from the provider's throttled `arguments`.
+ */
+export declare function decodeStreamedToolArgs(partialJson: string, source: StreamedToolArgsSource): Record<string, unknown>;
+/**
+ * Paces streamed tool-call arguments the same way StreamingRevealController
+ * paces assistant text: providers that deliver `partialJson` in large batches
+ * (or throttle their partial parses) would otherwise make write/edit/bash
+ * streaming previews jump in chunks. Each pending tool call reveals its raw
+ * argument stream at the shared 30fps cadence with the same adaptive
+ * catch-up step. JSON prefixes are parsed only when enough new bytes arrive to
+ * change renderer-visible fields, while raw-prefix consumers still receive
+ * fresh `__partialJson` on every reveal frame.
+ *
+ * Reveal units are UTF-16 code units of the raw stream, not graphemes —
+ * the prefix goes through a JSON parser rather than straight to the screen,
+ * so only surrogate-pair integrity matters (see {@link clampSliceEnd}).
+ */
+export declare class ToolArgsRevealController {
+    #private;
+    constructor(options: ToolArgsRevealControllerOptions);
+    /**
+     * Record the latest streamed argument text for a tool call and return the
+     * args to render right now. With smoothing disabled nothing is paced — the
+     * full received buffer decodes in one step — but the entry still runs the
+     * incremental string decoder + parse throttle, so streamed text fields
+     * (write `content`, edit bodies, eval `code`) stay fresh between the
+     * provider's own throttled full-JSON parses instead of lagging up to
+     * STREAMING_JSON_PARSE_MIN_GROWTH bytes behind.
+     */
+    setTarget(id: string, partialJson: string, target: ToolArgsRevealTarget): Record<string, unknown>;
+    /** Attach the component future ticks push frames into. */
+    bind(id: string, component: ToolArgsRevealComponent): void;
+    /** Final arguments arrived (the JSON closed): drop the reveal so the
+     *  caller's final-args render wins immediately, mirroring how assistant
+     *  text snaps to the full message at message_end. */
+    finish(id: string): void;
+    /** Snap every live entry to its full received stream and clear. Used at
+     *  message_end (abort/error mid-stream) so sealed components freeze showing
+     *  everything that arrived rather than a mid-reveal prefix. */
+    flushAll(): void;
+    /** Clear without pushing (teardown). */
+    stop(): void;
+}
+export {};

package/dist/types/modes/emoji-autocomplete.d.ts

@@ -0,0 +1,16 @@
+import type { AutocompleteItem } from "jeopi-tui";
+export declare function getEmojiSuggestions(textBeforeCursor: string): {
+    items: AutocompleteItem[];
+    prefix: string;
+} | null;
+export declare function applyEmojiCompletion(lines: string[], cursorLine: number, cursorCol: number, item: AutocompleteItem, prefix: string): {
+    lines: string[];
+    cursorLine: number;
+    cursorCol: number;
+};
+export declare function tryEmojiInlineReplace(textBeforeCursor: string): {
+    replaceLen: number;
+    insert: string;
+} | null;
+export declare function isEmojiPrefix(prefix: string): boolean;
+export declare function expandEmoticons(text: string): string;

package/dist/types/modes/gradient-highlight.d.ts

@@ -0,0 +1,32 @@
+/** A gradient keyword highlighter.
+ *
+ * - `resetTo` is the SGR foreground sequence re-emitted after each painted
+ *   keyword so surrounding text keeps its color; it defaults to a plain
+ *   foreground reset (editor / default-colored text).
+ * - `phase` ∈ [0, 1) rotates the gradient stops cyclically; pass `Date.now()`-
+ *   derived values to animate a shimmer. Defaults to `0` (the static
+ *   sent-bubble palette). */
+export type KeywordHighlighter = (text: string, resetTo?: string, phase?: number) => string;
+/** Declarative spec for {@link createGradientHighlighter}. */
+export interface GradientHighlightSpec {
+    /** Cheap, stateless presence probe used to skip the boundary regex on most lines. Must be non-global. */
+    probe: RegExp;
+    /** Global, word-bounded match regex walked by `.replace`. */
+    highlight: RegExp;
+    /** Number of color stops swept across the gradient. */
+    stops: number;
+    /** Maps a normalized position `t` in [0, 1) to an HSL hue in degrees. */
+    hue: (t: number) => number;
+    /** HSL saturation percentage. Default 90. */
+    saturation?: number;
+    /** HSL lightness percentage. Default 62. */
+    lightness?: number;
+}
+/**
+ * Build a stateless highlighter that paints each standalone match of `highlight`
+ * with a smooth HSL gradient for editor display. The returned function adds only
+ * zero-width SGR escapes — the visible width is unchanged — and returns the input
+ * untouched when `probe` does not match. The palette is compiled lazily and
+ * memoized per active color mode.
+ */
+export declare function createGradientHighlighter(spec: GradientHighlightSpec): KeywordHighlighter;

package/dist/types/modes/image-references.d.ts

@@ -0,0 +1,28 @@
+import type { ImageContent } from "jeopi-ai";
+import { type BlobPutResult } from "../session/blob-store";
+/** Matches `[Image #N]`/`[Image #N, WxH]` and `[Paste #N, +X lines]`/`[Paste #N, Y chars]` tokens.
+ *  Group 1 is the kind (`Image`/`Paste`), group 2 the 1-based index. The optional metadata
+ *  tail (`, …`) is captured loosely (no `]`/newline) so future label tweaks keep matching. */
+export declare const PLACEHOLDER_REGEX: RegExp;
+/** Renumber every `[Image #N]` marker in `text` by `offset` (added to the
+ *  existing index), preserving the optional `, WxH` tail. Paste markers are
+ *  left untouched. Used when restoring queued image-messages back into a draft
+ *  that already holds pending images so the merged text's positional markers
+ *  still line up with `pendingImages`. */
+export declare function shiftImageMarkers(text: string, offset: number): string;
+type ImageBlobWriter = (data: Buffer, options?: {
+    extension?: string;
+}) => Promise<BlobPutResult>;
+type ImageBlobWriterSync = (data: Buffer, options?: {
+    extension?: string;
+}) => BlobPutResult;
+export type PlaceholderKind = "image" | "paste";
+export interface PlaceholderRenderers {
+    renderText: (text: string) => string;
+    renderReference: (label: string, kind: PlaceholderKind, index: number) => string;
+}
+export declare function renderPlaceholders(text: string, renderers: PlaceholderRenderers): string;
+export declare function imageReferenceHyperlink(label: string, index: number, imageLinks: readonly (string | undefined)[] | undefined, renderLabel: (text: string) => string): string;
+export declare function materializeImageReferenceLinks(images: readonly ImageContent[] | undefined, putBlob: ImageBlobWriter): Promise<(string | undefined)[] | undefined>;
+export declare function materializeImageReferenceLinksSync(images: readonly ImageContent[] | undefined, putBlob: ImageBlobWriterSync): (string | undefined)[] | undefined;
+export {};

package/dist/types/modes/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Interactive mode and embeddable RPC client exports for the coding agent.
+ *
+ * Branch-specific runners live in their concrete modules so importing this
+ * barrel does not pull print, RPC server, or ACP server mode into the normal
+ * TUI graph.
+ */
+export * from "./interactive-mode";
+export * from "./rpc/rpc-client";
+export * from "./rpc/rpc-types";

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

@@ -0,0 +1,399 @@
+import { type Agent, type AgentMessage } from "jeopi-agent-core";
+import type { CompactionOutcome } from "jeopi-agent-core/compaction";
+import type { AssistantMessage, ImageContent, Message, Usage, UsageReport } from "jeopi-ai";
+import type { Component, EditorTheme } from "jeopi-tui";
+import { Container, Loader, Spacer, Text, TUI } from "jeopi-tui";
+import type { CollabGuestLink } from "../collab/guest";
+import type { CollabHost } from "../collab/host";
+import { KeybindingsManager } from "../config/keybindings";
+import { Settings } from "../config/settings";
+import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
+import type { CompactOptions } from "../extensibility/extensions/types";
+import type { Skill } from "../extensibility/skills";
+import type { MCPManager } from "../mcp";
+import { type PlanApprovalDetails } from "../plan-mode/approved-plan";
+import { type AgentSession } from "../session/agent-session";
+import type { CompactMode } from "../session/compact-modes";
+import { HistoryStorage } from "../session/history-storage";
+import type { SessionContext } from "../session/session-context";
+import type { SessionManager } from "../session/session-manager";
+import type { ShakeMode } from "../session/shake-types";
+import type { LspStartupServerInfo } from "../tools";
+import type { EventBus } from "../utils/event-bus";
+import { type AssistantMessageComponent } from "./components/assistant-message";
+import type { BashExecutionComponent } from "./components/bash-execution";
+import { CustomEditor } from "./components/custom-editor";
+import type { EvalExecutionComponent } from "./components/eval-execution";
+import type { HookEditorComponent } from "./components/hook-editor";
+import type { HookInputComponent } from "./components/hook-input";
+import type { HookSelectorComponent, HookSelectorSlider } from "./components/hook-selector";
+import { StatusLineComponent } from "./components/status-line";
+import type { ToolExecutionHandle } from "./components/tool-execution";
+import { TranscriptContainer } from "./components/transcript-container";
+import { EventController } from "./controllers/event-controller";
+import { type LoopLimitRuntime } from "./loop-limit";
+import { OAuthManualInputManager } from "./oauth-manual-input";
+import type { ObservableSession } from "./session-observer-registry";
+import type { Theme } from "./theme/theme";
+import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, InteractiveSelectorDialogOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
+/**
+ * Editor max-height cap for a terminal of `terminalRows` rows.
+ *
+ * Roomy terminals get the comfortable [6, 18] band. Small terminals shrink the
+ * cap so the editor leaves at least EDITOR_MIN_CHROME_ROWS rows for the
+ * transcript + status line. The editor is bordered, so it never renders fewer
+ * than EDITOR_MIN_RENDERED_ROWS rows; once the terminal is too small for both
+ * (terminalRows < EDITOR_MIN_RENDERED_ROWS + EDITOR_MIN_CHROME_ROWS) the cap is
+ * pinned to that floor — returning a smaller number would not shrink the editor
+ * any further, it would only misreport the rows it actually occupies.
+ */
+export declare function computeEditorMaxHeight(terminalRows: number): number;
+/** Options for creating an InteractiveMode instance (for future API use) */
+export interface InteractiveModeOptions {
+    /** Providers that were migrated during startup */
+    migratedProviders?: string[];
+    /** Warning message if model fallback occurred */
+    modelFallbackMessage?: string;
+    /** Initial message to send */
+    initialMessage?: string;
+    /** Initial images to include with the message */
+    initialImages?: ImageContent[];
+    /** Additional initial messages to queue */
+    initialMessages?: string[];
+}
+/**
+ * Build the anchored subagent HUD block: a bold accent "Subagents" header plus
+ * one hooked row per running agent in the same `Id: description` shape the
+ * inline task rows use (muted task preview when no description was given).
+ * Only detached background spawns are listed: a sync task call blocks the
+ * parent turn and its inline tool block already renders progress live, and
+ * eval `agent()` spawns are rendered by their own eval cell tree.
+ * Returns an empty array when nothing is running so the container can clear.
+ */
+export declare function renderSubagentHudLines(sessions: ObservableSession[], columns: number): string[];
+export declare class InteractiveMode implements InteractiveModeContext {
+    #private;
+    session: AgentSession;
+    sessionManager: SessionManager;
+    settings: Settings;
+    keybindings: KeybindingsManager;
+    agent: Agent;
+    historyStorage?: HistoryStorage;
+    ui: TUI;
+    chatContainer: TranscriptContainer;
+    pendingMessagesContainer: Container;
+    statusContainer: Container;
+    todoContainer: Container;
+    subagentContainer: Container;
+    btwContainer: Container;
+    omfgContainer: Container;
+    errorBannerContainer: Container;
+    modelCycleContainer: Container;
+    editor: CustomEditor;
+    editorContainer: Container;
+    hookWidgetContainerAbove: Container;
+    hookWidgetContainerBelow: Container;
+    statusLine: StatusLineComponent;
+    isInitialized: boolean;
+    initialChatRendered: boolean;
+    isBashMode: boolean;
+    toolOutputExpanded: boolean;
+    todoExpanded: boolean;
+    planModeEnabled: boolean;
+    planModePaused: boolean;
+    goalModeEnabled: boolean;
+    goalModePaused: boolean;
+    planModePlanFilePath: string | undefined;
+    loopModeEnabled: boolean;
+    loopPrompt: string | undefined;
+    loopLimit: LoopLimitRuntime | undefined;
+    todoPhases: TodoPhase[];
+    hideThinkingBlock: boolean;
+    /** Whether the visible session has produced thinking content the user can reveal. */
+    get hasDisplayableThinkingContent(): boolean;
+    /** Record received reasoning content so Ctrl+T can reveal it even when model metadata says thinking is off. */
+    noteDisplayableThinkingContent(message: AgentMessage): boolean;
+    /**
+     * Effective thinking-block visibility: hidden when the user's setting is on,
+     * or while thinking is "off" before the session has actually produced
+     * displayable thinking content. Some providers return thinking blocks without
+     * advertising reasoning support, so observed content unlocks the visibility
+     * toggle.
+     */
+    get effectiveHideThinkingBlock(): boolean;
+    proseOnlyThinking: boolean;
+    compactionQueuedMessages: CompactionQueuedMessage[];
+    pendingTools: Map<string, ToolExecutionHandle>;
+    pendingBashComponents: BashExecutionComponent[];
+    bashComponent: BashExecutionComponent | undefined;
+    pendingPythonComponents: EvalExecutionComponent[];
+    pythonComponent: EvalExecutionComponent | undefined;
+    isPythonMode: boolean;
+    streamingComponent: AssistantMessageComponent | undefined;
+    streamingMessage: AssistantMessage | undefined;
+    lastAssistantUsage: Usage | undefined;
+    loadingAnimation: Loader | undefined;
+    autoCompactionLoader: Loader | undefined;
+    retryLoader: Loader | undefined;
+    unsubscribe?: () => void;
+    onInputCallback?: (input: SubmittedUserInput) => void;
+    optimisticUserMessageSignature: string | undefined;
+    locallySubmittedUserSignatures: Set<string>;
+    lastSigintTime: number;
+    lastEscapeTime: number;
+    lastLeftTapTime: number;
+    shutdownRequested: boolean;
+    /** True once `shutdown()` has begun teardown. Surfaced to the input
+     *  controller so a Ctrl+C arriving while teardown is in flight can hard-
+     *  abort the remaining work instead of stacking another no-op call. */
+    get isShuttingDown(): boolean;
+    hookSelector: HookSelectorComponent | undefined;
+    hookInput: HookInputComponent | undefined;
+    hookEditor: HookEditorComponent | undefined;
+    lastStatusSpacer: Spacer | undefined;
+    lastStatusText: Text | undefined;
+    fileSlashCommands: Set<string>;
+    skillCommands: Map<string, Skill>;
+    oauthManualInput: OAuthManualInputManager;
+    collabHost?: CollabHost;
+    collabGuest?: CollabGuestLink;
+    readonly lspServers: LspStartupServerInfo[] | undefined;
+    mcpManager?: MCPManager;
+    get eventController(): EventController;
+    get eventBus(): EventBus | undefined;
+    get viewSession(): AgentSession;
+    get focusedAgentId(): string | undefined;
+    focusAgentSession(id: string): Promise<void>;
+    focusParentSession(): Promise<void>;
+    unfocusSession(): Promise<void>;
+    clearTransientSessionUi(): void;
+    constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: MCPManager, eventBus?: EventBus);
+    playWelcomeIntro(): void;
+    init(options?: InteractiveModeInitOptions): Promise<void>;
+    /** Reload the title-generation system prompt override for the provided working
+     *  directory and stash it on the session so first-input titling
+     *  ({@link input-controller}) and replan-driven refresh
+     *  ({@link AgentSession.#refreshTitleAfterReplan}) share one source
+     *  ({@link discoverTitleSystemPromptFile}; issue #3734). */
+    refreshTitleSystemPrompt(cwd?: string): Promise<void>;
+    /** Reload slash commands and autocomplete for the provided working directory. */
+    refreshSlashCommandState(cwd?: string): Promise<void>;
+    /**
+     * Re-point the process and every cwd-derived cache at `newCwd` after the
+     * active session's working directory changed (`/move` relocation or resuming
+     * a session from another project). The SessionManager's cwd MUST already
+     * reflect `newCwd` before this is called.
+     */
+    applyCwdChange(newCwd: string): Promise<void>;
+    getUserInput(): Promise<SubmittedUserInput>;
+    disableLoopMode(message?: string): void;
+    /**
+     * Pause the loop without exiting it: drops the captured prompt and any
+     * pending auto-resubmit. Loop mode stays enabled — the next prompt the
+     * user submits becomes the new loop prompt and resumes iteration.
+     */
+    pauseLoop(): void;
+    handleLoopCommand(args?: string): Promise<string | undefined>;
+    recordLocalSubmission(text: string, imageCount?: number): () => void;
+    withLocalSubmission<T>(text: string, fn: () => Promise<T>, options?: {
+        imageCount?: number;
+    }): Promise<T>;
+    clearOptimisticUserMessage(): void;
+    replaceOptimisticUserMessage(message: AgentMessage, options?: {
+        imageLinks?: readonly (string | undefined)[];
+    }): void;
+    startPendingSubmission(input: {
+        text: string;
+        images?: ImageContent[];
+        imageLinks?: (string | undefined)[];
+        customType?: string;
+        display?: boolean;
+        streamingBehavior?: "steer" | "followUp";
+    }): SubmittedUserInput;
+    cancelPendingSubmission(): boolean;
+    markPendingSubmissionStarted(input: SubmittedUserInput): boolean;
+    finishPendingSubmission(input: SubmittedUserInput): void;
+    updateEditorBorderColor(): void;
+    /** Refresh the running-subagents status badge from the active local or collab registry. */
+    syncRunningSubagentBadge(): void;
+    rebuildChatFromMessages(): void;
+    /**
+     * Render the ctrl+p model-role cycle chip track into its own anchored
+     * container (just above the editor), mirroring the todo HUD: the container is
+     * cleared and rebuilt in place on every cycle, so rapid presses or concurrent
+     * chat activity can never stack duplicate tracks into the scrollback.
+     */
+    showModelCycleTrack(track: string): void;
+    /** Apply any deferred model switch after the current stream ends. */
+    flushPendingModelSwitch(): Promise<void>;
+    showPlanReview(planContent: string, title: string, options: string[], dialogOptions?: {
+        helpText?: string;
+        disabledIndices?: number[];
+        onExternalEditor?: () => void;
+        onPlanEdited?: (content: string) => void;
+        onFeedbackChange?: (feedback: string) => void;
+        initialIndex?: number;
+    }, extra?: {
+        slider?: HookSelectorSlider;
+    }): Promise<string | undefined>;
+    handlePlanModeCommand(initialPrompt?: string): Promise<void>;
+    handleGoalModeCommand(rest?: string): Promise<void>;
+    handleGuidedGoalCommand(rest?: string): Promise<void>;
+    /** Manually (re-)open the plan-review overlay — bound to `/plan-review`. Lets
+     *  the operator pull the review back up after dismissing it, or review a plan
+     *  the agent wrote without calling `resolve`. There is no fixed plan filename:
+     *  `getPlanReferencePath()` is empty until a plan is actually approved (and does
+     *  not survive a restart), so this drives off the newest `local://<slug>-plan.md`
+     *  the agent wrote — the files persist in the session artifacts dir, so the scan
+     *  works before any review and across restarts. */
+    openPlanReview(): Promise<void>;
+    handlePlanApproval(details: PlanApprovalDetails): Promise<void>;
+    stop(): void;
+    shutdown(): Promise<void>;
+    checkShutdownRequested(): Promise<void>;
+    setToolUIContext(uiContext: ExtensionUIContext, hasUI: boolean): void;
+    initializeHookRunner(uiContext: ExtensionUIContext, hasUI: boolean): void;
+    setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
+    present(content: Component | readonly Component[]): void;
+    resetTranscript(): void;
+    showStatus(message: string, options?: {
+        dim?: boolean;
+    }): void;
+    showError(message: string): void;
+    showPinnedError(message: string): void;
+    clearPinnedError(): void;
+    showWarning(message: string): void;
+    ensureLoadingAnimation(): void;
+    setWorkingMessage(message?: string): void;
+    applyPendingWorkingMessage(): void;
+    showNewVersionNotification(newVersion: string): void;
+    clearEditor(): void;
+    updatePendingMessagesDisplay(): void;
+    queueCompactionMessage(text: string, mode: "steer" | "followUp", images?: ImageContent[]): void;
+    flushCompactionQueue(options?: {
+        willRetry?: boolean;
+    }): Promise<void>;
+    flushPendingBashComponents(): void;
+    isKnownSlashCommand(text: string): boolean;
+    addMessageToChat(message: AgentMessage, options?: {
+        populateHistory?: boolean;
+        imageLinks?: readonly (string | undefined)[];
+    }): Component[];
+    renderSessionContext(sessionContext: SessionContext, options?: {
+        updateFooter?: boolean;
+        populateHistory?: boolean;
+    }): void;
+    renderInitialMessages(options?: {
+        preserveExistingChat?: boolean;
+        clearTerminalHistory?: boolean;
+    }): void;
+    getUserMessageText(message: Message): string;
+    findLastAssistantMessage(): AssistantMessage | undefined;
+    extractAssistantText(message: AssistantMessage): string;
+    handleExportCommand(text: string): Promise<void>;
+    handleDumpCommand(): Promise<void>;
+    handleAdvisorDumpCommand(isRaw?: boolean): void;
+    handleDebugTranscriptCommand(): Promise<void>;
+    handleShareCommand(): Promise<void>;
+    handleTodoCommand(args: string): Promise<void>;
+    handleSessionCommand(): Promise<void>;
+    handleAdvisorStatusCommand(): Promise<void>;
+    handleJobsCommand(): Promise<void>;
+    handleUsageCommand(reports?: UsageReport[] | null): Promise<void>;
+    handleChangelogCommand(showFull?: boolean): Promise<void>;
+    handleHotkeysCommand(): void;
+    handleToolsCommand(): void;
+    handleContextCommand(): void;
+    handleClearCommand(): Promise<void>;
+    handleFreshCommand(): Promise<void>;
+    handleDropCommand(): Promise<void>;
+    handleForkCommand(): Promise<void>;
+    handleMoveCommand(targetPath?: string): Promise<void>;
+    handleRenameCommand(title: string): Promise<void>;
+    handleMemoryCommand(text: string): Promise<void>;
+    handleSTTToggle(): Promise<void>;
+    showDebugSelector(): Promise<void>;
+    showAgentHub(options?: {
+        requireContent?: boolean;
+    }): void;
+    resetObserverRegistry(): void;
+    handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void>;
+    handlePythonCommand(code: string, excludeFromContext?: boolean): Promise<void>;
+    handleMCPCommand(text: string): Promise<void>;
+    handleSSHCommand(text: string): Promise<void>;
+    handleCompactCommand(customInstructions?: string, mode?: CompactMode, beforeFlush?: (outcome: CompactionOutcome) => void | Promise<void>): Promise<CompactionOutcome>;
+    handleHandoffCommand(customInstructions?: string): Promise<void>;
+    handleShakeCommand(mode: ShakeMode): Promise<void>;
+    executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
+    openInBrowser(urlOrPath: string): void;
+    showSettingsSelector(): void;
+    showAdvisorConfigure(): void;
+    showHistorySearch(): void;
+    showExtensionsDashboard(): void;
+    showAgentsDashboard(): void;
+    showModelSelector(options?: {
+        temporaryOnly?: boolean;
+    }): void;
+    showPluginSelector(mode?: "install" | "uninstall"): void;
+    showUserMessageSelector(): void;
+    showCopySelector(): void;
+    showTreeSelector(): void;
+    showSessionSelector(): void;
+    handleResumeSession(sessionPath: string): Promise<void>;
+    handleSessionDeleteCommand(): Promise<void>;
+    showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showResetUsageSelector(): Promise<void>;
+    showProviderSetup(): Promise<void>;
+    showHookConfirm(title: string, message: string): Promise<boolean>;
+    handleCtrlC(): void;
+    handleCtrlD(): void;
+    handleCtrlZ(): void;
+    handleDequeue(): void;
+    handleImagePaste(): Promise<boolean>;
+    handleBtwCommand(question: string): Promise<void>;
+    handleTanCommand(work: string): Promise<void>;
+    hasActiveBtw(): boolean;
+    handleBtwEscape(): boolean;
+    canBranchBtw(): boolean;
+    handleBtwBranchKey(): Promise<boolean>;
+    canCopyBtw(): boolean;
+    handleBtwCopyKey(): Promise<boolean>;
+    handleBtwBranch(question: string, assistantMessage: AssistantMessage): Promise<void>;
+    handleOmfgCommand(complaint: string): Promise<void>;
+    hasActiveOmfg(): boolean;
+    handleOmfgEscape(): boolean;
+    cycleThinkingLevel(): void;
+    cycleRoleModel(direction?: "forward" | "backward"): Promise<void>;
+    toggleToolOutputExpansion(): void;
+    setToolsExpanded(expanded: boolean): void;
+    toggleThinkingBlockVisibility(): void;
+    toggleTodoExpansion(): void;
+    setTodos(todos: TodoItem[] | TodoPhase[]): void;
+    reloadTodos(): Promise<void>;
+    openExternalEditor(): void;
+    registerExtensionShortcuts(): void;
+    initHooksAndCustomTools(): Promise<void>;
+    emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;
+    setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
+    setHookStatus(key: string, text: string | undefined): void;
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: InteractiveSelectorDialogOptions, extra?: {
+        slider?: HookSelectorSlider;
+    }): Promise<string | undefined>;
+    hideHookSelector(): void;
+    showHookInput(title: string, placeholder?: string): Promise<string | undefined>;
+    hideHookInput(): void;
+    showHookEditor(title: string, prefill?: string, dialogOptions?: ExtensionUIDialogOptions, editorOptions?: {
+        promptStyle?: boolean;
+    }): Promise<string | undefined>;
+    hideHookEditor(): void;
+    showHookNotify(message: string, type?: "info" | "warning" | "error"): void;
+    showHookCustom<T>(factory: (tui: TUI, theme: Theme, keybindings: KeybindingsManager, done: (result: T) => void) => (Component & {
+        dispose?(): void;
+    }) | Promise<Component & {
+        dispose?(): void;
+    }>, options?: {
+        overlay?: boolean;
+    }): Promise<T>;
+    showExtensionError(extensionPath: string, error: string): void;
+    showToolError(toolName: string, error: string): void;
+}