@ellery/terminal-mcp 0.2.1 → 0.3.0

package/dist/tools/index.js

@@ -3,7 +3,22 @@ import { typeTool, handleType } from "./type.js";
 import { sendKeyTool, handleSendKey } from "./sendKey.js";
 import { getContentTool, handleGetContent } from "./getContent.js";
 import { screenshotTool, handleScreenshot } from "./screenshot.js";
-const tools = [typeTool, sendKeyTool, getContentTool, screenshotTool];
+import { startRecordingTool, handleStartRecording } from "./startRecording.js";
+import { stopRecordingTool, handleStopRecording } from "./stopRecording.js";
+import { createSessionTool, handleCreateSession } from "./createSession.js";
+import { listSessionsTool, handleListSessions } from "./listSessions.js";
+import { destroySessionTool, handleDestroySession } from "./destroySession.js";
+const tools = [
+    typeTool,
+    sendKeyTool,
+    getContentTool,
+    screenshotTool,
+    startRecordingTool,
+    stopRecordingTool,
+    createSessionTool,
+    listSessionsTool,
+    destroySessionTool,
+];
 export function registerTools(server, manager) {
     // Register list tools handler
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -22,6 +37,16 @@ export function registerTools(server, manager) {
                     return handleGetContent(manager, args);
                 case "takeScreenshot":
                     return handleScreenshot(manager, args);
+                case "startRecording":
+                    return handleStartRecording(manager, args);
+                case "stopRecording":
+                    return await handleStopRecording(manager, args);
+                case "createSession":
+                    return await handleCreateSession(manager, args);
+                case "listSessions":
+                    return handleListSessions(manager, args);
+                case "destroySession":
+                    return handleDestroySession(manager, args);
                 default:
                     throw new Error(`Unknown tool: ${name}`);
             }

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;AAEtE,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAwB;IACpE,8BAA8B;IAC9B,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK;KACN,CAAC,CAAC,CAAC;IAEJ,6BAA6B;IAC7B,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,IAAI,CAAC;YACH,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,MAAM;oBACT,OAAO,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnC,KAAK,SAAS;oBACZ,OAAO,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEtC,KAAK,YAAY;oBACf,OAAO,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEzC,KAAK,gBAAgB;oBACnB,OAAO,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEzC;oBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAU,OAAO,EAAE;qBAC1B;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/listSessions.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { TerminalManager } from "../terminal/index.js";
+export declare const listSessionsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const listSessionsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+};
+export declare function handleListSessions(manager: TerminalManager, _args: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+//# sourceMappingURL=listSessions.d.ts.map

package/dist/tools/listSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listSessions.d.ts","sourceRoot":"","sources":["../../src/tools/listSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,kBAAkB,gDAAe,CAAC;AAE/C,eAAO,MAAM,gBAAgB;;;;;;;;CAQ5B,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,OAAO,GACb;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAUpD"}

package/dist/tools/listSessions.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export const listSessionsSchema = z.object({});
+export const listSessionsTool = {
+    name: "listSessions",
+    description: "List all active terminal sessions, including the default session. Returns session metadata and the configured limits.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+};
+export function handleListSessions(manager, _args) {
+    const result = manager.listSessions();
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=listSessions.js.map

package/dist/tools/listSessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listSessions.js","sourceRoot":"","sources":["../../src/tools/listSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,uHAAuH;IACpI,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAChC,OAAwB,EACxB,KAAc;IAEd,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IACtC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/screenshot.d.ts

@@ -1,20 +1,43 @@
 import { z } from "zod";
 import { TerminalManager } from "../terminal/index.js";
-export declare const screenshotSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const screenshotSchema: z.ZodObject<{
+    format: z.ZodOptional<z.ZodEnum<["text", "ansi", "png"]>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    format?: "text" | "ansi" | "png" | undefined;
+    sessionId?: string | undefined;
+}, {
+    format?: "text" | "ansi" | "png" | undefined;
+    sessionId?: string | undefined;
+}>;
 export type ScreenshotArgs = z.infer<typeof screenshotSchema>;
 export declare const screenshotTool: {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
-        properties: {};
+        properties: {
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            sessionId: {
+                type: string;
+                description: string;
+            };
+        };
         required: never[];
     };
 };
-export declare function handleScreenshot(manager: TerminalManager, _args: unknown): {
+export declare function handleScreenshot(manager: TerminalManager, args: unknown): {
     content: Array<{
         type: "text";
         text: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
     }>;
 };
 //# sourceMappingURL=screenshot.d.ts.map

package/dist/tools/screenshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/tools/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,gBAAgB,gDAAe,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE9D,eAAO,MAAM,cAAc;;;;;;;;CAQ1B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAiB7H"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/tools/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,gBAAgB;;;;;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE9D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;CAoB1B,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,OAAO,GACZ;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAwDxG"}

package/dist/tools/screenshot.js

@@ -1,16 +1,66 @@
 import { z } from "zod";
-export const screenshotSchema = z.object({});
+import { renderTerminalToPng } from "../utils/render.js";
+export const screenshotSchema = z.object({
+    format: z.enum(["text", "ansi", "png"]).optional().describe("Output format: 'text' (default) returns plain JSON, 'ansi' returns text with ANSI color codes, 'png' returns a color screenshot image"),
+    sessionId: z.string().optional().describe("Target session ID. Omit to target the default session."),
+});
 export const screenshotTool = {
     name: "takeScreenshot",
-    description: "Capture terminal state as structured JSON with: content (visible text), cursor {x, y} position, and dimensions {cols, rows}. Use when you need cursor position (e.g., for interactive apps, vim) or terminal dimensions. For simple command output, prefer getContent().",
+    description: "Capture terminal state. Format 'text' (default) returns plain JSON with content, cursor, dimensions. Format 'ansi' returns JSON with ANSI color escape codes preserved in the content field. Format 'png' returns a color screenshot image.",
     inputSchema: {
         type: "object",
-        properties: {},
+        properties: {
+            format: {
+                type: "string",
+                enum: ["text", "ansi", "png"],
+                description: "Output format: 'text' (default) plain JSON, 'ansi' for colored text with ANSI codes, 'png' for color screenshot image",
+            },
+            sessionId: {
+                type: "string",
+                description: "Target session ID. Omit to target the default session.",
+            },
+        },
         required: [],
     },
 };
-export function handleScreenshot(manager, _args) {
-    const screenshot = manager.takeScreenshot();
+export function handleScreenshot(manager, args) {
+    const parsed = screenshotSchema.parse(args);
+    const format = parsed.format || "text";
+    if (format === "ansi") {
+        const content = manager.getAnsiContent(true, parsed.sessionId);
+        const buffer = manager.getTerminal(parsed.sessionId).buffer.active;
+        const result = {
+            content,
+            cursor: { x: buffer.cursorX, y: buffer.cursorY },
+            dimensions: {
+                cols: manager.getDimensions(parsed.sessionId).cols,
+                rows: manager.getDimensions(parsed.sessionId).rows,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    if (format === "png") {
+        const terminal = manager.getTerminal(parsed.sessionId);
+        const pngBuffer = renderTerminalToPng(terminal);
+        return {
+            content: [
+                {
+                    type: "image",
+                    data: pngBuffer.toString("base64"),
+                    mimeType: "image/png",
+                },
+            ],
+        };
+    }
+    // Default text format
+    const screenshot = manager.takeScreenshot(parsed.sessionId);
     const result = {
         content: screenshot.content,
         cursor: screenshot.cursor,

package/dist/tools/screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/tools/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAI7C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,0QAA0Q;IACvR,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,OAAwB,EAAE,KAAc;IACvE,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAE5C,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,UAAU,EAAE,UAAU,CAAC,UAAU;KAClC,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/tools/screenshot.ts"],"names":[],"mappings":"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"}

package/dist/tools/sendKey.d.ts

@@ -2,10 +2,13 @@ import { z } from "zod";
 import { TerminalManager } from "../terminal/index.js";
 export declare const sendKeySchema: z.ZodObject<{
     key: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     key: string;
+    sessionId?: string | undefined;
 }, {
     key: string;
+    sessionId?: string | undefined;
 }>;
 export type SendKeyArgs = z.infer<typeof sendKeySchema>;
 export declare const sendKeyTool: {
@@ -18,6 +21,10 @@ export declare const sendKeyTool: {
                 type: string;
                 description: string;
             };
+            sessionId: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/sendKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sendKey.d.ts","sourceRoot":"","sources":["../../src/tools/sendKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,aAAa;;;;;;EAExB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIxD,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAavB,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAqBzH"}
+{"version":3,"file":"sendKey.d.ts","sourceRoot":"","sources":["../../src/tools/sendKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIxD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;CAiBvB,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAqBzH"}

package/dist/tools/sendKey.js

@@ -2,11 +2,12 @@ import { z } from "zod";
 import { getKeySequence, getAvailableKeys } from "../utils/keys.js";
 export const sendKeySchema = z.object({
     key: z.string().describe("The key to send (e.g., 'Enter', 'Tab', 'Ctrl+C', 'ArrowUp')"),
+    sessionId: z.string().optional().describe("Target session ID. Omit to target the default session."),
 });
 const availableKeys = getAvailableKeys();
 export const sendKeyTool = {
     name: "sendKey",
-    description: "Send a special key or key combination to the terminal. Common keys: Enter, Tab, Escape, Backspace, Delete, ArrowUp/Down/Left/Right, Home, End, PageUp, PageDown. Control sequences: Ctrl+C (interrupt), Ctrl+D (EOF), Ctrl+Z (suspend), Ctrl+L (clear screen), Ctrl+A (line start), Ctrl+E (line end), Ctrl+U (clear line). Function keys: F1-F12.",
+    description: "Send a special key or key combination to the terminal. Common keys: Enter, Tab, Escape, Backspace, Delete, ArrowUp/Down/Left/Right, Home, End, PageUp, PageDown. Control sequences: Ctrl+C (interrupt), Ctrl+D (EOF), Ctrl+Z (suspend), Ctrl+L (clear screen), Ctrl+A (line start), Ctrl+E (line end), Ctrl+U (clear line). Function keys: F1-F12. Pass sessionId to target a specific session.",
     inputSchema: {
         type: "object",
         properties: {
@@ -14,6 +15,10 @@ export const sendKeyTool = {
                 type: "string",
                 description: "The key to send (e.g., 'Enter', 'Tab', 'Ctrl+C', 'ArrowUp', 'Escape')",
             },
+            sessionId: {
+                type: "string",
+                description: "Target session ID. Omit to target the default session.",
+            },
         },
         required: ["key"],
     },
@@ -25,7 +30,7 @@ export function handleSendKey(manager, args) {
         const available = getAvailableKeys();
         throw new Error(`Unknown key: "${parsed.key}". Available keys include: ${available.slice(0, 15).join(", ")}...`);
     }
-    manager.write(sequence);
+    manager.write(sequence, parsed.sessionId);
     return {
         content: [
             {

package/dist/tools/sendKey.js.map

@@ -1 +1 @@
-{"version":3,"file":"sendKey.js","sourceRoot":"","sources":["../../src/tools/sendKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;CACxF,CAAC,CAAC;AAIH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,oVAAoV;IACjW,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,OAAwB,EAAE,IAAa;IACnE,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAE5C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,CAAC,GAAG,8BAA8B,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAChG,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAExB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,MAAM,CAAC,GAAG,EAAE;aAChC;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sendKey.js","sourceRoot":"","sources":["../../src/tools/sendKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IACvF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CACpG,CAAC,CAAC;AAIH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,iYAAiY;IAC9Y,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,OAAwB,EAAE,IAAa;IACnE,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAE5C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,iBAAiB,MAAM,CAAC,GAAG,8BAA8B,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAChG,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAE1C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,MAAM,CAAC,GAAG,EAAE;aAChC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/startRecording.d.ts

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { TerminalManager } from "../terminal/index.js";
+export declare const startRecordingSchema: z.ZodObject<{
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["v2"]>>>;
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["always", "on-failure"]>>>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    idleTimeLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxDuration: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    inactivityTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    format: "v2";
+    mode: "always" | "on-failure";
+    idleTimeLimit: number;
+    maxDuration: number;
+    inactivityTimeout: number;
+    outputDir?: string | undefined;
+}, {
+    format?: "v2" | undefined;
+    mode?: "always" | "on-failure" | undefined;
+    outputDir?: string | undefined;
+    idleTimeLimit?: number | undefined;
+    maxDuration?: number | undefined;
+    inactivityTimeout?: number | undefined;
+}>;
+export declare const startRecordingTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            outputDir: {
+                type: string;
+                description: string;
+            };
+            idleTimeLimit: {
+                type: string;
+                description: string;
+            };
+            maxDuration: {
+                type: string;
+                description: string;
+            };
+            inactivityTimeout: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleStartRecording(manager: TerminalManager, args: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+//# sourceMappingURL=startRecording.d.ts.map

package/dist/tools/startRecording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startRecording.d.ts","sourceRoot":"","sources":["../../src/tools/startRecording.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmC9B,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,OAAO,GACZ;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAuEvE"}

package/dist/tools/startRecording.js

@@ -0,0 +1,111 @@
+import { z } from "zod";
+export const startRecordingSchema = z.object({
+    format: z.enum(['v2']).optional().default('v2'),
+    mode: z.enum(['always', 'on-failure']).optional().default('always'),
+    outputDir: z.string().optional(),
+    idleTimeLimit: z.number().optional().default(2),
+    maxDuration: z.number().optional().default(3600),
+    inactivityTimeout: z.number().optional().default(600),
+});
+export const startRecordingTool = {
+    name: "startRecording",
+    description: "Start recording terminal output to an asciicast v2 file. Returns the recording ID and path where the file will be saved. Only one recording can be active at a time. Recording captures output from all active sessions in the process.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            format: {
+                type: "string",
+                enum: ["v2"],
+                description: "Recording format (default: v2, asciicast v2 format)",
+            },
+            mode: {
+                type: "string",
+                enum: ["always", "on-failure"],
+                description: "Recording mode: always saves the recording, on-failure only saves if session exits with non-zero code (default: always)",
+            },
+            outputDir: {
+                type: "string",
+                description: "Directory to save the recording (default: ~/.local/state/terminal-mcp/recordings, or TERMINAL_MCP_RECORD_DIR env var)",
+            },
+            idleTimeLimit: {
+                type: "number",
+                description: "Max seconds between events in the recording (default: 2). Caps idle time to prevent long pauses during playback.",
+            },
+            maxDuration: {
+                type: "number",
+                description: "Max recording duration in seconds (default: 3600 = 60 minutes). Recording will auto-stop when this limit is reached.",
+            },
+            inactivityTimeout: {
+                type: "number",
+                description: "Stop recording after N seconds of no terminal output (default: 600 = 10 minutes). Resets on each output event.",
+            },
+        },
+        required: [],
+    },
+};
+export function handleStartRecording(manager, args) {
+    const parsed = startRecordingSchema.parse(args ?? {});
+    const recordingManager = manager.getRecordingManager();
+    // Check if there's already an active recording
+    const activeRecordings = recordingManager.getActiveRecordings();
+    if (activeRecordings.length > 0) {
+        const existing = activeRecordings[0];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "A recording is already in progress",
+                        activeRecordingId: existing.id,
+                        activePath: existing.getFinalPath(),
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const recorder = recordingManager.createRecording({
+        format: parsed.format,
+        mode: parsed.mode,
+        outputDir: parsed.outputDir ?? recordingManager.getDefaultOutputDir(),
+        idleTimeLimit: parsed.idleTimeLimit,
+        maxDuration: parsed.maxDuration,
+        inactivityTimeout: parsed.inactivityTimeout,
+    });
+    // Get current dimensions and start recording
+    const dimensions = manager.getDimensions();
+    recorder.start(dimensions.cols, dimensions.rows, {
+        TERM: 'xterm-256color',
+    });
+    // Build timeout message
+    const timeoutParts = [];
+    if (parsed.maxDuration > 0) {
+        const mins = Math.floor(parsed.maxDuration / 60);
+        timeoutParts.push(`${mins} minute${mins !== 1 ? 's' : ''}`);
+    }
+    if (parsed.inactivityTimeout > 0) {
+        const mins = Math.floor(parsed.inactivityTimeout / 60);
+        timeoutParts.push(`${mins} minute${mins !== 1 ? 's' : ''} of inactivity`);
+    }
+    const timeoutMessage = timeoutParts.length > 0
+        ? `Recording will auto-stop after ${timeoutParts.join(' or ')}`
+        : undefined;
+    const result = {
+        recordingId: recorder.id,
+        path: recorder.getFinalPath(),
+        format: parsed.format,
+        mode: parsed.mode,
+        maxDuration: parsed.maxDuration,
+        inactivityTimeout: parsed.inactivityTimeout,
+        message: timeoutMessage,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=startRecording.js.map

package/dist/tools/startRecording.js.map

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

package/dist/tools/stopRecording.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { TerminalManager } from "../terminal/index.js";
+export declare const stopRecordingSchema: z.ZodObject<{
+    recordingId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    recordingId: string;
+}, {
+    recordingId: string;
+}>;
+export declare const stopRecordingTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            recordingId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleStopRecording(manager: TerminalManager, args: unknown): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=stopRecording.d.ts.map

package/dist/tools/stopRecording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopRecording.d.ts","sourceRoot":"","sources":["../../src/tools/stopRecording.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAa7B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA+DhF"}

package/dist/tools/stopRecording.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+export const stopRecordingSchema = z.object({
+    recordingId: z.string(),
+});
+export const stopRecordingTool = {
+    name: "stopRecording",
+    description: "Stop a recording and finalize the asciicast file. Returns metadata about the saved recording including the file path and duration.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            recordingId: {
+                type: "string",
+                description: "The recording ID returned by startRecording",
+            },
+        },
+        required: ["recordingId"],
+    },
+};
+export async function handleStopRecording(manager, args) {
+    const parsed = stopRecordingSchema.parse(args);
+    const recordingManager = manager.getRecordingManager();
+    const recorder = recordingManager.getRecording(parsed.recordingId);
+    if (!recorder) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: Recording not found: ${parsed.recordingId}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (!recorder.isActive()) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: Recording already finalized: ${parsed.recordingId}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Finalize with exit code 0 (explicit stop means success)
+    const metadata = await recordingManager.finalizeRecording(parsed.recordingId, 0, 'explicit');
+    if (!metadata) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: Failed to finalize recording: ${parsed.recordingId}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const result = {
+        recordingId: metadata.id,
+        path: metadata.path,
+        durationMs: metadata.durationMs,
+        bytesWritten: metadata.bytesWritten,
+        saved: metadata.saved,
+        mode: metadata.mode,
+        stopReason: metadata.stopReason,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=stopRecording.js.map

package/dist/tools/stopRecording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopRecording.js","sourceRoot":"","sources":["../../src/tools/stopRecording.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,oIAAoI;IACjJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAwB,EACxB,IAAa;IAEb,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/C,MAAM,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEnE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,+BAA+B,MAAM,CAAC,WAAW,EAAE;iBAC1D;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,uCAAuC,MAAM,CAAC,WAAW,EAAE;iBAClE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IAE7F,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,wCAAwC,MAAM,CAAC,WAAW,EAAE;iBACnE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG;QACb,WAAW,EAAE,QAAQ,CAAC,EAAE;QACxB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}