skybridge 0.0.0-dev.da10bf6 → 0.0.0-dev.dbd3f0e

package/dist/{src/web → web/bridges/apps-sdk}/types.d.ts

@@ -1,18 +1,6 @@
-import "react";
-declare module "react" {
-    interface HTMLAttributes<T> {
-        "data-llm"?: string;
-    }
-}
-export type UnknownObject = Record<string, unknown>;
-export type Prettify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-export type Objectify<T> = T & UnknownObject;
-type RequiredKeys<T> = {
-    [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;
-}[keyof T];
-export type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;
+import type { UnknownObject } from "../../types.js";
+import type { CallToolArgs, CallToolResponse } from "../types.js";
+type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
 type WidgetState = UnknownObject;
 type FileMetadata = {
     fileId: string;
@@ -28,19 +16,20 @@ export declare class ToolResponseEvent extends CustomEvent<{
 }
 declare global {
     interface Window {
-        openai: OpenAiMethods<WidgetState> & OpenAiProperties;
+        openai: AppsSdkMethods<WidgetState> & AppsSdkContext;
     }
     interface WindowEventMap {
         [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
     }
 }
-export type OpenAiProperties<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
+export type AppsSdkContext<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
     theme: Theme;
     userAgent: UserAgent;
     locale: string;
     maxHeight: number;
     displayMode: DisplayMode;
     safeArea: SafeArea;
+    view: View;
     toolInput: ToolInput;
     toolOutput: ToolOutput | {
         text: string;
@@ -48,18 +37,17 @@ export type OpenAiProperties<ToolInput extends UnknownObject = Record<never, unk
     toolResponseMetadata: ToolResponseMetadata | null;
     widgetState: WidgetState | null;
 };
-export type CallToolArgs = Record<string, unknown> | null;
-export type CallToolResponse = {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: Record<string, unknown>;
-    isError: boolean;
-    result: string;
-    meta: Record<string, unknown>;
+export type RequestModalOptions = {
+    title?: string;
+    params?: Record<string, unknown>;
+    anchor?: {
+        top?: number;
+        left?: number;
+        width?: number;
+        height?: number;
+    };
 };
-export type OpenAiMethods<WidgetState extends UnknownObject = UnknownObject> = {
+export type AppsSdkMethods<WidgetState extends UnknownObject = UnknownObject> = {
     /** Calls a tool on your MCP. Returns the full response. */
     callTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
     /** Triggers a followup turn in the ChatGPT conversation */
@@ -89,39 +77,39 @@ export type OpenAiMethods<WidgetState extends UnknownObject = UnknownObject> = {
      * Opens a modal portaled outside of the widget iFrame.
      * This ensures the modal is correctly displayed and not limited to the widget's area.
      */
-    requestModal: (args: {
-        title: string;
-    }) => Promise<void>;
+    requestModal: (args: RequestModalOptions) => Promise<void>;
     /** Uploads a new file to the host */
     uploadFile: (file: File) => Promise<FileMetadata>;
     /**
      * Downloads a file from the host that was previously uploaded.
      * Only files uploaded by the same connector instance can be downloaded.
      */
-    downloadFile: (file: FileMetadata) => Promise<{
+    getFileDownloadUrl: (file: FileMetadata) => Promise<{
         downloadUrl: string;
     }>;
 };
 export declare const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
 export declare class SetGlobalsEvent extends CustomEvent<{
-    globals: Partial<OpenAiProperties>;
+    globals: Partial<AppsSdkContext>;
 }> {
     readonly type = "openai:set_globals";
 }
-export type CallTool = (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
-export type DisplayMode = "pip" | "inline" | "fullscreen";
-export type Theme = "light" | "dark";
-export type SafeAreaInsets = {
+type View = {
+    mode: DisplayMode;
+    params?: Record<string, unknown>;
+};
+type Theme = "light" | "dark";
+type SafeAreaInsets = {
     top: number;
     bottom: number;
     left: number;
     right: number;
 };
-export type SafeArea = {
+type SafeArea = {
     insets: SafeAreaInsets;
 };
-export type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
-export type UserAgent = {
+type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
+type UserAgent = {
     device: {
         type: DeviceType;
     };

package/dist/{src/web → web/bridges/apps-sdk}/types.js

@@ -1,4 +1,3 @@
-import "react";
 export const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
 export class ToolResponseEvent extends CustomEvent {
     type = TOOL_RESPONSE_EVENT_TYPE;

package/dist/web/bridges/apps-sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/types.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AA2FD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}

package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts

@@ -0,0 +1,2 @@
+import type { AppsSdkContext } from "./types.js";
+export declare function useAppsSdkContext<K extends keyof AppsSdkContext>(key: K): AppsSdkContext[K];

package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js

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

package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-apps-sdk-context.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/use-apps-sdk-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,UAAU,iBAAiB,CAC/B,GAAM;IAEN,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CACtD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CACxB,CAAC;AACJ,CAAC"}

package/dist/web/bridges/get-adaptor.d.ts

@@ -0,0 +1,2 @@
+import type { Adaptor } from "./types.js";
+export declare const getAdaptor: () => Adaptor;

package/dist/web/bridges/get-adaptor.js

@@ -0,0 +1,8 @@
+import { AppsSdkAdaptor } from "./apps-sdk/adaptor.js";
+import { McpAppAdaptor } from "./mcp-app/adaptor.js";
+export const getAdaptor = () => {
+    return window.skybridge.hostType === "apps-sdk"
+        ? AppsSdkAdaptor.getInstance()
+        : McpAppAdaptor.getInstance();
+};
+//# sourceMappingURL=get-adaptor.js.map

package/dist/web/bridges/get-adaptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-adaptor.js","sourceRoot":"","sources":["../../../src/web/bridges/get-adaptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE;IACtC,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;QAC7C,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE;QAC9B,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from "./apps-sdk/index.js";
+export { getAdaptor } from "./get-adaptor.js";
+export * from "./mcp-app/index.js";
+export * from "./types.js";
+export { useHostContext } from "./use-host-context.js";

package/dist/web/bridges/index.js

@@ -0,0 +1,6 @@
+export * from "./apps-sdk/index.js";
+export { getAdaptor } from "./get-adaptor.js";
+export * from "./mcp-app/index.js";
+export * from "./types.js";
+export { useHostContext } from "./use-host-context.js";
+//# sourceMappingURL=index.js.map

package/dist/web/bridges/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web/bridges/index.tsx"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,19 @@
+import type { McpUiRequestDisplayModeResult } from "@modelcontextprotocol/ext-apps";
+import type { Adaptor, CallToolResponse, DisplayMode, HostContext, HostContextStore, SetWidgetStateAction } from "../types.js";
+export declare class McpAppAdaptor implements Adaptor {
+    private static instance;
+    private stores;
+    private _widgetState;
+    private widgetStateListeners;
+    private constructor();
+    static getInstance(): McpAppAdaptor;
+    static resetInstance(): void;
+    getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<K>;
+    callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
+    requestDisplayMode: (mode: DisplayMode) => Promise<McpUiRequestDisplayModeResult>;
+    sendFollowUpMessage: (prompt: string) => Promise<void>;
+    openExternal(href: string): void;
+    private initializeStores;
+    setWidgetState: (stateOrUpdater: SetWidgetStateAction) => Promise<void>;
+    private createHostContextStore;
+}

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

@@ -0,0 +1,145 @@
+import { dequal } from "dequal/lite";
+import { McpAppBridge } from "./bridge.js";
+export class McpAppAdaptor {
+    static instance = null;
+    stores;
+    _widgetState = null;
+    widgetStateListeners = new Set();
+    constructor() {
+        this.stores = this.initializeStores();
+    }
+    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 bridge = McpAppBridge.getInstance();
+        const response = await bridge.request({
+            method: "tools/call",
+            params: {
+                name,
+                arguments: args ?? undefined,
+            },
+        });
+        const result = response.content
+            .filter((content) => content.type === "text")
+            .map(({ text }) => text)
+            .join("\n");
+        return {
+            content: response.content,
+            structuredContent: response.structuredContent ?? {},
+            isError: response.isError ?? false,
+            result,
+            meta: response._meta ?? {},
+        };
+    };
+    requestDisplayMode = (mode) => {
+        const bridge = McpAppBridge.getInstance();
+        if (mode !== "modal") {
+            return bridge.request({
+                method: "ui/request-display-mode",
+                params: { mode },
+            });
+        }
+        throw new Error("Modal display mode is not accessible in MCP App.");
+    };
+    sendFollowUpMessage = async (prompt) => {
+        const bridge = McpAppBridge.getInstance();
+        await bridge.request({
+            method: "ui/message",
+            params: {
+                role: "user",
+                content: [
+                    {
+                        type: "text",
+                        text: prompt,
+                    },
+                ],
+            },
+        });
+    };
+    openExternal(href) {
+        const bridge = McpAppBridge.getInstance();
+        bridge.request({
+            method: "ui/open-link",
+            params: { url: href },
+        });
+    }
+    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 ?? window.innerHeight;
+                }
+                return window.innerHeight;
+            }),
+            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),
+            widgetState: {
+                subscribe: (onChange) => {
+                    this.widgetStateListeners.add(onChange);
+                    return () => {
+                        this.widgetStateListeners.delete(onChange);
+                    };
+                },
+                getSnapshot: () => this._widgetState,
+            },
+        };
+    }
+    setWidgetState = async (stateOrUpdater) => {
+        const newState = typeof stateOrUpdater === "function"
+            ? stateOrUpdater(this._widgetState)
+            : stateOrUpdater;
+        const bridge = McpAppBridge.getInstance();
+        await bridge.request({
+            method: "ui/update-model-context",
+            params: { structuredContent: newState },
+        });
+        this._widgetState = newState;
+        this.widgetStateListeners.forEach((listener) => {
+            listener();
+        });
+    };
+    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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"}

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

@@ -0,0 +1,43 @@
+import type { McpUiHostContext, McpUiInitializeRequest } from "@modelcontextprotocol/ext-apps";
+import type { Bridge, Subscribe } from "../types.js";
+import type { McpAppContext, McpAppContextKey } from "./types.js";
+type McpAppInitializationOptions = Pick<McpUiInitializeRequest["params"], "appInfo">;
+export declare class McpAppBridge implements Bridge<McpUiHostContext> {
+    private static instance;
+    context: McpAppContext;
+    private listeners;
+    private pendingRequests;
+    private nextId;
+    private initialized;
+    private appInitializationOptions;
+    private requestTimeout;
+    private cleanupSizeObserver;
+    constructor(options: McpAppInitializationOptions, requestTimeout?: number);
+    static getInstance(options?: Partial<McpAppInitializationOptions>, requestTimeout?: number): McpAppBridge;
+    subscribe(key: McpAppContextKey): Subscribe;
+    subscribe(keys: readonly McpAppContextKey[]): Subscribe;
+    getSnapshot<K extends keyof McpAppContext>(key: K): McpAppContext[K];
+    cleanup: () => void;
+    static resetInstance(): void;
+    request<R extends {
+        method: string;
+        params?: unknown;
+    }, T>({ method, params, }: R): Promise<T>;
+    private emit;
+    private updateContext;
+    private init;
+    private handleMessage;
+    private handleResponse;
+    private handleNotification;
+    private handleRequest;
+    private connect;
+    private notify;
+    private sendSizeChanged;
+    /**
+     * Set up automatic size change notifications using ResizeObserver.
+     * Based on @modelcontextprotocol/ext-apps App.setupSizeChangedNotifications
+     * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/src/app.ts#L940-L989
+     */
+    private setupSizeChangedNotifications;
+}
+export {};

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

@@ -0,0 +1,255 @@
+const LATEST_PROTOCOL_VERSION = "2025-11-21";
+var JsonRpcErrorCode;
+(function (JsonRpcErrorCode) {
+    JsonRpcErrorCode[JsonRpcErrorCode["ParseError"] = -32700] = "ParseError";
+    JsonRpcErrorCode[JsonRpcErrorCode["InvalidRequest"] = -32600] = "InvalidRequest";
+    JsonRpcErrorCode[JsonRpcErrorCode["MethodNotFound"] = -32601] = "MethodNotFound";
+    JsonRpcErrorCode[JsonRpcErrorCode["InvalidParams"] = -32602] = "InvalidParams";
+    JsonRpcErrorCode[JsonRpcErrorCode["InternalError"] = -32603] = "InternalError";
+})(JsonRpcErrorCode || (JsonRpcErrorCode = {}));
+export class McpAppBridge {
+    static instance = null;
+    context = {
+        toolInput: null,
+        toolCancelled: null,
+        toolResult: null,
+    };
+    listeners = new Map();
+    pendingRequests = new Map();
+    nextId = 1;
+    initialized;
+    appInitializationOptions;
+    requestTimeout;
+    cleanupSizeObserver = null;
+    constructor(options, requestTimeout = 10_000) {
+        this.requestTimeout = requestTimeout;
+        this.initialized = false;
+        this.appInitializationOptions = {
+            appInfo: options.appInfo,
+            appCapabilities: {},
+            protocolVersion: LATEST_PROTOCOL_VERSION,
+        };
+        this.init();
+    }
+    static getInstance(options, requestTimeout) {
+        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 || requestTimeout)) {
+            console.warn("McpAppBridge.getInstance: options and requestTimeout ignored, instance already exists");
+        }
+        if (!McpAppBridge.instance) {
+            const defaultOptions = {
+                appInfo: { name: "skybridge-app", version: "0.0.1" },
+            };
+            McpAppBridge.instance = new McpAppBridge({ ...defaultOptions, ...options }, requestTimeout);
+        }
+        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 = () => {
+        window.removeEventListener("message", this.handleMessage);
+        this.pendingRequests.forEach((request) => {
+            clearTimeout(request.timeout);
+        });
+        this.pendingRequests.clear();
+        this.listeners.clear();
+        this.cleanupSizeObserver?.();
+        this.cleanupSizeObserver = null;
+    };
+    static resetInstance() {
+        if (McpAppBridge.instance) {
+            McpAppBridge.instance.cleanup();
+            McpAppBridge.instance = null;
+        }
+    }
+    request({ method, params, }) {
+        const id = this.nextId++;
+        const { promise, resolve, reject } = Promise.withResolvers();
+        this.pendingRequests.set(id, {
+            resolve: resolve,
+            reject,
+            timeout: setTimeout(() => {
+                reject(new Error("Request timed out"));
+                this.pendingRequests.delete(id);
+            }, this.requestTimeout),
+        });
+        window.parent.postMessage({ jsonrpc: "2.0", id, method, params }, "*");
+        return promise;
+    }
+    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);
+        }
+    }
+    init() {
+        if (this.initialized) {
+            return;
+        }
+        this.initialized = true;
+        if (typeof window === "undefined" || window.parent === window) {
+            return;
+        }
+        window.addEventListener("message", this.handleMessage);
+        this.connect();
+    }
+    handleMessage = (event) => {
+        const data = event.data;
+        if (data.jsonrpc !== "2.0") {
+            return;
+        }
+        if ("id" in data) {
+            if ("method" in data) {
+                this.handleRequest(data);
+                return;
+            }
+            this.handleResponse(data);
+            return;
+        }
+        this.handleNotification(data);
+    };
+    handleResponse(response) {
+        const request = this.pendingRequests.get(response.id);
+        if (request) {
+            clearTimeout(request.timeout);
+            this.pendingRequests.delete(response.id);
+            if ("error" in response) {
+                request.reject(new Error(response.error.message));
+                return;
+            }
+            request.resolve(response.result);
+        }
+    }
+    handleNotification = (notification) => {
+        switch (notification.method) {
+            case "ui/notifications/host-context-changed":
+                this.updateContext(notification.params);
+                return;
+            case "ui/notifications/tool-input":
+                this.updateContext({
+                    toolInput: notification.params.arguments ?? {},
+                });
+                return;
+            case "ui/notifications/tool-result":
+                this.updateContext({
+                    toolResult: notification.params,
+                });
+                return;
+            case "ui/notifications/tool-cancelled":
+                this.updateContext({
+                    toolCancelled: notification.params,
+                });
+                return;
+        }
+    };
+    handleRequest = (request) => {
+        switch (request.method) {
+            case "ui/resource-teardown":
+                this.cleanup();
+                window.parent.postMessage({
+                    jsonrpc: "2.0",
+                    id: request.id,
+                    result: {},
+                }, "*");
+                return;
+            default:
+                window.parent.postMessage({
+                    jsonrpc: "2.0",
+                    id: request.id,
+                    error: {
+                        code: JsonRpcErrorCode.MethodNotFound,
+                        message: "Unsupported Request",
+                    },
+                }, "*");
+        }
+    };
+    async connect() {
+        try {
+            const result = await this.request({
+                method: "ui/initialize",
+                params: this.appInitializationOptions,
+            });
+            this.updateContext(result.hostContext);
+            this.notify({ method: "ui/notifications/initialized" });
+            this.cleanupSizeObserver = this.setupSizeChangedNotifications();
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    notify(notification) {
+        window.parent.postMessage({ jsonrpc: "2.0", ...notification }, "*");
+    }
+    sendSizeChanged(params) {
+        this.notify({ method: "ui/notifications/size-changed", params });
+    }
+    /**
+     * Set up automatic size change notifications using ResizeObserver.
+     * Based on @modelcontextprotocol/ext-apps App.setupSizeChangedNotifications
+     * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/src/app.ts#L940-L989
+     */
+    setupSizeChangedNotifications() {
+        let scheduled = false;
+        let lastWidth = 0;
+        let lastHeight = 0;
+        const sendBodySizeChanged = () => {
+            if (scheduled) {
+                return;
+            }
+            scheduled = true;
+            requestAnimationFrame(() => {
+                scheduled = false;
+                let width;
+                let height;
+                // In fullscreen mode, use viewport size since the widget should fill
+                // the entire available space provided by the host.
+                if (this.context.displayMode === "fullscreen") {
+                    width = window.innerWidth;
+                    height = window.innerHeight;
+                }
+                else {
+                    // Use scrollWidth/scrollHeight to measure actual rendered content size.
+                    // This works better than fit-content for viewport-based layouts (vw/vh)
+                    // and fluid elements like maps that want to fill available space.
+                    const body = document.body;
+                    width = Math.ceil(body.scrollWidth);
+                    height = Math.ceil(body.scrollHeight);
+                }
+                // Only send if size actually changed (prevents feedback loops from
+                // style changes)
+                if (width !== lastWidth || height !== lastHeight) {
+                    lastWidth = width;
+                    lastHeight = height;
+                    this.sendSizeChanged({ width, height });
+                }
+            });
+        };
+        sendBodySizeChanged();
+        const resizeObserver = new ResizeObserver(sendBodySizeChanged);
+        resizeObserver.observe(document.documentElement);
+        resizeObserver.observe(document.body);
+        return () => resizeObserver.disconnect();
+    }
+}
+//# sourceMappingURL=bridge.js.map