@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/web/busqueda-nativa.js

@@ -0,0 +1,163 @@
+/**
+ * Búsqueda web con la credencial que el usuario YA tiene.
+ *
+ * Hasta ahora `web_search` exigía una clave de Serper aparte, así que la
+ * respuesta de fábrica era «Búsqueda web no configurada». Un agente de código
+ * que no puede mirar la documentación de una librería está cojo, y pedir una
+ * segunda cuenta para eso es una fricción que el usuario paga antes de haber
+ * visto ningún valor.
+ *
+ * Los modelos de Anthropic traen búsqueda de servidor (`web_search_20250305`).
+ * Si hay credencial de Anthropic —y la hay, porque es con lo que corre el
+ * agente— buscar puede funcionar sin configurar nada.
+ *
+ * Dos detalles que no son evidentes y que se descubrieron probándolo:
+ *
+ * 1. **Los resultados no llegan por el contenido del mensaje.** Nuestra capa de
+ *    modelos normaliza la respuesta a texto/razonamiento/llamadas, y los
+ *    bloques `web_search_tool_result` se pierden por el camino. Pedirle al
+ *    modelo que los liste en el texto tampoco vale: se probó, y contesta la
+ *    pregunta en vez de listar fuentes. Hay que leer el flujo crudo.
+ *
+ * 2. **Se lee sin tocar la capa de modelos**, pasando un `fetch` propio que
+ *    duplica el cuerpo con `tee()`: una rama sigue al SDK intacta y la otra se
+ *    analiza aquí. `agent-session.ts` y `packages/ai` son de upstream y el
+ *    presupuesto de fork está en el tope; esto no cuesta ni un hunk.
+ */
+/** La tool de servidor de Anthropic. */
+const TOOL_BUSQUEDA = "web_search_20250305";
+/** Proveedores cuyo modelo sabe buscar por su cuenta. */
+export function soportaBusquedaNativa(proveedor) {
+    return proveedor === "anthropic";
+}
+/**
+ * Añade la tool de búsqueda a la carga de la petición, sin pisar las que haya.
+ *
+ * Pura y separada para poder probarla: si esto machacara `tools`, el modelo se
+ * quedaría sin sus herramientas y el fallo aparecería en cualquier otro sitio.
+ */
+export function conToolDeBusqueda(carga, maxUsos = 5) {
+    if (!carga || typeof carga !== "object")
+        return carga;
+    const p = carga;
+    p.tools = [...(p.tools ?? []), { type: TOOL_BUSQUEDA, name: "web_search", max_uses: maxUsos }];
+    return p;
+}
+/**
+ * Recorre cualquier estructura y recoge los resultados de búsqueda.
+ *
+ * Se busca por el campo `type` en vez de por la ruta exacta del evento a
+ * propósito: el formato de los eventos SSE puede cambiar de sitio los bloques,
+ * y un recolector que dependa de la ruta se rompe en silencio —devolviendo cero
+ * resultados, que se lee igual que «no hay nada»—.
+ */
+export function recolectarResultados(valor, acumulado = []) {
+    if (Array.isArray(valor)) {
+        for (const v of valor)
+            recolectarResultados(v, acumulado);
+        return acumulado;
+    }
+    if (!valor || typeof valor !== "object")
+        return acumulado;
+    const o = valor;
+    if (o.type === "web_search_result" && typeof o.url === "string") {
+        acumulado.push({
+            titulo: typeof o.title === "string" ? o.title : o.url,
+            url: o.url,
+            edad: typeof o.page_age === "string" ? o.page_age : undefined,
+        });
+    }
+    for (const v of Object.values(o))
+        recolectarResultados(v, acumulado);
+    return acumulado;
+}
+/** Quita repetidos por URL, conservando el orden de aparición. */
+export function sinRepetidos(resultados) {
+    const vistas = new Set();
+    const unicos = [];
+    for (const r of resultados) {
+        if (vistas.has(r.url))
+            continue;
+        vistas.add(r.url);
+        unicos.push(r);
+    }
+    return unicos;
+}
+/**
+ * Envuelve un `fetch` para leer los resultados sin estorbar a quien lo usa.
+ *
+ * `tee()` da dos flujos: uno se devuelve intacto —el SDK tiene que recibir
+ * exactamente lo que habría recibido— y el otro se analiza aquí. Si el análisis
+ * falla, falla solo: una búsqueda sin fuentes es peor que una con fuentes, pero
+ * una sesión rota por el analizador es mucho peor que las dos.
+ */
+export function fetchQueRecolecta(base, destino) {
+    return async (...args) => {
+        const respuesta = await base(...args);
+        if (!respuesta.body)
+            return respuesta;
+        const [paraElSdk, paraNosotros] = respuesta.body.tee();
+        void (async () => {
+            const lector = paraNosotros.getReader();
+            const decodificador = new TextDecoder();
+            let pendiente = "";
+            try {
+                for (;;) {
+                    const { done, value } = await lector.read();
+                    if (done)
+                        break;
+                    pendiente += decodificador.decode(value, { stream: true });
+                    const lineas = pendiente.split("\n");
+                    // La última puede estar a medias: se queda para la próxima vuelta.
+                    pendiente = lineas.pop() ?? "";
+                    for (const linea of lineas) {
+                        if (!linea.startsWith("data: "))
+                            continue;
+                        try {
+                            recolectarResultados(JSON.parse(linea.slice(6)), destino);
+                        }
+                        catch {
+                            // Una línea que no es JSON no dice nada del resto del flujo.
+                        }
+                    }
+                }
+                // El flujo puede acabar sin salto final, y entonces el último evento
+                // se queda en `pendiente`. Perderlo silenciosamente equivaldría a
+                // devolver una fuente menos sin que nadie lo note.
+                if (pendiente.startsWith("data: ")) {
+                    try {
+                        recolectarResultados(JSON.parse(pendiente.slice(6)), destino);
+                    }
+                    catch {
+                        // Una cola incompleta no es un error: es una cola incompleta.
+                    }
+                }
+            }
+            catch {
+                // La rama de análisis nunca puede tumbar la petición.
+            }
+        })();
+        return new Response(paraElSdk, {
+            status: respuesta.status,
+            statusText: respuesta.statusText,
+            headers: respuesta.headers,
+        });
+    };
+}
+/**
+ * Busca y devuelve las fuentes.
+ *
+ * No devuelve la síntesis del modelo a propósito: quien llama es el agente, que
+ * ya sabe leer. Lo que necesita de una búsqueda son URLs a las que ir con
+ * `web_fetch`, no un resumen de segunda mano que ya viene con la
+ * interpretación de otro modelo encima.
+ */
+export async function buscarConElModelo(consulta, deps) {
+    const encontrados = [];
+    await deps.completar(consulta, {
+        fetch: fetchQueRecolecta(deps.fetchBase ?? fetch, encontrados),
+        onPayload: (carga) => conToolDeBusqueda(carga),
+    });
+    return sinRepetidos(encontrados).slice(0, deps.maxResultados ?? 10);
+}
+//# sourceMappingURL=busqueda-nativa.js.map

package/dist/core/web/busqueda-nativa.js.map

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

package/dist/core/web/consulta.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Parser Google-style para `web_search`.
+ *
+ * WEB-01 — El agente no puede usar operadores Google tal cual: los proveedores
+ * gratuitos (DDG/Mojeek/Ecosia) no los interpretan todos y el modelo los manda
+ * como una sola bolsa. Este parser los extrae para que:
+ *   1) la consulta que viaja a cada proveedor lleve la forma precisa que espera,
+ *   2) el agregador pueda filtrar en cliente lo que el proveedor ignore,
+ *   3) el audit pueda trazar qué filtro se aplicó sin copiar la URL completa.
+ *
+ * Operadores soportados:
+ *   site:example.com | filetype:pdf | ext:pdf
+ *   "frase exacta" | -term | -"frase exacta"
+ *   OR entre términos (a OR b OR c → orGrupos: [["a","b","c"]])
+ *   after:YYYY-MM-DD | before:YYYY-MM-DD  (también YYYY/MM/DD y YYYY-MM-DD)
+ *
+ * Sin dependencias; puro y testeable sin red.
+ */
+export interface ConsultaParseada {
+    /** Tal cual llegó. */
+    original: string;
+    /** Texto libre sin operadores ni frases entre comillas (ya sin OR). */
+    textoLibre: string;
+    /** Palabras sueltas del texto libre. */
+    terminos: string[];
+    /** Frases entre comillas con contenido. */
+    frasesExactas: string[];
+    /** Términos/frases con prefijo `-`. Incluye frases exactas excluidas sin comillas. */
+    excluidos: string[];
+    /** Dominio de `site:` (último gana). */
+    site?: string;
+    /** Extensión de `filetype:` / `ext:` (sin punto, minúsculas). */
+    filetype?: string;
+    /** `after:` tal cual (normalizado a YYYY-MM-DD si es parseable). */
+    after?: string;
+    /** `before:` tal cual. */
+    before?: string;
+    /** Grupos OR en orden de aparición. Cada grupo tiene ≥2 alternativas. */
+    orGrupos: string[][];
+}
+/**
+ * Parsea una consulta Google-style. Nunca lanza: con entrada vacía devuelve
+ * una estructura vacía.
+ */
+export declare function parsearConsulta(consulta: string): ConsultaParseada;
+/**
+ * Reconstruye una consulta normalizada apta para proveedores que sí entienden
+ * Google-style. Mantiene frases entre comillas y operadores canónicos.
+ */
+export declare function serializarConsulta(p: ConsultaParseada): string;
+/** Atajo: `true` si la consulta trae algún operador Google-style. */
+export declare function tieneOperadores(p: ConsultaParseada): boolean;
+//# sourceMappingURL=consulta.d.ts.map

package/dist/core/web/consulta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consulta.d.ts","sourceRoot":"","sources":["../../../src/core/web/consulta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,gBAAgB;IAChC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,sFAAsF;IACtF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;CACrB;AAiBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA4IlE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAgB9D;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAI5D"}

package/dist/core/web/consulta.js

@@ -0,0 +1,213 @@
+/**
+ * Parser Google-style para `web_search`.
+ *
+ * WEB-01 — El agente no puede usar operadores Google tal cual: los proveedores
+ * gratuitos (DDG/Mojeek/Ecosia) no los interpretan todos y el modelo los manda
+ * como una sola bolsa. Este parser los extrae para que:
+ *   1) la consulta que viaja a cada proveedor lleve la forma precisa que espera,
+ *   2) el agregador pueda filtrar en cliente lo que el proveedor ignore,
+ *   3) el audit pueda trazar qué filtro se aplicó sin copiar la URL completa.
+ *
+ * Operadores soportados:
+ *   site:example.com | filetype:pdf | ext:pdf
+ *   "frase exacta" | -term | -"frase exacta"
+ *   OR entre términos (a OR b OR c → orGrupos: [["a","b","c"]])
+ *   after:YYYY-MM-DD | before:YYYY-MM-DD  (también YYYY/MM/DD y YYYY-MM-DD)
+ *
+ * Sin dependencias; puro y testeable sin red.
+ */
+/** Normaliza YYYY/MM/DD → YYYY-MM-DD; si no es fecha válida, lo deja tal cual. */
+function normalizarFecha(raw) {
+    const v = raw.replaceAll("/", "-");
+    if (/^\d{4}-\d{2}-\d{2}$/.test(v)) {
+        const d = new Date(v);
+        if (!Number.isNaN(d.getTime()))
+            return v;
+    }
+    return raw;
+}
+function stripComillas(v) {
+    if (v.length >= 2 && v.startsWith('"') && v.endsWith('"'))
+        return v.slice(1, -1);
+    return v;
+}
+/**
+ * Parsea una consulta Google-style. Nunca lanza: con entrada vacía devuelve
+ * una estructura vacía.
+ */
+export function parsearConsulta(consulta) {
+    const original = consulta;
+    const frasesExactas = [];
+    const excluidos = [];
+    const orGrupos = [];
+    let site;
+    let filetype;
+    let after;
+    let before;
+    if (!consulta || !consulta.trim()) {
+        return {
+            original,
+            textoLibre: "",
+            terminos: [],
+            frasesExactas,
+            excluidos,
+            orGrupos,
+        };
+    }
+    let trabajo = consulta;
+    // 1. Frases entre comillas, con o sin `-` delante.
+    //    -"foo bar" → excluida; "foo bar" → incluida.
+    const frases = [];
+    trabajo = trabajo.replace(/(-?)"([^"]+)"/g, (_m, pref, contenido) => {
+        const excluida = pref === "-";
+        const t = contenido.trim();
+        if (t)
+            frases.push({ texto: t, excluida });
+        return " ";
+    });
+    for (const f of frases) {
+        if (f.excluida)
+            excluidos.push(f.texto);
+        else
+            frasesExactas.push(f.texto);
+    }
+    // 2. Operadores clave:valor. Valor puede ser "quoted" o \S+.
+    //    Soporta site:, filetype:, ext:, after:, before: (case-insensitive).
+    //    Prefijo `-` delante (p.ej. -site:spam.com) se trata como exclusión
+    //    y NO fija el filtro positivo.
+    const reOp = /(^|\s)(-?)(site|filetype|ext|after|before):("[^"]*"|\S+)/gi;
+    // Recolectar primero para no mutar mientras iteramos con índice.
+    const ops = [];
+    for (let m = reOp.exec(trabajo); m !== null; m = reOp.exec(trabajo)) {
+        ops.push({ neg: m[2] === "-", clave: m[3].toLowerCase(), rawValor: m[4] });
+    }
+    // Eliminar del texto de trabajo.
+    trabajo = trabajo.replace(reOp, " ");
+    for (const op of ops) {
+        const valor = stripComillas(op.rawValor).trim();
+        if (!valor)
+            continue;
+        if (op.neg) {
+            // Solo -site/-filetype tienen sentido como exclusión en nuestro
+            // criterio de filtrado; el resto se guarda como excluido genérico.
+            if (op.clave === "site" || op.clave === "filetype" || op.clave === "ext") {
+                excluidos.push(`${op.clave}:${valor}`);
+            }
+            else {
+                excluidos.push(valor);
+            }
+            continue;
+        }
+        switch (op.clave) {
+            case "site":
+                site = valor.replace(/^https?:\/\//i, "").replace(/\/$/, "");
+                break;
+            case "filetype":
+            case "ext":
+                filetype = valor.replace(/^\./, "").toLowerCase();
+                break;
+            case "after":
+                after = normalizarFecha(valor);
+                break;
+            case "before":
+                before = normalizarFecha(valor);
+                break;
+        }
+    }
+    // 3. Términos excluidos sueltos: -word (no entre comillas, esas ya salieron).
+    const reExcl = /(^|\s)-(\S+)/g;
+    const exclSueltos = [];
+    for (let ex = reExcl.exec(trabajo); ex !== null; ex = reExcl.exec(trabajo)) {
+        const v = ex[2].trim();
+        // Evitar capturar el "-" que queda de "--" o "-".
+        if (v && v !== "-")
+            exclSueltos.push(v);
+    }
+    trabajo = trabajo.replace(reExcl, " ");
+    for (const e of exclSueltos)
+        excluidos.push(e);
+    // 4. Grupos OR. `OR` es case-sensitive según Google (mayúsculas), pero
+    //    aquí se acepta case-insensitive para tolerancia, excepto dentro de
+    //    frases (que ya salieron).
+    //    "a OR b OR c" → [["a","b","c"]].  Términos sueltos sin OR no forman grupo.
+    const libreParaOr = trabajo.trim();
+    if (libreParaOr) {
+        // Tokenizar preservando OR como token separado.
+        const tokens = libreParaOr.split(/\s+/).filter(Boolean);
+        const restos = [];
+        let i = 0;
+        while (i < tokens.length) {
+            // Mirar si hay patrón  X (OR Y)+
+            if (i + 2 < tokens.length && tokens[i + 1].toUpperCase() === "OR") {
+                const grupo = [tokens[i]];
+                let j = i + 1;
+                while (j + 1 < tokens.length && tokens[j].toUpperCase() === "OR") {
+                    grupo.push(tokens[j + 1]);
+                    j += 2;
+                }
+                // Solo guardar si al menos 2 alternativas reales (y OR entre ellas)
+                if (grupo.length >= 2) {
+                    orGrupos.push(grupo);
+                    i = j;
+                    continue;
+                }
+            }
+            // Token suelto que no inicia un grupo OR
+            if (tokens[i].toUpperCase() !== "OR")
+                restos.push(tokens[i]);
+            // Un "OR" huérfano sin lado válido se ignora
+            i++;
+        }
+        trabajo = restos.join(" ");
+    }
+    const textoLibre = trabajo.trim().replace(/\s+/g, " ");
+    const terminos = textoLibre ? textoLibre.split(/\s+/).filter(Boolean) : [];
+    return {
+        original,
+        textoLibre,
+        terminos,
+        frasesExactas,
+        excluidos,
+        site,
+        filetype,
+        after: after ? normalizarFecha(after) : undefined,
+        before: before ? normalizarFecha(before) : undefined,
+        orGrupos,
+    };
+}
+/**
+ * Reconstruye una consulta normalizada apta para proveedores que sí entienden
+ * Google-style. Mantiene frases entre comillas y operadores canónicos.
+ */
+export function serializarConsulta(p) {
+    const partes = [];
+    if (p.textoLibre)
+        partes.push(p.textoLibre);
+    for (const f of p.frasesExactas)
+        partes.push(`"${f}"`);
+    for (const g of p.orGrupos)
+        partes.push(g.join(" OR "));
+    for (const e of p.excluidos) {
+        // Si ya es `site:…` lo dejamos con `-`
+        if (e.includes(":"))
+            partes.push(`-${e}`);
+        else if (e.includes(" "))
+            partes.push(`-"${e}"`);
+        else
+            partes.push(`-${e}`);
+    }
+    if (p.site)
+        partes.push(`site:${p.site}`);
+    if (p.filetype)
+        partes.push(`filetype:${p.filetype}`);
+    if (p.after)
+        partes.push(`after:${p.after}`);
+    if (p.before)
+        partes.push(`before:${p.before}`);
+    return partes.join(" ").trim();
+}
+/** Atajo: `true` si la consulta trae algún operador Google-style. */
+export function tieneOperadores(p) {
+    return Boolean(p.site || p.filetype || p.after || p.before || p.frasesExactas.length || p.excluidos.length || p.orGrupos.length);
+}
+//# sourceMappingURL=consulta.js.map

package/dist/core/web/consulta.js.map

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

package/dist/core/web/destino.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ¿A dónde va de verdad esta URL?
+ *
+ * EL FALLO. `assertFetchableUrl` compara el NOMBRE del host contra una lista y
+ * unas expresiones regulares. Eso para lo evidente y deja pasar todo lo que
+ * llega a la misma dirección por otro camino. Medido sobre nuestra guarda:
+ *
+ *     http://127.0.0.1:8080/secreto          bloqueado
+ *     http://localhost:8080/secreto          bloqueado
+ *     http://[::1]:8080/secreto              bloqueado
+ *     http://[::ffff:127.0.0.1]:8080/secreto PASA   ← IPv4 mapeada en IPv6
+ *     http://localtest.me:8080/secreto       PASA   ← resuelve a 127.0.0.1
+ *
+ * Y había un tercero: `redirect: "follow"`. Una URL pública que responde 302
+ * hacia loopback llega igual, porque la guarda solo mira la primera.
+ *
+ * Para un agente esto es serio: el modelo puede pedir una descarga con una URL
+ * que parece de internet y acabar leyendo el panel de administración de la red
+ * interna, o el endpoint de metadatos de la nube — que es donde viven las
+ * credenciales de la máquina.
+ *
+ * LA CAUSA RAÍZ, y por eso este módulo existe aparte: un nombre no es un
+ * destino. Lo único que dice a dónde va una petición es la DIRECCIÓN a la que
+ * resuelve, así que hay que resolverla y mirarla. Las comprobaciones por nombre
+ * se quedan, pero como filtro barato de primera pasada, no como la defensa.
+ *
+ * LO QUE NO RESUELVE, dicho antes de que lo descubra nadie: entre que
+ * resolvemos y que la petición sale, el DNS puede cambiar de respuesta —el
+ * ataque clásico de «rebind». Cerrarlo del todo exige fijar la dirección
+ * resuelta al abrir la conexión, que es cosa del agente HTTP y no de aquí.
+ * Contra un servidor hostil que controle su propio DNS esto sube el listón; no
+ * lo cierra.
+ */
+/**
+ * Valida una URL antes de pedirla.
+ *
+ * Bloquea esquemas no-HTTP, loopback, rangos privados y el endpoint de metadatos
+ * de los proveedores cloud — que es el objetivo clásico de un SSRF y devuelve
+ * credenciales de la instancia.
+ *
+ * Vive aquí (y no solo en `tools.ts`) para que `load-page.ts` pueda usar la
+ * MISMA guarda sin importar ciclos: `tools.ts` la re-exporta por compatibilidad.
+ */
+export declare function assertFetchableUrl(raw: string): URL;
+/** Por qué se rechaza un destino. Nunca una lista vacía silenciosa. */
+export interface DestinoRechazado {
+    motivo: string;
+    /** La dirección concreta que lo delató, cuando la hay. */
+    direccion?: string;
+}
+/**
+ * ¿Esta dirección IP es de una red que no debe alcanzarse desde una tool web?
+ *
+ * Se trabaja sobre la dirección ya resuelta, así que da igual cómo se escribió
+ * el host: decimal, octal, mapeada en IPv6 o un dominio que apunta ahí.
+ */
+export declare function direccionInterna(ip: string): string | null;
+/**
+ * Resuelve el host y comprueba TODAS las direcciones que devuelve.
+ *
+ * Todas, no la primera: un dominio puede devolver una dirección pública y otra
+ * interna, y quedarse con una sola convierte la defensa en una moneda al aire.
+ *
+ * Un fallo de resolución NO es un permiso. Se devuelve rechazo con su motivo:
+ * «no he podido comprobarlo» y «está bien» son cosas distintas, y aquí
+ * confundirlas es abrir la puerta.
+ */
+export declare function destinoPermitido(url: URL): Promise<DestinoRechazado | null>;
+//# sourceMappingURL=destino.d.ts.map

package/dist/core/web/destino.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destino.d.ts","sourceRoot":"","sources":["../../../src/core/web/destino.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAUH;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAmBnD;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwC1D;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAwBjF"}