frontmcp 1.0.4 → 1.1.0

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

@@ -0,0 +1,20 @@
+/**
+ * buildMcpb() — produce a `.mcpb` archive (MCP Bundle, spec v0.3).
+ *
+ * Pipeline:
+ *   1. Load exec config, resolve entry, compile TypeScript (reuses exec).
+ *   2. Bundle via esbuild (reuses exec's bundler).
+ *   3. Extract tool/prompt/skill schema from the compiled bundle.
+ *   4. Optionally build an SEA binary for the host platform.
+ *   5. Stage the MCPB layout on disk (manifest + server/ + bin/ + icon + README).
+ *   6. Deterministic zip → {outDir}/{name}-{version}.mcpb
+ *   7. Clean up intermediates unless --stage-only.
+ */
+import type { ParsedArgs } from '../../../core/args';
+import { type FrontMcpConfigParsed } from '../../../config';
+import type { McpbDeployment } from '../../../config/frontmcp-config.types';
+export interface BuildMcpbOptions extends ParsedArgs {
+    /** Resolved MCPB deployment config (from frontmcp.config if present). */
+    mcpbDeployment?: McpbDeployment;
+}
+export declare function buildMcpb(opts: BuildMcpbOptions, configParsed?: FrontMcpConfigParsed): Promise<void>;

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

@@ -0,0 +1,241 @@
+"use strict";
+/**
+ * buildMcpb() — produce a `.mcpb` archive (MCP Bundle, spec v0.3).
+ *
+ * Pipeline:
+ *   1. Load exec config, resolve entry, compile TypeScript (reuses exec).
+ *   2. Bundle via esbuild (reuses exec's bundler).
+ *   3. Extract tool/prompt/skill schema from the compiled bundle.
+ *   4. Optionally build an SEA binary for the host platform.
+ *   5. Stage the MCPB layout on disk (manifest + server/ + bin/ + icon + README).
+ *   6. Deterministic zip → {outDir}/{name}-{version}.mcpb
+ *   7. Clean up intermediates unless --stage-only.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMcpb = buildMcpb;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const utils_1 = require("@frontmcp/utils");
+const colors_1 = require("../../../core/colors");
+const fs_1 = require("../../../shared/fs");
+const tsconfig_1 = require("../../../core/tsconfig");
+const config_1 = require("../../../config");
+const config_2 = require("../exec/config");
+const esbuild_bundler_1 = require("../exec/esbuild-bundler");
+const binary_1 = require("./binary");
+const manifest_1 = require("./manifest");
+const user_config_1 = require("./user-config");
+const stage_1 = require("./stage");
+const zip_1 = require("./zip");
+const constants_1 = require("./constants");
+const version_1 = require("../../../core/version");
+async function buildMcpb(opts, configParsed) {
+    const cwd = process.cwd();
+    const outDir = path.resolve(cwd, opts.outDir || 'dist');
+    console.log(`${(0, colors_1.c)('cyan', '[build:mcpb]')} Building MCP Bundle...`);
+    // Snapshot outDir before any build work so cleanup only removes artifacts
+    // this build produced — files the user had sitting there are preserved.
+    const preExistingEntries = fs.existsSync(outDir)
+        ? new Set(fs.readdirSync(outDir))
+        : new Set();
+    // 1. Resolve exec + mcpb config
+    const rawConfig = await (0, config_2.loadExecConfig)(cwd);
+    const execConfig = (0, config_2.normalizeConfig)(rawConfig);
+    // When a v1 frontmcp.config is present, its build.esbuild / build.dependencies
+    // win — the legacy loader returns the raw file without merging these.
+    if (configParsed?.build?.esbuild) {
+        execConfig.esbuild = {
+            ...(execConfig.esbuild ?? {}),
+            ...configParsed.build.esbuild,
+        };
+    }
+    if (configParsed?.build?.dependencies?.nativeAddons) {
+        execConfig.dependencies = {
+            ...(execConfig.dependencies ?? {}),
+            nativeAddons: [
+                ...(execConfig.dependencies?.nativeAddons ?? []),
+                ...configParsed.build.dependencies.nativeAddons,
+            ],
+        };
+    }
+    if (configParsed?.nodeVersion) {
+        execConfig.nodeVersion = configParsed.nodeVersion;
+    }
+    const mcpbDeployment = opts.mcpbDeployment
+        ?? (configParsed ? (0, config_1.findDeployment)(configParsed, 'mcpb') : undefined);
+    console.log(`${(0, colors_1.c)('cyan', '[build:mcpb]')} name: ${execConfig.name}`);
+    console.log(`${(0, colors_1.c)('cyan', '[build:mcpb]')} version: ${execConfig.version}`);
+    // 2. Resolve entry
+    const entry = await (0, fs_1.resolveEntry)(cwd, execConfig.entry || opts.entry);
+    console.log(`${(0, colors_1.c)('cyan', '[build:mcpb]')} entry: ${path.relative(cwd, entry)}`);
+    // 3. TypeScript compile (same as exec pipeline)
+    await (0, utils_1.ensureDir)(outDir);
+    const tsconfigPath = path.join(cwd, 'tsconfig.json');
+    const hasTsconfig = await (0, utils_1.fileExists)(tsconfigPath);
+    const tscArgs = ['-y', 'tsc'];
+    if (hasTsconfig) {
+        tscArgs.push('--project', tsconfigPath);
+    }
+    else {
+        tscArgs.push(entry);
+        tscArgs.push('--rootDir', path.dirname(entry));
+        tscArgs.push('--experimentalDecorators', '--emitDecoratorMetadata');
+        tscArgs.push('--target', tsconfig_1.REQUIRED_DECORATOR_FIELDS.target);
+    }
+    tscArgs.push('--module', 'commonjs', '--outDir', outDir, '--skipLibCheck');
+    await (0, utils_1.runCmd)('npx', tscArgs);
+    console.log(`${(0, colors_1.c)('green', '[build:mcpb]')} TypeScript compiled`);
+    // 4. esbuild bundle → dist/{name}.bundle.js
+    const compiledEntry = path.join(outDir, path.basename(entry).replace(/\.tsx?$/, '.js'));
+    const bundleResult = await (0, esbuild_bundler_1.bundleWithEsbuild)(compiledEntry, outDir, execConfig);
+    console.log(`${(0, colors_1.c)('green', '[build:mcpb]')} bundle: ${path.relative(cwd, bundleResult.bundlePath)} (${(0, esbuild_bundler_1.formatSize)(bundleResult.bundleSize)})`);
+    // 5. Schema extraction
+    const { extractSchemas, SYSTEM_TOOL_NAMES } = await import('../exec/cli-runtime/schema-extractor.js');
+    const schema = await extractSchemas(bundleResult.bundlePath);
+    const userToolCount = schema.tools.filter((t) => !SYSTEM_TOOL_NAMES.has(t.name)).length;
+    console.log(`${(0, colors_1.c)('cyan', '[build:mcpb]')} extracted: ${userToolCount} tools, ${schema.resources.length} resources, ${schema.prompts.length} prompts`);
+    // 6. SEA binaries (optional)
+    const seaRequested = !!(opts.sea || mcpbDeployment?.sea?.enabled);
+    const mergeFrom = opts.mergeFrom ?? mcpbDeployment?.sea?.mergeFrom;
+    const binaries = [];
+    if (seaRequested) {
+        const hostPlatform = (0, binary_1.resolveHostPlatform)();
+        if (!hostPlatform) {
+            console.log(`${(0, colors_1.c)('yellow', '[build:mcpb]')} Unknown host platform ${process.platform}-${process.arch}; skipping SEA build`);
+        }
+        else {
+            console.log(`${(0, colors_1.c)('cyan', '[build:mcpb]')} building SEA binary for ${hostPlatform}...`);
+            const seaBundleName = `${execConfig.name}.sea-temp`;
+            const seaBundle = await (0, esbuild_bundler_1.bundleWithEsbuild)(compiledEntry, outDir, execConfig, {
+                selfContained: true,
+                outputName: seaBundleName,
+            });
+            const { buildSea } = await import('../exec/sea-builder.js');
+            const seaResult = await buildSea(seaBundle.bundlePath, outDir, execConfig.name);
+            fs.unlinkSync(seaBundle.bundlePath);
+            binaries.push({
+                platform: hostPlatform,
+                srcPath: seaResult.executablePath,
+                fileName: (0, binary_1.binaryFileName)(execConfig.name, hostPlatform),
+            });
+            console.log(`${(0, colors_1.c)('green', '[build:mcpb]')} SEA binary: ${path.relative(cwd, seaResult.executablePath)} (${(0, esbuild_bundler_1.formatSize)(seaResult.executableSize)})`);
+        }
+    }
+    if (mergeFrom) {
+        const absMergeDir = path.isAbsolute(mergeFrom) ? mergeFrom : path.resolve(cwd, mergeFrom);
+        const merged = (0, binary_1.mergeBinariesFrom)(absMergeDir, execConfig.name);
+        if (merged.length === 0) {
+            console.log(`${(0, colors_1.c)('yellow', '[build:mcpb]')} mergeFrom "${absMergeDir}" produced no binaries`);
+        }
+        else {
+            console.log(`${(0, colors_1.c)('cyan', '[build:mcpb]')} merging ${merged.length} cross-platform binaries from ${path.relative(cwd, absMergeDir)}`);
+            // Replace any duplicate platform entries from the local SEA build with merge-from versions.
+            for (const bin of merged) {
+                const idx = binaries.findIndex((b) => b.platform === bin.platform);
+                if (idx >= 0)
+                    binaries.splice(idx, 1);
+                binaries.push(bin);
+            }
+        }
+    }
+    // 7. Translate setup steps → user_config + env
+    const { userConfig, env: userConfigEnv, warnings } = (0, user_config_1.setupStepsToUserConfig)(execConfig.setup?.steps, mcpbDeployment);
+    for (const w of warnings) {
+        console.log(`${(0, colors_1.c)('yellow', '[build:mcpb]')} ${w}`);
+    }
+    // 8. Stage — outDir is already {dist}/mcpb (set by buildSingleTarget per-target layout)
+    const stageDir = path.join(outDir, '__stage');
+    if (fs.existsSync(stageDir)) {
+        fs.rmSync(stageDir, { recursive: true, force: true });
+    }
+    const iconOverride = opts.icon ?? mcpbDeployment?.icon;
+    const pkgMeta = (0, manifest_1.loadPackageJsonMeta)(cwd);
+    const iconAbs = (0, manifest_1.resolveIconPath)(cwd, iconOverride, pkgMeta.icon);
+    const iconAbsPath = iconAbs ? path.resolve(cwd, iconAbs) : undefined;
+    const stageResult = (0, stage_1.stageMcpbDirectory)({
+        stageDir,
+        cwd,
+        serverBundlePath: bundleResult.bundlePath,
+        name: execConfig.name,
+        version: execConfig.version,
+        schema,
+        iconPath: iconAbsPath,
+        binaries,
+    });
+    if (stageResult.skillAssetCount > 0) {
+        console.log(`${(0, colors_1.c)('green', '[build:mcpb]')} copied ${stageResult.skillAssetCount} skill asset(s) to server/_skills/`);
+    }
+    if (stageResult.hasIcon) {
+        console.log(`${(0, colors_1.c)('green', '[build:mcpb]')} icon: ${iconAbs}`);
+    }
+    // 9. Manifest
+    const platformOverrides = (0, binary_1.buildPlatformOverrides)(binaries);
+    const manifest = (0, manifest_1.generateMcpbManifest)({
+        name: execConfig.name,
+        version: execConfig.version,
+        nodeVersion: execConfig.nodeVersion,
+        cwd,
+        deployment: mcpbDeployment,
+        schema,
+        userConfig,
+        userConfigEnv,
+        platformOverrides,
+        hasIcon: stageResult.hasIcon,
+        cliVersion: (0, version_1.getSelfVersion)(),
+    });
+    (0, stage_1.writeManifest)(stageDir, manifest);
+    console.log(`${(0, colors_1.c)('green', '[build:mcpb]')} wrote manifest.json`);
+    // 10. Zip (unless --stage-only)
+    if (opts.stageOnly) {
+        console.log(`${(0, colors_1.c)('yellow', '[build:mcpb]')} --stage-only set; leaving ${path.relative(cwd, stageDir)} for inspection`);
+        cleanupIntermediates(outDir, preExistingEntries, ['__stage']);
+        return;
+    }
+    const archivePath = path.join(outDir, `${execConfig.name}-${execConfig.version}.mcpb`);
+    const zipResult = await (0, zip_1.createDeterministicZip)(stageDir, archivePath, {
+        deterministic: !opts.noDeterministic && (mcpbDeployment?.deterministic ?? true),
+    });
+    console.log(`${(0, colors_1.c)('green', '[build:mcpb]')} ${path.relative(cwd, zipResult.archivePath)} (${(0, esbuild_bundler_1.formatSize)(zipResult.size)})`);
+    console.log(`${(0, colors_1.c)('gray', '[build:mcpb]')} sha256: ${zipResult.sha256}`);
+    if (zipResult.size > constants_1.ARCHIVE_SIZE_ERROR) {
+        console.log(`${(0, colors_1.c)('yellow', '[build:mcpb]')} Archive is ${(zipResult.size / 1024 / 1024).toFixed(1)} MB — consider tuning externals`);
+    }
+    else if (zipResult.size > constants_1.ARCHIVE_SIZE_WARN) {
+        console.log(`${(0, colors_1.c)('yellow', '[build:mcpb]')} Archive is ${(zipResult.size / 1024 / 1024).toFixed(1)} MB`);
+    }
+    // 11. Cleanup
+    fs.rmSync(stageDir, { recursive: true, force: true });
+    cleanupIntermediates(outDir, preExistingEntries, [`${execConfig.name}-${execConfig.version}.mcpb`]);
+    console.log(`\n${(0, colors_1.c)('green', 'MCPB build completed.')}`);
+    console.log(`${(0, colors_1.c)('gray', 'Install:')} open ${path.relative(cwd, zipResult.archivePath)}`);
+}
+/**
+ * Remove intermediates this build produced, leaving pre-existing files and the
+ * keep-list alone. The tsc + esbuild stages write intermediates directly into
+ * outDir (same pattern as the exec target uses); we keep the archive and — in
+ * stage-only mode — the `__stage/` directory so the user can inspect it.
+ *
+ * `preExisting` is the set of entries that were in `outDir` before the build
+ * started. Anything in that set is preserved unconditionally so a shared
+ * outDir (e.g., `--out-dir dist` alongside other targets) is not clobbered.
+ */
+function cleanupIntermediates(outDir, preExisting, keep) {
+    if (!fs.existsSync(outDir))
+        return;
+    const keepSet = new Set(keep);
+    for (const entry of fs.readdirSync(outDir)) {
+        if (keepSet.has(entry))
+            continue;
+        if (preExisting.has(entry))
+            continue;
+        const full = path.join(outDir, entry);
+        try {
+            fs.rmSync(full, { recursive: true, force: true });
+        }
+        catch {
+            // best-effort — a race with an external process shouldn't fail the build
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/build/mcpb/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * buildMcpb() — produce a `.mcpb` archive (MCP Bundle, spec v0.3).\n *\n * Pipeline:\n *   1. Load exec config, resolve entry, compile TypeScript (reuses exec).\n *   2. Bundle via esbuild (reuses exec's bundler).\n *   3. Extract tool/prompt/skill schema from the compiled bundle.\n *   4. Optionally build an SEA binary for the host platform.\n *   5. Stage the MCPB layout on disk (manifest + server/ + bin/ + icon + README).\n *   6. Deterministic zip → {outDir}/{name}-{version}.mcpb\n *   7. Clean up intermediates unless --stage-only.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { ensureDir, fileExists, runCmd } from '@frontmcp/utils';\nimport type { ParsedArgs } from '../../../core/args';\nimport { c } from '../../../core/colors';\nimport { resolveEntry } from '../../../shared/fs';\nimport { REQUIRED_DECORATOR_FIELDS } from '../../../core/tsconfig';\nimport { findDeployment, type FrontMcpConfigParsed } from '../../../config';\nimport type { McpbDeployment } from '../../../config/frontmcp-config.types';\nimport { loadExecConfig, normalizeConfig } from '../exec/config';\nimport { bundleWithEsbuild, formatSize } from '../exec/esbuild-bundler';\nimport { buildPlatformOverrides, mergeBinariesFrom, resolveHostPlatform, binaryFileName, type BinaryEntry } from './binary';\nimport { generateMcpbManifest, loadPackageJsonMeta, resolveIconPath } from './manifest';\nimport { setupStepsToUserConfig } from './user-config';\nimport { stageMcpbDirectory, writeManifest } from './stage';\nimport { createDeterministicZip } from './zip';\nimport { ARCHIVE_SIZE_ERROR, ARCHIVE_SIZE_WARN } from './constants';\nimport { getSelfVersion } from '../../../core/version';\n\nexport interface BuildMcpbOptions extends ParsedArgs {\n  /** Resolved MCPB deployment config (from frontmcp.config if present). */\n  mcpbDeployment?: McpbDeployment;\n}\n\nexport async function buildMcpb(\n  opts: BuildMcpbOptions,\n  configParsed?: FrontMcpConfigParsed,\n): Promise<void> {\n  const cwd = process.cwd();\n  const outDir = path.resolve(cwd, opts.outDir || 'dist');\n\n  console.log(`${c('cyan', '[build:mcpb]')} Building MCP Bundle...`);\n\n  // Snapshot outDir before any build work so cleanup only removes artifacts\n  // this build produced — files the user had sitting there are preserved.\n  const preExistingEntries = fs.existsSync(outDir)\n    ? new Set<string>(fs.readdirSync(outDir))\n    : new Set<string>();\n\n  // 1. Resolve exec + mcpb config\n  const rawConfig = await loadExecConfig(cwd);\n  const execConfig = normalizeConfig(rawConfig);\n\n  // When a v1 frontmcp.config is present, its build.esbuild / build.dependencies\n  // win — the legacy loader returns the raw file without merging these.\n  if (configParsed?.build?.esbuild) {\n    execConfig.esbuild = {\n      ...(execConfig.esbuild ?? {}),\n      ...configParsed.build.esbuild,\n    };\n  }\n  if (configParsed?.build?.dependencies?.nativeAddons) {\n    execConfig.dependencies = {\n      ...(execConfig.dependencies ?? {}),\n      nativeAddons: [\n        ...(execConfig.dependencies?.nativeAddons ?? []),\n        ...configParsed.build.dependencies.nativeAddons,\n      ],\n    };\n  }\n  if (configParsed?.nodeVersion) {\n    execConfig.nodeVersion = configParsed.nodeVersion;\n  }\n\n  const mcpbDeployment =\n    opts.mcpbDeployment\n    ?? (configParsed ? (findDeployment(configParsed, 'mcpb') as McpbDeployment | undefined) : undefined);\n\n  console.log(`${c('cyan', '[build:mcpb]')} name: ${execConfig.name}`);\n  console.log(`${c('cyan', '[build:mcpb]')} version: ${execConfig.version}`);\n\n  // 2. Resolve entry\n  const entry = await resolveEntry(cwd, execConfig.entry || opts.entry);\n  console.log(`${c('cyan', '[build:mcpb]')} entry: ${path.relative(cwd, entry)}`);\n\n  // 3. TypeScript compile (same as exec pipeline)\n  await ensureDir(outDir);\n  const tsconfigPath = path.join(cwd, 'tsconfig.json');\n  const hasTsconfig = await fileExists(tsconfigPath);\n  const tscArgs: string[] = ['-y', 'tsc'];\n  if (hasTsconfig) {\n    tscArgs.push('--project', tsconfigPath);\n  } else {\n    tscArgs.push(entry);\n    tscArgs.push('--rootDir', path.dirname(entry));\n    tscArgs.push('--experimentalDecorators', '--emitDecoratorMetadata');\n    tscArgs.push('--target', REQUIRED_DECORATOR_FIELDS.target);\n  }\n  tscArgs.push('--module', 'commonjs', '--outDir', outDir, '--skipLibCheck');\n  await runCmd('npx', tscArgs);\n  console.log(`${c('green', '[build:mcpb]')} TypeScript compiled`);\n\n  // 4. esbuild bundle → dist/{name}.bundle.js\n  const compiledEntry = path.join(outDir, path.basename(entry).replace(/\\.tsx?$/, '.js'));\n  const bundleResult = await bundleWithEsbuild(compiledEntry, outDir, execConfig);\n  console.log(\n    `${c('green', '[build:mcpb]')} bundle: ${path.relative(cwd, bundleResult.bundlePath)} (${formatSize(bundleResult.bundleSize)})`,\n  );\n\n  // 5. Schema extraction\n  const { extractSchemas, SYSTEM_TOOL_NAMES } = await import('../exec/cli-runtime/schema-extractor.js');\n  const schema = await extractSchemas(bundleResult.bundlePath);\n  const userToolCount = schema.tools.filter((t) => !SYSTEM_TOOL_NAMES.has(t.name)).length;\n  console.log(\n    `${c('cyan', '[build:mcpb]')} extracted: ${userToolCount} tools, ${schema.resources.length} resources, ${schema.prompts.length} prompts`,\n  );\n\n  // 6. SEA binaries (optional)\n  const seaRequested = !!(opts.sea || mcpbDeployment?.sea?.enabled);\n  const mergeFrom = opts.mergeFrom ?? mcpbDeployment?.sea?.mergeFrom;\n  const binaries: BinaryEntry[] = [];\n\n  if (seaRequested) {\n    const hostPlatform = resolveHostPlatform();\n    if (!hostPlatform) {\n      console.log(\n        `${c('yellow', '[build:mcpb]')} Unknown host platform ${process.platform}-${process.arch}; skipping SEA build`,\n      );\n    } else {\n      console.log(`${c('cyan', '[build:mcpb]')} building SEA binary for ${hostPlatform}...`);\n      const seaBundleName = `${execConfig.name}.sea-temp`;\n      const seaBundle = await bundleWithEsbuild(compiledEntry, outDir, execConfig, {\n        selfContained: true,\n        outputName: seaBundleName,\n      });\n      const { buildSea } = await import('../exec/sea-builder.js');\n      const seaResult = await buildSea(seaBundle.bundlePath, outDir, execConfig.name);\n      fs.unlinkSync(seaBundle.bundlePath);\n      binaries.push({\n        platform: hostPlatform,\n        srcPath: seaResult.executablePath,\n        fileName: binaryFileName(execConfig.name, hostPlatform),\n      });\n      console.log(\n        `${c('green', '[build:mcpb]')} SEA binary: ${path.relative(cwd, seaResult.executablePath)} (${formatSize(seaResult.executableSize)})`,\n      );\n    }\n  }\n\n  if (mergeFrom) {\n    const absMergeDir = path.isAbsolute(mergeFrom) ? mergeFrom : path.resolve(cwd, mergeFrom);\n    const merged = mergeBinariesFrom(absMergeDir, execConfig.name);\n    if (merged.length === 0) {\n      console.log(`${c('yellow', '[build:mcpb]')} mergeFrom \"${absMergeDir}\" produced no binaries`);\n    } else {\n      console.log(\n        `${c('cyan', '[build:mcpb]')} merging ${merged.length} cross-platform binaries from ${path.relative(cwd, absMergeDir)}`,\n      );\n      // Replace any duplicate platform entries from the local SEA build with merge-from versions.\n      for (const bin of merged) {\n        const idx = binaries.findIndex((b) => b.platform === bin.platform);\n        if (idx >= 0) binaries.splice(idx, 1);\n        binaries.push(bin);\n      }\n    }\n  }\n\n  // 7. Translate setup steps → user_config + env\n  const { userConfig, env: userConfigEnv, warnings } = setupStepsToUserConfig(\n    execConfig.setup?.steps,\n    mcpbDeployment,\n  );\n  for (const w of warnings) {\n    console.log(`${c('yellow', '[build:mcpb]')} ${w}`);\n  }\n\n  // 8. Stage — outDir is already {dist}/mcpb (set by buildSingleTarget per-target layout)\n  const stageDir = path.join(outDir, '__stage');\n  if (fs.existsSync(stageDir)) {\n    fs.rmSync(stageDir, { recursive: true, force: true });\n  }\n  const iconOverride = opts.icon ?? mcpbDeployment?.icon;\n  const pkgMeta = loadPackageJsonMeta(cwd);\n  const iconAbs = resolveIconPath(cwd, iconOverride, pkgMeta.icon);\n  const iconAbsPath = iconAbs ? path.resolve(cwd, iconAbs) : undefined;\n\n  const stageResult = stageMcpbDirectory({\n    stageDir,\n    cwd,\n    serverBundlePath: bundleResult.bundlePath,\n    name: execConfig.name,\n    version: execConfig.version,\n    schema,\n    iconPath: iconAbsPath,\n    binaries,\n  });\n  if (stageResult.skillAssetCount > 0) {\n    console.log(`${c('green', '[build:mcpb]')} copied ${stageResult.skillAssetCount} skill asset(s) to server/_skills/`);\n  }\n  if (stageResult.hasIcon) {\n    console.log(`${c('green', '[build:mcpb]')} icon: ${iconAbs}`);\n  }\n\n  // 9. Manifest\n  const platformOverrides = buildPlatformOverrides(binaries);\n  const manifest = generateMcpbManifest({\n    name: execConfig.name,\n    version: execConfig.version,\n    nodeVersion: execConfig.nodeVersion,\n    cwd,\n    deployment: mcpbDeployment,\n    schema,\n    userConfig,\n    userConfigEnv,\n    platformOverrides,\n    hasIcon: stageResult.hasIcon,\n    cliVersion: getSelfVersion(),\n  });\n  writeManifest(stageDir, manifest);\n  console.log(`${c('green', '[build:mcpb]')} wrote manifest.json`);\n\n  // 10. Zip (unless --stage-only)\n  if (opts.stageOnly) {\n    console.log(`${c('yellow', '[build:mcpb]')} --stage-only set; leaving ${path.relative(cwd, stageDir)} for inspection`);\n    cleanupIntermediates(outDir, preExistingEntries, ['__stage']);\n    return;\n  }\n\n  const archivePath = path.join(outDir, `${execConfig.name}-${execConfig.version}.mcpb`);\n  const zipResult = await createDeterministicZip(stageDir, archivePath, {\n    deterministic: !opts.noDeterministic && (mcpbDeployment?.deterministic ?? true),\n  });\n  console.log(\n    `${c('green', '[build:mcpb]')} ${path.relative(cwd, zipResult.archivePath)} (${formatSize(zipResult.size)})`,\n  );\n  console.log(`${c('gray', '[build:mcpb]')} sha256: ${zipResult.sha256}`);\n\n  if (zipResult.size > ARCHIVE_SIZE_ERROR) {\n    console.log(\n      `${c('yellow', '[build:mcpb]')} Archive is ${(zipResult.size / 1024 / 1024).toFixed(1)} MB — consider tuning externals`,\n    );\n  } else if (zipResult.size > ARCHIVE_SIZE_WARN) {\n    console.log(`${c('yellow', '[build:mcpb]')} Archive is ${(zipResult.size / 1024 / 1024).toFixed(1)} MB`);\n  }\n\n  // 11. Cleanup\n  fs.rmSync(stageDir, { recursive: true, force: true });\n  cleanupIntermediates(outDir, preExistingEntries, [`${execConfig.name}-${execConfig.version}.mcpb`]);\n\n  console.log(`\\n${c('green', 'MCPB build completed.')}`);\n  console.log(`${c('gray', 'Install:')} open ${path.relative(cwd, zipResult.archivePath)}`);\n}\n\n/**\n * Remove intermediates this build produced, leaving pre-existing files and the\n * keep-list alone. The tsc + esbuild stages write intermediates directly into\n * outDir (same pattern as the exec target uses); we keep the archive and — in\n * stage-only mode — the `__stage/` directory so the user can inspect it.\n *\n * `preExisting` is the set of entries that were in `outDir` before the build\n * started. Anything in that set is preserved unconditionally so a shared\n * outDir (e.g., `--out-dir dist` alongside other targets) is not clobbered.\n */\nfunction cleanupIntermediates(outDir: string, preExisting: Set<string>, keep: string[]): void {\n  if (!fs.existsSync(outDir)) return;\n  const keepSet = new Set(keep);\n  for (const entry of fs.readdirSync(outDir)) {\n    if (keepSet.has(entry)) continue;\n    if (preExisting.has(entry)) continue;\n    const full = path.join(outDir, entry);\n    try {\n      fs.rmSync(full, { recursive: true, force: true });\n    } catch {\n      // best-effort — a race with an external process shouldn't fail the build\n    }\n  }\n}\n"]}

package/src/commands/build/mcpb/manifest.d.ts

@@ -0,0 +1,183 @@
+/**
+ * MCPB manifest generator + Zod schema for the emitted manifest.
+ *
+ * Source priority when resolving fields:
+ *   deployment.* (frontmcp.config)  >  package.json  >  hard defaults
+ *
+ * See https://github.com/modelcontextprotocol/mcpb/blob/main/MANIFEST.md
+ */
+import { z } from '@frontmcp/lazy-zod';
+import { type ExtractedSchema } from '../exec/cli-runtime/schema-extractor';
+import type { McpbAuthor, McpbCompatibility, McpbDeployment, McpbRepository, McpbUserConfigEntry } from '../../../config/frontmcp-config.types';
+export interface McpbMcpConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    platform_overrides?: Record<string, McpbMcpConfig>;
+}
+export interface McpbManifest {
+    manifest_version: string;
+    name: string;
+    version: string;
+    description: string;
+    display_name?: string;
+    long_description?: string;
+    author: McpbAuthor;
+    license?: string;
+    homepage?: string;
+    repository?: {
+        type: string;
+        url: string;
+    };
+    documentation?: string;
+    support?: string;
+    icon?: string;
+    keywords?: string[];
+    privacy_policies?: string[];
+    compatibility?: McpbCompatibility;
+    server: {
+        type: 'node' | 'python' | 'binary' | 'uv';
+        entry_point: string;
+        mcp_config: McpbMcpConfig;
+    };
+    tools?: Array<{
+        name: string;
+        description: string;
+    }>;
+    tools_generated?: boolean;
+    prompts?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    prompts_generated?: boolean;
+    user_config?: Record<string, McpbUserConfigEntry>;
+    _meta?: Record<string, unknown>;
+}
+export declare const mcpbManifestSchema: import("@frontmcp/lazy-zod").ZodObject<{
+    manifest_version: import("@frontmcp/lazy-zod").ZodString;
+    name: import("@frontmcp/lazy-zod").ZodString;
+    version: import("@frontmcp/lazy-zod").ZodString;
+    description: import("@frontmcp/lazy-zod").ZodString;
+    display_name: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    long_description: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    author: import("@frontmcp/lazy-zod").ZodObject<{
+        name: import("@frontmcp/lazy-zod").ZodString;
+        email: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+        url: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    }, import("zod/v4/core").$strict>;
+    license: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    homepage: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    repository: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodObject<{
+        type: import("@frontmcp/lazy-zod").ZodString;
+        url: import("@frontmcp/lazy-zod").ZodString;
+    }, import("zod/v4/core").$strict>>;
+    documentation: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    support: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    icon: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    keywords: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
+    privacy_policies: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>>;
+    compatibility: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodObject<{
+        claude_desktop: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+        platforms: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodEnum<{
+            darwin: "darwin";
+            win32: "win32";
+            linux: "linux";
+        }>>>;
+        runtimes: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodObject<{
+            node: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+            python: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+        }, import("zod/v4/core").$strict>>;
+    }, import("zod/v4/core").$strict>>;
+    server: import("@frontmcp/lazy-zod").ZodObject<{
+        type: import("@frontmcp/lazy-zod").ZodEnum<{
+            node: "node";
+            binary: "binary";
+            python: "python";
+            uv: "uv";
+        }>;
+        entry_point: import("@frontmcp/lazy-zod").ZodString;
+        mcp_config: z.ZodType<McpbMcpConfig, unknown>;
+    }, import("zod/v4/core").$strict>;
+    tools: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodObject<{
+        name: import("@frontmcp/lazy-zod").ZodString;
+        description: import("@frontmcp/lazy-zod").ZodString;
+    }, import("zod/v4/core").$strict>>>;
+    tools_generated: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodBoolean>;
+    prompts: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodObject<{
+        name: import("@frontmcp/lazy-zod").ZodString;
+        description: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    }, import("zod/v4/core").$strict>>>;
+    prompts_generated: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodBoolean>;
+    user_config: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodRecord<import("@frontmcp/lazy-zod").ZodString, import("@frontmcp/lazy-zod").ZodObject<{
+        type: import("@frontmcp/lazy-zod").ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            directory: "directory";
+            file: "file";
+        }>;
+        title: import("@frontmcp/lazy-zod").ZodString;
+        description: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+        required: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodBoolean>;
+        default: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodUnion<readonly [import("@frontmcp/lazy-zod").ZodString, import("@frontmcp/lazy-zod").ZodNumber, import("@frontmcp/lazy-zod").ZodBoolean]>>;
+        multiple: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodBoolean>;
+        sensitive: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodBoolean>;
+        min: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>;
+        max: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>;
+    }, import("zod/v4/core").$strict>>>;
+    _meta: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodRecord<import("@frontmcp/lazy-zod").ZodString, import("@frontmcp/lazy-zod").ZodUnknown>>;
+}, import("zod/v4/core").$strict>;
+export interface PackageJsonMeta {
+    name?: string;
+    version?: string;
+    description?: string;
+    author?: string | McpbAuthor;
+    license?: string;
+    homepage?: string;
+    repository?: string | {
+        type?: string;
+        url?: string;
+    };
+    keywords?: string[];
+    icon?: string;
+}
+/** Read and parse package.json from the given directory. Returns {} if absent. */
+export declare function loadPackageJsonMeta(cwd: string): PackageJsonMeta;
+/**
+ * Parse npm-style "Name <email> (url)" into an McpbAuthor.
+ * Falls back to `{ name: <raw> }` when parsing fails.
+ */
+export declare function parseAuthor(author: unknown): McpbAuthor;
+/** Normalize repository field (string → {type, url}). */
+export declare function normalizeRepository(repo: McpbRepository | PackageJsonMeta['repository'] | undefined): {
+    type: string;
+    url: string;
+} | undefined;
+/** Resolve first-existing icon path. */
+export declare function resolveIconPath(cwd: string, deploymentIcon?: string, pkgIcon?: string): string | undefined;
+export interface GenerateMcpbManifestInput {
+    /** Resolved server name. */
+    name: string;
+    /** Resolved server version. */
+    version: string;
+    /** Optional resolved node version range (e.g., ">=22.0.0"). */
+    nodeVersion?: string;
+    /** Project root. Used for icon resolution and package.json fallback. */
+    cwd: string;
+    /** Deployment config from frontmcp.config (may be undefined). */
+    deployment?: McpbDeployment;
+    /** Schema extracted from the compiled server bundle. */
+    schema: ExtractedSchema;
+    /** env → user_config reference map built by user-config.ts. */
+    userConfigEnv: Record<string, string>;
+    /** user_config entries built by user-config.ts. */
+    userConfig: Record<string, McpbUserConfigEntry>;
+    /** platform_overrides from binary.ts (may be empty). */
+    platformOverrides?: Record<string, McpbMcpConfig>;
+    /** Whether an icon was copied into the staged archive root. */
+    hasIcon?: boolean;
+    /** Tool name of the CLI version emitting this manifest (for _meta). */
+    cliVersion?: string;
+}
+/** Produce the final MCPB manifest object. */
+export declare function generateMcpbManifest(input: GenerateMcpbManifestInput): McpbManifest;