@winstonsayno/mcp-gateway 0.0.0-stage → 0.3.0

package/dist/transport/streamable-http.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Streamable HTTP channel — the current MCP HTTP transport (protocol 2025-03-26+).
+ *
+ *  - Every client→server message is a `POST <url>` with
+ *    `Accept: application/json, text/event-stream`.
+ *  - The server answers `202 Accepted` (notifications / responses), a single
+ *    `application/json` body, or a `text/event-stream` that carries the
+ *    response (plus any server requests/notifications sent before it).
+ *  - A session id returned in `Mcp-Session-Id` on `initialize` is echoed on
+ *    every later request; the negotiated version goes in `MCP-Protocol-Version`.
+ *  - `close()` ends the session with `DELETE` (best effort).
+ *
+ * Not implemented: the optional standalone `GET` stream for unsolicited server
+ * notifications, and SSE stream resumption. Neither is needed for tool calls.
+ *
+ * @module transport/streamable-http
+ */
+import type { McpServerConfig } from '../utils/types.js';
+import { type ChannelOptions, type JsonRpcId, type JsonRpcMessage, type UpstreamChannel } from './channel.js';
+export declare class StreamableHttpChannel implements UpstreamChannel {
+    private readonly config;
+    private readonly options;
+    readonly kind = "streamable-http";
+    onmessage?: (message: JsonRpcMessage) => void;
+    onclose?: (error: Error) => void;
+    private readonly url;
+    private readonly headers;
+    private sessionId?;
+    private protocolVersion?;
+    private closed;
+    private lost;
+    /** Open POST requests, keyed by JSON-RPC request id when they carry one. */
+    private readonly inflight;
+    constructor(config: McpServerConfig, options: ChannelOptions);
+    start(): Promise<void>;
+    setProtocolVersion(version: string): void;
+    private requestHeaders;
+    send(message: JsonRpcMessage): Promise<void>;
+    private deliver;
+    abandon(id: JsonRpcId): void;
+    private lose;
+    private abortAll;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=streamable-http.d.ts.map

package/dist/transport/streamable-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http.d.ts","sourceRoot":"","sources":["../../src/transport/streamable-http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAGtB,qBAAa,qBAAsB,YAAW,eAAe;IAezD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAf1B,QAAQ,CAAC,IAAI,qBAAqB;IAClC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkD;gBAGxD,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,cAAc;IAOpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzC,OAAO,CAAC,cAAc;IAOhB,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA2ElD,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAK5B,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,QAAQ;IAKV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAkB7B"}

package/dist/transport/streamable-http.js

@@ -0,0 +1,183 @@
+/**
+ * Streamable HTTP channel — the current MCP HTTP transport (protocol 2025-03-26+).
+ *
+ *  - Every client→server message is a `POST <url>` with
+ *    `Accept: application/json, text/event-stream`.
+ *  - The server answers `202 Accepted` (notifications / responses), a single
+ *    `application/json` body, or a `text/event-stream` that carries the
+ *    response (plus any server requests/notifications sent before it).
+ *  - A session id returned in `Mcp-Session-Id` on `initialize` is echoed on
+ *    every later request; the negotiated version goes in `MCP-Protocol-Version`.
+ *  - `close()` ends the session with `DELETE` (best effort).
+ *
+ * Not implemented: the optional standalone `GET` stream for unsolicited server
+ * notifications, and SSE stream resumption. Neither is needed for tool calls.
+ *
+ * @module transport/streamable-http
+ */
+import { logger } from '../utils/logger.js';
+import { errMessage, expandRecord, toMessages, } from './channel.js';
+import { readSseStream } from './sse-parser.js';
+export class StreamableHttpChannel {
+    config;
+    options;
+    kind = 'streamable-http';
+    onmessage;
+    onclose;
+    url;
+    headers;
+    sessionId;
+    protocolVersion;
+    closed = false;
+    lost = false;
+    /** Open POST requests, keyed by JSON-RPC request id when they carry one. */
+    inflight = new Map();
+    constructor(config, options) {
+        this.config = config;
+        this.options = options;
+        if (!config.url)
+            throw new Error(`Server "${config.id}" has no url configured`);
+        this.url = new URL(config.url);
+        this.headers = expandRecord(config.headers);
+    }
+    async start() {
+        // Nothing to open: the session starts with the `initialize` POST.
+    }
+    setProtocolVersion(version) {
+        this.protocolVersion = version;
+    }
+    requestHeaders(extra = {}) {
+        const h = { ...this.headers, ...extra };
+        if (this.sessionId)
+            h['mcp-session-id'] = this.sessionId;
+        if (this.protocolVersion)
+            h['mcp-protocol-version'] = this.protocolVersion;
+        return h;
+    }
+    async send(message) {
+        if (this.closed || this.lost)
+            throw new Error('Streamable HTTP channel is closed');
+        const key = message.method !== undefined && message.id !== undefined && message.id !== null ? message.id : Symbol('post');
+        const abort = new AbortController();
+        this.inflight.set(key, abort);
+        const done = () => {
+            if (this.inflight.get(key) === abort)
+                this.inflight.delete(key);
+        };
+        let res;
+        try {
+            res = await fetch(this.url, {
+                method: 'POST',
+                headers: this.requestHeaders({
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json, text/event-stream',
+                }),
+                body: JSON.stringify(message),
+                redirect: 'error',
+                signal: abort.signal,
+            });
+        }
+        catch (err) {
+            done();
+            if (abort.signal.aborted)
+                throw new Error('Request aborted');
+            // The server is unreachable: whatever session it held is gone.
+            const e = new Error(`POST ${this.url.origin}${this.url.pathname} failed: ${errMessage(err)}`);
+            this.lose(e);
+            throw e;
+        }
+        const sid = res.headers.get('mcp-session-id');
+        if (sid)
+            this.sessionId = sid;
+        if (res.status === 404 && this.sessionId && message.method !== 'initialize') {
+            done();
+            await res.body?.cancel().catch(() => { });
+            const e = new Error('MCP session expired (HTTP 404)');
+            this.lose(e);
+            throw e;
+        }
+        if (!res.ok) {
+            done();
+            const text = (await res.text().catch(() => '')).slice(0, 200);
+            throw new Error(`MCP server returned HTTP ${res.status}${text ? `: ${text}` : ''}`);
+        }
+        if (res.status === 202 || !res.body) {
+            done();
+            await res.body?.cancel().catch(() => { });
+            return;
+        }
+        const contentType = res.headers.get('content-type') ?? '';
+        if (contentType.includes('text/event-stream')) {
+            // Deliver events as they arrive; keep the stream open in the background.
+            void readSseStream(res.body, (ev) => {
+                if (ev.event !== 'message' || !ev.data)
+                    return;
+                this.deliver(ev.data);
+            })
+                .catch((err) => {
+                if (!abort.signal.aborted)
+                    logger.debug(`[${this.config.id}] response stream error: ${errMessage(err)}`);
+            })
+                .finally(done);
+            return;
+        }
+        try {
+            const text = await res.text();
+            if (text.trim())
+                this.deliver(text);
+        }
+        finally {
+            done();
+        }
+    }
+    deliver(text) {
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            logger.debug(`[${this.config.id}] ignoring non-JSON message`);
+            return;
+        }
+        for (const m of toMessages(parsed))
+            this.onmessage?.(m);
+    }
+    abandon(id) {
+        this.inflight.get(id)?.abort();
+        this.inflight.delete(id);
+    }
+    lose(err) {
+        if (this.closed || this.lost)
+            return;
+        this.lost = true;
+        this.abortAll();
+        this.onclose?.(err);
+    }
+    abortAll() {
+        for (const c of this.inflight.values())
+            c.abort();
+        this.inflight.clear();
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.abortAll();
+        if (!this.sessionId || this.lost)
+            return;
+        // Politely end the session; servers may answer 405 if they do not support it.
+        try {
+            const res = await fetch(this.url, {
+                method: 'DELETE',
+                headers: this.requestHeaders(),
+                redirect: 'error',
+                signal: AbortSignal.timeout(this.options.killGraceMs),
+            });
+            await res.body?.cancel().catch(() => { });
+        }
+        catch {
+            // best effort
+        }
+    }
+}
+//# sourceMappingURL=streamable-http.js.map

package/dist/transport/streamable-http.js.map

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

package/dist/transport/websocket.d.ts

@@ -0,0 +1,38 @@
+/**
+ * WebSocket channel — one JSON-RPC message per text frame, using the `mcp`
+ * subprotocol by default (the same convention as the official SDK's
+ * `WebSocketClientTransport`; override per server with `subprotocol`). Uses the `ws` package so custom headers work
+ * and Node 20 (no global WebSocket) is supported.
+ *
+ * Keep-alive pings detect half-open connections: if a pong does not arrive
+ * before the next ping, the socket is terminated and reported as lost.
+ * Reconnection is handled by the gateway supervisor, which re-runs the MCP
+ * handshake on a fresh socket.
+ *
+ * @module transport/websocket
+ */
+import type { McpServerConfig } from '../utils/types.js';
+import { type ChannelOptions, type JsonRpcMessage, type UpstreamChannel } from './channel.js';
+export interface WebSocketChannelOptions extends ChannelOptions {
+    pingIntervalMs?: number;
+}
+export declare class WebSocketChannel implements UpstreamChannel {
+    private readonly config;
+    private readonly options;
+    readonly kind = "websocket";
+    onmessage?: (message: JsonRpcMessage) => void;
+    onclose?: (error: Error) => void;
+    private ws?;
+    private closed;
+    private lost;
+    private pingTimer?;
+    private awaitingPong;
+    constructor(config: McpServerConfig, options: WebSocketChannelOptions);
+    start(): Promise<void>;
+    private lose;
+    private startPing;
+    private stopPing;
+    send(message: JsonRpcMessage): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/transport/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/transport/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAgB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAK5G,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAiB,YAAW,eAAe;IAYpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B,QAAQ,CAAC,IAAI,eAAe;IAC5B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,YAAY,CAAS;gBAGV,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,uBAAuB;IAKnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmEtB,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,QAAQ;IAKhB,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAwB7B"}

package/dist/transport/websocket.js

@@ -0,0 +1,172 @@
+/**
+ * WebSocket channel — one JSON-RPC message per text frame, using the `mcp`
+ * subprotocol by default (the same convention as the official SDK's
+ * `WebSocketClientTransport`; override per server with `subprotocol`). Uses the `ws` package so custom headers work
+ * and Node 20 (no global WebSocket) is supported.
+ *
+ * Keep-alive pings detect half-open connections: if a pong does not arrive
+ * before the next ping, the socket is terminated and reported as lost.
+ * Reconnection is handled by the gateway supervisor, which re-runs the MCP
+ * handshake on a fresh socket.
+ *
+ * @module transport/websocket
+ */
+import WebSocket from 'ws';
+import { logger } from '../utils/logger.js';
+import { expandRecord } from './channel.js';
+const SUBPROTOCOL = 'mcp';
+const MAX_PAYLOAD = 16 * 1024 * 1024;
+export class WebSocketChannel {
+    config;
+    options;
+    kind = 'websocket';
+    onmessage;
+    onclose;
+    ws;
+    closed = false;
+    lost = false;
+    pingTimer;
+    awaitingPong = false;
+    constructor(config, options) {
+        this.config = config;
+        this.options = options;
+        if (!config.url)
+            throw new Error(`Server "${config.id}" has no url configured`);
+    }
+    start() {
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            // `subprotocol: ""` connects without requesting one (for servers that reject it).
+            const sub = this.config.subprotocol ?? SUBPROTOCOL;
+            const ws = new WebSocket(this.config.url, sub ? [sub] : [], {
+                headers: expandRecord(this.config.headers),
+                handshakeTimeout: this.options.connectTimeoutMs,
+                maxPayload: MAX_PAYLOAD,
+            });
+            this.ws = ws;
+            ws.on('open', () => {
+                settled = true;
+                this.startPing();
+                resolve();
+            });
+            ws.on('unexpected-response', (_req, res) => {
+                res.resume();
+                const err = new Error(`WebSocket upgrade rejected with HTTP ${res.statusCode}`);
+                ws.terminate();
+                if (!settled) {
+                    settled = true;
+                    reject(err);
+                }
+            });
+            ws.on('message', (raw, isBinary) => {
+                if (isBinary)
+                    return;
+                let msg;
+                try {
+                    msg = JSON.parse(raw.toString());
+                }
+                catch {
+                    logger.debug(`[${this.config.id}] ignoring non-JSON WebSocket frame`);
+                    return;
+                }
+                // Batches are arrays of messages.
+                for (const m of Array.isArray(msg) ? msg : [msg]) {
+                    if (m && typeof m === 'object')
+                        this.onmessage?.(m);
+                }
+            });
+            ws.on('pong', () => {
+                this.awaitingPong = false;
+            });
+            ws.on('error', (err) => {
+                logger.debug(`[${this.config.id}] WebSocket error: ${err.message}`);
+                if (!settled) {
+                    settled = true;
+                    reject(err);
+                }
+            });
+            ws.on('close', (code, reason) => {
+                this.stopPing();
+                if (!settled) {
+                    settled = true;
+                    reject(new Error(`WebSocket closed during connect (code=${code})`));
+                    return;
+                }
+                this.lose(new Error(`WebSocket closed (code=${code}, reason=${reason.toString() || 'none'})`));
+            });
+        });
+    }
+    lose(err) {
+        if (this.closed || this.lost)
+            return;
+        this.lost = true;
+        logger.warn(`[${this.config.id}] ${err.message}`);
+        this.onclose?.(err);
+    }
+    startPing() {
+        const interval = this.options.pingIntervalMs ?? 30_000;
+        if (!(interval > 0))
+            return;
+        this.pingTimer = setInterval(() => {
+            const ws = this.ws;
+            if (!ws || ws.readyState !== WebSocket.OPEN)
+                return;
+            if (this.awaitingPong) {
+                // No pong since the last ping: the connection is dead.
+                ws.terminate();
+                return;
+            }
+            this.awaitingPong = true;
+            try {
+                ws.ping();
+            }
+            catch {
+                // ignore — 'close' will follow
+            }
+        }, interval);
+        this.pingTimer.unref();
+    }
+    stopPing() {
+        if (this.pingTimer)
+            clearInterval(this.pingTimer);
+        this.pingTimer = undefined;
+    }
+    send(message) {
+        const ws = this.ws;
+        if (this.closed || this.lost || !ws || ws.readyState !== WebSocket.OPEN) {
+            return Promise.reject(new Error('WebSocket channel is not connected'));
+        }
+        return new Promise((resolve, reject) => {
+            ws.send(JSON.stringify(message), (err) => (err ? reject(err) : resolve()));
+        });
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.stopPing();
+        const ws = this.ws;
+        if (!ws)
+            return;
+        if (ws.readyState === WebSocket.CLOSED)
+            return;
+        await new Promise((resolve) => {
+            const force = setTimeout(() => {
+                ws.terminate();
+                resolve();
+            }, this.options.killGraceMs);
+            force.unref();
+            ws.once('close', () => {
+                clearTimeout(force);
+                resolve();
+            });
+            try {
+                ws.close(1000, 'Client disconnect');
+            }
+            catch {
+                ws.terminate();
+            }
+        });
+    }
+}
+//# sourceMappingURL=websocket.js.map

package/dist/transport/websocket.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Minimal structured logger for mcp-gateway
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type { LogLevel };
+export declare class Logger {
+    private level;
+    setLevel(level: LogLevel): void;
+    private log;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAkBpD,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAoB;IAEjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,OAAO,CAAC,GAAG;IAkBX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG7D;AAUD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,60 @@
+/**
+ * Minimal structured logger for mcp-gateway
+ */
+const LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const COLORS = {
+    debug: '\x1b[90m', // gray
+    info: '\x1b[36m', // cyan
+    warn: '\x1b[33m', // yellow
+    error: '\x1b[31m', // red
+};
+const RESET = '\x1b[0m';
+export class Logger {
+    level = 'info';
+    setLevel(level) {
+        this.level = level;
+    }
+    log(level, message, meta) {
+        if (LEVELS[level] < LEVELS[this.level])
+            return;
+        const ts = new Date().toISOString();
+        const color = process.stdout.isTTY ? COLORS[level] : '';
+        const reset = process.stdout.isTTY ? RESET : '';
+        const prefix = `${color}[${level.toUpperCase().padEnd(5)}]${reset}`;
+        const metaStr = meta ? ` ${safeStringify(meta)}` : '';
+        const output = `${ts} ${prefix} ${message}${metaStr}`;
+        if (level === 'error' || level === 'warn') {
+            process.stderr.write(output + '\n');
+        }
+        else {
+            process.stdout.write(output + '\n');
+        }
+    }
+    debug(message, meta) {
+        this.log('debug', message, meta);
+    }
+    info(message, meta) {
+        this.log('info', message, meta);
+    }
+    warn(message, meta) {
+        this.log('warn', message, meta);
+    }
+    error(message, meta) {
+        this.log('error', message, meta);
+    }
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value, (_k, v) => (typeof v === 'bigint' ? v.toString() : v));
+    }
+    catch {
+        return '[unserializable meta]';
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/mutex.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Async Mutex
+ *
+ * Bug fix (v0.1.0): the server registry could attempt to restart the same
+ * MCP server process multiple times concurrently when several requests
+ * arrived simultaneously during a restart window, causing duplicate processes.
+ * This lightweight mutex serialises critical sections without external deps.
+ *
+ * @module utils/mutex
+ */
+export declare class Mutex {
+    private _queue;
+    private _locked;
+    /**
+     * Acquire the lock. The returned release function is idempotent: calling it
+     * more than once is a no-op (previously a double release could unlock the
+     * mutex while another holder was still inside the critical section).
+     */
+    acquire(): Promise<() => void>;
+    /** Hand the lock directly to the next waiter, or unlock if none. */
+    private _release;
+    get isLocked(): boolean;
+    runExclusive<T>(fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=mutex.d.ts.map

package/dist/utils/mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.d.ts","sourceRoot":"","sources":["../../src/utils/mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAS;IAExB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;IAmB9B,oEAAoE;IACpE,OAAO,CAAC,QAAQ;IAShB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAQxD"}

package/dist/utils/mutex.js

@@ -0,0 +1,62 @@
+/**
+ * Async Mutex
+ *
+ * Bug fix (v0.1.0): the server registry could attempt to restart the same
+ * MCP server process multiple times concurrently when several requests
+ * arrived simultaneously during a restart window, causing duplicate processes.
+ * This lightweight mutex serialises critical sections without external deps.
+ *
+ * @module utils/mutex
+ */
+export class Mutex {
+    _queue = [];
+    _locked = false;
+    /**
+     * Acquire the lock. The returned release function is idempotent: calling it
+     * more than once is a no-op (previously a double release could unlock the
+     * mutex while another holder was still inside the critical section).
+     */
+    acquire() {
+        return new Promise((resolve) => {
+            const grant = () => {
+                let released = false;
+                resolve(() => {
+                    if (released)
+                        return;
+                    released = true;
+                    this._release();
+                });
+            };
+            if (!this._locked) {
+                this._locked = true;
+                grant();
+            }
+            else {
+                this._queue.push(grant);
+            }
+        });
+    }
+    /** Hand the lock directly to the next waiter, or unlock if none. */
+    _release() {
+        const next = this._queue.shift();
+        if (next) {
+            next(); // lock stays held, ownership transfers
+        }
+        else {
+            this._locked = false;
+        }
+    }
+    get isLocked() {
+        return this._locked;
+    }
+    async runExclusive(fn) {
+        const release = await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            release();
+        }
+    }
+}
+//# sourceMappingURL=mutex.js.map

package/dist/utils/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../src/utils/mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,OAAO,KAAK;IACR,MAAM,GAAsB,EAAE,CAAC;IAC/B,OAAO,GAAG,KAAK,CAAC;IAExB;;;;OAIG;IACH,OAAO;QACL,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,GAAG,EAAE;gBACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;gBACrB,OAAO,CAAC,GAAG,EAAE;oBACX,IAAI,QAAQ;wBAAE,OAAO;oBACrB,QAAQ,GAAG,IAAI,CAAC;oBAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBACpB,KAAK,EAAE,CAAC;YACV,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IAC5D,QAAQ;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAC,CAAC,uCAAuC;QACjD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,YAAY,CAAI,EAAoB;QACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}