@greppleai/grip 0.0.0-stage → 0.1.3

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

@@ -0,0 +1,554 @@
+/**
+ * Interactive mode for the coding agent.
+ * Handles TUI rendering and user interaction, delegating business logic to AgentSession.
+ */
+import { type ImageContent } from "@greppleai/grip-ai";
+import type { Terminal, TuiMode } from "@greppleai/grip-tui";
+import { type Component, type TUI, TuiAltScreen, TuiMainScreen } from "@greppleai/grip-tui";
+import { type GripAgentRuntimeHost } from "../../core/grip-agent.ts";
+import { type FullscreenExitOutput } from "../../core/settings-manager.ts";
+import { type LatestGripRelease } from "../../utils/version-check.ts";
+export declare function isApiKeyLoginProvider(providerId: string, oauthProviderIds: ReadonlySet<string>, builtInProviderIds?: ReadonlySet<string>): boolean;
+/**
+ * Options for InteractiveMode initialization.
+ */
+export interface InteractiveModeOptions {
+    /** Providers that were migrated to auth.json (shows warning) */
+    migratedProviders?: string[];
+    /** Warning message if session model couldn't be restored */
+    modelFallbackMessage?: string;
+    /** Initial message to send on startup (can include @file content) */
+    initialMessage?: string;
+    /** Images to attach to the initial message */
+    initialImages?: ImageContent[];
+    /** Additional messages to send after the initial message */
+    initialMessages?: string[];
+    /** Force verbose startup (overrides quietStartup setting) */
+    verbose?: boolean;
+    /** Initial renderer choice. Defaults to the persisted mode and can be changed during the session. */
+    tuiMode?: TuiMode;
+}
+interface InteractiveTuiOptions {
+    tuiMode?: TuiMode;
+    showHardwareCursor: boolean;
+    logDirectory: string;
+    terminal?: Terminal;
+    onRightClickPaste?: () => void;
+}
+export type InteractiveTui = TuiMainScreen | TuiAltScreen;
+export interface AddMessageToChatOptions {
+    populateHistory?: boolean;
+}
+export interface RenderSessionContextOptions {
+    updateFooter?: boolean;
+    populateHistory?: boolean;
+}
+export interface ShutdownOptions {
+    fromSignal?: boolean;
+}
+export interface SelectorView {
+    component: Component;
+    focus: Component;
+}
+export type SelectorFactory = (done: () => void) => SelectorView;
+export interface CopyCommandOptions {
+    flashConfirmation?: boolean;
+}
+/** Composition root for selecting the interactive terminal renderer. */
+export declare function createInteractiveTui(options: InteractiveTuiOptions): InteractiveTui;
+/** Stable reference for components while InteractiveMode replaces the active renderer. */
+export declare function createInteractiveTuiReference(getTui: () => TUI): TUI;
+export declare class InteractiveMode {
+    private runtimeHost;
+    private options;
+    private readonly onRightClickPaste;
+    private renderer;
+    private ui;
+    private mainScreenRenderState;
+    private loadedResourcesContainer;
+    private chatContainer;
+    private documentContainer;
+    private transcriptScrollView;
+    private fullscreenLayoutRoot;
+    private pendingMessagesContainer;
+    private statusContainer;
+    private defaultEditor;
+    private editor;
+    private editorComponentFactory;
+    private autocompleteProvider;
+    private autocompleteProviderWrappers;
+    private fdPath;
+    private editorContainer;
+    private footer;
+    private footerContainer;
+    private footerDataProvider;
+    private keybindings;
+    private version;
+    private isInitialized;
+    private transcriptRendered;
+    private onInputCallback?;
+    private pendingUserInputs;
+    private loadingAnimation;
+    private workingMessage;
+    private compressionDetectionActive;
+    private compressionDetectionOwnsLoader;
+    private workingVisible;
+    private workingIndicatorOptions;
+    private readonly defaultWorkingMessage;
+    private readonly defaultHiddenThinkingLabel;
+    private hiddenThinkingLabel;
+    private lastSigintTime;
+    private lastEscapeTime;
+    private changelogMarkdown;
+    private startupNoticesShown;
+    private anthropicSubscriptionWarningShown;
+    private lastStatusSpacer;
+    private lastStatusText;
+    private streamingComponent;
+    private streamingMessage;
+    private pendingTools;
+    private toolOutputExpanded;
+    private activeSandboxContainerId;
+    private activeSandboxBackendConnected;
+    private readonly sessionSandboxStates;
+    private readonly managedLimaInstances;
+    private hideThinkingBlock;
+    private outputPad;
+    private readonly mermaidMarkdownTransformer;
+    private skillCommands;
+    private unsubscribe?;
+    private hookExecutionUnsubscribe?;
+    private hookExecutionActivityUnsubscribe?;
+    private hookExecutionActivityDepth;
+    private hookExecutionActivityOwnsLoader;
+    private hookExecutionSession?;
+    private hookExecutionNotices;
+    private hookExecutionComponents;
+    private activeToolHookExecutionGroups;
+    private hookExecutionTurnActive;
+    private signalCleanupHandlers;
+    private isBashMode;
+    private bashComponent;
+    private pendingBashComponents;
+    private autoCompactionLoader;
+    private autoCompactionEscapeHandler?;
+    private branchSummaryLoader;
+    private summarizationRetryLoader;
+    private summarizationRetryCountdown;
+    private retryLoader;
+    private retryCountdown;
+    private retryEscapeHandler?;
+    private compactionQueuedMessages;
+    private shutdownRequested;
+    private extensionSelector;
+    private extensionInput;
+    private extensionEditor;
+    private extensionTerminalInputSubscriptions;
+    private extensionWidgetsAbove;
+    private extensionWidgetsBelow;
+    private widgetContainerAbove;
+    private widgetContainerBelow;
+    private customFooter;
+    private headerContainer;
+    private builtInHeader;
+    private customHeader;
+    private get session();
+    private get agent();
+    private get activeSession();
+    private get settingsManager();
+    constructor(runtimeHost: GripAgentRuntimeHost, options?: InteractiveModeOptions);
+    private getAutocompleteSourceTag;
+    private prefixAutocompleteDescription;
+    private getBuiltInCommandConflictDiagnostics;
+    private createBaseAutocompleteProvider;
+    private setupAutocompleteProvider;
+    private showStartupNoticesIfNeeded;
+    private initializeBuiltInHeader;
+    private mountInteractiveTui;
+    private mountRootComponents;
+    private stopInteractiveTui;
+    private switchTuiMode;
+    init(): Promise<void>;
+    /**
+     * Update terminal title with session name and cwd.
+     */
+    private updateTerminalTitle;
+    /**
+     * Run the interactive mode. This is the main entry point.
+     * Initializes the UI, shows warnings, processes initial messages, and starts the interactive loop.
+     */
+    run(): Promise<void>;
+    private startBackgroundChecks;
+    private showStartupWarnings;
+    private promptAndReportError;
+    private processInitialMessages;
+    private runInteractivePromptLoop;
+    private checkForPackageUpdates;
+    private checkTmuxKeyboardSetup;
+    /**
+     * Get changelog entries to display on startup.
+     * Only shows new entries since last seen version, skips for resumed sessions.
+     */
+    private getChangelogForDisplay;
+    private reportInstallTelemetry;
+    private getMarkdownThemeWithSettings;
+    private formatDisplayPath;
+    private formatExtensionDisplayPath;
+    private formatContextPath;
+    private getStartupExpansionState;
+    /**
+     * Get a short path relative to the package root for display.
+     */
+    private getShortPath;
+    private getCompactPathLabel;
+    private getCompactPackageSourceLabel;
+    private getCompactExtensionLabel;
+    private getCompactDisplayPathSegments;
+    private getCompactNonPackageExtensionLabel;
+    private getCompactExtensionLabels;
+    private getDisplaySourceInfo;
+    private getScopeGroup;
+    private isPackageSource;
+    private buildScopeGroups;
+    private formatScopeGroups;
+    private findSourceInfoForPath;
+    private formatPathWithSource;
+    private formatCollisionGroup;
+    private formatResourceDiagnostic;
+    private formatDiagnostics;
+    private formatCompactResourceList;
+    private addLoadedResourceSection;
+    private getLoadedResourceSnapshot;
+    private renderContextFilesSection;
+    private renderNamedInstructionSection;
+    private renderPromptTemplateSection;
+    private renderExtensionSection;
+    private renderThemeSection;
+    private renderLoadedResourceListing;
+    private addResourceDiagnosticSection;
+    private getExtensionResourceDiagnostics;
+    private renderLoadedResourceDiagnostics;
+    private showLoadedResources;
+    private bindCurrentSessionExtensions;
+    private applyRuntimeSettings;
+    private rebindCurrentSession;
+    private handleFatalRuntimeError;
+    private retireAndRenderCurrentTranscript;
+    private renderCurrentSessionState;
+    private showRuntimeDiagnostics;
+    private getMarkdownTransformers;
+    /**
+     * Get a registered tool definition by name (for custom rendering).
+     */
+    private getRegisteredToolDefinition;
+    /**
+     * Set up keyboard shortcuts registered by extensions.
+     */
+    private setupExtensionShortcuts;
+    /**
+     * Set extension status text in the footer.
+     */
+    private setExtensionStatus;
+    private formatToolBackendStatus;
+    private updateToolBackendStatus;
+    private getWorkingLoaderMessage;
+    private createWorkingLoader;
+    private stopWorkingLoader;
+    private resetHookExecutionActivity;
+    private handleHookExecutionActivity;
+    private releaseCompressionDetectionLoader;
+    private handleCompressionDetectionActivity;
+    private setWorkingVisible;
+    private setWorkingIndicator;
+    private setHiddenThinkingLabel;
+    /**
+     * Set an extension widget (string array or custom component).
+     */
+    private setExtensionWidget;
+    private clearExtensionWidgets;
+    private resetExtensionUI;
+    private static readonly MAX_WIDGET_LINES;
+    /**
+     * Render all extension widgets to the widget container.
+     */
+    private renderWidgets;
+    private renderWidgetContainer;
+    /**
+     * Set a custom footer component, or restore the built-in footer.
+     */
+    private setExtensionFooter;
+    /**
+     * Set a custom header component, or restore the built-in header.
+     */
+    private setExtensionHeader;
+    private addExtensionTerminalInputListener;
+    private rebindExtensionTerminalInputListeners;
+    private clearExtensionTerminalInputListeners;
+    /**
+     * Create the ExtensionUIContext for extensions.
+     */
+    private createExtensionUIContext;
+    /**
+     * Show a selector for extensions.
+     */
+    private showExtensionSelector;
+    /**
+     * Hide the extension selector.
+     */
+    private hideExtensionSelector;
+    private showExtensionConfirm;
+    private promptForMissingSessionCwd;
+    /**
+     * Show a text input for extensions.
+     */
+    private showExtensionInput;
+    /**
+     * Hide the extension input.
+     */
+    private hideExtensionInput;
+    /**
+     * Show a multi-line editor for extensions (with Ctrl+G support).
+     */
+    private showExtensionEditor;
+    /**
+     * Hide the extension editor.
+     */
+    private hideExtensionEditor;
+    /**
+     * Set a custom editor component from an extension.
+     * Pass undefined to restore the default editor.
+     */
+    private configureCustomEditorPresentation;
+    private inheritAppEditorHandlers;
+    private createCustomEditorComponent;
+    private setCustomEditorComponent;
+    /**
+     * Show a notification for extensions.
+     */
+    private showExtensionNotify;
+    private getExtensionOverlayOptions;
+    private mountExtensionCustomComponent;
+    private showExtensionCustom;
+    /**
+     * Show an extension error in the UI.
+     */
+    private showExtensionError;
+    private handleEmptyEditorEscape;
+    private handleEditorEscape;
+    private setupKeyHandlers;
+    private handleClipboardPaste;
+    private handleRightClickPaste;
+    private matchesEditorCommand;
+    private handleCompressionToggleCommand;
+    private resolveParameterizedEditorCommand;
+    private resolveExactEditorCommand;
+    private handleBuiltInEditorCommand;
+    private handleBashEditorSubmission;
+    private handleCompactingEditorSubmission;
+    private handleStreamingEditorSubmission;
+    private submitEditorInput;
+    private handleEditorSubmit;
+    private setupEditorSubmitHandler;
+    private addHookExecutionNotice;
+    private appendHookExecutionNoticeToActiveGroup;
+    private addHookExecutionNoticeCard;
+    private trimHookExecutionNotices;
+    private resetHookExecutionGrouping;
+    private subscribeToAgent;
+    private handleAgentStart;
+    private createPendingToolComponent;
+    private handleMessageStart;
+    private updateStreamingToolComponents;
+    private handleMessageUpdate;
+    private getAbortedStreamingMessage;
+    private failPendingTools;
+    private completePendingToolArguments;
+    private handleMessageEnd;
+    private handleAgentEnd;
+    private getCompactionLoaderLabel;
+    private handleCompactionStart;
+    private restoreAfterCompaction;
+    private showCompactionError;
+    private handleCompactionEnd;
+    private handleAutoRetryStart;
+    private handleAutoRetryEnd;
+    private handleSummarizationRetryScheduled;
+    private handleSummarizationRetryAttemptStart;
+    private handleSummarizationRetryFinished;
+    private handleEvent;
+    /** Extract text content from a user message */
+    private getUserMessageText;
+    /**
+     * 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.
+     */
+    private showStatus;
+    private addBashExecutionMessage;
+    private addCustomMessage;
+    private addCompactionSummaryMessage;
+    private addBranchSummaryMessage;
+    private createUserMessageComponent;
+    private addUserMessageContent;
+    private addUserMessage;
+    private addAssistantMessage;
+    private addMessageToChat;
+    private renderTranscriptToolCall;
+    private getTranscriptToolFailure;
+    private renderAssistantTranscriptMessage;
+    private applyTranscriptToolResult;
+    private renderTranscriptMessage;
+    /**
+     * 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
+     */
+    private renderSessionContext;
+    renderInitialMessages(): void;
+    getUserInput(): Promise<string>;
+    private rebuildChatFromMessages;
+    private handleCtrlC;
+    private handleCtrlD;
+    /**
+     * Gracefully shutdown the agent.
+     * Stops the TUI before emitting shutdown events so extension UI cleanup cannot
+     * repaint the final frame while the process is exiting.
+     */
+    private isShuttingDown;
+    private shutdown;
+    private emergencyTerminalExit;
+    /**
+     * Last-resort handler for uncaught exceptions. The TUI puts stdin into raw
+     * mode and hides the cursor; without this handler, an uncaught throw from
+     * anywhere (e.g. an extension's async `ChildProcess.on("exit")` callback)
+     * tears down the process while leaving the terminal in raw mode with no
+     * cursor, requiring `stty sane && reset` to recover.
+     *
+     * Unlike emergencyTerminalExit, the terminal is still alive here, so we
+     * call ui.stop() to restore cooked mode, the cursor, and disable bracketed
+     * paste / Kitty / modifyOtherKeys sequences.
+     */
+    private uncaughtCrash;
+    private checkShutdownRequested;
+    private registerSignalHandlers;
+    private unregisterSignalHandlers;
+    private handleCtrlZ;
+    private handleFollowUp;
+    private handleDequeue;
+    private updateEditorBorderColor;
+    private cycleThinkingLevel;
+    private cycleModel;
+    private toggleToolOutputExpansion;
+    private setToolsExpanded;
+    private toggleThinkingBlockVisibility;
+    private openExternalEditor;
+    clearEditor(): void;
+    showError(errorMessage: string): void;
+    showWarning(warningMessage: string): void;
+    showNewVersionNotification(release: LatestGripRelease): void;
+    showPackageUpdateNotification(packages: string[]): void;
+    /**
+     * Get all queued messages (read-only).
+     * Combines session queue and compaction queue.
+     */
+    private getAllQueuedMessages;
+    /**
+     * Clear all queued messages and return their contents.
+     * Clears both session queue and compaction queue.
+     */
+    private clearAllQueues;
+    private updatePendingMessagesDisplay;
+    private restoreQueuedMessagesToEditor;
+    private queueCompactionMessage;
+    private isExtensionCommand;
+    private sendQueuedCompactionMessage;
+    private restoreCompactionQueue;
+    private flushNewCompactionQueue;
+    private flushCompactionQueue;
+    /** Move pending bash components from pending area to chat */
+    private flushPendingBashComponents;
+    /**
+     * Shows a selector component in place of the editor.
+     * @param create Factory that receives a `done` callback and returns the component and focus target
+     */
+    private showSelector;
+    private updateOutputPad;
+    private showSettingsSelector;
+    private handleModelCommand;
+    private handleCompressionDetectionModelCommand;
+    private findExactModelMatch;
+    private getModelCandidates;
+    private updateAvailableProviderCount;
+    private maybeWarnAboutAnthropicSubscriptionAuth;
+    private showModelSelector;
+    private showModelsSelector;
+    private showUserMessageSelector;
+    private handleCloneCommand;
+    private selectBranchSummaryOptions;
+    private navigateToTreeEntry;
+    private handleTreeSelection;
+    private showTreeSelector;
+    private showSessionSelector;
+    private handleResumeSession;
+    private getLoginProviderOptions;
+    private getLogoutProviderOptions;
+    private showLoginAuthTypeSelector;
+    private showLoginProviderSelector;
+    private showOAuthSelector;
+    private selectProviderDefaultModelAfterAuthentication;
+    private showCompletedProviderAuthentication;
+    private completeProviderAuthentication;
+    private showBedrockSetupDialog;
+    private showApiKeyLoginDialog;
+    private showOAuthLoginSelect;
+    private showLoginDialog;
+    private handleCdCommand;
+    private handleProfileCommand;
+    private handleReloadCommand;
+    private handleExportCommand;
+    private getPathCommandArgument;
+    private handleImportCommand;
+    private handleShareCommand;
+    private handleCopyCommand;
+    private handleHooksCommand;
+    private handleNameCommand;
+    private refreshUiAfterBackendChange;
+    private createLimaSandboxService;
+    private disposeRuntimeResources;
+    private restoreCurrentSessionSandbox;
+    private hasSandboxActivationConflict;
+    private ensureSandboxCanActivate;
+    private clearSandboxBackend;
+    private attachSandboxBackend;
+    private showSandboxStartupLoader;
+    private hideSandboxStartupLoader;
+    private activateStartedSandbox;
+    private startSandboxBackend;
+    private sandboxContainerIdsMatch;
+    private removeSandboxStatesForContainer;
+    private reconcileStoppedSandbox;
+    private stopSandboxBackend;
+    private executeSandboxCommand;
+    private handleSandboxCommand;
+    private handleSessionCommand;
+    private handleChangelogCommand;
+    /**
+     * Get capitalized display string for an app keybinding action.
+     */
+    private getAppKeyDisplay;
+    /**
+     * Get capitalized display string for an editor keybinding action.
+     */
+    private getEditorKeyDisplay;
+    private handleHotkeysCommand;
+    private handleClearCommand;
+    private handleDebugCommand;
+    private createBashExecutionDisplay;
+    private handleBashCommand;
+    private handleCompactCommand;
+    stop(fullscreenExitOutput?: FullscreenExitOutput): void;
+}
+export {};
+//# sourceMappingURL=interactive-mode.d.ts.map