@ssolis-ti/mcp-compra-agil 1.0.2

package/dist/tools/recomendar-precio.js

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+import { CompraAgilApiError } from '../utils/error-handler.js';
+import { logger } from '../utils/logger.js';
+const TOOL_NAME = 'recomendar_precio_ganador';
+const TOOL_DESCRIPTION = `Analiza procesos históricos similares de Compra Ágil que ya fueron cerrados y adjudicados para estimar y sugerir un precio unitario o total óptimo y competitivo para postular.
+Admite ingresar el código de una compra activa para extraer automáticamente las palabras clave o un término de búsqueda genérico.
+Nota: Realiza consultas en paralelo acotadas por el rate limiter.`;
+const inputSchema = {
+    codigo_compra: z.string().optional().describe('Código de la Compra Ágil activa para analizar (ej: "1057539-228-COT26"). Opcional si se especifica "q".'),
+    q: z.string().optional().describe('Término de búsqueda de producto/servicio a cotizar (ej: "resmas papel", "soporte computadores"). Opcional si se especifica "codigo_compra".'),
+    region: z.string().optional().describe('Código de la región para acotar el análisis histórico (1-16). Ej: "13" para Metropolitana.'),
+    limite_analisis: z.number().min(1).max(8).default(5).optional().describe('Cantidad máxima de procesos históricos a auditar (1-8, default 5) para no agotar la cuota de la API.'),
+};
+export function registerRecomendarPrecio(server, client) {
+    server.registerTool(TOOL_NAME, {
+        description: TOOL_DESCRIPTION,
+        inputSchema: inputSchema,
+    }, async (args) => {
+        try {
+            let keyword = args.q || '';
+            let region = args.region || '';
+            let targetProductDetail = '';
+            // 1. Si hay un código de compra activa, obtener su detalle para sacar las palabras clave
+            if (args.codigo_compra) {
+                logger.info(`recomendar_precio_ganador: Obteniendo detalle de compra activa ${args.codigo_compra}`);
+                const activeDetail = await client.detalle(args.codigo_compra);
+                if (activeDetail.productos_solicitados && activeDetail.productos_solicitados.length > 0) {
+                    const firstProd = activeDetail.productos_solicitados[0];
+                    keyword = firstProd.nombre;
+                    targetProductDetail = `Producto solicitado en la compra activa: "${firstProd.nombre}" (Cantidad: ${firstProd.cantidad} ${firstProd.unidad_medida})`;
+                }
+                else {
+                    keyword = activeDetail.nombre;
+                    targetProductDetail = `Proceso activo: "${activeDetail.nombre}"`;
+                }
+                // Si no se especificó región en los argumentos, usar la región de la compra activa
+                if (!region && activeDetail.institucion.region !== null) {
+                    region = String(activeDetail.institucion.region);
+                }
+            }
+            if (!keyword) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: 'Error de validación: Debes proporcionar "codigo_compra" (para buscar palabras clave automáticamente) o un término de búsqueda "q".',
+                        }],
+                    isError: true,
+                };
+            }
+            // 2. Buscar procesos históricos cerrados que ya tengan proveedor seleccionado
+            logger.info(`recomendar_precio_ganador: Buscando procesos cerrados adjudicados para "${keyword}" en región "${region || 'Todas'}"`);
+            const limit = args.limite_analisis || 5;
+            const searchResponse = await client.buscar({
+                q: keyword,
+                estado: 'proveedor_seleccionado',
+                region: region || undefined,
+                tamano_pagina: 10, // API v2 requiere mínimo 10
+                numero_pagina: 1,
+            });
+            if (!searchResponse.items || searchResponse.items.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `No se encontraron procesos históricos cerrados en estado "proveedor_seleccionado" que coincidan con la búsqueda "${keyword}" en la región ${region || 'todas'}. No hay datos históricos suficientes para realizar una recomendación de precios.`,
+                        }],
+                };
+            }
+            // 3. Consultar en paralelo (acotado por el limitador interno de la clase client) los detalles para obtener el ganador
+            const prices = [];
+            const processedItems = [];
+            const itemsToProcess = searchResponse.items.slice(0, limit);
+            logger.info(`recomendar_precio_ganador: Analizando detalles de ${itemsToProcess.length} procesos adjudicados`);
+            for (const item of itemsToProcess) {
+                try {
+                    const detail = await client.detalle(item.codigo);
+                    // Buscar al adjudicado/ganador
+                    const winner = detail.proveedores_cotizando?.find(prov => {
+                        if (prov.proveedor_seleccionado === true || prov.proveedor_seleccionado === 1)
+                            return true;
+                        if (prov.seleccion && prov.seleccion.proveedor_seleccionado === true)
+                            return true;
+                        return false;
+                    });
+                    if (winner) {
+                        const totalNeto = winner.valor_neto || winner.monto_total || 0;
+                        let unitPrice = null;
+                        // Intentar extraer el precio unitario del producto cotizado
+                        if (winner.productos_cotizados && winner.productos_cotizados.length === 1) {
+                            unitPrice = winner.productos_cotizados[0].precio_unitario;
+                        }
+                        else if (winner.productos_cotizados && winner.productos_cotizados.length > 1) {
+                            // Buscar el producto cotizado que más coincida con la keyword original
+                            const matchedProd = winner.productos_cotizados.find(p => p.nombre_producto.toLowerCase().includes(keyword.toLowerCase()));
+                            if (matchedProd) {
+                                unitPrice = matchedProd.precio_unitario;
+                            }
+                            else {
+                                // Fallback: usar el precio del primer item
+                                unitPrice = winner.productos_cotizados[0].precio_unitario;
+                            }
+                        }
+                        const priceValue = unitPrice || totalNeto;
+                        if (priceValue > 0) {
+                            prices.push(priceValue);
+                        }
+                        processedItems.push({
+                            codigo: item.codigo,
+                            institucion: item.institucion.organismo_comprador,
+                            fecha_cierre: item.fechas.fecha_cierre,
+                            ganador: winner.razon_social,
+                            es_emt: winner.es_emt,
+                            monto_total_adjudicado: winner.monto_total,
+                            precio_unitario_adjudicado: unitPrice,
+                            criterio_seleccion: winner.seleccion?.criterio_seleccion || 'No especificado',
+                        });
+                    }
+                }
+                catch (detailError) {
+                    logger.warn(`recomendar_precio_ganador: Error al consultar detalle de ${item.codigo}: ${String(detailError)}`);
+                }
+            }
+            if (prices.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Se encontraron ${searchResponse.items.length} procesos históricos que coinciden con "${keyword}", pero no se pudo extraer información económica de los ganadores debido a datos incompletos en la API.`,
+                        }],
+                };
+            }
+            // 4. Calcular estadísticas
+            prices.sort((a, b) => a - b);
+            const min = prices[0];
+            const max = prices[prices.length - 1];
+            const sum = prices.reduce((acc, val) => acc + val, 0);
+            const avg = Math.round(sum / prices.length);
+            // Mediana
+            const mid = Math.floor(prices.length / 2);
+            const median = prices.length % 2 !== 0 ? prices[mid] : Math.round((prices[mid - 1] + prices[mid]) / 2);
+            // 5. Sugerir precio competitivo (5% por debajo del promedio como referencia competitiva, acotada por el mínimo)
+            let recommended = Math.round(avg * 0.95);
+            if (recommended < min) {
+                recommended = min;
+            }
+            const result = {
+                proceso_activo: targetProductDetail || undefined,
+                termino_clave_utilizado: keyword,
+                region_analisis: region ? `Región ${region}` : 'Todas las regiones',
+                procesos_analizados_exitosamente: prices.length,
+                estadisticas_precios: {
+                    minimo_historico: min,
+                    maximo_historico: max,
+                    promedio_historico: avg,
+                    mediana_historica: median,
+                },
+                sugerencia_de_precio_competitivo: recommended,
+                rango_sugerido: {
+                    min: Math.round(recommended * 0.95),
+                    max: Math.round(recommended * 1.05),
+                },
+                detalle_de_casos_historicos: processedItems,
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof CompraAgilApiError
+                ? error.actionableMessage
+                : `Error inesperado al recomendar precio: ${String(error)}`;
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=recomendar-precio.js.map

package/dist/tools/recomendar-precio.js.map

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

package/dist/tools/verificar-oc.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tool: verificar_orden_compra
+ *
+ * Verifica si una Compra Ágil ya tiene una Orden de Compra (OC) emitida.
+ * Resuelve la limitación documentada donde el estado "oc_emitida" no aparece
+ * en la práctica y el campo codigo_orden_compra retorna null incluso con OC emitida.
+ *
+ * Implementa la lógica del Ejemplo 8.6 de la documentación oficial.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { CompraAgilClient } from '../api/compra-agil-client.js';
+export declare function registerVerificarOC(server: McpServer, client: CompraAgilClient): void;
+//# sourceMappingURL=verificar-oc.d.ts.map

package/dist/tools/verificar-oc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verificar-oc.d.ts","sourceRoot":"","sources":["../../src/tools/verificar-oc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAgBhE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA+ErF"}

package/dist/tools/verificar-oc.js

@@ -0,0 +1,94 @@
+/**
+ * Tool: verificar_orden_compra
+ *
+ * Verifica si una Compra Ágil ya tiene una Orden de Compra (OC) emitida.
+ * Resuelve la limitación documentada donde el estado "oc_emitida" no aparece
+ * en la práctica y el campo codigo_orden_compra retorna null incluso con OC emitida.
+ *
+ * Implementa la lógica del Ejemplo 8.6 de la documentación oficial.
+ */
+import { z } from 'zod';
+import { CompraAgilApiError } from '../utils/error-handler.js';
+import { logger } from '../utils/logger.js';
+const TOOL_NAME = 'verificar_orden_compra';
+const TOOL_DESCRIPTION = `Verifica si una Compra Ágil específica ya tiene una Orden de Compra (OC) emitida.
+IMPORTANTE: El estado "oc_emitida" de la API NO funciona en la práctica. Esta herramienta resuelve esa limitación
+consultando el detalle del proceso y cruzando con la API de Órdenes de Compra de Mercado Público si existe un id_orden_compra.`;
+const inputSchema = {
+    codigo: z.string().describe('Código único de la Compra Ágil a verificar. Formato: XXXXXX-YYY-COTXX. Ej: "1057539-228-COT26".'),
+};
+export function registerVerificarOC(server, client) {
+    server.registerTool(TOOL_NAME, {
+        description: TOOL_DESCRIPTION,
+        inputSchema: inputSchema,
+    }, async (args) => {
+        try {
+            const detalle = await client.detalle(args.codigo);
+            const idOrdenCompra = detalle.id_orden_compra ?? detalle.orden_compra?.id_orden_compra ?? null;
+            const idOc = detalle.orden_compra?.id_oc ?? null;
+            const tieneOC = idOrdenCompra !== null && idOrdenCompra !== undefined;
+            let detalleOCInfo = null;
+            if (tieneOC) {
+                try {
+                    const ocResponse = await client.obtenerDetalleOC(idOrdenCompra);
+                    if (ocResponse.Listado && ocResponse.Listado.length > 0) {
+                        const oc = ocResponse.Listado[0];
+                        detalleOCInfo = {
+                            codigo_oc: oc.Codigo,
+                            nombre_oc: oc.Nombre,
+                            estado_oc: oc.Estado,
+                            codigo_estado_oc: oc.CodigoEstado,
+                            monto_total: oc.Total,
+                            fecha_creacion: oc.FechaCreacion,
+                            fecha_aceptacion: oc.FechaAceptacion,
+                        };
+                    }
+                }
+                catch (e) {
+                    logger.warn(`No se pudo obtener el detalle de la OC ${idOrdenCompra} desde la API: ${String(e)}`);
+                }
+            }
+            const result = {
+                codigo: detalle.codigo,
+                nombre: detalle.nombre,
+                estado_actual: detalle.estado.glosa,
+                convocatoria: detalle.convocatoria.descripcion,
+                verificacion_oc: {
+                    tiene_orden_compra: tieneOC,
+                    id_orden_compra: idOrdenCompra,
+                    id_oc: idOc,
+                    codigo_orden_compra: detalleOCInfo?.codigo_oc ?? detalle.orden_compra?.codigo_orden_compra ?? null,
+                    estado_orden_compra: detalleOCInfo?.estado_oc ?? detalle.orden_compra?.estado_orden_compra ?? null,
+                    detalle_orden: detalleOCInfo,
+                    nota: tieneOC
+                        ? `La OC fue emitida. Código: ${detalleOCInfo?.codigo_oc ?? 'Desconocido'}. Usa la herramienta obtener_detalle_orden_compra para profundizar.`
+                        : 'No se ha emitido una Orden de Compra para esta Compra Ágil aún.',
+                },
+                proveedor_seleccionado: detalle.proveedores_cotizando
+                    .filter((p) => p.proveedor_seleccionado === 1 || p.proveedor_seleccionado === true || p.seleccion?.proveedor_seleccionado === true || p.estado_por_comprador === '1')
+                    .map((p) => ({
+                    rut: p.rut_proveedor,
+                    razon_social: p.razon_social,
+                    monto_total: p.monto_total,
+                })),
+                presupuesto_clp: detalle.presupuesto.monto_disponible_clp,
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof CompraAgilApiError
+                ? error.actionableMessage
+                : `Error inesperado: ${String(error)}`;
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=verificar-oc.js.map

package/dist/tools/verificar-oc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verificar-oc.js","sourceRoot":"","sources":["../../src/tools/verificar-oc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,SAAS,GAAG,wBAAwB,CAAC;AAE3C,MAAM,gBAAgB,GAAG;;+HAEsG,CAAC;AAEhI,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACzB,iGAAiG,CAClG;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAwB;IAC7E,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE,WAAW;KACzB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAElD,MAAM,aAAa,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,eAAe,IAAI,IAAI,CAAC;YAC/F,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,IAAI,IAAI,CAAC;YACjD,MAAM,OAAO,GAAG,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,SAAS,CAAC;YAEtE,IAAI,aAAa,GAAG,IAAI,CAAC;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC;oBACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;oBAChE,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxD,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;wBACjC,aAAa,GAAG;4BACd,SAAS,EAAE,EAAE,CAAC,MAAM;4BACpB,SAAS,EAAE,EAAE,CAAC,MAAM;4BACpB,SAAS,EAAE,EAAE,CAAC,MAAM;4BACpB,gBAAgB,EAAE,EAAE,CAAC,YAAY;4BACjC,WAAW,EAAE,EAAE,CAAC,KAAK;4BACrB,cAAc,EAAE,EAAE,CAAC,aAAa;4BAChC,gBAAgB,EAAE,EAAE,CAAC,eAAe;yBACrC,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,CAAC,IAAI,CAAC,0CAA0C,aAAa,kBAAkB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpG,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG;gBACb,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;gBACnC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,WAAW;gBAC9C,eAAe,EAAE;oBACf,kBAAkB,EAAE,OAAO;oBAC3B,eAAe,EAAE,aAAa;oBAC9B,KAAK,EAAE,IAAI;oBACX,mBAAmB,EAAE,aAAa,EAAE,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,mBAAmB,IAAI,IAAI;oBAClG,mBAAmB,EAAE,aAAa,EAAE,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,mBAAmB,IAAI,IAAI;oBAClG,aAAa,EAAE,aAAa;oBAC5B,IAAI,EAAE,OAAO;wBACX,CAAC,CAAC,8BAA8B,aAAa,EAAE,SAAS,IAAI,aAAa,qEAAqE;wBAC9I,CAAC,CAAC,iEAAiE;iBACtE;gBACD,sBAAsB,EAAE,OAAO,CAAC,qBAAqB;qBAClD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB,KAAK,CAAC,IAAI,CAAC,CAAC,sBAAsB,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,EAAE,sBAAsB,KAAK,IAAI,IAAI,CAAC,CAAC,oBAAoB,KAAK,GAAG,CAAC;qBACpK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACX,GAAG,EAAE,CAAC,CAAC,aAAa;oBACpB,YAAY,EAAE,CAAC,CAAC,YAAY;oBAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;iBAC3B,CAAC,CAAC;gBACL,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,oBAAoB;aAC1D,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC,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,qBAAqB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/env-loader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Carga de forma manual las variables de entorno de un archivo `.env` local.
+ * Útil para entornos MCP que no soportan dotenv nativamente o se ejecutan sin variables externas predefinidas.
+ */
+export declare function loadEnvManual(): void;
+//# sourceMappingURL=env-loader.d.ts.map

package/dist/utils/env-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.d.ts","sourceRoot":"","sources":["../../src/utils/env-loader.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CA2BpC"}

package/dist/utils/env-loader.js

@@ -0,0 +1,35 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Carga de forma manual las variables de entorno de un archivo `.env` local.
+ * Útil para entornos MCP que no soportan dotenv nativamente o se ejecutan sin variables externas predefinidas.
+ */
+export function loadEnvManual() {
+    try {
+        const envPath = path.resolve(process.cwd(), '.env');
+        if (fs.existsSync(envPath)) {
+            const content = fs.readFileSync(envPath, 'utf8');
+            for (const line of content.split('\n')) {
+                const trimmed = line.trim();
+                // Ignorar líneas vacías y comentarios
+                if (trimmed && !trimmed.startsWith('#')) {
+                    const parts = trimmed.split('=');
+                    const key = parts[0]?.trim();
+                    const value = parts.slice(1).join('=').trim();
+                    if (key && value) {
+                        // Eliminar comillas dobles o simples que encierran el valor
+                        const cleanValue = value.replace(/^['"]|['"]$/g, '');
+                        // Solo asignar si no está definida previamente a nivel de sistema para respetar prioridades
+                        if (process.env[key] === undefined) {
+                            process.env[key] = cleanValue;
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch (e) {
+        console.error('Error al parsear el archivo .env de forma manual:', e);
+    }
+}
+//# sourceMappingURL=env-loader.js.map

package/dist/utils/env-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.js","sourceRoot":"","sources":["../../src/utils/env-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,sCAAsC;gBACtC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACjC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;oBAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC9C,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;wBACjB,4DAA4D;wBAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;wBAErD,4FAA4F;wBAC5F,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;4BACnC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;wBAChC,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,mDAAmD,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Traductor de errores HTTP de la API Compra Ágil a mensajes accionables para LLMs.
+ *
+ * Cada mensaje está redactado para que un agente de IA entienda
+ * exactamente qué salió mal y qué acción tomar.
+ */
+export interface ApiError {
+    codigo: string;
+    mensaje: string;
+    detalle: string | null;
+}
+export interface ApiErrorResponse {
+    success: 'NOK';
+    trace: string | null;
+    payload: null;
+    errors: ApiError[];
+}
+export declare class CompraAgilApiError extends Error {
+    readonly httpStatus: number;
+    readonly apiErrors: ApiError[];
+    readonly actionableMessage: string;
+    constructor(httpStatus: number, apiErrors?: ApiError[]);
+}
+/**
+ * Parsea la respuesta de error de la API y lanza una excepción tipada.
+ */
+export declare function handleApiResponse(response: Response): Promise<unknown>;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;gBAE9B,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,EAAO;CAQ3D;AAqCD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB5E"}

package/dist/utils/error-handler.js

@@ -0,0 +1,74 @@
+/**
+ * Traductor de errores HTTP de la API Compra Ágil a mensajes accionables para LLMs.
+ *
+ * Cada mensaje está redactado para que un agente de IA entienda
+ * exactamente qué salió mal y qué acción tomar.
+ */
+export class CompraAgilApiError extends Error {
+    httpStatus;
+    apiErrors;
+    actionableMessage;
+    constructor(httpStatus, apiErrors = []) {
+        const actionable = getActionableMessage(httpStatus, apiErrors);
+        super(actionable);
+        this.name = 'CompraAgilApiError';
+        this.httpStatus = httpStatus;
+        this.apiErrors = apiErrors;
+        this.actionableMessage = actionable;
+    }
+}
+function getActionableMessage(httpStatus, apiErrors) {
+    const detail = apiErrors.length > 0
+        ? ` Detalle de la API: "${apiErrors[0].mensaje}"`
+        : '';
+    switch (httpStatus) {
+        case 400:
+            return `Parámetros inválidos enviados a la API de Compra Ágil. Verifica el formato de fechas (ISO-8601), que 'q' e 'id' no se usen juntos, y que los códigos de región estén entre 1 y 16.${detail}`;
+        case 401:
+            return `Ticket de acceso no proporcionado. Configura la variable de entorno COMPRA_AGIL_TICKET con un ticket válido obtenido en https://www.chilecompra.cl/api/.${detail}`;
+        case 403:
+            return `Ticket de acceso inválido, inactivo o bloqueado. Verifica que el ticket sea correcto y esté vigente. Si fue bloqueado, solicita uno nuevo en https://www.chilecompra.cl/api/.${detail}`;
+        case 404:
+            return `No se encontró una Compra Ágil con el código proporcionado. Verifica que el código tenga el formato correcto (ej: 1057539-228-COT26) y que el proceso exista y sea público.${detail}`;
+        case 429:
+            return formatRateLimitMessage(detail);
+        case 500:
+            return `Error interno del servidor de Mercado Público (api2.mercadopublico.cl). Esto no es un problema de tu consulta. Reintenta en unos minutos.${detail}`;
+        case 503:
+            return `El servicio de Mercado Público está temporalmente no disponible (posible mantenimiento). Reintenta más tarde.${detail}`;
+        default:
+            return `Error inesperado HTTP ${httpStatus} de la API de Compra Ágil.${detail}`;
+    }
+}
+function formatRateLimitMessage(detail) {
+    const now = new Date();
+    const tomorrow = new Date(now);
+    tomorrow.setUTCDate(tomorrow.getUTCDate() + 1);
+    tomorrow.setUTCHours(0, 1, 0, 0);
+    const waitHours = Math.ceil((tomorrow.getTime() - now.getTime()) / (1000 * 60 * 60));
+    return `Cuota diaria de la API agotada. El límite se restablece al inicio del próximo día calendario UTC (en aproximadamente ${waitHours} horas). Para reducir el consumo: usa filtros más específicos (estado, región, fechas), evita consultas masivas, y usa 'ttl_cambio_ms' para sincronización incremental en vez de descargas completas. Si necesitas más cuota, contacta a ChileCompra.${detail}`;
+}
+/**
+ * Parsea la respuesta de error de la API y lanza una excepción tipada.
+ */
+export async function handleApiResponse(response) {
+    if (response.ok) {
+        const json = await response.json();
+        if (json.success === 'NOK') {
+            throw new CompraAgilApiError(response.status, json.errors);
+        }
+        return json.payload;
+    }
+    let apiErrors = [];
+    try {
+        const errorJson = await response.json();
+        if (errorJson.errors) {
+            apiErrors = errorJson.errors;
+        }
+    }
+    catch {
+        // Response body was not JSON, proceed with HTTP status only
+    }
+    throw new CompraAgilApiError(response.status, apiErrors);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Logger seguro para servidores MCP con transporte Stdio.
+ *
+ * REGLA CRÍTICA: En servidores MCP que usan Stdio, JAMÁS se debe escribir
+ * a stdout (console.log) ya que corrompe el stream JSON-RPC.
+ * Todo el logging va exclusivamente a stderr (console.error).
+ */
+export declare function setMcpServer(server: any): void;
+export declare const logger: {
+    debug: (msg: string, data?: unknown) => void;
+    info: (msg: string, data?: unknown) => void;
+    warn: (msg: string, data?: unknown) => void;
+    error: (msg: string, data?: unknown) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,wBAAgB,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAE9C;AAyBD,eAAO,MAAM,MAAM;iBACJ,MAAM,SAAS,OAAO;gBACvB,MAAM,SAAS,OAAO;gBACtB,MAAM,SAAS,OAAO;iBACrB,MAAM,SAAS,OAAO;CACpC,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,48 @@
+/**
+ * Logger seguro para servidores MCP con transporte Stdio.
+ *
+ * REGLA CRÍTICA: En servidores MCP que usan Stdio, JAMÁS se debe escribir
+ * a stdout (console.log) ya que corrompe el stream JSON-RPC.
+ * Todo el logging va exclusivamente a stderr (console.error).
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const currentLevel = process.env.LOG_LEVEL || 'info';
+function formatTimestamp() {
+    return new Date().toISOString();
+}
+let mcpServer = null;
+export function setMcpServer(server) {
+    mcpServer = server;
+}
+function log(level, message, data) {
+    if (LOG_LEVELS[level] < LOG_LEVELS[currentLevel])
+        return;
+    const prefix = `[${formatTimestamp()}] [${level.toUpperCase()}]`;
+    const line = data
+        ? `${prefix} ${message} ${JSON.stringify(data)}`
+        : `${prefix} ${message}`;
+    // SIEMPRE stderr, NUNCA stdout
+    console.error(line);
+    // Intentar enviar el log de forma nativa al cliente MCP si el servidor está configurado
+    if (mcpServer) {
+        mcpServer.sendLoggingMessage({
+            level,
+            logger: 'mcp-compra-agil',
+            data: data ? `${message} ${JSON.stringify(data)}` : message,
+        }).catch(() => {
+            // Ignorar fallos silenciosamente para no interrumpir el flujo principal
+        });
+    }
+}
+export const logger = {
+    debug: (msg, data) => log('debug', msg, data),
+    info: (msg, data) => log('info', msg, data),
+    warn: (msg, data) => log('warn', msg, data),
+    error: (msg, data) => log('error', msg, data),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,YAAY,GAAc,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAC;AAE7E,SAAS,eAAe;IACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,IAAI,SAAS,GAAQ,IAAI,CAAC;AAE1B,MAAM,UAAU,YAAY,CAAC,MAAW;IACtC,SAAS,GAAG,MAAM,CAAC;AACrB,CAAC;AAED,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;IAC3D,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO;IAEzD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,MAAM,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI;QACf,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QAChD,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAE3B,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEpB,wFAAwF;IACxF,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,kBAAkB,CAAC;YAC3B,KAAK;YACL,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO;SAC5D,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACZ,wEAAwE;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;IAC/D,IAAI,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;IAC7D,IAAI,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;IAC7D,KAAK,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;CAChE,CAAC"}

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Control inteligente de rate limiting para la API de Compra Ágil.
+ *
+ * La API usa cuota por día calendario (se resetea a medianoche UTC).
+ * Este módulo lleva un contador local de requests para advertir
+ * proactivamente antes de alcanzar el límite.
+ */
+export declare class RateLimiter {
+    private requestCount;
+    private currentDay;
+    private isLimited;
+    private limitResetTime;
+    constructor();
+    private getTodayUTC;
+    /**
+     * Registra un request exitoso. Resetea el contador si cambió el día.
+     */
+    recordRequest(): void;
+    /**
+     * Marca que se recibió un error 429.
+     */
+    markLimited(): void;
+    /**
+     * Verifica si estamos actualmente limitados.
+     */
+    checkLimit(): {
+        limited: boolean;
+        resetIn?: string;
+    };
+    /**
+     * Obtiene estadísticas del uso actual.
+     */
+    getStats(): {
+        requestsToday: number;
+        isLimited: boolean;
+        resetTime: string | null;
+    };
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAqB;;IAM3C,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,aAAa,IAAI,IAAI;IAarB;;OAEG;IACH,WAAW,IAAI,IAAI;IAUnB;;OAEG;IACH,UAAU,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAyBpD;;OAEG;IACH,QAAQ,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAOpF"}