skybridge 0.0.0-dev.ff4b4a2 → 0.0.0-dev.ffaef7a

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExD,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC","sourcesContent":["import pkg from \"../package.json\" with { type: \"json\" };\n\nexport const VERSION: string = pkg.version;\n"]}

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

@@ -0,0 +1,51 @@
+import type { Adaptor, AnyViewToolHandler, CallToolResponse, DownloadParams, DownloadResult, FileMetadata, HostContext, HostContextStore, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, RequestSizeOptions, SendFollowUpMessageOptions, SetViewStateAction, UploadFileOptions, ViewToolConfig } from "./types.js";
+/**
+ * @internal
+ * Single composite implementation of {@link Adaptor}. Composes the MCP App
+ * bridge (always present) with an optional `window.openai` overlay. Per-method
+ * routing rules are encoded inline.
+ */
+export declare class HostAdaptor implements Adaptor {
+    private static instance;
+    static getInstance(): HostAdaptor;
+    static resetInstance(): void;
+    private readonly mcp;
+    private readonly openai;
+    private readonly stores;
+    private _viewState;
+    private readonly viewStateListeners;
+    private _viewUUID;
+    private _polyfillDisplay;
+    private readonly polyfillDisplayListeners;
+    private readonly polyfillDisplayStore;
+    private readonly polyfillViewStateStore;
+    private unsubscribeViewUUID;
+    constructor();
+    /** @internal Release any subscriptions held on the underlying bridges. */
+    cleanup(): 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>;
+    registerViewTool: (config: ViewToolConfig, handler: AnyViewToolHandler) => (() => void);
+    requestDisplayMode: (mode: RequestDisplayMode) => Promise<{
+        [x: string]: unknown;
+        mode: "inline" | "fullscreen" | "pip";
+    }>;
+    requestClose: () => Promise<void>;
+    requestSize: (size: RequestSizeOptions) => Promise<void>;
+    sendFollowUpMessage: (prompt: string, options?: SendFollowUpMessageOptions) => Promise<void>;
+    openExternal: (href: string, options?: OpenExternalOptions) => void;
+    download: (params: DownloadParams) => Promise<DownloadResult>;
+    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>;
+    closeModal: () => void;
+    private trackFileIds;
+    private subscribeToViewUUID;
+    private restoreFromLocalStorage;
+    protected persistToLocalStorage(state: Record<string, unknown> | null): void;
+}

package/dist/web/bridges/adaptor.js

@@ -0,0 +1,330 @@
+import { AppsSdkBridge } from "./apps-sdk/bridge.js";
+import { McpAppBridge } from "./mcp-app/bridge.js";
+import { NotSupportedError } from "./types.js";
+const STORAGE_PREFIX = "sb:";
+const MAX_STORAGE_ENTRIES = 200;
+const VIEW_STATE_TOKEN_WARNING_THRESHOLD = 4000;
+function getApproximateTokenCount(value) {
+    try {
+        return Math.max(1, Math.ceil(JSON.stringify(value).length / 4));
+    }
+    catch {
+        return 0;
+    }
+}
+function warnOnLargeViewState(value, source) {
+    const tokenCount = getApproximateTokenCount(value);
+    if (tokenCount > VIEW_STATE_TOKEN_WARNING_THRESHOLD) {
+        console.warn(`[skybridge] ${source} is persisting ${tokenCount} tokens in view state; this exceeds the ${VIEW_STATE_TOKEN_WARNING_THRESHOLD}-token warning threshold and may overload model context.`);
+    }
+}
+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;
+}
+/**
+ * @internal
+ * Single composite implementation of {@link Adaptor}. Composes the MCP App
+ * bridge (always present) with an optional `window.openai` overlay. Per-method
+ * routing rules are encoded inline.
+ */
+export class HostAdaptor {
+    static instance = null;
+    static getInstance() {
+        if (!HostAdaptor.instance) {
+            HostAdaptor.instance = new HostAdaptor();
+        }
+        return HostAdaptor.instance;
+    }
+    static resetInstance() {
+        HostAdaptor.instance?.cleanup();
+        HostAdaptor.instance = null;
+    }
+    mcp;
+    openai = null;
+    stores;
+    _viewState = null;
+    viewStateListeners = new Set();
+    _viewUUID = null;
+    _polyfillDisplay = { mode: "inline" };
+    polyfillDisplayListeners = new Set();
+    polyfillDisplayStore;
+    polyfillViewStateStore;
+    unsubscribeViewUUID = null;
+    constructor() {
+        this.mcp = McpAppBridge.getInstance();
+        let overlayStores = null;
+        if (typeof window !== "undefined" && window.openai !== undefined) {
+            this.openai = window.openai;
+            overlayStores = AppsSdkBridge.getInstance().createOverlayStores();
+        }
+        // Built once so that getHostContextStore returns stable references — required
+        // by useSyncExternalStore to avoid resubscribing on every render.
+        this.polyfillDisplayStore = {
+            subscribe: (onChange) => {
+                this.polyfillDisplayListeners.add(onChange);
+                return () => {
+                    this.polyfillDisplayListeners.delete(onChange);
+                };
+            },
+            getSnapshot: () => this._polyfillDisplay,
+        };
+        this.polyfillViewStateStore = {
+            subscribe: (onChange) => {
+                this.viewStateListeners.add(onChange);
+                return () => {
+                    this.viewStateListeners.delete(onChange);
+                };
+            },
+            getSnapshot: () => this._viewState,
+        };
+        this.stores = {
+            ...this.mcp.createContextStores(),
+            display: overlayStores?.display ?? this.polyfillDisplayStore,
+            viewState: overlayStores?.viewState ?? this.polyfillViewStateStore,
+        };
+        this.subscribeToViewUUID();
+    }
+    /** @internal Release any subscriptions held on the underlying bridges. */
+    cleanup() {
+        this.unsubscribeViewUUID?.();
+        this.unsubscribeViewUUID = null;
+    }
+    // ---- Adaptor interface ----
+    getHostContextStore = (key) => this.stores[key];
+    callTool = async (name, args) => {
+        const app = await this.mcp.getApp();
+        const response = await app.callServerTool({
+            name,
+            arguments: args ?? undefined,
+        });
+        return {
+            content: response.content,
+            structuredContent: response.structuredContent ?? {},
+            isError: response.isError ?? false,
+            meta: response._meta ?? {},
+        };
+    };
+    registerViewTool = (config, handler) => {
+        return this.mcp.registerViewTool(config, handler);
+    };
+    requestDisplayMode = async (mode) => {
+        const app = await this.mcp.getApp();
+        return app.requestDisplayMode({ mode });
+    };
+    requestClose = async () => {
+        if (this.openai) {
+            await this.openai.requestClose();
+        }
+        const app = await this.mcp.getApp();
+        await app.requestTeardown();
+    };
+    requestSize = async (size) => {
+        const app = await this.mcp.getApp();
+        await app.sendSizeChanged(size);
+    };
+    sendFollowUpMessage = async (prompt, options) => {
+        if (this.openai) {
+            await this.openai.sendFollowUpMessage({
+                prompt,
+                scrollToBottom: options?.scrollToBottom,
+            });
+            return;
+        }
+        const app = await this.mcp.getApp();
+        await app.sendMessage({
+            role: "user",
+            content: [{ type: "text", text: prompt }],
+        });
+    };
+    openExternal = (href, options) => {
+        if (this.openai) {
+            this.openai.openExternal({ href, ...options });
+            return;
+        }
+        this.mcp
+            .getApp()
+            .then((app) => app.openLink({ url: href }))
+            .catch((err) => {
+            console.error("Failed to open external link:", err);
+        });
+    };
+    download = async (params) => {
+        const app = await this.mcp.getApp();
+        if (!app.getHostCapabilities()?.downloadFile) {
+            console.error("[skybridge] download: host does not support ui/download-file");
+            return { isError: true };
+        }
+        return app.downloadFile(params);
+    };
+    setViewState = async (stateOrUpdater) => {
+        if (this.openai) {
+            const modelContent = typeof stateOrUpdater === "function"
+                ? stateOrUpdater(this.openai.widgetState?.modelContent ?? null)
+                : stateOrUpdater;
+            warnOnLargeViewState(modelContent, "setWidgetState");
+            await this.openai.setWidgetState({
+                privateContent: {},
+                ...this.openai.widgetState,
+                modelContent,
+            });
+            return;
+        }
+        const newState = typeof stateOrUpdater === "function"
+            ? stateOrUpdater(this._viewState)
+            : stateOrUpdater;
+        warnOnLargeViewState(newState, "setViewState");
+        // update local state immediately so successive calls see fresh state
+        this._viewState = newState;
+        this.viewStateListeners.forEach((l) => {
+            l();
+        });
+        this.persistToLocalStorage(newState);
+        try {
+            const app = await this.mcp.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);
+        }
+    };
+    uploadFile = async (file, options) => {
+        if (!this.openai) {
+            throw new NotSupportedError("uploadFile");
+        }
+        const metadata = await this.openai.uploadFile(file, options);
+        await this.trackFileIds(metadata.fileId);
+        return metadata;
+    };
+    getFileDownloadUrl = (file) => {
+        if (!this.openai) {
+            return Promise.reject(new NotSupportedError("getFileDownloadUrl"));
+        }
+        return this.openai.getFileDownloadUrl(file);
+    };
+    selectFiles = async () => {
+        if (!this.openai) {
+            throw new NotSupportedError("selectFiles");
+        }
+        if (!this.openai.selectFiles) {
+            throw new Error("selectFiles is not supported by the current host version.");
+        }
+        const files = await this.openai.selectFiles();
+        if (files.length > 0) {
+            await this.trackFileIds(...files.map((f) => f.fileId));
+        }
+        return files;
+    };
+    openModal = (options) => {
+        if (this.openai) {
+            this.openai.requestModal(options);
+            return;
+        }
+        this._polyfillDisplay = { mode: "modal", params: options.params };
+        this.polyfillDisplayListeners.forEach((l) => {
+            l();
+        });
+    };
+    setOpenInAppUrl = (href) => {
+        if (!this.openai) {
+            return Promise.reject(new NotSupportedError("setOpenInAppUrl"));
+        }
+        const trimmed = href.trim();
+        if (!trimmed) {
+            return Promise.reject(new Error("The href parameter is required."));
+        }
+        return this.openai.setOpenInAppUrl({ href: trimmed });
+    };
+    closeModal = () => {
+        if (this.openai) {
+            return; // host owns modal lifecycle
+        }
+        this._polyfillDisplay = { mode: "inline" };
+        this.polyfillDisplayListeners.forEach((l) => {
+            l();
+        });
+    };
+    async trackFileIds(...fileIds) {
+        if (!this.openai) {
+            return;
+        }
+        const current = this.openai.widgetState;
+        const state = current
+            ? { ...current }
+            : { modelContent: {}, privateContent: {} };
+        if (!state.imageIds) {
+            state.imageIds = [];
+        }
+        state.imageIds.push(...fileIds);
+        await this.openai.setWidgetState(state);
+    }
+    // ---- viewState persistence helpers ----
+    subscribeToViewUUID() {
+        this.unsubscribeViewUUID = this.mcp.subscribe("toolResult")(() => {
+            const toolResult = this.mcp.getSnapshot("toolResult");
+            const viewUUID = toolResult?._meta?.viewUUID;
+            if (viewUUID && viewUUID !== this._viewUUID) {
+                this._viewUUID = viewUUID;
+                this.restoreFromLocalStorage(viewUUID);
+            }
+        });
+    }
+    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((l) => {
+                        l();
+                    });
+                }
+            }
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    persistToLocalStorage(state) {
+        if (!this._viewUUID || state === null) {
+            return;
+        }
+        try {
+            const oldKey = findStorageKey(this._viewUUID);
+            if (oldKey) {
+                localStorage.removeItem(oldKey);
+            }
+            const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;
+            localStorage.setItem(newKey, JSON.stringify(state));
+            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);
+        }
+    }
+}
+//# sourceMappingURL=adaptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../src/web/bridges/adaptor.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppsSdkBridge } from \"./apps-sdk/bridge.js\";\nimport type { AppsSdkWidgetState } from \"./apps-sdk/types.js\";\nimport { McpAppBridge } from \"./mcp-app/bridge.js\";\nimport type {\n  Adaptor,\n  AnyViewToolHandler,\n  CallToolResponse,\n  DownloadParams,\n  DownloadResult,\n  FileMetadata,\n  HostContext,\n  HostContextStore,\n  OpenExternalOptions,\n  RequestDisplayMode,\n  RequestModalOptions,\n  RequestSizeOptions,\n  SendFollowUpMessageOptions,\n  SetViewStateAction,\n  UploadFileOptions,\n  ViewToolConfig,\n} from \"./types.js\";\nimport { NotSupportedError } from \"./types.js\";\n\nconst STORAGE_PREFIX = \"sb:\";\nconst MAX_STORAGE_ENTRIES = 200;\nconst VIEW_STATE_TOKEN_WARNING_THRESHOLD = 4000;\n\nfunction getApproximateTokenCount(value: unknown): number {\n  try {\n    return Math.max(1, Math.ceil(JSON.stringify(value).length / 4));\n  } catch {\n    return 0;\n  }\n}\n\nfunction warnOnLargeViewState(value: unknown, source: string): void {\n  const tokenCount = getApproximateTokenCount(value);\n  if (tokenCount > VIEW_STATE_TOKEN_WARNING_THRESHOLD) {\n    console.warn(\n      `[skybridge] ${source} is persisting ${tokenCount} tokens in view state; this exceeds the ${VIEW_STATE_TOKEN_WARNING_THRESHOLD}-token warning threshold and may overload model context.`,\n    );\n  }\n}\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\n/**\n * @internal\n * Single composite implementation of {@link Adaptor}. Composes the MCP App\n * bridge (always present) with an optional `window.openai` overlay. Per-method\n * routing rules are encoded inline.\n */\nexport class HostAdaptor implements Adaptor {\n  private static instance: HostAdaptor | null = null;\n\n  static getInstance(): HostAdaptor {\n    if (!HostAdaptor.instance) {\n      HostAdaptor.instance = new HostAdaptor();\n    }\n    return HostAdaptor.instance;\n  }\n\n  static resetInstance(): void {\n    HostAdaptor.instance?.cleanup();\n    HostAdaptor.instance = null;\n  }\n\n  private readonly mcp: McpAppBridge;\n  private readonly openai: typeof window.openai | null = null;\n\n  private readonly stores: { [K in keyof HostContext]: HostContextStore<K> };\n\n  private _viewState: HostContext[\"viewState\"] = null;\n  private readonly viewStateListeners = new Set<() => void>();\n  private _viewUUID: string | null = null;\n\n  private _polyfillDisplay: HostContext[\"display\"] = { mode: \"inline\" };\n  private readonly polyfillDisplayListeners = new Set<() => void>();\n\n  private readonly polyfillDisplayStore: HostContextStore<\"display\">;\n  private readonly polyfillViewStateStore: HostContextStore<\"viewState\">;\n\n  private unsubscribeViewUUID: (() => void) | null = null;\n\n  constructor() {\n    this.mcp = McpAppBridge.getInstance();\n\n    let overlayStores: ReturnType<AppsSdkBridge[\"createOverlayStores\"]> | null =\n      null;\n    if (typeof window !== \"undefined\" && window.openai !== undefined) {\n      this.openai = window.openai;\n      overlayStores = AppsSdkBridge.getInstance().createOverlayStores();\n    }\n\n    // Built once so that getHostContextStore returns stable references — required\n    // by useSyncExternalStore to avoid resubscribing on every render.\n    this.polyfillDisplayStore = {\n      subscribe: (onChange: () => void) => {\n        this.polyfillDisplayListeners.add(onChange);\n        return () => {\n          this.polyfillDisplayListeners.delete(onChange);\n        };\n      },\n      getSnapshot: () => this._polyfillDisplay,\n    };\n    this.polyfillViewStateStore = {\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    this.stores = {\n      ...this.mcp.createContextStores(),\n      display: overlayStores?.display ?? this.polyfillDisplayStore,\n      viewState: overlayStores?.viewState ?? this.polyfillViewStateStore,\n    };\n\n    this.subscribeToViewUUID();\n  }\n\n  /** @internal Release any subscriptions held on the underlying bridges. */\n  public cleanup(): void {\n    this.unsubscribeViewUUID?.();\n    this.unsubscribeViewUUID = null;\n  }\n\n  // ---- Adaptor interface ----\n\n  public getHostContextStore = <K extends keyof HostContext>(\n    key: K,\n  ): HostContextStore<K> => this.stores[key];\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 this.mcp.getApp();\n    const response = await app.callServerTool({\n      name,\n      arguments: args ?? undefined,\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 registerViewTool = (\n    config: ViewToolConfig,\n    handler: AnyViewToolHandler,\n  ): (() => void) => {\n    return this.mcp.registerViewTool(config, handler);\n  };\n\n  public requestDisplayMode = async (mode: RequestDisplayMode) => {\n    const app = await this.mcp.getApp();\n    return app.requestDisplayMode({ mode });\n  };\n\n  public requestClose = async (): Promise<void> => {\n    if (this.openai) {\n      await this.openai.requestClose();\n    }\n    const app = await this.mcp.getApp();\n    await app.requestTeardown();\n  };\n\n  public requestSize = async (size: RequestSizeOptions): Promise<void> => {\n    const app = await this.mcp.getApp();\n    await app.sendSizeChanged(size);\n  };\n\n  public sendFollowUpMessage = async (\n    prompt: string,\n    options?: SendFollowUpMessageOptions,\n  ): Promise<void> => {\n    if (this.openai) {\n      await this.openai.sendFollowUpMessage({\n        prompt,\n        scrollToBottom: options?.scrollToBottom,\n      });\n      return;\n    }\n    const app = await this.mcp.getApp();\n    await app.sendMessage({\n      role: \"user\",\n      content: [{ type: \"text\", text: prompt }],\n    });\n  };\n\n  public openExternal = (href: string, options?: OpenExternalOptions): void => {\n    if (this.openai) {\n      this.openai.openExternal({ href, ...options });\n      return;\n    }\n    this.mcp\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  public download = async (params: DownloadParams): Promise<DownloadResult> => {\n    const app = await this.mcp.getApp();\n    if (!app.getHostCapabilities()?.downloadFile) {\n      console.error(\n        \"[skybridge] download: host does not support ui/download-file\",\n      );\n      return { isError: true };\n    }\n    return app.downloadFile(params);\n  };\n\n  public setViewState = async (\n    stateOrUpdater: SetViewStateAction,\n  ): Promise<void> => {\n    if (this.openai) {\n      const modelContent =\n        typeof stateOrUpdater === \"function\"\n          ? stateOrUpdater(this.openai.widgetState?.modelContent ?? null)\n          : stateOrUpdater;\n      warnOnLargeViewState(modelContent, \"setWidgetState\");\n      await this.openai.setWidgetState({\n        privateContent: {},\n        ...this.openai.widgetState,\n        modelContent,\n      });\n      return;\n    }\n\n    const newState =\n      typeof stateOrUpdater === \"function\"\n        ? stateOrUpdater(this._viewState)\n        : stateOrUpdater;\n    warnOnLargeViewState(newState, \"setViewState\");\n\n    // update local state immediately so successive calls see fresh state\n    this._viewState = newState;\n    this.viewStateListeners.forEach((l) => {\n      l();\n    });\n\n    this.persistToLocalStorage(newState);\n\n    try {\n      const app = await this.mcp.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  public uploadFile = async (\n    file: File,\n    options?: UploadFileOptions,\n  ): Promise<FileMetadata> => {\n    if (!this.openai) {\n      throw new NotSupportedError(\"uploadFile\");\n    }\n    const metadata = await this.openai.uploadFile(file, options);\n    await this.trackFileIds(metadata.fileId);\n    return metadata;\n  };\n\n  public getFileDownloadUrl = (\n    file: FileMetadata,\n  ): Promise<{ downloadUrl: string }> => {\n    if (!this.openai) {\n      return Promise.reject(new NotSupportedError(\"getFileDownloadUrl\"));\n    }\n    return this.openai.getFileDownloadUrl(file);\n  };\n\n  public selectFiles = async (): Promise<FileMetadata[]> => {\n    if (!this.openai) {\n      throw new NotSupportedError(\"selectFiles\");\n    }\n    if (!this.openai.selectFiles) {\n      throw new Error(\n        \"selectFiles is not supported by the current host version.\",\n      );\n    }\n    const files = await this.openai.selectFiles();\n    if (files.length > 0) {\n      await this.trackFileIds(...files.map((f) => f.fileId));\n    }\n    return files;\n  };\n\n  public openModal = (options: RequestModalOptions): void => {\n    if (this.openai) {\n      this.openai.requestModal(options);\n      return;\n    }\n    this._polyfillDisplay = { mode: \"modal\", params: options.params };\n    this.polyfillDisplayListeners.forEach((l) => {\n      l();\n    });\n  };\n\n  public setOpenInAppUrl = (href: string): Promise<void> => {\n    if (!this.openai) {\n      return Promise.reject(new NotSupportedError(\"setOpenInAppUrl\"));\n    }\n    const trimmed = href.trim();\n    if (!trimmed) {\n      return Promise.reject(new Error(\"The href parameter is required.\"));\n    }\n    return this.openai.setOpenInAppUrl({ href: trimmed });\n  };\n\n  public closeModal = (): void => {\n    if (this.openai) {\n      return; // host owns modal lifecycle\n    }\n    this._polyfillDisplay = { mode: \"inline\" };\n    this.polyfillDisplayListeners.forEach((l) => {\n      l();\n    });\n  };\n\n  private async trackFileIds(...fileIds: string[]): Promise<void> {\n    if (!this.openai) {\n      return;\n    }\n    const current = this.openai.widgetState;\n    const state: AppsSdkWidgetState = current\n      ? { ...current }\n      : { modelContent: {}, privateContent: {} };\n    if (!state.imageIds) {\n      state.imageIds = [];\n    }\n    state.imageIds.push(...fileIds);\n    await this.openai.setWidgetState(state);\n  }\n\n  // ---- viewState persistence helpers ----\n\n  private subscribeToViewUUID(): void {\n    this.unsubscribeViewUUID = this.mcp.subscribe(\"toolResult\")(() => {\n      const toolResult = this.mcp.getSnapshot(\"toolResult\");\n      const viewUUID = (\n        toolResult?._meta as Record<string, unknown> | undefined\n      )?.viewUUID as string | undefined;\n      if (viewUUID && viewUUID !== this._viewUUID) {\n        this._viewUUID = viewUUID;\n        this.restoreFromLocalStorage(viewUUID);\n      }\n    });\n  }\n\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((l) => {\n            l();\n          });\n        }\n      }\n    } catch (err) {\n      console.error(err);\n    }\n  }\n\n  protected persistToLocalStorage(state: Record<string, unknown> | null): void {\n    if (!this._viewUUID || state === null) {\n      return;\n    }\n    try {\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      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"]}

package/dist/web/bridges/adaptor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/web/bridges/adaptor.test.js

@@ -0,0 +1,208 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { HostAdaptor } from "./adaptor.js";
+import { AppsSdkBridge } from "./apps-sdk/bridge.js";
+import { McpAppBridge } from "./mcp-app/bridge.js";
+import { NotSupportedError } from "./types.js";
+describe("HostAdaptor", () => {
+    beforeEach(() => {
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+        vi.stubGlobal("skybridge", { hostType: "apps-sdk" });
+        vi.stubGlobal("parent", { postMessage: vi.fn() });
+        localStorage.clear();
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+        localStorage.clear();
+    });
+    it("callTool always routes to mcp.callServerTool", async () => {
+        vi.stubGlobal("openai", { callTool: vi.fn() });
+        const adaptor = new HostAdaptor();
+        const fakeApp = {
+            callServerTool: vi.fn().mockResolvedValue({
+                content: [],
+                structuredContent: { ok: true },
+                isError: false,
+                _meta: { x: 1 },
+            }),
+        };
+        // biome-ignore lint/suspicious/noExplicitAny: test seam
+        adaptor.mcp.getApp = vi.fn().mockResolvedValue(fakeApp);
+        const result = await adaptor.callTool("greet", { name: "alice" });
+        expect(fakeApp.callServerTool).toHaveBeenCalledWith({
+            name: "greet",
+            arguments: { name: "alice" },
+        });
+        expect(result.structuredContent).toEqual({ ok: true });
+        expect(result.meta).toEqual({ x: 1 });
+    });
+    it("download returns isError when host lacks downloadFile capability", async () => {
+        vi.stubGlobal("openai", undefined);
+        const adaptor = new HostAdaptor();
+        const fakeApp = {
+            getHostCapabilities: () => ({}),
+            downloadFile: vi.fn(),
+        };
+        // biome-ignore lint/suspicious/noExplicitAny: test seam
+        adaptor.mcp.getApp = vi.fn().mockResolvedValue(fakeApp);
+        const r = await adaptor.download({ contents: [] });
+        expect(r.isError).toBe(true);
+        expect(fakeApp.downloadFile).not.toHaveBeenCalled();
+    });
+    it("sendFollowUpMessage routes to window.openai only when scrollToBottom is set", async () => {
+        const sendFollowUpMessage = vi.fn().mockResolvedValue(undefined);
+        vi.stubGlobal("openai", { sendFollowUpMessage });
+        let adaptor = new HostAdaptor();
+        await adaptor.sendFollowUpMessage("hi", { scrollToBottom: false });
+        expect(sendFollowUpMessage).toHaveBeenCalledWith({
+            prompt: "hi",
+            scrollToBottom: false,
+        });
+        // Default case falls through to MCP
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+        vi.stubGlobal("openai", undefined);
+        adaptor = new HostAdaptor();
+        const sendMessage = vi.fn().mockResolvedValue(undefined);
+        // biome-ignore lint/suspicious/noExplicitAny: test seam
+        adaptor.mcp.getApp = vi.fn().mockResolvedValue({ sendMessage });
+        await adaptor.sendFollowUpMessage("hi");
+        expect(sendMessage).toHaveBeenCalledWith({
+            role: "user",
+            content: [{ type: "text", text: "hi" }],
+        });
+    });
+    it("openExternal routes to window.openai only when redirectUrl: false", async () => {
+        const openExternal = vi.fn();
+        vi.stubGlobal("openai", { openExternal });
+        let adaptor = new HostAdaptor();
+        adaptor.openExternal("https://x", { redirectUrl: false });
+        expect(openExternal).toHaveBeenCalledWith({
+            href: "https://x",
+            redirectUrl: false,
+        });
+        // Default case falls through to MCP openLink
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+        vi.stubGlobal("openai", undefined);
+        adaptor = new HostAdaptor();
+        const openLink = vi.fn();
+        // biome-ignore lint/suspicious/noExplicitAny: test seam
+        adaptor.mcp.getApp = vi.fn().mockResolvedValue({ openLink });
+        adaptor.openExternal("https://x");
+        await new Promise((r) => setTimeout(r, 0));
+        expect(openLink).toHaveBeenCalledWith({ url: "https://x" });
+    });
+    it("Apps-SDK-exclusive methods throw NotSupportedError when window.openai is null", async () => {
+        vi.stubGlobal("openai", undefined);
+        const adaptor = new HostAdaptor();
+        await expect(adaptor.uploadFile(new File([], "x"))).rejects.toThrow(NotSupportedError);
+        await expect(adaptor.selectFiles()).rejects.toThrow(NotSupportedError);
+        await expect(adaptor.getFileDownloadUrl({ fileId: "x" })).rejects.toThrow(NotSupportedError);
+        await expect(adaptor.setOpenInAppUrl("https://x")).rejects.toThrow(NotSupportedError);
+    });
+    it("uploadFile delegates to window.openai.uploadFile and tracks fileId in widgetState", async () => {
+        const setWidgetState = vi.fn().mockResolvedValue(undefined);
+        const uploadFile = vi
+            .fn()
+            .mockResolvedValue({ fileId: "abc", fileName: "x" });
+        vi.stubGlobal("openai", { uploadFile, setWidgetState, widgetState: null });
+        const adaptor = new HostAdaptor();
+        const file = new File([], "x");
+        const r = await adaptor.uploadFile(file, { library: true });
+        expect(uploadFile).toHaveBeenCalledWith(file, { library: true });
+        expect(r.fileId).toBe("abc");
+        expect(setWidgetState).toHaveBeenCalledWith(expect.objectContaining({ imageIds: ["abc"] }));
+    });
+    it("setViewState uses window.openai.setWidgetState when present", async () => {
+        const setWidgetState = vi.fn().mockResolvedValue(undefined);
+        vi.stubGlobal("openai", { setWidgetState, widgetState: null });
+        const adaptor = new HostAdaptor();
+        await adaptor.setViewState({ count: 1 });
+        expect(setWidgetState).toHaveBeenCalledWith(expect.objectContaining({ modelContent: { count: 1 } }));
+    });
+    it("warns when setViewState persists more than 4K tokens", async () => {
+        const setWidgetState = vi.fn().mockResolvedValue(undefined);
+        vi.stubGlobal("openai", { setWidgetState, widgetState: null });
+        const adaptor = new HostAdaptor();
+        const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+        await adaptor.setViewState({
+            longText: "x".repeat(4096 * 4 + 50),
+        });
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining("setWidgetState is persisting"));
+        warnSpy.mockRestore();
+    });
+    it("setViewState falls back to MCP updateModelContext + localStorage when window.openai is absent", async () => {
+        vi.stubGlobal("openai", undefined);
+        const adaptor = new HostAdaptor();
+        const updateModelContext = vi.fn().mockResolvedValue(undefined);
+        // biome-ignore lint/suspicious/noExplicitAny: test seam
+        adaptor.mcp.getApp = vi
+            .fn()
+            .mockResolvedValue({ updateModelContext });
+        // biome-ignore lint/suspicious/noExplicitAny: test seam
+        adaptor._viewUUID = "view-1";
+        await adaptor.setViewState({ count: 2 });
+        expect(updateModelContext).toHaveBeenCalledWith({
+            structuredContent: { count: 2 },
+            content: [{ type: "text", text: JSON.stringify({ count: 2 }) }],
+        });
+        const keys = [];
+        for (let i = 0; i < localStorage.length; i++) {
+            const key = localStorage.key(i);
+            if (key !== null) {
+                keys.push(key);
+            }
+        }
+        expect(keys.some((k) => k.endsWith(":view-1"))).toBe(true);
+    });
+    it("openModal/closeModal: delegates to window.openai.requestModal when present, polyfill state otherwise", () => {
+        const requestModal = vi.fn();
+        vi.stubGlobal("openai", { requestModal });
+        let adaptor = new HostAdaptor();
+        adaptor.openModal({ title: "Hi" });
+        expect(requestModal).toHaveBeenCalledWith({ title: "Hi" });
+        expect(() => adaptor.closeModal()).not.toThrow();
+        // Polyfill path
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+        vi.stubGlobal("openai", undefined);
+        adaptor = new HostAdaptor();
+        adaptor.openModal({ params: { x: 1 } });
+        // biome-ignore lint/suspicious/noExplicitAny: test seam
+        expect(adaptor._polyfillDisplay).toEqual({
+            mode: "modal",
+            params: { x: 1 },
+        });
+        adaptor.closeModal();
+        // biome-ignore lint/suspicious/noExplicitAny: test seam
+        expect(adaptor._polyfillDisplay).toEqual({ mode: "inline" });
+    });
+    it("getHostContextStore: display/viewState route to Apps SDK overlay when present, MCP otherwise", () => {
+        vi.stubGlobal("openai", {
+            view: { mode: "fullscreen" },
+            widgetState: { modelContent: { count: 5 }, privateContent: {} },
+        });
+        let adaptor = new HostAdaptor();
+        expect(adaptor.getHostContextStore("display").getSnapshot()).toEqual({
+            mode: "fullscreen",
+        });
+        expect(adaptor.getHostContextStore("viewState").getSnapshot()).toEqual({
+            count: 5,
+        });
+        // Other keys (theme) always flow through MCP; default fallback when no notification
+        expect(adaptor.getHostContextStore("theme").getSnapshot()).toBe("light");
+        // Polyfill / local-state path
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+        vi.stubGlobal("openai", undefined);
+        adaptor = new HostAdaptor();
+        expect(adaptor.getHostContextStore("display").getSnapshot()).toEqual({
+            mode: "inline",
+        });
+        expect(adaptor.getHostContextStore("viewState").getSnapshot()).toBe(null);
+    });
+});
+//# sourceMappingURL=adaptor.test.js.map