@karlangas12/openapi-to-mcp 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAWnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAUvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQ/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EACL,OAAO,EACP,SAAS,EACT,OAAO,EACP,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/mcp/jsonrpc.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Tipos y utilidades del protocolo JSON-RPC 2.0, que es la base del transporte
+ * MCP. Se mantienen mínimos y sin dependencias: sólo lo que el servidor usa.
+ */
+export interface JsonRpcRequest {
+    readonly jsonrpc: '2.0';
+    readonly id: string | number;
+    readonly method: string;
+    readonly params?: unknown;
+}
+export interface JsonRpcNotification {
+    readonly jsonrpc: '2.0';
+    readonly method: string;
+    readonly params?: unknown;
+}
+export type JsonRpcIncoming = JsonRpcRequest | JsonRpcNotification;
+export interface JsonRpcSuccess {
+    readonly jsonrpc: '2.0';
+    readonly id: string | number;
+    readonly result: unknown;
+}
+export interface JsonRpcErrorResponse {
+    readonly jsonrpc: '2.0';
+    readonly id: string | number | null;
+    readonly error: {
+        readonly code: number;
+        readonly message: string;
+        readonly data?: unknown;
+    };
+}
+export type JsonRpcResponse = JsonRpcSuccess | JsonRpcErrorResponse;
+/** Códigos de error estándar de JSON-RPC 2.0. */
+export declare const JSON_RPC_ERROR: {
+    readonly parse: -32700;
+    readonly invalidRequest: -32600;
+    readonly methodNotFound: -32601;
+    readonly invalidParams: -32602;
+    readonly internal: -32603;
+};
+export declare function success(id: string | number, result: unknown): JsonRpcSuccess;
+export declare function failure(id: string | number | null, code: number, message: string, data?: unknown): JsonRpcErrorResponse;
+/** Distingue una petición (con `id`) de una notificación (sin `id`). */
+export declare function isRequest(message: JsonRpcIncoming): message is JsonRpcRequest;

package/dist/mcp/jsonrpc.js

@@ -0,0 +1,27 @@
+/**
+ * Tipos y utilidades del protocolo JSON-RPC 2.0, que es la base del transporte
+ * MCP. Se mantienen mínimos y sin dependencias: sólo lo que el servidor usa.
+ */
+/** Códigos de error estándar de JSON-RPC 2.0. */
+export const JSON_RPC_ERROR = {
+    parse: -32700,
+    invalidRequest: -32600,
+    methodNotFound: -32601,
+    invalidParams: -32602,
+    internal: -32603,
+};
+export function success(id, result) {
+    return { jsonrpc: '2.0', id, result };
+}
+export function failure(id, code, message, data) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: { code, message, ...(data === undefined ? {} : { data }) },
+    };
+}
+/** Distingue una petición (con `id`) de una notificación (sin `id`). */
+export function isRequest(message) {
+    return 'id' in message && message.id !== undefined;
+}
+//# sourceMappingURL=jsonrpc.js.map

package/dist/mcp/jsonrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../../src/mcp/jsonrpc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+BH,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,CAAC,KAAK;IACb,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,aAAa,EAAE,CAAC,KAAK;IACrB,QAAQ,EAAE,CAAC,KAAK;CACR,CAAC;AAEX,MAAM,UAAU,OAAO,CAAC,EAAmB,EAAE,MAAe;IAC1D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,EAA0B,EAC1B,IAAY,EACZ,OAAe,EACf,IAAc;IAEd,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;KAClE,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,OAAwB;IAChD,OAAO,IAAI,IAAI,OAAO,IAAK,OAA0B,CAAC,EAAE,KAAK,SAAS,CAAC;AACzE,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,32 @@
+import type { Logger } from '../core/telemetry/index.js';
+import type { FetchLike } from '../http/client.js';
+import type { FormatMode } from '../http/format.js';
+import type { ToolDefinition } from '../generator/operations.js';
+import type { JsonRpcIncoming, JsonRpcResponse } from './jsonrpc.js';
+/** Versión del protocolo MCP que anunciamos en `initialize`. */
+export declare const PROTOCOL_VERSION = "2024-11-05";
+export interface McpServerOptions {
+    readonly tools: readonly ToolDefinition[];
+    readonly baseUrl: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly fetchFn: FetchLike;
+    readonly formatMode?: FormatMode;
+    readonly serverInfo?: {
+        readonly name: string;
+        readonly version: string;
+    };
+    readonly logger?: Logger;
+}
+export interface McpServer {
+    /** Procesa un mensaje entrante y devuelve la respuesta, o `null` si era una notificación. */
+    handle(message: JsonRpcIncoming): Promise<JsonRpcResponse | null>;
+    readonly tools: readonly ToolDefinition[];
+}
+/**
+ * Crea el servidor MCP a partir de las herramientas generadas. Es agnóstico del
+ * transporte: recibe mensajes ya interpretados y devuelve respuestas, de modo
+ * que puede probarse sin tocar stdin/stdout ni la red.
+ */
+export declare function createMcpServer(options: McpServerOptions): McpServer;
+/** Logger de consola para el modo servidor (los logs van a stderr en la CLI). */
+export declare function defaultServerLogger(): Logger;

package/dist/mcp/server.js

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+import { createLogger, silentLogger } from '../core/telemetry/index.js';
+import { executeTool } from '../http/client.js';
+import { formatResult } from '../http/format.js';
+import { failure, isRequest, JSON_RPC_ERROR, success, } from './jsonrpc.js';
+/** Versión del protocolo MCP que anunciamos en `initialize`. */
+export const PROTOCOL_VERSION = '2024-11-05';
+const callParamsSchema = z.object({
+    name: z.string(),
+    arguments: z.record(z.unknown()).optional(),
+});
+/**
+ * Crea el servidor MCP a partir de las herramientas generadas. Es agnóstico del
+ * transporte: recibe mensajes ya interpretados y devuelve respuestas, de modo
+ * que puede probarse sin tocar stdin/stdout ni la red.
+ */
+export function createMcpServer(options) {
+    const logger = options.logger ?? silentLogger;
+    const byName = new Map(options.tools.map((tool) => [tool.name, tool]));
+    const serverInfo = options.serverInfo ?? { name: 'openapi-to-mcp', version: '0.1.0' };
+    async function handle(message) {
+        if (!isRequest(message)) {
+            // Notificaciones (p. ej. `notifications/initialized`): sin respuesta.
+            return null;
+        }
+        const { id, method } = message;
+        switch (method) {
+            case 'initialize':
+                return success(id, {
+                    protocolVersion: PROTOCOL_VERSION,
+                    capabilities: { tools: {} },
+                    serverInfo,
+                });
+            case 'ping':
+                return success(id, {});
+            case 'tools/list':
+                return success(id, {
+                    tools: options.tools.map((tool) => ({
+                        name: tool.name,
+                        description: tool.description,
+                        inputSchema: tool.inputSchema,
+                    })),
+                });
+            case 'tools/call':
+                return handleToolCall(id, message.params);
+            default:
+                return failure(id, JSON_RPC_ERROR.methodNotFound, `Método no soportado: ${method}`);
+        }
+    }
+    async function handleToolCall(id, params) {
+        const parsedParams = callParamsSchema.safeParse(params);
+        if (!parsedParams.success) {
+            return failure(id, JSON_RPC_ERROR.invalidParams, 'Parámetros de tools/call inválidos.');
+        }
+        const tool = byName.get(parsedParams.data.name);
+        if (tool === undefined) {
+            return failure(id, JSON_RPC_ERROR.invalidParams, `Herramienta desconocida: "${parsedParams.data.name}".`);
+        }
+        const args = parsedParams.data.arguments ?? {};
+        const validated = tool.input.safeParse(args);
+        if (!validated.success) {
+            // Se devuelve como resultado de herramienta (isError), no como error de
+            // protocolo, para que el modelo lea el motivo y reintente corrigiendo.
+            return success(id, toolError(`Argumentos inválidos: ${formatZodError(validated.error)}`));
+        }
+        try {
+            const result = await executeTool(tool, validated.data, {
+                baseUrl: options.baseUrl,
+                ...(options.headers === undefined ? {} : { headers: options.headers }),
+                fetchFn: options.fetchFn,
+            });
+            logger.info('tools/call', { tool: tool.name, status: result.status });
+            const text = formatResult(result, options.formatMode ?? 'markdown');
+            return success(id, {
+                content: [{ type: 'text', text }],
+                isError: !result.ok,
+            });
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            logger.error('fallo al ejecutar la herramienta', { tool: tool.name, error: message });
+            return success(id, toolError(`Error al llamar a la API: ${message}`));
+        }
+    }
+    return { handle, tools: options.tools };
+}
+function toolError(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function formatZodError(error) {
+    return error.issues
+        .map((issue) => `${issue.path.join('.') || '(raíz)'}: ${issue.message}`)
+        .join('; ');
+}
+/** Logger de consola para el modo servidor (los logs van a stderr en la CLI). */
+export function defaultServerLogger() {
+    return createLogger({ service: 'openapi-to-mcp', level: 'info' });
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/stdio.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from './server.js';
+export interface StdioOptions {
+    readonly input?: NodeJS.ReadableStream;
+    readonly output?: NodeJS.WritableStream;
+}
+/**
+ * Conecta un servidor MCP al transporte stdio: mensajes JSON-RPC delimitados por
+ * saltos de línea, uno por línea, tal como define el transporte stdio de MCP.
+ */
+export declare function startStdioServer(server: McpServer, options?: StdioOptions): void;

package/dist/mcp/stdio.js

@@ -0,0 +1,49 @@
+import { failure, JSON_RPC_ERROR } from './jsonrpc.js';
+/**
+ * Conecta un servidor MCP al transporte stdio: mensajes JSON-RPC delimitados por
+ * saltos de línea, uno por línea, tal como define el transporte stdio de MCP.
+ */
+export function startStdioServer(server, options = {}) {
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stdout;
+    let buffer = '';
+    input.setEncoding('utf8');
+    input.on('data', (chunk) => {
+        buffer += chunk;
+        let newlineIndex = buffer.indexOf('\n');
+        while (newlineIndex !== -1) {
+            const line = buffer.slice(0, newlineIndex).trim();
+            buffer = buffer.slice(newlineIndex + 1);
+            if (line !== '')
+                void processLine(line);
+            newlineIndex = buffer.indexOf('\n');
+        }
+    });
+    async function processLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            write(failure(null, JSON_RPC_ERROR.parse, 'Mensaje JSON-RPC no interpretable.'));
+            return;
+        }
+        try {
+            const response = await server.handle(message);
+            if (response !== null)
+                write(response);
+        }
+        catch (cause) {
+            const id = readId(message);
+            write(failure(id, JSON_RPC_ERROR.internal, cause instanceof Error ? cause.message : 'Error interno.'));
+        }
+    }
+    function write(value) {
+        output.write(`${JSON.stringify(value)}\n`);
+    }
+}
+function readId(message) {
+    const id = message.id;
+    return typeof id === 'string' || typeof id === 'number' ? id : null;
+}
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AASvD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,UAAwB,EAAE;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACjC,MAAM,IAAI,KAAK,CAAC;QAChB,IAAI,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;YACxC,IAAI,IAAI,KAAK,EAAE;gBAAE,KAAK,WAAW,CAAC,IAAI,CAAC,CAAC;YACxC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,UAAU,WAAW,CAAC,IAAY;QACrC,IAAI,OAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,oCAAoC,CAAC,CAAC,CAAC;YACjF,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,QAAQ,KAAK,IAAI;gBAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3B,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,cAAc,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;IAED,SAAS,KAAK,CAAC,KAAc;QAC3B,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,OAAwB;IACtC,MAAM,EAAE,GAAI,OAA4B,CAAC,EAAE,CAAC;IAC5C,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/dist/openapi/load.d.ts

@@ -0,0 +1,15 @@
+import type { FetchLike } from '../http/client.js';
+import type { OpenApiDocument } from './types.js';
+export interface LoadOptions {
+    /** Cliente HTTP para especificaciones remotas. Inyectable para los tests. */
+    readonly fetchFn?: FetchLike;
+    /** Lector de ficheros. Inyectable para los tests. */
+    readonly readFileFn?: (path: string) => Promise<string>;
+}
+/**
+ * Carga una especificación OpenAPI desde una ruta local o una URL, en JSON o
+ * YAML, y la devuelve como documento tras validar que es OpenAPI 3.x.
+ */
+export declare function loadSpec(source: string, options?: LoadOptions): Promise<OpenApiDocument>;
+/** Interpreta el contenido de una especificación (JSON o YAML) y lo valida. */
+export declare function parseSpecContent(text: string, source?: string): OpenApiDocument;

package/dist/openapi/load.js

@@ -0,0 +1,60 @@
+import { readFile } from 'node:fs/promises';
+import { parse as parseYaml } from 'yaml';
+import { badRequest } from '../utils/errors.js';
+/**
+ * Carga una especificación OpenAPI desde una ruta local o una URL, en JSON o
+ * YAML, y la devuelve como documento tras validar que es OpenAPI 3.x.
+ */
+export async function loadSpec(source, options = {}) {
+    const text = await readSource(source, options);
+    return parseSpecContent(text, source);
+}
+/** Interpreta el contenido de una especificación (JSON o YAML) y lo valida. */
+export function parseSpecContent(text, source = '<inline>') {
+    const trimmed = text.trimStart();
+    const looksLikeJson = trimmed.startsWith('{') || trimmed.startsWith('[');
+    let parsed;
+    try {
+        parsed = looksLikeJson ? JSON.parse(text) : parseYaml(text);
+    }
+    catch (cause) {
+        throw badRequest(`No se ha podido interpretar la especificación de "${source}": no es JSON ni YAML válido.`, cause instanceof Error ? cause.message : undefined);
+    }
+    return assertOpenApiDocument(parsed, source);
+}
+/** Valida la forma mínima de un documento OpenAPI 3.x. */
+function assertOpenApiDocument(value, source) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw badRequest(`La especificación de "${source}" no es un objeto OpenAPI.`);
+    }
+    const doc = value;
+    const version = doc['openapi'];
+    if (typeof version !== 'string' || !version.startsWith('3.')) {
+        throw badRequest(`Sólo se admite OpenAPI 3.x. La especificación de "${source}" declara openapi="${String(version)}".`);
+    }
+    if (doc['paths'] !== undefined && (typeof doc['paths'] !== 'object' || doc['paths'] === null)) {
+        throw badRequest(`El campo "paths" de "${source}" no es un objeto.`);
+    }
+    return value;
+}
+/** Obtiene el texto de la especificación desde el origen indicado. */
+async function readSource(source, options) {
+    if (/^https?:\/\//i.test(source)) {
+        const fetchFn = options.fetchFn ?? defaultFetch;
+        const response = await fetchFn(source, { method: 'GET' });
+        if (!response.ok) {
+            throw badRequest(`No se ha podido descargar la especificación de "${source}": HTTP ${response.status}.`);
+        }
+        return response.text();
+    }
+    const readFileFn = options.readFileFn ?? ((path) => readFile(path, 'utf8'));
+    try {
+        return await readFileFn(source);
+    }
+    catch (cause) {
+        throw badRequest(`No se ha podido leer la especificación en "${source}".`, cause instanceof Error ? cause.message : undefined);
+    }
+}
+/** Envoltorio del `fetch` global con la forma desacoplada `FetchLike`. */
+const defaultFetch = (url, init) => fetch(url, init);
+//# sourceMappingURL=load.js.map

package/dist/openapi/load.js.map

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

package/dist/openapi/resolve.d.ts

@@ -0,0 +1,20 @@
+import type { OpenApiDocument, SchemaObject } from './types.js';
+/**
+ * Resuelve referencias locales `$ref` (`#/components/schemas/...`) contra el
+ * documento raíz.
+ *
+ * Sólo se soportan referencias internas: las externas (a otros ficheros o URLs)
+ * quedan fuera del alcance de esta versión y provocan un error explícito, en vez
+ * de un fallo silencioso más difícil de diagnosticar.
+ */
+export declare class RefResolver {
+    private readonly root;
+    constructor(root: OpenApiDocument);
+    /** Devuelve el nodo apuntado por un `$ref`, o lanza si no resuelve. */
+    resolve(ref: string): SchemaObject;
+    /**
+     * Sigue la cadena de `$ref` hasta llegar a un schema concreto. Un ciclo de
+     * referencias (poco habitual, pero posible) se corta lanzando un error.
+     */
+    deref(schema: SchemaObject): SchemaObject;
+}

package/dist/openapi/resolve.js

@@ -0,0 +1,57 @@
+import { badRequest } from '../utils/errors.js';
+/**
+ * Resuelve referencias locales `$ref` (`#/components/schemas/...`) contra el
+ * documento raíz.
+ *
+ * Sólo se soportan referencias internas: las externas (a otros ficheros o URLs)
+ * quedan fuera del alcance de esta versión y provocan un error explícito, en vez
+ * de un fallo silencioso más difícil de diagnosticar.
+ */
+export class RefResolver {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    /** Devuelve el nodo apuntado por un `$ref`, o lanza si no resuelve. */
+    resolve(ref) {
+        if (!ref.startsWith('#/')) {
+            throw badRequest(`Referencia $ref no soportada: "${ref}". Sólo se admiten referencias locales que empiezan por "#/".`);
+        }
+        const segments = ref
+            .slice(2)
+            .split('/')
+            .map(decodePointerSegment);
+        let node = this.root;
+        for (const segment of segments) {
+            if (node === null || typeof node !== 'object') {
+                throw badRequest(`La referencia $ref "${ref}" no resuelve a ningún nodo.`);
+            }
+            node = node[segment];
+        }
+        if (node === null || typeof node !== 'object') {
+            throw badRequest(`La referencia $ref "${ref}" no apunta a un objeto Schema.`);
+        }
+        return node;
+    }
+    /**
+     * Sigue la cadena de `$ref` hasta llegar a un schema concreto. Un ciclo de
+     * referencias (poco habitual, pero posible) se corta lanzando un error.
+     */
+    deref(schema) {
+        const visited = new Set();
+        let current = schema;
+        while (current.$ref !== undefined) {
+            if (visited.has(current.$ref)) {
+                throw badRequest(`Ciclo de referencias $ref detectado en "${current.$ref}".`);
+            }
+            visited.add(current.$ref);
+            current = this.resolve(current.$ref);
+        }
+        return current;
+    }
+}
+/** Decodifica el escape de JSON Pointer: `~1` → `/`, `~0` → `~`. */
+function decodePointerSegment(segment) {
+    return segment.replace(/~1/g, '/').replace(/~0/g, '~');
+}
+//# sourceMappingURL=resolve.js.map

package/dist/openapi/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/openapi/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,IAAqB;QAArB,SAAI,GAAJ,IAAI,CAAiB;IAAG,CAAC;IAEtD,uEAAuE;IACvE,OAAO,CAAC,GAAW;QACjB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,UAAU,CACd,kCAAkC,GAAG,+DAA+D,CACrG,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG;aACjB,KAAK,CAAC,CAAC,CAAC;aACR,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAE7B,IAAI,IAAI,GAAY,IAAI,CAAC,IAAI,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9C,MAAM,UAAU,CAAC,uBAAuB,GAAG,8BAA8B,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,GAAI,IAAgC,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,UAAU,CAAC,uBAAuB,GAAG,iCAAiC,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,IAAoB,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAoB;QACxB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,IAAI,OAAO,GAAG,MAAM,CAAC;QACrB,OAAO,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,UAAU,CAAC,2CAA2C,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;YAChF,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,oEAAoE;AACpE,SAAS,oBAAoB,CAAC,OAAe;IAC3C,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC"}

package/dist/openapi/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Modelo interno mínimo de OpenAPI 3.0 / 3.1.
+ *
+ * No pretende cubrir la especificación entera: sólo las piezas que el generador
+ * consume para producir herramientas MCP. Todos los campos son opcionales porque
+ * las especificaciones del mundo real son irregulares; la validación estricta se
+ * hace en la frontera de entrada (`load.ts`) y al construir cada herramienta.
+ */
+/** Objeto Schema de OpenAPI (superconjunto práctico de JSON Schema). */
+export interface SchemaObject {
+    $ref?: string;
+    type?: string | readonly string[];
+    format?: string;
+    enum?: readonly unknown[];
+    const?: unknown;
+    /** OpenAPI 3.0: marca el valor como anulable. En 3.1 se usa `type: [..,'null']`. */
+    nullable?: boolean;
+    items?: SchemaObject;
+    properties?: Readonly<Record<string, SchemaObject>>;
+    required?: readonly string[];
+    additionalProperties?: boolean | SchemaObject;
+    allOf?: readonly SchemaObject[];
+    oneOf?: readonly SchemaObject[];
+    anyOf?: readonly SchemaObject[];
+    description?: string;
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    pattern?: string;
+    example?: unknown;
+}
+/** Objeto Parameter de OpenAPI. */
+export interface ParameterObject {
+    $ref?: string;
+    name?: string;
+    in?: 'path' | 'query' | 'header' | 'cookie';
+    required?: boolean;
+    description?: string;
+    schema?: SchemaObject;
+}
+/** Cuerpo de la petición. */
+export interface RequestBodyObject {
+    required?: boolean;
+    description?: string;
+    content?: Readonly<Record<string, {
+        schema?: SchemaObject;
+    }>>;
+}
+/** Una operación (método) sobre una ruta. */
+export interface OperationObject {
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags?: readonly string[];
+    parameters?: readonly ParameterObject[];
+    requestBody?: RequestBodyObject;
+    deprecated?: boolean;
+}
+/** Un elemento de `paths`: agrupa las operaciones por método. */
+export interface PathItemObject {
+    parameters?: readonly ParameterObject[];
+    get?: OperationObject;
+    put?: OperationObject;
+    post?: OperationObject;
+    delete?: OperationObject;
+    patch?: OperationObject;
+    head?: OperationObject;
+    options?: OperationObject;
+    trace?: OperationObject;
+}
+/** Servidor declarado en la especificación. */
+export interface ServerObject {
+    url?: string;
+    description?: string;
+}
+/** Documento OpenAPI completo (lo que consumimos de él). */
+export interface OpenApiDocument {
+    openapi?: string;
+    info?: {
+        title?: string;
+        version?: string;
+        description?: string;
+    };
+    servers?: readonly ServerObject[];
+    paths?: Readonly<Record<string, PathItemObject>>;
+    components?: Readonly<Record<string, unknown>>;
+}
+/** Los verbos HTTP que se convierten en herramientas. */
+export declare const HTTP_METHODS: readonly ["get", "put", "post", "delete", "patch", "head", "options", "trace"];
+export type HttpMethod = (typeof HTTP_METHODS)[number];

package/dist/openapi/types.js

@@ -0,0 +1,20 @@
+/**
+ * Modelo interno mínimo de OpenAPI 3.0 / 3.1.
+ *
+ * No pretende cubrir la especificación entera: sólo las piezas que el generador
+ * consume para producir herramientas MCP. Todos los campos son opcionales porque
+ * las especificaciones del mundo real son irregulares; la validación estricta se
+ * hace en la frontera de entrada (`load.ts`) y al construir cada herramienta.
+ */
+/** Los verbos HTTP que se convierten en herramientas. */
+export const HTTP_METHODS = [
+    'get',
+    'put',
+    'post',
+    'delete',
+    'patch',
+    'head',
+    'options',
+    'trace',
+];
+//# sourceMappingURL=types.js.map

package/dist/openapi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/openapi/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsFH,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK;IACL,KAAK;IACL,MAAM;IACN,QAAQ;IACR,OAAO;IACP,MAAM;IACN,SAAS;IACT,OAAO;CACC,CAAC"}

package/dist/schema/to-json.d.ts

@@ -0,0 +1,14 @@
+import type { RefResolver } from '../openapi/resolve.js';
+import type { SchemaObject } from '../openapi/types.js';
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Devuelve una copia del schema con todas las referencias `$ref` locales ya
+ * resueltas, apta para exponer como `inputSchema` de una herramienta MCP (JSON
+ * Schema plano, sin `$ref` que el cliente tendría que resolver por su cuenta).
+ *
+ * Los ciclos de referencias se cortan sustituyendo la rama por `{}` (equivalente
+ * a "cualquier valor"), en vez de expandir infinitamente.
+ */
+export declare function toJsonSchema(schema: SchemaObject, resolver: RefResolver): JsonValue;

package/dist/schema/to-json.js

@@ -0,0 +1,41 @@
+const MAX_DEPTH = 40;
+/**
+ * Devuelve una copia del schema con todas las referencias `$ref` locales ya
+ * resueltas, apta para exponer como `inputSchema` de una herramienta MCP (JSON
+ * Schema plano, sin `$ref` que el cliente tendría que resolver por su cuenta).
+ *
+ * Los ciclos de referencias se cortan sustituyendo la rama por `{}` (equivalente
+ * a "cualquier valor"), en vez de expandir infinitamente.
+ */
+export function toJsonSchema(schema, resolver) {
+    return deref(schema, resolver, new Set(), 0);
+}
+function deref(node, resolver, path, depth) {
+    if (depth > MAX_DEPTH)
+        return {};
+    if (Array.isArray(node)) {
+        return node.map((item) => deref(item, resolver, path, depth + 1));
+    }
+    if (node !== null && typeof node === 'object') {
+        const obj = node;
+        const ref = obj['$ref'];
+        if (typeof ref === 'string') {
+            if (path.has(ref))
+                return {};
+            const nextPath = new Set(path);
+            nextPath.add(ref);
+            return deref(resolver.resolve(ref), resolver, nextPath, depth + 1);
+        }
+        const out = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (value === undefined)
+                continue;
+            out[key] = deref(value, resolver, path, depth + 1);
+        }
+        return out;
+    }
+    if (node === undefined)
+        return null;
+    return node;
+}
+//# sourceMappingURL=to-json.js.map

package/dist/schema/to-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-json.js","sourceRoot":"","sources":["../../src/schema/to-json.ts"],"names":[],"mappings":"AAWA,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB,EAAE,QAAqB;IACtE,OAAO,KAAK,CAAC,MAAiB,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,KAAK,CAAC,IAAa,EAAE,QAAqB,EAAE,IAAyB,EAAE,KAAa;IAC3F,IAAI,KAAK,GAAG,SAAS;QAAE,OAAO,EAAE,CAAC;IAEjC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,IAA+B,CAAC;QAE5C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,GAAG,GAA8B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,IAAiB,CAAC;AAC3B,CAAC"}

package/dist/schema/to-zod.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import type { RefResolver } from '../openapi/resolve.js';
+import type { SchemaObject } from '../openapi/types.js';
+/**
+ * Convierte un Objeto Schema de OpenAPI en un validador Zod para comprobar los
+ * argumentos entrantes de una herramienta antes de tocar la API subyacente.
+ */
+export declare function schemaToZod(schema: SchemaObject, resolver: RefResolver, depth?: number): z.ZodTypeAny;