@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/ui/terminal.d.ts

@@ -65,6 +65,17 @@ export declare function clearLinesAbove(count: number): void;
  * Clear entire screen
  */
 export declare function clearScreen(): void;
+/**
+ * Enter alternate screen buffer.
+ * Content shown here doesn't go to main scrollback.
+ * Used for modal UIs like menus, editors.
+ */
+export declare function enterAlternateScreen(): void;
+/**
+ * Leave alternate screen buffer.
+ * Returns to main screen (previous content restored).
+ */
+export declare function leaveAlternateScreen(): void;
 /**
  * Calculate how many physical (visual) lines a string occupies
  * given terminal width and starting column.
@@ -94,6 +105,15 @@ export declare function calculateCursorPosition(text: string, cursorPos: number,
  * @returns String of repeated characters
  */
 export declare function horizontalLine(char?: string): string;
+/**
+ * Calculate total physical lines for an array of strings (joined with newlines).
+ * Each array entry is a logical line; this returns total physical lines.
+ *
+ * @param lines - Array of lines (may contain ANSI escape codes)
+ * @param termWidth - Terminal width in columns
+ * @returns Total physical line count
+ */
+export declare function totalPhysicalLines(lines: string[], termWidth: number): number;
 /**
  * Enable raw mode for stdin
  * In raw mode, input is available character by character

package/dist/ui/terminal.js

@@ -120,6 +120,26 @@ export function clearLinesAbove(count) {
 export function clearScreen() {
     process.stdout.write('\x1b[2J\x1b[H');
 }
+/**
+ * Enter alternate screen buffer.
+ * Content shown here doesn't go to main scrollback.
+ * Used for modal UIs like menus, editors.
+ */
+export function enterAlternateScreen() {
+    // Enter alternate screen and disable mouse tracking
+    // \x1b[?1049h - alternate screen
+    // \x1b[?1000l - disable mouse click tracking
+    // \x1b[?1002l - disable mouse drag tracking
+    // \x1b[?1003l - disable all mouse tracking
+    process.stdout.write('\x1b[?1049h\x1b[?1000l\x1b[?1002l\x1b[?1003l');
+}
+/**
+ * Leave alternate screen buffer.
+ * Returns to main screen (previous content restored).
+ */
+export function leaveAlternateScreen() {
+    process.stdout.write('\x1b[?1049l');
+}
 // =============================================================================
 // Line Calculations
 // =============================================================================
@@ -193,6 +213,58 @@ export function horizontalLine(char = '─') {
     return char.repeat(getTerminalWidth());
 }
 // =============================================================================
+// ANSI-Aware Utilities (internal)
+// =============================================================================
+/**
+ * Strip ANSI escape codes from a string.
+ * Used to calculate visual width of styled text.
+ * (Not exported to avoid conflicts with other modules)
+ */
+function stripAnsiCodes(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+/**
+ * Get the visual width of a string (excluding ANSI escape codes).
+ */
+function visualWidth(str) {
+    return stripAnsiCodes(str).length;
+}
+/**
+ * Calculate the number of physical terminal lines a string occupies.
+ * Accounts for ANSI escape codes (which don't take visual width) and line wrapping.
+ *
+ * @param text - Text to measure (may contain ANSI escape codes)
+ * @param termWidth - Terminal width in columns
+ * @returns Number of physical lines
+ */
+function physicalLineCount(text, termWidth) {
+    if (text.length === 0)
+        return 1; // Empty line still takes 1 line
+    const visLen = visualWidth(text);
+    if (visLen === 0)
+        return 1;
+    // Number of lines = ceil(visLen / termWidth)
+    return Math.ceil(visLen / termWidth);
+}
+/**
+ * Calculate total physical lines for an array of strings (joined with newlines).
+ * Each array entry is a logical line; this returns total physical lines.
+ *
+ * @param lines - Array of lines (may contain ANSI escape codes)
+ * @param termWidth - Terminal width in columns
+ * @returns Total physical line count
+ */
+export function totalPhysicalLines(lines, termWidth) {
+    if (lines.length === 0)
+        return 0;
+    let total = 0;
+    for (const line of lines) {
+        total += physicalLineCount(line, termWidth);
+    }
+    return total;
+}
+// =============================================================================
 // Raw Mode
 // =============================================================================
 /**

package/dist/ui/todo-zone.d.ts

@@ -26,6 +26,7 @@ export declare class TodoZone {
     private thinkingWord;
     private customSpinnerText;
     private animationTimer;
+    private isThinking;
     private onAnimationUpdate;
     constructor(options?: TodoZoneOptions);
     /**
@@ -46,9 +47,25 @@ export declare class TodoZone {
      */
     setSpinnerText(text: string | null): void;
     /**
-     * Add tokens to the counter
+     * Add tokens to the counter (legacy - adds to total)
      */
     addTokens(count: number): void;
+    /**
+     * Add input/output tokens separately (new API for live display)
+     */
+    addTokensDetailed(inputTokens: number, outputTokens: number): void;
+    /**
+     * Get current token counts
+     */
+    getTokenCounts(): {
+        input: number;
+        output: number;
+        total: number;
+    };
+    /**
+     * Set whether extended thinking mode is active
+     */
+    setThinking(thinking: boolean): void;
     /**
      * Set callback for animation updates
      */
@@ -103,6 +120,7 @@ export declare class TodoZone {
     private getDisplayText;
     /**
      * Render the spinner line (when agent running)
+     * Format: ✱ Working... (ctrl+c to interrupt · 1m 23s · ↓ 1.2k ↑ 500 · breakdown · thinking)
      */
     private renderSpinnerLine;
     /**

package/dist/ui/todo-zone.js

@@ -10,35 +10,65 @@
  */
 import chalk from 'chalk';
 import { getStyles } from '../themes/index.js';
+import { formatBreakdownCompact, formatCacheInfo } from '../utils/token-tracker.js';
+import { formatTokens } from './base/index.js';
 // =============================================================================
 // Thinking Words (for random selection when no active todo)
 // =============================================================================
+// Retro-computing themed thinking words (C64, Amiga, Spectrum era vibes)
 const THINKING_WORDS = [
-    'Thinking',
-    'Pondering',
-    'Contemplating',
-    'Ruminating',
-    'Cogitating',
-    'Deliberating',
-    'Musing',
-    'Reflecting',
-    'Considering',
-    'Analyzing',
-    'Processing',
-    'Computing',
-    'Synthesizing',
-    'Extrapolating',
-    'Hypothesizing',
-    'Discombobulating',
-    'Nebulizing',
-    'Percolating',
-    'Marinating',
-    'Simmering',
-    'Brewing',
-    'Fermenting',
-    'Distilling',
-    'Crystallizing',
-    'Transmuting',
+    // Tape/Cassette Era
+    'Rewinding tape',
+    'Loading from cassette',
+    'Seeking track',
+    'Press PLAY on tape',
+    'Fast forwarding',
+    // Floppy/Disk Era
+    'Spinning diskette',
+    'Aligning heads',
+    'Seeking sector',
+    'Ejecting floppy',
+    'Formatting track',
+    'Reading FAT',
+    // CRT/Old Hardware
+    'Degaussing CRT',
+    'Warming tubes',
+    'Adjusting V-HOLD',
+    'Tuning phosphors',
+    'Calibrating beam',
+    'Syncing scanlines',
+    // Memory/System
+    'Paging memory',
+    'Swapping buffers',
+    'Defragmenting',
+    'Poking registers',
+    'Peeking bytes',
+    'Flushing cache',
+    'Allocating heap',
+    // Modem/BBS Era
+    'Dialing BBS',
+    'Waiting for carrier',
+    'Handshaking modem',
+    'Negotiating baud',
+    'Detecting ring',
+    // Terminal/Shell
+    'Parsing commands',
+    'Piping output',
+    'Forking process',
+    'Grepping logs',
+    'Spawning shell',
+    'Sourcing profile',
+    // Classic References
+    'SYS 64738',
+    'LOAD "*",8,1',
+    'Guru meditating',
+    'POKE 53280,0',
+    'RUN/STOP',
+    'Inserting cartridge',
+    // Printer/Peripherals
+    'Feeding paper',
+    'Advancing ribbon',
+    'Parking heads',
 ];
 // =============================================================================
 // Formatting Helpers
@@ -55,15 +85,6 @@ function formatDuration(ms) {
     const remainingSeconds = seconds % 60;
     return `${String(minutes)}m ${String(remainingSeconds)}s`;
 }
-/**
- * Format token count (e.g., "1.2k", "500")
- */
-function formatTokens(tokens) {
-    if (tokens >= 1000) {
-        return `${(tokens / 1000).toFixed(1)}k`;
-    }
-    return tokens.toString();
-}
 // =============================================================================
 // Todo Zone Class
 // =============================================================================
@@ -81,6 +102,7 @@ export class TodoZone {
     thinkingWord = '';
     customSpinnerText = null;
     animationTimer = null;
+    isThinking = false; // Extended thinking mode active
     // Callback for when animation updates (Footer will re-render)
     onAnimationUpdate = null;
     constructor(options = {}) {
@@ -124,13 +146,42 @@ export class TodoZone {
         this.customSpinnerText = text;
     }
     /**
-     * Add tokens to the counter
+     * Add tokens to the counter (legacy - adds to total)
      */
     addTokens(count) {
         if (this.spinnerState) {
             this.spinnerState.tokens += count;
         }
     }
+    /**
+     * Add input/output tokens separately (new API for live display)
+     */
+    addTokensDetailed(inputTokens, outputTokens) {
+        if (this.spinnerState) {
+            this.spinnerState.inputTokens += inputTokens;
+            this.spinnerState.outputTokens += outputTokens;
+            this.spinnerState.tokens += inputTokens + outputTokens;
+        }
+    }
+    /**
+     * Get current token counts
+     */
+    getTokenCounts() {
+        if (this.spinnerState) {
+            return {
+                input: this.spinnerState.inputTokens,
+                output: this.spinnerState.outputTokens,
+                total: this.spinnerState.tokens,
+            };
+        }
+        return { input: 0, output: 0, total: 0 };
+    }
+    /**
+     * Set whether extended thinking mode is active
+     */
+    setThinking(thinking) {
+        this.isThinking = thinking;
+    }
     /**
      * Set callback for animation updates
      */
@@ -220,6 +271,8 @@ export class TodoZone {
         this.spinnerState = {
             text: this.thinkingWord,
             tokens: 0,
+            inputTokens: 0,
+            outputTokens: 0,
             startTime: Date.now(),
         };
         // Reset animation
@@ -282,6 +335,7 @@ export class TodoZone {
     }
     /**
      * Render the spinner line (when agent running)
+     * Format: ✱ Working... (ctrl+c to interrupt · 1m 23s · ↓ 1.2k ↑ 500 · breakdown · thinking)
      */
     renderSpinnerLine() {
         if (!this.spinnerState) {
@@ -289,8 +343,34 @@ export class TodoZone {
         }
         const s = getStyles();
         const elapsed = formatDuration(Date.now() - this.spinnerState.startTime);
-        const tokenStr = formatTokens(this.spinnerState.tokens);
-        const stats = s.muted(` (esc to cancel · ${elapsed} · ↓ ${tokenStr} tokens)`);
+        const inputStr = formatTokens(this.spinnerState.inputTokens);
+        const outputStr = formatTokens(this.spinnerState.outputTokens);
+        // Build status parts (Claude Code style with input/output)
+        const parts = [
+            'ctrl+c to interrupt',
+            elapsed,
+            `↓ ${inputStr} ↑ ${outputStr}`,
+        ];
+        // Add token breakdown if we have input tokens
+        if (this.spinnerState.inputTokens > 0) {
+            // Check for cache info first
+            const cacheInfo = formatCacheInfo();
+            if (cacheInfo) {
+                parts.push(cacheInfo);
+            }
+            else {
+                // Show component breakdown
+                const breakdown = formatBreakdownCompact();
+                if (breakdown) {
+                    parts.push(breakdown);
+                }
+            }
+        }
+        // Add "thinking" indicator when extended thinking is active
+        if (this.isThinking) {
+            parts.push('thinking');
+        }
+        const stats = s.muted(` (${parts.join(' · ')})`);
         // Determine display text - tool name or thinking word
         const displayText = this.currentTool
             ? `● ${this.currentTool}`
@@ -331,10 +411,16 @@ export class TodoZone {
         for (const todo of this.todos) {
             let checkbox;
             let text;
+            let ownerBadge = '';
+            // Format owner badge
+            if (todo.owner) {
+                ownerBadge = s.muted(` @${todo.owner}`);
+            }
             switch (todo.status) {
                 case 'completed':
                     checkbox = s.muted('☒');
                     text = chalk.strikethrough(s.muted(todo.content));
+                    ownerBadge = ''; // Don't show owner for completed items
                     break;
                 case 'in_progress':
                     checkbox = s.primary('☐');
@@ -346,7 +432,7 @@ export class TodoZone {
                     text = s.muted(todo.content);
                     break;
             }
-            lines.push(`${indent}${checkbox} ${text}`);
+            lines.push(`${indent}${checkbox} ${text}${ownerBadge}`);
         }
         return lines;
     }

package/dist/ui/tool-formatters.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tool Result Formatters
+ *
+ * Extracts content, summary, and success from tool results.
+ * Each tool type has its own formatter to produce human-readable output.
+ */
+export interface FormattedResult {
+    content: string;
+    summary: string;
+    success: boolean;
+}
+/**
+ * Format tool result for display.
+ * Handles the agent's structured result format.
+ */
+export declare function formatToolResult(toolName: string, result: unknown): FormattedResult;