skybridge 0.0.0-dev.f561bc3 → 0.0.0-dev.f57f202

package/dist/web/bridges/adaptor.js

@@ -0,0 +1,377 @@
+import { warnOnLargeViewState } from "../../context-warnings.js";
+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;
+function isImage(mimeType) {
+    return mimeType?.startsWith("image/") ?? false;
+}
+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;
+    _modelContext = null;
+    _polyfillDisplay = { mode: "inline" };
+    polyfillDisplayListeners = new Set();
+    polyfillDisplayStore;
+    polyfillViewStateStore;
+    unsubscribeViewUUID = null;
+    unsubscribeModelContext = 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();
+        this.unsubscribeModelContext = this.mcp.subscribe("openai/modelContext")(() => {
+            if (this.mcp.getSnapshot("openai/modelContext") === null) {
+                this._modelContext = null;
+            }
+        });
+    }
+    /** @internal Release any subscriptions held on the underlying bridges. */
+    cleanup() {
+        this.unsubscribeViewUUID?.();
+        this.unsubscribeViewUUID = null;
+        this.unsubscribeModelContext?.();
+        this.unsubscribeModelContext = null;
+    }
+    // ---- Adaptor interface ----
+    getHostContextStore = (key) => this.stores[key];
+    callTool = async (name, args, options) => {
+        const timeout = options?.timeout;
+        if (timeout !== undefined && (!Number.isFinite(timeout) || timeout <= 0)) {
+            throw new RangeError("Tool call timeout must be a positive, finite number of milliseconds.");
+        }
+        const app = await this.mcp.getApp();
+        const params = { name, arguments: args ?? undefined };
+        const response = timeout === undefined
+            ? await app.callServerTool(params)
+            : await app.callServerTool(params, { timeout });
+        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 {
+            await this.sendModelContext();
+        }
+        catch (error) {
+            console.error("Failed to update view state in MCP App.", error);
+        }
+    };
+    updateModelContext = async (params) => {
+        const app = await this.mcp.getApp();
+        const capabilities = app.getHostCapabilities();
+        if (!capabilities?.updateModelContext &&
+            !capabilities?.experimental?.["openai/modelContext"]) {
+            throw new NotSupportedError("updateModelContext", "the host does not advertise updateModelContext");
+        }
+        const previous = this._modelContext;
+        this._modelContext = params;
+        const result = await this.sendModelContext().catch((error) => {
+            this._modelContext = previous;
+            throw error;
+        });
+        const updateId = result._meta?.["openai/modelContext"]?.updateId;
+        return typeof updateId === "string" ? updateId : undefined;
+    };
+    async sendModelContext() {
+        const viewState = this.openai ? null : this._viewState;
+        const extra = this._modelContext;
+        const collisions = Object.keys(extra?.structuredContent ?? {}).filter((key) => viewState !== null && key in viewState);
+        if (collisions.length > 0) {
+            console.warn(`skybridge: view state overrides model context keys ${collisions.join(", ")}.`);
+        }
+        const structuredContent = { ...extra?.structuredContent, ...viewState };
+        const app = await this.mcp.getApp();
+        return app.updateModelContext({
+            ...(Object.keys(structuredContent).length > 0 && { structuredContent }),
+            content: [
+                ...(viewState === null
+                    ? []
+                    : [
+                        {
+                            type: "text",
+                            text: JSON.stringify(viewState),
+                            annotations: { audience: ["assistant"] },
+                        },
+                    ]),
+                ...(extra?.content ?? []),
+            ],
+        });
+    }
+    uploadFile = async (file, options) => {
+        if (!this.openai) {
+            throw new NotSupportedError("uploadFile");
+        }
+        const metadata = await this.openai.uploadFile(file, options);
+        if (isImage(metadata.mimeType ?? file.type)) {
+            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();
+        const imageIds = [];
+        for (const file of files) {
+            if (isImage(file.mimeType)) {
+                imageIds.push(file.fileId);
+            }
+        }
+        if (imageIds.length > 0) {
+            await this.trackFileIds(...imageIds);
+        }
+        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 { warnOnLargeViewState } from \"../../context-warnings.js\";\nimport { 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  CallToolOptions,\n  CallToolResponse,\n  DownloadParams,\n  DownloadResult,\n  FileMetadata,\n  HostContext,\n  HostContextStore,\n  ModelContextParams,\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;\n\nfunction isImage(mimeType: string | undefined): boolean {\n  return mimeType?.startsWith(\"image/\") ?? false;\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  private _modelContext: ModelContextParams | 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  private unsubscribeModelContext: (() => 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    this.unsubscribeModelContext = this.mcp.subscribe(\"openai/modelContext\")(\n      () => {\n        if (this.mcp.getSnapshot(\"openai/modelContext\") === null) {\n          this._modelContext = null;\n        }\n      },\n    );\n  }\n\n  /** @internal Release any subscriptions held on the underlying bridges. */\n  public cleanup(): void {\n    this.unsubscribeViewUUID?.();\n    this.unsubscribeViewUUID = null;\n    this.unsubscribeModelContext?.();\n    this.unsubscribeModelContext = 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    options?: CallToolOptions,\n  ): Promise<ToolResponse> => {\n    const timeout = options?.timeout;\n    if (timeout !== undefined && (!Number.isFinite(timeout) || timeout <= 0)) {\n      throw new RangeError(\n        \"Tool call timeout must be a positive, finite number of milliseconds.\",\n      );\n    }\n    const app = await this.mcp.getApp();\n    const params = { name, arguments: args ?? undefined };\n    const response =\n      timeout === undefined\n        ? await app.callServerTool(params)\n        : await app.callServerTool(params, { timeout });\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      await this.sendModelContext();\n    } catch (error) {\n      console.error(\"Failed to update view state in MCP App.\", error);\n    }\n  };\n\n  public updateModelContext = async (\n    params: ModelContextParams,\n  ): Promise<string | undefined> => {\n    const app = await this.mcp.getApp();\n    const capabilities = app.getHostCapabilities();\n    if (\n      !capabilities?.updateModelContext &&\n      !capabilities?.experimental?.[\"openai/modelContext\"]\n    ) {\n      throw new NotSupportedError(\n        \"updateModelContext\",\n        \"the host does not advertise updateModelContext\",\n      );\n    }\n    const previous = this._modelContext;\n    this._modelContext = params;\n    const result = await this.sendModelContext().catch((error: unknown) => {\n      this._modelContext = previous;\n      throw error;\n    });\n    const updateId = (\n      result._meta?.[\"openai/modelContext\"] as\n        | { updateId?: unknown }\n        | undefined\n    )?.updateId;\n    return typeof updateId === \"string\" ? updateId : undefined;\n  };\n\n  private async sendModelContext() {\n    const viewState = this.openai ? null : this._viewState;\n    const extra = this._modelContext;\n    const collisions = Object.keys(extra?.structuredContent ?? {}).filter(\n      (key) => viewState !== null && key in viewState,\n    );\n    if (collisions.length > 0) {\n      console.warn(\n        `skybridge: view state overrides model context keys ${collisions.join(\", \")}.`,\n      );\n    }\n    const structuredContent = { ...extra?.structuredContent, ...viewState };\n    const app = await this.mcp.getApp();\n    return app.updateModelContext({\n      ...(Object.keys(structuredContent).length > 0 && { structuredContent }),\n      content: [\n        ...(viewState === null\n          ? []\n          : [\n              {\n                type: \"text\" as const,\n                text: JSON.stringify(viewState),\n                annotations: { audience: [\"assistant\" as const] },\n              },\n            ]),\n        ...(extra?.content ?? []),\n      ],\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    if (isImage(metadata.mimeType ?? file.type)) {\n      await this.trackFileIds(metadata.fileId);\n    }\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    const imageIds: string[] = [];\n    for (const file of files) {\n      if (isImage(file.mimeType)) {\n        imageIds.push(file.fileId);\n      }\n    }\n    if (imageIds.length > 0) {\n      await this.trackFileIds(...imageIds);\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,231 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { VIEW_STATE_WARNING_TOKENS } from "../../context-warnings.js";
+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", {});
+        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",
+            mimeType: "image/png",
+        });
+        vi.stubGlobal("openai", { uploadFile, setWidgetState, widgetState: null });
+        const adaptor = new HostAdaptor();
+        const file = new File([], "x", { type: "image/png" });
+        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("uploadFile does not track a non-image fileId in widgetState.imageIds", async () => {
+        const setWidgetState = vi.fn().mockResolvedValue(undefined);
+        const uploadFile = vi.fn().mockResolvedValue({
+            fileId: "sediment://file_txt",
+            fileName: "notes.txt",
+            mimeType: "text/plain",
+        });
+        vi.stubGlobal("openai", { uploadFile, setWidgetState, widgetState: null });
+        const adaptor = new HostAdaptor();
+        await adaptor.uploadFile(new File([], "notes.txt", { type: "text/plain" }));
+        for (const call of setWidgetState.mock.calls) {
+            expect(call[0].imageIds ?? []).not.toContain("sediment://file_txt");
+        }
+    });
+    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 reaches 20K 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(VIEW_STATE_WARNING_TOKENS * 4),
+        });
+        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 }),
+                    annotations: { audience: ["assistant"] },
+                },
+            ],
+        });
+        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