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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { SourceFile } from 'ts-morph';
-import { JsonSchema, ToolAnnotations, ToolVisibility, ToolWidgetOptions, McpToolDescriptor, ResourceAnnotations, McpResourceDescriptor, McpResourceTemplateDescriptor, PromptArgsDefinition, McpPromptDescriptor } from '@sidecar-ai/core';
+import { BuildHost, BuildTarget, JsonSchema, ToolAnnotations, ToolVisibility, ToolWidgetOptions, McpToolDescriptor, ResourceAnnotations, McpResourceDescriptor, McpResourceTemplateDescriptor, PromptArgsDefinition, McpPromptDescriptor } from '@sidecar-ai/core';
 
 /** Diagnostic severity surfaced by the CLI and future editor integrations. */
 type DiagnosticSeverity = "warning" | "error";
@@ -26,9 +26,9 @@ declare function formatDiagnostic(diagnostic: SidecarDiagnostic): string;
 /** Manifest and option types shared across the Sidecar compiler modules. */
 
 /** Build target profile selected by reserved platform file suffixes. */
-type SidecarTarget = "mcp" | "chatgpt" | "claude";
+type SidecarTarget = BuildTarget;
 /** Host runtime artifact emitted for a build output. */
-type SidecarHost = "node" | "vercel";
+type SidecarHost = BuildHost;
 /** Platform suffix chosen for a reserved tool or widget file. */
 type SidecarSourceVariant = "shared" | "openai" | "anthropic";
 /** Tool entry emitted into `manifest.sidecar.json`. */
@@ -92,6 +92,12 @@ type SidecarPromptManifestEntry = {
 };
 /** Serializable project config subset recorded in build manifests. */
 type SidecarCompilerConfig = {
+    build: {
+        target?: SidecarTarget;
+        host?: SidecarHost;
+        outDir?: string;
+        plugins?: boolean;
+    };
     resources: {
         subscribe: boolean;
         listChanged: boolean;
@@ -178,7 +184,7 @@ declare function analyzeResourceFile(sourceFile: SourceFile, rootDir: string): S
 
 /** 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";
+/** Relative location of the Vercel Build Output API function entrypoint. */
+declare const VERCEL_ENTRYPOINT = "functions/api/sidecar.func/index.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

@@ -1504,6 +1504,12 @@ function analyzeProjectConfig(rootDir) {
     return defaultCompilerConfig();
   }
   return {
+    build: {
+      target: readTargetNested(definition, "build", "target"),
+      host: readHostNested(definition, "build", "host"),
+      outDir: readStringNested(definition, "build", "outDir"),
+      plugins: readBooleanNested(definition, "build", "plugins")
+    },
     resources: {
       subscribe: readBooleanNested(definition, "resources", "subscribe") ?? false,
       listChanged: readBooleanNested(definition, "resources", "listChanged") ?? false
@@ -1522,6 +1528,7 @@ function analyzeProjectConfig(rootDir) {
 }
 function defaultCompilerConfig() {
   return {
+    build: {},
     resources: {
       subscribe: false,
       listChanged: false
@@ -1538,6 +1545,26 @@ function defaultCompilerConfig() {
     }
   };
 }
+function readTargetNested(definition, section, propertyName) {
+  const value = readStringNested(definition, section, propertyName);
+  return value === "mcp" || value === "chatgpt" || value === "claude" ? value : void 0;
+}
+function readHostNested(definition, section, propertyName) {
+  const value = readStringNested(definition, section, propertyName);
+  return value === "node" || value === "vercel" ? value : void 0;
+}
+function readStringNested(definition, section, propertyName) {
+  const object = readObjectProperty3(definition, section);
+  if (!object) {
+    return void 0;
+  }
+  const property = object.getProperty(propertyName);
+  if (!property || !Node5.isPropertyAssignment(property)) {
+    return void 0;
+  }
+  const initializer = unwrapExpression(property.getInitializer());
+  return initializer && Node5.isStringLiteral(initializer) ? initializer.getLiteralText() : void 0;
+}
 function readBooleanNested(definition, section, propertyName) {
   const object = readObjectProperty3(definition, section);
   if (!object) {
@@ -2805,8 +2832,10 @@ 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") {
+var VERCEL_FUNCTION_DIR = "functions/api/sidecar.func";
+var VERCEL_ENTRYPOINT = `${VERCEL_FUNCTION_DIR}/index.js`;
+var VERCEL_HANDLER_FILE = "index.js";
+async function buildServerOutput(rootDir, outDir, manifest, identity, host = "node", options = {}) {
   const cacheDir = path17.join(rootDir, ".sidecar", "cache", "server");
   await mkdir8(cacheDir, { recursive: true });
   const entryFile = path17.join(cacheDir, "index.ts");
@@ -2836,9 +2865,13 @@ const require = __sidecarCreateRequire(import.meta.url);`
   });
   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());
+    const vercelOutputDir = options.vercelOutputDir ?? outDir;
+    await rm(path17.join(vercelOutputDir, "api"), { recursive: true, force: true });
+    await rm(path17.join(vercelOutputDir, "vercel.json"), { force: true });
+    await writeFile8(path17.join(outDir, VERCEL_HANDLER_FILE), renderVercelEntrypoint());
+    await writeFile8(path17.join(outDir, ".vc-config.json"), renderVercelFunctionConfig());
+    await mkdir8(vercelOutputDir, { recursive: true });
+    await writeFile8(path17.join(vercelOutputDir, "config.json"), renderVercelOutputConfig());
   } else {
     await rm(path17.join(outDir, "api"), { recursive: true, force: true });
     await rm(path17.join(outDir, "vercel.json"), { force: true });
@@ -3039,23 +3072,29 @@ function renderServerPackage(identity) {
 `;
 }
 function renderVercelEntrypoint() {
-  return `export { default } from "../server/index.js";
+  return `export { default } from "./server/index.js";
 `;
 }
-function renderVercelConfig() {
+function renderVercelFunctionConfig() {
   return `${JSON.stringify({
-    rewrites: [
+    runtime: "nodejs22.x",
+    handler: VERCEL_HANDLER_FILE,
+    launcherType: "Nodejs",
+    shouldAddHelpers: true,
+    supportsResponseStreaming: true,
+    maxDuration: 300
+  }, null, 2)}
+`;
+}
+function renderVercelOutputConfig() {
+  return `${JSON.stringify({
+    version: 3,
+    routes: [
       {
-        source: "/(.*)",
-        destination: "/api/sidecar"
-      }
-    ],
-    functions: {
-      "api/sidecar.js": {
-        includeFiles: "public/**",
-        maxDuration: 300
+        src: "/(.*)",
+        dest: "/api/sidecar"
       }
-    }
+    ]
   }, null, 2)}
 `;
 }
@@ -3104,9 +3143,10 @@ function findSidecarRepoRoot2(startDir) {
 // packages/compiler/src/build.ts
 async function buildProject(options) {
   const rootDir = path18.resolve(options.rootDir);
-  const target = options.target ?? "mcp";
-  const host = options.host ?? "node";
   const config = analyzeProjectConfig(rootDir);
+  const target = options.target ?? config.build.target ?? "mcp";
+  const host = options.host ?? config.build.host ?? "node";
+  const plugins = options.plugins ?? config.build.plugins ?? false;
   const tools = await analyzeProjectTools(rootDir, { target });
   const resources = await analyzeProjectResources(rootDir);
   const resourceTemplates = [];
@@ -3122,8 +3162,9 @@ async function buildProject(options) {
   if (errors.length) {
     throw new Error(errors.map(formatDiagnostic).join("\n"));
   }
-  const outDir = resolveInsideRoot(rootDir, options.outDir ?? "out/mcp");
-  await buildWidgets(rootDir, outDir, tools);
+  const outDir = resolveInsideRoot(rootDir, options.outDir ?? config.build.outDir ?? defaultBuildOutDir(host, target));
+  const runtimeOutDir = resolveRuntimeOutputDir(outDir, host);
+  await buildWidgets(rootDir, runtimeOutDir, tools);
   const manifest = {
     version: 1,
     target,
@@ -3137,20 +3178,43 @@ async function buildProject(options) {
     prompts,
     diagnostics
   };
-  await mkdir9(outDir, { recursive: true });
+  await mkdir9(runtimeOutDir, { recursive: true });
   await writeFile9(
-    path18.join(outDir, "manifest.sidecar.json"),
+    path18.join(runtimeOutDir, "manifest.sidecar.json"),
     `${JSON.stringify(manifest, null, 2)}
 `
   );
-  await writeFile9(path18.join(outDir, "README.md"), renderMcpReadme(manifest));
+  await writeFile9(path18.join(runtimeOutDir, "README.md"), renderMcpReadme(manifest));
   await writeGeneratedTypes(rootDir, tools);
-  await buildServerOutput(rootDir, outDir, manifest, identity, host);
-  if (options.plugins) {
-    await buildPluginPackages(rootDir, path18.dirname(outDir), manifest);
+  await buildServerOutput(rootDir, runtimeOutDir, manifest, identity, host, {
+    vercelOutputDir: outDir
+  });
+  if (plugins) {
+    await buildPluginPackages(rootDir, resolvePluginOutputBase(rootDir, outDir, host), manifest);
   }
   return manifest;
 }
+function defaultBuildOutDir(host, target) {
+  if (host === "vercel") {
+    return ".vercel/output";
+  }
+  return `out/${target}`;
+}
+function resolveRuntimeOutputDir(outDir, host) {
+  if (host === "vercel") {
+    return path18.join(outDir, VERCEL_FUNCTION_DIR);
+  }
+  return outDir;
+}
+function resolvePluginOutputBase(rootDir, outDir, host) {
+  if (host === "vercel" && isVercelBuildOutputDir(outDir)) {
+    return path18.join(rootDir, "out");
+  }
+  return path18.dirname(outDir);
+}
+function isVercelBuildOutputDir(outDir) {
+  return path18.basename(outDir) === "output" && path18.basename(path18.dirname(outDir)) === ".vercel";
+}
 function resolveInsideRoot(rootDir, output) {
   const resolved = path18.resolve(rootDir, output);
   const relative = path18.relative(rootDir, resolved);
@@ -3207,7 +3271,7 @@ Set \`PORT\` or \`SIDECAR_PORT\` to choose the listen port. Hosted/authenticated
 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.
+This output uses Vercel's Build Output API. The MCP function is emitted at \`${VERCEL_FUNCTION_DIR}\`, and \`config.json\` routes Streamable HTTP traffic to it. Set \`SIDECAR_MCP_URL\` to the public \`https://.../mcp\` URL in Vercel.
 `;
 }
 export {