@gtkx/mcp 2.0.0-beta.1 → 2.0.0-beta.11

package/dist/server.js

@@ -1,15 +1,18 @@
 import { loadConfig } from "@gtkx/config";
-import { resolveMcpSettings } from "@gtkx/config/internal";
+import { configDependenciesFor, resolveMcpSettings } from "@gtkx/config/internal";
 import { createLogger, installGracefulShutdown } from "@gtkx/utils";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
 import { parseArgs } from "node:util";
 import { z } from "zod";
 import packageManifest from "../package.json" with { type: "json" };
 import { AppRouter } from "./app-router.js";
 import { ConnectionRegistry } from "./connection-registry.js";
-import { DEFAULT_SOCKET_PATH, DEFAULT_SUBTREE_DEPTH, fireEventParams, MAX_SUBTREE_WIDGETS, queryParams, screenshotParams, treeParams, typeParams, widgetIdParams, widgetPropsParams, } from "./protocol/schemas.js";
+import { 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 { resolveMcpSocketAddress } from "./socket-path.js";
 import { SocketServer } from "./socket-server.js";
 import { selectTools } from "./tool-filter.js";
 import { defineTool, imageContent, registerTool, textContent, textError } from "./tool.js";
@@ -18,17 +21,23 @@ const log = createLogger("mcp");
 const DEFAULT_SETTINGS = { tools: [], isReadOnly: false };
 const INSTRUCTIONS = "The widget tools drive a GTKX app running under `gtkx dev`: they read " +
     "its live widget tree, query it by accessible role and name, click and type, and capture screenshots. " +
-    "They fail until an app is running, so start `gtkx dev` first. The reference tools answer from the " +
+    "They wait briefly for a starting app, so start `gtkx dev` before or alongside a widget request. " +
+    "The reference tools answer from the " +
     "bindings generated for a specific project, so they describe that project's GIR libraries rather than " +
-    "GTK in general; prefer them over recalled GTK knowledge, which is usually C, PyGObject or GJS and " +
-    "does not apply here.\n\n" +
+    "the GNOME platform in general; prefer them over recalled Adwaita or GTK knowledge, which is usually C, " +
+    "PyGObject or GJS and does not apply here.\n\n" +
     "Widget IDs are valid only while the widget is mounted. After a dialog closes, a list re-renders, or " +
     "fast refresh patches a component, re-read the tree or re-run the query instead of reusing an ID.";
-const APPLICATION_ID_DESCRIPTION = "Application ID to query. If not specified, uses the first connected app.";
+const APPLICATION_ID_DESCRIPTION = "Application ID to query. If not specified, uses the first connected app. The tool waits briefly for the " +
+    "requested app to register.";
+const APP_TIMEOUT_DESCRIPTION = "Milliseconds to wait for the requested app to register (default: 10000).";
 const WIDGET_ID_DESCRIPTION = "Widget ID obtained from `gtkx_get_widget_tree`, `gtkx_query_widgets`, or `gtkx_get_widget_props`. " +
     "IDs are scoped to a single app. An ID stays valid for as long as its widget is mounted and stops " +
     "resolving once the widget is unmounted.";
-const applicationIdShape = { applicationId: z.string().optional().describe(APPLICATION_ID_DESCRIPTION) };
+const applicationIdShape = {
+    applicationId: z.string().optional().describe(APPLICATION_ID_DESCRIPTION),
+    appTimeout: z.number().int().nonnegative().optional().describe(APP_TIMEOUT_DESCRIPTION),
+};
 const widgetIdShape = {
     ...applicationIdShape,
     ...describeParams(widgetIdParams.shape, { widgetId: WIDGET_ID_DESCRIPTION }),
@@ -81,7 +90,7 @@ const fireEventShape = {
     ...applicationIdShape,
     ...describeParams(fireEventParams.shape, {
         widgetId: WIDGET_ID_DESCRIPTION,
-        signal: "GTK4 signal name to emit",
+        signal: "GObject signal name to emit",
         args: "Arguments to pass to the signal",
     }),
 };
@@ -95,9 +104,8 @@ const screenshotShape = {
     returnImage: z
         .boolean()
         .optional()
-        .describe("Whether to return the PNG as image content, true by default. Pass false together with `path` " +
-        "to save the screenshot and get back only where it landed, which keeps the image out of the " +
-        "conversation until something actually needs to look at it."),
+        .describe("Return the PNG as image content (default: true). Set false with `path` to save the image " +
+        "and return only its file location."),
 };
 function describeParams(shape, descriptions) {
     const described = Object.entries(shape).map(([key, schema]) => [
@@ -133,11 +141,12 @@ const listAppsTool = (appRouter) => defineTool({
     name: "gtkx_list_apps",
     title: "List apps",
     kind: "readOnly",
-    description: "List all connected GTKX applications and their open windows.",
+    description: "List connected GTKX applications and their open windows. " +
+        "Returns the current snapshot immediately unless waitForApps is true.",
     inputSchema: listAppsShape,
     handler: async ({ waitForApps, timeout }) => {
         if (waitForApps && !appRouter.hasConnectedApps()) {
-            await appRouter.waitForApp(timeout);
+            await appRouter.waitForApp(undefined, timeout);
         }
         const apps = appRouter.getApps();
         const appsWithWindows = await Promise.all(apps.map((app) => appWithWindows(appRouter, app)));
@@ -165,8 +174,8 @@ const screenshotTool = (appRouter) => defineTool({
         "the PNG to `path` on the app's machine. You can't target widgets from a screenshot; use " +
         "`gtkx_get_widget_tree` to find widget IDs for interaction.",
     inputSchema: screenshotShape,
-    handler: async ({ applicationId, returnImage, ...params }) => {
-        const result = await appRouter.sendToApp(applicationId, "widget.screenshot", params);
+    handler: async ({ applicationId, appTimeout, returnImage, ...params }) => {
+        const result = await appRouter.sendToApp(applicationId, "widget.screenshot", params, appTimeout);
         return screenshotResult(result, returnImage !== false);
     },
 });
@@ -174,21 +183,17 @@ 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.",
+    description: "Read a widget's type, accessible role, name, text, sensitivity, visibility, CSS classes, " +
+        `and descendants. Defaults to ${String(DEFAULT_SUBTREE_DEPTH)} levels; \`maxDepth\` changes ` +
+        `the depth. Results contain at most ${String(MAX_SUBTREE_WIDGETS)} widgets, in breadth-first ` +
+        "order. `hiddenChildren` counts omitted direct children; query that widget's ID to expand it. " +
+        "Use `gtkx_get_widget_tree` for an overview. Requested GObject `properties` appear first, " +
+        "keyed by canonical kebab-case name with `{type, value}`. Enum/flags values use GType value " +
+        "names, 64-bit integers use decimal strings, and objects use their GType name plus `widgetId` " +
+        "for widgets. Unknown properties fail; values that cannot be converted include a `note`.",
     inputSchema: widgetPropsShape,
-    handler: async ({ applicationId, ...params }) => {
-        const result = await appRouter.sendToApp(applicationId, "widget.getProps", params);
+    handler: async ({ applicationId, appTimeout, ...params }) => {
+        const result = await appRouter.sendToApp(applicationId, "widget.getProps", params, appTimeout);
         return textContent(JSON.stringify(result, null, 2));
     },
 });
@@ -203,11 +208,11 @@ function buildInspectionTools(appRouter) {
                 "types, roles, and properties. For large apps, pass `maxDepth` for a shallow overview and/or " +
                 "`rootId` to render just one subtree instead of the whole (possibly truncated) tree.",
             inputSchema: treeShape,
-            handler: async ({ applicationId, rootId, maxDepth }) => {
+            handler: async ({ applicationId, appTimeout, rootId, maxDepth }) => {
                 const result = await appRouter.sendToApp(applicationId, "widget.getTree", {
                     rootId,
                     maxDepth,
-                });
+                }, appTimeout);
                 return textContent(result.tree);
             },
         }),
@@ -220,8 +225,8 @@ function buildInspectionTools(appRouter) {
                 "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);
+            handler: async ({ applicationId, appTimeout, ...params }) => {
+                const result = await appRouter.sendToApp(applicationId, "widget.query", params, appTimeout);
                 return textContent(JSON.stringify(result, null, 2));
             },
         }),
@@ -235,12 +240,12 @@ function buildInteractionTools(appRouter) {
             name: "gtkx_click",
             title: "Click widget",
             kind: "action",
-            description: "Click a widget through userEvent.click, with no special case per widget. Works with " +
+            description: "Click a widget through userEvent.click. 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);
+            handler: async ({ applicationId, appTimeout, ...params }) => {
+                await appRouter.sendToApp(applicationId, "widget.click", params, appTimeout);
                 return textContent("Clicked");
             },
         }),
@@ -250,8 +255,8 @@ function buildInteractionTools(appRouter) {
             kind: "action",
             description: "Type text into an editable widget like Entry or TextView",
             inputSchema: typeShape,
-            handler: async ({ applicationId, ...params }) => {
-                await appRouter.sendToApp(applicationId, "widget.type", params);
+            handler: async ({ applicationId, appTimeout, ...params }) => {
+                await appRouter.sendToApp(applicationId, "widget.type", params, appTimeout);
                 return textContent("Typed text");
             },
         }),
@@ -259,10 +264,10 @@ function buildInteractionTools(appRouter) {
             name: "gtkx_fire_event",
             title: "Fire event",
             kind: "action",
-            description: "Emit a GTK4 signal on a widget. Use this for custom interactions.",
+            description: "Emit a GObject signal on a widget. Use this for custom interactions.",
             inputSchema: fireEventShape,
-            handler: async ({ applicationId, ...params }) => {
-                const result = await appRouter.sendToApp(applicationId, "widget.fireEvent", params);
+            handler: async ({ applicationId, appTimeout, ...params }) => {
+                const result = await appRouter.sendToApp(applicationId, "widget.fireEvent", params, appTimeout);
                 return textContent(JSON.stringify(result, null, 2));
             },
         }),
@@ -280,34 +285,74 @@ const registerTools = (mcpServer, appRouter, provider, settings) => {
         registerTool(mcpServer, tool);
     }
 };
-async function stopServer(state) {
-    if (state.isStopped) {
-        return;
+const stoppedServerError = () => new Error("createMcpServer: a stopped server cannot be started again");
+const wasStopRequested = (state) => state.isStopRequested;
+function stopServer(state) {
+    if (state.shutdown !== null) {
+        return state.shutdown;
     }
-    state.isStopped = true;
-    await state.socketServer.stop();
-    await state.mcpServer.close();
+    state.isStopRequested = true;
+    state.appRouter.dispose();
+    const startup = state.startup;
+    const shutdown = (async () => {
+        if (startup !== null) {
+            await Promise.allSettled([startup]);
+        }
+        await state.socketServer.stop();
+        await state.mcpServer.close();
+    })();
+    state.shutdown = shutdown;
+    return shutdown;
 }
-async function startServer(state) {
-    if (state.isStopped) {
-        throw new Error("createMcpServer: a stopped server cannot be started again");
+function startServer(state) {
+    if (wasStopRequested(state)) {
+        return Promise.reject(stoppedServerError());
     }
-    await state.socketServer.start();
-    if (state.isStarted) {
-        return;
+    if (state.startup !== null) {
+        return state.startup;
     }
-    state.isStarted = true;
-    log.info(`socket server listening on ${state.socketPath}`);
-    await connectStdio(state.mcpServer, () => stopServer(state));
+    const startup = (async () => {
+        try {
+            await state.socketServer.start();
+            if (wasStopRequested(state)) {
+                return;
+            }
+            log.info(`socket server listening on ${state.socketPath}`);
+            await connectStdio(state.mcpServer, () => stopServer(state));
+        }
+        catch (error) {
+            if (!wasStopRequested(state)) {
+                state.isStopRequested = true;
+                state.appRouter.dispose();
+                await state.socketServer.stop();
+                await state.mcpServer.close();
+            }
+            throw error;
+        }
+    })();
+    state.startup = startup;
+    return startup;
 }
-const createServerHandle = (socketServer, mcpServer, socketPath) => {
-    const state = { socketServer, mcpServer, socketPath, isStopped: false, isStarted: false };
+const createServerHandle = (socketServer, mcpServer, appRouter, socketPath) => {
+    const state = {
+        socketServer,
+        mcpServer,
+        appRouter,
+        socketPath,
+        isStopRequested: false,
+        startup: null,
+        shutdown: null,
+    };
     return { start: () => startServer(state), stop: () => stopServer(state) };
 };
 const createMcpServer = (options) => {
-    const socketPath = options.socketPath ?? DEFAULT_SOCKET_PATH;
+    const socketAddress = resolveMcpSocketAddress(options.socketPath);
+    const socketPath = socketAddress.path;
+    if (socketAddress.fallbackDirectory !== null) {
+        log.warn(`MCP socket path exceeds the safe Unix byte budget; using private fallback ${socketPath}`);
+    }
     const registry = new ConnectionRegistry();
-    const socketServer = new SocketServer(registry, socketPath);
+    const socketServer = new SocketServer(registry, socketAddress);
     const appRouter = new AppRouter(registry);
     registry.addEventListener("error", logSocketError);
     appRouter.addEventListener("appRegistered", (event) => {
@@ -321,14 +366,17 @@ const createMcpServer = (options) => {
     const referenceProvider = createReferenceProvider({ getAppRoot: () => appRouter.getProjectRoot() });
     registerTools(mcpServer, appRouter, referenceProvider, options.settings ?? DEFAULT_SETTINGS);
     registerReferenceResources(mcpServer, referenceProvider);
-    return createServerHandle(socketServer, mcpServer, socketPath);
+    return createServerHandle(socketServer, mcpServer, appRouter, socketPath);
 };
 const configuredSettings = async (cwd) => {
     try {
         const { config } = await loadConfig(cwd);
         return resolveMcpSettings(config);
     }
-    catch {
+    catch (error) {
+        if (configDependenciesFor(error).some((path) => existsSync(resolve(cwd, path)))) {
+            throw error;
+        }
         return DEFAULT_SETTINGS;
     }
 };

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 type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { loadConfig } from \"@gtkx/config\";\nimport { type McpSettings, resolveMcpSettings } from \"@gtkx/config/internal\";\nimport { createLogger, installGracefulShutdown, type Logger } from \"@gtkx/utils\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { parseArgs } from \"node:util\";\nimport { z } from \"zod\";\nimport type { ConnectionErrorEvent } from \"./transport.js\";\nimport packageManifest from \"../package.json\" with { type: \"json\" };\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 { selectTools } from \"./tool-filter.js\";\nimport { defineTool, imageContent, registerTool, textContent, textError, type Tool } from \"./tool.js\";\n\ntype CreateMcpServerOptions = {\n    socketPath?: string;\n    version: string;\n    settings?: McpSettings;\n};\n\ntype ServerOptions = {\n    cwd?: string;\n    tools?: string[];\n    isReadOnly?: boolean;\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 { version } = packageManifest;\nconst log: Logger = createLogger(\"mcp\");\nconst DEFAULT_SETTINGS: McpSettings = { tools: [], isReadOnly: false };\n\nconst INSTRUCTIONS =\n    \"The widget tools drive a GTKX app running under `gtkx dev`: they read \" +\n    \"its live widget tree, query it by accessible role and name, click and type, and capture screenshots. \" +\n    \"They fail until an app is running, so start `gtkx dev` first. The reference tools answer from the \" +\n    \"bindings generated for a specific project, so they describe that project's GIR libraries rather than \" +\n    \"GTK in general; prefer them over recalled GTK knowledge, which is usually C, PyGObject or GJS and \" +\n    \"does not apply here.\\n\\n\" +\n    \"Widget IDs are valid only while the widget is mounted. After a dialog closes, a list re-renders, or \" +\n    \"fast refresh patches a component, re-read the tree or re-run the query instead of reusing an ID.\";\n\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    returnImage: z\n        .boolean()\n        .optional()\n        .describe(\n            \"Whether to return the PNG as image content, true by default. Pass false together with `path` \" +\n            \"to save the screenshot and get back only where it landed, which keeps the image out of the \" +\n            \"conversation until something actually needs to look at it.\",\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 screenshotResult = (\n    result: { data: string; mimeType: string; savedPath?: string },\n    shouldReturnImage: boolean,\n): CallToolResult => {\n    if (result.savedPath === undefined) {\n        return shouldReturnImage\n            ? imageContent(result.data, result.mimeType)\n            : textError(\n                    \"Nothing to return: `returnImage` was false and no `path` was given, so the screenshot was \" +\n                    \"neither saved nor returned. Pass `path` to save it, or leave `returnImage` unset.\",\n                );\n    }\n\n    const saved = { type: \"text\", text: `Screenshot saved to ${result.savedPath}` } as const;\n\n    if (!shouldReturnImage) {\n        return { content: [saved] };\n    }\n\n    return { content: [saved, { type: \"image\", data: result.data, mimeType: result.mimeType }] };\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, returnImage, ...params }) => {\n            const result = await appRouter.sendToApp<{ data: string; mimeType: string; savedPath?: string }>(\n                applicationId,\n                \"widget.screenshot\",\n                params,\n            );\n\n            return screenshotResult(result, returnImage !== false);\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 = (\n    mcpServer: McpServer,\n    appRouter: AppRouter,\n    provider: ReferenceProvider,\n    settings: McpSettings,\n): void => {\n    const tools = selectTools([...buildTools(appRouter), ...buildReferenceTools(provider)], settings);\n\n    if (tools.length === 0) {\n        log.warn(\"no tools matched the configured filter; the server is registering none\");\n    }\n\n    for (const tool of tools) {\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 }, { instructions: INSTRUCTIONS });\n    const referenceProvider = createReferenceProvider({ getAppRoot: () => appRouter.getProjectRoot() });\n    registerTools(mcpServer, appRouter, referenceProvider, options.settings ?? DEFAULT_SETTINGS);\n    registerReferenceResources(mcpServer, referenceProvider);\n\n    return createServerHandle(socketServer, mcpServer, socketPath);\n};\n\nconst configuredSettings = async (cwd: string): Promise<McpSettings> => {\n    try {\n        const { config } = await loadConfig(cwd);\n\n        return resolveMcpSettings(config);\n    } catch {\n        return DEFAULT_SETTINGS;\n    }\n};\n\nconst resolveSettings = async (options: ServerOptions): Promise<McpSettings> => {\n    const configured = await configuredSettings(options.cwd ?? process.cwd());\n\n    return {\n        tools: options.tools ?? configured.tools,\n        isReadOnly: options.isReadOnly ?? configured.isReadOnly,\n    };\n};\n\nconst splitPatterns = (values: string[]): string[] =>\n    values.flatMap((value) => value.split(\",\")).map((value) => value.trim()).filter((value) => value.length > 0);\n\nconst parseServerArgs = (argv: string[]): ServerOptions => {\n    const { values } = parseArgs({\n        args: argv,\n        options: {\n            tools: { type: \"string\", multiple: true },\n            \"read-only\": { type: \"boolean\" },\n        },\n        allowPositionals: false,\n    });\n\n    const tools = values.tools === undefined ? undefined : splitPatterns(values.tools);\n\n    return {\n        ...(tools !== undefined && { tools }),\n        ...(values[\"read-only\"] !== undefined && { isReadOnly: values[\"read-only\"] }),\n    };\n};\n\nasync function main(options: ServerOptions = {}): Promise<void> {\n    const settings = await resolveSettings(options);\n    const server = createMcpServer({ version, settings });\n\n    installGracefulShutdown({\n        onSignal: () => server.stop(),\n    });\n\n    await server.start();\n}\n\nexport { log, main, main as runMcpServer, parseServerArgs };\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { loadConfig } from \"@gtkx/config\";\nimport { configDependenciesFor, type McpSettings, resolveMcpSettings } from \"@gtkx/config/internal\";\nimport { createLogger, installGracefulShutdown, type Logger } from \"@gtkx/utils\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { parseArgs } from \"node:util\";\nimport { z } from \"zod\";\nimport type { ConnectionErrorEvent } from \"./transport.js\";\nimport packageManifest from \"../package.json\" with { type: \"json\" };\nimport { type AppRegisteredEvent, AppRouter, type AppUnregisteredEvent } from \"./app-router.js\";\nimport { ConnectionRegistry } from \"./connection-registry.js\";\nimport {\n    type AppInfo,\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 { resolveMcpSocketAddress } from \"./socket-path.js\";\nimport { SocketServer } from \"./socket-server.js\";\nimport { selectTools } from \"./tool-filter.js\";\nimport { defineTool, imageContent, registerTool, textContent, textError, type Tool } from \"./tool.js\";\n\ntype CreateMcpServerOptions = {\n    socketPath?: string;\n    version: string;\n    settings?: McpSettings;\n};\n\ntype ServerOptions = {\n    cwd?: string;\n    tools?: string[];\n    isReadOnly?: boolean;\n};\n\ntype McpServerHandle = {\n    start(): Promise<void>;\n    stop(): Promise<void>;\n};\n\ntype ServerLifecycle = {\n    socketServer: SocketServer;\n    mcpServer: McpServer;\n    appRouter: AppRouter;\n    socketPath: string;\n    isStopRequested: boolean;\n    startup: Promise<void> | null;\n    shutdown: Promise<void> | null;\n};\n\ntype AppWindow = { id: string; title: string | null };\ntype AppWithWindows = AppInfo & { windows?: AppWindow[] };\n\nconst { version } = packageManifest;\nconst log: Logger = createLogger(\"mcp\");\nconst DEFAULT_SETTINGS: McpSettings = { tools: [], isReadOnly: false };\n\nconst INSTRUCTIONS =\n    \"The widget tools drive a GTKX app running under `gtkx dev`: they read \" +\n    \"its live widget tree, query it by accessible role and name, click and type, and capture screenshots. \" +\n    \"They wait briefly for a starting app, so start `gtkx dev` before or alongside a widget request. \" +\n    \"The reference tools answer from the \" +\n    \"bindings generated for a specific project, so they describe that project's GIR libraries rather than \" +\n    \"the GNOME platform in general; prefer them over recalled Adwaita or GTK knowledge, which is usually C, \" +\n    \"PyGObject or GJS and does not apply here.\\n\\n\" +\n    \"Widget IDs are valid only while the widget is mounted. After a dialog closes, a list re-renders, or \" +\n    \"fast refresh patches a component, re-read the tree or re-run the query instead of reusing an ID.\";\n\nconst APPLICATION_ID_DESCRIPTION =\n    \"Application ID to query. If not specified, uses the first connected app. The tool waits briefly for the \" +\n    \"requested app to register.\";\n\nconst APP_TIMEOUT_DESCRIPTION = \"Milliseconds to wait for the requested app to register (default: 10000).\";\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 = {\n    applicationId: z.string().optional().describe(APPLICATION_ID_DESCRIPTION),\n    appTimeout: z.number().int().nonnegative().optional().describe(APP_TIMEOUT_DESCRIPTION),\n};\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: \"GObject 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    returnImage: z\n        .boolean()\n        .optional()\n        .describe(\n            \"Return the PNG as image content (default: true). Set false with `path` to save the image \" +\n            \"and return only its file location.\",\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:\n            \"List connected GTKX applications and their open windows. \" +\n            \"Returns the current snapshot immediately unless waitForApps is true.\",\n        inputSchema: listAppsShape,\n        handler: async ({ waitForApps, timeout }) => {\n            if (waitForApps && !appRouter.hasConnectedApps()) {\n                await appRouter.waitForApp(undefined, 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 screenshotResult = (\n    result: { data: string; mimeType: string; savedPath?: string },\n    shouldReturnImage: boolean,\n): CallToolResult => {\n    if (result.savedPath === undefined) {\n        return shouldReturnImage\n            ? imageContent(result.data, result.mimeType)\n            : textError(\n                    \"Nothing to return: `returnImage` was false and no `path` was given, so the screenshot was \" +\n                    \"neither saved nor returned. Pass `path` to save it, or leave `returnImage` unset.\",\n                );\n    }\n\n    const saved = { type: \"text\", text: `Screenshot saved to ${result.savedPath}` } as const;\n\n    if (!shouldReturnImage) {\n        return { content: [saved] };\n    }\n\n    return { content: [saved, { type: \"image\", data: result.data, mimeType: result.mimeType }] };\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, appTimeout, returnImage, ...params }) => {\n            const result = await appRouter.sendToApp<{ data: string; mimeType: string; savedPath?: string }>(\n                applicationId,\n                \"widget.screenshot\",\n                params,\n                appTimeout,\n            );\n\n            return screenshotResult(result, returnImage !== false);\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            \"Read a widget's type, accessible role, name, text, sensitivity, visibility, CSS classes, \" +\n            `and descendants. Defaults to ${String(DEFAULT_SUBTREE_DEPTH)} levels; \\`maxDepth\\` changes ` +\n            `the depth. Results contain at most ${String(MAX_SUBTREE_WIDGETS)} widgets, in breadth-first ` +\n            \"order. `hiddenChildren` counts omitted direct children; query that widget's ID to expand it. \" +\n            \"Use `gtkx_get_widget_tree` for an overview. Requested GObject `properties` appear first, \" +\n            \"keyed by canonical kebab-case name with `{type, value}`. Enum/flags values use GType value \" +\n            \"names, 64-bit integers use decimal strings, and objects use their GType name plus `widgetId` \" +\n            \"for widgets. Unknown properties fail; values that cannot be converted include a `note`.\",\n        inputSchema: widgetPropsShape,\n        handler: async ({ applicationId, appTimeout, ...params }) => {\n            const result = await appRouter.sendToApp(applicationId, \"widget.getProps\", params, appTimeout);\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, appTimeout, rootId, maxDepth }) => {\n                const result = await appRouter.sendToApp<{ tree: string }>(applicationId, \"widget.getTree\", {\n                    rootId,\n                    maxDepth,\n                }, appTimeout);\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, appTimeout, ...params }) => {\n                const result = await appRouter.sendToApp(applicationId, \"widget.query\", params, appTimeout);\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. 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, appTimeout, ...params }) => {\n                await appRouter.sendToApp(applicationId, \"widget.click\", params, appTimeout);\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, appTimeout, ...params }) => {\n                await appRouter.sendToApp(applicationId, \"widget.type\", params, appTimeout);\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 GObject signal on a widget. Use this for custom interactions.\",\n            inputSchema: fireEventShape,\n            handler: async ({ applicationId, appTimeout, ...params }) => {\n                const result = await appRouter.sendToApp(applicationId, \"widget.fireEvent\", params, appTimeout);\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 = (\n    mcpServer: McpServer,\n    appRouter: AppRouter,\n    provider: ReferenceProvider,\n    settings: McpSettings,\n): void => {\n    const tools = selectTools([...buildTools(appRouter), ...buildReferenceTools(provider)], settings);\n\n    if (tools.length === 0) {\n        log.warn(\"no tools matched the configured filter; the server is registering none\");\n    }\n\n    for (const tool of tools) {\n        registerTool(mcpServer, tool);\n    }\n};\n\nconst stoppedServerError = (): Error => new Error(\"createMcpServer: a stopped server cannot be started again\");\n\nconst wasStopRequested = (state: ServerLifecycle): boolean => state.isStopRequested;\n\nfunction stopServer(state: ServerLifecycle): Promise<void> {\n    if (state.shutdown !== null) {\n        return state.shutdown;\n    }\n\n    state.isStopRequested = true;\n    state.appRouter.dispose();\n    const startup = state.startup;\n    const shutdown = (async (): Promise<void> => {\n        if (startup !== null) {\n            await Promise.allSettled([startup]);\n        }\n\n        await state.socketServer.stop();\n        await state.mcpServer.close();\n    })();\n\n    state.shutdown = shutdown;\n\n    return shutdown;\n}\n\nfunction startServer(state: ServerLifecycle): Promise<void> {\n    if (wasStopRequested(state)) {\n        return Promise.reject(stoppedServerError());\n    }\n\n    if (state.startup !== null) {\n        return state.startup;\n    }\n\n    const startup = (async (): Promise<void> => {\n        try {\n            await state.socketServer.start();\n\n            if (wasStopRequested(state)) {\n                return;\n            }\n\n            log.info(`socket server listening on ${state.socketPath}`);\n            await connectStdio(state.mcpServer, () => stopServer(state));\n        } catch (error) {\n            if (!wasStopRequested(state)) {\n                state.isStopRequested = true;\n                state.appRouter.dispose();\n                await state.socketServer.stop();\n                await state.mcpServer.close();\n            }\n\n            throw error;\n        }\n    })();\n\n    state.startup = startup;\n\n    return startup;\n}\n\nconst createServerHandle = (\n    socketServer: SocketServer,\n    mcpServer: McpServer,\n    appRouter: AppRouter,\n    socketPath: string,\n): McpServerHandle => {\n    const state: ServerLifecycle = {\n        socketServer,\n        mcpServer,\n        appRouter,\n        socketPath,\n        isStopRequested: false,\n        startup: null,\n        shutdown: null,\n    };\n\n    return { start: () => startServer(state), stop: () => stopServer(state) };\n};\n\nconst createMcpServer = (options: CreateMcpServerOptions): McpServerHandle => {\n    const socketAddress = resolveMcpSocketAddress(options.socketPath);\n    const socketPath = socketAddress.path;\n\n    if (socketAddress.fallbackDirectory !== null) {\n        log.warn(`MCP socket path exceeds the safe Unix byte budget; using private fallback ${socketPath}`);\n    }\n\n    const registry = new ConnectionRegistry();\n    const socketServer = new SocketServer(registry, socketAddress);\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 }, { instructions: INSTRUCTIONS });\n    const referenceProvider = createReferenceProvider({ getAppRoot: () => appRouter.getProjectRoot() });\n    registerTools(mcpServer, appRouter, referenceProvider, options.settings ?? DEFAULT_SETTINGS);\n    registerReferenceResources(mcpServer, referenceProvider);\n\n    return createServerHandle(socketServer, mcpServer, appRouter, socketPath);\n};\n\nconst configuredSettings = async (cwd: string): Promise<McpSettings> => {\n    try {\n        const { config } = await loadConfig(cwd);\n\n        return resolveMcpSettings(config);\n    } catch (error) {\n        if (configDependenciesFor(error).some((path) => existsSync(resolve(cwd, path)))) {\n            throw error;\n        }\n\n        return DEFAULT_SETTINGS;\n    }\n};\n\nconst resolveSettings = async (options: ServerOptions): Promise<McpSettings> => {\n    const configured = await configuredSettings(options.cwd ?? process.cwd());\n\n    return {\n        tools: options.tools ?? configured.tools,\n        isReadOnly: options.isReadOnly ?? configured.isReadOnly,\n    };\n};\n\nconst splitPatterns = (values: string[]): string[] =>\n    values.flatMap((value) => value.split(\",\")).map((value) => value.trim()).filter((value) => value.length > 0);\n\nconst parseServerArgs = (argv: string[]): ServerOptions => {\n    const { values } = parseArgs({\n        args: argv,\n        options: {\n            tools: { type: \"string\", multiple: true },\n            \"read-only\": { type: \"boolean\" },\n        },\n        allowPositionals: false,\n    });\n\n    const tools = values.tools === undefined ? undefined : splitPatterns(values.tools);\n\n    return {\n        ...(tools !== undefined && { tools }),\n        ...(values[\"read-only\"] !== undefined && { isReadOnly: values[\"read-only\"] }),\n    };\n};\n\nasync function main(options: ServerOptions = {}): Promise<void> {\n    const settings = await resolveSettings(options);\n    const server = createMcpServer({ version, settings });\n\n    installGracefulShutdown({\n        onSignal: () => server.stop(),\n    });\n\n    await server.start();\n}\n\nexport { log, main, main as runMcpServer, parseServerArgs };\n"]}

package/dist/socket-path.d.ts

@@ -0,0 +1,11 @@
+type McpSocketAddress = {
+    path: string;
+    fallbackDirectory: string | null;
+};
+declare const MCP_SOCKET_PATH_ENV = "GTKX_MCP_SOCKET_PATH";
+declare const resolveMcpSocketAddress: (providedPath?: string) => McpSocketAddress;
+declare const resolveMcpSocketPath: (providedPath?: string) => string;
+declare const prepareMcpSocketAddress: (address: McpSocketAddress) => void;
+declare const cleanupMcpSocketAddress: (address: McpSocketAddress) => void;
+export { cleanupMcpSocketAddress, MCP_SOCKET_PATH_ENV, prepareMcpSocketAddress, resolveMcpSocketAddress, resolveMcpSocketPath, type McpSocketAddress, };
+//# sourceMappingURL=socket-path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"socket-path.d.ts","sourceRoot":"","sources":["../src/socket-path.ts"],"names":[],"mappings":"AAKA,KAAK,gBAAgB,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AAEF,QAAA,MAAM,mBAAmB,yBAAyB,CAAC;AAsDnD,QAAA,MAAM,uBAAuB,GAAI,eAAe,MAAM,KAAG,gBAMxD,CAAC;AAEF,QAAA,MAAM,oBAAoB,GAAI,eAAe,MAAM,KAAG,MAAoD,CAAC;AAE3G,QAAA,MAAM,uBAAuB,GAAI,SAAS,gBAAgB,KAAG,IAI5D,CAAC;AAEF,QAAA,MAAM,uBAAuB,GAAI,SAAS,gBAAgB,KAAG,IAa5D,CAAC;AAEF,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,KAAK,gBAAgB,GACxB,CAAC"}

package/dist/socket-path.js

@@ -0,0 +1,74 @@
+import { createHash } from "node:crypto";
+import { lstatSync, mkdirSync, rmdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const MCP_SOCKET_PATH_ENV = "GTKX_MCP_SOCKET_PATH";
+const SOCKET_NAME = "gtkx-mcp.sock";
+const SOCKET_PATH_BYTE_LIMIT = 100;
+const SHORT_SOCKET_ROOT = "/tmp";
+const socketCandidate = () => process.env[MCP_SOCKET_PATH_ENV] ?? join(process.env.XDG_RUNTIME_DIR ?? tmpdir(), SOCKET_NAME);
+const currentUserId = () => {
+    const getuid = process.getuid;
+    if (getuid === undefined) {
+        throw new Error("GTKX MCP Unix sockets require a platform with user IDs");
+    }
+    return getuid();
+};
+const verifyPrivateDirectory = (directory, userId) => {
+    const entry = lstatSync(directory);
+    if (!entry.isDirectory() || entry.uid !== userId || (entry.mode & 0o777) !== 0o700) {
+        throw new Error(`GTKX MCP fallback socket directory is not private: ${directory}`);
+    }
+};
+const ensurePrivateDirectory = (directory, userId) => {
+    try {
+        mkdirSync(directory, { mode: 0o700 });
+    }
+    catch (error) {
+        if (error.code !== "EEXIST") {
+            throw error;
+        }
+    }
+    verifyPrivateDirectory(directory, userId);
+};
+const fallbackAddress = (candidate) => {
+    const userId = currentUserId();
+    const digest = createHash("sha256").update(candidate).digest("hex").slice(0, 24);
+    const fallbackDirectory = join(SHORT_SOCKET_ROOT, `gtkx-mcp-${String(userId)}-${digest}`);
+    try {
+        verifyPrivateDirectory(fallbackDirectory, userId);
+    }
+    catch (error) {
+        if (error.code !== "ENOENT") {
+            throw error;
+        }
+    }
+    return { path: join(fallbackDirectory, "socket"), fallbackDirectory };
+};
+const resolveMcpSocketAddress = (providedPath) => {
+    const candidate = providedPath ?? socketCandidate();
+    return Buffer.byteLength(candidate) <= SOCKET_PATH_BYTE_LIMIT
+        ? { path: candidate, fallbackDirectory: null }
+        : fallbackAddress(candidate);
+};
+const resolveMcpSocketPath = (providedPath) => resolveMcpSocketAddress(providedPath).path;
+const prepareMcpSocketAddress = (address) => {
+    if (address.fallbackDirectory !== null) {
+        ensurePrivateDirectory(address.fallbackDirectory, currentUserId());
+    }
+};
+const cleanupMcpSocketAddress = (address) => {
+    const directory = address.fallbackDirectory;
+    if (directory === null) {
+        return;
+    }
+    try {
+        verifyPrivateDirectory(directory, currentUserId());
+        rmdirSync(directory);
+    }
+    catch {
+        return;
+    }
+};
+export { cleanupMcpSocketAddress, MCP_SOCKET_PATH_ENV, prepareMcpSocketAddress, resolveMcpSocketAddress, resolveMcpSocketPath, };
+//# sourceMappingURL=socket-path.js.map

package/dist/socket-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-path.js","sourceRoot":"","sources":["../src/socket-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,WAAW,GAAG,eAAe,CAAC;AACpC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,MAAM,eAAe,GAAG,GAAW,EAAE,CACjC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC;AAEnG,MAAM,aAAa,GAAG,GAAW,EAAE;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,MAAM,EAAE,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,SAAiB,EAAE,MAAc,EAAQ,EAAE;IACvE,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAEnC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,sDAAsD,SAAS,EAAE,CAAC,CAAC;IACvF,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,SAAiB,EAAE,MAAc,EAAQ,EAAE;IACvE,IAAI,CAAC;QACD,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAoB,EAAE;IAC5D,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,EAAE,YAAY,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAE1F,IAAI,CAAC;QACD,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,YAAqB,EAAoB,EAAE;IACxE,MAAM,SAAS,GAAG,YAAY,IAAI,eAAe,EAAE,CAAC;IAEpD,OAAO,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,sBAAsB;QACzD,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE;QAC9C,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,YAAqB,EAAU,EAAE,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;AAE3G,MAAM,uBAAuB,GAAG,CAAC,OAAyB,EAAQ,EAAE;IAChE,IAAI,OAAO,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QACrC,sBAAsB,CAAC,OAAO,CAAC,iBAAiB,EAAE,aAAa,EAAE,CAAC,CAAC;IACvE,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,OAAyB,EAAQ,EAAE;IAChE,MAAM,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAE5C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,sBAAsB,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;QACnD,SAAS,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO;IACX,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GAEvB,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { lstatSync, mkdirSync, rmdirSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\n\ntype McpSocketAddress = {\n    path: string;\n    fallbackDirectory: string | null;\n};\n\nconst MCP_SOCKET_PATH_ENV = \"GTKX_MCP_SOCKET_PATH\";\nconst SOCKET_NAME = \"gtkx-mcp.sock\";\nconst SOCKET_PATH_BYTE_LIMIT = 100;\nconst SHORT_SOCKET_ROOT = \"/tmp\";\n\nconst socketCandidate = (): string =>\n    process.env[MCP_SOCKET_PATH_ENV] ?? join(process.env.XDG_RUNTIME_DIR ?? tmpdir(), SOCKET_NAME);\n\nconst currentUserId = (): number => {\n    const getuid = process.getuid;\n\n    if (getuid === undefined) {\n        throw new Error(\"GTKX MCP Unix sockets require a platform with user IDs\");\n    }\n\n    return getuid();\n};\n\nconst verifyPrivateDirectory = (directory: string, userId: number): void => {\n    const entry = lstatSync(directory);\n\n    if (!entry.isDirectory() || entry.uid !== userId || (entry.mode & 0o777) !== 0o700) {\n        throw new Error(`GTKX MCP fallback socket directory is not private: ${directory}`);\n    }\n};\n\nconst ensurePrivateDirectory = (directory: string, userId: number): void => {\n    try {\n        mkdirSync(directory, { mode: 0o700 });\n    } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") {\n            throw error;\n        }\n    }\n\n    verifyPrivateDirectory(directory, userId);\n};\n\nconst fallbackAddress = (candidate: string): McpSocketAddress => {\n    const userId = currentUserId();\n    const digest = createHash(\"sha256\").update(candidate).digest(\"hex\").slice(0, 24);\n    const fallbackDirectory = join(SHORT_SOCKET_ROOT, `gtkx-mcp-${String(userId)}-${digest}`);\n\n    try {\n        verifyPrivateDirectory(fallbackDirectory, userId);\n    } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") {\n            throw error;\n        }\n    }\n\n    return { path: join(fallbackDirectory, \"socket\"), fallbackDirectory };\n};\n\nconst resolveMcpSocketAddress = (providedPath?: string): McpSocketAddress => {\n    const candidate = providedPath ?? socketCandidate();\n\n    return Buffer.byteLength(candidate) <= SOCKET_PATH_BYTE_LIMIT\n        ? { path: candidate, fallbackDirectory: null }\n        : fallbackAddress(candidate);\n};\n\nconst resolveMcpSocketPath = (providedPath?: string): string => resolveMcpSocketAddress(providedPath).path;\n\nconst prepareMcpSocketAddress = (address: McpSocketAddress): void => {\n    if (address.fallbackDirectory !== null) {\n        ensurePrivateDirectory(address.fallbackDirectory, currentUserId());\n    }\n};\n\nconst cleanupMcpSocketAddress = (address: McpSocketAddress): void => {\n    const directory = address.fallbackDirectory;\n\n    if (directory === null) {\n        return;\n    }\n\n    try {\n        verifyPrivateDirectory(directory, currentUserId());\n        rmdirSync(directory);\n    } catch {\n        return;\n    }\n};\n\nexport {\n    cleanupMcpSocketAddress,\n    MCP_SOCKET_PATH_ENV,\n    prepareMcpSocketAddress,\n    resolveMcpSocketAddress,\n    resolveMcpSocketPath,\n    type McpSocketAddress,\n};\n"]}

package/dist/socket-server.d.ts

@@ -1,11 +1,13 @@
 import type { ConnectionRegistry } from "./connection-registry.js";
+import { type McpSocketAddress } from "./socket-path.js";
 declare class SocketServer {
     private server;
     private socketPath;
     private registry;
+    private address;
     private boundInode;
     private startup;
-    constructor(registry: ConnectionRegistry, socketPath?: string);
+    constructor(registry: ConnectionRegistry, address?: McpSocketAddress);
     private listen;
     private listenPrivately;
     private bind;

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

@@ -1 +1 @@
-{"version":3,"file":"socket-server.d.ts","sourceRoot":"","sources":["../src/socket-server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AA0PnE,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,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;AACnE,OAAO,EAEH,KAAK,gBAAgB,EAGxB,MAAM,kBAAkB,CAAC;AAyO1B,cAAM,YAAY;IACd,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,OAAO,CAA8B;gBAEjC,QAAQ,EAAE,kBAAkB,EAAE,OAAO,GAAE,gBAA4C;IAM/F,OAAO,CAAC,MAAM;YAoBA,eAAe;YASf,IAAI;IAgClB,OAAO,CAAC,IAAI;YAWE,aAAa;YASb,OAAO;IAmBf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAW9B;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}