@gtkx/mcp 1.0.0-rc.3 → 1.0.0

package/dist/server.js

@@ -5,8 +5,8 @@ import { createRequire } from "node:module";
 import { z } from "zod";
 import { AppRouter } from "./app-router.js";
 import { ConnectionRegistry } from "./connection-registry.js";
-import { DEFAULT_SOCKET_PATH, fireEventParams, queryParams, screenshotParams, treeParams, typeParams, widgetIdParams, } from "./protocol/schemas.js";
-import { buildReferenceTools, createReferenceProvider, registerReferenceResources } from "./reference.js";
+import { DEFAULT_SOCKET_PATH, DEFAULT_SUBTREE_DEPTH, fireEventParams, MAX_SUBTREE_WIDGETS, queryParams, screenshotParams, treeParams, typeParams, widgetIdParams, widgetPropsParams, } from "./protocol/schemas.js";
+import { buildReferenceTools, createReferenceProvider, registerReferenceResources, } from "./reference.js";
 import { SocketServer } from "./socket-server.js";
 import { defineTool, imageContent, registerTool, textContent } from "./tool.js";
 const require = createRequire(import.meta.url);
@@ -19,13 +19,28 @@ const WIDGET_ID_DESCRIPTION = "Widget ID obtained from `gtkx_get_widget_tree`, `
 const applicationIdShape = { applicationId: z.string().optional().describe(APPLICATION_ID_DESCRIPTION) };
 const widgetIdShape = {
     ...applicationIdShape,
-    widgetId: widgetIdParams.shape.widgetId.describe(WIDGET_ID_DESCRIPTION),
+    ...describeParams(widgetIdParams.shape, { widgetId: WIDGET_ID_DESCRIPTION }),
+};
+const widgetPropsShape = {
+    ...applicationIdShape,
+    ...describeParams(widgetPropsParams.shape, {
+        widgetId: WIDGET_ID_DESCRIPTION,
+        properties: "GObject property names to read as well, in kebab-case or camelCase (\"current-breakpoint\" or " +
+            "\"currentBreakpoint\"). Omit for the summary alone.",
+        maxDepth: `How many levels of descendants to include: ${String(DEFAULT_SUBTREE_DEPTH)} by default, and 0 ` +
+            `for the widget on its own. At most ${String(MAX_SUBTREE_WIDGETS)} widgets come back whatever ` +
+            "the depth, and any widget whose own direct children were left out carries a `hiddenChildren` count.",
+    }),
 };
 const treeShape = {
     ...applicationIdShape,
-    rootId: treeParams.shape.rootId.describe("Render only the subtree rooted at this widget ID (from a prior tree or query). Omit for the whole app."),
-    maxDepth: treeParams.shape.maxDepth.describe("Limit how many levels deep to render; deeper descendants are summarized with a count. " +
-        "Combine with rootId to drill in without dumping the whole tree."),
+    ...describeParams(treeParams.shape, {
+        rootId: "Render only the subtree rooted at this widget ID (from a prior tree or query). Omit for the " +
+            "whole app.",
+        maxDepth: "Limit how many levels deep to render, and 0 for the root widget on its own; deeper " +
+            "descendants are summarized with a count. Combine with rootId to drill in without dumping " +
+            "the whole tree.",
+    }),
 };
 const listAppsShape = {
     waitForApps: z
@@ -36,25 +51,48 @@ const listAppsShape = {
 };
 const queryWidgetsShape = {
     ...applicationIdShape,
-    by: queryParams.shape.by.describe("Query type"),
-    value: queryParams.shape.value.describe("Value to search for"),
-    options: queryParams.shape.options.describe("Additional query options"),
+    ...describeParams(queryParams.shape, {
+        by: "Query type",
+        value: "Value to search for",
+        options: "Additional query options",
+    }),
 };
 const typeShape = {
-    ...widgetIdShape,
-    text: typeParams.shape.text.describe("Text to type"),
-    clear: typeParams.shape.clear.describe("Clear existing text before typing"),
+    ...applicationIdShape,
+    ...describeParams(typeParams.shape, {
+        widgetId: WIDGET_ID_DESCRIPTION,
+        text: "Text to type",
+        clear: "Clear existing text before typing",
+    }),
 };
 const fireEventShape = {
-    ...widgetIdShape,
-    signal: fireEventParams.shape.signal.describe("GTK4 signal name to emit"),
-    args: fireEventParams.shape.args.describe("Arguments to pass to the signal"),
+    ...applicationIdShape,
+    ...describeParams(fireEventParams.shape, {
+        widgetId: WIDGET_ID_DESCRIPTION,
+        signal: "GTK4 signal name to emit",
+        args: "Arguments to pass to the signal",
+    }),
 };
 const screenshotShape = {
     ...applicationIdShape,
-    windowId: screenshotParams.shape.windowId.describe("Window ID to capture. If not specified, captures the first window."),
-    path: screenshotParams.shape.path.describe("Absolute path to write the PNG to on the app's machine. If set, the screenshot is saved there " +
-        "in addition to being returned."),
+    ...describeParams(screenshotParams.shape, {
+        windowId: "Window ID to capture. If not specified, captures the first window.",
+        path: "Absolute path to write the PNG to on the app's machine. If set, the screenshot is saved there " +
+            "in addition to being returned.",
+    }),
+};
+function describeParams(shape, descriptions) {
+    const described = Object.entries(shape).map(([key, schema]) => [
+        key,
+        schema.describe(descriptions[key]),
+    ]);
+    return Object.fromEntries(described);
+}
+const connectStdio = async (mcpServer, stop) => {
+    const transport = new StdioServerTransport();
+    process.stdin.on("end", () => void stop());
+    process.stdin.on("close", () => void stop());
+    await mcpServer.connect(transport);
 };
 const logSocketError = (event) => {
     const error = event.detail;
@@ -109,6 +147,28 @@ const screenshotTool = (appRouter) => defineTool({
         return imageContent(result.data, result.mimeType);
     },
 });
+const widgetPropsTool = (appRouter) => defineTool({
+    name: "gtkx_get_widget_props",
+    title: "Get widget properties",
+    kind: "readOnly",
+    description: "Get a fixed summary of one widget by ID: type, accessible role, name, text, sensitivity, " +
+        "visibility, CSS classes, and the same summary for its descendants. The subtree is bounded " +
+        `twice: ${String(DEFAULT_SUBTREE_DEPTH)} levels deep unless \`maxDepth\` says otherwise, and ` +
+        `${String(MAX_SUBTREE_WIDGETS)} widgets in all, filled breadth first. Wherever either bound ` +
+        "cut a branch, that widget carries `hiddenChildren`, the count of its own direct children left " +
+        "out rather than of everything below them; call again with that widget's ID to drill in, or " +
+        "use `gtkx_get_widget_tree` for a wider map. Pass `properties` to read GObject properties too; " +
+        "they come back first in the payload, each under its canonical kebab-case name as " +
+        "`{type, value}`, where an enum or flags value is its GType value name, a 64-bit integer a " +
+        "decimal string, and an object its GType name plus `widgetId` when it is a widget. Asking for " +
+        "a property the widget does not have fails; a value that cannot be marshalled carries a `note` " +
+        "instead.",
+    inputSchema: widgetPropsShape,
+    handler: async ({ applicationId, ...params }) => {
+        const result = await appRouter.sendToApp(applicationId, "widget.getProps", params);
+        return textContent(JSON.stringify(result, null, 2));
+    },
+});
 function buildInspectionTools(appRouter) {
     return [
         listAppsTool(appRouter),
@@ -132,26 +192,17 @@ function buildInspectionTools(appRouter) {
             name: "gtkx_query_widgets",
             title: "Query widgets",
             kind: "readOnly",
-            description: "Find widgets by role, text, name, or label. Returns matching widgets with their IDs and properties.",
+            description: "Find widgets by role, text, name, or label. Returns each match with its ID and the same " +
+                "fixed summary `gtkx_get_widget_props` returns, with no descendants: a match that has " +
+                "children carries `hiddenChildren`, the count of its direct children left out. Read a " +
+                "match's subtree with `gtkx_get_widget_props` or `gtkx_get_widget_tree`.",
             inputSchema: queryWidgetsShape,
             handler: async ({ applicationId, ...params }) => {
                 const result = await appRouter.sendToApp(applicationId, "widget.query", params);
                 return textContent(JSON.stringify(result, null, 2));
             },
         }),
-        defineTool({
-            name: "gtkx_get_widget_props",
-            title: "Get widget properties",
-            kind: "readOnly",
-            description: "Get a fixed summary of one widget by ID: type, accessible role, name, text, sensitivity, " +
-                "visibility, CSS classes, and the full subtree of descendant widgets. It does not return " +
-                "arbitrary GObject properties.",
-            inputSchema: widgetIdShape,
-            handler: async ({ applicationId, ...params }) => {
-                const result = await appRouter.sendToApp(applicationId, "widget.getProps", params);
-                return textContent(JSON.stringify(result, null, 2));
-            },
-        }),
+        widgetPropsTool(appRouter),
         screenshotTool(appRouter),
     ];
 }
@@ -161,7 +212,9 @@ function buildInteractionTools(appRouter) {
             name: "gtkx_click",
             title: "Click widget",
             kind: "action",
-            description: "Click a widget. Works with buttons, checkboxes, and other interactive widgets.",
+            description: "Click a widget through userEvent.click, with no special case per widget. Works with " +
+                "buttons, checkboxes, switches, list and grid rows, tree expanders, and column headers: a " +
+                "row is selected, an expander toggles its row's expansion, and a header sorts its column.",
             inputSchema: widgetIdShape,
             handler: async ({ applicationId, ...params }) => {
                 await appRouter.sendToApp(applicationId, "widget.click", params);
@@ -186,8 +239,8 @@ function buildInteractionTools(appRouter) {
             description: "Emit a GTK4 signal on a widget. Use this for custom interactions.",
             inputSchema: fireEventShape,
             handler: async ({ applicationId, ...params }) => {
-                await appRouter.sendToApp(applicationId, "widget.fireEvent", params);
-                return textContent("Fired event");
+                const result = await appRouter.sendToApp(applicationId, "widget.fireEvent", params);
+                return textContent(JSON.stringify(result, null, 2));
             },
         }),
     ];
@@ -195,6 +248,35 @@ function buildInteractionTools(appRouter) {
 function buildTools(appRouter) {
     return [...buildInspectionTools(appRouter), ...buildInteractionTools(appRouter)];
 }
+const registerTools = (mcpServer, appRouter, provider) => {
+    for (const tool of [...buildTools(appRouter), ...buildReferenceTools(provider)]) {
+        registerTool(mcpServer, tool);
+    }
+};
+async function stopServer(state) {
+    if (state.isStopped) {
+        return;
+    }
+    state.isStopped = true;
+    await state.socketServer.stop();
+    await state.mcpServer.close();
+}
+async function startServer(state) {
+    if (state.isStopped) {
+        throw new Error("createMcpServer: a stopped server cannot be started again");
+    }
+    await state.socketServer.start();
+    if (state.isStarted) {
+        return;
+    }
+    state.isStarted = true;
+    log.info(`socket server listening on ${state.socketPath}`);
+    await connectStdio(state.mcpServer, () => stopServer(state));
+}
+const createServerHandle = (socketServer, mcpServer, socketPath) => {
+    const state = { socketServer, mcpServer, socketPath, isStopped: false, isStarted: false };
+    return { start: () => startServer(state), stop: () => stopServer(state) };
+};
 const createMcpServer = (options) => {
     const socketPath = options.socketPath ?? DEFAULT_SOCKET_PATH;
     const registry = new ConnectionRegistry();
@@ -209,29 +291,10 @@ const createMcpServer = (options) => {
         log.info(`app unregistered: ${event.detail}`);
     });
     const mcpServer = new McpServer({ name: "gtkx-mcp", version: options.version });
-    const referenceProvider = createReferenceProvider(() => appRouter.getProjectRoot() ?? process.cwd());
-    for (const tool of [...buildTools(appRouter), ...buildReferenceTools(referenceProvider)]) {
-        registerTool(mcpServer, tool);
-    }
+    const referenceProvider = createReferenceProvider({ getAppRoot: () => appRouter.getProjectRoot() });
+    registerTools(mcpServer, appRouter, referenceProvider);
     registerReferenceResources(mcpServer, referenceProvider);
-    let isStopped = false;
-    const stop = async () => {
-        if (isStopped) {
-            return;
-        }
-        isStopped = true;
-        await socketServer.stop();
-        await mcpServer.close();
-    };
-    const start = async () => {
-        await socketServer.start();
-        log.info(`socket server listening on ${socketPath}`);
-        const transport = new StdioServerTransport();
-        process.stdin.on("end", () => void stop());
-        process.stdin.on("close", () => void stop());
-        await mcpServer.connect(transport);
-    };
-    return { start, stop };
+    return createServerHandle(socketServer, mcpServer, socketPath);
 };
 async function main() {
     const server = createMcpServer({ version });

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import { createLogger, installGracefulShutdown, type Logger } from \"@gtkx/utils\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { createRequire } from \"node:module\";\nimport { z } from \"zod\";\nimport type { ConnectionErrorEvent } from \"./transport.js\";\nimport { type AppRegisteredEvent, AppRouter, type AppUnregisteredEvent } from \"./app-router.js\";\nimport { ConnectionRegistry } from \"./connection-registry.js\";\nimport {\n    type AppInfo,\n    DEFAULT_SOCKET_PATH,\n    fireEventParams,\n    queryParams,\n    screenshotParams,\n    treeParams,\n    typeParams,\n    widgetIdParams,\n} from \"./protocol/schemas.js\";\nimport { buildReferenceTools, createReferenceProvider, registerReferenceResources } from \"./reference.js\";\nimport { SocketServer } from \"./socket-server.js\";\nimport { defineTool, imageContent, registerTool, textContent, type Tool } from \"./tool.js\";\n\ntype CreateMcpServerOptions = {\n    socketPath?: string;\n    version: string;\n};\n\ntype McpServerHandle = {\n    start(): Promise<void>;\n    stop(): Promise<void>;\n};\n\ntype AppWindow = { id: string; title: string | null };\ntype AppWithWindows = AppInfo & { windows?: AppWindow[] };\n\nconst require = createRequire(import.meta.url);\nconst { version } = require(\"../package.json\") as { version: string };\nconst log: Logger = createLogger(\"mcp\");\nconst APPLICATION_ID_DESCRIPTION = \"Application ID to query. If not specified, uses the first connected app.\";\n\nconst WIDGET_ID_DESCRIPTION =\n    \"Widget ID obtained from `gtkx_get_widget_tree`, `gtkx_query_widgets`, or `gtkx_get_widget_props`. \" +\n    \"IDs are scoped to a single app. An ID stays valid for as long as its widget is mounted and stops \" +\n    \"resolving once the widget is unmounted.\";\n\nconst applicationIdShape = { applicationId: z.string().optional().describe(APPLICATION_ID_DESCRIPTION) };\n\nconst widgetIdShape = {\n    ...applicationIdShape,\n    widgetId: widgetIdParams.shape.widgetId.describe(WIDGET_ID_DESCRIPTION),\n};\n\nconst treeShape = {\n    ...applicationIdShape,\n    rootId: treeParams.shape.rootId.describe(\n        \"Render only the subtree rooted at this widget ID (from a prior tree or query). Omit for the whole app.\",\n    ),\n    maxDepth: treeParams.shape.maxDepth.describe(\n        \"Limit how many levels deep to render; deeper descendants are summarized with a count. \" +\n        \"Combine with rootId to drill in without dumping the whole tree.\",\n    ),\n};\n\nconst listAppsShape = {\n    waitForApps: z\n        .boolean()\n        .optional()\n        .describe(\n            \"If true, wait for at least one app to register before returning. Useful when app is still starting.\",\n        ),\n    timeout: z.number().optional().describe(\"Timeout in milliseconds when waitForApps is true (default: 10000)\"),\n};\n\nconst queryWidgetsShape = {\n    ...applicationIdShape,\n    by: queryParams.shape.by.describe(\"Query type\"),\n    value: queryParams.shape.value.describe(\"Value to search for\"),\n    options: queryParams.shape.options.describe(\"Additional query options\"),\n};\n\nconst typeShape = {\n    ...widgetIdShape,\n    text: typeParams.shape.text.describe(\"Text to type\"),\n    clear: typeParams.shape.clear.describe(\"Clear existing text before typing\"),\n};\n\nconst fireEventShape = {\n    ...widgetIdShape,\n    signal: fireEventParams.shape.signal.describe(\"GTK4 signal name to emit\"),\n    args: fireEventParams.shape.args.describe(\"Arguments to pass to the signal\"),\n};\n\nconst screenshotShape = {\n    ...applicationIdShape,\n    windowId: screenshotParams.shape.windowId.describe(\n        \"Window ID to capture. If not specified, captures the first window.\",\n    ),\n    path: screenshotParams.shape.path.describe(\n        \"Absolute path to write the PNG to on the app's machine. If set, the screenshot is saved there \" +\n        \"in addition to being returned.\",\n    ),\n};\n\nconst logSocketError = (event: Event): void => {\n    const error = (event as ConnectionErrorEvent).detail;\n    const code = (error as NodeJS.ErrnoException).code;\n\n    if (code === \"EPIPE\" || code === \"ECONNRESET\") {\n        return;\n    }\n\n    log.error(`socket error: ${error.message}`);\n};\n\nconst appWithWindows = async (appRouter: AppRouter, app: AppInfo): Promise<AppWithWindows> => {\n    try {\n        const result = await appRouter.sendToApp<{ windows: AppWindow[] }>(\n            app.applicationId,\n            \"app.getWindows\",\n            {},\n        );\n\n        return { ...app, windows: result.windows };\n    } catch {\n        return app;\n    }\n};\n\nconst listAppsTool = (appRouter: AppRouter): Tool =>\n    defineTool({\n        name: \"gtkx_list_apps\",\n        title: \"List apps\",\n        kind: \"readOnly\",\n        description: \"List all connected GTKX applications and their open windows.\",\n        inputSchema: listAppsShape,\n        handler: async ({ waitForApps, timeout }) => {\n            if (waitForApps && !appRouter.hasConnectedApps()) {\n                await appRouter.waitForApp(timeout);\n            }\n\n            const apps = appRouter.getApps();\n            const appsWithWindows = await Promise.all(apps.map((app) => appWithWindows(appRouter, app)));\n\n            return textContent(JSON.stringify(appsWithWindows, null, 2));\n        },\n    });\n\nconst screenshotTool = (appRouter: AppRouter): Tool =>\n    defineTool({\n        name: \"gtkx_take_screenshot\",\n        title: \"Take screenshot\",\n        kind: \"readOnly\",\n        description:\n            \"Capture a screenshot of a window. Returns base64-encoded PNG image data, and optionally writes \" +\n            \"the PNG to `path` on the app's machine. You can't target widgets from a screenshot; use \" +\n            \"`gtkx_get_widget_tree` to find widget IDs for interaction.\",\n        inputSchema: screenshotShape,\n        handler: async ({ applicationId, ...params }) => {\n            const result = await appRouter.sendToApp<{ data: string; mimeType: string; savedPath?: string }>(\n                applicationId,\n                \"widget.screenshot\",\n                params,\n            );\n\n            if (result.savedPath) {\n                return {\n                    content: [\n                        { type: \"text\", text: `Screenshot saved to ${result.savedPath}` },\n                        { type: \"image\", data: result.data, mimeType: result.mimeType },\n                    ],\n                };\n            }\n\n            return imageContent(result.data, result.mimeType);\n        },\n    });\n\nfunction buildInspectionTools(appRouter: AppRouter): Tool[] {\n    return [\n        listAppsTool(appRouter),\n        defineTool({\n            name: \"gtkx_get_widget_tree\",\n            title: \"Widget tree\",\n            kind: \"readOnly\",\n            description:\n                \"Get the widget hierarchy for a connected GTKX app. Returns a tree of widgets with their IDs, \" +\n                \"types, roles, and properties. For large apps, pass `maxDepth` for a shallow overview and/or \" +\n                \"`rootId` to render just one subtree instead of the whole (possibly truncated) tree.\",\n            inputSchema: treeShape,\n            handler: async ({ applicationId, rootId, maxDepth }) => {\n                const result = await appRouter.sendToApp<{ tree: string }>(applicationId, \"widget.getTree\", {\n                    rootId,\n                    maxDepth,\n                });\n\n                return textContent(result.tree);\n            },\n        }),\n        defineTool({\n            name: \"gtkx_query_widgets\",\n            title: \"Query widgets\",\n            kind: \"readOnly\",\n            description:\n                \"Find widgets by role, text, name, or label. Returns matching widgets with their IDs and properties.\",\n            inputSchema: queryWidgetsShape,\n            handler: async ({ applicationId, ...params }) => {\n                const result = await appRouter.sendToApp(applicationId, \"widget.query\", params);\n\n                return textContent(JSON.stringify(result, null, 2));\n            },\n        }),\n        defineTool({\n            name: \"gtkx_get_widget_props\",\n            title: \"Get widget properties\",\n            kind: \"readOnly\",\n            description:\n                \"Get a fixed summary of one widget by ID: type, accessible role, name, text, sensitivity, \" +\n                \"visibility, CSS classes, and the full subtree of descendant widgets. It does not return \" +\n                \"arbitrary GObject properties.\",\n            inputSchema: widgetIdShape,\n            handler: async ({ applicationId, ...params }) => {\n                const result = await appRouter.sendToApp(applicationId, \"widget.getProps\", params);\n\n                return textContent(JSON.stringify(result, null, 2));\n            },\n        }),\n        screenshotTool(appRouter),\n    ];\n}\n\nfunction buildInteractionTools(appRouter: AppRouter): Tool[] {\n    return [\n        defineTool({\n            name: \"gtkx_click\",\n            title: \"Click widget\",\n            kind: \"action\",\n            description: \"Click a widget. Works with buttons, checkboxes, and other interactive widgets.\",\n            inputSchema: widgetIdShape,\n            handler: async ({ applicationId, ...params }) => {\n                await appRouter.sendToApp(applicationId, \"widget.click\", params);\n\n                return textContent(\"Clicked\");\n            },\n        }),\n        defineTool({\n            name: \"gtkx_type\",\n            title: \"Type text\",\n            kind: \"action\",\n            description: \"Type text into an editable widget like Entry or TextView\",\n            inputSchema: typeShape,\n            handler: async ({ applicationId, ...params }) => {\n                await appRouter.sendToApp(applicationId, \"widget.type\", params);\n\n                return textContent(\"Typed text\");\n            },\n        }),\n        defineTool({\n            name: \"gtkx_fire_event\",\n            title: \"Fire event\",\n            kind: \"action\",\n            description: \"Emit a GTK4 signal on a widget. Use this for custom interactions.\",\n            inputSchema: fireEventShape,\n            handler: async ({ applicationId, ...params }) => {\n                await appRouter.sendToApp(applicationId, \"widget.fireEvent\", params);\n\n                return textContent(\"Fired event\");\n            },\n        }),\n    ];\n}\n\nfunction buildTools(appRouter: AppRouter): Tool[] {\n    return [...buildInspectionTools(appRouter), ...buildInteractionTools(appRouter)];\n}\n\nconst createMcpServer = (options: CreateMcpServerOptions): McpServerHandle => {\n    const socketPath = options.socketPath ?? DEFAULT_SOCKET_PATH;\n    const registry = new ConnectionRegistry();\n    const socketServer = new SocketServer(registry, socketPath);\n    const appRouter = new AppRouter(registry);\n    registry.addEventListener(\"error\", logSocketError);\n\n    appRouter.addEventListener(\"appRegistered\", (event) => {\n        const appInfo = (event as AppRegisteredEvent).detail;\n        log.info(`app registered: ${appInfo.applicationId} (PID: ${String(appInfo.pid)})`);\n    });\n\n    appRouter.addEventListener(\"appUnregistered\", (event) => {\n        log.info(`app unregistered: ${(event as AppUnregisteredEvent).detail}`);\n    });\n\n    const mcpServer = new McpServer({ name: \"gtkx-mcp\", version: options.version });\n    const referenceProvider = createReferenceProvider(() => appRouter.getProjectRoot() ?? process.cwd());\n\n    for (const tool of [...buildTools(appRouter), ...buildReferenceTools(referenceProvider)]) {\n        registerTool(mcpServer, tool);\n    }\n\n    registerReferenceResources(mcpServer, referenceProvider);\n    let isStopped = false;\n\n    const stop = async (): Promise<void> => {\n        if (isStopped) {\n            return;\n        }\n\n        isStopped = true;\n        await socketServer.stop();\n        await mcpServer.close();\n    };\n\n    const start = async (): Promise<void> => {\n        await socketServer.start();\n        log.info(`socket server listening on ${socketPath}`);\n        const transport = new StdioServerTransport();\n        process.stdin.on(\"end\", () => void stop());\n        process.stdin.on(\"close\", () => void stop());\n        await mcpServer.connect(transport);\n    };\n\n    return { start, stop };\n};\n\nasync function main(): Promise<void> {\n    const server = createMcpServer({ version });\n\n    installGracefulShutdown({\n        onSignal: () => server.stop(),\n    });\n\n    await server.start();\n}\n\nexport { log, createMcpServer, main };\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import { createLogger, installGracefulShutdown, type Logger } from \"@gtkx/utils\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { createRequire } from \"node:module\";\nimport { z } from \"zod\";\nimport type { ConnectionErrorEvent } from \"./transport.js\";\nimport { type AppRegisteredEvent, AppRouter, type AppUnregisteredEvent } from \"./app-router.js\";\nimport { ConnectionRegistry } from \"./connection-registry.js\";\nimport {\n    type AppInfo,\n    DEFAULT_SOCKET_PATH,\n    DEFAULT_SUBTREE_DEPTH,\n    fireEventParams,\n    MAX_SUBTREE_WIDGETS,\n    queryParams,\n    screenshotParams,\n    treeParams,\n    typeParams,\n    widgetIdParams,\n    widgetPropsParams,\n} from \"./protocol/schemas.js\";\nimport {\n    buildReferenceTools,\n    createReferenceProvider,\n    type ReferenceProvider,\n    registerReferenceResources,\n} from \"./reference.js\";\nimport { SocketServer } from \"./socket-server.js\";\nimport { defineTool, imageContent, registerTool, textContent, type Tool } from \"./tool.js\";\n\ntype CreateMcpServerOptions = {\n    socketPath?: string;\n    version: string;\n};\n\ntype McpServerHandle = {\n    start(): Promise<void>;\n    stop(): Promise<void>;\n};\n\ntype ServerLifecycle = {\n    socketServer: SocketServer;\n    mcpServer: McpServer;\n    socketPath: string;\n    isStopped: boolean;\n    isStarted: boolean;\n};\n\ntype AppWindow = { id: string; title: string | null };\ntype AppWithWindows = AppInfo & { windows?: AppWindow[] };\n\nconst require = createRequire(import.meta.url);\nconst { version } = require(\"../package.json\") as { version: string };\nconst log: Logger = createLogger(\"mcp\");\nconst APPLICATION_ID_DESCRIPTION = \"Application ID to query. If not specified, uses the first connected app.\";\n\nconst WIDGET_ID_DESCRIPTION =\n    \"Widget ID obtained from `gtkx_get_widget_tree`, `gtkx_query_widgets`, or `gtkx_get_widget_props`. \" +\n    \"IDs are scoped to a single app. An ID stays valid for as long as its widget is mounted and stops \" +\n    \"resolving once the widget is unmounted.\";\n\nconst applicationIdShape = { applicationId: z.string().optional().describe(APPLICATION_ID_DESCRIPTION) };\n\nconst widgetIdShape = {\n    ...applicationIdShape,\n    ...describeParams(widgetIdParams.shape, { widgetId: WIDGET_ID_DESCRIPTION }),\n};\n\nconst widgetPropsShape = {\n    ...applicationIdShape,\n    ...describeParams(widgetPropsParams.shape, {\n        widgetId: WIDGET_ID_DESCRIPTION,\n        properties:\n            \"GObject property names to read as well, in kebab-case or camelCase (\\\"current-breakpoint\\\" or \" +\n            \"\\\"currentBreakpoint\\\"). Omit for the summary alone.\",\n        maxDepth:\n            `How many levels of descendants to include: ${String(DEFAULT_SUBTREE_DEPTH)} by default, and 0 ` +\n            `for the widget on its own. At most ${String(MAX_SUBTREE_WIDGETS)} widgets come back whatever ` +\n            \"the depth, and any widget whose own direct children were left out carries a `hiddenChildren` count.\",\n    }),\n};\n\nconst treeShape = {\n    ...applicationIdShape,\n    ...describeParams(treeParams.shape, {\n        rootId:\n            \"Render only the subtree rooted at this widget ID (from a prior tree or query). Omit for the \" +\n            \"whole app.\",\n        maxDepth:\n            \"Limit how many levels deep to render, and 0 for the root widget on its own; deeper \" +\n            \"descendants are summarized with a count. Combine with rootId to drill in without dumping \" +\n            \"the whole tree.\",\n    }),\n};\n\nconst listAppsShape = {\n    waitForApps: z\n        .boolean()\n        .optional()\n        .describe(\n            \"If true, wait for at least one app to register before returning. Useful when app is still starting.\",\n        ),\n    timeout: z.number().optional().describe(\"Timeout in milliseconds when waitForApps is true (default: 10000)\"),\n};\n\nconst queryWidgetsShape = {\n    ...applicationIdShape,\n    ...describeParams(queryParams.shape, {\n        by: \"Query type\",\n        value: \"Value to search for\",\n        options: \"Additional query options\",\n    }),\n};\n\nconst typeShape = {\n    ...applicationIdShape,\n    ...describeParams(typeParams.shape, {\n        widgetId: WIDGET_ID_DESCRIPTION,\n        text: \"Text to type\",\n        clear: \"Clear existing text before typing\",\n    }),\n};\n\nconst fireEventShape = {\n    ...applicationIdShape,\n    ...describeParams(fireEventParams.shape, {\n        widgetId: WIDGET_ID_DESCRIPTION,\n        signal: \"GTK4 signal name to emit\",\n        args: \"Arguments to pass to the signal\",\n    }),\n};\n\nconst screenshotShape = {\n    ...applicationIdShape,\n    ...describeParams(screenshotParams.shape, {\n        windowId: \"Window ID to capture. If not specified, captures the first window.\",\n        path:\n            \"Absolute path to write the PNG to on the app's machine. If set, the screenshot is saved there \" +\n            \"in addition to being returned.\",\n    }),\n};\n\nfunction describeParams<Shape extends Record<string, z.ZodType>>(\n    shape: Shape,\n    descriptions: { [Key in keyof Shape]: string },\n): Shape {\n    const described: [string, z.ZodType][] = Object.entries(shape).map(([key, schema]) => [\n        key,\n        schema.describe(descriptions[key as keyof Shape]),\n    ]);\n\n    return Object.fromEntries(described) as Shape;\n}\n\nconst connectStdio = async (mcpServer: McpServer, stop: () => Promise<void>): Promise<void> => {\n    const transport = new StdioServerTransport();\n    process.stdin.on(\"end\", () => void stop());\n    process.stdin.on(\"close\", () => void stop());\n    await mcpServer.connect(transport);\n};\n\nconst logSocketError = (event: Event): void => {\n    const error = (event as ConnectionErrorEvent).detail;\n    const code = (error as NodeJS.ErrnoException).code;\n\n    if (code === \"EPIPE\" || code === \"ECONNRESET\") {\n        return;\n    }\n\n    log.error(`socket error: ${error.message}`);\n};\n\nconst appWithWindows = async (appRouter: AppRouter, app: AppInfo): Promise<AppWithWindows> => {\n    try {\n        const result = await appRouter.sendToApp<{ windows: AppWindow[] }>(\n            app.applicationId,\n            \"app.getWindows\",\n            {},\n        );\n\n        return { ...app, windows: result.windows };\n    } catch {\n        return app;\n    }\n};\n\nconst listAppsTool = (appRouter: AppRouter): Tool =>\n    defineTool({\n        name: \"gtkx_list_apps\",\n        title: \"List apps\",\n        kind: \"readOnly\",\n        description: \"List all connected GTKX applications and their open windows.\",\n        inputSchema: listAppsShape,\n        handler: async ({ waitForApps, timeout }) => {\n            if (waitForApps && !appRouter.hasConnectedApps()) {\n                await appRouter.waitForApp(timeout);\n            }\n\n            const apps = appRouter.getApps();\n            const appsWithWindows = await Promise.all(apps.map((app) => appWithWindows(appRouter, app)));\n\n            return textContent(JSON.stringify(appsWithWindows, null, 2));\n        },\n    });\n\nconst screenshotTool = (appRouter: AppRouter): Tool =>\n    defineTool({\n        name: \"gtkx_take_screenshot\",\n        title: \"Take screenshot\",\n        kind: \"readOnly\",\n        description:\n            \"Capture a screenshot of a window. Returns base64-encoded PNG image data, and optionally writes \" +\n            \"the PNG to `path` on the app's machine. You can't target widgets from a screenshot; use \" +\n            \"`gtkx_get_widget_tree` to find widget IDs for interaction.\",\n        inputSchema: screenshotShape,\n        handler: async ({ applicationId, ...params }) => {\n            const result = await appRouter.sendToApp<{ data: string; mimeType: string; savedPath?: string }>(\n                applicationId,\n                \"widget.screenshot\",\n                params,\n            );\n\n            if (result.savedPath) {\n                return {\n                    content: [\n                        { type: \"text\", text: `Screenshot saved to ${result.savedPath}` },\n                        { type: \"image\", data: result.data, mimeType: result.mimeType },\n                    ],\n                };\n            }\n\n            return imageContent(result.data, result.mimeType);\n        },\n    });\n\nconst widgetPropsTool = (appRouter: AppRouter): Tool =>\n    defineTool({\n        name: \"gtkx_get_widget_props\",\n        title: \"Get widget properties\",\n        kind: \"readOnly\",\n        description:\n            \"Get a fixed summary of one widget by ID: type, accessible role, name, text, sensitivity, \" +\n            \"visibility, CSS classes, and the same summary for its descendants. The subtree is bounded \" +\n            `twice: ${String(DEFAULT_SUBTREE_DEPTH)} levels deep unless \\`maxDepth\\` says otherwise, and ` +\n            `${String(MAX_SUBTREE_WIDGETS)} widgets in all, filled breadth first. Wherever either bound ` +\n            \"cut a branch, that widget carries `hiddenChildren`, the count of its own direct children left \" +\n            \"out rather than of everything below them; call again with that widget's ID to drill in, or \" +\n            \"use `gtkx_get_widget_tree` for a wider map. Pass `properties` to read GObject properties too; \" +\n            \"they come back first in the payload, each under its canonical kebab-case name as \" +\n            \"`{type, value}`, where an enum or flags value is its GType value name, a 64-bit integer a \" +\n            \"decimal string, and an object its GType name plus `widgetId` when it is a widget. Asking for \" +\n            \"a property the widget does not have fails; a value that cannot be marshalled carries a `note` \" +\n            \"instead.\",\n        inputSchema: widgetPropsShape,\n        handler: async ({ applicationId, ...params }) => {\n            const result = await appRouter.sendToApp(applicationId, \"widget.getProps\", params);\n\n            return textContent(JSON.stringify(result, null, 2));\n        },\n    });\n\nfunction buildInspectionTools(appRouter: AppRouter): Tool[] {\n    return [\n        listAppsTool(appRouter),\n        defineTool({\n            name: \"gtkx_get_widget_tree\",\n            title: \"Widget tree\",\n            kind: \"readOnly\",\n            description:\n                \"Get the widget hierarchy for a connected GTKX app. Returns a tree of widgets with their IDs, \" +\n                \"types, roles, and properties. For large apps, pass `maxDepth` for a shallow overview and/or \" +\n                \"`rootId` to render just one subtree instead of the whole (possibly truncated) tree.\",\n            inputSchema: treeShape,\n            handler: async ({ applicationId, rootId, maxDepth }) => {\n                const result = await appRouter.sendToApp<{ tree: string }>(applicationId, \"widget.getTree\", {\n                    rootId,\n                    maxDepth,\n                });\n\n                return textContent(result.tree);\n            },\n        }),\n        defineTool({\n            name: \"gtkx_query_widgets\",\n            title: \"Query widgets\",\n            kind: \"readOnly\",\n            description:\n                \"Find widgets by role, text, name, or label. Returns each match with its ID and the same \" +\n                \"fixed summary `gtkx_get_widget_props` returns, with no descendants: a match that has \" +\n                \"children carries `hiddenChildren`, the count of its direct children left out. Read a \" +\n                \"match's subtree with `gtkx_get_widget_props` or `gtkx_get_widget_tree`.\",\n            inputSchema: queryWidgetsShape,\n            handler: async ({ applicationId, ...params }) => {\n                const result = await appRouter.sendToApp(applicationId, \"widget.query\", params);\n\n                return textContent(JSON.stringify(result, null, 2));\n            },\n        }),\n        widgetPropsTool(appRouter),\n        screenshotTool(appRouter),\n    ];\n}\n\nfunction buildInteractionTools(appRouter: AppRouter): Tool[] {\n    return [\n        defineTool({\n            name: \"gtkx_click\",\n            title: \"Click widget\",\n            kind: \"action\",\n            description:\n                \"Click a widget through userEvent.click, with no special case per widget. Works with \" +\n                \"buttons, checkboxes, switches, list and grid rows, tree expanders, and column headers: a \" +\n                \"row is selected, an expander toggles its row's expansion, and a header sorts its column.\",\n            inputSchema: widgetIdShape,\n            handler: async ({ applicationId, ...params }) => {\n                await appRouter.sendToApp(applicationId, \"widget.click\", params);\n\n                return textContent(\"Clicked\");\n            },\n        }),\n        defineTool({\n            name: \"gtkx_type\",\n            title: \"Type text\",\n            kind: \"action\",\n            description: \"Type text into an editable widget like Entry or TextView\",\n            inputSchema: typeShape,\n            handler: async ({ applicationId, ...params }) => {\n                await appRouter.sendToApp(applicationId, \"widget.type\", params);\n\n                return textContent(\"Typed text\");\n            },\n        }),\n        defineTool({\n            name: \"gtkx_fire_event\",\n            title: \"Fire event\",\n            kind: \"action\",\n            description: \"Emit a GTK4 signal on a widget. Use this for custom interactions.\",\n            inputSchema: fireEventShape,\n            handler: async ({ applicationId, ...params }) => {\n                const result = await appRouter.sendToApp(applicationId, \"widget.fireEvent\", params);\n\n                return textContent(JSON.stringify(result, null, 2));\n            },\n        }),\n    ];\n}\n\nfunction buildTools(appRouter: AppRouter): Tool[] {\n    return [...buildInspectionTools(appRouter), ...buildInteractionTools(appRouter)];\n}\n\nconst registerTools = (mcpServer: McpServer, appRouter: AppRouter, provider: ReferenceProvider): void => {\n    for (const tool of [...buildTools(appRouter), ...buildReferenceTools(provider)]) {\n        registerTool(mcpServer, tool);\n    }\n};\n\nasync function stopServer(state: ServerLifecycle): Promise<void> {\n    if (state.isStopped) {\n        return;\n    }\n\n    state.isStopped = true;\n    await state.socketServer.stop();\n    await state.mcpServer.close();\n}\n\nasync function startServer(state: ServerLifecycle): Promise<void> {\n    if (state.isStopped) {\n        throw new Error(\"createMcpServer: a stopped server cannot be started again\");\n    }\n\n    await state.socketServer.start();\n\n    if (state.isStarted) {\n        return;\n    }\n\n    state.isStarted = true;\n    log.info(`socket server listening on ${state.socketPath}`);\n    await connectStdio(state.mcpServer, () => stopServer(state));\n}\n\nconst createServerHandle = (socketServer: SocketServer, mcpServer: McpServer, socketPath: string): McpServerHandle => {\n    const state: ServerLifecycle = { socketServer, mcpServer, socketPath, isStopped: false, isStarted: false };\n\n    return { start: () => startServer(state), stop: () => stopServer(state) };\n};\n\nconst createMcpServer = (options: CreateMcpServerOptions): McpServerHandle => {\n    const socketPath = options.socketPath ?? DEFAULT_SOCKET_PATH;\n    const registry = new ConnectionRegistry();\n    const socketServer = new SocketServer(registry, socketPath);\n    const appRouter = new AppRouter(registry);\n    registry.addEventListener(\"error\", logSocketError);\n\n    appRouter.addEventListener(\"appRegistered\", (event) => {\n        const appInfo = (event as AppRegisteredEvent).detail;\n        log.info(`app registered: ${appInfo.applicationId} (PID: ${String(appInfo.pid)})`);\n    });\n\n    appRouter.addEventListener(\"appUnregistered\", (event) => {\n        log.info(`app unregistered: ${(event as AppUnregisteredEvent).detail}`);\n    });\n\n    const mcpServer = new McpServer({ name: \"gtkx-mcp\", version: options.version });\n    const referenceProvider = createReferenceProvider({ getAppRoot: () => appRouter.getProjectRoot() });\n    registerTools(mcpServer, appRouter, referenceProvider);\n    registerReferenceResources(mcpServer, referenceProvider);\n\n    return createServerHandle(socketServer, mcpServer, socketPath);\n};\n\nasync function main(): Promise<void> {\n    const server = createMcpServer({ version });\n\n    installGracefulShutdown({\n        onSignal: () => server.stop(),\n    });\n\n    await server.start();\n}\n\nexport { log, createMcpServer, main };\n"]}

package/dist/socket-server.d.ts

@@ -1,11 +1,20 @@
 import type { ConnectionRegistry } from "./connection-registry.js";
+declare const withClaimLock: <T>(socketPath: string, action: () => Promise<T> | T) => Promise<T>;
 declare class SocketServer {
     private server;
     private socketPath;
     private registry;
+    private boundInode;
+    private startup;
     constructor(registry: ConnectionRegistry, socketPath?: string);
+    private listen;
+    private listenPrivately;
+    private bind;
+    private open;
+    private settleStartup;
+    private release;
     start(): Promise<void>;
     stop(): Promise<void>;
 }
-export { SocketServer };
+export { SocketServer, withClaimLock };
 //# sourceMappingURL=socket-server.d.ts.map

package/dist/socket-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-server.d.ts","sourceRoot":"","sources":["../src/socket-server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAiCnE,cAAM,YAAY;IACd,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,QAAQ,EAAE,kBAAkB,EAAE,UAAU,GAAE,MAA4B;IAK5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB9B;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"socket-server.d.ts","sourceRoot":"","sources":["../src/socket-server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AA+EnE,QAAA,MAAM,aAAa,GAAU,CAAC,EAAE,YAAY,MAAM,EAAE,QAAQ,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAG,OAAO,CAAC,CAAC,CAY3F,CAAC;AA+JF,cAAM,YAAY;IACd,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,OAAO,CAA8B;gBAEjC,QAAQ,EAAE,kBAAkB,EAAE,UAAU,GAAE,MAA4B;IAKlF,OAAO,CAAC,MAAM;YAoBA,eAAe;YASf,IAAI;IAclB,OAAO,CAAC,IAAI;YAIE,aAAa;YASb,OAAO;IASf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAa9B;AAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}