@hoilab/ada-cli 0.84.21 → 0.85.0

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":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrD,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAEjD,SAAS,gBAAgB,CAAC,IAAY,EAAW;IAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CAClH;AAED,SAAS,YAAY,CAAC,IAAY,EAAU;IAC3C,OAAO,IAAI;SACT,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AAAA,CACT;AAED,wGAAsG;AACtG,MAAM,OAAO,GACZ,gIAAgI,CAAC;AAClI,MAAM,UAAU,GAAG,yDAAyD,CAAC;AAE7E,SAAS,OAAO,CAAC,IAAY,EAAwB;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;IACtG,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,UAAU,GAAyB,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAC1E,IAAI,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,oCAAmC;QAC3F,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,WAAW;YAAE,SAAS;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1C,UAAU,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,WAAW;YACnB,GAAG,EAAE,IAAI;YACT,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS;SACpE,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AAAA,CAClB;AAED,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAC3F,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,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,uDAAqD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAAyB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACjF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,CACtC,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"]}

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","sourcesContent":["/**\n * Cabeceras de navegador para los proveedores sin clave.\n *\n * DuckDuckGo, Mojeek y Ecosia sirven HTML pensado para un navegador: sin un\n * User-Agent y un Accept-Language plausibles, varios devuelven directamente la\n * página de captcha en vez de resultados. No es spoofing agresivo —un único\n * perfil fijo, no rotación— solo lo mínimo para no parecer un script desnudo.\n */\nexport const CABECERAS_NAVEGADOR: Record<string, string> = {\n\t\"user-agent\":\n\t\t\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36\",\n\t\"accept-language\": \"en-US,en;q=0.9\",\n};\n"]}

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","sourcesContent":["/**\n * Cabeceras de navegador para los proveedores sin clave.\n *\n * DuckDuckGo, Mojeek y Ecosia sirven HTML pensado para un navegador: sin un\n * User-Agent y un Accept-Language plausibles, varios devuelven directamente la\n * página de captcha en vez de resultados. No es spoofing agresivo —un único\n * perfil fijo, no rotación— solo lo mínimo para no parecer un script desnudo.\n */\nexport const CABECERAS_NAVEGADOR: Record<string, string> = {\n\t\"user-agent\":\n\t\t\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36\",\n\t\"accept-language\": \"en-US,en;q=0.9\",\n};\n"]}

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,oGAAkG;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,+EAA4E;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","sourcesContent":["/**\n * Registro perezoso de proveedores de búsqueda web.\n *\n * Importar este fichero no carga NINGÚN proveedor: cada `cargar()` es un\n * `import()` dinámico que solo se ejecuta cuando le toca el turno en\n * `buscarConProveedores`. Son módulos pesados —parseo de HTML, clientes de\n * API— y como mucho se usa uno por sesión; cargarlos todos al arrancar sería\n * trabajo tirado para el 99% de las sesiones que no los necesitan.\n *\n * Orden: la búsqueda nativa del modelo (Anthropic) se resuelve ANTES de\n * llegar aquí, en `tools.ts`. Dentro de este registro: clave configurada >\n * sin clave — lo explícito que el usuario ha pagado y configurado gana a lo\n * gratuito. Entre proveedores con clave, el orden es el de esta lista; el\n * primero con clave disponible es el que se prueba primero.\n */\nimport type { DescriptorProveedor, ResultadoProveedor } from \"./tipos.ts\";\n\nconst CON_CLAVE: DescriptorProveedor[] = [\n\t{ nombre: \"brave\", necesitaClave: true, cargar: () => import(\"./brave.ts\") },\n\t{ nombre: \"tavily\", necesitaClave: true, cargar: () => import(\"./tavily.ts\") },\n\t{ nombre: \"exa\", necesitaClave: true, cargar: () => import(\"./exa.ts\") },\n\t{ nombre: \"searxng\", necesitaClave: true, cargar: () => import(\"./searxng.ts\") },\n\t{ nombre: \"serper\", necesitaClave: true, cargar: () => import(\"./serper.ts\") },\n];\n\nconst SIN_CLAVE: DescriptorProveedor[] = [\n\t{ nombre: \"duckduckgo\", necesitaClave: false, cargar: () => import(\"./duckduckgo.ts\") },\n\t{ nombre: \"mojeek\", necesitaClave: false, cargar: () => import(\"./mojeek.ts\") },\n\t{ nombre: \"ecosia\", necesitaClave: false, cargar: () => import(\"./ecosia.ts\") },\n];\n\n/** Metadatos de todos los proveedores, en orden de intento. Ningún `cargar()` se ejecuta aquí. */\nexport const PROVEEDORES: readonly DescriptorProveedor[] = [...CON_CLAVE, ...SIN_CLAVE];\n\nexport interface ResultadoBusquedaProveedores {\n\tproveedor: string;\n\tresultados: ResultadoProveedor[];\n}\n\nexport interface OpcionesBusquedaProveedores {\n\t/** Vault primero, variable de entorno después — lo resuelve quien llama. */\n\tobtenerClave: (nombreProveedor: string) => Promise<string | undefined>;\n\tfetchImpl?: typeof fetch;\n\tsignal?: AbortSignal;\n}\n\n/**\n * Prueba los proveedores en orden hasta que uno responda (con o sin\n * resultados) o se agoten todos.\n *\n * Un proveedor sin clave configurada se SALTA sin contar como fallo — no está\n * disponible, no ha fallado. Un proveedor que lanza SÍ cuenta como fallo y se\n * acumula su motivo. Los tres proveedores sin clave (duckduckgo, mojeek,\n * ecosia) están SIEMPRE en la lista, así que siempre hay al menos uno que\n * intentar: si el bucle se agota es porque todos lanzaron, nunca porque no\n * hubiera nada que probar. Por eso el único error que se lanza aquí es\n * «fallaron», nunca «no configurado» — decir lo contrario sería mentir sobre\n * qué pasó.\n */\nexport async function buscarConProveedores(\n\tconsulta: string,\n\tmaximo: number,\n\topciones: OpcionesBusquedaProveedores,\n): Promise<ResultadoBusquedaProveedores> {\n\tconst fetchImpl = opciones.fetchImpl ?? fetch;\n\tconst errores: string[] = [];\n\n\tfor (const descriptor of PROVEEDORES) {\n\t\tlet clave: string | undefined;\n\t\tif (descriptor.necesitaClave) {\n\t\t\tclave = await opciones.obtenerClave(descriptor.nombre);\n\t\t\tif (!clave) continue; // no configurado: no es un fallo, es \"no disponible\"\n\t\t}\n\t\ttry {\n\t\t\tconst modulo = await descriptor.cargar();\n\t\t\tconst resultados = await modulo.buscar(consulta, maximo, clave, fetchImpl, opciones.signal);\n\t\t\treturn { proveedor: descriptor.nombre, resultados };\n\t\t} catch (error) {\n\t\t\terrores.push(`${descriptor.nombre}: ${error instanceof Error ? error.message : String(error)}`);\n\t\t}\n\t}\n\n\tthrow new Error(`Todos los proveedores de búsqueda fallaron: ${errores.join(\" | \")}`);\n}\n"]}

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,oGAAkG;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,EACG;IACxC,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,gDAA+C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAAA,CACtF","sourcesContent":["/**\n * Registro perezoso de proveedores de búsqueda web.\n *\n * Importar este fichero no carga NINGÚN proveedor: cada `cargar()` es un\n * `import()` dinámico que solo se ejecuta cuando le toca el turno en\n * `buscarConProveedores`. Son módulos pesados —parseo de HTML, clientes de\n * API— y como mucho se usa uno por sesión; cargarlos todos al arrancar sería\n * trabajo tirado para el 99% de las sesiones que no los necesitan.\n *\n * Orden: la búsqueda nativa del modelo (Anthropic) se resuelve ANTES de\n * llegar aquí, en `tools.ts`. Dentro de este registro: clave configurada >\n * sin clave — lo explícito que el usuario ha pagado y configurado gana a lo\n * gratuito. Entre proveedores con clave, el orden es el de esta lista; el\n * primero con clave disponible es el que se prueba primero.\n */\nimport type { DescriptorProveedor, ResultadoProveedor } from \"./tipos.ts\";\n\nconst CON_CLAVE: DescriptorProveedor[] = [\n\t{ nombre: \"brave\", necesitaClave: true, cargar: () => import(\"./brave.ts\") },\n\t{ nombre: \"tavily\", necesitaClave: true, cargar: () => import(\"./tavily.ts\") },\n\t{ nombre: \"exa\", necesitaClave: true, cargar: () => import(\"./exa.ts\") },\n\t{ nombre: \"searxng\", necesitaClave: true, cargar: () => import(\"./searxng.ts\") },\n\t{ nombre: \"serper\", necesitaClave: true, cargar: () => import(\"./serper.ts\") },\n];\n\nconst SIN_CLAVE: DescriptorProveedor[] = [\n\t{ nombre: \"duckduckgo\", necesitaClave: false, cargar: () => import(\"./duckduckgo.ts\") },\n\t{ nombre: \"mojeek\", necesitaClave: false, cargar: () => import(\"./mojeek.ts\") },\n\t{ nombre: \"ecosia\", necesitaClave: false, cargar: () => import(\"./ecosia.ts\") },\n];\n\n/** Metadatos de todos los proveedores, en orden de intento. Ningún `cargar()` se ejecuta aquí. */\nexport const PROVEEDORES: readonly DescriptorProveedor[] = [...CON_CLAVE, ...SIN_CLAVE];\n\nexport interface ResultadoBusquedaProveedores {\n\tproveedor: string;\n\tresultados: ResultadoProveedor[];\n}\n\nexport interface OpcionesBusquedaProveedores {\n\t/** Vault primero, variable de entorno después — lo resuelve quien llama. */\n\tobtenerClave: (nombreProveedor: string) => Promise<string | undefined>;\n\tfetchImpl?: typeof fetch;\n\tsignal?: AbortSignal;\n}\n\n/**\n * Prueba los proveedores en orden hasta que uno responda (con o sin\n * resultados) o se agoten todos.\n *\n * Un proveedor sin clave configurada se SALTA sin contar como fallo — no está\n * disponible, no ha fallado. Un proveedor que lanza SÍ cuenta como fallo y se\n * acumula su motivo. Los tres proveedores sin clave (duckduckgo, mojeek,\n * ecosia) están SIEMPRE en la lista, así que siempre hay al menos uno que\n * intentar: si el bucle se agota es porque todos lanzaron, nunca porque no\n * hubiera nada que probar. Por eso el único error que se lanza aquí es\n * «fallaron», nunca «no configurado» — decir lo contrario sería mentir sobre\n * qué pasó.\n */\nexport async function buscarConProveedores(\n\tconsulta: string,\n\tmaximo: number,\n\topciones: OpcionesBusquedaProveedores,\n): Promise<ResultadoBusquedaProveedores> {\n\tconst fetchImpl = opciones.fetchImpl ?? fetch;\n\tconst errores: string[] = [];\n\n\tfor (const descriptor of PROVEEDORES) {\n\t\tlet clave: string | undefined;\n\t\tif (descriptor.necesitaClave) {\n\t\t\tclave = await opciones.obtenerClave(descriptor.nombre);\n\t\t\tif (!clave) continue; // no configurado: no es un fallo, es \"no disponible\"\n\t\t}\n\t\ttry {\n\t\t\tconst modulo = await descriptor.cargar();\n\t\t\tconst resultados = await modulo.buscar(consulta, maximo, clave, fetchImpl, opciones.signal);\n\t\t\treturn { proveedor: descriptor.nombre, resultados };\n\t\t} catch (error) {\n\t\t\terrores.push(`${descriptor.nombre}: ${error instanceof Error ? error.message : String(error)}`);\n\t\t}\n\t}\n\n\tthrow new Error(`Todos los proveedores de búsqueda fallaron: ${errores.join(\" | \")}`);\n}\n"]}

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","sourcesContent":["/**\n * SearXNG: metabuscador autoalojado. No tiene clave propia en el sentido\n * habitual —lo que hace falta es la URL de LA instancia del usuario—, pero\n * cuenta como «con clave» porque, igual que una API key, no funciona de\n * fábrica: hay que configurarla (vault `searxng`, o SEARXNG_URL).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\ninterface RespuestaSearxng {\n\tresults?: Array<{ title?: string; url?: string; content?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"SearXNG requiere la URL de una instancia.\");\n\tconst base = clave.replace(/\\/+$/, \"\");\n\tconst url = new URL(`${base}/search`);\n\turl.searchParams.set(\"q\", consulta);\n\turl.searchParams.set(\"format\", \"json\");\n\tconst respuesta = await fetchImpl(url, { headers: { Accept: \"application/json\" }, signal });\n\tif (!respuesta.ok) throw new Error(`SearXNG respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaSearxng;\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.content }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

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,CAAC;IAC1F,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,2BAA0B,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;AAAA,CACnC,CAAC","sourcesContent":["/**\n * SearXNG: metabuscador autoalojado. No tiene clave propia en el sentido\n * habitual —lo que hace falta es la URL de LA instancia del usuario—, pero\n * cuenta como «con clave» porque, igual que una API key, no funciona de\n * fábrica: hay que configurarla (vault `searxng`, o SEARXNG_URL).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\ninterface RespuestaSearxng {\n\tresults?: Array<{ title?: string; url?: string; content?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"SearXNG requiere la URL de una instancia.\");\n\tconst base = clave.replace(/\\/+$/, \"\");\n\tconst url = new URL(`${base}/search`);\n\turl.searchParams.set(\"q\", consulta);\n\turl.searchParams.set(\"format\", \"json\");\n\tconst respuesta = await fetchImpl(url, { headers: { Accept: \"application/json\" }, signal });\n\tif (!respuesta.ok) throw new Error(`SearXNG respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaSearxng;\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.content }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

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","sourcesContent":["/**\n * Serper (Google Search API). Requiere clave (`serper` en el vault, o\n * SERPER_API_KEY). Es el proveedor histórico de Ada, anterior a este\n * registro: se mantiene aquí para que quien ya tenga la clave configurada\n * siga funcionando exactamente igual.\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://google.serper.dev/search\";\n\ninterface RespuestaSerper {\n\torganic?: Array<{ title?: string; link?: string; snippet?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Serper requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"X-API-KEY\": clave, \"content-type\": \"application/json\" },\n\t\tbody: JSON.stringify({ q: consulta, num: maximo }),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Serper respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaSerper;\n\tconst resultados: ResultadoProveedor[] = (datos.organic ?? [])\n\t\t.filter((r) => typeof r.link === \"string\" && r.link)\n\t\t.map((r) => ({ titulo: r.title || r.link!, url: r.link!, resumen: r.snippet }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

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,CAAC;IAC1F,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,0BAAyB,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;AAAA,CACnC,CAAC","sourcesContent":["/**\n * Serper (Google Search API). Requiere clave (`serper` en el vault, o\n * SERPER_API_KEY). Es el proveedor histórico de Ada, anterior a este\n * registro: se mantiene aquí para que quien ya tenga la clave configurada\n * siga funcionando exactamente igual.\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://google.serper.dev/search\";\n\ninterface RespuestaSerper {\n\torganic?: Array<{ title?: string; link?: string; snippet?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Serper requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"X-API-KEY\": clave, \"content-type\": \"application/json\" },\n\t\tbody: JSON.stringify({ q: consulta, num: maximo }),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Serper respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaSerper;\n\tconst resultados: ResultadoProveedor[] = (datos.organic ?? [])\n\t\t.filter((r) => typeof r.link === \"string\" && r.link)\n\t\t.map((r) => ({ titulo: r.title || r.link!, url: r.link!, resumen: r.snippet }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

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","sourcesContent":["/**\n * Tavily Search API. Requiere clave (`tavily` en el vault, o TAVILY_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.tavily.com/search\";\n\ninterface RespuestaTavily {\n\tresults?: Array<{ title?: string; url?: string; content?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Tavily requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"content-type\": \"application/json\", authorization: `Bearer ${clave}` },\n\t\tbody: JSON.stringify({ query: consulta, max_results: Math.min(Math.max(maximo, 1), 20), search_depth: \"basic\" }),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Tavily respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaTavily;\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.content }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

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,CAAC;IAC1F,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,0BAAyB,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;AAAA,CACnC,CAAC","sourcesContent":["/**\n * Tavily Search API. Requiere clave (`tavily` en el vault, o TAVILY_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.tavily.com/search\";\n\ninterface RespuestaTavily {\n\tresults?: Array<{ title?: string; url?: string; content?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Tavily requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"content-type\": \"application/json\", authorization: `Bearer ${clave}` },\n\t\tbody: JSON.stringify({ query: consulta, max_results: Math.min(Math.max(maximo, 1), 20), search_depth: \"basic\" }),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Tavily respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaTavily;\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.content }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

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,yFAAwF;AACxF,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA8E;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","sourcesContent":["/**\n * Tipos compartidos por los proveedores de búsqueda web.\n *\n * Un proveedor es un módulo que se carga con `import()` la primera vez que se\n * necesita: importar este fichero (o `registro.ts`) NO debe cargar ni un solo\n * proveedor. Son pesados —cada uno trae su propio parseo— y como mucho se usa\n * uno por sesión, así que cargarlos todos por adelantado es trabajo tirado.\n */\n\n/** Un resultado de búsqueda ya normalizado, con snippet cuando el proveedor lo trae. */\nexport interface ResultadoProveedor {\n\ttitulo: string;\n\turl: string;\n\tresumen?: string;\n\t/** Antigüedad tal y como la da el proveedor (\"3 weeks ago\", \"2026-07-30\"). */\n\tedad?: string;\n}\n\n/**\n * Busca. Los proveedores SIN clave reciben `clave === undefined` y lo ignoran;\n * el registro nunca llama a un proveedor CON clave sin haberla resuelto antes.\n *\n * Debe LANZAR en cualquier fallo real (red, HTTP, bloqueo anti-bot, JSON roto):\n * el registro pasa al siguiente proveedor con ese error. Devolver `[]` es\n * SOLO para «he preguntado y no hay resultados» — confundir las dos cosas es\n * el error que la puerta de este hueco existe para atrapar.\n */\nexport type FuncionBuscar = (\n\tconsulta: string,\n\tmaximo: number,\n\tclave: string | undefined,\n\tfetchImpl: typeof fetch,\n\tsignal?: AbortSignal,\n) => Promise<ResultadoProveedor[]>;\n\nexport interface ModuloProveedor {\n\tbuscar: FuncionBuscar;\n}\n\nexport interface DescriptorProveedor {\n\tnombre: string;\n\tnecesitaClave: boolean;\n\t/** Import perezoso: no se ejecuta hasta que el proveedor le toca en el orden. */\n\tcargar: () => Promise<ModuloProveedor>;\n}\n"]}

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

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=tipos.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/tipos.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG","sourcesContent":["/**\n * Tipos compartidos por los proveedores de búsqueda web.\n *\n * Un proveedor es un módulo que se carga con `import()` la primera vez que se\n * necesita: importar este fichero (o `registro.ts`) NO debe cargar ni un solo\n * proveedor. Son pesados —cada uno trae su propio parseo— y como mucho se usa\n * uno por sesión, así que cargarlos todos por adelantado es trabajo tirado.\n */\n\n/** Un resultado de búsqueda ya normalizado, con snippet cuando el proveedor lo trae. */\nexport interface ResultadoProveedor {\n\ttitulo: string;\n\turl: string;\n\tresumen?: string;\n\t/** Antigüedad tal y como la da el proveedor (\"3 weeks ago\", \"2026-07-30\"). */\n\tedad?: string;\n}\n\n/**\n * Busca. Los proveedores SIN clave reciben `clave === undefined` y lo ignoran;\n * el registro nunca llama a un proveedor CON clave sin haberla resuelto antes.\n *\n * Debe LANZAR en cualquier fallo real (red, HTTP, bloqueo anti-bot, JSON roto):\n * el registro pasa al siguiente proveedor con ese error. Devolver `[]` es\n * SOLO para «he preguntado y no hay resultados» — confundir las dos cosas es\n * el error que la puerta de este hueco existe para atrapar.\n */\nexport type FuncionBuscar = (\n\tconsulta: string,\n\tmaximo: number,\n\tclave: string | undefined,\n\tfetchImpl: typeof fetch,\n\tsignal?: AbortSignal,\n) => Promise<ResultadoProveedor[]>;\n\nexport interface ModuloProveedor {\n\tbuscar: FuncionBuscar;\n}\n\nexport interface DescriptorProveedor {\n\tnombre: string;\n\tnecesitaClave: boolean;\n\t/** Import perezoso: no se ejecuta hasta que el proveedor le toca en el orden. */\n\tcargar: () => Promise<ModuloProveedor>;\n}\n"]}

package/dist/core/web/registro-red.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Envolver un `fetch` para que cada salida quede en el libro de sesión.
+ *
+ * POR QUÉ VIVE APARTE. Esto nació dentro de `web/tools.ts`, envolviendo el
+ * `fetch` que reciben el fetch genérico, los scrapers y los proveedores de
+ * búsqueda. Cubría esos tres caminos y ninguno más, y el informe para el DPO
+ * escribía **«No hubo transferencias»** — una ausencia que el registro no podía
+ * sostener, porque el cliente MCP hablaba con servidores remotos sin pasar por
+ * aquí.
+ *
+ * Un DPO diría que contactar con un MCP remoto ES una transferencia (art. 44 y
+ * siguientes del RGPD), y tendría razón. Sacarlo a un módulo propio es lo que
+ * permite que cualquier camino de salida lo use, en vez de tener el registro
+ * atado al que se implementó primero.
+ *
+ * LO QUE REGISTRA Y LO QUE NO. El dominio y si se permitió, nunca la URL
+ * completa ni el cuerpo. Una ruta puede llevar un identificador y un cuerpo
+ * puede llevar datos personales; el libro guarda la FORMA de lo que pasó, no su
+ * contenido. Un registro de cumplimiento que copiara los datos sería un segundo
+ * almacén de justo lo que el RGPD quiere minimizar.
+ */
+/** Qué se le cuenta al libro. `motivo` solo cuando se bloquea. */
+export type AnotarRed = (dominio: string, permitido: boolean, motivo?: string) => void;
+/** El dominio de un destino de `fetch`, o `null` si no se puede determinar. */
+export declare function dominioDeDestino(destino: Parameters<typeof fetch>[0]): string | null;
+/**
+ * `fetch` que anota cada salida antes de hacerla.
+ *
+ * Si `anotar` es `undefined` devuelve el `fetch` original tal cual, sin
+ * envolver: quien no tiene libro no paga el coste ni ve un comportamiento
+ * distinto.
+ *
+ * El registro es best-effort y la petición no: si anotar falla, la descarga
+ * sigue. Al revés sería un libro que puede tumbar el producto, y eso acabaría
+ * con el libro desactivado.
+ */
+export declare function fetchConRegistro(base: typeof fetch, anotar: AnotarRed | undefined): typeof fetch;
+export declare function publicarAnotarRed(anotar: AnotarRed | undefined): void;
+/** `undefined` = no hay sesión con libro; quien llame no envuelve nada. */
+export declare function anotarRedDeLaSesion(): AnotarRed | undefined;
+/** Solo para pruebas. */
+export declare function olvidarAnotarRed(): void;
+//# sourceMappingURL=registro-red.d.ts.map

package/dist/core/web/registro-red.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registro-red.d.ts","sourceRoot":"","sources":["../../../src/core/web/registro-red.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,mEAAkE;AAClE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvF,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAOpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,KAAK,CAahG;AAmBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAErE;AAED,4EAA2E;AAC3E,wBAAgB,mBAAmB,IAAI,SAAS,GAAG,SAAS,CAE3D;AAED,yBAAyB;AACzB,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC","sourcesContent":["/**\n * Envolver un `fetch` para que cada salida quede en el libro de sesión.\n *\n * POR QUÉ VIVE APARTE. Esto nació dentro de `web/tools.ts`, envolviendo el\n * `fetch` que reciben el fetch genérico, los scrapers y los proveedores de\n * búsqueda. Cubría esos tres caminos y ninguno más, y el informe para el DPO\n * escribía **«No hubo transferencias»** — una ausencia que el registro no podía\n * sostener, porque el cliente MCP hablaba con servidores remotos sin pasar por\n * aquí.\n *\n * Un DPO diría que contactar con un MCP remoto ES una transferencia (art. 44 y\n * siguientes del RGPD), y tendría razón. Sacarlo a un módulo propio es lo que\n * permite que cualquier camino de salida lo use, en vez de tener el registro\n * atado al que se implementó primero.\n *\n * LO QUE REGISTRA Y LO QUE NO. El dominio y si se permitió, nunca la URL\n * completa ni el cuerpo. Una ruta puede llevar un identificador y un cuerpo\n * puede llevar datos personales; el libro guarda la FORMA de lo que pasó, no su\n * contenido. Un registro de cumplimiento que copiara los datos sería un segundo\n * almacén de justo lo que el RGPD quiere minimizar.\n */\n\n/** Qué se le cuenta al libro. `motivo` solo cuando se bloquea. */\nexport type AnotarRed = (dominio: string, permitido: boolean, motivo?: string) => void;\n\n/** El dominio de un destino de `fetch`, o `null` si no se puede determinar. */\nexport function dominioDeDestino(destino: Parameters<typeof fetch>[0]): string | null {\n\ttry {\n\t\tconst url = typeof destino === \"string\" ? destino : destino instanceof URL ? destino.href : destino.url;\n\t\treturn new URL(url).hostname || null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * `fetch` que anota cada salida antes de hacerla.\n *\n * Si `anotar` es `undefined` devuelve el `fetch` original tal cual, sin\n * envolver: quien no tiene libro no paga el coste ni ve un comportamiento\n * distinto.\n *\n * El registro es best-effort y la petición no: si anotar falla, la descarga\n * sigue. Al revés sería un libro que puede tumbar el producto, y eso acabaría\n * con el libro desactivado.\n */\nexport function fetchConRegistro(base: typeof fetch, anotar: AnotarRed | undefined): typeof fetch {\n\tif (!anotar) return base;\n\treturn (destino, init) => {\n\t\tconst dominio = dominioDeDestino(destino);\n\t\tif (dominio) {\n\t\t\ttry {\n\t\t\t\tanotar(dominio, true);\n\t\t\t} catch {\n\t\t\t\t// Un fallo del libro no puede impedir una petición.\n\t\t\t}\n\t\t}\n\t\treturn base(destino, init);\n\t};\n}\n\n/**\n * El `anotarRed` de la sesión en curso, publicado.\n *\n * Los caminos de salida no nacen todos en el mismo sitio: las tools web se\n * crean en `agent-session.ts`, que SÍ tiene el libro a mano, y el cliente MCP\n * lo crea `resource-loader.ts`, que no. Enhebrar el libro hasta allí costaba\n * hunks del presupuesto de fork en un fichero de upstream; publicarlo cuesta\n * cero y es el mismo patrón ya usado —y validado— en\n * `core/extensiones/vigilancia.ts`.\n *\n * Es estado mutable de módulo, con lo que eso tiene de malo. Se acepta por lo\n * que compra: sin esto el informe para el DPO afirma «No hubo transferencias»\n * sobre una sesión que habló con un servidor de terceros, y esa es la clase de\n * afirmación que no se puede hacer a la ligera en un registro de cumplimiento.\n */\nlet anotarPublicado: AnotarRed | undefined;\n\nexport function publicarAnotarRed(anotar: AnotarRed | undefined): void {\n\tanotarPublicado = anotar;\n}\n\n/** `undefined` = no hay sesión con libro; quien llame no envuelve nada. */\nexport function anotarRedDeLaSesion(): AnotarRed | undefined {\n\treturn anotarPublicado;\n}\n\n/** Solo para pruebas. */\nexport function olvidarAnotarRed(): void {\n\tanotarPublicado = undefined;\n}\n"]}

package/dist/core/web/registro-red.js

@@ -0,0 +1,86 @@
+/**
+ * Envolver un `fetch` para que cada salida quede en el libro de sesión.
+ *
+ * POR QUÉ VIVE APARTE. Esto nació dentro de `web/tools.ts`, envolviendo el
+ * `fetch` que reciben el fetch genérico, los scrapers y los proveedores de
+ * búsqueda. Cubría esos tres caminos y ninguno más, y el informe para el DPO
+ * escribía **«No hubo transferencias»** — una ausencia que el registro no podía
+ * sostener, porque el cliente MCP hablaba con servidores remotos sin pasar por
+ * aquí.
+ *
+ * Un DPO diría que contactar con un MCP remoto ES una transferencia (art. 44 y
+ * siguientes del RGPD), y tendría razón. Sacarlo a un módulo propio es lo que
+ * permite que cualquier camino de salida lo use, en vez de tener el registro
+ * atado al que se implementó primero.
+ *
+ * LO QUE REGISTRA Y LO QUE NO. El dominio y si se permitió, nunca la URL
+ * completa ni el cuerpo. Una ruta puede llevar un identificador y un cuerpo
+ * puede llevar datos personales; el libro guarda la FORMA de lo que pasó, no su
+ * contenido. Un registro de cumplimiento que copiara los datos sería un segundo
+ * almacén de justo lo que el RGPD quiere minimizar.
+ */
+/** El dominio de un destino de `fetch`, o `null` si no se puede determinar. */
+export function dominioDeDestino(destino) {
+    try {
+        const url = typeof destino === "string" ? destino : destino instanceof URL ? destino.href : destino.url;
+        return new URL(url).hostname || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * `fetch` que anota cada salida antes de hacerla.
+ *
+ * Si `anotar` es `undefined` devuelve el `fetch` original tal cual, sin
+ * envolver: quien no tiene libro no paga el coste ni ve un comportamiento
+ * distinto.
+ *
+ * El registro es best-effort y la petición no: si anotar falla, la descarga
+ * sigue. Al revés sería un libro que puede tumbar el producto, y eso acabaría
+ * con el libro desactivado.
+ */
+export function fetchConRegistro(base, anotar) {
+    if (!anotar)
+        return base;
+    return (destino, init) => {
+        const dominio = dominioDeDestino(destino);
+        if (dominio) {
+            try {
+                anotar(dominio, true);
+            }
+            catch {
+                // Un fallo del libro no puede impedir una petición.
+            }
+        }
+        return base(destino, init);
+    };
+}
+/**
+ * El `anotarRed` de la sesión en curso, publicado.
+ *
+ * Los caminos de salida no nacen todos en el mismo sitio: las tools web se
+ * crean en `agent-session.ts`, que SÍ tiene el libro a mano, y el cliente MCP
+ * lo crea `resource-loader.ts`, que no. Enhebrar el libro hasta allí costaba
+ * hunks del presupuesto de fork en un fichero de upstream; publicarlo cuesta
+ * cero y es el mismo patrón ya usado —y validado— en
+ * `core/extensiones/vigilancia.ts`.
+ *
+ * Es estado mutable de módulo, con lo que eso tiene de malo. Se acepta por lo
+ * que compra: sin esto el informe para el DPO afirma «No hubo transferencias»
+ * sobre una sesión que habló con un servidor de terceros, y esa es la clase de
+ * afirmación que no se puede hacer a la ligera en un registro de cumplimiento.
+ */
+let anotarPublicado;
+export function publicarAnotarRed(anotar) {
+    anotarPublicado = anotar;
+}
+/** `undefined` = no hay sesión con libro; quien llame no envuelve nada. */
+export function anotarRedDeLaSesion() {
+    return anotarPublicado;
+}
+/** Solo para pruebas. */
+export function olvidarAnotarRed() {
+    anotarPublicado = undefined;
+}
+//# sourceMappingURL=registro-red.js.map

package/dist/core/web/registro-red.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registro-red.js","sourceRoot":"","sources":["../../../src/core/web/registro-red.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,OAAoC,EAAiB;IACrF,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QACxG,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AAAA,CACD;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAkB,EAAE,MAA6B,EAAgB;IACjG,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACb,IAAI,CAAC;gBACJ,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACR,qDAAoD;YACrD,CAAC;QACF,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAAA,CAC3B,CAAC;AAAA,CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,IAAI,eAAsC,CAAC;AAE3C,MAAM,UAAU,iBAAiB,CAAC,MAA6B,EAAQ;IACtE,eAAe,GAAG,MAAM,CAAC;AAAA,CACzB;AAED,4EAA2E;AAC3E,MAAM,UAAU,mBAAmB,GAA0B;IAC5D,OAAO,eAAe,CAAC;AAAA,CACvB;AAED,yBAAyB;AACzB,MAAM,UAAU,gBAAgB,GAAS;IACxC,eAAe,GAAG,SAAS,CAAC;AAAA,CAC5B","sourcesContent":["/**\n * Envolver un `fetch` para que cada salida quede en el libro de sesión.\n *\n * POR QUÉ VIVE APARTE. Esto nació dentro de `web/tools.ts`, envolviendo el\n * `fetch` que reciben el fetch genérico, los scrapers y los proveedores de\n * búsqueda. Cubría esos tres caminos y ninguno más, y el informe para el DPO\n * escribía **«No hubo transferencias»** — una ausencia que el registro no podía\n * sostener, porque el cliente MCP hablaba con servidores remotos sin pasar por\n * aquí.\n *\n * Un DPO diría que contactar con un MCP remoto ES una transferencia (art. 44 y\n * siguientes del RGPD), y tendría razón. Sacarlo a un módulo propio es lo que\n * permite que cualquier camino de salida lo use, en vez de tener el registro\n * atado al que se implementó primero.\n *\n * LO QUE REGISTRA Y LO QUE NO. El dominio y si se permitió, nunca la URL\n * completa ni el cuerpo. Una ruta puede llevar un identificador y un cuerpo\n * puede llevar datos personales; el libro guarda la FORMA de lo que pasó, no su\n * contenido. Un registro de cumplimiento que copiara los datos sería un segundo\n * almacén de justo lo que el RGPD quiere minimizar.\n */\n\n/** Qué se le cuenta al libro. `motivo` solo cuando se bloquea. */\nexport type AnotarRed = (dominio: string, permitido: boolean, motivo?: string) => void;\n\n/** El dominio de un destino de `fetch`, o `null` si no se puede determinar. */\nexport function dominioDeDestino(destino: Parameters<typeof fetch>[0]): string | null {\n\ttry {\n\t\tconst url = typeof destino === \"string\" ? destino : destino instanceof URL ? destino.href : destino.url;\n\t\treturn new URL(url).hostname || null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * `fetch` que anota cada salida antes de hacerla.\n *\n * Si `anotar` es `undefined` devuelve el `fetch` original tal cual, sin\n * envolver: quien no tiene libro no paga el coste ni ve un comportamiento\n * distinto.\n *\n * El registro es best-effort y la petición no: si anotar falla, la descarga\n * sigue. Al revés sería un libro que puede tumbar el producto, y eso acabaría\n * con el libro desactivado.\n */\nexport function fetchConRegistro(base: typeof fetch, anotar: AnotarRed | undefined): typeof fetch {\n\tif (!anotar) return base;\n\treturn (destino, init) => {\n\t\tconst dominio = dominioDeDestino(destino);\n\t\tif (dominio) {\n\t\t\ttry {\n\t\t\t\tanotar(dominio, true);\n\t\t\t} catch {\n\t\t\t\t// Un fallo del libro no puede impedir una petición.\n\t\t\t}\n\t\t}\n\t\treturn base(destino, init);\n\t};\n}\n\n/**\n * El `anotarRed` de la sesión en curso, publicado.\n *\n * Los caminos de salida no nacen todos en el mismo sitio: las tools web se\n * crean en `agent-session.ts`, que SÍ tiene el libro a mano, y el cliente MCP\n * lo crea `resource-loader.ts`, que no. Enhebrar el libro hasta allí costaba\n * hunks del presupuesto de fork en un fichero de upstream; publicarlo cuesta\n * cero y es el mismo patrón ya usado —y validado— en\n * `core/extensiones/vigilancia.ts`.\n *\n * Es estado mutable de módulo, con lo que eso tiene de malo. Se acepta por lo\n * que compra: sin esto el informe para el DPO afirma «No hubo transferencias»\n * sobre una sesión que habló con un servidor de terceros, y esa es la clase de\n * afirmación que no se puede hacer a la ligera en un registro de cumplimiento.\n */\nlet anotarPublicado: AnotarRed | undefined;\n\nexport function publicarAnotarRed(anotar: AnotarRed | undefined): void {\n\tanotarPublicado = anotar;\n}\n\n/** `undefined` = no hay sesión con libro; quien llame no envuelve nada. */\nexport function anotarRedDeLaSesion(): AnotarRed | undefined {\n\treturn anotarPublicado;\n}\n\n/** Solo para pruebas. */\nexport function olvidarAnotarRed(): void {\n\tanotarPublicado = undefined;\n}\n"]}

package/dist/core/web/scrapers/cisa-kev.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CISA KEV (Known Exploited Vulnerabilities), vía el feed JSON público.
+ *
+ * No hay endpoint por CVE: el feed es el catálogo entero (~1.5 MB). Se pide
+ * completo y se filtra en memoria — mismo coste de red que cualquier otra
+ * consulta a este catálogo, no hay forma más barata sin clave.
+ */
+import { type FuncionScraper } from "./tipos.ts";
+export declare const scrapear: FuncionScraper;
+//# sourceMappingURL=cisa-kev.d.ts.map

package/dist/core/web/scrapers/cisa-kev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cisa-kev.d.ts","sourceRoot":"","sources":["../../../../src/core/web/scrapers/cisa-kev.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAgBpE,eAAO,MAAM,QAAQ,EAAE,cAwBtB,CAAC","sourcesContent":["/**\n * CISA KEV (Known Exploited Vulnerabilities), vía el feed JSON público.\n *\n * No hay endpoint por CVE: el feed es el catálogo entero (~1.5 MB). Se pide\n * completo y se filtra en memoria — mismo coste de red que cualquier otra\n * consulta a este catálogo, no hay forma más barata sin clave.\n */\nimport { esHostOSubdominio, type FuncionScraper } from \"./tipos.ts\";\n\nconst FEED_URL = \"https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json\";\nconst RE_CVE = /CVE-\\d{4}-\\d{4,7}/i;\n\ninterface EntradaKev {\n\tcveID?: string;\n\tvendorProject?: string;\n\tproduct?: string;\n\tvulnerabilityName?: string;\n\tshortDescription?: string;\n\tdateAdded?: string;\n\tdueDate?: string;\n\tknownRansomwareCampaignUse?: string;\n}\n\nexport const scrapear: FuncionScraper = async (url, fetchImpl, signal) => {\n\tif (!esHostOSubdominio(url.hostname.toLowerCase(), \"cisa.gov\")) return null;\n\tconst cveMatch = url.pathname.match(RE_CVE) ?? url.search.match(RE_CVE);\n\tif (!cveMatch) return null;\n\tconst cveId = cveMatch[0].toUpperCase();\n\n\tconst respuesta = await fetchImpl(FEED_URL, { headers: { Accept: \"application/json\" }, signal });\n\tif (!respuesta.ok) throw new Error(`CISA KEV respondió HTTP ${respuesta.status}.`);\n\tconst doc = (await respuesta.json()) as { vulnerabilities?: EntradaKev[] };\n\tconst entrada = doc.vulnerabilities?.find((v) => v.cveID?.toUpperCase() === cveId);\n\tif (!entrada) return null; // el CVE es válido pero no está en el catálogo KEV\n\n\treturn {\n\t\ttitulo: `${entrada.cveID} — ${entrada.vulnerabilityName ?? \"explotado activamente (KEV)\"}`,\n\t\turl: `https://www.cisa.gov/known-exploited-vulnerabilities-catalog?search_api_fulltext=${entrada.cveID}`,\n\t\tresumen: entrada.shortDescription ?? \"\",\n\t\tdatos: {\n\t\t\tvendedor: entrada.vendorProject,\n\t\t\tproducto: entrada.product,\n\t\t\tañadido: entrada.dateAdded,\n\t\t\tfechaLimite: entrada.dueDate,\n\t\t\tusoEnRansomware: entrada.knownRansomwareCampaignUse,\n\t\t},\n\t};\n};\n"]}