skybridge 0.0.0-dev.dc4ed16 → 0.0.0-dev.dc576c4

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

@@ -0,0 +1,205 @@
+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("captures window.openai as overlay when present, else oai is null", () => {
+        vi.stubGlobal("openai", undefined);
+        expect(new HostAdaptor().hasAppsSdkOverlay()).toBe(false);
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+        vi.stubGlobal("openai", { widgetState: null });
+        expect(new HostAdaptor().hasAppsSdkOverlay()).toBe(true);
+    });
+    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 oai 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 oai 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 oai 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 oai.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 oai.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("setViewState falls back to MCP updateModelContext + localStorage when oai is null", 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 oai.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 oai 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

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

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

package/dist/web/bridges/apps-sdk/bridge.d.ts

@@ -0,0 +1,11 @@
+import type { Bridge, Subscribe } from "../types.js";
+import { type AppsSdkContext } from "./types.js";
+/** @internal Singleton bridge over `window.openai` events. Used by `HostAdaptor`. */
+export declare class AppsSdkBridge implements Bridge<AppsSdkContext> {
+    private static instance;
+    static getInstance(): AppsSdkBridge;
+    static resetInstance(): void;
+    subscribe(key: keyof AppsSdkContext): Subscribe;
+    subscribe(keys: readonly (keyof AppsSdkContext)[]): Subscribe;
+    getSnapshot: <K extends keyof AppsSdkContext>(key: K) => (import("./types.js").AppsSdkMethods<import("./types.js").AppsSdkWidgetState> & AppsSdkContext<Record<never, unknown>, import("../../types.js").UnknownObject, import("../../types.js").UnknownObject, import("./types.js").AppsSdkWidgetState>)[K];
+}

package/dist/web/bridges/apps-sdk/bridge.js

@@ -0,0 +1,46 @@
+import { SET_GLOBALS_EVENT_TYPE, } from "./types.js";
+/** @internal Singleton bridge over `window.openai` events. Used by `HostAdaptor`. */
+export class AppsSdkBridge {
+    static instance = null;
+    static getInstance() {
+        if (window.openai === undefined) {
+            throw new Error("Apps SDK Bridge requires window.openai (Apps SDK runtime).");
+        }
+        if (AppsSdkBridge.instance === null) {
+            AppsSdkBridge.instance = new AppsSdkBridge();
+        }
+        return AppsSdkBridge.instance;
+    }
+    static resetInstance() {
+        if (AppsSdkBridge.instance) {
+            AppsSdkBridge.instance = null;
+        }
+    }
+    subscribe(keyOrKeys) {
+        const keys = Array.isArray(keyOrKeys)
+            ? keyOrKeys
+            : [keyOrKeys];
+        return (onChange) => {
+            const handleSetGlobal = (event) => {
+                const hasRelevantChange = keys.some((key) => event.detail.globals[key] !== undefined);
+                if (!hasRelevantChange) {
+                    return;
+                }
+                onChange();
+            };
+            window.addEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal, {
+                passive: true,
+            });
+            return () => {
+                window.removeEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal);
+            };
+        };
+    }
+    getSnapshot = (key) => {
+        if (window.openai === undefined) {
+            throw new Error(`window.openai is not available. Make sure you're calling the hook requiring ${key} within the OpenAI iFrame skybridge runtime.`);
+        }
+        return window.openai[key];
+    };
+}
+//# sourceMappingURL=bridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,sBAAsB,GAEvB,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAyB,IAAI,CAAC;IAE9C,MAAM,CAAC,WAAW;QACvB,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpC,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAEM,MAAM,CAAC,aAAa;QACzB,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC3B,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IAIM,SAAS,CACd,SAAmE;QAEnE,MAAM,IAAI,GAAsC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACtE,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChB,OAAO,CAAC,QAAoB,EAAE,EAAE;YAC9B,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAE,EAAE;gBACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CACjC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CACjD,CAAC;gBACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACvB,OAAO;gBACT,CAAC;gBACD,QAAQ,EAAE,CAAC;YACb,CAAC,CAAC;YAEF,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,eAAe,EAAE;gBAC/D,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACV,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;YACtE,CAAC,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAEM,WAAW,GAAG,CAAiC,GAAM,EAAE,EAAE;QAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,+EAA+E,GAAG,8CAA8C,CACjI,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC","sourcesContent":["import type { Bridge, Subscribe } from \"../types.js\";\nimport {\n  type AppsSdkContext,\n  SET_GLOBALS_EVENT_TYPE,\n  type SetGlobalsEvent,\n} from \"./types.js\";\n\n/** @internal Singleton bridge over `window.openai` events. Used by `HostAdaptor`. */\nexport class AppsSdkBridge implements Bridge<AppsSdkContext> {\n  private static instance: AppsSdkBridge | null = null;\n\n  public static getInstance(): AppsSdkBridge {\n    if (window.openai === undefined) {\n      throw new Error(\n        \"Apps SDK Bridge requires window.openai (Apps SDK runtime).\",\n      );\n    }\n    if (AppsSdkBridge.instance === null) {\n      AppsSdkBridge.instance = new AppsSdkBridge();\n    }\n    return AppsSdkBridge.instance;\n  }\n\n  public static resetInstance(): void {\n    if (AppsSdkBridge.instance) {\n      AppsSdkBridge.instance = null;\n    }\n  }\n\n  public subscribe(key: keyof AppsSdkContext): Subscribe;\n  public subscribe(keys: readonly (keyof AppsSdkContext)[]): Subscribe;\n  public subscribe(\n    keyOrKeys: keyof AppsSdkContext | readonly (keyof AppsSdkContext)[],\n  ): Subscribe {\n    const keys: readonly (keyof AppsSdkContext)[] = Array.isArray(keyOrKeys)\n      ? keyOrKeys\n      : [keyOrKeys];\n    return (onChange: () => void) => {\n      const handleSetGlobal = (event: SetGlobalsEvent) => {\n        const hasRelevantChange = keys.some(\n          (key) => event.detail.globals[key] !== undefined,\n        );\n        if (!hasRelevantChange) {\n          return;\n        }\n        onChange();\n      };\n\n      window.addEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal, {\n        passive: true,\n      });\n\n      return () => {\n        window.removeEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal);\n      };\n    };\n  }\n\n  public getSnapshot = <K extends keyof AppsSdkContext>(key: K) => {\n    if (window.openai === undefined) {\n      throw new Error(\n        `window.openai is not available. Make sure you're calling the hook requiring ${key} within the OpenAI iFrame skybridge runtime.`,\n      );\n    }\n\n    return window.openai[key];\n  };\n}\n"]}

package/dist/web/bridges/apps-sdk/index.d.ts

@@ -0,0 +1,4 @@
+export { AppsSdkBridge } from "./bridge.js";
+export type { AppsSdkContext, AppsSdkMethods, AppsSdkWidgetState, ToolResponseEvent, } from "./types.js";
+export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
+export { useAppsSdkContext } from "./use-apps-sdk-context.js";

package/dist/web/bridges/apps-sdk/index.js

@@ -0,0 +1,4 @@
+export { AppsSdkBridge } from "./bridge.js";
+export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
+export { useAppsSdkContext } from "./use-apps-sdk-context.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["export { AppsSdkBridge } from \"./bridge.js\";\nexport type {\n  AppsSdkContext,\n  AppsSdkMethods,\n  AppsSdkWidgetState,\n  ToolResponseEvent,\n} from \"./types.js\";\nexport {\n  SET_GLOBALS_EVENT_TYPE,\n  SetGlobalsEvent,\n  TOOL_RESPONSE_EVENT_TYPE,\n} from \"./types.js\";\nexport { useAppsSdkContext } from \"./use-apps-sdk-context.js\";\n"]}

package/dist/web/bridges/apps-sdk/types.d.ts

@@ -0,0 +1,133 @@
+import type { UnknownObject } from "../../types.js";
+import type { CallToolArgs, CallToolResponse, FileMetadata, RequestModalOptions, UploadFileOptions } from "../types.js";
+type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
+type RequestDisplayMode = Exclude<DisplayMode, "modal">;
+export type AppsSdkWidgetState = {
+    modelContent: Record<string, unknown>;
+    privateContent: Record<string, unknown>;
+    imageIds?: string[];
+};
+export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
+export declare class ToolResponseEvent extends CustomEvent<{
+    tool: {
+        name: string;
+        args: UnknownObject;
+    };
+}> {
+    readonly type = "openai:tool_response";
+}
+declare global {
+    interface Window {
+        openai: AppsSdkMethods & AppsSdkContext;
+    }
+    interface WindowEventMap {
+        [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
+    }
+}
+export type AppsSdkContext<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WS extends AppsSdkWidgetState = AppsSdkWidgetState> = {
+    theme: Theme;
+    userAgent: UserAgent;
+    locale: string;
+    maxHeight: number | undefined;
+    displayMode: DisplayMode;
+    safeArea: SafeArea;
+    view: View;
+    toolInput: ToolInput;
+    toolOutput: ToolOutput | {
+        text: string;
+    } | null;
+    toolResponseMetadata: ToolResponseMetadata | null;
+    widgetState: WS | null;
+};
+export type AppsSdkMethods<WS extends AppsSdkWidgetState = AppsSdkWidgetState> = {
+    /** 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
+     * scrollToBottom is optional, defaults to true, and can be
+     * set to false to prevent auto-scroll.
+     */
+    sendFollowUpMessage: (args: {
+        prompt: string;
+        scrollToBottom?: boolean;
+    }) => Promise<void>;
+    /** Opens an external link, redirects web page or mobile app */
+    openExternal(args: {
+        href: string;
+        redirectUrl?: false;
+    }): void;
+    /** For transitioning an app from inline to fullscreen or pip */
+    requestDisplayMode: (args: {
+        mode: RequestDisplayMode;
+    }) => Promise<{
+        /**
+         * The granted display mode. The host may reject the request.
+         * For mobile, PiP is always coerced to fullscreen.
+         */
+        mode: RequestDisplayMode;
+    }>;
+    /** Requests the host to close (dismiss) the widget. */
+    requestClose: () => Promise<void>;
+    /**
+     * Sets the widget state.
+     * This state is persisted across widget renders.
+     */
+    setWidgetState: (state: WS) => Promise<void>;
+    /**
+     * Opens a modal portaled outside of the widget iFrame.
+     * This ensures the modal is correctly displayed and not limited to the widget's area.
+     */
+    requestModal: (args: RequestModalOptions) => Promise<void>;
+    /** Uploads a new file to the host. Pass `{ library: true }` to also save to the user's ChatGPT file library. */
+    uploadFile: (file: File, options?: UploadFileOptions) => Promise<FileMetadata>;
+    /**
+     * Opens ChatGPT's file library picker and returns app-authorized files.
+     * Feature-detect before using: this method may not be available on all host versions.
+     */
+    selectFiles?: () => Promise<FileMetadata[]>;
+    /**
+     * Downloads a file from the host. Works for files uploaded by the widget,
+     * files selected via selectFiles(), or files provided via tool/file params.
+     */
+    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<AppsSdkContext>;
+}> {
+    readonly type = "openai:set_globals";
+}
+type View = {
+    mode: DisplayMode;
+    params?: Record<string, unknown>;
+};
+type Theme = "light" | "dark";
+type SafeAreaInsets = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+type SafeArea = {
+    insets: SafeAreaInsets;
+};
+type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
+type UserAgent = {
+    device: {
+        type: DeviceType;
+    };
+    capabilities: {
+        hover: boolean;
+        touch: boolean;
+    };
+};
+export {};

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":"AAkBA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AA8GD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD","sourcesContent":["import type { UnknownObject } from \"../../types.js\";\nimport type {\n  CallToolArgs,\n  CallToolResponse,\n  FileMetadata,\n  RequestModalOptions,\n  UploadFileOptions,\n} from \"../types.js\";\n\ntype DisplayMode = \"pip\" | \"inline\" | \"fullscreen\" | \"modal\";\ntype RequestDisplayMode = Exclude<DisplayMode, \"modal\">;\n\nexport type AppsSdkWidgetState = {\n  modelContent: Record<string, unknown>;\n  privateContent: Record<string, unknown>;\n  imageIds?: string[];\n};\n\nexport const TOOL_RESPONSE_EVENT_TYPE = \"openai:tool_response\";\nexport class ToolResponseEvent extends CustomEvent<{\n  tool: { name: string; args: UnknownObject };\n}> {\n  override readonly type = TOOL_RESPONSE_EVENT_TYPE;\n}\n\ndeclare global {\n  interface Window {\n    openai: AppsSdkMethods & AppsSdkContext;\n  }\n\n  interface WindowEventMap {\n    [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;\n  }\n}\n\nexport type AppsSdkContext<\n  ToolInput extends UnknownObject = Record<never, unknown>,\n  ToolOutput extends UnknownObject = UnknownObject,\n  ToolResponseMetadata extends UnknownObject = UnknownObject,\n  WS extends AppsSdkWidgetState = AppsSdkWidgetState,\n> = {\n  theme: Theme;\n  userAgent: UserAgent;\n  locale: string;\n\n  // layout\n  maxHeight: number | undefined;\n  displayMode: DisplayMode;\n  safeArea: SafeArea;\n  view: View;\n\n  // state\n  toolInput: ToolInput;\n  toolOutput: ToolOutput | { text: string } | null;\n  toolResponseMetadata: ToolResponseMetadata | null;\n  widgetState: WS | null;\n};\n\nexport type AppsSdkMethods<WS extends AppsSdkWidgetState = AppsSdkWidgetState> =\n  {\n    /** Calls a tool on your MCP. Returns the full response. */\n    callTool: <\n      ToolArgs extends CallToolArgs = null,\n      ToolResponse extends CallToolResponse = CallToolResponse,\n    >(\n      name: string,\n      args: ToolArgs,\n    ) => Promise<ToolResponse>;\n\n    /**\n     * Triggers a followup turn in the ChatGPT conversation\n     * scrollToBottom is optional, defaults to true, and can be\n     * set to false to prevent auto-scroll.\n     */\n    sendFollowUpMessage: (args: {\n      prompt: string;\n      scrollToBottom?: boolean;\n    }) => Promise<void>;\n\n    /** Opens an external link, redirects web page or mobile app */\n    openExternal(args: { href: string; redirectUrl?: false }): void;\n\n    /** For transitioning an app from inline to fullscreen or pip */\n    requestDisplayMode: (args: { mode: RequestDisplayMode }) => Promise<{\n      /**\n       * The granted display mode. The host may reject the request.\n       * For mobile, PiP is always coerced to fullscreen.\n       */\n      mode: RequestDisplayMode;\n    }>;\n\n    /** Requests the host to close (dismiss) the widget. */\n    requestClose: () => Promise<void>;\n\n    /**\n     * Sets the widget state.\n     * This state is persisted across widget renders.\n     */\n    setWidgetState: (state: WS) => Promise<void>;\n\n    /**\n     * Opens a modal portaled outside of the widget iFrame.\n     * This ensures the modal is correctly displayed and not limited to the widget's area.\n     */\n    requestModal: (args: RequestModalOptions) => Promise<void>;\n\n    /** Uploads a new file to the host. Pass `{ library: true }` to also save to the user's ChatGPT file library. */\n    uploadFile: (\n      file: File,\n      options?: UploadFileOptions,\n    ) => Promise<FileMetadata>;\n\n    /**\n     * Opens ChatGPT's file library picker and returns app-authorized files.\n     * Feature-detect before using: this method may not be available on all host versions.\n     */\n    selectFiles?: () => Promise<FileMetadata[]>;\n\n    /**\n     * Downloads a file from the host. Works for files uploaded by the widget,\n     * files selected via selectFiles(), or files provided via tool/file params.\n     */\n    getFileDownloadUrl: (\n      file: FileMetadata,\n    ) => Promise<{ downloadUrl: string }>;\n\n    /**\n     * Sets the open in app URL.\n     * This URL will be opened in the app when the user clicks on the top right button in fullscreen mode.\n     */\n    setOpenInAppUrl: (args: { href: string }) => Promise<void>;\n  };\n\n// Dispatched when any global changes in the host page\nexport const SET_GLOBALS_EVENT_TYPE = \"openai:set_globals\";\nexport class SetGlobalsEvent extends CustomEvent<{\n  globals: Partial<AppsSdkContext>;\n}> {\n  override readonly type = SET_GLOBALS_EVENT_TYPE;\n}\n\ntype View = {\n  mode: DisplayMode;\n  params?: Record<string, unknown>;\n};\n\ntype Theme = \"light\" | \"dark\";\n\ntype SafeAreaInsets = {\n  top: number;\n  bottom: number;\n  left: number;\n  right: number;\n};\n\ntype SafeArea = {\n  insets: SafeAreaInsets;\n};\n\ntype DeviceType = \"mobile\" | \"tablet\" | \"desktop\" | \"unknown\";\n\ntype UserAgent = {\n  device: { type: DeviceType };\n  capabilities: {\n    hover: boolean;\n    touch: boolean;\n  };\n};\n"]}

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

@@ -0,0 +1,13 @@
+import type { AppsSdkContext } from "./types.js";
+/**
+ * Read a single key from the raw Apps SDK (`window.openai`) context.
+ *
+ * Advanced escape hatch — prefer the cross-host hooks (`useLayout`, `useUser`,
+ * `useToolInfo`, etc.) which work in both Apps SDK and MCP Apps. Reach for
+ * this when you need ChatGPT-only fields not surfaced by the public hooks.
+ *
+ * Throws if called outside the Apps SDK runtime.
+ *
+ * @see https://docs.skybridge.tech/api-reference/use-apps-sdk-context
+ */
+export declare function useAppsSdkContext<K extends keyof AppsSdkContext>(key: K): AppsSdkContext[K];

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

@@ -0,0 +1,18 @@
+import { useSyncExternalStore } from "react";
+import { AppsSdkBridge } from "./bridge.js";
+/**
+ * Read a single key from the raw Apps SDK (`window.openai`) context.
+ *
+ * Advanced escape hatch — prefer the cross-host hooks (`useLayout`, `useUser`,
+ * `useToolInfo`, etc.) which work in both Apps SDK and MCP Apps. Reach for
+ * this when you need ChatGPT-only fields not surfaced by the public hooks.
+ *
+ * Throws if called outside the Apps SDK runtime.
+ *
+ * @see https://docs.skybridge.tech/api-reference/use-apps-sdk-context
+ */
+export function useAppsSdkContext(key) {
+    const bridge = AppsSdkBridge.getInstance();
+    return useSyncExternalStore(bridge.subscribe(key), () => bridge.getSnapshot(key));
+}
+//# sourceMappingURL=use-apps-sdk-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-apps-sdk-context.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/use-apps-sdk-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;GAUG;AACH,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","sourcesContent":["import { useSyncExternalStore } from \"react\";\nimport { AppsSdkBridge } from \"./bridge.js\";\nimport type { AppsSdkContext } from \"./types.js\";\n\n/**\n * Read a single key from the raw Apps SDK (`window.openai`) context.\n *\n * Advanced escape hatch — prefer the cross-host hooks (`useLayout`, `useUser`,\n * `useToolInfo`, etc.) which work in both Apps SDK and MCP Apps. Reach for\n * this when you need ChatGPT-only fields not surfaced by the public hooks.\n *\n * Throws if called outside the Apps SDK runtime.\n *\n * @see https://docs.skybridge.tech/api-reference/use-apps-sdk-context\n */\nexport function useAppsSdkContext<K extends keyof AppsSdkContext>(\n  key: K,\n): AppsSdkContext[K] {\n  const bridge = AppsSdkBridge.getInstance();\n  return useSyncExternalStore(bridge.subscribe(key), () =>\n    bridge.getSnapshot(key),\n  );\n}\n"]}

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

@@ -0,0 +1,11 @@
+import type { Adaptor } from "./types.js";
+/**
+ * @internal
+ * Resolve the single host {@link Adaptor} instance. Prefer the documented
+ * hooks (`useCallTool`, `useViewState`, etc.) over calling this directly;
+ * it's the escape hatch used by the hooks themselves and by advanced
+ * integrations.
+ */
+export declare const getAdaptor: () => Adaptor;
+/** @internal Test-only. */
+export declare const _resetAdaptor: () => void;

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

@@ -0,0 +1,30 @@
+import { HostAdaptor } from "./adaptor.js";
+let cached = null;
+/**
+ * @internal
+ * Resolve the single host {@link Adaptor} instance. Prefer the documented
+ * hooks (`useCallTool`, `useViewState`, etc.) over calling this directly;
+ * it's the escape hatch used by the hooks themselves and by advanced
+ * integrations.
+ */
+export const getAdaptor = () => {
+    if (cached) {
+        return cached;
+    }
+    const hostType = typeof window !== "undefined" ? window.skybridge?.hostType : undefined;
+    const hasOai = typeof window !== "undefined" && window.openai !== undefined;
+    if (hostType === "mcp-app" && hasOai) {
+        console.warn("[skybridge] hostType is 'mcp-app' but window.openai is present; trusting the probe.");
+    }
+    else if (hostType === "apps-sdk" && !hasOai) {
+        console.warn("[skybridge] hostType is 'apps-sdk' but window.openai is absent; trusting the probe.");
+    }
+    cached = new HostAdaptor();
+    return cached;
+};
+/** @internal Test-only. */
+export const _resetAdaptor = () => {
+    cached?.cleanup();
+    cached = null;
+};
+//# 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,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,IAAI,MAAM,GAAuB,IAAI,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE;IACtC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,QAAQ,GACZ,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC;IAE5E,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,EAAE,CAAC;QACrC,OAAO,CAAC,IAAI,CACV,qFAAqF,CACtF,CAAC;IACJ,CAAC;SAAM,IAAI,QAAQ,KAAK,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9C,OAAO,CAAC,IAAI,CACV,qFAAqF,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,2BAA2B;AAC3B,MAAM,CAAC,MAAM,aAAa,GAAG,GAAS,EAAE;IACtC,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC,CAAC","sourcesContent":["import { HostAdaptor } from \"./adaptor.js\";\nimport type { Adaptor } from \"./types.js\";\n\nlet cached: HostAdaptor | null = null;\n\n/**\n * @internal\n * Resolve the single host {@link Adaptor} instance. Prefer the documented\n * hooks (`useCallTool`, `useViewState`, etc.) over calling this directly;\n * it's the escape hatch used by the hooks themselves and by advanced\n * integrations.\n */\nexport const getAdaptor = (): Adaptor => {\n  if (cached) {\n    return cached;\n  }\n\n  const hostType =\n    typeof window !== \"undefined\" ? window.skybridge?.hostType : undefined;\n  const hasOai = typeof window !== \"undefined\" && window.openai !== undefined;\n\n  if (hostType === \"mcp-app\" && hasOai) {\n    console.warn(\n      \"[skybridge] hostType is 'mcp-app' but window.openai is present; trusting the probe.\",\n    );\n  } else if (hostType === \"apps-sdk\" && !hasOai) {\n    console.warn(\n      \"[skybridge] hostType is 'apps-sdk' but window.openai is absent; trusting the probe.\",\n    );\n  }\n\n  cached = new HostAdaptor();\n  return cached;\n};\n\n/** @internal Test-only. */\nexport const _resetAdaptor = (): void => {\n  cached?.cleanup();\n  cached = null;\n};\n"]}

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

@@ -0,0 +1,48 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { HostAdaptor } from "./adaptor.js";
+import { AppsSdkBridge } from "./apps-sdk/bridge.js";
+import { _resetAdaptor, getAdaptor } from "./get-adaptor.js";
+import { McpAppBridge } from "./mcp-app/bridge.js";
+describe("getAdaptor", () => {
+    beforeEach(() => {
+        _resetAdaptor();
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+        vi.stubGlobal("parent", { postMessage: vi.fn() });
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        _resetAdaptor();
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+    });
+    it("returns a HostAdaptor instance", () => {
+        vi.stubGlobal("skybridge", { hostType: "mcp-app" });
+        vi.stubGlobal("openai", undefined);
+        expect(getAdaptor()).toBeInstanceOf(HostAdaptor);
+    });
+    it("memoizes the instance", () => {
+        vi.stubGlobal("skybridge", { hostType: "mcp-app" });
+        vi.stubGlobal("openai", undefined);
+        const a = getAdaptor();
+        const b = getAdaptor();
+        expect(a).toBe(b);
+    });
+    it("logs a warning when hostType disagrees with probe", () => {
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        vi.stubGlobal("skybridge", { hostType: "mcp-app" });
+        vi.stubGlobal("openai", { view: { mode: "inline" } });
+        getAdaptor();
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining("hostType"));
+        warn.mockRestore();
+    });
+    it("does not warn when hostType matches probe", () => {
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        vi.stubGlobal("skybridge", { hostType: "apps-sdk" });
+        vi.stubGlobal("openai", { view: { mode: "inline" } });
+        getAdaptor();
+        expect(warn).not.toHaveBeenCalled();
+        warn.mockRestore();
+    });
+});
+//# sourceMappingURL=get-adaptor.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-adaptor.test.js","sourceRoot":"","sources":["../../../src/web/bridges/get-adaptor.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { HostAdaptor } from \"./adaptor.js\";\nimport { AppsSdkBridge } from \"./apps-sdk/bridge.js\";\nimport { _resetAdaptor, getAdaptor } from \"./get-adaptor.js\";\nimport { McpAppBridge } from \"./mcp-app/bridge.js\";\n\ndescribe(\"getAdaptor\", () => {\n  beforeEach(() => {\n    _resetAdaptor();\n    McpAppBridge.resetInstance();\n    AppsSdkBridge.resetInstance();\n    vi.stubGlobal(\"parent\", { postMessage: vi.fn() });\n  });\n  afterEach(() => {\n    vi.unstubAllGlobals();\n    _resetAdaptor();\n    McpAppBridge.resetInstance();\n    AppsSdkBridge.resetInstance();\n  });\n\n  it(\"returns a HostAdaptor instance\", () => {\n    vi.stubGlobal(\"skybridge\", { hostType: \"mcp-app\" });\n    vi.stubGlobal(\"openai\", undefined);\n    expect(getAdaptor()).toBeInstanceOf(HostAdaptor);\n  });\n\n  it(\"memoizes the instance\", () => {\n    vi.stubGlobal(\"skybridge\", { hostType: \"mcp-app\" });\n    vi.stubGlobal(\"openai\", undefined);\n    const a = getAdaptor();\n    const b = getAdaptor();\n    expect(a).toBe(b);\n  });\n\n  it(\"logs a warning when hostType disagrees with probe\", () => {\n    const warn = vi.spyOn(console, \"warn\").mockImplementation(() => {});\n    vi.stubGlobal(\"skybridge\", { hostType: \"mcp-app\" });\n    vi.stubGlobal(\"openai\", { view: { mode: \"inline\" } });\n    getAdaptor();\n    expect(warn).toHaveBeenCalledWith(expect.stringContaining(\"hostType\"));\n    warn.mockRestore();\n  });\n\n  it(\"does not warn when hostType matches probe\", () => {\n    const warn = vi.spyOn(console, \"warn\").mockImplementation(() => {});\n    vi.stubGlobal(\"skybridge\", { hostType: \"apps-sdk\" });\n    vi.stubGlobal(\"openai\", { view: { mode: \"inline\" } });\n    getAdaptor();\n    expect(warn).not.toHaveBeenCalled();\n    warn.mockRestore();\n  });\n});\n"]}