skybridge 0.0.0-dev.f792261 → 0.0.0-dev.f7943e6

package/dist/web/hooks/use-view-state.test.js

@@ -1,6 +1,8 @@
 import { act, renderHook, waitFor } from "@testing-library/react";
+import { StrictMode } from "react";
 import { afterEach, beforeEach, describe, expect, it, vi, } from "vitest";
-import { McpAppAdaptor, McpAppBridge } from "../bridges/mcp-app/index.js";
+import { HostAdaptor } from "../bridges/adaptor.js";
+import { McpAppBridge } from "../bridges/mcp-app/index.js";
 import { fireToolResultNotification, getMcpAppHostPostMessageMock, MockResizeObserver, } from "./test/utils.js";
 import { useViewState } from "./use-view-state.js";
 describe("useViewState", () => {
@@ -16,6 +18,8 @@ describe("useViewState", () => {
     afterEach(() => {
         vi.unstubAllGlobals();
         vi.resetAllMocks();
+        HostAdaptor.resetInstance();
+        McpAppBridge.resetInstance();
     });
     const defaultState = { count: 0, name: "test" };
     const windowState = { count: 5, name: "window" };
@@ -52,6 +56,36 @@ describe("useViewState", () => {
         });
         expect(result.current[0]).toEqual({ count: 1, name: "test" });
     });
+    it("should call window.openai.setWidgetState once per update under StrictMode", () => {
+        const { result } = renderHook(() => useViewState(defaultState), {
+            wrapper: StrictMode,
+        });
+        act(() => {
+            result.current[1]({ count: 10, name: "updated" });
+        });
+        expect(OpenaiMock.setWidgetState).toHaveBeenCalledTimes(1);
+    });
+    it("should not persist anything on mount", () => {
+        renderHook(() => useViewState(defaultState), { wrapper: StrictMode });
+        expect(OpenaiMock.setWidgetState).not.toHaveBeenCalled();
+    });
+    it("should persist state when setViewState and unmount happen in the same tick", () => {
+        const { result, unmount } = renderHook(() => useViewState(defaultState));
+        act(() => {
+            result.current[1]({ count: 10, name: "updated" });
+            unmount();
+        });
+        expect(OpenaiMock.setWidgetState).toHaveBeenCalledTimes(1);
+    });
+    it("should not persist state when setViewState is called after unmount", () => {
+        const { result, unmount } = renderHook(() => useViewState(defaultState));
+        const setViewState = result.current[1];
+        unmount();
+        act(() => {
+            setViewState({ count: 10, name: "updated" });
+        });
+        expect(OpenaiMock.setWidgetState).not.toHaveBeenCalled();
+    });
     it("should update state when window.openai.widgetState changes", () => {
         OpenaiMock.widgetState = { modelContent: defaultState };
         const { result, rerender } = renderHook(() => useViewState(defaultState));
@@ -67,14 +101,15 @@ describe("useViewState (mcp-app host — localStorage persistence)", () => {
     beforeEach(() => {
         vi.stubGlobal("parent", { postMessage: getMcpAppHostPostMessageMock() });
         vi.stubGlobal("skybridge", { hostType: "mcp-app" });
+        vi.stubGlobal("openai", undefined);
         vi.stubGlobal("ResizeObserver", MockResizeObserver);
         localStorage.clear();
     });
     afterEach(() => {
         vi.unstubAllGlobals();
         vi.resetAllMocks();
+        HostAdaptor.resetInstance();
         McpAppBridge.resetInstance();
-        McpAppAdaptor.resetInstance();
         localStorage.clear();
     });
     it("should persist state to localStorage when viewUUID is available", async () => {

package/dist/web/hooks/use-view-state.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-view-state.test.js","sourceRoot":"","sources":["../../../src/web/hooks/use-view-state.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { act, renderHook, waitFor } from \"@testing-library/react\";\nimport {\n  afterEach,\n  beforeEach,\n  describe,\n  expect,\n  it,\n  type Mock,\n  vi,\n} from \"vitest\";\nimport { McpAppAdaptor, McpAppBridge } from \"../bridges/mcp-app/index.js\";\nimport {\n  fireToolResultNotification,\n  getMcpAppHostPostMessageMock,\n  MockResizeObserver,\n} from \"./test/utils.js\";\nimport { useViewState } from \"./use-view-state.js\";\n\ndescribe(\"useViewState\", () => {\n  let OpenaiMock: { widgetState: unknown; setWidgetState: Mock };\n\n  beforeEach(() => {\n    OpenaiMock = {\n      widgetState: null,\n      setWidgetState: vi.fn().mockResolvedValue(undefined),\n    };\n    vi.stubGlobal(\"openai\", OpenaiMock);\n    vi.stubGlobal(\"skybridge\", { hostType: \"apps-sdk\" });\n  });\n\n  afterEach(() => {\n    vi.unstubAllGlobals();\n    vi.resetAllMocks();\n  });\n\n  const defaultState = { count: 0, name: \"test\" };\n  const windowState = { count: 5, name: \"window\" };\n\n  it(\"should initialize with default state when window.openai.widgetState is null\", () => {\n    OpenaiMock.widgetState = null;\n    const { result } = renderHook(() => useViewState(defaultState));\n\n    expect(result.current[0]).toEqual(defaultState);\n  });\n\n  it(\"should initialize with window.openai.widgetState when available\", () => {\n    OpenaiMock.widgetState = { modelContent: windowState };\n    const { result } = renderHook(() => useViewState(defaultState));\n\n    expect(result.current[0]).toEqual(windowState);\n  });\n\n  it(\"should call window.openai.setWidgetState when setViewState is called with a new state\", async () => {\n    const { result } = renderHook(() => useViewState(defaultState));\n    const newState = { count: 10, name: \"updated\" };\n\n    act(() => {\n      result.current[1](newState);\n    });\n\n    expect(OpenaiMock.setWidgetState).toHaveBeenCalledWith({\n      modelContent: newState,\n      privateContent: {},\n    });\n    expect(result.current[0]).toEqual(newState);\n  });\n\n  it(\"should call window.openai.setWidgetState when setViewState is called with a function updater\", async () => {\n    const { result } = renderHook(() => useViewState(defaultState));\n\n    act(() => {\n      result.current[1]((prev) => ({ ...prev, count: prev.count + 1 }));\n    });\n\n    expect(OpenaiMock.setWidgetState).toHaveBeenCalledWith({\n      modelContent: { count: 1, name: \"test\" },\n      privateContent: {},\n    });\n    expect(result.current[0]).toEqual({ count: 1, name: \"test\" });\n  });\n\n  it(\"should update state when window.openai.widgetState changes\", () => {\n    OpenaiMock.widgetState = { modelContent: defaultState };\n    const { result, rerender } = renderHook(() => useViewState(defaultState));\n\n    expect(result.current[0]).toEqual(defaultState);\n\n    // Simulate window.openai.widgetState changing\n    OpenaiMock.widgetState = { modelContent: windowState };\n    // Trigger re-render to simulate the useEffect running\n    rerender();\n\n    expect(result.current[0]).toEqual(windowState);\n  });\n});\n\ndescribe(\"useViewState (mcp-app host — localStorage persistence)\", () => {\n  beforeEach(() => {\n    vi.stubGlobal(\"parent\", { postMessage: getMcpAppHostPostMessageMock() });\n    vi.stubGlobal(\"skybridge\", { hostType: \"mcp-app\" });\n    vi.stubGlobal(\"ResizeObserver\", MockResizeObserver);\n    localStorage.clear();\n  });\n\n  afterEach(() => {\n    vi.unstubAllGlobals();\n    vi.resetAllMocks();\n    McpAppBridge.resetInstance();\n    McpAppAdaptor.resetInstance();\n    localStorage.clear();\n  });\n\n  it(\"should persist state to localStorage when viewUUID is available\", async () => {\n    const viewUUID = \"test-uuid-123\";\n    const { result } = renderHook(() => useViewState({ page: 1, zoom: 100 }));\n\n    await act(async () => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    act(() => {\n      result.current[1]({ page: 3, zoom: 150 });\n    });\n\n    expect(result.current[0]).toEqual({ page: 3, zoom: 150 });\n    expect(localStorage.length).toBe(1);\n  });\n\n  it(\"should restore state from localStorage when viewUUID arrives\", async () => {\n    const viewUUID = \"test-uuid-456\";\n    // Pre-seed with the sb:{timestamp}:{viewUUID} format\n    localStorage.setItem(\n      `sb:1700000000000:${viewUUID}`,\n      JSON.stringify({ page: 5, zoom: 200 }),\n    );\n\n    const { result } = renderHook(() => useViewState({ page: 1, zoom: 100 }));\n\n    act(() => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    await waitFor(() => {\n      expect(result.current[0]).toEqual({ page: 5, zoom: 200 });\n    });\n  });\n\n  it(\"should not persist when no viewUUID is available\", () => {\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    act(() => {\n      result.current[1]({ page: 2 });\n    });\n\n    expect(result.current[0]).toEqual({ page: 2 });\n    expect(localStorage.length).toBe(0);\n  });\n\n  it(\"should handle corrupted localStorage data gracefully\", async () => {\n    const viewUUID = \"test-uuid-corrupt\";\n    localStorage.setItem(`sb:1700000000000:${viewUUID}`, \"not valid json{{{\");\n\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    act(() => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    await waitFor(() => {\n      expect(result.current[0]).toEqual({ page: 1 });\n    });\n  });\n\n  it(\"should refresh localStorage timestamp on each persist (LRU)\", async () => {\n    const viewUUID = \"lru-test-uuid\";\n    const oldKey = `sb:1000000000000:${viewUUID}`;\n    localStorage.setItem(oldKey, JSON.stringify({ page: 1 }));\n\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    await act(async () => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    act(() => {\n      result.current[1]({ page: 2 });\n    });\n\n    // Old key removed, replaced with a new one (still just 1 entry)\n    expect(localStorage.getItem(oldKey)).toBeNull();\n    expect(localStorage.length).toBe(1);\n  });\n\n  it(\"should evict oldest entries when exceeding max storage entries\", async () => {\n    // Fill localStorage with 200 entries (the max)\n    for (let i = 0; i < 200; i++) {\n      localStorage.setItem(\n        `sb:${String(1000000000000 + i)}:old-uuid-${String(i).padStart(4, \"0\")}`,\n        JSON.stringify({ i }),\n      );\n    }\n    expect(localStorage.length).toBe(200);\n\n    const viewUUID = \"eviction-test-uuid\";\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    await act(async () => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    act(() => {\n      result.current[1]({ page: 99 });\n    });\n\n    // Should have evicted the oldest entry to stay at 200\n    expect(localStorage.length).toBe(200);\n    expect(localStorage.getItem(\"sb:1000000000000:old-uuid-0000\")).toBeNull();\n  });\n});\n"]}
+{"version":3,"file":"use-view-state.test.js","sourceRoot":"","sources":["../../../src/web/hooks/use-view-state.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { act, renderHook, waitFor } from \"@testing-library/react\";\nimport { StrictMode } from \"react\";\nimport {\n  afterEach,\n  beforeEach,\n  describe,\n  expect,\n  it,\n  type Mock,\n  vi,\n} from \"vitest\";\nimport { HostAdaptor } from \"../bridges/adaptor.js\";\nimport { McpAppBridge } from \"../bridges/mcp-app/index.js\";\nimport {\n  fireToolResultNotification,\n  getMcpAppHostPostMessageMock,\n  MockResizeObserver,\n} from \"./test/utils.js\";\nimport { useViewState } from \"./use-view-state.js\";\n\ndescribe(\"useViewState\", () => {\n  let OpenaiMock: { widgetState: unknown; setWidgetState: Mock };\n\n  beforeEach(() => {\n    OpenaiMock = {\n      widgetState: null,\n      setWidgetState: vi.fn().mockResolvedValue(undefined),\n    };\n    vi.stubGlobal(\"openai\", OpenaiMock);\n    vi.stubGlobal(\"skybridge\", { hostType: \"apps-sdk\" });\n  });\n\n  afterEach(() => {\n    vi.unstubAllGlobals();\n    vi.resetAllMocks();\n    HostAdaptor.resetInstance();\n    McpAppBridge.resetInstance();\n  });\n\n  const defaultState = { count: 0, name: \"test\" };\n  const windowState = { count: 5, name: \"window\" };\n\n  it(\"should initialize with default state when window.openai.widgetState is null\", () => {\n    OpenaiMock.widgetState = null;\n    const { result } = renderHook(() => useViewState(defaultState));\n\n    expect(result.current[0]).toEqual(defaultState);\n  });\n\n  it(\"should initialize with window.openai.widgetState when available\", () => {\n    OpenaiMock.widgetState = { modelContent: windowState };\n    const { result } = renderHook(() => useViewState(defaultState));\n\n    expect(result.current[0]).toEqual(windowState);\n  });\n\n  it(\"should call window.openai.setWidgetState when setViewState is called with a new state\", async () => {\n    const { result } = renderHook(() => useViewState(defaultState));\n    const newState = { count: 10, name: \"updated\" };\n\n    act(() => {\n      result.current[1](newState);\n    });\n\n    expect(OpenaiMock.setWidgetState).toHaveBeenCalledWith({\n      modelContent: newState,\n      privateContent: {},\n    });\n    expect(result.current[0]).toEqual(newState);\n  });\n\n  it(\"should call window.openai.setWidgetState when setViewState is called with a function updater\", async () => {\n    const { result } = renderHook(() => useViewState(defaultState));\n\n    act(() => {\n      result.current[1]((prev) => ({ ...prev, count: prev.count + 1 }));\n    });\n\n    expect(OpenaiMock.setWidgetState).toHaveBeenCalledWith({\n      modelContent: { count: 1, name: \"test\" },\n      privateContent: {},\n    });\n    expect(result.current[0]).toEqual({ count: 1, name: \"test\" });\n  });\n\n  it(\"should call window.openai.setWidgetState once per update under StrictMode\", () => {\n    const { result } = renderHook(() => useViewState(defaultState), {\n      wrapper: StrictMode,\n    });\n\n    act(() => {\n      result.current[1]({ count: 10, name: \"updated\" });\n    });\n\n    expect(OpenaiMock.setWidgetState).toHaveBeenCalledTimes(1);\n  });\n\n  it(\"should not persist anything on mount\", () => {\n    renderHook(() => useViewState(defaultState), { wrapper: StrictMode });\n\n    expect(OpenaiMock.setWidgetState).not.toHaveBeenCalled();\n  });\n\n  it(\"should persist state when setViewState and unmount happen in the same tick\", () => {\n    const { result, unmount } = renderHook(() => useViewState(defaultState));\n\n    act(() => {\n      result.current[1]({ count: 10, name: \"updated\" });\n      unmount();\n    });\n\n    expect(OpenaiMock.setWidgetState).toHaveBeenCalledTimes(1);\n  });\n\n  it(\"should not persist state when setViewState is called after unmount\", () => {\n    const { result, unmount } = renderHook(() => useViewState(defaultState));\n    const setViewState = result.current[1];\n\n    unmount();\n\n    act(() => {\n      setViewState({ count: 10, name: \"updated\" });\n    });\n\n    expect(OpenaiMock.setWidgetState).not.toHaveBeenCalled();\n  });\n\n  it(\"should update state when window.openai.widgetState changes\", () => {\n    OpenaiMock.widgetState = { modelContent: defaultState };\n    const { result, rerender } = renderHook(() => useViewState(defaultState));\n\n    expect(result.current[0]).toEqual(defaultState);\n\n    // Simulate window.openai.widgetState changing\n    OpenaiMock.widgetState = { modelContent: windowState };\n    // Trigger re-render to simulate the useEffect running\n    rerender();\n\n    expect(result.current[0]).toEqual(windowState);\n  });\n});\n\ndescribe(\"useViewState (mcp-app host — localStorage persistence)\", () => {\n  beforeEach(() => {\n    vi.stubGlobal(\"parent\", { postMessage: getMcpAppHostPostMessageMock() });\n    vi.stubGlobal(\"skybridge\", { hostType: \"mcp-app\" });\n    vi.stubGlobal(\"openai\", undefined);\n    vi.stubGlobal(\"ResizeObserver\", MockResizeObserver);\n    localStorage.clear();\n  });\n\n  afterEach(() => {\n    vi.unstubAllGlobals();\n    vi.resetAllMocks();\n    HostAdaptor.resetInstance();\n    McpAppBridge.resetInstance();\n    localStorage.clear();\n  });\n\n  it(\"should persist state to localStorage when viewUUID is available\", async () => {\n    const viewUUID = \"test-uuid-123\";\n    const { result } = renderHook(() => useViewState({ page: 1, zoom: 100 }));\n\n    await act(async () => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    act(() => {\n      result.current[1]({ page: 3, zoom: 150 });\n    });\n\n    expect(result.current[0]).toEqual({ page: 3, zoom: 150 });\n    expect(localStorage.length).toBe(1);\n  });\n\n  it(\"should restore state from localStorage when viewUUID arrives\", async () => {\n    const viewUUID = \"test-uuid-456\";\n    // Pre-seed with the sb:{timestamp}:{viewUUID} format\n    localStorage.setItem(\n      `sb:1700000000000:${viewUUID}`,\n      JSON.stringify({ page: 5, zoom: 200 }),\n    );\n\n    const { result } = renderHook(() => useViewState({ page: 1, zoom: 100 }));\n\n    act(() => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    await waitFor(() => {\n      expect(result.current[0]).toEqual({ page: 5, zoom: 200 });\n    });\n  });\n\n  it(\"should not persist when no viewUUID is available\", () => {\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    act(() => {\n      result.current[1]({ page: 2 });\n    });\n\n    expect(result.current[0]).toEqual({ page: 2 });\n    expect(localStorage.length).toBe(0);\n  });\n\n  it(\"should handle corrupted localStorage data gracefully\", async () => {\n    const viewUUID = \"test-uuid-corrupt\";\n    localStorage.setItem(`sb:1700000000000:${viewUUID}`, \"not valid json{{{\");\n\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    act(() => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    await waitFor(() => {\n      expect(result.current[0]).toEqual({ page: 1 });\n    });\n  });\n\n  it(\"should refresh localStorage timestamp on each persist (LRU)\", async () => {\n    const viewUUID = \"lru-test-uuid\";\n    const oldKey = `sb:1000000000000:${viewUUID}`;\n    localStorage.setItem(oldKey, JSON.stringify({ page: 1 }));\n\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    await act(async () => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    act(() => {\n      result.current[1]({ page: 2 });\n    });\n\n    // Old key removed, replaced with a new one (still just 1 entry)\n    expect(localStorage.getItem(oldKey)).toBeNull();\n    expect(localStorage.length).toBe(1);\n  });\n\n  it(\"should evict oldest entries when exceeding max storage entries\", async () => {\n    // Fill localStorage with 200 entries (the max)\n    for (let i = 0; i < 200; i++) {\n      localStorage.setItem(\n        `sb:${String(1000000000000 + i)}:old-uuid-${String(i).padStart(4, \"0\")}`,\n        JSON.stringify({ i }),\n      );\n    }\n    expect(localStorage.length).toBe(200);\n\n    const viewUUID = \"eviction-test-uuid\";\n    const { result } = renderHook(() => useViewState({ page: 1 }));\n\n    await act(async () => {\n      fireToolResultNotification({\n        content: [{ type: \"text\", text: \"result\" }],\n        structuredContent: {},\n        _meta: { viewUUID },\n      });\n    });\n\n    act(() => {\n      result.current[1]({ page: 99 });\n    });\n\n    // Should have evicted the oldest entry to stay at 200\n    expect(localStorage.length).toBe(200);\n    expect(localStorage.getItem(\"sb:1000000000000:old-uuid-0000\")).toBeNull();\n  });\n});\n"]}

package/dist/web/mount-view.d.ts

@@ -1 +1,20 @@
+/**
+ * Mount a view's root React component into `#root`. Each view file's entry
+ * point should call this exactly once.
+ *
+ * Wraps the component in `StrictMode`, applies host-specific providers
+ * automatically (e.g. modal support for MCP Apps), and installs the dev-mode
+ * logging proxy for `window.openai` calls.
+ *
+ * @param component - Your root React element (already constructed, e.g. `<App />`).
+ *
+ * @example
+ * ```tsx
+ * // src/views/search.tsx
+ * import { mountView } from "skybridge/web";
+ * import { App } from "./App";
+ *
+ * mountView(<App />);
+ * ```
+ */
 export declare const mountView: (component: React.ReactNode) => void;

package/dist/web/mount-view.js

@@ -3,6 +3,25 @@ import { createElement, StrictMode } from "react";
 import { createRoot } from "react-dom/client";
 import { installOpenAILoggingProxy } from "./proxy.js";
 let rootInstance = null;
+/**
+ * Mount a view's root React component into `#root`. Each view file's entry
+ * point should call this exactly once.
+ *
+ * Wraps the component in `StrictMode`, applies host-specific providers
+ * automatically (e.g. modal support for MCP Apps), and installs the dev-mode
+ * logging proxy for `window.openai` calls.
+ *
+ * @param component - Your root React element (already constructed, e.g. `<App />`).
+ *
+ * @example
+ * ```tsx
+ * // src/views/search.tsx
+ * import { mountView } from "skybridge/web";
+ * import { App } from "./App";
+ *
+ * mountView(<App />);
+ * ```
+ */
 export const mountView = (component) => {
     const rootElement = document.getElementById("root");
     if (!rootElement) {

package/dist/web/mount-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"mount-view.js","sourceRoot":"","sources":["../../src/web/mount-view.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,IAAI,YAAY,GAAgB,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAA0B,EAAE,EAAE;IACtD,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACxB,yBAAyB,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;IAE5C,CAAC,KAAK,IAAI,EAAE;QACV,IAAI,GAAG,GAAG,SAAS,CAAC;QACpB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YACzE,GAAG,GAAG,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACtD,CAAC;QACD,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,EAAE,CAAC;AACP,CAAC,CAAC","sourcesContent":["/// <reference types=\"vite/client\" />\n\nimport { createElement, StrictMode } from \"react\";\nimport { createRoot, type Root } from \"react-dom/client\";\nimport { installOpenAILoggingProxy } from \"./proxy.js\";\n\nlet rootInstance: Root | null = null;\n\nexport const mountView = (component: React.ReactNode) => {\n  const rootElement = document.getElementById(\"root\");\n  if (!rootElement) {\n    throw new Error(\"Root element not found\");\n  }\n\n  if (!rootInstance) {\n    rootInstance = createRoot(rootElement);\n  }\n\n  if (import.meta.env.DEV) {\n    installOpenAILoggingProxy();\n  }\n\n  const hostType = window.skybridge?.hostType;\n\n  (async () => {\n    let app = component;\n    if (hostType === \"mcp-app\") {\n      const { ModalProvider } = await import(\"./components/modal-provider.js\");\n      app = createElement(ModalProvider, null, component);\n    }\n    rootInstance.render(createElement(StrictMode, null, app));\n  })();\n};\n"]}
+{"version":3,"file":"mount-view.js","sourceRoot":"","sources":["../../src/web/mount-view.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,IAAI,YAAY,GAAgB,IAAI,CAAC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAA0B,EAAE,EAAE;IACtD,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACxB,yBAAyB,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;IAE5C,CAAC,KAAK,IAAI,EAAE;QACV,IAAI,GAAG,GAAG,SAAS,CAAC;QACpB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YACzE,GAAG,GAAG,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACtD,CAAC;QACD,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,EAAE,CAAC;AACP,CAAC,CAAC","sourcesContent":["/// <reference types=\"vite/client\" />\n\nimport { createElement, StrictMode } from \"react\";\nimport { createRoot, type Root } from \"react-dom/client\";\nimport { installOpenAILoggingProxy } from \"./proxy.js\";\n\nlet rootInstance: Root | null = null;\n\n/**\n * Mount a view's root React component into `#root`. Each view file's entry\n * point should call this exactly once.\n *\n * Wraps the component in `StrictMode`, applies host-specific providers\n * automatically (e.g. modal support for MCP Apps), and installs the dev-mode\n * logging proxy for `window.openai` calls.\n *\n * @param component - Your root React element (already constructed, e.g. `<App />`).\n *\n * @example\n * ```tsx\n * // src/views/search.tsx\n * import { mountView } from \"skybridge/web\";\n * import { App } from \"./App\";\n *\n * mountView(<App />);\n * ```\n */\nexport const mountView = (component: React.ReactNode) => {\n  const rootElement = document.getElementById(\"root\");\n  if (!rootElement) {\n    throw new Error(\"Root element not found\");\n  }\n\n  if (!rootInstance) {\n    rootInstance = createRoot(rootElement);\n  }\n\n  if (import.meta.env.DEV) {\n    installOpenAILoggingProxy();\n  }\n\n  const hostType = window.skybridge?.hostType;\n\n  (async () => {\n    let app = component;\n    if (hostType === \"mcp-app\") {\n      const { ModalProvider } = await import(\"./components/modal-provider.js\");\n      app = createElement(ModalProvider, null, component);\n    }\n    rootInstance.render(createElement(StrictMode, null, app));\n  })();\n};\n"]}

package/dist/web/types.d.ts

@@ -4,13 +4,17 @@ declare module "react" {
         "data-llm"?: string;
     }
 }
+/** Shorthand for an arbitrary plain object — `Record<string, unknown>`. */
 export type UnknownObject = Record<string, unknown>;
+/** Flatten an intersection so it appears as a single object type in hovers and error messages. */
 export type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
+/** Widen `T` to also satisfy {@link UnknownObject}, useful for tool input/output narrowing. */
 export type Objectify<T> = T & UnknownObject;
 type RequiredKeys<T> = {
     [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;
 }[keyof T];
+/** `true` if `T` has at least one required key, `false` if every key is optional. */
 export type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;
 export {};

package/dist/web/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,CAAC","sourcesContent":["import \"react\";\n\ndeclare module \"react\" {\n  interface HTMLAttributes<T> {\n    \"data-llm\"?: string;\n  }\n}\n\nexport type UnknownObject = Record<string, unknown>;\n\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\nexport type Objectify<T> = T & UnknownObject;\n\ntype RequiredKeys<T> = {\n  [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;\n}[keyof T];\nexport type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,CAAC","sourcesContent":["import \"react\";\n\ndeclare module \"react\" {\n  interface HTMLAttributes<T> {\n    \"data-llm\"?: string;\n  }\n}\n\n/** Shorthand for an arbitrary plain object — `Record<string, unknown>`. */\nexport type UnknownObject = Record<string, unknown>;\n\n/** Flatten an intersection so it appears as a single object type in hovers and error messages. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n/** Widen `T` to also satisfy {@link UnknownObject}, useful for tool input/output narrowing. */\nexport type Objectify<T> = T & UnknownObject;\n\ntype RequiredKeys<T> = {\n  [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;\n}[keyof T];\n/** `true` if `T` has at least one required key, `false` if every key is optional. */\nexport type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;\n"]}

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "skybridge",
-  "version": "0.0.0-dev.f792261",
+  "version": "0.0.0-dev.f7943e6",
   "description": "Skybridge is a framework for building ChatGPT and MCP Apps",
   "repository": {
     "type": "git",
     "url": "https://github.com/alpic-ai/skybridge.git"
   },
   "type": "module",
+  "sideEffects": false,
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.23.1"
   },
   "files": [
     "dist",
@@ -26,9 +27,9 @@
       "types": "./dist/web/index.d.ts",
       "default": "./dist/web/index.js"
     },
-    "./vite": {
-      "types": "./dist/web/plugin/plugin.d.ts",
-      "default": "./dist/web/plugin/plugin.js"
+    "./views": {
+      "types": "./dist/views/index.d.ts",
+      "default": "./dist/views/index.js"
     }
   },
   "keywords": [
@@ -41,50 +42,51 @@
   "license": "ISC",
   "peerDependencies": {
     "@modelcontextprotocol/sdk": ">=1.27.0",
-    "@skybridge/devtools": ">=0.35.14 <1.0.0",
+    "@skybridge/devtools": "^1.1.0",
     "nodemon": ">=3.0.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
     "vite": ">=7.3.1"
   },
   "dependencies": {
-    "@babel/core": "^7.29.0",
-    "@modelcontextprotocol/ext-apps": "^1.3.2",
-    "@oclif/core": "^4.10.3",
+    "@modelcontextprotocol/ext-apps": "^1.7.4",
+    "@oclif/core": "^4.11.14",
     "ci-info": "^4.4.0",
     "cors": "^2.8.6",
     "cross-spawn": "^7.0.6",
     "dequal": "^2.0.3",
-    "es-toolkit": "^1.45.1",
+    "es-toolkit": "^1.49.0",
+    "esbuild": "^0.28.1",
     "express": "^5.2.1",
     "handlebars": "^4.7.9",
-    "ink": "^7.0.0",
+    "ink": "^7.1.1",
+    "jose": "^6.2.3",
     "open": "^11.0.0",
-    "posthog-node": "^5.28.9",
+    "posthog-node": "^5.45.2",
     "superjson": "^2.2.6",
-    "zustand": "^5.0.12"
+    "yaml": "^2.9.0",
+    "zustand": "^5.0.14"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@total-typescript/tsconfig": "^1.0.4",
-    "@types/babel__core": "^7.20.5",
     "@types/cors": "^2.8.19",
     "@types/cross-spawn": "^6.0.6",
     "@types/express": "^5.0.6",
-    "@types/jsdom": "^28.0.1",
-    "@types/node": "^24.12.0",
-    "@types/react": "^19.2.14",
+    "@types/jsdom": "^28.0.3",
+    "@types/node": "^24.13.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "@vitest/ui": "^4.1.4",
-    "jsdom": "^29.0.1",
+    "@vitest/ui": "^4.1.10",
+    "jsdom": "^29.1.1",
     "shx": "^0.4.0",
     "ts-node": "^10.9.2",
-    "typescript": "^6.0.2",
-    "vite": "^8.0.0",
-    "vitest": "^4.1.4",
-    "zod": "^4.3.6"
+    "typescript": "^6.0.3",
+    "vite": "^8.1.5",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3"
   },
   "bin": {
     "sb": "./bin/run.js",
@@ -95,6 +97,10 @@
     "commands": "./dist/commands",
     "dirname": "skybridge",
     "topicSeparator": " ",
+    "helpClass": {
+      "target": "./dist/commands/create",
+      "identifier": "SkybridgeHelp"
+    },
     "hooks": {
       "finally": "./dist/cli/telemetry"
     }

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

@@ -1,24 +0,0 @@
-import type { Adaptor, CallToolResponse, FileMetadata, HostContext, HostContextStore, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, SendFollowUpMessageOptions, SetViewStateAction, UploadFileOptions } from "../types.js";
-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;
-    }>;
-    sendFollowUpMessage: (prompt: string, options?: SendFollowUpMessageOptions) => Promise<void>;
-    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>;
-}

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

@@ -1,96 +0,0 @@
-import { AppsSdkBridge } from "./bridge.js";
-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) => {
-        return window.openai.callTool(name, args);
-    };
-    requestDisplayMode = (mode) => {
-        return window.openai.requestDisplayMode({ mode });
-    };
-    sendFollowUpMessage = (prompt, options) => {
-        return window.openai.sendFollowUpMessage({
-            prompt,
-            scrollToBottom: options?.scrollToBottom,
-        });
-    };
-    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 });
-    }
-}
-//# 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  FileMetadata,\n  HostContext,\n  HostContextStore,\n  OpenExternalOptions,\n  RequestDisplayMode,\n  RequestModalOptions,\n  SendFollowUpMessageOptions,\n  SetViewStateAction,\n  UploadFileOptions,\n} from \"../types.js\";\nimport { AppsSdkBridge } from \"./bridge.js\";\nimport type { AppsSdkWidgetState } from \"./types.js\";\n\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    return window.openai.callTool<ToolArgs, ToolResponse>(name, args);\n  };\n\n  public requestDisplayMode = (\n    mode: RequestDisplayMode,\n  ): Promise<{ mode: RequestDisplayMode }> => {\n    return window.openai.requestDisplayMode({ mode });\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 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"]}

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

@@ -1,48 +0,0 @@
-import type { Adaptor, CallToolResponse, HostContext, HostContextStore, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, SendFollowUpMessageOptions, SetViewStateAction } from "../types.js";
-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";
-    }>;
-    sendFollowUpMessage: (prompt: string, _options?: SendFollowUpMessageOptions) => Promise<void>;
-    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>;
-    private subscribeToViewUUID;
-    private restoreFromLocalStorage;
-    private persistToLocalStorage;
-    private createHostContextStore;
-}