@gtkx/mcp 0.21.0 → 1.0.0-rc.2

package/README.md

@@ -1,70 +1,173 @@
 <p align="center">
-    <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/logo.svg" alt="GTKX" width="100" height="100">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/logo.svg" alt="GTKX" width="100" />
 </p>
 
 <h1 align="center">GTKX</h1>
 
 <p align="center">
-    <strong>Linux application development for the modern age powered by GTK4 and React</strong>
+  The React framework for Linux.<br />
+  Build GTK4 and Adwaita apps in TypeScript, with React components and hooks driving GNOME's own widgets. What you ship is a GNOME app.
 </p>
 
 <p align="center">
-    <a href="https://www.npmjs.com/package/@gtkx/react"><img src="https://img.shields.io/npm/v/@gtkx/react.svg" alt="npm version"></a>
-    <a href="https://github.com/gtkx-org/gtkx/actions"><img src="https://img.shields.io/github/actions/workflow/status/eugeniodepalo/gtkx/ci.yml" alt="CI"></a>
-    <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License"></a>
-    <a href="https://github.com/gtkx-org/gtkx/discussions"><img src="https://img.shields.io/badge/discussions-GitHub-blue" alt="GitHub Discussions"></a>
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/v/create-gtkx?color=cb3837&logo=npm&label=create-gtkx" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/dm/create-gtkx?color=cb3837&logo=npm&label=downloads" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A524-339933?logo=node.js&logoColor=white" alt="Node >= 24" />
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License: MPL-2.0" /></a>
+  <a href="https://github.com/gtkx-org/gtkx/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gtkx-org/gtkx/ci.yml?branch=main&logo=github&label=CI" alt="CI status" /></a>
+  <img src="https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white" alt="TypeScript" />
+</p>
+
+<p align="center">
+  <a href="https://gtkx.dev">Homepage</a> &middot;
+  <a href="https://gtkx.dev/guide/why-gtkx">Documentation</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/tree/main/examples">Examples</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md">Contributing</a>
 </p>
 
 ---
 
+GTKX generates fully typed bindings for the entire GTK4 and Adwaita surface directly from GObject-Introspection. On top of those bindings you get the React programming model: components and hooks driving GObject instances, with Fast Refresh while you develop.
+
 <p align="center">
-    <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/demo.gif" alt="GTKX Demo" width="100%">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/examples/tutorial/assets/screenshot.png" alt="The Tasks app: an Adwaita window with a sidebar of smart views and colored lists on the left, and a boxed task list on the right." />
 </p>
 
----
+<p align="center">
+  <em>The Tasks app you build in the <a href="https://gtkx.dev/tutorial/">tutorial</a>.</em>
+</p>
+
+## Demo
+
+The intrinsic elements in this snippet render GTK4 widgets, and ordinary React hooks and events drive them:
+
+```tsx
+import * as Gtk from "@gtkx/gi/gtk";
+import { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkLabel } from "@gtkx/jsx/gtk";
+import { createRoot, quit } from "@gtkx/react";
+import { useState } from "react";
+
+const Counter = () => {
+  const [count, setCount] = useState(0);
+
+  return (
+    <GtkApplicationWindow
+      title="Hello GTKX"
+      defaultWidth={400}
+      defaultHeight={300}
+      onCloseRequest={quit}
+    >
+      <GtkBox
+        orientation={Gtk.Orientation.VERTICAL}
+        spacing={20}
+        marginTop={40}
+        marginBottom={40}
+        marginStart={40}
+        marginEnd={40}
+        valign={Gtk.Align.CENTER}
+        halign={Gtk.Align.CENTER}
+      >
+        <GtkLabel cssClasses={["title-1"]}>Welcome to GTKX!</GtkLabel>
+        <GtkLabel cssClasses={["title-2"]}>{`Count: ${count}`}</GtkLabel>
+        <GtkButton
+          label="Increment"
+          onClicked={() => setCount((c) => c + 1)}
+          cssClasses={["suggested-action", "pill"]}
+        />
+      </GtkBox>
+    </GtkApplicationWindow>
+  );
+};
+
+const App = () => (
+  <GtkApplication>
+    <Counter />
+  </GtkApplication>
+);
+
+createRoot().render(<App />);
+```
+
+This is the [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world) example, with `app.tsx` and `index.tsx` combined into a single snippet. `@gtkx/gi` and `@gtkx/jsx` are per-project bindings generated by the CLI, not packages you install from npm.
+
+## Why GTKX
+
+### A declarative layer for the GNOME stack
+
+GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing re-renders that interface when your application state changes, and nothing hot-reloads it as you work. GTKX adds that missing layer, and the tooling around it, on top of the stack you already know:
+
+- a React reconciler that exposes every GObject as a JSX element,
+- a CLI for scaffolding, development, and production builds,
+- a dev server with Fast Refresh that patches your running UI in place,
+- CSS-in-JS styling and high-level list, grid, and dialog components,
+- a Testing Library-style API for querying and driving your widgets in tests,
+- and a Model Context Protocol (MCP) server that exposes your live app to AI agents.
+
+### The full GNOME API surface
+
+React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX exposes it: GTK4, Adwaita, and any other GObject-Introspection library on your system. Linux-only by design.
+
+### Why Node.js, and why generated bindings
+
+GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [why-gtkx guide](https://gtkx.dev/guide/why-gtkx) covers the comparison in full.
 
-GTKX is a modern framework for building native Linux applications using React and GTK. It provides the full range of GTK4, GLib, and Node.js APIs, allowing you to create rich, performant desktop applications with the tools and libraries you already know.
+GTKX generates the TypeScript types and the native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. Codegen covers the whole GTK4 and Adwaita surface.
 
-## Features
+At runtime, the native Rust core calls straight into the system GTK4, Adwaita, and GLib libraries through libffi, without loading libgirepository at all.
 
-- **React 19** — Hooks, concurrent features, and the component model you know
-- **Fully native Node.js environment** - Runs on vanilla Node.js, with the help of a Neon native module
-- **TypeScript first** — Full type safety with auto-generated bindings
-- **Rich GLib support** — Provides bindings for most modern GLib/GObject libraries, including Adwaita
-- **HMR** — Fast refresh during development powered by Vite
-- **CSS-in-JS styling** — Easy styling with GTK CSS powered by Emotion
-- **Testing library** — Testing Library-inspired API for testing components and E2E
+## Quick start
 
-## Quick Start
+GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requirements).
 
-```bash
-npx @gtkx/cli create my-app
+Scaffold a new app with the `create-gtkx` initializer:
+
+```sh
+npm create gtkx@rc
+```
+
+The same command works with other package managers: `pnpm create gtkx@rc` or `yarn create gtkx@rc`.
+
+Then run your new app:
+
+```sh
 cd my-app
 npm run dev
 ```
 
-## Examples
+To go further, follow the [tutorial](https://gtkx.dev/tutorial/).
 
-Explore complete applications in the [`examples/`](./examples) directory:
+## Documentation
 
-- **[hello-world](./examples/hello-world)** — Minimal application showing a counter
-- **[gtk-demo](./examples/gtk-demo)** — Full replica of the official GTK demo app
-- **[tutorial](./examples/tutorial)** — Notes app from the tutorial with GSettings and Adwaita
-- **[browser](./examples/browser)** — Simple browser using WebKitWebView
+The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tutorial that builds a complete GNOME app, from scaffolding to packaging and shipping, plus guides and a full API reference.
 
-## Documentation
+**[Read the docs &rarr;](https://gtkx.dev/guide/why-gtkx)**
 
-Visit [https://gtkx.dev](https://gtkx.dev) for the full documentation.
+## Requirements
 
-## Contributing
+GTKX is Linux-only. You need:
 
-Contributions are welcome! Please see the [contributing guidelines](./CONTRIBUTING.md).
+- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Node.js 24 or later
 
-## Community
+The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
+
+## Examples
+
+Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
+
+- [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world): the counter above.
+- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): a React port of the official GTK4 widget showcase, covering lists, dialogs, gestures, CSS, and OpenGL.
+- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): a WebKitWebView-based web browser.
+- [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
+
+## Status
+
+GTKX 1.0 is at the release candidate stage.
+
+## Contributing
 
-- [GitHub Discussions](https://github.com/gtkx-org/gtkx/discussions) — Questions, ideas, and general discussion
-- [Issue Tracker](https://github.com/gtkx-org/gtkx/issues) — Bug reports and feature requests
+Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 24 or later, pnpm, and a Rust toolchain.
 
 ## License
 
-[MPL-2.0](./LICENSE)
+GTKX is licensed under [MPL-2.0](https://github.com/gtkx-org/gtkx/blob/main/LICENSE).

package/bin/gtkx-mcp.js

@@ -1,2 +1,10 @@
 #!/usr/bin/env node
-import "../dist/cli.js";
+import process from "node:process";
+import { log, main } from "../dist/server.js";
+
+try {
+    await main();
+} catch (error) {
+    log.error("fatal error", error);
+    process.exit(1);
+}

package/dist/app-router.d.ts

@@ -0,0 +1,35 @@
+import { type AppInfo } from "./protocol/schemas.js";
+import { type AppConnections, type ProtocolConnection } from "./transport.js";
+type AppRegisteredEvent = CustomEvent<AppInfo>;
+type AppUnregisteredEvent = CustomEvent<string>;
+type RegisteredApp = {
+    info: AppInfo;
+    connection: ProtocolConnection;
+};
+declare function appRegisteredEvent(info: AppInfo): AppRegisteredEvent;
+declare function appUnregisteredEvent(applicationId: string): AppUnregisteredEvent;
+declare class AppRouter extends EventTarget {
+    private static defaultWaitTimeout;
+    private apps;
+    private connectionToApp;
+    private requestTimeout;
+    private connections;
+    constructor(connections: AppConnections, options?: {
+        requestTimeout?: number;
+    });
+    private resolveTargetApp;
+    private handleRequest;
+    private handleRegister;
+    private handleUnregister;
+    private acknowledge;
+    private sendError;
+    private removeApp;
+    getApps(): AppInfo[];
+    hasConnectedApps(): boolean;
+    getDefaultApp(): RegisteredApp | undefined;
+    getProjectRoot(): string | undefined;
+    waitForApp(timeout?: number): Promise<AppInfo>;
+    sendToApp<T>(applicationId: string | undefined, method: string, params?: unknown): Promise<T>;
+}
+export { AppRouter, appRegisteredEvent, appUnregisteredEvent, type AppRegisteredEvent, type AppUnregisteredEvent };
+//# sourceMappingURL=app-router.d.ts.map

package/dist/app-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-router.d.ts","sourceRoot":"","sources":["../src/app-router.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,OAAO,EAAqD,MAAM,uBAAuB,CAAC;AACxG,OAAO,EACH,KAAK,cAAc,EAInB,KAAK,kBAAkB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,KAAK,kBAAkB,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAC/C,KAAK,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAEhD,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,kBAAkB,CAAC;CAClC,CAAC;AAIF,iBAAS,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAE7D;AAED,iBAAS,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,CAEzE;AAED,cAAM,SAAU,SAAQ,WAAW;IAC/B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAU;IAE3C,OAAO,CAAC,IAAI,CAAyC;IAErD,OAAO,CAAC,eAAe,CAAkC;IAEzD,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,WAAW,CAAiB;gBAExB,WAAW,EAAE,cAAc,EAAE,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO;IAelF,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,SAAS;IAgBjB,OAAO,IAAI,OAAO,EAAE;IAIpB,gBAAgB,IAAI,OAAO;IAI3B,aAAa,IAAI,aAAa,GAAG,SAAS;IAM1C,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,UAAU,CAAC,OAAO,GAAE,MAAqC,GAAG,OAAO,CAAC,OAAO,CAAC;IA6BtE,SAAS,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CActG;AAED,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,CAAC"}

package/dist/app-router.js

@@ -0,0 +1,143 @@
+import { appNotFoundError, connectionWriteFailedError, invalidRequestError, methodNotFoundError, noAppConnectedError, } from "./protocol/errors.js";
+import { RegisterParamsSchema } from "./protocol/schemas.js";
+import { ConnectionClosedError, } from "./transport.js";
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+function appRegisteredEvent(info) {
+    return new CustomEvent("appRegistered", { detail: info });
+}
+function appUnregisteredEvent(applicationId) {
+    return new CustomEvent("appUnregistered", { detail: applicationId });
+}
+class AppRouter extends EventTarget {
+    static defaultWaitTimeout = 10_000;
+    apps = new Map();
+    connectionToApp = new Map();
+    requestTimeout;
+    connections;
+    constructor(connections, options = {}) {
+        super();
+        this.connections = connections;
+        this.requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.connections.addEventListener("request", (event) => {
+            const { connection, request } = event.detail;
+            this.handleRequest(connection, request);
+        });
+        this.connections.addEventListener("disconnection", (event) => {
+            this.removeApp(event.detail);
+        });
+    }
+    resolveTargetApp(applicationId) {
+        const app = applicationId ? this.apps.get(applicationId) : this.getDefaultApp();
+        if (app) {
+            return app;
+        }
+        if (applicationId) {
+            throw appNotFoundError(applicationId);
+        }
+        throw noAppConnectedError();
+    }
+    handleRequest(connection, request) {
+        if (request.method === "app.register") {
+            this.handleRegister(connection, request);
+        }
+        else if (request.method === "app.unregister") {
+            this.handleUnregister(connection, request);
+        }
+        else {
+            this.sendError(connection, request, methodNotFoundError(request.method));
+        }
+    }
+    handleRegister(connection, request) {
+        const parseResult = RegisterParamsSchema.safeParse(request.params);
+        if (!parseResult.success) {
+            this.sendError(connection, request, invalidRequestError(parseResult.error.message));
+            return;
+        }
+        const params = parseResult.data;
+        const appInfo = {
+            applicationId: params.applicationId,
+            pid: params.pid,
+            ...(params.projectRoot !== undefined && { projectRoot: params.projectRoot }),
+        };
+        this.apps.set(params.applicationId, { info: appInfo, connection });
+        this.connectionToApp.set(connection.id, params.applicationId);
+        this.acknowledge(connection, request);
+        this.dispatchEvent(appRegisteredEvent(appInfo));
+    }
+    handleUnregister(connection, request) {
+        this.removeApp(connection);
+        this.acknowledge(connection, request);
+    }
+    acknowledge(connection, request) {
+        const response = {
+            id: request.id,
+            result: { success: true },
+        };
+        this.connections.send(connection.id, response);
+    }
+    sendError(connection, request, error) {
+        this.connections.send(connection.id, {
+            id: request.id,
+            error: error.toErrorObject(),
+        });
+    }
+    removeApp(connection) {
+        const applicationId = this.connectionToApp.get(connection.id);
+        this.connectionToApp.delete(connection.id);
+        if (applicationId === undefined) {
+            return;
+        }
+        if (this.apps.get(applicationId)?.connection !== connection) {
+            return;
+        }
+        this.apps.delete(applicationId);
+        this.dispatchEvent(appUnregisteredEvent(applicationId));
+    }
+    getApps() {
+        return this.apps.values().map((app) => app.info).toArray();
+    }
+    hasConnectedApps() {
+        return this.apps.size > 0;
+    }
+    getDefaultApp() {
+        const first = this.apps.values().next();
+        return first.done ? undefined : first.value;
+    }
+    getProjectRoot() {
+        return this.getDefaultApp()?.info.projectRoot;
+    }
+    waitForApp(timeout = AppRouter.defaultWaitTimeout) {
+        const defaultApp = this.getDefaultApp();
+        if (defaultApp) {
+            return Promise.resolve(defaultApp.info);
+        }
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                this.removeEventListener("appRegistered", onRegister);
+                reject(new Error(`Timeout waiting for app registration after ${String(timeout)}ms. ` +
+                    "Make sure your GTKX app is running with 'gtkx dev'."));
+            }, timeout);
+            const onRegister = (event) => {
+                clearTimeout(timeoutId);
+                this.removeEventListener("appRegistered", onRegister);
+                resolve(event.detail);
+            };
+            this.addEventListener("appRegistered", onRegister);
+        });
+    }
+    async sendToApp(applicationId, method, params) {
+        const app = this.resolveTargetApp(applicationId);
+        try {
+            return await app.connection.send(method, params, this.requestTimeout);
+        }
+        catch (error) {
+            if (error instanceof ConnectionClosedError) {
+                this.removeApp(app.connection);
+                throw connectionWriteFailedError(app.info.applicationId);
+            }
+            throw error;
+        }
+    }
+}
+export { AppRouter, appRegisteredEvent, appUnregisteredEvent };
+//# sourceMappingURL=app-router.js.map

package/dist/app-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-router.js","sourceRoot":"","sources":["../src/app-router.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    appNotFoundError,\n    connectionWriteFailedError,\n    invalidRequestError,\n    methodNotFoundError,\n    noAppConnectedError,\n    type ProtocolError,\n} from \"./protocol/errors.js\";\nimport { type AppInfo, RegisterParamsSchema, type Request, type Response } from \"./protocol/schemas.js\";\nimport {\n    type AppConnections,\n    ConnectionClosedError,\n    type ConnectionEvent,\n    type ConnectionRequestEvent,\n    type ProtocolConnection,\n} from \"./transport.js\";\n\ntype AppRegisteredEvent = CustomEvent<AppInfo>;\ntype AppUnregisteredEvent = CustomEvent<string>;\n\ntype RegisteredApp = {\n    info: AppInfo;\n    connection: ProtocolConnection;\n};\n\nconst DEFAULT_REQUEST_TIMEOUT_MS = 30_000;\n\nfunction appRegisteredEvent(info: AppInfo): AppRegisteredEvent {\n    return new CustomEvent(\"appRegistered\", { detail: info });\n}\n\nfunction appUnregisteredEvent(applicationId: string): AppUnregisteredEvent {\n    return new CustomEvent(\"appUnregistered\", { detail: applicationId });\n}\n\nclass AppRouter extends EventTarget {\n    private static defaultWaitTimeout = 10_000;\n\n    private apps: Map<string, RegisteredApp> = new Map();\n\n    private connectionToApp: Map<string, string> = new Map();\n\n    private requestTimeout: number;\n\n    private connections: AppConnections;\n\n    constructor(connections: AppConnections, options: { requestTimeout?: number } = {}) {\n        super();\n        this.connections = connections;\n        this.requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT_MS;\n\n        this.connections.addEventListener(\"request\", (event) => {\n            const { connection, request } = (event as ConnectionRequestEvent).detail;\n            this.handleRequest(connection, request);\n        });\n\n        this.connections.addEventListener(\"disconnection\", (event) => {\n            this.removeApp((event as ConnectionEvent).detail);\n        });\n    }\n\n    private resolveTargetApp(applicationId: string | undefined): RegisteredApp {\n        const app = applicationId ? this.apps.get(applicationId) : this.getDefaultApp();\n\n        if (app) {\n            return app;\n        }\n\n        if (applicationId) {\n            throw appNotFoundError(applicationId);\n        }\n\n        throw noAppConnectedError();\n    }\n\n    private handleRequest(connection: ProtocolConnection, request: Request): void {\n        if (request.method === \"app.register\") {\n            this.handleRegister(connection, request);\n        } else if (request.method === \"app.unregister\") {\n            this.handleUnregister(connection, request);\n        } else {\n            this.sendError(connection, request, methodNotFoundError(request.method));\n        }\n    }\n\n    private handleRegister(connection: ProtocolConnection, request: Request): void {\n        const parseResult = RegisterParamsSchema.safeParse(request.params);\n\n        if (!parseResult.success) {\n            this.sendError(connection, request, invalidRequestError(parseResult.error.message));\n\n            return;\n        }\n\n        const params = parseResult.data;\n\n        const appInfo: AppInfo = {\n            applicationId: params.applicationId,\n            pid: params.pid,\n            ...(params.projectRoot !== undefined && { projectRoot: params.projectRoot }),\n        };\n\n        this.apps.set(params.applicationId, { info: appInfo, connection });\n        this.connectionToApp.set(connection.id, params.applicationId);\n        this.acknowledge(connection, request);\n        this.dispatchEvent(appRegisteredEvent(appInfo));\n    }\n\n    private handleUnregister(connection: ProtocolConnection, request: Request): void {\n        this.removeApp(connection);\n        this.acknowledge(connection, request);\n    }\n\n    private acknowledge(connection: ProtocolConnection, request: Request): void {\n        const response: Response = {\n            id: request.id,\n            result: { success: true },\n        };\n\n        this.connections.send(connection.id, response);\n    }\n\n    private sendError(connection: ProtocolConnection, request: Request, error: ProtocolError): void {\n        this.connections.send(connection.id, {\n            id: request.id,\n            error: error.toErrorObject(),\n        });\n    }\n\n    private removeApp(connection: ProtocolConnection): void {\n        const applicationId = this.connectionToApp.get(connection.id);\n        this.connectionToApp.delete(connection.id);\n\n        if (applicationId === undefined) {\n            return;\n        }\n\n        if (this.apps.get(applicationId)?.connection !== connection) {\n            return;\n        }\n\n        this.apps.delete(applicationId);\n        this.dispatchEvent(appUnregisteredEvent(applicationId));\n    }\n\n    getApps(): AppInfo[] {\n        return this.apps.values().map((app) => app.info).toArray();\n    }\n\n    hasConnectedApps(): boolean {\n        return this.apps.size > 0;\n    }\n\n    getDefaultApp(): RegisteredApp | undefined {\n        const first = this.apps.values().next();\n\n        return first.done ? undefined : first.value;\n    }\n\n    getProjectRoot(): string | undefined {\n        return this.getDefaultApp()?.info.projectRoot;\n    }\n\n    waitForApp(timeout: number = AppRouter.defaultWaitTimeout): Promise<AppInfo> {\n        const defaultApp = this.getDefaultApp();\n\n        if (defaultApp) {\n            return Promise.resolve(defaultApp.info);\n        }\n\n        return new Promise((resolve, reject) => {\n            const timeoutId = setTimeout(() => {\n                this.removeEventListener(\"appRegistered\", onRegister);\n\n                reject(\n                    new Error(\n                        `Timeout waiting for app registration after ${String(timeout)}ms. ` +\n                        \"Make sure your GTKX app is running with 'gtkx dev'.\",\n                    ),\n                );\n            }, timeout);\n\n            const onRegister = (event: Event): void => {\n                clearTimeout(timeoutId);\n                this.removeEventListener(\"appRegistered\", onRegister);\n                resolve((event as AppRegisteredEvent).detail);\n            };\n\n            this.addEventListener(\"appRegistered\", onRegister);\n        });\n    }\n\n    async sendToApp<T>(applicationId: string | undefined, method: string, params?: unknown): Promise<T> {\n        const app = this.resolveTargetApp(applicationId);\n\n        try {\n            return await app.connection.send<T>(method, params, this.requestTimeout);\n        } catch (error) {\n            if (error instanceof ConnectionClosedError) {\n                this.removeApp(app.connection);\n                throw connectionWriteFailedError(app.info.applicationId);\n            }\n\n            throw error;\n        }\n    }\n}\n\nexport { AppRouter, appRegisteredEvent, appUnregisteredEvent, type AppRegisteredEvent, type AppUnregisteredEvent };\n"]}

package/dist/connection-registry.d.ts

@@ -0,0 +1,12 @@
+import type { Socket } from "node:net";
+import type { Message } from "./protocol/schemas.js";
+import { type AppConnections, ProtocolConnection } from "./transport.js";
+declare class ConnectionRegistry extends EventTarget implements AppConnections {
+    private connections;
+    private sockets;
+    register(socket: Socket): ProtocolConnection;
+    send(connectionId: string, message: Message): void;
+    dispose(reason: string): void;
+}
+export { ConnectionRegistry };
+//# sourceMappingURL=connection-registry.d.ts.map

package/dist/connection-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-registry.d.ts","sourceRoot":"","sources":["../src/connection-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACH,KAAK,cAAc,EAInB,kBAAkB,EACrB,MAAM,gBAAgB,CAAC;AAExB,cAAM,kBAAmB,SAAQ,WAAY,YAAW,cAAc;IAClE,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,OAAO,CAAkC;IAEjD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB;IAqB5C,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAUlD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAShC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/connection-registry.js

@@ -0,0 +1,39 @@
+import { connectionDisconnectionEvent, connectionErrorEvent, connectionRequestEvent, ProtocolConnection, } from "./transport.js";
+class ConnectionRegistry extends EventTarget {
+    connections = new Map();
+    sockets = new Map();
+    register(socket) {
+        const connection = ProtocolConnection.fromSocket(socket, {
+            onClose: () => {
+                this.connections.delete(connection.id);
+                this.sockets.delete(connection.id);
+                this.dispatchEvent(connectionDisconnectionEvent(connection));
+            },
+            onError: (error) => this.dispatchEvent(connectionErrorEvent(error)),
+        });
+        this.connections.set(connection.id, connection);
+        this.sockets.set(connection.id, socket);
+        connection.on("request", (request) => this.dispatchEvent(connectionRequestEvent(connection, request)));
+        connection.on("invalid", ({ id: badId, error }) => {
+            connection.write({ id: badId, error: error.toErrorObject() });
+        });
+        return connection;
+    }
+    send(connectionId, message) {
+        const connection = this.connections.get(connectionId);
+        if (!connection) {
+            return;
+        }
+        connection.write(message);
+    }
+    dispose(reason) {
+        for (const connection of this.connections.values()) {
+            connection.rejectPending(new Error(reason));
+        }
+        for (const socket of this.sockets.values()) {
+            socket.destroy();
+        }
+    }
+}
+export { ConnectionRegistry };
+//# sourceMappingURL=connection-registry.js.map

package/dist/connection-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-registry.js","sourceRoot":"","sources":["../src/connection-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAEH,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACrB,MAAM,gBAAgB,CAAC;AAExB,MAAM,kBAAmB,SAAQ,WAAW;IAChC,WAAW,GAAoC,IAAI,GAAG,EAAE,CAAC;IACzD,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEjD,QAAQ,CAAC,MAAc;QACnB,MAAM,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,MAAM,EAAE;YACrD,OAAO,EAAE,GAAG,EAAE;gBACV,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBACnC,IAAI,CAAC,aAAa,CAAC,4BAA4B,CAAC,UAAU,CAAC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;SACtE,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACxC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAEvG,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;YAC9C,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,YAAoB,EAAE,OAAgB;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAEtD,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,OAAO;QACX,CAAC;QAED,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,MAAc;QAClB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;IACL,CAAC;CACJ;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["import type { Socket } from \"node:net\";\nimport type { Message } from \"./protocol/schemas.js\";\nimport {\n    type AppConnections,\n    connectionDisconnectionEvent,\n    connectionErrorEvent,\n    connectionRequestEvent,\n    ProtocolConnection,\n} from \"./transport.js\";\n\nclass ConnectionRegistry extends EventTarget implements AppConnections {\n    private connections: Map<string, ProtocolConnection> = new Map();\n    private sockets: Map<string, Socket> = new Map();\n\n    register(socket: Socket): ProtocolConnection {\n        const connection = ProtocolConnection.fromSocket(socket, {\n            onClose: () => {\n                this.connections.delete(connection.id);\n                this.sockets.delete(connection.id);\n                this.dispatchEvent(connectionDisconnectionEvent(connection));\n            },\n            onError: (error) => this.dispatchEvent(connectionErrorEvent(error)),\n        });\n\n        this.connections.set(connection.id, connection);\n        this.sockets.set(connection.id, socket);\n        connection.on(\"request\", (request) => this.dispatchEvent(connectionRequestEvent(connection, request)));\n\n        connection.on(\"invalid\", ({ id: badId, error }) => {\n            connection.write({ id: badId, error: error.toErrorObject() });\n        });\n\n        return connection;\n    }\n\n    send(connectionId: string, message: Message): void {\n        const connection = this.connections.get(connectionId);\n\n        if (!connection) {\n            return;\n        }\n\n        connection.write(message);\n    }\n\n    dispose(reason: string): void {\n        for (const connection of this.connections.values()) {\n            connection.rejectPending(new Error(reason));\n        }\n\n        for (const socket of this.sockets.values()) {\n            socket.destroy();\n        }\n    }\n}\n\nexport { ConnectionRegistry };\n"]}

package/dist/internal.d.ts

@@ -0,0 +1,4 @@
+export { ErrorCode, invalidRequestError, methodNotFoundError, ProtocolError, widgetNotFoundError, } from "./protocol/errors.js";
+export { DEFAULT_SOCKET_PATH, type ParamsSchema, type Request, type SerializedWidget, type ServerInitiatedMethod, type ServerRequestParams, ServerRequestParamsSchemas, } from "./protocol/schemas.js";
+export { ProtocolConnection } from "./transport.js";
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,0BAA0B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/internal.js

@@ -0,0 +1,4 @@
+export { ErrorCode, invalidRequestError, methodNotFoundError, ProtocolError, widgetNotFoundError, } from "./protocol/errors.js";
+export { DEFAULT_SOCKET_PATH, ServerRequestParamsSchemas, } from "./protocol/schemas.js";
+export { ProtocolConnection } from "./transport.js";
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,mBAAmB,EAMnB,0BAA0B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["export {\n    ErrorCode,\n    invalidRequestError,\n    methodNotFoundError,\n    ProtocolError,\n    widgetNotFoundError,\n} from \"./protocol/errors.js\";\nexport {\n    DEFAULT_SOCKET_PATH,\n    type ParamsSchema,\n    type Request,\n    type SerializedWidget,\n    type ServerInitiatedMethod,\n    type ServerRequestParams,\n    ServerRequestParamsSchemas,\n} from \"./protocol/schemas.js\";\nexport { ProtocolConnection } from \"./transport.js\";\n"]}

package/dist/protocol/errors.d.ts

@@ -1,93 +1,31 @@
-/**
- * Error codes for MCP protocol errors.
- */
-export declare enum McpErrorCode {
-    /** Internal server error */
-    INTERNAL_ERROR = 1000,
-    /** No GTKX application is connected */
-    NO_APP_CONNECTED = 1001,
-    /** Requested application ID was not found */
-    APP_NOT_FOUND = 1002,
-    /** Widget with specified ID was not found */
-    WIDGET_NOT_FOUND = 1003,
-    /** Widget cannot be interacted with */
-    WIDGET_NOT_INTERACTABLE = 1004,
-    /** Query timed out waiting for widget */
-    QUERY_TIMEOUT = 1005,
-    /** Widget is not the expected type */
-    INVALID_WIDGET_TYPE = 1006,
-    /** Screenshot capture failed */
-    SCREENSHOT_FAILED = 1007,
-    /** IPC request timed out */
-    IPC_TIMEOUT = 1008,
-    /** Failed to serialize data */
-    SERIALIZATION_ERROR = 1009,
-    /** Request format is invalid */
-    INVALID_REQUEST = 1010,
-    /** Requested method does not exist */
-    METHOD_NOT_FOUND = 1011
-}
-/**
- * Error class for MCP protocol errors.
- *
- * Contains an error code, message, and optional additional data.
- */
-export declare class McpError extends Error {
-    /** The MCP error code */
-    readonly code: McpErrorCode;
-    /** Additional error context */
-    readonly data?: unknown;
-    constructor(code: McpErrorCode, message: string, data?: unknown);
-    /**
-     * Converts the error to an IPC-compatible format.
-     *
-     * @returns Object suitable for IPC response error field
-     */
-    toIpcError(): {
+type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+declare const ErrorCode: {
+    readonly INTERNAL_ERROR: 1000;
+    readonly NO_APP_CONNECTED: 1001;
+    readonly APP_NOT_FOUND: 1002;
+    readonly WIDGET_NOT_FOUND: 1003;
+    readonly CONNECTION_WRITE_FAILED: 1004;
+    readonly REQUEST_TIMEOUT: 1005;
+    readonly INVALID_REQUEST: 1006;
+    readonly METHOD_NOT_FOUND: 1007;
+};
+declare function isErrorCode(code: number): code is ErrorCode;
+declare function noAppConnectedError(): ProtocolError;
+declare function appNotFoundError(applicationId: string): ProtocolError;
+declare function connectionWriteFailedError(applicationId: string): ProtocolError;
+declare function widgetNotFoundError(widgetId: string): ProtocolError;
+declare function requestTimeoutError(timeout: number): ProtocolError;
+declare function invalidRequestError(reason: string): ProtocolError;
+declare function methodNotFoundError(method: string): ProtocolError;
+declare class ProtocolError extends Error {
+    code: ErrorCode;
+    data?: unknown;
+    constructor(code: ErrorCode, message: string, data?: unknown);
+    toErrorObject(): {
         code: number;
         message: string;
         data?: unknown;
     };
 }
-/**
- * Creates an error for when no GTKX application is connected.
- *
- * @returns McpError with NO_APP_CONNECTED code
- */
-export declare function noAppConnectedError(): McpError;
-/**
- * Creates an error for when a requested app is not found.
- *
- * @param appId - The application ID that was not found
- * @returns McpError with APP_NOT_FOUND code
- */
-export declare function appNotFoundError(appId: string): McpError;
-/**
- * Creates an error for when a widget is not found.
- *
- * @param widgetId - The widget ID that was not found
- * @returns McpError with WIDGET_NOT_FOUND code
- */
-export declare function widgetNotFoundError(widgetId: string): McpError;
-/**
- * Creates an error for when an IPC request times out.
- *
- * @param timeout - The timeout duration in milliseconds
- * @returns McpError with IPC_TIMEOUT code
- */
-export declare function ipcTimeoutError(timeout: number): McpError;
-/**
- * Creates an error for invalid request format.
- *
- * @param reason - Description of why the request is invalid
- * @returns McpError with INVALID_REQUEST code
- */
-export declare function invalidRequestError(reason: string): McpError;
-/**
- * Creates an error for when a method is not found.
- *
- * @param method - The method name that was not found
- * @returns McpError with METHOD_NOT_FOUND code
- */
-export declare function methodNotFoundError(method: string): McpError;
+export { ErrorCode, isErrorCode, noAppConnectedError, appNotFoundError, connectionWriteFailedError, widgetNotFoundError, requestTimeoutError, invalidRequestError, methodNotFoundError, ProtocolError, };
 //# sourceMappingURL=errors.d.ts.map