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

package/dist/utils/error-handler.js

@@ -4,6 +4,7 @@
  * Cada mensaje está redactado para que un agente de IA entienda
  * exactamente qué salió mal y qué acción tomar.
  */
+import { redact } from './redact.js';
 export class CompraAgilApiError extends Error {
     httpStatus;
     apiErrors;
@@ -18,8 +19,10 @@ export class CompraAgilApiError extends Error {
     }
 }
 function getActionableMessage(httpStatus, apiErrors) {
+    // El mensaje viene de la API: no se controla su contenido y podría hacer eco
+    // de la URL solicitada (que en el endpoint legado lleva el ticket en la query).
     const detail = apiErrors.length > 0
-        ? ` Detalle de la API: "${apiErrors[0].mensaje}"`
+        ? ` Detalle de la API: "${redact(apiErrors[0].mensaje ?? '')}"`
         : '';
     switch (httpStatus) {
         case 400:
@@ -29,7 +32,7 @@ function getActionableMessage(httpStatus, apiErrors) {
         case 403:
             return `Ticket de acceso inválido, inactivo o bloqueado. Verifica que el ticket sea correcto y esté vigente. Si fue bloqueado, solicita uno nuevo en https://www.chilecompra.cl/api/.${detail}`;
         case 404:
-            return `No se encontró una Compra Ágil con el código proporcionado. Verifica que el código tenga el formato correcto (ej: 1057539-228-COT26) y que el proceso exista y sea público.${detail}`;
+            return `No se encontró el recurso solicitado (Compra Ágil u Orden de Compra) con el código proporcionado. Verifica que el código sea correcto, que exista y sea público.${detail}`;
         case 429:
             return formatRateLimitMessage(detail);
         case 500:
@@ -54,10 +57,10 @@ function formatRateLimitMessage(detail) {
 export async function handleApiResponse(response) {
     if (response.ok) {
         const json = await response.json();
-        if (json.success === 'NOK') {
+        if (json && json.success === 'NOK') {
             throw new CompraAgilApiError(response.status, json.errors);
         }
-        return json.payload;
+        return (json && typeof json === 'object' && 'payload' in json) ? json.payload : json;
     }
     let apiErrors = [];
     try {

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":"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"}

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,+DAA+D;IAC/D,IAAI,IAAI,CAAC,sBAAsB,KAAK,IAAI,IAAI,IAAI,CAAC,sBAAsB,KAAK,CAAC,EAAE,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,2EAA2E;IAC3E,0DAA0D;IAC1D,IAAI,IAAI,CAAC,SAAS,EAAE,sBAAsB,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,iEAAiE;IACjE,IAAI,IAAI,CAAC,oBAAoB,KAAK,GAAG,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,sEAAsE;IACtE,IAAI,IAAI,CAAC,SAAS,EAAE,gBAAgB,IAAI,IAAI,CAAC,SAAS,EAAE,kBAAkB,EAAE,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,6BAA6B,CAAC;IAC7C,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAwB,EACxB,OAAgB;IAEhB,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC;IAC3C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACxD,CAAC;IAED,mDAAmD;IACnD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CACrD,CAAC;QACF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,gBAAgB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACjF,CAAC;AAYD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAiB;IACpD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,MAAM;QAClB,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QACZ,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5E,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;KACtB,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,SAAS,CAAC,SAAmB,EAAE,CAAS;IACtD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACrC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAgC;IACxD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACpF,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -10,8 +10,15 @@ export declare class RateLimiter {
     private currentDay;
     private isLimited;
     private limitResetTime;
-    constructor();
+    private readonly maxPerMinute;
+    private requestTimestamps;
+    constructor(maxPerMinute?: number);
     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.
      */

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;AAIH,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,YAAY,SAAK;IAK7B,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB/B;;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"}

package/dist/utils/rate-limiter.js

@@ -11,12 +11,36 @@ export class RateLimiter {
     currentDay;
     isLimited = false;
     limitResetTime = null;
-    constructor() {
+    // Throttle proactivo por minuto (ventana deslizante de timestamps).
+    maxPerMinute;
+    requestTimestamps = [];
+    constructor(maxPerMinute = 40) {
         this.currentDay = this.getTodayUTC();
+        this.maxPerMinute = maxPerMinute;
     }
     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.
      */

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":"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"}

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"}

package/dist/utils/redact.js

@@ -0,0 +1,100 @@
+/**
+ * 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.
+ */
+const MARCA = '[REDACTED]';
+/** Longitud mínima para registrar un secreto: evita redactar palabras comunes. */
+const LARGO_MINIMO = 8;
+const secretos = new Set();
+/**
+ * Registra un valor secreto para que sea removido de toda salida.
+ * Idempotente y seguro de llamar con undefined.
+ */
+export function registrarSecreto(valor) {
+    if (!valor)
+        return;
+    const v = valor.trim();
+    // Un secreto muy corto redactaría texto legítimo por coincidencia.
+    if (v.length < LARGO_MINIMO)
+        return;
+    secretos.add(v);
+    // La misma credencial puede aparecer URL-encodeada dentro de una URL.
+    const encoded = encodeURIComponent(v);
+    if (encoded !== v)
+        secretos.add(encoded);
+}
+/** Solo para tests: limpia los secretos registrados. */
+export function _resetSecretos() {
+    secretos.clear();
+}
+/** Cantidad de secretos registrados (diagnóstico). */
+export function secretosRegistrados() {
+    return secretos.size;
+}
+/**
+ * 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 function redact(texto) {
+    if (!texto)
+        return texto;
+    let out = texto;
+    for (const s of secretos) {
+        if (out.includes(s)) {
+            out = out.split(s).join(MARCA);
+        }
+    }
+    // Capa 2: cualquier ticket= en una URL, esté o no registrado.
+    out = out.replace(/([?&]ticket=)[^&\s"'<>)\]]+/gi, `$1${MARCA}`);
+    // Capa 2b: header/JSON con forma "ticket": "valor"
+    out = out.replace(/(["']?ticket["']?\s*[:=]\s*["'])([^"']+)(["'])/gi, `$1${MARCA}$3`);
+    return out;
+}
+/**
+ * Convierte cualquier valor lanzado en un string seguro para mostrar.
+ * Reemplaza el patrón `String(error)` usado en los catch de las tools.
+ */
+export function safeError(error) {
+    let base;
+    if (error instanceof Error) {
+        // El `cause` de undici puede traer detalle útil (y potencialmente la URL).
+        const cause = error.cause;
+        base = cause ? `${error.message} (${String(cause)})` : error.message;
+    }
+    else {
+        base = String(error);
+    }
+    return redact(base);
+}
+/**
+ * Enmascara una credencial para mostrarla como referencia sin revelarla.
+ * Ej: "abcd1234-ef56-7890" → "••••7890"
+ */
+export function pista(valor) {
+    if (!valor)
+        return '(no configurado)';
+    const v = valor.trim();
+    if (v.length <= 4)
+        return '••••';
+    return `••••${v.slice(-4)}`;
+}
+//# sourceMappingURL=redact.js.map

package/dist/utils/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,KAAK,GAAG,YAAY,CAAC;AAE3B,kFAAkF;AAClF,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,mEAAmE;IACnE,IAAI,CAAC,CAAC,MAAM,GAAG,YAAY;QAAE,OAAO;IAEpC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEhB,sEAAsE;IACtE,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,OAAO,KAAK,CAAC;QAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc;IAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,mBAAmB;IACjC,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,GAAG,GAAG,KAAK,CAAC;IAEhB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,+BAA+B,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC;IACjE,mDAAmD;IACnD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kDAAkD,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;IAEtF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,IAAY,CAAC;IACjB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,2EAA2E;QAC3E,MAAM,KAAK,GAAI,KAAqC,CAAC,KAAK,CAAC;QAC3D,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IACvE,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,KAAgC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,kBAAkB,CAAC;IACtC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACjC,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9B,CAAC"}