xonecode 0.1.0

package/dist/agent/puente.js

@@ -0,0 +1,142 @@
+import { normalizar } from "./normalizar.js";
+import { Mensajes } from "./mensajes.js";
+import { detalleDe } from "./resumenDeTool.js";
+/** El texto de un mensaje, venga como venga. */
+export function textoDe(msg) {
+    if (!msg || typeof msg !== "object")
+        return "";
+    const m = msg;
+    if (typeof m.text === "string")
+        return m.text;
+    const c = m.content;
+    if (typeof c === "string")
+        return c;
+    // Contenido en BLOQUES (Gemini con thinking): concatenar solo los de texto. Un
+    // `String(content)` daría el `repr` de la lista, razonamiento incluido, y el usuario
+    // vería basura donde esperaba una frase.
+    if (Array.isArray(c)) {
+        return c
+            .map((b) => (b && typeof b === "object" && typeof b.text === "string" ? b.text : ""))
+            .join("");
+    }
+    return "";
+}
+/** Los nombres de tool de un chunk de `updates`, con su detalle de la lista blanca. */
+export function toolsDe(dato) {
+    if (!dato || typeof dato !== "object")
+        return [];
+    const salida = [];
+    for (const nodo of Object.values(dato)) {
+        const msgs = nodo?.messages;
+        if (!Array.isArray(msgs))
+            continue;
+        for (const m of msgs) {
+            const llamadas = m?.tool_calls;
+            if (Array.isArray(llamadas)) {
+                for (const l of llamadas) {
+                    const n = l?.name;
+                    if (typeof n === "string")
+                        salida.push({ nombre: n, detalle: detalleDe(n, l.args) });
+                }
+            }
+        }
+    }
+    return salida;
+}
+/**
+ * ¿Este chunk lo emite el grafo PADRE, o un especialista?
+ *
+ * **Medido el 2026-08-30**, sobre un turno real con delegación. Los namespaces que
+ * llegan con `subgraphs: true` son exactamente tres formas:
+ *
+ * | namespace                              | quién         | chunks |
+ * |----------------------------------------|---------------|-------:|
+ * | `["model_request:…"]`                   | el padre      |    148 |
+ * | `["tools:…", "model_request:…"]`        | un especialista |  745 |
+ * | `["tools:…", "tools:…"]`                | tools de un especialista | 12 |
+ *
+ * Un especialista SIEMPRE lleva el segmento `tools:` delante, porque se le invoca con la
+ * tool `task`. Así que la frontera es la LONGITUD.
+ *
+ * **El fallo que esto cierra era mudo y caro.** Antes se descartaba todo `ns` no vacío,
+ * dando por hecho que el padre venía con `ns: []` — cierto para `updates`, FALSO para
+ * `messages`, que llegan con `["model_request:<uuid>"]`. Consecuencia: se descartaban
+ * TODOS los tokens, respuesta incluida. El turno corría entero, enseñaba sus tools,
+ * decía «sin cambios en el proyecto»… y no contestaba nada. Sin excepción y sin aviso.
+ *
+ * Y los números explican por qué el filtro tiene que existir: 745 chunks de especialista
+ * frente a 148 del padre. Emitirlos todos sería volcar el razonamiento interno de los
+ * especialistas encima de la respuesta.
+ */
+export function esDelPadre(ns) {
+    return ns.length <= 1;
+}
+/**
+ * Convierte el stream del grafo en `DomainEvent`.
+ *
+ * **Se lee con `subgraphs: true`**, porque sin él lo que hacen los especialistas —que son
+ * grafos compilados invocados dentro de un nodo— no llega al padre, y el fallo es MUDO. El
+ * precio, medido: el chunk pasa de `[modo, dato]` a `[namespace, modo, dato]`, y de eso se
+ * encarga `normalizar`.
+ *
+ * Los tokens que se emiten son SOLO los del grafo padre. Los de un
+ * especialista son su razonamiento interno, no la respuesta: enseñarlos convierte la
+ * consola en un volcado. Su trabajo se cuenta por `tool`, que es lo que el usuario
+ * necesita ver mientras espera.
+ */
+export async function* aEventos(stream, pendientes) {
+    const mensajes = new Mensajes();
+    try {
+        for await (const bruto of stream) {
+            const chunk = normalizar(bruto);
+            if (!chunk)
+                continue;
+            if (chunk.modo === "updates") {
+                for (const { nombre, detalle } of toolsDe(chunk.dato)) {
+                    yield { tipo: "tool", nombre, ...(detalle !== undefined ? { detalle } : {}) };
+                }
+                continue;
+            }
+            if (chunk.modo === "messages") {
+                if (!esDelPadre(chunk.ns))
+                    continue; // de un especialista: no es la respuesta
+                if (!Array.isArray(chunk.dato))
+                    continue;
+                const [msg] = chunk.dato;
+                const texto = textoDe(msg);
+                const id = msg?.id;
+                const idTexto = typeof id === "string" ? id : undefined;
+                if (mensajes.trozo(idTexto, texto).pintar) {
+                    yield { tipo: "token", texto, msgId: idTexto };
+                }
+            }
+        }
+    }
+    finally {
+        mensajes.fin();
+        // La pausa se consulta AL AGOTARSE el stream, no dentro del bucle: una pausa
+        // TERMINA el turno, así que el interrupt solo puede estar en el estado cuando el
+        // stream ya se ha acabado. Y solo si alguien pasó `pendientes`: sin el parámetro,
+        // el comportamiento es el de antes.
+        if (pendientes !== undefined) {
+            try {
+                const lista = await pendientes();
+                if (lista.length > 0) {
+                    // Una sola `pausa` aunque vengan varios: con dos `task` en un turno quedan
+                    // DOS interrupts a la vez, y dos eventos harían preguntar dos veces por lotes.
+                    yield { tipo: "pausa", pendientes: lista };
+                }
+            }
+            catch (e) {
+                // No se traga: callarlo haría creer que no había nada que aprobar cuando en
+                // verdad no se pudo comprobar. Fallar entero tampoco: el turno ya acabó.
+                yield {
+                    tipo: "aviso",
+                    texto: `⚠ No se pudo comprobar si había algo pendiente de aprobación: ${e instanceof Error ? e.message : String(e)}`,
+                    severidad: "grave",
+                };
+            }
+        }
+    }
+}
+//# sourceMappingURL=puente.js.map

package/dist/agent/puente.js.map

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

package/dist/agent/resumenDeTool.js

@@ -0,0 +1,48 @@
+/**
+ * La LISTA BLANCA de la línea de estado: qué argumento de cada tool puede salir como
+ * `detalle` del evento `tool`.
+ *
+ * La regla dura está documentada en `core/events.ts`: ningún evento lleva argumentos de
+ * tool crudos, porque `write_file` lleva el contenido del fichero y una tool MCP lleva
+ * el bearer — enseñar el progreso no puede ser la forma de filtrar un secreto. Este
+ * módulo es la otra mitad de esa regla: no se FILTRA nada, se ELIGE a mano un campo por
+ * tool — una ruta o un patrón, nunca contenido — y lo que no está en la tabla no sale.
+ * Los nombres de campo son los de las tools de fichero de deepagents, verificados
+ * contra su dist (`file_path` con `path` normalizado, `pattern` en glob/grep).
+ */
+/** El único campo permitido de cada tool. Sin entrada: nada sale. */
+const CAMPO_SEGURO = {
+    read_file: "file_path",
+    write_file: "file_path",
+    edit_file: "file_path",
+    ls: "path",
+    glob: "pattern",
+    grep: "pattern",
+};
+/**
+ * El `detalle` de una llamada, o `undefined` si no hay nada permitido que contar.
+ *
+ * Los argumentos llegan como objeto o como cadena JSON (así viajan en las
+ * `tool_calls`); un JSON roto es una tool rota, no una excepción que tumbe el turno.
+ */
+export function detalleDe(nombre, args) {
+    const campo = CAMPO_SEGURO[nombre];
+    if (campo === undefined)
+        return undefined;
+    let objeto = args;
+    if (typeof args === "string") {
+        try {
+            objeto = JSON.parse(args);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (!objeto || typeof objeto !== "object")
+        return undefined;
+    const valor = objeto[campo];
+    // Una cadena vacía no describe nada, y un tipo raro (`file_path: 42`) tampoco:
+    // sin detalle es una respuesta válida.
+    return typeof valor === "string" && valor !== "" ? valor : undefined;
+}
+//# sourceMappingURL=resumenDeTool.js.map

package/dist/agent/resumenDeTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumenDeTool.js","sourceRoot":"","sources":["../../src/agent/resumenDeTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qEAAqE;AACrE,MAAM,YAAY,GAA2B;IAC3C,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,WAAW;IACtB,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,IAAa;IACrD,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,IAAI,MAAM,GAAY,IAAI,CAAC;IAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAE5D,MAAM,KAAK,GAAI,MAAkC,CAAC,KAAK,CAAC,CAAC;IACzD,+EAA+E;IAC/E,uCAAuC;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}

package/dist/agent/skills.js

@@ -0,0 +1,65 @@
+import { readdirSync, existsSync, readFileSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseFrontmatter } from "../vendor/skillLoaders/catalog.js";
+/**
+ * Dónde viven las skills.
+ *
+ * Dos niveles arriba, y sirve igual desde `src/` (con tsx) que desde `dist/`: los dos
+ * cuelgan de la raíz del repo, así que `../../skills` acierta en ambos.
+ *
+ * Se resuelve contra ESTE módulo y no contra el cwd: en la v1 el cwd es el proyecto del
+ * cliente, así que un `./skills` relativo apuntaría al proyecto del usuario y el catálogo
+ * saldría vacío sin que nadie supiera por qué.
+ */
+export const RAIZ_SKILLS = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "skills");
+/** Estimación de coste. 4 caracteres por token es la regla de servilleta de siempre. */
+export const tokensDe = (texto) => Math.ceil(texto.length / 4);
+/**
+ * Las skills en disco. NO lleva la marca de doble: son las de verdad.
+ *
+ * El catálogo se lee UNA vez y se cachea: son seis ficheros que no cambian a mitad de
+ * turno, y releerlos por cada consulta convierte el catálogo en E/S dentro del lazo.
+ */
+export class SkillsEnDisco {
+    raiz;
+    cache = null;
+    constructor(raiz = RAIZ_SKILLS) {
+        this.raiz = raiz;
+    }
+    catalogo() {
+        if (this.cache)
+            return this.cache;
+        if (!existsSync(this.raiz))
+            return (this.cache = []);
+        const salida = [];
+        for (const entrada of readdirSync(this.raiz)) {
+            const skillMd = join(this.raiz, entrada, "SKILL.md");
+            if (!existsSync(skillMd))
+                continue;
+            try {
+                const bruto = readFileSync(skillMd, "utf8");
+                const { data } = parseFrontmatter(bruto);
+                salida.push({
+                    nombre: data.name ?? entrada,
+                    descripcion: data.description ?? "",
+                    tokens: tokensDe(bruto),
+                });
+            }
+            catch {
+                // Una skill ilegible no puede tumbar el catálogo entero: se queda fuera y las
+                // demás siguen. Que falte se ve en `xonecode skills`, que las cuenta.
+            }
+        }
+        return (this.cache = salida.sort((a, b) => a.nombre.localeCompare(b.nombre)));
+    }
+    cargar(nombre) {
+        const skillMd = join(this.raiz, nombre, "SKILL.md");
+        if (!existsSync(skillMd)) {
+            const hay = this.catalogo().map((s) => s.nombre).join(", ");
+            throw new Error(`no hay skill «${nombre}». Las que hay: ${hay || "(ninguna)"}`);
+        }
+        return readFileSync(skillMd, "utf8");
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/agent/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/agent/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAY,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAElG,wFAAwF;AACxF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAGK;IAFrB,KAAK,GAAuB,IAAI,CAAC;IAEzC,YAA6B,OAAe,WAAW;QAA1B,SAAI,GAAJ,IAAI,CAAsB;IAAG,CAAC;IAE3D,QAAQ;QACN,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAErD,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;YACrD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,SAAS;YACnC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC5C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBACzC,MAAM,CAAC,IAAI,CAAC;oBACV,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,OAAO;oBAC5B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;oBACnC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC;iBACxB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,8EAA8E;gBAC9E,sEAAsE;YACxE,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,mBAAmB,GAAG,IAAI,WAAW,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/agent/textoDeTool.js

@@ -0,0 +1,113 @@
+/**
+ * Convierte a TEXTO el contenido de los `ToolMessage` antes de mandárselo al modelo.
+ *
+ * ## El fallo que cierra, medido el 2026-08-30
+ *
+ * Un turno real reventaba con `Non string tool message content is not supported` tras
+ * 8-10 llamadas a tools. Reproducido con DOS modelos distintos —`glm-5.3-flash:cloud` y
+ * `qwen3.8:27b-mlx`, nube y local— y con la misma traza, lo que hacía pensar en un
+ * problema de langchain o de deepagents.
+ *
+ * **No lo era.** El mensaje sale de `@langchain/ollama/dist/utils.js:107`:
+ *
+ * ```js
+ * function convertToolMessageToOllama(message) {
+ *   if (typeof message.content !== "string")
+ *     throw new Error("Non string tool message content is not supported");
+ * ```
+ *
+ * O sea: es del PROVEEDOR, no del harness. Los dos modelos fallaban igual porque los dos
+ * eran Ollama. Su conversor no acepta contenido en bloques —que es lo que devuelven las
+ * tools de fichero de deepagents— y no lo convierte ni degrada: lanza.
+ *
+ * Y es una combinación que en este laboratorio importa: Ollama local es la vía por
+ * omisión (el coste manda), así que sin esto el harness no puede correr con su propio
+ * proveedor por defecto.
+ *
+ * ## Por qué se aplica SIEMPRE y no solo con Ollama
+ *
+ * Un `ToolMessage` de texto lo acepta cualquier proveedor, así que convertir de más no
+ * rompe a nadie. Condicionarlo al proveedor tendría dos costes: la rama solo se
+ * ejercitaría con Ollama —o sea, un camino que se rompe sin que ningún test lo note— y
+ * obligaría a este módulo a saber qué proveedor hay detrás, que es justo lo que los
+ * puertos existen para no tener que saber.
+ */
+import { createMiddleware } from "langchain";
+/** Un bloque de contenido: `{type:"text", text}` es el caso que hay que conservar. */
+function textoDeBloque(bloque) {
+    if (typeof bloque === "string")
+        return bloque;
+    if (!bloque || typeof bloque !== "object")
+        return "";
+    const b = bloque;
+    if (typeof b.text === "string")
+        return b.text;
+    // Un bloque que no es de texto (una imagen, por ejemplo) no se puede meter en una
+    // cadena sin mentir sobre lo que es. Se declara en vez de perderlo en silencio.
+    return typeof b.type === "string" ? `[${b.type}]` : "";
+}
+/**
+ * El contenido de un mensaje, como cadena.
+ *
+ * `JSON.stringify` es el último recurso y no el primero: para bloques de texto daría
+ * `[{"type":"text","text":"…"}]`, y el modelo tendría que desenterrar el contenido de
+ * su propio envoltorio en cada llamada.
+ */
+export function aTexto(contenido) {
+    if (typeof contenido === "string")
+        return contenido;
+    if (Array.isArray(contenido))
+        return contenido.map(textoDeBloque).join("");
+    if (contenido === null || contenido === undefined)
+        return "";
+    try {
+        return JSON.stringify(contenido);
+    }
+    catch {
+        return String(contenido);
+    }
+}
+/** ¿Es un `ToolMessage`? Se mira por las dos vías: el tipo de langchain y el campo. */
+export function esMensajeDeTool(msg) {
+    if (!msg || typeof msg !== "object")
+        return false;
+    const m = msg;
+    if (m.type === "tool" || m.role === "tool")
+        return true;
+    return typeof m.tool_call_id === "string" && m.tool_call_id.length > 0;
+}
+/**
+ * Convierte los `ToolMessage` de la petición, sin tocar el historial.
+ *
+ * Va en `wrapModelCall` y no en `beforeModel` a propósito: lo que hay que arreglar es lo
+ * que SE MANDA, no lo que se guarda. Reescribir el estado perdería el contenido
+ * estructurado para todo lo demás —el rastreo, un proveedor que sí lo acepte— por un
+ * problema de un solo conversor.
+ */
+export function middlewareTextoDeTool() {
+    return createMiddleware({
+        name: "TextoDeToolMiddleware",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        wrapModelCall: (request, handler) => {
+            const mensajes = request?.messages;
+            if (!Array.isArray(mensajes))
+                return handler(request);
+            let hubo = false;
+            const convertidos = mensajes.map((m) => {
+                if (!esMensajeDeTool(m))
+                    return m;
+                const msg = m;
+                if (typeof msg.content === "string")
+                    return m;
+                hubo = true;
+                // Se clona: mutar el mensaje lo cambiaría también en el historial, que es
+                // exactamente lo que este middleware evita.
+                const copia = Object.create(Object.getPrototypeOf(msg));
+                Object.assign(copia, msg, { content: aTexto(msg.content) });
+                return copia;
+            });
+            return handler(hubo ? { ...request, messages: convertidos } : request);
+        },
+    });
+}
+//# sourceMappingURL=textoDeTool.js.map

package/dist/agent/textoDeTool.js.map

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

package/dist/agent/turnoReal.js

@@ -0,0 +1,173 @@
+import { readdirSync, statSync, existsSync, readFileSync } from "node:fs";
+import { join, sep, resolve } from "node:path";
+import { randomUUID } from "node:crypto";
+import { HumanMessage } from "@langchain/core/messages";
+import { Command, MemorySaver } from "@langchain/langgraph";
+import { collectPending, MAX_APPROVAL_ROUNDS } from "../vendor/hitl.js";
+import { aPendiente, ficheroDe, cambioDe, buildResume } from "./interrupts.js";
+import { correrTurno } from "../core/turno.js";
+import { tomarInstantanea } from "./instantanea.js";
+import { construirAgente } from "./xoneAgent.js";
+import { aEventos } from "./puente.js";
+import { createTokenTracker } from "../vendor/tokenTracking.js";
+/**
+ * Recorre la raíz y devuelve las rutas en el ESPACIO VIRTUAL del backend.
+ *
+ * Exportada porque la consola la usa para el completado de «@ficheros» (cli puede
+ * importar de agent; al revés no). El recorrido se hace EN CADA llamada a propósito:
+ * la lista no se cachea porque los ficheros cambian durante la sesión.
+ */
+export function ficherosDelProyecto(raiz, prof = 0) {
+    if (prof > 4 || !existsSync(raiz))
+        return new Set();
+    const salida = new Set();
+    for (const entrada of readdirSync(raiz)) {
+        if (entrada === "node_modules" || entrada === ".git")
+            continue;
+        const ruta = join(raiz, entrada);
+        try {
+            if (statSync(ruta).isDirectory()) {
+                // La recursión devuelve rutas relativas al SUBDIRECTORIO: sin recoserle el
+                // nombre, «app/Clientes.xne» saldría como «/Clientes.xne» y el Set dejaría de
+                // responder por las vistas aplanadas ANIDADAS (este universo es el que consulta
+                // `esVistaAplanada`).
+                for (const f of ficherosDelProyecto(ruta, prof + 1))
+                    salida.add(`/${entrada}${f}`);
+            }
+            else {
+                salida.add("/" + ruta.slice(raiz.length + 1).split(sep).join("/"));
+            }
+        }
+        catch {
+            // Un enlace roto o un permiso no tumba el arranque; el agente vivirá sin ese fichero.
+        }
+    }
+    return salida;
+}
+/**
+ * Abre una sesión real: agente, checkpointer, hilo y tracker se construyen UNA vez aquí, y
+ * viven en el cierre. Todo lo que sobreviva al primer turno tiene que salir de este cierre:
+ * reconstruir el agente fuera (o un `MemorySaver` nuevo por llamada) tiraría la conversación.
+ */
+export async function abrirSesionReal(opciones) {
+    const { raiz, entorno } = opciones;
+    const checkpointer = new MemorySaver();
+    const tracker = createTokenTracker();
+    let modelos = opciones.modelos;
+    let hilo = `xonecode-${randomUUID()}`;
+    const construir = async () => construirAgente({
+        raiz,
+        ficheros: ficherosDelProyecto(raiz),
+        modelos,
+        skills: opciones.skills,
+        checkpointer: checkpointer,
+        tracker,
+    });
+    let agente = await construir();
+    /**
+     * Los pendientes de aprobación, del ESTADO y no del resultado del stream.
+     *
+     * Se leen los crudos (`collectPending`) y no solo los traducidos, porque de ellos sale la
+     * RUTA del fichero que se va a tocar (`ficheroDe`). Los argumentos NO se publican
+     * —`write_file` lleva el contenido entero—, pero aprobar a ciegas es peor que no aprobar,
+     * así que la ruta sí. Una sola llamada a `getState` para las dos cosas.
+     */
+    const leerPendientes = async () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const crudos = collectPending(await agente.getState({
+            configurable: { thread_id: hilo },
+        }));
+        const ficheros = new Map();
+        const diffs = new Map();
+        for (const c of crudos) {
+            const f = ficheroDe(c);
+            if (f)
+                ficheros.set(c.id, f);
+            // El ANTES es el disco: el interrupt pausa ANTES de escribir. La ruta viene del
+            // backend, que es relativo a la raíz del proyecto — y si no está en el disco, el
+            // fichero es nuevo y su «antes» es la cadena vacía, no un error.
+            const vista = cambioDe(c, (ruta) => {
+                try {
+                    return readFileSync(resolve(raiz, ruta), "utf8");
+                }
+                catch {
+                    return "";
+                }
+            });
+            if (vista)
+                diffs.set(c.id, vista.lineas);
+        }
+        return { lista: crudos.map(aPendiente), ficheros, diffs };
+    };
+    /**
+     * Un turno: foto del ANTES → stream con bucle de aprobación → diff contra esa foto.
+     *
+     * La foto es POR TURNO, no por sesión: con una sola, el diff del turno 3 incluiría lo que
+     * escribió el turno 1.
+     */
+    const turno = async (peticion, piel) => {
+        const instantanea = await tomarInstantanea(raiz, entorno.git);
+        let payload = { messages: [new HumanMessage(peticion)] };
+        let bitacora = null;
+        let ronda = 0;
+        // El bucle de aprobación, tal como está en `correrReal` (`cli/run.ts`): una pausa
+        // TERMINA la ronda, el interrupt queda en el estado, y se reanuda con un `Command`
+        // con las decisiones — también con rejects, que si no se resumen dejan el interrupt
+        // colgado para siempre y el modelo nunca llega a saber que se rechazó.
+        let cortadoPorTope = false;
+        while (true) {
+            ronda += 1;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const stream = await agente.stream(payload, {
+                configurable: { thread_id: hilo },
+                streamMode: ["updates", "messages"],
+                subgraphs: true,
+            });
+            bitacora = await correrTurno(aEventos(stream, async () => (await leerPendientes()).lista), piel, {
+                avisos: (b) => (b.corrio("verify") ? [] : ["⚠ el verificador no ha corrido en este turno"]),
+            });
+            const { lista, ficheros, diffs } = await leerPendientes();
+            if (lista.length === 0)
+                break;
+            // El tope existe porque un modelo que insiste tras cada rechazo convierte esto en un
+            // ciclo automático de ~200k tokens por ronda (medido en da04). Sin resumir: nada se
+            // aplica, pero el interrupt queda en el estado.
+            if (ronda >= MAX_APPROVAL_ROUNDS) {
+                piel.linea(`\n⚠ tope de ${MAX_APPROVAL_ROUNDS} rondas de aprobación agotado.`);
+                piel.linea(`  quedaban ${lista.length} sin resolver, y NO se han aplicado.`);
+                cortadoPorTope = true;
+                break;
+            }
+            if (!opciones.pedirAprobacion) {
+                piel.linea(`\n⏸  ${lista.length} escritura(s) piden aprobación, y no hay quién apruebe.`);
+                piel.linea("   Nada se ha aprobado y nada se ha aplicado.");
+                break;
+            }
+            const decisiones = await opciones.pedirAprobacion(lista, ficheros, diffs);
+            payload = new Command({ resume: buildResume(decisiones) });
+        }
+        // El diff contra la foto de ESTE turno. Un turno que no tocó nada TIENE que verse igual.
+        const cambios = await instantanea.cambios();
+        // `cortadoPorTope` viaja en el retorno y no en la bitácora porque es lo que decide el
+        // CÓDIGO DE SALIDA de quien invoca: un turno que se quedó con escrituras sin resolver
+        // no es un éxito, y CI no puede leerlo como tal.
+        return { bitacora: bitacora, cambios, cortadoPorTope };
+    };
+    return {
+        turno,
+        /** Para `/modelo`: agente nuevo con los mismos hilo, checkpointer y tracker. */
+        async cambiarModelos(nuevos) {
+            modelos = nuevos;
+            agente = await construir();
+        },
+        /** Para `/nuevo`: solo cambia el hilo. El agente no se reconstruye. */
+        nuevoHilo(id) {
+            hilo = id ?? `xonecode-${randomUUID()}`;
+        },
+        tracker,
+        get hilo() {
+            return hilo;
+        },
+    };
+}
+//# sourceMappingURL=turnoReal.js.map

package/dist/agent/turnoReal.js.map

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

package/dist/agent/verificador.js

@@ -0,0 +1,65 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const ejecutar = promisify(execFile);
+/** La forma que emite `xone-simulator validate --json` (xone-linter 1.4.0). */
+/**
+ * Cuando el simulador no pudo ni empezar. **Medido**: ante una ruta que no existe devuelve
+ * `{"success": false, "error": "No existe el directorio del proyecto: …"}` — sin `issues`,
+ * y **saliendo con código 0**, así que no lo caza ningún `catch` del proceso.
+ *
+ * Es un fallo del ENTORNO, no del proyecto, y por eso es una excepción y no un informe en
+ * rojo: un informe rojo dice «tu proyecto tiene errores», que aquí sería mentira.
+ */
+export class ErrorDelSimulador extends Error {
+}
+/**
+ * De la salida del simulador al informe del harness. PURA: sin subprocesos.
+ *
+ * Separada de quien invoca el binario para poder probar la traducción con el fichero de
+ * `__oro__/` — es el patrón del puerto aplicado dentro del puerto, igual que el harness
+ * Python separa la función que recibe la sesión ya lista del puerto que la construye.
+ */
+export function aInforme(salida) {
+    // La forma de fallo no trae `issues`. Sin esta guarda, `.map` de `undefined` reventaba
+    // con un TypeError que le llegaba al usuario TAL CUAL —«Cannot read properties of
+    // undefined (reading 'map')»— tapando el mensaje que el simulador ya daba claro.
+    if (!Array.isArray(salida.issues)) {
+        throw new ErrorDelSimulador(salida.error ?? "el simulador no devolvió hallazgos ni error");
+    }
+    const hallazgos = salida.issues.map((i) => ({
+        code: i.code,
+        severidad: i.severity,
+        mensaje: i.message,
+        fichero: i.location?.file ?? i.file,
+        linea: i.location?.line,
+        columna: i.location?.column,
+    }));
+    return { verde: salida.success, hallazgos };
+}
+/**
+ * El verificador real. NO lleva la marca `ES_DOBLE`: es de verdad, y `describe()` lo dirá.
+ *
+ * `validate` sale con código != 0 cuando encuentra errores, así que un fallo del proceso
+ * NO es un fallo del harness: es el resultado. Se distingue por si hubo JSON parseable —
+ * confundir las dos cosas es el patrón «fallo del proyecto != fallo del harness».
+ */
+export class SimuladorVerifier {
+    binario;
+    constructor(binario = "xone-simulator") {
+        this.binario = binario;
+    }
+    async verificar(rutaProyecto) {
+        let stdout;
+        try {
+            ({ stdout } = await ejecutar(this.binario, ["validate", rutaProyecto, "--json"]));
+        }
+        catch (e) {
+            const conSalida = e;
+            if (!conSalida.stdout)
+                throw e; // el binario no está, o reventó de verdad
+            stdout = conSalida.stdout; // salió != 0 porque HAY hallazgos: es el resultado
+        }
+        return aInforme(JSON.parse(stdout));
+    }
+}
+//# sourceMappingURL=verificador.js.map

package/dist/agent/verificador.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verificador.js","sourceRoot":"","sources":["../../src/agent/verificador.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAErC,+EAA+E;AAC/E;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAiB/C;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,MAA0B;IACjD,uFAAuF;IACvF,kFAAkF;IAClF,iFAAiF;IACjF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,KAAK,IAAI,6CAA6C,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,SAAS,GAAe,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,QAAiC;QAC9C,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI;QACnC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI;QACvB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM;KAC5B,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,UAAU,gBAAgB;QAA1B,YAAO,GAAP,OAAO,CAAmB;IAAG,CAAC;IAE3D,KAAK,CAAC,SAAS,CAAC,YAAoB;QAClC,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,SAAS,GAAG,CAAwB,CAAC;YAC3C,IAAI,CAAC,SAAS,CAAC,MAAM;gBAAE,MAAM,CAAC,CAAC,CAAC,0CAA0C;YAC1E,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAM,mDAAmD;QACrF,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAuB,CAAC,CAAC;IAC5D,CAAC;CACF"}