skybridge 0.0.0-dev.786f7eb → 0.0.0-dev.78d86f0

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "skybridge",
-  "version": "0.0.0-dev.786f7eb",
+  "version": "0.0.0-dev.78d86f0",
   "description": "Skybridge is a framework for building ChatGPT apps",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alpic-ai/skybridge.git"
+  },
   "type": "module",
   "files": [
     "dist"
@@ -23,10 +27,7 @@
     "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
     "test:unit": "vitest run",
     "test:type": "tsc --noEmit",
-    "test:format": "biome ci",
-    "docs:dev": "pnpm --filter @skybridge/docs start",
-    "docs:build": "pnpm --filter @skybridge/docs build",
-    "docs:serve": "pnpm --filter @skybridge/docs serve"
+    "test:format": "biome ci"
   },
   "keywords": [
     "chatgpt",
@@ -44,22 +45,23 @@
   "dependencies": {
     "@babel/core": "^7.28.5",
     "cors": "^2.8.5",
+    "dequal": "^2.0.3",
     "express": "^5.1.0",
     "handlebars": "^4.7.8",
     "superjson": "^2.2.6",
-    "vite": "^7.1.11",
+    "vite": "^7.3.0",
     "zustand": "^5.0.9"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.3.8",
+    "@modelcontextprotocol/ext-apps": "^0.2.2",
     "@modelcontextprotocol/sdk": "^1.24.3",
     "@testing-library/dom": "^10.4.1",
-    "@testing-library/react": "^16.3.0",
+    "@testing-library/react": "^16.3.1",
     "@total-typescript/tsconfig": "^1.0.4",
     "@types/babel__core": "^7.20.5",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.3",
-    "@types/jsdom": "^21.1.6",
+    "@types/jsdom": "^21.1.7",
     "@types/node": "^22.15.30",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Alpic
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,125 +0,0 @@
-<div align="center">
-
-<img alt="Skybridge" src="docs/static/img/github-banner.png" width="100%">
-
-<br />
-
-# Skybridge
-
-**Build ChatGPT Apps. The Modern TypeScript Way.**
-
-The fullstack TypeScript framework for ChatGPT Apps.<br />
-**Type-safe. React-powered. Zero config.**
-
-<br />
-
-[![NPM Version](https://img.shields.io/npm/v/skybridge?color=e90060&style=for-the-badge)](https://www.npmjs.com/package/skybridge)
-[![NPM Downloads](https://img.shields.io/npm/dm/skybridge?color=e90060&style=for-the-badge)](https://www.npmjs.com/package/skybridge)
-[![GitHub License](https://img.shields.io/github/license/alpic-ai/skybridge?color=e90060&style=for-the-badge)](https://github.com/alpic-ai/skybridge/blob/main/LICENSE)
-
-<br />
-
-[Documentation](https://skybridge.tech) · [Quick Start](https://github.com/new?template_name=apps-sdk-template&template_owner=alpic-ai) · [Examples](https://github.com/alpic-ai/apps-sdk-template)
-
-</div>
-
-<br />
-
-## ✨ Why Skybridge?
-
-ChatGPT Apps let you embed **rich, interactive UIs** directly in conversations. But the raw SDK is low-level—no hooks, no type safety, no dev tools, and no HMR.
-
-**Skybridge fixes that.**
-
-| | |
-|:--|:--|
-| 👨‍💻 **Full Dev Environment** — HMR, debug traces, and local devtools. No more refresh loops. | ✅ **End-to-End Type Safety** — tRPC-style inference from server to widget. Autocomplete everywhere. |
-| 🔄 **Widget-to-Model Sync** — Keep the model aware of UI state with `data-llm`. Dual surfaces, one source of truth. | ⚒️ **React Query-style Hooks** — `isPending`, `isError`, callbacks. State management you already know. |
-
-<br />
-
-## 🚀 Get Started
-
-**Create a new ChatGPT app:**
-
-```bash
-gh repo create my-app --template alpic-ai/apps-sdk-template --clone
-cd my-app && pnpm install
-```
-
-**Or add to an existing project:**
-
-```bash
-npm i skybridge
-yarn add skybridge
-pnpm add skybridge
-bun add skybridge
-deno add skybridge
-```
-
-<div align="center">
-
-**👉 [Read the Docs](https://skybridge.tech) 👈**
-
-</div>
-
-<br />
-
-## 📦 The Stack
-
-- **`skybridge/server`** — Drop-in MCP SDK replacement with widget registration and type inference.
-- **`skybridge/web`** — React hooks and components for ChatGPT's runtime.
-
-### Server
-
-```ts
-import { McpServer } from "skybridge/server";
-
-server.registerWidget("flights", {}, {
-  inputSchema: { destination: z.string() },
-}, async ({ destination }) => {
-  const flights = await searchFlights(destination);
-  return { structuredContent: { flights } };
-});
-```
-
-### Widget
-
-```tsx
-import { useToolInfo } from "skybridge/web";
-
-function FlightsWidget() {
-  const { output } = useToolInfo();
-
-  return output.structuredContent.flights.map(f =>
-    <FlightCard key={f.id} flight={f} />
-  );
-}
-```
-
-<br />
-
-## 🎯 Features at a Glance
-
-- **Live Reload** — Vite HMR. See changes instantly without reinstalling.
-- **Typed Hooks** — Full autocomplete for tools, inputs, outputs.
-- **Widget → Tool Calls** — Trigger server actions from UI.
-- **Dual Surface Sync** — Keep model aware of what users see with `data-llm`.
-- **React Query-style API** — `isPending`, `isError`, callbacks.
-- **MCP Compatible** — Extends the official SDK. Works with any MCP client.
-
-<br />
-
-<div align="center">
-
-[![GitHub Discussions](https://img.shields.io/badge/Discussions-Ask%20Questions-blue?style=flat-square&logo=github)](https://github.com/alpic-ai/skybridge/discussions)
-[![GitHub Issues](https://img.shields.io/badge/Issues-Report%20Bugs-red?style=flat-square&logo=github)](https://github.com/alpic-ai/skybridge/issues)
-[![Discord](https://img.shields.io/badge/Discord-Chat-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.com/invite/gNAazGueab)
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions
-
-<br />
-
-**[MIT License](LICENSE)** · Made with ❤️ by **[Alpic](https://alpic.ai)**
-
-</div>

package/dist/src/web/hooks/use-locale.d.ts

@@ -1 +0,0 @@
-export declare function useLocale(): string;

package/dist/src/web/hooks/use-locale.js

@@ -1,5 +0,0 @@
-import { useOpenAiGlobal } from "./use-openai-global.js";
-export function useLocale() {
-    return useOpenAiGlobal("locale");
-}
-//# sourceMappingURL=use-locale.js.map

package/dist/src/web/hooks/use-locale.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-locale.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,UAAU,SAAS;IACvB,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/dist/src/web/hooks/use-locale.test.js

@@ -1,21 +0,0 @@
-import { renderHook } from "@testing-library/react";
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import { useLocale } from "./use-locale.js";
-describe("useLocale", () => {
-    let OpenaiMock;
-    beforeEach(() => {
-        OpenaiMock = {
-            locale: "en-US",
-        };
-        vi.stubGlobal("openai", OpenaiMock);
-    });
-    afterEach(() => {
-        vi.unstubAllGlobals();
-        vi.resetAllMocks();
-    });
-    it("should return the current locale from window.openai.locale", () => {
-        const { result } = renderHook(() => useLocale());
-        expect(result.current).toBe("en-US");
-    });
-});
-//# sourceMappingURL=use-locale.test.js.map

package/dist/src/web/hooks/use-locale.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-locale.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-locale.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,IAAI,UAEH,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG;YACX,MAAM,EAAE,OAAO;SAChB,CAAC;QACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/web/hooks/use-theme.d.ts

@@ -1 +0,0 @@
-export declare function useTheme(): import("../types.js").Theme;

package/dist/src/web/hooks/use-theme.js

@@ -1,5 +0,0 @@
-import { useOpenAiGlobal } from "./use-openai-global.js";
-export function useTheme() {
-    return useOpenAiGlobal("theme");
-}
-//# sourceMappingURL=use-theme.js.map

package/dist/src/web/hooks/use-theme.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-theme.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,UAAU,QAAQ;IACtB,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/src/web/hooks/use-theme.test.js

@@ -1,26 +0,0 @@
-import { renderHook } from "@testing-library/react";
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import { useTheme } from "./use-theme.js";
-describe("useTheme", () => {
-    let OpenaiMock;
-    beforeEach(() => {
-        OpenaiMock = {
-            theme: "light",
-        };
-        vi.stubGlobal("openai", OpenaiMock);
-    });
-    afterEach(() => {
-        vi.unstubAllGlobals();
-        vi.resetAllMocks();
-    });
-    it("should return the current theme from window.openai.theme", () => {
-        const { result } = renderHook(() => useTheme());
-        expect(result.current).toBe("light");
-    });
-    it("should return dark theme when set to dark", () => {
-        OpenaiMock.theme = "dark";
-        const { result } = renderHook(() => useTheme());
-        expect(result.current).toBe("dark");
-    });
-});
-//# sourceMappingURL=use-theme.test.js.map

package/dist/src/web/hooks/use-theme.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-theme.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-theme.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,IAAI,UAEH,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG;YACX,KAAK,EAAE,OAAO;SACf,CAAC;QACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC;QAC1B,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/web/hooks/use-user-agent.d.ts

@@ -1 +0,0 @@
-export declare function useUserAgent(): import("../types.js").UserAgent;

package/dist/src/web/hooks/use-user-agent.js

@@ -1,5 +0,0 @@
-import { useOpenAiGlobal } from "./use-openai-global.js";
-export function useUserAgent() {
-    return useOpenAiGlobal("userAgent");
-}
-//# sourceMappingURL=use-user-agent.js.map

package/dist/src/web/hooks/use-user-agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-user-agent.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-user-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,UAAU,YAAY;IAC1B,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/web/hooks/use-user-agent.test.js

@@ -1,31 +0,0 @@
-import { renderHook } from "@testing-library/react";
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import { useUserAgent } from "./use-user-agent.js";
-describe("useUserAgent", () => {
-    let OpenaiMock;
-    beforeEach(() => {
-        OpenaiMock = {
-            userAgent: {
-                device: { type: "mobile" },
-                capabilities: { hover: false, touch: true },
-            },
-        };
-        vi.stubGlobal("openai", OpenaiMock);
-    });
-    afterEach(() => {
-        vi.unstubAllGlobals();
-        vi.resetAllMocks();
-    });
-    it("should return the current user agent from window.openai.userAgent", () => {
-        OpenaiMock.userAgent = {
-            device: { type: "mobile" },
-            capabilities: { hover: false, touch: true },
-        };
-        const { result } = renderHook(() => useUserAgent());
-        expect(result.current).toEqual({
-            device: { type: "mobile" },
-            capabilities: { hover: false, touch: true },
-        });
-    });
-});
-//# sourceMappingURL=use-user-agent.test.js.map

package/dist/src/web/hooks/use-user-agent.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-user-agent.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-user-agent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,UAEH,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG;YACX,SAAS,EAAE;gBACT,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;aAC5C;SACF,CAAC;QACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,UAAU,CAAC,SAAS,GAAG;YACrB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;SAC5C,CAAC;QACF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;QAEpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}