@nimrobo/mcporter-remote 0.1.0

package/dist/cli/emit-ts-command.js

@@ -0,0 +1,217 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { renderClientModule, renderTypesModule } from './emit-ts-templates.js';
+import { extractGeneratorFlags } from './generate/flag-parser.js';
+import { readPackageMetadata } from './generate/template.js';
+import { extractHttpServerTarget } from './http-utils.js';
+import { buildToolDoc } from './list-detail-helpers.js';
+import { consumeOutputFormat } from './output-format.js';
+import { findServerByHttpUrl } from './server-lookup.js';
+import { loadToolMetadata } from './tool-cache.js';
+export async function handleEmitTs(runtime, args) {
+    const options = parseEmitTsArgs(args);
+    const definition = getServerDefinition(runtime, options.server);
+    const metadataEntries = await loadToolMetadata(runtime, options.server, {
+        includeSchema: true,
+        autoAuthorize: false,
+    });
+    const generator = await readPackageMetadata();
+    const metadata = {
+        server: definition,
+        generatorLabel: `${generator.name}@${generator.version}`,
+        generatedAt: new Date(),
+    };
+    const docEntries = buildDocEntries(options.server, metadataEntries, options.includeOptional);
+    const interfaceName = buildInterfaceName(options.server);
+    if (options.mode === 'types') {
+        const source = renderTypesModule({ interfaceName, docs: docEntries, metadata });
+        await writeFile(options.outPath, source);
+        if (options.format === 'json') {
+            console.log(JSON.stringify({
+                mode: 'types',
+                server: options.server,
+                outPath: options.outPath,
+            }, null, 2));
+        }
+        else {
+            console.log(`Emitted TypeScript definitions for ${options.server} → ${options.outPath}`);
+        }
+        return;
+    }
+    const typesOutPath = options.typesOutPath ?? deriveTypesOutPath(options.outPath);
+    const relativeImportPath = computeImportPath(options.outPath, typesOutPath);
+    const typesSource = renderTypesModule({ interfaceName, docs: docEntries, metadata });
+    const clientSource = renderClientModule({
+        interfaceName,
+        docs: docEntries,
+        metadata,
+        typesImportPath: relativeImportPath,
+    });
+    await writeFile(typesOutPath, typesSource);
+    await writeFile(options.outPath, clientSource);
+    if (options.format === 'json') {
+        console.log(JSON.stringify({
+            mode: 'client',
+            server: options.server,
+            clientOutPath: options.outPath,
+            typesOutPath,
+        }, null, 2));
+    }
+    else {
+        console.log(`Emitted client + types for ${options.server} → ${options.outPath} / ${typesOutPath}`);
+    }
+}
+function parseEmitTsArgs(args) {
+    const flags = {
+        mode: 'types',
+        includeOptional: false,
+        format: 'text',
+    };
+    const common = extractGeneratorFlags(args, { allowIncludeOptional: true });
+    if (common.includeOptional) {
+        flags.includeOptional = true;
+    }
+    flags.format = consumeOutputFormat(args, {
+        defaultFormat: 'text',
+        allowed: ['text', 'json'],
+        enableRawShortcut: false,
+        jsonShortcutFlag: '--json',
+    });
+    let index = 0;
+    while (index < args.length) {
+        const token = args[index];
+        if (!token) {
+            index += 1;
+            continue;
+        }
+        if (token === '--out') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--out' requires a path.");
+            }
+            flags.outPath = value;
+            args.splice(index, 2);
+            continue;
+        }
+        if (token === '--types-out') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--types-out' requires a path.");
+            }
+            flags.typesOutPath = value;
+            args.splice(index, 2);
+            continue;
+        }
+        if (token === '--mode') {
+            const value = args[index + 1];
+            if (value !== 'types' && value !== 'client') {
+                throw new Error("--mode must be 'types' or 'client'.");
+            }
+            flags.mode = value;
+            args.splice(index, 2);
+            continue;
+        }
+        if (token.startsWith('--')) {
+            throw new Error(`Unknown flag '${token}' for emit-ts.`);
+        }
+        index += 1;
+    }
+    const server = args.shift();
+    if (!server) {
+        throw new Error('Usage: mcporter emit-ts <server> --out <file> [--mode types|client]');
+    }
+    const outPath = flags.outPath;
+    if (!outPath) {
+        throw new Error("Flag '--out' is required for emit-ts.");
+    }
+    if (flags.mode === 'client' && !outPath.endsWith('.ts')) {
+        throw new Error('--out should point to a .ts file when --mode client is used.');
+    }
+    if (flags.mode === 'types' && !outPath.endsWith('.ts') && !outPath.endsWith('.d.ts')) {
+        throw new Error('--out should be a .ts or .d.ts file for --mode types.');
+    }
+    return {
+        server,
+        outPath: path.resolve(outPath),
+        mode: flags.mode,
+        includeOptional: flags.includeOptional,
+        typesOutPath: flags.typesOutPath ? path.resolve(flags.typesOutPath) : undefined,
+        format: flags.format,
+    };
+}
+function getServerDefinition(runtime, selector) {
+    try {
+        return runtime.getDefinition(selector);
+    }
+    catch (error) {
+        const resolved = resolveHttpServerName(runtime, selector);
+        if (resolved) {
+            return runtime.getDefinition(resolved);
+        }
+        if (error instanceof Error) {
+            throw new Error(error.message);
+        }
+        throw error;
+    }
+}
+function resolveHttpServerName(runtime, selector) {
+    const target = extractHttpServerTarget(selector);
+    if (!target) {
+        return undefined;
+    }
+    return findServerByHttpUrl(runtime.getDefinitions(), target);
+}
+function buildDocEntries(serverName, metadataEntries, includeOptional) {
+    return metadataEntries.map((entry) => {
+        const doc = buildToolDoc({
+            serverName,
+            toolName: entry.tool.name,
+            description: entry.tool.description,
+            outputSchema: entry.tool.outputSchema,
+            options: entry.options,
+            requiredOnly: !includeOptional,
+            colorize: false,
+            defaultReturnType: 'CallResult',
+        });
+        return {
+            toolName: entry.tool.name,
+            methodName: entry.methodName,
+            doc,
+        };
+    });
+}
+function buildInterfaceName(serverName) {
+    const cleaned = serverName
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join('');
+    const base = cleaned.length > 0 ? cleaned : 'Server';
+    return `${base}Tools`;
+}
+function deriveTypesOutPath(tsPath) {
+    const dir = path.dirname(tsPath);
+    const base = path.basename(tsPath, path.extname(tsPath));
+    return path.join(dir, `${base}.d.ts`);
+}
+async function writeFile(targetPath, contents) {
+    await fs.mkdir(path.dirname(targetPath), { recursive: true });
+    await fs.writeFile(targetPath, `${contents}\n`, 'utf8');
+}
+function computeImportPath(fromPath, typesPath) {
+    const fromDir = path.dirname(fromPath);
+    const relative = path.relative(fromDir, typesPath).replace(/\\/g, '/');
+    const withoutExt = relative.replace(/\.[^.]+$/, '');
+    if (withoutExt.startsWith('.')) {
+        return withoutExt;
+    }
+    return `./${withoutExt}`;
+}
+export const __test = {
+    parseEmitTsArgs,
+    buildInterfaceName,
+    deriveTypesOutPath,
+    computeImportPath,
+    buildDocEntries,
+};
+//# sourceMappingURL=emit-ts-command.js.map

package/dist/cli/emit-ts-command.js.map

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

package/dist/cli/emit-ts-templates.d.ts

@@ -0,0 +1,23 @@
+import type { ServerDefinition } from '../config.js';
+import type { ToolDocModel } from './list-detail-helpers.js';
+export interface ToolDocEntry {
+    toolName: string;
+    methodName: string;
+    doc: ToolDocModel;
+}
+export interface EmitMetadata {
+    server: ServerDefinition;
+    generatorLabel: string;
+    generatedAt: Date;
+}
+export interface EmitTypesTemplateInput {
+    interfaceName: string;
+    docs: ToolDocEntry[];
+    metadata: EmitMetadata;
+}
+export interface EmitClientTemplateInput extends EmitTypesTemplateInput {
+    typesImportPath: string;
+}
+export declare function renderTypesModule(input: EmitTypesTemplateInput): string;
+export declare function renderClientModule(input: EmitClientTemplateInput): string;
+//# sourceMappingURL=emit-ts-templates.d.ts.map

package/dist/cli/emit-ts-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-ts-templates.d.ts","sourceRoot":"","sources":["../../src/cli/emit-ts-templates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,YAAY,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAuBvE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CA+CzE"}

package/dist/cli/emit-ts-templates.js

@@ -0,0 +1,130 @@
+import path from 'node:path';
+export function renderTypesModule(input) {
+    const lines = [];
+    lines.push(...renderHeader(input.metadata));
+    lines.push("import type { CallResult } from '@nimrobo/mcporter-remote';");
+    lines.push('');
+    lines.push(`export interface ${input.interfaceName} {`);
+    input.docs.forEach((entry, index) => {
+        lines.push(...renderDocComment(entry.doc.docLines, '  '));
+        const methodSignature = toInterfaceSignature(entry.doc.tsSignature, { wrapInPromise: true });
+        lines.push(`  ${methodSignature}`);
+        if (entry.doc.optionalSummary) {
+            lines.push(`  // ${entry.doc.optionalSummary.replace(/^\/\//, '').trim()}`);
+        }
+        if (index !== input.docs.length - 1) {
+            lines.push('');
+        }
+    });
+    if (input.docs.length === 0) {
+        lines.push('  // No tools reported for this server.');
+    }
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+export function renderClientModule(input) {
+    const lines = [];
+    lines.push(...renderHeader(input.metadata));
+    lines.push("import { createRuntime, createServerProxy, wrapCallResult } from '@nimrobo/mcporter-remote';");
+    lines.push(`import type { ${input.interfaceName} } from '${input.typesImportPath}';`);
+    lines.push('');
+    lines.push('type RuntimeInstance = Awaited<ReturnType<typeof createRuntime>>;');
+    const clientType = `${input.interfaceName.replace(/Tools$/, 'Client')}`;
+    const factoryName = `create${input.interfaceName.replace(/Tools$/, '')}Client`;
+    const serverName = input.metadata.server.name;
+    lines.push(`export type ${clientType} = ${input.interfaceName} & { close(): Promise<void> };`);
+    lines.push('');
+    lines.push('export interface CreateClientOptions {');
+    lines.push('  runtime?: RuntimeInstance;');
+    lines.push('  configPath?: string;');
+    lines.push('  rootDir?: string;');
+    lines.push('}');
+    lines.push('');
+    lines.push(`export async function ${factoryName}(options: CreateClientOptions = {}): Promise<${clientType}> {`);
+    lines.push('  const runtime = options.runtime ?? (await createRuntime({');
+    lines.push('    configPath: options.configPath,');
+    lines.push('    rootDir: options.rootDir,');
+    lines.push('  }));');
+    lines.push('  const ownsRuntime = !options.runtime;');
+    lines.push(`  const proxy = createServerProxy(runtime, ${JSON.stringify(serverName)});`);
+    lines.push(`  const client: ${clientType} = {`);
+    input.docs.forEach((entry, _index) => {
+        const methodName = entry.doc.tsSignature.match(/^function\s+([^()]+)/)?.[1] ?? entry.toolName;
+        lines.push(`    async ${methodName}(params: Parameters<${input.interfaceName}['${methodName}']>[0]) {`);
+        lines.push(`      const tool = proxy.${entry.methodName} as (args: Parameters<${input.interfaceName}['${methodName}']>[0]) => Promise<unknown>;`);
+        lines.push('      const raw = await tool(params);');
+        lines.push('      return wrapCallResult(raw).callResult;');
+        lines.push('    },');
+        lines.push('');
+    });
+    lines.push('    async close() {');
+    lines.push('      if (ownsRuntime) {');
+    lines.push(`        await runtime.close(${JSON.stringify(serverName)}).catch(() => {});`);
+    lines.push('      }');
+    lines.push('    },');
+    lines.push('  };');
+    lines.push('  return client;');
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+function renderHeader(metadata) {
+    const lines = [];
+    const timestamp = metadata.generatedAt.toISOString();
+    lines.push(`// Generated on ${timestamp} by ${metadata.generatorLabel}`);
+    if (metadata.server.description) {
+        lines.push(`// Server: ${metadata.server.name} — ${metadata.server.description}`);
+    }
+    else {
+        lines.push(`// Server: ${metadata.server.name}`);
+    }
+    const source = describeSource(metadata.server);
+    if (source) {
+        lines.push(`// Source: ${source}`);
+    }
+    const transport = describeTransport(metadata.server);
+    if (transport) {
+        lines.push(`// Transport: ${transport}`);
+    }
+    lines.push('');
+    return lines;
+}
+function renderDocComment(docLines, indent) {
+    if (!docLines || docLines.length === 0) {
+        return [];
+    }
+    return docLines.map((line) => `${indent}${line}`);
+}
+function toInterfaceSignature(signature, options) {
+    const trimmed = signature.trim();
+    const match = trimmed.match(/^function\s+([^(]+)\((.*)\)\s*(?::\s*([^;]+))?;?$/);
+    if (!match) {
+        return trimmed.replace(/^function\s+/, '');
+    }
+    const [, name, params, returnTypeRaw] = match;
+    const returnType = (returnTypeRaw ?? 'void').trim();
+    const finalReturn = options?.wrapInPromise ? `Promise<${returnType}>` : returnType;
+    return `${name}(${params}): ${finalReturn};`;
+}
+function describeTransport(definition) {
+    if (definition.command.kind === 'http') {
+        const url = definition.command.url instanceof URL ? definition.command.url.href : String(definition.command.url);
+        return `HTTP ${url}`;
+    }
+    if (definition.command.kind === 'stdio') {
+        const cmd = [definition.command.command, ...(definition.command.args ?? [])].join(' ').trim();
+        return cmd.length > 0 ? `STDIO ${cmd}` : 'STDIO';
+    }
+    return undefined;
+}
+function describeSource(definition) {
+    if (definition.source?.kind === 'import') {
+        return path.normalize(definition.source.path);
+    }
+    if (definition.source?.kind === 'local') {
+        return definition.source.path;
+    }
+    return undefined;
+}
+//# sourceMappingURL=emit-ts-templates.js.map

package/dist/cli/emit-ts-templates.js.map

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

package/dist/cli/ephemeral-flags.d.ts

@@ -0,0 +1,7 @@
+import type { EphemeralServerSpec } from './adhoc-server.js';
+interface ExtractOptions {
+    allowPersist?: boolean;
+}
+export declare function extractEphemeralServerFlags(args: string[], options?: ExtractOptions): EphemeralServerSpec | undefined;
+export {};
+//# sourceMappingURL=ephemeral-flags.d.ts.map

package/dist/cli/ephemeral-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-flags.d.ts","sourceRoot":"","sources":["../../src/cli/ephemeral-flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,UAAU,cAAc;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAID,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,cAAmB,GAC3B,mBAAmB,GAAG,SAAS,CAoHjC"}

package/dist/cli/ephemeral-flags.js

@@ -0,0 +1,108 @@
+// extractEphemeralServerFlags scans argv for ad-hoc server descriptors (HTTP/STDIO/env/etc.)
+// and removes them so higher-level parsers can focus on command-specific flags.
+export function extractEphemeralServerFlags(args, options = {}) {
+    let spec;
+    const ensureSpec = () => {
+        if (!spec) {
+            spec = {};
+        }
+        return spec;
+    };
+    const allowPersist = options.allowPersist ?? true;
+    let index = 0;
+    while (index < args.length) {
+        const token = args[index];
+        if (!token) {
+            index += 1;
+            continue;
+        }
+        if (token === '--http-url' || token === '--sse') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--http-url' requires a value.");
+            }
+            ensureSpec().httpUrl = value;
+            args.splice(index, 2);
+            continue;
+        }
+        if (token === '--allow-http' || token === '--insecure') {
+            ensureSpec().allowInsecureHttp = true;
+            args.splice(index, 1);
+            continue;
+        }
+        if (token === '--stdio') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--stdio' requires a value.");
+            }
+            ensureSpec().stdioCommand = value;
+            args.splice(index, 2);
+            continue;
+        }
+        if (token === '--stdio-arg') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--stdio-arg' requires a value.");
+            }
+            const current = ensureSpec();
+            current.stdioArgs = [...(current.stdioArgs ?? []), value];
+            args.splice(index, 2);
+            continue;
+        }
+        if (token === '--env') {
+            const value = args[index + 1];
+            if (!value || !value.includes('=')) {
+                throw new Error("Flag '--env' requires KEY=value.");
+            }
+            const [key, ...rest] = value.split('=');
+            if (!key) {
+                throw new Error("Flag '--env' requires KEY=value.");
+            }
+            const current = ensureSpec();
+            const envMap = current.env ? { ...current.env } : {};
+            envMap[key] = rest.join('=');
+            current.env = envMap;
+            args.splice(index, 2);
+            continue;
+        }
+        if (token === '--cwd') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--cwd' requires a value.");
+            }
+            ensureSpec().cwd = value;
+            args.splice(index, 2);
+            continue;
+        }
+        if (token === '--name') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--name' requires a value.");
+            }
+            ensureSpec().name = value;
+            args.splice(index, 2);
+            continue;
+        }
+        if (token === '--description') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--description' requires a value.");
+            }
+            ensureSpec().description = value;
+            args.splice(index, 2);
+            continue;
+        }
+        if (allowPersist && token === '--persist') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--persist' requires a value.");
+            }
+            ensureSpec().persistPath = value;
+            args.splice(index, 2);
+            continue;
+        }
+        index += 1;
+    }
+    return spec;
+}
+//# sourceMappingURL=ephemeral-flags.js.map

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

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

package/dist/cli/ephemeral-target.d.ts

@@ -0,0 +1,16 @@
+import type { Runtime } from '../runtime.js';
+import { type EphemeralServerResolution, type EphemeralServerSpec } from './adhoc-server.js';
+interface PrepareEphemeralServerTargetOptions {
+    runtime: Runtime;
+    target?: string;
+    ephemeral?: EphemeralServerSpec;
+    nameHints?: string[];
+    reuseFromSpec?: boolean;
+}
+interface PrepareEphemeralServerTargetResult {
+    target?: string;
+    resolution?: EphemeralServerResolution;
+}
+export declare function prepareEphemeralServerTarget(options: PrepareEphemeralServerTargetOptions): Promise<PrepareEphemeralServerTargetResult>;
+export {};
+//# sourceMappingURL=ephemeral-target.d.ts.map

package/dist/cli/ephemeral-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral-target.d.ts","sourceRoot":"","sources":["../../src/cli/ephemeral-target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EAIzB,MAAM,mBAAmB,CAAC;AAI3B,UAAU,mCAAmC;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,kCAAkC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC;AAED,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,kCAAkC,CAAC,CA8D7C"}

package/dist/cli/ephemeral-target.js

@@ -0,0 +1,105 @@
+import { persistEphemeralServer, resolveEphemeralServer, splitCommandLine, } from './adhoc-server.js';
+import { looksLikeHttpUrl, normalizeHttpUrlCandidate } from './http-utils.js';
+import { findServerByHttpUrl } from './server-lookup.js';
+export async function prepareEphemeralServerTarget(options) {
+    let target = options.target;
+    let spec = options.ephemeral ? { ...options.ephemeral } : undefined;
+    const promoteUrlCandidate = (value) => {
+        if (!value) {
+            return value;
+        }
+        const normalized = normalizeHttpUrlCandidate(value);
+        if (!normalized) {
+            return value;
+        }
+        const reused = findServerByHttpUrl(options.runtime.getDefinitions(), normalized);
+        if (reused) {
+            return reused;
+        }
+        if (!spec) {
+            spec = { httpUrl: normalized };
+        }
+        else if (!spec.httpUrl) {
+            spec = { ...spec, httpUrl: normalized };
+        }
+        return undefined;
+    };
+    target = promoteUrlCandidate(target);
+    if (!spec) {
+        const inferredInline = inferInlineStdioSpec(target);
+        if (inferredInline) {
+            spec = inferredInline;
+            target = undefined;
+        }
+    }
+    if (spec) {
+        applyNameHints(spec, options.nameHints);
+    }
+    if (!spec) {
+        return { target };
+    }
+    if (spec.httpUrl) {
+        const normalized = normalizeHttpUrlCandidate(spec.httpUrl);
+        if (normalized) {
+            spec = { ...spec, httpUrl: normalized };
+            if (options.reuseFromSpec) {
+                const reused = findServerByHttpUrl(options.runtime.getDefinitions(), normalized);
+                if (reused) {
+                    return { target: reused };
+                }
+            }
+        }
+    }
+    const resolution = resolveEphemeralServer(spec);
+    options.runtime.registerDefinition(resolution.definition, { overwrite: true });
+    if (spec.persistPath) {
+        await persistEphemeralServer(resolution, spec.persistPath);
+    }
+    const resolvedTarget = target ?? resolution.name;
+    return { target: resolvedTarget, resolution };
+}
+function applyNameHints(spec, hints) {
+    if (!spec || spec.name || !hints) {
+        return;
+    }
+    for (const hint of hints) {
+        if (!hint) {
+            continue;
+        }
+        if (looksLikeHttpUrl(hint)) {
+            continue;
+        }
+        spec.name = hint;
+        break;
+    }
+}
+function inferInlineStdioSpec(target) {
+    if (!target) {
+        return undefined;
+    }
+    const trimmed = target.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    if (looksLikeHttpUrl(trimmed)) {
+        return undefined;
+    }
+    if (!trimmed.includes(' ')) {
+        return undefined;
+    }
+    try {
+        const parts = splitCommandLine(trimmed);
+        if (parts.length < 2) {
+            return undefined;
+        }
+        const executable = parts[0]?.split(/[\\/]/).pop();
+        if (executable !== 'npx') {
+            return undefined;
+        }
+        return { stdioCommand: trimmed };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=ephemeral-target.js.map