mstro-app 0.1.47

package/dist/server/services/terminal/pty-manager.js

@@ -0,0 +1,377 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/**
+ * PTY Manager - Manages pseudo-terminal sessions for shell access
+ *
+ * Provides terminal emulation for running shell commands on the local machine.
+ * Each terminal session is managed independently with its own PTY process.
+ *
+ * Supports session persistence:
+ * - Sessions survive WebSocket disconnections
+ * - Scrollback buffer is maintained for replay on reconnect
+ * - Sessions can be reattached without losing running processes
+ *
+ * Also supports tmux-backed persistence for sessions that survive server restarts.
+ *
+ * NOTE: node-pty is an optional dependency requiring native compilation.
+ * Terminal features gracefully degrade when node-pty is not available.
+ */
+import { EventEmitter } from 'node:events';
+import { homedir, platform } from 'node:os';
+import { getTmuxManager, isTmuxAvailable } from './tmux-manager.js';
+// Try to load node-pty (optional native dependency)
+let pty = null;
+let _ptyLoadError = null;
+try {
+    pty = await import('node-pty');
+}
+catch (error) {
+    _ptyLoadError = error.message || 'Failed to load node-pty';
+    console.warn('[PTYManager] node-pty not available - terminal features disabled');
+    console.warn('[PTYManager] To enable terminals, run: mstro setup-terminal');
+}
+/**
+ * Check if node-pty is available
+ */
+export function isPtyAvailable() {
+    return pty !== null;
+}
+/**
+ * Get installation instructions for node-pty based on platform
+ */
+export function getPtyInstallInstructions() {
+    const os = platform();
+    let instructions = `Terminal feature requires native compilation of node-pty.\n\n`;
+    instructions += `To enable this feature:\n\n`;
+    if (os === 'darwin') {
+        instructions += `1. Install Xcode Command Line Tools:\n`;
+        instructions += `   xcode-select --install\n\n`;
+    }
+    else if (os === 'win32') {
+        instructions += `1. Install Windows Build Tools:\n`;
+        instructions += `   npm install -g windows-build-tools\n\n`;
+    }
+    else {
+        // Linux
+        instructions += `1. Install build tools:\n`;
+        instructions += `   # Debian/Ubuntu:\n`;
+        instructions += `   sudo apt install build-essential python3\n\n`;
+        instructions += `   # Fedora/RHEL:\n`;
+        instructions += `   sudo dnf install gcc-c++ make python3\n\n`;
+        instructions += `   # Arch:\n`;
+        instructions += `   sudo pacman -S base-devel python\n\n`;
+    }
+    instructions += `2. Rebuild native modules:\n`;
+    instructions += `   npm rebuild node-pty\n\n`;
+    instructions += `3. Restart mstro\n`;
+    return instructions;
+}
+// Maximum lines to store in scrollback buffer per terminal
+const MAX_SCROLLBACK_LINES = 5000;
+// Maximum characters per line to prevent memory bloat
+const MAX_LINE_LENGTH = 2000;
+/**
+ * Detect the user's default shell
+ */
+function detectShell() {
+    const shell = process.env.SHELL;
+    if (shell) {
+        return shell;
+    }
+    // Platform-specific defaults
+    if (platform() === 'win32') {
+        return process.env.COMSPEC || 'powershell.exe';
+    }
+    return '/bin/bash';
+}
+/**
+ * Get shell name from path
+ */
+function getShellName(shellPath) {
+    const parts = shellPath.split(/[/\\]/);
+    return parts[parts.length - 1] || 'shell';
+}
+export class PTYManager extends EventEmitter {
+    terminals = new Map();
+    constructor() {
+        super();
+        // Each terminal adds 3 listeners (output, exit, error) to this singleton.
+        // With multiple terminals, the default limit of 10 is easily exceeded.
+        this.setMaxListeners(50);
+    }
+    /**
+     * Check if a terminal session exists and is still running
+     */
+    exists(terminalId) {
+        return this.terminals.has(terminalId);
+    }
+    /**
+     * Get session info for reconnection
+     * Returns null if session doesn't exist
+     */
+    getSessionInfo(terminalId) {
+        const session = this.terminals.get(terminalId);
+        if (!session)
+            return null;
+        return {
+            shell: session.shell,
+            cwd: session.cwd,
+            cols: session.cols,
+            rows: session.rows,
+        };
+    }
+    /**
+     * Get scrollback buffer for replay on reconnect
+     * Returns the stored output history
+     */
+    getScrollback(terminalId) {
+        const session = this.terminals.get(terminalId);
+        if (!session)
+            return [];
+        return [...session.scrollback];
+    }
+    /**
+     * Add data to scrollback buffer
+     * Maintains a rolling buffer of recent terminal output
+     */
+    addToScrollback(session, data) {
+        // Split data into lines
+        const lines = data.split(/\r?\n/);
+        for (const line of lines) {
+            // Truncate very long lines to prevent memory issues
+            const truncatedLine = line.length > MAX_LINE_LENGTH
+                ? `${line.slice(0, MAX_LINE_LENGTH)}...`
+                : line;
+            session.scrollback.push(truncatedLine);
+        }
+        // Trim buffer if it exceeds max size
+        if (session.scrollback.length > MAX_SCROLLBACK_LINES) {
+            session.scrollback = session.scrollback.slice(-MAX_SCROLLBACK_LINES);
+        }
+        session.lastActivityAt = Date.now();
+    }
+    /**
+     * Check if PTY functionality is available
+     */
+    isPtyAvailable() {
+        return isPtyAvailable();
+    }
+    /**
+     * Get installation instructions if PTY is not available
+     */
+    getPtyInstallInstructions() {
+        return getPtyInstallInstructions();
+    }
+    /**
+     * Create a new terminal session
+     */
+    create(terminalId, workingDir, cols = 80, rows = 24, requestedShell) {
+        // Check if node-pty is available
+        if (!pty) {
+            throw new Error(`PTY_NOT_AVAILABLE:${getPtyInstallInstructions()}`);
+        }
+        // Check if session already exists - if so, this is a reconnection
+        if (this.terminals.has(terminalId)) {
+            const existingSession = this.terminals.get(terminalId);
+            // Always resize on reconnect to trigger SIGWINCH, which causes the
+            // shell to redraw its prompt line for the reconnected client
+            existingSession.pty.resize(cols, rows);
+            existingSession.cols = cols;
+            existingSession.rows = rows;
+            return {
+                shell: existingSession.shell,
+                cwd: existingSession.cwd,
+                isReconnect: true,
+            };
+        }
+        const shell = requestedShell || detectShell();
+        const cwd = workingDir || homedir();
+        try {
+            // Spawn the PTY process
+            const ptyProcess = pty.spawn(shell, [], {
+                name: 'xterm-256color',
+                cols,
+                rows,
+                cwd,
+                env: {
+                    ...process.env,
+                    TERM: 'xterm-256color',
+                    COLORTERM: 'truecolor',
+                    // Ensure home directory is set
+                    HOME: homedir(),
+                },
+            });
+            // Store the session with scrollback buffer
+            const session = {
+                id: terminalId,
+                pty: ptyProcess,
+                shell: getShellName(shell),
+                cwd,
+                scrollback: [],
+                createdAt: Date.now(),
+                lastActivityAt: Date.now(),
+                cols,
+                rows,
+            };
+            this.terminals.set(terminalId, session);
+            // Handle data output - store in scrollback and emit
+            ptyProcess.onData((data) => {
+                this.addToScrollback(session, data);
+                this.emit('output', terminalId, data);
+            });
+            // Handle exit
+            ptyProcess.onExit(({ exitCode }) => {
+                this.emit('exit', terminalId, exitCode);
+                this.terminals.delete(terminalId);
+            });
+            return { shell: session.shell, cwd, isReconnect: false };
+        }
+        catch (error) {
+            console.error(`[PTYManager] Failed to create terminal ${terminalId}:`, error);
+            this.emit('error', terminalId, error.message || 'Failed to create terminal');
+            throw error;
+        }
+    }
+    /**
+     * Write input data to terminal
+     */
+    write(terminalId, data) {
+        const session = this.terminals.get(terminalId);
+        if (!session) {
+            console.warn(`[PTYManager] Terminal ${terminalId} not found for write`);
+            return false;
+        }
+        try {
+            session.pty.write(data);
+            return true;
+        }
+        catch (error) {
+            console.error(`[PTYManager] Error writing to terminal ${terminalId}:`, error);
+            this.emit('error', terminalId, error.message || 'Write failed');
+            return false;
+        }
+    }
+    /**
+     * Resize terminal
+     */
+    resize(terminalId, cols, rows) {
+        const session = this.terminals.get(terminalId);
+        if (!session) {
+            console.warn(`[PTYManager] Terminal ${terminalId} not found for resize`);
+            return false;
+        }
+        try {
+            session.pty.resize(cols, rows);
+            return true;
+        }
+        catch (error) {
+            console.error(`[PTYManager] Error resizing terminal ${terminalId}:`, error);
+            return false;
+        }
+    }
+    /**
+     * Close terminal session
+     */
+    close(terminalId) {
+        const session = this.terminals.get(terminalId);
+        if (!session) {
+            return false;
+        }
+        try {
+            session.pty.kill();
+            this.terminals.delete(terminalId);
+            return true;
+        }
+        catch (error) {
+            console.error(`[PTYManager] Error closing terminal ${terminalId}:`, error);
+            this.terminals.delete(terminalId);
+            return false;
+        }
+    }
+    /**
+     * Get terminal session info
+     */
+    getSession(terminalId) {
+        return this.terminals.get(terminalId);
+    }
+    /**
+     * Check if terminal exists
+     */
+    has(terminalId) {
+        return this.terminals.has(terminalId);
+    }
+    /**
+     * Get all active terminal IDs
+     */
+    getActiveTerminals() {
+        return Array.from(this.terminals.keys());
+    }
+    /**
+     * Close all terminals
+     */
+    closeAll() {
+        for (const terminalId of this.terminals.keys()) {
+            this.close(terminalId);
+        }
+    }
+    /**
+     * Check if tmux persistence is available
+     */
+    isTmuxAvailable() {
+        return isTmuxAvailable();
+    }
+    /**
+     * Get list of persistent tmux sessions that can be restored
+     * These are sessions that survived a server restart
+     */
+    getPersistentSessions() {
+        const tmux = getTmuxManager();
+        return tmux.getActiveSessions();
+    }
+    /**
+     * Create a persistent (tmux-backed) terminal session
+     * These sessions survive server restarts
+     */
+    createPersistent(terminalId, workingDir, cols = 80, rows = 24, requestedShell) {
+        const tmux = getTmuxManager();
+        if (!tmux.isAvailable()) {
+            throw new Error('tmux is not available for persistent sessions');
+        }
+        const result = tmux.create(terminalId, workingDir, cols, rows, requestedShell);
+        return { ...result, persistent: true };
+    }
+    /**
+     * Attach to a persistent (tmux) session
+     * Returns handlers for write, resize, and detach
+     */
+    attachPersistent(terminalId, onOutput, onExit) {
+        const tmux = getTmuxManager();
+        if (!tmux.exists(terminalId)) {
+            return null;
+        }
+        return tmux.attach(terminalId, onOutput, onExit);
+    }
+    /**
+     * Get scrollback from a persistent (tmux) session
+     */
+    getPersistentScrollback(terminalId) {
+        const tmux = getTmuxManager();
+        return tmux.getScrollback(terminalId);
+    }
+    /**
+     * Close a persistent (tmux) session
+     */
+    closePersistent(terminalId) {
+        const tmux = getTmuxManager();
+        return tmux.close(terminalId);
+    }
+}
+// Singleton instance
+let ptyManagerInstance = null;
+export function getPTYManager() {
+    if (!ptyManagerInstance) {
+        ptyManagerInstance = new PTYManager();
+    }
+    return ptyManagerInstance;
+}
+//# sourceMappingURL=pty-manager.js.map

package/dist/server/services/terminal/pty-manager.js.map

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

package/dist/server/services/terminal/tmux-manager.d.ts

@@ -0,0 +1,82 @@
+import { EventEmitter } from 'node:events';
+export interface TmuxSession {
+    terminalId: string;
+    tmuxSessionName: string;
+    shell: string;
+    cwd: string;
+    createdAt: number;
+    lastAttachedAt: number;
+}
+/**
+ * Check if tmux is available on the system
+ */
+export declare function isTmuxAvailable(): boolean;
+/**
+ * TmuxManager - Manages tmux-backed terminal sessions
+ */
+export declare class TmuxManager extends EventEmitter {
+    private sessions;
+    private outputHandlers;
+    private tmuxAvailable;
+    constructor();
+    /**
+     * Check if tmux persistence is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Load session registry from disk
+     */
+    private loadRegistry;
+    /**
+     * Save session registry to disk
+     */
+    private saveRegistry;
+    /**
+     * Sync our registry with actual tmux sessions
+     * Remove sessions that no longer exist in tmux
+     */
+    private syncWithTmux;
+    /**
+     * Check if a session exists
+     */
+    exists(terminalId: string): boolean;
+    /**
+     * Get session info
+     */
+    getSessionInfo(terminalId: string): TmuxSession | null;
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions(): TmuxSession[];
+    /**
+     * Create a new tmux-backed terminal session
+     */
+    create(terminalId: string, workingDir: string, cols?: number, rows?: number, shell?: string): {
+        shell: string;
+        cwd: string;
+        isReconnect: boolean;
+    };
+    /**
+     * Attach to a tmux session and stream output
+     * Returns a function to detach
+     */
+    attach(terminalId: string, onOutput: (data: string) => void, onExit: (code: number) => void): {
+        write: (data: string) => void;
+        resize: (cols: number, rows: number) => void;
+        detach: () => void;
+    };
+    /**
+     * Get scrollback/history from tmux session
+     */
+    getScrollback(terminalId: string, lines?: number): string[];
+    /**
+     * Close/kill a tmux session
+     */
+    close(terminalId: string): boolean;
+    /**
+     * Close all mstro-managed tmux sessions
+     */
+    closeAll(): void;
+}
+export declare function getTmuxManager(): TmuxManager;
+//# sourceMappingURL=tmux-manager.d.ts.map

package/dist/server/services/terminal/tmux-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux-manager.d.ts","sourceRoot":"","sources":["../../../../server/services/terminal/tmux-manager.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,aAAa,CAAU;;IAY/B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoCpB;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAenC;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAItD;;OAEG;IACH,iBAAiB,IAAI,WAAW,EAAE;IAKlC;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAW,EACjB,IAAI,GAAE,MAAW,EACjB,KAAK,CAAC,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE;IAiEvD;;;OAGG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAChC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7B;QAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;IA4FtG;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAa,GAAG,MAAM,EAAE;IAqBjE;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAwBlC;;OAEG;IACH,QAAQ,IAAI,IAAI;CAKjB;AAKD,wBAAgB,cAAc,IAAI,WAAW,CAK5C"}