@airmcp-dev/gateway 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+   Copyright 2026 CodePedia Labs (labs@codepedia.kr)

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { McpProxy } from './proxy/index.js';
+export { SessionPool } from './proxy/index.js';
+export { ServerRegistry } from './registry/index.js';
+export { ToolIndex } from './registry/index.js';
+export { HealthChecker } from './registry/index.js';
+export { RequestRouter } from './router/index.js';
+export { LoadBalancer } from './router/index.js';
+export type { ServerEntry, StdioConnection, HttpConnection, ServerConnection, ServerStatus, ToolEntry, RouteRequest, RouteResult, HealthCheckResult, BalancerStrategy, GatewayConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — index.ts
+// re-export only. 로직 없음.
+// ── Proxy ──
+export { McpProxy } from './proxy/index.js';
+export { SessionPool } from './proxy/index.js';
+// ── Registry ──
+export { ServerRegistry } from './registry/index.js';
+export { ToolIndex } from './registry/index.js';
+export { HealthChecker } from './registry/index.js';
+// ── Router ──
+export { RequestRouter } from './router/index.js';
+export { LoadBalancer } from './router/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,iCAAiC;AACjC,yBAAyB;AAEzB,cAAc;AACd,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/proxy/index.d.ts

@@ -0,0 +1,5 @@
+export { McpProxy } from './mcp-proxy.js';
+export { SessionPool } from './session-pool.js';
+export type { Session } from './session-pool.js';
+export { buildToolCallRequest, buildListToolsRequest, extractResult, resolveTransportMethod, } from './protocol-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,GACvB,MAAM,uBAAuB,CAAC"}

package/dist/proxy/index.js

@@ -0,0 +1,7 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — proxy/index.ts
+// re-export only.
+export { McpProxy } from './mcp-proxy.js';
+export { SessionPool } from './session-pool.js';
+export { buildToolCallRequest, buildListToolsRequest, extractResult, resolveTransportMethod, } from './protocol-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,uCAAuC;AACvC,kBAAkB;AAElB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,GACvB,MAAM,uBAAuB,CAAC"}

package/dist/proxy/mcp-proxy.d.ts

@@ -0,0 +1,53 @@
+import type { GatewayConfig, ServerConnection } from '../types.js';
+import { ServerRegistry } from '../registry/server-registry.js';
+import { ToolIndex } from '../registry/tool-index.js';
+import { HealthChecker } from '../registry/health-checker.js';
+import { RequestRouter } from '../router/request-router.js';
+export declare class McpProxy {
+    readonly registry: ServerRegistry;
+    readonly toolIndex: ToolIndex;
+    readonly router: RequestRouter;
+    readonly healthChecker: HealthChecker;
+    private sessionPool;
+    private config;
+    constructor(config?: GatewayConfig);
+    /**
+     * 하위 MCP 서버를 등록한다.
+     */
+    addServer(id: string, name: string, connection: ServerConnection): void;
+    /**
+     * 서버를 제거한다.
+     */
+    removeServer(id: string): void;
+    /**
+     * 서버의 도구를 발견하고 인덱싱한다.
+     */
+    registerTools(serverId: string, tools: Array<{
+        name: string;
+        description?: string;
+        inputSchema?: any;
+    }>): void;
+    /**
+     * 도구를 호출한다 (프록시 핵심).
+     */
+    callTool(toolName: string, params: Record<string, any>): Promise<any>;
+    /**
+     * Gateway를 시작한다.
+     */
+    start(): Promise<void>;
+    /**
+     * Gateway를 중지한다.
+     */
+    stop(): Promise<void>;
+    /**
+     * 현재 상태를 반환한다.
+     */
+    status(): {
+        name: string;
+        servers: number;
+        tools: number;
+        sessions: number;
+        health: import("../types.js").HealthCheckResult[];
+    };
+}
+//# sourceMappingURL=mcp-proxy.d.ts.map

package/dist/proxy/mcp-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/mcp-proxy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAa,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAK5D,qBAAa,QAAQ;IACnB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,GAAE,aAAkB;IAiBtC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAKvE;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAM9B;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,GACtE,IAAI;IAeP;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAyC3E;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACH,MAAM;;;;;;;CASP"}

package/dist/proxy/mcp-proxy.js

@@ -0,0 +1,131 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — proxy/mcp-proxy.ts
+//
+// MCP 리버스 프록시.
+// 클라이언트의 도구 호출을 받아서 적절한 하위 서버로 전달하고 결과를 반환.
+// ServerRegistry + ToolIndex + RequestRouter + SessionPool을 조합.
+import { ServerRegistry } from '../registry/server-registry.js';
+import { ToolIndex } from '../registry/tool-index.js';
+import { HealthChecker } from '../registry/health-checker.js';
+import { RequestRouter } from '../router/request-router.js';
+import { LoadBalancer } from '../router/load-balancer.js';
+import { SessionPool } from './session-pool.js';
+import { buildToolCallRequest, extractResult } from './protocol-adapter.js';
+export class McpProxy {
+    registry;
+    toolIndex;
+    router;
+    healthChecker;
+    sessionPool;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            name: config.name || 'air-gateway',
+            port: config.port || 4000,
+            healthCheckInterval: config.healthCheckInterval || 30_000,
+            balancer: config.balancer || 'round-robin',
+            requestTimeout: config.requestTimeout || 30_000,
+        };
+        this.registry = new ServerRegistry();
+        this.toolIndex = new ToolIndex();
+        const balancer = new LoadBalancer(this.config.balancer);
+        this.router = new RequestRouter(this.registry, this.toolIndex, balancer);
+        this.healthChecker = new HealthChecker(this.registry, this.config.healthCheckInterval);
+        this.sessionPool = new SessionPool();
+    }
+    /**
+     * 하위 MCP 서버를 등록한다.
+     */
+    addServer(id, name, connection) {
+        const entry = this.registry.register(id, name, connection);
+        entry.status = 'connected'; // 초기 상태
+    }
+    /**
+     * 서버를 제거한다.
+     */
+    removeServer(id) {
+        this.toolIndex.removeServer(id);
+        this.sessionPool.destroyByServer(id);
+        this.registry.unregister(id);
+    }
+    /**
+     * 서버의 도구를 발견하고 인덱싱한다.
+     */
+    registerTools(serverId, tools) {
+        const toolEntries = tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            serverId,
+            inputSchema: t.inputSchema,
+        }));
+        this.registry.updateTools(serverId, toolEntries);
+        const server = this.registry.get(serverId);
+        if (server) {
+            this.toolIndex.reindex(server);
+        }
+    }
+    /**
+     * 도구를 호출한다 (프록시 핵심).
+     */
+    async callTool(toolName, params) {
+        // 라우팅
+        const { server, tool } = this.router.route({ toolName, params });
+        // 세션 획득
+        const session = this.sessionPool.acquire(server);
+        try {
+            // JSON-RPC 요청 구성
+            const request = buildToolCallRequest(toolName, params);
+            // transport에 따라 실행 (여기서는 HTTP 예시)
+            if (server.connection.type === 'http' || server.connection.type === 'sse') {
+                const url = server.connection.url;
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), this.config.requestTimeout);
+                try {
+                    const res = await fetch(url, {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify(request.jsonrpc),
+                        signal: controller.signal,
+                    });
+                    clearTimeout(timeout);
+                    const response = await res.json();
+                    return extractResult(response);
+                }
+                catch (err) {
+                    clearTimeout(timeout);
+                    throw err;
+                }
+            }
+            // stdio는 프로세스에 stdin/stdout으로 통신 (향후 구현)
+            throw new Error(`stdio proxy not yet implemented for server "${server.id}"`);
+        }
+        finally {
+            this.sessionPool.release(session.id);
+        }
+    }
+    /**
+     * Gateway를 시작한다.
+     */
+    async start() {
+        this.healthChecker.start();
+    }
+    /**
+     * Gateway를 중지한다.
+     */
+    async stop() {
+        this.healthChecker.stop();
+    }
+    /**
+     * 현재 상태를 반환한다.
+     */
+    status() {
+        return {
+            name: this.config.name,
+            servers: this.registry.size,
+            tools: this.toolIndex.size,
+            sessions: this.sessionPool.size,
+            health: this.healthChecker.getAllResults(),
+        };
+    }
+}
+//# sourceMappingURL=mcp-proxy.js.map

package/dist/proxy/mcp-proxy.js.map

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

package/dist/proxy/protocol-adapter.d.ts

@@ -0,0 +1,28 @@
+import type { ServerConnection } from '../types.js';
+/** 프로토콜 변환 결과 */
+export interface AdaptedRequest {
+    /** 변환된 요청 데이터 (JSON-RPC 형태) */
+    jsonrpc: {
+        jsonrpc: '2.0';
+        id: number | string;
+        method: string;
+        params?: Record<string, any>;
+    };
+}
+/**
+ * MCP 도구 호출을 JSON-RPC 요청으로 변환한다.
+ */
+export declare function buildToolCallRequest(toolName: string, params: Record<string, any>): AdaptedRequest;
+/**
+ * 서버 연결 타입에 따른 통신 방법을 결정한다.
+ */
+export declare function resolveTransportMethod(connection: ServerConnection): 'spawn-stdio' | 'http-post' | 'sse-stream';
+/**
+ * 도구 목록 요청을 JSON-RPC로 변환한다.
+ */
+export declare function buildListToolsRequest(): AdaptedRequest;
+/**
+ * JSON-RPC 응답에서 결과를 추출한다.
+ */
+export declare function extractResult(response: any): any;
+//# sourceMappingURL=protocol-adapter.d.ts.map

package/dist/proxy/protocol-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-adapter.d.ts","sourceRoot":"","sources":["../../src/proxy/protocol-adapter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,iBAAiB;AACjB,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,OAAO,EAAE;QACP,OAAO,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC9B,CAAC;CACH;AAKD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,cAAc,CAYhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,gBAAgB,GAC3B,aAAa,GAAG,WAAW,GAAG,YAAY,CAI5C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAQtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAKhD"}

package/dist/proxy/protocol-adapter.js

@@ -0,0 +1,56 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — proxy/protocol-adapter.ts
+//
+// MCP transport 간 프로토콜 변환.
+// 클라이언트가 HTTP로 요청 → 하위 서버가 stdio인 경우,
+// 또는 클라이언트가 stdio → 하위 서버가 SSE인 경우 등을 처리.
+/** JSON-RPC 요청 ID 카운터 */
+let requestIdCounter = 0;
+/**
+ * MCP 도구 호출을 JSON-RPC 요청으로 변환한다.
+ */
+export function buildToolCallRequest(toolName, params) {
+    return {
+        jsonrpc: {
+            jsonrpc: '2.0',
+            id: ++requestIdCounter,
+            method: 'tools/call',
+            params: {
+                name: toolName,
+                arguments: params,
+            },
+        },
+    };
+}
+/**
+ * 서버 연결 타입에 따른 통신 방법을 결정한다.
+ */
+export function resolveTransportMethod(connection) {
+    if (connection.type === 'stdio')
+        return 'spawn-stdio';
+    if (connection.type === 'sse')
+        return 'sse-stream';
+    return 'http-post';
+}
+/**
+ * 도구 목록 요청을 JSON-RPC로 변환한다.
+ */
+export function buildListToolsRequest() {
+    return {
+        jsonrpc: {
+            jsonrpc: '2.0',
+            id: ++requestIdCounter,
+            method: 'tools/list',
+        },
+    };
+}
+/**
+ * JSON-RPC 응답에서 결과를 추출한다.
+ */
+export function extractResult(response) {
+    if (response?.error) {
+        throw new Error(`MCP error ${response.error.code}: ${response.error.message}`);
+    }
+    return response?.result;
+}
+//# sourceMappingURL=protocol-adapter.js.map

package/dist/proxy/protocol-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-adapter.js","sourceRoot":"","sources":["../../src/proxy/protocol-adapter.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,kDAAkD;AAClD,EAAE;AACF,2BAA2B;AAC3B,sCAAsC;AACtC,0CAA0C;AAe1C,yBAAyB;AACzB,IAAI,gBAAgB,GAAG,CAAC,CAAC;AAEzB;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,MAA2B;IAE3B,OAAO;QACL,OAAO,EAAE;YACP,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,EAAE,gBAAgB;YACtB,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,MAAM;aAClB;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAA4B;IAE5B,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,aAAa,CAAC;IACtD,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC;IACnD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,OAAO,EAAE;YACP,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,EAAE,gBAAgB;YACtB,MAAM,EAAE,YAAY;SACrB;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAa;IACzC,IAAI,QAAQ,EAAE,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,QAAQ,EAAE,MAAM,CAAC;AAC1B,CAAC"}

package/dist/proxy/session-pool.d.ts

@@ -0,0 +1,39 @@
+import type { ServerEntry } from '../types.js';
+export interface Session {
+    id: string;
+    serverId: string;
+    createdAt: Date;
+    lastUsedAt: Date;
+    active: boolean;
+    /** 하위 서버와의 실제 연결 핸들 (transport별로 다름) */
+    handle: any;
+}
+export declare class SessionPool {
+    private sessions;
+    private sessionCounter;
+    /**
+     * 서버의 기존 세션을 가져오거나 없으면 새로 생성한다.
+     */
+    acquire(server: ServerEntry): Session;
+    /**
+     * 세션을 반환한다 (재사용 가능 상태로 전환).
+     */
+    release(sessionId: string): void;
+    /**
+     * 세션을 종료한다.
+     */
+    destroy(sessionId: string): void;
+    /**
+     * 특정 서버의 모든 세션을 종료한다.
+     */
+    destroyByServer(serverId: string): void;
+    /**
+     * 유휴 세션 정리 (maxIdleMs 이상 사용하지 않은 세션).
+     */
+    cleanup(maxIdleMs?: number): number;
+    /**
+     * 전체 세션 수.
+     */
+    get size(): number;
+}
+//# sourceMappingURL=session-pool.d.ts.map

package/dist/proxy/session-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pool.d.ts","sourceRoot":"","sources":["../../src/proxy/session-pool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,MAAM,EAAE,GAAG,CAAC;CACb;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,cAAc,CAAK;IAE3B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAyBrC;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAUhC;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAYhC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUvC;;OAEG;IACH,OAAO,CAAC,SAAS,GAAE,MAAgB,GAAG,MAAM;IAoB5C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAMjB;CACF"}

package/dist/proxy/session-pool.js

@@ -0,0 +1,102 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — proxy/session-pool.ts
+//
+// 하위 MCP 서버와의 연결 세션을 관리한다.
+// 서버 ID별로 세션을 풀링하고, 재사용 / 정리를 담당.
+export class SessionPool {
+    sessions = new Map();
+    sessionCounter = 0;
+    /**
+     * 서버의 기존 세션을 가져오거나 없으면 새로 생성한다.
+     */
+    acquire(server) {
+        const pool = this.sessions.get(server.id) || [];
+        // 재사용 가능한 세션 찾기
+        const reusable = pool.find((s) => s.active);
+        if (reusable) {
+            reusable.lastUsedAt = new Date();
+            return reusable;
+        }
+        // 새 세션 생성
+        const session = {
+            id: `session_${++this.sessionCounter}`,
+            serverId: server.id,
+            createdAt: new Date(),
+            lastUsedAt: new Date(),
+            active: true,
+            handle: null, // 실제 연결은 proxy에서 설정
+        };
+        pool.push(session);
+        this.sessions.set(server.id, pool);
+        return session;
+    }
+    /**
+     * 세션을 반환한다 (재사용 가능 상태로 전환).
+     */
+    release(sessionId) {
+        for (const pool of this.sessions.values()) {
+            const session = pool.find((s) => s.id === sessionId);
+            if (session) {
+                session.lastUsedAt = new Date();
+                return;
+            }
+        }
+    }
+    /**
+     * 세션을 종료한다.
+     */
+    destroy(sessionId) {
+        for (const [serverId, pool] of this.sessions) {
+            const idx = pool.findIndex((s) => s.id === sessionId);
+            if (idx !== -1) {
+                pool[idx].active = false;
+                pool.splice(idx, 1);
+                this.sessions.set(serverId, pool);
+                return;
+            }
+        }
+    }
+    /**
+     * 특정 서버의 모든 세션을 종료한다.
+     */
+    destroyByServer(serverId) {
+        const pool = this.sessions.get(serverId);
+        if (pool) {
+            for (const session of pool) {
+                session.active = false;
+            }
+            this.sessions.delete(serverId);
+        }
+    }
+    /**
+     * 유휴 세션 정리 (maxIdleMs 이상 사용하지 않은 세션).
+     */
+    cleanup(maxIdleMs = 300_000) {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [serverId, pool] of this.sessions) {
+            const active = pool.filter((s) => {
+                const idle = now - s.lastUsedAt.getTime();
+                if (idle > maxIdleMs) {
+                    s.active = false;
+                    cleaned++;
+                    return false;
+                }
+                return true;
+            });
+            this.sessions.set(serverId, active);
+        }
+        return cleaned;
+    }
+    /**
+     * 전체 세션 수.
+     */
+    get size() {
+        let count = 0;
+        for (const pool of this.sessions.values()) {
+            count += pool.length;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=session-pool.js.map

package/dist/proxy/session-pool.js.map

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

package/dist/registry/health-checker.d.ts

@@ -0,0 +1,35 @@
+import type { ServerEntry, HealthCheckResult } from '../types.js';
+import { ServerRegistry } from './server-registry.js';
+export declare class HealthChecker {
+    private registry;
+    private checkIntervalMs;
+    private timeoutMs;
+    private interval;
+    private results;
+    constructor(registry: ServerRegistry, checkIntervalMs?: number, timeoutMs?: number);
+    /**
+     * 주기적 헬스체크를 시작한다.
+     */
+    start(): void;
+    /**
+     * 헬스체크를 중지한다.
+     */
+    stop(): void;
+    /**
+     * 모든 connected 서버를 체크한다.
+     */
+    checkAll(): Promise<HealthCheckResult[]>;
+    /**
+     * 단일 서버를 체크한다.
+     */
+    checkOne(server: ServerEntry): Promise<HealthCheckResult>;
+    /**
+     * 마지막 헬스체크 결과를 조회한다.
+     */
+    getLastResult(serverId: string): HealthCheckResult | undefined;
+    /**
+     * 전체 마지막 결과.
+     */
+    getAllResults(): HealthCheckResult[];
+}
+//# sourceMappingURL=health-checker.d.ts.map

package/dist/registry/health-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-checker.d.ts","sourceRoot":"","sources":["../../src/registry/health-checker.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,aAAa;IAKtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,SAAS;IANnB,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,OAAO,CAAwC;gBAG7C,QAAQ,EAAE,cAAc,EACxB,eAAe,GAAE,MAAe,EAChC,SAAS,GAAE,MAAc;IAGnC;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAa9C;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyD/D;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9D;;OAEG;IACH,aAAa,IAAI,iBAAiB,EAAE;CAGrC"}