aicodeman 0.2.8

package/dist/hooks-config.js

@@ -0,0 +1,115 @@
+/**
+ * @fileoverview Claude Code hooks configuration generator
+ *
+ * Generates .claude/settings.local.json with hook definitions that POST
+ * to Codeman's /api/hook-event endpoint when Claude Code fires
+ * notification or stop hooks. Uses $CODEMAN_API_URL and
+ * $CODEMAN_SESSION_ID env vars (set on every managed session) so the
+ * config is static per case directory.
+ */
+import { existsSync } from 'node:fs';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Generates the hooks section for .claude/settings.local.json
+ *
+ * The hook commands read stdin JSON from Claude Code (contains tool_name,
+ * tool_input, etc.) and forward it as the `data` field to Codeman's API.
+ * Env vars are resolved at runtime by the shell, so the config is static
+ * per case directory.
+ */
+export function generateHooksConfig() {
+    // Read Claude Code's stdin JSON and forward it as the data field.
+    // Falls back to empty object if stdin is unavailable or malformed.
+    const curlCmd = (event) => `HOOK_DATA=$(cat 2>/dev/null || echo '{}'); ` +
+        `printf '{"event":"${event}","sessionId":"%s","data":%s}' "$CODEMAN_SESSION_ID" "$HOOK_DATA" | ` +
+        `curl -s -X POST "$CODEMAN_API_URL/api/hook-event" ` +
+        `-H 'Content-Type: application/json' ` +
+        `--data @- ` +
+        `2>/dev/null || true`;
+    return {
+        hooks: {
+            Notification: [
+                {
+                    matcher: 'idle_prompt',
+                    hooks: [{ type: 'command', command: curlCmd('idle_prompt'), timeout: 10000 }],
+                },
+                {
+                    matcher: 'permission_prompt',
+                    hooks: [{ type: 'command', command: curlCmd('permission_prompt'), timeout: 10000 }],
+                },
+                {
+                    matcher: 'elicitation_dialog',
+                    hooks: [{ type: 'command', command: curlCmd('elicitation_dialog'), timeout: 10000 }],
+                },
+            ],
+            Stop: [
+                {
+                    hooks: [{ type: 'command', command: curlCmd('stop'), timeout: 10000 }],
+                },
+            ],
+            TeammateIdle: [
+                {
+                    hooks: [{ type: 'command', command: curlCmd('teammate_idle'), timeout: 10000 }],
+                },
+            ],
+            TaskCompleted: [
+                {
+                    hooks: [{ type: 'command', command: curlCmd('task_completed'), timeout: 10000 }],
+                },
+            ],
+        },
+    };
+}
+/**
+ * Updates env vars in .claude/settings.local.json for the given case path.
+ * Merges with existing env field; removes vars set to empty string.
+ */
+export async function updateCaseEnvVars(casePath, envVars) {
+    const claudeDir = join(casePath, '.claude');
+    if (!existsSync(claudeDir)) {
+        await mkdir(claudeDir, { recursive: true });
+    }
+    const settingsPath = join(claudeDir, 'settings.local.json');
+    let existing = {};
+    try {
+        existing = JSON.parse(await readFile(settingsPath, 'utf-8'));
+    }
+    catch {
+        existing = {};
+    }
+    const currentEnv = existing.env || {};
+    for (const [key, value] of Object.entries(envVars)) {
+        if (value) {
+            currentEnv[key] = value;
+        }
+        else {
+            delete currentEnv[key];
+        }
+    }
+    existing.env = currentEnv;
+    await writeFile(settingsPath, JSON.stringify(existing, null, 2) + '\n');
+}
+/**
+ * Writes hooks config to .claude/settings.local.json in the given case path.
+ * Merges with existing file content, only touching the `hooks` key.
+ */
+export async function writeHooksConfig(casePath) {
+    const claudeDir = join(casePath, '.claude');
+    if (!existsSync(claudeDir)) {
+        await mkdir(claudeDir, { recursive: true });
+    }
+    const settingsPath = join(claudeDir, 'settings.local.json');
+    let existing = {};
+    try {
+        existing = JSON.parse(await readFile(settingsPath, 'utf-8'));
+    }
+    catch {
+        // If file is malformed or doesn't exist, start fresh
+        existing = {};
+    }
+    const hooksConfig = generateHooksConfig();
+    const merged = { ...existing, ...hooksConfig };
+    await writeFile(settingsPath, JSON.stringify(merged, null, 2) + '\n');
+}
+//# sourceMappingURL=hooks-config.js.map

package/dist/hooks-config.js.map

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

package/dist/image-watcher.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Image Watcher - Detects new image files in session working directories
+ *
+ * Watches session working directories for new image files (screenshots, generated images)
+ * and emits events to trigger automatic popup display in the web UI.
+ *
+ * Uses chokidar for reliable cross-platform file watching with awaitWriteFinish
+ * to ensure files are fully written before emitting detection events.
+ */
+import { EventEmitter } from 'node:events';
+import type { ImageDetectedEvent } from './types.js';
+export interface ImageWatcherEvents {
+    'image:detected': (event: ImageDetectedEvent) => void;
+    'image:error': (error: Error, sessionId?: string) => void;
+}
+/**
+ * Watches session working directories for new image files.
+ *
+ * Follows the SubagentWatcher pattern: extends EventEmitter, manages
+ * file watchers in Maps, emits typed events.
+ *
+ * @example
+ * ```typescript
+ * const watcher = new ImageWatcher();
+ * watcher.on('image:detected', (event) => {
+ *   console.log(`New image in session ${event.sessionId}: ${event.fileName}`);
+ * });
+ * watcher.watchSession('session-123', '/path/to/working/dir');
+ * ```
+ */
+export declare class ImageWatcher extends EventEmitter {
+    /** Map of sessionId -> FSWatcher for per-session directory watching */
+    private sessionWatchers;
+    /** Map of sessionId -> working directory path */
+    private sessionDirs;
+    /** Debounce timers for rapid image creation (keyed by filePath) */
+    private debounceTimers;
+    /** Track which session owns each debounce timer (for cleanup) */
+    private timerToSession;
+    /** Per-session burst tracking: sessionId -> { count, windowStart } */
+    private burstTrackers;
+    /** Whether the watcher is currently running */
+    private _isRunning;
+    constructor();
+    /**
+     * Check if the watcher is currently running
+     */
+    isRunning(): boolean;
+    /**
+     * Start the image watcher.
+     * After calling start(), use watchSession() to add directories to monitor.
+     */
+    start(): void;
+    /**
+     * Stop the image watcher and clean up all resources.
+     */
+    stop(): void;
+    /**
+     * Start watching a session's working directory for new images.
+     *
+     * @param sessionId - Codeman session ID
+     * @param workingDir - Path to the session's working directory
+     */
+    watchSession(sessionId: string, workingDir: string): void;
+    /**
+     * Stop watching a session's working directory.
+     *
+     * @param sessionId - Codeman session ID to stop watching
+     */
+    unwatchSession(sessionId: string): void;
+    /**
+     * Get list of currently watched session IDs.
+     */
+    getWatchedSessions(): string[];
+    /**
+     * Handle a new file being detected.
+     * Verifies it's an image and emits the detection event.
+     */
+    private handleNewFile;
+    /**
+     * Emit the image:detected event with file metadata.
+     */
+    private emitImageDetected;
+}
+export declare const imageWatcher: ImageWatcher;
+//# sourceMappingURL=image-watcher.d.ts.map

package/dist/image-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-watcher.d.ts","sourceRoot":"","sources":["../src/image-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACtD,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D;AAwBD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,uEAAuE;IACvE,OAAO,CAAC,eAAe,CAAgC;IAEvD,iDAAiD;IACjD,OAAO,CAAC,WAAW,CAA6B;IAEhD,mEAAmE;IACnE,OAAO,CAAC,cAAc,CAAqC;IAE3D,iEAAiE;IACjE,OAAO,CAAC,cAAc,CAA6B;IAEnD,sEAAsE;IACtE,OAAO,CAAC,aAAa,CAA6D;IAElF,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAAS;;IAS3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI;IAuBZ;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA8DzD;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA+BvC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAM9B;;;OAGG;IACH,OAAO,CAAC,aAAa;IA4CrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAuB1B;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/image-watcher.js

@@ -0,0 +1,275 @@
+/**
+ * @fileoverview Image Watcher - Detects new image files in session working directories
+ *
+ * Watches session working directories for new image files (screenshots, generated images)
+ * and emits events to trigger automatic popup display in the web UI.
+ *
+ * Uses chokidar for reliable cross-platform file watching with awaitWriteFinish
+ * to ensure files are fully written before emitting detection events.
+ */
+import { EventEmitter } from 'node:events';
+import { watch } from 'chokidar';
+import { basename, extname, relative } from 'node:path';
+import { statSync } from 'node:fs';
+// ========== Constants ==========
+/** Supported image file extensions (lowercase) */
+const IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp', '.svg']);
+/** Time to wait for file writes to stabilize (ms) */
+const STABILITY_THRESHOLD_MS = 500;
+/** Poll interval for checking file write stability (ms) */
+const POLL_INTERVAL_MS = 100;
+/** Debounce delay for rapid image creation (ms) */
+const DEBOUNCE_DELAY_MS = 200;
+/** Max images emitted per session within the burst window before throttling */
+const BURST_LIMIT = 20;
+/** Time window for burst detection (ms) — resets after this period of quiet */
+const BURST_WINDOW_MS = 10_000;
+// ========== ImageWatcher Class ==========
+/**
+ * Watches session working directories for new image files.
+ *
+ * Follows the SubagentWatcher pattern: extends EventEmitter, manages
+ * file watchers in Maps, emits typed events.
+ *
+ * @example
+ * ```typescript
+ * const watcher = new ImageWatcher();
+ * watcher.on('image:detected', (event) => {
+ *   console.log(`New image in session ${event.sessionId}: ${event.fileName}`);
+ * });
+ * watcher.watchSession('session-123', '/path/to/working/dir');
+ * ```
+ */
+export class ImageWatcher extends EventEmitter {
+    /** Map of sessionId -> FSWatcher for per-session directory watching */
+    sessionWatchers = new Map();
+    /** Map of sessionId -> working directory path */
+    sessionDirs = new Map();
+    /** Debounce timers for rapid image creation (keyed by filePath) */
+    debounceTimers = new Map();
+    /** Track which session owns each debounce timer (for cleanup) */
+    timerToSession = new Map();
+    /** Per-session burst tracking: sessionId -> { count, windowStart } */
+    burstTrackers = new Map();
+    /** Whether the watcher is currently running */
+    _isRunning = false;
+    constructor() {
+        super();
+        this.setMaxListeners(50);
+    }
+    // ========== Public API ==========
+    /**
+     * Check if the watcher is currently running
+     */
+    isRunning() {
+        return this._isRunning;
+    }
+    /**
+     * Start the image watcher.
+     * After calling start(), use watchSession() to add directories to monitor.
+     */
+    start() {
+        if (this._isRunning)
+            return;
+        this._isRunning = true;
+    }
+    /**
+     * Stop the image watcher and clean up all resources.
+     */
+    stop() {
+        this._isRunning = false;
+        // Close all session watchers
+        for (const [sessionId, watcher] of this.sessionWatchers) {
+            try {
+                watcher.close();
+            }
+            catch (error) {
+                this.emit('image:error', error instanceof Error ? error : new Error(String(error)), sessionId);
+            }
+        }
+        this.sessionWatchers.clear();
+        this.sessionDirs.clear();
+        // Clear all debounce timers
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        this.timerToSession.clear();
+        this.burstTrackers.clear();
+    }
+    /**
+     * Start watching a session's working directory for new images.
+     *
+     * @param sessionId - Codeman session ID
+     * @param workingDir - Path to the session's working directory
+     */
+    watchSession(sessionId, workingDir) {
+        if (!this._isRunning) {
+            this.start();
+        }
+        // Don't double-watch the same session
+        if (this.sessionWatchers.has(sessionId)) {
+            // If working directory changed, unwatch old and watch new
+            if (this.sessionDirs.get(sessionId) !== workingDir) {
+                this.unwatchSession(sessionId);
+            }
+            else {
+                return;
+            }
+        }
+        this.sessionDirs.set(sessionId, workingDir);
+        try {
+            // Create chokidar watcher for the directory
+            const watcher = watch(workingDir, {
+                // Only detect NEW files, not existing ones
+                ignoreInitial: true,
+                // Wait for file writes to stabilize before emitting
+                awaitWriteFinish: {
+                    stabilityThreshold: STABILITY_THRESHOLD_MS,
+                    pollInterval: POLL_INTERVAL_MS,
+                },
+                // Watch all subdirectories (images may be saved in src/, assets/, etc.)
+                // Ignore common heavy directories for performance
+                ignored: (path) => {
+                    // Skip node_modules, .git, and other heavy directories
+                    if (path.includes('/node_modules/') ||
+                        path.includes('/.git/') ||
+                        path.includes('/dist/') ||
+                        path.includes('/.next/')) {
+                        return true;
+                    }
+                    const ext = extname(path).toLowerCase();
+                    // Don't ignore directories (needed for watching to work)
+                    // Ignore files that aren't images
+                    return ext !== '' && !IMAGE_EXTENSIONS.has(ext);
+                },
+            });
+            // Handle new file detection
+            watcher.on('add', (filePath) => {
+                this.handleNewFile(sessionId, filePath);
+            });
+            // Handle watcher errors
+            watcher.on('error', (error) => {
+                this.emit('image:error', error, sessionId);
+            });
+            this.sessionWatchers.set(sessionId, watcher);
+        }
+        catch (error) {
+            this.emit('image:error', error instanceof Error ? error : new Error(String(error)), sessionId);
+        }
+    }
+    /**
+     * Stop watching a session's working directory.
+     *
+     * @param sessionId - Codeman session ID to stop watching
+     */
+    unwatchSession(sessionId) {
+        const watcher = this.sessionWatchers.get(sessionId);
+        if (watcher) {
+            try {
+                watcher.close();
+            }
+            catch (error) {
+                this.emit('image:error', error instanceof Error ? error : new Error(String(error)), sessionId);
+            }
+            this.sessionWatchers.delete(sessionId);
+        }
+        this.sessionDirs.delete(sessionId);
+        // Clear any pending debounce timers for this session
+        // Collect keys first to avoid iterator invalidation during deletion
+        const toDelete = [];
+        for (const [filePath, ownerId] of this.timerToSession) {
+            if (ownerId === sessionId) {
+                toDelete.push(filePath);
+            }
+        }
+        for (const filePath of toDelete) {
+            const timer = this.debounceTimers.get(filePath);
+            if (timer) {
+                clearTimeout(timer);
+                this.debounceTimers.delete(filePath);
+            }
+            this.timerToSession.delete(filePath);
+        }
+        this.burstTrackers.delete(sessionId);
+    }
+    /**
+     * Get list of currently watched session IDs.
+     */
+    getWatchedSessions() {
+        return Array.from(this.sessionWatchers.keys());
+    }
+    // ========== Private Methods ==========
+    /**
+     * Handle a new file being detected.
+     * Verifies it's an image and emits the detection event.
+     */
+    handleNewFile(sessionId, filePath) {
+        const ext = extname(filePath).toLowerCase();
+        // Double-check it's an image extension
+        if (!IMAGE_EXTENSIONS.has(ext)) {
+            return;
+        }
+        // Burst limit: skip if too many images detected for this session in a short window
+        const now = Date.now();
+        let burst = this.burstTrackers.get(sessionId);
+        if (burst) {
+            if (now - burst.windowStart > BURST_WINDOW_MS) {
+                // Window expired, reset
+                burst = { count: 0, windowStart: now };
+                this.burstTrackers.set(sessionId, burst);
+            }
+            if (burst.count >= BURST_LIMIT) {
+                return; // Throttled — too many images in this window
+            }
+        }
+        else {
+            burst = { count: 0, windowStart: now };
+            this.burstTrackers.set(sessionId, burst);
+        }
+        // Debounce rapid file creation (e.g., multiple screenshots quickly)
+        const existingTimer = this.debounceTimers.get(filePath);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(filePath);
+            this.timerToSession.delete(filePath);
+            this.emitImageDetected(sessionId, filePath);
+            // Increment burst count on actual emission (not on detection)
+            const b = this.burstTrackers.get(sessionId);
+            if (b)
+                b.count++;
+        }, DEBOUNCE_DELAY_MS);
+        this.debounceTimers.set(filePath, timer);
+        this.timerToSession.set(filePath, sessionId);
+    }
+    /**
+     * Emit the image:detected event with file metadata.
+     */
+    emitImageDetected(sessionId, filePath) {
+        try {
+            const stat = statSync(filePath);
+            const fileName = basename(filePath);
+            const workingDir = this.sessionDirs.get(sessionId);
+            // Compute relative path from working directory (for file-raw endpoint)
+            const relativePath = workingDir ? relative(workingDir, filePath) : fileName;
+            const event = {
+                sessionId,
+                filePath,
+                relativePath,
+                fileName,
+                timestamp: Date.now(),
+                size: stat.size,
+            };
+            this.emit('image:detected', event);
+        }
+        catch (error) {
+            // File may have been deleted between detection and stat
+            this.emit('image:error', error instanceof Error ? error : new Error(String(error)), sessionId);
+        }
+    }
+}
+// Export singleton instance for convenience
+export const imageWatcher = new ImageWatcher();
+//# sourceMappingURL=image-watcher.js.map

package/dist/image-watcher.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Codeman CLI entry point
+ *
+ * This is the main executable entry point for the Codeman CLI.
+ * It sets up global error handlers and invokes the CLI parser.
+ *
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Codeman CLI entry point
+ *
+ * This is the main executable entry point for the Codeman CLI.
+ * It sets up global error handlers and invokes the CLI parser.
+ *
+ * @module index
+ */
+import { program } from './cli.js';
+// Detect if we're running the web server (long-lived process)
+// In web mode, we should NOT exit on transient errors — log and continue
+const isWebMode = process.argv.includes('web');
+// Track consecutive unhandled errors in web mode — restart after too many
+let consecutiveErrors = 0;
+const MAX_CONSECUTIVE_ERRORS = 5;
+const ERROR_RESET_MS = 60000; // Reset counter after 1 minute of no errors
+let errorResetTimer = null;
+function trackError() {
+    consecutiveErrors++;
+    if (errorResetTimer)
+        clearTimeout(errorResetTimer);
+    errorResetTimer = setTimeout(() => {
+        consecutiveErrors = 0;
+    }, ERROR_RESET_MS);
+    if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
+        console.error(`[FATAL] ${MAX_CONSECUTIVE_ERRORS} consecutive unhandled errors — exiting for systemd restart`);
+        process.exit(1);
+    }
+}
+// Handle uncaught errors
+process.on('uncaughtException', (err) => {
+    console.error('Uncaught exception:', err.message);
+    if (isWebMode) {
+        console.error('[RECOVERED] Server continuing after uncaught exception:', err.stack);
+        trackError();
+    }
+    else {
+        process.exit(1);
+    }
+});
+process.on('unhandledRejection', (reason) => {
+    console.error('Unhandled rejection:', reason);
+    if (isWebMode) {
+        console.error('[RECOVERED] Server continuing after unhandled rejection');
+        trackError();
+    }
+    else {
+        process.exit(1);
+    }
+});
+// Run CLI
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,8DAA8D;AAC9D,yEAAyE;AACzE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAE/C,0EAA0E;AAC1E,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAC1B,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,4CAA4C;AAC1E,IAAI,eAAe,GAAyC,IAAI,CAAC;AAEjE,SAAS,UAAU;IACjB,iBAAiB,EAAE,CAAC;IACpB,IAAI,eAAe;QAAE,YAAY,CAAC,eAAe,CAAC,CAAC;IACnD,eAAe,GAAG,UAAU,CAAC,GAAG,EAAE;QAChC,iBAAiB,GAAG,CAAC,CAAC;IACxB,CAAC,EAAE,cAAc,CAAC,CAAC;IAEnB,IAAI,iBAAiB,IAAI,sBAAsB,EAAE,CAAC;QAChD,OAAO,CAAC,KAAK,CAAC,WAAW,sBAAsB,6DAA6D,CAAC,CAAC;QAC9G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,yBAAyB;AACzB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;IACtC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,yDAAyD,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACpF,UAAU,EAAE,CAAC;IACf,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACzE,UAAU,EAAE,CAAC;IACf,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,UAAU;AACV,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/mux-factory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Factory for creating the terminal multiplexer (tmux).
+ *
+ * @module mux-factory
+ */
+import type { TerminalMultiplexer } from './mux-interface.js';
+/**
+ * Create a TerminalMultiplexer instance.
+ *
+ * Requires tmux to be installed. Throws with install instructions if not found.
+ */
+export declare function createMultiplexer(): TerminalMultiplexer;
+//# sourceMappingURL=mux-factory.d.ts.map

package/dist/mux-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mux-factory.d.ts","sourceRoot":"","sources":["../src/mux-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,mBAAmB,CAOvD"}

package/dist/mux-factory.js

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Factory for creating the terminal multiplexer (tmux).
+ *
+ * @module mux-factory
+ */
+import { TmuxManager } from './tmux-manager.js';
+/**
+ * Create a TerminalMultiplexer instance.
+ *
+ * Requires tmux to be installed. Throws with install instructions if not found.
+ */
+export function createMultiplexer() {
+    if (!TmuxManager.isTmuxAvailable()) {
+        throw new Error('tmux not found. Install: sudo apt install tmux');
+    }
+    console.log('[MuxFactory] Using tmux backend');
+    return new TmuxManager();
+}
+//# sourceMappingURL=mux-factory.js.map

package/dist/mux-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mux-factory.js","sourceRoot":"","sources":["../src/mux-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,IAAI,WAAW,EAAE,CAAC;AAC3B,CAAC"}