@ellery/terminal-mcp 0.1.1

package/dist/ui/index.js

@@ -0,0 +1,124 @@
+const VERSION = "0.1.0";
+// Custom color #31cae1 as 24-bit ANSI escape (RGB: 49, 202, 225)
+const BRAND_COLOR = "\x1b[38;2;49;202;225m";
+// Pink accent color for MCP (RGB: 255, 105, 180 - hot pink)
+const PINK_COLOR = "\x1b[38;2;255;105;180m";
+// Bright yellow for borders (RGB: 255, 255, 0)
+const YELLOW_COLOR = "\x1b[38;2;255;255;0m";
+// White for text content
+const WHITE_COLOR = "\x1b[38;2;255;255;255m";
+const RESET = "\x1b[0m";
+// ANSI Shadow style figlet logo for "TERMINAL" + "MCP" stacked
+const LOGO = `
+████████╗███████╗██████╗ ███╗   ███╗██╗███╗   ██╗ █████╗ ██╗
+╚══██╔══╝██╔════╝██╔══██╗████╗ ████║██║████╗  ██║██╔══██╗██║
+   ██║   █████╗  ██████╔╝██╔████╔██║██║██╔██╗ ██║███████║██║
+   ██║   ██╔══╝  ██╔══██╗██║╚██╔╝██║██║██║╚██╗██║██╔══██║██║
+   ██║   ███████╗██║  ██║██║ ╚═╝ ██║██║██║ ╚████║██║  ██║███████╗
+   ╚═╝   ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝
+                    ███╗   ███╗ ██████╗██████╗
+                    ████╗ ████║██╔════╝██╔══██╗
+                    ██╔████╔██║██║     ██████╔╝
+                    ██║╚██╔╝██║██║     ██╔═══╝
+                    ██║ ╚═╝ ██║╚██████╗██║
+                    ╚═╝     ╚═╝ ╚═════╝╚═╝
+`.trim();
+/**
+ * Print the startup banner to stderr (so it doesn't interfere with shell output)
+ */
+export function printBanner(options) {
+    // Build the logo with box around it
+    const logoLines = LOGO.split("\n");
+    // Find the widest logo line to determine box width
+    const maxLogoWidth = Math.max(...logoLines.map((l) => l.length));
+    const boxWidth = maxLogoWidth + 4; // 2 chars padding on each side
+    const horizontalLine = "─".repeat(boxWidth);
+    const emptyLine = YELLOW_COLOR + "│" + " ".repeat(boxWidth) + "│";
+    // Center the logo as a block (same left padding for all lines)
+    // First 6 lines are TERMINAL (blue), last 6 lines are MCP (pink)
+    const centeredLogo = logoLines.map((line, index) => {
+        const rightPad = boxWidth - 2 - line.length;
+        const color = index < 6 ? BRAND_COLOR : PINK_COLOR;
+        return YELLOW_COLOR + "│ " + color + line + " ".repeat(rightPad) + " " + YELLOW_COLOR + "│";
+    });
+    const banner = `
+${YELLOW_COLOR}╭${horizontalLine}╮
+${centeredLogo.join("\n")}
+${YELLOW_COLOR}├${horizontalLine}┤
+${YELLOW_COLOR}│${WHITE_COLOR}  Socket: ${padRight(options.socketPath, boxWidth - 11)}${YELLOW_COLOR}│
+${YELLOW_COLOR}│${WHITE_COLOR}  Terminal: ${padRight(`${options.cols}x${options.rows}`, 12)}Shell: ${padRight(options.shell, boxWidth - 30)}${YELLOW_COLOR}│
+${emptyLine}
+${YELLOW_COLOR}│${WHITE_COLOR}  AI can now observe this terminal via MCP.${" ".repeat(boxWidth - 44)}${YELLOW_COLOR}│
+${YELLOW_COLOR}│${WHITE_COLOR}  Type /info for configuration help.${" ".repeat(boxWidth - 37)}${YELLOW_COLOR}│
+${YELLOW_COLOR}│${WHITE_COLOR}${" ".repeat(boxWidth - 7)}v${VERSION} ${YELLOW_COLOR}│
+${YELLOW_COLOR}╰${horizontalLine}╯${RESET}
+`;
+    process.stderr.write(banner);
+}
+/**
+ * Generate the /info output
+ */
+export function getInfoOutput(socketPath, cols, rows, shell, stats) {
+    const summary = stats.getSummary();
+    const toolCallsStr = Object.keys(summary.toolCalls).length > 0
+        ? Object.entries(summary.toolCalls)
+            .map(([tool, count]) => `    ${tool}: ${count}`)
+            .join("\n")
+        : "    (none yet)";
+    return `
+${YELLOW_COLOR}╭─────────────────────────────────────────────────────────────╮
+│${WHITE_COLOR}  📡 TERMINAL-MCP INFO                                       ${YELLOW_COLOR}│
+├─────────────────────────────────────────────────────────────┤${RESET}
+
+${WHITE_COLOR}\x1b[1mSession Info:\x1b[0m${WHITE_COLOR}
+  Socket: ${socketPath}
+  Terminal: ${cols}x${rows}
+  Shell: ${shell}
+  Uptime: ${summary.uptime}
+  Tool calls: ${summary.totalCalls}
+${toolCallsStr}
+
+\x1b[1mMCP Configuration:\x1b[0m${WHITE_COLOR}
+  Add this to your MCP client configuration:
+
+  ${YELLOW_COLOR}{
+    "mcpServers": {
+      "terminal": {
+        "command": "terminal-mcp"
+      }
+    }
+  }${WHITE_COLOR}
+
+  Then restart your MCP client to load the server.
+
+\x1b[1mAvailable Tools:\x1b[0m${WHITE_COLOR}
+  • getContent     - Read terminal buffer (visibleOnly=true for current screen)
+  • takeScreenshot - Get visible screen + cursor position
+  • type           - Send text input
+  • sendKey        - Send special keys (enter, ctrl+c, etc.)
+
+${YELLOW_COLOR}╰─────────────────────────────────────────────────────────────╯${RESET}
+`;
+}
+/**
+ * Print the /info output
+ */
+export function printInfo(socketPath, cols, rows, shell, stats) {
+    process.stdout.write(getInfoOutput(socketPath, cols, rows, shell, stats));
+}
+/**
+ * Pad a string to the right with spaces
+ */
+function padRight(str, length) {
+    if (str.length >= length) {
+        return str.substring(0, length - 1) + " ";
+    }
+    return str + " ".repeat(length - str.length);
+}
+/**
+ * Check if input is the /info command
+ */
+export function isInfoCommand(input) {
+    return input.trim() === "/info";
+}
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,iEAAiE;AACjE,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAC5C,4DAA4D;AAC5D,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAC5C,+CAA+C;AAC/C,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAC5C,yBAAyB;AACzB,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAC7C,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,+DAA+D;AAC/D,MAAM,IAAI,GAAG;;;;;;;;;;;;;CAaZ,CAAC,IAAI,EAAE,CAAC;AAST;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,oCAAoC;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnC,mDAAmD;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,+BAA+B;IAElE,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,YAAY,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;IAElE,+DAA+D;IAC/D,iEAAiE;IACjE,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACjD,MAAM,QAAQ,GAAG,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5C,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;QACnD,OAAO,YAAY,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,YAAY,GAAG,GAAG,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG;EACf,YAAY,IAAI,cAAc;EAC9B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;EACvB,YAAY,IAAI,cAAc;EAC9B,YAAY,IAAI,WAAW,aAAa,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,YAAY;EAClG,YAAY,IAAI,WAAW,eAAe,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,UAAU,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,YAAY;EACxJ,SAAS;EACT,YAAY,IAAI,WAAW,8CAA8C,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC,GAAG,YAAY;EACjH,YAAY,IAAI,WAAW,uCAAuC,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC,GAAG,YAAY;EAC1G,YAAY,IAAI,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,OAAO,IAAI,YAAY;EACjF,YAAY,IAAI,cAAc,IAAI,KAAK;CACxC,CAAC;IACA,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,IAAY,EACZ,IAAY,EACZ,KAAa,EACb,KAAY;IAEZ,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;IACnC,MAAM,YAAY,GAChB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC;QACvC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,KAAK,EAAE,CAAC;aAC/C,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,gBAAgB,CAAC;IAEvB,OAAO;EACP,YAAY;GACX,WAAW,gEAAgE,YAAY;iEACzB,KAAK;;EAEpE,WAAW,8BAA8B,WAAW;YAC1C,UAAU;cACR,IAAI,IAAI,IAAI;WACf,KAAK;YACJ,OAAO,CAAC,MAAM;gBACV,OAAO,CAAC,UAAU;EAChC,YAAY;;kCAEoB,WAAW;;;IAGzC,YAAY;;;;;;KAMX,WAAW;;;;gCAIgB,WAAW;;;;;;EAMzC,YAAY,kEAAkE,KAAK;CACpF,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,UAAkB,EAClB,IAAY,EACZ,IAAY,EACZ,KAAa,EACb,KAAY;IAEZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,GAAW,EAAE,MAAc;IAC3C,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC;AAClC,CAAC"}

package/dist/utils/keys.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Key code mappings for terminal special keys
+ * Maps human-readable key names to their ANSI escape sequences
+ */
+export declare const KEY_SEQUENCES: Record<string, string>;
+/**
+ * Get the escape sequence for a key name
+ * @param key - The key name (e.g., "Enter", "Ctrl+C", "ArrowUp")
+ * @returns The escape sequence or null if not found
+ */
+export declare function getKeySequence(key: string): string | null;
+/**
+ * Get all available key names
+ */
+export declare function getAvailableKeys(): string[];
+//# sourceMappingURL=keys.d.ts.map

package/dist/utils/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/utils/keys.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsEhD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C"}

package/dist/utils/keys.js

@@ -0,0 +1,98 @@
+/**
+ * Key code mappings for terminal special keys
+ * Maps human-readable key names to their ANSI escape sequences
+ */
+export const KEY_SEQUENCES = {
+    // Control keys
+    "Enter": "\r",
+    "Tab": "\t",
+    "Escape": "\x1b",
+    "Backspace": "\x7f",
+    "Delete": "\x1b[3~",
+    // Arrow keys
+    "ArrowUp": "\x1b[A",
+    "ArrowDown": "\x1b[B",
+    "ArrowRight": "\x1b[C",
+    "ArrowLeft": "\x1b[D",
+    // Navigation keys
+    "Home": "\x1b[H",
+    "End": "\x1b[F",
+    "PageUp": "\x1b[5~",
+    "PageDown": "\x1b[6~",
+    "Insert": "\x1b[2~",
+    // Function keys
+    "F1": "\x1bOP",
+    "F2": "\x1bOQ",
+    "F3": "\x1bOR",
+    "F4": "\x1bOS",
+    "F5": "\x1b[15~",
+    "F6": "\x1b[17~",
+    "F7": "\x1b[18~",
+    "F8": "\x1b[19~",
+    "F9": "\x1b[20~",
+    "F10": "\x1b[21~",
+    "F11": "\x1b[23~",
+    "F12": "\x1b[24~",
+    // Ctrl combinations
+    "Ctrl+A": "\x01",
+    "Ctrl+B": "\x02",
+    "Ctrl+C": "\x03",
+    "Ctrl+D": "\x04",
+    "Ctrl+E": "\x05",
+    "Ctrl+F": "\x06",
+    "Ctrl+G": "\x07",
+    "Ctrl+H": "\x08",
+    "Ctrl+I": "\x09",
+    "Ctrl+J": "\x0a",
+    "Ctrl+K": "\x0b",
+    "Ctrl+L": "\x0c",
+    "Ctrl+M": "\x0d",
+    "Ctrl+N": "\x0e",
+    "Ctrl+O": "\x0f",
+    "Ctrl+P": "\x10",
+    "Ctrl+Q": "\x11",
+    "Ctrl+R": "\x12",
+    "Ctrl+S": "\x13",
+    "Ctrl+T": "\x14",
+    "Ctrl+U": "\x15",
+    "Ctrl+V": "\x16",
+    "Ctrl+W": "\x17",
+    "Ctrl+X": "\x18",
+    "Ctrl+Y": "\x19",
+    "Ctrl+Z": "\x1a",
+    "Ctrl+[": "\x1b",
+    "Ctrl+\\": "\x1c",
+    "Ctrl+]": "\x1d",
+    "Ctrl+^": "\x1e",
+    "Ctrl+_": "\x1f",
+    // Common shortcuts
+    "Ctrl+Space": "\x00",
+};
+/**
+ * Get the escape sequence for a key name
+ * @param key - The key name (e.g., "Enter", "Ctrl+C", "ArrowUp")
+ * @returns The escape sequence or null if not found
+ */
+export function getKeySequence(key) {
+    // Normalize key name
+    const normalized = key.trim();
+    // Check direct match
+    if (KEY_SEQUENCES[normalized]) {
+        return KEY_SEQUENCES[normalized];
+    }
+    // Check case-insensitive match
+    const lowerKey = normalized.toLowerCase();
+    for (const [name, seq] of Object.entries(KEY_SEQUENCES)) {
+        if (name.toLowerCase() === lowerKey) {
+            return seq;
+        }
+    }
+    return null;
+}
+/**
+ * Get all available key names
+ */
+export function getAvailableKeys() {
+    return Object.keys(KEY_SEQUENCES);
+}
+//# sourceMappingURL=keys.js.map

package/dist/utils/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/utils/keys.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,eAAe;IACf,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,MAAM;IACnB,QAAQ,EAAE,SAAS;IAEnB,aAAa;IACb,SAAS,EAAE,QAAQ;IACnB,WAAW,EAAE,QAAQ;IACrB,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,QAAQ;IAErB,kBAAkB;IAClB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,SAAS;IACrB,QAAQ,EAAE,SAAS;IAEnB,gBAAgB;IAChB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;IAEjB,oBAAoB;IACpB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAEhB,mBAAmB;IACnB,YAAY,EAAE,MAAM;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,qBAAqB;IACrB,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE9B,qBAAqB;IACrB,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACxD,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC"}

package/dist/utils/stats.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Simple stats tracking for terminal MCP sessions
+ */
+export declare class Stats {
+    private startTime;
+    private toolCalls;
+    private totalCalls;
+    constructor();
+    /**
+     * Record a tool call
+     */
+    recordToolCall(toolName: string): void;
+    /**
+     * Get uptime in seconds
+     */
+    getUptimeSeconds(): number;
+    /**
+     * Get formatted uptime string
+     */
+    getFormattedUptime(): string;
+    /**
+     * Get total tool calls
+     */
+    getTotalCalls(): number;
+    /**
+     * Get tool calls breakdown
+     */
+    getToolCallsBreakdown(): Map<string, number>;
+    /**
+     * Get stats summary
+     */
+    getSummary(): {
+        uptime: string;
+        totalCalls: number;
+        toolCalls: Record<string, number>;
+    };
+}
+/**
+ * Get or create the global stats instance
+ */
+export declare function getStats(): Stats;
+/**
+ * Reset stats (mainly for testing)
+ */
+export declare function resetStats(): void;
+//# sourceMappingURL=stats.d.ts.map

package/dist/utils/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/utils/stats.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,UAAU,CAAS;;IAQ3B;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMtC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAe5B;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAI5C;;OAEG;IACH,UAAU,IAAI;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnC;CAWF;AAKD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAKhC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/utils/stats.js

@@ -0,0 +1,89 @@
+/**
+ * Simple stats tracking for terminal MCP sessions
+ */
+export class Stats {
+    startTime;
+    toolCalls;
+    totalCalls;
+    constructor() {
+        this.startTime = Date.now();
+        this.toolCalls = new Map();
+        this.totalCalls = 0;
+    }
+    /**
+     * Record a tool call
+     */
+    recordToolCall(toolName) {
+        const current = this.toolCalls.get(toolName) || 0;
+        this.toolCalls.set(toolName, current + 1);
+        this.totalCalls++;
+    }
+    /**
+     * Get uptime in seconds
+     */
+    getUptimeSeconds() {
+        return Math.floor((Date.now() - this.startTime) / 1000);
+    }
+    /**
+     * Get formatted uptime string
+     */
+    getFormattedUptime() {
+        const seconds = this.getUptimeSeconds();
+        const hours = Math.floor(seconds / 3600);
+        const minutes = Math.floor((seconds % 3600) / 60);
+        const secs = seconds % 60;
+        if (hours > 0) {
+            return `${hours}h ${minutes}m ${secs}s`;
+        }
+        else if (minutes > 0) {
+            return `${minutes}m ${secs}s`;
+        }
+        else {
+            return `${secs}s`;
+        }
+    }
+    /**
+     * Get total tool calls
+     */
+    getTotalCalls() {
+        return this.totalCalls;
+    }
+    /**
+     * Get tool calls breakdown
+     */
+    getToolCallsBreakdown() {
+        return new Map(this.toolCalls);
+    }
+    /**
+     * Get stats summary
+     */
+    getSummary() {
+        const toolCalls = {};
+        for (const [tool, count] of this.toolCalls) {
+            toolCalls[tool] = count;
+        }
+        return {
+            uptime: this.getFormattedUptime(),
+            totalCalls: this.totalCalls,
+            toolCalls,
+        };
+    }
+}
+// Global stats instance
+let globalStats = null;
+/**
+ * Get or create the global stats instance
+ */
+export function getStats() {
+    if (!globalStats) {
+        globalStats = new Stats();
+    }
+    return globalStats;
+}
+/**
+ * Reset stats (mainly for testing)
+ */
+export function resetStats() {
+    globalStats = new Stats();
+}
+//# sourceMappingURL=stats.js.map

package/dist/utils/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/utils/stats.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,KAAK;IACR,SAAS,CAAS;IAClB,SAAS,CAAsB;IAC/B,UAAU,CAAS;IAE3B;QACE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,CAAC;QAE1B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,GAAG,KAAK,KAAK,OAAO,KAAK,IAAI,GAAG,CAAC;QAC1C,CAAC;aAAM,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,IAAI,GAAG,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,UAAU;QAKR,MAAM,SAAS,GAA2B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC3C,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;QACD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS;SACV,CAAC;IACJ,CAAC;CACF;AAED,wBAAwB;AACxB,IAAI,WAAW,GAAiB,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,IAAI,KAAK,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,WAAW,GAAG,IAAI,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@ellery/terminal-mcp",
+  "version": "0.1.1",
+  "description": "A headless terminal emulator exposed via MCP for AI assistants",
+  "author": "Ellery Familia",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elleryfamilia/terminal-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/elleryfamilia/terminal-mcp/issues"
+  },
+  "homepage": "https://github.com/elleryfamilia/terminal-mcp#readme",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "terminal-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@xterm/headless": "^5.3.0",
+    "node-pty": "^0.10.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "terminal",
+    "pty",
+    "xterm",
+    "ai",
+    "claude"
+  ],
+  "license": "MIT"
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}