@agimon-ai/mcp-proxy 0.4.8 → 0.4.10

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_src = require('./src-CTeN-GJT.cjs');
+const require_src = require('./src-5rGDc0sh.cjs');
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
@@ -138,6 +138,27 @@ function resolveWorkspaceRoot(startPath = process.env.PROJECT_PATH || process.cw
 		current = parent;
 	}
 }
+const PROCESS_REGISTRY_SERVICE_HTTP$1 = "mcp-proxy-http";
+async function findExistingHealthyRuntime(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;
+	try {
+		const healthUrl = `http://${match.host}:${match.port}/health`;
+		if ((await fetch(healthUrl)).ok) {
+			const metadata = match.metadata;
+			return {
+				host: match.host,
+				port: match.port,
+				serverId: metadata?.serverId ?? "unknown",
+				workspaceRoot
+			};
+		}
+	} catch {}
+	return null;
+}
 function resolveSiblingRegistryPath(registryPath, fileName) {
 	if (!registryPath) return;
 	const resolved = node_path.default.resolve(registryPath);
@@ -217,11 +238,33 @@ function spawnBackgroundRuntime(args, env, cwd) {
 	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 findExistingHealthyRuntime(workspaceRoot);
+	if (existing) return existing;
+	await stopExistingRuntime(new require_src.RuntimeStateService(), options.id, options.host, options.port);
 	const childEnv = {
 		...process.env,
 		...registryPath ? {
@@ -261,7 +304,7 @@ async function prestartHttpRuntime(options) {
 			workspaceRoot
 		};
 	} catch (error) {
-		throw new Error(`Failed to prestart HTTP runtime '${serverId}': ${error instanceof Error ? error.message : String(error)}`);
+		throw new Error(`Failed to prestart HTTP runtime '${serverId}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
 	}
 }
 const prestartHttpCommand = new commander.Command("prestart-http").description("Start an mcp-proxy HTTP runtime in the background and wait until it is healthy").option("--id <id>", "Server identifier to assign to the runtime").option("--host <host>", "Host to bind to", DEFAULT_HOST$1).option("-p, --port <port>", "Preferred HTTP port for the runtime", (value) => Number.parseInt(value, 10)).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--registry-path <path>", "Custom registry path or directory for service discovery").option("--registry-dir <path>", "Custom registry directory for service discovery").option("--timeout-ms <ms>", "How long to wait for the runtime to become healthy", String(DEFAULT_TIMEOUT_MS)).action(async (options) => {
@@ -272,7 +315,7 @@ const prestartHttpCommand = new commander.Command("prestart-http").description("
 		process.stdout.write(`runtimeUrl=http://${host}:${port}\n`);
 		process.stdout.write(`workspaceRoot=${workspaceRoot}\n`);
 	} catch (error) {
-		throw new Error(`Failed to prestart HTTP runtime '${options.id || "generated-server-id"}': ${error instanceof Error ? error.message : String(error)}`);
+		throw new Error(`Failed to prestart HTTP runtime '${options.id || "generated-server-id"}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
 	}
 });
 
@@ -672,7 +715,24 @@ async function startStdioTransport(serverOptions) {
 }
 async function startSseTransport(serverOptions, config) {
 	try {
-		await startServer(new require_src.SseTransportHandler(await require_src.createServer(serverOptions), config));
+		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$9(error)}`);
 	}

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { D as findConfigFile, E as generateServerId, T as DefinitionsCacheService, d as version, f as StdioHttpTransportHandler, h as HttpTransportHandler, m as SseTransportHandler, n as createServer, o as createProxyIoCContainer, p as StdioTransportHandler, r as createSessionServer, t as TRANSPORT_MODE, u as initializeSharedServices, v as RuntimeStateService } from "./src-koR2D9Bb.mjs";
+import { D as findConfigFile, E as generateServerId, T as DefinitionsCacheService, _ as StopServerService, d as version, f as StdioHttpTransportHandler, h as HttpTransportHandler, m as SseTransportHandler, n as createServer, o as createProxyIoCContainer, p as StdioTransportHandler, r as createSessionServer, t as TRANSPORT_MODE, u as initializeSharedServices, v as RuntimeStateService } from "./src-BErGW2ax.mjs";
 import { randomUUID } from "node:crypto";
 import { access, writeFile } from "node:fs/promises";
 import path, { join, resolve } from "node:path";
@@ -137,6 +137,27 @@ function resolveWorkspaceRoot(startPath = process.env.PROJECT_PATH || process.cw
 		current = parent;
 	}
 }
+const PROCESS_REGISTRY_SERVICE_HTTP$1 = "mcp-proxy-http";
+async function findExistingHealthyRuntime(workspaceRoot) {
+	const match = (await new ProcessRegistryService(process.env.PROCESS_REGISTRY_PATH).listProcesses({
+		repositoryPath: workspaceRoot,
+		serviceName: PROCESS_REGISTRY_SERVICE_HTTP$1
+	}))[0];
+	if (!match?.host || !match?.port) return null;
+	try {
+		const healthUrl = `http://${match.host}:${match.port}/health`;
+		if ((await fetch(healthUrl)).ok) {
+			const metadata = match.metadata;
+			return {
+				host: match.host,
+				port: match.port,
+				serverId: metadata?.serverId ?? "unknown",
+				workspaceRoot
+			};
+		}
+	} catch {}
+	return null;
+}
 function resolveSiblingRegistryPath(registryPath, fileName) {
 	if (!registryPath) return;
 	const resolved = path.resolve(registryPath);
@@ -216,11 +237,33 @@ function spawnBackgroundRuntime(args, env, cwd) {
 	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 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 || generateServerId();
 	const timeoutMs = parseTimeoutMs(options.timeoutMs);
 	const registryPath = options.registryPath || options.registryDir;
 	const workspaceRoot = resolveWorkspaceRoot();
+	const existing = await findExistingHealthyRuntime(workspaceRoot);
+	if (existing) return existing;
+	await stopExistingRuntime(new RuntimeStateService(), options.id, options.host, options.port);
 	const childEnv = {
 		...process.env,
 		...registryPath ? {
@@ -260,7 +303,7 @@ async function prestartHttpRuntime(options) {
 			workspaceRoot
 		};
 	} catch (error) {
-		throw new Error(`Failed to prestart HTTP runtime '${serverId}': ${error instanceof Error ? error.message : String(error)}`);
+		throw new Error(`Failed to prestart HTTP runtime '${serverId}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
 	}
 }
 const prestartHttpCommand = new Command("prestart-http").description("Start an mcp-proxy HTTP runtime in the background and wait until it is healthy").option("--id <id>", "Server identifier to assign to the runtime").option("--host <host>", "Host to bind to", DEFAULT_HOST$1).option("-p, --port <port>", "Preferred HTTP port for the runtime", (value) => Number.parseInt(value, 10)).option("-c, --config <path>", "Path to MCP server configuration file").option("--no-cache", "Disable configuration caching, always reload from config file").option("--definitions-cache <path>", "Path to prefetched tool/prompt/skill definitions cache file").option("--clear-definitions-cache", "Delete definitions cache before startup", false).option("--proxy-mode <mode>", "How mcp-proxy exposes downstream tools: meta, flat, or search", "meta").option("--registry-path <path>", "Custom registry path or directory for service discovery").option("--registry-dir <path>", "Custom registry directory for service discovery").option("--timeout-ms <ms>", "How long to wait for the runtime to become healthy", String(DEFAULT_TIMEOUT_MS)).action(async (options) => {
@@ -271,7 +314,7 @@ const prestartHttpCommand = new Command("prestart-http").description("Start an m
 		process.stdout.write(`runtimeUrl=http://${host}:${port}\n`);
 		process.stdout.write(`workspaceRoot=${workspaceRoot}\n`);
 	} catch (error) {
-		throw new Error(`Failed to prestart HTTP runtime '${options.id || "generated-server-id"}': ${error instanceof Error ? error.message : String(error)}`);
+		throw new Error(`Failed to prestart HTTP runtime '${options.id || "generated-server-id"}': ${error instanceof Error ? error.message : String(error)}`, { cause: error });
 	}
 });
 
@@ -671,7 +714,24 @@ async function startStdioTransport(serverOptions) {
 }
 async function startSseTransport(serverOptions, config) {
 	try {
-		await startServer(new SseTransportHandler(await createServer(serverOptions), config));
+		const requestedPort = config.port;
+		const portRange = requestedPort !== void 0 ? {
+			min: requestedPort,
+			max: requestedPort
+		} : DEFAULT_PORT_RANGE;
+		const portLease = await createPortRegistryLease("mcp-proxy-sse", config.host ?? DEFAULT_HOST, requestedPort, serverOptions.serverId ?? generateServerId(), TRANSPORT_TYPE_SSE, void 0, portRange);
+		const resolvedConfig = {
+			...config,
+			port: portLease.port
+		};
+		const handler = new SseTransportHandler(await 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$9(error)}`);
 	}

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_src = require('./src-CTeN-GJT.cjs');
+const require_src = require('./src-5rGDc0sh.cjs');
 
 exports.ConfigFetcherService = require_src.ConfigFetcherService;
 exports.DefinitionsCacheService = require_src.DefinitionsCacheService;

package/dist/index.d.cts

@@ -50,7 +50,7 @@ type TransportMode = (typeof TRANSPORT_MODE)[keyof typeof TRANSPORT_MODE];
  */
 interface TransportConfig {
   mode: TransportMode;
-  port?: number;
+  port: number;
   host?: string;
 }
 /**
@@ -1125,7 +1125,7 @@ declare class HttpTransportHandler implements HttpTransportHandler$1 {
   private adminOptions?;
   private adminRateLimiter;
   private logger;
-  constructor(serverFactory: (() => Server | Promise<Server>), config: TransportConfig, adminOptions?: HttpTransportAdminOptions, logger?: LoggerLike);
+  constructor(serverFactory: () => Server | Promise<Server>, config: TransportConfig, adminOptions?: HttpTransportAdminOptions, logger?: LoggerLike);
   private setupMiddleware;
   private setupRoutes;
   private isAuthorizedShutdownRequest;

package/dist/index.d.mts

@@ -51,7 +51,7 @@ type TransportMode = (typeof TRANSPORT_MODE)[keyof typeof TRANSPORT_MODE];
  */
 interface TransportConfig {
   mode: TransportMode;
-  port?: number;
+  port: number;
   host?: string;
 }
 /**
@@ -1126,7 +1126,7 @@ declare class HttpTransportHandler implements HttpTransportHandler$1 {
   private adminOptions?;
   private adminRateLimiter;
   private logger;
-  constructor(serverFactory: (() => Server | Promise<Server>), config: TransportConfig, adminOptions?: HttpTransportAdminOptions, logger?: LoggerLike);
+  constructor(serverFactory: () => Server | Promise<Server>, config: TransportConfig, adminOptions?: HttpTransportAdminOptions, logger?: LoggerLike);
   private setupMiddleware;
   private setupRoutes;
   private isAuthorizedShutdownRequest;

package/dist/index.mjs

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

package/dist/{src-CTeN-GJT.cjs → src-5rGDc0sh.cjs}

@@ -3778,7 +3778,7 @@ var HttpTransportHandler = class {
 		this.sessionManager = new HttpFullSessionManager();
 		this.config = {
 			mode: config.mode,
-			port: config.port ?? 3e3,
+			port: config.port,
 			host: config.host ?? "localhost"
 		};
 		this.adminOptions = adminOptions;
@@ -4063,7 +4063,7 @@ var SseTransportHandler = class {
 		this.sessionManager = new SseSessionManager();
 		this.config = {
 			mode: config.mode,
-			port: config.port ?? 3e3,
+			port: config.port,
 			host: config.host ?? "localhost"
 		};
 		this.logger = logger;
@@ -4342,7 +4342,7 @@ var StdioHttpTransportHandler = class {
 
 //#endregion
 //#region package.json
-var version = "0.4.6";
+var version = "0.4.9";
 
 //#endregion
 //#region src/container/index.ts

package/dist/{src-koR2D9Bb.mjs → src-BErGW2ax.mjs}

@@ -3749,7 +3749,7 @@ var HttpTransportHandler = class {
 		this.sessionManager = new HttpFullSessionManager();
 		this.config = {
 			mode: config.mode,
-			port: config.port ?? 3e3,
+			port: config.port,
 			host: config.host ?? "localhost"
 		};
 		this.adminOptions = adminOptions;
@@ -4034,7 +4034,7 @@ var SseTransportHandler = class {
 		this.sessionManager = new SseSessionManager();
 		this.config = {
 			mode: config.mode,
-			port: config.port ?? 3e3,
+			port: config.port,
 			host: config.host ?? "localhost"
 		};
 		this.logger = logger;
@@ -4313,7 +4313,7 @@ var StdioHttpTransportHandler = class {
 
 //#endregion
 //#region package.json
-var version = "0.4.6";
+var version = "0.4.9";
 
 //#endregion
 //#region src/container/index.ts

package/package.json

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