@ellery/terminal-mcp 0.2.1 → 0.3.0

package/dist/terminal/manager.d.ts

@@ -1,54 +1,112 @@
 import { TerminalSession, TerminalSessionOptions, ScreenshotResult } from "./session.js";
+import type { SandboxController } from "../sandbox/index.js";
+import { RecordingManager } from "../recording/index.js";
+import type { RecordingMode, RecordingFormat, RecordingMetadata } from "../recording/index.js";
+export interface TerminalManagerOptions extends TerminalSessionOptions {
+    sandboxController?: SandboxController;
+    record?: RecordingMode;
+    recordDir?: string;
+    recordFormat?: RecordingFormat;
+    idleTimeLimit?: number;
+    maxDuration?: number;
+    inactivityTimeout?: number;
+    maxSessions?: number;
+    sessionIdleTimeout?: number;
+}
+export interface CreateSessionOptions {
+    shell?: string;
+    cols?: number;
+    rows?: number;
+}
+export interface SessionMetadata {
+    sessionId: string;
+    shell: string;
+    cols: number;
+    rows: number;
+    createdAt: string;
+    lastActivityAt: string;
+    isDefault: boolean;
+}
 /**
- * Manages the terminal session lifecycle
- * Currently supports a single session for simplicity
+ * Manages one or more terminal sessions in a single process.
+ *
+ * The "default" session is created lazily on first access and is never
+ * idle-evicted; it's what the existing single-session API operates on
+ * when no sessionId is passed. Additional sessions can be created via
+ * createSession() and addressed by ID.
  */
 export declare class TerminalManager {
-    private session;
+    private sessions;
+    private defaultSessionId;
+    private defaultSessionPromise;
+    private idleCheckInterval;
     private options;
-    constructor(options?: TerminalSessionOptions);
-    /**
-     * Get or create the terminal session
-     */
-    getSession(): TerminalSession;
-    /**
-     * Check if a session exists and is active
-     */
-    hasActiveSession(): boolean;
+    private sandboxController?;
+    private recordingManager;
+    private autoRecordingId;
+    private maxSessions;
+    private sessionIdleTimeoutMs;
+    constructor(options?: TerminalManagerOptions);
+    private generateSessionId;
+    private touchSession;
+    private cleanupIdleSessions;
     /**
-     * Write data to the terminal
+     * Wire recording hooks onto a session so its output is captured by any
+     * active recordings.
      */
-    write(data: string): void;
+    private wireRecording;
     /**
-     * Get terminal content
+     * Get or create the default session. Idempotent and concurrency-safe.
      */
-    getContent(): string;
+    getSessionAsync(): Promise<TerminalSession>;
+    getCurrentSession(): TerminalSession | null;
     /**
-     * Get visible content only
+     * @deprecated Use getSessionAsync(). Throws if the default session
+     * hasn't been created yet.
      */
-    getVisibleContent(): string;
-    /**
-     * Take a screenshot
-     */
-    takeScreenshot(): ScreenshotResult;
+    getSession(): TerminalSession;
+    initSession(): Promise<TerminalSession>;
+    private startAutoRecording;
     /**
-     * Clear the terminal
+     * Create a new non-default session.
      */
-    clear(): void;
+    createSession(opts?: CreateSessionOptions): Promise<SessionMetadata>;
+    destroySession(sessionId: string): {
+        success: boolean;
+        message: string;
+    };
+    listSessions(): {
+        sessions: SessionMetadata[];
+        maxSessions: number;
+        sessionIdleTimeout: number;
+    };
     /**
-     * Resize the terminal
+     * Resolve a session by ID. If sessionId is omitted/undefined, returns the
+     * default session (creating it if needed).
      */
-    resize(cols: number, rows: number): void;
+    resolveSession(sessionId?: string): Promise<TerminalSession>;
     /**
-     * Get terminal dimensions
+     * Synchronous variant of resolveSession() — requires the session to
+     * already exist. Throws if not created yet (used by sync tool handlers).
      */
-    getDimensions(): {
+    resolveSessionSync(sessionId?: string): TerminalSession;
+    hasActiveSession(): boolean;
+    write(data: string, sessionId?: string): void;
+    getContent(sessionId?: string): string;
+    getVisibleContent(sessionId?: string): string;
+    getAnsiContent(visibleOnly?: boolean, sessionId?: string): string;
+    getTerminal(sessionId?: string): import("@xterm/headless").Terminal;
+    takeScreenshot(sessionId?: string): ScreenshotResult;
+    clear(sessionId?: string): void;
+    resize(cols: number, rows: number, sessionId?: string): void;
+    getDimensions(sessionId?: string): {
         cols: number;
         rows: number;
     };
-    /**
-     * Dispose of the current session
-     */
+    getRecordingManager(): RecordingManager;
+    finalizeRecordings(exitCode: number): Promise<RecordingMetadata[]>;
     dispose(): void;
+    disposeAsync(): Promise<void>;
+    getSandboxController(): SandboxController | undefined;
 }
 //# sourceMappingURL=manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/terminal/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzF;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,GAAE,sBAA2B;IAIhD;;OAEG;IACH,UAAU,IAAI,eAAe;IAO7B;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,cAAc,IAAI,gBAAgB;IAIlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAI/C;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/terminal/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/F,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAYD;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,qBAAqB,CAAyC;IACtE,OAAO,CAAC,iBAAiB,CAA+B;IAExD,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,OAAO,GAAE,sBAA2B;IAuBhD,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,mBAAmB;IAY3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAiDjD,iBAAiB,IAAI,eAAe,GAAG,IAAI;IAM3C;;;OAGG;IACH,UAAU,IAAI,eAAe;IAUvB,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAQ7C,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACG,aAAa,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsC9E,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAgBxE,YAAY,IAAI;QACd,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;KAC5B;IAgBD;;;OAGG;IACG,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBlE;;;OAGG;IACH,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe;IAoBvD,gBAAgB,IAAI,OAAO;IAI3B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7C,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAItC,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAI7C,cAAc,CAAC,WAAW,UAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAI/D,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM;IAI9B,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAIpD,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5D,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAQjE,mBAAmB,IAAI,gBAAgB;IAIjC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxE,OAAO,IAAI,IAAI;IAYT,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,oBAAoB,IAAI,iBAAiB,GAAG,SAAS;CAGtD"}

package/dist/terminal/manager.js

@@ -1,79 +1,348 @@
+import { randomBytes } from "crypto";
 import { TerminalSession } from "./session.js";
+import { RecordingManager } from "../recording/index.js";
+import { getDefaultRecordDir } from "../utils/platform.js";
+const DEFAULT_MAX_SESSIONS = 5;
+const DEFAULT_SESSION_IDLE_TIMEOUT = 600; // 10 minutes
 /**
- * Manages the terminal session lifecycle
- * Currently supports a single session for simplicity
+ * Manages one or more terminal sessions in a single process.
+ *
+ * The "default" session is created lazily on first access and is never
+ * idle-evicted; it's what the existing single-session API operates on
+ * when no sessionId is passed. Additional sessions can be created via
+ * createSession() and addressed by ID.
  */
 export class TerminalManager {
-    session = null;
+    sessions = new Map();
+    defaultSessionId = null;
+    defaultSessionPromise = null;
+    idleCheckInterval = null;
     options;
+    sandboxController;
+    recordingManager;
+    autoRecordingId = null;
+    maxSessions;
+    sessionIdleTimeoutMs;
     constructor(options = {}) {
         this.options = options;
+        this.sandboxController = options.sandboxController;
+        this.recordingManager = new RecordingManager({
+            mode: options.record ?? 'off',
+            outputDir: options.recordDir ?? getDefaultRecordDir(),
+            format: options.recordFormat ?? 'v2',
+            idleTimeLimit: options.idleTimeLimit ?? 2,
+            maxDuration: options.maxDuration ?? 3600,
+            inactivityTimeout: options.inactivityTimeout ?? 600,
+        });
+        this.maxSessions = options.maxSessions ?? DEFAULT_MAX_SESSIONS;
+        this.sessionIdleTimeoutMs = (options.sessionIdleTimeout ?? DEFAULT_SESSION_IDLE_TIMEOUT) * 1000;
+        // Periodic idle cleanup for non-default sessions
+        this.idleCheckInterval = setInterval(() => this.cleanupIdleSessions(), 60 * 1000);
+        this.idleCheckInterval.unref();
     }
-    /**
-     * Get or create the terminal session
-     */
-    getSession() {
-        if (!this.session || !this.session.isActive()) {
-            this.session = new TerminalSession(this.options);
+    // ---------------------------------------------------------------------------
+    // Session lookup helpers
+    // ---------------------------------------------------------------------------
+    generateSessionId() {
+        while (true) {
+            const id = randomBytes(3).toString("hex").slice(0, 5);
+            if (!this.sessions.has(id))
+                return id;
         }
-        return this.session;
     }
-    /**
-     * Check if a session exists and is active
-     */
-    hasActiveSession() {
-        return this.session !== null && this.session.isActive();
+    touchSession(sessionId) {
+        const entry = this.sessions.get(sessionId);
+        if (entry) {
+            entry.lastActivity = Date.now();
+            entry.metadata.lastActivityAt = new Date().toISOString();
+        }
     }
-    /**
-     * Write data to the terminal
-     */
-    write(data) {
-        this.getSession().write(data);
+    cleanupIdleSessions() {
+        const now = Date.now();
+        // Snapshot to avoid mutation-during-iteration
+        for (const [sessionId, entry] of Array.from(this.sessions.entries())) {
+            if (entry.isDefault)
+                continue;
+            if (now - entry.lastActivity > this.sessionIdleTimeoutMs) {
+                entry.session.dispose();
+                this.sessions.delete(sessionId);
+            }
+        }
     }
     /**
-     * Get terminal content
+     * Wire recording hooks onto a session so its output is captured by any
+     * active recordings.
      */
-    getContent() {
-        return this.getSession().getContent();
+    wireRecording(session) {
+        session.onData((data) => this.recordingManager.recordOutputToAll(data));
+        session.onResize((cols, rows) => this.recordingManager.recordResizeToAll(cols, rows));
     }
+    // ---------------------------------------------------------------------------
+    // Default session (single-session API surface)
+    // ---------------------------------------------------------------------------
     /**
-     * Get visible content only
+     * Get or create the default session. Idempotent and concurrency-safe.
      */
-    getVisibleContent() {
-        return this.getSession().getVisibleContent();
+    async getSessionAsync() {
+        if (this.defaultSessionId) {
+            const entry = this.sessions.get(this.defaultSessionId);
+            if (entry && entry.session.isActive()) {
+                this.touchSession(this.defaultSessionId);
+                return entry.session;
+            }
+            this.defaultSessionId = null;
+        }
+        if (this.defaultSessionPromise) {
+            return this.defaultSessionPromise;
+        }
+        this.defaultSessionPromise = (async () => {
+            const session = await TerminalSession.create({
+                ...this.options,
+                sandboxController: this.sandboxController,
+            });
+            const id = this.generateSessionId();
+            const dims = session.getDimensions();
+            const now = new Date().toISOString();
+            const entry = {
+                session,
+                metadata: {
+                    sessionId: id,
+                    shell: this.options.shell ?? process.env.SHELL ?? "/bin/bash",
+                    cols: dims.cols,
+                    rows: dims.rows,
+                    createdAt: now,
+                    lastActivityAt: now,
+                    isDefault: true,
+                },
+                lastActivity: Date.now(),
+                isDefault: true,
+            };
+            this.sessions.set(id, entry);
+            this.defaultSessionId = id;
+            this.wireRecording(session);
+            return session;
+        })();
+        try {
+            return await this.defaultSessionPromise;
+        }
+        finally {
+            this.defaultSessionPromise = null;
+        }
     }
-    /**
-     * Take a screenshot
-     */
-    takeScreenshot() {
-        return this.getSession().takeScreenshot();
+    getCurrentSession() {
+        if (!this.defaultSessionId)
+            return null;
+        const entry = this.sessions.get(this.defaultSessionId);
+        return entry && entry.session.isActive() ? entry.session : null;
     }
     /**
-     * Clear the terminal
+     * @deprecated Use getSessionAsync(). Throws if the default session
+     * hasn't been created yet.
      */
-    clear() {
-        this.getSession().clear();
+    getSession() {
+        const session = this.getCurrentSession();
+        if (!session) {
+            throw new Error("Session not initialized. Use getSessionAsync() or call initSession() first.");
+        }
+        return session;
+    }
+    async initSession() {
+        const session = await this.getSessionAsync();
+        if (this.options.record && this.options.record !== 'off') {
+            this.startAutoRecording();
+        }
+        return session;
     }
+    startAutoRecording() {
+        if (this.autoRecordingId)
+            return;
+        const recorder = this.recordingManager.createRecording({
+            mode: this.options.record,
+            outputDir: this.options.recordDir ?? getDefaultRecordDir(),
+            format: this.options.recordFormat ?? 'v2',
+            idleTimeLimit: this.options.idleTimeLimit ?? 2,
+            maxDuration: this.options.maxDuration ?? 3600,
+            inactivityTimeout: this.options.inactivityTimeout ?? 600,
+        });
+        const session = this.getCurrentSession();
+        const dimensions = session?.getDimensions() ?? { cols: 120, rows: 40 };
+        recorder.start(dimensions.cols, dimensions.rows, {
+            SHELL: this.options.shell ?? process.env.SHELL,
+            TERM: 'xterm-256color',
+        });
+        this.autoRecordingId = recorder.id;
+    }
+    // ---------------------------------------------------------------------------
+    // Multi-session API
+    // ---------------------------------------------------------------------------
     /**
-     * Resize the terminal
+     * Create a new non-default session.
      */
-    resize(cols, rows) {
-        this.getSession().resize(cols, rows);
+    async createSession(opts = {}) {
+        if (this.sessions.size >= this.maxSessions) {
+            throw new Error(`Maximum session limit reached (${this.maxSessions}). ` +
+                `Destroy an existing session or raise --max-sessions.`);
+        }
+        const id = this.generateSessionId();
+        const session = await TerminalSession.create({
+            ...this.options,
+            shell: opts.shell ?? this.options.shell,
+            cols: opts.cols ?? this.options.cols,
+            rows: opts.rows ?? this.options.rows,
+            // Created sessions don't share the interactive startup banner
+            startupBanner: undefined,
+            sandboxController: this.sandboxController,
+        });
+        const dims = session.getDimensions();
+        const now = new Date().toISOString();
+        const metadata = {
+            sessionId: id,
+            shell: opts.shell ?? this.options.shell ?? process.env.SHELL ?? "/bin/bash",
+            cols: dims.cols,
+            rows: dims.rows,
+            createdAt: now,
+            lastActivityAt: now,
+            isDefault: false,
+        };
+        this.sessions.set(id, {
+            session,
+            metadata,
+            lastActivity: Date.now(),
+            isDefault: false,
+        });
+        this.wireRecording(session);
+        return metadata;
+    }
+    destroySession(sessionId) {
+        const entry = this.sessions.get(sessionId);
+        if (!entry) {
+            return { success: false, message: `Session '${sessionId}' not found` };
+        }
+        if (entry.isDefault) {
+            return {
+                success: false,
+                message: `Session '${sessionId}' is the default session and cannot be destroyed`,
+            };
+        }
+        entry.session.dispose();
+        this.sessions.delete(sessionId);
+        return { success: true, message: `Session '${sessionId}' destroyed` };
+    }
+    listSessions() {
+        const sessions = [];
+        for (const [sessionId, entry] of Array.from(this.sessions.entries())) {
+            if (entry.session.isActive()) {
+                sessions.push({ ...entry.metadata });
+            }
+            else {
+                this.sessions.delete(sessionId);
+            }
+        }
+        return {
+            sessions,
+            maxSessions: this.maxSessions,
+            sessionIdleTimeout: this.sessionIdleTimeoutMs / 1000,
+        };
     }
     /**
-     * Get terminal dimensions
+     * Resolve a session by ID. If sessionId is omitted/undefined, returns the
+     * default session (creating it if needed).
      */
-    getDimensions() {
-        return this.getSession().getDimensions();
+    async resolveSession(sessionId) {
+        if (!sessionId) {
+            return this.getSessionAsync();
+        }
+        const entry = this.sessions.get(sessionId);
+        if (!entry) {
+            throw new Error(`Session '${sessionId}' not found`);
+        }
+        if (!entry.session.isActive()) {
+            this.sessions.delete(sessionId);
+            throw new Error(`Session '${sessionId}' is no longer active`);
+        }
+        this.touchSession(sessionId);
+        return entry.session;
     }
     /**
-     * Dispose of the current session
+     * Synchronous variant of resolveSession() — requires the session to
+     * already exist. Throws if not created yet (used by sync tool handlers).
      */
+    resolveSessionSync(sessionId) {
+        if (!sessionId) {
+            return this.getSession();
+        }
+        const entry = this.sessions.get(sessionId);
+        if (!entry) {
+            throw new Error(`Session '${sessionId}' not found`);
+        }
+        if (!entry.session.isActive()) {
+            this.sessions.delete(sessionId);
+            throw new Error(`Session '${sessionId}' is no longer active`);
+        }
+        this.touchSession(sessionId);
+        return entry.session;
+    }
+    // ---------------------------------------------------------------------------
+    // Single-session shortcuts (now sessionId-aware)
+    // ---------------------------------------------------------------------------
+    hasActiveSession() {
+        return this.getCurrentSession() !== null;
+    }
+    write(data, sessionId) {
+        this.resolveSessionSync(sessionId).write(data);
+    }
+    getContent(sessionId) {
+        return this.resolveSessionSync(sessionId).getContent();
+    }
+    getVisibleContent(sessionId) {
+        return this.resolveSessionSync(sessionId).getVisibleContent();
+    }
+    getAnsiContent(visibleOnly = false, sessionId) {
+        return this.resolveSessionSync(sessionId).getAnsiContent(visibleOnly);
+    }
+    getTerminal(sessionId) {
+        return this.resolveSessionSync(sessionId).getTerminal();
+    }
+    takeScreenshot(sessionId) {
+        return this.resolveSessionSync(sessionId).takeScreenshot();
+    }
+    clear(sessionId) {
+        this.resolveSessionSync(sessionId).clear();
+    }
+    resize(cols, rows, sessionId) {
+        this.resolveSessionSync(sessionId).resize(cols, rows);
+    }
+    getDimensions(sessionId) {
+        return this.resolveSessionSync(sessionId).getDimensions();
+    }
+    // ---------------------------------------------------------------------------
+    // Recording / lifecycle
+    // ---------------------------------------------------------------------------
+    getRecordingManager() {
+        return this.recordingManager;
+    }
+    async finalizeRecordings(exitCode) {
+        return this.recordingManager.finalizeAll(exitCode);
+    }
     dispose() {
-        if (this.session) {
-            this.session.dispose();
-            this.session = null;
+        if (this.idleCheckInterval) {
+            clearInterval(this.idleCheckInterval);
+            this.idleCheckInterval = null;
+        }
+        for (const [, entry] of this.sessions) {
+            entry.session.dispose();
         }
+        this.sessions.clear();
+        this.defaultSessionId = null;
+    }
+    async disposeAsync() {
+        this.dispose();
+        if (this.sandboxController) {
+            await this.sandboxController.cleanup();
+        }
+    }
+    getSandboxController() {
+        return this.sandboxController;
     }
 }
 //# sourceMappingURL=manager.js.map

package/dist/terminal/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/terminal/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA4C,MAAM,cAAc,CAAC;AAEzF;;;GAGG;AACH,MAAM,OAAO,eAAe;IAClB,OAAO,GAA2B,IAAI,CAAC;IACvC,OAAO,CAAyB;IAExC,YAAY,UAAkC,EAAE;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,iBAAiB,EAAE,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,cAAc,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY,EAAE,IAAY;QAC/B,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/terminal/manager.ts"],"names":[],"mappings":"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"}

package/dist/terminal/session.d.ts

@@ -1,3 +1,6 @@
+import xtermHeadless from "@xterm/headless";
+declare const Terminal: typeof xtermHeadless.Terminal;
+import type { SandboxController } from "../sandbox/index.js";
 export interface TerminalSessionOptions {
     cols?: number;
     rows?: number;
@@ -5,6 +8,7 @@ export interface TerminalSessionOptions {
     cwd?: string;
     env?: Record<string, string>;
     startupBanner?: string;
+    sandboxController?: SandboxController;
 }
 export interface ScreenshotResult {
     content: string;
@@ -27,14 +31,28 @@ export declare class TerminalSession {
     private disposed;
     private dataListeners;
     private exitListeners;
+    private resizeListeners;
     private rcFile;
     private zdotdir;
+    /**
+     * Private constructor - use TerminalSession.create() instead
+     */
+    private constructor();
+    /**
+     * Factory method to create a TerminalSession
+     * Use this instead of the constructor to support async sandbox initialization
+     */
+    static create(options?: TerminalSessionOptions): Promise<TerminalSession>;
     /**
      * Set up shell-specific prompt customization
      * Returns args to pass to shell and env modifications
      */
     private setupShellPrompt;
-    constructor(options?: TerminalSessionOptions);
+    /**
+     * Initialize the terminal session
+     * This is called by the create() factory method
+     */
+    private initialize;
     /**
      * Subscribe to PTY output data
      */
@@ -43,6 +61,10 @@ export declare class TerminalSession {
      * Subscribe to PTY exit
      */
     onExit(listener: (code: number) => void): void;
+    /**
+     * Subscribe to terminal resize events
+     */
+    onResize(listener: (cols: number, rows: number) => void): void;
     /**
      * Write data to the terminal (simulates typing)
      */
@@ -51,6 +73,11 @@ export declare class TerminalSession {
      * Get the current terminal buffer content as plain text
      */
     getContent(): string;
+    /**
+     * Get terminal content with ANSI color escape sequences preserved.
+     * Reads the xterm.js cell buffer and reconstructs SGR sequences.
+     */
+    getAnsiContent(visibleOnly?: boolean): string;
     /**
      * Get only the visible viewport content
      */
@@ -71,6 +98,11 @@ export declare class TerminalSession {
      * Check if the session is still active
      */
     isActive(): boolean;
+    /**
+     * Get the underlying xterm.js Terminal instance for direct buffer access.
+     * Used by the color screenshot renderer.
+     */
+    getTerminal(): InstanceType<typeof Terminal>;
     /**
      * Get terminal dimensions
      */
@@ -83,4 +115,5 @@ export declare class TerminalSession {
      */
     dispose(): void;
 }
+export {};
 //# sourceMappingURL=session.d.ts.map

package/dist/terminal/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/terminal/session.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAW;IAC7B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,aAAa,CAAqC;IAE1D,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAuB;IAEtC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;gBA6EZ,OAAO,GAAE,sBAA2B;IA6ChD;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB;;OAEG;IACH,UAAU,IAAI,MAAM;IAwBpB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAmB3B;;OAEG;IACH,cAAc,IAAI,gBAAgB;IAoBlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAO/C;;OAEG;IACH,OAAO,IAAI,IAAI;CAuBhB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/terminal/session.ts"],"names":[],"mappings":"AAIA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,QAAA,MAAQ,QAAQ,+BAAkB,CAAC;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAK7D,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,eAAe,CAAmD;IAE1E,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAuB;IAEtC;;OAEG;IACH,OAAO;IAEP;;;OAGG;WACU,MAAM,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;IAMnF;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA6ExB;;;OAGG;YACW,UAAU;IA6DxB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI9D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB;;OAEG;IACH,UAAU,IAAI,MAAM;IAwBpB;;;OAGG;IACH,cAAc,CAAC,WAAW,UAAQ,GAAG,MAAM;IAiH3C;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAmB3B;;OAEG;IACH,cAAc,IAAI,gBAAgB;IAoBlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAaxC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,WAAW,IAAI,YAAY,CAAC,OAAO,QAAQ,CAAC;IAO5C;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAO/C;;OAEG;IACH,OAAO,IAAI,IAAI;CAuBhB"}