@ellery/terminal-mcp 0.1.1

package/dist/prompts/index.js

@@ -0,0 +1,79 @@
+import { ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+const TOOL_USAGE_PROMPT = `# Terminal MCP Tool Usage Guide
+
+## Overview
+This MCP server provides tools to interact with a terminal emulator. Use these tools to execute commands and read output.
+
+## Tools
+
+### type
+Send text input to the terminal. Text is written exactly as provided - no Enter key is sent automatically.
+
+To execute a command, use type() followed by sendKey('Enter').
+
+**Example workflow:**
+1. type('ls -la') - types the command
+2. sendKey('Enter') - executes it
+3. getContent() - reads the output
+
+### sendKey
+Send a special key or key combination to the terminal.
+
+**Common keys:** Enter, Tab, Escape, Backspace, Delete, ArrowUp, ArrowDown, ArrowLeft, ArrowRight
+
+**Navigation:** Home, End, PageUp, PageDown
+
+**Control sequences:**
+- Ctrl+C - interrupt current process
+- Ctrl+D - EOF/exit
+- Ctrl+Z - suspend process
+- Ctrl+L - clear screen
+- Ctrl+A - move to start of line
+- Ctrl+E - move to end of line
+
+**Function keys:** F1-F12
+
+### getContent
+Get terminal content as plain text. Use after sending commands to see output.
+
+Returns full scrollback buffer by default (up to 1000 lines). Set visibleOnly=true for just the current viewport (useful when output is very long).
+
+Prefer this over takeScreenshot when you only need text content.
+
+### takeScreenshot
+Capture terminal state as structured JSON with:
+- content: visible text
+- cursor: {x, y} position
+- dimensions: {cols, rows}
+
+Use when you need cursor position (e.g., for interactive apps, editors) or terminal dimensions. For simple command output, prefer getContent().
+`;
+const prompts = [
+    {
+        name: "tool-usage",
+        description: "Instructions for effectively using terminal-mcp tools",
+    },
+];
+export function registerPrompts(server) {
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts,
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name } = request.params;
+        if (name === "tool-usage") {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: TOOL_USAGE_PROMPT,
+                        },
+                    },
+                ],
+            };
+        }
+        throw new Error(`Unknown prompt: ${name}`);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDzB,CAAC;AAEF,MAAM,OAAO,GAAG;IACd;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,uDAAuD;KACrE;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9D,OAAO;KACR,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEhC,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAe;wBACrB,OAAO,EAAE;4BACP,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,iBAAiB;yBACxB;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,28 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import { TerminalManager } from "./terminal/index.js";
+export interface ServerOptions {
+    cols?: number;
+    rows?: number;
+    shell?: string;
+}
+/**
+ * Create and configure the MCP server with an existing terminal manager
+ */
+export declare function createServerWithManager(manager: TerminalManager): Server;
+/**
+ * Create and configure the MCP server with a new terminal manager
+ */
+export declare function createServer(options?: ServerOptions): {
+    server: Server;
+    manager: TerminalManager;
+};
+/**
+ * Connect an MCP server to a transport
+ */
+export declare function connectServer(server: Server, transport: Transport): Promise<void>;
+/**
+ * Start the MCP server with stdio transport (legacy mode)
+ */
+export declare function startServer(options?: ServerOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAkBxE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;CAC1B,CAUA;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E"}

package/dist/server.js

@@ -0,0 +1,58 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { TerminalManager } from "./terminal/index.js";
+import { registerTools } from "./tools/index.js";
+import { registerPrompts } from "./prompts/index.js";
+/**
+ * Create and configure the MCP server with an existing terminal manager
+ */
+export function createServerWithManager(manager) {
+    const server = new Server({
+        name: "terminal-mcp",
+        version: "0.1.0",
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+        },
+    });
+    registerTools(server, manager);
+    registerPrompts(server);
+    return server;
+}
+/**
+ * Create and configure the MCP server with a new terminal manager
+ */
+export function createServer(options = {}) {
+    const manager = new TerminalManager({
+        cols: options.cols,
+        rows: options.rows,
+        shell: options.shell,
+    });
+    const server = createServerWithManager(manager);
+    return { server, manager };
+}
+/**
+ * Connect an MCP server to a transport
+ */
+export async function connectServer(server, transport) {
+    await server.connect(transport);
+}
+/**
+ * Start the MCP server with stdio transport (legacy mode)
+ */
+export async function startServer(options = {}) {
+    const { server, manager } = createServer(options);
+    const transport = new StdioServerTransport();
+    // Handle graceful shutdown
+    process.on("SIGINT", () => {
+        manager.dispose();
+        process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+        manager.dispose();
+        process.exit(0);
+    });
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQrD;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IAItD,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEhD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,SAAoB;IACtE,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAyB,EAAE;IAC3D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/terminal/index.d.ts

@@ -0,0 +1,4 @@
+export { TerminalSession } from "./session.js";
+export type { TerminalSessionOptions, ScreenshotResult } from "./session.js";
+export { TerminalManager } from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/terminal/index.js

@@ -0,0 +1,3 @@
+export { TerminalSession } from "./session.js";
+export { TerminalManager } from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/terminal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/terminal/manager.d.ts

@@ -0,0 +1,54 @@
+import { TerminalSession, TerminalSessionOptions, ScreenshotResult } from "./session.js";
+/**
+ * Manages the terminal session lifecycle
+ * Currently supports a single session for simplicity
+ */
+export declare class TerminalManager {
+    private session;
+    private options;
+    constructor(options?: TerminalSessionOptions);
+    /**
+     * Get or create the terminal session
+     */
+    getSession(): TerminalSession;
+    /**
+     * 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
+     */
+    dispose(): void;
+}
+//# 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":"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"}

package/dist/terminal/manager.js

@@ -0,0 +1,79 @@
+import { TerminalSession } from "./session.js";
+/**
+ * Manages the terminal session lifecycle
+ * Currently supports a single session for simplicity
+ */
+export class TerminalManager {
+    session = null;
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Get or create the terminal session
+     */
+    getSession() {
+        if (!this.session || !this.session.isActive()) {
+            this.session = new TerminalSession(this.options);
+        }
+        return this.session;
+    }
+    /**
+     * 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
+     */
+    dispose() {
+        if (this.session) {
+            this.session.dispose();
+            this.session = null;
+        }
+    }
+}
+//# 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":"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"}

package/dist/terminal/session.d.ts

@@ -0,0 +1,85 @@
+export interface TerminalSessionOptions {
+    cols?: number;
+    rows?: number;
+    shell?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+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 rcFile;
+    private zdotdir;
+    /**
+     * Set up shell-specific prompt customization
+     * Returns args to pass to shell and env modifications
+     */
+    private setupShellPrompt;
+    constructor(options?: TerminalSessionOptions);
+    /**
+     * Subscribe to PTY output data
+     */
+    onData(listener: (data: string) => void): void;
+    /**
+     * Subscribe to PTY exit
+     */
+    onExit(listener: (code: 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;
+    };
+    /**
+     * 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":"AAUA,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;CAC9B;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;gBA+CZ,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"}

package/dist/terminal/session.js

@@ -0,0 +1,246 @@
+import * as pty from "node-pty";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import xtermHeadless from "@xterm/headless";
+const { Terminal } = xtermHeadless;
+// Custom prompt indicator for terminal-mcp
+const PROMPT_INDICATOR = "⚡";
+/**
+ * Terminal session that combines node-pty with xterm.js headless
+ * for full terminal emulation
+ */
+export class TerminalSession {
+    ptyProcess;
+    terminal;
+    disposed = false;
+    dataListeners = [];
+    exitListeners = [];
+    rcFile = null;
+    zdotdir = null;
+    /**
+     * Set up shell-specific prompt customization
+     * Returns args to pass to shell and env modifications
+     */
+    setupShellPrompt(shellName, extraEnv) {
+        const env = {
+            TERMINAL_MCP: "1",
+            ...extraEnv,
+        };
+        if (shellName === "bash" || shellName === "sh") {
+            // Create temp rcfile that sources user's .bashrc then sets our prompt
+            const homeDir = os.homedir();
+            const bashrcContent = `
+# Source user's bashrc if it exists
+[ -f "${homeDir}/.bashrc" ] && source "${homeDir}/.bashrc"
+# Set terminal-mcp prompt
+PS1="${PROMPT_INDICATOR} \\$ "
+`;
+            this.rcFile = path.join(os.tmpdir(), `terminal-mcp-bashrc-${process.pid}`);
+            fs.writeFileSync(this.rcFile, bashrcContent);
+            return { args: ["--rcfile", this.rcFile], env };
+        }
+        if (shellName === "zsh") {
+            // Create temp ZDOTDIR with .zshrc that sources user's config then sets prompt
+            const homeDir = os.homedir();
+            this.zdotdir = path.join(os.tmpdir(), `terminal-mcp-zsh-${process.pid}`);
+            fs.mkdirSync(this.zdotdir, { recursive: true });
+            const zshrcContent = `
+# Reset ZDOTDIR so nested zsh uses normal config
+export ZDOTDIR="${homeDir}"
+# Source user's zshrc if it exists
+[ -f "${homeDir}/.zshrc" ] && source "${homeDir}/.zshrc"
+# Set terminal-mcp prompt
+PROMPT="${PROMPT_INDICATOR} %# "
+`;
+            fs.writeFileSync(path.join(this.zdotdir, ".zshrc"), zshrcContent);
+            env.ZDOTDIR = this.zdotdir;
+            return { args: [], env };
+        }
+        // For other shells, just set env vars and hope for the best
+        env.PS1 = `${PROMPT_INDICATOR} $ `;
+        return { args: [], env };
+    }
+    constructor(options = {}) {
+        const cols = options.cols ?? 120;
+        const rows = options.rows ?? 40;
+        const shell = options.shell ?? process.env.SHELL ?? "bash";
+        // Create headless terminal emulator
+        this.terminal = new Terminal({
+            cols,
+            rows,
+            scrollback: 1000,
+            allowProposedApi: true,
+        });
+        // Determine shell type and set up custom prompt
+        const shellName = path.basename(shell);
+        const { args, env } = this.setupShellPrompt(shellName, options.env);
+        // Spawn PTY process
+        this.ptyProcess = pty.spawn(shell, args, {
+            name: "xterm-256color",
+            cols,
+            rows,
+            cwd: options.cwd ?? process.cwd(),
+            env: { ...process.env, ...env },
+        });
+        // Pipe PTY output to terminal emulator and listeners
+        this.ptyProcess.onData((data) => {
+            if (!this.disposed) {
+                this.terminal.write(data);
+                // Notify all data listeners
+                for (const listener of this.dataListeners) {
+                    listener(data);
+                }
+            }
+        });
+        this.ptyProcess.onExit(({ exitCode }) => {
+            this.disposed = true;
+            for (const listener of this.exitListeners) {
+                listener(exitCode);
+            }
+        });
+    }
+    /**
+     * Subscribe to PTY output data
+     */
+    onData(listener) {
+        this.dataListeners.push(listener);
+    }
+    /**
+     * Subscribe to PTY exit
+     */
+    onExit(listener) {
+        this.exitListeners.push(listener);
+    }
+    /**
+     * Write data to the terminal (simulates typing)
+     */
+    write(data) {
+        if (this.disposed) {
+            throw new Error("Terminal session has been disposed");
+        }
+        this.ptyProcess.write(data);
+    }
+    /**
+     * Get the current terminal buffer content as plain text
+     */
+    getContent() {
+        if (this.disposed) {
+            throw new Error("Terminal session has been disposed");
+        }
+        const buffer = this.terminal.buffer.active;
+        const lines = [];
+        // Get all lines from the buffer (including scrollback)
+        for (let i = 0; i < buffer.length; i++) {
+            const line = buffer.getLine(i);
+            if (line) {
+                lines.push(line.translateToString(true));
+            }
+        }
+        // Trim trailing empty lines
+        while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
+            lines.pop();
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Get only the visible viewport content
+     */
+    getVisibleContent() {
+        if (this.disposed) {
+            throw new Error("Terminal session has been disposed");
+        }
+        const buffer = this.terminal.buffer.active;
+        const lines = [];
+        const baseY = buffer.baseY;
+        for (let i = 0; i < this.terminal.rows; i++) {
+            const line = buffer.getLine(baseY + i);
+            if (line) {
+                lines.push(line.translateToString(true));
+            }
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Take a screenshot of the terminal state
+     */
+    takeScreenshot() {
+        if (this.disposed) {
+            throw new Error("Terminal session has been disposed");
+        }
+        const buffer = this.terminal.buffer.active;
+        return {
+            content: this.getVisibleContent(),
+            cursor: {
+                x: buffer.cursorX,
+                y: buffer.cursorY,
+            },
+            dimensions: {
+                cols: this.terminal.cols,
+                rows: this.terminal.rows,
+            },
+        };
+    }
+    /**
+     * Clear the terminal screen
+     */
+    clear() {
+        if (this.disposed) {
+            throw new Error("Terminal session has been disposed");
+        }
+        this.terminal.clear();
+    }
+    /**
+     * Resize the terminal
+     */
+    resize(cols, rows) {
+        if (this.disposed) {
+            throw new Error("Terminal session has been disposed");
+        }
+        this.terminal.resize(cols, rows);
+        this.ptyProcess.resize(cols, rows);
+    }
+    /**
+     * Check if the session is still active
+     */
+    isActive() {
+        return !this.disposed;
+    }
+    /**
+     * Get terminal dimensions
+     */
+    getDimensions() {
+        return {
+            cols: this.terminal.cols,
+            rows: this.terminal.rows,
+        };
+    }
+    /**
+     * Dispose of the terminal session
+     */
+    dispose() {
+        if (!this.disposed) {
+            this.disposed = true;
+            this.ptyProcess.kill();
+            this.terminal.dispose();
+            // Clean up temp rc files
+            if (this.rcFile) {
+                try {
+                    fs.unlinkSync(this.rcFile);
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+            if (this.zdotdir) {
+                try {
+                    fs.rmSync(this.zdotdir, { recursive: true });
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=session.js.map