skybridge 0.0.0-dev.9c6d056 → 0.0.0-dev.9c70f50

package/dist/views/scan-views.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-views.test.js","sourceRoot":"","sources":["../../src/views/scan-views.test.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  mkdirSync,\n  mkdtempSync,\n  readFileSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { afterEach, beforeEach, describe, expect, it } from \"vitest\";\nimport {\n  discoverViewsSync,\n  scanAndWriteViewsDts,\n  scanViewsSync,\n  writeViewsDts,\n} from \"./scan-views.js\";\n\nconst DEFAULT_EXPORT = \"export default function V() { return null; }\";\n\ndescribe(\"discoverViewsSync\", () => {\n  let root: string;\n  let viewsDir: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-scan-\"));\n    viewsDir = join(root, \"views\");\n    mkdirSync(viewsDir, { recursive: true });\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  it(\"picks up flat and dir-index views\", () => {\n    writeFileSync(join(viewsDir, \"a.tsx\"), DEFAULT_EXPORT);\n    mkdirSync(join(viewsDir, \"my-view\"));\n    writeFileSync(join(viewsDir, \"my-view/index.tsx\"), DEFAULT_EXPORT);\n\n    expect(\n      discoverViewsSync(viewsDir)\n        .map((v) => v.name)\n        .sort(),\n    ).toEqual([\"a\", \"my-view\"]);\n  });\n\n  it(\"throws on duplicate view names (flat + dir-index collision)\", () => {\n    writeFileSync(join(viewsDir, \"dup.tsx\"), DEFAULT_EXPORT);\n    mkdirSync(join(viewsDir, \"dup\"));\n    writeFileSync(join(viewsDir, \"dup/index.tsx\"), DEFAULT_EXPORT);\n\n    expect(() => discoverViewsSync(viewsDir)).toThrow(\n      /duplicate view name \"dup\"/,\n    );\n  });\n});\n\ndescribe(\"scanViewsSync\", () => {\n  let root: string;\n  let viewsDir: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-scan-views-\"));\n    viewsDir = join(root, \"views\");\n    mkdirSync(viewsDir, { recursive: true });\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  it(\"returns valid and invalid views from a flat layout\", () => {\n    writeFileSync(join(viewsDir, \"ok.tsx\"), DEFAULT_EXPORT);\n    writeFileSync(\n      join(viewsDir, \"broken.tsx\"),\n      \"export const Foo = () => null;\",\n    );\n\n    const { valid, invalid } = scanViewsSync(viewsDir);\n\n    expect(valid.map((v) => v.name).sort()).toEqual([\"ok\"]);\n    expect(invalid).toEqual([{ filePath: join(viewsDir, \"broken.tsx\") }]);\n  });\n\n  it(\"flags an index file in a view dir that lacks a default export\", () => {\n    mkdirSync(join(viewsDir, \"broken\"));\n    writeFileSync(\n      join(viewsDir, \"broken/index.tsx\"),\n      \"export const Foo = () => null;\",\n    );\n\n    const { valid, invalid } = scanViewsSync(viewsDir);\n\n    expect(valid).toEqual([]);\n    expect(invalid).toEqual([{ filePath: join(viewsDir, \"broken/index.tsx\") }]);\n  });\n\n  it(\"ignores top-level index.tsx (treated as a barrel, not a view)\", () => {\n    writeFileSync(\n      join(viewsDir, \"index.tsx\"),\n      \"export const Foo = () => null;\",\n    );\n\n    const { valid, invalid } = scanViewsSync(viewsDir);\n\n    expect(valid).toEqual([]);\n    expect(invalid).toEqual([]);\n  });\n});\n\ndescribe(\"writeViewsDts\", () => {\n  let root: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-dts-\"));\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  it(\"is a no-op when content is unchanged\", () => {\n    const views = [{ name: \"a\", filePath: \"/a.tsx\" }];\n    writeViewsDts(root, views);\n\n    const dtsPath = join(root, \".skybridge\", \"views.d.ts\");\n    const firstMtime = statSync(dtsPath).mtimeMs;\n\n    writeViewsDts(root, views);\n    expect(statSync(dtsPath).mtimeMs).toBe(firstMtime);\n  });\n});\n\ndescribe(\"scanAndWriteViewsDts\", () => {\n  let root: string;\n\n  beforeEach(() => {\n    root = mkdtempSync(join(tmpdir(), \"skybridge-scan-dts-\"));\n    mkdirSync(join(root, \"src/views\"), { recursive: true });\n    writeFileSync(join(root, \"src/views/hello.tsx\"), DEFAULT_EXPORT);\n  });\n\n  afterEach(() => {\n    rmSync(root, { recursive: true, force: true });\n  });\n\n  it(\"writes a views.d.ts that augments skybridge/server with discovered view names\", () => {\n    scanAndWriteViewsDts(root);\n\n    const content = readFileSync(join(root, \".skybridge/views.d.ts\"), \"utf-8\");\n    expect(content).toContain('declare module \"skybridge/server\"');\n    expect(content).toContain('\"hello\": true;');\n  });\n});\n"]}

package/dist/views/validate-view.d.ts

@@ -0,0 +1 @@
+export declare function hasDefaultExport(code: string): boolean;

package/dist/{web/plugin → views}/validate-view.js

@@ -1,7 +1,7 @@
 function stripComments(code) {
-    return code.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+    return code.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
 }
-export function hasDefaultExport(code, _filePath) {
+export function hasDefaultExport(code) {
     const stripped = stripComments(code);
     return (/export\s+default\s/.test(stripped) ||
         /export\s*\{[^}]*\bas\s+default\b[^}]*}/.test(stripped));

package/dist/views/validate-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-view.js","sourceRoot":"","sources":["../../src/views/validate-view.ts"],"names":[],"mappings":"AAAA,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,CACL,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC;QACnC,wCAAwC,CAAC,IAAI,CAAC,QAAQ,CAAC,CACxD,CAAC;AACJ,CAAC","sourcesContent":["function stripComments(code: string): string {\n  return code.replace(/\\/\\/[^\\n]*/g, \"\").replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\");\n}\n\nexport function hasDefaultExport(code: string): boolean {\n  const stripped = stripComments(code);\n  return (\n    /export\\s+default\\s/.test(stripped) ||\n    /export\\s*\\{[^}]*\\bas\\s+default\\b[^}]*}/.test(stripped)\n  );\n}\n"]}

package/dist/views/validate-view.test.d.ts

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

package/dist/views/validate-view.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-view.test.js","sourceRoot":"","sources":["../../src/views/validate-view.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,gBAAgB,CAAC,qCAAqC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,gBAAgB,CAAC,4BAA4B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,IAAI,GAAG;;;KAGZ,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { hasDefaultExport } from \"./validate-view.js\";\n\ndescribe(\"hasDefaultExport\", () => {\n  it(\"detects export default declaration\", () => {\n    expect(hasDefaultExport(\"export default MyView;\")).toBe(true);\n  });\n\n  it(\"detects export default function\", () => {\n    expect(hasDefaultExport(\"export default function MyView() {}\")).toBe(true);\n  });\n\n  it(\"detects re-export as default\", () => {\n    expect(hasDefaultExport(\"export { Foo as default };\")).toBe(true);\n  });\n\n  it(\"returns false when no default export\", () => {\n    expect(hasDefaultExport(\"export const Foo = 1;\")).toBe(false);\n  });\n\n  it(\"ignores commented-out default exports\", () => {\n    const code = `\n      // export default MyView;\n      /* export default MyView; */\n    `;\n    expect(hasDefaultExport(code)).toBe(false);\n  });\n});\n"]}

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

@@ -0,0 +1,62 @@
+import type { Adaptor, AnyViewToolHandler, CallToolOptions, CallToolResponse, DownloadParams, DownloadResult, FileMetadata, FileResource, FileResourceContent, FileResourceWriteResult, FollowUpMessage, HostContext, HostContextStore, ModelContextParams, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, RequestSizeOptions, ResourceRepresentation, SendFollowUpMessageOptions, SetViewStateAction, UploadFileOptions, ViewToolConfig } from "./types.js";
+/**
+ * @internal
+ * Single composite implementation of {@link Adaptor}. Composes the MCP App
+ * bridge (always present) with an optional `window.openai` overlay. Per-method
+ * routing rules are encoded inline.
+ */
+export declare class HostAdaptor implements Adaptor {
+    private static instance;
+    static getInstance(): HostAdaptor;
+    static resetInstance(): void;
+    private readonly mcp;
+    private readonly openai;
+    private readonly stores;
+    private _viewState;
+    private readonly viewStateListeners;
+    private _viewUUID;
+    private _modelContext;
+    private readonly resourceListeners;
+    private resourceApp?;
+    private _polyfillDisplay;
+    private readonly polyfillDisplayListeners;
+    private readonly polyfillDisplayStore;
+    private readonly polyfillViewStateStore;
+    private unsubscribeViewUUID;
+    private unsubscribeModelContext;
+    constructor();
+    /** @internal Release any subscriptions held on the underlying bridges. */
+    cleanup(): void;
+    getHostContextStore: <K extends keyof HostContext>(key: K) => HostContextStore<K>;
+    callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs, options?: CallToolOptions) => Promise<ToolResponse>;
+    registerViewTool: (config: ViewToolConfig, handler: AnyViewToolHandler) => (() => void);
+    requestDisplayMode: (mode: RequestDisplayMode) => Promise<{
+        [x: string]: unknown;
+        mode: "inline" | "fullscreen" | "pip";
+    }>;
+    requestClose: () => Promise<void>;
+    requestSize: (size: RequestSizeOptions) => Promise<void>;
+    sendFollowUpMessage: (prompt: FollowUpMessage, options?: SendFollowUpMessageOptions) => Promise<void>;
+    openExternal: (href: string, options?: OpenExternalOptions) => void;
+    download: (params: DownloadParams) => Promise<DownloadResult>;
+    setViewState: (stateOrUpdater: SetViewStateAction) => Promise<void>;
+    updateModelContext: (params: ModelContextParams) => Promise<string | undefined>;
+    private sendModelContext;
+    openFile: (path: string) => Promise<void>;
+    readResource: (uri: string, representation?: ResourceRepresentation) => Promise<FileResource>;
+    watchResource: (uri: string, onUpdate: () => void) => (() => void);
+    writeResource: (uri: string, content: FileResourceContent, ifMatch?: string) => Promise<FileResourceWriteResult>;
+    private getResourceApp;
+    uploadFile: (file: File, options?: UploadFileOptions) => Promise<FileMetadata>;
+    getFileDownloadUrl: (file: FileMetadata) => Promise<{
+        downloadUrl: string;
+    }>;
+    selectFiles: () => Promise<FileMetadata[]>;
+    openModal: (options: RequestModalOptions) => void;
+    setOpenInAppUrl: (href: string) => Promise<void>;
+    closeModal: () => void;
+    private trackFileIds;
+    private subscribeToViewUUID;
+    private restoreFromLocalStorage;
+    protected persistToLocalStorage(state: Record<string, unknown> | null): void;
+}

package/dist/web/bridges/adaptor.js

@@ -0,0 +1,471 @@
+import { ResultSchema } from "@modelcontextprotocol/core";
+import * as z from "zod/v4";
+import { warnOnLargeViewState } from "../../context-warnings.js";
+import { AppsSdkBridge } from "./apps-sdk/bridge.js";
+import { McpAppBridge } from "./mcp-app/bridge.js";
+import { NotSupportedError } from "./types.js";
+const ResourceMetaSchema = z.object({
+    writable: z.boolean().optional(),
+    etag: z.string().optional(),
+});
+const WriteResultSchema = z.discriminatedUnion("outcome", [
+    z.object({ outcome: z.enum(["saved", "conflict"]), etag: z.string() }),
+    z.object({ outcome: z.literal("too-large"), maxBytes: z.number() }),
+]);
+const STORAGE_PREFIX = "sb:";
+const MAX_STORAGE_ENTRIES = 200;
+function isImage(mimeType) {
+    return mimeType?.startsWith("image/") ?? false;
+}
+function findStorageKey(viewUUID) {
+    const suffix = `:${viewUUID}`;
+    for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        if (key?.startsWith(STORAGE_PREFIX) && key.endsWith(suffix)) {
+            return key;
+        }
+    }
+    return undefined;
+}
+/**
+ * @internal
+ * Single composite implementation of {@link Adaptor}. Composes the MCP App
+ * bridge (always present) with an optional `window.openai` overlay. Per-method
+ * routing rules are encoded inline.
+ */
+export class HostAdaptor {
+    static instance = null;
+    static getInstance() {
+        if (!HostAdaptor.instance) {
+            HostAdaptor.instance = new HostAdaptor();
+        }
+        return HostAdaptor.instance;
+    }
+    static resetInstance() {
+        HostAdaptor.instance?.cleanup();
+        HostAdaptor.instance = null;
+    }
+    mcp;
+    openai = null;
+    stores;
+    _viewState = null;
+    viewStateListeners = new Set();
+    _viewUUID = null;
+    _modelContext = null;
+    resourceListeners = new Map();
+    resourceApp;
+    _polyfillDisplay = { mode: "inline" };
+    polyfillDisplayListeners = new Set();
+    polyfillDisplayStore;
+    polyfillViewStateStore;
+    unsubscribeViewUUID = null;
+    unsubscribeModelContext = null;
+    constructor() {
+        this.mcp = McpAppBridge.getInstance();
+        let overlayStores = null;
+        if (typeof window !== "undefined" && window.openai !== undefined) {
+            this.openai = window.openai;
+            overlayStores = AppsSdkBridge.getInstance().createOverlayStores();
+        }
+        // Built once so that getHostContextStore returns stable references — required
+        // by useSyncExternalStore to avoid resubscribing on every render.
+        this.polyfillDisplayStore = {
+            subscribe: (onChange) => {
+                this.polyfillDisplayListeners.add(onChange);
+                return () => {
+                    this.polyfillDisplayListeners.delete(onChange);
+                };
+            },
+            getSnapshot: () => this._polyfillDisplay,
+        };
+        this.polyfillViewStateStore = {
+            subscribe: (onChange) => {
+                this.viewStateListeners.add(onChange);
+                return () => {
+                    this.viewStateListeners.delete(onChange);
+                };
+            },
+            getSnapshot: () => this._viewState,
+        };
+        this.stores = {
+            ...this.mcp.createContextStores(),
+            display: overlayStores?.display ?? this.polyfillDisplayStore,
+            viewState: overlayStores?.viewState ?? this.polyfillViewStateStore,
+        };
+        this.subscribeToViewUUID();
+        this.unsubscribeModelContext = this.mcp.subscribe("openai/modelContext")(() => {
+            if (this.mcp.getSnapshot("openai/modelContext") === null) {
+                this._modelContext = null;
+            }
+        });
+    }
+    /** @internal Release any subscriptions held on the underlying bridges. */
+    cleanup() {
+        this.unsubscribeViewUUID?.();
+        this.unsubscribeViewUUID = null;
+        this.unsubscribeModelContext?.();
+        this.unsubscribeModelContext = null;
+    }
+    // ---- Adaptor interface ----
+    getHostContextStore = (key) => this.stores[key];
+    callTool = async (name, args, options) => {
+        const timeout = options?.timeout;
+        if (timeout !== undefined && (!Number.isFinite(timeout) || timeout <= 0)) {
+            throw new RangeError("Tool call timeout must be a positive, finite number of milliseconds.");
+        }
+        const app = await this.mcp.getApp();
+        const params = { name, arguments: args ?? undefined };
+        const response = await app.callServerTool(params, { timeout });
+        return {
+            content: response.content,
+            structuredContent: response.structuredContent ?? {},
+            isError: response.isError ?? false,
+            meta: response._meta ?? {},
+        };
+    };
+    registerViewTool = (config, handler) => {
+        return this.mcp.registerViewTool(config, handler);
+    };
+    requestDisplayMode = async (mode) => {
+        const app = await this.mcp.getApp();
+        return app.requestDisplayMode({ mode });
+    };
+    requestClose = async () => {
+        if (this.openai) {
+            await this.openai.requestClose();
+        }
+        const app = await this.mcp.getApp();
+        await app.requestTeardown();
+    };
+    requestSize = async (size) => {
+        const app = await this.mcp.getApp();
+        await app.sendSizeChanged(size);
+    };
+    sendFollowUpMessage = async (prompt, options) => {
+        const target = options?.target;
+        if (this.openai && typeof prompt === "string" && target !== "new") {
+            await this.openai.sendFollowUpMessage({
+                prompt,
+                scrollToBottom: options?.scrollToBottom,
+            });
+            return;
+        }
+        const app = await this.mcp.getApp();
+        if (target === "new" &&
+            !app.getHostCapabilities()?.experimental?.["openai/message"]) {
+            throw new NotSupportedError("sendFollowUpMessage", "the host does not advertise openai/message, so it can't open a new conversation");
+        }
+        const result = await app.sendMessage({
+            role: "user",
+            content: typeof prompt === "string" ? [{ type: "text", text: prompt }] : prompt,
+            ...(target === "new" && { _meta: { "openai/message": { target } } }),
+        });
+        if (result?.isError) {
+            throw new Error("The host rejected the follow-up message.");
+        }
+    };
+    openExternal = (href, options) => {
+        if (this.openai) {
+            this.openai.openExternal({ href, ...options });
+            return;
+        }
+        this.mcp
+            .getApp()
+            .then((app) => app.openLink({ url: href }))
+            .catch((err) => {
+            console.error("Failed to open external link:", err);
+        });
+    };
+    download = async (params) => {
+        const app = await this.mcp.getApp();
+        if (!app.getHostCapabilities()?.downloadFile) {
+            console.error("[skybridge] download: host does not support ui/download-file");
+            return { isError: true };
+        }
+        return app.downloadFile(params);
+    };
+    setViewState = async (stateOrUpdater) => {
+        if (this.openai) {
+            const modelContent = typeof stateOrUpdater === "function"
+                ? stateOrUpdater(this.openai.widgetState?.modelContent ?? null)
+                : stateOrUpdater;
+            warnOnLargeViewState(modelContent, "setWidgetState");
+            await this.openai.setWidgetState({
+                privateContent: {},
+                ...this.openai.widgetState,
+                modelContent,
+            });
+            return;
+        }
+        const newState = typeof stateOrUpdater === "function"
+            ? stateOrUpdater(this._viewState)
+            : stateOrUpdater;
+        warnOnLargeViewState(newState, "setViewState");
+        // update local state immediately so successive calls see fresh state
+        this._viewState = newState;
+        this.viewStateListeners.forEach((l) => {
+            l();
+        });
+        this.persistToLocalStorage(newState);
+        try {
+            await this.sendModelContext();
+        }
+        catch (error) {
+            console.error("Failed to update view state in MCP App.", error);
+        }
+    };
+    updateModelContext = async (params) => {
+        const app = await this.mcp.getApp();
+        const capabilities = app.getHostCapabilities();
+        if (!capabilities?.updateModelContext &&
+            !capabilities?.experimental?.["openai/modelContext"]) {
+            throw new NotSupportedError("updateModelContext", "the host does not advertise updateModelContext");
+        }
+        const previous = this._modelContext;
+        this._modelContext = params;
+        const result = await this.sendModelContext().catch((error) => {
+            if (this._modelContext === params) {
+                this._modelContext = previous;
+            }
+            throw error;
+        });
+        const parsed = z
+            .object({ updateId: z.string() })
+            .safeParse(result._meta?.["openai/modelContext"]);
+        return parsed.success ? parsed.data.updateId : undefined;
+    };
+    async sendModelContext() {
+        const viewState = this.openai ? null : this._viewState;
+        const extra = this._modelContext;
+        const collisions = Object.keys(extra?.structuredContent ?? {}).filter((key) => viewState !== null && key in viewState);
+        if (collisions.length > 0) {
+            console.warn(`skybridge: view state overrides model context keys ${collisions.join(", ")}.`);
+        }
+        const structuredContent = { ...extra?.structuredContent, ...viewState };
+        const app = await this.mcp.getApp();
+        return app.updateModelContext({
+            ...(Object.keys(structuredContent).length > 0 && { structuredContent }),
+            content: [
+                ...(viewState === null
+                    ? []
+                    : [
+                        {
+                            type: "text",
+                            text: JSON.stringify(viewState),
+                            annotations: { audience: ["assistant"] },
+                        },
+                    ]),
+                ...(extra?.content ?? []),
+            ],
+        });
+    }
+    openFile = async (path) => {
+        const app = await this.mcp.getApp();
+        if (!app.getHostCapabilities()?.experimental?.["openai/files"]) {
+            throw new NotSupportedError("openFile", "the host does not advertise openai/files");
+        }
+        await app.request({ method: "openai/files/open", params: { path } }, ResultSchema);
+    };
+    readResource = async (uri, representation) => {
+        const app = await this.mcp.getApp();
+        const { contents } = await app.readServerResource({
+            uri,
+            ...(representation && {
+                _meta: { "openai/resource": { representation } },
+            }),
+        });
+        const item = contents.find((content) => content.uri === uri) ?? contents[0];
+        if (!item) {
+            throw new Error(`The host returned no contents for ${uri}.`);
+        }
+        const { data: meta } = ResourceMetaSchema.safeParse(item._meta?.["openai/resource"]);
+        return {
+            ...("text" in item ? { text: item.text } : { blob: item.blob }),
+            mimeType: item.mimeType,
+            writable: meta?.writable ?? false,
+            etag: meta?.etag,
+        };
+    };
+    watchResource = (uri, onUpdate) => {
+        const listeners = this.resourceListeners.get(uri) ?? new Set();
+        if (listeners.size === 0) {
+            this.resourceListeners.set(uri, listeners);
+            this.getResourceApp()
+                .then((app) => app?.request({ method: "resources/subscribe", params: { uri } }, ResultSchema))
+                .catch((error) => {
+                console.warn(`Failed to subscribe to ${uri}.`, error);
+            });
+        }
+        listeners.add(onUpdate);
+        return () => {
+            if (listeners.delete(onUpdate) && listeners.size === 0) {
+                this.resourceListeners.delete(uri);
+                this.getResourceApp()
+                    .then((app) => app?.request({ method: "resources/unsubscribe", params: { uri } }, ResultSchema))
+                    .catch(() => { });
+            }
+        };
+    };
+    writeResource = async (uri, content, ifMatch) => {
+        const app = await this.getResourceApp();
+        if (!app) {
+            throw new NotSupportedError("writeResource", "the host does not advertise openai/resource");
+        }
+        return app.request({
+            method: "openai/resources/write",
+            params: { uri, ...content, ...(ifMatch && { ifMatch }) },
+        }, WriteResultSchema);
+    };
+    getResourceApp() {
+        this.resourceApp ??= this.mcp.getApp().then((app) => {
+            if (!app.getHostCapabilities()?.experimental?.["openai/resource"]) {
+                return undefined;
+            }
+            app.setNotificationHandler("notifications/resources/updated", ({ params }) => {
+                this.resourceListeners.get(params.uri)?.forEach((l) => {
+                    l();
+                });
+            });
+            return app;
+        });
+        return this.resourceApp;
+    }
+    uploadFile = async (file, options) => {
+        if (!this.openai) {
+            throw new NotSupportedError("uploadFile");
+        }
+        const metadata = await this.openai.uploadFile(file, options);
+        if (isImage(metadata.mimeType ?? file.type)) {
+            await this.trackFileIds(metadata.fileId);
+        }
+        return metadata;
+    };
+    getFileDownloadUrl = (file) => {
+        if (!this.openai) {
+            return Promise.reject(new NotSupportedError("getFileDownloadUrl"));
+        }
+        return this.openai.getFileDownloadUrl(file);
+    };
+    selectFiles = async () => {
+        if (!this.openai) {
+            throw new NotSupportedError("selectFiles");
+        }
+        if (!this.openai.selectFiles) {
+            throw new Error("selectFiles is not supported by the current host version.");
+        }
+        const files = await this.openai.selectFiles();
+        const imageIds = [];
+        for (const file of files) {
+            if (isImage(file.mimeType)) {
+                imageIds.push(file.fileId);
+            }
+        }
+        if (imageIds.length > 0) {
+            await this.trackFileIds(...imageIds);
+        }
+        return files;
+    };
+    openModal = (options) => {
+        if (this.openai) {
+            this.openai.requestModal(options);
+            return;
+        }
+        this._polyfillDisplay = { mode: "modal", params: options.params };
+        this.polyfillDisplayListeners.forEach((l) => {
+            l();
+        });
+    };
+    setOpenInAppUrl = (href) => {
+        if (!this.openai) {
+            return Promise.reject(new NotSupportedError("setOpenInAppUrl"));
+        }
+        const trimmed = href.trim();
+        if (!trimmed) {
+            return Promise.reject(new Error("The href parameter is required."));
+        }
+        return this.openai.setOpenInAppUrl({ href: trimmed });
+    };
+    closeModal = () => {
+        if (this.openai) {
+            return; // host owns modal lifecycle
+        }
+        this._polyfillDisplay = { mode: "inline" };
+        this.polyfillDisplayListeners.forEach((l) => {
+            l();
+        });
+    };
+    async trackFileIds(...fileIds) {
+        if (!this.openai) {
+            return;
+        }
+        const current = this.openai.widgetState;
+        const state = current
+            ? { ...current }
+            : { modelContent: {}, privateContent: {} };
+        if (!state.imageIds) {
+            state.imageIds = [];
+        }
+        state.imageIds.push(...fileIds);
+        await this.openai.setWidgetState(state);
+    }
+    // ---- viewState persistence helpers ----
+    subscribeToViewUUID() {
+        this.unsubscribeViewUUID = this.mcp.subscribe("toolResult")(() => {
+            const toolResult = this.mcp.getSnapshot("toolResult");
+            const viewUUID = toolResult?._meta?.viewUUID;
+            if (viewUUID && viewUUID !== this._viewUUID) {
+                this._viewUUID = viewUUID;
+                this.restoreFromLocalStorage(viewUUID);
+            }
+        });
+    }
+    restoreFromLocalStorage(viewUUID) {
+        try {
+            const existingKey = findStorageKey(viewUUID);
+            if (existingKey) {
+                const stored = localStorage.getItem(existingKey);
+                if (stored !== null) {
+                    this._viewState = JSON.parse(stored);
+                    this.viewStateListeners.forEach((l) => {
+                        l();
+                    });
+                }
+            }
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+    persistToLocalStorage(state) {
+        if (!this._viewUUID || state === null) {
+            return;
+        }
+        try {
+            const oldKey = findStorageKey(this._viewUUID);
+            if (oldKey) {
+                localStorage.removeItem(oldKey);
+            }
+            const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;
+            localStorage.setItem(newKey, JSON.stringify(state));
+            const keys = [];
+            for (let i = 0; i < localStorage.length; i++) {
+                const key = localStorage.key(i);
+                if (key?.startsWith(STORAGE_PREFIX)) {
+                    keys.push(key);
+                }
+            }
+            if (keys.length <= MAX_STORAGE_ENTRIES) {
+                return;
+            }
+            keys.sort();
+            const toRemove = keys.slice(0, keys.length - MAX_STORAGE_ENTRIES);
+            for (const key of toRemove) {
+                localStorage.removeItem(key);
+            }
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }
+}
+//# sourceMappingURL=adaptor.js.map