xonecode 0.3.0 → 0.5.1

package/dist/cli/wizardInicial.js

@@ -0,0 +1,240 @@
+/**
+ * El asistente de cuenta: proveedor y modelo, la primera vez.
+ *
+ * No hace falta una marca de «primer arranque»: la resolución de modelos ya guarda de
+ * dónde salió cada valor. Si `trabajo` resuelve por `omisión`, nadie ha elegido nunca.
+ * Un flag aparte sería una segunda fuente de verdad sobre algo que el sistema ya sabe.
+ *
+ * **Es un LAZO, no una escalera.** Elegir proveedor era irreversible: quien se equivocaba
+ * solo podía cancelar el asistente entero y quedarse con el modelo por omisión sin
+ * saberlo. Ahora hay dos vueltas atrás y las dos son explícitas:
+ * - una opción «volver» al final de la lista de modelos (`ID_VOLVER`), y
+ * - el catálogo que FALLA, que devuelve al paso de proveedor con el motivo delante en vez
+ *   de dar el paso por bueno.
+ *
+ * **Listar el catálogo ES la validación de la conexión.** Es una llamada real al proveedor
+ * con la credencial recién escrita: si no autoriza, no contesta o no ofrece ningún modelo
+ * de conversación, la cuenta NO está resuelta. Antes esos tres casos escribían una línea y
+ * seguían adelante con el modelo de omisión — un fallo mudo con forma de aviso. Y como la
+ * clave se vuelve a pedir cuando el catálogo de ese proveedor ya falló una vez en esta
+ * llamada, una clave mal tecleada se corrige sin salir del asistente: `hayCredencial`
+ * diría que sí (está en disco desde el intento anterior) y no volvería a preguntarla.
+ *
+ * **Quién puede cancelar lo decide quien llama** (`exigirEleccion`). En el terminal
+ * cancelar sigue significando cancelar: se sigue con el modelo por omisión, que es una
+ * consola perfectamente usable (Ollama local). En la consola web el paso de cuenta es una
+ * PUERTA —no se entra al dashboard sin cuenta—, así que cancelar vuelve a preguntar con el
+ * motivo delante. El único final de ese lazo es que se elija algo o que el humano se vaya,
+ * y eso se mira por `consola.eof?.()`: solo se insiste mientras conste que hay alguien al
+ * otro lado. Una consola que no implemente `eof` no puede afirmarlo, así que no se insiste
+ * — un lazo que no sabe si queda alguien es un lazo que no termina.
+ *
+ * Ese lazo apoya en una condición que las dos pieles con selector cumplen y que conviene
+ * decir en voz alta: **`seleccionar` espera a un humano o vence por plazo**; no resuelve al
+ * instante mientras `eof()` diga que hay alguien (`consolaWeb.ts#esperarAUnHumano`, y el
+ * modal de la TUI). Una implementación que devolviera `undefined` de inmediato CON alguien
+ * conectado convertiría este lazo en una rueda: no se acota con un contador a propósito,
+ * porque un tope sería una puerta que se abre sola a la vuelta N — justo lo que este paso
+ * existe para impedir.
+ */
+import { motivoDeClaveInaceptable } from "../core/config.js";
+import { PROVEEDORES, PAPELES, SIN_CREDENCIAL } from "../core/modelos.js";
+/**
+ * La opción «volver» de la lista de modelos. El id lleva una flecha a propósito: tiene que
+ * ser imposible de confundir con el id de un modelo del catálogo, que es lo único que
+ * comparte lista con ella. Va la ÚLTIMA de la lista, detrás de los modelos de verdad.
+ */
+export const ID_VOLVER = "←proveedor";
+/** Lo que se dice al insistir: por qué se vuelve a preguntar lo mismo. */
+const AVISO_HACE_FALTA = "hace falta un proveedor con conexión y un modelo elegido para seguir; sin eso no se puede continuar.";
+/**
+ * Los proveedores sin credencial (hoy, Ollama local) primero: es la omisión del repo
+ * («Ollama por omisión, y a propósito», `core/modelos.ts`) y la ruta sin fricción para
+ * quien arranca sin ninguna clave a mano. `filter` en vez de un `sort` con aritmética
+ * porque es más fácil de leer y el resultado es el mismo.
+ */
+function proveedoresParaElAsistente() {
+    return [
+        ...PROVEEDORES.filter((p) => SIN_CREDENCIAL.has(p)),
+        ...PROVEEDORES.filter((p) => !SIN_CREDENCIAL.has(p)),
+    ];
+}
+function detalleDe(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export async function asistenteDeModelo(consola, contexto) {
+    // Ya hay una elección (proyecto, global, bandera o entorno): no se pregunta.
+    if (contexto.origenDeTrabajo !== "omision")
+        return "sin-preguntar";
+    // Sin TTY no se pregunta NADA: las tuberías y `xonecode run` deben seguir dando una
+    // salida byte-idéntica.
+    if (!consola.interactivo || consola.seleccionar === undefined)
+        return "sin-preguntar";
+    const seleccionar = consola.seleccionar;
+    /**
+     * Solo se insiste mientras CONSTE que hay alguien: `eof()` ausente no vale como «hay
+     * humano», porque entonces el lazo no tendría final. La consola web sí lo implementa
+     * (`consolaWeb.ts`: `eof = !transporte.conectado()`), que es donde se pide insistir.
+     */
+    const insistir = () => contexto.exigirEleccion === true && consola.eof?.() === false;
+    /** Los proveedores cuyo catálogo ya falló en ESTA llamada: a esos se les vuelve a pedir
+     *  la clave aunque `hayCredencial` diga que la hay (la hay, si llegó a escribirse). */
+    const fallaron = new Set();
+    let aviso = contexto.aviso;
+    /**
+     * Escribe la credencial y lo DICE. Devuelve `undefined` si no se pudo escribir, con el
+     * motivo ya puesto en `aviso` — el caso real es `AuthRotoEnDisco`: un `auth.json` con el
+     * JSON estropeado no se sobrescribe. Antes esa excepción subía hasta quien conduce el
+     * paso, que en la web deja el paso a medias y ANUNCIA el alta igual.
+     */
+    const escribirCredencial = (proveedor, clave) => {
+        try {
+            const guardada = contexto.guardarCredencial?.(proveedor, clave);
+            if (guardada !== undefined) {
+                // Se dice en el momento: si el usuario cancela en el paso de MODELO que viene
+                // después, el «asistente cancelado» no puede ser la única frase que vea —
+                // dejaría creer que no se tocó nada, y la credencial ya está en disco.
+                consola.escribir(`credencial de ${proveedor} guardada en ${guardada.ruta}\n`);
+            }
+            return guardada ?? { ruta: "" };
+        }
+        catch (error) {
+            aviso = `no se pudo guardar la credencial de ${proveedor}: ${detalleDe(error)}`;
+            consola.escribir(`${aviso}\n`);
+            return undefined;
+        }
+    };
+    /** Cancelar: o se sale diciéndolo, o se vuelve a preguntar con el motivo delante. */
+    const cancelar = () => {
+        if (insistir()) {
+            aviso = AVISO_HACE_FALTA;
+            return undefined;
+        }
+        consola.escribir("asistente cancelado; se usa el modelo por omisión\n");
+        return "cancelado";
+    };
+    for (;;) {
+        const enCurso = aviso;
+        aviso = undefined;
+        /**
+         * La clave recién tecleada que todavía NO está en disco: se escribe al final de ESTA
+         * vuelta, y solo si el catálogo del proveedor contesta. Vive dentro del lazo a
+         * propósito y no fuera: siendo del lazo, una vuelta que se va por un `continue` se la
+         * dejaba puesta, y la vuelta siguiente —otro proveedor— la escribía como suya.
+         * Medido: con `auth.json` roto, la clave tecleada para openai se intentaba guardar
+         * después bajo ollama, que ni pide credencial.
+         */
+        let clavePorEscribir;
+        const proveedor = (await seleccionar({
+            titulo: "Proveedor de modelos",
+            opciones: proveedoresParaElAsistente().map((p) => ({
+                id: p,
+                etiqueta: p,
+                detalle: SIN_CREDENCIAL.has(p) ? "local, no necesita clave" : "necesita una clave de API",
+            })),
+            // El motivo viaja EN el selector y no solo por `escribir`: la consola web no pinta
+            // el transcript durante el alta (`apps/web/src/App.tsx`, rama `enAlta`), así que un
+            // aviso que solo fuera un acto de sistema sería un fallo mudo justo en el paso que
+            // se está repitiendo. Las pieles de terminal lo ignoran: ahí el `escribir` ya está
+            // a la vista, encima del selector.
+            ...(enCurso === undefined ? {} : { aviso: enCurso }),
+        }));
+        if (proveedor === undefined || !PROVEEDORES.includes(proveedor)) {
+            const salida = cancelar();
+            if (salida !== undefined)
+                return salida;
+            continue;
+        }
+        if (!SIN_CREDENCIAL.has(proveedor) &&
+            (fallaron.has(proveedor) || contexto.hayCredencial?.(proveedor) === false)) {
+            // El enunciado dice CÓMO se sale, y solo donde eso es verdad: con `exigirEleccion`
+            // dejarlo en blanco devuelve al paso de proveedor (es la única vuelta atrás que
+            // tiene un campo de secreto, y sin decirlo no se descubre); sin él, en blanco
+            // cancela el asistente entero, que es lo que este enunciado dice desde siempre.
+            const clave = await consola.leerSecreto(insistir()
+                ? `clave de ${proveedor} (en blanco para elegir otro proveedor): `
+                : `clave de ${proveedor}: `);
+            if (clave.trim() === "") {
+                // Una clave vacía es la forma de cancelar que tiene un campo de secreto: se trata
+                // igual que cancelar el selector, ni mejor ni peor.
+                const salida = cancelar();
+                if (salida !== undefined)
+                    return salida;
+                continue;
+            }
+            // La criba de balde, antes de gastar una llamada: lo que el propio campo ya dice
+            // (una línea `NOMBRE=valor` pegada entera, comillas, espacios) no hace falta
+            // preguntárselo al proveedor. Ver `core/config.ts#motivoDeClaveInaceptable`.
+            const malaClave = motivoDeClaveInaceptable(clave);
+            if (malaClave !== undefined) {
+                aviso = `esa clave de ${proveedor} no vale: ${malaClave}`;
+                consola.escribir(`${aviso}\n`);
+                continue;
+            }
+            // Se APLICA al proceso y no se escribe: guardarla es lo último, y solo si el
+            // proveedor contesta. Sin `aplicarCredencial` no hay forma de probarla antes, así
+            // que ahí se conserva el orden viejo — escribir primero — y se dice dónde quedó.
+            clavePorEscribir = clave.trim();
+            if (contexto.aplicarCredencial !== undefined) {
+                contexto.aplicarCredencial(proveedor, clavePorEscribir);
+            }
+            else if (escribirCredencial(proveedor, clavePorEscribir) === undefined) {
+                continue;
+            }
+            else {
+                clavePorEscribir = undefined;
+            }
+        }
+        // La conexión de verdad: una llamada al catálogo del proveedor con la credencial
+        // puesta. Lo que falle aquí NO deja seguir — vuelve al paso de proveedor.
+        let modelos;
+        try {
+            modelos = await consola.catalogoModelos.listar(proveedor);
+        }
+        catch (error) {
+            aviso = `no se pudo conectar con ${proveedor}: ${detalleDe(error)}`;
+            consola.escribir(`${aviso}\n`);
+            fallaron.add(proveedor);
+            // La clave tecleada se queda EN EL AIRE y no llega al disco: `clavePorEscribir`
+            // muere con esta vuelta. Sigue aplicada al proceso —no estorba, y la vuelta
+            // siguiente la sustituye porque `fallaron` obliga a volver a pedirla.
+            continue;
+        }
+        if (modelos.length === 0) {
+            aviso = `${proveedor} no ofrece ningún modelo de conversación; elige otro proveedor.`;
+            consola.escribir(`${aviso}\n`);
+            fallaron.add(proveedor);
+            continue;
+        }
+        fallaron.delete(proveedor);
+        // El proveedor ha contestado: AHORA se escribe la clave, y no antes. Una clave que no
+        // sirve no llega nunca al disco — no hay nada que confesar porque no se guardó nada.
+        if (clavePorEscribir !== undefined && escribirCredencial(proveedor, clavePorEscribir) === undefined) {
+            continue;
+        }
+        const elegido = await seleccionar({
+            titulo: `Modelos de ${proveedor}`,
+            opciones: [
+                ...modelos.map((m) => ({ id: m.id, etiqueta: m.nombre ?? m.id, detalle: m.id })),
+                { id: ID_VOLVER, etiqueta: "← Elegir otro proveedor", detalle: "vuelve al paso anterior" },
+            ],
+        });
+        // Volver NO es cancelar: no se dice nada y no se toca nada, solo se repite el paso.
+        if (elegido === ID_VOLVER)
+            continue;
+        if (elegido === undefined) {
+            const salida = cancelar();
+            if (salida !== undefined)
+                return salida;
+            continue;
+        }
+        // Un modelo para los tres papeles, como `/modelo`. Afinar por papel es opt-in con
+        // `/modelos`: preguntar tres veces antes de que nadie sepa qué es «afilado» es peaje.
+        const id = `${proveedor}/${elegido}`;
+        for (const papel of PAPELES)
+            consola.guardarModeloGlobal(papel, id);
+        consola.escribir(`→ ${id} guardado para los tres papeles\n`);
+        return "elegido";
+    }
+}
+//# sourceMappingURL=wizardInicial.js.map

package/dist/cli/wizardInicial.js.map

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

package/dist/core/actos.js

@@ -0,0 +1,113 @@
+/**
+ * Un acto del transcript: lo que ya no cambia y se pinta por su tipo.
+ *
+ * Vivía en `cli/tui/store.ts` porque solo lo usaba la TUI. Ahora lo usan DOS pieles —la
+ * TUI y la web—, y el servidor web no puede importar de `cli/tui/` sin romper la frontera
+ * de Ink. Así que baja a `core/`, que es donde vive lo que comparten las pieles.
+ *
+ * Ningún acto lleva argumentos de tool: `herramientas.lineas` son líneas YA resumidas por
+ * `agent/resumenDeTool.ts`, con la lista blanca de campos por nombre de tool. Lo que se
+ * añadió después (`detalles`) tampoco los lleva: es el NOMBRE de la tool y su error, que
+ * el evento ya traía y el acto tiraba al componer la línea.
+ */
+/** Suma dos consumos, cuenta por cuenta. La ventana gana la del SEGUNDO: es la más reciente. */
+export function sumarConsumo(a, b) {
+    const suma = (x, y) => ({
+        entrada: x.entrada + y.entrada,
+        salida: x.salida + y.salida,
+        cache: x.cache + y.cache,
+    });
+    const ventana = b.ventana ?? a.ventana;
+    return {
+        modelo: suma(a.modelo, b.modelo),
+        externo: suma(a.externo, b.externo),
+        ...(ventana === undefined ? {} : { ventana }),
+    };
+}
+/**
+ * Lo que costó una CONVERSACIÓN, leída de sus actos.
+ *
+ * Suma los deltas de los `fin` y se queda con la última ventana que CONSTA —la más
+ * reciente que se midió, que es la mejor respuesta a «cuánto ocupa el historial ahora»
+ * cuando el último turno no la midió—. Devuelve `undefined` cuando NINGÚN `fin` lo trae,
+ * que es lo que distingue una sesión anterior a esto de una que gastó cero: pintar un cero
+ * que nadie ha medido es la cifra inventada de siempre (`ContadorDeTokens`), y aquí se
+ * puede caer en ella con una sesión vieja delante.
+ *
+ * Vive en `core/` y no en el servidor porque es una lectura de actos, no de disco: los
+ * actos que le llegan pueden venir del `.jsonl` recién releído o de cualquier otra fuente.
+ */
+export function consumoDeLosActos(actos) {
+    let total;
+    for (const acto of actos) {
+        if (acto.tipo !== "fin" || acto.consumo === undefined)
+            continue;
+        total = total === undefined ? { ...acto.consumo } : sumarConsumo(total, acto.consumo);
+    }
+    return total;
+}
+/**
+ * El ACUMULADO de una sesión: se suma un turno detrás de otro, y **la ventana NO viaja**.
+ *
+ * Es la diferencia con `sumarConsumo`, y es la razón de que esto exista con nombre propio en
+ * vez de ser un `sumarConsumo` más en la llamada. `consumoDeLosActos` compone los actos de UNA
+ * conversación que se está mirando AHORA, y ahí la ventana tiene sentido: «cuánto ocupa el
+ * historial» es una pregunta del momento, y la del último turno que midió es la respuesta.
+ * Un acumulado estampado en el índice es otra cosa —el gasto de una sesión ya cerrada—, y una
+ * ventana dentro sería un «ahora» congelado hace tres días que alguien leería como el de hoy.
+ * El dato no se pierde: sigue en cada `fin` del `.jsonl`, que es donde se mide.
+ *
+ * `a` ausente es el primer `fin` de la sesión: devuelve una copia del delta, no el delta —quien
+ * lo llame lo va a guardar en el índice, y los actos del lazo no son de nadie para mutarlos.
+ */
+export function acumularTotales(a, delta) {
+    const total = a === undefined ? delta : sumarConsumo(a, delta);
+    return {
+        modelo: { ...total.modelo },
+        externo: { ...total.externo },
+    };
+}
+/**
+ * Una línea de cierre de racha del colapsador del motor (`core/notify.ts`): «→ lee ×3 — …».
+ * Devuelve su prefijo icono+verbo («→ lee»), o undefined si no es un cierre.
+ */
+function prefijoDeCierre(linea) {
+    const m = /^(\S+ \S+) ×\d+/.exec(linea);
+    return m?.[1];
+}
+/**
+ * Añadir una línea de tool al grupo: si es el cierre de la racha cuya apertura es la
+ * última línea, la SUSTITUYE. El colapsador escribe apertura y cierre porque stdio solo
+ * añade; una piel que repinta (TUI, web) no puede permitirse dos líneas para la misma
+ * racha. Pura, y vivía en `cli/tui/store.ts` hasta que la web empezó a necesitarla
+ * también: dos copias de esta sutileza es cómo divergen.
+ */
+export function conLineaDeTool(lineas, linea) {
+    const prefijo = prefijoDeCierre(linea);
+    const ultima = lineas.at(-1);
+    if (prefijo !== undefined && ultima !== undefined && (ultima === prefijo || ultima.startsWith(`${prefijo} `))) {
+        return [...lineas.slice(0, -1), linea];
+    }
+    return [...lineas, linea];
+}
+/**
+ * La misma fusión, sobre las DOS listas a la vez.
+ *
+ * Los `detalles` van en paralelo a las `lineas`, así que aplicarles la regla por separado
+ * es cómo se desincronizan: la sustitución del cierre de una racha quita un elemento de
+ * una lista y no de la otra, y a partir de ahí cada línea lleva el detalle de su vecina.
+ * Una sola función que devuelva las dos lo hace imposible por construcción.
+ */
+export function conLlamadaDeTool(grupo, linea, detalle) {
+    const lineas = conLineaDeTool(grupo.lineas, linea);
+    // Si `conLineaDeTool` sustituyó, la lista no creció: el detalle nuevo sustituye al
+    // último igual que su línea. Si creció, se añade. Se compara por LONGITUD y no
+    // repitiendo el `prefijoDeCierre`, para que solo haya una decisión y no dos que puedan
+    // discrepar.
+    const previos = grupo.detalles ?? grupo.lineas.map(() => ({}));
+    const detalles = lineas.length === grupo.lineas.length
+        ? [...previos.slice(0, -1), detalle]
+        : [...previos, detalle];
+    return { lineas, detalles };
+}
+//# sourceMappingURL=actos.js.map

package/dist/core/actos.js.map

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

package/dist/core/adjuntos.js

@@ -0,0 +1,97 @@
+/**
+ * Los ADJUNTOS de una tarea: los documentos que una persona anexa al crearla.
+ *
+ * Una captura de la pantalla que hay que replicar, un `.md` con el detalle del encargo, un
+ * CSV con los datos de prueba. **No son ficheros del proyecto y no son artefactos**: no los
+ * produce el agente, los aporta quien pide el trabajo, y el agente solo los LEE. De ahí las
+ * dos reglas de este módulo:
+ *
+ * - **Viven FUERA del proyecto** (`~/.xonecode/tareas/<id>/adjuntos/`, ver
+ *   `agent/tareasEnDisco.ts`), y eso trae gratis lo que importaba: no entran en git y no
+ *   suben a CloudStudio, sin depender de ninguna exclusión. Una tarea puede crearse para un
+ *   proyecto que nadie ha abierto nunca, así que guardarlos en su `.xonecode/` sería
+ *   estrenárselo por la puerta de atrás.
+ * - **El agente los ve en `/adjuntos/`, de SOLO lectura** — la misma pieza que `/skills/` y
+ *   `/artefactos/` (`agent/proyecto.ts#backendConAdjuntos`), y de solo lectura por lo mismo
+ *   que las skills: son material de entrada, no ficheros que reescribir. Lo deniega
+ *   `permisosDe` y no un prompt.
+ *
+ * Este módulo es `core/`: datos puros, una lista blanca de forma y el texto con que se le
+ * cuentan al agente. Quién los guarda y quién los monta es de `agent/`.
+ */
+/**
+ * El mime de un adjunto, por su EXTENSIÓN.
+ *
+ * Es literalmente la MISMA tabla que la de los artefactos y se reexporta en vez de
+ * copiarse: dos tablas de extensiones son dos tablas que divergen, y el criterio ya está
+ * argumentado ahí (por extensión y no olfateando los bytes, porque un PNG lleva ceros en su
+ * cabecera; y lo que no está en la tabla es `undefined`, que es «no lo sé» y no «es
+ * binario»).
+ */
+export { mimeDeArtefacto as mimeDeAdjunto } from "./artefactos.js";
+/** El prefijo virtual. Con barra final: `CompositeBackend` la exige para no reconstruir
+ *  `//nombre` fuera de la raíz montada — la misma trampa medida con `/skills/`. */
+export const RUTA_ADJUNTOS = "/adjuntos/";
+/**
+ * ¿Vale este nombre para un adjunto?
+ *
+ * **Lista BLANCA de forma, no un `startsWith` ni una lista de trampas**, y de ella depende
+ * que un `POST /adjunto?nombre=…` no escriba fuera de la carpeta de la tarea: el nombre
+ * llega del cliente y se concatena a una ruta de disco. Cada nombre tiene que ser un
+ * segmento de texto llano (letras y cifras ASCII, punto, guion y guion bajo), lo que deja
+ * fuera `..`, `.`, el hueco vacío de un `//`, la barra y la barra invertida de Windows, el
+ * NUL, los espacios y cualquier `%2e%2e` que llegue sin decodificar.
+ *
+ * Es la misma regla —y el mismo patrón— que `esRutaDeArtefacto` (`core/artefactos.ts`), y
+ * vive aquí para que la usen los tres sitios que la necesitan sin copiarla: la ruta de
+ * subida, el guardado en disco y el listado.
+ */
+const SEGMENTO = /^[A-Za-z0-9._-]+$/;
+export function nombreDeAdjuntoAceptable(nombre) {
+    return SEGMENTO.test(nombre) && nombre !== "." && nombre !== "..";
+}
+/** Un tamaño para leer. KB de 1000, como el resto de la interfaz. */
+const peso = (bytes) => bytes < 1000 ? `${bytes} B` : bytes < 1_000_000 ? `${Math.round(bytes / 1000)} KB` : `${(bytes / 1_000_000).toFixed(1)} MB`;
+/**
+ * La petición del turno con el inventario de los adjuntos detrás.
+ *
+ * **Existe porque montar la carpeta no basta.** El agente no explora `/adjuntos/` por su
+ * cuenta: es una raíz virtual que ninguna instrucción suya nombra, así que un encargo que no
+ * la mencione deja los ficheros ahí sin que nadie los abra. Y no se puede confiar en que lo
+ * diga el ENCARGO: el encargo lo redacta el aumentador —que puede haber fallado, y entonces
+ * es el texto crudo de la persona— o lo edita quien crea la tarea, y las dos cosas pueden
+ * borrar la única mención. Así que se añade al MANDAR el turno, que es el único momento en
+ * que se sabe lo que hay en disco. Es el mismo reparto que `peticionDeFeedback`
+ * (`web/servidor/corredorDeTareas.ts`): el texto de la persona, y detrás lo que el código
+ * sabe.
+ *
+ * **Sin adjuntos no toca nada.** Nombrar una carpeta que no se ha montado sería mandarle al
+ * agente a un sitio que no existe — el «control sin dato detrás» de siempre, aquí en forma
+ * de prompt.
+ *
+ * **Y dice la limitación de las imágenes** (§2 del diseño: que el agente VEA una imagen es
+ * multimodal y es otra tanda). Solo si hay alguna: el aviso pegado a un `.md` sería ruido.
+ * Prometerle que «mira» la captura y que la lea como bytes es la peor clase de mentira aquí,
+ * porque quien se la cree es el modelo y contestará que la ha mirado.
+ */
+export function conAdjuntos(peticion, adjuntos) {
+    if (adjuntos.length === 0)
+        return peticion;
+    const hayImagen = adjuntos.some((a) => a.mime?.startsWith("image/") === true);
+    return [
+        peticion,
+        "",
+        `ADJUNTOS DE ESTA TAREA (${adjuntos.length}). Los ha anexado la persona que la creó y están`,
+        `montados en «${RUTA_ADJUNTOS}», de SOLO lectura: se leen con las tools de fichero y no se`,
+        "pueden escribir ni borrar. No son ficheros del proyecto.",
+        ...adjuntos.map((a) => `- ${RUTA_ADJUNTOS}${a.nombre} (${peso(a.bytes)}${a.mime === undefined ? "" : `, ${a.mime}`})`),
+        ...(hayImagen
+            ? [
+                "AVISO sobre las imágenes: las LEES como fichero, pero no las ves — no hay visión en",
+                "este harness todavía. No digas que has mirado una captura ni describas lo que aparece",
+                "en ella: si el encargo depende de verla, dilo y pide que se describa por escrito.",
+            ]
+            : []),
+    ].join("\n");
+}
+//# sourceMappingURL=adjuntos.js.map

package/dist/core/adjuntos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjuntos.js","sourceRoot":"","sources":["../../src/core/adjuntos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;GAQG;AACH,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEnE;mFACmF;AACnF,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AAErC,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,IAAI,CAAC;AACpE,CAAC;AAUD,qEAAqE;AACrE,MAAM,IAAI,GAAG,CAAC,KAAa,EAAU,EAAE,CACrC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAE9H;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAqC;IACjF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;IAC9E,OAAO;QACL,QAAQ;QACR,EAAE;QACF,2BAA2B,QAAQ,CAAC,MAAM,kDAAkD;QAC5F,gBAAgB,aAAa,8DAA8D;QAC3F,0DAA0D;QAC1D,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,aAAa,GAAG,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;QACtH,GAAG,CAAC,SAAS;YACX,CAAC,CAAC;gBACE,qFAAqF;gBACrF,uFAAuF;gBACvF,mFAAmF;aACpF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}