@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/web/destino.js

@@ -0,0 +1,127 @@
+/**
+ * ¿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.
+ */
+import { lookup } from "node:dns/promises";
+/**
+ * ¿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 function direccionInterna(ip) {
+    const limpia = ip.toLowerCase().replace(/^\[|\]$/g, "");
+    // IPv4 mapeada en IPv6: se desenvuelve y se juzga como IPv4, que es lo que
+    // era. Sin esto, `[::ffff:127.0.0.1]` pasaba entera.
+    //
+    // Hay que cubrir LAS DOS FORMAS, y esto casi se me escapa: `new URL()`
+    // normaliza `[::ffff:127.0.0.1]` a `[::ffff:7f00:1]`, en hexadecimal. Una
+    // guarda que solo mirara la forma decimal daría verde sobre la única forma
+    // que llega de verdad desde una URL.
+    let dir = limpia;
+    const decimal = limpia.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);
+    if (decimal) {
+        dir = decimal[1];
+    }
+    else {
+        const hex = limpia.match(/^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);
+        if (hex) {
+            const alto = Number.parseInt(hex[1], 16);
+            const bajo = Number.parseInt(hex[2], 16);
+            dir = `${alto >> 8}.${alto & 0xff}.${bajo >> 8}.${bajo & 0xff}`;
+        }
+    }
+    if (/^\d+\.\d+\.\d+\.\d+$/.test(dir)) {
+        const [a, b] = dir.split(".").map(Number);
+        if (a === 127)
+            return "loopback";
+        if (a === 10)
+            return "red privada (10/8)";
+        if (a === 172 && b >= 16 && b <= 31)
+            return "red privada (172.16/12)";
+        if (a === 192 && b === 168)
+            return "red privada (192.168/16)";
+        if (a === 169 && b === 254)
+            return "enlace local (169.254/16), donde vive el endpoint de metadatos";
+        if (a === 100 && b >= 64 && b <= 127)
+            return "CGNAT (100.64/10)";
+        if (a === 0)
+            return "esta red (0/8)";
+        return null;
+    }
+    if (dir === "::1" || dir === "::")
+        return "loopback IPv6";
+    // `fc00::/7` son las direcciones únicas locales; `fe80::/10`, el enlace local.
+    if (/^f[cd]/.test(dir))
+        return "red privada IPv6 (fc00::/7)";
+    if (/^fe[89ab]/.test(dir))
+        return "enlace local IPv6 (fe80::/10)";
+    return 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 async function destinoPermitido(url) {
+    const host = url.hostname.toLowerCase().replace(/^\[|\]$/g, "");
+    // Si el host YA es una dirección, no hay nada que resolver.
+    const directa = direccionInterna(host);
+    if (directa)
+        return { motivo: directa, direccion: host };
+    if (/^[\d.]+$/.test(host) || host.includes(":"))
+        return null;
+    let direcciones;
+    try {
+        direcciones = await lookup(host, { all: true });
+    }
+    catch (error) {
+        return {
+            motivo: `no se ha podido resolver el nombre (${error.code ?? "error"}), y sin saber a dónde apunta no se descarga`,
+        };
+    }
+    if (direcciones.length === 0) {
+        return { motivo: "el nombre no resuelve a ninguna dirección" };
+    }
+    for (const { address } of direcciones) {
+        const que = direccionInterna(address);
+        if (que)
+            return { motivo: `el nombre resuelve a ${que}`, direccion: address };
+    }
+    return null;
+}
+//# sourceMappingURL=destino.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"destino.js","sourceRoot":"","sources":["../../../src/core/web/destino.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ¿A dónde va de verdad esta URL?\n *\n * EL FALLO. `assertFetchableUrl` compara el NOMBRE del host contra una lista y\n * unas expresiones regulares. Eso para lo evidente y deja pasar todo lo que\n * llega a la misma dirección por otro camino. Medido sobre nuestra guarda:\n *\n *     http://127.0.0.1:8080/secreto          bloqueado\n *     http://localhost:8080/secreto          bloqueado\n *     http://[::1]:8080/secreto              bloqueado\n *     http://[::ffff:127.0.0.1]:8080/secreto PASA   ← IPv4 mapeada en IPv6\n *     http://localtest.me:8080/secreto       PASA   ← resuelve a 127.0.0.1\n *\n * Y había un tercero: `redirect: \"follow\"`. Una URL pública que responde 302\n * hacia loopback llega igual, porque la guarda solo mira la primera.\n *\n * Para un agente esto es serio: el modelo puede pedir una descarga con una URL\n * que parece de internet y acabar leyendo el panel de administración de la red\n * interna, o el endpoint de metadatos de la nube — que es donde viven las\n * credenciales de la máquina.\n *\n * LA CAUSA RAÍZ, y por eso este módulo existe aparte: un nombre no es un\n * destino. Lo único que dice a dónde va una petición es la DIRECCIÓN a la que\n * resuelve, así que hay que resolverla y mirarla. Las comprobaciones por nombre\n * se quedan, pero como filtro barato de primera pasada, no como la defensa.\n *\n * LO QUE NO RESUELVE, dicho antes de que lo descubra nadie: entre que\n * resolvemos y que la petición sale, el DNS puede cambiar de respuesta —el\n * ataque clásico de «rebind». Cerrarlo del todo exige fijar la dirección\n * resuelta al abrir la conexión, que es cosa del agente HTTP y no de aquí.\n * Contra un servidor hostil que controle su propio DNS esto sube el listón; no\n * lo cierra.\n */\n\nimport { lookup } from \"node:dns/promises\";\n\n/** Por qué se rechaza un destino. Nunca una lista vacía silenciosa. */\nexport interface DestinoRechazado {\n\tmotivo: string;\n\t/** La dirección concreta que lo delató, cuando la hay. */\n\tdireccion?: string;\n}\n\n/**\n * ¿Esta dirección IP es de una red que no debe alcanzarse desde una tool web?\n *\n * Se trabaja sobre la dirección ya resuelta, así que da igual cómo se escribió\n * el host: decimal, octal, mapeada en IPv6 o un dominio que apunta ahí.\n */\nexport function direccionInterna(ip: string): string | null {\n\tconst limpia = ip.toLowerCase().replace(/^\\[|\\]$/g, \"\");\n\n\t// IPv4 mapeada en IPv6: se desenvuelve y se juzga como IPv4, que es lo que\n\t// era. Sin esto, `[::ffff:127.0.0.1]` pasaba entera.\n\t//\n\t// Hay que cubrir LAS DOS FORMAS, y esto casi se me escapa: `new URL()`\n\t// normaliza `[::ffff:127.0.0.1]` a `[::ffff:7f00:1]`, en hexadecimal. Una\n\t// guarda que solo mirara la forma decimal daría verde sobre la única forma\n\t// que llega de verdad desde una URL.\n\tlet dir = limpia;\n\tconst decimal = limpia.match(/^::ffff:(\\d+\\.\\d+\\.\\d+\\.\\d+)$/);\n\tif (decimal) {\n\t\tdir = decimal[1];\n\t} else {\n\t\tconst hex = limpia.match(/^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);\n\t\tif (hex) {\n\t\t\tconst alto = Number.parseInt(hex[1], 16);\n\t\t\tconst bajo = Number.parseInt(hex[2], 16);\n\t\t\tdir = `${alto >> 8}.${alto & 0xff}.${bajo >> 8}.${bajo & 0xff}`;\n\t\t}\n\t}\n\n\tif (/^\\d+\\.\\d+\\.\\d+\\.\\d+$/.test(dir)) {\n\t\tconst [a, b] = dir.split(\".\").map(Number);\n\t\tif (a === 127) return \"loopback\";\n\t\tif (a === 10) return \"red privada (10/8)\";\n\t\tif (a === 172 && b >= 16 && b <= 31) return \"red privada (172.16/12)\";\n\t\tif (a === 192 && b === 168) return \"red privada (192.168/16)\";\n\t\tif (a === 169 && b === 254) return \"enlace local (169.254/16), donde vive el endpoint de metadatos\";\n\t\tif (a === 100 && b >= 64 && b <= 127) return \"CGNAT (100.64/10)\";\n\t\tif (a === 0) return \"esta red (0/8)\";\n\t\treturn null;\n\t}\n\n\tif (dir === \"::1\" || dir === \"::\") return \"loopback IPv6\";\n\t// `fc00::/7` son las direcciones únicas locales; `fe80::/10`, el enlace local.\n\tif (/^f[cd]/.test(dir)) return \"red privada IPv6 (fc00::/7)\";\n\tif (/^fe[89ab]/.test(dir)) return \"enlace local IPv6 (fe80::/10)\";\n\treturn null;\n}\n\n/**\n * Resuelve el host y comprueba TODAS las direcciones que devuelve.\n *\n * Todas, no la primera: un dominio puede devolver una dirección pública y otra\n * interna, y quedarse con una sola convierte la defensa en una moneda al aire.\n *\n * Un fallo de resolución NO es un permiso. Se devuelve rechazo con su motivo:\n * «no he podido comprobarlo» y «está bien» son cosas distintas, y aquí\n * confundirlas es abrir la puerta.\n */\nexport async function destinoPermitido(url: URL): Promise<DestinoRechazado | null> {\n\tconst host = url.hostname.toLowerCase().replace(/^\\[|\\]$/g, \"\");\n\n\t// Si el host YA es una dirección, no hay nada que resolver.\n\tconst directa = direccionInterna(host);\n\tif (directa) return { motivo: directa, direccion: host };\n\tif (/^[\\d.]+$/.test(host) || host.includes(\":\")) return null;\n\n\tlet direcciones: Array<{ address: string }>;\n\ttry {\n\t\tdirecciones = await lookup(host, { all: true });\n\t} catch (error) {\n\t\treturn {\n\t\t\tmotivo: `no se ha podido resolver el nombre (${(error as NodeJS.ErrnoException).code ?? \"error\"}), y sin saber a dónde apunta no se descarga`,\n\t\t};\n\t}\n\tif (direcciones.length === 0) {\n\t\treturn { motivo: \"el nombre no resuelve a ninguna dirección\" };\n\t}\n\tfor (const { address } of direcciones) {\n\t\tconst que = direccionInterna(address);\n\t\tif (que) return { motivo: `el nombre resuelve a ${que}`, direccion: address };\n\t}\n\treturn null;\n}\n"]}

package/dist/core/web/proveedores/brave.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Brave Search API. Requiere clave (`brave` en el vault, o BRAVE_API_KEY).
+ */
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=brave.d.ts.map

package/dist/core/web/proveedores/brave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/brave.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAQpE,eAAO,MAAM,MAAM,EAAE,aAepB,CAAC","sourcesContent":["/**\n * Brave Search API. Requiere clave (`brave` en el vault, o BRAVE_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.search.brave.com/res/v1/web/search\";\n\ninterface RespuestaBrave {\n\tweb?: { results?: Array<{ title?: string; url?: string; description?: string }> };\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Brave requiere clave.\");\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\turl.searchParams.set(\"count\", String(Math.min(Math.max(maximo, 1), 20)));\n\tconst respuesta = await fetchImpl(url, {\n\t\theaders: { Accept: \"application/json\", \"X-Subscription-Token\": clave },\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Brave respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaBrave;\n\tconst resultados: ResultadoProveedor[] = (datos.web?.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.description }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/brave.js

@@ -0,0 +1,20 @@
+const ENDPOINT = "https://api.search.brave.com/res/v1/web/search";
+export const buscar = async (consulta, maximo, clave, fetchImpl, signal) => {
+    if (!clave)
+        throw new Error("Brave requiere clave.");
+    const url = new URL(ENDPOINT);
+    url.searchParams.set("q", consulta);
+    url.searchParams.set("count", String(Math.min(Math.max(maximo, 1), 20)));
+    const respuesta = await fetchImpl(url, {
+        headers: { Accept: "application/json", "X-Subscription-Token": clave },
+        signal,
+    });
+    if (!respuesta.ok)
+        throw new Error(`Brave respondió HTTP ${respuesta.status}.`);
+    const datos = (await respuesta.json());
+    const resultados = (datos.web?.results ?? [])
+        .filter((r) => typeof r.url === "string" && r.url)
+        .map((r) => ({ titulo: r.title || r.url, url: r.url, resumen: r.description }));
+    return resultados.slice(0, maximo);
+};
+//# sourceMappingURL=brave.js.map

package/dist/core/web/proveedores/brave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/brave.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAG,gDAAgD,CAAC;AAMlE,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1F,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;QACtC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,KAAK,EAAE;QACtE,MAAM;KACN,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAwB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAmB,CAAC;IACzD,MAAM,UAAU,GAAyB,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC;SACjE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAI,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACnF,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,CACnC,CAAC","sourcesContent":["/**\n * Brave Search API. Requiere clave (`brave` en el vault, o BRAVE_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.search.brave.com/res/v1/web/search\";\n\ninterface RespuestaBrave {\n\tweb?: { results?: Array<{ title?: string; url?: string; description?: string }> };\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Brave requiere clave.\");\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\turl.searchParams.set(\"count\", String(Math.min(Math.max(maximo, 1), 20)));\n\tconst respuesta = await fetchImpl(url, {\n\t\theaders: { Accept: \"application/json\", \"X-Subscription-Token\": clave },\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Brave respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaBrave;\n\tconst resultados: ResultadoProveedor[] = (datos.web?.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.description }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/claves.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resuelve la clave de un proveedor de búsqueda: vault primero, variable de
+ * entorno después (la que usa CI, donde no hay vault desbloqueado).
+ *
+ * Vive separado del registro para que `agent-session.ts` —de upstream, con el
+ * presupuesto de sincronización agotado— pueda enchufarlo con una sola
+ * llamada en vez de repetir aquí la lógica try/vault/env por cada proveedor.
+ */
+/** Lo mínimo que hace falta del vault: buscar un secreto por nombre. */
+export interface FuenteDeVault {
+    getSecret(nombre: string): string | null | undefined;
+}
+/**
+ * Construye el `obtenerClave` que espera `createWebTools`, atado a un vault
+ * concreto. `obtenerVault` se llama en cada búsqueda, no una vez: el vault
+ * puede desbloquearse o bloquearse durante la sesión.
+ */
+export declare function crearObtenerClave(obtenerVault: () => FuenteDeVault | null | undefined): (nombreProveedor: string) => Promise<string | undefined>;
+//# sourceMappingURL=claves.d.ts.map

package/dist/core/web/proveedores/claves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claves.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/claves.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,yEAAwE;AACxE,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,YAAY,EAAE,MAAM,aAAa,GAAG,IAAI,GAAG,SAAS,GAClD,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW1D","sourcesContent":["/**\n * Resuelve la clave de un proveedor de búsqueda: vault primero, variable de\n * entorno después (la que usa CI, donde no hay vault desbloqueado).\n *\n * Vive separado del registro para que `agent-session.ts` —de upstream, con el\n * presupuesto de sincronización agotado— pueda enchufarlo con una sola\n * llamada en vez de repetir aquí la lógica try/vault/env por cada proveedor.\n */\n\n/** Nombre de proveedor → variable de entorno donde puede vivir su clave. */\nconst VARIABLE_ENTORNO: Record<string, string> = {\n\tserper: \"SERPER_API_KEY\",\n\tbrave: \"BRAVE_API_KEY\",\n\ttavily: \"TAVILY_API_KEY\",\n\texa: \"EXA_API_KEY\",\n\tsearxng: \"SEARXNG_URL\",\n};\n\n/** Lo mínimo que hace falta del vault: buscar un secreto por nombre. */\nexport interface FuenteDeVault {\n\tgetSecret(nombre: string): string | null | undefined;\n}\n\n/**\n * Construye el `obtenerClave` que espera `createWebTools`, atado a un vault\n * concreto. `obtenerVault` se llama en cada búsqueda, no una vez: el vault\n * puede desbloquearse o bloquearse durante la sesión.\n */\nexport function crearObtenerClave(\n\tobtenerVault: () => FuenteDeVault | null | undefined,\n): (nombreProveedor: string) => Promise<string | undefined> {\n\treturn async (nombreProveedor: string) => {\n\t\tconst variable = VARIABLE_ENTORNO[nombreProveedor];\n\t\ttry {\n\t\t\tconst delVault = obtenerVault()?.getSecret(nombreProveedor);\n\t\t\tif (delVault) return delVault;\n\t\t} catch {\n\t\t\t// Vault bloqueado o no inicializado: caer a la variable de entorno.\n\t\t}\n\t\treturn variable ? process.env[variable] : undefined;\n\t};\n}\n"]}

package/dist/core/web/proveedores/claves.js

@@ -0,0 +1,36 @@
+/**
+ * Resuelve la clave de un proveedor de búsqueda: vault primero, variable de
+ * entorno después (la que usa CI, donde no hay vault desbloqueado).
+ *
+ * Vive separado del registro para que `agent-session.ts` —de upstream, con el
+ * presupuesto de sincronización agotado— pueda enchufarlo con una sola
+ * llamada en vez de repetir aquí la lógica try/vault/env por cada proveedor.
+ */
+/** Nombre de proveedor → variable de entorno donde puede vivir su clave. */
+const VARIABLE_ENTORNO = {
+    serper: "SERPER_API_KEY",
+    brave: "BRAVE_API_KEY",
+    tavily: "TAVILY_API_KEY",
+    exa: "EXA_API_KEY",
+    searxng: "SEARXNG_URL",
+};
+/**
+ * Construye el `obtenerClave` que espera `createWebTools`, atado a un vault
+ * concreto. `obtenerVault` se llama en cada búsqueda, no una vez: el vault
+ * puede desbloquearse o bloquearse durante la sesión.
+ */
+export function crearObtenerClave(obtenerVault) {
+    return async (nombreProveedor) => {
+        const variable = VARIABLE_ENTORNO[nombreProveedor];
+        try {
+            const delVault = obtenerVault()?.getSecret(nombreProveedor);
+            if (delVault)
+                return delVault;
+        }
+        catch {
+            // Vault bloqueado o no inicializado: caer a la variable de entorno.
+        }
+        return variable ? process.env[variable] : undefined;
+    };
+}
+//# sourceMappingURL=claves.js.map

package/dist/core/web/proveedores/claves.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claves.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/claves.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA4E;AAC5E,MAAM,gBAAgB,GAA2B;IAChD,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,gBAAgB;IACxB,GAAG,EAAE,aAAa;IAClB,OAAO,EAAE,aAAa;CACtB,CAAC;AAOF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAChC,YAAoD,EACO;IAC3D,OAAO,KAAK,EAAE,eAAuB,EAAE,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;QACnD,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,YAAY,EAAE,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;YAC5D,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACR,oEAAoE;QACrE,CAAC;QACD,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAAA,CACpD,CAAC;AAAA,CACF","sourcesContent":["/**\n * Resuelve la clave de un proveedor de búsqueda: vault primero, variable de\n * entorno después (la que usa CI, donde no hay vault desbloqueado).\n *\n * Vive separado del registro para que `agent-session.ts` —de upstream, con el\n * presupuesto de sincronización agotado— pueda enchufarlo con una sola\n * llamada en vez de repetir aquí la lógica try/vault/env por cada proveedor.\n */\n\n/** Nombre de proveedor → variable de entorno donde puede vivir su clave. */\nconst VARIABLE_ENTORNO: Record<string, string> = {\n\tserper: \"SERPER_API_KEY\",\n\tbrave: \"BRAVE_API_KEY\",\n\ttavily: \"TAVILY_API_KEY\",\n\texa: \"EXA_API_KEY\",\n\tsearxng: \"SEARXNG_URL\",\n};\n\n/** Lo mínimo que hace falta del vault: buscar un secreto por nombre. */\nexport interface FuenteDeVault {\n\tgetSecret(nombre: string): string | null | undefined;\n}\n\n/**\n * Construye el `obtenerClave` que espera `createWebTools`, atado a un vault\n * concreto. `obtenerVault` se llama en cada búsqueda, no una vez: el vault\n * puede desbloquearse o bloquearse durante la sesión.\n */\nexport function crearObtenerClave(\n\tobtenerVault: () => FuenteDeVault | null | undefined,\n): (nombreProveedor: string) => Promise<string | undefined> {\n\treturn async (nombreProveedor: string) => {\n\t\tconst variable = VARIABLE_ENTORNO[nombreProveedor];\n\t\ttry {\n\t\t\tconst delVault = obtenerVault()?.getSecret(nombreProveedor);\n\t\t\tif (delVault) return delVault;\n\t\t} catch {\n\t\t\t// Vault bloqueado o no inicializado: caer a la variable de entorno.\n\t\t}\n\t\treturn variable ? process.env[variable] : undefined;\n\t};\n}\n"]}

package/dist/core/web/proveedores/duckduckgo.d.ts

@@ -0,0 +1,3 @@
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=duckduckgo.d.ts.map

package/dist/core/web/proveedores/duckduckgo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckduckgo.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/duckduckgo.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AA8EpE,eAAO,MAAM,MAAM,EAAE,aAepB,CAAC","sourcesContent":["/**\n * DuckDuckGo, vía su frontend HTML sin JS (`html.duckduckgo.com/html/`).\n *\n * Sin clave: es el único de los tres proveedores gratuitos que responde con\n * resultados reales desde una red de centro de datos en la práctica —Mojeek y\n * Ecosia sirven un captcha o un firewall a cualquier cliente sin navegador\n * real la mayoría de las veces—. Por eso va primero en el grupo sin clave: es\n * el que de verdad sostiene la puerta «sin ninguna clave, hay resultados».\n *\n * DuckDuckGo enruta cada resultado por `//duckduckgo.com/l/?uddg=<url>` para\n * medir clics; hay que desenvolverlo o el agente termina con enlaces inútiles.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://html.duckduckgo.com/html/\";\n\n/** `true` cuando la página es el modal anti-bot, no resultados. DDG mezcla 200 y 202 en este caso. */\nfunction esBloqueoAntiBot(html: string): boolean {\n\treturn html.includes(\"anomaly-modal\") || html.includes(\"anomaly.js\");\n}\n\n/**\n * Desenvuelve la URL real de un resultado. Los orgánicos van envueltos en\n * `uddg=`; los ANUNCIOS (`//duckduckgo.com/y.js?ad_domain=…`) no llevan ese\n * envoltorio porque no apuntan a un destino final, sino al propio tracker de\n * clics de DDG — por eso, tras desenvolver, cualquier URL que SIGA en\n * duckduckgo.com se descarta: es un anuncio, no un resultado.\n */\nfunction desenvolverUrl(href: string): string | undefined {\n\tconst decodificado = href.replace(/&amp;/gi, \"&\");\n\tlet resuelta: string | undefined;\n\tconst match = decodificado.match(/[?&]uddg=([^&]+)/);\n\tif (match) {\n\t\ttry {\n\t\t\tresuelta = decodeURIComponent(match[1]);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t} else if (decodificado.startsWith(\"//\")) {\n\t\tresuelta = `https:${decodificado}`;\n\t} else if (decodificado.startsWith(\"http://\") || decodificado.startsWith(\"https://\")) {\n\t\tresuelta = decodificado;\n\t} else {\n\t\treturn undefined;\n\t}\n\ttry {\n\t\tif (new URL(resuelta).hostname.endsWith(\"duckduckgo.com\")) return undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n\treturn resuelta;\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\nconst RE_BLOQUE =\n\t/<div\\b[^>]*\\bclass=\"[^\"]*\\bresult\\b[^\"]*\"[^>]*>([\\s\\S]*?)(?=<div\\b[^>]*\\bclass=\"[^\"]*\\bresult\\b|<div\\b[^>]*\\bclass=\"[^\"]*\\bnav-link\\b|$)/g;\nconst RE_TITULO = /<a\\b[^>]*\\bclass=\"[^\"]*\\bresult__a\\b[^\"]*\"[^>]*\\bhref=\"([^\"]+)\"[^>]*>([\\s\\S]*?)<\\/a>/;\nconst RE_SNIPPET = /<(?:a|div|span)\\b[^>]*\\bclass=\"[^\"]*\\bresult__snippet\\b[^\"]*\"[^>]*>([\\s\\S]*?)<\\/(?:a|div|span)>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const bloque of html.matchAll(RE_BLOQUE)) {\n\t\tconst titulo = bloque[1].match(RE_TITULO);\n\t\tif (!titulo) continue;\n\t\tconst url = desenvolverUrl(titulo[1]);\n\t\tif (!url) continue;\n\t\tconst tituloTexto = limpiarTexto(titulo[2]);\n\t\tif (!tituloTexto) continue;\n\t\tconst snippet = bloque[1].match(RE_SNIPPET);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl,\n\t\t\tresumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\t// GET, no POST: probado en vivo contra `html.duckduckgo.com` — el mismo\n\t// endpoint trata el POST (el envío \"de formulario real\" que usan otros\n\t// scrapers) con más sospecha que un GET con la consulta en la query, al\n\t// menos desde redes de centro de datos. Con GET responde con resultados\n\t// reales de forma consistente; con POST, con el modal anti-bot.\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tif (!respuesta.ok) throw new Error(`DuckDuckGo respondió HTTP ${respuesta.status}.`);\n\tconst html = await respuesta.text();\n\tif (esBloqueoAntiBot(html)) {\n\t\tthrow new Error(\"DuckDuckGo bloqueó la petición con su captcha anti-bot.\");\n\t}\n\treturn parsear(html).slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/duckduckgo.js

@@ -0,0 +1,109 @@
+/**
+ * DuckDuckGo, vía su frontend HTML sin JS (`html.duckduckgo.com/html/`).
+ *
+ * Sin clave: es el único de los tres proveedores gratuitos que responde con
+ * resultados reales desde una red de centro de datos en la práctica —Mojeek y
+ * Ecosia sirven un captcha o un firewall a cualquier cliente sin navegador
+ * real la mayoría de las veces—. Por eso va primero en el grupo sin clave: es
+ * el que de verdad sostiene la puerta «sin ninguna clave, hay resultados».
+ *
+ * DuckDuckGo enruta cada resultado por `//duckduckgo.com/l/?uddg=<url>` para
+ * medir clics; hay que desenvolverlo o el agente termina con enlaces inútiles.
+ */
+import { CABECERAS_NAVEGADOR } from "./navegador.js";
+const ENDPOINT = "https://html.duckduckgo.com/html/";
+/** `true` cuando la página es el modal anti-bot, no resultados. DDG mezcla 200 y 202 en este caso. */
+function esBloqueoAntiBot(html) {
+    return html.includes("anomaly-modal") || html.includes("anomaly.js");
+}
+/**
+ * Desenvuelve la URL real de un resultado. Los orgánicos van envueltos en
+ * `uddg=`; los ANUNCIOS (`//duckduckgo.com/y.js?ad_domain=…`) no llevan ese
+ * envoltorio porque no apuntan a un destino final, sino al propio tracker de
+ * clics de DDG — por eso, tras desenvolver, cualquier URL que SIGA en
+ * duckduckgo.com se descarta: es un anuncio, no un resultado.
+ */
+function desenvolverUrl(href) {
+    const decodificado = href.replace(/&amp;/gi, "&");
+    let resuelta;
+    const match = decodificado.match(/[?&]uddg=([^&]+)/);
+    if (match) {
+        try {
+            resuelta = decodeURIComponent(match[1]);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    else if (decodificado.startsWith("//")) {
+        resuelta = `https:${decodificado}`;
+    }
+    else if (decodificado.startsWith("http://") || decodificado.startsWith("https://")) {
+        resuelta = decodificado;
+    }
+    else {
+        return undefined;
+    }
+    try {
+        if (new URL(resuelta).hostname.endsWith("duckduckgo.com"))
+            return undefined;
+    }
+    catch {
+        return undefined;
+    }
+    return resuelta;
+}
+function limpiarTexto(html) {
+    return html
+        .replace(/<[^>]*>/g, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;|&apos;/gi, "'")
+        .replace(/&nbsp;/gi, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+const RE_BLOQUE = /<div\b[^>]*\bclass="[^"]*\bresult\b[^"]*"[^>]*>([\s\S]*?)(?=<div\b[^>]*\bclass="[^"]*\bresult\b|<div\b[^>]*\bclass="[^"]*\bnav-link\b|$)/g;
+const RE_TITULO = /<a\b[^>]*\bclass="[^"]*\bresult__a\b[^"]*"[^>]*\bhref="([^"]+)"[^>]*>([\s\S]*?)<\/a>/;
+const RE_SNIPPET = /<(?:a|div|span)\b[^>]*\bclass="[^"]*\bresult__snippet\b[^"]*"[^>]*>([\s\S]*?)<\/(?:a|div|span)>/;
+function parsear(html) {
+    const resultados = [];
+    for (const bloque of html.matchAll(RE_BLOQUE)) {
+        const titulo = bloque[1].match(RE_TITULO);
+        if (!titulo)
+            continue;
+        const url = desenvolverUrl(titulo[1]);
+        if (!url)
+            continue;
+        const tituloTexto = limpiarTexto(titulo[2]);
+        if (!tituloTexto)
+            continue;
+        const snippet = bloque[1].match(RE_SNIPPET);
+        resultados.push({
+            titulo: tituloTexto,
+            url,
+            resumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,
+        });
+    }
+    return resultados;
+}
+export const buscar = async (consulta, maximo, _clave, fetchImpl, signal) => {
+    // GET, no POST: probado en vivo contra `html.duckduckgo.com` — el mismo
+    // endpoint trata el POST (el envío "de formulario real" que usan otros
+    // scrapers) con más sospecha que un GET con la consulta en la query, al
+    // menos desde redes de centro de datos. Con GET responde con resultados
+    // reales de forma consistente; con POST, con el modal anti-bot.
+    const url = new URL(ENDPOINT);
+    url.searchParams.set("q", consulta);
+    const respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });
+    if (!respuesta.ok)
+        throw new Error(`DuckDuckGo respondió HTTP ${respuesta.status}.`);
+    const html = await respuesta.text();
+    if (esBloqueoAntiBot(html)) {
+        throw new Error("DuckDuckGo bloqueó la petición con su captcha anti-bot.");
+    }
+    return parsear(html).slice(0, maximo);
+};
+//# sourceMappingURL=duckduckgo.js.map

package/dist/core/web/proveedores/duckduckgo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckduckgo.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/duckduckgo.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DuckDuckGo, vía su frontend HTML sin JS (`html.duckduckgo.com/html/`).\n *\n * Sin clave: es el único de los tres proveedores gratuitos que responde con\n * resultados reales desde una red de centro de datos en la práctica —Mojeek y\n * Ecosia sirven un captcha o un firewall a cualquier cliente sin navegador\n * real la mayoría de las veces—. Por eso va primero en el grupo sin clave: es\n * el que de verdad sostiene la puerta «sin ninguna clave, hay resultados».\n *\n * DuckDuckGo enruta cada resultado por `//duckduckgo.com/l/?uddg=<url>` para\n * medir clics; hay que desenvolverlo o el agente termina con enlaces inútiles.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://html.duckduckgo.com/html/\";\n\n/** `true` cuando la página es el modal anti-bot, no resultados. DDG mezcla 200 y 202 en este caso. */\nfunction esBloqueoAntiBot(html: string): boolean {\n\treturn html.includes(\"anomaly-modal\") || html.includes(\"anomaly.js\");\n}\n\n/**\n * Desenvuelve la URL real de un resultado. Los orgánicos van envueltos en\n * `uddg=`; los ANUNCIOS (`//duckduckgo.com/y.js?ad_domain=…`) no llevan ese\n * envoltorio porque no apuntan a un destino final, sino al propio tracker de\n * clics de DDG — por eso, tras desenvolver, cualquier URL que SIGA en\n * duckduckgo.com se descarta: es un anuncio, no un resultado.\n */\nfunction desenvolverUrl(href: string): string | undefined {\n\tconst decodificado = href.replace(/&amp;/gi, \"&\");\n\tlet resuelta: string | undefined;\n\tconst match = decodificado.match(/[?&]uddg=([^&]+)/);\n\tif (match) {\n\t\ttry {\n\t\t\tresuelta = decodeURIComponent(match[1]);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t} else if (decodificado.startsWith(\"//\")) {\n\t\tresuelta = `https:${decodificado}`;\n\t} else if (decodificado.startsWith(\"http://\") || decodificado.startsWith(\"https://\")) {\n\t\tresuelta = decodificado;\n\t} else {\n\t\treturn undefined;\n\t}\n\ttry {\n\t\tif (new URL(resuelta).hostname.endsWith(\"duckduckgo.com\")) return undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n\treturn resuelta;\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\nconst RE_BLOQUE =\n\t/<div\\b[^>]*\\bclass=\"[^\"]*\\bresult\\b[^\"]*\"[^>]*>([\\s\\S]*?)(?=<div\\b[^>]*\\bclass=\"[^\"]*\\bresult\\b|<div\\b[^>]*\\bclass=\"[^\"]*\\bnav-link\\b|$)/g;\nconst RE_TITULO = /<a\\b[^>]*\\bclass=\"[^\"]*\\bresult__a\\b[^\"]*\"[^>]*\\bhref=\"([^\"]+)\"[^>]*>([\\s\\S]*?)<\\/a>/;\nconst RE_SNIPPET = /<(?:a|div|span)\\b[^>]*\\bclass=\"[^\"]*\\bresult__snippet\\b[^\"]*\"[^>]*>([\\s\\S]*?)<\\/(?:a|div|span)>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const bloque of html.matchAll(RE_BLOQUE)) {\n\t\tconst titulo = bloque[1].match(RE_TITULO);\n\t\tif (!titulo) continue;\n\t\tconst url = desenvolverUrl(titulo[1]);\n\t\tif (!url) continue;\n\t\tconst tituloTexto = limpiarTexto(titulo[2]);\n\t\tif (!tituloTexto) continue;\n\t\tconst snippet = bloque[1].match(RE_SNIPPET);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl,\n\t\t\tresumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\t// GET, no POST: probado en vivo contra `html.duckduckgo.com` — el mismo\n\t// endpoint trata el POST (el envío \"de formulario real\" que usan otros\n\t// scrapers) con más sospecha que un GET con la consulta en la query, al\n\t// menos desde redes de centro de datos. Con GET responde con resultados\n\t// reales de forma consistente; con POST, con el modal anti-bot.\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tif (!respuesta.ok) throw new Error(`DuckDuckGo respondió HTTP ${respuesta.status}.`);\n\tconst html = await respuesta.text();\n\tif (esBloqueoAntiBot(html)) {\n\t\tthrow new Error(\"DuckDuckGo bloqueó la petición con su captcha anti-bot.\");\n\t}\n\treturn parsear(html).slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/ecosia.d.ts

@@ -0,0 +1,3 @@
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=ecosia.d.ts.map

package/dist/core/web/proveedores/ecosia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosia.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/ecosia.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAuDpE,eAAO,MAAM,MAAM,EAAE,aAUpB,CAAC","sourcesContent":["/**\n * Ecosia, vía su página HTML pública (`ecosia.org/search`).\n *\n * Sin clave. Su frontal Cloudflare bloquea con frecuencia a clientes sin\n * navegador real (403 \"Ecosia Firewall\"); igual que Mojeek, se implementa\n * porque cuando responde trae resultados reales y el registro salta al\n * siguiente proveedor cuando este lanza.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://www.ecosia.org/search\";\n\nfunction esBloqueado(status: number, html: string): boolean {\n\treturn (\n\t\tstatus === 403 ||\n\t\tstatus === 429 ||\n\t\thtml.includes(\"Ecosia Firewall\") ||\n\t\thtml.includes(\"_cf_chl_opt\") ||\n\t\thtml.includes(\"/cdn-cgi/challenge-platform/\")\n\t);\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\n/** Cada resultado orgánico es un `<article data-test-id=\"organic-result\">`. */\nconst RE_ARTICULO = /<article\\b[^>]*\\bdata-test-id=\"organic-result\"[^>]*>([\\s\\S]*?)<\\/article>/g;\nconst RE_ENLACE_TITULO = /<a\\b[^>]*\\bhref=\"([^\"]+)\"[^>]*>[\\s\\S]*?data-test-id=\"result-title\"[\\s\\S]*?<\\/a>/;\nconst RE_TITULO_TEXTO = /data-test-id=\"result-title\"[^>]*>([\\s\\S]*?)<\\/h2>/;\nconst RE_DESCRIPCION = /data-test-id=\"(?:web-result-description|result-description)\"[^>]*>([\\s\\S]*?)<\\/p>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const articulo of html.matchAll(RE_ARTICULO)) {\n\t\tconst bloque = articulo[1];\n\t\tconst enlace = bloque.match(RE_ENLACE_TITULO);\n\t\tconst titulo = bloque.match(RE_TITULO_TEXTO);\n\t\tif (!enlace || !titulo) continue;\n\t\tconst href = enlace[1];\n\t\tif (!href.startsWith(\"http://\") && !href.startsWith(\"https://\")) continue;\n\t\tif (/^https?:\\/\\/(www\\.)?ecosia\\.org/i.test(href)) continue;\n\t\tconst tituloTexto = limpiarTexto(titulo[1]);\n\t\tif (!tituloTexto) continue;\n\t\tconst descripcion = bloque.match(RE_DESCRIPCION);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl: href,\n\t\t\tresumen: descripcion ? limpiarTexto(descripcion[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tconst html = await respuesta.text();\n\tif (esBloqueado(respuesta.status, html)) {\n\t\tthrow new Error(\"Ecosia bloqueó la petición con su firewall anti-bot.\");\n\t}\n\tif (!respuesta.ok) throw new Error(`Ecosia respondió HTTP ${respuesta.status}.`);\n\treturn parsear(html).slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/ecosia.js

@@ -0,0 +1,72 @@
+/**
+ * Ecosia, vía su página HTML pública (`ecosia.org/search`).
+ *
+ * Sin clave. Su frontal Cloudflare bloquea con frecuencia a clientes sin
+ * navegador real (403 "Ecosia Firewall"); igual que Mojeek, se implementa
+ * porque cuando responde trae resultados reales y el registro salta al
+ * siguiente proveedor cuando este lanza.
+ */
+import { CABECERAS_NAVEGADOR } from "./navegador.js";
+const ENDPOINT = "https://www.ecosia.org/search";
+function esBloqueado(status, html) {
+    return (status === 403 ||
+        status === 429 ||
+        html.includes("Ecosia Firewall") ||
+        html.includes("_cf_chl_opt") ||
+        html.includes("/cdn-cgi/challenge-platform/"));
+}
+function limpiarTexto(html) {
+    return html
+        .replace(/<[^>]*>/g, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;|&apos;/gi, "'")
+        .replace(/&nbsp;/gi, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** Cada resultado orgánico es un `<article data-test-id="organic-result">`. */
+const RE_ARTICULO = /<article\b[^>]*\bdata-test-id="organic-result"[^>]*>([\s\S]*?)<\/article>/g;
+const RE_ENLACE_TITULO = /<a\b[^>]*\bhref="([^"]+)"[^>]*>[\s\S]*?data-test-id="result-title"[\s\S]*?<\/a>/;
+const RE_TITULO_TEXTO = /data-test-id="result-title"[^>]*>([\s\S]*?)<\/h2>/;
+const RE_DESCRIPCION = /data-test-id="(?:web-result-description|result-description)"[^>]*>([\s\S]*?)<\/p>/;
+function parsear(html) {
+    const resultados = [];
+    for (const articulo of html.matchAll(RE_ARTICULO)) {
+        const bloque = articulo[1];
+        const enlace = bloque.match(RE_ENLACE_TITULO);
+        const titulo = bloque.match(RE_TITULO_TEXTO);
+        if (!enlace || !titulo)
+            continue;
+        const href = enlace[1];
+        if (!href.startsWith("http://") && !href.startsWith("https://"))
+            continue;
+        if (/^https?:\/\/(www\.)?ecosia\.org/i.test(href))
+            continue;
+        const tituloTexto = limpiarTexto(titulo[1]);
+        if (!tituloTexto)
+            continue;
+        const descripcion = bloque.match(RE_DESCRIPCION);
+        resultados.push({
+            titulo: tituloTexto,
+            url: href,
+            resumen: descripcion ? limpiarTexto(descripcion[1]) || undefined : undefined,
+        });
+    }
+    return resultados;
+}
+export const buscar = async (consulta, maximo, _clave, fetchImpl, signal) => {
+    const url = new URL(ENDPOINT);
+    url.searchParams.set("q", consulta);
+    const respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });
+    const html = await respuesta.text();
+    if (esBloqueado(respuesta.status, html)) {
+        throw new Error("Ecosia bloqueó la petición con su firewall anti-bot.");
+    }
+    if (!respuesta.ok)
+        throw new Error(`Ecosia respondió HTTP ${respuesta.status}.`);
+    return parsear(html).slice(0, maximo);
+};
+//# sourceMappingURL=ecosia.js.map

package/dist/core/web/proveedores/ecosia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosia.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/ecosia.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Ecosia, vía su página HTML pública (`ecosia.org/search`).\n *\n * Sin clave. Su frontal Cloudflare bloquea con frecuencia a clientes sin\n * navegador real (403 \"Ecosia Firewall\"); igual que Mojeek, se implementa\n * porque cuando responde trae resultados reales y el registro salta al\n * siguiente proveedor cuando este lanza.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://www.ecosia.org/search\";\n\nfunction esBloqueado(status: number, html: string): boolean {\n\treturn (\n\t\tstatus === 403 ||\n\t\tstatus === 429 ||\n\t\thtml.includes(\"Ecosia Firewall\") ||\n\t\thtml.includes(\"_cf_chl_opt\") ||\n\t\thtml.includes(\"/cdn-cgi/challenge-platform/\")\n\t);\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\n/** Cada resultado orgánico es un `<article data-test-id=\"organic-result\">`. */\nconst RE_ARTICULO = /<article\\b[^>]*\\bdata-test-id=\"organic-result\"[^>]*>([\\s\\S]*?)<\\/article>/g;\nconst RE_ENLACE_TITULO = /<a\\b[^>]*\\bhref=\"([^\"]+)\"[^>]*>[\\s\\S]*?data-test-id=\"result-title\"[\\s\\S]*?<\\/a>/;\nconst RE_TITULO_TEXTO = /data-test-id=\"result-title\"[^>]*>([\\s\\S]*?)<\\/h2>/;\nconst RE_DESCRIPCION = /data-test-id=\"(?:web-result-description|result-description)\"[^>]*>([\\s\\S]*?)<\\/p>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const articulo of html.matchAll(RE_ARTICULO)) {\n\t\tconst bloque = articulo[1];\n\t\tconst enlace = bloque.match(RE_ENLACE_TITULO);\n\t\tconst titulo = bloque.match(RE_TITULO_TEXTO);\n\t\tif (!enlace || !titulo) continue;\n\t\tconst href = enlace[1];\n\t\tif (!href.startsWith(\"http://\") && !href.startsWith(\"https://\")) continue;\n\t\tif (/^https?:\\/\\/(www\\.)?ecosia\\.org/i.test(href)) continue;\n\t\tconst tituloTexto = limpiarTexto(titulo[1]);\n\t\tif (!tituloTexto) continue;\n\t\tconst descripcion = bloque.match(RE_DESCRIPCION);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl: href,\n\t\t\tresumen: descripcion ? limpiarTexto(descripcion[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tconst html = await respuesta.text();\n\tif (esBloqueado(respuesta.status, html)) {\n\t\tthrow new Error(\"Ecosia bloqueó la petición con su firewall anti-bot.\");\n\t}\n\tif (!respuesta.ok) throw new Error(`Ecosia respondió HTTP ${respuesta.status}.`);\n\treturn parsear(html).slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/exa.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Exa Search API. Requiere clave (`exa` en el vault, o EXA_API_KEY).
+ */
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=exa.d.ts.map

package/dist/core/web/proveedores/exa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/exa.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAQpE,eAAO,MAAM,MAAM,EAAE,aAmBpB,CAAC","sourcesContent":["/**\n * Exa Search API. Requiere clave (`exa` en el vault, o EXA_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.exa.ai/search\";\n\ninterface RespuestaExa {\n\tresults?: Array<{ title?: string; url?: string; text?: string; summary?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Exa requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"content-type\": \"application/json\", \"x-api-key\": clave },\n\t\tbody: JSON.stringify({\n\t\t\tquery: consulta,\n\t\t\tnumResults: Math.min(Math.max(maximo, 1), 20),\n\t\t\ttype: \"auto\",\n\t\t\tcontents: { summary: { query: consulta } },\n\t\t}),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Exa respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaExa;\n\tconst resultados: ResultadoProveedor[] = (datos.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.summary || r.text }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/exa.js

@@ -0,0 +1,24 @@
+const ENDPOINT = "https://api.exa.ai/search";
+export const buscar = async (consulta, maximo, clave, fetchImpl, signal) => {
+    if (!clave)
+        throw new Error("Exa requiere clave.");
+    const respuesta = await fetchImpl(ENDPOINT, {
+        method: "POST",
+        headers: { "content-type": "application/json", "x-api-key": clave },
+        body: JSON.stringify({
+            query: consulta,
+            numResults: Math.min(Math.max(maximo, 1), 20),
+            type: "auto",
+            contents: { summary: { query: consulta } },
+        }),
+        signal,
+    });
+    if (!respuesta.ok)
+        throw new Error(`Exa respondió HTTP ${respuesta.status}.`);
+    const datos = (await respuesta.json());
+    const resultados = (datos.results ?? [])
+        .filter((r) => typeof r.url === "string" && r.url)
+        .map((r) => ({ titulo: r.title || r.url, url: r.url, resumen: r.summary || r.text }));
+    return resultados.slice(0, maximo);
+};
+//# sourceMappingURL=exa.js.map

package/dist/core/web/proveedores/exa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/exa.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAG,2BAA2B,CAAC;AAM7C,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1F,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,EAAE;QACnE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACpB,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;SAC1C,CAAC;QACF,MAAM;KACN,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAsB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAiB,CAAC;IACvD,MAAM,UAAU,GAAyB,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;SAC5D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzF,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,CACnC,CAAC","sourcesContent":["/**\n * Exa Search API. Requiere clave (`exa` en el vault, o EXA_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.exa.ai/search\";\n\ninterface RespuestaExa {\n\tresults?: Array<{ title?: string; url?: string; text?: string; summary?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Exa requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"content-type\": \"application/json\", \"x-api-key\": clave },\n\t\tbody: JSON.stringify({\n\t\t\tquery: consulta,\n\t\t\tnumResults: Math.min(Math.max(maximo, 1), 20),\n\t\t\ttype: \"auto\",\n\t\t\tcontents: { summary: { query: consulta } },\n\t\t}),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Exa respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaExa;\n\tconst resultados: ResultadoProveedor[] = (datos.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.summary || r.text }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/mojeek.d.ts

@@ -0,0 +1,3 @@
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=mojeek.d.ts.map

package/dist/core/web/proveedores/mojeek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mojeek.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/mojeek.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AA8CpE,eAAO,MAAM,MAAM,EAAE,aAWpB,CAAC","sourcesContent":["/**\n * Mojeek, vía su página HTML pública (`mojeek.com/search`).\n *\n * Índice propio, sin clave. En la práctica bloquea con un captcha (ALTCHA) a\n * casi cualquier cliente sin navegador real bastante a menudo — se implementa\n * igualmente porque cuando SÍ contesta trae resultados reales, y el registro\n * ya está pensado para saltar al siguiente proveedor cuando este lanza.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://www.mojeek.com/search\";\n\nfunction esBloqueoAntiBot(html: string): boolean {\n\treturn html.includes(\"altcha-widget\") || html.includes(\"captcha-wrap\") || /sending automated queries/i.test(html);\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\n/** Cada resultado orgánico es un `<li>` de `ul.results-standard`, con el título en `h2 > a.title`. */\nconst RE_ITEM =\n\t/<li\\b[^>]*>[\\s\\S]*?<h2[^>]*>\\s*<a\\b[^>]*\\bclass=\"[^\"]*\\btitle\\b[^\"]*\"[^>]*\\bhref=\"([^\"]+)\"[^>]*>([\\s\\S]*?)<\\/a>[\\s\\S]*?<\\/li>/g;\nconst RE_SNIPPET = /<p\\b[^>]*\\bclass=\"[^\"]*\\bs\\b[^\"]*\"[^>]*>([\\s\\S]*?)<\\/p>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst bloque = html.match(/<ul\\b[^>]*\\bclass=\"[^\"]*\\bresults-standard\\b[^\"]*\"[^>]*>([\\s\\S]*?)<\\/ul>/);\n\tif (!bloque) return [];\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const item of bloque[1].matchAll(RE_ITEM)) {\n\t\tconst href = item[1];\n\t\tif (!href.startsWith(\"http://\") && !href.startsWith(\"https://\")) continue;\n\t\tif (/mojeek\\.(com|co\\.uk|fr|de)/i.test(href)) continue; // navegación interna, no resultado\n\t\tconst tituloTexto = limpiarTexto(item[2]);\n\t\tif (!tituloTexto) continue;\n\t\tconst snippet = item[0].match(RE_SNIPPET);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl: href,\n\t\t\tresumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\turl.searchParams.set(\"t\", String(maximo));\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tconst html = await respuesta.text();\n\tif (esBloqueoAntiBot(html)) {\n\t\tthrow new Error(\"Mojeek bloqueó la petición con su captcha anti-bot.\");\n\t}\n\tif (!respuesta.ok) throw new Error(`Mojeek respondió HTTP ${respuesta.status}.`);\n\treturn parsear(html).slice(0, maximo);\n};\n"]}