@ssolis-ti/mcp-compra-agil 1.0.2 → 2.1.0

package/dist/tools/generar-informe.js

@@ -0,0 +1,111 @@
+/**
+ * Tool: generar_informe
+ *
+ * Genera informes profesionales (HTML imprimible) a partir de los datos del MCP.
+ *
+ * DISEÑO: el HTML nunca se devuelve al LLM — se escribe a disco y la tool
+ * retorna solo la ruta y un resumen breve. Un informe pesa decenas de KB y
+ * retornarlo consumiría miles de tokens de contexto por llamada.
+ */
+import { z } from 'zod';
+import { CompraAgilApiError } from '../utils/error-handler.js';
+import { logger } from '../utils/logger.js';
+import { recolectarDatosRadar } from './radar-oportunidades.js';
+import { renderRadarInforme } from '../reports/templates/radar-oportunidades.js';
+import { escribirInforme, slug, stamp, defaultOutputDir } from '../reports/export.js';
+import { clp } from '../reports/format.js';
+import { PAPEL, FORMATO_POR_DEFECTO } from '../reports/theme.js';
+import { safeError } from '../utils/redact.js';
+const TOOL_NAME = 'generar_informe';
+const TOOL_DESCRIPTION = `Genera un informe profesional imprimible (HTML con diseño de impresión) a partir de los datos de Compra Ágil.
+El archivo se guarda en disco y la herramienta devuelve la RUTA del archivo (no su contenido, para no saturar el contexto).
+El usuario puede abrirlo en su navegador y exportarlo a PDF con Ctrl+P (el diseño está optimizado para impresión: saltos de página controlados y cabeceras de tabla repetidas).
+Formatos de papel: "carta" (216×279mm, estándar de oficina en Chile, por defecto), "oficio" (216×330mm, folio chileno para documentos oficiales) y "a4" (210×297mm, estándar ISO).
+Tipos disponibles:
+- "radar": Radar de oportunidades activas priorizadas por facilidad de adjudicación (KPIs, gráfico de puntuación, fichas destacadas y listado completo).`;
+const inputSchema = {
+    tipo: z.enum(['radar']).describe('Tipo de informe a generar. Actualmente disponible: "radar".'),
+    formato_papel: z.enum(['carta', 'oficio', 'a4']).default('carta').optional().describe('Tamaño de papel: "carta" (216×279mm, el más usado en oficinas chilenas, por defecto), "oficio" (216×330mm, folio chileno para documentos oficiales/legales) o "a4" (210×297mm, estándar ISO).'),
+    region: z.string().optional().describe('Código de región para acotar (1-16). Ej: "13" para Metropolitana.'),
+    q: z.string().optional().describe('Término de búsqueda para acotar a un rubro o producto (ej: "licencias").'),
+    presupuesto_minimo: z.number().optional().describe('Filtrar procesos con presupuesto disponible mayor o igual a este monto en CLP.'),
+    limite_resultados: z.number().min(1).max(50).default(20).optional().describe('Cantidad máxima de oportunidades a incluir en el informe (1-50, default 20).'),
+    max_paginas: z.number().min(1).max(10).default(3).optional().describe('Páginas de 50 resultados a escanear (1-10, default 3).'),
+    ruta_salida: z.string().optional().describe('Directorio donde guardar el informe. Si se omite, se usa la carpeta "informes/" del directorio de trabajo.'),
+};
+export function registerGenerarInforme(server, client) {
+    server.registerTool(TOOL_NAME, {
+        description: TOOL_DESCRIPTION,
+        inputSchema: inputSchema,
+    }, async (args) => {
+        try {
+            if (args.tipo !== 'radar') {
+                return {
+                    content: [{ type: 'text', text: `Tipo de informe no soportado: "${args.tipo}".` }],
+                    isError: true,
+                };
+            }
+            logger.info(`generar_informe: construyendo informe "${args.tipo}"`);
+            const generadoEn = new Date();
+            // 1. Recolectar datos con la MISMA función que usa la tool JSON del radar
+            const datos = await recolectarDatosRadar(client, {
+                region: args.region,
+                q: args.q,
+                presupuesto_minimo: args.presupuesto_minimo,
+                limite_resultados: args.limite_resultados ?? 20,
+                max_paginas: args.max_paginas,
+            }, generadoEn.getTime());
+            // 2. Renderizar el HTML en el formato de papel solicitado
+            const formato = args.formato_papel ?? FORMATO_POR_DEFECTO;
+            const html = renderRadarInforme({
+                oportunidades: datos.oportunidades,
+                totalAnalizadas: datos.totalAnalizadas,
+                filtros: {
+                    region: args.region,
+                    q: args.q,
+                    presupuestoMinimo: args.presupuesto_minimo,
+                    paginasEscaneadas: datos.paginasEscaneadas,
+                },
+                generadoEn,
+                formato,
+            });
+            // 3. Escribir a disco y devolver SOLO la ruta + resumen
+            const ambito = args.region ? `region-${args.region}` : 'nacional';
+            const rubro = args.q ? `-${slug(args.q)}` : '';
+            const nombre = `radar-${ambito}${rubro}-${formato}-${stamp(generadoEn)}.html`;
+            const { ruta, bytes } = escribirInforme(html, nombre, args.ruta_salida);
+            const ops = datos.oportunidades;
+            const sinOferentes = ops.filter((o) => o.ofertas_recibidas === 0).length;
+            const montoTotal = ops.reduce((acc, o) => acc + (o.presupuesto_disponible || 0), 0);
+            const mejor = ops[0];
+            const resumen = [
+                `✅ Informe generado: ${ruta}`,
+                `   (${(bytes / 1024).toFixed(1)} KB · formato ${PAPEL[formato].glosa})`,
+                `   Ábrelo en el navegador y usa Ctrl+P para exportar a PDF.`,
+                `   ⚠ En el diálogo de impresión selecciona el papel "${formato === 'carta' ? 'Carta / Letter' : formato === 'oficio' ? 'Oficio / Folio (216×330mm)' : 'A4'}" para que calce exactamente.`,
+                ``,
+                `Resumen del contenido:`,
+                `• ${ops.length} oportunidades incluidas (de ${datos.totalAnalizadas} vigentes analizadas)`,
+                `• ${sinOferentes} sin oferentes (competencia cero)`,
+                `• ${ops.filter((o) => o.horas_restantes <= 24).length} cierran en menos de 24 horas`,
+                `• Monto total en juego: ${clp(montoTotal)}`,
+                mejor ? `• Mejor oportunidad: ${mejor.nombre} (${mejor.codigo}) — ${mejor.puntuacion_caliente} pts` : '',
+                ``,
+                `Carpeta de informes: ${args.ruta_salida ? args.ruta_salida : defaultOutputDir()}`,
+            ].filter(Boolean).join('\n');
+            return {
+                content: [{ type: 'text', text: resumen }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof CompraAgilApiError
+                ? error.actionableMessage
+                : `Error inesperado al generar el informe: ${safeError(error)}`;
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=generar-informe.js.map

package/dist/tools/generar-informe.js.map

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

package/dist/tools/monitorear-cambios.d.ts

@@ -1,10 +1,40 @@
 /**
  * Tool: monitorear_cambios_recientes
  *
- * Detecta procesos de Compra Ágil que hayan sido creados o modificados
- * recientemente. Ideal para alertas y monitoreo de oportunidades.
+ * Detecta procesos de Compra Ágil creados o modificados dentro de una ventana
+ * de cambios: relativa (últimos N minutos) o absoluta (rango de fechas
+ * arbitrario). Ideal para alertas, monitoreo de oportunidades y sincronización
+ * incremental de un período pasado.
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { CompraAgilClient } from '../api/compra-agil-client.js';
+/** Ventana de cambios ya resuelta y lista para enviar a la API. */
+export interface VentanaCambios {
+    /** Parámetros de la API que definen la ventana (uno u otro grupo, nunca ambos). */
+    params: {
+        ttl_cambio_ms?: number;
+        cambio_desde?: string;
+        cambio_hasta?: string;
+    };
+    /** Glosa legible para el reporte de salida. */
+    descripcion: string;
+}
+/**
+ * Resuelve la ventana de cambios a partir de los argumentos de la herramienta.
+ *
+ * La API expone dos formas mutuamente excluyentes de acotar los cambios
+ * (Guía API Compra Ágil v2 §5.1, Grupo 1): `ttl_cambio_ms` (opción A) o el par
+ * `cambio_desde`/`cambio_hasta` (opción B). Enviar ambas a la vez es un 400,
+ * así que se decide aquí y se falla localmente para no gastar cuota.
+ *
+ * Retorna un string con el error de validación, o la ventana resuelta.
+ */
+export declare function resolverVentanaCambios(args: {
+    minutos?: number;
+    cambio_desde?: string;
+    cambio_hasta?: string;
+}): VentanaCambios | {
+    error: string;
+};
 export declare function registerMonitorearCambios(server: McpServer, client: CompraAgilClient): void;
 //# sourceMappingURL=monitorear-cambios.d.ts.map

package/dist/tools/monitorear-cambios.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"monitorear-cambios.d.ts","sourceRoot":"","sources":["../../src/tools/monitorear-cambios.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AA4BhE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAqD3F"}
+{"version":3,"file":"monitorear-cambios.d.ts","sourceRoot":"","sources":["../../src/tools/monitorear-cambios.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAyChE,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,MAAM,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA+CrC;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA4D3F"}

package/dist/tools/monitorear-cambios.js

@@ -1,31 +1,100 @@
 /**
  * Tool: monitorear_cambios_recientes
  *
- * Detecta procesos de Compra Ágil que hayan sido creados o modificados
- * recientemente. Ideal para alertas y monitoreo de oportunidades.
+ * Detecta procesos de Compra Ágil creados o modificados dentro de una ventana
+ * de cambios: relativa (últimos N minutos) o absoluta (rango de fechas
+ * arbitrario). Ideal para alertas, monitoreo de oportunidades y sincronización
+ * incremental de un período pasado.
  */
 import { z } from 'zod';
 import { CompraAgilApiError } from '../utils/error-handler.js';
+import { safeError } from '../utils/redact.js';
 const TOOL_NAME = 'monitorear_cambios_recientes';
-const TOOL_DESCRIPTION = `Busca Compras Ágiles que hayan sido creadas o modificadas en los últimos N minutos.
-Ideal para monitoreo de nuevas oportunidades de negocio y alertas en tiempo real.
-Internamente convierte los minutos a milisegundos para el parámetro ttl_cambio_ms de la API.
+const TOOL_DESCRIPTION = `Busca Compras Ágiles que hayan sido creadas o modificadas dentro de una ventana de cambios.
+Ideal para monitoreo de nuevas oportunidades de negocio, alertas en tiempo real y sincronización incremental.
+La ventana se define de UNA de dos formas, mutuamente excluyentes:
+  • Relativa: 'minutos' (últimos N minutos, máx 1440 = 24h). Es el modo por defecto (60 min).
+  • Absoluta: 'cambio_desde' + 'cambio_hasta' (rango ISO-8601 arbitrario), para resincronizar un período pasado
+    o retomar desde el último timestamp procesado, sin el techo de 24 horas.
 Puede combinarse con filtros de estado y región para acotar los resultados.`;
+/** Acepta ISO-8601 con 'Z' o con offset (±HH:MM). Los segundos son opcionales. */
+const ISO_8601 = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
 const inputSchema = {
-    minutos: z.number().min(1).max(1440).default(60).describe('Buscar cambios en los últimos N minutos. Ej: 60 = última hora, 1440 = últimas 24 horas. Máximo 1440 (24h).'),
+    minutos: z.number().min(1).max(1440).optional().describe('Ventana RELATIVA: buscar cambios en los últimos N minutos. Ej: 60 = última hora, 1440 = últimas 24 horas. Máximo 1440 (24h). Se usa 60 por defecto si no se indica ni "minutos" ni un rango. No combinar con "cambio_desde"/"cambio_hasta".'),
+    cambio_desde: z.string().optional().describe('Ventana ABSOLUTA: fecha/hora ISO-8601 de inicio del rango de cambios. Ej: "2026-09-01T00:00:00Z". Úsala para sincronización incremental de un período arbitrario (sin el límite de 24h de "minutos"). No combinar con "minutos".'),
+    cambio_hasta: z.string().optional().describe('Ventana ABSOLUTA: fecha/hora ISO-8601 de fin del rango de cambios. Ej: "2026-09-02T00:00:00Z". Requiere "cambio_desde". No combinar con "minutos".'),
     estado: z.string().optional().describe('Filtrar por estado(s), separados por coma. Ej: "publicada" para solo oportunidades abiertas.'),
     region: z.string().optional().describe('Código(s) de región, separados por coma. Ej: "13" para Metropolitana.'),
     tamano_pagina: z.number().min(10).max(50).default(50).describe('Resultados por página (10-50, default 50).'),
     numero_pagina: z.number().min(1).optional().describe('Número de página a consultar (comienza en 1).'),
 };
+/**
+ * Resuelve la ventana de cambios a partir de los argumentos de la herramienta.
+ *
+ * La API expone dos formas mutuamente excluyentes de acotar los cambios
+ * (Guía API Compra Ágil v2 §5.1, Grupo 1): `ttl_cambio_ms` (opción A) o el par
+ * `cambio_desde`/`cambio_hasta` (opción B). Enviar ambas a la vez es un 400,
+ * así que se decide aquí y se falla localmente para no gastar cuota.
+ *
+ * Retorna un string con el error de validación, o la ventana resuelta.
+ */
+export function resolverVentanaCambios(args) {
+    const usaRango = Boolean(args.cambio_desde || args.cambio_hasta);
+    if (usaRango && args.minutos !== undefined) {
+        return {
+            error: 'Error de validación: "minutos" (ventana relativa) y "cambio_desde"/"cambio_hasta" (ventana absoluta) son mutuamente excluyentes. Usa solo uno de los dos modos.',
+        };
+    }
+    if (usaRango) {
+        if (!args.cambio_desde) {
+            return {
+                error: 'Error de validación: "cambio_hasta" requiere también "cambio_desde" para delimitar el rango.',
+            };
+        }
+        for (const [nombre, valor] of [
+            ['cambio_desde', args.cambio_desde],
+            ['cambio_hasta', args.cambio_hasta],
+        ]) {
+            if (valor && !ISO_8601.test(valor)) {
+                return {
+                    error: `Error de validación: "${nombre}" debe estar en formato ISO-8601 con zona horaria. Ej: "2026-09-01T00:00:00Z". Recibido: "${valor}".`,
+                };
+            }
+        }
+        if (args.cambio_hasta && args.cambio_desde > args.cambio_hasta) {
+            return {
+                error: `Error de validación: "cambio_desde" (${args.cambio_desde}) es posterior a "cambio_hasta" (${args.cambio_hasta}). El rango quedaría vacío.`,
+            };
+        }
+        return {
+            params: { cambio_desde: args.cambio_desde, cambio_hasta: args.cambio_hasta },
+            descripcion: args.cambio_hasta
+                ? `Cambios entre ${args.cambio_desde} y ${args.cambio_hasta}`
+                : `Cambios desde ${args.cambio_desde}`,
+        };
+    }
+    // Modo relativo (por defecto): 60 minutos si no se indicó nada.
+    const minutos = args.minutos ?? 60;
+    return {
+        params: { ttl_cambio_ms: minutos * 60 * 1000 },
+        descripcion: `Últimos ${minutos} minutos`,
+    };
+}
 export function registerMonitorearCambios(server, client) {
     server.registerTool(TOOL_NAME, {
         description: TOOL_DESCRIPTION,
         inputSchema: inputSchema,
     }, async (args) => {
         try {
-            const ttlMs = args.minutos * 60 * 1000;
-            const response = await client.cambiosRecientes(ttlMs, {
+            const ventana = resolverVentanaCambios(args);
+            if ('error' in ventana) {
+                return {
+                    content: [{ type: 'text', text: ventana.error }],
+                    isError: true,
+                };
+            }
+            const response = await client.buscar({
+                ...ventana.params,
                 estado: args.estado,
                 region: args.region,
                 tamano_pagina: args.tamano_pagina,
@@ -42,7 +111,7 @@ export function registerMonitorearCambios(server, client) {
                 ultimo_cambio: item.fechas.fecha_ultimo_cambio,
             }));
             const result = {
-                ventana_temporal: `Últimos ${args.minutos} minutos`,
+                ventana_temporal: ventana.descripcion,
                 total_resultados: response.paginacion.total_resultados,
                 pagina: `${response.paginacion.numero_pagina} de ${response.paginacion.total_paginas}`,
                 resultados: summary,
@@ -57,7 +126,7 @@ export function registerMonitorearCambios(server, client) {
         catch (error) {
             const message = error instanceof CompraAgilApiError
                 ? error.actionableMessage
-                : `Error inesperado: ${String(error)}`;
+                : `Error inesperado: ${safeError(error)}`;
             return {
                 content: [{ type: 'text', text: message }],
                 isError: true,

package/dist/tools/monitorear-cambios.js.map

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

package/dist/tools/radar-oportunidades.d.ts

@@ -1,4 +1,45 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { CompraAgilClient } from '../api/compra-agil-client.js';
+import { CompraAgilClient, CompraAgilItem } from '../api/compra-agil-client.js';
+export interface OportunidadRadar {
+    codigo: string;
+    nombre: string;
+    organismo: string;
+    region: string;
+    presupuesto_disponible: number;
+    ofertas_recibidas: number;
+    horas_restantes: number;
+    fecha_cierre: string;
+    puntuacion_caliente: number;
+    factores_calificacion: string[];
+}
+/**
+ * Calcula el "Hot Score" de una oportunidad de forma pura (sin efectos secundarios).
+ * Retorna null si el proceso debe omitirse (ya cerrado o bajo el presupuesto mínimo).
+ * Ponderación: baja competencia (máx 50) + urgencia (máx 30) + presupuesto (máx 20) + facilidad (máx 5).
+ */
+export declare function evaluarOportunidad(item: CompraAgilItem, now: number, minBudget?: number): OportunidadRadar | null;
+export interface RadarParams {
+    region?: string;
+    q?: string;
+    presupuesto_minimo?: number;
+    limite_resultados?: number;
+    max_paginas?: number;
+}
+export interface RadarDatos {
+    /** Oportunidades vigentes ya rankeadas y recortadas al límite pedido. */
+    oportunidades: OportunidadRadar[];
+    /** Total de oportunidades vigentes encontradas antes de aplicar el límite. */
+    totalAnalizadas: number;
+    limite: number;
+    paginasEscaneadas: number;
+}
+/**
+ * Recolecta y rankea las oportunidades del radar.
+ *
+ * Función pura de datos (sin formato de salida): la comparten la tool
+ * `radar_oportunidades_calientes` (que emite JSON para el LLM) y el informe
+ * HTML/PDF, garantizando que ambos muestren exactamente lo mismo.
+ */
+export declare function recolectarDatosRadar(client: CompraAgilClient, params: RadarParams, now?: number): Promise<RadarDatos>;
 export declare function registerRadarOportunidades(server: McpServer, client: CompraAgilClient): void;
 //# sourceMappingURL=radar-oportunidades.d.ts.map

package/dist/tools/radar-oportunidades.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radar-oportunidades.d.ts","sourceRoot":"","sources":["../../src/tools/radar-oportunidades.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AA6BhE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAoJ5F"}
+{"version":3,"file":"radar-oportunidades.d.ts","sourceRoot":"","sources":["../../src/tools/radar-oportunidades.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAkBhF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EACX,SAAS,SAAI,GACZ,gBAAgB,GAAG,IAAI,CAyEzB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,WAAW,EACnB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,UAAU,CAAC,CA6BrB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA4C5F"}

package/dist/tools/radar-oportunidades.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { CompraAgilApiError } from '../utils/error-handler.js';
 import { logger } from '../utils/logger.js';
+import { safeError } from '../utils/redact.js';
 const TOOL_NAME = 'radar_oportunidades_calientes';
 const TOOL_DESCRIPTION = `Escanea, califica y clasifica de forma priorizada los procesos de Compra Ágil activos (publicados).
 Utiliza una fórmula ponderada (Hot Score) basada en la falta de oferentes, el presupuesto disponible y las horas restantes de cierre para destacar los llamados más convenientes y fáciles de ganar.`;
@@ -9,23 +10,131 @@ const inputSchema = {
     q: z.string().optional().describe('Término de búsqueda opcional para acotar a un rubro o producto específico (ej: "licencias").'),
     presupuesto_minimo: z.number().optional().describe('Filtrar solo procesos con presupuesto disponible mayor o igual a este monto en CLP.'),
     limite_resultados: z.number().min(1).max(20).default(10).optional().describe('Cantidad máxima de oportunidades destacadas a retornar (1-20, default 10).'),
+    max_paginas: z.number().min(1).max(10).default(3).optional().describe('Cuántas páginas de 50 resultados escanear antes de rankear (1-10, default 3 = hasta 150 procesos). Más páginas = más cobertura pero más consumo de cuota.'),
 };
+/**
+ * Calcula el "Hot Score" de una oportunidad de forma pura (sin efectos secundarios).
+ * Retorna null si el proceso debe omitirse (ya cerrado o bajo el presupuesto mínimo).
+ * Ponderación: baja competencia (máx 50) + urgencia (máx 30) + presupuesto (máx 20) + facilidad (máx 5).
+ */
+export function evaluarOportunidad(item, now, minBudget = 0) {
+    const budget = item.montos?.monto_disponible_clp || item.montos?.monto_disponible || 0;
+    if (budget < minBudget)
+        return null;
+    let hoursLeft = 0;
+    if (item.fechas?.fecha_cierre) {
+        const cierreTime = new Date(item.fechas.fecha_cierre).getTime();
+        hoursLeft = (cierreTime - now) / (1000 * 60 * 60);
+    }
+    if (hoursLeft <= 0)
+        return null;
+    let score = 0;
+    const factors = [];
+    // Factor 1: Baja Competencia — Máx 50 pts
+    const bids = item.resumen?.total_ofertas_recibidas ?? 0;
+    if (bids === 0) {
+        score += 50;
+        factors.push('Sin oferentes activos (+50 pts)');
+    }
+    else if (bids === 1) {
+        score += 30;
+        factors.push('Baja competencia: solo 1 oferente (+30 pts)');
+    }
+    else if (bids === 2) {
+        score += 15;
+        factors.push('Competencia moderada: 2 oferentes (+15 pts)');
+    }
+    // Factor 2: Urgencia del Cierre — Máx 30 pts
+    if (hoursLeft <= 4) {
+        score += 30;
+        factors.push('Urgencia crítica: cierra en menos de 4 horas (+30 pts)');
+    }
+    else if (hoursLeft <= 12) {
+        score += 20;
+        factors.push('Cierre inminente: cierra en menos de 12 horas (+20 pts)');
+    }
+    else if (hoursLeft <= 24) {
+        score += 10;
+        factors.push('Cierre cercano: cierra en menos de 24 horas (+10 pts)');
+    }
+    // Factor 3: Tamaño de Presupuesto — Máx 20 pts
+    if (budget >= 5000000) {
+        score += 20;
+        factors.push('Presupuesto de alto valor (>= $5.000.000 CLP) (+20 pts)');
+    }
+    else if (budget >= 2000000) {
+        score += 15;
+        factors.push('Presupuesto medio-alto (>= $2.000.000 CLP) (+15 pts)');
+    }
+    else if (budget >= 500000) {
+        score += 10;
+        factors.push('Presupuesto medio (>= $500.000 CLP) (+10 pts)');
+    }
+    else {
+        score += 5;
+        factors.push('Presupuesto bajo (< $500.000 CLP) (+5 pts)');
+    }
+    // Factor 4: Facilidad de Postulación — Máx 5 pts
+    const docsCount = item.documentos?.length || 0;
+    if (docsCount === 0) {
+        score += 5;
+        factors.push('Sin documentos adjuntos (postulación rápida sin leer bases) (+5 pts)');
+    }
+    return {
+        codigo: item.codigo,
+        nombre: item.nombre,
+        organismo: item.institucion?.organismo_comprador || 'No especificado',
+        region: item.institucion?.nombre_region || 'No especificada',
+        presupuesto_disponible: budget,
+        ofertas_recibidas: bids,
+        horas_restantes: Math.round(hoursLeft * 10) / 10,
+        fecha_cierre: item.fechas?.fecha_cierre,
+        puntuacion_caliente: score,
+        factores_calificacion: factors,
+    };
+}
+/**
+ * Recolecta y rankea las oportunidades del radar.
+ *
+ * Función pura de datos (sin formato de salida): la comparten la tool
+ * `radar_oportunidades_calientes` (que emite JSON para el LLM) y el informe
+ * HTML/PDF, garantizando que ambos muestren exactamente lo mismo.
+ */
+export async function recolectarDatosRadar(client, params, now = Date.now()) {
+    const maxPaginas = params.max_paginas || 3;
+    logger.info(`radar: escaneando procesos activos (hasta ${maxPaginas} pág.) region="${params.region || 'Todas'}" q="${params.q || 'Todos'}"`);
+    // Auto-paginación: escanear varias páginas para no perder oportunidades en páginas 2+
+    const items = await client.buscarTodo({
+        estado: 'publicada',
+        region: params.region || undefined,
+        q: params.q || undefined,
+        tamano_pagina: 50,
+    }, maxPaginas);
+    const minBudget = params.presupuesto_minimo || 0;
+    const opportunities = [];
+    for (const item of items) {
+        const evaluada = evaluarOportunidad(item, now, minBudget);
+        if (evaluada)
+            opportunities.push(evaluada);
+    }
+    // Ordenar descendentemente por puntuación caliente
+    opportunities.sort((a, b) => b.puntuacion_caliente - a.puntuacion_caliente);
+    const limite = params.limite_resultados || 10;
+    return {
+        oportunidades: opportunities.slice(0, limite),
+        totalAnalizadas: opportunities.length,
+        limite,
+        paginasEscaneadas: maxPaginas,
+    };
+}
 export function registerRadarOportunidades(server, client) {
     server.registerTool(TOOL_NAME, {
         description: TOOL_DESCRIPTION,
         inputSchema: inputSchema,
     }, async (args) => {
         try {
-            const queryParams = {
-                estado: 'publicada',
-                region: args.region || undefined,
-                q: args.q || undefined,
-                tamano_pagina: 50, // Obtener un lote amplio de 50 para poder rankear
-                numero_pagina: 1,
-            };
-            logger.info(`radar_oportunidades_calientes: Escaneando procesos activos para region="${args.region || 'Todas'}" q="${args.q || 'Todos'}"`);
-            const searchResponse = await client.buscar(queryParams);
-            if (!searchResponse.items || searchResponse.items.length === 0) {
+            const datos = await recolectarDatosRadar(client, args);
+            if (datos.totalAnalizadas === 0) {
                 return {
                     content: [{
                             type: 'text',
@@ -33,99 +142,10 @@ export function registerRadarOportunidades(server, client) {
                         }],
                 };
             }
-            const now = Date.now();
-            const opportunities = [];
-            const minBudget = args.presupuesto_minimo || 0;
-            for (const item of searchResponse.items) {
-                const budget = item.montos?.monto_disponible_clp || item.montos?.monto_disponible || 0;
-                // Filtrar por presupuesto mínimo si corresponde
-                if (budget < minBudget) {
-                    continue;
-                }
-                // Calcular tiempo restante en horas
-                let hoursLeft = 0;
-                if (item.fechas?.fecha_cierre) {
-                    const cierreTime = new Date(item.fechas.fecha_cierre).getTime();
-                    hoursLeft = (cierreTime - now) / (1000 * 60 * 60);
-                }
-                // Omitir procesos que ya cerraron o están en negativo por zona horaria
-                if (hoursLeft <= 0) {
-                    continue;
-                }
-                let score = 0;
-                const factors = [];
-                // Factor 1: Baja Competencia (total_ofertas_recibidas) - Máx 50 pts
-                const bids = item.resumen?.total_ofertas_recibidas ?? 0;
-                if (bids === 0) {
-                    score += 50;
-                    factors.push('Sin oferentes activos (+50 pts)');
-                }
-                else if (bids === 1) {
-                    score += 30;
-                    factors.push('Baja competencia: solo 1 oferente (+30 pts)');
-                }
-                else if (bids === 2) {
-                    score += 15;
-                    factors.push('Competencia moderada: 2 oferentes (+15 pts)');
-                }
-                // Factor 2: Urgencia del Cierre (horas restantes) - Máx 30 pts
-                if (hoursLeft <= 4) {
-                    score += 30;
-                    factors.push('Urgencia crítica: cierra en menos de 4 horas (+30 pts)');
-                }
-                else if (hoursLeft <= 12) {
-                    score += 20;
-                    factors.push('Cierre inminente: cierra en menos de 12 horas (+20 pts)');
-                }
-                else if (hoursLeft <= 24) {
-                    score += 10;
-                    factors.push('Cierre cercano: cierra en menos de 24 horas (+10 pts)');
-                }
-                // Factor 3: Tamaño de Presupuesto - Máx 20 pts
-                if (budget >= 5000000) {
-                    score += 20;
-                    factors.push('Presupuesto de alto valor (>= $5.000.000 CLP) (+20 pts)');
-                }
-                else if (budget >= 2000000) {
-                    score += 15;
-                    factors.push('Presupuesto medio-alto (>= $2.000.000 CLP) (+15 pts)');
-                }
-                else if (budget >= 500000) {
-                    score += 10;
-                    factors.push('Presupuesto medio (>= $500.000 CLP) (+10 pts)');
-                }
-                else {
-                    score += 5;
-                    factors.push('Presupuesto bajo (< $500.000 CLP) (+5 pts)');
-                }
-                // Factor 4: Facilidad de Postulación - Máx 5 pts
-                const docsCount = item.documentos?.length || 0;
-                if (docsCount === 0) {
-                    score += 5;
-                    factors.push('Sin documentos adjuntos (postulación rápida sin leer bases) (+5 pts)');
-                }
-                opportunities.push({
-                    codigo: item.codigo,
-                    nombre: item.nombre,
-                    organismo: item.institucion?.organismo_comprador || 'No especificado',
-                    region: item.institucion?.nombre_region || 'No especificada',
-                    presupuesto_disponible: budget,
-                    ofertas_recibidas: bids,
-                    horas_restantes: Math.round(hoursLeft * 10) / 10,
-                    fecha_cierre: item.fechas?.fecha_cierre,
-                    puntuacion_caliente: score,
-                    factores_calificacion: factors,
-                });
-            }
-            // Ordenar descendentemente por puntuación caliente
-            opportunities.sort((a, b) => b.puntuacion_caliente - a.puntuacion_caliente);
-            // Aplicar límite
-            const limit = args.limite_resultados || 10;
-            const rankedOpportunities = opportunities.slice(0, limit);
             const result = {
-                total_oportunidades_analizadas: opportunities.length,
-                radar_limite_resultados: limit,
-                oportunidades_calientes: rankedOpportunities,
+                total_oportunidades_analizadas: datos.totalAnalizadas,
+                radar_limite_resultados: datos.limite,
+                oportunidades_calientes: datos.oportunidades,
             };
             return {
                 content: [{
@@ -137,7 +157,7 @@ export function registerRadarOportunidades(server, client) {
         catch (error) {
             const message = error instanceof CompraAgilApiError
                 ? error.actionableMessage
-                : `Error inesperado en radar de oportunidades: ${String(error)}`;
+                : `Error inesperado en radar de oportunidades: ${safeError(error)}`;
             return {
                 content: [{ type: 'text', text: message }],
                 isError: true,