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

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

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

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;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"}
+{"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"}

package/dist/utils/logger.js

@@ -5,6 +5,7 @@
  * a stdout (console.log) ya que corrompe el stream JSON-RPC.
  * Todo el logging va exclusivamente a stderr (console.error).
  */
+import { redact } from './redact.js';
 const LOG_LEVELS = {
     debug: 0,
     info: 1,
@@ -23,17 +24,19 @@ 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}`;
+    // Redacción en el punto de salida: cubre tanto el mensaje como los datos
+    // adjuntos, sin importar de qué ruta provengan.
+    const cuerpo = data ? `${message} ${JSON.stringify(data)}` : message;
+    const seguro = redact(cuerpo);
     // SIEMPRE stderr, NUNCA stdout
-    console.error(line);
-    // Intentar enviar el log de forma nativa al cliente MCP si el servidor está configurado
+    console.error(`${prefix} ${seguro}`);
+    // El cliente MCP recibe los logs de forma nativa — es decir, van al contexto
+    // del LLM y a la transcripción. Se envía la versión ya redactada.
     if (mcpServer) {
         mcpServer.sendLoggingMessage({
             level,
             logger: 'mcp-compra-agil',
-            data: data ? `${message} ${JSON.stringify(data)}` : message,
+            data: seguro,
         }).catch(() => {
             // Ignorar fallos silenciosamente para no interrumpir el flujo principal
         });

package/dist/utils/logger.js.map

@@ -1 +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"}
+{"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"}

package/dist/utils/quotation.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Utilidades de cotización: análisis de precios y detección de adjudicación.
+ *
+ * ⚠ REALIDAD DE LA API (verificado empíricamente contra el servicio real,
+ *   julio 2026 — 45 procesos inspeccionados, 52 cotizaciones — y re-confirmado
+ *   en septiembre 2026 con resultados idénticos):
+ *
+ *   • `proveedor_seleccionado` SÍ existe, pero su valor fue **0 en el 100%**
+ *     de las cotizaciones observadas. Nunca se observó un 1.
+ *   • Ningún proceso traía `id_orden_compra` (siempre null).
+ *   • El filtro `estado=proveedor_seleccionado` devuelve **0 resultados**.
+ *   • El filtro `estado=oc_emitida` devuelve **HTTP 400** (ni siquiera es válido).
+ *   • `seleccion.*` y `estado_cotizacion.*` NO existen en la respuesta.
+ *     En su lugar hay `estado` (número; siempre 3 en la muestra).
+ *
+ *   CONCLUSIÓN: la API no expone procesos adjudicados. Cualquier análisis
+ *   basado en "el precio que ganó" está condenado a no encontrar datos.
+ *   El Ejemplo 8.6 de la Guía oficial v3.0 (detectar OCs emitidas recorriendo
+ *   `estado=proveedor_seleccionado`) es irrealizable por la misma razón:
+ *   su primer paso devuelve una lista vacía.
+ *
+ *   Lo que SÍ hay: cotizaciones reales con `precio_unitario` y `valor_neto`
+ *   (17 de 45 procesos las traían). Por eso el análisis se basa en precios
+ *   COTIZADOS — señal de mercado genuina — y no en precios adjudicados.
+ */
+import type { ProveedorCotizando } from '../api/compra-agil-client.js';
+/**
+ * Determina si un proveedor fue el adjudicado.
+ *
+ * Se conserva porque es correcta si la API alguna vez publica adjudicaciones,
+ * pero en la práctica retorna false SIEMPRE (ver nota de cabecera). No debe
+ * usarse como única fuente de un análisis: hazlo degradar con elegancia.
+ */
+export declare function esGanador(prov: ProveedorCotizando): boolean;
+/**
+ * Una cotización es admisible si el comprador no la declaró inadmisible.
+ * Útil para separar precios "sanos" de los descartados por incumplimiento
+ * (ej: "Oferta no cumple con garantía solicitada"), que distorsionan la muestra.
+ */
+export declare function esAdmisible(prov: ProveedorCotizando): boolean;
+/**
+ * Extrae el precio UNITARIO de la cotización de un proveedor para un término
+ * de búsqueda dado. Retorna null si no hay un precio unitario confiable.
+ *
+ * No cae al monto total: el precio unitario y el total NO son comparables y
+ * mezclarlos corrompe cualquier estadística agregada.
+ */
+export declare function extraerPrecioUnitario(prov: ProveedorCotizando, keyword?: string): number | null;
+/**
+ * Extrae el monto NETO total de la cotización de un proveedor.
+ * Útil para estadísticas de monto cotizado (distintas de precio unitario).
+ */
+export declare function extraerMontoNeto(prov: ProveedorCotizando): number | null;
+export interface EstadisticasPrecio {
+    muestras: number;
+    minimo: number;
+    maximo: number;
+    promedio: number;
+    mediana: number;
+    /** Percentil 25 — referencia para posicionarse de forma competitiva. */
+    p25: number;
+}
+/**
+ * Calcula estadísticas de una serie de precios.
+ * Retorna null si la serie está vacía, para poder distinguir "sin datos"
+ * de "datos que dan cero".
+ */
+export declare function calcularEstadisticas(valores: number[]): EstadisticasPrecio | null;
+/** Percentil por interpolación lineal sobre una serie YA ordenada. */
+export declare function percentil(ordenados: number[], p: number): number;
+//# sourceMappingURL=quotation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quotation.d.ts","sourceRoot":"","sources":["../../src/utils/quotation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAmB3D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAG7D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CA4Bf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAExE;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,kBAAkB,GAAG,IAAI,CAYjF;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQhE"}

package/dist/utils/quotation.js

@@ -0,0 +1,140 @@
+/**
+ * Utilidades de cotización: análisis de precios y detección de adjudicación.
+ *
+ * ⚠ REALIDAD DE LA API (verificado empíricamente contra el servicio real,
+ *   julio 2026 — 45 procesos inspeccionados, 52 cotizaciones — y re-confirmado
+ *   en septiembre 2026 con resultados idénticos):
+ *
+ *   • `proveedor_seleccionado` SÍ existe, pero su valor fue **0 en el 100%**
+ *     de las cotizaciones observadas. Nunca se observó un 1.
+ *   • Ningún proceso traía `id_orden_compra` (siempre null).
+ *   • El filtro `estado=proveedor_seleccionado` devuelve **0 resultados**.
+ *   • El filtro `estado=oc_emitida` devuelve **HTTP 400** (ni siquiera es válido).
+ *   • `seleccion.*` y `estado_cotizacion.*` NO existen en la respuesta.
+ *     En su lugar hay `estado` (número; siempre 3 en la muestra).
+ *
+ *   CONCLUSIÓN: la API no expone procesos adjudicados. Cualquier análisis
+ *   basado en "el precio que ganó" está condenado a no encontrar datos.
+ *   El Ejemplo 8.6 de la Guía oficial v3.0 (detectar OCs emitidas recorriendo
+ *   `estado=proveedor_seleccionado`) es irrealizable por la misma razón:
+ *   su primer paso devuelve una lista vacía.
+ *
+ *   Lo que SÍ hay: cotizaciones reales con `precio_unitario` y `valor_neto`
+ *   (17 de 45 procesos las traían). Por eso el análisis se basa en precios
+ *   COTIZADOS — señal de mercado genuina — y no en precios adjudicados.
+ */
+/**
+ * Determina si un proveedor fue el adjudicado.
+ *
+ * Se conserva porque es correcta si la API alguna vez publica adjudicaciones,
+ * pero en la práctica retorna false SIEMPRE (ver nota de cabecera). No debe
+ * usarse como única fuente de un análisis: hazlo degradar con elegancia.
+ */
+export function esGanador(prov) {
+    // Señal 1: flag directo (la API lo entrega como número: 0 | 1)
+    if (prov.proveedor_seleccionado === true || prov.proveedor_seleccionado === 1) {
+        return true;
+    }
+    // Señal 2: objeto `seleccion` anidado — documentado pero inexistente en la
+    // respuesta real. Se mantiene por si la API lo incorpora.
+    if (prov.seleccion?.proveedor_seleccionado === true) {
+        return true;
+    }
+    // Señal 3: estado_por_comprador === '1' (observado siempre null)
+    if (prov.estado_por_comprador === '1') {
+        return true;
+    }
+    // Señal 4: motivo/criterio de selección presente implica adjudicación
+    if (prov.seleccion?.motivo_seleccion || prov.seleccion?.criterio_seleccion) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Una cotización es admisible si el comprador no la declaró inadmisible.
+ * Útil para separar precios "sanos" de los descartados por incumplimiento
+ * (ej: "Oferta no cumple con garantía solicitada"), que distorsionan la muestra.
+ */
+export function esAdmisible(prov) {
+    const j = prov.justificacion_inadmisibilidad;
+    return j === null || j === undefined || String(j).trim() === '';
+}
+/**
+ * Extrae el precio UNITARIO de la cotización de un proveedor para un término
+ * de búsqueda dado. Retorna null si no hay un precio unitario confiable.
+ *
+ * No cae al monto total: el precio unitario y el total NO son comparables y
+ * mezclarlos corrompe cualquier estadística agregada.
+ */
+export function extraerPrecioUnitario(prov, keyword) {
+    const productos = prov.productos_cotizados;
+    if (!productos || productos.length === 0) {
+        return null;
+    }
+    // Un solo producto → su precio unitario
+    if (productos.length === 1) {
+        return normalizarPrecio(productos[0].precio_unitario);
+    }
+    // Varios productos → intentar casar con la keyword
+    if (keyword) {
+        const kw = keyword.toLowerCase();
+        const matched = productos.find((p) => (p.nombre_producto || '').toLowerCase().includes(kw));
+        if (matched) {
+            return normalizarPrecio(matched.precio_unitario);
+        }
+    }
+    // Fallback: primer producto con precio unitario válido
+    for (const p of productos) {
+        const precio = normalizarPrecio(p.precio_unitario);
+        if (precio !== null)
+            return precio;
+    }
+    return null;
+}
+/**
+ * Extrae el monto NETO total de la cotización de un proveedor.
+ * Útil para estadísticas de monto cotizado (distintas de precio unitario).
+ */
+export function extraerMontoNeto(prov) {
+    return normalizarPrecio(prov.valor_neto) ?? normalizarPrecio(prov.monto_total);
+}
+/**
+ * Calcula estadísticas de una serie de precios.
+ * Retorna null si la serie está vacía, para poder distinguir "sin datos"
+ * de "datos que dan cero".
+ */
+export function calcularEstadisticas(valores) {
+    if (!valores || valores.length === 0)
+        return null;
+    const s = [...valores].sort((a, b) => a - b);
+    const mid = Math.floor(s.length / 2);
+    return {
+        muestras: s.length,
+        minimo: s[0],
+        maximo: s[s.length - 1],
+        promedio: Math.round(s.reduce((a, b) => a + b, 0) / s.length),
+        mediana: s.length % 2 !== 0 ? s[mid] : Math.round((s[mid - 1] + s[mid]) / 2),
+        p25: percentil(s, 25),
+    };
+}
+/** Percentil por interpolación lineal sobre una serie YA ordenada. */
+export function percentil(ordenados, p) {
+    if (ordenados.length === 0)
+        return 0;
+    if (ordenados.length === 1)
+        return ordenados[0];
+    const pos = (p / 100) * (ordenados.length - 1);
+    const bajo = Math.floor(pos);
+    const alto = Math.ceil(pos);
+    if (bajo === alto)
+        return ordenados[bajo];
+    return Math.round(ordenados[bajo] + (ordenados[alto] - ordenados[bajo]) * (pos - bajo));
+}
+function normalizarPrecio(valor) {
+    if (valor === null || valor === undefined)
+        return null;
+    if (typeof valor !== 'number' || !Number.isFinite(valor) || valor <= 0)
+        return null;
+    return valor;
+}
+//# sourceMappingURL=quotation.js.map

package/dist/utils/quotation.js.map

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

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

@@ -5,21 +5,63 @@
  * Este módulo lleva un contador local de requests para advertir
  * proactivamente antes de alcanzar el límite.
  */
+/** Archivo donde el servidor recuerda la cuota entre reinicios. */
+export declare const RUTA_ESTADO_POR_DEFECTO: string;
 export declare class RateLimiter {
     private requestCount;
     private currentDay;
     private isLimited;
     private limitResetTime;
-    constructor();
+    /** 429 seguidos sin una consulta exitosa en medio; gradúa la espera. */
+    private consecutive429;
+    private readonly maxPerMinute;
+    private requestTimestamps;
+    /**
+     * Ruta de persistencia, o `null` para operar solo en memoria.
+     *
+     * ⚠ POR QUÉ SE PERSISTE: el contador vivía únicamente en memoria, así que
+     *   cada arranque del servidor empezaba en cero. Como un servidor MCP se
+     *   reinicia cada vez que el usuario reinicia su cliente, `obtener_estadisticas_uso`
+     *   informaba `isLimited: false` incluso segundos después de que la API
+     *   hubiera respondido 429 por cuota agotada, y el throttle preventivo
+     *   disparaba peticiones contra un muro. Detectado en auditoría.
+     */
+    private readonly statePath;
+    constructor(maxPerMinute?: number, statePath?: string | null);
+    /** Lee el estado del día en curso. Un estado de otro día se descarta. */
+    private cargarEstado;
+    private guardarEstado;
     private getTodayUTC;
+    /**
+     * Espera (si es necesario) hasta que haya cupo dentro de la ventana de 1 minuto,
+     * de forma proactiva, ANTES de enviar la solicitud. Evita gatillar 429 por ráfagas.
+     */
+    throttle(): Promise<void>;
     /**
      * Registra un request exitoso. Resetea el contador si cambió el día.
      */
     recordRequest(): void;
     /**
      * Marca que se recibió un error 429.
+     *
+     * ⚠ POR QUÉ NO SE BLOQUEA HASTA MAÑANA: antes, un solo 429 fijaba el reset
+     *   en las 00:01 UTC del día siguiente y `checkLimit()` rechazaba localmente
+     *   TODA consulta posterior — el MCP quedaba inutilizable durante horas sin
+     *   siquiera intentar llegar a la API. Medido en auditoría: tras un 429, la
+     *   API volvió a responder con normalidad 13 minutos después. La propia guía
+     *   oficial describe la cuota como un *token bucket* que "se recarga
+     *   automáticamente" (glosario) y manda esperar el header `Retry-After`
+     *   (§7), aunque su §4 diga que el límite es por día calendario.
+     *
+     *   Ahora se espera lo que indique `Retry-After`; si no viene, se aplica una
+     *   espera creciente (15 → 30 → 60 min, tope 2 h) que se reinicia con la
+     *   primera consulta exitosa.
+     *
+     * @param retryAfterSeconds Valor del header `Retry-After`, si la API lo envió.
      */
-    markLimited(): void;
+    markLimited(retryAfterSeconds?: number): void;
+    /** Espera creciente ante 429 sucesivos, para no martillar la API. */
+    private esperaPorDefecto;
     /**
      * Verifica si estamos actualmente limitados.
      */

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

@@ -1 +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"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,QAAwD,CAAC;AAS7F,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAqB;IAC3C,wEAAwE;IACxE,OAAO,CAAC,cAAc,CAAK;IAG3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,iBAAiB,CAAgB;IAEzC;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAE9B,YAAY,SAAK,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW;IAO9D,yEAAyE;IACzE,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB/B;;OAEG;IACH,aAAa,IAAI,IAAI;IAoBrB;;;;;;;;;;;;;;;;;OAiBG;IACH,WAAW,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI;IAiB7C,qEAAqE;IACrE,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,UAAU,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IA0BpD;;OAEG;IACH,QAAQ,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAOpF"}

package/dist/utils/rate-limiter.js

@@ -5,18 +5,98 @@
  * Este módulo lleva un contador local de requests para advertir
  * proactivamente antes de alcanzar el límite.
  */
+import fs from 'fs';
+import path from 'path';
 import { logger } from './logger.js';
+/** Archivo donde el servidor recuerda la cuota entre reinicios. */
+export const RUTA_ESTADO_POR_DEFECTO = path.resolve(process.cwd(), '.rate-limit-state.json');
 export class RateLimiter {
     requestCount = 0;
     currentDay;
     isLimited = false;
     limitResetTime = null;
-    constructor() {
+    /** 429 seguidos sin una consulta exitosa en medio; gradúa la espera. */
+    consecutive429 = 0;
+    // Throttle proactivo por minuto (ventana deslizante de timestamps).
+    maxPerMinute;
+    requestTimestamps = [];
+    /**
+     * Ruta de persistencia, o `null` para operar solo en memoria.
+     *
+     * ⚠ POR QUÉ SE PERSISTE: el contador vivía únicamente en memoria, así que
+     *   cada arranque del servidor empezaba en cero. Como un servidor MCP se
+     *   reinicia cada vez que el usuario reinicia su cliente, `obtener_estadisticas_uso`
+     *   informaba `isLimited: false` incluso segundos después de que la API
+     *   hubiera respondido 429 por cuota agotada, y el throttle preventivo
+     *   disparaba peticiones contra un muro. Detectado en auditoría.
+     */
+    statePath;
+    constructor(maxPerMinute = 40, statePath = null) {
         this.currentDay = this.getTodayUTC();
+        this.maxPerMinute = maxPerMinute;
+        this.statePath = statePath;
+        this.cargarEstado();
+    }
+    /** Lee el estado del día en curso. Un estado de otro día se descarta. */
+    cargarEstado() {
+        if (!this.statePath)
+            return;
+        try {
+            if (!fs.existsSync(this.statePath))
+                return;
+            const raw = JSON.parse(fs.readFileSync(this.statePath, 'utf8'));
+            if (raw.day !== this.currentDay)
+                return;
+            this.requestCount = raw.requestCount ?? 0;
+            this.isLimited = raw.isLimited ?? false;
+            this.limitResetTime = raw.limitResetTime ? new Date(raw.limitResetTime) : null;
+            if (this.isLimited) {
+                logger.info('Rate limiter: se recuperó un estado de cuota agotada de esta misma jornada UTC.');
+            }
+        }
+        catch {
+            // Un estado ilegible no debe impedir arrancar: se sigue en memoria.
+        }
+    }
+    guardarEstado() {
+        if (!this.statePath)
+            return;
+        try {
+            const estado = {
+                day: this.currentDay,
+                requestCount: this.requestCount,
+                isLimited: this.isLimited,
+                limitResetTime: this.limitResetTime?.toISOString() ?? null,
+            };
+            fs.writeFileSync(this.statePath, JSON.stringify(estado), 'utf8');
+        }
+        catch {
+            // Persistir es una mejora, no un requisito: si el disco no deja, se sigue.
+        }
     }
     getTodayUTC() {
         return new Date().toISOString().split('T')[0];
     }
+    /**
+     * Espera (si es necesario) hasta que haya cupo dentro de la ventana de 1 minuto,
+     * de forma proactiva, ANTES de enviar la solicitud. Evita gatillar 429 por ráfagas.
+     */
+    async throttle() {
+        // Purgar timestamps con más de 60s de antigüedad
+        const cutoff = Date.now() - 60_000;
+        this.requestTimestamps = this.requestTimestamps.filter((t) => t > cutoff);
+        if (this.requestTimestamps.length >= this.maxPerMinute) {
+            // Esperar hasta que el request más antiguo salga de la ventana
+            const oldest = this.requestTimestamps[0];
+            const waitMs = Math.max(0, oldest + 60_000 - Date.now()) + 5;
+            logger.debug(`Rate limiter: throttling ${waitMs}ms (${this.requestTimestamps.length}/${this.maxPerMinute} req/min).`);
+            await new Promise((resolve) => setTimeout(resolve, waitMs));
+            // Repurgar tras la espera
+            const cutoff2 = Date.now() - 60_000;
+            this.requestTimestamps = this.requestTimestamps.filter((t) => t > cutoff2);
+        }
+        this.requestTimestamps.push(Date.now());
+    }
     /**
      * Registra un request exitoso. Resetea el contador si cambió el día.
      */
@@ -30,19 +110,50 @@ export class RateLimiter {
             logger.info('Rate limiter: contador diario reseteado (nuevo día calendario UTC).');
         }
         this.requestCount++;
+        // Una consulta exitosa prueba que el balde volvió a tener fichas.
+        if (this.consecutive429 > 0 || this.isLimited) {
+            this.consecutive429 = 0;
+            this.isLimited = false;
+            this.limitResetTime = null;
+        }
         logger.debug(`Rate limiter: request #${this.requestCount} del día.`);
+        this.guardarEstado();
     }
     /**
      * Marca que se recibió un error 429.
+     *
+     * ⚠ POR QUÉ NO SE BLOQUEA HASTA MAÑANA: antes, un solo 429 fijaba el reset
+     *   en las 00:01 UTC del día siguiente y `checkLimit()` rechazaba localmente
+     *   TODA consulta posterior — el MCP quedaba inutilizable durante horas sin
+     *   siquiera intentar llegar a la API. Medido en auditoría: tras un 429, la
+     *   API volvió a responder con normalidad 13 minutos después. La propia guía
+     *   oficial describe la cuota como un *token bucket* que "se recarga
+     *   automáticamente" (glosario) y manda esperar el header `Retry-After`
+     *   (§7), aunque su §4 diga que el límite es por día calendario.
+     *
+     *   Ahora se espera lo que indique `Retry-After`; si no viene, se aplica una
+     *   espera creciente (15 → 30 → 60 min, tope 2 h) que se reinicia con la
+     *   primera consulta exitosa.
+     *
+     * @param retryAfterSeconds Valor del header `Retry-After`, si la API lo envió.
      */
-    markLimited() {
+    markLimited(retryAfterSeconds) {
         this.isLimited = true;
-        const now = new Date();
-        const tomorrow = new Date(now);
-        tomorrow.setUTCDate(tomorrow.getUTCDate() + 1);
-        tomorrow.setUTCHours(0, 1, 0, 0);
-        this.limitResetTime = tomorrow;
-        logger.warn(`Rate limiter: cuota agotada. Reset estimado: ${tomorrow.toISOString()}`);
+        this.consecutive429++;
+        const esperaSegundos = retryAfterSeconds && retryAfterSeconds > 0
+            ? retryAfterSeconds
+            : this.esperaPorDefecto();
+        this.limitResetTime = new Date(Date.now() + esperaSegundos * 1000);
+        const origen = retryAfterSeconds && retryAfterSeconds > 0 ? 'header Retry-After' : 'espera progresiva local';
+        logger.warn(`Rate limiter: 429 recibido (#${this.consecutive429} consecutivo). ` +
+            `Reintentable a partir de ${this.limitResetTime.toISOString()} (${origen}).`);
+        this.guardarEstado();
+    }
+    /** Espera creciente ante 429 sucesivos, para no martillar la API. */
+    esperaPorDefecto() {
+        const escala = [15, 30, 60, 120]; // minutos
+        const i = Math.min(this.consecutive429 - 1, escala.length - 1);
+        return escala[Math.max(0, i)] * 60;
     }
     /**
      * Verifica si estamos actualmente limitados.
@@ -57,16 +168,17 @@ export class RateLimiter {
             this.limitResetTime = null;
             this.requestCount = 0;
             this.currentDay = this.getTodayUTC();
+            this.guardarEstado();
             return { limited: false };
         }
         const waitMs = this.limitResetTime
             ? this.limitResetTime.getTime() - now.getTime()
             : 0;
-        const waitHours = Math.ceil(waitMs / (1000 * 60 * 60));
-        return {
-            limited: true,
-            resetIn: `aproximadamente ${waitHours} hora(s)`,
-        };
+        const waitMin = Math.max(1, Math.ceil(waitMs / 60_000));
+        const resetIn = waitMin >= 60
+            ? `aproximadamente ${Math.ceil(waitMin / 60)} hora(s)`
+            : `aproximadamente ${waitMin} minuto(s)`;
+        return { limited: true, resetIn };
     }
     /**
      * Obtiene estadísticas del uso actual.

package/dist/utils/rate-limiter.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,wBAAwB,CAAC,CAAC;AAS7F,MAAM,OAAO,WAAW;IACd,YAAY,GAAG,CAAC,CAAC;IACjB,UAAU,CAAS;IACnB,SAAS,GAAG,KAAK,CAAC;IAClB,cAAc,GAAgB,IAAI,CAAC;IAC3C,wEAAwE;IAChE,cAAc,GAAG,CAAC,CAAC;IAE3B,oEAAoE;IACnD,YAAY,CAAS;IAC9B,iBAAiB,GAAa,EAAE,CAAC;IAEzC;;;;;;;;;OASG;IACc,SAAS,CAAgB;IAE1C,YAAY,YAAY,GAAG,EAAE,EAAE,YAA2B,IAAI;QAC5D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,yEAAyE;IACjE,YAAY;QAClB,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;gBAAE,OAAO;YAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAqB,CAAC;YACpF,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,UAAU;gBAAE,OAAO;YACxC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC;YACxC,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/E,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;YACjG,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAqB;gBAC/B,GAAG,EAAE,IAAI,CAAC,UAAU;gBACpB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,IAAI;aAC3D,CAAC;YACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;QAC7E,CAAC;IACH,CAAC;IAEO,WAAW;QACjB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,iDAAiD;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACnC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;QAE1E,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvD,+DAA+D;YAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,CAAC,KAAK,CAAC,4BAA4B,MAAM,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,YAAY,CAAC,CAAC;YACtH,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;YAC5D,0BAA0B;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;YACpC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,aAAa;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,KAAK,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,kEAAkE;QAClE,IAAI,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9C,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,0BAA0B,IAAI,CAAC,YAAY,WAAW,CAAC,CAAC;QACrE,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,WAAW,CAAC,iBAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,MAAM,cAAc,GAAG,iBAAiB,IAAI,iBAAiB,GAAG,CAAC;YAC/D,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE5B,IAAI,CAAC,cAAc,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,GAAG,IAAI,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,iBAAiB,IAAI,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,yBAAyB,CAAC;QAC7G,MAAM,CAAC,IAAI,CACT,gCAAgC,IAAI,CAAC,cAAc,iBAAiB;YACpE,4BAA4B,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,CAC7E,CAAC;QACF,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,qEAAqE;IAC7D,gBAAgB;QACtB,MAAM,MAAM,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU;QAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,cAAc,IAAI,GAAG,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc;YAChC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;YAC/C,CAAC,CAAC,CAAC,CAAC;QACN,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,OAAO,IAAI,EAAE;YAC3B,CAAC,CAAC,mBAAmB,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,UAAU;YACtD,CAAC,CAAC,mBAAmB,OAAO,YAAY,CAAC;QAE3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,IAAI;SACtD,CAAC;IACJ,CAAC;CACF"}

package/dist/utils/redact.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Redacción de secretos: punto único de estrangulamiento.
+ *
+ * POR QUÉ EXISTE
+ * El ticket de acceso viaja en la query string del endpoint legado
+ * (/servicios/.../OrdenCompra.json). Se verificó empíricamente que algunos
+ * errores de `fetch` incluyen la URL completa en su mensaje:
+ *
+ *   TypeError: Failed to parse URL from http://host/x?ticket=SECRETO
+ *
+ * Ese texto termina en la respuesta de la tool → contexto del LLM →
+ * transcripción, logs y capturas de pantalla. Auditar caso por caso cada
+ * `String(error)` es una batalla perdida: siempre aparecerá una ruta nueva.
+ *
+ * En vez de eso, TODO string que sale del proceso pasa por `redact()`.
+ * Aunque surja un camino de error imprevisto, el secreto no se escapa.
+ *
+ * Se aplica en tres puntos: el logger, el error-handler y los catch de tools.
+ */
+/**
+ * Registra un valor secreto para que sea removido de toda salida.
+ * Idempotente y seguro de llamar con undefined.
+ */
+export declare function registrarSecreto(valor: string | undefined | null): void;
+/** Solo para tests: limpia los secretos registrados. */
+export declare function _resetSecretos(): void;
+/** Cantidad de secretos registrados (diagnóstico). */
+export declare function secretosRegistrados(): number;
+/**
+ * Elimina cualquier secreto conocido de un texto.
+ *
+ * Defensa en dos capas:
+ * 1. Coincidencia exacta de los secretos registrados.
+ * 2. Patrón `ticket=<valor>` en query strings — cubre el caso en que el
+ *    secreto no alcanzó a registrarse (ej. error durante el arranque).
+ */
+export declare function redact(texto: string): string;
+/**
+ * Convierte cualquier valor lanzado en un string seguro para mostrar.
+ * Reemplaza el patrón `String(error)` usado en los catch de las tools.
+ */
+export declare function safeError(error: unknown): string;
+/**
+ * Enmascara una credencial para mostrarla como referencia sin revelarla.
+ * Ej: "abcd1234-ef56-7890" → "••••7890"
+ */
+export declare function pista(valor: string | undefined | null): string;
+//# sourceMappingURL=redact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAWvE;AAED,wDAAwD;AACxD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgB5C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUhD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAK9D"}