frontmcp 1.0.3 → 1.1.0-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontmcp",
-  "version": "1.0.3",
+  "version": "1.1.0-beta.1",
   "description": "FrontMCP command line interface",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -30,17 +30,23 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
-    "@frontmcp/utils": "1.0.3",
+    "@frontmcp/lazy-zod": "1.1.0-beta.1",
+    "@frontmcp/utils": "1.1.0-beta.1",
+    "@frontmcp/skills": "1.1.0-beta.1",
     "commander": "^13.0.0",
     "tslib": "^2.3.0",
     "vectoriadb": "^2.2.0",
     "@rspack/core": "^1.7.6",
-    "esbuild": "^0.27.3"
+    "esbuild": "^0.27.3",
+    "yauzl": "^3.2.0",
+    "yazl": "^3.3.1"
   },
   "devDependencies": {
     "typescript": "^5.5.3",
     "tsx": "^4.20.6",
-    "@types/node": "^24.0.0"
+    "@types/node": "^24.0.0",
+    "@types/yauzl": "^2.10.3",
+    "@types/yazl": "^2.4.5"
   },
   "types": "./index.d.js",
   "type": "commonjs"

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

@@ -1,4 +1,4 @@
-import { AdapterTemplate } from '../types';
+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.

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

@@ -12,6 +12,7 @@ exports.cloudflareAdapter = {
     getEntryTemplate: (mainModulePath) => `// Auto-generated Cloudflare Workers entry point
 // Generated by: frontmcp build --target cloudflare
 process.env.FRONTMCP_SERVERLESS = '1';
+process.env.FRONTMCP_DEPLOYMENT_MODE = 'serverless';
 
 require('${mainModulePath}');
 const { getServerlessHandlerAsync } = require('@frontmcp/sdk');

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":";;;AAEA;;;;;GAKG;AACU,QAAA,iBAAiB,GAAoB;IAChD,YAAY,EAAE,UAAU;IAExB,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;;WAIrC,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDxB;IAEC,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;;;CAG9B;IAEC,cAAc,EAAE,eAAe;CAChC,CAAC","sourcesContent":["import { 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';\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  getConfig: (_cwd: string) => `name = \"frontmcp-worker\"\nmain = \"dist/index.js\"\ncompatibility_date = \"2024-01-01\"\n`,\n\n  configFileName: 'wrangler.toml',\n};\n"]}
+{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/cloudflare.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACU,QAAA,iBAAiB,GAAoB;IAChD,YAAY,EAAE,UAAU;IAExB,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;;;WAKrC,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDxB;IAEC,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;;;CAG9B;IAEC,cAAc,EAAE,eAAe;CAChC,CAAC","sourcesContent":["import 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  getConfig: (_cwd: string) => `name = \"frontmcp-worker\"\nmain = \"dist/index.js\"\ncompatibility_date = \"2024-01-01\"\n`,\n\n  configFileName: 'wrangler.toml',\n};\n"]}

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

@@ -0,0 +1,15 @@
+import type { AdapterTemplate } from '../types';
+/**
+ * Distributed adapter - multi-pod Node.js deployment with HA.
+ * Compiles to CommonJS with an HA setup file that sets FRONTMCP_DEPLOYMENT_MODE.
+ *
+ * The setup file runs before any imports to ensure the deployment mode
+ * is detected before @FrontMcp decorators execute. This enables:
+ * - Session heartbeat and takeover
+ * - Cross-pod notification relay via Redis pub/sub
+ * - LB affinity via __frontmcp_node cookie
+ * - Machine ID from K8s HOSTNAME or os.hostname()
+ *
+ * Requires Redis configuration in @FrontMcp() for session persistence.
+ */
+export declare const distributedAdapter: AdapterTemplate;

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distributedAdapter = void 0;
+/**
+ * Distributed adapter - multi-pod Node.js deployment with HA.
+ * Compiles to CommonJS with an HA setup file that sets FRONTMCP_DEPLOYMENT_MODE.
+ *
+ * The setup file runs before any imports to ensure the deployment mode
+ * is detected before @FrontMcp decorators execute. This enables:
+ * - Session heartbeat and takeover
+ * - Cross-pod notification relay via Redis pub/sub
+ * - LB affinity via __frontmcp_node cookie
+ * - Machine ID from K8s HOSTNAME or os.hostname()
+ *
+ * Requires Redis configuration in @FrontMcp() for session persistence.
+ */
+exports.distributedAdapter = {
+    moduleFormat: 'commonjs',
+    getSetupTemplate: () => `// Distributed HA setup - MUST be imported first
+// Sets FRONTMCP_DEPLOYMENT_MODE before any decorators run
+// Enables heartbeat, session takeover, and notification relay
+process.env.FRONTMCP_DEPLOYMENT_MODE = 'distributed';
+`,
+    getEntryTemplate: (mainModulePath) => `// Auto-generated distributed entry point
+// Generated by: frontmcp build --target distributed
+require('./ha-setup.js');
+require('${mainModulePath}');
+`,
+};
+//# sourceMappingURL=distributed.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"distributed.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/distributed.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;GAYG;AACU,QAAA,kBAAkB,GAAoB;IACjD,YAAY,EAAE,UAAU;IAExB,gBAAgB,EAAE,GAAG,EAAE,CAAC;;;;CAIzB;IAEC,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;WAGrC,cAAc;CACxB;CACA,CAAC","sourcesContent":["import type { AdapterTemplate } from '../types';\n\n/**\n * Distributed adapter - multi-pod Node.js deployment with HA.\n * Compiles to CommonJS with an HA setup file that sets FRONTMCP_DEPLOYMENT_MODE.\n *\n * The setup file runs before any imports to ensure the deployment mode\n * is detected before @FrontMcp decorators execute. This enables:\n * - Session heartbeat and takeover\n * - Cross-pod notification relay via Redis pub/sub\n * - LB affinity via __frontmcp_node cookie\n * - Machine ID from K8s HOSTNAME or os.hostname()\n *\n * Requires Redis configuration in @FrontMcp() for session persistence.\n */\nexport const distributedAdapter: AdapterTemplate = {\n  moduleFormat: 'commonjs',\n\n  getSetupTemplate: () => `// Distributed HA setup - MUST be imported first\n// Sets FRONTMCP_DEPLOYMENT_MODE before any decorators run\n// Enables heartbeat, session takeover, and notification relay\nprocess.env.FRONTMCP_DEPLOYMENT_MODE = 'distributed';\n`,\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated distributed entry point\n// Generated by: frontmcp build --target distributed\nrequire('./ha-setup.js');\nrequire('${mainModulePath}');\n`,\n};\n"]}

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

@@ -1,12 +1,13 @@
-import { AdapterTemplate, AdapterName } from '../types';
+import type { AdapterTemplate, AdapterName } from '../types';
 import { nodeAdapter } from './node';
 import { vercelAdapter } from './vercel';
 import { lambdaAdapter } from './lambda';
 import { cloudflareAdapter } from './cloudflare';
+import { distributedAdapter } from './distributed';
 /**
  * Registry of all available deployment adapters.
  * Each adapter configures how the FrontMCP server is compiled and packaged
  * for a specific deployment target.
  */
 export declare const ADAPTERS: Record<AdapterName, AdapterTemplate>;
-export { nodeAdapter, vercelAdapter, lambdaAdapter, cloudflareAdapter };
+export { nodeAdapter, vercelAdapter, lambdaAdapter, cloudflareAdapter, distributedAdapter };

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cloudflareAdapter = exports.lambdaAdapter = exports.vercelAdapter = exports.nodeAdapter = exports.ADAPTERS = void 0;
+exports.distributedAdapter = exports.cloudflareAdapter = exports.lambdaAdapter = exports.vercelAdapter = exports.nodeAdapter = exports.ADAPTERS = void 0;
 const node_1 = require("./node");
 Object.defineProperty(exports, "nodeAdapter", { enumerable: true, get: function () { return node_1.nodeAdapter; } });
 const vercel_1 = require("./vercel");
@@ -9,6 +9,8 @@ const lambda_1 = require("./lambda");
 Object.defineProperty(exports, "lambdaAdapter", { enumerable: true, get: function () { return lambda_1.lambdaAdapter; } });
 const cloudflare_1 = require("./cloudflare");
 Object.defineProperty(exports, "cloudflareAdapter", { enumerable: true, get: function () { return cloudflare_1.cloudflareAdapter; } });
+const distributed_1 = require("./distributed");
+Object.defineProperty(exports, "distributedAdapter", { enumerable: true, get: function () { return distributed_1.distributedAdapter; } });
 /**
  * Registry of all available deployment adapters.
  * Each adapter configures how the FrontMCP server is compiled and packaged
@@ -19,5 +21,6 @@ exports.ADAPTERS = {
     vercel: vercel_1.vercelAdapter,
     lambda: lambda_1.lambdaAdapter,
     cloudflare: cloudflare_1.cloudflareAdapter,
+    distributed: distributed_1.distributedAdapter,
 };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/index.ts"],"names":[],"mappings":";;;AACA,iCAAqC;AAiB5B,4FAjBA,kBAAW,OAiBA;AAhBpB,qCAAyC;AAgBnB,8FAhBb,sBAAa,OAgBa;AAfnC,qCAAyC;AAeJ,8FAf5B,sBAAa,OAe4B;AAdlD,6CAAiD;AAcG,kGAd3C,8BAAiB,OAc2C;AAZrE;;;;GAIG;AACU,QAAA,QAAQ,GAAyC;IAC5D,IAAI,EAAE,kBAAW;IACjB,MAAM,EAAE,sBAAa;IACrB,MAAM,EAAE,sBAAa;IACrB,UAAU,EAAE,8BAAiB;CAC9B,CAAC","sourcesContent":["import { AdapterTemplate, AdapterName } from '../types';\nimport { nodeAdapter } from './node';\nimport { vercelAdapter } from './vercel';\nimport { lambdaAdapter } from './lambda';\nimport { cloudflareAdapter } from './cloudflare';\n\n/**\n * Registry of all available deployment adapters.\n * Each adapter configures how the FrontMCP server is compiled and packaged\n * for a specific deployment target.\n */\nexport const ADAPTERS: Record<AdapterName, AdapterTemplate> = {\n  node: nodeAdapter,\n  vercel: vercelAdapter,\n  lambda: lambdaAdapter,\n  cloudflare: cloudflareAdapter,\n};\n\nexport { nodeAdapter, vercelAdapter, lambdaAdapter, cloudflareAdapter };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/index.ts"],"names":[],"mappings":";;;AACA,iCAAqC;AAmB5B,4FAnBA,kBAAW,OAmBA;AAlBpB,qCAAyC;AAkBnB,8FAlBb,sBAAa,OAkBa;AAjBnC,qCAAyC;AAiBJ,8FAjB5B,sBAAa,OAiB4B;AAhBlD,6CAAiD;AAgBG,kGAhB3C,8BAAiB,OAgB2C;AAfrE,+CAAmD;AAeoB,mGAf9D,gCAAkB,OAe8D;AAbzF;;;;GAIG;AACU,QAAA,QAAQ,GAAyC;IAC5D,IAAI,EAAE,kBAAW;IACjB,MAAM,EAAE,sBAAa;IACrB,MAAM,EAAE,sBAAa;IACrB,UAAU,EAAE,8BAAiB;IAC7B,WAAW,EAAE,gCAAkB;CAChC,CAAC","sourcesContent":["import type { AdapterTemplate, AdapterName } from '../types';\nimport { nodeAdapter } from './node';\nimport { vercelAdapter } from './vercel';\nimport { lambdaAdapter } from './lambda';\nimport { cloudflareAdapter } from './cloudflare';\nimport { distributedAdapter } from './distributed';\n\n/**\n * Registry of all available deployment adapters.\n * Each adapter configures how the FrontMCP server is compiled and packaged\n * for a specific deployment target.\n */\nexport const ADAPTERS: Record<AdapterName, AdapterTemplate> = {\n  node: nodeAdapter,\n  vercel: vercelAdapter,\n  lambda: lambdaAdapter,\n  cloudflare: cloudflareAdapter,\n  distributed: distributedAdapter,\n};\n\nexport { nodeAdapter, vercelAdapter, lambdaAdapter, cloudflareAdapter, distributedAdapter };\n"]}

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

@@ -1,4 +1,4 @@
-import { AdapterTemplate } from '../types';
+import type { AdapterTemplate } from '../types';
 /**
  * AWS Lambda adapter - serverless deployment on AWS Lambda.
  * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.

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

@@ -24,6 +24,7 @@ exports.lambdaAdapter = {
 // This sets FRONTMCP_SERVERLESS before any decorators run
 // Required because ESM hoists imports before other statements
 process.env.FRONTMCP_SERVERLESS = '1';
+process.env.FRONTMCP_DEPLOYMENT_MODE = 'serverless';
 `,
     getEntryTemplate: (mainModulePath) => `// Auto-generated AWS Lambda entry point
 // Generated by: frontmcp build --target lambda

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

@@ -1 +1 @@
-{"version":3,"file":"lambda.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/lambda.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;GAcG;AACU,QAAA,aAAa,GAAoB;IAC5C,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,aAAa;IAE3B,gBAAgB,EAAE,GAAG,EAAE,CAAC;;;;CAIzB;IAEC,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;;;;;UAOtC,cAAc;;;;;;;;;;;;;;;;;CAiBvB;IAEC,qEAAqE;CACtE,CAAC","sourcesContent":["import { AdapterTemplate } from '../types';\n\n/**\n * AWS Lambda adapter - serverless deployment on AWS Lambda.\n * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.\n *\n * Prerequisites:\n *   npm install @codegenie/serverless-express\n *\n * The build process:\n * 1. TypeScript compiles to ESM in dist/\n * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)\n * 3. index.js imports setup first, then main module\n * 4. rspack bundles everything into handler.cjs\n *\n * @see https://github.com/codegenie/serverless-express\n */\nexport const lambdaAdapter: AdapterTemplate = {\n  moduleFormat: 'esnext',\n  shouldBundle: true,\n  bundleOutput: 'handler.cjs',\n\n  getSetupTemplate: () => `// Serverless environment setup - MUST be imported first\n// This sets FRONTMCP_SERVERLESS before any decorators run\n// Required because ESM hoists imports before other statements\nprocess.env.FRONTMCP_SERVERLESS = '1';\n`,\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated AWS Lambda entry point\n// Generated by: frontmcp build --target lambda\n//\n// IMPORTANT: This adapter requires @codegenie/serverless-express\n// Install it with: npm install @codegenie/serverless-express\n//\nimport './serverless-setup.js';\nimport '${mainModulePath}';\nimport { getServerlessHandlerAsync } from '@frontmcp/sdk';\nimport serverlessExpress from '@codegenie/serverless-express';\n\nlet serverlessExpressInstance = null;\n\nasync function setup() {\n  const app = await getServerlessHandlerAsync();\n  serverlessExpressInstance = serverlessExpress({ app });\n}\n\nexport const handler = async (event, context) => {\n  if (!serverlessExpressInstance) {\n    await setup();\n  }\n  return serverlessExpressInstance(event, context);\n};\n`,\n\n  // No config file - user manages serverless.yml, SAM template, or CDK\n};\n"]}
+{"version":3,"file":"lambda.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/lambda.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;GAcG;AACU,QAAA,aAAa,GAAoB;IAC5C,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,aAAa;IAE3B,gBAAgB,EAAE,GAAG,EAAE,CAAC;;;;;CAKzB;IAEC,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC;;;;;;;UAOtC,cAAc;;;;;;;;;;;;;;;;;CAiBvB;IAEC,qEAAqE;CACtE,CAAC","sourcesContent":["import type { AdapterTemplate } from '../types';\n\n/**\n * AWS Lambda adapter - serverless deployment on AWS Lambda.\n * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.\n *\n * Prerequisites:\n *   npm install @codegenie/serverless-express\n *\n * The build process:\n * 1. TypeScript compiles to ESM in dist/\n * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)\n * 3. index.js imports setup first, then main module\n * 4. rspack bundles everything into handler.cjs\n *\n * @see https://github.com/codegenie/serverless-express\n */\nexport const lambdaAdapter: AdapterTemplate = {\n  moduleFormat: 'esnext',\n  shouldBundle: true,\n  bundleOutput: 'handler.cjs',\n\n  getSetupTemplate: () => `// Serverless environment setup - MUST be imported first\n// This sets FRONTMCP_SERVERLESS before any decorators run\n// Required because ESM hoists imports before other statements\nprocess.env.FRONTMCP_SERVERLESS = '1';\nprocess.env.FRONTMCP_DEPLOYMENT_MODE = 'serverless';\n`,\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated AWS Lambda entry point\n// Generated by: frontmcp build --target lambda\n//\n// IMPORTANT: This adapter requires @codegenie/serverless-express\n// Install it with: npm install @codegenie/serverless-express\n//\nimport './serverless-setup.js';\nimport '${mainModulePath}';\nimport { getServerlessHandlerAsync } from '@frontmcp/sdk';\nimport serverlessExpress from '@codegenie/serverless-express';\n\nlet serverlessExpressInstance = null;\n\nasync function setup() {\n  const app = await getServerlessHandlerAsync();\n  serverlessExpressInstance = serverlessExpress({ app });\n}\n\nexport const handler = async (event, context) => {\n  if (!serverlessExpressInstance) {\n    await setup();\n  }\n  return serverlessExpressInstance(event, context);\n};\n`,\n\n  // No config file - user manages serverless.yml, SAM template, or CDK\n};\n"]}

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

@@ -1,4 +1,4 @@
-import { AdapterTemplate } from '../types';
+import type { AdapterTemplate } from '../types';
 /**
  * Vercel adapter - serverless deployment on Vercel.
  * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.

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

@@ -55,6 +55,7 @@ exports.vercelAdapter = {
 // This sets FRONTMCP_SERVERLESS before any decorators run
 // Required because ESM hoists imports before other statements
 process.env.FRONTMCP_SERVERLESS = '1';
+process.env.FRONTMCP_DEPLOYMENT_MODE = 'serverless';
 `,
     getEntryTemplate: (mainModulePath) => `// Auto-generated Vercel entry point
 // Generated by: frontmcp build --target vercel

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

@@ -1 +1 @@
-{"version":3,"file":"vercel.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/vercel.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport { existsSync } from 'fs';\nimport { execSync } from 'child_process';\nimport { mkdir, readdir, stat, cp, copyFile, readFile, writeFile } from '@frontmcp/utils';\nimport { AdapterTemplate } from '../types';\n\ntype PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun';\n\ninterface PackageManagerConfig {\n  install: string;\n  run: string;\n}\n\nconst PACKAGE_MANAGERS: Record<PackageManager, PackageManagerConfig> = {\n  bun: { install: 'bun install', run: 'bun run build' },\n  pnpm: { install: 'pnpm install', run: 'pnpm run build' },\n  yarn: { install: 'yarn install', run: 'yarn build' },\n  npm: { install: 'npm install', run: 'npm run build' },\n};\n\nconst LOCKFILE_TO_PM: Record<string, PackageManager> = {\n  'bun.lockb': 'bun',\n  'pnpm-lock.yaml': 'pnpm',\n  'yarn.lock': 'yarn',\n  'package-lock.json': 'npm',\n};\n\n/**\n * Detect package manager based on lockfile presence.\n * Priority: bun > pnpm > yarn > npm (fastest to slowest install times)\n */\nfunction detectPackageManager(cwd: string): PackageManager {\n  for (const [lockfile, pm] of Object.entries(LOCKFILE_TO_PM)) {\n    if (existsSync(path.join(cwd, lockfile))) {\n      return pm;\n    }\n  }\n  return 'npm'; // Default fallback\n}\n\n/**\n * Vercel adapter - serverless deployment on Vercel.\n * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.\n *\n * Uses Vercel Build Output API for deployment:\n * - Creates .vercel/output/config.json with routing\n * - Creates .vercel/output/functions/index.func/ with handler\n *\n * The build process:\n * 1. TypeScript compiles to ESM in dist/\n * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)\n * 3. index.js imports setup first, then main module\n * 4. rspack bundles everything into handler.cjs\n * 5. Build Output API structure is created in .vercel/output/\n *\n * @see https://vercel.com/docs/build-output-api/v3\n */\nexport const vercelAdapter: AdapterTemplate = {\n  moduleFormat: 'esnext',\n  shouldBundle: true,\n  bundleOutput: 'handler.cjs',\n\n  getSetupTemplate: () => `// Serverless environment setup - MUST be imported first\n// This sets FRONTMCP_SERVERLESS before any decorators run\n// Required because ESM hoists imports before other statements\nprocess.env.FRONTMCP_SERVERLESS = '1';\n`,\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated Vercel entry point\n// Generated by: frontmcp build --target vercel\nimport './serverless-setup.js';\nimport '${mainModulePath}';\nimport { getServerlessHandlerAsync } from '@frontmcp/sdk';\n\nlet handlerPromise = null;\n\nexport default async function handler(req, res) {\n  if (!handlerPromise) {\n    handlerPromise = getServerlessHandlerAsync();\n  }\n  const app = await handlerPromise;\n  return app(req, res);\n}\n`,\n\n  // Detect package manager and generate appropriate vercel.json\n  getConfig: (cwd: string) => {\n    const pm = detectPackageManager(cwd);\n    const config = PACKAGE_MANAGERS[pm];\n    return {\n      version: 2,\n      buildCommand: config.run,\n      installCommand: config.install,\n    };\n  },\n\n  configFileName: 'vercel.json',\n\n  /**\n   * Create Vercel Build Output API structure after bundling.\n   * This allows Vercel to deploy the function without needing an /api folder.\n   *\n   * Structure created:\n   * .vercel/output/\n   * ├── config.json          (routes all requests to index function)\n   * └── functions/\n   *     └── index.func/\n   *         ├── .vc-config.json  (Node.js 22 runtime config)\n   *         ├── handler.cjs      (bundled handler + chunks)\n   *         └── node_modules/    (runtime dependencies that can't be bundled)\n   */\n  postBundle: async (outDir: string, cwd: string, bundleOutput: string) => {\n    const outputDir = path.join(cwd, '.vercel', 'output');\n    const funcDir = path.join(outputDir, 'functions', 'index.func');\n\n    // Create directories\n    await mkdir(funcDir, { recursive: true });\n\n    // Copy all files from dist to the function directory\n    // This includes handler.cjs and any chunk files (*.handler.cjs)\n    const distFiles = await readdir(outDir);\n    for (const file of distFiles) {\n      const srcPath = path.join(outDir, file);\n      const destPath = path.join(funcDir, file);\n      const fileStat = await stat(srcPath);\n\n      if (fileStat.isDirectory()) {\n        // Recursively copy directories\n        await cp(srcPath, destPath, { recursive: true });\n      } else {\n        // Copy files\n        await copyFile(srcPath, destPath);\n      }\n    }\n\n    // Install runtime dependencies that can't be statically bundled (dynamic requires)\n    // These are packages loaded via require() inside functions that rspack can't analyze\n    // We install them fresh to ensure correct platform binaries (linux-x64 for Vercel)\n    const runtimeDeps = ['@vercel/kv', 'esbuild', '@swc/core'];\n\n    // Read package.json to get the exact versions\n    const pkgJsonPath = path.join(cwd, 'package.json');\n    const pkgJson = JSON.parse(await readFile(pkgJsonPath, 'utf-8'));\n    const allDeps = { ...pkgJson.dependencies, ...pkgJson.devDependencies };\n\n    // Build list of deps with versions\n    const depsToInstall: string[] = [];\n    for (const dep of runtimeDeps) {\n      const version = allDeps[dep];\n      if (version) {\n        depsToInstall.push(`${dep}@${version}`);\n      }\n    }\n\n    if (depsToInstall.length > 0) {\n      // Create package.json in function directory\n      const funcPkgJson = { name: 'index.func', private: true, dependencies: {} };\n      await writeFile(path.join(funcDir, 'package.json'), JSON.stringify(funcPkgJson, null, 2));\n\n      // Install dependencies using npm (works on all platforms)\n      try {\n        execSync(`npm install ${depsToInstall.join(' ')} --omit=dev`, {\n          cwd: funcDir,\n          stdio: 'pipe',\n        });\n      } catch {\n        // Silently continue if install fails - the dep might not be needed\n      }\n    }\n\n    // Create function config (.vc-config.json)\n    const vcConfig = {\n      runtime: 'nodejs24.x',\n      handler: bundleOutput,\n      launcherType: 'Nodejs',\n    };\n    await writeFile(\n      path.join(funcDir, '.vc-config.json'),\n      JSON.stringify(vcConfig, null, 2),\n    );\n\n    // Create output config (config.json) with routing\n    const outputConfig = {\n      version: 3,\n      routes: [{ src: '/(.*)', dest: '/index' }],\n    };\n    await writeFile(\n      path.join(outputDir, 'config.json'),\n      JSON.stringify(outputConfig, null, 2),\n    );\n  },\n};\n"]}
+{"version":3,"file":"vercel.js","sourceRoot":"","sources":["../../../../../src/commands/build/adapters/vercel.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport { existsSync } from 'fs';\nimport { execSync } from 'child_process';\nimport { mkdir, readdir, stat, cp, copyFile, readFile, writeFile } from '@frontmcp/utils';\nimport type { AdapterTemplate } from '../types';\n\ntype PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun';\n\ninterface PackageManagerConfig {\n  install: string;\n  run: string;\n}\n\nconst PACKAGE_MANAGERS: Record<PackageManager, PackageManagerConfig> = {\n  bun: { install: 'bun install', run: 'bun run build' },\n  pnpm: { install: 'pnpm install', run: 'pnpm run build' },\n  yarn: { install: 'yarn install', run: 'yarn build' },\n  npm: { install: 'npm install', run: 'npm run build' },\n};\n\nconst LOCKFILE_TO_PM: Record<string, PackageManager> = {\n  'bun.lockb': 'bun',\n  'pnpm-lock.yaml': 'pnpm',\n  'yarn.lock': 'yarn',\n  'package-lock.json': 'npm',\n};\n\n/**\n * Detect package manager based on lockfile presence.\n * Priority: bun > pnpm > yarn > npm (fastest to slowest install times)\n */\nfunction detectPackageManager(cwd: string): PackageManager {\n  for (const [lockfile, pm] of Object.entries(LOCKFILE_TO_PM)) {\n    if (existsSync(path.join(cwd, lockfile))) {\n      return pm;\n    }\n  }\n  return 'npm'; // Default fallback\n}\n\n/**\n * Vercel adapter - serverless deployment on Vercel.\n * Compiles to ESM, bundles with rspack to CJS for maximum compatibility.\n *\n * Uses Vercel Build Output API for deployment:\n * - Creates .vercel/output/config.json with routing\n * - Creates .vercel/output/functions/index.func/ with handler\n *\n * The build process:\n * 1. TypeScript compiles to ESM in dist/\n * 2. serverless-setup.js is generated (sets FRONTMCP_SERVERLESS=1)\n * 3. index.js imports setup first, then main module\n * 4. rspack bundles everything into handler.cjs\n * 5. Build Output API structure is created in .vercel/output/\n *\n * @see https://vercel.com/docs/build-output-api/v3\n */\nexport const vercelAdapter: AdapterTemplate = {\n  moduleFormat: 'esnext',\n  shouldBundle: true,\n  bundleOutput: 'handler.cjs',\n\n  getSetupTemplate: () => `// Serverless environment setup - MUST be imported first\n// This sets FRONTMCP_SERVERLESS before any decorators run\n// Required because ESM hoists imports before other statements\nprocess.env.FRONTMCP_SERVERLESS = '1';\nprocess.env.FRONTMCP_DEPLOYMENT_MODE = 'serverless';\n`,\n\n  getEntryTemplate: (mainModulePath: string) => `// Auto-generated Vercel entry point\n// Generated by: frontmcp build --target vercel\nimport './serverless-setup.js';\nimport '${mainModulePath}';\nimport { getServerlessHandlerAsync } from '@frontmcp/sdk';\n\nlet handlerPromise = null;\n\nexport default async function handler(req, res) {\n  if (!handlerPromise) {\n    handlerPromise = getServerlessHandlerAsync();\n  }\n  const app = await handlerPromise;\n  return app(req, res);\n}\n`,\n\n  // Detect package manager and generate appropriate vercel.json\n  getConfig: (cwd: string) => {\n    const pm = detectPackageManager(cwd);\n    const config = PACKAGE_MANAGERS[pm];\n    return {\n      version: 2,\n      buildCommand: config.run,\n      installCommand: config.install,\n    };\n  },\n\n  configFileName: 'vercel.json',\n\n  /**\n   * Create Vercel Build Output API structure after bundling.\n   * This allows Vercel to deploy the function without needing an /api folder.\n   *\n   * Structure created:\n   * .vercel/output/\n   * ├── config.json          (routes all requests to index function)\n   * └── functions/\n   *     └── index.func/\n   *         ├── .vc-config.json  (Node.js 22 runtime config)\n   *         ├── handler.cjs      (bundled handler + chunks)\n   *         └── node_modules/    (runtime dependencies that can't be bundled)\n   */\n  postBundle: async (outDir: string, cwd: string, bundleOutput: string) => {\n    const outputDir = path.join(cwd, '.vercel', 'output');\n    const funcDir = path.join(outputDir, 'functions', 'index.func');\n\n    // Create directories\n    await mkdir(funcDir, { recursive: true });\n\n    // Copy all files from dist to the function directory\n    // This includes handler.cjs and any chunk files (*.handler.cjs)\n    const distFiles = await readdir(outDir);\n    for (const file of distFiles) {\n      const srcPath = path.join(outDir, file);\n      const destPath = path.join(funcDir, file);\n      const fileStat = await stat(srcPath);\n\n      if (fileStat.isDirectory()) {\n        // Recursively copy directories\n        await cp(srcPath, destPath, { recursive: true });\n      } else {\n        // Copy files\n        await copyFile(srcPath, destPath);\n      }\n    }\n\n    // Install runtime dependencies that can't be statically bundled (dynamic requires)\n    // These are packages loaded via require() inside functions that rspack can't analyze\n    // We install them fresh to ensure correct platform binaries (linux-x64 for Vercel)\n    const runtimeDeps = ['@vercel/kv', 'esbuild', '@swc/core'];\n\n    // Read package.json to get the exact versions\n    const pkgJsonPath = path.join(cwd, 'package.json');\n    const pkgJson = JSON.parse(await readFile(pkgJsonPath, 'utf-8'));\n    const allDeps = { ...pkgJson.dependencies, ...pkgJson.devDependencies };\n\n    // Build list of deps with versions\n    const depsToInstall: string[] = [];\n    for (const dep of runtimeDeps) {\n      const version = allDeps[dep];\n      if (version) {\n        depsToInstall.push(`${dep}@${version}`);\n      }\n    }\n\n    if (depsToInstall.length > 0) {\n      // Create package.json in function directory\n      const funcPkgJson = { name: 'index.func', private: true, dependencies: {} };\n      await writeFile(path.join(funcDir, 'package.json'), JSON.stringify(funcPkgJson, null, 2));\n\n      // Install dependencies using npm (works on all platforms)\n      try {\n        execSync(`npm install ${depsToInstall.join(' ')} --omit=dev`, {\n          cwd: funcDir,\n          stdio: 'pipe',\n        });\n      } catch {\n        // Silently continue if install fails - the dep might not be needed\n      }\n    }\n\n    // Create function config (.vc-config.json)\n    const vcConfig = {\n      runtime: 'nodejs24.x',\n      handler: bundleOutput,\n      launcherType: 'Nodejs',\n    };\n    await writeFile(\n      path.join(funcDir, '.vc-config.json'),\n      JSON.stringify(vcConfig, null, 2),\n    );\n\n    // Create output config (config.json) with routing\n    const outputConfig = {\n      version: 3,\n      routes: [{ src: '/(.*)', dest: '/index' }],\n    };\n    await writeFile(\n      path.join(outputDir, 'config.json'),\n      JSON.stringify(outputConfig, null, 2),\n    );\n  },\n};\n"]}

package/src/commands/build/exec/cli-runtime/generate-cli-entry.js

@@ -86,19 +86,52 @@ ${selfContained ? `
 // using the inlined (bundled) server code — no external requires needed.
 if (process.env.__FRONTMCP_DAEMON_MODE === '1') {
   require('reflect-metadata');
+  // Suppress @FrontMcp decorator auto-bootstrap — daemon handles bootstrap explicitly below.
+  process.env.FRONTMCP_SCHEMA_EXTRACT = '1';
   var _dMod = require(${JSON.stringify('../' + serverBundleFilename)});
+  delete process.env.FRONTMCP_SCHEMA_EXTRACT;
   var _dSdk = require('@frontmcp/sdk');
   var _FMI = _dSdk.FrontMcpInstance || _dSdk.default.FrontMcpInstance;
   var _raw = _dMod.default || _dMod;
   var _cfg = (typeof _raw === 'function' && typeof Reflect !== 'undefined' && Reflect.getMetadata)
     ? (Reflect.getMetadata('__frontmcp:config', _raw) || _raw) : _raw;
-  var _sp = process.env.FRONTMCP_DAEMON_SOCKET;
-  _FMI.runUnixSocket(Object.assign({}, _cfg, { socketPath: _sp }))
-    .then(function() { console.log('Daemon listening on ' + _sp); })
-    .catch(function(e) { console.error('Daemon failed:', e); process.exit(1); });
+  var _dp = process.env.FRONTMCP_DAEMON_PORT;
+  if (_dp) {
+    var _port = parseInt(_dp, 10);
+    _cfg = Object.assign({}, _cfg, { http: Object.assign({}, _cfg.http || {}, { port: _port }) });
+    process.env.PORT = _dp;
+    _FMI.bootstrap(_cfg)
+      .then(function() { console.log('Daemon listening on port ' + _port); })
+      .catch(function(e) { console.error('Daemon failed:', e); process.exit(1); });
+  } else {
+    var _sp = process.env.FRONTMCP_DAEMON_SOCKET;
+    _FMI.runUnixSocket(Object.assign({}, _cfg, { socketPath: _sp }))
+      .then(function() { console.log('Daemon listening on ' + _sp); })
+      .catch(function(e) { console.error('Daemon failed:', e); process.exit(1); });
+  }
   return;
 }
 ` : ''}
+// Stdio mode: when --stdio is passed, run as an MCP stdio server (stdin/stdout JSON-RPC).
+// Detected early before commander to avoid overhead and ensure stdout stays clean for MCP protocol.
+// Logs go to ~/.frontmcp/logs/{appName}-*.log — stdout is reserved for MCP JSON-RPC only.
+if (process.argv.includes('--stdio')) {
+  // Set app name for file logging before any initialization
+  process.env.FRONTMCP_APP_NAME = process.env.FRONTMCP_APP_NAME || ${JSON.stringify(appName)};
+  require('reflect-metadata');
+  process.env.FRONTMCP_SCHEMA_EXTRACT = '1';
+  var _sMod = require(${selfContained ? `${JSON.stringify('../' + serverBundleFilename)}` : `require('path').join(__dirname, ${JSON.stringify(serverBundleFilename)})`});
+  delete process.env.FRONTMCP_SCHEMA_EXTRACT;
+  var _sSdk = require('@frontmcp/sdk');
+  var _sFMI = _sSdk.FrontMcpInstance || _sSdk.default.FrontMcpInstance;
+  var _sRaw = _sMod.default || _sMod;
+  var _sCfg = (typeof _sRaw === 'function' && typeof Reflect !== 'undefined' && Reflect.getMetadata)
+    ? (Reflect.getMetadata('__frontmcp:config', _sRaw) || _sRaw) : _sRaw;
+  _sFMI.runStdio(_sCfg)
+    .catch(function(e) { console.error('Stdio server failed:', e); process.exit(1); });
+  return;
+}
+
 var { Command, Option } = require('commander');
 var path = require('path');
 var fs = require('fs');
@@ -1059,11 +1092,31 @@ function generateServeCommand(serverBundleFilename, selfContained) {
         : `require(path.join(SCRIPT_DIR, ${JSON.stringify(serverBundleFilename)}))`;
     return `program
   .command('serve')
-  .description('Start the HTTP/SSE server')
+  .description('Start the MCP server')
   .option('-p, --port <port>', 'Port number', function(v) { return parseInt(v, 10); })
+  .option('--stdio', 'Run as stdio transport (stdin/stdout JSON-RPC) for use in .mcp.json')
   .action(async function(opts) {
+    if (opts.stdio) {
+      // --stdio on serve is handled by the early argv check at the top of the entry;
+      // this branch is a fallback in case commander parsed it first.
+      _isLongRunning = true;
+      process.env.FRONTMCP_SCHEMA_EXTRACT = '1';
+      var sMod = ${requireExpr};
+      delete process.env.FRONTMCP_SCHEMA_EXTRACT;
+      var sRaw = sMod.default || sMod;
+      var sSdk = require('@frontmcp/sdk');
+      var sFMI = sSdk.FrontMcpInstance || sSdk.default.FrontMcpInstance;
+      var sCfg = (typeof sRaw === 'function' && typeof Reflect !== 'undefined' && Reflect.getMetadata)
+        ? (Reflect.getMetadata('__frontmcp:config', sRaw) || sRaw) : sRaw;
+      await sFMI.runStdio(sCfg);
+      return;
+    }
     _isLongRunning = true;
+    // Suppress @FrontMcp decorator auto-bootstrap during require() — the CLI
+    // serve command handles bootstrap explicitly below with port/config overrides.
+    process.env.FRONTMCP_SCHEMA_EXTRACT = '1';
     var mod = ${requireExpr};
+    delete process.env.FRONTMCP_SCHEMA_EXTRACT;
     if (opts.port) process.env.PORT = String(opts.port);
     // If the bundle exports a start() function (@FrontMcp-decorated class auto-bootstraps), use it
     if (typeof mod.start === 'function') { await mod.start(); return; }
@@ -1277,7 +1330,8 @@ function generateDaemonCommands(appName, serverBundleFilename, selfContained) {
 
 daemonCmd
   .command('start')
-  .description('Start as a background daemon (Unix socket)')
+  .description('Start as a background daemon')
+  .option('-p, --port <port>', 'Listen on a TCP port instead of a Unix socket', function(v) { return parseInt(v, 10); })
   .option('--idle-timeout <ms>', 'Auto-stop after idle period (ms, 0 to disable)', function(v) { return parseInt(v, 10); }, 300000)
   .action(async function(opts) {
     var { spawn } = require('child_process');
@@ -1289,10 +1343,11 @@ daemonCmd
     fs.mkdirSync(logDir, { recursive: true });
     fs.mkdirSync(socketDir, { recursive: true });
 
+    var usePort = !!opts.port;
     var socketPath = pathMod.join(socketDir, ${JSON.stringify(appName)} + '.sock');
 
-    // Clean up stale socket file
-    try { fs.unlinkSync(socketPath); } catch (_) { /* ok */ }
+    // Clean up stale socket file (only relevant in socket mode)
+    if (!usePort) { try { fs.unlinkSync(socketPath); } catch (_) { /* ok */ } }
 
     // Check if already running
     var pidPath = pathMod.join(pidDir, ${JSON.stringify(appName)} + '.pid');
@@ -1304,9 +1359,13 @@ daemonCmd
     } catch (_) { /* not running, proceed */ }
 
     var env = Object.assign({}, process.env, {
-      FRONTMCP_DAEMON_SOCKET: socketPath,
       FRONTMCP_DAEMON_IDLE_TIMEOUT: String(opts.idleTimeout)
     });
+    if (usePort) {
+      env.FRONTMCP_DAEMON_PORT = String(opts.port);
+    } else {
+      env.FRONTMCP_DAEMON_SOCKET = socketPath;
+    }
 
     var logPath = pathMod.join(logDir, ${JSON.stringify(appName)} + '.log');
     var out = fs.openSync(logPath, 'a');
@@ -1318,20 +1377,33 @@ ${selfContained ? `    // SEA mode: spawn the binary itself in daemon mode — a
       detached: true,
       stdio: ['ignore', out, err],
       env: env
-    });` : `    // Start the daemon using runUnixSocket via a small wrapper script
+    });` : `    // Start the daemon via a small wrapper script
     // Always use absolute path for the server bundle (SCRIPT_DIR resolves to __dirname at runtime)
     var serverBundlePath = pathMod.join(SCRIPT_DIR, ${JSON.stringify(serverBundleFilename)});
     var daemonScript = 'require("reflect-metadata");' +
+      'process.env.FRONTMCP_SCHEMA_EXTRACT="1";' +
       'var mod = require(' + JSON.stringify(serverBundlePath) + ');' +
+      'delete process.env.FRONTMCP_SCHEMA_EXTRACT;' +
       'var sdk = require("@frontmcp/sdk");' +
       'var FrontMcpInstance = sdk.FrontMcpInstance || sdk.default.FrontMcpInstance;' +
       'var raw = mod.default || mod;' +
       ${'// If the export is a @FrontMcp-decorated class, extract config via Reflect metadata'}
       'var config = (typeof raw === "function" && typeof Reflect !== "undefined" && Reflect.getMetadata) ' +
-      '  ? (Reflect.getMetadata("__frontmcp:config", raw) || raw) : raw;' +
-      'FrontMcpInstance.runUnixSocket(Object.assign({}, config, { socketPath: ' + JSON.stringify(socketPath) + ' }))' +
-      '.then(function() { console.log("Daemon listening on " + ' + JSON.stringify(socketPath) + '); })' +
-      '.catch(function(e) { console.error("Daemon failed:", e); process.exit(1); });';
+      '  ? (Reflect.getMetadata("__frontmcp:config", raw) || raw) : raw;';
+
+    if (usePort) {
+      daemonScript +=
+        'config = Object.assign({}, config, { http: Object.assign({}, config.http || {}, { port: ' + opts.port + ' }) });' +
+        'process.env.PORT = ' + JSON.stringify(String(opts.port)) + ';' +
+        'FrontMcpInstance.bootstrap(config)' +
+        '.then(function() { console.log("Daemon listening on port ' + opts.port + '"); })' +
+        '.catch(function(e) { console.error("Daemon failed:", e); process.exit(1); });';
+    } else {
+      daemonScript +=
+        'FrontMcpInstance.runUnixSocket(Object.assign({}, config, { socketPath: ' + JSON.stringify(socketPath) + ' }))' +
+        '.then(function() { console.log("Daemon listening on " + ' + JSON.stringify(socketPath) + '); })' +
+        '.catch(function(e) { console.error("Daemon failed:", e); process.exit(1); });';
+    }
 
     var child = spawn('node', ['-e', daemonScript], {
       detached: true,
@@ -1343,26 +1415,40 @@ ${selfContained ? `    // SEA mode: spawn the binary itself in daemon mode — a
     fs.closeSync(out);
     fs.closeSync(err);
 
-    fs.writeFileSync(pidPath, JSON.stringify({
-      pid: child.pid,
-      socketPath: socketPath,
-      startedAt: new Date().toISOString()
-    }));
-    child.unref();
-
-    // Wait for socket file to appear (max 5s)
-    var waited = 0;
-    while (!fs.existsSync(socketPath) && waited < 5000) {
-      await new Promise(function(r) { setTimeout(r, 100); });
-      waited += 100;
+    var pidData = { pid: child.pid, startedAt: new Date().toISOString() };
+    if (usePort) {
+      pidData.port = opts.port;
+    } else {
+      pidData.socketPath = socketPath;
     }
+    fs.writeFileSync(pidPath, JSON.stringify(pidData));
+    child.unref();
 
-    if (fs.existsSync(socketPath)) {
-      console.log('Daemon started (PID: ' + child.pid + '). Socket: ' + socketPath);
-      console.log('Logs: ' + logPath);
+    if (usePort) {
+      // For port mode, wait briefly then check if process is still alive
+      await new Promise(function(r) { setTimeout(r, 1000); });
+      try {
+        process.kill(child.pid, 0);
+        console.log('Daemon started (PID: ' + child.pid + '). Port: ' + opts.port);
+        console.log('Logs: ' + logPath);
+      } catch (_) {
+        console.log('Daemon failed to start. Check logs: ' + logPath);
+      }
     } else {
-      console.log('Daemon started (PID: ' + child.pid + ') but socket not yet available.');
-      console.log('Check logs: ' + logPath);
+      // Wait for socket file to appear (max 5s)
+      var waited = 0;
+      while (!fs.existsSync(socketPath) && waited < 5000) {
+        await new Promise(function(r) { setTimeout(r, 100); });
+        waited += 100;
+      }
+
+      if (fs.existsSync(socketPath)) {
+        console.log('Daemon started (PID: ' + child.pid + '). Socket: ' + socketPath);
+        console.log('Logs: ' + logPath);
+      } else {
+        console.log('Daemon started (PID: ' + child.pid + ') but socket not yet available.');
+        console.log('Check logs: ' + logPath);
+      }
     }
   });
 
@@ -1396,8 +1482,8 @@ daemonCmd
       var data = JSON.parse(fs.readFileSync(pidPath, 'utf8'));
       try {
         process.kill(data.pid, 0);
-        var socketStatus = data.socketPath && fs.existsSync(data.socketPath) ? ', socket: active' : '';
-        console.log('Running (PID: ' + data.pid + ', started: ' + data.startedAt + socketStatus + ')');
+        var listenInfo = data.port ? ', port: ' + data.port : (data.socketPath && fs.existsSync(data.socketPath) ? ', socket: active' : '');
+        console.log('Running (PID: ' + data.pid + ', started: ' + data.startedAt + listenInfo + ')');
       } catch (_) {
         console.log('Not running (stale PID file).');
         fs.unlinkSync(pidPath);
@@ -1431,7 +1517,9 @@ program.parseAsync(process.argv).then(async function() {
   // on unclosed handles (file loggers, in-memory transport, etc.).
   if (_isLongRunning) return;
   await closeClient();
-  process.exit(process.exitCode || 0);
+  // Defer process.exit() by one event-loop tick so native addon destructors
+  // (ONNX runtime, etc.) can release mutexes before V8 tears down.
+  setImmediate(function() { process.exit(process.exitCode || 0); });
 }).catch(async function(err) {
   console.error('Fatal:', err.message || err);
   await closeClient();