@winstonsayno/mcp-gateway 0.0.0-stage → 0.3.0

package/dist/middleware/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/middleware/timeout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1D,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,IACzC,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CAiC/D"}

package/dist/middleware/timeout.js

@@ -0,0 +1,39 @@
+/**
+ * Request Timeout Middleware
+ *
+ * Bug fix (v0.1.0): tool-call requests to slow or unresponsive MCP servers
+ * could hang indefinitely, exhausting the Node.js event loop.
+ * This middleware enforces a per-request deadline and returns a 504 response.
+ *
+ * @module middleware/timeout
+ */
+import { GatewayError, ErrorCodes } from './error-handler.js';
+export function timeoutMiddleware(timeoutMs) {
+    return (req, res, next) => {
+        // Skip timeout for SSE streaming endpoints
+        if (req.path.endsWith('/stream')) {
+            next();
+            return;
+        }
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            // The handler may have started streaming; nothing safe to send then.
+            if (res.headersSent)
+                return;
+            res.set('Retry-After', String(Math.max(1, Math.ceil(timeoutMs / 1000))));
+            next(new GatewayError(504, ErrorCodes.TIMEOUT, `Request timed out after ${timeoutMs}ms`, { path: req.path, method: req.method }));
+        }, timeoutMs);
+        // Clear the timer once the response is sent
+        res.on('finish', () => {
+            if (!timedOut)
+                clearTimeout(timer);
+        });
+        res.on('close', () => {
+            if (!timedOut)
+                clearTimeout(timer);
+        });
+        next();
+    };
+}
+//# sourceMappingURL=timeout.js.map

package/dist/middleware/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/middleware/timeout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,2CAA2C;QAC3C,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,QAAQ,GAAG,IAAI,CAAC;YAChB,qEAAqE;YACrE,IAAI,GAAG,CAAC,WAAW;gBAAE,OAAO;YAC5B,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,IAAI,CACF,IAAI,YAAY,CACd,GAAG,EACH,UAAU,CAAC,OAAO,EAClB,2BAA2B,SAAS,IAAI,EACxC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACvC,CACF,CAAC;QACJ,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,4CAA4C;QAC5C,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACpB,IAAI,CAAC,QAAQ;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,IAAI,CAAC,QAAQ;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

package/dist/monitor/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Metrics collection and aggregation for mcp-gateway
+ *
+ * Audit fixes:
+ *  - Prometheus `*_total` series were the count of the *last minute*, which
+ *    goes down over time and breaks `rate()`; they are now real monotonic
+ *    counters kept independently of the retention window.
+ *  - Label values are escaped per the exposition format.
+ *  - Percentiles use the nearest-rank method; `requestsPerMinute` without a
+ *    window is computed from the actual time span instead of request count.
+ *  - The in-memory log is capped (`maxEntries`) so high traffic within the
+ *    retention window cannot exhaust memory; cleanup timer is unref()'d.
+ */
+import { EventEmitter } from 'events';
+import type { RequestMetric, AggregatedMetrics, MonitorConfig } from '../utils/types.js';
+export interface MetricsOptions {
+    /** Hard cap on retained request records (oldest dropped first). Default 100k. */
+    maxEntries?: number;
+}
+/** Per-server connection state exported as Prometheus gauges / counters. */
+export interface ServerStateSample {
+    id: string;
+    status: string;
+    /** 1 when connected (online or degraded), else 0. */
+    up: number;
+    /** Successful automatic reconnects since start (monotonic). */
+    reconnects: number;
+    /** Consecutive failed reconnect attempts right now. */
+    reconnectAttempt: number;
+    latencyMs?: number;
+}
+export declare class MetricsCollector extends EventEmitter {
+    private metrics;
+    private readonly retentionMs;
+    private readonly maxEntries;
+    private cleanupInterval?;
+    private readonly counters;
+    constructor(config?: MonitorConfig, options?: MetricsOptions);
+    record(metric: Omit<RequestMetric, 'id' | 'timestamp'>): RequestMetric;
+    aggregate(windowMs?: number): AggregatedMetrics;
+    toPrometheusText(servers?: ServerStateSample[]): string;
+    start(): void;
+    /** Drop records older than the retention period. */
+    prune(now?: number): number;
+    stop(): void;
+    getRecent(limit?: number): RequestMetric[];
+    clear(): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/monitor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEzF,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;gBAElD,MAAM,CAAC,EAAE,aAAa,EAAE,OAAO,GAAE,cAAmB;IAQhE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,aAAa;IAwBtE,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAsD/C,gBAAgB,CAAC,OAAO,GAAE,iBAAiB,EAAO,GAAG,MAAM;IAkG3D,KAAK,IAAI,IAAI;IAMb,oDAAoD;IACpD,KAAK,CAAC,GAAG,SAAa,GAAG,MAAM;IAS/B,IAAI,IAAI,IAAI;IAOZ,SAAS,CAAC,KAAK,SAAM,GAAG,aAAa,EAAE;IAKvC,KAAK,IAAI,IAAI;CAId"}

package/dist/monitor/index.js

@@ -0,0 +1,204 @@
+/**
+ * Metrics collection and aggregation for mcp-gateway
+ *
+ * Audit fixes:
+ *  - Prometheus `*_total` series were the count of the *last minute*, which
+ *    goes down over time and breaks `rate()`; they are now real monotonic
+ *    counters kept independently of the retention window.
+ *  - Label values are escaped per the exposition format.
+ *  - Percentiles use the nearest-rank method; `requestsPerMinute` without a
+ *    window is computed from the actual time span instead of request count.
+ *  - The in-memory log is capped (`maxEntries`) so high traffic within the
+ *    retention window cannot exhaust memory; cleanup timer is unref()'d.
+ */
+import { EventEmitter } from 'events';
+import { randomUUID } from 'crypto';
+const SERVER_STATUSES = ['online', 'degraded', 'reconnecting', 'offline', 'unknown'];
+export class MetricsCollector extends EventEmitter {
+    metrics = [];
+    retentionMs;
+    maxEntries;
+    cleanupInterval;
+    counters = new Map();
+    constructor(config, options = {}) {
+        super();
+        this.retentionMs = (config?.retentionHours ?? 24) * 60 * 60 * 1000;
+        this.maxEntries = Math.max(1, options.maxEntries ?? 100_000);
+    }
+    // ─── Recording ──────────────────────────────────────────────────────────────
+    record(metric) {
+        const full = {
+            ...metric,
+            id: randomUUID(),
+            timestamp: new Date(),
+        };
+        this.metrics.push(full);
+        // Trim in batches to keep this amortised O(1).
+        if (this.metrics.length > this.maxEntries * 1.1) {
+            this.metrics.splice(0, this.metrics.length - this.maxEntries);
+        }
+        const c = this.counters.get(metric.serverId) ?? { requests: 0, errors: 0, durationMsSum: 0 };
+        c.requests++;
+        if (!metric.success)
+            c.errors++;
+        c.durationMsSum += metric.durationMs;
+        this.counters.set(metric.serverId, c);
+        this.emit('metric', full);
+        return full;
+    }
+    // ─── Aggregation ────────────────────────────────────────────────────────────
+    aggregate(windowMs) {
+        const now = Date.now();
+        const validWindow = windowMs !== undefined && Number.isFinite(windowMs) && windowMs > 0;
+        const cutoff = validWindow ? now - windowMs : 0;
+        const recent = cutoff > 0 ? this.metrics.filter((m) => m.timestamp.getTime() >= cutoff) : this.metrics;
+        if (recent.length === 0) {
+            return {
+                totalRequests: 0,
+                successRate: 1,
+                avgLatencyMs: 0,
+                p95LatencyMs: 0,
+                p99LatencyMs: 0,
+                requestsPerMinute: 0,
+                topTools: [],
+                topServers: [],
+                errorsByServer: {},
+            };
+        }
+        let successCount = 0;
+        let latencySum = 0;
+        const latencies = new Array(recent.length);
+        const toolCounts = new Map();
+        const serverCounts = new Map();
+        const errorsByServer = {};
+        recent.forEach((m, i) => {
+            latencies[i] = m.durationMs;
+            latencySum += m.durationMs;
+            if (m.success)
+                successCount++;
+            else
+                errorsByServer[m.serverId] = (errorsByServer[m.serverId] ?? 0) + 1;
+            toolCounts.set(m.toolName, (toolCounts.get(m.toolName) ?? 0) + 1);
+            serverCounts.set(m.serverId, (serverCounts.get(m.serverId) ?? 0) + 1);
+        });
+        latencies.sort((a, b) => a - b);
+        const spanMs = validWindow ? windowMs : Math.max(60_000, now - recent[0].timestamp.getTime());
+        return {
+            totalRequests: recent.length,
+            successRate: successCount / recent.length,
+            avgLatencyMs: latencySum / recent.length,
+            p95LatencyMs: percentile(latencies, 0.95),
+            p99LatencyMs: percentile(latencies, 0.99),
+            requestsPerMinute: recent.length / (spanMs / 60_000),
+            topTools: topN(toolCounts).map(([name, count]) => ({ name, count })),
+            topServers: topN(serverCounts).map(([id, count]) => ({ id, count })),
+            errorsByServer,
+        };
+    }
+    // ─── Prometheus Format ──────────────────────────────────────────────────────
+    toPrometheusText(servers = []) {
+        const agg = this.aggregate(60_000); // gauges over the last minute
+        let total = 0;
+        let errors = 0;
+        for (const c of this.counters.values()) {
+            total += c.requests;
+            errors += c.errors;
+        }
+        const lines = [
+            '# HELP mcp_gateway_requests_total Total number of tool calls since start',
+            '# TYPE mcp_gateway_requests_total counter',
+            `mcp_gateway_requests_total ${total}`,
+            '# HELP mcp_gateway_errors_total Total number of failed tool calls since start',
+            '# TYPE mcp_gateway_errors_total counter',
+            `mcp_gateway_errors_total ${errors}`,
+            '# HELP mcp_gateway_server_requests_total Tool calls per server since start',
+            '# TYPE mcp_gateway_server_requests_total counter',
+        ];
+        for (const [id, c] of this.counters) {
+            lines.push(`mcp_gateway_server_requests_total{server="${escapeLabel(id)}"} ${c.requests}`);
+        }
+        lines.push('# HELP mcp_gateway_server_errors_total Failed tool calls per server since start', '# TYPE mcp_gateway_server_errors_total counter');
+        for (const [id, c] of this.counters) {
+            lines.push(`mcp_gateway_server_errors_total{server="${escapeLabel(id)}"} ${c.errors}`);
+        }
+        lines.push('# HELP mcp_gateway_server_duration_ms_sum Sum of tool call latency per server since start (ms)', '# TYPE mcp_gateway_server_duration_ms_sum counter');
+        for (const [id, c] of this.counters) {
+            lines.push(`mcp_gateway_server_duration_ms_sum{server="${escapeLabel(id)}"} ${c.durationMsSum}`);
+        }
+        lines.push('# HELP mcp_gateway_success_rate Request success rate over the last minute (0-1)', '# TYPE mcp_gateway_success_rate gauge', `mcp_gateway_success_rate ${agg.successRate.toFixed(4)}`, '# HELP mcp_gateway_latency_avg_ms Average latency over the last minute (ms)', '# TYPE mcp_gateway_latency_avg_ms gauge', `mcp_gateway_latency_avg_ms ${agg.avgLatencyMs.toFixed(2)}`, '# HELP mcp_gateway_latency_p95_ms P95 latency over the last minute (ms)', '# TYPE mcp_gateway_latency_p95_ms gauge', `mcp_gateway_latency_p95_ms ${agg.p95LatencyMs.toFixed(2)}`, '# HELP mcp_gateway_latency_p99_ms P99 latency over the last minute (ms)', '# TYPE mcp_gateway_latency_p99_ms gauge', `mcp_gateway_latency_p99_ms ${agg.p99LatencyMs.toFixed(2)}`);
+        if (servers.length > 0) {
+            lines.push('# HELP mcp_gateway_server_up Whether the gateway currently has a session with the server (1/0)', '# TYPE mcp_gateway_server_up gauge');
+            for (const s of servers)
+                lines.push(`mcp_gateway_server_up{server="${escapeLabel(s.id)}"} ${s.up}`);
+            lines.push('# HELP mcp_gateway_server_status Current server status (1 for the active status label)', '# TYPE mcp_gateway_server_status gauge');
+            for (const s of servers) {
+                for (const st of SERVER_STATUSES) {
+                    lines.push(`mcp_gateway_server_status{server="${escapeLabel(s.id)}",status="${st}"} ${s.status === st ? 1 : 0}`);
+                }
+            }
+            lines.push('# HELP mcp_gateway_server_reconnects_total Successful automatic reconnects per server since start', '# TYPE mcp_gateway_server_reconnects_total counter');
+            for (const s of servers) {
+                lines.push(`mcp_gateway_server_reconnects_total{server="${escapeLabel(s.id)}"} ${s.reconnects}`);
+            }
+            lines.push('# HELP mcp_gateway_server_reconnect_attempt Consecutive failed reconnect attempts (0 when healthy)', '# TYPE mcp_gateway_server_reconnect_attempt gauge');
+            for (const s of servers) {
+                lines.push(`mcp_gateway_server_reconnect_attempt{server="${escapeLabel(s.id)}"} ${s.reconnectAttempt}`);
+            }
+            const pinged = servers.filter((s) => typeof s.latencyMs === 'number');
+            if (pinged.length > 0) {
+                lines.push('# HELP mcp_gateway_server_ping_ms Latency of the last health ping (ms)', '# TYPE mcp_gateway_server_ping_ms gauge');
+                for (const s of pinged)
+                    lines.push(`mcp_gateway_server_ping_ms{server="${escapeLabel(s.id)}"} ${s.latencyMs}`);
+            }
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────────────────
+    start() {
+        this.stop();
+        this.cleanupInterval = setInterval(() => this.prune(), 60_000);
+        this.cleanupInterval.unref();
+    }
+    /** Drop records older than the retention period. */
+    prune(now = Date.now()) {
+        const cutoff = now - this.retentionMs;
+        // Records are appended in time order: find the first one to keep.
+        let i = 0;
+        while (i < this.metrics.length && this.metrics[i].timestamp.getTime() < cutoff)
+            i++;
+        if (i > 0)
+            this.metrics.splice(0, i);
+        return i;
+    }
+    stop() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+    }
+    getRecent(limit = 100) {
+        if (!Number.isFinite(limit) || limit <= 0)
+            return [];
+        return this.metrics.slice(-Math.floor(limit)).reverse();
+    }
+    clear() {
+        this.metrics = [];
+        this.counters.clear();
+    }
+}
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.min(sorted.length - 1, Math.max(0, Math.ceil(p * sorted.length) - 1));
+    return sorted[idx];
+}
+function topN(counts, n = 10) {
+    return Array.from(counts.entries())
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, n);
+}
+function escapeLabel(v) {
+    return v.replace(/\\/g, '\\\\').replace(/\n/g, '\\n').replace(/"/g, '\\"');
+}
+//# sourceMappingURL=index.js.map

package/dist/monitor/index.js.map

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

package/dist/proxy/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * MCP Proxy
+ * Routes tool-call requests to the appropriate upstream MCP server over any
+ * supported transport: `stdio`, `sse` (HTTP+SSE, 2024-11-05), `websocket`
+ * and `streamable-http` (2025-03-26+).
+ *
+ * The proxy is split in two layers:
+ *  - a *channel* per transport (`src/transport/*`) that only moves JSON-RPC
+ *    messages, and
+ *  - this transport-independent *session* layer: MCP handshake, request/
+ *    response correlation, timeouts + upstream cancellation, `maxConcurrency`,
+ *    answering server→client requests (`ping`), `tools/list` pagination and
+ *    `notifications/tools/list_changed`.
+ *
+ * Events:
+ *  - `disconnected` (serverId, error) — a session was lost unexpectedly
+ *    (process exit, socket/stream closed, session expired). Not emitted for
+ *    `disconnect()`. The gateway supervisor uses it to reconnect.
+ *  - `tools-changed` (serverId, tools) — the server announced a new tool list.
+ *
+ * Fixes kept from v0.2.0 / the audit: per-server connect mutex (BUG-001),
+ * monotonic ids (BUG-002), no leaked sessions on failed `initialize`, an old
+ * session's exit can never remove a newer one, server requests with colliding
+ * ids are answered instead of mistaken for responses.
+ *
+ * @module proxy
+ */
+import { EventEmitter } from 'events';
+import type { McpServerConfig, ProxyResponse, ToolInfo } from '../utils/types.js';
+import type { ChannelFactory } from '../transport/channel.js';
+/** Protocol version the gateway asks for in `initialize`. */
+export declare const MCP_PROTOCOL_VERSION = "2025-06-18";
+/** Versions the gateway understands; servers may answer with any of them. */
+export declare const SUPPORTED_PROTOCOL_VERSIONS: string[];
+export declare const ERR_NOT_CONNECTED = -32000;
+export declare const ERR_TIMEOUT = -32001;
+/** Default channel per transport. */
+export declare const defaultChannelFactory: ChannelFactory;
+export interface SessionInfo {
+    transport: string;
+    protocolVersion?: string;
+    serverInfo?: {
+        name?: string;
+        version?: string;
+    };
+    connectedAt?: Date;
+}
+export interface ProxyOptions {
+    /** Grace period between closing stdin / SIGTERM / SIGKILL (and for WS/HTTP close). */
+    killGraceMs?: number;
+    /** Override how channels are created (for tests or custom transports). */
+    channelFactory?: ChannelFactory;
+}
+export declare class McpProxy extends EventEmitter {
+    private sessions;
+    private spawnLocks;
+    private readonly killGraceMs;
+    private readonly channelFactory;
+    constructor(options?: ProxyOptions);
+    private getSpawnLock;
+    connect(config: McpServerConfig): Promise<ToolInfo[]>;
+    private _handshake;
+    private _listTools;
+    disconnect(serverId: string): Promise<void>;
+    private _disconnectUnlocked;
+    disconnectAll(): Promise<void>;
+    callTool(serverId: string, toolName: string, args: Record<string, unknown>, timeout?: number): Promise<ProxyResponse>;
+    /** MCP `ping`: resolves with the round-trip latency (ms), or rejects if the server does not answer. */
+    ping(serverId: string, timeout?: number): Promise<number>;
+    isConnected(serverId: string): boolean;
+    /** Negotiated session details (for /servers). */
+    getSessionInfo(serverId: string): SessionInfo | undefined;
+    /** In-flight and queued tool calls for a server (for monitoring). */
+    getLoad(serverId: string): {
+        inFlight: number;
+        queued: number;
+    } | undefined;
+    private _onChannelLost;
+    private _rejectAll;
+    private _onMessage;
+    private _refreshTools;
+    private _answerServerRequest;
+    private _notify;
+    private _sendRequest;
+}
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAKlF,OAAO,KAAK,EAAE,cAAc,EAA8D,MAAM,yBAAyB,CAAC;AAM1H,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B,UAA6C,CAAC;AAMtF,eAAO,MAAM,iBAAiB,SAAS,CAAC;AACxC,eAAO,MAAM,WAAW,SAAS,CAAC;AAQlC,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,EAAE,cAanC,CAAC;AAqBF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,qBAAa,QAAS,SAAQ,YAAY;IACxC,OAAO,CAAC,QAAQ,CAA8B;IAE9C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAEpC,OAAO,GAAE,YAAiB;IAMtC,OAAO,CAAC,YAAY;IAWd,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;YA0C7C,UAAU;YAoCV,UAAU;IAgClB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAInC,mBAAmB;IAY3B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC;IAkBzB,uGAAuG;IACjG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAY9D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKtC,iDAAiD;IACjD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAWzD,qEAAqE;IACrE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAO3E,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,oBAAoB;YAQd,OAAO;YAOP,YAAY;CA+E3B"}