@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/prompt-cache/payload.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Mutaciones del payload de proveedor para maximizar aciertos de caché.
+ *
+ * Tres cosas, cada una por un motivo distinto:
+ *
+ * 1. `prompt_cache_key` de respaldo. Ada core ya lo pone, pero solo para la URL
+ *    oficial de OpenAI o cuando hay retención larga declarada
+ *    (`openai-completions.ts`). Un endpoint de terceros con retención corta —
+ *    justo el caso de un gateway propio o un proxy — se queda sin clave, y sin
+ *    clave el backend no puede enrutar a un worker con la caché caliente.
+ *
+ * 2. Seguridad de `prompt_cache_retention`. Enviarlo a un endpoint que no lo
+ *    entiende devuelve 400 y tumba la petición entera. Se envía solo cuando se
+ *    sabe que se soporta, y se APRENDE de los 400 vistos.
+ *
+ * 3. Orden de TTL en `cache_control` de Anthropic. La API rechaza un breakpoint
+ *    de 1h que venga detrás de uno de 5m. Es un fallo de orden, no de contenido,
+ *    y se puede reparar sin cambiar nada semántico.
+ */
+export declare function clampCacheKey(sessionId: string | undefined): string | undefined;
+/** ¿El payload ya trae una clave efectiva? Nunca se pisa la del host. */
+export declare function hasCacheKey(payload: Record<string, unknown>): boolean;
+export interface PayloadContext {
+    api: string;
+    baseUrl?: string;
+    sessionId?: string;
+    /** `compat.supportsLongCacheRetention` del modelo. */
+    supportsLongRetention?: boolean;
+    /** Modelos a los que este proceso ya vio devolver 400 por retención. */
+    retentionRejected?: boolean;
+}
+/**
+ * Añade la clave de caché si falta. No sobrescribe nunca: una clave que cambia
+ * entre peticiones es PEOR que ninguna, porque fragmenta el enrutado.
+ */
+export declare function withCacheKey(payload: Record<string, unknown>, ctx: PayloadContext): Record<string, unknown>;
+/**
+ * Decide si `prompt_cache_retention` puede viajar.
+ *
+ * El orden importa: la evidencia empírica (un 400 ya visto) manda sobre la
+ * configuración del usuario. Si no, un opt-in equivocado contra un endpoint que
+ * lo rechaza devuelve 400 para siempre.
+ */
+export declare function retentionAllowed(ctx: PayloadContext): boolean;
+export declare function withRetentionGuard(payload: Record<string, unknown>, ctx: PayloadContext): Record<string, unknown>;
+/** ¿Este error del proveedor es "no entiendo prompt_cache_retention"? */
+export declare function isRetentionUnsupportedError(text: string): boolean;
+/** ¿Es el error de Anthropic por orden de TTL en cache_control? */
+export declare function isAnthropicTtlOrderError(text: string): boolean;
+/**
+ * Recorre los bloques con `cache_control` en ORDEN DE CABLE (tools → system →
+ * messages) y degrada cualquier TTL largo que venga detrás de uno corto.
+ *
+ * Degradar es seguro: se pierde duración de caché, no corrección. Reordenar los
+ * breakpoints sí cambiaría qué se cachea, y eso no es nuestro para decidir.
+ */
+export declare function normalizeAnthropicTtlOrder(payload: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=payload.d.ts.map

package/dist/core/prompt-cache/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/core/prompt-cache/payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAErE;AAED,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAKD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM3G;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAI7D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKjH;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAOD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCpG"}

package/dist/core/prompt-cache/payload.js

@@ -0,0 +1,122 @@
+/**
+ * Mutaciones del payload de proveedor para maximizar aciertos de caché.
+ *
+ * Tres cosas, cada una por un motivo distinto:
+ *
+ * 1. `prompt_cache_key` de respaldo. Ada core ya lo pone, pero solo para la URL
+ *    oficial de OpenAI o cuando hay retención larga declarada
+ *    (`openai-completions.ts`). Un endpoint de terceros con retención corta —
+ *    justo el caso de un gateway propio o un proxy — se queda sin clave, y sin
+ *    clave el backend no puede enrutar a un worker con la caché caliente.
+ *
+ * 2. Seguridad de `prompt_cache_retention`. Enviarlo a un endpoint que no lo
+ *    entiende devuelve 400 y tumba la petición entera. Se envía solo cuando se
+ *    sabe que se soporta, y se APRENDE de los 400 vistos.
+ *
+ * 3. Orden de TTL en `cache_control` de Anthropic. La API rechaza un breakpoint
+ *    de 1h que venga detrás de uno de 5m. Es un fallo de orden, no de contenido,
+ *    y se puede reparar sin cambiar nada semántico.
+ */
+/** Límite documentado de OpenAI para prompt_cache_key. */
+const MAX_CACHE_KEY_LENGTH = 64;
+export function clampCacheKey(sessionId) {
+    const trimmed = sessionId?.trim();
+    if (!trimmed)
+        return undefined;
+    return [...trimmed].slice(0, MAX_CACHE_KEY_LENGTH).join("");
+}
+/** ¿El payload ya trae una clave efectiva? Nunca se pisa la del host. */
+export function hasCacheKey(payload) {
+    return typeof payload.prompt_cache_key === "string" || typeof payload.promptCacheKey === "string";
+}
+/** APIs con forma OpenAI donde `prompt_cache_key` significa algo. */
+const OPENAI_SHAPED = new Set(["openai-completions", "openai-responses"]);
+/**
+ * Añade la clave de caché si falta. No sobrescribe nunca: una clave que cambia
+ * entre peticiones es PEOR que ninguna, porque fragmenta el enrutado.
+ */
+export function withCacheKey(payload, ctx) {
+    if (!OPENAI_SHAPED.has(ctx.api))
+        return payload;
+    if (hasCacheKey(payload))
+        return payload;
+    const key = clampCacheKey(ctx.sessionId);
+    if (!key)
+        return payload;
+    return { ...payload, prompt_cache_key: key };
+}
+/**
+ * Decide si `prompt_cache_retention` puede viajar.
+ *
+ * El orden importa: la evidencia empírica (un 400 ya visto) manda sobre la
+ * configuración del usuario. Si no, un opt-in equivocado contra un endpoint que
+ * lo rechaza devuelve 400 para siempre.
+ */
+export function retentionAllowed(ctx) {
+    if (ctx.baseUrl?.includes("api.openai.com"))
+        return true;
+    if (ctx.retentionRejected)
+        return false;
+    return ctx.supportsLongRetention === true;
+}
+export function withRetentionGuard(payload, ctx) {
+    if (typeof payload.prompt_cache_retention !== "string")
+        return payload;
+    if (retentionAllowed(ctx))
+        return payload;
+    const { prompt_cache_retention: _dropped, ...rest } = payload;
+    return rest;
+}
+/** ¿Este error del proveedor es "no entiendo prompt_cache_retention"? */
+export function isRetentionUnsupportedError(text) {
+    return /prompt_cache_retention/i.test(text) && /unsupported|unknown|unrecognized|invalid/i.test(text);
+}
+/** ¿Es el error de Anthropic por orden de TTL en cache_control? */
+export function isAnthropicTtlOrderError(text) {
+    return /cache_control/i.test(text) && /ttl/i.test(text) && /order|1h|5m/i.test(text);
+}
+/**
+ * Recorre los bloques con `cache_control` en ORDEN DE CABLE (tools → system →
+ * messages) y degrada cualquier TTL largo que venga detrás de uno corto.
+ *
+ * Degradar es seguro: se pierde duración de caché, no corrección. Reordenar los
+ * breakpoints sí cambiaría qué se cachea, y eso no es nuestro para decidir.
+ */
+export function normalizeAnthropicTtlOrder(payload) {
+    const holders = [];
+    const collect = (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                collect(item);
+            return;
+        }
+        if (!value || typeof value !== "object")
+            return;
+        const record = value;
+        if (record.cache_control && typeof record.cache_control === "object")
+            holders.push(record);
+        for (const nested of Object.values(record)) {
+            if (nested && typeof nested === "object")
+                collect(nested);
+        }
+    };
+    // Orden de cable, no de objeto: es el que valida Anthropic.
+    collect(payload.tools);
+    collect(payload.system);
+    collect(payload.messages);
+    let seenShort = false;
+    let changed = false;
+    for (const holder of holders) {
+        const ttl = holder.cache_control?.ttl;
+        if (ttl === "5m" || ttl === undefined) {
+            seenShort = true;
+            continue;
+        }
+        if (ttl === "1h" && seenShort) {
+            holder.cache_control = { ...holder.cache_control, ttl: "5m" };
+            changed = true;
+        }
+    }
+    return changed ? { ...payload } : payload;
+}
+//# sourceMappingURL=payload.js.map

package/dist/core/prompt-cache/payload.js.map

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

package/dist/core/prompt-cache/stabilize.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Estabilización del prefijo del prompt.
+ *
+ * Las cachés de prompt (DeepSeek, OpenAI, Anthropic) casan por PREFIJO: un byte
+ * distinto en la posición N invalida todo lo que va detrás. En DeepSeek el hit
+ * cuesta ~31x menos que el miss, así que el coste de un cambio no es
+ * proporcional a su tamaño sino a su POSICIÓN.
+ *
+ * Esto reordena el system prompt para que todo lo estable quede por delante y lo
+ * dinámico detrás de un separador, de modo que el sufijo invalidado sea lo más
+ * pequeño posible.
+ *
+ * Dos decisiones de diseño que no son obvias:
+ *
+ * 1. Los candidatos ANIDAN — el bloque de un context file contiene su propio
+ *    contenido a secas. Por eso las ocurrencias se cuentan contra UNA instantánea
+ *    inmutable del prompt original, no contra el texto que va quedando: recontar
+ *    tras cada extracción daría resultados incoherentes. Cualquier candidato que
+ *    no aparezca EXACTAMENTE una vez se deja en su sitio.
+ *
+ * 2. Hay guardia de integridad. Si tras reordenar desaparece cualquier marcador
+ *    estructural (una etiqueta, un delimitador), se descarta la reescritura
+ *    entera y se devuelve el original. Un reordenado con un bug que corrompe el
+ *    prompt en silencio es mucho peor que no cachear.
+ */
+/** Separador entre la zona estable y la dinámica. */
+export declare const STABLE_SEPARATOR = "\n\n---\n\n";
+export declare function isStableContextFile(path: string): boolean;
+export interface StabilizeInput {
+    /** El system prompt ya ensamblado. */
+    prompt: string;
+    /** Prompt de sistema propio del usuario, si lo hay. */
+    customPrompt?: string;
+    /** Bloques añadidos al final (incluye la personalidad del engine). */
+    appendSystemPrompt?: string;
+    /** Guidelines por tool. */
+    promptGuidelines?: string[];
+    /** Ficheros de contexto cargados. */
+    contextFiles?: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+export interface StabilizeResult {
+    prompt: string;
+    /** Cuántos bloques se subieron al prefijo estable. */
+    lifted: number;
+    /** True si la guardia de integridad descartó la reescritura. */
+    rolledBack: boolean;
+}
+/**
+ * Marcadores estructurales: etiquetas y delimitadores de bloque. Si el
+ * reordenado pierde alguno, algo se ha comido texto.
+ */
+export declare function extractStructuralMarkers(text: string): string[];
+/** Construye los bloques candidatos a subir, en orden determinista. */
+export declare function buildStableCandidates(input: StabilizeInput): string[];
+/**
+ * Reordena el prompt: estable primero, dinámico después del separador.
+ *
+ * No-op seguro: si nada casa exactamente una vez, o si la guardia de integridad
+ * salta, devuelve el prompt original sin tocar.
+ */
+export declare function stabilizeSystemPrompt(input: StabilizeInput): StabilizeResult;
+//# sourceMappingURL=stabilize.d.ts.map

package/dist/core/prompt-cache/stabilize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stabilize.d.ts","sourceRoot":"","sources":["../../../src/core/prompt-cache/stabilize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAW9C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,MAAM,WAAW,cAAc;IAC9B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2BAA2B;IAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,qCAAqC;IACrC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/D;AAED,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAkBrE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAuD5E"}

package/dist/core/prompt-cache/stabilize.js

@@ -0,0 +1,137 @@
+/**
+ * Estabilización del prefijo del prompt.
+ *
+ * Las cachés de prompt (DeepSeek, OpenAI, Anthropic) casan por PREFIJO: un byte
+ * distinto en la posición N invalida todo lo que va detrás. En DeepSeek el hit
+ * cuesta ~31x menos que el miss, así que el coste de un cambio no es
+ * proporcional a su tamaño sino a su POSICIÓN.
+ *
+ * Esto reordena el system prompt para que todo lo estable quede por delante y lo
+ * dinámico detrás de un separador, de modo que el sufijo invalidado sea lo más
+ * pequeño posible.
+ *
+ * Dos decisiones de diseño que no son obvias:
+ *
+ * 1. Los candidatos ANIDAN — el bloque de un context file contiene su propio
+ *    contenido a secas. Por eso las ocurrencias se cuentan contra UNA instantánea
+ *    inmutable del prompt original, no contra el texto que va quedando: recontar
+ *    tras cada extracción daría resultados incoherentes. Cualquier candidato que
+ *    no aparezca EXACTAMENTE una vez se deja en su sitio.
+ *
+ * 2. Hay guardia de integridad. Si tras reordenar desaparece cualquier marcador
+ *    estructural (una etiqueta, un delimitador), se descarta la reescritura
+ *    entera y se devuelve el original. Un reordenado con un bug que corrompe el
+ *    prompt en silencio es mucho peor que no cachear.
+ */
+/** Por debajo de esto un "candidato" es ruido que aparece en cualquier sitio. */
+const MIN_CANDIDATE_LENGTH = 8;
+/** Separador entre la zona estable y la dinámica. */
+export const STABLE_SEPARATOR = "\n\n---\n\n";
+/**
+ * Ficheros de contexto que se consideran estables.
+ *
+ * El tamaño NO es criterio: un fichero grande puede cambiar cada turno. Solo se
+ * suben ficheros de instrucciones cuyo contenido se sabe estable durante la
+ * sesión.
+ */
+const STABLE_CONTEXT_FILES = /(^|\/)(agents(\.override)?\.md|claude\.md|gemini\.md|cursor\.md)$/i;
+export function isStableContextFile(path) {
+    return STABLE_CONTEXT_FILES.test(path.replace(/\\/g, "/").toLowerCase());
+}
+/**
+ * Marcadores estructurales: etiquetas y delimitadores de bloque. Si el
+ * reordenado pierde alguno, algo se ha comido texto.
+ */
+export function extractStructuralMarkers(text) {
+    const markers = [];
+    for (const match of text.matchAll(/<\/?[a-zA-Z][\w-]*>/g))
+        markers.push(match[0]);
+    for (const match of text.matchAll(/<!--\s*[A-Z_]+:(START|END)\s*-->/g))
+        markers.push(match[0]);
+    return markers.sort();
+}
+/** Construye los bloques candidatos a subir, en orden determinista. */
+export function buildStableCandidates(input) {
+    const candidates = [];
+    const push = (value) => {
+        const trimmed = value?.trim();
+        if (trimmed && trimmed.length >= MIN_CANDIDATE_LENGTH)
+            candidates.push(trimmed);
+    };
+    push(input.customPrompt);
+    push(input.appendSystemPrompt);
+    for (const guideline of input.promptGuidelines ?? [])
+        push(`- ${guideline}`);
+    for (const file of input.contextFiles ?? []) {
+        if (!isStableContextFile(file.path))
+            continue;
+        // Dos formas: con cabecera de ruta y sin ella. El ensamblador puede usar
+        // cualquiera de las dos y solo una casará.
+        push(`## ${file.path}\n\n${file.content}`);
+        push(file.content);
+    }
+    return candidates;
+}
+/**
+ * Reordena el prompt: estable primero, dinámico después del separador.
+ *
+ * No-op seguro: si nada casa exactamente una vez, o si la guardia de integridad
+ * salta, devuelve el prompt original sin tocar.
+ */
+export function stabilizeSystemPrompt(input) {
+    const original = input.prompt;
+    if (!original.trim())
+        return { prompt: original, lifted: 0, rolledBack: false };
+    const candidates = buildStableCandidates(input);
+    if (candidates.length === 0)
+        return { prompt: original, lifted: 0, rolledBack: false };
+    // Contar SIEMPRE contra la instantánea original: los candidatos anidan.
+    const snapshot = original;
+    const occurrencesOf = (needle) => {
+        let count = 0;
+        let from = 0;
+        while (true) {
+            const at = snapshot.indexOf(needle, from);
+            if (at === -1)
+                break;
+            count++;
+            from = at + needle.length;
+            if (count > 1)
+                break; // con saber que hay más de una basta
+        }
+        return count;
+    };
+    const stable = [];
+    let rest = original;
+    const seen = new Set();
+    for (const candidate of candidates) {
+        if (seen.has(candidate))
+            continue;
+        if (occurrencesOf(candidate) !== 1)
+            continue;
+        const at = rest.indexOf(candidate);
+        if (at === -1)
+            continue; // ya extraído dentro de otro candidato
+        seen.add(candidate);
+        stable.push(candidate);
+        rest = rest.slice(0, at) + rest.slice(at + candidate.length);
+    }
+    if (stable.length === 0)
+        return { prompt: original, lifted: 0, rolledBack: false };
+    const stableJoined = stable.join("\n\n");
+    // Ya estabilizado: sin esto una segunda pasada apilaría otro separador y el
+    // prefijo se movería en cada turno — exactamente lo contrario de lo que
+    // buscamos. La idempotencia no es elegancia aquí, es la propiedad.
+    if (original.startsWith(stableJoined + STABLE_SEPARATOR)) {
+        return { prompt: original, lifted: 0, rolledBack: false };
+    }
+    const rewritten = `${stableJoined}${STABLE_SEPARATOR}${rest.trim()}`;
+    // Guardia de integridad: ningún marcador estructural puede desaparecer.
+    const before = extractStructuralMarkers(original);
+    const after = extractStructuralMarkers(rewritten);
+    if (before.length !== after.length || before.some((m, i) => m !== after[i])) {
+        return { prompt: original, lifted: 0, rolledBack: true };
+    }
+    return { prompt: rewritten, lifted: stable.length, rolledBack: false };
+}
+//# sourceMappingURL=stabilize.js.map

package/dist/core/prompt-cache/stabilize.js.map

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

package/dist/core/prompt-cache/stats.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Lectura y persistencia de estadísticas de caché.
+ *
+ * Sin medición, todo lo demás es fe. Cada familia de proveedor reporta el uso de
+ * caché con nombres distintos, y algunos proxies los omiten — en cuyo caso hay
+ * que decirlo en vez de mostrar un 0% que parece un problema de caché cuando en
+ * realidad es un problema de telemetría.
+ */
+export interface CacheUsage {
+    /** Tokens de entrada servidos desde caché. */
+    cacheRead: number;
+    /** Tokens escritos a la caché (Anthropic los cobra aparte). */
+    cacheWrite: number;
+    /** Total de tokens de entrada, incluyendo los cacheados. */
+    totalInput: number;
+    /** True si el proveedor no reportó campos de caché (≠ 0 aciertos). */
+    missingFields: boolean;
+}
+/**
+ * Normaliza el usage de cualquier familia de proveedor.
+ *
+ * Los nombres NO son intercambiables:
+ * - DeepSeek: `prompt_cache_hit_tokens` + `prompt_cache_miss_tokens` suman el total.
+ * - OpenAI: `prompt_tokens_details.cached_tokens` es un SUBCONJUNTO de `prompt_tokens`.
+ * - Anthropic: `input_tokens` EXCLUYE lo cacheado, así que hay que sumarlo.
+ * - Gemini: `cachedContentTokenCount` sobre `promptTokenCount`.
+ */
+export declare function readCacheUsage(raw: unknown): CacheUsage;
+export interface ModelCacheStats {
+    day: string;
+    requests: number;
+    hits: number;
+    cachedTokens: number;
+    totalTokens: number;
+    missingFieldRequests: number;
+}
+export declare function emptyStats(day: string): ModelCacheStats;
+export declare function accumulate(stats: ModelCacheStats, usage: CacheUsage): ModelCacheStats;
+/** Línea del footer: `DS cache 42/57·1.20M/1.85M 64.9%`. */
+export declare function formatStats(label: string, stats: ModelCacheStats): string;
+/** Persistencia con escritura debounced; el disco nunca bloquea una petición. */
+export declare class CacheStatsStore {
+    private path;
+    private data;
+    private timer;
+    constructor(agentDir: string);
+    load(): Promise<void>;
+    record(modelKey: string, day: string, usage: CacheUsage): ModelCacheStats;
+    get(modelKey: string): ModelCacheStats | undefined;
+    all(): Record<string, ModelCacheStats>;
+    reset(modelKey?: string): void;
+    private schedulePersist;
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=stats.d.ts.map

package/dist/core/prompt-cache/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/core/prompt-cache/stats.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,UAAU;IAC1B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,aAAa,EAAE,OAAO,CAAC;CACvB;AAQD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAyDvD;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAEvD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,GAAG,eAAe,CASrF;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,CAMzE;AAOD,iFAAiF;AACjF,qBAAa,eAAe;IAC3B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAA0C;IACtD,OAAO,CAAC,KAAK,CAA8C;gBAE/C,QAAQ,EAAE,MAAM;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,eAAe;IASzE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIlD,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAItC,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAM9B,OAAO,CAAC,eAAe;IAMjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAY5B"}

package/dist/core/prompt-cache/stats.js

@@ -0,0 +1,158 @@
+/**
+ * Lectura y persistencia de estadísticas de caché.
+ *
+ * Sin medición, todo lo demás es fe. Cada familia de proveedor reporta el uso de
+ * caché con nombres distintos, y algunos proxies los omiten — en cuyo caso hay
+ * que decirlo en vez de mostrar un 0% que parece un problema de caché cuando en
+ * realidad es un problema de telemetría.
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+const ZERO = { cacheRead: 0, cacheWrite: 0, totalInput: 0, missingFields: true };
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+/**
+ * Normaliza el usage de cualquier familia de proveedor.
+ *
+ * Los nombres NO son intercambiables:
+ * - DeepSeek: `prompt_cache_hit_tokens` + `prompt_cache_miss_tokens` suman el total.
+ * - OpenAI: `prompt_tokens_details.cached_tokens` es un SUBCONJUNTO de `prompt_tokens`.
+ * - Anthropic: `input_tokens` EXCLUYE lo cacheado, así que hay que sumarlo.
+ * - Gemini: `cachedContentTokenCount` sobre `promptTokenCount`.
+ */
+export function readCacheUsage(raw) {
+    if (!raw || typeof raw !== "object")
+        return { ...ZERO };
+    const u = raw;
+    // DeepSeek
+    if ("prompt_cache_hit_tokens" in u || "prompt_cache_miss_tokens" in u) {
+        const hit = num(u.prompt_cache_hit_tokens);
+        const miss = num(u.prompt_cache_miss_tokens);
+        return { cacheRead: hit, cacheWrite: 0, totalInput: hit + miss || num(u.prompt_tokens), missingFields: false };
+    }
+    // Anthropic: input_tokens NO incluye lo cacheado.
+    if ("cache_read_input_tokens" in u || "cache_creation_input_tokens" in u) {
+        const read = num(u.cache_read_input_tokens);
+        const write = num(u.cache_creation_input_tokens);
+        return {
+            cacheRead: read,
+            cacheWrite: write,
+            totalInput: num(u.input_tokens) + read + write,
+            missingFields: false,
+        };
+    }
+    // OpenAI: cached_tokens es subconjunto de prompt_tokens.
+    const details = (u.prompt_tokens_details ?? u.input_tokens_details);
+    if (details && typeof details === "object" && "cached_tokens" in details) {
+        const read = num(details.cached_tokens);
+        return {
+            cacheRead: read,
+            cacheWrite: num(u.cache_write_tokens),
+            totalInput: num(u.prompt_tokens) || num(u.input_tokens) || read,
+            missingFields: false,
+        };
+    }
+    // Gemini
+    const meta = u.usageMetadata;
+    if (meta && typeof meta === "object" && "cachedContentTokenCount" in meta) {
+        const read = num(meta.cachedContentTokenCount);
+        return { cacheRead: read, cacheWrite: 0, totalInput: num(meta.promptTokenCount) || read, missingFields: false };
+    }
+    // Forma ya normalizada por el SDK.
+    if ("cacheRead" in u || "input" in u) {
+        const read = num(u.cacheRead);
+        const write = num(u.cacheWrite);
+        return {
+            cacheRead: read,
+            cacheWrite: write,
+            // Suelo: el total nunca puede ser menor que lo cacheado, o saldrían
+            // ratios por encima del 100% cuando un proxy omite el total.
+            totalInput: Math.max(num(u.input), read + write),
+            missingFields: !("cacheRead" in u),
+        };
+    }
+    return { ...ZERO };
+}
+export function emptyStats(day) {
+    return { day, requests: 0, hits: 0, cachedTokens: 0, totalTokens: 0, missingFieldRequests: 0 };
+}
+export function accumulate(stats, usage) {
+    return {
+        ...stats,
+        requests: stats.requests + 1,
+        hits: stats.hits + (usage.cacheRead > 0 ? 1 : 0),
+        cachedTokens: stats.cachedTokens + usage.cacheRead,
+        totalTokens: stats.totalTokens + usage.totalInput,
+        missingFieldRequests: stats.missingFieldRequests + (usage.missingFields ? 1 : 0),
+    };
+}
+/** Línea del footer: `DS cache 42/57·1.20M/1.85M 64.9%`. */
+export function formatStats(label, stats) {
+    if (stats.requests === 0)
+        return "";
+    const pct = stats.totalTokens > 0 ? ((stats.cachedTokens / stats.totalTokens) * 100).toFixed(1) : "0.0";
+    const m = (n) => `${(n / 1_000_000).toFixed(2)}M`;
+    const warn = stats.missingFieldRequests > 0 ? " ⚠️ sin datos de caché" : "";
+    return `${label} ${stats.hits}/${stats.requests}·${m(stats.cachedTokens)}/${m(stats.totalTokens)} ${pct}%${warn}`;
+}
+/** Persistencia con escritura debounced; el disco nunca bloquea una petición. */
+export class CacheStatsStore {
+    path;
+    data = { version: 1, byModel: {} };
+    timer = null;
+    constructor(agentDir) {
+        this.path = join(agentDir, "prompt-cache-stats.json");
+    }
+    async load() {
+        try {
+            const parsed = JSON.parse(await readFile(this.path, "utf-8"));
+            if (parsed.version === 1 && parsed.byModel)
+                this.data = parsed;
+        }
+        catch {
+            // primer arranque / fichero corrupto: se empieza de cero
+        }
+    }
+    record(modelKey, day, usage) {
+        const current = this.data.byModel[modelKey];
+        const base = current && current.day === day ? current : emptyStats(day);
+        const next = accumulate(base, usage);
+        this.data.byModel[modelKey] = next;
+        this.schedulePersist();
+        return next;
+    }
+    get(modelKey) {
+        return this.data.byModel[modelKey];
+    }
+    all() {
+        return { ...this.data.byModel };
+    }
+    reset(modelKey) {
+        if (modelKey)
+            delete this.data.byModel[modelKey];
+        else
+            this.data.byModel = {};
+        this.schedulePersist();
+    }
+    schedulePersist() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = setTimeout(() => void this.flush(), 2000);
+        this.timer.unref?.();
+    }
+    async flush() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        try {
+            await mkdir(dirname(this.path), { recursive: true });
+            await writeFile(this.path, JSON.stringify(this.data), "utf-8");
+        }
+        catch {
+            // las estadísticas nunca deben romper una sesión
+        }
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/core/prompt-cache/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/core/prompt-cache/stats.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAa1C,MAAM,IAAI,GAAe,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;AAE7F,SAAS,GAAG,CAAC,KAAc;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IAC1C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACxD,MAAM,CAAC,GAAG,GAA8B,CAAC;IAEzC,WAAW;IACX,IAAI,yBAAyB,IAAI,CAAC,IAAI,0BAA0B,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;QAC7C,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAChH,CAAC;IAED,kDAAkD;IAClD,IAAI,yBAAyB,IAAI,CAAC,IAAI,6BAA6B,IAAI,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;QACjD,OAAO;YACN,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,IAAI,GAAG,KAAK;YAC9C,aAAa,EAAE,KAAK;SACpB,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,CAAC,oBAAoB,CAAwC,CAAC;IAC3G,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,eAAe,IAAI,OAAO,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACxC,OAAO;YACN,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC;YACrC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,IAAI;YAC/D,aAAa,EAAE,KAAK;SACpB,CAAC;IACH,CAAC;IAED,SAAS;IACT,MAAM,IAAI,GAAG,CAAC,CAAC,aAAoD,CAAC;IACpE,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,yBAAyB,IAAI,IAAI,EAAE,CAAC;QAC3E,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC/C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IACjH,CAAC;IAED,mCAAmC;IACnC,IAAI,WAAW,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAChC,OAAO;YACN,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,KAAK;YACjB,oEAAoE;YACpE,6DAA6D;YAC7D,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;YAChD,aAAa,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;SAClC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;AACpB,CAAC;AAWD,MAAM,UAAU,UAAU,CAAC,GAAW;IACrC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAsB,EAAE,KAAiB;IACnE,OAAO;QACN,GAAG,KAAK;QACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,CAAC;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,YAAY,EAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,SAAS;QAClD,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU;QACjD,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAChF,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,KAAsB;IAChE,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACxG,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,oBAAoB,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;AACnH,CAAC;AAOD,iFAAiF;AACjF,MAAM,OAAO,eAAe;IACnB,IAAI,CAAS;IACb,IAAI,GAAc,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9C,KAAK,GAAyC,IAAI,CAAC;IAE3D,YAAY,QAAgB;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,IAAI;QACT,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAc,CAAC;YAC3E,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO;gBAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACR,yDAAyD;QAC1D,CAAC;IACF,CAAC;IAED,MAAM,CAAC,QAAgB,EAAE,GAAW,EAAE,KAAiB;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QACnC,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,GAAG,CAAC,QAAgB;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,GAAG;QACF,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,QAAiB;QACtB,IAAI,QAAQ;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;;YAC5C,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IAEO,eAAe;QACtB,IAAI,IAAI,CAAC,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,KAA2C,CAAC,KAAK,EAAE,EAAE,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,KAAK;QACV,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,IAAI,CAAC;YACJ,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACR,iDAAiD;QAClD,CAAC;IACF,CAAC;CACD"}