xonecode 0.5.1 → 0.8.0

package/dist/core/selectorDeCarpeta.js

@@ -0,0 +1,87 @@
+/**
+ * El selector de carpeta NATIVO: qué comando lo abre en cada sistema y cómo se lee su
+ * respuesta.
+ *
+ * **Por qué no lo pone el navegador, que es lo primero que uno intenta.** Una página no
+ * puede devolver una ruta absoluta y no es un descuido de nadie: `showDirectoryPicker()`
+ * entrega un handle del que solo se puede leer el NOMBRE de la carpeta, y un
+ * `<input webkitdirectory>` entrega rutas RELATIVAS a lo elegido. Las dos cosas son
+ * deliberadas —una web no tiene por qué saber cómo está montado tu disco— y las dos son
+ * justo lo que aquí no sirve: `settings.workspace` necesita la ruta entera.
+ *
+ * **Por qué tampoco un explorador propio servido por nosotros.** Se puede: el servidor lista
+ * carpetas y el cliente navega. El precio es que el ÁRBOL DE CARPETAS de la máquina empieza
+ * a viajar por el cable, y eso es exactamente lo que `sinRutas` evita — una ruta del
+ * workspace es la excepción declarada; el mapa del disco entero no lo es, y sería una
+ * excepción mucho más ancha para el mismo resultado.
+ *
+ * **Así que lo abre el sistema donde corre la consola.** Solo cruza el cable la carpeta que
+ * la persona elige, que es la misma que iba a teclear. El precio declarado es que el diálogo
+ * sale en ESA máquina: con la consola por un túnel, el botón no sirve — por eso el campo de
+ * texto sigue siendo el camino principal y esto es un atajo, nunca el único.
+ *
+ * Esta parte es pura: compone el comando y lee su salida. Lanzarlo es de
+ * `agent/config/selectorEnMaquina.ts`.
+ */
+/** Lo que tarda un diálogo en contestar lo pone una persona, así que el tope es largo: solo
+ *  existe para que un diálogo que nadie cierra no deje un proceso vivo para siempre. */
+export const TOPE_DEL_SELECTOR_MS = 5 * 60 * 1000;
+/**
+ * El comando que abre el selector, o AUSENTE si este sistema no tiene ninguno conocido.
+ *
+ * Ausente no es un fallo: es «aquí no hay selector», y entonces no se ofrece el botón. Un
+ * botón que no hace nada es peor que no tenerlo, y el campo de texto ya resuelve el caso.
+ *
+ * `desde` es dónde se abre el diálogo — la carpeta que hay puesta ahora, para no empezar en
+ * un sitio cualquiera. Se pasa como argumento SEPARADO, nunca interpolado en el guion de
+ * AppleScript: ahí dentro una comilla en un nombre de carpeta cerraría la cadena.
+ */
+export function comandoDelSelector(plataforma, desde) {
+    if (plataforma === "darwin") {
+        // `choose folder` con la ubicación por argumento (`argv of me`), y no pegada al guion.
+        // Un `POSIX file` que no existe hace fallar el diálogo entero, así que el guion cae a la
+        // casa cuando no se le da ninguna o la que se le da no vale.
+        const guion = [
+            "on run argumentos",
+            "  set destino to item 1 of argumentos",
+            "  try",
+            '    set inicio to POSIX file destino as alias',
+            "  on error",
+            "    set inicio to path to home folder",
+            "  end try",
+            '  set elegida to choose folder with prompt "Dónde se bajan los proyectos de xonecode" default location inicio',
+            "  return POSIX path of elegida",
+            "end run",
+        ].join("\n");
+        return { programa: "osascript", argumentos: ["-e", guion, desde ?? ""] };
+    }
+    if (plataforma === "linux") {
+        return {
+            programa: "zenity",
+            argumentos: [
+                "--file-selection",
+                "--directory",
+                "--title=Dónde se bajan los proyectos de xonecode",
+                ...(desde === undefined ? [] : [`--filename=${desde.replace(/\/*$/, "/")}`]),
+            ],
+        };
+    }
+    return undefined;
+}
+/**
+ * La carpeta elegida, leída de lo que escupió el comando — o AUSENTE si no se eligió ninguna.
+ *
+ * **Cancelar no es un fallo y se cuenta igual que no elegir.** `osascript` sale con código 1
+ * y `zenity` con 1 cuando la persona cierra el diálogo, así que quien llama no puede
+ * distinguir un «no, gracias» de una avería por el código; lo que sí distingue es que no hay
+ * ruta, y con eso basta: el campo se queda como estaba.
+ *
+ * Se recorta el salto de línea final, que es del terminal y no del dato, y se exige que
+ * empiece por `/`: cualquier otra cosa que salga por ahí no es una carpeta y no se cuela
+ * hasta el validador disfrazada de ruta.
+ */
+export function carpetaDeLaSalida(salida) {
+    const limpia = salida.trim().replace(/\/+$/, "");
+    return limpia.startsWith("/") ? limpia : undefined;
+}
+//# sourceMappingURL=selectorDeCarpeta.js.map

package/dist/core/selectorDeCarpeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectorDeCarpeta.js","sourceRoot":"","sources":["../../src/core/selectorDeCarpeta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;wFACwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAOlD;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,KAAc;IACnE,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,uFAAuF;QACvF,yFAAyF;QACzF,6DAA6D;QAC7D,MAAM,KAAK,GAAG;YACZ,mBAAmB;YACnB,uCAAuC;YACvC,OAAO;YACP,+CAA+C;YAC/C,YAAY;YACZ,uCAAuC;YACvC,WAAW;YACX,+GAA+G;YAC/G,gCAAgC;YAChC,SAAS;SACV,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE;gBACV,kBAAkB;gBAClB,aAAa;gBACb,kDAAkD;gBAClD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;aAC7E;SACF,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC"}

package/dist/core/settings.js

@@ -6,8 +6,8 @@
  * de un cliente. Vive en global y no en el proyecto porque un entorno sirve a muchos
  * proyectos; el proyecto solo guarda a cuál pertenece.
  *
- * TypeScript puro: ni disco ni red. El disco lo pone `agent/settingsEnDisco.ts`, igual
- * que `core/config.ts` deja el I/O a `agent/configEnDisco.ts` y `agent/authEnDisco.ts`.
+ * TypeScript puro: ni disco ni red. El disco lo pone `agent/config/settingsEnDisco.ts`, igual
+ * que `core/config.ts` deja el I/O a `agent/config/configEnDisco.ts` y `agent/config/authEnDisco.ts`.
  */
 import { posix } from "node:path";
 import { CLAVES_DENEGADAS } from "./config.js";
@@ -216,16 +216,27 @@ export function segmentoSeguro(valor, que) {
     return valor;
 }
 /**
- * Dónde queda la copia local de un proyecto.
+ * Dónde queda la copia local de un proyecto: `<workspace>/<entorno>/<proyecto>`.
  *
- * La BASE es configurable (`settings.workspace`); la disposición de dentro NO, porque es
- * lo que hace predecible encontrar una copia sin consultar un índice.
+ * El WORKSPACE es configurable (`settings.workspace`); la disposición de dentro NO, porque
+ * es lo que hace predecible encontrar una copia sin consultar un índice.
+ *
+ * **El literal `workspace` vivía aquí, en MEDIO** (`<base>/<entorno>/workspace/<proyecto>`),
+ * y se ha mudado a la omisión de la base (`~/.xonecode/workspace`). Dos motivos medidos:
+ * con la base en `~/.xonecode`, los ids de los entornos quedaban de HERMANOS de `agentes/`,
+ * `skills/`, `tareas/` y `auth.json` —la casa del harness mezclada con el trabajo—; y quien
+ * eligiera una carpeta suya se encontraba un nivel `workspace/` que no había pedido. Con el
+ * literal en la base, lo que se configura ES el workspace.
+ *
+ * **El segmento del ENTORNO se queda, y no es decoración**: el mismo nombre de proyecto
+ * existe a la vez en dos entornos, y sin ese nivel serían la misma carpeta (ver
+ * `Wizard.tsx`, que ya explica por qué un on-premise necesita id propio).
  */
 /**
  * ¿Esa raíz es una copia que creó xonecode, o una carpeta del usuario?
  *
  * De esto depende si el harness puede COMMITEAR solo al cerrar cada turno. En
- * `<base>/<entorno>/workspace/<proyecto>` la carpeta la creó él y es suya; en la que abrió
+ * `<workspace>/<entorno>/<proyecto>` la carpeta la creó él y es suya; en la que abrió
  * una persona —un proyecto offline, o `./bin/xonecode` dentro de su propio repo— un commit
  * por turno sería ensuciarle el historial cada vez que habla con el agente.
  *
@@ -240,7 +251,45 @@ export function dentroDelWorkspace(raiz, base) {
     const fuera = normal(base);
     return dentro.length > fuera.length && fuera.every((seg, i) => dentro[i] === seg);
 }
+/**
+ * Un `~/…` tecleado, resuelto contra la casa. Solo `~` y `~/…`: un `~otro` es la casa de
+ * OTRA persona en la sintaxis del shell, y aquí no se resuelve — se deja tal cual y se
+ * rechaza después por no ser absoluta.
+ *
+ * Es una comodidad de ENTRADA y nada más. **Lo que se enseña y lo que se guarda es la ruta
+ * ENTERA**: se probó a mandarla abreviada por el cable, para que el caso normal no llevara
+ * el nombre de la cuenta del sistema, y no se sostiene — la cabecera de esa misma consola ya
+ * saluda por el nombre del usuario, así que el `~` no tapaba nada que no estuviera ya, y a
+ * cambio dejaba en pantalla una ruta que no se puede comprobar de un vistazo, que es justo
+ * para lo que ese campo existe. `casa` entra por parámetro: este módulo es puro.
+ */
+export function expandirConCasa(ruta, casa) {
+    const limpio = ruta.trim();
+    if (limpio === "~")
+        return casa;
+    return limpio.startsWith("~/") ? posix.join(casa, limpio.slice(2)) : limpio;
+}
+/**
+ * ¿Vale eso como workspace? Ausente = sí.
+ *
+ * Se comprueba sobre la ruta ya EXPANDIDA. Tres noes, y ninguno es de estilo: vacío no es
+ * una elección, una ruta relativa dependería del directorio desde el que se arrancó la
+ * consola —que no es el proyecto ni nada estable— y la raíz del disco convertiría cada id de
+ * entorno en una carpeta de primer nivel del sistema.
+ */
+export function motivoDeWorkspaceInaceptable(ruta) {
+    const limpio = ruta.trim();
+    if (limpio === "")
+        return "escribe una carpeta: en blanco no es una elección";
+    if (!posix.isAbsolute(limpio)) {
+        return "tiene que ser una ruta absoluta, que empiece por «/» o por «~/»";
+    }
+    if (posix.normalize(limpio).replace(/\/+$/, "") === "") {
+        return "la raíz del disco no: ahí cada entorno sería una carpeta de primer nivel del sistema";
+    }
+    return undefined;
+}
 export function rutaDeWorkspace(base, entorno, proyecto) {
-    return posix.join(base, segmentoSeguro(entorno, "id de entorno"), "workspace", segmentoSeguro(proyecto, "nombre de proyecto"));
+    return posix.join(base, segmentoSeguro(entorno, "id de entorno"), segmentoSeguro(proyecto, "nombre de proyecto"));
 }
 //# sourceMappingURL=settings.js.map

package/dist/core/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/core/settings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/core/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAc,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAqB3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,cAAc,CAAU,CAAC;AAsBzG,2CAA2C;AAC3C,MAAM,UAAU,MAAM,CAAC,OAA0C,EAAE,UAAmC;IACpG,OAAO,OAAO,EAAE,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC;AACzC,CAAC;AAsBD;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAyBhD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAMrC;IACC,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACnE,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,QAAQ,CAAC,WAAW,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAsB;IAC9C,GAAG,gBAAgB;IACnB,OAAO;IACP,UAAU;IACV,YAAY;CACb,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAE9B,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,oBAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAa,EAAE,KAAa;IACnD,OAAO;QACL,KAAK,EAAE,4BAA4B,KAAK,IAAI,KAAK,gGAAgG;QACjJ,SAAS,EAAE,OAAO;KACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,SAAkB,EAAE,MAAe;IACzD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1E,MAAM,CAAC,GAAG,SAAoC,CAAC;IAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5F,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,IAAI,mBAAmB,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC9D,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtE,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAChE,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,sFAAsF;QACtF,mFAAmF;QACnF,UAAU;QACV,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvG,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAChD,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAEhD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,IAAI,mBAAmB,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,OAAO,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9D,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,oBAAoB,GAAG,2BAA2B,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACtF,OAAO;QACL,QAAQ,EAAE;YACR,QAAQ;YACR,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;YACjD,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;YACvD,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;YACzD,GAAG,CAAC,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC;SACxE;QACD,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,oBAAoB,CAAC,SAAkB;IAC9C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACtG,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAoC,CAAC,EAAE,CAAC;QACjF,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpG,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,mBAAmB,CAAC,SAAkB;IAC7C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1E,MAAM,CAAC,GAAG,SAAoC,CAAC;IAC/C,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,KAAK,MAAM,UAAU,IAAI,0BAA0B,EAAE,CAAC;QACpD,IAAI,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,UAAU,CAAY,CAAC;IACxF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,SAAS,2BAA2B,CAAC,SAAkB;IACrD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACpF,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,8BAA8B;QAAE,OAAO,SAAS,CAAC;IAClF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,GAAW;IACvD,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,GAAG,2CAA2C,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAY;IAC3D,MAAM,MAAM,GAAG,CAAC,CAAS,EAAY,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1F,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,mDAAmD,CAAC;IAC9E,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,iEAAiE,CAAC;IAC3E,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;QACvD,OAAO,sFAAsF,CAAC;IAChG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe,EAAE,QAAgB;IAC7E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,cAAc,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC;AACpH,CAAC"}

package/dist/core/shellDeAgente.js

@@ -0,0 +1,144 @@
+/**
+ * El ENTORNO con el que corre la shell de un subagente con ejecución.
+ *
+ * TypeScript puro: aquí se decide QUÉ variables ve esa shell, y quien la monta es
+ * `agent/grafo/proyecto.ts`. Separado por lo de siempre —compuesto dentro del montaje, que
+ * todos los tests doblan, la regla quedaría escrita y no probada—, y porque esto es una
+ * decisión sobre secretos, que es justo lo que no puede depender de acordarse.
+ *
+ * **Lo que se quita, y por qué es obligatorio quitarlo.** `guardarCredencial` escribe la
+ * clave de API TAMBIÉN en `process.env`, a propósito (`agent/config/authEnDisco.ts`). Un
+ * `inheritEnv: true` a secas le pasaría esas claves a la shell del modelo, y entonces un
+ * `printenv` —que es lo primero que hace cualquiera para orientarse— las deja en el
+ * resultado de la tool, o sea en el contexto y en el `.jsonl` de la sesión. No es una fuga
+ * hipotética: es la salida normal de un comando normal.
+ *
+ * Se quitan **por la tabla** (`VARIABLES_POR_PROVEEDOR`, el único sitio donde vive el nombre
+ * de la variable de cada proveedor — hubo cuatro copias y ya habían divergido) más el
+ * prefijo `XONECODE_CLAVE_`, que es el de los proveedores PERSONALIZADOS y por definición no
+ * puede estar en ninguna tabla: el slug lo elige el usuario. Y no se quita todo lo que
+ * empiece por `XONECODE_`, que se llevaría `XONECODE_TRACE_TOOLS` y `XONECODE_MODELO` sin
+ * que sean secretos de nadie.
+ *
+ * **Límite declarado, y conviene no engañarse con él**: esto quita NUESTRAS credenciales,
+ * las que xonecode puso ahí. El entorno de quien arranca el proceso puede traer un
+ * `GITHUB_TOKEN` o un `AWS_SECRET_ACCESS_KEY` suyos, y eso no se filtra — ni se podría con
+ * honestidad, porque «lo que parece una clave» es una heurística y una heurística que falla
+ * en silencio es peor que una regla declarada. Quien concede ejecución concede leer el
+ * entorno y el disco; lo que esto evita es que el harness REGALE lo que él mismo escribió.
+ *
+ * **Y los scripts de una skill se ponen en el PATH, que es lo que quita el problema en vez de
+ * explicarlo.** Medido corriéndolo: el agente tenía DOS espacios de rutas —las virtuales de
+ * `read_file` y las reales de sus comandos— y se pasó decenas de llamadas mezclándolos, leyendo
+ * con `read_file` rutas absolutas que no existen para esa tool y no van a existir nunca. Con los
+ * `scripts/` de cada skill montada en el PATH, un script se llama por su NOMBRE
+ * (`xone-hotswap …`) y no hay ninguna ruta que acertar, ni que meter en el prompt, ni que viaje
+ * en el evento. Un aparato nuevo mañana trae su skill con sus scripts y quedan disponibles solos.
+ *
+ * **Se AÑADEN al final, no al principio.** Prepender dejaría que una skill —que puede venir en
+ * un `.zip` de cualquier sitio— sombreara un binario del sistema llamando a un script suyo `ls`
+ * o `git`. Al final, lo que ya existe gana.
+ *
+ * **Y lo que se AÑADE además son rutas, una variable por cosa.** Una shell ve el disco de verdad,
+ * no nuestras rutas virtuales: `/skills/xone-hotswap/` no existe para ella. Pero meter la
+ * ruta absoluta en el prompt tendría dos precios —el comando que el modelo componga sería el
+ * `detalle` del evento, y ahí no puede viajar una ruta de la máquina (`sinRutas`), y la
+ * raíz no es UNA sino tres con la del proyecto ganando—. Con una variable por skill, el
+ * prompt dice `$XONECODE_SKILL_XONE_HOTSWAP/scripts/android.mjs` y ni el contexto ni el
+ * cable ven una ruta.
+ */
+import { VARIABLES_POR_PROVEEDOR } from "./modelos.js";
+/** El prefijo de las claves de un proveedor personalizado (`core/modelos.ts#variableDeProveedor`). */
+const PREFIJO_DE_CLAVE = "XONECODE_CLAVE_";
+/**
+ * La variable que nombra la carpeta donde dejar lo que se quiera enseñar a una persona.
+ *
+ * Sin ella, un script escribe en el `cwd` —la raíz del proyecto— que es justo lo que
+ * `artefactoFueraDeSitio` prohíbe a las tools de fichero, y una shell no pasa por ahí.
+ */
+export const VARIABLE_DE_ARTEFACTOS = "XONECODE_ARTEFACTOS";
+/**
+ * Cómo se llama la variable que lleva la ruta real de una skill.
+ *
+ * La MISMA derivación que `variableDeProveedor` para un personalizado (mayúsculas y los
+ * guiones a guión bajo): dos formas de convertir un slug en variable son dos formas de
+ * discrepar. El prefijo es otro a propósito — `XONECODE_SKILL_` frente a
+ * `XONECODE_CLAVE_`—, así que una skill no puede fabricarse el nombre de una credencial.
+ */
+export function variableDeSkill(nombre) {
+    return `XONECODE_SKILL_${nombre.toUpperCase().replace(/-/g, "_")}`;
+}
+/**
+ * Las dos rutas de Android que la shell necesita y no puede deducir.
+ *
+ * **Medido en la máquina de desarrollo**: `adb` está en el PATH (`/opt/homebrew/bin/adb`) y
+ * `emulator` **no** —vive en `.../share/android-commandlinetools/emulator/`— con
+ * `ANDROID_HOME` y `ANDROID_SDK_ROOT` vacías. O sea que el caso normal de un Mac con
+ * Homebrew es justo el que deja al agente sin el binario que arranca un emulador.
+ *
+ * Quien sabe dónde está el SDK es `localizadorDeAndroid` (`agent/dispositivos/`), que ya
+ * mira las dos variables de entorno y las raíces por omisión de cada plataforma. Pasarlo por
+ * aquí es lo que evita que el script tenga que adivinarlo: **una segunda regla sobre dónde
+ * vive el SDK es una segunda regla que puede divergir**, y ésta es la clase de cosa que falla
+ * en silencio —el script no encuentra el binario, el modelo se apaña por su cuenta—.
+ *
+ * Va por VARIABLE y no por el prompt por lo mismo que las skills: el comando que el modelo
+ * componga sale como `detalle` del evento, y ahí no puede viajar una ruta de la máquina
+ * (`sinRutas`).
+ */
+export const VARIABLE_DE_EMULATOR = "XONECODE_EMULATOR";
+export const VARIABLE_DE_ADB = "XONECODE_ADB";
+/**
+ * De un localizador de binarios del SDK a las variables que ve la shell.
+ *
+ * PURA y con el localizador por parámetro: así se prueba sin disco, y sobre todo así la
+ * composición de producción no vive dentro de `entornoDeLaShellDelProyecto` —que toca
+ * `process.env` y `existsSync`, y por tanto ningún test suyo podría ver si el localizador
+ * llegó a estar cableado—. Es el patrón de fallo que este repo lleva contadas nueve veces.
+ *
+ * Lo que no se encuentra **no sale**, ni siquiera como cadena vacía: la misma regla que el
+ * resto del módulo. Un `XONECODE_EMULATOR=""` no es «no consta», es una ruta rota que el
+ * script tomaría por buena.
+ */
+export function variablesDeAndroid(enSdk) {
+    const variables = {};
+    const emulator = enSdk("emulator", "emulator");
+    if (emulator !== undefined)
+        variables[VARIABLE_DE_EMULATOR] = emulator;
+    const adb = enSdk("adb", "platform-tools");
+    if (adb !== undefined)
+        variables[VARIABLE_DE_ADB] = adb;
+    return variables;
+}
+export function entornoDeShell(opciones) {
+    const credenciales = new Set(Object.values(VARIABLES_POR_PROVEEDOR));
+    const limpio = {};
+    for (const [clave, valor] of Object.entries(opciones.entorno)) {
+        // Una variable sin valor se DESCARTA en vez de pasarse como cadena vacía: un `PATH=""`
+        // no es «no consta», es un PATH roto.
+        if (valor === undefined)
+            continue;
+        if (credenciales.has(clave))
+            continue;
+        if (clave.startsWith(PREFIJO_DE_CLAVE))
+            continue;
+        limpio[clave] = valor;
+    }
+    for (const skill of opciones.skills ?? []) {
+        limpio[variableDeSkill(skill.nombre)] = skill.dir;
+    }
+    const binarios = opciones.binarios ?? [];
+    if (binarios.length > 0) {
+        // Sin PATH heredado no se parte de vacío: `sh` se inventaría el suyo y perderíamos el del
+        // proceso, que es donde están el `adb` y el `node` del usuario.
+        const actual = limpio["PATH"];
+        limpio["PATH"] = actual === undefined || actual === "" ? binarios.join(":") : [actual, ...binarios].join(":");
+    }
+    if (opciones.artefactos !== undefined)
+        limpio[VARIABLE_DE_ARTEFACTOS] = opciones.artefactos;
+    // Después de la copia del entorno heredado, así que lo que resuelve el localizador gana
+    // sobre un valor que viniera de fuera: el localizador SÍ ha comprobado que el fichero está.
+    Object.assign(limpio, opciones.android ?? {});
+    return limpio;
+}
+//# sourceMappingURL=shellDeAgente.js.map

package/dist/core/shellDeAgente.js.map

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

package/dist/core/skills.js

@@ -0,0 +1,158 @@
+/**
+ * Una skill: el `SKILL.md` que el agente carga bajo demanda, y de quién es.
+ *
+ * **Este módulo es PURO.** Quién lee el disco es `agent/grafo/skills.ts`; quién las monta
+ * para el agente, `agent/grafo/proyecto.ts#backendConSkills`. Aquí solo vive el formato del
+ * fichero y la regla de qué nombre vale — las dos cosas que la ventana de Ajustes, el
+ * cargador y los tests tienen que entender igual.
+ *
+ * **Tres orígenes y no dos**, con la misma precedencia que los subagentes y los modelos:
+ *
+ * | origen | dónde | quién la escribe |
+ * |---|---|---|
+ * | `serie` | la carpeta `skills/` del PAQUETE | xonecode, y no se toca desde la consola |
+ * | `global` | `~/.xonecode/skills/` | el usuario, para todos sus proyectos |
+ * | `proyecto` | `<raiz>/.xonecode/skills/` | el usuario, solo para ese proyecto |
+ *
+ * Las de serie son de SOLO LECTURA y no se borran ni se editan: viven dentro del paquete
+ * instalado, así que una edición se la llevaría por delante el siguiente `npm install` sin
+ * decir nada. Lo que sí se puede es COPIARLA a las tuyas y cambiarla ahí, que además deja
+ * ver de dónde salió. Por eso no hay `.semilla.json` como en los subagentes: nada nuestro
+ * se copia nunca a la casa del usuario, así que no hay marca que llevar ni nada que
+ * restaurar.
+ *
+ * El `SKILL.md` es el formato de Claude Code, y eso no es una coincidencia que convenga
+ * mantener: es lo que hace que una skill escrita para otro harness se lea aquí tal cual, y
+ * que `SkillsMiddleware` de deepagents —que es quien las descubre de verdad— la encuentre
+ * sin que xonecode traduzca nada.
+ */
+import { motivoDeNombreInaceptable, nombreSugerido } from "./agentes.js";
+/** 4 caracteres por token, la regla de servilleta de siempre. */
+export const tokensDeSkill = (texto) => Math.ceil(texto.length / 4);
+/**
+ * El nombre de una skill es un SEGMENTO DE RUTA —la carpeta donde vive— y también lo que el
+ * subagente declara en su `.md`, así que vale la MISMA regla que la de un subagente y por la
+ * misma razón: `motivoDeNombreInaceptable` (`core/agentes.ts`). No se escribe una segunda
+ * aquí porque dos reglas para el mismo tipo de nombre es donde divergen.
+ */
+export const motivoDeNombreDeSkillInaceptable = motivoDeNombreInaceptable;
+export const nombreDeSkillSugerido = nombreSugerido;
+/** El texto que sale del frontmatter cuando un campo lleva caracteres que lo romperían. */
+const enUnaLinea = (texto) => texto.replace(/\r?\n/g, " ").trim();
+/** ¿Esta línea abre la clave `clave` en el primer nivel del frontmatter? */
+const abreClave = (linea, clave) => linea.startsWith(`${clave}:`) && !linea.startsWith(" ") && !linea.startsWith("\t");
+/**
+ * Compone el `SKILL.md`.
+ *
+ * El frontmatter es el mínimo que `parseFrontmatter` (`vendor/skillLoaders/catalog.ts`) y
+ * deepagents leen: `name` y `description`, una línea cada uno. La descripción se aplana a
+ * una línea porque ahí un salto la partiría en dos claves y la segunda mitad se perdería en
+ * silencio — el mismo motivo por el que el nombre es un slug.
+ *
+ * **Y lo demás del frontmatter se CONSERVA**: las claves que no son `name` ni `description`
+ * se reescriben tal cual, en su orden. Componer uno nuevo desde cero le borraba a una skill
+ * escrita a mano su `license`, su `allowed-tools` o su bloque `metadata` en cuanto alguien
+ * abriera la ventana y pulsara Guardar — sin error, sin aviso y sobre un fichero suyo. Las
+ * líneas INDENTADAS van con la clave que las abre, que es lo que deja pasar un bloque
+ * anidado entero sin entender YAML.
+ */
+export function escribirSkill(skill) {
+    const cuerpo = skill.cuerpo.replace(/^\n+/, "");
+    const resto = [];
+    let saltando = false;
+    for (const linea of (skill.frontmatter ?? "").split("\n")) {
+        if (abreClave(linea, "name") || abreClave(linea, "description")) {
+            saltando = true;
+            continue;
+        }
+        // Una línea indentada pertenece a la clave de arriba: si se estaba saltando, se salta.
+        const indentada = /^[ \t]/.test(linea);
+        if (saltando && indentada)
+            continue;
+        saltando = false;
+        if (linea.trim() !== "")
+            resto.push(linea);
+    }
+    const extra = resto.length === 0 ? "" : `${resto.join("\n")}\n`;
+    return `---\nname: ${skill.nombre}\ndescription: ${enUnaLinea(skill.descripcion)}\n${extra}---\n\n${cuerpo}`;
+}
+/**
+ * Lee un `SKILL.md`.
+ *
+ * **El nombre sale de la CARPETA, no del frontmatter**, exactamente como el de un subagente
+ * sale del fichero: es lo que la hace direccionable (`/skills/<nombre>/`) y lo que el
+ * subagente declara. Un `name:` que diga otra cosa se ignora — mandaría sobre una ruta que
+ * ya está decidida, y entonces `rutasDeSkills` apuntaría a una carpeta que no existe.
+ *
+ * **Sin `description` no se carga.** Es lo que el modelo lee para decidir si esta skill le
+ * sirve: sin ella, la skill está en el catálogo y no la usa nadie nunca, que es peor que no
+ * estar. Misma regla que la `descripcion` de un subagente.
+ */
+export function leerSkill(texto, nombreDeCarpeta, origen, ficheros = []) {
+    const { descripcion, frontmatter, cuerpo } = partirFrontmatter(texto);
+    if (descripcion === "")
+        return { error: "no tiene `description` en el frontmatter" };
+    return {
+        skill: {
+            nombre: nombreDeCarpeta,
+            descripcion,
+            cuerpo,
+            frontmatter,
+            origen,
+            tokens: tokensDeSkill(texto),
+            ficheros,
+        },
+    };
+}
+/**
+ * El frontmatter mínimo, sin traer un parser de YAML.
+ *
+ * Es el mismo criterio que `core/agentes.ts` y que `vendor/skillLoaders/catalog.ts`: la
+ * superficie es `clave: valor` de una línea entre `---`, y un parser entero sería una
+ * dependencia para leer dos campos. Lo que no se entiende no se inventa: sin frontmatter,
+ * el fichero entero es cuerpo y la descripción sale vacía, que es lo que `leerSkill`
+ * rechaza.
+ */
+function partirFrontmatter(texto) {
+    if (!texto.startsWith("---"))
+        return { descripcion: "", frontmatter: "", cuerpo: texto };
+    const fin = texto.indexOf("\n---", 3);
+    if (fin === -1)
+        return { descripcion: "", frontmatter: "", cuerpo: texto };
+    // El bloque entero, tal cual, sin los `---` ni el salto que los sigue. Es lo que se enseña
+    // y lo que se conserva al guardar: recomponerlo de las claves que entendemos tiraría las
+    // que no.
+    const frontmatter = texto.slice(3, fin).replace(/^\n/, "");
+    let descripcion = "";
+    for (const linea of frontmatter.split("\n")) {
+        const i = linea.indexOf(":");
+        if (i === -1)
+            continue;
+        if (linea.slice(0, i).trim() === "description")
+            descripcion = linea.slice(i + 1).trim();
+    }
+    const salto = texto.indexOf("\n", fin + 1);
+    return {
+        descripcion,
+        frontmatter,
+        cuerpo: salto === -1 ? "" : texto.slice(salto + 1).replace(/^\n+/, ""),
+    };
+}
+/**
+ * Funde las listas por nombre: la ÚLTIMA gana.
+ *
+ * Se llama con `serie`, `global`, `proyecto` en ese orden, así que una skill del proyecto
+ * tapa a la global del mismo nombre y las dos tapan a la de serie — la misma precedencia
+ * que los subagentes y que los modelos, y por lo mismo: lo particular manda sobre lo
+ * general. Que una tape a otra NO es un problema que reportar: es la forma de afinar una
+ * skill nuestra sin editarla donde el `npm install` la pisaría. Quien lo dice es la ficha,
+ * con su origen al lado.
+ */
+export function fusionarSkills(...listas) {
+    const porNombre = new Map();
+    for (const lista of listas)
+        for (const skill of lista)
+            porNombre.set(skill.nombre, skill);
+    return [...porNombre.values()].sort((a, b) => a.nombre.localeCompare(b.nombre));
+}
+//# sourceMappingURL=skills.js.map

package/dist/core/skills.js.map

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

package/dist/core/topeAgotado.js

@@ -0,0 +1,69 @@
+/**
+ * Lo que se le dice a quien delegó cuando a un especialista se le acabó el presupuesto.
+ *
+ * ## El fallo que cierra, medido el 19-09-2026
+ *
+ * Cada especialista corre con un tope de llamadas al modelo
+ * (`TOPE_DE_LLAMADAS_DEL_ESPECIALISTA`, con `exitBehavior: "end"`). Al agotarse, la librería
+ * añade un `AIMessage` con SU texto —«Model call limits exceeded: run level call limit reached
+ * with 15 model calls»— y salta al final. Y el `task` de deepagents devuelve **solo el último
+ * mensaje** (`extractLastMessage`).
+ *
+ * O sea que lo que el orquestador recibe como respuesta del especialista es esa frase, en
+ * inglés y en jerga del harness, **y todo lo que el especialista averiguó en sus quince
+ * llamadas se tira**. Medido: 100-160k de entrada por especialista, y menos de 900 tokens de
+ * salida devueltos. Por eso el orquestador encadena al siguiente: no es que enrute mal, es que
+ * no recibe nada con lo que seguir.
+ *
+ * **Por eso el tope es NUESTRO** (`topeDeLlamadas`) en vez de parchear el de la librería: sus
+ * dos ganchos de salida —el mensaje y el reset del contador— van detrás de un `jumpTo: "end"`
+ * que cortocircuita todo lo que haya debajo, así que **no corre NINGÚN middleware posterior**
+ * (medido contra la librería real, con `FakeToolCallingModel` y `runLimit: 0`). No había dónde
+ * engancharse: ni `afterAgent`, ni otro `beforeModel`. Reconocer su frase en inglés para
+ * sustituirla habría atado esto a un texto suyo, y encima sin sitio donde hacerlo.
+ *
+ * Esto NO sube el tope —que está medido y argumentado— ni lo quita. Hace tres cosas:
+ * devuelve el trabajo que se iba a tirar, lo marca como PARCIAL para que nadie lo lea como una
+ * conclusión, y dice qué hacer a continuación. Que un presupuesto se agote es normal; que se
+ * agote **en silencio** es el fallo.
+ *
+ * Puro y en `core/`: el texto se puede probar sin librería ni modelo. Quién lo mete en la
+ * conversación es de `agent/`.
+ */
+/**
+ * Cuánto del trabajo parcial se devuelve.
+ *
+ * Hay tope porque esto viaja como respuesta de una `task` y entra ENTERO en el contexto del
+ * orquestador: devolver sin límite convertiría el arreglo de un gasto en otro gasto. Lo que no
+ * cabe se dice, como en todas partes aquí.
+ */
+export const TOPE_DE_PARCIAL = 4_000;
+/**
+ * El mensaje que sustituye al de la librería.
+ *
+ * **Habla con voz del harness y en primera persona del especialista**, porque quien lo va a
+ * leer es el orquestador y lo va a leer como la respuesta de aquél. Y dice las tres cosas que
+ * la frase de la librería no dice: que está a medias, qué había, y qué NO hacer — volver a
+ * encargarle lo mismo a otro es exactamente lo que se midió que pasa.
+ */
+export function mensajeDeTopeAgotado({ limite, parcial }) {
+    const hay = parcial !== undefined && parcial.trim() !== "";
+    const recortado = hay && parcial.length > TOPE_DE_PARCIAL;
+    return [
+        `[harness] Me he quedado sin presupuesto: ${limite} llamadas al modelo, y NO he terminado.`,
+        "",
+        ...(hay
+            ? [
+                "Esto es lo último que tenía, y es PARCIAL — no es una conclusión:",
+                "",
+                recortado ? `${parcial.slice(0, TOPE_DE_PARCIAL)}…` : parcial,
+                ...(recortado ? ["", `(recortado: había ${parcial.length} caracteres)`] : []),
+            ]
+            : ["No llegué a dejar nada en claro: se me fue el presupuesto antes."]),
+        "",
+        "NO se lo encargues igual a otro especialista: gastará su presupuesto en volver a averiguar",
+        "lo mismo. O le pasas lo de arriba en el bloque `HANDOFF DE ANÁLISIS`, o parte el encargo en",
+        "uno más pequeño.",
+    ].join("\n");
+}
+//# sourceMappingURL=topeAgotado.js.map

package/dist/core/topeAgotado.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topeAgotado.js","sourceRoot":"","sources":["../../src/core/topeAgotado.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AASrC;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAe;IACnE,MAAM,GAAG,GAAG,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC3D,MAAM,SAAS,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe,CAAC;IAC1D,OAAO;QACL,4CAA4C,MAAM,yCAAyC;QAC3F,EAAE;QACF,GAAG,CAAC,GAAG;YACL,CAAC,CAAC;gBACE,mEAAmE;gBACnE,EAAE;gBACF,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO;gBAC7D,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,qBAAqB,OAAO,CAAC,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9E;YACH,CAAC,CAAC,CAAC,kEAAkE,CAAC,CAAC;QACzE,EAAE;QACF,4FAA4F;QAC5F,6FAA6F;QAC7F,kBAAkB;KACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}