xonecode 0.3.0 → 0.5.1

package/dist/agent/perfiles.js

@@ -1,37 +1,17 @@
+/**
+ * Los PERMISOS de un especialista, con tools de FICHERO (la v1 no usa MCP).
+ *
+ * Este fichero ya no tiene la lista de especialistas: los cuatro que vivían aquí a fuego
+ * son ahora ficheros `.md` (`core/agentes.ts`, `agent/agentesEnDisco.ts`), sembrados la
+ * primera vez y editables por el usuario. Lo que se queda es lo que NO puede salir de un
+ * fichero: qué se le deniega a todo el mundo, qué tools le tocan a quien escribe y cómo se
+ * monta su aprobación humana. Un `.md` puede cambiar el prompt de un agente; no puede
+ * concederle leer `/.env`.
+ */
+import { artefactoFueraDeSitio } from "../core/artefactos.js";
 /** Las tools de fichero que monta deepagents sobre el backend. */
 export const TOOLS_LECTURA = ["ls", "read_file", "glob", "grep"];
 export const TOOLS_ESCRITURA = ["write_file", "edit_file"];
-export const PERFILES = {
-    docs: {
-        nombre: "docs",
-        descripcion: "Responde preguntas técnicas de la plataforma XOne (XML/.xne, JavaScript, CSS, " +
-            "eventos, patrones). Puede leer el proyecto para no contradecir el código real. " +
-            "No modifica nada.",
-        soloLectura: true,
-        skills: ["xone-development"],
-    },
-    planner: {
-        nombre: "planner",
-        descripcion: "Inspecciona el proyecto real para anclar planes y diagnósticos: estructura, " +
-            "colecciones y búsqueda de código. No modifica nada.",
-        soloLectura: true,
-        skills: ["xone-spec-builder", "xone-plan-builder"],
-    },
-    dev: {
-        nombre: "dev",
-        descripcion: "Desarrolla: crea y modifica colecciones, escribe scripts y edita ficheros. " +
-            "Las modificaciones requieren aprobación humana.",
-        soloLectura: false,
-        skills: ["xone-development", "xone-debugging"],
-    },
-    mockup: {
-        nombre: "mockup",
-        descripcion: "Trabajo visual: layouts, CSS y recursos. Las modificaciones requieren " +
-            "aprobación humana.",
-        soloLectura: false,
-        skills: ["xone-development"],
-    },
-};
 /** Lo que estructuralmente da igual quién seas: nunca se lee ni se escribe. */
 export const DENEGADO_SIEMPRE = [
     {
@@ -39,6 +19,28 @@ export const DENEGADO_SIEMPRE = [
         paths: ["/.env", "/.env.*", "/.git", "/.git/**", "/.xonecode", "/.xonecode/**"],
         mode: "deny",
     },
+    // Las skills son instrucciones del harness, nunca ficheros que el agente pueda alterar.
+    { operations: ["write"], paths: ["/skills", "/skills/**"], mode: "deny" },
+    /**
+     * Los ADJUNTOS de una tarea (`core/adjuntos.ts`), de solo lectura por lo mismo que las
+     * skills: son material de ENTRADA —los documentos que anexó la persona que creó la
+     * tarea—, no ficheros que reescribir. Leerlos es justamente su razón de ser, así que la
+     * denegación es solo de `write`.
+     *
+     * **Y es incondicional, no «solo si están montados».** Medido contra deepagents 1.13.2:
+     * sin esta fila, un `write_file` a `/adjuntos/x.txt` en una consola donde la carpeta NO
+     * está montada escribe `<raiz>/adjuntos/x.txt` — o sea un fichero del proyecto, con un
+     * nombre que la interfaz presenta como «lo que te adjuntaron». Con la fila puesta, las dos
+     * situaciones contestan «permission denied» y el disco no se toca (también medido).
+     *
+     * Esta lista alcanza también al ORQUESTADOR desde el 9-09-2026, y antes no: su
+     * `createFilesystemMiddleware` se montaba sin `permissions`, así que las tres denegaciones
+     * de aquí eran decorativas para él y su `write_file` contestaba «Successfully wrote» a
+     * `/adjuntos/pwn.txt`, a `/skills/pwn.txt` y a `/.env`. Hoy recibe
+     * `permisosDe(PERFIL_DEL_ORQUESTADOR)`, que es de solo lectura; lo mide
+     * `xoneAgent.orquestador.test.ts`.
+     */
+    { operations: ["write"], paths: ["/adjuntos", "/adjuntos/**"], mode: "deny" },
 ];
 /**
  * Los permisos de un perfil. **Nunca los escribas a mano.**
@@ -52,8 +54,36 @@ export function permisosDe(perfil) {
     const base = [...DENEGADO_SIEMPRE];
     if (!perfil.soloLectura)
         return base;
+    // OJO para cuando el `xone-device-tester` sepa hablar con el móvil: este `/**` también deniega
+    // `/artefactos/**`, así que un agente de SOLO LECTURA no puede dejar una captura. Hoy no
+    // hay ningún productor de solo lectura, así que no se abre un hueco por si acaso — pero
+    // el día que lo haya, la excepción va aquí y antes hay que medir el orden de reglas de
+    // deepagents (¿gana la primera que casa, o gana la denegación?), porque de eso depende que
+    // un `allow` sobre `/artefactos/**` haga algo o sea decorativo.
     return [...base, { operations: ["write"], paths: ["/**"], mode: "deny" }];
 }
+/**
+ * Barrera de lectura para tools propias.
+ *
+ * `FilesystemMiddleware` aplica `permisosDe()` a sus seis herramientas, pero
+ * una tool de LangChain añadida por xonecode no pasa por ese middleware. Las
+ * rutas protegidas se concentran aquí para que esas tools no abran por accidente
+ * `.env`, `.git` ni la carpeta interna del proyecto.
+ */
+export function puedeLeerRuta(ruta) {
+    return !(ruta === "/.env" ||
+        ruta.startsWith("/.env.") ||
+        // También `.env` como CARPETA (`/.env/algo`), que no es lo mismo que `/.env.algo` y se
+        // caía por el hueco entre los dos: el punto y la barra son caracteres distintos. Salió de
+        // atar esta función con `DENEGADO_SIEMPRE` en `escrituraExterna.test.ts`. Raro, sí — pero
+        // de esta función depende también que `busquedaRegex` no lea ahí dentro, y denegar una
+        // carpeta que nadie tiene no cuesta nada.
+        ruta.startsWith("/.env/") ||
+        ruta === "/.git" ||
+        ruta.startsWith("/.git/") ||
+        ruta === "/.xonecode" ||
+        ruta.startsWith("/.xonecode/"));
+}
 /**
  * Las tools de fichero que le corresponden a un perfil.
  *
@@ -96,8 +126,39 @@ export function hitlDe(perfil) {
             // El nombre del perfil va DENTRO de la descripción por necesidad: el interrupt que
             // llega al runner no dice de qué subagente viene, y `dev` y `mockup` comparten tools.
             description: `[${perfil.nombre}] quiere ${TEXTO_HITL[tool] ?? tool}`,
+            when: seDetieneEn,
         };
     }
     return salida;
 }
+/**
+ * ¿Se para el turno a preguntar por ESTA escritura?
+ *
+ * El predicado `when` de `InterruptOnConfig` (leído en `langchain/agents/middleware/hitl`:
+ * «Returns `true` to interrupt or `false` to auto-approve the tool call»), y aquí existe
+ * para una sola cosa: **una escritura que el backend va a rechazar de todas formas no puede
+ * sacar un modal de aprobación.** Pasaba, y medido: pedir un artefacto en `/artifacts/`
+ * enseñaba el diff entero con Aprobar y Rechazar, y aprobarlo no escribía nada —
+ * `sinArtefactosEnElProyecto` lo rechaza después—. Un modal cuyo único final posible es un
+ * rechazo enseña a aprobar sin mirar, que es exactamente cómo se rompe la aprobación el día
+ * que importa.
+ *
+ * **Esto NO relaja la aprobación, y esa es la parte delicada.** No se salta la pregunta para
+ * escribir: se salta para NO escribir. La condición es la MISMA función que usa la guarda del
+ * backend —`artefactoFueraDeSitio`, sobre la misma cadena—, así que las dos no pueden
+ * discrepar; si discreparan, una escritura al proyecto pasaría sin que nadie la aprobara, que
+ * es el único fallo abierto posible por aquí. `perfiles.test.ts` lo ata: para cada ruta,
+ * saltarse la pregunta implica que la guarda la rechaza.
+ *
+ * Lo que pasa después es lo que se busca: la tool corre, el backend devuelve su `{error}` con
+ * la ruta buena, y el modelo reintenta en `/artefactos/`.
+ */
+export function seDetieneEn(peticion) {
+    const args = peticion?.toolCall?.args;
+    const ruta = args?.["file_path"];
+    if (typeof ruta !== "string")
+        return true;
+    // Ante la duda, se PREGUNTA: es la dirección conservadora de siempre.
+    return artefactoFueraDeSitio(ruta) === undefined;
+}
 //# sourceMappingURL=perfiles.js.map

package/dist/agent/perfiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"perfiles.js","sourceRoot":"","sources":["../../src/agent/perfiles.ts"],"names":[],"mappings":"AAQA,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,WAAW,CAAU,CAAC;AAWpE,MAAM,CAAC,MAAM,QAAQ,GAAiC;IACpD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,WAAW,EACT,gFAAgF;YAChF,iFAAiF;YACjF,mBAAmB;QACrB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,CAAC,kBAAkB,CAAC;KAC7B;IACD,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,WAAW,EACT,8EAA8E;YAC9E,qDAAqD;QACvD,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;KACnD;IACD,GAAG,EAAE;QACH,MAAM,EAAE,KAAK;QACb,WAAW,EACT,6EAA6E;YAC7E,iDAAiD;QACnD,WAAW,EAAE,KAAK;QAClB,MAAM,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;KAC/C;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,WAAW,EACT,wEAAwE;YACxE,oBAAoB;QACtB,WAAW,EAAE,KAAK;QAClB,MAAM,EAAE,CAAC,kBAAkB,CAAC;KAC7B;CACF,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B;QACE,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,CAAU;QACtC,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,CAAC;QAC/E,IAAI,EAAE,MAAe;KACtB;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,IAAI,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,OAAO,CAAU,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,OAAO,MAAM,CAAC,WAAW;QACvB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;QACpB,CAAC,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,eAAe,CAAC,CAAC;AAC7C,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,GAA2B;IACzC,UAAU,EAAE,kCAAkC;IAC9C,SAAS,EAAE,mCAAmC;CAC/C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,IAAI,MAAM,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,MAAM,GAAwE,EAAE,CAAC;IACvF,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,GAAG;YACb,gBAAgB,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;YACvC,mFAAmF;YACnF,sFAAsF;YACtF,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,YAAY,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE;SACrE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"perfiles.js","sourceRoot":"","sources":["../../src/agent/perfiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,WAAW,CAAU,CAAC;AAgBpE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B;QACE,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,CAAU;QACtC,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,CAAC;QAC/E,IAAI,EAAE,MAAe;KACtB;IACD,wFAAwF;IACxF,EAAE,UAAU,EAAE,CAAC,OAAO,CAAU,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE;IAC3F;;;;;;;;;;;;;;;;;;OAkBG;IACH,EAAE,UAAU,EAAE,CAAC,OAAO,CAAU,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE;CAChG,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAA2B;IACpD,MAAM,IAAI,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACrC,+FAA+F;IAC/F,yFAAyF;IACzF,wFAAwF;IACxF,uFAAuF;IACvF,2FAA2F;IAC3F,gEAAgE;IAChE,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,OAAO,CAAU,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,CAAC,CACN,IAAI,KAAK,OAAO;QAChB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QACzB,uFAAuF;QACvF,0FAA0F;QAC1F,0FAA0F;QAC1F,uFAAuF;QACvF,0CAA0C;QAC1C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QACzB,IAAI,KAAK,OAAO;QAChB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QACzB,IAAI,KAAK,YAAY;QACrB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CAAC,MAA2B;IACjD,OAAO,MAAM,CAAC,WAAW;QACvB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;QACpB,CAAC,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,eAAe,CAAC,CAAC;AAC7C,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,GAA2B;IACzC,UAAU,EAAE,kCAAkC;IAC9C,SAAS,EAAE,mCAAmC;CAC/C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,MAA2B;IAChD,IAAI,MAAM,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,MAAM,GAAsC,EAAE,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,GAAG;YACb,gBAAgB,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;YACvC,mFAAmF;YACnF,sFAAsF;YACtF,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,YAAY,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE;YACpE,IAAI,EAAE,WAAW;SAClB,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,WAAW,CAAC,QAAiB;IAC3C,MAAM,IAAI,GAAI,QAAqE,EAAE,QAAQ,EAAE,IAAI,CAAC;IACpG,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC;IACjC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,sEAAsE;IACtE,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AACnD,CAAC"}

package/dist/agent/persona.js

@@ -0,0 +1,40 @@
+/**
+ * El nombre de quien programa, SOLO para el saludo del primer arranque
+ * (`apps/web/src/componentes/Bienvenida.tsx`). No es un dato de CloudStudio ni de la
+ * sesión: se resuelve en local, ANTES de que exista ninguna cuenta ni ningún login, y
+ * nunca viaja más allá de ese saludo — no entra en un acto, no se persiste en
+ * `.xonecode/sesiones/` ni en `config.json`, y `web/servidor/arranque.ts` lo manda
+ * suelto en el mensaje de alta, no dentro de nada que la sesión guarde.
+ *
+ * Orden de preferencia: `git config user.name` (el efectivo — repo si lo hay, si no
+ * global —, igual que `agent/gitSync.ts#valorDeConfig` resuelve la config de sincronía)
+ * y, si no hay, el usuario del sistema (`os.userInfo()`). Sin ninguno de los dos,
+ * `undefined` — nunca un nombre inventado como «usuario»: un saludo sin nombre es
+ * neutro, uno con un nombre que no es el tuyo parece un error.
+ */
+import { execFileSync } from "node:child_process";
+import { userInfo } from "node:os";
+export function nombreDePersona(cwd) {
+    try {
+        const salida = execFileSync("git", ["config", "--get", "user.name"], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        if (salida !== "")
+            return salida;
+    }
+    catch {
+        // Sin git en el PATH, sin ninguna config, o `user.name` sin poner: se cae al
+        // siguiente candidato en vez de propagar el fallo — esto es un saludo, no un dato
+        // del que dependa nada más.
+    }
+    try {
+        const nombre = userInfo().username.trim();
+        return nombre === "" ? undefined : nombre;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=persona.js.map

package/dist/agent/persona.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.js","sourceRoot":"","sources":["../../src/agent/persona.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE;YACnE,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,MAAM,KAAK,EAAE;YAAE,OAAO,MAAM,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;QAC7E,kFAAkF;QAClF,4BAA4B;IAC9B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC1C,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/agent/procesosEnMaquina.js

@@ -0,0 +1,204 @@
+/**
+ * EL EJECUTOR DE PROCESOS DE LA MÁQUINA: lanzar, contar lo que dice, y saber en qué acabó.
+ *
+ * Existe por una duplicación MEDIDA y no por una intuición: `instalacionEnMaquina.ts` y
+ * `lanzamientoEnMaquina.ts` tenían este mismo ejecutor escrito dos veces —el `kill` del grupo
+ * con su caída al hijo, los dos topes, el troceado por líneas y la decisión de qué es
+ * «colgada»—, y ya habían empezado a divergir: la frase de `ECONNREFUSED` estaba en una y no
+ * en la otra, y el motivo del cuelgue lo distinguía una y la otra no. Un segundo sitio donde
+ * se decide CUÁNDO se mata a un proceso es un segundo sitio donde esa decisión puede dejar de
+ * estar, y ese es el patrón de fallo de esta casa.
+ *
+ * **Lo que NO unifica, y es a propósito: las FRASES.** De aquí sale la CAUSA del cuelgue
+ * —`silencio` o `total`— y cada módulo escribe la suya, porque no dicen lo mismo: «no dijo
+ * nada en N min» es un proceso esperando a alguien que no está, y «no terminó en N min» es uno
+ * que habla y da vueltas. Aplanarlas perdería justo el dato que se mira para saber qué pasó.
+ * El motivo de un código distinto de cero sí es el mismo en los dos, y vive aquí.
+ *
+ * **Todos los efectos entran por parámetro.** `npm test` no lanza un proceso: `lanzar` y
+ * `matarGrupo` son puertos, y sus valores POR OMISIÓN —los únicos de verdad, y los mismos para
+ * los dos módulos— son los que nadie pasa cuando esto corre sobre una máquina.
+ */
+import { spawn } from "node:child_process";
+/**
+ * Cuánto se aguanta SIN una sola línea de salida antes de darlo por colgado.
+ *
+ * No es un tope de duración: `sdkmanager` habla mientras descarga (porcentajes) y `adb`
+ * contesta en milisegundos, así que mientras diga algo se le espera lo que haga falta — una
+ * descarga de 3 GB por una línea lenta puede tardar media hora, y matarla por ser lenta sería
+ * peor que esperarla. Lo que no es normal es el SILENCIO: eso es un prompt esperando a alguien
+ * que no está.
+ */
+export const TOPE_SIN_SALIDA_MS = 5 * 60_000;
+/** Y un tope total, para que un proceso que habla sin avanzar no se quede para siempre. */
+export const TOPE_DE_TRABAJO_MS = 60 * 60_000;
+/** Un ejecutor con los efectos que le pasen. Sin nada, los de verdad. */
+export function crearEjecutor(deps = {}) {
+    const lanzar = deps.lanzar ?? lanzarReal;
+    const matarGrupo = deps.matarGrupo ?? ((pid, senal) => void process.kill(-pid, senal));
+    const entorno = deps.entorno ?? process.env;
+    let cancelado = false;
+    /** El que esté VIVO ahora. Se limpia al cerrarse: matar a un muerto no arregla nada. */
+    let matarAlVivo;
+    /**
+     * **NO es `async`, y es deliberado.** Devuelve la promesa que resuelve el CIERRE, tal cual:
+     * un envoltorio `async` —o un `.then()` de más— mete un tick de microtarea entre el `close`
+     * de un proceso y lo que quien llama hace después, y hay un paso de la receta que son dos
+     * procesos encadenados, donde ese tick es la diferencia entre seguir en el mismo turno o
+     * dejar un hueco.
+     */
+    const correr = (binario, args, opciones = {}) => {
+        // Cancelado antes de arrancar: no se lanza nada, que es lo que se pidió. Un proceso que
+        // nace muerto gasta un `spawn` y ensucia el log de la ventana con una línea que no es.
+        if (cancelado)
+            return Promise.resolve({ estado: "cancelada" });
+        const alSalirLinea = opciones.alSalirLinea;
+        const env = opciones.env ?? entorno;
+        const teclear = opciones.teclear ?? [];
+        return new Promise((resolver) => {
+            let hijo;
+            try {
+                hijo = lanzar(binario, args, { env });
+            }
+            catch (error) {
+                resolver({ estado: "fallo", motivo: unaLinea(error) });
+                return;
+            }
+            /**
+             * Matar el GRUPO y no solo al hijo. Medido: `brew` lanza `curl` y `sdkmanager` lanza
+             * `java`, y con `child.kill()` el nieto seguía vivo descargando después de cancelar.
+             * Sin pid —los dobles de los tests no lo tienen— se cae a matar al hijo, que es lo que
+             * esto hacía siempre.
+             */
+            const matarArbol = (senal) => {
+                const pid = hijo.pid;
+                if (pid !== undefined) {
+                    try {
+                        matarGrupo(pid, senal);
+                        return;
+                    }
+                    catch {
+                        // El grupo ya no está o el sistema no deja: se intenta con el hijo.
+                    }
+                }
+                hijo.kill(senal);
+            };
+            let cuelgue;
+            let sinSalida;
+            const rearmar = () => {
+                clearTimeout(sinSalida);
+                sinSalida = setTimeout(() => {
+                    cuelgue = "silencio";
+                    matarArbol("SIGKILL");
+                }, TOPE_SIN_SALIDA_MS);
+            };
+            const total = setTimeout(() => {
+                cuelgue = "total";
+                matarArbol("SIGKILL");
+            }, TOPE_DE_TRABAJO_MS);
+            rearmar();
+            matarAlVivo = () => matarArbol("SIGTERM");
+            if (cancelado)
+                matarAlVivo();
+            // Las líneas se parten aquí: un `data` no es una línea —puede traer media o tres—, y
+            // emitir trozos dejaría el log cortado por la mitad en la ventana.
+            let resto = "";
+            let ultima = "";
+            const trocear = (dato) => {
+                rearmar();
+                resto += String(dato);
+                const partes = resto.split(/\r?\n/);
+                resto = partes.pop() ?? "";
+                for (const linea of partes) {
+                    const limpia = linea.trimEnd();
+                    if (limpia === "")
+                        continue;
+                    ultima = limpia;
+                    alSalirLinea?.(limpia);
+                }
+            };
+            hijo.stdout.on("data", trocear);
+            hijo.stderr.on("data", trocear);
+            // Lo que hay que teclear, de una vez: el prompt puede aparecer antes de que nadie mire.
+            // El lazo corre al menos una vez aunque no haya nada que teclear: el `stdin` se cierra
+            // igual, que es lo que hace un proceso sin entrada.
+            for (let i = 0; i < Math.max(1, opciones.repetir ?? 1); i++) {
+                for (const t of teclear)
+                    hijo.stdin.write(t);
+            }
+            hijo.stdin.end();
+            hijo.on("error", ((error) => {
+                clearTimeout(sinSalida);
+                clearTimeout(total);
+                matarAlVivo = undefined;
+                resolver({ estado: "fallo", motivo: unaLinea(error) });
+            }));
+            hijo.on("close", ((codigo) => {
+                clearTimeout(sinSalida);
+                clearTimeout(total);
+                matarAlVivo = undefined;
+                // El cuelgue manda sobre el código: a un proceso al que se le mandó SIGKILL se le
+                // ocurre salir con cualquier cosa, y eso no es lo que pasó.
+                if (cuelgue !== undefined) {
+                    resolver({ estado: "colgada", cuelgue });
+                    return;
+                }
+                if (cancelado) {
+                    resolver({ estado: "cancelada" });
+                    return;
+                }
+                if (codigo === 0) {
+                    resolver({ estado: "ok" });
+                    return;
+                }
+                resolver({ estado: "fallo", motivo: motivoDelCodigo(codigo, ultima) });
+            }));
+        });
+    };
+    return {
+        correr,
+        cancelar: () => {
+            cancelado = true;
+            matarAlVivo?.();
+        },
+    };
+}
+/**
+ * Una línea, nunca la salida entera ni una traza con rutas.
+ *
+ * Es la de un proceso: `ENOENT` tiene frase propia porque «el ejecutable no existe» es lo que
+ * hay que leer, y el resto se corta en la primera línea. Un canal de RED pone su caso encima y
+ * cae aquí para lo demás (`lanzamientoEnMaquina.ts`), que es como se evita tener dos copias
+ * que ya divergieron una vez.
+ */
+export function unaLinea(error) {
+    const e = error;
+    if (e !== null && typeof e === "object" && e.code === "ENOENT")
+        return "el ejecutable no existe";
+    const mensaje = e !== null && typeof e === "object" && typeof e.message === "string" ? e.message : String(error);
+    return mensaje.split(/\r?\n/)[0].slice(0, 160);
+}
+/**
+ * El motivo de un código distinto de cero. La última línea si dijo algo, y si no el código
+ * — que es todo lo que hay.
+ */
+export function motivoDelCodigo(codigo, ultima) {
+    return ultima === "" ? `terminó con código ${codigo}` : ultima;
+}
+/**
+ * El hijo de verdad. Dos decisiones, las dos medidas:
+ *
+ * - **`detached: true`**, para que sea líder de su grupo y `kill(-pid)` se lleve también a
+ *   los nietos: sin ello, cancelar dejaba el `curl` de `brew` descargando.
+ * - **`stdio[0]` sigue siendo un `pipe`**, porque `sdkmanager` necesita que se le teclee.
+ *   Lo que hace que un `sudo` de dentro no cuelgue no es cerrar `stdin`: es no tener
+ *   terminal de CONTROL, que es de donde `sudo` lee la contraseña — y con `detached` no lo
+ *   tiene ni por herencia.
+ *
+ * Es el valor POR OMISIÓN de `crearEjecutor`, y el único `spawn` de los dos módulos: la receta
+ * de instalación y el `adb` del lanzamiento necesitan exactamente estas dos cosas por los
+ * mismos motivos, y un segundo `spawn` sería un segundo sitio donde el `detached` puede dejar
+ * de estar —y ese día el `kill(-pid)` de un sitio mataría a un grupo que no existe—.
+ */
+export const lanzarReal = (binario, args, opciones) => spawn(binario, args, { env: opciones.env, stdio: ["pipe", "pipe", "pipe"], detached: true });
+//# sourceMappingURL=procesosEnMaquina.js.map

package/dist/agent/procesosEnMaquina.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procesosEnMaquina.js","sourceRoot":"","sources":["../../src/agent/procesosEnMaquina.ts"],"names":[],"mappings":"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"}