brosh 0.2.2

package/dist/lib.js

@@ -0,0 +1,28 @@
+/**
+ * Library Exports
+ *
+ * This file exports all public APIs for use as a library.
+ * The main index.ts is the CLI entry point; this file is for programmatic usage.
+ */
+// Terminal management
+export { TerminalSession, TerminalManager } from "./terminal/index.js";
+// Transport layer - GUI streaming
+export { GUIOutputStream, createGUIOutputStream, } from "./transport/index.js";
+// GUI protocol types
+export { encodeData, decodeData, isGuiMessageToBackend, isGuiMessageToFrontend, } from "./transport/index.js";
+// Socket transport
+export { SocketTransport, createSocketServer, createToolProxyServer, isSocketInUse, checkSocketAndWarn, } from "./transport/index.js";
+// Recording
+export { RecordingManager } from "./recording/index.js";
+// Utilities
+export { getDefaultShell, getDefaultSocketPath, getDefaultRecordDir } from "./utils/platform.js";
+export { getKeySequence, KEY_SEQUENCES, getAvailableKeys } from "./utils/keys.js";
+// Sandbox/Mode selection
+export { promptForMode } from "./sandbox/mode-prompt.js";
+export { promptForPermissions } from "./sandbox/prompt.js";
+export { SandboxController, loadConfigFromFile, DEFAULT_PERMISSIONS } from "./sandbox/index.js";
+// MCP Client Info types
+export { ClientInfoSchema, RuntimeInfoSchema, CapabilitiesSchema, SessionMetadataSchema, ObservabilitySchema, ExtendedClientInfoSchema, generateClientId, } from "./types/mcp-client-info.js";
+// Session logging
+export { SessionLogger } from "./utils/session-logger.js";
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AASvE,kCAAkC;AAClC,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAM9B,qBAAqB;AACrB,OAAO,EACL,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAuB9B,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQxD,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAElF,yBAAyB;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGhG,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAepC,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/mode-selector.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Standalone mode selector - minimal script for GUI wrapper
+ * Outputs JSON: {"mode": "direct"|"sandbox"} or {"mode": null, "cancelled": true}
+ */
+export {};
+//# sourceMappingURL=mode-selector.d.ts.map

package/dist/mode-selector.d.ts.map

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

package/dist/mode-selector.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+/**
+ * Standalone mode selector - minimal script for GUI wrapper
+ * Outputs JSON: {"mode": "direct"|"sandbox"} or {"mode": null, "cancelled": true}
+ */
+// ANSI escape codes
+const ESC = "\x1b";
+const CURSOR_HIDE = `${ESC}[?25l`;
+const CURSOR_SHOW = `${ESC}[?25h`;
+const CLEAR_SCREEN = `${ESC}[2J`;
+const CURSOR_HOME = `${ESC}[H`;
+const CURSOR_TO = (row, col) => `${ESC}[${row};${col}H`;
+// Colors
+const BOLD = `${ESC}[1m`;
+const DIM = `${ESC}[2m`;
+const RESET = `${ESC}[0m`;
+const GREEN = `${ESC}[32m`;
+const YELLOW = `${ESC}[33m`;
+const GRAY = `${ESC}[90m`;
+const WHITE = `${ESC}[97m`;
+// Box drawing
+const BOX = {
+    topLeft: "╭",
+    topRight: "╮",
+    bottomLeft: "╰",
+    bottomRight: "╯",
+    horizontal: "─",
+    vertical: "│",
+};
+// Helper to pad string, handling negative values
+const pad = (n) => " ".repeat(Math.max(0, n));
+const repeat = (s, n) => s.repeat(Math.max(0, n));
+async function main() {
+    // Check if we can use raw mode
+    if (typeof process.stdin.setRawMode !== 'function') {
+        console.log(JSON.stringify({ mode: 'direct' }));
+        process.exit(0);
+    }
+    let selected = 'direct';
+    const boxWidth = 38;
+    try {
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding("utf8");
+    }
+    catch {
+        console.log(JSON.stringify({ mode: 'direct' }));
+        process.exit(0);
+    }
+    // Get terminal size
+    const cols = process.stdout.columns || 80;
+    const rows = process.stdout.rows || 24;
+    // Calculate center position
+    const startCol = Math.max(1, Math.floor((cols - boxWidth) / 2));
+    const startRow = Math.max(1, Math.floor((rows - 10) / 2));
+    const render = () => {
+        const output = [];
+        output.push(CLEAR_SCREEN + CURSOR_HOME + CURSOR_HIDE);
+        const innerWidth = boxWidth - 2;
+        const lines = [];
+        // Title bar
+        const title = " Terminal Mode ";
+        const titlePadLeft = Math.floor((innerWidth - title.length) / 2);
+        const titlePadRight = innerWidth - titlePadLeft - title.length;
+        lines.push(`${YELLOW}${BOX.topLeft}${repeat(BOX.horizontal, titlePadLeft)}${WHITE}${BOLD}${title}${RESET}${YELLOW}${repeat(BOX.horizontal, titlePadRight)}${BOX.topRight}${RESET}`);
+        // Empty line
+        lines.push(`${YELLOW}${BOX.vertical}${RESET}${pad(innerWidth)}${YELLOW}${BOX.vertical}${RESET}`);
+        // Standard option
+        const stdSelected = selected === 'direct';
+        const stdBullet = stdSelected ? `${GREEN}●${RESET}` : `${GRAY}○${RESET}`;
+        const stdLabel = stdSelected ? `${WHITE}${BOLD}Standard${RESET}` : `${GRAY}Standard${RESET}`;
+        const stdContent = `  ${stdBullet} ${stdLabel}`;
+        // Account for ANSI codes in length calculation
+        const stdVisibleLen = 2 + 1 + 1 + 8; // "  " + bullet + " " + "Standard"
+        lines.push(`${YELLOW}${BOX.vertical}${RESET}${stdContent}${pad(innerWidth - stdVisibleLen)}${YELLOW}${BOX.vertical}${RESET}`);
+        // Standard description
+        const stdDesc = "full access to resources";
+        lines.push(`${YELLOW}${BOX.vertical}${RESET}      ${DIM}${stdDesc}${RESET}${pad(innerWidth - 6 - stdDesc.length)}${YELLOW}${BOX.vertical}${RESET}`);
+        // Empty line
+        lines.push(`${YELLOW}${BOX.vertical}${RESET}${pad(innerWidth)}${YELLOW}${BOX.vertical}${RESET}`);
+        // Sandboxed option
+        const sbxSelected = selected === 'sandbox';
+        const sbxBullet = sbxSelected ? `${GREEN}●${RESET}` : `${GRAY}○${RESET}`;
+        const sbxLabel = sbxSelected ? `${WHITE}${BOLD}Sandboxed${RESET}` : `${GRAY}Sandboxed${RESET}`;
+        const sbxContent = `  ${sbxBullet} ${sbxLabel}`;
+        const sbxVisibleLen = 2 + 1 + 1 + 9; // "  " + bullet + " " + "Sandboxed"
+        lines.push(`${YELLOW}${BOX.vertical}${RESET}${sbxContent}${pad(innerWidth - sbxVisibleLen)}${YELLOW}${BOX.vertical}${RESET}`);
+        // Sandboxed description
+        const sbxDesc = "restricted access with controls";
+        lines.push(`${YELLOW}${BOX.vertical}${RESET}      ${DIM}${sbxDesc}${RESET}${pad(innerWidth - 6 - sbxDesc.length)}${YELLOW}${BOX.vertical}${RESET}`);
+        // Empty line
+        lines.push(`${YELLOW}${BOX.vertical}${RESET}${pad(innerWidth)}${YELLOW}${BOX.vertical}${RESET}`);
+        // Bottom border
+        lines.push(`${YELLOW}${BOX.bottomLeft}${repeat(BOX.horizontal, innerWidth)}${BOX.bottomRight}${RESET}`);
+        for (let i = 0; i < lines.length; i++) {
+            output.push(CURSOR_TO(startRow + i, startCol) + lines[i]);
+        }
+        process.stdout.write(output.join(''));
+    };
+    const cleanup = () => {
+        try {
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            process.stdin.removeAllListeners("data");
+            process.stdout.write(CLEAR_SCREEN + CURSOR_HOME + CURSOR_SHOW);
+        }
+        catch {
+            // Ignore
+        }
+    };
+    render();
+    process.stdin.on("data", (key) => {
+        if (key === "\r" || key === "\n") {
+            cleanup();
+            console.log(JSON.stringify({ mode: selected }));
+            process.exit(0);
+        }
+        else if (key === "\x1b[A" || key === "k" || key === "1") {
+            selected = 'direct';
+            render();
+        }
+        else if (key === "\x1b[B" || key === "j" || key === "2") {
+            selected = 'sandbox';
+            render();
+        }
+        else if (key === "\x03" || key === "q") {
+            cleanup();
+            console.log(JSON.stringify({ mode: null, cancelled: true }));
+            process.exit(0);
+        }
+    });
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+export {};
+//# sourceMappingURL=mode-selector.js.map

package/dist/mode-selector.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,3 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function registerPrompts(server: Server): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA+DnE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAwBpD"}

package/dist/prompts/index.js

@@ -0,0 +1,79 @@
+import { ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+const TOOL_USAGE_PROMPT = `# brosh Tool Usage Guide
+
+## Overview
+This MCP server provides tools to interact with a terminal emulator. Use these tools to execute commands and read output.
+
+## Tools
+
+### type
+Send text input to the terminal. Text is written exactly as provided - no Enter key is sent automatically.
+
+To execute a command, use type() followed by sendKey('Enter').
+
+**Example workflow:**
+1. type('ls -la') - types the command
+2. sendKey('Enter') - executes it
+3. getContent() - reads the output
+
+### sendKey
+Send a special key or key combination to the terminal.
+
+**Common keys:** Enter, Tab, Escape, Backspace, Delete, ArrowUp, ArrowDown, ArrowLeft, ArrowRight
+
+**Navigation:** Home, End, PageUp, PageDown
+
+**Control sequences:**
+- Ctrl+C - interrupt current process
+- Ctrl+D - EOF/exit
+- Ctrl+Z - suspend process
+- Ctrl+L - clear screen
+- Ctrl+A - move to start of line
+- Ctrl+E - move to end of line
+
+**Function keys:** F1-F12
+
+### getContent
+Get terminal content as plain text. Use after sending commands to see output.
+
+Returns full scrollback buffer by default (up to 1000 lines). Set visibleOnly=true for just the current viewport (useful when output is very long).
+
+Prefer this over takeScreenshot when you only need text content.
+
+### takeScreenshot
+Capture terminal state as structured JSON with:
+- content: visible text
+- cursor: {x, y} position
+- dimensions: {cols, rows}
+
+Use when you need cursor position (e.g., for interactive apps, editors) or terminal dimensions. For simple command output, prefer getContent().
+`;
+const prompts = [
+    {
+        name: "tool-usage",
+        description: "Instructions for effectively using brosh tools",
+    },
+];
+export function registerPrompts(server) {
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts,
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name } = request.params;
+        if (name === "tool-usage") {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: TOOL_USAGE_PROMPT,
+                        },
+                    },
+                ],
+            };
+        }
+        throw new Error(`Unknown prompt: ${name}`);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDzB,CAAC;AAEF,MAAM,OAAO,GAAG;IACd;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,gDAAgD;KAC9D;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9D,OAAO;KACR,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEhC,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAe;wBACrB,OAAO,EAAE;4BACP,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,iBAAiB;yBACxB;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/recording/index.d.ts

@@ -0,0 +1,4 @@
+export { Recorder } from "./recorder.js";
+export { RecordingManager } from "./manager.js";
+export type { RecordingMode, RecordingFormat, RecordingOptions, AsciicastHeader, AsciicastEvent, AsciicastOutputEvent, AsciicastResizeEvent, RecordingMetadata, StopReason, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/recording/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recording/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/recording/index.js

@@ -0,0 +1,3 @@
+export { Recorder } from "./recorder.js";
+export { RecordingManager } from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/recording/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recording/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/recording/manager.d.ts

@@ -0,0 +1,62 @@
+import { Recorder } from "./recorder.js";
+import { RecordingMode, RecordingOptions, RecordingMetadata, StopReason } from "./types.js";
+/**
+ * RecordingManager tracks and manages multiple recordings
+ */
+export declare class RecordingManager {
+    private recordings;
+    private defaultOptions;
+    constructor(options?: Partial<RecordingOptions>);
+    /**
+     * Create a new recording
+     * Returns the recorder instance
+     */
+    createRecording(options?: Partial<RecordingOptions>): Recorder;
+    /**
+     * Get a recording by ID
+     */
+    getRecording(id: string): Recorder | undefined;
+    /**
+     * Check if a recording exists
+     */
+    hasRecording(id: string): boolean;
+    /**
+     * Get all active recordings
+     */
+    getActiveRecordings(): Recorder[];
+    /**
+     * Get the count of active recordings
+     */
+    getActiveCount(): number;
+    /**
+     * Record output to all active recordings
+     */
+    recordOutputToAll(data: string): void;
+    /**
+     * Record resize to all active recordings
+     */
+    recordResizeToAll(cols: number, rows: number): void;
+    /**
+     * Finalize a specific recording
+     */
+    finalizeRecording(id: string, exitCode: number | null, stopReason?: StopReason): Promise<RecordingMetadata | undefined>;
+    /**
+     * Finalize all active recordings
+     * Returns array of metadata for all finalized recordings
+     */
+    finalizeAll(exitCode: number | null, stopReason?: StopReason): Promise<RecordingMetadata[]>;
+    /**
+     * Get default recording mode
+     */
+    getDefaultMode(): RecordingMode;
+    /**
+     * Get default output directory
+     */
+    getDefaultOutputDir(): string;
+    /**
+     * Check if auto-recording is enabled (mode !== 'off')
+     */
+    isAutoRecordingEnabled(): boolean;
+    private generateId;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/recording/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/recording/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,aAAa,EAEb,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACX,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,cAAc,CAAmB;gBAE7B,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAW/C;;;OAGG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,QAAQ;IAqB9D;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI9C;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,mBAAmB,IAAI,QAAQ,EAAE;IAIjC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMrC;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMnD;;OAEG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAW7H;;;OAGG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,GAAE,UAA2B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAcjH;;OAEG;IACH,cAAc,IAAI,aAAa;IAI/B;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,sBAAsB,IAAI,OAAO;IAIjC,OAAO,CAAC,UAAU;CAGnB"}

package/dist/recording/manager.js

@@ -0,0 +1,123 @@
+import * as crypto from "crypto";
+import { Recorder } from "./recorder.js";
+import { getDefaultRecordDir } from "../utils/platform.js";
+/**
+ * RecordingManager tracks and manages multiple recordings
+ */
+export class RecordingManager {
+    recordings = new Map();
+    defaultOptions;
+    constructor(options) {
+        this.defaultOptions = {
+            mode: options?.mode ?? 'off',
+            format: options?.format ?? 'v2',
+            outputDir: options?.outputDir ?? getDefaultRecordDir(),
+            idleTimeLimit: options?.idleTimeLimit ?? 2,
+            maxDuration: options?.maxDuration ?? 3600, // 60 minutes default
+            inactivityTimeout: options?.inactivityTimeout ?? 600, // 10 minutes default
+        };
+    }
+    /**
+     * Create a new recording
+     * Returns the recorder instance
+     */
+    createRecording(options) {
+        const id = this.generateId();
+        const mergedOptions = {
+            ...this.defaultOptions,
+            ...options,
+        };
+        const recorder = new Recorder(id, mergedOptions.mode, mergedOptions.outputDir, mergedOptions.format, mergedOptions.idleTimeLimit, mergedOptions.maxDuration, mergedOptions.inactivityTimeout);
+        this.recordings.set(id, recorder);
+        return recorder;
+    }
+    /**
+     * Get a recording by ID
+     */
+    getRecording(id) {
+        return this.recordings.get(id);
+    }
+    /**
+     * Check if a recording exists
+     */
+    hasRecording(id) {
+        return this.recordings.has(id);
+    }
+    /**
+     * Get all active recordings
+     */
+    getActiveRecordings() {
+        return Array.from(this.recordings.values()).filter(r => r.isActive());
+    }
+    /**
+     * Get the count of active recordings
+     */
+    getActiveCount() {
+        return this.getActiveRecordings().length;
+    }
+    /**
+     * Record output to all active recordings
+     */
+    recordOutputToAll(data) {
+        for (const recorder of this.getActiveRecordings()) {
+            recorder.recordOutput(data);
+        }
+    }
+    /**
+     * Record resize to all active recordings
+     */
+    recordResizeToAll(cols, rows) {
+        for (const recorder of this.getActiveRecordings()) {
+            recorder.recordResize(cols, rows);
+        }
+    }
+    /**
+     * Finalize a specific recording
+     */
+    async finalizeRecording(id, exitCode, stopReason) {
+        const recorder = this.recordings.get(id);
+        if (!recorder) {
+            return undefined;
+        }
+        const metadata = await recorder.finalize(exitCode, stopReason);
+        this.recordings.delete(id);
+        return metadata;
+    }
+    /**
+     * Finalize all active recordings
+     * Returns array of metadata for all finalized recordings
+     */
+    async finalizeAll(exitCode, stopReason = 'session_exit') {
+        const results = [];
+        for (const [id, recorder] of this.recordings) {
+            if (recorder.isActive()) {
+                const metadata = await recorder.finalize(exitCode, stopReason);
+                results.push(metadata);
+            }
+            this.recordings.delete(id);
+        }
+        return results;
+    }
+    /**
+     * Get default recording mode
+     */
+    getDefaultMode() {
+        return this.defaultOptions.mode;
+    }
+    /**
+     * Get default output directory
+     */
+    getDefaultOutputDir() {
+        return this.defaultOptions.outputDir;
+    }
+    /**
+     * Check if auto-recording is enabled (mode !== 'off')
+     */
+    isAutoRecordingEnabled() {
+        return this.defaultOptions.mode !== 'off';
+    }
+    generateId() {
+        return crypto.randomBytes(8).toString('hex');
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/recording/manager.js.map

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

package/dist/recording/recorder.d.ts

@@ -0,0 +1,95 @@
+import type { RecordingMode, RecordingFormat, RecordingMetadata, StopReason } from "./types.js";
+/**
+ * Recorder handles writing asciicast v2 format recordings
+ *
+ * Asciicast v2 format:
+ * - First line: JSON header with version, dimensions, timestamp
+ * - Subsequent lines: JSON arrays [time, type, data]
+ *   - time: seconds since start (float)
+ *   - type: "o" for output, "r" for resize
+ *   - data: string content
+ */
+export declare class Recorder {
+    readonly id: string;
+    private mode;
+    private format;
+    private outputDir;
+    private tempPath;
+    private finalPath;
+    private writeStream;
+    private startTime;
+    private bytesWritten;
+    private finalized;
+    private idleTimeLimit;
+    private lastEventTime;
+    private adjustedElapsed;
+    private maxDuration;
+    private inactivityTimeout;
+    private maxDurationTimer;
+    private inactivityTimer;
+    private stopReason;
+    private onAutoFinalize?;
+    constructor(id: string, mode: RecordingMode, outputDir: string, format?: RecordingFormat, idleTimeLimit?: number, maxDuration?: number, // 60 minutes default
+    inactivityTimeout?: number);
+    /**
+     * Start the recording
+     * Writes the asciicast header to the temp file
+     */
+    start(width: number, height: number, env?: {
+        SHELL?: string;
+        TERM?: string;
+    }): void;
+    /**
+     * Record output data
+     */
+    recordOutput(data: string): void;
+    /**
+     * Record terminal resize event
+     */
+    recordResize(cols: number, rows: number): void;
+    /**
+     * Finalize the recording
+     * - For 'always' mode: move temp file to output dir
+     * - For 'on-failure' mode: move if exitCode !== 0, delete otherwise
+     *
+     * Returns metadata about the recording
+     */
+    finalize(exitCode: number | null, stopReason?: StopReason): Promise<RecordingMetadata>;
+    /**
+     * Check if recording is active
+     */
+    isActive(): boolean;
+    /**
+     * Get the temp file path (for debugging/testing)
+     */
+    getTempPath(): string;
+    /**
+     * Get the final file path
+     */
+    getFinalPath(): string;
+    private getElapsedSeconds;
+    private writeLine;
+    /**
+     * Clear all active timers
+     */
+    private clearTimers;
+    /**
+     * Auto-finalize the recording due to timeout
+     * Called internally when max duration or inactivity timeout is reached
+     */
+    private _autoFinalize;
+    /**
+     * Set callback for auto-finalize events (timeout triggered)
+     */
+    setOnAutoFinalize(callback: (metadata: RecordingMetadata) => void): void;
+    /**
+     * Get timeout configuration and remaining time
+     */
+    getTimeoutInfo(): {
+        maxDuration: number;
+        inactivityTimeout: number;
+        elapsedSeconds: number;
+        remainingMaxDuration: number;
+    };
+}
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recording/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/recording/recorder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAGf,iBAAiB,EACjB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,eAAe,CAAa;IAGpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,UAAU,CAA0B;IAG5C,OAAO,CAAC,cAAc,CAAC,CAAwC;gBAG7D,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,eAAsB,EAC9B,aAAa,GAAE,MAAU,EACzB,WAAW,GAAE,MAAa,EAAS,qBAAqB;IACxD,iBAAiB,GAAE,MAAY;IAiBjC;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA8CnF;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAoBhC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAU9C;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8G5F;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;;OAGG;YACW,aAAa;IAc3B;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI;IAIxE;;OAEG;IACH,cAAc,IAAI;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;KAC9B;CAWF"}