@hoilab/ada-cli 0.84.22 → 0.85.0

package/dist/core/browser/sesion.js

@@ -0,0 +1,176 @@
+/**
+ * El navegador del agente.
+ *
+ * Arranca Chrome con un **perfil propio y vacío** (`--user-data-dir` dentro de
+ * `<agentDir>/browser`). Eso no es un detalle de limpieza: convierte la regla
+ * de "solo se conducen las pestañas del agente" en algo estructural en vez de
+ * una promesa. En ese perfil no hay cookies, ni sesiones iniciadas, ni el
+ * correo del usuario — aunque el agente se equivoque, no hay nada que filtrar.
+ *
+ * El precio es que no puede usar sitios donde el usuario ya está identificado.
+ * Es el precio correcto: la alternativa es un agente con acceso al banco.
+ */
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { ClienteCdp } from "./cdp.js";
+import { exigirPestañaPropia } from "./politica.js";
+const CANDIDATOS_CHROME = [
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+    "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+    "/usr/bin/google-chrome",
+    "/usr/bin/chromium",
+    "/usr/bin/chromium-browser",
+    "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
+    "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
+];
+export function buscarNavegador(candidatos = CANDIDATOS_CHROME) {
+    return candidatos.find((ruta) => existsSync(ruta)) ?? null;
+}
+export class NavegadorAgente {
+    proceso = null;
+    cliente = null;
+    pestañas = new Map();
+    sesionesPorTarget = new Map();
+    // Campo normal y no propiedad de constructor: el repo compila con
+    // `erasableSyntaxOnly`, que prohíbe la forma corta.
+    viewport;
+    constructor(proceso, cliente, viewport) {
+        this.proceso = proceso;
+        this.cliente = cliente;
+        this.viewport = viewport;
+    }
+    static async abrir(opciones) {
+        const ejecutable = opciones.ejecutable ?? buscarNavegador();
+        if (!ejecutable) {
+            throw new Error("No se encontró Chrome, Chromium, Edge ni Brave. Instala uno o pasa la ruta en la configuración.");
+        }
+        const perfil = join(opciones.agentDir, "browser", "perfil");
+        mkdirSync(perfil, { recursive: true, mode: 0o700 });
+        const viewport = opciones.viewport ?? { width: 1280, height: 800 };
+        const puerto = opciones.puerto ?? 0;
+        const proceso = spawn(ejecutable, [
+            `--remote-debugging-port=${puerto}`,
+            // Perfil propio y vacío: ver la cabecera del fichero.
+            `--user-data-dir=${perfil}`,
+            "--no-first-run",
+            "--no-default-browser-check",
+            // Sin esto, Chrome puede reutilizar una instancia ya abierta del
+            // usuario y acabaríamos conduciendo SU navegador.
+            "--disable-features=ChromeWhatsNewUI",
+            `--window-size=${viewport.width},${viewport.height}`,
+            ...(opciones.headless ? ["--headless=new"] : []),
+            "about:blank",
+        ], { stdio: ["ignore", "ignore", "pipe"] });
+        const urlWs = await leerUrlDevTools(proceso);
+        const cliente = await ClienteCdp.conectar(urlWs);
+        return new NavegadorAgente(proceso, cliente, viewport);
+    }
+    exigirCliente() {
+        if (!this.cliente)
+            throw new Error("el navegador está cerrado");
+        return this.cliente;
+    }
+    /** Abre una pestaña NUEVA. Es la única forma de que el agente tenga una. */
+    async abrirPestaña(url) {
+        const cliente = this.exigirCliente();
+        const { targetId } = await cliente.enviar("Target.createTarget", { url });
+        const { sessionId } = await cliente.enviar("Target.attachToTarget", {
+            targetId,
+            flatten: true,
+        });
+        this.sesionesPorTarget.set(targetId, sessionId);
+        const pestaña = { targetId, url, propia: true };
+        this.pestañas.set(targetId, pestaña);
+        await cliente.enviar("Page.enable", {}, sessionId);
+        await cliente.enviar("Runtime.enable", {}, sessionId);
+        return pestaña;
+    }
+    sesionDe(targetId) {
+        exigirPestañaPropia(this.pestañas, targetId);
+        const sessionId = this.sesionesPorTarget.get(targetId);
+        if (!sessionId)
+            throw new Error(`la pestaña ${targetId} no está conectada`);
+        return sessionId;
+    }
+    async navegar(targetId, url) {
+        const sessionId = this.sesionDe(targetId);
+        await this.exigirCliente().enviar("Page.navigate", { url }, sessionId);
+        const pestaña = this.pestañas.get(targetId);
+        if (pestaña)
+            pestaña.url = url;
+    }
+    /** Evalúa JavaScript en la pestaña y devuelve el valor serializado. */
+    async evaluar(targetId, expresion) {
+        const sessionId = this.sesionDe(targetId);
+        const respuesta = await this.exigirCliente().enviar("Runtime.evaluate", { expression: expresion, returnByValue: true, awaitPromise: true }, sessionId);
+        if (respuesta.exceptionDetails) {
+            throw new Error(respuesta.exceptionDetails.exception?.description ??
+                respuesta.exceptionDetails.text ??
+                "error en la página");
+        }
+        return respuesta.result?.value;
+    }
+    async capturar(targetId) {
+        const sessionId = this.sesionDe(targetId);
+        const { data } = await this.exigirCliente().enviar("Page.captureScreenshot", { format: "png" }, sessionId);
+        return data;
+    }
+    async cambiarViewport(targetId, width, height, movil = false) {
+        const sessionId = this.sesionDe(targetId);
+        await this.exigirCliente().enviar("Emulation.setDeviceMetricsOverride", { width, height, deviceScaleFactor: 1, mobile: movil }, sessionId);
+        this.viewport = { width, height };
+    }
+    get viewportActual() {
+        return { ...this.viewport };
+    }
+    async cerrarPestaña(targetId) {
+        this.sesionDe(targetId);
+        await this.exigirCliente().enviar("Target.closeTarget", { targetId });
+        this.pestañas.delete(targetId);
+        this.sesionesPorTarget.delete(targetId);
+    }
+    listarPestañas() {
+        return [...this.pestañas.values()];
+    }
+    cerrar() {
+        this.cliente?.cerrar();
+        this.cliente = null;
+        this.proceso?.kill();
+        this.proceso = null;
+        this.pestañas.clear();
+        this.sesionesPorTarget.clear();
+    }
+}
+/**
+ * Lee la URL de DevTools que Chrome escribe en stderr al arrancar.
+ *
+ * Se lee del proceso en vez de sondear `http://localhost:<puerto>/json/version`
+ * porque con `--remote-debugging-port=0` el puerto lo elige el sistema y no lo
+ * sabemos de antemano. Sondear un puerto fijo, además, podría acertar con una
+ * instancia de Chrome que ya tuviera el usuario abierta — y acabaríamos
+ * conduciendo su navegador con sus sesiones.
+ */
+function leerUrlDevTools(proceso, timeoutMs = 15_000) {
+    return new Promise((resolve, reject) => {
+        let acumulado = "";
+        const temporizador = setTimeout(() => {
+            reject(new Error(`el navegador no anunció su puerto de depuración en ${timeoutMs} ms`));
+        }, timeoutMs);
+        const terminar = (fn) => {
+            clearTimeout(temporizador);
+            fn();
+        };
+        proceso.stderr?.on("data", (trozo) => {
+            acumulado += trozo.toString("utf8");
+            const encontrado = acumulado.match(/ws:\/\/[^\s]+/);
+            if (encontrado)
+                terminar(() => resolve(encontrado[0]));
+        });
+        proceso.on("error", (error) => terminar(() => reject(error)));
+        proceso.on("exit", (codigo) => terminar(() => reject(new Error(`el navegador se cerró con código ${codigo} antes de arrancar`))));
+    });
+}
+//# sourceMappingURL=sesion.js.map

package/dist/core/browser/sesion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sesion.js","sourceRoot":"","sources":["../../../src/core/browser/sesion.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * El navegador del agente.\n *\n * Arranca Chrome con un **perfil propio y vacío** (`--user-data-dir` dentro de\n * `<agentDir>/browser`). Eso no es un detalle de limpieza: convierte la regla\n * de \"solo se conducen las pestañas del agente\" en algo estructural en vez de\n * una promesa. En ese perfil no hay cookies, ni sesiones iniciadas, ni el\n * correo del usuario — aunque el agente se equivoque, no hay nada que filtrar.\n *\n * El precio es que no puede usar sitios donde el usuario ya está identificado.\n * Es el precio correcto: la alternativa es un agente con acceso al banco.\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync, mkdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { ClienteCdp } from \"./cdp.ts\";\nimport { exigirPestañaPropia, type Pestaña } from \"./politica.ts\";\n\nconst CANDIDATOS_CHROME = [\n\t\"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\",\n\t\"/Applications/Chromium.app/Contents/MacOS/Chromium\",\n\t\"/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge\",\n\t\"/Applications/Brave Browser.app/Contents/MacOS/Brave Browser\",\n\t\"/usr/bin/google-chrome\",\n\t\"/usr/bin/chromium\",\n\t\"/usr/bin/chromium-browser\",\n\t\"C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe\",\n\t\"C:\\\\Program Files (x86)\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe\",\n];\n\nexport function buscarNavegador(candidatos: string[] = CANDIDATOS_CHROME): string | null {\n\treturn candidatos.find((ruta) => existsSync(ruta)) ?? null;\n}\n\nexport interface OpcionesNavegador {\n\tagentDir: string;\n\t/** 0 = que el sistema elija uno libre, que es lo que queremos. */\n\tpuerto?: number;\n\theadless?: boolean;\n\tejecutable?: string;\n\t/** Ancho y alto iniciales; `browser_viewport` los cambia después. */\n\tviewport?: { width: number; height: number };\n}\n\nexport class NavegadorAgente {\n\tprivate proceso: ChildProcess | null = null;\n\tprivate cliente: ClienteCdp | null = null;\n\tprivate pestañas = new Map<string, Pestaña>();\n\tprivate sesionesPorTarget = new Map<string, string>();\n\n\t// Campo normal y no propiedad de constructor: el repo compila con\n\t// `erasableSyntaxOnly`, que prohíbe la forma corta.\n\tprivate viewport: { width: number; height: number };\n\n\tprivate constructor(proceso: ChildProcess, cliente: ClienteCdp, viewport: { width: number; height: number }) {\n\t\tthis.proceso = proceso;\n\t\tthis.cliente = cliente;\n\t\tthis.viewport = viewport;\n\t}\n\n\tstatic async abrir(opciones: OpcionesNavegador): Promise<NavegadorAgente> {\n\t\tconst ejecutable = opciones.ejecutable ?? buscarNavegador();\n\t\tif (!ejecutable) {\n\t\t\tthrow new Error(\n\t\t\t\t\"No se encontró Chrome, Chromium, Edge ni Brave. Instala uno o pasa la ruta en la configuración.\",\n\t\t\t);\n\t\t}\n\t\tconst perfil = join(opciones.agentDir, \"browser\", \"perfil\");\n\t\tmkdirSync(perfil, { recursive: true, mode: 0o700 });\n\t\tconst viewport = opciones.viewport ?? { width: 1280, height: 800 };\n\n\t\tconst puerto = opciones.puerto ?? 0;\n\t\tconst proceso = spawn(\n\t\t\tejecutable,\n\t\t\t[\n\t\t\t\t`--remote-debugging-port=${puerto}`,\n\t\t\t\t// Perfil propio y vacío: ver la cabecera del fichero.\n\t\t\t\t`--user-data-dir=${perfil}`,\n\t\t\t\t\"--no-first-run\",\n\t\t\t\t\"--no-default-browser-check\",\n\t\t\t\t// Sin esto, Chrome puede reutilizar una instancia ya abierta del\n\t\t\t\t// usuario y acabaríamos conduciendo SU navegador.\n\t\t\t\t\"--disable-features=ChromeWhatsNewUI\",\n\t\t\t\t`--window-size=${viewport.width},${viewport.height}`,\n\t\t\t\t...(opciones.headless ? [\"--headless=new\"] : []),\n\t\t\t\t\"about:blank\",\n\t\t\t],\n\t\t\t{ stdio: [\"ignore\", \"ignore\", \"pipe\"] },\n\t\t);\n\n\t\tconst urlWs = await leerUrlDevTools(proceso);\n\t\tconst cliente = await ClienteCdp.conectar(urlWs);\n\t\treturn new NavegadorAgente(proceso, cliente, viewport);\n\t}\n\n\tprivate exigirCliente(): ClienteCdp {\n\t\tif (!this.cliente) throw new Error(\"el navegador está cerrado\");\n\t\treturn this.cliente;\n\t}\n\n\t/** Abre una pestaña NUEVA. Es la única forma de que el agente tenga una. */\n\tasync abrirPestaña(url: string): Promise<Pestaña> {\n\t\tconst cliente = this.exigirCliente();\n\t\tconst { targetId } = await cliente.enviar<{ targetId: string }>(\"Target.createTarget\", { url });\n\t\tconst { sessionId } = await cliente.enviar<{ sessionId: string }>(\"Target.attachToTarget\", {\n\t\t\ttargetId,\n\t\t\tflatten: true,\n\t\t});\n\t\tthis.sesionesPorTarget.set(targetId, sessionId);\n\t\tconst pestaña: Pestaña = { targetId, url, propia: true };\n\t\tthis.pestañas.set(targetId, pestaña);\n\t\tawait cliente.enviar(\"Page.enable\", {}, sessionId);\n\t\tawait cliente.enviar(\"Runtime.enable\", {}, sessionId);\n\t\treturn pestaña;\n\t}\n\n\tprivate sesionDe(targetId: string): string {\n\t\texigirPestañaPropia(this.pestañas, targetId);\n\t\tconst sessionId = this.sesionesPorTarget.get(targetId);\n\t\tif (!sessionId) throw new Error(`la pestaña ${targetId} no está conectada`);\n\t\treturn sessionId;\n\t}\n\n\tasync navegar(targetId: string, url: string): Promise<void> {\n\t\tconst sessionId = this.sesionDe(targetId);\n\t\tawait this.exigirCliente().enviar(\"Page.navigate\", { url }, sessionId);\n\t\tconst pestaña = this.pestañas.get(targetId);\n\t\tif (pestaña) pestaña.url = url;\n\t}\n\n\t/** Evalúa JavaScript en la pestaña y devuelve el valor serializado. */\n\tasync evaluar<T = unknown>(targetId: string, expresion: string): Promise<T> {\n\t\tconst sessionId = this.sesionDe(targetId);\n\t\tconst respuesta = await this.exigirCliente().enviar<{\n\t\t\tresult?: { value?: T };\n\t\t\texceptionDetails?: { text?: string; exception?: { description?: string } };\n\t\t}>(\"Runtime.evaluate\", { expression: expresion, returnByValue: true, awaitPromise: true }, sessionId);\n\t\tif (respuesta.exceptionDetails) {\n\t\t\tthrow new Error(\n\t\t\t\trespuesta.exceptionDetails.exception?.description ??\n\t\t\t\t\trespuesta.exceptionDetails.text ??\n\t\t\t\t\t\"error en la página\",\n\t\t\t);\n\t\t}\n\t\treturn respuesta.result?.value as T;\n\t}\n\n\tasync capturar(targetId: string): Promise<string> {\n\t\tconst sessionId = this.sesionDe(targetId);\n\t\tconst { data } = await this.exigirCliente().enviar<{ data: string }>(\n\t\t\t\"Page.captureScreenshot\",\n\t\t\t{ format: \"png\" },\n\t\t\tsessionId,\n\t\t);\n\t\treturn data;\n\t}\n\n\tasync cambiarViewport(targetId: string, width: number, height: number, movil = false): Promise<void> {\n\t\tconst sessionId = this.sesionDe(targetId);\n\t\tawait this.exigirCliente().enviar(\n\t\t\t\"Emulation.setDeviceMetricsOverride\",\n\t\t\t{ width, height, deviceScaleFactor: 1, mobile: movil },\n\t\t\tsessionId,\n\t\t);\n\t\tthis.viewport = { width, height };\n\t}\n\n\tget viewportActual(): { width: number; height: number } {\n\t\treturn { ...this.viewport };\n\t}\n\n\tasync cerrarPestaña(targetId: string): Promise<void> {\n\t\tthis.sesionDe(targetId);\n\t\tawait this.exigirCliente().enviar(\"Target.closeTarget\", { targetId });\n\t\tthis.pestañas.delete(targetId);\n\t\tthis.sesionesPorTarget.delete(targetId);\n\t}\n\n\tlistarPestañas(): Pestaña[] {\n\t\treturn [...this.pestañas.values()];\n\t}\n\n\tcerrar(): void {\n\t\tthis.cliente?.cerrar();\n\t\tthis.cliente = null;\n\t\tthis.proceso?.kill();\n\t\tthis.proceso = null;\n\t\tthis.pestañas.clear();\n\t\tthis.sesionesPorTarget.clear();\n\t}\n}\n\n/**\n * Lee la URL de DevTools que Chrome escribe en stderr al arrancar.\n *\n * Se lee del proceso en vez de sondear `http://localhost:<puerto>/json/version`\n * porque con `--remote-debugging-port=0` el puerto lo elige el sistema y no lo\n * sabemos de antemano. Sondear un puerto fijo, además, podría acertar con una\n * instancia de Chrome que ya tuviera el usuario abierta — y acabaríamos\n * conduciendo su navegador con sus sesiones.\n */\nfunction leerUrlDevTools(proceso: ChildProcess, timeoutMs = 15_000): Promise<string> {\n\treturn new Promise((resolve, reject) => {\n\t\tlet acumulado = \"\";\n\t\tconst temporizador = setTimeout(() => {\n\t\t\treject(new Error(`el navegador no anunció su puerto de depuración en ${timeoutMs} ms`));\n\t\t}, timeoutMs);\n\n\t\tconst terminar = (fn: () => void) => {\n\t\t\tclearTimeout(temporizador);\n\t\t\tfn();\n\t\t};\n\n\t\tproceso.stderr?.on(\"data\", (trozo: Buffer) => {\n\t\t\tacumulado += trozo.toString(\"utf8\");\n\t\t\tconst encontrado = acumulado.match(/ws:\\/\\/[^\\s]+/);\n\t\t\tif (encontrado) terminar(() => resolve(encontrado[0]));\n\t\t});\n\t\tproceso.on(\"error\", (error) => terminar(() => reject(error)));\n\t\tproceso.on(\"exit\", (codigo) =>\n\t\t\tterminar(() => reject(new Error(`el navegador se cerró con código ${codigo} antes de arrancar`))),\n\t\t);\n\t});\n}\n"]}

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

@@ -0,0 +1,16 @@
+/**
+ * Tools de navegador para el agente.
+ *
+ * El navegador arranca perezosamente: la primera tool que lo necesita lo abre.
+ * Nadie paga un proceso de Chrome por tener las tools registradas.
+ *
+ * Las tres reglas viven en `politica.ts` y aquí solo se aplican. La que más se
+ * nota en el uso: el agente **solo conduce las pestañas que abrió él**, y
+ * además lo hace en un perfil vacío sin ninguna sesión del usuario.
+ */
+import type { ToolDefinition } from "../extensions/types.ts";
+import { type OpcionesNavegador } from "./sesion.ts";
+export declare function crearBrowserTools(opciones: OpcionesNavegador & {
+    ordenador?: boolean;
+}): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/core/browser/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA4EtE,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,iBAAiB,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwOhC","sourcesContent":["/**\n * Tools de navegador para el agente.\n *\n * El navegador arranca perezosamente: la primera tool que lo necesita lo abre.\n * Nadie paga un proceso de Chrome por tener las tools registradas.\n *\n * Las tres reglas viven en `politica.ts` y aquí solo se aplican. La que más se\n * nota en el uso: el agente **solo conduce las pestañas que abrió él**, y\n * además lo hace en un perfil vacío sin ninguna sesión del usuario.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport { reglaDeEleccion } from \"../prompt-eleccion.ts\";\nimport { CampoSecretoError, esCampoSecreto, pareceIrreversible, urlNavegable } from \"./politica.ts\";\nimport { NavegadorAgente, type OpcionesNavegador } from \"./sesion.ts\";\n\n/**\n * Cómo usar el navegador, no solo que existe.\n *\n * Sin esto el modelo intentaría conducir pestañas que no abrió (y que fallan\n * con un error que no entiende), o pulsaría \"Comprar\" sin preguntar.\n */\nfunction guiaNavegador(ordenador: boolean): string[] {\n\treturn [\n\t\treglaDeEleccion({ navegador: true, ordenador }),\n\t\t\"Abre las páginas con browser_open: no puedes conducir las pestañas del usuario, solo las que abras tú.\",\n\t\t\"Usa browser_read antes de pulsar o escribir, y actúa por la referencia que devuelve; vuelve a leer después de navegar.\",\n\t\t\"Si un control envía, compra, publica, borra o acepta condiciones, pregunta al usuario ANTES de pulsarlo.\",\n\t\t\"El navegador del agente usa un perfil vacío: no hay sesiones iniciadas, así que no cuentes con estar identificado en ningún sitio.\",\n\t];\n}\n\nfunction texto(t: string): AgentToolResult<unknown> {\n\treturn { content: [{ type: \"text\" as const, text: t }], details: undefined };\n}\n\nfunction fallo(error: unknown): AgentToolResult<unknown> {\n\treturn texto(`Error: ${error instanceof Error ? error.message : String(error)}`);\n}\n\n/**\n * Script que se inyecta para leer la página.\n *\n * Devuelve el texto y los elementos con los que se puede interactuar, cada uno\n * con una referencia estable dentro de la lectura. Se marcan los campos que\n * piden credenciales y los botones que parecen irreversibles, para que el\n * agente lo sepa ANTES de tocarlos, no después.\n */\nconst LEER_PAGINA = `(() => {\n  const interactivos = [...document.querySelectorAll('a[href],button,input,select,textarea,[role=button],[role=link],[onclick]')];\n  window.__adaRefs = interactivos;\n  const visible = (el) => { const r = el.getBoundingClientRect(); return r.width > 0 && r.height > 0; };\n  return {\n    url: location.href,\n    titulo: document.title,\n    texto: (document.body?.innerText ?? '').slice(0, 20000),\n    elementos: interactivos.map((el, i) => ({\n      ref: i,\n      etiqueta: el.tagName.toLowerCase(),\n      type: el.getAttribute('type') ?? undefined,\n      name: el.getAttribute('name') ?? undefined,\n      id: el.id || undefined,\n      autocomplete: el.getAttribute('autocomplete') ?? undefined,\n      placeholder: el.getAttribute('placeholder') ?? undefined,\n      ariaLabel: el.getAttribute('aria-label') ?? undefined,\n      texto: (el.innerText || el.value || '').trim().slice(0, 120),\n      visible: visible(el),\n    })).filter((e) => e.visible).slice(0, 200),\n  };\n})()`;\n\ninterface ElementoLeido {\n\tref: number;\n\tetiqueta: string;\n\ttype?: string;\n\tname?: string;\n\tid?: string;\n\tautocomplete?: string;\n\tplaceholder?: string;\n\tariaLabel?: string;\n\ttexto: string;\n}\n\ninterface PaginaLeida {\n\turl: string;\n\ttitulo: string;\n\ttexto: string;\n\telementos: ElementoLeido[];\n}\n\nexport function crearBrowserTools(\n\topciones: OpcionesNavegador & { ordenador?: boolean },\n): Record<string, ToolDefinition> {\n\t// La regla de elección solo puede nombrar `computer_*` si esas tools existen.\n\tconst guia = guiaNavegador(opciones.ordenador === true);\n\tlet navegador: NavegadorAgente | null = null;\n\n\tconst exigirNavegador = async (): Promise<NavegadorAgente> => {\n\t\tif (!navegador) navegador = await NavegadorAgente.abrir(opciones);\n\t\treturn navegador;\n\t};\n\n\tconst abrir: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_open\",\n\t\tlabel: \"Abrir pestaña\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Abre una pestaña NUEVA en el navegador del agente y devuelve su id. \" +\n\t\t\t\"Es la única forma de tener una pestaña: las del usuario no se pueden conducir. \" +\n\t\t\t\"El navegador usa un perfil vacío, así que no hay sesiones iniciadas.\",\n\t\tpromptSnippet: \"abrir una página web para interactuar con ella\",\n\t\tparameters: Type.Object({ url: Type.String({ description: \"URL http(s) a abrir\" }) }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst url = urlNavegable(String(input.url ?? \"\"));\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst pestaña = await nav.abrirPestaña(url.toString());\n\t\t\t\treturn texto(`Pestaña abierta: ${pestaña.targetId}\\nURL: ${pestaña.url}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst navegar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_navigate\",\n\t\tlabel: \"Navegar\",\n\t\tdescription: \"Lleva una pestaña del agente a otra URL.\",\n\t\tpromptSnippet: \"cambiar de página en una pestaña ya abierta\",\n\t\tparameters: Type.Object({ tabId: Type.String(), url: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst url = urlNavegable(String(input.url ?? \"\"));\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.navegar(String(input.tabId), url.toString());\n\t\t\t\treturn texto(`Navegado a ${url}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst leer: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_read\",\n\t\tlabel: \"Leer página\",\n\t\tdescription:\n\t\t\t\"Devuelve el texto de la página y sus elementos interactivos con una referencia cada uno. \" +\n\t\t\t\"Usa esas referencias en browser_click y browser_type. Hay que volver a leer tras navegar.\",\n\t\tpromptSnippet: \"leer el contenido y los controles de una página\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst pagina = await nav.evaluar<PaginaLeida>(String(input.tabId), LEER_PAGINA);\n\t\t\t\tconst lineas = pagina.elementos.map((e) => {\n\t\t\t\t\tconst marcas = [\n\t\t\t\t\t\tesCampoSecreto(e) ? \"CREDENCIAL — el agente no escribe aquí\" : \"\",\n\t\t\t\t\t\tpareceIrreversible(e.texto) ? \"parece irreversible: pregunta antes\" : \"\",\n\t\t\t\t\t].filter(Boolean);\n\t\t\t\t\tconst desc = e.texto || e.placeholder || e.ariaLabel || e.name || e.id || \"(sin texto)\";\n\t\t\t\t\treturn `  [${e.ref}] <${e.etiqueta}${e.type ? ` type=${e.type}` : \"\"}> ${desc}${marcas.length ? ` ⚠ ${marcas.join(\"; \")}` : \"\"}`;\n\t\t\t\t});\n\t\t\t\treturn texto(\n\t\t\t\t\t`${pagina.titulo}\\n${pagina.url}\\n\\n${pagina.texto}\\n\\nElementos interactivos:\\n${lineas.join(\"\\n\") || \"  (ninguno)\"}`,\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst pulsar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_click\",\n\t\tlabel: \"Pulsar\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Pulsa un elemento por su referencia de browser_read. \" +\n\t\t\t\"Si el botón parece irreversible (enviar, comprar, publicar, borrar), pregunta al usuario antes.\",\n\t\tpromptSnippet: \"pulsar un botón o enlace de la página\",\n\t\tparameters: Type.Object({ tabId: Type.String(), ref: Type.Number() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst r = await nav.evaluar<{ ok: boolean; texto?: string; motivo?: string }>(\n\t\t\t\t\tString(input.tabId),\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = (window.__adaRefs || [])[${Number(input.ref)}];\n\t\t\t\t\t  if (!el) return { ok: false, motivo: 'referencia desconocida; vuelve a leer la página' };\n\t\t\t\t\t  const t = (el.innerText || el.value || '').trim();\n\t\t\t\t\t  el.click();\n\t\t\t\t\t  return { ok: true, texto: t };\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\tif (!r.ok) return texto(`No se pudo pulsar: ${r.motivo}`);\n\t\t\t\treturn texto(`Pulsado: ${r.texto || \"(sin texto)\"}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst escribir: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_type\",\n\t\tlabel: \"Escribir\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Escribe texto en un campo por su referencia. \" +\n\t\t\t\"Nunca escribe en campos de contraseña, token o tarjeta: eso lo hace el usuario.\",\n\t\tpromptSnippet: \"rellenar un campo de un formulario\",\n\t\tparameters: Type.Object({ tabId: Type.String(), ref: Type.Number(), texto: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst tabId = String(input.tabId);\n\t\t\t\t// Se comprueba en el momento, no con lo leído antes: la página pudo\n\t\t\t\t// cambiar el campo entre la lectura y ahora.\n\t\t\t\tconst campo = await nav.evaluar<ElementoLeido | null>(\n\t\t\t\t\ttabId,\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = (window.__adaRefs || [])[${Number(input.ref)}];\n\t\t\t\t\t  if (!el) return null;\n\t\t\t\t\t  return { ref: ${Number(input.ref)}, etiqueta: el.tagName.toLowerCase(), type: el.getAttribute('type') ?? undefined,\n\t\t\t\t\t    name: el.getAttribute('name') ?? undefined, id: el.id || undefined,\n\t\t\t\t\t    autocomplete: el.getAttribute('autocomplete') ?? undefined,\n\t\t\t\t\t    placeholder: el.getAttribute('placeholder') ?? undefined,\n\t\t\t\t\t    ariaLabel: el.getAttribute('aria-label') ?? undefined, texto: '' };\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\tif (!campo) return texto(\"No se pudo escribir: referencia desconocida; vuelve a leer la página.\");\n\t\t\t\tif (esCampoSecreto(campo)) return fallo(new CampoSecretoError());\n\n\t\t\t\tawait nav.evaluar(\n\t\t\t\t\ttabId,\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = window.__adaRefs[${Number(input.ref)}];\n\t\t\t\t\t  const setter = Object.getOwnPropertyDescriptor(el.constructor.prototype, 'value')?.set;\n\t\t\t\t\t  // El setter del prototipo, no el de la instancia: React sobrescribe\n\t\t\t\t\t  // el de la instancia y su onChange no se enteraría del cambio.\n\t\t\t\t\t  if (setter) setter.call(el, ${JSON.stringify(String(input.texto ?? \"\"))});\n\t\t\t\t\t  else el.value = ${JSON.stringify(String(input.texto ?? \"\"))};\n\t\t\t\t\t  el.dispatchEvent(new Event('input', { bubbles: true }));\n\t\t\t\t\t  el.dispatchEvent(new Event('change', { bubbles: true }));\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\treturn texto(`Escrito en [${Number(input.ref)}].`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst capturar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_screenshot\",\n\t\tlabel: \"Captura\",\n\t\tdescription: \"Captura la pestaña y devuelve la imagen.\",\n\t\tpromptSnippet: \"ver cómo se ve la página\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst data = await nav.capturar(String(input.tabId));\n\t\t\t\treturn { content: [{ type: \"image\" as const, data, mimeType: \"image/png\" }], details: undefined };\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst viewport: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_viewport\",\n\t\tlabel: \"Cambiar viewport\",\n\t\tdescription:\n\t\t\t\"Cambia el tamaño de la ventana emulada. Con movil=true, una página SIN <meta name=viewport> \" +\n\t\t\t\"usará el viewport heredado de 980 px: es lo que hace un teléfono de verdad, no un fallo.\",\n\t\tpromptSnippet: \"probar la página en otro tamaño de pantalla\",\n\t\tparameters: Type.Object({\n\t\t\ttabId: Type.String(),\n\t\t\twidth: Type.Number(),\n\t\t\theight: Type.Number(),\n\t\t\tmovil: Type.Optional(Type.Boolean()),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.cambiarViewport(\n\t\t\t\t\tString(input.tabId),\n\t\t\t\t\tNumber(input.width),\n\t\t\t\t\tNumber(input.height),\n\t\t\t\t\tinput.movil === true,\n\t\t\t\t);\n\t\t\t\treturn texto(`Viewport: ${Number(input.width)}x${Number(input.height)}${input.movil ? \" (móvil)\" : \"\"}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst cerrar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_close\",\n\t\tlabel: \"Cerrar pestaña\",\n\t\tdescription: \"Cierra una pestaña del agente.\",\n\t\tpromptSnippet: \"cerrar una pestaña que ya no hace falta\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.cerrarPestaña(String(input.tabId));\n\t\t\t\treturn texto(\"Pestaña cerrada.\");\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\treturn {\n\t\tbrowser_open: abrir as ToolDefinition,\n\t\tbrowser_navigate: navegar as ToolDefinition,\n\t\tbrowser_read: leer as ToolDefinition,\n\t\tbrowser_click: pulsar as ToolDefinition,\n\t\tbrowser_type: escribir as ToolDefinition,\n\t\tbrowser_screenshot: capturar as ToolDefinition,\n\t\tbrowser_viewport: viewport as ToolDefinition,\n\t\tbrowser_close: cerrar as ToolDefinition,\n\t};\n}\n"]}

package/dist/core/browser/tools.js

@@ -0,0 +1,279 @@
+/**
+ * Tools de navegador para el agente.
+ *
+ * El navegador arranca perezosamente: la primera tool que lo necesita lo abre.
+ * Nadie paga un proceso de Chrome por tener las tools registradas.
+ *
+ * Las tres reglas viven en `politica.ts` y aquí solo se aplican. La que más se
+ * nota en el uso: el agente **solo conduce las pestañas que abrió él**, y
+ * además lo hace en un perfil vacío sin ninguna sesión del usuario.
+ */
+import { Type } from "typebox";
+import { reglaDeEleccion } from "../prompt-eleccion.js";
+import { CampoSecretoError, esCampoSecreto, pareceIrreversible, urlNavegable } from "./politica.js";
+import { NavegadorAgente } from "./sesion.js";
+/**
+ * Cómo usar el navegador, no solo que existe.
+ *
+ * Sin esto el modelo intentaría conducir pestañas que no abrió (y que fallan
+ * con un error que no entiende), o pulsaría "Comprar" sin preguntar.
+ */
+function guiaNavegador(ordenador) {
+    return [
+        reglaDeEleccion({ navegador: true, ordenador }),
+        "Abre las páginas con browser_open: no puedes conducir las pestañas del usuario, solo las que abras tú.",
+        "Usa browser_read antes de pulsar o escribir, y actúa por la referencia que devuelve; vuelve a leer después de navegar.",
+        "Si un control envía, compra, publica, borra o acepta condiciones, pregunta al usuario ANTES de pulsarlo.",
+        "El navegador del agente usa un perfil vacío: no hay sesiones iniciadas, así que no cuentes con estar identificado en ningún sitio.",
+    ];
+}
+function texto(t) {
+    return { content: [{ type: "text", text: t }], details: undefined };
+}
+function fallo(error) {
+    return texto(`Error: ${error instanceof Error ? error.message : String(error)}`);
+}
+/**
+ * Script que se inyecta para leer la página.
+ *
+ * Devuelve el texto y los elementos con los que se puede interactuar, cada uno
+ * con una referencia estable dentro de la lectura. Se marcan los campos que
+ * piden credenciales y los botones que parecen irreversibles, para que el
+ * agente lo sepa ANTES de tocarlos, no después.
+ */
+const LEER_PAGINA = `(() => {
+  const interactivos = [...document.querySelectorAll('a[href],button,input,select,textarea,[role=button],[role=link],[onclick]')];
+  window.__adaRefs = interactivos;
+  const visible = (el) => { const r = el.getBoundingClientRect(); return r.width > 0 && r.height > 0; };
+  return {
+    url: location.href,
+    titulo: document.title,
+    texto: (document.body?.innerText ?? '').slice(0, 20000),
+    elementos: interactivos.map((el, i) => ({
+      ref: i,
+      etiqueta: el.tagName.toLowerCase(),
+      type: el.getAttribute('type') ?? undefined,
+      name: el.getAttribute('name') ?? undefined,
+      id: el.id || undefined,
+      autocomplete: el.getAttribute('autocomplete') ?? undefined,
+      placeholder: el.getAttribute('placeholder') ?? undefined,
+      ariaLabel: el.getAttribute('aria-label') ?? undefined,
+      texto: (el.innerText || el.value || '').trim().slice(0, 120),
+      visible: visible(el),
+    })).filter((e) => e.visible).slice(0, 200),
+  };
+})()`;
+export function crearBrowserTools(opciones) {
+    // La regla de elección solo puede nombrar `computer_*` si esas tools existen.
+    const guia = guiaNavegador(opciones.ordenador === true);
+    let navegador = null;
+    const exigirNavegador = async () => {
+        if (!navegador)
+            navegador = await NavegadorAgente.abrir(opciones);
+        return navegador;
+    };
+    const abrir = {
+        name: "browser_open",
+        label: "Abrir pestaña",
+        promptGuidelines: guia,
+        description: "Abre una pestaña NUEVA en el navegador del agente y devuelve su id. " +
+            "Es la única forma de tener una pestaña: las del usuario no se pueden conducir. " +
+            "El navegador usa un perfil vacío, así que no hay sesiones iniciadas.",
+        promptSnippet: "abrir una página web para interactuar con ella",
+        parameters: Type.Object({ url: Type.String({ description: "URL http(s) a abrir" }) }),
+        async execute(_id, input) {
+            try {
+                const url = urlNavegable(String(input.url ?? ""));
+                const nav = await exigirNavegador();
+                const pestaña = await nav.abrirPestaña(url.toString());
+                return texto(`Pestaña abierta: ${pestaña.targetId}\nURL: ${pestaña.url}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const navegar = {
+        name: "browser_navigate",
+        label: "Navegar",
+        description: "Lleva una pestaña del agente a otra URL.",
+        promptSnippet: "cambiar de página en una pestaña ya abierta",
+        parameters: Type.Object({ tabId: Type.String(), url: Type.String() }),
+        async execute(_id, input) {
+            try {
+                const url = urlNavegable(String(input.url ?? ""));
+                const nav = await exigirNavegador();
+                await nav.navegar(String(input.tabId), url.toString());
+                return texto(`Navegado a ${url}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const leer = {
+        name: "browser_read",
+        label: "Leer página",
+        description: "Devuelve el texto de la página y sus elementos interactivos con una referencia cada uno. " +
+            "Usa esas referencias en browser_click y browser_type. Hay que volver a leer tras navegar.",
+        promptSnippet: "leer el contenido y los controles de una página",
+        parameters: Type.Object({ tabId: Type.String() }),
+        async execute(_id, input) {
+            try {
+                const nav = await exigirNavegador();
+                const pagina = await nav.evaluar(String(input.tabId), LEER_PAGINA);
+                const lineas = pagina.elementos.map((e) => {
+                    const marcas = [
+                        esCampoSecreto(e) ? "CREDENCIAL — el agente no escribe aquí" : "",
+                        pareceIrreversible(e.texto) ? "parece irreversible: pregunta antes" : "",
+                    ].filter(Boolean);
+                    const desc = e.texto || e.placeholder || e.ariaLabel || e.name || e.id || "(sin texto)";
+                    return `  [${e.ref}] <${e.etiqueta}${e.type ? ` type=${e.type}` : ""}> ${desc}${marcas.length ? ` ⚠ ${marcas.join("; ")}` : ""}`;
+                });
+                return texto(`${pagina.titulo}\n${pagina.url}\n\n${pagina.texto}\n\nElementos interactivos:\n${lineas.join("\n") || "  (ninguno)"}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const pulsar = {
+        name: "browser_click",
+        label: "Pulsar",
+        promptGuidelines: guia,
+        description: "Pulsa un elemento por su referencia de browser_read. " +
+            "Si el botón parece irreversible (enviar, comprar, publicar, borrar), pregunta al usuario antes.",
+        promptSnippet: "pulsar un botón o enlace de la página",
+        parameters: Type.Object({ tabId: Type.String(), ref: Type.Number() }),
+        async execute(_id, input) {
+            try {
+                const nav = await exigirNavegador();
+                const r = await nav.evaluar(String(input.tabId), `(() => {
+					  const el = (window.__adaRefs || [])[${Number(input.ref)}];
+					  if (!el) return { ok: false, motivo: 'referencia desconocida; vuelve a leer la página' };
+					  const t = (el.innerText || el.value || '').trim();
+					  el.click();
+					  return { ok: true, texto: t };
+					})()`);
+                if (!r.ok)
+                    return texto(`No se pudo pulsar: ${r.motivo}`);
+                return texto(`Pulsado: ${r.texto || "(sin texto)"}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const escribir = {
+        name: "browser_type",
+        label: "Escribir",
+        promptGuidelines: guia,
+        description: "Escribe texto en un campo por su referencia. " +
+            "Nunca escribe en campos de contraseña, token o tarjeta: eso lo hace el usuario.",
+        promptSnippet: "rellenar un campo de un formulario",
+        parameters: Type.Object({ tabId: Type.String(), ref: Type.Number(), texto: Type.String() }),
+        async execute(_id, input) {
+            try {
+                const nav = await exigirNavegador();
+                const tabId = String(input.tabId);
+                // Se comprueba en el momento, no con lo leído antes: la página pudo
+                // cambiar el campo entre la lectura y ahora.
+                const campo = await nav.evaluar(tabId, `(() => {
+					  const el = (window.__adaRefs || [])[${Number(input.ref)}];
+					  if (!el) return null;
+					  return { ref: ${Number(input.ref)}, etiqueta: el.tagName.toLowerCase(), type: el.getAttribute('type') ?? undefined,
+					    name: el.getAttribute('name') ?? undefined, id: el.id || undefined,
+					    autocomplete: el.getAttribute('autocomplete') ?? undefined,
+					    placeholder: el.getAttribute('placeholder') ?? undefined,
+					    ariaLabel: el.getAttribute('aria-label') ?? undefined, texto: '' };
+					})()`);
+                if (!campo)
+                    return texto("No se pudo escribir: referencia desconocida; vuelve a leer la página.");
+                if (esCampoSecreto(campo))
+                    return fallo(new CampoSecretoError());
+                await nav.evaluar(tabId, `(() => {
+					  const el = window.__adaRefs[${Number(input.ref)}];
+					  const setter = Object.getOwnPropertyDescriptor(el.constructor.prototype, 'value')?.set;
+					  // El setter del prototipo, no el de la instancia: React sobrescribe
+					  // el de la instancia y su onChange no se enteraría del cambio.
+					  if (setter) setter.call(el, ${JSON.stringify(String(input.texto ?? ""))});
+					  else el.value = ${JSON.stringify(String(input.texto ?? ""))};
+					  el.dispatchEvent(new Event('input', { bubbles: true }));
+					  el.dispatchEvent(new Event('change', { bubbles: true }));
+					})()`);
+                return texto(`Escrito en [${Number(input.ref)}].`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const capturar = {
+        name: "browser_screenshot",
+        label: "Captura",
+        description: "Captura la pestaña y devuelve la imagen.",
+        promptSnippet: "ver cómo se ve la página",
+        parameters: Type.Object({ tabId: Type.String() }),
+        async execute(_id, input) {
+            try {
+                const nav = await exigirNavegador();
+                const data = await nav.capturar(String(input.tabId));
+                return { content: [{ type: "image", data, mimeType: "image/png" }], details: undefined };
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const viewport = {
+        name: "browser_viewport",
+        label: "Cambiar viewport",
+        description: "Cambia el tamaño de la ventana emulada. Con movil=true, una página SIN <meta name=viewport> " +
+            "usará el viewport heredado de 980 px: es lo que hace un teléfono de verdad, no un fallo.",
+        promptSnippet: "probar la página en otro tamaño de pantalla",
+        parameters: Type.Object({
+            tabId: Type.String(),
+            width: Type.Number(),
+            height: Type.Number(),
+            movil: Type.Optional(Type.Boolean()),
+        }),
+        async execute(_id, input) {
+            try {
+                const nav = await exigirNavegador();
+                await nav.cambiarViewport(String(input.tabId), Number(input.width), Number(input.height), input.movil === true);
+                return texto(`Viewport: ${Number(input.width)}x${Number(input.height)}${input.movil ? " (móvil)" : ""}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const cerrar = {
+        name: "browser_close",
+        label: "Cerrar pestaña",
+        description: "Cierra una pestaña del agente.",
+        promptSnippet: "cerrar una pestaña que ya no hace falta",
+        parameters: Type.Object({ tabId: Type.String() }),
+        async execute(_id, input) {
+            try {
+                const nav = await exigirNavegador();
+                await nav.cerrarPestaña(String(input.tabId));
+                return texto("Pestaña cerrada.");
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    return {
+        browser_open: abrir,
+        browser_navigate: navegar,
+        browser_read: leer,
+        browser_click: pulsar,
+        browser_type: escribir,
+        browser_screenshot: capturar,
+        browser_viewport: viewport,
+        browser_close: cerrar,
+    };
+}
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/core/browser/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tools de navegador para el agente.\n *\n * El navegador arranca perezosamente: la primera tool que lo necesita lo abre.\n * Nadie paga un proceso de Chrome por tener las tools registradas.\n *\n * Las tres reglas viven en `politica.ts` y aquí solo se aplican. La que más se\n * nota en el uso: el agente **solo conduce las pestañas que abrió él**, y\n * además lo hace en un perfil vacío sin ninguna sesión del usuario.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport { reglaDeEleccion } from \"../prompt-eleccion.ts\";\nimport { CampoSecretoError, esCampoSecreto, pareceIrreversible, urlNavegable } from \"./politica.ts\";\nimport { NavegadorAgente, type OpcionesNavegador } from \"./sesion.ts\";\n\n/**\n * Cómo usar el navegador, no solo que existe.\n *\n * Sin esto el modelo intentaría conducir pestañas que no abrió (y que fallan\n * con un error que no entiende), o pulsaría \"Comprar\" sin preguntar.\n */\nfunction guiaNavegador(ordenador: boolean): string[] {\n\treturn [\n\t\treglaDeEleccion({ navegador: true, ordenador }),\n\t\t\"Abre las páginas con browser_open: no puedes conducir las pestañas del usuario, solo las que abras tú.\",\n\t\t\"Usa browser_read antes de pulsar o escribir, y actúa por la referencia que devuelve; vuelve a leer después de navegar.\",\n\t\t\"Si un control envía, compra, publica, borra o acepta condiciones, pregunta al usuario ANTES de pulsarlo.\",\n\t\t\"El navegador del agente usa un perfil vacío: no hay sesiones iniciadas, así que no cuentes con estar identificado en ningún sitio.\",\n\t];\n}\n\nfunction texto(t: string): AgentToolResult<unknown> {\n\treturn { content: [{ type: \"text\" as const, text: t }], details: undefined };\n}\n\nfunction fallo(error: unknown): AgentToolResult<unknown> {\n\treturn texto(`Error: ${error instanceof Error ? error.message : String(error)}`);\n}\n\n/**\n * Script que se inyecta para leer la página.\n *\n * Devuelve el texto y los elementos con los que se puede interactuar, cada uno\n * con una referencia estable dentro de la lectura. Se marcan los campos que\n * piden credenciales y los botones que parecen irreversibles, para que el\n * agente lo sepa ANTES de tocarlos, no después.\n */\nconst LEER_PAGINA = `(() => {\n  const interactivos = [...document.querySelectorAll('a[href],button,input,select,textarea,[role=button],[role=link],[onclick]')];\n  window.__adaRefs = interactivos;\n  const visible = (el) => { const r = el.getBoundingClientRect(); return r.width > 0 && r.height > 0; };\n  return {\n    url: location.href,\n    titulo: document.title,\n    texto: (document.body?.innerText ?? '').slice(0, 20000),\n    elementos: interactivos.map((el, i) => ({\n      ref: i,\n      etiqueta: el.tagName.toLowerCase(),\n      type: el.getAttribute('type') ?? undefined,\n      name: el.getAttribute('name') ?? undefined,\n      id: el.id || undefined,\n      autocomplete: el.getAttribute('autocomplete') ?? undefined,\n      placeholder: el.getAttribute('placeholder') ?? undefined,\n      ariaLabel: el.getAttribute('aria-label') ?? undefined,\n      texto: (el.innerText || el.value || '').trim().slice(0, 120),\n      visible: visible(el),\n    })).filter((e) => e.visible).slice(0, 200),\n  };\n})()`;\n\ninterface ElementoLeido {\n\tref: number;\n\tetiqueta: string;\n\ttype?: string;\n\tname?: string;\n\tid?: string;\n\tautocomplete?: string;\n\tplaceholder?: string;\n\tariaLabel?: string;\n\ttexto: string;\n}\n\ninterface PaginaLeida {\n\turl: string;\n\ttitulo: string;\n\ttexto: string;\n\telementos: ElementoLeido[];\n}\n\nexport function crearBrowserTools(\n\topciones: OpcionesNavegador & { ordenador?: boolean },\n): Record<string, ToolDefinition> {\n\t// La regla de elección solo puede nombrar `computer_*` si esas tools existen.\n\tconst guia = guiaNavegador(opciones.ordenador === true);\n\tlet navegador: NavegadorAgente | null = null;\n\n\tconst exigirNavegador = async (): Promise<NavegadorAgente> => {\n\t\tif (!navegador) navegador = await NavegadorAgente.abrir(opciones);\n\t\treturn navegador;\n\t};\n\n\tconst abrir: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_open\",\n\t\tlabel: \"Abrir pestaña\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Abre una pestaña NUEVA en el navegador del agente y devuelve su id. \" +\n\t\t\t\"Es la única forma de tener una pestaña: las del usuario no se pueden conducir. \" +\n\t\t\t\"El navegador usa un perfil vacío, así que no hay sesiones iniciadas.\",\n\t\tpromptSnippet: \"abrir una página web para interactuar con ella\",\n\t\tparameters: Type.Object({ url: Type.String({ description: \"URL http(s) a abrir\" }) }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst url = urlNavegable(String(input.url ?? \"\"));\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst pestaña = await nav.abrirPestaña(url.toString());\n\t\t\t\treturn texto(`Pestaña abierta: ${pestaña.targetId}\\nURL: ${pestaña.url}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst navegar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_navigate\",\n\t\tlabel: \"Navegar\",\n\t\tdescription: \"Lleva una pestaña del agente a otra URL.\",\n\t\tpromptSnippet: \"cambiar de página en una pestaña ya abierta\",\n\t\tparameters: Type.Object({ tabId: Type.String(), url: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst url = urlNavegable(String(input.url ?? \"\"));\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.navegar(String(input.tabId), url.toString());\n\t\t\t\treturn texto(`Navegado a ${url}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst leer: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_read\",\n\t\tlabel: \"Leer página\",\n\t\tdescription:\n\t\t\t\"Devuelve el texto de la página y sus elementos interactivos con una referencia cada uno. \" +\n\t\t\t\"Usa esas referencias en browser_click y browser_type. Hay que volver a leer tras navegar.\",\n\t\tpromptSnippet: \"leer el contenido y los controles de una página\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst pagina = await nav.evaluar<PaginaLeida>(String(input.tabId), LEER_PAGINA);\n\t\t\t\tconst lineas = pagina.elementos.map((e) => {\n\t\t\t\t\tconst marcas = [\n\t\t\t\t\t\tesCampoSecreto(e) ? \"CREDENCIAL — el agente no escribe aquí\" : \"\",\n\t\t\t\t\t\tpareceIrreversible(e.texto) ? \"parece irreversible: pregunta antes\" : \"\",\n\t\t\t\t\t].filter(Boolean);\n\t\t\t\t\tconst desc = e.texto || e.placeholder || e.ariaLabel || e.name || e.id || \"(sin texto)\";\n\t\t\t\t\treturn `  [${e.ref}] <${e.etiqueta}${e.type ? ` type=${e.type}` : \"\"}> ${desc}${marcas.length ? ` ⚠ ${marcas.join(\"; \")}` : \"\"}`;\n\t\t\t\t});\n\t\t\t\treturn texto(\n\t\t\t\t\t`${pagina.titulo}\\n${pagina.url}\\n\\n${pagina.texto}\\n\\nElementos interactivos:\\n${lineas.join(\"\\n\") || \"  (ninguno)\"}`,\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst pulsar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_click\",\n\t\tlabel: \"Pulsar\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Pulsa un elemento por su referencia de browser_read. \" +\n\t\t\t\"Si el botón parece irreversible (enviar, comprar, publicar, borrar), pregunta al usuario antes.\",\n\t\tpromptSnippet: \"pulsar un botón o enlace de la página\",\n\t\tparameters: Type.Object({ tabId: Type.String(), ref: Type.Number() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst r = await nav.evaluar<{ ok: boolean; texto?: string; motivo?: string }>(\n\t\t\t\t\tString(input.tabId),\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = (window.__adaRefs || [])[${Number(input.ref)}];\n\t\t\t\t\t  if (!el) return { ok: false, motivo: 'referencia desconocida; vuelve a leer la página' };\n\t\t\t\t\t  const t = (el.innerText || el.value || '').trim();\n\t\t\t\t\t  el.click();\n\t\t\t\t\t  return { ok: true, texto: t };\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\tif (!r.ok) return texto(`No se pudo pulsar: ${r.motivo}`);\n\t\t\t\treturn texto(`Pulsado: ${r.texto || \"(sin texto)\"}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst escribir: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_type\",\n\t\tlabel: \"Escribir\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Escribe texto en un campo por su referencia. \" +\n\t\t\t\"Nunca escribe en campos de contraseña, token o tarjeta: eso lo hace el usuario.\",\n\t\tpromptSnippet: \"rellenar un campo de un formulario\",\n\t\tparameters: Type.Object({ tabId: Type.String(), ref: Type.Number(), texto: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst tabId = String(input.tabId);\n\t\t\t\t// Se comprueba en el momento, no con lo leído antes: la página pudo\n\t\t\t\t// cambiar el campo entre la lectura y ahora.\n\t\t\t\tconst campo = await nav.evaluar<ElementoLeido | null>(\n\t\t\t\t\ttabId,\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = (window.__adaRefs || [])[${Number(input.ref)}];\n\t\t\t\t\t  if (!el) return null;\n\t\t\t\t\t  return { ref: ${Number(input.ref)}, etiqueta: el.tagName.toLowerCase(), type: el.getAttribute('type') ?? undefined,\n\t\t\t\t\t    name: el.getAttribute('name') ?? undefined, id: el.id || undefined,\n\t\t\t\t\t    autocomplete: el.getAttribute('autocomplete') ?? undefined,\n\t\t\t\t\t    placeholder: el.getAttribute('placeholder') ?? undefined,\n\t\t\t\t\t    ariaLabel: el.getAttribute('aria-label') ?? undefined, texto: '' };\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\tif (!campo) return texto(\"No se pudo escribir: referencia desconocida; vuelve a leer la página.\");\n\t\t\t\tif (esCampoSecreto(campo)) return fallo(new CampoSecretoError());\n\n\t\t\t\tawait nav.evaluar(\n\t\t\t\t\ttabId,\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = window.__adaRefs[${Number(input.ref)}];\n\t\t\t\t\t  const setter = Object.getOwnPropertyDescriptor(el.constructor.prototype, 'value')?.set;\n\t\t\t\t\t  // El setter del prototipo, no el de la instancia: React sobrescribe\n\t\t\t\t\t  // el de la instancia y su onChange no se enteraría del cambio.\n\t\t\t\t\t  if (setter) setter.call(el, ${JSON.stringify(String(input.texto ?? \"\"))});\n\t\t\t\t\t  else el.value = ${JSON.stringify(String(input.texto ?? \"\"))};\n\t\t\t\t\t  el.dispatchEvent(new Event('input', { bubbles: true }));\n\t\t\t\t\t  el.dispatchEvent(new Event('change', { bubbles: true }));\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\treturn texto(`Escrito en [${Number(input.ref)}].`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst capturar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_screenshot\",\n\t\tlabel: \"Captura\",\n\t\tdescription: \"Captura la pestaña y devuelve la imagen.\",\n\t\tpromptSnippet: \"ver cómo se ve la página\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst data = await nav.capturar(String(input.tabId));\n\t\t\t\treturn { content: [{ type: \"image\" as const, data, mimeType: \"image/png\" }], details: undefined };\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst viewport: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_viewport\",\n\t\tlabel: \"Cambiar viewport\",\n\t\tdescription:\n\t\t\t\"Cambia el tamaño de la ventana emulada. Con movil=true, una página SIN <meta name=viewport> \" +\n\t\t\t\"usará el viewport heredado de 980 px: es lo que hace un teléfono de verdad, no un fallo.\",\n\t\tpromptSnippet: \"probar la página en otro tamaño de pantalla\",\n\t\tparameters: Type.Object({\n\t\t\ttabId: Type.String(),\n\t\t\twidth: Type.Number(),\n\t\t\theight: Type.Number(),\n\t\t\tmovil: Type.Optional(Type.Boolean()),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.cambiarViewport(\n\t\t\t\t\tString(input.tabId),\n\t\t\t\t\tNumber(input.width),\n\t\t\t\t\tNumber(input.height),\n\t\t\t\t\tinput.movil === true,\n\t\t\t\t);\n\t\t\t\treturn texto(`Viewport: ${Number(input.width)}x${Number(input.height)}${input.movil ? \" (móvil)\" : \"\"}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst cerrar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_close\",\n\t\tlabel: \"Cerrar pestaña\",\n\t\tdescription: \"Cierra una pestaña del agente.\",\n\t\tpromptSnippet: \"cerrar una pestaña que ya no hace falta\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.cerrarPestaña(String(input.tabId));\n\t\t\t\treturn texto(\"Pestaña cerrada.\");\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\treturn {\n\t\tbrowser_open: abrir as ToolDefinition,\n\t\tbrowser_navigate: navegar as ToolDefinition,\n\t\tbrowser_read: leer as ToolDefinition,\n\t\tbrowser_click: pulsar as ToolDefinition,\n\t\tbrowser_type: escribir as ToolDefinition,\n\t\tbrowser_screenshot: capturar as ToolDefinition,\n\t\tbrowser_viewport: viewport as ToolDefinition,\n\t\tbrowser_close: cerrar as ToolDefinition,\n\t};\n}\n"]}