@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/agents/loader.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Subagentes definidos por el usuario en Markdown.
+ *
+ * `~/.ada/agents/<nombre>.md` (usuario) y `<proyecto>/.ada/agents/<nombre>.md`
+ * (proyecto). El frontmatter configura el subagente y el cuerpo es su prompt.
+ *
+ * Dos cosas que este cargador hace y el contrato que copiamos no:
+ *
+ * 1. **Los booleanos se validan de verdad.** `readOnly` y `web` deciden si un
+ *    agente puede escribir ficheros o sacar por la red lo que ha leído. Un
+ *    `readOnly: "no"` que YAML entrega como cadena es truthy, y aceptarlo sin
+ *    mirar convertiría una errata en un permiso. Se rechaza el fichero entero y
+ *    se dice cuál es.
+ *
+ * 2. **Los de proyecto exigen confianza.** Un `.ada/agents/*.md` viene del
+ *    repositorio, igual que una extensión: abrir un repo ajeno no puede
+ *    definir un agente con `web: true` que lea el código y lo mande fuera.
+ */
+import type { TSchema } from "typebox";
+export interface AgenteDefinido {
+    nombre: string;
+    descripcion?: string;
+    /** El cuerpo del Markdown: el prompt de sistema del subagente. */
+    instrucciones: string;
+    model?: string;
+    tier?: string;
+    readOnly?: boolean;
+    web?: boolean;
+    isolation?: "none" | "worktree";
+    timeoutMs?: number;
+    /**
+     * Esquema de salida (JSON Schema) declarado en `outputSchema:` del
+     * frontmatter. El host lo usa para validar la salida del subagente y
+     * reintentar con el error concreto si no valida — ver contrato/validador.ts.
+     */
+    esquemaSalida?: TSchema;
+    alcance: "usuario" | "proyecto";
+    ruta: string;
+}
+export interface ProblemaAgente {
+    ruta: string;
+    motivo: string;
+}
+/** Analiza un fichero de agente. Lanza con un motivo legible si no vale. */
+export declare function analizarAgente(contenido: string, ruta: string, alcance: "usuario" | "proyecto"): AgenteDefinido;
+export interface OpcionesCarga {
+    agentDir: string;
+    cwd: string;
+    /** Los de proyecto solo cargan si el proyecto es de confianza. Ver cabecera. */
+    proyectoDeConfianza: boolean;
+    configDirName: string;
+}
+export interface CargaAgentes {
+    agentes: AgenteDefinido[];
+    problemas: ProblemaAgente[];
+    /** Cuántos de proyecto se ignoraron por falta de confianza. */
+    bloqueadosSinConfianza: number;
+}
+/**
+ * Carga los agentes de usuario y, si el proyecto es de confianza, los suyos.
+ *
+ * Los de proyecto pisan a los de usuario con el mismo nombre: quien abre un
+ * repositorio y decide confiar en él está pidiendo su configuración.
+ */
+export declare function cargarAgentes(opciones: OpcionesCarga): CargaAgentes;
+/** Traduce un agente definido a las opciones que entiende el runtime. */
+export declare function aOpcionesDeAgente(agente: AgenteDefinido): {
+    instructions: string;
+    model?: string;
+    tier?: string;
+    readOnly?: boolean;
+    web?: boolean;
+    isolation?: "none" | "worktree";
+    timeoutMs?: number;
+    schema?: TSchema;
+};
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/agents/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/agents/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIvC,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,SAAS,GAAG,UAAU,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAiBD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,cAAc,CA2D/G;AA6BD,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,+DAA+D;IAC/D,sBAAsB,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAmBnE;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB,CAWA"}

package/dist/core/agents/loader.js

@@ -0,0 +1,154 @@
+/**
+ * Subagentes definidos por el usuario en Markdown.
+ *
+ * `~/.ada/agents/<nombre>.md` (usuario) y `<proyecto>/.ada/agents/<nombre>.md`
+ * (proyecto). El frontmatter configura el subagente y el cuerpo es su prompt.
+ *
+ * Dos cosas que este cargador hace y el contrato que copiamos no:
+ *
+ * 1. **Los booleanos se validan de verdad.** `readOnly` y `web` deciden si un
+ *    agente puede escribir ficheros o sacar por la red lo que ha leído. Un
+ *    `readOnly: "no"` que YAML entrega como cadena es truthy, y aceptarlo sin
+ *    mirar convertiría una errata en un permiso. Se rechaza el fichero entero y
+ *    se dice cuál es.
+ *
+ * 2. **Los de proyecto exigen confianza.** Un `.ada/agents/*.md` viene del
+ *    repositorio, igual que una extensión: abrir un repo ajeno no puede
+ *    definir un agente con `web: true` que lea el código y lo mande fuera.
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { parseFrontmatter } from "../../utils/frontmatter.js";
+import { esEsquemaValido } from "../workflows/contrato/esquema.js";
+const TIERS = new Set(["small", "medium", "big"]);
+/**
+ * Booleano estricto.
+ *
+ * Devuelve `undefined` si el campo no está, y lanza si está y no es un booleano
+ * de verdad. Ver el punto 1 de la cabecera: aquí un "casi booleano" es un
+ * permiso mal concedido.
+ */
+function booleanoEstricto(valor, campo) {
+    if (valor === undefined || valor === null)
+        return undefined;
+    if (typeof valor === "boolean")
+        return valor;
+    throw new Error(`'${campo}' tiene que ser true o false, no ${JSON.stringify(valor)}`);
+}
+/** Analiza un fichero de agente. Lanza con un motivo legible si no vale. */
+export function analizarAgente(contenido, ruta, alcance) {
+    const { frontmatter, body } = parseFrontmatter(contenido);
+    const nombreDeclarado = typeof frontmatter.name === "string" ? frontmatter.name.trim() : "";
+    // El nombre del fichero manda si no se declara: es lo que el usuario escribe.
+    const nombre = nombreDeclarado || basename(ruta).replace(/\.md$/i, "");
+    if (!/^[a-z0-9][a-z0-9_-]*$/i.test(nombre)) {
+        throw new Error(`nombre inválido: '${nombre}' (solo letras, números, guion y guion bajo)`);
+    }
+    if (!body.trim()) {
+        throw new Error("el cuerpo está vacío: un agente sin instrucciones no hace nada");
+    }
+    const tier = typeof frontmatter.tier === "string" ? frontmatter.tier : undefined;
+    if (tier && !TIERS.has(tier)) {
+        throw new Error(`tier desconocido: '${tier}' (small, medium o big)`);
+    }
+    const isolation = typeof frontmatter.isolation === "string" ? frontmatter.isolation : undefined;
+    if (isolation && isolation !== "none" && isolation !== "worktree") {
+        throw new Error(`isolation desconocido: '${isolation}' (none o worktree)`);
+    }
+    const timeoutMs = frontmatter.timeoutMs;
+    if (timeoutMs !== undefined && (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs <= 0)) {
+        throw new Error(`timeoutMs tiene que ser un número de milisegundos positivo`);
+    }
+    const model = typeof frontmatter.model === "string" ? frontmatter.model.trim() : undefined;
+    if (model === "") {
+        throw new Error("model está vacío: quítalo o pon 'proveedor/modelo'");
+    }
+    // outputSchema declara el CONTRATO de salida: el host lo valida y reintenta
+    // con el error concreto si no cumple (contrato/validador.ts). Un esquema
+    // presente pero sin pinta de JSON Schema (`{}`, una lista, un string...) se
+    // rechaza aquí — aceptarlo callado dejaría "validar" cualquier cosa.
+    let esquemaSalida;
+    if (frontmatter.outputSchema !== undefined) {
+        if (!esEsquemaValido(frontmatter.outputSchema)) {
+            throw new Error("outputSchema no parece un JSON Schema válido (falta type/properties/anyOf/enum/...)");
+        }
+        esquemaSalida = frontmatter.outputSchema;
+    }
+    return {
+        nombre,
+        descripcion: typeof frontmatter.description === "string" ? frontmatter.description : undefined,
+        instrucciones: body.trim(),
+        model,
+        tier,
+        readOnly: booleanoEstricto(frontmatter.readOnly, "readOnly"),
+        web: booleanoEstricto(frontmatter.web, "web"),
+        isolation: isolation,
+        timeoutMs: timeoutMs,
+        esquemaSalida,
+        alcance,
+        ruta,
+    };
+}
+function leerDirectorio(dir, alcance, agentes, problemas) {
+    if (!existsSync(dir))
+        return;
+    let ficheros;
+    try {
+        ficheros = readdirSync(dir).filter((f) => f.toLowerCase().endsWith(".md"));
+    }
+    catch (error) {
+        problemas.push({ ruta: dir, motivo: error instanceof Error ? error.message : String(error) });
+        return;
+    }
+    for (const fichero of ficheros.sort()) {
+        const ruta = join(dir, fichero);
+        try {
+            const agente = analizarAgente(readFileSync(ruta, "utf8"), ruta, alcance);
+            agentes.set(agente.nombre, agente);
+        }
+        catch (error) {
+            // Un fichero roto no puede impedir que carguen los demás, pero SÍ se
+            // cuenta: un agente que desaparece en silencio es peor que un error.
+            problemas.push({ ruta, motivo: error instanceof Error ? error.message : String(error) });
+        }
+    }
+}
+/**
+ * Carga los agentes de usuario y, si el proyecto es de confianza, los suyos.
+ *
+ * Los de proyecto pisan a los de usuario con el mismo nombre: quien abre un
+ * repositorio y decide confiar en él está pidiendo su configuración.
+ */
+export function cargarAgentes(opciones) {
+    const agentes = new Map();
+    const problemas = [];
+    leerDirectorio(join(opciones.agentDir, "agents"), "usuario", agentes, problemas);
+    const dirProyecto = join(opciones.cwd, opciones.configDirName, "agents");
+    let bloqueadosSinConfianza = 0;
+    if (opciones.proyectoDeConfianza) {
+        leerDirectorio(dirProyecto, "proyecto", agentes, problemas);
+    }
+    else if (existsSync(dirProyecto)) {
+        try {
+            bloqueadosSinConfianza = readdirSync(dirProyecto).filter((f) => f.toLowerCase().endsWith(".md")).length;
+        }
+        catch {
+            bloqueadosSinConfianza = 0;
+        }
+    }
+    return { agentes: [...agentes.values()], problemas, bloqueadosSinConfianza };
+}
+/** Traduce un agente definido a las opciones que entiende el runtime. */
+export function aOpcionesDeAgente(agente) {
+    return {
+        instructions: agente.instrucciones,
+        model: agente.model,
+        tier: agente.tier,
+        readOnly: agente.readOnly,
+        web: agente.web,
+        isolation: agente.isolation,
+        timeoutMs: agente.timeoutMs,
+        schema: agente.esquemaSalida,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/agents/loader.js.map

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

package/dist/core/appendonly/append-only-context.d.ts

@@ -0,0 +1,118 @@
+/**
+ * AppendOnlyContextManager — AG2 (Fase 1).
+ *
+ * Referencia omp: agent append-only-context.ts:45 (append-only context AUTO
+ * para deepseek/runtimes locales) y session/session-maintenance.ts (el prefijo
+ * estable se protege vía cachePrefixLen — nunca se reescribe dentro de él).
+ *
+ * Problema: cada byte distinto en la posición N invalida el prompt-cache de
+ * todo lo que va detrás (~40k tokens de re-prefill por turno reescrito).
+ *
+ * Contrato:
+ * - El historial SOLO crece por append; los turnos ya enviados son inmutables
+ *   (clonados y congelados en profundidad al entrar; cualquier intento de
+ *   mutación lanza TypeError en modo estricto).
+ * - prefijoEstable() congela (lazy, primera llamada) un hash sha256 del
+ *   prefijo; los appends posteriores NO lo cambian. Solo compactar() lo
+ *   invalida para recalcularlo incluyendo el resumen.
+ * - compactar(resumen) AÑADE una entrada resumen al final y marca un puntero;
+ *   nunca borra ni reescribe: el prefijo ya cacheado permanece byte a byte.
+ * - reconstruirDesde(journal) rehidrata el manager desde el JournalTree que
+ *   produce serializarAJournal() (reutiliza src/core/sesion/journal-tree.ts),
+ *   verificando los hashes almacenados.
+ *
+ * Wiring sin hunks upstream (integración por extensión):
+ * - banco/pruning (PruningGuard): consumir `prefijoEstable().hasta` como
+ *   longitud de prefijo protegido (cachePrefixLen) — el prune solo poda en el
+ *   sufijo `contextoActivo()`.
+ * - compactacion/ (prune/shake/handoff): operar únicamente sobre el sufijo
+ *   `contextoActivo()`; handoff persiste con `serializarAJournal()` y la sesión
+ *   nueva rehidrata con `reconstruirDesde()` — cero reescrituras de turnos.
+ */
+import type { Mensaje } from "../compactacion/tipos.ts";
+import { JournalTree } from "../sesion/journal-tree.ts";
+/** Tipo de entrada del contexto: turno real o resumen de compactación. */
+export type TipoEntrada = "mensaje" | "resumen";
+/** Entrada inmutable del historial de contexto. */
+export interface EntradaContexto {
+    id: string;
+    tipo: TipoEntrada;
+    mensaje: Mensaje;
+    /** sha256 hex del contenido canónico {id, mensaje}. */
+    hash: string;
+    /** Solo resumen: índice de la primera entrada viva tras esta compactación. */
+    puntero?: number;
+}
+/** Prefijo estable congelado: cubre las entradas [0, hasta). */
+export interface PrefijoEstable {
+    /** sha256 hex sobre la concatenación de hashes de entrada del prefijo. */
+    hash: string;
+    /** Número de entradas que cubre el prefijo. */
+    hasta: number;
+}
+export interface AppendOnlyOptions {
+    /** Prefijo para ids generados. Por defecto "ctx-". */
+    idPrefix?: string;
+}
+export declare class AppendOnlyContextManager {
+    #private;
+    constructor(options?: AppendOnlyOptions);
+    /** Número total de entradas (incluye resúmenes). */
+    get size(): number;
+    /**
+     * Índice de la primera entrada viva tras la última compactación,
+     * o null si nunca se ha compactado.
+     */
+    get punteroCompactacion(): number | null;
+    /**
+     * Añade un turno al final del historial. El mensaje se clona y congela en
+     * profundidad: ni el llamador ni nadie puede mutar un turno ya enviado.
+     */
+    append(mensaje: Mensaje): EntradaContexto;
+    /**
+     * Vista de solo lectura del historial completo (incluye resúmenes).
+     * Los elementos están congelados en profundidad: mutarlos lanza TypeError.
+     */
+    mensajes(): readonly Mensaje[];
+    /**
+     * Prefijo estable: hash congelado en la primera llamada; los appends
+     * siguientes NO lo alteran. Solo compactar() lo invalida (recalcula
+     * incluyendo el resumen, que pasa a formar parte del prefijo enviado).
+     */
+    prefijoEstable(): PrefijoEstable;
+    /**
+     * Compactación append-only: añade una entrada resumen al FINAL y marca el
+     * puntero de compactación en `hasta` (por defecto, todas las entradas
+     * actuales). No elimina ni reescribe nada: el prefijo ya cacheado queda
+     * byte a byte. Invalida el prefijo congelado para que la siguiente llamada
+     * a prefijoEstable() lo recalcule incluyendo el resumen.
+     *
+     * Devuelve la entrada resumen creada.
+     */
+    compactar(resumen: string, hasta?: number): EntradaContexto;
+    /**
+     * Contexto activo: lo que un runtime debería enviar al modelo — el último
+     * resumen (si lo hay) más las entradas vivas desde el puntero de
+     * compactación. Las entradas anteriores siguen en el historial (nunca se
+     * borran) pero su contenido está plegado en el resumen.
+     */
+    contextoActivo(): Mensaje[];
+    /**
+     * Verifica la integridad de todas las entradas recalculando hashes.
+     * Lanza ante corrupción (mutación externa, reconstrucción dañada).
+     */
+    verificar(): void;
+    /**
+     * Serializa el historial a un JournalTree (src/core/sesion/journal-tree.ts):
+     * una entrada por elemento, encadenadas parentId, type="contexto",
+     * data=EntradaContexto completa (con hash y puntero para rehidratación).
+     */
+    serializarAJournal(): JournalTree;
+    /**
+     * Rehidrata el manager desde un JournalTree producido por
+     * serializarAJournal(): recorre el camino raíz→leaf, restaura las entradas
+     * en orden y verifica sus hashes. Sustituye el estado actual.
+     */
+    reconstruirDesde(journal: JournalTree): this;
+}
+//# sourceMappingURL=append-only-context.d.ts.map

package/dist/core/appendonly/append-only-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-only-context.d.ts","sourceRoot":"","sources":["../../../src/core/appendonly/append-only-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhD,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC9B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IACjC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AA6BD,qBAAa,wBAAwB;;gBAQxB,OAAO,CAAC,EAAE,iBAAiB;IAIvC,oDAAoD;IACpD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,IAAI,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEvC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe;IAmBzC;;;OAGG;IACH,QAAQ,IAAI,SAAS,OAAO,EAAE;IAI9B;;;;OAIG;IACH,cAAc,IAAI,cAAc;IAWhC;;;;;;;;OAQG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe;IAwB3D;;;;;OAKG;IACH,cAAc,IAAI,OAAO,EAAE;IAc3B;;;OAGG;IACH,SAAS,IAAI,IAAI;IAwBjB;;;;OAIG;IACH,kBAAkB,IAAI,WAAW;IAejC;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CA8B5C"}

package/dist/core/appendonly/append-only-context.js

@@ -0,0 +1,256 @@
+/**
+ * AppendOnlyContextManager — AG2 (Fase 1).
+ *
+ * Referencia omp: agent append-only-context.ts:45 (append-only context AUTO
+ * para deepseek/runtimes locales) y session/session-maintenance.ts (el prefijo
+ * estable se protege vía cachePrefixLen — nunca se reescribe dentro de él).
+ *
+ * Problema: cada byte distinto en la posición N invalida el prompt-cache de
+ * todo lo que va detrás (~40k tokens de re-prefill por turno reescrito).
+ *
+ * Contrato:
+ * - El historial SOLO crece por append; los turnos ya enviados son inmutables
+ *   (clonados y congelados en profundidad al entrar; cualquier intento de
+ *   mutación lanza TypeError en modo estricto).
+ * - prefijoEstable() congela (lazy, primera llamada) un hash sha256 del
+ *   prefijo; los appends posteriores NO lo cambian. Solo compactar() lo
+ *   invalida para recalcularlo incluyendo el resumen.
+ * - compactar(resumen) AÑADE una entrada resumen al final y marca un puntero;
+ *   nunca borra ni reescribe: el prefijo ya cacheado permanece byte a byte.
+ * - reconstruirDesde(journal) rehidrata el manager desde el JournalTree que
+ *   produce serializarAJournal() (reutiliza src/core/sesion/journal-tree.ts),
+ *   verificando los hashes almacenados.
+ *
+ * Wiring sin hunks upstream (integración por extensión):
+ * - banco/pruning (PruningGuard): consumir `prefijoEstable().hasta` como
+ *   longitud de prefijo protegido (cachePrefixLen) — el prune solo poda en el
+ *   sufijo `contextoActivo()`.
+ * - compactacion/ (prune/shake/handoff): operar únicamente sobre el sufijo
+ *   `contextoActivo()`; handoff persiste con `serializarAJournal()` y la sesión
+ *   nueva rehidrata con `reconstruirDesde()` — cero reescrituras de turnos.
+ */
+import { createHash } from "node:crypto";
+import { JournalTree } from "../sesion/journal-tree.js";
+function sha256Hex(s) {
+    return createHash("sha256").update(s, "utf8").digest("hex");
+}
+function hashEntrada(id, mensaje) {
+    return sha256Hex(JSON.stringify({ id, mensaje }));
+}
+/** Congela en profundidad (in situ) valores anidados. */
+function deepFreeze(value) {
+    if (value !== null && typeof value === "object") {
+        for (const key of Object.keys(value)) {
+            deepFreeze(value[key]);
+        }
+        Object.freeze(value);
+    }
+    return value;
+}
+let contadorGlobal = 0;
+function generarId(prefix) {
+    contadorGlobal += 1;
+    const rand = sha256Hex(`${contadorGlobal}:${process.hrtime.bigint()}`).slice(0, 8);
+    return `${prefix}${contadorGlobal}-${rand}`;
+}
+export class AppendOnlyContextManager {
+    #idPrefix;
+    #entradas = [];
+    #prefijoCongelado = null;
+    /** Índice (en #entradas) de la primera entrada viva tras la última compactación. */
+    #punteroCompactacion = null;
+    #ultimoResumenId = null;
+    constructor(options) {
+        this.#idPrefix = options?.idPrefix ?? "ctx-";
+    }
+    /** Número total de entradas (incluye resúmenes). */
+    get size() {
+        return this.#entradas.length;
+    }
+    /**
+     * Índice de la primera entrada viva tras la última compactación,
+     * o null si nunca se ha compactado.
+     */
+    get punteroCompactacion() {
+        return this.#punteroCompactacion;
+    }
+    /**
+     * Añade un turno al final del historial. El mensaje se clona y congela en
+     * profundidad: ni el llamador ni nadie puede mutar un turno ya enviado.
+     */
+    append(mensaje) {
+        if (mensaje === null || typeof mensaje !== "object") {
+            throw new Error("append: mensaje debe ser un objeto");
+        }
+        if (!("role" in mensaje) || !("content" in mensaje)) {
+            throw new Error("append: mensaje requiere role y content");
+        }
+        const clon = deepFreeze(structuredClone(mensaje));
+        const entrada = {
+            id: generarId(this.#idPrefix),
+            tipo: "mensaje",
+            mensaje: clon,
+            hash: "",
+        };
+        entrada.hash = hashEntrada(entrada.id, entrada.mensaje);
+        this.#entradas.push(Object.freeze(entrada));
+        return entrada;
+    }
+    /**
+     * Vista de solo lectura del historial completo (incluye resúmenes).
+     * Los elementos están congelados en profundidad: mutarlos lanza TypeError.
+     */
+    mensajes() {
+        return Object.freeze(this.#entradas.map((e) => e.mensaje));
+    }
+    /**
+     * Prefijo estable: hash congelado en la primera llamada; los appends
+     * siguientes NO lo alteran. Solo compactar() lo invalida (recalcula
+     * incluyendo el resumen, que pasa a formar parte del prefijo enviado).
+     */
+    prefijoEstable() {
+        if (this.#prefijoCongelado === null) {
+            const hashes = this.#entradas.map((e) => e.hash).join("\n");
+            this.#prefijoCongelado = {
+                hash: sha256Hex(hashes),
+                hasta: this.#entradas.length,
+            };
+        }
+        return this.#prefijoCongelado;
+    }
+    /**
+     * Compactación append-only: añade una entrada resumen al FINAL y marca el
+     * puntero de compactación en `hasta` (por defecto, todas las entradas
+     * actuales). No elimina ni reescribe nada: el prefijo ya cacheado queda
+     * byte a byte. Invalida el prefijo congelado para que la siguiente llamada
+     * a prefijoEstable() lo recalcule incluyendo el resumen.
+     *
+     * Devuelve la entrada resumen creada.
+     */
+    compactar(resumen, hasta) {
+        if (typeof resumen !== "string" || resumen.trim() === "") {
+            throw new Error("compactar: resumen requerido");
+        }
+        const limite = hasta ?? this.#entradas.length;
+        if (!Number.isInteger(limite) || limite < 0 || limite > this.#entradas.length) {
+            throw new Error(`compactar: hasta=${limite} fuera de rango (0..${this.#entradas.length})`);
+        }
+        const mensajeResumen = { role: "user", content: resumen };
+        const entrada = {
+            id: generarId(this.#idPrefix),
+            tipo: "resumen",
+            mensaje: deepFreeze(mensajeResumen),
+            hash: "",
+            puntero: limite,
+        };
+        entrada.hash = hashEntrada(entrada.id, entrada.mensaje);
+        this.#entradas.push(Object.freeze(entrada));
+        this.#punteroCompactacion = limite;
+        this.#ultimoResumenId = entrada.id;
+        this.#prefijoCongelado = null;
+        return entrada;
+    }
+    /**
+     * Contexto activo: lo que un runtime debería enviar al modelo — el último
+     * resumen (si lo hay) más las entradas vivas desde el puntero de
+     * compactación. Las entradas anteriores siguen en el historial (nunca se
+     * borran) pero su contenido está plegado en el resumen.
+     */
+    contextoActivo() {
+        const activo = [];
+        let desde = 0;
+        if (this.#ultimoResumenId !== null && this.#punteroCompactacion !== null) {
+            const resumen = this.#entradas.find((e) => e.id === this.#ultimoResumenId);
+            if (resumen)
+                activo.push(resumen.mensaje);
+            desde = this.#punteroCompactacion;
+        }
+        for (const e of this.#entradas.slice(desde)) {
+            if (e.tipo === "mensaje")
+                activo.push(e.mensaje);
+        }
+        return activo;
+    }
+    /**
+     * Verifica la integridad de todas las entradas recalculando hashes.
+     * Lanza ante corrupción (mutación externa, reconstrucción dañada).
+     */
+    verificar() {
+        for (let i = 0; i < this.#entradas.length; i += 1) {
+            const e = this.#entradas[i];
+            if (e.hash !== hashEntrada(e.id, e.mensaje)) {
+                throw new Error(`verificar: entrada ${i} (${e.id}) corrupta — hash no coincide`);
+            }
+        }
+        if (this.#prefijoCongelado !== null) {
+            const { hash, hasta } = this.#prefijoCongelado;
+            if (hasta > this.#entradas.length) {
+                throw new Error(`verificar: prefijo congelado cubre ${hasta} entradas pero hay ${this.#entradas.length}`);
+            }
+            const recalculado = sha256Hex(this.#entradas
+                .slice(0, hasta)
+                .map((e) => e.hash)
+                .join("\n"));
+            if (recalculado !== hash) {
+                throw new Error("verificar: prefijo congelado no coincide con las entradas");
+            }
+        }
+    }
+    /**
+     * Serializa el historial a un JournalTree (src/core/sesion/journal-tree.ts):
+     * una entrada por elemento, encadenadas parentId, type="contexto",
+     * data=EntradaContexto completa (con hash y puntero para rehidratación).
+     */
+    serializarAJournal() {
+        const tree = new JournalTree();
+        let parent = null;
+        for (const e of this.#entradas) {
+            tree.append({
+                id: e.id,
+                parentId: parent,
+                type: "contexto",
+                data: e.tipo === "resumen" ? { ...e, puntero: e.puntero ?? this.#punteroCompactacion } : e,
+            });
+            parent = e.id;
+        }
+        return tree;
+    }
+    /**
+     * Rehidrata el manager desde un JournalTree producido por
+     * serializarAJournal(): recorre el camino raíz→leaf, restaura las entradas
+     * en orden y verifica sus hashes. Sustituye el estado actual.
+     */
+    reconstruirDesde(journal) {
+        const camino = journal.breadcrumb(journal.leafId ?? undefined);
+        const entradas = [];
+        let ultimoResumenId = null;
+        let puntero = null;
+        for (const id of camino) {
+            const je = journal.get(id);
+            if (!je || je.type !== "contexto")
+                continue;
+            const data = je.data;
+            if (!data || typeof data !== "object" || !data.id || !data.mensaje || !data.hash) {
+                throw new Error(`reconstruirDesde: entrada ${id} sin forma de EntradaContexto`);
+            }
+            if (data.id !== id)
+                throw new Error(`reconstruirDesde: id divergente (${id} vs ${data.id})`);
+            if (hashEntrada(data.id, data.mensaje) !== data.hash) {
+                throw new Error(`reconstruirDesde: entrada ${id} corrupta — hash no coincide`);
+            }
+            entradas.push(Object.freeze(deepFreeze(data)));
+            if (data.tipo === "resumen") {
+                ultimoResumenId = data.id;
+                puntero = typeof data.puntero === "number" ? data.puntero : entradas.length - 1;
+            }
+        }
+        this.#entradas = entradas;
+        this.#ultimoResumenId = ultimoResumenId;
+        this.#punteroCompactacion = puntero;
+        // El historial reconstruido ya fue enviado: congelar el prefijo completo.
+        this.#prefijoCongelado = null;
+        this.prefijoEstable();
+        return this;
+    }
+}
+//# sourceMappingURL=append-only-context.js.map

package/dist/core/appendonly/append-only-context.js.map

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