xonecode 0.2.0 → 0.5.0

package/dist/agent/arbolDeProyecto.js

@@ -0,0 +1,245 @@
+import { existsSync } from "node:fs";
+import { open, readFile, realpath, stat } from "node:fs/promises";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { ficherosDelProyecto } from "./turnoReal.js";
+import { puedeLeerRuta } from "./perfiles.js";
+import { esVistaAplanada } from "./proyecto.js";
+/**
+ * El proyecto tal como lo enseña la pestaña Ficheros de la consola web: el árbol y el
+ * contenido de un fichero, de SOLO lectura.
+ *
+ * Lo que se lista y lo que se lee es lo mismo que ve el agente, con las mismas reglas y
+ * por las mismas funciones: `puedeLeerRuta` (la barrera de las tools propias) y
+ * `esVistaAplanada` (los `.xml` que genera XOne Studio no se tocan). Reescribirlas aquí
+ * sería la segunda copia que diverge el primer día.
+ */
+/** Profundidad del árbol de la web: sin tope práctico (el del Tab es 4). */
+export const PROFUNDIDAD_DEL_ARBOL = 32;
+/** Entradas a partir de las cuales el árbol se recorta y lo dice. */
+export const TOPE_DE_ENTRADAS = 5_000;
+/** Bytes de contenido que viajan como mucho: el mismo tope que el parche de Revisión. */
+export const TOPE_DE_FICHERO = 400_000;
+/** Ventana en la que un NUL delata un binario. */
+export const VENTANA_DE_BINARIO = 8_192;
+/**
+ * Bytes de IMAGEN que viajan como mucho. Tope propio y más alto que el del texto por dos
+ * razones: una imagen recortada no es una imagen a medias, es nada —el navegador pinta el
+ * icono roto—, así que aquí no hay término medio entre traerla entera y no traerla; y la
+ * codificación base64 infla un tercio, de modo que este tope son ~2,7 MB por el cable.
+ * Un mockup o un icono de un proyecto XOne caben de sobra; un PSD de veinte megas no, y
+ * eso se DICE en vez de colgar la pestaña.
+ */
+export const TOPE_DE_IMAGEN = 2_000_000;
+/**
+ * Extensión → tipo MIME de las imágenes que el visor sabe pintar. Tabla CERRADA y por
+ * EXTENSIÓN, no por olfateo del contenido: el `<img>` del navegador necesita un MIME en la
+ * URL de datos, y adivinarlo de los primeros bytes sería reimplementar `file(1)` para
+ * acabar en la misma lista. Un `Map` por lo mismo que `lenguajeDe` en el cliente: la
+ * extensión sale de un nombre de fichero y `constructor` resolvería una propiedad heredada.
+ *
+ * El SVG está aquí Y es texto: viaja con las dos cosas, para poder verlo pintado o leer su
+ * fuente. Se pinta con un `<img>` y una URL de datos —nunca inyectado en el DOM—, que es
+ * un contexto donde el navegador NO ejecuta el script que un SVG puede llevar dentro.
+ */
+const IMAGENES = new Map([
+    ["png", "image/png"],
+    ["jpg", "image/jpeg"],
+    ["jpeg", "image/jpeg"],
+    ["gif", "image/gif"],
+    ["webp", "image/webp"],
+    ["bmp", "image/bmp"],
+    ["ico", "image/x-icon"],
+    ["avif", "image/avif"],
+    ["svg", "image/svg+xml"],
+]);
+/** El MIME de una ruta si es una imagen que sabemos pintar, o `undefined`. */
+export function mimeDeImagen(ruta) {
+    const nombre = ruta.slice(ruta.lastIndexOf("/") + 1);
+    const punto = nombre.lastIndexOf(".");
+    if (punto <= 0)
+        return undefined;
+    return IMAGENES.get(nombre.slice(punto + 1).toLowerCase());
+}
+/** El motivo con el que se rechaza una vista aplanada. Uno solo: se comprueba dos veces. */
+const MOTIVO_APLANADA = "es una vista aplanada que genera XOne Studio; la fuente es el .xne del mismo nombre";
+const comparador = new Intl.Collator("es", { sensitivity: "base" });
+/**
+ * Carpetas antes que ficheros en cada nivel, y dentro alfabético sin distinguir mayúsculas.
+ * Se compara segmento a segmento: en el primero que difiere, si uno es hoja (último
+ * segmento de su ruta) y el otro carpeta, la carpeta va antes.
+ */
+export function ordenarRutas(rutas) {
+    return [...rutas].sort((a, b) => {
+        const sa = a.split("/");
+        const sb = b.split("/");
+        const n = Math.min(sa.length, sb.length);
+        for (let i = 0; i < n; i++) {
+            const aHoja = i === sa.length - 1;
+            const bHoja = i === sb.length - 1;
+            if (aHoja !== bHoja)
+                return aHoja ? 1 : -1;
+            if (sa[i] !== sb[i])
+                return comparador.compare(sa[i], sb[i]) || (sa[i] < sb[i] ? -1 : 1);
+        }
+        return sa.length - sb.length;
+    });
+}
+export function arbolDeProyecto(raiz) {
+    const todas = ficherosDelProyecto(raiz, 0, PROFUNDIDAD_DEL_ARBOL);
+    const visibles = [...todas].filter((r) => puedeLeerRuta(r) && !esVistaAplanada(r, todas)).map((r) => r.slice(1));
+    const ordenadas = ordenarRutas(visibles);
+    if (ordenadas.length > TOPE_DE_ENTRADAS)
+        return { rutas: ordenadas.slice(0, TOPE_DE_ENTRADAS), recortado: true };
+    return { rutas: ordenadas, recortado: false };
+}
+/**
+ * Por qué una ruta del cable no se acepta, o `undefined` si vale. Es la criba de balde,
+ * antes de tocar el disco: relativa, sin `.`/`..`/segmentos vacíos, y admitida por la
+ * barrera de lectura. La segunda criba —que el camino REAL siga dentro de la raíz— es de
+ * `leerFicheroDeProyecto`, porque necesita `realpath`.
+ */
+export function motivoDeRutaInaceptable(ruta) {
+    if (ruta === "")
+        return "la ruta está vacía";
+    if (isAbsolute(ruta) || ruta.startsWith("/") || ruta.startsWith("\\") || /^[A-Za-z]:/.test(ruta)) {
+        return "la ruta tiene que ser relativa al proyecto";
+    }
+    const segmentos = ruta.split(/[\\/]/);
+    if (segmentos.some((s) => s === "" || s === "." || s === "..")) {
+        return "la ruta no puede llevar «.», «..» ni segmentos vacíos";
+    }
+    if (!puedeLeerRuta(`/${segmentos.join("/")}`))
+        return "esa ruta no se enseña";
+    return undefined;
+}
+export async function leerFicheroDeProyecto(raiz, ruta) {
+    const rechazo = (error) => ({ ruta, recortado: false, binario: false, bytes: 0, error });
+    const motivo = motivoDeRutaInaceptable(ruta);
+    if (motivo !== undefined)
+        return rechazo(motivo);
+    // La misma regla que `esVistaAplanada` (un `.xml` con su `.xne` al lado), preguntada al
+    // disco en O(1) en vez de recorrer el árbol entero por cada fichero que se abre.
+    const normal = ruta.split(/[\\/]/).join("/");
+    if (normal.endsWith(".xml") && existsSync(resolve(raiz, `${normal.slice(0, -4)}.xne`))) {
+        return rechazo(MOTIVO_APLANADA);
+    }
+    let real;
+    let raizReal;
+    try {
+        raizReal = await realpath(raiz);
+        // Se resuelve con `normal`, no con `ruta`: en POSIX `path.resolve` trata «\» como
+        // carácter literal de nombre, así que una ruta con separadores de Windows pasaba la
+        // criba de vista aplanada (ya normalizada) y luego se buscaba en disco con la barra
+        // invertida sin traducir, fallando con «no existe» aunque el fichero SÍ estuviera.
+        real = await realpath(resolve(raiz, normal));
+    }
+    catch {
+        return rechazo("no existe");
+    }
+    // Un enlace simbólico dentro del proyecto que apunte fuera se queda aquí: la lección que
+    // el repo ya pagó con `virtualMode: true` en el backend del agente.
+    if (!real.startsWith(raizReal + sep))
+        return rechazo("está fuera del proyecto");
+    // **La barrera se aplica DOS veces, y una sola no basta.** La primera pasada es sobre el
+    // TEXTO que teclea el cliente (`motivoDeRutaInaceptable` y la criba de aplanadas de
+    // arriba): es de balde y evita tocar el disco. Esta segunda es sobre el camino que el
+    // disco ha resuelto DE VERDAD, y cierra tres agujeros medidos:
+    //  - En un sistema de ficheros que no distingue mayúsculas (APFS, NTFS) «.ENV» no es
+    //    «/.env» para `puedeLeerRuta`, pero abre `.env`. Lo mismo «.Xonecode/config.json».
+    //  - Un enlace simbólico DENTRO de la raíz que apunte a un fichero denegado
+    //    («enlace-env.txt» → «.env») o a una carpeta denegada («carpeta-enlazada» →
+    //    «.xonecode») pasa la comprobación de arriba, porque su camino real sí está dentro
+    //    del proyecto: lo que falla no es el sitio, es el destino.
+    //  - Un enlace a una vista aplanada («alias.xml» → «app/Clientes.xml») no tiene ningún
+    //    «alias.xne» al lado, así que la criba de balde no puede verlo.
+    // `realpath` canonicaliza las mayúsculas y sigue los enlaces, así que recomprobar sobre
+    // su resultado cierra los tres a la vez. Y sigue siendo una recomprobación y no una
+    // prohibición de enlaces: un enlace a un fichero que SÍ se enseña se lee con normalidad.
+    const relReal = relative(raizReal, real).split(sep).join("/");
+    if (!puedeLeerRuta(`/${relReal}`))
+        return rechazo("esa ruta no se enseña");
+    if (relReal.endsWith(".xml") && existsSync(`${real.slice(0, -4)}.xne`))
+        return rechazo(MOTIVO_APLANADA);
+    return leerContenidoDeFichero(real, ruta, mimeDeImagen(normal));
+}
+/**
+ * El CONTENIDO de un fichero cuyo camino REAL ya pasó su barrera: texto o imagen, con su
+ * tope, su codificación y las dos caras del SVG.
+ *
+ * Se extrajo de `leerFicheroDeProyecto` cuando los ARTEFACTOS de una sesión necesitaron lo
+ * mismo (`agent/artefactosEnDisco.ts`). Lo que NO se extrajo es la barrera: la de un
+ * fichero del proyecto y la de un artefacto son reglas distintas —una pregunta
+ * `puedeLeerRuta` y las vistas aplanadas, la otra que el nombre sea un segmento llano
+ * dentro de la carpeta de la sesión—, y fundirlas en un parámetro sería la clase de
+ * generalización que acaba dejando un agujero en el lado que no se estaba mirando.
+ *
+ * `real` es el camino ya resuelto con `realpath`; `ruta` es la que se enseña y viaja de
+ * vuelta, nunca la del disco. El `mime` lo decide quien llama porque cada lado lo saca de
+ * un nombre distinto, y de él dependen los dos caminos de aquí: la imagen que solo viaja
+ * entera y el SVG, que va con fuente y dibujo.
+ */
+export async function leerContenidoDeFichero(real, ruta, mime) {
+    const rechazo = (error) => ({ ruta, recortado: false, binario: false, bytes: 0, error });
+    const info = await stat(real);
+    if (!info.isFile())
+        return rechazo("no es un fichero");
+    const bytes = info.size;
+    // **Las imágenes se deciden por la EXTENSIÓN y ANTES de olfatear el NUL.** Al revés no
+    // funciona: un PNG lleva ceros en su propia cabecera (la longitud del primer trozo va en
+    // big-endian y empieza por `00 00`), así que todas caían por el camino del texto y salían
+    // como «es un fichero binario, no se enseña su contenido» — teniendo el visor delante.
+    // El SVG NO se atiende aquí: es texto, y sigue por el camino de abajo para poder enseñar
+    // también su fuente. Solo se le añade el dibujo al final, si no hubo que recortarlo.
+    if (mime !== undefined && mime !== "image/svg+xml") {
+        // Demasiado grande: se dice QUÉ es y cuánto pesa en vez de traer un trozo. Media imagen
+        // no es media información, es el icono roto del navegador. `binario` sigue siendo
+        // cierto —no hay texto que enseñar— y el `mime` viaja igualmente: es lo que le permite
+        // al visor decir «una imagen de 12 MB» en lugar de «un binario».
+        if (bytes > TOPE_DE_IMAGEN)
+            return { ruta, recortado: false, binario: true, bytes, mime };
+        const datos = await readFile(real);
+        return { ruta, recortado: false, binario: true, bytes, mime, base64: datos.toString("base64") };
+    }
+    const fh = await open(real, "r");
+    try {
+        const buffer = Buffer.alloc(Math.min(info.size, TOPE_DE_FICHERO + 1));
+        const { bytesRead } = await fh.read(buffer, 0, buffer.length, 0);
+        const leido = buffer.subarray(0, bytesRead);
+        if (leido.subarray(0, VENTANA_DE_BINARIO).includes(0)) {
+            return { ruta, recortado: false, binario: true, bytes };
+        }
+        const recortado = bytesRead > TOPE_DE_FICHERO;
+        const cuerpo = recortado ? leido.subarray(0, TOPE_DE_FICHERO) : leido;
+        const { texto, codificacion } = decodificar(cuerpo, recortado);
+        // El SVG viaja con las dos caras: la fuente que se acaba de decodificar y el dibujo
+        // para pintarlo. El dibujo solo si el fichero entró ENTERO —un SVG cortado por la mitad
+        // no abre— y solo desde el mismo cuerpo que ya está en memoria.
+        if (mime === "image/svg+xml" && !recortado) {
+            return { ruta, texto, recortado, binario: false, bytes, codificacion, mime, base64: Buffer.from(cuerpo).toString("base64") };
+        }
+        return { ruta, texto, recortado, binario: false, bytes, codificacion };
+    }
+    finally {
+        await fh.close();
+    }
+}
+/**
+ * UTF-8 estricto, y si no lo es, latin1 (que en Node es windows-1252: lo que traen los
+ * proyectos XOne antiguos hechos en Windows). Cuando el cuerpo va RECORTADO el corte puede
+ * partir un carácter multibyte, y eso no es «no es UTF-8»: se reintenta quitando hasta tres
+ * bytes del final antes de dar el fichero por latin1.
+ */
+function decodificar(cuerpo, recortado) {
+    const estricto = new TextDecoder("utf-8", { fatal: true });
+    const intentos = recortado ? [0, 1, 2, 3] : [0];
+    for (const quitar of intentos) {
+        try {
+            return { texto: estricto.decode(cuerpo.subarray(0, cuerpo.length - quitar)), codificacion: "utf-8" };
+        }
+        catch {
+            // siguiente intento
+        }
+    }
+    return { texto: new TextDecoder("latin1").decode(cuerpo), codificacion: "latin1" };
+}
+//# sourceMappingURL=arbolDeProyecto.js.map

package/dist/agent/arbolDeProyecto.js.map

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

package/dist/agent/artefactosEnDisco.js

@@ -0,0 +1,139 @@
+/**
+ * Leer un ARTEFACTO de la sesión: lo que el agente dibujó y no es del proyecto.
+ *
+ * Los escribe el backend por la ruta virtual `/artefactos/<nombre>` (`agent/proyecto.ts`) y
+ * caen en `.xonecode/sesiones/<id>/artefactos/`. Esta es la puerta de vuelta, la que deja
+ * ENSEÑARLOS en la consola web: un HTML en un iframe, una imagen en su visor, y la
+ * descarga.
+ *
+ * Dos lectores y no uno, porque son dos transportes con necesidades opuestas:
+ *  - `leerArtefactoDeSesion` devuelve la misma forma que un fichero del proyecto
+ *    (`FicheroLeido`) para viajar por el CABLE: texto recortado al tope, imagen en base64,
+ *    codificación declarada. Así los visores del cliente son los MISMOS que los de la
+ *    pestaña Ficheros, sin una segunda familia de componentes.
+ *  - `leerArtefactoCrudo` devuelve los bytes tal cual para la RUTA HTTP, que es la única
+ *    forma de darle un documento a un iframe. Ahí no vale recortar —un HTML cortado no
+ *    abre— ni inflar un tercio con base64.
+ *
+ * **La carpeta `.xonecode` está denegada en todas partes, y esto no es una excepción a esa
+ * regla: es la razón de que la barrera de aquí sea propia.** El servidor estático rechaza
+ * `.xonecode` por el texto de la ruta y `puedeLeerRuta` la deniega al agente; lo que se
+ * abre aquí es UNA carpeta concreta de dentro, la de los artefactos de UNA sesión, y solo
+ * por nombre de fichero. Nada de este módulo acepta una ruta: acepta un nombre, y compone.
+ */
+import { readFile, realpath, stat } from "node:fs/promises";
+import { join, sep } from "node:path";
+import { RUTA_ARTEFACTOS, carpetaDeArtefactosDeSesion, esRutaDeArtefacto, mimeDeArtefacto, } from "../core/artefactos.js";
+import { leerContenidoDeFichero } from "./arbolDeProyecto.js";
+/**
+ * Bytes que la ruta HTTP sirve como mucho.
+ *
+ * No es el tope del cable (`TOPE_DE_FICHERO`, 400 KB) y no puede serlo: por aquí pasa el
+ * documento que el iframe pinta, y medio HTML no es medio panel — es una página rota. Un
+ * panel de `artifacts-builder` con sus datos horneados dentro ronda el megabyte, así que el
+ * tope está donde deja de ser un artefacto y empieza a ser un descuido; existe para que un
+ * fichero de 800 MB no se lea entero a memoria en la máquina del usuario, no para acotar lo
+ * que el agente puede dibujar.
+ */
+export const TOPE_DE_ARTEFACTO = 20_000_000;
+/**
+ * El camino REAL de un artefacto, o `undefined` si no se puede afirmar que sea uno.
+ *
+ * La barrera se aplica DOS veces, la misma disciplina que `leerFicheroDeProyecto` y por los
+ * mismos agujeros medidos allí:
+ *  - Sobre el TEXTO, de balde y antes de tocar el disco: `esRutaDeArtefacto` exige que cada
+ *    segmento sea texto llano, lo que deja fuera `..`, `.`, el hueco de un `//`, la barra
+ *    invertida de Windows, el NUL y un `%2e%2e` sin decodificar. Es la MISMA función que
+ *    decide que una escritura ahí no pide aprobación humana: una regla, no dos que puedan
+ *    divergir el día que alguien toque una.
+ *  - Sobre el camino que el disco resuelve DE VERDAD: un enlace simbólico dentro de la
+ *    carpeta cuyo destino esté fuera pasa la primera criba —su nombre es un segmento
+ *    llano— y solo se ve comparando el `realpath`. El agente no crea enlaces con
+ *    `write_file`, pero la carpeta está en el disco del usuario y quien la barra es esto.
+ */
+async function caminoDeArtefacto(raiz, sesion, nombre) {
+    if (!esRutaDeArtefacto(`${RUTA_ARTEFACTOS}${nombre}`))
+        return undefined;
+    let carpeta;
+    try {
+        // `segmentoSeguro` LANZA con un id que lleve separadores. El id lo pone el servidor y es
+        // un uuid, así que aquí no debería llegar nunca uno malo — y precisamente por eso se
+        // atrapa: el día que llegue, la respuesta tiene que ser un rechazo y no una excepción
+        // que suba hasta el manejador de la ruta.
+        carpeta = carpetaDeArtefactosDeSesion(raiz, sesion);
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        const carpetaReal = await realpath(carpeta);
+        const real = await realpath(join(carpeta, nombre));
+        if (!real.startsWith(carpetaReal + sep))
+            return undefined;
+        return real;
+    }
+    catch {
+        // No existe: ni la carpeta (una sesión que nunca dibujó nada no la tiene, y eso es lo
+        // normal) ni el fichero. Quien llama distingue las dos cosas de un rechazo.
+        return undefined;
+    }
+}
+/** ¿Se rechazó el NOMBRE, o simplemente no hay nada ahí? Son dos respuestas distintas y la
+ *  ruta HTTP las contesta con códigos distintos, así que la pregunta del texto se hace
+ *  aparte —es pura y de balde— en vez de deducirla del fallo del disco. */
+const nombreAceptable = (nombre) => esRutaDeArtefacto(`${RUTA_ARTEFACTOS}${nombre}`);
+/**
+ * Para el CABLE: la misma forma con la que viaja un fichero del proyecto.
+ *
+ * La `ruta` que vuelve es la VIRTUAL (`/artefactos/<nombre>`), nunca la del disco: el cable
+ * puede ir por un túnel, y es la misma regla por la que la ruta de una herramienta se queda
+ * en el host. El error tampoco la lleva.
+ */
+export async function leerArtefactoDeSesion(raiz, sesion, nombre) {
+    const ruta = `${RUTA_ARTEFACTOS}${nombre}`;
+    const rechazo = (error) => ({
+        ruta,
+        recortado: false,
+        binario: false,
+        bytes: 0,
+        error,
+    });
+    if (!nombreAceptable(nombre))
+        return rechazo("ese nombre no es de un artefacto");
+    const real = await caminoDeArtefacto(raiz, sesion, nombre);
+    if (real === undefined)
+        return rechazo("no existe");
+    // El mime se saca del NOMBRE que se pidió, no del camino real: es el nombre que el
+    // usuario ve y el que el agente eligió decir que era.
+    return leerContenidoDeFichero(real, ruta, mimeDeImagenDeArtefacto(nombre));
+}
+/**
+ * El mime SOLO si es una imagen que el visor sabe pintar.
+ *
+ * `leerContenidoDeFichero` usa este parámetro para elegir camino —imagen entera, o SVG con
+ * sus dos caras—, así que aquí no puede entrar el `text/html` de `mimeDeArtefacto`: un HTML
+ * es texto y tiene que seguir el camino del texto. La ruta HTTP sí quiere el mime completo,
+ * y por eso lo pide ella a `mimeDeArtefacto`.
+ */
+function mimeDeImagenDeArtefacto(nombre) {
+    const mime = mimeDeArtefacto(nombre);
+    return mime !== undefined && mime.startsWith("image/") ? mime : undefined;
+}
+/** Para la RUTA HTTP: los bytes, sin recortar y sin base64. Ver `TOPE_DE_ARTEFACTO`. */
+export async function leerArtefactoCrudo(raiz, sesion, nombre) {
+    if (!nombreAceptable(nombre))
+        return { ok: false, motivo: "rechazado" };
+    const real = await caminoDeArtefacto(raiz, sesion, nombre);
+    if (real === undefined)
+        return { ok: false, motivo: "no-existe" };
+    const info = await stat(real);
+    if (!info.isFile())
+        return { ok: false, motivo: "no-existe" };
+    // El tamaño se mira ANTES de leer: el tope existe para no traer 800 MB a memoria, y
+    // comprobarlo después de `readFile` no protegería de nada.
+    if (info.size > TOPE_DE_ARTEFACTO)
+        return { ok: false, motivo: "demasiado-grande" };
+    const mime = mimeDeArtefacto(nombre);
+    return { ok: true, nombre, datos: await readFile(real), ...(mime === undefined ? {} : { mime }) };
+}
+//# sourceMappingURL=artefactosEnDisco.js.map

package/dist/agent/artefactosEnDisco.js.map

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

package/dist/agent/aumentador.js

@@ -0,0 +1,175 @@
+import { textoDe } from "./puente.js";
+/** El papel del aumentador. Redacción con el proyecto delante: `trabajo`. */
+export const PAPEL_DEL_AUMENTADOR = "trabajo";
+/**
+ * Cuánto encargo se guarda.
+ *
+ * De este texto salen tres cosas: el `<textarea>` que una persona edita, el `encargo` que se
+ * escribe en el índice de la cola (que lleva ya el encargo entero de cada tarea) y la
+ * petición del turno. Un modelo que se venga arriba puede contestar veinte kilobytes de
+ * prosa; el tope es generoso porque esto ES un documento con apartados —al contrario que el
+ * resumen del juez, que es una frase— pero existe, y cuando muerde se DICE en el propio
+ * texto: un encargo cortado en seco parecería que la persona lo dejó a medias.
+ */
+export const TOPE_DE_ENCARGO = 8_000;
+/**
+ * No se pudo PREGUNTAR, o lo que contestó no es un encargo.
+ *
+ * Es fallo del ENTORNO y no del proyecto —la misma familia que `ErrorDelSimulador` y
+ * `ErrorDelJuezDeTarea`—, y es un tipo propio por lo mismo: quien lo recoge tiene que poder
+ * distinguirlo para encolar la tarea con el texto original en vez de dar el fallo por un
+ * encargo.
+ */
+export class ErrorDelAumentador extends Error {
+    constructor(motivo) {
+        super(`no se pudo preparar el encargo (papel «${PAPEL_DEL_AUMENTADOR}»): ${motivo}`);
+        this.name = "ErrorDelAumentador";
+    }
+}
+/**
+ * El `invocar` de PRODUCCIÓN, sobre `ModelosPort`.
+ *
+ * Es hermano de `invocarConModelos` (`agent/juezDeTarea.ts`) y **no se reutiliza aquél a
+ * propósito**: su error dice «no se pudo consultar al juez de QA», que aquí sería falso — y
+ * ese mensaje es lo que la ventana de crear le enseña a una persona. Dos frases distintas
+ * para dos operaciones distintas; lo que sí es idéntico, porque es la regla del repo, es el
+ * reparto entre los dos sitios de envoltura:
+ *
+ * - **Construir** el modelo del papel falla ANTES de tocar la red y con un mensaje escrito
+ *   para leerse («falta la credencial para nvidia (NVIDIA_API_KEY); usa /provider nvidia»).
+ *   Ese mensaje SÍ se conserva: es la única línea que dice qué hacer.
+ * - **Llamar** es otra cosa: ahí los SDK devuelven el cuerpo remoto, y ahí van claves
+ *   redactadas y cabeceras. De esa solo se conserva el NOMBRE del error — la misma regla que
+ *   `ErrorCatalogoModelos`: nunca la clave ni el cuerpo remoto. No es ser opaco, es no
+ *   filtrar secretos.
+ */
+export function invocarParaAumentar(modelos) {
+    return async (papel, prompt) => {
+        let modelo;
+        try {
+            modelo = modelos.paraPapel(papel);
+        }
+        catch (error) {
+            throw new ErrorDelAumentador(error instanceof Error ? error.message : String(error));
+        }
+        if (typeof modelo !== "object" ||
+            modelo === null ||
+            typeof modelo.invoke !== "function") {
+            // Un doble de modelos (`ModeloGuionizado`) devuelve `{guion}` y no sabe invocar.
+            throw new ErrorDelAumentador(`el modelo del papel «${papel}» no se puede invocar aquí`);
+        }
+        try {
+            const respuesta = await modelo.invoke(prompt);
+            // El MISMO extractor que el puente del stream, no una copia: dos reglas para sacar el
+            // texto de un mensaje son dos reglas que divergen — y una de ellas metería el
+            // razonamiento del modelo dentro del encargo.
+            return textoDe(respuesta);
+        }
+        catch (error) {
+            throw new ErrorDelAumentador(error instanceof Error ? error.name : "error de la llamada");
+        }
+    };
+}
+/**
+ * El prompt del aumentador.
+ *
+ * Lleva la petición, el proyecto y su rama, los adjuntos POR NOMBRE y la memoria del proyecto
+ * si existe. **No lleva la raíz** —es una ruta de la máquina, y está en la petición para
+ * resolver el papel `trabajo` contra el `config.json` del proyecto, no para el prompt— ni el
+ * árbol del proyecto, que sería contexto por gastar en una llamada cuyo trabajo es redactar.
+ *
+ * Y lo que le PROHÍBE es lo que este repo prohíbe en todas partes: inventarse nada de XOne
+ * (lo desconocido no da error, da un bug mudo) y dar por hecho un paso de aprobación humana
+ * que ya no existe.
+ */
+export function promptDelAumentador(peticion) {
+    const { proyecto, adjuntos } = peticion;
+    return [
+        "Eres el jefe de proyecto de un equipo que desarrolla aplicaciones XOne. Un desarrollador",
+        "ha apuntado lo que quiere en una frase, y tu trabajo es convertirla en un ENCARGO que",
+        "otro agente pueda ejecutar SOLO, de principio a fin.",
+        "",
+        `El proyecto es «${proyecto.nombre}»${proyecto.rama === undefined ? "" : `, rama «${proyecto.rama}»`}.`,
+        "",
+        "LO QUE HA PEDIDO, tal cual:",
+        peticion.texto,
+        "",
+        ...(peticion.memoria === undefined || peticion.memoria.trim() === ""
+            ? []
+            : ["Memoria del proyecto: decisiones ya tomadas que el encargo no debe contradecir.", peticion.memoria, ""]),
+        ...(adjuntos.length === 0
+            ? []
+            : [
+                `Ha anexado ${adjuntos.length} fichero(s), que el agente verá en «/adjuntos/» de solo lectura:`,
+                ...adjuntos.map((a) => `- ${a.nombre}${a.mime === undefined ? "" : ` (${a.mime})`}`),
+                "Di para qué sirve cada uno. Y AVISO que tienes que trasladarle: el agente puede LEER",
+                "una imagen como fichero, pero no la VE — no hay visión en este harness. No escribas un",
+                "criterio que dependa de mirar una captura.",
+                "",
+            ]),
+        "CÓMO SE EJECUTA ESTE ENCARGO, y esto cambia cómo hay que redactarlo:",
+        "la tarea corre SOLA, sin nadie delante, y APLICA sus escrituras sin pedir aprobación —la",
+        "autorización fue el acto de crear la tarea—. Así que el encargo describe un trabajo que se",
+        "hace ENTERO de una vez: una funcionalidad nueva, un refactor, un arreglo, documentación.",
+        "NO escribas ningún paso que espere a una persona («cuando lo apruebes», «pide",
+        "confirmación», «espera el visto bueno»): ese paso no existe y el agente se quedaría",
+        "esperando a alguien que no está. Si de verdad hace falta una decisión que solo puede tomar",
+        "el desarrollador, dile al agente que PARE y la pregunte, en vez de inventarse la respuesta.",
+        "",
+        "REGLAS DE XONE que el encargo no puede romper: XOne no es desarrollo web. Es XML en",
+        "ficheros `.xne`, JavaScript ES5 y un CSS propio; no hay DOM, ni async/await, ni React. Los",
+        "`.xml` los genera XOne Studio a partir del `.xne` y NO se tocan. XOne ignora en silencio lo",
+        "que no conoce, así que un atributo o una función inventada no da error: da un bug mudo.",
+        "No te inventes nombres de colecciones, de campos ni de funciones que no aparezcan en lo",
+        "que te han dado: si hace falta averiguarlos, el encargo dice que se averigüen leyendo el",
+        "proyecto.",
+        "",
+        "Contesta SOLO con el encargo, en markdown, con estos cuatro apartados y nada más:",
+        "## Qué hay que conseguir",
+        "## Criterios de aceptación (comprobables, uno por línea)",
+        "## Qué NO hay que tocar",
+        adjuntos.length === 0 ? "## Cómo empezar" : "## Adjuntos y para qué sirve cada uno",
+    ].join("\n");
+}
+/**
+ * El encargo tal como se guarda: sin caracteres de control, acotado, y nunca vacío.
+ *
+ * **Los saltos de línea y los tabuladores se conservan**, al contrario que en el resumen del
+ * juez (`unaFrase`): esto es un documento con apartados que se pinta en un `<textarea>`, no
+ * un rótulo de una tarjeta. Lo que se va es el resto de los controles, por lo mismo de
+ * siempre — acaban en el cable y en el índice.
+ *
+ * **Una respuesta vacía es un FALLO y no un encargo.** Encolar con el encargo en blanco
+ * mandaría al agente a trabajar sin nada que hacer; y el camino de reserva ya existe y es
+ * mejor: el texto original de la persona.
+ */
+export function encargoDeTexto(texto) {
+    const limpio = texto.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]+/g, "").trim();
+    if (limpio === "")
+        throw new ErrorDelAumentador("el modelo contestó en blanco");
+    if (limpio.length <= TOPE_DE_ENCARGO)
+        return limpio;
+    // Cortado y DICHO: en seco parecería que la persona lo dejó a medias.
+    return `${limpio.slice(0, TOPE_DE_ENCARGO)}\n\n[el encargo propuesto se recortó aquí: no cabía entero]`;
+}
+export function crearAumentador(opciones) {
+    return {
+        augmentar: async (peticion) => {
+            let texto;
+            try {
+                texto = await opciones.invocar(PAPEL_DEL_AUMENTADOR, promptDelAumentador(peticion), peticion.proyecto.raiz);
+            }
+            catch (error) {
+                // Lo que ya viene envuelto se deja: `invocarParaAumentar` distingue el fallo de
+                // CONSTRUIR (cuyo mensaje es el accionable) del de LLAMAR (cuyo cuerpo no se
+                // repite). Cualquier otro `invocar` puede lanzar lo que sea, y entonces solo se
+                // conserva el nombre del error — la regla de `ErrorCatalogoModelos`.
+                if (error instanceof ErrorDelAumentador)
+                    throw error;
+                throw new ErrorDelAumentador(error instanceof Error ? error.name : "error al preguntar");
+            }
+            return encargoDeTexto(texto);
+        },
+    };
+}
+//# sourceMappingURL=aumentador.js.map

package/dist/agent/aumentador.js.map

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