@agimon-ai/mcp-proxy 0.10.4 → 0.10.7

package/dist/cli.cjs

@@ -1,1754 +1,146 @@
 #!/usr/bin/env node
-const require_src = require("./src-DRpIyfzb.cjs");
-let node_fs = require("node:fs");
-let node_fs_promises = require("node:fs/promises");
-let js_yaml = require("js-yaml");
-js_yaml = require_src.__toESM(js_yaml);
-let node_crypto = require("node:crypto");
-let node_path = require("node:path");
-node_path = require_src.__toESM(node_path);
-let _agimon_ai_foundation_process_registry = require("@agimon-ai/foundation-process-registry");
-let node_child_process = require("node:child_process");
-let liquidjs = require("liquidjs");
-let commander = require("commander");
-let node_url = require("node:url");
-let _agimon_ai_foundation_port_registry = require("@agimon-ai/foundation-port-registry");
-//#region src/commands/http-runtime.ts
-/**
-* HTTP Runtime Helper
-*
-* Starts an mcp-proxy HTTP runtime in the background, waits until it is healthy,
-* and returns the runtime details for callers that need to reuse it.
-*/
-const WORKSPACE_MARKERS = [
-	"pnpm-workspace.yaml",
-	"nx.json",
-	".git"
-];
-const DEFAULT_HOST$1 = "localhost";
-const DEFAULT_HTTP_RUNTIME_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;
-	}
-}
-const PROCESS_REGISTRY_SERVICE_HTTP$1 = "mcp-proxy-http";
-async function findExistingRuntime(workspaceRoot) {
-	const match = (await new _agimon_ai_foundation_process_registry.ProcessRegistryService(process.env.PROCESS_REGISTRY_PATH).listProcesses({
-		repositoryPath: workspaceRoot,
-		serviceName: PROCESS_REGISTRY_SERVICE_HTTP$1
-	}))[0];
-	if (!match?.host || !match?.port) return null;
-	const metadata = match.metadata;
-	return {
-		host: match.host,
-		port: match.port,
-		serverId: metadata?.serverId ?? "unknown"
-	};
-}
-async function isRuntimeHealthy(host, port) {
-	try {
-		return (await fetch(`http://${host}:${port}/health`)).ok;
-	} catch {
-		return false;
-	}
-}
-function buildCliCandidates() {
-	const currentFile = (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
-	const currentDir = node_path.default.dirname(currentFile);
-	const distCandidates = [
-		node_path.default.resolve(currentDir, "cli.mjs"),
-		node_path.default.resolve(currentDir, "..", "dist", "cli.mjs"),
-		node_path.default.resolve(currentDir, "..", "..", "dist", "cli.mjs")
-	];
-	const srcCandidates = [node_path.default.resolve(currentDir, "..", "cli.ts"), node_path.default.resolve(currentDir, "..", "..", "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_HTTP_RUNTIME_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) => setTimeout(resolve, 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) => setTimeout(resolve, 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 stopExistingRuntime(runtimeStateService, serverId, host, port) {
-	const runtimes = await runtimeStateService.list();
-	const targetHost = host || DEFAULT_HOST$1;
-	const match = runtimes.find((r) => {
-		if (serverId && r.serverId === serverId) return true;
-		if (port !== void 0 && r.host === targetHost && r.port === port) return true;
-		return false;
-	});
-	if (!match) return;
-	const stopService = new require_src.StopServerService(runtimeStateService);
-	try {
-		await stopService.stop({
-			serverId: match.serverId,
-			force: true
-		});
-	} catch {
-		await runtimeStateService.remove(match.serverId);
-	}
-}
-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 existing = await findExistingRuntime(workspaceRoot);
-	if (existing && await isRuntimeHealthy(existing.host, existing.port)) return {
-		host: existing.host,
-		port: existing.port,
-		serverId: existing.serverId,
-		workspaceRoot,
-		reusedExistingRuntime: true
-	};
-	const targetPort = options.port ?? existing?.port;
-	await stopExistingRuntime(new require_src.RuntimeStateService(), options.id, options.host, targetPort);
-	const childEnv = {
-		...process.env,
-		...registryPath ? {
-			PORT_REGISTRY_PATH: registryPath,
-			PROCESS_REGISTRY_PATH: (0, _agimon_ai_foundation_process_registry.resolveSiblingRegistryPath)(registryPath, "processes.json")
-		} : {}
-	};
-	const child = spawnBackgroundRuntime([
-		"mcp-serve",
-		"--type",
-		"http",
-		"--id",
-		serverId,
-		"--host",
-		options.host || DEFAULT_HOST$1,
-		...targetPort !== void 0 ? ["--port", String(targetPort)] : [],
-		...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,
-			reusedExistingRuntime: false
-		};
-	} catch (error) {
-		throw new Error(`Failed to prestart HTTP runtime '${serverId}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-	}
-}
-function writePrestartHttpResult(result) {
-	process.stdout.write(`mcp-proxy HTTP runtime ready at http://${result.host}:${result.port} (${result.serverId})\n`);
-	process.stdout.write(`runtimeId=${result.serverId}\n`);
-	process.stdout.write(`runtimeUrl=http://${result.host}:${result.port}\n`);
-	process.stdout.write(`workspaceRoot=${result.workspaceRoot}\n`);
-}
-//#endregion
-//#region src/commands/bootstrap.ts
-function toErrorMessage$9(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-async function checkHealth(host, port) {
-	try {
-		return (await fetch(`http://${host}:${port}/health`, { signal: AbortSignal.timeout(3e3) })).ok;
-	} catch {
-		return false;
-	}
-}
-/**
-* Proxy mode: connect to a running HTTP server instead of downstream servers directly.
-* Auto-starts the server if not running.
-*/
-async function withProxiedContext(container, config, configFilePath, options, run) {
-	const host = config.proxy?.host ?? "localhost";
-	const port = config.proxy?.port;
-	const endpoint = `http://${host}:${port}/mcp`;
-	if (!await checkHealth(host, port)) {
-		if (!options.json) console.error("Starting HTTP proxy server in background...");
-		await prestartHttpRuntime({
-			host,
-			port,
-			config: configFilePath,
-			cache: options.useCache !== false,
-			clearDefinitionsCache: false,
-			proxyMode: "flat"
-		});
-	}
-	const clientManager = container.createClientManagerService();
-	try {
-		await clientManager.connectToServer("proxy", {
-			name: "proxy",
-			transport: "http",
-			config: { url: endpoint }
-		});
-		if (!options.json) console.error(`✓ Connected to proxy at ${endpoint}`);
-	} catch (error) {
-		throw new Error(`Failed to connect to proxy server at ${endpoint}: ${toErrorMessage$9(error)}`);
-	}
-	try {
-		return await run({
-			container,
-			configFilePath,
-			config,
-			clientManager
-		});
-	} finally {
-		await clientManager.disconnectAll();
-	}
-}
-/**
-* Direct mode: connect to all downstream MCP servers individually.
-*/
-async function withDirectContext(container, config, configFilePath, options, run) {
-	const clientManager = container.createClientManagerService();
-	await Promise.all(Object.entries(config.mcpServers).map(async ([serverName, serverConfig]) => {
-		try {
-			await clientManager.connectToServer(serverName, serverConfig);
-			if (!options.json) console.error(`✓ Connected to ${serverName}`);
-		} catch (error) {
-			if (!options.json) console.error(`✗ Failed to connect to ${serverName}: ${toErrorMessage$9(error)}`);
-		}
-	}));
-	if (clientManager.getAllClients().length === 0) throw new Error("No MCP servers connected");
-	try {
-		return await run({
-			container,
-			configFilePath,
-			config,
-			clientManager
-		});
-	} finally {
-		await clientManager.disconnectAll();
-	}
-}
-async function withConnectedCommandContext(options, run) {
-	const container = require_src.createProxyIoCContainer();
-	const configFilePath = options.config || require_src.findConfigFile();
-	if (!configFilePath) throw new Error("No config file found. Use --config or create mcp-config.yaml");
-	const config = await container.createConfigFetcherService({
-		configFilePath,
-		useCache: options.useCache
-	}).fetchConfiguration();
-	if (config.proxy?.port) return await withProxiedContext(container, config, configFilePath, options, run);
-	return await withDirectContext(container, config, configFilePath, options, run);
-}
-//#endregion
-//#region src/commands/describe-tools.ts
-/**
-* Describe Tools Command
-*
-* DESIGN PATTERNS:
-* - Command pattern with Commander for CLI argument parsing
-* - Async/await pattern for asynchronous operations
-* - Error handling pattern with try-catch and proper exit codes
-*
-* CODING STANDARDS:
-* - Use async action handlers for asynchronous operations
-* - Provide clear option descriptions and default values
-* - Handle errors gracefully with process.exit()
-* - Log progress and errors to console
-* - Use Commander's .option() and .argument() for inputs
-*
-* AVOID:
-* - Synchronous blocking operations in action handlers
-* - Missing error handling (always use try-catch)
-* - Hardcoded values (use options or environment variables)
-* - Not exiting with appropriate exit codes on errors
-*/
-function toErrorMessage$8(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-/**
-* Describe specific MCP tools
-*/
-const describeToolsCommand = new commander.Command("describe-tools").description("Describe specific MCP tools").argument("<toolNames...>", "Tool names to describe").option("-c, --config <path>", "Path to MCP server configuration file").option("-s, --server <name>", "Filter by server name").option("-j, --json", "Output as JSON", false).action(async (toolNames, options) => {
-	try {
-		await withConnectedCommandContext(options, async ({ container, config, clientManager }) => {
-			const clients = options.server ? [clientManager.getClient(options.server)].filter((client) => client !== void 0) : clientManager.getAllClients();
-			if (options.server && clients.length === 0) throw new Error(`Server "${options.server}" not found`);
-			const cwd = process.env.PROJECT_PATH || process.cwd();
-			const skillPaths = config.skills?.paths || [];
-			const skillService = skillPaths.length > 0 ? container.createSkillService(cwd, skillPaths) : void 0;
-			const foundTools = [];
-			const foundSkills = [];
-			const notFoundTools = [...toolNames];
-			const toolResults = await Promise.all(clients.map(async (client) => {
-				try {
-					return {
-						client,
-						tools: await client.listTools(),
-						error: null
-					};
-				} catch (error) {
-					return {
-						client,
-						tools: [],
-						error
-					};
-				}
-			}));
-			for (const { client, tools, error } of toolResults) {
-				if (error) {
-					if (!options.json) console.error(`Failed to list tools from ${client.serverName}:`, error);
-					continue;
-				}
-				for (const toolName of toolNames) {
-					const tool = tools.find((entry) => entry.name === toolName);
-					if (tool) {
-						foundTools.push({
-							server: client.serverName,
-							name: tool.name,
-							description: tool.description,
-							inputSchema: tool.inputSchema
-						});
-						const idx = notFoundTools.indexOf(toolName);
-						if (idx > -1) notFoundTools.splice(idx, 1);
-					}
-				}
-			}
-			if (skillService && notFoundTools.length > 0) {
-				const skillResults = await Promise.all([...notFoundTools].map(async (toolName) => {
-					const skillName = toolName.startsWith("skill__") ? toolName.slice(7) : toolName;
-					return {
-						toolName,
-						skill: await skillService.getSkill(skillName)
-					};
-				}));
-				for (const { toolName, skill } of skillResults) if (skill) {
-					foundSkills.push({
-						name: skill.name,
-						location: skill.basePath,
-						instructions: skill.content
-					});
-					const idx = notFoundTools.indexOf(toolName);
-					if (idx > -1) notFoundTools.splice(idx, 1);
-				}
-			}
-			const nextSteps = [];
-			if (foundTools.length > 0) nextSteps.push("For MCP tools: Use the use_tool function with toolName and toolArgs based on the inputSchema above.");
-			if (foundSkills.length > 0) nextSteps.push(`For skill, just follow skill's description to continue.`);
-			if (options.json) {
-				const result = {};
-				if (foundTools.length > 0) result.tools = foundTools;
-				if (foundSkills.length > 0) result.skills = foundSkills;
-				if (nextSteps.length > 0) result.nextSteps = nextSteps;
-				if (notFoundTools.length > 0) result.notFound = notFoundTools;
-				console.log(JSON.stringify(result, null, 2));
-			} else {
-				if (foundTools.length > 0) {
-					console.log("\nFound tools:\n");
-					for (const tool of foundTools) {
-						console.log(`Server: ${tool.server}`);
-						console.log(`Tool: ${tool.name}`);
-						console.log(`Description: ${tool.description || "No description"}`);
-						console.log("Input Schema:");
-						console.log(JSON.stringify(tool.inputSchema, null, 2));
-						console.log("");
-					}
-				}
-				if (foundSkills.length > 0) {
-					console.log("\nFound skills:\n");
-					for (const skill of foundSkills) {
-						console.log(`Skill: ${skill.name}`);
-						console.log(`Location: ${skill.location}`);
-						console.log(`Instructions:\n${skill.instructions}`);
-						console.log("");
-					}
-				}
-				if (nextSteps.length > 0) {
-					console.log("\nNext steps:");
-					for (const step of nextSteps) console.log(`  • ${step}`);
-					console.log("");
-				}
-				if (notFoundTools.length > 0) console.error(`\nTools/skills not found: ${notFoundTools.join(", ")}`);
-				if (foundTools.length === 0 && foundSkills.length === 0) {
-					console.error("No tools or skills found");
-					process.exit(1);
-				}
-			}
-		});
-	} catch (error) {
-		console.error(`Error executing describe-tools: ${toErrorMessage$8(error)}`);
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/commands/get-prompt.ts
-function toErrorMessage$7(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-const getPromptCommand = new commander.Command("get-prompt").description("Get a prompt by name from a connected MCP server").argument("<promptName>", "Prompt name to fetch").option("-c, --config <path>", "Path to MCP server configuration file").option("-s, --server <name>", "Server name (required if prompt exists on multiple servers)").option("-a, --args <json>", "Prompt arguments as JSON string", "{}").option("-j, --json", "Output as JSON", false).action(async (promptName, options) => {
-	try {
-		let promptArgs = {};
-		try {
-			promptArgs = JSON.parse(options.args);
-		} catch {
-			throw new Error("Invalid JSON in --args");
-		}
-		await withConnectedCommandContext(options, async ({ clientManager }) => {
-			const clients = clientManager.getAllClients();
-			if (options.server) {
-				const client = clientManager.getClient(options.server);
-				if (!client) throw new Error(`Server "${options.server}" not found`);
-				const prompt = await client.getPrompt(promptName, promptArgs);
-				if (options.json) console.log(JSON.stringify(prompt, null, 2));
-				else for (const message of prompt.messages) {
-					const content = message.content;
-					if (typeof content === "object" && content && "text" in content) console.log(content.text);
-					else console.log(JSON.stringify(message, null, 2));
-				}
-				return;
-			}
-			const matchingServers = [];
-			await Promise.all(clients.map(async (client) => {
-				try {
-					if ((await client.listPrompts()).some((prompt) => prompt.name === promptName)) matchingServers.push(client.serverName);
-				} catch (error) {
-					if (!options.json) console.error(`Failed to list prompts from ${client.serverName}: ${toErrorMessage$7(error)}`);
-				}
-			}));
-			if (matchingServers.length === 0) throw new Error(`Prompt "${promptName}" not found on any connected server`);
-			if (matchingServers.length > 1) throw new Error(`Prompt "${promptName}" found on multiple servers: ${matchingServers.join(", ")}. Use --server to disambiguate`);
-			const client = clientManager.getClient(matchingServers[0]);
-			if (!client) throw new Error(`Internal error: Server "${matchingServers[0]}" not connected`);
-			const prompt = await client.getPrompt(promptName, promptArgs);
-			if (options.json) console.log(JSON.stringify(prompt, null, 2));
-			else for (const message of prompt.messages) {
-				const content = message.content;
-				if (typeof content === "object" && content && "text" in content) console.log(content.text);
-				else console.log(JSON.stringify(message, null, 2));
-			}
-		});
-	} catch (error) {
-		console.error(`Error executing get-prompt: ${toErrorMessage$7(error)}`);
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/templates/mcp-config.json?raw
-var mcp_config_default = "{\n  \"_comment\": \"MCP Server Configuration - Use ${VAR_NAME} syntax for environment variable interpolation\",\n  \"_instructions\": \"config.instruction: Server's default instruction | instruction: User override (takes precedence)\",\n  \"mcpServers\": {\n    \"example-server\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-server/build/index.js\"],\n      \"env\": {\n        \"LOG_LEVEL\": \"info\",\n        \"_comment\": \"You can use environment variable interpolation:\",\n        \"_example_DATABASE_URL\": \"${DATABASE_URL}\",\n        \"_example_API_KEY\": \"${MY_API_KEY}\"\n      },\n      \"config\": {\n        \"instruction\": \"Use this server for...\"\n      },\n      \"_instruction_override\": \"Optional user override - takes precedence over config.instruction\"\n    }\n  }\n}\n";
-//#endregion
-//#region src/templates/mcp-config.yaml.liquid?raw
-var mcp_config_yaml_default = "# MCP Server Configuration\n# This file configures the MCP servers that mcp-proxy will connect to\n#\n# Environment Variable Interpolation:\n# Use ${VAR_NAME} syntax to reference environment variables\n# Example: ${HOME}, ${API_KEY}, ${DATABASE_URL}\n#\n# Instructions:\n# - config.instruction: Server's default instruction (from server documentation)\n# - instruction: User override (optional, takes precedence over config.instruction)\n# - config.toolBlacklist: Array of tool names to hide/block from this server\n# - config.omitToolDescription: Boolean to show only tool names without descriptions (saves tokens)\n\n# Remote Configuration Sources (OPTIONAL)\n# Fetch and merge configurations from remote URLs\n# Remote configs are merged with local configs based on merge strategy\n#\n# SECURITY: SSRF Protection is ENABLED by default\n# - Only HTTPS URLs are allowed (set security.enforceHttps: false to allow HTTP)\n# - Private IPs and localhost are blocked (set security.allowPrivateIPs: true for internal networks)\n# - Blocked ranges: 127.0.0.0/8, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 169.254.0.0/16\nremoteConfigs:\n  # Example 1: Basic remote config with default security\n  # - url: ${AGIFLOW_URL}/api/v1/mcp-configs\n  #   headers:\n  #     Authorization: Bearer ${AGIFLOW_API_KEY}\n  #   mergeStrategy: local-priority  # Options: local-priority (default), remote-priority, merge-deep\n  #\n  # Example 2: Remote config with custom security settings (for internal networks)\n  # - url: ${INTERNAL_URL}/mcp-configs\n  #   headers:\n  #     Authorization: Bearer ${INTERNAL_TOKEN}\n  #   security:\n  #     allowPrivateIPs: true   # Allow internal IPs (default: false)\n  #     enforceHttps: false     # Allow HTTP (default: true, HTTPS only)\n  #   mergeStrategy: local-priority\n  #\n  # Example 3: Remote config with additional validation (OPTIONAL)\n  # - url: ${AGIFLOW_URL}/api/v1/mcp-configs\n  #   headers:\n  #     Authorization: Bearer ${AGIFLOW_API_KEY}\n  #     X-API-Key: ${AGIFLOW_API_KEY}\n  #   security:\n  #     enforceHttps: true      # Require HTTPS (default: true)\n  #     allowPrivateIPs: false  # Block private IPs (default: false)\n  #   validation:  # OPTIONAL: Additional regex validation on top of security checks\n  #     url: ^https://.*\\.agiflow\\.io/.*  # OPTIONAL: Regex pattern to validate URL format\n  #     headers:  # OPTIONAL: Regex patterns to validate header values\n  #       Authorization: ^Bearer [A-Za-z0-9_-]+$\n  #       X-API-Key: ^[A-Za-z0-9_-]{32,}$\n  #   mergeStrategy: local-priority\n\nmcpServers:\n{%- if mcpServers %}{% for server in mcpServers %}\n  {{ server.name }}:\n    command: {{ server.command }}\n    args:{% for arg in server.args %}\n      - '{{ arg }}'{% endfor %}\n    # env:\n    #   LOG_LEVEL: info\n    #   # API_KEY: ${MY_API_KEY}\n    # config:\n    #   instruction: Use this server for...\n    #   # toolBlacklist:\n    #   #   - tool_to_block\n    #   # omitToolDescription: true\n{% endfor %}\n  # Example MCP server using SSE transport\n  # remote-server:\n  #   url: https://example.com/mcp\n  #   type: sse\n  #   headers:\n  #     Authorization: Bearer ${API_KEY}\n  #   config:\n  #     instruction: This server provides tools for...\n{% else %}\n  # Example MCP server using stdio transport\n  example-server:\n    command: node\n    args:\n      - /path/to/mcp-server/build/index.js\n    env:\n      # Environment variables for the MCP server\n      LOG_LEVEL: info\n      # You can use environment variable interpolation:\n      # DATABASE_URL: ${DATABASE_URL}\n      # API_KEY: ${MY_API_KEY}\n    config:\n      # Server's default instruction (from server documentation)\n      instruction: Use this server for...\n      # Optional: Block specific tools from being listed or executed\n      # toolBlacklist:\n      #   - dangerous_tool_name\n      #   - another_blocked_tool\n      # Optional: Omit tool descriptions to save tokens (default: false)\n      # omitToolDescription: true\n    # instruction: Optional user override - takes precedence over config.instruction\n\n  # Example MCP server using SSE transport with environment variables\n  # remote-server:\n  #   url: https://example.com/mcp\n  #   type: sse\n  #   headers:\n  #     # Use ${VAR_NAME} to interpolate environment variables\n  #     Authorization: Bearer ${API_KEY}\n  #   config:\n  #     instruction: This server provides tools for...\n  #     # Optional: Block specific tools from being listed or executed\n  #     # toolBlacklist:\n  #     #   - tool_to_block\n  #     # Optional: Omit tool descriptions to save tokens (default: false)\n  #     # omitToolDescription: true\n  #   # instruction: Optional user override\n{% endif %}\n";
-//#endregion
-//#region src/utils/output.ts
-function writeLine(message = "") {
-	console.log(message);
-}
-function writeError(message, detail) {
-	if (detail) console.error(`${message} ${detail}`);
-	else console.error(message);
-}
-const log = {
-	info: (message) => writeLine(message),
-	error: (message, detail) => writeError(message, detail)
-};
-const print = {
-	info: (message) => writeLine(message),
-	warning: (message) => writeLine(`Warning: ${message}`),
-	error: (message) => writeError(message),
-	success: (message) => writeLine(message),
-	newline: () => writeLine(),
-	header: (message) => writeLine(message),
-	item: (message) => writeLine(`- ${message}`),
-	indent: (message) => writeLine(`  ${message}`)
-};
-//#endregion
-//#region src/commands/init.ts
-/**
-* Init Command
-*
-* DESIGN PATTERNS:
-* - Command pattern with Commander for CLI argument parsing
-* - Async/await pattern for asynchronous operations
-* - Error handling pattern with try-catch and proper exit codes
-*
-* CODING STANDARDS:
-* - Use async action handlers for asynchronous operations
-* - Provide clear option descriptions and default values
-* - Handle errors gracefully with process.exit()
-* - Log progress and errors to console
-* - Use Commander's .option() and .argument() for inputs
-*
-* AVOID:
-* - Synchronous blocking operations in action handlers
-* - Missing error handling (always use try-catch)
-* - Hardcoded values (use options or environment variables)
-* - Not exiting with appropriate exit codes on errors
-*/
-/**
-* Initialize MCP configuration file
-*/
-const initCommand = new commander.Command("init").description("Initialize MCP configuration file").option("-o, --output <path>", "Output file path", "mcp-config.yaml").option("--json", "Generate JSON config instead of YAML", false).option("-f, --force", "Overwrite existing config file", false).option("--mcp-servers <json>", "JSON string of MCP servers to add to config (optional)").action(async (options) => {
-	try {
-		const outputPath = (0, node_path.resolve)(options.output);
-		const isYaml = !options.json && (outputPath.endsWith(".yaml") || outputPath.endsWith(".yml"));
-		let content;
-		if (isYaml) {
-			const liquid = new liquidjs.Liquid();
-			let mcpServersData = null;
-			if (options.mcpServers) try {
-				const serversObj = JSON.parse(options.mcpServers);
-				mcpServersData = Object.entries(serversObj).map(([name, config]) => ({
-					name,
-					command: config.command,
-					args: config.args
-				}));
-			} catch (parseError) {
-				log.error("Failed to parse --mcp-servers JSON:", parseError instanceof Error ? parseError.message : String(parseError));
-				process.exit(1);
-			}
-			content = await liquid.parseAndRender(mcp_config_yaml_default, { mcpServers: mcpServersData });
-		} else content = mcp_config_default;
-		try {
-			await (0, node_fs_promises.writeFile)(outputPath, content, {
-				encoding: "utf-8",
-				flag: options.force ? "w" : "wx"
-			});
-		} catch (error) {
-			if (error && typeof error === "object" && "code" in error && error.code === "EEXIST") {
-				log.error(`Config file already exists: ${outputPath}`);
-				log.info("Use --force to overwrite");
-				process.exit(1);
-			}
-			throw error;
-		}
-		log.info(`MCP configuration file created: ${outputPath}`);
-		log.info("Next steps:");
-		log.info("1. Edit the configuration file to add your MCP servers");
-		log.info(`2. Run: mcp-proxy mcp-serve --config ${outputPath}`);
-	} catch (error) {
-		log.error("Error executing init:", error instanceof Error ? error.message : String(error));
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/commands/list-prompts.ts
-function toErrorMessage$6(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-const listPromptsCommand = new commander.Command("list-prompts").description("List all available prompts from connected MCP servers").option("-c, --config <path>", "Path to MCP server configuration file").option("-s, --server <name>", "Filter by server name").option("-j, --json", "Output as JSON", false).action(async (options) => {
-	try {
-		await withConnectedCommandContext(options, async ({ clientManager }) => {
-			const clients = options.server ? [clientManager.getClient(options.server)].filter((client) => client !== void 0) : clientManager.getAllClients();
-			if (options.server && clients.length === 0) throw new Error(`Server "${options.server}" not found`);
-			const promptsByServer = {};
-			await Promise.all(clients.map(async (client) => {
-				try {
-					promptsByServer[client.serverName] = await client.listPrompts();
-				} catch (error) {
-					promptsByServer[client.serverName] = [];
-					if (!options.json) console.error(`Failed to list prompts from ${client.serverName}: ${toErrorMessage$6(error)}`);
-				}
-			}));
-			if (options.json) console.log(JSON.stringify(promptsByServer, null, 2));
-			else for (const [serverName, prompts] of Object.entries(promptsByServer)) {
-				console.log(`\n${serverName}:`);
-				if (prompts.length === 0) {
-					console.log("  No prompts available");
-					continue;
-				}
-				for (const prompt of prompts) {
-					console.log(`  - ${prompt.name}: ${prompt.description || "No description"}`);
-					if (prompt.arguments && prompt.arguments.length > 0) {
-						const args = prompt.arguments.map((arg) => `${arg.name}${arg.required ? " (required)" : ""}`).join(", ");
-						console.log(`    args: ${args}`);
-					}
-				}
-			}
-		});
-	} catch (error) {
-		console.error(`Error executing list-prompts: ${toErrorMessage$6(error)}`);
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/commands/list-resources.ts
-/**
-* ListResources Command
-*
-* DESIGN PATTERNS:
-* - Command pattern with Commander for CLI argument parsing
-* - Async/await pattern for asynchronous operations
-* - Error handling pattern with try-catch and proper exit codes
-*
-* CODING STANDARDS:
-* - Use async action handlers for asynchronous operations
-* - Provide clear option descriptions and default values
-* - Handle errors gracefully with process.exit()
-* - Log progress and errors to console
-* - Use Commander's .option() and .argument() for inputs
-*
-* AVOID:
-* - Synchronous blocking operations in action handlers
-* - Missing error handling (always use try-catch)
-* - Hardcoded values (use options or environment variables)
-* - Not exiting with appropriate exit codes on errors
-*/
-function toErrorMessage$5(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-/**
-* List all available resources from connected MCP servers
-*/
-const listResourcesCommand = new commander.Command("list-resources").description("List all available resources from connected MCP servers").option("-c, --config <path>", "Path to MCP server configuration file").option("-s, --server <name>", "Filter by server name").option("-j, --json", "Output as JSON", false).action(async (options) => {
-	try {
-		await withConnectedCommandContext(options, async ({ clientManager }) => {
-			const clients = options.server ? [clientManager.getClient(options.server)].filter((c) => c !== void 0) : clientManager.getAllClients();
-			if (options.server && clients.length === 0) throw new Error(`Server "${options.server}" not found`);
-			const resourcesByServer = {};
-			const resourceResults = await Promise.all(clients.map(async (client) => {
-				try {
-					const resources = await client.listResources();
-					return {
-						serverName: client.serverName,
-						resources,
-						error: null
-					};
-				} catch (error) {
-					return {
-						serverName: client.serverName,
-						resources: [],
-						error
-					};
-				}
-			}));
-			for (const { serverName, resources, error } of resourceResults) {
-				if (error && !options.json) console.error(`Failed to list resources from ${serverName}: ${toErrorMessage$5(error)}`);
-				resourcesByServer[serverName] = resources;
-			}
-			if (options.json) console.log(JSON.stringify(resourcesByServer, null, 2));
-			else for (const [serverName, resources] of Object.entries(resourcesByServer)) {
-				console.log(`\n${serverName}:`);
-				if (resources.length === 0) console.log("  No resources available");
-				else for (const resource of resources) {
-					const label = resource.name ? `${resource.name} (${resource.uri})` : resource.uri;
-					console.log(`  - ${label}${resource.description ? `: ${resource.description}` : ""}`);
-				}
-			}
-		});
-	} catch (error) {
-		console.error(`Error executing list-resources: ${toErrorMessage$5(error)}`);
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/commands/list-tools.ts
-/**
-* List Tools Command
-*
-* DESIGN PATTERNS:
-* - Command pattern with Commander for CLI argument parsing
-* - Async/await pattern for asynchronous operations
-* - Error handling pattern with try-catch and proper exit codes
-*
-* CODING STANDARDS:
-* - Use async action handlers for asynchronous operations
-* - Provide clear option descriptions and default values
-* - Handle errors gracefully with process.exit()
-* - Log progress and errors to console
-* - Use Commander's .option() and .argument() for inputs
-*
-* AVOID:
-* - Synchronous blocking operations in action handlers
-* - Missing error handling (always use try-catch)
-* - Hardcoded values (use options or environment variables)
-* - Not exiting with appropriate exit codes on errors
-*/
-function toErrorMessage$4(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-function printSearchResults(result) {
-	for (const server of result.servers) {
-		console.log(`\n${server.server}:`);
-		if (server.capabilities && server.capabilities.length > 0) console.log(`  capabilities: ${server.capabilities.join(", ")}`);
-		if (server.summary) console.log(`  summary: ${server.summary}`);
-		if (server.tools.length === 0) {
-			console.log("  no tools");
-			continue;
-		}
-		for (const tool of server.tools) {
-			const capabilitySummary = tool.capabilities && tool.capabilities.length > 0 ? ` [${tool.capabilities.join(", ")}]` : "";
-			console.log(`  - ${tool.name}${capabilitySummary}`);
-			if (tool.description) console.log(`    ${tool.description}`);
-		}
-	}
-}
-const searchToolsCommand = new commander.Command("search-tools").description("Search proxied MCP tools by capability or server").option("-c, --config <path>", "Path to MCP server configuration file").option("-s, --server <name>", "Filter by server name").option("--capability <name>", "Filter by capability tag, summary, tool name, or description").option("--definitions-cache <path>", "Path to definitions cache file").option("-j, --json", "Output as JSON", false).action(async (options) => {
-	try {
-		await withConnectedCommandContext(options, async ({ container, config, clientManager, configFilePath }) => {
-			clientManager.registerServerConfigs(config.mcpServers);
-			const cachePath = options.definitionsCache || require_src.DefinitionsCacheService.getDefaultCachePath(configFilePath);
-			let cacheData;
-			try {
-				cacheData = await require_src.DefinitionsCacheService.readFromFile(cachePath);
-			} catch {
-				cacheData = void 0;
-			}
-			const definitionsCacheService = container.createDefinitionsCacheService(clientManager, void 0, { cacheData });
-			const textBlock = (await container.createSearchListToolsTool(clientManager, definitionsCacheService).execute({
-				capability: options.capability,
-				serverName: options.server
-			})).content.find((content) => content.type === "text");
-			const parsed = textBlock?.type === "text" ? JSON.parse(textBlock.text) : { servers: [] };
-			if (options.json) console.log(JSON.stringify(parsed, null, 2));
-			else {
-				if (!parsed.servers || parsed.servers.length === 0) throw new Error("No tools matched the requested filters");
-				printSearchResults(parsed);
-			}
-		});
-	} catch (error) {
-		console.error(`Error executing search-tools: ${toErrorMessage$4(error)}`);
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/commands/mcp-serve.ts
-/**
-* MCP Serve Command
-*
-* DESIGN PATTERNS:
-* - Command pattern with Commander for CLI argument parsing
-* - Transport abstraction pattern for flexible deployment (stdio, HTTP, SSE)
-* - Factory pattern for creating transport handlers
-* - Graceful shutdown pattern with signal handling
-*
-* CODING STANDARDS:
-* - Use async/await for asynchronous operations
-* - Implement proper error handling with try-catch blocks
-* - Handle process signals for graceful shutdown
-* - Provide clear CLI options and help messages
-*
-* AVOID:
-* - Hardcoded configuration values (use CLI options or environment variables)
-* - Missing error handling for transport startup
-* - Not cleaning up resources on shutdown
-*/
-const CONFIG_FILE_NAMES = [
-	"mcp-config.yaml",
-	"mcp-config.yml",
-	"mcp-config.json"
-];
-const MCP_ENDPOINT_PATH = "/mcp";
-const DEFAULT_HOST = "localhost";
-const TRANSPORT_TYPE_STDIO = "stdio";
-const TRANSPORT_TYPE_HTTP = "http";
-const TRANSPORT_TYPE_SSE = "sse";
-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";
-function getWorkspaceRoot() {
-	return resolveWorkspaceRoot();
-}
-const PROCESS_REGISTRY_SERVICE_HTTP = "mcp-proxy-http";
-const PROCESS_REGISTRY_SERVICE_TYPE = "service";
-function getRegistryRepositoryPath() {
-	return getWorkspaceRoot();
-}
-function toErrorMessage$3(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-function isValidTransportType(type) {
-	return type === TRANSPORT_TYPE_STDIO || type === TRANSPORT_TYPE_HTTP || type === TRANSPORT_TYPE_SSE || type === TRANSPORT_TYPE_STDIO_HTTP;
-}
-function isValidProxyMode(mode) {
-	return mode === "meta" || mode === "flat" || mode === "search";
-}
-async function pathExists(filePath) {
-	try {
-		await (0, node_fs_promises.access)(filePath, node_fs.constants.F_OK);
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function findConfigFileAsync() {
-	try {
-		const projectPath = process.env.PROJECT_PATH;
-		if (projectPath) for (const fileName of CONFIG_FILE_NAMES) {
-			const configPath = (0, node_path.resolve)(projectPath, fileName);
-			if (await pathExists(configPath)) return configPath;
-		}
-		const MAX_PARENT_LEVELS = 3;
-		let searchDir = process.cwd();
-		for (let level = 0; level <= MAX_PARENT_LEVELS; level++) {
-			for (const fileName of CONFIG_FILE_NAMES) {
-				const configPath = (0, node_path.join)(searchDir, fileName);
-				if (await pathExists(configPath)) return configPath;
-			}
-			const parentDir = (0, node_path.dirname)(searchDir);
-			if (parentDir === searchDir) break;
-			searchDir = parentDir;
-		}
-		return null;
-	} catch (error) {
-		throw new Error(`Failed to discover MCP config file: ${toErrorMessage$3(error)}`);
-	}
-}
-function loadProxyDefaults(configPath) {
-	try {
-		const content = (0, node_fs.readFileSync)(configPath, "utf-8");
-		const proxy = (configPath.endsWith(".yaml") || configPath.endsWith(".yml") ? js_yaml.default.load(content) : JSON.parse(content))?.proxy;
-		if (!proxy || typeof proxy !== "object") return {};
-		const p = proxy;
-		return {
-			type: typeof p.type === "string" ? p.type : void 0,
-			port: typeof p.port === "number" && Number.isInteger(p.port) && p.port > 0 ? p.port : void 0,
-			host: typeof p.host === "string" ? p.host : void 0,
-			keepAlive: typeof p.keepAlive === "boolean" ? p.keepAlive : void 0
-		};
-	} catch {
-		return {};
-	}
-}
-async function resolveServerId(options, resolvedConfigPath) {
-	const container = require_src.createProxyIoCContainer();
-	if (options.id) return options.id;
-	if (resolvedConfigPath) try {
-		const config = await container.createConfigFetcherService({
-			configFilePath: resolvedConfigPath,
-			useCache: options.cache !== false
-		}).fetchConfiguration(options.cache === false);
-		if (config.id) return config.id;
-	} catch (error) {
-		throw new Error(`Failed to resolve server ID from config '${resolvedConfigPath}': ${toErrorMessage$3(error)}`);
-	}
-	return require_src.generateServerId();
-}
-function validateTransportType(type) {
-	if (!isValidTransportType(type)) throw new Error(`Unknown transport type: '${type}'. Valid options: ${TRANSPORT_TYPE_STDIO}, ${TRANSPORT_TYPE_HTTP}, ${TRANSPORT_TYPE_SSE}, ${TRANSPORT_TYPE_STDIO_HTTP}`);
-	return type;
-}
-function validateProxyMode(mode) {
-	if (!isValidProxyMode(mode)) throw new Error(`Unknown proxy mode: '${mode}'. Valid options: meta, flat, search`);
-}
-function createTransportConfig(options, mode, proxyDefaults) {
-	const envPort = process.env.MCP_PORT ? Number(process.env.MCP_PORT) : void 0;
-	return {
-		mode,
-		port: options.port ?? (Number.isFinite(envPort) ? envPort : void 0) ?? proxyDefaults?.port,
-		host: options.host ?? process.env.MCP_HOST ?? proxyDefaults?.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) {
-	return {
-		configFilePath: resolvedConfigPath,
-		noCache: options.cache === false,
-		serverId,
-		definitionsCachePath: options.definitionsCache,
-		clearDefinitionsCache: options.clearDefinitionsCache,
-		proxyMode: options.proxyMode
-	};
-}
-function formatStartError(type, host, port, error) {
-	const startErrorMessage = toErrorMessage$3(error);
-	if (type === TRANSPORT_TYPE_STDIO) return `Failed to start MCP server with transport '${type}': ${startErrorMessage}`;
-	return `Failed to start MCP server with transport '${type}' on ${port === void 0 ? `${host} (dynamic port)` : `${host}:${port}`}: ${startErrorMessage}`;
-}
-function createRuntimeRecord(serverId, config, port, shutdownToken, configPath) {
-	return {
-		serverId,
-		host: config.host ?? DEFAULT_HOST,
-		port,
-		transport: RUNTIME_TRANSPORT,
-		shutdownToken,
-		startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-		pid: process.pid,
-		configPath
-	};
-}
-function createPortRegistryService() {
-	return new _agimon_ai_foundation_port_registry.PortRegistryService(process.env.PORT_REGISTRY_PATH);
-}
-function getRegistryEnvironment() {
-	return process.env.NODE_ENV ?? "development";
-}
-async function createPortRegistryLease(serviceName, host, preferredPort, serverId, transport, configPath, portRange = preferredPort !== void 0 ? {
-	min: preferredPort,
-	max: preferredPort
-} : _agimon_ai_foundation_port_registry.DEFAULT_PORT_RANGE) {
-	const portRegistry = createPortRegistryService();
-	const result = await portRegistry.reservePort({
-		repositoryPath: getRegistryRepositoryPath(),
-		serviceName,
-		serviceType: PORT_REGISTRY_SERVICE_TYPE,
-		environment: getRegistryEnvironment(),
-		pid: process.pid,
-		host,
-		preferredPort,
-		portRange,
-		force: true,
-		metadata: {
-			transport,
-			serverId,
-			...configPath ? { configPath } : {}
-		}
-	});
-	if (!result.success || !result.record) {
-		const requestedPortLabel = preferredPort === void 0 ? "dynamic port" : `port ${preferredPort}`;
-		throw new Error(result.error || `Failed to reserve ${requestedPortLabel} in port registry`);
-	}
-	let released = false;
-	return {
-		port: result.record.port,
-		release: async () => {
-			if (released) return;
-			released = true;
-			const releaseResult = await portRegistry.releasePort({
-				repositoryPath: getRegistryRepositoryPath(),
-				serviceName,
-				serviceType: PORT_REGISTRY_SERVICE_TYPE,
-				pid: process.pid,
-				environment: getRegistryEnvironment(),
-				force: true
-			});
-			if (!releaseResult.success && releaseResult.error && !releaseResult.error.includes("No matching registry entry")) throw new Error(releaseResult.error || `Failed to release port for ${serviceName}`);
-		}
-	};
-}
-async function releasePortLease(lease) {
-	if (!lease) return;
-	await lease.release();
-}
-function createHttpAdminOptions(serverId, shutdownToken, onShutdownRequested) {
-	return {
-		serverId,
-		shutdownToken,
-		onShutdownRequested
-	};
-}
-async function removeRuntimeRecord(runtimeStateService, serverId) {
-	try {
-		await runtimeStateService.remove(serverId);
-	} catch (error) {
-		throw new Error(`Failed to remove runtime state for '${serverId}': ${toErrorMessage$3(error)}`);
-	}
-}
-async function writeRuntimeRecord(runtimeStateService, record) {
-	try {
-		await runtimeStateService.write(record);
-	} catch (error) {
-		throw new Error(`Failed to persist runtime state for '${record.serverId}': ${toErrorMessage$3(error)}`);
-	}
-}
-async function stopOwnedHttpTransport(handler, runtimeStateService, serverId, processLease) {
-	try {
-		try {
-			await handler.stop();
-		} catch (error) {
-			throw new Error(`Failed to stop owned HTTP transport '${serverId}': ${toErrorMessage$3(error)}`);
-		}
-	} finally {
-		await processLease?.release({ kill: false });
-		await removeRuntimeRecord(runtimeStateService, serverId);
-	}
-}
-/**
-* Run post-stop cleanup for an HTTP runtime (release port, dispose services, remove state).
-* This is the subset of stopOwnedHttpTransport that runs AFTER handler.stop() has already
-* been called by startServer()'s signal handler — avoids double-stopping the transport.
-*/
-async function cleanupHttpRuntime(runtimeStateService, serverId, processLease) {
-	await processLease?.release({ kill: false });
-	await removeRuntimeRecord(runtimeStateService, serverId);
-}
-async function cleanupFailedRuntimeStartup(handler, runtimeStateService, serverId, processLease) {
-	try {
-		try {
-			await handler.stop();
-		} catch (error) {
-			throw new Error(`Failed to stop HTTP transport during cleanup for '${serverId}': ${toErrorMessage$3(error)}`);
-		}
-	} finally {
-		await processLease?.release({ kill: false });
-		await removeRuntimeRecord(runtimeStateService, serverId);
-	}
-}
-/**
-* Start MCP server with given transport handler
-* @param handler - The transport handler to start
-* @param onStopped - Optional cleanup callback run after signal-based shutdown
-*/
-async function startServer(handler, onStopped) {
-	try {
-		await handler.start();
-	} catch (error) {
-		throw new Error(`Failed to start transport handler: ${toErrorMessage$3(error)}`);
-	}
-	const shutdown = async (signal) => {
-		console.error(`\nReceived ${signal}, shutting down gracefully...`);
-		try {
-			await handler.stop();
-			if (onStopped) await onStopped();
-			process.exit(0);
-		} catch (error) {
-			console.error(`Failed to gracefully stop transport during ${signal}: ${toErrorMessage$3(error)}`);
-			process.exit(1);
-		}
-	};
-	process.on("SIGINT", async () => await shutdown("SIGINT"));
-	process.on("SIGTERM", async () => await shutdown("SIGTERM"));
-}
-async function createAndStartHttpRuntime(serverOptions, config, resolvedConfigPath) {
-	const sharedServices = await require_src.initializeSharedServices(serverOptions);
-	const runtimeStateService = new require_src.RuntimeStateService();
-	const shutdownToken = (0, node_crypto.randomUUID)();
-	const runtimeServerId = serverOptions.serverId ?? require_src.generateServerId();
-	const requestedPort = config.port;
-	const portRange = requestedPort !== void 0 ? {
-		min: requestedPort,
-		max: requestedPort
-	} : _agimon_ai_foundation_port_registry.DEFAULT_PORT_RANGE;
-	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 (0, _agimon_ai_foundation_process_registry.createProcessLease)({
-		repositoryPath: getRegistryRepositoryPath(),
-		serviceName: PROCESS_REGISTRY_SERVICE_HTTP,
-		serviceType: PROCESS_REGISTRY_SERVICE_TYPE,
-		environment: getRegistryEnvironment(),
-		host: runtimeConfig.host ?? DEFAULT_HOST,
-		port: runtimePort,
-		command: process.argv[1],
-		args: process.argv.slice(2),
-		metadata: {
-			transport: TRANSPORT_TYPE_HTTP,
-			serverId: runtimeServerId,
-			...resolvedConfigPath ? { configPath: resolvedConfigPath } : {}
-		}
-	});
-	let releasePort = async () => {
-		await releasePortLease(portLease ?? null);
-		releasePort = async () => void 0;
-	};
-	const runtimeRecord = createRuntimeRecord(runtimeServerId, runtimeConfig, runtimePort, shutdownToken, resolvedConfigPath);
-	let handler;
-	let isStopping = false;
-	const stopHandler = async () => {
-		if (isStopping) return;
-		isStopping = true;
-		try {
-			await stopOwnedHttpTransport(handler, runtimeStateService, runtimeRecord.serverId, processLease);
-			await releasePort();
-			await sharedServices.dispose();
-			process.exit(0);
-		} catch (error) {
-			throw new Error(`Failed to stop HTTP runtime '${runtimeRecord.serverId}' from admin shutdown: ${toErrorMessage$3(error)}`);
-		}
-	};
-	try {
-		handler = new require_src.HttpTransportHandler(() => require_src.createSessionServer(sharedServices), runtimeConfig, createHttpAdminOptions(runtimeRecord.serverId, shutdownToken, stopHandler));
-	} catch (error) {
-		await releasePort();
-		await processLease.release({ kill: false });
-		await sharedServices.dispose();
-		throw new Error(`Failed to create HTTP runtime server: ${toErrorMessage$3(error)}`);
-	}
-	try {
-		await startServer(handler, async () => {
-			await releasePort();
-			await sharedServices.dispose();
-			await cleanupHttpRuntime(runtimeStateService, runtimeRecord.serverId, processLease);
-		});
-		await writeRuntimeRecord(runtimeStateService, runtimeRecord);
-	} catch (error) {
-		await releasePort();
-		await sharedServices.dispose();
-		await cleanupFailedRuntimeStartup(handler, runtimeStateService, runtimeRecord.serverId, processLease);
-		throw new Error(`Failed to start HTTP runtime '${runtimeRecord.serverId}': ${toErrorMessage$3(error)}`);
-	}
-	console.error(`Runtime state: http://${runtimeRecord.host}:${runtimeRecord.port} (${runtimeRecord.serverId})`);
-}
-async function startStdioTransport(serverOptions) {
-	let server;
-	try {
-		server = await require_src.createServer(serverOptions);
-		await startServer(new require_src.StdioTransportHandler(server, createStdioSafeLogger()), async () => {
-			await server?.dispose?.();
-		});
-	} catch (error) {
-		await server?.dispose?.();
-		throw new Error(`Failed to start stdio transport: ${toErrorMessage$3(error)}`);
-	}
-}
-async function startSseTransport(serverOptions, config) {
-	try {
-		const requestedPort = config.port;
-		const portRange = requestedPort !== void 0 ? {
-			min: requestedPort,
-			max: requestedPort
-		} : _agimon_ai_foundation_port_registry.DEFAULT_PORT_RANGE;
-		const portLease = await createPortRegistryLease("mcp-proxy-sse", config.host ?? DEFAULT_HOST, requestedPort, serverOptions.serverId ?? require_src.generateServerId(), TRANSPORT_TYPE_SSE, void 0, portRange);
-		const resolvedConfig = {
-			...config,
-			port: portLease.port
-		};
-		const handler = new require_src.SseTransportHandler(await require_src.createServer(serverOptions), resolvedConfig);
-		const shutdown = async () => {
-			await handler.stop();
-			await portLease.release();
-		};
-		process.on("SIGINT", shutdown);
-		process.on("SIGTERM", shutdown);
-		await startServer(handler);
-	} catch (error) {
-		throw new Error(`Failed to start SSE transport: ${toErrorMessage$3(error)}`);
-	}
-}
-async function resolveStdioHttpEndpoint(config, options, resolvedConfigPath) {
-	const repositoryPath = getRegistryRepositoryPath();
-	if (config.port !== void 0) return { endpoint: new URL(`http://${config.host ?? DEFAULT_HOST}:${config.port}${MCP_ENDPOINT_PATH}`) };
-	const portRegistry = createPortRegistryService();
-	const result = await portRegistry.getPort({
-		repositoryPath,
-		serviceName: PORT_REGISTRY_SERVICE_HTTP,
-		serviceType: PORT_REGISTRY_SERVICE_TYPE,
-		environment: getRegistryEnvironment()
-	});
-	if (result.success && result.record) {
-		const host = config.host ?? result.record.host;
-		const endpoint = new URL(`http://${host}:${result.record.port}${MCP_ENDPOINT_PATH}`);
-		try {
-			const healthUrl = `http://${host}:${result.record.port}/health`;
-			if ((await fetch(healthUrl)).ok) return { endpoint };
-		} catch {}
-		await portRegistry.releasePort({
-			repositoryPath,
-			serviceName: PORT_REGISTRY_SERVICE_HTTP,
-			serviceType: PORT_REGISTRY_SERVICE_TYPE,
-			environment: getRegistryEnvironment(),
-			force: true
-		});
-	}
-	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 {
-		endpoint: new URL(`http://${runtime.host}:${runtime.port}${MCP_ENDPOINT_PATH}`),
-		ownedRuntimeServerId: runtime.reusedExistingRuntime ? void 0 : runtime.serverId
-	};
-}
-async function rediscoverStdioHttpEndpoint(config, options, resolvedConfigPath) {
-	const { endpoint } = await resolveStdioHttpEndpoint(config, options, resolvedConfigPath);
-	return endpoint;
-}
-async function startStdioHttpTransport(config, options, resolvedConfigPath, proxyDefaults) {
-	let ownedRuntimeServerId;
-	const keepAlive = proxyDefaults?.keepAlive ?? false;
-	try {
-		const resolvedEndpoint = await resolveStdioHttpEndpoint(config, options, resolvedConfigPath);
-		ownedRuntimeServerId = resolvedEndpoint.ownedRuntimeServerId;
-		const { endpoint } = resolvedEndpoint;
-		await startServer(new require_src.StdioHttpTransportHandler({
-			endpoint,
-			resolveEndpoint: async () => await rediscoverStdioHttpEndpoint(config, options, resolvedConfigPath)
-		}, createStdioSafeLogger()), async () => {
-			if (keepAlive || !ownedRuntimeServerId) return;
-			await new require_src.StopServerService().stop({
-				serverId: ownedRuntimeServerId,
-				force: true
-			});
-		});
-	} catch (error) {
-		if (!keepAlive && ownedRuntimeServerId) {
-			const stopServerService = new require_src.StopServerService();
-			try {
-				await stopServerService.stop({
-					serverId: ownedRuntimeServerId,
-					force: true
-				});
-			} catch (cleanupError) {
-				throw new Error(`Failed to start stdio-http transport: ${toErrorMessage$3(error)}; also failed to stop owned HTTP runtime '${ownedRuntimeServerId}': ${toErrorMessage$3(cleanupError)}`);
-			}
-		}
-		throw new Error(`Failed to start stdio-http transport: ${toErrorMessage$3(error)}`);
-	}
-}
-async function startTransport(transportType, options, resolvedConfigPath, serverOptions, proxyDefaults) {
-	try {
-		if (transportType === TRANSPORT_TYPE_STDIO) {
-			await startStdioTransport(serverOptions);
-			return;
-		}
-		if (transportType === TRANSPORT_TYPE_HTTP) {
-			await createAndStartHttpRuntime(serverOptions, createTransportConfig(options, require_src.TRANSPORT_MODE.HTTP, proxyDefaults), resolvedConfigPath);
-			return;
-		}
-		if (transportType === TRANSPORT_TYPE_SSE) {
-			await startSseTransport(serverOptions, createTransportConfig(options, require_src.TRANSPORT_MODE.SSE, proxyDefaults));
-			return;
-		}
-		await startStdioHttpTransport(createTransportConfig(options, require_src.TRANSPORT_MODE.HTTP, proxyDefaults), options, resolvedConfigPath, proxyDefaults);
-	} catch (error) {
-		throw new Error(`Failed to start transport '${transportType}': ${toErrorMessage$3(error)}`);
-	}
-}
-async function prestartHttpRuntimeCommand(options, resolvedConfigPath) {
-	try {
-		writePrestartHttpResult(await prestartHttpRuntime({
-			id: options.id,
-			host: options.host ?? DEFAULT_HOST,
-			port: options.port,
-			config: options.config || resolvedConfigPath,
-			cache: options.cache,
-			definitionsCache: options.definitionsCache,
-			clearDefinitionsCache: options.clearDefinitionsCache,
-			proxyMode: options.proxyMode,
-			timeoutMs: options.timeoutMs
-		}));
-	} catch (error) {
-		console.error(`Failed to prestart HTTP runtime '${options.id || "generated-server-id"}': ${toErrorMessage$3(error)}`);
-		process.exit(1);
-	}
-}
-/**
-* MCP Serve command
-*/
-const mcpServeCommand = new commander.Command("mcp-serve").description("Start MCP server with specified transport or prestart the HTTP runtime in the background").option("-t, --type <type>", `Transport type: ${TRANSPORT_TYPE_STDIO}, ${TRANSPORT_TYPE_HTTP}, ${TRANSPORT_TYPE_SSE}, or ${TRANSPORT_TYPE_STDIO_HTTP}`).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").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)").option("--prestart-http", "Prestart the HTTP runtime in the background and exit after it becomes healthy", false).option("--timeout-ms <ms>", "How long to wait for the HTTP runtime to become healthy", String(DEFAULT_HTTP_RUNTIME_TIMEOUT_MS)).action(async (options) => {
-	try {
-		if (options.prestartHttp) {
-			await prestartHttpRuntimeCommand(options, options.config || await findConfigFileAsync() || void 0);
-			return;
-		}
-		const resolvedConfigPath = options.config || await findConfigFileAsync() || void 0;
-		const proxyDefaults = resolvedConfigPath ? loadProxyDefaults(resolvedConfigPath) : {};
-		const transportType = validateTransportType((options.type ?? proxyDefaults.type ?? TRANSPORT_TYPE_STDIO).toLowerCase());
-		validateProxyMode(options.proxyMode);
-		await startTransport(transportType, options, resolvedConfigPath, createServerOptions(options, resolvedConfigPath, await resolveServerId(options, resolvedConfigPath)), proxyDefaults);
-	} catch (error) {
-		const rawTransportType = (options.type ?? TRANSPORT_TYPE_STDIO).toLowerCase();
-		const transportType = isValidTransportType(rawTransportType) ? rawTransportType : TRANSPORT_TYPE_STDIO;
-		const envPort = process.env.MCP_PORT ? Number(process.env.MCP_PORT) : void 0;
-		const requestedPort = options.port ?? (Number.isFinite(envPort) ? envPort : void 0);
-		console.error(formatStartError(transportType, options.host ?? DEFAULT_HOST, requestedPort, error));
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/commands/prefetch.ts
-/**
-* Prefetch Command
-*
-* DESIGN PATTERNS:
-* - Command pattern with Commander for CLI argument parsing
-* - Async/await pattern for asynchronous operations
-* - Error handling pattern with try-catch and proper exit codes
-*
-* CODING STANDARDS:
-* - Use async action handlers for asynchronous operations
-* - Provide clear option descriptions and default values
-* - Handle errors gracefully with process.exit()
-* - Log progress and errors to console
-* - Use Commander's .option() and .argument() for inputs
-*
-* AVOID:
-* - Synchronous blocking operations in action handlers
-* - Missing error handling (always use try-catch)
-* - Hardcoded values (use options or environment variables)
-* - Not exiting with appropriate exit codes on errors
-*/
-/**
-* Pre-download packages used by MCP servers (npx, pnpx, uvx, uv)
-*/
-const prefetchCommand = new commander.Command("prefetch").description("Pre-download packages used by MCP servers (npx, pnpx, uvx, uv)").option("-c, --config <path>", "Path to MCP server configuration file").option("-p, --parallel", "Run prefetch commands in parallel", false).option("-d, --dry-run", "Show what would be prefetched without executing", false).option("-f, --filter <type>", "Filter by package manager type: npx, pnpx, uvx, or uv").option("--definitions-out <path>", "Write discovered definitions to a JSON or YAML cache file").option("--skip-packages", "Skip package prefetch and only build definitions cache", false).option("--clear-definitions-cache", "Delete the definitions cache file before continuing", false).action(async (options) => {
-	try {
-		const container = require_src.createProxyIoCContainer();
-		const configFilePath = options.config || require_src.findConfigFile();
-		if (!configFilePath) {
-			print.error("No MCP configuration file found.");
-			print.info("Use --config <path> to specify a config file, or run \"mcp-proxy init\" to create one.");
-			process.exit(1);
-		}
-		print.info(`Loading configuration from: ${configFilePath}`);
-		const mcpConfig = await container.createConfigFetcherService({
-			configFilePath,
-			useCache: false
-		}).fetchConfiguration(true);
-		const serverId = mcpConfig.id || require_src.generateServerId();
-		const configHash = require_src.DefinitionsCacheService.generateConfigHash(mcpConfig);
-		const effectiveDefinitionsPath = options.definitionsOut || require_src.DefinitionsCacheService.getDefaultCachePath(configFilePath);
-		const prefetchService = container.createPrefetchService({
-			mcpConfig,
-			filter: options.filter,
-			parallel: options.parallel
-		});
-		const packages = prefetchService.extractPackages();
-		const shouldPrefetchPackages = !options.skipPackages;
-		const shouldWriteDefinitions = Boolean(options.definitionsOut);
-		if (options.clearDefinitionsCache) if (options.dryRun) print.info(`Would clear definitions cache: ${effectiveDefinitionsPath}`);
-		else {
-			await require_src.DefinitionsCacheService.clearFile(effectiveDefinitionsPath);
-			print.success(`Cleared definitions cache: ${effectiveDefinitionsPath}`);
-		}
-		if (shouldPrefetchPackages) if (packages.length === 0) {
-			print.warning("No packages found to prefetch.");
-			print.info("Prefetch supports: npx, pnpx, uvx, and uv run commands");
-		} else {
-			print.info(`Found ${packages.length} package(s) to prefetch:`);
-			for (const pkg of packages) print.item(`${pkg.serverName}: ${pkg.packageManager} ${pkg.packageName}`);
-		}
-		if (!shouldPrefetchPackages && !shouldWriteDefinitions) {
-			print.warning("Nothing to do. Use package prefetch or provide --definitions-out.");
-			return;
-		}
-		if (options.dryRun) {
-			if (shouldPrefetchPackages && packages.length > 0) {
-				print.newline();
-				print.header("Dry run mode - commands that would be executed:");
-				for (const pkg of packages) print.indent(pkg.fullCommand.join(" "));
-			}
-			if (shouldWriteDefinitions) {
-				print.newline();
-				print.info(`Would write definitions cache to: ${effectiveDefinitionsPath}`);
-			}
-			return;
-		}
-		let packagePrefetchFailed = false;
-		if (shouldPrefetchPackages && packages.length > 0) {
-			print.newline();
-			print.info("Prefetching packages...");
-			const summary = await prefetchService.prefetch();
-			print.newline();
-			if (summary.failed === 0) print.success(`Package prefetch complete: ${summary.successful} succeeded, ${summary.failed} failed`);
-			else print.warning(`Package prefetch complete: ${summary.successful} succeeded, ${summary.failed} failed`);
-			if (summary.failed > 0) {
-				packagePrefetchFailed = true;
-				print.newline();
-				print.error("Failed packages:");
-				for (const result of summary.results.filter((r) => !r.success)) print.item(`${result.package.serverName} (${result.package.packageName}): ${result.output.trim()}`);
-			}
-		}
-		if (shouldWriteDefinitions) {
-			print.newline();
-			print.info("Collecting definitions cache...");
-			const clientManager = container.createClientManagerService();
-			const skillPaths = mcpConfig.skills?.paths || [];
-			const skillService = skillPaths.length > 0 ? container.createSkillService(process.cwd(), skillPaths) : void 0;
-			const definitionsCacheService = container.createDefinitionsCacheService(clientManager, skillService);
-			await Promise.all(Object.entries(mcpConfig.mcpServers).map(async ([serverName, serverConfig]) => {
-				try {
-					await clientManager.connectToServer(serverName, serverConfig);
-					print.item(`Connected for definitions: ${serverName}`);
-				} catch (error) {
-					print.warning(`Failed to connect for definitions: ${serverName} (${error instanceof Error ? error.message : String(error)})`);
-				}
-			}));
-			const definitionsCache = await definitionsCacheService.collectForCache({
-				configPath: configFilePath,
-				configHash,
-				oneMcpVersion: require_src.version,
-				serverId
-			});
-			await require_src.DefinitionsCacheService.writeToFile(effectiveDefinitionsPath, definitionsCache);
-			print.success(`Definitions cache written: ${effectiveDefinitionsPath} (${Object.keys(definitionsCache.servers).length} servers, ${definitionsCache.skills.length} skills)`);
-			if (definitionsCache.failures.length > 0) print.warning(`Definitions cache completed with ${definitionsCache.failures.length} server failure(s)`);
-			await clientManager.disconnectAll();
-		}
-		if (packagePrefetchFailed) process.exit(1);
-	} catch (error) {
-		print.error(`Error executing prefetch: ${error instanceof Error ? error.message : String(error)}`);
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/commands/read-resource.ts
-/**
-* ReadResource Command
-*
-* DESIGN PATTERNS:
-* - Command pattern with Commander for CLI argument parsing
-* - Async/await pattern for asynchronous operations
-* - Error handling pattern with try-catch and proper exit codes
-*
-* CODING STANDARDS:
-* - Use async action handlers for asynchronous operations
-* - Provide clear option descriptions and default values
-* - Handle errors gracefully with process.exit()
-* - Log progress and errors to console
-* - Use Commander's .option() and .argument() for inputs
-*
-* AVOID:
-* - Synchronous blocking operations in action handlers
-* - Missing error handling (always use try-catch)
-* - Hardcoded values (use options or environment variables)
-* - Not exiting with appropriate exit codes on errors
-*/
-function toErrorMessage$2(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-/**
-* Read a resource by URI from a connected MCP server
-*/
-const readResourceCommand = new commander.Command("read-resource").description("Read a resource by URI from a connected MCP server").argument("<uri>", "Resource URI to read").option("-c, --config <path>", "Path to MCP server configuration file").option("-s, --server <name>", "Server name (required if resource exists on multiple servers)").option("-j, --json", "Output as JSON", false).action(async (uri, options) => {
-	try {
-		await withConnectedCommandContext(options, async ({ clientManager }) => {
-			const clients = clientManager.getAllClients();
-			if (options.server) {
-				const client = clientManager.getClient(options.server);
-				if (!client) throw new Error(`Server "${options.server}" not found`);
-				if (!options.json) console.error(`Reading ${uri} from ${options.server}...`);
-				const result = await client.readResource(uri);
-				if (options.json) console.log(JSON.stringify(result, null, 2));
-				else for (const content of result.contents) if ("text" in content) console.log(content.text);
-				else console.log(JSON.stringify(content, null, 2));
-				return;
-			}
-			const searchResults = await Promise.all(clients.map(async (client) => {
-				try {
-					const hasResource = (await client.listResources()).some((r) => r.uri === uri);
-					return {
-						serverName: client.serverName,
-						hasResource,
-						error: null
-					};
-				} catch (error) {
-					return {
-						serverName: client.serverName,
-						hasResource: false,
-						error
-					};
-				}
-			}));
-			const matchingServers = [];
-			for (const { serverName, hasResource, error } of searchResults) {
-				if (error) {
-					console.error(`Failed to list resources from ${serverName}: ${toErrorMessage$2(error)}`);
-					continue;
-				}
-				if (hasResource) matchingServers.push(serverName);
-			}
-			if (matchingServers.length === 0) throw new Error(`Resource "${uri}" not found on any connected server`);
-			if (matchingServers.length > 1) throw new Error(`Resource "${uri}" found on multiple servers: ${matchingServers.join(", ")}. Use --server to disambiguate`);
-			const targetServer = matchingServers[0];
-			const client = clientManager.getClient(targetServer);
-			if (!client) throw new Error(`Internal error: Server "${targetServer}" not connected`);
-			if (!options.json) console.error(`Reading ${uri} from ${targetServer}...`);
-			const result = await client.readResource(uri);
-			if (options.json) console.log(JSON.stringify(result, null, 2));
-			else for (const content of result.contents) if ("text" in content) console.log(content.text);
-			else console.log(JSON.stringify(content, null, 2));
-		});
-	} catch (error) {
-		console.error(`Error executing read-resource: ${toErrorMessage$2(error)}`);
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/commands/stop.ts
-/**
-* Stop Command
-*
-* Stops a running HTTP mcp-proxy server using the authenticated admin endpoint
-* and the persisted runtime registry.
-*/
-function toErrorMessage$1(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-function printStopResult(result) {
-	console.log(`Stopped mcp-proxy server '${result.serverId}'.`);
-	console.log(`Endpoint: http://${result.host}:${result.port}`);
-	console.log(`Result: ${result.message}`);
-}
-/**
-* Stop a running HTTP mcp-proxy server.
-*/
-const stopCommand = new commander.Command("stop").description("Stop a running HTTP mcp-proxy server").option("--id <id>", "Target server ID from the runtime registry").option("--host <host>", "Target runtime host").option("--port <port>", "Target runtime port", (value) => Number.parseInt(value, 10)).option("-c, --config <path>", "Reserved for future config-based targeting support").option("--token <token>", "Override the persisted shutdown token").option("--force", "Skip server ID verification against the /health response", false).option("-j, --json", "Output as JSON", false).option("--timeout <ms>", "Maximum time to wait for shutdown completion", (value) => Number.parseInt(value, 10), 5e3).action(async (options) => {
-	try {
-		if (options.config) console.error("Warning: --config is not used yet; runtime resolution uses the persisted registry.");
-		const result = await require_src.createProxyIoCContainer().createStopServerService().stop({
-			serverId: options.id,
-			host: options.host,
-			port: options.port,
-			token: options.token,
-			force: options.force,
-			timeoutMs: options.timeout
-		});
-		if (options.json) {
-			console.log(JSON.stringify(result, null, 2));
-			return;
-		}
-		printStopResult(result);
-	} catch (error) {
-		const errorMessage = `Error executing stop: ${toErrorMessage$1(error)}`;
-		if (options.json) console.log(JSON.stringify({
-			ok: false,
-			error: errorMessage
-		}, null, 2));
-		else console.error(errorMessage);
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/commands/use-tool.ts
-/**
-* Use Tool Command
-*
-* DESIGN PATTERNS:
-* - Command pattern with Commander for CLI argument parsing
-* - Async/await pattern for asynchronous operations
-* - Error handling pattern with try-catch and proper exit codes
-*
-* CODING STANDARDS:
-* - Use async action handlers for asynchronous operations
-* - Provide clear option descriptions and default values
-* - Handle errors gracefully with process.exit()
-* - Log progress and errors to console
-* - Use Commander'"'"'s .option() and .argument() for inputs
-*
-* AVOID:
-* - Synchronous blocking operations in action handlers
-* - Missing error handling (always use try-catch)
-* - Hardcoded values (use options or environment variables)
-* - Not exiting with appropriate exit codes on errors
-*/
-function toErrorMessage(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-/**
-* Execute an MCP tool with arguments
-*/
-const useToolCommand = new commander.Command("use-tool").description("Execute an MCP tool with arguments").argument("<toolName>", "Tool name to execute").option("-c, --config <path>", "Path to MCP server configuration file").option("-s, --server <name>", "Server name (required if tool exists on multiple servers)").option("-a, --args <json>", "Tool arguments as JSON string", "{}").option("-t, --timeout <ms>", "Request timeout in milliseconds for tool execution (default: 60000)", Number.parseInt).option("-j, --json", "Output as JSON", false).action(async (toolName, options) => {
-	try {
-		let toolArgs = {};
-		try {
-			toolArgs = JSON.parse(options.args);
-		} catch {
-			console.error("Error: Invalid JSON in --args");
-			process.exit(1);
-		}
-		await withConnectedCommandContext(options, async ({ container, config, clientManager }) => {
-			const clients = clientManager.getAllClients();
-			if (options.server) {
-				const client = clientManager.getClient(options.server);
-				if (!client) throw new Error(`Server "${options.server}" not found`);
-				if (!options.json) console.error(`Executing ${toolName} on ${options.server}...`);
-				const requestOptions = options.timeout ? { timeout: options.timeout } : void 0;
-				const result = await client.callTool(toolName, toolArgs, requestOptions);
-				if (options.json) console.log(JSON.stringify(result, null, 2));
-				else {
-					console.log("\nResult:");
-					if (result.content) for (const content of result.content) if (content.type === "text") console.log(content.text);
-					else console.log(JSON.stringify(content, null, 2));
-					if (result.isError) {
-						console.error("\n⚠️  Tool execution returned an error");
-						process.exit(1);
-					}
-				}
-				return;
-			}
-			const searchResults = await Promise.all(clients.map(async (client) => {
-				try {
-					const hasTool = (await client.listTools()).some((t) => t.name === toolName);
-					return {
-						serverName: client.serverName,
-						hasTool,
-						error: null
-					};
-				} catch (error) {
-					return {
-						serverName: client.serverName,
-						hasTool: false,
-						error
-					};
-				}
-			}));
-			const matchingServers = [];
-			for (const { serverName, hasTool, error } of searchResults) {
-				if (error) {
-					if (!options.json) console.error(`Failed to list tools from ${serverName}:`, error);
-					continue;
-				}
-				if (hasTool) matchingServers.push(serverName);
-			}
-			if (matchingServers.length === 0) {
-				const skillPaths = config.skills?.paths || [];
-				if (skillPaths.length > 0) try {
-					const cwd = process.env.PROJECT_PATH || process.cwd();
-					const skillService = container.createSkillService(cwd, skillPaths);
-					const skillName = toolName.startsWith("skill__") ? toolName.slice(7) : toolName;
-					const skill = await skillService.getSkill(skillName);
-					if (skill) {
-						const result = { content: [{
-							type: "text",
-							text: skill.content
-						}] };
-						if (options.json) console.log(JSON.stringify(result, null, 2));
-						else {
-							console.log("\nSkill content:");
-							console.log(skill.content);
-						}
-						return;
-					}
-				} catch (error) {
-					if (!options.json) console.error(`Failed to lookup skill "${toolName}":`, error);
-				}
-				throw new Error(`Tool or skill "${toolName}" not found on any connected server or configured skill paths`);
-			}
-			if (matchingServers.length > 1) throw new Error(`Tool "${toolName}" found on multiple servers: ${matchingServers.join(", ")}`);
-			const targetServer = matchingServers[0];
-			const client = clientManager.getClient(targetServer);
-			if (!client) throw new Error(`Internal error: Server "${targetServer}" not connected`);
-			if (!options.json) console.error(`Executing ${toolName} on ${targetServer}...`);
-			const requestOptions = options.timeout ? { timeout: options.timeout } : void 0;
-			const result = await client.callTool(toolName, toolArgs, requestOptions);
-			if (options.json) console.log(JSON.stringify(result, null, 2));
-			else {
-				console.log("\nResult:");
-				if (result.content) for (const content of result.content) if (content.type === "text") console.log(content.text);
-				else console.log(JSON.stringify(content, null, 2));
-				if (result.isError) {
-					console.error("\n⚠️  Tool execution returned an error");
-					process.exit(1);
-				}
-			}
-		});
-	} catch (error) {
-		console.error(`Error executing use-tool: ${toErrorMessage(error)}`);
-		process.exit(1);
-	}
-});
-//#endregion
-//#region src/cli.ts
-/**
-* MCP Server Entry Point
-*
-* DESIGN PATTERNS:
-* - CLI pattern with Commander for argument parsing
-* - Command pattern for organizing CLI commands
-* - Transport abstraction for multiple communication methods
-*
-* CODING STANDARDS:
-* - Use async/await for asynchronous operations
-* - Handle errors gracefully with try-catch
-* - Log important events for debugging
-* - Register all commands in main entry point
-*
-* AVOID:
-* - Hardcoding command logic in index.ts (use separate command files)
-* - Missing error handling for command execution
-*/
-/**
-* Main entry point
-*/
-async function main() {
-	try {
-		const program = new commander.Command();
-		program.name("mcp-proxy").description("MCP proxy server package").version(require_src.version);
-		program.addCommand(initCommand);
-		program.addCommand(mcpServeCommand);
-		program.addCommand(searchToolsCommand);
-		program.addCommand(describeToolsCommand);
-		program.addCommand(useToolCommand);
-		program.addCommand(listResourcesCommand);
-		program.addCommand(readResourceCommand);
-		program.addCommand(listPromptsCommand);
-		program.addCommand(getPromptCommand);
-		program.addCommand(prefetchCommand);
-		program.addCommand(stopCommand);
-		await program.parseAsync(process.argv);
-	} catch (error) {
-		console.error(`CLI execution failed: ${error instanceof Error ? error.message : error}`);
-		process.exit(1);
-	}
-}
-main().catch((error) => {
-	console.error(`Fatal error: ${error instanceof Error ? error.message : error}`);
-	process.exit(1);
-});
-//#endregion
+const e=require(`./src-CLGPFgYD.cjs`);let t=require(`node:fs`),n=require(`node:fs/promises`),r=require(`js-yaml`);r=e.O(r);let i=require(`node:crypto`),a=require(`node:path`);a=e.O(a);let o=require(`@agimon-ai/foundation-process-registry`),s=require(`node:child_process`),c=require(`liquidjs`),l=require(`commander`),u=require(`node:url`),d=require(`@agimon-ai/foundation-port-registry`);const f=[`pnpm-workspace.yaml`,`nx.json`,`.git`],p=`localhost`;function m(e=process.env.PROJECT_PATH||process.cwd()){let n=a.default.resolve(e);for(;;){for(let e of f)if((0,t.existsSync)(a.default.join(n,e)))return n;let e=a.default.dirname(n);if(e===n)return process.cwd();n=e}}async function h(e){let t=(await new o.ProcessRegistryService(process.env.PROCESS_REGISTRY_PATH).listProcesses({repositoryPath:e,serviceName:`mcp-proxy-http`}))[0];if(!t?.host||!t?.port)return null;let n=t.metadata;return{host:t.host,port:t.port,serverId:n?.serverId??`unknown`}}async function g(e,t){try{return(await fetch(`http://${e}:${t}/health`)).ok}catch{return!1}}function _(){let e=(0,u.fileURLToPath)(require(`url`).pathToFileURL(__filename).href),n=a.default.dirname(e),r=[a.default.resolve(n,`cli.mjs`),a.default.resolve(n,`..`,`dist`,`cli.mjs`),a.default.resolve(n,`..`,`..`,`dist`,`cli.mjs`)],i=[a.default.resolve(n,`..`,`cli.ts`),a.default.resolve(n,`..`,`..`,`src`,`cli.ts`)];for(let e of r)if((0,t.existsSync)(e))return{command:process.execPath,args:[e]};for(let e of i)if((0,t.existsSync)(e))return{command:process.execPath,args:[`--import`,`tsx`,e]};throw Error(`Unable to locate mcp-proxy CLI entrypoint`)}function v(e){if(!e)return 12e4;let t=Number.parseInt(e,10);if(!Number.isInteger(t)||t<=0)throw Error(`Invalid timeout value: ${e}`);return t}async function y(e,t){let r=Date.now()+t;for(;Date.now()<r;){try{await(0,n.access)(e);return}catch{}await new Promise(e=>setTimeout(e,250))}throw Error(`Timed out waiting for runtime state file: ${e}`)}async function b(t,n){let r=new e.b,i=Date.now()+n;for(;Date.now()<i;){let e=await r.read(t);if(e){let t=`http://${e.host}:${e.port}/health`;try{let n=await fetch(t);if(n.ok){let t=await n.json().catch(()=>null);if(!t||t.transport===`http`)return{host:e.host,port:e.port}}}catch{}}await new Promise(e=>setTimeout(e,250))}throw Error(`Timed out waiting for HTTP runtime '${t}' to become healthy`)}function x(e,t,n){let{command:r,args:i}=_(),a=(0,s.spawn)(r,[...i,...e],{detached:!0,cwd:n,stdio:`ignore`,env:t});return a.unref(),a}async function ee(t,n,r,i){let a=await t.list(),o=r||p,s=a.find(e=>!!(n&&e.serverId===n||i!==void 0&&e.host===o&&e.port===i));if(!s)return;let c=new e.v(t);try{await c.stop({serverId:s.serverId,force:!0})}catch{await t.remove(s.serverId)}}async function S(t){let n=t.id||e.w(),r=v(t.timeoutMs),i=t.registryPath||t.registryDir,s=m(),c=await h(s);if(c&&await g(c.host,c.port))return{host:c.host,port:c.port,serverId:c.serverId,workspaceRoot:s,reusedExistingRuntime:!0};let l=t.port??c?.port;await ee(new e.b,t.id,t.host,l);let u={...process.env,...i?{PORT_REGISTRY_PATH:i,PROCESS_REGISTRY_PATH:(0,o.resolveSiblingRegistryPath)(i,`processes.json`)}:{}},d=x([`mcp-serve`,`--type`,`http`,`--id`,n,`--host`,t.host||p,...l===void 0?[]:[`--port`,String(l)],...t.config?[`--config`,t.config]:[],...t.cache===!1?[`--no-cache`]:[],...t.definitionsCache?[`--definitions-cache`,t.definitionsCache]:[],...t.clearDefinitionsCache?[`--clear-definitions-cache`]:[],`--proxy-mode`,t.proxyMode],u,s),f=new Promise((e,t)=>{d.once(`exit`,(e,n)=>{t(Error(`Background runtime exited before becoming healthy (code=${e??`null`}, signal=${n??`null`})`))})}),_=a.default.join(e.b.getDefaultRuntimeDir(),`${n}.runtime.json`);try{await Promise.race([y(_,r),f]);let{host:e,port:t}=await Promise.race([b(n,r),f]);return{host:e,port:t,serverId:n,workspaceRoot:s,reusedExistingRuntime:!1}}catch(e){throw Error(`Failed to prestart HTTP runtime '${n}': ${e instanceof Error?e.message:String(e)}`,{cause:e})}}function te(e){process.stdout.write(`mcp-proxy HTTP runtime ready at http://${e.host}:${e.port} (${e.serverId})\n`),process.stdout.write(`runtimeId=${e.serverId}\n`),process.stdout.write(`runtimeUrl=http://${e.host}:${e.port}\n`),process.stdout.write(`workspaceRoot=${e.workspaceRoot}\n`)}function C(e){return e instanceof Error?e.message:String(e)}async function ne(e,t){try{return(await fetch(`http://${e}:${t}/health`,{signal:AbortSignal.timeout(3e3)})).ok}catch{return!1}}async function re(e,t,n,r,i){let a=t.proxy?.host??`localhost`,o=t.proxy?.port,s=`http://${a}:${o}/mcp`;await ne(a,o)||(r.json||console.error(`Starting HTTP proxy server in background...`),await S({host:a,port:o,config:n,cache:r.useCache!==!1,clearDefinitionsCache:!1,proxyMode:`flat`}));let c=e.createClientManagerService();try{await c.connectToServer(`proxy`,{name:`proxy`,transport:`http`,config:{url:s}}),r.json||console.error(`✓ Connected to proxy at ${s}`)}catch(e){throw Error(`Failed to connect to proxy server at ${s}: ${C(e)}`)}try{return await i({container:e,configFilePath:n,config:t,clientManager:c})}finally{await c.disconnectAll()}}async function ie(e,t,n,r,i){let a=e.createClientManagerService();if(await Promise.all(Object.entries(t.mcpServers).map(async([e,t])=>{try{await a.connectToServer(e,t),r.json||console.error(`✓ Connected to ${e}`)}catch(t){r.json||console.error(`✗ Failed to connect to ${e}: ${C(t)}`)}})),a.getAllClients().length===0)throw Error(`No MCP servers connected`);try{return await i({container:e,configFilePath:n,config:t,clientManager:a})}finally{await a.disconnectAll()}}async function w(t,n){let r=e.o(),i=t.config||e.T();if(!i)throw Error(`No config file found. Use --config or create mcp-config.yaml`);let a=await r.createConfigFetcherService({configFilePath:i,useCache:t.useCache}).fetchConfiguration();return a.proxy?.port?await re(r,a,i,t,n):await ie(r,a,i,t,n)}function ae(e){return e instanceof Error?e.message:String(e)}const oe=new l.Command(`describe-tools`).description(`Describe specific MCP tools`).argument(`<toolNames...>`,`Tool names to describe`).option(`-c, --config <path>`,`Path to MCP server configuration file`).option(`-s, --server <name>`,`Filter by server name`).option(`-j, --json`,`Output as JSON`,!1).action(async(e,t)=>{try{await w(t,async({container:n,config:r,clientManager:i})=>{let a=t.server?[i.getClient(t.server)].filter(e=>e!==void 0):i.getAllClients();if(t.server&&a.length===0)throw Error(`Server "${t.server}" not found`);let o=process.env.PROJECT_PATH||process.cwd(),s=r.skills?.paths||[],c=s.length>0?n.createSkillService(o,s):void 0,l=[],u=[],d=[...e],f=await Promise.all(a.map(async e=>{try{return{client:e,tools:await e.listTools(),error:null}}catch(t){return{client:e,tools:[],error:t}}}));for(let{client:n,tools:r,error:i}of f){if(i){t.json||console.error(`Failed to list tools from ${n.serverName}:`,i);continue}for(let t of e){let e=r.find(e=>e.name===t);if(e){l.push({server:n.serverName,name:e.name,description:e.description,inputSchema:e.inputSchema});let r=d.indexOf(t);r>-1&&d.splice(r,1)}}}if(c&&d.length>0){let e=await Promise.all([...d].map(async e=>{let t=e.startsWith(`skill__`)?e.slice(7):e;return{toolName:e,skill:await c.getSkill(t)}}));for(let{toolName:t,skill:n}of e)if(n){u.push({name:n.name,location:n.basePath,instructions:n.content});let e=d.indexOf(t);e>-1&&d.splice(e,1)}}let p=[];if(l.length>0&&p.push(`For MCP tools: Use the use_tool function with toolName and toolArgs based on the inputSchema above.`),u.length>0&&p.push(`For skill, just follow skill's description to continue.`),t.json){let e={};l.length>0&&(e.tools=l),u.length>0&&(e.skills=u),p.length>0&&(e.nextSteps=p),d.length>0&&(e.notFound=d),console.log(JSON.stringify(e,null,2))}else{if(l.length>0){console.log(`
+Found tools:
+`);for(let e of l)console.log(`Server: ${e.server}`),console.log(`Tool: ${e.name}`),console.log(`Description: ${e.description||`No description`}`),console.log(`Input Schema:`),console.log(JSON.stringify(e.inputSchema,null,2)),console.log(``)}if(u.length>0){console.log(`
+Found skills:
+`);for(let e of u)console.log(`Skill: ${e.name}`),console.log(`Location: ${e.location}`),console.log(`Instructions:\n${e.instructions}`),console.log(``)}if(p.length>0){console.log(`
+Next steps:`);for(let e of p)console.log(`  • ${e}`);console.log(``)}d.length>0&&console.error(`\nTools/skills not found: ${d.join(`, `)}`),l.length===0&&u.length===0&&(console.error(`No tools or skills found`),process.exit(1))}})}catch(e){console.error(`Error executing describe-tools: ${ae(e)}`),process.exit(1)}});function T(e){return e instanceof Error?e.message:String(e)}const se=new l.Command(`get-prompt`).description(`Get a prompt by name from a connected MCP server`).argument(`<promptName>`,`Prompt name to fetch`).option(`-c, --config <path>`,`Path to MCP server configuration file`).option(`-s, --server <name>`,`Server name (required if prompt exists on multiple servers)`).option(`-a, --args <json>`,`Prompt arguments as JSON string`,`{}`).option(`-j, --json`,`Output as JSON`,!1).action(async(e,t)=>{try{let n={};try{n=JSON.parse(t.args)}catch{throw Error(`Invalid JSON in --args`)}await w(t,async({clientManager:r})=>{let i=r.getAllClients();if(t.server){let i=r.getClient(t.server);if(!i)throw Error(`Server "${t.server}" not found`);let a=await i.getPrompt(e,n);if(t.json)console.log(JSON.stringify(a,null,2));else for(let e of a.messages){let t=e.content;typeof t==`object`&&t&&`text`in t?console.log(t.text):console.log(JSON.stringify(e,null,2))}return}let a=[];if(await Promise.all(i.map(async n=>{try{(await n.listPrompts()).some(t=>t.name===e)&&a.push(n.serverName)}catch(e){t.json||console.error(`Failed to list prompts from ${n.serverName}: ${T(e)}`)}})),a.length===0)throw Error(`Prompt "${e}" not found on any connected server`);if(a.length>1)throw Error(`Prompt "${e}" found on multiple servers: ${a.join(`, `)}. Use --server to disambiguate`);let o=r.getClient(a[0]);if(!o)throw Error(`Internal error: Server "${a[0]}" not connected`);let s=await o.getPrompt(e,n);if(t.json)console.log(JSON.stringify(s,null,2));else for(let e of s.messages){let t=e.content;typeof t==`object`&&t&&`text`in t?console.log(t.text):console.log(JSON.stringify(e,null,2))}})}catch(e){console.error(`Error executing get-prompt: ${T(e)}`),process.exit(1)}});var ce=`{
+  "_comment": "MCP Server Configuration - Use \${VAR_NAME} syntax for environment variable interpolation",
+  "_instructions": "config.instruction: Server's default instruction | instruction: User override (takes precedence)",
+  "mcpServers": {
+    "example-server": {
+      "command": "node",
+      "args": ["/path/to/mcp-server/build/index.js"],
+      "env": {
+        "LOG_LEVEL": "info",
+        "_comment": "You can use environment variable interpolation:",
+        "_example_DATABASE_URL": "\${DATABASE_URL}",
+        "_example_API_KEY": "\${MY_API_KEY}"
+      },
+      "config": {
+        "instruction": "Use this server for..."
+      },
+      "_instruction_override": "Optional user override - takes precedence over config.instruction"
+    }
+  }
+}
+`,le=`# MCP Server Configuration
+# This file configures the MCP servers that mcp-proxy will connect to
+#
+# Environment Variable Interpolation:
+# Use \${VAR_NAME} syntax to reference environment variables
+# Example: \${HOME}, \${API_KEY}, \${DATABASE_URL}
+#
+# Instructions:
+# - config.instruction: Server's default instruction (from server documentation)
+# - instruction: User override (optional, takes precedence over config.instruction)
+# - config.toolBlacklist: Array of tool names to hide/block from this server
+# - config.omitToolDescription: Boolean to show only tool names without descriptions (saves tokens)
+
+# Remote Configuration Sources (OPTIONAL)
+# Fetch and merge configurations from remote URLs
+# Remote configs are merged with local configs based on merge strategy
+#
+# SECURITY: SSRF Protection is ENABLED by default
+# - Only HTTPS URLs are allowed (set security.enforceHttps: false to allow HTTP)
+# - Private IPs and localhost are blocked (set security.allowPrivateIPs: true for internal networks)
+# - Blocked ranges: 127.0.0.0/8, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 169.254.0.0/16
+remoteConfigs:
+  # Example 1: Basic remote config with default security
+  # - url: \${AGIFLOW_URL}/api/v1/mcp-configs
+  #   headers:
+  #     Authorization: Bearer \${AGIFLOW_API_KEY}
+  #   mergeStrategy: local-priority  # Options: local-priority (default), remote-priority, merge-deep
+  #
+  # Example 2: Remote config with custom security settings (for internal networks)
+  # - url: \${INTERNAL_URL}/mcp-configs
+  #   headers:
+  #     Authorization: Bearer \${INTERNAL_TOKEN}
+  #   security:
+  #     allowPrivateIPs: true   # Allow internal IPs (default: false)
+  #     enforceHttps: false     # Allow HTTP (default: true, HTTPS only)
+  #   mergeStrategy: local-priority
+  #
+  # Example 3: Remote config with additional validation (OPTIONAL)
+  # - url: \${AGIFLOW_URL}/api/v1/mcp-configs
+  #   headers:
+  #     Authorization: Bearer \${AGIFLOW_API_KEY}
+  #     X-API-Key: \${AGIFLOW_API_KEY}
+  #   security:
+  #     enforceHttps: true      # Require HTTPS (default: true)
+  #     allowPrivateIPs: false  # Block private IPs (default: false)
+  #   validation:  # OPTIONAL: Additional regex validation on top of security checks
+  #     url: ^https://.*\\.agiflow\\.io/.*  # OPTIONAL: Regex pattern to validate URL format
+  #     headers:  # OPTIONAL: Regex patterns to validate header values
+  #       Authorization: ^Bearer [A-Za-z0-9_-]+$
+  #       X-API-Key: ^[A-Za-z0-9_-]{32,}$
+  #   mergeStrategy: local-priority
+
+mcpServers:
+{%- if mcpServers %}{% for server in mcpServers %}
+  {{ server.name }}:
+    command: {{ server.command }}
+    args:{% for arg in server.args %}
+      - '{{ arg }}'{% endfor %}
+    # env:
+    #   LOG_LEVEL: info
+    #   # API_KEY: \${MY_API_KEY}
+    # config:
+    #   instruction: Use this server for...
+    #   # toolBlacklist:
+    #   #   - tool_to_block
+    #   # omitToolDescription: true
+{% endfor %}
+  # Example MCP server using SSE transport
+  # remote-server:
+  #   url: https://example.com/mcp
+  #   type: sse
+  #   headers:
+  #     Authorization: Bearer \${API_KEY}
+  #   config:
+  #     instruction: This server provides tools for...
+{% else %}
+  # Example MCP server using stdio transport
+  example-server:
+    command: node
+    args:
+      - /path/to/mcp-server/build/index.js
+    env:
+      # Environment variables for the MCP server
+      LOG_LEVEL: info
+      # You can use environment variable interpolation:
+      # DATABASE_URL: \${DATABASE_URL}
+      # API_KEY: \${MY_API_KEY}
+    config:
+      # Server's default instruction (from server documentation)
+      instruction: Use this server for...
+      # Optional: Block specific tools from being listed or executed
+      # toolBlacklist:
+      #   - dangerous_tool_name
+      #   - another_blocked_tool
+      # Optional: Omit tool descriptions to save tokens (default: false)
+      # omitToolDescription: true
+    # instruction: Optional user override - takes precedence over config.instruction
+
+  # Example MCP server using SSE transport with environment variables
+  # remote-server:
+  #   url: https://example.com/mcp
+  #   type: sse
+  #   headers:
+  #     # Use \${VAR_NAME} to interpolate environment variables
+  #     Authorization: Bearer \${API_KEY}
+  #   config:
+  #     instruction: This server provides tools for...
+  #     # Optional: Block specific tools from being listed or executed
+  #     # toolBlacklist:
+  #     #   - tool_to_block
+  #     # Optional: Omit tool descriptions to save tokens (default: false)
+  #     # omitToolDescription: true
+  #   # instruction: Optional user override
+{% endif %}
+`;function E(e=``){console.log(e)}function D(e,t){console.error(t?`${e} ${t}`:e)}const O={info:e=>E(e),error:(e,t)=>D(e,t)},k={info:e=>E(e),warning:e=>E(`Warning: ${e}`),error:e=>D(e),success:e=>E(e),newline:()=>E(),header:e=>E(e),item:e=>E(`- ${e}`),indent:e=>E(`  ${e}`)},ue=new l.Command(`init`).description(`Initialize MCP configuration file`).option(`-o, --output <path>`,`Output file path`,`mcp-config.yaml`).option(`--json`,`Generate JSON config instead of YAML`,!1).option(`-f, --force`,`Overwrite existing config file`,!1).option(`--mcp-servers <json>`,`JSON string of MCP servers to add to config (optional)`).action(async e=>{try{let t=(0,a.resolve)(e.output),r=!e.json&&(t.endsWith(`.yaml`)||t.endsWith(`.yml`)),i;if(r){let t=new c.Liquid,n=null;if(e.mcpServers)try{let t=JSON.parse(e.mcpServers);n=Object.entries(t).map(([e,t])=>({name:e,command:t.command,args:t.args}))}catch(e){O.error(`Failed to parse --mcp-servers JSON:`,e instanceof Error?e.message:String(e)),process.exit(1)}i=await t.parseAndRender(le,{mcpServers:n})}else i=ce;try{await(0,n.writeFile)(t,i,{encoding:`utf-8`,flag:e.force?`w`:`wx`})}catch(e){throw e&&typeof e==`object`&&`code`in e&&e.code===`EEXIST`&&(O.error(`Config file already exists: ${t}`),O.info(`Use --force to overwrite`),process.exit(1)),e}O.info(`MCP configuration file created: ${t}`),O.info(`Next steps:`),O.info(`1. Edit the configuration file to add your MCP servers`),O.info(`2. Run: mcp-proxy mcp-serve --config ${t}`)}catch(e){O.error(`Error executing init:`,e instanceof Error?e.message:String(e)),process.exit(1)}});function A(e){return e instanceof Error?e.message:String(e)}const de=new l.Command(`list-prompts`).description(`List all available prompts from connected MCP servers`).option(`-c, --config <path>`,`Path to MCP server configuration file`).option(`-s, --server <name>`,`Filter by server name`).option(`-j, --json`,`Output as JSON`,!1).action(async e=>{try{await w(e,async({clientManager:t})=>{let n=e.server?[t.getClient(e.server)].filter(e=>e!==void 0):t.getAllClients();if(e.server&&n.length===0)throw Error(`Server "${e.server}" not found`);let r={};if(await Promise.all(n.map(async t=>{try{r[t.serverName]=await t.listPrompts()}catch(n){r[t.serverName]=[],e.json||console.error(`Failed to list prompts from ${t.serverName}: ${A(n)}`)}})),e.json)console.log(JSON.stringify(r,null,2));else for(let[e,t]of Object.entries(r)){if(console.log(`\n${e}:`),t.length===0){console.log(`  No prompts available`);continue}for(let e of t)if(console.log(`  - ${e.name}: ${e.description||`No description`}`),e.arguments&&e.arguments.length>0){let t=e.arguments.map(e=>`${e.name}${e.required?` (required)`:``}`).join(`, `);console.log(`    args: ${t}`)}}})}catch(e){console.error(`Error executing list-prompts: ${A(e)}`),process.exit(1)}});function j(e){return e instanceof Error?e.message:String(e)}const fe=new l.Command(`list-resources`).description(`List all available resources from connected MCP servers`).option(`-c, --config <path>`,`Path to MCP server configuration file`).option(`-s, --server <name>`,`Filter by server name`).option(`-j, --json`,`Output as JSON`,!1).action(async e=>{try{await w(e,async({clientManager:t})=>{let n=e.server?[t.getClient(e.server)].filter(e=>e!==void 0):t.getAllClients();if(e.server&&n.length===0)throw Error(`Server "${e.server}" not found`);let r={},i=await Promise.all(n.map(async e=>{try{let t=await e.listResources();return{serverName:e.serverName,resources:t,error:null}}catch(t){return{serverName:e.serverName,resources:[],error:t}}}));for(let{serverName:t,resources:n,error:a}of i)a&&!e.json&&console.error(`Failed to list resources from ${t}: ${j(a)}`),r[t]=n;if(e.json)console.log(JSON.stringify(r,null,2));else for(let[e,t]of Object.entries(r))if(console.log(`\n${e}:`),t.length===0)console.log(`  No resources available`);else for(let e of t){let t=e.name?`${e.name} (${e.uri})`:e.uri;console.log(`  - ${t}${e.description?`: ${e.description}`:``}`)}})}catch(e){console.error(`Error executing list-resources: ${j(e)}`),process.exit(1)}});function pe(e){return e instanceof Error?e.message:String(e)}function me(e){for(let t of e.servers){if(console.log(`\n${t.server}:`),t.capabilities&&t.capabilities.length>0&&console.log(`  capabilities: ${t.capabilities.join(`, `)}`),t.summary&&console.log(`  summary: ${t.summary}`),t.tools.length===0){console.log(`  no tools`);continue}for(let e of t.tools){let t=e.capabilities&&e.capabilities.length>0?` [${e.capabilities.join(`, `)}]`:``;console.log(`  - ${e.name}${t}`),e.description&&console.log(`    ${e.description}`)}}}const he=new l.Command(`search-tools`).description(`Search proxied MCP tools by capability or server`).option(`-c, --config <path>`,`Path to MCP server configuration file`).option(`-s, --server <name>`,`Filter by server name`).option(`--capability <name>`,`Filter by capability tag, summary, tool name, or description`).option(`--definitions-cache <path>`,`Path to definitions cache file`).option(`-j, --json`,`Output as JSON`,!1).action(async t=>{try{await w(t,async({container:n,config:r,clientManager:i,configFilePath:a})=>{i.registerServerConfigs(r.mcpServers);let o=t.definitionsCache||e.C.getDefaultCachePath(a),s;try{s=await e.C.readFromFile(o)}catch{s=void 0}let c=n.createDefinitionsCacheService(i,void 0,{cacheData:s}),l=(await n.createSearchListToolsTool(i,c).execute({capability:t.capability,serverName:t.server})).content.find(e=>e.type===`text`),u=l?.type===`text`?JSON.parse(l.text):{servers:[]};if(t.json)console.log(JSON.stringify(u,null,2));else{if(!u.servers||u.servers.length===0)throw Error(`No tools matched the requested filters`);me(u)}})}catch(e){console.error(`Error executing search-tools: ${pe(e)}`),process.exit(1)}}),M=[`mcp-config.yaml`,`mcp-config.yml`,`mcp-config.json`],N=`/mcp`,P=`localhost`,F=`stdio`,I=`http`,L=`stdio-http`,R=`mcp-proxy-http`,z=`service`;function ge(){return m()}function B(){return ge()}function V(e){return e instanceof Error?e.message:String(e)}function H(e){return e===F||e===I||e===`sse`||e===L}function _e(e){return e===`meta`||e===`flat`||e===`search`}async function U(e){try{return await(0,n.access)(e,t.constants.F_OK),!0}catch{return!1}}async function W(){try{let e=process.env.PROJECT_PATH;if(e)for(let t of M){let n=(0,a.resolve)(e,t);if(await U(n))return n}let t=process.cwd();for(let e=0;e<=3;e++){for(let e of M){let n=(0,a.join)(t,e);if(await U(n))return n}let e=(0,a.dirname)(t);if(e===t)break;t=e}return null}catch(e){throw Error(`Failed to discover MCP config file: ${V(e)}`)}}function ve(e){try{let n=(0,t.readFileSync)(e,`utf-8`),i=(e.endsWith(`.yaml`)||e.endsWith(`.yml`)?r.default.load(n):JSON.parse(n))?.proxy;if(!i||typeof i!=`object`)return{};let a=i;return{type:typeof a.type==`string`?a.type:void 0,port:typeof a.port==`number`&&Number.isInteger(a.port)&&a.port>0?a.port:void 0,host:typeof a.host==`string`?a.host:void 0,keepAlive:typeof a.keepAlive==`boolean`?a.keepAlive:void 0}}catch{return{}}}async function ye(t,n){let r=e.o();if(t.id)return t.id;if(n)try{let e=await r.createConfigFetcherService({configFilePath:n,useCache:t.cache!==!1}).fetchConfiguration(t.cache===!1);if(e.id)return e.id}catch(e){throw Error(`Failed to resolve server ID from config '${n}': ${V(e)}`)}return e.w()}function be(e){if(!H(e))throw Error(`Unknown transport type: '${e}'. Valid options: ${F}, ${I}, sse, ${L}`);return e}function xe(e){if(!_e(e))throw Error(`Unknown proxy mode: '${e}'. Valid options: meta, flat, search`)}function G(e,t,n){let r=process.env.MCP_PORT?Number(process.env.MCP_PORT):void 0;return{mode:t,port:e.port??(Number.isFinite(r)?r:void 0)??n?.port,host:e.host??process.env.MCP_HOST??n?.host??P}}function K(){let e=(e,t)=>{if(t===void 0){console.error(e);return}console.error(e,t)};return{trace:e,debug:e,info:e,warn:e,error:e}}function Se(e,t,n){return{configFilePath:t,noCache:e.cache===!1,serverId:n,definitionsCachePath:e.definitionsCache,clearDefinitionsCache:e.clearDefinitionsCache,proxyMode:e.proxyMode}}function Ce(e,t,n,r){let i=V(r);return e===F?`Failed to start MCP server with transport '${e}': ${i}`:`Failed to start MCP server with transport '${e}' on ${n===void 0?`${t} (dynamic port)`:`${t}:${n}`}: ${i}`}function we(e,t,n,r,i){return{serverId:e,host:t.host??P,port:n,transport:`http`,shutdownToken:r,startedAt:new Date().toISOString(),pid:process.pid,configPath:i}}function q(){return new d.PortRegistryService(process.env.PORT_REGISTRY_PATH)}function J(){return process.env.NODE_ENV??`development`}async function Y(e,t,n,r,i,a,o=n===void 0?d.DEFAULT_PORT_RANGE:{min:n,max:n}){let s=q(),c=await s.reservePort({repositoryPath:B(),serviceName:e,serviceType:z,environment:J(),pid:process.pid,host:t,preferredPort:n,portRange:o,force:!0,metadata:{transport:i,serverId:r,...a?{configPath:a}:{}}});if(!c.success||!c.record){let e=n===void 0?`dynamic port`:`port ${n}`;throw Error(c.error||`Failed to reserve ${e} in port registry`)}let l=!1;return{port:c.record.port,release:async()=>{if(l)return;l=!0;let t=await s.releasePort({repositoryPath:B(),serviceName:e,serviceType:z,pid:process.pid,environment:J(),force:!0});if(!t.success&&t.error&&!t.error.includes(`No matching registry entry`))throw Error(t.error||`Failed to release port for ${e}`)}}}async function Te(e){e&&await e.release()}function Ee(e,t,n){return{serverId:e,shutdownToken:t,onShutdownRequested:n}}async function X(e,t){try{await e.remove(t)}catch(e){throw Error(`Failed to remove runtime state for '${t}': ${V(e)}`)}}async function De(e,t){try{await e.write(t)}catch(e){throw Error(`Failed to persist runtime state for '${t.serverId}': ${V(e)}`)}}async function Oe(e,t,n,r){try{try{await e.stop()}catch(e){throw Error(`Failed to stop owned HTTP transport '${n}': ${V(e)}`)}}finally{await r?.release({kill:!1}),await X(t,n)}}async function ke(e,t,n){await n?.release({kill:!1}),await X(e,t)}async function Ae(e,t,n,r){try{try{await e.stop()}catch(e){throw Error(`Failed to stop HTTP transport during cleanup for '${n}': ${V(e)}`)}}finally{await r?.release({kill:!1}),await X(t,n)}}async function Z(e,t){try{await e.start()}catch(e){throw Error(`Failed to start transport handler: ${V(e)}`)}let n=async n=>{console.error(`\nReceived ${n}, shutting down gracefully...`);try{await e.stop(),t&&await t(),process.exit(0)}catch(e){console.error(`Failed to gracefully stop transport during ${n}: ${V(e)}`),process.exit(1)}};process.on(`SIGINT`,async()=>await n(`SIGINT`)),process.on(`SIGTERM`,async()=>await n(`SIGTERM`))}async function je(t,n,r){let a=await e.u(t),s=new e.b,c=(0,i.randomUUID)(),l=t.serverId??e.w(),u=n.port,f=u===void 0?d.DEFAULT_PORT_RANGE:{min:u,max:u},p=await Y(R,n.host??P,u,l,I,r,f),m=p.port,h={...n,port:m},g=await(0,o.createProcessLease)({repositoryPath:B(),serviceName:`mcp-proxy-http`,serviceType:`service`,environment:J(),host:h.host??P,port:m,command:process.argv[1],args:process.argv.slice(2),metadata:{transport:I,serverId:l,...r?{configPath:r}:{}}}),_=async()=>{await Te(p??null),_=async()=>void 0},v=we(l,h,m,c,r),y,b=!1,x=async()=>{if(!b){b=!0;try{await Oe(y,s,v.serverId,g),await _(),await a.dispose(),process.exit(0)}catch(e){throw Error(`Failed to stop HTTP runtime '${v.serverId}' from admin shutdown: ${V(e)}`)}}};try{y=new e.m(()=>e.r(a),h,Ee(v.serverId,c,x))}catch(e){throw await _(),await g.release({kill:!1}),await a.dispose(),Error(`Failed to create HTTP runtime server: ${V(e)}`)}try{await Z(y,async()=>{await _(),await a.dispose(),await ke(s,v.serverId,g)}),await De(s,v)}catch(e){throw await _(),await a.dispose(),await Ae(y,s,v.serverId,g),Error(`Failed to start HTTP runtime '${v.serverId}': ${V(e)}`)}console.error(`Runtime state: http://${v.host}:${v.port} (${v.serverId})`)}async function Me(t){let n;try{n=await e.n(t),await Z(new e.f(n,K()),async()=>{await n?.dispose?.()})}catch(e){throw await n?.dispose?.(),Error(`Failed to start stdio transport: ${V(e)}`)}}async function Ne(t,n){try{let r=n.port,i=r===void 0?d.DEFAULT_PORT_RANGE:{min:r,max:r},a=await Y(`mcp-proxy-sse`,n.host??P,r,t.serverId??e.w(),`sse`,void 0,i),o={...n,port:a.port},s=new e.p(await e.n(t),o),c=async()=>{await s.stop(),await a.release()};process.on(`SIGINT`,c),process.on(`SIGTERM`,c),await Z(s)}catch(e){throw Error(`Failed to start SSE transport: ${V(e)}`)}}async function Q(e,t,n){let r=B();if(e.port!==void 0)return{endpoint:new URL(`http://${e.host??P}:${e.port}${N}`)};let i=q(),a=await i.getPort({repositoryPath:r,serviceName:R,serviceType:z,environment:J()});if(a.success&&a.record){let t=e.host??a.record.host,n=new URL(`http://${t}:${a.record.port}${N}`);try{let e=`http://${t}:${a.record.port}/health`;if((await fetch(e)).ok)return{endpoint:n}}catch{}await i.releasePort({repositoryPath:r,serviceName:R,serviceType:z,environment:J(),force:!0})}let o=await S({host:e.host??P,config:t.config||n,cache:t.cache,definitionsCache:t.definitionsCache,clearDefinitionsCache:t.clearDefinitionsCache,proxyMode:t.proxyMode});return{endpoint:new URL(`http://${o.host}:${o.port}${N}`),ownedRuntimeServerId:o.reusedExistingRuntime?void 0:o.serverId}}async function Pe(e,t,n){let{endpoint:r}=await Q(e,t,n);return r}async function Fe(t,n,r,i){let a,o=i?.keepAlive??!1;try{let i=await Q(t,n,r);a=i.ownedRuntimeServerId;let{endpoint:s}=i;await Z(new e.d({endpoint:s,resolveEndpoint:async()=>await Pe(t,n,r)},K()),async()=>{o||!a||await new e.v().stop({serverId:a,force:!0})})}catch(t){if(!o&&a){let n=new e.v;try{await n.stop({serverId:a,force:!0})}catch(e){throw Error(`Failed to start stdio-http transport: ${V(t)}; also failed to stop owned HTTP runtime '${a}': ${V(e)}`)}}throw Error(`Failed to start stdio-http transport: ${V(t)}`)}}async function Ie(t,n,r,i,a){try{if(t===F){await Me(i);return}if(t===I){await je(i,G(n,e.t.HTTP,a),r);return}if(t===`sse`){await Ne(i,G(n,e.t.SSE,a));return}await Fe(G(n,e.t.HTTP,a),n,r,a)}catch(e){throw Error(`Failed to start transport '${t}': ${V(e)}`)}}async function Le(e,t){try{te(await S({id:e.id,host:e.host??P,port:e.port,config:e.config||t,cache:e.cache,definitionsCache:e.definitionsCache,clearDefinitionsCache:e.clearDefinitionsCache,proxyMode:e.proxyMode,timeoutMs:e.timeoutMs}))}catch(t){console.error(`Failed to prestart HTTP runtime '${e.id||`generated-server-id`}': ${V(t)}`),process.exit(1)}}const Re=new l.Command(`mcp-serve`).description(`Start MCP server with specified transport or prestart the HTTP runtime in the background`).option(`-t, --type <type>`,`Transport type: ${F}, ${I}, sse, or ${L}`).option(`-p, --port <port>`,`Port to listen on (http/sse) or backend port for stdio-http`,e=>Number.parseInt(e,10)).option(`--host <host>`,`Host to bind to (http/sse) or backend host for stdio-http`).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`,!1).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)`).option(`--prestart-http`,`Prestart the HTTP runtime in the background and exit after it becomes healthy`,!1).option(`--timeout-ms <ms>`,`How long to wait for the HTTP runtime to become healthy`,`120000`).action(async e=>{try{if(e.prestartHttp){await Le(e,e.config||await W()||void 0);return}let t=e.config||await W()||void 0,n=t?ve(t):{},r=be((e.type??n.type??F).toLowerCase());xe(e.proxyMode),await Ie(r,e,t,Se(e,t,await ye(e,t)),n)}catch(t){let n=(e.type??F).toLowerCase(),r=H(n)?n:F,i=process.env.MCP_PORT?Number(process.env.MCP_PORT):void 0,a=e.port??(Number.isFinite(i)?i:void 0);console.error(Ce(r,e.host??P,a,t)),process.exit(1)}}),ze=new l.Command(`prefetch`).description(`Pre-download packages used by MCP servers (npx, pnpx, uvx, uv)`).option(`-c, --config <path>`,`Path to MCP server configuration file`).option(`-p, --parallel`,`Run prefetch commands in parallel`,!1).option(`-d, --dry-run`,`Show what would be prefetched without executing`,!1).option(`-f, --filter <type>`,`Filter by package manager type: npx, pnpx, uvx, or uv`).option(`--definitions-out <path>`,`Write discovered definitions to a JSON or YAML cache file`).option(`--skip-packages`,`Skip package prefetch and only build definitions cache`,!1).option(`--clear-definitions-cache`,`Delete the definitions cache file before continuing`,!1).action(async t=>{try{let n=e.o(),r=t.config||e.T();r||(k.error(`No MCP configuration file found.`),k.info(`Use --config <path> to specify a config file, or run "mcp-proxy init" to create one.`),process.exit(1)),k.info(`Loading configuration from: ${r}`);let i=await n.createConfigFetcherService({configFilePath:r,useCache:!1}).fetchConfiguration(!0),a=i.id||e.w(),o=e.C.generateConfigHash(i),s=t.definitionsOut||e.C.getDefaultCachePath(r),c=n.createPrefetchService({mcpConfig:i,filter:t.filter,parallel:t.parallel}),l=c.extractPackages(),u=!t.skipPackages,d=!!t.definitionsOut;if(t.clearDefinitionsCache&&(t.dryRun?k.info(`Would clear definitions cache: ${s}`):(await e.C.clearFile(s),k.success(`Cleared definitions cache: ${s}`))),u)if(l.length===0)k.warning(`No packages found to prefetch.`),k.info(`Prefetch supports: npx, pnpx, uvx, and uv run commands`);else{k.info(`Found ${l.length} package(s) to prefetch:`);for(let e of l)k.item(`${e.serverName}: ${e.packageManager} ${e.packageName}`)}if(!u&&!d){k.warning(`Nothing to do. Use package prefetch or provide --definitions-out.`);return}if(t.dryRun){if(u&&l.length>0){k.newline(),k.header(`Dry run mode - commands that would be executed:`);for(let e of l)k.indent(e.fullCommand.join(` `))}d&&(k.newline(),k.info(`Would write definitions cache to: ${s}`));return}let f=!1;if(u&&l.length>0){k.newline(),k.info(`Prefetching packages...`);let e=await c.prefetch();if(k.newline(),e.failed===0?k.success(`Package prefetch complete: ${e.successful} succeeded, ${e.failed} failed`):k.warning(`Package prefetch complete: ${e.successful} succeeded, ${e.failed} failed`),e.failed>0){f=!0,k.newline(),k.error(`Failed packages:`);for(let t of e.results.filter(e=>!e.success))k.item(`${t.package.serverName} (${t.package.packageName}): ${t.output.trim()}`)}}if(d){k.newline(),k.info(`Collecting definitions cache...`);let t=n.createClientManagerService(),c=i.skills?.paths||[],l=c.length>0?n.createSkillService(process.cwd(),c):void 0,u=n.createDefinitionsCacheService(t,l);await Promise.all(Object.entries(i.mcpServers).map(async([e,n])=>{try{await t.connectToServer(e,n),k.item(`Connected for definitions: ${e}`)}catch(t){k.warning(`Failed to connect for definitions: ${e} (${t instanceof Error?t.message:String(t)})`)}}));let d=await u.collectForCache({configPath:r,configHash:o,oneMcpVersion:e.D,serverId:a});await e.C.writeToFile(s,d),k.success(`Definitions cache written: ${s} (${Object.keys(d.servers).length} servers, ${d.skills.length} skills)`),d.failures.length>0&&k.warning(`Definitions cache completed with ${d.failures.length} server failure(s)`),await t.disconnectAll()}f&&process.exit(1)}catch(e){k.error(`Error executing prefetch: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}});function $(e){return e instanceof Error?e.message:String(e)}const Be=new l.Command(`read-resource`).description(`Read a resource by URI from a connected MCP server`).argument(`<uri>`,`Resource URI to read`).option(`-c, --config <path>`,`Path to MCP server configuration file`).option(`-s, --server <name>`,`Server name (required if resource exists on multiple servers)`).option(`-j, --json`,`Output as JSON`,!1).action(async(e,t)=>{try{await w(t,async({clientManager:n})=>{let r=n.getAllClients();if(t.server){let r=n.getClient(t.server);if(!r)throw Error(`Server "${t.server}" not found`);t.json||console.error(`Reading ${e} from ${t.server}...`);let i=await r.readResource(e);if(t.json)console.log(JSON.stringify(i,null,2));else for(let e of i.contents)`text`in e?console.log(e.text):console.log(JSON.stringify(e,null,2));return}let i=await Promise.all(r.map(async t=>{try{let n=(await t.listResources()).some(t=>t.uri===e);return{serverName:t.serverName,hasResource:n,error:null}}catch(e){return{serverName:t.serverName,hasResource:!1,error:e}}})),a=[];for(let{serverName:e,hasResource:t,error:n}of i){if(n){console.error(`Failed to list resources from ${e}: ${$(n)}`);continue}t&&a.push(e)}if(a.length===0)throw Error(`Resource "${e}" not found on any connected server`);if(a.length>1)throw Error(`Resource "${e}" found on multiple servers: ${a.join(`, `)}. Use --server to disambiguate`);let o=a[0],s=n.getClient(o);if(!s)throw Error(`Internal error: Server "${o}" not connected`);t.json||console.error(`Reading ${e} from ${o}...`);let c=await s.readResource(e);if(t.json)console.log(JSON.stringify(c,null,2));else for(let e of c.contents)`text`in e?console.log(e.text):console.log(JSON.stringify(e,null,2))})}catch(e){console.error(`Error executing read-resource: ${$(e)}`),process.exit(1)}});function Ve(e){return e instanceof Error?e.message:String(e)}function He(e){console.log(`Stopped mcp-proxy server '${e.serverId}'.`),console.log(`Endpoint: http://${e.host}:${e.port}`),console.log(`Result: ${e.message}`)}const Ue=new l.Command(`stop`).description(`Stop a running HTTP mcp-proxy server`).option(`--id <id>`,`Target server ID from the runtime registry`).option(`--host <host>`,`Target runtime host`).option(`--port <port>`,`Target runtime port`,e=>Number.parseInt(e,10)).option(`-c, --config <path>`,`Reserved for future config-based targeting support`).option(`--token <token>`,`Override the persisted shutdown token`).option(`--force`,`Skip server ID verification against the /health response`,!1).option(`-j, --json`,`Output as JSON`,!1).option(`--timeout <ms>`,`Maximum time to wait for shutdown completion`,e=>Number.parseInt(e,10),5e3).action(async t=>{try{t.config&&console.error(`Warning: --config is not used yet; runtime resolution uses the persisted registry.`);let n=await e.o().createStopServerService().stop({serverId:t.id,host:t.host,port:t.port,token:t.token,force:t.force,timeoutMs:t.timeout});if(t.json){console.log(JSON.stringify(n,null,2));return}He(n)}catch(e){let n=`Error executing stop: ${Ve(e)}`;t.json?console.log(JSON.stringify({ok:!1,error:n},null,2)):console.error(n),process.exit(1)}});function We(e){return e instanceof Error?e.message:String(e)}const Ge=new l.Command(`use-tool`).description(`Execute an MCP tool with arguments`).argument(`<toolName>`,`Tool name to execute`).option(`-c, --config <path>`,`Path to MCP server configuration file`).option(`-s, --server <name>`,`Server name (required if tool exists on multiple servers)`).option(`-a, --args <json>`,`Tool arguments as JSON string`,`{}`).option(`-t, --timeout <ms>`,`Request timeout in milliseconds for tool execution (default: 60000)`,Number.parseInt).option(`-j, --json`,`Output as JSON`,!1).action(async(e,t)=>{try{let n={};try{n=JSON.parse(t.args)}catch{console.error(`Error: Invalid JSON in --args`),process.exit(1)}await w(t,async({container:r,config:i,clientManager:a})=>{let o=a.getAllClients();if(t.server){let r=a.getClient(t.server);if(!r)throw Error(`Server "${t.server}" not found`);t.json||console.error(`Executing ${e} on ${t.server}...`);let i=t.timeout?{timeout:t.timeout}:void 0,o=await r.callTool(e,n,i);if(t.json)console.log(JSON.stringify(o,null,2));else{if(console.log(`
+Result:`),o.content)for(let e of o.content)e.type===`text`?console.log(e.text):console.log(JSON.stringify(e,null,2));o.isError&&(console.error(`
+⚠️  Tool execution returned an error`),process.exit(1))}return}let s=await Promise.all(o.map(async t=>{try{let n=(await t.listTools()).some(t=>t.name===e);return{serverName:t.serverName,hasTool:n,error:null}}catch(e){return{serverName:t.serverName,hasTool:!1,error:e}}})),c=[];for(let{serverName:e,hasTool:n,error:r}of s){if(r){t.json||console.error(`Failed to list tools from ${e}:`,r);continue}n&&c.push(e)}if(c.length===0){let n=i.skills?.paths||[];if(n.length>0)try{let i=process.env.PROJECT_PATH||process.cwd(),a=r.createSkillService(i,n),o=e.startsWith(`skill__`)?e.slice(7):e,s=await a.getSkill(o);if(s){let e={content:[{type:`text`,text:s.content}]};t.json?console.log(JSON.stringify(e,null,2)):(console.log(`
+Skill content:`),console.log(s.content));return}}catch(n){t.json||console.error(`Failed to lookup skill "${e}":`,n)}throw Error(`Tool or skill "${e}" not found on any connected server or configured skill paths`)}if(c.length>1)throw Error(`Tool "${e}" found on multiple servers: ${c.join(`, `)}`);let l=c[0],u=a.getClient(l);if(!u)throw Error(`Internal error: Server "${l}" not connected`);t.json||console.error(`Executing ${e} on ${l}...`);let d=t.timeout?{timeout:t.timeout}:void 0,f=await u.callTool(e,n,d);if(t.json)console.log(JSON.stringify(f,null,2));else{if(console.log(`
+Result:`),f.content)for(let e of f.content)e.type===`text`?console.log(e.text):console.log(JSON.stringify(e,null,2));f.isError&&(console.error(`
+⚠️  Tool execution returned an error`),process.exit(1))}})}catch(e){console.error(`Error executing use-tool: ${We(e)}`),process.exit(1)}});async function Ke(){try{let t=new l.Command;t.name(`mcp-proxy`).description(`MCP proxy server package`).version(e.D),t.addCommand(ue),t.addCommand(Re),t.addCommand(he),t.addCommand(oe),t.addCommand(Ge),t.addCommand(fe),t.addCommand(Be),t.addCommand(de),t.addCommand(se),t.addCommand(ze),t.addCommand(Ue),await t.parseAsync(process.argv)}catch(e){console.error(`CLI execution failed: ${e instanceof Error?e.message:e}`),process.exit(1)}}Ke().catch(e=>{console.error(`Fatal error: ${e instanceof Error?e.message:e}`),process.exit(1)});