@hoilab/ada-cli 0.84.21 → 0.85.0

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

@@ -0,0 +1,91 @@
+/**
+ * Tools de web: `web_search` y `web_fetch`.
+ *
+ * Existían por su NOMBRE en el builtin `deep_research` pero nadie las
+ * registraba, así que ese workflow —uno de los cinco que anunciamos— no podía
+ * funcionar: le pedía al agente usar herramientas inexistentes. Un nombre de
+ * tool dentro de un prompt no lo comprueba ni el compilador ni los tests.
+ *
+ * `web_search` prueba, en orden: la búsqueda nativa del proveedor de modelo
+ * activo (ya es la credencial con la que corre el agente) → el registro de
+ * proveedores de terceros con clave configurada (`proveedores/registro.ts`,
+ * vault primero, variable de entorno después) → los proveedores sin clave
+ * (DuckDuckGo, Mojeek, Ecosia), que garantizan que `web_search` funciona de
+ * fábrica incluso sin ninguna credencial de terceros y con un modelo que no
+ * traiga búsqueda propia.
+ *
+ * `web_fetch` prueba primero un scraper especializado (`scrapers/registro.ts`)
+ * que devuelve datos ESTRUCTURADOS de la API pública del sitio —versión y
+ * licencia de un paquete, no el HTML de la página—; si ninguno encaja o falla,
+ * cae al fetch genérico + limpieza de HTML de siempre.
+ *
+ * `web_fetch` trae guardas contra SSRF. Una tool que descarga cualquier URL que
+ * el modelo proponga es, sin ellas, una puerta a la red interna: basta con que
+ * el modelo lea una URL en un README para que acabe pidiéndola.
+ *
+ * El acceso a estas tools es opt-in por agente (`web: true`), nunca implícito
+ * en `readOnly` — ver `resolveAllowedTools` en workflows/agent-runner.ts.
+ */
+import type { ToolDefinition } from "../extensions/types.ts";
+import type { ResultadoWeb } from "./busqueda-nativa.ts";
+import { htmlToText } from "./texto.ts";
+export { htmlToText };
+export interface WebToolsOptions {
+    /**
+     * Clave de un proveedor de búsqueda de terceros, por nombre (`serper`,
+     * `brave`, `tavily`, `exa`, `searxng`): vault primero, variable de entorno
+     * después. `undefined` cuando ese proveedor concreto no está configurado —
+     * eso lo salta, no lo hace fallar.
+     */
+    obtenerClave: (nombreProveedor: string) => Promise<string | undefined>;
+    /**
+     * Búsqueda con la credencial del modelo, cuando el proveedor la trae.
+     *
+     * Es lo que hace que `web_search` funcione sin configurar nada: el usuario ya
+     * tiene credencial —es con la que corre el agente— y los modelos de Anthropic
+     * saben buscar solos. Sin esto, la respuesta de fábrica era «Búsqueda web no
+     * configurada», que para un agente de código equivale a no poder mirar la
+     * documentación de ninguna librería.
+     *
+     * Va PRIMERO: es la credencial que el usuario ya está pagando, así que no
+     * tiene sentido preguntar por una clave de terceros antes de intentarla.
+     *
+     * Devuelve `null` cuando NO puede buscar (el proveedor activo no trae
+     * búsqueda propia) y `[]` cuando ha buscado y no ha encontrado nada. Los dos
+     * casos se leen igual desde fuera y no son lo mismo: al agente hay que
+     * decirle «no puedo» para que cambie de estrategia, no «no hay» para que se
+     * rinda. Se cometió justo ese fallo aquí, y solo salió ejecutando el
+     * producto: con un modelo de OpenRouter la tool contestaba «Sin resultados»
+     * cuando en realidad no había buscado.
+     */
+    buscarNativo?: (consulta: string, maximo: number) => Promise<ResultadoWeb[] | null>;
+    fetchImpl?: typeof fetch;
+    /**
+     * Anota una salida a la red en el libro de sesión: art. 44 y ss. del RGPD,
+     * "qué salió de la máquina y hacia dónde".
+     *
+     * El tipo `red` del libro existía sin que nadie lo anotara. Se engancha aquí y
+     * no en el manejador de tools de `agent-session.ts` porque desde allí el único
+     * destino visible es la URL que pidió el modelo, y la petición de verdad la
+     * hacen los scrapers y los proveedores de búsqueda a OTROS dominios (la API de
+     * npm, DuckDuckGo…). Envolviendo el `fetchImpl` que todos ellos comparten, el
+     * destino que se registra es el real y no el pedido.
+     *
+     * Solo el DOMINIO, nunca la ruta ni los parámetros: una query string lleva
+     * tokens y términos de búsqueda, y el libro guarda la forma, no el contenido.
+     *
+     * Nunca debe lanzar: un fallo del registro no puede tumbar una descarga.
+     */
+    anotarRed?: (dominio: string, permitido: boolean, motivo?: string) => void;
+    timeoutMs?: number;
+}
+/**
+ * Valida una URL antes de pedirla.
+ *
+ * Bloquea esquemas no-HTTP, loopback, rangos privados y el endpoint de metadatos
+ * de los proveedores cloud — que es el objetivo clásico de un SSRF y devuelve
+ * credenciales de la instancia.
+ */
+export declare function assertFetchableUrl(raw: string): URL;
+export declare function createWebTools(options: WebToolsOptions): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/core/web/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIzD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,UAAU,EAAE,CAAC;AAKtB,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,YAAY,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;IACpF,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAmBnD;AA2CD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAuMvF","sourcesContent":["/**\n * Tools de web: `web_search` y `web_fetch`.\n *\n * Existían por su NOMBRE en el builtin `deep_research` pero nadie las\n * registraba, así que ese workflow —uno de los cinco que anunciamos— no podía\n * funcionar: le pedía al agente usar herramientas inexistentes. Un nombre de\n * tool dentro de un prompt no lo comprueba ni el compilador ni los tests.\n *\n * `web_search` prueba, en orden: la búsqueda nativa del proveedor de modelo\n * activo (ya es la credencial con la que corre el agente) → el registro de\n * proveedores de terceros con clave configurada (`proveedores/registro.ts`,\n * vault primero, variable de entorno después) → los proveedores sin clave\n * (DuckDuckGo, Mojeek, Ecosia), que garantizan que `web_search` funciona de\n * fábrica incluso sin ninguna credencial de terceros y con un modelo que no\n * traiga búsqueda propia.\n *\n * `web_fetch` prueba primero un scraper especializado (`scrapers/registro.ts`)\n * que devuelve datos ESTRUCTURADOS de la API pública del sitio —versión y\n * licencia de un paquete, no el HTML de la página—; si ninguno encaja o falla,\n * cae al fetch genérico + limpieza de HTML de siempre.\n *\n * `web_fetch` trae guardas contra SSRF. Una tool que descarga cualquier URL que\n * el modelo proponga es, sin ellas, una puerta a la red interna: basta con que\n * el modelo lea una URL en un README para que acabe pidiéndola.\n *\n * El acceso a estas tools es opt-in por agente (`web: true`), nunca implícito\n * en `readOnly` — ver `resolveAllowedTools` en workflows/agent-runner.ts.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport type { ResultadoWeb } from \"./busqueda-nativa.ts\";\nimport { destinoPermitido } from \"./destino.ts\";\nimport { buscarConProveedores } from \"./proveedores/registro.ts\";\nimport { encontrarScraper } from \"./scrapers/registro.ts\";\nimport { htmlToText } from \"./texto.ts\";\n\nexport { htmlToText };\n\nconst MAX_FETCH_BYTES = 512 * 1024;\nconst DEFAULT_TIMEOUT_MS = 20_000;\n\nexport interface WebToolsOptions {\n\t/**\n\t * Clave de un proveedor de búsqueda de terceros, por nombre (`serper`,\n\t * `brave`, `tavily`, `exa`, `searxng`): vault primero, variable de entorno\n\t * después. `undefined` cuando ese proveedor concreto no está configurado —\n\t * eso lo salta, no lo hace fallar.\n\t */\n\tobtenerClave: (nombreProveedor: string) => Promise<string | undefined>;\n\t/**\n\t * Búsqueda con la credencial del modelo, cuando el proveedor la trae.\n\t *\n\t * Es lo que hace que `web_search` funcione sin configurar nada: el usuario ya\n\t * tiene credencial —es con la que corre el agente— y los modelos de Anthropic\n\t * saben buscar solos. Sin esto, la respuesta de fábrica era «Búsqueda web no\n\t * configurada», que para un agente de código equivale a no poder mirar la\n\t * documentación de ninguna librería.\n\t *\n\t * Va PRIMERO: es la credencial que el usuario ya está pagando, así que no\n\t * tiene sentido preguntar por una clave de terceros antes de intentarla.\n\t *\n\t * Devuelve `null` cuando NO puede buscar (el proveedor activo no trae\n\t * búsqueda propia) y `[]` cuando ha buscado y no ha encontrado nada. Los dos\n\t * casos se leen igual desde fuera y no son lo mismo: al agente hay que\n\t * decirle «no puedo» para que cambie de estrategia, no «no hay» para que se\n\t * rinda. Se cometió justo ese fallo aquí, y solo salió ejecutando el\n\t * producto: con un modelo de OpenRouter la tool contestaba «Sin resultados»\n\t * cuando en realidad no había buscado.\n\t */\n\tbuscarNativo?: (consulta: string, maximo: number) => Promise<ResultadoWeb[] | null>;\n\tfetchImpl?: typeof fetch;\n\t/**\n\t * Anota una salida a la red en el libro de sesión: art. 44 y ss. del RGPD,\n\t * \"qué salió de la máquina y hacia dónde\".\n\t *\n\t * El tipo `red` del libro existía sin que nadie lo anotara. Se engancha aquí y\n\t * no en el manejador de tools de `agent-session.ts` porque desde allí el único\n\t * destino visible es la URL que pidió el modelo, y la petición de verdad la\n\t * hacen los scrapers y los proveedores de búsqueda a OTROS dominios (la API de\n\t * npm, DuckDuckGo…). Envolviendo el `fetchImpl` que todos ellos comparten, el\n\t * destino que se registra es el real y no el pedido.\n\t *\n\t * Solo el DOMINIO, nunca la ruta ni los parámetros: una query string lleva\n\t * tokens y términos de búsqueda, y el libro guarda la forma, no el contenido.\n\t *\n\t * Nunca debe lanzar: un fallo del registro no puede tumbar una descarga.\n\t */\n\tanotarRed?: (dominio: string, permitido: boolean, motivo?: string) => void;\n\ttimeoutMs?: number;\n}\n\nfunction textResult(text: string): AgentToolResult<unknown> {\n\treturn { content: [{ type: \"text\" as const, text }], details: undefined };\n}\n\n/** Hosts que nunca deben alcanzarse desde una URL propuesta por el modelo. */\nconst BLOCKED_HOSTNAMES = new Set([\"localhost\", \"metadata.google.internal\", \"metadata\"]);\n\n/** Cuántos saltos se siguen antes de rendirse. Cada uno se revalida. */\nconst MAX_REDIRECCIONES = 5;\nconst PRIVATE_IPV4 =\n\t/^(?:10\\.|127\\.|0\\.|169\\.254\\.|192\\.168\\.|172\\.(?:1[6-9]|2\\d|3[01])\\.|100\\.(?:6[4-9]|[7-9]\\d|1[01]\\d|12[0-7])\\.)/;\n\n/**\n * Valida una URL antes de pedirla.\n *\n * Bloquea esquemas no-HTTP, loopback, rangos privados y el endpoint de metadatos\n * de los proveedores cloud — que es el objetivo clásico de un SSRF y devuelve\n * credenciales de la instancia.\n */\nexport function assertFetchableUrl(raw: string): URL {\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(raw);\n\t} catch {\n\t\tthrow new Error(`URL inválida: ${raw}`);\n\t}\n\tif (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n\t\tthrow new Error(`Solo se permiten http y https (recibido: ${url.protocol}).`);\n\t}\n\tconst host = url.hostname.toLowerCase().replace(/^\\[|\\]$/g, \"\");\n\tif (host === \"169.254.169.254\") throw new Error(\"Endpoint de metadatos cloud bloqueado.\");\n\tif (BLOCKED_HOSTNAMES.has(host) || host.endsWith(\".localhost\")) {\n\t\tthrow new Error(`Host bloqueado: ${host}`);\n\t}\n\tif (PRIVATE_IPV4.test(host) || host === \"::1\" || host.startsWith(\"fc\") || host.startsWith(\"fd\")) {\n\t\tthrow new Error(`Dirección de red privada bloqueada: ${host}`);\n\t}\n\treturn url;\n}\n\nconst searchParams = Type.Object({\n\tquery: Type.String({ description: \"Consulta de búsqueda.\" }),\n\tcount: Type.Optional(Type.Number({ description: \"Número de resultados (por defecto 5, máximo 10).\" })),\n});\n\nconst fetchParams = Type.Object({\n\turl: Type.String({ description: \"URL http(s) a descargar.\" }),\n});\n\n/** Formatea resultados de búsqueda (nativos o de un proveedor) como texto numerado. */\nfunction formatearResultados(\n\tresultados: Array<{ titulo: string; url: string; resumen?: string; edad?: string }>,\n): string {\n\treturn resultados\n\t\t.map((r, i) => {\n\t\t\tconst partes = [`${i + 1}. ${r.titulo}`, `   ${r.url}`];\n\t\t\tif (r.resumen) partes.push(`   ${r.resumen}`);\n\t\t\tif (r.edad) partes.push(`   (${r.edad})`);\n\t\t\treturn partes.join(\"\\n\");\n\t\t})\n\t\t.join(\"\\n\\n\");\n}\n\n/**\n * El dominio de destino, o `null` si no se puede leer.\n *\n * Solo el hostname: la ruta y la query se descartan aquí a propósito, porque es\n * el único sitio por el que pasan y un `?api_key=…` en el libro sería la fuga\n * que el libro existe para no tener.\n */\n// `Parameters<typeof fetch>[0]` y no `RequestInfo`: el proyecto compila sin la\n// librería DOM, así que ese nombre global no existe aquí.\nfunction dominioDe(destino: Parameters<typeof fetch>[0]): string | null {\n\ttry {\n\t\tconst crudo = typeof destino === \"string\" ? destino : destino instanceof URL ? destino.href : destino.url;\n\t\treturn new URL(crudo).hostname || null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport function createWebTools(options: WebToolsOptions): Record<string, ToolDefinition> {\n\tconst fetchCrudo = options.fetchImpl ?? fetch;\n\tconst anotarRed = options.anotarRed;\n\t// Un solo punto para todas las salidas: este `fetchImpl` es el que reciben los\n\t// scrapers (`modulo.scrapear(url, fetchImpl, …)`) y los proveedores de\n\t// búsqueda (`buscarConProveedores(…, { fetchImpl })`), así que envolverlo una\n\t// vez registra las salidas de los tres caminos y no solo del fetch genérico.\n\tconst fetchImpl: typeof fetch = anotarRed\n\t\t? (destino, init) => {\n\t\t\t\tconst dominio = dominioDe(destino);\n\t\t\t\t// `try` porque el registro es best-effort y la descarga no lo es.\n\t\t\t\tif (dominio) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tanotarRed(dominio, true);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Un fallo del libro no puede impedir una descarga.\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn fetchCrudo(destino, init);\n\t\t\t}\n\t\t: fetchCrudo;\n\tconst timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\n\t/** Aborta la petición si tarda demasiado, y respeta el abort del agente. */\n\tconst withTimeout = async (\n\t\touter: AbortSignal | undefined,\n\t\trun: (signal: AbortSignal) => Promise<Response>,\n\t): Promise<Response> => {\n\t\tconst controller = new AbortController();\n\t\tconst timer = setTimeout(() => controller.abort(), timeoutMs);\n\t\tconst onAbort = () => controller.abort();\n\t\touter?.addEventListener(\"abort\", onAbort);\n\t\ttry {\n\t\t\treturn await run(controller.signal);\n\t\t} finally {\n\t\t\tclearTimeout(timer);\n\t\t\touter?.removeEventListener(\"abort\", onAbort);\n\t\t}\n\t};\n\n\tconst webSearch: ToolDefinition<typeof searchParams> = {\n\t\tname: \"web_search\",\n\t\tlabel: \"Buscar en la web\",\n\t\tdescription:\n\t\t\t\"Busca en la web y devuelve resultados con título, URL y extracto. \" +\n\t\t\t\"Úsalo para hechos que puedan haber cambiado o que no estén en el repositorio. \" +\n\t\t\t\"Cita siempre la URL exacta: un resultado sin fuente no vale como evidencia.\",\n\t\tpromptSnippet: \"buscar en la web\",\n\t\tparameters: searchParams,\n\t\tasync execute(_toolCallId, input, signal): Promise<AgentToolResult<unknown>> {\n\t\t\tconst query = String(input.query ?? \"\").trim();\n\t\t\tif (!query) return textResult(\"Error: 'query' es obligatorio.\");\n\t\t\tconst count = Math.min(Math.max(Number(input.count) || 5, 1), 10);\n\n\t\t\t// 1) Nativo del proveedor de modelo: la credencial que el usuario ya paga.\n\t\t\tif (options.buscarNativo) {\n\t\t\t\ttry {\n\t\t\t\t\tconst nativos = await options.buscarNativo(query, count);\n\t\t\t\t\tif (nativos !== null) {\n\t\t\t\t\t\tif (nativos.length === 0) return textResult(`Sin resultados para: ${query}`);\n\t\t\t\t\t\treturn textResult(formatearResultados(nativos));\n\t\t\t\t\t}\n\t\t\t\t\t// null: el proveedor activo no trae búsqueda propia — seguir al registro.\n\t\t\t\t} catch (error) {\n\t\t\t\t\treturn textResult(\n\t\t\t\t\t\t`La búsqueda con el modelo falló: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// 2) Registro de proveedores: clave configurada > sin clave. Los tres sin\n\t\t\t// clave (duckduckgo, mojeek, ecosia) están siempre en la lista, así que\n\t\t\t// esto SIEMPRE tiene algo que probar — nunca \"no configurado\".\n\t\t\ttry {\n\t\t\t\tconst { resultados } = await buscarConProveedores(query, count, {\n\t\t\t\t\tobtenerClave: options.obtenerClave,\n\t\t\t\t\tfetchImpl,\n\t\t\t\t\tsignal,\n\t\t\t\t});\n\t\t\t\tif (resultados.length === 0) return textResult(`Sin resultados para: ${query}`);\n\t\t\t\treturn textResult(formatearResultados(resultados));\n\t\t\t} catch (error) {\n\t\t\t\t// Un fallo de red o de todos los proveedores es un FALLO, no \"sin\n\t\t\t\t// resultados\": el agente debe saber que no se ha buscado de verdad.\n\t\t\t\treturn textResult(`La búsqueda falló: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst webFetch: ToolDefinition<typeof fetchParams> = {\n\t\tname: \"web_fetch\",\n\t\tlabel: \"Descargar URL\",\n\t\tdescription:\n\t\t\t\"Descarga una URL y devuelve su texto. Úsalo tras web_search para leer una fuente concreta. \" +\n\t\t\t\"Para registros de paquetes (npm, PyPI, crates.io…), GitHub, MDN, Stack Overflow y CVEs (NVD, CISA \" +\n\t\t\t\"KEV) devuelve datos estructurados en vez de HTML. Solo http/https públicos: la red interna está bloqueada.\",\n\t\tpromptSnippet: \"leer el contenido de una URL\",\n\t\tparameters: fetchParams,\n\t\tasync execute(_toolCallId, input, signal): Promise<AgentToolResult<unknown>> {\n\t\t\tconst raw = String(input.url ?? \"\").trim();\n\t\t\tif (!raw) return textResult(\"Error: 'url' es obligatorio.\");\n\t\t\tlet url: URL;\n\t\t\ttry {\n\t\t\t\turl = assertFetchableUrl(raw);\n\t\t\t} catch (error) {\n\t\t\t\tconst motivo = error instanceof Error ? error.message : String(error);\n\t\t\t\t// Un intento BLOQUEADO es tan auditable como una salida consumada, y es\n\t\t\t\t// el único que no pasa por el `fetchImpl` envuelto: la guarda SSRF corta\n\t\t\t\t// antes. Sin esta línea el libro solo tendría `permitido: true` y el\n\t\t\t\t// campo `permitido` sería decorativo — un registro que dice siempre lo\n\t\t\t\t// mismo no distingue nada.\n\t\t\t\ttry {\n\t\t\t\t\tanotarRed?.(dominioDe(raw) ?? \"(url ilegible)\", false, motivo);\n\t\t\t\t} catch {\n\t\t\t\t\t// best-effort, igual que arriba.\n\t\t\t\t}\n\t\t\t\treturn textResult(`Error: ${motivo}`);\n\t\t\t}\n\n\t\t\t// Scraper especializado primero: datos estructurados de la API del sitio\n\t\t\t// en vez del HTML de la página. Si no encaja o falla, se cae al fetch\n\t\t\t// genérico de siempre — la URL sigue siendo legible aunque no se pueda\n\t\t\t// enriquecer.\n\t\t\tconst descriptor = encontrarScraper(url);\n\t\t\tif (descriptor) {\n\t\t\t\ttry {\n\t\t\t\t\tconst modulo = await descriptor.cargar();\n\t\t\t\t\tconst resultado = await modulo.scrapear(url, fetchImpl, signal);\n\t\t\t\t\tif (resultado) {\n\t\t\t\t\t\treturn textResult(\n\t\t\t\t\t\t\t`${resultado.titulo}\\n${resultado.url}\\n\\n${resultado.resumen}\\n\\nDatos estructurados:\\n` +\n\t\t\t\t\t\t\t\tJSON.stringify(resultado.datos, null, 2),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// El scraper falló: se cae al fetch genérico en vez de dejar la\n\t\t\t\t\t// tool en blanco. La URL sigue siendo lo que el usuario pidió leer.\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// La dirección, no el nombre. `assertFetchableUrl` compara cadenas y deja\n\t\t\t// pasar todo lo que llega al mismo sitio por otro camino: medido,\n\t\t\t// `[::ffff:127.0.0.1]` y un dominio que resuelve a 127.0.0.1 pasaban\n\t\t\t// enteros. Ver `core/web/destino.ts`.\n\t\t\tconst rechazo = await destinoPermitido(url);\n\t\t\tif (rechazo) {\n\t\t\t\tanotarRed?.(url.hostname, false, rechazo.motivo);\n\t\t\t\treturn textResult(\n\t\t\t\t\t`Descarga bloqueada: ${rechazo.motivo}${rechazo.direccion ? ` (${rechazo.direccion})` : \"\"}. ` +\n\t\t\t\t\t\t\"Las tools web no alcanzan la red interna ni la propia máquina.\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\t// `redirect: \"manual\"` y cada salto revalidado. Con `follow`, una URL\n\t\t\t\t// pública que responde 302 hacia loopback llegaba igual, porque solo se\n\t\t\t\t// miraba la primera — era el tercer camino abierto de los tres.\n\t\t\t\tlet destino = url;\n\t\t\t\tlet response: Response | undefined;\n\t\t\t\tfor (let salto = 0; salto <= MAX_REDIRECCIONES; salto++) {\n\t\t\t\t\tresponse = await withTimeout(signal, (s) =>\n\t\t\t\t\t\tfetchImpl(destino.toString(), {\n\t\t\t\t\t\t\tredirect: \"manual\",\n\t\t\t\t\t\t\tsignal: s,\n\t\t\t\t\t\t\theaders: { \"user-agent\": \"ada-cli\" },\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t\tif (response.status < 300 || response.status >= 400) break;\n\t\t\t\t\tconst siguiente = response.headers.get(\"location\");\n\t\t\t\t\tif (!siguiente) break;\n\t\t\t\t\tif (salto === MAX_REDIRECCIONES) {\n\t\t\t\t\t\treturn textResult(`La descarga dio más de ${MAX_REDIRECCIONES} redirecciones y se ha parado.`);\n\t\t\t\t\t}\n\t\t\t\t\t// Relativa respecto al destino actual, como manda el estándar.\n\t\t\t\t\tdestino = new URL(siguiente, destino);\n\t\t\t\t\tassertFetchableUrl(destino.toString());\n\t\t\t\t\tconst rechazoSalto = await destinoPermitido(destino);\n\t\t\t\t\tif (rechazoSalto) {\n\t\t\t\t\t\tanotarRed?.(destino.hostname, false, `redirección a ${rechazoSalto.motivo}`);\n\t\t\t\t\t\treturn textResult(\n\t\t\t\t\t\t\t`Descarga bloqueada: la redirección lleva a ${rechazoSalto.motivo}` +\n\t\t\t\t\t\t\t\t`${rechazoSalto.direccion ? ` (${rechazoSalto.direccion})` : \"\"}.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tanotarRed?.(destino.hostname, true, \"redirección\");\n\t\t\t\t}\n\t\t\t\tif (!response) return textResult(\"La descarga no devolvió respuesta.\");\n\t\t\t\tif (!response.ok) return textResult(`La descarga devolvió HTTP ${response.status}.`);\n\t\t\t\tconst body = await response.text();\n\t\t\t\tconst truncated = body.length > MAX_FETCH_BYTES;\n\t\t\t\tconst text = htmlToText(body.slice(0, MAX_FETCH_BYTES));\n\t\t\t\treturn textResult(truncated ? `${text}\\n\\n[truncado en ${MAX_FETCH_BYTES} bytes]` : text);\n\t\t\t} catch (error) {\n\t\t\t\treturn textResult(`La descarga falló: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t},\n\t};\n\n\treturn { web_search: webSearch as ToolDefinition, web_fetch: webFetch as ToolDefinition };\n}\n"]}

package/dist/core/web/tools.js

@@ -0,0 +1,304 @@
+/**
+ * Tools de web: `web_search` y `web_fetch`.
+ *
+ * Existían por su NOMBRE en el builtin `deep_research` pero nadie las
+ * registraba, así que ese workflow —uno de los cinco que anunciamos— no podía
+ * funcionar: le pedía al agente usar herramientas inexistentes. Un nombre de
+ * tool dentro de un prompt no lo comprueba ni el compilador ni los tests.
+ *
+ * `web_search` prueba, en orden: la búsqueda nativa del proveedor de modelo
+ * activo (ya es la credencial con la que corre el agente) → el registro de
+ * proveedores de terceros con clave configurada (`proveedores/registro.ts`,
+ * vault primero, variable de entorno después) → los proveedores sin clave
+ * (DuckDuckGo, Mojeek, Ecosia), que garantizan que `web_search` funciona de
+ * fábrica incluso sin ninguna credencial de terceros y con un modelo que no
+ * traiga búsqueda propia.
+ *
+ * `web_fetch` prueba primero un scraper especializado (`scrapers/registro.ts`)
+ * que devuelve datos ESTRUCTURADOS de la API pública del sitio —versión y
+ * licencia de un paquete, no el HTML de la página—; si ninguno encaja o falla,
+ * cae al fetch genérico + limpieza de HTML de siempre.
+ *
+ * `web_fetch` trae guardas contra SSRF. Una tool que descarga cualquier URL que
+ * el modelo proponga es, sin ellas, una puerta a la red interna: basta con que
+ * el modelo lea una URL en un README para que acabe pidiéndola.
+ *
+ * El acceso a estas tools es opt-in por agente (`web: true`), nunca implícito
+ * en `readOnly` — ver `resolveAllowedTools` en workflows/agent-runner.ts.
+ */
+import { Type } from "typebox";
+import { destinoPermitido } from "./destino.js";
+import { buscarConProveedores } from "./proveedores/registro.js";
+import { encontrarScraper } from "./scrapers/registro.js";
+import { htmlToText } from "./texto.js";
+export { htmlToText };
+const MAX_FETCH_BYTES = 512 * 1024;
+const DEFAULT_TIMEOUT_MS = 20_000;
+function textResult(text) {
+    return { content: [{ type: "text", text }], details: undefined };
+}
+/** Hosts que nunca deben alcanzarse desde una URL propuesta por el modelo. */
+const BLOCKED_HOSTNAMES = new Set(["localhost", "metadata.google.internal", "metadata"]);
+/** Cuántos saltos se siguen antes de rendirse. Cada uno se revalida. */
+const MAX_REDIRECCIONES = 5;
+const PRIVATE_IPV4 = /^(?:10\.|127\.|0\.|169\.254\.|192\.168\.|172\.(?:1[6-9]|2\d|3[01])\.|100\.(?:6[4-9]|[7-9]\d|1[01]\d|12[0-7])\.)/;
+/**
+ * Valida una URL antes de pedirla.
+ *
+ * Bloquea esquemas no-HTTP, loopback, rangos privados y el endpoint de metadatos
+ * de los proveedores cloud — que es el objetivo clásico de un SSRF y devuelve
+ * credenciales de la instancia.
+ */
+export function assertFetchableUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new Error(`URL inválida: ${raw}`);
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error(`Solo se permiten http y https (recibido: ${url.protocol}).`);
+    }
+    const host = url.hostname.toLowerCase().replace(/^\[|\]$/g, "");
+    if (host === "169.254.169.254")
+        throw new Error("Endpoint de metadatos cloud bloqueado.");
+    if (BLOCKED_HOSTNAMES.has(host) || host.endsWith(".localhost")) {
+        throw new Error(`Host bloqueado: ${host}`);
+    }
+    if (PRIVATE_IPV4.test(host) || host === "::1" || host.startsWith("fc") || host.startsWith("fd")) {
+        throw new Error(`Dirección de red privada bloqueada: ${host}`);
+    }
+    return url;
+}
+const searchParams = Type.Object({
+    query: Type.String({ description: "Consulta de búsqueda." }),
+    count: Type.Optional(Type.Number({ description: "Número de resultados (por defecto 5, máximo 10)." })),
+});
+const fetchParams = Type.Object({
+    url: Type.String({ description: "URL http(s) a descargar." }),
+});
+/** Formatea resultados de búsqueda (nativos o de un proveedor) como texto numerado. */
+function formatearResultados(resultados) {
+    return resultados
+        .map((r, i) => {
+        const partes = [`${i + 1}. ${r.titulo}`, `   ${r.url}`];
+        if (r.resumen)
+            partes.push(`   ${r.resumen}`);
+        if (r.edad)
+            partes.push(`   (${r.edad})`);
+        return partes.join("\n");
+    })
+        .join("\n\n");
+}
+/**
+ * El dominio de destino, o `null` si no se puede leer.
+ *
+ * Solo el hostname: la ruta y la query se descartan aquí a propósito, porque es
+ * el único sitio por el que pasan y un `?api_key=…` en el libro sería la fuga
+ * que el libro existe para no tener.
+ */
+// `Parameters<typeof fetch>[0]` y no `RequestInfo`: el proyecto compila sin la
+// librería DOM, así que ese nombre global no existe aquí.
+function dominioDe(destino) {
+    try {
+        const crudo = typeof destino === "string" ? destino : destino instanceof URL ? destino.href : destino.url;
+        return new URL(crudo).hostname || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function createWebTools(options) {
+    const fetchCrudo = options.fetchImpl ?? fetch;
+    const anotarRed = options.anotarRed;
+    // Un solo punto para todas las salidas: este `fetchImpl` es el que reciben los
+    // scrapers (`modulo.scrapear(url, fetchImpl, …)`) y los proveedores de
+    // búsqueda (`buscarConProveedores(…, { fetchImpl })`), así que envolverlo una
+    // vez registra las salidas de los tres caminos y no solo del fetch genérico.
+    const fetchImpl = anotarRed
+        ? (destino, init) => {
+            const dominio = dominioDe(destino);
+            // `try` porque el registro es best-effort y la descarga no lo es.
+            if (dominio) {
+                try {
+                    anotarRed(dominio, true);
+                }
+                catch {
+                    // Un fallo del libro no puede impedir una descarga.
+                }
+            }
+            return fetchCrudo(destino, init);
+        }
+        : fetchCrudo;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    /** Aborta la petición si tarda demasiado, y respeta el abort del agente. */
+    const withTimeout = async (outer, run) => {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const onAbort = () => controller.abort();
+        outer?.addEventListener("abort", onAbort);
+        try {
+            return await run(controller.signal);
+        }
+        finally {
+            clearTimeout(timer);
+            outer?.removeEventListener("abort", onAbort);
+        }
+    };
+    const webSearch = {
+        name: "web_search",
+        label: "Buscar en la web",
+        description: "Busca en la web y devuelve resultados con título, URL y extracto. " +
+            "Úsalo para hechos que puedan haber cambiado o que no estén en el repositorio. " +
+            "Cita siempre la URL exacta: un resultado sin fuente no vale como evidencia.",
+        promptSnippet: "buscar en la web",
+        parameters: searchParams,
+        async execute(_toolCallId, input, signal) {
+            const query = String(input.query ?? "").trim();
+            if (!query)
+                return textResult("Error: 'query' es obligatorio.");
+            const count = Math.min(Math.max(Number(input.count) || 5, 1), 10);
+            // 1) Nativo del proveedor de modelo: la credencial que el usuario ya paga.
+            if (options.buscarNativo) {
+                try {
+                    const nativos = await options.buscarNativo(query, count);
+                    if (nativos !== null) {
+                        if (nativos.length === 0)
+                            return textResult(`Sin resultados para: ${query}`);
+                        return textResult(formatearResultados(nativos));
+                    }
+                    // null: el proveedor activo no trae búsqueda propia — seguir al registro.
+                }
+                catch (error) {
+                    return textResult(`La búsqueda con el modelo falló: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+            // 2) Registro de proveedores: clave configurada > sin clave. Los tres sin
+            // clave (duckduckgo, mojeek, ecosia) están siempre en la lista, así que
+            // esto SIEMPRE tiene algo que probar — nunca "no configurado".
+            try {
+                const { resultados } = await buscarConProveedores(query, count, {
+                    obtenerClave: options.obtenerClave,
+                    fetchImpl,
+                    signal,
+                });
+                if (resultados.length === 0)
+                    return textResult(`Sin resultados para: ${query}`);
+                return textResult(formatearResultados(resultados));
+            }
+            catch (error) {
+                // Un fallo de red o de todos los proveedores es un FALLO, no "sin
+                // resultados": el agente debe saber que no se ha buscado de verdad.
+                return textResult(`La búsqueda falló: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    };
+    const webFetch = {
+        name: "web_fetch",
+        label: "Descargar URL",
+        description: "Descarga una URL y devuelve su texto. Úsalo tras web_search para leer una fuente concreta. " +
+            "Para registros de paquetes (npm, PyPI, crates.io…), GitHub, MDN, Stack Overflow y CVEs (NVD, CISA " +
+            "KEV) devuelve datos estructurados en vez de HTML. Solo http/https públicos: la red interna está bloqueada.",
+        promptSnippet: "leer el contenido de una URL",
+        parameters: fetchParams,
+        async execute(_toolCallId, input, signal) {
+            const raw = String(input.url ?? "").trim();
+            if (!raw)
+                return textResult("Error: 'url' es obligatorio.");
+            let url;
+            try {
+                url = assertFetchableUrl(raw);
+            }
+            catch (error) {
+                const motivo = error instanceof Error ? error.message : String(error);
+                // Un intento BLOQUEADO es tan auditable como una salida consumada, y es
+                // el único que no pasa por el `fetchImpl` envuelto: la guarda SSRF corta
+                // antes. Sin esta línea el libro solo tendría `permitido: true` y el
+                // campo `permitido` sería decorativo — un registro que dice siempre lo
+                // mismo no distingue nada.
+                try {
+                    anotarRed?.(dominioDe(raw) ?? "(url ilegible)", false, motivo);
+                }
+                catch {
+                    // best-effort, igual que arriba.
+                }
+                return textResult(`Error: ${motivo}`);
+            }
+            // Scraper especializado primero: datos estructurados de la API del sitio
+            // en vez del HTML de la página. Si no encaja o falla, se cae al fetch
+            // genérico de siempre — la URL sigue siendo legible aunque no se pueda
+            // enriquecer.
+            const descriptor = encontrarScraper(url);
+            if (descriptor) {
+                try {
+                    const modulo = await descriptor.cargar();
+                    const resultado = await modulo.scrapear(url, fetchImpl, signal);
+                    if (resultado) {
+                        return textResult(`${resultado.titulo}\n${resultado.url}\n\n${resultado.resumen}\n\nDatos estructurados:\n` +
+                            JSON.stringify(resultado.datos, null, 2));
+                    }
+                }
+                catch {
+                    // El scraper falló: se cae al fetch genérico en vez de dejar la
+                    // tool en blanco. La URL sigue siendo lo que el usuario pidió leer.
+                }
+            }
+            // La dirección, no el nombre. `assertFetchableUrl` compara cadenas y deja
+            // pasar todo lo que llega al mismo sitio por otro camino: medido,
+            // `[::ffff:127.0.0.1]` y un dominio que resuelve a 127.0.0.1 pasaban
+            // enteros. Ver `core/web/destino.ts`.
+            const rechazo = await destinoPermitido(url);
+            if (rechazo) {
+                anotarRed?.(url.hostname, false, rechazo.motivo);
+                return textResult(`Descarga bloqueada: ${rechazo.motivo}${rechazo.direccion ? ` (${rechazo.direccion})` : ""}. ` +
+                    "Las tools web no alcanzan la red interna ni la propia máquina.");
+            }
+            try {
+                // `redirect: "manual"` y cada salto revalidado. Con `follow`, una URL
+                // pública que responde 302 hacia loopback llegaba igual, porque solo se
+                // miraba la primera — era el tercer camino abierto de los tres.
+                let destino = url;
+                let response;
+                for (let salto = 0; salto <= MAX_REDIRECCIONES; salto++) {
+                    response = await withTimeout(signal, (s) => fetchImpl(destino.toString(), {
+                        redirect: "manual",
+                        signal: s,
+                        headers: { "user-agent": "ada-cli" },
+                    }));
+                    if (response.status < 300 || response.status >= 400)
+                        break;
+                    const siguiente = response.headers.get("location");
+                    if (!siguiente)
+                        break;
+                    if (salto === MAX_REDIRECCIONES) {
+                        return textResult(`La descarga dio más de ${MAX_REDIRECCIONES} redirecciones y se ha parado.`);
+                    }
+                    // Relativa respecto al destino actual, como manda el estándar.
+                    destino = new URL(siguiente, destino);
+                    assertFetchableUrl(destino.toString());
+                    const rechazoSalto = await destinoPermitido(destino);
+                    if (rechazoSalto) {
+                        anotarRed?.(destino.hostname, false, `redirección a ${rechazoSalto.motivo}`);
+                        return textResult(`Descarga bloqueada: la redirección lleva a ${rechazoSalto.motivo}` +
+                            `${rechazoSalto.direccion ? ` (${rechazoSalto.direccion})` : ""}.`);
+                    }
+                    anotarRed?.(destino.hostname, true, "redirección");
+                }
+                if (!response)
+                    return textResult("La descarga no devolvió respuesta.");
+                if (!response.ok)
+                    return textResult(`La descarga devolvió HTTP ${response.status}.`);
+                const body = await response.text();
+                const truncated = body.length > MAX_FETCH_BYTES;
+                const text = htmlToText(body.slice(0, MAX_FETCH_BYTES));
+                return textResult(truncated ? `${text}\n\n[truncado en ${MAX_FETCH_BYTES} bytes]` : text);
+            }
+            catch (error) {
+                return textResult(`La descarga falló: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    };
+    return { web_search: webSearch, web_fetch: webFetch };
+}
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/core/web/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tools de web: `web_search` y `web_fetch`.\n *\n * Existían por su NOMBRE en el builtin `deep_research` pero nadie las\n * registraba, así que ese workflow —uno de los cinco que anunciamos— no podía\n * funcionar: le pedía al agente usar herramientas inexistentes. Un nombre de\n * tool dentro de un prompt no lo comprueba ni el compilador ni los tests.\n *\n * `web_search` prueba, en orden: la búsqueda nativa del proveedor de modelo\n * activo (ya es la credencial con la que corre el agente) → el registro de\n * proveedores de terceros con clave configurada (`proveedores/registro.ts`,\n * vault primero, variable de entorno después) → los proveedores sin clave\n * (DuckDuckGo, Mojeek, Ecosia), que garantizan que `web_search` funciona de\n * fábrica incluso sin ninguna credencial de terceros y con un modelo que no\n * traiga búsqueda propia.\n *\n * `web_fetch` prueba primero un scraper especializado (`scrapers/registro.ts`)\n * que devuelve datos ESTRUCTURADOS de la API pública del sitio —versión y\n * licencia de un paquete, no el HTML de la página—; si ninguno encaja o falla,\n * cae al fetch genérico + limpieza de HTML de siempre.\n *\n * `web_fetch` trae guardas contra SSRF. Una tool que descarga cualquier URL que\n * el modelo proponga es, sin ellas, una puerta a la red interna: basta con que\n * el modelo lea una URL en un README para que acabe pidiéndola.\n *\n * El acceso a estas tools es opt-in por agente (`web: true`), nunca implícito\n * en `readOnly` — ver `resolveAllowedTools` en workflows/agent-runner.ts.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport type { ResultadoWeb } from \"./busqueda-nativa.ts\";\nimport { destinoPermitido } from \"./destino.ts\";\nimport { buscarConProveedores } from \"./proveedores/registro.ts\";\nimport { encontrarScraper } from \"./scrapers/registro.ts\";\nimport { htmlToText } from \"./texto.ts\";\n\nexport { htmlToText };\n\nconst MAX_FETCH_BYTES = 512 * 1024;\nconst DEFAULT_TIMEOUT_MS = 20_000;\n\nexport interface WebToolsOptions {\n\t/**\n\t * Clave de un proveedor de búsqueda de terceros, por nombre (`serper`,\n\t * `brave`, `tavily`, `exa`, `searxng`): vault primero, variable de entorno\n\t * después. `undefined` cuando ese proveedor concreto no está configurado —\n\t * eso lo salta, no lo hace fallar.\n\t */\n\tobtenerClave: (nombreProveedor: string) => Promise<string | undefined>;\n\t/**\n\t * Búsqueda con la credencial del modelo, cuando el proveedor la trae.\n\t *\n\t * Es lo que hace que `web_search` funcione sin configurar nada: el usuario ya\n\t * tiene credencial —es con la que corre el agente— y los modelos de Anthropic\n\t * saben buscar solos. Sin esto, la respuesta de fábrica era «Búsqueda web no\n\t * configurada», que para un agente de código equivale a no poder mirar la\n\t * documentación de ninguna librería.\n\t *\n\t * Va PRIMERO: es la credencial que el usuario ya está pagando, así que no\n\t * tiene sentido preguntar por una clave de terceros antes de intentarla.\n\t *\n\t * Devuelve `null` cuando NO puede buscar (el proveedor activo no trae\n\t * búsqueda propia) y `[]` cuando ha buscado y no ha encontrado nada. Los dos\n\t * casos se leen igual desde fuera y no son lo mismo: al agente hay que\n\t * decirle «no puedo» para que cambie de estrategia, no «no hay» para que se\n\t * rinda. Se cometió justo ese fallo aquí, y solo salió ejecutando el\n\t * producto: con un modelo de OpenRouter la tool contestaba «Sin resultados»\n\t * cuando en realidad no había buscado.\n\t */\n\tbuscarNativo?: (consulta: string, maximo: number) => Promise<ResultadoWeb[] | null>;\n\tfetchImpl?: typeof fetch;\n\t/**\n\t * Anota una salida a la red en el libro de sesión: art. 44 y ss. del RGPD,\n\t * \"qué salió de la máquina y hacia dónde\".\n\t *\n\t * El tipo `red` del libro existía sin que nadie lo anotara. Se engancha aquí y\n\t * no en el manejador de tools de `agent-session.ts` porque desde allí el único\n\t * destino visible es la URL que pidió el modelo, y la petición de verdad la\n\t * hacen los scrapers y los proveedores de búsqueda a OTROS dominios (la API de\n\t * npm, DuckDuckGo…). Envolviendo el `fetchImpl` que todos ellos comparten, el\n\t * destino que se registra es el real y no el pedido.\n\t *\n\t * Solo el DOMINIO, nunca la ruta ni los parámetros: una query string lleva\n\t * tokens y términos de búsqueda, y el libro guarda la forma, no el contenido.\n\t *\n\t * Nunca debe lanzar: un fallo del registro no puede tumbar una descarga.\n\t */\n\tanotarRed?: (dominio: string, permitido: boolean, motivo?: string) => void;\n\ttimeoutMs?: number;\n}\n\nfunction textResult(text: string): AgentToolResult<unknown> {\n\treturn { content: [{ type: \"text\" as const, text }], details: undefined };\n}\n\n/** Hosts que nunca deben alcanzarse desde una URL propuesta por el modelo. */\nconst BLOCKED_HOSTNAMES = new Set([\"localhost\", \"metadata.google.internal\", \"metadata\"]);\n\n/** Cuántos saltos se siguen antes de rendirse. Cada uno se revalida. */\nconst MAX_REDIRECCIONES = 5;\nconst PRIVATE_IPV4 =\n\t/^(?:10\\.|127\\.|0\\.|169\\.254\\.|192\\.168\\.|172\\.(?:1[6-9]|2\\d|3[01])\\.|100\\.(?:6[4-9]|[7-9]\\d|1[01]\\d|12[0-7])\\.)/;\n\n/**\n * Valida una URL antes de pedirla.\n *\n * Bloquea esquemas no-HTTP, loopback, rangos privados y el endpoint de metadatos\n * de los proveedores cloud — que es el objetivo clásico de un SSRF y devuelve\n * credenciales de la instancia.\n */\nexport function assertFetchableUrl(raw: string): URL {\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(raw);\n\t} catch {\n\t\tthrow new Error(`URL inválida: ${raw}`);\n\t}\n\tif (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n\t\tthrow new Error(`Solo se permiten http y https (recibido: ${url.protocol}).`);\n\t}\n\tconst host = url.hostname.toLowerCase().replace(/^\\[|\\]$/g, \"\");\n\tif (host === \"169.254.169.254\") throw new Error(\"Endpoint de metadatos cloud bloqueado.\");\n\tif (BLOCKED_HOSTNAMES.has(host) || host.endsWith(\".localhost\")) {\n\t\tthrow new Error(`Host bloqueado: ${host}`);\n\t}\n\tif (PRIVATE_IPV4.test(host) || host === \"::1\" || host.startsWith(\"fc\") || host.startsWith(\"fd\")) {\n\t\tthrow new Error(`Dirección de red privada bloqueada: ${host}`);\n\t}\n\treturn url;\n}\n\nconst searchParams = Type.Object({\n\tquery: Type.String({ description: \"Consulta de búsqueda.\" }),\n\tcount: Type.Optional(Type.Number({ description: \"Número de resultados (por defecto 5, máximo 10).\" })),\n});\n\nconst fetchParams = Type.Object({\n\turl: Type.String({ description: \"URL http(s) a descargar.\" }),\n});\n\n/** Formatea resultados de búsqueda (nativos o de un proveedor) como texto numerado. */\nfunction formatearResultados(\n\tresultados: Array<{ titulo: string; url: string; resumen?: string; edad?: string }>,\n): string {\n\treturn resultados\n\t\t.map((r, i) => {\n\t\t\tconst partes = [`${i + 1}. ${r.titulo}`, `   ${r.url}`];\n\t\t\tif (r.resumen) partes.push(`   ${r.resumen}`);\n\t\t\tif (r.edad) partes.push(`   (${r.edad})`);\n\t\t\treturn partes.join(\"\\n\");\n\t\t})\n\t\t.join(\"\\n\\n\");\n}\n\n/**\n * El dominio de destino, o `null` si no se puede leer.\n *\n * Solo el hostname: la ruta y la query se descartan aquí a propósito, porque es\n * el único sitio por el que pasan y un `?api_key=…` en el libro sería la fuga\n * que el libro existe para no tener.\n */\n// `Parameters<typeof fetch>[0]` y no `RequestInfo`: el proyecto compila sin la\n// librería DOM, así que ese nombre global no existe aquí.\nfunction dominioDe(destino: Parameters<typeof fetch>[0]): string | null {\n\ttry {\n\t\tconst crudo = typeof destino === \"string\" ? destino : destino instanceof URL ? destino.href : destino.url;\n\t\treturn new URL(crudo).hostname || null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport function createWebTools(options: WebToolsOptions): Record<string, ToolDefinition> {\n\tconst fetchCrudo = options.fetchImpl ?? fetch;\n\tconst anotarRed = options.anotarRed;\n\t// Un solo punto para todas las salidas: este `fetchImpl` es el que reciben los\n\t// scrapers (`modulo.scrapear(url, fetchImpl, …)`) y los proveedores de\n\t// búsqueda (`buscarConProveedores(…, { fetchImpl })`), así que envolverlo una\n\t// vez registra las salidas de los tres caminos y no solo del fetch genérico.\n\tconst fetchImpl: typeof fetch = anotarRed\n\t\t? (destino, init) => {\n\t\t\t\tconst dominio = dominioDe(destino);\n\t\t\t\t// `try` porque el registro es best-effort y la descarga no lo es.\n\t\t\t\tif (dominio) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tanotarRed(dominio, true);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Un fallo del libro no puede impedir una descarga.\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn fetchCrudo(destino, init);\n\t\t\t}\n\t\t: fetchCrudo;\n\tconst timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\n\t/** Aborta la petición si tarda demasiado, y respeta el abort del agente. */\n\tconst withTimeout = async (\n\t\touter: AbortSignal | undefined,\n\t\trun: (signal: AbortSignal) => Promise<Response>,\n\t): Promise<Response> => {\n\t\tconst controller = new AbortController();\n\t\tconst timer = setTimeout(() => controller.abort(), timeoutMs);\n\t\tconst onAbort = () => controller.abort();\n\t\touter?.addEventListener(\"abort\", onAbort);\n\t\ttry {\n\t\t\treturn await run(controller.signal);\n\t\t} finally {\n\t\t\tclearTimeout(timer);\n\t\t\touter?.removeEventListener(\"abort\", onAbort);\n\t\t}\n\t};\n\n\tconst webSearch: ToolDefinition<typeof searchParams> = {\n\t\tname: \"web_search\",\n\t\tlabel: \"Buscar en la web\",\n\t\tdescription:\n\t\t\t\"Busca en la web y devuelve resultados con título, URL y extracto. \" +\n\t\t\t\"Úsalo para hechos que puedan haber cambiado o que no estén en el repositorio. \" +\n\t\t\t\"Cita siempre la URL exacta: un resultado sin fuente no vale como evidencia.\",\n\t\tpromptSnippet: \"buscar en la web\",\n\t\tparameters: searchParams,\n\t\tasync execute(_toolCallId, input, signal): Promise<AgentToolResult<unknown>> {\n\t\t\tconst query = String(input.query ?? \"\").trim();\n\t\t\tif (!query) return textResult(\"Error: 'query' es obligatorio.\");\n\t\t\tconst count = Math.min(Math.max(Number(input.count) || 5, 1), 10);\n\n\t\t\t// 1) Nativo del proveedor de modelo: la credencial que el usuario ya paga.\n\t\t\tif (options.buscarNativo) {\n\t\t\t\ttry {\n\t\t\t\t\tconst nativos = await options.buscarNativo(query, count);\n\t\t\t\t\tif (nativos !== null) {\n\t\t\t\t\t\tif (nativos.length === 0) return textResult(`Sin resultados para: ${query}`);\n\t\t\t\t\t\treturn textResult(formatearResultados(nativos));\n\t\t\t\t\t}\n\t\t\t\t\t// null: el proveedor activo no trae búsqueda propia — seguir al registro.\n\t\t\t\t} catch (error) {\n\t\t\t\t\treturn textResult(\n\t\t\t\t\t\t`La búsqueda con el modelo falló: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// 2) Registro de proveedores: clave configurada > sin clave. Los tres sin\n\t\t\t// clave (duckduckgo, mojeek, ecosia) están siempre en la lista, así que\n\t\t\t// esto SIEMPRE tiene algo que probar — nunca \"no configurado\".\n\t\t\ttry {\n\t\t\t\tconst { resultados } = await buscarConProveedores(query, count, {\n\t\t\t\t\tobtenerClave: options.obtenerClave,\n\t\t\t\t\tfetchImpl,\n\t\t\t\t\tsignal,\n\t\t\t\t});\n\t\t\t\tif (resultados.length === 0) return textResult(`Sin resultados para: ${query}`);\n\t\t\t\treturn textResult(formatearResultados(resultados));\n\t\t\t} catch (error) {\n\t\t\t\t// Un fallo de red o de todos los proveedores es un FALLO, no \"sin\n\t\t\t\t// resultados\": el agente debe saber que no se ha buscado de verdad.\n\t\t\t\treturn textResult(`La búsqueda falló: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst webFetch: ToolDefinition<typeof fetchParams> = {\n\t\tname: \"web_fetch\",\n\t\tlabel: \"Descargar URL\",\n\t\tdescription:\n\t\t\t\"Descarga una URL y devuelve su texto. Úsalo tras web_search para leer una fuente concreta. \" +\n\t\t\t\"Para registros de paquetes (npm, PyPI, crates.io…), GitHub, MDN, Stack Overflow y CVEs (NVD, CISA \" +\n\t\t\t\"KEV) devuelve datos estructurados en vez de HTML. Solo http/https públicos: la red interna está bloqueada.\",\n\t\tpromptSnippet: \"leer el contenido de una URL\",\n\t\tparameters: fetchParams,\n\t\tasync execute(_toolCallId, input, signal): Promise<AgentToolResult<unknown>> {\n\t\t\tconst raw = String(input.url ?? \"\").trim();\n\t\t\tif (!raw) return textResult(\"Error: 'url' es obligatorio.\");\n\t\t\tlet url: URL;\n\t\t\ttry {\n\t\t\t\turl = assertFetchableUrl(raw);\n\t\t\t} catch (error) {\n\t\t\t\tconst motivo = error instanceof Error ? error.message : String(error);\n\t\t\t\t// Un intento BLOQUEADO es tan auditable como una salida consumada, y es\n\t\t\t\t// el único que no pasa por el `fetchImpl` envuelto: la guarda SSRF corta\n\t\t\t\t// antes. Sin esta línea el libro solo tendría `permitido: true` y el\n\t\t\t\t// campo `permitido` sería decorativo — un registro que dice siempre lo\n\t\t\t\t// mismo no distingue nada.\n\t\t\t\ttry {\n\t\t\t\t\tanotarRed?.(dominioDe(raw) ?? \"(url ilegible)\", false, motivo);\n\t\t\t\t} catch {\n\t\t\t\t\t// best-effort, igual que arriba.\n\t\t\t\t}\n\t\t\t\treturn textResult(`Error: ${motivo}`);\n\t\t\t}\n\n\t\t\t// Scraper especializado primero: datos estructurados de la API del sitio\n\t\t\t// en vez del HTML de la página. Si no encaja o falla, se cae al fetch\n\t\t\t// genérico de siempre — la URL sigue siendo legible aunque no se pueda\n\t\t\t// enriquecer.\n\t\t\tconst descriptor = encontrarScraper(url);\n\t\t\tif (descriptor) {\n\t\t\t\ttry {\n\t\t\t\t\tconst modulo = await descriptor.cargar();\n\t\t\t\t\tconst resultado = await modulo.scrapear(url, fetchImpl, signal);\n\t\t\t\t\tif (resultado) {\n\t\t\t\t\t\treturn textResult(\n\t\t\t\t\t\t\t`${resultado.titulo}\\n${resultado.url}\\n\\n${resultado.resumen}\\n\\nDatos estructurados:\\n` +\n\t\t\t\t\t\t\t\tJSON.stringify(resultado.datos, null, 2),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// El scraper falló: se cae al fetch genérico en vez de dejar la\n\t\t\t\t\t// tool en blanco. La URL sigue siendo lo que el usuario pidió leer.\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// La dirección, no el nombre. `assertFetchableUrl` compara cadenas y deja\n\t\t\t// pasar todo lo que llega al mismo sitio por otro camino: medido,\n\t\t\t// `[::ffff:127.0.0.1]` y un dominio que resuelve a 127.0.0.1 pasaban\n\t\t\t// enteros. Ver `core/web/destino.ts`.\n\t\t\tconst rechazo = await destinoPermitido(url);\n\t\t\tif (rechazo) {\n\t\t\t\tanotarRed?.(url.hostname, false, rechazo.motivo);\n\t\t\t\treturn textResult(\n\t\t\t\t\t`Descarga bloqueada: ${rechazo.motivo}${rechazo.direccion ? ` (${rechazo.direccion})` : \"\"}. ` +\n\t\t\t\t\t\t\"Las tools web no alcanzan la red interna ni la propia máquina.\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\t// `redirect: \"manual\"` y cada salto revalidado. Con `follow`, una URL\n\t\t\t\t// pública que responde 302 hacia loopback llegaba igual, porque solo se\n\t\t\t\t// miraba la primera — era el tercer camino abierto de los tres.\n\t\t\t\tlet destino = url;\n\t\t\t\tlet response: Response | undefined;\n\t\t\t\tfor (let salto = 0; salto <= MAX_REDIRECCIONES; salto++) {\n\t\t\t\t\tresponse = await withTimeout(signal, (s) =>\n\t\t\t\t\t\tfetchImpl(destino.toString(), {\n\t\t\t\t\t\t\tredirect: \"manual\",\n\t\t\t\t\t\t\tsignal: s,\n\t\t\t\t\t\t\theaders: { \"user-agent\": \"ada-cli\" },\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t\tif (response.status < 300 || response.status >= 400) break;\n\t\t\t\t\tconst siguiente = response.headers.get(\"location\");\n\t\t\t\t\tif (!siguiente) break;\n\t\t\t\t\tif (salto === MAX_REDIRECCIONES) {\n\t\t\t\t\t\treturn textResult(`La descarga dio más de ${MAX_REDIRECCIONES} redirecciones y se ha parado.`);\n\t\t\t\t\t}\n\t\t\t\t\t// Relativa respecto al destino actual, como manda el estándar.\n\t\t\t\t\tdestino = new URL(siguiente, destino);\n\t\t\t\t\tassertFetchableUrl(destino.toString());\n\t\t\t\t\tconst rechazoSalto = await destinoPermitido(destino);\n\t\t\t\t\tif (rechazoSalto) {\n\t\t\t\t\t\tanotarRed?.(destino.hostname, false, `redirección a ${rechazoSalto.motivo}`);\n\t\t\t\t\t\treturn textResult(\n\t\t\t\t\t\t\t`Descarga bloqueada: la redirección lleva a ${rechazoSalto.motivo}` +\n\t\t\t\t\t\t\t\t`${rechazoSalto.direccion ? ` (${rechazoSalto.direccion})` : \"\"}.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tanotarRed?.(destino.hostname, true, \"redirección\");\n\t\t\t\t}\n\t\t\t\tif (!response) return textResult(\"La descarga no devolvió respuesta.\");\n\t\t\t\tif (!response.ok) return textResult(`La descarga devolvió HTTP ${response.status}.`);\n\t\t\t\tconst body = await response.text();\n\t\t\t\tconst truncated = body.length > MAX_FETCH_BYTES;\n\t\t\t\tconst text = htmlToText(body.slice(0, MAX_FETCH_BYTES));\n\t\t\t\treturn textResult(truncated ? `${text}\\n\\n[truncado en ${MAX_FETCH_BYTES} bytes]` : text);\n\t\t\t} catch (error) {\n\t\t\t\treturn textResult(`La descarga falló: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t},\n\t};\n\n\treturn { web_search: webSearch as ToolDefinition, web_fetch: webFetch as ToolDefinition };\n}\n"]}

package/dist/core/wiki/almacen.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dónde vive la wiki y cómo se indexa.
+ *
+ * En `<proyecto>/<configDir>/wiki/`: páginas en Markdown y un `citas.json` con
+ * la huella de cada cita. Va dentro del proyecto y no en el agentDir a
+ * propósito — es documentación del repositorio, debe poder versionarse y
+ * revisarse en un pull request como cualquier otro fichero.
+ */
+import { type Afirmacion } from "./citas.ts";
+export interface Wiki {
+    version: 1;
+    afirmaciones: Afirmacion[];
+}
+export declare function rutaWiki(cwd: string, configDirName: string): string;
+export declare function leerWiki(cwd: string, configDirName: string): Wiki;
+export declare function escribirWiki(cwd: string, configDirName: string, wiki: Wiki): void;
+/**
+ * Lector de ficheros del proyecto, con la raíz cerrada.
+ *
+ * Una cita es texto que puede haber escrito un modelo. Sin esta comprobación,
+ * `../../.ssh/id_rsa` en una página de la wiki haría que `wiki check` leyera
+ * cualquier cosa del disco.
+ */
+export declare function lectorDelProyecto(cwd: string): (fichero: string) => string | null;
+/**
+ * Indexa las páginas Markdown: saca sus citas y les calcula la huella.
+ *
+ * Cada párrafo no vacío es una afirmación. Es una regla tonta a propósito: si
+ * el troceado fuera listo, dos ejecuciones sobre el mismo texto podrían dar
+ * afirmaciones distintas y el fichero de citas cambiaría sin que cambiara nada.
+ */
+export declare function indexarPaginas(cwd: string, configDirName: string): Wiki;
+//# sourceMappingURL=almacen.d.ts.map

package/dist/core/wiki/almacen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"almacen.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/almacen.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,UAAU,EAA0C,MAAM,YAAY,CAAC;AAErF,MAAM,WAAW,IAAI;IACpB,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,UAAU,EAAE,CAAC;CAC3B;AAID,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAUjE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAIjF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAYjF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CA2BvE","sourcesContent":["/**\n * Dónde vive la wiki y cómo se indexa.\n *\n * En `<proyecto>/<configDir>/wiki/`: páginas en Markdown y un `citas.json` con\n * la huella de cada cita. Va dentro del proyecto y no en el agentDir a\n * propósito — es documentación del repositorio, debe poder versionarse y\n * revisarse en un pull request como cualquier otro fichero.\n */\n\nimport { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join, relative, resolve } from \"node:path\";\nimport { type Afirmacion, type Cita, extraerCitas, huellaDeTexto } from \"./citas.ts\";\n\nexport interface Wiki {\n\tversion: 1;\n\tafirmaciones: Afirmacion[];\n}\n\nconst VACIA: Wiki = { version: 1, afirmaciones: [] };\n\nexport function rutaWiki(cwd: string, configDirName: string): string {\n\treturn join(cwd, configDirName, \"wiki\");\n}\n\nexport function leerWiki(cwd: string, configDirName: string): Wiki {\n\tconst fichero = join(rutaWiki(cwd, configDirName), \"citas.json\");\n\tif (!existsSync(fichero)) return { ...VACIA };\n\ttry {\n\t\tconst datos = JSON.parse(readFileSync(fichero, \"utf8\")) as Wiki;\n\t\treturn Array.isArray(datos.afirmaciones) ? datos : { ...VACIA };\n\t} catch {\n\t\t// Un citas.json corrupto no puede impedir regenerar la wiki.\n\t\treturn { ...VACIA };\n\t}\n}\n\nexport function escribirWiki(cwd: string, configDirName: string, wiki: Wiki): void {\n\tconst dir = rutaWiki(cwd, configDirName);\n\tmkdirSync(dir, { recursive: true });\n\twriteFileSync(join(dir, \"citas.json\"), `${JSON.stringify(wiki, null, 2)}\\n`, \"utf8\");\n}\n\n/**\n * Lector de ficheros del proyecto, con la raíz cerrada.\n *\n * Una cita es texto que puede haber escrito un modelo. Sin esta comprobación,\n * `../../.ssh/id_rsa` en una página de la wiki haría que `wiki check` leyera\n * cualquier cosa del disco.\n */\nexport function lectorDelProyecto(cwd: string): (fichero: string) => string | null {\n\tconst raiz = resolve(cwd);\n\treturn (fichero) => {\n\t\tconst absoluta = resolve(raiz, fichero);\n\t\tconst dentro = relative(raiz, absoluta);\n\t\tif (dentro.startsWith(\"..\") || resolve(raiz, dentro) !== absoluta) return null;\n\t\ttry {\n\t\t\treturn readFileSync(absoluta, \"utf8\");\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t};\n}\n\n/**\n * Indexa las páginas Markdown: saca sus citas y les calcula la huella.\n *\n * Cada párrafo no vacío es una afirmación. Es una regla tonta a propósito: si\n * el troceado fuera listo, dos ejecuciones sobre el mismo texto podrían dar\n * afirmaciones distintas y el fichero de citas cambiaría sin que cambiara nada.\n */\nexport function indexarPaginas(cwd: string, configDirName: string): Wiki {\n\tconst dir = rutaWiki(cwd, configDirName);\n\tif (!existsSync(dir)) return { ...VACIA };\n\tconst leer = lectorDelProyecto(cwd);\n\tconst afirmaciones: Afirmacion[] = [];\n\n\tfor (const fichero of readdirSync(dir)\n\t\t.filter((f) => f.endsWith(\".md\"))\n\t\t.sort()) {\n\t\tconst contenido = readFileSync(join(dir, fichero), \"utf8\");\n\t\tconst parrafos = contenido\n\t\t\t.split(/\\n\\s*\\n/)\n\t\t\t.map((p) => p.trim())\n\t\t\t.filter(Boolean);\n\t\tparrafos.forEach((parrafo, i) => {\n\t\t\tconst citas: Cita[] = [];\n\t\t\tfor (const sinHuella of extraerCitas(parrafo)) {\n\t\t\t\tconst fuente = leer(sinHuella.fichero);\n\t\t\t\tif (fuente === null) continue;\n\t\t\t\tconst lineas = fuente.split(\"\\n\").slice(sinHuella.desde - 1, sinHuella.hasta);\n\t\t\t\tif (lineas.length === 0) continue;\n\t\t\t\tcitas.push({ ...sinHuella, huella: huellaDeTexto(lineas) });\n\t\t\t}\n\t\t\tafirmaciones.push({ id: `${fichero}#${i}`, texto: parrafo.slice(0, 400), citas });\n\t\t});\n\t}\n\treturn { version: 1, afirmaciones };\n}\n"]}

package/dist/core/wiki/almacen.js

@@ -0,0 +1,93 @@
+/**
+ * Dónde vive la wiki y cómo se indexa.
+ *
+ * En `<proyecto>/<configDir>/wiki/`: páginas en Markdown y un `citas.json` con
+ * la huella de cada cita. Va dentro del proyecto y no en el agentDir a
+ * propósito — es documentación del repositorio, debe poder versionarse y
+ * revisarse en un pull request como cualquier otro fichero.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+import { extraerCitas, huellaDeTexto } from "./citas.js";
+const VACIA = { version: 1, afirmaciones: [] };
+export function rutaWiki(cwd, configDirName) {
+    return join(cwd, configDirName, "wiki");
+}
+export function leerWiki(cwd, configDirName) {
+    const fichero = join(rutaWiki(cwd, configDirName), "citas.json");
+    if (!existsSync(fichero))
+        return { ...VACIA };
+    try {
+        const datos = JSON.parse(readFileSync(fichero, "utf8"));
+        return Array.isArray(datos.afirmaciones) ? datos : { ...VACIA };
+    }
+    catch {
+        // Un citas.json corrupto no puede impedir regenerar la wiki.
+        return { ...VACIA };
+    }
+}
+export function escribirWiki(cwd, configDirName, wiki) {
+    const dir = rutaWiki(cwd, configDirName);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "citas.json"), `${JSON.stringify(wiki, null, 2)}\n`, "utf8");
+}
+/**
+ * Lector de ficheros del proyecto, con la raíz cerrada.
+ *
+ * Una cita es texto que puede haber escrito un modelo. Sin esta comprobación,
+ * `../../.ssh/id_rsa` en una página de la wiki haría que `wiki check` leyera
+ * cualquier cosa del disco.
+ */
+export function lectorDelProyecto(cwd) {
+    const raiz = resolve(cwd);
+    return (fichero) => {
+        const absoluta = resolve(raiz, fichero);
+        const dentro = relative(raiz, absoluta);
+        if (dentro.startsWith("..") || resolve(raiz, dentro) !== absoluta)
+            return null;
+        try {
+            return readFileSync(absoluta, "utf8");
+        }
+        catch {
+            return null;
+        }
+    };
+}
+/**
+ * Indexa las páginas Markdown: saca sus citas y les calcula la huella.
+ *
+ * Cada párrafo no vacío es una afirmación. Es una regla tonta a propósito: si
+ * el troceado fuera listo, dos ejecuciones sobre el mismo texto podrían dar
+ * afirmaciones distintas y el fichero de citas cambiaría sin que cambiara nada.
+ */
+export function indexarPaginas(cwd, configDirName) {
+    const dir = rutaWiki(cwd, configDirName);
+    if (!existsSync(dir))
+        return { ...VACIA };
+    const leer = lectorDelProyecto(cwd);
+    const afirmaciones = [];
+    for (const fichero of readdirSync(dir)
+        .filter((f) => f.endsWith(".md"))
+        .sort()) {
+        const contenido = readFileSync(join(dir, fichero), "utf8");
+        const parrafos = contenido
+            .split(/\n\s*\n/)
+            .map((p) => p.trim())
+            .filter(Boolean);
+        parrafos.forEach((parrafo, i) => {
+            const citas = [];
+            for (const sinHuella of extraerCitas(parrafo)) {
+                const fuente = leer(sinHuella.fichero);
+                if (fuente === null)
+                    continue;
+                const lineas = fuente.split("\n").slice(sinHuella.desde - 1, sinHuella.hasta);
+                if (lineas.length === 0)
+                    continue;
+                citas.push({ ...sinHuella, huella: huellaDeTexto(lineas) });
+            }
+            afirmaciones.push({ id: `${fichero}#${i}`, texto: parrafo.slice(0, 400), citas });
+        });
+    }
+    return { version: 1, afirmaciones };
+}
+//# sourceMappingURL=almacen.js.map