@compilr-dev/cli 0.4.0

package/dist/repl.d.ts

@@ -0,0 +1,121 @@
+/**
+ * REPL (Read-Eval-Print Loop)
+ *
+ * Main orchestration for the interactive agent session.
+ * Coordinates between input, agent execution, and output.
+ *
+ * Uses event-driven architecture with Footer component for:
+ * - Persistent todo list while agent runs
+ * - Persistent input prompt (always visible)
+ * - Input queueing during agent execution
+ * - Esc to cancel running agent
+ */
+import type { Agent } from '@compilr-dev/agents';
+import type { AgentMode } from './ui/types.js';
+export interface REPLOptions {
+    agent: Agent;
+    model: string;
+    provider?: string;
+    version?: string;
+    showFiltering?: boolean;
+    /** Callback when mode changes (to sync with external state) */
+    onModeChange?: (mode: AgentMode) => void;
+    /** Callback when footer is ready (provides pause/resume/setSuggestion functions) */
+    onFooterReady?: (pause: () => void, resume: () => void, setSuggestion: (action: string | null) => void) => void;
+    /** Callback when agent finishes (for applying deferred actions like suggestions) */
+    onAgentFinish?: () => void;
+}
+export declare class REPL {
+    private readonly agent;
+    private readonly model;
+    private currentModel;
+    private readonly provider;
+    private readonly version;
+    private readonly showFiltering;
+    private readonly onModeChange?;
+    private readonly onAgentFinish?;
+    private readonly startTime;
+    private readonly state;
+    private readonly footer;
+    private sessionInputTokens;
+    private sessionOutputTokens;
+    private sessionRequests;
+    private isRunning;
+    private agentRunning;
+    private abortController;
+    private exitResolve;
+    constructor(options: REPLOptions);
+    /**
+     * Set up Footer event handlers
+     */
+    private setupEventHandlers;
+    /**
+     * Cycle through agent modes (normal -> auto-accept -> plan -> normal)
+     */
+    private cycleMode;
+    /**
+     * Start the REPL (event-driven)
+     */
+    run(): Promise<void>;
+    /**
+     * Wait for REPL exit
+     */
+    private waitForExit;
+    /**
+     * Get current model
+     */
+    getCurrentModel(): string;
+    /**
+     * Get current provider
+     */
+    getProvider(): string;
+    /**
+     * Set model for hot-switching (within same provider)
+     */
+    setModel(model: string): void;
+    /**
+     * Set the agent mode programmatically (e.g., from permission handler)
+     */
+    setMode(mode: AgentMode): void;
+    /**
+     * Stop the REPL
+     */
+    stop(): void;
+    /**
+     * Handle submitted input (processes message and queued inputs)
+     */
+    private handleSubmit;
+    /**
+     * Handle slash command
+     * Returns false if REPL should exit
+     */
+    private handleCommand;
+    /**
+     * Handle /scaffold command (shared between /scaffold and /build scaffold)
+     */
+    private handleScaffoldCommand;
+    /**
+     * Strip '@' prefix from @path mentions before sending to agent
+     * The '@' is UI syntax for path autocomplete, not part of the actual path
+     * Only strips @ when it's at start of a word (not in middle like email@domain.com)
+     */
+    private stripAtMentions;
+    /**
+     * Process a message to the agent
+     * @param input - The full message to send to the agent
+     * @param options - Optional settings
+     * @param options.displayMessage - What to show the user (defaults to input)
+     * @param options.skipPlanModeCheck - Skip plan mode handling (for /design, /refine)
+     */
+    private processMessage;
+    private handleCompact;
+    private showTools;
+    private showTokens;
+    private showContext;
+    private showStatus;
+    private renderProgressBar;
+    private showTodos;
+    private handleExport;
+    private formatConversationAsMarkdown;
+    private copyToClipboard;
+}