@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/compactacion/comandos.js

@@ -0,0 +1,155 @@
+/**
+ * Comandos de contexto (SLASH-01): la torre de compactación A04 expuesta como
+ * slash commands. Cada función es el handler del comando: ejecuta el MOTOR
+ * REAL (shake/pruneCacheAware/crearHandoff de este paquete, o AsidesBuffer de
+ * banco/asides.ts) y devuelve una respuesta textual en uno de tres estados:
+ * - "hecho": ejecutó el motor sobre el contexto.
+ * - "nada":  contexto válido pero nada que hacer (ya colapsado, vacío…).
+ * - "uso":   error de uso del comando (falta argumento requerido, etc.).
+ *
+ * Capa pura salvo JournalTree/AsidesBuffer en memoria: sin I/O ni TUI. La capa
+ * interactiva solo despacha y muestra `respuesta`.
+ */
+import { crearHandoff, restaurarDeHandoff } from "./handoff.js";
+import { PRUNE_DEFECTO, pruneCacheAware } from "./prune.js";
+import { SHAKE_DEFECTO, shake } from "./shake.js";
+export function comandoShake(turnos, config) {
+    if (turnos.length === 0) {
+        return {
+            estado: "nada",
+            respuesta: "Contexto vacío: no hay nada que colapsar.",
+            turnos: [],
+            colapsados: 0,
+            tokensAhorrados: 0,
+            anclasPreservadas: 0,
+        };
+    }
+    const r = shake(turnos, { ...SHAKE_DEFECTO, ...config });
+    if (r.colapsados.length === 0) {
+        return {
+            estado: "nada",
+            respuesta: `Nada que colapsar: las anclas y la cola protegida (${SHAKE_DEFECTO.protegerUltimosTokens} tokens) ya cubren todo el contexto.`,
+            turnos: r.turnos,
+            colapsados: 0,
+            tokensAhorrados: 0,
+            anclasPreservadas: r.anclasPreservadas,
+        };
+    }
+    return {
+        estado: "hecho",
+        respuesta: `Colapsados ${r.colapsados.length} turnos antiguos (~${r.tokensAhorrados} tokens ahorrados); preservadas ${r.anclasPreservadas} anclas.`,
+        turnos: r.turnos,
+        colapsados: r.colapsados.length,
+        tokensAhorrados: r.tokensAhorrados,
+        anclasPreservadas: r.anclasPreservadas,
+    };
+}
+function cerrarEnResumen(turnos, verbo, opciones) {
+    if (turnos.length === 0) {
+        return {
+            estado: "nada",
+            respuesta: "No hay contexto que cerrar: la sesión no tiene turnos.",
+        };
+    }
+    const h = crearHandoff(turnos, opciones);
+    const idEntrada = restaurarDeHandoff(h.journal)?.idEntrada ?? "";
+    return {
+        estado: "hecho",
+        respuesta: `${verbo} ${h.info.turnosResumidos} turnos en un resumen mecánico (${h.info.herramientasUsadas.length} herramientas usadas). Journal nuevo "${idEntrada}" con puntero a la hoja "${h.info.hojaOrigen ?? ""}"; la sesión nueva abre solo con <handoff>.`,
+        resultado: h,
+    };
+}
+/** /handoff — cierra la sesión actual: resumen mecánico completo + puntero al journal. */
+export function comandoHandoff(turnos, opciones = {}) {
+    return cerrarEnResumen(turnos, "Sesión cerrada en handoff:", opciones);
+}
+/**
+ * /fresh — sesión nueva conservando SOLO el resumen mínimo (objetivo +
+ * herramientas): sin la cola reciente del asistente, que pertenece a la
+ * sesión vieja. Mismo motor (crearHandoff), resumen deliberadamente más corto.
+ */
+export function comandoFresh(turnos, opciones = {}) {
+    return cerrarEnResumen(turnos, "Sesión nueva lista:", { colaReciente: 0, ...opciones });
+}
+const USO_DROP = "Uso: /drop <n|tool-results> — elimina los últimos N turnos del contexto o poda los resultados antiguos de tools.";
+export function comandoDrop(turnos, arg, config) {
+    const a = arg?.trim();
+    if (!a) {
+        return { estado: "uso", respuesta: USO_DROP, turnos: [...turnos], eliminados: 0, tokensAhorrados: 0 };
+    }
+    if (a === "tool-results") {
+        if (turnos.length === 0) {
+            return {
+                estado: "nada",
+                respuesta: "Contexto vacío: no hay resultados de tools que podar.",
+                turnos: [],
+                eliminados: 0,
+                tokensAhorrados: 0,
+            };
+        }
+        // El slash poda explícitamente: se relaja la guardia de prompt-cache y
+        // el mínimo de ahorro (la decisión la toma el usuario, no la heurística).
+        const r = pruneCacheAware(turnos, {
+            ...PRUNE_DEFECTO,
+            sufijoCalienteTokens: Number.MAX_SAFE_INTEGER,
+            minimoAhorro: 1,
+            ...config,
+        });
+        if (r.podados === 0) {
+            return {
+                estado: "nada",
+                respuesta: "Nada que podar: no queda ningún resultado de tools con contenido.",
+                turnos: r.turnos,
+                eliminados: 0,
+                tokensAhorrados: 0,
+            };
+        }
+        return {
+            estado: "hecho",
+            respuesta: `Podados ${r.podados} resultados de tools (~${r.tokensAhorrados} tokens); quedan como placeholders con su emparejamiento toolCall intacto.`,
+            turnos: r.turnos,
+            eliminados: r.podados,
+            tokensAhorrados: r.tokensAhorrados,
+        };
+    }
+    const n = Number(a);
+    if (!Number.isInteger(n) || n <= 0) {
+        return { estado: "uso", respuesta: USO_DROP, turnos: [...turnos], eliminados: 0, tokensAhorrados: 0 };
+    }
+    const eliminados = Math.min(n, turnos.length);
+    const restantes = turnos.slice(0, turnos.length - eliminados);
+    if (eliminados === 0) {
+        return {
+            estado: "nada",
+            respuesta: "El contexto ya está vacío: no hay turnos que eliminar.",
+            turnos: restantes,
+            eliminados: 0,
+            tokensAhorrados: 0,
+        };
+    }
+    const aviso = restantes.length === 0 ? " Aviso: has eliminado TODO el contexto." : "";
+    return {
+        estado: "hecho",
+        respuesta: `Eliminados los últimos ${eliminados} turnos; quedan ${restantes.length}.${aviso}`,
+        turnos: restantes,
+        eliminados,
+        tokensAhorrados: 0,
+    };
+}
+export function comandoBtw(buffer, nota) {
+    const t = nota?.trim();
+    if (!t) {
+        return {
+            estado: "uso",
+            respuesta: "Uso: /btw <nota> — registra una nota lateral que se drena al final del turno sin interrumpir.",
+            pendientes: buffer.size,
+        };
+    }
+    buffer.push(t);
+    return {
+        estado: "hecho",
+        respuesta: `Nota lateral registrada (${buffer.size} pendiente${buffer.size === 1 ? "" : "s"}); se drenará al final del turno sin interrumpir ninguna tool.`,
+        pendientes: buffer.size,
+    };
+}
+//# sourceMappingURL=comandos.js.map

package/dist/core/compactacion/comandos.js.map

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

package/dist/core/compactacion/extension.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Extensión inline de comandos de contexto (SLASH-01).
+ *
+ * Expone la torre de compactación A04 como slash commands (/handoff, /shake,
+ * /fresh, /drop, /btw). Se registra como extensión inline por defecto desde
+ * `resource-loader.loadBuiltinExtensions` (bloque ya propiedad de Ada: no
+ * cuesta hunks contra el presupuesto de sync) y usa la API pública de
+ * extensiones, igual que `prompt-cache`.
+ *
+ * Contrato de cada comando:
+ * - El handler llama al MOTOR REAL vía ./comandos.ts y muestra `respuesta`
+ *   (tres estados: hecho / nada / uso).
+ * - /handoff y /fresh además persisten el journal del handoff bajo
+ *   `<agentDir>/handoff/` y arrancan una sesión nueva cuyo único contexto es
+ *   el resumen (`ctx.newSession` + `setup`).
+ * - /shake y /drop reescriben el contexto aplicando el motor y arrancan una
+ *   sesión cuyo historial es exactamente el resultado del motor.
+ * - /btw registra una nota lateral en el buffer de asides SIN interrumpir:
+ *   las notas viajan con la próxima operación de contexto (/handoff, /fresh,
+ *   /shake, /drop las siembran en la sesión nueva) y se listan con `/btw` sin
+ *   argumento.
+ */
+import type { ExtensionAPI } from "../extensions/types.ts";
+export interface ContextoExtensionOptions {
+    agentDir: string;
+}
+export declare function crearExtensionContexto(options: ContextoExtensionOptions): (pi: ExtensionAPI) => void;
+//# sourceMappingURL=extension.d.ts.map

package/dist/core/compactacion/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/core/compactacion/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,wBAAwB,CAAC;AAcpF,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAgED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,IAC/D,IAAI,YAAY,KAAG,IAAI,CA+E/B"}

package/dist/core/compactacion/extension.js

@@ -0,0 +1,159 @@
+/**
+ * Extensión inline de comandos de contexto (SLASH-01).
+ *
+ * Expone la torre de compactación A04 como slash commands (/handoff, /shake,
+ * /fresh, /drop, /btw). Se registra como extensión inline por defecto desde
+ * `resource-loader.loadBuiltinExtensions` (bloque ya propiedad de Ada: no
+ * cuesta hunks contra el presupuesto de sync) y usa la API pública de
+ * extensiones, igual que `prompt-cache`.
+ *
+ * Contrato de cada comando:
+ * - El handler llama al MOTOR REAL vía ./comandos.ts y muestra `respuesta`
+ *   (tres estados: hecho / nada / uso).
+ * - /handoff y /fresh además persisten el journal del handoff bajo
+ *   `<agentDir>/handoff/` y arrancan una sesión nueva cuyo único contexto es
+ *   el resumen (`ctx.newSession` + `setup`).
+ * - /shake y /drop reescriben el contexto aplicando el motor y arrancan una
+ *   sesión cuyo historial es exactamente el resultado del motor.
+ * - /btw registra una nota lateral en el buffer de asides SIN interrumpir:
+ *   las notas viajan con la próxima operación de contexto (/handoff, /fresh,
+ *   /shake, /drop las siembran en la sesión nueva) y se listan con `/btw` sin
+ *   argumento.
+ */
+import { mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { AsidesBuffer } from "../banco/asides.js";
+import { comandoBtw, comandoDrop, comandoFresh, comandoHandoff, comandoShake, } from "./comandos.js";
+import { restaurarDeHandoff } from "./handoff.js";
+/** Buffer de notas laterales /btw, compartido por todas las sesiones del proceso. */
+const asidesPendientes = new AsidesBuffer();
+/** Turnos de la rama actual agrupados como la torre los espera (user abre turno). */
+function extraerTurnos(sessionManager) {
+    const turnos = [];
+    let actual;
+    for (const entry of sessionManager.getBranch()) {
+        if (entry.type !== "message")
+            continue;
+        const mensaje = entry.message;
+        if (mensaje.role === "user" || actual === undefined) {
+            actual = { id: entry.id, mensajes: [mensaje] };
+            turnos.push(actual);
+        }
+        else {
+            actual.mensajes.push(mensaje);
+        }
+    }
+    return turnos;
+}
+/** Siembra el historial resultado del motor (y las notas /btw pendientes) en una sesión. */
+async function sembrar(sessionManager, turnos, conAsides) {
+    for (const t of turnos) {
+        for (const m of t.mensajes)
+            sessionManager.appendMessage(m);
+    }
+    if (conAsides && !asidesPendientes.isEmpty()) {
+        const notas = asidesPendientes.drain();
+        const contenido = ["Notas laterales (/btw) pendientes de esta sesión:", ...notas.map((n) => `- ${n}`)].join("\n");
+        sessionManager.appendMessage({ role: "user", content: contenido, timestamp: Date.now() });
+    }
+}
+function notificar(ctx, salida) {
+    ctx.ui?.notify(salida.respuesta, salida.estado === "uso" ? "warning" : "info");
+}
+/**
+ * Arranca una sesión nueva sembrada con el contexto del motor; si se da
+ * `journalDir`, persiste antes el journal del handoff bajo ese directorio.
+ */
+async function reiniciarCon(ctx, salida, journalDir) {
+    const h = salida.resultado;
+    let rutaJournal;
+    if (journalDir) {
+        const idEntrada = restaurarDeHandoff(h.journal)?.idEntrada ?? "handoff";
+        mkdirSync(journalDir, { recursive: true });
+        rutaJournal = join(journalDir, `${idEntrada}.jsonl`);
+        h.journal.saveAtomic(rutaJournal);
+    }
+    await ctx.newSession({
+        setup: async (sm) => {
+            await sembrar(sm, h.sesionNueva, true);
+        },
+    });
+    notificar(ctx, {
+        estado: "hecho",
+        respuesta: rutaJournal ? `${salida.respuesta}\nJournal del handoff: ${rutaJournal}` : salida.respuesta,
+    });
+}
+export function crearExtensionContexto(options) {
+    return (pi) => {
+        const journalDir = join(options.agentDir, "handoff");
+        pi.registerCommand("handoff", {
+            description: "Cierra la sesión en un resumen mecánico y continúa en una sesión nueva (puntero al journal)",
+            handler: async (_args, ctx) => {
+                const salida = comandoHandoff(extraerTurnos(ctx.sessionManager));
+                if (salida.estado !== "hecho" || !salida.resultado) {
+                    notificar(ctx, salida);
+                    return;
+                }
+                await reiniciarCon(ctx, salida, journalDir);
+            },
+        });
+        pi.registerCommand("fresh", {
+            description: "Arranca una sesión nueva conservando solo el resumen mínimo",
+            handler: async (_args, ctx) => {
+                const salida = comandoFresh(extraerTurnos(ctx.sessionManager));
+                if (salida.estado !== "hecho" || !salida.resultado) {
+                    notificar(ctx, salida);
+                    return;
+                }
+                await reiniciarCon(ctx, salida);
+            },
+        });
+        pi.registerCommand("shake", {
+            description: "Colapsa tool calls/results antiguos en placeholders, preservando anclas",
+            handler: async (_args, ctx) => {
+                const salida = comandoShake(extraerTurnos(ctx.sessionManager));
+                if (salida.estado !== "hecho") {
+                    notificar(ctx, salida);
+                    return;
+                }
+                await ctx.newSession({
+                    setup: async (sm) => {
+                        await sembrar(sm, salida.turnos, true);
+                    },
+                });
+                notificar(ctx, salida);
+            },
+        });
+        pi.registerCommand("drop", {
+            description: "Elimina los últimos N turnos o poda los resultados antiguos de tools",
+            handler: async (args, ctx) => {
+                const salida = comandoDrop(extraerTurnos(ctx.sessionManager), args.trim() || undefined);
+                if (salida.estado !== "hecho") {
+                    notificar(ctx, salida);
+                    return;
+                }
+                await ctx.newSession({
+                    setup: async (sm) => {
+                        await sembrar(sm, salida.turnos, true);
+                    },
+                });
+                notificar(ctx, salida);
+            },
+        });
+        pi.registerCommand("btw", {
+            description: "Registra una nota lateral que viaja con la próxima operación de contexto",
+            handler: async (args, ctx) => {
+                const nota = args.trim();
+                if (nota.length === 0 && !asidesPendientes.isEmpty()) {
+                    ctx.ui?.notify(`Notas /btw pendientes:\n${asidesPendientes
+                        .peek()
+                        .map((n) => `- ${n}`)
+                        .join("\n")}`, "info");
+                    return;
+                }
+                notificar(ctx, comandoBtw(asidesPendientes, nota || undefined));
+            },
+        });
+    };
+}
+//# sourceMappingURL=extension.js.map

package/dist/core/compactacion/extension.js.map

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

package/dist/core/compactacion/handoff.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Handoff (A04, Fase 3) — tercera planta: continuar en sesión nueva.
+ *
+ * A diferencia de prune/shake, handoff NO reescribe la historia: cierra la
+ * sesión actual y arranca una nueva cuyo único contexto inicial es un resumen
+ * mecánico + puntero al journal de origen (src/core/sesion/journal-tree.ts,
+ * reutilizado tal cual — árbol id/parentId con persistencia atómica).
+ *
+ * El resumen es determinista (sin LLM): objetivo original (primer user),
+ * herramientas usadas y cola reciente de textos del asistente. La sesión nueva
+ * abre con un mensaje user que porta el resumen dentro de <handoff> junto al
+ * puntero (journalId + hojaOrigen), de modo que el agente puede volver a los
+ * detalles consultando el journal original.
+ */
+import { JournalTree } from "../sesion/journal-tree.ts";
+import { type Turno } from "./tipos.ts";
+export interface OpcionesHandoff {
+    /** Cuántos mensajes assistant recientes incluir en el resumen. Default 3. */
+    colaReciente?: number;
+    /** Id asignado a la entrada handoff en el journal nuevo. */
+    idEntrada?: string;
+}
+export interface HandoffInfo {
+    /** Objetivo original: primer mensaje user de la sesión. */
+    objetivo: string;
+    resumen: string;
+    /** Id del último turno de la sesión cerrada. */
+    hojaOrigen: string | null;
+    turnosResumidos: number;
+    herramientasUsadas: string[];
+}
+export interface HandoffResult {
+    info: HandoffInfo;
+    /** Journal NUEVO con la entrada type="handoff" (puntero + resumen). */
+    journal: JournalTree;
+    /** Contexto inicial de la sesión nueva: user message con resumen + puntero. */
+    sesionNueva: Turno[];
+}
+/**
+ * Cierra `turnos` en un handoff: journal nuevo con la entrada de puntero +
+ * contexto inicial de la sesión nueva. Puro salvo por el JournalTree en memoria
+ * (su persistencia saveAtomic queda a cargo del llamador).
+ */
+export declare function crearHandoff(turnos: readonly Turno[], opciones?: OpcionesHandoff): HandoffResult;
+export interface HandoffRestaurado {
+    resumen: string;
+    hojaOrigen: string | null;
+    turnosResumidos: number;
+    idEntrada: string;
+}
+/**
+ * Restaura el contexto desde un journal de handoff (también funciona tras un
+ * roundtrip saveAtomic/loadAtomic). Toma la ÚLTIMA entrada type="handoff".
+ */
+export declare function restaurarDeHandoff(journal: JournalTree): HandoffRestaurado | undefined;
+/**
+ * Reconstruye el contexto inicial de la sesión nueva desde un journal de
+ * handoff ya cargado (equivalente a sesionNueva de crearHandoff).
+ */
+export declare function continuarTrasHandoff(journal: JournalTree, nuevosTurnos?: readonly Turno[]): Turno[];
+//# sourceMappingURL=handoff.d.ts.map

package/dist/core/compactacion/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../../src/core/compactacion/handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC/B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC3B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,uEAAuE;IACvE,OAAO,EAAE,WAAW,CAAC;IACrB,+EAA+E;IAC/E,WAAW,EAAE,KAAK,EAAE,CAAC;CACrB;AAmDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,QAAQ,GAAE,eAAoB,GAAG,aAAa,CA+BpG;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CActF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,GAAE,SAAS,KAAK,EAAO,GAAG,KAAK,EAAE,CAWvG"}

package/dist/core/compactacion/handoff.js

@@ -0,0 +1,139 @@
+/**
+ * Handoff (A04, Fase 3) — tercera planta: continuar en sesión nueva.
+ *
+ * A diferencia de prune/shake, handoff NO reescribe la historia: cierra la
+ * sesión actual y arranca una nueva cuyo único contexto inicial es un resumen
+ * mecánico + puntero al journal de origen (src/core/sesion/journal-tree.ts,
+ * reutilizado tal cual — árbol id/parentId con persistencia atómica).
+ *
+ * El resumen es determinista (sin LLM): objetivo original (primer user),
+ * herramientas usadas y cola reciente de textos del asistente. La sesión nueva
+ * abre con un mensaje user que porta el resumen dentro de <handoff> junto al
+ * puntero (journalId + hojaOrigen), de modo que el agente puede volver a los
+ * detalles consultando el journal original.
+ */
+import { JournalTree } from "../sesion/journal-tree.js";
+import { textoBloques } from "./tipos.js";
+function extraerObjetivo(turnos) {
+    for (const t of turnos) {
+        for (const m of t.mensajes) {
+            if (m.role !== "user")
+                continue;
+            return textoBloques(m.content);
+        }
+    }
+    return "";
+}
+function extraerHerramientas(turnos) {
+    const usadas = new Set();
+    for (const t of turnos) {
+        for (const m of t.mensajes) {
+            if (m.role === "toolResult" && m.toolName)
+                usadas.add(m.toolName);
+            if (m.role === "assistant")
+                for (const c of m.toolCalls ?? [])
+                    usadas.add(c.name);
+        }
+    }
+    return [...usadas].sort();
+}
+function construirResumen(turnos, colaReciente) {
+    const objetivo = extraerObjetivo(turnos);
+    const herramientas = extraerHerramientas(turnos);
+    const asistentesRecientes = [];
+    for (let i = turnos.length - 1; i >= 0 && asistentesRecientes.length < colaReciente; i--) {
+        for (let j = turnos[i].mensajes.length - 1; j >= 0 && asistentesRecientes.length < colaReciente; j--) {
+            const m = turnos[i].mensajes[j];
+            if (m.role !== "assistant")
+                continue;
+            const texto = textoBloques(m.content).trim();
+            if (texto.length > 0)
+                asistentesRecientes.unshift(texto.slice(0, 400));
+        }
+    }
+    const lineas = [`Objetivo: ${objetivo}`];
+    if (herramientas.length > 0)
+        lineas.push(`Herramientas usadas: ${herramientas.join(", ")}`);
+    if (asistentesRecientes.length > 0)
+        lineas.push(`Estado reciente:\n${asistentesRecientes.map((t) => `- ${t}`).join("\n")}`);
+    return {
+        objetivo,
+        resumen: lineas.join("\n"),
+        hojaOrigen: turnos.length > 0 ? turnos[turnos.length - 1].id : null,
+        turnosResumidos: turnos.length,
+        herramientasUsadas: herramientas,
+    };
+}
+/**
+ * Cierra `turnos` en un handoff: journal nuevo con la entrada de puntero +
+ * contexto inicial de la sesión nueva. Puro salvo por el JournalTree en memoria
+ * (su persistencia saveAtomic queda a cargo del llamador).
+ */
+export function crearHandoff(turnos, opciones = {}) {
+    const colaReciente = opciones.colaReciente ?? 3;
+    const info = construirResumen(turnos, colaReciente);
+    const journal = new JournalTree();
+    const idEntrada = opciones.idEntrada ?? `handoff-${Date.now()}-${Math.floor(Math.random() * 1e6).toString(36)}`;
+    journal.append({
+        id: idEntrada,
+        parentId: null,
+        type: "handoff",
+        data: {
+            resumen: info.resumen,
+            hojaOrigen: info.hojaOrigen,
+            turnosResumidos: info.turnosResumidos,
+            timestamp: new Date().toISOString(),
+        },
+    });
+    const contenidoUser = [
+        `<handoff journal="${idEntrada}" hoja="${info.hojaOrigen ?? ""}" turnos="${info.turnosResumidos}">`,
+        info.resumen,
+        "</handoff>",
+        "",
+        "Continúa la tarea desde este resumen. Los detalles completos están en el journal original referenciado.",
+    ].join("\n");
+    return {
+        info,
+        journal,
+        sesionNueva: [{ id: `${idEntrada}-contexto`, mensajes: [{ role: "user", content: contenidoUser }] }],
+    };
+}
+/**
+ * Restaura el contexto desde un journal de handoff (también funciona tras un
+ * roundtrip saveAtomic/loadAtomic). Toma la ÚLTIMA entrada type="handoff".
+ */
+export function restaurarDeHandoff(journal) {
+    let ultima;
+    for (const e of journal.entries()) {
+        if (e.type !== "handoff")
+            continue;
+        const data = e.data;
+        if (typeof data.resumen !== "string")
+            continue;
+        ultima = {
+            resumen: data.resumen,
+            hojaOrigen: typeof data.hojaOrigen === "string" ? data.hojaOrigen : null,
+            turnosResumidos: typeof data.turnosResumidos === "number" ? data.turnosResumidos : 0,
+            idEntrada: e.id,
+        };
+    }
+    return ultima;
+}
+/**
+ * Reconstruye el contexto inicial de la sesión nueva desde un journal de
+ * handoff ya cargado (equivalente a sesionNueva de crearHandoff).
+ */
+export function continuarTrasHandoff(journal, nuevosTurnos = []) {
+    const h = restaurarDeHandoff(journal);
+    if (!h)
+        return [...nuevosTurnos];
+    const contenidoUser = [
+        `<handoff journal="${h.idEntrada}" hoja="${h.hojaOrigen ?? ""}" turnos="${h.turnosResumidos}">`,
+        h.resumen,
+        "</handoff>",
+        "",
+        "Continúa la tarea desde este resumen. Los detalles completos están en el journal original referenciado.",
+    ].join("\n");
+    return [{ id: `${h.idEntrada}-contexto`, mensajes: [{ role: "user", content: contenidoUser }] }, ...nuevosTurnos];
+}
+//# sourceMappingURL=handoff.js.map

package/dist/core/compactacion/handoff.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * Torre de compactación A04 (Fase 3): prune cache-aware → shake → handoff.
+ *
+ * - prune: quirúrgico sobre toolResults, solo dentro de la cola barata de
+ *   re-cache (guardia de prompt-cache; no reescribe turnos con caché válida).
+ * - shake: colapso mecánico de turnos antiguos preservando anclas (primer user,
+ *   toolResults referenciados por turnos vivos, cola protegida).
+ * - handoff: cierre de sesión con resumen + puntero al journal arbolado
+ *   (reutiliza src/core/sesion/journal-tree.ts) y arranque de sesión nueva.
+ */
+export * from "./handoff.ts";
+export * from "./prune.ts";
+export * from "./shake.ts";
+export * from "./tipos.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/compactacion/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/core/compactacion/index.js

@@ -0,0 +1,15 @@
+/**
+ * Torre de compactación A04 (Fase 3): prune cache-aware → shake → handoff.
+ *
+ * - prune: quirúrgico sobre toolResults, solo dentro de la cola barata de
+ *   re-cache (guardia de prompt-cache; no reescribe turnos con caché válida).
+ * - shake: colapso mecánico de turnos antiguos preservando anclas (primer user,
+ *   toolResults referenciados por turnos vivos, cola protegida).
+ * - handoff: cierre de sesión con resumen + puntero al journal arbolado
+ *   (reutiliza src/core/sesion/journal-tree.ts) y arranque de sesión nueva.
+ */
+export * from "./handoff.js";
+export * from "./prune.js";
+export * from "./shake.js";
+export * from "./tipos.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/compactacion/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}