@ssolis-ti/mcp-compra-agil 1.0.2

package/dist/api/compra-agil-client.js

@@ -0,0 +1,137 @@
+/**
+ * Cliente HTTP para la API REST de Compra Ágil v2 de Mercado Público.
+ *
+ * Centraliza autenticación, manejo de errores, rate limiting
+ * y paginación automática.
+ *
+ * Usa fetch nativo de Node.js 22+ (sin dependencias externas).
+ */
+import { logger } from '../utils/logger.js';
+import { handleApiResponse, CompraAgilApiError } from '../utils/error-handler.js';
+import { RateLimiter } from '../utils/rate-limiter.js';
+// ─── Cliente ────────────────────────────────────────────────────────
+export class CompraAgilClient {
+    baseUrl;
+    ticket;
+    rateLimiter;
+    constructor(ticket, baseUrl) {
+        this.ticket = ticket;
+        this.baseUrl = baseUrl || 'https://api2.mercadopublico.cl';
+        this.rateLimiter = new RateLimiter();
+    }
+    /**
+     * Realiza un GET autenticado a la API.
+     */
+    async request(path, params) {
+        // Verificar rate limit antes de enviar
+        const limitCheck = this.rateLimiter.checkLimit();
+        if (limitCheck.limited) {
+            throw new CompraAgilApiError(429, [{
+                    codigo: '429',
+                    mensaje: `Cuota diaria agotada. Se restablece en ${limitCheck.resetIn}.`,
+                    detalle: null,
+                }]);
+        }
+        // Construir URL con query params
+        const base = path.startsWith('/servicios') ? 'https://api.mercadopublico.cl' : this.baseUrl;
+        const url = new URL(path, base);
+        if (path.startsWith('/servicios')) {
+            url.searchParams.set('ticket', this.ticket);
+        }
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null && value !== '') {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        logger.debug(`API Request: GET ${url.toString()}`);
+        const response = await fetch(url.toString(), {
+            method: 'GET',
+            headers: {
+                'ticket': this.ticket,
+            },
+        });
+        if (response.status === 429) {
+            this.rateLimiter.markLimited();
+        }
+        else {
+            this.rateLimiter.recordRequest();
+        }
+        const payload = await handleApiResponse(response);
+        return payload;
+    }
+    /**
+     * Buscar Compras Ágiles con filtros y paginación.
+     */
+    async buscar(params) {
+        const queryParams = {
+            ttl_cambio_ms: params.ttl_cambio_ms,
+            cambio_desde: params.cambio_desde,
+            cambio_hasta: params.cambio_hasta,
+            publicado_desde: params.publicado_desde,
+            publicado_hasta: params.publicado_hasta,
+            estado: params.estado,
+            region: params.region,
+            id: params.id,
+            q: params.q,
+            tamano_pagina: params.tamano_pagina,
+            numero_pagina: params.numero_pagina,
+            ordenar_por: params.ordenar_por,
+        };
+        return this.request('/v2/compra-agil', queryParams);
+    }
+    /**
+     * Buscar todas las páginas de resultados (auto-paginación).
+     * Útil cuando la IA necesita todos los resultados sin gestionar páginas.
+     */
+    async buscarTodo(params, maxPages = 10) {
+        const allItems = [];
+        let currentPage = 1;
+        while (currentPage <= maxPages) {
+            const response = await this.buscar({
+                ...params,
+                tamano_pagina: params.tamano_pagina || 50,
+                numero_pagina: currentPage,
+            });
+            allItems.push(...response.items);
+            logger.debug(`Auto-paginación: página ${response.paginacion.numero_pagina}/${response.paginacion.total_paginas}`);
+            if (currentPage >= response.paginacion.total_paginas) {
+                break;
+            }
+            currentPage++;
+        }
+        return allItems;
+    }
+    /**
+     * Obtener el detalle completo de una Compra Ágil específica.
+     */
+    async detalle(codigo) {
+        return this.request(`/v2/compra-agil/${encodeURIComponent(codigo)}`);
+    }
+    /**
+     * Buscar cambios recientes en los últimos N milisegundos.
+     */
+    async cambiosRecientes(ttlMs, filtros) {
+        return this.buscar({
+            ttl_cambio_ms: ttlMs,
+            ...filtros,
+        });
+    }
+    /**
+     * Obtener estadísticas del rate limiter.
+     */
+    getRateLimitStats() {
+        return this.rateLimiter.getStats();
+    }
+    /**
+     * Obtener el detalle completo de una Orden de Compra (OC).
+     * Admite tanto el ID numérico interno como el código alfanumérico.
+     */
+    async obtenerDetalleOC(idOC) {
+        return this.request('/servicios/v1/publico/OrdenCompra.json', {
+            codigo: String(idOC),
+        });
+    }
+}
+//# sourceMappingURL=compra-agil-client.js.map

package/dist/api/compra-agil-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+import { loadEnvManual } from './utils/env-loader.js';
+// Inicializar entorno antes de cualquier otra importación o llamada
+loadEnvManual();
+/**
+ * MCP Server: Compra Ágil v2 — Mercado Público de Chile
+ *
+ * Servidor MCP que envuelve la API REST de Compra Ágil v2,
+ * permitiendo a cualquier IA, agente o cliente MCP consultar
+ * procesos de compra pública del Estado de Chile.
+ *
+ * Transporte: Stdio (compatible con Claude Desktop, Cursor, OpenClaw, etc.)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CompraAgilClient } from './api/compra-agil-client.js';
+import { logger, setMcpServer } from './utils/logger.js';
+// Tools
+import { registerBuscarCompras } from './tools/buscar-compras.js';
+import { registerDetalleCompra } from './tools/detalle-compra.js';
+import { registerMonitorearCambios } from './tools/monitorear-cambios.js';
+import { registerVerificarOC } from './tools/verificar-oc.js';
+import { registerEstadisticasUso } from './tools/estadisticas-uso.js';
+import { registerDetalleOC } from './tools/detalle-oc.js';
+import { registerDocumentosTools } from './tools/documentos.js';
+import { registerRecomendarPrecio } from './tools/recomendar-precio.js';
+import { registerAuditarDesiertas } from './tools/auditar-desiertas.js';
+import { registerGenerarBorrador } from './tools/generar-borrador.js';
+import { registerRadarOportunidades } from './tools/radar-oportunidades.js';
+// Resources
+import { registerRegionesResource } from './resources/regiones.js';
+import { registerEstadosResource } from './resources/estados.js';
+import { registerGlosarioResource } from './resources/glosario.js';
+import { registerComprasTemplateResource } from './resources/compras-template.js';
+import { registerDocumentacionResource } from './resources/documentacion.js';
+// Prompts
+import { registerBuscarOportunidadesPrompt } from './prompts/buscar-oportunidades.js';
+import { registerAnalizarCompetenciaPrompt } from './prompts/analizar-competencia.js';
+// ─── Configuración ──────────────────────────────────────────────────
+const TICKET = process.env.COMPRA_AGIL_TICKET;
+const BASE_URL = process.env.COMPRA_AGIL_BASE_URL || 'https://api2.mercadopublico.cl';
+if (!TICKET) {
+    logger.error('Variable de entorno COMPRA_AGIL_TICKET no configurada. ' +
+        'Obtén tu ticket en https://www.chilecompra.cl/api/ y configúrala antes de iniciar el servidor.');
+    process.exit(1);
+}
+// Ticket validado — asignar a const tipada para usar dentro de main()
+const VALID_TICKET = TICKET;
+// ─── Inicialización ─────────────────────────────────────────────────
+async function main() {
+    logger.info('Iniciando servidor MCP Compra Ágil v2...');
+    // 1. Crear cliente HTTP para la API de Mercado Público
+    const client = new CompraAgilClient(VALID_TICKET, BASE_URL);
+    logger.info(`Cliente API configurado → ${BASE_URL}`);
+    // 2. Crear servidor MCP
+    const server = new McpServer({
+        name: 'mcp-compra-agil',
+        version: '1.0.0',
+    });
+    // 3. Registrar herramientas (Tools)
+    registerBuscarCompras(server, client);
+    registerDetalleCompra(server, client);
+    registerMonitorearCambios(server, client);
+    registerVerificarOC(server, client);
+    registerEstadisticasUso(server, client);
+    registerDetalleOC(server, client);
+    registerDocumentosTools(server);
+    registerRecomendarPrecio(server, client);
+    registerAuditarDesiertas(server, client);
+    registerGenerarBorrador(server, client);
+    registerRadarOportunidades(server, client);
+    logger.info('13 herramientas registradas: buscar_compras_agiles, obtener_detalle_compra, monitorear_cambios_recientes, verificar_orden_compra, obtener_estadisticas_uso, obtener_detalle_orden_compra, obtener_enlace_documento, descargar_y_leer_documento, consultar_documentos_locales, recomendar_precio_ganador, auditar_compras_desiertas, generar_borrador_cotizacion, radar_oportunidades_calientes');
+    // 4. Registrar recursos (Resources)
+    registerRegionesResource(server);
+    registerEstadosResource(server);
+    registerGlosarioResource(server);
+    registerComprasTemplateResource(server, client);
+    registerDocumentacionResource(server);
+    logger.info('5 recursos registrados: regiones, estados, glosario, compra-agil://compras/{codigo}, compra-agil://documentacion/{filename}');
+    // 5. Registrar prompts
+    registerBuscarOportunidadesPrompt(server);
+    registerAnalizarCompetenciaPrompt(server);
+    logger.info('2 prompts registrados: buscar_oportunidades_proveedor, analizar_competencia');
+    // 6. Conectar al transporte Stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // 7. Enlazar logger con la instancia del servidor conectado para logs nativos
+    setMcpServer(server);
+    logger.info('Servidor MCP Compra Ágil v2 listo y escuchando via Stdio.');
+}
+main().catch((error) => {
+    logger.error('Error fatal al iniciar el servidor MCP:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/prompts/analizar-competencia.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Prompt: analizar_competencia
+ *
+ * Plantilla guiada para que la IA analice la competencia
+ * en un proceso de Compra Ágil específico.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAnalizarCompetenciaPrompt(server: McpServer): void;
+//# sourceMappingURL=analizar-competencia.d.ts.map

package/dist/prompts/analizar-competencia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analizar-competencia.d.ts","sourceRoot":"","sources":["../../src/prompts/analizar-competencia.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6CzE"}

package/dist/prompts/analizar-competencia.js

@@ -0,0 +1,50 @@
+/**
+ * Prompt: analizar_competencia
+ *
+ * Plantilla guiada para que la IA analice la competencia
+ * en un proceso de Compra Ágil específico.
+ */
+import { z } from 'zod';
+export function registerAnalizarCompetenciaPrompt(server) {
+    server.registerPrompt('analizar_competencia', {
+        description: 'Analiza la competencia en un proceso de Compra Ágil específico. Compara proveedores, precios, y genera insights sobre la competitividad del proceso.',
+        argsSchema: {
+            codigo: z.string().describe('Código de la Compra Ágil a analizar. Ej: "1057539-228-COT26".'),
+        },
+    }, async (args) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Necesito un análisis competitivo del proceso de Compra Ágil con código "${args.codigo}".
+
+Por favor, sigue estos pasos:
+
+1. **Obtener el detalle completo:** Usa "obtener_detalle_compra" con el código "${args.codigo}".
+
+2. **Verificar estado de OC:** Usa "verificar_orden_compra" para saber si ya se emitió una Orden de Compra.
+
+3. **Analizar los proveedores cotizando:**
+   - Lista todos los proveedores con sus montos totales, valores netos y costos de despacho.
+   - Identifica cuáles son Empresa de Menor Tamaño (EMT).
+   - Si hay productos cotizados, compara los precios unitarios entre proveedores.
+
+4. **Generar análisis comparativo:**
+   - Tabla comparativa de todos los proveedores:
+     | Proveedor | RUT | EMT | Valor Neto | Impuesto | Despacho | Total |
+   - Identifica al proveedor más económico y al más caro.
+   - Calcula el spread (diferencia porcentual entre el más barato y el más caro).
+   - Si hay precios unitarios, identifica en qué productos hay mayor diferencia de precio.
+
+5. **Conclusiones:**
+   - ¿El proceso es muy competitivo (muchos proveedores) o poco competitivo?
+   - ¿El presupuesto disponible es coherente con las ofertas recibidas?
+   - ¿Qué proveedor tiene la mejor relación precio-completitud?
+   - Si se seleccionó un proveedor, ¿fue el más barato o hay otros criterios?`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=analizar-competencia.js.map

package/dist/prompts/analizar-competencia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analizar-competencia.js","sourceRoot":"","sources":["../../src/prompts/analizar-competencia.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,iCAAiC,CAAC,MAAiB;IACjE,MAAM,CAAC,cAAc,CACnB,sBAAsB,EACtB;QACE,WAAW,EAAE,sJAAsJ;QACnK,UAAU,EAAE;YACV,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;SAC7F;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACf,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,2EAA2E,IAAI,CAAC,MAAM;;;;kFAItB,IAAI,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;8EAoBf;iBACnE;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/prompts/buscar-oportunidades.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Prompt: buscar_oportunidades_proveedor
+ *
+ * Plantilla guiada para que la IA ayude a un proveedor
+ * a encontrar oportunidades de negocio en Compra Ágil.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerBuscarOportunidadesPrompt(server: McpServer): void;
+//# sourceMappingURL=buscar-oportunidades.d.ts.map

package/dist/prompts/buscar-oportunidades.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buscar-oportunidades.d.ts","sourceRoot":"","sources":["../../src/prompts/buscar-oportunidades.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2CzE"}

package/dist/prompts/buscar-oportunidades.js

@@ -0,0 +1,48 @@
+/**
+ * Prompt: buscar_oportunidades_proveedor
+ *
+ * Plantilla guiada para que la IA ayude a un proveedor
+ * a encontrar oportunidades de negocio en Compra Ágil.
+ */
+import { z } from 'zod';
+export function registerBuscarOportunidadesPrompt(server) {
+    server.registerPrompt('buscar_oportunidades_proveedor', {
+        description: 'Ayuda a un proveedor a encontrar oportunidades de Compra Ágil relevantes para su rubro y región. Genera un resumen ejecutivo con las mejores oportunidades, presupuestos y plazos.',
+        argsSchema: {
+            rubro: z.string().describe('Rubro o tipo de productos/servicios del proveedor. Ej: "materiales eléctricos", "servicios de limpieza", "equipos médicos".'),
+            region: z.string().describe('Región de interés del proveedor. Puede ser el nombre (ej: "Metropolitana") o el código numérico (ej: "13").'),
+        },
+    }, async (args) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Soy un proveedor del rubro "${args.rubro}" y me interesa encontrar oportunidades de Compra Ágil en la región "${args.region}".
+
+Por favor, sigue estos pasos:
+
+1. **Resolver la región:** Consulta el recurso "compra-agil://regiones" para obtener el código numérico de la región "${args.region}" si es que proporcioné el nombre.
+
+2. **Buscar oportunidades abiertas:** Usa la herramienta "buscar_compras_agiles" con:
+   - estado: "publicada" (solo procesos abiertos recibiendo cotizaciones)
+   - region: el código numérico resuelto
+   - q: "${args.rubro}" como palabras clave
+   - tamano_pagina: 50
+
+3. **Analizar los resultados:** Para los 5 procesos más relevantes (por presupuesto o afinidad), usa "obtener_detalle_compra" para obtener:
+   - Productos solicitados con cantidades
+   - Presupuesto disponible
+   - Fecha de cierre (plazo para cotizar)
+   - Dirección y plazo de entrega
+   - Número de competidores (ofertas recibidas)
+
+4. **Generar resumen ejecutivo:** Presenta una tabla con:
+   | Código | Nombre | Presupuesto CLP | Cierre | Productos | Competidores |
+   Y una recomendación sobre las mejores oportunidades considerando presupuesto alto, pocos competidores y afinidad con mi rubro.`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=buscar-oportunidades.js.map

package/dist/prompts/buscar-oportunidades.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buscar-oportunidades.js","sourceRoot":"","sources":["../../src/prompts/buscar-oportunidades.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,iCAAiC,CAAC,MAAiB;IACjE,MAAM,CAAC,cAAc,CACnB,gCAAgC,EAChC;QACE,WAAW,EAAE,oLAAoL;QACjM,UAAU,EAAE;YACV,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6HAA6H,CAAC;YACzJ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6GAA6G,CAAC;SAC3I;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACf,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,+BAA+B,IAAI,CAAC,KAAK,wEAAwE,IAAI,CAAC,MAAM;;;;wHAItB,IAAI,CAAC,MAAM;;;;;WAKxH,IAAI,CAAC,KAAK;;;;;;;;;;;;kIAY6G;iBACvH;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources/compras-template.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resource: compra-agil://compras/{codigo}
+ *
+ * Recurso dinámico que permite consultar la ficha detallada de una Compra Ágil
+ * directamente mediante lectura de URI del protocolo MCP.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { CompraAgilClient } from '../api/compra-agil-client.js';
+export declare function registerComprasTemplateResource(server: McpServer, client: CompraAgilClient): void;
+//# sourceMappingURL=compras-template.d.ts.map

package/dist/resources/compras-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compras-template.d.ts","sourceRoot":"","sources":["../../src/resources/compras-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAoCjG"}

package/dist/resources/compras-template.js

@@ -0,0 +1,40 @@
+/**
+ * Resource: compra-agil://compras/{codigo}
+ *
+ * Recurso dinámico que permite consultar la ficha detallada de una Compra Ágil
+ * directamente mediante lectura de URI del protocolo MCP.
+ */
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { CompraAgilApiError } from '../utils/error-handler.js';
+export function registerComprasTemplateResource(server, client) {
+    // Crear plantilla de URI para compra-agil://compras/{codigo}
+    const template = new ResourceTemplate('compra-agil://compras/{codigo}', {
+        list: undefined, // No implementamos listado dinámico masivo para evitar saturar la cuota de la API
+    });
+    server.registerResource('detalle-compra-dinamica', template, {
+        description: 'Obtiene el detalle completo de un proceso de Compra Ágil por su código único (formato XXXXXX-YYY-COTXX) en formato JSON estructurado.',
+        mimeType: 'application/json',
+    }, async (uri, variables) => {
+        try {
+            const codigo = variables.codigo;
+            if (!codigo) {
+                throw new Error('El parámetro "codigo" es requerido en la URI.');
+            }
+            const detalle = await client.detalle(codigo);
+            return {
+                contents: [{
+                        uri: uri.toString(),
+                        mimeType: 'application/json',
+                        text: JSON.stringify(detalle, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof CompraAgilApiError
+                ? error.actionableMessage
+                : `Error al leer recurso de Compra Ágil: ${String(error)}`;
+            throw new Error(message);
+        }
+    });
+}
+//# sourceMappingURL=compras-template.js.map

package/dist/resources/compras-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compras-template.js","sourceRoot":"","sources":["../../src/resources/compras-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,MAAwB;IACzF,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,gCAAgC,EAAE;QACtE,IAAI,EAAE,SAAS,EAAE,kFAAkF;KACpG,CAAC,CAAC;IAEH,MAAM,CAAC,gBAAgB,CACrB,yBAAyB,EACzB,QAAQ,EACR;QACE,WAAW,EAAE,uIAAuI;QACpJ,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,SAAS,CAAC,MAAgB,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7C,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;wBACnB,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;qBACvC,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,kBAAkB;gBACjD,CAAC,CAAC,KAAK,CAAC,iBAAiB;gBACzB,CAAC,CAAC,yCAAyC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources/documentacion.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registra el recurso dinámico para consultar manuales y guías locales (PDF/TXT/MD).
+ */
+export declare function registerDocumentacionResource(server: McpServer): void;
+//# sourceMappingURL=documentacion.d.ts.map

package/dist/resources/documentacion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentacion.d.ts","sourceRoot":"","sources":["../../src/resources/documentacion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAoCtF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsErE"}

package/dist/resources/documentacion.js

@@ -0,0 +1,100 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { PDFParse } from 'pdf-parse';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageDocsDir = path.resolve(__dirname, '../../docs');
+const cwdDocsDir = path.resolve(process.cwd(), 'docs');
+let DOCS_DIR = cwdDocsDir;
+if (fs.existsSync(packageDocsDir) && fs.readdirSync(packageDocsDir).some(f => f.toLowerCase().endsWith('.pdf'))) {
+    DOCS_DIR = packageDocsDir;
+}
+/**
+ * Obtiene de forma recursiva todos los archivos dentro de un directorio,
+ * retornando sus rutas relativas formateadas con barras diagonales (/).
+ */
+function getRelativeFilesRecursively(dir, baseDir = dir) {
+    let results = [];
+    if (!fs.existsSync(dir))
+        return [];
+    const list = fs.readdirSync(dir);
+    for (const file of list) {
+        const filePath = path.join(dir, file);
+        const stat = fs.statSync(filePath);
+        if (stat && stat.isDirectory()) {
+            results = results.concat(getRelativeFilesRecursively(filePath, baseDir));
+        }
+        else {
+            const relativePath = path.relative(baseDir, filePath).replace(/\\/g, '/');
+            results.push(relativePath);
+        }
+    }
+    return results;
+}
+/**
+ * Registra el recurso dinámico para consultar manuales y guías locales (PDF/TXT/MD).
+ */
+export function registerDocumentacionResource(server) {
+    // Crear plantilla de URI para compra-agil://documentacion/{filename}
+    const template = new ResourceTemplate('compra-agil://documentacion/{filename}', {
+        list: async () => {
+            try {
+                if (!fs.existsSync(DOCS_DIR)) {
+                    fs.mkdirSync(DOCS_DIR, { recursive: true });
+                }
+                const files = getRelativeFilesRecursively(DOCS_DIR).filter(file => {
+                    const ext = path.extname(file).toLowerCase();
+                    const name = path.basename(file).toLowerCase();
+                    return (ext === '.pdf' || ext === '.txt' || ext === '.md') && name !== 'readme.md';
+                });
+                return {
+                    resources: files.map(file => ({
+                        uri: `compra-agil://documentacion/${encodeURIComponent(file)}`,
+                        name: file,
+                        mimeType: 'text/plain', // Indicamos que el contenido entregado es de texto plano para que el LLM lo interprete
+                        description: `Manual o Guía de Compra Ágil: ${file}`,
+                    })),
+                };
+            }
+            catch (error) {
+                console.error('Error al listar recursos de documentación:', error);
+                return { resources: [] };
+            }
+        },
+    });
+    server.registerResource('documentacion-ayuda', template, {
+        description: 'Obtiene el contenido textual completo de una guía o manual local sobre Compra Ágil usando su nombre de archivo.',
+        mimeType: 'text/plain',
+    }, async (uri, variables) => {
+        try {
+            const filename = decodeURIComponent(variables.filename);
+            const filePath = path.join(DOCS_DIR, filename);
+            if (!fs.existsSync(filePath)) {
+                throw new Error(`El archivo ${filename} no existe en la carpeta docs/.`);
+            }
+            const ext = path.extname(filename).toLowerCase();
+            let text = '';
+            if (ext === '.pdf') {
+                const buffer = fs.readFileSync(filePath);
+                const parser = new PDFParse({ data: buffer });
+                const pdfData = await parser.getText();
+                text = pdfData.text || '';
+            }
+            else {
+                text = fs.readFileSync(filePath, 'utf8');
+            }
+            return {
+                contents: [{
+                        uri: uri.toString(),
+                        mimeType: 'text/plain',
+                        text: text,
+                    }],
+            };
+        }
+        catch (error) {
+            throw new Error(`Error al leer el manual local: ${error.message || String(error)}`);
+        }
+    });
+}
+//# sourceMappingURL=documentacion.js.map

package/dist/resources/documentacion.js.map

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

package/dist/resources/estados.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resource: compra-agil://estados
+ *
+ * Catálogo de estados válidos de una Compra Ágil con descripciones
+ * y notas sobre comportamiento real de la API.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerEstadosResource(server: McpServer): void;
+//# sourceMappingURL=estados.d.ts.map

package/dist/resources/estados.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estados.d.ts","sourceRoot":"","sources":["../../src/resources/estados.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmCpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgB/D"}

package/dist/resources/estados.js

@@ -0,0 +1,51 @@
+/**
+ * Resource: compra-agil://estados
+ *
+ * Catálogo de estados válidos de una Compra Ágil con descripciones
+ * y notas sobre comportamiento real de la API.
+ */
+const ESTADOS = [
+    {
+        codigo: 'publicada',
+        descripcion: 'La Compra Ágil está abierta y recibiendo cotizaciones de proveedores.',
+        nota: null,
+    },
+    {
+        codigo: 'cerrada',
+        descripcion: 'El plazo de cotización finalizó. El organismo está evaluando las ofertas.',
+        nota: null,
+    },
+    {
+        codigo: 'desierta',
+        descripcion: 'No se recibieron ofertas válidas para este proceso.',
+        nota: null,
+    },
+    {
+        codigo: 'cancelada',
+        descripcion: 'El proceso fue cancelado por el organismo comprador.',
+        nota: 'El motivo de cancelación está disponible en el campo motivos.motivo_cancelacion del detalle.',
+    },
+    {
+        codigo: 'proveedor_seleccionado',
+        descripcion: 'Se seleccionó al proveedor ganador. INCLUYE también las Compras Ágiles que ya tienen OC emitida.',
+        nota: 'Este estado agrupa tanto los procesos con proveedor elegido como los que ya tienen Orden de Compra. Para distinguirlos, usa la herramienta "verificar_orden_compra".',
+    },
+    {
+        codigo: 'oc_emitida',
+        descripcion: 'Se emitió una Orden de Compra (definido en el modelo de la API).',
+        nota: '⚠ LIMITACIÓN CONOCIDA: Este estado NO aparece en la práctica en las respuestas de la API. Los procesos con OC emitida se listan bajo "proveedor_seleccionado". Usa la herramienta "verificar_orden_compra" para detectar si un proceso tiene OC real.',
+    },
+];
+export function registerEstadosResource(server) {
+    server.registerResource('estados', 'compra-agil://estados', {
+        description: 'Catálogo de estados válidos de una Compra Ágil con descripciones y notas sobre limitaciones conocidas de la API. Consulta este recurso antes de filtrar por estado para entender qué significa cada valor.',
+        mimeType: 'application/json',
+    }, async () => ({
+        contents: [{
+                uri: 'compra-agil://estados',
+                mimeType: 'application/json',
+                text: JSON.stringify(ESTADOS, null, 2),
+            }],
+    }));
+}
+//# sourceMappingURL=estados.js.map