@mcpmake/core 0.2.0

package/dist/emitter/index.js

@@ -0,0 +1,297 @@
+import { writeCodeUnits } from './code-writer.js';
+import { scaffoldProjectFiles, scaffoldSharedModules } from './project-scaffolder.js';
+import { scaffoldSiteProjectFiles, scaffoldSiteSharedModules } from './site-scaffolder.js';
+import { renderTemplate } from './template-loader.js';
+import { renderSiteTemplate } from './site-template-loader.js';
+import { renderPythonTemplate } from './python-template-loader.js';
+import { renderWorkerTemplate } from './worker-template-loader.js';
+import { buildCatalog } from '../transformer/catalog-builder.js';
+import { logger } from '../utils/logger.js';
+const SAFE_VERSION_RE = /^[0-9a-zA-Z._+-]{1,50}$/;
+/**
+ * Serialize named environments for the generated `.env.example` / `.dev.vars`
+ * seed (the `MCP_ENVIRONMENTS` JSON map). Returns undefined when none are set,
+ * so the templates keep their commented placeholder for normal output.
+ */
+function environmentsJson(manifest) {
+    return manifest.environments && Object.keys(manifest.environments).length > 0
+        ? JSON.stringify(manifest.environments)
+        : undefined;
+}
+export async function emitProject(manifest, options) {
+    // Cloudflare Workers target uses a separate (stateless Fetch-handler) pipeline.
+    if (manifest.target === 'cloudflare') {
+        return emitWorkerProject(manifest, options);
+    }
+    if (!/^[a-z0-9][a-z0-9._-]*$/.test(manifest.serverName)) {
+        throw new Error(`Invalid server name: "${manifest.serverName}". Must match /^[a-z0-9][a-z0-9._-]*$/`);
+    }
+    if (!SAFE_VERSION_RE.test(manifest.serverVersion)) {
+        logger.warn(`Unsafe server version "${manifest.serverVersion}" sanitized to "0.0.0"`);
+        manifest = { ...manifest, serverVersion: '0.0.0' };
+    }
+    const units = [];
+    // Project skeleton
+    units.push(...scaffoldProjectFiles(manifest));
+    // Shared source modules
+    units.push(...scaffoldSharedModules(manifest));
+    // Task manager (if any async operations detected)
+    const hasAsyncTools = manifest.tools.some((t) => t.isAsync);
+    if (hasAsyncTools) {
+        units.push({
+            filePath: 'src/task-manager.ts',
+            content: renderTemplate('task-manager.ts', manifest),
+        });
+        units.push({
+            filePath: 'src/task-handlers.ts',
+            content: renderTemplate('task-handlers.ts', manifest),
+        });
+        units.push({
+            filePath: 'src/task-sse.ts',
+            content: renderTemplate('task-sse.ts', manifest),
+        });
+    }
+    // OAuth module (if OAuth2 auth detected)
+    const hasOAuth = manifest.authSchemes.some((s) => s.type === 'oauth2');
+    if (hasOAuth) {
+        units.push({
+            filePath: 'src/oauth.ts',
+            content: renderTemplate('oauth.ts', manifest),
+        });
+    }
+    if (manifest.dynamicDiscovery) {
+        // Dynamic discovery mode: emit catalog + discovery meta-tools
+        const catalog = buildCatalog(manifest.tools);
+        units.push({
+            filePath: 'src/tool-catalog.json',
+            content: JSON.stringify(catalog, null, 2),
+        });
+        units.push({
+            filePath: 'src/discovery.ts',
+            content: renderTemplate('discovery.ts', manifest),
+        });
+        // Hybrid mode: also register first N tools statically
+        const staticCount = manifest.staticToolCount ?? 0;
+        const staticTools = manifest.tools.slice(0, staticCount);
+        if (staticTools.length > 0) {
+            for (const tool of staticTools) {
+                units.push({
+                    filePath: `src/tools/${tool.fileName}.ts`,
+                    content: renderTemplate('tool-handler.ts', tool),
+                });
+            }
+            units.push({
+                filePath: 'src/tools/index.ts',
+                content: renderTemplate('tool-index.ts', { tools: staticTools }),
+            });
+        }
+        logger.info(`Dynamic discovery: ${catalog.length} tools in catalog` +
+            (staticTools.length > 0 ? `, ${staticTools.length} static` : ''));
+    }
+    else {
+        // Standard mode: emit all tools individually
+        for (const tool of manifest.tools) {
+            units.push({
+                filePath: `src/tools/${tool.fileName}.ts`,
+                content: renderTemplate('tool-handler.ts', tool),
+            });
+        }
+        units.push({
+            filePath: 'src/tools/index.ts',
+            content: renderTemplate('tool-index.ts', { tools: manifest.tools }),
+        });
+    }
+    // Resources file (if any GET list endpoints exist)
+    if (manifest.resources && manifest.resources.length > 0) {
+        units.push({
+            filePath: 'src/resources.ts',
+            content: renderTemplate('resources.ts', { resources: manifest.resources }),
+        });
+    }
+    // Prompts file (if any)
+    if (manifest.prompts && manifest.prompts.length > 0) {
+        units.push({
+            filePath: 'src/prompts.ts',
+            content: renderTemplate('prompts.ts', { prompts: manifest.prompts }),
+        });
+    }
+    // Test files for each tool
+    for (const tool of manifest.tools) {
+        units.push({
+            filePath: `test/tools/${tool.fileName}.test.ts`,
+            content: renderTemplate('tool-test.ts', tool),
+        });
+    }
+    logger.info(`Writing ${units.length} files to ${options.outputDir}`);
+    await writeCodeUnits(units, options.outputDir, options);
+}
+/**
+ * Emit a Cloudflare Workers MCP server project (the `--target cloudflare` path).
+ *
+ * Workers is stateless and has no node:http server, so the SDK's
+ * StreamableHTTPServerTransport cannot run there. The entry (`src/index.ts`) is a
+ * hand-rolled JSON-RPC Fetch handler instead. The runtime-agnostic modules
+ * (`http.ts`, `auth.ts`, `trace.ts`) are reused verbatim from the Node templates —
+ * they only need `nodejs_compat`, which `wrangler.toml` enables.
+ *
+ * v1 scope is tools + initialize/ping/server-discover + bearer auth. Resources,
+ * prompts, the Tasks extension and OAuth2 outbound auth are not emitted for this
+ * target (a warning is logged and the user is pointed at `--target node`).
+ */
+export async function emitWorkerProject(manifest, options) {
+    if (!/^[a-z0-9][a-z0-9._-]*$/.test(manifest.serverName)) {
+        throw new Error(`Invalid server name: "${manifest.serverName}". Must match /^[a-z0-9][a-z0-9._-]*$/`);
+    }
+    if (!SAFE_VERSION_RE.test(manifest.serverVersion)) {
+        logger.warn(`Unsafe server version "${manifest.serverVersion}" sanitized to "0.0.0"`);
+        manifest = { ...manifest, serverVersion: '0.0.0' };
+    }
+    // Warn about features the Workers target does not emit (so nothing is silently
+    // dropped). Tools — the dominant case — are always fully emitted.
+    if ((manifest.resources?.length ?? 0) > 0 || (manifest.prompts?.length ?? 0) > 0) {
+        logger.warn(`Cloudflare target emits tools only — ${manifest.resources?.length ?? 0} resource(s) ` +
+            `and ${manifest.prompts?.length ?? 0} prompt(s) omitted. Use --target node to include them.`);
+    }
+    if (manifest.tools.some((t) => t.isAsync)) {
+        logger.warn('Cloudflare target: async tools run synchronously within the request (no Tasks extension / background polling).');
+    }
+    if (manifest.dynamicDiscovery) {
+        logger.warn('Cloudflare target does not support --dynamic-discovery; emitting all tools individually.');
+    }
+    const workerAuthSchemes = manifest.authSchemes.filter((s) => s.type !== 'oauth2');
+    if (workerAuthSchemes.length !== manifest.authSchemes.length) {
+        logger.warn('Cloudflare target: OAuth2 outbound auth is omitted (apiKey / bearer / basic are supported). Use --target node for OAuth2.');
+    }
+    const authEnvVars = manifest.envVars.filter((v) => v.name !== 'BASE_URL');
+    // The reused auth + config modules must see the filtered (no-oauth2) schemes so
+    // they never reference an un-emitted oauth.ts.
+    const templateData = {
+        ...manifest,
+        authSchemes: workerAuthSchemes,
+        authEnvVars,
+        hasOAuth: false,
+        environmentsJson: environmentsJson(manifest),
+    };
+    const units = [
+        // Worker-specific files.
+        { filePath: 'src/index.ts', content: renderWorkerTemplate('worker.ts', templateData) },
+        { filePath: 'src/config.ts', content: renderWorkerTemplate('config.ts', templateData) },
+        { filePath: 'package.json', content: renderWorkerTemplate('package.json', templateData) },
+        { filePath: 'tsconfig.json', content: renderWorkerTemplate('tsconfig.json', templateData) },
+        { filePath: 'wrangler.toml', content: renderWorkerTemplate('wrangler.toml', templateData) },
+        { filePath: 'README.md', content: renderWorkerTemplate('readme.md', templateData) },
+        {
+            filePath: '.dev.vars.example',
+            content: renderWorkerTemplate('dev-vars.example', templateData),
+        },
+        { filePath: '.gitignore', content: renderWorkerTemplate('gitignore', templateData) },
+        // Runtime-agnostic modules reused from the Node templates (fetch / Buffer /
+        // AsyncLocalStorage — all covered by nodejs_compat).
+        { filePath: 'src/http.ts', content: renderTemplate('http-executor.ts', templateData) },
+        {
+            filePath: 'src/response-filter.ts',
+            content: renderTemplate('response-filter.ts', templateData),
+        },
+        { filePath: 'src/auth.ts', content: renderTemplate('auth-provider.ts', templateData) },
+        { filePath: 'src/trace.ts', content: renderTemplate('trace.ts', templateData) },
+    ];
+    for (const tool of manifest.tools) {
+        units.push({
+            filePath: `src/tools/${tool.fileName}.ts`,
+            content: renderWorkerTemplate('tool-handler.ts', tool),
+        });
+    }
+    units.push({
+        filePath: 'src/tools/index.ts',
+        content: renderWorkerTemplate('tool-index.ts', { tools: manifest.tools }),
+    });
+    units.push({
+        filePath: 'test/server.test.ts',
+        content: renderWorkerTemplate('server.test.ts', templateData),
+    });
+    logger.info(`Writing ${units.length} Workers files to ${options.outputDir}`);
+    await writeCodeUnits(units, options.outputDir, options);
+}
+/**
+ * Emit a Playwright-based MCP server project from a SiteProjectManifest.
+ * Parallel to emitProject() but uses site-specific templates.
+ */
+export async function emitSiteProject(manifest, options) {
+    if (!/^[a-z0-9][a-z0-9._-]*$/.test(manifest.serverName)) {
+        throw new Error(`Invalid server name: "${manifest.serverName}". Must match /^[a-z0-9][a-z0-9._-]*$/`);
+    }
+    if (!SAFE_VERSION_RE.test(manifest.serverVersion)) {
+        logger.warn(`Unsafe server version "${manifest.serverVersion}" sanitized to "0.0.0"`);
+        manifest = { ...manifest, serverVersion: '0.0.0' };
+    }
+    const units = [];
+    // Project skeleton (package.json, tsconfig, Dockerfile, .env.example, .gitignore)
+    units.push(...scaffoldSiteProjectFiles(manifest));
+    // Shared source modules (server entry, config, browser-manager, site-descriptor.json)
+    units.push(...scaffoldSiteSharedModules(manifest));
+    // Tool files — choose template based on tool type
+    for (const tool of manifest.tools) {
+        const templateName = getSiteToolTemplate(tool);
+        units.push({
+            filePath: `src/tools/${tool.fileName}.ts`,
+            content: renderSiteTemplate(templateName, tool),
+        });
+    }
+    // Tool index (registers all tools)
+    units.push({
+        filePath: 'src/tools/index.ts',
+        content: renderSiteTemplate('tool-index.ts', { tools: manifest.tools }),
+    });
+    logger.info(`Writing ${units.length} files to ${options.outputDir}`);
+    await writeCodeUnits(units, options.outputDir, options);
+}
+/** Pick the right template for a site tool based on its type. */
+function getSiteToolTemplate(tool) {
+    switch (tool.toolType) {
+        case 'browser-lifecycle':
+            return 'tool-handler-lifecycle.ts';
+        case 'page-action':
+            return 'tool-handler-form.ts';
+        case 'element-action':
+        case 'navigation':
+            return 'tool-handler-action.ts';
+        default:
+            return 'tool-handler-action.ts';
+    }
+}
+/**
+ * Emit a Python MCP server project.
+ * Generates a single server.py file with all tools, plus requirements.txt.
+ */
+export async function emitPythonProject(manifest, options) {
+    if (!/^[a-z0-9][a-z0-9._-]*$/.test(manifest.serverName)) {
+        throw new Error(`Invalid server name: "${manifest.serverName}". Must match /^[a-z0-9][a-z0-9._-]*$/`);
+    }
+    const units = [];
+    const templateData = {
+        ...manifest,
+        authEnvVars: manifest.envVars.filter((v) => v.name !== 'BASE_URL'),
+        environmentsJson: environmentsJson(manifest),
+    };
+    units.push({
+        filePath: 'server.py',
+        content: renderPythonTemplate('server.py', templateData),
+    });
+    units.push({
+        filePath: 'requirements.txt',
+        content: renderPythonTemplate('requirements.txt', manifest),
+    });
+    units.push({
+        filePath: '.env.example',
+        content: renderPythonTemplate('env.example', templateData),
+    });
+    if (manifest.transport === 'http') {
+        units.push({
+            filePath: 'Dockerfile',
+            content: renderPythonTemplate('dockerfile', manifest),
+        });
+    }
+    logger.info(`Writing ${units.length} Python files to ${options.outputDir}`);
+    await writeCodeUnits(units, options.outputDir, options);
+}
+//# sourceMappingURL=index.js.map

package/dist/emitter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/emitter/index.ts"],"names":[],"mappings":"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"}

package/dist/emitter/mcpb-bundler.d.ts

@@ -0,0 +1,32 @@
+export interface McpbManifest {
+    schema_version: string;
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    license: string;
+    runtime: string;
+    entry_point: string;
+    tools: {
+        name: string;
+        description: string;
+    }[];
+    env_vars: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+}
+/**
+ * Generate an .mcpb bundle from a built MCP server project.
+ *
+ * The bundle is a zip file containing:
+ *   manifest.json  - metadata, tool list, config schema
+ *   server/        - the Node.js server code (package.json, dist/, node_modules/)
+ */
+export declare function generateMcpb(opts: {
+    projectDir: string;
+    outputPath?: string;
+    manifest?: Partial<McpbManifest>;
+}): Promise<string>;
+//# sourceMappingURL=mcpb-bundler.d.ts.map

package/dist/emitter/mcpb-bundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpb-bundler.d.ts","sourceRoot":"","sources":["../../src/emitter/mcpb-bundler.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CACtE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAClC,GAAG,OAAO,CAAC,MAAM,CAAC,CAqFlB"}

package/dist/emitter/mcpb-bundler.js

@@ -0,0 +1,173 @@
+import { readFile, readdir, mkdtemp, rm, cp, writeFile } from 'node:fs/promises';
+import { resolve, join, basename } from 'node:path';
+import { tmpdir } from 'node:os';
+import { execFile as execFileCb } from 'node:child_process';
+import { promisify } from 'node:util';
+import { logger } from '../utils/logger.js';
+import { pathExists } from '../utils/fs.js';
+const execFile = promisify(execFileCb);
+/**
+ * Generate an .mcpb bundle from a built MCP server project.
+ *
+ * The bundle is a zip file containing:
+ *   manifest.json  - metadata, tool list, config schema
+ *   server/        - the Node.js server code (package.json, dist/, node_modules/)
+ */
+export async function generateMcpb(opts) {
+    const { projectDir } = opts;
+    // Validate project structure
+    const pkgPath = resolve(projectDir, 'package.json');
+    if (!(await pathExists(pkgPath))) {
+        throw new Error(`Not a valid project directory (no package.json): ${projectDir}`);
+    }
+    const distDir = resolve(projectDir, 'dist');
+    if (!(await pathExists(distDir))) {
+        throw new Error(`No dist/ directory found. Build the project first: cd ${projectDir} && npm run build`);
+    }
+    // Read project metadata
+    const pkgJson = JSON.parse(await readFile(pkgPath, 'utf-8'));
+    const projectName = pkgJson.name ?? 'mcp-server';
+    const projectVersion = pkgJson.version ?? '1.0.0';
+    const projectDescription = pkgJson.description ?? '';
+    // Extract tool list (reuse same strategies as publish.ts)
+    const tools = await extractToolList(projectDir);
+    // Extract env vars from .env.example
+    const envVars = await extractEnvVars(projectDir);
+    // Build the manifest
+    const manifest = {
+        schema_version: '1.0',
+        name: opts.manifest?.name ?? projectName,
+        version: opts.manifest?.version ?? projectVersion,
+        description: opts.manifest?.description ?? projectDescription,
+        author: opts.manifest?.author ?? '',
+        license: opts.manifest?.license ?? 'proprietary',
+        runtime: opts.manifest?.runtime ?? 'node',
+        entry_point: opts.manifest?.entry_point ?? 'server/dist/index.js',
+        tools: opts.manifest?.tools ?? tools,
+        env_vars: opts.manifest?.env_vars ?? envVars,
+    };
+    // Create temp staging directory
+    const stagingDir = await mkdtemp(join(tmpdir(), 'mcpb-'));
+    try {
+        // Create server/ subdirectory with the project contents
+        const serverDir = join(stagingDir, 'server');
+        // Copy dist/
+        await cp(resolve(projectDir, 'dist'), join(serverDir, 'dist'), { recursive: true });
+        // Copy package.json (stripped to essentials)
+        const minimalPkg = {
+            name: pkgJson.name,
+            version: pkgJson.version,
+            description: pkgJson.description,
+            type: pkgJson.type,
+            main: pkgJson.main,
+            dependencies: pkgJson.dependencies,
+        };
+        await writeFile(join(serverDir, 'package.json'), JSON.stringify(minimalPkg, null, 2), 'utf-8');
+        // Copy node_modules/ if present
+        const nodeModulesDir = resolve(projectDir, 'node_modules');
+        if (await pathExists(nodeModulesDir)) {
+            await cp(nodeModulesDir, join(serverDir, 'node_modules'), { recursive: true });
+        }
+        // Write manifest.json at root of the bundle
+        await writeFile(join(stagingDir, 'manifest.json'), JSON.stringify(manifest, null, 2), 'utf-8');
+        // Determine output path
+        const outputPath = opts.outputPath ?? resolve(projectDir, '..', `${basename(projectDir)}.mcpb`);
+        // Create the zip archive using the system zip command
+        await execFile('zip', ['-r', '-q', resolve(outputPath), '.'], {
+            cwd: stagingDir,
+        });
+        return outputPath;
+    }
+    finally {
+        // Clean up staging directory
+        await rm(stagingDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Extract tool names and descriptions from a generated project.
+ * Tries tool-catalog.json first, then scans src/tools/*.ts files.
+ */
+async function extractToolList(projectDir) {
+    // Strategy 1: tool-catalog.json (dynamic discovery projects)
+    const catalogPath = resolve(projectDir, 'src/tool-catalog.json');
+    if (await pathExists(catalogPath)) {
+        try {
+            const catalog = JSON.parse(await readFile(catalogPath, 'utf-8'));
+            if (Array.isArray(catalog)) {
+                return catalog.map((entry) => ({
+                    name: entry.name,
+                    description: entry.description ?? entry.title ?? '',
+                }));
+            }
+        }
+        catch {
+            logger.warn('Failed to parse tool-catalog.json, falling back to tool file scanning');
+        }
+    }
+    // Strategy 2: Parse individual tool handler files in src/tools/
+    const toolsDir = resolve(projectDir, 'src/tools');
+    if (!(await pathExists(toolsDir))) {
+        return [];
+    }
+    const tools = [];
+    let entries;
+    try {
+        entries = await readdir(toolsDir);
+    }
+    catch {
+        return [];
+    }
+    for (const file of entries) {
+        if (file === 'index.ts' || !file.endsWith('.ts'))
+            continue;
+        try {
+            const content = await readFile(join(toolsDir, file), 'utf-8');
+            const nameMatch = content.match(/registerTool\(\s*['"]([^'"]+)['"]/);
+            if (!nameMatch)
+                continue;
+            const descMatch = content.match(/description:\s*[`'"]([^`'"]*)[`'"]/);
+            tools.push({
+                name: nameMatch[1],
+                description: descMatch ? descMatch[1] : '',
+            });
+        }
+        catch {
+            // skip files that can't be read
+        }
+    }
+    return tools;
+}
+/**
+ * Extract environment variable definitions from .env.example.
+ * Each line is expected to be: VAR_NAME=value  # optional comment
+ */
+async function extractEnvVars(projectDir) {
+    const envPath = resolve(projectDir, '.env.example');
+    if (!(await pathExists(envPath))) {
+        return [];
+    }
+    const content = await readFile(envPath, 'utf-8');
+    const vars = [];
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIndex = trimmed.indexOf('=');
+        if (eqIndex === -1)
+            continue;
+        const name = trimmed.slice(0, eqIndex).trim();
+        if (!name)
+            continue;
+        // Extract inline comment as description
+        const valuePart = trimmed.slice(eqIndex + 1);
+        const commentIndex = valuePart.indexOf('#');
+        const description = commentIndex >= 0 ? valuePart.slice(commentIndex + 1).trim() : '';
+        vars.push({
+            name,
+            description,
+            required: true,
+        });
+    }
+    return vars;
+}
+//# sourceMappingURL=mcpb-bundler.js.map

package/dist/emitter/mcpb-bundler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpb-bundler.js","sourceRoot":"","sources":["../../src/emitter/mcpb-bundler.ts"],"names":[],"mappings":"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"}

package/dist/emitter/project-scaffolder.d.ts

@@ -0,0 +1,5 @@
+import type { ProjectManifest } from '../types/index.js';
+import type { CodeUnit } from './code-writer.js';
+export declare function scaffoldProjectFiles(manifest: ProjectManifest): CodeUnit[];
+export declare function scaffoldSharedModules(manifest: ProjectManifest): CodeUnit[];
+//# sourceMappingURL=project-scaffolder.d.ts.map

package/dist/emitter/project-scaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scaffolder.d.ts","sourceRoot":"","sources":["../../src/emitter/project-scaffolder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AASjD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,EAAE,CAgD1E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,EAAE,CAmD3E"}

package/dist/emitter/project-scaffolder.js

@@ -0,0 +1,101 @@
+import { renderTemplate } from './template-loader.js';
+/**
+ * At/above this tool count, registering every tool upfront is a real token-cost
+ * problem; the README recommends `--dynamic-discovery` (the #1 buyer concern).
+ */
+const DISCOVERY_RECOMMEND_THRESHOLD = 50;
+export function scaffoldProjectFiles(manifest) {
+    const dynamicDiscovery = manifest.dynamicDiscovery ?? false;
+    const units = [
+        {
+            filePath: 'package.json',
+            content: renderTemplate('package.json', manifest),
+        },
+        {
+            filePath: 'tsconfig.json',
+            content: renderTemplate('tsconfig.json', manifest),
+        },
+        {
+            filePath: '.env.example',
+            content: renderTemplate('env.example', {
+                ...manifest,
+                authEnvVars: manifest.envVars.filter((v) => v.name !== 'BASE_URL'),
+                // Pre-seed MCP_ENVIRONMENTS when an importer carried over named
+                // environments (e.g. Stainless `environments:`); omitted otherwise.
+                environmentsJson: manifest.environments && Object.keys(manifest.environments).length > 0
+                    ? JSON.stringify(manifest.environments)
+                    : undefined,
+            }),
+        },
+        {
+            filePath: '.gitignore',
+            content: renderTemplate('gitignore', manifest),
+        },
+        {
+            filePath: 'README.md',
+            content: renderTemplate('readme.md', {
+                ...manifest,
+                authEnvVars: manifest.envVars.filter((v) => v.name !== 'BASE_URL'),
+                dynamicDiscovery,
+                recommendDiscovery: !dynamicDiscovery && manifest.tools.length >= DISCOVERY_RECOMMEND_THRESHOLD,
+            }),
+        },
+    ];
+    if (manifest.transport === 'http') {
+        units.push({
+            filePath: 'Dockerfile',
+            content: renderTemplate('dockerfile', manifest),
+        });
+    }
+    return units;
+}
+export function scaffoldSharedModules(manifest) {
+    const hasOAuth = manifest.authSchemes.some((s) => s.type === 'oauth2');
+    const hasDynamicDiscovery = manifest.dynamicDiscovery ?? false;
+    const hasStaticTools = !hasDynamicDiscovery || (manifest.staticToolCount ?? 0) > 0;
+    const hasAsyncTools = manifest.tools.some((t) => t.isAsync);
+    const templateData = {
+        ...manifest,
+        hasResources: (manifest.resources?.length ?? 0) > 0,
+        hasPrompts: (manifest.prompts?.length ?? 0) > 0,
+        hasOAuth,
+        hasDynamicDiscovery,
+        hasStaticTools,
+        hasAsyncTools,
+    };
+    return [
+        {
+            filePath: 'src/index.ts',
+            content: renderTemplate(manifest.transport === 'http' ? 'server-main-http.ts' : 'server-main.ts', templateData),
+        },
+        {
+            filePath: 'src/config.ts',
+            content: renderTemplate('config.ts', manifest),
+        },
+        {
+            filePath: 'src/auth.ts',
+            content: renderTemplate('auth-provider.ts', templateData),
+        },
+        {
+            filePath: 'src/http.ts',
+            content: renderTemplate('http-executor.ts', manifest),
+        },
+        {
+            // Minimal dependency-free jq subset for the per-call `jq_filter` argument
+            // and any build-time x-mcp-jq-filter.
+            filePath: 'src/response-filter.ts',
+            content: renderTemplate('response-filter.ts', manifest),
+        },
+        {
+            // W3C Trace Context — the executor stamps the active traceparent onto
+            // upstream calls; the HTTP server establishes the context per request.
+            filePath: 'src/trace.ts',
+            content: renderTemplate('trace.ts', manifest),
+        },
+        {
+            filePath: 'src/types.ts',
+            content: renderTemplate('types.ts', manifest),
+        },
+    ];
+}
+//# sourceMappingURL=project-scaffolder.js.map

package/dist/emitter/project-scaffolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scaffolder.js","sourceRoot":"","sources":["../../src/emitter/project-scaffolder.ts"],"names":[],"mappings":"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"}