@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/utils/shell-snapshot.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Snapshot del shell interactivo (UTIL-02).
+ *
+ * El tool bash corre con `process.env` del proceso CLI, no con el entorno del
+ * shell interactivo del usuario (PATH, aliases, funciones). "En mi terminal
+ * funciona" es el síntoma.
+ *
+ * Versión mínima: captura el entorno del shell padre al arrancar y lo ofrece
+ * al tool bash. La versión completa de omp además captura aliases/funciones
+ * vía `alias` y `declare -f`, con sanitización para brush; aquí se deja como
+ * follow-up si el banco lo justifica.
+ */
+export declare function captureShellEnv(): Record<string, string>;
+export declare function getShellEnv(): Record<string, string>;
+/**
+ * Env para un `spawn("bash", ...)` que hereda el shell del usuario, no solo
+ * el del proceso CLI. Las claves del snapshot pisan `process.env` para que
+ * PATH y demás reflejen lo que el usuario ve en su terminal.
+ */
+export declare function shellEnvForSpawn(): NodeJS.ProcessEnv;
+//# sourceMappingURL=shell-snapshot.d.ts.map

package/dist/core/utils/shell-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-snapshot.d.ts","sourceRoot":"","sources":["../../../src/core/utils/shell-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxD;AAED,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,UAAU,CAGpD"}

package/dist/core/utils/shell-snapshot.js

@@ -0,0 +1,32 @@
+/**
+ * Snapshot del shell interactivo (UTIL-02).
+ *
+ * El tool bash corre con `process.env` del proceso CLI, no con el entorno del
+ * shell interactivo del usuario (PATH, aliases, funciones). "En mi terminal
+ * funciona" es el síntoma.
+ *
+ * Versión mínima: captura el entorno del shell padre al arrancar y lo ofrece
+ * al tool bash. La versión completa de omp además captura aliases/funciones
+ * vía `alias` y `declare -f`, con sanitización para brush; aquí se deja como
+ * follow-up si el banco lo justifica.
+ */
+let snapshotEnv = null;
+export function captureShellEnv() {
+    if (snapshotEnv)
+        return snapshotEnv;
+    snapshotEnv = { ...process.env };
+    return snapshotEnv;
+}
+export function getShellEnv() {
+    return snapshotEnv ?? captureShellEnv();
+}
+/**
+ * Env para un `spawn("bash", ...)` que hereda el shell del usuario, no solo
+ * el del proceso CLI. Las claves del snapshot pisan `process.env` para que
+ * PATH y demás reflejen lo que el usuario ve en su terminal.
+ */
+export function shellEnvForSpawn() {
+    const snap = getShellEnv();
+    return { ...process.env, ...snap };
+}
+//# sourceMappingURL=shell-snapshot.js.map

package/dist/core/utils/shell-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-snapshot.js","sourceRoot":"","sources":["../../../src/core/utils/shell-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,IAAI,WAAW,GAAkC,IAAI,CAAC;AAEtD,MAAM,UAAU,eAAe;IAC9B,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,WAAW,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAA4B,CAAC;IAC3D,OAAO,WAAW,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,WAAW;IAC1B,OAAO,WAAW,IAAI,eAAe,EAAE,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC/B,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/dist/core/utils/startup-watchdog.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Watchdog de arranque: si el CLI no entrega el terminal a un modo en 10 s,
+ * imprime fase + ruta de logs cada 10 s hasta que lo haga.
+ *
+ * Convierte "se queda colgado" (cero salida, diagnóstico imposible) en un
+ * reporte auto-documentado. Espejo de `main.ts:222-263` de omp.
+ */
+export declare function armarWatchdog(): void;
+export declare function actualizarFase(fase: string): void;
+export declare function desarmarWatchdog(): void;
+//# sourceMappingURL=startup-watchdog.d.ts.map

package/dist/core/utils/startup-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-watchdog.d.ts","sourceRoot":"","sources":["../../../src/core/utils/startup-watchdog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,wBAAgB,aAAa,IAAI,IAAI,CAWpC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC"}

package/dist/core/utils/startup-watchdog.js

@@ -0,0 +1,34 @@
+/**
+ * Watchdog de arranque: si el CLI no entrega el terminal a un modo en 10 s,
+ * imprime fase + ruta de logs cada 10 s hasta que lo haga.
+ *
+ * Convierte "se queda colgado" (cero salida, diagnóstico imposible) en un
+ * reporte auto-documentado. Espejo de `main.ts:222-263` de omp.
+ */
+let timer;
+let faseActual = "carga de módulos";
+let inicioMs = 0;
+function formatearFase() {
+    return faseActual;
+}
+export function armarWatchdog() {
+    if (timer)
+        return;
+    inicioMs = Date.now();
+    timer = setInterval(() => {
+        const secs = Math.round((Date.now() - inicioMs) / 1000);
+        process.stderr.write(`[ada] Still starting after ${secs}s — phase: ${formatearFase()}\n` +
+            `  logs: ~/.ada/logs/ada-cli-${new Date().toISOString().slice(0, 10)}.log · re-run with PI_DEBUG_STARTUP=1 for streaming markers\n`);
+    }, 10_000);
+    timer.unref?.();
+}
+export function actualizarFase(fase) {
+    faseActual = fase;
+}
+export function desarmarWatchdog() {
+    if (!timer)
+        return;
+    clearInterval(timer);
+    timer = undefined;
+}
+//# sourceMappingURL=startup-watchdog.js.map

package/dist/core/utils/startup-watchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-watchdog.js","sourceRoot":"","sources":["../../../src/core/utils/startup-watchdog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,IAAI,KAAiD,CAAC;AACtD,IAAI,UAAU,GAAG,kBAAkB,CAAC;AACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;AAEjB,SAAS,aAAa;IACrB,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa;IAC5B,IAAI,KAAK;QAAE,OAAO;IAClB,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,8BAA8B,IAAI,cAAc,aAAa,EAAE,IAAI;YAClE,+BAA+B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,+DAA+D,CACpI,CAAC;IACH,CAAC,EAAE,MAAM,CAAC,CAAC;IACX,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,UAAU,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC/B,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,aAAa,CAAC,KAAK,CAAC,CAAC;IACrB,KAAK,GAAG,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/utils/tls-ca-shim.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shim NODE_EXTRA_CA_CERTS para fetch (UT5).
+ *
+ * Node 20+ respeta `NODE_EXTRA_CA_CERTS` nativamente en `fetch` y `tls`.
+ * Bun no — necesita un shim que lea la variable, cargue el PEM y lo inyecte
+ * en su `fetch` vía `tls` options. Omp lo tiene en `utils/tls-fetch.ts:79`
+ * (`resolveExtraCa`) porque corre sobre Bun.
+ *
+ * En ada-cli (Node) el shim es no-op: si la variable está definida, Node ya
+ * la usa. Se deja aquí para documentar la paridad y para que un futuro
+ * build sobre Bun no pierda la CA corporativa.
+ *
+ * Verificación: `NODE_EXTRA_CA_CERTS=/path/to/ca.pem ada-cli --help` no debe
+ * fallar por TLS y `resolveExtraCa()` debe devolver el path si existe.
+ */
+export declare function resolveExtraCa(): string | undefined;
+//# sourceMappingURL=tls-ca-shim.d.ts.map

package/dist/core/utils/tls-ca-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tls-ca-shim.d.ts","sourceRoot":"","sources":["../../../src/core/utils/tls-ca-shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAQnD"}

package/dist/core/utils/tls-ca-shim.js

@@ -0,0 +1,33 @@
+/**
+ * Shim NODE_EXTRA_CA_CERTS para fetch (UT5).
+ *
+ * Node 20+ respeta `NODE_EXTRA_CA_CERTS` nativamente en `fetch` y `tls`.
+ * Bun no — necesita un shim que lea la variable, cargue el PEM y lo inyecte
+ * en su `fetch` vía `tls` options. Omp lo tiene en `utils/tls-fetch.ts:79`
+ * (`resolveExtraCa`) porque corre sobre Bun.
+ *
+ * En ada-cli (Node) el shim es no-op: si la variable está definida, Node ya
+ * la usa. Se deja aquí para documentar la paridad y para que un futuro
+ * build sobre Bun no pierda la CA corporativa.
+ *
+ * Verificación: `NODE_EXTRA_CA_CERTS=/path/to/ca.pem ada-cli --help` no debe
+ * fallar por TLS y `resolveExtraCa()` debe devolver el path si existe.
+ */
+import { existsSync } from "node:fs";
+export function resolveExtraCa() {
+    const caPath = process.env.NODE_EXTRA_CA_CERTS;
+    if (!caPath)
+        return undefined;
+    if (!existsSync(caPath)) {
+        console.warn(`[ada] NODE_EXTRA_CA_CERTS points to missing file: ${caPath}`);
+        return undefined;
+    }
+    return caPath;
+}
+// Auto-verificación en import: si la variable apunta a un fichero inexistente,
+// avisar temprano en vez de fallar silenciosamente en el primer fetch.
+const _extraCa = resolveExtraCa();
+if (_extraCa === undefined && process.env.NODE_EXTRA_CA_CERTS) {
+    // Ya avisado en resolveExtraCa.
+}
+//# sourceMappingURL=tls-ca-shim.js.map

package/dist/core/utils/tls-ca-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tls-ca-shim.js","sourceRoot":"","sources":["../../../src/core/utils/tls-ca-shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,UAAU,cAAc;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,qDAAqD,MAAM,EAAE,CAAC,CAAC;QAC5E,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,uEAAuE;AACvE,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;AAClC,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;IAC/D,gCAAgC;AACjC,CAAC"}

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

@@ -0,0 +1,67 @@
+/**
+ * Agregador fan-out para `web_search`.
+ *
+ * WEB-02/WEB-03 — Un solo proveedor en secuencia es el cuello: si el primero
+ * tarda o da pocos resultados, la cobertura cae y la latencia sube. El
+ * fan-out dispara búsquedas paralelas a múltiples fuentes y agrega por
+ * relevancia con dedup canónica.
+ *
+ * Diseño:
+ *   - Paralelo real con `Promise.allSettled` — un proveedor lento no bloquea.
+ *   - Deadline blando por fuente (timeoutMs) + `AbortSignal` externo del agente.
+ *   - Dedup por URL canónica (host minúsculas, sin fragment, sin parámetros de
+ *     rastreo, sin barra final superflua). Misma URL en 3 proveedores = 3 votos.
+ *   - Ranking por consenso (nº de fuentes que la vieron) y luego por posición
+ *     media (cuanto antes aparezca en sus listas, más relevante).
+ *   - Sin clave por defecto: usa las fuentes públicas (DDG/Mojeek/Ecosia).
+ *     Con clave, cualquier fuente puede participar.
+ *
+ * No toca `proveedores/registro.ts` ni `busqueda-nativa.ts` — es Ada-owned
+ * y compone sobre los `FuncionBuscar` ya existentes (0 hunks).
+ */
+import type { ResultadoProveedor } from "./proveedores/tipos.ts";
+export interface FuenteFanout {
+    nombre: string;
+    buscar: (consulta: string, maximo: number, clave: string | undefined, fetchImpl: typeof fetch, signal?: AbortSignal) => Promise<ResultadoProveedor[]>;
+    necesitaClave?: boolean;
+}
+export interface OpcionesAgregador {
+    /** Límite final tras agregar (antes de cortar). */
+    maxResultados?: number;
+    /** Por fuente: cuántos pedir (si se omite, maxResultados). */
+    maxPorFuente?: number;
+    /** Timeout blando por fuente. Pasado, esa fuente se ignora (no falla todo). */
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+    obtenerClave?: (nombre: string) => Promise<string | undefined>;
+}
+export interface ResultadoAgregado {
+    resultados: ResultadoProveedor[];
+    /** Por fuente: cuántos aportó (tras dedup no, bruto por fuente útil para debug). */
+    aportes: Record<string, number>;
+    /** Fuentes que fallaron o expiraron (no cuentan como aporte). */
+    fallos: string[];
+    /** Tiempo total del fan-out (ms). */
+    duracionMs: number;
+}
+/**
+ * Canoniza una URL para dedup: host en minúsculas, sin fragment, sin trailing
+ * slash superfluo, sin params de rastreo, query ordenada.
+ * Si no es URL válida, devuelve la cadena tal cual en minúsculas y recortada.
+ */
+export declare function canonizarUrl(raw: string): string;
+/**
+ * Agrega listas ya obtenidas (una por fuente) por consenso y dedup.
+ * No hace red: es pura y testeable.
+ */
+export declare function agregarResultados(listas: Array<{
+    nombre: string;
+    resultados: ResultadoProveedor[];
+}>, maxResultados?: number): ResultadoProveedor[];
+/**
+ * Fan-out paralelo: dispara todas las fuentes a la vez, agrega por relevancia
+ * y deduplica. Una fuente que falla o expira no tumba el resto.
+ */
+export declare function buscarConFanout(consulta: string, fuentes: FuenteFanout[], opciones?: OpcionesAgregador): Promise<ResultadoAgregado>;
+//# sourceMappingURL=agregador.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agregador.d.ts","sourceRoot":"","sources":["../../../src/core/web/agregador.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CACP,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;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IACjC,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACnB;AAiBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAuBhD;AAcD;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,EACnE,aAAa,SAAK,GAChB,kBAAkB,EAAE,CAoCtB;AA2BD;;;GAGG;AACH,wBAAsB,eAAe,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,GAAE,iBAAsB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAgD5B"}

package/dist/core/web/agregador.js

@@ -0,0 +1,182 @@
+/**
+ * Agregador fan-out para `web_search`.
+ *
+ * WEB-02/WEB-03 — Un solo proveedor en secuencia es el cuello: si el primero
+ * tarda o da pocos resultados, la cobertura cae y la latencia sube. El
+ * fan-out dispara búsquedas paralelas a múltiples fuentes y agrega por
+ * relevancia con dedup canónica.
+ *
+ * Diseño:
+ *   - Paralelo real con `Promise.allSettled` — un proveedor lento no bloquea.
+ *   - Deadline blando por fuente (timeoutMs) + `AbortSignal` externo del agente.
+ *   - Dedup por URL canónica (host minúsculas, sin fragment, sin parámetros de
+ *     rastreo, sin barra final superflua). Misma URL en 3 proveedores = 3 votos.
+ *   - Ranking por consenso (nº de fuentes que la vieron) y luego por posición
+ *     media (cuanto antes aparezca en sus listas, más relevante).
+ *   - Sin clave por defecto: usa las fuentes públicas (DDG/Mojeek/Ecosia).
+ *     Con clave, cualquier fuente puede participar.
+ *
+ * No toca `proveedores/registro.ts` ni `busqueda-nativa.ts` — es Ada-owned
+ * y compone sobre los `FuncionBuscar` ya existentes (0 hunks).
+ */
+/** Parámetros de rastreo que no distinguen contenido. */
+const PARAMS_RASTREO = new Set([
+    "utm_source",
+    "utm_medium",
+    "utm_campaign",
+    "utm_term",
+    "utm_content",
+    "utm_id",
+    "gclid",
+    "fbclid",
+    "igshid",
+    "mc_eid",
+    "mkt_tok",
+]);
+/**
+ * Canoniza una URL para dedup: host en minúsculas, sin fragment, sin trailing
+ * slash superfluo, sin params de rastreo, query ordenada.
+ * Si no es URL válida, devuelve la cadena tal cual en minúsculas y recortada.
+ */
+export function canonizarUrl(raw) {
+    const t = raw.trim();
+    try {
+        const u = new URL(t);
+        u.hostname = u.hostname.toLowerCase();
+        u.hash = "";
+        // Quitar params de rastreo
+        for (const k of [...u.searchParams.keys()]) {
+            if (PARAMS_RASTREO.has(k.toLowerCase()))
+                u.searchParams.delete(k);
+        }
+        u.searchParams.sort();
+        // Path: quitar barra final si no es raíz y no hay query
+        let p = u.pathname;
+        if (p.length > 1 && p.endsWith("/"))
+            p = p.slice(0, -1);
+        u.pathname = p;
+        // puerto por defecto explícito fuera
+        if ((u.protocol === "https:" && u.port === "443") || (u.protocol === "http:" && u.port === "80")) {
+            u.port = "";
+        }
+        return u.toString();
+    }
+    catch {
+        return t.toLowerCase();
+    }
+}
+/**
+ * Agrega listas ya obtenidas (una por fuente) por consenso y dedup.
+ * No hace red: es pura y testeable.
+ */
+export function agregarResultados(listas, maxResultados = 10) {
+    const mapa = new Map();
+    let ordenGlobal = 0;
+    for (const lista of listas) {
+        for (let pos = 0; pos < lista.resultados.length; pos++) {
+            const r = lista.resultados[pos];
+            if (!r?.url)
+                continue;
+            const canon = canonizarUrl(r.url);
+            const existente = mapa.get(canon);
+            if (existente) {
+                existente.votos += 1;
+                existente.sumaPos += pos;
+            }
+            else {
+                mapa.set(canon, {
+                    canon,
+                    resultado: r,
+                    votos: 1,
+                    sumaPos: pos,
+                    primerOrden: ordenGlobal,
+                });
+            }
+            ordenGlobal++;
+        }
+    }
+    const entradas = [...mapa.values()];
+    entradas.sort((a, b) => {
+        if (b.votos !== a.votos)
+            return b.votos - a.votos;
+        const mediaA = a.sumaPos / a.votos;
+        const mediaB = b.sumaPos / b.votos;
+        if (mediaA !== mediaB)
+            return mediaA - mediaB;
+        return a.primerOrden - b.primerOrden;
+    });
+    return entradas.slice(0, maxResultados).map((e) => e.resultado);
+}
+/** Envuelve una promesa con timeout blando; expira → rechaza con `Timeout`. */
+function conTimeout(p, ms, signal) {
+    if (ms <= 0)
+        return p;
+    return new Promise((resolve, reject) => {
+        const t = setTimeout(() => reject(new Error(`Timeout tras ${ms}ms`)), ms);
+        const onAbort = () => {
+            clearTimeout(t);
+            reject(signal?.reason ?? new Error("Abortado"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+        p.then((v) => {
+            clearTimeout(t);
+            signal?.removeEventListener("abort", onAbort);
+            resolve(v);
+        }, (e) => {
+            clearTimeout(t);
+            signal?.removeEventListener("abort", onAbort);
+            reject(e);
+        });
+    });
+}
+/**
+ * Fan-out paralelo: dispara todas las fuentes a la vez, agrega por relevancia
+ * y deduplica. Una fuente que falla o expira no tumba el resto.
+ */
+export async function buscarConFanout(consulta, fuentes, opciones = {}) {
+    const t0 = Date.now();
+    const q = consulta.trim();
+    const maxResultados = Math.min(Math.max(opciones.maxResultados ?? 10, 1), 20);
+    const maxPorFuente = opciones.maxPorFuente ?? maxResultados;
+    const timeoutMs = opciones.timeoutMs ?? 8000;
+    const fetchImpl = opciones.fetchImpl ?? fetch;
+    const signal = opciones.signal;
+    if (!q) {
+        return { resultados: [], aportes: {}, fallos: [], duracionMs: Date.now() - t0 };
+    }
+    if (fuentes.length === 0) {
+        return { resultados: [], aportes: {}, fallos: [], duracionMs: Date.now() - t0 };
+    }
+    const tareas = fuentes.map(async (fuente) => {
+        let clave;
+        if (fuente.necesitaClave) {
+            if (!opciones.obtenerClave)
+                throw new Error(`Falta obtenerClave para ${fuente.nombre}`);
+            clave = await opciones.obtenerClave(fuente.nombre);
+            if (!clave)
+                throw new Error(`Sin clave para ${fuente.nombre}`);
+        }
+        const p = fuente.buscar(q, maxPorFuente, clave, fetchImpl, signal);
+        return conTimeout(p, timeoutMs, signal);
+    });
+    const settled = await Promise.allSettled(tareas);
+    const listas = [];
+    const aportes = {};
+    const fallos = [];
+    for (let i = 0; i < settled.length; i++) {
+        const nombre = fuentes[i].nombre;
+        const s = settled[i];
+        if (s.status === "fulfilled") {
+            const res = s.value;
+            aportes[nombre] = res.length;
+            listas.push({ nombre, resultados: res });
+        }
+        else {
+            fallos.push(nombre);
+            aportes[nombre] = 0;
+        }
+    }
+    const resultados = agregarResultados(listas, maxResultados);
+    return { resultados, aportes, fallos, duracionMs: Date.now() - t0 };
+}
+//# sourceMappingURL=agregador.js.map

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

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

package/dist/core/web/busqueda-nativa.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Búsqueda web con la credencial que el usuario YA tiene.
+ *
+ * Hasta ahora `web_search` exigía una clave de Serper aparte, así que la
+ * respuesta de fábrica era «Búsqueda web no configurada». Un agente de código
+ * que no puede mirar la documentación de una librería está cojo, y pedir una
+ * segunda cuenta para eso es una fricción que el usuario paga antes de haber
+ * visto ningún valor.
+ *
+ * Los modelos de Anthropic traen búsqueda de servidor (`web_search_20250305`).
+ * Si hay credencial de Anthropic —y la hay, porque es con lo que corre el
+ * agente— buscar puede funcionar sin configurar nada.
+ *
+ * Dos detalles que no son evidentes y que se descubrieron probándolo:
+ *
+ * 1. **Los resultados no llegan por el contenido del mensaje.** Nuestra capa de
+ *    modelos normaliza la respuesta a texto/razonamiento/llamadas, y los
+ *    bloques `web_search_tool_result` se pierden por el camino. Pedirle al
+ *    modelo que los liste en el texto tampoco vale: se probó, y contesta la
+ *    pregunta en vez de listar fuentes. Hay que leer el flujo crudo.
+ *
+ * 2. **Se lee sin tocar la capa de modelos**, pasando un `fetch` propio que
+ *    duplica el cuerpo con `tee()`: una rama sigue al SDK intacta y la otra se
+ *    analiza aquí. `agent-session.ts` y `packages/ai` son de upstream y el
+ *    presupuesto de fork está en el tope; esto no cuesta ni un hunk.
+ */
+/** Un resultado, ya normalizado. */
+export interface ResultadoWeb {
+    titulo: string;
+    url: string;
+    /** Antigüedad tal y como la da el proveedor ("3 weeks ago", "June 8, 2026"). */
+    edad?: string;
+}
+/** Proveedores cuyo modelo sabe buscar por su cuenta. */
+export declare function soportaBusquedaNativa(proveedor: string): boolean;
+/**
+ * Añade la tool de búsqueda a la carga de la petición, sin pisar las que haya.
+ *
+ * Pura y separada para poder probarla: si esto machacara `tools`, el modelo se
+ * quedaría sin sus herramientas y el fallo aparecería en cualquier otro sitio.
+ */
+export declare function conToolDeBusqueda(carga: unknown, maxUsos?: number): unknown;
+/**
+ * Recorre cualquier estructura y recoge los resultados de búsqueda.
+ *
+ * Se busca por el campo `type` en vez de por la ruta exacta del evento a
+ * propósito: el formato de los eventos SSE puede cambiar de sitio los bloques,
+ * y un recolector que dependa de la ruta se rompe en silencio —devolviendo cero
+ * resultados, que se lee igual que «no hay nada»—.
+ */
+export declare function recolectarResultados(valor: unknown, acumulado?: ResultadoWeb[]): ResultadoWeb[];
+/** Quita repetidos por URL, conservando el orden de aparición. */
+export declare function sinRepetidos(resultados: ResultadoWeb[]): ResultadoWeb[];
+/**
+ * Envuelve un `fetch` para leer los resultados sin estorbar a quien lo usa.
+ *
+ * `tee()` da dos flujos: uno se devuelve intacto —el SDK tiene que recibir
+ * exactamente lo que habría recibido— y el otro se analiza aquí. Si el análisis
+ * falla, falla solo: una búsqueda sin fuentes es peor que una con fuentes, pero
+ * una sesión rota por el analizador es mucho peor que las dos.
+ */
+export declare function fetchQueRecolecta(base: typeof fetch, destino: ResultadoWeb[]): typeof fetch;
+/** Lo que hace falta para buscar, inyectado para poder probarlo sin red. */
+export interface DependenciasBusqueda {
+    /** Ejecuta una consulta contra el modelo con las opciones dadas. */
+    completar: (consulta: string, opciones: {
+        fetch: typeof fetch;
+        onPayload: (c: unknown) => unknown;
+    }) => Promise<void>;
+    fetchBase?: typeof fetch;
+    maxResultados?: number;
+}
+/**
+ * Busca y devuelve las fuentes.
+ *
+ * No devuelve la síntesis del modelo a propósito: quien llama es el agente, que
+ * ya sabe leer. Lo que necesita de una búsqueda son URLs a las que ir con
+ * `web_fetch`, no un resumen de segunda mano que ya viene con la
+ * interpretación de otro modelo encima.
+ */
+export declare function buscarConElModelo(consulta: string, deps: DependenciasBusqueda): Promise<ResultadoWeb[]>;
+//# sourceMappingURL=busqueda-nativa.d.ts.map

package/dist/core/web/busqueda-nativa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"busqueda-nativa.d.ts","sourceRoot":"","sources":["../../../src/core/web/busqueda-nativa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAKD,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAI,GAAG,OAAO,CAKtE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,GAAE,YAAY,EAAO,GAAG,YAAY,EAAE,CAgBnG;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CASvE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,KAAK,CAgD3F;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACpC,oEAAoE;IACpE,SAAS,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;QAAE,KAAK,EAAE,OAAO,KAAK,CAAC;QAAC,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAA;KAAE,KACjE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAO7G"}