@oh-my-pi/pi-coding-agent 15.1.1 → 15.1.3

package/dist/types/modes/theme/mermaid-cache.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolve mermaid ASCII from fenced block source text.
+ * Returns null when rendering fails, while memoizing failures to avoid repeated work.
+ */
+export declare function resolveMermaidAscii(source: string): string | null;
+/**
+ * Clear the mermaid cache.
+ */
+export declare function clearMermaidCache(): void;

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

@@ -0,0 +1,273 @@
+import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Effort } from "@oh-my-pi/pi-ai";
+import type { EditorTheme, MarkdownTheme, SelectListTheme, SymbolTheme } from "@oh-my-pi/pi-tui";
+export { getLanguageFromPath } from "../../utils/lang-from-path";
+export type SymbolPreset = "unicode" | "nerd" | "ascii";
+/**
+ * All available symbol keys organized by category.
+ */
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers";
+export type SpinnerType = "status" | "activity";
+export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
+/** Check if a string is a valid ThemeColor value */
+export declare function isValidThemeColor(color: string): color is ThemeColor;
+export type ThemeBg = "selectedBg" | "userMessageBg" | "customMessageBg" | "toolPendingBg" | "toolSuccessBg" | "toolErrorBg" | "statusLineBg";
+type ColorMode = "truecolor" | "256color";
+export declare class Theme {
+    #private;
+    private readonly mode;
+    private readonly symbolPreset;
+    constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, symbolPreset: SymbolPreset, symbolOverrides: Partial<Record<SymbolKey, string>>);
+    fg(color: ThemeColor, text: string): string;
+    bg(color: ThemeBg, text: string): string;
+    bold(text: string): string;
+    italic(text: string): string;
+    underline(text: string): string;
+    strikethrough(text: string): string;
+    inverse(text: string): string;
+    getFgAnsi(color: ThemeColor): string;
+    getBgAnsi(color: ThemeBg): string;
+    getColorMode(): ColorMode;
+    getThinkingBorderColor(level: ThinkingLevel | Effort): (str: string) => string;
+    getBashModeBorderColor(): (str: string) => string;
+    getPythonModeBorderColor(): (str: string) => string;
+    /**
+     * Get a symbol by key.
+     */
+    symbol(key: SymbolKey): string;
+    /**
+     * Get a symbol styled with a color.
+     */
+    styledSymbol(key: SymbolKey, color: ThemeColor): string;
+    /**
+     * Get the current symbol preset.
+     */
+    getSymbolPreset(): SymbolPreset;
+    get status(): {
+        success: string;
+        error: string;
+        warning: string;
+        info: string;
+        pending: string;
+        disabled: string;
+        enabled: string;
+        running: string;
+        shadowed: string;
+        aborted: string;
+    };
+    get nav(): {
+        cursor: string;
+        selected: string;
+        expand: string;
+        collapse: string;
+        back: string;
+    };
+    get tree(): {
+        branch: string;
+        last: string;
+        vertical: string;
+        horizontal: string;
+        hook: string;
+    };
+    get boxRound(): {
+        topLeft: string;
+        topRight: string;
+        bottomLeft: string;
+        bottomRight: string;
+        horizontal: string;
+        vertical: string;
+    };
+    get boxSharp(): {
+        topLeft: string;
+        topRight: string;
+        bottomLeft: string;
+        bottomRight: string;
+        horizontal: string;
+        vertical: string;
+        cross: string;
+        teeDown: string;
+        teeUp: string;
+        teeRight: string;
+        teeLeft: string;
+    };
+    get sep(): {
+        powerline: string;
+        powerlineThin: string;
+        powerlineLeft: string;
+        powerlineRight: string;
+        powerlineThinLeft: string;
+        powerlineThinRight: string;
+        block: string;
+        space: string;
+        asciiLeft: string;
+        asciiRight: string;
+        dot: string;
+        slash: string;
+        pipe: string;
+    };
+    get icon(): {
+        model: string;
+        plan: string;
+        goal: string;
+        pause: string;
+        loop: string;
+        folder: string;
+        scratchFolder: string;
+        file: string;
+        git: string;
+        branch: string;
+        pr: string;
+        tokens: string;
+        context: string;
+        cost: string;
+        time: string;
+        pi: string;
+        agents: string;
+        cache: string;
+        input: string;
+        output: string;
+        host: string;
+        session: string;
+        package: string;
+        warning: string;
+        rewind: string;
+        auto: string;
+        fast: string;
+        extensionSkill: string;
+        extensionTool: string;
+        extensionSlashCommand: string;
+        extensionMcp: string;
+        extensionRule: string;
+        extensionHook: string;
+        extensionPrompt: string;
+        extensionContextFile: string;
+        extensionInstruction: string;
+        mic: string;
+    };
+    get thinking(): {
+        minimal: string;
+        low: string;
+        medium: string;
+        high: string;
+        xhigh: string;
+    };
+    get checkbox(): {
+        checked: string;
+        unchecked: string;
+    };
+    get format(): {
+        bullet: string;
+        dash: string;
+        bracketLeft: string;
+        bracketRight: string;
+    };
+    get md(): {
+        quoteBorder: string;
+        hrChar: string;
+        bullet: string;
+    };
+    /**
+     * Default spinner frames (status spinner).
+     */
+    get spinnerFrames(): string[];
+    /**
+     * Get spinner frames by type.
+     */
+    getSpinnerFrames(type?: SpinnerType): string[];
+    /**
+     * Get language icon for a language name.
+     * Maps common language names to their corresponding symbol keys.
+     */
+    getLangIcon(lang: string | undefined): string;
+}
+export declare function getAvailableThemes(): Promise<string[]>;
+export interface ThemeInfo {
+    name: string;
+    path: string | undefined;
+}
+export declare function getAvailableThemesWithPaths(): Promise<ThemeInfo[]>;
+export declare function getThemeByName(name: string): Promise<Theme | undefined>;
+export declare var theme: Theme;
+/** Get the name of the currently active theme. */
+export declare function getCurrentThemeName(): string | undefined;
+export declare function initTheme(enableWatcher?: boolean, symbolPreset?: SymbolPreset, colorBlindMode?: boolean, darkTheme?: string, lightTheme?: string): Promise<void>;
+export declare function setTheme(name: string, enableWatcher?: boolean): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+export declare function previewTheme(name: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Enable auto-detection mode, switching to the appropriate dark/light theme.
+ */
+export declare function enableAutoTheme(): void;
+/**
+ * Update the theme mappings for auto-detection mode.
+ * When a dark/light mapping changes and auto-detection is active, re-evaluate the theme.
+ */
+export declare function setAutoThemeMapping(mode: "dark" | "light", themeName: string): void;
+/**
+ * Called when the terminal detects a dark/light appearance change.
+ * The terminal layer queries OSC 11 (background color) and computes luminance;
+ * Mode 2031 notifications trigger re-queries rather than providing the value directly.
+ */
+export declare function onTerminalAppearanceChange(mode: "dark" | "light"): void;
+export declare function setThemeInstance(themeInstance: Theme): void;
+/**
+ * Set the symbol preset override, recreating the theme with the new preset.
+ */
+export declare function setSymbolPreset(preset: SymbolPreset): Promise<void>;
+/**
+ * Get the current symbol preset override.
+ */
+export declare function getSymbolPresetOverride(): SymbolPreset | undefined;
+/**
+ * Set color blind mode, recreating the theme with the new setting.
+ * When enabled, uses blue instead of green for diff additions.
+ */
+export declare function setColorBlindMode(enabled: boolean): Promise<void>;
+/**
+ * Get the current color blind mode setting.
+ */
+export declare function getColorBlindMode(): boolean;
+export declare function onThemeChange(callback: () => void): void;
+/**
+ * Get available symbol presets.
+ */
+export declare function getAvailableSymbolPresets(): SymbolPreset[];
+/**
+ * Check if a string is a valid symbol preset.
+ */
+export declare function isValidSymbolPreset(preset: string): preset is SymbolPreset;
+export declare function stopThemeWatcher(): void;
+/**
+ * Get resolved theme colors as CSS-compatible hex strings.
+ * Used by HTML export to generate CSS custom properties.
+ */
+export declare function getResolvedThemeColors(themeName?: string): Promise<Record<string, string>>;
+/**
+ * Check if a theme is a "light" theme by analyzing its background color luminance.
+ * Loads theme JSON synchronously (built-in or custom file) and resolves userMessageBg.
+ */
+export declare function isLightTheme(themeName?: string): boolean;
+/**
+ * Get explicit export colors from theme JSON, if specified.
+ * Returns undefined for each color that isn't explicitly set.
+ */
+export declare function getThemeExportColors(themeName?: string): Promise<{
+    pageBg?: string;
+    cardBg?: string;
+    infoBg?: string;
+}>;
+/**
+ * Highlight code with syntax coloring based on file extension or language.
+ * Returns array of highlighted lines.
+ */
+export declare function highlightCode(code: string, lang?: string): string[];
+export declare function getSymbolTheme(): SymbolTheme;
+export declare function getMarkdownTheme(): MarkdownTheme;
+export declare function getSelectListTheme(): SelectListTheme;
+export declare function getEditorTheme(): EditorTheme;
+export declare function getSettingsListTheme(): import("@oh-my-pi/pi-tui").SettingsListTheme;

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

@@ -0,0 +1,274 @@
+import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+import type { CompactionOutcome } from "@oh-my-pi/pi-agent-core/compaction";
+import type { AssistantMessage, ImageContent, Message, UsageReport } from "@oh-my-pi/pi-ai";
+import type { Component, Container, EditorTheme, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
+import type { KeybindingsManager } from "../config/keybindings";
+import type { Settings } from "../config/settings";
+import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
+import type { CompactOptions } from "../extensibility/extensions/types";
+import type { MCPManager } from "../mcp";
+import type { PlanApprovalDetails } from "../plan-mode/approved-plan";
+import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
+import type { HistoryStorage } from "../session/history-storage";
+import type { SessionContext, SessionManager } from "../session/session-manager";
+import type { LspStartupServerInfo } from "../tools";
+import type { AssistantMessageComponent } from "./components/assistant-message";
+import type { BashExecutionComponent } from "./components/bash-execution";
+import type { 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 } from "./components/hook-selector";
+import type { StatusLineComponent } from "./components/status-line";
+import type { ToolExecutionHandle } from "./components/tool-execution";
+import type { LoopLimitRuntime } from "./loop-limit";
+import type { OAuthManualInputManager } from "./oauth-manual-input";
+import type { Theme } from "./theme/theme";
+export type CompactionQueuedMessage = {
+    text: string;
+    mode: "steer" | "followUp";
+};
+export type SubmittedUserInput = {
+    text: string;
+    images?: ImageContent[];
+    customType?: string;
+    display?: boolean;
+    cancelled: boolean;
+    started: boolean;
+};
+export type TodoStatus = "pending" | "in_progress" | "completed" | "abandoned";
+export type TodoItem = {
+    content: string;
+    status: TodoStatus;
+    details?: string;
+    notes?: string[];
+};
+export type TodoPhase = {
+    name: string;
+    tasks: TodoItem[];
+};
+export interface InteractiveModeContext {
+    ui: TUI;
+    chatContainer: Container;
+    pendingMessagesContainer: Container;
+    statusContainer: Container;
+    todoContainer: Container;
+    btwContainer: Container;
+    editor: CustomEditor;
+    editorContainer: Container;
+    hookWidgetContainerAbove: Container;
+    hookWidgetContainerBelow: Container;
+    statusLine: StatusLineComponent;
+    session: AgentSession;
+    sessionManager: SessionManager;
+    settings: Settings;
+    keybindings: KeybindingsManager;
+    agent: AgentSession["agent"];
+    historyStorage?: HistoryStorage;
+    mcpManager?: MCPManager;
+    lspServers?: LspStartupServerInfo[];
+    isInitialized: boolean;
+    isBackgrounded: boolean;
+    isBashMode: boolean;
+    toolOutputExpanded: boolean;
+    todoExpanded: boolean;
+    planModeEnabled: boolean;
+    goalModeEnabled: boolean;
+    goalModePaused: boolean;
+    loopModeEnabled: boolean;
+    loopPrompt?: string;
+    loopLimit?: LoopLimitRuntime;
+    planModePlanFilePath?: string;
+    hideThinkingBlock: boolean;
+    pendingImages: ImageContent[];
+    compactionQueuedMessages: CompactionQueuedMessage[];
+    pendingTools: Map<string, ToolExecutionHandle>;
+    pendingBashComponents: BashExecutionComponent[];
+    bashComponent: BashExecutionComponent | undefined;
+    pendingPythonComponents: EvalExecutionComponent[];
+    pythonComponent: EvalExecutionComponent | undefined;
+    isPythonMode: boolean;
+    streamingComponent: AssistantMessageComponent | undefined;
+    streamingMessage: AssistantMessage | undefined;
+    loadingAnimation: Loader | undefined;
+    autoCompactionLoader: Loader | undefined;
+    retryLoader: Loader | undefined;
+    autoCompactionEscapeHandler?: () => void;
+    retryEscapeHandler?: () => void;
+    unsubscribe?: () => void;
+    onInputCallback?: (input: SubmittedUserInput) => void;
+    optimisticUserMessageSignature: string | undefined;
+    locallySubmittedUserSignatures: Set<string>;
+    lastSigintTime: number;
+    lastEscapeTime: number;
+    shutdownRequested: boolean;
+    hookSelector: HookSelectorComponent | undefined;
+    hookInput: HookInputComponent | undefined;
+    hookEditor: HookEditorComponent | undefined;
+    lastStatusSpacer: Spacer | undefined;
+    lastStatusText: Text | undefined;
+    fileSlashCommands: Set<string>;
+    skillCommands: Map<string, string>;
+    oauthManualInput: OAuthManualInputManager;
+    todoPhases: TodoPhase[];
+    init(): Promise<void>;
+    shutdown(): Promise<void>;
+    checkShutdownRequested(): Promise<void>;
+    setToolUIContext(uiContext: ExtensionUIContext, hasUI: boolean): void;
+    initializeHookRunner(uiContext: ExtensionUIContext, hasUI: boolean): void;
+    createBackgroundUiContext(): ExtensionUIContext;
+    setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
+    handleBackgroundEvent(event: AgentSessionEvent): Promise<void>;
+    showStatus(message: string, options?: {
+        dim?: boolean;
+    }): void;
+    showError(message: string): void;
+    showWarning(message: string): void;
+    showNewVersionNotification(newVersion: string): void;
+    clearEditor(): void;
+    updatePendingMessagesDisplay(): void;
+    queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
+    flushCompactionQueue(options?: {
+        willRetry?: boolean;
+    }): Promise<void>;
+    flushPendingBashComponents(): void;
+    flushPendingModelSwitch(): Promise<void>;
+    setWorkingMessage(message?: string): void;
+    applyPendingWorkingMessage(): void;
+    ensureLoadingAnimation(): void;
+    startPendingSubmission(input: {
+        text: string;
+        images?: ImageContent[];
+        customType?: string;
+        display?: boolean;
+    }): SubmittedUserInput;
+    cancelPendingSubmission(): boolean;
+    markPendingSubmissionStarted(input: SubmittedUserInput): boolean;
+    finishPendingSubmission(input: SubmittedUserInput): void;
+    /**
+     * Marks a locally-initiated user submission so the eventual `message_start`
+     * event for that user message does not clobber the editor draft (see #783).
+     * Returns a dispose function that removes the signature; call it on
+     * delivery failure so a retry can be re-marked cleanly.
+     */
+    recordLocalSubmission(text: string, imageCount?: number): () => void;
+    /**
+     * Wraps `fn` in a `recordLocalSubmission` marker that is automatically
+     * removed if `fn` rejects. Use this for the common case where a thrown
+     * delivery error should leave the signature set untouched.
+     */
+    withLocalSubmission<T>(text: string, fn: () => Promise<T>, options?: {
+        imageCount?: number;
+    }): Promise<T>;
+    isKnownSlashCommand(text: string): boolean;
+    addMessageToChat(message: AgentMessage, options?: {
+        populateHistory?: boolean;
+    }): Component[];
+    renderSessionContext(sessionContext: SessionContext, options?: {
+        updateFooter?: boolean;
+        populateHistory?: boolean;
+    }): void;
+    renderInitialMessages(prebuiltContext?: SessionContext): void;
+    getUserMessageText(message: Message): string;
+    findLastAssistantMessage(): AssistantMessage | undefined;
+    extractAssistantText(message: AssistantMessage): string;
+    updateEditorTopBorder(): void;
+    updateEditorBorderColor(): void;
+    rebuildChatFromMessages(): void;
+    setTodos(todos: TodoItem[] | TodoPhase[]): void;
+    reloadTodos(): Promise<void>;
+    toggleTodoExpansion(): void;
+    handleExportCommand(text: string): Promise<void>;
+    handleShareCommand(): Promise<void>;
+    handleCopyCommand(sub?: string): void;
+    handleTodoCommand(args: string): Promise<void>;
+    handleSessionCommand(): Promise<void>;
+    handleJobsCommand(): Promise<void>;
+    handleUsageCommand(reports?: UsageReport[] | null): Promise<void>;
+    handleChangelogCommand(showFull?: boolean): Promise<void>;
+    handleHotkeysCommand(): void;
+    handleToolsCommand(): void;
+    handleContextCommand(): void;
+    handleDumpCommand(): void;
+    handleDebugTranscriptCommand(): Promise<void>;
+    handleClearCommand(): Promise<void>;
+    handleDropCommand(): Promise<void>;
+    handleForkCommand(): Promise<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): Promise<CompactionOutcome>;
+    handleHandoffCommand(customInstructions?: string): Promise<void>;
+    handleMoveCommand(targetPath: string): Promise<void>;
+    handleRenameCommand(title: string): Promise<void>;
+    handleMemoryCommand(text: string): Promise<void>;
+    handleSTTToggle(): Promise<void>;
+    executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
+    openInBrowser(urlOrPath: string): void;
+    refreshSlashCommandState(cwd?: string): Promise<void>;
+    showSettingsSelector(): void;
+    showHistorySearch(): void;
+    showExtensionsDashboard(): void;
+    showAgentsDashboard(): void;
+    showModelSelector(options?: {
+        temporaryOnly?: boolean;
+    }): void;
+    showPluginSelector(mode?: "install" | "uninstall"): void;
+    showUserMessageSelector(): void;
+    showTreeSelector(): void;
+    showSessionSelector(): void;
+    handleResumeSession(sessionPath: string): Promise<void>;
+    handleSessionDeleteCommand(): Promise<void>;
+    showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showHookConfirm(title: string, message: string): Promise<boolean>;
+    showDebugSelector(): void;
+    showSessionObserver(): void;
+    resetObserverRegistry(): void;
+    handleCtrlC(): void;
+    handleCtrlD(): void;
+    handleCtrlZ(): void;
+    handleDequeue(): void;
+    handleBackgroundCommand(): void;
+    handleImagePaste(): Promise<boolean>;
+    handleBtwCommand(question: string): Promise<void>;
+    hasActiveBtw(): boolean;
+    handleBtwEscape(): boolean;
+    cycleThinkingLevel(): void;
+    cycleRoleModel(options?: {
+        temporary?: boolean;
+    }): Promise<void>;
+    toggleToolOutputExpansion(): void;
+    setToolsExpanded(expanded: boolean): void;
+    toggleThinkingBlockVisibility(): void;
+    openExternalEditor(): void;
+    registerExtensionShortcuts(): void;
+    handlePlanModeCommand(initialPrompt?: string): Promise<void>;
+    handleGoalModeCommand(rest?: string): Promise<void>;
+    handleLoopCommand(args?: string): Promise<void>;
+    disableLoopMode(): void;
+    pauseLoop(): void;
+    handlePlanApproval(details: PlanApprovalDetails): Promise<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: string[], dialogOptions?: ExtensionUIDialogOptions): 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;
+}

package/dist/types/modes/utils/context-usage.d.ts

@@ -0,0 +1,30 @@
+import type { Model } from "@oh-my-pi/pi-ai";
+import type { AgentSession } from "../../session/agent-session";
+import type { theme as Theme } from "../theme/theme";
+type CategoryId = "systemPrompt" | "systemContext" | "systemTools" | "skills" | "messages";
+interface CategoryInfo {
+    id: CategoryId;
+    label: string;
+    tokens: number;
+    color: "accent" | "warning" | "success" | "userMessageText" | "customMessageLabel";
+    glyph: string;
+}
+export interface ContextBreakdown {
+    model: Model | undefined;
+    contextWindow: number;
+    categories: CategoryInfo[];
+    usedTokens: number;
+    autoCompactBufferTokens: number;
+    freeTokens: number;
+}
+/**
+ * Compute a breakdown of estimated context usage by category for the active
+ * session and model.
+ */
+export declare function computeContextBreakdown(session: AgentSession): ContextBreakdown;
+/**
+ * Render a colorful context-usage panel as ANSI text. Output is a series of
+ * lines pairing the grid (left) with the legend (right).
+ */
+export declare function renderContextUsage(breakdown: ContextBreakdown, theme: typeof Theme): string;
+export {};

package/dist/types/modes/utils/hotkeys-markdown.d.ts

@@ -0,0 +1,5 @@
+import type { KeybindingsManager } from "../../config/keybindings";
+export interface HotkeysMarkdownBindings {
+    keybindings: Pick<KeybindingsManager, "getDisplayString">;
+}
+export declare function buildHotkeysMarkdown(bindings: HotkeysMarkdownBindings): string;

package/dist/types/modes/utils/keybinding-matchers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Match the coding-agent interrupt key.
+ *
+ * Interactive mode installs a keybinding manager that exposes `app.interrupt`
+ * globally, but some isolated component tests still run with only TUI
+ * keybindings registered. In that case, fall back to raw Escape matching.
+ */
+export declare function matchesAppInterrupt(data: string): boolean;
+export declare function matchesSelectCancel(data: string): boolean;
+export declare function matchesAppExternalEditor(data: string): boolean;

package/dist/types/modes/utils/tools-markdown.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from "../../tools";
+export interface ToolsMarkdownBindings {
+    tools: ReadonlyArray<Pick<Tool, "description" | "name">>;
+}
+export declare function buildToolsMarkdown(bindings: ToolsMarkdownBindings): string;

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -0,0 +1,49 @@
+import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+import type { AssistantMessage, Message } from "@oh-my-pi/pi-ai";
+import { type Component } from "@oh-my-pi/pi-tui";
+import type { InteractiveModeContext } from "../../modes/types";
+import type { SessionContext } from "../../session/session-manager";
+export declare class UiHelpers {
+    #private;
+    private ctx;
+    constructor(ctx: InteractiveModeContext);
+    /** Extract text content from a user message */
+    getUserMessageText(message: Message): string;
+    /**
+     * Show a status message in the chat.
+     *
+     * If multiple status messages are emitted back-to-back (without anything else being added to the chat),
+     * we update the previous status line instead of appending new ones to avoid log spam.
+     */
+    showStatus(message: string, options?: {
+        dim?: boolean;
+    }): void;
+    addMessageToChat(message: AgentMessage, options?: {
+        populateHistory?: boolean;
+    }): Component[];
+    /**
+     * Render session context to chat. Used for initial load and rebuild after compaction.
+     * @param sessionContext Session context to render
+     * @param options.updateFooter Update footer state
+     * @param options.populateHistory Add user messages to editor history
+     */
+    renderSessionContext(sessionContext: SessionContext, options?: {
+        updateFooter?: boolean;
+        populateHistory?: boolean;
+    }): void;
+    renderInitialMessages(prebuiltContext?: SessionContext): void;
+    clearEditor(): void;
+    showError(errorMessage: string): void;
+    showWarning(warningMessage: string): void;
+    showNewVersionNotification(newVersion: string): void;
+    updatePendingMessagesDisplay(): void;
+    queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
+    isKnownSlashCommand(text: string): boolean;
+    flushCompactionQueue(options?: {
+        willRetry?: boolean;
+    }): Promise<void>;
+    /** Move pending bash components from pending area to chat */
+    flushPendingBashComponents(): void;
+    findLastAssistantMessage(): AssistantMessage | undefined;
+    extractAssistantText(message: AssistantMessage): string;
+}