frontmcp 1.4.1 → 1.5.0-rc.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontmcp",
-  "version": "1.4.1",
+  "version": "1.5.0-rc.1",
   "description": "FrontMCP command line interface",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -29,14 +29,14 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
-    "@frontmcp/lazy-zod": "1.4.1",
-    "@frontmcp/skills": "1.4.1",
-    "@frontmcp/utils": "1.4.1",
+    "@frontmcp/lazy-zod": "1.5.0-rc.1",
+    "@frontmcp/skills": "1.5.0-rc.1",
+    "@frontmcp/utils": "1.5.0-rc.1",
     "@rspack/core": "^1.7.6",
     "commander": "^13.0.0",
     "esbuild": "^0.27.3",
     "tslib": "^2.3.0",
-    "vectoriadb": "^2.2.0",
+    "vectoriadb": "^2.3.2",
     "yauzl": "^3.2.0",
     "yazl": "^3.3.1"
   },

package/src/commands/build/adapters/cloudflare.d.ts

@@ -1,7 +1,16 @@
 import type { AdapterTemplate } from '../types';
 /**
  * Cloudflare Workers adapter - edge deployment on Cloudflare.
- * Compiles to CommonJS and adapts the Express app to Cloudflare's fetch API.
+ * Compiles to an ES Module Worker that routes the native Web `Request` into the
+ * SDK's web-fetch handler (`getServerlessHandlerAsync` in worker mode) — no
+ * Express, no Node `req`/`res` shim.
+ *
+ * NOTE: this decorator-build path does NOT emit KV / Durable Object / R2 / D1
+ * bindings or `[triggers] crontabs` into `wrangler.toml`, and the entry passes
+ * only the `Request` to the handler (not `env`/`ctx`). Workers needing bindings
+ * or the managed auto-update Cron (`scheduled`) should use `@frontmcp/edge`
+ * `createEdgeMcp` with a hand-written `wrangler.toml`. See
+ * docs/frontmcp/deployment/cloudflare-worker.mdx.
  *
  * @see https://developers.cloudflare.com/workers/
  */

package/src/commands/build/adapters/cloudflare.js

@@ -3,73 +3,56 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.cloudflareAdapter = void 0;
 /**
  * Cloudflare Workers adapter - edge deployment on Cloudflare.
- * Compiles to CommonJS and adapts the Express app to Cloudflare's fetch API.
+ * Compiles to an ES Module Worker that routes the native Web `Request` into the
+ * SDK's web-fetch handler (`getServerlessHandlerAsync` in worker mode) — no
+ * Express, no Node `req`/`res` shim.
+ *
+ * NOTE: this decorator-build path does NOT emit KV / Durable Object / R2 / D1
+ * bindings or `[triggers] crontabs` into `wrangler.toml`, and the entry passes
+ * only the `Request` to the handler (not `env`/`ctx`). Workers needing bindings
+ * or the managed auto-update Cron (`scheduled`) should use `@frontmcp/edge`
+ * `createEdgeMcp` with a hand-written `wrangler.toml`. See
+ * docs/frontmcp/deployment/cloudflare-worker.mdx.
  *
  * @see https://developers.cloudflare.com/workers/
  */
 exports.cloudflareAdapter = {
-    moduleFormat: 'commonjs',
-    getEntryTemplate: (mainModulePath) => `// Auto-generated Cloudflare Workers entry point
-// Generated by: frontmcp build --target cloudflare
+    // ES Module format — modern Cloudflare Workers (and `nodejs_compat`) require
+    // the Module Worker shape (`export default { fetch }`). The legacy CommonJS
+    // `module.exports` is interpreted as a Service Worker, where `nodejs_compat`
+    // cannot externalize Node builtins and the build fails.
+    moduleFormat: 'esnext',
+    // Emitted as `serverless-setup.js` and imported FIRST by the entry, so the
+    // env flags are set before the user module's `@FrontMcp` decorator evaluates
+    // (ESM import evaluation is ordered, and the decorator reads these at import
+    // time). FRONTMCP_WORKER selects FrontMCP's Web-standard fetch handler.
+    getSetupTemplate: () => `// Auto-generated — sets env before the @FrontMcp decorator runs.
 process.env.FRONTMCP_SERVERLESS = '1';
 process.env.FRONTMCP_DEPLOYMENT_MODE = 'serverless';
+process.env.FRONTMCP_WORKER = '1';
+`,
+    getEntryTemplate: (mainModulePath) => `// Auto-generated Cloudflare Workers entry point (ES Module / Module Worker).
+// Generated by: frontmcp build --target cloudflare
+//
+// The Worker receives the native Web Request and the SDK routes it straight
+// into the MCP WebStandard transport (Request/Response). No Express, no Node
+// req/res shim.
+import './serverless-setup.js';
+import '${mainModulePath}';
+import { getServerlessHandlerAsync } from '@frontmcp/sdk';
 
-require('${mainModulePath}');
-const { getServerlessHandlerAsync } = require('@frontmcp/sdk');
-
-let app = null;
-
-async function handleRequest(request) {
-  if (!app) {
-    app = await getServerlessHandlerAsync();
-  }
-
-  // Convert Cloudflare Request to Node.js format
-  const url = new URL(request.url);
-  const req = {
-    method: request.method,
-    url: url.pathname + url.search,
-    headers: Object.fromEntries(request.headers),
-    body: request.body,
-  };
-
-  return new Promise((resolve) => {
-    const res = {
-      statusCode: 200,
-      headers: {},
-      body: '',
-      status(code) { this.statusCode = code; return this; },
-      setHeader(key, value) { this.headers[key] = value; },
-      json(data) {
-        this.headers['Content-Type'] = 'application/json';
-        this.body = JSON.stringify(data);
-        resolve(new Response(this.body, {
-          status: this.statusCode,
-          headers: this.headers,
-        }));
-      },
-      send(data) {
-        this.body = data;
-        resolve(new Response(this.body, {
-          status: this.statusCode,
-          headers: this.headers,
-        }));
-      },
-      end() {
-        resolve(new Response(this.body, {
-          status: this.statusCode,
-          headers: this.headers,
-        }));
-      },
-    };
-    app(req, res);
-  });
-}
+let handlerPromise = null;
 
-module.exports = {
+export default {
   async fetch(request, env, ctx) {
-    return handleRequest(request);
-  }
+    if (!handlerPromise) {
+      handlerPromise = getServerlessHandlerAsync();
+    }
+    // In worker mode the stored handler is a Web fetch handler:
+    // (Request) => Promise<Response>.
+    const handler = await handlerPromise;
+    return handler(request);
+  },
 };
 `,
     // #375 — fail the build when the user's @FrontMcp config references
@@ -116,16 +99,28 @@ module.exports = {
     // wrangler deploy silently failed.
     alwaysWriteConfig: true,
     // #374 round-2 — merge `frontmcp.config.deployments[].wrangler.{name,
-    // compatibilityDate}` into the rendered TOML so values declared in the
-    // user's config actually reach `wrangler deploy`. Defaults preserved when
-    // the field is absent or no deployment was matched.
+    // compatibilityDate, compatibilityFlags}` into the rendered TOML so values
+    // declared in the user's config actually reach `wrangler deploy`. Defaults
+    // preserved when the field is absent or no deployment was matched.
     getConfig: (_cwd, deployment) => {
         const wrangler = deployment?.wrangler ?? {};
         const name = wrangler.name ?? 'frontmcp-worker';
-        const compatibilityDate = wrangler.compatibilityDate ?? '2024-01-01';
+        // The cloudflare entry (getEntryTemplate) is an ES Module that imports the
+        // SDK's web-fetch handler, which still transitively pulls in Node builtins
+        // (node:*, Buffer, process, streams) through the SDK runtime. On Workers
+        // those exist ONLY behind the `nodejs_compat` flag — without it the Worker
+        // fails to even load. The flag is therefore non-negotiable for this target;
+        // we always emit it and merge in any extra flags the user declared (deduped,
+        // `nodejs_compat` guaranteed first).
+        const flags = Array.from(new Set(['nodejs_compat', ...(wrangler.compatibilityFlags ?? [])]));
+        // `nodejs_compat` only provides the full Node API surface (incl. `require`
+        // of builtins) when compatibility_date >= 2024-09-23; default to that so a
+        // freshly-built worker boots. Users can still pin an older/newer date.
+        const compatibilityDate = wrangler.compatibilityDate ?? '2024-09-23';
         return `name = "${name}"
 main = "dist/cloudflare/index.js"
 compatibility_date = "${compatibilityDate}"
+compatibility_flags = [${flags.map((f) => `"${f}"`).join(', ')}]
 `;
     },
     configFileName: 'wrangler.toml',

package/src/commands/build/adapters/cloudflare.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/cloudflare.ts"],"names":[],"mappings":";;;AAGA;;;;;GAKG;AACU,QAAA,iBAAiB,GAAoB;IAChD,YAAY,EAAE,UAAU;IAExB,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;;;WAKrC,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDxB;IAEC,oEAAoE;IACpE,yDAAyD;IACzD,EAAE;IACF,6EAA6E;IAC7E,8EAA8E;IAC9E,4EAA4E;IAC5E,0EAA0E;IAC1E,0EAA0E;IAC1E,8EAA8E;IAC9E,6EAA6E;IAC7E,4EAA4E;IAC5E,iDAAiD;IACjD,QAAQ,EAAE,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE;QAClC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,MAAM,eAAe,GACnB,eAAe,EAAE,CAAC,QAAQ,CAAC,KAAK,SAAS;YACzC,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAK,QAAQ;YAC7C,eAAe,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;QACrC,MAAM,cAAc,GAClB,eAAe,EAAE,CAAC,OAAO,CAAC,KAAK,SAAS;YACxC,OAAO,eAAe,CAAC,OAAO,CAAC,KAAK,QAAQ;YAC5C,eAAe,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;QACpC,MAAM,UAAU,GAAG,eAAe,IAAI,CAAC,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnF,MAAM,SAAS,GAAG,cAAc,IAAI,CAAC,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEhF,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,8FAA8F;gBAC5F,0FAA0F;gBAC1F,uFAAuF;gBACvF,gFAAgF,CACnF,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CACT,uFAAuF;gBACrF,yFAAyF;gBACzF,uFAAuF;gBACvF,gFAAgF,CACnF,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,2EAA2E,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CACnG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAC1E,sEAAsE;IACtE,mCAAmC;IACnC,iBAAiB,EAAE,IAAI;IAEvB,sEAAsE;IACtE,uEAAuE;IACvE,0EAA0E;IAC1E,oDAAoD;IACpD,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE;QAC9B,MAAM,QAAQ,GAAI,UAA+C,EAAE,QAAQ,IAAI,EAAE,CAAC;QAClF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,iBAAiB,CAAC;QAChD,MAAM,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,IAAI,YAAY,CAAC;QACrE,OAAO,WAAW,IAAI;;wBAEF,iBAAiB;CACxC,CAAC;IACA,CAAC;IAED,cAAc,EAAE,eAAe;CAChC,CAAC","sourcesContent":["import type { CloudflareDeployment } from '../../../config/frontmcp-config.types';\nimport type { AdapterTemplate } from '../types';\n\n/**\n * Cloudflare Workers adapter - edge deployment on Cloudflare.\n * Compiles to CommonJS and adapts the Express app to Cloudflare's fetch API.\n *\n * @see https://developers.cloudflare.com/workers/\n */\nexport const cloudflareAdapter: AdapterTemplate = {\n  moduleFormat: 'commonjs',\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated Cloudflare Workers entry point\n// Generated by: frontmcp build --target cloudflare\nprocess.env.FRONTMCP_SERVERLESS = '1';\nprocess.env.FRONTMCP_DEPLOYMENT_MODE = 'serverless';\n\nrequire('${mainModulePath}');\nconst { getServerlessHandlerAsync } = require('@frontmcp/sdk');\n\nlet app = null;\n\nasync function handleRequest(request) {\n  if (!app) {\n    app = await getServerlessHandlerAsync();\n  }\n\n  // Convert Cloudflare Request to Node.js format\n  const url = new URL(request.url);\n  const req = {\n    method: request.method,\n    url: url.pathname + url.search,\n    headers: Object.fromEntries(request.headers),\n    body: request.body,\n  };\n\n  return new Promise((resolve) => {\n    const res = {\n      statusCode: 200,\n      headers: {},\n      body: '',\n      status(code) { this.statusCode = code; return this; },\n      setHeader(key, value) { this.headers[key] = value; },\n      json(data) {\n        this.headers['Content-Type'] = 'application/json';\n        this.body = JSON.stringify(data);\n        resolve(new Response(this.body, {\n          status: this.statusCode,\n          headers: this.headers,\n        }));\n      },\n      send(data) {\n        this.body = data;\n        resolve(new Response(this.body, {\n          status: this.statusCode,\n          headers: this.headers,\n        }));\n      },\n      end() {\n        resolve(new Response(this.body, {\n          status: this.statusCode,\n          headers: this.headers,\n        }));\n      },\n    };\n    app(req, res);\n  });\n}\n\nmodule.exports = {\n  async fetch(request, env, ctx) {\n    return handleRequest(request);\n  }\n};\n`,\n\n  // #375 — fail the build when the user's @FrontMcp config references\n  // Node-only storage providers that can't run on Workers.\n  //\n  // Round 1 only inspected the runtime-evaluated config object. The reporter's\n  // failure case was `sqlite: process.env.REDIS_HOST ? {…} : { sqlite: {…} }` —\n  // a ternary that may evaluate to `undefined` at decorator-load time (so the\n  // runtime check sees nothing) but still ships the Node-only branch in the\n  // bundled worker. Round 2 also inspects `info.keysSeenInSource`, which is\n  // collected by walking the @FrontMcp({...}) source expression — that captures\n  // the property name regardless of whether its value is a literal, a ternary,\n  // or a function call. If `sqlite`/`redis` appear at all, fail loud and tell\n  // the user how to gate them at the source level.\n  validate: (decoratorConfig, info) => {\n    const errors: string[] = [];\n\n    const sqliteIsLiteral =\n      decoratorConfig?.['sqlite'] !== undefined &&\n      typeof decoratorConfig['sqlite'] === 'object' &&\n      decoratorConfig['sqlite'] !== null;\n    const redisIsLiteral =\n      decoratorConfig?.['redis'] !== undefined &&\n      typeof decoratorConfig['redis'] === 'object' &&\n      decoratorConfig['redis'] !== null;\n    const sqliteSeen = sqliteIsLiteral || !!info?.keysSeenInSource?.includes('sqlite');\n    const redisSeen = redisIsLiteral || !!info?.keysSeenInSource?.includes('redis');\n\n    if (sqliteSeen) {\n      errors.push(\n        'sqlite storage is not supported on --target cloudflare (no fs / native modules on Workers). ' +\n          'Even an env-gated `sqlite: process.env.X ? {...} : undefined` still ships the Node-only ' +\n          'branch in the worker bundle. Use Cloudflare KV / Durable Objects, or move the sqlite ' +\n          'config behind a build-time `define` so the bundler can dead-code-eliminate it.',\n      );\n    }\n    if (redisSeen) {\n      errors.push(\n        'ioredis-style `redis` storage is not supported on --target cloudflare (no Node net). ' +\n          'Even an env-gated `redis: process.env.X ? {...} : undefined` still ships the Node-only ' +\n          'branch in the worker bundle. Use Vercel KV / Upstash Redis (HTTP), or move the redis ' +\n          'config behind a build-time `define` so the bundler can dead-code-eliminate it.',\n      );\n    }\n    if (errors.length) {\n      throw new Error(\n        `[--target cloudflare] config incompatible with Cloudflare Workers:\\n  - ${errors.join('\\n  - ')}`,\n      );\n    }\n  },\n\n  // #374 — always write wrangler.toml from the build output. Skipping when\n  // the file already exists left users with a wrangler.toml that pointed at\n  // dist/index.js while the build emitted dist/cloudflare/index.js, and\n  // wrangler deploy silently failed.\n  alwaysWriteConfig: true,\n\n  // #374 round-2 — merge `frontmcp.config.deployments[].wrangler.{name,\n  // compatibilityDate}` into the rendered TOML so values declared in the\n  // user's config actually reach `wrangler deploy`. Defaults preserved when\n  // the field is absent or no deployment was matched.\n  getConfig: (_cwd, deployment) => {\n    const wrangler = (deployment as CloudflareDeployment | undefined)?.wrangler ?? {};\n    const name = wrangler.name ?? 'frontmcp-worker';\n    const compatibilityDate = wrangler.compatibilityDate ?? '2024-01-01';\n    return `name = \"${name}\"\nmain = \"dist/cloudflare/index.js\"\ncompatibility_date = \"${compatibilityDate}\"\n`;\n  },\n\n  configFileName: 'wrangler.toml',\n};\n"]}
+{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/cloudflare.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CloudflareDeployment } from '../../../config/frontmcp-config.types';\nimport type { AdapterTemplate } from '../types';\n\n/**\n * Cloudflare Workers adapter - edge deployment on Cloudflare.\n * Compiles to an ES Module Worker that routes the native Web `Request` into the\n * SDK's web-fetch handler (`getServerlessHandlerAsync` in worker mode) — no\n * Express, no Node `req`/`res` shim.\n *\n * NOTE: this decorator-build path does NOT emit KV / Durable Object / R2 / D1\n * bindings or `[triggers] crontabs` into `wrangler.toml`, and the entry passes\n * only the `Request` to the handler (not `env`/`ctx`). Workers needing bindings\n * or the managed auto-update Cron (`scheduled`) should use `@frontmcp/edge`\n * `createEdgeMcp` with a hand-written `wrangler.toml`. See\n * docs/frontmcp/deployment/cloudflare-worker.mdx.\n *\n * @see https://developers.cloudflare.com/workers/\n */\nexport const cloudflareAdapter: AdapterTemplate = {\n  // ES Module format — modern Cloudflare Workers (and `nodejs_compat`) require\n  // the Module Worker shape (`export default { fetch }`). The legacy CommonJS\n  // `module.exports` is interpreted as a Service Worker, where `nodejs_compat`\n  // cannot externalize Node builtins and the build fails.\n  moduleFormat: 'esnext',\n\n  // Emitted as `serverless-setup.js` and imported FIRST by the entry, so the\n  // env flags are set before the user module's `@FrontMcp` decorator evaluates\n  // (ESM import evaluation is ordered, and the decorator reads these at import\n  // time). FRONTMCP_WORKER selects FrontMCP's Web-standard fetch handler.\n  getSetupTemplate: () => `// Auto-generated — sets env before the @FrontMcp decorator runs.\nprocess.env.FRONTMCP_SERVERLESS = '1';\nprocess.env.FRONTMCP_DEPLOYMENT_MODE = 'serverless';\nprocess.env.FRONTMCP_WORKER = '1';\n`,\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated Cloudflare Workers entry point (ES Module / Module Worker).\n// Generated by: frontmcp build --target cloudflare\n//\n// The Worker receives the native Web Request and the SDK routes it straight\n// into the MCP WebStandard transport (Request/Response). No Express, no Node\n// req/res shim.\nimport './serverless-setup.js';\nimport '${mainModulePath}';\nimport { getServerlessHandlerAsync } from '@frontmcp/sdk';\n\nlet handlerPromise = null;\n\nexport default {\n  async fetch(request, env, ctx) {\n    if (!handlerPromise) {\n      handlerPromise = getServerlessHandlerAsync();\n    }\n    // In worker mode the stored handler is a Web fetch handler:\n    // (Request) => Promise<Response>.\n    const handler = await handlerPromise;\n    return handler(request);\n  },\n};\n`,\n\n  // #375 — fail the build when the user's @FrontMcp config references\n  // Node-only storage providers that can't run on Workers.\n  //\n  // Round 1 only inspected the runtime-evaluated config object. The reporter's\n  // failure case was `sqlite: process.env.REDIS_HOST ? {…} : { sqlite: {…} }` —\n  // a ternary that may evaluate to `undefined` at decorator-load time (so the\n  // runtime check sees nothing) but still ships the Node-only branch in the\n  // bundled worker. Round 2 also inspects `info.keysSeenInSource`, which is\n  // collected by walking the @FrontMcp({...}) source expression — that captures\n  // the property name regardless of whether its value is a literal, a ternary,\n  // or a function call. If `sqlite`/`redis` appear at all, fail loud and tell\n  // the user how to gate them at the source level.\n  validate: (decoratorConfig, info) => {\n    const errors: string[] = [];\n\n    const sqliteIsLiteral =\n      decoratorConfig?.['sqlite'] !== undefined &&\n      typeof decoratorConfig['sqlite'] === 'object' &&\n      decoratorConfig['sqlite'] !== null;\n    const redisIsLiteral =\n      decoratorConfig?.['redis'] !== undefined &&\n      typeof decoratorConfig['redis'] === 'object' &&\n      decoratorConfig['redis'] !== null;\n    const sqliteSeen = sqliteIsLiteral || !!info?.keysSeenInSource?.includes('sqlite');\n    const redisSeen = redisIsLiteral || !!info?.keysSeenInSource?.includes('redis');\n\n    if (sqliteSeen) {\n      errors.push(\n        'sqlite storage is not supported on --target cloudflare (no fs / native modules on Workers). ' +\n          'Even an env-gated `sqlite: process.env.X ? {...} : undefined` still ships the Node-only ' +\n          'branch in the worker bundle. Use Cloudflare KV / Durable Objects, or move the sqlite ' +\n          'config behind a build-time `define` so the bundler can dead-code-eliminate it.',\n      );\n    }\n    if (redisSeen) {\n      errors.push(\n        'ioredis-style `redis` storage is not supported on --target cloudflare (no Node net). ' +\n          'Even an env-gated `redis: process.env.X ? {...} : undefined` still ships the Node-only ' +\n          'branch in the worker bundle. Use Vercel KV / Upstash Redis (HTTP), or move the redis ' +\n          'config behind a build-time `define` so the bundler can dead-code-eliminate it.',\n      );\n    }\n    if (errors.length) {\n      throw new Error(\n        `[--target cloudflare] config incompatible with Cloudflare Workers:\\n  - ${errors.join('\\n  - ')}`,\n      );\n    }\n  },\n\n  // #374 — always write wrangler.toml from the build output. Skipping when\n  // the file already exists left users with a wrangler.toml that pointed at\n  // dist/index.js while the build emitted dist/cloudflare/index.js, and\n  // wrangler deploy silently failed.\n  alwaysWriteConfig: true,\n\n  // #374 round-2 — merge `frontmcp.config.deployments[].wrangler.{name,\n  // compatibilityDate, compatibilityFlags}` into the rendered TOML so values\n  // declared in the user's config actually reach `wrangler deploy`. Defaults\n  // preserved when the field is absent or no deployment was matched.\n  getConfig: (_cwd, deployment) => {\n    const wrangler = (deployment as CloudflareDeployment | undefined)?.wrangler ?? {};\n    const name = wrangler.name ?? 'frontmcp-worker';\n    // The cloudflare entry (getEntryTemplate) is an ES Module that imports the\n    // SDK's web-fetch handler, which still transitively pulls in Node builtins\n    // (node:*, Buffer, process, streams) through the SDK runtime. On Workers\n    // those exist ONLY behind the `nodejs_compat` flag — without it the Worker\n    // fails to even load. The flag is therefore non-negotiable for this target;\n    // we always emit it and merge in any extra flags the user declared (deduped,\n    // `nodejs_compat` guaranteed first).\n    const flags = Array.from(new Set(['nodejs_compat', ...(wrangler.compatibilityFlags ?? [])]));\n    // `nodejs_compat` only provides the full Node API surface (incl. `require`\n    // of builtins) when compatibility_date >= 2024-09-23; default to that so a\n    // freshly-built worker boots. Users can still pin an older/newer date.\n    const compatibilityDate = wrangler.compatibilityDate ?? '2024-09-23';\n    return `name = \"${name}\"\nmain = \"dist/cloudflare/index.js\"\ncompatibility_date = \"${compatibilityDate}\"\ncompatibility_flags = [${flags.map((f) => `\"${f}\"`).join(', ')}]\n`;\n  },\n\n  configFileName: 'wrangler.toml',\n};\n"]}

package/src/commands/build/index.js

@@ -263,6 +263,14 @@ async function runAdapterBuild(opts, adapter, deployment) {
         args.push('--target', tsconfig_1.REQUIRED_DECORATOR_FIELDS.target);
     }
     args.push('--module', moduleFormat);
+    // `--module esnext` defaults `moduleResolution` to `classic`, which can't
+    // resolve bare specifiers like `@frontmcp/sdk` (package.json `exports`). Use
+    // `bundler` resolution — it mirrors how wrangler/esbuild resolve the worker
+    // bundle and keeps the ESM (Module Worker) target building. `commonjs`
+    // already defaults to node resolution, so only the ESM path needs this.
+    if (moduleFormat === 'esnext') {
+        args.push('--moduleResolution', 'bundler');
+    }
     args.push('--outDir', outDir);
     args.push('--skipLibCheck');
     await (0, utils_1.runCmd)('npx', args);

package/src/commands/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/build/index.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport { type ParsedArgs } from '../../core/args';\nimport { c } from '../../core/colors';\nimport { ensureDir, fileExists, runCmd, writeJSON } from '@frontmcp/utils';\nimport { fsp, resolveEntry } from '../../shared/fs';\nimport { REQUIRED_DECORATOR_FIELDS } from '../../core/tsconfig';\nimport { ADAPTERS } from './adapters';\nimport { type AdapterName } from './types';\nimport { bundleForServerless } from './bundler';\nimport {\n  type DeploymentTarget,\n  findDeployment,\n  type FrontMcpConfigParsed,\n  getDeploymentTargets,\n  tryLoadFrontMcpConfig,\n} from '../../config';\n\nfunction isTsLike(p: string): boolean {\n  return /\\.tsx?$/i.test(p);\n}\n\n/**\n * Generate adapter-specific entry point and config files.\n */\nasync function generateAdapterFiles(\n  adapter: AdapterName,\n  outDir: string,\n  entryBasename: string,\n  cwd: string,\n  deployment?: DeploymentTarget,\n): Promise<void> {\n  const template = ADAPTERS[adapter];\n\n  // Generate serverless setup file first (if adapter has one)\n  // This file sets FRONTMCP_SERVERLESS=1 before any imports run\n  if (template.getSetupTemplate) {\n    const setupContent = template.getSetupTemplate();\n    const setupPath = path.join(outDir, 'serverless-setup.js');\n    await fsp.writeFile(setupPath, setupContent, 'utf8');\n    console.log(c('green', `  Generated serverless setup at ${path.relative(cwd, setupPath)}`));\n  }\n\n  // Generate index.js entry point\n  const mainModuleName = entryBasename.replace(/\\.tsx?$/, '.js');\n  const entryContent = template.getEntryTemplate(`./${mainModuleName}`);\n\n  // Skip if no entry template (e.g., node adapter)\n  if (entryContent) {\n    const entryPath = path.join(outDir, 'index.js');\n    await fsp.writeFile(entryPath, entryContent, 'utf8');\n    console.log(c('green', `  Generated ${adapter} entry at ${path.relative(cwd, entryPath)}`));\n\n    // ESM adapters (vercel, lambda) emit `import` syntax in the entry. The\n    // user's project may be `\"type\": \"commonjs\"`, in which case Node and\n    // rspack treat the .js file as CJS and parsing fails on `import`.\n    // Drop a sibling package.json with `\"type\": \"module\"` so the dist\n    // directory is always interpreted correctly regardless of the parent.\n    if (template.moduleFormat === 'esnext') {\n      const pkgPath = path.join(outDir, 'package.json');\n      await fsp.writeFile(pkgPath, JSON.stringify({ type: 'module' }, null, 2), 'utf8');\n    }\n  }\n\n  // Bundle if adapter requires it (creates single CJS file for serverless)\n  if (template.shouldBundle && template.bundleOutput) {\n    console.log(c('cyan', `[build] Bundling for ${adapter}...`));\n    const entryPath = path.join(outDir, 'index.js');\n    await bundleForServerless(entryPath, outDir, template.bundleOutput);\n    console.log(c('green', `  Created bundle: ${template.bundleOutput}`));\n\n    // Run post-bundle hook if defined (e.g., create Build Output API structure)\n    if (template.postBundle) {\n      console.log(c('cyan', `[build] Creating ${adapter} deployment structure...`));\n      await template.postBundle(outDir, cwd, template.bundleOutput);\n      console.log(c('green', `  Created deployment output structure`));\n    }\n  }\n\n  // Generate config file if adapter has one. By default we preserve an\n  // existing user-edited file. Adapters that mark `alwaysWriteConfig` (e.g.,\n  // cloudflare's wrangler.toml) overwrite it on every build so the\n  // generated `main = ...` path always matches the actual build output —\n  // see #374.\n  if (template.getConfig && template.configFileName) {\n    const configPath = path.join(cwd, template.configFileName);\n    const exists = await fileExists(configPath);\n\n    const configContent = template.getConfig(cwd, deployment);\n    const writeIt = async (): Promise<void> => {\n      if (typeof configContent === 'string') {\n        await fsp.writeFile(configPath, configContent, 'utf8');\n      } else {\n        await writeJSON(configPath, configContent);\n      }\n    };\n\n    if (!exists) {\n      await writeIt();\n      console.log(c('green', `  Generated ${template.configFileName}`));\n    } else if (template.alwaysWriteConfig) {\n      await writeIt();\n      console.log(c('green', `  Updated ${template.configFileName} (build output reference)`));\n    } else {\n      console.log(c('yellow', `  ${template.configFileName} already exists (skipping)`));\n    }\n  }\n}\n\n/** Map target names to internal adapter names. */\nconst TARGET_TO_ADAPTER: Record<string, AdapterName> = {\n  'vercel': 'vercel',\n  'lambda': 'lambda',\n  'cloudflare': 'cloudflare',\n  'distributed': 'distributed',\n};\n\n/**\n * Build the FrontMCP server for a specific deployment target.\n *\n * @example\n * ```bash\n * frontmcp build --target node          # Node.js server bundle\n * frontmcp build --target cli           # CLI with SEA binary\n * frontmcp build --target cli --js      # CLI without SEA\n * frontmcp build --target sdk           # Library (CJS+ESM+types)\n * frontmcp build --target browser       # Browser ESM bundle\n * frontmcp build --target vercel        # Vercel serverless\n * frontmcp build --target lambda        # AWS Lambda\n * frontmcp build --target cloudflare    # Cloudflare Workers\n * ```\n */\nexport async function runBuild(opts: ParsedArgs): Promise<void> {\n  const cwd = process.cwd();\n\n  // Try loading frontmcp.config for multi-target support.\n  //\n  // #365 — `tryLoadFrontMcpConfig` differentiates between recoverable cases:\n  //   - no config file present                          → returns undefined\n  //   - config exists but doesn't match the new schema  → returns undefined\n  //     (legacy top-level `cli`/`sea`/`esbuild` shape — picked up later by\n  //     the exec-build's own `loadExecConfig`)\n  // …and hard failures:\n  //   - file exists but can't be parsed (TS syntax error, broken require)\n  //     → the error propagates, no silent-default regression.\n  const config: FrontMcpConfigParsed | undefined = await tryLoadFrontMcpConfig(cwd);\n\n  // If no -t flag and config has deployments, build all targets from config\n  if (!opts.buildTarget && config && config.deployments.length > 0) {\n    const targets = getDeploymentTargets(config);\n    console.log(c('cyan', `[build] Building ${targets.length} target(s) from frontmcp.config: ${targets.join(', ')}`));\n\n    for (const targetName of targets) {\n      console.log(c('cyan', `\\n[build] ═══ ${targetName} ═══`));\n      await buildSingleTarget(targetName, opts, config);\n    }\n    return;\n  }\n\n  // Single target build (from -t flag or default 'node')\n  const target = opts.buildTarget ?? 'node';\n  await buildSingleTarget(target, opts, config);\n}\n\n/**\n * Build a single deployment target.\n * Merges per-target config (from frontmcp.config) with CLI opts.\n */\nasync function buildSingleTarget(\n  target: string,\n  opts: ParsedArgs,\n  config?: FrontMcpConfigParsed,\n): Promise<void> {\n  const deployment:DeploymentTarget | undefined = config ? findDeployment(config, target) : undefined;\n\n  // Resolve output directory: deployment.outDir > CLI --out-dir > dist/{target}\n  const baseOutDir = path.resolve(process.cwd(), opts.outDir || 'dist');\n  const targetOutDir = deployment?.outDir\n    ? path.resolve(process.cwd(), deployment.outDir)\n    : path.join(baseOutDir, target);\n\n  // Merge entry from config if not provided via CLI\n  const entry = opts.entry || config?.entry;\n  const targetOpts = { ...opts, outDir: targetOutDir, entry };\n\n  // #370: forward `build.storage` and per-deployment `cli.outputDefault` from\n  // the FrontMcp config into the exec build so the manifest reflects them.\n  // The exec build has its own loader (`loadExecConfig`) that doesn't see\n  // the deployment-level shape; passing these via opts merges them in\n  // `normalizeConfig` before the manifest is generated.\n  //\n  // Only the cli deployment shape carries a `cli` block; map it down to the\n  // narrow exec-config shape (outputDefault / description / authRequired) so\n  // the result is a clean object, never `false`.\n  const cliDeploymentConfig = deployment?.target === 'cli' ? deployment.cli : undefined;\n  const execOverrides: {\n    storage?: { type: 'sqlite' | 'redis' | 'none'; required?: boolean };\n    cli?: { outputDefault?: 'text' | 'json'; description?: string; authRequired?: boolean };\n    // #365 round-3 — without this, top-level `nodeVersion` declared in\n    // `frontmcp.config.{ts,js}` was silently dropped because the legacy\n    // `loadExecConfig` doesn't read .ts and the new-shape loader's result\n    // wasn't forwarded into buildExec. The exec build's manifest emitter\n    // shipped the SDK default (`>=22.0.0`) instead of the user's value.\n    nodeVersion?: string;\n  } = {\n    storage: config?.build?.storage,\n    cli: cliDeploymentConfig\n      ? {\n          ...(cliDeploymentConfig.outputDefault ? { outputDefault: cliDeploymentConfig.outputDefault } : {}),\n          ...(cliDeploymentConfig.description ? { description: cliDeploymentConfig.description } : {}),\n          ...(typeof cliDeploymentConfig.authRequired === 'boolean'\n            ? { authRequired: cliDeploymentConfig.authRequired }\n            : {}),\n        }\n      : undefined,\n    nodeVersion: config?.nodeVersion,\n  };\n\n  switch (target) {\n    case 'cli': {\n      const { buildExec } = await import('./exec/index.js');\n      return buildExec({\n        ...targetOpts,\n        cli: true,\n        sea: !opts.js,\n        execOverrides,\n      } as ParsedArgs & { cli: boolean; sea: boolean; execOverrides?: typeof execOverrides });\n    }\n    case 'node': {\n      const { buildExec } = await import('./exec/index.js');\n      return buildExec({\n        ...targetOpts,\n        execOverrides,\n      } as ParsedArgs & { execOverrides?: typeof execOverrides });\n    }\n    case 'sdk': {\n      const { buildSdk } = await import('./sdk/index.js');\n      return buildSdk(targetOpts);\n    }\n    case 'browser': {\n      const { buildBrowser } = await import('./browser/index.js');\n      return buildBrowser(targetOpts);\n    }\n    case 'mcpb': {\n      const { buildMcpb } = await import('./mcpb/index.js');\n      return buildMcpb(targetOpts, config);\n    }\n    case 'vercel':\n    case 'lambda':\n    case 'cloudflare':\n    case 'distributed': {\n      const adapter = TARGET_TO_ADAPTER[target];\n      return runAdapterBuild(targetOpts, adapter, deployment);\n    }\n    default:\n      throw new Error(`Unknown build target: ${target}. Available: cli, node, sdk, browser, cloudflare, vercel, lambda, distributed, mcpb`);\n  }\n}\n\n/**\n * Build using a deployment adapter (serverless platforms).\n */\nasync function runAdapterBuild(\n  opts: ParsedArgs,\n  adapter: AdapterName,\n  deployment?: DeploymentTarget,\n): Promise<void> {\n  const cwd = process.cwd();\n  const entry = await resolveEntry(cwd, opts.entry);\n  const outDir = path.resolve(cwd, opts.outDir || 'dist');\n  await ensureDir(outDir);\n\n  const template = ADAPTERS[adapter];\n  if (!template) {\n    const available = Object.keys(ADAPTERS).join(', ');\n    throw new Error(`Unknown adapter: ${adapter}. Available: ${available}`);\n  }\n\n  if (adapter === 'cloudflare') {\n    console.log(\n      c('yellow', 'Cloudflare Workers adapter is experimental. See docs for limitations.'),\n    );\n  }\n\n  // #375 — adapter-level pre-validation: read the entry's @FrontMcp() config\n  // metadata and let the adapter reject incompatible features\n  // (sqlite/redis on Workers, etc.) before emitting an unrunnable bundle.\n  // `loadEntryDecoratorInfo` handles both compiled-JS and raw-TS entries\n  // (TS goes through esbuild + Module._compile so we don't need a tsc pass)\n  // AND scans the source AST for keys hidden behind env-gated ternaries —\n  // round-2 made the env-gated case the headline #375 reproducer.\n  if (template.validate) {\n    const { loadEntryDecoratorInfo } = await import('./load-entry-config.js');\n    const info = await loadEntryDecoratorInfo(entry);\n    template.validate(info.decoratorConfig, { keysSeenInSource: info.keysSeenInSource });\n  }\n\n  const moduleFormat = template.moduleFormat;\n\n  console.log(`${c('cyan', '[build]')} entry: ${path.relative(cwd, entry)}`);\n  console.log(`${c('cyan', '[build]')} outDir: ${path.relative(cwd, outDir)}`);\n  console.log(`${c('cyan', '[build]')} target: ${adapter} (${moduleFormat})`);\n\n  const tsconfigPath = path.join(cwd, 'tsconfig.json');\n  const hasTsconfig = await fileExists(tsconfigPath);\n  const args: string[] = ['-y', 'tsc'];\n\n  if (hasTsconfig) {\n    console.log(c('gray', `[build] tsconfig.json detected — compiling with project settings`));\n    args.push('--project', tsconfigPath);\n  } else {\n    args.push(entry);\n    args.push('--rootDir', path.dirname(entry));\n    if (!isTsLike(entry)) {\n      args.push('--allowJs');\n      console.log(c('yellow', '[build] Entry is not TypeScript; enabling --allowJs'));\n    }\n    args.push('--experimentalDecorators', '--emitDecoratorMetadata');\n    args.push('--target', REQUIRED_DECORATOR_FIELDS.target);\n  }\n\n  args.push('--module', moduleFormat);\n  args.push('--outDir', outDir);\n  args.push('--skipLibCheck');\n\n  await runCmd('npx', args);\n\n  if (adapter !== 'node') {\n    console.log(c('cyan', `[build] Generating ${adapter} deployment files...`));\n    const entryBasename = path.basename(entry);\n    await generateAdapterFiles(adapter, outDir, entryBasename, cwd, deployment);\n  }\n\n  console.log(c('green', 'Build completed.'));\n  console.log(c('gray', `Output placed in ${path.relative(cwd, outDir)}`));\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/build/index.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport { type ParsedArgs } from '../../core/args';\nimport { c } from '../../core/colors';\nimport { ensureDir, fileExists, runCmd, writeJSON } from '@frontmcp/utils';\nimport { fsp, resolveEntry } from '../../shared/fs';\nimport { REQUIRED_DECORATOR_FIELDS } from '../../core/tsconfig';\nimport { ADAPTERS } from './adapters';\nimport { type AdapterName } from './types';\nimport { bundleForServerless } from './bundler';\nimport {\n  type DeploymentTarget,\n  findDeployment,\n  type FrontMcpConfigParsed,\n  getDeploymentTargets,\n  tryLoadFrontMcpConfig,\n} from '../../config';\n\nfunction isTsLike(p: string): boolean {\n  return /\\.tsx?$/i.test(p);\n}\n\n/**\n * Generate adapter-specific entry point and config files.\n */\nasync function generateAdapterFiles(\n  adapter: AdapterName,\n  outDir: string,\n  entryBasename: string,\n  cwd: string,\n  deployment?: DeploymentTarget,\n): Promise<void> {\n  const template = ADAPTERS[adapter];\n\n  // Generate serverless setup file first (if adapter has one)\n  // This file sets FRONTMCP_SERVERLESS=1 before any imports run\n  if (template.getSetupTemplate) {\n    const setupContent = template.getSetupTemplate();\n    const setupPath = path.join(outDir, 'serverless-setup.js');\n    await fsp.writeFile(setupPath, setupContent, 'utf8');\n    console.log(c('green', `  Generated serverless setup at ${path.relative(cwd, setupPath)}`));\n  }\n\n  // Generate index.js entry point\n  const mainModuleName = entryBasename.replace(/\\.tsx?$/, '.js');\n  const entryContent = template.getEntryTemplate(`./${mainModuleName}`);\n\n  // Skip if no entry template (e.g., node adapter)\n  if (entryContent) {\n    const entryPath = path.join(outDir, 'index.js');\n    await fsp.writeFile(entryPath, entryContent, 'utf8');\n    console.log(c('green', `  Generated ${adapter} entry at ${path.relative(cwd, entryPath)}`));\n\n    // ESM adapters (vercel, lambda) emit `import` syntax in the entry. The\n    // user's project may be `\"type\": \"commonjs\"`, in which case Node and\n    // rspack treat the .js file as CJS and parsing fails on `import`.\n    // Drop a sibling package.json with `\"type\": \"module\"` so the dist\n    // directory is always interpreted correctly regardless of the parent.\n    if (template.moduleFormat === 'esnext') {\n      const pkgPath = path.join(outDir, 'package.json');\n      await fsp.writeFile(pkgPath, JSON.stringify({ type: 'module' }, null, 2), 'utf8');\n    }\n  }\n\n  // Bundle if adapter requires it (creates single CJS file for serverless)\n  if (template.shouldBundle && template.bundleOutput) {\n    console.log(c('cyan', `[build] Bundling for ${adapter}...`));\n    const entryPath = path.join(outDir, 'index.js');\n    await bundleForServerless(entryPath, outDir, template.bundleOutput);\n    console.log(c('green', `  Created bundle: ${template.bundleOutput}`));\n\n    // Run post-bundle hook if defined (e.g., create Build Output API structure)\n    if (template.postBundle) {\n      console.log(c('cyan', `[build] Creating ${adapter} deployment structure...`));\n      await template.postBundle(outDir, cwd, template.bundleOutput);\n      console.log(c('green', `  Created deployment output structure`));\n    }\n  }\n\n  // Generate config file if adapter has one. By default we preserve an\n  // existing user-edited file. Adapters that mark `alwaysWriteConfig` (e.g.,\n  // cloudflare's wrangler.toml) overwrite it on every build so the\n  // generated `main = ...` path always matches the actual build output —\n  // see #374.\n  if (template.getConfig && template.configFileName) {\n    const configPath = path.join(cwd, template.configFileName);\n    const exists = await fileExists(configPath);\n\n    const configContent = template.getConfig(cwd, deployment);\n    const writeIt = async (): Promise<void> => {\n      if (typeof configContent === 'string') {\n        await fsp.writeFile(configPath, configContent, 'utf8');\n      } else {\n        await writeJSON(configPath, configContent);\n      }\n    };\n\n    if (!exists) {\n      await writeIt();\n      console.log(c('green', `  Generated ${template.configFileName}`));\n    } else if (template.alwaysWriteConfig) {\n      await writeIt();\n      console.log(c('green', `  Updated ${template.configFileName} (build output reference)`));\n    } else {\n      console.log(c('yellow', `  ${template.configFileName} already exists (skipping)`));\n    }\n  }\n}\n\n/** Map target names to internal adapter names. */\nconst TARGET_TO_ADAPTER: Record<string, AdapterName> = {\n  'vercel': 'vercel',\n  'lambda': 'lambda',\n  'cloudflare': 'cloudflare',\n  'distributed': 'distributed',\n};\n\n/**\n * Build the FrontMCP server for a specific deployment target.\n *\n * @example\n * ```bash\n * frontmcp build --target node          # Node.js server bundle\n * frontmcp build --target cli           # CLI with SEA binary\n * frontmcp build --target cli --js      # CLI without SEA\n * frontmcp build --target sdk           # Library (CJS+ESM+types)\n * frontmcp build --target browser       # Browser ESM bundle\n * frontmcp build --target vercel        # Vercel serverless\n * frontmcp build --target lambda        # AWS Lambda\n * frontmcp build --target cloudflare    # Cloudflare Workers\n * ```\n */\nexport async function runBuild(opts: ParsedArgs): Promise<void> {\n  const cwd = process.cwd();\n\n  // Try loading frontmcp.config for multi-target support.\n  //\n  // #365 — `tryLoadFrontMcpConfig` differentiates between recoverable cases:\n  //   - no config file present                          → returns undefined\n  //   - config exists but doesn't match the new schema  → returns undefined\n  //     (legacy top-level `cli`/`sea`/`esbuild` shape — picked up later by\n  //     the exec-build's own `loadExecConfig`)\n  // …and hard failures:\n  //   - file exists but can't be parsed (TS syntax error, broken require)\n  //     → the error propagates, no silent-default regression.\n  const config: FrontMcpConfigParsed | undefined = await tryLoadFrontMcpConfig(cwd);\n\n  // If no -t flag and config has deployments, build all targets from config\n  if (!opts.buildTarget && config && config.deployments.length > 0) {\n    const targets = getDeploymentTargets(config);\n    console.log(c('cyan', `[build] Building ${targets.length} target(s) from frontmcp.config: ${targets.join(', ')}`));\n\n    for (const targetName of targets) {\n      console.log(c('cyan', `\\n[build] ═══ ${targetName} ═══`));\n      await buildSingleTarget(targetName, opts, config);\n    }\n    return;\n  }\n\n  // Single target build (from -t flag or default 'node')\n  const target = opts.buildTarget ?? 'node';\n  await buildSingleTarget(target, opts, config);\n}\n\n/**\n * Build a single deployment target.\n * Merges per-target config (from frontmcp.config) with CLI opts.\n */\nasync function buildSingleTarget(\n  target: string,\n  opts: ParsedArgs,\n  config?: FrontMcpConfigParsed,\n): Promise<void> {\n  const deployment:DeploymentTarget | undefined = config ? findDeployment(config, target) : undefined;\n\n  // Resolve output directory: deployment.outDir > CLI --out-dir > dist/{target}\n  const baseOutDir = path.resolve(process.cwd(), opts.outDir || 'dist');\n  const targetOutDir = deployment?.outDir\n    ? path.resolve(process.cwd(), deployment.outDir)\n    : path.join(baseOutDir, target);\n\n  // Merge entry from config if not provided via CLI\n  const entry = opts.entry || config?.entry;\n  const targetOpts = { ...opts, outDir: targetOutDir, entry };\n\n  // #370: forward `build.storage` and per-deployment `cli.outputDefault` from\n  // the FrontMcp config into the exec build so the manifest reflects them.\n  // The exec build has its own loader (`loadExecConfig`) that doesn't see\n  // the deployment-level shape; passing these via opts merges them in\n  // `normalizeConfig` before the manifest is generated.\n  //\n  // Only the cli deployment shape carries a `cli` block; map it down to the\n  // narrow exec-config shape (outputDefault / description / authRequired) so\n  // the result is a clean object, never `false`.\n  const cliDeploymentConfig = deployment?.target === 'cli' ? deployment.cli : undefined;\n  const execOverrides: {\n    storage?: { type: 'sqlite' | 'redis' | 'none'; required?: boolean };\n    cli?: { outputDefault?: 'text' | 'json'; description?: string; authRequired?: boolean };\n    // #365 round-3 — without this, top-level `nodeVersion` declared in\n    // `frontmcp.config.{ts,js}` was silently dropped because the legacy\n    // `loadExecConfig` doesn't read .ts and the new-shape loader's result\n    // wasn't forwarded into buildExec. The exec build's manifest emitter\n    // shipped the SDK default (`>=22.0.0`) instead of the user's value.\n    nodeVersion?: string;\n  } = {\n    storage: config?.build?.storage,\n    cli: cliDeploymentConfig\n      ? {\n          ...(cliDeploymentConfig.outputDefault ? { outputDefault: cliDeploymentConfig.outputDefault } : {}),\n          ...(cliDeploymentConfig.description ? { description: cliDeploymentConfig.description } : {}),\n          ...(typeof cliDeploymentConfig.authRequired === 'boolean'\n            ? { authRequired: cliDeploymentConfig.authRequired }\n            : {}),\n        }\n      : undefined,\n    nodeVersion: config?.nodeVersion,\n  };\n\n  switch (target) {\n    case 'cli': {\n      const { buildExec } = await import('./exec/index.js');\n      return buildExec({\n        ...targetOpts,\n        cli: true,\n        sea: !opts.js,\n        execOverrides,\n      } as ParsedArgs & { cli: boolean; sea: boolean; execOverrides?: typeof execOverrides });\n    }\n    case 'node': {\n      const { buildExec } = await import('./exec/index.js');\n      return buildExec({\n        ...targetOpts,\n        execOverrides,\n      } as ParsedArgs & { execOverrides?: typeof execOverrides });\n    }\n    case 'sdk': {\n      const { buildSdk } = await import('./sdk/index.js');\n      return buildSdk(targetOpts);\n    }\n    case 'browser': {\n      const { buildBrowser } = await import('./browser/index.js');\n      return buildBrowser(targetOpts);\n    }\n    case 'mcpb': {\n      const { buildMcpb } = await import('./mcpb/index.js');\n      return buildMcpb(targetOpts, config);\n    }\n    case 'vercel':\n    case 'lambda':\n    case 'cloudflare':\n    case 'distributed': {\n      const adapter = TARGET_TO_ADAPTER[target];\n      return runAdapterBuild(targetOpts, adapter, deployment);\n    }\n    default:\n      throw new Error(`Unknown build target: ${target}. Available: cli, node, sdk, browser, cloudflare, vercel, lambda, distributed, mcpb`);\n  }\n}\n\n/**\n * Build using a deployment adapter (serverless platforms).\n */\nasync function runAdapterBuild(\n  opts: ParsedArgs,\n  adapter: AdapterName,\n  deployment?: DeploymentTarget,\n): Promise<void> {\n  const cwd = process.cwd();\n  const entry = await resolveEntry(cwd, opts.entry);\n  const outDir = path.resolve(cwd, opts.outDir || 'dist');\n  await ensureDir(outDir);\n\n  const template = ADAPTERS[adapter];\n  if (!template) {\n    const available = Object.keys(ADAPTERS).join(', ');\n    throw new Error(`Unknown adapter: ${adapter}. Available: ${available}`);\n  }\n\n  if (adapter === 'cloudflare') {\n    console.log(\n      c('yellow', 'Cloudflare Workers adapter is experimental. See docs for limitations.'),\n    );\n  }\n\n  // #375 — adapter-level pre-validation: read the entry's @FrontMcp() config\n  // metadata and let the adapter reject incompatible features\n  // (sqlite/redis on Workers, etc.) before emitting an unrunnable bundle.\n  // `loadEntryDecoratorInfo` handles both compiled-JS and raw-TS entries\n  // (TS goes through esbuild + Module._compile so we don't need a tsc pass)\n  // AND scans the source AST for keys hidden behind env-gated ternaries —\n  // round-2 made the env-gated case the headline #375 reproducer.\n  if (template.validate) {\n    const { loadEntryDecoratorInfo } = await import('./load-entry-config.js');\n    const info = await loadEntryDecoratorInfo(entry);\n    template.validate(info.decoratorConfig, { keysSeenInSource: info.keysSeenInSource });\n  }\n\n  const moduleFormat = template.moduleFormat;\n\n  console.log(`${c('cyan', '[build]')} entry: ${path.relative(cwd, entry)}`);\n  console.log(`${c('cyan', '[build]')} outDir: ${path.relative(cwd, outDir)}`);\n  console.log(`${c('cyan', '[build]')} target: ${adapter} (${moduleFormat})`);\n\n  const tsconfigPath = path.join(cwd, 'tsconfig.json');\n  const hasTsconfig = await fileExists(tsconfigPath);\n  const args: string[] = ['-y', 'tsc'];\n\n  if (hasTsconfig) {\n    console.log(c('gray', `[build] tsconfig.json detected — compiling with project settings`));\n    args.push('--project', tsconfigPath);\n  } else {\n    args.push(entry);\n    args.push('--rootDir', path.dirname(entry));\n    if (!isTsLike(entry)) {\n      args.push('--allowJs');\n      console.log(c('yellow', '[build] Entry is not TypeScript; enabling --allowJs'));\n    }\n    args.push('--experimentalDecorators', '--emitDecoratorMetadata');\n    args.push('--target', REQUIRED_DECORATOR_FIELDS.target);\n  }\n\n  args.push('--module', moduleFormat);\n  // `--module esnext` defaults `moduleResolution` to `classic`, which can't\n  // resolve bare specifiers like `@frontmcp/sdk` (package.json `exports`). Use\n  // `bundler` resolution — it mirrors how wrangler/esbuild resolve the worker\n  // bundle and keeps the ESM (Module Worker) target building. `commonjs`\n  // already defaults to node resolution, so only the ESM path needs this.\n  if (moduleFormat === 'esnext') {\n    args.push('--moduleResolution', 'bundler');\n  }\n  args.push('--outDir', outDir);\n  args.push('--skipLibCheck');\n\n  await runCmd('npx', args);\n\n  if (adapter !== 'node') {\n    console.log(c('cyan', `[build] Generating ${adapter} deployment files...`));\n    const entryBasename = path.basename(entry);\n    await generateAdapterFiles(adapter, outDir, entryBasename, cwd, deployment);\n  }\n\n  console.log(c('green', 'Build completed.'));\n  console.log(c('gray', `Output placed in ${path.relative(cwd, outDir)}`));\n}\n"]}

package/src/commands/scaffold/create.js

@@ -540,19 +540,32 @@ Outputs:
     Description: API Gateway endpoint URL
     Value: !Sub "https://\${ServerlessHttpApi}.execute-api.\${AWS::Region}.amazonaws.com"
 `;
-// Cloudflare Workers template
+// Cloudflare Workers template.
+// NOTE: `frontmcp build --target cloudflare` regenerates the top-level keys
+// (name / main / compatibility_date / compatibility_flags) on every build, so
+// they MUST match the adapter's output: an ES Module Worker at
+// dist/cloudflare/index.js, requiring `nodejs_compat` with date >= 2024-09-23
+// (without the flag the Worker fails to load). KV/cron below are for the
+// managed `@frontmcp/edge` path (which is bundled by wrangler, not `frontmcp
+// build`, so those keys persist there).
 const TEMPLATE_WRANGLER_TOML = (projectName) => `
 name = "${projectName}"
-main = "dist/main.js"
-compatibility_date = "2024-01-01"
+main = "dist/cloudflare/index.js"
+compatibility_date = "2024-09-23"
+compatibility_flags = ["nodejs_compat"]
 
 [vars]
 NODE_ENV = "production"
 
-# Uncomment to enable KV namespace for caching
+# ── Managed auto-update (only when using @frontmcp/edge createEdgeMcp) ──
+# Last-good bundle cache (createKvBundleCache / kvBundleCacheFromEnv('BUNDLE_CACHE')):
 # [[kv_namespaces]]
-# binding = "CACHE"
+# binding = "BUNDLE_CACHE"
 # id = "your-kv-namespace-id"
+#
+# Cron Trigger that drives the \`scheduled\` refresh handler (set your cadence here):
+# [triggers]
+# crontabs = ["*/5 * * * *"]
 `;
 // =============================================================================
 // GitHub Actions Templates