skybridge 0.0.0-dev.feb36b5 → 0.0.0-dev.febcf34

package/README.md

@@ -1,126 +1,153 @@
-<div align="center">
-
-# Skybridge
-
-**Skybridge is the TypeScript framework for building ChatGPT apps**
-
-[![By Alpic](https://img.shields.io/badge/Made%20by%20Alpic-f6ffed?logo=alpic)](https://alpic.ai)
-
-![NPM Downloads](https://img.shields.io/npm/dm/skybridge?color=e90060)
-![NPM Version](https://img.shields.io/npm/v/skybridge?color=e90060)
-![GitHub License](https://img.shields.io/github/license/alpic-ai/skybridge?color=e90060)
-
-</div>
-
-Skybridge comes with 2 packages:
-
-- `skybridge/server`: A drop-in replacement of the `@modelcontextprotocol/sdk` official `McpServer` class with extra features for widget development.
-- `skybridge/web`: A react library with hooks and components to build widgets on the underlying _OpenAI iFrame skybridge_ runtime.
-
-## Quick start
-
-To get started in less than a minute, you can [create a new repository](https://github.com/new?template_name=apps-sdk-template&template_owner=alpic-ai) using our [ChatGPT SDK template](https://github.com/alpic-ai/apps-sdk-template). This template includes a basic setup for both the server and the widgets.
-
-## Installation
-
+# Skybridge - the MCP Apps framework
+
+<p align="center">
+  <a href="https://docs.skybridge.tech">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/skybridge-readme-banner-dark.png" />
+      <img alt="Skybridge, the full-stack React framework for MCP apps and MCP servers" src="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/skybridge-readme-banner-light.png" width="100%" />
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <strong>The full-stack React framework for MCP Apps and MCP Servers.</strong>
+</p>
+
+<p align="center">
+  <a href="https://docs.skybridge.tech">Documentation</a> ·
+  <a href="https://docs.skybridge.tech/quickstart/create-new-app">Quickstart</a> ·
+  <a href="https://github.com/alpic-ai/skybridge/tree/main/examples">Examples</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/skybridge"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/v/skybridge?color=77F5EE&amp;labelColor=161B22&amp;style=for-the-badge"><img alt="npm version" src="https://img.shields.io/npm/v/skybridge?color=E3FAF7&amp;labelColor=F6F8FA&amp;style=for-the-badge"></picture></a>
+  <a href="https://www.npmjs.com/package/skybridge"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/dm/skybridge?color=D7FFC8&amp;labelColor=161B22&amp;style=for-the-badge"><img alt="npm downloads" src="https://img.shields.io/npm/dm/skybridge?color=E8FBD9&amp;labelColor=F6F8FA&amp;style=for-the-badge"></picture></a>
+  <a href="https://discord.com/invite/gNAazGueab"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/badge/Discord-community-77F5EE?style=for-the-badge&amp;logo=discord&amp;logoColor=77F5EE&amp;labelColor=161B22"><img alt="Discord community" src="https://img.shields.io/badge/Discord-community-E3FAF7?style=for-the-badge&amp;logo=discord&amp;logoColor=5865F2&amp;labelColor=F6F8FA"></picture></a>
+  <a href="https://github.com/alpic-ai/skybridge/blob/main/LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/license/alpic-ai/skybridge?color=D7FFC8&amp;labelColor=161B22&amp;style=for-the-badge"><img alt="License: MIT" src="https://img.shields.io/github/license/alpic-ai/skybridge?color=E8FBD9&amp;labelColor=F6F8FA&amp;style=for-the-badge"></picture></a>
+</p>
+
+## About Skybridge
+
+Skybridge helps developers build type-safe MCP apps for Claude, ChatGPT and other UI-enabled MCP clients, with a complete set of tooling designed for both humans and agents.
+
+Why? MCP apps extend the [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro) with **rich, interactive UI views** rendered from MCP servers. Conversational apps need seamless interaction between the user, the UI, and the model. This means new UX patterns, developer tooling, and abstractions. 
+Plus, the raw SDKs are low-level: no hooks, type safety, HMR, etc.
+
+That's why we built *Skybridge*.
+
+Features include:
+
+- **Delightful dev environment**: Skybridge provides a dev server with a local emulator, hot module reload, and a permanent tunnel to connect your local app to Claude and ChatGPT.
+- **Write once, run everywhere**: the framework abstracts implementation differences between MCP clients, so your app runs seamlessly in Claude, ChatGPT, VSCode, and any other MCP apps compatible client.
+- **Agent-ready**: powerful skills, CLI, and programmatic dev tool APIs, everything your coding agent needs to build MCP apps end-to-end.
+- **Type-safe end-to-end**: tRPC-style inference from MCP server tool definition to React view for type safety from server to frontend.
+- **React-first**: Intuitive React Query-style hooks, with advanced state management. 
+- **Example library**: get started quickly with ChatGPT- and Claude-ready app examples for ecommerce, travel, SaaS, and more.
+
+They chose to build their MCP apps with Skybridge: 
+
+<p align="center">
+  <a href="https://www.datadoghq.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/datadog-dark.svg"><img src="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/datadog-light.svg" alt="Datadog" height="24"></picture></a>
+  &nbsp;&nbsp;
+  <a href="https://bitmovin.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/bitmovin-dark.svg"><img src="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/bitmovin-light.svg" alt="Bitmovin" height="22"></picture></a>
+  &nbsp;&nbsp;
+  <a href="https://www.evaneos.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/evaneos-dark.svg"><img src="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/evaneos-light.svg" alt="Evaneos" height="18"></picture></a>
+  &nbsp;&nbsp;
+  <a href="https://www.touchstream.media"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/touchstream-dark.svg"><img src="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/touchstream-light.svg" alt="Touchstream" height="24"></picture></a>
+  &nbsp;&nbsp;
+  <a href="https://www.cottages.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/cottages-dark.svg"><img src="https://raw.githubusercontent.com/alpic-ai/skybridge/main/docs/images/user-logos/cottages-light.svg" alt="Cottages.com" height="24"></picture></a>
+</p>
+
+## Get started
+
+**For agents**
+
+Install our [skill](https://docs.skybridge.tech/devtools/skills) for building MCP apps and ChatGPT apps:
 ```bash
-pnpm add skybridge
+npx skills add alpic-ai/skybridge -s skybridge
 ```
+Once installed, ask your agent "What skills do you have?" to confirm, then try:
 
-## Concepts
-
-### Widgets
-
-> A widget is a UI component that turns structured tool results into a human-friendly UI. Those are built using React components. They are rendered inside an iframe inline with the conversation on ChatGPT.
+- _Create a new MCP app_
+- _Migrate my MCP server to the Skybridge framework_
+- _Add a new view to my MCP app_ 
 
-Each widget in your app must have a unique name. The name is used to bridge the tool invocation result with the widget React component.
+**For humans**
 
-For example, in order to register a new widget named `pokemon` on your ChatGPT app. You should have the following file structure and file contents:
-
-_Project structure_
-
-```
-server/
-└── src/
-    └── index.ts // Register the widget with McpServer.widget()
-web/
-└── src/
-    └── widgets/
-        └── pokemon.tsx // Use the same widget name as the file name
+Bootstrap a new project with:
+```bash
+npm create skybridge@latest my-app
 ```
+For full install instructions, read our [**Quickstart guide**](https://docs.skybridge.tech/quickstart/create-new-app).
 
-_server/src/index.ts_
-
-```ts
-import { McpServer } from "skybridge/server";
-
-const server = new McpServer();
+## Documentation
 
-server.widget(
-  "pokemon"
-  // Remaining arguments...
-);
-```
-
-_web/src/widgets/pokemon.tsx_
+The [Skybridge documentation](https://docs.skybridge.tech) covers the full lifecycle of building MCP Apps:
 
-```ts
-import { mountWidget } from "skybridge/web";
+- [Fundamentals](https://docs.skybridge.tech/fundamentals): understand MCP Apps, ChatGPT Apps, and how Skybridge bridges both runtimes.
+- [Core concepts](https://docs.skybridge.tech/concepts): learn about server <> model <> UI data flows, LLM context sync, type safety, and instant local iteration with our devtools.
+- [Guides](https://docs.skybridge.tech/guides/fetching-data): build real app behavior with tools, views, state, and model communication.
+- [API Reference](https://docs.skybridge.tech/api-reference): browse our MCP server APIs, React hooks, CLI commands, and runtime compatibility.
 
-const Pokemon: React.FunctionComponent = () => {
-  // Your React component code goes here...
-};
+## Deploy
 
-mountWidget(<Pokemon />);
-```
+Deploy Skybridge apps instantly on [Alpic](https://alpic.ai) for scalable hosting, MCP-specific analytics, permanent tunneling, app store compliance auditing and submission help. You can also self-host on any Node.js-compatible platform.
 
-## Packages
+See our [deployment guide](https://docs.skybridge.tech/quickstart/deploy) for the full production path.
 
-### skybridge/server
+## Community & Contributing
 
-The `skybridge/server` package is a drop-in replacement of the `@modelcontextprotocol/sdk` official `McpServer` class with extra features for widget development. If you're already using the `@modelcontextprotocol/sdk`, you can simply replace your `McpServer` import with `skybridge/server` and you're good to go.
+We'd love your help improving Skybridge. Here are a few ways to get involved:
 
-### skybridge/web
+- **Bugs**: If you run into a bug or unexpected behavior, open a [GitHub Issue](https://github.com/alpic-ai/skybridge/issues) with a clear reproduction.
+- **Questions and ideas**: Need help building with Skybridge or have ideas to improve the framework, docs, examples, or developer experience? [Open an issue](https://github.com/alpic-ai/skybridge/issues) or share them on our [Discord](https://discord.com/invite/gNAazGueab).
+- **Pull requests**: For code or documentation changes, read the [Contributing Guide](https://github.com/alpic-ai/skybridge/blob/main/CONTRIBUTING.md) before opening a PR.
 
-The `skybridge/web` package is a react library with hooks and components to build widgets on the underlying _OpenAI iFrame skybridge_ runtime.
+Skybridge is released under the [MIT License](https://github.com/alpic-ai/skybridge/blob/main/LICENSE).
 
-**Vite plugin**
+### Contributors
 
-The `skybridge/web` package comes with a Vite plugin that allows you to build your widgets as regular Vite apps.
+Built and maintained with ❤️ by [Harijoe](https://github.com/harijoe), [Fred Barthelet](https://github.com/fredericbarthelet), and the [Alpic](https://alpic.ai) team.
 
-```ts
-import { defineConfig } from "vite";
-import { skybridge } from "skybridge/web";
+<a href="https://github.com/alpic-ai/skybridge/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=alpic-ai/skybridge" alt="Skybridge contributors">
+</a>
 
-export default defineConfig({
-  plugins: [skybridge()],
-});
-```
+## Example templates
 
-**Hooks**
+Explore all our example templates in the [Examples](https://docs.skybridge.tech/examples) section of the documentation.
 
-The `skybridge/web` package comes with a set of hooks to help you build your widgets.
+### Basic
 
-```ts
-import { useToolOutput } from "skybridge/web";
+| Preview | App | Description | Demo | Code |
+| --- | --- | --- | --- | --- |
+| <img src="docs/images/showcase-example.png" alt="Everything" width="160" /> | Everything | Comprehensive playground app showcasing all Skybridge hooks and features. | [Try Demo](https://everything.skybridge.tech/try) | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/everything) |
 
-// Initial data returned by the tool invocation on structuredOutput
-const toolOutput = useToolOutput();
-```
+### Use cases
 
-## Migrate your existing MCP server to a ChatGPT app
+| Preview | App | Description | Demo | Code |
+| --- | --- | --- | --- | --- |
+| <img src="docs/images/showcase-capitals.png" alt="Capitals Explorer" width="160" /> | Capitals Explorer | Interactive world map with geolocation, country information, and dynamic capital exploration. | [Try Demo](https://capitals.skybridge.tech/try) | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/capitals) |
+| <img src="docs/images/showcase-flight-booking.png" alt="Flight Booking" width="160" /> | Flight Booking | Flight search carousel with route details, pricing comparison, and external booking. | [Try Demo](https://flight-booking.skybridge.tech/try) | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/flight-booking) |
+| <img src="docs/images/showcase-ecommerce.png" alt="Ecommerce Carousel" width="160" /> | Ecommerce Carousel | Product carousel with persistent cart, localization, theme switching, and modal dialogs. | [Try Demo](https://ecommerce.skybridge.tech/try) | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/ecom-carousel) |
+| <img src="docs/images/showcase-investigation-game.png" alt="Investigation Game" width="160" /> | Investigation Game | Multi-screen mystery game with fullscreen mode, dynamic story progression and context asynchronicity demonstration | [Try Demo](https://investigation-game.skybridge.tech/try) | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/investigation-game) |
+| <img src="docs/images/showcase-productivity.png" alt="Productivity" width="160" /> | Productivity | Interactive analytics dashboard with charts, theme adaptation, localization, fullscreen mode, and bidirectional tool calls. | [Try Demo](https://productivity.skybridge.tech/try) | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/productivity) |
+| <img src="docs/images/showcase-times-up.png" alt="Time's Up" width="160" /> | Time's Up | Word-guessing party game where the user gives hints and the AI tries to guess. | [Try Demo](https://times-up.skybridge.tech/try) | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/times-up) |
+| <img src="docs/images/showcase-lumo.png" alt="Lumo Interactive AI Tutor" width="160" /> | Lumo — Interactive AI Tutor | Adaptive tutor with Mermaid diagrams, mind maps, quizzes, and fill-in-the-blank exercises. | [Try Demo](https://lumo-mcp-app-39519fdd.alpic.live/try) | [View code](https://github.com/connorads/lumo-mcp-app) |
 
-If you're already using the `@modelcontextprotocol/sdk` to build a MCP server, you can migrate to a ChatGPT app by following these steps:
+### Auth
 
-1. Replace your `McpServer` import from `@modelcontextprotocol/sdk` with the same import from `skybridge/server`
-2. Create a new vite project in a folder named `web` and install the `skybridge` package
-3. Replace the `vite.config.ts` file with the following:
+| Preview | Provider | Description | Code |
+| --- | --- | --- | --- |
+| <img src="docs/images/descope.webp" alt="Auth Descope" width="160" /> | Descope | Full OAuth authentication with Descope and personalized coffee shop search. | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/auth-descope) |
+| <img src="docs/images/showcase-clerk.png" alt="Auth Clerk" width="160" /> | Clerk | Full OAuth authentication with Clerk and personalized coffee shop search. | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/auth-clerk) |
+| <img src="docs/images/showcase-workos.png" alt="Auth WorkOS AuthKit" width="160" /> | WorkOS AuthKit | Full OAuth authentication with WorkOS AuthKit and personalized coffee shop search. | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/auth-workos) |
+| <img src="docs/images/showcase-stytch.png" alt="Auth Stytch" width="160" /> | Stytch | Full OAuth authentication with Stytch and personalized coffee shop search. | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/auth-stytch) |
+| <img src="docs/images/showcase-auth0.png" alt="Auth Auth0" width="160" /> | Auth0 | Full OAuth authentication with Auth0 and personalized coffee shop search. | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/auth-auth0) |
 
-```ts
-import { defineConfig } from "vite";
-import { skybridge } from "skybridge/web";
+### UI and component libraries
 
-export default defineConfig({
-  plugins: [skybridge()],
-});
-```
+| Preview | App | Description | Demo | Code |
+| --- | --- | --- | --- | --- |
+| <img src="docs/images/showcase-manifest-ui.png" alt="Manifest UI" width="160" /> | Manifest UI | Agentic component library example for rich AI-powered experiences. | [Try Demo](https://manifest-ui.skybridge.tech/try) | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/manifest-ui) |
+| <img src="docs/images/showcase-generative-ui.png" alt="Generative UI" width="160" /> | Generative UI | LLM-generated dynamic UIs with json-render and 36 pre-built shadcn/ui components. | [Try Demo](https://generative-ui.skybridge.tech/try) | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/generative-ui) |

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { execute } from "@oclif/core";
+
+await execute({ dir: import.meta.url });

package/dist/cli/build-helpers.d.ts

@@ -0,0 +1,10 @@
+export declare const ENTRY_WRAPPER_CONTENT = "import { __setBuildManifest } from \"skybridge/server\";\nimport manifest from \"./vite-manifest.js\";\n\n__setBuildManifest(manifest);\n\nconst userMod = await import(\"./server.js\");\nexport default userMod.default;\n";
+export declare function emitEntryWrapper(distDir: string): void;
+export declare function emitManifestModule(manifestPath: string, outPath: string): void;
+/** Emit an empty Vite manifest for view-less (headless) servers. */
+export declare function emitEmptyManifestModule(outPath: string): void;
+export declare function ensureAssetsDir(assetsDir: string): void;
+export declare const VERCEL_FUNCTION_NAME = "mcp";
+export declare const VERCEL_CONFIG: unknown;
+export declare const VERCEL_VC_CONFIG: unknown;
+export declare function emitVercelBuildOutput(root: string): Promise<void>;

package/dist/cli/build-helpers.js

@@ -0,0 +1,93 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import path from "node:path";
+// Primes the manifest in skybridge's module scope, then dynamically imports
+// `./server.js` so user code runs *after* the side channel is set. The
+// dynamic import is load-bearing: a static `export { default } from ...` is
+// hoisted with the rest of the static graph and would evaluate `server.js`
+// before `__setBuildManifest` runs.
+export const ENTRY_WRAPPER_CONTENT = `import { __setBuildManifest } from "skybridge/server";
+import manifest from "./vite-manifest.js";
+
+__setBuildManifest(manifest);
+
+const userMod = await import("./server.js");
+export default userMod.default;
+`;
+export function emitEntryWrapper(distDir) {
+    writeFileSync(path.join(distDir, "__entry.js"), ENTRY_WRAPPER_CONTENT);
+}
+export function emitManifestModule(manifestPath, outPath) {
+    const manifest = readFileSync(manifestPath, "utf-8");
+    writeFileSync(outPath, `export default ${manifest};\n`);
+}
+/** Emit an empty Vite manifest for view-less (headless) servers. */
+export function emitEmptyManifestModule(outPath) {
+    writeFileSync(outPath, "export default {};\n");
+}
+export function ensureAssetsDir(assetsDir) {
+    mkdirSync(assetsDir, { recursive: true });
+}
+export const VERCEL_FUNCTION_NAME = "mcp";
+export const VERCEL_CONFIG = {
+    version: 3,
+    routes: [
+        {
+            src: "/assets/(.*)",
+            headers: { "Access-Control-Allow-Origin": "*" },
+            continue: true,
+        },
+        { handle: "filesystem" },
+        { src: "/(.*)", dest: `/${VERCEL_FUNCTION_NAME}` },
+    ],
+};
+export const VERCEL_VC_CONFIG = {
+    runtime: "nodejs22.x",
+    handler: "index.js",
+    launcherType: "Nodejs",
+    shouldAddHelpers: true,
+};
+// Emit a Build Output API tree under `.vercel/output/`. Bundling the server
+// with esbuild produces a self-contained function bundle, so we don't ship
+// `node_modules` and don't touch tracked paths like `api/` or `public/`.
+//
+// Entry is `dist/__entry.js` — the wrapper that primes the Vite manifest via
+// `__setBuildManifest` before importing user code. Bundling `dist/server.js`
+// directly would skip that priming and 500 on view resource reads when the
+// function falls back to `readFileSync('dist/assets/.vite/manifest.json')`
+// (Vercel functions don't ship `dist/`).
+export async function emitVercelBuildOutput(root) {
+    const outputDir = path.join(root, ".vercel", "output");
+    const funcDir = path.join(outputDir, "functions", `${VERCEL_FUNCTION_NAME}.func`);
+    const staticAssetsDir = path.join(outputDir, "static", "assets");
+    rmSync(outputDir, { recursive: true, force: true });
+    mkdirSync(funcDir, { recursive: true });
+    const { build } = await import("esbuild");
+    await build({
+        entryPoints: [path.join(root, "dist", "__entry.js")],
+        bundle: true,
+        platform: "node",
+        target: "node22",
+        format: "esm",
+        outfile: path.join(funcDir, "index.js"),
+        // Lets esbuild DCE dev-only branches that pull in vite/devtools.
+        define: { "process.env.NODE_ENV": '"production"' },
+        // Dev-only deps reachable from re-exports; safe to leave unresolved since
+        // the code paths that touch them are eliminated by the NODE_ENV define.
+        external: ["vite", "@skybridge/devtools"],
+        banner: {
+            // ESM bundles miss CJS interop globals that some deps reach for.
+            js: "import{createRequire}from'node:module';const require=createRequire(import.meta.url);",
+        },
+    });
+    writeFileSync(path.join(funcDir, ".vc-config.json"), `${JSON.stringify(VERCEL_VC_CONFIG, null, 2)}\n`);
+    writeFileSync(path.join(funcDir, "package.json"), `${JSON.stringify({ type: "module" }, null, 2)}\n`);
+    const assetsSrc = path.join(root, "dist", "assets");
+    if (existsSync(assetsSrc)) {
+        cpSync(assetsSrc, staticAssetsDir, { recursive: true });
+    }
+    else {
+        mkdirSync(staticAssetsDir, { recursive: true });
+    }
+    writeFileSync(path.join(outputDir, "config.json"), `${JSON.stringify(VERCEL_CONFIG, null, 2)}\n`);
+}
+//# sourceMappingURL=build-helpers.js.map

package/dist/cli/build-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-helpers.js","sourceRoot":"","sources":["../../src/cli/build-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from \"node:fs\";\nimport path from \"node:path\";\n\n// Primes the manifest in skybridge's module scope, then dynamically imports\n// `./server.js` so user code runs *after* the side channel is set. The\n// dynamic import is load-bearing: a static `export { default } from ...` is\n// hoisted with the rest of the static graph and would evaluate `server.js`\n// before `__setBuildManifest` runs.\nexport const ENTRY_WRAPPER_CONTENT = `import { __setBuildManifest } from \"skybridge/server\";\nimport manifest from \"./vite-manifest.js\";\n\n__setBuildManifest(manifest);\n\nconst userMod = await import(\"./server.js\");\nexport default userMod.default;\n`;\n\nexport function emitEntryWrapper(distDir: string): void {\n  writeFileSync(path.join(distDir, \"__entry.js\"), ENTRY_WRAPPER_CONTENT);\n}\n\nexport function emitManifestModule(\n  manifestPath: string,\n  outPath: string,\n): void {\n  const manifest = readFileSync(manifestPath, \"utf-8\");\n  writeFileSync(outPath, `export default ${manifest};\\n`);\n}\n\n/** Emit an empty Vite manifest for view-less (headless) servers. */\nexport function emitEmptyManifestModule(outPath: string): void {\n  writeFileSync(outPath, \"export default {};\\n\");\n}\n\nexport function ensureAssetsDir(assetsDir: string): void {\n  mkdirSync(assetsDir, { recursive: true });\n}\n\nexport const VERCEL_FUNCTION_NAME = \"mcp\";\n\nexport const VERCEL_CONFIG: unknown = {\n  version: 3,\n  routes: [\n    {\n      src: \"/assets/(.*)\",\n      headers: { \"Access-Control-Allow-Origin\": \"*\" },\n      continue: true,\n    },\n    { handle: \"filesystem\" },\n    { src: \"/(.*)\", dest: `/${VERCEL_FUNCTION_NAME}` },\n  ],\n};\n\nexport const VERCEL_VC_CONFIG: unknown = {\n  runtime: \"nodejs22.x\",\n  handler: \"index.js\",\n  launcherType: \"Nodejs\",\n  shouldAddHelpers: true,\n};\n\n// Emit a Build Output API tree under `.vercel/output/`. Bundling the server\n// with esbuild produces a self-contained function bundle, so we don't ship\n// `node_modules` and don't touch tracked paths like `api/` or `public/`.\n//\n// Entry is `dist/__entry.js` — the wrapper that primes the Vite manifest via\n// `__setBuildManifest` before importing user code. Bundling `dist/server.js`\n// directly would skip that priming and 500 on view resource reads when the\n// function falls back to `readFileSync('dist/assets/.vite/manifest.json')`\n// (Vercel functions don't ship `dist/`).\nexport async function emitVercelBuildOutput(root: string): Promise<void> {\n  const outputDir = path.join(root, \".vercel\", \"output\");\n  const funcDir = path.join(\n    outputDir,\n    \"functions\",\n    `${VERCEL_FUNCTION_NAME}.func`,\n  );\n  const staticAssetsDir = path.join(outputDir, \"static\", \"assets\");\n\n  rmSync(outputDir, { recursive: true, force: true });\n  mkdirSync(funcDir, { recursive: true });\n\n  const { build } = await import(\"esbuild\");\n  await build({\n    entryPoints: [path.join(root, \"dist\", \"__entry.js\")],\n    bundle: true,\n    platform: \"node\",\n    target: \"node22\",\n    format: \"esm\",\n    outfile: path.join(funcDir, \"index.js\"),\n    // Lets esbuild DCE dev-only branches that pull in vite/devtools.\n    define: { \"process.env.NODE_ENV\": '\"production\"' },\n    // Dev-only deps reachable from re-exports; safe to leave unresolved since\n    // the code paths that touch them are eliminated by the NODE_ENV define.\n    external: [\"vite\", \"@skybridge/devtools\"],\n    banner: {\n      // ESM bundles miss CJS interop globals that some deps reach for.\n      js: \"import{createRequire}from'node:module';const require=createRequire(import.meta.url);\",\n    },\n  });\n\n  writeFileSync(\n    path.join(funcDir, \".vc-config.json\"),\n    `${JSON.stringify(VERCEL_VC_CONFIG, null, 2)}\\n`,\n  );\n  writeFileSync(\n    path.join(funcDir, \"package.json\"),\n    `${JSON.stringify({ type: \"module\" }, null, 2)}\\n`,\n  );\n\n  const assetsSrc = path.join(root, \"dist\", \"assets\");\n  if (existsSync(assetsSrc)) {\n    cpSync(assetsSrc, staticAssetsDir, { recursive: true });\n  } else {\n    mkdirSync(staticAssetsDir, { recursive: true });\n  }\n\n  writeFileSync(\n    path.join(outputDir, \"config.json\"),\n    `${JSON.stringify(VERCEL_CONFIG, null, 2)}\\n`,\n  );\n}\n"]}

package/dist/cli/build-helpers.test.js

@@ -0,0 +1,89 @@
+// @vitest-environment node
+// esbuild's invariant check on TextEncoder/Uint8Array trips jsdom's polyfill.
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { ENTRY_WRAPPER_CONTENT, emitEmptyManifestModule, emitEntryWrapper, emitManifestModule, emitVercelBuildOutput, ensureAssetsDir, VERCEL_CONFIG, VERCEL_VC_CONFIG, } from "./build-helpers.js";
+function mkTmp(prefix = "skybridge-build-helpers-") {
+    return mkdtempSync(path.join(tmpdir(), prefix));
+}
+describe("emitEntryWrapper", () => {
+    it("writes dist/__entry.js that primes the manifest before importing user code", () => {
+        const dir = mkTmp();
+        emitEntryWrapper(dir);
+        const out = readFileSync(path.join(dir, "__entry.js"), "utf-8");
+        expect(out).toBe(ENTRY_WRAPPER_CONTENT);
+        expect(out).toContain('import { __setBuildManifest } from "skybridge/server"');
+        expect(out).toContain('import manifest from "./vite-manifest.js"');
+        expect(out).toContain("__setBuildManifest(manifest)");
+        // Dynamic import is load-bearing: `server.js` must evaluate after the
+        // setter runs, so a static re-export wouldn't work.
+        expect(out).toContain('await import("./server.js")');
+        expect(out).toContain("export default userMod.default");
+    });
+});
+describe("emitManifestModule", () => {
+    it("inlines the JSON manifest as an ESM default export", () => {
+        const dir = mkTmp();
+        const inPath = path.join(dir, "manifest.json");
+        const outPath = path.join(dir, "vite-manifest.js");
+        const manifest = { "src/views/foo.tsx": { file: "assets/foo-abc.js" } };
+        writeFileSync(inPath, JSON.stringify(manifest));
+        emitManifestModule(inPath, outPath);
+        const out = readFileSync(outPath, "utf-8");
+        expect(out.startsWith("export default ")).toBe(true);
+        const literal = out
+            .slice("export default ".length)
+            .trim()
+            .replace(/;$/, "");
+        expect(JSON.parse(literal)).toEqual(manifest);
+    });
+});
+describe("emitEmptyManifestModule", () => {
+    it("writes an empty object default export", () => {
+        const dir = mkTmp();
+        const outPath = path.join(dir, "vite-manifest.js");
+        emitEmptyManifestModule(outPath);
+        expect(readFileSync(outPath, "utf-8")).toBe("export default {};\n");
+    });
+});
+describe("ensureAssetsDir", () => {
+    it("creates the assets directory when missing", () => {
+        const dir = mkTmp();
+        const assetsDir = path.join(dir, "dist", "assets");
+        ensureAssetsDir(assetsDir);
+        expect(existsSync(assetsDir)).toBe(true);
+    });
+});
+describe("emitVercelBuildOutput", () => {
+    it("emits a Build Output API tree with bundled function and static assets", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "dist", "assets"), { recursive: true });
+        writeFileSync(path.join(root, "dist", "server.js"), "export default function handler(_req, res) { res.end('ok'); }\n");
+        // Minimal `dist/__entry.js` (the real wrapper imports `skybridge/server`,
+        // which isn't resolvable in this test's tmp dir — the function-bundling
+        // contract we care about here is just "bundle whatever `__entry.js`
+        // imports into a single function file").
+        writeFileSync(path.join(root, "dist", "__entry.js"), "const userMod = await import('./server.js');\nexport default userMod.default;\n");
+        writeFileSync(path.join(root, "dist", "assets", "view-abc.js"), "/* bundled view */\n");
+        await emitVercelBuildOutput(root);
+        const outputDir = path.join(root, ".vercel", "output");
+        const funcDir = path.join(outputDir, "functions", "mcp.func");
+        expect(existsSync(path.join(funcDir, "index.js"))).toBe(true);
+        expect(JSON.parse(readFileSync(path.join(funcDir, ".vc-config.json"), "utf-8"))).toEqual(VERCEL_VC_CONFIG);
+        expect(JSON.parse(readFileSync(path.join(funcDir, "package.json"), "utf-8"))).toEqual({ type: "module" });
+        expect(JSON.parse(readFileSync(path.join(outputDir, "config.json"), "utf-8"))).toEqual(VERCEL_CONFIG);
+        expect(readFileSync(path.join(outputDir, "static", "assets", "view-abc.js"), "utf-8")).toContain("bundled view");
+    });
+    it("emits static assets directory when dist/assets is missing", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "dist"), { recursive: true });
+        writeFileSync(path.join(root, "dist", "__entry.js"), "const userMod = await import('./server.js');\nexport default userMod.default;\n");
+        writeFileSync(path.join(root, "dist", "server.js"), "export default function handler(_req, res) { res.end('ok'); }\n");
+        await emitVercelBuildOutput(root);
+        expect(existsSync(path.join(root, ".vercel", "output", "static", "assets"))).toBe(true);
+        expect(existsSync(path.join(root, ".vercel", "output", "functions", "mcp.func", "index.js"))).toBe(true);
+    });
+});
+//# sourceMappingURL=build-helpers.test.js.map

package/dist/cli/build-helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-helpers.test.js","sourceRoot":"","sources":["../../src/cli/build-helpers.test.ts"],"names":[],"mappings":"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","sourcesContent":["// @vitest-environment node\n// esbuild's invariant check on TextEncoder/Uint8Array trips jsdom's polyfill.\nimport {\n  existsSync,\n  mkdirSync,\n  mkdtempSync,\n  readFileSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport { describe, expect, it } from \"vitest\";\nimport {\n  ENTRY_WRAPPER_CONTENT,\n  emitEmptyManifestModule,\n  emitEntryWrapper,\n  emitManifestModule,\n  emitVercelBuildOutput,\n  ensureAssetsDir,\n  VERCEL_CONFIG,\n  VERCEL_VC_CONFIG,\n} from \"./build-helpers.js\";\n\nfunction mkTmp(prefix = \"skybridge-build-helpers-\") {\n  return mkdtempSync(path.join(tmpdir(), prefix));\n}\n\ndescribe(\"emitEntryWrapper\", () => {\n  it(\"writes dist/__entry.js that primes the manifest before importing user code\", () => {\n    const dir = mkTmp();\n    emitEntryWrapper(dir);\n    const out = readFileSync(path.join(dir, \"__entry.js\"), \"utf-8\");\n    expect(out).toBe(ENTRY_WRAPPER_CONTENT);\n    expect(out).toContain(\n      'import { __setBuildManifest } from \"skybridge/server\"',\n    );\n    expect(out).toContain('import manifest from \"./vite-manifest.js\"');\n    expect(out).toContain(\"__setBuildManifest(manifest)\");\n    // Dynamic import is load-bearing: `server.js` must evaluate after the\n    // setter runs, so a static re-export wouldn't work.\n    expect(out).toContain('await import(\"./server.js\")');\n    expect(out).toContain(\"export default userMod.default\");\n  });\n});\n\ndescribe(\"emitManifestModule\", () => {\n  it(\"inlines the JSON manifest as an ESM default export\", () => {\n    const dir = mkTmp();\n    const inPath = path.join(dir, \"manifest.json\");\n    const outPath = path.join(dir, \"vite-manifest.js\");\n    const manifest = { \"src/views/foo.tsx\": { file: \"assets/foo-abc.js\" } };\n    writeFileSync(inPath, JSON.stringify(manifest));\n    emitManifestModule(inPath, outPath);\n    const out = readFileSync(outPath, \"utf-8\");\n    expect(out.startsWith(\"export default \")).toBe(true);\n    const literal = out\n      .slice(\"export default \".length)\n      .trim()\n      .replace(/;$/, \"\");\n    expect(JSON.parse(literal)).toEqual(manifest);\n  });\n});\n\ndescribe(\"emitEmptyManifestModule\", () => {\n  it(\"writes an empty object default export\", () => {\n    const dir = mkTmp();\n    const outPath = path.join(dir, \"vite-manifest.js\");\n    emitEmptyManifestModule(outPath);\n    expect(readFileSync(outPath, \"utf-8\")).toBe(\"export default {};\\n\");\n  });\n});\n\ndescribe(\"ensureAssetsDir\", () => {\n  it(\"creates the assets directory when missing\", () => {\n    const dir = mkTmp();\n    const assetsDir = path.join(dir, \"dist\", \"assets\");\n    ensureAssetsDir(assetsDir);\n    expect(existsSync(assetsDir)).toBe(true);\n  });\n});\n\ndescribe(\"emitVercelBuildOutput\", () => {\n  it(\"emits a Build Output API tree with bundled function and static assets\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"dist\", \"assets\"), { recursive: true });\n    writeFileSync(\n      path.join(root, \"dist\", \"server.js\"),\n      \"export default function handler(_req, res) { res.end('ok'); }\\n\",\n    );\n    // Minimal `dist/__entry.js` (the real wrapper imports `skybridge/server`,\n    // which isn't resolvable in this test's tmp dir — the function-bundling\n    // contract we care about here is just \"bundle whatever `__entry.js`\n    // imports into a single function file\").\n    writeFileSync(\n      path.join(root, \"dist\", \"__entry.js\"),\n      \"const userMod = await import('./server.js');\\nexport default userMod.default;\\n\",\n    );\n    writeFileSync(\n      path.join(root, \"dist\", \"assets\", \"view-abc.js\"),\n      \"/* bundled view */\\n\",\n    );\n\n    await emitVercelBuildOutput(root);\n\n    const outputDir = path.join(root, \".vercel\", \"output\");\n    const funcDir = path.join(outputDir, \"functions\", \"mcp.func\");\n\n    expect(existsSync(path.join(funcDir, \"index.js\"))).toBe(true);\n    expect(\n      JSON.parse(readFileSync(path.join(funcDir, \".vc-config.json\"), \"utf-8\")),\n    ).toEqual(VERCEL_VC_CONFIG);\n    expect(\n      JSON.parse(readFileSync(path.join(funcDir, \"package.json\"), \"utf-8\")),\n    ).toEqual({ type: \"module\" });\n    expect(\n      JSON.parse(readFileSync(path.join(outputDir, \"config.json\"), \"utf-8\")),\n    ).toEqual(VERCEL_CONFIG);\n    expect(\n      readFileSync(\n        path.join(outputDir, \"static\", \"assets\", \"view-abc.js\"),\n        \"utf-8\",\n      ),\n    ).toContain(\"bundled view\");\n  });\n\n  it(\"emits static assets directory when dist/assets is missing\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"dist\"), { recursive: true });\n    writeFileSync(\n      path.join(root, \"dist\", \"__entry.js\"),\n      \"const userMod = await import('./server.js');\\nexport default userMod.default;\\n\",\n    );\n    writeFileSync(\n      path.join(root, \"dist\", \"server.js\"),\n      \"export default function handler(_req, res) { res.end('ok'); }\\n\",\n    );\n\n    await emitVercelBuildOutput(root);\n\n    expect(\n      existsSync(path.join(root, \".vercel\", \"output\", \"static\", \"assets\")),\n    ).toBe(true);\n    expect(\n      existsSync(\n        path.join(\n          root,\n          \".vercel\",\n          \"output\",\n          \"functions\",\n          \"mcp.func\",\n          \"index.js\",\n        ),\n      ),\n    ).toBe(true);\n  });\n});\n"]}

package/dist/cli/build-steps.d.ts

@@ -0,0 +1,2 @@
+import type { CommandStep } from "./use-execute-steps.js";
+export declare function getCommandSteps(root?: string): Promise<CommandStep[]>;

package/dist/cli/build-steps.js

@@ -0,0 +1,68 @@
+import { rmSync, writeFileSync } from "node:fs";
+import path, { isAbsolute, resolve } from "node:path";
+import { scanAndWriteViewsDts, scanViewsSync, } from "../web/plugin/scan-views.js";
+import { emitEmptyManifestModule, emitEntryWrapper, emitManifestModule, emitVercelBuildOutput, ensureAssetsDir, } from "./build-helpers.js";
+import { resolveViewsDir } from "./resolve-views-dir.js";
+export async function getCommandSteps(root = process.cwd()) {
+    const viewsDir = await resolveViewsDir(root);
+    const rawDir = viewsDir ?? "src/views";
+    const resolvedDir = isAbsolute(rawDir) ? rawDir : resolve(root, rawDir);
+    // Non-throwing pre-check: duplicate view names are validated in the
+    // "Scanning views" step so useExecuteSteps can render a styled error.
+    const hasViews = scanViewsSync(resolvedDir).valid.length > 0;
+    const steps = [
+        {
+            label: "Scanning views",
+            run: async () => {
+                scanAndWriteViewsDts(root, viewsDir);
+            },
+        },
+        {
+            label: "Compiling server",
+            run: () => rmSync(path.join(root, "dist"), { recursive: true, force: true }),
+            command: "tsc -b --force",
+        },
+    ];
+    if (hasViews) {
+        steps.push({
+            label: "Building views",
+            command: "vite build",
+        });
+    }
+    steps.push({
+        label: "Emitting manifest module",
+        run: () => {
+            const manifestOut = path.join(root, "dist", "vite-manifest.js");
+            if (hasViews) {
+                emitManifestModule(path.join(root, "dist", "assets", ".vite", "manifest.json"), manifestOut);
+            }
+            else {
+                emitEmptyManifestModule(manifestOut);
+            }
+        },
+    }, {
+        label: "Emitting entry wrapper",
+        run: () => {
+            emitEntryWrapper(path.join(root, "dist"));
+        },
+    }, {
+        label: "Emitting Cloudflare redirects",
+        run: () => {
+            const assetsDir = path.join(root, "dist", "assets");
+            ensureAssetsDir(assetsDir);
+            writeFileSync(path.join(assetsDir, "_redirects"), "/assets/assets/* /assets/:splat 200\n");
+        },
+    }, {
+        label: "Emitting Cloudflare headers",
+        run: () => {
+            const assetsDir = path.join(root, "dist", "assets");
+            ensureAssetsDir(assetsDir);
+            writeFileSync(path.join(assetsDir, "_headers"), "/assets/*\n  Access-Control-Allow-Origin: *\n");
+        },
+    }, {
+        label: "Emitting Vercel build output",
+        run: () => emitVercelBuildOutput(root),
+    });
+    return steps;
+}
+//# sourceMappingURL=build-steps.js.map

package/dist/cli/build-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-steps.js","sourceRoot":"","sources":["../../src/cli/build-steps.ts"],"names":[],"mappings":"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","sourcesContent":["import { rmSync, writeFileSync } from \"node:fs\";\nimport path, { isAbsolute, resolve } from \"node:path\";\nimport {\n  scanAndWriteViewsDts,\n  scanViewsSync,\n} from \"../web/plugin/scan-views.js\";\nimport {\n  emitEmptyManifestModule,\n  emitEntryWrapper,\n  emitManifestModule,\n  emitVercelBuildOutput,\n  ensureAssetsDir,\n} from \"./build-helpers.js\";\nimport { resolveViewsDir } from \"./resolve-views-dir.js\";\nimport type { CommandStep } from \"./use-execute-steps.js\";\n\nexport async function getCommandSteps(\n  root = process.cwd(),\n): Promise<CommandStep[]> {\n  const viewsDir = await resolveViewsDir(root);\n  const rawDir = viewsDir ?? \"src/views\";\n  const resolvedDir = isAbsolute(rawDir) ? rawDir : resolve(root, rawDir);\n  // Non-throwing pre-check: duplicate view names are validated in the\n  // \"Scanning views\" step so useExecuteSteps can render a styled error.\n  const hasViews = scanViewsSync(resolvedDir).valid.length > 0;\n\n  const steps: CommandStep[] = [\n    {\n      label: \"Scanning views\",\n      run: async () => {\n        scanAndWriteViewsDts(root, viewsDir);\n      },\n    },\n    {\n      label: \"Compiling server\",\n      run: () =>\n        rmSync(path.join(root, \"dist\"), { recursive: true, force: true }),\n      command: \"tsc -b --force\",\n    },\n  ];\n\n  if (hasViews) {\n    steps.push({\n      label: \"Building views\",\n      command: \"vite build\",\n    });\n  }\n\n  steps.push(\n    {\n      label: \"Emitting manifest module\",\n      run: () => {\n        const manifestOut = path.join(root, \"dist\", \"vite-manifest.js\");\n        if (hasViews) {\n          emitManifestModule(\n            path.join(root, \"dist\", \"assets\", \".vite\", \"manifest.json\"),\n            manifestOut,\n          );\n        } else {\n          emitEmptyManifestModule(manifestOut);\n        }\n      },\n    },\n    {\n      label: \"Emitting entry wrapper\",\n      run: () => {\n        emitEntryWrapper(path.join(root, \"dist\"));\n      },\n    },\n    {\n      label: \"Emitting Cloudflare redirects\",\n      run: () => {\n        const assetsDir = path.join(root, \"dist\", \"assets\");\n        ensureAssetsDir(assetsDir);\n        writeFileSync(\n          path.join(assetsDir, \"_redirects\"),\n          \"/assets/assets/* /assets/:splat 200\\n\",\n        );\n      },\n    },\n    {\n      label: \"Emitting Cloudflare headers\",\n      run: () => {\n        const assetsDir = path.join(root, \"dist\", \"assets\");\n        ensureAssetsDir(assetsDir);\n        writeFileSync(\n          path.join(assetsDir, \"_headers\"),\n          \"/assets/*\\n  Access-Control-Allow-Origin: *\\n\",\n        );\n      },\n    },\n    {\n      label: \"Emitting Vercel build output\",\n      run: () => emitVercelBuildOutput(root),\n    },\n  );\n\n  return steps;\n}\n"]}