@winstonsayno/mcp-gateway 5.0.0 → 5.2.0

package/dist/features/conformance.js

@@ -0,0 +1,236 @@
+/**
+ * MCP conformance suite (5.1): black-box checks of a Streamable HTTP MCP endpoint against the protocol revisions
+ * the gateway speaks. Used by `mcp-gateway conformance <url>`, `POST /api/v1/admin/conformance/run` (self-test of
+ * this gateway's `/mcp`) and the test suite.
+ *
+ * Every check is independent and reports `pass` / `fail` / `skip` with a reason; the run never throws.
+ *
+ * @module features/conformance
+ */
+import { PROTOCOL_VERSIONS } from '../mcp/compat.js';
+import { registerFeature } from '../gateway/features.js';
+async function post(ctx, body, extra = {}) {
+    const res = await ctx.f(ctx.url, {
+        method: 'POST',
+        headers: {
+            'content-type': 'application/json',
+            accept: 'application/json, text/event-stream',
+            ...ctx.headers,
+            ...(ctx.session ? { 'mcp-session-id': ctx.session } : {}),
+            ...(ctx.version ? { 'mcp-protocol-version': ctx.version } : {}),
+            ...extra,
+        },
+        body: typeof body === 'string' ? body : JSON.stringify(body),
+    });
+    const text = await res.text();
+    let parsed = undefined;
+    if (text) {
+        const ct = res.headers.get('content-type') ?? '';
+        if (ct.includes('text/event-stream')) {
+            const data = text.split('\n').filter((l) => l.startsWith('data:')).map((l) => l.slice(5).trim());
+            parsed = data.length ? JSON.parse(data[data.length - 1]) : undefined;
+        }
+        else {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                parsed = text;
+            }
+        }
+    }
+    return { status: res.status, headers: res.headers, body: parsed };
+}
+const init = (version, id = 1) => ({
+    jsonrpc: '2.0',
+    id,
+    method: 'initialize',
+    params: { protocolVersion: version, capabilities: {}, clientInfo: { name: 'mcp-gateway-conformance', version: '1' } },
+});
+class Fail extends Error {
+}
+const expect = (cond, msg) => {
+    if (!cond)
+        throw new Fail(msg);
+};
+export const CHECKS = [
+    {
+        id: 'initialize',
+        title: 'initialize negotiates the latest revision and returns a session id',
+        run: async (ctx) => {
+            const r = await post(ctx, init(PROTOCOL_VERSIONS[0]));
+            expect(r.status === 200, `HTTP ${r.status}`);
+            expect(r.body?.result?.protocolVersion, 'no result.protocolVersion');
+            expect(r.body.result.serverInfo?.name, 'no serverInfo.name');
+            expect(r.body.result.capabilities && typeof r.body.result.capabilities === 'object', 'no capabilities');
+            return `protocol ${r.body.result.protocolVersion}`;
+        },
+    },
+    {
+        id: 'version-negotiation',
+        title: 'every advertised revision is accepted; an unknown revision gets a supported one',
+        run: async (ctx) => {
+            const accepted = [];
+            for (const v of PROTOCOL_VERSIONS) {
+                const r = await post({ ...ctx, session: undefined, version: undefined }, init(v));
+                if (r.body?.result?.protocolVersion === v)
+                    accepted.push(v);
+            }
+            expect(accepted.length > 0, 'no revision accepted');
+            const r = await post({ ...ctx, session: undefined, version: undefined }, init('1999-01-01'));
+            const got = r.body?.result?.protocolVersion;
+            expect(typeof got === 'string' && PROTOCOL_VERSIONS.includes(got), `unknown revision answered with ${JSON.stringify(got)}`);
+            return `accepted ${accepted.join(', ')}`;
+        },
+    },
+    {
+        id: 'parse-error',
+        title: 'malformed JSON gets JSON-RPC -32700',
+        run: async (ctx) => {
+            const r = await post(ctx, '{not json');
+            expect(r.body?.error?.code === -32700, `got ${JSON.stringify(r.body?.error ?? r.status)}`);
+        },
+    },
+    {
+        id: 'invalid-request',
+        title: 'a non-JSON-RPC body gets -32600',
+        run: async (ctx) => {
+            const r = await post(ctx, { hello: 'world' });
+            expect(r.body?.error?.code === -32600, `got ${JSON.stringify(r.body?.error ?? r.status)}`);
+        },
+    },
+    {
+        id: 'ping',
+        title: 'ping answers with an empty result',
+        needsSession: true,
+        run: async (ctx) => {
+            const r = await post(ctx, { jsonrpc: '2.0', id: 'p', method: 'ping' });
+            expect(r.body?.id === 'p' && r.body?.result && typeof r.body.result === 'object', `got ${JSON.stringify(r.body)}`);
+        },
+    },
+    {
+        id: 'method-not-found',
+        title: 'an unknown method gets -32601',
+        needsSession: true,
+        run: async (ctx) => {
+            const r = await post(ctx, { jsonrpc: '2.0', id: 9, method: 'no/such/method' });
+            expect(r.body?.error?.code === -32601, `got ${JSON.stringify(r.body?.error ?? r.body)}`);
+        },
+    },
+    {
+        id: 'notification-202',
+        title: 'notifications are acknowledged with 202 and no body',
+        needsSession: true,
+        run: async (ctx) => {
+            const r = await post(ctx, { jsonrpc: '2.0', method: 'notifications/initialized' });
+            expect(r.status === 202, `HTTP ${r.status}`);
+        },
+    },
+    {
+        id: 'tools-list',
+        title: 'tools/list returns tools with name and inputSchema',
+        needsSession: true,
+        run: async (ctx) => {
+            const r = await post(ctx, { jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} });
+            const tools = r.body?.result?.tools;
+            expect(Array.isArray(tools), `no result.tools: ${JSON.stringify(r.body).slice(0, 200)}`);
+            for (const t of tools)
+                expect(typeof t.name === 'string' && t.inputSchema && typeof t.inputSchema === 'object', `bad tool ${JSON.stringify(t).slice(0, 120)}`);
+            return `${tools.length} tools`;
+        },
+    },
+    {
+        id: 'unknown-tool',
+        title: 'calling an unknown tool is an error (JSON-RPC error or isError result)',
+        needsSession: true,
+        run: async (ctx) => {
+            const r = await post(ctx, { jsonrpc: '2.0', id: 3, method: 'tools/call', params: { name: '__conformance_missing__', arguments: {} } });
+            expect(r.body?.error || r.body?.result?.isError === true, `got ${JSON.stringify(r.body).slice(0, 200)}`);
+        },
+    },
+    {
+        id: 'bad-protocol-header',
+        title: 'an unsupported MCP-Protocol-Version header is rejected with 400',
+        needsSession: true,
+        run: async (ctx) => {
+            const r = await post(ctx, { jsonrpc: '2.0', id: 4, method: 'ping' }, { 'mcp-protocol-version': '1999-01-01' });
+            expect(r.status === 400, `HTTP ${r.status}`);
+        },
+    },
+    {
+        id: 'unknown-session',
+        title: 'a request with an unknown session id gets 404',
+        run: async (ctx) => {
+            const r = await post({ ...ctx, session: 'conformance-unknown-session' }, { jsonrpc: '2.0', id: 5, method: 'ping' });
+            expect(r.status === 404, `HTTP ${r.status}`);
+        },
+    },
+];
+/** Run the suite against a Streamable HTTP MCP endpoint. */
+export async function runConformance(url, opts = {}) {
+    const started = Date.now();
+    const ctx = { url, f: opts.fetch ?? fetch, headers: opts.headers ?? {} };
+    const checks = [];
+    const selected = CHECKS.filter((c) => !opts.only?.length || opts.only.includes(c.id));
+    let sessionError;
+    if (selected.some((c) => c.needsSession)) {
+        try {
+            const r = await post(ctx, init(PROTOCOL_VERSIONS[0]));
+            ctx.session = r.headers.get('mcp-session-id') ?? undefined;
+            ctx.version = r.body?.result?.protocolVersion;
+            if (!ctx.version)
+                sessionError = `initialize failed (HTTP ${r.status})`;
+            else
+                await post(ctx, { jsonrpc: '2.0', method: 'notifications/initialized' });
+        }
+        catch (e) {
+            sessionError = `initialize failed: ${e.message}`;
+        }
+    }
+    for (const c of selected) {
+        if (c.needsSession && sessionError) {
+            checks.push({ id: c.id, title: c.title, status: 'skip', detail: sessionError });
+            continue;
+        }
+        try {
+            const detail = await c.run(ctx);
+            checks.push({ id: c.id, title: c.title, status: 'pass', ...(detail ? { detail } : {}) });
+        }
+        catch (e) {
+            checks.push({ id: c.id, title: c.title, status: 'fail', detail: e.message });
+        }
+    }
+    const n = (s) => checks.filter((c) => c.status === s).length;
+    return { url, startedAt: new Date(started).toISOString(), durationMs: Date.now() - started, passed: n('pass'), failed: n('fail'), skipped: n('skip'), checks };
+}
+/** Plain-text rendering for the CLI. */
+export function formatReport(r) {
+    const mark = { pass: '✓', fail: '✗', skip: '-' };
+    return [
+        `MCP conformance — ${r.url}`,
+        ...r.checks.map((c) => `  ${mark[c.status]} ${c.id}: ${c.title}${c.detail ? ` (${c.detail})` : ''}`),
+        `${r.passed} passed, ${r.failed} failed, ${r.skipped} skipped in ${r.durationMs} ms`,
+    ].join('\n');
+}
+registerFeature({
+    id: 'conformance',
+    since: '5.1.0',
+    summary: 'MCP conformance self-test of this gateway\'s /mcp endpoint',
+    mount: (router, ctx) => {
+        router.get('/checks', (_req, res) => void res.json({ checks: CHECKS.map(({ id, title }) => ({ id, title })) }));
+        router.post('/run', async (req, res) => {
+            const base = ctx.baseUrl();
+            if (!base)
+                return void res.status(503).json({ error: 'Service Unavailable', message: 'gateway is not listening' });
+            if (ctx.config().mcp?.enabled === false)
+                return void res.status(409).json({ error: 'Conflict', message: 'the MCP endpoint is disabled (mcp.enabled: false)' });
+            const only = Array.isArray(req.body?.only) ? (req.body.only.map(String)) : undefined;
+            const headers = {};
+            for (const h of ['authorization', 'x-api-key'])
+                if (req.headers[h])
+                    headers[h] = String(req.headers[h]);
+            res.json(await runConformance(base + (ctx.config().mcp?.path ?? '/mcp'), { only, headers }));
+        });
+    },
+});
+//# sourceMappingURL=conformance.js.map

package/dist/features/conformance.js.map

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

package/dist/features/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Built-in feature modules (5.1+). Importing this module registers each of them with the feature registry
+ * ({@link ../gateway/features.ts}); they are mounted under `/api/v1/admin/<id>`.
+ *
+ * @module features
+ */
+import './conformance.js';
+import './regions.js';
+export { listFeatures, registerFeature, createFeatureRouter } from '../gateway/features.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/features/index.js

@@ -0,0 +1,10 @@
+/**
+ * Built-in feature modules (5.1+). Importing this module registers each of them with the feature registry
+ * ({@link ../gateway/features.ts}); they are mounted under `/api/v1/admin/<id>`.
+ *
+ * @module features
+ */
+import './conformance.js';
+import './regions.js';
+export { listFeatures, registerFeature, createFeatureRouter } from '../gateway/features.js';
+//# sourceMappingURL=index.js.map

package/dist/features/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/features/regions.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Multi-region active-active (5.2).
+ *
+ * Every region runs a full gateway. Regions replicate a small shared key-value state (last-writer-wins per key,
+ * ties broken by region id) and gossip which upstream servers are online, so a call whose upstream is down locally
+ * can be failed over to a region that has it.
+ *
+ * ```yaml
+ * regions:
+ *   self: eu-west
+ *   syncIntervalMs: 5000
+ *   peers:
+ *     - { id: us-east, url: https://us.gw.example.com, apiKey: ${US_ADMIN_KEY}, priority: 1 }
+ * ```
+ *
+ * - `GET  /admin/regions` — this region, peers (health, last sync, servers online), replicated key count.
+ * - `POST /admin/regions/sync` — peer exchange `{ region, since, entries, servers }` → `{ region, entries, servers }`.
+ * - `GET|PUT|DELETE /admin/regions/kv/:key` — replicated state (`PUT` body `{ value }`).
+ * - `GET  /admin/regions/route/:serverId` — where a call to that server should run: `local`, a peer, or none.
+ *
+ * @module features/regions
+ */
+import { z } from 'zod';
+export declare const RegionsSchema: z.ZodObject<{
+    self: z.ZodString;
+    syncIntervalMs: z.ZodDefault<z.ZodNumber>;
+    /** Consecutive failed syncs before a peer is considered down. */
+    downAfter: z.ZodDefault<z.ZodNumber>;
+    peers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodString>;
+        priority: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        priority: number;
+        apiKey?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        apiKey?: string | undefined;
+        priority?: number | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    self: string;
+    syncIntervalMs: number;
+    downAfter: number;
+    peers: {
+        id: string;
+        url: string;
+        priority: number;
+        apiKey?: string | undefined;
+    }[];
+}, {
+    self: string;
+    syncIntervalMs?: number | undefined;
+    downAfter?: number | undefined;
+    peers?: {
+        id: string;
+        url: string;
+        apiKey?: string | undefined;
+        priority?: number | undefined;
+    }[] | undefined;
+}>;
+export type RegionsConfig = z.input<typeof RegionsSchema>;
+type Resolved = z.output<typeof RegionsSchema>;
+export interface ReplicatedEntry {
+    key: string;
+    /** `null` = tombstone (deleted). */
+    value: unknown;
+    /** Hybrid timestamp: wall-clock ms, bumped to stay monotonic per region. */
+    ts: number;
+    region: string;
+}
+export interface PeerState {
+    id: string;
+    url: string;
+    priority: number;
+    status: 'unknown' | 'up' | 'down';
+    failures: number;
+    lastSync?: string;
+    lastError?: string;
+    /** Highest `ts` received from this peer (sync cursor). */
+    cursor: number;
+    servers: string[];
+}
+/** Last-writer-wins: newer ts wins; equal ts → lexicographically larger region wins. */
+export declare const newer: (a: ReplicatedEntry, b: ReplicatedEntry | undefined) => boolean;
+export declare class RegionMesh {
+    private cfg;
+    private readonly now;
+    private readonly entries;
+    private readonly peers;
+    private clock;
+    private timer?;
+    constructor(cfg: Resolved, now?: () => number);
+    get self(): string;
+    configure(cfg: Resolved): void;
+    private tick;
+    get(key: string): unknown;
+    put(key: string, value: unknown): ReplicatedEntry;
+    delete(key: string): boolean;
+    size(): number;
+    /** Merge remote entries; returns how many changed local state. */
+    merge(entries: ReplicatedEntry[]): number;
+    /** Entries changed after `since` (any origin, so state relays through intermediate regions). */
+    delta(since?: number): ReplicatedEntry[];
+    peerList(): PeerState[];
+    /** Record a peer's gossip (from an inbound or outbound sync). */
+    sawPeer(id: string, servers: unknown, cursor?: number): void;
+    peerFailed(id: string, err: string): void;
+    /** Where a call to `serverId` should run. */
+    route(serverId: string, localOnline: string[]): {
+        target: 'local';
+    } | {
+        target: 'peer';
+        peer: string;
+        url: string;
+    } | {
+        target: 'none';
+    };
+    /** One outbound sync round with every peer. */
+    syncOnce(localOnline: string[], f?: typeof fetch): Promise<void>;
+    start(localOnline: () => string[], f?: typeof fetch): void;
+    stop(): void;
+    status(): Record<string, unknown>;
+}
+/** Resolve (validate + defaults) a `regions` section. */
+export declare const resolveRegions: (raw: unknown) => Resolved;
+export {};
+//# sourceMappingURL=regions.d.ts.map

package/dist/features/regions.d.ts.map

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