skybridge 0.0.0-dev.89e1390 → 0.0.0-dev.89e35fa

package/dist/server/requestOrigin.d.ts

@@ -1,6 +0,0 @@
-/**
- * Resolves this server's public origin from request headers, in precedence
- * `x-forwarded-host` → `origin` → `host` → localhost dev fallback. Shared by
- * view serving and OAuth metadata so the two can't drift.
- */
-export declare function resolveServerOrigin(header: (key: string) => string | undefined): string;

package/dist/server/requestOrigin.js

@@ -1,30 +0,0 @@
-/**
- * Resolves this server's public origin from request headers, in precedence
- * `x-forwarded-host` → `origin` → `host` → localhost dev fallback. Shared by
- * view serving and OAuth metadata so the two can't drift.
- */
-export function resolveServerOrigin(header) {
-    // Proxies may send X-Forwarded-* as a comma-separated chain; the client-facing
-    // hop is the first entry.
-    const firstHop = (value) => value?.split(",")[0]?.trim();
-    const forwardedHost = firstHop(header("x-forwarded-host"));
-    if (forwardedHost) {
-        const proto = firstHop(header("x-forwarded-proto")) || "https";
-        return `${proto}://${forwardedHost}`;
-    }
-    // Skip opaque origins (browsers send the literal "null") and other
-    // non-URL values, falling through to the Host header.
-    const origin = header("origin");
-    if (origin && URL.canParse(origin)) {
-        return origin;
-    }
-    const host = header("host");
-    if (host) {
-        const proto = ["127.0.0.1:", "localhost:"].some((p) => host.startsWith(p))
-            ? "http"
-            : "https";
-        return `${proto}://${host}`;
-    }
-    return `http://localhost:${process.env.__PORT || "3000"}`;
-}
-//# sourceMappingURL=requestOrigin.js.map

package/dist/server/requestOrigin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"requestOrigin.js","sourceRoot":"","sources":["../../src/server/requestOrigin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA2C;IAE3C,+EAA+E;IAC/E,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,CAAC,KAAyB,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAC7E,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC3D,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,OAAO,CAAC;QAC/D,OAAO,GAAG,KAAK,MAAM,aAAa,EAAE,CAAC;IACvC,CAAC;IACD,mEAAmE;IACnE,sDAAsD;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACxE,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,OAAO,CAAC;QACZ,OAAO,GAAG,KAAK,MAAM,IAAI,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,oBAAoB,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;AAC5D,CAAC","sourcesContent":["/**\n * Resolves this server's public origin from request headers, in precedence\n * `x-forwarded-host` → `origin` → `host` → localhost dev fallback. Shared by\n * view serving and OAuth metadata so the two can't drift.\n */\nexport function resolveServerOrigin(\n  header: (key: string) => string | undefined,\n): string {\n  // Proxies may send X-Forwarded-* as a comma-separated chain; the client-facing\n  // hop is the first entry.\n  const firstHop = (value: string | undefined) => value?.split(\",\")[0]?.trim();\n  const forwardedHost = firstHop(header(\"x-forwarded-host\"));\n  if (forwardedHost) {\n    const proto = firstHop(header(\"x-forwarded-proto\")) || \"https\";\n    return `${proto}://${forwardedHost}`;\n  }\n  // Skip opaque origins (browsers send the literal \"null\") and other\n  // non-URL values, falling through to the Host header.\n  const origin = header(\"origin\");\n  if (origin && URL.canParse(origin)) {\n    return origin;\n  }\n  const host = header(\"host\");\n  if (host) {\n    const proto = [\"127.0.0.1:\", \"localhost:\"].some((p) => host.startsWith(p))\n      ? \"http\"\n      : \"https\";\n    return `${proto}://${host}`;\n  }\n  return `http://localhost:${process.env.__PORT || \"3000\"}`;\n}\n"]}

package/dist/server/view-resource-resolution.test.d.ts

@@ -1,6 +0,0 @@
-declare module "./server.js" {
-    interface ViewNameRegistry {
-        widget: true;
-    }
-}
-export {};

package/dist/server/view-resource-resolution.test.js

@@ -1,88 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
-import { afterEach, describe, expect, it } from "vitest";
-import { __setBuildManifest, McpServer } from "./index.js";
-// SKY-435: a view resource must resolve no matter the `?v=` query param value.
-// The version param is a content-derived cache key for external consumers
-// (it busts host/CDN caches when the bundle changes); it is not part of the
-// resource's identity, so a stale, absent, or arbitrary param must still serve
-// the underlying asset.
-async function connect(register) {
-    const server = new McpServer({ name: "test", version: "1.0.0" });
-    register(server);
-    const client = new Client({ name: "test-client", version: "1.0.0" });
-    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
-    await server.connect(serverTransport);
-    await client.connect(clientTransport);
-    return {
-        client,
-        teardown: async () => {
-            await client.close();
-            await server.close();
-        },
-    };
-}
-function registerWidget(server) {
-    server.registerTool({ name: "show", description: "show", view: { component: "widget" } }, () => ({ content: [{ type: "text", text: "ok" }] }));
-}
-/** Narrow a read-resource content entry to its text variant. */
-function textContent(contents) {
-    return contents[0];
-}
-describe("view resource resolution (cache key)", () => {
-    afterEach(() => {
-        delete process.env.NODE_ENV;
-    });
-    it("resolves regardless of the ?v= param and echoes the requested URI", async () => {
-        const { client, teardown } = await connect(registerWidget);
-        const { resources } = await client.listResources();
-        const listed = resources.find((r) => r.uri.startsWith("ui://views/apps-sdk/widget.html"));
-        // Dev build advertises no cache key.
-        expect(listed?.uri).toBe("ui://views/apps-sdk/widget.html");
-        // A stale/arbitrary/absent param all resolve the same underlying asset,
-        // and the response echoes the URI the consumer asked for (never rewritten).
-        for (const uri of [
-            "ui://views/apps-sdk/widget.html?v=stale123",
-            "ui://views/apps-sdk/widget.html?v=whatever-else",
-            "ui://views/apps-sdk/widget.html",
-        ]) {
-            const { contents } = await client.readResource({ uri });
-            expect(contents).toHaveLength(1);
-            const content = textContent(contents);
-            expect(typeof content.text).toBe("string");
-            expect(content.text.length).toBeGreaterThan(0);
-            expect(content.uri).toBe(uri);
-        }
-        await teardown();
-    });
-    it("resolves a stale cache key when the canonical URI carries ?v= (prod)", async () => {
-        process.env.NODE_ENV = "production";
-        __setBuildManifest({
-            "src/views/widget.tsx": {
-                isEntry: true,
-                name: "widget",
-                file: "assets/widget-ABC123.js",
-            },
-            "style.css": { file: "assets/style-XYZ.css" },
-        });
-        const { client, teardown } = await connect(registerWidget);
-        const { resources } = await client.listResources();
-        const listed = resources.find((r) => r.uri.startsWith("ui://views/apps-sdk/widget.html"));
-        // Production advertises a content-derived cache key.
-        expect(listed?.uri).toMatch(/^ui:\/\/views\/apps-sdk\/widget\.html\?v=[0-9a-f]{8}$/);
-        // A consumer holding a stale key still resolves the current asset.
-        const staleUri = "ui://views/apps-sdk/widget.html?v=00000000";
-        const { contents } = await client.readResource({ uri: staleUri });
-        expect(contents).toHaveLength(1);
-        const content = textContent(contents);
-        expect(typeof content.text).toBe("string");
-        expect(content.uri).toBe(staleUri);
-        await teardown();
-    });
-    it("still throws for an unknown view path", async () => {
-        const { client, teardown } = await connect(registerWidget);
-        await expect(client.readResource({ uri: "ui://views/apps-sdk/nope.html?v=1" })).rejects.toThrow();
-        await teardown();
-    });
-});
-//# sourceMappingURL=view-resource-resolution.test.js.map

package/dist/server/view-resource-resolution.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"view-resource-resolution.test.js","sourceRoot":"","sources":["../../src/server/view-resource-resolution.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { InMemoryTransport } from \"@modelcontextprotocol/sdk/inMemory.js\";\nimport { afterEach, describe, expect, it } from \"vitest\";\nimport { __setBuildManifest, McpServer } from \"./index.js\";\n\n// Mirror what the Skybridge Vite plugin generates in `.skybridge/views.d.ts`:\n// narrow `ViewName` so `component: \"widget\"` typechecks against the registry.\ndeclare module \"./server.js\" {\n  interface ViewNameRegistry {\n    widget: true;\n  }\n}\n\n// SKY-435: a view resource must resolve no matter the `?v=` query param value.\n// The version param is a content-derived cache key for external consumers\n// (it busts host/CDN caches when the bundle changes); it is not part of the\n// resource's identity, so a stale, absent, or arbitrary param must still serve\n// the underlying asset.\n\nasync function connect(register: (server: McpServer) => void) {\n  const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n  register(server);\n  const client = new Client({ name: \"test-client\", version: \"1.0.0\" });\n  const [clientTransport, serverTransport] =\n    InMemoryTransport.createLinkedPair();\n  await server.connect(serverTransport);\n  await client.connect(clientTransport);\n  return {\n    client,\n    teardown: async () => {\n      await client.close();\n      await server.close();\n    },\n  };\n}\n\nfunction registerWidget(server: McpServer) {\n  server.registerTool(\n    { name: \"show\", description: \"show\", view: { component: \"widget\" } },\n    () => ({ content: [{ type: \"text\" as const, text: \"ok\" }] }),\n  );\n}\n\n/** Narrow a read-resource content entry to its text variant. */\nfunction textContent(contents: Array<{ uri: string }>): {\n  uri: string;\n  text: string;\n} {\n  return contents[0] as { uri: string; text: string };\n}\n\ndescribe(\"view resource resolution (cache key)\", () => {\n  afterEach(() => {\n    delete process.env.NODE_ENV;\n  });\n\n  it(\"resolves regardless of the ?v= param and echoes the requested URI\", async () => {\n    const { client, teardown } = await connect(registerWidget);\n\n    const { resources } = await client.listResources();\n    const listed = resources.find((r) =>\n      r.uri.startsWith(\"ui://views/apps-sdk/widget.html\"),\n    );\n    // Dev build advertises no cache key.\n    expect(listed?.uri).toBe(\"ui://views/apps-sdk/widget.html\");\n\n    // A stale/arbitrary/absent param all resolve the same underlying asset,\n    // and the response echoes the URI the consumer asked for (never rewritten).\n    for (const uri of [\n      \"ui://views/apps-sdk/widget.html?v=stale123\",\n      \"ui://views/apps-sdk/widget.html?v=whatever-else\",\n      \"ui://views/apps-sdk/widget.html\",\n    ]) {\n      const { contents } = await client.readResource({ uri });\n      expect(contents).toHaveLength(1);\n      const content = textContent(contents);\n      expect(typeof content.text).toBe(\"string\");\n      expect(content.text.length).toBeGreaterThan(0);\n      expect(content.uri).toBe(uri);\n    }\n\n    await teardown();\n  });\n\n  it(\"resolves a stale cache key when the canonical URI carries ?v= (prod)\", async () => {\n    process.env.NODE_ENV = \"production\";\n    __setBuildManifest({\n      \"src/views/widget.tsx\": {\n        isEntry: true,\n        name: \"widget\",\n        file: \"assets/widget-ABC123.js\",\n      },\n      \"style.css\": { file: \"assets/style-XYZ.css\" },\n    } as unknown as Record<string, { file: string }>);\n\n    const { client, teardown } = await connect(registerWidget);\n\n    const { resources } = await client.listResources();\n    const listed = resources.find((r) =>\n      r.uri.startsWith(\"ui://views/apps-sdk/widget.html\"),\n    );\n    // Production advertises a content-derived cache key.\n    expect(listed?.uri).toMatch(\n      /^ui:\\/\\/views\\/apps-sdk\\/widget\\.html\\?v=[0-9a-f]{8}$/,\n    );\n\n    // A consumer holding a stale key still resolves the current asset.\n    const staleUri = \"ui://views/apps-sdk/widget.html?v=00000000\";\n    const { contents } = await client.readResource({ uri: staleUri });\n    expect(contents).toHaveLength(1);\n    const content = textContent(contents);\n    expect(typeof content.text).toBe(\"string\");\n    expect(content.uri).toBe(staleUri);\n\n    await teardown();\n  });\n\n  it(\"still throws for an unknown view path\", async () => {\n    const { client, teardown } = await connect(registerWidget);\n\n    await expect(\n      client.readResource({ uri: \"ui://views/apps-sdk/nope.html?v=1\" }),\n    ).rejects.toThrow();\n\n    await teardown();\n  });\n});\n"]}

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

@@ -1,29 +0,0 @@
-import type { Adaptor, CallToolResponse, DownloadParams, DownloadResult, FileMetadata, HostContext, HostContextStore, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, RequestSizeOptions, SendFollowUpMessageOptions, SetViewStateAction, UploadFileOptions } from "../types.js";
-/** @internal Apps SDK implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */
-export declare class AppsSdkAdaptor implements Adaptor {
-    private static instance;
-    static getInstance(): AppsSdkAdaptor;
-    static resetInstance(): void;
-    getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<K>;
-    callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
-    requestDisplayMode: (mode: RequestDisplayMode) => Promise<{
-        mode: RequestDisplayMode;
-    }>;
-    requestClose: () => Promise<void>;
-    requestSize: (_size: RequestSizeOptions) => Promise<void>;
-    sendFollowUpMessage: (prompt: string, options?: SendFollowUpMessageOptions) => Promise<void>;
-    download: (_params: DownloadParams) => Promise<DownloadResult>;
-    openExternal(href: string, options?: OpenExternalOptions): void;
-    setViewState: (stateOrUpdater: SetViewStateAction) => Promise<void>;
-    uploadFile: (file: File, options?: UploadFileOptions) => Promise<FileMetadata>;
-    getFileDownloadUrl: (file: {
-        fileId: string;
-    }) => Promise<{
-        downloadUrl: string;
-    }>;
-    selectFiles: () => Promise<FileMetadata[]>;
-    private trackFileIds;
-    openModal(options: RequestModalOptions): Promise<void>;
-    setOpenInAppUrl(href: string): Promise<void>;
-    registerViewTool: () => (() => void);
-}

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

@@ -1,117 +0,0 @@
-import { AppsSdkBridge } from "./bridge.js";
-/** @internal Apps SDK implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */
-export class AppsSdkAdaptor {
-    static instance = null;
-    static getInstance() {
-        if (!AppsSdkAdaptor.instance) {
-            AppsSdkAdaptor.instance = new AppsSdkAdaptor();
-        }
-        return AppsSdkAdaptor.instance;
-    }
-    static resetInstance() {
-        AppsSdkAdaptor.instance = null;
-    }
-    getHostContextStore(key) {
-        const bridge = AppsSdkBridge.getInstance();
-        if (key === "viewState") {
-            return {
-                subscribe: bridge.subscribe("widgetState"),
-                getSnapshot: () => bridge.getSnapshot("widgetState")?.modelContent ?? null,
-            };
-        }
-        if (key === "display") {
-            return {
-                subscribe: bridge.subscribe("view"),
-                getSnapshot: () => bridge.getSnapshot("view"),
-            };
-        }
-        return {
-            subscribe: bridge.subscribe(key),
-            getSnapshot: () => bridge.getSnapshot(key),
-        };
-    }
-    callTool = async (name, args) => {
-        const response = await window.openai.callTool(name, args);
-        return {
-            content: response.content,
-            structuredContent: response.structuredContent ?? {},
-            isError: response.isError ?? false,
-            meta: response._meta ?? response.meta ?? {},
-        };
-    };
-    requestDisplayMode = (mode) => {
-        return window.openai.requestDisplayMode({ mode });
-    };
-    requestClose = () => {
-        return window.openai.requestClose();
-    };
-    requestSize = async (_size) => {
-        console.warn("[skybridge] requestSize: not supported on Apps SDK");
-    };
-    sendFollowUpMessage = (prompt, options) => {
-        return window.openai.sendFollowUpMessage({
-            prompt,
-            scrollToBottom: options?.scrollToBottom,
-        });
-    };
-    download = async (_params) => {
-        console.error("[skybridge] download: not supported on Apps SDK");
-        return { isError: true };
-    };
-    openExternal(href, options = {}) {
-        window.openai.openExternal({ href, ...options });
-    }
-    setViewState = (stateOrUpdater) => {
-        const modelContent = typeof stateOrUpdater === "function"
-            ? stateOrUpdater(window.openai.widgetState?.modelContent ?? null)
-            : stateOrUpdater;
-        return window.openai.setWidgetState({
-            privateContent: {},
-            ...window.openai.widgetState,
-            modelContent,
-        });
-    };
-    uploadFile = async (file, options) => {
-        const metadata = await window.openai.uploadFile(file, options);
-        await this.trackFileIds(metadata.fileId);
-        return metadata;
-    };
-    getFileDownloadUrl = (file) => {
-        return window.openai.getFileDownloadUrl(file);
-    };
-    selectFiles = async () => {
-        if (!window.openai.selectFiles) {
-            throw new Error("selectFiles is not supported by the current host version.");
-        }
-        const files = await window.openai.selectFiles();
-        if (files.length > 0) {
-            await this.trackFileIds(...files.map((f) => f.fileId));
-        }
-        return files;
-    };
-    async trackFileIds(...fileIds) {
-        const state = window.openai.widgetState
-            ? { ...window.openai.widgetState }
-            : { modelContent: {}, privateContent: {} };
-        if (!state.imageIds) {
-            state.imageIds = [];
-        }
-        state.imageIds.push(...fileIds);
-        await window.openai.setWidgetState(state);
-    }
-    openModal(options) {
-        return window.openai.requestModal(options);
-    }
-    setOpenInAppUrl(href) {
-        href = href.trim();
-        if (!href) {
-            throw new Error("The href parameter is required.");
-        }
-        return window.openai.setOpenInAppUrl({ href });
-    }
-    registerViewTool = () => {
-        console.warn("[skybridge] registerViewTool: view tools are not supported on the Apps SDK runtime");
-        return () => { };
-    };
-}
-//# sourceMappingURL=adaptor.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/adaptor.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Adaptor,\n  CallToolResponse,\n  DownloadParams,\n  DownloadResult,\n  FileMetadata,\n  HostContext,\n  HostContextStore,\n  OpenExternalOptions,\n  RequestDisplayMode,\n  RequestModalOptions,\n  RequestSizeOptions,\n  SendFollowUpMessageOptions,\n  SetViewStateAction,\n  UploadFileOptions,\n} from \"../types.js\";\nimport { AppsSdkBridge } from \"./bridge.js\";\nimport type { AppsSdkWidgetState } from \"./types.js\";\n\n/** @internal Apps SDK implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */\nexport class AppsSdkAdaptor implements Adaptor {\n  private static instance: AppsSdkAdaptor | null = null;\n\n  public static getInstance(): AppsSdkAdaptor {\n    if (!AppsSdkAdaptor.instance) {\n      AppsSdkAdaptor.instance = new AppsSdkAdaptor();\n    }\n    return AppsSdkAdaptor.instance;\n  }\n\n  public static resetInstance(): void {\n    AppsSdkAdaptor.instance = null;\n  }\n\n  public getHostContextStore<K extends keyof HostContext>(\n    key: K,\n  ): HostContextStore<K> {\n    const bridge = AppsSdkBridge.getInstance();\n\n    if (key === \"viewState\") {\n      return {\n        subscribe: bridge.subscribe(\"widgetState\"),\n        getSnapshot: () =>\n          bridge.getSnapshot(\"widgetState\")?.modelContent ?? null,\n      } as HostContextStore<K>;\n    }\n\n    if (key === \"display\") {\n      return {\n        subscribe: bridge.subscribe(\"view\"),\n        getSnapshot: () => bridge.getSnapshot(\"view\"),\n      } as HostContextStore<K>;\n    }\n\n    return {\n      subscribe: bridge.subscribe(key),\n      getSnapshot: () => bridge.getSnapshot(key),\n    } as HostContextStore<K>;\n  }\n\n  public callTool = async <\n    ToolArgs extends Record<string, unknown> | null = null,\n    ToolResponse extends CallToolResponse = CallToolResponse,\n  >(\n    name: string,\n    args: ToolArgs,\n  ): Promise<ToolResponse> => {\n    const response = await (window.openai.callTool(name, args) as Promise<\n      CallToolResponse & { _meta?: CallToolResponse[\"meta\"] }\n    >);\n    return {\n      content: response.content,\n      structuredContent: response.structuredContent ?? {},\n      isError: response.isError ?? false,\n      meta: response._meta ?? response.meta ?? {},\n    } as ToolResponse;\n  };\n\n  public requestDisplayMode = (\n    mode: RequestDisplayMode,\n  ): Promise<{ mode: RequestDisplayMode }> => {\n    return window.openai.requestDisplayMode({ mode });\n  };\n\n  public requestClose = (): Promise<void> => {\n    return window.openai.requestClose();\n  };\n\n  public requestSize = async (_size: RequestSizeOptions): Promise<void> => {\n    console.warn(\"[skybridge] requestSize: not supported on Apps SDK\");\n  };\n\n  public sendFollowUpMessage = (\n    prompt: string,\n    options?: SendFollowUpMessageOptions,\n  ): Promise<void> => {\n    return window.openai.sendFollowUpMessage({\n      prompt,\n      scrollToBottom: options?.scrollToBottom,\n    });\n  };\n\n  public download = async (\n    _params: DownloadParams,\n  ): Promise<DownloadResult> => {\n    console.error(\"[skybridge] download: not supported on Apps SDK\");\n    return { isError: true };\n  };\n\n  public openExternal(href: string, options: OpenExternalOptions = {}): void {\n    window.openai.openExternal({ href, ...options });\n  }\n\n  public setViewState = (stateOrUpdater: SetViewStateAction): Promise<void> => {\n    const modelContent =\n      typeof stateOrUpdater === \"function\"\n        ? stateOrUpdater(window.openai.widgetState?.modelContent ?? null)\n        : stateOrUpdater;\n\n    return window.openai.setWidgetState({\n      privateContent: {},\n      ...window.openai.widgetState,\n      modelContent,\n    });\n  };\n\n  public uploadFile = async (file: File, options?: UploadFileOptions) => {\n    const metadata = await window.openai.uploadFile(file, options);\n    await this.trackFileIds(metadata.fileId);\n    return metadata;\n  };\n\n  public getFileDownloadUrl = (file: { fileId: string }) => {\n    return window.openai.getFileDownloadUrl(file);\n  };\n\n  public selectFiles = async (): Promise<FileMetadata[]> => {\n    if (!window.openai.selectFiles) {\n      throw new Error(\n        \"selectFiles is not supported by the current host version.\",\n      );\n    }\n    const files = await window.openai.selectFiles();\n    if (files.length > 0) {\n      await this.trackFileIds(...files.map((f) => f.fileId));\n    }\n    return files;\n  };\n\n  private async trackFileIds(...fileIds: string[]): Promise<void> {\n    const state: AppsSdkWidgetState = window.openai.widgetState\n      ? { ...window.openai.widgetState }\n      : { modelContent: {}, privateContent: {} };\n    if (!state.imageIds) {\n      state.imageIds = [];\n    }\n    state.imageIds.push(...fileIds);\n    await window.openai.setWidgetState(state);\n  }\n\n  public openModal(options: RequestModalOptions) {\n    return window.openai.requestModal(options);\n  }\n\n  public setOpenInAppUrl(href: string): Promise<void> {\n    href = href.trim();\n\n    if (!href) {\n      throw new Error(\"The href parameter is required.\");\n    }\n\n    return window.openai.setOpenInAppUrl({ href });\n  }\n\n  public registerViewTool = (): (() => void) => {\n    console.warn(\n      \"[skybridge] registerViewTool: view tools are not supported on the Apps SDK runtime\",\n    );\n    return () => {};\n  };\n}\n"]}

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

@@ -1,53 +0,0 @@
-import type { Adaptor, AnyViewToolHandler, CallToolResponse, DownloadParams, DownloadResult, HostContext, HostContextStore, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, RequestSizeOptions, SendFollowUpMessageOptions, SetViewStateAction, ViewToolConfig } from "../types.js";
-/** @internal MCP Apps implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */
-export declare class McpAppAdaptor implements Adaptor {
-    private static instance;
-    private stores;
-    private _viewState;
-    private viewStateListeners;
-    private _viewUUID;
-    private _displayState;
-    private displayListeners;
-    private constructor();
-    static getInstance(): McpAppAdaptor;
-    static resetInstance(): void;
-    getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<K>;
-    callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
-    requestDisplayMode: (mode: RequestDisplayMode) => Promise<{
-        [x: string]: unknown;
-        mode: "inline" | "fullscreen" | "pip";
-    }>;
-    requestClose: () => Promise<void>;
-    requestSize: (size: RequestSizeOptions) => Promise<void>;
-    sendFollowUpMessage: (prompt: string, _options?: SendFollowUpMessageOptions) => Promise<void>;
-    download: (params: DownloadParams) => Promise<DownloadResult>;
-    openExternal(href: string, options?: OpenExternalOptions): void;
-    private initializeStores;
-    setViewState: (stateOrUpdater: SetViewStateAction) => Promise<void>;
-    /**
-     * @throws File upload is not supported in MCP App.
-     */
-    uploadFile(): Promise<{
-        fileId: string;
-    }>;
-    /**
-     * @throws File download is not supported in MCP App.
-     */
-    getFileDownloadUrl(): Promise<{
-        downloadUrl: string;
-    }>;
-    /**
-     * @throws File selection is not supported in MCP App.
-     */
-    selectFiles(): Promise<{
-        fileId: string;
-    }[]>;
-    openModal(options: RequestModalOptions): void;
-    closeModal(): void;
-    setOpenInAppUrl(_href: string): Promise<void>;
-    registerViewTool: (config: ViewToolConfig, handler: AnyViewToolHandler) => (() => void);
-    private subscribeToViewUUID;
-    private restoreFromLocalStorage;
-    private persistToLocalStorage;
-    private createHostContextStore;
-}