@agimon-ai/mcp-proxy 0.4.4 → 0.4.6

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_src = require('./src-G1hs2GLZ.cjs');
+const require_src = require('./src-B2m53VQ1.cjs');
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
@@ -8,8 +8,8 @@ let node_fs = require("node:fs");
 let liquidjs = require("liquidjs");
 let node_child_process = require("node:child_process");
 let commander = require("commander");
-let __agimon_ai_foundation_process_registry = require("@agimon-ai/foundation-process-registry");
 let __agimon_ai_foundation_port_registry = require("@agimon-ai/foundation-port-registry");
+let __agimon_ai_foundation_process_registry = require("@agimon-ai/foundation-process-registry");
 let node_url = require("node:url");
 
 //#region src/utils/output.ts
@@ -113,6 +113,169 @@ const initCommand = new commander.Command("init").description("Initialize MCP co
 	}
 });
 
+//#endregion
+//#region src/commands/prestart-http.ts
+/**
+* Prestart HTTP Command
+*
+* Starts an mcp-proxy HTTP runtime in the background, waits until it is healthy,
+* and then exits so the runtime can be reused by other commands.
+*/
+const WORKSPACE_MARKERS = [
+	"pnpm-workspace.yaml",
+	"nx.json",
+	".git"
+];
+const DEFAULT_HOST$1 = "localhost";
+const DEFAULT_TIMEOUT_MS = 12e4;
+const POLL_INTERVAL_MS = 250;
+function resolveWorkspaceRoot(startPath = process.env.PROJECT_PATH || process.cwd()) {
+	let current = node_path.default.resolve(startPath);
+	while (true) {
+		for (const marker of WORKSPACE_MARKERS) if ((0, node_fs.existsSync)(node_path.default.join(current, marker))) return current;
+		const parent = node_path.default.dirname(current);
+		if (parent === current) return process.cwd();
+		current = parent;
+	}
+}
+function resolveSiblingRegistryPath(registryPath, fileName) {
+	if (!registryPath) return;
+	const resolved = node_path.default.resolve(registryPath);
+	if (node_path.default.extname(resolved) === ".json") return node_path.default.join(node_path.default.dirname(resolved), fileName);
+	return node_path.default.join(resolved, fileName);
+}
+function buildCliCandidates() {
+	const __filename$1 = (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
+	const __dirname$1 = node_path.default.dirname(__filename$1);
+	const distCandidates = [
+		node_path.default.resolve(__dirname$1, "cli.mjs"),
+		node_path.default.resolve(__dirname$1, "..", "dist", "cli.mjs"),
+		node_path.default.resolve(__dirname$1, "..", "..", "dist", "cli.mjs")
+	];
+	const srcCandidates = [node_path.default.resolve(__dirname$1, "..", "cli.ts"), node_path.default.resolve(__dirname$1, "..", "..", "src", "cli.ts")];
+	for (const candidate of distCandidates) if ((0, node_fs.existsSync)(candidate)) return {
+		command: process.execPath,
+		args: [candidate]
+	};
+	for (const candidate of srcCandidates) if ((0, node_fs.existsSync)(candidate)) return {
+		command: process.execPath,
+		args: [
+			"--import",
+			"tsx",
+			candidate
+		]
+	};
+	throw new Error("Unable to locate mcp-proxy CLI entrypoint");
+}
+function parseTimeoutMs(value) {
+	if (!value) return DEFAULT_TIMEOUT_MS;
+	const parsed = Number.parseInt(value, 10);
+	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`Invalid timeout value: ${value}`);
+	return parsed;
+}
+async function waitForFile(filePath, timeoutMs) {
+	const deadline = Date.now() + timeoutMs;
+	while (Date.now() < deadline) {
+		try {
+			await (0, node_fs_promises.access)(filePath);
+			return;
+		} catch {}
+		await new Promise((resolve$2) => setTimeout(resolve$2, POLL_INTERVAL_MS));
+	}
+	throw new Error(`Timed out waiting for runtime state file: ${filePath}`);
+}
+async function waitForHealthyRuntime(serverId, timeoutMs) {
+	const runtimeStateService = new require_src.RuntimeStateService();
+	const deadline = Date.now() + timeoutMs;
+	while (Date.now() < deadline) {
+		const record = await runtimeStateService.read(serverId);
+		if (record) {
+			const healthUrl = `http://${record.host}:${record.port}/health`;
+			try {
+				const response = await fetch(healthUrl);
+				if (response.ok) {
+					const payload = await response.json().catch(() => null);
+					if (!payload || payload.transport === "http") return {
+						host: record.host,
+						port: record.port
+					};
+				}
+			} catch {}
+		}
+		await new Promise((resolve$2) => setTimeout(resolve$2, POLL_INTERVAL_MS));
+	}
+	throw new Error(`Timed out waiting for HTTP runtime '${serverId}' to become healthy`);
+}
+function spawnBackgroundRuntime(args, env, cwd) {
+	const { command, args: baseArgs } = buildCliCandidates();
+	const child = (0, node_child_process.spawn)(command, [...baseArgs, ...args], {
+		detached: true,
+		cwd,
+		stdio: "ignore",
+		env
+	});
+	child.unref();
+	return child;
+}
+async function prestartHttpRuntime(options) {
+	const serverId = options.id || require_src.generateServerId();
+	const timeoutMs = parseTimeoutMs(options.timeoutMs);
+	const registryPath = options.registryPath || options.registryDir;
+	const workspaceRoot = resolveWorkspaceRoot();
+	const childEnv = {
+		...process.env,
+		...registryPath ? {
+			PORT_REGISTRY_PATH: registryPath,
+			PROCESS_REGISTRY_PATH: resolveSiblingRegistryPath(registryPath, "processes.json")
+		} : {}
+	};
+	const child = spawnBackgroundRuntime([
+		"mcp-serve",
+		"--type",
+		"http",
+		"--id",
+		serverId,
+		"--host",
+		options.host || DEFAULT_HOST$1,
+		...options.port !== void 0 ? ["--port", String(options.port)] : [],
+		...options.config ? ["--config", options.config] : [],
+		...options.cache === false ? ["--no-cache"] : [],
+		...options.definitionsCache ? ["--definitions-cache", options.definitionsCache] : [],
+		...options.clearDefinitionsCache ? ["--clear-definitions-cache"] : [],
+		"--proxy-mode",
+		options.proxyMode
+	], childEnv, workspaceRoot);
+	const childExit = new Promise((_, reject) => {
+		child.once("exit", (code, signal) => {
+			reject(/* @__PURE__ */ new Error(`Background runtime exited before becoming healthy (code=${code ?? "null"}, signal=${signal ?? "null"})`));
+		});
+	});
+	const runtimeFile = node_path.default.join(require_src.RuntimeStateService.getDefaultRuntimeDir(), `${serverId}.runtime.json`);
+	try {
+		await Promise.race([waitForFile(runtimeFile, timeoutMs), childExit]);
+		const { host, port } = await Promise.race([waitForHealthyRuntime(serverId, timeoutMs), childExit]);
+		return {
+			host,
+			port,
+			serverId,
+			workspaceRoot
+		};
+	} catch (error) {
+		throw new Error(`Failed to prestart HTTP runtime '${serverId}': ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+const prestartHttpCommand = new commander.Command("prestart-http").description("Start an mcp-proxy HTTP runtime in the background and wait until it is healthy").option("--id <id>", "Server identifier to assign to the runtime").option("--host <host>", "Host to bind to", DEFAULT_HOST$1).option("-p, --port <port>", "Preferred HTTP port for the runtime", (value) => Number.parseInt(value, 10)).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--registry-path <path>", "Custom registry path or directory for service discovery").option("--registry-dir <path>", "Custom registry directory for service discovery").option("--timeout-ms <ms>", "How long to wait for the runtime to become healthy", String(DEFAULT_TIMEOUT_MS)).action(async (options) => {
+	try {
+		const { host, port, serverId, workspaceRoot } = await prestartHttpRuntime(options);
+		process.stdout.write(`mcp-proxy HTTP runtime ready at http://${host}:${port} (${serverId})\n`);
+		process.stdout.write(`runtimeId=${serverId}\n`);
+		process.stdout.write(`runtimeUrl=http://${host}:${port}\n`);
+		process.stdout.write(`workspaceRoot=${workspaceRoot}\n`);
+	} catch (error) {
+		throw new Error(`Failed to prestart HTTP runtime '${options.id || "generated-server-id"}': ${error instanceof Error ? error.message : String(error)}`);
+	}
+});
+
 //#endregion
 //#region src/commands/mcp-serve.ts
 /**
@@ -141,7 +304,7 @@ const CONFIG_FILE_NAMES = [
 	"mcp-config.json"
 ];
 const MCP_ENDPOINT_PATH = "/mcp";
-const DEFAULT_HOST$1 = "localhost";
+const DEFAULT_HOST = "localhost";
 const TRANSPORT_TYPE_STDIO = "stdio";
 const TRANSPORT_TYPE_HTTP = "http";
 const TRANSPORT_TYPE_SSE = "sse";
@@ -149,10 +312,14 @@ const TRANSPORT_TYPE_STDIO_HTTP = "stdio-http";
 const RUNTIME_TRANSPORT = TRANSPORT_TYPE_HTTP;
 const PORT_REGISTRY_SERVICE_HTTP = "mcp-proxy-http";
 const PORT_REGISTRY_SERVICE_TYPE = "service";
-const PORT_REGISTRY_REPOSITORY_PATH = process.cwd();
+function getWorkspaceRoot() {
+	return resolveWorkspaceRoot();
+}
 const PROCESS_REGISTRY_SERVICE_HTTP = "mcp-proxy-http";
 const PROCESS_REGISTRY_SERVICE_TYPE = "service";
-const PROCESS_REGISTRY_REPOSITORY_PATH = process.cwd();
+function getRegistryRepositoryPath() {
+	return getWorkspaceRoot();
+}
 function toErrorMessage$9(error) {
 	return error instanceof Error ? error.message : String(error);
 }
@@ -213,7 +380,23 @@ function createTransportConfig(options, mode) {
 	return {
 		mode,
 		port: options.port ?? (Number.isFinite(envPort) ? envPort : void 0),
-		host: options.host || process.env.MCP_HOST || DEFAULT_HOST$1
+		host: options.host || process.env.MCP_HOST || DEFAULT_HOST
+	};
+}
+function createStdioSafeLogger() {
+	const logToStderr = (message, data) => {
+		if (data === void 0) {
+			console.error(message);
+			return;
+		}
+		console.error(message, data);
+	};
+	return {
+		trace: logToStderr,
+		debug: logToStderr,
+		info: logToStderr,
+		warn: logToStderr,
+		error: logToStderr
 	};
 }
 function createServerOptions(options, resolvedConfigPath, serverId) {
@@ -234,7 +417,7 @@ function formatStartError(type, host, port, error) {
 function createRuntimeRecord(serverId, config, port, shutdownToken, configPath) {
 	return {
 		serverId,
-		host: config.host ?? DEFAULT_HOST$1,
+		host: config.host ?? DEFAULT_HOST,
 		port,
 		transport: RUNTIME_TRANSPORT,
 		shutdownToken,
@@ -258,7 +441,7 @@ async function createPortRegistryLease(serviceName, host, preferredPort, serverI
 } : __agimon_ai_foundation_port_registry.DEFAULT_PORT_RANGE) {
 	const portRegistry = createPortRegistryService();
 	const result = await portRegistry.reservePort({
-		repositoryPath: PORT_REGISTRY_REPOSITORY_PATH,
+		repositoryPath: getRegistryRepositoryPath(),
 		serviceName,
 		serviceType: PORT_REGISTRY_SERVICE_TYPE,
 		environment: getRegistryEnvironment(),
@@ -284,7 +467,7 @@ async function createPortRegistryLease(serviceName, host, preferredPort, serverI
 			if (released) return;
 			released = true;
 			const releaseResult = await portRegistry.releasePort({
-				repositoryPath: PORT_REGISTRY_REPOSITORY_PATH,
+				repositoryPath: getRegistryRepositoryPath(),
 				serviceName,
 				serviceType: PORT_REGISTRY_SERVICE_TYPE,
 				pid: process.pid,
@@ -298,7 +481,7 @@ async function createPortRegistryLease(serviceName, host, preferredPort, serverI
 async function createProcessRegistryLease(serviceName, host, port, serverId, transport, configPath) {
 	const processRegistry = createProcessRegistryService();
 	const result = await processRegistry.registerProcess({
-		repositoryPath: PROCESS_REGISTRY_REPOSITORY_PATH,
+		repositoryPath: getRegistryRepositoryPath(),
 		serviceName,
 		serviceType: PROCESS_REGISTRY_SERVICE_TYPE,
 		environment: getRegistryEnvironment(),
@@ -319,7 +502,7 @@ async function createProcessRegistryLease(serviceName, host, port, serverId, tra
 		if (released) return;
 		released = true;
 		const releaseResult = await processRegistry.releaseProcess({
-			repositoryPath: PROCESS_REGISTRY_REPOSITORY_PATH,
+			repositoryPath: getRegistryRepositoryPath(),
 			serviceName,
 			serviceType: PROCESS_REGISTRY_SERVICE_TYPE,
 			pid: process.pid,
@@ -420,13 +603,13 @@ async function createAndStartHttpRuntime(serverOptions, config, resolvedConfigPa
 		min: requestedPort,
 		max: requestedPort
 	} : __agimon_ai_foundation_port_registry.DEFAULT_PORT_RANGE;
-	const portLease = await createPortRegistryLease(PORT_REGISTRY_SERVICE_HTTP, config.host ?? DEFAULT_HOST$1, requestedPort, runtimeServerId, TRANSPORT_TYPE_HTTP, resolvedConfigPath, portRange);
+	const portLease = await createPortRegistryLease(PORT_REGISTRY_SERVICE_HTTP, config.host ?? DEFAULT_HOST, requestedPort, runtimeServerId, TRANSPORT_TYPE_HTTP, resolvedConfigPath, portRange);
 	const runtimePort = portLease.port;
 	const runtimeConfig = {
 		...config,
 		port: runtimePort
 	};
-	const processLease = await createProcessRegistryLease(PROCESS_REGISTRY_SERVICE_HTTP, runtimeConfig.host ?? DEFAULT_HOST$1, runtimePort, runtimeServerId, TRANSPORT_TYPE_HTTP, resolvedConfigPath);
+	const processLease = await createProcessRegistryLease(PROCESS_REGISTRY_SERVICE_HTTP, runtimeConfig.host ?? DEFAULT_HOST, runtimePort, runtimeServerId, TRANSPORT_TYPE_HTTP, resolvedConfigPath);
 	let releasePort = async () => {
 		await releasePortLease(portLease ?? null);
 		releasePort = async () => void 0;
@@ -482,7 +665,7 @@ async function createAndStartHttpRuntime(serverOptions, config, resolvedConfigPa
 }
 async function startStdioTransport(serverOptions) {
 	try {
-		await startServer(new require_src.StdioTransportHandler(await require_src.createServer(serverOptions)));
+		await startServer(new require_src.StdioTransportHandler(await require_src.createServer(serverOptions), createStdioSafeLogger()));
 	} catch (error) {
 		throw new Error(`Failed to start stdio transport: ${toErrorMessage$9(error)}`);
 	}
@@ -494,20 +677,29 @@ async function startSseTransport(serverOptions, config) {
 		throw new Error(`Failed to start SSE transport: ${toErrorMessage$9(error)}`);
 	}
 }
-async function resolveStdioHttpEndpoint(config) {
-	if (config.port !== void 0) return new URL(`http://${config.host ?? DEFAULT_HOST$1}:${config.port}${MCP_ENDPOINT_PATH}`);
+async function resolveStdioHttpEndpoint(config, options, resolvedConfigPath) {
+	const repositoryPath = getRegistryRepositoryPath();
+	if (config.port !== void 0) return new URL(`http://${config.host ?? DEFAULT_HOST}:${config.port}${MCP_ENDPOINT_PATH}`);
 	const result = await createPortRegistryService().getPort({
-		repositoryPath: PORT_REGISTRY_REPOSITORY_PATH,
+		repositoryPath,
 		serviceName: PORT_REGISTRY_SERVICE_HTTP,
 		serviceType: PORT_REGISTRY_SERVICE_TYPE,
 		environment: getRegistryEnvironment()
 	});
-	if (!result.success || !result.record) throw new Error(result.error || "No prestarted HTTP backend found for stdio-http transport");
-	return new URL(`http://${config.host ?? result.record.host}:${result.record.port}${MCP_ENDPOINT_PATH}`);
+	if (result.success && result.record) return new URL(`http://${config.host ?? result.record.host}:${result.record.port}${MCP_ENDPOINT_PATH}`);
+	const runtime = await prestartHttpRuntime({
+		host: config.host ?? DEFAULT_HOST,
+		config: options.config || resolvedConfigPath,
+		cache: options.cache,
+		definitionsCache: options.definitionsCache,
+		clearDefinitionsCache: options.clearDefinitionsCache,
+		proxyMode: options.proxyMode
+	});
+	return new URL(`http://${runtime.host}:${runtime.port}${MCP_ENDPOINT_PATH}`);
 }
-async function startStdioHttpTransport(config) {
+async function startStdioHttpTransport(config, options, resolvedConfigPath) {
 	try {
-		await startServer(new require_src.StdioHttpTransportHandler({ endpoint: await resolveStdioHttpEndpoint(config) }));
+		await startServer(new require_src.StdioHttpTransportHandler({ endpoint: await resolveStdioHttpEndpoint(config, options, resolvedConfigPath) }, createStdioSafeLogger()));
 	} catch (error) {
 		throw new Error(`Failed to start stdio-http transport: ${toErrorMessage$9(error)}`);
 	}
@@ -526,7 +718,7 @@ async function startTransport(transportType, options, resolvedConfigPath, server
 			await startSseTransport(serverOptions, createTransportConfig(options, require_src.TRANSPORT_MODE.SSE));
 			return;
 		}
-		await startStdioHttpTransport(createTransportConfig(options, require_src.TRANSPORT_MODE.HTTP));
+		await startStdioHttpTransport(createTransportConfig(options, require_src.TRANSPORT_MODE.HTTP), options, resolvedConfigPath);
 	} catch (error) {
 		throw new Error(`Failed to start transport '${transportType}': ${toErrorMessage$9(error)}`);
 	}
@@ -534,7 +726,7 @@ async function startTransport(transportType, options, resolvedConfigPath, server
 /**
 * MCP Serve command
 */
-const mcpServeCommand = new commander.Command("mcp-serve").description("Start MCP server with specified transport").option("-t, --type <type>", `Transport type: ${TRANSPORT_TYPE_STDIO}, ${TRANSPORT_TYPE_HTTP}, ${TRANSPORT_TYPE_SSE}, or ${TRANSPORT_TYPE_STDIO_HTTP}`, TRANSPORT_TYPE_STDIO).option("-p, --port <port>", "Port to listen on (http/sse) or backend port for stdio-http", (val) => parseInt(val, 10)).option("--host <host>", "Host to bind to (http/sse) or backend host for stdio-http", DEFAULT_HOST$1).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--id <id>", "Unique server identifier (overrides config file id, auto-generated if not provided)").action(async (options) => {
+const mcpServeCommand = new commander.Command("mcp-serve").description("Start MCP server with specified transport").option("-t, --type <type>", `Transport type: ${TRANSPORT_TYPE_STDIO}, ${TRANSPORT_TYPE_HTTP}, ${TRANSPORT_TYPE_SSE}, or ${TRANSPORT_TYPE_STDIO_HTTP}`, TRANSPORT_TYPE_STDIO).option("-p, --port <port>", "Port to listen on (http/sse) or backend port for stdio-http", (val) => Number.parseInt(val, 10)).option("--host <host>", "Host to bind to (http/sse) or backend host for stdio-http", DEFAULT_HOST).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--id <id>", "Unique server identifier (overrides config file id, auto-generated if not provided)").action(async (options) => {
 	try {
 		const transportType = validateTransportType(options.type.toLowerCase());
 		validateProxyMode(options.proxyMode);
@@ -550,156 +742,6 @@ const mcpServeCommand = new commander.Command("mcp-serve").description("Start MC
 	}
 });
 
-//#endregion
-//#region src/commands/prestart-http.ts
-/**
-* Prestart HTTP Command
-*
-* Starts an mcp-proxy HTTP runtime in the background, waits until it is healthy,
-* and then exits so the runtime can be reused by other commands.
-*/
-const WORKSPACE_MARKERS = [
-	"pnpm-workspace.yaml",
-	"nx.json",
-	".git"
-];
-const DEFAULT_HOST = "localhost";
-const DEFAULT_TIMEOUT_MS = 12e4;
-const POLL_INTERVAL_MS = 250;
-function resolveWorkspaceRoot(startPath = process.cwd()) {
-	let current = node_path.default.resolve(startPath);
-	while (true) {
-		for (const marker of WORKSPACE_MARKERS) if ((0, node_fs.existsSync)(node_path.default.join(current, marker))) return current;
-		const parent = node_path.default.dirname(current);
-		if (parent === current) return process.cwd();
-		current = parent;
-	}
-}
-function resolveSiblingRegistryPath(registryPath, fileName) {
-	if (!registryPath) return;
-	const resolved = node_path.default.resolve(registryPath);
-	if (node_path.default.extname(resolved) === ".json") return node_path.default.join(node_path.default.dirname(resolved), fileName);
-	return node_path.default.join(resolved, fileName);
-}
-function buildCliCandidates() {
-	const __filename$1 = (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
-	const __dirname$1 = node_path.default.dirname(__filename$1);
-	const distCandidates = [
-		node_path.default.resolve(__dirname$1, "cli.mjs"),
-		node_path.default.resolve(__dirname$1, "..", "dist", "cli.mjs"),
-		node_path.default.resolve(__dirname$1, "..", "..", "dist", "cli.mjs")
-	];
-	const srcCandidates = [node_path.default.resolve(__dirname$1, "..", "cli.ts"), node_path.default.resolve(__dirname$1, "..", "..", "src", "cli.ts")];
-	for (const candidate of distCandidates) if ((0, node_fs.existsSync)(candidate)) return {
-		command: process.execPath,
-		args: [candidate]
-	};
-	for (const candidate of srcCandidates) if ((0, node_fs.existsSync)(candidate)) return {
-		command: process.execPath,
-		args: [
-			"--import",
-			"tsx",
-			candidate
-		]
-	};
-	throw new Error("Unable to locate mcp-proxy CLI entrypoint");
-}
-function parseTimeoutMs(value) {
-	if (!value) return DEFAULT_TIMEOUT_MS;
-	const parsed = Number.parseInt(value, 10);
-	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`Invalid timeout value: ${value}`);
-	return parsed;
-}
-async function waitForFile(filePath, timeoutMs) {
-	const deadline = Date.now() + timeoutMs;
-	while (Date.now() < deadline) {
-		try {
-			await (0, node_fs_promises.access)(filePath);
-			return;
-		} catch {}
-		await new Promise((resolve$2) => setTimeout(resolve$2, POLL_INTERVAL_MS));
-	}
-	throw new Error(`Timed out waiting for runtime state file: ${filePath}`);
-}
-async function waitForHealthyRuntime(serverId, timeoutMs) {
-	const runtimeStateService = new require_src.RuntimeStateService();
-	const deadline = Date.now() + timeoutMs;
-	while (Date.now() < deadline) {
-		const record = await runtimeStateService.read(serverId);
-		if (record) {
-			const healthUrl = `http://${record.host}:${record.port}/health`;
-			try {
-				const response = await fetch(healthUrl);
-				if (response.ok) {
-					const payload = await response.json().catch(() => null);
-					if (!payload || payload.transport === "http") return {
-						host: record.host,
-						port: record.port
-					};
-				}
-			} catch {}
-		}
-		await new Promise((resolve$2) => setTimeout(resolve$2, POLL_INTERVAL_MS));
-	}
-	throw new Error(`Timed out waiting for HTTP runtime '${serverId}' to become healthy`);
-}
-function spawnBackgroundRuntime(args, env) {
-	const { command, args: baseArgs } = buildCliCandidates();
-	const child = (0, node_child_process.spawn)(command, [...baseArgs, ...args], {
-		detached: true,
-		stdio: "ignore",
-		env
-	});
-	child.unref();
-	return child;
-}
-const prestartHttpCommand = new commander.Command("prestart-http").description("Start an mcp-proxy HTTP runtime in the background and wait until it is healthy").option("--id <id>", "Server identifier to assign to the runtime").option("--host <host>", "Host to bind to", DEFAULT_HOST).option("-p, --port <port>", "Preferred HTTP port for the runtime", (value) => Number.parseInt(value, 10)).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--registry-path <path>", "Custom registry path or directory for service discovery").option("--registry-dir <path>", "Custom registry directory for service discovery").option("--timeout-ms <ms>", "How long to wait for the runtime to become healthy", String(DEFAULT_TIMEOUT_MS)).action(async (options) => {
-	const serverId = options.id || require_src.generateServerId();
-	const timeoutMs = parseTimeoutMs(options.timeoutMs);
-	const registryPath = options.registryPath || options.registryDir;
-	new require_src.RuntimeStateService();
-	const workspaceRoot = resolveWorkspaceRoot(process.cwd());
-	const childEnv = {
-		...process.env,
-		...registryPath ? {
-			PORT_REGISTRY_PATH: registryPath,
-			PROCESS_REGISTRY_PATH: resolveSiblingRegistryPath(registryPath, "processes.json")
-		} : {}
-	};
-	const child = spawnBackgroundRuntime([
-		"mcp-serve",
-		"--type",
-		"http",
-		"--id",
-		serverId,
-		"--host",
-		options.host || DEFAULT_HOST,
-		...options.port !== void 0 ? ["--port", String(options.port)] : [],
-		...options.config ? ["--config", options.config] : [],
-		...options.cache === false ? ["--no-cache"] : [],
-		...options.definitionsCache ? ["--definitions-cache", options.definitionsCache] : [],
-		...options.clearDefinitionsCache ? ["--clear-definitions-cache"] : [],
-		"--proxy-mode",
-		options.proxyMode
-	], childEnv);
-	const childExit = new Promise((_, reject) => {
-		child.once("exit", (code, signal) => {
-			reject(/* @__PURE__ */ new Error(`Background runtime exited before becoming healthy (code=${code ?? "null"}, signal=${signal ?? "null"})`));
-		});
-	});
-	const runtimeFile = node_path.default.join(require_src.RuntimeStateService.getDefaultRuntimeDir(), `${serverId}.runtime.json`);
-	try {
-		await Promise.race([waitForFile(runtimeFile, timeoutMs), childExit]);
-		const { host, port } = await Promise.race([waitForHealthyRuntime(serverId, timeoutMs), childExit]);
-		process.stdout.write(`mcp-proxy HTTP runtime ready at http://${host}:${port} (${serverId})\n`);
-		process.stdout.write(`runtimeId=${serverId}\n`);
-		process.stdout.write(`runtimeUrl=http://${host}:${port}\n`);
-		process.stdout.write(`workspaceRoot=${workspaceRoot}\n`);
-	} catch (error) {
-		throw new Error(`Failed to prestart HTTP runtime '${serverId}': ${error instanceof Error ? error.message : String(error)}`);
-	}
-});
-
 //#endregion
 //#region src/commands/bootstrap.ts
 function toErrorMessage$8(error) {

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { D as findConfigFile, E as generateServerId, T as DefinitionsCacheService, d as version, f as StdioHttpTransportHandler, h as HttpTransportHandler, m as SseTransportHandler, n as createServer, o as createProxyIoCContainer, p as StdioTransportHandler, r as createSessionServer, t as TRANSPORT_MODE, u as initializeSharedServices, v as RuntimeStateService } from "./src-0OJqEpGA.mjs";
+import { D as findConfigFile, E as generateServerId, T as DefinitionsCacheService, d as version, f as StdioHttpTransportHandler, h as HttpTransportHandler, m as SseTransportHandler, n as createServer, o as createProxyIoCContainer, p as StdioTransportHandler, r as createSessionServer, t as TRANSPORT_MODE, u as initializeSharedServices, v as RuntimeStateService } from "./src-DCIv5S_2.mjs";
 import { randomUUID } from "node:crypto";
 import { access, writeFile } from "node:fs/promises";
 import path, { join, resolve } from "node:path";
@@ -7,8 +7,8 @@ import { constants, existsSync } from "node:fs";
 import { Liquid } from "liquidjs";
 import { spawn } from "node:child_process";
 import { Command } from "commander";
-import { ProcessRegistryService } from "@agimon-ai/foundation-process-registry";
 import { DEFAULT_PORT_RANGE, PortRegistryService } from "@agimon-ai/foundation-port-registry";
+import { ProcessRegistryService } from "@agimon-ai/foundation-process-registry";
 import { fileURLToPath } from "node:url";
 
 //#region src/utils/output.ts
@@ -112,6 +112,169 @@ const initCommand = new Command("init").description("Initialize MCP configuratio
 	}
 });
 
+//#endregion
+//#region src/commands/prestart-http.ts
+/**
+* Prestart HTTP Command
+*
+* Starts an mcp-proxy HTTP runtime in the background, waits until it is healthy,
+* and then exits so the runtime can be reused by other commands.
+*/
+const WORKSPACE_MARKERS = [
+	"pnpm-workspace.yaml",
+	"nx.json",
+	".git"
+];
+const DEFAULT_HOST$1 = "localhost";
+const DEFAULT_TIMEOUT_MS = 12e4;
+const POLL_INTERVAL_MS = 250;
+function resolveWorkspaceRoot(startPath = process.env.PROJECT_PATH || process.cwd()) {
+	let current = path.resolve(startPath);
+	while (true) {
+		for (const marker of WORKSPACE_MARKERS) if (existsSync(path.join(current, marker))) return current;
+		const parent = path.dirname(current);
+		if (parent === current) return process.cwd();
+		current = parent;
+	}
+}
+function resolveSiblingRegistryPath(registryPath, fileName) {
+	if (!registryPath) return;
+	const resolved = path.resolve(registryPath);
+	if (path.extname(resolved) === ".json") return path.join(path.dirname(resolved), fileName);
+	return path.join(resolved, fileName);
+}
+function buildCliCandidates() {
+	const __filename = fileURLToPath(import.meta.url);
+	const __dirname = path.dirname(__filename);
+	const distCandidates = [
+		path.resolve(__dirname, "cli.mjs"),
+		path.resolve(__dirname, "..", "dist", "cli.mjs"),
+		path.resolve(__dirname, "..", "..", "dist", "cli.mjs")
+	];
+	const srcCandidates = [path.resolve(__dirname, "..", "cli.ts"), path.resolve(__dirname, "..", "..", "src", "cli.ts")];
+	for (const candidate of distCandidates) if (existsSync(candidate)) return {
+		command: process.execPath,
+		args: [candidate]
+	};
+	for (const candidate of srcCandidates) if (existsSync(candidate)) return {
+		command: process.execPath,
+		args: [
+			"--import",
+			"tsx",
+			candidate
+		]
+	};
+	throw new Error("Unable to locate mcp-proxy CLI entrypoint");
+}
+function parseTimeoutMs(value) {
+	if (!value) return DEFAULT_TIMEOUT_MS;
+	const parsed = Number.parseInt(value, 10);
+	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`Invalid timeout value: ${value}`);
+	return parsed;
+}
+async function waitForFile(filePath, timeoutMs) {
+	const deadline = Date.now() + timeoutMs;
+	while (Date.now() < deadline) {
+		try {
+			await access(filePath);
+			return;
+		} catch {}
+		await new Promise((resolve$1) => setTimeout(resolve$1, POLL_INTERVAL_MS));
+	}
+	throw new Error(`Timed out waiting for runtime state file: ${filePath}`);
+}
+async function waitForHealthyRuntime(serverId, timeoutMs) {
+	const runtimeStateService = new RuntimeStateService();
+	const deadline = Date.now() + timeoutMs;
+	while (Date.now() < deadline) {
+		const record = await runtimeStateService.read(serverId);
+		if (record) {
+			const healthUrl = `http://${record.host}:${record.port}/health`;
+			try {
+				const response = await fetch(healthUrl);
+				if (response.ok) {
+					const payload = await response.json().catch(() => null);
+					if (!payload || payload.transport === "http") return {
+						host: record.host,
+						port: record.port
+					};
+				}
+			} catch {}
+		}
+		await new Promise((resolve$1) => setTimeout(resolve$1, POLL_INTERVAL_MS));
+	}
+	throw new Error(`Timed out waiting for HTTP runtime '${serverId}' to become healthy`);
+}
+function spawnBackgroundRuntime(args, env, cwd) {
+	const { command, args: baseArgs } = buildCliCandidates();
+	const child = spawn(command, [...baseArgs, ...args], {
+		detached: true,
+		cwd,
+		stdio: "ignore",
+		env
+	});
+	child.unref();
+	return child;
+}
+async function prestartHttpRuntime(options) {
+	const serverId = options.id || generateServerId();
+	const timeoutMs = parseTimeoutMs(options.timeoutMs);
+	const registryPath = options.registryPath || options.registryDir;
+	const workspaceRoot = resolveWorkspaceRoot();
+	const childEnv = {
+		...process.env,
+		...registryPath ? {
+			PORT_REGISTRY_PATH: registryPath,
+			PROCESS_REGISTRY_PATH: resolveSiblingRegistryPath(registryPath, "processes.json")
+		} : {}
+	};
+	const child = spawnBackgroundRuntime([
+		"mcp-serve",
+		"--type",
+		"http",
+		"--id",
+		serverId,
+		"--host",
+		options.host || DEFAULT_HOST$1,
+		...options.port !== void 0 ? ["--port", String(options.port)] : [],
+		...options.config ? ["--config", options.config] : [],
+		...options.cache === false ? ["--no-cache"] : [],
+		...options.definitionsCache ? ["--definitions-cache", options.definitionsCache] : [],
+		...options.clearDefinitionsCache ? ["--clear-definitions-cache"] : [],
+		"--proxy-mode",
+		options.proxyMode
+	], childEnv, workspaceRoot);
+	const childExit = new Promise((_, reject) => {
+		child.once("exit", (code, signal) => {
+			reject(/* @__PURE__ */ new Error(`Background runtime exited before becoming healthy (code=${code ?? "null"}, signal=${signal ?? "null"})`));
+		});
+	});
+	const runtimeFile = path.join(RuntimeStateService.getDefaultRuntimeDir(), `${serverId}.runtime.json`);
+	try {
+		await Promise.race([waitForFile(runtimeFile, timeoutMs), childExit]);
+		const { host, port } = await Promise.race([waitForHealthyRuntime(serverId, timeoutMs), childExit]);
+		return {
+			host,
+			port,
+			serverId,
+			workspaceRoot
+		};
+	} catch (error) {
+		throw new Error(`Failed to prestart HTTP runtime '${serverId}': ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+const prestartHttpCommand = new Command("prestart-http").description("Start an mcp-proxy HTTP runtime in the background and wait until it is healthy").option("--id <id>", "Server identifier to assign to the runtime").option("--host <host>", "Host to bind to", DEFAULT_HOST$1).option("-p, --port <port>", "Preferred HTTP port for the runtime", (value) => Number.parseInt(value, 10)).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--registry-path <path>", "Custom registry path or directory for service discovery").option("--registry-dir <path>", "Custom registry directory for service discovery").option("--timeout-ms <ms>", "How long to wait for the runtime to become healthy", String(DEFAULT_TIMEOUT_MS)).action(async (options) => {
+	try {
+		const { host, port, serverId, workspaceRoot } = await prestartHttpRuntime(options);
+		process.stdout.write(`mcp-proxy HTTP runtime ready at http://${host}:${port} (${serverId})\n`);
+		process.stdout.write(`runtimeId=${serverId}\n`);
+		process.stdout.write(`runtimeUrl=http://${host}:${port}\n`);
+		process.stdout.write(`workspaceRoot=${workspaceRoot}\n`);
+	} catch (error) {
+		throw new Error(`Failed to prestart HTTP runtime '${options.id || "generated-server-id"}': ${error instanceof Error ? error.message : String(error)}`);
+	}
+});
+
 //#endregion
 //#region src/commands/mcp-serve.ts
 /**
@@ -140,7 +303,7 @@ const CONFIG_FILE_NAMES = [
 	"mcp-config.json"
 ];
 const MCP_ENDPOINT_PATH = "/mcp";
-const DEFAULT_HOST$1 = "localhost";
+const DEFAULT_HOST = "localhost";
 const TRANSPORT_TYPE_STDIO = "stdio";
 const TRANSPORT_TYPE_HTTP = "http";
 const TRANSPORT_TYPE_SSE = "sse";
@@ -148,10 +311,14 @@ const TRANSPORT_TYPE_STDIO_HTTP = "stdio-http";
 const RUNTIME_TRANSPORT = TRANSPORT_TYPE_HTTP;
 const PORT_REGISTRY_SERVICE_HTTP = "mcp-proxy-http";
 const PORT_REGISTRY_SERVICE_TYPE = "service";
-const PORT_REGISTRY_REPOSITORY_PATH = process.cwd();
+function getWorkspaceRoot() {
+	return resolveWorkspaceRoot();
+}
 const PROCESS_REGISTRY_SERVICE_HTTP = "mcp-proxy-http";
 const PROCESS_REGISTRY_SERVICE_TYPE = "service";
-const PROCESS_REGISTRY_REPOSITORY_PATH = process.cwd();
+function getRegistryRepositoryPath() {
+	return getWorkspaceRoot();
+}
 function toErrorMessage$9(error) {
 	return error instanceof Error ? error.message : String(error);
 }
@@ -212,7 +379,23 @@ function createTransportConfig(options, mode) {
 	return {
 		mode,
 		port: options.port ?? (Number.isFinite(envPort) ? envPort : void 0),
-		host: options.host || process.env.MCP_HOST || DEFAULT_HOST$1
+		host: options.host || process.env.MCP_HOST || DEFAULT_HOST
+	};
+}
+function createStdioSafeLogger() {
+	const logToStderr = (message, data) => {
+		if (data === void 0) {
+			console.error(message);
+			return;
+		}
+		console.error(message, data);
+	};
+	return {
+		trace: logToStderr,
+		debug: logToStderr,
+		info: logToStderr,
+		warn: logToStderr,
+		error: logToStderr
 	};
 }
 function createServerOptions(options, resolvedConfigPath, serverId) {
@@ -233,7 +416,7 @@ function formatStartError(type, host, port, error) {
 function createRuntimeRecord(serverId, config, port, shutdownToken, configPath) {
 	return {
 		serverId,
-		host: config.host ?? DEFAULT_HOST$1,
+		host: config.host ?? DEFAULT_HOST,
 		port,
 		transport: RUNTIME_TRANSPORT,
 		shutdownToken,
@@ -257,7 +440,7 @@ async function createPortRegistryLease(serviceName, host, preferredPort, serverI
 } : DEFAULT_PORT_RANGE) {
 	const portRegistry = createPortRegistryService();
 	const result = await portRegistry.reservePort({
-		repositoryPath: PORT_REGISTRY_REPOSITORY_PATH,
+		repositoryPath: getRegistryRepositoryPath(),
 		serviceName,
 		serviceType: PORT_REGISTRY_SERVICE_TYPE,
 		environment: getRegistryEnvironment(),
@@ -283,7 +466,7 @@ async function createPortRegistryLease(serviceName, host, preferredPort, serverI
 			if (released) return;
 			released = true;
 			const releaseResult = await portRegistry.releasePort({
-				repositoryPath: PORT_REGISTRY_REPOSITORY_PATH,
+				repositoryPath: getRegistryRepositoryPath(),
 				serviceName,
 				serviceType: PORT_REGISTRY_SERVICE_TYPE,
 				pid: process.pid,
@@ -297,7 +480,7 @@ async function createPortRegistryLease(serviceName, host, preferredPort, serverI
 async function createProcessRegistryLease(serviceName, host, port, serverId, transport, configPath) {
 	const processRegistry = createProcessRegistryService();
 	const result = await processRegistry.registerProcess({
-		repositoryPath: PROCESS_REGISTRY_REPOSITORY_PATH,
+		repositoryPath: getRegistryRepositoryPath(),
 		serviceName,
 		serviceType: PROCESS_REGISTRY_SERVICE_TYPE,
 		environment: getRegistryEnvironment(),
@@ -318,7 +501,7 @@ async function createProcessRegistryLease(serviceName, host, port, serverId, tra
 		if (released) return;
 		released = true;
 		const releaseResult = await processRegistry.releaseProcess({
-			repositoryPath: PROCESS_REGISTRY_REPOSITORY_PATH,
+			repositoryPath: getRegistryRepositoryPath(),
 			serviceName,
 			serviceType: PROCESS_REGISTRY_SERVICE_TYPE,
 			pid: process.pid,
@@ -419,13 +602,13 @@ async function createAndStartHttpRuntime(serverOptions, config, resolvedConfigPa
 		min: requestedPort,
 		max: requestedPort
 	} : DEFAULT_PORT_RANGE;
-	const portLease = await createPortRegistryLease(PORT_REGISTRY_SERVICE_HTTP, config.host ?? DEFAULT_HOST$1, requestedPort, runtimeServerId, TRANSPORT_TYPE_HTTP, resolvedConfigPath, portRange);
+	const portLease = await createPortRegistryLease(PORT_REGISTRY_SERVICE_HTTP, config.host ?? DEFAULT_HOST, requestedPort, runtimeServerId, TRANSPORT_TYPE_HTTP, resolvedConfigPath, portRange);
 	const runtimePort = portLease.port;
 	const runtimeConfig = {
 		...config,
 		port: runtimePort
 	};
-	const processLease = await createProcessRegistryLease(PROCESS_REGISTRY_SERVICE_HTTP, runtimeConfig.host ?? DEFAULT_HOST$1, runtimePort, runtimeServerId, TRANSPORT_TYPE_HTTP, resolvedConfigPath);
+	const processLease = await createProcessRegistryLease(PROCESS_REGISTRY_SERVICE_HTTP, runtimeConfig.host ?? DEFAULT_HOST, runtimePort, runtimeServerId, TRANSPORT_TYPE_HTTP, resolvedConfigPath);
 	let releasePort = async () => {
 		await releasePortLease(portLease ?? null);
 		releasePort = async () => void 0;
@@ -481,7 +664,7 @@ async function createAndStartHttpRuntime(serverOptions, config, resolvedConfigPa
 }
 async function startStdioTransport(serverOptions) {
 	try {
-		await startServer(new StdioTransportHandler(await createServer(serverOptions)));
+		await startServer(new StdioTransportHandler(await createServer(serverOptions), createStdioSafeLogger()));
 	} catch (error) {
 		throw new Error(`Failed to start stdio transport: ${toErrorMessage$9(error)}`);
 	}
@@ -493,20 +676,29 @@ async function startSseTransport(serverOptions, config) {
 		throw new Error(`Failed to start SSE transport: ${toErrorMessage$9(error)}`);
 	}
 }
-async function resolveStdioHttpEndpoint(config) {
-	if (config.port !== void 0) return new URL(`http://${config.host ?? DEFAULT_HOST$1}:${config.port}${MCP_ENDPOINT_PATH}`);
+async function resolveStdioHttpEndpoint(config, options, resolvedConfigPath) {
+	const repositoryPath = getRegistryRepositoryPath();
+	if (config.port !== void 0) return new URL(`http://${config.host ?? DEFAULT_HOST}:${config.port}${MCP_ENDPOINT_PATH}`);
 	const result = await createPortRegistryService().getPort({
-		repositoryPath: PORT_REGISTRY_REPOSITORY_PATH,
+		repositoryPath,
 		serviceName: PORT_REGISTRY_SERVICE_HTTP,
 		serviceType: PORT_REGISTRY_SERVICE_TYPE,
 		environment: getRegistryEnvironment()
 	});
-	if (!result.success || !result.record) throw new Error(result.error || "No prestarted HTTP backend found for stdio-http transport");
-	return new URL(`http://${config.host ?? result.record.host}:${result.record.port}${MCP_ENDPOINT_PATH}`);
+	if (result.success && result.record) return new URL(`http://${config.host ?? result.record.host}:${result.record.port}${MCP_ENDPOINT_PATH}`);
+	const runtime = await prestartHttpRuntime({
+		host: config.host ?? DEFAULT_HOST,
+		config: options.config || resolvedConfigPath,
+		cache: options.cache,
+		definitionsCache: options.definitionsCache,
+		clearDefinitionsCache: options.clearDefinitionsCache,
+		proxyMode: options.proxyMode
+	});
+	return new URL(`http://${runtime.host}:${runtime.port}${MCP_ENDPOINT_PATH}`);
 }
-async function startStdioHttpTransport(config) {
+async function startStdioHttpTransport(config, options, resolvedConfigPath) {
 	try {
-		await startServer(new StdioHttpTransportHandler({ endpoint: await resolveStdioHttpEndpoint(config) }));
+		await startServer(new StdioHttpTransportHandler({ endpoint: await resolveStdioHttpEndpoint(config, options, resolvedConfigPath) }, createStdioSafeLogger()));
 	} catch (error) {
 		throw new Error(`Failed to start stdio-http transport: ${toErrorMessage$9(error)}`);
 	}
@@ -525,7 +717,7 @@ async function startTransport(transportType, options, resolvedConfigPath, server
 			await startSseTransport(serverOptions, createTransportConfig(options, TRANSPORT_MODE.SSE));
 			return;
 		}
-		await startStdioHttpTransport(createTransportConfig(options, TRANSPORT_MODE.HTTP));
+		await startStdioHttpTransport(createTransportConfig(options, TRANSPORT_MODE.HTTP), options, resolvedConfigPath);
 	} catch (error) {
 		throw new Error(`Failed to start transport '${transportType}': ${toErrorMessage$9(error)}`);
 	}
@@ -533,7 +725,7 @@ async function startTransport(transportType, options, resolvedConfigPath, server
 /**
 * MCP Serve command
 */
-const mcpServeCommand = new Command("mcp-serve").description("Start MCP server with specified transport").option("-t, --type <type>", `Transport type: ${TRANSPORT_TYPE_STDIO}, ${TRANSPORT_TYPE_HTTP}, ${TRANSPORT_TYPE_SSE}, or ${TRANSPORT_TYPE_STDIO_HTTP}`, TRANSPORT_TYPE_STDIO).option("-p, --port <port>", "Port to listen on (http/sse) or backend port for stdio-http", (val) => parseInt(val, 10)).option("--host <host>", "Host to bind to (http/sse) or backend host for stdio-http", DEFAULT_HOST$1).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--id <id>", "Unique server identifier (overrides config file id, auto-generated if not provided)").action(async (options) => {
+const mcpServeCommand = new Command("mcp-serve").description("Start MCP server with specified transport").option("-t, --type <type>", `Transport type: ${TRANSPORT_TYPE_STDIO}, ${TRANSPORT_TYPE_HTTP}, ${TRANSPORT_TYPE_SSE}, or ${TRANSPORT_TYPE_STDIO_HTTP}`, TRANSPORT_TYPE_STDIO).option("-p, --port <port>", "Port to listen on (http/sse) or backend port for stdio-http", (val) => Number.parseInt(val, 10)).option("--host <host>", "Host to bind to (http/sse) or backend host for stdio-http", DEFAULT_HOST).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--id <id>", "Unique server identifier (overrides config file id, auto-generated if not provided)").action(async (options) => {
 	try {
 		const transportType = validateTransportType(options.type.toLowerCase());
 		validateProxyMode(options.proxyMode);
@@ -549,156 +741,6 @@ const mcpServeCommand = new Command("mcp-serve").description("Start MCP server w
 	}
 });
 
-//#endregion
-//#region src/commands/prestart-http.ts
-/**
-* Prestart HTTP Command
-*
-* Starts an mcp-proxy HTTP runtime in the background, waits until it is healthy,
-* and then exits so the runtime can be reused by other commands.
-*/
-const WORKSPACE_MARKERS = [
-	"pnpm-workspace.yaml",
-	"nx.json",
-	".git"
-];
-const DEFAULT_HOST = "localhost";
-const DEFAULT_TIMEOUT_MS = 12e4;
-const POLL_INTERVAL_MS = 250;
-function resolveWorkspaceRoot(startPath = process.cwd()) {
-	let current = path.resolve(startPath);
-	while (true) {
-		for (const marker of WORKSPACE_MARKERS) if (existsSync(path.join(current, marker))) return current;
-		const parent = path.dirname(current);
-		if (parent === current) return process.cwd();
-		current = parent;
-	}
-}
-function resolveSiblingRegistryPath(registryPath, fileName) {
-	if (!registryPath) return;
-	const resolved = path.resolve(registryPath);
-	if (path.extname(resolved) === ".json") return path.join(path.dirname(resolved), fileName);
-	return path.join(resolved, fileName);
-}
-function buildCliCandidates() {
-	const __filename = fileURLToPath(import.meta.url);
-	const __dirname = path.dirname(__filename);
-	const distCandidates = [
-		path.resolve(__dirname, "cli.mjs"),
-		path.resolve(__dirname, "..", "dist", "cli.mjs"),
-		path.resolve(__dirname, "..", "..", "dist", "cli.mjs")
-	];
-	const srcCandidates = [path.resolve(__dirname, "..", "cli.ts"), path.resolve(__dirname, "..", "..", "src", "cli.ts")];
-	for (const candidate of distCandidates) if (existsSync(candidate)) return {
-		command: process.execPath,
-		args: [candidate]
-	};
-	for (const candidate of srcCandidates) if (existsSync(candidate)) return {
-		command: process.execPath,
-		args: [
-			"--import",
-			"tsx",
-			candidate
-		]
-	};
-	throw new Error("Unable to locate mcp-proxy CLI entrypoint");
-}
-function parseTimeoutMs(value) {
-	if (!value) return DEFAULT_TIMEOUT_MS;
-	const parsed = Number.parseInt(value, 10);
-	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`Invalid timeout value: ${value}`);
-	return parsed;
-}
-async function waitForFile(filePath, timeoutMs) {
-	const deadline = Date.now() + timeoutMs;
-	while (Date.now() < deadline) {
-		try {
-			await access(filePath);
-			return;
-		} catch {}
-		await new Promise((resolve$1) => setTimeout(resolve$1, POLL_INTERVAL_MS));
-	}
-	throw new Error(`Timed out waiting for runtime state file: ${filePath}`);
-}
-async function waitForHealthyRuntime(serverId, timeoutMs) {
-	const runtimeStateService = new RuntimeStateService();
-	const deadline = Date.now() + timeoutMs;
-	while (Date.now() < deadline) {
-		const record = await runtimeStateService.read(serverId);
-		if (record) {
-			const healthUrl = `http://${record.host}:${record.port}/health`;
-			try {
-				const response = await fetch(healthUrl);
-				if (response.ok) {
-					const payload = await response.json().catch(() => null);
-					if (!payload || payload.transport === "http") return {
-						host: record.host,
-						port: record.port
-					};
-				}
-			} catch {}
-		}
-		await new Promise((resolve$1) => setTimeout(resolve$1, POLL_INTERVAL_MS));
-	}
-	throw new Error(`Timed out waiting for HTTP runtime '${serverId}' to become healthy`);
-}
-function spawnBackgroundRuntime(args, env) {
-	const { command, args: baseArgs } = buildCliCandidates();
-	const child = spawn(command, [...baseArgs, ...args], {
-		detached: true,
-		stdio: "ignore",
-		env
-	});
-	child.unref();
-	return child;
-}
-const prestartHttpCommand = new Command("prestart-http").description("Start an mcp-proxy HTTP runtime in the background and wait until it is healthy").option("--id <id>", "Server identifier to assign to the runtime").option("--host <host>", "Host to bind to", DEFAULT_HOST).option("-p, --port <port>", "Preferred HTTP port for the runtime", (value) => Number.parseInt(value, 10)).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--registry-path <path>", "Custom registry path or directory for service discovery").option("--registry-dir <path>", "Custom registry directory for service discovery").option("--timeout-ms <ms>", "How long to wait for the runtime to become healthy", String(DEFAULT_TIMEOUT_MS)).action(async (options) => {
-	const serverId = options.id || generateServerId();
-	const timeoutMs = parseTimeoutMs(options.timeoutMs);
-	const registryPath = options.registryPath || options.registryDir;
-	new RuntimeStateService();
-	const workspaceRoot = resolveWorkspaceRoot(process.cwd());
-	const childEnv = {
-		...process.env,
-		...registryPath ? {
-			PORT_REGISTRY_PATH: registryPath,
-			PROCESS_REGISTRY_PATH: resolveSiblingRegistryPath(registryPath, "processes.json")
-		} : {}
-	};
-	const child = spawnBackgroundRuntime([
-		"mcp-serve",
-		"--type",
-		"http",
-		"--id",
-		serverId,
-		"--host",
-		options.host || DEFAULT_HOST,
-		...options.port !== void 0 ? ["--port", String(options.port)] : [],
-		...options.config ? ["--config", options.config] : [],
-		...options.cache === false ? ["--no-cache"] : [],
-		...options.definitionsCache ? ["--definitions-cache", options.definitionsCache] : [],
-		...options.clearDefinitionsCache ? ["--clear-definitions-cache"] : [],
-		"--proxy-mode",
-		options.proxyMode
-	], childEnv);
-	const childExit = new Promise((_, reject) => {
-		child.once("exit", (code, signal) => {
-			reject(/* @__PURE__ */ new Error(`Background runtime exited before becoming healthy (code=${code ?? "null"}, signal=${signal ?? "null"})`));
-		});
-	});
-	const runtimeFile = path.join(RuntimeStateService.getDefaultRuntimeDir(), `${serverId}.runtime.json`);
-	try {
-		await Promise.race([waitForFile(runtimeFile, timeoutMs), childExit]);
-		const { host, port } = await Promise.race([waitForHealthyRuntime(serverId, timeoutMs), childExit]);
-		process.stdout.write(`mcp-proxy HTTP runtime ready at http://${host}:${port} (${serverId})\n`);
-		process.stdout.write(`runtimeId=${serverId}\n`);
-		process.stdout.write(`runtimeUrl=http://${host}:${port}\n`);
-		process.stdout.write(`workspaceRoot=${workspaceRoot}\n`);
-	} catch (error) {
-		throw new Error(`Failed to prestart HTTP runtime '${serverId}': ${error instanceof Error ? error.message : String(error)}`);
-	}
-});
-
 //#endregion
 //#region src/commands/bootstrap.ts
 function toErrorMessage$8(error) {

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_src = require('./src-G1hs2GLZ.cjs');
+const require_src = require('./src-B2m53VQ1.cjs');
 
 exports.ConfigFetcherService = require_src.ConfigFetcherService;
 exports.DefinitionsCacheService = require_src.DefinitionsCacheService;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { C as SearchListToolsTool, D as findConfigFile, E as generateServerId, S as UseToolTool, T as DefinitionsCacheService, _ as StopServerService, a as createProxyContainer, b as createProxyLogger, c as createStdioHttpTransportHandler, f as StdioHttpTransportHandler, g as SkillService, h as HttpTransportHandler, i as createHttpTransportHandler, l as createStdioTransportHandler, m as SseTransportHandler, n as createServer, p as StdioTransportHandler, r as createSessionServer, s as createSseTransportHandler, t as TRANSPORT_MODE, u as initializeSharedServices, v as RuntimeStateService, w as DescribeToolsTool, x as ConfigFetcherService, y as McpClientManagerService } from "./src-0OJqEpGA.mjs";
+import { C as SearchListToolsTool, D as findConfigFile, E as generateServerId, S as UseToolTool, T as DefinitionsCacheService, _ as StopServerService, a as createProxyContainer, b as createProxyLogger, c as createStdioHttpTransportHandler, f as StdioHttpTransportHandler, g as SkillService, h as HttpTransportHandler, i as createHttpTransportHandler, l as createStdioTransportHandler, m as SseTransportHandler, n as createServer, p as StdioTransportHandler, r as createSessionServer, s as createSseTransportHandler, t as TRANSPORT_MODE, u as initializeSharedServices, v as RuntimeStateService, w as DescribeToolsTool, x as ConfigFetcherService, y as McpClientManagerService } from "./src-DCIv5S_2.mjs";
 
 export { ConfigFetcherService, DefinitionsCacheService, DescribeToolsTool, HttpTransportHandler, McpClientManagerService, RuntimeStateService, SearchListToolsTool, SkillService, SseTransportHandler, StdioHttpTransportHandler, StdioTransportHandler, StopServerService, TRANSPORT_MODE, UseToolTool, createHttpTransportHandler, createProxyContainer, createProxyLogger, createServer, createSessionServer, createSseTransportHandler, createStdioHttpTransportHandler, createStdioTransportHandler, findConfigFile, generateServerId, initializeSharedServices };

package/dist/{src-G1hs2GLZ.cjs → src-B2m53VQ1.cjs}

@@ -4342,7 +4342,7 @@ var StdioHttpTransportHandler = class {
 
 //#endregion
 //#region package.json
-var version = "0.4.2";
+var version = "0.5.0";
 
 //#endregion
 //#region src/container/index.ts

package/dist/{src-0OJqEpGA.mjs → src-DCIv5S_2.mjs}

@@ -4313,7 +4313,7 @@ var StdioHttpTransportHandler = class {
 
 //#endregion
 //#region package.json
-var version = "0.4.2";
+var version = "0.5.0";
 
 //#endregion
 //#region src/container/index.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agimon-ai/mcp-proxy",
   "description": "MCP proxy server package",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "license": "AGPL-3.0",
   "keywords": [
     "mcp",
@@ -27,9 +27,9 @@
     "js-yaml": "^4.1.0",
     "liquidjs": "^10.21.0",
     "zod": "^3.24.1",
-    "@agimon-ai/foundation-process-registry": "0.2.3",
-    "@agimon-ai/log-sink-mcp": "0.2.7",
-    "@agimon-ai/foundation-port-registry": "0.2.7"
+    "@agimon-ai/foundation-process-registry": "0.2.4",
+    "@agimon-ai/foundation-port-registry": "0.2.8",
+    "@agimon-ai/log-sink-mcp": "0.2.8"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",