@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/audit/registro-sesion.js

@@ -0,0 +1,202 @@
+/**
+ * Todo lo que Ada añade alrededor de una llamada a herramienta, en una pieza.
+ *
+ * Reúne tres cosas que empezaron sueltas dentro de `agent-session.ts` —el libro
+ * de sesión, la política de aprobación y el observador de ediciones— porque las
+ * tres cuelgan de los mismos dos ganchos y comparten el ciclo de vida de la
+ * llamada.
+ *
+ * El motivo de agruparlas no es estético. `agent-session.ts` es de upstream y
+ * cada región nuestra que vive ahí es un hunk que se reaplica en cada
+ * sincronización y se rompe cuando upstream refactoriza. Tres campos y un
+ * método sueltos partían el hunk de declaraciones en dos y se pasaban del
+ * presupuesto; un campo y dos llamadas, no. La regla está escrita en
+ * `core/ada.ts`: si vas a tocar `agent-session.ts`, mira antes si lo tuyo cabe
+ * en un módulo propio.
+ */
+import { decidir, leerDenegadas } from "../aprobacion/politica.js";
+import { ObservadorDeEdiciones } from "../edicion/observador.js";
+import { publicarLibroDeSesion } from "../extensiones/vigilancia.js";
+import { nivelDesdeConfig } from "../hooks/session-hooks.js";
+import { LibroDeSesion } from "./libro.js";
+export class RegistroDeSesion {
+    agentDir;
+    sesionId;
+    observador;
+    /** Decisión de cada llamada, de `beforeToolCall` a `afterToolCall`. */
+    decisiones = new Map();
+    /**
+     * Llamadas que el modelo ANUNCIÓ y de las que el libro aún no sabe nada.
+     *
+     * Existe porque había un hueco medido: `validateToolArguments` corre ANTES
+     * que `beforeToolCall`, así que una llamada rechazada por sus argumentos
+     * —el error más común de los modelos pequeños— no llegaba a ninguno de
+     * nuestros dos enganches y desaparecía del libro. Ocurrió de verdad en una
+     * comparación contra un modelo gratuito: el transcript tenía dos `edit` y el
+     * libro solo una. Un registro que se vende como «qué hizo el agente» no puede
+     * callarse lo que el agente intentó hacer.
+     */
+    anunciadas = new Map();
+    _libro;
+    // Los tres primeros son funciones y no valores: este objeto se construye en
+    // un inicializador de campo de `AgentSession`, que corre ANTES del cuerpo
+    // del constructor. `this.sessionId` es un getter sobre estado que todavía
+    // no existe ahí, y leerlo en ese momento reventaba la sesión entera —76
+    // ficheros de prueba en rojo— sin que los tipos dijeran nada.
+    //
+    // `completar` es opcional: sin modelo (sesiones de prueba, subagentes sin
+    // auth) la auto-reparación de ediciones rotas queda "no-aplicable" en vez
+    // de intentarlo con `undefined` y reventar.
+    constructor(agentDir, sesionId, cwd, completar) {
+        this.agentDir = agentDir;
+        this.sesionId = sesionId;
+        this.observador = new ObservadorDeEdiciones(cwd, agentDir, completar);
+        // `pi.exec` de una extensión escribe en el MISMO libro que las llamadas
+        // del agente. Sin esto, la extensión abriría su propio fichero de sesión
+        // y quien auditara el de la conversación no vería nada — que es el mismo
+        // agujero de antes con un rastro más difícil de encontrar.
+        //
+        // Se publica un getter para no forzar la creación del libro aquí: sigue
+        // siendo perezoso, y una sesión que no hace nada no deja directorio.
+        publicarLibroDeSesion(() => this.libro());
+    }
+    /**
+     * El libro, creado en la primera anotación.
+     *
+     * Perezoso a propósito: abrirlo al construir la sesión crearía el directorio
+     * incluso para sesiones que no llegan a hacer nada, y entonces "no hay
+     * registro" y "no hizo nada" dejarían de distinguirse.
+     */
+    libro() {
+        this._libro ??= new LibroDeSesion(this.agentDir(), this.sesionId());
+        return this._libro;
+    }
+    /**
+     * Antes de ejecutar: decide si se permite y guarda la preimagen del fichero.
+     *
+     * Devuelve la decisión. Quien llama corta si es `denegada`; la denegación ya
+     * queda anotada aquí.
+     */
+    async antesDeLlamada(idLlamada, tool, args, config) {
+        const decision = decidir({
+            tool,
+            args,
+            modo: nivelDesdeConfig(config),
+            agentDir: this.agentDir(),
+            denegadas: leerDenegadas(config),
+        });
+        if (decision.veredicto === "denegada") {
+            void this.libro().anotar({
+                tipo: "tool",
+                nombre: tool,
+                ok: false,
+                decision: "denegada",
+                motivo: decision.politica,
+            });
+            // Una llamada bloqueada no llega a `trasLlamada`, así que no se guarda
+            // nada que luego nadie recogería. Y ya está anotada arriba: se saca de
+            // las pendientes para que la reconciliación no la cuente dos veces.
+            this.anunciadas.delete(idLlamada);
+            return decision;
+        }
+        // Tope por si alguna llamada muere antes de consumirse.
+        if (this.decisiones.size > 256)
+            this.decisiones.clear();
+        this.decisiones.set(idLlamada, decision);
+        await this.observador.antesDe(idLlamada, tool, args);
+        return decision;
+    }
+    /**
+     * Después de ejecutar: anota lo ocurrido y devuelve el aviso de edición rota,
+     * o `null` si no hay nada que decir — que es el caso de casi todas.
+     */
+    async trasLlamada(idLlamada, tool, args, huboError) {
+        const aprobacion = this.decisiones.get(idLlamada);
+        this.decisiones.delete(idLlamada);
+        this.anunciadas.delete(idLlamada);
+        const comando = args?.command;
+        void this.libro().anotar(tool === "bash" && typeof comando === "string"
+            ? { tipo: "comando", argv: [comando], codigo: huboError ? 1 : 0, origen: "agente" }
+            : {
+                tipo: "tool",
+                nombre: tool,
+                ok: !huboError,
+                // Qué regla la dejó pasar. Sin esto el libro dice que algo
+                // ocurrió pero no por qué se permitió, que es justo la mitad
+                // que pregunta una auditoría.
+                decision: aprobacion?.veredicto,
+                motivo: aprobacion?.politica,
+            });
+        const aviso = await this.observador.despuesDe(idLlamada, huboError);
+        // El suceso `fichero` del libro: art. 30 RGPD, qué ficheros se trataron.
+        //
+        // El tipo existía en `libro.ts` desde el primer día y NADIE lo anotaba: el
+        // comentario de `agent-session.ts` decía "los hashes de fichero llegan con
+        // el observador de ediciones", en futuro, y nunca llegaron. La auditoría
+        // enterprise lo encontró preguntando lo que pregunta un DPO. Es el defecto
+        // número uno de esta casa: capacidad construida y desenchufada, con el tipo
+        // compilando y las pruebas en verde porque las pruebas anotaban a mano.
+        //
+        // Se toma del observador, que ya leyó las dos versiones, en vez de releer el
+        // fichero aquí. El libro hashea `antes` y `despues` al escribir, así que el
+        // contenido pasa por aquí pero no llega a disco.
+        const cambio = this.observador.ultimoCambio(idLlamada);
+        if (cambio) {
+            void this.libro().anotar({
+                tipo: "fichero",
+                ruta: cambio.ruta,
+                antes: cambio.antes,
+                despues: cambio.despues,
+                tool,
+            });
+        }
+        return aviso;
+    }
+    /**
+     * Una llamada al modelo.
+     *
+     * Se anota por llamada y no por turno porque un turno puede gastar varias, y
+     * "qué modelo se usó y cuánto costó" hay que poder responderlo con ese grano.
+     * Las que fallan también: `motivoParada: "error"` es justo lo que hay que
+     * poder enseñar.
+     */
+    anotarModelo(asistente) {
+        // RECONCILIAR PRIMERO. Para cuando llega este mensaje, las herramientas del
+        // anterior ya se ejecutaron —el bucle las espera—, así que todo lo que siga
+        // pendiente es una llamada que el modelo pidió y que nunca llegó a
+        // ejecutarse: argumentos que no validaron, o una herramienta inexistente.
+        for (const [id, nombre] of this.anunciadas) {
+            void this.libro().anotar({
+                tipo: "tool",
+                nombre,
+                ok: false,
+                decision: "no-ejecutada",
+                // El motivo no se inventa: desde aquí no se ve la causa exacta, y
+                // escribir una supuesta sería peor que nombrar lo que sí se sabe.
+                motivo: "el modelo la pidió y no llegó a ejecutarse (argumentos inválidos o herramienta inexistente)",
+            });
+            this.anunciadas.delete(id);
+        }
+        if (!asistente.usage)
+            return;
+        // Y se apuntan las de ESTE mensaje, para poder reconciliarlas en el
+        // siguiente.
+        for (const bloque of asistente.content) {
+            if (bloque.type === "toolCall")
+                this.anunciadas.set(bloque.id, bloque.name);
+        }
+        void this.libro().anotar({
+            tipo: "modelo",
+            proveedor: asistente.provider,
+            // `responseModel` es el modelo CONCRETO cuando lo pedido era un alias
+            // (el `auto` de OpenRouter, por ejemplo). Para un registro de
+            // cumplimiento importa el que respondió, no el que se pidió.
+            modelo: asistente.responseModel ?? asistente.model,
+            entrada: asistente.usage.input,
+            salida: asistente.usage.output,
+            coste: asistente.usage.cost?.total,
+            motivoParada: asistente.stopReason,
+        });
+    }
+}
+//# sourceMappingURL=registro-sesion.js.map

package/dist/core/audit/registro-sesion.js.map

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

package/dist/core/audit/retencion.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Purgar el libro sin que la purga parezca una manipulación.
+ *
+ * EL CALLEJÓN SIN SALIDA, medido antes de escribir nada. El artículo 5.1.e del
+ * RGPD obliga a no conservar los datos más de lo necesario, así que un DPO
+ * TIENE que poder borrar lo viejo. Pero hoy:
+ *
+ *   · Si borra los ficheros de `sesion/`, el ancla del índice los sigue
+ *     esperando y `verificar` contesta
+ *     «FALTAN 1 fichero(s) con 3 entrada(s): alguien los ha borrado». Cumplir
+ *     la ley nos acusa de manipular.
+ *   · Si borra también el índice, el libro queda «íntegro» con menos entradas y
+ *     la purga desaparece sin rastro. Es indistinguible de un borrado hostil.
+ *
+ * Las dos salidas son malas, y el subcomando ni siquiera existe: `audit purge`,
+ * `audit purgar`, `audit retencion` → «Subcomando desconocido». El único camino
+ * era `rm`.
+ *
+ * LA IDEA: una purga no es una ausencia, es un HECHO. Y un hecho se anota.
+ *
+ * En vez de borrar y callar, se escribe una LÁPIDA en el libro —encadenada como
+ * cualquier otra entrada— que dice qué periodo se purgó, cuántas entradas
+ * había, bajo qué política, y el hash de cierre del tramo que se va. Con eso:
+ *
+ *   · `verificar` distingue «esto se purgó el día D bajo la política P» de
+ *     «esto ha desaparecido», que es la diferencia entre cumplir y encubrir.
+ *   · El artículo 5.2 —responsabilidad proactiva: hay que poder DEMOSTRAR que
+ *     se cumple— queda cubierto por el propio mecanismo.
+ *   · Y quien reciba el libro años después puede reconstruir qué pasó con lo
+ *     que ya no está.
+ *
+ * LO QUE LA LÁPIDA NO ES. No es una prueba de que lo purgado fuera lo que dice
+ * la lápida: quien controla el disco puede escribir la lápida que quiera. Es
+ * una prueba de INTENCIÓN DECLARADA, y sirve para lo que sirve — que un borrado
+ * legítimo no se confunda con uno hostil, y que uno hostil tenga que mentir por
+ * escrito en vez de limitarse a borrar. Contra un adversario con acceso al
+ * disco no hay defensa local; para eso hace falta un ancla externa.
+ */
+import type { EntradaDelLibro, LibroDeSesion } from "./libro.ts";
+/** Lo que la lápida deja escrito. Todo es dato de forma, nunca contenido. */
+export interface Lapida {
+    /** Qué fichero de sesión se fue. */
+    fichero: string;
+    /** Cuántas entradas tenía, para que el hueco sea contable. */
+    entradas: number;
+    /** El sello de tiempo de la primera y la última, que delimitan el periodo. */
+    desde: string;
+    hasta: string;
+    /** Hash del último eslabón del tramo purgado: ancla de lo que se fue. */
+    hashDeCierre: string;
+    /** Bajo qué regla. Un texto libre que el DPO reconozca en su documentación. */
+    politica: string;
+}
+export interface ResultadoDePurga {
+    purgados: Lapida[];
+    /** Los que se miraron y NO se purgaron, con su motivo. */
+    conservados: Array<{
+        fichero: string;
+        porque: string;
+    }>;
+}
+/**
+ * Purga los ficheros de sesión anteriores a `antesDe`, dejando una lápida.
+ *
+ * `antesDe` se compara contra el sello de la ÚLTIMA entrada del fichero: una
+ * sesión que empezó en enero y terminó en marzo se conserva si el corte está en
+ * febrero. Purgar por la fecha de inicio borraría actividad posterior al corte,
+ * que es justo lo que no se puede hacer.
+ *
+ * No purga el fichero de la sesión EN CURSO aunque cumpla la fecha: quitarle el
+ * suelo a un libro que se está escribiendo rompería su cadena en memoria.
+ */
+export declare function purgarAntesDe(libro: LibroDeSesion, agentDir: string, antesDe: Date, politica: string, 
+/** Con `true` se decide igual pero no se escribe ni se borra nada. */
+simular?: boolean): Promise<ResultadoDePurga>;
+/**
+ * Los ficheros que una lápida declara purgados, leídos del propio libro.
+ *
+ * `verificar` lo usa para distinguir un hueco explicado de uno que no lo está.
+ */
+export declare function ficherosPurgados(entradas: readonly EntradaDelLibro[]): Map<string, Lapida>;
+//# sourceMappingURL=retencion.d.ts.map

package/dist/core/audit/retencion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retencion.d.ts","sourceRoot":"","sources":["../../../src/core/audit/retencion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGjE,6EAA6E;AAC7E,MAAM,WAAW,MAAM;IACtB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0DAA0D;IAC1D,WAAW,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAcD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,EACb,QAAQ,EAAE,MAAM;AAChB,sEAAsE;AACtE,OAAO,UAAQ,GACb,OAAO,CAAC,gBAAgB,CAAC,CAiE3B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAe1F"}

package/dist/core/audit/retencion.js

@@ -0,0 +1,152 @@
+/**
+ * Purgar el libro sin que la purga parezca una manipulación.
+ *
+ * EL CALLEJÓN SIN SALIDA, medido antes de escribir nada. El artículo 5.1.e del
+ * RGPD obliga a no conservar los datos más de lo necesario, así que un DPO
+ * TIENE que poder borrar lo viejo. Pero hoy:
+ *
+ *   · Si borra los ficheros de `sesion/`, el ancla del índice los sigue
+ *     esperando y `verificar` contesta
+ *     «FALTAN 1 fichero(s) con 3 entrada(s): alguien los ha borrado». Cumplir
+ *     la ley nos acusa de manipular.
+ *   · Si borra también el índice, el libro queda «íntegro» con menos entradas y
+ *     la purga desaparece sin rastro. Es indistinguible de un borrado hostil.
+ *
+ * Las dos salidas son malas, y el subcomando ni siquiera existe: `audit purge`,
+ * `audit purgar`, `audit retencion` → «Subcomando desconocido». El único camino
+ * era `rm`.
+ *
+ * LA IDEA: una purga no es una ausencia, es un HECHO. Y un hecho se anota.
+ *
+ * En vez de borrar y callar, se escribe una LÁPIDA en el libro —encadenada como
+ * cualquier otra entrada— que dice qué periodo se purgó, cuántas entradas
+ * había, bajo qué política, y el hash de cierre del tramo que se va. Con eso:
+ *
+ *   · `verificar` distingue «esto se purgó el día D bajo la política P» de
+ *     «esto ha desaparecido», que es la diferencia entre cumplir y encubrir.
+ *   · El artículo 5.2 —responsabilidad proactiva: hay que poder DEMOSTRAR que
+ *     se cumple— queda cubierto por el propio mecanismo.
+ *   · Y quien reciba el libro años después puede reconstruir qué pasó con lo
+ *     que ya no está.
+ *
+ * LO QUE LA LÁPIDA NO ES. No es una prueba de que lo purgado fuera lo que dice
+ * la lápida: quien controla el disco puede escribir la lápida que quiera. Es
+ * una prueba de INTENCIÓN DECLARADA, y sirve para lo que sirve — que un borrado
+ * legítimo no se confunda con uno hostil, y que uno hostil tenga que mentir por
+ * escrito en vez de limitarse a borrar. Contra un adversario con acceso al
+ * disco no hay defensa local; para eso hace falta un ancla externa.
+ */
+import { readFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { DIR_INDICE, DIR_SESION } from "./rutas.js";
+/** Un fichero del libro leído, o `null` si no se pudo. */
+function leerEntradas(ruta) {
+    try {
+        return readFileSync(ruta, "utf-8")
+            .split("\n")
+            .filter(Boolean)
+            .map((l) => JSON.parse(l));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Purga los ficheros de sesión anteriores a `antesDe`, dejando una lápida.
+ *
+ * `antesDe` se compara contra el sello de la ÚLTIMA entrada del fichero: una
+ * sesión que empezó en enero y terminó en marzo se conserva si el corte está en
+ * febrero. Purgar por la fecha de inicio borraría actividad posterior al corte,
+ * que es justo lo que no se puede hacer.
+ *
+ * No purga el fichero de la sesión EN CURSO aunque cumpla la fecha: quitarle el
+ * suelo a un libro que se está escribiendo rompería su cadena en memoria.
+ */
+export async function purgarAntesDe(libro, agentDir, antesDe, politica, 
+/** Con `true` se decide igual pero no se escribe ni se borra nada. */
+simular = false) {
+    const purgados = [];
+    const conservados = [];
+    const { readdirSync } = await import("node:fs");
+    let nombres;
+    try {
+        nombres = readdirSync(join(agentDir, DIR_SESION)).filter((f) => f.endsWith(".jsonl"));
+    }
+    catch {
+        return { purgados, conservados };
+    }
+    for (const nombre of nombres) {
+        // Se pregunta DENTRO del bucle: la primera lápida es la que da nombre al
+        // fichero de esta sesión, así que antes de escribirla el libro todavía no
+        // tiene ninguno —y si no tiene, tampoco está en `nombres`—.
+        if (nombre === libro.ficheroEnCurso) {
+            conservados.push({ fichero: nombre, porque: "es la sesión en curso" });
+            continue;
+        }
+        const ruta = join(agentDir, DIR_SESION, nombre);
+        const entradas = leerEntradas(ruta);
+        // No se borra lo que no se ha podido leer: sin saber qué había, la lápida
+        // sería una declaración inventada, que es peor que no purgar.
+        if (!entradas || entradas.length === 0) {
+            conservados.push({
+                fichero: nombre,
+                porque: "no se ha podido leer, y no se purga lo que no se puede describir",
+            });
+            continue;
+        }
+        const ultima = entradas[entradas.length - 1];
+        if (new Date(ultima.ts) >= antesDe) {
+            conservados.push({
+                fichero: nombre,
+                porque: `su última entrada (${ultima.ts.slice(0, 10)}) es posterior al corte`,
+            });
+            continue;
+        }
+        const lapida = {
+            fichero: nombre,
+            entradas: entradas.length,
+            desde: entradas[0].ts,
+            hasta: ultima.ts,
+            hashDeCierre: ultima.hash,
+            politica,
+        };
+        // La lápida PRIMERO, el borrado después. Si el proceso muere en medio, el
+        // libro tiene una lápida de más y el fichero todavía ahí — un estado
+        // incómodo pero legible. Al revés quedaría un hueco sin explicación, que
+        // es exactamente lo que este módulo existe para no producir.
+        //
+        // Con `simular` se decide EXACTAMENTE igual y no se toca nada: lo que se
+        // enseña antes de un borrado irreversible tiene que salir del mismo camino
+        // que lo ejecuta, o es una promesa sobre otro código.
+        if (!simular) {
+            await libro.anotar({ tipo: "purga", ...lapida });
+            rmSync(ruta, { force: true });
+            rmSync(join(agentDir, DIR_INDICE, nombre), { force: true });
+        }
+        purgados.push(lapida);
+    }
+    return { purgados, conservados };
+}
+/**
+ * Los ficheros que una lápida declara purgados, leídos del propio libro.
+ *
+ * `verificar` lo usa para distinguir un hueco explicado de uno que no lo está.
+ */
+export function ficherosPurgados(entradas) {
+    const mapa = new Map();
+    for (const e of entradas) {
+        const s = e.suceso;
+        if (s.tipo !== "purga" || typeof s.fichero !== "string")
+            continue;
+        mapa.set(s.fichero, {
+            fichero: s.fichero,
+            entradas: Number(s.entradas ?? 0),
+            desde: String(s.desde ?? ""),
+            hasta: String(s.hasta ?? ""),
+            hashDeCierre: String(s.hashDeCierre ?? ""),
+            politica: String(s.politica ?? ""),
+        });
+    }
+    return mapa;
+}
+//# sourceMappingURL=retencion.js.map

package/dist/core/audit/retencion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retencion.js","sourceRoot":"","sources":["../../../src/core/audit/retencion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAuBpD,0DAA0D;AAC1D,SAAS,YAAY,CAAC,IAAY;IACjC,IAAI,CAAC;QACJ,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;aAChC,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAoB,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,KAAoB,EACpB,QAAgB,EAChB,OAAa,EACb,QAAgB;AAChB,sEAAsE;AACtE,OAAO,GAAG,KAAK;IAEf,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,WAAW,GAA+C,EAAE,CAAC;IAEnE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACJ,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,yEAAyE;QACzE,0EAA0E;QAC1E,4DAA4D;QAC5D,IAAI,MAAM,KAAK,KAAK,CAAC,cAAc,EAAE,CAAC;YACrC,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;YACvE,SAAS;QACV,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,0EAA0E;QAC1E,8DAA8D;QAC9D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,WAAW,CAAC,IAAI,CAAC;gBAChB,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE,kEAAkE;aAC1E,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;YACpC,WAAW,CAAC,IAAI,CAAC;gBAChB,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE,sBAAsB,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,yBAAyB;aAC7E,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QAED,MAAM,MAAM,GAAW;YACtB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,QAAQ,CAAC,MAAM;YACzB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YACrB,KAAK,EAAE,MAAM,CAAC,EAAE;YAChB,YAAY,EAAE,MAAM,CAAC,IAAI;YACzB,QAAQ;SACR,CAAC;QACF,0EAA0E;QAC1E,qEAAqE;QACrE,yEAAyE;QACzE,6DAA6D;QAC7D,EAAE;QACF,yEAAyE;QACzE,2EAA2E;QAC3E,sDAAsD;QACtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,EAAW,CAAC,CAAC;YAC1D,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAoC;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,MAAiC,CAAC;QAC9C,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YAAE,SAAS;QAClE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE;YACnB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;YACjC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5B,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5B,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;YAC1C,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC;SAClC,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/core/audit/rutas.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Los dos directorios del libro de auditoría, en un sitio que puedan importar
+ * tanto quien ESCRIBE el libro (`audit/libro.ts`) como quien lo PROTEGE
+ * (`aprobacion/politica.ts`).
+ *
+ * Están aquí y no en `libro.ts` para que la política no arrastre el módulo del
+ * libro entero, y sobre todo para que los dos nombres no puedan divergir:
+ * renombrar el directorio en el libro y olvidarlo en la política dejaría la
+ * carpeta desprotegida sin que nada fallara, que es exactamente la forma de
+ * defecto que perseguimos —una guarda que sigue en verde mirando a un sitio
+ * donde ya no hay nada.
+ */
+/** Donde vive el libro: `<agentDir>/sesion/*.jsonl`. */
+export declare const DIR_SESION = "sesion";
+/**
+ * El índice: el ancla que sobrevive a `rm -rf sesion/`.
+ *
+ * No es una copia de metadatos sino un ENLACE DURO a cada fichero de sesión
+ * (ver `LibroDeSesion.reservarFichero`), así que no puede desincronizarse del
+ * libro: son los mismos bytes con dos nombres.
+ */
+export declare const DIR_INDICE = "libro-indice";
+//# sourceMappingURL=rutas.d.ts.map

package/dist/core/audit/rutas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rutas.d.ts","sourceRoot":"","sources":["../../../src/core/audit/rutas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,wDAAwD;AACxD,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,iBAAiB,CAAC"}

package/dist/core/audit/rutas.js

@@ -0,0 +1,23 @@
+/**
+ * Los dos directorios del libro de auditoría, en un sitio que puedan importar
+ * tanto quien ESCRIBE el libro (`audit/libro.ts`) como quien lo PROTEGE
+ * (`aprobacion/politica.ts`).
+ *
+ * Están aquí y no en `libro.ts` para que la política no arrastre el módulo del
+ * libro entero, y sobre todo para que los dos nombres no puedan divergir:
+ * renombrar el directorio en el libro y olvidarlo en la política dejaría la
+ * carpeta desprotegida sin que nada fallara, que es exactamente la forma de
+ * defecto que perseguimos —una guarda que sigue en verde mirando a un sitio
+ * donde ya no hay nada.
+ */
+/** Donde vive el libro: `<agentDir>/sesion/*.jsonl`. */
+export const DIR_SESION = "sesion";
+/**
+ * El índice: el ancla que sobrevive a `rm -rf sesion/`.
+ *
+ * No es una copia de metadatos sino un ENLACE DURO a cada fichero de sesión
+ * (ver `LibroDeSesion.reservarFichero`), así que no puede desincronizarse del
+ * libro: son los mismos bytes con dos nombres.
+ */
+export const DIR_INDICE = "libro-indice";
+//# sourceMappingURL=rutas.js.map

package/dist/core/audit/rutas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rutas.js","sourceRoot":"","sources":["../../../src/core/audit/rutas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC"}

package/dist/core/auth-guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-guidance.d.ts","sourceRoot":"","sources":["../../src/core/auth-guidance.ts"],"names":[],"mappings":"AAKA,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAED,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnE","sourcesContent":["import { join } from \"node:path\";\nimport { getDocsPath } from \"../config.ts\";\n\nconst UNKNOWN_PROVIDER = \"unknown\";\n\nexport function getProviderLoginHelp(): string {\n\treturn [\n\t\t\"Use /login to log into a provider via OAuth or API key. See:\",\n\t\t`  ${join(getDocsPath(), \"providers.md\")}`,\n\t\t`  ${join(getDocsPath(), \"models.md\")}`,\n\t].join(\"\\n\");\n}\n\nexport function formatNoModelsAvailableMessage(): string {\n\treturn `No models available. ${getProviderLoginHelp()}`;\n}\n\nexport function formatNoModelSelectedMessage(): string {\n\treturn `No model selected.\\n\\n${getProviderLoginHelp()}\\n\\nThen use /model to select a model.`;\n}\n\nexport function formatNoApiKeyFoundMessage(provider: string): string {\n\tconst providerDisplay = provider === UNKNOWN_PROVIDER ? \"the selected model\" : provider;\n\treturn `No API key found for ${providerDisplay}.\\n\\n${getProviderLoginHelp()}`;\n}\n"]}
+{"version":3,"file":"auth-guidance.d.ts","sourceRoot":"","sources":["../../src/core/auth-guidance.ts"],"names":[],"mappings":"AAKA,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAED,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnE"}

package/dist/core/auth-guidance.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth-guidance.js","sourceRoot":"","sources":["../../src/core/auth-guidance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEnC,MAAM,UAAU,oBAAoB,GAAW;IAC9C,OAAO;QACN,8DAA8D;QAC9D,KAAK,IAAI,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,EAAE;QAC1C,KAAK,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,EAAE;KACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACb;AAED,MAAM,UAAU,8BAA8B,GAAW;IACxD,OAAO,wBAAwB,oBAAoB,EAAE,EAAE,CAAC;AAAA,CACxD;AAED,MAAM,UAAU,4BAA4B,GAAW;IACtD,OAAO,yBAAyB,oBAAoB,EAAE,wCAAwC,CAAC;AAAA,CAC/F;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAgB,EAAU;IACpE,MAAM,eAAe,GAAG,QAAQ,KAAK,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxF,OAAO,wBAAwB,eAAe,QAAQ,oBAAoB,EAAE,EAAE,CAAC;AAAA,CAC/E","sourcesContent":["import { join } from \"node:path\";\nimport { getDocsPath } from \"../config.ts\";\n\nconst UNKNOWN_PROVIDER = \"unknown\";\n\nexport function getProviderLoginHelp(): string {\n\treturn [\n\t\t\"Use /login to log into a provider via OAuth or API key. See:\",\n\t\t`  ${join(getDocsPath(), \"providers.md\")}`,\n\t\t`  ${join(getDocsPath(), \"models.md\")}`,\n\t].join(\"\\n\");\n}\n\nexport function formatNoModelsAvailableMessage(): string {\n\treturn `No models available. ${getProviderLoginHelp()}`;\n}\n\nexport function formatNoModelSelectedMessage(): string {\n\treturn `No model selected.\\n\\n${getProviderLoginHelp()}\\n\\nThen use /model to select a model.`;\n}\n\nexport function formatNoApiKeyFoundMessage(provider: string): string {\n\tconst providerDisplay = provider === UNKNOWN_PROVIDER ? \"the selected model\" : provider;\n\treturn `No API key found for ${providerDisplay}.\\n\\n${getProviderLoginHelp()}`;\n}\n"]}
+{"version":3,"file":"auth-guidance.js","sourceRoot":"","sources":["../../src/core/auth-guidance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEnC,MAAM,UAAU,oBAAoB;IACnC,OAAO;QACN,8DAA8D;QAC9D,KAAK,IAAI,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,EAAE;QAC1C,KAAK,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,EAAE;KACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC7C,OAAO,wBAAwB,oBAAoB,EAAE,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC3C,OAAO,yBAAyB,oBAAoB,EAAE,wCAAwC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IAC1D,MAAM,eAAe,GAAG,QAAQ,KAAK,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxF,OAAO,wBAAwB,eAAe,QAAQ,oBAAoB,EAAE,EAAE,CAAC;AAChF,CAAC"}

package/dist/core/auth-storage.d.ts

@@ -38,9 +38,6 @@ export declare class InMemoryAuthStorageBackend implements AuthStorageBackend {
     withLock<T>(fn: (current: string | undefined) => LockResult<T>): T;
     withLockAsync<T>(fn: (current: string | undefined) => Promise<LockResult<T>>, options?: AuthOperationOptions): Promise<T>;
 }
-/**
- * Credential storage backed by a JSON file.
- */
 export declare class AuthStorage implements CredentialStore {
     private storage;
     private authPath;

package/dist/core/auth-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-storage.d.ts","sourceRoot":"","sources":["../../src/core/auth-storage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CredentialStore implementation backed by auth.json.\n * Provider auth orchestration belongs to ModelRuntime and pi-ai Models.\n */\n\nimport type { AuthOperationOptions, Credential, CredentialInfo, CredentialStore } from \"@earendil-works/pi-ai\";\nimport { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { dirname, join } from \"path\";\nimport lockfile from \"proper-lockfile\";\nimport { setTimeout as sleep } from \"timers/promises\";\nimport { getAgentDir } from \"../config.ts\";\nimport { raceWithAbortSignal } from \"../utils/abort.ts\";\nimport { getFileRevision, normalizePath } from \"../utils/paths.ts\";\nimport { stripBom } from \"../utils/text.ts\";\nimport { isCommandConfigValue, resolveConfigValue } from \"./resolve-config-value.ts\";\n\ntype AuthStorageData = Record<string, Credential>;\n\ntype LockResult<T> = {\n\tresult: T;\n\tnext?: string;\n};\n\nconst AUTH_FILE_WRITE_OPTIONS = { encoding: \"utf-8\", mode: 0o600 } as const;\n\ntype AuthFileReload = {\n\tcontroller: AbortController;\n\tpromise: Promise<AuthStorageData>;\n\treaders: number;\n};\n\ntype AuthFileReadState = {\n\tdata: AuthStorageData;\n\trevision?: string;\n\treload?: AuthFileReload;\n};\n\nlet sharedAuthFileReadState: { authPath: string; readState: AuthFileReadState } | undefined;\n\nexport interface AuthStorageBackend {\n\twithLock<T>(fn: (current: string | undefined) => LockResult<T>): T;\n\twithLockAsync<T>(\n\t\tfn: (current: string | undefined) => Promise<LockResult<T>>,\n\t\toptions?: AuthOperationOptions,\n\t): Promise<T>;\n}\n\nexport class FileAuthStorageBackend implements AuthStorageBackend {\n\tprivate authPath: string;\n\n\tconstructor(authPath: string = join(getAgentDir(), \"auth.json\")) {\n\t\tthis.authPath = normalizePath(authPath);\n\t}\n\n\tprivate ensureParentDir(): void {\n\t\tconst dir = dirname(this.authPath);\n\t\tif (!existsSync(dir)) {\n\t\t\tmkdirSync(dir, { recursive: true, mode: 0o700 });\n\t\t}\n\t}\n\n\tprivate ensureFileExists(): void {\n\t\tif (!existsSync(this.authPath)) {\n\t\t\twriteFileSync(this.authPath, \"{}\", AUTH_FILE_WRITE_OPTIONS);\n\t\t\tchmodSync(this.authPath, 0o600);\n\t\t}\n\t}\n\n\tprivate acquireLockSyncWithRetry(path: string): () => void {\n\t\tconst maxAttempts = 10;\n\t\tconst delayMs = 20;\n\t\tlet lastError: unknown;\n\n\t\tfor (let attempt = 1; attempt <= maxAttempts; attempt++) {\n\t\t\ttry {\n\t\t\t\treturn lockfile.lockSync(path, { realpath: false });\n\t\t\t} catch (error) {\n\t\t\t\tconst code =\n\t\t\t\t\ttypeof error === \"object\" && error !== null && \"code\" in error\n\t\t\t\t\t\t? String((error as { code?: unknown }).code)\n\t\t\t\t\t\t: undefined;\n\t\t\t\tif (code !== \"ELOCKED\" || attempt === maxAttempts) {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\tlastError = error;\n\t\t\t\tconst start = Date.now();\n\t\t\t\twhile (Date.now() - start < delayMs) {\n\t\t\t\t\t// Sleep synchronously to avoid changing callers to async.\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tthrow (lastError as Error) ?? new Error(\"Failed to acquire auth storage lock\");\n\t}\n\n\twithLock<T>(fn: (current: string | undefined) => LockResult<T>): T {\n\t\tthis.ensureParentDir();\n\t\tthis.ensureFileExists();\n\n\t\tlet release: (() => void) | undefined;\n\t\ttry {\n\t\t\trelease = this.acquireLockSyncWithRetry(this.authPath);\n\t\t\tconst current = existsSync(this.authPath) ? readFileSync(this.authPath, \"utf-8\") : undefined;\n\t\t\tconst { result, next } = fn(current);\n\t\t\tif (next !== undefined) {\n\t\t\t\twriteFileSync(this.authPath, next, AUTH_FILE_WRITE_OPTIONS);\n\t\t\t\tchmodSync(this.authPath, 0o600);\n\t\t\t}\n\t\t\treturn result;\n\t\t} finally {\n\t\t\tif (release) {\n\t\t\t\trelease();\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async acquireLockAsync(\n\t\tsignal: AbortSignal | undefined,\n\t\tonCompromised: (error: Error) => void,\n\t): Promise<() => Promise<void>> {\n\t\tconst staleMs = 30_000;\n\t\tconst maxDelayMs = 2_000;\n\t\tconst deadline = Date.now() + staleMs;\n\t\tlet retry = 0;\n\t\twhile (true) {\n\t\t\tsignal?.throwIfAborted();\n\t\t\tlet release: (() => Promise<void>) | undefined;\n\t\t\ttry {\n\t\t\t\trelease = await lockfile.lock(this.authPath, {\n\t\t\t\t\trealpath: false,\n\t\t\t\t\tretries: 0,\n\t\t\t\t\tstale: staleMs,\n\t\t\t\t\tonCompromised,\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tsignal?.throwIfAborted();\n\t\t\t\tconst code =\n\t\t\t\t\ttypeof error === \"object\" && error !== null && \"code\" in error\n\t\t\t\t\t\t? String((error as { code?: unknown }).code)\n\t\t\t\t\t\t: undefined;\n\t\t\t\tconst remainingMs = deadline - Date.now();\n\t\t\t\tif (code !== \"ELOCKED\" || remainingMs <= 0) throw error;\n\t\t\t\tconst baseDelayMs = Math.min(10 * 2 ** retry, maxDelayMs / 2);\n\t\t\t\tretry++;\n\t\t\t\tconst delayMs = Math.min(Math.round(baseDelayMs * (1 + Math.random())), remainingMs);\n\t\t\t\tif (signal) await sleep(delayMs, undefined, { signal });\n\t\t\t\telse await sleep(delayMs);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (signal?.aborted) {\n\t\t\t\tawait release();\n\t\t\t\tsignal.throwIfAborted();\n\t\t\t}\n\t\t\treturn release;\n\t\t}\n\t}\n\n\tasync withLockAsync<T>(\n\t\tfn: (current: string | undefined) => Promise<LockResult<T>>,\n\t\toptions?: AuthOperationOptions,\n\t): Promise<T> {\n\t\toptions?.signal?.throwIfAborted();\n\t\tthis.ensureParentDir();\n\t\tthis.ensureFileExists();\n\n\t\tlet release: (() => Promise<void>) | undefined;\n\t\tlet lockCompromised = false;\n\t\tlet lockCompromisedError: Error | undefined;\n\t\tconst throwIfCompromised = () => {\n\t\t\tif (lockCompromised) {\n\t\t\t\tthrow lockCompromisedError ?? new Error(\"Auth storage lock was compromised\");\n\t\t\t}\n\t\t};\n\n\t\ttry {\n\t\t\trelease = await this.acquireLockAsync(options?.signal, (error) => {\n\t\t\t\tlockCompromised = true;\n\t\t\t\tlockCompromisedError = error;\n\t\t\t});\n\n\t\t\tthrowIfCompromised();\n\t\t\toptions?.signal?.throwIfAborted();\n\t\t\tconst current = existsSync(this.authPath) ? readFileSync(this.authPath, \"utf-8\") : undefined;\n\t\t\tconst { result, next } = await fn(current);\n\t\t\tthrowIfCompromised();\n\t\t\toptions?.signal?.throwIfAborted();\n\t\t\tif (next !== undefined) {\n\t\t\t\twriteFileSync(this.authPath, next, AUTH_FILE_WRITE_OPTIONS);\n\t\t\t\tchmodSync(this.authPath, 0o600);\n\t\t\t}\n\t\t\tthrowIfCompromised();\n\t\t\treturn result;\n\t\t} finally {\n\t\t\tif (release) {\n\t\t\t\ttry {\n\t\t\t\t\tawait release();\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore unlock errors when lock is compromised.\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport class ReadOnlyAuthStorage implements CredentialStore {\n\tprivate readonly authPath: string;\n\tprivate data: AuthStorageData | undefined;\n\n\tconstructor(authPath: string = join(getAgentDir(), \"auth.json\")) {\n\t\tthis.authPath = normalizePath(authPath);\n\t}\n\n\tprivate load(): AuthStorageData {\n\t\tif (this.data) return this.data;\n\n\t\tlet parsed: unknown;\n\t\ttry {\n\t\t\tparsed = JSON.parse(stripBom(readFileSync(this.authPath, \"utf-8\")));\n\t\t} catch (error) {\n\t\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n\t\t\t\tthis.data = {};\n\t\t\t\treturn this.data;\n\t\t\t}\n\t\t\tthrow new Error(`Failed to read auth.json: ${error instanceof Error ? error.message : String(error)}`);\n\t\t}\n\n\t\tif (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n\t\t\tthrow new Error(\"Invalid auth.json: expected an object\");\n\t\t}\n\t\tfor (const [providerId, credential] of Object.entries(parsed)) {\n\t\t\tif (typeof credential !== \"object\" || credential === null || Array.isArray(credential)) {\n\t\t\t\tthrow new Error(`Invalid auth.json credential for provider \"${providerId}\"`);\n\t\t\t}\n\t\t\tconst value = credential as Record<string, unknown>;\n\t\t\tif (value.type === \"api_key\") {\n\t\t\t\tconst validKey = value.key === undefined || typeof value.key === \"string\";\n\t\t\t\tconst validEnv =\n\t\t\t\t\tvalue.env === undefined ||\n\t\t\t\t\t(typeof value.env === \"object\" &&\n\t\t\t\t\t\tvalue.env !== null &&\n\t\t\t\t\t\t!Array.isArray(value.env) &&\n\t\t\t\t\t\tObject.values(value.env).every((entry) => typeof entry === \"string\"));\n\t\t\t\tif (validKey && validEnv) continue;\n\t\t\t} else if (\n\t\t\t\tvalue.type === \"oauth\" &&\n\t\t\t\ttypeof value.access === \"string\" &&\n\t\t\t\ttypeof value.refresh === \"string\" &&\n\t\t\t\ttypeof value.expires === \"number\" &&\n\t\t\t\tNumber.isFinite(value.expires)\n\t\t\t) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tthrow new Error(`Invalid auth.json credential for provider \"${providerId}\"`);\n\t\t}\n\n\t\tthis.data = parsed as AuthStorageData;\n\t\treturn this.data;\n\t}\n\n\tasync read(providerId: string, options?: AuthOperationOptions): Promise<Credential | undefined> {\n\t\toptions?.signal?.throwIfAborted();\n\t\tconst credential = this.load()[providerId];\n\t\toptions?.signal?.throwIfAborted();\n\t\tif (!credential) return undefined;\n\t\tif (credential.type !== \"api_key\" || !credential.key || isCommandConfigValue(credential.key)) {\n\t\t\treturn structuredClone(credential);\n\t\t}\n\t\treturn { ...credential, key: resolveConfigValue(credential.key, credential.env) };\n\t}\n\n\tasync list(options?: AuthOperationOptions): Promise<readonly CredentialInfo[]> {\n\t\toptions?.signal?.throwIfAborted();\n\t\tconst credentials = Object.entries(this.load()).map(([providerId, credential]) => ({\n\t\t\tproviderId,\n\t\t\ttype: credential.type,\n\t\t}));\n\t\toptions?.signal?.throwIfAborted();\n\t\treturn credentials;\n\t}\n\n\tasync modify(\n\t\t_providerId: string,\n\t\t_fn: (current: Credential | undefined) => Promise<Credential | undefined>,\n\t\t_options?: AuthOperationOptions,\n\t): Promise<Credential | undefined> {\n\t\tthrow new Error(\"Read-only credential storage cannot modify auth.json\");\n\t}\n\n\tasync delete(_providerId: string, _options?: AuthOperationOptions): Promise<void> {\n\t\tthrow new Error(\"Read-only credential storage cannot modify auth.json\");\n\t}\n}\n\nexport class InMemoryAuthStorageBackend implements AuthStorageBackend {\n\tprivate value: string | undefined;\n\tprivate asyncChain: Promise<unknown> = Promise.resolve();\n\n\twithLock<T>(fn: (current: string | undefined) => LockResult<T>): T {\n\t\tconst { result, next } = fn(this.value);\n\t\tif (next !== undefined) {\n\t\t\tthis.value = next;\n\t\t}\n\t\treturn result;\n\t}\n\n\twithLockAsync<T>(\n\t\tfn: (current: string | undefined) => Promise<LockResult<T>>,\n\t\toptions?: AuthOperationOptions,\n\t): Promise<T> {\n\t\tconst previous = this.asyncChain;\n\t\tconst operation = (async () => {\n\t\t\tawait previous.catch(() => {});\n\t\t\toptions?.signal?.throwIfAborted();\n\t\t\tconst { result, next } = await fn(this.value);\n\t\t\toptions?.signal?.throwIfAborted();\n\t\t\tif (next !== undefined) {\n\t\t\t\tthis.value = next;\n\t\t\t}\n\t\t\treturn result;\n\t\t})();\n\t\tthis.asyncChain = operation.catch(() => {});\n\t\treturn raceWithAbortSignal(operation, options?.signal);\n\t}\n}\n\n/**\n * Credential storage backed by a JSON file.\n */\nexport class AuthStorage implements CredentialStore {\n\tprivate storage: AuthStorageBackend;\n\tprivate authPath: string | undefined;\n\tprivate readState: AuthFileReadState;\n\n\tprivate constructor(storage: AuthStorageBackend, authPath?: string) {\n\t\tthis.storage = storage;\n\t\tthis.authPath = authPath;\n\t\tthis.readState =\n\t\t\tauthPath && sharedAuthFileReadState?.authPath === authPath ? sharedAuthFileReadState.readState : { data: {} };\n\t\tif (authPath && !sharedAuthFileReadState) {\n\t\t\tsharedAuthFileReadState = { authPath, readState: this.readState };\n\t\t}\n\t\tif (authPath) {\n\t\t\tconst revision = getFileRevision(authPath);\n\t\t\tif (revision !== undefined && revision === this.readState.revision) return;\n\t\t}\n\t\tthis.reload();\n\t}\n\n\tstatic create(authPath: string = join(getAgentDir(), \"auth.json\")): AuthStorage {\n\t\tconst normalizedAuthPath = normalizePath(authPath);\n\t\treturn new AuthStorage(new FileAuthStorageBackend(normalizedAuthPath), normalizedAuthPath);\n\t}\n\n\tstatic fromStorage(storage: AuthStorageBackend): AuthStorage {\n\t\treturn new AuthStorage(storage);\n\t}\n\n\tstatic inMemory(data: AuthStorageData = {}): AuthStorage {\n\t\tconst storage = new InMemoryAuthStorageBackend();\n\t\tstorage.withLock(() => ({ result: undefined, next: JSON.stringify(data, null, 2) }));\n\t\treturn AuthStorage.fromStorage(storage);\n\t}\n\n\tprivate parseStorageData(content: string | undefined): AuthStorageData {\n\t\tif (!content) {\n\t\t\treturn {};\n\t\t}\n\t\treturn JSON.parse(stripBom(content)) as AuthStorageData;\n\t}\n\n\tprivate updateReadState(data: AuthStorageData, revision?: string): void {\n\t\tthis.readState.data = data;\n\t\tthis.readState.revision = revision;\n\t}\n\n\t/**\n\t * Reload credentials from storage.\n\t */\n\treload(): void {\n\t\tlet content: string | undefined;\n\t\tlet revision: string | undefined;\n\t\ttry {\n\t\t\tthis.storage.withLock((current) => {\n\t\t\t\tcontent = current;\n\t\t\t\trevision = this.authPath ? getFileRevision(this.authPath) : undefined;\n\t\t\t\treturn { result: undefined };\n\t\t\t});\n\t\t\tthis.updateReadState(this.parseStorageData(content), revision);\n\t\t} catch {\n\t\t\t// Preserve the last valid in-memory snapshot.\n\t\t}\n\t}\n\n\tprivate async reloadFromStorageAsync(options?: AuthOperationOptions): Promise<AuthStorageData> {\n\t\treturn this.storage.withLockAsync(async (content) => {\n\t\t\tconst currentData = this.parseStorageData(content);\n\t\t\tconst revision = this.authPath ? getFileRevision(this.authPath) : undefined;\n\t\t\tthis.updateReadState(currentData, revision);\n\t\t\treturn { result: currentData };\n\t\t}, options);\n\t}\n\n\tprivate async readLatestData(options?: AuthOperationOptions): Promise<AuthStorageData> {\n\t\toptions?.signal?.throwIfAborted();\n\t\tif (!this.authPath) {\n\t\t\tconst reload = this.reloadFromStorageAsync(options);\n\t\t\treturn options?.signal ? reload : reload.catch(() => this.readState.data);\n\t\t}\n\t\tconst revision = getFileRevision(this.authPath);\n\t\tif (revision !== undefined && revision === this.readState.revision) return this.readState.data;\n\t\tif (!this.readState.reload) {\n\t\t\tconst controller = new AbortController();\n\t\t\tconst reload: AuthFileReload = {\n\t\t\t\tcontroller,\n\t\t\t\tpromise: this.reloadFromStorageAsync({ signal: controller.signal }),\n\t\t\t\treaders: 0,\n\t\t\t};\n\t\t\tthis.readState.reload = reload;\n\t\t\tvoid reload.promise.then(\n\t\t\t\t() => {\n\t\t\t\t\tif (this.readState.reload === reload) this.readState.reload = undefined;\n\t\t\t\t},\n\t\t\t\t() => {\n\t\t\t\t\tif (this.readState.reload === reload) this.readState.reload = undefined;\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\n\t\tconst reload = this.readState.reload;\n\t\treload.readers++;\n\t\ttry {\n\t\t\tconst result = raceWithAbortSignal(reload.promise, options?.signal);\n\t\t\treturn options?.signal ? await result : await result.catch(() => this.readState.data);\n\t\t} finally {\n\t\t\treload.readers--;\n\t\t\tif (reload.readers === 0 && this.readState.reload === reload) {\n\t\t\t\tthis.readState.reload = undefined;\n\t\t\t\treload.controller.abort();\n\t\t\t}\n\t\t}\n\t}\n\n\tasync read(provider: string, options?: AuthOperationOptions): Promise<Credential | undefined> {\n\t\tconst credential = (await this.readLatestData(options))[provider];\n\t\toptions?.signal?.throwIfAborted();\n\t\tif (credential?.type !== \"api_key\") return credential;\n\t\tif (credential.key === undefined) return credential;\n\t\treturn { ...credential, key: resolveConfigValue(credential.key, credential.env) };\n\t}\n\n\tasync modify(\n\t\tprovider: string,\n\t\tfn: (current: Credential | undefined) => Promise<Credential | undefined>,\n\t\toptions?: AuthOperationOptions,\n\t): Promise<Credential | undefined> {\n\t\tlet latestData = this.readState.data;\n\t\tlet revision: string | undefined;\n\t\tconst result = await this.storage.withLockAsync(async (content) => {\n\t\t\tconst currentData = this.parseStorageData(content);\n\t\t\tconst next = await fn(currentData[provider]);\n\t\t\tif (next === undefined) {\n\t\t\t\tlatestData = currentData;\n\t\t\t\trevision = this.authPath ? getFileRevision(this.authPath) : undefined;\n\t\t\t\treturn { result: currentData[provider] };\n\t\t\t}\n\n\t\t\tconst merged: AuthStorageData = { ...currentData, [provider]: next };\n\t\t\tlatestData = merged;\n\t\t\treturn { result: next, next: JSON.stringify(merged, null, 2) };\n\t\t}, options);\n\t\tthis.updateReadState(latestData, revision);\n\t\treturn result;\n\t}\n\n\tasync delete(provider: string, options?: AuthOperationOptions): Promise<void> {\n\t\tlet latestData = this.readState.data;\n\t\tawait this.storage.withLockAsync(async (content) => {\n\t\t\tconst currentData = this.parseStorageData(content);\n\t\t\tdelete currentData[provider];\n\t\t\tlatestData = currentData;\n\t\t\treturn { result: undefined, next: JSON.stringify(currentData, null, 2) };\n\t\t}, options);\n\t\tthis.updateReadState(latestData);\n\t}\n\n\t/** List credential metadata without resolving configured key values. */\n\tasync list(options?: AuthOperationOptions): Promise<readonly CredentialInfo[]> {\n\t\tconst entries = Object.entries(await this.readLatestData(options));\n\t\toptions?.signal?.throwIfAborted();\n\t\treturn entries.map(([providerId, credential]) => ({ providerId, type: credential.type }));\n\t}\n}\n\n/**\n * One-off synchronous read of a stored credential from an auth.json file,\n * without instantiating a store or resolving configured key values.\n */\nexport function readStoredCredential(\n\tproviderId: string,\n\tauthPath: string = join(getAgentDir(), \"auth.json\"),\n): Credential | undefined {\n\ttry {\n\t\tconst data = JSON.parse(stripBom(readFileSync(normalizePath(authPath), \"utf-8\"))) as AuthStorageData;\n\t\treturn data[providerId];\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n"]}
+{"version":3,"file":"auth-storage.d.ts","sourceRoot":"","sources":["../../src/core/auth-storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAW/G,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAElD,KAAK,UAAU,CAAC,CAAC,IAAI;IACpB,MAAM,EAAE,CAAC,CAAC;IACV,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAmBF,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnE,aAAa,CAAC,CAAC,EACd,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAC3D,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,CAAC,CAAC,CAAC;CACd;AAED,qBAAa,sBAAuB,YAAW,kBAAkB;IAChE,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,GAAE,MAAyC;IAI/D,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,wBAAwB;IA2BhC,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;YAoBpD,gBAAgB;IAyCxB,aAAa,CAAC,CAAC,EACpB,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAC3D,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,CAAC,CAAC;CAyCb;AAED,qBAAa,mBAAoB,YAAW,eAAe;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,IAAI,CAA8B;gBAE9B,QAAQ,GAAE,MAAyC;IAI/D,OAAO,CAAC,IAAI;IA+CN,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAWzF,IAAI,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAUxE,MAAM,CACX,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,EACzE,QAAQ,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAI5B,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjF;AAED,qBAAa,0BAA2B,YAAW,kBAAkB;IACpE,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,UAAU,CAAuC;IAEzD,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;IAQlE,aAAa,CAAC,CAAC,EACd,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAC3D,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,CAAC,CAAC;CAeb;AASD,qBAAa,WAAY,YAAW,eAAe;IAClD,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAoB;IAErC,OAAO;IAyBP,MAAM,CAAC,MAAM,CAAC,QAAQ,GAAE,MAAyC,GAAG,WAAW;IAK/E,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;IAI5D,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,WAAW;IAMxD,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,MAAM,IAAI,IAAI;YAeA,sBAAsB;YAStB,cAAc;IAwCtB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAQvF,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,EACxE,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAoB5B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7E,wEAAwE;IAClE,IAAI,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;CAK9E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAyC,GACjD,UAAU,GAAG,SAAS,CAOxB"}