@compilr-dev/cli 0.5.0 → 0.5.1

package/dist/ui/terminal-ui.d.ts

@@ -15,159 +15,56 @@
  */
 import { EventEmitter } from 'events';
 import type { TodoItem, AgentMode } from './types.js';
+import type { AgentMessage, TerminalUIConfig, TerminalUIOptions, AgentSuggestion, PrintableItem } from './terminal-types.js';
+export type { AgentMessage, TerminalUIEvents, TerminalUIConfig, TerminalUIOptions, AgentSuggestion, PrintableItem, MascotExpression } from './terminal-types.js';
+export { DEFAULT_TERMINAL_UI_CONFIG, MASCOT } from './terminal-types.js';
 import type { Overlay } from './overlay/index.js';
 import { LiveRegion, type LiveItem, type SubagentLiveItem } from './live-region.js';
-/**
- * Message to be sent to the agent from a command.
- * Allows commands to invoke the agent with a detailed prompt while
- * showing a simpler message to the user.
- */
-export interface AgentMessage {
-    /** Full message to send to the agent */
-    message: string;
-    /** Optional: Simpler message to display to user (defaults to message) */
-    displayMessage?: string;
-}
-export interface TerminalUIEvents {
-    submit: (input: string) => void;
-    command: (command: string, args: string) => void;
-    cancel: () => void;
-    escape: () => void;
-    interrupt: () => void;
-    modeChange: () => void;
-}
-/**
- * Configuration for TerminalUI rendering behavior.
- * Can be changed at runtime via setConfig().
- */
-export interface TerminalUIConfig {
-    verbose: boolean;
-    theme: string;
-    showMascot: boolean;
-}
-export declare const DEFAULT_TERMINAL_UI_CONFIG: TerminalUIConfig;
-export interface TerminalUIOptions {
-    prompt?: string;
-    initialMode?: AgentMode;
-    config?: Partial<TerminalUIConfig>;
-}
-/**
- * Represents a semantic item that can be printed to the scrolling zone.
- * TerminalUI handles all formatting based on the item type and config.
- *
- * Items are stored in conversation history for re-rendering when config changes.
- */
-export type PrintableItem = {
-    type: 'user-message';
-    text: string;
-} | {
-    type: 'agent-text';
-    text: string;
-    expression?: MascotExpression;
-} | {
-    type: 'thinking';
-    text: string;
-} | {
-    type: 'tool-start';
-    name: string;
-    params: string;
-} | {
-    type: 'tool-result';
-    name: string;
-    params: string;
-    summary: string;
-    content?: string;
-    success?: boolean;
-} | {
-    type: 'tool-error';
-    name: string;
-    params: string;
-    error: string;
-} | {
-    type: 'interrupted';
-    action?: string;
-    suggestion?: string;
-} | {
-    type: 'error';
-    message: string;
-} | {
-    type: 'success';
-    message: string;
-} | {
-    type: 'info';
-    message: string;
-} | {
-    type: 'warning';
-    message: string;
-} | {
-    type: 'raw';
-    text: string;
-} | {
-    type: 'raw-lines';
-    lines: string[];
-};
-/**
- * Inline mascot expressions for agent identity and state feedback.
- * Used to prefix agent messages and in spinner animations.
- */
-export declare const MASCOT: {
-    readonly neutral: "[•_•]";
-    readonly thinking: "[°_°]";
-    readonly searching: "[◐_◐]";
-    readonly success: "[^_^]";
-    readonly error: "[×_×]";
-    readonly confused: "[?_?]";
-    readonly working: "[•̀_•́]";
-    readonly crt: readonly ["[░░░]", "[▒░░]", "[░▒░]", "[░░▒]", "[░▒░]", "[▒░░]"];
-};
-export type MascotExpression = 'neutral' | 'thinking' | 'searching' | 'success' | 'error' | 'confused' | 'working';
 export declare class TerminalUI extends EventEmitter {
     private promptPrefix;
     private promptPrefixLen;
     private config;
-    private conversationHistory;
-    private lines;
-    private currentLine;
-    private cursorPos;
+    private readonly conversation;
+    private readonly input;
+    private get lines();
+    private set lines(value);
+    private get currentLine();
+    private set currentLine(value);
+    private get cursorPos();
+    private set cursorPos(value);
+    private get suggestion();
+    private set suggestion(value);
+    private get queuedInputs();
+    private set queuedInputs(value);
     private mode;
     private projectName;
     private todos;
+    private activePlanId;
+    private activePlanName;
     private spinnerText;
-    private spinnerFrame;
     private agentRunning;
-    private queuedInputs;
     private agentMessageQueue;
     private currentTool;
-    private readonly liveRegion;
-    private readonly autocomplete;
-    private readonly fileAutocomplete;
-    private readonly history;
-    private historyIndex;
-    private savedInput;
-    private lastRenderHeight;
-    private cursorLineFromBottom;
+    private readonly turnMetrics;
+    private readonly live;
+    private readonly ac;
     private isRunning;
     private isPaused;
     private renderTimer;
     private needsRender;
-    private lastEscapeTime;
-    private suggestion;
+    private activeTeamAgent;
     private showTodos;
     private viewMode;
-    private readonly spinnerFrames;
-    private spinnerTimer;
-    private readonly overlayStack;
-    private readonly overlayResolvers;
-    private overlayRenderState;
-    private overlayPrintBuffer;
+    private readonly statusBar;
+    private readonly overlay;
+    private readonly footer;
+    private readonly keyboard;
     constructor(options?: TerminalUIOptions);
-    /** Get the full input value (all lines joined with newlines) */
-    private getInputValue;
-    /** Get the current line content */
-    private getCurrentLineContent;
-    /** Clear input and reset to single empty line */
-    private clearInput;
-    start(): void;
+    /** Set background agent count (called by REPL to keep UI in sync). */
+    setBackgroundAgentCount(count: number): void;
+    /** Set MCP loading state for status bar indicator. */
+    setMCPLoading(loading: boolean, toolCount?: number): void;
+    start(skipInitialRender?: boolean): void;
     stop(): void;
     /**
      * Print a semantic item to the scrolling zone.
@@ -181,8 +78,9 @@ export declare class TerminalUI extends EventEmitter {
     /**
      * Render a single item to the console.
      * Config-aware: respects verbose, showMascot settings.
+     * Delegates to standalone renderItem() function.
      */
-    private renderItem;
+    private renderItemToConsole;
     /**
      * Execute a callback that outputs to terminal.
      * Handles clear → callback → render automatically.
@@ -196,74 +94,123 @@ export declare class TerminalUI extends EventEmitter {
     getTodos(): TodoItem[];
     setSpinnerText(text: string | null): void;
     setCurrentTool(tool: string | null): void;
-    setMode(mode: AgentMode): void;
-    getMode(): AgentMode;
-    setProjectName(name: string | null): void;
-    getProjectName(): string | null;
     /**
-     * Set ghost text suggestion (shown when input is empty)
+     * Set whether extended thinking mode is active
+     * Shows "thinking" indicator in status line
      */
-    setSuggestion(text: string | null): void;
-    getSuggestion(): string | null;
-    clearSuggestion(): void;
+    setThinking(thinking: boolean): void;
     /**
-     * Add a subagent to the live region.
+     * Add input/output tokens for live display
+     * @param thinkingTokens - Optional thinking tokens (Gemini 2.5+ models)
+     * @param cacheReadTokens - Optional cache read tokens (Anthropic/Gemini)
+     * @param debugPayload - Optional debug payload sizes (char counts)
      */
-    addSubagent(id: string, agentType: string, description: string): void;
+    addTokens(inputTokens: number, outputTokens: number, thinkingTokens?: number, cacheReadTokens?: number, debugPayload?: {
+        systemChars: number;
+        contentsChars: number;
+        toolsChars: number;
+    }): void;
     /**
-     * Update a subagent's tool usage.
+     * Increment tool call counter
      */
-    updateSubagentTool(id: string, toolName: string, summary: string): void;
+    incrementToolCalls(): void;
     /**
-     * Mark a subagent as completed.
+     * Increment API call counter (called on each LLM request completion)
      */
-    completeSubagent(id: string, success: boolean, tokenCount?: number, _error?: string): void;
+    incrementApiCalls(): void;
     /**
-     * Remove a subagent and return it for committing to scrolling zone.
+     * Reset turn metrics (call when agent starts a new turn)
      */
-    removeSubagent(id: string): LiveItem | undefined;
+    resetTurnMetrics(): void;
     /**
-     * Clear all subagents from live region.
+     * Get current turn metrics
      */
-    clearLiveRegion(): void;
+    getTurnMetrics(): {
+        inputTokens: number;
+        outputTokens: number;
+        thinkingTokens: number;
+        cacheReadTokens: number;
+        durationMs: number;
+        toolCalls: number;
+        apiCalls: number;
+        debugPayload?: {
+            systemChars: number;
+            contentsChars: number;
+            toolsChars: number;
+        };
+    };
+    setMode(mode: AgentMode): void;
+    getMode(): AgentMode;
+    setProjectName(name: string | null): void;
+    getProjectName(): string | null;
     /**
-     * Toggle expanded view in live region (Ctrl+O).
+     * Set the active team agent (displayed in footer)
+     * Pass null to clear (default agent or no team)
      */
-    toggleLiveRegionExpanded(): void;
+    setActiveTeamAgent(agent: {
+        id: string;
+        displayName: string;
+        mascot: string;
+    } | null): void;
     /**
-     * Check if live region has items.
+     * Get the active team agent
      */
-    hasLiveItems(): boolean;
+    getActiveTeamAgent(): {
+        id: string;
+        displayName: string;
+        mascot: string;
+    } | null;
     /**
-     * Get live region for direct access if needed.
+     * Set the callback to get available team agents for $ autocomplete
      */
-    getLiveRegion(): LiveRegion;
+    setAgentSuggestionsCallback(callback: (() => AgentSuggestion[]) | undefined): void;
     /**
-     * Add a bash command to the live region.
+     * Set the callback to get available commands for / autocomplete
      */
-    addBashCommand(id: string, command: string): void;
+    setCommandsCallback(callback: (() => {
+        command: string;
+        description: string;
+    }[]) | undefined): void;
     /**
-     * Add output line to a bash command.
+     * Set the active plan (for Plan Mode display in footer)
      */
-    updateBashOutput(id: string, line: string): void;
+    setActivePlan(planId: number | null, planName: string | null): void;
     /**
-     * Mark a bash command as completed.
+     * Get the active plan info
      */
-    completeBashCommand(id: string, exitCode: number): void;
+    getActivePlan(): {
+        id: number | null;
+        name: string | null;
+    };
     /**
-     * Remove a bash command and commit it to the scrolling zone.
+     * Clear the active plan
      */
-    commitBashCommand(id: string): void;
+    clearActivePlan(): void;
     /**
-     * Remove a subagent and commit it to the scrolling zone.
-     * This is the atomic equivalent of commitBashCommand for subagents.
-     * The result content comes from tool_end, not from the LiveRegion item.
+     * Set ghost text suggestion (shown when input is empty)
      */
+    setSuggestion(text: string | null): void;
+    getSuggestion(): string | null;
+    clearSuggestion(): void;
+    addSubagent(id: string, agentType: string, description: string): void;
+    updateSubagentTool(id: string, toolName: string, summary: string): void;
+    completeSubagent(id: string, success: boolean, tokenCount?: number, _error?: string): void;
+    removeSubagent(id: string): LiveItem | undefined;
+    clearLiveRegion(): void;
+    toggleLiveRegionExpanded(): void;
+    hasLiveItems(): boolean;
+    getLiveRegion(): LiveRegion;
+    addBashCommand(id: string, command: string): void;
+    updateBashOutput(id: string, line: string): void;
+    completeBashCommand(id: string, exitCode: number): void;
+    commitBashCommand(id: string): void;
+    backgroundBashCommand(): void;
+    hasActiveBash(): boolean;
+    getActiveBashInfo(): {
+        toolUseId: string;
+        startTime: number;
+    } | null;
     commitSubagent(id: string, resultContent: string, success: boolean): SubagentLiveItem | undefined;
-    /**
-     * Format token count (e.g., 5000 -> "5.0k")
-     */
-    private formatTokens;
     /**
      * Toggle todo list visibility (Ctrl+T)
      */
@@ -286,6 +233,21 @@ export declare class TerminalUI extends EventEmitter {
      * Re-render conversation with temporary verbose setting.
      */
     private reRenderConversationVerbose;
+    /**
+     * Store restored conversation items for Ctrl+R history view.
+     * Called when a session is resumed/restored.
+     */
+    setRestoredHistory(items: PrintableItem[]): void;
+    /**
+     * Check if there is restored history available.
+     */
+    hasRestoredHistory(): boolean;
+    /**
+     * Show restored conversation history (Ctrl+R).
+     * Renders items permanently into the scrollback buffer.
+     * Stays in normal mode — the output persists like any other printed content.
+     */
+    private showRestoredHistory;
     /**
      * Update configuration at runtime.
      * If verbose changes, re-renders the entire conversation.
@@ -309,72 +271,18 @@ export declare class TerminalUI extends EventEmitter {
      * Get conversation history (copy).
      */
     getConversationHistory(): PrintableItem[];
-    /**
-     * Check if an overlay is currently active.
-     */
+    setConversationFilter(agentIds: string[]): void;
+    clearConversationFilter(): void;
+    getConversationFilter(): {
+        agentIds: string[];
+        isActive: boolean;
+    };
+    addToConversationFilter(agentId: string): boolean;
+    isAgentInFilter(agentId: string): boolean;
     hasActiveOverlay(): boolean;
-    /**
-     * Get the currently active overlay (if any).
-     */
     getActiveOverlay(): Overlay | null;
-    /**
-     * Show an overlay and wait for result.
-     * Returns promise that resolves when overlay closes.
-     */
     showOverlay<TResult>(overlay: Overlay<unknown, TResult>): Promise<TResult | null>;
-    /**
-     * Close current overlay with result.
-     * Called internally when overlay returns close action.
-     */
-    private closeCurrentOverlay;
-    /**
-     * Enter fullscreen overlay mode.
-     * Clears screen and prepares for overlay rendering.
-     */
-    private enterFullscreenOverlayMode;
-    /**
-     * Enter inline overlay mode.
-     * Clears footer but keeps conversation visible.
-     */
-    private enterInlineOverlayMode;
-    /**
-     * Exit overlay mode and restore normal rendering.
-     */
-    private exitOverlayMode;
-    /**
-     * Flush items that were buffered while an overlay was active.
-     * Called after overlay closes to render any pending output.
-     */
-    private flushOverlayPrintBuffer;
-    /**
-     * Clear previous overlay render.
-     * Uses maxLineCount to ensure all lines are cleared even if content shrank between renders.
-     */
-    private clearOverlayRender;
-    /**
-     * Render the active overlay.
-     */
-    private renderOverlay;
-    /**
-     * Render fullscreen overlay.
-     *
-     * CRITICAL: Cursor positioning must be consistent between renders.
-     * Same logic as renderInlineOverlay - pad to maxLineCount for consistency.
-     */
-    private renderFullscreenOverlay;
-    /**
-     * Render inline overlay (above footer).
-     *
-     * CRITICAL: Cursor positioning must be consistent between renders.
-     * After rendering, cursor MUST be at maxLineCount position, not at
-     * actual content height. Otherwise, the next clear will move cursor
-     * up by maxLineCount from the wrong position, causing "ghost lines".
-     */
-    private renderInlineOverlay;
-    /**
-     * Process overlay action returned by handleKey.
-     */
-    private processOverlayAction;
+    requestOverlayRender(): void;
     getQueuedInputs(): string[];
     popQueuedInput(): string | null;
     hasQueuedInput(): boolean;
@@ -420,44 +328,4 @@ export declare class TerminalUI extends EventEmitter {
      * @deprecated Use print() or output() instead
      */
     forceRender(): void;
-    private clear;
-    private render;
-    private buildSpinnerLine;
-    private buildTodoLine;
-    private buildModeLine;
-    private buildAutocompleteLines;
-    private buildFileAutocompleteLines;
-    private updateAutocomplete;
-    private acceptAutocomplete;
-    private closeAutocomplete;
-    private navigateAutocompleteUp;
-    private navigateAutocompleteDown;
-    private addToHistory;
-    private navigateHistoryUp;
-    private navigateHistoryDown;
-    private resetHistoryNavigation;
-    private startSpinnerAnimation;
-    private stopSpinnerAnimation;
-    private keyHandler;
-    private dataHandler;
-    private startKeyboardCapture;
-    private stopKeyboardCapture;
-    /**
-     * Handle word left (Option+Left) - move cursor to previous word boundary
-     */
-    private handleWordLeft;
-    /**
-     * Handle word right (Option+Right) - move cursor to next word boundary
-     */
-    private handleWordRight;
-    /**
-     * Handle Escape key - called from raw data handler for reliable detection
-     */
-    private handleEscape;
-    /**
-     * Handle keypress when overlay is active.
-     * Converts keyboard event to KeyEvent and routes to overlay.
-     */
-    private handleOverlayKeypress;
-    private handleKeypress;
 }