@gtkx/cli 0.21.0 → 1.0.0-rc.2

package/dist/mcp/client.d.ts

@@ -0,0 +1,28 @@
+type McpClientOptions = {
+    socketPath?: string;
+    applicationId: string;
+};
+declare class McpClient {
+    private socket;
+    private connection;
+    private socketPath;
+    private applicationId;
+    private reconnectTimer;
+    private hasConnected;
+    private isStopping;
+    private pendingConnectReject;
+    private registry;
+    constructor(options: McpClientOptions);
+    private handleClose;
+    private handleSocketError;
+    private registerWithServer;
+    private attemptConnect;
+    private scheduleReconnect;
+    private register;
+    private respondToRequest;
+    private handleRequest;
+    connect(): Promise<void>;
+    disconnect(): void;
+}
+export { McpClient, type McpClientOptions };
+//# sourceMappingURL=client.d.ts.map

package/dist/mcp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAQA,KAAK,gBAAgB,GAAG;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AA2CF,cAAM,SAAS;IACX,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,oBAAoB,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAwB;gBAE5B,OAAO,EAAE,gBAAgB;IAKrC,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,iBAAiB;YAUX,kBAAkB;IAWhC,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,QAAQ;YAgBF,gBAAgB;YAuBhB,aAAa;IAQrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B,UAAU,IAAI,IAAI;CAwBrB;AAED,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/mcp/client.js

@@ -0,0 +1,182 @@
+import * as Gio from "@gtkx/gi/gio";
+import * as Gtk from "@gtkx/gi/gtk";
+import { DEFAULT_SOCKET_PATH, ErrorCode, ProtocolConnection, ProtocolError } from "@gtkx/mcp/internal";
+import { error, errorMessage, info, normalizeError, warn } from "@gtkx/utils";
+import * as net from "node:net";
+import { dispatch } from "./handlers.js";
+import { WidgetRegistry } from "./widget-registry.js";
+const RECONNECT_DELAY_MS = 2000;
+const REGISTER_TIMEOUT_MS = 30_000;
+const DISCONNECT_ERROR_CODES = new Set(["ENOENT", "ECONNREFUSED", "EPIPE", "ECONNRESET"]);
+const toResponseError = (error) => error instanceof ProtocolError
+    ? error.toErrorObject()
+    : { code: ErrorCode.INTERNAL_ERROR, message: errorMessage(error) };
+const connectSettler = (callbacks) => {
+    let isSettled = false;
+    const settle = (notify) => {
+        if (isSettled) {
+            return;
+        }
+        isSettled = true;
+        notify();
+    };
+    return {
+        succeed: () => {
+            settle(() => callbacks.onSuccess?.());
+        },
+        fail: (failure) => {
+            settle(() => callbacks.onError?.(failure));
+        },
+    };
+};
+class McpClient {
+    socket = null;
+    connection = null;
+    socketPath;
+    applicationId;
+    reconnectTimer = null;
+    hasConnected = false;
+    isStopping = false;
+    pendingConnectReject = null;
+    registry = new WidgetRegistry();
+    constructor(options) {
+        this.socketPath = options.socketPath ?? DEFAULT_SOCKET_PATH;
+        this.applicationId = options.applicationId;
+    }
+    handleClose() {
+        if (this.hasConnected) {
+            info("Disconnected from MCP server");
+            this.hasConnected = false;
+        }
+        this.socket = null;
+        this.connection = null;
+        this.scheduleReconnect();
+    }
+    handleSocketError(socketError) {
+        const code = socketError.code;
+        if (code !== undefined && DISCONNECT_ERROR_CODES.has(code)) {
+            this.scheduleReconnect();
+        }
+        else {
+            error("Socket error:", socketError.message);
+        }
+    }
+    async registerWithServer(settle) {
+        try {
+            await this.register();
+            info("Registered with MCP server");
+            settle.succeed();
+        }
+        catch (registerError) {
+            error("Failed to register with MCP server:", errorMessage(registerError));
+            settle.fail(normalizeError(registerError));
+        }
+    }
+    attemptConnect(callbacks = {}) {
+        const settle = connectSettler(callbacks);
+        const socket = net.createConnection(this.socketPath, () => {
+            info(`Connected to MCP server at ${this.socketPath}`);
+            this.hasConnected = true;
+            void this.registerWithServer(settle);
+        });
+        const connection = ProtocolConnection.fromSocket(socket, {
+            onClose: () => {
+                this.handleClose();
+            },
+            onError: (socketError) => {
+                this.handleSocketError(socketError);
+                settle.fail(socketError);
+            },
+        });
+        connection.on("request", (request) => {
+            void this.handleRequest(request);
+        });
+        connection.on("invalid", ({ error: parseError }) => {
+            warn(`Received invalid JSON from MCP server: ${parseError.message}`);
+        });
+        this.socket = socket;
+        this.connection = connection;
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer || this.isStopping) {
+            return;
+        }
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.attemptConnect();
+        }, RECONNECT_DELAY_MS);
+    }
+    register() {
+        if (!this.connection) {
+            return Promise.reject(new Error("Connection not initialized"));
+        }
+        return this.connection.send("app.register", {
+            applicationId: this.applicationId,
+            pid: process.pid,
+            projectRoot: process.cwd(),
+        }, REGISTER_TIMEOUT_MS);
+    }
+    async respondToRequest(request) {
+        const { id, method, params } = request;
+        const connection = this.connection;
+        if (!connection) {
+            return;
+        }
+        try {
+            const defaultApp = Gio.Application.getDefault();
+            if (!(defaultApp instanceof Gtk.Application)) {
+                throw new TypeError("Application not initialized");
+            }
+            this.registry.refresh();
+            const result = await dispatch(method, params, { app: defaultApp, registry: this.registry });
+            connection.write({ id, result });
+        }
+        catch (dispatchError) {
+            connection.write({ id, error: toResponseError(dispatchError) });
+        }
+    }
+    async handleRequest(request) {
+        try {
+            await this.respondToRequest(request);
+        }
+        catch (requestError) {
+            error("Error handling request:", requestError);
+        }
+    }
+    async connect() {
+        return new Promise((resolve, reject) => {
+            this.pendingConnectReject = reject;
+            this.attemptConnect({
+                onSuccess: () => {
+                    this.pendingConnectReject = null;
+                    resolve();
+                },
+                onError: (connectError) => {
+                    this.pendingConnectReject = null;
+                    reject(connectError);
+                },
+            });
+        });
+    }
+    disconnect() {
+        this.isStopping = true;
+        if (this.pendingConnectReject) {
+            this.pendingConnectReject(new Error("Client disconnected before connection registered"));
+            this.pendingConnectReject = null;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.connection?.rejectPending(new Error("Client disconnected"));
+        if (this.socket) {
+            this.connection?.write({ id: crypto.randomUUID(), method: "app.unregister" });
+            this.socket.destroy();
+            this.socket = null;
+        }
+        this.connection = null;
+        this.hasConnected = false;
+    }
+}
+export { McpClient };
+//# sourceMappingURL=client.js.map

package/dist/mcp/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gio from \"@gtkx/gi/gio\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { DEFAULT_SOCKET_PATH, ErrorCode, ProtocolConnection, ProtocolError, type Request } from \"@gtkx/mcp/internal\";\nimport { error, errorMessage, info, normalizeError, warn } from \"@gtkx/utils\";\nimport * as net from \"node:net\";\nimport { dispatch } from \"./handlers.js\";\nimport { WidgetRegistry } from \"./widget-registry.js\";\n\ntype McpClientOptions = {\n    socketPath?: string;\n    applicationId: string;\n};\n\ntype ConnectCallbacks = {\n    onSuccess?: (() => void) | undefined;\n    onError?: ((error: Error) => void) | undefined;\n};\n\ntype ConnectSettler = {\n    succeed: () => void;\n    fail: (error: Error) => void;\n};\n\nconst RECONNECT_DELAY_MS = 2000;\nconst REGISTER_TIMEOUT_MS = 30_000;\nconst DISCONNECT_ERROR_CODES: Set<string> = new Set([\"ENOENT\", \"ECONNREFUSED\", \"EPIPE\", \"ECONNRESET\"]);\n\nconst toResponseError = (error: unknown): { code: number; message: string; data?: unknown } =>\n    error instanceof ProtocolError\n        ? error.toErrorObject()\n        : { code: ErrorCode.INTERNAL_ERROR, message: errorMessage(error) };\n\nconst connectSettler = (callbacks: ConnectCallbacks): ConnectSettler => {\n    let isSettled = false;\n\n    const settle = (notify: () => void): void => {\n        if (isSettled) {\n            return;\n        }\n\n        isSettled = true;\n        notify();\n    };\n\n    return {\n        succeed: () => {\n            settle(() => callbacks.onSuccess?.());\n        },\n        fail: (failure) => {\n            settle(() => callbacks.onError?.(failure));\n        },\n    };\n};\n\nclass McpClient {\n    private socket: net.Socket | null = null;\n    private connection: ProtocolConnection | null = null;\n    private socketPath: string;\n    private applicationId: string;\n    private reconnectTimer: NodeJS.Timeout | null = null;\n    private hasConnected = false;\n    private isStopping = false;\n    private pendingConnectReject: ((error: Error) => void) | null = null;\n    private registry = new WidgetRegistry();\n\n    constructor(options: McpClientOptions) {\n        this.socketPath = options.socketPath ?? DEFAULT_SOCKET_PATH;\n        this.applicationId = options.applicationId;\n    }\n\n    private handleClose(): void {\n        if (this.hasConnected) {\n            info(\"Disconnected from MCP server\");\n            this.hasConnected = false;\n        }\n\n        this.socket = null;\n        this.connection = null;\n        this.scheduleReconnect();\n    }\n\n    private handleSocketError(socketError: Error): void {\n        const code = (socketError as NodeJS.ErrnoException).code;\n\n        if (code !== undefined && DISCONNECT_ERROR_CODES.has(code)) {\n            this.scheduleReconnect();\n        } else {\n            error(\"Socket error:\", socketError.message);\n        }\n    }\n\n    private async registerWithServer(settle: ConnectSettler): Promise<void> {\n        try {\n            await this.register();\n            info(\"Registered with MCP server\");\n            settle.succeed();\n        } catch (registerError) {\n            error(\"Failed to register with MCP server:\", errorMessage(registerError));\n            settle.fail(normalizeError(registerError));\n        }\n    }\n\n    private attemptConnect(callbacks: ConnectCallbacks = {}): void {\n        const settle = connectSettler(callbacks);\n\n        const socket = net.createConnection(this.socketPath, () => {\n            info(`Connected to MCP server at ${this.socketPath}`);\n            this.hasConnected = true;\n            void this.registerWithServer(settle);\n        });\n\n        const connection = ProtocolConnection.fromSocket(socket, {\n            onClose: () => {\n                this.handleClose();\n            },\n            onError: (socketError) => {\n                this.handleSocketError(socketError);\n                settle.fail(socketError);\n            },\n        });\n\n        connection.on(\"request\", (request) => {\n            void this.handleRequest(request);\n        });\n\n        connection.on(\"invalid\", ({ error: parseError }) => {\n            warn(`Received invalid JSON from MCP server: ${parseError.message}`);\n        });\n\n        this.socket = socket;\n        this.connection = connection;\n    }\n\n    private scheduleReconnect(): void {\n        if (this.reconnectTimer || this.isStopping) {\n            return;\n        }\n\n        this.reconnectTimer = setTimeout(() => {\n            this.reconnectTimer = null;\n            this.attemptConnect();\n        }, RECONNECT_DELAY_MS);\n    }\n\n    private register(): Promise<unknown> {\n        if (!this.connection) {\n            return Promise.reject(new Error(\"Connection not initialized\"));\n        }\n\n        return this.connection.send(\n            \"app.register\",\n            {\n                applicationId: this.applicationId,\n                pid: process.pid,\n                projectRoot: process.cwd(),\n            },\n            REGISTER_TIMEOUT_MS,\n        );\n    }\n\n    private async respondToRequest(request: Request): Promise<void> {\n        const { id, method, params } = request;\n        const connection = this.connection;\n\n        if (!connection) {\n            return;\n        }\n\n        try {\n            const defaultApp = Gio.Application.getDefault();\n\n            if (!(defaultApp instanceof Gtk.Application)) {\n                throw new TypeError(\"Application not initialized\");\n            }\n\n            this.registry.refresh();\n            const result = await dispatch(method, params, { app: defaultApp, registry: this.registry });\n            connection.write({ id, result });\n        } catch (dispatchError) {\n            connection.write({ id, error: toResponseError(dispatchError) });\n        }\n    }\n\n    private async handleRequest(request: Request): Promise<void> {\n        try {\n            await this.respondToRequest(request);\n        } catch (requestError) {\n            error(\"Error handling request:\", requestError);\n        }\n    }\n\n    async connect(): Promise<void> {\n        return new Promise<void>((resolve, reject) => {\n            this.pendingConnectReject = reject;\n\n            this.attemptConnect({\n                onSuccess: () => {\n                    this.pendingConnectReject = null;\n                    resolve();\n                },\n                onError: (connectError) => {\n                    this.pendingConnectReject = null;\n                    reject(connectError);\n                },\n            });\n        });\n    }\n\n    disconnect(): void {\n        this.isStopping = true;\n\n        if (this.pendingConnectReject) {\n            this.pendingConnectReject(new Error(\"Client disconnected before connection registered\"));\n            this.pendingConnectReject = null;\n        }\n\n        if (this.reconnectTimer) {\n            clearTimeout(this.reconnectTimer);\n            this.reconnectTimer = null;\n        }\n\n        this.connection?.rejectPending(new Error(\"Client disconnected\"));\n\n        if (this.socket) {\n            this.connection?.write({ id: crypto.randomUUID(), method: \"app.unregister\" });\n            this.socket.destroy();\n            this.socket = null;\n        }\n\n        this.connection = null;\n        this.hasConnected = false;\n    }\n}\n\nexport { McpClient, type McpClientOptions };\n"]}

package/dist/mcp/handlers.d.ts

@@ -0,0 +1,9 @@
+import * as Gtk from "@gtkx/gi/gtk";
+import type { WidgetRegistry } from "./widget-registry.js";
+type HandlerContext = {
+    app: Gtk.Application;
+    registry: WidgetRegistry;
+};
+declare const dispatch: (method: string, params: unknown, ctx: HandlerContext) => Promise<unknown>;
+export { dispatch, type HandlerContext };
+//# sourceMappingURL=handlers.d.ts.map

package/dist/mcp/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAYpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,KAAK,cAAc,GAAG;IAClB,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;CAC5B,CAAC;AAyLF,QAAA,MAAM,QAAQ,GAAU,QAAQ,MAAM,EAAE,QAAQ,OAAO,EAAE,KAAK,cAAc,KAAG,OAAO,CAAC,OAAO,CAM7F,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,CAAC"}

package/dist/mcp/handlers.js

@@ -0,0 +1,147 @@
+import * as Gtk from "@gtkx/gi/gtk";
+import { invalidRequestError, methodNotFoundError, ServerRequestParamsSchemas, widgetNotFoundError, } from "@gtkx/mcp/internal";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { serializeWidget } from "./serialize-widget.js";
+import { loadTestingModule } from "./testing-loader.js";
+const HANDLERS = {
+    "app.getWindows": validated(ServerRequestParamsSchemas["app.getWindows"], ({ registry }) => Promise.resolve({
+        windows: registry.toplevels().map((window) => ({
+            id: registry.getOrCreateId(window),
+            title: window.getTitle(),
+        })),
+    })),
+    "widget.getTree": validated(ServerRequestParamsSchemas["widget.getTree"], async ({ app, registry }, params) => {
+        const testing = await loadTestingModule();
+        const container = params.rootId === undefined ? app : requireWidget(registry, params.rootId);
+        return {
+            tree: testing.prettyWidget(container, {
+                getId: (w) => registry.getOrCreateId(w),
+                highlight: false,
+                ...((params.maxDepth !== undefined) && { maxDepth: params.maxDepth }),
+            }),
+        };
+    }),
+    "widget.query": validated(ServerRequestParamsSchemas["widget.query"], handleQuery),
+    "widget.getProps": validated(ServerRequestParamsSchemas["widget.getProps"], async ({ registry }, params) => {
+        const { testing, widget } = await widgetTarget(registry, params.widgetId);
+        return serializeWidget(widget, (target) => registry.getOrCreateId(target), testing);
+    }),
+    "widget.click": validated(ServerRequestParamsSchemas["widget.click"], async ({ registry }, params) => {
+        const { testing, widget } = await widgetTarget(registry, params.widgetId);
+        await testing.userEvent.click(widget);
+        return { success: true };
+    }),
+    "widget.type": validated(ServerRequestParamsSchemas["widget.type"], async ({ registry }, params) => {
+        const { testing, widget } = await widgetTarget(registry, params.widgetId);
+        if (params.clear) {
+            await testing.userEvent.clear(widget);
+        }
+        await testing.userEvent.type(widget, params.text);
+        return { success: true };
+    }),
+    "widget.fireEvent": validated(ServerRequestParamsSchemas["widget.fireEvent"], async ({ registry }, params) => {
+        const { testing, widget } = await widgetTarget(registry, params.widgetId);
+        const signalArgs = (params.args ?? []).map((arg) => extractSignalArg(arg));
+        await testing.fireEvent(widget, params.signal, ...signalArgs);
+        return { success: true };
+    }),
+    "widget.screenshot": validated(ServerRequestParamsSchemas["widget.screenshot"], handleScreenshot),
+};
+function validated(schema, handler) {
+    return (ctx, params) => {
+        const parsed = schema.safeParse(params ?? {});
+        if (!parsed.success) {
+            throw invalidRequestError(parsed.error.message);
+        }
+        return handler(ctx, parsed.data);
+    };
+}
+const widgetTarget = async (registry, widgetId) => ({
+    testing: await loadTestingModule(),
+    widget: requireWidget(registry, widgetId),
+});
+const requireWidget = (registry, widgetId) => {
+    if (widgetId === undefined) {
+        throw widgetNotFoundError("undefined");
+    }
+    const widget = registry.get(widgetId);
+    if (!widget) {
+        throw widgetNotFoundError(widgetId);
+    }
+    return widget;
+};
+const extractSignalArg = (arg) => {
+    const isTypedArg = typeof arg === "object" && arg !== null && "type" in arg && "value" in arg;
+    return isTypedArg ? arg.value : arg;
+};
+const resolveRole = (value) => {
+    if (typeof value === "number") {
+        return value;
+    }
+    const resolved = Gtk.AccessibleRole[value.toUpperCase()];
+    return typeof resolved === "number" ? resolved : undefined;
+};
+const matchesOrEmpty = async (find) => {
+    try {
+        return await find();
+    }
+    catch {
+        return [];
+    }
+};
+async function handleQuery({ app, registry }, params) {
+    const testing = await loadTestingModule();
+    let widgets = [];
+    switch (params.by) {
+        case "role": {
+            const roleValue = resolveRole(params.value);
+            if (roleValue === undefined) {
+                throw invalidRequestError(`Unknown accessible role "${String(params.value)}"; use the lowercase role shown in the ` +
+                    "widget tree, e.g. \"button\", \"list\", \"list_item\", or \"checkbox\".");
+            }
+            widgets = await matchesOrEmpty(() => testing.findAllByRole(app, roleValue, params.options));
+            break;
+        }
+        case "text": {
+            widgets = await matchesOrEmpty(() => testing.findAllByText(app, String(params.value), params.options));
+            break;
+        }
+        case "name": {
+            widgets = await matchesOrEmpty(() => testing.findAllByName(app, String(params.value), params.options));
+            break;
+        }
+        case "labelText": {
+            widgets = await matchesOrEmpty(() => testing.findAllByLabelText(app, String(params.value), params.options));
+            break;
+        }
+    }
+    return { widgets: widgets.map((w) => serializeWidget(w, (widget) => registry.getOrCreateId(widget), testing, 0)) };
+}
+const defaultScreenshotTarget = (registry) => {
+    const [toplevel] = registry.toplevels();
+    if (!toplevel) {
+        throw new Error("No windows available for screenshot");
+    }
+    return toplevel;
+};
+async function handleScreenshot({ registry }, params) {
+    const testing = await loadTestingModule();
+    const target = params.windowId ? requireWidget(registry, params.windowId) : defaultScreenshotTarget(registry);
+    const result = await testing.screenshot(target);
+    if (params.path) {
+        mkdirSync(dirname(params.path), { recursive: true });
+        writeFileSync(params.path, Buffer.from(result.data, "base64"));
+        return { data: result.data, mimeType: result.mimeType, savedPath: params.path };
+    }
+    return { data: result.data, mimeType: result.mimeType };
+}
+const isServerInitiatedMethod = (method) => Object.hasOwn(ServerRequestParamsSchemas, method);
+const dispatch = async (method, params, ctx) => {
+    if (!isServerInitiatedMethod(method)) {
+        throw methodNotFoundError(method);
+    }
+    return HANDLERS[method](ctx, params);
+};
+export { dispatch };
+//# sourceMappingURL=handlers.js.map

package/dist/mcp/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport {\n    invalidRequestError,\n    methodNotFoundError,\n    type ParamsSchema,\n    type ServerInitiatedMethod,\n    type ServerRequestParams,\n    ServerRequestParamsSchemas,\n    widgetNotFoundError,\n} from \"@gtkx/mcp/internal\";\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport type { WidgetRegistry } from \"./widget-registry.js\";\nimport { serializeWidget } from \"./serialize-widget.js\";\nimport { loadTestingModule, type TestingModule } from \"./testing-loader.js\";\n\ntype HandlerContext = {\n    app: Gtk.Application;\n    registry: WidgetRegistry;\n};\n\ntype ValidatedHandler = (ctx: HandlerContext, params: unknown) => Promise<unknown>;\ntype WidgetTarget = { testing: TestingModule; widget: Gtk.Widget };\n\nconst HANDLERS: Record<ServerInitiatedMethod, ValidatedHandler> = {\n    \"app.getWindows\": validated(ServerRequestParamsSchemas[\"app.getWindows\"], ({ registry }) =>\n        Promise.resolve({\n            windows: registry.toplevels().map((window) => ({\n                id: registry.getOrCreateId(window),\n                title: window.getTitle(),\n            })),\n        })),\n    \"widget.getTree\": validated(ServerRequestParamsSchemas[\"widget.getTree\"], async ({ app, registry }, params) => {\n        const testing = await loadTestingModule();\n        const container = params.rootId === undefined ? app : requireWidget(registry, params.rootId);\n\n        return {\n            tree: testing.prettyWidget(container, {\n                getId: (w) => registry.getOrCreateId(w),\n                highlight: false,\n                ...((params.maxDepth !== undefined) && { maxDepth: params.maxDepth }),\n            }),\n        };\n    }),\n    \"widget.query\": validated(ServerRequestParamsSchemas[\"widget.query\"], handleQuery),\n    \"widget.getProps\": validated(ServerRequestParamsSchemas[\"widget.getProps\"], async ({ registry }, params) => {\n        const { testing, widget } = await widgetTarget(registry, params.widgetId);\n\n        return serializeWidget(widget, (target) => registry.getOrCreateId(target), testing);\n    }),\n    \"widget.click\": validated(ServerRequestParamsSchemas[\"widget.click\"], async ({ registry }, params) => {\n        const { testing, widget } = await widgetTarget(registry, params.widgetId);\n        await testing.userEvent.click(widget);\n\n        return { success: true };\n    }),\n    \"widget.type\": validated(ServerRequestParamsSchemas[\"widget.type\"], async ({ registry }, params) => {\n        const { testing, widget } = await widgetTarget(registry, params.widgetId);\n\n        if (params.clear) {\n            await testing.userEvent.clear(widget);\n        }\n\n        await testing.userEvent.type(widget, params.text);\n\n        return { success: true };\n    }),\n    \"widget.fireEvent\": validated(ServerRequestParamsSchemas[\"widget.fireEvent\"], async ({ registry }, params) => {\n        const { testing, widget } = await widgetTarget(registry, params.widgetId);\n        const signalArgs = (params.args ?? []).map((arg) => extractSignalArg(arg));\n        await testing.fireEvent(widget, params.signal, ...signalArgs);\n\n        return { success: true };\n    }),\n    \"widget.screenshot\": validated(ServerRequestParamsSchemas[\"widget.screenshot\"], handleScreenshot),\n};\n\nfunction validated<Params>(\n    schema: ParamsSchema<Params>,\n    handler: (ctx: HandlerContext, params: Params) => Promise<unknown>,\n): ValidatedHandler {\n    return (ctx, params) => {\n        const parsed = schema.safeParse(params ?? {});\n\n        if (!parsed.success) {\n            throw invalidRequestError(parsed.error.message);\n        }\n\n        return handler(ctx, parsed.data);\n    };\n}\n\nconst widgetTarget = async (registry: WidgetRegistry, widgetId: string | undefined): Promise<WidgetTarget> => ({\n    testing: await loadTestingModule(),\n    widget: requireWidget(registry, widgetId),\n});\n\nconst requireWidget = (registry: WidgetRegistry, widgetId: string | undefined): Gtk.Widget => {\n    if (widgetId === undefined) {\n        throw widgetNotFoundError(\"undefined\");\n    }\n\n    const widget = registry.get(widgetId);\n\n    if (!widget) {\n        throw widgetNotFoundError(widgetId);\n    }\n\n    return widget;\n};\n\nconst extractSignalArg = (arg: unknown): unknown => {\n    const isTypedArg = typeof arg === \"object\" && arg !== null && \"type\" in arg && \"value\" in arg;\n\n    return isTypedArg ? (arg as { value: unknown }).value : arg;\n};\n\nconst resolveRole = (value: string | number): Gtk.AccessibleRole | undefined => {\n    if (typeof value === \"number\") {\n        return value;\n    }\n\n    const resolved = Gtk.AccessibleRole[value.toUpperCase() as keyof typeof Gtk.AccessibleRole];\n\n    return typeof resolved === \"number\" ? resolved : undefined;\n};\n\nconst matchesOrEmpty = async (find: () => Promise<Gtk.Widget[]>): Promise<Gtk.Widget[]> => {\n    try {\n        return await find();\n    } catch {\n        return [];\n    }\n};\n\nasync function handleQuery(\n    { app, registry }: HandlerContext,\n    params: ServerRequestParams<\"widget.query\">,\n): Promise<unknown> {\n    const testing = await loadTestingModule();\n    let widgets: Gtk.Widget[] = [];\n\n    switch (params.by) {\n        case \"role\": {\n            const roleValue = resolveRole(params.value);\n\n            if (roleValue === undefined) {\n                throw invalidRequestError(\n                    `Unknown accessible role \"${String(params.value)}\"; use the lowercase role shown in the ` +\n                    \"widget tree, e.g. \\\"button\\\", \\\"list\\\", \\\"list_item\\\", or \\\"checkbox\\\".\",\n                );\n            }\n\n            widgets = await matchesOrEmpty(() => testing.findAllByRole(app, roleValue, params.options));\n            break;\n        }\n        case \"text\": {\n            widgets = await matchesOrEmpty(() => testing.findAllByText(app, String(params.value), params.options));\n            break;\n        }\n        case \"name\": {\n            widgets = await matchesOrEmpty(() => testing.findAllByName(app, String(params.value), params.options));\n            break;\n        }\n        case \"labelText\": {\n            widgets = await matchesOrEmpty(() => testing.findAllByLabelText(app, String(params.value), params.options));\n            break;\n        }\n    }\n\n    return { widgets: widgets.map((w) => serializeWidget(w, (widget) => registry.getOrCreateId(widget), testing, 0)) };\n}\n\nconst defaultScreenshotTarget = (registry: WidgetRegistry): Gtk.Widget => {\n    const [toplevel] = registry.toplevels();\n\n    if (!toplevel) {\n        throw new Error(\"No windows available for screenshot\");\n    }\n\n    return toplevel;\n};\n\nasync function handleScreenshot(\n    { registry }: HandlerContext,\n    params: ServerRequestParams<\"widget.screenshot\">,\n): Promise<unknown> {\n    const testing = await loadTestingModule();\n    const target = params.windowId ? requireWidget(registry, params.windowId) : defaultScreenshotTarget(registry);\n    const result = await testing.screenshot(target);\n\n    if (params.path) {\n        mkdirSync(dirname(params.path), { recursive: true });\n        writeFileSync(params.path, Buffer.from(result.data, \"base64\"));\n\n        return { data: result.data, mimeType: result.mimeType, savedPath: params.path };\n    }\n\n    return { data: result.data, mimeType: result.mimeType };\n}\n\nconst isServerInitiatedMethod = (method: string): method is ServerInitiatedMethod =>\n    Object.hasOwn(ServerRequestParamsSchemas, method);\n\nconst dispatch = async (method: string, params: unknown, ctx: HandlerContext): Promise<unknown> => {\n    if (!isServerInitiatedMethod(method)) {\n        throw methodNotFoundError(method);\n    }\n\n    return HANDLERS[method](ctx, params);\n};\n\nexport { dispatch, type HandlerContext };\n"]}

package/dist/mcp/index.d.ts

@@ -0,0 +1,4 @@
+import { McpClient } from "./client.js";
+declare const startMcpClient: (applicationId: string) => Promise<McpClient>, stopMcpClient: () => void;
+export { startMcpClient, stopMcpClient };
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxC,QAAA,MAAe,cAAc,kBAJF,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,EAInB,aAAa,QAHlC,IAGkE,CAAC;AAsCnF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,34 @@
+import { McpClient } from "./client.js";
+const { start: startMcpClient, stop: stopMcpClient } = createMcpClientController();
+async function connectQuietly(client) {
+    try {
+        await client.connect();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function createMcpClientController() {
+    let current = null;
+    return {
+        start: async (applicationId) => {
+            if (current) {
+                return current;
+            }
+            const client = new McpClient({ applicationId });
+            current = client;
+            await connectQuietly(client);
+            return client;
+        },
+        stop: () => {
+            if (!current) {
+                return;
+            }
+            current.disconnect();
+            current = null;
+        },
+    };
+}
+export { startMcpClient, stopMcpClient };
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,yBAAyB,EAAE,CAAC;AAEnF,KAAK,UAAU,cAAc,CAAC,MAAiB;IAC3C,IAAI,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QAEvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB;IAC9B,IAAI,OAAO,GAAqB,IAAI,CAAC;IAErC,OAAO;QACH,KAAK,EAAE,KAAK,EAAE,aAAqB,EAAsB,EAAE;YACvD,IAAI,OAAO,EAAE,CAAC;gBACV,OAAO,OAAO,CAAC;YACnB,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;YAChD,OAAO,GAAG,MAAM,CAAC;YACjB,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;YAE7B,OAAO,MAAM,CAAC;QAClB,CAAC;QACD,IAAI,EAAE,GAAS,EAAE;YACb,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO;YACX,CAAC;YAED,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;KACJ,CAAC;AACN,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import { McpClient } from \"./client.js\";\n\ntype McpClientController = {\n    start: (applicationId: string) => Promise<McpClient>;\n    stop: () => void;\n};\n\nconst { start: startMcpClient, stop: stopMcpClient } = createMcpClientController();\n\nasync function connectQuietly(client: McpClient): Promise<boolean> {\n    try {\n        await client.connect();\n\n        return true;\n    } catch {\n        return false;\n    }\n}\n\nfunction createMcpClientController(): McpClientController {\n    let current: McpClient | null = null;\n\n    return {\n        start: async (applicationId: string): Promise<McpClient> => {\n            if (current) {\n                return current;\n            }\n\n            const client = new McpClient({ applicationId });\n            current = client;\n            await connectQuietly(client);\n\n            return client;\n        },\n        stop: (): void => {\n            if (!current) {\n                return;\n            }\n\n            current.disconnect();\n            current = null;\n        },\n    };\n}\n\nexport { startMcpClient, stopMcpClient };\n"]}

package/dist/mcp/serialize-widget.d.ts

@@ -0,0 +1,10 @@
+import type * as Gtk from "@gtkx/gi/gtk";
+import type { SerializedWidget } from "@gtkx/mcp/internal";
+type WidgetIdResolver = (widget: Gtk.Widget) => string;
+type WidgetFormatting = {
+    formatRole(role: Gtk.AccessibleRole): string;
+    getWidgetNodeText(widget: Gtk.Widget): string | null;
+};
+declare const serializeWidget: (widget: Gtk.Widget, resolveId: WidgetIdResolver, testing: WidgetFormatting, maxDepth?: number) => SerializedWidget;
+export { serializeWidget, type WidgetFormatting };
+//# sourceMappingURL=serialize-widget.d.ts.map

package/dist/mcp/serialize-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-widget.d.ts","sourceRoot":"","sources":["../../src/mcp/serialize-widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC;AAEvD,KAAK,gBAAgB,GAAG;IACpB,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC;IAC7C,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACxD,CAAC;AAEF,QAAA,MAAM,eAAe,GACjB,QAAQ,GAAG,CAAC,MAAM,EAClB,WAAW,gBAAgB,EAC3B,SAAS,gBAAgB,EACzB,iBAAmB,KACpB,gBAuBF,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/mcp/serialize-widget.js

@@ -0,0 +1,23 @@
+const serializeWidget = (widget, resolveId, testing, maxDepth = Infinity) => {
+    const children = [];
+    if (maxDepth > 0) {
+        let child = widget.getFirstChild();
+        while (child) {
+            children.push(serializeWidget(child, resolveId, testing, maxDepth - 1));
+            child = child.getNextSibling();
+        }
+    }
+    return {
+        id: resolveId(widget),
+        type: widget.constructor.name,
+        role: testing.formatRole(widget.getAccessibleRole()),
+        name: widget.getName() || null,
+        text: testing.getWidgetNodeText(widget),
+        sensitive: widget.getSensitive(),
+        visible: widget.getVisible(),
+        cssClasses: widget.getCssClasses(),
+        children,
+    };
+};
+export { serializeWidget };
+//# sourceMappingURL=serialize-widget.js.map

package/dist/mcp/serialize-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-widget.js","sourceRoot":"","sources":["../../src/mcp/serialize-widget.ts"],"names":[],"mappings":"AAUA,MAAM,eAAe,GAAG,CACpB,MAAkB,EAClB,SAA2B,EAC3B,OAAyB,EACzB,QAAQ,GAAG,QAAQ,EACH,EAAE;IAClB,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACf,IAAI,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QAEnC,OAAO,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;YACxE,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;QACnC,CAAC;IACL,CAAC;IAED,OAAO;QACH,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI;QAC7B,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACpD,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI;QAC9B,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACvC,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE;QAChC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE;QAC5B,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE;QAClC,QAAQ;KACX,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,eAAe,EAAyB,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { SerializedWidget } from \"@gtkx/mcp/internal\";\n\ntype WidgetIdResolver = (widget: Gtk.Widget) => string;\n\ntype WidgetFormatting = {\n    formatRole(role: Gtk.AccessibleRole): string;\n    getWidgetNodeText(widget: Gtk.Widget): string | null;\n};\n\nconst serializeWidget = (\n    widget: Gtk.Widget,\n    resolveId: WidgetIdResolver,\n    testing: WidgetFormatting,\n    maxDepth = Infinity,\n): SerializedWidget => {\n    const children: SerializedWidget[] = [];\n\n    if (maxDepth > 0) {\n        let child = widget.getFirstChild();\n\n        while (child) {\n            children.push(serializeWidget(child, resolveId, testing, maxDepth - 1));\n            child = child.getNextSibling();\n        }\n    }\n\n    return {\n        id: resolveId(widget),\n        type: widget.constructor.name,\n        role: testing.formatRole(widget.getAccessibleRole()),\n        name: widget.getName() || null,\n        text: testing.getWidgetNodeText(widget),\n        sensitive: widget.getSensitive(),\n        visible: widget.getVisible(),\n        cssClasses: widget.getCssClasses(),\n        children,\n    };\n};\n\nexport { serializeWidget, type WidgetFormatting };\n"]}

package/dist/mcp/testing-loader.d.ts

@@ -0,0 +1,5 @@
+type TestingModule = typeof import("@gtkx/testing");
+type TestingModuleLoader = () => Promise<TestingModule>;
+declare const setTestingModuleLoader: (next: TestingModuleLoader | null) => void, loadTestingModule: () => Promise<TestingModule>;
+export { setTestingModuleLoader, loadTestingModule, type TestingModule, type TestingModuleLoader };
+//# sourceMappingURL=testing-loader.d.ts.map

package/dist/mcp/testing-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing-loader.d.ts","sourceRoot":"","sources":["../../src/mcp/testing-loader.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG,cAAc,eAAe,CAAC,CAAC;AACpD,KAAK,mBAAmB,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;AAaxD,QAAA,MAAmB,sBAAsB,SAVnB,mBAAmB,GAAG,IAAI,KAAK,IAAI,EAUR,iBAAiB,QATlD,OAAO,CAAC,aAAa,CAS4D,CAAC;AA0DlG,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,CAAC"}

package/dist/mcp/testing-loader.js

@@ -0,0 +1,47 @@
+const { setLoader: setTestingModuleLoader, load: loadTestingModule } = createTestingModuleCache();
+function defaultLoader() {
+    return import("@gtkx/testing");
+}
+function missingTestingPackageError(cause) {
+    return new Error("@gtkx/testing is not installed, install it to enable MCP widget interactions: " +
+        `pnpm add -D @gtkx/testing (import failed: ${String(cause)})`, { cause });
+}
+function replaceLoader(state, next) {
+    state.loader = next ?? defaultLoader;
+    state.testingModule = null;
+    state.testingLoadError = null;
+}
+async function importTestingModule(state) {
+    try {
+        state.testingModule = await state.loader();
+        return state.testingModule;
+    }
+    catch (error) {
+        state.testingLoadError = missingTestingPackageError(error);
+        throw state.testingLoadError;
+    }
+}
+function loadCachedTestingModule(state) {
+    if (state.testingModule) {
+        return Promise.resolve(state.testingModule);
+    }
+    if (state.testingLoadError) {
+        return Promise.reject(state.testingLoadError);
+    }
+    return importTestingModule(state);
+}
+function createTestingModuleCache() {
+    const state = {
+        loader: defaultLoader,
+        testingModule: null,
+        testingLoadError: null,
+    };
+    return {
+        setLoader: (next) => {
+            replaceLoader(state, next);
+        },
+        load: () => loadCachedTestingModule(state),
+    };
+}
+export { setTestingModuleLoader, loadTestingModule };
+//# sourceMappingURL=testing-loader.js.map

package/dist/mcp/testing-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing-loader.js","sourceRoot":"","sources":["../../src/mcp/testing-loader.ts"],"names":[],"mappings":"AAcA,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,wBAAwB,EAAE,CAAC;AAElG,SAAS,aAAa;IAClB,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAC9C,OAAO,IAAI,KAAK,CACZ,gFAAgF;QAChF,6CAA6C,MAAM,CAAC,KAAK,CAAC,GAAG,EAC7D,EAAE,KAAK,EAAE,CACZ,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB,EAAE,IAAgC;IAC9E,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,aAAa,CAAC;IACrC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,KAAyB;IACxD,IAAI,CAAC;QACD,KAAK,CAAC,aAAa,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QAE3C,OAAO,KAAK,CAAC,aAAa,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,KAAK,CAAC,gBAAgB,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,KAAK,CAAC,gBAAgB,CAAC;IACjC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAyB;IACtD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,wBAAwB;IAC7B,MAAM,KAAK,GAAuB;QAC9B,MAAM,EAAE,aAAa;QACrB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;KACzB,CAAC;IAEF,OAAO;QACH,SAAS,EAAE,CAAC,IAAgC,EAAQ,EAAE;YAClD,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,EAAE,GAA2B,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC;KACrE,CAAC;AACN,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAgD,CAAC","sourcesContent":["type TestingModule = typeof import(\"@gtkx/testing\");\ntype TestingModuleLoader = () => Promise<TestingModule>;\n\ntype TestingModuleCache = {\n    setLoader: (next: TestingModuleLoader | null) => void;\n    load: () => Promise<TestingModule>;\n};\n\ntype TestingModuleState = {\n    loader: TestingModuleLoader;\n    testingModule: TestingModule | null;\n    testingLoadError: Error | null;\n};\n\nconst { setLoader: setTestingModuleLoader, load: loadTestingModule } = createTestingModuleCache();\n\nfunction defaultLoader(): Promise<TestingModule> {\n    return import(\"@gtkx/testing\");\n}\n\nfunction missingTestingPackageError(cause: unknown): Error {\n    return new Error(\n        \"@gtkx/testing is not installed, install it to enable MCP widget interactions: \" +\n        `pnpm add -D @gtkx/testing (import failed: ${String(cause)})`,\n        { cause },\n    );\n}\n\nfunction replaceLoader(state: TestingModuleState, next: TestingModuleLoader | null): void {\n    state.loader = next ?? defaultLoader;\n    state.testingModule = null;\n    state.testingLoadError = null;\n}\n\nasync function importTestingModule(state: TestingModuleState): Promise<TestingModule> {\n    try {\n        state.testingModule = await state.loader();\n\n        return state.testingModule;\n    } catch (error) {\n        state.testingLoadError = missingTestingPackageError(error);\n        throw state.testingLoadError;\n    }\n}\n\nfunction loadCachedTestingModule(state: TestingModuleState): Promise<TestingModule> {\n    if (state.testingModule) {\n        return Promise.resolve(state.testingModule);\n    }\n\n    if (state.testingLoadError) {\n        return Promise.reject(state.testingLoadError);\n    }\n\n    return importTestingModule(state);\n}\n\nfunction createTestingModuleCache(): TestingModuleCache {\n    const state: TestingModuleState = {\n        loader: defaultLoader,\n        testingModule: null,\n        testingLoadError: null,\n    };\n\n    return {\n        setLoader: (next: TestingModuleLoader | null): void => {\n            replaceLoader(state, next);\n        },\n        load: (): Promise<TestingModule> => loadCachedTestingModule(state),\n    };\n}\n\nexport { setTestingModuleLoader, loadTestingModule, type TestingModule, type TestingModuleLoader };\n"]}

package/dist/mcp/widget-registry.d.ts

@@ -0,0 +1,14 @@
+import * as Gtk from "@gtkx/gi/gtk";
+declare class WidgetRegistry {
+    private idByWidget;
+    private nextId;
+    private widgetById;
+    private toplevelWindows;
+    refresh(): void;
+    toplevels(): Gtk.Window[];
+    register(widget: Gtk.Widget): void;
+    getOrCreateId(widget: Gtk.Widget): string;
+    get(id: string): Gtk.Widget | undefined;
+}
+export { WidgetRegistry };
+//# sourceMappingURL=widget-registry.d.ts.map

package/dist/mcp/widget-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-registry.d.ts","sourceRoot":"","sources":["../../src/mcp/widget-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,cAAM,cAAc;IAChB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,eAAe,CAAoB;IAE3C,OAAO,IAAI,IAAI;IASf,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE;IAIzB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,IAAI;IAWlC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM;IAWzC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,SAAS;CAG1C;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}