@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/computer/motor-ada.js

@@ -0,0 +1,412 @@
+/**
+ * Puente entre nuestras tools y el motor forkeado.
+ *
+ * Sustituye al driver anterior, que hablaba por CLI con `open-computer-use`.
+ * Aquel motor tenía seis acciones y le faltaban las dos que importan: esperar a
+ * que algo cambie, y buscar dentro de la interfaz. Sin espera se actúa sobre
+ * ventanas que aún no están listas — el fallo que apareció al probarlo contra
+ * TextEdit, donde la escritura se dio por buena y el fichero quedó vacío.
+ *
+ * El modelo del motor nuevo trae una garantía que antes no teníamos: **para
+ * actuar hace falta el `lookId` de una observación previa**. Nuestra guía "lee
+ * antes de pulsar" deja de ser un consejo en el prompt y pasa a ser un
+ * requisito que el motor impone. Actuar sobre estado viejo ya no compila.
+ *
+ * Aquí NO vive ninguna regla de permisos: eso es `politica.ts`, y lo aplica
+ * `tools.ts` antes de llamar a nada de esto.
+ */
+import { countOutlineNodes, foldToBudget, nodeByRef } from "./motor/outline.js";
+import { currentPlatformBackend } from "./motor/platform/index.js";
+import { macosHelper } from "./motor/platform/macos/helper.js";
+import { scoreWindow } from "./motor/root-selection.js";
+let arrancado = false;
+/**
+ * Arranca el demonio nativo si hace falta.
+ *
+ * Es idempotente y se llama antes de cada operación: el demonio puede haberse
+ * caído entre dos acciones, y descubrirlo con un ENOENT de socket es peor que
+ * volver a levantarlo.
+ */
+export async function asegurarMotor() {
+    if (process.platform !== "darwin")
+        return;
+    if (arrancado)
+        return;
+    await macosHelper.ensureInstalled();
+    await macosHelper.ensureDaemon();
+    arrancado = true;
+}
+export async function listarApps(signal) {
+    await asegurarMotor();
+    const apps = await currentPlatformBackend.listApps(signal);
+    return apps.map((a) => ({
+        nombre: a.appName ?? a.bundleId ?? "(sin nombre)",
+        bundleId: a.bundleId,
+        pid: a.pid,
+    }));
+}
+export async function appEnPrimerPlano(signal) {
+    await asegurarMotor();
+    const f = (await currentPlatformBackend.getFrontmost(signal));
+    return { nombre: f.appName ?? "(desconocida)", bundleId: f.bundleId, pid: f.pid };
+}
+/** Localiza el pid de una aplicación por su nombre. */
+export async function pidDe(nombreApp, signal) {
+    const apps = await listarApps(signal);
+    const buscado = nombreApp.trim().toLowerCase();
+    return apps.find((a) => a.nombre.trim().toLowerCase() === buscado)?.pid;
+}
+/**
+ * Por qué una aplicación viva no enseña ninguna ventana.
+ *
+ * Hay dos motivos y se parecen desde fuera: o de verdad no tiene ventanas, o
+ * macOS nos está negando la Accesibilidad y por eso el árbol llega vacío.
+ *
+ * Distinguirlos no es cosmético. Se descubrió probándolo: con los permisos sin
+ * conceder, `computer_read` sobre TextEdit —que estaba abierto y salía en la
+ * lista de aplicaciones— contestaba "no tiene ninguna ventana abierta". Un
+ * agente que lea eso intentará ABRIR una ventana, que no arregla nada. El error
+ * no solo era inútil: empujaba en la dirección contraria.
+ *
+ * Solo se pregunta al fallar, no en cada observación: el diagnóstico cuesta una
+ * ida y vuelta al helper y el caso normal es que haya ventanas.
+ */
+async function porQueNoHayVentanas(pid, signal) {
+    const sinVentanas = `El proceso ${pid} no tiene ninguna ventana abierta. Puede estar en segundo plano o minimizado.`;
+    if (process.platform !== "darwin")
+        return sinVentanas;
+    try {
+        const d = (await macosHelper.diagnosticsCommand(signal));
+        if (d.accessibility === true)
+            return sinVentanas;
+        return (`macOS está negando el permiso de Accesibilidad, así que no se puede leer la interfaz de ninguna ` +
+            `aplicación (el proceso ${pid} sí está vivo). Concédelo con 'ada-cli computer permissions', o en ` +
+            `Ajustes del Sistema → Privacidad y seguridad → Accesibilidad.`);
+    }
+    catch {
+        // Si ni el diagnóstico contesta, no se inventa un motivo.
+        return sinVentanas;
+    }
+}
+/**
+ * Traduce un fallo de captura a algo accionable.
+ *
+ * Leer una ventana necesita LOS DOS permisos, no solo Accesibilidad: el motor
+ * captura para situar los elementos. Con la Accesibilidad concedida y la
+ * Grabación de pantalla no, macOS devuelve "El usuario ha rechazado las
+ * preferencias de TCC para la captura…" — que dice la causa y ningún remedio, y
+ * además contradice lo que el usuario acaba de hacer (conceder un permiso).
+ *
+ * Se detecta por el texto porque es lo que hay: el error llega como cadena del
+ * sistema, traducida al idioma del Mac. Por eso se buscan las dos palabras que
+ * no cambian de forma —TCC y capture/captura— en vez de una frase entera.
+ */
+function explicarFalloDeCaptura(error) {
+    const mensaje = error instanceof Error ? error.message : String(error);
+    const esTcc = /\bTCC\b/i.test(mensaje) || /captur/i.test(mensaje);
+    if (!esTcc)
+        return mensaje;
+    return (`${mensaje}\n\n` +
+        `Leer una ventana necesita TAMBIÉN el permiso de Grabación de pantalla, no solo el de ` +
+        `Accesibilidad: el motor captura la pantalla para situar los elementos. Ábrelo con ` +
+        `'ada-cli computer permissions' y, después de concederlo, 'ada-cli computer recheck' — ` +
+        `macOS cachea los permisos por proceso y hasta que el motor no se reinicie seguirá creyendo ` +
+        `que no lo tiene.`);
+}
+/**
+ * Observa una ventana y devuelve la observación con la que se puede actuar.
+ *
+ * `readText: "auto"` deja al motor decidir cuánto texto trae: pedir siempre
+ * todo el texto de una ventana grande llena el contexto de ruido, y no pedirlo
+ * nunca obliga a una segunda llamada para cada etiqueta.
+ */
+export async function observar(pid, opciones = {}) {
+    await asegurarMotor();
+    // Hay que resolver la VENTANA primero. Observar por pid a secas falla con
+    // "Root is not owned by a running app": un proceso puede tener cero, una o
+    // diez ventanas, y el motor necesita saber cuál.
+    const raices = await currentPlatformBackend.listRoots({ pid }, opciones.signal);
+    if (raices.length === 0)
+        throw new Error(await porQueNoHayVentanas(pid, opciones.signal));
+    // Estar minimizada se FILTRA, no se puntúa. Es una precondición, no una
+    // preferencia: una ventana minimizada no se puede observar en absoluto.
+    //
+    // Esto no es teórico. `scoreWindow` (del propio motor) da +180 a `isModal`,
+    // más que a todo lo demás junto, y las ventanas de TextEdit se declaran
+    // `AXDialog` → modales. Resultado con TextEdit abierto: una ventana
+    // minimizada ganaba a la única usable, y el motor contestaba "Root is not
+    // owned by a running app" — que no menciona ni ventanas ni minimizado. El
+    // propio `root-selection.ts` avisa de la trampa: "AXDialog can describe a
+    // background main window, so modality alone is insufficient".
+    //
+    // Entre las que SÍ sirven, `scoreWindow` ordena bien: foco, principal, en
+    // pantalla. Ahí sí es preferencia.
+    const usables = raices.filter((r) => !r.isMinimized);
+    const [raiz] = (usables.length > 0 ? usables : raices).sort((a, b) => scoreWindow(b) - scoreWindow(a));
+    if (usables.length === 0) {
+        // Todas minimizadas: es un estado del que el agente PUEDE salir, pero solo
+        // si se lo dicen. El error del motor no lo menciona.
+        const cuales = raices
+            .map((r) => `"${r.title}"`)
+            .slice(0, 5)
+            .join(", ");
+        throw new Error(`Todas las ventanas de este proceso están minimizadas (${cuales}), y una ventana minimizada no se puede leer. ` +
+            `Pídele al usuario que la restaure, o abre la aplicación desde el Dock.`);
+    }
+    let r;
+    try {
+        r = (await currentPlatformBackend.observe({
+            target: { pid, windowId: raiz.windowId },
+            readText: "auto",
+            scopeRef: opciones.scopeRef,
+            includeImage: opciones.conImagen === true,
+        }, { signal: opciones.signal, timeoutMs: opciones.timeoutMs }));
+    }
+    catch (error) {
+        throw new Error(explicarFalloDeCaptura(error));
+    }
+    // `outline` NO es texto: es el árbol, con referencias al padre en cada nodo.
+    // Un `JSON.stringify` revienta con "circular structure" — y solo revienta
+    // cuando hay permisos, porque sin ellos nunca se llega hasta aquí.
+    //
+    // El motor trae su propio renderizador, `foldToBudget`, que además PLIEGA:
+    // una ventana real tiene miles de nodos y volcarlos todos llenaría el
+    // contexto de ruido dejando lo importante enterrado. Se despliega lo que
+    // tiene el foco y lo accionable, se pliega el resto.
+    // `parsedOutline` es el árbol INDEXADO (con el mapa de referencias); `outline`
+    // a secas es solo el nodo raíz, que no basta para plegar. El backend lo rellena
+    // al parsear la respuesta del helper.
+    const arbol = r.parsedOutline;
+    return {
+        lookId: r.lookId ?? "",
+        pid,
+        titulo: raiz.title,
+        resumen: arbol ? foldToBudget(arbol).text : "(el motor no devolvió ningún árbol)",
+        elementos: countOutlineNodes(r.outline),
+        arbol,
+        imagen: r.image ? { datos: r.image.jpegBase64, mimeType: r.image.mimeType ?? "image/jpeg" } : undefined,
+    };
+}
+/**
+ * Actúa sobre una observación.
+ *
+ * Exige el `lookId`: el motor rechaza actuar sobre una observación que ya no
+ * refleja la pantalla. Eso convierte en imposible el fallo de escribir en una
+ * ventana que se cerró en medio.
+ */
+export async function actuar(observacion, accion, opciones = {}) {
+    await asegurarMotor();
+    // Tipado explícito y SIN casts: es la única comprobación automática de que
+    // los nombres de acción que enviamos existen de verdad en el motor. El
+    // `screenshot` fantasma del motor anterior sobrevivió a las pruebas porque
+    // aquella llamada iba por texto libre; aquí un nombre inventado no compila.
+    const construir = (politica) => {
+        // El motor deriva el transporte de la política: en primer plano manda
+        // eventos HID (como un teclado de verdad), en segundo plano los entrega al
+        // proceso. Sin este campo la entrega queda a medias y la escritura se
+        // acepta sin surtir efecto.
+        const delivery = politica === "foreground" ? "hid" : "pid";
+        const base = { lookId: observacion.lookId, pid: observacion.pid, policy: politica };
+        switch (accion.tipo) {
+            case "click":
+                return {
+                    ...base,
+                    target: { ref: accion.ref },
+                    action: "click",
+                    params: { button: accion.boton ?? "left", clickCount: accion.veces ?? 1, delivery },
+                };
+            case "escribir":
+                return {
+                    ...base,
+                    target: { ref: accion.ref },
+                    action: "typeText",
+                    params: { text: accion.texto, delivery },
+                };
+            case "teclas":
+                return {
+                    ...base,
+                    target: accion.ref ? { ref: accion.ref } : { ref: "" },
+                    action: "keypress",
+                    params: { keys: accion.teclas, delivery },
+                };
+            case "desplazar":
+                return {
+                    ...base,
+                    target: { ref: accion.ref },
+                    action: "scroll",
+                    params: { scrollX: accion.x, scrollY: accion.y, delivery },
+                };
+        }
+    };
+    // Escribir tarda proporcionalmente a lo que se escribe. Un timeout fijo corta
+    // los textos largos por la mitad, y medio texto escrito es peor que ninguno.
+    const texto = accion.tipo === "escribir" ? accion.texto : "";
+    const timeoutMs = opciones.timeoutMs ?? Math.max(15_000, texto.length * 25 + 4_000);
+    const ejecutar = (politica) => currentPlatformBackend.act(construir(politica), { signal: opciones.signal, timeoutMs });
+    // Segundo plano PRIMERO. Es la diferencia entre trabajar mientras el usuario
+    // usa su ordenador y robarle la ventana en cada acción.
+    //
+    // Pero el segundo plano falla en aplicaciones que exigen ser la de delante
+    // para aceptar entrada — TextEdit entre ellas: el motor contesta "the
+    // background accessibility value write was accepted but did not take effect".
+    // Entonces se ESCALA a primer plano, que levanta la ventana y manda eventos
+    // HID reales. Solo para escribir y teclas: repetir un clic podría pulsar dos
+    // veces algo que ya funcionó, y esa es la asimetría que el propio motor fija
+    // en `canRetryInForeground`.
+    const puedeEscalar = accion.tipo === "escribir" || accion.tipo === "teclas";
+    try {
+        const primero = await ejecutar("background");
+        if (primero.outcome !== "didnt" || !puedeEscalar)
+            return interpretarResultado(primero);
+        // ANTES de repetir, comprobarlo por nuestra cuenta.
+        //
+        // El motor decide `didnt` mirando su propia evidencia, y con TextEdit esa
+        // evidencia es un FALSO NEGATIVO: dice `valueChanged: false, value: ""`
+        // mientras el texto está escrito y se ve en el árbol. Escalando a ciegas
+        // se escribía DOS VECES — "HOLA'ADAHOLA'ADA" en el documento de prueba.
+        //
+        // Y duplicar es peor que fallar: fallar se ve, duplicar no. Así que la
+        // escalada solo ocurre si el valor del elemento sigue igual que antes. No
+        // se compara con el texto pedido (la aplicación puede transformarlo — la
+        // sustitución tipográfica de TextEdit convierte los guiones en comillas),
+        // sino con el valor previo: cualquier cambio significa que entró.
+        if (await yaSurtioEfecto(observacion, accion, opciones.signal)) {
+            return { ok: true, detalle: "Hecho (el motor no pudo verificarlo, pero el valor cambió)." };
+        }
+        return interpretarResultado(await ejecutar("foreground"));
+    }
+    catch (error) {
+        // El motor pide primer plano explícitamente con este código.
+        const codigo = error?.code;
+        if (codigo === "foreground_required") {
+            try {
+                return interpretarResultado(await ejecutar("foreground"));
+            }
+            catch (segundo) {
+                return { ok: false, detalle: segundo instanceof Error ? segundo.message : String(segundo) };
+            }
+        }
+        return { ok: false, detalle: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Busca un nodo tolerando la arroba.
+ *
+ * En el árbol el ref se guarda como `"@e10"`, pero en el texto que ve el agente
+ * aparece como `@e10` dentro de una línea, y tanto el agente como el motor
+ * aceptan `e10` a secas. Es decir: hay dos formas del mismo identificador
+ * circulando. El motor las normaliza al actuar; `nodeByRef` no, y devolvía
+ * `undefined` en silencio — que en `yaSurtioEfecto` significaba "no lo puedo
+ * comprobar" y disparaba la escalada. De ahí el texto duplicado.
+ */
+function nodoDe(arbol, ref) {
+    const limpio = ref.replace(/^@/, "");
+    return nodeByRef(arbol, ref) ?? nodeByRef(arbol, `@${limpio}`) ?? nodeByRef(arbol, limpio);
+}
+/**
+ * ¿Cambió el valor del elemento, aunque el motor diga que no?
+ *
+ * Se vuelve a observar y se compara el valor del MISMO ref con el que tenía en
+ * la observación de partida. Cualquier diferencia cuenta como éxito: no se
+ * compara con el texto que se pidió escribir porque la aplicación puede
+ * transformarlo al vuelo.
+ *
+ * Ante la duda devuelve `false` — es decir, deja que se escale. Un fallo por
+ * duplicar texto es silencioso; un fallo por no escribir se ve enseguida.
+ */
+async function yaSurtioEfecto(observacion, accion, signal) {
+    if (accion.tipo !== "escribir" || !observacion.arbol || observacion.pid === undefined)
+        return false;
+    const antes = nodoDe(observacion.arbol, accion.ref)?.value;
+    if (antes === undefined)
+        return false;
+    try {
+        const ahora = await observar(observacion.pid, { signal });
+        const despues = ahora.arbol ? nodoDe(ahora.arbol, accion.ref)?.value : undefined;
+        return despues !== undefined && despues !== antes;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Traduce la respuesta del motor a "¿pasó o no pasó?".
+ *
+ * El motor NO responde con un booleano: responde con `outcome`, que tiene tres
+ * valores. Y el tercero es el que importa:
+ *
+ * - `worked`  — lo hizo y lo comprobó.
+ * - `didnt`   — lo intentó y NO surtió efecto. Sin error: el clic salió, la
+ *               interfaz no se movió.
+ * - `unknown` — lo hizo pero no pudo verificarlo.
+ *
+ * Tratar `didnt` como éxito es justo el fallo que motivó cambiar de motor: se
+ * dio por escrito un texto y el fichero quedó vacío. Solo `worked` es un sí.
+ * `unknown` se devuelve como fallo A PROPÓSITO, diciendo que no se pudo
+ * comprobar: es preferible que el agente vuelva a mirar con `computer_read` a
+ * que encadene diez acciones sobre una suposición.
+ *
+ * Es una función aparte, y pura, para poder probar los tres casos sin un
+ * ordenador delante — el motivo por el que el fallo anterior sobrevivió es que
+ * esto vivía dentro de una llamada al sistema que las pruebas nunca alcanzaban.
+ */
+export function interpretarResultado(r) {
+    const cambios = (r.rootDelta ?? [])
+        .map((d) => `${d.change}: ${d.title ?? d.kind}`)
+        .slice(0, 5)
+        .join("; ");
+    if (r.outcome === "worked") {
+        return { ok: true, detalle: cambios ? `Hecho. Cambios en pantalla — ${cambios}` : "Hecho." };
+    }
+    const motivo = r.error?.message ?? r.error?.code;
+    if (r.outcome === "didnt") {
+        return {
+            ok: false,
+            detalle: motivo
+                ? `La acción no surtió efecto: ${motivo}`
+                : "La acción no surtió efecto. El elemento puede estar deshabilitado, tapado o no aceptar esta acción.",
+        };
+    }
+    return {
+        ok: false,
+        detalle: `No se pudo comprobar si la acción surtió efecto${motivo ? `: ${motivo}` : ""}. Vuelve a leer la ventana con computer_read antes de seguir.`,
+    };
+}
+/**
+ * Espera a que algo aparezca (o desaparezca) en una ventana.
+ *
+ * Es la pieza por la que se cambió de motor. Sin ella, la única forma de
+ * "esperar" era dormir un rato fijo y cruzar los dedos: demasiado corto falla,
+ * demasiado largo desperdicia el turno, y ninguno de los dos sabe si lo que
+ * esperabas llegó.
+ */
+export async function esperar(pid, criterio, opciones = {}) {
+    await asegurarMotor();
+    const timeoutMs = Math.min(Math.max(criterio.timeoutMs ?? 10_000, 500), 60_000);
+    try {
+        const r = (await currentPlatformBackend.waitFor({ pid, text: criterio.texto, role: criterio.rol, gone: criterio.desaparezca === true, timeoutMs }, { signal: opciones.signal, timeoutMs: timeoutMs + 5_000 }));
+        return {
+            encontrado: r.found === true,
+            detalle: r.found ? "encontrado" : r.timedOut ? `no apareció en ${timeoutMs} ms` : "no encontrado",
+        };
+    }
+    catch (error) {
+        return { encontrado: false, detalle: error instanceof Error ? error.message : String(error) };
+    }
+}
+/** Lee el texto de un elemento, por trozos. */
+export async function leerTexto(observacion, elementRef, opciones = {}) {
+    await asegurarMotor();
+    const r = await currentPlatformBackend.readText({
+        lookId: observacion.lookId,
+        elementRef,
+        offset: opciones.offset ?? 0,
+        limit: Math.min(opciones.limit ?? 4000, 20_000),
+    }, { signal: opciones.signal });
+    return { texto: r.text, hayMas: r.hasMore, total: r.totalChars };
+}
+export function cerrarMotor() {
+    arrancado = false;
+    void currentPlatformBackend.shutdown?.();
+}
+//# sourceMappingURL=motor-ada.js.map

package/dist/core/computer/motor-ada.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motor-ada.js","sourceRoot":"","sources":["../../../src/core/computer/motor-ada.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Puente entre nuestras tools y el motor forkeado.\n *\n * Sustituye al driver anterior, que hablaba por CLI con `open-computer-use`.\n * Aquel motor tenía seis acciones y le faltaban las dos que importan: esperar a\n * que algo cambie, y buscar dentro de la interfaz. Sin espera se actúa sobre\n * ventanas que aún no están listas — el fallo que apareció al probarlo contra\n * TextEdit, donde la escritura se dio por buena y el fichero quedó vacío.\n *\n * El modelo del motor nuevo trae una garantía que antes no teníamos: **para\n * actuar hace falta el `lookId` de una observación previa**. Nuestra guía \"lee\n * antes de pulsar\" deja de ser un consejo en el prompt y pasa a ser un\n * requisito que el motor impone. Actuar sobre estado viejo ya no compila.\n *\n * Aquí NO vive ninguna regla de permisos: eso es `politica.ts`, y lo aplica\n * `tools.ts` antes de llamar a nada de esto.\n */\n\nimport { countOutlineNodes, foldToBudget, type LookResponse, nodeByRef, type Outline } from \"./motor/outline.ts\";\nimport { currentPlatformBackend } from \"./motor/platform/index.ts\";\nimport { macosHelper } from \"./motor/platform/macos/helper.ts\";\nimport type { HelperActResult, PlatformActRequest } from \"./motor/platform/types.ts\";\nimport { scoreWindow } from \"./motor/root-selection.ts\";\n\n/** Una observación viva. El `lookId` es lo que autoriza a actuar. */\nexport interface Observacion {\n\tlookId: string;\n\tpid?: number;\n\t/** Título de la ventana observada, para que el agente sepa dónde está. */\n\ttitulo?: string;\n\t/** Texto legible del árbol, tal y como lo devuelve el motor. */\n\tresumen: string;\n\telementos: number;\n\t/**\n\t * El árbol indexado. NO se le enseña al agente: es para comprobar por\n\t * nuestra cuenta si una acción surtió efecto, sin fiarnos de lo que diga el\n\t * motor. Ver `actuar`.\n\t */\n\tarbol?: Outline;\n\t/** Captura de la ventana, solo si se pidió `conImagen`. */\n\timagen?: { datos: string; mimeType: string };\n}\n\nlet arrancado = false;\n\n/**\n * Arranca el demonio nativo si hace falta.\n *\n * Es idempotente y se llama antes de cada operación: el demonio puede haberse\n * caído entre dos acciones, y descubrirlo con un ENOENT de socket es peor que\n * volver a levantarlo.\n */\nexport async function asegurarMotor(): Promise<void> {\n\tif (process.platform !== \"darwin\") return;\n\tif (arrancado) return;\n\tawait macosHelper.ensureInstalled();\n\tawait macosHelper.ensureDaemon();\n\tarrancado = true;\n}\n\nexport interface AppAbierta {\n\tnombre: string;\n\tbundleId?: string;\n\tpid?: number;\n}\n\nexport async function listarApps(signal?: AbortSignal): Promise<AppAbierta[]> {\n\tawait asegurarMotor();\n\tconst apps = await currentPlatformBackend.listApps(signal);\n\treturn apps.map((a) => ({\n\t\tnombre: (a as { appName?: string }).appName ?? (a as { bundleId?: string }).bundleId ?? \"(sin nombre)\",\n\t\tbundleId: (a as { bundleId?: string }).bundleId,\n\t\tpid: (a as { pid?: number }).pid,\n\t}));\n}\n\nexport async function appEnPrimerPlano(signal?: AbortSignal): Promise<AppAbierta> {\n\tawait asegurarMotor();\n\tconst f = (await currentPlatformBackend.getFrontmost(signal)) as {\n\t\tappName?: string;\n\t\tbundleId?: string;\n\t\tpid?: number;\n\t};\n\treturn { nombre: f.appName ?? \"(desconocida)\", bundleId: f.bundleId, pid: f.pid };\n}\n\n/** Localiza el pid de una aplicación por su nombre. */\nexport async function pidDe(nombreApp: string, signal?: AbortSignal): Promise<number | undefined> {\n\tconst apps = await listarApps(signal);\n\tconst buscado = nombreApp.trim().toLowerCase();\n\treturn apps.find((a) => a.nombre.trim().toLowerCase() === buscado)?.pid;\n}\n\n/**\n * Por qué una aplicación viva no enseña ninguna ventana.\n *\n * Hay dos motivos y se parecen desde fuera: o de verdad no tiene ventanas, o\n * macOS nos está negando la Accesibilidad y por eso el árbol llega vacío.\n *\n * Distinguirlos no es cosmético. Se descubrió probándolo: con los permisos sin\n * conceder, `computer_read` sobre TextEdit —que estaba abierto y salía en la\n * lista de aplicaciones— contestaba \"no tiene ninguna ventana abierta\". Un\n * agente que lea eso intentará ABRIR una ventana, que no arregla nada. El error\n * no solo era inútil: empujaba en la dirección contraria.\n *\n * Solo se pregunta al fallar, no en cada observación: el diagnóstico cuesta una\n * ida y vuelta al helper y el caso normal es que haya ventanas.\n */\nasync function porQueNoHayVentanas(pid: number, signal?: AbortSignal): Promise<string> {\n\tconst sinVentanas = `El proceso ${pid} no tiene ninguna ventana abierta. Puede estar en segundo plano o minimizado.`;\n\tif (process.platform !== \"darwin\") return sinVentanas;\n\ttry {\n\t\tconst d = (await macosHelper.diagnosticsCommand(signal)) as { accessibility?: boolean };\n\t\tif (d.accessibility === true) return sinVentanas;\n\t\treturn (\n\t\t\t`macOS está negando el permiso de Accesibilidad, así que no se puede leer la interfaz de ninguna ` +\n\t\t\t`aplicación (el proceso ${pid} sí está vivo). Concédelo con 'ada-cli computer permissions', o en ` +\n\t\t\t`Ajustes del Sistema → Privacidad y seguridad → Accesibilidad.`\n\t\t);\n\t} catch {\n\t\t// Si ni el diagnóstico contesta, no se inventa un motivo.\n\t\treturn sinVentanas;\n\t}\n}\n\n/**\n * Traduce un fallo de captura a algo accionable.\n *\n * Leer una ventana necesita LOS DOS permisos, no solo Accesibilidad: el motor\n * captura para situar los elementos. Con la Accesibilidad concedida y la\n * Grabación de pantalla no, macOS devuelve \"El usuario ha rechazado las\n * preferencias de TCC para la captura…\" — que dice la causa y ningún remedio, y\n * además contradice lo que el usuario acaba de hacer (conceder un permiso).\n *\n * Se detecta por el texto porque es lo que hay: el error llega como cadena del\n * sistema, traducida al idioma del Mac. Por eso se buscan las dos palabras que\n * no cambian de forma —TCC y capture/captura— en vez de una frase entera.\n */\nfunction explicarFalloDeCaptura(error: unknown): string {\n\tconst mensaje = error instanceof Error ? error.message : String(error);\n\tconst esTcc = /\\bTCC\\b/i.test(mensaje) || /captur/i.test(mensaje);\n\tif (!esTcc) return mensaje;\n\treturn (\n\t\t`${mensaje}\\n\\n` +\n\t\t`Leer una ventana necesita TAMBIÉN el permiso de Grabación de pantalla, no solo el de ` +\n\t\t`Accesibilidad: el motor captura la pantalla para situar los elementos. Ábrelo con ` +\n\t\t`'ada-cli computer permissions' y, después de concederlo, 'ada-cli computer recheck' — ` +\n\t\t`macOS cachea los permisos por proceso y hasta que el motor no se reinicie seguirá creyendo ` +\n\t\t`que no lo tiene.`\n\t);\n}\n\n/**\n * Observa una ventana y devuelve la observación con la que se puede actuar.\n *\n * `readText: \"auto\"` deja al motor decidir cuánto texto trae: pedir siempre\n * todo el texto de una ventana grande llena el contexto de ruido, y no pedirlo\n * nunca obliga a una segunda llamada para cada etiqueta.\n */\nexport async function observar(\n\tpid: number,\n\topciones: { scopeRef?: string; signal?: AbortSignal; timeoutMs?: number; conImagen?: boolean } = {},\n): Promise<Observacion> {\n\tawait asegurarMotor();\n\n\t// Hay que resolver la VENTANA primero. Observar por pid a secas falla con\n\t// \"Root is not owned by a running app\": un proceso puede tener cero, una o\n\t// diez ventanas, y el motor necesita saber cuál.\n\tconst raices = await currentPlatformBackend.listRoots({ pid }, opciones.signal);\n\tif (raices.length === 0) throw new Error(await porQueNoHayVentanas(pid, opciones.signal));\n\n\t// Estar minimizada se FILTRA, no se puntúa. Es una precondición, no una\n\t// preferencia: una ventana minimizada no se puede observar en absoluto.\n\t//\n\t// Esto no es teórico. `scoreWindow` (del propio motor) da +180 a `isModal`,\n\t// más que a todo lo demás junto, y las ventanas de TextEdit se declaran\n\t// `AXDialog` → modales. Resultado con TextEdit abierto: una ventana\n\t// minimizada ganaba a la única usable, y el motor contestaba \"Root is not\n\t// owned by a running app\" — que no menciona ni ventanas ni minimizado. El\n\t// propio `root-selection.ts` avisa de la trampa: \"AXDialog can describe a\n\t// background main window, so modality alone is insufficient\".\n\t//\n\t// Entre las que SÍ sirven, `scoreWindow` ordena bien: foco, principal, en\n\t// pantalla. Ahí sí es preferencia.\n\tconst usables = raices.filter((r) => !r.isMinimized);\n\tconst [raiz] = (usables.length > 0 ? usables : raices).sort((a, b) => scoreWindow(b) - scoreWindow(a));\n\tif (usables.length === 0) {\n\t\t// Todas minimizadas: es un estado del que el agente PUEDE salir, pero solo\n\t\t// si se lo dicen. El error del motor no lo menciona.\n\t\tconst cuales = raices\n\t\t\t.map((r) => `\"${r.title}\"`)\n\t\t\t.slice(0, 5)\n\t\t\t.join(\", \");\n\t\tthrow new Error(\n\t\t\t`Todas las ventanas de este proceso están minimizadas (${cuales}), y una ventana minimizada no se puede leer. ` +\n\t\t\t\t`Pídele al usuario que la restaure, o abre la aplicación desde el Dock.`,\n\t\t);\n\t}\n\n\tlet r: LookResponse;\n\ttry {\n\t\tr = (await currentPlatformBackend.observe(\n\t\t\t{\n\t\t\t\ttarget: { pid, windowId: raiz.windowId },\n\t\t\t\treadText: \"auto\",\n\t\t\t\tscopeRef: opciones.scopeRef,\n\t\t\t\tincludeImage: opciones.conImagen === true,\n\t\t\t},\n\t\t\t{ signal: opciones.signal, timeoutMs: opciones.timeoutMs },\n\t\t)) as LookResponse;\n\t} catch (error) {\n\t\tthrow new Error(explicarFalloDeCaptura(error));\n\t}\n\n\t// `outline` NO es texto: es el árbol, con referencias al padre en cada nodo.\n\t// Un `JSON.stringify` revienta con \"circular structure\" — y solo revienta\n\t// cuando hay permisos, porque sin ellos nunca se llega hasta aquí.\n\t//\n\t// El motor trae su propio renderizador, `foldToBudget`, que además PLIEGA:\n\t// una ventana real tiene miles de nodos y volcarlos todos llenaría el\n\t// contexto de ruido dejando lo importante enterrado. Se despliega lo que\n\t// tiene el foco y lo accionable, se pliega el resto.\n\t// `parsedOutline` es el árbol INDEXADO (con el mapa de referencias); `outline`\n\t// a secas es solo el nodo raíz, que no basta para plegar. El backend lo rellena\n\t// al parsear la respuesta del helper.\n\tconst arbol = r.parsedOutline;\n\treturn {\n\t\tlookId: r.lookId ?? \"\",\n\t\tpid,\n\t\ttitulo: raiz.title,\n\t\tresumen: arbol ? foldToBudget(arbol).text : \"(el motor no devolvió ningún árbol)\",\n\t\telementos: countOutlineNodes(r.outline),\n\t\tarbol,\n\t\timagen: r.image ? { datos: r.image.jpegBase64, mimeType: r.image.mimeType ?? \"image/jpeg\" } : undefined,\n\t};\n}\n\nexport type AccionMotor =\n\t| { tipo: \"click\"; ref: string; boton?: \"left\" | \"right\" | \"middle\"; veces?: number }\n\t| { tipo: \"escribir\"; ref: string; texto: string }\n\t| { tipo: \"teclas\"; ref?: string; teclas: string[] }\n\t| { tipo: \"desplazar\"; ref: string; x: number; y: number };\n\n/**\n * Actúa sobre una observación.\n *\n * Exige el `lookId`: el motor rechaza actuar sobre una observación que ya no\n * refleja la pantalla. Eso convierte en imposible el fallo de escribir en una\n * ventana que se cerró en medio.\n */\nexport async function actuar(\n\tobservacion: Observacion,\n\taccion: AccionMotor,\n\topciones: { signal?: AbortSignal; timeoutMs?: number } = {},\n): Promise<{ ok: boolean; detalle: string }> {\n\tawait asegurarMotor();\n\n\t// Tipado explícito y SIN casts: es la única comprobación automática de que\n\t// los nombres de acción que enviamos existen de verdad en el motor. El\n\t// `screenshot` fantasma del motor anterior sobrevivió a las pruebas porque\n\t// aquella llamada iba por texto libre; aquí un nombre inventado no compila.\n\tconst construir = (politica: \"background\" | \"foreground\"): PlatformActRequest => {\n\t\t// El motor deriva el transporte de la política: en primer plano manda\n\t\t// eventos HID (como un teclado de verdad), en segundo plano los entrega al\n\t\t// proceso. Sin este campo la entrega queda a medias y la escritura se\n\t\t// acepta sin surtir efecto.\n\t\tconst delivery = politica === \"foreground\" ? (\"hid\" as const) : (\"pid\" as const);\n\t\tconst base = { lookId: observacion.lookId, pid: observacion.pid, policy: politica };\n\t\tswitch (accion.tipo) {\n\t\t\tcase \"click\":\n\t\t\t\treturn {\n\t\t\t\t\t...base,\n\t\t\t\t\ttarget: { ref: accion.ref },\n\t\t\t\t\taction: \"click\" as const,\n\t\t\t\t\tparams: { button: accion.boton ?? \"left\", clickCount: accion.veces ?? 1, delivery },\n\t\t\t\t};\n\t\t\tcase \"escribir\":\n\t\t\t\treturn {\n\t\t\t\t\t...base,\n\t\t\t\t\ttarget: { ref: accion.ref },\n\t\t\t\t\taction: \"typeText\" as const,\n\t\t\t\t\tparams: { text: accion.texto, delivery },\n\t\t\t\t};\n\t\t\tcase \"teclas\":\n\t\t\t\treturn {\n\t\t\t\t\t...base,\n\t\t\t\t\ttarget: accion.ref ? { ref: accion.ref } : { ref: \"\" },\n\t\t\t\t\taction: \"keypress\" as const,\n\t\t\t\t\tparams: { keys: accion.teclas, delivery },\n\t\t\t\t};\n\t\t\tcase \"desplazar\":\n\t\t\t\treturn {\n\t\t\t\t\t...base,\n\t\t\t\t\ttarget: { ref: accion.ref },\n\t\t\t\t\taction: \"scroll\" as const,\n\t\t\t\t\tparams: { scrollX: accion.x, scrollY: accion.y, delivery },\n\t\t\t\t};\n\t\t}\n\t};\n\n\t// Escribir tarda proporcionalmente a lo que se escribe. Un timeout fijo corta\n\t// los textos largos por la mitad, y medio texto escrito es peor que ninguno.\n\tconst texto = accion.tipo === \"escribir\" ? accion.texto : \"\";\n\tconst timeoutMs = opciones.timeoutMs ?? Math.max(15_000, texto.length * 25 + 4_000);\n\tconst ejecutar = (politica: \"background\" | \"foreground\") =>\n\t\tcurrentPlatformBackend.act(construir(politica), { signal: opciones.signal, timeoutMs });\n\n\t// Segundo plano PRIMERO. Es la diferencia entre trabajar mientras el usuario\n\t// usa su ordenador y robarle la ventana en cada acción.\n\t//\n\t// Pero el segundo plano falla en aplicaciones que exigen ser la de delante\n\t// para aceptar entrada — TextEdit entre ellas: el motor contesta \"the\n\t// background accessibility value write was accepted but did not take effect\".\n\t// Entonces se ESCALA a primer plano, que levanta la ventana y manda eventos\n\t// HID reales. Solo para escribir y teclas: repetir un clic podría pulsar dos\n\t// veces algo que ya funcionó, y esa es la asimetría que el propio motor fija\n\t// en `canRetryInForeground`.\n\tconst puedeEscalar = accion.tipo === \"escribir\" || accion.tipo === \"teclas\";\n\ttry {\n\t\tconst primero = await ejecutar(\"background\");\n\t\tif (primero.outcome !== \"didnt\" || !puedeEscalar) return interpretarResultado(primero);\n\n\t\t// ANTES de repetir, comprobarlo por nuestra cuenta.\n\t\t//\n\t\t// El motor decide `didnt` mirando su propia evidencia, y con TextEdit esa\n\t\t// evidencia es un FALSO NEGATIVO: dice `valueChanged: false, value: \"\"`\n\t\t// mientras el texto está escrito y se ve en el árbol. Escalando a ciegas\n\t\t// se escribía DOS VECES — \"HOLA'ADAHOLA'ADA\" en el documento de prueba.\n\t\t//\n\t\t// Y duplicar es peor que fallar: fallar se ve, duplicar no. Así que la\n\t\t// escalada solo ocurre si el valor del elemento sigue igual que antes. No\n\t\t// se compara con el texto pedido (la aplicación puede transformarlo — la\n\t\t// sustitución tipográfica de TextEdit convierte los guiones en comillas),\n\t\t// sino con el valor previo: cualquier cambio significa que entró.\n\t\tif (await yaSurtioEfecto(observacion, accion, opciones.signal)) {\n\t\t\treturn { ok: true, detalle: \"Hecho (el motor no pudo verificarlo, pero el valor cambió).\" };\n\t\t}\n\t\treturn interpretarResultado(await ejecutar(\"foreground\"));\n\t} catch (error) {\n\t\t// El motor pide primer plano explícitamente con este código.\n\t\tconst codigo = (error as { code?: string })?.code;\n\t\tif (codigo === \"foreground_required\") {\n\t\t\ttry {\n\t\t\t\treturn interpretarResultado(await ejecutar(\"foreground\"));\n\t\t\t} catch (segundo) {\n\t\t\t\treturn { ok: false, detalle: segundo instanceof Error ? segundo.message : String(segundo) };\n\t\t\t}\n\t\t}\n\t\treturn { ok: false, detalle: error instanceof Error ? error.message : String(error) };\n\t}\n}\n\n/**\n * Busca un nodo tolerando la arroba.\n *\n * En el árbol el ref se guarda como `\"@e10\"`, pero en el texto que ve el agente\n * aparece como `@e10` dentro de una línea, y tanto el agente como el motor\n * aceptan `e10` a secas. Es decir: hay dos formas del mismo identificador\n * circulando. El motor las normaliza al actuar; `nodeByRef` no, y devolvía\n * `undefined` en silencio — que en `yaSurtioEfecto` significaba \"no lo puedo\n * comprobar\" y disparaba la escalada. De ahí el texto duplicado.\n */\nfunction nodoDe(arbol: Outline, ref: string) {\n\tconst limpio = ref.replace(/^@/, \"\");\n\treturn nodeByRef(arbol, ref) ?? nodeByRef(arbol, `@${limpio}`) ?? nodeByRef(arbol, limpio);\n}\n\n/**\n * ¿Cambió el valor del elemento, aunque el motor diga que no?\n *\n * Se vuelve a observar y se compara el valor del MISMO ref con el que tenía en\n * la observación de partida. Cualquier diferencia cuenta como éxito: no se\n * compara con el texto que se pidió escribir porque la aplicación puede\n * transformarlo al vuelo.\n *\n * Ante la duda devuelve `false` — es decir, deja que se escale. Un fallo por\n * duplicar texto es silencioso; un fallo por no escribir se ve enseguida.\n */\nasync function yaSurtioEfecto(observacion: Observacion, accion: AccionMotor, signal?: AbortSignal): Promise<boolean> {\n\tif (accion.tipo !== \"escribir\" || !observacion.arbol || observacion.pid === undefined) return false;\n\tconst antes = nodoDe(observacion.arbol, accion.ref)?.value;\n\tif (antes === undefined) return false;\n\ttry {\n\t\tconst ahora = await observar(observacion.pid, { signal });\n\t\tconst despues = ahora.arbol ? nodoDe(ahora.arbol, accion.ref)?.value : undefined;\n\t\treturn despues !== undefined && despues !== antes;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Traduce la respuesta del motor a \"¿pasó o no pasó?\".\n *\n * El motor NO responde con un booleano: responde con `outcome`, que tiene tres\n * valores. Y el tercero es el que importa:\n *\n * - `worked`  — lo hizo y lo comprobó.\n * - `didnt`   — lo intentó y NO surtió efecto. Sin error: el clic salió, la\n *               interfaz no se movió.\n * - `unknown` — lo hizo pero no pudo verificarlo.\n *\n * Tratar `didnt` como éxito es justo el fallo que motivó cambiar de motor: se\n * dio por escrito un texto y el fichero quedó vacío. Solo `worked` es un sí.\n * `unknown` se devuelve como fallo A PROPÓSITO, diciendo que no se pudo\n * comprobar: es preferible que el agente vuelva a mirar con `computer_read` a\n * que encadene diez acciones sobre una suposición.\n *\n * Es una función aparte, y pura, para poder probar los tres casos sin un\n * ordenador delante — el motivo por el que el fallo anterior sobrevivió es que\n * esto vivía dentro de una llamada al sistema que las pruebas nunca alcanzaban.\n */\nexport function interpretarResultado(r: HelperActResult): { ok: boolean; detalle: string } {\n\tconst cambios = (r.rootDelta ?? [])\n\t\t.map((d) => `${d.change}: ${d.title ?? d.kind}`)\n\t\t.slice(0, 5)\n\t\t.join(\"; \");\n\n\tif (r.outcome === \"worked\") {\n\t\treturn { ok: true, detalle: cambios ? `Hecho. Cambios en pantalla — ${cambios}` : \"Hecho.\" };\n\t}\n\n\tconst motivo = r.error?.message ?? r.error?.code;\n\tif (r.outcome === \"didnt\") {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tdetalle: motivo\n\t\t\t\t? `La acción no surtió efecto: ${motivo}`\n\t\t\t\t: \"La acción no surtió efecto. El elemento puede estar deshabilitado, tapado o no aceptar esta acción.\",\n\t\t};\n\t}\n\n\treturn {\n\t\tok: false,\n\t\tdetalle: `No se pudo comprobar si la acción surtió efecto${motivo ? `: ${motivo}` : \"\"}. Vuelve a leer la ventana con computer_read antes de seguir.`,\n\t};\n}\n\n/**\n * Espera a que algo aparezca (o desaparezca) en una ventana.\n *\n * Es la pieza por la que se cambió de motor. Sin ella, la única forma de\n * \"esperar\" era dormir un rato fijo y cruzar los dedos: demasiado corto falla,\n * demasiado largo desperdicia el turno, y ninguno de los dos sabe si lo que\n * esperabas llegó.\n */\nexport async function esperar(\n\tpid: number,\n\tcriterio: { texto?: string; rol?: string; desaparezca?: boolean; timeoutMs?: number },\n\topciones: { signal?: AbortSignal } = {},\n): Promise<{ encontrado: boolean; detalle: string }> {\n\tawait asegurarMotor();\n\tconst timeoutMs = Math.min(Math.max(criterio.timeoutMs ?? 10_000, 500), 60_000);\n\ttry {\n\t\tconst r = (await currentPlatformBackend.waitFor(\n\t\t\t{ pid, text: criterio.texto, role: criterio.rol, gone: criterio.desaparezca === true, timeoutMs },\n\t\t\t{ signal: opciones.signal, timeoutMs: timeoutMs + 5_000 },\n\t\t)) as { found?: boolean; timedOut?: boolean };\n\t\treturn {\n\t\t\tencontrado: r.found === true,\n\t\t\tdetalle: r.found ? \"encontrado\" : r.timedOut ? `no apareció en ${timeoutMs} ms` : \"no encontrado\",\n\t\t};\n\t} catch (error) {\n\t\treturn { encontrado: false, detalle: error instanceof Error ? error.message : String(error) };\n\t}\n}\n\n/** Lee el texto de un elemento, por trozos. */\nexport async function leerTexto(\n\tobservacion: Observacion,\n\telementRef: string,\n\topciones: { offset?: number; limit?: number; signal?: AbortSignal } = {},\n): Promise<{ texto: string; hayMas: boolean; total: number }> {\n\tawait asegurarMotor();\n\tconst r = await currentPlatformBackend.readText(\n\t\t{\n\t\t\tlookId: observacion.lookId,\n\t\t\telementRef,\n\t\t\toffset: opciones.offset ?? 0,\n\t\t\tlimit: Math.min(opciones.limit ?? 4000, 20_000),\n\t\t},\n\t\t{ signal: opciones.signal },\n\t);\n\treturn { texto: r.text, hayMas: r.hasMore, total: r.totalChars };\n}\n\nexport function cerrarMotor(): void {\n\tarrancado = false;\n\tvoid currentPlatformBackend.shutdown?.();\n}\n"]}

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

@@ -0,0 +1,56 @@
+/**
+ * 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.
+ */
+/** Qué puede hacer el agente sobre una aplicación concreta. */
+export type Nivel = "read" | "click" | "full";
+export declare function esAppProhibida(nombreApp: string): boolean;
+export declare class AppProhibidaError extends Error {
+    constructor(app: string);
+}
+/** Nivel máximo que se puede conceder a una aplicación, por su categoría. */
+export declare function techoDeCategoria(nombreApp: string): Nivel;
+/** El menor de dos niveles. Conceder nunca amplía por encima del techo. */
+export declare function menorNivel(a: Nivel, b: Nivel): Nivel;
+/** Acciones que el agente puede pedir, ordenadas por lo que exigen. */
+export type Accion = "screenshot" | "cursor_position" | "mouse_move" | "scroll" | "left_click" | "double_click" | "triple_click" | "middle_click" | "right_click" | "left_click_drag" | "type" | "key" | "hold_key";
+export declare class AccionNoPermitidaError extends Error {
+    constructor(accion: Accion, app: string, nivel: Nivel);
+}
+/**
+ * ¿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 declare function exigirPermiso(accion: Accion, app: string): void;
+export declare function pareceCredencial(texto: string): boolean;
+export declare class CredencialError extends Error {
+    constructor();
+}
+export declare function teclaPeligrosa(combinacion: string): boolean;
+//# sourceMappingURL=politica.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"politica.d.ts","sourceRoot":"","sources":["../../../src/core/computer/politica.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,iEAA+D;AAC/D,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAyB9C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,YAAY,GAAG,EAAE,MAAM,EAMtB;CACD;AAMD,gFAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAKzD;AAID,4EAA2E;AAC3E,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED,uEAAuE;AACvE,MAAM,MAAM,MAAM,GACf,YAAY,GACZ,iBAAiB,GACjB,YAAY,GACZ,QAAQ,GACR,YAAY,GACZ,cAAc,GACd,cAAc,GACd,cAAc,GACd,aAAa,GACb,iBAAiB,GACjB,MAAM,GACN,KAAK,GACL,UAAU,CAAC;AAwBd,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,YAAY,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAWpD;CACD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAK/D;AAuBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACzC,cAMC;CACD;AAWD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3D","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"]}