erosolar-cli 1.7.344 → 1.7.346

package/dist/shell/claudeCodeStreamHandler.js

@@ -0,0 +1,322 @@
+/**
+ * ClaudeCodeStreamHandler - Complete streaming I/O handler following Claude Code's approach
+ *
+ * This module combines StreamingOutputManager and InputQueueManager to provide
+ * the complete Claude Code streaming experience:
+ *
+ * 1. Natural Output Flow
+ *    - Streaming output just writes to stdout normally
+ *    - Cursor stays where it is after each write
+ *    - Lines scroll up naturally as new content appears
+ *    - NO scroll regions, NO save/restore cursor during streaming
+ *
+ * 2. Readline Handles Input
+ *    - Uses Node.js readline module
+ *    - Input prompt naturally moves up as output streams above it
+ *    - User can type while streaming - input is queued in memory, not rendered
+ *
+ * 3. Queue-Based Approach
+ *    User types during streaming → Input stored in queue → Processed after streaming ends
+ *
+ * 4. The Key Insight
+ *    The cursor is NEVER moved during streaming. Output just appends at current position.
+ *    The "input at bottom" effect comes from:
+ *    - New output pushes older content (including the prompt) upward
+ *    - After streaming ends, a new prompt is shown at the bottom
+ */
+import * as readline from 'node:readline';
+import { EventEmitter } from 'node:events';
+import { getStreamingOutputManager } from './streamingOutputManager.js';
+import { getInputQueueManager } from './inputQueueManager.js';
+import { writeLock } from '../ui/writeLock.js';
+/**
+ * Coordinates streaming output and queued input for Claude Code style UX.
+ */
+export class ClaudeCodeStreamHandler extends EventEmitter {
+    outputManager;
+    inputManager;
+    writeStream;
+    readStream;
+    rl = null;
+    keypressHandler = null;
+    originalStdoutWrite = null;
+    isOutputSuppressed = false;
+    constructor(writeStream = process.stdout, readStream = process.stdin) {
+        super();
+        this.writeStream = writeStream;
+        this.readStream = readStream;
+        this.outputManager = getStreamingOutputManager();
+        this.inputManager = getInputQueueManager();
+        // Forward events
+        this.inputManager.on('input-queued', (input) => {
+            this.emit('input-queued', input);
+        });
+    }
+    /**
+     * Attach to an existing readline interface
+     * Call this after creating your readline.Interface
+     */
+    attachToReadline(rl) {
+        this.rl = rl;
+        this.setupKeypressCapture();
+    }
+    /**
+     * Set up keypress capturing for queued input during streaming
+     */
+    setupKeypressCapture() {
+        if (!this.readStream || !this.readStream.isTTY) {
+            return;
+        }
+        // Enable keypress events if not already enabled
+        if (this.readStream.listenerCount('keypress') === 0 && this.rl) {
+            readline.emitKeypressEvents(this.readStream, this.rl);
+        }
+        // Ensure raw mode for keypress events
+        if (this.readStream.setRawMode && !this.readStream.isRaw) {
+            this.readStream.setRawMode(true);
+        }
+        this.keypressHandler = (_str, key) => {
+            // Only capture when streaming
+            if (!this.outputManager.isStreaming() || !this.inputManager.isCapturing()) {
+                return;
+            }
+            // Handle special keys
+            if (key) {
+                // Ctrl+C - interrupt
+                if (key.ctrl && key.name === 'c') {
+                    this.inputManager.handleInterrupt();
+                    return;
+                }
+                // Enter - submit queued input
+                if (key.name === 'return' || key.name === 'enter') {
+                    this.inputManager.handleSubmit();
+                    return;
+                }
+                // Backspace
+                if (key.name === 'backspace') {
+                    this.inputManager.handleBackspace();
+                    return;
+                }
+                // Delete
+                if (key.name === 'delete') {
+                    this.inputManager.handleDelete();
+                    return;
+                }
+                // Arrow keys
+                if (key.name === 'left') {
+                    this.inputManager.handleCursorLeft();
+                    return;
+                }
+                if (key.name === 'right') {
+                    this.inputManager.handleCursorRight();
+                    return;
+                }
+                // Ignore other control sequences during capture
+                if (key.ctrl || key.meta) {
+                    return;
+                }
+            }
+            // Regular character input
+            if (_str && _str.length > 0 && !key?.ctrl && !key?.meta) {
+                this.inputManager.handleChar(_str);
+            }
+        };
+        this.readStream.prependListener('keypress', this.keypressHandler);
+    }
+    /**
+     * Begin streaming mode
+     *
+     * Claude Code approach:
+     * - Start capturing input to queue
+     * - Suppress readline echo (characters typed go to queue, not screen)
+     * - Output flows naturally to stdout
+     */
+    startStreaming() {
+        if (this.outputManager.isStreaming()) {
+            return;
+        }
+        // Start both managers
+        this.outputManager.startStream();
+        this.inputManager.startCapturing();
+        // Suppress readline's output so typed characters don't appear
+        this.suppressReadlineOutput();
+        this.emit('streaming-start');
+    }
+    /**
+     * End streaming mode
+     *
+     * Claude Code approach:
+     * - Stop capturing (any remaining buffer is preserved)
+     * - Restore readline echo
+     * - Return streaming statistics
+     */
+    endStreaming() {
+        // Get remaining buffer before stopping capture
+        const remainingBuffer = this.inputManager.stopCapturing();
+        // If there's unsubmitted content in buffer, preserve it for next prompt
+        if (remainingBuffer && remainingBuffer.trim()) {
+            // The remaining buffer will be shown when readline prompts again
+            // We could queue it, but leaving it as-is is more intuitive
+        }
+        // Restore readline output
+        this.restoreReadlineOutput();
+        // End output streaming
+        const stats = this.outputManager.endStream();
+        const result = {
+            ...stats,
+            queuedInputs: this.inputManager.getQueueLength(),
+        };
+        this.emit('streaming-end', stats);
+        return result;
+    }
+    /**
+     * Write content during streaming
+     * Just writes naturally to stdout - no cursor manipulation
+     */
+    write(content) {
+        this.outputManager.writeChunk(content);
+    }
+    /**
+     * Write a complete line during streaming
+     */
+    writeLine(line = '') {
+        this.outputManager.writeLine(line);
+    }
+    /**
+     * Check if currently streaming
+     */
+    isStreaming() {
+        return this.outputManager.isStreaming();
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        const outputStats = this.outputManager.getStats();
+        return {
+            isStreaming: this.outputManager.isStreaming(),
+            queuedCount: this.inputManager.getQueueLength(),
+            charsWritten: outputStats.chars,
+            linesWritten: outputStats.lines,
+            elapsedMs: outputStats.elapsed,
+        };
+    }
+    /**
+     * Check if there are queued inputs to process
+     */
+    hasQueuedInput() {
+        return this.inputManager.hasQueuedInput();
+    }
+    /**
+     * Get the next queued input
+     */
+    getNextQueuedInput() {
+        return this.inputManager.dequeue();
+    }
+    /**
+     * Get all queued inputs
+     */
+    getAllQueuedInputs() {
+        return this.inputManager.getQueue();
+    }
+    /**
+     * Clear all queued inputs
+     */
+    clearQueue() {
+        this.inputManager.clearQueue();
+    }
+    /**
+     * Get queue summary for display
+     */
+    getQueueSummary() {
+        return this.inputManager.getQueueSummary();
+    }
+    /**
+     * Suppress readline's output during streaming
+     * Characters typed will be captured but not displayed
+     */
+    suppressReadlineOutput() {
+        if (this.isOutputSuppressed) {
+            return;
+        }
+        // Save original write function
+        this.originalStdoutWrite = this.writeStream.write.bind(this.writeStream);
+        // Replace with filtered version that suppresses readline echo
+        const outputManager = this.outputManager;
+        const originalWrite = this.originalStdoutWrite;
+        this.writeStream.write = function (chunk, encodingOrCallback, callback) {
+            const text = typeof chunk === 'string' ? chunk : chunk.toString();
+            // During streaming, only allow output from the streaming manager
+            // Suppress readline's echo of typed characters (single character writes)
+            if (outputManager.isStreaming()) {
+                // Allow newlines and multi-character writes (likely streaming content)
+                if (text.length === 1 && !text.includes('\n') && !text.includes('\r')) {
+                    // Single character during streaming - likely user typing, suppress it
+                    if (typeof encodingOrCallback === 'function') {
+                        encodingOrCallback(null);
+                        return true;
+                    }
+                    if (callback) {
+                        callback(null);
+                    }
+                    return true;
+                }
+            }
+            // Pass through everything else
+            // If lock is already held, write directly - we're in a protected context
+            // This prevents queuing issues where content gets delayed during streaming
+            if (writeLock.isLocked()) {
+                return originalWrite(chunk, encodingOrCallback, callback);
+            }
+            let result = true;
+            writeLock.withLock(() => {
+                result = originalWrite(chunk, encodingOrCallback, callback);
+            }, 'claudeCodeStreamHandler.stdout');
+            return result;
+        };
+        this.isOutputSuppressed = true;
+    }
+    /**
+     * Restore readline's normal output
+     */
+    restoreReadlineOutput() {
+        if (!this.isOutputSuppressed || !this.originalStdoutWrite) {
+            return;
+        }
+        this.writeStream.write = this.originalStdoutWrite;
+        this.originalStdoutWrite = null;
+        this.isOutputSuppressed = false;
+    }
+    /**
+     * Cleanup when done
+     */
+    dispose() {
+        // Restore output if suppressed
+        this.restoreReadlineOutput();
+        // Remove keypress handler
+        if (this.keypressHandler && this.readStream) {
+            this.readStream.off('keypress', this.keypressHandler);
+            this.keypressHandler = null;
+        }
+        // Clear queue
+        this.inputManager.clearQueue();
+        this.rl = null;
+    }
+}
+/**
+ * Singleton instance for global use
+ */
+let globalInstance = null;
+export function getClaudeCodeStreamHandler() {
+    if (!globalInstance) {
+        globalInstance = new ClaudeCodeStreamHandler();
+    }
+    return globalInstance;
+}
+export function resetClaudeCodeStreamHandler() {
+    if (globalInstance) {
+        globalInstance.dispose();
+    }
+    globalInstance = null;
+}
+//# sourceMappingURL=claudeCodeStreamHandler.js.map

package/dist/shell/claudeCodeStreamHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeCodeStreamHandler.js","sourceRoot":"","sources":["../../src/shell/claudeCodeStreamHandler.ts"],"names":[],"mappings":"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"}

package/dist/shell/inputQueueManager.d.ts

@@ -0,0 +1,144 @@
+/**
+ * InputQueueManager - Queue-based input handling for Claude Code style streaming
+ *
+ * Key principles from Claude Code:
+ * 1. Readline handles input - Uses Node.js readline module
+ * 2. User can type while streaming - Input is queued in memory, not rendered
+ * 3. Queue-based approach: User types → stored in queue → processed after streaming ends
+ *
+ * The key insight is that the cursor is never moved during streaming.
+ * Input is captured "invisibly" while streaming, then processed when streaming ends.
+ */
+import { EventEmitter } from 'node:events';
+export interface QueuedInput {
+    id: string;
+    text: string;
+    timestamp: number;
+    type: 'message' | 'command' | 'interrupt';
+}
+export interface InputQueueState {
+    isCapturing: boolean;
+    buffer: string;
+    cursorPosition: number;
+    queue: QueuedInput[];
+}
+export interface InputQueueEvents {
+    'input-queued': (input: QueuedInput) => void;
+    'input-processed': (input: QueuedInput) => void;
+    'queue-cleared': () => void;
+    'capture-start': () => void;
+    'capture-end': () => void;
+}
+/**
+ * Manages input queuing during streaming output.
+ *
+ * When streaming is active:
+ * - Captures keystrokes into a buffer
+ * - On Enter, queues the input for later processing
+ * - Provides methods to process queue after streaming ends
+ */
+export declare class InputQueueManager extends EventEmitter {
+    private state;
+    private inputIdCounter;
+    private readonly maxQueueSize;
+    private readonly maxBufferLength;
+    constructor(options?: {
+        maxQueueSize?: number;
+        maxBufferLength?: number;
+    });
+    /**
+     * Start capturing input (during streaming)
+     * Input will be buffered and queued, not immediately processed
+     */
+    startCapturing(): void;
+    /**
+     * Stop capturing input (after streaming ends)
+     * Returns any remaining buffer content
+     */
+    stopCapturing(): string;
+    /**
+     * Check if currently capturing input
+     */
+    isCapturing(): boolean;
+    /**
+     * Handle a character input
+     * During capturing, adds to buffer; otherwise ignored
+     */
+    handleChar(char: string): void;
+    /**
+     * Handle backspace
+     */
+    handleBackspace(): void;
+    /**
+     * Handle delete key
+     */
+    handleDelete(): void;
+    /**
+     * Handle cursor left
+     */
+    handleCursorLeft(): void;
+    /**
+     * Handle cursor right
+     */
+    handleCursorRight(): void;
+    /**
+     * Handle Enter - queue the current buffer
+     * Returns the queued input or null if buffer was empty
+     */
+    handleSubmit(): QueuedInput | null;
+    /**
+     * Handle Ctrl+C during capture - queue an interrupt
+     */
+    handleInterrupt(): QueuedInput;
+    /**
+     * Get current buffer contents (for display purposes)
+     */
+    getBuffer(): string;
+    /**
+     * Get current cursor position
+     */
+    getCursorPosition(): number;
+    /**
+     * Get the number of queued inputs
+     */
+    getQueueLength(): number;
+    /**
+     * Check if there are queued inputs
+     */
+    hasQueuedInput(): boolean;
+    /**
+     * Get the next queued input without removing it
+     */
+    peekQueue(): QueuedInput | undefined;
+    /**
+     * Get and remove the next queued input
+     */
+    dequeue(): QueuedInput | undefined;
+    /**
+     * Get all queued inputs (copy)
+     */
+    getQueue(): QueuedInput[];
+    /**
+     * Clear all queued inputs
+     */
+    clearQueue(): void;
+    /**
+     * Clear the current buffer
+     */
+    clearBuffer(): void;
+    /**
+     * Set the buffer content directly (for paste handling)
+     */
+    setBuffer(content: string, cursorPos?: number): void;
+    /**
+     * Get queue summary for display
+     */
+    getQueueSummary(): string;
+    /**
+     * Get full state (for debugging)
+     */
+    getState(): InputQueueState;
+}
+export declare function getInputQueueManager(): InputQueueManager;
+export declare function resetInputQueueManager(): void;
+//# sourceMappingURL=inputQueueManager.d.ts.map

package/dist/shell/inputQueueManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputQueueManager.d.ts","sourceRoot":"","sources":["../../src/shell/inputQueueManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,iBAAiB,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,KAAK,CAKX;IAEF,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAO;IAM7E;;;OAGG;IACH,cAAc,IAAI,IAAI;IAYtB;;;OAGG;IACH,aAAa,IAAI,MAAM;IAWvB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkB9B;;OAEG;IACH,eAAe,IAAI,IAAI;IAWvB;;OAEG;IACH,YAAY,IAAI,IAAI;IAUpB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAKxB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAKzB;;;OAGG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IAoClC;;OAEG;IACH,eAAe,IAAI,WAAW;IAiB9B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,SAAS,IAAI,WAAW,GAAG,SAAS;IAIpC;;OAEG;IACH,OAAO,IAAI,WAAW,GAAG,SAAS;IAQlC;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACH,UAAU,IAAI,IAAI;IASlB;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,eAAe,IAAI,MAAM;IAwBzB;;OAEG;IACH,QAAQ,IAAI,eAAe;CAG5B;AAOD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAKxD;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}