@ssolis-ti/mcp-compra-agil 2.3.0 → 2.5.0

package/dist/utils/concurrencia.js

@@ -0,0 +1,122 @@
+/**
+ * Límite de concurrencia adaptativo para las consultas a la API.
+ *
+ * ⚠ POR QUÉ EXISTE: las herramientas de análisis piden varios detalles a la vez
+ *   —en serie tardaban más de 105 s y ningún cliente MCP espera tanto—, pero un
+ *   paralelismo fijo es igual de ingenuo en el otro sentido. Medido en
+ *   producción el 8 de septiembre de 2026, el endpoint de detalle tardaba 20-25 s
+ *   y devolvía HTTP 504 en 1 de cada 3 consultas: cuando el servicio está así,
+ *   insistir con la misma tanda solo produce más 504 y gasta cuota en llamadas
+ *   condenadas.
+ *
+ *   La política es la de control de congestión de TCP (AIMD): ante una señal de
+ *   saturación se baja a la mitad de inmediato, y se sube de a uno solo cuando
+ *   una tanda completa sale limpia. Bajar rápido y subir despacio es lo correcto
+ *   aquí porque el costo de los errores es asimétrico — un 504 desperdicia 30
+ *   segundos de espera, mientras que ir un poco lento solo cuesta unos segundos.
+ *
+ *   Lo que NO cuenta como congestión: 400, 404 y demás errores por consulta.
+ *   Esos hablan del ítem pedido, no del estado del servicio, y reaccionar a
+ *   ellos bajaría el paralelismo por motivos equivocados. El 429 tampoco: de la
+ *   cuota se encarga el RateLimiter, que sabe esperar el `Retry-After`.
+ */
+import { logger } from './logger.js';
+/** Códigos que indican que la pasarela no dio abasto, no que la consulta fuera inválida. */
+const CODIGOS_DE_CONGESTION = new Set([502, 503, 504]);
+/** ¿El fallo habla del servicio saturado o del ítem que se pidió? */
+export function esSenalDeCongestion(error) {
+    const e = error;
+    if (!e)
+        return false;
+    if (typeof e.httpStatus === 'number' && CODIGOS_DE_CONGESTION.has(e.httpStatus))
+        return true;
+    // Los cortes de red y timeouts cuentan igual: el servicio no alcanzó a responder.
+    return /timeout|ETIMEDOUT|ECONNRESET|socket hang up|fetch failed/i.test(String(e.message ?? ''));
+}
+export class LimitadorConcurrencia {
+    limite;
+    minimo;
+    maximo;
+    tandas = 0;
+    congestiones = 0;
+    constructor(opciones = {}) {
+        this.maximo = Math.max(1, opciones.maximo ?? 5);
+        this.minimo = Math.max(1, Math.min(opciones.minimo ?? 1, this.maximo));
+        this.limite = Math.min(this.maximo, Math.max(this.minimo, opciones.inicial ?? this.maximo));
+    }
+    get limiteActual() {
+        return this.limite;
+    }
+    estadisticas() {
+        return {
+            limiteActual: this.limite,
+            minimo: this.minimo,
+            maximo: this.maximo,
+            tandas: this.tandas,
+            congestiones: this.congestiones,
+        };
+    }
+    /** Disminución multiplicativa: a la mitad, en cuanto aparece la primera señal. */
+    reducir() {
+        const antes = this.limite;
+        this.limite = Math.max(this.minimo, Math.floor(this.limite / 2));
+        this.congestiones++;
+        if (this.limite !== antes) {
+            logger.warn(`Concurrencia: señal de saturación, se baja de ${antes} a ${this.limite} consultas simultáneas.`);
+        }
+    }
+    /** Aumento aditivo: de a uno, y solo tras una tanda entera sin congestión. */
+    aumentar() {
+        if (this.limite >= this.maximo)
+            return;
+        this.limite++;
+        logger.debug(`Concurrencia: tanda limpia, se sube a ${this.limite} consultas simultáneas.`);
+    }
+    /**
+     * Ejecuta las tareas respetando el límite vigente, que puede bajar A MITAD DE
+     * TANDA: si las primeras consultas ya vienen con 504, las que quedan salen con
+     * menos paralelismo en vez de repetir el error en bloque.
+     *
+     * Devuelve un arreglo del mismo largo y en el mismo orden que `tareas`, con
+     * `null` en las que fallaron. Nunca lanza: quien llama distingue el fallo por
+     * el `null`, que es lo que las herramientas de análisis ya esperan.
+     */
+    async ejecutar(tareas) {
+        const resultados = new Array(tareas.length).fill(null);
+        if (tareas.length === 0)
+            return resultados;
+        this.tandas++;
+        let huboCongestion = false;
+        let siguiente = 0;
+        let enVuelo = 0;
+        await new Promise((resolve) => {
+            const lanzar = () => {
+                while (enVuelo < this.limite && siguiente < tareas.length) {
+                    const i = siguiente++;
+                    enVuelo++;
+                    tareas[i]()
+                        .then((valor) => { resultados[i] = valor; })
+                        .catch((e) => {
+                        resultados[i] = null;
+                        if (esSenalDeCongestion(e)) {
+                            huboCongestion = true;
+                            this.reducir(); // efecto inmediato sobre lo que queda por lanzar
+                        }
+                    })
+                        .finally(() => {
+                        enVuelo--;
+                        if (siguiente >= tareas.length && enVuelo === 0)
+                            resolve();
+                        else
+                            lanzar();
+                    });
+                }
+            };
+            lanzar();
+        });
+        if (!huboCongestion)
+            this.aumentar();
+        return resultados;
+    }
+}
+//# sourceMappingURL=concurrencia.js.map

package/dist/utils/concurrencia.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,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;AAoCD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB5E"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,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;AA4CD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB5E"}

package/dist/utils/error-handler.js

@@ -39,6 +39,14 @@ function getActionableMessage(httpStatus, apiErrors) {
             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}`;
+        // 502 y 504 no están en la tabla de errores de la guía oficial, pero la API
+        // los devuelve: se observó un 504 sistemático (septiembre 2026) al pedir
+        // tamano_pagina=50 sobre `estado=desierta` con búsqueda de texto — la
+        // pasarela corta a los ~30 s. Sin este caso caían en "Error inesperado", que
+        // hacía parecer un fallo del cliente lo que es una lentitud del servicio.
+        case 502:
+        case 504:
+            return `La pasarela de Mercado Público cortó la conexión antes de que la API respondiera (HTTP ${httpStatus}): la consulta tardó demasiado, no es un error de tus parámetros. Reintenta, y si se repite reduce el trabajo por consulta — un 'tamano_pagina' más chico, menos 'limite_analisis' o un filtro más específico. Las búsquedas por texto sobre 'estado=desierta' son las más lentas.${detail}`;
         default:
             return `Error inesperado HTTP ${httpStatus} de la API de Compra Ágil.${detail}`;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAerC,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3B,UAAU,CAAS;IACnB,SAAS,CAAa;IACtB,iBAAiB,CAAS;IAE1C,YAAY,UAAkB,EAAE,YAAwB,EAAE;QACxD,MAAM,UAAU,GAAG,oBAAoB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC/D,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,iBAAiB,GAAG,UAAU,CAAC;IACtC,CAAC;CACF;AAED,SAAS,oBAAoB,CAAC,UAAkB,EAAE,SAAqB;IACrE,6EAA6E;IAC7E,gFAAgF;IAChF,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;QACjC,CAAC,CAAC,wBAAwB,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG;QAC/D,CAAC,CAAC,EAAE,CAAC;IAEP,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,GAAG;YACN,OAAO,qLAAqL,MAAM,EAAE,CAAC;QACvM,KAAK,GAAG;YACN,OAAO,2JAA2J,MAAM,EAAE,CAAC;QAC7K,KAAK,GAAG;YACN,OAAO,gLAAgL,MAAM,EAAE,CAAC;QAClM,KAAK,GAAG;YACN,OAAO,mKAAmK,MAAM,EAAE,CAAC;QACrL,KAAK,GAAG;YACN,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,GAAG;YACN,OAAO,4IAA4I,MAAM,EAAE,CAAC;QAC9J,KAAK,GAAG;YACN,OAAO,gHAAgH,MAAM,EAAE,CAAC;QAClI;YACE,OAAO,yBAAyB,UAAU,6BAA6B,MAAM,EAAE,CAAC;IACpF,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAc;IAC5C,6EAA6E;IAC7E,4EAA4E;IAC5E,sEAAsE;IACtE,OAAO,0jBAA0jB,MAAM,EAAE,CAAC;AAC5kB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAkB;IACxD,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA6C,CAAC;QAC9E,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACnC,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAG,IAAoC,CAAC,MAAM,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACvF,CAAC;IAED,IAAI,SAAS,GAAe,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAsB,CAAC;QAC5D,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACrB,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;IAC9D,CAAC;IAED,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"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"}

package/dist/utils/fechas.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Interpretación de las fechas que entrega la API.
+ *
+ * ⚠ EL PROBLEMA: la API mezcla dos formatos para el mismo instante.
+ *
+ *     fechas.fecha_cierre                  "2026-09-11 12:00"      ← sin zona
+ *     convocatoria.fecha_cierre_primer_llamado "2026-09-11T12:00:00Z"  ← UTC
+ *
+ *   Verificado en 8 de 8 procesos: el valor es idéntico, pero solo uno declara
+ *   su zona horaria. Los campos sin marca son justamente los que un proveedor
+ *   mira para saber cuándo cierra un llamado.
+ *
+ * ⚠ POR QUÉ NO BASTA CON `new Date()`: ante un string sin zona y con espacio en
+ *   vez de "T", V8 lo interpreta en la zona horaria DEL SERVIDOR. Medido: el
+ *   mismo "2026-09-11 12:00" se convierte en 15:00Z si el proceso corre en
+ *   Chile y en 12:00Z si corre en UTC. Es decir, el radar calculaba
+ *   `horas_restantes` —y con ello su puntaje de urgencia— con tres horas de
+ *   diferencia según dónde estuviera desplegado, con los mismos datos.
+ *
+ * ⚠ POR QUÉ SE ASUME UTC: no se pudo determinar con certeza si esos valores son
+ *   UTC u hora de Chile. La evidencia está dividida — el filtro `ttl_cambio_ms`
+ *   de la API trata las marcas `Z` como UTC real, pero la ficha del portal
+ *   muestra ese mismo "12:00" a usuarios chilenos sin convertir.
+ *
+ *   Ante la duda se elige UTC porque el error es asimétrico. Si el valor fuera
+ *   hora de Chile y lo leemos como UTC, mostramos el cierre TRES HORAS ANTES de
+ *   lo real: el proveedor se apura de más. Al revés —leerlo como hora local
+ *   siendo UTC— le haría creer que tiene tres horas extra y perdería el plazo.
+ *   Entre apurarse de más y llegar tarde a una licitación, la elección es clara.
+ */
+/**
+ * Convierte una fecha de la API a un instante absoluto, sin depender de la zona
+ * horaria del servidor. Devuelve `null` si el valor falta o no se entiende, para
+ * que quien llame distinga "no hay fecha" de "medianoche".
+ */
+export declare function parsearFechaApi(valor: string | null | undefined): Date | null;
+/** ¿El valor viene sin declarar su zona horaria? Entonces se asumió UTC. */
+export declare function esFechaAmbigua(valor: string | null | undefined): boolean;
+/**
+ * Texto que acompaña a una fecha ambigua para que ni el modelo ni la persona
+ * asuman hora local. Va en la salida de las herramientas, no en los logs:
+ * quien decide si alcanza a cotizar necesita verlo.
+ */
+export declare const NOTA_ZONA_HORARIA: string;
+/**
+ * Misma fecha, expresada también en hora de Chile, para que el usuario no tenga
+ * que hacer la resta mental. Devuelve `null` si la fecha no se pudo interpretar.
+ */
+export declare function enHoraDeChile(valor: string | null | undefined): string | null;
+//# sourceMappingURL=fechas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fechas.d.ts","sourceRoot":"","sources":["../../src/utils/fechas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAgB7E;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAG4E,CAAC;AAE3G;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAK7E"}

package/dist/utils/fechas.js

@@ -0,0 +1,77 @@
+/**
+ * Interpretación de las fechas que entrega la API.
+ *
+ * ⚠ EL PROBLEMA: la API mezcla dos formatos para el mismo instante.
+ *
+ *     fechas.fecha_cierre                  "2026-09-11 12:00"      ← sin zona
+ *     convocatoria.fecha_cierre_primer_llamado "2026-09-11T12:00:00Z"  ← UTC
+ *
+ *   Verificado en 8 de 8 procesos: el valor es idéntico, pero solo uno declara
+ *   su zona horaria. Los campos sin marca son justamente los que un proveedor
+ *   mira para saber cuándo cierra un llamado.
+ *
+ * ⚠ POR QUÉ NO BASTA CON `new Date()`: ante un string sin zona y con espacio en
+ *   vez de "T", V8 lo interpreta en la zona horaria DEL SERVIDOR. Medido: el
+ *   mismo "2026-09-11 12:00" se convierte en 15:00Z si el proceso corre en
+ *   Chile y en 12:00Z si corre en UTC. Es decir, el radar calculaba
+ *   `horas_restantes` —y con ello su puntaje de urgencia— con tres horas de
+ *   diferencia según dónde estuviera desplegado, con los mismos datos.
+ *
+ * ⚠ POR QUÉ SE ASUME UTC: no se pudo determinar con certeza si esos valores son
+ *   UTC u hora de Chile. La evidencia está dividida — el filtro `ttl_cambio_ms`
+ *   de la API trata las marcas `Z` como UTC real, pero la ficha del portal
+ *   muestra ese mismo "12:00" a usuarios chilenos sin convertir.
+ *
+ *   Ante la duda se elige UTC porque el error es asimétrico. Si el valor fuera
+ *   hora de Chile y lo leemos como UTC, mostramos el cierre TRES HORAS ANTES de
+ *   lo real: el proveedor se apura de más. Al revés —leerlo como hora local
+ *   siendo UTC— le haría creer que tiene tres horas extra y perdería el plazo.
+ *   Entre apurarse de más y llegar tarde a una licitación, la elección es clara.
+ */
+/** Formato sin zona horaria que devuelve la API: "2026-09-11 12:00". */
+const SIN_ZONA = /^(\d{4}-\d{2}-\d{2})[ T](\d{2}:\d{2})(:(\d{2}))?$/;
+/**
+ * Convierte una fecha de la API a un instante absoluto, sin depender de la zona
+ * horaria del servidor. Devuelve `null` si el valor falta o no se entiende, para
+ * que quien llame distinga "no hay fecha" de "medianoche".
+ */
+export function parsearFechaApi(valor) {
+    if (!valor)
+        return null;
+    const texto = String(valor).trim();
+    const m = SIN_ZONA.exec(texto);
+    if (m) {
+        // Se le añade la Z que la API omitió: así el resultado es el mismo en
+        // cualquier servidor, que es la mitad del problema que esto resuelve.
+        const segundos = m[4] ?? '00';
+        const d = new Date(`${m[1]}T${m[2]}:${segundos}Z`);
+        return isNaN(d.getTime()) ? null : d;
+    }
+    // Ya trae zona horaria (Z u offset): se respeta lo que dice.
+    const d = new Date(texto);
+    return isNaN(d.getTime()) ? null : d;
+}
+/** ¿El valor viene sin declarar su zona horaria? Entonces se asumió UTC. */
+export function esFechaAmbigua(valor) {
+    return Boolean(valor) && SIN_ZONA.test(String(valor).trim());
+}
+/**
+ * Texto que acompaña a una fecha ambigua para que ni el modelo ni la persona
+ * asuman hora local. Va en la salida de las herramientas, no en los logs:
+ * quien decide si alcanza a cotizar necesita verlo.
+ */
+export const NOTA_ZONA_HORARIA = 'Las horas provienen de la API sin declarar zona horaria y se interpretan como UTC. ' +
+    'En Chile continental (UTC-3) resta 3 horas: un cierre a las "12:00" corresponde a las 09:00 locales. ' +
+    'Como la API no lo especifica, confirma el plazo exacto en la ficha del proceso antes de comprometerte.';
+/**
+ * Misma fecha, expresada también en hora de Chile, para que el usuario no tenga
+ * que hacer la resta mental. Devuelve `null` si la fecha no se pudo interpretar.
+ */
+export function enHoraDeChile(valor) {
+    const d = parsearFechaApi(valor);
+    if (!d)
+        return null;
+    // sv-SE da el formato ISO "YYYY-MM-DD HH:MM", legible y sin ambigüedad.
+    return d.toLocaleString('sv-SE', { timeZone: 'America/Santiago' }).slice(0, 16);
+}
+//# sourceMappingURL=fechas.js.map

package/dist/utils/fechas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fechas.js","sourceRoot":"","sources":["../../src/utils/fechas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,wEAAwE;AACxE,MAAM,QAAQ,GAAG,mDAAmD,CAAC;AAErE;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgC;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,CAAC;QACN,sEAAsE;QACtE,sEAAsE;QACtE,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,6DAA6D;IAC7D,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,KAAgC;IAC7D,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,qFAAqF;IACrF,uGAAuG;IACvG,wGAAwG,CAAC;AAE3G;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgC;IAC5D,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,wEAAwE;IACxE,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,wBAAgB,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAE9C;AA2BD,eAAO,MAAM,MAAM;iBACJ,MAAM,SAAS,OAAO;gBACvB,MAAM,SAAS,OAAO;gBACtB,MAAM,SAAS,OAAO;iBACrB,MAAM,SAAS,OAAO;CACpC,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,wBAAgB,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAE9C;AAsCD,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

@@ -17,6 +17,8 @@ function formatTimestamp() {
     return new Date().toISOString();
 }
 let mcpServer = null;
+/** Evita repetir el aviso de fallo de envío en cada línea de log. */
+let falloDeEnvioAvisado = false;
 export function setMcpServer(server) {
     mcpServer = server;
 }
@@ -37,8 +39,17 @@ function log(level, message, data) {
             level,
             logger: 'mcp-compra-agil',
             data: seguro,
-        }).catch(() => {
-            // Ignorar fallos silenciosamente para no interrumpir el flujo principal
+        }).catch((e) => {
+            // No se interrumpe el flujo principal por un log que no se pudo enviar,
+            // pero tampoco se calla del todo: este `catch` mudo fue lo que ocultó
+            // durante meses que la capacidad `logging` no estaba declarada y que
+            // NINGUNA notificación llegaba al cliente. Se avisa una sola vez, a
+            // stderr, para que el aviso no se convierta en el ruido que denuncia.
+            if (!falloDeEnvioAvisado) {
+                falloDeEnvioAvisado = true;
+                console.error(`[${formatTimestamp()}] [WARN] No se pudieron enviar logs al cliente MCP ` +
+                    `(se seguirá escribiendo a stderr). Causa: ${redact(String(e))}`);
+            }
         });
     }
 }

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,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,yEAAyE;IACzE,gDAAgD;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACrE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9B,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IAErC,6EAA6E;IAC7E,kEAAkE;IAClE,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,kBAAkB,CAAC;YAC3B,KAAK;YACL,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,MAAM;SACb,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"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,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;AAC1B,qEAAqE;AACrE,IAAI,mBAAmB,GAAG,KAAK,CAAC;AAEhC,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,yEAAyE;IACzE,gDAAgD;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACrE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9B,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IAErC,6EAA6E;IAC7E,kEAAkE;IAClE,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,kBAAkB,CAAC;YAC3B,KAAK;YACL,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;YACtB,wEAAwE;YACxE,sEAAsE;YACtE,qEAAqE;YACrE,oEAAoE;YACpE,sEAAsE;YACtE,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACzB,mBAAmB,GAAG,IAAI,CAAC;gBAC3B,OAAO,CAAC,KAAK,CACX,IAAI,eAAe,EAAE,qDAAqD;oBAC1E,6CAA6C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CACjE,CAAC;YACJ,CAAC;QACH,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/ntp.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Consulta la hora oficial de Chile contra el SHOA (Servicio Hidrográfico y
+ * Oceanográfico de la Armada), que es el organismo que la fija legalmente.
+ *
+ * ⚠ QUÉ PROBLEMA RESUELVE Y CUÁL NO: no dice nada sobre cómo interpretar las
+ *   fechas ambiguas que entrega la API —de eso se encarga `utils/fechas.ts`—.
+ *   Resuelve algo distinto y anterior: si el reloj de esta máquina está
+ *   desviado, entonces `horas_restantes` y el puntaje de urgencia del radar
+ *   están mal aunque la interpretación de la fecha sea perfecta, porque ambos
+ *   se calculan restando la hora local. Un reloj adelantado media hora hace
+ *   creer que un plazo está más cerca de lo que está; uno atrasado, lo
+ *   contrario, y eso sí cuesta una licitación.
+ *
+ * Implementa lo mínimo de NTP (RFC 5905) sobre `dgram`, sin dependencias. El
+ * desfase se calcula con la fórmula del protocolo, que descuenta el viaje de
+ * ida y vuelta en vez de atribuirlo todo al reloj:
+ *
+ *     desfase = ((T2 − T1) + (T3 − T4)) / 2
+ *     demora  = (T4 − T1) − (T3 − T2)
+ *
+ *   T1 salida del cliente · T2 llegada al servidor
+ *   T3 salida del servidor · T4 llegada al cliente
+ */
+/** Servidor oficial de la hora en Chile. */
+export declare const SERVIDOR_NTP_CHILE = "ntp.shoa.cl";
+export interface ResultadoNtp {
+    ok: true;
+    servidor: string;
+    /** Diferencia del reloj local respecto del oficial, en ms. Positivo = local atrasado. */
+    desfaseMs: number;
+    /** Ida y vuelta de la consulta, en ms. Una demora alta resta precisión al desfase. */
+    demoraMs: number;
+    horaOficial: string;
+    horaLocal: string;
+}
+export interface FalloNtp {
+    ok: false;
+    servidor: string;
+    motivo: string;
+}
+/**
+ * Pregunta la hora al SHOA. Nunca lanza: un fallo de red se devuelve como
+ * `{ ok: false }` porque muchas redes corporativas bloquean el UDP 123, y eso
+ * no debe impedir que el servidor MCP funcione.
+ */
+export declare function consultarHoraOficial(servidor?: string, timeoutMs?: number): Promise<ResultadoNtp | FalloNtp>;
+/** Umbral a partir del cual el desfase puede alterar una decisión de plazo. */
+export declare const DESFASE_PREOCUPANTE_MS = 60000;
+/** Traduce el desfase a lo que significa para quien va a cotizar. */
+export declare function interpretarDesfase(desfaseMs: number): string;
+//# sourceMappingURL=ntp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ntp.d.ts","sourceRoot":"","sources":["../../src/utils/ntp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAKhD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AASD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,GAAE,MAA2B,EACrC,SAAS,SAAO,GACf,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC,CAmElC;AAED,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAY5D"}

package/dist/utils/ntp.js

@@ -0,0 +1,121 @@
+/**
+ * Consulta la hora oficial de Chile contra el SHOA (Servicio Hidrográfico y
+ * Oceanográfico de la Armada), que es el organismo que la fija legalmente.
+ *
+ * ⚠ QUÉ PROBLEMA RESUELVE Y CUÁL NO: no dice nada sobre cómo interpretar las
+ *   fechas ambiguas que entrega la API —de eso se encarga `utils/fechas.ts`—.
+ *   Resuelve algo distinto y anterior: si el reloj de esta máquina está
+ *   desviado, entonces `horas_restantes` y el puntaje de urgencia del radar
+ *   están mal aunque la interpretación de la fecha sea perfecta, porque ambos
+ *   se calculan restando la hora local. Un reloj adelantado media hora hace
+ *   creer que un plazo está más cerca de lo que está; uno atrasado, lo
+ *   contrario, y eso sí cuesta una licitación.
+ *
+ * Implementa lo mínimo de NTP (RFC 5905) sobre `dgram`, sin dependencias. El
+ * desfase se calcula con la fórmula del protocolo, que descuenta el viaje de
+ * ida y vuelta en vez de atribuirlo todo al reloj:
+ *
+ *     desfase = ((T2 − T1) + (T3 − T4)) / 2
+ *     demora  = (T4 − T1) − (T3 − T2)
+ *
+ *   T1 salida del cliente · T2 llegada al servidor
+ *   T3 salida del servidor · T4 llegada al cliente
+ */
+import dgram from 'dgram';
+/** Servidor oficial de la hora en Chile. */
+export const SERVIDOR_NTP_CHILE = 'ntp.shoa.cl';
+/** Segundos entre la época NTP (1900) y la de Unix (1970). */
+const EPOCA_NTP_A_UNIX = 2_208_988_800;
+/** Lee un timestamp NTP de 64 bits (32 de segundos + 32 de fracción) como ms Unix. */
+function leerTimestamp(buf, offset) {
+    const segundos = buf.readUInt32BE(offset);
+    const fraccion = buf.readUInt32BE(offset + 4);
+    return (segundos - EPOCA_NTP_A_UNIX) * 1000 + Math.round((fraccion / 4_294_967_296) * 1000);
+}
+/**
+ * Pregunta la hora al SHOA. Nunca lanza: un fallo de red se devuelve como
+ * `{ ok: false }` porque muchas redes corporativas bloquean el UDP 123, y eso
+ * no debe impedir que el servidor MCP funcione.
+ */
+export function consultarHoraOficial(servidor = SERVIDOR_NTP_CHILE, timeoutMs = 5000) {
+    return new Promise((resolve) => {
+        const socket = dgram.createSocket('udp4');
+        let resuelto = false;
+        const terminar = (r) => {
+            if (resuelto)
+                return;
+            resuelto = true;
+            try {
+                socket.close();
+            }
+            catch { /* ya cerrado */ }
+            resolve(r);
+        };
+        const temporizador = setTimeout(() => terminar({
+            ok: false,
+            servidor,
+            motivo: `El servidor no respondió en ${timeoutMs} ms. Muchas redes corporativas bloquean el puerto UDP 123, que es el que usa NTP.`,
+        }), timeoutMs);
+        socket.on('message', (msg) => {
+            clearTimeout(temporizador);
+            const t4 = Date.now();
+            if (msg.length < 48) {
+                return terminar({ ok: false, servidor, motivo: 'La respuesta no tiene el tamaño de un paquete NTP.' });
+            }
+            try {
+                const t1 = leerTimestamp(msg, 24); // Originate: el T1 que enviamos, devuelto por el servidor
+                const t2 = leerTimestamp(msg, 32); // Receive
+                const t3 = leerTimestamp(msg, 40); // Transmit
+                const desfaseMs = Math.round(((t2 - t1) + (t3 - t4)) / 2);
+                const demoraMs = Math.max(0, Math.round((t4 - t1) - (t3 - t2)));
+                terminar({
+                    ok: true,
+                    servidor,
+                    desfaseMs,
+                    demoraMs,
+                    horaOficial: new Date(t4 + desfaseMs).toISOString(),
+                    horaLocal: new Date(t4).toISOString(),
+                });
+            }
+            catch (e) {
+                terminar({ ok: false, servidor, motivo: `No se pudo leer la respuesta: ${String(e)}` });
+            }
+        });
+        socket.on('error', (e) => {
+            clearTimeout(temporizador);
+            terminar({ ok: false, servidor, motivo: `Error de red: ${e.message}` });
+        });
+        // Paquete de consulta: LI=0, VN=4, Mode=3 (cliente). El resto en cero.
+        const paquete = Buffer.alloc(48);
+        paquete[0] = 0x23;
+        // Se escribe T1 en Originate para que el servidor lo devuelva y el cálculo
+        // del desfase no dependa del reloj local más de lo imprescindible.
+        const t1 = Date.now();
+        paquete.writeUInt32BE(Math.floor(t1 / 1000) + EPOCA_NTP_A_UNIX, 40);
+        paquete.writeUInt32BE(Math.round(((t1 % 1000) / 1000) * 4_294_967_296), 44);
+        socket.send(paquete, 0, 48, 123, servidor, (e) => {
+            if (e) {
+                clearTimeout(temporizador);
+                terminar({ ok: false, servidor, motivo: `No se pudo enviar la consulta: ${e.message}` });
+            }
+        });
+    });
+}
+/** Umbral a partir del cual el desfase puede alterar una decisión de plazo. */
+export const DESFASE_PREOCUPANTE_MS = 60_000;
+/** Traduce el desfase a lo que significa para quien va a cotizar. */
+export function interpretarDesfase(desfaseMs) {
+    const abs = Math.abs(desfaseMs);
+    if (abs < 1000)
+        return 'El reloj de esta máquina está sincronizado con la hora oficial de Chile.';
+    if (abs < DESFASE_PREOCUPANTE_MS) {
+        return `El reloj está desviado ${(abs / 1000).toFixed(1)} s respecto de la hora oficial. Es una diferencia irrelevante para calcular plazos de cierre.`;
+    }
+    const minutos = (abs / 60_000).toFixed(1);
+    const sentido = desfaseMs > 0 ? 'atrasado' : 'adelantado';
+    const consecuencia = desfaseMs > 0
+        ? 'las horas restantes que informa el radar son MAYORES que las reales, así que un plazo puede vencer antes de lo que parece'
+        : 'las horas restantes que informa el radar son MENORES que las reales';
+    return `⚠ El reloj de esta máquina está ${sentido} ${minutos} min respecto de la hora oficial de Chile. Como los plazos se calculan restando la hora local, ${consecuencia}. Conviene sincronizar el reloj del sistema antes de fiarse de "horas_restantes".`;
+}
+//# sourceMappingURL=ntp.js.map

package/dist/utils/ntp.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssolis-ti/mcp-compra-agil",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "Servidor MCP para la API Compra Ágil v2 de Mercado Público (Chile)",
   "type": "module",
   "bin": {