@gtkx/mcp 0.20.0 → 1.0.0-rc.1

package/dist/protocol/errors.d.ts

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

package/dist/protocol/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,YAAY;IACpB,4BAA4B;IAC5B,cAAc,OAAO;IACrB,uCAAuC;IACvC,gBAAgB,OAAO;IACvB,6CAA6C;IAC7C,aAAa,OAAO;IACpB,6CAA6C;IAC7C,gBAAgB,OAAO;IACvB,uCAAuC;IACvC,uBAAuB,OAAO;IAC9B,yCAAyC;IACzC,aAAa,OAAO;IACpB,sCAAsC;IACtC,mBAAmB,OAAO;IAC1B,gCAAgC;IAChC,iBAAiB,OAAO;IACxB,4BAA4B;IAC5B,WAAW,OAAO;IAClB,+BAA+B;IAC/B,mBAAmB,OAAO;IAC1B,gCAAgC;IAChC,eAAe,OAAO;IACtB,sCAAsC;IACtC,gBAAgB,OAAO;CAC1B;AAED;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAC/B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAW/D;;;;OAIG;IACH,UAAU,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE;CAOlE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAM9C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAE5D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;aAClB,cAAc,EAAE,IAAI;aACpB,gBAAgB,EAAE,IAAI;aACtB,aAAa,EAAE,IAAI;aACnB,gBAAgB,EAAE,IAAI;aACtB,uBAAuB,EAAE,IAAI;aAC7B,eAAe,EAAE,IAAI;aACrB,eAAe,EAAE,IAAI;aACrB,gBAAgB,EAAE,IAAI;CAChB,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAE3D;AAED,qBAAa,aAAc,SAAQ,KAAK;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,YAAY,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAK3D;IAED,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAMjE;CACJ;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAMnD;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAErE;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAM/E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAEnE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAElE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAEjE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAEjE"}

package/dist/protocol/errors.js

@@ -1,58 +1,26 @@
-/**
- * Error codes for MCP protocol errors.
- */
-export var McpErrorCode;
-(function (McpErrorCode) {
-    /** Internal server error */
-    McpErrorCode[McpErrorCode["INTERNAL_ERROR"] = 1000] = "INTERNAL_ERROR";
-    /** No GTKX application is connected */
-    McpErrorCode[McpErrorCode["NO_APP_CONNECTED"] = 1001] = "NO_APP_CONNECTED";
-    /** Requested application ID was not found */
-    McpErrorCode[McpErrorCode["APP_NOT_FOUND"] = 1002] = "APP_NOT_FOUND";
-    /** Widget with specified ID was not found */
-    McpErrorCode[McpErrorCode["WIDGET_NOT_FOUND"] = 1003] = "WIDGET_NOT_FOUND";
-    /** Widget cannot be interacted with */
-    McpErrorCode[McpErrorCode["WIDGET_NOT_INTERACTABLE"] = 1004] = "WIDGET_NOT_INTERACTABLE";
-    /** Query timed out waiting for widget */
-    McpErrorCode[McpErrorCode["QUERY_TIMEOUT"] = 1005] = "QUERY_TIMEOUT";
-    /** Widget is not the expected type */
-    McpErrorCode[McpErrorCode["INVALID_WIDGET_TYPE"] = 1006] = "INVALID_WIDGET_TYPE";
-    /** Screenshot capture failed */
-    McpErrorCode[McpErrorCode["SCREENSHOT_FAILED"] = 1007] = "SCREENSHOT_FAILED";
-    /** IPC request timed out */
-    McpErrorCode[McpErrorCode["IPC_TIMEOUT"] = 1008] = "IPC_TIMEOUT";
-    /** Failed to serialize data */
-    McpErrorCode[McpErrorCode["SERIALIZATION_ERROR"] = 1009] = "SERIALIZATION_ERROR";
-    /** Request format is invalid */
-    McpErrorCode[McpErrorCode["INVALID_REQUEST"] = 1010] = "INVALID_REQUEST";
-    /** Requested method does not exist */
-    McpErrorCode[McpErrorCode["METHOD_NOT_FOUND"] = 1011] = "METHOD_NOT_FOUND";
-})(McpErrorCode || (McpErrorCode = {}));
-/**
- * Error class for MCP protocol errors.
- *
- * Contains an error code, message, and optional additional data.
- */
-export class McpError extends Error {
-    /** The MCP error code */
+export const ErrorCode = {
+    INTERNAL_ERROR: 1000,
+    NO_APP_CONNECTED: 1001,
+    APP_NOT_FOUND: 1002,
+    WIDGET_NOT_FOUND: 1003,
+    CONNECTION_WRITE_FAILED: 1004,
+    REQUEST_TIMEOUT: 1005,
+    INVALID_REQUEST: 1006,
+    METHOD_NOT_FOUND: 1007,
+};
+export function isErrorCode(code) {
+    return Object.values(ErrorCode).includes(code);
+}
+export class ProtocolError extends Error {
     code;
-    /** Additional error context */
     data;
     constructor(code, message, data) {
         super(message);
         this.code = code;
         this.data = data;
-        this.name = "McpError";
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, McpError);
-        }
+        this.name = "ProtocolError";
     }
-    /**
-     * Converts the error to an IPC-compatible format.
-     *
-     * @returns Object suitable for IPC response error field
-     */
-    toIpcError() {
+    toErrorObject() {
         return {
             code: this.code,
             message: this.message,
@@ -60,57 +28,25 @@ export class McpError extends Error {
         };
     }
 }
-/**
- * Creates an error for when no GTKX application is connected.
- *
- * @returns McpError with NO_APP_CONNECTED code
- */
 export function noAppConnectedError() {
-    return new McpError(McpErrorCode.NO_APP_CONNECTED, "No GTKX application connected. Start an app with 'gtkx dev' to connect.", { hint: "Run 'gtkx dev src/app.tsx' in your project directory" });
+    return new ProtocolError(ErrorCode.NO_APP_CONNECTED, "No GTKX application connected: start an app with 'gtkx dev' to connect", { hint: "Run 'gtkx dev' in your project directory" });
+}
+export function appNotFoundError(applicationId) {
+    return new ProtocolError(ErrorCode.APP_NOT_FOUND, `Application '${applicationId}' not found`, { applicationId });
 }
-/**
- * Creates an error for when a requested app is not found.
- *
- * @param appId - The application ID that was not found
- * @returns McpError with APP_NOT_FOUND code
- */
-export function appNotFoundError(appId) {
-    return new McpError(McpErrorCode.APP_NOT_FOUND, `Application '${appId}' not found`, { appId });
+export function connectionWriteFailedError(applicationId) {
+    return new ProtocolError(ErrorCode.CONNECTION_WRITE_FAILED, `Connection to application '${applicationId}' is no longer writable`, { applicationId });
 }
-/**
- * Creates an error for when a widget is not found.
- *
- * @param widgetId - The widget ID that was not found
- * @returns McpError with WIDGET_NOT_FOUND code
- */
 export function widgetNotFoundError(widgetId) {
-    return new McpError(McpErrorCode.WIDGET_NOT_FOUND, `Widget '${widgetId}' not found`, { widgetId });
+    return new ProtocolError(ErrorCode.WIDGET_NOT_FOUND, `Widget '${widgetId}' not found`, { widgetId });
 }
-/**
- * Creates an error for when an IPC request times out.
- *
- * @param timeout - The timeout duration in milliseconds
- * @returns McpError with IPC_TIMEOUT code
- */
-export function ipcTimeoutError(timeout) {
-    return new McpError(McpErrorCode.IPC_TIMEOUT, `IPC request timed out after ${timeout}ms`, { timeout });
+export function requestTimeoutError(timeout) {
+    return new ProtocolError(ErrorCode.REQUEST_TIMEOUT, `Request timed out after ${timeout}ms`, { timeout });
 }
-/**
- * Creates an error for invalid request format.
- *
- * @param reason - Description of why the request is invalid
- * @returns McpError with INVALID_REQUEST code
- */
 export function invalidRequestError(reason) {
-    return new McpError(McpErrorCode.INVALID_REQUEST, `Invalid request: ${reason}`, { reason });
+    return new ProtocolError(ErrorCode.INVALID_REQUEST, `Invalid request: ${reason}`, { reason });
 }
-/**
- * Creates an error for when a method is not found.
- *
- * @param method - The method name that was not found
- * @returns McpError with METHOD_NOT_FOUND code
- */
 export function methodNotFoundError(method) {
-    return new McpError(McpErrorCode.METHOD_NOT_FOUND, `Method '${method}' not found`, { method });
+    return new ProtocolError(ErrorCode.METHOD_NOT_FOUND, `Method '${method}' not found`, { method });
 }
 //# sourceMappingURL=errors.js.map

package/dist/protocol/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,YAyBX;AAzBD,WAAY,YAAY;IACpB,4BAA4B;IAC5B,sEAAqB,CAAA;IACrB,uCAAuC;IACvC,0EAAuB,CAAA;IACvB,6CAA6C;IAC7C,oEAAoB,CAAA;IACpB,6CAA6C;IAC7C,0EAAuB,CAAA;IACvB,uCAAuC;IACvC,wFAA8B,CAAA;IAC9B,yCAAyC;IACzC,oEAAoB,CAAA;IACpB,sCAAsC;IACtC,gFAA0B,CAAA;IAC1B,gCAAgC;IAChC,4EAAwB,CAAA;IACxB,4BAA4B;IAC5B,gEAAkB,CAAA;IAClB,+BAA+B;IAC/B,gFAA0B,CAAA;IAC1B,gCAAgC;IAChC,wEAAsB,CAAA;IACtB,sCAAsC;IACtC,0EAAuB,CAAA;AAC3B,CAAC,EAzBW,YAAY,KAAZ,YAAY,QAyBvB;AAED;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAC/B,yBAAyB;IAChB,IAAI,CAAe;IAC5B,+BAA+B;IACtB,IAAI,CAAW;IAExB,YAAY,IAAkB,EAAE,OAAe,EAAE,IAAc;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QAEvB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,UAAU;QACN,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;SACtD,CAAC;IACN,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IAC/B,OAAO,IAAI,QAAQ,CACf,YAAY,CAAC,gBAAgB,EAC7B,yEAAyE,EACzE,EAAE,IAAI,EAAE,sDAAsD,EAAE,CACnE,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC1C,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,gBAAgB,KAAK,aAAa,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AACnG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAChD,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,gBAAgB,EAAE,WAAW,QAAQ,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AACvG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC3C,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,+BAA+B,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAC9C,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,eAAe,EAAE,oBAAoB,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAChG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAC9C,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,gBAAgB,EAAE,WAAW,MAAM,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACnG,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,IAAI;IAC7B,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;CAChB,CAAC;AAIX,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAQ,MAAM,CAAC,MAAM,CAAC,SAAS,CAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpC,IAAI,CAAY;IAChB,IAAI,CAAW;IAEf,YAAY,IAAe,EAAE,OAAe,EAAE,IAAc;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAChC,CAAC;IAED,aAAa;QACT,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;SACtD,CAAC;IACN,CAAC;CACJ;AAED,MAAM,UAAU,mBAAmB;IAC/B,OAAO,IAAI,aAAa,CACpB,SAAS,CAAC,gBAAgB,EAC1B,wEAAwE,EACxE,EAAE,IAAI,EAAE,0CAA0C,EAAE,CACvD,CAAC;AACN,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,aAAqB;IAClD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,aAAa,EAAE,gBAAgB,aAAa,aAAa,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;AACrH,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,aAAqB;IAC5D,OAAO,IAAI,aAAa,CACpB,SAAS,CAAC,uBAAuB,EACjC,8BAA8B,aAAa,yBAAyB,EACpE,EAAE,aAAa,EAAE,CACpB,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAChD,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,gBAAgB,EAAE,WAAW,QAAQ,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAC/C,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,eAAe,EAAE,2BAA2B,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7G,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAC9C,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,eAAe,EAAE,oBAAoB,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAC9C,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,gBAAgB,EAAE,WAAW,MAAM,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACrG,CAAC","sourcesContent":["export const ErrorCode = {\n    INTERNAL_ERROR: 1000,\n    NO_APP_CONNECTED: 1001,\n    APP_NOT_FOUND: 1002,\n    WIDGET_NOT_FOUND: 1003,\n    CONNECTION_WRITE_FAILED: 1004,\n    REQUEST_TIMEOUT: 1005,\n    INVALID_REQUEST: 1006,\n    METHOD_NOT_FOUND: 1007,\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\nexport function isErrorCode(code: number): code is ErrorCode {\n    return (Object.values(ErrorCode) as number[]).includes(code);\n}\n\nexport class ProtocolError extends Error {\n    code: ErrorCode;\n    data?: unknown;\n\n    constructor(code: ErrorCode, message: string, data?: unknown) {\n        super(message);\n        this.code = code;\n        this.data = data;\n        this.name = \"ProtocolError\";\n    }\n\n    toErrorObject(): { code: number; message: string; data?: unknown } {\n        return {\n            code: this.code,\n            message: this.message,\n            ...(this.data !== undefined && { data: this.data }),\n        };\n    }\n}\n\nexport function noAppConnectedError(): ProtocolError {\n    return new ProtocolError(\n        ErrorCode.NO_APP_CONNECTED,\n        \"No GTKX application connected: start an app with 'gtkx dev' to connect\",\n        { hint: \"Run 'gtkx dev' in your project directory\" },\n    );\n}\n\nexport function appNotFoundError(applicationId: string): ProtocolError {\n    return new ProtocolError(ErrorCode.APP_NOT_FOUND, `Application '${applicationId}' not found`, { applicationId });\n}\n\nexport function connectionWriteFailedError(applicationId: string): ProtocolError {\n    return new ProtocolError(\n        ErrorCode.CONNECTION_WRITE_FAILED,\n        `Connection to application '${applicationId}' is no longer writable`,\n        { applicationId },\n    );\n}\n\nexport function widgetNotFoundError(widgetId: string): ProtocolError {\n    return new ProtocolError(ErrorCode.WIDGET_NOT_FOUND, `Widget '${widgetId}' not found`, { widgetId });\n}\n\nexport function requestTimeoutError(timeout: number): ProtocolError {\n    return new ProtocolError(ErrorCode.REQUEST_TIMEOUT, `Request timed out after ${timeout}ms`, { timeout });\n}\n\nexport function invalidRequestError(reason: string): ProtocolError {\n    return new ProtocolError(ErrorCode.INVALID_REQUEST, `Invalid request: ${reason}`, { reason });\n}\n\nexport function methodNotFoundError(method: string): ProtocolError {\n    return new ProtocolError(ErrorCode.METHOD_NOT_FOUND, `Method '${method}' not found`, { method });\n}\n"]}

package/dist/protocol/schemas.d.ts

@@ -0,0 +1,89 @@
+import { z } from "zod";
+export declare const RequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type Request = z.infer<typeof RequestSchema>;
+declare const ErrorSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const ResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<typeof ErrorSchema>;
+}, z.core.$strip>;
+export type Response = z.infer<typeof ResponseSchema>;
+export type SerializedWidget = {
+    id: string;
+    type: string;
+    role: string;
+    name: string | null;
+    text: string | null;
+    sensitive: boolean;
+    visible: boolean;
+    cssClasses: string[];
+    children: SerializedWidget[];
+};
+export type AppInfo = {
+    applicationId: string;
+    pid: number;
+    projectRoot?: string;
+};
+export declare const RegisterParamsSchema: z.ZodObject<{
+    applicationId: z.ZodString;
+    pid: z.ZodNumber;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const emptyParams: z.ZodObject<Record<string, never>, z.core.$strip>;
+export declare const widgetIdParams: z.ZodObject<{
+    widgetId: z.ZodString;
+}, z.core.$strip>;
+export declare const queryOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    exact: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const queryParams: z.ZodObject<{
+    by: z.ZodEnum<{
+        role: "role";
+        text: "text";
+        name: "name";
+        labelText: "labelText";
+    }>;
+    value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    options: z.ZodOptional<typeof queryOptionsSchema>;
+}, z.core.$strip>;
+export declare const typeParams: z.ZodObject<{
+    widgetId: z.ZodString;
+    text: z.ZodString;
+    clear: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const fireEventParams: z.ZodObject<{
+    widgetId: z.ZodString;
+    signal: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const screenshotParams: z.ZodObject<{
+    windowId: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ServerRequestParamsSchemas: {
+    "app.getWindows": typeof emptyParams;
+    "widget.getTree": typeof emptyParams;
+    "widget.query": typeof queryParams;
+    "widget.getProps": typeof widgetIdParams;
+    "widget.click": typeof widgetIdParams;
+    "widget.type": typeof typeParams;
+    "widget.fireEvent": typeof fireEventParams;
+    "widget.screenshot": typeof screenshotParams;
+};
+export type ServerRequestParams<Method extends keyof typeof ServerRequestParamsSchemas> = z.infer<(typeof ServerRequestParamsSchemas)[Method]>;
+export type ParamsSchema<Output> = z.ZodType<Output>;
+export type ServerInitiatedMethod = keyof typeof ServerRequestParamsSchemas;
+export type Message = Request | Response;
+export declare const DEFAULT_SOCKET_PATH: string;
+export {};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/protocol/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/protocol/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,SAAS,CACnC;IACI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;CACvC,EACD,CAAC,CAAC,IAAI,CAAC,MAAM,CAKf,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,QAAA,MAAM,WAAW,EAAE,CAAC,CAAC,SAAS,CAC1B;IAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;CAAE,EAC9E,CAAC,CAAC,IAAI,CAAC,MAAM,CAKf,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,SAAS,CACpC;IACI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;CAC5C,EACD,CAAC,CAAC,IAAI,CAAC,MAAM,CAKf,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,SAAS,CAC1C;IACI,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC;IACjB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CAC3C,EACD,CAAC,CAAC,IAAI,CAAC,MAAM,CAKf,CAAC;AAEH,QAAA,MAAM,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAgB,CAAC;AACpF,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC;IAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAA;CAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAE/E,CAAC;AACH,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,SAAS,CACxC;IAAE,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;CAAE,EAC7G,CAAC,CAAC,IAAI,CAAC,MAAM,CAKf,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,SAAS,CACjC;IACI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IACpF,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;CACrD,EACD,CAAC,CAAC,IAAI,CAAC,MAAM,CAKf,CAAC;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,SAAS,CAChC;IAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;CAAE,EAChF,CAAC,CAAC,IAAI,CAAC,MAAM,CACsE,CAAC;AACxF,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,SAAS,CACrC;IAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;CAAE,EAC7F,CAAC,CAAC,IAAI,CAAC,MAAM,CACgF,CAAC;AAClG,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,SAAS,CACtC;IAAE,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;CAAE,EAC1E,CAAC,CAAC,IAAI,CAAC,MAAM,CAIf,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE;IACrC,gBAAgB,EAAE,OAAO,WAAW,CAAC;IACrC,gBAAgB,EAAE,OAAO,WAAW,CAAC;IACrC,cAAc,EAAE,OAAO,WAAW,CAAC;IACnC,iBAAiB,EAAE,OAAO,cAAc,CAAC;IACzC,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,aAAa,EAAE,OAAO,UAAU,CAAC;IACjC,kBAAkB,EAAE,OAAO,eAAe,CAAC;IAC3C,mBAAmB,EAAE,OAAO,gBAAgB,CAAC;CAUhD,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,MAAM,OAAO,0BAA0B,IAAI,CAAC,CAAC,KAAK,CAC7F,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAC9C,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,0BAA0B,CAAC;AAE5E,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAIzC,eAAO,MAAM,mBAAmB,EAAE,MAA+C,CAAC"}

package/dist/protocol/schemas.js

@@ -0,0 +1,56 @@
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { z } from "zod";
+export const RequestSchema = z.object({
+    id: z.string(),
+    method: z.string(),
+    params: z.unknown().optional(),
+});
+const ErrorSchema = z.object({
+    code: z.number(),
+    message: z.string(),
+    data: z.unknown().optional(),
+});
+export const ResponseSchema = z.object({
+    id: z.string(),
+    result: z.unknown().optional(),
+    error: ErrorSchema.optional(),
+});
+export const RegisterParamsSchema = z.object({
+    applicationId: z.string(),
+    pid: z.number(),
+    projectRoot: z.string().optional(),
+});
+const emptyParams = z.object({});
+export const widgetIdParams = z.object({
+    widgetId: z.string(),
+});
+export const queryOptionsSchema = z.object({
+    name: z.string().optional(),
+    exact: z.boolean().optional(),
+    timeout: z.number().optional(),
+});
+export const queryParams = z.object({
+    by: z.enum(["role", "text", "name", "labelText"]),
+    value: z.union([z.string(), z.number()]),
+    options: queryOptionsSchema.optional(),
+});
+export const typeParams = z.object({ widgetId: z.string(), text: z.string(), clear: z.boolean().optional() });
+export const fireEventParams = z.object({ widgetId: z.string(), signal: z.string(), args: z.array(z.unknown()).optional() });
+export const screenshotParams = z.object({
+    windowId: z.string().optional(),
+    path: z.string().optional(),
+});
+export const ServerRequestParamsSchemas = {
+    "app.getWindows": emptyParams,
+    "widget.getTree": emptyParams,
+    "widget.query": queryParams,
+    "widget.getProps": widgetIdParams,
+    "widget.click": widgetIdParams,
+    "widget.type": typeParams,
+    "widget.fireEvent": fireEventParams,
+    "widget.screenshot": screenshotParams,
+};
+const getRuntimeDir = () => process.env.XDG_RUNTIME_DIR ?? tmpdir();
+export const DEFAULT_SOCKET_PATH = join(getRuntimeDir(), "gtkx-mcp.sock");
+//# sourceMappingURL=schemas.js.map

package/dist/protocol/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/protocol/schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { z } from \"zod\";\n\nexport const RequestSchema: z.ZodObject<\n    {\n        id: z.ZodString;\n        method: z.ZodString;\n        params: z.ZodOptional<z.ZodUnknown>;\n    },\n    z.core.$strip\n> = z.object({\n    id: z.string(),\n    method: z.string(),\n    params: z.unknown().optional(),\n});\n\nexport type Request = z.infer<typeof RequestSchema>;\n\nconst ErrorSchema: z.ZodObject<\n    { code: z.ZodNumber; message: z.ZodString; data: z.ZodOptional<z.ZodUnknown> },\n    z.core.$strip\n> = z.object({\n    code: z.number(),\n    message: z.string(),\n    data: z.unknown().optional(),\n});\n\nexport const ResponseSchema: z.ZodObject<\n    {\n        id: z.ZodString;\n        result: z.ZodOptional<z.ZodUnknown>;\n        error: z.ZodOptional<typeof ErrorSchema>;\n    },\n    z.core.$strip\n> = z.object({\n    id: z.string(),\n    result: z.unknown().optional(),\n    error: ErrorSchema.optional(),\n});\n\nexport type Response = z.infer<typeof ResponseSchema>;\n\nexport type SerializedWidget = {\n    id: string;\n    type: string;\n    role: string;\n    name: string | null;\n    text: string | null;\n    sensitive: boolean;\n    visible: boolean;\n    cssClasses: string[];\n    children: SerializedWidget[];\n};\n\nexport type AppInfo = {\n    applicationId: string;\n    pid: number;\n    projectRoot?: string;\n};\n\nexport const RegisterParamsSchema: z.ZodObject<\n    {\n        applicationId: z.ZodString;\n        pid: z.ZodNumber;\n        projectRoot: z.ZodOptional<z.ZodString>;\n    },\n    z.core.$strip\n> = z.object({\n    applicationId: z.string(),\n    pid: z.number(),\n    projectRoot: z.string().optional(),\n});\n\nconst emptyParams: z.ZodObject<Record<string, never>, z.core.$strip> = z.object({});\nexport const widgetIdParams: z.ZodObject<{ widgetId: z.ZodString }, z.core.$strip> = z.object({\n    widgetId: z.string(),\n});\nexport const queryOptionsSchema: z.ZodObject<\n    { name: z.ZodOptional<z.ZodString>; exact: z.ZodOptional<z.ZodBoolean>; timeout: z.ZodOptional<z.ZodNumber> },\n    z.core.$strip\n> = z.object({\n    name: z.string().optional(),\n    exact: z.boolean().optional(),\n    timeout: z.number().optional(),\n});\n\nexport const queryParams: z.ZodObject<\n    {\n        by: z.ZodEnum<{ role: \"role\"; text: \"text\"; name: \"name\"; labelText: \"labelText\" }>;\n        value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;\n        options: z.ZodOptional<typeof queryOptionsSchema>;\n    },\n    z.core.$strip\n> = z.object({\n    by: z.enum([\"role\", \"text\", \"name\", \"labelText\"]),\n    value: z.union([z.string(), z.number()]),\n    options: queryOptionsSchema.optional(),\n});\nexport const typeParams: z.ZodObject<\n    { widgetId: z.ZodString; text: z.ZodString; clear: z.ZodOptional<z.ZodBoolean> },\n    z.core.$strip\n> = z.object({ widgetId: z.string(), text: z.string(), clear: z.boolean().optional() });\nexport const fireEventParams: z.ZodObject<\n    { widgetId: z.ZodString; signal: z.ZodString; args: z.ZodOptional<z.ZodArray<z.ZodUnknown>> },\n    z.core.$strip\n> = z.object({ widgetId: z.string(), signal: z.string(), args: z.array(z.unknown()).optional() });\nexport const screenshotParams: z.ZodObject<\n    { windowId: z.ZodOptional<z.ZodString>; path: z.ZodOptional<z.ZodString> },\n    z.core.$strip\n> = z.object({\n    windowId: z.string().optional(),\n    path: z.string().optional(),\n});\n\nexport const ServerRequestParamsSchemas: {\n    \"app.getWindows\": typeof emptyParams;\n    \"widget.getTree\": typeof emptyParams;\n    \"widget.query\": typeof queryParams;\n    \"widget.getProps\": typeof widgetIdParams;\n    \"widget.click\": typeof widgetIdParams;\n    \"widget.type\": typeof typeParams;\n    \"widget.fireEvent\": typeof fireEventParams;\n    \"widget.screenshot\": typeof screenshotParams;\n} = {\n    \"app.getWindows\": emptyParams,\n    \"widget.getTree\": emptyParams,\n    \"widget.query\": queryParams,\n    \"widget.getProps\": widgetIdParams,\n    \"widget.click\": widgetIdParams,\n    \"widget.type\": typeParams,\n    \"widget.fireEvent\": fireEventParams,\n    \"widget.screenshot\": screenshotParams,\n};\n\nexport type ServerRequestParams<Method extends keyof typeof ServerRequestParamsSchemas> = z.infer<\n    (typeof ServerRequestParamsSchemas)[Method]\n>;\n\nexport type ParamsSchema<Output> = z.ZodType<Output>;\n\nexport type ServerInitiatedMethod = keyof typeof ServerRequestParamsSchemas;\n\nexport type Message = Request | Response;\n\nconst getRuntimeDir = (): string => process.env.XDG_RUNTIME_DIR ?? tmpdir();\n\nexport const DEFAULT_SOCKET_PATH: string = join(getRuntimeDir(), \"gtkx-mcp.sock\");\n"]}

package/dist/reference.d.ts

@@ -0,0 +1,13 @@
+import { type ApiReference } from "@gtkx/codegen";
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type Tool } from "./tool.js";
+export type ReferenceApi = Pick<ApiReference, "lookup" | "namespaceOverview" | "namespaces" | "overview" | "search" | "symbolNames">;
+export type ReferenceProvider = {
+    get(): Promise<ReferenceApi>;
+};
+export declare const createReferenceProvider: (resolveRoot: () => string) => ReferenceProvider;
+export declare const buildReferenceTools: (provider: ReferenceProvider) => Tool[];
+type ResourceServer = Pick<McpServer, "registerResource">;
+export declare const registerReferenceResources: (server: ResourceServer, provider: ReferenceProvider) => void;
+export {};
+//# sourceMappingURL=reference.d.ts.map

package/dist/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAsE,MAAM,eAAe,CAAC;AAEtH,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAG3F,OAAO,EAAc,KAAK,IAAI,EAA0B,MAAM,WAAW,CAAC;AAE1E,MAAM,MAAM,YAAY,GAAG,IAAI,CAC3B,YAAY,EACZ,QAAQ,GAAG,mBAAmB,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CACxF,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAChC,CAAC;AA2DF,eAAO,MAAM,uBAAuB,gBAAiB,MAAM,MAAM,KAAG,iBA4BnE,CAAC;AA4GF,eAAO,MAAM,mBAAmB,aAAc,iBAAiB,KAAG,IAAI,EAIrE,CAAC;AASF,KAAK,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;AA+G1D,eAAO,MAAM,0BAA0B,WAAY,cAAc,YAAY,iBAAiB,KAAG,IAIhG,CAAC"}