@hoilab/ada-cli 0.84.22 → 0.85.0

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"serper.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/serper.ts"],"names":[],"mappings":"AAQA,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AAMpD,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1F,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE;QACnE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAClD,MAAM;KACN,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAAyB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAoB,CAAC;IAC1D,MAAM,UAAU,GAAyB,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;SAC5D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC;SACnD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAK,EAAE,GAAG,EAAE,CAAC,CAAC,IAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACjF,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,CACnC,CAAC","sourcesContent":["/**\n * Serper (Google Search API). Requiere clave (`serper` en el vault, o\n * SERPER_API_KEY). Es el proveedor histórico de Ada, anterior a este\n * registro: se mantiene aquí para que quien ya tenga la clave configurada\n * siga funcionando exactamente igual.\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://google.serper.dev/search\";\n\ninterface RespuestaSerper {\n\torganic?: Array<{ title?: string; link?: string; snippet?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Serper requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"X-API-KEY\": clave, \"content-type\": \"application/json\" },\n\t\tbody: JSON.stringify({ q: consulta, num: maximo }),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Serper respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaSerper;\n\tconst resultados: ResultadoProveedor[] = (datos.organic ?? [])\n\t\t.filter((r) => typeof r.link === \"string\" && r.link)\n\t\t.map((r) => ({ titulo: r.title || r.link!, url: r.link!, resumen: r.snippet }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/tavily.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAQpE,eAAO,MAAM,MAAM,EAAE,aAcpB,CAAC","sourcesContent":["/**\n * Tavily Search API. Requiere clave (`tavily` en el vault, o TAVILY_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.tavily.com/search\";\n\ninterface RespuestaTavily {\n\tresults?: Array<{ title?: string; url?: string; content?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Tavily requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"content-type\": \"application/json\", authorization: `Bearer ${clave}` },\n\t\tbody: JSON.stringify({ query: consulta, max_results: Math.min(Math.max(maximo, 1), 20), search_depth: \"basic\" }),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Tavily respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaTavily;\n\tconst resultados: ResultadoProveedor[] = (datos.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.content }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

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

@@ -0,0 +1,19 @@
+const ENDPOINT = "https://api.tavily.com/search";
+export const buscar = async (consulta, maximo, clave, fetchImpl, signal) => {
+    if (!clave)
+        throw new Error("Tavily requiere clave.");
+    const respuesta = await fetchImpl(ENDPOINT, {
+        method: "POST",
+        headers: { "content-type": "application/json", authorization: `Bearer ${clave}` },
+        body: JSON.stringify({ query: consulta, max_results: Math.min(Math.max(maximo, 1), 20), search_depth: "basic" }),
+        signal,
+    });
+    if (!respuesta.ok)
+        throw new Error(`Tavily respondió HTTP ${respuesta.status}.`);
+    const datos = (await respuesta.json());
+    const resultados = (datos.results ?? [])
+        .filter((r) => typeof r.url === "string" && r.url)
+        .map((r) => ({ titulo: r.title || r.url, url: r.url, resumen: r.content }));
+    return resultados.slice(0, maximo);
+};
+//# sourceMappingURL=tavily.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/tavily.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAMjD,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1F,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;QACjF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;QAChH,MAAM;KACN,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAAyB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAoB,CAAC;IAC1D,MAAM,UAAU,GAAyB,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;SAC5D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/E,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,CACnC,CAAC","sourcesContent":["/**\n * Tavily Search API. Requiere clave (`tavily` en el vault, o TAVILY_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.tavily.com/search\";\n\ninterface RespuestaTavily {\n\tresults?: Array<{ title?: string; url?: string; content?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Tavily requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"content-type\": \"application/json\", authorization: `Bearer ${clave}` },\n\t\tbody: JSON.stringify({ query: consulta, max_results: Math.min(Math.max(maximo, 1), 20), search_depth: \"basic\" }),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Tavily respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaTavily;\n\tconst resultados: ResultadoProveedor[] = (datos.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.content }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

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

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

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Tipos compartidos por los proveedores de búsqueda web.
+ *
+ * Un proveedor es un módulo que se carga con `import()` la primera vez que se
+ * necesita: importar este fichero (o `registro.ts`) NO debe cargar ni un solo
+ * proveedor. Son pesados —cada uno trae su propio parseo— y como mucho se usa
+ * uno por sesión, así que cargarlos todos por adelantado es trabajo tirado.
+ */
+export {};
+//# sourceMappingURL=tipos.js.map

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/core/web/scrapers/cisa-kev.js

@@ -0,0 +1,38 @@
+/**
+ * CISA KEV (Known Exploited Vulnerabilities), vía el feed JSON público.
+ *
+ * No hay endpoint por CVE: el feed es el catálogo entero (~1.5 MB). Se pide
+ * completo y se filtra en memoria — mismo coste de red que cualquier otra
+ * consulta a este catálogo, no hay forma más barata sin clave.
+ */
+import { esHostOSubdominio } from "./tipos.js";
+const FEED_URL = "https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json";
+const RE_CVE = /CVE-\d{4}-\d{4,7}/i;
+export const scrapear = async (url, fetchImpl, signal) => {
+    if (!esHostOSubdominio(url.hostname.toLowerCase(), "cisa.gov"))
+        return null;
+    const cveMatch = url.pathname.match(RE_CVE) ?? url.search.match(RE_CVE);
+    if (!cveMatch)
+        return null;
+    const cveId = cveMatch[0].toUpperCase();
+    const respuesta = await fetchImpl(FEED_URL, { headers: { Accept: "application/json" }, signal });
+    if (!respuesta.ok)
+        throw new Error(`CISA KEV respondió HTTP ${respuesta.status}.`);
+    const doc = (await respuesta.json());
+    const entrada = doc.vulnerabilities?.find((v) => v.cveID?.toUpperCase() === cveId);
+    if (!entrada)
+        return null; // el CVE es válido pero no está en el catálogo KEV
+    return {
+        titulo: `${entrada.cveID} — ${entrada.vulnerabilityName ?? "explotado activamente (KEV)"}`,
+        url: `https://www.cisa.gov/known-exploited-vulnerabilities-catalog?search_api_fulltext=${entrada.cveID}`,
+        resumen: entrada.shortDescription ?? "",
+        datos: {
+            vendedor: entrada.vendorProject,
+            producto: entrada.product,
+            añadido: entrada.dateAdded,
+            fechaLimite: entrada.dueDate,
+            usoEnRansomware: entrada.knownRansomwareCampaignUse,
+        },
+    };
+};
+//# sourceMappingURL=cisa-kev.js.map

package/dist/core/web/scrapers/cisa-kev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cisa-kev.js","sourceRoot":"","sources":["../../../../src/core/web/scrapers/cisa-kev.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAuB,MAAM,YAAY,CAAC;AAEpE,MAAM,QAAQ,GAAG,qFAAqF,CAAC;AACvG,MAAM,MAAM,GAAG,oBAAoB,CAAC;AAapC,MAAM,CAAC,MAAM,QAAQ,GAAmB,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACzE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAExC,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACjG,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA2B,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACnF,MAAM,GAAG,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAuC,CAAC;IAC3E,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC;IACnF,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,CAAC,sDAAmD;IAE9E,OAAO;QACN,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,QAAM,OAAO,CAAC,iBAAiB,IAAI,6BAA6B,EAAE;QAC1F,GAAG,EAAE,oFAAoF,OAAO,CAAC,KAAK,EAAE;QACxG,OAAO,EAAE,OAAO,CAAC,gBAAgB,IAAI,EAAE;QACvC,KAAK,EAAE;YACN,QAAQ,EAAE,OAAO,CAAC,aAAa;YAC/B,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,QAAO,EAAE,OAAO,CAAC,SAAS;YAC1B,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,eAAe,EAAE,OAAO,CAAC,0BAA0B;SACnD;KACD,CAAC;AAAA,CACF,CAAC","sourcesContent":["/**\n * CISA KEV (Known Exploited Vulnerabilities), vía el feed JSON público.\n *\n * No hay endpoint por CVE: el feed es el catálogo entero (~1.5 MB). Se pide\n * completo y se filtra en memoria — mismo coste de red que cualquier otra\n * consulta a este catálogo, no hay forma más barata sin clave.\n */\nimport { esHostOSubdominio, type FuncionScraper } from \"./tipos.ts\";\n\nconst FEED_URL = \"https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json\";\nconst RE_CVE = /CVE-\\d{4}-\\d{4,7}/i;\n\ninterface EntradaKev {\n\tcveID?: string;\n\tvendorProject?: string;\n\tproduct?: string;\n\tvulnerabilityName?: string;\n\tshortDescription?: string;\n\tdateAdded?: string;\n\tdueDate?: string;\n\tknownRansomwareCampaignUse?: string;\n}\n\nexport const scrapear: FuncionScraper = async (url, fetchImpl, signal) => {\n\tif (!esHostOSubdominio(url.hostname.toLowerCase(), \"cisa.gov\")) return null;\n\tconst cveMatch = url.pathname.match(RE_CVE) ?? url.search.match(RE_CVE);\n\tif (!cveMatch) return null;\n\tconst cveId = cveMatch[0].toUpperCase();\n\n\tconst respuesta = await fetchImpl(FEED_URL, { headers: { Accept: \"application/json\" }, signal });\n\tif (!respuesta.ok) throw new Error(`CISA KEV respondió HTTP ${respuesta.status}.`);\n\tconst doc = (await respuesta.json()) as { vulnerabilities?: EntradaKev[] };\n\tconst entrada = doc.vulnerabilities?.find((v) => v.cveID?.toUpperCase() === cveId);\n\tif (!entrada) return null; // el CVE es válido pero no está en el catálogo KEV\n\n\treturn {\n\t\ttitulo: `${entrada.cveID} — ${entrada.vulnerabilityName ?? \"explotado activamente (KEV)\"}`,\n\t\turl: `https://www.cisa.gov/known-exploited-vulnerabilities-catalog?search_api_fulltext=${entrada.cveID}`,\n\t\tresumen: entrada.shortDescription ?? \"\",\n\t\tdatos: {\n\t\t\tvendedor: entrada.vendorProject,\n\t\t\tproducto: entrada.product,\n\t\t\tañadido: entrada.dateAdded,\n\t\t\tfechaLimite: entrada.dueDate,\n\t\t\tusoEnRansomware: entrada.knownRansomwareCampaignUse,\n\t\t},\n\t};\n};\n"]}

package/dist/core/web/scrapers/crates-io.d.ts

@@ -0,0 +1,11 @@
+/**
+ * crates.io, vía su API pública (`crates.io/api/v1/crates/<crate>`).
+ *
+ * La licencia no vive en el objeto `crate` sino en cada entrada de
+ * `versions`; se toma la de `max_stable_version` (la primera del array
+ * coincide salvo prereleases raras, pero se busca por número para no fiarse
+ * del orden).
+ */
+import type { FuncionScraper } from "./tipos.ts";
+export declare const scrapear: FuncionScraper;
+//# sourceMappingURL=crates-io.d.ts.map

package/dist/core/web/scrapers/crates-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crates-io.d.ts","sourceRoot":"","sources":["../../../../src/core/web/scrapers/crates-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAcjD,eAAO,MAAM,QAAQ,EAAE,cAyBtB,CAAC","sourcesContent":["/**\n * crates.io, vía su API pública (`crates.io/api/v1/crates/<crate>`).\n *\n * La licencia no vive en el objeto `crate` sino en cada entrada de\n * `versions`; se toma la de `max_stable_version` (la primera del array\n * coincide salvo prereleases raras, pero se busca por número para no fiarse\n * del orden).\n */\nimport type { FuncionScraper } from \"./tipos.ts\";\n\ninterface DocCratesIo {\n\tcrate?: {\n\t\tname?: string;\n\t\tmax_stable_version?: string;\n\t\tmax_version?: string;\n\t\tdescription?: string;\n\t\thomepage?: string;\n\t\trepository?: string;\n\t};\n\tversions?: Array<{ num?: string; license?: string }>;\n}\n\nexport const scrapear: FuncionScraper = async (url, fetchImpl, signal) => {\n\tif (url.hostname !== \"crates.io\") return null;\n\tconst match = url.pathname.match(/^\\/crates\\/([^/]+)/);\n\tif (!match) return null;\n\tconst nombre = decodeURIComponent(match[1]);\n\n\tconst respuesta = await fetchImpl(`https://crates.io/api/v1/crates/${nombre}`, {\n\t\theaders: { Accept: \"application/json\", \"User-Agent\": \"ada-cli (web_fetch scraper)\" },\n\t\tsignal,\n\t});\n\tif (respuesta.status === 404) return null;\n\tif (!respuesta.ok) throw new Error(`crates.io respondió HTTP ${respuesta.status}.`);\n\tconst doc = (await respuesta.json()) as DocCratesIo;\n\tconst crate = doc.crate;\n\tif (!crate?.name) return null;\n\n\tconst version = crate.max_stable_version ?? crate.max_version;\n\tconst licencia = doc.versions?.find((v) => v.num === version)?.license ?? doc.versions?.[0]?.license;\n\n\treturn {\n\t\ttitulo: `${crate.name}@${version ?? \"?\"}`,\n\t\turl: `https://crates.io/crates/${crate.name}`,\n\t\tresumen: crate.description ?? \"\",\n\t\tdatos: { nombre: crate.name, version, licencia, homepage: crate.homepage ?? crate.repository },\n\t};\n};\n"]}

package/dist/core/web/scrapers/crates-io.js

@@ -0,0 +1,29 @@
+export const scrapear = async (url, fetchImpl, signal) => {
+    if (url.hostname !== "crates.io")
+        return null;
+    const match = url.pathname.match(/^\/crates\/([^/]+)/);
+    if (!match)
+        return null;
+    const nombre = decodeURIComponent(match[1]);
+    const respuesta = await fetchImpl(`https://crates.io/api/v1/crates/${nombre}`, {
+        headers: { Accept: "application/json", "User-Agent": "ada-cli (web_fetch scraper)" },
+        signal,
+    });
+    if (respuesta.status === 404)
+        return null;
+    if (!respuesta.ok)
+        throw new Error(`crates.io respondió HTTP ${respuesta.status}.`);
+    const doc = (await respuesta.json());
+    const crate = doc.crate;
+    if (!crate?.name)
+        return null;
+    const version = crate.max_stable_version ?? crate.max_version;
+    const licencia = doc.versions?.find((v) => v.num === version)?.license ?? doc.versions?.[0]?.license;
+    return {
+        titulo: `${crate.name}@${version ?? "?"}`,
+        url: `https://crates.io/crates/${crate.name}`,
+        resumen: crate.description ?? "",
+        datos: { nombre: crate.name, version, licencia, homepage: crate.homepage ?? crate.repository },
+    };
+};
+//# sourceMappingURL=crates-io.js.map

package/dist/core/web/scrapers/crates-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crates-io.js","sourceRoot":"","sources":["../../../../src/core/web/scrapers/crates-io.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,QAAQ,GAAmB,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACzE,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,mCAAmC,MAAM,EAAE,EAAE;QAC9E,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,6BAA6B,EAAE;QACpF,MAAM;KACN,CAAC,CAAC;IACH,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA4B,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACpF,MAAM,GAAG,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAgB,CAAC;IACpD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,IAAI;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,OAAO,GAAG,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,WAAW,CAAC;IAC9D,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,EAAE,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;IAErG,OAAO;QACN,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,IAAI,GAAG,EAAE;QACzC,GAAG,EAAE,4BAA4B,KAAK,CAAC,IAAI,EAAE;QAC7C,OAAO,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QAChC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,UAAU,EAAE;KAC9F,CAAC;AAAA,CACF,CAAC","sourcesContent":["/**\n * crates.io, vía su API pública (`crates.io/api/v1/crates/<crate>`).\n *\n * La licencia no vive en el objeto `crate` sino en cada entrada de\n * `versions`; se toma la de `max_stable_version` (la primera del array\n * coincide salvo prereleases raras, pero se busca por número para no fiarse\n * del orden).\n */\nimport type { FuncionScraper } from \"./tipos.ts\";\n\ninterface DocCratesIo {\n\tcrate?: {\n\t\tname?: string;\n\t\tmax_stable_version?: string;\n\t\tmax_version?: string;\n\t\tdescription?: string;\n\t\thomepage?: string;\n\t\trepository?: string;\n\t};\n\tversions?: Array<{ num?: string; license?: string }>;\n}\n\nexport const scrapear: FuncionScraper = async (url, fetchImpl, signal) => {\n\tif (url.hostname !== \"crates.io\") return null;\n\tconst match = url.pathname.match(/^\\/crates\\/([^/]+)/);\n\tif (!match) return null;\n\tconst nombre = decodeURIComponent(match[1]);\n\n\tconst respuesta = await fetchImpl(`https://crates.io/api/v1/crates/${nombre}`, {\n\t\theaders: { Accept: \"application/json\", \"User-Agent\": \"ada-cli (web_fetch scraper)\" },\n\t\tsignal,\n\t});\n\tif (respuesta.status === 404) return null;\n\tif (!respuesta.ok) throw new Error(`crates.io respondió HTTP ${respuesta.status}.`);\n\tconst doc = (await respuesta.json()) as DocCratesIo;\n\tconst crate = doc.crate;\n\tif (!crate?.name) return null;\n\n\tconst version = crate.max_stable_version ?? crate.max_version;\n\tconst licencia = doc.versions?.find((v) => v.num === version)?.license ?? doc.versions?.[0]?.license;\n\n\treturn {\n\t\ttitulo: `${crate.name}@${version ?? \"?\"}`,\n\t\turl: `https://crates.io/crates/${crate.name}`,\n\t\tresumen: crate.description ?? \"\",\n\t\tdatos: { nombre: crate.name, version, licencia, homepage: crate.homepage ?? crate.repository },\n\t};\n};\n"]}

package/dist/core/web/scrapers/docs-rs.d.ts

@@ -0,0 +1,10 @@
+/**
+ * docs.rs no tiene una API JSON estable y pública para metadatos (el índice de
+ * búsqueda es un blob interno versionado). Lo que un agente quiere de una URL
+ * de docs.rs —versión y licencia del crate— SÍ lo tiene crates.io, así que se
+ * reutiliza su API: docs.rs y crates.io comparten el mismo nombre de crate por
+ * construcción (docs.rs se genera A PARTIR de lo publicado en crates.io).
+ */
+import type { FuncionScraper } from "./tipos.ts";
+export declare const scrapear: FuncionScraper;
+//# sourceMappingURL=docs-rs.d.ts.map

package/dist/core/web/scrapers/docs-rs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-rs.d.ts","sourceRoot":"","sources":["../../../../src/core/web/scrapers/docs-rs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoBjD,eAAO,MAAM,QAAQ,EAAE,cAwBtB,CAAC","sourcesContent":["/**\n * docs.rs no tiene una API JSON estable y pública para metadatos (el índice de\n * búsqueda es un blob interno versionado). Lo que un agente quiere de una URL\n * de docs.rs —versión y licencia del crate— SÍ lo tiene crates.io, así que se\n * reutiliza su API: docs.rs y crates.io comparten el mismo nombre de crate por\n * construcción (docs.rs se genera A PARTIR de lo publicado en crates.io).\n */\nimport type { FuncionScraper } from \"./tipos.ts\";\n\ninterface DocCratesIo {\n\tcrate?: {\n\t\tname?: string;\n\t\tmax_stable_version?: string;\n\t\tmax_version?: string;\n\t\tdescription?: string;\n\t\thomepage?: string;\n\t};\n\tversions?: Array<{ num?: string; license?: string }>;\n}\n\n/** `/crate/<nombre>[/<version>]` o `/<nombre>/<version>/...` — ambas formas empiezan por el crate. */\nfunction crateDeRuta(pathname: string): string | undefined {\n\tconst partes = pathname.split(\"/\").filter(Boolean);\n\tif (partes.length === 0) return undefined;\n\treturn partes[0] === \"crate\" ? partes[1] : partes[0];\n}\n\nexport const scrapear: FuncionScraper = async (url, fetchImpl, signal) => {\n\tif (url.hostname !== \"docs.rs\") return null;\n\tconst nombre = crateDeRuta(url.pathname);\n\tif (!nombre) return null;\n\n\tconst respuesta = await fetchImpl(`https://crates.io/api/v1/crates/${nombre}`, {\n\t\theaders: { Accept: \"application/json\", \"User-Agent\": \"ada-cli (web_fetch scraper)\" },\n\t\tsignal,\n\t});\n\tif (respuesta.status === 404) return null;\n\tif (!respuesta.ok) throw new Error(`docs.rs (vía crates.io) respondió HTTP ${respuesta.status}.`);\n\tconst doc = (await respuesta.json()) as DocCratesIo;\n\tconst crate = doc.crate;\n\tif (!crate?.name) return null;\n\n\tconst version = crate.max_stable_version ?? crate.max_version;\n\tconst licencia = doc.versions?.find((v) => v.num === version)?.license ?? doc.versions?.[0]?.license;\n\n\treturn {\n\t\ttitulo: `${crate.name}@${version ?? \"?\"} — docs.rs`,\n\t\turl: `https://docs.rs/${crate.name}/latest/${crate.name}/`,\n\t\tresumen: crate.description ?? \"\",\n\t\tdatos: { nombre: crate.name, version, licencia, homepage: crate.homepage },\n\t};\n};\n"]}

package/dist/core/web/scrapers/docs-rs.js

@@ -0,0 +1,35 @@
+/** `/crate/<nombre>[/<version>]` o `/<nombre>/<version>/...` — ambas formas empiezan por el crate. */
+function crateDeRuta(pathname) {
+    const partes = pathname.split("/").filter(Boolean);
+    if (partes.length === 0)
+        return undefined;
+    return partes[0] === "crate" ? partes[1] : partes[0];
+}
+export const scrapear = async (url, fetchImpl, signal) => {
+    if (url.hostname !== "docs.rs")
+        return null;
+    const nombre = crateDeRuta(url.pathname);
+    if (!nombre)
+        return null;
+    const respuesta = await fetchImpl(`https://crates.io/api/v1/crates/${nombre}`, {
+        headers: { Accept: "application/json", "User-Agent": "ada-cli (web_fetch scraper)" },
+        signal,
+    });
+    if (respuesta.status === 404)
+        return null;
+    if (!respuesta.ok)
+        throw new Error(`docs.rs (vía crates.io) respondió HTTP ${respuesta.status}.`);
+    const doc = (await respuesta.json());
+    const crate = doc.crate;
+    if (!crate?.name)
+        return null;
+    const version = crate.max_stable_version ?? crate.max_version;
+    const licencia = doc.versions?.find((v) => v.num === version)?.license ?? doc.versions?.[0]?.license;
+    return {
+        titulo: `${crate.name}@${version ?? "?"} — docs.rs`,
+        url: `https://docs.rs/${crate.name}/latest/${crate.name}/`,
+        resumen: crate.description ?? "",
+        datos: { nombre: crate.name, version, licencia, homepage: crate.homepage },
+    };
+};
+//# sourceMappingURL=docs-rs.js.map

package/dist/core/web/scrapers/docs-rs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-rs.js","sourceRoot":"","sources":["../../../../src/core/web/scrapers/docs-rs.ts"],"names":[],"mappings":"AAoBA,wGAAsG;AACtG,SAAS,WAAW,CAAC,QAAgB,EAAsB;IAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAAA,CACrD;AAED,MAAM,CAAC,MAAM,QAAQ,GAAmB,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACzE,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,mCAAmC,MAAM,EAAE,EAAE;QAC9E,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,6BAA6B,EAAE;QACpF,MAAM;KACN,CAAC,CAAC;IACH,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA0C,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAClG,MAAM,GAAG,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAgB,CAAC;IACpD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,IAAI;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,OAAO,GAAG,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,WAAW,CAAC;IAC9D,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,EAAE,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;IAErG,OAAO;QACN,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,IAAI,GAAG,cAAY;QACnD,GAAG,EAAE,mBAAmB,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,IAAI,GAAG;QAC1D,OAAO,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QAChC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;KAC1E,CAAC;AAAA,CACF,CAAC","sourcesContent":["/**\n * docs.rs no tiene una API JSON estable y pública para metadatos (el índice de\n * búsqueda es un blob interno versionado). Lo que un agente quiere de una URL\n * de docs.rs —versión y licencia del crate— SÍ lo tiene crates.io, así que se\n * reutiliza su API: docs.rs y crates.io comparten el mismo nombre de crate por\n * construcción (docs.rs se genera A PARTIR de lo publicado en crates.io).\n */\nimport type { FuncionScraper } from \"./tipos.ts\";\n\ninterface DocCratesIo {\n\tcrate?: {\n\t\tname?: string;\n\t\tmax_stable_version?: string;\n\t\tmax_version?: string;\n\t\tdescription?: string;\n\t\thomepage?: string;\n\t};\n\tversions?: Array<{ num?: string; license?: string }>;\n}\n\n/** `/crate/<nombre>[/<version>]` o `/<nombre>/<version>/...` — ambas formas empiezan por el crate. */\nfunction crateDeRuta(pathname: string): string | undefined {\n\tconst partes = pathname.split(\"/\").filter(Boolean);\n\tif (partes.length === 0) return undefined;\n\treturn partes[0] === \"crate\" ? partes[1] : partes[0];\n}\n\nexport const scrapear: FuncionScraper = async (url, fetchImpl, signal) => {\n\tif (url.hostname !== \"docs.rs\") return null;\n\tconst nombre = crateDeRuta(url.pathname);\n\tif (!nombre) return null;\n\n\tconst respuesta = await fetchImpl(`https://crates.io/api/v1/crates/${nombre}`, {\n\t\theaders: { Accept: \"application/json\", \"User-Agent\": \"ada-cli (web_fetch scraper)\" },\n\t\tsignal,\n\t});\n\tif (respuesta.status === 404) return null;\n\tif (!respuesta.ok) throw new Error(`docs.rs (vía crates.io) respondió HTTP ${respuesta.status}.`);\n\tconst doc = (await respuesta.json()) as DocCratesIo;\n\tconst crate = doc.crate;\n\tif (!crate?.name) return null;\n\n\tconst version = crate.max_stable_version ?? crate.max_version;\n\tconst licencia = doc.versions?.find((v) => v.num === version)?.license ?? doc.versions?.[0]?.license;\n\n\treturn {\n\t\ttitulo: `${crate.name}@${version ?? \"?\"} — docs.rs`,\n\t\turl: `https://docs.rs/${crate.name}/latest/${crate.name}/`,\n\t\tresumen: crate.description ?? \"\",\n\t\tdatos: { nombre: crate.name, version, licencia, homepage: crate.homepage },\n\t};\n};\n"]}

package/dist/core/web/scrapers/github.d.ts

@@ -0,0 +1,3 @@
+import type { FuncionScraper } from "./tipos.ts";
+export declare const scrapear: FuncionScraper;
+//# sourceMappingURL=github.d.ts.map

package/dist/core/web/scrapers/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../../src/core/web/scrapers/github.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA+BjD,eAAO,MAAM,QAAQ,EAAE,cAoDtB,CAAC","sourcesContent":["/**\n * GitHub: repos e issues/PRs, vía la API REST pública (`api.github.com`).\n * Sin clave: 60 peticiones/hora por IP, suficiente para una consulta suelta.\n */\nimport { htmlToText } from \"../texto.ts\";\nimport type { FuncionScraper } from \"./tipos.ts\";\n\ninterface DocRepo {\n\tfull_name?: string;\n\tdescription?: string;\n\tlicense?: { spdx_id?: string };\n\tstargazers_count?: number;\n\topen_issues_count?: number;\n\tdefault_branch?: string;\n\tlanguage?: string;\n\thtml_url?: string;\n}\n\ninterface DocIssue {\n\ttitle?: string;\n\tbody?: string;\n\tstate?: string;\n\tnumber?: number;\n\tuser?: { login?: string };\n\tcomments?: number;\n\tpull_request?: unknown;\n\thtml_url?: string;\n}\n\nasync function pedirJson<T>(fetchImpl: typeof fetch, url: string, signal?: AbortSignal): Promise<T | null> {\n\tconst respuesta = await fetchImpl(url, { headers: { Accept: \"application/vnd.github+json\" }, signal });\n\tif (respuesta.status === 404) return null;\n\tif (!respuesta.ok) throw new Error(`GitHub respondió HTTP ${respuesta.status}.`);\n\treturn (await respuesta.json()) as T;\n}\n\nexport const scrapear: FuncionScraper = async (url, fetchImpl, signal) => {\n\tlet owner: string;\n\tlet repo: string;\n\tlet apiBase: string;\n\tif (url.hostname === \"github.com\") {\n\t\tconst partes = url.pathname.split(\"/\").filter(Boolean);\n\t\tif (partes.length < 2) return null;\n\t\t[owner, repo] = partes;\n\t\tapiBase = `https://api.github.com/repos/${owner}/${repo}`;\n\n\t\tconst seccion = partes[2];\n\t\tconst numero = partes[3];\n\t\tif ((seccion === \"issues\" || seccion === \"pull\") && /^\\d+$/.test(numero ?? \"\")) {\n\t\t\tconst issue = await pedirJson<DocIssue>(fetchImpl, `${apiBase}/issues/${numero}`, signal);\n\t\t\tif (!issue?.title) return null;\n\t\t\treturn {\n\t\t\t\ttitulo: `${issue.pull_request ? \"PR\" : \"Issue\"} #${issue.number}: ${issue.title}`,\n\t\t\t\turl: issue.html_url ?? url.href,\n\t\t\t\tresumen: htmlToText(issue.body ?? \"\").slice(0, 600),\n\t\t\t\tdatos: {\n\t\t\t\t\tnumero: issue.number,\n\t\t\t\t\testado: issue.state,\n\t\t\t\t\tautor: issue.user?.login,\n\t\t\t\t\tcomentarios: issue.comments,\n\t\t\t\t\tesPR: Boolean(issue.pull_request),\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\tif (seccion !== undefined && seccion !== \"\") return null; // otras subrutas (blob, tree…) no son de este scraper\n\t} else if (url.hostname === \"api.github.com\") {\n\t\tapiBase = url.href.replace(/\\/issues\\/\\d+$/, \"\");\n\t\tconst match = url.pathname.match(/^\\/repos\\/([^/]+)\\/([^/]+)/);\n\t\tif (!match) return null;\n\t\t[, owner, repo] = match;\n\t} else {\n\t\treturn null;\n\t}\n\n\tconst repoDoc = await pedirJson<DocRepo>(fetchImpl, `https://api.github.com/repos/${owner}/${repo}`, signal);\n\tif (!repoDoc?.full_name) return null;\n\treturn {\n\t\ttitulo: repoDoc.full_name,\n\t\turl: repoDoc.html_url ?? `https://github.com/${owner}/${repo}`,\n\t\tresumen: repoDoc.description ?? \"\",\n\t\tdatos: {\n\t\t\tlicencia: repoDoc.license?.spdx_id,\n\t\t\testrellas: repoDoc.stargazers_count,\n\t\t\tissuesAbiertas: repoDoc.open_issues_count,\n\t\t\tramaPorDefecto: repoDoc.default_branch,\n\t\t\tlenguaje: repoDoc.language,\n\t\t},\n\t};\n};\n"]}

package/dist/core/web/scrapers/github.js

@@ -0,0 +1,72 @@
+/**
+ * GitHub: repos e issues/PRs, vía la API REST pública (`api.github.com`).
+ * Sin clave: 60 peticiones/hora por IP, suficiente para una consulta suelta.
+ */
+import { htmlToText } from "../texto.js";
+async function pedirJson(fetchImpl, url, signal) {
+    const respuesta = await fetchImpl(url, { headers: { Accept: "application/vnd.github+json" }, signal });
+    if (respuesta.status === 404)
+        return null;
+    if (!respuesta.ok)
+        throw new Error(`GitHub respondió HTTP ${respuesta.status}.`);
+    return (await respuesta.json());
+}
+export const scrapear = async (url, fetchImpl, signal) => {
+    let owner;
+    let repo;
+    let apiBase;
+    if (url.hostname === "github.com") {
+        const partes = url.pathname.split("/").filter(Boolean);
+        if (partes.length < 2)
+            return null;
+        [owner, repo] = partes;
+        apiBase = `https://api.github.com/repos/${owner}/${repo}`;
+        const seccion = partes[2];
+        const numero = partes[3];
+        if ((seccion === "issues" || seccion === "pull") && /^\d+$/.test(numero ?? "")) {
+            const issue = await pedirJson(fetchImpl, `${apiBase}/issues/${numero}`, signal);
+            if (!issue?.title)
+                return null;
+            return {
+                titulo: `${issue.pull_request ? "PR" : "Issue"} #${issue.number}: ${issue.title}`,
+                url: issue.html_url ?? url.href,
+                resumen: htmlToText(issue.body ?? "").slice(0, 600),
+                datos: {
+                    numero: issue.number,
+                    estado: issue.state,
+                    autor: issue.user?.login,
+                    comentarios: issue.comments,
+                    esPR: Boolean(issue.pull_request),
+                },
+            };
+        }
+        if (seccion !== undefined && seccion !== "")
+            return null; // otras subrutas (blob, tree…) no son de este scraper
+    }
+    else if (url.hostname === "api.github.com") {
+        apiBase = url.href.replace(/\/issues\/\d+$/, "");
+        const match = url.pathname.match(/^\/repos\/([^/]+)\/([^/]+)/);
+        if (!match)
+            return null;
+        [, owner, repo] = match;
+    }
+    else {
+        return null;
+    }
+    const repoDoc = await pedirJson(fetchImpl, `https://api.github.com/repos/${owner}/${repo}`, signal);
+    if (!repoDoc?.full_name)
+        return null;
+    return {
+        titulo: repoDoc.full_name,
+        url: repoDoc.html_url ?? `https://github.com/${owner}/${repo}`,
+        resumen: repoDoc.description ?? "",
+        datos: {
+            licencia: repoDoc.license?.spdx_id,
+            estrellas: repoDoc.stargazers_count,
+            issuesAbiertas: repoDoc.open_issues_count,
+            ramaPorDefecto: repoDoc.default_branch,
+            lenguaje: repoDoc.language,
+        },
+    };
+};
+//# sourceMappingURL=github.js.map

package/dist/core/web/scrapers/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../../../src/core/web/scrapers/github.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyBzC,KAAK,UAAU,SAAS,CAAI,SAAuB,EAAE,GAAW,EAAE,MAAoB,EAAqB;IAC1G,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACvG,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAAyB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACjF,OAAO,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAM,CAAC;AAAA,CACrC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAmB,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACzE,IAAI,KAAa,CAAC;IAClB,IAAI,IAAY,CAAC;IACjB,IAAI,OAAe,CAAC;IACpB,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC;QACvB,OAAO,GAAG,gCAAgC,KAAK,IAAI,IAAI,EAAE,CAAC;QAE1D,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;YAChF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAW,SAAS,EAAE,GAAG,OAAO,WAAW,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;YAC1F,IAAI,CAAC,KAAK,EAAE,KAAK;gBAAE,OAAO,IAAI,CAAC;YAC/B,OAAO;gBACN,MAAM,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE;gBACjF,GAAG,EAAE,KAAK,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI;gBAC/B,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBACnD,KAAK,EAAE;oBACN,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,MAAM,EAAE,KAAK,CAAC,KAAK;oBACnB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK;oBACxB,WAAW,EAAE,KAAK,CAAC,QAAQ;oBAC3B,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;iBACjC;aACD,CAAC;QACH,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC,CAAC,wDAAsD;IACjH,CAAC;SAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;QAC9C,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;SAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,SAAS,CAAU,SAAS,EAAE,gCAAgC,KAAK,IAAI,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7G,IAAI,CAAC,OAAO,EAAE,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,SAAS;QACzB,GAAG,EAAE,OAAO,CAAC,QAAQ,IAAI,sBAAsB,KAAK,IAAI,IAAI,EAAE;QAC9D,OAAO,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QAClC,KAAK,EAAE;YACN,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO;YAClC,SAAS,EAAE,OAAO,CAAC,gBAAgB;YACnC,cAAc,EAAE,OAAO,CAAC,iBAAiB;YACzC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC1B;KACD,CAAC;AAAA,CACF,CAAC","sourcesContent":["/**\n * GitHub: repos e issues/PRs, vía la API REST pública (`api.github.com`).\n * Sin clave: 60 peticiones/hora por IP, suficiente para una consulta suelta.\n */\nimport { htmlToText } from \"../texto.ts\";\nimport type { FuncionScraper } from \"./tipos.ts\";\n\ninterface DocRepo {\n\tfull_name?: string;\n\tdescription?: string;\n\tlicense?: { spdx_id?: string };\n\tstargazers_count?: number;\n\topen_issues_count?: number;\n\tdefault_branch?: string;\n\tlanguage?: string;\n\thtml_url?: string;\n}\n\ninterface DocIssue {\n\ttitle?: string;\n\tbody?: string;\n\tstate?: string;\n\tnumber?: number;\n\tuser?: { login?: string };\n\tcomments?: number;\n\tpull_request?: unknown;\n\thtml_url?: string;\n}\n\nasync function pedirJson<T>(fetchImpl: typeof fetch, url: string, signal?: AbortSignal): Promise<T | null> {\n\tconst respuesta = await fetchImpl(url, { headers: { Accept: \"application/vnd.github+json\" }, signal });\n\tif (respuesta.status === 404) return null;\n\tif (!respuesta.ok) throw new Error(`GitHub respondió HTTP ${respuesta.status}.`);\n\treturn (await respuesta.json()) as T;\n}\n\nexport const scrapear: FuncionScraper = async (url, fetchImpl, signal) => {\n\tlet owner: string;\n\tlet repo: string;\n\tlet apiBase: string;\n\tif (url.hostname === \"github.com\") {\n\t\tconst partes = url.pathname.split(\"/\").filter(Boolean);\n\t\tif (partes.length < 2) return null;\n\t\t[owner, repo] = partes;\n\t\tapiBase = `https://api.github.com/repos/${owner}/${repo}`;\n\n\t\tconst seccion = partes[2];\n\t\tconst numero = partes[3];\n\t\tif ((seccion === \"issues\" || seccion === \"pull\") && /^\\d+$/.test(numero ?? \"\")) {\n\t\t\tconst issue = await pedirJson<DocIssue>(fetchImpl, `${apiBase}/issues/${numero}`, signal);\n\t\t\tif (!issue?.title) return null;\n\t\t\treturn {\n\t\t\t\ttitulo: `${issue.pull_request ? \"PR\" : \"Issue\"} #${issue.number}: ${issue.title}`,\n\t\t\t\turl: issue.html_url ?? url.href,\n\t\t\t\tresumen: htmlToText(issue.body ?? \"\").slice(0, 600),\n\t\t\t\tdatos: {\n\t\t\t\t\tnumero: issue.number,\n\t\t\t\t\testado: issue.state,\n\t\t\t\t\tautor: issue.user?.login,\n\t\t\t\t\tcomentarios: issue.comments,\n\t\t\t\t\tesPR: Boolean(issue.pull_request),\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\tif (seccion !== undefined && seccion !== \"\") return null; // otras subrutas (blob, tree…) no son de este scraper\n\t} else if (url.hostname === \"api.github.com\") {\n\t\tapiBase = url.href.replace(/\\/issues\\/\\d+$/, \"\");\n\t\tconst match = url.pathname.match(/^\\/repos\\/([^/]+)\\/([^/]+)/);\n\t\tif (!match) return null;\n\t\t[, owner, repo] = match;\n\t} else {\n\t\treturn null;\n\t}\n\n\tconst repoDoc = await pedirJson<DocRepo>(fetchImpl, `https://api.github.com/repos/${owner}/${repo}`, signal);\n\tif (!repoDoc?.full_name) return null;\n\treturn {\n\t\ttitulo: repoDoc.full_name,\n\t\turl: repoDoc.html_url ?? `https://github.com/${owner}/${repo}`,\n\t\tresumen: repoDoc.description ?? \"\",\n\t\tdatos: {\n\t\t\tlicencia: repoDoc.license?.spdx_id,\n\t\t\testrellas: repoDoc.stargazers_count,\n\t\t\tissuesAbiertas: repoDoc.open_issues_count,\n\t\t\tramaPorDefecto: repoDoc.default_branch,\n\t\t\tlenguaje: repoDoc.language,\n\t\t},\n\t};\n};\n"]}

package/dist/core/web/scrapers/go-pkg.d.ts

@@ -0,0 +1,7 @@
+/**
+ * pkg.go.dev, vía el proxy de módulos de Go (`proxy.golang.org`) — sin clave,
+ * es infraestructura pública del propio toolchain de Go.
+ */
+import type { FuncionScraper } from "./tipos.ts";
+export declare const scrapear: FuncionScraper;
+//# sourceMappingURL=go-pkg.d.ts.map

package/dist/core/web/scrapers/go-pkg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-pkg.d.ts","sourceRoot":"","sources":["../../../../src/core/web/scrapers/go-pkg.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD,eAAO,MAAM,QAAQ,EAAE,cA0BtB,CAAC","sourcesContent":["/**\n * pkg.go.dev, vía el proxy de módulos de Go (`proxy.golang.org`) — sin clave,\n * es infraestructura pública del propio toolchain de Go.\n */\nimport type { FuncionScraper } from \"./tipos.ts\";\n\ninterface DocGoInfo {\n\tVersion?: string;\n\tTime?: string;\n\tOrigin?: { URL?: string };\n}\n\nexport const scrapear: FuncionScraper = async (url, fetchImpl, signal) => {\n\tif (url.hostname !== \"pkg.go.dev\") return null;\n\tconst ruta = url.pathname.slice(1);\n\tif (!ruta) return null;\n\n\t// Formas: /modulo, /modulo@version, /modulo/subpaquete[@version]. El proxy\n\t// solo entiende el módulo raíz, así que se descarta todo lo de después de `@`.\n\tconst arroba = ruta.indexOf(\"@\");\n\tconst modulo = arroba === -1 ? ruta : ruta.slice(0, arroba);\n\n\t// Limitación conocida: un subpaquete (p.ej. golang.org/x/text/encoding) no es\n\t// el módulo raíz (golang.org/x/text), y resolver eso implicaría ir probando\n\t// prefijos contra el proxy. Se deja sin resolver a propósito: un 404 aquí\n\t// cae al `web_fetch` genérico, que sí sabe leer la página humana.\n\tconst respuesta = await fetchImpl(`https://proxy.golang.org/${encodeURIComponent(modulo)}/@latest`, { signal });\n\tif (respuesta.status === 404 || respuesta.status === 410) return null;\n\tif (!respuesta.ok) throw new Error(`pkg.go.dev (vía proxy.golang.org) respondió HTTP ${respuesta.status}.`);\n\tconst doc = (await respuesta.json()) as DocGoInfo;\n\tif (!doc.Version) return null;\n\n\treturn {\n\t\ttitulo: `${modulo}@${doc.Version}`,\n\t\turl: `https://pkg.go.dev/${modulo}`,\n\t\tresumen: \"\",\n\t\tdatos: { modulo, version: doc.Version, publicado: doc.Time, origen: doc.Origin?.URL },\n\t};\n};\n"]}