frontmcp 1.0.4 → 1.1.0

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

@@ -0,0 +1,252 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpbManifestSchema = void 0;
+exports.loadPackageJsonMeta = loadPackageJsonMeta;
+exports.parseAuthor = parseAuthor;
+exports.normalizeRepository = normalizeRepository;
+exports.resolveIconPath = resolveIconPath;
+exports.generateMcpbManifest = generateMcpbManifest;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const lazy_zod_1 = require("@frontmcp/lazy-zod");
+const schema_extractor_1 = require("../exec/cli-runtime/schema-extractor");
+const constants_1 = require("./constants");
+// ============================================
+// Zod schema (used by validate.ts)
+// ============================================
+const authorSchema = lazy_zod_1.z
+    .object({
+    name: lazy_zod_1.z.string(),
+    email: lazy_zod_1.z.string().optional(),
+    url: lazy_zod_1.z.string().optional(),
+})
+    .strict();
+const userConfigEntrySchema = lazy_zod_1.z
+    .object({
+    type: lazy_zod_1.z.enum(['string', 'number', 'boolean', 'directory', 'file']),
+    title: lazy_zod_1.z.string(),
+    description: lazy_zod_1.z.string().optional(),
+    required: lazy_zod_1.z.boolean().optional(),
+    default: lazy_zod_1.z.union([lazy_zod_1.z.string(), lazy_zod_1.z.number(), lazy_zod_1.z.boolean()]).optional(),
+    multiple: lazy_zod_1.z.boolean().optional(),
+    sensitive: lazy_zod_1.z.boolean().optional(),
+    min: lazy_zod_1.z.number().optional(),
+    max: lazy_zod_1.z.number().optional(),
+})
+    .strict();
+const mcpConfigSchema = lazy_zod_1.z.lazy(() => lazy_zod_1.z
+    .object({
+    command: lazy_zod_1.z.string(),
+    args: lazy_zod_1.z.array(lazy_zod_1.z.string()).optional(),
+    env: lazy_zod_1.z.record(lazy_zod_1.z.string(), lazy_zod_1.z.string()).optional(),
+    platform_overrides: lazy_zod_1.z.record(lazy_zod_1.z.string(), mcpConfigSchema).optional(),
+})
+    .strict());
+exports.mcpbManifestSchema = lazy_zod_1.z
+    .object({
+    manifest_version: lazy_zod_1.z.string(),
+    name: lazy_zod_1.z.string().min(1),
+    version: lazy_zod_1.z.string().min(1),
+    description: lazy_zod_1.z.string(),
+    display_name: lazy_zod_1.z.string().optional(),
+    long_description: lazy_zod_1.z.string().optional(),
+    author: authorSchema,
+    license: lazy_zod_1.z.string().optional(),
+    homepage: lazy_zod_1.z.string().optional(),
+    repository: lazy_zod_1.z
+        .object({ type: lazy_zod_1.z.string(), url: lazy_zod_1.z.string() })
+        .strict()
+        .optional(),
+    documentation: lazy_zod_1.z.string().optional(),
+    support: lazy_zod_1.z.string().optional(),
+    icon: lazy_zod_1.z.string().optional(),
+    keywords: lazy_zod_1.z.array(lazy_zod_1.z.string()).optional(),
+    privacy_policies: lazy_zod_1.z.array(lazy_zod_1.z.string()).optional(),
+    compatibility: lazy_zod_1.z
+        .object({
+        claude_desktop: lazy_zod_1.z.string().optional(),
+        platforms: lazy_zod_1.z.array(lazy_zod_1.z.enum(['darwin', 'win32', 'linux'])).optional(),
+        runtimes: lazy_zod_1.z
+            .object({ node: lazy_zod_1.z.string().optional(), python: lazy_zod_1.z.string().optional() })
+            .strict()
+            .optional(),
+    })
+        .strict()
+        .optional(),
+    server: lazy_zod_1.z
+        .object({
+        type: lazy_zod_1.z.enum(['node', 'python', 'binary', 'uv']),
+        entry_point: lazy_zod_1.z.string(),
+        mcp_config: mcpConfigSchema,
+    })
+        .strict(),
+    tools: lazy_zod_1.z
+        .array(lazy_zod_1.z.object({ name: lazy_zod_1.z.string(), description: lazy_zod_1.z.string() }).strict())
+        .optional(),
+    tools_generated: lazy_zod_1.z.boolean().optional(),
+    prompts: lazy_zod_1.z
+        .array(lazy_zod_1.z
+        .object({ name: lazy_zod_1.z.string(), description: lazy_zod_1.z.string().optional() })
+        .strict())
+        .optional(),
+    prompts_generated: lazy_zod_1.z.boolean().optional(),
+    user_config: lazy_zod_1.z.record(lazy_zod_1.z.string(), userConfigEntrySchema).optional(),
+    _meta: lazy_zod_1.z.record(lazy_zod_1.z.string(), lazy_zod_1.z.unknown()).optional(),
+})
+    .strict();
+/** Read and parse package.json from the given directory. Returns {} if absent. */
+function loadPackageJsonMeta(cwd) {
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Parse npm-style "Name <email> (url)" into an McpbAuthor.
+ * Falls back to `{ name: <raw> }` when parsing fails.
+ */
+function parseAuthor(author) {
+    if (!author)
+        return { name: 'unknown' };
+    if (typeof author === 'object' && 'name' in author) {
+        const a = author;
+        return {
+            name: a.name,
+            ...(a.email ? { email: a.email } : {}),
+            ...(a.url ? { url: a.url } : {}),
+        };
+    }
+    if (typeof author !== 'string') {
+        return { name: String(author) };
+    }
+    const match = author.match(/^([^<(]+?)(?:\s*<([^>]+)>)?(?:\s*\(([^)]+)\))?$/);
+    if (!match || !match[1])
+        return { name: author };
+    const [, name, email, url] = match;
+    return {
+        name: name.trim(),
+        ...(email ? { email: email.trim() } : {}),
+        ...(url ? { url: url.trim() } : {}),
+    };
+}
+/** Normalize repository field (string → {type, url}). */
+function normalizeRepository(repo) {
+    if (!repo)
+        return undefined;
+    if (typeof repo === 'string') {
+        return { type: 'git', url: repo };
+    }
+    if (typeof repo === 'object' && repo.url) {
+        return { type: repo.type || 'git', url: repo.url };
+    }
+    return undefined;
+}
+/** Resolve first-existing icon path. */
+function resolveIconPath(cwd, deploymentIcon, pkgIcon) {
+    const candidates = [deploymentIcon, pkgIcon, 'icon.png', 'assets/icon.png'].filter((x) => !!x);
+    for (const rel of candidates) {
+        if (fs.existsSync(path.resolve(cwd, rel))) {
+            return rel;
+        }
+    }
+    return undefined;
+}
+/** Produce the final MCPB manifest object. */
+function generateMcpbManifest(input) {
+    const { name, version, cwd, deployment, schema, userConfig, userConfigEnv, platformOverrides, hasIcon, cliVersion, } = input;
+    const pkg = loadPackageJsonMeta(cwd);
+    const description = deployment?.longDescription?.split('\n')[0]?.trim()
+        || pkg.description
+        || '';
+    const author = deployment?.author || parseAuthor(pkg.author);
+    const license = deployment?.license ?? pkg.license;
+    const homepage = deployment?.homepage ?? pkg.homepage;
+    const repository = normalizeRepository(deployment?.repository ?? pkg.repository);
+    const keywords = deployment?.keywords ?? pkg.keywords;
+    const icon = hasIcon ? 'icon.png' : undefined;
+    const nodeVersion = deployment?.compatibility?.runtimes?.node
+        ?? input.nodeVersion
+        ?? constants_1.DEFAULT_NODE_COMPAT;
+    const compatibility = {
+        ...(deployment?.compatibility?.claude_desktop
+            ? { claude_desktop: deployment.compatibility.claude_desktop }
+            : {}),
+        platforms: deployment?.compatibility?.platforms ?? [...constants_1.DEFAULT_PLATFORMS],
+        runtimes: {
+            ...(deployment?.compatibility?.runtimes?.python
+                ? { python: deployment.compatibility.runtimes.python }
+                : {}),
+            node: nodeVersion,
+        },
+    };
+    const tools = schema.tools
+        .filter((t) => !schema_extractor_1.SYSTEM_TOOL_NAMES.has(t.name))
+        .map((t) => ({ name: t.name, description: t.description || '' }));
+    const prompts = schema.prompts.map((p) => ({
+        name: p.name,
+        ...(p.description ? { description: p.description } : {}),
+    }));
+    const mcpConfig = {
+        command: 'node',
+        args: ['${__dirname}/server/index.js'],
+        ...(Object.keys(userConfigEnv).length > 0 ? { env: userConfigEnv } : {}),
+        ...(platformOverrides && Object.keys(platformOverrides).length > 0
+            ? { platform_overrides: platformOverrides }
+            : {}),
+    };
+    const manifest = {
+        manifest_version: constants_1.MCPB_MANIFEST_VERSION,
+        name,
+        version,
+        description,
+        ...(deployment?.displayName ? { display_name: deployment.displayName } : {}),
+        ...(deployment?.longDescription
+            ? { long_description: deployment.longDescription }
+            : {}),
+        author,
+        ...(license ? { license } : {}),
+        ...(homepage ? { homepage } : {}),
+        ...(repository ? { repository } : {}),
+        ...(deployment?.documentation ? { documentation: deployment.documentation } : {}),
+        ...(deployment?.support ? { support: deployment.support } : {}),
+        ...(icon ? { icon } : {}),
+        ...(keywords && keywords.length > 0 ? { keywords } : {}),
+        ...(deployment?.privacyPolicies && deployment.privacyPolicies.length > 0
+            ? { privacy_policies: deployment.privacyPolicies }
+            : {}),
+        compatibility,
+        server: {
+            type: 'node',
+            entry_point: 'server/index.js',
+            mcp_config: mcpConfig,
+        },
+        tools,
+        tools_generated: false,
+        prompts,
+        // FrontMCP prompts resolve dynamically via execute() — MCPB's static `text`
+        // template cannot represent JS logic. Set generated:true so consumers query
+        // the server at runtime while still getting name/description hints here.
+        prompts_generated: true,
+        ...(Object.keys(userConfig).length > 0 ? { user_config: userConfig } : {}),
+        _meta: {
+            'dev.frontmcp.generator': cliVersion ? `frontmcp@${cliVersion}` : 'frontmcp',
+            'dev.frontmcp.capabilities': schema.capabilities,
+        },
+    };
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../../../src/commands/build/mcpb/manifest.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCPB manifest generator + Zod schema for the emitted manifest.\n *\n * Source priority when resolving fields:\n *   deployment.* (frontmcp.config)  >  package.json  >  hard defaults\n *\n * See https://github.com/modelcontextprotocol/mcpb/blob/main/MANIFEST.md\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { z } from '@frontmcp/lazy-zod';\nimport { type ExtractedSchema, SYSTEM_TOOL_NAMES } from '../exec/cli-runtime/schema-extractor';\nimport type {\n  McpbAuthor,\n  McpbCompatibility,\n  McpbDeployment,\n  McpbRepository,\n  McpbUserConfigEntry,\n} from '../../../config/frontmcp-config.types';\nimport {\n  DEFAULT_NODE_COMPAT,\n  DEFAULT_PLATFORMS,\n  MCPB_MANIFEST_VERSION,\n} from './constants';\n\n// ============================================\n// Emitted manifest shape (MCPB v0.3 subset we produce)\n// ============================================\n\nexport interface McpbMcpConfig {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n  platform_overrides?: Record<string, McpbMcpConfig>;\n}\n\nexport interface McpbManifest {\n  manifest_version: string;\n  name: string;\n  version: string;\n  description: string;\n  display_name?: string;\n  long_description?: string;\n  author: McpbAuthor;\n  license?: string;\n  homepage?: string;\n  repository?: { type: string; url: string };\n  documentation?: string;\n  support?: string;\n  icon?: string;\n  keywords?: string[];\n  privacy_policies?: string[];\n  compatibility?: McpbCompatibility;\n  server: {\n    type: 'node' | 'python' | 'binary' | 'uv';\n    entry_point: string;\n    mcp_config: McpbMcpConfig;\n  };\n  tools?: Array<{ name: string; description: string }>;\n  tools_generated?: boolean;\n  prompts?: Array<{ name: string; description?: string }>;\n  prompts_generated?: boolean;\n  user_config?: Record<string, McpbUserConfigEntry>;\n  _meta?: Record<string, unknown>;\n}\n\n// ============================================\n// Zod schema (used by validate.ts)\n// ============================================\n\nconst authorSchema = z\n  .object({\n    name: z.string(),\n    email: z.string().optional(),\n    url: z.string().optional(),\n  })\n  .strict();\n\nconst userConfigEntrySchema = z\n  .object({\n    type: z.enum(['string', 'number', 'boolean', 'directory', 'file']),\n    title: z.string(),\n    description: z.string().optional(),\n    required: z.boolean().optional(),\n    default: z.union([z.string(), z.number(), z.boolean()]).optional(),\n    multiple: z.boolean().optional(),\n    sensitive: z.boolean().optional(),\n    min: z.number().optional(),\n    max: z.number().optional(),\n  })\n  .strict();\n\nconst mcpConfigSchema: z.ZodType<McpbMcpConfig> = z.lazy(() =>\n  z\n    .object({\n      command: z.string(),\n      args: z.array(z.string()).optional(),\n      env: z.record(z.string(), z.string()).optional(),\n      platform_overrides: z.record(z.string(), mcpConfigSchema).optional(),\n    })\n    .strict(),\n);\n\nexport const mcpbManifestSchema = z\n  .object({\n    manifest_version: z.string(),\n    name: z.string().min(1),\n    version: z.string().min(1),\n    description: z.string(),\n    display_name: z.string().optional(),\n    long_description: z.string().optional(),\n    author: authorSchema,\n    license: z.string().optional(),\n    homepage: z.string().optional(),\n    repository: z\n      .object({ type: z.string(), url: z.string() })\n      .strict()\n      .optional(),\n    documentation: z.string().optional(),\n    support: z.string().optional(),\n    icon: z.string().optional(),\n    keywords: z.array(z.string()).optional(),\n    privacy_policies: z.array(z.string()).optional(),\n    compatibility: z\n      .object({\n        claude_desktop: z.string().optional(),\n        platforms: z.array(z.enum(['darwin', 'win32', 'linux'])).optional(),\n        runtimes: z\n          .object({ node: z.string().optional(), python: z.string().optional() })\n          .strict()\n          .optional(),\n      })\n      .strict()\n      .optional(),\n    server: z\n      .object({\n        type: z.enum(['node', 'python', 'binary', 'uv']),\n        entry_point: z.string(),\n        mcp_config: mcpConfigSchema,\n      })\n      .strict(),\n    tools: z\n      .array(z.object({ name: z.string(), description: z.string() }).strict())\n      .optional(),\n    tools_generated: z.boolean().optional(),\n    prompts: z\n      .array(\n        z\n          .object({ name: z.string(), description: z.string().optional() })\n          .strict(),\n      )\n      .optional(),\n    prompts_generated: z.boolean().optional(),\n    user_config: z.record(z.string(), userConfigEntrySchema).optional(),\n    _meta: z.record(z.string(), z.unknown()).optional(),\n  })\n  .strict();\n\n// ============================================\n// Sources + helpers\n// ============================================\n\nexport interface PackageJsonMeta {\n  name?: string;\n  version?: string;\n  description?: string;\n  author?: string | McpbAuthor;\n  license?: string;\n  homepage?: string;\n  repository?: string | { type?: string; url?: string };\n  keywords?: string[];\n  icon?: string;\n}\n\n/** Read and parse package.json from the given directory. Returns {} if absent. */\nexport function loadPackageJsonMeta(cwd: string): PackageJsonMeta {\n  const pkgPath = path.join(cwd, 'package.json');\n  if (!fs.existsSync(pkgPath)) return {};\n  try {\n    return JSON.parse(fs.readFileSync(pkgPath, 'utf-8')) as PackageJsonMeta;\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Parse npm-style \"Name <email> (url)\" into an McpbAuthor.\n * Falls back to `{ name: <raw> }` when parsing fails.\n */\nexport function parseAuthor(author: unknown): McpbAuthor {\n  if (!author) return { name: 'unknown' };\n  if (typeof author === 'object' && 'name' in author) {\n    const a = author as McpbAuthor;\n    return {\n      name: a.name,\n      ...(a.email ? { email: a.email } : {}),\n      ...(a.url ? { url: a.url } : {}),\n    };\n  }\n  if (typeof author !== 'string') {\n    return { name: String(author) };\n  }\n  const match = author.match(/^([^<(]+?)(?:\\s*<([^>]+)>)?(?:\\s*\\(([^)]+)\\))?$/);\n  if (!match || !match[1]) return { name: author };\n  const [, name, email, url] = match;\n  return {\n    name: name.trim(),\n    ...(email ? { email: email.trim() } : {}),\n    ...(url ? { url: url.trim() } : {}),\n  };\n}\n\n/** Normalize repository field (string → {type, url}). */\nexport function normalizeRepository(\n  repo: McpbRepository | PackageJsonMeta['repository'] | undefined,\n): { type: string; url: string } | undefined {\n  if (!repo) return undefined;\n  if (typeof repo === 'string') {\n    return { type: 'git', url: repo };\n  }\n  if (typeof repo === 'object' && repo.url) {\n    return { type: repo.type || 'git', url: repo.url };\n  }\n  return undefined;\n}\n\n/** Resolve first-existing icon path. */\nexport function resolveIconPath(cwd: string, deploymentIcon?: string, pkgIcon?: string): string | undefined {\n  const candidates = [deploymentIcon, pkgIcon, 'icon.png', 'assets/icon.png'].filter(\n    (x): x is string => !!x,\n  );\n  for (const rel of candidates) {\n    if (fs.existsSync(path.resolve(cwd, rel))) {\n      return rel;\n    }\n  }\n  return undefined;\n}\n\n// ============================================\n// Generator input + output\n// ============================================\n\nexport interface GenerateMcpbManifestInput {\n  /** Resolved server name. */\n  name: string;\n  /** Resolved server version. */\n  version: string;\n  /** Optional resolved node version range (e.g., \">=22.0.0\"). */\n  nodeVersion?: string;\n  /** Project root. Used for icon resolution and package.json fallback. */\n  cwd: string;\n  /** Deployment config from frontmcp.config (may be undefined). */\n  deployment?: McpbDeployment;\n  /** Schema extracted from the compiled server bundle. */\n  schema: ExtractedSchema;\n  /** env → user_config reference map built by user-config.ts. */\n  userConfigEnv: Record<string, string>;\n  /** user_config entries built by user-config.ts. */\n  userConfig: Record<string, McpbUserConfigEntry>;\n  /** platform_overrides from binary.ts (may be empty). */\n  platformOverrides?: Record<string, McpbMcpConfig>;\n  /** Whether an icon was copied into the staged archive root. */\n  hasIcon?: boolean;\n  /** Tool name of the CLI version emitting this manifest (for _meta). */\n  cliVersion?: string;\n}\n\n/** Produce the final MCPB manifest object. */\nexport function generateMcpbManifest(input: GenerateMcpbManifestInput): McpbManifest {\n  const {\n    name,\n    version,\n    cwd,\n    deployment,\n    schema,\n    userConfig,\n    userConfigEnv,\n    platformOverrides,\n    hasIcon,\n    cliVersion,\n  } = input;\n\n  const pkg = loadPackageJsonMeta(cwd);\n\n  const description = deployment?.longDescription?.split('\\n')[0]?.trim()\n    || pkg.description\n    || '';\n\n  const author = deployment?.author || parseAuthor(pkg.author);\n  const license = deployment?.license ?? pkg.license;\n  const homepage = deployment?.homepage ?? pkg.homepage;\n  const repository = normalizeRepository(deployment?.repository ?? pkg.repository);\n  const keywords = deployment?.keywords ?? pkg.keywords;\n  const icon = hasIcon ? 'icon.png' : undefined;\n\n  const nodeVersion = deployment?.compatibility?.runtimes?.node\n    ?? input.nodeVersion\n    ?? DEFAULT_NODE_COMPAT;\n\n  const compatibility: McpbCompatibility = {\n    ...(deployment?.compatibility?.claude_desktop\n      ? { claude_desktop: deployment.compatibility.claude_desktop }\n      : {}),\n    platforms: deployment?.compatibility?.platforms ?? [...DEFAULT_PLATFORMS],\n    runtimes: {\n      ...(deployment?.compatibility?.runtimes?.python\n        ? { python: deployment.compatibility.runtimes.python }\n        : {}),\n      node: nodeVersion,\n    },\n  };\n\n  const tools = schema.tools\n    .filter((t) => !SYSTEM_TOOL_NAMES.has(t.name))\n    .map((t) => ({ name: t.name, description: t.description || '' }));\n\n  const prompts = schema.prompts.map((p) => ({\n    name: p.name,\n    ...(p.description ? { description: p.description } : {}),\n  }));\n\n  const mcpConfig: McpbMcpConfig = {\n    command: 'node',\n    args: ['${__dirname}/server/index.js'],\n    ...(Object.keys(userConfigEnv).length > 0 ? { env: userConfigEnv } : {}),\n    ...(platformOverrides && Object.keys(platformOverrides).length > 0\n      ? { platform_overrides: platformOverrides }\n      : {}),\n  };\n\n  const manifest: McpbManifest = {\n    manifest_version: MCPB_MANIFEST_VERSION,\n    name,\n    version,\n    description,\n    ...(deployment?.displayName ? { display_name: deployment.displayName } : {}),\n    ...(deployment?.longDescription\n      ? { long_description: deployment.longDescription }\n      : {}),\n    author,\n    ...(license ? { license } : {}),\n    ...(homepage ? { homepage } : {}),\n    ...(repository ? { repository } : {}),\n    ...(deployment?.documentation ? { documentation: deployment.documentation } : {}),\n    ...(deployment?.support ? { support: deployment.support } : {}),\n    ...(icon ? { icon } : {}),\n    ...(keywords && keywords.length > 0 ? { keywords } : {}),\n    ...(deployment?.privacyPolicies && deployment.privacyPolicies.length > 0\n      ? { privacy_policies: deployment.privacyPolicies }\n      : {}),\n    compatibility,\n    server: {\n      type: 'node',\n      entry_point: 'server/index.js',\n      mcp_config: mcpConfig,\n    },\n    tools,\n    tools_generated: false,\n    prompts,\n    // FrontMCP prompts resolve dynamically via execute() — MCPB's static `text`\n    // template cannot represent JS logic. Set generated:true so consumers query\n    // the server at runtime while still getting name/description hints here.\n    prompts_generated: true,\n    ...(Object.keys(userConfig).length > 0 ? { user_config: userConfig } : {}),\n    _meta: {\n      'dev.frontmcp.generator': cliVersion ? `frontmcp@${cliVersion}` : 'frontmcp',\n      'dev.frontmcp.capabilities': schema.capabilities,\n    },\n  };\n\n  return manifest;\n}\n"]}

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

@@ -0,0 +1,50 @@
+/**
+ * Stage the MCPB archive layout on disk before zipping.
+ *
+ * Layout produced:
+ *
+ *   __stage/
+ *     manifest.json
+ *     server/
+ *       index.js          (esbuild bundle, renamed from {name}.bundle.js)
+ *       package.json      (minimal CJS manifest so Node resolves index.js)
+ *       _skills/          (optional — when the server ships skills)
+ *     bin/                (optional — when SEA is enabled)
+ *       {platform}/{name}[.exe]
+ *     icon.png            (optional)
+ *     README.md           (optional)
+ */
+import type { BinaryEntry } from './binary';
+import type { ExtractedSchema } from '../exec/cli-runtime/schema-extractor';
+export interface StageInput {
+    stageDir: string;
+    /** Project root (for reading README, icon, etc.). */
+    cwd: string;
+    /** Absolute path to the esbuild server bundle. */
+    serverBundlePath: string;
+    /** App name — written into server/package.json. */
+    name: string;
+    /** App version — written into server/package.json. */
+    version: string;
+    /** Schema extracted from the bundle (drives skill asset copy). */
+    schema: ExtractedSchema;
+    /** Absolute path of a resolved icon file (optional). */
+    iconPath?: string;
+    /** Binaries to stage under bin/{platform}/. */
+    binaries?: BinaryEntry[];
+    /** When true, copy README.md from cwd if present. @default true */
+    includeReadme?: boolean;
+}
+export interface StageResult {
+    stageDir: string;
+    /** Relative paths written into the stage (for logging). */
+    written: string[];
+    /** Whether an icon was actually staged (drives manifest.icon field). */
+    hasIcon: boolean;
+    /** Number of skill asset files copied (zero when no skills). */
+    skillAssetCount: number;
+}
+/** Build the staged `__stage/` tree on disk. */
+export declare function stageMcpbDirectory(input: StageInput): StageResult;
+/** Write the final manifest.json to the stage root. */
+export declare function writeManifest(stageDir: string, manifest: unknown): string;

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

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Stage the MCPB archive layout on disk before zipping.
+ *
+ * Layout produced:
+ *
+ *   __stage/
+ *     manifest.json
+ *     server/
+ *       index.js          (esbuild bundle, renamed from {name}.bundle.js)
+ *       package.json      (minimal CJS manifest so Node resolves index.js)
+ *       _skills/          (optional — when the server ships skills)
+ *     bin/                (optional — when SEA is enabled)
+ *       {platform}/{name}[.exe]
+ *     icon.png            (optional)
+ *     README.md           (optional)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stageMcpbDirectory = stageMcpbDirectory;
+exports.writeManifest = writeManifest;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const skill_assets_1 = require("../exec/skill-assets");
+/** Build the staged `__stage/` tree on disk. */
+function stageMcpbDirectory(input) {
+    const { stageDir, cwd, serverBundlePath, name, version, schema, iconPath, binaries = [], includeReadme = true, } = input;
+    const written = [];
+    fs.mkdirSync(stageDir, { recursive: true });
+    // 1. server/
+    const serverDir = path.join(stageDir, 'server');
+    fs.mkdirSync(serverDir, { recursive: true });
+    const serverIndex = path.join(serverDir, 'index.js');
+    fs.copyFileSync(serverBundlePath, serverIndex);
+    written.push('server/index.js');
+    // Minimal server/package.json so Node resolves index.js as CJS.
+    const serverPkg = {
+        name,
+        version,
+        main: 'index.js',
+        type: 'commonjs',
+        private: true,
+    };
+    fs.writeFileSync(path.join(serverDir, 'package.json'), `${JSON.stringify(serverPkg, null, 2)}\n`);
+    written.push('server/package.json');
+    // 2. server/_skills/ (if the bundle exposes skills)
+    const skillsResult = (0, skill_assets_1.copySkillAssets)(serverDir, schema.skillAssets);
+    if (skillsResult.copiedCount > 0) {
+        written.push('server/_skills/');
+    }
+    // 3. bin/{platform}/{file}
+    for (const bin of binaries) {
+        const destDir = path.join(stageDir, 'bin', bin.platform);
+        fs.mkdirSync(destDir, { recursive: true });
+        const destFile = path.join(destDir, bin.fileName);
+        fs.copyFileSync(bin.srcPath, destFile);
+        try {
+            fs.chmodSync(destFile, 0o755);
+        }
+        catch {
+            // Windows or a filesystem that rejects chmod — safe to ignore.
+        }
+        written.push(`bin/${bin.platform}/${bin.fileName}`);
+    }
+    // 4. icon.png
+    let hasIcon = false;
+    if (iconPath && fs.existsSync(iconPath)) {
+        const destIcon = path.join(stageDir, 'icon.png');
+        fs.copyFileSync(iconPath, destIcon);
+        written.push('icon.png');
+        hasIcon = true;
+    }
+    // 5. README.md
+    if (includeReadme) {
+        const readmePath = path.join(cwd, 'README.md');
+        if (fs.existsSync(readmePath)) {
+            fs.copyFileSync(readmePath, path.join(stageDir, 'README.md'));
+            written.push('README.md');
+        }
+    }
+    return {
+        stageDir,
+        written,
+        hasIcon,
+        skillAssetCount: skillsResult.copiedCount,
+    };
+}
+/** Write the final manifest.json to the stage root. */
+function writeManifest(stageDir, manifest) {
+    const manifestPath = path.join(stageDir, 'manifest.json');
+    fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    return manifestPath;
+}
+//# sourceMappingURL=stage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stage.js","sourceRoot":"","sources":["../../../../../src/commands/build/mcpb/stage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Stage the MCPB archive layout on disk before zipping.\n *\n * Layout produced:\n *\n *   __stage/\n *     manifest.json\n *     server/\n *       index.js          (esbuild bundle, renamed from {name}.bundle.js)\n *       package.json      (minimal CJS manifest so Node resolves index.js)\n *       _skills/          (optional — when the server ships skills)\n *     bin/                (optional — when SEA is enabled)\n *       {platform}/{name}[.exe]\n *     icon.png            (optional)\n *     README.md           (optional)\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport type { BinaryEntry } from './binary';\nimport type { ExtractedSchema } from '../exec/cli-runtime/schema-extractor';\nimport { copySkillAssets } from '../exec/skill-assets';\n\nexport interface StageInput {\n  stageDir: string;\n  /** Project root (for reading README, icon, etc.). */\n  cwd: string;\n  /** Absolute path to the esbuild server bundle. */\n  serverBundlePath: string;\n  /** App name — written into server/package.json. */\n  name: string;\n  /** App version — written into server/package.json. */\n  version: string;\n  /** Schema extracted from the bundle (drives skill asset copy). */\n  schema: ExtractedSchema;\n  /** Absolute path of a resolved icon file (optional). */\n  iconPath?: string;\n  /** Binaries to stage under bin/{platform}/. */\n  binaries?: BinaryEntry[];\n  /** When true, copy README.md from cwd if present. @default true */\n  includeReadme?: boolean;\n}\n\nexport interface StageResult {\n  stageDir: string;\n  /** Relative paths written into the stage (for logging). */\n  written: string[];\n  /** Whether an icon was actually staged (drives manifest.icon field). */\n  hasIcon: boolean;\n  /** Number of skill asset files copied (zero when no skills). */\n  skillAssetCount: number;\n}\n\n/** Build the staged `__stage/` tree on disk. */\nexport function stageMcpbDirectory(input: StageInput): StageResult {\n  const {\n    stageDir,\n    cwd,\n    serverBundlePath,\n    name,\n    version,\n    schema,\n    iconPath,\n    binaries = [],\n    includeReadme = true,\n  } = input;\n\n  const written: string[] = [];\n  fs.mkdirSync(stageDir, { recursive: true });\n\n  // 1. server/\n  const serverDir = path.join(stageDir, 'server');\n  fs.mkdirSync(serverDir, { recursive: true });\n\n  const serverIndex = path.join(serverDir, 'index.js');\n  fs.copyFileSync(serverBundlePath, serverIndex);\n  written.push('server/index.js');\n\n  // Minimal server/package.json so Node resolves index.js as CJS.\n  const serverPkg = {\n    name,\n    version,\n    main: 'index.js',\n    type: 'commonjs',\n    private: true,\n  };\n  fs.writeFileSync(\n    path.join(serverDir, 'package.json'),\n    `${JSON.stringify(serverPkg, null, 2)}\\n`,\n  );\n  written.push('server/package.json');\n\n  // 2. server/_skills/ (if the bundle exposes skills)\n  const skillsResult = copySkillAssets(serverDir, schema.skillAssets);\n  if (skillsResult.copiedCount > 0) {\n    written.push('server/_skills/');\n  }\n\n  // 3. bin/{platform}/{file}\n  for (const bin of binaries) {\n    const destDir = path.join(stageDir, 'bin', bin.platform);\n    fs.mkdirSync(destDir, { recursive: true });\n    const destFile = path.join(destDir, bin.fileName);\n    fs.copyFileSync(bin.srcPath, destFile);\n    try {\n      fs.chmodSync(destFile, 0o755);\n    } catch {\n      // Windows or a filesystem that rejects chmod — safe to ignore.\n    }\n    written.push(`bin/${bin.platform}/${bin.fileName}`);\n  }\n\n  // 4. icon.png\n  let hasIcon = false;\n  if (iconPath && fs.existsSync(iconPath)) {\n    const destIcon = path.join(stageDir, 'icon.png');\n    fs.copyFileSync(iconPath, destIcon);\n    written.push('icon.png');\n    hasIcon = true;\n  }\n\n  // 5. README.md\n  if (includeReadme) {\n    const readmePath = path.join(cwd, 'README.md');\n    if (fs.existsSync(readmePath)) {\n      fs.copyFileSync(readmePath, path.join(stageDir, 'README.md'));\n      written.push('README.md');\n    }\n  }\n\n  return {\n    stageDir,\n    written,\n    hasIcon,\n    skillAssetCount: skillsResult.copiedCount,\n  };\n}\n\n/** Write the final manifest.json to the stage root. */\nexport function writeManifest(stageDir: string, manifest: unknown): string {\n  const manifestPath = path.join(stageDir, 'manifest.json');\n  fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`);\n  return manifestPath;\n}\n"]}

package/src/commands/build/mcpb/user-config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Translate FrontMCP `setup.steps` into MCPB `user_config` + `mcp_config.env`.
+ *
+ * MCPB's user_config is a flat key/value form. FrontMCP's setup graph supports
+ * branching (`step.next`) and conditional visibility (`step.showWhen`). Those
+ * features have no MCPB equivalent — we emit a warning and render every step
+ * unconditionally.
+ */
+import { type SetupStep } from '../exec/setup';
+import type { McpbDeployment, McpbUserConfigEntry } from '../../../config/frontmcp-config.types';
+export interface UserConfigTranslationResult {
+    /** MCPB user_config block. */
+    userConfig: Record<string, McpbUserConfigEntry>;
+    /** mcp_config.env map: ENV_NAME → ${user_config.key}. */
+    env: Record<string, string>;
+    /** Warnings to surface to the CLI log. */
+    warnings: string[];
+}
+/** Convert kebab/snake/SCREAMING_SNAKE id to camelCase for the MCPB key. */
+export declare function idToCamelKey(id: string): string;
+/**
+ * Produce MCPB user_config + env mapping from FrontMCP setup steps.
+ * Also applies any per-key `deployment.userConfig` overrides (e.g., to change
+ * type to `file` or `directory`).
+ */
+export declare function setupStepsToUserConfig(steps: SetupStep[] | undefined, deployment?: McpbDeployment): UserConfigTranslationResult;

package/src/commands/build/mcpb/user-config.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Translate FrontMCP `setup.steps` into MCPB `user_config` + `mcp_config.env`.
+ *
+ * MCPB's user_config is a flat key/value form. FrontMCP's setup graph supports
+ * branching (`step.next`) and conditional visibility (`step.showWhen`). Those
+ * features have no MCPB equivalent — we emit a warning and render every step
+ * unconditionally.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.idToCamelKey = idToCamelKey;
+exports.setupStepsToUserConfig = setupStepsToUserConfig;
+const setup_1 = require("../exec/setup");
+const constants_1 = require("./constants");
+/** Convert kebab/snake/SCREAMING_SNAKE id to camelCase for the MCPB key. */
+function idToCamelKey(id) {
+    const normalized = id.replace(/[^a-zA-Z0-9]+/g, ' ').trim().toLowerCase();
+    const parts = normalized.split(/\s+/).filter(Boolean);
+    if (parts.length === 0)
+        return 'value';
+    return parts
+        .map((part, idx) => (idx === 0 ? part : part[0].toUpperCase() + part.slice(1)))
+        .join('');
+}
+/** Resolve the user_config.type for a setup step. */
+function resolveType(jsonSchema, override) {
+    if (override) {
+        return { type: override, multiple: false };
+    }
+    const schemaType = jsonSchema['type'];
+    if (schemaType === 'boolean')
+        return { type: 'boolean', multiple: false };
+    if (schemaType === 'number' || schemaType === 'integer') {
+        return { type: 'number', multiple: false };
+    }
+    if (schemaType === 'array') {
+        const items = jsonSchema['items'];
+        const itemType = items && typeof items === 'object' && 'type' in items
+            ? items.type
+            : 'string';
+        if (itemType === 'number' || itemType === 'integer') {
+            return { type: 'number', multiple: true };
+        }
+        if (itemType === 'boolean') {
+            return { type: 'boolean', multiple: true };
+        }
+        return { type: 'string', multiple: true };
+    }
+    return { type: 'string', multiple: false };
+}
+/**
+ * Produce MCPB user_config + env mapping from FrontMCP setup steps.
+ * Also applies any per-key `deployment.userConfig` overrides (e.g., to change
+ * type to `file` or `directory`).
+ */
+function setupStepsToUserConfig(steps, deployment) {
+    const userConfig = {};
+    const env = {};
+    const warnings = [];
+    if (!steps || steps.length === 0) {
+        // Allow deployment.userConfig to stand alone (no setup graph).
+        if (deployment?.userConfig) {
+            for (const [key, entry] of Object.entries(deployment.userConfig)) {
+                userConfig[key] = entry;
+            }
+        }
+        return { userConfig, env, warnings };
+    }
+    for (const step of steps) {
+        if (step.showWhen || step.next) {
+            warnings.push(`Step "${step.id}" uses showWhen/next — MCPB has no equivalent; rendered unconditionally`);
+        }
+        const jsonSchema = step.jsonSchema ?? (step.schema ? (0, setup_1.zodSchemaToJsonSchema)(step.schema) : { type: 'string' });
+        const key = idToCamelKey(step.id);
+        const override = deployment?.userConfig?.[key];
+        const { type, multiple } = resolveType(jsonSchema, override?.type);
+        const entry = {
+            type,
+            title: override?.title ?? step.prompt,
+            ...(step.description || override?.description
+                ? { description: override?.description ?? step.description }
+                : {}),
+            ...(step.sensitive || override?.sensitive ? { sensitive: true } : {}),
+            ...(multiple || override?.multiple ? { multiple: true } : {}),
+        };
+        const required = inferRequired(jsonSchema, override?.required);
+        if (required)
+            entry.required = true;
+        const defaultVal = jsonSchema['default'] ?? override?.default;
+        if (defaultVal !== undefined && !entry.sensitive) {
+            if ((entry.type === 'string' || entry.type === 'directory' || entry.type === 'file') &&
+                typeof defaultVal === 'string') {
+                entry.default = defaultVal;
+            }
+            else if (entry.type === 'number' && typeof defaultVal === 'number') {
+                entry.default = defaultVal;
+            }
+            else if (entry.type === 'boolean' && typeof defaultVal === 'boolean') {
+                entry.default = defaultVal;
+            }
+        }
+        const min = pickNumber(jsonSchema['minimum'] ?? jsonSchema['minLength']) ?? override?.min;
+        const max = pickNumber(jsonSchema['maximum'] ?? jsonSchema['maxLength']) ?? override?.max;
+        if (min !== undefined)
+            entry.min = min;
+        if (max !== undefined)
+            entry.max = max;
+        // Merge explicit deployment.userConfig fields that weren't captured above.
+        if (override) {
+            for (const prop of ['title', 'description', 'required', 'multiple', 'sensitive', 'min', 'max', 'default']) {
+                if (override[prop] !== undefined && entry[prop] === undefined) {
+                    entry[prop] = override[prop];
+                }
+            }
+        }
+        userConfig[key] = entry;
+        const envName = step.env ?? (0, setup_1.idToEnvName)(step.id);
+        env[envName] = `\${${constants_1.USER_CONFIG_PREFIX}${key}}`;
+    }
+    // Any deployment.userConfig entries not derived from a setup step are merged verbatim.
+    if (deployment?.userConfig) {
+        for (const [key, entry] of Object.entries(deployment.userConfig)) {
+            if (!userConfig[key]) {
+                userConfig[key] = entry;
+            }
+        }
+    }
+    return { userConfig, env, warnings };
+}
+function inferRequired(jsonSchema, override) {
+    if (override !== undefined)
+        return override;
+    // JSON Schema 'required' arrays apply at the parent level; for a single-value
+    // schema, treat missing default + no `.optional()` marker as required.
+    if (jsonSchema['default'] !== undefined)
+        return false;
+    // Best-effort: Zod/v4 encodes optional as a union with undefined or nullable.
+    const anyOf = jsonSchema['anyOf'];
+    if (Array.isArray(anyOf) && anyOf.some((s) => s && typeof s === 'object' && s.type === 'null')) {
+        return false;
+    }
+    return true;
+}
+function pickNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+//# sourceMappingURL=user-config.js.map