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

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

@@ -0,0 +1,47 @@
+import type { SourceMeta } from "../../capability/types";
+import type { InteractiveModeContext } from "../types";
+export type ScopeValue = "project" | "user";
+export type ScopeFlagResult = {
+    ok: true;
+    scope: ScopeValue;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Validate the value following a `--scope` flag.
+ */
+export declare function readScopeFlag(value: string | undefined): ScopeFlagResult;
+export type RemoveArgs = {
+    name: string | undefined;
+    scope: ScopeValue;
+};
+export type ParseRemoveResult = {
+    ok: true;
+    value: RemoveArgs;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Parse the argument tail of `/<cmd> remove <name> [--scope project|user]`.
+ *
+ * `rest` is the text after the subcommand keyword. The caller is responsible
+ * for emitting the command-specific "<entity> name required" usage hint when
+ * `value.name` is undefined.
+ */
+export declare function parseRemoveArgs(rest: string): ParseRemoveResult;
+/**
+ * Group capability-loaded items by their source provider+path, yielding each
+ * group with a display-ready `shortPath`.
+ */
+export declare function groupBySource<T>(items: Iterable<T>, getSource: (item: T) => SourceMeta): Iterable<{
+    providerName: string;
+    shortPath: string;
+    items: T[];
+}>;
+/**
+ * Render a message block (DynamicBorder / Text / DynamicBorder) into the chat
+ * container and request a render.
+ */
+export declare function showCommandMessage(ctx: InteractiveModeContext, text: string): void;

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

@@ -0,0 +1,36 @@
+import { type CompactionOutcome } from "@oh-my-pi/pi-agent-core/compaction";
+import { type ProviderDetails, type UsageReport } from "@oh-my-pi/pi-ai";
+import type { CompactOptions } from "../../extensibility/extensions/types";
+import { theme } from "../../modes/theme/theme";
+import type { InteractiveModeContext } from "../../modes/types";
+export declare class CommandController {
+    #private;
+    private readonly ctx;
+    constructor(ctx: InteractiveModeContext);
+    openInBrowser(urlOrPath: string): void;
+    handleExportCommand(text: string): Promise<void>;
+    handleDumpCommand(): void;
+    handleDebugTranscriptCommand(): Promise<void>;
+    handleShareCommand(): Promise<void>;
+    handleCopyCommand(sub?: string): void;
+    handleSessionCommand(): Promise<void>;
+    handleJobsCommand(): Promise<void>;
+    handleUsageCommand(reports?: UsageReport[] | null): Promise<void>;
+    handleChangelogCommand(showFull?: boolean): Promise<void>;
+    handleHotkeysCommand(): void;
+    handleToolsCommand(): void;
+    handleContextCommand(): void;
+    handleMemoryCommand(text: string): Promise<void>;
+    handleClearCommand(): Promise<void>;
+    handleDropCommand(): Promise<void>;
+    handleForkCommand(): Promise<void>;
+    handleMoveCommand(targetPath: string): Promise<void>;
+    handleRenameCommand(title: string): Promise<void>;
+    handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void>;
+    handlePythonCommand(code: string, excludeFromContext?: boolean): Promise<void>;
+    handleCompactCommand(customInstructions?: string): Promise<CompactionOutcome>;
+    handleSkillCommand(skillPath: string, args: string): Promise<void>;
+    executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
+    handleHandoffCommand(customInstructions?: string): Promise<void>;
+}
+export declare function renderProviderSection(details: ProviderDetails, uiTheme: Pick<typeof theme, "fg">): string;

package/dist/types/modes/controllers/event-controller.d.ts

@@ -0,0 +1,12 @@
+import type { InteractiveModeContext } from "../../modes/types";
+import type { AgentSessionEvent } from "../../session/agent-session";
+export declare class EventController {
+    #private;
+    private ctx;
+    constructor(ctx: InteractiveModeContext);
+    dispose(): void;
+    subscribeToAgent(): void;
+    handleEvent(event: AgentSessionEvent): Promise<void>;
+    sendCompletionNotification(): void;
+    handleBackgroundEvent(event: AgentSessionEvent): Promise<void>;
+}

package/dist/types/modes/controllers/extension-ui-controller.d.ts

@@ -0,0 +1,80 @@
+import type { Component, TUI } from "@oh-my-pi/pi-tui";
+import { KeybindingsManager } from "../../config/keybindings";
+import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions, TerminalInputHandler } from "../../extensibility/extensions";
+import { type Theme } from "../../modes/theme/theme";
+import type { InteractiveModeContext } from "../../modes/types";
+export declare class ExtensionUiController {
+    #private;
+    private ctx;
+    constructor(ctx: InteractiveModeContext);
+    /**
+     * Initialize the hook system with TUI-based UI context.
+     */
+    initHooksAndCustomTools(): Promise<void>;
+    setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
+    initializeHookRunner(uiContext: ExtensionUIContext, _hasUI: boolean): void;
+    createBackgroundUiContext(): ExtensionUIContext;
+    /**
+     * Emit session event to all extension tools.
+     */
+    emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;
+    /**
+     * Show a tool error in the chat.
+     */
+    showToolError(toolName: string, error: string): void;
+    /**
+     * Set hook status text in the footer.
+     */
+    setHookStatus(key: string, text: string | undefined): void;
+    /**
+     * Show a selector for hooks.
+     */
+    showHookSelector(title: string, options: string[], dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
+    /**
+     * Hide the hook selector.
+     */
+    hideHookSelector(): void;
+    /**
+     * Show a confirmation dialog for hooks.
+     */
+    showHookConfirm(title: string, message: string): Promise<boolean>;
+    /**
+     * Show a text input for hooks.
+     */
+    showHookInput(title: string, placeholder?: string, dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
+    /**
+     * Hide the hook input.
+     */
+    hideHookInput(): void;
+    /**
+     * Show a multi-line editor for hooks (with Ctrl+G support).
+     */
+    showHookEditor(title: string, prefill?: string, dialogOptions?: ExtensionUIDialogOptions, editorOptions?: {
+        promptStyle?: boolean;
+    }): Promise<string | undefined>;
+    /**
+     * Hide the hook editor.
+     */
+    hideHookEditor(): void;
+    /**
+     * Show a notification for hooks.
+     */
+    showHookNotify(message: string, type?: "info" | "warning" | "error"): void;
+    /**
+     * Show a custom component with keyboard focus.
+     */
+    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>;
+    /**
+     * Show an extension error in the UI.
+     */
+    addExtensionTerminalInputListener(handler: TerminalInputHandler): () => void;
+    clearHookWidgets(): void;
+    clearExtensionTerminalInputListeners(): void;
+    showExtensionError(extensionPath: string, error: string): void;
+}

package/dist/types/modes/controllers/input-controller.d.ts

@@ -0,0 +1,35 @@
+import type { AutocompleteProvider, SlashCommand } from "@oh-my-pi/pi-tui";
+import type { InteractiveModeContext } from "../../modes/types";
+export declare class InputController {
+    #private;
+    private ctx;
+    constructor(ctx: InteractiveModeContext);
+    setupKeyHandlers(): void;
+    setupEditorSubmitHandler(): void;
+    handleCtrlC(): void;
+    handleCtrlD(): void;
+    handleCtrlZ(): void;
+    handleDequeue(): void;
+    /** Send editor text as a follow-up message (queued behind current stream). */
+    handleFollowUp(): Promise<void>;
+    restoreQueuedMessagesToEditor(options?: {
+        abort?: boolean;
+        currentText?: string;
+    }): number;
+    handleBackgroundCommand(): void;
+    handleImagePaste(): Promise<boolean>;
+    createAutocompleteProvider(commands: SlashCommand[], basePath: string): AutocompleteProvider;
+    /** Copy the current editor line to the system clipboard. */
+    handleCopyCurrentLine(): void;
+    /** Copy current prompt text to system clipboard. */
+    handleCopyPrompt(): void;
+    cycleThinkingLevel(): void;
+    cycleRoleModel(options?: {
+        temporary?: boolean;
+    }): Promise<void>;
+    toggleToolOutputExpansion(): void;
+    setToolsExpanded(expanded: boolean): void;
+    toggleThinkingBlockVisibility(): void;
+    openExternalEditor(): Promise<void>;
+    registerExtensionShortcuts(): void;
+}

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

@@ -0,0 +1,10 @@
+import type { InteractiveModeContext } from "../types";
+export declare class MCPCommandController {
+    #private;
+    private ctx;
+    constructor(ctx: InteractiveModeContext);
+    /**
+     * Handle /mcp command and route to subcommands
+     */
+    handle(text: string): Promise<void>;
+}

package/dist/types/modes/controllers/selector-controller.d.ts

@@ -0,0 +1,45 @@
+import type { Component } from "@oh-my-pi/pi-tui";
+import type { InteractiveModeContext } from "../../modes/types";
+import type { SessionObserverRegistry } from "../session-observer-registry";
+export declare class SelectorController {
+    #private;
+    private ctx;
+    constructor(ctx: InteractiveModeContext);
+    /**
+     * Shows a selector component in place of the editor.
+     * @param create Factory that receives a `done` callback and returns the component and focus target
+     */
+    showSelector(create: (done: () => void) => {
+        component: Component;
+        focus: Component;
+    }): void;
+    showSettingsSelector(): void;
+    showHistorySearch(): void;
+    /**
+     * Show the Extension Control Center dashboard.
+     * Replaces /status with a unified view of all providers and extensions.
+     */
+    showExtensionsDashboard(): Promise<void>;
+    /**
+     * Show the Agent Control Center dashboard.
+     */
+    showAgentsDashboard(): Promise<void>;
+    /**
+     * Handle setting changes from the settings selector.
+     * Most settings are saved directly via SettingsManager in the definitions.
+     * This handles side effects and session-specific settings.
+     */
+    handleSettingChange(id: string, value: unknown): void;
+    showModelSelector(options?: {
+        temporaryOnly?: boolean;
+    }): void;
+    showPluginSelector(mode?: "install" | "uninstall"): Promise<void>;
+    showUserMessageSelector(): void;
+    showTreeSelector(): void;
+    showSessionSelector(): Promise<void>;
+    handleResumeSession(sessionPath: string): Promise<void>;
+    handleSessionDeleteCommand(): Promise<void>;
+    showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showDebugSelector(): void;
+    showSessionObserver(registry: SessionObserverRegistry): void;
+}

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

@@ -0,0 +1,10 @@
+import type { InteractiveModeContext } from "../types";
+export declare class SSHCommandController {
+    #private;
+    private ctx;
+    constructor(ctx: InteractiveModeContext);
+    /**
+     * Handle /ssh command and route to subcommands
+     */
+    handle(text: 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/emoji-autocomplete.d.ts

@@ -0,0 +1,16 @@
+import type { AutocompleteItem } from "@oh-my-pi/pi-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/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Run modes for the coding agent.
+ */
+export { runAcpMode } from "./acp";
+export { InteractiveMode, type InteractiveModeOptions } from "./interactive-mode";
+export { type PrintModeOptions, runPrintMode } from "./print-mode";
+export { defineRpcClientTool, type ModelInfo, RpcClient, type RpcClientCustomTool, type RpcClientOptions, type RpcClientToolContext, type RpcClientToolResult, type RpcEventListener, } from "./rpc/rpc-client";
+export { runRpcMode } from "./rpc/rpc-mode";
+export type { RpcCommand, RpcHostToolCallRequest, RpcHostToolCancelRequest, RpcHostToolDefinition, RpcHostToolResult, RpcHostToolUpdate, RpcResponse, RpcSessionState, } from "./rpc/rpc-types";

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

@@ -0,0 +1,267 @@
+import { type Agent, type AgentMessage } from "@oh-my-pi/pi-agent-core";
+import type { CompactionOutcome } from "@oh-my-pi/pi-agent-core/compaction";
+import { type AssistantMessage, type ImageContent, type Message, type UsageReport } from "@oh-my-pi/pi-ai";
+import type { Component, EditorTheme } from "@oh-my-pi/pi-tui";
+import { Container, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
+import { KeybindingsManager } from "../config/keybindings";
+import { Settings } from "../config/settings";
+import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
+import type { CompactOptions } from "../extensibility/extensions/types";
+import { type PlanApprovalDetails } from "../plan-mode/approved-plan";
+import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
+import { HistoryStorage } from "../session/history-storage";
+import type { SessionContext, SessionManager } from "../session/session-manager";
+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 } from "./components/hook-selector";
+import { StatusLineComponent } from "./components/status-line";
+import type { ToolExecutionHandle } from "./components/tool-execution";
+import { type LoopLimitRuntime } from "./loop-limit";
+import { OAuthManualInputManager } from "./oauth-manual-input";
+import type { Theme } from "./theme/theme";
+import type { CompactionQueuedMessage, InteractiveModeContext, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
+/** 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[];
+}
+export declare class InteractiveMode implements InteractiveModeContext {
+    #private;
+    session: AgentSession;
+    sessionManager: SessionManager;
+    settings: Settings;
+    keybindings: KeybindingsManager;
+    agent: Agent;
+    historyStorage?: HistoryStorage;
+    ui: TUI;
+    chatContainer: Container;
+    pendingMessagesContainer: Container;
+    statusContainer: Container;
+    todoContainer: Container;
+    btwContainer: Container;
+    editor: CustomEditor;
+    editorContainer: Container;
+    hookWidgetContainerAbove: Container;
+    hookWidgetContainerBelow: Container;
+    statusLine: StatusLineComponent;
+    isInitialized: boolean;
+    isBackgrounded: 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;
+    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;
+    readonly lspServers: LspStartupServerInfo[] | undefined;
+    mcpManager?: import("../mcp").MCPManager;
+    constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: import("../mcp").MCPManager, eventBus?: EventBus);
+    init(): Promise<void>;
+    /** Reload slash commands and autocomplete for the provided working directory. */
+    refreshSlashCommandState(cwd?: 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<void>;
+    recordLocalSubmission(text: string, imageCount?: number): () => void;
+    withLocalSubmission<T>(text: string, fn: () => Promise<T>, options?: {
+        imageCount?: number;
+    }): Promise<T>;
+    startPendingSubmission(input: {
+        text: string;
+        images?: ImageContent[];
+        customType?: string;
+        display?: boolean;
+    }): SubmittedUserInput;
+    cancelPendingSubmission(): boolean;
+    markPendingSubmissionStarted(input: SubmittedUserInput): boolean;
+    finishPendingSubmission(input: SubmittedUserInput): void;
+    updateEditorBorderColor(): void;
+    updateEditorTopBorder(): void;
+    rebuildChatFromMessages(): void;
+    /** Apply any deferred model switch after the current stream ends. */
+    flushPendingModelSwitch(): Promise<void>;
+    handlePlanModeCommand(initialPrompt?: string): Promise<void>;
+    handleGoalModeCommand(rest?: string): 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;
+    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;
+    ensureLoadingAnimation(): void;
+    setWorkingMessage(message?: string): void;
+    applyPendingWorkingMessage(): void;
+    showNewVersionNotification(newVersion: string): void;
+    clearEditor(): void;
+    updatePendingMessagesDisplay(): void;
+    queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
+    flushCompactionQueue(options?: {
+        willRetry?: boolean;
+    }): Promise<void>;
+    flushPendingBashComponents(): void;
+    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;
+    handleExportCommand(text: string): Promise<void>;
+    handleDumpCommand(): void;
+    handleDebugTranscriptCommand(): 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;
+    handleClearCommand(): 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(): void;
+    showSessionObserver(): 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): Promise<CompactionOutcome>;
+    handleHandoffCommand(customInstructions?: string): Promise<void>;
+    executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
+    openInBrowser(urlOrPath: string): 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>;
+    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;
+    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: 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/loop-limit.d.ts

@@ -0,0 +1,22 @@
+export type LoopLimitConfig = {
+    kind: "iterations";
+    iterations: number;
+} | {
+    kind: "duration";
+    durationMs: number;
+};
+export type LoopLimitRuntime = {
+    kind: "iterations";
+    initial: number;
+    remaining: number;
+} | {
+    kind: "duration";
+    durationMs: number;
+    deadlineMs: number;
+};
+export declare function parseLoopLimitArgs(args: string): LoopLimitConfig | undefined | string;
+export declare function createLoopLimitRuntime(config: LoopLimitConfig | undefined, nowMs?: number): LoopLimitRuntime | undefined;
+export declare function consumeLoopLimitIteration(limit: LoopLimitRuntime | undefined, nowMs?: number): boolean;
+export declare function isLoopDurationExpired(limit: LoopLimitRuntime | undefined, nowMs?: number): boolean;
+export declare function describeLoopLimit(config: LoopLimitConfig): string;
+export declare function describeLoopLimitRuntime(limit: LoopLimitRuntime): string;

package/dist/types/modes/oauth-manual-input.d.ts

@@ -0,0 +1,8 @@
+export declare class OAuthManualInputManager {
+    #private;
+    waitForInput(providerId: string): Promise<string>;
+    submit(input: string): boolean;
+    clear(reason?: string): void;
+    hasPending(): boolean;
+    get pendingProviderId(): string | undefined;
+}

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

@@ -0,0 +1,27 @@
+/**
+ * Print mode (single-shot): Send prompts, output result, exit.
+ *
+ * Used for:
+ * - `omp -p "prompt"` - text output
+ * - `omp --mode json "prompt"` - JSON event stream
+ */
+import type { ImageContent } from "@oh-my-pi/pi-ai";
+import type { AgentSession } from "../session/agent-session";
+/**
+ * Options for print mode.
+ */
+export interface PrintModeOptions {
+    /** Output mode: "text" for final response only, "json" for all events */
+    mode: "text" | "json";
+    /** Array of additional prompts to send after initialMessage */
+    messages?: string[];
+    /** First message to send (may contain @file content) */
+    initialMessage?: string;
+    /** Images to attach to the initial message */
+    initialImages?: ImageContent[];
+}
+/**
+ * Run in print (single-shot) mode.
+ * Sends prompts to the agent and outputs the result.
+ */
+export declare function runPrintMode(session: AgentSession, options: PrintModeOptions): Promise<void>;