skybridge 0.0.0-dev.d7aaec6 → 0.0.0-dev.d7d9ce9

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

@@ -1,24 +1,7 @@
-import "react";
-import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-import type { WidgetHostType } from "../server/index.js";
-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, FileMetadata, RequestModalOptions } from "../types.js";
+type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
 type WidgetState = UnknownObject;
-type FileMetadata = {
-    fileId: string;
-};
 export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
 export declare class ToolResponseEvent extends CustomEvent<{
     tool: {
@@ -30,21 +13,17 @@ export declare class ToolResponseEvent extends CustomEvent<{
 }
 declare global {
     interface Window {
-        skybridge: SkybridgeProperties;
-        openai: OpenAiMethods<WidgetState> & OpenAiProperties;
+        openai: AppsSdkMethods<WidgetState> & AppsSdkContext;
     }
     interface WindowEventMap {
         [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
     }
 }
-export type SkybridgeProperties = {
-    hostType: WidgetHostType;
-};
-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;
+    maxHeight: number | undefined;
     displayMode: DisplayMode;
     safeArea: SafeArea;
     view: View;
@@ -55,25 +34,7 @@ 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: CallToolResult["content"];
-    structuredContent: Record<string, unknown>;
-    isError: boolean;
-    result: string;
-    _meta?: CallToolResult["_meta"];
-};
-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 */
@@ -110,34 +71,39 @@ export type OpenAiMethods<WidgetState extends UnknownObject = UnknownObject> = {
      * 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;
     }>;
+    /**
+     * Sets the open in app URL.
+     * This URL will be opened in the app when the user clicks on the top right button in fullscreen mode.
+     */
+    setOpenInAppUrl: (args: {
+        href: string;
+    }) => Promise<void>;
 };
 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" | "modal";
-export type View = {
+type View = {
     mode: DisplayMode;
     params?: Record<string, unknown>;
 };
-export type Theme = "light" | "dark";
-export type SafeAreaInsets = {
+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":"AAYA,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/{src/web/bridges/hooks/use-apps-sdk-bridge.js → web/bridges/apps-sdk/use-apps-sdk-context.js}

@@ -1,7 +1,7 @@
 import { useSyncExternalStore } from "react";
-import { AppsSdkBridge } from "../apps-sdk-bridge.js";
-export function useAppsSdkBridge(key) {
+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-bridge.js.map
+//# 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,36 @@
+import type { McpUiRequestDisplayModeResult } from "@modelcontextprotocol/ext-apps";
+import type { Adaptor, CallToolResponse, DisplayMode, HostContext, HostContextStore, RequestModalOptions, SetWidgetStateAction } from "../types.js";
+export declare class McpAppAdaptor implements Adaptor {
+    private static instance;
+    private stores;
+    private _widgetState;
+    private widgetStateListeners;
+    private _viewState;
+    private viewListeners;
+    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>;
+    /**
+     * @throws File upload is not supported in MCP App.
+     */
+    uploadFile(): Promise<{
+        fileId: string;
+    }>;
+    /**
+     * @throws File download is not supported in MCP App.
+     */
+    getFileDownloadUrl(): Promise<{
+        downloadUrl: string;
+    }>;
+    openModal(options: RequestModalOptions): void;
+    closeModal(): void;
+    setOpenInAppUrl(_href: string): Promise<void>;
+    private createHostContextStore;
+}

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

@@ -0,0 +1,185 @@
+import { dequal } from "dequal/lite";
+import { McpAppBridge } from "./bridge.js";
+export class McpAppAdaptor {
+    static instance = null;
+    stores;
+    _widgetState = null;
+    widgetStateListeners = new Set();
+    _viewState = {
+        mode: "inline",
+    };
+    viewListeners = 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;
+                }
+                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),
+            view: {
+                subscribe: (onChange) => {
+                    this.viewListeners.add(onChange);
+                    return () => {
+                        this.viewListeners.delete(onChange);
+                    };
+                },
+                getSnapshot: () => this._viewState,
+            },
+            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();
+        });
+    };
+    /**
+     * @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.");
+    }
+    openModal(options) {
+        this._viewState = { mode: "modal", params: options.params };
+        this.viewListeners.forEach((listener) => {
+            listener();
+        });
+    }
+    closeModal() {
+        this._viewState = { mode: "inline" };
+        this.viewListeners.forEach((listener) => {
+            listener();
+        });
+    }
+    setOpenInAppUrl(_href) {
+        throw new Error("setOpenInAppUrl is not implemented in MCP App.");
+    }
+    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/{src/web/bridges/mcp-app-bridge.js → web/bridges/mcp-app/bridge.js}

@@ -1,4 +1,12 @@
 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 = {
@@ -12,6 +20,7 @@ export class McpAppBridge {
     initialized;
     appInitializationOptions;
     requestTimeout;
+    cleanupSizeObserver = null;
     constructor(options, requestTimeout = 10_000) {
         this.requestTimeout = requestTimeout;
         this.initialized = false;
@@ -20,6 +29,7 @@ export class McpAppBridge {
             appCapabilities: {},
             protocolVersion: LATEST_PROTOCOL_VERSION,
         };
+        this.init();
     }
     static getInstance(options, requestTimeout) {
         if (window.skybridge.hostType !== "mcp-app") {
@@ -42,7 +52,6 @@ export class McpAppBridge {
             for (const key of keys) {
                 this.listeners.set(key, new Set([...(this.listeners.get(key) || []), onChange]));
             }
-            this.init();
             return () => {
                 for (const key of keys) {
                     this.listeners.get(key)?.delete(onChange);
@@ -60,6 +69,8 @@ export class McpAppBridge {
         });
         this.pendingRequests.clear();
         this.listeners.clear();
+        this.cleanupSizeObserver?.();
+        this.cleanupSizeObserver = null;
     };
     static resetInstance() {
         if (McpAppBridge.instance) {
@@ -109,39 +120,70 @@ export class McpAppBridge {
             return;
         }
         if ("id" in data) {
-            const request = this.pendingRequests.get(data.id);
-            if (request) {
-                clearTimeout(request.timeout);
-                this.pendingRequests.delete(data.id);
-                if ("error" in data) {
-                    request.reject(new Error(data.error.message));
-                    return;
-                }
-                request.resolve(data.result);
+            if ("method" in data) {
+                this.handleRequest(data);
+                return;
             }
+            this.handleResponse(data);
             return;
         }
-        switch (data.method) {
+        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(data.params);
+                this.updateContext(notification.params);
                 return;
             case "ui/notifications/tool-input":
                 this.updateContext({
-                    toolInput: data.params.arguments ?? {},
+                    toolInput: notification.params.arguments ?? {},
                 });
                 return;
             case "ui/notifications/tool-result":
                 this.updateContext({
-                    toolResult: data.params,
+                    toolResult: notification.params,
                 });
                 return;
             case "ui/notifications/tool-cancelled":
                 this.updateContext({
-                    toolCancelled: data.params,
+                    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({
@@ -150,6 +192,7 @@ export class McpAppBridge {
             });
             this.updateContext(result.hostContext);
             this.notify({ method: "ui/notifications/initialized" });
+            this.cleanupSizeObserver = this.setupSizeChangedNotifications();
         }
         catch (err) {
             console.error(err);
@@ -158,5 +201,55 @@ export class McpAppBridge {
     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=mcp-app-bridge.js.map
+//# sourceMappingURL=bridge.js.map