@winstonsayno/mcp-gateway 2.6.0 → 2.7.0

package/CHANGELOG.md

@@ -9,6 +9,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.7.0] - 2026-10-07
+
+Bridges: OpenAI-compatible tools proxy and A2A agent card.
+
+### Added
+- **OpenAI-compatible tools proxy** (`openai:`): `GET /openai/v1/tools` (function tools + name mapping),
+  `POST /openai/v1/tool_calls` (execute `tool_calls`, get `role: "tool"` messages) and
+  `POST /openai/v1/chat/completions` (forward to `openai.upstream`, inject gateway tools, run the tool loop up to
+  `maxToolRounds`; caller-supplied tools are returned untouched; `stream: true` passes through).
+- **A2A bridge** (`a2a:`): Agent Card at `/.well-known/agent-card.json` (and `/.well-known/agent.json`), one skill per
+  visible tool; JSON-RPC `message/send` / `tasks/get` at `a2a.path` (default `/a2a`); results as A2A Tasks with
+  artifacts.
+- Bridge calls run through the regular REST checks (auth, scopes, tenants, policy, quotas, cache, output filter).
+- `validateConfig()` exported from the config loader.
+- Docs: [Bridges](docs/guides/bridges.md).
+
 ## [2.6.0] - 2026-10-07
 
 Edge runtimes: Cloudflare Workers, Deno and Bun adapters for the HTTP transport.

package/README.md

@@ -579,6 +579,15 @@ await gateway.start();
 process.on('SIGTERM', () => gateway.stop());
 ```
 
+## What's New in v2.7
+
+| Feature | Description |
+|---------|-------------|
+| **OpenAI tools proxy** | `/openai/v1/tools`, `/tool_calls`, `/chat/completions` with an automatic tool loop |
+| **A2A bridge** | Agent Card at `/.well-known/agent-card.json` + JSON-RPC `message/send` — [guide](docs/guides/bridges.md) |
+
+Details: [CHANGELOG](CHANGELOG.md).
+
 ## What's New in v2.6
 
 | Feature | Description |

package/dist/bridges/a2a.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A2A (Agent2Agent) bridge: publishes the gateway's tools as an A2A agent.
+ *
+ * - `GET /.well-known/agent-card.json` (and the older `/.well-known/agent.json`): the Agent Card — one skill per
+ *   gateway tool the caller could see (anonymous callers see the card only when `a2a.public` is true or auth is off).
+ * - `POST <a2a.path>` (default `/a2a`): JSON-RPC 2.0 with `message/send` and `tasks/get`. A message selects a tool
+ *   with a data part `{ "kind": "data", "data": { "skill": "<skill id>", "arguments": { … } } }` (or message
+ *   `metadata.skill` + a data part with the arguments). The tool runs through the regular REST checks; the reply is
+ *   a completed (or failed) Task whose artifact carries the tool result as text and data parts.
+ *
+ * Tasks are kept in memory for `a2a.taskRetentionSeconds` (600).
+ *
+ * @module bridges/a2a
+ */
+import express, { type Request, type RequestHandler } from 'express';
+import type { A2ABridgeConfig, ToolInfo } from '../utils/types.js';
+import { type ToolCallResponse } from '../gateway/api.js';
+export declare const A2A_PROTOCOL_VERSION = "0.3.0";
+export interface A2ABridgeDeps {
+    config: () => A2ABridgeConfig | undefined;
+    tools: () => ToolInfo[];
+    naming: () => 'auto' | 'prefix';
+    authenticate: RequestHandler;
+    authRequired: () => boolean;
+    runToolCall: (req: Request, body: Record<string, unknown>, res: ToolCallResponse) => Promise<void>;
+}
+export declare function createA2ARouter(deps: A2ABridgeDeps): express.Router;
+//# sourceMappingURL=a2a.d.ts.map

package/dist/bridges/a2a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.d.ts","sourceRoot":"","sources":["../../src/bridges/a2a.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,OAAO,EAAE,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAInE,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,eAAe,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,MAAM,QAAQ,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,MAAM,GAAG,QAAQ,CAAC;IAChC,YAAY,EAAE,cAAc,CAAC;IAC7B,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpG;AAkCD,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CA8GnE"}

package/dist/bridges/a2a.js

@@ -0,0 +1,161 @@
+/**
+ * A2A (Agent2Agent) bridge: publishes the gateway's tools as an A2A agent.
+ *
+ * - `GET /.well-known/agent-card.json` (and the older `/.well-known/agent.json`): the Agent Card — one skill per
+ *   gateway tool the caller could see (anonymous callers see the card only when `a2a.public` is true or auth is off).
+ * - `POST <a2a.path>` (default `/a2a`): JSON-RPC 2.0 with `message/send` and `tasks/get`. A message selects a tool
+ *   with a data part `{ "kind": "data", "data": { "skill": "<skill id>", "arguments": { … } } }` (or message
+ *   `metadata.skill` + a data part with the arguments). The tool runs through the regular REST checks; the reply is
+ *   a completed (or failed) Task whose artifact carries the tool result as text and data parts.
+ *
+ * Tasks are kept in memory for `a2a.taskRetentionSeconds` (600).
+ *
+ * @module bridges/a2a
+ */
+import express from 'express';
+import { randomUUID } from 'crypto';
+import { toLlmToolSchemas } from '../mcp/llm-schemas.js';
+import { filterToolsByScope } from '../auth/scopes.js';
+import { CapturedResponse } from '../gateway/api.js';
+import { VERSION } from '../utils/version.js';
+export const A2A_PROTOCOL_VERSION = '0.3.0';
+const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+function skillsFor(scope, deps) {
+    const tools = filterToolsByScope(scope, deps.tools());
+    const schemas = toLlmToolSchemas(tools, 'openai', deps.naming());
+    const byTarget = new Map(tools.map((t) => [`${t.serverId}\u0000${t.name}`, t]));
+    return Object.entries(schemas.mapping).map(([id, target]) => {
+        const t = byTarget.get(`${target.server}\u0000${target.tool}`);
+        return {
+            id,
+            name: t?.title ?? target.tool,
+            description: t?.description ?? `${target.tool} on ${target.server}`,
+            tags: [target.server, 'mcp-tool'],
+            inputModes: ['application/json'],
+            outputModes: ['application/json', 'text/plain'],
+            target,
+            inputSchema: t?.inputSchema,
+        };
+    });
+}
+export function createA2ARouter(deps) {
+    const router = express.Router();
+    const tasks = new Map();
+    const path = () => deps.config()?.path ?? '/a2a';
+    const enabled = () => deps.config()?.enabled === true;
+    const prune = () => {
+        const now = Date.now();
+        for (const [k, v] of tasks)
+            if (v.expires <= now)
+                tasks.delete(k);
+    };
+    const card = (req) => {
+        const cfg = deps.config() ?? {};
+        const base = cfg.url ?? `${req.protocol}://${req.get('host')}`;
+        const skills = skillsFor(req.scope, deps).map(({ target: _t, inputSchema: _s, ...s }) => s);
+        return {
+            protocolVersion: A2A_PROTOCOL_VERSION,
+            name: cfg.name ?? 'mcp-gateway',
+            description: cfg.description ?? 'MCP tools exposed as A2A skills by mcp-gateway',
+            url: `${base.replace(/\/+$/, '')}${path()}`,
+            preferredTransport: 'JSONRPC',
+            version: VERSION,
+            provider: cfg.provider,
+            capabilities: { streaming: false, pushNotifications: false, stateTransitionHistory: false },
+            defaultInputModes: ['application/json'],
+            defaultOutputModes: ['application/json', 'text/plain'],
+            ...(deps.authRequired() ? { securitySchemes: { bearer: { type: 'http', scheme: 'bearer' } }, security: [{ bearer: [] }] } : {}),
+            skills,
+        };
+    };
+    // Agent card: authenticated when auth is on and the card is not public (skills reflect the caller's scope).
+    const cardAuth = (req, res, next) => {
+        if (!enabled())
+            return void res.status(404).json({ error: 'Not Found' });
+        if (deps.config()?.public && !req.headers.authorization)
+            return next();
+        return deps.authenticate(req, res, next);
+    };
+    router.get(['/.well-known/agent-card.json', '/.well-known/agent.json'], cardAuth, (req, res) => {
+        res.set('Cache-Control', 'no-store').json(card(req));
+    });
+    router.post('*', (req, res, next) => {
+        if (!enabled() || req.path !== path())
+            return next();
+        deps.authenticate(req, res, async () => {
+            const msg = (req.body ?? {});
+            const id = (msg.id ?? null);
+            const reply = (body) => res.json({ jsonrpc: '2.0', id, ...body });
+            const error = (code, message) => reply({ error: { code, message } });
+            if (msg.jsonrpc !== '2.0' || typeof msg.method !== 'string')
+                return error(-32600, 'Invalid Request');
+            prune();
+            try {
+                if (msg.method === 'tasks/get') {
+                    const tid = isObj(msg.params) ? msg.params.id : undefined;
+                    const t = typeof tid === 'string' ? tasks.get(tid) : undefined;
+                    if (!t)
+                        return error(-32001, 'Task not found');
+                    return reply({ result: t.task });
+                }
+                if (msg.method === 'tasks/cancel')
+                    return error(-32002, 'Task cannot be canceled (tasks complete synchronously)');
+                if (msg.method !== 'message/send')
+                    return error(-32601, `Method not found: ${msg.method}`);
+                const params = isObj(msg.params) ? msg.params : {};
+                const message = isObj(params.message) ? params.message : undefined;
+                const parts = message && Array.isArray(message.parts) ? message.parts.filter(isObj) : [];
+                if (!message || parts.length === 0)
+                    return error(-32602, 'params.message with parts is required');
+                const data = parts.find((p) => p.kind === 'data' && isObj(p.data))?.data;
+                const meta = isObj(message.metadata) ? message.metadata : {};
+                const skillId = typeof data?.skill === 'string' ? data.skill : typeof meta.skill === 'string' ? meta.skill : undefined;
+                const skills = skillsFor(req.scope, deps);
+                const skill = skillId ? skills.find((s) => s.id === skillId) : skills.length === 1 ? skills[0] : undefined;
+                const contextId = typeof message.contextId === 'string' ? message.contextId : randomUUID();
+                const task = { kind: 'task', id: randomUUID(), contextId, status: { state: 'completed', timestamp: new Date().toISOString() }, history: [message] };
+                if (!skill) {
+                    task.status = {
+                        state: 'rejected',
+                        timestamp: new Date().toISOString(),
+                        message: { kind: 'message', role: 'agent', messageId: randomUUID(), parts: [{ kind: 'text', text: skillId ? `Unknown skill "${skillId}"` : 'Choose a skill: send a data part { "skill": "<id>", "arguments": {…} }' }] },
+                    };
+                }
+                else {
+                    const args = isObj(data?.arguments) ? data.arguments : isObj(data) && !('skill' in data) ? data : {};
+                    const out = new CapturedResponse();
+                    await deps.runToolCall(req, { tool: skill.target.tool, server: skill.target.server, arguments: args }, out);
+                    const body = isObj(out.body) ? out.body : {};
+                    if (out.statusCode === 200) {
+                        const result = body.result;
+                        const text = (result?.content ?? []).filter((c) => c.type === 'text').map((c) => c.text ?? '').join('\n');
+                        task.artifacts = [
+                            {
+                                artifactId: randomUUID(),
+                                name: `${skill.id} result`,
+                                parts: [...(text ? [{ kind: 'text', text }] : []), { kind: 'data', data: (result?.structuredContent ?? result ?? null) }],
+                            },
+                        ];
+                        if (result?.isError)
+                            task.status = { state: 'failed', timestamp: new Date().toISOString() };
+                    }
+                    else {
+                        task.status = {
+                            state: out.statusCode === 403 || out.statusCode === 429 ? 'rejected' : 'failed',
+                            timestamp: new Date().toISOString(),
+                            message: { kind: 'message', role: 'agent', messageId: randomUUID(), parts: [{ kind: 'text', text: String(body.message ?? body.error ?? `HTTP ${out.statusCode}`) }], metadata: { httpStatus: out.statusCode, code: body.code } },
+                        };
+                    }
+                    task.metadata = { skill: skill.id, server: skill.target.server, tool: skill.target.tool };
+                }
+                tasks.set(task.id, { task, expires: Date.now() + (deps.config()?.taskRetentionSeconds ?? 600) * 1000 });
+                return reply({ result: task });
+            }
+            catch (err) {
+                return error(-32603, err instanceof Error ? err.message : String(err));
+            }
+        });
+    });
+    return router;
+}
+//# sourceMappingURL=a2a.js.map

package/dist/bridges/a2a.js.map

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

package/dist/bridges/openai.d.ts

@@ -0,0 +1,42 @@
+/**
+ * OpenAI-compatible tools proxy.
+ *
+ * - `GET  <path>/tools` — the caller's gateway tools as OpenAI function tools (+ name mapping).
+ * - `POST <path>/tool_calls` — execute OpenAI `tool_calls` (or an assistant message carrying them) and get the
+ *   `role: "tool"` messages to append to the conversation.
+ * - `POST <path>/chat/completions` — when `openai.upstream` is set: forward to an OpenAI-compatible API, inject the
+ *   gateway tools, execute gateway tool calls and loop until the model answers (`maxToolRounds`). Calls to tools the
+ *   caller supplied itself are returned to the caller untouched. `stream: true` is forwarded as is (no tool loop).
+ *
+ * Tool calls go through the same checks as `POST /api/v1/tools/call` (scopes, tenants, policy, quotas, cache).
+ *
+ * @module bridges/openai
+ */
+import express, { type Request, type RequestHandler } from 'express';
+import type { OpenAIBridgeConfig, ToolInfo } from '../utils/types.js';
+import { type LlmToolSchemas } from '../mcp/llm-schemas.js';
+import { type ToolCallResponse } from '../gateway/api.js';
+export interface OpenAIBridgeDeps {
+    config: () => OpenAIBridgeConfig | undefined;
+    tools: () => ToolInfo[];
+    naming: () => 'auto' | 'prefix';
+    authenticate: RequestHandler;
+    runToolCall: (req: Request, body: Record<string, unknown>, res: ToolCallResponse) => Promise<void>;
+    fetch?: typeof fetch;
+}
+interface OpenAIToolCall {
+    id: string;
+    type?: string;
+    function: {
+        name: string;
+        arguments?: string;
+    };
+}
+export declare function executeToolCalls(req: Request, calls: OpenAIToolCall[], schemas: LlmToolSchemas, run: OpenAIBridgeDeps['runToolCall']): Promise<Array<{
+    role: 'tool';
+    tool_call_id: string;
+    content: string;
+}>>;
+export declare function createOpenAIRouter(deps: OpenAIBridgeDeps): express.Router;
+export {};
+//# sourceMappingURL=openai.d.ts.map

package/dist/bridges/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/bridges/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,OAAO,EAAE,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAiB,MAAM,SAAS,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG9E,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,kBAAkB,GAAG,SAAS,CAAC;IAC7C,KAAK,EAAE,MAAM,QAAQ,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,MAAM,GAAG,QAAQ,CAAC;IAChC,YAAY,EAAE,cAAc,CAAC;IAC7B,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAqBD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,gBAAgB,CAAC,aAAa,CAAC,GACnC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAgBzE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAmFzE"}

package/dist/bridges/openai.js

@@ -0,0 +1,142 @@
+/**
+ * OpenAI-compatible tools proxy.
+ *
+ * - `GET  <path>/tools` — the caller's gateway tools as OpenAI function tools (+ name mapping).
+ * - `POST <path>/tool_calls` — execute OpenAI `tool_calls` (or an assistant message carrying them) and get the
+ *   `role: "tool"` messages to append to the conversation.
+ * - `POST <path>/chat/completions` — when `openai.upstream` is set: forward to an OpenAI-compatible API, inject the
+ *   gateway tools, execute gateway tool calls and loop until the model answers (`maxToolRounds`). Calls to tools the
+ *   caller supplied itself are returned to the caller untouched. `stream: true` is forwarded as is (no tool loop).
+ *
+ * Tool calls go through the same checks as `POST /api/v1/tools/call` (scopes, tenants, policy, quotas, cache).
+ *
+ * @module bridges/openai
+ */
+import express from 'express';
+import { toLlmToolSchemas } from '../mcp/llm-schemas.js';
+import { filterToolsByScope } from '../auth/scopes.js';
+import { CapturedResponse } from '../gateway/api.js';
+import { logger } from '../utils/logger.js';
+const isObj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+function schemasFor(req, deps) {
+    const scope = req.scope;
+    return toLlmToolSchemas(filterToolsByScope(scope, deps.tools()), 'openai', deps.naming());
+}
+/** Text content for a `role: "tool"` message from a gateway call outcome. */
+function toolContent(status, body) {
+    if (status === 200 && isObj(body)) {
+        const result = body.result;
+        if (result?.structuredContent !== undefined)
+            return JSON.stringify(result.structuredContent);
+        const text = (result?.content ?? []).filter((c) => c.type === 'text' && typeof c.text === 'string').map((c) => c.text).join('\n');
+        return text || JSON.stringify(result ?? null);
+    }
+    const msg = isObj(body) ? (body.message ?? body.error) : body;
+    return JSON.stringify({ error: String(msg ?? `HTTP ${status}`), status });
+}
+export async function executeToolCalls(req, calls, schemas, run) {
+    return Promise.all(calls.map(async (c) => {
+        const target = schemas.mapping[c.function?.name];
+        if (!target)
+            return { role: 'tool', tool_call_id: c.id, content: JSON.stringify({ error: `Unknown tool "${c.function?.name}"` }) };
+        let args = {};
+        try {
+            args = c.function.arguments ? JSON.parse(c.function.arguments) : {};
+        }
+        catch {
+            return { role: 'tool', tool_call_id: c.id, content: JSON.stringify({ error: 'arguments are not valid JSON' }) };
+        }
+        const out = new CapturedResponse();
+        await run(req, { tool: target.tool, server: target.server, arguments: args }, out);
+        return { role: 'tool', tool_call_id: c.id, content: toolContent(out.statusCode, out.body) };
+    }));
+}
+export function createOpenAIRouter(deps) {
+    const router = express.Router();
+    const fetchImpl = deps.fetch ?? ((...a) => fetch(...a));
+    const enabled = (_req, res, next) => (!deps.config() || deps.config()?.enabled === false ? void res.status(404).json({ error: 'Not Found' }) : next());
+    router.get('/tools', enabled, deps.authenticate, (req, res) => {
+        res.json(schemasFor(req, deps));
+    });
+    router.post('/tool_calls', enabled, deps.authenticate, async (req, res, next) => {
+        try {
+            const b = (req.body ?? {});
+            const calls = (Array.isArray(b.tool_calls) ? b.tool_calls : isObj(b.message) && Array.isArray(b.message.tool_calls) ? b.message.tool_calls : undefined);
+            if (!calls || !calls.every((c) => isObj(c) && typeof c.id === 'string' && isObj(c.function) && typeof c.function.name === 'string')) {
+                return void res.status(400).json({ error: 'Bad Request', message: 'Body must be { "tool_calls": [{ "id", "function": { "name", "arguments" } }] }' });
+            }
+            res.json({ messages: await executeToolCalls(req, calls, schemasFor(req, deps), deps.runToolCall) });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.post('/chat/completions', enabled, deps.authenticate, async (req, res, next) => {
+        const cfg = deps.config() ?? {};
+        const up = cfg.upstream;
+        if (!up?.baseUrl)
+            return void res.status(501).json({ error: 'Not Implemented', message: 'openai.upstream.baseUrl is not configured' });
+        try {
+            const body = { ...(req.body ?? {}) };
+            const schemas = schemasFor(req, deps);
+            const ownTools = Array.isArray(body.tools) ? body.tools : [];
+            const ownNames = new Set(ownTools.map((t) => t.function?.name).filter(Boolean));
+            if (cfg.injectTools !== false && schemas.tools.length > 0) {
+                body.tools = [...ownTools, ...schemas.tools.filter((t) => !ownNames.has(t.function.name))];
+            }
+            const headers = { 'content-type': 'application/json', ...(up.headers ?? {}) };
+            if (up.apiKey)
+                headers.authorization = `Bearer ${up.apiKey}`;
+            const url = `${up.baseUrl.replace(/\/+$/, '')}/chat/completions`;
+            const send = (payload) => fetchImpl(url, { method: 'POST', headers, body: JSON.stringify(payload), signal: AbortSignal.timeout(up.timeoutMs ?? 120_000) });
+            if (body.stream === true) {
+                const r = await send(body);
+                res.status(r.status);
+                r.headers.forEach((v, k) => {
+                    if (!['content-length', 'content-encoding', 'transfer-encoding', 'connection'].includes(k))
+                        res.setHeader(k, v);
+                });
+                if (!r.body)
+                    return void res.end();
+                for await (const chunk of r.body)
+                    res.write(chunk);
+                return void res.end();
+            }
+            const messages = Array.isArray(body.messages) ? [...body.messages] : [];
+            const rounds = cfg.maxToolRounds ?? 5;
+            let executed = 0;
+            for (let round = 0;; round++) {
+                const r = await send({ ...body, messages });
+                const text = await r.text();
+                let data;
+                try {
+                    data = JSON.parse(text);
+                }
+                catch {
+                    return void res.status(502).json({ error: 'Bad Gateway', message: 'Upstream returned non-JSON', status: r.status });
+                }
+                if (!r.ok)
+                    return void res.status(r.status).json(data);
+                const choice = isObj(data) && Array.isArray(data.choices) ? data.choices[0] : undefined;
+                const msg = choice && isObj(choice.message) ? choice.message : undefined;
+                const calls = (msg && Array.isArray(msg.tool_calls) ? msg.tool_calls : []);
+                const mine = calls.filter((c) => schemas.mapping[c.function?.name] && !ownNames.has(c.function.name));
+                // Done: no tool calls, some are the caller's own tools, or out of rounds.
+                if (mine.length === 0 || mine.length !== calls.length || round >= rounds) {
+                    if (isObj(data))
+                        data['x_mcp_gateway'] = { toolRounds: round, toolCallsExecuted: executed };
+                    return void res.status(200).json(data);
+                }
+                messages.push(msg);
+                messages.push(...(await executeToolCalls(req, mine, schemas, deps.runToolCall)));
+                executed += mine.length;
+                logger.debug(`OpenAI bridge: executed ${mine.length} tool call(s), round ${round + 1}`);
+            }
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=openai.js.map

package/dist/bridges/openai.js.map

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

package/dist/config/loader.d.ts

@@ -8,6 +8,8 @@ import type { GatewayConfig } from '../utils/types.js';
  * given, otherwise the first match in the default search paths.
  */
 export declare function resolveConfigPath(configPath?: string): string | undefined;
+/** Validate (and apply defaults to) a raw config object; throws a readable error listing every issue. */
+export declare function validateConfig(raw: unknown): GatewayConfig;
 export declare function loadConfig(configPath?: string): Promise<GatewayConfig>;
 export declare function generateDefaultConfig(): string;
 //# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA8hBvD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAwB5E;AAyCD,wBAAgB,qBAAqB,IAAI,MAAM,CAiH9C"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA6jBvD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAQ1D;AAED,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiB5E;AAyCD,wBAAgB,qBAAqB,IAAI,MAAM,CAiH9C"}

package/dist/config/loader.js

@@ -463,6 +463,37 @@ const GatewayConfigSchema = z.object({
     })
         .strict()
         .optional(),
+    openai: z
+        .object({
+        enabled: z.boolean().optional(),
+        path: z.string().regex(/^\/[^\s]*$/, 'must start with "/"').optional(),
+        injectTools: z.boolean().optional(),
+        maxToolRounds: z.number().int().min(0).max(50).optional(),
+        upstream: z
+            .object({
+            baseUrl: z.string().url(),
+            apiKey: z.string().min(1).optional(),
+            headers: z.record(z.string()).optional(),
+            timeoutMs: z.number().int().positive().optional(),
+        })
+            .strict()
+            .optional(),
+    })
+        .strict()
+        .optional(),
+    a2a: z
+        .object({
+        enabled: z.boolean().optional(),
+        path: z.string().regex(/^\/[^\s]*$/, 'must start with "/"').optional(),
+        url: z.string().url().optional(),
+        name: z.string().min(1).optional(),
+        description: z.string().optional(),
+        provider: z.object({ organization: z.string().min(1), url: z.string().url().optional() }).strict().optional(),
+        public: z.boolean().optional(),
+        taskRetentionSeconds: z.number().int().positive().optional(),
+    })
+        .strict()
+        .optional(),
     plugins: z
         .array(z
         .object({
@@ -541,6 +572,14 @@ export function resolveConfigPath(configPath) {
     }
     return undefined;
 }
+/** Validate (and apply defaults to) a raw config object; throws a readable error listing every issue. */
+export function validateConfig(raw) {
+    const result = GatewayConfigSchema.safeParse(raw);
+    if (!result.success) {
+        throw new Error(`Invalid configuration:\n${result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\n')}`);
+    }
+    return result.data;
+}
 export async function loadConfig(configPath) {
     const filePath = resolveConfigPath(configPath);
     let raw = filePath ? await readConfigFile(filePath) : {};
@@ -553,11 +592,7 @@ export async function loadConfig(configPath) {
     }
     // Apply environment variable overrides
     raw = applyEnvOverrides(raw);
-    const result = GatewayConfigSchema.safeParse(raw);
-    if (!result.success) {
-        throw new Error(`Invalid configuration:\n${result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\n')}`);
-    }
-    const config = result.data;
+    const config = validateConfig(raw);
     if (filePath)
         config.configDir = dirname(filePath);
     return config;