@hoilab/ada-cli 0.84.22 → 0.85.1

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

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

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

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

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;IACzF,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,sBAAsB,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;AACpC,CAAC,CAAC"}

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

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

@@ -0,0 +1,65 @@
+/**
+ * Mojeek, vía su página HTML pública (`mojeek.com/search`).
+ *
+ * Índice propio, sin clave. En la práctica bloquea con un captcha (ALTCHA) a
+ * casi cualquier cliente sin navegador real bastante a menudo — se implementa
+ * igualmente porque cuando SÍ contesta trae resultados reales, y el registro
+ * ya está pensado para saltar al siguiente proveedor cuando este lanza.
+ */
+import { CABECERAS_NAVEGADOR } from "./navegador.js";
+const ENDPOINT = "https://www.mojeek.com/search";
+function esBloqueoAntiBot(html) {
+    return html.includes("altcha-widget") || html.includes("captcha-wrap") || /sending automated queries/i.test(html);
+}
+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 `<li>` de `ul.results-standard`, con el título en `h2 > a.title`. */
+const RE_ITEM = /<li\b[^>]*>[\s\S]*?<h2[^>]*>\s*<a\b[^>]*\bclass="[^"]*\btitle\b[^"]*"[^>]*\bhref="([^"]+)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?<\/li>/g;
+const RE_SNIPPET = /<p\b[^>]*\bclass="[^"]*\bs\b[^"]*"[^>]*>([\s\S]*?)<\/p>/;
+function parsear(html) {
+    const bloque = html.match(/<ul\b[^>]*\bclass="[^"]*\bresults-standard\b[^"]*"[^>]*>([\s\S]*?)<\/ul>/);
+    if (!bloque)
+        return [];
+    const resultados = [];
+    for (const item of bloque[1].matchAll(RE_ITEM)) {
+        const href = item[1];
+        if (!href.startsWith("http://") && !href.startsWith("https://"))
+            continue;
+        if (/mojeek\.(com|co\.uk|fr|de)/i.test(href))
+            continue; // navegación interna, no resultado
+        const tituloTexto = limpiarTexto(item[2]);
+        if (!tituloTexto)
+            continue;
+        const snippet = item[0].match(RE_SNIPPET);
+        resultados.push({
+            titulo: tituloTexto,
+            url: href,
+            resumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,
+        });
+    }
+    return resultados;
+}
+export const buscar = async (consulta, maximo, _clave, fetchImpl, signal) => {
+    const url = new URL(ENDPOINT);
+    url.searchParams.set("q", consulta);
+    url.searchParams.set("t", String(maximo));
+    const respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });
+    const html = await respuesta.text();
+    if (esBloqueoAntiBot(html)) {
+        throw new Error("Mojeek bloqueó la petición con su captcha anti-bot.");
+    }
+    if (!respuesta.ok)
+        throw new Error(`Mojeek respondió HTTP ${respuesta.status}.`);
+    return parsear(html).slice(0, maximo);
+};
+//# sourceMappingURL=mojeek.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Cabeceras de navegador para los proveedores sin clave.
+ *
+ * DuckDuckGo, Mojeek y Ecosia sirven HTML pensado para un navegador: sin un
+ * User-Agent y un Accept-Language plausibles, varios devuelven directamente la
+ * página de captcha en vez de resultados. No es spoofing agresivo —un único
+ * perfil fijo, no rotación— solo lo mínimo para no parecer un script desnudo.
+ */
+export declare const CABECERAS_NAVEGADOR: Record<string, string>;
+//# sourceMappingURL=navegador.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navegador.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/navegador.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAItD,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Cabeceras de navegador para los proveedores sin clave.
+ *
+ * DuckDuckGo, Mojeek y Ecosia sirven HTML pensado para un navegador: sin un
+ * User-Agent y un Accept-Language plausibles, varios devuelven directamente la
+ * página de captcha en vez de resultados. No es spoofing agresivo —un único
+ * perfil fijo, no rotación— solo lo mínimo para no parecer un script desnudo.
+ */
+export const CABECERAS_NAVEGADOR = {
+    "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36",
+    "accept-language": "en-US,en;q=0.9",
+};
+//# sourceMappingURL=navegador.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navegador.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/navegador.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IAC1D,YAAY,EACX,mHAAmH;IACpH,iBAAiB,EAAE,gBAAgB;CACnC,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Registro perezoso de proveedores de búsqueda web.
+ *
+ * Importar este fichero no carga NINGÚN proveedor: cada `cargar()` es un
+ * `import()` dinámico que solo se ejecuta cuando le toca el turno en
+ * `buscarConProveedores`. Son módulos pesados —parseo de HTML, clientes de
+ * API— y como mucho se usa uno por sesión; cargarlos todos al arrancar sería
+ * trabajo tirado para el 99% de las sesiones que no los necesitan.
+ *
+ * Orden: la búsqueda nativa del modelo (Anthropic) se resuelve ANTES de
+ * llegar aquí, en `tools.ts`. Dentro de este registro: clave configurada >
+ * sin clave — lo explícito que el usuario ha pagado y configurado gana a lo
+ * gratuito. Entre proveedores con clave, el orden es el de esta lista; el
+ * primero con clave disponible es el que se prueba primero.
+ */
+import type { DescriptorProveedor, ResultadoProveedor } from "./tipos.ts";
+/** Metadatos de todos los proveedores, en orden de intento. Ningún `cargar()` se ejecuta aquí. */
+export declare const PROVEEDORES: readonly DescriptorProveedor[];
+export interface ResultadoBusquedaProveedores {
+    proveedor: string;
+    resultados: ResultadoProveedor[];
+}
+export interface OpcionesBusquedaProveedores {
+    /** Vault primero, variable de entorno después — lo resuelve quien llama. */
+    obtenerClave: (nombreProveedor: string) => Promise<string | undefined>;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Prueba los proveedores en orden hasta que uno responda (con o sin
+ * resultados) o se agoten todos.
+ *
+ * Un proveedor sin clave configurada se SALTA sin contar como fallo — no está
+ * disponible, no ha fallado. Un proveedor que lanza SÍ cuenta como fallo y se
+ * acumula su motivo. Los tres proveedores sin clave (duckduckgo, mojeek,
+ * ecosia) están SIEMPRE en la lista, así que siempre hay al menos uno que
+ * intentar: si el bucle se agota es porque todos lanzaron, nunca porque no
+ * hubiera nada que probar. Por eso el único error que se lanza aquí es
+ * «fallaron», nunca «no configurado» — decir lo contrario sería mentir sobre
+ * qué pasó.
+ */
+export declare function buscarConProveedores(consulta: string, maximo: number, opciones: OpcionesBusquedaProveedores): Promise<ResultadoBusquedaProveedores>;
+//# sourceMappingURL=registro.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registro.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/registro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgB1E,kGAAkG;AAClG,eAAO,MAAM,WAAW,EAAE,SAAS,mBAAmB,EAAiC,CAAC;AAExF,MAAM,WAAW,4BAA4B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC3C,4EAA4E;IAC5E,YAAY,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,2BAA2B,GACnC,OAAO,CAAC,4BAA4B,CAAC,CAoBvC"}

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

@@ -0,0 +1,49 @@
+const CON_CLAVE = [
+    { nombre: "brave", necesitaClave: true, cargar: () => import("./brave.js") },
+    { nombre: "tavily", necesitaClave: true, cargar: () => import("./tavily.js") },
+    { nombre: "exa", necesitaClave: true, cargar: () => import("./exa.js") },
+    { nombre: "searxng", necesitaClave: true, cargar: () => import("./searxng.js") },
+    { nombre: "serper", necesitaClave: true, cargar: () => import("./serper.js") },
+];
+const SIN_CLAVE = [
+    { nombre: "duckduckgo", necesitaClave: false, cargar: () => import("./duckduckgo.js") },
+    { nombre: "mojeek", necesitaClave: false, cargar: () => import("./mojeek.js") },
+    { nombre: "ecosia", necesitaClave: false, cargar: () => import("./ecosia.js") },
+];
+/** Metadatos de todos los proveedores, en orden de intento. Ningún `cargar()` se ejecuta aquí. */
+export const PROVEEDORES = [...CON_CLAVE, ...SIN_CLAVE];
+/**
+ * Prueba los proveedores en orden hasta que uno responda (con o sin
+ * resultados) o se agoten todos.
+ *
+ * Un proveedor sin clave configurada se SALTA sin contar como fallo — no está
+ * disponible, no ha fallado. Un proveedor que lanza SÍ cuenta como fallo y se
+ * acumula su motivo. Los tres proveedores sin clave (duckduckgo, mojeek,
+ * ecosia) están SIEMPRE en la lista, así que siempre hay al menos uno que
+ * intentar: si el bucle se agota es porque todos lanzaron, nunca porque no
+ * hubiera nada que probar. Por eso el único error que se lanza aquí es
+ * «fallaron», nunca «no configurado» — decir lo contrario sería mentir sobre
+ * qué pasó.
+ */
+export async function buscarConProveedores(consulta, maximo, opciones) {
+    const fetchImpl = opciones.fetchImpl ?? fetch;
+    const errores = [];
+    for (const descriptor of PROVEEDORES) {
+        let clave;
+        if (descriptor.necesitaClave) {
+            clave = await opciones.obtenerClave(descriptor.nombre);
+            if (!clave)
+                continue; // no configurado: no es un fallo, es "no disponible"
+        }
+        try {
+            const modulo = await descriptor.cargar();
+            const resultados = await modulo.buscar(consulta, maximo, clave, fetchImpl, opciones.signal);
+            return { proveedor: descriptor.nombre, resultados };
+        }
+        catch (error) {
+            errores.push(`${descriptor.nombre}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    throw new Error(`Todos los proveedores de búsqueda fallaron: ${errores.join(" | ")}`);
+}
+//# sourceMappingURL=registro.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registro.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/registro.ts"],"names":[],"mappings":"AAiBA,MAAM,SAAS,GAA0B;IACxC,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;IAC5E,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;IAC9E,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;IACxE,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE;IAChF,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;CAC9E,CAAC;AAEF,MAAM,SAAS,GAA0B;IACxC,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE;IACvF,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;IAC/E,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;CAC/E,CAAC;AAEF,kGAAkG;AAClG,MAAM,CAAC,MAAM,WAAW,GAAmC,CAAC,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;AAcxF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,QAAgB,EAChB,MAAc,EACd,QAAqC;IAErC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACtC,IAAI,KAAyB,CAAC;QAC9B,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;YAC9B,KAAK,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACvD,IAAI,CAAC,KAAK;gBAAE,SAAS,CAAC,qDAAqD;QAC5E,CAAC;QACD,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5F,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjG,CAAC;IACF,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,+CAA+C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACvF,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * SearXNG: metabuscador autoalojado. No tiene clave propia en el sentido
+ * habitual —lo que hace falta es la URL de LA instancia del usuario—, pero
+ * cuenta como «con clave» porque, igual que una API key, no funciona de
+ * fábrica: hay que configurarla (vault `searxng`, o SEARXNG_URL).
+ */
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=searxng.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searxng.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/searxng.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAMpE,eAAO,MAAM,MAAM,EAAE,aAapB,CAAC"}

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

@@ -0,0 +1,17 @@
+export const buscar = async (consulta, maximo, clave, fetchImpl, signal) => {
+    if (!clave)
+        throw new Error("SearXNG requiere la URL de una instancia.");
+    const base = clave.replace(/\/+$/, "");
+    const url = new URL(`${base}/search`);
+    url.searchParams.set("q", consulta);
+    url.searchParams.set("format", "json");
+    const respuesta = await fetchImpl(url, { headers: { Accept: "application/json" }, signal });
+    if (!respuesta.ok)
+        throw new Error(`SearXNG 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.content }));
+    return resultados.slice(0, maximo);
+};
+//# sourceMappingURL=searxng.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searxng.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/searxng.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;IACzF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC;IACtC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAqB,CAAC;IAC3D,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,EAAE,CAAC,CAAC,CAAC;IAC/E,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Serper (Google Search API). Requiere clave (`serper` en el vault, o
+ * SERPER_API_KEY). Es el proveedor histórico de Ada, anterior a este
+ * registro: se mantiene aquí para que quien ya tenga la clave configurada
+ * siga funcionando exactamente igual.
+ */
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=serper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serper.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/serper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAQpE,eAAO,MAAM,MAAM,EAAE,aAcpB,CAAC"}

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

@@ -0,0 +1,19 @@
+const ENDPOINT = "https://google.serper.dev/search";
+export const buscar = async (consulta, maximo, clave, fetchImpl, signal) => {
+    if (!clave)
+        throw new Error("Serper requiere clave.");
+    const respuesta = await fetchImpl(ENDPOINT, {
+        method: "POST",
+        headers: { "X-API-KEY": clave, "content-type": "application/json" },
+        body: JSON.stringify({ q: consulta, num: maximo }),
+        signal,
+    });
+    if (!respuesta.ok)
+        throw new Error(`Serper respondió HTTP ${respuesta.status}.`);
+    const datos = (await respuesta.json());
+    const resultados = (datos.organic ?? [])
+        .filter((r) => typeof r.link === "string" && r.link)
+        .map((r) => ({ titulo: r.title || r.link, url: r.link, resumen: r.snippet }));
+    return resultados.slice(0, maximo);
+};
+//# sourceMappingURL=serper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serper.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/serper.ts"],"names":[],"mappings":"AAQA,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AAMpD,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;IACzF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE;QACnE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAClD,MAAM;KACN,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAoB,CAAC;IAC1D,MAAM,UAAU,GAAyB,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;SAC5D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC;SACnD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAK,EAAE,GAAG,EAAE,CAAC,CAAC,IAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACjF,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/tavily.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAQpE,eAAO,MAAM,MAAM,EAAE,aAcpB,CAAC"}

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

@@ -0,0 +1,19 @@
+const ENDPOINT = "https://api.tavily.com/search";
+export const buscar = async (consulta, maximo, clave, fetchImpl, signal) => {
+    if (!clave)
+        throw new Error("Tavily requiere clave.");
+    const respuesta = await fetchImpl(ENDPOINT, {
+        method: "POST",
+        headers: { "content-type": "application/json", authorization: `Bearer ${clave}` },
+        body: JSON.stringify({ query: consulta, max_results: Math.min(Math.max(maximo, 1), 20), search_depth: "basic" }),
+        signal,
+    });
+    if (!respuesta.ok)
+        throw new Error(`Tavily 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.content }));
+    return resultados.slice(0, maximo);
+};
+//# sourceMappingURL=tavily.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/tavily.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAMjD,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;IACzF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;QACjF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;QAChH,MAAM;KACN,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAoB,CAAC;IAC1D,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,EAAE,CAAC,CAAC,CAAC;IAC/E,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * Tipos compartidos por los proveedores de búsqueda web.
+ *
+ * Un proveedor es un módulo que se carga con `import()` la primera vez que se
+ * necesita: importar este fichero (o `registro.ts`) NO debe cargar ni un solo
+ * proveedor. Son pesados —cada uno trae su propio parseo— y como mucho se usa
+ * uno por sesión, así que cargarlos todos por adelantado es trabajo tirado.
+ */
+/** Un resultado de búsqueda ya normalizado, con snippet cuando el proveedor lo trae. */
+export interface ResultadoProveedor {
+    titulo: string;
+    url: string;
+    resumen?: string;
+    /** Antigüedad tal y como la da el proveedor ("3 weeks ago", "2026-07-30"). */
+    edad?: string;
+}
+/**
+ * Busca. Los proveedores SIN clave reciben `clave === undefined` y lo ignoran;
+ * el registro nunca llama a un proveedor CON clave sin haberla resuelto antes.
+ *
+ * Debe LANZAR en cualquier fallo real (red, HTTP, bloqueo anti-bot, JSON roto):
+ * el registro pasa al siguiente proveedor con ese error. Devolver `[]` es
+ * SOLO para «he preguntado y no hay resultados» — confundir las dos cosas es
+ * el error que la puerta de este hueco existe para atrapar.
+ */
+export type FuncionBuscar = (consulta: string, maximo: number, clave: string | undefined, fetchImpl: typeof fetch, signal?: AbortSignal) => Promise<ResultadoProveedor[]>;
+export interface ModuloProveedor {
+    buscar: FuncionBuscar;
+}
+export interface DescriptorProveedor {
+    nombre: string;
+    necesitaClave: boolean;
+    /** Import perezoso: no se ejecuta hasta que el proveedor le toca en el orden. */
+    cargar: () => Promise<ModuloProveedor>;
+}
+//# sourceMappingURL=tipos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/tipos.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,OAAO,KAAK,EACvB,MAAM,CAAC,EAAE,WAAW,KAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,MAAM,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;CACvC"}