@hoilab/ada-cli 0.84.22 → 0.85.1

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.js","sourceRoot":"","sources":["../../../src/core/compactacion/tipos.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2CH,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,CAAU;IACtC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IACpD,OAAO,CAAC,CAAC,OAAO;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC;SAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAmC;IAC/D,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,OAAO,OAAO;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC;SAC5B,IAAI,CAAC,EAAE,CAAC,CAAC;AACZ,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,aAAa,CAAC,KAAa;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,aAAa,CAAC,CAAU;IACvC,IAAI,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE;QAAE,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,CAAC;AACV,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,CAAQ;IACnC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ;QAAE,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC;AACV,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * Compactación a registro denso.
+ *
+ * Punto de entrada que usa la sesión: toma la `CompactionPreparation` (lo que
+ * upstream ya calculó sobre qué se descarta y qué se conserva) y produce un
+ * registro de hechos, sin llamar al modelo y sin poder inventar.
+ *
+ * Por qué el registro se AÑADE al resumen en prosa en vez de sustituirlo
+ * (`anadirRegistroDenso`): sustituirlo dejaba 12 pruebas de upstream en rojo, y
+ * no por capricho suyo — la prosa es el único camino por el que pasan los
+ * reintentos de summarización (#6647), la `usage` que alimenta el contador de
+ * coste de la sesión y la baseUrl resuelta por auth (#6768). Matar ese camino
+ * para ahorrar tokens sale caro: se pierde la síntesis (los "Next Steps", el
+ * porqué de una decisión) y se pierde la contabilidad. Sumar los dos cabe de
+ * sobra en el presupuesto que upstream YA reserva para el resumen: en la sesión
+ * real la prosa gastó 1.073 de los 13.107 tokens disponibles.
+ */
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { CompactionPreparation, CompactionResult } from "../compaction/compaction.ts";
+export * from "./registro-denso.ts";
+/**
+ * Mensajes del lote en el mismo orden en que se numeran los turnos del
+ * registro. Se expone porque las pruebas de procedencia necesitan exactamente
+ * este array: si aquí y en `compactarADenso` se ordenaran distinto, la puerta
+ * de procedencia comprobaría contra los turnos equivocados.
+ */
+export declare function mensajesDelLote(preparation: CompactionPreparation): AgentMessage[];
+/**
+ * Construye SOLO el registro denso de un lote, sin prosa.
+ *
+ * Devuelve `null` cuando no hay ni un hecho que registrar, o cuando no queda
+ * presupuesto para escribirlo. Quien llama se queda con la prosa a secas.
+ *
+ * OJO: `null` NO distingue "no hay hechos" de "no cabe" — son dos cosas
+ * distintas y aquí salen por la misma puerta. Es deliberado y es lo único que
+ * puede serlo: el consumidor (`anadirRegistroDenso`) hace lo mismo en los dos
+ * casos, devolver la prosa intacta. Lo que el registro NO puede hacer es callar
+ * un recorte PARCIAL, y eso no pasa por aquí: lo anuncia `formatearRegistro`
+ * con su línea `[omitidos N hechos por presupuesto: ...]`.
+ */
+export declare function compactarADenso(preparation: CompactionPreparation, presupuestoTokens?: number): CompactionResult | null;
+/**
+ * Añade el registro denso al resultado de la compactación en prosa.
+ *
+ * Este es el punto que llama `AgentSession._runDefaultCompaction`. Si no cabe o
+ * no hay hechos, devuelve el resultado TAL CUAL: la compactación nunca falla ni
+ * se degrada por culpa del registro. `usage`, `details` y `firstKeptEntryId` de
+ * la prosa se respetan — el registro no toca la contabilidad de tokens porque
+ * no ha gastado ninguno.
+ */
+export declare function anadirRegistroDenso(resultado: CompactionResult, preparation: CompactionPreparation): CompactionResult;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/compactar/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAI3F,cAAc,qBAAqB,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,qBAAqB,GAAG,YAAY,EAAE,CAElF;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC9B,WAAW,EAAE,qBAAqB,EAClC,iBAAiB,SAAgC,GAC/C,gBAAgB,GAAG,IAAI,CAoBzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,qBAAqB,GAAG,gBAAgB,CAKrH"}

package/dist/core/compactar/index.js

@@ -0,0 +1,91 @@
+/**
+ * Compactación a registro denso.
+ *
+ * Punto de entrada que usa la sesión: toma la `CompactionPreparation` (lo que
+ * upstream ya calculó sobre qué se descarta y qué se conserva) y produce un
+ * registro de hechos, sin llamar al modelo y sin poder inventar.
+ *
+ * Por qué el registro se AÑADE al resumen en prosa en vez de sustituirlo
+ * (`anadirRegistroDenso`): sustituirlo dejaba 12 pruebas de upstream en rojo, y
+ * no por capricho suyo — la prosa es el único camino por el que pasan los
+ * reintentos de summarización (#6647), la `usage` que alimenta el contador de
+ * coste de la sesión y la baseUrl resuelta por auth (#6768). Matar ese camino
+ * para ahorrar tokens sale caro: se pierde la síntesis (los "Next Steps", el
+ * porqué de una decisión) y se pierde la contabilidad. Sumar los dos cabe de
+ * sobra en el presupuesto que upstream YA reserva para el resumen: en la sesión
+ * real la prosa gastó 1.073 de los 13.107 tokens disponibles.
+ */
+import { computeFileLists } from "../compaction/utils.js";
+import { reescribirADenso, tokensDeTexto } from "./registro-denso.js";
+export * from "./registro-denso.js";
+/**
+ * Mensajes del lote en el mismo orden en que se numeran los turnos del
+ * registro. Se expone porque las pruebas de procedencia necesitan exactamente
+ * este array: si aquí y en `compactarADenso` se ordenaran distinto, la puerta
+ * de procedencia comprobaría contra los turnos equivocados.
+ */
+export function mensajesDelLote(preparation) {
+    return [...preparation.messagesToSummarize, ...preparation.turnPrefixMessages];
+}
+/**
+ * Techo de tokens del resumen completo: el mismo que `generateSummaryWithUsage`
+ * le da a la prosa (0,8 * reserveTokens). El registro se queda con lo que la
+ * prosa no haya gastado, así que el resumen entero nunca crece por encima de lo
+ * que upstream ya reservaba.
+ */
+function presupuestoTotal(preparation) {
+    return Math.floor(0.8 * preparation.settings.reserveTokens);
+}
+/** Por debajo de esto no cabe ni la cabecera del bloque: no vale la pena. */
+const MINIMO_UTIL = 40;
+/**
+ * Construye SOLO el registro denso de un lote, sin prosa.
+ *
+ * Devuelve `null` cuando no hay ni un hecho que registrar, o cuando no queda
+ * presupuesto para escribirlo. Quien llama se queda con la prosa a secas.
+ *
+ * OJO: `null` NO distingue "no hay hechos" de "no cabe" — son dos cosas
+ * distintas y aquí salen por la misma puerta. Es deliberado y es lo único que
+ * puede serlo: el consumidor (`anadirRegistroDenso`) hace lo mismo en los dos
+ * casos, devolver la prosa intacta. Lo que el registro NO puede hacer es callar
+ * un recorte PARCIAL, y eso no pasa por aquí: lo anuncia `formatearRegistro`
+ * con su línea `[omitidos N hechos por presupuesto: ...]`.
+ */
+export function compactarADenso(preparation, presupuestoTokens = presupuestoTotal(preparation)) {
+    const mensajes = mensajesDelLote(preparation);
+    if (mensajes.length === 0)
+        return null;
+    if (presupuestoTokens < MINIMO_UTIL)
+        return null;
+    const registro = reescribirADenso(mensajes, presupuestoTokens, preparation.previousSummary);
+    if (registro.incluidos.length === 0)
+        return null;
+    // Las listas de ficheros siguen yendo en `details` aunque el registro ya
+    // nombre cada fichero: upstream las reinyecta en la SIGUIENTE compactación
+    // (`extractFileOperations`), y romper esa cadena perdería los ficheros de
+    // hace dos compactaciones.
+    const { readFiles, modifiedFiles } = computeFileLists(preparation.fileOps);
+    return {
+        summary: registro.texto,
+        firstKeptEntryId: preparation.firstKeptEntryId,
+        tokensBefore: preparation.tokensBefore,
+        details: { readFiles, modifiedFiles },
+    };
+}
+/**
+ * Añade el registro denso al resultado de la compactación en prosa.
+ *
+ * Este es el punto que llama `AgentSession._runDefaultCompaction`. Si no cabe o
+ * no hay hechos, devuelve el resultado TAL CUAL: la compactación nunca falla ni
+ * se degrada por culpa del registro. `usage`, `details` y `firstKeptEntryId` de
+ * la prosa se respetan — el registro no toca la contabilidad de tokens porque
+ * no ha gastado ninguno.
+ */
+export function anadirRegistroDenso(resultado, preparation) {
+    const restante = presupuestoTotal(preparation) - tokensDeTexto(resultado.summary);
+    const denso = compactarADenso(preparation, restante);
+    if (!denso)
+        return resultado;
+    return { ...resultado, summary: `${resultado.summary}\n\n${denso.summary}` };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/compactar/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEtE,cAAc,qBAAqB,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,WAAkC;IACjE,OAAO,CAAC,GAAG,WAAW,CAAC,mBAAmB,EAAE,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAAC;AAChF,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,WAAkC;IAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AAC7D,CAAC;AAED,6EAA6E;AAC7E,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC9B,WAAkC,EAClC,iBAAiB,GAAG,gBAAgB,CAAC,WAAW,CAAC;IAEjD,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,iBAAiB,GAAG,WAAW;QAAE,OAAO,IAAI,CAAC;IAEjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAC5F,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjD,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,2BAA2B;IAC3B,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAE3E,OAAO;QACN,OAAO,EAAE,QAAQ,CAAC,KAAK;QACvB,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;QAC9C,YAAY,EAAE,WAAW,CAAC,YAAY;QACtC,OAAO,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE;KACrC,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAA2B,EAAE,WAAkC;IAClG,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,OAAO,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;AAC9E,CAAC"}