@hoilab/ada-cli 0.84.21 → 0.85.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../../src/core/undo/journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAkBvC,gFAA+E;AAC/E,IAAI,MAAM,GAAuB,IAAI,CAAC;AAEtC,SAAS,aAAa,CAAC,QAAgB,EAAE,GAAW,EAAU;IAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC;AAAA,CAChD;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,GAAW,EAAE,KAAa,EAAU;IAChF,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAChE,MAAM,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAClD,KAAK,KAAK,CAAC;IACX,OAAO,KAAK,CAAC;AAAA,CACb;AAED,MAAM,UAAU,WAAW,GAAS;IACnC,MAAM,GAAG,IAAI,CAAC;AAAA,CACd;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAQ;IAC1D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO;IACtD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE/B,IAAI,OAAsB,CAAC;IAC3B,IAAI,CAAC;QACJ,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9B,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACpF,CAAC;aAAM,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,GAAG,cAAc,EAAE,CAAC;YACxD,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnG,CAAC;aAAM,CAAC;YACP,OAAO,GAAG;gBACT,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC;gBACzC,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;aACd,CAAC;QACH,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,0EAAyE;QACzE,0DAAyD;QACzD,OAAO,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACnG,CAAC;IACD,IAAI,CAAC;QACJ,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACR,yEAAwE;QACxE,8BAA6B;IAC9B,CAAC;AAAA,CACD;AAED,SAAS,YAAY,CAAC,UAAkB,EAAmB;IAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,SAAS;QAC5B,IAAI,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAkB,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACR,uDAAsD;QACvD,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC;AAAA,CAChB;AAUD;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,GAAW,EAAqB;IAC1E,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAE9F,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEtE,gEAAgE;IAChE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC;QACJ,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACvB,mDAAkD;gBAClD,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;oBAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC3C,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACP,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChD,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACxC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACF,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,EAAE,CAAC;YACxC,IAAI,CAAC;gBACJ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;oBACxB,IAAI,UAAU,CAAC,IAAI,CAAC;wBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;gBACxC,CAAC;qBAAM,CAAC;oBACP,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBACxC,CAAC;YACF,CAAC;YAAC,MAAM,CAAC;gBACR,0DAAwD;YACzD,CAAC;QACF,CAAC;QACD,OAAO;YACN,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,EAAE;YACZ,QAAQ;YACR,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC7D,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,uBAAuB;IACvB,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IAC7D,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEpG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAAA,CAC1D;AAED,kDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,GAAW,EAAmB;IAC7E,MAAM,QAAQ,GAAG,YAAY,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IACtC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;AAAA,CAC9E","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"]}

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

@@ -0,0 +1,28 @@
+/**
+ * Parseo de URLs internas: `esquema://resto`.
+ *
+ * oh-my-pi (el competidor, ver `/Users/31017423z/auditoria-omp/oh-my-pi`)
+ * tiene veinte esquemas y un parser que reconstruye `URL` a mano para
+ * aguantar dos puntos dentro del host (`skill://plugin:name`). Nosotros no
+ * tenemos esa forma — nuestro "resto" es una consulta, un nombre o un número,
+ * nunca un host con puerto — así que un regex basta y no hace falta
+ * replicar esa máquina.
+ *
+ * La frontera es literal: cualquier texto con forma `algo://algo` entra en
+ * este espacio de nombres y YA NO se intenta como ruta de fichero. Una ruta
+ * real de disco no lleva `://`, así que no hay colisión que resolver.
+ */
+/** Los únicos cuatro esquemas que existen hoy. Cualquier otro es un error con lista. */
+export declare const ESQUEMAS_INTERNOS: readonly ["memory", "vault", "rule", "audit"];
+export type EsquemaInterno = (typeof ESQUEMAS_INTERNOS)[number];
+export interface UrlInterna {
+    esquema: string;
+    /** Todo lo que va después de `://`, sin decodificar: cada manejador decide qué hacer con él. */
+    resto: string;
+}
+/** `null` cuando el texto no tiene forma de URL — no es "no reconocido", es "no aplica". */
+export declare function parseaUrlInterna(texto: string): UrlInterna | null;
+export declare function esEsquemaConocido(esquema: string): esquema is EsquemaInterno;
+/** El error que ve el modelo cuando pide un esquema que no existe. Siempre nombra los que sí. */
+export declare function errorEsquemaDesconocido(esquema: string): Error;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,yFAAwF;AACxF,eAAO,MAAM,iBAAiB,+CAAgD,CAAC;AAC/E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,mGAAgG;IAChG,KAAK,EAAE,MAAM,CAAC;CACd;AAID,8FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAIjE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,cAAc,CAE5E;AAED,kGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAI9D","sourcesContent":["/**\n * Parseo de URLs internas: `esquema://resto`.\n *\n * oh-my-pi (el competidor, ver `/Users/31017423z/auditoria-omp/oh-my-pi`)\n * tiene veinte esquemas y un parser que reconstruye `URL` a mano para\n * aguantar dos puntos dentro del host (`skill://plugin:name`). Nosotros no\n * tenemos esa forma — nuestro \"resto\" es una consulta, un nombre o un número,\n * nunca un host con puerto — así que un regex basta y no hace falta\n * replicar esa máquina.\n *\n * La frontera es literal: cualquier texto con forma `algo://algo` entra en\n * este espacio de nombres y YA NO se intenta como ruta de fichero. Una ruta\n * real de disco no lleva `://`, así que no hay colisión que resolver.\n */\n\n/** Los únicos cuatro esquemas que existen hoy. Cualquier otro es un error con lista. */\nexport const ESQUEMAS_INTERNOS = [\"memory\", \"vault\", \"rule\", \"audit\"] as const;\nexport type EsquemaInterno = (typeof ESQUEMAS_INTERNOS)[number];\n\nexport interface UrlInterna {\n\tesquema: string;\n\t/** Todo lo que va después de `://`, sin decodificar: cada manejador decide qué hacer con él. */\n\tresto: string;\n}\n\nconst PATRON = /^([a-zA-Z][a-zA-Z0-9+.-]*):\\/\\/(.*)$/s;\n\n/** `null` cuando el texto no tiene forma de URL — no es \"no reconocido\", es \"no aplica\". */\nexport function parseaUrlInterna(texto: string): UrlInterna | null {\n\tconst m = PATRON.exec(texto);\n\tif (!m) return null;\n\treturn { esquema: m[1].toLowerCase(), resto: m[2] };\n}\n\nexport function esEsquemaConocido(esquema: string): esquema is EsquemaInterno {\n\treturn (ESQUEMAS_INTERNOS as readonly string[]).includes(esquema);\n}\n\n/** El error que ve el modelo cuando pide un esquema que no existe. Siempre nombra los que sí. */\nexport function errorEsquemaDesconocido(esquema: string): Error {\n\treturn new Error(\n\t\t`Esquema interno desconocido: \"${esquema}://\". Esquemas disponibles: ${ESQUEMAS_INTERNOS.map((e) => `${e}://`).join(\", \")}.`,\n\t);\n}\n"]}

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

@@ -0,0 +1,32 @@
+/**
+ * Parseo de URLs internas: `esquema://resto`.
+ *
+ * oh-my-pi (el competidor, ver `/Users/31017423z/auditoria-omp/oh-my-pi`)
+ * tiene veinte esquemas y un parser que reconstruye `URL` a mano para
+ * aguantar dos puntos dentro del host (`skill://plugin:name`). Nosotros no
+ * tenemos esa forma — nuestro "resto" es una consulta, un nombre o un número,
+ * nunca un host con puerto — así que un regex basta y no hace falta
+ * replicar esa máquina.
+ *
+ * La frontera es literal: cualquier texto con forma `algo://algo` entra en
+ * este espacio de nombres y YA NO se intenta como ruta de fichero. Una ruta
+ * real de disco no lleva `://`, así que no hay colisión que resolver.
+ */
+/** Los únicos cuatro esquemas que existen hoy. Cualquier otro es un error con lista. */
+export const ESQUEMAS_INTERNOS = ["memory", "vault", "rule", "audit"];
+const PATRON = /^([a-zA-Z][a-zA-Z0-9+.-]*):\/\/(.*)$/s;
+/** `null` cuando el texto no tiene forma de URL — no es "no reconocido", es "no aplica". */
+export function parseaUrlInterna(texto) {
+    const m = PATRON.exec(texto);
+    if (!m)
+        return null;
+    return { esquema: m[1].toLowerCase(), resto: m[2] };
+}
+export function esEsquemaConocido(esquema) {
+    return ESQUEMAS_INTERNOS.includes(esquema);
+}
+/** El error que ve el modelo cuando pide un esquema que no existe. Siempre nombra los que sí. */
+export function errorEsquemaDesconocido(esquema) {
+    return new Error(`Esquema interno desconocido: "${esquema}://". Esquemas disponibles: ${ESQUEMAS_INTERNOS.map((e) => `${e}://`).join(", ")}.`);
+}
+//# sourceMappingURL=parse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/core/urls-internas/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,yFAAwF;AACxF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAS/E,MAAM,MAAM,GAAG,uCAAuC,CAAC;AAEvD,8FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAqB;IAClE,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAAA,CACpD;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAA6B;IAC7E,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAAA,CAClE;AAED,kGAAiG;AACjG,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAS;IAC/D,OAAO,IAAI,KAAK,CACf,iCAAiC,OAAO,+BAA+B,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC5H,CAAC;AAAA,CACF","sourcesContent":["/**\n * Parseo de URLs internas: `esquema://resto`.\n *\n * oh-my-pi (el competidor, ver `/Users/31017423z/auditoria-omp/oh-my-pi`)\n * tiene veinte esquemas y un parser que reconstruye `URL` a mano para\n * aguantar dos puntos dentro del host (`skill://plugin:name`). Nosotros no\n * tenemos esa forma — nuestro \"resto\" es una consulta, un nombre o un número,\n * nunca un host con puerto — así que un regex basta y no hace falta\n * replicar esa máquina.\n *\n * La frontera es literal: cualquier texto con forma `algo://algo` entra en\n * este espacio de nombres y YA NO se intenta como ruta de fichero. Una ruta\n * real de disco no lleva `://`, así que no hay colisión que resolver.\n */\n\n/** Los únicos cuatro esquemas que existen hoy. Cualquier otro es un error con lista. */\nexport const ESQUEMAS_INTERNOS = [\"memory\", \"vault\", \"rule\", \"audit\"] as const;\nexport type EsquemaInterno = (typeof ESQUEMAS_INTERNOS)[number];\n\nexport interface UrlInterna {\n\tesquema: string;\n\t/** Todo lo que va después de `://`, sin decodificar: cada manejador decide qué hacer con él. */\n\tresto: string;\n}\n\nconst PATRON = /^([a-zA-Z][a-zA-Z0-9+.-]*):\\/\\/(.*)$/s;\n\n/** `null` cuando el texto no tiene forma de URL — no es \"no reconocido\", es \"no aplica\". */\nexport function parseaUrlInterna(texto: string): UrlInterna | null {\n\tconst m = PATRON.exec(texto);\n\tif (!m) return null;\n\treturn { esquema: m[1].toLowerCase(), resto: m[2] };\n}\n\nexport function esEsquemaConocido(esquema: string): esquema is EsquemaInterno {\n\treturn (ESQUEMAS_INTERNOS as readonly string[]).includes(esquema);\n}\n\n/** El error que ve el modelo cuando pide un esquema que no existe. Siempre nombra los que sí. */\nexport function errorEsquemaDesconocido(esquema: string): Error {\n\treturn new Error(\n\t\t`Esquema interno desconocido: \"${esquema}://\". Esquemas disponibles: ${ESQUEMAS_INTERNOS.map((e) => `${e}://`).join(\", \")}.`,\n\t);\n}\n"]}

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

@@ -0,0 +1,10 @@
+/**
+ * `rule://<origen>` — las reglas que `descubrimiento/reglas.ts` ya encuentra
+ * (`.cursorrules`, `.clinerules`, `.windsurfrules`, GEMINI.md, Copilot…).
+ *
+ * `descubrirReglas` ya hace la deduplicación por contenido y el tope de
+ * tamaño; aquí solo se filtra por origen y se recorta el texto final para no
+ * volcar un fichero de 32KB entero en una respuesta de `read`.
+ */
+export declare function leerReglas(cwd: string, origen: string): string;
+//# sourceMappingURL=reglas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reglas.d.ts","sourceRoot":"","sources":["../../../src/core/urls-internas/reglas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAiB9D","sourcesContent":["/**\n * `rule://<origen>` — las reglas que `descubrimiento/reglas.ts` ya encuentra\n * (`.cursorrules`, `.clinerules`, `.windsurfrules`, GEMINI.md, Copilot…).\n *\n * `descubrirReglas` ya hace la deduplicación por contenido y el tope de\n * tamaño; aquí solo se filtra por origen y se recorta el texto final para no\n * volcar un fichero de 32KB entero en una respuesta de `read`.\n */\n\nimport { descubrirReglas } from \"../descubrimiento/reglas.ts\";\nimport { truncateHead } from \"../tools/truncate.ts\";\n\nconst TOPE_SALIDA = 8 * 1024;\n\nexport function leerReglas(cwd: string, origen: string): string {\n\tconst { reglas, omitidas } = descubrirReglas(cwd);\n\tconst filtro = origen.trim().toLowerCase();\n\tconst encontradas = filtro ? reglas.filter((r) => r.origen.toLowerCase().includes(filtro)) : reglas;\n\n\tif (reglas.length === 0) return \"rule://: no se ha descubierto ninguna regla en este proyecto.\";\n\tif (encontradas.length === 0) {\n\t\tconst origenes = [...new Set(reglas.map((r) => r.origen))].join(\", \");\n\t\treturn `rule://${origen}: ninguna regla descubierta de ese origen. Orígenes presentes: ${origenes}.`;\n\t}\n\n\tconst cuerpo = encontradas.map((r) => `── ${r.ruta} (${r.origen}) ──\\n${r.contenido}`).join(\"\\n\\n\");\n\tconst recortado = truncateHead(cuerpo, { maxBytes: TOPE_SALIDA });\n\tlet salida = `${encontradas.length} regla(s) de ${filtro ? origen : \"todos los orígenes\"}:\\n${recortado.content}`;\n\tif (recortado.truncated) salida += \"\\n\\n[recortado; pide un origen más concreto para ver el resto]\";\n\tif (omitidas.length > 0) salida += `\\n\\nOmitidas: ${omitidas.map((o) => `${o.ruta} (${o.motivo})`).join(\"; \")}`;\n\treturn salida;\n}\n"]}

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

@@ -0,0 +1,31 @@
+/**
+ * `rule://<origen>` — las reglas que `descubrimiento/reglas.ts` ya encuentra
+ * (`.cursorrules`, `.clinerules`, `.windsurfrules`, GEMINI.md, Copilot…).
+ *
+ * `descubrirReglas` ya hace la deduplicación por contenido y el tope de
+ * tamaño; aquí solo se filtra por origen y se recorta el texto final para no
+ * volcar un fichero de 32KB entero en una respuesta de `read`.
+ */
+import { descubrirReglas } from "../descubrimiento/reglas.js";
+import { truncateHead } from "../tools/truncate.js";
+const TOPE_SALIDA = 8 * 1024;
+export function leerReglas(cwd, origen) {
+    const { reglas, omitidas } = descubrirReglas(cwd);
+    const filtro = origen.trim().toLowerCase();
+    const encontradas = filtro ? reglas.filter((r) => r.origen.toLowerCase().includes(filtro)) : reglas;
+    if (reglas.length === 0)
+        return "rule://: no se ha descubierto ninguna regla en este proyecto.";
+    if (encontradas.length === 0) {
+        const origenes = [...new Set(reglas.map((r) => r.origen))].join(", ");
+        return `rule://${origen}: ninguna regla descubierta de ese origen. Orígenes presentes: ${origenes}.`;
+    }
+    const cuerpo = encontradas.map((r) => `── ${r.ruta} (${r.origen}) ──\n${r.contenido}`).join("\n\n");
+    const recortado = truncateHead(cuerpo, { maxBytes: TOPE_SALIDA });
+    let salida = `${encontradas.length} regla(s) de ${filtro ? origen : "todos los orígenes"}:\n${recortado.content}`;
+    if (recortado.truncated)
+        salida += "\n\n[recortado; pide un origen más concreto para ver el resto]";
+    if (omitidas.length > 0)
+        salida += `\n\nOmitidas: ${omitidas.map((o) => `${o.ruta} (${o.motivo})`).join("; ")}`;
+    return salida;
+}
+//# sourceMappingURL=reglas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reglas.js","sourceRoot":"","sources":["../../../src/core/urls-internas/reglas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC;AAE7B,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,MAAc,EAAU;IAC/D,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEpG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,+DAA+D,CAAC;IAChG,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,UAAU,MAAM,mEAAkE,QAAQ,GAAG,CAAC;IACtG,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,aAAS,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpG,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IAClE,IAAI,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,gBAAgB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAoB,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;IAClH,IAAI,SAAS,CAAC,SAAS;QAAE,MAAM,IAAI,iEAAgE,CAAC;IACpG,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,iBAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAChH,OAAO,MAAM,CAAC;AAAA,CACd","sourcesContent":["/**\n * `rule://<origen>` — las reglas que `descubrimiento/reglas.ts` ya encuentra\n * (`.cursorrules`, `.clinerules`, `.windsurfrules`, GEMINI.md, Copilot…).\n *\n * `descubrirReglas` ya hace la deduplicación por contenido y el tope de\n * tamaño; aquí solo se filtra por origen y se recorta el texto final para no\n * volcar un fichero de 32KB entero en una respuesta de `read`.\n */\n\nimport { descubrirReglas } from \"../descubrimiento/reglas.ts\";\nimport { truncateHead } from \"../tools/truncate.ts\";\n\nconst TOPE_SALIDA = 8 * 1024;\n\nexport function leerReglas(cwd: string, origen: string): string {\n\tconst { reglas, omitidas } = descubrirReglas(cwd);\n\tconst filtro = origen.trim().toLowerCase();\n\tconst encontradas = filtro ? reglas.filter((r) => r.origen.toLowerCase().includes(filtro)) : reglas;\n\n\tif (reglas.length === 0) return \"rule://: no se ha descubierto ninguna regla en este proyecto.\";\n\tif (encontradas.length === 0) {\n\t\tconst origenes = [...new Set(reglas.map((r) => r.origen))].join(\", \");\n\t\treturn `rule://${origen}: ninguna regla descubierta de ese origen. Orígenes presentes: ${origenes}.`;\n\t}\n\n\tconst cuerpo = encontradas.map((r) => `── ${r.ruta} (${r.origen}) ──\\n${r.contenido}`).join(\"\\n\\n\");\n\tconst recortado = truncateHead(cuerpo, { maxBytes: TOPE_SALIDA });\n\tlet salida = `${encontradas.length} regla(s) de ${filtro ? origen : \"todos los orígenes\"}:\\n${recortado.content}`;\n\tif (recortado.truncated) salida += \"\\n\\n[recortado; pide un origen más concreto para ver el resto]\";\n\tif (omitidas.length > 0) salida += `\\n\\nOmitidas: ${omitidas.map((o) => `${o.ruta} (${o.motivo})`).join(\"; \")}`;\n\treturn salida;\n}\n"]}

package/dist/core/usage/aggregate.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Agrega el consumo real a partir de los JSONL de sesión.
+ *
+ * El dato ya estaba ahí —cada mensaje del asistente guarda `usage` con tokens y
+ * coste—, solo que nadie lo leía. Esto no estima nada: suma lo que el proveedor
+ * cobró.
+ *
+ * Los tokens de caché se cuentan APARTE. Meterlos en el total haría que un día
+ * con mucha caché pareciera carísimo cuando es justo lo contrario: la caché es
+ * lo que abarata: en DeepSeek un acierto cuesta ~1/31 de un fallo. Un panel que
+ * los mezcla enseña un número que no se corresponde con la factura.
+ */
+export interface UsoBruto {
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    cost?: {
+        total?: number;
+    };
+}
+export interface LineaSesion {
+    type?: string;
+    timestamp?: string;
+    cwd?: string;
+    message?: {
+        role?: string;
+        provider?: string;
+        model?: string;
+        usage?: UsoBruto;
+    };
+}
+export interface Totales {
+    mensajes: number;
+    entrada: number;
+    salida: number;
+    cacheRead: number;
+    cacheWrite: number;
+    coste: number;
+}
+export interface Resumen extends Totales {
+    sesiones: number;
+    /** Sesiones descartadas por vivir en un directorio temporal. */
+    sesionesTemporales: number;
+    porModelo: Record<string, Totales>;
+    porDia: Record<string, Totales>;
+    porProyecto: Record<string, Totales>;
+}
+export declare function esRutaTemporal(ruta: string): boolean;
+export interface OpcionesResumen {
+    /** Solo mensajes a partir de esta fecha (ISO). */
+    desde?: string;
+    /** Incluir las sesiones de directorios temporales (las de los tests). */
+    incluirTemporales?: boolean;
+}
+/**
+ * Resume una o varias sesiones.
+ *
+ * Una sesión cuenta solo si aportó consumo: los JSONL abandonados sin una sola
+ * respuesta inflarían el recuento de sesiones sin corresponder a trabajo.
+ */
+export declare function resumir(sesiones: Array<{
+    cwd?: string;
+    lineas: LineaSesion[];
+}>, opciones?: OpcionesResumen): Resumen;
+/** Ordena un desglose de mayor a menor coste, que es el orden que importa. */
+export declare function porCoste(cubos: Record<string, Totales>): Array<[string, Totales]>;
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/core/usage/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../src/core/usage/aggregate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,QAAQ;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,QAAQ,CAAC;KACjB,CAAC;CACF;AAED,MAAM,WAAW,OAAO;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAQ,SAAQ,OAAO;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAoCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,MAAM,WAAW,eAAe;IAC/B,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACtB,QAAQ,EAAE,KAAK,CAAC;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,EACxD,QAAQ,GAAE,eAAoB,GAC5B,OAAO,CAmCT;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEjF","sourcesContent":["/**\n * Agrega el consumo real a partir de los JSONL de sesión.\n *\n * El dato ya estaba ahí —cada mensaje del asistente guarda `usage` con tokens y\n * coste—, solo que nadie lo leía. Esto no estima nada: suma lo que el proveedor\n * cobró.\n *\n * Los tokens de caché se cuentan APARTE. Meterlos en el total haría que un día\n * con mucha caché pareciera carísimo cuando es justo lo contrario: la caché es\n * lo que abarata: en DeepSeek un acierto cuesta ~1/31 de un fallo. Un panel que\n * los mezcla enseña un número que no se corresponde con la factura.\n */\n\nexport interface UsoBruto {\n\tinput?: number;\n\toutput?: number;\n\tcacheRead?: number;\n\tcacheWrite?: number;\n\tcost?: { total?: number };\n}\n\nexport interface LineaSesion {\n\ttype?: string;\n\ttimestamp?: string;\n\tcwd?: string;\n\tmessage?: {\n\t\trole?: string;\n\t\tprovider?: string;\n\t\tmodel?: string;\n\t\tusage?: UsoBruto;\n\t};\n}\n\nexport interface Totales {\n\tmensajes: number;\n\tentrada: number;\n\tsalida: number;\n\tcacheRead: number;\n\tcacheWrite: number;\n\tcoste: number;\n}\n\nexport interface Resumen extends Totales {\n\tsesiones: number;\n\t/** Sesiones descartadas por vivir en un directorio temporal. */\n\tsesionesTemporales: number;\n\tporModelo: Record<string, Totales>;\n\tporDia: Record<string, Totales>;\n\tporProyecto: Record<string, Totales>;\n}\n\nfunction vacio(): Totales {\n\treturn { mensajes: 0, entrada: 0, salida: 0, cacheRead: 0, cacheWrite: 0, coste: 0 };\n}\n\nfunction acumular(destino: Totales, uso: UsoBruto): void {\n\tdestino.mensajes += 1;\n\tdestino.entrada += uso.input ?? 0;\n\tdestino.salida += uso.output ?? 0;\n\tdestino.cacheRead += uso.cacheRead ?? 0;\n\tdestino.cacheWrite += uso.cacheWrite ?? 0;\n\tdestino.coste += uso.cost?.total ?? 0;\n}\n\nfunction enCubo(mapa: Record<string, Totales>, clave: string): Totales {\n\tconst actual = mapa[clave];\n\tif (actual) return actual;\n\tconst nuevo = vacio();\n\tmapa[clave] = nuevo;\n\treturn nuevo;\n}\n\n/**\n * Directorios que nunca son un proyecto del usuario.\n *\n * Las suites de tests crean sus sesiones en temporales del sistema y acaban en\n * el mismo almacén que las reales: sin filtrarlas, el desglose por proyecto son\n * 989 rutas `/var/folders/kl/5b56hptn6…` que ya ni existen, y el consumo real\n * queda enterrado debajo.\n *\n * Estrecho a propósito: esconder un proyecto real sería peor que enseñar una\n * ruta rara, y por eso hay `--all`.\n */\nconst RUTAS_TEMPORALES = [/^\\/var\\/folders\\//, /^\\/private\\/var\\/folders\\//, /^\\/tmp\\//, /[\\\\/]Temp[\\\\/]/i];\n\nexport function esRutaTemporal(ruta: string): boolean {\n\treturn RUTAS_TEMPORALES.some((patron) => patron.test(ruta));\n}\n\nexport interface OpcionesResumen {\n\t/** Solo mensajes a partir de esta fecha (ISO). */\n\tdesde?: string;\n\t/** Incluir las sesiones de directorios temporales (las de los tests). */\n\tincluirTemporales?: boolean;\n}\n\n/**\n * Resume una o varias sesiones.\n *\n * Una sesión cuenta solo si aportó consumo: los JSONL abandonados sin una sola\n * respuesta inflarían el recuento de sesiones sin corresponder a trabajo.\n */\nexport function resumir(\n\tsesiones: Array<{ cwd?: string; lineas: LineaSesion[] }>,\n\topciones: OpcionesResumen = {},\n): Resumen {\n\tconst resumen: Resumen = {\n\t\t...vacio(),\n\t\tsesiones: 0,\n\t\tsesionesTemporales: 0,\n\t\tporModelo: {},\n\t\tporDia: {},\n\t\tporProyecto: {},\n\t};\n\n\tfor (const sesion of sesiones) {\n\t\tlet aporto = false;\n\t\t// El `cwd` viene en la cabecera; si falta, se etiqueta explícitamente en\n\t\t// vez de repartirlo entre los demás proyectos.\n\t\tconst proyecto = sesion.cwd ?? sesion.lineas.find((l) => l.type === \"session\")?.cwd ?? \"(desconocido)\";\n\t\tif (!opciones.incluirTemporales && esRutaTemporal(proyecto)) {\n\t\t\tresumen.sesionesTemporales += 1;\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const linea of sesion.lineas) {\n\t\t\tconst uso = linea.message?.usage;\n\t\t\tif (!uso || linea.message?.role !== \"assistant\") continue;\n\t\t\tif (opciones.desde && linea.timestamp && linea.timestamp < opciones.desde) continue;\n\n\t\t\taporto = true;\n\t\t\tacumular(resumen, uso);\n\t\t\tacumular(enCubo(resumen.porModelo, `${linea.message.provider ?? \"?\"}/${linea.message.model ?? \"?\"}`), uso);\n\t\t\tacumular(enCubo(resumen.porProyecto, proyecto), uso);\n\t\t\tif (linea.timestamp) acumular(enCubo(resumen.porDia, linea.timestamp.slice(0, 10)), uso);\n\t\t}\n\t\tif (aporto) resumen.sesiones += 1;\n\t}\n\n\treturn resumen;\n}\n\n/** Ordena un desglose de mayor a menor coste, que es el orden que importa. */\nexport function porCoste(cubos: Record<string, Totales>): Array<[string, Totales]> {\n\treturn Object.entries(cubos).sort((a, b) => b[1].coste - a[1].coste || b[1].salida - a[1].salida);\n}\n"]}