skybridge 0.0.0-dev.d9ee984 → 0.0.0-dev.da00241

package/dist/web/hooks/use-viewport.test.js

@@ -0,0 +1,109 @@
+import { renderHook, waitFor } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { HostAdaptor } from "../bridges/adaptor.js";
+import { McpAppBridge } from "../bridges/mcp-app/bridge.js";
+import { getMcpAppHostPostMessageMock, MockResizeObserver, } from "./test/utils.js";
+import { useViewport } from "./use-viewport.js";
+describe("useViewport", () => {
+    describe("apps-sdk host type", () => {
+        beforeEach(() => {
+            HostAdaptor.resetInstance();
+            McpAppBridge.resetInstance();
+            vi.stubGlobal("skybridge", {});
+            vi.stubGlobal("openai", { view: { mode: "inline" } });
+            vi.stubGlobal("ResizeObserver", MockResizeObserver);
+        });
+        afterEach(() => {
+            vi.unstubAllGlobals();
+            vi.resetAllMocks();
+            McpAppBridge.resetInstance();
+            HostAdaptor.resetInstance();
+        });
+        it("should return maxHeight and safeArea from mcp host context", async () => {
+            vi.stubGlobal("parent", {
+                postMessage: getMcpAppHostPostMessageMock({
+                    containerDimensions: { maxHeight: 500, width: 400 },
+                    safeAreaInsets: { top: 0, bottom: 0, left: 0, right: 0 },
+                }),
+            });
+            const { result } = renderHook(() => useViewport());
+            await waitFor(() => {
+                expect(result.current.maxHeight).toBe(500);
+                expect(result.current.safeArea).toEqual({
+                    insets: { top: 0, bottom: 0, left: 0, right: 0 },
+                });
+            });
+        });
+        it("should return different maxHeight when set", async () => {
+            vi.stubGlobal("parent", {
+                postMessage: getMcpAppHostPostMessageMock({
+                    containerDimensions: { maxHeight: 800, width: 400 },
+                    safeAreaInsets: { top: 0, bottom: 0, left: 0, right: 0 },
+                }),
+            });
+            const { result } = renderHook(() => useViewport());
+            await waitFor(() => {
+                expect(result.current.maxHeight).toBe(800);
+            });
+        });
+        it("should return safeArea with insets when set", async () => {
+            vi.stubGlobal("parent", {
+                postMessage: getMcpAppHostPostMessageMock({
+                    containerDimensions: { maxHeight: 500, width: 400 },
+                    safeAreaInsets: { top: 44, bottom: 34, left: 0, right: 0 },
+                }),
+            });
+            const { result } = renderHook(() => useViewport());
+            await waitFor(() => {
+                expect(result.current.safeArea.insets.top).toBe(44);
+                expect(result.current.safeArea.insets.bottom).toBe(34);
+            });
+        });
+    });
+    describe("mcp-app host type", () => {
+        beforeEach(() => {
+            HostAdaptor.resetInstance();
+            McpAppBridge.resetInstance();
+            vi.stubGlobal("skybridge", {});
+            vi.stubGlobal("openai", undefined);
+            vi.stubGlobal("ResizeObserver", MockResizeObserver);
+        });
+        afterEach(async () => {
+            vi.unstubAllGlobals();
+            vi.resetAllMocks();
+            McpAppBridge.resetInstance();
+            HostAdaptor.resetInstance();
+        });
+        it("should return maxHeight and safeArea from mcp host context", async () => {
+            vi.stubGlobal("parent", {
+                postMessage: getMcpAppHostPostMessageMock({
+                    containerDimensions: { maxHeight: 800, width: 400 },
+                    safeAreaInsets: { top: 20, right: 0, bottom: 34, left: 0 },
+                }),
+            });
+            const { result } = renderHook(() => useViewport());
+            await waitFor(() => {
+                expect(result.current.maxHeight).toBe(800);
+                expect(result.current.safeArea).toEqual({
+                    insets: { top: 20, right: 0, bottom: 34, left: 0 },
+                });
+            });
+        });
+        it("should maintain safeArea referential stability when data has not changed", async () => {
+            vi.stubGlobal("parent", {
+                postMessage: getMcpAppHostPostMessageMock({
+                    containerDimensions: { maxHeight: 500, width: 400 },
+                    safeAreaInsets: { top: 44, right: 0, bottom: 34, left: 0 },
+                }),
+            });
+            const { result, rerender } = renderHook(() => useViewport());
+            await waitFor(() => {
+                expect(result.current.safeArea).toBeDefined();
+            });
+            const initialSafeArea = result.current.safeArea;
+            rerender();
+            expect(result.current.safeArea).toBe(initialSafeArea);
+        });
+    });
+});
+//# sourceMappingURL=use-viewport.test.js.map

package/dist/web/hooks/use-viewport.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-viewport.test.js","sourceRoot":"","sources":["../../../src/web/hooks/use-viewport.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { renderHook, waitFor } from \"@testing-library/react\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { HostAdaptor } from \"../bridges/adaptor.js\";\nimport { McpAppBridge } from \"../bridges/mcp-app/bridge.js\";\nimport {\n  getMcpAppHostPostMessageMock,\n  MockResizeObserver,\n} from \"./test/utils.js\";\nimport { useViewport } from \"./use-viewport.js\";\n\ndescribe(\"useViewport\", () => {\n  describe(\"apps-sdk host type\", () => {\n    beforeEach(() => {\n      HostAdaptor.resetInstance();\n      McpAppBridge.resetInstance();\n      vi.stubGlobal(\"skybridge\", {});\n      vi.stubGlobal(\"openai\", { view: { mode: \"inline\" } });\n      vi.stubGlobal(\"ResizeObserver\", MockResizeObserver);\n    });\n\n    afterEach(() => {\n      vi.unstubAllGlobals();\n      vi.resetAllMocks();\n      McpAppBridge.resetInstance();\n      HostAdaptor.resetInstance();\n    });\n\n    it(\"should return maxHeight and safeArea from mcp host context\", async () => {\n      vi.stubGlobal(\"parent\", {\n        postMessage: getMcpAppHostPostMessageMock({\n          containerDimensions: { maxHeight: 500, width: 400 },\n          safeAreaInsets: { top: 0, bottom: 0, left: 0, right: 0 },\n        }),\n      });\n      const { result } = renderHook(() => useViewport());\n\n      await waitFor(() => {\n        expect(result.current.maxHeight).toBe(500);\n        expect(result.current.safeArea).toEqual({\n          insets: { top: 0, bottom: 0, left: 0, right: 0 },\n        });\n      });\n    });\n\n    it(\"should return different maxHeight when set\", async () => {\n      vi.stubGlobal(\"parent\", {\n        postMessage: getMcpAppHostPostMessageMock({\n          containerDimensions: { maxHeight: 800, width: 400 },\n          safeAreaInsets: { top: 0, bottom: 0, left: 0, right: 0 },\n        }),\n      });\n      const { result } = renderHook(() => useViewport());\n\n      await waitFor(() => {\n        expect(result.current.maxHeight).toBe(800);\n      });\n    });\n\n    it(\"should return safeArea with insets when set\", async () => {\n      vi.stubGlobal(\"parent\", {\n        postMessage: getMcpAppHostPostMessageMock({\n          containerDimensions: { maxHeight: 500, width: 400 },\n          safeAreaInsets: { top: 44, bottom: 34, left: 0, right: 0 },\n        }),\n      });\n      const { result } = renderHook(() => useViewport());\n\n      await waitFor(() => {\n        expect(result.current.safeArea.insets.top).toBe(44);\n        expect(result.current.safeArea.insets.bottom).toBe(34);\n      });\n    });\n  });\n\n  describe(\"mcp-app host type\", () => {\n    beforeEach(() => {\n      HostAdaptor.resetInstance();\n      McpAppBridge.resetInstance();\n      vi.stubGlobal(\"skybridge\", {});\n      vi.stubGlobal(\"openai\", undefined);\n      vi.stubGlobal(\"ResizeObserver\", MockResizeObserver);\n    });\n\n    afterEach(async () => {\n      vi.unstubAllGlobals();\n      vi.resetAllMocks();\n      McpAppBridge.resetInstance();\n      HostAdaptor.resetInstance();\n    });\n\n    it(\"should return maxHeight and safeArea from mcp host context\", async () => {\n      vi.stubGlobal(\"parent\", {\n        postMessage: getMcpAppHostPostMessageMock({\n          containerDimensions: { maxHeight: 800, width: 400 },\n          safeAreaInsets: { top: 20, right: 0, bottom: 34, left: 0 },\n        }),\n      });\n      const { result } = renderHook(() => useViewport());\n\n      await waitFor(() => {\n        expect(result.current.maxHeight).toBe(800);\n        expect(result.current.safeArea).toEqual({\n          insets: { top: 20, right: 0, bottom: 34, left: 0 },\n        });\n      });\n    });\n\n    it(\"should maintain safeArea referential stability when data has not changed\", async () => {\n      vi.stubGlobal(\"parent\", {\n        postMessage: getMcpAppHostPostMessageMock({\n          containerDimensions: { maxHeight: 500, width: 400 },\n          safeAreaInsets: { top: 44, right: 0, bottom: 34, left: 0 },\n        }),\n      });\n      const { result, rerender } = renderHook(() => useViewport());\n\n      await waitFor(() => {\n        expect(result.current.safeArea).toBeDefined();\n      });\n\n      const initialSafeArea = result.current.safeArea;\n\n      rerender();\n\n      expect(result.current.safeArea).toBe(initialSafeArea);\n    });\n  });\n});\n"]}

package/dist/web/index.d.ts

@@ -1,4 +1,7 @@
-export { useOpenAiGlobal } from "./use-openai-global.js";
-export { useToolOutput } from "./use-tool-output.js";
+export * from "./bridges/index.js";
+export { createStore } from "./create-store.js";
+export * from "./data-llm.js";
+export { generateHelpers } from "./generate-helpers.js";
+export * from "./hooks/index.js";
+export { mountView } from "./mount-view.js";
 export * from "./types.js";
-export { mountWidget } from "./mount-widget.js";

package/dist/web/index.js

@@ -1,5 +1,8 @@
-export { useOpenAiGlobal } from "./use-openai-global.js";
-export { useToolOutput } from "./use-tool-output.js";
+export * from "./bridges/index.js";
+export { createStore } from "./create-store.js";
+export * from "./data-llm.js";
+export { generateHelpers } from "./generate-helpers.js";
+export * from "./hooks/index.js";
+export { mountView } from "./mount-view.js";
 export * from "./types.js";
-export { mountWidget } from "./mount-widget.js";
 //# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./bridges/index.js\";\nexport { createStore } from \"./create-store.js\";\nexport * from \"./data-llm.js\";\nexport { generateHelpers } from \"./generate-helpers.js\";\nexport * from \"./hooks/index.js\";\nexport { mountView } from \"./mount-view.js\";\nexport * from \"./types.js\";\n"]}

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

@@ -0,0 +1,21 @@
+/**
+ * Mount a view's root React component into `#root`. The Vite plugin
+ * auto-mounts every view, so apps normally never call this themselves —
+ * it is the entry point the generated view wrappers use.
+ *
+ * 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

@@ -0,0 +1,43 @@
+/// <reference types="vite/client" />
+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`. The Vite plugin
+ * auto-mounts every view, so apps normally never call this themselves —
+ * it is the entry point the generated view wrappers use.
+ *
+ * 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) {
+        throw new Error("Root element not found");
+    }
+    if (!rootInstance) {
+        rootInstance = createRoot(rootElement);
+    }
+    if (import.meta.env.DEV) {
+        installOpenAILoggingProxy();
+    }
+    (async () => {
+        const { ModalProvider } = await import("./components/modal-provider.js");
+        const app = createElement(ModalProvider, null, component);
+        rootInstance.render(createElement(StrictMode, null, app));
+    })();
+};
+//# sourceMappingURL=mount-view.js.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;GAmBG;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,CAAC,KAAK,IAAI,EAAE;QACV,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC1D,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`. The Vite plugin\n * auto-mounts every view, so apps normally never call this themselves —\n * it is the entry point the generated view wrappers use.\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  (async () => {\n    const { ModalProvider } = await import(\"./components/modal-provider.js\");\n    const app = createElement(ModalProvider, null, component);\n    rootInstance.render(createElement(StrictMode, null, app));\n  })();\n};\n"]}

package/dist/web/proxy.d.ts

@@ -0,0 +1 @@
+export declare function installOpenAILoggingProxy(): void;

package/dist/web/proxy.js

@@ -0,0 +1,52 @@
+const colors = {
+    brand: "#6366f1",
+    info: "#22223b",
+    success: "#22c55e",
+    error: "#ef4444",
+};
+export function installOpenAILoggingProxy() {
+    if (typeof window === "undefined" || !window.openai) {
+        return;
+    }
+    const descriptor = Object.getOwnPropertyDescriptor(window, "openai");
+    if (descriptor?.configurable === false || descriptor?.writable === false) {
+        console.warn("[openai-proxy] window.openai is not configurable or writable, skipping proxy installation");
+        return;
+    }
+    const originalOpenAI = window.openai;
+    const handler = {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            if (typeof value !== "function") {
+                return value;
+            }
+            return (...args) => {
+                const methodName = String(prop);
+                console.group(`%c[openai] %cmethod %c${methodName}`, `color: ${colors.brand}; font-weight: normal`, `color: ${colors.info}; font-weight: normal`, `color: ${colors.success}`);
+                console.log("%c← args:", `color: ${colors.info}`, args);
+                const result = value.apply(target, args);
+                if (result && typeof result.then === "function") {
+                    return result.then((resolved) => {
+                        console.log("%c→ resolved:", `color: ${colors.success}`, resolved);
+                        console.groupEnd();
+                        return resolved;
+                    }, (error) => {
+                        console.error("%c→ rejected:", `color: ${colors.error}`, error);
+                        console.groupEnd();
+                        throw error;
+                    });
+                }
+                console.log("%c→ returned:", `color: ${colors.success}`, result);
+                console.groupEnd();
+                return result;
+            };
+        },
+        set(target, prop, value, receiver) {
+            console.log(`%c[openai] %cupdate %c${String(prop)}`, `color: ${colors.brand}`, `color: ${colors.info}`, `color: ${colors.success}; font-weight: bold`, "←", value);
+            return Reflect.set(target, prop, value, receiver);
+        },
+    };
+    window.openai = new Proxy(originalOpenAI, handler);
+    console.log("%c[openai-proxy] %cInstalled logging proxy for window.openai", `color: ${colors.brand}`, `color: ${colors.info}`);
+}
+//# sourceMappingURL=proxy.js.map

package/dist/web/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/web/proxy.ts"],"names":[],"mappings":"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","sourcesContent":["const colors = {\n  brand: \"#6366f1\",\n  info: \"#22223b\",\n  success: \"#22c55e\",\n  error: \"#ef4444\",\n} as const;\n\nexport function installOpenAILoggingProxy() {\n  if (typeof window === \"undefined\" || !window.openai) {\n    return;\n  }\n\n  const descriptor = Object.getOwnPropertyDescriptor(window, \"openai\");\n  if (descriptor?.configurable === false || descriptor?.writable === false) {\n    console.warn(\n      \"[openai-proxy] window.openai is not configurable or writable, skipping proxy installation\",\n    );\n    return;\n  }\n\n  const originalOpenAI = window.openai;\n\n  const handler: ProxyHandler<typeof originalOpenAI> = {\n    get(target, prop, receiver) {\n      const value = Reflect.get(target, prop, receiver);\n\n      if (typeof value !== \"function\") {\n        return value;\n      }\n\n      return (...args: unknown[]) => {\n        const methodName = String(prop);\n\n        console.group(\n          `%c[openai] %cmethod %c${methodName}`,\n          `color: ${colors.brand}; font-weight: normal`,\n          `color: ${colors.info}; font-weight: normal`,\n          `color: ${colors.success}`,\n        );\n        console.log(\"%c← args:\", `color: ${colors.info}`, args);\n\n        const result = value.apply(target, args);\n\n        if (result && typeof result.then === \"function\") {\n          return result.then(\n            (resolved: unknown) => {\n              console.log(\n                \"%c→ resolved:\",\n                `color: ${colors.success}`,\n                resolved,\n              );\n              console.groupEnd();\n              return resolved;\n            },\n            (error: unknown) => {\n              console.error(\"%c→ rejected:\", `color: ${colors.error}`, error);\n              console.groupEnd();\n              throw error;\n            },\n          );\n        }\n\n        console.log(\"%c→ returned:\", `color: ${colors.success}`, result);\n        console.groupEnd();\n\n        return result;\n      };\n    },\n\n    set(target, prop, value, receiver) {\n      console.log(\n        `%c[openai] %cupdate %c${String(prop)}`,\n        `color: ${colors.brand}`,\n        `color: ${colors.info}`,\n        `color: ${colors.success}; font-weight: bold`,\n        \"←\",\n        value,\n      );\n\n      return Reflect.set(target, prop, value, receiver);\n    },\n  };\n\n  window.openai = new Proxy(originalOpenAI, handler);\n\n  console.log(\n    \"%c[openai-proxy] %cInstalled logging proxy for window.openai\",\n    `color: ${colors.brand}`,\n    `color: ${colors.info}`,\n  );\n}\n"]}

package/dist/web/types.d.ts

@@ -1,95 +1,20 @@
-type UnknownObject = Record<string, unknown>;
-export type WidgetState = UnknownObject;
-export type SetWidgetState = (state: WidgetState) => Promise<void>;
-export type SendFollowUpMessage = (args: {
-    prompt: string;
-}) => Promise<void>;
-export type RequestDisplayMode = (args: {
-    mode: DisplayMode;
-}) => Promise<{
-    mode: DisplayMode;
-}>;
-export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
-export declare class ToolResponseEvent extends CustomEvent<{
-    tool: {
-        name: string;
-        args: UnknownObject;
-    };
-}> {
-    readonly type = "openai:tool_response";
-}
-declare global {
-    interface Window {
-        openai: API<WidgetState> & OpenAiGlobals;
-    }
-    interface WindowEventMap {
-        [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
+import "react";
+declare module "react" {
+    interface HTMLAttributes<T> {
+        "data-llm"?: string;
     }
 }
-export type OpenAiGlobals<ToolInput extends UnknownObject = UnknownObject, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
-    theme: Theme;
-    userAgent: UserAgent;
-    locale: string;
-    maxHeight: number;
-    displayMode: DisplayMode;
-    safeArea: SafeArea;
-    toolInput: ToolInput;
-    toolOutput: ToolOutput | null;
-    toolResponseMetadata: ToolResponseMetadata | null;
-    widgetState: WidgetState | null;
-};
-export type CallToolResponse = {
-    result: string;
-};
-type API<WidgetState extends UnknownObject> = {
-    /** Calls a tool on your MCP. Returns the full response. */
-    callTool: (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
-    /** Triggers a followup turn in the ChatGPT conversation */
-    sendFollowUpMessage: (args: {
-        prompt: string;
-    }) => Promise<void>;
-    /** Opens an external link, redirects web page or mobile app */
-    openExternal(payload: {
-        href: string;
-    }): void;
-    /** For transitioning an app from inline to fullscreen or pip */
-    requestDisplayMode: (args: {
-        mode: DisplayMode;
-    }) => Promise<{
-        /**
-         * The granted display mode. The host may reject the request.
-         * For mobile, PiP is always coerced to fullscreen.
-         */
-        mode: DisplayMode;
-    }>;
-    setWidgetState: (state: WidgetState) => Promise<void>;
-};
-export declare const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
-export declare class SetGlobalsEvent extends CustomEvent<{
-    globals: Partial<OpenAiGlobals>;
-}> {
-    readonly type = "openai:set_globals";
-}
-export type CallTool = (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
-export type DisplayMode = "pip" | "inline" | "fullscreen";
-export type Theme = "light" | "dark";
-export type SafeAreaInsets = {
-    top: number;
-    bottom: number;
-    left: number;
-    right: number;
-};
-export type SafeArea = {
-    insets: SafeAreaInsets;
-};
-export type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
-export type UserAgent = {
-    device: {
-        type: DeviceType;
-    };
-    capabilities: {
-        hover: boolean;
-        touch: boolean;
-    };
-};
+/** 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

@@ -1,10 +1,2 @@
-export const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
-export class ToolResponseEvent extends CustomEvent {
-    type = TOOL_RESPONSE_EVENT_TYPE;
-}
-// Dispatched when any global changes in the host page
-export const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
-export class SetGlobalsEvent extends CustomEvent {
-    type = SET_GLOBALS_EVENT_TYPE;
-}
+import "react";
 //# sourceMappingURL=types.js.map

package/dist/web/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AA+DD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}
+{"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,12 +1,24 @@
 {
   "name": "skybridge",
-  "version": "0.0.0-dev.d9ee984",
-  "description": "Skybridge is a framework for building ChatGPT apps",
+  "version": "0.0.0-dev.da00241",
+  "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.23.1"
+  },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "tsconfig.base.json"
   ],
   "exports": {
+    "./tsconfig": "./tsconfig.base.json",
+    "./tsconfig.json": "./tsconfig.base.json",
     "./server": {
       "types": "./dist/server/index.d.ts",
       "default": "./dist/server/index.js"
@@ -14,11 +26,12 @@
     "./web": {
       "types": "./dist/web/index.d.ts",
       "default": "./dist/web/index.js"
+    },
+    "./views": {
+      "types": "./dist/views/index.d.ts",
+      "default": "./dist/views/index.js"
     }
   },
-  "scripts": {
-    "build": "tsc"
-  },
   "keywords": [
     "chatgpt",
     "app",
@@ -28,24 +41,80 @@
   "author": "Frédéric Barthelet",
   "license": "ISC",
   "peerDependencies": {
-    "react": ">=19.0.0",
-    "react-dom": ">=19.0.0"
+    "@skybridge/devtools": "^2.0.0",
+    "nodemon": ">=3.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "vite": ">=7.3.1",
+    "zod": "^4.2.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.20.0",
-    "zod": "^3.25.51",
-    "cors": "^2.8.5",
-    "express": "^5.1.0",
-    "vite": "^7.1.9"
+    "@modelcontextprotocol/core": "^2.0.0",
+    "@modelcontextprotocol/ext-apps": "^1.7.4",
+    "@modelcontextprotocol/express": "^2.0.0",
+    "@modelcontextprotocol/node": "^2.0.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@modelcontextprotocol/server": "^2.0.0",
+    "@oclif/core": "^4.11.14",
+    "ci-info": "^4.4.0",
+    "cors": "^2.8.6",
+    "cross-spawn": "^7.0.6",
+    "dequal": "^2.0.3",
+    "esbuild": "^0.28.1",
+    "express": "^5.2.1",
+    "handlebars": "^4.7.9",
+    "ink": "^7.1.1",
+    "jose": "^6.2.3",
+    "open": "^11.0.0",
+    "posthog-node": "^5.45.2",
+    "superjson": "^2.2.6",
+    "yaml": "^2.9.0",
+    "zustand": "^5.0.14"
   },
   "devDependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
     "@total-typescript/tsconfig": "^1.0.4",
     "@types/cors": "^2.8.19",
-    "@types/express": "^5.0.3",
-    "@types/node": "^22.15.30",
-    "@types/react-dom": "^19.2.2",
-    "@types/react": "^19.2.2",
-    "typescript": "^5.9.3"
-  },
-  "packageManager": "pnpm@10.17.1"
-}
+    "@types/cross-spawn": "^6.0.6",
+    "@types/express": "^5.0.6",
+    "@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.10",
+    "jsdom": "^29.1.1",
+    "shx": "^0.4.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^6.0.3",
+    "vite": "^8.1.5",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3"
+  },
+  "bin": {
+    "sb": "./bin/run.js",
+    "skybridge": "./bin/run.js"
+  },
+  "oclif": {
+    "bin": "skybridge",
+    "commands": "./dist/commands",
+    "dirname": "skybridge",
+    "topicSeparator": " ",
+    "helpClass": {
+      "target": "./dist/commands/create",
+      "identifier": "SkybridgeHelp"
+    },
+    "hooks": {
+      "finally": "./dist/cli/telemetry"
+    }
+  },
+  "scripts": {
+    "build": "shx rm -rf dist && pnpm run build:templates && tsc",
+    "build:templates": "node scripts/precompile-templates.mjs",
+    "format": "biome check --write --error-on-warnings",
+    "test": "pnpm run test:unit && pnpm run test:format",
+    "test:unit": "pnpm run build:templates && vitest run",
+    "test:format": "biome ci"
+  }
+}

package/tsconfig.base.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    // Module resolution options
+    "module": "NodeNext",
+    "esModuleInterop": true,
+    "verbatimModuleSyntax": true,
+
+    // Output options
+    "rootDir": "${configDir}/src",
+    "outDir": "${configDir}/dist",
+    "noEmit": false,
+    "incremental": true,
+    "sourceMap": true,
+
+    // Language and environment options
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+
+    // Type declarations
+    "types": ["node", "vite/client"],
+
+    // Strictness and checking options
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+
+    // Code quality & diagnostics
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  }
+}

package/dist/server/widgetsDevServer.d.ts

@@ -1,9 +0,0 @@
-import { type RequestHandler } from "express";
-/**
- * Install Vite dev server when env is not production
- * This router MUST be installed at the application root, like so:
- *
- *  const app = express();
- *  app.use(await widgetsRouter());
- */
-export declare const widgetsDevServer: () => Promise<RequestHandler>;