@hoilab/ada-cli 0.85.0 → 0.85.3

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.map

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

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

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

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

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

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

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