@hoilab/ada-cli 0.84.22 → 0.85.0

package/dist/core/undo/journal.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Diario para deshacer los cambios de ficheros de un turno.
+ *
+ * Guarda el estado ANTERIOR de cada fichero justo antes de tocarlo, agrupado
+ * por turno. `deshacer()` devuelve todos los ficheros del último turno a la vez,
+ * o ninguno: revertir la mitad de un cambio deja el repositorio en un estado que
+ * el agente no produjo nunca y que nadie ha revisado.
+ *
+ * El punto de captura es `withFileMutationQueue`, por donde pasan tanto `edit`
+ * como `write`. Engancharse ahí cubre las dos herramientas con un solo sitio, y
+ * cualquier herramienta futura que escriba ficheros entra gratis.
+ */
+export interface EntradaDiario {
+    turno: number;
+    path: string;
+    /** Contenido anterior; `null` si el fichero no existía (lo creó el turno). */
+    previo: string | null;
+    /** `true` si era demasiado grande para fotografiar. */
+    omitido?: boolean;
+    ts: number;
+}
+/**
+ * Abre un turno nuevo. Todo lo que se escriba a partir de aquí se agrupa junto.
+ *
+ * El número de turno sale del diario, no de un contador en memoria: si el
+ * proceso se reinicia a mitad de sesión, el turno siguiente no puede reutilizar
+ * un número y mezclarse con cambios viejos.
+ */
+export declare function abrirTurno(agentDir: string, cwd: string, ahora: number): number;
+export declare function cerrarTurno(): void;
+/**
+ * Fotografía un fichero antes de que lo toquen.
+ *
+ * Solo la PRIMERA vez dentro del turno: si el agente edita el mismo fichero
+ * cinco veces, deshacer debe devolverlo a como estaba antes de las cinco, no
+ * antes de la última.
+ */
+export declare function registrarPrevio(rutaFichero: string): void;
+export interface ResultadoDeshacer {
+    turno: number | null;
+    restaurados: string[];
+    borrados: string[];
+    omitidos: string[];
+    error?: string;
+}
+/**
+ * Deshace el último turno con cambios. Todo o nada.
+ *
+ * Antes de escribir nada se fotografía el estado actual de cada objetivo; si
+ * una escritura falla a mitad, se devuelven todas atrás. Sin eso, un fallo de
+ * permisos en el tercer fichero dejaría dos revertidos y tres no — un estado
+ * que nadie escribió ni revisó.
+ */
+export declare function deshacer(agentDir: string, cwd: string): ResultadoDeshacer;
+/** Qué haría un `undo` sin llegar a hacerlo. */
+export declare function previsualizar(agentDir: string, cwd: string): EntradaDiario[];
+//# sourceMappingURL=journal.d.ts.map

package/dist/core/undo/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../../src/core/undo/journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,gFAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACX;AAgBD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA6BzD;AAgBD,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAyDzE;AAED,kDAAgD;AAChD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAI5E","sourcesContent":["/**\n * Diario para deshacer los cambios de ficheros de un turno.\n *\n * Guarda el estado ANTERIOR de cada fichero justo antes de tocarlo, agrupado\n * por turno. `deshacer()` devuelve todos los ficheros del último turno a la vez,\n * o ninguno: revertir la mitad de un cambio deja el repositorio en un estado que\n * el agente no produjo nunca y que nadie ha revisado.\n *\n * El punto de captura es `withFileMutationQueue`, por donde pasan tanto `edit`\n * como `write`. Engancharse ahí cubre las dos herramientas con un solo sitio, y\n * cualquier herramienta futura que escriba ficheros entra gratis.\n */\n\nimport { createHash } from \"node:crypto\";\nimport { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\n/**\n * Un fichero más grande que esto no se fotografía.\n *\n * Se registra igualmente, marcado, para poder DECIRLO al deshacer. Callarlo\n * sería peor: el usuario creería que revirtió todo cuando faltó un fichero.\n */\nconst MAX_FOTO_BYTES = 4 * 1024 * 1024;\n\nexport interface EntradaDiario {\n\tturno: number;\n\tpath: string;\n\t/** Contenido anterior; `null` si el fichero no existía (lo creó el turno). */\n\tprevio: string | null;\n\t/** `true` si era demasiado grande para fotografiar. */\n\tomitido?: boolean;\n\tts: number;\n}\n\ninterface TurnoActivo {\n\trutaDiario: string;\n\tturno: number;\n\tvistos: Set<string>;\n}\n\n/** El turno abierto ahora mismo. La cola de mutaciones no conoce la sesión. */\nlet activo: TurnoActivo | null = null;\n\nfunction rutaDelDiario(agentDir: string, cwd: string): string {\n\tconst clave = createHash(\"sha256\").update(cwd).digest(\"hex\").slice(0, 16);\n\treturn join(agentDir, \"undo\", `${clave}.jsonl`);\n}\n\n/**\n * Abre un turno nuevo. Todo lo que se escriba a partir de aquí se agrupa junto.\n *\n * El número de turno sale del diario, no de un contador en memoria: si el\n * proceso se reinicia a mitad de sesión, el turno siguiente no puede reutilizar\n * un número y mezclarse con cambios viejos.\n */\nexport function abrirTurno(agentDir: string, cwd: string, ahora: number): number {\n\tconst rutaDiario = rutaDelDiario(agentDir, cwd);\n\tmkdirSync(dirname(rutaDiario), { recursive: true, mode: 0o700 });\n\tconst turno = (leerEntradas(rutaDiario).at(-1)?.turno ?? 0) + 1;\n\tactivo = { rutaDiario, turno, vistos: new Set() };\n\tvoid ahora;\n\treturn turno;\n}\n\nexport function cerrarTurno(): void {\n\tactivo = null;\n}\n\n/**\n * Fotografía un fichero antes de que lo toquen.\n *\n * Solo la PRIMERA vez dentro del turno: si el agente edita el mismo fichero\n * cinco veces, deshacer debe devolverlo a como estaba antes de las cinco, no\n * antes de la última.\n */\nexport function registrarPrevio(rutaFichero: string): void {\n\tif (!activo || activo.vistos.has(rutaFichero)) return;\n\tactivo.vistos.add(rutaFichero);\n\n\tlet entrada: EntradaDiario;\n\ttry {\n\t\tif (!existsSync(rutaFichero)) {\n\t\t\tentrada = { turno: activo.turno, path: rutaFichero, previo: null, ts: Date.now() };\n\t\t} else if (statSync(rutaFichero).size > MAX_FOTO_BYTES) {\n\t\t\tentrada = { turno: activo.turno, path: rutaFichero, previo: null, omitido: true, ts: Date.now() };\n\t\t} else {\n\t\t\tentrada = {\n\t\t\t\tturno: activo.turno,\n\t\t\t\tpath: rutaFichero,\n\t\t\t\tprevio: readFileSync(rutaFichero, \"utf8\"),\n\t\t\t\tts: Date.now(),\n\t\t\t};\n\t\t}\n\t} catch {\n\t\t// Un fichero ilegible no puede impedir la edición; se marca omitido para\n\t\t// que deshacer lo diga en vez de fingir que lo revirtió.\n\t\tentrada = { turno: activo.turno, path: rutaFichero, previo: null, omitido: true, ts: Date.now() };\n\t}\n\ttry {\n\t\tappendFileSync(activo.rutaDiario, `${JSON.stringify(entrada)}\\n`, { mode: 0o600 });\n\t} catch {\n\t\t// El diario es una comodidad, no una garantía: si no se puede escribir,\n\t\t// la edición sigue adelante.\n\t}\n}\n\nfunction leerEntradas(rutaDiario: string): EntradaDiario[] {\n\tif (!existsSync(rutaDiario)) return [];\n\tconst entradas: EntradaDiario[] = [];\n\tfor (const linea of readFileSync(rutaDiario, \"utf8\").split(\"\\n\")) {\n\t\tif (!linea.trim()) continue;\n\t\ttry {\n\t\t\tentradas.push(JSON.parse(linea) as EntradaDiario);\n\t\t} catch {\n\t\t\t// Una línea corrupta no invalida el resto del diario.\n\t\t}\n\t}\n\treturn entradas;\n}\n\nexport interface ResultadoDeshacer {\n\tturno: number | null;\n\trestaurados: string[];\n\tborrados: string[];\n\tomitidos: string[];\n\terror?: string;\n}\n\n/**\n * Deshace el último turno con cambios. Todo o nada.\n *\n * Antes de escribir nada se fotografía el estado actual de cada objetivo; si\n * una escritura falla a mitad, se devuelven todas atrás. Sin eso, un fallo de\n * permisos en el tercer fichero dejaría dos revertidos y tres no — un estado\n * que nadie escribió ni revisó.\n */\nexport function deshacer(agentDir: string, cwd: string): ResultadoDeshacer {\n\tconst rutaDiario = rutaDelDiario(agentDir, cwd);\n\tconst entradas = leerEntradas(rutaDiario);\n\tconst ultimo = entradas.at(-1)?.turno;\n\tif (ultimo === undefined) return { turno: null, restaurados: [], borrados: [], omitidos: [] };\n\n\tconst delTurno = entradas.filter((e) => e.turno === ultimo);\n\tconst aplicables = delTurno.filter((e) => !e.omitido);\n\tconst omitidos = delTurno.filter((e) => e.omitido).map((e) => e.path);\n\n\t// Foto de seguridad para poder retroceder si algo peta a mitad.\n\tconst seguro = new Map<string, string | null>();\n\tfor (const e of aplicables) {\n\t\tseguro.set(e.path, existsSync(e.path) ? readFileSync(e.path, \"utf8\") : null);\n\t}\n\n\tconst restaurados: string[] = [];\n\tconst borrados: string[] = [];\n\ttry {\n\t\tfor (const e of aplicables) {\n\t\t\tif (e.previo === null) {\n\t\t\t\t// El turno creó el fichero: deshacer es borrarlo.\n\t\t\t\tif (existsSync(e.path)) unlinkSync(e.path);\n\t\t\t\tborrados.push(e.path);\n\t\t\t} else {\n\t\t\t\tmkdirSync(dirname(e.path), { recursive: true });\n\t\t\t\twriteFileSync(e.path, e.previo, \"utf8\");\n\t\t\t\trestaurados.push(e.path);\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tfor (const [ruta, contenido] of seguro) {\n\t\t\ttry {\n\t\t\t\tif (contenido === null) {\n\t\t\t\t\tif (existsSync(ruta)) unlinkSync(ruta);\n\t\t\t\t} else {\n\t\t\t\t\twriteFileSync(ruta, contenido, \"utf8\");\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Poco más se puede hacer; el mensaje de error lo dirá.\n\t\t\t}\n\t\t}\n\t\treturn {\n\t\t\tturno: ultimo,\n\t\t\trestaurados: [],\n\t\t\tborrados: [],\n\t\t\tomitidos,\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t};\n\t}\n\n\t// El turno deshecho sale del diario: deshacer dos veces debe ir al anterior,\n\t// no repetir el mismo.\n\tconst restantes = entradas.filter((e) => e.turno !== ultimo);\n\twriteFileSync(rutaDiario, restantes.map((e) => `${JSON.stringify(e)}\\n`).join(\"\"), { mode: 0o600 });\n\n\treturn { turno: ultimo, restaurados, borrados, omitidos };\n}\n\n/** Qué haría un `undo` sin llegar a hacerlo. */\nexport function previsualizar(agentDir: string, cwd: string): EntradaDiario[] {\n\tconst entradas = leerEntradas(rutaDelDiario(agentDir, cwd));\n\tconst ultimo = entradas.at(-1)?.turno;\n\treturn ultimo === undefined ? [] : entradas.filter((e) => e.turno === ultimo);\n}\n"]}

package/dist/core/undo/journal.js

@@ -0,0 +1,178 @@
+/**
+ * Diario para deshacer los cambios de ficheros de un turno.
+ *
+ * Guarda el estado ANTERIOR de cada fichero justo antes de tocarlo, agrupado
+ * por turno. `deshacer()` devuelve todos los ficheros del último turno a la vez,
+ * o ninguno: revertir la mitad de un cambio deja el repositorio en un estado que
+ * el agente no produjo nunca y que nadie ha revisado.
+ *
+ * El punto de captura es `withFileMutationQueue`, por donde pasan tanto `edit`
+ * como `write`. Engancharse ahí cubre las dos herramientas con un solo sitio, y
+ * cualquier herramienta futura que escriba ficheros entra gratis.
+ */
+import { createHash } from "node:crypto";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Un fichero más grande que esto no se fotografía.
+ *
+ * Se registra igualmente, marcado, para poder DECIRLO al deshacer. Callarlo
+ * sería peor: el usuario creería que revirtió todo cuando faltó un fichero.
+ */
+const MAX_FOTO_BYTES = 4 * 1024 * 1024;
+/** El turno abierto ahora mismo. La cola de mutaciones no conoce la sesión. */
+let activo = null;
+function rutaDelDiario(agentDir, cwd) {
+    const clave = createHash("sha256").update(cwd).digest("hex").slice(0, 16);
+    return join(agentDir, "undo", `${clave}.jsonl`);
+}
+/**
+ * Abre un turno nuevo. Todo lo que se escriba a partir de aquí se agrupa junto.
+ *
+ * El número de turno sale del diario, no de un contador en memoria: si el
+ * proceso se reinicia a mitad de sesión, el turno siguiente no puede reutilizar
+ * un número y mezclarse con cambios viejos.
+ */
+export function abrirTurno(agentDir, cwd, ahora) {
+    const rutaDiario = rutaDelDiario(agentDir, cwd);
+    mkdirSync(dirname(rutaDiario), { recursive: true, mode: 0o700 });
+    const turno = (leerEntradas(rutaDiario).at(-1)?.turno ?? 0) + 1;
+    activo = { rutaDiario, turno, vistos: new Set() };
+    void ahora;
+    return turno;
+}
+export function cerrarTurno() {
+    activo = null;
+}
+/**
+ * Fotografía un fichero antes de que lo toquen.
+ *
+ * Solo la PRIMERA vez dentro del turno: si el agente edita el mismo fichero
+ * cinco veces, deshacer debe devolverlo a como estaba antes de las cinco, no
+ * antes de la última.
+ */
+export function registrarPrevio(rutaFichero) {
+    if (!activo || activo.vistos.has(rutaFichero))
+        return;
+    activo.vistos.add(rutaFichero);
+    let entrada;
+    try {
+        if (!existsSync(rutaFichero)) {
+            entrada = { turno: activo.turno, path: rutaFichero, previo: null, ts: Date.now() };
+        }
+        else if (statSync(rutaFichero).size > MAX_FOTO_BYTES) {
+            entrada = { turno: activo.turno, path: rutaFichero, previo: null, omitido: true, ts: Date.now() };
+        }
+        else {
+            entrada = {
+                turno: activo.turno,
+                path: rutaFichero,
+                previo: readFileSync(rutaFichero, "utf8"),
+                ts: Date.now(),
+            };
+        }
+    }
+    catch {
+        // Un fichero ilegible no puede impedir la edición; se marca omitido para
+        // que deshacer lo diga en vez de fingir que lo revirtió.
+        entrada = { turno: activo.turno, path: rutaFichero, previo: null, omitido: true, ts: Date.now() };
+    }
+    try {
+        appendFileSync(activo.rutaDiario, `${JSON.stringify(entrada)}\n`, { mode: 0o600 });
+    }
+    catch {
+        // El diario es una comodidad, no una garantía: si no se puede escribir,
+        // la edición sigue adelante.
+    }
+}
+function leerEntradas(rutaDiario) {
+    if (!existsSync(rutaDiario))
+        return [];
+    const entradas = [];
+    for (const linea of readFileSync(rutaDiario, "utf8").split("\n")) {
+        if (!linea.trim())
+            continue;
+        try {
+            entradas.push(JSON.parse(linea));
+        }
+        catch {
+            // Una línea corrupta no invalida el resto del diario.
+        }
+    }
+    return entradas;
+}
+/**
+ * Deshace el último turno con cambios. Todo o nada.
+ *
+ * Antes de escribir nada se fotografía el estado actual de cada objetivo; si
+ * una escritura falla a mitad, se devuelven todas atrás. Sin eso, un fallo de
+ * permisos en el tercer fichero dejaría dos revertidos y tres no — un estado
+ * que nadie escribió ni revisó.
+ */
+export function deshacer(agentDir, cwd) {
+    const rutaDiario = rutaDelDiario(agentDir, cwd);
+    const entradas = leerEntradas(rutaDiario);
+    const ultimo = entradas.at(-1)?.turno;
+    if (ultimo === undefined)
+        return { turno: null, restaurados: [], borrados: [], omitidos: [] };
+    const delTurno = entradas.filter((e) => e.turno === ultimo);
+    const aplicables = delTurno.filter((e) => !e.omitido);
+    const omitidos = delTurno.filter((e) => e.omitido).map((e) => e.path);
+    // Foto de seguridad para poder retroceder si algo peta a mitad.
+    const seguro = new Map();
+    for (const e of aplicables) {
+        seguro.set(e.path, existsSync(e.path) ? readFileSync(e.path, "utf8") : null);
+    }
+    const restaurados = [];
+    const borrados = [];
+    try {
+        for (const e of aplicables) {
+            if (e.previo === null) {
+                // El turno creó el fichero: deshacer es borrarlo.
+                if (existsSync(e.path))
+                    unlinkSync(e.path);
+                borrados.push(e.path);
+            }
+            else {
+                mkdirSync(dirname(e.path), { recursive: true });
+                writeFileSync(e.path, e.previo, "utf8");
+                restaurados.push(e.path);
+            }
+        }
+    }
+    catch (error) {
+        for (const [ruta, contenido] of seguro) {
+            try {
+                if (contenido === null) {
+                    if (existsSync(ruta))
+                        unlinkSync(ruta);
+                }
+                else {
+                    writeFileSync(ruta, contenido, "utf8");
+                }
+            }
+            catch {
+                // Poco más se puede hacer; el mensaje de error lo dirá.
+            }
+        }
+        return {
+            turno: ultimo,
+            restaurados: [],
+            borrados: [],
+            omitidos,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    // El turno deshecho sale del diario: deshacer dos veces debe ir al anterior,
+    // no repetir el mismo.
+    const restantes = entradas.filter((e) => e.turno !== ultimo);
+    writeFileSync(rutaDiario, restantes.map((e) => `${JSON.stringify(e)}\n`).join(""), { mode: 0o600 });
+    return { turno: ultimo, restaurados, borrados, omitidos };
+}
+/** Qué haría un `undo` sin llegar a hacerlo. */
+export function previsualizar(agentDir, cwd) {
+    const entradas = leerEntradas(rutaDelDiario(agentDir, cwd));
+    const ultimo = entradas.at(-1)?.turno;
+    return ultimo === undefined ? [] : entradas.filter((e) => e.turno === ultimo);
+}
+//# sourceMappingURL=journal.js.map

package/dist/core/undo/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../../src/core/undo/journal.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Diario para deshacer los cambios de ficheros de un turno.\n *\n * Guarda el estado ANTERIOR de cada fichero justo antes de tocarlo, agrupado\n * por turno. `deshacer()` devuelve todos los ficheros del último turno a la vez,\n * o ninguno: revertir la mitad de un cambio deja el repositorio en un estado que\n * el agente no produjo nunca y que nadie ha revisado.\n *\n * El punto de captura es `withFileMutationQueue`, por donde pasan tanto `edit`\n * como `write`. Engancharse ahí cubre las dos herramientas con un solo sitio, y\n * cualquier herramienta futura que escriba ficheros entra gratis.\n */\n\nimport { createHash } from \"node:crypto\";\nimport { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\n/**\n * Un fichero más grande que esto no se fotografía.\n *\n * Se registra igualmente, marcado, para poder DECIRLO al deshacer. Callarlo\n * sería peor: el usuario creería que revirtió todo cuando faltó un fichero.\n */\nconst MAX_FOTO_BYTES = 4 * 1024 * 1024;\n\nexport interface EntradaDiario {\n\tturno: number;\n\tpath: string;\n\t/** Contenido anterior; `null` si el fichero no existía (lo creó el turno). */\n\tprevio: string | null;\n\t/** `true` si era demasiado grande para fotografiar. */\n\tomitido?: boolean;\n\tts: number;\n}\n\ninterface TurnoActivo {\n\trutaDiario: string;\n\tturno: number;\n\tvistos: Set<string>;\n}\n\n/** El turno abierto ahora mismo. La cola de mutaciones no conoce la sesión. */\nlet activo: TurnoActivo | null = null;\n\nfunction rutaDelDiario(agentDir: string, cwd: string): string {\n\tconst clave = createHash(\"sha256\").update(cwd).digest(\"hex\").slice(0, 16);\n\treturn join(agentDir, \"undo\", `${clave}.jsonl`);\n}\n\n/**\n * Abre un turno nuevo. Todo lo que se escriba a partir de aquí se agrupa junto.\n *\n * El número de turno sale del diario, no de un contador en memoria: si el\n * proceso se reinicia a mitad de sesión, el turno siguiente no puede reutilizar\n * un número y mezclarse con cambios viejos.\n */\nexport function abrirTurno(agentDir: string, cwd: string, ahora: number): number {\n\tconst rutaDiario = rutaDelDiario(agentDir, cwd);\n\tmkdirSync(dirname(rutaDiario), { recursive: true, mode: 0o700 });\n\tconst turno = (leerEntradas(rutaDiario).at(-1)?.turno ?? 0) + 1;\n\tactivo = { rutaDiario, turno, vistos: new Set() };\n\tvoid ahora;\n\treturn turno;\n}\n\nexport function cerrarTurno(): void {\n\tactivo = null;\n}\n\n/**\n * Fotografía un fichero antes de que lo toquen.\n *\n * Solo la PRIMERA vez dentro del turno: si el agente edita el mismo fichero\n * cinco veces, deshacer debe devolverlo a como estaba antes de las cinco, no\n * antes de la última.\n */\nexport function registrarPrevio(rutaFichero: string): void {\n\tif (!activo || activo.vistos.has(rutaFichero)) return;\n\tactivo.vistos.add(rutaFichero);\n\n\tlet entrada: EntradaDiario;\n\ttry {\n\t\tif (!existsSync(rutaFichero)) {\n\t\t\tentrada = { turno: activo.turno, path: rutaFichero, previo: null, ts: Date.now() };\n\t\t} else if (statSync(rutaFichero).size > MAX_FOTO_BYTES) {\n\t\t\tentrada = { turno: activo.turno, path: rutaFichero, previo: null, omitido: true, ts: Date.now() };\n\t\t} else {\n\t\t\tentrada = {\n\t\t\t\tturno: activo.turno,\n\t\t\t\tpath: rutaFichero,\n\t\t\t\tprevio: readFileSync(rutaFichero, \"utf8\"),\n\t\t\t\tts: Date.now(),\n\t\t\t};\n\t\t}\n\t} catch {\n\t\t// Un fichero ilegible no puede impedir la edición; se marca omitido para\n\t\t// que deshacer lo diga en vez de fingir que lo revirtió.\n\t\tentrada = { turno: activo.turno, path: rutaFichero, previo: null, omitido: true, ts: Date.now() };\n\t}\n\ttry {\n\t\tappendFileSync(activo.rutaDiario, `${JSON.stringify(entrada)}\\n`, { mode: 0o600 });\n\t} catch {\n\t\t// El diario es una comodidad, no una garantía: si no se puede escribir,\n\t\t// la edición sigue adelante.\n\t}\n}\n\nfunction leerEntradas(rutaDiario: string): EntradaDiario[] {\n\tif (!existsSync(rutaDiario)) return [];\n\tconst entradas: EntradaDiario[] = [];\n\tfor (const linea of readFileSync(rutaDiario, \"utf8\").split(\"\\n\")) {\n\t\tif (!linea.trim()) continue;\n\t\ttry {\n\t\t\tentradas.push(JSON.parse(linea) as EntradaDiario);\n\t\t} catch {\n\t\t\t// Una línea corrupta no invalida el resto del diario.\n\t\t}\n\t}\n\treturn entradas;\n}\n\nexport interface ResultadoDeshacer {\n\tturno: number | null;\n\trestaurados: string[];\n\tborrados: string[];\n\tomitidos: string[];\n\terror?: string;\n}\n\n/**\n * Deshace el último turno con cambios. Todo o nada.\n *\n * Antes de escribir nada se fotografía el estado actual de cada objetivo; si\n * una escritura falla a mitad, se devuelven todas atrás. Sin eso, un fallo de\n * permisos en el tercer fichero dejaría dos revertidos y tres no — un estado\n * que nadie escribió ni revisó.\n */\nexport function deshacer(agentDir: string, cwd: string): ResultadoDeshacer {\n\tconst rutaDiario = rutaDelDiario(agentDir, cwd);\n\tconst entradas = leerEntradas(rutaDiario);\n\tconst ultimo = entradas.at(-1)?.turno;\n\tif (ultimo === undefined) return { turno: null, restaurados: [], borrados: [], omitidos: [] };\n\n\tconst delTurno = entradas.filter((e) => e.turno === ultimo);\n\tconst aplicables = delTurno.filter((e) => !e.omitido);\n\tconst omitidos = delTurno.filter((e) => e.omitido).map((e) => e.path);\n\n\t// Foto de seguridad para poder retroceder si algo peta a mitad.\n\tconst seguro = new Map<string, string | null>();\n\tfor (const e of aplicables) {\n\t\tseguro.set(e.path, existsSync(e.path) ? readFileSync(e.path, \"utf8\") : null);\n\t}\n\n\tconst restaurados: string[] = [];\n\tconst borrados: string[] = [];\n\ttry {\n\t\tfor (const e of aplicables) {\n\t\t\tif (e.previo === null) {\n\t\t\t\t// El turno creó el fichero: deshacer es borrarlo.\n\t\t\t\tif (existsSync(e.path)) unlinkSync(e.path);\n\t\t\t\tborrados.push(e.path);\n\t\t\t} else {\n\t\t\t\tmkdirSync(dirname(e.path), { recursive: true });\n\t\t\t\twriteFileSync(e.path, e.previo, \"utf8\");\n\t\t\t\trestaurados.push(e.path);\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tfor (const [ruta, contenido] of seguro) {\n\t\t\ttry {\n\t\t\t\tif (contenido === null) {\n\t\t\t\t\tif (existsSync(ruta)) unlinkSync(ruta);\n\t\t\t\t} else {\n\t\t\t\t\twriteFileSync(ruta, contenido, \"utf8\");\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Poco más se puede hacer; el mensaje de error lo dirá.\n\t\t\t}\n\t\t}\n\t\treturn {\n\t\t\tturno: ultimo,\n\t\t\trestaurados: [],\n\t\t\tborrados: [],\n\t\t\tomitidos,\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t};\n\t}\n\n\t// El turno deshecho sale del diario: deshacer dos veces debe ir al anterior,\n\t// no repetir el mismo.\n\tconst restantes = entradas.filter((e) => e.turno !== ultimo);\n\twriteFileSync(rutaDiario, restantes.map((e) => `${JSON.stringify(e)}\\n`).join(\"\"), { mode: 0o600 });\n\n\treturn { turno: ultimo, restaurados, borrados, omitidos };\n}\n\n/** Qué haría un `undo` sin llegar a hacerlo. */\nexport function previsualizar(agentDir: string, cwd: string): EntradaDiario[] {\n\tconst entradas = leerEntradas(rutaDelDiario(agentDir, cwd));\n\tconst ultimo = entradas.at(-1)?.turno;\n\treturn ultimo === undefined ? [] : entradas.filter((e) => e.turno === ultimo);\n}\n"]}

package/dist/core/urls-internas/auditoria.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `audit://<n>` — las últimas `n` entradas del libro de sesión
+ * (`audit/libro.ts`), con el veredicto de la cadena de hashes.
+ *
+ * El veredicto va SIEMPRE, no solo cuando algo falla: "válida" es tan
+ * informativo como "alterada" para quien pregunta qué hizo el agente.
+ */
+import type { LibroDeSesion } from "../audit/libro.ts";
+export declare function leerAuditoria(libro: LibroDeSesion, resto: string): Promise<string>;
+//# sourceMappingURL=auditoria.d.ts.map

package/dist/core/urls-internas/auditoria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditoria.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/auditoria.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAavD,wBAAsB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BxF","sourcesContent":["/**\n * `audit://<n>` — las últimas `n` entradas del libro de sesión\n * (`audit/libro.ts`), con el veredicto de la cadena de hashes.\n *\n * El veredicto va SIEMPRE, no solo cuando algo falla: \"válida\" es tan\n * informativo como \"alterada\" para quien pregunta qué hizo el agente.\n */\n\nimport type { LibroDeSesion } from \"../audit/libro.ts\";\n\nconst LIMITE_DEFECTO = 20;\n\nfunction resumenSuceso(suceso: Record<string, unknown>): string {\n\tconst tipo = String(suceso.tipo ?? \"?\");\n\tconst resto = Object.entries(suceso)\n\t\t.filter(([k]) => k !== \"tipo\")\n\t\t.map(([k, v]) => `${k}=${JSON.stringify(v)}`)\n\t\t.join(\" \");\n\treturn resto ? `${tipo} ${resto}` : tipo;\n}\n\nexport async function leerAuditoria(libro: LibroDeSesion, resto: string): Promise<string> {\n\tconst texto = resto.trim();\n\tlet limite = LIMITE_DEFECTO;\n\tif (texto) {\n\t\tlimite = Number.parseInt(texto, 10);\n\t\tif (!Number.isFinite(limite) || limite <= 0) {\n\t\t\tthrow new Error(`audit://: \"${resto}\" no es un número positivo. Usa audit://<n>, por ejemplo audit://5.`);\n\t\t}\n\t}\n\n\tconst entradas = await libro.leer(limite);\n\tconst veredicto = await libro.verificar();\n\t// El caso «falta un fichero entero» no tiene `alteradaEn`, porque no hay\n\t// ninguna entrada que no cuadre: lo que no cuadra es el inventario. Sin esta\n\t// rama el texto decía «cadena ALTERADA en undefined», que es la peor versión\n\t// de un aviso — grita y no dice qué.\n\tconst cadena = veredicto.faltan?.length\n\t\t? `FALTAN ${veredicto.faltan.length} fichero(s) del libro con ${veredicto.faltan.reduce((n, f) => n + f.entradas, 0)} entrada(s), borrados de sesion/ y recuperados del índice`\n\t\t: veredicto.valido\n\t\t\t? `cadena válida (${veredicto.comprobadas} entrada(s) comprobada(s))`\n\t\t\t: `cadena ALTERADA${veredicto.alteradaEn ? ` en ${veredicto.alteradaEn}` : \"\"} (${veredicto.comprobadas} entrada(s) válidas antes de eso${veredicto.motivo ? `; ${veredicto.motivo}` : \"\"})`;\n\n\tif (entradas.length === 0) return `audit://${resto}: el libro de sesión está vacío. ${cadena}.`;\n\n\tconst lineas = entradas.map((e) => `#${e.seq} ${e.ts} ${resumenSuceso(e.suceso)}`);\n\treturn `${entradas.length} entrada(s) (de más reciente a más antigua), ${cadena}:\\n${lineas.join(\"\\n\")}`;\n}\n"]}

package/dist/core/urls-internas/auditoria.js

@@ -0,0 +1,42 @@
+/**
+ * `audit://<n>` — las últimas `n` entradas del libro de sesión
+ * (`audit/libro.ts`), con el veredicto de la cadena de hashes.
+ *
+ * El veredicto va SIEMPRE, no solo cuando algo falla: "válida" es tan
+ * informativo como "alterada" para quien pregunta qué hizo el agente.
+ */
+const LIMITE_DEFECTO = 20;
+function resumenSuceso(suceso) {
+    const tipo = String(suceso.tipo ?? "?");
+    const resto = Object.entries(suceso)
+        .filter(([k]) => k !== "tipo")
+        .map(([k, v]) => `${k}=${JSON.stringify(v)}`)
+        .join(" ");
+    return resto ? `${tipo} ${resto}` : tipo;
+}
+export async function leerAuditoria(libro, resto) {
+    const texto = resto.trim();
+    let limite = LIMITE_DEFECTO;
+    if (texto) {
+        limite = Number.parseInt(texto, 10);
+        if (!Number.isFinite(limite) || limite <= 0) {
+            throw new Error(`audit://: "${resto}" no es un número positivo. Usa audit://<n>, por ejemplo audit://5.`);
+        }
+    }
+    const entradas = await libro.leer(limite);
+    const veredicto = await libro.verificar();
+    // El caso «falta un fichero entero» no tiene `alteradaEn`, porque no hay
+    // ninguna entrada que no cuadre: lo que no cuadra es el inventario. Sin esta
+    // rama el texto decía «cadena ALTERADA en undefined», que es la peor versión
+    // de un aviso — grita y no dice qué.
+    const cadena = veredicto.faltan?.length
+        ? `FALTAN ${veredicto.faltan.length} fichero(s) del libro con ${veredicto.faltan.reduce((n, f) => n + f.entradas, 0)} entrada(s), borrados de sesion/ y recuperados del índice`
+        : veredicto.valido
+            ? `cadena válida (${veredicto.comprobadas} entrada(s) comprobada(s))`
+            : `cadena ALTERADA${veredicto.alteradaEn ? ` en ${veredicto.alteradaEn}` : ""} (${veredicto.comprobadas} entrada(s) válidas antes de eso${veredicto.motivo ? `; ${veredicto.motivo}` : ""})`;
+    if (entradas.length === 0)
+        return `audit://${resto}: el libro de sesión está vacío. ${cadena}.`;
+    const lineas = entradas.map((e) => `#${e.seq} ${e.ts} ${resumenSuceso(e.suceso)}`);
+    return `${entradas.length} entrada(s) (de más reciente a más antigua), ${cadena}:\n${lineas.join("\n")}`;
+}
+//# sourceMappingURL=auditoria.js.map

package/dist/core/urls-internas/auditoria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditoria.js","sourceRoot":"","sources":["../../../src/core/urls-internas/auditoria.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,SAAS,aAAa,CAAC,MAA+B,EAAU;IAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAAA,CACzC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAoB,EAAE,KAAa,EAAmB;IACzF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,IAAI,KAAK,EAAE,CAAC;QACX,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,sEAAqE,CAAC,CAAC;QAC3G,CAAC;IACF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IAC1C,2EAAyE;IACzE,6EAA6E;IAC7E,iFAA6E;IAC7E,wCAAqC;IACrC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM;QACtC,CAAC,CAAC,UAAU,SAAS,CAAC,MAAM,CAAC,MAAM,6BAA6B,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,4DAA2D;QAC/K,CAAC,CAAC,SAAS,CAAC,MAAM;YACjB,CAAC,CAAC,mBAAkB,SAAS,CAAC,WAAW,4BAA4B;YACrE,CAAC,CAAC,kBAAkB,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,WAAW,oCAAmC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IAE/L,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,KAAK,uCAAoC,MAAM,GAAG,CAAC;IAEhG,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnF,OAAO,GAAG,QAAQ,CAAC,MAAM,kDAAgD,MAAM,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAAA,CACzG","sourcesContent":["/**\n * `audit://<n>` — las últimas `n` entradas del libro de sesión\n * (`audit/libro.ts`), con el veredicto de la cadena de hashes.\n *\n * El veredicto va SIEMPRE, no solo cuando algo falla: \"válida\" es tan\n * informativo como \"alterada\" para quien pregunta qué hizo el agente.\n */\n\nimport type { LibroDeSesion } from \"../audit/libro.ts\";\n\nconst LIMITE_DEFECTO = 20;\n\nfunction resumenSuceso(suceso: Record<string, unknown>): string {\n\tconst tipo = String(suceso.tipo ?? \"?\");\n\tconst resto = Object.entries(suceso)\n\t\t.filter(([k]) => k !== \"tipo\")\n\t\t.map(([k, v]) => `${k}=${JSON.stringify(v)}`)\n\t\t.join(\" \");\n\treturn resto ? `${tipo} ${resto}` : tipo;\n}\n\nexport async function leerAuditoria(libro: LibroDeSesion, resto: string): Promise<string> {\n\tconst texto = resto.trim();\n\tlet limite = LIMITE_DEFECTO;\n\tif (texto) {\n\t\tlimite = Number.parseInt(texto, 10);\n\t\tif (!Number.isFinite(limite) || limite <= 0) {\n\t\t\tthrow new Error(`audit://: \"${resto}\" no es un número positivo. Usa audit://<n>, por ejemplo audit://5.`);\n\t\t}\n\t}\n\n\tconst entradas = await libro.leer(limite);\n\tconst veredicto = await libro.verificar();\n\t// El caso «falta un fichero entero» no tiene `alteradaEn`, porque no hay\n\t// ninguna entrada que no cuadre: lo que no cuadra es el inventario. Sin esta\n\t// rama el texto decía «cadena ALTERADA en undefined», que es la peor versión\n\t// de un aviso — grita y no dice qué.\n\tconst cadena = veredicto.faltan?.length\n\t\t? `FALTAN ${veredicto.faltan.length} fichero(s) del libro con ${veredicto.faltan.reduce((n, f) => n + f.entradas, 0)} entrada(s), borrados de sesion/ y recuperados del índice`\n\t\t: veredicto.valido\n\t\t\t? `cadena válida (${veredicto.comprobadas} entrada(s) comprobada(s))`\n\t\t\t: `cadena ALTERADA${veredicto.alteradaEn ? ` en ${veredicto.alteradaEn}` : \"\"} (${veredicto.comprobadas} entrada(s) válidas antes de eso${veredicto.motivo ? `; ${veredicto.motivo}` : \"\"})`;\n\n\tif (entradas.length === 0) return `audit://${resto}: el libro de sesión está vacío. ${cadena}.`;\n\n\tconst lineas = entradas.map((e) => `#${e.seq} ${e.ts} ${resumenSuceso(e.suceso)}`);\n\treturn `${entradas.length} entrada(s) (de más reciente a más antigua), ${cadena}:\\n${lineas.join(\"\\n\")}`;\n}\n"]}

package/dist/core/urls-internas/boveda.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `vault://<nombre>` — lista los NOMBRES del vault y su clasificación.
+ *
+ * Nunca el valor. La política de aprobación (`aprobacion/politica.ts`,
+ * `rutaProtegida`) deniega a propósito leer `<agentDir>/vault/…` incluso en
+ * modo `yolo` — es la única ruta que no es configurable. Este esquema no
+ * puede ser la puerta trasera que deshaga esa decisión, así que ni siquiera
+ * llama a `VaultManager.getSecret()`: solo a `.list()`, que por construcción
+ * no puede devolver un valor porque `VaultListEntry` no tiene ese campo.
+ */
+import type { VaultManager } from "../memory-engine/vault.ts";
+export declare function leerBoveda(vault: VaultManager | null, nombre: string): string;
+//# sourceMappingURL=boveda.d.ts.map

package/dist/core/urls-internas/boveda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boveda.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/boveda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAO9E,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAwB7E","sourcesContent":["/**\n * `vault://<nombre>` — lista los NOMBRES del vault y su clasificación.\n *\n * Nunca el valor. La política de aprobación (`aprobacion/politica.ts`,\n * `rutaProtegida`) deniega a propósito leer `<agentDir>/vault/…` incluso en\n * modo `yolo` — es la única ruta que no es configurable. Este esquema no\n * puede ser la puerta trasera que deshaga esa decisión, así que ni siquiera\n * llama a `VaultManager.getSecret()`: solo a `.list()`, que por construcción\n * no puede devolver un valor porque `VaultListEntry` no tiene ese campo.\n */\n\nimport type { VaultListEntry, VaultManager } from \"../memory-engine/vault.ts\";\n\nfunction formatoEntrada(e: VaultListEntry): string {\n\tconst categoria = e.category ?? \"sin categoría\";\n\treturn `- ${e.name} [${categoria}] (${e.source})${e.note ? ` — ${e.note}` : \"\"}`;\n}\n\nexport function leerBoveda(vault: VaultManager | null, nombre: string): string {\n\tif (!vault) throw new Error(\"vault://: no hay vault configurado en esta sesión.\");\n\tconst objetivo = nombre.trim();\n\tconst entradas = vault.list();\n\n\t// TRES estados, no dos.\n\t//\n\t// `VaultManager.list()` devuelve `[]` tanto cuando el vault está VACÍO como\n\t// cuando está BLOQUEADO —`projectVault` es `null` hasta que alguien lo\n\t// desbloquea—, así que un usuario con doce secretos guardados leía «no hay\n\t// secretos guardados». Es «no puedo» disfrazado de «no hay», y en la ruta de\n\t// seguridad: le empujaría a volver a guardarlos o a dar el vault por roto.\n\tif (entradas.length === 0 && vault.exists() && !vault.isUnlocked) {\n\t\treturn \"vault://: el vault de este proyecto existe pero está BLOQUEADO. No es que no haya secretos: no se han podido leer. Desbloquéalo para listarlos.\";\n\t}\n\n\tif (!objetivo) {\n\t\tif (entradas.length === 0) return \"vault://: no hay secretos guardados en este proyecto.\";\n\t\treturn `${entradas.length} secreto(s) en el vault (solo nombre y clasificación, nunca el valor):\\n${entradas.map(formatoEntrada).join(\"\\n\")}`;\n\t}\n\n\tconst encontrada = entradas.find((e) => e.name === objetivo);\n\tif (!encontrada) return `vault://${objetivo}: no existe una entrada con ese nombre.`;\n\treturn `${formatoEntrada(encontrada)}\\n(el valor no se expone por esta vía: la política de aprobación deniega leer el vault)`;\n}\n"]}

package/dist/core/urls-internas/boveda.js

@@ -0,0 +1,40 @@
+/**
+ * `vault://<nombre>` — lista los NOMBRES del vault y su clasificación.
+ *
+ * Nunca el valor. La política de aprobación (`aprobacion/politica.ts`,
+ * `rutaProtegida`) deniega a propósito leer `<agentDir>/vault/…` incluso en
+ * modo `yolo` — es la única ruta que no es configurable. Este esquema no
+ * puede ser la puerta trasera que deshaga esa decisión, así que ni siquiera
+ * llama a `VaultManager.getSecret()`: solo a `.list()`, que por construcción
+ * no puede devolver un valor porque `VaultListEntry` no tiene ese campo.
+ */
+function formatoEntrada(e) {
+    const categoria = e.category ?? "sin categoría";
+    return `- ${e.name} [${categoria}] (${e.source})${e.note ? ` — ${e.note}` : ""}`;
+}
+export function leerBoveda(vault, nombre) {
+    if (!vault)
+        throw new Error("vault://: no hay vault configurado en esta sesión.");
+    const objetivo = nombre.trim();
+    const entradas = vault.list();
+    // TRES estados, no dos.
+    //
+    // `VaultManager.list()` devuelve `[]` tanto cuando el vault está VACÍO como
+    // cuando está BLOQUEADO —`projectVault` es `null` hasta que alguien lo
+    // desbloquea—, así que un usuario con doce secretos guardados leía «no hay
+    // secretos guardados». Es «no puedo» disfrazado de «no hay», y en la ruta de
+    // seguridad: le empujaría a volver a guardarlos o a dar el vault por roto.
+    if (entradas.length === 0 && vault.exists() && !vault.isUnlocked) {
+        return "vault://: el vault de este proyecto existe pero está BLOQUEADO. No es que no haya secretos: no se han podido leer. Desbloquéalo para listarlos.";
+    }
+    if (!objetivo) {
+        if (entradas.length === 0)
+            return "vault://: no hay secretos guardados en este proyecto.";
+        return `${entradas.length} secreto(s) en el vault (solo nombre y clasificación, nunca el valor):\n${entradas.map(formatoEntrada).join("\n")}`;
+    }
+    const encontrada = entradas.find((e) => e.name === objetivo);
+    if (!encontrada)
+        return `vault://${objetivo}: no existe una entrada con ese nombre.`;
+    return `${formatoEntrada(encontrada)}\n(el valor no se expone por esta vía: la política de aprobación deniega leer el vault)`;
+}
+//# sourceMappingURL=boveda.js.map

package/dist/core/urls-internas/boveda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boveda.js","sourceRoot":"","sources":["../../../src/core/urls-internas/boveda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,SAAS,cAAc,CAAC,CAAiB,EAAU;IAClD,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,IAAI,gBAAe,CAAC;IAChD,OAAO,KAAK,CAAC,CAAC,IAAI,KAAK,SAAS,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAAA,CACjF;AAED,MAAM,UAAU,UAAU,CAAC,KAA0B,EAAE,MAAc,EAAU;IAC9E,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAoD,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE9B,wBAAwB;IACxB,EAAE;IACF,8EAA4E;IAC5E,0EAAuE;IACvE,gFAA2E;IAC3E,kFAA6E;IAC7E,4EAA2E;IAC3E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAClE,OAAO,mJAAiJ,CAAC;IAC1J,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,uDAAuD,CAAC;QAC1F,OAAO,GAAG,QAAQ,CAAC,MAAM,4EAA2E,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/I,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU;QAAE,OAAO,WAAW,QAAQ,yCAAyC,CAAC;IACrF,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,4FAAyF,CAAC;AAAA,CAC9H","sourcesContent":["/**\n * `vault://<nombre>` — lista los NOMBRES del vault y su clasificación.\n *\n * Nunca el valor. La política de aprobación (`aprobacion/politica.ts`,\n * `rutaProtegida`) deniega a propósito leer `<agentDir>/vault/…` incluso en\n * modo `yolo` — es la única ruta que no es configurable. Este esquema no\n * puede ser la puerta trasera que deshaga esa decisión, así que ni siquiera\n * llama a `VaultManager.getSecret()`: solo a `.list()`, que por construcción\n * no puede devolver un valor porque `VaultListEntry` no tiene ese campo.\n */\n\nimport type { VaultListEntry, VaultManager } from \"../memory-engine/vault.ts\";\n\nfunction formatoEntrada(e: VaultListEntry): string {\n\tconst categoria = e.category ?? \"sin categoría\";\n\treturn `- ${e.name} [${categoria}] (${e.source})${e.note ? ` — ${e.note}` : \"\"}`;\n}\n\nexport function leerBoveda(vault: VaultManager | null, nombre: string): string {\n\tif (!vault) throw new Error(\"vault://: no hay vault configurado en esta sesión.\");\n\tconst objetivo = nombre.trim();\n\tconst entradas = vault.list();\n\n\t// TRES estados, no dos.\n\t//\n\t// `VaultManager.list()` devuelve `[]` tanto cuando el vault está VACÍO como\n\t// cuando está BLOQUEADO —`projectVault` es `null` hasta que alguien lo\n\t// desbloquea—, así que un usuario con doce secretos guardados leía «no hay\n\t// secretos guardados». Es «no puedo» disfrazado de «no hay», y en la ruta de\n\t// seguridad: le empujaría a volver a guardarlos o a dar el vault por roto.\n\tif (entradas.length === 0 && vault.exists() && !vault.isUnlocked) {\n\t\treturn \"vault://: el vault de este proyecto existe pero está BLOQUEADO. No es que no haya secretos: no se han podido leer. Desbloquéalo para listarlos.\";\n\t}\n\n\tif (!objetivo) {\n\t\tif (entradas.length === 0) return \"vault://: no hay secretos guardados en este proyecto.\";\n\t\treturn `${entradas.length} secreto(s) en el vault (solo nombre y clasificación, nunca el valor):\\n${entradas.map(formatoEntrada).join(\"\\n\")}`;\n\t}\n\n\tconst encontrada = entradas.find((e) => e.name === objetivo);\n\tif (!encontrada) return `vault://${objetivo}: no existe una entrada con ese nombre.`;\n\treturn `${formatoEntrada(encontrada)}\\n(el valor no se expone por esta vía: la política de aprobación deniega leer el vault)`;\n}\n"]}

package/dist/core/urls-internas/lector.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Engancha las cuatro URLs internas (`memory://`, `vault://`, `rule://`,
+ * `audit://`) en la tool `read`, SIN tocar `core/tools/read.ts`.
+ *
+ * `read.ts` es de upstream y el presupuesto de sincronización ya está al
+ * tope (115/115, ver `scripts/sync-ada.sh --check`): un hunk más ahí hace
+ * fallar la construcción. La tool en sí ya expone el hueco que hace falta —
+ * es un `ToolDefinition` normal, y `agent-session.ts` construye el registro
+ * de tools con `Map<string, ToolDefinition>` donde el nombre gana por
+ * inserción — así que envolver la definición y reemplazarla con
+ * `_baseToolDefinitions.set("read", …)` no es un rodeo, es como Ada ya
+ * registra `memory_*`, `web_*` y el resto de sus capacidades en ese mismo
+ * método.
+ *
+ * Delega TODO lo que no sea una URL interna al `read` original: rutas de
+ * fichero, imágenes, `offset`/`limit`… nada de eso cambia.
+ */
+import type { LibroDeSesion } from "../audit/libro.ts";
+import type { ToolDefinition } from "../extensions/types.ts";
+import type { MemoryEngine } from "../memory-engine/engine.ts";
+import type { VaultManager } from "../memory-engine/vault.ts";
+export interface DependenciasUrlsInternas {
+    memoryEngine: MemoryEngine | null;
+    vaultManager: VaultManager | null;
+    cwd: string;
+    /** Perezoso porque el libro también lo es (ver `RegistroDeSesion.libro()`). */
+    libro: () => LibroDeSesion;
+}
+export declare function envolverReadConUrlsInternas(base: ToolDefinition, deps: DependenciasUrlsInternas): ToolDefinition;
+//# sourceMappingURL=lector.d.ts.map

package/dist/core/urls-internas/lector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lector.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/lector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAO9D,MAAM,WAAW,wBAAwB;IACxC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,gFAA+E;IAC/E,KAAK,EAAE,MAAM,aAAa,CAAC;CAC3B;AAoBD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,wBAAwB,GAAG,cAAc,CAchH","sourcesContent":["/**\n * Engancha las cuatro URLs internas (`memory://`, `vault://`, `rule://`,\n * `audit://`) en la tool `read`, SIN tocar `core/tools/read.ts`.\n *\n * `read.ts` es de upstream y el presupuesto de sincronización ya está al\n * tope (115/115, ver `scripts/sync-ada.sh --check`): un hunk más ahí hace\n * fallar la construcción. La tool en sí ya expone el hueco que hace falta —\n * es un `ToolDefinition` normal, y `agent-session.ts` construye el registro\n * de tools con `Map<string, ToolDefinition>` donde el nombre gana por\n * inserción — así que envolver la definición y reemplazarla con\n * `_baseToolDefinitions.set(\"read\", …)` no es un rodeo, es como Ada ya\n * registra `memory_*`, `web_*` y el resto de sus capacidades en ese mismo\n * método.\n *\n * Delega TODO lo que no sea una URL interna al `read` original: rutas de\n * fichero, imágenes, `offset`/`limit`… nada de eso cambia.\n */\n\nimport type { LibroDeSesion } from \"../audit/libro.ts\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport type { MemoryEngine } from \"../memory-engine/engine.ts\";\nimport type { VaultManager } from \"../memory-engine/vault.ts\";\nimport { leerAuditoria } from \"./auditoria.ts\";\nimport { leerBoveda } from \"./boveda.ts\";\nimport { leerMemoria } from \"./memoria.ts\";\nimport { errorEsquemaDesconocido, esEsquemaConocido, parseaUrlInterna } from \"./parse.ts\";\nimport { leerReglas } from \"./reglas.ts\";\n\nexport interface DependenciasUrlsInternas {\n\tmemoryEngine: MemoryEngine | null;\n\tvaultManager: VaultManager | null;\n\tcwd: string;\n\t/** Perezoso porque el libro también lo es (ver `RegistroDeSesion.libro()`). */\n\tlibro: () => LibroDeSesion;\n}\n\nasync function resuelveUrlInterna(esquema: string, resto: string, deps: DependenciasUrlsInternas): Promise<string> {\n\tswitch (esquema) {\n\t\tcase \"memory\":\n\t\t\treturn leerMemoria(deps.memoryEngine, resto);\n\t\tcase \"vault\":\n\t\t\treturn leerBoveda(deps.vaultManager, resto);\n\t\tcase \"rule\":\n\t\t\treturn leerReglas(deps.cwd, resto);\n\t\tcase \"audit\":\n\t\t\treturn leerAuditoria(deps.libro(), resto);\n\t\tdefault:\n\t\t\t// Inalcanzable si `esEsquemaConocido` ya filtró, pero deja el fallo\n\t\t\t// hablando en vez de romper con un `undefined` silencioso si alguien\n\t\t\t// añade un esquema a la lista y olvida este switch.\n\t\t\tthrow errorEsquemaDesconocido(esquema);\n\t}\n}\n\nexport function envolverReadConUrlsInternas(base: ToolDefinition, deps: DependenciasUrlsInternas): ToolDefinition {\n\treturn {\n\t\t...base,\n\t\tdescription: `${base.description} Además de rutas de fichero, acepta URLs internas: memory://<consulta>, vault://<nombre> (solo nombre y clasificación, nunca el valor), rule://<origen>, audit://<n>.`,\n\t\tasync execute(toolCallId, params, signal, onUpdate, ctx): Promise<AgentToolResult<unknown>> {\n\t\t\tconst ruta = (params as { path?: unknown }).path;\n\t\t\tconst url = typeof ruta === \"string\" ? parseaUrlInterna(ruta) : null;\n\t\t\tif (!url) return base.execute(toolCallId, params, signal, onUpdate, ctx);\n\n\t\t\tif (!esEsquemaConocido(url.esquema)) throw errorEsquemaDesconocido(url.esquema);\n\t\t\tconst texto = await resuelveUrlInterna(url.esquema, url.resto, deps);\n\t\t\treturn { content: [{ type: \"text\", text: texto }], details: undefined };\n\t\t},\n\t};\n}\n"]}

package/dist/core/urls-internas/lector.js

@@ -0,0 +1,56 @@
+/**
+ * Engancha las cuatro URLs internas (`memory://`, `vault://`, `rule://`,
+ * `audit://`) en la tool `read`, SIN tocar `core/tools/read.ts`.
+ *
+ * `read.ts` es de upstream y el presupuesto de sincronización ya está al
+ * tope (115/115, ver `scripts/sync-ada.sh --check`): un hunk más ahí hace
+ * fallar la construcción. La tool en sí ya expone el hueco que hace falta —
+ * es un `ToolDefinition` normal, y `agent-session.ts` construye el registro
+ * de tools con `Map<string, ToolDefinition>` donde el nombre gana por
+ * inserción — así que envolver la definición y reemplazarla con
+ * `_baseToolDefinitions.set("read", …)` no es un rodeo, es como Ada ya
+ * registra `memory_*`, `web_*` y el resto de sus capacidades en ese mismo
+ * método.
+ *
+ * Delega TODO lo que no sea una URL interna al `read` original: rutas de
+ * fichero, imágenes, `offset`/`limit`… nada de eso cambia.
+ */
+import { leerAuditoria } from "./auditoria.js";
+import { leerBoveda } from "./boveda.js";
+import { leerMemoria } from "./memoria.js";
+import { errorEsquemaDesconocido, esEsquemaConocido, parseaUrlInterna } from "./parse.js";
+import { leerReglas } from "./reglas.js";
+async function resuelveUrlInterna(esquema, resto, deps) {
+    switch (esquema) {
+        case "memory":
+            return leerMemoria(deps.memoryEngine, resto);
+        case "vault":
+            return leerBoveda(deps.vaultManager, resto);
+        case "rule":
+            return leerReglas(deps.cwd, resto);
+        case "audit":
+            return leerAuditoria(deps.libro(), resto);
+        default:
+            // Inalcanzable si `esEsquemaConocido` ya filtró, pero deja el fallo
+            // hablando en vez de romper con un `undefined` silencioso si alguien
+            // añade un esquema a la lista y olvida este switch.
+            throw errorEsquemaDesconocido(esquema);
+    }
+}
+export function envolverReadConUrlsInternas(base, deps) {
+    return {
+        ...base,
+        description: `${base.description} Además de rutas de fichero, acepta URLs internas: memory://<consulta>, vault://<nombre> (solo nombre y clasificación, nunca el valor), rule://<origen>, audit://<n>.`,
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            const ruta = params.path;
+            const url = typeof ruta === "string" ? parseaUrlInterna(ruta) : null;
+            if (!url)
+                return base.execute(toolCallId, params, signal, onUpdate, ctx);
+            if (!esEsquemaConocido(url.esquema))
+                throw errorEsquemaDesconocido(url.esquema);
+            const texto = await resuelveUrlInterna(url.esquema, url.resto, deps);
+            return { content: [{ type: "text", text: texto }], details: undefined };
+        },
+    };
+}
+//# sourceMappingURL=lector.js.map

package/dist/core/urls-internas/lector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lector.js","sourceRoot":"","sources":["../../../src/core/urls-internas/lector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,KAAK,UAAU,kBAAkB,CAAC,OAAe,EAAE,KAAa,EAAE,IAA8B,EAAmB;IAClH,QAAQ,OAAO,EAAE,CAAC;QACjB,KAAK,QAAQ;YACZ,OAAO,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC9C,KAAK,OAAO;YACX,OAAO,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC7C,KAAK,MAAM;YACV,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,KAAK,OAAO;YACX,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3C;YACC,qEAAoE;YACpE,qEAAqE;YACrE,qDAAoD;YACpD,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;AAAA,CACD;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAoB,EAAE,IAA8B,EAAkB;IACjH,OAAO;QACN,GAAG,IAAI;QACP,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,yKAAuK;QACvM,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAqC;YAC3F,MAAM,IAAI,GAAI,MAA6B,CAAC,IAAI,CAAC;YACjD,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACrE,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YAEzE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,MAAM,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAChF,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAAA,CACxE;KACD,CAAC;AAAA,CACF","sourcesContent":["/**\n * Engancha las cuatro URLs internas (`memory://`, `vault://`, `rule://`,\n * `audit://`) en la tool `read`, SIN tocar `core/tools/read.ts`.\n *\n * `read.ts` es de upstream y el presupuesto de sincronización ya está al\n * tope (115/115, ver `scripts/sync-ada.sh --check`): un hunk más ahí hace\n * fallar la construcción. La tool en sí ya expone el hueco que hace falta —\n * es un `ToolDefinition` normal, y `agent-session.ts` construye el registro\n * de tools con `Map<string, ToolDefinition>` donde el nombre gana por\n * inserción — así que envolver la definición y reemplazarla con\n * `_baseToolDefinitions.set(\"read\", …)` no es un rodeo, es como Ada ya\n * registra `memory_*`, `web_*` y el resto de sus capacidades en ese mismo\n * método.\n *\n * Delega TODO lo que no sea una URL interna al `read` original: rutas de\n * fichero, imágenes, `offset`/`limit`… nada de eso cambia.\n */\n\nimport type { LibroDeSesion } from \"../audit/libro.ts\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport type { MemoryEngine } from \"../memory-engine/engine.ts\";\nimport type { VaultManager } from \"../memory-engine/vault.ts\";\nimport { leerAuditoria } from \"./auditoria.ts\";\nimport { leerBoveda } from \"./boveda.ts\";\nimport { leerMemoria } from \"./memoria.ts\";\nimport { errorEsquemaDesconocido, esEsquemaConocido, parseaUrlInterna } from \"./parse.ts\";\nimport { leerReglas } from \"./reglas.ts\";\n\nexport interface DependenciasUrlsInternas {\n\tmemoryEngine: MemoryEngine | null;\n\tvaultManager: VaultManager | null;\n\tcwd: string;\n\t/** Perezoso porque el libro también lo es (ver `RegistroDeSesion.libro()`). */\n\tlibro: () => LibroDeSesion;\n}\n\nasync function resuelveUrlInterna(esquema: string, resto: string, deps: DependenciasUrlsInternas): Promise<string> {\n\tswitch (esquema) {\n\t\tcase \"memory\":\n\t\t\treturn leerMemoria(deps.memoryEngine, resto);\n\t\tcase \"vault\":\n\t\t\treturn leerBoveda(deps.vaultManager, resto);\n\t\tcase \"rule\":\n\t\t\treturn leerReglas(deps.cwd, resto);\n\t\tcase \"audit\":\n\t\t\treturn leerAuditoria(deps.libro(), resto);\n\t\tdefault:\n\t\t\t// Inalcanzable si `esEsquemaConocido` ya filtró, pero deja el fallo\n\t\t\t// hablando en vez de romper con un `undefined` silencioso si alguien\n\t\t\t// añade un esquema a la lista y olvida este switch.\n\t\t\tthrow errorEsquemaDesconocido(esquema);\n\t}\n}\n\nexport function envolverReadConUrlsInternas(base: ToolDefinition, deps: DependenciasUrlsInternas): ToolDefinition {\n\treturn {\n\t\t...base,\n\t\tdescription: `${base.description} Además de rutas de fichero, acepta URLs internas: memory://<consulta>, vault://<nombre> (solo nombre y clasificación, nunca el valor), rule://<origen>, audit://<n>.`,\n\t\tasync execute(toolCallId, params, signal, onUpdate, ctx): Promise<AgentToolResult<unknown>> {\n\t\t\tconst ruta = (params as { path?: unknown }).path;\n\t\t\tconst url = typeof ruta === \"string\" ? parseaUrlInterna(ruta) : null;\n\t\t\tif (!url) return base.execute(toolCallId, params, signal, onUpdate, ctx);\n\n\t\t\tif (!esEsquemaConocido(url.esquema)) throw errorEsquemaDesconocido(url.esquema);\n\t\t\tconst texto = await resuelveUrlInterna(url.esquema, url.resto, deps);\n\t\t\treturn { content: [{ type: \"text\", text: texto }], details: undefined };\n\t\t},\n\t};\n}\n"]}

package/dist/core/urls-internas/memoria.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `memory://<consulta>` — busca en el motor de memoria (`memory-engine/engine.ts`).
+ *
+ * No es un tool nuevo: es el mismo `searchMemories` que ya usa `memory_search`
+ * en `memory-engine/tools.ts`, con el mismo formato de salida. Reutilizarlo en
+ * vez de reimplementar la búsqueda es justo el punto del hueco — un `read` en
+ * vez de veinte tools.
+ */
+import type { MemoryEngine } from "../memory-engine/engine.ts";
+export declare function leerMemoria(engine: MemoryEngine | null, consulta: string): string;
+//# sourceMappingURL=memoria.d.ts.map

package/dist/core/urls-internas/memoria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoria.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/memoria.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAajF","sourcesContent":["/**\n * `memory://<consulta>` — busca en el motor de memoria (`memory-engine/engine.ts`).\n *\n * No es un tool nuevo: es el mismo `searchMemories` que ya usa `memory_search`\n * en `memory-engine/tools.ts`, con el mismo formato de salida. Reutilizarlo en\n * vez de reimplementar la búsqueda es justo el punto del hueco — un `read` en\n * vez de veinte tools.\n */\n\nimport type { MemoryEngine } from \"../memory-engine/engine.ts\";\n\nconst LIMITE = 10;\n\nexport function leerMemoria(engine: MemoryEngine | null, consulta: string): string {\n\tif (!engine) throw new Error(\"memory://: el motor de memoria no está disponible en esta sesión.\");\n\tconst texto = consulta.trim();\n\tif (!texto) throw new Error(\"memory://: falta la consulta. Usa memory://<lo que buscas>.\");\n\n\tconst hits = engine.searchMemories({ text: texto, limit: LIMITE });\n\tif (hits.length === 0) return `memory://${consulta}: sin resultados.`;\n\n\tconst lineas = hits.map((hit, i) => {\n\t\tconst alcance = hit.observation.project ? \"project\" : \"global/user\";\n\t\treturn `${i + 1}. [${hit.observation.type} · ${alcance}] ${hit.observation.text}`;\n\t});\n\treturn `${hits.length} resultado(s) para memory://${consulta}:\\n${lineas.join(\"\\n\")}`;\n}\n"]}

package/dist/core/urls-internas/memoria.js

@@ -0,0 +1,25 @@
+/**
+ * `memory://<consulta>` — busca en el motor de memoria (`memory-engine/engine.ts`).
+ *
+ * No es un tool nuevo: es el mismo `searchMemories` que ya usa `memory_search`
+ * en `memory-engine/tools.ts`, con el mismo formato de salida. Reutilizarlo en
+ * vez de reimplementar la búsqueda es justo el punto del hueco — un `read` en
+ * vez de veinte tools.
+ */
+const LIMITE = 10;
+export function leerMemoria(engine, consulta) {
+    if (!engine)
+        throw new Error("memory://: el motor de memoria no está disponible en esta sesión.");
+    const texto = consulta.trim();
+    if (!texto)
+        throw new Error("memory://: falta la consulta. Usa memory://<lo que buscas>.");
+    const hits = engine.searchMemories({ text: texto, limit: LIMITE });
+    if (hits.length === 0)
+        return `memory://${consulta}: sin resultados.`;
+    const lineas = hits.map((hit, i) => {
+        const alcance = hit.observation.project ? "project" : "global/user";
+        return `${i + 1}. [${hit.observation.type} · ${alcance}] ${hit.observation.text}`;
+    });
+    return `${hits.length} resultado(s) para memory://${consulta}:\n${lineas.join("\n")}`;
+}
+//# sourceMappingURL=memoria.js.map

package/dist/core/urls-internas/memoria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoria.js","sourceRoot":"","sources":["../../../src/core/urls-internas/memoria.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,GAAG,EAAE,CAAC;AAElB,MAAM,UAAU,WAAW,CAAC,MAA2B,EAAE,QAAgB,EAAU;IAClF,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAmE,CAAC,CAAC;IAClG,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAE3F,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,QAAQ,mBAAmB,CAAC;IAEtE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;QACpE,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,WAAW,CAAC,IAAI,OAAM,OAAO,KAAK,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAAA,CAClF,CAAC,CAAC;IACH,OAAO,GAAG,IAAI,CAAC,MAAM,+BAA+B,QAAQ,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAAA,CACtF","sourcesContent":["/**\n * `memory://<consulta>` — busca en el motor de memoria (`memory-engine/engine.ts`).\n *\n * No es un tool nuevo: es el mismo `searchMemories` que ya usa `memory_search`\n * en `memory-engine/tools.ts`, con el mismo formato de salida. Reutilizarlo en\n * vez de reimplementar la búsqueda es justo el punto del hueco — un `read` en\n * vez de veinte tools.\n */\n\nimport type { MemoryEngine } from \"../memory-engine/engine.ts\";\n\nconst LIMITE = 10;\n\nexport function leerMemoria(engine: MemoryEngine | null, consulta: string): string {\n\tif (!engine) throw new Error(\"memory://: el motor de memoria no está disponible en esta sesión.\");\n\tconst texto = consulta.trim();\n\tif (!texto) throw new Error(\"memory://: falta la consulta. Usa memory://<lo que buscas>.\");\n\n\tconst hits = engine.searchMemories({ text: texto, limit: LIMITE });\n\tif (hits.length === 0) return `memory://${consulta}: sin resultados.`;\n\n\tconst lineas = hits.map((hit, i) => {\n\t\tconst alcance = hit.observation.project ? \"project\" : \"global/user\";\n\t\treturn `${i + 1}. [${hit.observation.type} · ${alcance}] ${hit.observation.text}`;\n\t});\n\treturn `${hits.length} resultado(s) para memory://${consulta}:\\n${lineas.join(\"\\n\")}`;\n}\n"]}