xonecode 0.8.46 → 0.9.0

package/dist/agent/motores/trueforge/recortes.js

@@ -0,0 +1,121 @@
+/**
+ * Lo que deepagents RECORTA de un resultado de tool antes de meterlo en el contexto, en TrueForge.
+ *
+ * Medido en una sesión real de MyAllXOne con la MISMA petición («lanza la app en el emulador»):
+ * TrueForge gastó 510k de entrada y deepagents 227k, con un número de tools parecido. La diferencia
+ * no estaba en el motor sino en lo que cada resultado DEJABA en el contexto: el `FilesystemMiddleware`
+ * de deepagents hace tres cosas que el adaptador de TrueForge no hacía, y un resultado que entra
+ * entero se vuelve a mandar en CADA llamada siguiente de ese hilo.
+ *
+ * 1. **Desaloja** lo que pasa de `toolTokenLimitBeforeEvict` tokens (a 4 caracteres por token) en
+ *    `execute` y en las tools que no son de fichero: lo escribe en `/large_tool_results/` y al
+ *    modelo le llega la ruta y un extracto de cabeza y cola. Las de fichero no se desalojan —ya
+ *    paginan—, igual que en la librería.
+ * 2. **Trunca** `ls`, `glob` y `grep` por encima de 80.000 caracteres.
+ * 3. **Topa** `grep` en `grepMaxCount` coincidencias.
+ *
+ * Los VALORES son los nuestros de deepagents (`OPCIONES_BUSQUEDA_FICHEROS`), no una copia: dos
+ * motores con dos umbrales serían dos gastos que no se pueden comparar.
+ */
+import { OPCIONES_BUSQUEDA_FICHEROS } from "../../grafo/opcionesDeFicheros.js";
+/** Por encima de esto `ls`/`glob`/`grep` se truncan (el `truncateIfTooLong` de deepagents). */
+export const CARACTERES_ANTES_DE_TRUNCAR = 80_000;
+/** Lo que se conserva al truncar: 20.000 tokens a 4 caracteres, como la librería. */
+const CARACTERES_TRAS_TRUNCAR = 20_000 * 4;
+export const AVISO_DE_TRUNCADO = "\n... [resultados truncados: afina el patrón o la ruta]";
+/** Por encima de esto un resultado de `execute` o de una tool propia se desaloja del contexto. */
+export const CARACTERES_ANTES_DE_DESALOJAR = OPCIONES_BUSQUEDA_FICHEROS.toolTokenLimitBeforeEvict * 4;
+export const MAXIMO_DE_COINCIDENCIAS = OPCIONES_BUSQUEDA_FICHEROS.grepMaxCount;
+export function truncarSiLargo(texto) {
+    return texto.length > CARACTERES_ANTES_DE_TRUNCAR ? texto.slice(0, CARACTERES_TRAS_TRUNCAR) + AVISO_DE_TRUNCADO : texto;
+}
+const numerar = (lineas, desde) => lineas.map((l, i) => `${String(desde + i).padStart(6)}\t${l.slice(0, 1000)}`).join("\n");
+/** Cabeza y cola numeradas, con cuántas líneas se saltan en medio (`createContentPreview`). */
+export function vistaPrevia(texto, cabeza = 5, cola = 5) {
+    const lineas = texto.split("\n");
+    if (lineas.length <= cabeza + cola)
+        return numerar(lineas, 1);
+    return [
+        numerar(lineas.slice(0, cabeza), 1),
+        `... [${lineas.length - cabeza - cola} líneas omitidas] ...`,
+        numerar(lineas.slice(-cola), lineas.length - cola + 1),
+    ].join("\n");
+}
+let secuencia = 0;
+/**
+ * El texto que VE el modelo: el mismo si cabe, o la ruta donde quedó y un extracto si no. Si no
+ * se puede guardar —sin carpeta de artefactos no hay dónde colgar `/large_tool_results/`, y la
+ * guarda del proyecto lo rechaza, como debe— se dice y va el extracto igual: meter el resultado
+ * entero es justo lo que esto evita.
+ */
+export async function desalojarSiGrande(texto, backend, forzar = false) {
+    if (!forzar && texto.length <= CARACTERES_ANTES_DE_DESALOJAR)
+        return texto;
+    const ruta = `/large_tool_results/tf-${Date.now()}-${++secuencia}.txt`;
+    let error;
+    try {
+        const r = (await backend.write(ruta, texto));
+        error = r?.error;
+    }
+    catch (e) {
+        error = e instanceof Error ? e.message : String(e);
+    }
+    const extracto = vistaPrevia(texto);
+    if (error !== undefined) {
+        return `Resultado demasiado grande (${texto.length} caracteres) y no se pudo guardar aparte (${error}). Extracto:\n\n${extracto}`;
+    }
+    return (`Resultado demasiado grande (${texto.length} caracteres): se guardó en ${ruta}. Léelo con read_file por ` +
+        `partes (offset y limit), no entero. Extracto de cabeza y cola:\n\n${extracto}`);
+}
+/**
+ * **El presupuesto de un PASO**, que el recorte de arriba no ve: cada resultado se mira solo, así
+ * que cinco `execute` en paralelo de 20.000 caracteres pasan uno a uno y juntos meten 100.000 en
+ * el contexto. Es la regla del `largeToolResponse` de TrueForge, con su umbral (10.000 tokens),
+ * portada y no montada: con los dos puestos la misma salida se procesaría dos veces.
+ */
+export const CARACTERES_DEL_PASO = 10_000 * 4;
+/** Un error que haya que recortar se TRUNCA a esto en vez de desalojarse: ahí no hay nada que releer. */
+export const CARACTERES_DE_UN_ERROR = 500;
+const textoDelResultado = (r) => typeof r.message.content === "string" ? r.message.content : JSON.stringify(r.message.content ?? "");
+function recortarError(r, texto) {
+    if (texto.length <= CARACTERES_DE_UN_ERROR)
+        return;
+    r.message.content = `${texto.slice(0, CARACTERES_DE_UN_ERROR)}\n... [error truncado: ${texto.length} caracteres]`;
+    r.isStructuredContent = false;
+}
+/**
+ * Los resultados de UN paso, dentro del presupuesto: un error ENORME se trunca, y mientras el
+ * total se pase se desalojan los mayores primero. Modifica los resultados, que es el contrato del
+ * procesador de la librería; no quita ninguno (la librería lanza si falta uno).
+ */
+export async function recortarPaso(resultados, backend) {
+    for (const r of resultados) {
+        const texto = textoDelResultado(r);
+        if (r.failure && texto.length > CARACTERES_ANTES_DE_DESALOJAR)
+            recortarError(r, texto);
+    }
+    let total = resultados.reduce((suma, r) => suma + textoDelResultado(r).length, 0);
+    const porTamano = [...resultados].sort((a, b) => textoDelResultado(b).length - textoDelResultado(a).length);
+    for (const r of porTamano) {
+        if (total <= CARACTERES_DEL_PASO)
+            break;
+        const antes = textoDelResultado(r);
+        if (r.failure)
+            recortarError(r, antes);
+        else {
+            r.message.content = await desalojarSiGrande(antes, backend, true);
+            r.isStructuredContent = false;
+        }
+        total -= antes.length - textoDelResultado(r).length;
+    }
+}
+/** El procesador que TrueForge llama con todos los resultados de un paso. */
+export function presupuestoDelPaso(backend) {
+    return {
+        process: async (resultados) => {
+            await recortarPaso(resultados, backend);
+            return {};
+        },
+    };
+}
+//# sourceMappingURL=recortes.js.map

package/dist/agent/motores/trueforge/recortes.js.map

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