aicodeman 0.2.8

package/dist/tmux-manager.d.ts

@@ -0,0 +1,181 @@
+/**
+ * @fileoverview tmux session manager for persistent Claude sessions.
+ *
+ * This module provides the TmuxManager class which creates and manages
+ * tmux sessions that wrap Claude CLI processes. tmux provides:
+ *
+ * - **Persistence**: Sessions survive server restarts and disconnects
+ * - **Ghost recovery**: Orphaned sessions are discovered and reattached on startup
+ * - **Resource tracking**: Memory, CPU, and child process stats per session
+ * - **Reliable input**: `send-keys -l` sends literal text in a single command
+ * - **Teammate support**: Immutable pane IDs enable targeting individual teammates
+ *
+ * tmux sessions are named `codeman-{sessionId}` and stored in ~/.codeman/mux-sessions.json.
+ *
+ * Key features:
+ * - `send-keys 'text' Enter` sends literal text in a single command
+ * - `list-sessions -F` provides structured queries
+ * - `display-message -p '#{pane_pid}'` for reliable PID discovery
+ * - Single server architecture
+ *
+ * @module tmux-manager
+ */
+import { EventEmitter } from 'node:events';
+import { ProcessStats, PersistedRespawnConfig, type PaneInfo } from './types.js';
+import type { TerminalMultiplexer, MuxSession, MuxSessionWithStats, CreateSessionOptions, RespawnPaneOptions } from './mux-interface.js';
+/**
+ * Manages tmux sessions that wrap Claude CLI or shell processes.
+ *
+ * Implements the TerminalMultiplexer interface.
+ *
+ * @example
+ * ```typescript
+ * const manager = new TmuxManager();
+ *
+ * // Create a tmux session for Claude
+ * const session = await manager.createSession({ sessionId, workingDir: '/project', mode: 'claude' });
+ *
+ * // Send input (single command, no delay!)
+ * manager.sendInput(sessionId, '/clear\r');
+ *
+ * // Kill when done
+ * await manager.killSession(sessionId);
+ * ```
+ */
+export declare class TmuxManager extends EventEmitter implements TerminalMultiplexer {
+    readonly backend: "tmux";
+    private sessions;
+    private statsInterval;
+    private mouseSyncInterval;
+    /** Track last-known pane count per session to avoid unnecessary tmux set-option calls */
+    private lastPaneCount;
+    private trueColorConfigured;
+    constructor();
+    private loadSessions;
+    /**
+     * Save sessions to disk asynchronously. (NEVER writes in test mode)
+     * Uses atomic temp+rename to prevent corruption on crash.
+     */
+    private saveSessions;
+    /**
+     * Creates a new tmux session wrapping Claude CLI or a shell.
+     * In test mode: creates an in-memory session only (no real tmux session).
+     */
+    createSession(options: CreateSessionOptions): Promise<MuxSession>;
+    /**
+     * Get the PID of the process running in the tmux pane.
+     */
+    private getPanePid;
+    /**
+     * Check if a tmux session exists.
+     */
+    muxSessionExists(muxName: string): boolean;
+    /**
+     * Check if the pane in a tmux session is dead (command exited but remain-on-exit keeps it).
+     * Returns true if the session exists but the pane's command has exited.
+     */
+    isPaneDead(muxName: string): boolean;
+    /**
+     * Respawn a dead pane in an existing tmux session.
+     * Uses `tmux respawn-pane -k` to restart the command in the same pane,
+     * preserving the session and its scrollback buffer.
+     */
+    respawnPane(options: RespawnPaneOptions): Promise<number | null>;
+    private sessionExists;
+    private getChildPids;
+    private isProcessAlive;
+    private verifyProcessesDead;
+    /**
+     * Kill a tmux session and all its child processes.
+     * Uses a 4-strategy approach (children → process group → tmux kill → SIGKILL).
+     * In test mode: removes from memory only (no real kill).
+     */
+    killSession(sessionId: string): Promise<boolean>;
+    getSessions(): MuxSession[];
+    getSession(sessionId: string): MuxSession | undefined;
+    updateSessionName(sessionId: string, name: string): boolean;
+    /**
+     * Reconcile tracked sessions with actual running tmux sessions.
+     */
+    reconcileSessions(): Promise<{
+        alive: string[];
+        dead: string[];
+        discovered: string[];
+    }>;
+    getProcessStats(sessionId: string): Promise<ProcessStats | null>;
+    getSessionsWithStats(): Promise<MuxSessionWithStats[]>;
+    startStatsCollection(intervalMs?: number): void;
+    stopStatsCollection(): void;
+    /**
+     * Start periodic mouse mode sync for all tracked sessions.
+     * Polls pane counts every 5s and toggles mouse on/off as needed.
+     * Polls every 5s. On pane count change, toggles mouse on (>1 pane) or off (1 pane).
+     * If enableMouseMode/disableMouseMode fails, lastPaneCount is NOT updated so it retries next poll.
+     */
+    startMouseModeSync(intervalMs?: number): void;
+    stopMouseModeSync(): void;
+    destroy(): void;
+    registerSession(session: MuxSession): void;
+    setAttached(sessionId: string, attached: boolean): void;
+    updateRespawnConfig(sessionId: string, config: PersistedRespawnConfig | undefined): void;
+    clearRespawnConfig(sessionId: string): void;
+    updateRalphEnabled(sessionId: string, enabled: boolean): void;
+    /**
+     * Send input directly to a tmux session using `send-keys`.
+     *
+     * Uses tmux send-keys for reliable input delivery:
+     * - `-l` flag sends literal text (no key interpretation)
+     * - `Enter` key is sent as a SEPARATE tmux invocation after a small delay
+     * - Ink (Claude CLI) needs text and Enter split to avoid treating Enter as a newline
+     */
+    sendInput(sessionId: string, input: string): Promise<boolean>;
+    /**
+     * Enable mouse mode for an existing tmux session.
+     * Allows clicking to select panes in agent team split-pane layouts.
+     * When mouse mode is on, tmux intercepts mouse events (slow selection, no browser copy).
+     */
+    enableMouseMode(muxName: string): boolean;
+    /**
+     * Disable mouse mode for an existing tmux session.
+     * Restores native xterm.js text selection and browser clipboard copy.
+     */
+    disableMouseMode(muxName: string): boolean;
+    /**
+     * Sync mouse mode based on pane count: enable if split (>1 pane), disable if single.
+     * Called by TeamWatcher when teammates spawn/despawn panes.
+     * Uses `tmux list-panes` for bulletproof detection — counts actual panes, not config.
+     */
+    syncMouseMode(muxName: string): boolean;
+    /**
+     * List all panes in a tmux session.
+     * Returns structured info for each pane.
+     */
+    listPanes(muxName: string): PaneInfo[];
+    /**
+     * Send input to a specific pane within a tmux session.
+     * Uses the same literal text approach as sendInput() but targets a specific pane.
+     */
+    sendInputToPane(muxName: string, paneTarget: string, input: string): boolean;
+    /**
+     * Capture the current buffer of a specific pane.
+     * Returns the pane content with ANSI escape codes preserved.
+     */
+    capturePaneBuffer(muxName: string, paneTarget: string): string | null;
+    /**
+     * Start piping pane output to a file using tmux pipe-pane.
+     * Only pipes output direction (-O) to avoid echoing input.
+     */
+    startPipePane(muxName: string, paneTarget: string, outputFile: string): boolean;
+    /**
+     * Stop piping pane output (calling pipe-pane with no command stops piping).
+     */
+    stopPipePane(muxName: string, paneTarget: string): boolean;
+    getAttachCommand(): string;
+    getAttachArgs(muxName: string): string[];
+    isAvailable(): boolean;
+    /**
+     * Check if tmux is available on the system.
+     */
+    static isTmuxAvailable(): boolean;
+}
+//# sourceMappingURL=tmux-manager.d.ts.map

package/dist/tmux-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux-manager.d.ts","sourceRoot":"","sources":["../src/tmux-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C,OAAO,EACL,YAAY,EACZ,sBAAsB,EAGtB,KAAK,QAAQ,EAId,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AA4O5B;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAY,SAAQ,YAAa,YAAW,mBAAmB;IAC1E,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,iBAAiB,CAA+B;IACxD,yFAAyF;IACzF,OAAO,CAAC,aAAa,CAAkC;IAEvD,OAAO,CAAC,mBAAmB,CAAS;;IAWpC,OAAO,CAAC,YAAY;IAkBpB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAsBpB;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsLvE;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI1C;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAcpC;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA+DtE,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,cAAc;YAUR,mBAAmB;IAmBjC;;;;OAIG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsGtD,WAAW,IAAI,UAAU,EAAE;IAI3B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIrD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAU3D;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAoFvF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAsChE,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA6G5D,oBAAoB,CAAC,UAAU,GAAE,MAAkC,GAAG,IAAI;IAe1E,mBAAmB,IAAI,IAAI;IAO3B;;;;;OAKG;IACH,kBAAkB,CAAC,UAAU,GAAE,MAAa,GAAG,IAAI;IA+BnD,iBAAiB,IAAI,IAAI;IAQzB,OAAO,IAAI,IAAI;IAKf,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAK1C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAQvD,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI;IAQxF,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ3C,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQ7D;;;;;;;OAOG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4DnE;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAoBzC;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAoB1C;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAUvC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE;IA+BtC;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IA8C5E;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAwBrE;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IA6B/E;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAyB1D,gBAAgB,IAAI,MAAM;IAI1B,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAIxC,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,OAAO;CAQlC"}