@ellery/terminal-mcp 0.2.1 → 0.2.2

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;IA0CnF;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkBhC;;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;IAiF5F;;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"}

package/dist/recording/recorder.js

@@ -0,0 +1,296 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+/**
+ * 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 class Recorder {
+    id;
+    mode;
+    format;
+    outputDir;
+    tempPath;
+    finalPath;
+    writeStream = null;
+    startTime = 0;
+    bytesWritten = 0;
+    finalized = false;
+    idleTimeLimit;
+    lastEventTime = 0;
+    adjustedElapsed = 0;
+    // Timeout settings
+    maxDuration;
+    inactivityTimeout;
+    maxDurationTimer = null;
+    inactivityTimer = null;
+    stopReason = 'explicit';
+    // Callback for auto-finalize events
+    onAutoFinalize;
+    constructor(id, mode, outputDir, format = 'v2', idleTimeLimit = 2, maxDuration = 3600, // 60 minutes default
+    inactivityTimeout = 600 // 10 minutes default
+    ) {
+        this.id = id;
+        this.mode = mode;
+        this.format = format;
+        this.outputDir = outputDir;
+        this.idleTimeLimit = idleTimeLimit;
+        this.maxDuration = maxDuration;
+        this.inactivityTimeout = inactivityTimeout;
+        // Generate temp and final paths
+        const timestamp = Date.now();
+        const filename = `terminal-${timestamp}-${id}.cast`;
+        this.tempPath = path.join(os.tmpdir(), `terminal-mcp-recording-${id}.cast`);
+        this.finalPath = path.join(outputDir, filename);
+    }
+    /**
+     * Start the recording
+     * Writes the asciicast header to the temp file
+     */
+    start(width, height, env) {
+        if (this.writeStream) {
+            throw new Error("Recording already started");
+        }
+        this.startTime = Date.now();
+        // Ensure output directory exists
+        fs.mkdirSync(this.outputDir, { recursive: true });
+        // Create write stream to temp file
+        this.writeStream = fs.createWriteStream(this.tempPath, { flags: 'w' });
+        // Write header
+        const header = {
+            version: 2,
+            width,
+            height,
+            timestamp: Math.floor(this.startTime / 1000),
+        };
+        if (env) {
+            header.env = env;
+        }
+        this.writeLine(JSON.stringify(header));
+        // Set up max duration timer
+        if (this.maxDuration > 0) {
+            this.maxDurationTimer = setTimeout(() => {
+                this._autoFinalize('max_duration');
+            }, this.maxDuration * 1000);
+        }
+        // Set up initial inactivity timer
+        if (this.inactivityTimeout > 0) {
+            this.inactivityTimer = setTimeout(() => {
+                this._autoFinalize('inactivity');
+            }, this.inactivityTimeout * 1000);
+        }
+    }
+    /**
+     * Record output data
+     */
+    recordOutput(data) {
+        if (!this.writeStream || this.finalized) {
+            return;
+        }
+        // Reset inactivity timer on each output event
+        if (this.inactivityTimeout > 0 && this.inactivityTimer) {
+            clearTimeout(this.inactivityTimer);
+            this.inactivityTimer = setTimeout(() => {
+                this._autoFinalize('inactivity');
+            }, this.inactivityTimeout * 1000);
+        }
+        const elapsed = this.getElapsedSeconds();
+        const event = [elapsed, 'o', data];
+        this.writeLine(JSON.stringify(event));
+    }
+    /**
+     * Record terminal resize event
+     */
+    recordResize(cols, rows) {
+        if (!this.writeStream || this.finalized) {
+            return;
+        }
+        const elapsed = this.getElapsedSeconds();
+        const event = [elapsed, 'r', `${cols}x${rows}`];
+        this.writeLine(JSON.stringify(event));
+    }
+    /**
+     * 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
+     */
+    async finalize(exitCode, stopReason) {
+        if (this.finalized) {
+            throw new Error("Recording already finalized");
+        }
+        this.finalized = true;
+        const endTime = Date.now();
+        const durationMs = endTime - this.startTime;
+        // Clear any active timers
+        this.clearTimers();
+        // Use provided stopReason or the internally tracked one
+        const finalStopReason = stopReason ?? this.stopReason;
+        // Close the write stream
+        if (this.writeStream) {
+            await new Promise((resolve, reject) => {
+                this.writeStream.end((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        }
+        let saved = false;
+        let finalPath = this.tempPath;
+        // Determine whether to save based on mode and exit code
+        const shouldSave = this.mode === 'always' ||
+            (this.mode === 'on-failure' && exitCode !== 0 && exitCode !== null);
+        if (shouldSave) {
+            // Move temp file to final location
+            try {
+                fs.renameSync(this.tempPath, this.finalPath);
+                finalPath = this.finalPath;
+                saved = true;
+            }
+            catch (err) {
+                // If rename fails (cross-device), copy and delete
+                fs.copyFileSync(this.tempPath, this.finalPath);
+                fs.unlinkSync(this.tempPath);
+                finalPath = this.finalPath;
+                saved = true;
+            }
+            // Write metadata sidecar file
+            const metaPath = this.finalPath.replace(/\.cast$/, '.meta.json');
+            const meta = {
+                exitCode,
+                durationMs,
+                startTime: this.startTime,
+                endTime,
+                bytesWritten: this.bytesWritten,
+                stopReason: finalStopReason,
+            };
+            fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2));
+        }
+        else {
+            // Delete temp file
+            try {
+                fs.unlinkSync(this.tempPath);
+            }
+            catch {
+                // Ignore if already deleted
+            }
+        }
+        return {
+            id: this.id,
+            path: saved ? finalPath : '',
+            tempPath: this.tempPath,
+            startTime: this.startTime,
+            endTime,
+            durationMs,
+            bytesWritten: this.bytesWritten,
+            exitCode,
+            mode: this.mode,
+            saved,
+            stopReason: finalStopReason,
+        };
+    }
+    /**
+     * Check if recording is active
+     */
+    isActive() {
+        return this.writeStream !== null && !this.finalized;
+    }
+    /**
+     * Get the temp file path (for debugging/testing)
+     */
+    getTempPath() {
+        return this.tempPath;
+    }
+    /**
+     * Get the final file path
+     */
+    getFinalPath() {
+        return this.finalPath;
+    }
+    getElapsedSeconds() {
+        const now = Date.now();
+        if (this.lastEventTime === 0) {
+            // First event - just record the time
+            this.lastEventTime = now;
+            this.adjustedElapsed = (now - this.startTime) / 1000;
+            return this.adjustedElapsed;
+        }
+        // Calculate actual idle time since last event
+        const idleTime = (now - this.lastEventTime) / 1000;
+        // Cap idle time if limit is set and exceeded
+        if (this.idleTimeLimit > 0 && idleTime > this.idleTimeLimit) {
+            // Only add the capped idle time to our adjusted elapsed
+            this.adjustedElapsed += this.idleTimeLimit;
+        }
+        else {
+            // Add actual idle time
+            this.adjustedElapsed += idleTime;
+        }
+        this.lastEventTime = now;
+        return this.adjustedElapsed;
+    }
+    writeLine(line) {
+        if (this.writeStream) {
+            const data = line + '\n';
+            this.writeStream.write(data);
+            this.bytesWritten += Buffer.byteLength(data, 'utf8');
+        }
+    }
+    /**
+     * Clear all active timers
+     */
+    clearTimers() {
+        if (this.maxDurationTimer) {
+            clearTimeout(this.maxDurationTimer);
+            this.maxDurationTimer = null;
+        }
+        if (this.inactivityTimer) {
+            clearTimeout(this.inactivityTimer);
+            this.inactivityTimer = null;
+        }
+    }
+    /**
+     * Auto-finalize the recording due to timeout
+     * Called internally when max duration or inactivity timeout is reached
+     */
+    async _autoFinalize(reason) {
+        if (this.finalized) {
+            return;
+        }
+        this.stopReason = reason;
+        const metadata = await this.finalize(null, reason);
+        // Notify callback if registered
+        if (this.onAutoFinalize) {
+            this.onAutoFinalize(metadata);
+        }
+    }
+    /**
+     * Set callback for auto-finalize events (timeout triggered)
+     */
+    setOnAutoFinalize(callback) {
+        this.onAutoFinalize = callback;
+    }
+    /**
+     * Get timeout configuration and remaining time
+     */
+    getTimeoutInfo() {
+        const elapsedSeconds = this.startTime > 0 ? (Date.now() - this.startTime) / 1000 : 0;
+        const remainingMaxDuration = this.maxDuration > 0 ? Math.max(0, this.maxDuration - elapsedSeconds) : -1;
+        return {
+            maxDuration: this.maxDuration,
+            inactivityTimeout: this.inactivityTimeout,
+            elapsedSeconds,
+            remainingMaxDuration,
+        };
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/recording/recorder.js.map

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

package/dist/recording/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Recording mode determines when recordings are saved
+ * - 'always': Save all recordings
+ * - 'on-failure': Only save recordings when the session exits with non-zero code
+ * - 'off': Disable recording
+ */
+export type RecordingMode = 'always' | 'on-failure' | 'off';
+/**
+ * Recording format (asciicast v2 is the only supported format)
+ */
+export type RecordingFormat = 'v2';
+/**
+ * Options for creating a recording
+ */
+export interface RecordingOptions {
+    mode: RecordingMode;
+    format: RecordingFormat;
+    outputDir: string;
+    idleTimeLimit?: number;
+    maxDuration?: number;
+    inactivityTimeout?: number;
+}
+/**
+ * Asciicast v2 header (first line of the .cast file)
+ */
+export interface AsciicastHeader {
+    version: 2;
+    width: number;
+    height: number;
+    timestamp: number;
+    env?: {
+        SHELL?: string;
+        TERM?: string;
+    };
+    title?: string;
+}
+/**
+ * Asciicast event types:
+ * - 'o': output (data written to terminal)
+ * - 'r': resize (terminal dimensions changed)
+ */
+export type AsciicastOutputEvent = [number, 'o', string];
+export type AsciicastResizeEvent = [number, 'r', string];
+export type AsciicastEvent = AsciicastOutputEvent | AsciicastResizeEvent;
+/**
+ * Reason why recording stopped
+ */
+export type StopReason = 'explicit' | 'session_exit' | 'max_duration' | 'inactivity';
+/**
+ * Metadata returned after finalizing a recording
+ */
+export interface RecordingMetadata {
+    id: string;
+    path: string;
+    tempPath: string;
+    startTime: number;
+    endTime: number;
+    durationMs: number;
+    bytesWritten: number;
+    exitCode: number | null;
+    mode: RecordingMode;
+    saved: boolean;
+    stopReason?: StopReason;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/recording/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,KAAK,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB"}

package/dist/recording/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map