@gtkx/mcp 1.0.0 → 1.1.0

package/README.md

@@ -161,7 +161,7 @@ Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
 
 ## Status
 
-GTKX 1.0 is released.
+GTKX is stable and ready for production use.
 
 ## Contributing
 

package/dist/app-router.d.ts

@@ -6,8 +6,6 @@ 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;
@@ -31,5 +29,5 @@ declare class AppRouter extends EventTarget {
     waitForApp(timeout?: number): Promise<AppInfo>;
     sendToApp<T>(applicationId: string | undefined, method: string, params?: unknown): Promise<T>;
 }
-export { AppRouter, appRegisteredEvent, appUnregisteredEvent, type AppRegisteredEvent, type AppUnregisteredEvent };
+export { AppRouter, type AppRegisteredEvent, type AppUnregisteredEvent };
 //# sourceMappingURL=app-router.d.ts.map

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

@@ -1 +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"}
+{"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;AAYF,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,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,CAAC"}

package/dist/app-router.js

@@ -139,5 +139,5 @@ class AppRouter extends EventTarget {
         }
     }
 }
-export { AppRouter, appRegisteredEvent, appUnregisteredEvent };
+export { AppRouter };
 //# sourceMappingURL=app-router.js.map

package/dist/app-router.js.map

@@ -1 +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"]}
+{"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, type AppRegisteredEvent, type AppUnregisteredEvent };\n"]}

package/dist/reference.d.ts

@@ -23,5 +23,5 @@ type ResourceServer = Pick<McpServer, "registerResource">;
 declare const createReferenceProvider: (options: ReferenceProviderOptions) => ReferenceProvider;
 declare const buildReferenceTools: (provider: ReferenceProvider) => Tool[];
 declare const registerReferenceResources: (server: ResourceServer, provider: ReferenceProvider) => void;
-export { createReferenceProvider, buildReferenceTools, registerReferenceResources, type ReferenceApi, type ReferenceProvider, type ResolvedProject, };
+export { createReferenceProvider, buildReferenceTools, registerReferenceResources, type ReferenceProvider, };
 //# sourceMappingURL=reference.d.ts.map

package/dist/reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAsE,MAAM,eAAe,CAAC;AAEtH,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAK3F,OAAO,EAAsC,KAAK,IAAI,EAAiB,MAAM,WAAW,CAAC;AAEzF,KAAK,YAAY,GAAG,IAAI,CACpB,YAAY,EACZ,QAAQ,GAAG,mBAAmB,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CACxF,CAAC;AAEF,KAAK,aAAa,GAAG,UAAU,GAAG,kBAAkB,GAAG,KAAK,CAAC;AAE7D,KAAK,eAAe,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,KAAK,eAAe,GAAG,eAAe,GAAG;IACrC,SAAS,EAAE,YAAY,CAAC;CAC3B,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC5B,UAAU,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACrC,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC;CACtC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACrB,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACzD,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;CAClD,CAAC;AAsBF,KAAK,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAmM1D,QAAA,MAAM,uBAAuB,GAAI,SAAS,wBAAwB,KAAG,iBAgBpE,CAAC;AAqIF,QAAA,MAAM,mBAAmB,GAAI,UAAU,iBAAiB,KAAG,IAAI,EAI9D,CAAC;AAsJF,QAAA,MAAM,0BAA0B,GAAI,QAAQ,cAAc,EAAE,UAAU,iBAAiB,KAAG,IAIzF,CAAC;AAEF,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,EAC1B,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACvB,CAAC"}
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAsE,MAAM,eAAe,CAAC;AAEtH,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAK3F,OAAO,EAAsC,KAAK,IAAI,EAAiB,MAAM,WAAW,CAAC;AAEzF,KAAK,YAAY,GAAG,IAAI,CACpB,YAAY,EACZ,QAAQ,GAAG,mBAAmB,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CACxF,CAAC;AAEF,KAAK,aAAa,GAAG,UAAU,GAAG,kBAAkB,GAAG,KAAK,CAAC;AAE7D,KAAK,eAAe,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,KAAK,eAAe,GAAG,eAAe,GAAG;IACrC,SAAS,EAAE,YAAY,CAAC;CAC3B,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC5B,UAAU,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACrC,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC;CACtC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACrB,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACzD,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;CAClD,CAAC;AAsBF,KAAK,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAmM1D,QAAA,MAAM,uBAAuB,GAAI,SAAS,wBAAwB,KAAG,iBAgBpE,CAAC;AAqIF,QAAA,MAAM,mBAAmB,GAAI,UAAU,iBAAiB,KAAG,IAAI,EAI9D,CAAC;AAsJF,QAAA,MAAM,0BAA0B,GAAI,QAAQ,cAAc,EAAE,UAAU,iBAAiB,KAAG,IAIzF,CAAC;AAEF,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,EAC1B,KAAK,iBAAiB,GACzB,CAAC"}

package/dist/reference.js.map

@@ -1 +1 @@
-{"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ApiReference, type ApiSymbol, loadApiReference, resolveGirPath, resolveLibraries } from \"@gtkx/codegen\";\nimport { loadConfig } from \"@gtkx/config\";\nimport { type McpServer, ResourceTemplate } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { type CallToolResult, ErrorCode, McpError, type ReadResourceResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { existsSync, statSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { z } from \"zod\";\nimport { defineTool, textContent, textError, type Tool, type ToolArgs } from \"./tool.js\";\n\ntype ReferenceApi = Pick<\n    ApiReference,\n    \"lookup\" | \"namespaceOverview\" | \"namespaces\" | \"overview\" | \"search\" | \"symbolNames\"\n>;\n\ntype ProjectSource = \"argument\" | \"workingDirectory\" | \"app\";\n\ntype ResolvedProject = {\n    root: string;\n    source: ProjectSource;\n};\n\ntype ScopedReference = ResolvedProject & {\n    reference: ReferenceApi;\n};\n\ntype ReferenceProviderOptions = {\n    getAppRoot: () => string | undefined;\n    getWorkingDirectory?: () => string;\n};\n\ntype ReferenceProvider = {\n    get(projectRoot?: string): Promise<ScopedReference>;\n    load(project: ResolvedProject): Promise<ScopedReference>;\n    resolve(projectRoot?: string): ResolvedProject;\n};\n\ntype WatchedFile = {\n    path: string;\n    mtimeMs: number;\n    size: number;\n};\n\ntype LoadedReference = {\n    reference: ApiReference;\n    root: string;\n    watched: WatchedFile[];\n};\n\ntype CacheEntry = {\n    pending: Promise<LoadedReference>;\n    verifiedAt: number;\n    failedAt: number | undefined;\n};\n\ntype ReferenceCache = Map<string, CacheEntry>;\ntype SearchOptions = Parameters<ReferenceApi[\"search\"]>[0];\ntype ResourceServer = Pick<McpServer, \"registerResource\">;\n\nconst FRESHNESS_INTERVAL_MS = 2000;\nconst FAILURE_RETRY_MS = 5000;\nconst CONFIG_EXTENSIONS = [\"ts\", \"mts\", \"cts\", \"js\", \"mjs\", \"cjs\", \"json\"];\n\nconst PROJECT_SOURCE_LABELS: Record<ProjectSource, string> = {\n    argument: \"requested with `projectRoot`\",\n    workingDirectory: \"found from the working directory\",\n    app: \"taken from a connected app; pass `projectRoot` to document another project\",\n};\n\nconst SYMBOL_KIND = z.enum([\n    \"element\",\n    \"class\",\n    \"interface\",\n    \"record\",\n    \"enum\",\n    \"callback\",\n    \"alias\",\n    \"function\",\n    \"constant\",\n]);\n\nconst SYMBOL_DESCRIPTION =\n    \"Qualified symbol name (`Gtk.Button`, `Gtk.Orientation`, `GLib.idleAdd`), JSX element name (`GtkButton`), \" +\n    \"or bare symbol name when unambiguous (`Button`).\";\n\nconst PROJECT_ROOT_DESCRIPTION =\n    \"Directory of the GTKX project whose bindings to document, absolute or relative to the working directory. \" +\n    \"Any directory inside the project works; its `gtkx.config.ts` decides the documented libraries. Omit to use \" +\n    \"the project containing the working directory, falling back to a connected app's project.\";\n\nconst projectRootShape = {\n    projectRoot: z.string().optional().describe(PROJECT_ROOT_DESCRIPTION),\n};\n\nconst listApiShape = {\n    ...projectRootShape,\n    namespace: z\n        .string()\n        .optional()\n        .describe(\"Namespace to list (e.g. `Gtk`, `Adw`, `Gio`). Omit for an overview of all namespaces.\"),\n};\n\nconst searchApiShape = {\n    ...projectRootShape,\n    query: z.string().describe(\"Case-insensitive substring of a symbol name, e.g. `headerbar` or `orientation`.\"),\n    namespace: z.string().optional().describe(\"Restrict matches to one namespace (e.g. `Gtk`).\"),\n    kind: SYMBOL_KIND.optional().describe(\"Restrict matches to one symbol kind.\"),\n    limit: z.number().int().min(1).optional().describe(\"Maximum number of results (default: 20).\"),\n};\n\nconst apiDocsShape = {\n    ...projectRootShape,\n    symbol: z.string().describe(SYMBOL_DESCRIPTION),\n    kind: SYMBOL_KIND.optional().describe(\"Disambiguate when several kinds share the symbol name.\"),\n};\n\nconst watchFile = (path: string): WatchedFile => {\n    try {\n        const stats = statSync(path);\n\n        return { path, mtimeMs: stats.mtimeMs, size: stats.size };\n    } catch {\n        return { path, mtimeMs: -1, size: -1 };\n    }\n};\n\nconst isFresh = (loaded: LoadedReference): boolean =>\n    loaded.watched.every((file) => {\n        const current = watchFile(file.path);\n\n        return current.mtimeMs === file.mtimeMs && current.size === file.size;\n    });\n\nconst hasConfigFile = (directory: string): boolean =>\n    CONFIG_EXTENSIONS.some((extension) => existsSync(join(directory, `gtkx.config.${extension}`)));\n\nconst findProjectRoot = (start: string): string | undefined => {\n    const current = resolve(start);\n    const parent = dirname(current);\n\n    if (hasConfigFile(current)) {\n        return current;\n    }\n\n    return parent === current ? undefined : findProjectRoot(parent);\n};\n\nconst projectAt = (candidate: string, source: ProjectSource): ResolvedProject => ({\n    root: findProjectRoot(candidate) ?? resolve(candidate),\n    source,\n});\n\nconst resolveProject = (\n    workingDirectory: string,\n    getAppRoot: () => string | undefined,\n    projectRoot: string | undefined,\n): ResolvedProject => {\n    if (projectRoot !== undefined) {\n        return projectAt(projectRoot, \"argument\");\n    }\n\n    const discovered = findProjectRoot(workingDirectory);\n\n    if (discovered !== undefined) {\n        return { root: discovered, source: \"workingDirectory\" };\n    }\n\n    const appRoot = getAppRoot();\n\n    return appRoot === undefined\n        ? { root: resolve(workingDirectory), source: \"workingDirectory\" }\n        : projectAt(appRoot, \"app\");\n};\n\nconst loadReference = async (requestedRoot: string): Promise<LoadedReference> => {\n    const { config, configFile, root } = await loadConfig(requestedRoot);\n\n    if (config.codegen === false) {\n        throw new Error(\n            `codegen is disabled for the project at ${root}, so there are no generated bindings to document. ` +\n            \"Remove `codegen: false` from gtkx.config.ts to use the API reference, or point the `projectRoot` \" +\n            \"argument at another project.\",\n        );\n    }\n\n    const girPath = resolveGirPath(config.girPath);\n\n    if (girPath.length === 0) {\n        throw new Error(\n            \"No GIR search paths available. Install gobject-introspection \" +\n            \"(Linux: `sudo dnf install gobject-introspection-devel` or `sudo apt install libgirepository1.0-dev`), \" +\n            \"or set `girPath` in gtkx.config.ts.\",\n        );\n    }\n\n    const libraries = resolveLibraries(config.libraries, girPath);\n    const reference = loadApiReference({ libraries, girPath });\n    const watched = [watchFile(resolve(root, configFile)), ...reference.girFiles.map((file) => watchFile(file))];\n\n    return { reference, root, watched };\n};\n\nconst markFailed = async (entry: CacheEntry): Promise<void> => {\n    try {\n        await entry.pending;\n    } catch {\n        entry.failedAt = Date.now();\n    }\n};\n\nconst startLoad = (cache: ReferenceCache, root: string): CacheEntry => {\n    const entry: CacheEntry = { pending: loadReference(root), verifiedAt: Date.now(), failedAt: undefined };\n    void markFailed(entry);\n    cache.set(root, entry);\n\n    return entry;\n};\n\nconst isRetryDue = (entry: CacheEntry): boolean =>\n    entry.failedAt !== undefined && Date.now() - entry.failedAt >= FAILURE_RETRY_MS;\n\nconst resolveEntry = (cache: ReferenceCache, root: string): CacheEntry => {\n    const entry = cache.get(root) ?? startLoad(cache, root);\n\n    return isRetryDue(entry) ? startLoad(cache, root) : entry;\n};\n\nconst revalidate = (cache: ReferenceCache, root: string, entry: CacheEntry): CacheEntry => {\n    const current = cache.get(root);\n\n    return current === undefined || current === entry ? startLoad(cache, root) : current;\n};\n\nconst currentReference = async (cache: ReferenceCache, root: string): Promise<LoadedReference> => {\n    const entry = resolveEntry(cache, root);\n    const loaded = await entry.pending;\n\n    if (Date.now() - entry.verifiedAt < FRESHNESS_INTERVAL_MS) {\n        return loaded;\n    }\n\n    if (isFresh(loaded)) {\n        entry.verifiedAt = Date.now();\n\n        return loaded;\n    }\n\n    return revalidate(cache, root, entry).pending;\n};\n\nconst defaultWorkingDirectory = (): string => process.cwd();\n\nconst createReferenceProvider = (options: ReferenceProviderOptions): ReferenceProvider => {\n    const cache: ReferenceCache = new Map();\n    const getWorkingDirectory = options.getWorkingDirectory ?? defaultWorkingDirectory;\n\n    const resolve = (projectRoot?: string): ResolvedProject =>\n        resolveProject(getWorkingDirectory(), options.getAppRoot, projectRoot);\n\n    const load = async (project: ResolvedProject): Promise<ScopedReference> => {\n        const loaded = await currentReference(cache, project.root);\n\n        return { reference: loaded.reference, root: loaded.root, source: project.source };\n    };\n\n    const get = (projectRoot?: string): Promise<ScopedReference> => load(resolve(projectRoot));\n\n    return { get, load, resolve };\n};\n\nconst projectNote = (project: ResolvedProject): string =>\n    `Project: ${project.root} (${PROJECT_SOURCE_LABELS[project.source]})`;\n\nconst withProjectNote = (result: CallToolResult, note: string): CallToolResult => ({\n    ...result,\n    content: [...result.content, { type: \"text\", text: note }],\n});\n\nconst scopedResult = async (\n    provider: ReferenceProvider,\n    projectRoot: string | undefined,\n    render: (reference: ReferenceApi) => CallToolResult,\n): Promise<CallToolResult> => {\n    const resolved = provider.resolve(projectRoot);\n\n    try {\n        const scoped = await provider.load(resolved);\n\n        return withProjectNote(render(scoped.reference), projectNote(scoped));\n    } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n\n        return withProjectNote(textError(message), projectNote(resolved));\n    }\n};\n\nconst formatCandidates = (candidates: ApiSymbol[]): string =>\n    candidates.map((candidate) => `- ${candidate.namespace}.${candidate.name} (${candidate.kind})`).join(\"\\n\");\n\nconst buildSearchOptions = (args: ToolArgs<typeof searchApiShape>): SearchOptions => {\n    const options: SearchOptions = { query: args.query };\n\n    if (args.namespace !== undefined) {\n        options.namespace = args.namespace;\n    }\n\n    if (args.kind !== undefined) {\n        options.kinds = [args.kind];\n    }\n\n    if (args.limit !== undefined) {\n        options.limit = args.limit;\n    }\n\n    return options;\n};\n\nconst listApiResult = (reference: ReferenceApi, namespace: string | undefined): CallToolResult => {\n    if (namespace === undefined) {\n        return textContent(reference.overview());\n    }\n\n    const overview = reference.namespaceOverview(namespace);\n\n    if (overview === undefined) {\n        const names = reference\n            .namespaces()\n            .map((summary) => summary.name)\n            .join(\", \");\n\n        return textError(`Unknown namespace \"${namespace}\". Available namespaces: ${names}`);\n    }\n\n    return textContent(overview);\n};\n\nconst searchApiResult = (reference: ReferenceApi, args: ToolArgs<typeof searchApiShape>): CallToolResult => {\n    const results = reference.search(buildSearchOptions(args));\n\n    if (results.length === 0) {\n        return textContent(`No symbols matched \"${args.query}\". Try a shorter substring or \\`gtkx_list_api\\`.`);\n    }\n\n    return textContent(JSON.stringify(results, null, 2));\n};\n\nconst apiDocsResult = (reference: ReferenceApi, args: ToolArgs<typeof apiDocsShape>): CallToolResult => {\n    const result = reference.lookup(args.symbol, args.kind);\n\n    if (result.outcome === \"notFound\") {\n        return textError(`No symbol named \"${args.symbol}\". Use \\`gtkx_search_api\\` to find the right name.`);\n    }\n\n    if (result.outcome === \"ambiguous\") {\n        return textError(\n            `\"${args.symbol}\" matches several symbols. Pass a qualified name or a kind:\\n` +\n            formatCandidates(result.candidates),\n        );\n    }\n\n    return textContent(result.markdown);\n};\n\nconst listApiTool = (provider: ReferenceProvider): Tool =>\n    defineTool({\n        name: \"gtkx_list_api\",\n        title: \"List API reference\",\n        kind: \"readOnly\",\n        description:\n            \"List the project's generated GTK4 bindings API (`@gtkx/gi` and `@gtkx/jsx`). Without a namespace, \" +\n            \"returns every namespace with symbol counts; with a namespace, lists all of its symbols grouped by kind.\",\n        inputSchema: listApiShape,\n        handler: ({ namespace, projectRoot }) =>\n            scopedResult(provider, projectRoot, (reference) => listApiResult(reference, namespace)),\n    });\n\nconst searchApiTool = (provider: ReferenceProvider): Tool =>\n    defineTool({\n        name: \"gtkx_search_api\",\n        title: \"Search API reference\",\n        kind: \"readOnly\",\n        description:\n            \"Search the project's generated GTK4 bindings API by symbol name. Returns matching symbols with \" +\n            \"their namespace, kind, and a one-line summary; fetch full pages with `gtkx_get_api_docs`.\",\n        inputSchema: searchApiShape,\n        handler: (args) => scopedResult(provider, args.projectRoot, (reference) => searchApiResult(reference, args)),\n    });\n\nconst getApiDocsTool = (provider: ReferenceProvider): Tool =>\n    defineTool({\n        name: \"gtkx_get_api_docs\",\n        title: \"Get API docs\",\n        kind: \"readOnly\",\n        description:\n            \"Get the full reference page for one symbol of the project's generated GTK4 bindings: JSX elements \" +\n            \"(props, signals, methods) or `@gtkx/gi` classes, interfaces, records, enums, callbacks, aliases, \" +\n            \"functions, and constants.\",\n        inputSchema: apiDocsShape,\n        handler: (args) => scopedResult(provider, args.projectRoot, (reference) => apiDocsResult(reference, args)),\n    });\n\nconst buildReferenceTools = (provider: ReferenceProvider): Tool[] => [\n    listApiTool(provider),\n    searchApiTool(provider),\n    getApiDocsTool(provider),\n];\n\nconst markdownResource = (uri: URL, text: string): ReadResourceResult => ({\n    contents: [{ uri: uri.href, mimeType: \"text/markdown\", text }],\n});\n\nconst variableValue = (value: string | string[] | undefined): string =>\n    Array.isArray(value) ? (value[0] ?? \"\") : (value ?? \"\");\n\nconst withLoadFallback = async <T>(load: () => Promise<T>, fallback: T): Promise<T> => {\n    try {\n        return await load();\n    } catch {\n        return fallback;\n    }\n};\n\nconst namesStartingWith = (names: string[], value: string): string[] =>\n    names.filter((name) => name.toLowerCase().startsWith(value.toLowerCase()));\n\nconst completeNames = (\n    provider: ReferenceProvider,\n    value: string,\n    collect: (reference: ReferenceApi) => string[],\n): Promise<string[]> =>\n    withLoadFallback(async () => {\n        const { reference } = await provider.get();\n\n        return namesStartingWith(collect(reference), value);\n    }, []);\n\nconst namespaceCompleter =\n    (provider: ReferenceProvider) =>\n        (value: string): Promise<string[]> =>\n            completeNames(provider, value, (reference) => reference.namespaces().map((summary) => summary.name));\n\nconst completeSymbol = (provider: ReferenceProvider, namespace: string, value: string): Promise<string[]> => {\n    if (namespace.length === 0) {\n        return Promise.resolve([]);\n    }\n\n    return completeNames(provider, value, (reference) => reference.symbolNames(namespace));\n};\n\nconst resourceNotFound = (message: string): McpError => new McpError(ErrorCode.InvalidParams, message);\n\nconst symbolPage = async (\n    uri: URL,\n    provider: ReferenceProvider,\n    namespace: string,\n    symbol: string,\n): Promise<ReadResourceResult> => {\n    const { reference } = await provider.get();\n    const result = reference.lookup(`${namespace}.${symbol}`);\n\n    if (result.outcome === \"page\") {\n        return markdownResource(uri, result.markdown);\n    }\n\n    if (result.outcome === \"ambiguous\") {\n        throw resourceNotFound(\n            `\"${namespace}.${symbol}\" matches several symbols:\\n${formatCandidates(result.candidates)}`,\n        );\n    }\n\n    throw resourceNotFound(`No symbol named \"${namespace}.${symbol}\"`);\n};\n\nconst registerIndexResource = (server: ResourceServer, provider: ReferenceProvider): void => {\n    server.registerResource(\n        \"gtkx-api-reference\",\n        \"gtkx://reference/index\",\n        {\n            title: \"GTKX API reference index\",\n            description: \"Namespaces of the project's generated GTK4 bindings, with symbol and JSX element counts.\",\n            mimeType: \"text/markdown\",\n        },\n        async (uri) => {\n            const { reference } = await provider.get();\n\n            return markdownResource(uri, reference.overview());\n        },\n    );\n};\n\nconst registerNamespaceResource = (server: ResourceServer, provider: ReferenceProvider): void => {\n    server.registerResource(\n        \"gtkx-api-namespace\",\n        new ResourceTemplate(\"gtkx://reference/{namespace}\", {\n            list: () =>\n                withLoadFallback(\n                    async () => {\n                        const { reference } = await provider.get();\n\n                        return {\n                            resources: reference.namespaces().map((summary) => ({\n                                uri: `gtkx://reference/${summary.name}`,\n                                name: `${summary.name} namespace reference`,\n                                mimeType: \"text/markdown\",\n                            })),\n                        };\n                    },\n                    { resources: [] },\n                ),\n            complete: {\n                namespace: namespaceCompleter(provider),\n            },\n        }),\n        {\n            title: \"GTKX namespace reference\",\n            description: \"All symbols of one namespace of the project's generated GTK4 bindings, grouped by kind.\",\n            mimeType: \"text/markdown\",\n        },\n        async (uri, variables) => {\n            const namespace = variableValue(variables.namespace);\n            const { reference } = await provider.get();\n            const overview = reference.namespaceOverview(namespace);\n\n            if (overview === undefined) {\n                throw resourceNotFound(`Unknown namespace \"${namespace}\"`);\n            }\n\n            return markdownResource(uri, overview);\n        },\n    );\n};\n\nconst registerSymbolResource = (server: ResourceServer, provider: ReferenceProvider): void => {\n    server.registerResource(\n        \"gtkx-api-symbol\",\n        new ResourceTemplate(\"gtkx://reference/{namespace}/{symbol}\", {\n            list: undefined,\n            complete: {\n                namespace: namespaceCompleter(provider),\n                symbol: (value, context) =>\n                    completeSymbol(provider, variableValue(context?.arguments?.namespace), value),\n            },\n        }),\n        {\n            title: \"GTKX symbol reference\",\n            description:\n                \"Reference page for one symbol of the project's generated GTK4 bindings: a JSX element or a \" +\n                \"class, interface, record, enum, callback, alias, function, or constant.\",\n            mimeType: \"text/markdown\",\n        },\n        (uri, variables) =>\n            symbolPage(uri, provider, variableValue(variables.namespace), variableValue(variables.symbol)),\n    );\n};\n\nconst registerReferenceResources = (server: ResourceServer, provider: ReferenceProvider): void => {\n    registerIndexResource(server, provider);\n    registerNamespaceResource(server, provider);\n    registerSymbolResource(server, provider);\n};\n\nexport {\n    createReferenceProvider,\n    buildReferenceTools,\n    registerReferenceResources,\n    type ReferenceApi,\n    type ReferenceProvider,\n    type ResolvedProject,\n};\n"]}
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ApiReference, type ApiSymbol, loadApiReference, resolveGirPath, resolveLibraries } from \"@gtkx/codegen\";\nimport { loadConfig } from \"@gtkx/config\";\nimport { type McpServer, ResourceTemplate } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { type CallToolResult, ErrorCode, McpError, type ReadResourceResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { existsSync, statSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { z } from \"zod\";\nimport { defineTool, textContent, textError, type Tool, type ToolArgs } from \"./tool.js\";\n\ntype ReferenceApi = Pick<\n    ApiReference,\n    \"lookup\" | \"namespaceOverview\" | \"namespaces\" | \"overview\" | \"search\" | \"symbolNames\"\n>;\n\ntype ProjectSource = \"argument\" | \"workingDirectory\" | \"app\";\n\ntype ResolvedProject = {\n    root: string;\n    source: ProjectSource;\n};\n\ntype ScopedReference = ResolvedProject & {\n    reference: ReferenceApi;\n};\n\ntype ReferenceProviderOptions = {\n    getAppRoot: () => string | undefined;\n    getWorkingDirectory?: () => string;\n};\n\ntype ReferenceProvider = {\n    get(projectRoot?: string): Promise<ScopedReference>;\n    load(project: ResolvedProject): Promise<ScopedReference>;\n    resolve(projectRoot?: string): ResolvedProject;\n};\n\ntype WatchedFile = {\n    path: string;\n    mtimeMs: number;\n    size: number;\n};\n\ntype LoadedReference = {\n    reference: ApiReference;\n    root: string;\n    watched: WatchedFile[];\n};\n\ntype CacheEntry = {\n    pending: Promise<LoadedReference>;\n    verifiedAt: number;\n    failedAt: number | undefined;\n};\n\ntype ReferenceCache = Map<string, CacheEntry>;\ntype SearchOptions = Parameters<ReferenceApi[\"search\"]>[0];\ntype ResourceServer = Pick<McpServer, \"registerResource\">;\n\nconst FRESHNESS_INTERVAL_MS = 2000;\nconst FAILURE_RETRY_MS = 5000;\nconst CONFIG_EXTENSIONS = [\"ts\", \"mts\", \"cts\", \"js\", \"mjs\", \"cjs\", \"json\"];\n\nconst PROJECT_SOURCE_LABELS: Record<ProjectSource, string> = {\n    argument: \"requested with `projectRoot`\",\n    workingDirectory: \"found from the working directory\",\n    app: \"taken from a connected app; pass `projectRoot` to document another project\",\n};\n\nconst SYMBOL_KIND = z.enum([\n    \"element\",\n    \"class\",\n    \"interface\",\n    \"record\",\n    \"enum\",\n    \"callback\",\n    \"alias\",\n    \"function\",\n    \"constant\",\n]);\n\nconst SYMBOL_DESCRIPTION =\n    \"Qualified symbol name (`Gtk.Button`, `Gtk.Orientation`, `GLib.idleAdd`), JSX element name (`GtkButton`), \" +\n    \"or bare symbol name when unambiguous (`Button`).\";\n\nconst PROJECT_ROOT_DESCRIPTION =\n    \"Directory of the GTKX project whose bindings to document, absolute or relative to the working directory. \" +\n    \"Any directory inside the project works; its `gtkx.config.ts` decides the documented libraries. Omit to use \" +\n    \"the project containing the working directory, falling back to a connected app's project.\";\n\nconst projectRootShape = {\n    projectRoot: z.string().optional().describe(PROJECT_ROOT_DESCRIPTION),\n};\n\nconst listApiShape = {\n    ...projectRootShape,\n    namespace: z\n        .string()\n        .optional()\n        .describe(\"Namespace to list (e.g. `Gtk`, `Adw`, `Gio`). Omit for an overview of all namespaces.\"),\n};\n\nconst searchApiShape = {\n    ...projectRootShape,\n    query: z.string().describe(\"Case-insensitive substring of a symbol name, e.g. `headerbar` or `orientation`.\"),\n    namespace: z.string().optional().describe(\"Restrict matches to one namespace (e.g. `Gtk`).\"),\n    kind: SYMBOL_KIND.optional().describe(\"Restrict matches to one symbol kind.\"),\n    limit: z.number().int().min(1).optional().describe(\"Maximum number of results (default: 20).\"),\n};\n\nconst apiDocsShape = {\n    ...projectRootShape,\n    symbol: z.string().describe(SYMBOL_DESCRIPTION),\n    kind: SYMBOL_KIND.optional().describe(\"Disambiguate when several kinds share the symbol name.\"),\n};\n\nconst watchFile = (path: string): WatchedFile => {\n    try {\n        const stats = statSync(path);\n\n        return { path, mtimeMs: stats.mtimeMs, size: stats.size };\n    } catch {\n        return { path, mtimeMs: -1, size: -1 };\n    }\n};\n\nconst isFresh = (loaded: LoadedReference): boolean =>\n    loaded.watched.every((file) => {\n        const current = watchFile(file.path);\n\n        return current.mtimeMs === file.mtimeMs && current.size === file.size;\n    });\n\nconst hasConfigFile = (directory: string): boolean =>\n    CONFIG_EXTENSIONS.some((extension) => existsSync(join(directory, `gtkx.config.${extension}`)));\n\nconst findProjectRoot = (start: string): string | undefined => {\n    const current = resolve(start);\n    const parent = dirname(current);\n\n    if (hasConfigFile(current)) {\n        return current;\n    }\n\n    return parent === current ? undefined : findProjectRoot(parent);\n};\n\nconst projectAt = (candidate: string, source: ProjectSource): ResolvedProject => ({\n    root: findProjectRoot(candidate) ?? resolve(candidate),\n    source,\n});\n\nconst resolveProject = (\n    workingDirectory: string,\n    getAppRoot: () => string | undefined,\n    projectRoot: string | undefined,\n): ResolvedProject => {\n    if (projectRoot !== undefined) {\n        return projectAt(projectRoot, \"argument\");\n    }\n\n    const discovered = findProjectRoot(workingDirectory);\n\n    if (discovered !== undefined) {\n        return { root: discovered, source: \"workingDirectory\" };\n    }\n\n    const appRoot = getAppRoot();\n\n    return appRoot === undefined\n        ? { root: resolve(workingDirectory), source: \"workingDirectory\" }\n        : projectAt(appRoot, \"app\");\n};\n\nconst loadReference = async (requestedRoot: string): Promise<LoadedReference> => {\n    const { config, configFile, root } = await loadConfig(requestedRoot);\n\n    if (config.codegen === false) {\n        throw new Error(\n            `codegen is disabled for the project at ${root}, so there are no generated bindings to document. ` +\n            \"Remove `codegen: false` from gtkx.config.ts to use the API reference, or point the `projectRoot` \" +\n            \"argument at another project.\",\n        );\n    }\n\n    const girPath = resolveGirPath(config.girPath);\n\n    if (girPath.length === 0) {\n        throw new Error(\n            \"No GIR search paths available. Install gobject-introspection \" +\n            \"(Linux: `sudo dnf install gobject-introspection-devel` or `sudo apt install libgirepository1.0-dev`), \" +\n            \"or set `girPath` in gtkx.config.ts.\",\n        );\n    }\n\n    const libraries = resolveLibraries(config.libraries, girPath);\n    const reference = loadApiReference({ libraries, girPath });\n    const watched = [watchFile(resolve(root, configFile)), ...reference.girFiles.map((file) => watchFile(file))];\n\n    return { reference, root, watched };\n};\n\nconst markFailed = async (entry: CacheEntry): Promise<void> => {\n    try {\n        await entry.pending;\n    } catch {\n        entry.failedAt = Date.now();\n    }\n};\n\nconst startLoad = (cache: ReferenceCache, root: string): CacheEntry => {\n    const entry: CacheEntry = { pending: loadReference(root), verifiedAt: Date.now(), failedAt: undefined };\n    void markFailed(entry);\n    cache.set(root, entry);\n\n    return entry;\n};\n\nconst isRetryDue = (entry: CacheEntry): boolean =>\n    entry.failedAt !== undefined && Date.now() - entry.failedAt >= FAILURE_RETRY_MS;\n\nconst resolveEntry = (cache: ReferenceCache, root: string): CacheEntry => {\n    const entry = cache.get(root) ?? startLoad(cache, root);\n\n    return isRetryDue(entry) ? startLoad(cache, root) : entry;\n};\n\nconst revalidate = (cache: ReferenceCache, root: string, entry: CacheEntry): CacheEntry => {\n    const current = cache.get(root);\n\n    return current === undefined || current === entry ? startLoad(cache, root) : current;\n};\n\nconst currentReference = async (cache: ReferenceCache, root: string): Promise<LoadedReference> => {\n    const entry = resolveEntry(cache, root);\n    const loaded = await entry.pending;\n\n    if (Date.now() - entry.verifiedAt < FRESHNESS_INTERVAL_MS) {\n        return loaded;\n    }\n\n    if (isFresh(loaded)) {\n        entry.verifiedAt = Date.now();\n\n        return loaded;\n    }\n\n    return revalidate(cache, root, entry).pending;\n};\n\nconst defaultWorkingDirectory = (): string => process.cwd();\n\nconst createReferenceProvider = (options: ReferenceProviderOptions): ReferenceProvider => {\n    const cache: ReferenceCache = new Map();\n    const getWorkingDirectory = options.getWorkingDirectory ?? defaultWorkingDirectory;\n\n    const resolve = (projectRoot?: string): ResolvedProject =>\n        resolveProject(getWorkingDirectory(), options.getAppRoot, projectRoot);\n\n    const load = async (project: ResolvedProject): Promise<ScopedReference> => {\n        const loaded = await currentReference(cache, project.root);\n\n        return { reference: loaded.reference, root: loaded.root, source: project.source };\n    };\n\n    const get = (projectRoot?: string): Promise<ScopedReference> => load(resolve(projectRoot));\n\n    return { get, load, resolve };\n};\n\nconst projectNote = (project: ResolvedProject): string =>\n    `Project: ${project.root} (${PROJECT_SOURCE_LABELS[project.source]})`;\n\nconst withProjectNote = (result: CallToolResult, note: string): CallToolResult => ({\n    ...result,\n    content: [...result.content, { type: \"text\", text: note }],\n});\n\nconst scopedResult = async (\n    provider: ReferenceProvider,\n    projectRoot: string | undefined,\n    render: (reference: ReferenceApi) => CallToolResult,\n): Promise<CallToolResult> => {\n    const resolved = provider.resolve(projectRoot);\n\n    try {\n        const scoped = await provider.load(resolved);\n\n        return withProjectNote(render(scoped.reference), projectNote(scoped));\n    } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n\n        return withProjectNote(textError(message), projectNote(resolved));\n    }\n};\n\nconst formatCandidates = (candidates: ApiSymbol[]): string =>\n    candidates.map((candidate) => `- ${candidate.namespace}.${candidate.name} (${candidate.kind})`).join(\"\\n\");\n\nconst buildSearchOptions = (args: ToolArgs<typeof searchApiShape>): SearchOptions => {\n    const options: SearchOptions = { query: args.query };\n\n    if (args.namespace !== undefined) {\n        options.namespace = args.namespace;\n    }\n\n    if (args.kind !== undefined) {\n        options.kinds = [args.kind];\n    }\n\n    if (args.limit !== undefined) {\n        options.limit = args.limit;\n    }\n\n    return options;\n};\n\nconst listApiResult = (reference: ReferenceApi, namespace: string | undefined): CallToolResult => {\n    if (namespace === undefined) {\n        return textContent(reference.overview());\n    }\n\n    const overview = reference.namespaceOverview(namespace);\n\n    if (overview === undefined) {\n        const names = reference\n            .namespaces()\n            .map((summary) => summary.name)\n            .join(\", \");\n\n        return textError(`Unknown namespace \"${namespace}\". Available namespaces: ${names}`);\n    }\n\n    return textContent(overview);\n};\n\nconst searchApiResult = (reference: ReferenceApi, args: ToolArgs<typeof searchApiShape>): CallToolResult => {\n    const results = reference.search(buildSearchOptions(args));\n\n    if (results.length === 0) {\n        return textContent(`No symbols matched \"${args.query}\". Try a shorter substring or \\`gtkx_list_api\\`.`);\n    }\n\n    return textContent(JSON.stringify(results, null, 2));\n};\n\nconst apiDocsResult = (reference: ReferenceApi, args: ToolArgs<typeof apiDocsShape>): CallToolResult => {\n    const result = reference.lookup(args.symbol, args.kind);\n\n    if (result.outcome === \"notFound\") {\n        return textError(`No symbol named \"${args.symbol}\". Use \\`gtkx_search_api\\` to find the right name.`);\n    }\n\n    if (result.outcome === \"ambiguous\") {\n        return textError(\n            `\"${args.symbol}\" matches several symbols. Pass a qualified name or a kind:\\n` +\n            formatCandidates(result.candidates),\n        );\n    }\n\n    return textContent(result.markdown);\n};\n\nconst listApiTool = (provider: ReferenceProvider): Tool =>\n    defineTool({\n        name: \"gtkx_list_api\",\n        title: \"List API reference\",\n        kind: \"readOnly\",\n        description:\n            \"List the project's generated GTK4 bindings API (`@gtkx/gi` and `@gtkx/jsx`). Without a namespace, \" +\n            \"returns every namespace with symbol counts; with a namespace, lists all of its symbols grouped by kind.\",\n        inputSchema: listApiShape,\n        handler: ({ namespace, projectRoot }) =>\n            scopedResult(provider, projectRoot, (reference) => listApiResult(reference, namespace)),\n    });\n\nconst searchApiTool = (provider: ReferenceProvider): Tool =>\n    defineTool({\n        name: \"gtkx_search_api\",\n        title: \"Search API reference\",\n        kind: \"readOnly\",\n        description:\n            \"Search the project's generated GTK4 bindings API by symbol name. Returns matching symbols with \" +\n            \"their namespace, kind, and a one-line summary; fetch full pages with `gtkx_get_api_docs`.\",\n        inputSchema: searchApiShape,\n        handler: (args) => scopedResult(provider, args.projectRoot, (reference) => searchApiResult(reference, args)),\n    });\n\nconst getApiDocsTool = (provider: ReferenceProvider): Tool =>\n    defineTool({\n        name: \"gtkx_get_api_docs\",\n        title: \"Get API docs\",\n        kind: \"readOnly\",\n        description:\n            \"Get the full reference page for one symbol of the project's generated GTK4 bindings: JSX elements \" +\n            \"(props, signals, methods) or `@gtkx/gi` classes, interfaces, records, enums, callbacks, aliases, \" +\n            \"functions, and constants.\",\n        inputSchema: apiDocsShape,\n        handler: (args) => scopedResult(provider, args.projectRoot, (reference) => apiDocsResult(reference, args)),\n    });\n\nconst buildReferenceTools = (provider: ReferenceProvider): Tool[] => [\n    listApiTool(provider),\n    searchApiTool(provider),\n    getApiDocsTool(provider),\n];\n\nconst markdownResource = (uri: URL, text: string): ReadResourceResult => ({\n    contents: [{ uri: uri.href, mimeType: \"text/markdown\", text }],\n});\n\nconst variableValue = (value: string | string[] | undefined): string =>\n    Array.isArray(value) ? (value[0] ?? \"\") : (value ?? \"\");\n\nconst withLoadFallback = async <T>(load: () => Promise<T>, fallback: T): Promise<T> => {\n    try {\n        return await load();\n    } catch {\n        return fallback;\n    }\n};\n\nconst namesStartingWith = (names: string[], value: string): string[] =>\n    names.filter((name) => name.toLowerCase().startsWith(value.toLowerCase()));\n\nconst completeNames = (\n    provider: ReferenceProvider,\n    value: string,\n    collect: (reference: ReferenceApi) => string[],\n): Promise<string[]> =>\n    withLoadFallback(async () => {\n        const { reference } = await provider.get();\n\n        return namesStartingWith(collect(reference), value);\n    }, []);\n\nconst namespaceCompleter =\n    (provider: ReferenceProvider) =>\n        (value: string): Promise<string[]> =>\n            completeNames(provider, value, (reference) => reference.namespaces().map((summary) => summary.name));\n\nconst completeSymbol = (provider: ReferenceProvider, namespace: string, value: string): Promise<string[]> => {\n    if (namespace.length === 0) {\n        return Promise.resolve([]);\n    }\n\n    return completeNames(provider, value, (reference) => reference.symbolNames(namespace));\n};\n\nconst resourceNotFound = (message: string): McpError => new McpError(ErrorCode.InvalidParams, message);\n\nconst symbolPage = async (\n    uri: URL,\n    provider: ReferenceProvider,\n    namespace: string,\n    symbol: string,\n): Promise<ReadResourceResult> => {\n    const { reference } = await provider.get();\n    const result = reference.lookup(`${namespace}.${symbol}`);\n\n    if (result.outcome === \"page\") {\n        return markdownResource(uri, result.markdown);\n    }\n\n    if (result.outcome === \"ambiguous\") {\n        throw resourceNotFound(\n            `\"${namespace}.${symbol}\" matches several symbols:\\n${formatCandidates(result.candidates)}`,\n        );\n    }\n\n    throw resourceNotFound(`No symbol named \"${namespace}.${symbol}\"`);\n};\n\nconst registerIndexResource = (server: ResourceServer, provider: ReferenceProvider): void => {\n    server.registerResource(\n        \"gtkx-api-reference\",\n        \"gtkx://reference/index\",\n        {\n            title: \"GTKX API reference index\",\n            description: \"Namespaces of the project's generated GTK4 bindings, with symbol and JSX element counts.\",\n            mimeType: \"text/markdown\",\n        },\n        async (uri) => {\n            const { reference } = await provider.get();\n\n            return markdownResource(uri, reference.overview());\n        },\n    );\n};\n\nconst registerNamespaceResource = (server: ResourceServer, provider: ReferenceProvider): void => {\n    server.registerResource(\n        \"gtkx-api-namespace\",\n        new ResourceTemplate(\"gtkx://reference/{namespace}\", {\n            list: () =>\n                withLoadFallback(\n                    async () => {\n                        const { reference } = await provider.get();\n\n                        return {\n                            resources: reference.namespaces().map((summary) => ({\n                                uri: `gtkx://reference/${summary.name}`,\n                                name: `${summary.name} namespace reference`,\n                                mimeType: \"text/markdown\",\n                            })),\n                        };\n                    },\n                    { resources: [] },\n                ),\n            complete: {\n                namespace: namespaceCompleter(provider),\n            },\n        }),\n        {\n            title: \"GTKX namespace reference\",\n            description: \"All symbols of one namespace of the project's generated GTK4 bindings, grouped by kind.\",\n            mimeType: \"text/markdown\",\n        },\n        async (uri, variables) => {\n            const namespace = variableValue(variables.namespace);\n            const { reference } = await provider.get();\n            const overview = reference.namespaceOverview(namespace);\n\n            if (overview === undefined) {\n                throw resourceNotFound(`Unknown namespace \"${namespace}\"`);\n            }\n\n            return markdownResource(uri, overview);\n        },\n    );\n};\n\nconst registerSymbolResource = (server: ResourceServer, provider: ReferenceProvider): void => {\n    server.registerResource(\n        \"gtkx-api-symbol\",\n        new ResourceTemplate(\"gtkx://reference/{namespace}/{symbol}\", {\n            list: undefined,\n            complete: {\n                namespace: namespaceCompleter(provider),\n                symbol: (value, context) =>\n                    completeSymbol(provider, variableValue(context?.arguments?.namespace), value),\n            },\n        }),\n        {\n            title: \"GTKX symbol reference\",\n            description:\n                \"Reference page for one symbol of the project's generated GTK4 bindings: a JSX element or a \" +\n                \"class, interface, record, enum, callback, alias, function, or constant.\",\n            mimeType: \"text/markdown\",\n        },\n        (uri, variables) =>\n            symbolPage(uri, provider, variableValue(variables.namespace), variableValue(variables.symbol)),\n    );\n};\n\nconst registerReferenceResources = (server: ResourceServer, provider: ReferenceProvider): void => {\n    registerIndexResource(server, provider);\n    registerNamespaceResource(server, provider);\n    registerSymbolResource(server, provider);\n};\n\nexport {\n    createReferenceProvider,\n    buildReferenceTools,\n    registerReferenceResources,\n    type ReferenceProvider,\n};\n"]}

package/dist/server.d.ts

@@ -1,14 +1,5 @@
 import { type Logger } from "@gtkx/utils";
-type CreateMcpServerOptions = {
-    socketPath?: string;
-    version: string;
-};
-type McpServerHandle = {
-    start(): Promise<void>;
-    stop(): Promise<void>;
-};
 declare const log: Logger;
-declare const createMcpServer: (options: CreateMcpServerOptions) => McpServerHandle;
 declare function main(): Promise<void>;
-export { log, createMcpServer, main };
+export { log, main };
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AA8BjF,KAAK,sBAAsB,GAAG;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG;IACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB,CAAC;AAeF,QAAA,MAAM,GAAG,EAAE,MAA4B,CAAC;AAgVxC,QAAA,MAAM,eAAe,GAAI,SAAS,sBAAsB,KAAG,eAsB1D,CAAC;AAEF,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAQnC;AAED,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAoDjF,QAAA,MAAM,GAAG,EAAE,MAA4B,CAAC;AAwWxC,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAQnC;AAED,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC"}

package/dist/server.js

@@ -1,16 +1,15 @@
 import { createLogger, installGracefulShutdown } from "@gtkx/utils";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createRequire } from "node:module";
 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 { buildReferenceTools, createReferenceProvider, registerReferenceResources, } from "./reference.js";
 import { SocketServer } from "./socket-server.js";
 import { defineTool, imageContent, registerTool, textContent } from "./tool.js";
-const require = createRequire(import.meta.url);
-const { version } = require("../package.json");
+const { version } = packageManifest;
 const log = createLogger("mcp");
 const APPLICATION_ID_DESCRIPTION = "Application ID to query. If not specified, uses the first connected app.";
 const WIDGET_ID_DESCRIPTION = "Widget ID obtained from `gtkx_get_widget_tree`, `gtkx_query_widgets`, or `gtkx_get_widget_props`. " +
@@ -303,5 +302,5 @@ async function main() {
     });
     await server.start();
 }
-export { log, createMcpServer, main };
+export { log, main };
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/socket-server.d.ts

@@ -1,5 +1,4 @@
 import type { ConnectionRegistry } from "./connection-registry.js";
-declare const withClaimLock: <T>(socketPath: string, action: () => Promise<T> | T) => Promise<T>;
 declare class SocketServer {
     private server;
     private socketPath;
@@ -16,5 +15,5 @@ declare class SocketServer {
     start(): Promise<void>;
     stop(): Promise<void>;
 }
-export { SocketServer, withClaimLock };
+export { SocketServer };
 //# sourceMappingURL=socket-server.d.ts.map

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

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

package/dist/socket-server.js

@@ -267,5 +267,5 @@ class SocketServer {
         await this.release();
     }
 }
-export { SocketServer, withClaimLock };
+export { SocketServer };
 //# sourceMappingURL=socket-server.js.map

package/dist/socket-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"socket-server.js","sourceRoot":"","sources":["../src/socket-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAMtD,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAC9C,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAErC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CACxC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACpB,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEP,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAiB,EAAE,CACtD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACpB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;QACd,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEP,MAAM,SAAS,GAAG,CAAC,UAAkB,EAAU,EAAE,CAC7C,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,cAAc,GAAG,CAAC,UAAkB,EAAU,EAAE;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE3D,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;AAClF,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,OAAe,EAA8B,EAAE,CAC7D,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACpB,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;IAChC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAClB,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE;QACtB,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEP,MAAM,iBAAiB,GAAG,CAAC,UAAkB,EAAS,EAAE,CACpD,IAAI,KAAK,CACL,oEAAoE,UAAU,IAAI;IAClF,sDAAsD,CACzD,CAAC;AAEN,MAAM,gBAAgB,GAAG,KAAK,EAAE,UAAkB,EAA8B,EAAE;IAC9E,MAAM,OAAO,GAAG,GAAG,iBAAiB,GAAG,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,qBAAqB,CAAC;IACpD,IAAI,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEnC,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC5C,MAAM,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACvC,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,KAAK,EAAE,IAAuB,EAAiB,EAAE;IACtE,IAAI,IAAI,EAAE,CAAC;QACP,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,KAAK,EAAK,UAAkB,EAAE,MAA4B,EAAc,EAAE;IAC5F,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEhD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC;QACD,OAAO,MAAM,MAAM,EAAE,CAAC;IAC1B,CAAC;YAAS,CAAC;QACP,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAmB,EAAE;IACjD,IAAI,CAAC;QACD,OAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAiB,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC;AAElF,MAAM,oBAAoB,GAAG,CAAC,KAA4B,EAAgB,EAAE;IACxE,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,MAAc,EAAyB,EAAE,CAC1D,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACpB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAG,CAAC,OAAqB,EAAQ,EAAE;QAC/C,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;QACjD,UAAU,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEP,MAAM,oBAAoB,GAAG,KAAK,EAAE,MAAc,EAAyB,EAAE;IACzE,IAAI,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAExC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,cAAc,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACzF,MAAM,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,UAAkB,EAAS,EAAE,CACpD,IAAI,KAAK,CACL,wCAAwC,UAAU,IAAI;IACtD,mGAAmG,CACtG,CAAC;AAEN,MAAM,mBAAmB,GAAG,CAAC,UAAkB,EAAE,IAAY,EAAS,EAAE,CACpE,IAAI,KAAK,CACL,uDAAuD,UAAU,4BAA4B,IAAI,IAAI;IACrG,iGAAiG;IACjG,8DAA8D,CACjE,CAAC;AAEN,MAAM,kBAAkB,GAAG,CAAC,UAAkB,EAAS,EAAE,CACrD,IAAI,KAAK,CACL,4BAA4B,UAAU,iCAAiC;IACvE,sFAAsF,CACzF,CAAC;AAEN,MAAM,kBAAkB,GAAG,CAAC,UAAkB,EAAE,IAAY,EAAS,EAAE,CACnE,IAAI,KAAK,CACL,2CAA2C,UAAU,2BAA2B,IAAI,IAAI;IACxF,kDAAkD,CACrD,CAAC;AAEN,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,KAAa,EAAQ,EAAE;IACxD,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;QAC7B,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,KAAK,EAAE,MAAc,EAAwB,EAAE;IAClE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE/B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAEnD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,KAAK,EAAE,UAAkB,EAAiB,EAAE;IAClE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;IAEjD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,WAAmB,EAAE,UAAkB,EAAgB,EAAE;IAC9E,IAAI,CAAC;QACD,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAErC,OAAO,WAAW,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,UAAU,CAAC;QACtB,CAAC;QAED,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,KAAK,EAAE,WAAmB,EAAE,UAAkB,EAA0B,EAAE;IAC5F,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,cAAc,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAEpC,IAAI,eAAe,CAAC,WAAW,EAAE,UAAU,CAAC,KAAK,WAAW,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YACnC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAExC,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,KAAK,EAAE,UAAkB,EAAE,KAAa,EAAiB,EAAE;IACjF,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEhD,IAAI,CAAC;QACD,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;YAAS,CAAC;QACP,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,YAAY;IACN,MAAM,GAAsB,IAAI,CAAC;IACjC,UAAU,CAAS;IACnB,QAAQ,CAAqB;IAC7B,UAAU,GAAkB,IAAI,CAAC;IACjC,OAAO,GAAyB,IAAI,CAAC;IAE7C,YAAY,QAA4B,EAAE,aAAqB,mBAAmB;QAC9E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAEO,MAAM,CAAC,WAAmB;QAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5E,IAAI,WAAW,GAAG,KAAK,CAAC;YAExB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACzB,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAEzD,IAAI,CAAC,WAAW,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE;gBAC5B,WAAW,GAAG,IAAI,CAAC;gBACnB,OAAO,CAAC,MAAM,CAAC,CAAC;YACpB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,WAAmB;QAC7C,IAAI,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,KAA8B,CAAC;YAC/C,MAAM,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/E,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,IAAI;QACd,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAEvD,IAAI,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAEO,IAAI;QACR,OAAO,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAEO,KAAK,CAAC,aAAa;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAEvB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,IAAI,CAAC;YACD,MAAM,OAAO,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,CAAC;YAED,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO;QACX,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACzC,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;CACJ;AAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport * as net from \"node:net\";\nimport { basename, dirname, join, resolve as resolvePath } from \"node:path\";\nimport type { ConnectionRegistry } from \"./connection-registry.js\";\nimport { DEFAULT_SOCKET_PATH } from \"./protocol/schemas.js\";\nimport { connectionErrorEvent } from \"./transport.js\";\n\ntype ProbeOutcome = { kind: \"live\" } | { kind: \"unknown\"; code: string } | { kind: \"vacant\" };\ntype PathVerdict = ProbeOutcome | { kind: \"directory\" };\ntype ClaimOutcome = \"occupied\" | \"published\";\n\nconst PROBE_TIMEOUT_MS = 1000;\nconst PROBE_ATTEMPTS = 3;\nconst PROBE_RETRY_DELAY_MS = 50;\nconst CLAIM_ATTEMPTS = 3;\nconst CLAIM_LOCK_PREFIX = \"\\0gtkx-mcp-claim-\";\nconst CLAIM_LOCK_RETRY_DELAY_MS = 25;\nconst CLAIM_LOCK_TIMEOUT_MS = 15_000;\n\nconst delay = (ms: number): Promise<void> =>\n    new Promise((resolve) => {\n        setTimeout(resolve, ms);\n    });\n\nconst closeServer = (server: net.Server): Promise<void> =>\n    new Promise((resolve) => {\n        server.close(() => {\n            resolve();\n        });\n    });\n\nconst digestFor = (socketPath: string): string =>\n    createHash(\"sha256\").update(resolvePath(socketPath)).digest(\"hex\");\n\nconst privatePathFor = (socketPath: string): string => {\n    const width = Math.max(1, basename(socketPath).length - 1);\n\n    return join(dirname(socketPath), `.${digestFor(socketPath).slice(0, width)}`);\n};\n\nconst bindLock = (address: string): Promise<net.Server | null> =>\n    new Promise((resolve) => {\n        const lock = net.createServer();\n        let isBound = false;\n\n        lock.on(\"error\", () => {\n            if (!isBound) {\n                resolve(null);\n            }\n        });\n\n        lock.listen(address, () => {\n            isBound = true;\n            resolve(lock);\n        });\n    });\n\nconst claimBlockedError = (socketPath: string): Error =>\n    new Error(\n        `Timed out waiting for another GTKX MCP server to finish claiming ${socketPath}. ` +\n        \"Retry once no other server is starting on that path.\",\n    );\n\nconst acquireClaimLock = async (socketPath: string): Promise<net.Server | null> => {\n    const address = `${CLAIM_LOCK_PREFIX}${digestFor(socketPath)}`;\n    const deadline = Date.now() + CLAIM_LOCK_TIMEOUT_MS;\n    let lock = await bindLock(address);\n\n    while (lock === null && Date.now() < deadline) {\n        await delay(CLAIM_LOCK_RETRY_DELAY_MS);\n        lock = await bindLock(address);\n    }\n\n    return lock;\n};\n\nconst releaseClaimLock = async (lock: net.Server | null): Promise<void> => {\n    if (lock) {\n        await closeServer(lock);\n    }\n};\n\nconst withClaimLock = async <T>(socketPath: string, action: () => Promise<T> | T): Promise<T> => {\n    const lock = await acquireClaimLock(socketPath);\n\n    if (lock === null) {\n        throw claimBlockedError(socketPath);\n    }\n\n    try {\n        return await action();\n    } finally {\n        await closeServer(lock);\n    }\n};\n\nconst entryFor = (target: string): fs.Stats | null => {\n    try {\n        return fs.lstatSync(target);\n    } catch {\n        return null;\n    }\n};\n\nconst inodeFor = (target: string): number | null => entryFor(target)?.ino ?? null;\n\nconst outcomeForProbeError = (error: NodeJS.ErrnoException): ProbeOutcome => {\n    if (error.code === \"ECONNREFUSED\" || error.code === \"ENOENT\") {\n        return { kind: \"vacant\" };\n    }\n\n    return { kind: \"unknown\", code: error.code ?? error.message };\n};\n\nconst probeSocket = (target: string): Promise<ProbeOutcome> =>\n    new Promise((resolve) => {\n        const probe = net.connect({ path: target, timeout: PROBE_TIMEOUT_MS });\n\n        const settleWith = (outcome: ProbeOutcome): void => {\n            probe.destroy();\n            resolve(outcome);\n        };\n\n        probe.once(\"connect\", () => {\n            settleWith({ kind: \"live\" });\n        });\n\n        probe.once(\"timeout\", () => {\n            settleWith({ kind: \"unknown\", code: \"ETIMEDOUT\" });\n        });\n\n        probe.once(\"error\", (error: NodeJS.ErrnoException) => {\n            settleWith(outcomeForProbeError(error));\n        });\n    });\n\nconst probeUntilConclusive = async (target: string): Promise<ProbeOutcome> => {\n    let outcome = await probeSocket(target);\n\n    for (let attempt = 1; attempt < PROBE_ATTEMPTS && outcome.kind === \"unknown\"; attempt += 1) {\n        await delay(PROBE_RETRY_DELAY_MS);\n        outcome = await probeSocket(target);\n    }\n\n    return outcome;\n};\n\nconst alreadyOwnedError = (socketPath: string): Error =>\n    new Error(\n        `Another GTKX MCP server already owns ${socketPath}. ` +\n        \"Stop the other server (for example, the GTKX MCP server of another active session) and reconnect.\",\n    );\n\nconst undecidedOwnerError = (socketPath: string, code: string): Error =>\n    new Error(\n        `Could not tell whether another GTKX MCP server owns ${socketPath}: probing it failed with ${code}. ` +\n        \"Leaving the socket in place instead of removing one that may still be serving another session. \" +\n        \"Retry, or delete the file by hand once no server is running.\",\n    );\n\nconst directoryPathError = (socketPath: string): Error =>\n    new Error(\n        `The GTKX MCP socket path ${socketPath} is a directory, not a socket. ` +\n        \"Remove it, or point XDG_RUNTIME_DIR at a directory where GTKX can create its socket.\",\n    );\n\nconst listenFailureError = (socketPath: string, code: string): Error =>\n    new Error(\n        `Could not create the GTKX MCP socket at ${socketPath}: listening failed with ${code}. ` +\n        \"Check that its directory exists and is writable.\",\n    );\n\nconst removeEntry = (target: string, inode: number): void => {\n    if (inodeFor(target) === inode) {\n        fs.rmSync(target, { force: true });\n    }\n};\n\nconst clearStalePath = async (target: string): Promise<PathVerdict> => {\n    const entry = entryFor(target);\n\n    if (entry === null) {\n        return { kind: \"vacant\" };\n    }\n\n    if (entry.isDirectory()) {\n        return { kind: \"directory\" };\n    }\n\n    const outcome = await probeUntilConclusive(target);\n\n    if (outcome.kind === \"vacant\") {\n        removeEntry(target, entry.ino);\n    }\n\n    return outcome;\n};\n\nconst requireVacantPath = async (socketPath: string): Promise<void> => {\n    const verdict = await clearStalePath(socketPath);\n\n    if (verdict.kind === \"live\") {\n        throw alreadyOwnedError(socketPath);\n    }\n\n    if (verdict.kind === \"directory\") {\n        throw directoryPathError(socketPath);\n    }\n\n    if (verdict.kind === \"unknown\") {\n        throw undecidedOwnerError(socketPath, verdict.code);\n    }\n};\n\nconst claimSocketPath = (privatePath: string, socketPath: string): ClaimOutcome => {\n    try {\n        fs.linkSync(privatePath, socketPath);\n\n        return \"published\";\n    } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"EEXIST\") {\n            return \"occupied\";\n        }\n\n        throw error;\n    }\n};\n\nconst publishSocket = async (privatePath: string, socketPath: string): Promise<number | null> => {\n    for (let attempt = 1; attempt <= CLAIM_ATTEMPTS; attempt += 1) {\n        await requireVacantPath(socketPath);\n\n        if (claimSocketPath(privatePath, socketPath) === \"published\") {\n            const inode = inodeFor(socketPath);\n            fs.rmSync(privatePath, { force: true });\n\n            return inode;\n        }\n    }\n\n    throw alreadyOwnedError(socketPath);\n};\n\nconst releaseSocketPath = async (socketPath: string, inode: number): Promise<void> => {\n    const lock = await acquireClaimLock(socketPath);\n\n    try {\n        removeEntry(socketPath, inode);\n    } finally {\n        await releaseClaimLock(lock);\n    }\n};\n\nclass SocketServer {\n    private server: net.Server | null = null;\n    private socketPath: string;\n    private registry: ConnectionRegistry;\n    private boundInode: number | null = null;\n    private startup: Promise<void> | null = null;\n\n    constructor(registry: ConnectionRegistry, socketPath: string = DEFAULT_SOCKET_PATH) {\n        this.registry = registry;\n        this.socketPath = socketPath;\n    }\n\n    private listen(privatePath: string): Promise<net.Server> {\n        return new Promise((resolve, reject) => {\n            const server = net.createServer((socket) => this.registry.register(socket));\n            let isListening = false;\n\n            server.on(\"error\", (error) => {\n                this.registry.dispatchEvent(connectionErrorEvent(error));\n\n                if (!isListening) {\n                    reject(error);\n                }\n            });\n\n            server.listen(privatePath, () => {\n                isListening = true;\n                resolve(server);\n            });\n        });\n    }\n\n    private async listenPrivately(privatePath: string): Promise<net.Server> {\n        try {\n            return await this.listen(privatePath);\n        } catch (error) {\n            const failure = error as NodeJS.ErrnoException;\n            throw listenFailureError(this.socketPath, failure.code ?? failure.message);\n        }\n    }\n\n    private async bind(): Promise<void> {\n        const privatePath = privatePathFor(this.socketPath);\n        await clearStalePath(privatePath);\n        const server = await this.listenPrivately(privatePath);\n\n        try {\n            this.boundInode = await publishSocket(privatePath, this.socketPath);\n            this.server = server;\n        } catch (error) {\n            await closeServer(server);\n            throw error;\n        }\n    }\n\n    private open(): Promise<void> {\n        return withClaimLock(this.socketPath, () => this.bind());\n    }\n\n    private async settleStartup(): Promise<void> {\n        const startup = this.startup;\n        this.startup = null;\n\n        if (startup) {\n            await Promise.allSettled([startup]);\n        }\n    }\n\n    private async release(): Promise<void> {\n        const inode = this.boundInode;\n        this.boundInode = null;\n\n        if (inode !== null) {\n            await releaseSocketPath(this.socketPath, inode);\n        }\n    }\n\n    async start(): Promise<void> {\n        this.startup ??= this.open();\n        const startup = this.startup;\n\n        try {\n            await startup;\n        } catch (error) {\n            if (this.startup === startup) {\n                this.startup = null;\n            }\n\n            throw error;\n        }\n    }\n\n    async stop(): Promise<void> {\n        await this.settleStartup();\n        const server = this.server;\n\n        if (!server) {\n            return;\n        }\n\n        this.server = null;\n        this.registry.dispose(\"Server stopping\");\n        await closeServer(server);\n        await this.release();\n    }\n}\n\nexport { SocketServer, withClaimLock };\n"]}
+{"version":3,"file":"socket-server.js","sourceRoot":"","sources":["../src/socket-server.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport * as net from \"node:net\";\nimport { basename, dirname, join, resolve as resolvePath } from \"node:path\";\nimport type { ConnectionRegistry } from \"./connection-registry.js\";\nimport { DEFAULT_SOCKET_PATH } from \"./protocol/schemas.js\";\nimport { connectionErrorEvent } from \"./transport.js\";\n\ntype ProbeOutcome = { kind: \"live\" } | { kind: \"unknown\"; code: string } | { kind: \"vacant\" };\ntype PathVerdict = ProbeOutcome | { kind: \"directory\" };\ntype ClaimOutcome = \"occupied\" | \"published\";\n\nconst PROBE_TIMEOUT_MS = 1000;\nconst PROBE_ATTEMPTS = 3;\nconst PROBE_RETRY_DELAY_MS = 50;\nconst CLAIM_ATTEMPTS = 3;\nconst CLAIM_LOCK_PREFIX = \"\\0gtkx-mcp-claim-\";\nconst CLAIM_LOCK_RETRY_DELAY_MS = 25;\nconst CLAIM_LOCK_TIMEOUT_MS = 15_000;\n\nconst delay = (ms: number): Promise<void> =>\n    new Promise((resolve) => {\n        setTimeout(resolve, ms);\n    });\n\nconst closeServer = (server: net.Server): Promise<void> =>\n    new Promise((resolve) => {\n        server.close(() => {\n            resolve();\n        });\n    });\n\nconst digestFor = (socketPath: string): string =>\n    createHash(\"sha256\").update(resolvePath(socketPath)).digest(\"hex\");\n\nconst privatePathFor = (socketPath: string): string => {\n    const width = Math.max(1, basename(socketPath).length - 1);\n\n    return join(dirname(socketPath), `.${digestFor(socketPath).slice(0, width)}`);\n};\n\nconst bindLock = (address: string): Promise<net.Server | null> =>\n    new Promise((resolve) => {\n        const lock = net.createServer();\n        let isBound = false;\n\n        lock.on(\"error\", () => {\n            if (!isBound) {\n                resolve(null);\n            }\n        });\n\n        lock.listen(address, () => {\n            isBound = true;\n            resolve(lock);\n        });\n    });\n\nconst claimBlockedError = (socketPath: string): Error =>\n    new Error(\n        `Timed out waiting for another GTKX MCP server to finish claiming ${socketPath}. ` +\n        \"Retry once no other server is starting on that path.\",\n    );\n\nconst acquireClaimLock = async (socketPath: string): Promise<net.Server | null> => {\n    const address = `${CLAIM_LOCK_PREFIX}${digestFor(socketPath)}`;\n    const deadline = Date.now() + CLAIM_LOCK_TIMEOUT_MS;\n    let lock = await bindLock(address);\n\n    while (lock === null && Date.now() < deadline) {\n        await delay(CLAIM_LOCK_RETRY_DELAY_MS);\n        lock = await bindLock(address);\n    }\n\n    return lock;\n};\n\nconst releaseClaimLock = async (lock: net.Server | null): Promise<void> => {\n    if (lock) {\n        await closeServer(lock);\n    }\n};\n\nconst withClaimLock = async <T>(socketPath: string, action: () => Promise<T> | T): Promise<T> => {\n    const lock = await acquireClaimLock(socketPath);\n\n    if (lock === null) {\n        throw claimBlockedError(socketPath);\n    }\n\n    try {\n        return await action();\n    } finally {\n        await closeServer(lock);\n    }\n};\n\nconst entryFor = (target: string): fs.Stats | null => {\n    try {\n        return fs.lstatSync(target);\n    } catch {\n        return null;\n    }\n};\n\nconst inodeFor = (target: string): number | null => entryFor(target)?.ino ?? null;\n\nconst outcomeForProbeError = (error: NodeJS.ErrnoException): ProbeOutcome => {\n    if (error.code === \"ECONNREFUSED\" || error.code === \"ENOENT\") {\n        return { kind: \"vacant\" };\n    }\n\n    return { kind: \"unknown\", code: error.code ?? error.message };\n};\n\nconst probeSocket = (target: string): Promise<ProbeOutcome> =>\n    new Promise((resolve) => {\n        const probe = net.connect({ path: target, timeout: PROBE_TIMEOUT_MS });\n\n        const settleWith = (outcome: ProbeOutcome): void => {\n            probe.destroy();\n            resolve(outcome);\n        };\n\n        probe.once(\"connect\", () => {\n            settleWith({ kind: \"live\" });\n        });\n\n        probe.once(\"timeout\", () => {\n            settleWith({ kind: \"unknown\", code: \"ETIMEDOUT\" });\n        });\n\n        probe.once(\"error\", (error: NodeJS.ErrnoException) => {\n            settleWith(outcomeForProbeError(error));\n        });\n    });\n\nconst probeUntilConclusive = async (target: string): Promise<ProbeOutcome> => {\n    let outcome = await probeSocket(target);\n\n    for (let attempt = 1; attempt < PROBE_ATTEMPTS && outcome.kind === \"unknown\"; attempt += 1) {\n        await delay(PROBE_RETRY_DELAY_MS);\n        outcome = await probeSocket(target);\n    }\n\n    return outcome;\n};\n\nconst alreadyOwnedError = (socketPath: string): Error =>\n    new Error(\n        `Another GTKX MCP server already owns ${socketPath}. ` +\n        \"Stop the other server (for example, the GTKX MCP server of another active session) and reconnect.\",\n    );\n\nconst undecidedOwnerError = (socketPath: string, code: string): Error =>\n    new Error(\n        `Could not tell whether another GTKX MCP server owns ${socketPath}: probing it failed with ${code}. ` +\n        \"Leaving the socket in place instead of removing one that may still be serving another session. \" +\n        \"Retry, or delete the file by hand once no server is running.\",\n    );\n\nconst directoryPathError = (socketPath: string): Error =>\n    new Error(\n        `The GTKX MCP socket path ${socketPath} is a directory, not a socket. ` +\n        \"Remove it, or point XDG_RUNTIME_DIR at a directory where GTKX can create its socket.\",\n    );\n\nconst listenFailureError = (socketPath: string, code: string): Error =>\n    new Error(\n        `Could not create the GTKX MCP socket at ${socketPath}: listening failed with ${code}. ` +\n        \"Check that its directory exists and is writable.\",\n    );\n\nconst removeEntry = (target: string, inode: number): void => {\n    if (inodeFor(target) === inode) {\n        fs.rmSync(target, { force: true });\n    }\n};\n\nconst clearStalePath = async (target: string): Promise<PathVerdict> => {\n    const entry = entryFor(target);\n\n    if (entry === null) {\n        return { kind: \"vacant\" };\n    }\n\n    if (entry.isDirectory()) {\n        return { kind: \"directory\" };\n    }\n\n    const outcome = await probeUntilConclusive(target);\n\n    if (outcome.kind === \"vacant\") {\n        removeEntry(target, entry.ino);\n    }\n\n    return outcome;\n};\n\nconst requireVacantPath = async (socketPath: string): Promise<void> => {\n    const verdict = await clearStalePath(socketPath);\n\n    if (verdict.kind === \"live\") {\n        throw alreadyOwnedError(socketPath);\n    }\n\n    if (verdict.kind === \"directory\") {\n        throw directoryPathError(socketPath);\n    }\n\n    if (verdict.kind === \"unknown\") {\n        throw undecidedOwnerError(socketPath, verdict.code);\n    }\n};\n\nconst claimSocketPath = (privatePath: string, socketPath: string): ClaimOutcome => {\n    try {\n        fs.linkSync(privatePath, socketPath);\n\n        return \"published\";\n    } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"EEXIST\") {\n            return \"occupied\";\n        }\n\n        throw error;\n    }\n};\n\nconst publishSocket = async (privatePath: string, socketPath: string): Promise<number | null> => {\n    for (let attempt = 1; attempt <= CLAIM_ATTEMPTS; attempt += 1) {\n        await requireVacantPath(socketPath);\n\n        if (claimSocketPath(privatePath, socketPath) === \"published\") {\n            const inode = inodeFor(socketPath);\n            fs.rmSync(privatePath, { force: true });\n\n            return inode;\n        }\n    }\n\n    throw alreadyOwnedError(socketPath);\n};\n\nconst releaseSocketPath = async (socketPath: string, inode: number): Promise<void> => {\n    const lock = await acquireClaimLock(socketPath);\n\n    try {\n        removeEntry(socketPath, inode);\n    } finally {\n        await releaseClaimLock(lock);\n    }\n};\n\nclass SocketServer {\n    private server: net.Server | null = null;\n    private socketPath: string;\n    private registry: ConnectionRegistry;\n    private boundInode: number | null = null;\n    private startup: Promise<void> | null = null;\n\n    constructor(registry: ConnectionRegistry, socketPath: string = DEFAULT_SOCKET_PATH) {\n        this.registry = registry;\n        this.socketPath = socketPath;\n    }\n\n    private listen(privatePath: string): Promise<net.Server> {\n        return new Promise((resolve, reject) => {\n            const server = net.createServer((socket) => this.registry.register(socket));\n            let isListening = false;\n\n            server.on(\"error\", (error) => {\n                this.registry.dispatchEvent(connectionErrorEvent(error));\n\n                if (!isListening) {\n                    reject(error);\n                }\n            });\n\n            server.listen(privatePath, () => {\n                isListening = true;\n                resolve(server);\n            });\n        });\n    }\n\n    private async listenPrivately(privatePath: string): Promise<net.Server> {\n        try {\n            return await this.listen(privatePath);\n        } catch (error) {\n            const failure = error as NodeJS.ErrnoException;\n            throw listenFailureError(this.socketPath, failure.code ?? failure.message);\n        }\n    }\n\n    private async bind(): Promise<void> {\n        const privatePath = privatePathFor(this.socketPath);\n        await clearStalePath(privatePath);\n        const server = await this.listenPrivately(privatePath);\n\n        try {\n            this.boundInode = await publishSocket(privatePath, this.socketPath);\n            this.server = server;\n        } catch (error) {\n            await closeServer(server);\n            throw error;\n        }\n    }\n\n    private open(): Promise<void> {\n        return withClaimLock(this.socketPath, () => this.bind());\n    }\n\n    private async settleStartup(): Promise<void> {\n        const startup = this.startup;\n        this.startup = null;\n\n        if (startup) {\n            await Promise.allSettled([startup]);\n        }\n    }\n\n    private async release(): Promise<void> {\n        const inode = this.boundInode;\n        this.boundInode = null;\n\n        if (inode !== null) {\n            await releaseSocketPath(this.socketPath, inode);\n        }\n    }\n\n    async start(): Promise<void> {\n        this.startup ??= this.open();\n        const startup = this.startup;\n\n        try {\n            await startup;\n        } catch (error) {\n            if (this.startup === startup) {\n                this.startup = null;\n            }\n\n            throw error;\n        }\n    }\n\n    async stop(): Promise<void> {\n        await this.settleStartup();\n        const server = this.server;\n\n        if (!server) {\n            return;\n        }\n\n        this.server = null;\n        this.registry.dispose(\"Server stopping\");\n        await closeServer(server);\n        await this.release();\n    }\n}\n\nexport { SocketServer };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Model Context Protocol server that gives an agent the GTKX API reference and control of a running application",
   "keywords": [
     "gtkx",
@@ -41,15 +41,29 @@
     "dist",
     "src"
   ],
+  "nx": {
+    "targets": {
+      "lint": {
+        "options": {
+          "cwd": ".",
+          "command": "eslint {projectRoot}"
+        }
+      }
+    }
+  },
   "engines": {
     "node": ">=24"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.4.3",
-    "@gtkx/codegen": "1.0.0",
-    "@gtkx/utils": "1.0.0",
-    "@gtkx/config": "1.0.0"
+    "@gtkx/codegen": "1.1.0",
+    "@gtkx/config": "1.1.0",
+    "@gtkx/utils": "1.1.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.10",
+    "@gtkx/vitest": "1.1.0"
   },
   "scripts": {
     "release": "tsx ../../scripts/release-package.ts"

package/src/app-router.ts

@@ -206,4 +206,4 @@ class AppRouter extends EventTarget {
     }
 }
 
-export { AppRouter, appRegisteredEvent, appUnregisteredEvent, type AppRegisteredEvent, type AppUnregisteredEvent };
+export { AppRouter, type AppRegisteredEvent, type AppUnregisteredEvent };

package/src/reference.ts

@@ -562,7 +562,5 @@ export {
     createReferenceProvider,
     buildReferenceTools,
     registerReferenceResources,
-    type ReferenceApi,
     type ReferenceProvider,
-    type ResolvedProject,
 };

package/src/server.ts

@@ -1,9 +1,9 @@
 import { createLogger, installGracefulShutdown, type Logger } from "@gtkx/utils";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createRequire } from "node:module";
 import { z } from "zod";
 import type { ConnectionErrorEvent } from "./transport.js";
+import packageManifest from "../package.json" with { type: "json" };
 import { type AppRegisteredEvent, AppRouter, type AppUnregisteredEvent } from "./app-router.js";
 import { ConnectionRegistry } from "./connection-registry.js";
 import {
@@ -49,8 +49,7 @@ type ServerLifecycle = {
 type AppWindow = { id: string; title: string | null };
 type AppWithWindows = AppInfo & { windows?: AppWindow[] };
 
-const require = createRequire(import.meta.url);
-const { version } = require("../package.json") as { version: string };
+const { version } = packageManifest;
 const log: Logger = createLogger("mcp");
 const APPLICATION_ID_DESCRIPTION = "Application ID to query. If not specified, uses the first connected app.";
 
@@ -421,4 +420,4 @@ async function main(): Promise<void> {
     await server.start();
 }
 
-export { log, createMcpServer, main };
+export { log, main };

package/src/socket-server.ts

@@ -359,4 +359,4 @@ class SocketServer {
     }
 }
 
-export { SocketServer, withClaimLock };
+export { SocketServer };