xonecode 0.35.0 → 0.37.0

package/dist/agent/remoto/ngrokEnMaquina.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngrokEnMaquina.js","sourceRoot":"","sources":["../../../src/agent/remoto/ngrokEnMaquina.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACrH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAY1D,iIAAiI;AACjI,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,CAAqD,CAAC;QAClG,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;QACrC,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAa/F,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,OAA4B,EAAE;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,UAAU,KAAK,EAAE;QAAE,OAAO,UAAU,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAA4B,CAAC;QACnF,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,OAAO,CAAC,SAAS,CAAC;IACpH,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,oBAAoB,CAAC,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QAC5F,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5C,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA4B,EAAE;IAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,aAAa,CAAC,EAAE,CAAC;IACtD,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;AACxF,CAAC;AAID,uGAAuG;AACvG,SAAS,mBAAmB,CAAC,IAAY,EAAE,SAAiB;IAC1D,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAC/C,IAAI,EAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACrC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACrC,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,EAAE,GAAG,SAAS,CAAC;QACf,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,EAAE,KAAK,SAAS;YAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAA4B,EAAE;IAClF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,CAAC;IACxG,IAAI,CAAC;QACH,CAAC,IAAI,CAAC,QAAQ,IAAI,mBAAmB,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACnJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,mBAAmB,EAAE,CAAC;IACtE,CAAC;AACH,CAAC"}

package/dist/agent/remoto/puenteWebSocket.js

@@ -0,0 +1,175 @@
+export const NOMBRE_DEL_PAQUETE = "@xone/xonecode-remoto";
+/** `undefined` = el paquete no está instalado: quien llama lo dice, aquí no se propaga el error. */
+export async function cargarModuloRemoto(importar = (n) => import(n)) {
+    // En una VARIABLE `string`: un literal haría que tsc y los empaquetadores lo resolvieran.
+    const nombre = NOMBRE_DEL_PAQUETE;
+    try {
+        return (await importar(nombre));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * La subruta del paquete con el PUENTE (el relé que `xonecode-server` corre en la nube), para la
+ * vía «túnel local»: xonecode lo arranca en loopback y ngrok lo publica (`tunelNgrok.ts`). Vive
+ * aquí para que el nombre del paquete siga en UN fichero.
+ */
+export const NOMBRE_DEL_SERVIDOR = `${NOMBRE_DEL_PAQUETE}/servidor`;
+/**
+ * `undefined` = el paquete no está, o es una versión sin el puente (sin la subruta, o sin
+ * `arrancarServidor`): quien llama lo dice con su texto fijo.
+ */
+export async function cargarServidorRemoto(importar = (n) => import(n)) {
+    const nombre = NOMBRE_DEL_SERVIDOR;
+    try {
+        const m = (await importar(nombre));
+        return m !== null && typeof m === "object" && typeof m.arrancarServidor === "function" ? m : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Motivos del relé que acaban la sesión, con texto FIJO: lo que el relé diga no cruza el cable. */
+const MOTIVOS = {
+    version: "la versión del protocolo no casa: actualiza xonecode",
+    "sala-ocupada": "esa sala ya tiene un anfitrión",
+    ritmo: "el puente cortó la conexión por exceso de mensajes",
+    "mensaje-ilegible": "el puente no entendió un mensaje",
+};
+const MOTIVO_DE_TAMANO = "un mensaje superó el tamaño máximo del puente";
+/**
+ * Lo que `cerrar` espera, como mucho, a que el relé cierre el socket tras el «cerrar». Sin tope,
+ * un relé que no contesta colgaría el apagado; con él, lo peor es el comportamiento de antes.
+ */
+export const TOPE_DE_CIERRE_MS = 2_000;
+/** Código de cierre WebSocket de «mensaje demasiado grande»: el relé cierra así, sin `error`. */
+const CIERRE_MENSAJE_GRANDE = 1009;
+export function crearPuenteWebSocket(modulo, opciones = {}) {
+    const esperas = opciones.esperasMs ?? [1_000, 2_000, 5_000, 10_000, 30_000];
+    const topeDeCierre = opciones.topeDeCierreMs ?? TOPE_DE_CIERRE_MS;
+    return {
+        async abrir(servidor, escuchas) {
+            const { sala, secreto } = modulo.generarCredenciales();
+            // UN canal cifrado por encendido, conservado en las reconexiones: uno nuevo al reconectar
+            // dejaría al relé repetir mensajes viejos del móvil.
+            const canal = await modulo.crearCanal({ secreto, sala, rol: "anfitrion" });
+            const url = modulo.urlDeSesion(modulo.baseHttpDe(servidor), sala, secreto);
+            let ws;
+            let cerrado = false;
+            let intento = 0;
+            let cola = Promise.resolve();
+            /**
+             * Lo que SALE, también en cola: el canal toma la secuencia al llamar a `cifrar` y el móvil
+             * descarta toda secuencia que no supere la última, así que cifrar en paralelo y mandar al
+             * terminar perdía un mensaje (una `reemision` o una `aprobacion` grandes, adelantadas por
+             * uno pequeño). Cifrar Y mandar van en el orden de llamada; un paso que falla no bloquea.
+             */
+            let envios = Promise.resolve();
+            let temporizador;
+            const acabar = (motivo) => {
+                cerrado = true;
+                escuchas.alEstado({ estado: "cerrada", motivo });
+            };
+            const conectar = () => {
+                const socket = new WebSocket(servidor);
+                ws = socket;
+                socket.onopen = () => {
+                    intento = 0;
+                    socket.send(JSON.stringify({ t: "abrir", sala, v: modulo.VERSION_DEL_PROTOCOLO }));
+                };
+                const procesar = async (ev) => {
+                    if (cerrado || ws !== socket)
+                        return;
+                    let s;
+                    try {
+                        s = JSON.parse(String(ev.data));
+                    }
+                    catch {
+                        return;
+                    }
+                    if (s.t === "abierta")
+                        escuchas.alEstado({ estado: "abierta", url });
+                    else if (s.t === "presencia" && Array.isArray(s.moviles))
+                        escuchas.alPresencia(s.moviles.filter((x) => typeof x === "string"));
+                    else if (s.t === "dato" && typeof s.de === "string" && typeof s.carga === "string") {
+                        let claro;
+                        try {
+                            claro = await canal.descifrar(s.carga);
+                        }
+                        catch {
+                            return; // lo que no descifra no es del móvil: se descarta
+                        }
+                        if (claro !== undefined && !cerrado)
+                            escuchas.alMensaje(s.de, claro);
+                    }
+                    else if (s.t === "error" && typeof s.motivo === "string" && s.motivo in MOTIVOS) {
+                        acabar(MOTIVOS[s.motivo]);
+                        socket.close();
+                    }
+                };
+                // En orden de llegada: el canal real descarta lo que no supera la última secuencia vista,
+                // y descifrar en paralelo desordenaría los mensajes legítimos del móvil.
+                socket.onmessage = (ev) => {
+                    cola = cola.then(() => procesar(ev)).catch(() => { });
+                };
+                socket.onclose = (ev) => {
+                    if (cerrado || ws !== socket)
+                        return;
+                    if (ev.code === CIERRE_MENSAJE_GRANDE) {
+                        acabar(MOTIVO_DE_TAMANO);
+                        return;
+                    }
+                    escuchas.alEstado({ estado: "reconectando" });
+                    const espera = esperas[Math.min(intento, esperas.length - 1)];
+                    intento += 1;
+                    temporizador = setTimeout(() => {
+                        if (!cerrado)
+                            conectar();
+                    }, espera);
+                };
+                // Un fallo de conexión llega también como `close`: aquí solo se evita que `error` sobre.
+                socket.onerror = () => { };
+            };
+            conectar();
+            return {
+                enviar(para, mensaje) {
+                    const paso = envios.then(async () => {
+                        const socket = ws;
+                        if (cerrado || socket?.readyState !== WebSocket.OPEN)
+                            return;
+                        const carga = await canal.cifrar(mensaje);
+                        if (cerrado || socket.readyState !== WebSocket.OPEN)
+                            return;
+                        socket.send(JSON.stringify(para === undefined ? { t: "dato", carga } : { t: "dato", para, carga }));
+                    });
+                    envios = paso.catch(() => { });
+                    return paso;
+                },
+                cerrar() {
+                    cerrado = true;
+                    if (temporizador !== undefined)
+                        clearTimeout(temporizador);
+                    const socket = ws;
+                    if (socket === undefined || socket.readyState === WebSocket.CLOSED)
+                        return Promise.resolve();
+                    // El relé contesta al «cerrar» avisando a los móviles y cortando: cuando el socket se
+                    // cierra, ese aviso ya salió. Quien mate después lo que hay en medio (ngrok) no lo pierde.
+                    const cerrandose = new Promise((resolver) => {
+                        const tope = setTimeout(resolver, topeDeCierre);
+                        tope.unref?.();
+                        socket.addEventListener("close", () => {
+                            clearTimeout(tope);
+                            resolver();
+                        });
+                    });
+                    if (socket.readyState === WebSocket.OPEN)
+                        socket.send(JSON.stringify({ t: "cerrar" }));
+                    socket.close();
+                    return cerrandose;
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=puenteWebSocket.js.map

package/dist/agent/remoto/puenteWebSocket.js.map

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

package/dist/agent/remoto/tunelNgrok.js

@@ -0,0 +1,158 @@
+import { MOTIVOS_DEL_TUNEL, motivoDeDominioInaceptable, motivoDeSalidaDeNgrok, servidorDeTunel } from "../../core/tunel.js";
+import { authtokenDeNgrok, cargarSdkReal } from "./ngrokEnMaquina.js";
+import { cargarServidorRemoto } from "./puenteWebSocket.js";
+/** Lo que se espera a que ngrok dé la dirección pública. */
+export const TOPE_DE_TUNEL_MS = 30_000;
+/** Lo que se espera a que el SDK reconecte tras perder la conexión, antes de dar el túnel por caído. */
+export const ESPERA_DE_RECONEXION_MS = 30_000;
+class FalloDelTunel extends Error {
+}
+/** El motivo de un error del SDK, por su CÓDIGO y nunca por su texto. */
+function motivoDeErrorDelSdk(error) {
+    const codigo = error?.errorCode;
+    return MOTIVOS_DEL_TUNEL[motivoDeSalidaDeNgrok(typeof codigo === "string" ? [codigo] : [])];
+}
+export function crearTunelNgrok(deps = {}) {
+    const cargarServidor = deps.cargarServidor ?? (() => cargarServidorRemoto());
+    const cargarSdk = deps.cargarSdk ?? cargarSdkReal;
+    const authtoken = deps.authtoken ?? (() => authtokenDeNgrok());
+    const topeMs = deps.topeMs ?? TOPE_DE_TUNEL_MS;
+    const esperaDeReconexionMs = deps.esperaDeReconexionMs ?? ESPERA_DE_RECONEXION_MS;
+    return {
+        async abrir({ dominio }) {
+            if (dominio !== undefined && motivoDeDominioInaceptable(dominio) !== undefined) {
+                throw new FalloDelTunel(MOTIVOS_DEL_TUNEL.dominio);
+            }
+            const sdk = await cargarSdk();
+            if (sdk === undefined)
+                throw new FalloDelTunel(MOTIVOS_DEL_TUNEL.noInstalado);
+            const token = authtoken();
+            if (token === undefined)
+                throw new FalloDelTunel(MOTIVOS_DEL_TUNEL.autenticacion);
+            const modulo = await cargarServidor();
+            if (modulo === undefined)
+                throw new FalloDelTunel(MOTIVOS_DEL_TUNEL.paqueteViejo);
+            let puente;
+            try {
+                puente = await modulo.arrancarServidor({ puerto: 0 });
+            }
+            catch {
+                throw new FalloDelTunel(MOTIVOS_DEL_TUNEL.puente);
+            }
+            let puenteCerrado;
+            const cerrarPuente = () => (puenteCerrado ??= puente.cerrar().catch(() => { }));
+            // `host:puerto` tal como escucha el puente (127.0.0.1), y no «localhost», que puede resolver a ::1 y dejar a ngrok
+            // sin nadie al otro lado.
+            const destino = new URL(puente.urlHttp).host;
+            let cerrando = false;
+            let caida;
+            const caidas = [];
+            let reconexion;
+            let tunel;
+            let tunelCerrado;
+            const cerrarTunel = () => (tunelCerrado ??= (tunel?.close() ?? Promise.resolve()).catch(() => { }));
+            /** Un oyente que lanza no tumba la consola ni deja sin aviso a los demás. */
+            const avisar = (f, motivo) => {
+                if (cerrando)
+                    return;
+                try {
+                    f(motivo);
+                }
+                catch {
+                    // es de quien escucha
+                }
+            };
+            const darPorCaido = () => {
+                if (cerrando || caida !== undefined)
+                    return;
+                caida = cerrarTunel()
+                    .then(() => cerrarPuente())
+                    .then(() => MOTIVOS_DEL_TUNEL.seCerro);
+                void caida.then((m) => {
+                    for (const f of caidas.splice(0))
+                        avisar(f, m);
+                });
+            };
+            const alCambiarEstado = (estado) => {
+                if (estado === "closed") {
+                    if (reconexion === undefined && !cerrando) {
+                        reconexion = setTimeout(darPorCaido, esperaDeReconexionMs);
+                        reconexion.unref?.();
+                    }
+                }
+                else if (estado === "connected" && reconexion !== undefined) {
+                    clearTimeout(reconexion);
+                    reconexion = undefined;
+                }
+            };
+            let tope;
+            let agotado = false;
+            try {
+                const abierto = sdk.forward({
+                    addr: destino,
+                    authtoken: token,
+                    ...(dominio === undefined ? {} : { domain: dominio }),
+                    onStatusChange: alCambiarEstado,
+                });
+                // Si llega DESPUÉS del tope, se cierra: nadie lo va a usar.
+                void abierto.then((t) => {
+                    if (agotado)
+                        void t.close().catch(() => { });
+                }, () => { });
+                tunel = await Promise.race([
+                    abierto,
+                    new Promise((_, rechazar) => {
+                        tope = setTimeout(() => {
+                            agotado = true;
+                            rechazar(new FalloDelTunel(MOTIVOS_DEL_TUNEL.sinDireccion));
+                        }, topeMs);
+                    }),
+                ]);
+            }
+            catch (error) {
+                cerrando = true;
+                await cerrarPuente();
+                throw error instanceof FalloDelTunel ? error : new FalloDelTunel(motivoDeErrorDelSdk(error));
+            }
+            finally {
+                if (tope !== undefined)
+                    clearTimeout(tope);
+            }
+            let servidor;
+            try {
+                const publica = tunel.url();
+                if (publica === null)
+                    throw new Error("sin dirección");
+                servidor = servidorDeTunel(publica);
+            }
+            catch {
+                cerrando = true;
+                await cerrarTunel();
+                await cerrarPuente();
+                throw new FalloDelTunel(MOTIVOS_DEL_TUNEL.sinDireccion);
+            }
+            let cerrado;
+            return {
+                servidor,
+                cerrar: () => (cerrado ??= (async () => {
+                    cerrando = true;
+                    caidas.length = 0;
+                    if (reconexion !== undefined)
+                        clearTimeout(reconexion);
+                    await cerrarTunel();
+                    await cerrarPuente();
+                })()),
+                alCaer: (f) => {
+                    if (cerrando)
+                        return;
+                    if (caida !== undefined) {
+                        void caida.then((m) => avisar(f, m));
+                        return;
+                    }
+                    caidas.push(f);
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=tunelNgrok.js.map

package/dist/agent/remoto/tunelNgrok.js.map

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

package/dist/core/idiomaDeLaRespuesta.js

@@ -0,0 +1,38 @@
+/**
+ * **Una respuesta que se fue al CHINO**, medida con reglas de código y no con otro modelo.
+ *
+ * Medido en Maset: tras un turno largo, `deepseek-flash` escribió la respuesta FINAL entera en chino, con su propio
+ * razonamiento diciendo justo antes «write the final answer in Spanish». La regla del idioma (`IDIOMA_DE_LA_RESPUESTA`)
+ * le había llegado y la había entendido: es una deriva del modelo, no un prompt que falte, así que el arreglo es código.
+ * Solo se reconoce el chino (lo único visto); una deriva a otro idioma no la ve esta regla.
+ */
+/** Ideogramas CJK unificados: el chino escrito. El japonés los usa también, y entonces se mira la petición. */
+const HAN = /[㐀-䶿一-鿿]/gu;
+/** Letras de cualquier escritura: la base contra la que se mide la proporción. */
+const LETRA = /\p{L}/gu;
+/** Por debajo de esto no se juzga: un nombre de producto en chino no es una respuesta en chino. */
+export const MINIMO_DE_IDEOGRAMAS = 20;
+/** Qué parte de las letras de la respuesta tienen que ser ideogramas para darla por escrita en chino. */
+export const PROPORCION_EN_CHINO = 0.3;
+function proporcionHan(texto) {
+    const han = texto.match(HAN)?.length ?? 0;
+    const letras = texto.match(LETRA)?.length ?? 0;
+    return { han, proporcion: letras === 0 ? 0 : han / letras };
+}
+/** ¿La respuesta está escrita en chino y quien pide NO escribe en chino? Una petición con ideogramas no se corrige. */
+export function respuestaEnChinoSinPedirlo(respuesta, peticion) {
+    const r = proporcionHan(respuesta);
+    if (r.han < MINIMO_DE_IDEOGRAMAS || r.proporcion < PROPORCION_EN_CHINO)
+        return false;
+    return (peticion.match(HAN)?.length ?? 0) === 0;
+}
+/** Hasta dónde se cita el mensaje del usuario en la orden de reescribir: lo justo para que se vea su idioma. */
+export const TOPE_DE_CITA_DEL_USUARIO = 200;
+/** El mensaje que le devuelve al modelo su respuesta para que la reescriba, sin herramientas y sin cambiar el contenido. */
+export function textoDeReescritura(peticion) {
+    const cita = peticion.trim().slice(0, TOPE_DE_CITA_DEL_USUARIO);
+    return ("[Aviso del harness] Tu última respuesta salió escrita en chino, y el usuario no escribe en chino. Reescríbela ENTERA " +
+        "en el idioma en que te escribe el usuario, sin cambiar su contenido, sin añadir nada y sin llamar a ninguna herramienta. " +
+        `Su mensaje empezaba así: «${cita}»`);
+}
+//# sourceMappingURL=idiomaDeLaRespuesta.js.map

package/dist/core/idiomaDeLaRespuesta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idiomaDeLaRespuesta.js","sourceRoot":"","sources":["../../src/core/idiomaDeLaRespuesta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+GAA+G;AAC/G,MAAM,GAAG,GAAG,YAAY,CAAC;AACzB,kFAAkF;AAClF,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,mGAAmG;AACnG,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,yGAAyG;AACzG,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC/C,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,EAAE,CAAC;AAC9D,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,0BAA0B,CAAC,SAAiB,EAAE,QAAgB;IAC5E,MAAM,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC,GAAG,GAAG,oBAAoB,IAAI,CAAC,CAAC,UAAU,GAAG,mBAAmB;QAAE,OAAO,KAAK,CAAC;IACrF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,gHAAgH;AAChH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,4HAA4H;AAC5H,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAChE,OAAO,CACL,uHAAuH;QACvH,2HAA2H;QAC3H,6BAA6B,IAAI,GAAG,CACrC,CAAC;AACJ,CAAC"}

package/dist/core/panorama.js

@@ -0,0 +1,93 @@
+/** Cuántas tareas terminadas viajan (las más recientes por `acabada`). */
+export const TAREAS_TERMINADAS_EN_PANORAMA = 5;
+export const CARACTERES_DE_TITULO = 120;
+export const CARACTERES_DE_MOTIVO = 400;
+/** Líneas de diff por fichero; pasadas esas, se recorta y se marca `recortada`. */
+export const LINEAS_DE_DIFF_EN_PANORAMA = 200;
+/** El feedback que el móvil manda a una tarea se recorta a esto. */
+export const CARACTERES_DE_FEEDBACK = 4000;
+/** Como mucho una vez por este intervalo se manda un panorama nuevo a los móviles. */
+export const INTERVALO_DE_PANORAMA_MS = 1000;
+const URGENCIA = { "esperando-aprobacion": 0, "esperando-respuesta": 1, trabajando: 2, parada: 3 };
+const ORDEN_DE_TAREA = { "requiere-atencion": 0, "en-proceso": 1, nuevo: 2, terminada: 3 };
+const recortarTexto = (t, tope) => (t.length <= tope ? t : `${t.slice(0, Math.max(0, tope - 1))}…`);
+function estadoDe(c) {
+    if (c.aprobacion !== undefined)
+        return "esperando-aprobacion";
+    if (c.preguntaPendiente)
+        return "esperando-respuesta";
+    if (c.turnoEnVuelo)
+        return "trabajando";
+    return "parada";
+}
+function aprobacionRecortada(a) {
+    let recortada = false;
+    const diffs = {};
+    for (const [id, lineas] of Object.entries(a.diffs)) {
+        if (lineas.length > LINEAS_DE_DIFF_EN_PANORAMA) {
+            diffs[id] = lineas.slice(0, LINEAS_DE_DIFF_EN_PANORAMA);
+            recortada = true;
+        }
+        else
+            diffs[id] = lineas;
+    }
+    return { pendientes: a.pendientes, ficheros: a.ficheros, diffs, ...(recortada ? { recortada: true } : {}) };
+}
+function tareaRecortada(t) {
+    const { motivo, ...resto } = t;
+    return {
+        ...resto,
+        titulo: recortarTexto(t.titulo, CARACTERES_DE_TITULO),
+        ...(t.estado === "requiere-atencion" && motivo !== undefined ? { motivo: recortarTexto(motivo, CARACTERES_DE_MOTIVO) } : {}),
+    };
+}
+const cmp = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+/**
+ * Pone cada tarea con `tras` justo detrás de su anterior, si esa viaja también. Tolera ciclos.
+ * Una anterior TERMINADA ya no retiene (`siguientesAEjecutar`): la siguiente se queda en su bloque
+ * de prioridad y no se va al de las terminadas. Y una tarea que se nombra a sí misma no se mueve.
+ */
+function respetandoTras(lista) {
+    const salida = [...lista];
+    for (let pasada = 0; pasada < lista.length; pasada++) {
+        let movida = false;
+        for (const t of [...salida]) {
+            if (t.tras === undefined || t.tras === t.id)
+                continue;
+            const iAnterior = salida.findIndex((x) => x.id === t.tras);
+            const iT = salida.indexOf(t);
+            if (iAnterior === -1 || salida[iAnterior].estado === "terminada" || iT > iAnterior)
+                continue;
+            salida.splice(iT, 1);
+            salida.splice(salida.findIndex((x) => x.id === t.tras) + 1, 0, t);
+            movida = true;
+        }
+        if (!movida)
+            break;
+    }
+    return salida;
+}
+export function componerPanorama(entrada) {
+    const consolas = entrada.consolas
+        .map((c) => ({
+        id: c.id,
+        proyecto: c.proyecto,
+        ...(c.sesion !== undefined ? { sesion: c.sesion } : {}),
+        foco: c.foco,
+        estado: estadoDe(c),
+        ...(c.ultimaActividad !== undefined ? { ultimaActividad: c.ultimaActividad } : {}),
+        ...(c.aprobacion !== undefined ? { aprobacion: aprobacionRecortada(c.aprobacion) } : {}),
+    }))
+        .sort((a, b) => Number(b.foco) - Number(a.foco) || URGENCIA[a.estado] - URGENCIA[b.estado]);
+    const vivas = entrada.tareas
+        .filter((t) => t.estado !== "terminada")
+        .sort((a, b) => ORDEN_DE_TAREA[a.estado] - ORDEN_DE_TAREA[b.estado] || cmp(a.creada, b.creada));
+    const terminadas = entrada.tareas
+        .filter((t) => t.estado === "terminada")
+        .sort((a, b) => cmp(b.acabada ?? b.creada, a.acabada ?? a.creada))
+        .slice(0, TAREAS_TERMINADAS_EN_PANORAMA);
+    const tareas = respetandoTras([...vivas, ...terminadas]).map(tareaRecortada);
+    const esperando = consolas.reduce((n, c) => n + (c.aprobacion?.pendientes.length ?? 0), 0) + tareas.filter((t) => t.estado === "requiere-atencion").length;
+    return { clase: "panorama", consolas, tareas, esperando };
+}
+//# sourceMappingURL=panorama.js.map

package/dist/core/panorama.js.map

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

package/dist/core/ports.js

@@ -460,4 +460,104 @@ export class ConectoresEnMemoria {
         return this.conectores[id]?.respuesta ?? "";
     }
 }
+/** El doble: deja al test hacer de servidor y de móviles, y apunta lo enviado. */
+export class PuenteRemotoEnMemoria {
+    [ES_DOBLE] = true;
+    aperturas = [];
+    enviados = [];
+    cerrados = 0;
+    /**
+     * Un registro POR canal abierto: el real tiene sockets viejos que aún pueden hablar tras
+     * cerrarse o reemplazarse, y sin poder disparar eventos de uno viejo ese fallo no se probaría.
+     */
+    canales = [];
+    async abrir(servidor, escuchas) {
+        this.aperturas.push(servidor);
+        const registro = { servidor, escuchas, cerrado: false, enviados: [] };
+        this.canales.push(registro);
+        return {
+            enviar: async (para, mensaje) => {
+                this.enviados.push({ para, mensaje });
+                registro.enviados.push({ para, mensaje });
+            },
+            cerrar: async () => {
+                registro.cerrado = true;
+                this.cerrados += 1;
+            },
+        };
+    }
+    ultimo() {
+        return this.canales.at(-1)?.escuchas;
+    }
+    /** Lo que haría el servidor real; sin índice, sobre el canal MÁS RECIENTE. */
+    abierta(url = "https://remoto.example/r/SALA#SECRETO", canal) {
+        (canal === undefined ? this.ultimo() : this.canales[canal]?.escuchas)?.alEstado({ estado: "abierta", url });
+    }
+    presencia(...moviles) {
+        this.ultimo()?.alPresencia(moviles);
+    }
+    presenciaDe(canal, ...moviles) {
+        this.canales[canal]?.escuchas.alPresencia(moviles);
+    }
+    delMovil(de, mensaje) {
+        this.ultimo()?.alMensaje(de, mensaje);
+    }
+    cerrada(motivo, canal) {
+        (canal === undefined ? this.ultimo() : this.canales[canal]?.escuchas)?.alEstado(motivo === undefined ? { estado: "cerrada" } : { estado: "cerrada", motivo });
+    }
+    reconectando(canal) {
+        (canal === undefined ? this.ultimo() : this.canales[canal]?.escuchas)?.alEstado({ estado: "reconectando" });
+    }
+}
+/** El doble: apunta aperturas y cierres, y deja al test elegir la dirección, un fallo o la caída. */
+export class TunelEnMemoria {
+    [ES_DOBLE] = true;
+    aperturas = [];
+    cerrados = 0;
+    /** El `servidor` que devuelve la próxima apertura. */
+    servidor = "wss://tunel.example/ws";
+    /** Con valor, la próxima apertura LANZA con este motivo (y se consume). */
+    fallo;
+    /** Un registro por túnel abierto: cerrado o caído ya no avisa, como el real. */
+    tuneles = [];
+    async abrir(o) {
+        this.aperturas.push({ ...o });
+        if (this.fallo !== undefined) {
+            const motivo = this.fallo;
+            this.fallo = undefined;
+            throw new Error(motivo);
+        }
+        const registro = { escuchas: [], cerrado: false, caido: undefined };
+        this.tuneles.push(registro);
+        return {
+            servidor: this.servidor,
+            cerrar: async () => {
+                if (registro.cerrado)
+                    return;
+                registro.cerrado = true;
+                registro.escuchas.length = 0;
+                this.cerrados += 1;
+            },
+            alCaer: (f) => {
+                if (registro.cerrado)
+                    return;
+                if (registro.caido !== undefined) {
+                    const motivo = registro.caido;
+                    queueMicrotask(() => f(motivo));
+                    return;
+                }
+                registro.escuchas.push(f);
+            },
+        };
+    }
+    /** Lo que haría ngrok al salir solo; sin índice, el túnel MÁS RECIENTE. Una vez por túnel. */
+    caer(motivo, tunel) {
+        const registro = tunel === undefined ? this.tuneles.at(-1) : this.tuneles[tunel];
+        if (registro === undefined || registro.cerrado || registro.caido !== undefined)
+            return;
+        registro.caido = motivo;
+        for (const f of registro.escuchas.splice(0))
+            f(motivo);
+    }
+}
 //# sourceMappingURL=ports.js.map