@gtkx/mcp 0.20.0 → 1.0.0-rc.1

package/dist/socket-server.js

@@ -1,59 +1,50 @@
-import EventEmitter from "node:events";
 import * as fs from "node:fs";
 import * as net from "node:net";
-import { invalidRequestError } from "./protocol/errors.js";
-import { DEFAULT_SOCKET_PATH, IpcRequestSchema, IpcResponseSchema, } from "./protocol/types.js";
-/**
- * Unix domain socket server for MCP communication.
- *
- * Manages connections from GTKX applications and handles IPC messaging.
- */
-export class SocketServer extends EventEmitter {
+import { DEFAULT_SOCKET_PATH } from "./protocol/schemas.js";
+const isSocketLive = (socketPath) => new Promise((resolve) => {
+    const probe = net.connect(socketPath);
+    probe.once("connect", () => {
+        probe.destroy();
+        resolve(true);
+    });
+    probe.once("error", () => resolve(false));
+});
+export class SocketServer {
     server = null;
-    connections = new Map();
     socketPath;
-    constructor(socketPath = DEFAULT_SOCKET_PATH) {
-        super();
+    registry;
+    constructor(registry, socketPath = DEFAULT_SOCKET_PATH) {
+        this.registry = registry;
         this.socketPath = socketPath;
     }
-    get path() {
-        return this.socketPath;
-    }
-    get isListening() {
-        return this.server?.listening ?? false;
-    }
-    getConnections() {
-        return Array.from(this.connections.values());
-    }
-    getConnection(id) {
-        return this.connections.get(id);
-    }
     async start() {
-        if (this.server) {
+        if (this.server)
             return;
-        }
         if (fs.existsSync(this.socketPath)) {
+            if (await isSocketLive(this.socketPath)) {
+                throw new Error(`Another GTKX MCP server already owns ${this.socketPath}. ` +
+                    "Stop the other server (for example, the gtkx MCP server of another active session) and reconnect.");
+            }
             fs.unlinkSync(this.socketPath);
         }
         return new Promise((resolve, reject) => {
-            this.server = net.createServer((socket) => this.handleConnection(socket));
+            this.server = net.createServer((socket) => this.registry.register(socket));
+            let listening = false;
             this.server.on("error", (error) => {
-                this.emit("error", error);
-                reject(error);
+                this.registry.emit("error", error);
+                if (!listening)
+                    reject(error);
             });
             this.server.listen(this.socketPath, () => {
+                listening = true;
                 resolve();
             });
         });
     }
     async stop() {
-        if (!this.server) {
+        if (!this.server)
             return;
-        }
-        for (const connection of this.connections.values()) {
-            connection.socket.destroy();
-        }
-        this.connections.clear();
+        this.registry.dispose("Server stopping");
         return new Promise((resolve) => {
             this.server?.close(() => {
                 this.server = null;
@@ -64,79 +55,5 @@ export class SocketServer extends EventEmitter {
             });
         });
     }
-    send(connectionId, message) {
-        const connection = this.connections.get(connectionId);
-        if (!connection || !connection.socket.writable) {
-            return false;
-        }
-        const data = `${JSON.stringify(message)}\n`;
-        connection.socket.write(data);
-        return true;
-    }
-    handleConnection(socket) {
-        const connectionId = crypto.randomUUID();
-        const connection = {
-            id: connectionId,
-            socket,
-            buffer: "",
-        };
-        this.connections.set(connectionId, connection);
-        this.emit("connection", connection);
-        socket.on("data", (data) => this.handleData(connection, data));
-        socket.on("close", () => {
-            this.connections.delete(connectionId);
-            this.emit("disconnection", connection);
-        });
-        socket.on("error", (error) => {
-            this.emit("error", error);
-        });
-    }
-    handleData(connection, data) {
-        connection.buffer += data.toString();
-        let newlineIndex = connection.buffer.indexOf("\n");
-        while (newlineIndex !== -1) {
-            const line = connection.buffer.slice(0, newlineIndex);
-            connection.buffer = connection.buffer.slice(newlineIndex + 1);
-            if (line.trim()) {
-                this.processMessage(connection, line);
-            }
-            newlineIndex = connection.buffer.indexOf("\n");
-        }
-    }
-    processMessage(connection, line) {
-        let parsed;
-        try {
-            parsed = JSON.parse(line);
-        }
-        catch {
-            const response = {
-                id: "unknown",
-                error: invalidRequestError("Invalid JSON").toIpcError(),
-            };
-            this.send(connection.id, response);
-            return;
-        }
-        const message = parsed;
-        const hasMethod = typeof message.method === "string";
-        if (hasMethod) {
-            const requestResult = IpcRequestSchema.safeParse(parsed);
-            if (requestResult.success) {
-                this.emit("request", connection, requestResult.data);
-                return;
-            }
-        }
-        else {
-            const responseResult = IpcResponseSchema.safeParse(parsed);
-            if (responseResult.success) {
-                this.emit("response", connection, responseResult.data);
-                return;
-            }
-        }
-        const response = {
-            id: message.id ?? "unknown",
-            error: invalidRequestError("Invalid message format").toIpcError(),
-        };
-        this.send(connection.id, response);
-    }
 }
 //# sourceMappingURL=socket-server.js.map

package/dist/socket-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"socket-server.js","sourceRoot":"","sources":["../src/socket-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"socket-server.js","sourceRoot":"","sources":["../src/socket-server.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs\";\nimport * as net from \"node:net\";\nimport type { ConnectionRegistry } from \"./connection-registry.js\";\nimport { DEFAULT_SOCKET_PATH } from \"./protocol/schemas.js\";\n\nconst isSocketLive = (socketPath: string): Promise<boolean> =>\n    new Promise((resolve) => {\n        const probe = net.connect(socketPath);\n        probe.once(\"connect\", () => {\n            probe.destroy();\n            resolve(true);\n        });\n        probe.once(\"error\", () => resolve(false));\n    });\n\nexport class SocketServer {\n    private server: net.Server | null = null;\n    private socketPath: string;\n    private registry: ConnectionRegistry;\n\n    constructor(registry: ConnectionRegistry, socketPath: string = DEFAULT_SOCKET_PATH) {\n        this.registry = registry;\n        this.socketPath = socketPath;\n    }\n\n    async start(): Promise<void> {\n        if (this.server) return;\n\n        if (fs.existsSync(this.socketPath)) {\n            if (await isSocketLive(this.socketPath)) {\n                throw new Error(\n                    `Another GTKX MCP server already owns ${this.socketPath}. ` +\n                        \"Stop the other server (for example, the gtkx MCP server of another active session) and reconnect.\",\n                );\n            }\n            fs.unlinkSync(this.socketPath);\n        }\n\n        return new Promise((resolve, reject) => {\n            this.server = net.createServer((socket) => this.registry.register(socket));\n\n            let listening = false;\n            this.server.on(\"error\", (error) => {\n                this.registry.emit(\"error\", error);\n                if (!listening) reject(error);\n            });\n\n            this.server.listen(this.socketPath, () => {\n                listening = true;\n                resolve();\n            });\n        });\n    }\n\n    async stop(): Promise<void> {\n        if (!this.server) return;\n\n        this.registry.dispose(\"Server stopping\");\n\n        return new Promise((resolve) => {\n            this.server?.close(() => {\n                this.server = null;\n                if (fs.existsSync(this.socketPath)) {\n                    fs.unlinkSync(this.socketPath);\n                }\n                resolve();\n            });\n        });\n    }\n}\n"]}

package/dist/tool.d.ts

@@ -0,0 +1,22 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { z } from "zod";
+export declare const textContent: (text: string) => CallToolResult;
+export declare const textError: (text: string) => CallToolResult;
+export declare const imageContent: (data: string, mimeType: string) => CallToolResult;
+export type ToolArgs<Shape extends Record<string, z.ZodType>> = {
+    [K in keyof Shape]: z.output<Shape[K]>;
+};
+type ToolKind = "readOnly" | "action";
+export type Tool<Shape extends Record<string, z.ZodType> = Record<string, z.ZodType>> = {
+    name: string;
+    title: string;
+    kind: ToolKind;
+    description: string;
+    inputSchema: Shape;
+    handler: (args: ToolArgs<Shape>) => Promise<CallToolResult>;
+};
+export declare const defineTool: <Shape extends Record<string, z.ZodType>>(tool: Tool<Shape>) => Tool;
+export declare const registerTool: (server: McpServer, tool: Tool) => void;
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,cAAyD,CAAC;AAErG,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,cAGvC,CAAC;AAEH,eAAO,MAAM,YAAY,SAAU,MAAM,YAAY,MAAM,KAAG,cAE5D,CAAC;AAEH,MAAM,MAAM,QAAQ,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAE3G,KAAK,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtC,MAAM,MAAM,IAAI,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC;IACnB,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/D,CAAC;AAmBF,eAAO,MAAM,UAAU,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAG,IAAoB,CAAC;AAE7G,eAAO,MAAM,YAAY,WAAY,SAAS,QAAQ,IAAI,KAAG,IAiB5D,CAAC"}

package/dist/tool.js

@@ -0,0 +1,36 @@
+import { ProtocolError } from "./protocol/errors.js";
+export const textContent = (text) => ({ content: [{ type: "text", text }] });
+export const textError = (text) => ({
+    content: [{ type: "text", text }],
+    isError: true,
+});
+export const imageContent = (data, mimeType) => ({
+    content: [{ type: "image", data, mimeType }],
+});
+const hasStringHint = (data) => typeof data === "object" && data !== null && "hint" in data && typeof data.hint === "string";
+const runTool = async (handler, args) => {
+    try {
+        return await handler(args);
+    }
+    catch (error) {
+        if (error instanceof ProtocolError) {
+            return textError(hasStringHint(error.data) ? `${error.message}\n${error.data.hint}` : error.message);
+        }
+        return textError(error instanceof Error ? error.message : String(error));
+    }
+};
+export const defineTool = (tool) => tool;
+export const registerTool = (server, tool) => {
+    const callback = ((args, _extra) => runTool(tool.handler, args));
+    server.registerTool(tool.name, {
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        annotations: {
+            title: tool.title,
+            readOnlyHint: tool.kind === "readOnly",
+            destructiveHint: tool.kind === "action",
+            openWorldHint: true,
+        },
+    }, callback);
+};
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAkB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAErG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAkB,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjC,OAAO,EAAE,IAAI;CAChB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAkB,EAAE,CAAC,CAAC;IAC7E,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;CAC/C,CAAC,CAAC;AAeH,MAAM,aAAa,GAAG,CAAC,IAAa,EAA4B,EAAE,CAC9D,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAEjG,MAAM,OAAO,GAAG,KAAK,EACjB,OAA+E,EAC/E,IAAyC,EAClB,EAAE;IACzB,IAAI,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzG,CAAC;QACD,OAAO,SAAS,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7E,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAA0C,IAAiB,EAAQ,EAAE,CAAC,IAAY,CAAC;AAE7G,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAiB,EAAE,IAAU,EAAQ,EAAE;IAChE,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAyC,EAAE,MAAe,EAAE,EAAE,CAC7E,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAA4C,CAAC;IAC5E,MAAM,CAAC,YAAY,CACf,IAAI,CAAC,IAAI,EACT;QACI,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE;YACT,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,IAAI,KAAK,UAAU;YACtC,eAAe,EAAE,IAAI,CAAC,IAAI,KAAK,QAAQ;YACvC,aAAa,EAAE,IAAI;SACtB;KACJ,EACD,QAAQ,CACX,CAAC;AACN,CAAC,CAAC","sourcesContent":["import type { McpServer, ToolCallback } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { z } from \"zod\";\nimport { ProtocolError } from \"./protocol/errors.js\";\n\nexport const textContent = (text: string): CallToolResult => ({ content: [{ type: \"text\", text }] });\n\nexport const textError = (text: string): CallToolResult => ({\n    content: [{ type: \"text\", text }],\n    isError: true,\n});\n\nexport const imageContent = (data: string, mimeType: string): CallToolResult => ({\n    content: [{ type: \"image\", data, mimeType }],\n});\n\nexport type ToolArgs<Shape extends Record<string, z.ZodType>> = { [K in keyof Shape]: z.output<Shape[K]> };\n\ntype ToolKind = \"readOnly\" | \"action\";\n\nexport type Tool<Shape extends Record<string, z.ZodType> = Record<string, z.ZodType>> = {\n    name: string;\n    title: string;\n    kind: ToolKind;\n    description: string;\n    inputSchema: Shape;\n    handler: (args: ToolArgs<Shape>) => Promise<CallToolResult>;\n};\n\nconst hasStringHint = (data: unknown): data is { hint: string } =>\n    typeof data === \"object\" && data !== null && \"hint\" in data && typeof data.hint === \"string\";\n\nconst runTool = async (\n    handler: (args: ToolArgs<Record<string, z.ZodType>>) => Promise<CallToolResult>,\n    args: ToolArgs<Record<string, z.ZodType>>,\n): Promise<CallToolResult> => {\n    try {\n        return await handler(args);\n    } catch (error) {\n        if (error instanceof ProtocolError) {\n            return textError(hasStringHint(error.data) ? `${error.message}\\n${error.data.hint}` : error.message);\n        }\n        return textError(error instanceof Error ? error.message : String(error));\n    }\n};\n\nexport const defineTool = <Shape extends Record<string, z.ZodType>>(tool: Tool<Shape>): Tool => tool as Tool;\n\nexport const registerTool = (server: McpServer, tool: Tool): void => {\n    const callback = ((args: ToolArgs<Record<string, z.ZodType>>, _extra: unknown) =>\n        runTool(tool.handler, args)) as ToolCallback<Record<string, z.ZodType>>;\n    server.registerTool(\n        tool.name,\n        {\n            description: tool.description,\n            inputSchema: tool.inputSchema,\n            annotations: {\n                title: tool.title,\n                readOnlyHint: tool.kind === \"readOnly\",\n                destructiveHint: tool.kind === \"action\",\n                openWorldHint: true,\n            },\n        },\n        callback,\n    );\n};\n"]}

package/dist/transport.d.ts

@@ -0,0 +1,41 @@
+import EventEmitter from "node:events";
+import type { Socket } from "node:net";
+import type { Duplex } from "node:stream";
+import { ProtocolError } from "./protocol/errors.js";
+import { type Message, type Request } from "./protocol/schemas.js";
+export type ProtocolConnectionEvents = {
+    request: [Request];
+    invalid: [{
+        id: string;
+        error: ProtocolError;
+    }];
+};
+export declare class ConnectionClosedError extends Error {
+    constructor();
+}
+export declare class ProtocolConnection extends EventEmitter<ProtocolConnectionEvents> {
+    id: string;
+    private buffer;
+    private pending;
+    private writer;
+    constructor(writer: Duplex);
+    feed(data: Buffer | string): void;
+    write(message: Message): void;
+    static fromSocket(socket: Socket, options?: {
+        onClose?: () => void;
+        onError?: (error: Error) => void;
+    }): ProtocolConnection;
+    send<T = unknown>(method: string, params: unknown, timeout: number): Promise<T>;
+    rejectPending(error: Error): void;
+    private processLine;
+    private handleResponse;
+}
+export type AppConnectionEvents = {
+    disconnection: [ProtocolConnection];
+    request: [ProtocolConnection, Request];
+    error: [Error];
+};
+export interface AppConnections extends EventEmitter<AppConnectionEvents> {
+    send(connectionId: string, message: Message): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAA+C,aAAa,EAAuB,MAAM,sBAAsB,CAAC;AACvH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,OAAO,EAAgD,MAAM,uBAAuB,CAAC;AAEjH,MAAM,MAAM,wBAAwB,GAAG;IACnC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,EAAE,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;CACnD,CAAC;AAQF,qBAAa,qBAAsB,SAAQ,KAAK;IAC5C,cAGC;CACJ;AAED,qBAAa,kBAAmB,SAAQ,YAAY,CAAC,wBAAwB,CAAC;IAC1E,EAAE,EAAE,MAAM,CAAuB;IACjC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,MAAM,EAAE,MAAM,EAGzB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAahC;IAED,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAG5B;IAED,MAAM,CAAC,UAAU,CACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QACL,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KAC/B,GACP,kBAAkB,CAWpB;IAED,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CA0B9E;IAED,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAMhC;IAED,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,cAAc;CAgBzB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAC9B,aAAa,EAAE,CAAC,kBAAkB,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,cAAe,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IACrE,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACtD"}

package/dist/transport.js

@@ -0,0 +1,121 @@
+import EventEmitter from "node:events";
+import { ErrorCode, invalidRequestError, isErrorCode, ProtocolError, requestTimeoutError } from "./protocol/errors.js";
+import { RequestSchema, ResponseSchema } from "./protocol/schemas.js";
+export class ConnectionClosedError extends Error {
+    constructor() {
+        super("Connection stream is not writable");
+        this.name = "ConnectionClosedError";
+    }
+}
+export class ProtocolConnection extends EventEmitter {
+    id = crypto.randomUUID();
+    buffer = "";
+    pending = new Map();
+    writer;
+    constructor(writer) {
+        super();
+        this.writer = writer;
+    }
+    feed(data) {
+        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) {
+        if (!this.writer.writable)
+            return;
+        this.writer.write(`${JSON.stringify(message)}\n`);
+    }
+    static fromSocket(socket, options = {}) {
+        const connection = new ProtocolConnection(socket);
+        socket.on("data", (data) => 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(method, params, timeout) {
+        return new Promise((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,
+                reject,
+                timeout: timeoutHandle,
+            });
+            this.write({ id, method, params });
+            if (!this.writer.writable) {
+                clearTimeout(timeoutHandle);
+                this.pending.delete(id);
+                reject(new ConnectionClosedError());
+            }
+        });
+    }
+    rejectPending(error) {
+        for (const entry of this.pending.values()) {
+            clearTimeout(entry.timeout);
+            entry.reject(error);
+        }
+        this.pending.clear();
+    }
+    processLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            this.emit("invalid", { id: "unknown", error: invalidRequestError("Invalid JSON") });
+            return;
+        }
+        const message = parsed;
+        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") });
+    }
+    handleResponse(response) {
+        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);
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gtkx/mcp",
-  "version": "0.20.0",
-  "description": "MCP server for AI-powered interaction with GTKX applications",
+  "version": "1.0.0-rc.1",
+  "description": "Model Context Protocol server that gives an agent the GTKX API reference and control of a running application",
   "keywords": [
     "gtkx",
     "gtk",
@@ -19,7 +19,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/gtkx-org/gtkx.git",
+    "url": "git+https://github.com/gtkx-org/gtkx.git",
     "directory": "packages/mcp"
   },
   "license": "MPL-2.0",
@@ -27,9 +27,9 @@
   "type": "module",
   "exports": {
     "./package.json": "./package.json",
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
     }
   },
   "bin": {
@@ -41,13 +41,19 @@
     "dist",
     "src"
   ],
+  "engines": {
+    "node": ">=24"
+  },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "zod": "^4.3.6"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3",
+    "@gtkx/codegen": "1.0.0-rc.1",
+    "@gtkx/config": "1.0.0-rc.1",
+    "@gtkx/utils": "1.0.0-rc.1"
   },
   "scripts": {
-    "build": "tsc -b && cp ../../README.md .",
-    "test": "vitest run",
-    "typecheck": "tsc -b --emitDeclarationOnly"
+    "build": "tsc -b tsconfig.lib.json",
+    "typecheck": "tsc -b --emitDeclarationOnly",
+    "release": "tsx ../../scripts/release-package.ts"
   }
 }