skybridge 0.0.0-dev.fd77b0f → 0.0.0-dev.fd947a0

package/dist/web/bridges/mcp-app/adaptor.js

@@ -0,0 +1,263 @@
+import { dequal } from "dequal/lite";
+import { McpAppBridge } from "./bridge.js";
+const STORAGE_PREFIX = "sb:";
+const MAX_STORAGE_ENTRIES = 200;
+function findStorageKey(viewUUID) {
+    const suffix = `:${viewUUID}`;
+    for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        if (key?.startsWith(STORAGE_PREFIX) && key.endsWith(suffix)) {
+            return key;
+        }
+    }
+    return undefined;
+}
+export class McpAppAdaptor {
+    static instance = null;
+    stores;
+    _viewState = null;
+    viewStateListeners = new Set();
+    _viewUUID = null;
+    _displayState = {
+        mode: "inline",
+    };
+    displayListeners = new Set();
+    constructor() {
+        this.stores = this.initializeStores();
+        this.subscribeToViewUUID();
+    }
+    static getInstance() {
+        if (!McpAppAdaptor.instance) {
+            McpAppAdaptor.instance = new McpAppAdaptor();
+        }
+        return McpAppAdaptor.instance;
+    }
+    static resetInstance() {
+        McpAppAdaptor.instance = null;
+    }
+    getHostContextStore(key) {
+        return this.stores[key];
+    }
+    callTool = async (name, args) => {
+        const app = await McpAppBridge.getInstance().getApp();
+        const response = await app.callServerTool({
+            name,
+            arguments: args ?? undefined,
+        });
+        return {
+            content: response.content,
+            structuredContent: response.structuredContent ?? {},
+            isError: response.isError ?? false,
+            meta: response._meta ?? {},
+        };
+    };
+    requestDisplayMode = async (mode) => {
+        const app = await McpAppBridge.getInstance().getApp();
+        return app.requestDisplayMode({ mode });
+    };
+    sendFollowUpMessage = async (prompt, _options) => {
+        const app = await McpAppBridge.getInstance().getApp();
+        await app.sendMessage({
+            role: "user",
+            content: [
+                {
+                    type: "text",
+                    text: prompt,
+                },
+            ],
+        });
+    };
+    openExternal(href, options) {
+        if (options?.redirectUrl === false) {
+            console.warn("[skybridge] redirectUrl option is not supported by the MCP ui/open-link protocol and will be ignored.");
+        }
+        McpAppBridge.getInstance()
+            .getApp()
+            .then((app) => app.openLink({ url: href }))
+            .catch((err) => {
+            console.error("Failed to open external link:", err);
+        });
+    }
+    initializeStores() {
+        return {
+            theme: this.createHostContextStore(["theme"], ({ theme }) => theme ?? "light"),
+            locale: this.createHostContextStore(["locale"], ({ locale }) => locale ?? "en-US"),
+            safeArea: this.createHostContextStore(["safeAreaInsets"], ({ safeAreaInsets }) => ({
+                insets: safeAreaInsets ?? { top: 0, right: 0, bottom: 0, left: 0 },
+            })),
+            displayMode: this.createHostContextStore(["displayMode"], ({ displayMode }) => displayMode ?? "inline"),
+            maxHeight: this.createHostContextStore(["containerDimensions"], ({ containerDimensions }) => {
+                if (containerDimensions && "maxHeight" in containerDimensions) {
+                    return containerDimensions.maxHeight;
+                }
+                return undefined;
+            }),
+            userAgent: this.createHostContextStore(["platform", "deviceCapabilities"], ({ platform, deviceCapabilities }) => ({
+                device: {
+                    type: platform === "web" ? "desktop" : (platform ?? "unknown"),
+                },
+                capabilities: {
+                    hover: true,
+                    touch: true,
+                    ...deviceCapabilities,
+                },
+            })),
+            toolInput: this.createHostContextStore(["toolInput"], ({ toolInput }) => toolInput ?? null),
+            toolOutput: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?.structuredContent ?? null),
+            toolResponseMetadata: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?._meta ?? null),
+            display: {
+                subscribe: (onChange) => {
+                    this.displayListeners.add(onChange);
+                    return () => {
+                        this.displayListeners.delete(onChange);
+                    };
+                },
+                getSnapshot: () => this._displayState,
+            },
+            viewState: {
+                subscribe: (onChange) => {
+                    this.viewStateListeners.add(onChange);
+                    return () => {
+                        this.viewStateListeners.delete(onChange);
+                    };
+                },
+                getSnapshot: () => this._viewState,
+            },
+        };
+    }
+    setViewState = async (stateOrUpdater) => {
+        const newState = typeof stateOrUpdater === "function"
+            ? stateOrUpdater(this._viewState)
+            : stateOrUpdater;
+        // must happen before the async bridge call to ensure the state is updated immediately for the UI,
+        // otherwise successive calls to setViewState may have stale state
+        this._viewState = newState;
+        this.viewStateListeners.forEach((listener) => {
+            listener();
+        });
+        this.persistToLocalStorage(newState);
+        try {
+            const app = await McpAppBridge.getInstance().getApp();
+            await app.updateModelContext({
+                structuredContent: newState,
+                content: [{ type: "text", text: JSON.stringify(newState) }],
+            });
+        }
+        catch (error) {
+            console.error("Failed to update view state in MCP App.", error);
+        }
+    };
+    /**
+     * @throws File upload is not supported in MCP App.
+     */
+    uploadFile() {
+        throw new Error("File upload is not supported in MCP App.");
+    }
+    /**
+     * @throws File download is not supported in MCP App.
+     */
+    getFileDownloadUrl() {
+        throw new Error("File download is not supported in MCP App.");
+    }
+    /**
+     * @throws File selection is not supported in MCP App.
+     */
+    selectFiles() {
+        throw new Error("File selection is not supported in MCP App.");
+    }
+    openModal(options) {
+        this._displayState = { mode: "modal", params: options.params };
+        this.displayListeners.forEach((listener) => {
+            listener();
+        });
+    }
+    closeModal() {
+        this._displayState = { mode: "inline" };
+        this.displayListeners.forEach((listener) => {
+            listener();
+        });
+    }
+    setOpenInAppUrl(_href) {
+        throw new Error("setOpenInAppUrl is not implemented in MCP App.");
+    }
+    subscribeToViewUUID() {
+        const bridge = McpAppBridge.getInstance();
+        bridge.subscribe("toolResult")(() => {
+            const toolResult = bridge.getSnapshot("toolResult");
+            const viewUUID = toolResult?._meta?.viewUUID;
+            if (viewUUID && viewUUID !== this._viewUUID) {
+                this._viewUUID = viewUUID;
+                this.restoreFromLocalStorage(viewUUID);
+            }
+        });
+    }
+    // localStorage keys: sb:{unix_ms}:{viewUUID}
+    // Timestamp is updated on every write (LRU); eviction drops the least recently used entries.
+    restoreFromLocalStorage(viewUUID) {
+        try {
+            const existingKey = findStorageKey(viewUUID);
+            if (existingKey) {
+                const stored = localStorage.getItem(existingKey);
+                if (stored !== null) {
+                    this._viewState = JSON.parse(stored);
+                    this.viewStateListeners.forEach((listener) => {
+                        listener();
+                    });
+                }
+            }
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    persistToLocalStorage(state) {
+        if (!this._viewUUID || state === null) {
+            return;
+        }
+        try {
+            // Remove old key for this view, write with fresh timestamp (LRU)
+            const oldKey = findStorageKey(this._viewUUID);
+            if (oldKey) {
+                localStorage.removeItem(oldKey);
+            }
+            const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;
+            localStorage.setItem(newKey, JSON.stringify(state));
+            // lru cleanup
+            const keys = [];
+            for (let i = 0; i < localStorage.length; i++) {
+                const key = localStorage.key(i);
+                if (key?.startsWith(STORAGE_PREFIX)) {
+                    keys.push(key);
+                }
+            }
+            if (keys.length <= MAX_STORAGE_ENTRIES) {
+                return;
+            }
+            keys.sort();
+            const toRemove = keys.slice(0, keys.length - MAX_STORAGE_ENTRIES);
+            for (const key of toRemove) {
+                localStorage.removeItem(key);
+            }
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    createHostContextStore(keys, computeSnapshot) {
+        const bridge = McpAppBridge.getInstance();
+        let cachedValue;
+        return {
+            subscribe: bridge.subscribe(keys),
+            getSnapshot: () => {
+                const context = Object.fromEntries(keys.map((k) => [k, bridge.getSnapshot(k)]));
+                const newValue = computeSnapshot(context);
+                if (cachedValue !== undefined && dequal(cachedValue, newValue)) {
+                    return cachedValue;
+                }
+                cachedValue = newValue;
+                return newValue;
+            },
+        };
+    }
+}
+//# sourceMappingURL=adaptor.js.map

package/dist/web/bridges/mcp-app/adaptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app/adaptor.ts"],"names":[],"mappings":"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","sourcesContent":["import { dequal } from \"dequal/lite\";\nimport type {\n  Adaptor,\n  CallToolResponse,\n  HostContext,\n  HostContextStore,\n  OpenExternalOptions,\n  RequestDisplayMode,\n  RequestModalOptions,\n  SendFollowUpMessageOptions,\n  SetViewStateAction,\n} from \"../types.js\";\nimport { McpAppBridge } from \"./bridge.js\";\nimport type { McpAppContext, McpAppContextKey } from \"./types.js\";\n\ntype PickContext<K extends readonly McpAppContextKey[]> = {\n  [P in K[number]]: McpAppContext[P];\n};\n\nconst STORAGE_PREFIX = \"sb:\";\nconst MAX_STORAGE_ENTRIES = 200;\n\nfunction findStorageKey(viewUUID: string): string | undefined {\n  const suffix = `:${viewUUID}`;\n  for (let i = 0; i < localStorage.length; i++) {\n    const key = localStorage.key(i);\n    if (key?.startsWith(STORAGE_PREFIX) && key.endsWith(suffix)) {\n      return key;\n    }\n  }\n  return undefined;\n}\n\nexport class McpAppAdaptor implements Adaptor {\n  private static instance: McpAppAdaptor | null = null;\n  private stores: {\n    [K in keyof HostContext]: HostContextStore<K>;\n  };\n  private _viewState: HostContext[\"viewState\"] = null;\n  private viewStateListeners = new Set<() => void>();\n  private _viewUUID: string | null = null;\n\n  private _displayState: HostContext[\"display\"] = {\n    mode: \"inline\",\n  };\n  private displayListeners = new Set<() => void>();\n\n  private constructor() {\n    this.stores = this.initializeStores();\n    this.subscribeToViewUUID();\n  }\n\n  public static getInstance(): McpAppAdaptor {\n    if (!McpAppAdaptor.instance) {\n      McpAppAdaptor.instance = new McpAppAdaptor();\n    }\n    return McpAppAdaptor.instance;\n  }\n\n  public static resetInstance(): void {\n    McpAppAdaptor.instance = null;\n  }\n\n  public getHostContextStore<K extends keyof HostContext>(\n    key: K,\n  ): HostContextStore<K> {\n    return this.stores[key];\n  }\n\n  public callTool = async <\n    ToolArgs extends Record<string, unknown> | null = null,\n    ToolResponse extends CallToolResponse = CallToolResponse,\n  >(\n    name: string,\n    args: ToolArgs,\n  ): Promise<ToolResponse> => {\n    const app = await McpAppBridge.getInstance().getApp();\n    const response = await app.callServerTool({\n      name,\n      arguments: args ?? undefined,\n    });\n\n    return {\n      content: response.content,\n      structuredContent: response.structuredContent ?? {},\n      isError: response.isError ?? false,\n      meta: response._meta ?? {},\n    } as ToolResponse;\n  };\n\n  public requestDisplayMode = async (mode: RequestDisplayMode) => {\n    const app = await McpAppBridge.getInstance().getApp();\n    return app.requestDisplayMode({ mode });\n  };\n\n  public sendFollowUpMessage = async (\n    prompt: string,\n    _options?: SendFollowUpMessageOptions,\n  ) => {\n    const app = await McpAppBridge.getInstance().getApp();\n    await app.sendMessage({\n      role: \"user\",\n      content: [\n        {\n          type: \"text\",\n          text: prompt,\n        },\n      ],\n    });\n  };\n\n  public openExternal(href: string, options?: OpenExternalOptions): void {\n    if (options?.redirectUrl === false) {\n      console.warn(\n        \"[skybridge] redirectUrl option is not supported by the MCP ui/open-link protocol and will be ignored.\",\n      );\n    }\n\n    McpAppBridge.getInstance()\n      .getApp()\n      .then((app) => app.openLink({ url: href }))\n      .catch((err) => {\n        console.error(\"Failed to open external link:\", err);\n      });\n  }\n\n  private initializeStores(): {\n    [K in keyof HostContext]: HostContextStore<K>;\n  } {\n    return {\n      theme: this.createHostContextStore(\n        [\"theme\"],\n        ({ theme }) => theme ?? \"light\",\n      ),\n      locale: this.createHostContextStore(\n        [\"locale\"],\n        ({ locale }) => locale ?? \"en-US\",\n      ),\n      safeArea: this.createHostContextStore(\n        [\"safeAreaInsets\"],\n        ({ safeAreaInsets }) => ({\n          insets: safeAreaInsets ?? { top: 0, right: 0, bottom: 0, left: 0 },\n        }),\n      ),\n      displayMode: this.createHostContextStore(\n        [\"displayMode\"],\n        ({ displayMode }) => displayMode ?? \"inline\",\n      ),\n      maxHeight: this.createHostContextStore(\n        [\"containerDimensions\"],\n        ({ containerDimensions }) => {\n          if (containerDimensions && \"maxHeight\" in containerDimensions) {\n            return containerDimensions.maxHeight;\n          }\n\n          return undefined;\n        },\n      ),\n      userAgent: this.createHostContextStore(\n        [\"platform\", \"deviceCapabilities\"],\n        ({ platform, deviceCapabilities }) => ({\n          device: {\n            type: platform === \"web\" ? \"desktop\" : (platform ?? \"unknown\"),\n          },\n          capabilities: {\n            hover: true,\n            touch: true,\n            ...deviceCapabilities,\n          },\n        }),\n      ),\n      toolInput: this.createHostContextStore(\n        [\"toolInput\"],\n        ({ toolInput }) => toolInput ?? null,\n      ),\n      toolOutput: this.createHostContextStore(\n        [\"toolResult\"],\n        ({ toolResult }) => toolResult?.structuredContent ?? null,\n      ),\n      toolResponseMetadata: this.createHostContextStore(\n        [\"toolResult\"],\n        ({ toolResult }) => toolResult?._meta ?? null,\n      ),\n      display: {\n        subscribe: (onChange: () => void) => {\n          this.displayListeners.add(onChange);\n          return () => {\n            this.displayListeners.delete(onChange);\n          };\n        },\n        getSnapshot: () => this._displayState,\n      },\n      viewState: {\n        subscribe: (onChange: () => void) => {\n          this.viewStateListeners.add(onChange);\n          return () => {\n            this.viewStateListeners.delete(onChange);\n          };\n        },\n        getSnapshot: () => this._viewState,\n      },\n    };\n  }\n\n  public setViewState = async (\n    stateOrUpdater: SetViewStateAction,\n  ): Promise<void> => {\n    const newState =\n      typeof stateOrUpdater === \"function\"\n        ? stateOrUpdater(this._viewState)\n        : stateOrUpdater;\n\n    // must happen before the async bridge call to ensure the state is updated immediately for the UI,\n    // otherwise successive calls to setViewState may have stale state\n    this._viewState = newState;\n    this.viewStateListeners.forEach((listener) => {\n      listener();\n    });\n\n    this.persistToLocalStorage(newState);\n\n    try {\n      const app = await McpAppBridge.getInstance().getApp();\n      await app.updateModelContext({\n        structuredContent: newState,\n        content: [{ type: \"text\", text: JSON.stringify(newState) }],\n      });\n    } catch (error) {\n      console.error(\"Failed to update view state in MCP App.\", error);\n    }\n  };\n\n  /**\n   * @throws File upload is not supported in MCP App.\n   */\n  public uploadFile(): Promise<{ fileId: string }> {\n    throw new Error(\"File upload is not supported in MCP App.\");\n  }\n\n  /**\n   * @throws File download is not supported in MCP App.\n   */\n  public getFileDownloadUrl(): Promise<{ downloadUrl: string }> {\n    throw new Error(\"File download is not supported in MCP App.\");\n  }\n\n  /**\n   * @throws File selection is not supported in MCP App.\n   */\n  public selectFiles(): Promise<{ fileId: string }[]> {\n    throw new Error(\"File selection is not supported in MCP App.\");\n  }\n\n  public openModal(options: RequestModalOptions) {\n    this._displayState = { mode: \"modal\", params: options.params };\n    this.displayListeners.forEach((listener) => {\n      listener();\n    });\n  }\n\n  public closeModal() {\n    this._displayState = { mode: \"inline\" };\n    this.displayListeners.forEach((listener) => {\n      listener();\n    });\n  }\n\n  public setOpenInAppUrl(_href: string): Promise<void> {\n    throw new Error(\"setOpenInAppUrl is not implemented in MCP App.\");\n  }\n\n  private subscribeToViewUUID(): void {\n    const bridge = McpAppBridge.getInstance();\n    bridge.subscribe(\"toolResult\")(() => {\n      const toolResult = bridge.getSnapshot(\"toolResult\");\n      const viewUUID = (\n        toolResult?._meta as Record<string, unknown> | undefined\n      )?.viewUUID as string | undefined;\n\n      if (viewUUID && viewUUID !== this._viewUUID) {\n        this._viewUUID = viewUUID;\n        this.restoreFromLocalStorage(viewUUID);\n      }\n    });\n  }\n\n  // localStorage keys: sb:{unix_ms}:{viewUUID}\n  // Timestamp is updated on every write (LRU); eviction drops the least recently used entries.\n  private restoreFromLocalStorage(viewUUID: string): void {\n    try {\n      const existingKey = findStorageKey(viewUUID);\n      if (existingKey) {\n        const stored = localStorage.getItem(existingKey);\n        if (stored !== null) {\n          this._viewState = JSON.parse(stored);\n          this.viewStateListeners.forEach((listener) => {\n            listener();\n          });\n        }\n      }\n    } catch (err) {\n      console.error(err);\n    }\n  }\n\n  private persistToLocalStorage(state: Record<string, unknown> | null): void {\n    if (!this._viewUUID || state === null) {\n      return;\n    }\n    try {\n      // Remove old key for this view, write with fresh timestamp (LRU)\n      const oldKey = findStorageKey(this._viewUUID);\n      if (oldKey) {\n        localStorage.removeItem(oldKey);\n      }\n      const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;\n      localStorage.setItem(newKey, JSON.stringify(state));\n\n      // lru cleanup\n      const keys: string[] = [];\n      for (let i = 0; i < localStorage.length; i++) {\n        const key = localStorage.key(i);\n        if (key?.startsWith(STORAGE_PREFIX)) {\n          keys.push(key);\n        }\n      }\n      if (keys.length <= MAX_STORAGE_ENTRIES) {\n        return;\n      }\n      keys.sort();\n      const toRemove = keys.slice(0, keys.length - MAX_STORAGE_ENTRIES);\n      for (const key of toRemove) {\n        localStorage.removeItem(key);\n      }\n    } catch (err) {\n      console.error(err);\n    }\n  }\n\n  private createHostContextStore<\n    const Keys extends readonly McpAppContextKey[],\n    R,\n  >(keys: Keys, computeSnapshot: (context: PickContext<Keys>) => R) {\n    const bridge = McpAppBridge.getInstance();\n    let cachedValue: R | undefined;\n\n    return {\n      subscribe: bridge.subscribe(keys),\n      getSnapshot: () => {\n        const context = Object.fromEntries(\n          keys.map((k) => [k, bridge.getSnapshot(k)]),\n        ) as PickContext<Keys>;\n        const newValue = computeSnapshot(context);\n\n        if (cachedValue !== undefined && dequal(cachedValue, newValue)) {\n          return cachedValue;\n        }\n\n        cachedValue = newValue;\n        return newValue;\n      },\n    };\n  }\n}\n"]}

package/dist/web/bridges/mcp-app/bridge.d.ts

@@ -0,0 +1,26 @@
+import { App } from "@modelcontextprotocol/ext-apps";
+import type { Implementation } from "@modelcontextprotocol/sdk/types.js";
+import type { Bridge, Subscribe } from "../types.js";
+import type { McpAppContext, McpAppContextKey } from "./types.js";
+export declare class McpAppBridge implements Bridge<McpAppContext> {
+    private static instance;
+    context: McpAppContext;
+    private listeners;
+    private app;
+    private connectPromise;
+    constructor(options: {
+        appInfo: Implementation;
+    });
+    private connect;
+    getApp(): Promise<App>;
+    static getInstance(options?: Partial<{
+        appInfo: Implementation;
+    }>): McpAppBridge;
+    subscribe(key: McpAppContextKey): Subscribe;
+    subscribe(keys: readonly McpAppContextKey[]): Subscribe;
+    getSnapshot<K extends keyof McpAppContext>(key: K): McpAppContext[K];
+    cleanup: () => void;
+    static resetInstance(): void;
+    private emit;
+    private updateContext;
+}

package/dist/web/bridges/mcp-app/bridge.js

@@ -0,0 +1,102 @@
+import { App } from "@modelcontextprotocol/ext-apps";
+export class McpAppBridge {
+    static instance = null;
+    context = {
+        toolInput: null,
+        toolCancelled: null,
+        toolResult: null,
+    };
+    listeners = new Map();
+    app;
+    connectPromise;
+    constructor(options) {
+        this.app = new App(options.appInfo);
+        this.app.ontoolinput = (params) => {
+            this.updateContext({ toolInput: params.arguments ?? {} });
+        };
+        this.app.ontoolinputpartial = (params) => {
+            this.updateContext({ toolInput: params.arguments ?? {} });
+        };
+        this.app.ontoolresult = (params) => {
+            this.updateContext({ toolResult: params });
+        };
+        this.app.ontoolcancelled = (params) => {
+            this.updateContext({ toolCancelled: params });
+        };
+        this.app.onhostcontextchanged = (params) => {
+            this.updateContext(params);
+        };
+        this.connectPromise = this.connect();
+    }
+    async connect() {
+        try {
+            await this.app.connect();
+            const hostContext = this.app.getHostContext();
+            if (hostContext) {
+                this.updateContext(hostContext);
+            }
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    async getApp() {
+        await this.connectPromise;
+        return this.app;
+    }
+    static getInstance(options) {
+        if (window.skybridge.hostType !== "mcp-app") {
+            throw new Error("MCP App Bridge can only be used in the mcp-app runtime");
+        }
+        if (McpAppBridge.instance && options) {
+            console.warn("McpAppBridge.getInstance: options ignored, instance already exists");
+        }
+        if (!McpAppBridge.instance) {
+            const defaultOptions = {
+                appInfo: { name: "skybridge-app", version: "0.0.1" },
+            };
+            McpAppBridge.instance = new McpAppBridge({
+                ...defaultOptions,
+                ...options,
+            });
+        }
+        return McpAppBridge.instance;
+    }
+    subscribe(keyOrKeys) {
+        const keys = Array.isArray(keyOrKeys) ? keyOrKeys : [keyOrKeys];
+        return (onChange) => {
+            for (const key of keys) {
+                this.listeners.set(key, new Set([...(this.listeners.get(key) || []), onChange]));
+            }
+            return () => {
+                for (const key of keys) {
+                    this.listeners.get(key)?.delete(onChange);
+                }
+            };
+        };
+    }
+    getSnapshot(key) {
+        return this.context[key];
+    }
+    cleanup = () => {
+        this.listeners.clear();
+    };
+    static resetInstance() {
+        if (McpAppBridge.instance) {
+            McpAppBridge.instance.cleanup();
+            McpAppBridge.instance = null;
+        }
+    }
+    emit(key) {
+        this.listeners.get(key)?.forEach((listener) => {
+            listener();
+        });
+    }
+    updateContext(context) {
+        this.context = { ...this.context, ...context };
+        for (const key of Object.keys(context)) {
+            this.emit(key);
+        }
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/web/bridges/mcp-app/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app/bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import { App } from \"@modelcontextprotocol/ext-apps\";\nimport type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { Bridge, Subscribe } from \"../types.js\";\nimport type { McpAppContext, McpAppContextKey } from \"./types.js\";\n\nexport class McpAppBridge implements Bridge<McpAppContext> {\n  private static instance: McpAppBridge | null = null;\n  public context: McpAppContext = {\n    toolInput: null,\n    toolCancelled: null,\n    toolResult: null,\n  };\n  private listeners = new Map<McpAppContextKey, Set<() => void>>();\n  private app: App;\n  private connectPromise: Promise<void>;\n\n  constructor(options: { appInfo: Implementation }) {\n    this.app = new App(options.appInfo);\n\n    this.app.ontoolinput = (params) => {\n      this.updateContext({ toolInput: params.arguments ?? {} });\n    };\n\n    this.app.ontoolinputpartial = (params) => {\n      this.updateContext({ toolInput: params.arguments ?? {} });\n    };\n\n    this.app.ontoolresult = (params) => {\n      this.updateContext({ toolResult: params });\n    };\n\n    this.app.ontoolcancelled = (params) => {\n      this.updateContext({ toolCancelled: params });\n    };\n\n    this.app.onhostcontextchanged = (params) => {\n      this.updateContext(params);\n    };\n\n    this.connectPromise = this.connect();\n  }\n\n  private async connect() {\n    try {\n      await this.app.connect();\n      const hostContext = this.app.getHostContext();\n      if (hostContext) {\n        this.updateContext(hostContext);\n      }\n    } catch (err) {\n      console.error(err);\n    }\n  }\n\n  public async getApp(): Promise<App> {\n    await this.connectPromise;\n    return this.app;\n  }\n\n  public static getInstance(\n    options?: Partial<{ appInfo: Implementation }>,\n  ): McpAppBridge {\n    if (window.skybridge.hostType !== \"mcp-app\") {\n      throw new Error(\"MCP App Bridge can only be used in the mcp-app runtime\");\n    }\n    if (McpAppBridge.instance && options) {\n      console.warn(\n        \"McpAppBridge.getInstance: options ignored, instance already exists\",\n      );\n    }\n    if (!McpAppBridge.instance) {\n      const defaultOptions = {\n        appInfo: { name: \"skybridge-app\", version: \"0.0.1\" },\n      };\n      McpAppBridge.instance = new McpAppBridge({\n        ...defaultOptions,\n        ...options,\n      });\n    }\n    return McpAppBridge.instance;\n  }\n\n  public subscribe(key: McpAppContextKey): Subscribe;\n  public subscribe(keys: readonly McpAppContextKey[]): Subscribe;\n  public subscribe(\n    keyOrKeys: McpAppContextKey | readonly McpAppContextKey[],\n  ): Subscribe {\n    const keys = Array.isArray(keyOrKeys) ? keyOrKeys : [keyOrKeys];\n    return (onChange: () => void) => {\n      for (const key of keys) {\n        this.listeners.set(\n          key,\n          new Set([...(this.listeners.get(key) || []), onChange]),\n        );\n      }\n      return () => {\n        for (const key of keys) {\n          this.listeners.get(key)?.delete(onChange);\n        }\n      };\n    };\n  }\n\n  public getSnapshot<K extends keyof McpAppContext>(key: K): McpAppContext[K] {\n    return this.context[key];\n  }\n\n  public cleanup = () => {\n    this.listeners.clear();\n  };\n\n  public static resetInstance(): void {\n    if (McpAppBridge.instance) {\n      McpAppBridge.instance.cleanup();\n      McpAppBridge.instance = null;\n    }\n  }\n\n  private emit(key: McpAppContextKey) {\n    this.listeners.get(key)?.forEach((listener) => {\n      listener();\n    });\n  }\n\n  private updateContext(context: Partial<McpAppContext>) {\n    this.context = { ...this.context, ...context };\n    for (const key of Object.keys(context)) {\n      this.emit(key);\n    }\n  }\n}\n"]}

package/dist/web/bridges/mcp-app/index.d.ts

@@ -0,0 +1,4 @@
+export { McpAppAdaptor } from "./adaptor.js";
+export { McpAppBridge } from "./bridge.js";
+export type { McpAppContext, McpAppContextKey, McpToolState, } from "./types.js";
+export { useMcpAppContext } from "./use-mcp-app-context.js";

package/dist/web/bridges/mcp-app/index.js

@@ -0,0 +1,4 @@
+export { McpAppAdaptor } from "./adaptor.js";
+export { McpAppBridge } from "./bridge.js";
+export { useMcpAppContext } from "./use-mcp-app-context.js";
+//# sourceMappingURL=index.js.map

package/dist/web/bridges/mcp-app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export { McpAppAdaptor } from \"./adaptor.js\";\nexport { McpAppBridge } from \"./bridge.js\";\nexport type {\n  McpAppContext,\n  McpAppContextKey,\n  McpToolState,\n} from \"./types.js\";\nexport { useMcpAppContext } from \"./use-mcp-app-context.js\";\n"]}

package/dist/web/bridges/mcp-app/types.d.ts

@@ -0,0 +1,8 @@
+import type { McpUiHostContext, McpUiToolCancelledNotification, McpUiToolInputNotification, McpUiToolResultNotification } from "@modelcontextprotocol/ext-apps";
+export type McpToolState = {
+    toolInput: NonNullable<McpUiToolInputNotification["params"]["arguments"]> | null;
+    toolResult: McpUiToolResultNotification["params"] | null;
+    toolCancelled: McpUiToolCancelledNotification["params"] | null;
+};
+export type McpAppContext = McpUiHostContext & McpToolState;
+export type McpAppContextKey = keyof McpAppContext;

package/dist/web/bridges/mcp-app/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/web/bridges/mcp-app/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  McpUiHostContext,\n  McpUiToolCancelledNotification,\n  McpUiToolInputNotification,\n  McpUiToolResultNotification,\n} from \"@modelcontextprotocol/ext-apps\";\n\nexport type McpToolState = {\n  toolInput: NonNullable<\n    McpUiToolInputNotification[\"params\"][\"arguments\"]\n  > | null;\n  toolResult: McpUiToolResultNotification[\"params\"] | null;\n  toolCancelled: McpUiToolCancelledNotification[\"params\"] | null;\n};\n\nexport type McpAppContext = McpUiHostContext & McpToolState;\n\nexport type McpAppContextKey = keyof McpAppContext;\n"]}

package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts

@@ -0,0 +1,7 @@
+import type { Implementation } from "@modelcontextprotocol/sdk/types.js";
+import type { McpAppContext } from "./types.js";
+type McpAppInitializationOptions = {
+    appInfo: Implementation;
+};
+export declare function useMcpAppContext<K extends keyof McpAppContext>(key: K, options?: Partial<McpAppInitializationOptions>): McpAppContext[K];
+export {};

package/dist/web/bridges/mcp-app/use-mcp-app-context.js

@@ -0,0 +1,7 @@
+import { useSyncExternalStore } from "react";
+import { McpAppBridge } from "./bridge.js";
+export function useMcpAppContext(key, options) {
+    const bridge = McpAppBridge.getInstance(options);
+    return useSyncExternalStore(bridge.subscribe(key), () => bridge.getSnapshot(key));
+}
+//# sourceMappingURL=use-mcp-app-context.js.map

package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mcp-app-context.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app/use-mcp-app-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,MAAM,UAAU,gBAAgB,CAC9B,GAAM,EACN,OAA8C;IAE9C,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CACtD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CACxB,CAAC;AACJ,CAAC","sourcesContent":["import type { Implementation } from \"@modelcontextprotocol/sdk/types.js\";\n\nimport { useSyncExternalStore } from \"react\";\nimport { McpAppBridge } from \"./bridge.js\";\nimport type { McpAppContext } from \"./types.js\";\n\ntype McpAppInitializationOptions = {\n  appInfo: Implementation;\n};\n\nexport function useMcpAppContext<K extends keyof McpAppContext>(\n  key: K,\n  options?: Partial<McpAppInitializationOptions>,\n): McpAppContext[K] {\n  const bridge = McpAppBridge.getInstance(options);\n  return useSyncExternalStore(bridge.subscribe(key), () =>\n    bridge.getSnapshot(key),\n  );\n}\n"]}

package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js

@@ -0,0 +1,26 @@
+import { renderHook, waitFor } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { getMcpAppHostPostMessageMock, MockResizeObserver, } from "../../hooks/test/utils.js";
+import { McpAppBridge } from "./bridge.js";
+import { useMcpAppContext } from "./use-mcp-app-context.js";
+describe("useMcpAppContext", () => {
+    beforeEach(async () => {
+        vi.stubGlobal("skybridge", { hostType: "mcp-app" });
+        vi.stubGlobal("ResizeObserver", MockResizeObserver);
+        McpAppBridge.resetInstance();
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.clearAllMocks();
+    });
+    it("should return the theme value from host context and update on notification", async () => {
+        vi.stubGlobal("parent", {
+            postMessage: getMcpAppHostPostMessageMock({ theme: "light" }),
+        });
+        const { result } = renderHook(() => useMcpAppContext("theme"));
+        await waitFor(() => {
+            expect(result.current).toBe("light");
+        });
+    });
+});
+//# sourceMappingURL=use-mcp-app-context.test.js.map

package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mcp-app-context.test.js","sourceRoot":"","sources":["../../../../src/web/bridges/mcp-app/use-mcp-app-context.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QACpD,EAAE,CAAC,UAAU,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;QACpD,YAAY,CAAC,aAAa,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE;YACtB,WAAW,EAAE,4BAA4B,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;SAC9D,CAAC,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;QAE/D,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { renderHook, waitFor } from \"@testing-library/react\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport {\n  getMcpAppHostPostMessageMock,\n  MockResizeObserver,\n} from \"../../hooks/test/utils.js\";\nimport { McpAppBridge } from \"./bridge.js\";\nimport { useMcpAppContext } from \"./use-mcp-app-context.js\";\n\ndescribe(\"useMcpAppContext\", () => {\n  beforeEach(async () => {\n    vi.stubGlobal(\"skybridge\", { hostType: \"mcp-app\" });\n    vi.stubGlobal(\"ResizeObserver\", MockResizeObserver);\n    McpAppBridge.resetInstance();\n  });\n\n  afterEach(() => {\n    vi.unstubAllGlobals();\n    vi.clearAllMocks();\n  });\n\n  it(\"should return the theme value from host context and update on notification\", async () => {\n    vi.stubGlobal(\"parent\", {\n      postMessage: getMcpAppHostPostMessageMock({ theme: \"light\" }),\n    });\n    const { result } = renderHook(() => useMcpAppContext(\"theme\"));\n\n    await waitFor(() => {\n      expect(result.current).toBe(\"light\");\n    });\n  });\n});\n"]}

package/dist/web/bridges/types.d.ts

@@ -0,0 +1,111 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { useSyncExternalStore } from "react";
+import type { ViewHostType } from "../../server/index.js";
+export type SkybridgeProperties = {
+    hostType: ViewHostType;
+    serverUrl: string;
+};
+declare global {
+    interface Window {
+        skybridge: SkybridgeProperties;
+    }
+}
+export type CallToolArgs = Record<string, unknown> | null;
+export type CallToolResponse = {
+    content: CallToolResult["content"];
+    structuredContent: NonNullable<CallToolResult["structuredContent"]>;
+    isError: NonNullable<CallToolResult["isError"]>;
+    meta?: CallToolResult["_meta"];
+};
+export type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
+export type RequestDisplayMode = Exclude<DisplayMode, "modal">;
+export type Theme = "light" | "dark";
+export type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
+export type SafeAreaInsets = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+export type SafeArea = {
+    insets: SafeAreaInsets;
+};
+export type UserAgent = {
+    device: {
+        type: DeviceType;
+    };
+    capabilities: {
+        hover: boolean;
+        touch: boolean;
+    };
+};
+export interface HostContext {
+    theme: Theme;
+    locale: string;
+    displayMode: DisplayMode;
+    safeArea: SafeArea;
+    maxHeight: number | undefined;
+    userAgent: UserAgent;
+    toolInput: Record<string, unknown> | null;
+    toolOutput: Record<string, unknown> | null;
+    toolResponseMetadata: Record<string, unknown> | null;
+    display: {
+        mode: DisplayMode;
+        params?: Record<string, unknown>;
+    };
+    viewState: Record<string, unknown> | null;
+}
+export type Subscribe = Parameters<typeof useSyncExternalStore>[0];
+export interface Bridge<Context> {
+    subscribe(key: keyof Context): Subscribe;
+    subscribe(keys: readonly (keyof Context)[]): Subscribe;
+    getSnapshot<K extends keyof Context>(key: K): Context[K] | undefined;
+}
+export type HostContextStore<K extends keyof HostContext> = {
+    subscribe: Subscribe;
+    getSnapshot: () => HostContext[K];
+};
+export type ViewState = Record<string, unknown>;
+export type SetViewStateAction = ViewState | ((prevState: ViewState | null) => ViewState);
+export type FileMetadata = {
+    fileId: string;
+    fileName?: string;
+    mimeType?: string;
+};
+export type UploadFileOptions = {
+    library?: boolean;
+};
+export type RequestModalOptions = {
+    title?: string;
+    params?: Record<string, unknown>;
+    template?: string;
+    anchor?: {
+        top?: number;
+        left?: number;
+        width?: number;
+        height?: number;
+    };
+};
+export type OpenExternalOptions = {
+    redirectUrl?: false;
+};
+export type SendFollowUpMessageOptions = {
+    scrollToBottom?: boolean;
+};
+export interface Adaptor {
+    getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<K>;
+    callTool<ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs): Promise<ToolResponse>;
+    requestDisplayMode(mode: RequestDisplayMode): Promise<{
+        mode: RequestDisplayMode;
+    }>;
+    sendFollowUpMessage(prompt: string, options?: SendFollowUpMessageOptions): Promise<void>;
+    openExternal(href: string, options?: OpenExternalOptions): void;
+    setViewState(stateOrUpdater: SetViewStateAction): Promise<void>;
+    uploadFile(file: File, options?: UploadFileOptions): Promise<FileMetadata>;
+    getFileDownloadUrl(file: FileMetadata): Promise<{
+        downloadUrl: string;
+    }>;
+    selectFiles(): Promise<FileMetadata[]>;
+    openModal(options: RequestModalOptions): void;
+    setOpenInAppUrl(href: string): Promise<void>;
+}

package/dist/web/bridges/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map