skybridge 0.0.0-dev.ffdda73 → 0.0.0-dev.ffdf126

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

@@ -0,0 +1,225 @@
+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 }) }],
+        });
+        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

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 { VIEW_STATE_WARNING_TOKENS } from \"../../context-warnings.js\";\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\", {});\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(\"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 window.openai 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 window.openai 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 window.openai 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 window.openai.uploadFile and tracks fileId in widgetState\", async () => {\n    const setWidgetState = vi.fn().mockResolvedValue(undefined);\n    const uploadFile = vi.fn().mockResolvedValue({\n      fileId: \"abc\",\n      fileName: \"x\",\n      mimeType: \"image/png\",\n    });\n    vi.stubGlobal(\"openai\", { uploadFile, setWidgetState, widgetState: null });\n    const adaptor = new HostAdaptor();\n    const file = new File([], \"x\", { type: \"image/png\" });\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(\"uploadFile does not track a non-image fileId in widgetState.imageIds\", async () => {\n    const setWidgetState = vi.fn().mockResolvedValue(undefined);\n    const uploadFile = vi.fn().mockResolvedValue({\n      fileId: \"sediment://file_txt\",\n      fileName: \"notes.txt\",\n      mimeType: \"text/plain\",\n    });\n    vi.stubGlobal(\"openai\", { uploadFile, setWidgetState, widgetState: null });\n    const adaptor = new HostAdaptor();\n\n    await adaptor.uploadFile(new File([], \"notes.txt\", { type: \"text/plain\" }));\n\n    for (const call of setWidgetState.mock.calls) {\n      expect(call[0].imageIds ?? []).not.toContain(\"sediment://file_txt\");\n    }\n  });\n\n  it(\"setViewState uses window.openai.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(\"warns when setViewState reaches 20K tokens\", async () => {\n    const setWidgetState = vi.fn().mockResolvedValue(undefined);\n    vi.stubGlobal(\"openai\", { setWidgetState, widgetState: null });\n    const adaptor = new HostAdaptor();\n    const warnSpy = vi.spyOn(console, \"warn\").mockImplementation(() => {});\n\n    await adaptor.setViewState({\n      longText: \"x\".repeat(VIEW_STATE_WARNING_TOKENS * 4),\n    });\n\n    expect(warnSpy).toHaveBeenCalledWith(\n      expect.stringContaining(\"setWidgetState is persisting\"),\n    );\n\n    warnSpy.mockRestore();\n  });\n\n  it(\"setViewState falls back to MCP updateModelContext + localStorage when window.openai is absent\", 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 window.openai.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 Apps SDK 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

@@ -1,5 +1,6 @@
-import type { Bridge, Subscribe } from "../types.js";
+import type { Bridge, HostContextStore, 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;
@@ -7,4 +8,8 @@ export declare class AppsSdkBridge implements Bridge<AppsSdkContext> {
     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];
+    createOverlayStores(): {
+        display: HostContextStore<"display">;
+        viewState: HostContextStore<"viewState">;
+    };
 }

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

@@ -1,10 +1,10 @@
 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.skybridge.hostType !== "apps-sdk" ||
-            window.openai === undefined) {
-            throw new Error("Apps SDK Bridge can only be used in the apps-sdk runtime");
+        if (window.openai === undefined) {
+            throw new Error("Apps SDK Bridge requires window.openai (Apps SDK runtime).");
         }
         if (AppsSdkBridge.instance === null) {
             AppsSdkBridge.instance = new AppsSdkBridge();
@@ -42,5 +42,17 @@ export class AppsSdkBridge {
         }
         return window.openai[key];
     };
+    createOverlayStores() {
+        return {
+            display: {
+                subscribe: this.subscribe("view"),
+                getSnapshot: () => this.getSnapshot("view"),
+            },
+            viewState: {
+                subscribe: this.subscribe("widgetState"),
+                getSnapshot: () => this.getSnapshot("widgetState")?.modelContent ?? null,
+            },
+        };
+    }
 }
 //# sourceMappingURL=bridge.js.map

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

@@ -1 +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,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAyB,IAAI,CAAC;IAE9C,MAAM,CAAC,WAAW;QACvB,IACE,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;YACxC,MAAM,CAAC,MAAM,KAAK,SAAS,EAC3B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,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\nexport class AppsSdkBridge implements Bridge<AppsSdkContext> {\n  private static instance: AppsSdkBridge | null = null;\n\n  public static getInstance(): AppsSdkBridge {\n    if (\n      window.skybridge.hostType !== \"apps-sdk\" ||\n      window.openai === undefined\n    ) {\n      throw new Error(\n        \"Apps SDK Bridge can only be used in the 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"]}
+{"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;IAEK,mBAAmB;QAIxB,OAAO;YACL,OAAO,EAAE;gBACP,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBACjC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;aAC5C;YACD,SAAS,EAAE;gBACT,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;gBACxC,WAAW,EAAE,GAAG,EAAE,CAChB,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,YAAY,IAAI,IAAI;aACxD;SACF,CAAC;IACJ,CAAC","sourcesContent":["import type { Bridge, HostContextStore, 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  public createOverlayStores(): {\n    display: HostContextStore<\"display\">;\n    viewState: HostContextStore<\"viewState\">;\n  } {\n    return {\n      display: {\n        subscribe: this.subscribe(\"view\"),\n        getSnapshot: () => this.getSnapshot(\"view\"),\n      },\n      viewState: {\n        subscribe: this.subscribe(\"widgetState\"),\n        getSnapshot: () =>\n          this.getSnapshot(\"widgetState\")?.modelContent ?? null,\n      },\n    };\n  }\n}\n"]}

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

@@ -1,4 +1,3 @@
-export { AppsSdkAdaptor } from "./adaptor.js";
 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";

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

@@ -1,4 +1,3 @@
-export { AppsSdkAdaptor } from "./adaptor.js";
 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";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,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 { AppsSdkAdaptor } from \"./adaptor.js\";\nexport { 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"]}
+{"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/use-apps-sdk-context.d.ts

@@ -1,2 +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 (`useViewport`, `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

@@ -1,5 +1,16 @@
 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 (`useViewport`, `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));

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

@@ -1 +1 @@
-{"version":3,"file":"use-apps-sdk-context.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/use-apps-sdk-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,UAAU,iBAAiB,CAC/B,GAAM;IAEN,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CACtD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CACxB,CAAC;AACJ,CAAC","sourcesContent":["import { useSyncExternalStore } from \"react\";\nimport { AppsSdkBridge } from \"./bridge.js\";\nimport type { AppsSdkContext } from \"./types.js\";\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"]}
+{"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 (`useViewport`, `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

@@ -1,2 +1,9 @@
 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;

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"get-adaptor.js","sourceRoot":"","sources":["../../../src/web/bridges/get-adaptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE;IACtC,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;QAC7C,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE;QAC9B,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC,CAAC","sourcesContent":["import { AppsSdkAdaptor } from \"./apps-sdk/adaptor.js\";\nimport { McpAppAdaptor } from \"./mcp-app/adaptor.js\";\nimport type { Adaptor } from \"./types.js\";\n\nexport const getAdaptor = (): Adaptor => {\n  return window.skybridge.hostType === \"apps-sdk\"\n    ? AppsSdkAdaptor.getInstance()\n    : McpAppAdaptor.getInstance();\n};\n"]}
+{"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;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import { HostAdaptor } from \"./adaptor.js\";\nimport type { Adaptor } from \"./types.js\";\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 => HostAdaptor.getInstance();\n"]}

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

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

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

@@ -0,0 +1,32 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { HostAdaptor } from "./adaptor.js";
+import { AppsSdkBridge } from "./apps-sdk/bridge.js";
+import { getAdaptor } from "./get-adaptor.js";
+import { McpAppBridge } from "./mcp-app/bridge.js";
+describe("getAdaptor", () => {
+    beforeEach(() => {
+        HostAdaptor.resetInstance();
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+        vi.stubGlobal("parent", { postMessage: vi.fn() });
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        HostAdaptor.resetInstance();
+        McpAppBridge.resetInstance();
+        AppsSdkBridge.resetInstance();
+    });
+    it("returns a HostAdaptor instance", () => {
+        vi.stubGlobal("skybridge", {});
+        vi.stubGlobal("openai", undefined);
+        expect(getAdaptor()).toBeInstanceOf(HostAdaptor);
+    });
+    it("memoizes the instance", () => {
+        vi.stubGlobal("skybridge", {});
+        vi.stubGlobal("openai", undefined);
+        const a = getAdaptor();
+        const b = getAdaptor();
+        expect(a).toBe(b);
+    });
+});
+//# 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":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,UAAU,CAAC,GAAG,EAAE;QACd,WAAW,CAAC,aAAa,EAAE,CAAC;QAC5B,YAAY,CAAC,aAAa,EAAE,CAAC;QAC7B,aAAa,CAAC,aAAa,EAAE,CAAC;QAC9B,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,WAAW,CAAC,aAAa,EAAE,CAAC;QAC5B,YAAY,CAAC,aAAa,EAAE,CAAC;QAC7B,aAAa,CAAC,aAAa,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC/B,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACnC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC/B,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { HostAdaptor } from \"./adaptor.js\";\nimport { AppsSdkBridge } from \"./apps-sdk/bridge.js\";\nimport { getAdaptor } from \"./get-adaptor.js\";\nimport { McpAppBridge } from \"./mcp-app/bridge.js\";\n\ndescribe(\"getAdaptor\", () => {\n  beforeEach(() => {\n    HostAdaptor.resetInstance();\n    McpAppBridge.resetInstance();\n    AppsSdkBridge.resetInstance();\n    vi.stubGlobal(\"parent\", { postMessage: vi.fn() });\n  });\n  afterEach(() => {\n    vi.unstubAllGlobals();\n    HostAdaptor.resetInstance();\n    McpAppBridge.resetInstance();\n    AppsSdkBridge.resetInstance();\n  });\n\n  it(\"returns a HostAdaptor instance\", () => {\n    vi.stubGlobal(\"skybridge\", {});\n    vi.stubGlobal(\"openai\", undefined);\n    expect(getAdaptor()).toBeInstanceOf(HostAdaptor);\n  });\n\n  it(\"memoizes the instance\", () => {\n    vi.stubGlobal(\"skybridge\", {});\n    vi.stubGlobal(\"openai\", undefined);\n    const a = getAdaptor();\n    const b = getAdaptor();\n    expect(a).toBe(b);\n  });\n});\n"]}

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

@@ -1,7 +1,8 @@
 import { App } from "@modelcontextprotocol/ext-apps";
-import type { Implementation } from "@modelcontextprotocol/sdk/types.js";
-import type { Bridge, Subscribe } from "../types.js";
+import { type Implementation } from "@modelcontextprotocol/sdk/types.js";
+import type { AnyViewToolHandler, Bridge, HostContextStore, Subscribe, ViewToolConfig } from "../types.js";
 import type { McpAppContext, McpAppContextKey } from "./types.js";
+/** @internal Singleton bridge over the `ext-apps` JSON-RPC App connection. Used by `HostAdaptor`. */
 export declare class McpAppBridge implements Bridge<McpAppContext> {
     private static instance;
     context: McpAppContext;
@@ -13,12 +14,24 @@ export declare class McpAppBridge implements Bridge<McpAppContext> {
     });
     private connect;
     getApp(): Promise<App>;
+    registerViewTool(config: ViewToolConfig, handler: AnyViewToolHandler): () => void;
     static getInstance(options?: Partial<{
         appInfo: Implementation;
     }>): McpAppBridge;
     subscribe(key: McpAppContextKey): Subscribe;
     subscribe(keys: readonly McpAppContextKey[]): Subscribe;
     getSnapshot<K extends keyof McpAppContext>(key: K): McpAppContext[K];
+    createContextStores(): {
+        theme: HostContextStore<"theme">;
+        locale: HostContextStore<"locale">;
+        safeArea: HostContextStore<"safeArea">;
+        displayMode: HostContextStore<"displayMode">;
+        maxHeight: HostContextStore<"maxHeight">;
+        userAgent: HostContextStore<"userAgent">;
+        toolInput: HostContextStore<"toolInput">;
+        toolOutput: HostContextStore<"toolOutput">;
+        toolResponseMetadata: HostContextStore<"toolResponseMetadata">;
+    };
     cleanup: () => void;
     static resetInstance(): void;
     private emit;