@hoilab/ada-cli 0.85.0 → 0.85.3

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"}

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

@@ -0,0 +1,38 @@
+/**
+ * Prune cache-aware (A04, Fase 3) — primera planta de la torre.
+ *
+ * Referencia omp: packages/agent/src/compaction/pruning.ts (prompt-cache guard,
+ * cacheWarmSuffixTokens). La regla central: mutar un toolResult antiguo obliga
+ * al proveedor a reescribir TODO el sufijo posterior en la caché cálida
+ * (premium de cacheWrite). Solo se poda cuando el sufijo posterior al candidato
+ * cabe en la "cola barata de re-cache". La guardia es conservadora y determinista:
+ * sin reloj, sin TTL — rechaza y contabiliza.
+ *
+ * Capa pura, sin I/O. Copy-on-write: los turnos no tocados se devuelven tal cual.
+ */
+import { type Turno } from "./tipos.ts";
+export interface PruneConfig {
+    /** Máx. tokens del sufijo posterior al candidato para permitir mutarlo in-place. */
+    sufijoCalienteTokens: number;
+    /** Ahorro mínimo (tokens) para que valga la pena podar un resultado. */
+    minimoAhorro: number;
+    /** Herramientas cuyos resultados nunca se podan (p. ej. "skill"). */
+    herramientasProtegidas: string[];
+}
+export declare const PRUNE_DEFECTO: PruneConfig;
+export interface ResultadoPrune {
+    turnos: Turno[];
+    /** Resultados podados (sustituidos por placeholder). */
+    podados: number;
+    tokensAhorrados: number;
+    /** Candidatos válidos rechazados POR LA GUARDIA DE CACHÉ (sufijo demasiado caro). */
+    rechazadosPorCache: number;
+}
+/**
+ * Poda toolResults antiguos sustituyéndolos por placeholders cortos, SOLO
+ * dentro de la cola barata de re-cache. Nunca toca el primer turno (ancla del
+ * objetivo) ni herramientas protegidas. Los emparejamientos toolCall↔toolResult
+ * se preservan: el placeholder conserva role/toolCallId/toolName.
+ */
+export declare function pruneCacheAware(turnos: readonly Turno[], config?: PruneConfig): ResultadoPrune;
+//# sourceMappingURL=prune.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../../src/core/compactacion/prune.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAiB,KAAK,KAAK,EAA6B,MAAM,YAAY,CAAC;AAElF,MAAM,WAAW,WAAW;IAC3B,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,sBAAsB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,eAAO,MAAM,aAAa,EAAE,WAI3B,CAAC;AAEF,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAiBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,GAAE,WAA2B,GAAG,cAAc,CAoD7G"}

package/dist/core/compactacion/prune.js

@@ -0,0 +1,81 @@
+/**
+ * Prune cache-aware (A04, Fase 3) — primera planta de la torre.
+ *
+ * Referencia omp: packages/agent/src/compaction/pruning.ts (prompt-cache guard,
+ * cacheWarmSuffixTokens). La regla central: mutar un toolResult antiguo obliga
+ * al proveedor a reescribir TODO el sufijo posterior en la caché cálida
+ * (premium de cacheWrite). Solo se poda cuando el sufijo posterior al candidato
+ * cabe en la "cola barata de re-cache". La guardia es conservadora y determinista:
+ * sin reloj, sin TTL — rechaza y contabiliza.
+ *
+ * Capa pura, sin I/O. Copy-on-write: los turnos no tocados se devuelven tal cual.
+ */
+import { estimarTokens, textoBloques, tokensTurno } from "./tipos.js";
+export const PRUNE_DEFECTO = {
+    sufijoCalienteTokens: 8_000,
+    minimoAhorro: 200,
+    herramientasProtegidas: [],
+};
+function contenidoPodado(toolName, toolCallId, tokensOriginales) {
+    return `[podado:${toolName ?? "tool"} ${toolCallId ?? ""}]\n[contenido original (${tokensOriginales} tokens) fuera de contexto]`;
+}
+/**
+ * Poda toolResults antiguos sustituyéndolos por placeholders cortos, SOLO
+ * dentro de la cola barata de re-cache. Nunca toca el primer turno (ancla del
+ * objetivo) ni herramientas protegidas. Los emparejamientos toolCall↔toolResult
+ * se preservan: el placeholder conserva role/toolCallId/toolName.
+ */
+export function pruneCacheAware(turnos, config = PRUNE_DEFECTO) {
+    const protegidas = new Set(config.herramientasProtegidas);
+    // Tokens acumulados del sufijo POSTERIOR a cada turno (para el índice i:
+    // suma de tokensTurno de turnos i+1..n-1).
+    const sufijos = new Array(turnos.length);
+    let acumulado = 0;
+    for (let i = turnos.length - 1; i >= 0; i--) {
+        sufijos[i] = acumulado;
+        acumulado += tokensTurno(turnos[i]);
+    }
+    const candidatos = [];
+    for (let i = 1; i < turnos.length; i++) {
+        for (let j = 0; j < turnos[i].mensajes.length; j++) {
+            const m = turnos[i].mensajes[j];
+            if (m.role !== "toolResult")
+                continue;
+            if (m.toolName !== undefined && protegidas.has(m.toolName))
+                continue;
+            const texto = textoBloques(m.content);
+            if (texto.startsWith("[podado:"))
+                continue;
+            const tokens = estimarTokens(texto);
+            const podado = contenidoPodado(m.toolName, m.toolCallId, tokens);
+            const ahorro = tokens - estimarTokens(podado);
+            if (ahorro < config.minimoAhorro)
+                continue;
+            candidatos.push({ turnoIdx: i, msgIdx: j, contenidoPodado: podado, ahorro });
+        }
+    }
+    let podados = 0;
+    let tokensAhorrados = 0;
+    let rechazadosPorCache = 0;
+    const copias = new Map();
+    for (const c of candidatos) {
+        // Guardia de prompt-cache: mutar aquí reescribe sufijos[c.turnoIdx]
+        // tokens cálidos. Solo permitido si la cola es barata de re-cache.
+        if (sufijos[c.turnoIdx] > config.sufijoCalienteTokens) {
+            rechazadosPorCache++;
+            continue;
+        }
+        let turno = copias.get(c.turnoIdx);
+        if (!turno) {
+            turno = { ...turnos[c.turnoIdx], mensajes: [...turnos[c.turnoIdx].mensajes] };
+            copias.set(c.turnoIdx, turno);
+        }
+        turno.mensajes[c.msgIdx] = { ...turnos[c.turnoIdx].mensajes[c.msgIdx], content: c.contenidoPodado };
+        podados++;
+        tokensAhorrados += c.ahorro;
+    }
+    if (copias.size === 0)
+        return { turnos: [...turnos], podados, tokensAhorrados, rechazadosPorCache };
+    return { turnos: turnos.map((t, i) => copias.get(i) ?? t), podados, tokensAhorrados, rechazadosPorCache };
+}
+//# sourceMappingURL=prune.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * Shake (A04, Fase 3) — segunda planta: colapso mecánico de turnos antiguos.
+ *
+ * Referencia omp: packages/agent/src/compaction/shake.ts. A diferencia de prune
+ * (quirúrgico sobre toolResults dentro de la cola barata), shake reescribe la
+ * historia antigua en bloque — es un reductor de clase compactación: asume que
+ * la caché se reconstruye de todos modos y por eso puede alcanzar el prefijo.
+ *
+ * Anclas que NUNCA se colapsan:
+ * - el turno que contiene el PRIMER mensaje user (objetivo original);
+ * - cualquier turno cuyo toolResult esté referenciado por una toolCall que
+ *   sobrevive en turnos intactos;
+ * - la cola final protegida por `protegerUltimosTokens`.
+ *
+ * Consistencia de emparejamiento: al colapsar un turno se eliminan sus
+ * toolResults JUNTO con las toolCalls del assistant del mismo turno, así que no
+ * quedan referencias colgantes hacia fuera del turno.
+ */
+import { type Turno } from "./tipos.ts";
+export interface ShakeConfig {
+    /** Tokens del final del contexto que quedan intactos. */
+    protegerUltimosTokens: number;
+    /** No hacer nada si el ahorro estimado total queda por debajo. */
+    ahorroMinimo: number;
+}
+export declare const SHAKE_DEFECTO: ShakeConfig;
+export interface ResultadoShake {
+    turnos: Turno[];
+    /** Ids de turnos colapsados. */
+    colapsados: string[];
+    tokensAhorrados: number;
+    /** Turnos elegibles que se saltaron por ancla (referenciado o primer user). */
+    anclasPreservadas: number;
+}
+/**
+ * Colapsa turnos antiguos preservando las anclas. Determinista y puro;
+ * copy-on-write para los turnos supervivientes.
+ */
+export declare function shake(turnos: readonly Turno[], config?: ShakeConfig): ResultadoShake;
+//# sourceMappingURL=shake.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shake.d.ts","sourceRoot":"","sources":["../../../src/core/compactacion/shake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAgB,KAAK,KAAK,EAA6B,MAAM,YAAY,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC3B,yDAAyD;IACzD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,EAAE,WAG3B,CAAC;AAEF,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAuBD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,GAAE,WAA2B,GAAG,cAAc,CAgEnG"}

package/dist/core/compactacion/shake.js

@@ -0,0 +1,106 @@
+/**
+ * Shake (A04, Fase 3) — segunda planta: colapso mecánico de turnos antiguos.
+ *
+ * Referencia omp: packages/agent/src/compaction/shake.ts. A diferencia de prune
+ * (quirúrgico sobre toolResults dentro de la cola barata), shake reescribe la
+ * historia antigua en bloque — es un reductor de clase compactación: asume que
+ * la caché se reconstruye de todos modos y por eso puede alcanzar el prefijo.
+ *
+ * Anclas que NUNCA se colapsan:
+ * - el turno que contiene el PRIMER mensaje user (objetivo original);
+ * - cualquier turno cuyo toolResult esté referenciado por una toolCall que
+ *   sobrevive en turnos intactos;
+ * - la cola final protegida por `protegerUltimosTokens`.
+ *
+ * Consistencia de emparejamiento: al colapsar un turno se eliminan sus
+ * toolResults JUNTO con las toolCalls del assistant del mismo turno, así que no
+ * quedan referencias colgantes hacia fuera del turno.
+ */
+import { textoBloques, tokensTurno } from "./tipos.js";
+export const SHAKE_DEFECTO = {
+    protegerUltimosTokens: 4_000,
+    ahorroMinimo: 500,
+};
+function toolCallIdsDe(m) {
+    return (m.toolCalls ?? []).map((c) => c.id);
+}
+/** Colapsa UN turno: trunca user/assistant a placeholder y elimina pares toolCall↔toolResult internos. */
+function colapsarTurno(t) {
+    const antes = tokensTurno(t);
+    const mensajes = [];
+    for (const m of t.mensajes) {
+        if (m.role === "toolResult")
+            continue; // su toolCall desaparece con el turno
+        if (m.role === "assistant") {
+            mensajes.push({ ...m, content: `[turno ${t.id} colapsado]`, toolCalls: undefined });
+            continue;
+        }
+        const primeraLinea = textoBloques(m.content).split("\n")[0] ?? "";
+        const breadcrumb = primeraLinea.length > 0 ? `: ${primeraLinea.slice(0, 80)}` : "";
+        mensajes.push({ ...m, content: `[turno ${t.id} colapsado${breadcrumb}]` });
+    }
+    return { turno: { ...t, mensajes }, ahorro: antes - tokensTurno({ ...t, mensajes }) };
+}
+/**
+ * Colapsa turnos antiguos preservando las anclas. Determinista y puro;
+ * copy-on-write para los turnos supervivientes.
+ */
+export function shake(turnos, config = SHAKE_DEFECTO) {
+    if (turnos.length === 0) {
+        return { turnos: [], colapsados: [], tokensAhorrados: 0, anclasPreservadas: 0 };
+    }
+    // Ventana protegida: índice desde el que todo queda intacto.
+    let corte = turnos.length;
+    let colaTokens = 0;
+    for (let i = turnos.length - 1; i >= 0; i--) {
+        colaTokens += tokensTurno(turnos[i]);
+        if (colaTokens > config.protegerUltimosTokens)
+            break;
+        corte = i;
+    }
+    // Ancla absoluta: el turno con el primer user message.
+    let idxPrimerUser = -1;
+    for (let i = 0; i < turnos.length; i++) {
+        if (turnos[i].mensajes.some((m) => m.role === "user")) {
+            idxPrimerUser = i;
+            break;
+        }
+    }
+    // toolResultIds referenciados por toolCalls en turnos INTACTOS (>= corte).
+    const referenciadosPorVivos = new Set();
+    for (let i = corte; i < turnos.length; i++) {
+        for (const m of turnos[i].mensajes) {
+            for (const id of toolCallIdsDe(m))
+                referenciadosPorVivos.add(id);
+        }
+    }
+    const colapsados = [];
+    let tokensAhorrados = 0;
+    let anclasPreservadas = 0;
+    const copias = new Map();
+    for (let i = 0; i < corte; i++) {
+        if (i === idxPrimerUser) {
+            anclasPreservadas++;
+            continue;
+        }
+        const tieneReferenciaViva = turnos[i].mensajes.some((m) => m.role === "toolResult" && m.toolCallId !== undefined && referenciadosPorVivos.has(m.toolCallId));
+        if (tieneReferenciaViva) {
+            anclasPreservadas++;
+            continue;
+        }
+        const { turno, ahorro } = colapsarTurno(turnos[i]);
+        copias.set(i, turno);
+        colapsados.push(turnos[i].id);
+        tokensAhorrados += ahorro;
+    }
+    if (tokensAhorrados < config.ahorroMinimo) {
+        return { turnos: [...turnos], colapsados: [], tokensAhorrados: 0, anclasPreservadas };
+    }
+    return {
+        turnos: turnos.map((t, i) => copias.get(i) ?? t),
+        colapsados,
+        tokensAhorrados,
+        anclasPreservadas,
+    };
+}
+//# sourceMappingURL=shake.js.map

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

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

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

@@ -0,0 +1,54 @@
+/**
+ * Tipos compartidos de la torre de compactación (A04, Fase 3).
+ *
+ * Referencia omp: session/session-maintenance.ts y packages/agent/src/compaction/*.
+ * Capa pura: sin I/O. La forma estructural de `Mensaje` es compatible con los
+ * AgentMessage de pi-agent-core (user / assistant / toolResult), de modo que el
+ * llamador puede pasar turnos reales sin conversión.
+ */
+export interface UsoTokens {
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    totalTokens?: number;
+}
+export interface LlamadaTool {
+    id: string;
+    name: string;
+}
+export interface BloqueContenido {
+    type: string;
+    text?: string;
+}
+export interface Mensaje {
+    role: "user" | "assistant" | "toolResult";
+    content: string | BloqueContenido[];
+    /** Solo toolResult: id de la toolCall emparejada. */
+    toolCallId?: string;
+    /** Solo toolResult: nombre de la herramienta. */
+    toolName?: string;
+    /** Solo assistant: llamadas a tools emitidas en este mensaje. */
+    toolCalls?: LlamadaTool[];
+    /** Uso de tokens reportado por el proveedor para este mensaje. */
+    usage?: UsoTokens;
+}
+/**
+ * Un turno conversacional: agrupa el user prompt, la respuesta del asistente,
+ * las toolCalls intermedias y sus toolResults. Las toolResults de un turno solo
+ * referencian toolCalls del MISMO turno (invariante que prune/shake preservan).
+ */
+export interface Turno {
+    id: string;
+    mensajes: Mensaje[];
+}
+/** Texto de un mensaje como string plano (bloques concatenados). */
+export declare function textoMensaje(m: Mensaje): string;
+export declare function textoBloques(content: string | BloqueContenido[]): string;
+/** Estimación grosera de tokens (~4 caracteres por token); suficiente para gates de ahorro. */
+export declare function estimarTokens(texto: string): number;
+/** Tokens estimados de un mensaje. */
+export declare function tokensMensaje(m: Mensaje): number;
+/** Tokens estimados de un turno completo. */
+export declare function tokensTurno(t: Turno): number;
+//# sourceMappingURL=tipos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.d.ts","sourceRoot":"","sources":["../../../src/core/compactacion/tipos.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,SAAS;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;IAC1C,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IACpC,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,kEAAkE;IAClE,KAAK,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAM/C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,GAAG,MAAM,CAMxE;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,sCAAsC;AACtC,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAIhD;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAI5C"}

package/dist/core/compactacion/tipos.js

@@ -0,0 +1,44 @@
+/**
+ * Tipos compartidos de la torre de compactación (A04, Fase 3).
+ *
+ * Referencia omp: session/session-maintenance.ts y packages/agent/src/compaction/*.
+ * Capa pura: sin I/O. La forma estructural de `Mensaje` es compatible con los
+ * AgentMessage de pi-agent-core (user / assistant / toolResult), de modo que el
+ * llamador puede pasar turnos reales sin conversión.
+ */
+/** Texto de un mensaje como string plano (bloques concatenados). */
+export function textoMensaje(m) {
+    if (typeof m.content === "string")
+        return m.content;
+    return m.content
+        .filter((b) => typeof b.text === "string")
+        .map((b) => b.text)
+        .join("\n");
+}
+export function textoBloques(content) {
+    if (typeof content === "string")
+        return content;
+    return content
+        .filter((b) => typeof b.text === "string")
+        .map((b) => b.text)
+        .join("");
+}
+/** Estimación grosera de tokens (~4 caracteres por token); suficiente para gates de ahorro. */
+export function estimarTokens(texto) {
+    return Math.ceil(texto.length / 4);
+}
+/** Tokens estimados de un mensaje. */
+export function tokensMensaje(m) {
+    let n = estimarTokens(textoBloques(m.content));
+    for (const c of m.toolCalls ?? [])
+        n += estimarTokens(c.id + c.name);
+    return n;
+}
+/** Tokens estimados de un turno completo. */
+export function tokensTurno(t) {
+    let n = 0;
+    for (const m of t.mensajes)
+        n += tokensMensaje(m);
+    return n;
+}
+//# sourceMappingURL=tipos.js.map