frontmcp 1.0.0-beta.1 → 1.0.0-beta.10

package/README.md

@@ -39,14 +39,14 @@ export default class Server {}
 
 ## Installation
 
-**Node.js 22+** required (24 recommended).
+**Node.js 24+** required.
 
 ```bash
 # New project (recommended)
 npx frontmcp create my-app
 
 # Existing project
-npm i -D frontmcp @types/node@^22
+npm i -D frontmcp @types/node@^24
 npx frontmcp init
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontmcp",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.10",
   "description": "FrontMCP command line interface",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -26,21 +26,21 @@
     "frontmcp": "./src/core/cli.js"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=24.0.0"
   },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
-    "@frontmcp/utils": "1.0.0-beta.1",
+    "@frontmcp/utils": "1.0.0-beta.10",
     "commander": "^13.0.0",
     "tslib": "^2.3.0",
+    "vectoriadb": "^2.1.3",
     "@rspack/core": "^1.7.6",
     "esbuild": "^0.27.3"
   },
   "devDependencies": {
     "typescript": "^5.5.3",
     "tsx": "^4.20.6",
-    "@types/node": "^24.0.0",
-    "@modelcontextprotocol/inspector": "^0.21.1"
+    "@types/node": "^24.0.0"
   },
   "types": "./index.d.js",
   "type": "commonjs"

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

@@ -10,7 +10,7 @@ exports.cloudflareAdapter = void 0;
 exports.cloudflareAdapter = {
     moduleFormat: 'commonjs',
     getEntryTemplate: (mainModulePath) => `// Auto-generated Cloudflare Workers entry point
-// Generated by: frontmcp build --adapter cloudflare
+// Generated by: frontmcp build --target cloudflare
 process.env.FRONTMCP_SERVERLESS = '1';
 
 require('${mainModulePath}');

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 --adapter 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;;;;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"]}

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

@@ -26,7 +26,7 @@ exports.lambdaAdapter = {
 process.env.FRONTMCP_SERVERLESS = '1';
 `,
     getEntryTemplate: (mainModulePath) => `// Auto-generated AWS Lambda entry point
-// Generated by: frontmcp build --adapter lambda
+// Generated by: frontmcp build --target lambda
 //
 // IMPORTANT: This adapter requires @codegenie/serverless-express
 // Install it with: npm install @codegenie/serverless-express

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 --adapter 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;;;;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"]}

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

@@ -57,7 +57,7 @@ exports.vercelAdapter = {
 process.env.FRONTMCP_SERVERLESS = '1';
 `,
     getEntryTemplate: (mainModulePath) => `// Auto-generated Vercel entry point
-// Generated by: frontmcp build --adapter vercel
+// Generated by: frontmcp build --target vercel
 import './serverless-setup.js';
 import '${mainModulePath}';
 import { getServerlessHandlerAsync } from '@frontmcp/sdk';
@@ -150,7 +150,7 @@ export default async function handler(req, res) {
         }
         // Create function config (.vc-config.json)
         const vcConfig = {
-            runtime: 'nodejs22.x',
+            runtime: 'nodejs24.x',
             handler: bundleOutput,
             launcherType: 'Nodejs',
         };

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 --adapter 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: 'nodejs22.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":";;;;AAAA,mDAA6B;AAC7B,2BAAgC;AAChC,iDAAyC;AACzC,2CAA0F;AAU1F,MAAM,gBAAgB,GAAiD;IACrE,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,eAAe,EAAE;IACrD,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,gBAAgB,EAAE;IACxD,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,YAAY,EAAE;IACpD,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,eAAe,EAAE;CACtD,CAAC;AAEF,MAAM,cAAc,GAAmC;IACrD,WAAW,EAAE,KAAK;IAClB,gBAAgB,EAAE,MAAM;IACxB,WAAW,EAAE,MAAM;IACnB,mBAAmB,EAAE,KAAK;CAC3B,CAAC;AAEF;;;GAGG;AACH,SAAS,oBAAoB,CAAC,GAAW;IACvC,KAAK,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5D,IAAI,IAAA,eAAU,EAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,mBAAmB;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;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;;;UAGtC,cAAc;;;;;;;;;;;;CAYvB;IAEC,8DAA8D;IAC9D,SAAS,EAAE,CAAC,GAAW,EAAE,EAAE;QACzB,MAAM,EAAE,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACpC,OAAO;YACL,OAAO,EAAE,CAAC;YACV,YAAY,EAAE,MAAM,CAAC,GAAG;YACxB,cAAc,EAAE,MAAM,CAAC,OAAO;SAC/B,CAAC;IACJ,CAAC;IAED,cAAc,EAAE,aAAa;IAE7B;;;;;;;;;;;;OAYG;IACH,UAAU,EAAE,KAAK,EAAE,MAAc,EAAE,GAAW,EAAE,YAAoB,EAAE,EAAE;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;QAEhE,qBAAqB;QACrB,MAAM,IAAA,aAAK,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,qDAAqD;QACrD,gEAAgE;QAChE,MAAM,SAAS,GAAG,MAAM,IAAA,eAAO,EAAC,MAAM,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAG,MAAM,IAAA,YAAI,EAAC,OAAO,CAAC,CAAC;YAErC,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC3B,+BAA+B;gBAC/B,MAAM,IAAA,UAAE,EAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,aAAa;gBACb,MAAM,IAAA,gBAAQ,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,mFAAmF;QACnF,qFAAqF;QACrF,mFAAmF;QACnF,MAAM,WAAW,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAE3D,8CAA8C;QAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,gBAAQ,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QAExE,mCAAmC;QACnC,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,OAAO,EAAE,CAAC;gBACZ,aAAa,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,4CAA4C;YAC5C,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;YAC5E,MAAM,IAAA,iBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAE1F,0DAA0D;YAC1D,IAAI,CAAC;gBACH,IAAA,wBAAQ,EAAC,eAAe,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE;oBAC5D,GAAG,EAAE,OAAO;oBACZ,KAAK,EAAE,MAAM;iBACd,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,mEAAmE;YACrE,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,MAAM,QAAQ,GAAG;YACf,OAAO,EAAE,YAAY;YACrB,OAAO,EAAE,YAAY;YACrB,YAAY,EAAE,QAAQ;SACvB,CAAC;QACF,MAAM,IAAA,iBAAS,EACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,EACrC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAClC,CAAC;QAEF,kDAAkD;QAClD,MAAM,YAAY,GAAG;YACnB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC3C,CAAC;QACF,MAAM,IAAA,iBAAS,EACb,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EACnC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CACtC,CAAC;IACJ,CAAC;CACF,CAAC","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"]}

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

@@ -0,0 +1,17 @@
+import { ParsedArgs } from '../../../core/args';
+/**
+ * Build a browser-compatible ESM bundle.
+ *
+ * Uses esbuild with `platform: 'browser'` which resolves conditional imports
+ * (`#imports` in package.json) to browser implementations automatically:
+ * - Crypto → @noble/hashes + @noble/ciphers (no node:crypto)
+ * - AsyncLocalStorage → stack-based polyfill
+ * - EventEmitter → Map-based polyfill
+ * - SSE/Express/Stdio → stubs that throw on instantiation
+ *
+ * @example
+ * ```bash
+ * frontmcp build --target browser
+ * ```
+ */
+export declare function buildBrowser(opts: ParsedArgs): Promise<void>;

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

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBrowser = buildBrowser;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const colors_1 = require("../../../core/colors");
+const utils_1 = require("@frontmcp/utils");
+const fs_1 = require("../../../shared/fs");
+/**
+ * Build a browser-compatible ESM bundle.
+ *
+ * Uses esbuild with `platform: 'browser'` which resolves conditional imports
+ * (`#imports` in package.json) to browser implementations automatically:
+ * - Crypto → @noble/hashes + @noble/ciphers (no node:crypto)
+ * - AsyncLocalStorage → stack-based polyfill
+ * - EventEmitter → Map-based polyfill
+ * - SSE/Express/Stdio → stubs that throw on instantiation
+ *
+ * @example
+ * ```bash
+ * frontmcp build --target browser
+ * ```
+ */
+async function buildBrowser(opts) {
+    const cwd = process.cwd();
+    const entry = await (0, fs_1.resolveEntry)(cwd, opts.entry);
+    const outDir = path.resolve(cwd, opts.outDir || 'dist');
+    await (0, utils_1.ensureDir)(outDir);
+    const pkg = require(path.join(cwd, 'package.json'));
+    const appName = pkg.name || path.basename(cwd);
+    console.log(`${(0, colors_1.c)('cyan', '[build:browser]')} entry: ${path.relative(cwd, entry)}`);
+    console.log(`${(0, colors_1.c)('cyan', '[build:browser]')} outDir: ${path.relative(cwd, outDir)}`);
+    const esbuild = await import('esbuild');
+    // Build ESM bundle for browsers
+    console.log((0, colors_1.c)('cyan', '[build:browser] Bundling ESM for browser...'));
+    await esbuild.build({
+        entryPoints: [entry],
+        bundle: true,
+        platform: 'browser',
+        format: 'esm',
+        target: 'es2022',
+        outfile: path.join(outDir, `${appName}.browser.mjs`),
+        keepNames: true,
+        treeShaking: true,
+        sourcemap: true,
+        // Browser-safe: keep React and peer deps external (user's bundler handles them)
+        external: [
+            'react', 'react-dom', 'react-router', 'react-router-dom',
+            // Keep @frontmcp/* external — user installs them
+            '@frontmcp/sdk', '@frontmcp/di', '@frontmcp/utils',
+            '@frontmcp/auth', '@frontmcp/react',
+            'reflect-metadata',
+            // Node.js-only — these should be tree-shaken by platform: 'browser'
+            // but list explicitly to avoid accidental bundling
+            'better-sqlite3', 'fsevents', 'ioredis',
+            ...Object.keys(pkg.peerDependencies || {}),
+        ],
+        // Resolve conditional imports to browser variants
+        conditions: ['browser', 'import', 'default'],
+        define: {
+            'process.env.NODE_ENV': '"production"',
+        },
+    });
+    console.log((0, colors_1.c)('green', `\n  Browser build complete:`));
+    console.log((0, colors_1.c)('gray', `  ESM: ${appName}.browser.mjs`));
+    console.log((0, colors_1.c)('gray', `  Source map: ${appName}.browser.mjs.map`));
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/build/browser/index.ts"],"names":[],"mappings":";;AAqBA,oCAgDC;;AArED,mDAA6B;AAE7B,iDAAyC;AACzC,2CAA4C;AAC5C,2CAAkD;AAElD;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,YAAY,CAAC,IAAgB;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,IAAA,iBAAY,EAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC;IACxD,MAAM,IAAA,iBAAS,EAAC,MAAM,CAAC,CAAC;IAExB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE/C,OAAO,CAAC,GAAG,CAAC,GAAG,IAAA,UAAC,EAAC,MAAM,EAAE,iBAAiB,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,GAAG,CAAC,GAAG,IAAA,UAAC,EAAC,MAAM,EAAE,iBAAiB,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAErF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAExC,gCAAgC;IAChC,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,MAAM,EAAE,6CAA6C,CAAC,CAAC,CAAC;IACtE,MAAM,OAAO,CAAC,KAAK,CAAC;QAClB,WAAW,EAAE,CAAC,KAAK,CAAC;QACpB,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,cAAc,CAAC;QACpD,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI;QACf,gFAAgF;QAChF,QAAQ,EAAE;YACR,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB;YACxD,iDAAiD;YACjD,eAAe,EAAE,cAAc,EAAE,iBAAiB;YAClD,gBAAgB,EAAE,iBAAiB;YACnC,kBAAkB;YAClB,oEAAoE;YACpE,mDAAmD;YACnD,gBAAgB,EAAE,UAAU,EAAE,SAAS;YACvC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;SAC3C;QACD,kDAAkD;QAClD,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;QAC5C,MAAM,EAAE;YACN,sBAAsB,EAAE,cAAc;SACvC;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,MAAM,EAAE,UAAU,OAAO,cAAc,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,MAAM,EAAE,iBAAiB,OAAO,kBAAkB,CAAC,CAAC,CAAC;AACrE,CAAC","sourcesContent":["import * as path from 'path';\nimport { ParsedArgs } from '../../../core/args';\nimport { c } from '../../../core/colors';\nimport { ensureDir } from '@frontmcp/utils';\nimport { resolveEntry } from '../../../shared/fs';\n\n/**\n * Build a browser-compatible ESM bundle.\n *\n * Uses esbuild with `platform: 'browser'` which resolves conditional imports\n * (`#imports` in package.json) to browser implementations automatically:\n * - Crypto → @noble/hashes + @noble/ciphers (no node:crypto)\n * - AsyncLocalStorage → stack-based polyfill\n * - EventEmitter → Map-based polyfill\n * - SSE/Express/Stdio → stubs that throw on instantiation\n *\n * @example\n * ```bash\n * frontmcp build --target browser\n * ```\n */\nexport async function buildBrowser(opts: ParsedArgs): 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 pkg = require(path.join(cwd, 'package.json'));\n  const appName = pkg.name || path.basename(cwd);\n\n  console.log(`${c('cyan', '[build:browser]')} entry: ${path.relative(cwd, entry)}`);\n  console.log(`${c('cyan', '[build:browser]')} outDir: ${path.relative(cwd, outDir)}`);\n\n  const esbuild = await import('esbuild');\n\n  // Build ESM bundle for browsers\n  console.log(c('cyan', '[build:browser] Bundling ESM for browser...'));\n  await esbuild.build({\n    entryPoints: [entry],\n    bundle: true,\n    platform: 'browser',\n    format: 'esm',\n    target: 'es2022',\n    outfile: path.join(outDir, `${appName}.browser.mjs`),\n    keepNames: true,\n    treeShaking: true,\n    sourcemap: true,\n    // Browser-safe: keep React and peer deps external (user's bundler handles them)\n    external: [\n      'react', 'react-dom', 'react-router', 'react-router-dom',\n      // Keep @frontmcp/* external — user installs them\n      '@frontmcp/sdk', '@frontmcp/di', '@frontmcp/utils',\n      '@frontmcp/auth', '@frontmcp/react',\n      'reflect-metadata',\n      // Node.js-only — these should be tree-shaken by platform: 'browser'\n      // but list explicitly to avoid accidental bundling\n      'better-sqlite3', 'fsevents', 'ioredis',\n      ...Object.keys(pkg.peerDependencies || {}),\n    ],\n    // Resolve conditional imports to browser variants\n    conditions: ['browser', 'import', 'default'],\n    define: {\n      'process.env.NODE_ENV': '\"production\"',\n    },\n  });\n\n  console.log(c('green', `\\n  Browser build complete:`));\n  console.log(c('gray', `  ESM: ${appName}.browser.mjs`));\n  console.log(c('gray', `  Source map: ${appName}.browser.mjs.map`));\n}\n"]}

package/src/commands/build/exec/cli-runtime/daemon-client.js

@@ -92,6 +92,7 @@ function createDaemonClient(socketPath) {
   }
 
   return {
+    _isDaemon: true,
     ping: function() {
       return call('ping');
     },

package/src/commands/build/exec/cli-runtime/daemon-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"daemon-client.js","sourceRoot":"","sources":["../../../../../../src/commands/build/exec/cli-runtime/daemon-client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAQH,gEAoJC;AA1JD,0DAA0D;AAE1D;;;GAGG;AACH,SAAgB,0BAA0B;IACxC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkJR,CAAC;AACF,CAAC","sourcesContent":["/**\n * Lightweight daemon client for CLI exec.\n *\n * Sends MCP JSON-RPC requests over a Unix socket using Node.js built-in http module.\n * This avoids the full FrontMCP SDK initialization (~420ms) by talking to an\n * already-running daemon process.\n *\n * NOTE: This file is used as a CJS runtime module — it gets bundled into the CLI\n * output by esbuild alongside the generated CLI entry. It must remain free of\n * TypeScript-only constructs at runtime (the .ts extension is for build-time only).\n */\n\n/* eslint-disable @typescript-eslint/no-require-imports */\n\n/**\n * Generate the daemon-client JavaScript source code (CJS module).\n * This is embedded into the CLI bundle at build time.\n */\nexport function generateDaemonClientSource(): string {\n  return `'use strict';\n\nvar http = require('http');\n\n/**\n * Send a JSON-RPC request over a Unix socket.\n * @param {string} socketPath - Path to the Unix socket file.\n * @param {string} method - JSON-RPC method name.\n * @param {object} [params] - Method parameters.\n * @returns {Promise<object>} Parsed JSON-RPC result.\n */\nfunction rpcCall(socketPath, method, params) {\n  return new Promise(function(resolve, reject) {\n    var body = JSON.stringify({\n      jsonrpc: '2.0',\n      id: Date.now(),\n      method: method,\n      params: params || {}\n    });\n\n    var req = http.request({\n      socketPath: socketPath,\n      path: '/mcp',\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Content-Length': Buffer.byteLength(body)\n      },\n      timeout: 10000\n    }, function(res) {\n      var chunks = [];\n      res.on('data', function(chunk) { chunks.push(chunk); });\n      res.on('end', function() {\n        try {\n          var json = JSON.parse(Buffer.concat(chunks).toString());\n          if (json.error) {\n            var err = new Error(json.error.message || 'RPC error');\n            err.code = json.error.code;\n            err.data = json.error.data;\n            reject(err);\n          } else {\n            resolve(json.result);\n          }\n        } catch (e) {\n          reject(new Error('Invalid JSON response from daemon'));\n        }\n      });\n    });\n\n    req.on('error', function(err) {\n      reject(err);\n    });\n\n    req.on('timeout', function() {\n      req.destroy();\n      reject(new Error('Daemon request timed out'));\n    });\n\n    req.write(body);\n    req.end();\n  });\n}\n\n/**\n * Create a daemon client that implements the same interface as DirectClient.\n * @param {string} socketPath - Path to the Unix socket file.\n * @returns {object} Client object with MCP methods.\n */\nfunction createDaemonClient(socketPath) {\n  function call(method, params) {\n    return rpcCall(socketPath, method, params);\n  }\n\n  return {\n    ping: function() {\n      return call('ping');\n    },\n    callTool: function(name, args) {\n      return call('tools/call', { name: name, arguments: args || {} });\n    },\n    listTools: function() {\n      return call('tools/list');\n    },\n    listResources: function() {\n      return call('resources/list');\n    },\n    readResource: function(uri) {\n      return call('resources/read', { uri: uri });\n    },\n    listResourceTemplates: function() {\n      return call('resources/templates/list');\n    },\n    listPrompts: function() {\n      return call('prompts/list');\n    },\n    getPrompt: function(name, args) {\n      return call('prompts/get', { name: name, arguments: args || {} });\n    },\n    searchSkills: function(query) {\n      return call('skills/search', { query: query || '' });\n    },\n    loadSkills: function(ids) {\n      return call('skills/load', { ids: ids });\n    },\n    listSkills: function() {\n      return call('skills/list');\n    },\n    listJobs: function() {\n      return call('jobs/list');\n    },\n    executeJob: function(name, input, opts) {\n      return call('jobs/execute', { name: name, input: input, options: opts });\n    },\n    getJobStatus: function(runId) {\n      return call('jobs/status', { runId: runId });\n    },\n    listWorkflows: function() {\n      return call('workflows/list');\n    },\n    executeWorkflow: function(name, input, opts) {\n      return call('workflows/execute', { name: name, input: input, options: opts });\n    },\n    getWorkflowStatus: function(runId) {\n      return call('workflows/status', { runId: runId });\n    },\n    subscribeResource: function(uri) {\n      return call('resources/subscribe', { uri: uri });\n    },\n    unsubscribeResource: function(uri) {\n      return call('resources/unsubscribe', { uri: uri });\n    },\n    onResourceUpdated: function() {\n      console.warn('Resource subscriptions are not supported in daemon mode (HTTP-based, no push).');\n      return function() {};\n    },\n    onNotification: function() {\n      console.warn('Notifications are not supported in daemon mode (HTTP-based, no push).');\n      return function() {};\n    },\n    close: function() {\n      return Promise.resolve();\n    }\n  };\n}\n\nexports.createDaemonClient = createDaemonClient;\n`;\n}\n"]}
+{"version":3,"file":"daemon-client.js","sourceRoot":"","sources":["../../../../../../src/commands/build/exec/cli-runtime/daemon-client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAQH,gEAqJC;AA3JD,0DAA0D;AAE1D;;;GAGG;AACH,SAAgB,0BAA0B;IACxC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmJR,CAAC;AACF,CAAC","sourcesContent":["/**\n * Lightweight daemon client for CLI exec.\n *\n * Sends MCP JSON-RPC requests over a Unix socket using Node.js built-in http module.\n * This avoids the full FrontMCP SDK initialization (~420ms) by talking to an\n * already-running daemon process.\n *\n * NOTE: This file is used as a CJS runtime module — it gets bundled into the CLI\n * output by esbuild alongside the generated CLI entry. It must remain free of\n * TypeScript-only constructs at runtime (the .ts extension is for build-time only).\n */\n\n/* eslint-disable @typescript-eslint/no-require-imports */\n\n/**\n * Generate the daemon-client JavaScript source code (CJS module).\n * This is embedded into the CLI bundle at build time.\n */\nexport function generateDaemonClientSource(): string {\n  return `'use strict';\n\nvar http = require('http');\n\n/**\n * Send a JSON-RPC request over a Unix socket.\n * @param {string} socketPath - Path to the Unix socket file.\n * @param {string} method - JSON-RPC method name.\n * @param {object} [params] - Method parameters.\n * @returns {Promise<object>} Parsed JSON-RPC result.\n */\nfunction rpcCall(socketPath, method, params) {\n  return new Promise(function(resolve, reject) {\n    var body = JSON.stringify({\n      jsonrpc: '2.0',\n      id: Date.now(),\n      method: method,\n      params: params || {}\n    });\n\n    var req = http.request({\n      socketPath: socketPath,\n      path: '/mcp',\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Content-Length': Buffer.byteLength(body)\n      },\n      timeout: 10000\n    }, function(res) {\n      var chunks = [];\n      res.on('data', function(chunk) { chunks.push(chunk); });\n      res.on('end', function() {\n        try {\n          var json = JSON.parse(Buffer.concat(chunks).toString());\n          if (json.error) {\n            var err = new Error(json.error.message || 'RPC error');\n            err.code = json.error.code;\n            err.data = json.error.data;\n            reject(err);\n          } else {\n            resolve(json.result);\n          }\n        } catch (e) {\n          reject(new Error('Invalid JSON response from daemon'));\n        }\n      });\n    });\n\n    req.on('error', function(err) {\n      reject(err);\n    });\n\n    req.on('timeout', function() {\n      req.destroy();\n      reject(new Error('Daemon request timed out'));\n    });\n\n    req.write(body);\n    req.end();\n  });\n}\n\n/**\n * Create a daemon client that implements the same interface as DirectClient.\n * @param {string} socketPath - Path to the Unix socket file.\n * @returns {object} Client object with MCP methods.\n */\nfunction createDaemonClient(socketPath) {\n  function call(method, params) {\n    return rpcCall(socketPath, method, params);\n  }\n\n  return {\n    _isDaemon: true,\n    ping: function() {\n      return call('ping');\n    },\n    callTool: function(name, args) {\n      return call('tools/call', { name: name, arguments: args || {} });\n    },\n    listTools: function() {\n      return call('tools/list');\n    },\n    listResources: function() {\n      return call('resources/list');\n    },\n    readResource: function(uri) {\n      return call('resources/read', { uri: uri });\n    },\n    listResourceTemplates: function() {\n      return call('resources/templates/list');\n    },\n    listPrompts: function() {\n      return call('prompts/list');\n    },\n    getPrompt: function(name, args) {\n      return call('prompts/get', { name: name, arguments: args || {} });\n    },\n    searchSkills: function(query) {\n      return call('skills/search', { query: query || '' });\n    },\n    loadSkills: function(ids) {\n      return call('skills/load', { ids: ids });\n    },\n    listSkills: function() {\n      return call('skills/list');\n    },\n    listJobs: function() {\n      return call('jobs/list');\n    },\n    executeJob: function(name, input, opts) {\n      return call('jobs/execute', { name: name, input: input, options: opts });\n    },\n    getJobStatus: function(runId) {\n      return call('jobs/status', { runId: runId });\n    },\n    listWorkflows: function() {\n      return call('workflows/list');\n    },\n    executeWorkflow: function(name, input, opts) {\n      return call('workflows/execute', { name: name, input: input, options: opts });\n    },\n    getWorkflowStatus: function(runId) {\n      return call('workflows/status', { runId: runId });\n    },\n    subscribeResource: function(uri) {\n      return call('resources/subscribe', { uri: uri });\n    },\n    unsubscribeResource: function(uri) {\n      return call('resources/unsubscribe', { uri: uri });\n    },\n    onResourceUpdated: function() {\n      console.warn('Resource subscriptions are not supported in daemon mode (HTTP-based, no push).');\n      return function() {};\n    },\n    onNotification: function() {\n      console.warn('Notifications are not supported in daemon mode (HTTP-based, no push).');\n      return function() {};\n    },\n    close: function() {\n      return Promise.resolve();\n    }\n  };\n}\n\nexports.createDaemonClient = createDaemonClient;\n`;\n}\n"]}

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

@@ -50,10 +50,10 @@ function generateCliEntry(options) {
             generateLogoutCommand(appName),
             generateSessionCommands(),
         ] : []),
-        generateServeCommand(serverBundleFilename),
+        generateServeCommand(serverBundleFilename, selfContained),
         generateDoctorCommand(appName, options.nativeDeps),
         generateInstallCommand(appName, options.nativeDeps, selfContained),
-        generateDaemonCommands(appName, serverBundleFilename),
+        generateDaemonCommands(appName, serverBundleFilename, selfContained),
         generateFooter(),
     ];
     return sections.filter(Boolean).join('\n\n');
@@ -81,7 +81,24 @@ function generateHeader(appName, appVersion, description, serverBundleFilename,
     groupEntries.push(`      'Subscriptions': []`);
     groupEntries.push(`      'System': []`);
     return `'use strict';
-
+${selfContained ? `
+// SEA daemon mode: when spawned by 'daemon start', run the server directly
+// using the inlined (bundled) server code — no external requires needed.
+if (process.env.__FRONTMCP_DAEMON_MODE === '1') {
+  require('reflect-metadata');
+  var _dMod = require(${JSON.stringify('../' + serverBundleFilename)});
+  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); });
+  return;
+}
+` : ''}
 var { Command, Option } = require('commander');
 var path = require('path');
 var fs = require('fs');
@@ -762,14 +779,33 @@ workflowCmd
   });`;
 }
 function generateSubscribeCommands() {
-    return `var subscribeCmd = program.command('subscribe').description('Subscribe to updates');
+    return `
+// Subscribe commands need push support (onNotification/onResourceUpdated).
+// Daemon HTTP cannot push, so we force in-process when daemon was used.
+async function getSubscribeClient() {
+  var client = await getClient();
+  // If connected via daemon, the onNotification/onResourceUpdated are no-ops.
+  // Reconnect via in-process for push support.
+  if (client._isDaemon) {
+    _client = null; // clear cached daemon client
+    var mod = require(SERVER_BUNDLE);
+    var configOrClass = mod.default || mod;
+    var sdk = require('@frontmcp/sdk');
+    var connect = sdk.connect || sdk.direct.connect;
+    _client = await connect(configOrClass, { mode: 'cli' });
+    return _client;
+  }
+  return client;
+}
+
+var subscribeCmd = program.command('subscribe').description('Subscribe to updates');
 
 subscribeCmd
   .command('resource <uri>')
   .description('Stream resource updates (Ctrl+C to stop)')
   .action(async function(uri) {
     try {
-      var client = await getClient();
+      var client = await getSubscribeClient();
       await client.subscribeResource(uri);
       var mode = program.opts().output || 'text';
       console.log('Subscribed to resource: ' + uri);
@@ -782,7 +818,9 @@ subscribeCmd
         try { await client.unsubscribeResource(uri); } catch (_) { /* ok */ }
         process.exit(0);
       });
-      // Keep process alive
+      // Keep process alive — setInterval creates an active event loop handle
+      // so Node.js won't exit even with InMemoryTransport (no persistent I/O)
+      setInterval(function() {}, 2147483647);
       await new Promise(function() {});
     } catch (err) {
       console.error('Error:', err.message || err);
@@ -795,7 +833,7 @@ subscribeCmd
   .description('Stream notifications (Ctrl+C to stop)')
   .action(async function(name) {
     try {
-      var client = await getClient();
+      var client = await getSubscribeClient();
       var mode = program.opts().output || 'text';
       console.log('Listening for notification: ' + name);
       console.log('Waiting for events... (Ctrl+C to stop)\\n');
@@ -808,7 +846,9 @@ subscribeCmd
         console.log('\\nStopping...');
         process.exit(0);
       });
-      // Keep process alive
+      // Keep process alive — setInterval creates an active event loop handle
+      // so Node.js won't exit even with InMemoryTransport (no persistent I/O)
+      setInterval(function() {}, 2147483647);
       await new Promise(function() {});
     } catch (err) {
       console.error('Error:', err.message || err);
@@ -933,17 +973,30 @@ program
     console.log('Credentials stored for session: ' + sessionName);
   });`;
 }
-function generateServeCommand(serverBundleFilename) {
+function generateServeCommand(serverBundleFilename, selfContained) {
+    // In self-contained/SEA mode, use a static relative require that esbuild can resolve at bundle time.
+    // In normal mode, use dynamic path.join for runtime resolution from disk.
+    const requireExpr = selfContained
+        ? `require(${JSON.stringify('../' + serverBundleFilename)})`
+        : `require(path.join(SCRIPT_DIR, ${JSON.stringify(serverBundleFilename)}))`;
     return `program
   .command('serve')
   .description('Start the HTTP/SSE server')
   .option('-p, --port <port>', 'Port number', function(v) { return parseInt(v, 10); })
   .action(async function(opts) {
-    var mod = require(path.join(SCRIPT_DIR, ${JSON.stringify(serverBundleFilename)}));
+    var mod = ${requireExpr};
     if (opts.port) process.env.PORT = String(opts.port);
-    // The server bundle should self-start when required
-    if (typeof mod.start === 'function') await mod.start();
-    else if (typeof mod.default?.start === 'function') await mod.default.start();
+    // If the bundle exports a start() function (@FrontMcp-decorated class auto-bootstraps), use it
+    if (typeof mod.start === 'function') { await mod.start(); return; }
+    if (typeof mod.default?.start === 'function') { await mod.default.start(); return; }
+    // Otherwise, bootstrap the plain config object via FrontMcpInstance
+    var raw = mod.default || mod;
+    var sdk = require('@frontmcp/sdk');
+    var FrontMcpInstance = sdk.FrontMcpInstance || sdk.default.FrontMcpInstance;
+    var config = (typeof raw === 'function' && typeof Reflect !== 'undefined' && Reflect.getMetadata)
+      ? (Reflect.getMetadata('__frontmcp:config', raw) || raw) : raw;
+    if (opts.port) config = Object.assign({}, config, { http: Object.assign({}, config.http || {}, { port: opts.port }) });
+    await FrontMcpInstance.bootstrap(config);
   });`;
 }
 function generateDoctorCommand(appName, nativeDeps) {
@@ -1015,6 +1068,10 @@ ${checks.join(',\n')}
     } else {
       console.log('  [!!] App directory not found: ' + appDir);
       ok = false;
+      if (opts.fix) {
+        fs.mkdirSync(appDir, { recursive: true });
+        console.log('      [fixed] Created ' + appDir);
+      }
     }
 
     if (ok) console.log('\\nAll checks passed.');
@@ -1129,7 +1186,7 @@ program
     console.log('Uninstalled ${appName}.');
   });`;
 }
-function generateDaemonCommands(appName, serverBundleFilename) {
+function generateDaemonCommands(appName, serverBundleFilename, selfContained) {
     return `var daemonCmd = program.command('daemon').description('Daemon management');
 
 daemonCmd
@@ -1169,13 +1226,23 @@ daemonCmd
     var out = fs.openSync(logPath, 'a');
     var err = fs.openSync(logPath, 'a');
 
-    // Start the daemon using runUnixSocket via a small wrapper script
+${selfContained ? `    // SEA mode: spawn the binary itself in daemon mode — all code is inlined
+    env.__FRONTMCP_DAEMON_MODE = '1';
+    var child = spawn(process.execPath, [], {
+      detached: true,
+      stdio: ['ignore', out, err],
+      env: env
+    });` : `    // Start the daemon using runUnixSocket 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 = 'var mod = require(' + JSON.stringify(serverBundlePath) + ');' +
+    var daemonScript = 'require("reflect-metadata");' +
+      'var mod = require(' + JSON.stringify(serverBundlePath) + ');' +
       'var sdk = require("@frontmcp/sdk");' +
       'var FrontMcpInstance = sdk.FrontMcpInstance || sdk.default.FrontMcpInstance;' +
-      'var config = mod.default || mod;' +
+      '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); });';
@@ -1184,7 +1251,7 @@ daemonCmd
       detached: true,
       stdio: ['ignore', out, err],
       env: env
-    });
+    });`}
 
     fs.writeFileSync(pidPath, JSON.stringify({
       pid: child.pid,
@@ -1264,7 +1331,11 @@ daemonCmd
   });`;
 }
 function generateFooter() {
-    return `program.parseAsync(process.argv).catch(function(err) {
+    return `program.on('command:*', function(args) {
+  console.error('Unknown command: ' + args[0]);
+  process.exitCode = 1;
+});
+program.parseAsync(process.argv).catch(function(err) {
   console.error('Fatal:', err.message || err);
   process.exit(1);
 });`;