brosh 0.2.2

package/dist/terminal/manager.d.ts

@@ -0,0 +1,153 @@
+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";
+/**
+ * Options for creating a TerminalManager
+ */
+export interface TerminalManagerOptions extends TerminalSessionOptions {
+    sandboxController?: SandboxController;
+    record?: RecordingMode;
+    recordDir?: string;
+    recordFormat?: RecordingFormat;
+    idleTimeLimit?: number;
+    maxDuration?: number;
+    inactivityTimeout?: number;
+    /** Skip prompt customization and use user's native shell config */
+    nativeShell?: boolean;
+}
+/**
+ * Options for creating an individual session
+ */
+export interface CreateSessionOptions {
+    cols?: number;
+    rows?: number;
+    shell?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+/**
+ * Extended session with ID for multi-session support
+ */
+export interface ManagedSession extends TerminalSession {
+    id: string;
+}
+/**
+ * Manages the terminal session lifecycle
+ * Supports both single-session (legacy) and multi-session modes
+ */
+export declare class TerminalManager {
+    private session;
+    private sessionPromise;
+    private sessions;
+    private sessionCounter;
+    private options;
+    private sandboxController?;
+    private recordingManager;
+    private autoRecordingId;
+    constructor(options?: TerminalManagerOptions);
+    /**
+     * Get the default shell path
+     */
+    getDefaultShell(): string;
+    /**
+     * Create a new terminal session with a unique ID
+     */
+    createSession(options?: CreateSessionOptions): Promise<ManagedSession>;
+    /**
+     * Get a session by ID
+     */
+    getSessionById(sessionId: string): TerminalSession | null;
+    /**
+     * Close a session by ID
+     */
+    closeSession(sessionId: string): boolean;
+    /**
+     * Get all active session IDs
+     */
+    getSessionIds(): string[];
+    /**
+     * Get count of active sessions
+     */
+    getSessionCount(): number;
+    /**
+     * Get or create the terminal session (async)
+     */
+    getSessionAsync(): Promise<TerminalSession>;
+    /**
+     * Get the current session if it exists and is active
+     * Returns null if no session exists yet
+     */
+    getCurrentSession(): TerminalSession | null;
+    /**
+     * @deprecated Use getSessionAsync() instead. This method exists for backwards compatibility
+     * but will throw if the session hasn't been created yet.
+     */
+    getSession(): TerminalSession;
+    /**
+     * Initialize the session eagerly
+     * Call this at startup to create the session before it's needed
+     */
+    initSession(): Promise<TerminalSession>;
+    /**
+     * Start auto-recording based on CLI options
+     */
+    private startAutoRecording;
+    /**
+     * Get the RecordingManager instance
+     */
+    getRecordingManager(): RecordingManager;
+    /**
+     * Finalize all recordings and return their metadata
+     * Called by the caller when the session exits
+     */
+    finalizeRecordings(exitCode: number): Promise<RecordingMetadata[]>;
+    /**
+     * Check if a session exists and is active
+     */
+    hasActiveSession(): boolean;
+    /**
+     * Write data to the terminal
+     */
+    write(data: string): void;
+    /**
+     * Get terminal content
+     */
+    getContent(): string;
+    /**
+     * Get visible content only
+     */
+    getVisibleContent(): string;
+    /**
+     * Take a screenshot
+     */
+    takeScreenshot(): ScreenshotResult;
+    /**
+     * Clear the terminal
+     */
+    clear(): void;
+    /**
+     * Resize the terminal
+     */
+    resize(cols: number, rows: number): void;
+    /**
+     * Get terminal dimensions
+     */
+    getDimensions(): {
+        cols: number;
+        rows: number;
+    };
+    /**
+     * Dispose of the current session and cleanup sandbox
+     */
+    dispose(): void;
+    /**
+     * Async dispose that also cleans up sandbox resources
+     */
+    disposeAsync(): Promise<void>;
+    /**
+     * Get the sandbox controller if one is configured
+     */
+    getSandboxController(): SandboxController | undefined;
+}
+//# sourceMappingURL=manager.d.ts.map

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

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

package/dist/terminal/manager.js

@@ -0,0 +1,276 @@
+import { TerminalSession } from "./session.js";
+import { RecordingManager } from "../recording/index.js";
+import { getDefaultRecordDir, getDefaultShell } from "../utils/platform.js";
+import { randomUUID } from "crypto";
+/**
+ * Manages the terminal session lifecycle
+ * Supports both single-session (legacy) and multi-session modes
+ */
+export class TerminalManager {
+    // Legacy single-session support
+    session = null;
+    sessionPromise = null;
+    // Multi-session support
+    sessions = new Map();
+    sessionCounter = 0;
+    options;
+    sandboxController;
+    recordingManager;
+    autoRecordingId = null;
+    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,
+        });
+    }
+    /**
+     * Get the default shell path
+     */
+    getDefaultShell() {
+        return this.options.shell || getDefaultShell();
+    }
+    // =========================================================================
+    // Multi-Session API (for GUI/Electron)
+    // =========================================================================
+    /**
+     * Create a new terminal session with a unique ID
+     */
+    async createSession(options = {}) {
+        const sessionId = `session-${++this.sessionCounter}-${randomUUID().slice(0, 8)}`;
+        const session = await TerminalSession.create({
+            cols: options.cols ?? this.options.cols ?? 120,
+            rows: options.rows ?? this.options.rows ?? 40,
+            shell: options.shell ?? this.options.shell,
+            cwd: options.cwd ?? this.options.cwd,
+            env: options.env ?? this.options.env,
+            nativeShell: this.options.nativeShell,
+            setLocaleEnv: this.options.setLocaleEnv,
+            sandboxController: this.sandboxController,
+        });
+        // Store in map
+        this.sessions.set(sessionId, session);
+        // Wire up recording hooks
+        session.onData((data) => this.recordingManager.recordOutputToAll(data));
+        session.onResize((cols, rows) => this.recordingManager.recordResizeToAll(cols, rows));
+        // Clean up when session exits
+        session.onExit(() => {
+            this.sessions.delete(sessionId);
+        });
+        // Return session with ID attached
+        const managedSession = session;
+        managedSession.id = sessionId;
+        return managedSession;
+    }
+    /**
+     * Get a session by ID
+     */
+    getSessionById(sessionId) {
+        return this.sessions.get(sessionId) ?? null;
+    }
+    /**
+     * Close a session by ID
+     */
+    closeSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.dispose();
+            this.sessions.delete(sessionId);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get all active session IDs
+     */
+    getSessionIds() {
+        return Array.from(this.sessions.keys());
+    }
+    /**
+     * Get count of active sessions
+     */
+    getSessionCount() {
+        return this.sessions.size;
+    }
+    // =========================================================================
+    // Legacy Single-Session API (for CLI/MCP compatibility)
+    // =========================================================================
+    /**
+     * Get or create the terminal session (async)
+     */
+    async getSessionAsync() {
+        if (this.session && this.session.isActive()) {
+            return this.session;
+        }
+        // If there's already a creation in progress, wait for it
+        if (this.sessionPromise) {
+            return this.sessionPromise;
+        }
+        // Create new session
+        this.sessionPromise = TerminalSession.create({
+            ...this.options,
+            sandboxController: this.sandboxController,
+        });
+        try {
+            this.session = await this.sessionPromise;
+            return this.session;
+        }
+        finally {
+            this.sessionPromise = null;
+        }
+    }
+    /**
+     * Get the current session if it exists and is active
+     * Returns null if no session exists yet
+     */
+    getCurrentSession() {
+        if (this.session && this.session.isActive()) {
+            return this.session;
+        }
+        return null;
+    }
+    /**
+     * @deprecated Use getSessionAsync() instead. This method exists for backwards compatibility
+     * but will throw if the session hasn't been created yet.
+     */
+    getSession() {
+        if (!this.session || !this.session.isActive()) {
+            throw new Error("Session not initialized. Use getSessionAsync() or call initSession() first.");
+        }
+        return this.session;
+    }
+    /**
+     * Initialize the session eagerly
+     * Call this at startup to create the session before it's needed
+     */
+    async initSession() {
+        const session = await this.getSessionAsync();
+        // Wire up recording hooks
+        session.onData((data) => this.recordingManager.recordOutputToAll(data));
+        session.onResize((cols, rows) => this.recordingManager.recordResizeToAll(cols, rows));
+        // Start auto-recording if CLI mode !== 'off'
+        if (this.options.record && this.options.record !== 'off') {
+            this.startAutoRecording();
+        }
+        return session;
+    }
+    /**
+     * Start auto-recording based on CLI options
+     */
+    startAutoRecording() {
+        if (this.autoRecordingId) {
+            return; // Already recording
+        }
+        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 dimensions = this.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;
+    }
+    /**
+     * Get the RecordingManager instance
+     */
+    getRecordingManager() {
+        return this.recordingManager;
+    }
+    /**
+     * Finalize all recordings and return their metadata
+     * Called by the caller when the session exits
+     */
+    async finalizeRecordings(exitCode) {
+        return this.recordingManager.finalizeAll(exitCode);
+    }
+    /**
+     * Check if a session exists and is active
+     */
+    hasActiveSession() {
+        return this.session !== null && this.session.isActive();
+    }
+    /**
+     * Write data to the terminal
+     */
+    write(data) {
+        this.getSession().write(data);
+    }
+    /**
+     * Get terminal content
+     */
+    getContent() {
+        return this.getSession().getContent();
+    }
+    /**
+     * Get visible content only
+     */
+    getVisibleContent() {
+        return this.getSession().getVisibleContent();
+    }
+    /**
+     * Take a screenshot
+     */
+    takeScreenshot() {
+        return this.getSession().takeScreenshot();
+    }
+    /**
+     * Clear the terminal
+     */
+    clear() {
+        this.getSession().clear();
+    }
+    /**
+     * Resize the terminal
+     */
+    resize(cols, rows) {
+        this.getSession().resize(cols, rows);
+    }
+    /**
+     * Get terminal dimensions
+     */
+    getDimensions() {
+        return this.getSession().getDimensions();
+    }
+    /**
+     * Dispose of the current session and cleanup sandbox
+     */
+    dispose() {
+        // Dispose legacy session
+        if (this.session) {
+            this.session.dispose();
+            this.session = null;
+        }
+        // Dispose all multi-session instances
+        for (const session of this.sessions.values()) {
+            session.dispose();
+        }
+        this.sessions.clear();
+    }
+    /**
+     * Async dispose that also cleans up sandbox resources
+     */
+    async disposeAsync() {
+        this.dispose();
+        if (this.sandboxController) {
+            await this.sandboxController.cleanup();
+        }
+    }
+    /**
+     * Get the sandbox controller if one is configured
+     */
+    getSandboxController() {
+        return this.sandboxController;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/terminal/manager.js.map

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

package/dist/terminal/session.d.ts

@@ -0,0 +1,137 @@
+import type { SandboxController } from "../sandbox/index.js";
+export interface TerminalSessionOptions {
+    cols?: number;
+    rows?: number;
+    shell?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+    startupBanner?: string;
+    sandboxController?: SandboxController;
+    /** Skip prompt customization and use user's native shell config */
+    nativeShell?: boolean;
+    /**
+     * Also set LC_CTYPE in addition to LANG.
+     * When false (default), only LANG is set, matching iTerm2 behavior.
+     * When true, also sets LC_CTYPE which may cause issues when SSH'ing
+     * to remote servers that don't have the same locales installed
+     * (SSH forwards LC_* variables via SendEnv).
+     */
+    setLocaleEnv?: boolean;
+}
+export interface ScreenshotResult {
+    content: string;
+    cursor: {
+        x: number;
+        y: number;
+    };
+    dimensions: {
+        cols: number;
+        rows: number;
+    };
+}
+/**
+ * Terminal session that combines node-pty with xterm.js headless
+ * for full terminal emulation
+ */
+export declare class TerminalSession {
+    private ptyProcess;
+    private terminal;
+    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;
+    /**
+     * Get a list of available UTF-8 locales on the system.
+     * Returns the best one to use, preferring the user's existing locale if valid.
+     */
+    private getAvailableUtf8Locale;
+    /**
+     * Ensure proper UTF-8 locale settings for the terminal.
+     * Electron apps launched from Finder on macOS don't inherit shell locale settings,
+     * which breaks programs like mosh that require UTF-8.
+     */
+    private ensureUtf8Locale;
+    /**
+     * Initialize the terminal session
+     * This is called by the create() factory method
+     */
+    private initialize;
+    /**
+     * Subscribe to PTY output data
+     */
+    onData(listener: (data: string) => void): void;
+    /**
+     * 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)
+     */
+    write(data: string): void;
+    /**
+     * Get the current terminal buffer content as plain text
+     */
+    getContent(): string;
+    /**
+     * Get only the visible viewport content
+     */
+    getVisibleContent(): string;
+    /**
+     * Take a screenshot of the terminal state
+     */
+    takeScreenshot(): ScreenshotResult;
+    /**
+     * Clear the terminal screen
+     */
+    clear(): void;
+    /**
+     * Resize the terminal
+     */
+    resize(cols: number, rows: number): void;
+    /**
+     * Check if the session is still active
+     */
+    isActive(): boolean;
+    /**
+     * Get terminal dimensions
+     */
+    getDimensions(): {
+        cols: number;
+        rows: number;
+    };
+    /**
+     * Get the current foreground process name
+     * On macOS/Linux this returns the actual process running in the terminal
+     */
+    getProcess(): string;
+    /**
+     * Get the current working directory of the foreground process
+     * Uses process tree traversal to find the deepest child process
+     */
+    getCwd(): string | null;
+    /**
+     * Dispose of the terminal session
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/terminal/session.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAoC7D,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;IACtC,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,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,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;IAkIxB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAgD9B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;;OAGG;YACW,UAAU;IAyPxB;;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;;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;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAO/C;;;OAGG;IACH,UAAU,IAAI,MAAM;IAYpB;;;OAGG;IACH,MAAM,IAAI,MAAM,GAAG,IAAI;IAkFvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAuBhB"}