@airmcp-dev/gateway 0.1.0

package/dist/registry/health-checker.js

@@ -0,0 +1,121 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — registry/health-checker.ts
+//
+// 등록된 서버들의 헬스체크를 주기적으로 수행한다.
+// 응답 없는 서버는 status를 'error'로 전환.
+export class HealthChecker {
+    registry;
+    checkIntervalMs;
+    timeoutMs;
+    interval = null;
+    results = new Map();
+    constructor(registry, checkIntervalMs = 30_000, timeoutMs = 5_000) {
+        this.registry = registry;
+        this.checkIntervalMs = checkIntervalMs;
+        this.timeoutMs = timeoutMs;
+    }
+    /**
+     * 주기적 헬스체크를 시작한다.
+     */
+    start() {
+        if (this.interval)
+            return;
+        // 즉시 1회 실행
+        this.checkAll();
+        this.interval = setInterval(() => {
+            this.checkAll();
+        }, this.checkIntervalMs);
+    }
+    /**
+     * 헬스체크를 중지한다.
+     */
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+    /**
+     * 모든 connected 서버를 체크한다.
+     */
+    async checkAll() {
+        const servers = this.registry.listAll();
+        const results = [];
+        for (const server of servers) {
+            if (server.status === 'stopped')
+                continue;
+            const result = await this.checkOne(server);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * 단일 서버를 체크한다.
+     */
+    async checkOne(server) {
+        const start = Date.now();
+        try {
+            if (server.connection.type === 'stdio') {
+                // stdio 서버는 프로세스 존재 여부로 판단
+                // (실제로는 PID 체크 또는 ping 메시지)
+                const result = {
+                    serverId: server.id,
+                    healthy: server.status === 'connected',
+                    latencyMs: Date.now() - start,
+                    checkedAt: new Date(),
+                };
+                this.results.set(server.id, result);
+                return result;
+            }
+            // http/sse 서버는 URL로 health 체크
+            const url = server.connection.url;
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+            try {
+                const res = await fetch(`${url}/health`, {
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                const healthy = res.ok;
+                const result = {
+                    serverId: server.id,
+                    healthy,
+                    latencyMs: Date.now() - start,
+                    checkedAt: new Date(),
+                };
+                this.registry.updateStatus(server.id, healthy ? 'connected' : 'error');
+                this.results.set(server.id, result);
+                return result;
+            }
+            catch (err) {
+                clearTimeout(timeout);
+                throw err;
+            }
+        }
+        catch (err) {
+            const result = {
+                serverId: server.id,
+                healthy: false,
+                latencyMs: Date.now() - start,
+                error: err.message,
+                checkedAt: new Date(),
+            };
+            this.registry.updateStatus(server.id, 'error');
+            this.results.set(server.id, result);
+            return result;
+        }
+    }
+    /**
+     * 마지막 헬스체크 결과를 조회한다.
+     */
+    getLastResult(serverId) {
+        return this.results.get(serverId);
+    }
+    /**
+     * 전체 마지막 결과.
+     */
+    getAllResults() {
+        return Array.from(this.results.values());
+    }
+}
+//# sourceMappingURL=health-checker.js.map

package/dist/registry/health-checker.js.map

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

package/dist/registry/index.d.ts

@@ -0,0 +1,4 @@
+export { ServerRegistry } from './server-registry.js';
+export { ToolIndex } from './tool-index.js';
+export { HealthChecker } from './health-checker.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,7 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — registry/index.ts
+// re-export only.
+export { ServerRegistry } from './server-registry.js';
+export { ToolIndex } from './tool-index.js';
+export { HealthChecker } from './health-checker.js';
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,0CAA0C;AAC1C,kBAAkB;AAElB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/registry/server-registry.d.ts

@@ -0,0 +1,37 @@
+import type { ServerEntry, ServerConnection, ServerStatus, ToolEntry } from '../types.js';
+export declare class ServerRegistry {
+    private servers;
+    /**
+     * 서버를 등록한다.
+     */
+    register(id: string, name: string, connection: ServerConnection): ServerEntry;
+    /**
+     * 서버를 해제한다.
+     */
+    unregister(id: string): boolean;
+    /**
+     * 서버를 ID로 조회한다.
+     */
+    get(id: string): ServerEntry | undefined;
+    /**
+     * 전체 서버 목록.
+     */
+    listAll(): ServerEntry[];
+    /**
+     * 특정 상태의 서버만 조회.
+     */
+    listByStatus(status: ServerStatus): ServerEntry[];
+    /**
+     * 서버 상태를 갱신한다.
+     */
+    updateStatus(id: string, status: ServerStatus): void;
+    /**
+     * 서버의 도구 목록을 갱신한다 (발견 후 호출).
+     */
+    updateTools(id: string, tools: ToolEntry[]): void;
+    /**
+     * 등록된 서버 수.
+     */
+    get size(): number;
+}
+//# sourceMappingURL=server-registry.d.ts.map

package/dist/registry/server-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-registry.d.ts","sourceRoot":"","sources":["../../src/registry/server-registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1F,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkC;IAEjD;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,WAAW;IAa7E;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC;;OAEG;IACH,OAAO,IAAI,WAAW,EAAE;IAIxB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,EAAE;IAIjD;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAOpD;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAOjD;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/registry/server-registry.js

@@ -0,0 +1,72 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — registry/server-registry.ts
+//
+// MCP 서버 등록/해제/조회.
+// Gateway에 하위 서버를 등록하면 자동으로 도구를 발견하고 인덱싱한다.
+export class ServerRegistry {
+    servers = new Map();
+    /**
+     * 서버를 등록한다.
+     */
+    register(id, name, connection) {
+        const entry = {
+            id,
+            name,
+            transport: connection.type === 'stdio' ? 'stdio' : connection.type,
+            connection,
+            tools: [],
+            status: 'registered',
+        };
+        this.servers.set(id, entry);
+        return entry;
+    }
+    /**
+     * 서버를 해제한다.
+     */
+    unregister(id) {
+        return this.servers.delete(id);
+    }
+    /**
+     * 서버를 ID로 조회한다.
+     */
+    get(id) {
+        return this.servers.get(id);
+    }
+    /**
+     * 전체 서버 목록.
+     */
+    listAll() {
+        return Array.from(this.servers.values());
+    }
+    /**
+     * 특정 상태의 서버만 조회.
+     */
+    listByStatus(status) {
+        return this.listAll().filter((s) => s.status === status);
+    }
+    /**
+     * 서버 상태를 갱신한다.
+     */
+    updateStatus(id, status) {
+        const server = this.servers.get(id);
+        if (server) {
+            server.status = status;
+        }
+    }
+    /**
+     * 서버의 도구 목록을 갱신한다 (발견 후 호출).
+     */
+    updateTools(id, tools) {
+        const server = this.servers.get(id);
+        if (server) {
+            server.tools = tools;
+        }
+    }
+    /**
+     * 등록된 서버 수.
+     */
+    get size() {
+        return this.servers.size;
+    }
+}
+//# sourceMappingURL=server-registry.js.map

package/dist/registry/server-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-registry.js","sourceRoot":"","sources":["../../src/registry/server-registry.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,oDAAoD;AACpD,EAAE;AACF,mBAAmB;AACnB,4CAA4C;AAI5C,MAAM,OAAO,cAAc;IACjB,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,EAAU,EAAE,IAAY,EAAE,UAA4B;QAC7D,MAAM,KAAK,GAAgB;YACzB,EAAE;YACF,IAAI;YACJ,SAAS,EAAE,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI;YAClE,UAAU;YACV,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,YAAY;SACrB,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAoB;QAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,EAAU,EAAE,MAAoB;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,EAAU,EAAE,KAAkB;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}

package/dist/registry/tool-index.d.ts

@@ -0,0 +1,35 @@
+import type { ToolEntry, ServerEntry } from '../types.js';
+export declare class ToolIndex {
+    /** toolName → ToolEntry[] (같은 이름의 도구가 여러 서버에 있을 수 있음) */
+    private index;
+    /**
+     * 서버의 도구 목록을 인덱스에 반영한다.
+     * 기존 항목은 제거 후 재등록.
+     */
+    reindex(server: ServerEntry): void;
+    /**
+     * 서버의 모든 도구를 인덱스에서 제거한다.
+     */
+    removeServer(serverId: string): void;
+    /**
+     * 도구 이름으로 제공 서버를 조회한다.
+     */
+    find(toolName: string): ToolEntry[];
+    /**
+     * 도구가 존재하는지 확인.
+     */
+    has(toolName: string): boolean;
+    /**
+     * 전체 도구 목록 (중복 제거 없이).
+     */
+    listAll(): ToolEntry[];
+    /**
+     * 고유 도구 이름 목록.
+     */
+    listNames(): string[];
+    /**
+     * 전체 도구 수.
+     */
+    get size(): number;
+}
+//# sourceMappingURL=tool-index.d.ts.map

package/dist/registry/tool-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-index.d.ts","sourceRoot":"","sources":["../../src/registry/tool-index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D,qBAAa,SAAS;IACpB,yDAAyD;IACzD,OAAO,CAAC,KAAK,CAAkC;IAE/C;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAYlC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWpC;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAInC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,OAAO,IAAI,SAAS,EAAE;IAQtB;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/registry/tool-index.js

@@ -0,0 +1,72 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — registry/tool-index.ts
+//
+// 전체 하위 서버의 도구를 하나의 인덱스로 관리한다.
+// 도구 이름으로 어떤 서버가 제공하는지 즉시 조회 가능.
+export class ToolIndex {
+    /** toolName → ToolEntry[] (같은 이름의 도구가 여러 서버에 있을 수 있음) */
+    index = new Map();
+    /**
+     * 서버의 도구 목록을 인덱스에 반영한다.
+     * 기존 항목은 제거 후 재등록.
+     */
+    reindex(server) {
+        // 기존 항목 제거
+        this.removeServer(server.id);
+        // 새 도구 등록
+        for (const tool of server.tools) {
+            const existing = this.index.get(tool.name) || [];
+            existing.push(tool);
+            this.index.set(tool.name, existing);
+        }
+    }
+    /**
+     * 서버의 모든 도구를 인덱스에서 제거한다.
+     */
+    removeServer(serverId) {
+        for (const [name, entries] of this.index) {
+            const filtered = entries.filter((e) => e.serverId !== serverId);
+            if (filtered.length === 0) {
+                this.index.delete(name);
+            }
+            else {
+                this.index.set(name, filtered);
+            }
+        }
+    }
+    /**
+     * 도구 이름으로 제공 서버를 조회한다.
+     */
+    find(toolName) {
+        return this.index.get(toolName) || [];
+    }
+    /**
+     * 도구가 존재하는지 확인.
+     */
+    has(toolName) {
+        return this.index.has(toolName);
+    }
+    /**
+     * 전체 도구 목록 (중복 제거 없이).
+     */
+    listAll() {
+        const all = [];
+        for (const entries of this.index.values()) {
+            all.push(...entries);
+        }
+        return all;
+    }
+    /**
+     * 고유 도구 이름 목록.
+     */
+    listNames() {
+        return Array.from(this.index.keys());
+    }
+    /**
+     * 전체 도구 수.
+     */
+    get size() {
+        return this.index.size;
+    }
+}
+//# sourceMappingURL=tool-index.js.map

package/dist/registry/tool-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-index.js","sourceRoot":"","sources":["../../src/registry/tool-index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,+CAA+C;AAC/C,EAAE;AACF,+BAA+B;AAC/B,iCAAiC;AAIjC,MAAM,OAAO,SAAS;IACpB,yDAAyD;IACjD,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE/C;;;OAGG;IACH,OAAO,CAAC,MAAmB;QACzB,WAAW;QACX,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE7B,UAAU;QACV,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAAgB;QAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;YAChE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,QAAgB;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,GAAG,GAAgB,EAAE,CAAC;QAC5B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/router/index.d.ts

@@ -0,0 +1,3 @@
+export { RequestRouter } from './request-router.js';
+export { LoadBalancer } from './load-balancer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/router/index.js

@@ -0,0 +1,6 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — router/index.ts
+// re-export only.
+export { RequestRouter } from './request-router.js';
+export { LoadBalancer } from './load-balancer.js';
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wCAAwC;AACxC,kBAAkB;AAElB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/router/load-balancer.d.ts

@@ -0,0 +1,23 @@
+import type { ToolEntry, BalancerStrategy } from '../types.js';
+export declare class LoadBalancer {
+    private strategy;
+    private counter;
+    private weights;
+    constructor(strategy?: BalancerStrategy);
+    /**
+     * 후보 중 하나를 선택한다.
+     */
+    select(candidates: ToolEntry[]): ToolEntry;
+    /**
+     * 서버별 가중치를 설정한다 (weighted 전략용).
+     */
+    setWeight(serverId: string, weight: number): void;
+    /**
+     * 전략을 변경한다.
+     */
+    setStrategy(strategy: BalancerStrategy): void;
+    private roundRobin;
+    private random;
+    private weighted;
+}
+//# sourceMappingURL=load-balancer.d.ts.map

package/dist/router/load-balancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-balancer.d.ts","sourceRoot":"","sources":["../../src/router/load-balancer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ;IAH5B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAA6B;gBAExB,QAAQ,GAAE,gBAAgC;IAE9D;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS;IAyB1C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAK7C,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,QAAQ;CAkBjB"}

package/dist/router/load-balancer.js

@@ -0,0 +1,78 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — router/load-balancer.ts
+//
+// 여러 후보 중 하나를 선택하는 로드밸런서.
+// 전략: round-robin (기본), random, weighted.
+export class LoadBalancer {
+    strategy;
+    counter = 0;
+    weights = new Map();
+    constructor(strategy = 'round-robin') {
+        this.strategy = strategy;
+    }
+    /**
+     * 후보 중 하나를 선택한다.
+     */
+    select(candidates) {
+        if (candidates.length === 0) {
+            throw new Error('No candidates to balance.');
+        }
+        if (candidates.length === 1) {
+            return candidates[0];
+        }
+        switch (this.strategy) {
+            case 'round-robin':
+                return this.roundRobin(candidates);
+            case 'random':
+                return this.random(candidates);
+            case 'weighted':
+                return this.weighted(candidates);
+            case 'least-connections':
+                // least-connections는 세션 수 추적이 필요 → 향후 구현
+                // fallback to round-robin
+                return this.roundRobin(candidates);
+            default:
+                return this.roundRobin(candidates);
+        }
+    }
+    /**
+     * 서버별 가중치를 설정한다 (weighted 전략용).
+     */
+    setWeight(serverId, weight) {
+        this.weights.set(serverId, Math.max(0, weight));
+    }
+    /**
+     * 전략을 변경한다.
+     */
+    setStrategy(strategy) {
+        this.strategy = strategy;
+        this.counter = 0;
+    }
+    roundRobin(candidates) {
+        const idx = this.counter % candidates.length;
+        this.counter++;
+        return candidates[idx];
+    }
+    random(candidates) {
+        const idx = Math.floor(Math.random() * candidates.length);
+        return candidates[idx];
+    }
+    weighted(candidates) {
+        // 가중치 없는 서버는 기본 1
+        const entries = candidates.map((c) => ({
+            tool: c,
+            weight: this.weights.get(c.serverId) ?? 1,
+        }));
+        const totalWeight = entries.reduce((sum, e) => sum + e.weight, 0);
+        if (totalWeight === 0)
+            return this.roundRobin(candidates);
+        let random = Math.random() * totalWeight;
+        for (const entry of entries) {
+            random -= entry.weight;
+            if (random <= 0)
+                return entry.tool;
+        }
+        return entries[entries.length - 1].tool;
+    }
+}
+//# sourceMappingURL=load-balancer.js.map

package/dist/router/load-balancer.js.map

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

package/dist/router/request-router.d.ts

@@ -0,0 +1,21 @@
+import type { RouteRequest, RouteResult } from '../types.js';
+import { ServerRegistry } from '../registry/server-registry.js';
+import { ToolIndex } from '../registry/tool-index.js';
+import { LoadBalancer } from './load-balancer.js';
+export declare class RequestRouter {
+    private registry;
+    private toolIndex;
+    private balancer;
+    constructor(registry: ServerRegistry, toolIndex: ToolIndex, balancer: LoadBalancer);
+    /**
+     * 도구 호출 요청을 라우팅한다.
+     *
+     * @throws 도구를 찾을 수 없거나 사용 가능한 서버가 없으면 에러
+     */
+    route(request: RouteRequest): RouteResult;
+    /**
+     * 도구가 라우팅 가능한지 확인 (dry-run).
+     */
+    canRoute(toolName: string): boolean;
+}
+//# sourceMappingURL=request-router.d.ts.map

package/dist/router/request-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-router.d.ts","sourceRoot":"","sources":["../../src/router/request-router.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAA0B,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ;gBAFR,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,YAAY;IAGhC;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAwBzC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAOpC"}

package/dist/router/request-router.js

@@ -0,0 +1,50 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// @airmcp-dev/gateway — router/request-router.ts
+//
+// 도구 호출 요청을 적절한 서버로 라우팅한다.
+// ToolIndex에서 후보를 찾고, LoadBalancer로 하나를 선택.
+export class RequestRouter {
+    registry;
+    toolIndex;
+    balancer;
+    constructor(registry, toolIndex, balancer) {
+        this.registry = registry;
+        this.toolIndex = toolIndex;
+        this.balancer = balancer;
+    }
+    /**
+     * 도구 호출 요청을 라우팅한다.
+     *
+     * @throws 도구를 찾을 수 없거나 사용 가능한 서버가 없으면 에러
+     */
+    route(request) {
+        // ── 1. 도구 후보 찾기 ──
+        const candidates = this.toolIndex.find(request.toolName);
+        if (candidates.length === 0) {
+            throw new Error(`Tool "${request.toolName}" not found in any registered server.`);
+        }
+        // ── 2. 연결된 서버만 필터링 ──
+        const available = candidates.filter((t) => {
+            const server = this.registry.get(t.serverId);
+            return server && server.status === 'connected';
+        });
+        if (available.length === 0) {
+            throw new Error(`Tool "${request.toolName}" exists but no healthy server is available.`);
+        }
+        // ── 3. 로드밸런싱으로 하나 선택 ──
+        const selected = this.balancer.select(available);
+        const server = this.registry.get(selected.serverId);
+        return { server, tool: selected };
+    }
+    /**
+     * 도구가 라우팅 가능한지 확인 (dry-run).
+     */
+    canRoute(toolName) {
+        const candidates = this.toolIndex.find(toolName);
+        return candidates.some((t) => {
+            const server = this.registry.get(t.serverId);
+            return server && server.status === 'connected';
+        });
+    }
+}
+//# sourceMappingURL=request-router.js.map

package/dist/router/request-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-router.js","sourceRoot":"","sources":["../../src/router/request-router.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,iDAAiD;AACjD,EAAE;AACF,2BAA2B;AAC3B,4CAA4C;AAO5C,MAAM,OAAO,aAAa;IAEd;IACA;IACA;IAHV,YACU,QAAwB,EACxB,SAAoB,EACpB,QAAsB;QAFtB,aAAQ,GAAR,QAAQ,CAAgB;QACxB,cAAS,GAAT,SAAS,CAAW;QACpB,aAAQ,GAAR,QAAQ,CAAc;IAC7B,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,OAAqB;QACzB,oBAAoB;QACpB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,CAAC,QAAQ,uCAAuC,CAAC,CAAC;QACpF,CAAC;QAED,uBAAuB;QACvB,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC7C,OAAO,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,CAAC,QAAQ,8CAA8C,CAAC,CAAC;QAC3F,CAAC;QAED,yBAAyB;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAE,CAAC;QAErD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAgB;QACvB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC7C,OAAO,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}