claude-face 0.1.0

package/dist/src/ipc.js

@@ -0,0 +1,136 @@
+import * as net from 'node:net';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import { config } from './config.js';
+// ── Socket path ─────────────────────────────────────────────────────
+export function getSocketPath() {
+    const tmpdir = os.tmpdir();
+    return `${tmpdir}/claude-face.sock`;
+}
+// ── Server (wrapper process — terminal 1) ───────────────────────────
+export class StateServer {
+    server;
+    clients = new Set();
+    socketPath;
+    constructor(socketPath) {
+        this.socketPath = socketPath;
+        // Remove stale socket file if it exists
+        try {
+            fs.unlinkSync(socketPath);
+        }
+        catch {
+            // doesn't exist — fine
+        }
+        this.server = net.createServer((socket) => {
+            this.clients.add(socket);
+            socket.on('close', () => this.clients.delete(socket));
+            socket.on('error', () => this.clients.delete(socket));
+        });
+        this.server.listen(socketPath);
+    }
+    broadcast(state) {
+        const msg = { state, ts: Date.now() };
+        const line = JSON.stringify(msg) + '\n';
+        for (const socket of this.clients) {
+            try {
+                socket.write(line);
+            }
+            catch {
+                this.clients.delete(socket);
+            }
+        }
+    }
+    close() {
+        for (const socket of this.clients) {
+            try {
+                socket.destroy();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.clients.clear();
+        this.server.close();
+        try {
+            fs.unlinkSync(this.socketPath);
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+// ── Client (face renderer — terminal 2) ─────────────────────────────
+export class StateClient {
+    socket = null;
+    socketPath;
+    onState;
+    onDisconnect;
+    onConnect;
+    buffer = '';
+    retryTimer = null;
+    closed = false;
+    constructor(socketPath, onState, opts) {
+        this.socketPath = socketPath;
+        this.onState = onState;
+        this.onDisconnect = opts?.onDisconnect;
+        this.onConnect = opts?.onConnect;
+        this.connect();
+    }
+    connect() {
+        if (this.closed)
+            return;
+        this.socket = net.createConnection(this.socketPath);
+        this.socket.on('connect', () => {
+            this.buffer = '';
+            this.onConnect?.();
+        });
+        this.socket.on('data', (data) => {
+            this.buffer += data.toString();
+            const lines = this.buffer.split('\n');
+            // Keep the incomplete last chunk in the buffer
+            this.buffer = lines.pop();
+            for (const line of lines) {
+                if (!line)
+                    continue;
+                try {
+                    const msg = JSON.parse(line);
+                    this.onState(msg.state);
+                }
+                catch {
+                    // malformed JSON — skip
+                }
+            }
+        });
+        this.socket.on('close', () => {
+            if (this.closed)
+                return;
+            this.onDisconnect?.();
+            this.scheduleRetry();
+        });
+        this.socket.on('error', () => {
+            if (this.closed)
+                return;
+            // Will trigger 'close' which handles reconnection
+        });
+    }
+    scheduleRetry() {
+        if (this.closed)
+            return;
+        this.retryTimer = setTimeout(() => {
+            this.retryTimer = null;
+            this.connect();
+        }, config.ipcRetryMs);
+    }
+    close() {
+        this.closed = true;
+        if (this.retryTimer !== null) {
+            clearTimeout(this.retryTimer);
+            this.retryTimer = null;
+        }
+        if (this.socket) {
+            this.socket.destroy();
+            this.socket = null;
+        }
+    }
+}
+//# sourceMappingURL=ipc.js.map

package/dist/src/ipc.js.map

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

package/dist/src/loader.d.ts

@@ -0,0 +1,2 @@
+import { FaceDefinition } from './types.js';
+export declare function loadDefaultFace(): FaceDefinition;

package/dist/src/loader.js

@@ -0,0 +1,87 @@
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ── Locate faces/ directory ──────────────────────────────────────────
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function findProjectRoot() {
+    let dir = __dirname;
+    while (dir !== dirname(dir)) {
+        if (existsSync(join(dir, 'package.json')))
+            return dir;
+        dir = dirname(dir);
+    }
+    throw new Error('Could not find project root (no package.json found)');
+}
+const FACES_DIR = join(findProjectRoot(), 'faces');
+// ── Parser ───────────────────────────────────────────────────────────
+/**
+ * Load an expression from a folder: faces/{name}/
+ *
+ * Reads config.json for animation config, then loads all .txt files
+ * sorted numerically as individual frames.
+ */
+function loadExpression(name) {
+    const dir = join(FACES_DIR, name);
+    // Read animation config
+    const configPath = join(dir, 'config.json');
+    const configRaw = readFileSync(configPath, 'utf-8');
+    const config = JSON.parse(configRaw);
+    // Scan for .txt frame files, sort numerically
+    const files = readdirSync(dir)
+        .filter((f) => f.endsWith('.txt'))
+        .sort((a, b) => parseInt(a) - parseInt(b));
+    if (files.length === 0) {
+        throw new Error(`Expression "${name}" has no frame .txt files`);
+    }
+    const frames = files.map((file) => {
+        const raw = readFileSync(join(dir, file), 'utf-8');
+        const lines = raw.split('\n');
+        // Trim trailing empty line (from trailing newline in file)
+        while (lines.length > 0 && lines[lines.length - 1].trim() === '')
+            lines.pop();
+        while (lines.length > 0 && lines[0].trim() === '')
+            lines.shift();
+        return lines;
+    });
+    if (frames[0].length === 0) {
+        throw new Error(`Expression "${name}" frame 01.txt is empty`);
+    }
+    // Infer width from longest line across all frames
+    let maxWidth = 0;
+    for (const lines of frames) {
+        for (const line of lines) {
+            if (line.length > maxWidth)
+                maxWidth = line.length;
+        }
+    }
+    // Pad all lines to maxWidth and build Frame objects
+    const expressionFrames = frames.map((lines) => ({
+        art: lines.map((line) => line.length >= maxWidth ? line.slice(0, maxWidth) : line + ' '.repeat(maxWidth - line.length)),
+        colors: [],
+    }));
+    return {
+        name,
+        frames: expressionFrames,
+        config,
+    };
+}
+// ── Build FaceDefinition ─────────────────────────────────────────────
+const ALL_EXPRESSIONS = ['idle', 'typing', 'thinking', 'listening'];
+export function loadDefaultFace() {
+    const expressions = {};
+    for (const name of ALL_EXPRESSIONS) {
+        expressions[name] = loadExpression(name);
+    }
+    // Dimensions from idle (the reference expression)
+    const idleFrame = expressions['idle'].frames[0];
+    const height = idleFrame.art.length;
+    const width = idleFrame.art[0].length;
+    return {
+        name: 'default',
+        width,
+        height,
+        expressions,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/loader.js.map

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

package/dist/src/main.d.ts

@@ -0,0 +1,2 @@
+import { CliOptions } from './types.js';
+export declare function run(options: CliOptions): Promise<void>;

package/dist/src/main.js

@@ -0,0 +1,201 @@
+import { spawnClaude } from './pty.js';
+import { StateMachine } from './state.js';
+import { FaceRenderer } from './face.js';
+import { getTheme } from './theme.js';
+import { defaultFace } from './frames.js';
+import { StateServer, StateClient, getSocketPath } 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.`);
+            }
+            if (frame.art.length !== face.height) {
+                throw new Error(`Expression "${key}", frame ${i}: art has ${frame.art.length} rows ` +
+                    `but face.height is ${face.height}.`);
+            }
+            for (let r = 0; r < frame.art.length; r++) {
+                if (frame.art[r].length !== face.width) {
+                    throw new Error(`Expression "${key}", frame ${i}, row ${r}: length is ` +
+                        `${frame.art[r].length} but face.width is ${face.width}.`);
+                }
+            }
+        }
+    }
+}
+// ── 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;
+        }
+    }
+    return defaultFace;
+}
+// ── Main entry point ────────────────────────────────────────────────
+export async function run(options) {
+    // ── Face-only mode ──────────────────────────────────────────────
+    if (options.faceOnly) {
+        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);
+    process.stderr.write(`Face server listening. In another terminal run: claude-face --face-only\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
+    const cleanup = () => {
+        stateMachine.destroy();
+        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);
+    const socketPath = getSocketPath();
+    renderer.setState('idle');
+    renderer.showMessage('Waiting for claude-face...');
+    // Connect to wrapper's IPC server
+    const client = new StateClient(socketPath, (state) => {
+        renderer.setState(state);
+    }, {
+        onDisconnect() {
+            renderer.showMessage('Disconnected. Waiting for claude-face...');
+        },
+        onConnect() {
+            renderer.setState('idle');
+        },
+    });
+    // Handle resize — invalidate pre-rendered frame cache
+    process.on('SIGWINCH', () => {
+        renderer.invalidateCache();
+    });
+    // Cleanup
+    const cleanup = () => {
+        renderer.destroy();
+        client.close();
+        // Show cursor on exit
+        process.stdout.write('\x1b[?25h');
+    };
+    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;