@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/ttsr/captura.js

@@ -0,0 +1,183 @@
+/**
+ * Captura incremental del stream de argumentos de tools (D07, mitad captura).
+ *
+ * El audit (AUDITORIA-OMP.md D07) pide exponer el stream de argumentos como
+ * sistema de primer orden: mientras el modelo va escribiendo el JSON de una
+ * tool call, un observador debe poder ver qué lleva hasta ahora — sin tocar
+ * el contrato actual ni el transcript final.
+ *
+ * Este fichero es la mitad barata: vive bajo `core/ttsr/`, que no existe en
+ * upstream, así que cuesta 0 hunks del presupuesto de sincronización. Se
+ * engancha por la API pública de extensiones (`message_update`, eventos
+ * `toolcall_start/delta/end`) desde `index.ts` — cargable con
+ * `ada-cli -e packages/coding-agent/src/core/ttsr/index.ts`.
+ *
+ * Contrato:
+ *   - Buffer por `toolCallId`: cada delta se AÑADE, nunca se reescribe.
+ *   - Parse parcial tolerante: un JSON cortado a la mitad devuelve lo que se
+ *     pueda entender (`{ ok: true, completo: false }`), jamás lanza.
+ *   - Solo lectura: la captura jamás muta el mensaje parcial ni el historial;
+ *     el transcript final queda intacto hasta que `toolcall_end` entrega la
+ *     tool_call completa.
+ */
+/**
+ * Parse tolerante de JSON en curso. Primero intenta el parse estricto; si el
+ * texto está cortado (cadena abierta, contenedores sin cerrar, literal a
+ * medias), repara lo imprescindible y devuelve lo entendible.
+ */
+export function parseJsonParcial(texto) {
+    try {
+        return { ok: true, valor: JSON.parse(texto), completo: true };
+    }
+    catch {
+        /* seguir con reparación */
+    }
+    const reparado = repararJsonIncompleto(texto);
+    if (reparado === undefined)
+        return { ok: false, valor: undefined, completo: false };
+    try {
+        return { ok: true, valor: JSON.parse(reparado), completo: false };
+    }
+    catch {
+        return { ok: false, valor: undefined, completo: false };
+    }
+}
+/**
+ * Cierra lo que el corte dejó abierto: cadenas, objetos y arrays. Si lo que
+ * queda colgando no cierra limpio, recorta cola y reintenta (los buffers son
+ * pequeños; el coste cuadrático acotado no importa aquí).
+ */
+function repararJsonIncompleto(texto) {
+    let base = texto;
+    // Escape colgante dentro de cadena ("abc\") rompería el cierre: suéltalo.
+    if (/(\\+)$/.test(base) && enCadenaAlFinal(base)) {
+        const cola = base.match(/(\\+)$/)[1];
+        if (cola.length % 2 === 1)
+            base = base.slice(0, -cola.length);
+    }
+    else if (!enCadenaAlFinal(base)) {
+        // Coma final o clave sin valor ("{«a»: «b»,", "{«a»:") no cierran nunca.
+        base = base.replace(/[\s,:]+$/, "");
+    }
+    for (let recortes = 0; recortes <= base.length; recortes++) {
+        const candidato = base.slice(0, base.length - recortes);
+        const candidatoCerrado = candidato + (enCadenaAlFinal(candidato) ? '"' : "") + cierresPendientes(candidato);
+        if (candidatoCerrado.length === 0)
+            continue;
+        try {
+            JSON.parse(candidatoCerrado);
+            return candidatoCerrado;
+        }
+        catch {
+            /* recorta y reintenta */
+        }
+    }
+    return undefined;
+}
+function enCadenaAlFinal(texto) {
+    let enCadena = false;
+    let enEscape = false;
+    for (const c of texto) {
+        if (enCadena) {
+            if (enEscape)
+                enEscape = false;
+            else if (c === "\\")
+                enEscape = true;
+            else if (c === '"')
+                enCadena = false;
+        }
+        else if (c === '"') {
+            enCadena = true;
+        }
+    }
+    return enCadena;
+}
+/** Cierros necesarios para completar los contenedores abiertos del texto. */
+function cierresPendientes(texto) {
+    let enCadena = false;
+    let enEscape = false;
+    const pila = [];
+    for (const c of texto) {
+        if (enCadena) {
+            if (enEscape)
+                enEscape = false;
+            else if (c === "\\")
+                enEscape = true;
+            else if (c === '"')
+                enCadena = false;
+            continue;
+        }
+        if (c === '"')
+            enCadena = true;
+        else if (c === "{" || c === "[")
+            pila.push(c === "{" ? "}" : "]");
+        else if (c === "}" || c === "]")
+            pila.pop();
+    }
+    return pila.reverse().join("");
+}
+/**
+ * Buffer incremental por `toolCallId`. Alimenta `preview.ts`; el transcript
+ * del agente no pasa por aquí, así que esta clase no puede contaminarlo.
+ */
+export class CapturaArgsStream {
+    activas = new Map();
+    /** Orden de llegada, para resolver deltas con id aún vacío. */
+    orden = [];
+    iniciar(id, nombre) {
+        if (!id || this.activas.has(id))
+            return;
+        this.activas.set(id, { nombre, buffer: "", revision: 0, cerrada: false });
+        this.orden.push(id);
+    }
+    /** Añade un fragmento al buffer de la llamada. Devuelve false si no hay llamada activa para ese id. */
+    alimentar(id, delta) {
+        if (!delta)
+            return false;
+        const clave = id || this.orden[this.orden.length - 1] || "";
+        const llamada = clave ? this.activas.get(clave) : undefined;
+        if (!llamada || llamada.cerrada)
+            return false;
+        llamada.buffer += delta;
+        llamada.revision++;
+        return true;
+    }
+    /**
+     * Cierra la captura de una tool_call completa. La entrada queda marcada
+     * cerrada (deltas tardíos se ignoran: integridad del transcript) pero
+     * sigue legible para previews tardíos hasta `descartar()`.
+     */
+    cerrar(id) {
+        const llamada = id ? this.activas.get(id) : undefined;
+        if (!llamada || llamada.cerrada)
+            return undefined;
+        llamada.cerrada = true;
+        const parse = parseJsonParcial(llamada.buffer);
+        return {
+            nombre: llamada.nombre,
+            args: parse.ok && parse.valor && typeof parse.valor === "object" ? parse.valor : {},
+        };
+    }
+    instantanea(id) {
+        const clave = id || this.orden[this.orden.length - 1] || "";
+        const llamada = clave ? this.activas.get(clave) : undefined;
+        if (!llamada)
+            return undefined;
+        return {
+            id: clave,
+            nombre: llamada.nombre,
+            buffer: llamada.buffer,
+            revision: llamada.revision,
+            parse: parseJsonParcial(llamada.buffer),
+        };
+    }
+    ids() {
+        return [...this.orden];
+    }
+    /** Libera todo: fin de turno o aborto. Nada sobrevive al transcript. */
+    descartar() {
+        this.activas.clear();
+        this.orden.length = 0;
+    }
+}
+//# sourceMappingURL=captura.js.map

package/dist/core/ttsr/captura.js.map

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

package/dist/core/ttsr/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * TTSR — enganche del stream de argumentos de tools como sistema observable
+ * (D07). Mitad captura (`captura.ts`) + mitad preview (`preview.ts`), unidas
+ * aquí por la API pública de extensiones, a coste cero contra el presupuesto
+ * de sincronización (este directorio no existe en upstream):
+ *
+ *   ada-cli -e packages/coding-agent/src/core/ttsr/index.ts
+ *
+ * `message_update` entrega los eventos del stream (`toolcall_start`,
+ * `toolcall_delta`, `toolcall_end`); esta extensión SOLO LEE — alimenta el
+ * buffer por toolCallId y deja que un observador pida previews exactly-once.
+ * El transcript final lo escribe el agente con el `toolCall` completo, así
+ * que el contrato actual no cambia y el historial jamás se contamina.
+ *
+ * Migrar a builtin sería una línea en `builtInExtensions` el día que haya
+ * margen — este fichero no cambia (mismo patrón que `core/lsp/extension.ts`).
+ */
+import type { ExtensionAPI } from "../extensions/types.ts";
+import { CapturaArgsStream } from "./captura.ts";
+export { CapturaArgsStream, parseJsonParcial } from "./captura.ts";
+export { MAX_LINEAS_POR_DEFECTO, PreviewEdicion, recortarAUltimaLineaNueva, renderizarArgs } from "./preview.ts";
+export declare function capturaTtsr(): CapturaArgsStream;
+export default function ttsrExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ttsr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/ttsr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAKjH,wBAAgB,WAAW,IAAI,iBAAiB,CAG/C;AAmBD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA2B5D"}

package/dist/core/ttsr/index.js

@@ -0,0 +1,57 @@
+/**
+ * TTSR — enganche del stream de argumentos de tools como sistema observable
+ * (D07). Mitad captura (`captura.ts`) + mitad preview (`preview.ts`), unidas
+ * aquí por la API pública de extensiones, a coste cero contra el presupuesto
+ * de sincronización (este directorio no existe en upstream):
+ *
+ *   ada-cli -e packages/coding-agent/src/core/ttsr/index.ts
+ *
+ * `message_update` entrega los eventos del stream (`toolcall_start`,
+ * `toolcall_delta`, `toolcall_end`); esta extensión SOLO LEE — alimenta el
+ * buffer por toolCallId y deja que un observador pida previews exactly-once.
+ * El transcript final lo escribe el agente con el `toolCall` completo, así
+ * que el contrato actual no cambia y el historial jamás se contamina.
+ *
+ * Migrar a builtin sería una línea en `builtInExtensions` el día que haya
+ * margen — este fichero no cambia (mismo patrón que `core/lsp/extension.ts`).
+ */
+import { CapturaArgsStream } from "./captura.js";
+export { CapturaArgsStream, parseJsonParcial } from "./captura.js";
+export { MAX_LINEAS_POR_DEFECTO, PreviewEdicion, recortarAUltimaLineaNueva, renderizarArgs } from "./preview.js";
+/** Captura viva del proceso: una sola, para que cualquier consumidor vea el mismo stream. */
+let capturaGlobal;
+export function capturaTtsr() {
+    if (!capturaGlobal)
+        capturaGlobal = new CapturaArgsStream();
+    return capturaGlobal;
+}
+/** Extrae el bloque de tool call en construcción del mensaje parcial. */
+function bloqueDeParcial(parcial, contentIndex) {
+    const contenido = parcial?.content;
+    return Array.isArray(contenido) ? contenido[contentIndex] : undefined;
+}
+function idDeParcial(parcial, contentIndex) {
+    const id = bloqueDeParcial(parcial, contentIndex)?.id;
+    return typeof id === "string" ? id : "";
+}
+export default function ttsrExtension(pi) {
+    const captura = capturaTtsr();
+    pi.on("message_update", (event) => {
+        const ev = event.assistantMessageEvent;
+        if (ev.type === "toolcall_start") {
+            const idx = ev.contentIndex ?? 0;
+            const nombre = bloqueDeParcial(ev.partial, idx)?.name;
+            captura.iniciar(idDeParcial(ev.partial, idx) || `sin-id-${captura.ids().length}`, typeof nombre === "string" ? nombre : "");
+        }
+        else if (ev.type === "toolcall_delta") {
+            captura.alimentar(idDeParcial(ev.partial, ev.contentIndex ?? 0), ev.delta ?? "");
+        }
+        else if (ev.type === "toolcall_end") {
+            captura.cerrar(idDeParcial(ev.partial, ev.contentIndex ?? 0));
+        }
+    });
+    pi.on("turn_end", () => {
+        captura.descartar();
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/core/ttsr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/ttsr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjH,6FAA6F;AAC7F,IAAI,aAA4C,CAAC;AAEjD,MAAM,UAAU,WAAW;IAC1B,IAAI,CAAC,aAAa;QAAE,aAAa,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC5D,OAAO,aAAa,CAAC;AACtB,CAAC;AAQD,yEAAyE;AACzE,SAAS,eAAe,CAAC,OAAgB,EAAE,YAAoB;IAC9D,MAAM,SAAS,GAAI,OAA+C,EAAE,OAAO,CAAC;IAC5E,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAE,SAAS,CAAC,YAAY,CAAuC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9G,CAAC;AAED,SAAS,WAAW,CAAC,OAAgB,EAAE,YAAoB;IAC1D,MAAM,EAAE,GAAG,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC;IACtD,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAgB;IACrD,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAE9B,EAAE,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;QACjC,MAAM,EAAE,GAAG,KAAK,CAAC,qBAKhB,CAAC;QACF,IAAI,EAAE,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,IAAI,CAAC,CAAC;YACjC,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC;YACtD,OAAO,CAAC,OAAO,CACd,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,UAAU,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAChE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACxC,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACzC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAClF,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACvC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE;QACtB,OAAO,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/ttsr/preview.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Preview mid-stream de argumentos de tools (D07, mitad preview).
+ *
+ * Sobre la captura incremental (`captura.ts`), renderiza lo que el modelo
+ * lleva escrito de los argumentos y lo recorta a líneas completas: el corte
+ * se hace en la ÚLTIMA línea nueva del render, así que jamás se enseña una
+ * media línea que luego cambiaría por debajo del usuario.
+ *
+ * exactly-once: cada prefijo visible se emite UNA sola vez por toolCallId.
+ * Pedir preview sin datos nuevos devuelve `undefined` — el consumidor puede
+ * llamar en cada delta sin duplicar nada.
+ *
+ * El preview vive fuera del transcript: solo lee de los buffers de captura,
+ * así que el historial final queda intacto hasta que `toolcall_end` entrega
+ * la tool_call completa (contrato D07).
+ */
+import type { InstantaneaArgs, ParseParcial } from "./captura.ts";
+export interface OpcionesPreview {
+    /** Renderer acotado al viewport: máximo de líneas por preview. */
+    maxLineas?: number;
+}
+export declare const MAX_LINEAS_POR_DEFECTO = 24;
+export declare function renderizarArgs(valor: unknown, maxLineas?: number): string[];
+/**
+ * Preview exactly-once sobre una captura incremental. Un objeto por sesión
+ * de streaming; `emitir` es idempotente frente a datos sin cambios.
+ */
+export declare class PreviewEdicion {
+    private ultimoEmitido;
+    private readonly maxLineas;
+    private readonly captura;
+    constructor(captura: {
+        instantanea(id: string): InstantaneaArgs | undefined;
+    }, opciones?: OpcionesPreview);
+    /**
+     * Emite el preview actual de una llamada, o `undefined` si no hay línea
+     * completa nueva desde la última emisión (o si el parse aún no da nada).
+     */
+    emitir(id: string): string | undefined;
+    /** Olvida el último preview emitido (p. ej. al descartar la captura). */
+    reiniciar(): void;
+}
+/**
+ * Corta el render en la última línea nueva: solo líneas completas salen.
+ * Sin ninguna línea nueva todavía → vacío (nada que enseñar con confianza).
+ */
+export declare function recortarAUltimaLineaNueva(parse: ParseParcial, maxLineas: number): string;
+//# sourceMappingURL=preview.d.ts.map

package/dist/core/ttsr/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/core/ttsr/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,WAAW,eAAe;IAC/B,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,SAAyB,GAAG,MAAM,EAAE,CAiB3F;AAED;;;GAGG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2D;gBAEvE,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAA;KAAE,EAAE,QAAQ,CAAC,EAAE,eAAe;IAKzG;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUtC,yEAAyE;IACzE,SAAS,IAAI,IAAI;CAGjB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIxF"}

package/dist/core/ttsr/preview.js

@@ -0,0 +1,83 @@
+/**
+ * Preview mid-stream de argumentos de tools (D07, mitad preview).
+ *
+ * Sobre la captura incremental (`captura.ts`), renderiza lo que el modelo
+ * lleva escrito de los argumentos y lo recorta a líneas completas: el corte
+ * se hace en la ÚLTIMA línea nueva del render, así que jamás se enseña una
+ * media línea que luego cambiaría por debajo del usuario.
+ *
+ * exactly-once: cada prefijo visible se emite UNA sola vez por toolCallId.
+ * Pedir preview sin datos nuevos devuelve `undefined` — el consumidor puede
+ * llamar en cada delta sin duplicar nada.
+ *
+ * El preview vive fuera del transcript: solo lee de los buffers de captura,
+ * así que el historial final queda intacto hasta que `toolcall_end` entrega
+ * la tool_call completa (contrato D07).
+ */
+export const MAX_LINEAS_POR_DEFECTO = 24;
+export function renderizarArgs(valor, maxLineas = MAX_LINEAS_POR_DEFECTO) {
+    if (valor === null || valor === undefined)
+        return [];
+    const brutas = [];
+    if (typeof valor === "string") {
+        brutas.push(valor);
+    }
+    else if (Array.isArray(valor)) {
+        for (const elemento of valor)
+            brutas.push(JSON.stringify(elemento));
+    }
+    else if (typeof valor === "object") {
+        for (const [clave, v] of Object.entries(valor)) {
+            brutas.push(typeof v === "string" ? `${clave}: ${v}` : `${clave}: ${JSON.stringify(v)}`);
+        }
+    }
+    else {
+        brutas.push(String(valor));
+    }
+    // Los valores de cadena traen sus propios saltos: se aplanan a líneas y el
+    // viewport corta sobre el TOTAL, no sobre campos.
+    return brutas.flatMap((linea) => linea.split("\n")).slice(0, maxLineas);
+}
+/**
+ * Preview exactly-once sobre una captura incremental. Un objeto por sesión
+ * de streaming; `emitir` es idempotente frente a datos sin cambios.
+ */
+export class PreviewEdicion {
+    ultimoEmitido = new Map();
+    maxLineas;
+    captura;
+    constructor(captura, opciones) {
+        this.captura = captura;
+        this.maxLineas = opciones?.maxLineas ?? MAX_LINEAS_POR_DEFECTO;
+    }
+    /**
+     * Emite el preview actual de una llamada, o `undefined` si no hay línea
+     * completa nueva desde la última emisión (o si el parse aún no da nada).
+     */
+    emitir(id) {
+        const instantanea = this.captura.instantanea(id);
+        if (!instantanea || !instantanea.parse.ok)
+            return undefined;
+        const visible = recortarAUltimaLineaNueva(instantanea.parse, this.maxLineas);
+        if (!visible)
+            return undefined;
+        if (this.ultimoEmitido.get(instantanea.id) === visible)
+            return undefined;
+        this.ultimoEmitido.set(instantanea.id, visible);
+        return visible;
+    }
+    /** Olvida el último preview emitido (p. ej. al descartar la captura). */
+    reiniciar() {
+        this.ultimoEmitido.clear();
+    }
+}
+/**
+ * Corta el render en la última línea nueva: solo líneas completas salen.
+ * Sin ninguna línea nueva todavía → vacío (nada que enseñar con confianza).
+ */
+export function recortarAUltimaLineaNueva(parse, maxLineas) {
+    const texto = renderizarArgs(parse.valor, maxLineas).join("\n");
+    const corte = texto.lastIndexOf("\n");
+    return corte >= 0 ? texto.slice(0, corte) : "";
+}
+//# sourceMappingURL=preview.js.map

package/dist/core/ttsr/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../src/core/ttsr/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,SAAS,GAAG,sBAAsB;IAChF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,MAAM,QAAQ,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrE,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC3E,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1F,CAAC;IACF,CAAC;SAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,2EAA2E;IAC3E,kDAAkD;IAClD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IAClB,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjC,SAAS,CAAS;IAClB,OAAO,CAA2D;IAEnF,YAAY,OAAiE,EAAE,QAA0B;QACxG,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,QAAQ,EAAE,SAAS,IAAI,sBAAsB,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAC5D,MAAM,OAAO,GAAG,yBAAyB,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,OAAO;YAAE,OAAO,SAAS,CAAC;QACzE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,yEAAyE;IACzE,SAAS;QACR,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAmB,EAAE,SAAiB;IAC/E,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC"}

package/dist/core/turno-vacio/detectar.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Distingue las TRES cosas distintas que puede ser un turno del modelo, porque
+ * confundir dos de ellas es un fallo que se lee como éxito:
+ *
+ *   - `contesto`: trae texto, razonamiento o llamadas a herramienta.
+ *   - `vacio`:    el turno TERMINÓ bien y no trae NADA. El modelo no contestó.
+ *   - `no-pudo`:  error o abortado. No se sabe si habría contestado.
+ *
+ * El caso que lo motiva es real y de hoy: el modelo `x-preview-f-free`
+ * devolvía respuestas vacías y el banco las contaba como «el modelo decidió
+ * no editar» (un `fantasma`). Son cosas opuestas: una habla del modelo, la
+ * otra de que no hubo respuesta que medir. En la sesión interactiva el mismo
+ * turno se veía como silencio, indistinguible de un turno terminado.
+ *
+ * Un detector que grita siempre no vale, así que aquí se calla ante todo lo
+ * que no sea con certeza «nada»: un bloque de tipo desconocido cuenta como
+ * contenido, y un turno con razonamiento (aunque no haya texto) también.
+ */
+/** Los tres estados. Nunca dos, nunca un booleano. */
+export type EstadoDeTurno = "contesto" | "vacio" | "no-pudo";
+/**
+ * Forma mínima de un mensaje de asistente. Se acepta laxa a propósito: por
+ * aquí pasan mensajes de disco (sesiones viejas) y de proveedores que mandan
+ * `content: null`.
+ */
+export interface TurnoDelModelo {
+    content?: unknown;
+    stopReason?: string | null;
+    model?: string;
+}
+/**
+ * `stopReason` llega como `null` desde algunos proveedores y como `undefined`
+ * de sesiones antiguas; los dos significan «no lo sé», no «terminó bien».
+ */
+export declare function estadoDelTurno(turno: TurnoDelModelo): EstadoDeTurno;
+/** El texto que ve el usuario. Dice qué pasó y qué NO pasó. */
+export declare function mensajeDeTurnoVacio(turno: TurnoDelModelo): string;
+//# sourceMappingURL=detectar.d.ts.map

package/dist/core/turno-vacio/detectar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectar.d.ts","sourceRoot":"","sources":["../../../src/core/turno-vacio/detectar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,sDAAsD;AACtD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAuBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAMnE;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CASjE"}

package/dist/core/turno-vacio/detectar.js

@@ -0,0 +1,66 @@
+/**
+ * Distingue las TRES cosas distintas que puede ser un turno del modelo, porque
+ * confundir dos de ellas es un fallo que se lee como éxito:
+ *
+ *   - `contesto`: trae texto, razonamiento o llamadas a herramienta.
+ *   - `vacio`:    el turno TERMINÓ bien y no trae NADA. El modelo no contestó.
+ *   - `no-pudo`:  error o abortado. No se sabe si habría contestado.
+ *
+ * El caso que lo motiva es real y de hoy: el modelo `x-preview-f-free`
+ * devolvía respuestas vacías y el banco las contaba como «el modelo decidió
+ * no editar» (un `fantasma`). Son cosas opuestas: una habla del modelo, la
+ * otra de que no hubo respuesta que medir. En la sesión interactiva el mismo
+ * turno se veía como silencio, indistinguible de un turno terminado.
+ *
+ * Un detector que grita siempre no vale, así que aquí se calla ante todo lo
+ * que no sea con certeza «nada»: un bloque de tipo desconocido cuenta como
+ * contenido, y un turno con razonamiento (aunque no haya texto) también.
+ */
+function tieneContenido(bloques) {
+    if (!Array.isArray(bloques))
+        return false;
+    for (const bloque of bloques) {
+        if (bloque === null || typeof bloque !== "object")
+            continue;
+        const b = bloque;
+        if (b.type === "toolCall")
+            return true;
+        if (b.type === "text") {
+            if (typeof b.text === "string" && b.text.trim() !== "")
+                return true;
+            continue;
+        }
+        if (b.type === "thinking") {
+            if (typeof b.thinking === "string" && b.thinking.trim() !== "")
+                return true;
+            continue;
+        }
+        // Tipo que este módulo no conoce: cuenta como contenido. Preferimos
+        // callarnos antes que acusar de vacío un turno que sí trajo algo.
+        return true;
+    }
+    return false;
+}
+/**
+ * `stopReason` llega como `null` desde algunos proveedores y como `undefined`
+ * de sesiones antiguas; los dos significan «no lo sé», no «terminó bien».
+ */
+export function estadoDelTurno(turno) {
+    const parada = turno.stopReason ?? undefined;
+    if (parada === undefined || parada === "error" || parada === "aborted" || parada === "pending") {
+        return "no-pudo";
+    }
+    return tieneContenido(turno.content) ? "contesto" : "vacio";
+}
+/** El texto que ve el usuario. Dice qué pasó y qué NO pasó. */
+export function mensajeDeTurnoVacio(turno) {
+    const detalles = [];
+    if (turno.model)
+        detalles.push(`modelo ${turno.model}`);
+    if (turno.stopReason)
+        detalles.push(`parada «${turno.stopReason}»`);
+    const cola = detalles.length > 0 ? ` (${detalles.join(", ")})` : "";
+    return (`El modelo no ha contestado: turno sin texto, sin razonamiento y sin llamadas a herramienta${cola}. ` +
+        "No es que haya decidido no hacer nada: no ha devuelto nada.");
+}
+//# sourceMappingURL=detectar.js.map

package/dist/core/turno-vacio/detectar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectar.js","sourceRoot":"","sources":["../../../src/core/turno-vacio/detectar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAgBH,SAAS,cAAc,CAAC,OAAgB;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,SAAS;QAC5D,MAAM,CAAC,GAAG,MAAgE,CAAC;QAC3E,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QACvC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACvB,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,OAAO,IAAI,CAAC;YACpE,SAAS;QACV,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,OAAO,IAAI,CAAC;YAC5E,SAAS;QACV,CAAC;QACD,oEAAoE;QACpE,kEAAkE;QAClE,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC;IAC7C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChG,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;AAC7D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,KAAqB;IACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,UAAU;QAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,OAAO,CACN,6FAA6F,IAAI,IAAI;QACrG,6DAA6D,CAC7D,CAAC;AACH,CAAC"}

package/dist/core/undo/journal.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Diario para deshacer los cambios de ficheros de un turno.
+ *
+ * Guarda el estado ANTERIOR de cada fichero justo antes de tocarlo, agrupado
+ * por turno. `deshacer()` devuelve todos los ficheros del último turno a la vez,
+ * o ninguno: revertir la mitad de un cambio deja el repositorio en un estado que
+ * el agente no produjo nunca y que nadie ha revisado.
+ *
+ * El punto de captura es `withFileMutationQueue`, por donde pasan tanto `edit`
+ * como `write`. Engancharse ahí cubre las dos herramientas con un solo sitio, y
+ * cualquier herramienta futura que escriba ficheros entra gratis.
+ */
+export interface EntradaDiario {
+    turno: number;
+    path: string;
+    /** Contenido anterior; `null` si el fichero no existía (lo creó el turno). */
+    previo: string | null;
+    /** `true` si era demasiado grande para fotografiar. */
+    omitido?: boolean;
+    ts: number;
+}
+/**
+ * Abre un turno nuevo. Todo lo que se escriba a partir de aquí se agrupa junto.
+ *
+ * El número de turno sale del diario, no de un contador en memoria: si el
+ * proceso se reinicia a mitad de sesión, el turno siguiente no puede reutilizar
+ * un número y mezclarse con cambios viejos.
+ */
+export declare function abrirTurno(agentDir: string, cwd: string, ahora: number): number;
+export declare function cerrarTurno(): void;
+/**
+ * Fotografía un fichero antes de que lo toquen.
+ *
+ * Solo la PRIMERA vez dentro del turno: si el agente edita el mismo fichero
+ * cinco veces, deshacer debe devolverlo a como estaba antes de las cinco, no
+ * antes de la última.
+ */
+export declare function registrarPrevio(rutaFichero: string): void;
+export interface ResultadoDeshacer {
+    turno: number | null;
+    restaurados: string[];
+    borrados: string[];
+    omitidos: string[];
+    error?: string;
+}
+/**
+ * Deshace el último turno con cambios. Todo o nada.
+ *
+ * Antes de escribir nada se fotografía el estado actual de cada objetivo; si
+ * una escritura falla a mitad, se devuelven todas atrás. Sin eso, un fallo de
+ * permisos en el tercer fichero dejaría dos revertidos y tres no — un estado
+ * que nadie escribió ni revisó.
+ */
+export declare function deshacer(agentDir: string, cwd: string): ResultadoDeshacer;
+/** Qué haría un `undo` sin llegar a hacerlo. */
+export declare function previsualizar(agentDir: string, cwd: string): EntradaDiario[];
+//# sourceMappingURL=journal.d.ts.map

package/dist/core/undo/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../../src/core/undo/journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACX;AAgBD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA6BzD;AAgBD,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAyDzE;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAI5E"}