@nimrobo/mcporter-remote 0.1.0

package/dist/cli/ephemeral-target.js.map

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

package/dist/cli/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class CliUsageError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cli/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/cli/errors.js

@@ -0,0 +1,7 @@
+export class CliUsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CliUsageError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/cli/flag-utils.d.ts

@@ -0,0 +1,4 @@
+export type FlagMap = Partial<Record<string, string>>;
+export declare function extractFlags(args: string[], keys: readonly string[]): FlagMap;
+export declare function expectValue(flag: string, value: string | undefined): string;
+//# sourceMappingURL=flag-utils.d.ts.map

package/dist/cli/flag-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-utils.d.ts","sourceRoot":"","sources":["../../src/cli/flag-utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAGtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAiB7E;AAGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK3E"}

package/dist/cli/flag-utils.js

@@ -0,0 +1,27 @@
+// extractFlags snacks out targeted flags (and their values) from argv in place.
+export function extractFlags(args, keys) {
+    const flags = {};
+    let index = 0;
+    while (index < args.length) {
+        const token = args[index];
+        if (token === undefined || !keys.includes(token)) {
+            index += 1;
+            continue;
+        }
+        const value = args[index + 1];
+        if (value === undefined) {
+            throw new Error(`Flag '${token}' requires a value.`);
+        }
+        flags[token] = value;
+        args.splice(index, 2);
+    }
+    return flags;
+}
+// expectValue asserts that a flag is followed by a value.
+export function expectValue(flag, value) {
+    if (value === undefined) {
+        throw new Error(`Flag '${flag}' requires a value.`);
+    }
+    return value;
+}
+//# sourceMappingURL=flag-utils.js.map

package/dist/cli/flag-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-utils.js","sourceRoot":"","sources":["../../src/cli/flag-utils.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,IAAc,EAAE,IAAuB;IAClE,MAAM,KAAK,GAAY,EAAE,CAAC;IAC1B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,qBAAqB,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAyB;IACjE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,qBAAqB,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/generate/artifacts.d.ts

@@ -0,0 +1,15 @@
+export declare function bundleOutput({ sourcePath, targetPath, runtimeKind, minify, bundler, }: {
+    sourcePath: string;
+    targetPath: string;
+    runtimeKind: 'node' | 'bun';
+    minify: boolean;
+    bundler: 'rolldown' | 'bun';
+}): Promise<string>;
+export declare function compileBundleWithBun(bundlePath: string, outputPath: string): Promise<void>;
+export declare function resolveBundleTarget({ bundle, compile, outputPath, }: {
+    bundle?: boolean | string;
+    compile?: boolean | string;
+    outputPath: string;
+}): string;
+export declare function computeCompileTarget(compileOption: boolean | string | undefined, _bundlePath: string, serverName: string): string;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/cli/generate/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/cli/generate/artifacts.ts"],"names":[],"mappings":"AAkBA,wBAAsB,YAAY,CAAC,EACjC,UAAU,EACV,UAAU,EACV,WAAW,EACX,MAAM,EACN,OAAO,GACR,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,UAAU,GAAG,KAAK,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlB;AA4FD,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhG;AAED,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,OAAO,EACP,UAAU,GACX,EAAE;IACD,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAkBT;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,EAC3C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAMR"}

package/dist/cli/generate/artifacts.js

@@ -0,0 +1,247 @@
+import { execFile } from 'node:child_process';
+import fsSync from 'node:fs';
+import fs from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { markExecutable, safeCopyFile } from './fs-helpers.js';
+import { verifyBunAvailable } from './runtime.js';
+const localRequire = createRequire(import.meta.url);
+const packageRoot = fileURLToPath(new URL('../../..', import.meta.url));
+// Generated CLIs import commander/mcporter, but end-users run mcporter from directories
+// that often lack node_modules. Pre-resolve those deps to this package so bundling works
+// even in empty temp dirs (fixes #1).
+const BUNDLED_DEPENDENCIES = ['commander', '@nimrobo/mcporter-remote', 'jsonc-parser'];
+const dependencyAliasPlugin = createLocalDependencyAliasPlugin([...BUNDLED_DEPENDENCIES]);
+export async function bundleOutput({ sourcePath, targetPath, runtimeKind, minify, bundler, }) {
+    if (bundler === 'bun') {
+        return await bundleWithBun({ sourcePath, targetPath, runtimeKind, minify });
+    }
+    return await bundleWithRolldown({ sourcePath, targetPath, runtimeKind, minify });
+}
+async function bundleWithRolldown({ sourcePath, targetPath, runtimeKind, minify, }) {
+    let rolldownImpl;
+    try {
+        ({ rolldown: rolldownImpl } = await import('rolldown'));
+    }
+    catch (error) {
+        const message = 'Rolldown bundling is unavailable in this build of mcporter; rerun with --bundler bun or install mcporter via npm (Node.js) to use the Rolldown bundler.';
+        if (error instanceof Error) {
+            error.message = `${message}\n\n${error.message}`;
+            throw error;
+        }
+        throw new Error(message);
+    }
+    const absTarget = path.resolve(targetPath);
+    await fs.mkdir(path.dirname(absTarget), { recursive: true });
+    const plugins = dependencyAliasPlugin ? [dependencyAliasPlugin] : undefined;
+    const bundle = await rolldownImpl({
+        input: sourcePath,
+        treeshake: false,
+        plugins,
+        onLog(level, log, handler) {
+            if (typeof log.code === 'string' && log.code === 'EVAL') {
+                return;
+            }
+            handler(level, log);
+        },
+    });
+    await bundle.write({
+        file: absTarget,
+        format: runtimeKind === 'bun' ? 'esm' : 'cjs',
+        sourcemap: false,
+        minify,
+    });
+    await markExecutable(absTarget);
+    return absTarget;
+}
+async function bundleWithBun({ sourcePath, targetPath, runtimeKind, minify, }) {
+    const absTarget = path.resolve(targetPath);
+    await fs.mkdir(path.dirname(absTarget), { recursive: true });
+    const bunBin = await verifyBunAvailable();
+    const tmpRoot = path.join(packageRoot, 'tmp');
+    await fs.mkdir(tmpRoot, { recursive: true });
+    const stagingDir = await fs.mkdtemp(path.join(tmpRoot, 'bundle-'));
+    const stagingEntry = path.join(stagingDir, path.basename(sourcePath));
+    // Copy the template into the package tree so Bun sees our node_modules deps even when the
+    // CLI runs from an empty working directory.
+    await safeCopyFile(sourcePath, stagingEntry);
+    await ensureBundlerDeps(stagingDir);
+    try {
+        const args = ['build', stagingEntry, '--outfile', absTarget, '--target', runtimeKind === 'bun' ? 'bun' : 'node'];
+        if (minify) {
+            args.push('--minify');
+        }
+        await new Promise((resolve, reject) => {
+            execFile(bunBin, args, { cwd: packageRoot, env: process.env }, (error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+        });
+    }
+    finally {
+        await fs.rm(stagingDir, { recursive: true, force: true }).catch(() => { });
+    }
+    await markExecutable(absTarget);
+    return absTarget;
+}
+export async function compileBundleWithBun(bundlePath, outputPath) {
+    const bunBin = await verifyBunAvailable();
+    await new Promise((resolve, reject) => {
+        execFile(bunBin, ['build', bundlePath, '--compile', '--outfile', outputPath], { cwd: process.cwd(), env: process.env }, (error) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+    await markExecutable(outputPath);
+}
+export function resolveBundleTarget({ bundle, compile, outputPath, }) {
+    if (typeof bundle === 'string') {
+        return bundle;
+    }
+    if (bundle) {
+        throw new Error('--bundle requires an explicit output path when used with --compile.');
+    }
+    if (typeof compile === 'string') {
+        const ext = path.extname(compile);
+        const base = ext ? path.join(path.dirname(compile), path.basename(compile, ext)) : compile;
+        return `${base}.js`;
+    }
+    if (compile) {
+        const tmpDir = path.join(process.cwd(), 'tmp', 'mcporter-cli-bundles');
+        const baseName = path.basename(outputPath, path.extname(outputPath)) || 'bundle';
+        return path.join(tmpDir, `${baseName}-${Date.now()}.bundle.js`);
+    }
+    throw new Error('--compile requires an explicit bundle target.');
+}
+export function computeCompileTarget(compileOption, _bundlePath, serverName) {
+    if (typeof compileOption === 'string') {
+        return compileOption;
+    }
+    const baseName = sanitizeFileName(serverName) || 'mcporter-cli';
+    return resolveUniquePath(process.cwd(), baseName);
+}
+function createLocalDependencyAliasPlugin(specifiers) {
+    const resolvedEntries = specifiers
+        .map((specifier) => ({ specifier, path: resolveLocalDependency(specifier) }))
+        .filter((entry) => Boolean(entry.path));
+    if (resolvedEntries.length === 0) {
+        return undefined;
+    }
+    return {
+        name: 'mcporter-local-deps',
+        resolveId(source) {
+            const match = resolvedEntries.find((entry) => entry.specifier === source);
+            if (match) {
+                return match.path;
+            }
+            return null;
+        },
+    };
+}
+function resolveLocalDependency(specifier) {
+    try {
+        if (specifier === 'jsonc-parser') {
+            const pkgJsonPath = localRequire.resolve('jsonc-parser/package.json');
+            const pkgDir = path.dirname(pkgJsonPath);
+            try {
+                const pkg = JSON.parse(fsSync.readFileSync(pkgJsonPath, 'utf8'));
+                if (pkg.module) {
+                    const esmEntry = path.join(pkgDir, pkg.module);
+                    if (fsSync.existsSync(esmEntry)) {
+                        return esmEntry;
+                    }
+                }
+            }
+            catch {
+                // Fall back to Node's resolution below if we can't parse or locate the module entry.
+            }
+        }
+        return localRequire.resolve(specifier);
+    }
+    catch {
+        if (specifier === '@nimrobo/mcporter-remote') {
+            // During development or unpublished builds there may not be an installed entry,
+            // so fall back to the files inside the repo that represent the published surface.
+            const fallbacks = [
+                path.join(packageRoot, 'dist', 'index.js'),
+                path.join(packageRoot, 'dist', 'index.mjs'),
+                path.join(packageRoot, 'src', 'index.ts'),
+                path.join(packageRoot, 'src', 'index.js'),
+            ];
+            for (const candidate of fallbacks) {
+                if (fsSync.existsSync(candidate)) {
+                    return candidate;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+async function ensureBundlerDeps(stagingDir) {
+    const nodeModulesDir = path.join(stagingDir, 'node_modules');
+    await fs.mkdir(nodeModulesDir, { recursive: true });
+    await Promise.all(BUNDLED_DEPENDENCIES.map(async (specifier) => {
+        const sourceDir = resolveDependencyDirectory(specifier);
+        if (!sourceDir) {
+            return;
+        }
+        const target = path.join(nodeModulesDir, specifier);
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await linkOrCopyDependency(sourceDir, target);
+    }));
+}
+function resolveDependencyDirectory(specifier) {
+    try {
+        if (specifier === '@nimrobo/mcporter-remote') {
+            return packageRoot;
+        }
+        const pkgPath = localRequire.resolve(path.join(specifier, 'package.json'));
+        return path.dirname(pkgPath);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function linkOrCopyDependency(sourceDir, targetDir) {
+    try {
+        await fs.symlink(sourceDir, targetDir, 'dir');
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'EEXIST') {
+            return;
+        }
+        if (code === 'ENOENT') {
+            return;
+        }
+        if (code === 'EPERM' || code === 'EACCES') {
+            await fs.cp(sourceDir, targetDir, { recursive: true });
+            return;
+        }
+        throw error;
+    }
+}
+function sanitizeFileName(input) {
+    const slug = input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-');
+    return slug.replace(/^-+|-+$/g, '');
+}
+function resolveUniquePath(directory, baseName) {
+    let attempt = path.join(directory, baseName);
+    let suffix = 1;
+    while (fsSync.existsSync(attempt)) {
+        attempt = path.join(directory, `${baseName}-${suffix}`);
+        suffix += 1;
+    }
+    return attempt;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/cli/generate/artifacts.js.map

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

package/dist/cli/generate/definition.d.ts

@@ -0,0 +1,22 @@
+import type { CliArtifactMetadata } from '../../cli-metadata.js';
+import { type ServerDefinition } from '../../config.js';
+import type { ServerToolInfo } from '../../runtime.js';
+export interface ResolvedServer {
+    definition: ServerDefinition;
+    name: string;
+}
+type DefinitionInput = ServerDefinition | (Record<string, unknown> & {
+    name: string;
+    command?: unknown;
+    args?: unknown;
+});
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function ensureInvocationDefaults(invocation: CliArtifactMetadata['invocation'], definition: ServerDefinition): CliArtifactMetadata['invocation'];
+export declare function resolveServerDefinition(serverRef: string, configPath?: string, rootDir?: string): Promise<ResolvedServer>;
+export declare function fetchTools(definition: ServerDefinition, serverName: string, configPath?: string, rootDir?: string): Promise<{
+    tools: ServerToolInfo[];
+    derivedDescription?: string;
+}>;
+export declare function normalizeDefinition(def: DefinitionInput): ServerDefinition;
+export {};
+//# sourceMappingURL=definition.d.ts.map

package/dist/cli/generate/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/cli/generate/definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAA2C,KAAK,gBAAgB,EAAqB,MAAM,iBAAiB,CAAC;AACpH,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIhE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,KAAK,eAAe,GAChB,gBAAgB,GAChB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AAEP,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAC7C,UAAU,EAAE,gBAAgB,GAC3B,mBAAmB,CAAC,YAAY,CAAC,CAUnC;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAwEzB;AAED,wBAAsB,UAAU,CAC9B,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBnE;AAiCD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,gBAAgB,CAwD1E"}

package/dist/cli/generate/definition.js

@@ -0,0 +1,265 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { loadServerDefinitions } from '../../config.js';
+import { createRuntime } from '../../runtime.js';
+import { extractHttpServerTarget, normalizeHttpUrl } from '../http-utils.js';
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function ensureInvocationDefaults(invocation, definition) {
+    const serverRef = invocation.serverRef ?? definition.name;
+    const configPath = invocation.configPath ??
+        (definition.source && definition.source.kind === 'local' ? definition.source.path : undefined);
+    return {
+        ...invocation,
+        serverRef,
+        configPath,
+    };
+}
+export async function resolveServerDefinition(serverRef, configPath, rootDir) {
+    const trimmed = serverRef.trim();
+    if (trimmed.startsWith('{') && trimmed.endsWith('}')) {
+        // Allow callers to inline a JSON server definition (used by tests + CLI).
+        const parsed = JSON.parse(trimmed);
+        if (!parsed.name) {
+            throw new Error("Inline server definition must include a 'name' field.");
+        }
+        return { definition: normalizeDefinition(parsed), name: parsed.name };
+    }
+    const possiblePath = path.resolve(trimmed);
+    try {
+        const buffer = await fs.readFile(possiblePath, 'utf8');
+        const parsed = JSON.parse(buffer);
+        if (!parsed.mcpServers || typeof parsed.mcpServers !== 'object') {
+            throw new Error(`Config file ${possiblePath} does not contain mcpServers.`);
+        }
+        const entries = Object.entries(parsed.mcpServers);
+        if (entries.length === 0) {
+            throw new Error(`Config file ${possiblePath} does not define any servers.`);
+        }
+        const first = entries[0];
+        if (!first) {
+            throw new Error(`Config file ${possiblePath} does not define any servers.`);
+        }
+        const [name, value] = first;
+        return {
+            definition: normalizeDefinition({
+                name,
+                ...value,
+            }),
+            name,
+        };
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    const definitions = await loadServerDefinitions({
+        configPath,
+        rootDir,
+    });
+    const matchByName = definitions.find((def) => def.name === trimmed);
+    if (matchByName) {
+        return { definition: matchByName, name: matchByName.name };
+    }
+    const httpTarget = extractHttpServerTarget(trimmed);
+    if (httpTarget) {
+        const normalizedTarget = normalizeHttpUrl(httpTarget);
+        if (normalizedTarget) {
+            const matchByUrl = definitions.find((def) => {
+                if (def.command.kind !== 'http') {
+                    return false;
+                }
+                const normalizedDefinitionUrl = normalizeHttpUrl(def.command.url);
+                return normalizedDefinitionUrl === normalizedTarget;
+            });
+            if (matchByUrl) {
+                return { definition: matchByUrl, name: matchByUrl.name };
+            }
+        }
+    }
+    throw new Error(`Unknown MCP server '${trimmed}'. Provide a name from config, a JSON file, inline JSON, or an HTTP URL that matches a configured server.`);
+}
+export async function fetchTools(definition, serverName, configPath, rootDir) {
+    // Reuse the runtime helper so bundle builds and CLI generation share the same discovery path.
+    const runtime = await createRuntime({
+        configPath,
+        rootDir,
+        servers: configPath ? undefined : [definition],
+    });
+    try {
+        const tools = await runtime.listTools(serverName, { includeSchema: true });
+        const derivedDescription = definition.description
+            ? undefined
+            : await deriveDefinitionDescription(runtime, serverName);
+        return { tools, derivedDescription };
+    }
+    finally {
+        await runtime.close(serverName).catch(() => { });
+    }
+}
+async function deriveDefinitionDescription(runtime, serverName) {
+    try {
+        const context = await runtime.connect(serverName);
+        const instructions = typeof context.client.getInstructions === 'function' ? context.client.getInstructions() : undefined;
+        const serverInfo = typeof context.client.getServerVersion === 'function' ? context.client.getServerVersion() : undefined;
+        const derived = pickDescription(instructions, serverInfo);
+        return derived;
+    }
+    catch {
+        // Ignore metadata lookup failures; fallback description will be used instead.
+        return undefined;
+    }
+}
+function pickDescription(instructions, serverInfo) {
+    const ordered = [instructions, serverInfo?.title, serverInfo?.name];
+    for (const candidate of ordered) {
+        if (typeof candidate === 'string') {
+            const trimmed = candidate.trim();
+            if (trimmed.length > 0) {
+                return trimmed;
+            }
+        }
+    }
+    return undefined;
+}
+export function normalizeDefinition(def) {
+    if (isServerDefinition(def)) {
+        return def;
+    }
+    const name = def.name;
+    if (typeof name !== 'string' || name.trim().length === 0) {
+        throw new Error('Server definition must include a name.');
+    }
+    const description = typeof def.description === 'string' ? def.description : undefined;
+    const env = toStringRecord(def.env);
+    const auth = typeof def.auth === 'string' ? def.auth : undefined;
+    const tokenCacheDir = typeof def.tokenCacheDir === 'string' ? def.tokenCacheDir : undefined;
+    const clientName = typeof def.clientName === 'string' ? def.clientName : undefined;
+    const headers = toStringRecord(def.headers);
+    const commandValue = def.command;
+    if (isCommandSpec(commandValue)) {
+        return {
+            name,
+            description,
+            command: normalizeCommand(commandValue, headers),
+            env,
+            auth,
+            tokenCacheDir,
+            clientName,
+        };
+    }
+    if (typeof commandValue === 'string' && commandValue.trim().length > 0) {
+        return {
+            name,
+            description,
+            command: toCommandSpec(commandValue, getStringArray(def.args), headers ? { headers } : undefined),
+            env,
+            auth,
+            tokenCacheDir,
+            clientName,
+        };
+    }
+    if (Array.isArray(commandValue) && commandValue.length > 0) {
+        const [first, ...rest] = commandValue;
+        if (typeof first !== 'string' || !rest.every((entry) => typeof entry === 'string')) {
+            throw new Error('Command array must contain only strings.');
+        }
+        return {
+            name,
+            description,
+            command: toCommandSpec(first, rest, headers ? { headers } : undefined),
+            env,
+            auth,
+            tokenCacheDir,
+            clientName,
+        };
+    }
+    throw new Error('Server definition must include command information.');
+}
+function isServerDefinition(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const record = value;
+    if (typeof record.name !== 'string') {
+        return false;
+    }
+    return isCommandSpec(record.command);
+}
+function isCommandSpec(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    if (candidate.kind === 'http') {
+        return 'url' in candidate;
+    }
+    if (candidate.kind === 'stdio') {
+        return 'command' in candidate;
+    }
+    return false;
+}
+function normalizeCommand(command, headers) {
+    if (command.kind === 'http') {
+        const urlValue = command.url;
+        const url = urlValue instanceof URL ? urlValue : new URL(String(urlValue));
+        const mergedHeaders = command.headers ? (headers ? { ...command.headers, ...headers } : command.headers) : headers;
+        const normalized = {
+            kind: 'http',
+            url,
+            ...(mergedHeaders ? { headers: mergedHeaders } : {}),
+        };
+        return normalized;
+    }
+    return {
+        kind: 'stdio',
+        command: command.command,
+        args: [...command.args],
+        cwd: command.cwd ?? process.cwd(),
+    };
+}
+function toCommandSpec(command, args, extra) {
+    if (command.startsWith('http://') || command.startsWith('https://')) {
+        const httpCommand = {
+            kind: 'http',
+            url: new URL(command),
+            ...(extra?.headers ? { headers: extra.headers } : {}),
+        };
+        return httpCommand;
+    }
+    const stdio = {
+        kind: 'stdio',
+        command,
+        args: args ?? [],
+        cwd: process.cwd(),
+    };
+    return stdio;
+}
+function getStringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const entries = value.filter((item) => typeof item === 'string');
+    return entries.length > 0 ? entries : undefined;
+}
+function toStringRecord(value) {
+    if (typeof value !== 'object' || value === null) {
+        return undefined;
+    }
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry === 'string') {
+            result[key] = entry;
+        }
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+//# sourceMappingURL=definition.js.map