cc-face 0.1.10

package/dist/src/main.js

@@ -0,0 +1,210 @@
+import { spawnClaude } from './pty.js';
+import { StateMachine } from './state.js';
+import { FaceRenderer } from './face.js';
+import { getTheme } from './theme.js';
+import { initGenerator, buildFace } from './loader.js';
+import { StateServer, StateClient, getSocketPath, writeDiscovery, readDiscovery, clearDiscovery } from './ipc.js';
+// ── Required expression keys ────────────────────────────────────────
+const REQUIRED_EXPRESSIONS = ['idle', 'typing', 'thinking', 'listening'];
+// ── Face validation ─────────────────────────────────────────────────
+function validateFace(face) {
+    if (!face.name || typeof face.name !== 'string') {
+        throw new Error('Face definition must have a "name" string property.');
+    }
+    if (typeof face.width !== 'number' || face.width <= 0) {
+        throw new Error('Face definition must have a positive "width" number.');
+    }
+    if (typeof face.height !== 'number' || face.height <= 0) {
+        throw new Error('Face definition must have a positive "height" number.');
+    }
+    if (!face.expressions || typeof face.expressions !== 'object') {
+        throw new Error('Face definition must have an "expressions" object.');
+    }
+    // Check all required expression keys are present
+    for (const key of REQUIRED_EXPRESSIONS) {
+        if (!(key in face.expressions)) {
+            throw new Error(`Face definition is missing required expression "${key}". ` +
+                `Required expressions: ${REQUIRED_EXPRESSIONS.join(', ')}.`);
+        }
+        const expr = face.expressions[key];
+        if (!expr.frames || !Array.isArray(expr.frames) || expr.frames.length === 0) {
+            throw new Error(`Expression "${key}" must have a non-empty "frames" array.`);
+        }
+        // Validate animation config
+        const config = expr.config;
+        if (!config || typeof config !== 'object') {
+            throw new Error(`Expression "${key}" must have a "config" object.`);
+        }
+        if (typeof config.loopDuration !== 'number' || config.loopDuration <= 0) {
+            throw new Error(`Expression "${key}": config.loopDuration must be a positive number.`);
+        }
+        if (typeof config.gap !== 'number' || config.gap < 0) {
+            throw new Error(`Expression "${key}": config.gap must be a non-negative number.`);
+        }
+        if (typeof config.reverse !== 'boolean') {
+            throw new Error(`Expression "${key}": config.reverse must be a boolean.`);
+        }
+        // Validate each frame
+        for (let i = 0; i < expr.frames.length; i++) {
+            const frame = expr.frames[i];
+            if (!frame.art || !Array.isArray(frame.art)) {
+                throw new Error(`Expression "${key}", frame ${i}: must have an "art" array of strings.`);
+            }
+        }
+    }
+}
+// ── Load face definition ────────────────────────────────────────────
+async function loadFace(facePath) {
+    if (facePath) {
+        try {
+            const imported = await import(facePath);
+            const face = imported.default ?? imported.face ?? imported;
+            validateFace(face);
+            return face;
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                throw new Error(`Failed to load face from "${facePath}": ${err.message}`);
+            }
+            throw err;
+        }
+    }
+    const cols = process.stdout.columns ?? 80;
+    const rows = process.stdout.rows ?? 24;
+    return buildFace(cols, rows);
+}
+// ── Main entry point ────────────────────────────────────────────────
+export async function run(options) {
+    await initGenerator();
+    // ── Face-only mode ──────────────────────────────────────────────
+    if (options.displayOnly) {
+        return runFaceOnly(options);
+    }
+    // ── Load face ───────────────────────────────────────────────────
+    const face = await loadFace(options.facePath);
+    // ── --no-face mode (plain passthrough) ──────────────────────────
+    if (options.noFace) {
+        const cols = process.stdout.columns ?? 80;
+        const rows = process.stdout.rows ?? 24;
+        const pty = spawnClaude(cols, rows, []);
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on('data', (data) => pty.write(data.toString()));
+        pty.onData((data) => process.stdout.write(data));
+        pty.onExit(({ exitCode }) => {
+            process.stdin.setRawMode(false);
+            process.exit(exitCode);
+        });
+        return;
+    }
+    // ── Wrapper mode (default) ──────────────────────────────────────
+    // Start IPC server
+    const socketPath = getSocketPath();
+    const server = new StateServer(socketPath);
+    writeDiscovery(socketPath);
+    process.stderr.write(`Face server listening. In another terminal run: cc-face -display\n`);
+    // Spawn Claude PTY at full terminal size
+    const cols = process.stdout.columns ?? 80;
+    const rows = process.stdout.rows ?? 24;
+    const pty = spawnClaude(cols, rows, []);
+    // State machine — broadcast state changes over IPC
+    const stateMachine = new StateMachine((event) => {
+        server.broadcast(event.next);
+    });
+    // Wire PTY data → stdout + state machine
+    pty.onData((data) => {
+        process.stdout.write(data);
+        stateMachine.feed(data);
+    });
+    // Wire stdin → PTY + notify state machine of human input
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on('data', (data) => {
+        stateMachine.notifyHumanInput();
+        pty.write(data.toString());
+    });
+    // Handle SIGWINCH (terminal resize)
+    process.on('SIGWINCH', () => {
+        const newCols = process.stdout.columns ?? 80;
+        const newRows = process.stdout.rows ?? 24;
+        pty.resize(newCols, newRows);
+    });
+    // Cleanup (guarded against double invocation from concurrent signals)
+    let cleaned = false;
+    const cleanup = () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        stateMachine.destroy();
+        server.broadcastShutdown();
+        clearDiscovery(socketPath);
+        server.close();
+        try {
+            process.stdin.setRawMode(false);
+        }
+        catch {
+            // stdin may already be destroyed
+        }
+    };
+    pty.onExit(({ exitCode }) => {
+        cleanup();
+        process.exit(exitCode);
+    });
+    process.on('SIGINT', () => {
+        cleanup();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        cleanup();
+        process.exit(0);
+    });
+}
+// ── Face-only mode ──────────────────────────────────────────────────
+async function runFaceOnly(options) {
+    const face = await loadFace(options.facePath);
+    const theme = getTheme(options.theme);
+    const renderer = new FaceRenderer(face, theme);
+    // If --sock given, use it directly. Otherwise, discover via the active file.
+    const socketPathOrResolver = options.socketPath
+        ? options.socketPath
+        : () => readDiscovery();
+    renderer.showMessage('Waiting for cc-face...');
+    // Connect to wrapper's IPC server
+    const client = new StateClient(socketPathOrResolver, (state) => {
+        renderer.setState(state);
+    }, {
+        onDisconnect() {
+            renderer.showMessage('Disconnected. Waiting for cc-face...');
+        },
+        onConnect() {
+            renderer.setState('idle');
+        },
+        onShutdown() {
+            renderer.destroy();
+            client.close();
+            process.exit(0);
+        },
+    });
+    // Handle resize — invalidate pre-rendered frame cache
+    process.on('SIGWINCH', () => {
+        renderer.invalidateCache();
+    });
+    // Cleanup (guarded against double invocation from concurrent signals)
+    let cleaned = false;
+    const cleanup = () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        renderer.destroy();
+        client.close();
+    };
+    process.on('SIGINT', () => {
+        cleanup();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        cleanup();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/src/main.js.map

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

package/dist/src/patterns.d.ts

@@ -0,0 +1,6 @@
+import { FaceState } from './types.js';
+export interface PatternEntry {
+    state: FaceState;
+    patterns: RegExp[];
+}
+export declare const realtimePatterns: PatternEntry[];

package/dist/src/patterns.js

@@ -0,0 +1,14 @@
+// ── Realtime Patterns ────────────────────────────────────────────────
+// Checked during streaming (each feed() call). Priority = array order.
+export const realtimePatterns = [
+    {
+        state: 'thinking',
+        patterns: [
+            /[⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏]/, // braille spinners
+            /[·✢✳✶✻✽]/, // tweakcc phases
+            /Thinking/,
+            /Reasoning/,
+        ],
+    },
+];
+//# sourceMappingURL=patterns.js.map

package/dist/src/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../src/patterns.ts"],"names":[],"mappings":"AASA,wEAAwE;AACxE,uEAAuE;AAEvE,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C;QACE,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE;YACR,cAAc,EAAK,mBAAmB;YACtC,UAAU,EAAe,iBAAiB;YAC1C,UAAU;YACV,WAAW;SACZ;KACF;CACF,CAAC"}

package/dist/src/pty.d.ts

@@ -0,0 +1,17 @@
+export interface PtyHandle {
+    onData(cb: (data: string) => void): void;
+    onExit(cb: (exit: {
+        exitCode: number;
+        signal?: number;
+    }) => void): void;
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    kill(): void;
+    pid: number;
+}
+export declare function findClaude(): string;
+export declare function resolveSymlink(p: string): string | null;
+/**
+ * Spawn `claude` CLI in a pseudo-terminal.
+ */
+export declare function spawnClaude(cols: number, rows: number, args?: string[]): PtyHandle;

package/dist/src/pty.js

@@ -0,0 +1,84 @@
+import * as pty from 'node-pty';
+import { accessSync, constants, readlinkSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+export function findClaude() {
+    // 1. Explicit override via env var
+    if (process.env.CLAUDE_PATH)
+        return process.env.CLAUDE_PATH;
+    if (process.platform === 'win32')
+        return 'cmd.exe';
+    // 2. Resolve via user's login shell (picks up ~/.local/bin etc.)
+    try {
+        const resolved = execSync('which claude', { encoding: 'utf-8', env: process.env }).trim();
+        if (resolved)
+            return resolved;
+    }
+    catch { /* fall through */ }
+    // 3. Check common install locations
+    const home = process.env.HOME ?? '';
+    const candidates = [
+        `${home}/.local/bin/claude`,
+        '/usr/local/bin/claude',
+        '/opt/homebrew/bin/claude',
+    ];
+    for (const p of candidates) {
+        try {
+            accessSync(p, constants.X_OK);
+            return p;
+        }
+        catch { /* next */ }
+    }
+    throw new Error('Could not find "claude" CLI. Ensure Claude Code is installed and on your PATH,\n' +
+        'or set CLAUDE_PATH=/path/to/claude.');
+}
+export function resolveSymlink(p) {
+    try {
+        return readlinkSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Spawn `claude` CLI in a pseudo-terminal.
+ */
+export function spawnClaude(cols, rows, args = []) {
+    const claudePath = findClaude();
+    const shellArgs = process.platform === 'win32' ? ['/c', 'claude', ...args] : args;
+    let proc;
+    try {
+        proc = pty.spawn(claudePath, shellArgs, {
+            name: 'xterm-256color',
+            cols,
+            rows,
+            cwd: process.cwd(),
+            env: process.env,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to spawn PTY for "${claudePath}": ${msg}\n` +
+            `Tip: verify with: ls -la ${claudePath} && ${claudePath} --version`);
+    }
+    return {
+        onData(cb) {
+            proc.onData(cb);
+        },
+        onExit(cb) {
+            proc.onExit(cb);
+        },
+        write(data) {
+            proc.write(data);
+        },
+        resize(c, r) {
+            proc.resize(c, r);
+        },
+        kill() {
+            proc.kill();
+        },
+        get pid() {
+            return proc.pid;
+        },
+    };
+}
+//# sourceMappingURL=pty.js.map

package/dist/src/pty.js.map

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

package/dist/src/scroll.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ANSI scroll-region management.
+ *
+ * Uses DECSTBM (`ESC [ top ; bottom r`) to split the terminal into a
+ * fixed face region at the top and a scrollable content region below.
+ */
+export interface ScrollDimensions {
+    faceRows: number;
+    contentRows: number;
+    totalRows: number;
+    totalCols: number;
+}
+/**
+ * Return current terminal dimensions split by face height.
+ */
+export declare function getScrollDimensions(faceHeight: number): ScrollDimensions;
+/**
+ * Set the terminal scroll region so that the top `faceHeight` rows are
+ * fixed and only the rows below them scroll.
+ *
+ * Returns a cleanup function that resets the scroll region.
+ */
+export declare function setupScrollRegion(faceHeight: number): () => void;
+/**
+ * Reset scroll region to the full terminal and show cursor.
+ */
+export declare function teardownScrollRegion(): void;
+/**
+ * Save cursor position and move to row 0, col 0 (top-left) for face
+ * rendering.  Uses 1-indexed ANSI coordinates.
+ */
+export declare function moveCursorToFace(): void;
+/**
+ * Restore the previously saved cursor position.
+ */
+export declare function restoreCursor(): void;

package/dist/src/scroll.js

@@ -0,0 +1,56 @@
+/**
+ * ANSI scroll-region management.
+ *
+ * Uses DECSTBM (`ESC [ top ; bottom r`) to split the terminal into a
+ * fixed face region at the top and a scrollable content region below.
+ */
+/**
+ * Return current terminal dimensions split by face height.
+ */
+export function getScrollDimensions(faceHeight) {
+    const totalRows = process.stdout.rows ?? 24;
+    const totalCols = process.stdout.columns ?? 80;
+    const faceRows = faceHeight;
+    const contentRows = totalRows - faceHeight;
+    return { faceRows, contentRows, totalRows, totalCols };
+}
+/**
+ * Set the terminal scroll region so that the top `faceHeight` rows are
+ * fixed and only the rows below them scroll.
+ *
+ * Returns a cleanup function that resets the scroll region.
+ */
+export function setupScrollRegion(faceHeight) {
+    const { totalRows } = getScrollDimensions(faceHeight);
+    // DECSTBM: set scroll region from (faceHeight+1) to totalRows (1-indexed)
+    process.stdout.write(`\x1b[${faceHeight + 1};${totalRows}r`);
+    // Move cursor to the first row of the content area
+    process.stdout.write(`\x1b[${faceHeight + 1};1H`);
+    return teardownScrollRegion;
+}
+/**
+ * Reset scroll region to the full terminal and show cursor.
+ */
+export function teardownScrollRegion() {
+    // Reset scroll region
+    process.stdout.write('\x1b[r');
+    // Show cursor
+    process.stdout.write('\x1b[?25h');
+}
+/**
+ * Save cursor position and move to row 0, col 0 (top-left) for face
+ * rendering.  Uses 1-indexed ANSI coordinates.
+ */
+export function moveCursorToFace() {
+    // Save cursor position
+    process.stdout.write('\x1b7');
+    // Move to row 1, col 1 (top-left, 1-indexed)
+    process.stdout.write('\x1b[1;1H');
+}
+/**
+ * Restore the previously saved cursor position.
+ */
+export function restoreCursor() {
+    process.stdout.write('\x1b8');
+}
+//# sourceMappingURL=scroll.js.map

package/dist/src/scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.js","sourceRoot":"","sources":["../../src/scroll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC;IAC5B,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAE3C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEtD,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,UAAU,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;IAE7D,mDAAmD;IACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,UAAU,GAAG,CAAC,KAAK,CAAC,CAAC;IAElD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,sBAAsB;IACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,cAAc;IACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,uBAAuB;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/state.d.ts

@@ -0,0 +1,36 @@
+import { FaceState, StateEvent } from './types.js';
+export declare class StateMachine {
+    private state;
+    private idleTimer;
+    private debounceTimer;
+    private feedTimer;
+    private listeningTimer;
+    private onStateChange;
+    private pendingData;
+    private hasPendingData;
+    private lastThinkingMatchTime;
+    private hasReceivedHumanInput;
+    constructor(onStateChange: (event: StateEvent) => void);
+    getState(): FaceState;
+    /**
+     * Called when the human presses a key. Transitions to 'listening'
+     * and resets the listening timeout. When the user stops typing for
+     * LISTENING_TIMEOUT_MS, transitions back to idle.
+     */
+    notifyHumanInput(): void;
+    /**
+     * Feed raw PTY data. Instead of processing every chunk synchronously
+     * (hundreds of regex ops + timer create/destroy per second during heavy
+     * output), we accumulate data and process it at a fixed sample rate.
+     * This adds up to 50ms of detection latency, which is imperceptible
+     * given the 100ms debounce on output.
+     */
+    feed(data: string): void;
+    destroy(): void;
+    /**
+     * Process accumulated data: strip ANSI once for the whole batch,
+     * run pattern matching once, check for typing once.
+     */
+    private processPendingData;
+    private transition;
+}

package/dist/src/state.js

@@ -0,0 +1,164 @@
+import { stripAnsi } from './utils.js';
+import { realtimePatterns } from './patterns.js';
+import { config } from './config.js';
+// ── Timeout constants ────────────────────────────────────────────────
+const { idleTimeoutMs: IDLE_TIMEOUT_MS, debounceMs: DEBOUNCE_MS, feedSampleIntervalMs: FEED_SAMPLE_INTERVAL_MS, minPrintableLen: MIN_PRINTABLE_LEN, thinkingCooldownMs: THINKING_COOLDOWN_MS, listeningTimeoutMs: LISTENING_TIMEOUT_MS, } = config;
+// ── Helper: match against a pattern list (first match wins) ─────────
+function matchPatterns(text, entries) {
+    for (const entry of entries) {
+        for (const re of entry.patterns) {
+            if (re.test(text)) {
+                return entry;
+            }
+        }
+    }
+    return null;
+}
+// ── State Machine ────────────────────────────────────────────────────
+export class StateMachine {
+    state = 'idle';
+    idleTimer = null;
+    debounceTimer = null;
+    feedTimer = null;
+    listeningTimer = null;
+    onStateChange;
+    // Accumulated PTY data between processing ticks
+    pendingData = '';
+    hasPendingData = false;
+    // Timestamp of last thinking pattern match — used to suppress
+    // typing transitions during the thinking cooldown window
+    lastThinkingMatchTime = 0;
+    // Suppress typing transitions until the user has pressed a key.
+    // Prevents Claude's startup banner from triggering the typing state.
+    hasReceivedHumanInput = false;
+    constructor(onStateChange) {
+        this.onStateChange = onStateChange;
+    }
+    getState() {
+        return this.state;
+    }
+    /**
+     * Called when the human presses a key. Transitions to 'listening'
+     * and resets the listening timeout. When the user stops typing for
+     * LISTENING_TIMEOUT_MS, transitions back to idle.
+     */
+    notifyHumanInput() {
+        this.hasReceivedHumanInput = true;
+        // Don't override thinking/typing — Claude is actively doing something
+        if (this.state === 'thinking' || this.state === 'typing')
+            return;
+        this.transition('listening');
+        // Reset listening timeout
+        if (this.listeningTimer !== null)
+            clearTimeout(this.listeningTimer);
+        this.listeningTimer = setTimeout(() => {
+            this.listeningTimer = null;
+            if (this.state === 'listening') {
+                this.transition('idle');
+            }
+        }, LISTENING_TIMEOUT_MS);
+    }
+    /**
+     * Feed raw PTY data. Instead of processing every chunk synchronously
+     * (hundreds of regex ops + timer create/destroy per second during heavy
+     * output), we accumulate data and process it at a fixed sample rate.
+     * This adds up to 50ms of detection latency, which is imperceptible
+     * given the 100ms debounce on output.
+     */
+    feed(data) {
+        if (data.length === 0)
+            return;
+        this.pendingData += data;
+        this.hasPendingData = true;
+        // Reset idle timer on every chunk (this is cheap — just a clear + set)
+        if (this.idleTimer !== null)
+            clearTimeout(this.idleTimer);
+        this.idleTimer = setTimeout(() => {
+            this.idleTimer = null;
+            this.transition('idle');
+        }, IDLE_TIMEOUT_MS);
+        // Schedule processing if not already pending
+        if (this.feedTimer === null) {
+            this.feedTimer = setTimeout(() => this.processPendingData(), FEED_SAMPLE_INTERVAL_MS);
+        }
+    }
+    // ── Cleanup ──────────────────────────────────────────────────────
+    destroy() {
+        if (this.idleTimer !== null) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+        if (this.debounceTimer !== null) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        if (this.feedTimer !== null) {
+            clearTimeout(this.feedTimer);
+            this.feedTimer = null;
+        }
+        if (this.listeningTimer !== null) {
+            clearTimeout(this.listeningTimer);
+            this.listeningTimer = null;
+        }
+        this.pendingData = '';
+        this.hasPendingData = false;
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    /**
+     * Process accumulated data: strip ANSI once for the whole batch,
+     * run pattern matching once, check for typing once.
+     */
+    processPendingData() {
+        this.feedTimer = null;
+        if (!this.hasPendingData)
+            return;
+        const raw = this.pendingData;
+        this.pendingData = '';
+        this.hasPendingData = false;
+        const clean = stripAnsi(raw);
+        // Realtime pattern matching (priority order)
+        const match = matchPatterns(clean, realtimePatterns);
+        if (match) {
+            if (match.state === 'thinking') {
+                this.lastThinkingMatchTime = Date.now();
+            }
+            // Cancel listening state — Claude is responding
+            if (this.listeningTimer !== null) {
+                clearTimeout(this.listeningTimer);
+                this.listeningTimer = null;
+            }
+            this.transition(match.state);
+            return;
+        }
+        // "typing" — non-trivial printable text from Claude (not human echo).
+        // If we're in listening state, PTY echo from human keystrokes will appear
+        // but it's short (1-2 chars per keystroke). MIN_PRINTABLE_LEN filters that.
+        // Suppress if we recently saw a thinking pattern.
+        if (this.state !== 'listening') {
+            if (!this.hasReceivedHumanInput)
+                return;
+            const inThinkingCooldown = Date.now() - this.lastThinkingMatchTime < THINKING_COOLDOWN_MS;
+            if (inThinkingCooldown)
+                return;
+            const printable = clean.replace(/[\x00-\x1f\x7f]/g, '').trim();
+            if (printable.length >= MIN_PRINTABLE_LEN) {
+                this.transition('typing');
+            }
+        }
+    }
+    transition(next) {
+        if (next === this.state)
+            return;
+        const prev = this.state;
+        this.state = next;
+        // Debounce the callback — only fire after state is stable for DEBOUNCE_MS.
+        // Internal state updates immediately so getState() is always current.
+        if (this.debounceTimer !== null)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null;
+            this.onStateChange({ prev, next: this.state, timestamp: Date.now() });
+        }, DEBOUNCE_MS);
+    }
+}
+//# sourceMappingURL=state.js.map