@sidecar-ai/compiler 0.1.0-alpha.1 → 0.1.0-alpha.4

package/dist/index.d.ts

@@ -27,6 +27,8 @@ declare function formatDiagnostic(diagnostic: SidecarDiagnostic): string;
 
 /** Build target profile selected by reserved platform file suffixes. */
 type SidecarTarget = "mcp" | "chatgpt" | "claude";
+/** Host runtime artifact emitted for a build output. */
+type SidecarHost = "node" | "vercel";
 /** Platform suffix chosen for a reserved tool or widget file. */
 type SidecarSourceVariant = "shared" | "openai" | "anthropic";
 /** Tool entry emitted into `manifest.sidecar.json`. */
@@ -109,6 +111,7 @@ type SidecarCompilerConfig = {
 type SidecarManifest = {
     version: 1;
     target: SidecarTarget;
+    host: SidecarHost;
     rootDir: string;
     generatedAt: string;
     config: SidecarCompilerConfig;
@@ -121,6 +124,7 @@ type SidecarManifest = {
 /** Options accepted by `buildProject()`. */
 type BuildProjectOptions = {
     rootDir: string;
+    host?: SidecarHost;
     outDir?: string;
     plugins?: boolean;
     strict?: boolean;
@@ -172,4 +176,9 @@ declare function analyzeProjectResources(rootDir: string): Promise<SidecarResour
 /** Analyzes one `resource.ts` source file into a compiler manifest entry. */
 declare function analyzeResourceFile(sourceFile: SourceFile, rootDir: string): SidecarResourceManifestEntry;
 
-export { type BuildProjectOptions, CompilerError, type ProjectIdentity, type SidecarCompilerConfig, type SidecarDiagnostic, type SidecarManifest, type SidecarPromptManifestEntry, type SidecarResourceManifestEntry, type SidecarResourceTemplateManifestEntry, type SidecarSourceVariant, type SidecarTarget, type SidecarToolManifestEntry, type SidecarWidgetManifestEntry, analyzeProjectConfig, analyzeProjectPrompts, analyzeProjectResources, analyzeProjectTools, analyzePromptFile, analyzeResourceFile, analyzeToolFile, buildProject, collectProjectDiagnostics, formatDiagnostic };
+/** Relative location of the generated server entrypoint inside a build output. */
+declare const SERVER_ENTRYPOINT = "server/index.js";
+/** Relative location of the optional Vercel request-handler shim. */
+declare const VERCEL_ENTRYPOINT = "api/sidecar.js";
+
+export { type BuildProjectOptions, CompilerError, type ProjectIdentity, SERVER_ENTRYPOINT, type SidecarCompilerConfig, type SidecarDiagnostic, type SidecarHost, type SidecarManifest, type SidecarPromptManifestEntry, type SidecarResourceManifestEntry, type SidecarResourceTemplateManifestEntry, type SidecarSourceVariant, type SidecarTarget, type SidecarToolManifestEntry, type SidecarWidgetManifestEntry, VERCEL_ENTRYPOINT, analyzeProjectConfig, analyzeProjectPrompts, analyzeProjectResources, analyzeProjectTools, analyzePromptFile, analyzeResourceFile, analyzeToolFile, buildProject, collectProjectDiagnostics, formatDiagnostic };

package/dist/index.js

@@ -579,12 +579,19 @@ function typeToJsonSchemaInner(type) {
     return { anyOf: parts.map((part) => typeToJsonSchema(part)) };
   }
   const properties = type.getProperties();
+  const indexType = type.getStringIndexType() ?? type.getNumberIndexType();
   if (properties.length > 0) {
-    return objectTypeToSchema(properties);
+    return objectTypeToSchema(properties, indexType);
+  }
+  if (indexType) {
+    return {
+      type: "object",
+      additionalProperties: indexTypeToAdditionalProperties(indexType)
+    };
   }
   return {};
 }
-function objectTypeToSchema(properties) {
+function objectTypeToSchema(properties, indexType) {
   const schemaProperties = {};
   const required = [];
   for (const property of properties) {
@@ -608,9 +615,16 @@ function objectTypeToSchema(properties) {
     type: "object",
     properties: schemaProperties,
     required,
-    additionalProperties: false
+    additionalProperties: indexType ? indexTypeToAdditionalProperties(indexType) : false
   };
 }
+function indexTypeToAdditionalProperties(type) {
+  if (type.isAny() || type.isUnknown()) {
+    return true;
+  }
+  const schema = typeToJsonSchema(type);
+  return Object.keys(schema).length ? schema : true;
+}
 function literalOrPrimitive(type, primitive) {
   if (isLiteralType(type)) {
     return { const: literalValue(type) };
@@ -679,6 +693,7 @@ import {
   Node as Node3,
   SyntaxKind
 } from "ts-morph";
+var CLAUDE_FONT_RESOURCE_DOMAIN = "https://assets.claude.ai";
 async function buildWidgets(rootDir, outDir, tools) {
   const widgets = tools.filter(
     (entry) => Boolean(entry.widget)
@@ -862,7 +877,7 @@ function widgetMeta(resourceUri, options = {}, target = "mcp") {
 function widgetResourceMeta(options = {}, target = "mcp") {
   const csp = stripUndefined3({
     connectDomains: options.csp?.connectDomains ? [...options.csp.connectDomains] : [],
-    resourceDomains: options.csp?.resourceDomains ? [...options.csp.resourceDomains] : [],
+    resourceDomains: widgetResourceDomains(options, target),
     frameDomains: options.csp?.frameDomains ? [...options.csp.frameDomains] : void 0,
     baseUriDomains: options.csp?.baseUriDomains ? [...options.csp.baseUriDomains] : void 0
   });
@@ -875,6 +890,13 @@ function widgetResourceMeta(options = {}, target = "mcp") {
   });
   return Object.keys(ui).length ? { ui } : void 0;
 }
+function widgetResourceDomains(options, target) {
+  const domains = [...options.csp?.resourceDomains ?? []];
+  if (target === "claude" && !domains.includes(CLAUDE_FONT_RESOURCE_DOMAIN)) {
+    domains.push(CLAUDE_FONT_RESOURCE_DOMAIN);
+  }
+  return domains;
+}
 function findWidgetDefinition(sourceFile) {
   const call = resolveDefaultExportCall(sourceFile, "widget");
   if (!call) {
@@ -1460,8 +1482,8 @@ function readStringArrayProperty2(definition, propertyName) {
 }
 
 // packages/compiler/src/build.ts
-import { mkdir as mkdir8, writeFile as writeFile8 } from "fs/promises";
-import path17 from "path";
+import { mkdir as mkdir9, writeFile as writeFile9 } from "fs/promises";
+import path18 from "path";
 
 // packages/compiler/src/config.ts
 import path5 from "path";
@@ -1878,10 +1900,6 @@ function uniqueMethodNames(names) {
   });
 }
 
-// packages/compiler/src/plugins.ts
-import { mkdir as mkdir7, writeFile as writeFile7 } from "fs/promises";
-import path14 from "path";
-
 // packages/compiler/src/identity.ts
 import { readFile as readFile3 } from "fs/promises";
 import path8 from "path";
@@ -1922,6 +1940,10 @@ function readConfigString(configText, key) {
   return match?.[1];
 }
 
+// packages/compiler/src/plugins.ts
+import { mkdir as mkdir7, writeFile as writeFile7 } from "fs/promises";
+import path14 from "path";
+
 // packages/compiler/src/plugin-components/agents.ts
 import { mkdir as mkdir3, readdir as readdir2, readFile as readFile4, writeFile as writeFile3 } from "fs/promises";
 import path9 from "path";
@@ -2366,7 +2388,7 @@ This package was generated by Sidecar.
 
 Set \`SIDECAR_MCP_URL\` to the hosted MCP endpoint for this app.
 
-For local testing, run \`sidecar dev --tunnel\` and use the printed HTTPS MCP URL.
+For local testing, run \`sidecar dev --tunnel\` and use the validated HTTPS MCP URL it prints. Temporary quick tunnels are public and best-effort; use a configured tunnel/domain or deployed preview for repeatable testing.
 
 Claude/Cowork plugin-specific components such as skills, slash commands, agents, hooks, output styles, themes, monitors, assets, and bin scripts will be emitted here when the source project defines them.
 `
@@ -2777,15 +2799,319 @@ function readStringArrayProperty4(definition, propertyName) {
   return initializer.getElements().filter(Node8.isStringLiteral).map((element) => element.getLiteralText());
 }
 
+// packages/compiler/src/server-output.ts
+import { existsSync as existsSync5 } from "fs";
+import { mkdir as mkdir8, rm, writeFile as writeFile8 } from "fs/promises";
+import path17 from "path";
+import { build as esbuild2 } from "esbuild";
+var SERVER_ENTRYPOINT = "server/index.js";
+var VERCEL_ENTRYPOINT = "api/sidecar.js";
+async function buildServerOutput(rootDir, outDir, manifest, identity, host = "node") {
+  const cacheDir = path17.join(rootDir, ".sidecar", "cache", "server");
+  await mkdir8(cacheDir, { recursive: true });
+  const entryFile = path17.join(cacheDir, "index.ts");
+  await writeFile8(entryFile, renderServerEntry(rootDir, entryFile, manifest, identity));
+  const serverFile = path17.join(outDir, SERVER_ENTRYPOINT);
+  await mkdir8(path17.dirname(serverFile), { recursive: true });
+  await esbuild2({
+    absWorkingDir: rootDir,
+    alias: sidecarBundleAliases(rootDir),
+    banner: {
+      js: `import { createRequire as __sidecarCreateRequire } from "node:module";
+const require = __sidecarCreateRequire(import.meta.url);`
+    },
+    bundle: true,
+    entryPoints: [entryFile],
+    format: "esm",
+    legalComments: "none",
+    minify: false,
+    nodePaths: [
+      path17.join(rootDir, "node_modules"),
+      path17.join(process.cwd(), "node_modules")
+    ],
+    outfile: serverFile,
+    platform: "node",
+    sourcemap: false,
+    target: "node20"
+  });
+  await writeFile8(path17.join(outDir, "package.json"), renderServerPackage(identity));
+  if (host === "vercel") {
+    await mkdir8(path17.join(outDir, "api"), { recursive: true });
+    await writeFile8(path17.join(outDir, VERCEL_ENTRYPOINT), renderVercelEntrypoint());
+    await writeFile8(path17.join(outDir, "vercel.json"), renderVercelConfig());
+  } else {
+    await rm(path17.join(outDir, "api"), { recursive: true, force: true });
+    await rm(path17.join(outDir, "vercel.json"), { force: true });
+  }
+}
+function renderServerEntry(rootDir, entryFile, manifest, identity) {
+  const entryDir = path17.dirname(entryFile);
+  const tools = manifest.tools;
+  const resources = manifest.resources;
+  const prompts = manifest.prompts;
+  const imports = [
+    `import { readFileSync, realpathSync } from "node:fs";`,
+    `import { createServer } from "node:http";`,
+    `import { pathToFileURL } from "node:url";`,
+    `import { createSidecarHttpHandler } from "@sidecar-ai/server";`,
+    `import { isSidecarAuth } from "@sidecar-ai/auth";`,
+    `import { isSidecarPrompt, isSidecarResource, isSidecarTool } from "@sidecar-ai/core";`,
+    `import { isSidecarProxy } from "@sidecar-ai/server/proxy";`,
+    ...tools.map(
+      (entry, index) => `import tool${index} from ${JSON.stringify(toImportSpecifier(entryDir, path17.join(rootDir, entry.sourceFile)))};`
+    ),
+    ...resources.map(
+      (entry, index) => `import resource${index} from ${JSON.stringify(toImportSpecifier(entryDir, path17.join(rootDir, entry.sourceFile)))};`
+    ),
+    ...prompts.map(
+      (entry, index) => `import prompt${index} from ${JSON.stringify(toImportSpecifier(entryDir, path17.join(rootDir, entry.sourceFile)))};`
+    ),
+    existsSync5(path17.join(rootDir, "auth.ts")) ? `import authExport from ${JSON.stringify(toImportSpecifier(entryDir, path17.join(rootDir, "auth.ts")))};` : `const authExport = undefined;`,
+    existsSync5(path17.join(rootDir, "proxy.ts")) ? `import proxyExport from ${JSON.stringify(toImportSpecifier(entryDir, path17.join(rootDir, "proxy.ts")))};` : `const proxyExport = undefined;`,
+    existsSync5(path17.join(rootDir, "sidecar.config.ts")) ? `import configExport from ${JSON.stringify(toImportSpecifier(entryDir, path17.join(rootDir, "sidecar.config.ts")))};` : `const configExport = undefined;`
+  ].join("\n");
+  return `${imports}
+
+const manifest = ${JSON.stringify(manifest, null, 2)};
+const identity = ${JSON.stringify(identity, null, 2)};
+
+const loadedAuth = authExport === undefined ? undefined : assertAuth(authExport);
+const auth = loadedAuth && process.env.SIDECAR_MCP_URL
+  ? loadedAuth.withResource(process.env.SIDECAR_MCP_URL)
+  : loadedAuth;
+const proxy = proxyExport === undefined ? undefined : assertProxy(proxyExport);
+const runtimeConfig = configExport && typeof configExport === "object" ? configExport : undefined;
+
+if (auth && !process.env.SIDECAR_MCP_URL) {
+  console.warn("Sidecar auth is enabled. Set SIDECAR_MCP_URL to the public https://.../mcp URL before hosting.");
+}
+
+export const handler = createSidecarHttpHandler({
+  name: identity.name,
+  version: identity.version,
+  path: process.env.SIDECAR_MCP_PATH ?? "/mcp",
+  publicUrl: process.env.SIDECAR_PUBLIC_URL ?? process.env.SIDECAR_MCP_URL,
+  auth,
+  proxy,
+  tools: [
+${tools.map((entry, index) => `    loadTool(${JSON.stringify(entry.sourceFile)}, tool${index}, manifest.tools[${index}].descriptor),`).join("\n")}
+  ],
+  resources: [
+${renderWidgetResources(manifest)}
+${resources.map((entry, index) => `    loadResource(${JSON.stringify(entry.sourceFile)}, resource${index}, manifest.resources[${index}]),`).join("\n")}
+  ],
+  resourceTemplates: manifest.resourceTemplates.map((entry) => ({ descriptor: entry.descriptor })),
+  prompts: [
+${prompts.map((entry, index) => `    loadPrompt(${JSON.stringify(entry.sourceFile)}, prompt${index}, manifest.prompts[${index}].descriptor),`).join("\n")}
+  ],
+  capabilities: {
+    tools: runtimeConfig?.tools ?? manifest.config.tools,
+    resources: runtimeConfig?.resources ?? manifest.config.resources,
+    prompts: runtimeConfig?.prompts ?? manifest.config.prompts,
+  },
+  pagination: runtimeConfig?.pagination ?? {
+    pageSize: manifest.config.pagination.pageSize,
+  },
+});
+
+export default handler;
+
+export const server = createServer(handler);
+
+if (isDirectRun()) {
+  const port = readPort();
+  const host = process.env.SIDECAR_HOST ?? process.env.HOST ?? "0.0.0.0";
+  server.listen(port, host, () => {
+    const localHost = host === "0.0.0.0" ? "127.0.0.1" : host;
+    console.log(\`MCP running on Streamable HTTP at http://\${localHost}:\${port}\${process.env.SIDECAR_MCP_PATH ?? "/mcp"}\`);
+  });
+
+  process.on("SIGTERM", () => shutdown());
+  process.on("SIGINT", () => shutdown());
+}
+
+function loadTool(sourceFile, value, descriptor) {
+  const tool = unwrapRuntimeDefault(value);
+  if (!isSidecarTool(tool)) {
+    throw new Error(\`\${sourceFile} did not default-export a Sidecar tool.\`);
+  }
+  return { tool, descriptor };
+}
+
+function loadResource(sourceFile, value, entry) {
+  const resource = unwrapRuntimeDefault(value);
+  if (!isSidecarResource(resource)) {
+    throw new Error(\`\${sourceFile} did not default-export a Sidecar resource.\`);
+  }
+  return {
+    uri: entry.uri,
+    descriptor: entry.descriptor,
+    resource,
+  };
+}
+
+function loadPrompt(sourceFile, value, descriptor) {
+  const prompt = unwrapRuntimeDefault(value);
+  if (!isSidecarPrompt(prompt)) {
+    throw new Error(\`\${sourceFile} did not default-export a Sidecar prompt.\`);
+  }
+  return { prompt, descriptor };
+}
+
+function assertAuth(value) {
+  const authValue = unwrapRuntimeDefault(value);
+  if (!isSidecarAuth(authValue)) {
+    throw new Error("auth.ts must default-export auth({ ... }) from sidecar-ai.");
+  }
+  return authValue;
+}
+
+function assertProxy(value) {
+  const proxyValue = unwrapRuntimeDefault(value);
+  if (!isSidecarProxy(proxyValue)) {
+    throw new Error("proxy.ts must default-export proxy({ ... }) from @sidecar-ai/server/proxy.");
+  }
+  return proxyValue;
+}
+
+function unwrapRuntimeDefault(value) {
+  if (
+    value &&
+    typeof value === "object" &&
+    "default" in value &&
+    Object.keys(value).length === 1
+  ) {
+    return unwrapRuntimeDefault(value.default);
+  }
+  return value;
+}
+
+function readWidget(outputFile) {
+  return readFileSync(new URL(\`../\${outputFile}\`, import.meta.url), "utf8");
+}
+
+function readPort() {
+  const raw = process.env.PORT ?? process.env.SIDECAR_PORT ?? "3001";
+  const port = Number(raw);
+  if (!Number.isInteger(port) || port < 0 || port > 65535) {
+    throw new Error(\`Invalid PORT/SIDECAR_PORT value: \${raw}\`);
+  }
+  return port;
+}
+
+function isDirectRun() {
+  const entry = process.argv[1];
+  if (!entry) {
+    return false;
+  }
+
+  return import.meta.url === pathToFileURL(realpathSync(entry)).href;
+}
+
+function shutdown() {
+  server.close(() => process.exit(0));
+}
+`;
+}
+function renderWidgetResources(manifest) {
+  return manifest.tools.filter((entry) => entry.widget?.outputFile).map((entry) => `    {
+      uri: ${JSON.stringify(entry.widget?.resourceUri)},
+      name: ${JSON.stringify(entry.name)},
+      description: ${JSON.stringify(entry.widget?.options?.description)},
+      mimeType: "text/html;profile=mcp-app",
+      text: readWidget(${JSON.stringify(entry.widget?.outputFile)}),
+      _meta: ${JSON.stringify(entry.widget?.resourceMeta ?? void 0)},
+    },`).join("\n");
+}
+function renderServerPackage(identity) {
+  return `${JSON.stringify({
+    name: `${identity.slug}-sidecar-server`,
+    version: identity.version,
+    private: true,
+    type: "module",
+    scripts: {
+      start: "node server/index.js"
+    },
+    engines: {
+      node: ">=20"
+    }
+  }, null, 2)}
+`;
+}
+function renderVercelEntrypoint() {
+  return `export { default } from "../server/index.js";
+`;
+}
+function renderVercelConfig() {
+  return `${JSON.stringify({
+    rewrites: [
+      {
+        source: "/(.*)",
+        destination: "/api/sidecar"
+      }
+    ],
+    functions: {
+      "api/sidecar.js": {
+        includeFiles: "public/**",
+        maxDuration: 300
+      }
+    }
+  }, null, 2)}
+`;
+}
+function sidecarBundleAliases(rootDir) {
+  const repoRoot = findSidecarRepoRoot2(rootDir) ?? findSidecarRepoRoot2(process.cwd());
+  if (!repoRoot) {
+    return void 0;
+  }
+  return {
+    "sidecar-ai": path17.join(repoRoot, "packages", "sidecar-ai", "src", "index.ts"),
+    "@sidecar-ai/auth": path17.join(repoRoot, "packages", "auth", "src", "index.ts"),
+    "@sidecar-ai/core": path17.join(repoRoot, "packages", "core", "src", "index.ts"),
+    "@sidecar-ai/server": path17.join(repoRoot, "packages", "server", "src", "index.ts"),
+    "@sidecar-ai/server/proxy": path17.join(repoRoot, "packages", "server", "src", "proxy.ts"),
+    "@sidecar-ai/client": path17.join(repoRoot, "packages", "client", "src", "index.ts"),
+    "@sidecar-ai/react": path17.join(repoRoot, "packages", "react", "src", "index.ts"),
+    "@sidecar-ai/native": path17.join(repoRoot, "packages", "native", "src", "index.ts"),
+    "@sidecar-ai/native/components": path17.join(repoRoot, "packages", "native", "src", "components", "index.tsx"),
+    "@sidecar-ai/openai": path17.join(repoRoot, "packages", "openai", "src", "index.ts"),
+    "@sidecar-ai/openai/components": path17.join(repoRoot, "packages", "openai", "src", "components.tsx"),
+    "@sidecar-ai/openai/official": path17.join(repoRoot, "packages", "openai", "src", "official.ts"),
+    "@sidecar-ai/anthropic": path17.join(repoRoot, "packages", "anthropic", "src", "index.ts"),
+    "@sidecar-ai/anthropic/agent": path17.join(repoRoot, "packages", "anthropic", "src", "agent.ts"),
+    "@sidecar-ai/anthropic/command": path17.join(repoRoot, "packages", "anthropic", "src", "command.ts"),
+    "@sidecar-ai/anthropic/components": path17.join(repoRoot, "packages", "anthropic", "src", "components.tsx"),
+    "@sidecar-ai/anthropic/hooks": path17.join(repoRoot, "packages", "anthropic", "src", "hooks.ts"),
+    "@sidecar-ai/anthropic/mcp": path17.join(repoRoot, "packages", "anthropic", "src", "mcp.ts"),
+    "@sidecar-ai/anthropic/plugin": path17.join(repoRoot, "packages", "anthropic", "src", "plugin.ts"),
+    "@sidecar-ai/anthropic/skill": path17.join(repoRoot, "packages", "anthropic", "src", "skill.ts")
+  };
+}
+function findSidecarRepoRoot2(startDir) {
+  let current = path17.resolve(startDir);
+  while (true) {
+    if (existsSync5(path17.join(current, "packages", "core", "src", "index.ts"))) {
+      return current;
+    }
+    const parent = path17.dirname(current);
+    if (parent === current) {
+      return void 0;
+    }
+    current = parent;
+  }
+}
+
 // packages/compiler/src/build.ts
 async function buildProject(options) {
-  const rootDir = path17.resolve(options.rootDir);
+  const rootDir = path18.resolve(options.rootDir);
   const target = options.target ?? "mcp";
+  const host = options.host ?? "node";
   const config = analyzeProjectConfig(rootDir);
   const tools = await analyzeProjectTools(rootDir, { target });
   const resources = await analyzeProjectResources(rootDir);
   const resourceTemplates = [];
   const prompts = await analyzeProjectPrompts(rootDir);
+  const identity = await loadProjectIdentity(rootDir);
   const diagnostics = await collectProjectDiagnostics(rootDir, {
     tools,
     resources,
@@ -2801,6 +3127,7 @@ async function buildProject(options) {
   const manifest = {
     version: 1,
     target,
+    host,
     rootDir: ".",
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     config,
@@ -2810,23 +3137,24 @@ async function buildProject(options) {
     prompts,
     diagnostics
   };
-  await mkdir8(outDir, { recursive: true });
-  await writeFile8(
-    path17.join(outDir, "manifest.sidecar.json"),
+  await mkdir9(outDir, { recursive: true });
+  await writeFile9(
+    path18.join(outDir, "manifest.sidecar.json"),
     `${JSON.stringify(manifest, null, 2)}
 `
   );
-  await writeFile8(path17.join(outDir, "README.md"), renderMcpReadme(manifest));
+  await writeFile9(path18.join(outDir, "README.md"), renderMcpReadme(manifest));
   await writeGeneratedTypes(rootDir, tools);
+  await buildServerOutput(rootDir, outDir, manifest, identity, host);
   if (options.plugins) {
-    await buildPluginPackages(rootDir, path17.dirname(outDir), manifest);
+    await buildPluginPackages(rootDir, path18.dirname(outDir), manifest);
   }
   return manifest;
 }
 function resolveInsideRoot(rootDir, output) {
-  const resolved = path17.resolve(rootDir, output);
-  const relative = path17.relative(rootDir, resolved);
-  if (relative.startsWith("..") || path17.isAbsolute(relative)) {
+  const resolved = path18.resolve(rootDir, output);
+  const relative = path18.relative(rootDir, resolved);
+  if (relative.startsWith("..") || path18.isAbsolute(relative)) {
     throw new Error(`Build output must stay inside the project root: ${output}`);
   }
   return resolved;
@@ -2851,13 +3179,41 @@ ${resources || "No resources detected."}
 
 ${prompts || "No prompts detected."}
 
+${manifest.host === "vercel" ? renderVercelReadmeSection() : renderNodeReadmeSection()}
+
 ## Local HTTPS Testing
 
-Run \`sidecar dev --tunnel\` from the project root to start the local MCP server on Streamable HTTP and print an HTTPS MCP URL that can be added to ChatGPT, Claude, or a Claude plugin install.
+Run \`sidecar dev --tunnel\` from the project root to start the local MCP server on Streamable HTTP and print a validated HTTPS MCP URL that can be added to ChatGPT, Claude, or a Claude plugin install. Temporary quick tunnels are public and best-effort; use a configured tunnel/domain or deployed preview for repeatable testing.
+`;
+}
+function renderNodeReadmeSection() {
+  return `## Run The Server
+
+This output includes a standalone Node MCP server. Start it with:
+
+\`\`\`sh
+npm start
+\`\`\`
+
+or:
+
+\`\`\`sh
+node server/index.js
+\`\`\`
+
+Set \`PORT\` or \`SIDECAR_PORT\` to choose the listen port. Hosted/authenticated MCPs should set \`SIDECAR_MCP_URL\` to the public \`https://.../mcp\` URL before starting.
+`;
+}
+function renderVercelReadmeSection() {
+  return `## Deploy To Vercel
+
+This output includes a Vercel Function shim at \`api/sidecar.js\` and a \`vercel.json\` rewrite that sends Streamable HTTP traffic to \`/mcp\`. Deploy this output directory with Vercel and set \`SIDECAR_MCP_URL\` to the public \`https://.../mcp\` URL.
 `;
 }
 export {
   CompilerError,
+  SERVER_ENTRYPOINT,
+  VERCEL_ENTRYPOINT,
   analyzeProjectConfig,
   analyzeProjectPrompts,
   analyzeProjectResources,