@gtkx/mcp 0.21.0 → 1.0.0-rc.1

package/src/transport.ts

@@ -0,0 +1,165 @@
+import EventEmitter from "node:events";
+import type { Socket } from "node:net";
+import type { Duplex } from "node:stream";
+import { ErrorCode, invalidRequestError, isErrorCode, ProtocolError, requestTimeoutError } from "./protocol/errors.js";
+import { type Message, type Request, RequestSchema, type Response, ResponseSchema } from "./protocol/schemas.js";
+
+export type ProtocolConnectionEvents = {
+    request: [Request];
+    invalid: [{ id: string; error: ProtocolError }];
+};
+
+type PendingRequest = {
+    resolve: (result: unknown) => void;
+    reject: (error: Error) => void;
+    timeout: NodeJS.Timeout;
+};
+
+export class ConnectionClosedError extends Error {
+    constructor() {
+        super("Connection stream is not writable");
+        this.name = "ConnectionClosedError";
+    }
+}
+
+export class ProtocolConnection extends EventEmitter<ProtocolConnectionEvents> {
+    id: string = crypto.randomUUID();
+    private buffer = "";
+    private pending: Map<string, PendingRequest> = new Map();
+    private writer: Duplex;
+
+    constructor(writer: Duplex) {
+        super();
+        this.writer = writer;
+    }
+
+    feed(data: Buffer | string): void {
+        this.buffer += typeof data === "string" ? data : data.toString();
+
+        let newlineIndex = this.buffer.indexOf("\n");
+        while (newlineIndex !== -1) {
+            const line = this.buffer.slice(0, newlineIndex);
+            this.buffer = this.buffer.slice(newlineIndex + 1);
+
+            if (line.trim()) {
+                this.processLine(line);
+            }
+            newlineIndex = this.buffer.indexOf("\n");
+        }
+    }
+
+    write(message: Message): void {
+        if (!this.writer.writable) return;
+        this.writer.write(`${JSON.stringify(message)}\n`);
+    }
+
+    static fromSocket(
+        socket: Socket,
+        options: {
+            onClose?: () => void;
+            onError?: (error: Error) => void;
+        } = {},
+    ): ProtocolConnection {
+        const connection = new ProtocolConnection(socket);
+        socket.on("data", (data: Buffer) => connection.feed(data));
+        socket.on("close", () => {
+            connection.rejectPending(new Error("Connection closed"));
+            options.onClose?.();
+        });
+        if (options.onError) {
+            socket.on("error", options.onError);
+        }
+        return connection;
+    }
+
+    send<T = unknown>(method: string, params: unknown, timeout: number): Promise<T> {
+        return new Promise<T>((resolve, reject) => {
+            if (!this.writer.writable) {
+                reject(new ConnectionClosedError());
+                return;
+            }
+
+            const id = crypto.randomUUID();
+            const timeoutHandle = setTimeout(() => {
+                this.pending.delete(id);
+                reject(requestTimeoutError(timeout));
+            }, timeout);
+
+            this.pending.set(id, {
+                resolve: resolve as (result: unknown) => void,
+                reject,
+                timeout: timeoutHandle,
+            });
+
+            this.write({ id, method, params });
+            if (!this.writer.writable) {
+                clearTimeout(timeoutHandle);
+                this.pending.delete(id);
+                reject(new ConnectionClosedError());
+            }
+        });
+    }
+
+    rejectPending(error: Error): void {
+        for (const entry of this.pending.values()) {
+            clearTimeout(entry.timeout);
+            entry.reject(error);
+        }
+        this.pending.clear();
+    }
+
+    private processLine(line: string): void {
+        let parsed: unknown;
+        try {
+            parsed = JSON.parse(line);
+        } catch {
+            this.emit("invalid", { id: "unknown", error: invalidRequestError("Invalid JSON") });
+            return;
+        }
+
+        const message = parsed as Record<string, unknown>;
+        if (typeof message.method === "string") {
+            const requestResult = RequestSchema.safeParse(parsed);
+            if (requestResult.success) {
+                this.emit("request", requestResult.data);
+                return;
+            }
+        } else {
+            const responseResult = ResponseSchema.safeParse(parsed);
+            if (responseResult.success) {
+                this.handleResponse(responseResult.data);
+                return;
+            }
+        }
+
+        const id = typeof message.id === "string" ? message.id : "unknown";
+        this.emit("invalid", { id, error: invalidRequestError("Invalid message format") });
+    }
+
+    private handleResponse(response: Response): void {
+        const entry = this.pending.get(response.id);
+        if (!entry) return;
+
+        clearTimeout(entry.timeout);
+        this.pending.delete(response.id);
+
+        if (response.error) {
+            const err = response.error;
+            entry.reject(
+                new ProtocolError(isErrorCode(err.code) ? err.code : ErrorCode.INTERNAL_ERROR, err.message, err.data),
+            );
+        } else {
+            entry.resolve(response.result);
+        }
+    }
+}
+
+export type AppConnectionEvents = {
+    disconnection: [ProtocolConnection];
+    request: [ProtocolConnection, Request];
+    error: [Error];
+};
+
+export interface AppConnections extends EventEmitter<AppConnectionEvents> {
+    send(connectionId: string, message: Message): void;
+}

package/dist/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -1,399 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from "node:module";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-import { z } from "zod";
-import { ConnectionManager } from "./connection-manager.js";
-import { DEFAULT_SOCKET_PATH } from "./protocol/types.js";
-import { SocketServer } from "./socket-server.js";
-const require = createRequire(import.meta.url);
-const { version } = require("../package.json");
-const AppIdSchema = z.object({
-    appId: z.string().optional().describe("App ID to query. If not specified, uses the first connected app."),
-});
-const ListAppsInputSchema = z.object({
-    waitForApps: z
-        .boolean()
-        .optional()
-        .describe("If true, wait for at least one app to register before returning. Useful when app is still starting."),
-    timeout: z.number().optional().describe("Timeout in milliseconds when waitForApps is true (default: 10000)"),
-});
-const GetWidgetTreeInputSchema = AppIdSchema;
-const QueryWidgetsInputSchema = AppIdSchema.extend({
-    by: z.enum(["role", "text", "name", "labelText"]).describe("Query type"),
-    value: z.union([z.string(), z.number()]).describe("Value to search for"),
-    options: z
-        .object({
-        name: z.string().optional(),
-        exact: z.boolean().optional(),
-        timeout: z.number().optional(),
-    })
-        .optional()
-        .describe("Additional query options"),
-});
-const WidgetIdSchema = AppIdSchema.extend({
-    widgetId: z.string().describe("Widget ID"),
-});
-const GetWidgetPropsInputSchema = WidgetIdSchema;
-const ClickInputSchema = WidgetIdSchema;
-const TypeInputSchema = WidgetIdSchema.extend({
-    text: z.string().describe("Text to type"),
-    clear: z.boolean().optional().describe("Clear existing text before typing"),
-});
-const FireEventInputSchema = WidgetIdSchema.extend({
-    signal: z.string().describe("GTK signal name to emit"),
-    args: z.array(z.unknown()).optional().describe("Arguments to pass to the signal"),
-});
-const TakeScreenshotInputSchema = AppIdSchema.extend({
-    windowId: z.string().optional().describe("Window ID to capture. If not specified, captures the first window."),
-});
-const tools = [
-    {
-        name: "gtkx_list_apps",
-        description: "List all connected GTKX applications",
-        inputSchema: {
-            type: "object",
-            properties: {
-                waitForApps: {
-                    type: "boolean",
-                    description: "If true, wait for at least one app to register before returning. Useful when app is still starting.",
-                },
-                timeout: {
-                    type: "number",
-                    description: "Timeout in milliseconds when waitForApps is true (default: 10000)",
-                },
-            },
-            required: [],
-        },
-    },
-    {
-        name: "gtkx_get_widget_tree",
-        description: "Get the widget hierarchy for a connected GTKX app. Returns a tree of all widgets with their IDs, types, roles, and properties.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                appId: {
-                    type: "string",
-                    description: "App ID to query. If not specified, uses the first connected app.",
-                },
-            },
-            required: [],
-        },
-    },
-    {
-        name: "gtkx_query_widgets",
-        description: "Find widgets by role, text, name, or label. Returns matching widgets with their IDs and properties.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                appId: {
-                    type: "string",
-                    description: "App ID to query. If not specified, uses the first connected app.",
-                },
-                by: {
-                    type: "string",
-                    enum: ["role", "text", "name", "labelText"],
-                    description: "Query type",
-                },
-                value: {
-                    oneOf: [{ type: "string" }, { type: "number" }],
-                    description: "Value to search for",
-                },
-                options: {
-                    type: "object",
-                    properties: {
-                        name: { type: "string" },
-                        exact: { type: "boolean" },
-                        timeout: { type: "number" },
-                    },
-                    description: "Additional query options",
-                },
-            },
-            required: ["by", "value"],
-        },
-    },
-    {
-        name: "gtkx_get_widget_props",
-        description: "Get all properties of a specific widget by its ID",
-        inputSchema: {
-            type: "object",
-            properties: {
-                appId: {
-                    type: "string",
-                    description: "App ID to query. If not specified, uses the first connected app.",
-                },
-                widgetId: {
-                    type: "string",
-                    description: "Widget ID to get properties for",
-                },
-            },
-            required: ["widgetId"],
-        },
-    },
-    {
-        name: "gtkx_click",
-        description: "Click a widget. Works with buttons, checkboxes, and other interactive widgets.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                appId: {
-                    type: "string",
-                    description: "App ID to query. If not specified, uses the first connected app.",
-                },
-                widgetId: {
-                    type: "string",
-                    description: "Widget ID to click",
-                },
-            },
-            required: ["widgetId"],
-        },
-    },
-    {
-        name: "gtkx_type",
-        description: "Type text into an editable widget like Entry or TextView",
-        inputSchema: {
-            type: "object",
-            properties: {
-                appId: {
-                    type: "string",
-                    description: "App ID to query. If not specified, uses the first connected app.",
-                },
-                widgetId: {
-                    type: "string",
-                    description: "Widget ID to type into",
-                },
-                text: {
-                    type: "string",
-                    description: "Text to type",
-                },
-                clear: {
-                    type: "boolean",
-                    description: "Clear existing text before typing",
-                },
-            },
-            required: ["widgetId", "text"],
-        },
-    },
-    {
-        name: "gtkx_fire_event",
-        description: "Emit a GTK signal on a widget. Use this for custom interactions.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                appId: {
-                    type: "string",
-                    description: "App ID to query. If not specified, uses the first connected app.",
-                },
-                widgetId: {
-                    type: "string",
-                    description: "Widget ID to emit event on",
-                },
-                signal: {
-                    type: "string",
-                    description: "GTK signal name to emit",
-                },
-                args: {
-                    type: "array",
-                    items: {},
-                    description: "Arguments to pass to the signal",
-                },
-            },
-            required: ["widgetId", "signal"],
-        },
-    },
-    {
-        name: "gtkx_take_screenshot",
-        description: "Capture a screenshot of a window. Returns base64-encoded PNG image data.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                appId: {
-                    type: "string",
-                    description: "App ID to query. If not specified, uses the first connected app.",
-                },
-                windowId: {
-                    type: "string",
-                    description: "Window ID to capture. If not specified, captures the first window.",
-                },
-            },
-            required: [],
-        },
-    },
-];
-async function main() {
-    const socketServer = new SocketServer(DEFAULT_SOCKET_PATH);
-    const connectionManager = new ConnectionManager(socketServer);
-    socketServer.on("error", (error) => {
-        const code = error.code;
-        if (code !== "EPIPE" && code !== "ECONNRESET") {
-            console.error("[gtkx] Socket error:", error.message);
-        }
-    });
-    await socketServer.start();
-    console.error(`[gtkx] Socket server listening on ${DEFAULT_SOCKET_PATH}`);
-    connectionManager.on("appRegistered", (appInfo) => {
-        console.error(`[gtkx] App registered: ${appInfo.appId} (PID: ${appInfo.pid})`);
-    });
-    connectionManager.on("appUnregistered", (appId) => {
-        console.error(`[gtkx] App unregistered: ${appId}`);
-    });
-    const server = new Server({
-        name: "gtkx-mcp",
-        version,
-    }, {
-        capabilities: {
-            tools: {},
-        },
-    });
-    server.setRequestHandler(ListToolsRequestSchema, async () => {
-        return { tools };
-    });
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        const { name, arguments: args } = request.params;
-        try {
-            switch (name) {
-                case "gtkx_list_apps": {
-                    const input = ListAppsInputSchema.parse(args);
-                    if (input.waitForApps && !connectionManager.hasConnectedApps()) {
-                        try {
-                            await connectionManager.waitForApp(input.timeout);
-                        }
-                        catch (error) {
-                            return {
-                                content: [
-                                    {
-                                        type: "text",
-                                        text: error instanceof Error ? error.message : "Timeout waiting for app",
-                                    },
-                                ],
-                                isError: true,
-                            };
-                        }
-                    }
-                    const apps = connectionManager.getApps();
-                    const appsWithWindows = await Promise.all(apps.map(async (app) => {
-                        try {
-                            const result = await connectionManager.sendToApp(app.appId, "app.getWindows", {});
-                            return { ...app, windows: result.windows };
-                        }
-                        catch {
-                            return app;
-                        }
-                    }));
-                    return {
-                        content: [{ type: "text", text: JSON.stringify(appsWithWindows, null, 2) }],
-                    };
-                }
-                case "gtkx_get_widget_tree": {
-                    const input = GetWidgetTreeInputSchema.parse(args);
-                    const result = await connectionManager.sendToApp(input.appId, "widget.getTree", {});
-                    return {
-                        content: [{ type: "text", text: result.tree }],
-                    };
-                }
-                case "gtkx_query_widgets": {
-                    const input = QueryWidgetsInputSchema.parse(args);
-                    const result = await connectionManager.sendToApp(input.appId, "widget.query", {
-                        queryType: input.by,
-                        value: input.value,
-                        options: input.options,
-                    });
-                    return {
-                        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-                    };
-                }
-                case "gtkx_get_widget_props": {
-                    const input = GetWidgetPropsInputSchema.parse(args);
-                    const result = await connectionManager.sendToApp(input.appId, "widget.getProps", {
-                        widgetId: input.widgetId,
-                    });
-                    return {
-                        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-                    };
-                }
-                case "gtkx_click": {
-                    const input = ClickInputSchema.parse(args);
-                    await connectionManager.sendToApp(input.appId, "widget.click", {
-                        widgetId: input.widgetId,
-                    });
-                    return {
-                        content: [{ type: "text", text: "Click successful" }],
-                    };
-                }
-                case "gtkx_type": {
-                    const input = TypeInputSchema.parse(args);
-                    await connectionManager.sendToApp(input.appId, "widget.type", {
-                        widgetId: input.widgetId,
-                        text: input.text,
-                        clear: input.clear,
-                    });
-                    return {
-                        content: [{ type: "text", text: "Type successful" }],
-                    };
-                }
-                case "gtkx_fire_event": {
-                    const input = FireEventInputSchema.parse(args);
-                    await connectionManager.sendToApp(input.appId, "widget.fireEvent", {
-                        widgetId: input.widgetId,
-                        signal: input.signal,
-                        args: input.args,
-                    });
-                    return {
-                        content: [{ type: "text", text: "Event fired successfully" }],
-                    };
-                }
-                case "gtkx_take_screenshot": {
-                    const input = TakeScreenshotInputSchema.parse(args);
-                    const result = await connectionManager.sendToApp(input.appId, "widget.screenshot", {
-                        windowId: input.windowId,
-                    });
-                    return {
-                        content: [
-                            {
-                                type: "image",
-                                data: result.data,
-                                mimeType: result.mimeType,
-                            },
-                        ],
-                    };
-                }
-                default:
-                    return {
-                        content: [{ type: "text", text: `Unknown tool: ${name}` }],
-                        isError: true,
-                    };
-            }
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [{ type: "text", text: message }],
-                isError: true,
-            };
-        }
-    });
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    let isShuttingDown = false;
-    const shutdown = async () => {
-        if (isShuttingDown)
-            return;
-        isShuttingDown = true;
-        try {
-            connectionManager.cleanup();
-            await socketServer.stop();
-            await server.close();
-        }
-        finally {
-            process.exit(0);
-        }
-    };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-}
-main().catch((error) => {
-    console.error("[gtkx] Fatal error:", error);
-    process.exit(1);
-});
-//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/connection-manager.d.ts

@@ -1,48 +0,0 @@
-import EventEmitter from "node:events";
-import { type AppInfo } from "./protocol/types.js";
-import type { AppConnection, SocketServer } from "./socket-server.js";
-type ConnectionManagerEventMap = {
-    appRegistered: [AppInfo];
-    appUnregistered: [string];
-};
-type RegisteredApp = {
-    info: AppInfo;
-    connection: AppConnection;
-};
-/**
- * Manages connections between the MCP server and GTKX applications.
- *
- * Handles app registration, request routing, and connection lifecycle.
- */
-export declare class ConnectionManager extends EventEmitter<ConnectionManagerEventMap> {
-    private socketServer;
-    private static readonly DEFAULT_WAIT_TIMEOUT;
-    private apps;
-    private connectionToApp;
-    private pendingRequests;
-    private requestTimeout;
-    constructor(socketServer: SocketServer, options?: {
-        requestTimeout?: number;
-    });
-    getApps(): AppInfo[];
-    getApp(appId: string): AppInfo | undefined;
-    hasConnectedApps(): boolean;
-    getDefaultApp(): RegisteredApp | undefined;
-    /**
-     * Waits for at least one app to connect and register.
-     *
-     * @param timeout - Maximum time to wait in milliseconds (default: 10000)
-     * @returns Promise that resolves with the first registered app info
-     * @throws Error if timeout is reached before any app registers
-     */
-    waitForApp(timeout?: number): Promise<AppInfo>;
-    sendToApp<T>(appId: string | undefined, method: string, params?: unknown): Promise<T>;
-    cleanup(): void;
-    private handleRequest;
-    private handleResponse;
-    private handleRegister;
-    private handleUnregister;
-    private handleDisconnection;
-}
-export {};
-//# sourceMappingURL=connection-manager.d.ts.map

package/dist/connection-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../src/connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,aAAa,CAAC;AASvC,OAAO,EAAE,KAAK,OAAO,EAA2D,MAAM,qBAAqB,CAAC;AAC5G,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,KAAK,yBAAyB,GAAG;IAC7B,aAAa,EAAE,CAAC,OAAO,CAAC,CAAC;IACzB,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC;CAC7B,CAAC;AAQF,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,aAAa,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,yBAAyB,CAAC;IAStE,OAAO,CAAC,YAAY;IARxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAErD,OAAO,CAAC,IAAI,CAAyC;IACrD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,cAAc,CAAS;gBAGnB,YAAY,EAAE,YAAY,EAClC,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO;IAkB7C,OAAO,IAAI,OAAO,EAAE;IAIpB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI1C,gBAAgB,IAAI,OAAO;IAI3B,aAAa,IAAI,aAAa,GAAG,SAAS;IAK1C;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,GAAE,MAA+C,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BhF,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAuC3F,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,cAAc;IAmCtB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,mBAAmB;CAQ9B"}