@gtkx/mcp 0.20.0 → 1.0.0-rc.1

package/dist/index.d.ts

@@ -1,5 +0,0 @@
-export { ConnectionManager } from "./connection-manager.js";
-export { appNotFoundError, invalidRequestError, ipcTimeoutError, McpError, McpErrorCode, methodNotFoundError, noAppConnectedError, widgetNotFoundError, } from "./protocol/errors.js";
-export { type AppInfo, DEFAULT_SOCKET_PATH, getRuntimeDir, type IpcError, IpcErrorSchema, type IpcMessage, type IpcMethod, type IpcRequest, IpcRequestSchema, type IpcResponse, IpcResponseSchema, type QueryOptions, type SerializedWidget, } from "./protocol/types.js";
-export { type AppConnection, SocketServer } from "./socket-server.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACH,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,KAAK,OAAO,EACZ,mBAAmB,EACnB,aAAa,EACb,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,WAAW,EAChB,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,5 +0,0 @@
-export { ConnectionManager } from "./connection-manager.js";
-export { appNotFoundError, invalidRequestError, ipcTimeoutError, McpError, McpErrorCode, methodNotFoundError, noAppConnectedError, widgetNotFoundError, } from "./protocol/errors.js";
-export { DEFAULT_SOCKET_PATH, getRuntimeDir, IpcErrorSchema, IpcRequestSchema, IpcResponseSchema, } from "./protocol/types.js";
-export { SocketServer } from "./socket-server.js";
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACH,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEH,mBAAmB,EACnB,aAAa,EAEb,cAAc,EAId,gBAAgB,EAEhB,iBAAiB,GAGpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAsB,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/protocol/types.d.ts

@@ -1,132 +0,0 @@
-import { z } from "zod";
-/**
- * Zod schema for validating IPC requests.
- */
-export declare const IpcRequestSchema: z.ZodObject<{
-    id: z.ZodString;
-    method: z.ZodString;
-    params: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strip>;
-/**
- * An IPC request message.
- */
-export type IpcRequest = z.infer<typeof IpcRequestSchema>;
-/**
- * An IPC error object.
- */
-export type IpcError = {
-    /** Error code */
-    code: number;
-    /** Error message */
-    message: string;
-    /** Additional error data */
-    data?: unknown;
-};
-/**
- * Zod schema for validating IPC errors.
- */
-export declare const IpcErrorSchema: z.ZodObject<{
-    code: z.ZodNumber;
-    message: z.ZodString;
-    data: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strip>;
-/**
- * Zod schema for validating IPC responses.
- */
-export declare const IpcResponseSchema: z.ZodObject<{
-    id: z.ZodString;
-    result: z.ZodOptional<z.ZodUnknown>;
-    error: z.ZodOptional<z.ZodObject<{
-        code: z.ZodNumber;
-        message: z.ZodString;
-        data: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-/**
- * An IPC response message.
- */
-export type IpcResponse = z.infer<typeof IpcResponseSchema>;
-/**
- * A serialized representation of a GTK widget for IPC transfer.
- */
-export type SerializedWidget = {
-    /** Unique widget identifier */
-    id: string;
-    /** Widget type name (e.g., "GtkButton") */
-    type: string;
-    /** Accessible role */
-    role: string;
-    /** Widget name (test ID) */
-    name: string | null;
-    /** Accessible label */
-    label: string | null;
-    /** Text content */
-    text: string | null;
-    /** Whether the widget is sensitive (interactive) */
-    sensitive: boolean;
-    /** Whether the widget is visible */
-    visible: boolean;
-    /** CSS class names */
-    cssClasses: string[];
-    /** Child widgets */
-    children: SerializedWidget[];
-    /** Widget bounds in window coordinates */
-    bounds?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-};
-/**
- * Information about a connected GTKX application.
- */
-export type AppInfo = {
-    /** Application ID (e.g., "com.example.myapp") */
-    appId: string;
-    /** Process ID */
-    pid: number;
-    /** Open windows */
-    windows: Array<{
-        id: string;
-        title: string | null;
-    }>;
-};
-/**
- * Options for widget queries.
- */
-export type QueryOptions = {
-    /** Widget name to match */
-    name?: string;
-    /** Require exact match */
-    exact?: boolean;
-    /** Query timeout in milliseconds */
-    timeout?: number;
-};
-/**
- * Zod schema for app registration parameters.
- * @internal
- */
-export declare const RegisterParamsSchema: z.ZodObject<{
-    appId: z.ZodString;
-    pid: z.ZodNumber;
-}, z.core.$strip>;
-/**
- * Available IPC methods.
- */
-export type IpcMethod = "app.register" | "app.unregister" | "app.getWindows" | "widget.getTree" | "widget.query" | "widget.getProps" | "widget.click" | "widget.type" | "widget.fireEvent" | "widget.screenshot";
-/**
- * Union type for any IPC message (request or response).
- */
-export type IpcMessage = IpcRequest | IpcResponse;
-/**
- * Gets the XDG runtime directory or falls back to system temp.
- *
- * @returns Path to the runtime directory
- */
-export declare const getRuntimeDir: () => string;
-/**
- * Default path for the MCP socket file.
- */
-export declare const DEFAULT_SOCKET_PATH: string;
-//# sourceMappingURL=types.d.ts.map

package/dist/protocol/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACnB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;;iBAIzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;iBAI5B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,uBAAuB;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,mBAAmB;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,MAAM,CAAC,EAAE;QACL,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;CACL,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IAClB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,OAAO,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC,CAAC;CACN,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GACf,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,mBAAmB,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAO,MAAiD,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAyC,CAAC"}

package/dist/protocol/types.js

@@ -1,46 +0,0 @@
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { z } from "zod";
-/**
- * Zod schema for validating IPC requests.
- */
-export const IpcRequestSchema = z.object({
-    id: z.string(),
-    method: z.string(),
-    params: z.unknown().optional(),
-});
-/**
- * Zod schema for validating IPC errors.
- */
-export const IpcErrorSchema = z.object({
-    code: z.number(),
-    message: z.string(),
-    data: z.unknown().optional(),
-});
-/**
- * Zod schema for validating IPC responses.
- */
-export const IpcResponseSchema = z.object({
-    id: z.string(),
-    result: z.unknown().optional(),
-    error: IpcErrorSchema.optional(),
-});
-/**
- * Zod schema for app registration parameters.
- * @internal
- */
-export const RegisterParamsSchema = z.object({
-    appId: z.string(),
-    pid: z.number(),
-});
-/**
- * Gets the XDG runtime directory or falls back to system temp.
- *
- * @returns Path to the runtime directory
- */
-export const getRuntimeDir = () => process.env.XDG_RUNTIME_DIR ?? tmpdir();
-/**
- * Default path for the MCP socket file.
- */
-export const DEFAULT_SOCKET_PATH = join(getRuntimeDir(), "gtkx-mcp.sock");
-//# sourceMappingURL=types.js.map

package/dist/protocol/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAmBH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,cAAc,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAmEH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAsBH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,EAAE,CAAC;AAEnF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,eAAe,CAAC,CAAC"}

package/src/cli.ts

@@ -1,449 +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") as { version: string };
-
-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", "testId", "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" as const,
-            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" as const,
-            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, testId, or label. Returns matching widgets with their IDs and properties.",
-        inputSchema: {
-            type: "object" as const,
-            properties: {
-                appId: {
-                    type: "string",
-                    description: "App ID to query. If not specified, uses the first connected app.",
-                },
-                by: {
-                    type: "string",
-                    enum: ["role", "text", "testId", "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" as const,
-            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" as const,
-            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" as const,
-            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" as const,
-            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" as const,
-            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 as NodeJS.ErrnoException).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<{
-                                    windows: Array<{ id: string; title: string | null }>;
-                                }>(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<{ tree: string }>(
-                        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<{ data: string; mimeType: string }>(
-                        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);
-});