skybridge 0.0.0-dev.d4358f5 → 0.0.0-dev.d455164

package/README.md

@@ -2,7 +2,10 @@
 
 <p align="center">
   <a href="https://docs.skybridge.tech">
-    <img alt="Skybridge - The full-stack React framework for MCP Apps and MCP Servers" src="docs/images/skybridge-readme-banner.png" width="100%" />
+    <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>
 
@@ -25,85 +28,86 @@
 
 ## About Skybridge
 
-Skybridge helps developers build type-safe MCP Apps for Claude, ChatGPT, Gemini and other UI enabled MCP Clients, with a complete set of devtools designed for both humans and agents.
+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.
 
-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. This is why we built Skybridge.
+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**: It 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**: Skybridge abstracts implementation differences between MCP Clients, so your app runs seamlessly in Claude, ChatGPT, VSCode, and any other compatible MCP Apps client.
-- **Agent-ready**: Powerful Skills, CLI, and programmatic DevTools APIs: it provides 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 end-to-end from server to frontend.
+- **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. 
-- **Examples library**: Get started quickly with production-ready app examples for e-commerce, travel, SaaS, and others.
+- **Example library**: get started quickly with ChatGPT- and Claude-ready app examples for ecommerce, travel, SaaS, and more.
 
-These companies chose Skybridge to deploy their apps on ChatGPT and Claude stores: 
+They chose to build their MCP apps with Skybridge: 
 
 <p align="center">
-  <a href="https://www.datadoghq.com"><img src="docs/images/user-logos/datadog-light.svg#gh-light-mode-only" alt="Datadog" height="24"><img src="docs/images/user-logos/datadog-dark.svg#gh-dark-mode-only" alt="Datadog" height="24"></a>
+  <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"><img src="docs/images/user-logos/bitmovin-light.svg#gh-light-mode-only" alt="Bitmovin" height="22"><img src="docs/images/user-logos/bitmovin-dark.svg#gh-dark-mode-only" alt="Bitmovin" height="22"></a>
+  <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"><img src="docs/images/user-logos/evaneos-light.svg#gh-light-mode-only" alt="Evaneos" height="18"><img src="docs/images/user-logos/evaneos-dark.svg#gh-dark-mode-only" alt="Evaneos" height="18"></a>
+  <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"><img src="docs/images/user-logos/touchstream-light.svg#gh-light-mode-only" alt="Touchstream" height="24"><img src="docs/images/user-logos/touchstream-dark.svg#gh-dark-mode-only" alt="Touchstream" height="24"></a>
+  <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"><img src="docs/images/user-logos/cottages-light.svg#gh-light-mode-only" alt="Cottages.com" height="24"><img src="docs/images/user-logos/cottages-dark.svg#gh-dark-mode-only" alt="Cottages.com" height="24"></a>
+  <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 MCP Apps and ChatGPT Apps:
+Install our [skill](https://docs.skybridge.tech/devtools/skills) for building MCP apps and ChatGPT apps:
 ```bash
 npx skills add alpic-ai/skybridge -s skybridge
 ```
-Once installed, if you ask your agent "_what skills do you have?_", it should mention the skybridge skill. Then, you can ask it to:
+Once installed, ask your agent "What skills do you have?" to confirm, then try:
 
-- _Create a new MCP App_
-- _Migrate my MCP Server to the Skybridge framework_
-- _Add a new view to my MCP App_ 
+- _Create a new MCP app_
+- _Migrate my MCP server to the Skybridge framework_
+- _Add a new view to my MCP app_ 
 
 **For humans**
 
 Bootstrap a new project with:
 ```bash
-npm create skybridge my-app
+npm create skybridge@latest my-app
 ```
-For full install instructions, read the [**Quickstart section**](https://docs.skybridge.tech/quickstart/create-new-app) of our documentation.
+For full install instructions, read our [**Quickstart guide**](https://docs.skybridge.tech/quickstart/create-new-app).
 
 ## Documentation
 
 The [Skybridge documentation](https://docs.skybridge.tech) covers the full lifecycle of building MCP Apps:
 
 - [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 flow, LLM context sync, type safety, and instant local iteration with our devtools.
+- [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.
 
 ## Deploy
 
-Deploy Skybridge apps instantly on [Alpic](https://alpic.ai) to get scalable hosting, MCP analytics, permanent tunnelling, MCP auditing and app stores submission help, or self-host on any Node.js-compatible platform.
+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.
 
-Read the [deployment guide](https://docs.skybridge.tech/quickstart/deploy) for the full production path.
+See our [deployment guide](https://docs.skybridge.tech/quickstart/deploy) for the full production path.
 
 ## Community & Contributing
 
-We invite you to contribute and help improve Skybridge.
-
-Here are a few ways you can get involved:
+We'd love your help improving Skybridge. Here are a few ways to get involved:
 
-- **Reporting bugs**: If you run into a bug or unexpected behavior, please open an issue in [GitHub Issues](https://github.com/alpic-ai/skybridge/issues) with a clear reproduction.
-- **Questions and Suggestions**: 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, please read the [Contributing Guide](https://github.com/alpic-ai/skybridge/blob/main/CONTRIBUTING.md) before opening a PR.
+- **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.
 
 Skybridge is released under the [MIT License](https://github.com/alpic-ai/skybridge/blob/main/LICENSE).
 
 ### Contributors
 
-Built and maintained by [Harijoe](https://github.com/harijoe), [Fred Barthelet](https://github.com/fredericbarthelet), and the [Alpic](https://alpic.ai) team.
+Built and maintained with ❤️ by [Harijoe](https://github.com/harijoe), [Fred Barthelet](https://github.com/fredericbarthelet), and the [Alpic](https://alpic.ai) team.
 
 <a href="https://github.com/alpic-ai/skybridge/graphs/contributors">
   <img src="https://contrib.rocks/image?repo=alpic-ai/skybridge" alt="Skybridge contributors">
@@ -135,10 +139,12 @@ Explore all our example templates in the [Examples](https://docs.skybridge.tech/
 
 | 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) |
+| <img src="docs/images/showcase-authplane.png" alt="Auth Authplane" width="160" /> | Authplane | Full OAuth authentication with Authplane and personalized coffee shop search. | [View code](https://github.com/alpic-ai/skybridge/tree/main/examples/auth-authplane) |
 
 ### UI and component libraries
 

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

@@ -0,0 +1,11 @@
+export declare const ENTRY_WRAPPER_CONTENT = "import { __setBuildManifest, __setSkillsManifest } from \"skybridge/server\";\nimport manifest from \"./vite-manifest.js\";\nimport skills from \"./skills.js\";\n\n__setBuildManifest(manifest);\n__setSkillsManifest(skills);\n\nconst userMod = await import(\"./server.js\");\nexport default userMod.default;\n";
+export declare function emitEntryWrapper(distDir: string): void;
+export declare function emitSkillsModule(skillsDir: string, outPath: 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, serverExternal?: string[]): Promise<void>;

package/dist/cli/build-helpers.js

@@ -0,0 +1,107 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import path from "node:path";
+import { discoverSkills } from "../server/skills.js";
+// Primes the manifest and skills snapshot in skybridge's module scope, then
+// dynamically imports `./server.js` so user code runs *after* the side channels
+// are 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 the primers run. Both `skills.js` and
+// the manifest are imported (not read from disk) so they ride the bundle on
+// filesystem-less targets like Cloudflare Workers.
+export const ENTRY_WRAPPER_CONTENT = `import { __setBuildManifest, __setSkillsManifest } from "skybridge/server";
+import manifest from "./vite-manifest.js";
+import skills from "./skills.js";
+
+__setBuildManifest(manifest);
+__setSkillsManifest(skills);
+
+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 emitSkillsModule(skillsDir, outPath) {
+    const skills = discoverSkills(skillsDir);
+    writeFileSync(outPath, `export default ${JSON.stringify(skills)};\n`);
+}
+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, serverExternal = []) {
+    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.
+        // `serverExternal` comes from the vite plugin, for deps esbuild can't
+        // resolve or load (e.g. optional native modules pulled in transitively).
+        external: ["vite", "@skybridge/devtools", ...serverExternal],
+        // Native addons can't be inlined into the bundle; copy them next to the
+        // function and rewrite the require path to point at the copy.
+        loader: { ".node": "file" },
+        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\";\nimport { discoverSkills } from \"../server/skills.js\";\n\n// Primes the manifest and skills snapshot in skybridge's module scope, then\n// dynamically imports `./server.js` so user code runs *after* the side channels\n// are set. The dynamic import is load-bearing: a static\n// `export { default } from ...` is hoisted with the rest of the static graph\n// and would evaluate `server.js` before the primers run. Both `skills.js` and\n// the manifest are imported (not read from disk) so they ride the bundle on\n// filesystem-less targets like Cloudflare Workers.\nexport const ENTRY_WRAPPER_CONTENT = `import { __setBuildManifest, __setSkillsManifest } from \"skybridge/server\";\nimport manifest from \"./vite-manifest.js\";\nimport skills from \"./skills.js\";\n\n__setBuildManifest(manifest);\n__setSkillsManifest(skills);\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 emitSkillsModule(skillsDir: string, outPath: string): void {\n  const skills = discoverSkills(skillsDir);\n  writeFileSync(outPath, `export default ${JSON.stringify(skills)};\\n`);\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(\n  root: string,\n  serverExternal: string[] = [],\n): 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    // `serverExternal` comes from the vite plugin, for deps esbuild can't\n    // resolve or load (e.g. optional native modules pulled in transitively).\n    external: [\"vite\", \"@skybridge/devtools\", ...serverExternal],\n    // Native addons can't be inlined into the bundle; copy them next to the\n    // function and rewrite the require path to point at the copy.\n    loader: { \".node\": \"file\" },\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.d.ts

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

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

@@ -0,0 +1,132 @@
+// @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, emitSkillsModule, 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, __setSkillsManifest } from "skybridge/server"');
+        expect(out).toContain('import manifest from "./vite-manifest.js"');
+        expect(out).toContain('import skills from "./skills.js"');
+        expect(out).toContain("__setBuildManifest(manifest)");
+        expect(out).toContain("__setSkillsManifest(skills)");
+        // Dynamic import is load-bearing: `server.js` must evaluate after the
+        // setters run, so a static re-export wouldn't work.
+        expect(out).toContain('await import("./server.js")');
+        expect(out).toContain("export default userMod.default");
+    });
+});
+describe("emitSkillsModule", () => {
+    it("inlines discovered skills as an ESM default export", () => {
+        const dir = mkTmp();
+        const skillsDir = path.join(dir, "src", "skills");
+        mkdirSync(path.join(skillsDir, "refunds"), { recursive: true });
+        writeFileSync(path.join(skillsDir, "refunds", "SKILL.md"), "---\nname: refunds\ndescription: Process refunds\n---\nBody");
+        const outPath = path.join(dir, "skills.js");
+        emitSkillsModule(skillsDir, outPath);
+        const out = readFileSync(outPath, "utf-8");
+        const literal = out
+            .slice("export default ".length)
+            .trim()
+            .replace(/;$/, "");
+        const skills = JSON.parse(literal);
+        expect(skills).toHaveLength(1);
+        expect(skills[0]).toMatchObject({
+            uri: "skill://refunds/SKILL.md",
+            frontmatter: { name: "refunds", description: "Process refunds" },
+        });
+        expect(skills[0].resources).toHaveLength(1);
+        expect(skills[0].resources[0].uri).toBe("skill://refunds/SKILL.md");
+        expect(skills[0].resources[0].digest).toMatch(/^sha256:[a-f0-9]{64}$/);
+    });
+    it("emits an empty array when the skills directory is absent", () => {
+        const dir = mkTmp();
+        const outPath = path.join(dir, "skills.js");
+        emitSkillsModule(path.join(dir, "nope"), outPath);
+        expect(readFileSync(outPath, "utf-8")).toBe("export default [];\n");
+    });
+});
+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("leaves serverExternal packages unbundled", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "dist"), { recursive: true });
+        // Unresolvable from the tmp root, so esbuild fails the build unless the
+        // package is marked external (bunyan → optional `dtrace-provider`).
+        writeFileSync(path.join(root, "dist", "__entry.js"), 'import "dtrace-provider";\nexport default null;\n');
+        await expect(emitVercelBuildOutput(root)).rejects.toThrow(/Could not resolve "dtrace-provider"/);
+        await emitVercelBuildOutput(root, ["dtrace-provider"]);
+        const bundle = readFileSync(path.join(root, ".vercel", "output", "functions", "mcp.func", "index.js"), "utf-8");
+        expect(bundle).toContain('import "dtrace-provider"');
+    });
+    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  emitSkillsModule,\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, __setSkillsManifest } from \"skybridge/server\"',\n    );\n    expect(out).toContain('import manifest from \"./vite-manifest.js\"');\n    expect(out).toContain('import skills from \"./skills.js\"');\n    expect(out).toContain(\"__setBuildManifest(manifest)\");\n    expect(out).toContain(\"__setSkillsManifest(skills)\");\n    // Dynamic import is load-bearing: `server.js` must evaluate after the\n    // setters run, 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(\"emitSkillsModule\", () => {\n  it(\"inlines discovered skills as an ESM default export\", () => {\n    const dir = mkTmp();\n    const skillsDir = path.join(dir, \"src\", \"skills\");\n    mkdirSync(path.join(skillsDir, \"refunds\"), { recursive: true });\n    writeFileSync(\n      path.join(skillsDir, \"refunds\", \"SKILL.md\"),\n      \"---\\nname: refunds\\ndescription: Process refunds\\n---\\nBody\",\n    );\n    const outPath = path.join(dir, \"skills.js\");\n    emitSkillsModule(skillsDir, outPath);\n    const out = readFileSync(outPath, \"utf-8\");\n    const literal = out\n      .slice(\"export default \".length)\n      .trim()\n      .replace(/;$/, \"\");\n    const skills = JSON.parse(literal);\n    expect(skills).toHaveLength(1);\n    expect(skills[0]).toMatchObject({\n      uri: \"skill://refunds/SKILL.md\",\n      frontmatter: { name: \"refunds\", description: \"Process refunds\" },\n    });\n    expect(skills[0].resources).toHaveLength(1);\n    expect(skills[0].resources[0].uri).toBe(\"skill://refunds/SKILL.md\");\n    expect(skills[0].resources[0].digest).toMatch(/^sha256:[a-f0-9]{64}$/);\n  });\n\n  it(\"emits an empty array when the skills directory is absent\", () => {\n    const dir = mkTmp();\n    const outPath = path.join(dir, \"skills.js\");\n    emitSkillsModule(path.join(dir, \"nope\"), outPath);\n    expect(readFileSync(outPath, \"utf-8\")).toBe(\"export default [];\\n\");\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(\"leaves serverExternal packages unbundled\", async () => {\n    const root = mkTmp();\n    mkdirSync(path.join(root, \"dist\"), { recursive: true });\n    // Unresolvable from the tmp root, so esbuild fails the build unless the\n    // package is marked external (bunyan → optional `dtrace-provider`).\n    writeFileSync(\n      path.join(root, \"dist\", \"__entry.js\"),\n      'import \"dtrace-provider\";\\nexport default null;\\n',\n    );\n\n    await expect(emitVercelBuildOutput(root)).rejects.toThrow(\n      /Could not resolve \"dtrace-provider\"/,\n    );\n    await emitVercelBuildOutput(root, [\"dtrace-provider\"]);\n\n    const bundle = readFileSync(\n      path.join(root, \".vercel\", \"output\", \"functions\", \"mcp.func\", \"index.js\"),\n      \"utf-8\",\n    );\n    expect(bundle).toContain('import \"dtrace-provider\"');\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,73 @@
+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, emitSkillsModule, emitVercelBuildOutput, ensureAssetsDir, } from "./build-helpers.js";
+import { resolveSkybridgeConfig } from "./resolve-skybridge-config.js";
+export async function getCommandSteps(root = process.cwd()) {
+    const { viewsDir, serverExternal } = await resolveSkybridgeConfig(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 skills module",
+        run: () => {
+            emitSkillsModule(resolve(root, "src/skills"), path.join(root, "dist", "skills.js"));
+        },
+    }, {
+        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, serverExternal),
+    });
+    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  emitSkillsModule,\n  emitVercelBuildOutput,\n  ensureAssetsDir,\n} from \"./build-helpers.js\";\nimport { resolveSkybridgeConfig } from \"./resolve-skybridge-config.js\";\nimport type { CommandStep } from \"./use-execute-steps.js\";\n\nexport async function getCommandSteps(\n  root = process.cwd(),\n): Promise<CommandStep[]> {\n  const { viewsDir, serverExternal } = await resolveSkybridgeConfig(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 skills module\",\n      run: () => {\n        emitSkillsModule(\n          resolve(root, \"src/skills\"),\n          path.join(root, \"dist\", \"skills.js\"),\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, serverExternal),\n    },\n  );\n\n  return steps;\n}\n"]}

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

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

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

@@ -0,0 +1,52 @@
+// @vitest-environment node
+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 { getCommandSteps } from "./build-steps.js";
+function mkTmp(prefix = "skybridge-build-steps-") {
+    return mkdtempSync(path.join(tmpdir(), prefix));
+}
+describe("getCommandSteps", () => {
+    it("omits the vite build step when no views are registered", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "src"), { recursive: true });
+        writeFileSync(path.join(root, "vite.config.ts"), `import { defineConfig } from "vite";
+import { skybridge } from "skybridge/vite";
+export default defineConfig({ plugins: [skybridge()] });`);
+        writeFileSync(path.join(root, "tsconfig.json"), JSON.stringify({ compilerOptions: { strict: true } }));
+        const steps = await getCommandSteps(root);
+        const labels = steps.map((step) => step.label);
+        expect(labels).not.toContain("Building views");
+        expect(labels).toContain("Emitting manifest module");
+        expect(labels.at(-1)).toBe("Emitting Vercel build output");
+    });
+    it("includes the vite build step when views are present", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "src", "views"), { recursive: true });
+        writeFileSync(path.join(root, "src", "views", "hello.tsx"), "export default function Hello() { return null; }\n");
+        writeFileSync(path.join(root, "vite.config.ts"), `import { defineConfig } from "vite";
+import { skybridge } from "skybridge/vite";
+export default defineConfig({ plugins: [skybridge()] });`);
+        writeFileSync(path.join(root, "tsconfig.json"), JSON.stringify({ compilerOptions: { strict: true } }));
+        const steps = await getCommandSteps(root);
+        const labels = steps.map((step) => step.label);
+        expect(labels).toContain("Building views");
+    });
+    it("emits an empty manifest module when there are no views", async () => {
+        const root = mkTmp();
+        mkdirSync(path.join(root, "src"), { recursive: true });
+        writeFileSync(path.join(root, "vite.config.ts"), `import { defineConfig } from "vite";
+import { skybridge } from "skybridge/vite";
+export default defineConfig({ plugins: [skybridge()] });`);
+        const steps = await getCommandSteps(root);
+        const emitManifest = steps.find((step) => step.label === "Emitting manifest module");
+        expect(emitManifest?.run).toBeDefined();
+        mkdirSync(path.join(root, "dist"), { recursive: true });
+        await emitManifest?.run?.();
+        const manifestOut = path.join(root, "dist", "vite-manifest.js");
+        expect(existsSync(manifestOut)).toBe(true);
+        expect(readFileSync(manifestOut, "utf-8")).toBe("export default {};\n");
+    });
+});
+//# sourceMappingURL=build-steps.test.js.map