@compilr-dev/cli 0.4.0

package/dist/ui/iteration-limit-overlay.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Iteration Limit Overlay
+ *
+ * Modal overlay shown when the agent reaches its iteration limit.
+ * Asks the user if they want to continue or stop execution.
+ */
+export type IterationLimitResult = {
+    continue: true;
+    additionalIterations: number;
+} | {
+    continue: false;
+};
+export interface IterationLimitOverlayOptions {
+    iteration: number;
+    maxIterations: number;
+    toolCallCount: number;
+}
+/**
+ * Show the iteration limit overlay
+ */
+export declare function showIterationLimitOverlay(options: IterationLimitOverlayOptions): Promise<IterationLimitResult>;

package/dist/ui/iteration-limit-overlay.js

@@ -0,0 +1,150 @@
+/**
+ * Iteration Limit Overlay
+ *
+ * Modal overlay shown when the agent reaches its iteration limit.
+ * Asks the user if they want to continue or stop execution.
+ */
+import chalk from 'chalk';
+import * as terminal from './terminal.js';
+import { getStyles } from '../themes/index.js';
+// =============================================================================
+// Rendering
+// =============================================================================
+function render(options, state, previousLineCount = 0, targetLineCount = 0) {
+    const s = getStyles();
+    const lines = [];
+    const cols = terminal.getTerminalWidth();
+    const border = s.muted('─'.repeat(Math.max(1, cols - 1)));
+    // Clear previous render
+    if (previousLineCount > 0) {
+        terminal.clearLinesAbove(previousLineCount);
+    }
+    // Header
+    lines.push(border);
+    lines.push(' ' + s.warning('⚠') + ' ' + chalk.bold('Iteration Limit Reached'));
+    lines.push('');
+    // Stats
+    lines.push('  Iterations: ' + s.primary(String(options.iteration)) + ' / ' + s.muted(String(options.maxIterations)));
+    lines.push('  Tool calls: ' + s.primary(String(options.toolCallCount)));
+    lines.push('');
+    lines.push('  ' + s.muted('The agent has reached its iteration limit.'));
+    lines.push('  ' + s.muted('Would you like to continue?'));
+    lines.push('');
+    // Options
+    const optionLabels = ['Yes, continue (+10 iterations)', 'Yes, continue (+20 iterations)', 'No, stop here'];
+    const optionKeys = ['1', '2', 'n'];
+    for (let i = 0; i < optionLabels.length; i++) {
+        const isCursor = state.selectedIndex === i;
+        const prefix = isCursor ? ' ❯ ' : '   ';
+        const key = `[${optionKeys[i]}] `;
+        if (isCursor) {
+            lines.push(s.primary(prefix + key + optionLabels[i]));
+        }
+        else {
+            lines.push(s.muted(prefix + key + optionLabels[i]));
+        }
+    }
+    // Footer
+    lines.push('');
+    lines.push(s.muted(' ↑↓ Navigate · Enter Select · 1/2/n Quick select'));
+    // Bottom border
+    lines.push(border);
+    // Pad with empty lines to maintain consistent height
+    while (lines.length < targetLineCount) {
+        lines.push('');
+    }
+    // Render all lines
+    terminal.write(lines.join('\n'));
+    return lines.length;
+}
+// =============================================================================
+// Main Export
+// =============================================================================
+/**
+ * Show the iteration limit overlay
+ */
+export async function showIterationLimitOverlay(options) {
+    const state = {
+        selectedIndex: 0, // Default to "Yes, continue (+10)"
+    };
+    let lineCount = 0;
+    let maxLineCount = 0;
+    // Ensure we start from a fresh line
+    terminal.writeLine('');
+    terminal.hideCursor();
+    const wasRawMode = process.stdin.isRaw;
+    terminal.enableRawMode();
+    // Initial render
+    lineCount = render(options, state, 0);
+    maxLineCount = Math.max(maxLineCount, lineCount);
+    return new Promise((resolve) => {
+        const cleanup = (result) => {
+            terminal.clearLinesAbove(maxLineCount);
+            // Show result summary
+            const s = getStyles();
+            if (result.continue) {
+                terminal.writeLine(s.muted(`Iteration limit: `) + s.success(`Continuing (+${String(result.additionalIterations)})`));
+            }
+            else {
+                terminal.writeLine(s.muted(`Iteration limit: `) + s.error(`Stopped`));
+            }
+            terminal.writeLine(''); // Blank line for separation
+            terminal.showCursor();
+            if (!wasRawMode) {
+                terminal.disableRawMode();
+            }
+            process.stdin.removeListener('data', handleData);
+            resolve(result);
+        };
+        const handleData = (data) => {
+            const isEscape = data.length === 1 && data[0] === 0x1b;
+            const isUpArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x41;
+            const isDownArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x42;
+            const isCtrlC = data.length === 1 && data[0] === 0x03;
+            const isEnter = data.length === 1 && (data[0] === 0x0d || data[0] === 0x0a);
+            // Ctrl+C or Escape = stop
+            if (isCtrlC || isEscape) {
+                cleanup({ continue: false });
+                return;
+            }
+            // Quick keys
+            const key = data.toString();
+            if (key === '1') {
+                cleanup({ continue: true, additionalIterations: 10 });
+                return;
+            }
+            if (key === '2') {
+                cleanup({ continue: true, additionalIterations: 20 });
+                return;
+            }
+            if (key.toLowerCase() === 'n') {
+                cleanup({ continue: false });
+                return;
+            }
+            // Arrow navigation
+            if (isUpArrow) {
+                state.selectedIndex = Math.max(0, state.selectedIndex - 1);
+            }
+            else if (isDownArrow) {
+                state.selectedIndex = Math.min(2, state.selectedIndex + 1);
+            }
+            else if (isEnter) {
+                // Select based on current index
+                if (state.selectedIndex === 0) {
+                    cleanup({ continue: true, additionalIterations: 10 });
+                }
+                else if (state.selectedIndex === 1) {
+                    cleanup({ continue: true, additionalIterations: 20 });
+                }
+                else {
+                    cleanup({ continue: false });
+                }
+                return;
+            }
+            // Re-render
+            lineCount = render(options, state, maxLineCount, maxLineCount);
+            maxLineCount = Math.max(maxLineCount, lineCount);
+        };
+        process.stdin.on('data', handleData);
+    });
+}

package/dist/ui/keys-overlay.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Keys Overlay
+ *
+ * Modal overlay for managing API keys.
+ * Shows status of all providers and allows setting/deleting keys.
+ */
+export interface KeysOverlayResult {
+    /** Whether any keys were changed */
+    changed: boolean;
+}
+/**
+ * Show the keys management overlay
+ */
+export declare function showKeysOverlay(): Promise<KeysOverlayResult>;

package/dist/ui/keys-overlay.js

@@ -0,0 +1,181 @@
+/**
+ * Keys Overlay
+ *
+ * Modal overlay for managing API keys.
+ * Shows status of all providers and allows setting/deleting keys.
+ */
+import * as terminal from './terminal.js';
+import { getStyles } from '../themes/index.js';
+import { getAllProviderStatuses, setApiKey, deleteApiKey, } from '../utils/credentials.js';
+// =============================================================================
+// Rendering
+// =============================================================================
+function render(state, previousLineCount = 0) {
+    const s = getStyles();
+    const lines = [];
+    const cols = terminal.getTerminalWidth();
+    const border = s.muted('─'.repeat(Math.max(1, cols - 1)));
+    // Clear previous render
+    if (previousLineCount > 0) {
+        terminal.clearLinesAbove(previousLineCount);
+    }
+    // Header
+    lines.push(border);
+    lines.push(' ' + s.primaryBold('API Keys'));
+    lines.push('');
+    if (state.mode === 'list') {
+        // List mode - show all providers
+        for (let i = 0; i < state.providers.length; i++) {
+            const p = state.providers[i];
+            const isCursor = state.selectedIndex === i;
+            const prefix = isCursor ? ' ❯ ' : '   ';
+            // Status indicator
+            let status;
+            if (p.provider === 'ollama') {
+                status = s.secondary('Local (no key needed)');
+            }
+            else if (p.hasKey) {
+                const source = p.fromEnv ? s.muted(' (env)') : '';
+                status = s.success(`✓ ${p.masked ?? '***'}`) + source;
+            }
+            else {
+                status = s.warning('○ Not set');
+            }
+            // Provider name
+            const name = isCursor ? s.primary(p.name) : p.name;
+            const line = `${prefix}${name.padEnd(22)} ${status}`;
+            lines.push(line);
+        }
+        lines.push('');
+        lines.push(s.muted(' ↑↓ Navigate · Enter Edit · d Delete · Esc Close'));
+    }
+    else {
+        // Input mode - show key entry
+        const provider = state.providers.find(p => p.provider === state.editingProvider);
+        if (provider) {
+            lines.push(` Set API key for ${s.primaryBold(provider.name)}:`);
+            lines.push('');
+            lines.push(` > ${state.inputBuffer}${s.primary('▋')}`);
+            lines.push('');
+            lines.push(s.muted(` Get key: ${provider.keyUrl}`));
+            lines.push('');
+            lines.push(s.muted(' Enter Save · Esc Cancel'));
+        }
+    }
+    // Bottom border
+    lines.push(border);
+    // Render all lines
+    terminal.write(lines.join('\n'));
+    return lines.length;
+}
+// =============================================================================
+// Main Export
+// =============================================================================
+/**
+ * Show the keys management overlay
+ */
+export async function showKeysOverlay() {
+    const state = {
+        mode: 'list',
+        selectedIndex: 0,
+        editingProvider: null,
+        inputBuffer: '',
+        cancelled: false,
+        providers: getAllProviderStatuses(),
+    };
+    let lineCount = 0;
+    let changed = false;
+    // Initial render
+    lineCount = render(state, lineCount);
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        stdin.setRawMode(true);
+        stdin.resume();
+        const cleanup = () => {
+            stdin.removeListener('data', handleKey);
+            stdin.setRawMode(false);
+            stdin.pause();
+            // Clear the overlay
+            terminal.clearLinesAbove(lineCount);
+        };
+        const handleKey = (data) => {
+            const key = data.toString();
+            if (state.mode === 'list') {
+                // List mode key handling
+                switch (key) {
+                    case '\x1B': // Escape
+                    case 'q':
+                        cleanup();
+                        resolve({ changed });
+                        return;
+                    case '\x1B[A': // Up arrow
+                        if (state.selectedIndex > 0) {
+                            state.selectedIndex--;
+                        }
+                        break;
+                    case '\x1B[B': // Down arrow
+                        if (state.selectedIndex < state.providers.length - 1) {
+                            state.selectedIndex++;
+                        }
+                        break;
+                    case '\r': // Enter - edit selected
+                    case '\n': {
+                        const selected = state.providers[state.selectedIndex];
+                        if (selected.provider !== 'ollama') {
+                            state.mode = 'input';
+                            state.editingProvider = selected.provider;
+                            state.inputBuffer = '';
+                        }
+                        break;
+                    }
+                    case 'd':
+                    case 'D': {
+                        // Delete key for selected provider
+                        const selected = state.providers[state.selectedIndex];
+                        if (selected.provider !== 'ollama' && selected.hasKey && !selected.fromEnv) {
+                            deleteApiKey(selected.provider);
+                            state.providers = getAllProviderStatuses();
+                            changed = true;
+                        }
+                        break;
+                    }
+                }
+            }
+            else {
+                // Input mode key handling
+                if (key === '\x1B') {
+                    // Escape - cancel input
+                    state.mode = 'list';
+                    state.editingProvider = null;
+                    state.inputBuffer = '';
+                }
+                else if (key === '\r' || key === '\n') {
+                    // Enter - save key
+                    if (state.inputBuffer.trim() && state.editingProvider) {
+                        setApiKey(state.editingProvider, state.inputBuffer.trim());
+                        state.providers = getAllProviderStatuses();
+                        changed = true;
+                    }
+                    state.mode = 'list';
+                    state.editingProvider = null;
+                    state.inputBuffer = '';
+                }
+                else if (key === '\x7F' || key === '\b') {
+                    // Backspace
+                    state.inputBuffer = state.inputBuffer.slice(0, -1);
+                }
+                else {
+                    // Handle paste (multiple characters) or single printable character
+                    // Filter to only printable ASCII characters
+                    const printable = key.split('').filter(c => c >= ' ' && c <= '~').join('');
+                    if (printable.length > 0) {
+                        state.inputBuffer += printable;
+                    }
+                }
+            }
+            // Re-render
+            lineCount = render(state, lineCount);
+        };
+        stdin.on('data', handleKey);
+    });
+}

package/dist/ui/model-warning-overlay.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Model Warning Overlay
+ *
+ * Shows a warning when the user runs a command that requires
+ * a larger model than they're currently using.
+ *
+ * Offers options to:
+ * - Switch to a recommended model
+ * - Use a simpler alternative command
+ * - Continue anyway
+ * - Cancel
+ */
+import type { TierLevel } from '../utils/model-tiers.js';
+export interface ModelWarningOptions {
+    /** The command being run (e.g., '/design') */
+    command: string;
+    /** Current model ID */
+    currentModel: string;
+    /** Current model's tier */
+    currentTier: TierLevel;
+    /** Suggested upgrade model (if available) */
+    suggestedModel?: string;
+    /** Alternative simpler command (e.g., '/sketch') */
+    alternativeCommand?: string;
+}
+export type ModelWarningChoice = 'switch' | 'alternative' | 'continue' | 'cancel';
+/**
+ * Show the model warning overlay and return the user's choice.
+ */
+export declare function showModelWarningOverlay(options: ModelWarningOptions): Promise<ModelWarningChoice>;

package/dist/ui/model-warning-overlay.js

@@ -0,0 +1,171 @@
+/**
+ * Model Warning Overlay
+ *
+ * Shows a warning when the user runs a command that requires
+ * a larger model than they're currently using.
+ *
+ * Offers options to:
+ * - Switch to a recommended model
+ * - Use a simpler alternative command
+ * - Continue anyway
+ * - Cancel
+ */
+import * as terminal from './terminal.js';
+import { getStyles } from '../themes/index.js';
+import { pauseForOverlay, resumeAfterOverlay } from './overlay-controller.js';
+// =============================================================================
+// Rendering
+// =============================================================================
+function render(options, selectedIndex, previousLineCount = 0, targetLineCount = 0) {
+    const s = getStyles();
+    const lines = [];
+    const cols = terminal.getTerminalWidth();
+    const border = s.muted('─'.repeat(Math.max(1, cols - 1)));
+    // Clear previous render
+    if (previousLineCount > 0) {
+        terminal.clearLinesAbove(previousLineCount);
+    }
+    // Build options list
+    const choiceOptions = [];
+    if (options.suggestedModel) {
+        choiceOptions.push({
+            key: '1',
+            label: `Switch to ${options.suggestedModel} and continue`,
+            choice: 'switch',
+        });
+    }
+    if (options.alternativeCommand) {
+        choiceOptions.push({
+            key: String(choiceOptions.length + 1),
+            label: `Use ${options.alternativeCommand} instead (simpler, works with any model)`,
+            choice: 'alternative',
+        });
+    }
+    choiceOptions.push({
+        key: String(choiceOptions.length + 1),
+        label: 'Continue with current model anyway',
+        choice: 'continue',
+    });
+    // Header
+    lines.push(border);
+    lines.push(' ' + s.warning('⚠ Model Recommendation'));
+    lines.push('');
+    // Description
+    lines.push(` ${options.command} works best with larger models for complex`);
+    lines.push(' multi-question workflows.');
+    lines.push('');
+    // Current and recommended
+    lines.push(` Current: ${s.muted(options.currentModel)} (${options.currentTier} tier)`);
+    if (options.suggestedModel) {
+        lines.push(` Recommended: ${s.primary(options.suggestedModel)} (large tier)`);
+    }
+    lines.push('');
+    // Separator
+    lines.push(border);
+    // Options
+    for (let i = 0; i < choiceOptions.length; i++) {
+        const opt = choiceOptions[i];
+        const isCursor = selectedIndex === i;
+        const prefix = isCursor ? ' ❯ ' : '   ';
+        if (isCursor) {
+            lines.push(s.primary(`${prefix}[${opt.key}] ${opt.label}`));
+        }
+        else {
+            lines.push(s.muted(`${prefix}[${opt.key}] ${opt.label}`));
+        }
+    }
+    // Footer
+    lines.push('');
+    lines.push(s.muted(' ↑↓ Navigate · Enter Select · Esc Cancel'));
+    lines.push(border);
+    // Pad with empty lines to maintain consistent height
+    while (lines.length < targetLineCount) {
+        lines.push('');
+    }
+    // Render all lines
+    terminal.write(lines.join('\n'));
+    return lines.length;
+}
+// =============================================================================
+// Main Export
+// =============================================================================
+/**
+ * Show the model warning overlay and return the user's choice.
+ */
+export async function showModelWarningOverlay(options) {
+    // Build choice list to track what each index maps to
+    const choices = [];
+    if (options.suggestedModel) {
+        choices.push('switch');
+    }
+    if (options.alternativeCommand) {
+        choices.push('alternative');
+    }
+    choices.push('continue');
+    let selectedIndex = 0;
+    let lineCount = 0;
+    let maxLineCount = 0;
+    // Pause footer animation
+    pauseForOverlay();
+    // Clear and prepare
+    terminal.clearToEndOfScreen();
+    terminal.writeLine('');
+    terminal.hideCursor();
+    const wasRawMode = process.stdin.isRaw;
+    terminal.enableRawMode();
+    // Initial render
+    lineCount = render(options, selectedIndex, 0);
+    maxLineCount = Math.max(maxLineCount, lineCount);
+    // Re-render to stabilize
+    lineCount = render(options, selectedIndex, lineCount, lineCount);
+    return new Promise((resolve) => {
+        const cleanup = () => {
+            terminal.clearLinesAbove(maxLineCount);
+            terminal.writeLine('');
+            terminal.showCursor();
+            if (!wasRawMode) {
+                terminal.disableRawMode();
+            }
+            process.stdin.removeListener('data', handleData);
+            resumeAfterOverlay();
+        };
+        const handleData = (data) => {
+            const isEscape = data.length === 1 && data[0] === 0x1b;
+            const isUpArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x41;
+            const isDownArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x42;
+            const isCtrlC = data.length === 1 && data[0] === 0x03;
+            const isEnter = data.length === 1 && (data[0] === 0x0d || data[0] === 0x0a);
+            // Ctrl+C or Escape cancels
+            if (isCtrlC || isEscape) {
+                cleanup();
+                resolve('cancel');
+                return;
+            }
+            // Navigation
+            if (isUpArrow) {
+                selectedIndex = Math.max(0, selectedIndex - 1);
+            }
+            else if (isDownArrow) {
+                selectedIndex = Math.min(choices.length - 1, selectedIndex + 1);
+            }
+            else if (isEnter) {
+                cleanup();
+                resolve(choices[selectedIndex]);
+                return;
+            }
+            else if (data.length === 1 && data[0] >= 0x31 && data[0] <= 0x39) {
+                // Number keys 1-9
+                const numIndex = data[0] - 0x31; // 0-indexed
+                if (numIndex < choices.length) {
+                    cleanup();
+                    resolve(choices[numIndex]);
+                    return;
+                }
+            }
+            // Re-render
+            lineCount = render(options, selectedIndex, maxLineCount, maxLineCount);
+            maxLineCount = Math.max(maxLineCount, lineCount);
+        };
+        process.stdin.on('data', handleData);
+    });
+}

package/dist/ui/overlay-controller.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Overlay Controller
+ *
+ * Global controller for managing overlay display and footer coordination.
+ * Tools and overlays can use this to pause/resume the footer animation
+ * and take exclusive control of the terminal.
+ */
+type PauseCallback = () => void;
+type ResumeCallback = () => void;
+/**
+ * Register the footer pause/resume callbacks.
+ * Called once during REPL initialization.
+ */
+export declare function registerFooterCallbacks(pause: PauseCallback, resume: ResumeCallback): void;
+/**
+ * Pause footer animation and clear it for overlay use.
+ * Call this before displaying an overlay.
+ */
+export declare function pauseForOverlay(): void;
+/**
+ * Resume footer animation after overlay is done.
+ * Call this after the overlay closes.
+ */
+export declare function resumeAfterOverlay(): void;
+export {};

package/dist/ui/overlay-controller.js

@@ -0,0 +1,35 @@
+/**
+ * Overlay Controller
+ *
+ * Global controller for managing overlay display and footer coordination.
+ * Tools and overlays can use this to pause/resume the footer animation
+ * and take exclusive control of the terminal.
+ */
+let pauseFooter = null;
+let resumeFooter = null;
+/**
+ * Register the footer pause/resume callbacks.
+ * Called once during REPL initialization.
+ */
+export function registerFooterCallbacks(pause, resume) {
+    pauseFooter = pause;
+    resumeFooter = resume;
+}
+/**
+ * Pause footer animation and clear it for overlay use.
+ * Call this before displaying an overlay.
+ */
+export function pauseForOverlay() {
+    if (pauseFooter) {
+        pauseFooter();
+    }
+}
+/**
+ * Resume footer animation after overlay is done.
+ * Call this after the overlay closes.
+ */
+export function resumeAfterOverlay() {
+    if (resumeFooter) {
+        resumeFooter();
+    }
+}

package/dist/ui/overlays.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Overlays
+ *
+ * Modal overlays that temporarily take over the screen.
+ * - Help menu
+ * - Confirmation dialogs
+ * - Permission prompts
+ * - Context stats
+ */
+import type { ContextStats, PermissionResult } from './types.js';
+/**
+ * Show the tabbed help menu
+ */
+export declare function showHelp(): Promise<void>;
+export interface ConfirmationOptions {
+    confirmText?: string;
+    cancelText?: string;
+}
+/**
+ * Show a confirmation dialog
+ */
+export declare function showConfirmation(message: string, options?: ConfirmationOptions): Promise<boolean>;
+/**
+ * Show permission prompt for tool execution
+ */
+export declare function showPermissionPrompt(tool: string, args: string): Promise<PermissionResult>;
+/**
+ * Show context window usage stats
+ */
+export declare function showContextStats(stats: ContextStats): void;
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    estimatedCost?: number;
+}
+/**
+ * Show session token usage
+ */
+export declare function showTokenUsage(usage: TokenUsage): void;
+/**
+ * Show available tools in compact column format
+ */
+export declare function showTools(tools: Array<{
+    name: string;
+    description?: string;
+}>): void;