@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/computer/motor-ada.d.ts

@@ -0,0 +1,159 @@
+/**
+ * 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 { type Outline } from "./motor/outline.ts";
+import type { HelperActResult } from "./motor/platform/types.ts";
+/** Una observación viva. El `lookId` es lo que autoriza a actuar. */
+export interface Observacion {
+    lookId: string;
+    pid?: number;
+    /** Título de la ventana observada, para que el agente sepa dónde está. */
+    titulo?: string;
+    /** Texto legible del árbol, tal y como lo devuelve el motor. */
+    resumen: string;
+    elementos: number;
+    /**
+     * El árbol indexado. NO se le enseña al agente: es para comprobar por
+     * nuestra cuenta si una acción surtió efecto, sin fiarnos de lo que diga el
+     * motor. Ver `actuar`.
+     */
+    arbol?: Outline;
+    /** Captura de la ventana, solo si se pidió `conImagen`. */
+    imagen?: {
+        datos: string;
+        mimeType: string;
+    };
+}
+/**
+ * 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 declare function asegurarMotor(): Promise<void>;
+export interface AppAbierta {
+    nombre: string;
+    bundleId?: string;
+    pid?: number;
+}
+export declare function listarApps(signal?: AbortSignal): Promise<AppAbierta[]>;
+export declare function appEnPrimerPlano(signal?: AbortSignal): Promise<AppAbierta>;
+/** Localiza el pid de una aplicación por su nombre. */
+export declare function pidDe(nombreApp: string, signal?: AbortSignal): Promise<number | undefined>;
+/**
+ * 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 declare function observar(pid: number, opciones?: {
+    scopeRef?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    conImagen?: boolean;
+}): Promise<Observacion>;
+export type AccionMotor = {
+    tipo: "click";
+    ref: string;
+    boton?: "left" | "right" | "middle";
+    veces?: number;
+} | {
+    tipo: "escribir";
+    ref: string;
+    texto: string;
+} | {
+    tipo: "teclas";
+    ref?: string;
+    teclas: string[];
+} | {
+    tipo: "desplazar";
+    ref: string;
+    x: number;
+    y: number;
+};
+/**
+ * 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 declare function actuar(observacion: Observacion, accion: AccionMotor, opciones?: {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<{
+    ok: boolean;
+    detalle: string;
+}>;
+/**
+ * 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 declare function interpretarResultado(r: HelperActResult): {
+    ok: boolean;
+    detalle: string;
+};
+/**
+ * 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 declare function esperar(pid: number, criterio: {
+    texto?: string;
+    rol?: string;
+    desaparezca?: boolean;
+    timeoutMs?: number;
+}, opciones?: {
+    signal?: AbortSignal;
+}): Promise<{
+    encontrado: boolean;
+    detalle: string;
+}>;
+/** Lee el texto de un elemento, por trozos. */
+export declare function leerTexto(observacion: Observacion, elementRef: string, opciones?: {
+    offset?: number;
+    limit?: number;
+    signal?: AbortSignal;
+}): Promise<{
+    texto: string;
+    hayMas: boolean;
+    total: number;
+}>;
+export declare function cerrarMotor(): void;
+//# sourceMappingURL=motor-ada.d.ts.map

package/dist/core/computer/motor-ada.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motor-ada.d.ts","sourceRoot":"","sources":["../../../src/core/computer/motor-ada.ts"],"names":[],"mappings":"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"}

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":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAqB,SAAS,EAAgB,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAqBxD,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IAClC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO;IAC1C,IAAI,SAAS;QAAE,OAAO;IACtB,MAAM,WAAW,CAAC,eAAe,EAAE,CAAC;IACpC,MAAM,WAAW,CAAC,YAAY,EAAE,CAAC;IACjC,SAAS,GAAG,IAAI,CAAC;AAClB,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAoB;IACpD,MAAM,aAAa,EAAE,CAAC;IACtB,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvB,MAAM,EAAG,CAA0B,CAAC,OAAO,IAAK,CAA2B,CAAC,QAAQ,IAAI,cAAc;QACtG,QAAQ,EAAG,CAA2B,CAAC,QAAQ;QAC/C,GAAG,EAAG,CAAsB,CAAC,GAAG;KAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAoB;IAC1D,MAAM,aAAa,EAAE,CAAC;IACtB,MAAM,CAAC,GAAG,CAAC,MAAM,sBAAsB,CAAC,YAAY,CAAC,MAAM,CAAC,CAI3D,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,IAAI,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;AACnF,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,SAAiB,EAAE,MAAoB;IAClE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,EAAE,GAAG,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,KAAK,UAAU,mBAAmB,CAAC,GAAW,EAAE,MAAoB;IACnE,MAAM,WAAW,GAAG,cAAc,GAAG,+EAA+E,CAAC;IACrH,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC;IACtD,IAAI,CAAC;QACJ,MAAM,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAgC,CAAC;QACxF,IAAI,CAAC,CAAC,aAAa,KAAK,IAAI;YAAE,OAAO,WAAW,CAAC;QACjD,OAAO,CACN,kGAAkG;YAClG,0BAA0B,GAAG,qEAAqE;YAClG,+DAA+D,CAC/D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,0DAA0D;QAC1D,OAAO,WAAW,CAAC;IACpB,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,sBAAsB,CAAC,KAAc;IAC7C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC3B,OAAO,CACN,GAAG,OAAO,MAAM;QAChB,uFAAuF;QACvF,oFAAoF;QACpF,wFAAwF;QACxF,6FAA6F;QAC7F,kBAAkB,CAClB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC7B,GAAW,EACX,WAAiG,EAAE;IAEnG,MAAM,aAAa,EAAE,CAAC;IAEtB,0EAA0E;IAC1E,2EAA2E;IAC3E,iDAAiD;IACjD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,mBAAmB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1F,wEAAwE;IACxE,wEAAwE;IACxE,EAAE;IACF,4EAA4E;IAC5E,wEAAwE;IACxE,oEAAoE;IACpE,0EAA0E;IAC1E,0EAA0E;IAC1E,0EAA0E;IAC1E,8DAA8D;IAC9D,EAAE;IACF,0EAA0E;IAC1E,mCAAmC;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACvG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,2EAA2E;QAC3E,qDAAqD;QACrD,MAAM,MAAM,GAAG,MAAM;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC;aAC1B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,IAAI,KAAK,CACd,yDAAyD,MAAM,gDAAgD;YAC9G,wEAAwE,CACzE,CAAC;IACH,CAAC;IAED,IAAI,CAAe,CAAC;IACpB,IAAI,CAAC;QACJ,CAAC,GAAG,CAAC,MAAM,sBAAsB,CAAC,OAAO,CACxC;YACC,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;YACxC,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,YAAY,EAAE,QAAQ,CAAC,SAAS,KAAK,IAAI;SACzC,EACD,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAC1D,CAAiB,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,6EAA6E;IAC7E,0EAA0E;IAC1E,mEAAmE;IACnE,EAAE;IACF,2EAA2E;IAC3E,sEAAsE;IACtE,yEAAyE;IACzE,qDAAqD;IACrD,+EAA+E;IAC/E,gFAAgF;IAChF,sCAAsC;IACtC,MAAM,KAAK,GAAG,CAAC,CAAC,aAAa,CAAC;IAC9B,OAAO;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;QACtB,GAAG;QACH,MAAM,EAAE,IAAI,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,qCAAqC;QACjF,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC;QACvC,KAAK;QACL,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS;KACvG,CAAC;AACH,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC3B,WAAwB,EACxB,MAAmB,EACnB,WAAyD,EAAE;IAE3D,MAAM,aAAa,EAAE,CAAC;IAEtB,2EAA2E;IAC3E,uEAAuE;IACvE,2EAA2E;IAC3E,4EAA4E;IAC5E,MAAM,SAAS,GAAG,CAAC,QAAqC,EAAsB,EAAE;QAC/E,sEAAsE;QACtE,2EAA2E;QAC3E,sEAAsE;QACtE,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAE,KAAe,CAAC,CAAC,CAAE,KAAe,CAAC;QACjF,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACpF,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,OAAO;gBACX,OAAO;oBACN,GAAG,IAAI;oBACP,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;oBAC3B,MAAM,EAAE,OAAgB;oBACxB,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,EAAE,QAAQ,EAAE;iBACnF,CAAC;YACH,KAAK,UAAU;gBACd,OAAO;oBACN,GAAG,IAAI;oBACP,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;oBAC3B,MAAM,EAAE,UAAmB;oBAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE;iBACxC,CAAC;YACH,KAAK,QAAQ;gBACZ,OAAO;oBACN,GAAG,IAAI;oBACP,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;oBACtD,MAAM,EAAE,UAAmB;oBAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE;iBACzC,CAAC;YACH,KAAK,WAAW;gBACf,OAAO;oBACN,GAAG,IAAI;oBACP,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;oBAC3B,MAAM,EAAE,QAAiB;oBACzB,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE;iBAC1D,CAAC;QACJ,CAAC;IACF,CAAC,CAAC;IAEF,8EAA8E;IAC9E,6EAA6E;IAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,CAAC,QAAqC,EAAE,EAAE,CAC1D,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAEzF,6EAA6E;IAC7E,wDAAwD;IACxD,EAAE;IACF,2EAA2E;IAC3E,sEAAsE;IACtE,8EAA8E;IAC9E,4EAA4E;IAC5E,6EAA6E;IAC7E,6EAA6E;IAC7E,6BAA6B;IAC7B,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC5E,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,YAAY;YAAE,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAEvF,oDAAoD;QACpD,EAAE;QACF,0EAA0E;QAC1E,wEAAwE;QACxE,yEAAyE;QACzE,wEAAwE;QACxE,EAAE;QACF,uEAAuE;QACvE,0EAA0E;QAC1E,yEAAyE;QACzE,0EAA0E;QAC1E,kEAAkE;QAClE,IAAI,MAAM,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAChE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC;QAC7F,CAAC;QACD,OAAO,oBAAoB,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,6DAA6D;QAC7D,MAAM,MAAM,GAAI,KAA2B,EAAE,IAAI,CAAC;QAClD,IAAI,MAAM,KAAK,qBAAqB,EAAE,CAAC;YACtC,IAAI,CAAC;gBACJ,OAAO,oBAAoB,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;YAC3D,CAAC;YAAC,OAAO,OAAO,EAAE,CAAC;gBAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7F,CAAC;QACF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACvF,CAAC;AACF,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,MAAM,CAAC,KAAc,EAAE,GAAW;IAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrC,OAAO,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC5F,CAAC;AAED;;;;;;;;;;GAUG;AACH,KAAK,UAAU,cAAc,CAAC,WAAwB,EAAE,MAAmB,EAAE,MAAoB;IAChG,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACpG,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACjF,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAAC,CAAkB;IACtD,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;SAC/C,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9F,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC;IACjD,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO;YACN,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,MAAM;gBACd,CAAC,CAAC,+BAA+B,MAAM,EAAE;gBACzC,CAAC,CAAC,qGAAqG;SACxG,CAAC;IACH,CAAC;IAED,OAAO;QACN,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,kDAAkD,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,+DAA+D;KACrJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC5B,GAAW,EACX,QAAqF,EACrF,WAAqC,EAAE;IAEvC,MAAM,aAAa,EAAE,CAAC;IACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,IAAI,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAChF,IAAI,CAAC;QACJ,MAAM,CAAC,GAAG,CAAC,MAAM,sBAAsB,CAAC,OAAO,CAC9C,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,KAAK,IAAI,EAAE,SAAS,EAAE,EACjG,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,KAAK,EAAE,CACzD,CAA4C,CAAC;QAC9C,OAAO;YACN,UAAU,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI;YAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,SAAS,KAAK,CAAC,CAAC,CAAC,eAAe;SACjG,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/F,CAAC;AACF,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,SAAS,CAC9B,WAAwB,EACxB,UAAkB,EAClB,WAAsE,EAAE;IAExE,MAAM,aAAa,EAAE,CAAC;IACtB,MAAM,CAAC,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAC9C;QACC,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,UAAU;QACV,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,CAAC;QAC5B,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,EAAE,MAAM,CAAC;KAC/C,EACD,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAC3B,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW;IAC1B,SAAS,GAAG,KAAK,CAAC;IAClB,KAAK,sBAAsB,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC1C,CAAC"}

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,+DAA+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;gBAC/B,GAAG,EAAE,MAAM;CAOvB;AAMD,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAKzD;AAID,2EAA2E;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;gBACpC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAYrD;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;;CAQzC;AAWD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3D"}