xonecode 0.3.0 → 0.5.1

package/dist/agent/lanzamientoEnMaquina.js

@@ -0,0 +1,377 @@
+/**
+ * Poner una app en el dispositivo y dejarla ARRANCADA: el recorrido entero, fase a fase.
+ *
+ * Es la mitad que EJECUTA lo que decide la pestaña «Ejecutar»: el túnel de `adb`, el ZIP del
+ * proyecto, la subida, el reinicio del framework y —por el canal de `/hotswap`— el lanzamiento
+ * con la lectura que dice si de verdad está viva.
+ *
+ * **Las fases, y por qué ese orden** (el de arriba abajo es el del código, y no es casual):
+ *
+ * 1. **`comprobando`.** El túnel PRIMERO, porque sin él `127.0.0.1:8443` no lleva a ninguna
+ *    parte: el servidor escucha en el `localhost` del aparato, y quien lo trae aquí es
+ *    `adb forward`. **Se aplica siempre y NO se quita al terminar**: se reaplica tras cada
+ *    reconexión del cable, así que quitarlo dejaría el SIGUIENTE lanzamiento hablando con
+ *    nadie. Y va antes de la comprobación del framework porque un aparato al que no se llega
+ *    falla aquí con la línea de `adb`, que es justo el diagnóstico de ese caso.
+ * 2. **`empaquetando`.** El ZIP, porque subir es lo que pone los ficheros nuevos en el
+ *    aparato. Es síncrono y en memoria: no hay fichero temporal.
+ * 3. **`subiendo`.** **Subir NO aplica**: el proceso del framework tiene cargado lo de antes,
+ *    y el ZIP no limpia el destino —añade y sobrescribe, así que los `-wal` de una base vieja
+ *    se quedan ahí—. Por eso no viaja `bd/`, y por eso esto no es el final del recorrido.
+ * 4. **`reiniciando`.** Es lo ÚNICO que aplica lo subido. Y es `SetupActivity`, **nunca
+ *    `.mainEntry`**: medido, `.mainEntry` no levanta el servidor.
+ * 5. **`lanzando`.** El lanzamiento por el WebSocket, esperando el saludo del servidor. Entra
+ *    por `deps.abrirSocket`, que es el CONSTRUCTOR del socket —así se llama en el módulo al que
+ *    alimenta—: el cliente de `/hotswap` ya está escrito y medido en `agent/hotswap.ts`, y `ws`
+ *    no se importa aquí.
+ * 6. **`comprobando-arranque`.** La LECTURA, porque `{"result":true}` de `launchApplication`
+ *    significa «aceptado», no «arrancó»: lo que dice si está viva es el árbol de controles.
+ *
+ * **El efecto de la subida va por `node:https`, y el porqué.** Ni `fetch` con un `dispatcher`
+ * de `undici` —`undici` no es dependencia de este repo— ni `NODE_TLS_REJECT_UNAUTHORIZED=0`,
+ * que desactivaría la confianza **para todo el proceso**, proveedores de modelo y CloudStudio
+ * incluidos: una variable de entorno no distingue a quién le estás hablando. `node:https` deja
+ * el `rejectUnauthorized` en ESTA petición (el certificado del aparato es autofirmado), deja
+ * poner `Content-Length` y manda el ZIP desde memoria, sin fichero temporal.
+ *
+ * **El silencio es el síntoma, no la lentitud** (`TOPE_SIN_SALIDA_MS`): `adb` contesta en
+ * milisegundos, y lo que no es normal es que se quede callado minutos. Con `TOPE_DE_TRABAJO_MS`
+ * por encima, para que un proceso que habla sin avanzar no se quede para siempre.
+ *
+ * **Se mata el GRUPO y no el hijo** (`detached: true` + `kill(-pid)`): medido, un nieto
+ * sobrevive a `child.kill()`.
+ *
+ * **Todos los efectos entran por `deps`.** `npm test` no lanza un `adb`, ni abre un socket, ni
+ * toca la red: el ZIP, la subida, el framework y el canal de `/hotswap` son puertos, y sus
+ * dobles viven en el test. El único `node:https` de verdad es el que se usa cuando nadie pasa
+ * un doble.
+ *
+ * **Y el puerto 8443 es el de FÁBRICA, no una garantía**: si el del aparato está ocupado, el
+ * servidor coge el siguiente libre y el real se ve en la pantalla del framework. Esto se
+ * implementa contra 8443 y se anota; leer el puerto real no está implementado.
+ */
+import { request } from "node:https";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { frameworkEnDispositivo, localizadorDeAndroid, } from "./dispositivosEnMaquina.js";
+import { lanzarYComprobar } from "./hotswap.js";
+import { crearEjecutor, TOPE_DE_TRABAJO_MS, TOPE_SIN_SALIDA_MS, unaLinea, } from "./procesosEnMaquina.js";
+import { empaquetarProyecto, enMegas } from "./paqueteDelProyecto.js";
+/**
+ * Los dos topes son los MISMOS de la instalación, y se reexportan desde aquí para que no haya
+ * una segunda copia de los números: son la misma regla —el silencio es el síntoma— sobre el
+ * mismo tipo de proceso. Viven con el ejecutor que los arma (`procesosEnMaquina.ts`), que es el
+ * que usan los dos módulos.
+ */
+export { TOPE_DE_TRABAJO_MS, TOPE_SIN_SALIDA_MS };
+/**
+ * El puerto del servidor del framework. El de fábrica: ver el docstring del módulo.
+ *
+ * El mismo número para el `adb forward` y para la subida, y no dos constantes: son las dos
+ * puntas del MISMO túnel, y escribirlas por separado dejaría un lanzamiento hablando por un
+ * agujero y subiendo por otro.
+ */
+const PUERTO_DEL_SERVIDOR = 8443;
+/**
+ * El nombre EXACTO del ZIP. La extracción automática se dispara **solo** con este nombre, y con
+ * él `appName` pasa a ser obligatorio (sin él: `400`). Se extrae en `app_<appName-en-minúsculas>`.
+ */
+const NOMBRE_DEL_ZIP = "debug_app_update.zip";
+/**
+ * La actividad que LEVANTA el servidor del framework. **`.mainEntry` no sirve**: medido, no
+ * levanta el servidor, y con él el `/hotswap` no existe y el lanzamiento se queda sin canal.
+ */
+const ACTIVIDAD_DEL_SERVIDOR = "com.xone.android.hotswap.activities.SetupActivity";
+export const FASES_DE_LANZAMIENTO = [
+    "comprobando",
+    "empaquetando",
+    "subiendo",
+    "reiniciando",
+    "lanzando",
+    "comprobando-arranque",
+];
+/**
+ * Los motivos de la tabla medida (`skills/xone-hotswap/references/conexion-y-despliegue.md` §7),
+ * uno por código. **Ninguna frase lleva el cuerpo de la respuesta**, y ninguna dice «error»:
+ * cada una dice qué pasó y de quién es el problema.
+ */
+const MOTIVO_POR_CODIGO = {
+    400: "el servidor rechazó la subida: falta el nombre de la app o el tamaño no cuadra",
+    403: "el servidor rechazó el nombre de la app o la ruta",
+    405: "el servidor no acepta POST en esa ruta",
+    409: "en el dispositivo hay un directorio donde iba la app",
+    411: "el servidor pidió el tamaño del cuerpo y no se lo mandamos",
+    413: "el ZIP pasa de 512 MiB",
+    500: "el dispositivo no pudo crear el directorio, extraer o mover el fichero",
+};
+/** El `200` es el único que no es un rechazo. Y un código que no está en la tabla se CUENTA. */
+export function motivoDeSubida(codigo) {
+    if (codigo === 200)
+        return undefined;
+    return MOTIVO_POR_CODIGO[codigo] ?? `subida rechazada (${codigo})`;
+}
+/**
+ * La ruta de la subida, con la query. `appName` va escapado: un nombre con un espacio, un `&`
+ * o un `#` partiría la query y el servidor leería otro nombre —o ninguno— sin decir nada.
+ */
+export function rutaDeSubida(app) {
+    return `/file_upload?file=${NOMBRE_DEL_ZIP}&appName=${encodeURIComponent(app)}`;
+}
+/**
+ * Las cabeceras de la subida. `Content-Length` es obligatoria (sin ella: `411`).
+ *
+ * Y el `Content-Type` **está medido**, no supuesto: el comando que se midió funcionando la primera
+ * vez era un `curl --data-binary`, cuyo `Content-Type` por omisión es
+ * `application/x-www-form-urlencoded`, así que durante una pasada esto se declaró sin afirmarse.
+ * Ya se subió de verdad con `application/octet-stream` y el servidor contestó `200` **con los bytes
+ * enteros** — el `md5` de `LoginColl.xne` y de `app.xml` en el aparato coincide con el del proyecto
+ * en disco, y con eso subido la app arranca—, así que el cuerpo no se interpreta como formulario.
+ * Es lo correcto para bytes y es lo que vale; la medida entera está en `docs/DECISIONES.md`.
+ */
+export function cabecerasDeSubida(bytes) {
+    return {
+        "Content-Length": String(bytes.length),
+        "Content-Type": "application/octet-stream",
+    };
+}
+/**
+ * Las opciones de la petición, en UNA función que se puede mirar sin abrir nada.
+ *
+ * Existe para que la decisión de TLS y de método sea comprobable: `rejectUnauthorized: false`
+ * es el certificado autofirmado del aparato, y el destino es un túnel de `adb` en loopback.
+ * Un test que hablara con un servidor de verdad para comprobarlo necesitaría red y un
+ * certificado; esto se lee.
+ */
+export function opcionesDeSubida(peticion, senal) {
+    return {
+        host: peticion.host,
+        port: peticion.puerto,
+        path: peticion.ruta,
+        method: peticion.metodo,
+        headers: peticion.cabeceras,
+        timeout: TOPE_DE_TRABAJO_MS,
+        signal: senal,
+        rejectUnauthorized: false,
+    };
+}
+/**
+ * El recorrido entero, lanzado. Devuelve el trabajo en curso: se puede cancelar mientras corre.
+ *
+ * **Nunca lanza.** Todo lo que puede ir mal —no hay `adb`, no hay framework, el paquete no se
+ * puede montar, el servidor contesta un código, el proceso se queda callado— vuelve como un
+ * `ResultadoDeLanzamiento` con su fase y su línea de motivo: quien llama está atendiendo una
+ * petición del navegador y un aparato que no contesta no es una excepción del programa.
+ */
+export function lanzarEnDispositivo(peticion, deps = {}) {
+    const plataforma = deps.plataforma ?? process.platform;
+    const entorno = deps.entorno ?? process.env;
+    const home = deps.home ?? homedir();
+    const existe = deps.existe ?? existsSync;
+    const marco = deps.frameworkEnDispositivo ?? frameworkEnDispositivo;
+    const empaquetar = deps.empaquetarProyecto ?? empaquetarProyecto;
+    const subir = deps.subir ?? subirReal;
+    const ahora = deps.ahora ?? (() => Date.now());
+    const t0 = ahora();
+    // El ejecutor de procesos es el MISMO de la receta de instalación (`procesosEnMaquina.ts`):
+    // los `adb` de aquí necesitan exactamente los topes, el troceado por líneas y el `kill` del
+    // grupo que ya estaban escritos allí. `lanzar` y `matarGrupo` siguen siendo puertos de este
+    // módulo, y entran por aquí.
+    const ejecutor = crearEjecutor({ lanzar: deps.lanzar, matarGrupo: deps.matarGrupo, entorno });
+    const decir = (fase, linea) => deps.alFase?.(fase, linea);
+    const acabar = (fase, desenlace) => {
+        // El motivo ES una línea que merece contarse: el log de la pestaña acabaría sin decir por
+        // qué, y un recorrido que se para en silencio se lee como que se ha colgado.
+        const motivo = desenlace.estado === "fallo" || desenlace.estado === "colgada" ? desenlace.motivo : undefined;
+        if (motivo !== undefined)
+            decir(fase, motivo);
+        return { estado: desenlace.estado, fase, ...(motivo === undefined ? {} : { motivo }), ms: ahora() - t0 };
+    };
+    let cancelado = false;
+    /** La subida en vuelo, para poder abortarla. */
+    let abortar;
+    /**
+     * El aviso de cancelación, y el porqué: `lanzarYComprobar` es dueño de su socket y no acepta
+     * una cancelación, así que sin esto un «Cancelar» durante el sondeo esperaría hasta 60 s. Y lo
+     * mismo vale para el reintento con que abre el canal —el que espera a que el framework
+     * reiniciado escuche—, que se rige por su propio tope.
+     * El precio, declarado: el canal se cierra con SU tope, no con el nuestro.
+     */
+    let avisarCancelacion;
+    const cancelacion = new Promise((cumplir) => {
+        avisarCancelacion = cumplir;
+    });
+    const terminado = (async () => {
+        // ---- 1. comprobando: el túnel, y luego el framework --------------------------------
+        const adb = localizadorDeAndroid({ plataforma, entorno, home, existe }).enSdk("adb", "platform-tools");
+        if (adb === undefined) {
+            return acabar("comprobando", { estado: "fallo", motivo: "no está adb: sin él no se llega al dispositivo" });
+        }
+        const serial = peticion.dispositivo.id;
+        const tunel = await unProceso("comprobando", adb, [
+            "-s",
+            serial,
+            "forward",
+            `tcp:${PUERTO_DEL_SERVIDOR}`,
+            `tcp:${PUERTO_DEL_SERVIDOR}`,
+        ]);
+        if (tunel.estado !== "ok")
+            return acabar("comprobando", tunel);
+        decir("comprobando", `túnel aplicado: 127.0.0.1:${PUERTO_DEL_SERVIDOR} es el aparato ${serial}`);
+        const instalado = await marco(peticion.dispositivo, { plataforma, entorno, home, existe });
+        if (!instalado.instalado || instalado.paquete === undefined) {
+            // El `detalle` es una línea que ya existe y dice qué se buscó y qué se encontró.
+            return acabar("comprobando", { estado: "fallo", motivo: instalado.detalle });
+        }
+        // El paquete del framework es lo que reinicia, y sale de la MEDIDA de este aparato: los dos
+        // flavors tienen nombres distintos y un valor a fuego lanzaría el de otro.
+        const delFramework = instalado.paquete;
+        decir("comprobando", instalado.detalle);
+        // ---- 2. empaquetando ----------------------------------------------------------------
+        let paquete;
+        try {
+            paquete = empaquetar(peticion.raiz);
+        }
+        catch (error) {
+            return acabar("empaquetando", { estado: "fallo", motivo: unaLineaDeLaSubida(error) });
+        }
+        if (cancelado)
+            return acabar("empaquetando", { estado: "cancelada" });
+        decir("empaquetando", `el paquete son ${enMegas(paquete.total)} en ${paquete.ficheros.length} ficheros`);
+        // ---- 3. subiendo --------------------------------------------------------------------
+        const bytes = paquete.bytes;
+        decir("subiendo", `subiendo ${NOMBRE_DEL_ZIP} (${enMegas(bytes.length)}) a 127.0.0.1:${PUERTO_DEL_SERVIDOR}`);
+        abortar = new AbortController();
+        let respuesta;
+        try {
+            respuesta = await subir({
+                host: "127.0.0.1",
+                puerto: PUERTO_DEL_SERVIDOR,
+                ruta: rutaDeSubida(peticion.app),
+                metodo: "POST",
+                cabeceras: cabecerasDeSubida(bytes),
+                cuerpo: bytes,
+            }, abortar.signal);
+        }
+        catch (error) {
+            if (cancelado)
+                return acabar("subiendo", { estado: "cancelada" });
+            return acabar("subiendo", { estado: "fallo", motivo: unaLineaDeLaSubida(error) });
+        }
+        finally {
+            abortar = undefined;
+        }
+        if (cancelado)
+            return acabar("subiendo", { estado: "cancelada" });
+        const rechazo = motivoDeSubida(respuesta.codigo);
+        if (rechazo !== undefined)
+            return acabar("subiendo", { estado: "fallo", motivo: rechazo });
+        decir("subiendo", "el servidor aceptó la subida: los ficheros están en el aparato, sin aplicar");
+        // ---- 4. reiniciando: lo único que APLICA lo subido ----------------------------------
+        decir("reiniciando", `parando ${delFramework}`);
+        const parada = await unProceso("reiniciando", adb, ["-s", serial, "shell", "am", "force-stop", delFramework]);
+        if (parada.estado !== "ok")
+            return acabar("reiniciando", parada);
+        decir("reiniciando", "arrancando la pantalla del servidor de hotswap, que levanta el canal");
+        const arranqueDeLaPantalla = await unProceso("reiniciando", adb, [
+            "-s",
+            serial,
+            "shell",
+            "am",
+            "start",
+            "-n",
+            `${delFramework}/${ACTIVIDAD_DEL_SERVIDOR}`,
+        ]);
+        if (arranqueDeLaPantalla.estado !== "ok")
+            return acabar("reiniciando", arranqueDeLaPantalla);
+        // ---- 5 y 6. lanzando, y la LECTURA que decide ---------------------------------------
+        decir("lanzando", `lanzando ${peticion.app} por el canal /hotswap`);
+        const veredicto = await Promise.race([
+            lanzarYComprobar(peticion.app, {
+                abrirSocket: deps.abrirSocket,
+                // Las líneas del canal se cuelgan de la fase del lanzamiento: son suyas, y el saludo
+                // del servidor con su `protocol_version` es parte de lo que hay que poder leer.
+                alLinea: (linea) => decir("lanzando", linea),
+            }),
+            cancelacion.then(() => undefined),
+        ]);
+        if (veredicto === undefined || cancelado)
+            return acabar("lanzando", { estado: "cancelada" });
+        if (!veredicto.viva) {
+            // El motivo es la frase LITERAL del framework, sin traducir: es lo único que dice QUÉ
+            // pasó, y traducirla perdería justo el dato que hace falta para diagnosticar.
+            return acabar("comprobando-arranque", { estado: "fallo", motivo: veredicto.motivo ?? "no arrancó" });
+        }
+        decir("comprobando-arranque", "la app está viva: el framework contestó su árbol de controles");
+        return acabar("comprobando-arranque", { estado: "ok" });
+    })();
+    /**
+     * Un `adb` y su salida en vivo, por el ejecutor COMPARTIDO (`procesosEnMaquina.ts`): los
+     * topes, el troceado por líneas y el `kill` del GRUPO son los mismos que los de la receta, y
+     * por los mismos motivos. Aquí solo se le dice a qué fase pertenecen sus líneas y se traduce
+     * su desenlace; el que esté en vuelo lo cancela el propio ejecutor.
+     */
+    function unProceso(fase, bin, args) {
+        return ejecutor.correr(bin, args, { alSalirLinea: (linea) => decir(fase, linea) }).then(desenlaceDe);
+    }
+    return {
+        cancelar: () => {
+            cancelado = true;
+            avisarCancelacion?.();
+            abortar?.abort();
+            ejecutor.cancelar();
+        },
+        terminado,
+    };
+}
+/**
+ * La subida de verdad, en una petición y sin fichero temporal. El cuerpo NO se lee —solo el
+ * código—, y por eso no hay nada que pueda acabar en una frase de log.
+ */
+const subirReal = (peticion, senal) => new Promise((resolver, fallar) => {
+    const peticionHttp = request(opcionesDeSubida(peticion, senal), (respuesta) => {
+        // Se drena la respuesta para que el socket se cierre: dejarla a medias mantiene la
+        // conexión abierta y el servidor esperando.
+        respuesta.resume();
+        resolver({ codigo: respuesta.statusCode ?? 0 });
+    });
+    peticionHttp.on("error", fallar);
+    peticionHttp.on("timeout", () => {
+        peticionHttp.destroy(new Error(`no respondió en ${Math.round(TOPE_DE_TRABAJO_MS / 60_000)} min`));
+    });
+    peticionHttp.end(peticion.cuerpo);
+});
+/**
+ * Una línea, con la frase que solo tiene sentido en ESTE canal encima de la genérica.
+ *
+ * El caso de `ECONNREFUSED` —el servidor vive dentro de la app, y sin app no hay servidor— es
+ * la MISMA frase, palabra por palabra, que la de `hotswap.ts`. Y es a propósito: es el mismo
+ * hecho, y leerlo de dos formas distintas según en qué fase se descubriera haría pensar que son
+ * dos fallos. `hotswap.ts` conserva la suya —su socket no es un proceso y allí se lee entera—
+ * y esta envuelve a la del ejecutor (`procesosEnMaquina.ts`) en vez de repetirla, que es como
+ * estas dos frases dejaron de ser dos copias que divergen.
+ */
+function unaLineaDeLaSubida(error) {
+    const e = error;
+    if (e !== null && typeof e === "object" && e.code === "ECONNREFUSED") {
+        return "no hay nadie escuchando ahí: el servidor vive dentro de la app, y sin app no hay servidor";
+    }
+    return unaLinea(error);
+}
+/**
+ * La frase de un cuelgue. **No es lo mismo callarse que dar vueltas**: un proceso que no dice
+ * nada está esperando a alguien que no está —un prompt, un permiso—, y uno que habla y no
+ * acaba está dando vueltas. La causa la devuelve el ejecutor y la frase se escribe aquí, que es
+ * de quien es el diagnóstico.
+ */
+function motivoDelCuelgue(causa) {
+    return causa === "silencio"
+        ? `no dijo nada en ${Math.round(TOPE_SIN_SALIDA_MS / 60_000)} min`
+        : `no terminó en ${Math.round(TOPE_DE_TRABAJO_MS / 60_000)} min`;
+}
+/** Lo que dijo el ejecutor, en el vocabulario de este recorrido. La fase la pone quien llama. */
+function desenlaceDe(fin) {
+    if (fin.estado === "colgada")
+        return { estado: "colgada", motivo: motivoDelCuelgue(fin.cuelgue) };
+    return fin;
+}
+//# sourceMappingURL=lanzamientoEnMaquina.js.map

package/dist/agent/lanzamientoEnMaquina.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lanzamientoEnMaquina.js","sourceRoot":"","sources":["../../src/agent/lanzamientoEnMaquina.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,OAAO,EAAE,OAAO,EAAuB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAGrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAA2B,MAAM,cAAc,CAAC;AACzE,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,GAIT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAA2B,MAAM,yBAAyB,CAAC;AAE/F;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;GAGG;AACH,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAE9C;;;GAGG;AACH,MAAM,sBAAsB,GAAG,mDAAmD,CAAC;AAcnF,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,aAAa;IACb,cAAc;IACd,UAAU;IACV,aAAa;IACb,UAAU;IACV,sBAAsB;CACvB,CAAC;AAiGF;;;;GAIG;AACH,MAAM,iBAAiB,GAA2B;IAChD,GAAG,EAAE,gFAAgF;IACrF,GAAG,EAAE,mDAAmD;IACxD,GAAG,EAAE,wCAAwC;IAC7C,GAAG,EAAE,sDAAsD;IAC3D,GAAG,EAAE,4DAA4D;IACjE,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,wEAAwE;CAC9E,CAAC;AAEF,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IACrC,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,qBAAqB,MAAM,GAAG,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,qBAAqB,cAAc,YAAY,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAiB;IACjD,OAAO;QACL,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACtC,cAAc,EAAE,0BAA0B;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA0B,EAAE,KAAmB;IAC9E,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,IAAI,EAAE,QAAQ,CAAC,MAAM;QACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,QAAQ,CAAC,SAAS;QAC3B,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,KAAK;QACb,kBAAkB,EAAE,KAAK;KAC1B,CAAC;AACJ,CAAC;AAKD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA+B,EAC/B,OAAkC,EAAE;IAEpC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,sBAAsB,IAAI,sBAAsB,CAAC;IACpE,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC;IACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,4FAA4F;IAC5F,4FAA4F;IAC5F,4FAA4F;IAC5F,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAE9F,MAAM,KAAK,GAAG,CAAC,IAAuB,EAAE,KAAa,EAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3F,MAAM,MAAM,GAAG,CAAC,IAAuB,EAAE,SAAoB,EAA0B,EAAE;QACvF,0FAA0F;QAC1F,6EAA6E;QAC7E,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,KAAK,OAAO,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7G,IAAI,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;IAC3G,CAAC,CAAC;IAEF,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,gDAAgD;IAChD,IAAI,OAAoC,CAAC;IACzC;;;;;;OAMG;IACH,IAAI,iBAA2C,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAChD,iBAAiB,GAAG,OAAO,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,CAAC,KAAK,IAAqC,EAAE;QAC7D,uFAAuF;QACvF,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QACvG,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gDAAgD,EAAE,CAAC,CAAC;QAC9G,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,aAAa,EAAE,GAAG,EAAE;YAChD,IAAI;YACJ,MAAM;YACN,SAAS;YACT,OAAO,mBAAmB,EAAE;YAC5B,OAAO,mBAAmB,EAAE;SAC7B,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC/D,KAAK,CAAC,aAAa,EAAE,6BAA6B,mBAAmB,kBAAkB,MAAM,EAAE,CAAC,CAAC;QAEjG,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC5D,iFAAiF;YACjF,OAAO,MAAM,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,4FAA4F;QAC5F,2EAA2E;QAC3E,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC;QACvC,KAAK,CAAC,aAAa,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;QAExC,wFAAwF;QACxF,IAAI,OAA2B,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,SAAS;YAAE,OAAO,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QACtE,KAAK,CAAC,cAAc,EAAE,kBAAkB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;QAEzG,wFAAwF;QACxF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,KAAK,CAAC,UAAU,EAAE,YAAY,cAAc,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,mBAAmB,EAAE,CAAC,CAAC;QAC9G,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;QAChC,IAAI,SAA4B,CAAC;QACjC,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,KAAK,CACrB;gBACE,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,mBAAmB;gBAC3B,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAChC,MAAM,EAAE,MAAM;gBACd,SAAS,EAAE,iBAAiB,CAAC,KAAK,CAAC;gBACnC,MAAM,EAAE,KAAK;aACd,EACD,OAAO,CAAC,MAAM,CACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS;gBAAE,OAAO,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;YAClE,OAAO,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;QACD,IAAI,SAAS;YAAE,OAAO,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3F,KAAK,CAAC,UAAU,EAAE,6EAA6E,CAAC,CAAC;QAEjG,wFAAwF;QACxF,KAAK,CAAC,aAAa,EAAE,WAAW,YAAY,EAAE,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;QAC9G,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAEjE,KAAK,CAAC,aAAa,EAAE,sEAAsE,CAAC,CAAC;QAC7F,MAAM,oBAAoB,GAAG,MAAM,SAAS,CAAC,aAAa,EAAE,GAAG,EAAE;YAC/D,IAAI;YACJ,MAAM;YACN,OAAO;YACP,IAAI;YACJ,OAAO;YACP,IAAI;YACJ,GAAG,YAAY,IAAI,sBAAsB,EAAE;SAC5C,CAAC,CAAC;QACH,IAAI,oBAAoB,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;QAE7F,wFAAwF;QACxF,KAAK,CAAC,UAAU,EAAE,YAAY,QAAQ,CAAC,GAAG,wBAAwB,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YACnC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,EAAE;gBAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,qFAAqF;gBACrF,gFAAgF;gBAChF,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC;aAC7C,CAAC;YACF,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS;YAAE,OAAO,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACpB,sFAAsF;YACtF,8EAA8E;YAC9E,OAAO,MAAM,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,KAAK,CAAC,sBAAsB,EAAE,+DAA+D,CAAC,CAAC;QAC/F,OAAO,MAAM,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,EAAE,CAAC;IAEL;;;;;OAKG;IACH,SAAS,SAAS,CAAC,IAAuB,EAAE,GAAW,EAAE,IAAc;QACrE,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvG,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE;YACb,SAAS,GAAG,IAAI,CAAC;YACjB,iBAAiB,EAAE,EAAE,CAAC;YACtB,OAAO,EAAE,KAAK,EAAE,CAAC;YACjB,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,CAAC;QACD,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,SAAS,GAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAClD,IAAI,OAAO,CAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;IAClD,MAAM,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE;QAC5E,mFAAmF;QACnF,4CAA4C;QAC5C,SAAS,CAAC,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QAC9B,YAAY,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,KAAK,CAAC,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;IACH,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEL;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,KAAc;IACxC,MAAM,CAAC,GAAG,KAAkC,CAAC;IAC7C,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACrE,OAAO,2FAA2F,CAAC;IACrG,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,KAAsB;IAC9C,OAAO,KAAK,KAAK,UAAU;QACzB,CAAC,CAAC,mBAAmB,IAAI,CAAC,KAAK,CAAC,kBAAkB,GAAG,MAAM,CAAC,MAAM;QAClE,CAAC,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;AACrE,CAAC;AAED,iGAAiG;AACjG,SAAS,WAAW,CAAC,GAAiB;IACpC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;IAClG,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/agent/manifiesto.js

@@ -0,0 +1,59 @@
+/**
+ * Todos los directorios antepasados de una ruta, del más profundo al más superficial.
+ *
+ * No basta con el padre inmediato: si el truncado esconde un directorio HERMANO del que
+ * sí sobrevivió (p. ej. "a/d/" cuando solo asomó "a/b/c.txt"), solo pedir "a/b" nunca
+ * llega a pedir "a", y "a/d/e.txt" se queda sin enumerar. Encolar la cadena entera de
+ * ancestros es lo que recupera esos hermanos.
+ */
+const ancestrosDe = (ruta) => {
+    const partes = ruta.split("/");
+    const ancestros = [];
+    for (let i = partes.length - 1; i > 0; i--) {
+        ancestros.push(partes.slice(0, i).join("/"));
+    }
+    return ancestros;
+};
+export async function enumerarRemoto(puerto) {
+    const vistas = new Map();
+    const noEnumerados = [];
+    const pendientes = [""];
+    const visitados = new Set();
+    let raizTruncada = false;
+    while (pendientes.length > 0) {
+        const directorio = pendientes.shift();
+        if (visitados.has(directorio))
+            continue;
+        visitados.add(directorio);
+        let respuesta;
+        try {
+            respuesta = await puerto.estructura(directorio === "" ? undefined : directorio);
+        }
+        catch {
+            // El motivo no se propaga al mensaje: puede traer rutas del servidor. Basta con
+            // saber QUÉ no se enumeró, que es lo que condiciona el candado.
+            noEnumerados.push(directorio);
+            continue;
+        }
+        // Solo la raíz importa aquí: un directorio truncado cualquiera lo sortea el propio
+        // recorrido pidiendo sus ancestros, pero un hermano de primer nivel que la raíz deja
+        // fuera y que ningún fichero visto menciona nunca llega a pedirse.
+        if (directorio === "" && respuesta.truncado)
+            raizTruncada = true;
+        for (const entrada of respuesta.entradas) {
+            vistas.set(entrada.ruta, entrada.bytes);
+            // Cada directorio antepasado se vuelve a pedir por su cuenta: si esta respuesta
+            // venía truncada, el recorrido por subdirectorios recupera lo que faltó — incluidos
+            // hermanos que no llegaron a asomar en absoluto en la respuesta truncada.
+            for (const ancestro of ancestrosDe(entrada.ruta)) {
+                if (!visitados.has(ancestro))
+                    pendientes.push(ancestro);
+            }
+        }
+    }
+    const manifiesto = [...vistas.entries()]
+        .map(([ruta, bytes]) => ({ ruta, bytes }))
+        .sort((a, b) => a.ruta.localeCompare(b.ruta));
+    return { manifiesto, noEnumerados, raizTruncada };
+}
+//# sourceMappingURL=manifiesto.js.map

package/dist/agent/manifiesto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifiesto.js","sourceRoot":"","sources":["../../src/agent/manifiesto.ts"],"names":[],"mappings":"AA0BA;;;;;;;GAOG;AACH,MAAM,WAAW,GAAG,CAAC,IAAY,EAAY,EAAE;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAuB;IAC1D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,UAAU,GAAa,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,EAAG,CAAC;QACvC,IAAI,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACxC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE1B,IAAI,SAAS,CAAC;QACd,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,gFAAgF;YAChF,gEAAgE;YAChE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,mFAAmF;QACnF,qFAAqF;QACrF,mEAAmE;QACnE,IAAI,UAAU,KAAK,EAAE,IAAI,SAAS,CAAC,QAAQ;YAAE,YAAY,GAAG,IAAI,CAAC;QAEjE,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACxC,gFAAgF;YAChF,oFAAoF;YACpF,0EAA0E;YAC1E,KAAK,MAAM,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACpD,CAAC"}

package/dist/agent/memoriaDeProyecto.js

@@ -0,0 +1,60 @@
+/**
+ * La memoria que pertenece al proyecto, no a una sesión ni a la cuenta del usuario.
+ *
+ * Se guarda en `.xonecode/memoria.md` para viajar con el proyecto si el usuario quiere
+ * versionarla, pero el agente la conoce mediante una sola ruta virtual segura. Ni
+ * `config.json` ni otros ficheros internos quedan expuestos por esta costura.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { NOMBRE_CARPETA } from "./configEnDisco.js";
+export const NOMBRE_ARCHIVO_MEMORIA = "memoria.md";
+/** Ruta que ve el agente dentro de su backend virtual. */
+export const RUTA_MEMORIA_VIRTUAL = "/MEMORIA_PROYECTO.md";
+/** Ruta real dentro del backend virtual; nunca se enseña al agente. */
+export const RUTA_MEMORIA_INTERNA = `/${NOMBRE_CARPETA}/${NOMBRE_ARCHIVO_MEMORIA}`;
+/** Almacén interno de los historiales que DeepAgents ya ha resumido. */
+export const RUTA_HISTORIAL_RESUMIDO = `/${NOMBRE_CARPETA}/conversation_history`;
+export function rutaMemoriaDeProyecto(raiz) {
+    return join(raiz, NOMBRE_CARPETA, NOMBRE_ARCHIVO_MEMORIA);
+}
+export const PLANTILLA_MEMORIA = `# Memoria del proyecto
+
+Esta memoria recoge solo hechos confirmados, decisiones acordadas y riesgos que ayudan a
+continuar el trabajo. No es un transcript ni guarda secretos, credenciales o contenido de
+ficheros completos.
+
+## Decisiones
+
+- Aún no hay decisiones registradas.
+
+## Estado y convenciones
+
+- Aún no hay estado persistente registrado.
+
+## Riesgos y pendientes
+
+- Aún no hay riesgos o pendientes registrados.
+`;
+/**
+ * Crea la memoria inicial una sola vez. `flag: wx` es la barrera contra pisar una
+ * memoria existente, incluso si dos sesiones arrancan a la vez.
+ */
+export function asegurarMemoriaDeProyecto(raiz) {
+    const ruta = rutaMemoriaDeProyecto(raiz);
+    if (existsSync(ruta))
+        return false;
+    mkdirSync(join(raiz, NOMBRE_CARPETA), { recursive: true });
+    try {
+        writeFileSync(ruta, PLANTILLA_MEMORIA, { encoding: "utf8", flag: "wx" });
+        return true;
+    }
+    catch (error) {
+        // Otra sesión pudo ganarnos entre existsSync y writeFileSync: su memoria es la que
+        // manda. Cualquier otro fallo (permiso, ruta inválida) debe llegar al llamador.
+        if (error && typeof error === "object" && "code" in error && error.code === "EEXIST")
+            return false;
+        throw error;
+    }
+}
+//# sourceMappingURL=memoriaDeProyecto.js.map

package/dist/agent/memoriaDeProyecto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoriaDeProyecto.js","sourceRoot":"","sources":["../../src/agent/memoriaDeProyecto.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,YAAY,CAAC;AACnD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAC3D,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,cAAc,IAAI,sBAAsB,EAAE,CAAC;AACnF,wEAAwE;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,cAAc,uBAAuB,CAAC;AAEjF,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,sBAAsB,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;CAiBhC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,aAAa,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,mFAAmF;QACnF,gFAAgF;QAChF,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACnG,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}