frontmcp 1.4.0 → 1.5.0-rc.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontmcp",
-  "version": "1.4.0",
+  "version": "1.5.0-rc.1",
   "description": "FrontMCP command line interface",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -23,31 +23,29 @@
   },
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
-  "bin": {
-    "frontmcp": "./src/core/cli.js"
-  },
+  "bin": "./src/core/cli.js",
   "engines": {
     "node": ">=24.0.0"
   },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
-    "@frontmcp/lazy-zod": "1.4.0",
-    "@frontmcp/utils": "1.4.0",
-    "@frontmcp/skills": "1.4.0",
-    "commander": "^13.0.0",
-    "tslib": "^2.3.0",
-    "vectoriadb": "^2.2.0",
+    "@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.3.2",
     "yauzl": "^3.2.0",
     "yazl": "^3.3.1"
   },
   "devDependencies": {
-    "typescript": "^5.5.3",
-    "tsx": "^4.20.6",
     "@types/node": "^24.0.0",
     "@types/yauzl": "^2.10.3",
-    "@types/yazl": "^2.4.5"
+    "@types/yazl": "^2.4.5",
+    "tsx": "^4.20.6",
+    "typescript": "^5.5.3"
   },
   "type": "commonjs"
 }

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/exec/cli-runtime/generate-cli-entry.js

@@ -586,6 +586,7 @@ var _getCmd = promptCmd
   .description('Render a prompt by name')
 ${promptGetOptionLines}
   .allowUnknownOption(true)
+  .allowExcessArguments(true) // #382 — without this, an out-of-spec flag like \`--bogus x\` becomes excess operands and Commander throws "too many arguments" before the action can emit the precise "unknown option(s) for prompt" error.
   .action(async function(name) {
     try {
       var spec = promptArgs[name];