@casys/mcp-bridge 0.2.0

package/script/core/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/core/protocol.ts"],"names":[],"mappings":"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"}

package/script/core/protocol.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * JSON-RPC 2.0 message builders and validators for the MCP Apps protocol.
+ *
+ * Provides type-safe construction of all MCP Apps messages and a
+ * message validator to guard incoming data at system boundaries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonRpcErrorCode = void 0;
+exports.nextRequestId = nextRequestId;
+exports.resetRequestIdCounter = resetRequestIdCounter;
+exports.isJsonRpcMessage = isJsonRpcMessage;
+exports.isRequest = isRequest;
+exports.isNotification = isNotification;
+exports.isResponse = isResponse;
+exports.isErrorResponse = isErrorResponse;
+exports.buildInitializeRequest = buildInitializeRequest;
+exports.buildToolCallRequest = buildToolCallRequest;
+exports.buildResourceReadRequest = buildResourceReadRequest;
+exports.buildOpenLinkRequest = buildOpenLinkRequest;
+exports.buildMessageRequest = buildMessageRequest;
+exports.buildUpdateModelContextRequest = buildUpdateModelContextRequest;
+exports.buildDisplayModeRequest = buildDisplayModeRequest;
+exports.buildInitializedNotification = buildInitializedNotification;
+exports.buildToolInputNotification = buildToolInputNotification;
+exports.buildToolResultNotification = buildToolResultNotification;
+exports.buildToolCancelledNotification = buildToolCancelledNotification;
+exports.buildHostContextChangedNotification = buildHostContextChangedNotification;
+exports.buildResourceTeardownRequest = buildResourceTeardownRequest;
+exports.buildLogNotification = buildLogNotification;
+exports.buildInitializeResponse = buildInitializeResponse;
+exports.buildSuccessResponse = buildSuccessResponse;
+exports.buildErrorResponse = buildErrorResponse;
+const types_js_1 = require("./types.js");
+// ---------------------------------------------------------------------------
+// ID generation
+// ---------------------------------------------------------------------------
+let _nextId = 1;
+/** Generate a monotonically increasing request ID. */
+function nextRequestId() {
+    return _nextId++;
+}
+/** Reset the ID counter. @internal — exported for tests only. */
+function resetRequestIdCounter() {
+    _nextId = 1;
+}
+// ---------------------------------------------------------------------------
+// Message type guards
+// ---------------------------------------------------------------------------
+/** Check if a value is a valid JSON-RPC 2.0 message. */
+function isJsonRpcMessage(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "jsonrpc" in value &&
+        value.jsonrpc === "2.0");
+}
+/** Check if a message is a JSON-RPC request (has `id` and `method`). */
+function isRequest(msg) {
+    return "method" in msg && "id" in msg;
+}
+/** Check if a message is a JSON-RPC notification (has `method`, no `id`). */
+function isNotification(msg) {
+    return "method" in msg && !("id" in msg);
+}
+/** Check if a message is a JSON-RPC success response. */
+function isResponse(msg) {
+    return "result" in msg && "id" in msg && !("method" in msg);
+}
+/** Check if a message is a JSON-RPC error response. */
+function isErrorResponse(msg) {
+    return "error" in msg && "id" in msg;
+}
+// ---------------------------------------------------------------------------
+// Request builders (App -> Host)
+// ---------------------------------------------------------------------------
+/** Build a `ui/initialize` request. */
+function buildInitializeRequest(params) {
+    return {
+        jsonrpc: "2.0",
+        id: nextRequestId(),
+        method: types_js_1.McpAppsMethod.UI_INITIALIZE,
+        params,
+    };
+}
+/** Build a `tools/call` request. */
+function buildToolCallRequest(params) {
+    return {
+        jsonrpc: "2.0",
+        id: nextRequestId(),
+        method: types_js_1.McpAppsMethod.TOOLS_CALL,
+        params,
+    };
+}
+/** Build a `resources/read` request. */
+function buildResourceReadRequest(params) {
+    return {
+        jsonrpc: "2.0",
+        id: nextRequestId(),
+        method: types_js_1.McpAppsMethod.RESOURCES_READ,
+        params,
+    };
+}
+/** Build a `ui/open-link` request. */
+function buildOpenLinkRequest(params) {
+    return {
+        jsonrpc: "2.0",
+        id: nextRequestId(),
+        method: types_js_1.McpAppsMethod.UI_OPEN_LINK,
+        params,
+    };
+}
+/** Build a `ui/message` request. */
+function buildMessageRequest(params) {
+    return {
+        jsonrpc: "2.0",
+        id: nextRequestId(),
+        method: types_js_1.McpAppsMethod.UI_MESSAGE,
+        params,
+    };
+}
+/** Build a `ui/update-model-context` request. */
+function buildUpdateModelContextRequest(params) {
+    return {
+        jsonrpc: "2.0",
+        id: nextRequestId(),
+        method: types_js_1.McpAppsMethod.UI_UPDATE_MODEL_CONTEXT,
+        params,
+    };
+}
+/** Build a `ui/request-display-mode` request. */
+function buildDisplayModeRequest(params) {
+    return {
+        jsonrpc: "2.0",
+        id: nextRequestId(),
+        method: types_js_1.McpAppsMethod.UI_REQUEST_DISPLAY_MODE,
+        params,
+    };
+}
+// ---------------------------------------------------------------------------
+// Notification builders (Host -> App)
+// ---------------------------------------------------------------------------
+/** Build a `ui/notifications/initialized` notification (App -> Host). */
+function buildInitializedNotification() {
+    return {
+        jsonrpc: "2.0",
+        method: types_js_1.McpAppsMethod.UI_NOTIFICATIONS_INITIALIZED,
+    };
+}
+/** Build a `ui/notifications/tool-input` notification (Host -> App). */
+function buildToolInputNotification(params) {
+    return {
+        jsonrpc: "2.0",
+        method: types_js_1.McpAppsMethod.UI_TOOL_INPUT,
+        params,
+    };
+}
+/** Build a `ui/notifications/tool-result` notification (Host -> App). */
+function buildToolResultNotification(params) {
+    return {
+        jsonrpc: "2.0",
+        method: types_js_1.McpAppsMethod.UI_TOOL_RESULT,
+        params,
+    };
+}
+/** Build a `ui/notifications/tool-cancelled` notification (Host -> App). */
+function buildToolCancelledNotification(params) {
+    return {
+        jsonrpc: "2.0",
+        method: types_js_1.McpAppsMethod.UI_TOOL_CANCELLED,
+        params,
+    };
+}
+/** Build a `ui/notifications/host-context-changed` notification. */
+function buildHostContextChangedNotification(params) {
+    return {
+        jsonrpc: "2.0",
+        method: types_js_1.McpAppsMethod.UI_HOST_CONTEXT_CHANGED,
+        params: params,
+    };
+}
+/** Build a `ui/resource-teardown` request (Host -> App). */
+function buildResourceTeardownRequest(params) {
+    return {
+        jsonrpc: "2.0",
+        id: nextRequestId(),
+        method: types_js_1.McpAppsMethod.UI_RESOURCE_TEARDOWN,
+        params,
+    };
+}
+/** Build a `notifications/message` notification (logging). */
+function buildLogNotification(params) {
+    return {
+        jsonrpc: "2.0",
+        method: types_js_1.McpAppsMethod.NOTIFICATIONS_MESSAGE,
+        params,
+    };
+}
+// ---------------------------------------------------------------------------
+// Response builders
+// ---------------------------------------------------------------------------
+/** Build a `ui/initialize` success response. */
+function buildInitializeResponse(id, params) {
+    return {
+        jsonrpc: "2.0",
+        id,
+        result: params,
+    };
+}
+/** Build a generic JSON-RPC success response. */
+function buildSuccessResponse(id, result) {
+    return { jsonrpc: "2.0", id, result };
+}
+/** Build a JSON-RPC error response. */
+function buildErrorResponse(id, code, message, data) {
+    return {
+        jsonrpc: "2.0",
+        id,
+        error: { code, message, ...(data !== undefined ? { data } : {}) },
+    };
+}
+// ---------------------------------------------------------------------------
+// Standard JSON-RPC error codes
+// ---------------------------------------------------------------------------
+exports.JsonRpcErrorCode = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+};

package/script/core/resource-resolver.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Resolves `ui://` resource URIs to HTTP URLs served by the resource server.
+ *
+ * The `ui://` scheme is defined by the MCP Apps specification:
+ *   `ui://<server>/<path>?<query>`
+ *
+ * The resolver rewrites these to the resource server's HTTP base URL so that
+ * platform WebViews can fetch the assets over plain HTTP(S).
+ */
+import type { ResourceUri } from "./types.js";
+/**
+ * Parse a raw `ui://` URI string into its components.
+ *
+ * @throws {Error} if the URI does not start with `ui://`.
+ */
+export declare function parseResourceUri(raw: string): ResourceUri;
+/**
+ * Resolve a `ui://` URI to an HTTP URL using the given base URL.
+ *
+ * Example:
+ * ```
+ * resolveToHttp("ui://my-app/index.html", "https://resource.example.com")
+ * // => "https://resource.example.com/my-app/index.html"
+ * ```
+ */
+export declare function resolveToHttp(uriOrString: ResourceUri | string, httpBaseUrl: string): string;
+//# sourceMappingURL=resource-resolver.d.ts.map

package/script/core/resource-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-resolver.d.ts","sourceRoot":"","sources":["../../src/core/resource-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAqDzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,WAAW,GAAG,MAAM,EACjC,WAAW,EAAE,MAAM,GAClB,MAAM,CAwBR"}

package/script/core/resource-resolver.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Resolves `ui://` resource URIs to HTTP URLs served by the resource server.
+ *
+ * The `ui://` scheme is defined by the MCP Apps specification:
+ *   `ui://<server>/<path>?<query>`
+ *
+ * The resolver rewrites these to the resource server's HTTP base URL so that
+ * platform WebViews can fetch the assets over plain HTTP(S).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseResourceUri = parseResourceUri;
+exports.resolveToHttp = resolveToHttp;
+const UI_SCHEME = "ui://";
+/**
+ * Parse a raw `ui://` URI string into its components.
+ *
+ * @throws {Error} if the URI does not start with `ui://`.
+ */
+function parseResourceUri(raw) {
+    if (!raw.startsWith(UI_SCHEME)) {
+        throw new Error(`[ResourceResolver] Invalid resource URI: expected "ui://" scheme, got "${raw}".`);
+    }
+    const withoutScheme = raw.slice(UI_SCHEME.length);
+    const queryIdx = withoutScheme.indexOf("?");
+    let serverAndPath;
+    let queryString = "";
+    if (queryIdx >= 0) {
+        serverAndPath = withoutScheme.slice(0, queryIdx);
+        queryString = withoutScheme.slice(queryIdx + 1);
+    }
+    else {
+        serverAndPath = withoutScheme;
+    }
+    const slashIdx = serverAndPath.indexOf("/");
+    let server;
+    let path;
+    if (slashIdx >= 0) {
+        server = serverAndPath.slice(0, slashIdx);
+        path = serverAndPath.slice(slashIdx);
+    }
+    else {
+        server = serverAndPath;
+        path = "/";
+    }
+    if (server.length === 0) {
+        throw new Error(`[ResourceResolver] Invalid resource URI: empty server in "${raw}".`);
+    }
+    const query = {};
+    if (queryString.length > 0) {
+        for (const pair of queryString.split("&")) {
+            const eqIdx = pair.indexOf("=");
+            if (eqIdx >= 0) {
+                query[decodeURIComponent(pair.slice(0, eqIdx))] = decodeURIComponent(pair.slice(eqIdx + 1));
+            }
+            else {
+                query[decodeURIComponent(pair)] = "";
+            }
+        }
+    }
+    return { raw, server, path, query };
+}
+/**
+ * Resolve a `ui://` URI to an HTTP URL using the given base URL.
+ *
+ * Example:
+ * ```
+ * resolveToHttp("ui://my-app/index.html", "https://resource.example.com")
+ * // => "https://resource.example.com/my-app/index.html"
+ * ```
+ */
+function resolveToHttp(uriOrString, httpBaseUrl) {
+    const uri = typeof uriOrString === "string"
+        ? parseResourceUri(uriOrString)
+        : uriOrString;
+    const base = httpBaseUrl.endsWith("/")
+        ? httpBaseUrl.slice(0, -1)
+        : httpBaseUrl;
+    const pathPart = uri.path.startsWith("/") ? uri.path : `/${uri.path}`;
+    const queryEntries = Object.entries(uri.query);
+    let url = `${base}/${uri.server}${pathPart}`;
+    if (queryEntries.length > 0) {
+        const qs = queryEntries
+            .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+            .join("&");
+        url += `?${qs}`;
+    }
+    return url;
+}

package/script/core/transport.d.ts

@@ -0,0 +1,46 @@
+import type { McpAppsMessage } from "./types.js";
+/** Handler invoked when the transport receives a message. */
+export type TransportMessageHandler = (message: McpAppsMessage) => void;
+/** Handler invoked when the transport connection state changes. */
+export type TransportStateHandler = (connected: boolean) => void;
+/**
+ * Transport layer for bidirectional JSON-RPC communication between
+ * the bridge adapter and the resource server.
+ */
+export interface BridgeTransport {
+    /** Send a JSON-RPC message to the resource server. */
+    send(message: McpAppsMessage): void;
+    /** Register a handler for incoming messages from the resource server. */
+    onMessage(handler: TransportMessageHandler): void;
+    /** Register a handler for connection state changes. */
+    onStateChange(handler: TransportStateHandler): void;
+    /** Connect to the resource server at the given URL. */
+    connect(url: string): Promise<void>;
+    /** Disconnect from the resource server. */
+    disconnect(): void;
+    /** Whether the transport is currently connected. */
+    readonly connected: boolean;
+}
+/**
+ * WebSocket-based transport for the MCP Apps Bridge.
+ *
+ * This is the primary transport. It provides full-duplex communication
+ * so the resource server can push notifications (tool results, context
+ * changes) to the app without polling.
+ *
+ * NOTE: This class uses browser WebSocket APIs. It is designed to run
+ * inside a platform webview (Telegram, LINE), not on the server side.
+ */
+export declare class WebSocketTransport implements BridgeTransport {
+    private ws;
+    private messageHandlers;
+    private stateHandlers;
+    send(message: McpAppsMessage): void;
+    onMessage(handler: TransportMessageHandler): void;
+    onStateChange(handler: TransportStateHandler): void;
+    connect(url: string): Promise<void>;
+    disconnect(): void;
+    get connected(): boolean;
+    private notifyState;
+}
+//# sourceMappingURL=transport.d.ts.map

package/script/core/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/core/transport.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,6DAA6D;AAC7D,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAExE,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAEpC,yEAAyE;IACzE,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAElD,uDAAuD;IACvD,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAEpD,uDAAuD;IACvD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,2CAA2C;IAC3C,UAAU,IAAI,IAAI,CAAC;IAEnB,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IAExD,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,aAAa,CAA+B;IAEpD,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IASnC,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAIjD,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAInD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CnC,UAAU,IAAI,IAAI;IAOlB,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,CAAC,WAAW;CAKpB"}

package/script/core/transport.js

@@ -0,0 +1,112 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketTransport = void 0;
+/**
+ * Transport abstraction for the MCP Apps Bridge.
+ *
+ * Defines how JSON-RPC messages travel between the bridge adapter
+ * (client-side, in the webview) and the resource server.
+ *
+ * The primary implementation is WebSocket, with HTTP POST as a fallback.
+ */
+const dntShim = __importStar(require("../_dnt.shims.js"));
+/**
+ * WebSocket-based transport for the MCP Apps Bridge.
+ *
+ * This is the primary transport. It provides full-duplex communication
+ * so the resource server can push notifications (tool results, context
+ * changes) to the app without polling.
+ *
+ * NOTE: This class uses browser WebSocket APIs. It is designed to run
+ * inside a platform webview (Telegram, LINE), not on the server side.
+ */
+class WebSocketTransport {
+    // deno-lint-ignore no-explicit-any
+    ws = null; // WebSocket instance (browser API)
+    messageHandlers = [];
+    stateHandlers = [];
+    send(message) {
+        if (!this.ws || this.ws.readyState !== 1 /* WebSocket.OPEN */) {
+            throw new Error("[WebSocketTransport] Not connected. Call connect() first.");
+        }
+        this.ws.send(JSON.stringify(message));
+    }
+    onMessage(handler) {
+        this.messageHandlers.push(handler);
+    }
+    onStateChange(handler) {
+        this.stateHandlers.push(handler);
+    }
+    connect(url) {
+        // deno-lint-ignore no-explicit-any
+        const WS = dntShim.dntGlobalThis.WebSocket;
+        if (!WS) {
+            throw new Error("[WebSocketTransport] WebSocket API not available. " +
+                "This transport requires a browser environment.");
+        }
+        return new Promise((resolve, reject) => {
+            const ws = new WS(url);
+            ws.onopen = () => {
+                this.ws = ws;
+                this.notifyState(true);
+                resolve();
+            };
+            ws.onerror = () => {
+                reject(new Error(`[WebSocketTransport] Failed to connect to ${url}.`));
+            };
+            ws.onmessage = (event) => {
+                try {
+                    const message = JSON.parse(event.data);
+                    for (const handler of this.messageHandlers) {
+                        handler(message);
+                    }
+                }
+                catch (err) {
+                    console.warn("[WebSocketTransport] Received non-JSON message, dropping:", err instanceof Error ? err.message : err);
+                }
+            };
+            ws.onclose = () => {
+                this.ws = null;
+                this.notifyState(false);
+            };
+        });
+    }
+    disconnect() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    get connected() {
+        return this.ws !== null && this.ws.readyState === 1; /* WebSocket.OPEN */
+    }
+    notifyState(connected) {
+        for (const handler of this.stateHandlers) {
+            handler(connected);
+        }
+    }
+}
+exports.WebSocketTransport = WebSocketTransport;