@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/computer/politica.js

@@ -0,0 +1,163 @@
+/**
+ * Reglas del control del ordenador. Puro: sin procesos ni capturas.
+ *
+ * Esta es la superficie más peligrosa del producto, por encima del navegador.
+ * En el navegador podíamos aislarnos con un perfil vacío: sin cookies, sin
+ * sesiones, nada que filtrar aunque el agente se equivocara. **Aquí no hay
+ * perfil vacío.** El ratón toca el escritorio de verdad, con tu correo abierto,
+ * tu banco abierto y tu terminal abierta. Un clic mal puesto no es un error de
+ * navegación: es una transferencia.
+ *
+ * Por eso el modelo no es "el navegador pero más grande". Son tres reglas:
+ *
+ * 1. **Aplicaciones prohibidas**, sin excepción. Un gestor de contraseñas o una
+ *    app bancaria no se controla en ningún nivel, ni siquiera para mirar.
+ * 2. **Techo por categoría.** Un navegador ya tiene sus propias tools con
+ *    perfil aislado; una terminal ya tiene `bash`. Dejar que el agente teclee
+ *    ahí sería rodear las dos puertas que sí controlamos.
+ * 3. **Nunca credenciales, nunca lo irreversible sin preguntar.** Y aquí, a
+ *    diferencia del navegador, no hay DOM que inspeccionar: la regla tiene que
+ *    ser MÁS conservadora, no menos.
+ *
+ * Lo que NO hay es una lista de aplicaciones que el usuario tenga que
+ * mantener. Se probó y era peor: obligaba a configurar antes de poder usar
+ * nada, y un interruptor encendido con la lista vacía no hacía absolutamente
+ * nada. Las categorías protegen igual y no piden mantenimiento.
+ */
+/**
+ * Categorías que NUNCA se conceden al máximo, aunque el usuario diga que sí.
+ *
+ * No es paternalismo: es que para estas dos ya existe un camino mejor y
+ * controlado. Teclear en un navegador se hace con las tools de navegador, que
+ * corren en un perfil sin sesiones. Ejecutar un comando se hace con `bash`, que
+ * pasa por los permisos y queda en el registro. Permitir el teclado aquí
+ * convertiría el control del ordenador en la puerta de atrás de las otras dos.
+ */
+/**
+ * Aplicaciones que NO se conceden nunca, en ningún nivel.
+ *
+ * Un gestor de contraseñas no tiene un uso legítimo para el agente, y el modo
+ * de fallo es catastrófico: aquí ni siquiera "solo ver" vale, porque leer la
+ * pantalla de un gestor de contraseñas ES leer las contraseñas. Lo mismo con
+ * el llavero y las apps de banca.
+ *
+ * Se descubrió mirando la lista real de esta máquina: "Contraseñas" salía con
+ * techo "control total" porque no era ni navegador ni terminal.
+ */
+const PROHIBIDAS = /^(contraseñas|passwords|acceso a llaveros|keychain access|1password.*|bitwarden|dashlane|lastpass|enpass|keeper|proton pass|nordpass|authy|google authenticator|banc[oa].*|caixabank|bbva|santander)$/i;
+export function esAppProhibida(nombreApp) {
+    return PROHIBIDAS.test(nombreApp.trim());
+}
+export class AppProhibidaError extends Error {
+    constructor(app) {
+        super(`"${app}" no se puede controlar en ningún nivel: es un gestor de credenciales o una aplicación bancaria. ` +
+            `Ni siquiera verla, porque leer su pantalla es leer los secretos.`);
+        this.name = "AppProhibidaError";
+    }
+}
+const NAVEGADORES = /^(safari|google chrome|chromium|firefox|microsoft edge|brave browser|arc|opera|vivaldi|orion)$/i;
+const TERMINALES_E_IDE = /^(terminal|iterm2?|warp|alacritty|kitty|wezterm|ghostty|hyper|visual studio code|vscodium|cursor|zed|xcode|intellij idea|pycharm|webstorm|goland|rubymine|clion|phpstorm|android studio|sublime text|nova|emacs|vim|neovide)$/i;
+/** Nivel máximo que se puede conceder a una aplicación, por su categoría. */
+export function techoDeCategoria(nombreApp) {
+    const nombre = nombreApp.trim();
+    if (NAVEGADORES.test(nombre))
+        return "read";
+    if (TERMINALES_E_IDE.test(nombre))
+        return "click";
+    return "full";
+}
+const ORDEN = { read: 0, click: 1, full: 2 };
+/** El menor de dos niveles. Conceder nunca amplía por encima del techo. */
+export function menorNivel(a, b) {
+    return ORDEN[a] <= ORDEN[b] ? a : b;
+}
+/** Qué nivel mínimo exige cada acción. */
+const EXIGE = {
+    // Mirar y mover el puntero no cambia nada.
+    screenshot: "read",
+    cursor_position: "read",
+    mouse_move: "read",
+    scroll: "read",
+    // Un clic izquierdo activa cosas, pero no escribe.
+    left_click: "click",
+    double_click: "click",
+    triple_click: "click",
+    // El resto puede pegar, arrastrar o teclear: pleno.
+    // El clic derecho entra aquí porque su menú contextual trae "Pegar", que es
+    // escritura por la puerta de atrás.
+    middle_click: "full",
+    right_click: "full",
+    left_click_drag: "full",
+    type: "full",
+    key: "full",
+    hold_key: "full",
+};
+export class AccionNoPermitidaError extends Error {
+    constructor(accion, app, nivel) {
+        const alternativa = nivel === "read"
+            ? " Para un navegador usa las tools browser_*, que corren en un perfil sin sesiones."
+            : nivel === "click"
+                ? " Para ejecutar comandos usa la tool bash, que pasa por los permisos."
+                : "";
+        super(`'${accion}' no se puede hacer sobre "${app}": es ${nivel === "read" ? "un navegador" : "una terminal o un IDE"}.${alternativa}`);
+        this.name = "AccionNoPermitidaError";
+    }
+}
+/**
+ * ¿Se puede hacer esta acción sobre esta aplicación?
+ *
+ * El control del ordenador es un interruptor: o está activo o no lo está. Lo
+ * que decide qué se puede hacer sobre cada aplicación es su CATEGORÍA, que se
+ * calcula sola — no una lista que el usuario tenga que mantener al día cada
+ * vez que instala algo.
+ */
+export function exigirPermiso(accion, app) {
+    // Primero lo que no se concede nunca.
+    if (esAppProhibida(app))
+        throw new AppProhibidaError(app);
+    const techo = techoDeCategoria(app);
+    if (ORDEN[EXIGE[accion]] > ORDEN[techo])
+        throw new AccionNoPermitidaError(accion, app, techo);
+}
+/**
+ * Texto que el agente NUNCA teclea.
+ *
+ * En el navegador podíamos mirar el `type` y el `autocomplete` del campo. Aquí
+ * no hay campo que inspeccionar: solo tenemos el texto. Así que la regla mira
+ * lo que se va a escribir y bloquea lo que PARECE una credencial, aceptando
+ * falsos positivos — es preferible que el agente diga "escríbelo tú" de más a
+ * que teclee una clave de más.
+ */
+const PARECE_SECRETO = [
+    /\bsk-[a-zA-Z0-9_-]{16,}/, // claves de API estilo OpenAI/Anthropic
+    /\bghp_[a-zA-Z0-9]{20,}/, // tokens de GitHub
+    /\bgh[pousr]_[a-zA-Z0-9]{20,}/,
+    /\bxox[baprs]-[a-zA-Z0-9-]{10,}/, // Slack
+    /\bAKIA[0-9A-Z]{16}\b/, // AWS
+    /\beyJ[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}\./, // JWT
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----/,
+    /\b(?:\d[ -]?){13,19}\b/, // números de tarjeta
+    /\b[A-Z]{2}\d{2}[A-Z0-9]{10,30}\b/, // IBAN
+];
+export function pareceCredencial(texto) {
+    return PARECE_SECRETO.some((p) => p.test(texto));
+}
+export class CredencialError extends Error {
+    constructor() {
+        super("Ese texto parece una credencial (clave, token, tarjeta o IBAN). El agente no teclea credenciales: " +
+            "escríbelo tú, o usa el gestor de contraseñas.");
+        this.name = "CredencialError";
+    }
+}
+/**
+ * Combinaciones de teclas que no se pulsan sin permiso explícito.
+ *
+ * Son las que borran, envían o salen sin vuelta atrás. Igual que en el
+ * navegador, esto AVISA además de bloquear: la lista nunca será completa, y
+ * fingir que sí lo es sería peor que no tenerla.
+ */
+const TECLAS_PELIGROSAS = /^(cmd\+q|cmd\+w|cmd\+shift\+q|cmd\+delete|cmd\+shift\+delete|ctrl\+alt\+delete)$/i;
+export function teclaPeligrosa(combinacion) {
+    return TECLAS_PELIGROSAS.test(combinacion.trim().replace(/\s+/g, ""));
+}
+//# sourceMappingURL=politica.js.map

package/dist/core/computer/politica.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"politica.js","sourceRoot":"","sources":["../../../src/core/computer/politica.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Reglas del control del ordenador. Puro: sin procesos ni capturas.\n *\n * Esta es la superficie más peligrosa del producto, por encima del navegador.\n * En el navegador podíamos aislarnos con un perfil vacío: sin cookies, sin\n * sesiones, nada que filtrar aunque el agente se equivocara. **Aquí no hay\n * perfil vacío.** El ratón toca el escritorio de verdad, con tu correo abierto,\n * tu banco abierto y tu terminal abierta. Un clic mal puesto no es un error de\n * navegación: es una transferencia.\n *\n * Por eso el modelo no es \"el navegador pero más grande\". Son tres reglas:\n *\n * 1. **Aplicaciones prohibidas**, sin excepción. Un gestor de contraseñas o una\n *    app bancaria no se controla en ningún nivel, ni siquiera para mirar.\n * 2. **Techo por categoría.** Un navegador ya tiene sus propias tools con\n *    perfil aislado; una terminal ya tiene `bash`. Dejar que el agente teclee\n *    ahí sería rodear las dos puertas que sí controlamos.\n * 3. **Nunca credenciales, nunca lo irreversible sin preguntar.** Y aquí, a\n *    diferencia del navegador, no hay DOM que inspeccionar: la regla tiene que\n *    ser MÁS conservadora, no menos.\n *\n * Lo que NO hay es una lista de aplicaciones que el usuario tenga que\n * mantener. Se probó y era peor: obligaba a configurar antes de poder usar\n * nada, y un interruptor encendido con la lista vacía no hacía absolutamente\n * nada. Las categorías protegen igual y no piden mantenimiento.\n */\n\n/** Qué puede hacer el agente sobre una aplicación concreta. */\nexport type Nivel = \"read\" | \"click\" | \"full\";\n\n/**\n * Categorías que NUNCA se conceden al máximo, aunque el usuario diga que sí.\n *\n * No es paternalismo: es que para estas dos ya existe un camino mejor y\n * controlado. Teclear en un navegador se hace con las tools de navegador, que\n * corren en un perfil sin sesiones. Ejecutar un comando se hace con `bash`, que\n * pasa por los permisos y queda en el registro. Permitir el teclado aquí\n * convertiría el control del ordenador en la puerta de atrás de las otras dos.\n */\n/**\n * Aplicaciones que NO se conceden nunca, en ningún nivel.\n *\n * Un gestor de contraseñas no tiene un uso legítimo para el agente, y el modo\n * de fallo es catastrófico: aquí ni siquiera \"solo ver\" vale, porque leer la\n * pantalla de un gestor de contraseñas ES leer las contraseñas. Lo mismo con\n * el llavero y las apps de banca.\n *\n * Se descubrió mirando la lista real de esta máquina: \"Contraseñas\" salía con\n * techo \"control total\" porque no era ni navegador ni terminal.\n */\nconst PROHIBIDAS =\n\t/^(contraseñas|passwords|acceso a llaveros|keychain access|1password.*|bitwarden|dashlane|lastpass|enpass|keeper|proton pass|nordpass|authy|google authenticator|banc[oa].*|caixabank|bbva|santander)$/i;\n\nexport function esAppProhibida(nombreApp: string): boolean {\n\treturn PROHIBIDAS.test(nombreApp.trim());\n}\n\nexport class AppProhibidaError extends Error {\n\tconstructor(app: string) {\n\t\tsuper(\n\t\t\t`\"${app}\" no se puede controlar en ningún nivel: es un gestor de credenciales o una aplicación bancaria. ` +\n\t\t\t\t`Ni siquiera verla, porque leer su pantalla es leer los secretos.`,\n\t\t);\n\t\tthis.name = \"AppProhibidaError\";\n\t}\n}\n\nconst NAVEGADORES = /^(safari|google chrome|chromium|firefox|microsoft edge|brave browser|arc|opera|vivaldi|orion)$/i;\nconst TERMINALES_E_IDE =\n\t/^(terminal|iterm2?|warp|alacritty|kitty|wezterm|ghostty|hyper|visual studio code|vscodium|cursor|zed|xcode|intellij idea|pycharm|webstorm|goland|rubymine|clion|phpstorm|android studio|sublime text|nova|emacs|vim|neovide)$/i;\n\n/** Nivel máximo que se puede conceder a una aplicación, por su categoría. */\nexport function techoDeCategoria(nombreApp: string): Nivel {\n\tconst nombre = nombreApp.trim();\n\tif (NAVEGADORES.test(nombre)) return \"read\";\n\tif (TERMINALES_E_IDE.test(nombre)) return \"click\";\n\treturn \"full\";\n}\n\nconst ORDEN: Record<Nivel, number> = { read: 0, click: 1, full: 2 };\n\n/** El menor de dos niveles. Conceder nunca amplía por encima del techo. */\nexport function menorNivel(a: Nivel, b: Nivel): Nivel {\n\treturn ORDEN[a] <= ORDEN[b] ? a : b;\n}\n\n/** Acciones que el agente puede pedir, ordenadas por lo que exigen. */\nexport type Accion =\n\t| \"screenshot\"\n\t| \"cursor_position\"\n\t| \"mouse_move\"\n\t| \"scroll\"\n\t| \"left_click\"\n\t| \"double_click\"\n\t| \"triple_click\"\n\t| \"middle_click\"\n\t| \"right_click\"\n\t| \"left_click_drag\"\n\t| \"type\"\n\t| \"key\"\n\t| \"hold_key\";\n\n/** Qué nivel mínimo exige cada acción. */\nconst EXIGE: Record<Accion, Nivel> = {\n\t// Mirar y mover el puntero no cambia nada.\n\tscreenshot: \"read\",\n\tcursor_position: \"read\",\n\tmouse_move: \"read\",\n\tscroll: \"read\",\n\t// Un clic izquierdo activa cosas, pero no escribe.\n\tleft_click: \"click\",\n\tdouble_click: \"click\",\n\ttriple_click: \"click\",\n\t// El resto puede pegar, arrastrar o teclear: pleno.\n\t// El clic derecho entra aquí porque su menú contextual trae \"Pegar\", que es\n\t// escritura por la puerta de atrás.\n\tmiddle_click: \"full\",\n\tright_click: \"full\",\n\tleft_click_drag: \"full\",\n\ttype: \"full\",\n\tkey: \"full\",\n\thold_key: \"full\",\n};\n\nexport class AccionNoPermitidaError extends Error {\n\tconstructor(accion: Accion, app: string, nivel: Nivel) {\n\t\tconst alternativa =\n\t\t\tnivel === \"read\"\n\t\t\t\t? \" Para un navegador usa las tools browser_*, que corren en un perfil sin sesiones.\"\n\t\t\t\t: nivel === \"click\"\n\t\t\t\t\t? \" Para ejecutar comandos usa la tool bash, que pasa por los permisos.\"\n\t\t\t\t\t: \"\";\n\t\tsuper(\n\t\t\t`'${accion}' no se puede hacer sobre \"${app}\": es ${nivel === \"read\" ? \"un navegador\" : \"una terminal o un IDE\"}.${alternativa}`,\n\t\t);\n\t\tthis.name = \"AccionNoPermitidaError\";\n\t}\n}\n\n/**\n * ¿Se puede hacer esta acción sobre esta aplicación?\n *\n * El control del ordenador es un interruptor: o está activo o no lo está. Lo\n * que decide qué se puede hacer sobre cada aplicación es su CATEGORÍA, que se\n * calcula sola — no una lista que el usuario tenga que mantener al día cada\n * vez que instala algo.\n */\nexport function exigirPermiso(accion: Accion, app: string): void {\n\t// Primero lo que no se concede nunca.\n\tif (esAppProhibida(app)) throw new AppProhibidaError(app);\n\tconst techo = techoDeCategoria(app);\n\tif (ORDEN[EXIGE[accion]] > ORDEN[techo]) throw new AccionNoPermitidaError(accion, app, techo);\n}\n\n/**\n * Texto que el agente NUNCA teclea.\n *\n * En el navegador podíamos mirar el `type` y el `autocomplete` del campo. Aquí\n * no hay campo que inspeccionar: solo tenemos el texto. Así que la regla mira\n * lo que se va a escribir y bloquea lo que PARECE una credencial, aceptando\n * falsos positivos — es preferible que el agente diga \"escríbelo tú\" de más a\n * que teclee una clave de más.\n */\nconst PARECE_SECRETO = [\n\t/\\bsk-[a-zA-Z0-9_-]{16,}/, // claves de API estilo OpenAI/Anthropic\n\t/\\bghp_[a-zA-Z0-9]{20,}/, // tokens de GitHub\n\t/\\bgh[pousr]_[a-zA-Z0-9]{20,}/,\n\t/\\bxox[baprs]-[a-zA-Z0-9-]{10,}/, // Slack\n\t/\\bAKIA[0-9A-Z]{16}\\b/, // AWS\n\t/\\beyJ[a-zA-Z0-9_-]{10,}\\.[a-zA-Z0-9_-]{10,}\\./, // JWT\n\t/-----BEGIN [A-Z ]*PRIVATE KEY-----/,\n\t/\\b(?:\\d[ -]?){13,19}\\b/, // números de tarjeta\n\t/\\b[A-Z]{2}\\d{2}[A-Z0-9]{10,30}\\b/, // IBAN\n];\n\nexport function pareceCredencial(texto: string): boolean {\n\treturn PARECE_SECRETO.some((p) => p.test(texto));\n}\n\nexport class CredencialError extends Error {\n\tconstructor() {\n\t\tsuper(\n\t\t\t\"Ese texto parece una credencial (clave, token, tarjeta o IBAN). El agente no teclea credenciales: \" +\n\t\t\t\t\"escríbelo tú, o usa el gestor de contraseñas.\",\n\t\t);\n\t\tthis.name = \"CredencialError\";\n\t}\n}\n\n/**\n * Combinaciones de teclas que no se pulsan sin permiso explícito.\n *\n * Son las que borran, envían o salen sin vuelta atrás. Igual que en el\n * navegador, esto AVISA además de bloquear: la lista nunca será completa, y\n * fingir que sí lo es sería peor que no tenerla.\n */\nconst TECLAS_PELIGROSAS = /^(cmd\\+q|cmd\\+w|cmd\\+shift\\+q|cmd\\+delete|cmd\\+shift\\+delete|ctrl\\+alt\\+delete)$/i;\n\nexport function teclaPeligrosa(combinacion: string): boolean {\n\treturn TECLAS_PELIGROSAS.test(combinacion.trim().replace(/\\s+/g, \"\"));\n}\n"]}

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

@@ -0,0 +1,26 @@
+/**
+ * Tools de control del ordenador.
+ *
+ * El motor es nuestro fork de pi-computer-use (ver `motor/README.md`), pero el
+ * agente NO habla con él: habla con estas tools, y cada una pasa por
+ * `politica.ts` antes de mover nada. Registrar el motor directamente dejaría al
+ * modelo pulsando cualquier cosa en cualquier aplicación, y nuestra gobernanza
+ * no pintaría nada.
+ *
+ * Preferimos SIEMPRE actuar sobre el árbol de accesibilidad antes que sobre
+ * coordenadas. Pulsar "el botón Enviar" es verificable; pulsar en (840, 512) es
+ * una apuesta, y cuando falla no falla en el vacío: pulsa otra cosa.
+ *
+ * Desde el cambio de motor eso ya no es una preferencia: **para actuar hace
+ * falta el `lookId` de una observación previa**. El motor rechaza actuar sobre
+ * estado viejo, así que "lee antes de pulsar" pasó de consejo del prompt a
+ * requisito que no se puede saltar. El fallo que apareció contra TextEdit
+ * —escribir en una ventana que ya se había cerrado— dejó de ser posible.
+ */
+import type { ToolDefinition } from "../extensions/types.ts";
+/** Los nombres, sueltos, para que `agent-session` los active sin construirlas. */
+export declare const NOMBRES_COMPUTER_TOOLS: readonly ["computer_apps", "computer_read", "computer_screenshot", "computer_click", "computer_type", "computer_key", "computer_scroll", "computer_wait", "computer_text"];
+export declare function crearComputerTools(opciones?: {
+    navegador?: boolean;
+}): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/core/computer/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAkD9E,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,4KAUzB,CAAC;AAEX,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAuWzG","sourcesContent":["/**\n * Tools de control del ordenador.\n *\n * El motor es nuestro fork de pi-computer-use (ver `motor/README.md`), pero el\n * agente NO habla con él: habla con estas tools, y cada una pasa por\n * `politica.ts` antes de mover nada. Registrar el motor directamente dejaría al\n * modelo pulsando cualquier cosa en cualquier aplicación, y nuestra gobernanza\n * no pintaría nada.\n *\n * Preferimos SIEMPRE actuar sobre el árbol de accesibilidad antes que sobre\n * coordenadas. Pulsar \"el botón Enviar\" es verificable; pulsar en (840, 512) es\n * una apuesta, y cuando falla no falla en el vacío: pulsa otra cosa.\n *\n * Desde el cambio de motor eso ya no es una preferencia: **para actuar hace\n * falta el `lookId` de una observación previa**. El motor rechaza actuar sobre\n * estado viejo, así que \"lee antes de pulsar\" pasó de consejo del prompt a\n * requisito que no se puede saltar. El fallo que apareció contra TextEdit\n * —escribir en una ventana que ya se había cerrado— dejó de ser posible.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport { avisoSinNavegador, reglaDeEleccion } from \"../prompt-eleccion.ts\";\nimport { capturarPantalla } from \"./captura.ts\";\nimport {\n\tactuar,\n\tappEnPrimerPlano,\n\tesperar,\n\tleerTexto,\n\tlistarApps,\n\ttype Observacion,\n\tobservar,\n\tpidDe,\n} from \"./motor-ada.ts\";\nimport {\n\ttype Accion,\n\tCredencialError,\n\tesAppProhibida,\n\texigirPermiso,\n\tpareceCredencial,\n\ttechoDeCategoria,\n\tteclaPeligrosa,\n} from \"./politica.ts\";\n\n/**\n * Lo que el agente necesita saber para usar esto bien.\n *\n * `promptSnippet` solo dice que la tool existe. Para una capacidad que mueve el\n * ratón sobre el escritorio de verdad, saber que existe no es saber usarla.\n */\nfunction guiaOrdenador(navegador: boolean): string[] {\n\treturn [\n\t\treglaDeEleccion({ navegador, ordenador: true }),\n\t\t...(navegador ? [] : [avisoSinNavegador()]),\n\t\t\"Ante la duda entre computer_* y cualquier otra, elige la otra: manejar una ventana es lo más frágil que puedes hacer y lo que más puede romper sin avisar.\",\n\t\t\"Antes de controlar el ordenador, usa computer_apps: cada aplicación dice hasta dónde puedes llegar con ella.\",\n\t\t\"computer_read te da un lookId y las referencias de los elementos; toda acción necesita ese lookId, y si la ventana cambió tendrás que volver a leer.\",\n\t\t\"Cuando algo tarde en aparecer, usa computer_wait en vez de actuar y confiar: actuar sobre una ventana que no está lista falla en silencio.\",\n\t\t\"Si lo que vas a pulsar envía, compra, publica, borra o acepta condiciones, pregunta al usuario ANTES de hacerlo.\",\n\t\t\"No teclees contraseñas, tokens ni datos de tarjeta: pídeselo al usuario.\",\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/** Los nombres, sueltos, para que `agent-session` los active sin construirlas. */\nexport const NOMBRES_COMPUTER_TOOLS = [\n\t\"computer_apps\",\n\t\"computer_read\",\n\t\"computer_screenshot\",\n\t\"computer_click\",\n\t\"computer_type\",\n\t\"computer_key\",\n\t\"computer_scroll\",\n\t\"computer_wait\",\n\t\"computer_text\",\n] as const;\n\nexport function crearComputerTools(opciones: { navegador?: boolean } = {}): Record<string, ToolDefinition> {\n\t// Sin tools de navegador, la política que redirige \"esto es un navegador,\n\t// usa browser_*\" apuntaría al vacío. Se avisa antes en vez de después.\n\tconst guia = guiaOrdenador(opciones.navegador === true);\n\t/**\n\t * Observaciones vivas, por `lookId`.\n\t *\n\t * El agente recibe el `lookId` y lo devuelve en cada acción. Se guarda aquí\n\t * el objeto completo porque el motor necesita también el pid, y hacer que el\n\t * modelo arrastre dos identificadores sería pedirle que no se equivoque en\n\t * algo que podemos recordar nosotros.\n\t */\n\tconst observaciones = new Map<string, Observacion>();\n\n\t/** Puerta de permisos. Ver `politica.ts`. */\n\tconst guardia = (accion: Accion, app: string): void => exigirPermiso(accion, app);\n\n\t/** Resuelve el pid de una app aplicando la política antes de tocarla. */\n\tconst prepararApp = async (nombreApp: string, accion: Accion): Promise<number> => {\n\t\tguardia(accion, nombreApp);\n\t\tconst pid = await pidDe(nombreApp);\n\t\tif (pid === undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t`No encuentro ninguna aplicación abierta llamada \"${nombreApp}\". Usa computer_apps para verlas.`,\n\t\t\t);\n\t\t}\n\t\treturn pid;\n\t};\n\n\t/** Recupera una observación. Actuar sin ella es actuar a ciegas. */\n\tconst observacionDe = (lookId: string): Observacion => {\n\t\tconst obs = observaciones.get(lookId);\n\t\tif (!obs) {\n\t\t\tthrow new Error(\n\t\t\t\t`El lookId \"${lookId}\" no existe o ya caducó. Vuelve a leer la ventana con computer_read: ` +\n\t\t\t\t\t`el motor no deja actuar sobre observaciones viejas, a propósito.`,\n\t\t\t);\n\t\t}\n\t\treturn obs;\n\t};\n\n\tconst listar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_apps\",\n\t\tlabel: \"Listar aplicaciones\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Lista las aplicaciones abiertas y hasta dónde puedes llegar con cada una. \" +\n\t\t\t\"Úsalo antes de nada: cada una dice su límite.\",\n\t\tpromptSnippet: \"ver qué aplicaciones hay y hasta dónde puedo llegar con cada una\",\n\t\tparameters: Type.Object({}),\n\t\tasync execute(): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst apps = await listarApps();\n\t\t\t\tconst frente = await appEnPrimerPlano().catch(() => null);\n\t\t\t\t// El límite se anota por aplicación para que el modelo lo sepa ANTES\n\t\t\t\t// de intentar algo, en vez de descubrirlo con un error.\n\t\t\t\tconst lineas = apps.map((a) => {\n\t\t\t\t\tconst marca = frente?.pid === a.pid ? \" [primer plano]\" : \"\";\n\t\t\t\t\tif (esAppProhibida(a.nombre)) return `${a.nombre}${marca} → NUNCA (credenciales)`;\n\t\t\t\t\tconst techo = techoDeCategoria(a.nombre);\n\t\t\t\t\tconst nota =\n\t\t\t\t\t\ttecho === \"read\"\n\t\t\t\t\t\t\t? \"solo ver — para manejarlo usa browser_*\"\n\t\t\t\t\t\t\t: techo === \"click\"\n\t\t\t\t\t\t\t\t? \"ver y pulsar — para ejecutar comandos usa bash\"\n\t\t\t\t\t\t\t\t: \"control total\";\n\t\t\t\t\treturn `${a.nombre}${marca} → ${nota}`;\n\t\t\t\t});\n\t\t\t\treturn texto(lineas.join(\"\\n\"));\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: \"computer_read\",\n\t\tlabel: \"Leer la ventana\",\n\t\tdescription:\n\t\t\t\"Observa una aplicación y devuelve su árbol de elementos junto a un lookId. \" +\n\t\t\t\"TODA acción necesita ese lookId. Si la ventana cambia, vuelve a leer.\",\n\t\tpromptSnippet: \"leer los elementos de una ventana y obtener su lookId\",\n\t\tparameters: Type.Object({\n\t\t\tapp: Type.String({ description: \"Nombre de la aplicación\" }),\n\t\t\tscopeRef: Type.Optional(\n\t\t\t\tType.String({ description: \"Referencia de un elemento, para mirar solo dentro de él\" }),\n\t\t\t),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nombreApp = String(input.app ?? \"\");\n\t\t\t\tconst pid = await prepararApp(nombreApp, \"screenshot\");\n\t\t\t\tconst obs = await observar(pid, { scopeRef: input.scopeRef ? String(input.scopeRef) : undefined });\n\t\t\t\tobservaciones.set(obs.lookId, obs);\n\t\t\t\treturn texto(\n\t\t\t\t\t`Ventana: ${obs.titulo ?? \"(sin título)\"}  ·  ${obs.elementos} elementos\\n` +\n\t\t\t\t\t\t`lookId: ${obs.lookId}\\n\\n${obs.resumen}`,\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 captura: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_screenshot\",\n\t\tlabel: \"Captura de pantalla\",\n\t\tdescription: \"Captura la pantalla. Para decidir dónde pulsar, prefiere computer_read.\",\n\t\tpromptSnippet: \"ver la pantalla\",\n\t\tparameters: Type.Object({}),\n\t\tasync execute(): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(\"screenshot\", frente.nombre);\n\n\t\t\t\t// Primero, por el MOTOR. No es una preferencia estética: en macOS el\n\t\t\t\t// permiso de Grabación de pantalla se concede a una aplicación, y el\n\t\t\t\t// helper ya lo tiene. `screencapture` lo lanzaría NUESTRO proceso —\n\t\t\t\t// node, dentro de la Terminal o del escritorio — que es otra identidad\n\t\t\t\t// y necesitaría su propio permiso, uno por cada sitio desde el que se\n\t\t\t\t// use Ada. Comprobado: con el helper autorizado, `screencapture -x`\n\t\t\t\t// desde node seguía devolviendo \"could not create image from display\".\n\t\t\t\t//\n\t\t\t\t// Captura la VENTANA de delante, no la pantalla entera. Además de\n\t\t\t\t// funcionar, es lo correcto: no arrastra al contexto lo que haya en\n\t\t\t\t// otras ventanas del usuario.\n\t\t\t\tif (frente.pid !== undefined) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst obs = await observar(frente.pid, { conImagen: true });\n\t\t\t\t\t\tif (obs.imagen) {\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t\t\t{ type: \"text\" as const, text: `Ventana: ${obs.titulo ?? frente.nombre}` },\n\t\t\t\t\t\t\t\t\t{ type: \"image\" as const, data: obs.imagen.datos, mimeType: obs.imagen.mimeType },\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t\tdetails: undefined,\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Si el motor no puede, queda la captura del sistema.\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst r = await capturarPantalla();\n\t\t\t\tif (!r.imagen) return texto(r.motivo ?? \"No se pudo capturar la pantalla.\");\n\t\t\t\treturn { content: [{ type: \"image\" as const, data: r.imagen, 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 pulsar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_click\",\n\t\tlabel: \"Pulsar\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Pulsa un elemento por su referencia, usando el lookId de computer_read. \" +\n\t\t\t\"Si lo que vas a pulsar envía, compra, publica o borra, pregunta al usuario ANTES.\",\n\t\tpromptSnippet: \"pulsar un elemento de la pantalla\",\n\t\tparameters: Type.Object({\n\t\t\tlookId: Type.String(),\n\t\t\tref: Type.String({ description: \"Referencia del elemento, de computer_read\" }),\n\t\t\tboton: Type.Optional(Type.String({ description: \"left (por defecto), right, middle\" })),\n\t\t\tveces: Type.Optional(Type.Number({ description: \"1 (por defecto), 2 para doble\" })),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst boton = String(input.boton ?? \"left\") as \"left\" | \"right\" | \"middle\";\n\t\t\t\tconst veces = Number(input.veces ?? 1);\n\t\t\t\tconst accion: Accion =\n\t\t\t\t\tboton === \"right\"\n\t\t\t\t\t\t? \"right_click\"\n\t\t\t\t\t\t: boton === \"middle\"\n\t\t\t\t\t\t\t? \"middle_click\"\n\t\t\t\t\t\t\t: veces >= 3\n\t\t\t\t\t\t\t\t? \"triple_click\"\n\t\t\t\t\t\t\t\t: veces === 2\n\t\t\t\t\t\t\t\t\t? \"double_click\"\n\t\t\t\t\t\t\t\t\t: \"left_click\";\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(accion, frente.nombre);\n\t\t\t\tconst r = await actuar(obs, { tipo: \"click\", ref: String(input.ref ?? \"\"), boton, veces });\n\t\t\t\treturn texto(r.ok ? `Pulsado.${r.detalle ? `\\n${r.detalle}` : \"\"}` : `No se pudo pulsar: ${r.detalle}`);\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: \"computer_type\",\n\t\tlabel: \"Escribir\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Escribe texto en un elemento, usando el lookId de computer_read. \" +\n\t\t\t\"No escribe credenciales: claves, tokens, tarjetas o IBAN los pone el usuario.\",\n\t\tpromptSnippet: \"escribir texto en un campo\",\n\t\tparameters: Type.Object({ lookId: Type.String(), ref: Type.String(), texto: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst contenido = String(input.texto ?? \"\");\n\t\t\t\t// Antes que el permiso: si es una credencial da igual qué app sea.\n\t\t\t\tif (pareceCredencial(contenido)) return fallo(new CredencialError());\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(\"type\", frente.nombre);\n\t\t\t\tconst r = await actuar(obs, { tipo: \"escribir\", ref: String(input.ref ?? \"\"), texto: contenido });\n\t\t\t\tif (!r.ok) return texto(`No se pudo escribir: ${r.detalle}`);\n\t\t\t\t// El motor devuelve el estado posterior, así que la comprobación que\n\t\t\t\t// antes había que hacer a mano viene de serie.\n\t\t\t\treturn texto(`Escrito.${r.detalle ? `\\n${r.detalle}` : \"\"}`);\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 tecla: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_key\",\n\t\tlabel: \"Pulsar tecla\",\n\t\tdescription:\n\t\t\t\"Pulsa una tecla o combinación ('cmd+s', 'return', 'tab'). \" +\n\t\t\t\"Las que cierran o borran sin vuelta atrás necesitan que el usuario lo pida.\",\n\t\tpromptSnippet: \"pulsar una combinación de teclas\",\n\t\tparameters: Type.Object({\n\t\t\tlookId: Type.String(),\n\t\t\ttecla: Type.String(),\n\t\t\tref: Type.Optional(Type.String()),\n\t\t\tconfirmado: Type.Optional(Type.Boolean({ description: \"El usuario ha pedido esta tecla peligrosa\" })),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst combinacion = String(input.tecla ?? \"\");\n\t\t\t\tif (teclaPeligrosa(combinacion) && input.confirmado !== true) {\n\t\t\t\t\treturn texto(\n\t\t\t\t\t\t`'${combinacion}' cierra o borra sin vuelta atrás. Pregúntale al usuario y vuelve con confirmado: true.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(\"key\", frente.nombre);\n\t\t\t\tconst r = await actuar(obs, {\n\t\t\t\t\ttipo: \"teclas\",\n\t\t\t\t\tref: input.ref ? String(input.ref) : undefined,\n\t\t\t\t\tteclas: combinacion.split(\"+\").map((k) => k.trim()),\n\t\t\t\t});\n\t\t\t\treturn texto(r.ok ? `Pulsado ${combinacion}.` : `No se pudo pulsar: ${r.detalle}`);\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 desplazar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_scroll\",\n\t\tlabel: \"Desplazar\",\n\t\tdescription: \"Desplaza el contenido de un elemento.\",\n\t\tpromptSnippet: \"desplazar la pantalla\",\n\t\tparameters: Type.Object({\n\t\t\tlookId: Type.String(),\n\t\t\tref: Type.String(),\n\t\t\tdireccion: Type.String({ description: \"up, down, left, right\" }),\n\t\t\tcantidad: Type.Optional(Type.Number()),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(\"scroll\", frente.nombre);\n\t\t\t\tconst paso = Number(input.cantidad ?? 3) * 100;\n\t\t\t\tconst dir = String(input.direccion ?? \"down\");\n\t\t\t\tconst r = await actuar(obs, {\n\t\t\t\t\ttipo: \"desplazar\",\n\t\t\t\t\tref: String(input.ref ?? \"\"),\n\t\t\t\t\tx: dir === \"left\" ? -paso : dir === \"right\" ? paso : 0,\n\t\t\t\t\ty: dir === \"up\" ? -paso : dir === \"down\" ? paso : 0,\n\t\t\t\t});\n\t\t\t\treturn texto(r.ok ? \"Desplazado.\" : `No se pudo desplazar: ${r.detalle}`);\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 aguardar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_wait\",\n\t\tlabel: \"Esperar\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Espera a que un texto o un tipo de control aparezca (o desaparezca) en una ventana. \" +\n\t\t\t\"Úsalo cuando algo tarde: actuar sobre una ventana que no está lista falla en silencio.\",\n\t\tpromptSnippet: \"esperar a que la pantalla cambie\",\n\t\tparameters: Type.Object({\n\t\t\tapp: Type.String(),\n\t\t\ttexto: Type.Optional(Type.String({ description: \"Texto que debe aparecer\" })),\n\t\t\trol: Type.Optional(Type.String({ description: \"Tipo de control, p. ej. button\" })),\n\t\t\tdesaparezca: Type.Optional(Type.Boolean({ description: \"Esperar a que DEJE de estar\" })),\n\t\t\ttimeoutMs: Type.Optional(Type.Number({ description: \"Por defecto 10000, máximo 60000\" })),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst pid = await prepararApp(String(input.app ?? \"\"), \"screenshot\");\n\t\t\t\tconst r = await esperar(pid, {\n\t\t\t\t\ttexto: input.texto ? String(input.texto) : undefined,\n\t\t\t\t\trol: input.rol ? String(input.rol) : undefined,\n\t\t\t\t\tdesaparezca: input.desaparezca === true,\n\t\t\t\t\ttimeoutMs: input.timeoutMs ? Number(input.timeoutMs) : undefined,\n\t\t\t\t});\n\t\t\t\treturn texto(\n\t\t\t\t\tr.encontrado\n\t\t\t\t\t\t? \"Listo: lo que esperabas está. Vuelve a leer con computer_read para actuar.\"\n\t\t\t\t\t\t: `No llegó a pasar (${r.detalle}). No actúes a ciegas: mira con computer_read qué hay.`,\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 textoDe: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_text\",\n\t\tlabel: \"Leer texto\",\n\t\tdescription:\n\t\t\t\"Lee el texto completo de un elemento, por trozos. \" +\n\t\t\t\"Para contenidos largos que computer_read resume o recorta.\",\n\t\tpromptSnippet: \"leer el texto completo de un elemento\",\n\t\tparameters: Type.Object({\n\t\t\tlookId: Type.String(),\n\t\t\tref: Type.String(),\n\t\t\tdesde: Type.Optional(Type.Number()),\n\t\t\tlimite: Type.Optional(Type.Number()),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst r = await leerTexto(obs, String(input.ref ?? \"\"), {\n\t\t\t\t\toffset: input.desde ? Number(input.desde) : 0,\n\t\t\t\t\tlimit: input.limite ? Number(input.limite) : undefined,\n\t\t\t\t});\n\t\t\t\treturn texto(r.hayMas ? `${r.texto}\\n\\n[…quedan ${r.total - r.texto.length} caracteres]` : r.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\treturn {\n\t\tcomputer_apps: listar as ToolDefinition,\n\t\tcomputer_read: leer as ToolDefinition,\n\t\tcomputer_screenshot: captura as ToolDefinition,\n\t\tcomputer_click: pulsar as ToolDefinition,\n\t\tcomputer_type: escribir as ToolDefinition,\n\t\tcomputer_key: tecla as ToolDefinition,\n\t\tcomputer_scroll: desplazar as ToolDefinition,\n\t\tcomputer_wait: aguardar as ToolDefinition,\n\t\tcomputer_text: textoDe as ToolDefinition,\n\t};\n}\n"]}