@karlangas12/openapi-to-mcp 0.1.0

package/dist/core/telemetry/index.js

@@ -0,0 +1,152 @@
+/**
+ * Telemetría unificada: logging estructurado y métricas.
+ *
+ * Diseño pensado para el edge:
+ * - Sin dependencias externas: el transporte por defecto es la consola.
+ * - Estructurado en JSON, para que Better Stack / Axiom lo indexen tal cual.
+ * - Redacción automática de secretos: nunca queremos una API key en los logs.
+ *
+ * Uso típico en un Worker:
+ *
+ *   const log = createLogger({ level: config.LOG_LEVEL, service: 'mi-activo' });
+ *   log.info('petición recibida', { path: '/v1/generar' });
+ */
+/** Prioridad numérica de cada nivel, para filtrar por umbral. */
+const LEVEL_PRIORITY = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+/**
+ * Claves cuyo valor se sustituye por `[REDACTADO]`.
+ *
+ * La comparación es por subcadena y sin distinguir mayúsculas, de modo que
+ * `x-api-key`, `API_KEY` o `stripeSecret` quedan cubiertos por igual.
+ */
+const REDACTED_KEY_PATTERNS = [
+    'key',
+    'token',
+    'secret',
+    'password',
+    'authorization',
+    'cookie',
+    'signature',
+];
+const REDACTED_PLACEHOLDER = '[REDACTADO]';
+/** Indica si el nombre de un campo debe redactarse. */
+function shouldRedact(key) {
+    const normalized = key.toLowerCase();
+    return REDACTED_KEY_PATTERNS.some((pattern) => normalized.includes(pattern));
+}
+/**
+ * Recorre un valor y redacta los campos sensibles.
+ *
+ * Limita la profundidad para no atascarse con estructuras enormes o cíclicas
+ * (un log nunca debe ser el cuello de botella de una petición).
+ */
+export function redact(value, depth = 0) {
+    if (depth > 6)
+        return '[PROFUNDIDAD_MÁXIMA]';
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (value instanceof Error) {
+        return { name: value.name, message: value.message, stack: value.stack };
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => redact(item, depth + 1));
+    }
+    const result = {};
+    for (const [key, item] of Object.entries(value)) {
+        result[key] = shouldRedact(key) ? REDACTED_PLACEHOLDER : redact(item, depth + 1);
+    }
+    return result;
+}
+/** Transporte por defecto: una línea JSON por registro en la consola. */
+export const consoleTransport = {
+    emit(record) {
+        const line = JSON.stringify(record);
+        if (record.level === 'error')
+            console.error(line);
+        else if (record.level === 'warn')
+            console.warn(line);
+        else
+            console.log(line);
+    },
+};
+/**
+ * Transporte HTTP genérico para Better Stack, Axiom o cualquier colector que
+ * acepte JSON por POST.
+ *
+ * Los envíos son "fire and forget": si el colector falla no queremos tumbar la
+ * petición del usuario. Pasa el `Promise` a `ctx.waitUntil()` en un Worker si
+ * necesitas garantizar la entrega antes de que muera el aislado.
+ */
+export function createHttpTransport(options) {
+    return {
+        emit(record) {
+            const promise = fetch(options.url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', ...options.headers },
+                body: JSON.stringify(record),
+            }).catch((error) => {
+                // Fallo del colector: lo dejamos en consola y seguimos.
+                console.error(JSON.stringify({
+                    level: 'error',
+                    message: 'No se pudo enviar la telemetría al colector remoto.',
+                    error: String(error),
+                }));
+            });
+            options.onFlush?.(promise);
+        },
+    };
+}
+/** Emite cada registro a varios destinos a la vez. */
+export function combineTransports(...transports) {
+    return {
+        emit(record) {
+            for (const transport of transports)
+                transport.emit(record);
+        },
+    };
+}
+/** Crea un logger estructurado. */
+export function createLogger(options = {}) {
+    const level = options.level ?? 'info';
+    const service = options.service ?? 'motor3';
+    const transport = options.transport ?? consoleTransport;
+    const baseContext = options.context ?? {};
+    const now = options.now ?? (() => Date.now());
+    const threshold = LEVEL_PRIORITY[level];
+    const write = (recordLevel, message, context) => {
+        if (LEVEL_PRIORITY[recordLevel] < threshold)
+            return;
+        const merged = { ...baseContext, ...context };
+        transport.emit({
+            timestamp: new Date(now()).toISOString(),
+            level: recordLevel,
+            message,
+            service,
+            context: redact(merged),
+        });
+    };
+    return {
+        debug: (message, context) => write('debug', message, context),
+        info: (message, context) => write('info', message, context),
+        warn: (message, context) => write('warn', message, context),
+        error: (message, context) => write('error', message, context),
+        metric: (name, value, context) => write('info', `métrica: ${name}`, { ...context, metric: name, value }),
+        child: (context) => createLogger({
+            level,
+            service,
+            transport,
+            context: { ...baseContext, ...context },
+            now,
+        }),
+    };
+}
+/** Logger silencioso, útil en tests que no deben ensuciar la salida. */
+export const silentLogger = createLogger({
+    transport: { emit: () => undefined },
+});
+//# sourceMappingURL=index.js.map

package/dist/core/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,iEAAiE;AACjE,MAAM,cAAc,GAA6B;IAC/C,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAmBF;;;;;GAKG;AACH,MAAM,qBAAqB,GAAG;IAC5B,KAAK;IACL,OAAO;IACP,QAAQ;IACR,UAAU;IACV,eAAe;IACf,QAAQ;IACR,WAAW;CACZ,CAAC;AAEF,MAAM,oBAAoB,GAAG,aAAa,CAAC;AAE3C,uDAAuD;AACvD,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IAC9C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,sBAAsB,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC3E,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,IAAI,CAAC,MAAiB;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aAC7C,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAChD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAInC;IACC,OAAO;QACL,IAAI,CAAC,MAAiB;YACpB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;gBACjC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE;gBACnE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;aAC7B,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC1B,wDAAwD;gBACxD,OAAO,CAAC,KAAK,CACX,IAAI,CAAC,SAAS,CAAC;oBACb,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,qDAAqD;oBAC9D,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;iBACrB,CAAC,CACH,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,iBAAiB,CAAC,GAAG,UAAgC;IACnE,OAAO;QACL,IAAI,CAAC,MAAiB;YACpB,KAAK,MAAM,SAAS,IAAI,UAAU;gBAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AA0BD,mCAAmC;AACnC,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC;IACxD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,CAAC,WAAqB,EAAE,OAAe,EAAE,OAAoB,EAAQ,EAAE;QACnF,IAAI,cAAc,CAAC,WAAW,CAAC,GAAG,SAAS;YAAE,OAAO;QAEpD,MAAM,MAAM,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC;QAC9C,SAAS,CAAC,IAAI,CAAC;YACb,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;YACxC,KAAK,EAAE,WAAW;YAClB,OAAO;YACP,OAAO;YACP,OAAO,EAAE,MAAM,CAAC,MAAM,CAA4B;SACnD,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;QAC7D,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QAC3D,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QAC3D,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;QAC7D,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAC/B,KAAK,CAAC,MAAM,EAAE,YAAY,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACxE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,YAAY,CAAC;YACX,KAAK;YACL,OAAO;YACP,SAAS;YACT,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,EAAE;YACvC,GAAG;SACJ,CAAC;KACL,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAW,YAAY,CAAC;IAC/C,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE;CACrC,CAAC,CAAC"}

package/dist/generator/codegen.d.ts

@@ -0,0 +1,15 @@
+import type { OpenApiDocument } from '../openapi/types.js';
+export interface CodegenOptions {
+    /** Nombre del paquete del que importar el runtime. */
+    readonly packageName?: string;
+    /** URL base a incrustar (si la especificación no declara servers). */
+    readonly baseUrl?: string;
+    /** Nombre del servidor anunciado en `initialize`. */
+    readonly serverName?: string;
+}
+/**
+ * Genera el código de un servidor MCP autocontenido en TypeScript que sirve una
+ * especificación concreta. El resultado incrusta la especificación y arranca el
+ * runtime de este paquete: un único fichero listo para ejecutar con `tsx`/`node`.
+ */
+export declare function generateServerCode(doc: OpenApiDocument, options?: CodegenOptions): string;

package/dist/generator/codegen.js

@@ -0,0 +1,33 @@
+/**
+ * Genera el código de un servidor MCP autocontenido en TypeScript que sirve una
+ * especificación concreta. El resultado incrusta la especificación y arranca el
+ * runtime de este paquete: un único fichero listo para ejecutar con `tsx`/`node`.
+ */
+export function generateServerCode(doc, options = {}) {
+    const packageName = options.packageName ?? '@karlangas12/openapi-to-mcp';
+    const serverName = options.serverName ?? doc.info?.title ?? 'openapi-mcp-server';
+    const baseUrlLiteral = JSON.stringify(options.baseUrl ?? doc.servers?.[0]?.url ?? '');
+    const specLiteral = JSON.stringify(doc, null, 2);
+    return `#!/usr/bin/env node
+// Servidor MCP generado por openapi-to-mcp. No editar a mano: regenéralo.
+import { buildTools, createMcpServer, startStdioServer } from '${packageName}';
+
+const spec = ${specLiteral} as const;
+
+const { tools, baseUrl } = buildTools(spec);
+const resolvedBaseUrl = baseUrl ?? ${baseUrlLiteral};
+if (resolvedBaseUrl === '') {
+  throw new Error('No hay URL base: define servers[] en la especificación o pásala al generar.');
+}
+
+const server = createMcpServer({
+  tools,
+  baseUrl: resolvedBaseUrl,
+  serverInfo: { name: ${JSON.stringify(serverName)}, version: '0.1.0' },
+  fetchFn: (url, init) => fetch(url, init as RequestInit | undefined) as never,
+});
+
+startStdioServer(server);
+`;
+}
+//# sourceMappingURL=codegen.js.map

package/dist/generator/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../../src/generator/codegen.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAoB,EAAE,UAA0B,EAAE;IACnF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,6BAA6B,CAAC;IACzE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,oBAAoB,CAAC;IACjF,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACtF,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEjD,OAAO;;iEAEwD,WAAW;;eAE7D,WAAW;;;qCAGW,cAAc;;;;;;;;wBAQ3B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;;;;;CAKjD,CAAC;AACF,CAAC"}

package/dist/generator/operations.d.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import type { HttpMethod, OpenApiDocument } from '../openapi/types.js';
+import type { JsonValue } from '../schema/to-json.js';
+export interface ParamBinding {
+    readonly name: string;
+    readonly in: 'path' | 'query' | 'header' | 'cookie';
+    readonly required: boolean;
+}
+export interface ToolBinding {
+    readonly method: HttpMethod;
+    readonly pathTemplate: string;
+    readonly params: readonly ParamBinding[];
+    readonly requestBody?: {
+        readonly required: boolean;
+        readonly contentType: string;
+    };
+}
+export interface JsonSchemaObject {
+    readonly type: 'object';
+    readonly properties: Readonly<Record<string, JsonValue>>;
+    readonly required: readonly string[];
+    readonly additionalProperties: boolean;
+}
+export interface ToolDefinition {
+    /** Nombre de la herramienta MCP, único y válido (`[a-z0-9_]`). */
+    readonly name: string;
+    readonly description: string;
+    /** JSON Schema que se expone en `tools/list`. */
+    readonly inputSchema: JsonSchemaObject;
+    /** Validador Zod de los argumentos entrantes. */
+    readonly input: z.ZodTypeAny;
+    readonly binding: ToolBinding;
+}
+export interface BuildToolsResult {
+    readonly tools: readonly ToolDefinition[];
+    /** URL base resuelta (opción explícita o primer `servers[].url`). */
+    readonly baseUrl: string | undefined;
+}
+export interface BuildToolsOptions {
+    /** Fuerza la URL base, ignorando la declarada en la especificación. */
+    readonly baseUrl?: string;
+}
+/**
+ * Construye la lista de herramientas MCP a partir de un documento OpenAPI: cada
+ * par método + ruta se convierte en una herramienta con su schema y su binding.
+ */
+export declare function buildTools(doc: OpenApiDocument, options?: BuildToolsOptions): BuildToolsResult;

package/dist/generator/operations.js

@@ -0,0 +1,143 @@
+import { z } from 'zod';
+import { RefResolver } from '../openapi/resolve.js';
+import { HTTP_METHODS } from '../openapi/types.js';
+import { schemaToZod } from '../schema/to-zod.js';
+import { toJsonSchema } from '../schema/to-json.js';
+/** Tipo de contenido preferido para los cuerpos de petición. */
+const PREFERRED_CONTENT = 'application/json';
+/**
+ * Construye la lista de herramientas MCP a partir de un documento OpenAPI: cada
+ * par método + ruta se convierte en una herramienta con su schema y su binding.
+ */
+export function buildTools(doc, options = {}) {
+    const resolver = new RefResolver(doc);
+    const baseUrl = options.baseUrl ?? firstServerUrl(doc);
+    const tools = [];
+    const usedNames = new Set();
+    for (const [path, pathItem] of Object.entries(doc.paths ?? {})) {
+        const pathParams = pathItem.parameters ?? [];
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (operation === undefined)
+                continue;
+            const params = mergeParameters(pathParams, operation.parameters ?? [], resolver);
+            const name = uniqueName(toolName(operation.operationId, method, path), usedNames);
+            const properties = {};
+            const shape = {};
+            const required = [];
+            const paramBindings = [];
+            for (const param of params) {
+                if (param.name === undefined || param.in === undefined)
+                    continue;
+                const isRequired = param.required === true || param.in === 'path';
+                const schema = param.schema ?? { type: 'string' };
+                if (param.in !== 'cookie') {
+                    properties[param.name] = toJsonSchema(schema, resolver);
+                    const zod = schemaToZod(schema, resolver);
+                    shape[param.name] = isRequired ? zod : zod.optional();
+                    if (isRequired)
+                        required.push(param.name);
+                }
+                paramBindings.push({ name: param.name, in: param.in, required: isRequired });
+            }
+            let requestBody;
+            const bodySchema = jsonBodySchema(operation.requestBody?.content);
+            if (bodySchema !== undefined) {
+                const bodyRequired = operation.requestBody?.required === true;
+                properties['body'] = toJsonSchema(bodySchema, resolver);
+                const zod = schemaToZod(bodySchema, resolver);
+                shape['body'] = bodyRequired ? zod : zod.optional();
+                if (bodyRequired)
+                    required.push('body');
+                requestBody = { required: bodyRequired, contentType: PREFERRED_CONTENT };
+            }
+            const inputSchema = {
+                type: 'object',
+                properties,
+                required,
+                additionalProperties: false,
+            };
+            tools.push({
+                name,
+                description: describe(operation.summary, operation.description, method, path),
+                inputSchema,
+                input: z.object(shape).passthrough(),
+                binding: {
+                    method,
+                    pathTemplate: path,
+                    params: paramBindings,
+                    ...(requestBody === undefined ? {} : { requestBody }),
+                },
+            });
+        }
+    }
+    return { tools, baseUrl };
+}
+function firstServerUrl(doc) {
+    const url = doc.servers?.[0]?.url;
+    return typeof url === 'string' && url.length > 0 ? url : undefined;
+}
+/** Fusiona parámetros de nivel de ruta y de operación; la operación gana. */
+function mergeParameters(pathParams, operationParams, resolver) {
+    const byKey = new Map();
+    for (const raw of [...pathParams, ...operationParams]) {
+        const param = raw.$ref !== undefined ? resolver.resolve(raw.$ref) : raw;
+        if (param.name === undefined || param.in === undefined)
+            continue;
+        byKey.set(`${param.in}:${param.name}`, param);
+    }
+    return [...byKey.values()];
+}
+/** Extrae el schema del cuerpo JSON, si la operación declara uno. */
+function jsonBodySchema(content) {
+    if (content === undefined)
+        return undefined;
+    const direct = content[PREFERRED_CONTENT]?.schema;
+    if (direct !== undefined)
+        return direct;
+    // Cualquier tipo `*/*+json` o similar también vale.
+    for (const [type, media] of Object.entries(content)) {
+        if (/json/i.test(type) && media.schema !== undefined)
+            return media.schema;
+    }
+    return undefined;
+}
+/** Deriva el nombre de la herramienta: `operationId` o `metodo_ruta`. */
+function toolName(operationId, method, path) {
+    if (operationId !== undefined && operationId.trim() !== '') {
+        return sanitizeName(operationId);
+    }
+    const segments = path
+        .split('/')
+        .filter((segment) => segment.length > 0)
+        .map((segment) => segment.replace(/^\{(.+)\}$/, 'by_$1'));
+    return sanitizeName([method, ...segments].join('_'));
+}
+/** Normaliza a `snake_case` válido para un nombre de herramienta MCP. */
+function sanitizeName(raw) {
+    const snake = raw
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return snake.length > 0 ? snake : 'tool';
+}
+/** Garantiza que el nombre no colisione con otro ya generado. */
+function uniqueName(base, used) {
+    if (!used.has(base)) {
+        used.add(base);
+        return base;
+    }
+    let index = 2;
+    while (used.has(`${base}_${index}`))
+        index += 1;
+    const name = `${base}_${index}`;
+    used.add(name);
+    return name;
+}
+function describe(summary, description, method, path) {
+    const text = summary ?? description;
+    const suffix = `(${method.toUpperCase()} ${path})`;
+    return text !== undefined && text.trim() !== '' ? `${text} ${suffix}` : `${method.toUpperCase()} ${path}`;
+}
+//# sourceMappingURL=operations.js.map

package/dist/generator/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/generator/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOnD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA6CpD,gEAAgE;AAChE,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAoB,EAAE,UAA6B,EAAE;IAC9E,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/D,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;QAE7C,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,SAAS,KAAK,SAAS;gBAAE,SAAS;YAEtC,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;YAElF,MAAM,UAAU,GAA8B,EAAE,CAAC;YACjD,MAAM,KAAK,GAAiC,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,MAAM,aAAa,GAAmB,EAAE,CAAC;YAEzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS;oBAAE,SAAS;gBACjE,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC;gBAClE,MAAM,MAAM,GAAiB,KAAK,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAEhE,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;oBAC1B,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;oBACxD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;oBAC1C,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACtD,IAAI,UAAU;wBAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5C,CAAC;gBACD,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAC/E,CAAC;YAED,IAAI,WAAuC,CAAC;YAC5C,MAAM,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAClE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,EAAE,QAAQ,KAAK,IAAI,CAAC;gBAC9D,UAAU,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;gBACxD,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;gBAC9C,KAAK,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACpD,IAAI,YAAY;oBAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxC,WAAW,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;YAC3E,CAAC;YAED,MAAM,WAAW,GAAqB;gBACpC,IAAI,EAAE,QAAQ;gBACd,UAAU;gBACV,QAAQ;gBACR,oBAAoB,EAAE,KAAK;aAC5B,CAAC;YAEF,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI;gBACJ,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC;gBAC7E,WAAW;gBACX,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;gBACpC,OAAO,EAAE;oBACP,MAAM;oBACN,YAAY,EAAE,IAAI;oBAClB,MAAM,EAAE,aAAa;oBACrB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;iBACtD;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,cAAc,CAAC,GAAoB;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IAClC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,6EAA6E;AAC7E,SAAS,eAAe,CACtB,UAAsC,EACtC,eAA2C,EAC3C,QAAqB;IAErB,MAAM,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IACjD,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,UAAU,EAAE,GAAG,eAAe,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAgC,CAAC,CAAC,CAAC,GAAG,CAAC;QACxG,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS;YAAE,SAAS;QACjE,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,qEAAqE;AACrE,SAAS,cAAc,CACrB,OAAwE;IAExE,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAClD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,oDAAoD;IACpD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC5E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yEAAyE;AACzE,SAAS,QAAQ,CAAC,WAA+B,EAAE,MAAkB,EAAE,IAAY;IACjF,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3D,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI;SAClB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,OAAO,YAAY,CAAC,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,yEAAyE;AACzE,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,KAAK,GAAG,GAAG;SACd,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC;AAED,iEAAiE;AACjE,SAAS,UAAU,CAAC,IAAY,EAAE,IAAiB;IACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;IAChC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACf,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CACf,OAA2B,EAC3B,WAA+B,EAC/B,MAAkB,EAClB,IAAY;IAEZ,MAAM,IAAI,GAAG,OAAO,IAAI,WAAW,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,GAAG,CAAC;IACnD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;AAC5G,CAAC"}

package/dist/http/client.d.ts

@@ -0,0 +1,47 @@
+import type { ToolDefinition } from '../generator/operations.js';
+/**
+ * Forma mínima del cliente HTTP que necesita el activo, desacoplada del `fetch`
+ * global. Cualquier `fetch` de Node lo satisface de forma estructural, y un test
+ * puede inyectar un doble sin depender de la red.
+ */
+export type FetchLike = (input: string, init?: FetchInit) => Promise<FetchResponse>;
+export interface FetchInit {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}
+export interface FetchResponse {
+    status: number;
+    ok: boolean;
+    headers: {
+        get(name: string): string | null;
+    };
+    text(): Promise<string>;
+}
+export interface ExecuteOptions {
+    /** URL base de la API subyacente (sin barra final relevante). */
+    readonly baseUrl: string;
+    /** Cabeceras estáticas (autenticación, contenido) que se envían siempre. */
+    readonly headers?: Readonly<Record<string, string>>;
+    /** Cliente HTTP. Inyectable para los tests. */
+    readonly fetchFn: FetchLike;
+}
+export interface ToolCallResult {
+    readonly status: number;
+    readonly ok: boolean;
+    readonly contentType: string | null;
+    /** Cuerpo ya interpretado si era JSON; si no, el texto crudo. */
+    readonly body: unknown;
+    /** Texto crudo de la respuesta, por si el llamante lo necesita. */
+    readonly raw: string;
+    /** Método y URL finales, útiles para depurar y auditar. */
+    readonly request: {
+        method: string;
+        url: string;
+    };
+}
+/**
+ * Ejecuta la llamada HTTP que representa una herramienta, mapeando los
+ * argumentos validados a parámetros de ruta, query, cabecera y cuerpo.
+ */
+export declare function executeTool(tool: ToolDefinition, args: Readonly<Record<string, unknown>>, options: ExecuteOptions): Promise<ToolCallResult>;

package/dist/http/client.js

@@ -0,0 +1,92 @@
+/**
+ * Ejecuta la llamada HTTP que representa una herramienta, mapeando los
+ * argumentos validados a parámetros de ruta, query, cabecera y cuerpo.
+ */
+export async function executeTool(tool, args, options) {
+    const { binding } = tool;
+    // 1. Ruta: sustituye los marcadores {name} por los parámetros de ruta.
+    let path = binding.pathTemplate;
+    for (const param of binding.params) {
+        if (param.in !== 'path')
+            continue;
+        const value = args[param.name];
+        path = path.replace(`{${param.name}}`, encodeURIComponent(stringifyValue(value)));
+    }
+    // 2. Query: añade los parámetros presentes en los argumentos.
+    const query = new URLSearchParams();
+    for (const param of binding.params) {
+        if (param.in !== 'query')
+            continue;
+        const value = args[param.name];
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                query.append(param.name, stringifyValue(item));
+        }
+        else {
+            query.append(param.name, stringifyValue(value));
+        }
+    }
+    // 3. Cabeceras: estáticas + parámetros de cabecera de la operación.
+    const headers = { ...(options.headers ?? {}) };
+    for (const param of binding.params) {
+        if (param.in !== 'header')
+            continue;
+        const value = args[param.name];
+        if (value === undefined || value === null)
+            continue;
+        headers[param.name] = stringifyValue(value);
+    }
+    // 4. Cuerpo: sólo si la operación lo declara y viene en los argumentos.
+    let body;
+    if (binding.requestBody && args['body'] !== undefined) {
+        body = JSON.stringify(args['body']);
+        if (headers['content-type'] === undefined && headers['Content-Type'] === undefined) {
+            headers['content-type'] = binding.requestBody.contentType;
+        }
+    }
+    const queryString = query.toString();
+    const url = `${trimTrailingSlash(options.baseUrl)}${path}${queryString ? `?${queryString}` : ''}`;
+    const method = binding.method.toUpperCase();
+    const response = await options.fetchFn(url, {
+        method,
+        headers,
+        ...(body === undefined ? {} : { body }),
+    });
+    const raw = await response.text();
+    const contentType = response.headers.get('content-type');
+    const parsed = isJsonContent(contentType) ? tryParseJson(raw) : raw;
+    return {
+        status: response.status,
+        ok: response.ok,
+        contentType,
+        body: parsed,
+        raw,
+        request: { method, url },
+    };
+}
+function stringifyValue(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value);
+}
+function trimTrailingSlash(url) {
+    return url.endsWith('/') ? url.slice(0, -1) : url;
+}
+function isJsonContent(contentType) {
+    return contentType !== null && /\bjson\b/i.test(contentType);
+}
+function tryParseJson(raw) {
+    if (raw.trim() === '')
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/http/client.js.map

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

package/dist/http/format.d.ts

@@ -0,0 +1,10 @@
+import type { ToolCallResult } from './client.js';
+export type FormatMode = 'markdown' | 'json';
+/**
+ * Da forma a la respuesta HTTP para que ocupe poco y sea legible dentro de la
+ * ventana de contexto de un LLM.
+ *
+ * - `json`: un objeto compacto con estado y cuerpo, en JSON indentado.
+ * - `markdown`: una línea de estado y el cuerpo en un bloque de código.
+ */
+export declare function formatResult(result: ToolCallResult, mode?: FormatMode): string;

package/dist/http/format.js

@@ -0,0 +1,22 @@
+/**
+ * Da forma a la respuesta HTTP para que ocupe poco y sea legible dentro de la
+ * ventana de contexto de un LLM.
+ *
+ * - `json`: un objeto compacto con estado y cuerpo, en JSON indentado.
+ * - `markdown`: una línea de estado y el cuerpo en un bloque de código.
+ */
+export function formatResult(result, mode = 'markdown') {
+    if (mode === 'json') {
+        return JSON.stringify({ status: result.status, ok: result.ok, body: result.body }, null, 2);
+    }
+    const bodyText = typeof result.body === 'string' ? result.body : JSON.stringify(result.body, null, 2);
+    const lang = typeof result.body === 'string' ? '' : 'json';
+    return [
+        `HTTP ${result.status} ${result.ok ? '(OK)' : '(error)'} — ${result.request.method} ${result.request.url}`,
+        '',
+        '```' + lang,
+        bodyText,
+        '```',
+    ].join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/http/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/http/format.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAsB,EAAE,OAAmB,UAAU;IAChF,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,QAAQ,GACZ,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvF,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAE3D,OAAO;QACL,QAAQ,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;QAC1G,EAAE;QACF,KAAK,GAAG,IAAI;QACZ,QAAQ;QACR,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * openapi-to-mcp — convierte una especificación OpenAPI 3.x en un servidor
+ * Model Context Protocol (MCP). Este barrel expone la API pública para usarlo
+ * como biblioteca; la CLI vive en `cli.ts`.
+ */
+export { loadSpec, parseSpecContent } from './openapi/load.js';
+export type { LoadOptions } from './openapi/load.js';
+export { RefResolver } from './openapi/resolve.js';
+export type { OpenApiDocument, OperationObject, ParameterObject, PathItemObject, RequestBodyObject, SchemaObject, ServerObject, HttpMethod, } from './openapi/types.js';
+export { HTTP_METHODS } from './openapi/types.js';
+export { schemaToZod } from './schema/to-zod.js';
+export { toJsonSchema } from './schema/to-json.js';
+export type { JsonValue } from './schema/to-json.js';
+export { buildTools } from './generator/operations.js';
+export type { BuildToolsOptions, BuildToolsResult, JsonSchemaObject, ParamBinding, ToolBinding, ToolDefinition, } from './generator/operations.js';
+export { generateServerCode } from './generator/codegen.js';
+export type { CodegenOptions } from './generator/codegen.js';
+export { executeTool } from './http/client.js';
+export type { ExecuteOptions, FetchInit, FetchLike, FetchResponse, ToolCallResult, } from './http/client.js';
+export { formatResult } from './http/format.js';
+export type { FormatMode } from './http/format.js';
+export { createMcpServer, PROTOCOL_VERSION, defaultServerLogger } from './mcp/server.js';
+export type { McpServer, McpServerOptions } from './mcp/server.js';
+export { startStdioServer } from './mcp/stdio.js';
+export type { StdioOptions } from './mcp/stdio.js';
+export { failure, isRequest, success, JSON_RPC_ERROR, } from './mcp/jsonrpc.js';
+export type { JsonRpcErrorResponse, JsonRpcIncoming, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccess, } from './mcp/jsonrpc.js';

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * openapi-to-mcp — convierte una especificación OpenAPI 3.x en un servidor
+ * Model Context Protocol (MCP). Este barrel expone la API pública para usarlo
+ * como biblioteca; la CLI vive en `cli.ts`.
+ */
+export { loadSpec, parseSpecContent } from './openapi/load.js';
+export { RefResolver } from './openapi/resolve.js';
+export { HTTP_METHODS } from './openapi/types.js';
+export { schemaToZod } from './schema/to-zod.js';
+export { toJsonSchema } from './schema/to-json.js';
+export { buildTools } from './generator/operations.js';
+export { generateServerCode } from './generator/codegen.js';
+export { executeTool } from './http/client.js';
+export { formatResult } from './http/format.js';
+export { createMcpServer, PROTOCOL_VERSION, defaultServerLogger } from './mcp/server.js';
+export { startStdioServer } from './mcp/stdio.js';
+export { failure, isRequest, success, JSON_RPC_ERROR, } from './mcp/jsonrpc.js';
+//# sourceMappingURL=index.js.map