@ellery/terminal-mcp 0.2.1 → 0.3.0

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

package/dist/recording/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/recording/types.ts"],"names":[],"mappings":""}

package/dist/sandbox/config.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Sandbox filesystem permission configuration
+ */
+export interface FilesystemPermissions {
+    /** Paths with full read/write access */
+    readWrite: string[];
+    /** Paths with read-only access */
+    readOnly: string[];
+    /** Paths completely blocked from access */
+    blocked: string[];
+}
+/**
+ * Sandbox network permission configuration
+ */
+export interface NetworkPermissions {
+    /** Network access mode */
+    mode: "all" | "none" | "allowlist";
+    /** Allowed domains when mode is 'allowlist' */
+    allowedDomains?: string[];
+}
+/**
+ * Full sandbox permissions configuration
+ */
+export interface SandboxPermissions {
+    filesystem: FilesystemPermissions;
+    network: NetworkPermissions;
+}
+/**
+ * Default permissions for sandbox mode
+ * Provides reasonable defaults while blocking sensitive directories
+ * Allows shell-related files to be writable for normal shell operation
+ */
+export declare const DEFAULT_PERMISSIONS: SandboxPermissions;
+/**
+ * Expand ~ to home directory in a path
+ */
+export declare function expandPath(p: string): string;
+/**
+ * Load sandbox configuration from a JSON file
+ */
+export declare function loadConfigFromFile(filePath: string): SandboxPermissions;
+/**
+ * Merge user selections with defaults
+ */
+export declare function mergePermissions(base: SandboxPermissions, overrides: Partial<SandboxPermissions>): SandboxPermissions;
+//# sourceMappingURL=config.d.ts.map

package/dist/sandbox/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/sandbox/config.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC;IACnC,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,qBAAqB,CAAC;IAClC,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,kBA+CjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAiBvE;AA+DD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACrC,kBAAkB,CAYpB"}

package/dist/sandbox/config.js

@@ -0,0 +1,144 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+/**
+ * Default permissions for sandbox mode
+ * Provides reasonable defaults while blocking sensitive directories
+ * Allows shell-related files to be writable for normal shell operation
+ */
+export const DEFAULT_PERMISSIONS = {
+    filesystem: {
+        readWrite: [
+            // Core paths
+            ".", // Current working directory
+            "/tmp", // Temp files
+            // Shell operation
+            "~/.cache", // Cache files (oh-my-zsh, etc.)
+            "~/.local", // Local user data
+            "~/.zsh_history", // Zsh history
+            "~/.bash_history", // Bash history
+            "~/.node_repl_history", // Node REPL history
+            "~/.python_history", // Python history
+            // Package managers
+            "~/.npm",
+            "~/.yarn",
+            "~/.pnpm",
+            "~/.bun",
+        ],
+        readOnly: [
+            "~", // Home directory (general read access)
+        ],
+        blocked: [
+            // SSH/GPG
+            "~/.ssh",
+            "~/.gnupg",
+            // Cloud credentials
+            "~/.aws",
+            "~/.config/gcloud",
+            "~/.azure",
+            "~/.kube",
+            // CLI credentials
+            "~/.config/gh",
+            // Auth tokens
+            "~/.npmrc",
+            "~/.netrc",
+            "~/.docker/config.json",
+        ],
+    },
+    network: {
+        mode: "all",
+    },
+};
+/**
+ * Expand ~ to home directory in a path
+ */
+export function expandPath(p) {
+    if (p.startsWith("~/")) {
+        return path.join(os.homedir(), p.slice(2));
+    }
+    if (p === "~") {
+        return os.homedir();
+    }
+    if (p === ".") {
+        return process.cwd();
+    }
+    return path.resolve(p);
+}
+/**
+ * Load sandbox configuration from a JSON file
+ */
+export function loadConfigFromFile(filePath) {
+    const expandedPath = expandPath(filePath);
+    if (!fs.existsSync(expandedPath)) {
+        throw new Error(`Sandbox config file not found: ${expandedPath}`);
+    }
+    const content = fs.readFileSync(expandedPath, "utf-8");
+    let config;
+    try {
+        config = JSON.parse(content);
+    }
+    catch {
+        throw new Error(`Invalid JSON in sandbox config file: ${expandedPath}`);
+    }
+    return validateConfig(config);
+}
+/**
+ * Validate and normalize a config object
+ */
+function validateConfig(config) {
+    if (typeof config !== "object" || config === null) {
+        throw new Error("Sandbox config must be an object");
+    }
+    const obj = config;
+    const result = {
+        filesystem: {
+            readWrite: [],
+            readOnly: [],
+            blocked: [],
+        },
+        network: {
+            mode: "all",
+        },
+    };
+    // Validate filesystem config
+    if (obj.filesystem && typeof obj.filesystem === "object") {
+        const fs = obj.filesystem;
+        if (Array.isArray(fs.readWrite)) {
+            result.filesystem.readWrite = fs.readWrite.filter((p) => typeof p === "string");
+        }
+        if (Array.isArray(fs.readOnly)) {
+            result.filesystem.readOnly = fs.readOnly.filter((p) => typeof p === "string");
+        }
+        if (Array.isArray(fs.blocked)) {
+            result.filesystem.blocked = fs.blocked.filter((p) => typeof p === "string");
+        }
+    }
+    // Validate network config
+    if (obj.network && typeof obj.network === "object") {
+        const net = obj.network;
+        if (net.mode === "all" || net.mode === "none" || net.mode === "allowlist") {
+            result.network.mode = net.mode;
+        }
+        if (Array.isArray(net.allowedDomains)) {
+            result.network.allowedDomains = net.allowedDomains.filter((d) => typeof d === "string");
+        }
+    }
+    return result;
+}
+/**
+ * Merge user selections with defaults
+ */
+export function mergePermissions(base, overrides) {
+    return {
+        filesystem: {
+            readWrite: overrides.filesystem?.readWrite ?? base.filesystem.readWrite,
+            readOnly: overrides.filesystem?.readOnly ?? base.filesystem.readOnly,
+            blocked: overrides.filesystem?.blocked ?? base.filesystem.blocked,
+        },
+        network: {
+            mode: overrides.network?.mode ?? base.network.mode,
+            allowedDomains: overrides.network?.allowedDomains ?? base.network.allowedDomains,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map