@hoilab/ada-cli 0.85.0 → 0.85.1

package/dist/core/slash-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"slash-commands.js","sourceRoot":"","sources":["../../src/core/slash-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAkBxC,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACzE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACvD,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,kCAAkC,EAAE,YAAY,EAAE,kBAAkB,EAAE;IACpG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACxE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,YAAY,EAAE,SAAS,EAAE;IAChF,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,0CAA0C,EAAE;IAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8DAA8D,EAAE;IAC/F,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;IAChF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,uCAAuC,EAAE;IACvE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACrE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACzD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE;IAC5D,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,gDAAgD,EAAE;IAC/E,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,uDAAuD,EAAE;IACvF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,iDAAiD,EAAE;IACjF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,mCAAmC,EAAE,YAAY,EAAE,YAAY,EAAE;IAC/F,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;IACjE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE;IACnD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACxE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC7D,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4EAA4E,EAAE;IAC7G,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,QAAQ,EAAE,EAAE;CACjD,CAAC","sourcesContent":["import { APP_NAME } from \"../config.ts\";\nimport type { SourceInfo } from \"./source-info.ts\";\n\nexport type SlashCommandSource = \"extension\" | \"prompt\" | \"skill\";\n\nexport interface SlashCommandInfo {\n\tname: string;\n\tdescription?: string;\n\tsource: SlashCommandSource;\n\tsourceInfo: SourceInfo;\n}\n\nexport interface BuiltinSlashCommand {\n\tname: string;\n\tdescription: string;\n\targumentHint?: string;\n}\n\nexport const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand> = [\n\t{ name: \"settings\", description: \"Open settings menu\" },\n\t{ name: \"model\", description: \"Select model (opens selector UI)\", argumentHint: \"<provider/model>\" },\n\t{ name: \"tree\", description: \"Navigate session tree (switch branches)\" },\n\t{ name: \"thinking\", description: \"Set thinking level\", argumentHint: \"<level>\" },\n\t{ name: \"scoped-models\", description: \"Enable/disable models for Ctrl+P cycling\" },\n\t{ name: \"export\", description: \"Export session (HTML default, or specify path: .html/.jsonl)\" },\n\t{ name: \"import\", description: \"Import and resume a session from a JSONL file\" },\n\t{ name: \"share\", description: \"Share session as a secret GitHub gist\" },\n\t{ name: \"copy\", description: \"Copy last agent message to clipboard\" },\n\t{ name: \"name\", description: \"Set session display name\" },\n\t{ name: \"session\", description: \"Show session info and stats\" },\n\t{ name: \"changelog\", description: \"Show changelog entries\" },\n\t{ name: \"hotkeys\", description: \"Show all keyboard shortcuts\" },\n\t{ name: \"fork\", description: \"Create a new fork from a previous user message\" },\n\t{ name: \"clone\", description: \"Duplicate the current session at the current position\" },\n\t{ name: \"trust\", description: \"Save project trust decision for future sessions\" },\n\t{ name: \"login\", description: \"Configure provider authentication\", argumentHint: \"<provider>\" },\n\t{ name: \"logout\", description: \"Remove provider authentication\" },\n\t{ name: \"new\", description: \"Start a new session\" },\n\t{ name: \"compact\", description: \"Manually compact the session context\" },\n\t{ name: \"resume\", description: \"Resume a different session\" },\n\t{ name: \"reload\", description: \"Reload keybindings, extensions, skills, prompts, themes, and context files\" },\n\t{ name: \"quit\", description: `Quit ${APP_NAME}` },\n];\n"]}
+{"version":3,"file":"slash-commands.js","sourceRoot":"","sources":["../../src/core/slash-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAkBxC,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACzE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACvD,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,kCAAkC,EAAE,YAAY,EAAE,kBAAkB,EAAE;IACpG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACxE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,YAAY,EAAE,SAAS,EAAE;IAChF,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,0CAA0C,EAAE;IAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8DAA8D,EAAE;IAC/F,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;IAChF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,uCAAuC,EAAE;IACvE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACrE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACzD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE;IAC5D,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,gDAAgD,EAAE;IAC/E,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,uDAAuD,EAAE;IACvF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,iDAAiD,EAAE;IACjF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,mCAAmC,EAAE,YAAY,EAAE,YAAY,EAAE;IAC/F,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;IACjE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE;IACnD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACxE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC7D,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4EAA4E,EAAE;IAC7G,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,QAAQ,EAAE,EAAE;CACjD,CAAC"}

package/dist/core/source-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-info.d.ts","sourceRoot":"","sources":["../../src/core/source-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAEnD,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,UAAU,CAQjF;AAED,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACR,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GACC,UAAU,CAQZ","sourcesContent":["import type { PathMetadata } from \"./package-manager.ts\";\n\nexport type SourceScope = \"user\" | \"project\" | \"temporary\";\nexport type SourceOrigin = \"package\" | \"top-level\";\n\nexport interface SourceInfo {\n\tpath: string;\n\tsource: string;\n\tscope: SourceScope;\n\torigin: SourceOrigin;\n\tbaseDir?: string;\n}\n\nexport function createSourceInfo(path: string, metadata: PathMetadata): SourceInfo {\n\treturn {\n\t\tpath,\n\t\tsource: metadata.source,\n\t\tscope: metadata.scope,\n\t\torigin: metadata.origin,\n\t\tbaseDir: metadata.baseDir,\n\t};\n}\n\nexport function createSyntheticSourceInfo(\n\tpath: string,\n\toptions: {\n\t\tsource: string;\n\t\tscope?: SourceScope;\n\t\torigin?: SourceOrigin;\n\t\tbaseDir?: string;\n\t},\n): SourceInfo {\n\treturn {\n\t\tpath,\n\t\tsource: options.source,\n\t\tscope: options.scope ?? \"temporary\",\n\t\torigin: options.origin ?? \"top-level\",\n\t\tbaseDir: options.baseDir,\n\t};\n}\n"]}
+{"version":3,"file":"source-info.d.ts","sourceRoot":"","sources":["../../src/core/source-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAEnD,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,UAAU,CAQjF;AAED,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACR,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GACC,UAAU,CAQZ"}

package/dist/core/source-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-info.js","sourceRoot":"","sources":["../../src/core/source-info.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAsB,EAAc;IAClF,OAAO;QACN,IAAI;QACJ,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;KACzB,CAAC;AAAA,CACF;AAED,MAAM,UAAU,yBAAyB,CACxC,IAAY,EACZ,OAKC,EACY;IACb,OAAO;QACN,IAAI;QACJ,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,WAAW;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,WAAW;QACrC,OAAO,EAAE,OAAO,CAAC,OAAO;KACxB,CAAC;AAAA,CACF","sourcesContent":["import type { PathMetadata } from \"./package-manager.ts\";\n\nexport type SourceScope = \"user\" | \"project\" | \"temporary\";\nexport type SourceOrigin = \"package\" | \"top-level\";\n\nexport interface SourceInfo {\n\tpath: string;\n\tsource: string;\n\tscope: SourceScope;\n\torigin: SourceOrigin;\n\tbaseDir?: string;\n}\n\nexport function createSourceInfo(path: string, metadata: PathMetadata): SourceInfo {\n\treturn {\n\t\tpath,\n\t\tsource: metadata.source,\n\t\tscope: metadata.scope,\n\t\torigin: metadata.origin,\n\t\tbaseDir: metadata.baseDir,\n\t};\n}\n\nexport function createSyntheticSourceInfo(\n\tpath: string,\n\toptions: {\n\t\tsource: string;\n\t\tscope?: SourceScope;\n\t\torigin?: SourceOrigin;\n\t\tbaseDir?: string;\n\t},\n): SourceInfo {\n\treturn {\n\t\tpath,\n\t\tsource: options.source,\n\t\tscope: options.scope ?? \"temporary\",\n\t\torigin: options.origin ?? \"top-level\",\n\t\tbaseDir: options.baseDir,\n\t};\n}\n"]}
+{"version":3,"file":"source-info.js","sourceRoot":"","sources":["../../src/core/source-info.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAsB;IACpE,OAAO;QACN,IAAI;QACJ,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;KACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACxC,IAAY,EACZ,OAKC;IAED,OAAO;QACN,IAAI;QACJ,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,WAAW;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,WAAW;QACrC,OAAO,EAAE,OAAO,CAAC,OAAO;KACxB,CAAC;AACH,CAAC"}

package/dist/core/stream-guard/guardia.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Guardia de streaming universal — hallazgo E de la auditoría omp.
+ *
+ * Hoy solo el WS de Codex tiene idle-timeout (packages/ai/src/api/
+ * openai-codex-responses.ts); cualquier otro stream (SSE del rele, MCP,
+ * subprocesos largos) puede colgarse para siempre. vigilarStream envuelve
+ * CUALQUIER AsyncIterator con tres garantías:
+ *
+ * - Idle: si no llega evento en idleTimeoutMs se lanza ErrorStreamIdle
+ *   (clasificado, no un Error genérico), se avisa por onIdle y la fuente
+ *   subyacente se cierra. El consumidor decide reintentar (con replay si
+ *   envolvió la fuente en bufferReplay).
+ * - In-flight: contador global de streams vigilados con techo; al superarlo
+ *   la primera lectura rechaza con ErrorSaturado hasta que alguno baje.
+ * - Limpieza: el cupo se libera y la fuente se cierra en TODAS las salidas
+ *   (fin normal, error del consumidor, error del origen, idle).
+ */
+/** Sin eventos durante idleTimeoutMs: clasificada, reintento decisión del consumidor. */
+export declare class ErrorStreamIdle extends Error {
+    readonly idleTimeoutMs: number;
+    constructor(idleTimeoutMs: number);
+}
+/** Techo de streams simultáneos alcanzado: rechazo inmediato hasta que baje. */
+export declare class ErrorSaturado extends Error {
+    readonly activos: number;
+    readonly techo: number;
+    constructor(activos: number, techo: number);
+}
+export interface OpcionesGuardia {
+    /** ms sin eventos antes de declarar idle. 0 desactiva la vigilia. Default 30000. */
+    readonly idleTimeoutMs?: number;
+    /** Aviso de idle ANTES de lanzar ErrorStreamIdle (métricas, logs). */
+    readonly onIdle?: () => void;
+}
+/** Fija el techo global de streams vigilados simultáneos (anti-fuga). */
+export declare function fijarTechoStreams(techo: number): void;
+/** Recuento actual de streams bajo vigilancia (observabilidad). */
+export declare function contarStreamsActivos(): number;
+/**
+ * Envuelve un AsyncIterable/Iterator con vigilancia de idle y cupo in-flight.
+ * La adquisición del cupo es perezosa: ocurre en la primera `next()`, donde un
+ * exceso rechaza con ErrorSaturado (un generador aún no arrancado no consume).
+ */
+export declare function vigilarStream<T>(fuente: AsyncIterable<T> | AsyncIterator<T>, opciones?: OpcionesGuardia): AsyncGenerator<T>;
+//# sourceMappingURL=guardia.d.ts.map

package/dist/core/stream-guard/guardia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardia.d.ts","sourceRoot":"","sources":["../../../src/core/stream-guard/guardia.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,yFAAyF;AACzF,qBAAa,eAAgB,SAAQ,KAAK;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,aAAa,EAAE,MAAM;CAKjC;AAED,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAM1C;AAED,MAAM,WAAW,eAAe;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAOD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKrD;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AA2CD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC9B,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC3C,QAAQ,GAAE,eAAoB,GAC5B,cAAc,CAAC,CAAC,CAAC,CAInB"}

package/dist/core/stream-guard/guardia.js

@@ -0,0 +1,100 @@
+/**
+ * Guardia de streaming universal — hallazgo E de la auditoría omp.
+ *
+ * Hoy solo el WS de Codex tiene idle-timeout (packages/ai/src/api/
+ * openai-codex-responses.ts); cualquier otro stream (SSE del rele, MCP,
+ * subprocesos largos) puede colgarse para siempre. vigilarStream envuelve
+ * CUALQUIER AsyncIterator con tres garantías:
+ *
+ * - Idle: si no llega evento en idleTimeoutMs se lanza ErrorStreamIdle
+ *   (clasificado, no un Error genérico), se avisa por onIdle y la fuente
+ *   subyacente se cierra. El consumidor decide reintentar (con replay si
+ *   envolvió la fuente en bufferReplay).
+ * - In-flight: contador global de streams vigilados con techo; al superarlo
+ *   la primera lectura rechaza con ErrorSaturado hasta que alguno baje.
+ * - Limpieza: el cupo se libera y la fuente se cierra en TODAS las salidas
+ *   (fin normal, error del consumidor, error del origen, idle).
+ */
+/** Sin eventos durante idleTimeoutMs: clasificada, reintento decisión del consumidor. */
+export class ErrorStreamIdle extends Error {
+    idleTimeoutMs;
+    constructor(idleTimeoutMs) {
+        super(`Stream inactivo: ningún evento en ${idleTimeoutMs}ms.`);
+        this.name = "ErrorStreamIdle";
+        this.idleTimeoutMs = idleTimeoutMs;
+    }
+}
+/** Techo de streams simultáneos alcanzado: rechazo inmediato hasta que baje. */
+export class ErrorSaturado extends Error {
+    activos;
+    techo;
+    constructor(activos, techo) {
+        super(`Límite de streams simultáneos alcanzado (${activos}/${techo}).`);
+        this.name = "ErrorSaturado";
+        this.activos = activos;
+        this.techo = techo;
+    }
+}
+const IDLE_POR_DEFECTO_MS = 30_000;
+let techoStreams = 64;
+let streamsActivos = 0;
+/** Fija el techo global de streams vigilados simultáneos (anti-fuga). */
+export function fijarTechoStreams(techo) {
+    if (!Number.isInteger(techo) || techo <= 0) {
+        throw new Error(`Techo de streams inválido: ${String(techo)}`);
+    }
+    techoStreams = techo;
+}
+/** Recuento actual de streams bajo vigilancia (observabilidad). */
+export function contarStreamsActivos() {
+    return streamsActivos;
+}
+async function* vigilancia(iterator, idleTimeoutMs, onIdle) {
+    if (streamsActivos >= techoStreams) {
+        throw new ErrorSaturado(streamsActivos, techoStreams);
+    }
+    streamsActivos++;
+    try {
+        for (;;) {
+            let resultado;
+            if (idleTimeoutMs > 0) {
+                let temporizador;
+                const vencimiento = new Promise((_, reject) => {
+                    temporizador = setTimeout(() => {
+                        onIdle?.();
+                        void Promise.resolve(iterator.return?.()).catch(() => { });
+                        reject(new ErrorStreamIdle(idleTimeoutMs));
+                    }, idleTimeoutMs);
+                    // Node Timeout expone unref para no impedir la salida del proceso.
+                    const conUnref = temporizador;
+                    conUnref.unref?.();
+                });
+                resultado = await Promise.race([iterator.next(), vencimiento]).finally(() => {
+                    clearTimeout(temporizador);
+                });
+            }
+            else {
+                resultado = await iterator.next();
+            }
+            if (resultado.done) {
+                return;
+            }
+            yield resultado.value;
+        }
+    }
+    finally {
+        streamsActivos--;
+        await Promise.resolve(iterator.return?.()).catch(() => { });
+    }
+}
+/**
+ * Envuelve un AsyncIterable/Iterator con vigilancia de idle y cupo in-flight.
+ * La adquisición del cupo es perezosa: ocurre en la primera `next()`, donde un
+ * exceso rechaza con ErrorSaturado (un generador aún no arrancado no consume).
+ */
+export function vigilarStream(fuente, opciones = {}) {
+    const iterator = Symbol.asyncIterator in fuente ? fuente[Symbol.asyncIterator]() : fuente;
+    const idleTimeoutMs = opciones.idleTimeoutMs ?? IDLE_POR_DEFECTO_MS;
+    return vigilancia(iterator, idleTimeoutMs, opciones.onIdle);
+}
+//# sourceMappingURL=guardia.js.map

package/dist/core/stream-guard/guardia.js.map

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

package/dist/core/stream-guard/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * stream-guard — robustez de streaming universal (hallazgo E).
+ * Guardia de idle + techo in-flight + búfer replay para reconexión.
+ */
+export type { OpcionesGuardia } from "./guardia.ts";
+export { contarStreamsActivos, ErrorSaturado, ErrorStreamIdle, fijarTechoStreams, vigilarStream } from "./guardia.ts";
+export type { EntradaReplay, StreamConReplay } from "./replay.ts";
+export { BufferReplay, bufferReplay } from "./replay.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/stream-guard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/stream-guard/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtH,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/stream-guard/index.js

@@ -0,0 +1,7 @@
+/**
+ * stream-guard — robustez de streaming universal (hallazgo E).
+ * Guardia de idle + techo in-flight + búfer replay para reconexión.
+ */
+export { contarStreamsActivos, ErrorSaturado, ErrorStreamIdle, fijarTechoStreams, vigilarStream } from "./guardia.js";
+export { BufferReplay, bufferReplay } from "./replay.js";
+//# sourceMappingURL=index.js.map

package/dist/core/stream-guard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/stream-guard/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/stream-guard/replay.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Replay buffer para streams — complemento del guardia (hallazgo E).
+ *
+ * Reconexión SSE sin pérdida: guarda los últimos maxEventos eventos
+ * numerados y permite re-entregar desde una secuencia dada. El rele AG8 lo
+ * usa servidor-side para atender `x-rele-desde-seq` tras un corte de red.
+ */
+/** Evento numerado dentro del búfer. */
+export interface EntradaReplay<T> {
+    readonly seq: number;
+    readonly evento: T;
+}
+export declare class BufferReplay<T> {
+    #private;
+    constructor(maxEventos?: number);
+    /** Última secuencia entregada a este búfer (0 si vacío). */
+    get ultimoSeq(): number;
+    /** Registra un evento, le asigna secuencia y recorta el anillo. Devuelve la seq. */
+    registrar(evento: T): number;
+    /**
+     * Re-entrega los eventos con seq > desde (inclusive-exclusive, semántica
+     * Last-Event-ID de SSE). Los evicted ya no están y NO se re-entregan.
+     */
+    replayDesde(desde: number): T[];
+}
+export interface StreamConReplay<T> extends AsyncGenerator<T> {
+    /** Re-entrega los últimos eventos con seq > dado (para reconexión del consumidor). */
+    replayDesde(seq: number): T[];
+    /** Última seq vista por este búfer. */
+    ultimoSeq(): number;
+}
+/**
+ * Envuelve un AsyncIterable numerando cada evento en un BufferReplay y
+ * exponiendo replayDesde sobre el propio stream resultante.
+ */
+export declare function bufferReplay<T>(fuente: AsyncIterable<T>, opciones?: {
+    readonly maxEventos?: number;
+}): StreamConReplay<T>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/core/stream-guard/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../../src/core/stream-guard/replay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wCAAwC;AACxC,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CACnB;AAID,qBAAa,YAAY,CAAC,CAAC;;gBAKd,UAAU,GAAE,MAAgC;IAOxD,4DAA4D;IAC5D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,oFAAoF;IACpF,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM;IAS5B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE;CAa/B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAC5D,sFAAsF;IACtF,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IAC9B,uCAAuC;IACvC,SAAS,IAAI,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC7B,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,QAAQ,GAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,eAAe,CAAC,CAAC,CAAC,CAepB"}

package/dist/core/stream-guard/replay.js

@@ -0,0 +1,68 @@
+/**
+ * Replay buffer para streams — complemento del guardia (hallazgo E).
+ *
+ * Reconexión SSE sin pérdida: guarda los últimos maxEventos eventos
+ * numerados y permite re-entregar desde una secuencia dada. El rele AG8 lo
+ * usa servidor-side para atender `x-rele-desde-seq` tras un corte de red.
+ */
+const MAX_EVENTOS_POR_DEFECTO = 100;
+export class BufferReplay {
+    #buffer = [];
+    #maxEventos;
+    #ultimoSeq = 0;
+    constructor(maxEventos = MAX_EVENTOS_POR_DEFECTO) {
+        if (!Number.isInteger(maxEventos) || maxEventos <= 0) {
+            throw new Error(`maxEventos inválido: ${String(maxEventos)}`);
+        }
+        this.#maxEventos = maxEventos;
+    }
+    /** Última secuencia entregada a este búfer (0 si vacío). */
+    get ultimoSeq() {
+        return this.#ultimoSeq;
+    }
+    /** Registra un evento, le asigna secuencia y recorta el anillo. Devuelve la seq. */
+    registrar(evento) {
+        this.#ultimoSeq++;
+        this.#buffer.push({ seq: this.#ultimoSeq, evento });
+        if (this.#buffer.length > this.#maxEventos) {
+            this.#buffer.splice(0, this.#buffer.length - this.#maxEventos);
+        }
+        return this.#ultimoSeq;
+    }
+    /**
+     * Re-entrega los eventos con seq > desde (inclusive-exclusive, semántica
+     * Last-Event-ID de SSE). Los evicted ya no están y NO se re-entregan.
+     */
+    replayDesde(desde) {
+        if (!Number.isInteger(desde) || desde < 0) {
+            throw new RangeError(`seq inválida para replay: ${String(desde)}`);
+        }
+        const salida = [];
+        for (let i = this.#buffer.length - 1; i >= 0; i--) {
+            if (this.#buffer[i].seq <= desde) {
+                break;
+            }
+            salida.unshift(this.#buffer[i].evento);
+        }
+        return salida;
+    }
+}
+/**
+ * Envuelve un AsyncIterable numerando cada evento en un BufferReplay y
+ * exponiendo replayDesde sobre el propio stream resultante.
+ */
+export function bufferReplay(fuente, opciones = {}) {
+    const bufer = new BufferReplay(opciones.maxEventos);
+    async function* numerado() {
+        for await (const evento of fuente) {
+            bufer.registrar(evento);
+            yield evento;
+        }
+    }
+    const generador = numerado();
+    return Object.assign(generador, {
+        replayDesde: (seq) => bufer.replayDesde(seq),
+        ultimoSeq: () => bufer.ultimoSeq,
+    });
+}
+//# sourceMappingURL=replay.js.map

package/dist/core/stream-guard/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../../src/core/stream-guard/replay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,MAAM,OAAO,YAAY;IACxB,OAAO,GAA4B,EAAE,CAAC;IACtC,WAAW,CAAS;IACpB,UAAU,GAAG,CAAC,CAAC;IAEf,YAAY,aAAqB,uBAAuB;QACvD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,4DAA4D;IAC5D,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED,oFAAoF;IACpF,SAAS,CAAC,MAAS;QAClB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,KAAa;QACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,UAAU,CAAC,6BAA6B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC;gBAClC,MAAM;YACP,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;CACD;AASD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC3B,MAAwB,EACxB,WAA6C,EAAE;IAE/C,MAAM,KAAK,GAAG,IAAI,YAAY,CAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;IAEvD,KAAK,SAAS,CAAC,CAAC,QAAQ;QACvB,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;YACnC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACxB,MAAM,MAAM,CAAC;QACd,CAAC;IACF,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;QAC/B,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC;QACpD,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS;KAChC,CAAuB,CAAC;AAC1B,CAAC"}

package/dist/core/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CA6I3E","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { montarPromptDelSistema } from \"./prompts/montar.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\nexport interface BuildSystemPromptOptions {\n\t/**\n\t * Modo plan activo: el prompt gana la sección que dice que el árbol es de\n\t * solo lectura. Declarado aquí arriba, y no junto a los demás campos, para\n\t * que el hunk de sincronización se pegue al del `import` de `montar.ts` en\n\t * vez de abrir uno nuevo: el presupuesto de fork está a 118/118.\n\t */\n\tmodoPlan?: boolean;\n\t/**\n\t * Tools que el usuario ha denegado (`permissions.denied`).\n\t *\n\t * La sección de modo plan enumera las tools que SIGUEN valiendo, y `decidir()`\n\t * consulta el `deny` del usuario ANTES del modo: sin esto la sección promete\n\t * una tool que el guardián rechaza, que es exactamente el rechazo inesperado\n\t * que la sección existe para evitarle al modelo. Pegado a `modoPlan` para que\n\t * los dos caigan en el mismo hunk de sincronización (medido: sigue en 2).\n\t */\n\ttoolsDenegadas?: readonly string[];\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}\\n`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\t// La doctrina vive en `core/prompts/sistema.md` y se monta con plantillas\n\t// condicionales: cada sección existe SOLO si su capacidad existe. Antes aquí\n\t// había dos directrices («Be concise», «Show file paths clearly») y un bloque\n\t// sobre la documentación de Ada — y de las trece capacidades que habíamos\n\t// construido, NINGUNA aparecía. Ver `core/prompts/montar.ts`.\n\tlet prompt = `${montarPromptDelSistema({\n\t\tnombresDeHerramienta: tools,\n\t\tfrasesDeHerramienta: toolSnippets,\n\t\tmodoPlan: options.modoPlan === true,\n\t\ttoolsDenegadas: options.toolsDenegadas,\n\t})}\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n${guidelines ? `\\nProject guidelines:\\n${guidelines}\\n` : \"\"}\nAda documentation (read only when the user asks about ada itself, its SDK, extensions, themes, skills, or TUI; the Ada SDK API is the pi.* extension API for compatibility):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading ada docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), ada packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on ada topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read ada .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CA6I3E"}

package/dist/core/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * System prompt construction and project context loading\n */\n\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.ts\";\nimport { montarPromptDelSistema } from \"./prompts/montar.ts\";\nimport { formatSkillsForPrompt, type Skill } from \"./skills.ts\";\n\nexport interface BuildSystemPromptOptions {\n\t/**\n\t * Modo plan activo: el prompt gana la sección que dice que el árbol es de\n\t * solo lectura. Declarado aquí arriba, y no junto a los demás campos, para\n\t * que el hunk de sincronización se pegue al del `import` de `montar.ts` en\n\t * vez de abrir uno nuevo: el presupuesto de fork está a 118/118.\n\t */\n\tmodoPlan?: boolean;\n\t/**\n\t * Tools que el usuario ha denegado (`permissions.denied`).\n\t *\n\t * La sección de modo plan enumera las tools que SIGUEN valiendo, y `decidir()`\n\t * consulta el `deny` del usuario ANTES del modo: sin esto la sección promete\n\t * una tool que el guardián rechaza, que es exactamente el rechazo inesperado\n\t * que la sección existe para evitarle al modelo. Pegado a `modoPlan` para que\n\t * los dos caigan en el mismo hunk de sincronización (medido: sigue en 2).\n\t */\n\ttoolsDenegadas?: readonly string[];\n\t/** Custom system prompt (replaces default). */\n\tcustomPrompt?: string;\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\n\tselectedTools?: string[];\n\t/** Optional one-line tool snippets keyed by tool name. */\n\ttoolSnippets?: Record<string, string>;\n\t/** Additional guideline bullets appended to the default system prompt guidelines. */\n\tpromptGuidelines?: string[];\n\t/** Text to append to system prompt. */\n\tappendSystemPrompt?: string;\n\t/** Working directory. */\n\tcwd: string;\n\t/** Pre-loaded context files. */\n\tcontextFiles?: Array<{ path: string; content: string }>;\n\t/** Pre-loaded skills. */\n\tskills?: Skill[];\n}\n\n/** Build the system prompt with tools, guidelines, and context */\nexport function buildSystemPrompt(options: BuildSystemPromptOptions): string {\n\tconst {\n\t\tcustomPrompt,\n\t\tselectedTools,\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t\tappendSystemPrompt,\n\t\tcwd,\n\t\tcontextFiles: providedContextFiles,\n\t\tskills: providedSkills,\n\t} = options;\n\tconst promptCwd = cwd.replace(/\\\\/g, \"/\");\n\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\n\n\tconst contextFiles = providedContextFiles ?? [];\n\tconst skills = providedSkills ?? [];\n\n\tif (customPrompt) {\n\t\tlet prompt = customPrompt;\n\n\t\tif (appendSection) {\n\t\t\tprompt += appendSection;\n\t\t}\n\n\t\t// Append project context files\n\t\tif (contextFiles.length > 0) {\n\t\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t\t}\n\t\t\tprompt += \"</project_context>\\n\";\n\t\t}\n\n\t\t// Append skills section (only if read tool is available)\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\n\t\tif (customPromptHasRead && skills.length > 0) {\n\t\t\tprompt += formatSkillsForPrompt(skills);\n\t\t}\n\n\t\tprompt += `\\nCurrent working directory: ${promptCwd}\\n`;\n\n\t\treturn prompt;\n\t}\n\n\t// Get absolute paths to documentation and examples\n\tconst readmePath = getReadmePath();\n\tconst docsPath = getDocsPath();\n\tconst examplesPath = getExamplesPath();\n\n\t// Build tools list based on selected tools.\n\t// A tool appears in Available tools only when the caller provides a one-line snippet.\n\tconst tools = selectedTools || [\"read\", \"bash\", \"edit\", \"write\"];\n\tconst visibleTools = tools.filter((name) => !!toolSnippets?.[name]);\n\tconst toolsList =\n\t\tvisibleTools.length > 0 ? visibleTools.map((name) => `- ${name}: ${toolSnippets![name]}`).join(\"\\n\") : \"(none)\";\n\n\t// Build guidelines based on which tools are actually available\n\tconst guidelinesList: string[] = [];\n\tconst guidelinesSet = new Set<string>();\n\tconst addGuideline = (guideline: string): void => {\n\t\tif (guidelinesSet.has(guideline)) {\n\t\t\treturn;\n\t\t}\n\t\tguidelinesSet.add(guideline);\n\t\tguidelinesList.push(guideline);\n\t};\n\n\tconst hasBash = tools.includes(\"bash\");\n\tconst hasGrep = tools.includes(\"grep\");\n\tconst hasFind = tools.includes(\"find\");\n\tconst hasLs = tools.includes(\"ls\");\n\tconst hasRead = tools.includes(\"read\");\n\n\t// File exploration guidelines\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\n\t\taddGuideline(\"Use bash for file operations like ls, rg, find\");\n\t}\n\n\tfor (const guideline of promptGuidelines ?? []) {\n\t\tconst normalized = guideline.trim();\n\t\tif (normalized.length > 0) {\n\t\t\taddGuideline(normalized);\n\t\t}\n\t}\n\n\t// Always include these\n\taddGuideline(\"Be concise in your responses\");\n\taddGuideline(\"Show file paths clearly when working with files\");\n\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\n\n\t// La doctrina vive en `core/prompts/sistema.md` y se monta con plantillas\n\t// condicionales: cada sección existe SOLO si su capacidad existe. Antes aquí\n\t// había dos directrices («Be concise», «Show file paths clearly») y un bloque\n\t// sobre la documentación de Ada — y de las trece capacidades que habíamos\n\t// construido, NINGUNA aparecía. Ver `core/prompts/montar.ts`.\n\tlet prompt = `${montarPromptDelSistema({\n\t\tnombresDeHerramienta: tools,\n\t\tfrasesDeHerramienta: toolSnippets,\n\t\tmodoPlan: options.modoPlan === true,\n\t\ttoolsDenegadas: options.toolsDenegadas,\n\t})}\n\nAvailable tools:\n${toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n${guidelines ? `\\nProject guidelines:\\n${guidelines}\\n` : \"\"}\nAda documentation (read only when the user asks about ada itself, its SDK, extensions, themes, skills, or TUI; the Ada SDK API is the pi.* extension API for compatibility):\n- Main documentation: ${readmePath}\n- Additional docs: ${docsPath}\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading ada docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), ada packages (docs/packages.md), environment variables (docs/environment-variables.md)\n- When working on ada topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read ada .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\n\n\tif (appendSection) {\n\t\tprompt += appendSection;\n\t}\n\n\t// Append project context files\n\tif (contextFiles.length > 0) {\n\t\tprompt += \"\\n\\n<project_context>\\n\\n\";\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\n\t\tfor (const { path: filePath, content } of contextFiles) {\n\t\t\tprompt += `<project_instructions path=\"${filePath}\">\\n${content}\\n</project_instructions>\\n\\n`;\n\t\t}\n\t\tprompt += \"</project_context>\\n\";\n\t}\n\n\t// Append skills section (only if read tool is available)\n\tif (hasRead && skills.length > 0) {\n\t\tprompt += formatSkillsForPrompt(skills);\n\t}\n\n\tprompt += `\\nCurrent working directory: ${promptCwd}`;\n\n\treturn prompt;\n}\n"]}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"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"}

package/dist/core/telemetria/otlp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../../../src/core/telemetria/otlp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,iFAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,UAAU,CAAC;IACtD,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,eAAe,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC,CAAC;IACrG,MAAM,EAAE,MAAM,CAAC;CACf;AAqCD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CAmEzF;AA6DD,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAK7D;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAOzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CA8BrG;AAoCD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAwB7D;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAcvE","sourcesContent":["/**\n * OTLP que NO PUEDE filtrar contenido.\n *\n * La casilla que marca un comité de compras es «exporta a OpenTelemetry». Eso\n * lo tiene cualquiera: el contrato es un puñado de variables de entorno\n * (`OTEL_EXPORTER_OTLP_ENDPOINT` y compañía) y un JSON con una forma fija. Lo\n * que no tiene cualquiera es exportar SIN convertir el colector de\n * observabilidad del cliente en un tratamiento de datos personales que nadie ha\n * inventariado.\n *\n * El competidor trae una variable para capturar el CUERPO de los mensajes —el\n * patrón se llama `CAPTURE_MESSAGE_CONTENT` en la especificación de OTel para\n * GenAI—. Activarla mete prompts y respuestas del modelo en un almacén de\n * trazas: un segundo depósito de justo aquello que el RGPD manda minimizar, y\n * encima uno del que el DPO no suele saber nada porque lo administra el equipo\n * de plataforma.\n *\n * PROPIEDAD DE DISEÑO, y es lo que este módulo vende:\n *\n *   NO EXISTE en este fichero ninguna variable de entorno, opción, parámetro ni\n *   bandera que active la exportación de contenido. No es que venga apagada por\n *   defecto: es que no está. Una opción apagada la enciende alguien un martes;\n *   un mecanismo que no existe no se enciende.\n *\n * Hay una prueba que recorre el fuente de este módulo comprobándolo, con los\n * comentarios quitados —porque este párrafo nombra el patrón que persigue y si\n * no, se acusaría a sí misma—. Ver `test/otlp-sin-contenido.test.ts`.\n *\n * TRES CINTURONES, no uno:\n *\n *   1. `atributosDeSuceso` trabaja con una LISTA BLANCA explícita. Lo que no\n *      está, no sale. Es la misma regla que ya cumple `audit/libro.ts`: se\n *      registra la FORMA de lo que pasó, nunca su contenido.\n *   2. El descarte es CONTABLE. Sale en `ada.atributos_descartados`, para que\n *      «este suceso traía cinco claves que no exporto» sea un dato y no un\n *      silencio. Un filtro mudo es indistinguible de un filtro roto.\n *   3. `sinContenido` es la red por debajo: cualquier valor con salto de línea o\n *      más largo que 200 caracteres se cae aunque su clave esté en la lista.\n *      Sirve para el día en que alguien añada una clave sin pensarlo.\n *\n * LO QUE ESTE MÓDULO NO HACE. No envía nada. Construye el cuerpo y lo devuelve;\n * quien lo suba a un colector es otro, y así este fichero no tiene ninguna\n * salida a la red que auditar.\n */\n\nimport { createHash } from \"node:crypto\";\nimport type { EntradaDelLibro } from \"../audit/libro.ts\";\n\n/** Las tres señales del contrato OTLP. Se nombran en español como el resto. */\nexport type SenalOtlp = \"trazas\" | \"logs\" | \"metricas\";\n\nexport interface ConfiguracionOtlp {\n\testado: \"sin-configurar\" | \"configurada\" | \"invalida\";\n\tporSenal: Partial<Record<SenalOtlp, { endpoint: string; protocolo: \"http/protobuf\" | \"http/json\" }>>;\n\tmotivo: string;\n}\n\nconst SENALES: readonly SenalOtlp[] = [\"trazas\", \"logs\", \"metricas\"];\n\n/** Los dos únicos protocolos que este exportador sabe rendir. */\nconst PROTOCOLOS = [\"http/protobuf\", \"http/json\"] as const;\ntype Protocolo = (typeof PROTOCOLOS)[number];\n\n/**\n * El contrato estándar, tal cual. Los nombres son los de OpenTelemetry y no se\n * traducen: son lo que un comité de compras busca en la documentación.\n */\nconst VARIABLE_ENDPOINT_BASE = \"OTEL_EXPORTER_OTLP_ENDPOINT\";\nconst VARIABLE_PROTOCOLO_BASE = \"OTEL_EXPORTER_OTLP_PROTOCOL\";\nconst VARIABLES_POR_SENAL: Record<SenalOtlp, { endpoint: string; protocolo: string }> = {\n\ttrazas: { endpoint: \"OTEL_EXPORTER_OTLP_TRACES_ENDPOINT\", protocolo: \"OTEL_EXPORTER_OTLP_TRACES_PROTOCOL\" },\n\tlogs: { endpoint: \"OTEL_EXPORTER_OTLP_LOGS_ENDPOINT\", protocolo: \"OTEL_EXPORTER_OTLP_LOGS_PROTOCOL\" },\n\tmetricas: { endpoint: \"OTEL_EXPORTER_OTLP_METRICS_ENDPOINT\", protocolo: \"OTEL_EXPORTER_OTLP_METRICS_PROTOCOL\" },\n};\n\n/** Una variable vacía o con solo espacios cuenta como no puesta. */\nfunction valor(env: NodeJS.ProcessEnv, nombre: string): string | undefined {\n\tconst crudo = env[nombre];\n\tif (typeof crudo !== \"string\") return undefined;\n\tconst limpio = crudo.trim();\n\treturn limpio === \"\" ? undefined : limpio;\n}\n\nfunction esUrlHttp(candidato: string): boolean {\n\ttry {\n\t\tconst url = new URL(candidato);\n\t\treturn url.protocol === \"http:\" || url.protocol === \"https:\";\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Lee la configuración del entorno, con TRES estados y sin inventarse nada.\n *\n * La base (`OTEL_EXPORTER_OTLP_ENDPOINT` / `_PROTOCOL`) vale para las tres\n * señales; la variable específica de una señal la sobreescribe.\n *\n * Lo que NO hace, y es deliberado: no cae a `http/protobuf` cuando falta el\n * protocolo, aunque sea el defecto de la especificación. Un endpoint sin\n * protocolo declarado sale como `invalida`. El motivo es el de siempre: elegir\n * en silencio por el operador convierte un despiste suyo en una configuración\n * nuestra, y el día que el colector no reciba nada nadie sabrá por qué.\n */\nexport function configuracionOtlp(env: NodeJS.ProcessEnv = process.env): ConfiguracionOtlp {\n\tconst endpointBase = valor(env, VARIABLE_ENDPOINT_BASE);\n\tconst protocoloBase = valor(env, VARIABLE_PROTOCOLO_BASE);\n\n\tconst porSenal: ConfiguracionOtlp[\"porSenal\"] = {};\n\tconst problemas: string[] = [];\n\t/** Señales con protocolo declarado y ningún endpoint donde mandarlo. */\n\tconst protocoloHuerfano: SenalOtlp[] = [];\n\n\tfor (const senal of SENALES) {\n\t\tconst variables = VARIABLES_POR_SENAL[senal];\n\t\tconst endpoint = valor(env, variables.endpoint) ?? endpointBase;\n\t\tconst protocolo = valor(env, variables.protocolo) ?? protocoloBase;\n\n\t\tif (endpoint === undefined) {\n\t\t\tif (protocolo !== undefined) protocoloHuerfano.push(senal);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!esUrlHttp(endpoint)) {\n\t\t\tproblemas.push(`${senal}: el endpoint recibido (${endpoint}) no es una URL http:// ni https://`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (protocolo === undefined) {\n\t\t\tproblemas.push(\n\t\t\t\t`${senal}: hay endpoint (${endpoint}) y ningun protocolo declarado; ` +\n\t\t\t\t\t`declara ${variables.protocolo} o ${VARIABLE_PROTOCOLO_BASE} con ${PROTOCOLOS.join(\" o \")} ` +\n\t\t\t\t\t\"(no se asume ninguno por defecto)\",\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!(PROTOCOLOS as readonly string[]).includes(protocolo)) {\n\t\t\tproblemas.push(\n\t\t\t\t`${senal}: el protocolo recibido (${protocolo}) no es valido; los unicos validos son ${PROTOCOLOS.join(\" y \")}`,\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tporSenal[senal] = { endpoint, protocolo: protocolo as Protocolo };\n\t}\n\n\t// Una señal mal configurada NO entra en `porSenal`: quien lea esto no puede\n\t// acabar exportando a un sitio que no supimos validar.\n\tif (problemas.length > 0) {\n\t\treturn { estado: \"invalida\", porSenal, motivo: problemas.join(\"; \") };\n\t}\n\n\tconst configuradas = Object.keys(porSenal) as SenalOtlp[];\n\tif (configuradas.length > 0) {\n\t\tconst detalle = configuradas.map((s) => `${s} -> ${porSenal[s]?.endpoint} (${porSenal[s]?.protocolo})`);\n\t\treturn { estado: \"configurada\", porSenal, motivo: `exportacion OTLP activa para ${detalle.join(\", \")}` };\n\t}\n\n\t// El tercer estado se dice entero: «no hay endpoint» y «hay protocolo pero\n\t// no hay endpoint» son dos situaciones distintas para quien la está montando.\n\tif (protocoloHuerfano.length > 0) {\n\t\treturn {\n\t\t\testado: \"sin-configurar\",\n\t\t\tporSenal,\n\t\t\tmotivo:\n\t\t\t\t`hay protocolo declarado para ${protocoloHuerfano.join(\", \")} pero ningun endpoint: ` +\n\t\t\t\t`sin ${VARIABLE_ENDPOINT_BASE} (o el especifico de la senal) no hay nada que exportar`,\n\t\t};\n\t}\n\treturn {\n\t\testado: \"sin-configurar\",\n\t\tporSenal,\n\t\tmotivo: `no hay ninguna variable ${VARIABLE_ENDPOINT_BASE} en el entorno: la exportacion OTLP esta apagada`,\n\t};\n}\n\n/**\n * LA LISTA BLANCA. Clave del suceso -> nombre del atributo OTLP.\n *\n * Todo lo que hay aquí es FORMA: qué pasó, con qué herramienta, cómo acabó,\n * cuánto ocupó. Nada de aquí puede llevar texto del usuario.\n *\n * Lo que NO está, y no por olvido:\n *\n *   · `argv` — el texto del comando. Es la clave más golosa y la que más caro\n *     sale: un comando lleva rutas, nombres de cliente y a veces un secreto\n *     pegado en la línea.\n *   · `ruta` — la ruta completa del fichero. El nombre de un fichero ya es un\n *     dato: `/casos/2024/despido-<nombre>.docx` identifica a una persona sin\n *     que haga falta abrirlo. Del fichero salen sus hashes y nada más.\n *   · `motivo` — texto libre de la política. Hoy son frases nuestras; mañana\n *     alguien mete ahí lo que el modelo dijo.\n *   · `extension` — ruta en disco de la extensión, mismo argumento que `ruta`.\n *   · `violaciones` — lista de texto libre del sandbox.\n *\n * Y nunca, en ninguna versión: el prompt, la respuesta del modelo o el\n * contenido de un fichero. No hay clave en `SucesoDeSesion` que los lleve, y\n * este módulo existe para que siga sin haberla.\n */\nconst LISTA_BLANCA: Readonly<Record<string, string>> = {\n\ttipo: \"ada.suceso.tipo\",\n\t// tool\n\tnombre: \"ada.tool.nombre\",\n\tok: \"ada.tool.ok\",\n\tdecision: \"ada.permiso.veredicto\",\n\t// comando\n\tcodigo: \"ada.comando.codigo\",\n\tsandbox: \"ada.comando.encierro\",\n\torigen: \"ada.comando.origen\",\n\t// modelo\n\tproveedor: \"ada.modelo.proveedor\",\n\tmodelo: \"ada.modelo.nombre\",\n\tentrada: \"ada.modelo.tokens_entrada\",\n\tsalida: \"ada.modelo.tokens_salida\",\n\tmotivoParada: \"ada.modelo.motivo_parada\",\n\t// fichero: solo los hashes, jamás la ruta\n\tantes: \"ada.fichero.hash_antes\",\n\tdespues: \"ada.fichero.hash_despues\",\n\ttool: \"ada.fichero.tool\",\n\t// red: el dominio, nunca la ruta ni los parametros (ahi viajan los tokens)\n\tdominio: \"ada.red.dominio\",\n\tpermitido: \"ada.red.permitido\",\n\t// credenciales: el identificador, jamas el valor\n\taccion: \"ada.credencial.accion\",\n\tcredencialId: \"ada.credencial.id\",\n\tresultado: \"ada.credencial.resultado\",\n\t// purga por retencion\n\tpolitica: \"ada.politica.nombre\",\n\tentradas: \"ada.purga.entradas\",\n\thashDeCierre: \"ada.purga.hash_de_cierre\",\n\t// medidas genericas, si el suceso las trae\n\tbytes: \"ada.bytes\",\n\tduracionMs: \"ada.duracion_ms\",\n};\n\n/** Nombre del contador de descartes. Se expone porque las pruebas lo miran. */\nexport const CLAVE_DESCARTADOS = \"ada.atributos_descartados\";\n\n/** Un valor de cadena más largo que esto ya no es forma: es texto. */\nconst LARGO_MAXIMO = 200;\n\n/**\n * Las claves sospechosas de llevar texto libre.\n *\n * Dos señales, las dos baratas y las dos difíciles de fingir por un dato de\n * forma: un salto de línea (un hash no los tiene, un diff sí) y una longitud\n * que ningún identificador nuestro alcanza.\n *\n * Es un cinturón POR ENCIMA de la lista blanca, no un sustituto. Sola dejaría\n * pasar una ruta de 40 caracteres; la lista blanca sola dejaría pasar lo que\n * alguien añada mañana sin pensarlo. Hacen falta las dos.\n */\nexport function sinContenido(atributos: Record<string, unknown>): string[] {\n\tconst sospechosas: string[] = [];\n\tfor (const [clave, valorDelAtributo] of Object.entries(atributos)) {\n\t\tif (typeof valorDelAtributo !== \"string\") continue;\n\t\tif (valorDelAtributo.length > LARGO_MAXIMO || /[\\r\\n]/.test(valorDelAtributo)) sospechosas.push(clave);\n\t}\n\treturn sospechosas;\n}\n\n/**\n * Los atributos de un suceso, filtrados y con el descarte contado.\n *\n * `ada.atributos_descartados` cuenta lo que se quedó fuera: claves que no están\n * en la lista blanca, claves cuyo valor no es un escalar exportable y claves\n * que `sinContenido` marcó. Sin ese número, un filtro que se comiera todo y un\n * suceso que no traía nada darían el mismo span.\n *\n * Una clave de la lista blanca con valor `null` no cuenta como descarte y no\n * sale: en el libro `null` significa «el fichero no existía» o «no había\n * credencial activa», y un atributo ausente en OTLP significa exactamente eso.\n */\nexport function atributosDeSuceso(entrada: EntradaDelLibro): Record<string, string | number | boolean> {\n\tconst candidatos: Record<string, string | number | boolean> = {\n\t\t\"ada.sesion\": entrada.sesion,\n\t\t\"ada.seq\": entrada.seq,\n\t};\n\tlet descartados = 0;\n\n\tfor (const [clave, valorCrudo] of Object.entries(entrada.suceso ?? {})) {\n\t\tconst nombre = LISTA_BLANCA[clave];\n\t\tif (nombre === undefined) {\n\t\t\tdescartados++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (valorCrudo === null || valorCrudo === undefined) continue;\n\t\tif (typeof valorCrudo !== \"string\" && typeof valorCrudo !== \"number\" && typeof valorCrudo !== \"boolean\") {\n\t\t\t// Un objeto o un array en una clave blanca: no se aplana ni se\n\t\t\t// serializa, porque serializar es justo por donde entraría el texto.\n\t\t\tdescartados++;\n\t\t\tcontinue;\n\t\t}\n\t\tcandidatos[nombre] = valorCrudo;\n\t}\n\n\tfor (const clave of sinContenido(candidatos)) {\n\t\tdelete candidatos[clave];\n\t\tdescartados++;\n\t}\n\n\tcandidatos[CLAVE_DESCARTADOS] = descartados;\n\treturn candidatos;\n}\n\n/** Un identificador hexadecimal derivado del suceso, estable entre procesos. */\nfunction hex(material: string, bytes: number): string {\n\treturn createHash(\"sha256\")\n\t\t.update(material)\n\t\t.digest(\"hex\")\n\t\t.slice(0, bytes * 2);\n}\n\n/** El atributo tal y como lo espera OTLP/JSON: clave y valor etiquetado. */\nfunction atributoOtlp(clave: string, valorDelAtributo: string | number | boolean): object {\n\tif (typeof valorDelAtributo === \"boolean\") return { key: clave, value: { boolValue: valorDelAtributo } };\n\tif (typeof valorDelAtributo === \"number\") {\n\t\treturn Number.isInteger(valorDelAtributo)\n\t\t\t? { key: clave, value: { intValue: String(valorDelAtributo) } }\n\t\t\t: { key: clave, value: { doubleValue: valorDelAtributo } };\n\t}\n\treturn { key: clave, value: { stringValue: valorDelAtributo } };\n}\n\n/** Códigos de `SpanKind` de OTLP. Solo se usan estos dos. */\nconst SPAN_KIND_INTERNAL = 1;\nconst SPAN_KIND_CLIENT = 3;\n/** Códigos de `StatusCode`: 0 sin fijar, 2 error. El 1 (`OK`) se reserva. */\nconst STATUS_UNSET = 0;\nconst STATUS_ERROR = 2;\n\n/** ¿El suceso terminó mal? Se mira la forma, nunca el texto del error. */\nfunction fueError(suceso: Record<string, unknown>): boolean {\n\tif (suceso.ok === false) return true;\n\tif (typeof suceso.codigo === \"number\" && suceso.codigo !== 0) return true;\n\tif (suceso.permitido === false) return true;\n\treturn false;\n}\n\n/**\n * Un span de OTLP a partir de una entrada del libro.\n *\n * `traceId` sale de la sesión y `spanId` de la sesión más el número de\n * secuencia: los sucesos de una misma sesión cuelgan de la misma traza sin que\n * haya que guardar estado en ningún sitio, y dos procesos que exporten el mismo\n * libro producen los mismos identificadores en vez de duplicar la traza.\n *\n * Si el sello de tiempo no se puede leer, los dos tiempos van a cero y el span\n * lo dice en `ada.sello_ilegible`. Poner la hora actual sería inventarse un\n * dato: en un registro de cumplimiento, una hora inventada es peor que un cero.\n */\nexport function spanDeSuceso(entrada: EntradaDelLibro): object {\n\tconst suceso = (entrada.suceso ?? {}) as Record<string, unknown>;\n\tconst tipo = typeof suceso.tipo === \"string\" ? suceso.tipo : \"desconocido\";\n\tconst atributos = atributosDeSuceso(entrada);\n\n\tconst milis = Date.parse(entrada.ts);\n\tconst ilegible = Number.isNaN(milis);\n\tif (ilegible) atributos[\"ada.sello_ilegible\"] = true;\n\tconst inicio = ilegible ? 0n : BigInt(milis) * 1_000_000n;\n\tconst duracion =\n\t\ttypeof suceso.duracionMs === \"number\" && suceso.duracionMs > 0 ? BigInt(Math.round(suceso.duracionMs)) : 0n;\n\n\treturn {\n\t\ttraceId: hex(`traza:${entrada.sesion}`, 16),\n\t\tspanId: hex(`span:${entrada.sesion}:${entrada.seq}`, 8),\n\t\tname: `ada.${tipo}`,\n\t\tkind: tipo === \"red\" || tipo === \"modelo\" ? SPAN_KIND_CLIENT : SPAN_KIND_INTERNAL,\n\t\tstartTimeUnixNano: String(inicio),\n\t\tendTimeUnixNano: String(inicio + duracion * 1_000_000n),\n\t\tattributes: Object.entries(atributos).map(([clave, v]) => atributoOtlp(clave, v)),\n\t\t// El estado va sin `message`: el texto de un error es contenido, y este\n\t\t// es el hueco por donde se colaria.\n\t\tstatus: { code: fueError(suceso) ? STATUS_ERROR : STATUS_UNSET },\n\t};\n}\n\n/** Lo que se anuncia como productor de las trazas. Nada de esto es un dato del usuario. */\nconst RECURSO: readonly (readonly [string, string])[] = [\n\t[\"service.name\", \"ada\"],\n\t[\"telemetry.sdk.name\", \"ada-libro-de-sesion\"],\n\t[\"telemetry.sdk.language\", \"nodejs\"],\n];\n\n/**\n * El cuerpo `ResourceSpans` de OTLP/JSON, listo para que otro lo suba.\n *\n * La forma es la del estándar y no se improvisa:\n * `resourceSpans[] -> scopeSpans[] -> spans[]`, con `traceId` y `spanId` en\n * hexadecimal y los tiempos en nanosegundos desde epoch como cadena, porque son\n * enteros de 64 bits y un `number` de JavaScript no los sostiene.\n *\n * Una lista vacía devuelve un cuerpo con cero spans y NO un cuerpo vacío: el\n * colector tiene que poder distinguir «esta sesión no tuvo sucesos» de «no se\n * exportó nada».\n */\nexport function cuerpoOtlp(entradas: readonly EntradaDelLibro[]): object {\n\treturn {\n\t\tresourceSpans: [\n\t\t\t{\n\t\t\t\tresource: { attributes: RECURSO.map(([clave, v]) => atributoOtlp(clave, v)) },\n\t\t\t\tscopeSpans: [\n\t\t\t\t\t{\n\t\t\t\t\t\tscope: { name: \"ada.core.audit.libro\", version: \"1\" },\n\t\t\t\t\t\tspans: entradas.map(spanDeSuceso),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n}\n"]}
+{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../../../src/core/telemetria/otlp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,UAAU,CAAC;IACtD,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,eAAe,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC,CAAC;IACrG,MAAM,EAAE,MAAM,CAAC;CACf;AAqCD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CAmEzF;AA6DD,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAK7D;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAOzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CA8BrG;AAoCD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAwB7D;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAcvE"}

package/dist/core/telemetria/otlp.js.map

@@ -1 +1 @@
-{"version":3,"file":"otlp.js","sourceRoot":"","sources":["../../../src/core/telemetria/otlp.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * OTLP que NO PUEDE filtrar contenido.\n *\n * La casilla que marca un comité de compras es «exporta a OpenTelemetry». Eso\n * lo tiene cualquiera: el contrato es un puñado de variables de entorno\n * (`OTEL_EXPORTER_OTLP_ENDPOINT` y compañía) y un JSON con una forma fija. Lo\n * que no tiene cualquiera es exportar SIN convertir el colector de\n * observabilidad del cliente en un tratamiento de datos personales que nadie ha\n * inventariado.\n *\n * El competidor trae una variable para capturar el CUERPO de los mensajes —el\n * patrón se llama `CAPTURE_MESSAGE_CONTENT` en la especificación de OTel para\n * GenAI—. Activarla mete prompts y respuestas del modelo en un almacén de\n * trazas: un segundo depósito de justo aquello que el RGPD manda minimizar, y\n * encima uno del que el DPO no suele saber nada porque lo administra el equipo\n * de plataforma.\n *\n * PROPIEDAD DE DISEÑO, y es lo que este módulo vende:\n *\n *   NO EXISTE en este fichero ninguna variable de entorno, opción, parámetro ni\n *   bandera que active la exportación de contenido. No es que venga apagada por\n *   defecto: es que no está. Una opción apagada la enciende alguien un martes;\n *   un mecanismo que no existe no se enciende.\n *\n * Hay una prueba que recorre el fuente de este módulo comprobándolo, con los\n * comentarios quitados —porque este párrafo nombra el patrón que persigue y si\n * no, se acusaría a sí misma—. Ver `test/otlp-sin-contenido.test.ts`.\n *\n * TRES CINTURONES, no uno:\n *\n *   1. `atributosDeSuceso` trabaja con una LISTA BLANCA explícita. Lo que no\n *      está, no sale. Es la misma regla que ya cumple `audit/libro.ts`: se\n *      registra la FORMA de lo que pasó, nunca su contenido.\n *   2. El descarte es CONTABLE. Sale en `ada.atributos_descartados`, para que\n *      «este suceso traía cinco claves que no exporto» sea un dato y no un\n *      silencio. Un filtro mudo es indistinguible de un filtro roto.\n *   3. `sinContenido` es la red por debajo: cualquier valor con salto de línea o\n *      más largo que 200 caracteres se cae aunque su clave esté en la lista.\n *      Sirve para el día en que alguien añada una clave sin pensarlo.\n *\n * LO QUE ESTE MÓDULO NO HACE. No envía nada. Construye el cuerpo y lo devuelve;\n * quien lo suba a un colector es otro, y así este fichero no tiene ninguna\n * salida a la red que auditar.\n */\n\nimport { createHash } from \"node:crypto\";\nimport type { EntradaDelLibro } from \"../audit/libro.ts\";\n\n/** Las tres señales del contrato OTLP. Se nombran en español como el resto. */\nexport type SenalOtlp = \"trazas\" | \"logs\" | \"metricas\";\n\nexport interface ConfiguracionOtlp {\n\testado: \"sin-configurar\" | \"configurada\" | \"invalida\";\n\tporSenal: Partial<Record<SenalOtlp, { endpoint: string; protocolo: \"http/protobuf\" | \"http/json\" }>>;\n\tmotivo: string;\n}\n\nconst SENALES: readonly SenalOtlp[] = [\"trazas\", \"logs\", \"metricas\"];\n\n/** Los dos únicos protocolos que este exportador sabe rendir. */\nconst PROTOCOLOS = [\"http/protobuf\", \"http/json\"] as const;\ntype Protocolo = (typeof PROTOCOLOS)[number];\n\n/**\n * El contrato estándar, tal cual. Los nombres son los de OpenTelemetry y no se\n * traducen: son lo que un comité de compras busca en la documentación.\n */\nconst VARIABLE_ENDPOINT_BASE = \"OTEL_EXPORTER_OTLP_ENDPOINT\";\nconst VARIABLE_PROTOCOLO_BASE = \"OTEL_EXPORTER_OTLP_PROTOCOL\";\nconst VARIABLES_POR_SENAL: Record<SenalOtlp, { endpoint: string; protocolo: string }> = {\n\ttrazas: { endpoint: \"OTEL_EXPORTER_OTLP_TRACES_ENDPOINT\", protocolo: \"OTEL_EXPORTER_OTLP_TRACES_PROTOCOL\" },\n\tlogs: { endpoint: \"OTEL_EXPORTER_OTLP_LOGS_ENDPOINT\", protocolo: \"OTEL_EXPORTER_OTLP_LOGS_PROTOCOL\" },\n\tmetricas: { endpoint: \"OTEL_EXPORTER_OTLP_METRICS_ENDPOINT\", protocolo: \"OTEL_EXPORTER_OTLP_METRICS_PROTOCOL\" },\n};\n\n/** Una variable vacía o con solo espacios cuenta como no puesta. */\nfunction valor(env: NodeJS.ProcessEnv, nombre: string): string | undefined {\n\tconst crudo = env[nombre];\n\tif (typeof crudo !== \"string\") return undefined;\n\tconst limpio = crudo.trim();\n\treturn limpio === \"\" ? undefined : limpio;\n}\n\nfunction esUrlHttp(candidato: string): boolean {\n\ttry {\n\t\tconst url = new URL(candidato);\n\t\treturn url.protocol === \"http:\" || url.protocol === \"https:\";\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Lee la configuración del entorno, con TRES estados y sin inventarse nada.\n *\n * La base (`OTEL_EXPORTER_OTLP_ENDPOINT` / `_PROTOCOL`) vale para las tres\n * señales; la variable específica de una señal la sobreescribe.\n *\n * Lo que NO hace, y es deliberado: no cae a `http/protobuf` cuando falta el\n * protocolo, aunque sea el defecto de la especificación. Un endpoint sin\n * protocolo declarado sale como `invalida`. El motivo es el de siempre: elegir\n * en silencio por el operador convierte un despiste suyo en una configuración\n * nuestra, y el día que el colector no reciba nada nadie sabrá por qué.\n */\nexport function configuracionOtlp(env: NodeJS.ProcessEnv = process.env): ConfiguracionOtlp {\n\tconst endpointBase = valor(env, VARIABLE_ENDPOINT_BASE);\n\tconst protocoloBase = valor(env, VARIABLE_PROTOCOLO_BASE);\n\n\tconst porSenal: ConfiguracionOtlp[\"porSenal\"] = {};\n\tconst problemas: string[] = [];\n\t/** Señales con protocolo declarado y ningún endpoint donde mandarlo. */\n\tconst protocoloHuerfano: SenalOtlp[] = [];\n\n\tfor (const senal of SENALES) {\n\t\tconst variables = VARIABLES_POR_SENAL[senal];\n\t\tconst endpoint = valor(env, variables.endpoint) ?? endpointBase;\n\t\tconst protocolo = valor(env, variables.protocolo) ?? protocoloBase;\n\n\t\tif (endpoint === undefined) {\n\t\t\tif (protocolo !== undefined) protocoloHuerfano.push(senal);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!esUrlHttp(endpoint)) {\n\t\t\tproblemas.push(`${senal}: el endpoint recibido (${endpoint}) no es una URL http:// ni https://`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (protocolo === undefined) {\n\t\t\tproblemas.push(\n\t\t\t\t`${senal}: hay endpoint (${endpoint}) y ningun protocolo declarado; ` +\n\t\t\t\t\t`declara ${variables.protocolo} o ${VARIABLE_PROTOCOLO_BASE} con ${PROTOCOLOS.join(\" o \")} ` +\n\t\t\t\t\t\"(no se asume ninguno por defecto)\",\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!(PROTOCOLOS as readonly string[]).includes(protocolo)) {\n\t\t\tproblemas.push(\n\t\t\t\t`${senal}: el protocolo recibido (${protocolo}) no es valido; los unicos validos son ${PROTOCOLOS.join(\" y \")}`,\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tporSenal[senal] = { endpoint, protocolo: protocolo as Protocolo };\n\t}\n\n\t// Una señal mal configurada NO entra en `porSenal`: quien lea esto no puede\n\t// acabar exportando a un sitio que no supimos validar.\n\tif (problemas.length > 0) {\n\t\treturn { estado: \"invalida\", porSenal, motivo: problemas.join(\"; \") };\n\t}\n\n\tconst configuradas = Object.keys(porSenal) as SenalOtlp[];\n\tif (configuradas.length > 0) {\n\t\tconst detalle = configuradas.map((s) => `${s} -> ${porSenal[s]?.endpoint} (${porSenal[s]?.protocolo})`);\n\t\treturn { estado: \"configurada\", porSenal, motivo: `exportacion OTLP activa para ${detalle.join(\", \")}` };\n\t}\n\n\t// El tercer estado se dice entero: «no hay endpoint» y «hay protocolo pero\n\t// no hay endpoint» son dos situaciones distintas para quien la está montando.\n\tif (protocoloHuerfano.length > 0) {\n\t\treturn {\n\t\t\testado: \"sin-configurar\",\n\t\t\tporSenal,\n\t\t\tmotivo:\n\t\t\t\t`hay protocolo declarado para ${protocoloHuerfano.join(\", \")} pero ningun endpoint: ` +\n\t\t\t\t`sin ${VARIABLE_ENDPOINT_BASE} (o el especifico de la senal) no hay nada que exportar`,\n\t\t};\n\t}\n\treturn {\n\t\testado: \"sin-configurar\",\n\t\tporSenal,\n\t\tmotivo: `no hay ninguna variable ${VARIABLE_ENDPOINT_BASE} en el entorno: la exportacion OTLP esta apagada`,\n\t};\n}\n\n/**\n * LA LISTA BLANCA. Clave del suceso -> nombre del atributo OTLP.\n *\n * Todo lo que hay aquí es FORMA: qué pasó, con qué herramienta, cómo acabó,\n * cuánto ocupó. Nada de aquí puede llevar texto del usuario.\n *\n * Lo que NO está, y no por olvido:\n *\n *   · `argv` — el texto del comando. Es la clave más golosa y la que más caro\n *     sale: un comando lleva rutas, nombres de cliente y a veces un secreto\n *     pegado en la línea.\n *   · `ruta` — la ruta completa del fichero. El nombre de un fichero ya es un\n *     dato: `/casos/2024/despido-<nombre>.docx` identifica a una persona sin\n *     que haga falta abrirlo. Del fichero salen sus hashes y nada más.\n *   · `motivo` — texto libre de la política. Hoy son frases nuestras; mañana\n *     alguien mete ahí lo que el modelo dijo.\n *   · `extension` — ruta en disco de la extensión, mismo argumento que `ruta`.\n *   · `violaciones` — lista de texto libre del sandbox.\n *\n * Y nunca, en ninguna versión: el prompt, la respuesta del modelo o el\n * contenido de un fichero. No hay clave en `SucesoDeSesion` que los lleve, y\n * este módulo existe para que siga sin haberla.\n */\nconst LISTA_BLANCA: Readonly<Record<string, string>> = {\n\ttipo: \"ada.suceso.tipo\",\n\t// tool\n\tnombre: \"ada.tool.nombre\",\n\tok: \"ada.tool.ok\",\n\tdecision: \"ada.permiso.veredicto\",\n\t// comando\n\tcodigo: \"ada.comando.codigo\",\n\tsandbox: \"ada.comando.encierro\",\n\torigen: \"ada.comando.origen\",\n\t// modelo\n\tproveedor: \"ada.modelo.proveedor\",\n\tmodelo: \"ada.modelo.nombre\",\n\tentrada: \"ada.modelo.tokens_entrada\",\n\tsalida: \"ada.modelo.tokens_salida\",\n\tmotivoParada: \"ada.modelo.motivo_parada\",\n\t// fichero: solo los hashes, jamás la ruta\n\tantes: \"ada.fichero.hash_antes\",\n\tdespues: \"ada.fichero.hash_despues\",\n\ttool: \"ada.fichero.tool\",\n\t// red: el dominio, nunca la ruta ni los parametros (ahi viajan los tokens)\n\tdominio: \"ada.red.dominio\",\n\tpermitido: \"ada.red.permitido\",\n\t// credenciales: el identificador, jamas el valor\n\taccion: \"ada.credencial.accion\",\n\tcredencialId: \"ada.credencial.id\",\n\tresultado: \"ada.credencial.resultado\",\n\t// purga por retencion\n\tpolitica: \"ada.politica.nombre\",\n\tentradas: \"ada.purga.entradas\",\n\thashDeCierre: \"ada.purga.hash_de_cierre\",\n\t// medidas genericas, si el suceso las trae\n\tbytes: \"ada.bytes\",\n\tduracionMs: \"ada.duracion_ms\",\n};\n\n/** Nombre del contador de descartes. Se expone porque las pruebas lo miran. */\nexport const CLAVE_DESCARTADOS = \"ada.atributos_descartados\";\n\n/** Un valor de cadena más largo que esto ya no es forma: es texto. */\nconst LARGO_MAXIMO = 200;\n\n/**\n * Las claves sospechosas de llevar texto libre.\n *\n * Dos señales, las dos baratas y las dos difíciles de fingir por un dato de\n * forma: un salto de línea (un hash no los tiene, un diff sí) y una longitud\n * que ningún identificador nuestro alcanza.\n *\n * Es un cinturón POR ENCIMA de la lista blanca, no un sustituto. Sola dejaría\n * pasar una ruta de 40 caracteres; la lista blanca sola dejaría pasar lo que\n * alguien añada mañana sin pensarlo. Hacen falta las dos.\n */\nexport function sinContenido(atributos: Record<string, unknown>): string[] {\n\tconst sospechosas: string[] = [];\n\tfor (const [clave, valorDelAtributo] of Object.entries(atributos)) {\n\t\tif (typeof valorDelAtributo !== \"string\") continue;\n\t\tif (valorDelAtributo.length > LARGO_MAXIMO || /[\\r\\n]/.test(valorDelAtributo)) sospechosas.push(clave);\n\t}\n\treturn sospechosas;\n}\n\n/**\n * Los atributos de un suceso, filtrados y con el descarte contado.\n *\n * `ada.atributos_descartados` cuenta lo que se quedó fuera: claves que no están\n * en la lista blanca, claves cuyo valor no es un escalar exportable y claves\n * que `sinContenido` marcó. Sin ese número, un filtro que se comiera todo y un\n * suceso que no traía nada darían el mismo span.\n *\n * Una clave de la lista blanca con valor `null` no cuenta como descarte y no\n * sale: en el libro `null` significa «el fichero no existía» o «no había\n * credencial activa», y un atributo ausente en OTLP significa exactamente eso.\n */\nexport function atributosDeSuceso(entrada: EntradaDelLibro): Record<string, string | number | boolean> {\n\tconst candidatos: Record<string, string | number | boolean> = {\n\t\t\"ada.sesion\": entrada.sesion,\n\t\t\"ada.seq\": entrada.seq,\n\t};\n\tlet descartados = 0;\n\n\tfor (const [clave, valorCrudo] of Object.entries(entrada.suceso ?? {})) {\n\t\tconst nombre = LISTA_BLANCA[clave];\n\t\tif (nombre === undefined) {\n\t\t\tdescartados++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (valorCrudo === null || valorCrudo === undefined) continue;\n\t\tif (typeof valorCrudo !== \"string\" && typeof valorCrudo !== \"number\" && typeof valorCrudo !== \"boolean\") {\n\t\t\t// Un objeto o un array en una clave blanca: no se aplana ni se\n\t\t\t// serializa, porque serializar es justo por donde entraría el texto.\n\t\t\tdescartados++;\n\t\t\tcontinue;\n\t\t}\n\t\tcandidatos[nombre] = valorCrudo;\n\t}\n\n\tfor (const clave of sinContenido(candidatos)) {\n\t\tdelete candidatos[clave];\n\t\tdescartados++;\n\t}\n\n\tcandidatos[CLAVE_DESCARTADOS] = descartados;\n\treturn candidatos;\n}\n\n/** Un identificador hexadecimal derivado del suceso, estable entre procesos. */\nfunction hex(material: string, bytes: number): string {\n\treturn createHash(\"sha256\")\n\t\t.update(material)\n\t\t.digest(\"hex\")\n\t\t.slice(0, bytes * 2);\n}\n\n/** El atributo tal y como lo espera OTLP/JSON: clave y valor etiquetado. */\nfunction atributoOtlp(clave: string, valorDelAtributo: string | number | boolean): object {\n\tif (typeof valorDelAtributo === \"boolean\") return { key: clave, value: { boolValue: valorDelAtributo } };\n\tif (typeof valorDelAtributo === \"number\") {\n\t\treturn Number.isInteger(valorDelAtributo)\n\t\t\t? { key: clave, value: { intValue: String(valorDelAtributo) } }\n\t\t\t: { key: clave, value: { doubleValue: valorDelAtributo } };\n\t}\n\treturn { key: clave, value: { stringValue: valorDelAtributo } };\n}\n\n/** Códigos de `SpanKind` de OTLP. Solo se usan estos dos. */\nconst SPAN_KIND_INTERNAL = 1;\nconst SPAN_KIND_CLIENT = 3;\n/** Códigos de `StatusCode`: 0 sin fijar, 2 error. El 1 (`OK`) se reserva. */\nconst STATUS_UNSET = 0;\nconst STATUS_ERROR = 2;\n\n/** ¿El suceso terminó mal? Se mira la forma, nunca el texto del error. */\nfunction fueError(suceso: Record<string, unknown>): boolean {\n\tif (suceso.ok === false) return true;\n\tif (typeof suceso.codigo === \"number\" && suceso.codigo !== 0) return true;\n\tif (suceso.permitido === false) return true;\n\treturn false;\n}\n\n/**\n * Un span de OTLP a partir de una entrada del libro.\n *\n * `traceId` sale de la sesión y `spanId` de la sesión más el número de\n * secuencia: los sucesos de una misma sesión cuelgan de la misma traza sin que\n * haya que guardar estado en ningún sitio, y dos procesos que exporten el mismo\n * libro producen los mismos identificadores en vez de duplicar la traza.\n *\n * Si el sello de tiempo no se puede leer, los dos tiempos van a cero y el span\n * lo dice en `ada.sello_ilegible`. Poner la hora actual sería inventarse un\n * dato: en un registro de cumplimiento, una hora inventada es peor que un cero.\n */\nexport function spanDeSuceso(entrada: EntradaDelLibro): object {\n\tconst suceso = (entrada.suceso ?? {}) as Record<string, unknown>;\n\tconst tipo = typeof suceso.tipo === \"string\" ? suceso.tipo : \"desconocido\";\n\tconst atributos = atributosDeSuceso(entrada);\n\n\tconst milis = Date.parse(entrada.ts);\n\tconst ilegible = Number.isNaN(milis);\n\tif (ilegible) atributos[\"ada.sello_ilegible\"] = true;\n\tconst inicio = ilegible ? 0n : BigInt(milis) * 1_000_000n;\n\tconst duracion =\n\t\ttypeof suceso.duracionMs === \"number\" && suceso.duracionMs > 0 ? BigInt(Math.round(suceso.duracionMs)) : 0n;\n\n\treturn {\n\t\ttraceId: hex(`traza:${entrada.sesion}`, 16),\n\t\tspanId: hex(`span:${entrada.sesion}:${entrada.seq}`, 8),\n\t\tname: `ada.${tipo}`,\n\t\tkind: tipo === \"red\" || tipo === \"modelo\" ? SPAN_KIND_CLIENT : SPAN_KIND_INTERNAL,\n\t\tstartTimeUnixNano: String(inicio),\n\t\tendTimeUnixNano: String(inicio + duracion * 1_000_000n),\n\t\tattributes: Object.entries(atributos).map(([clave, v]) => atributoOtlp(clave, v)),\n\t\t// El estado va sin `message`: el texto de un error es contenido, y este\n\t\t// es el hueco por donde se colaria.\n\t\tstatus: { code: fueError(suceso) ? STATUS_ERROR : STATUS_UNSET },\n\t};\n}\n\n/** Lo que se anuncia como productor de las trazas. Nada de esto es un dato del usuario. */\nconst RECURSO: readonly (readonly [string, string])[] = [\n\t[\"service.name\", \"ada\"],\n\t[\"telemetry.sdk.name\", \"ada-libro-de-sesion\"],\n\t[\"telemetry.sdk.language\", \"nodejs\"],\n];\n\n/**\n * El cuerpo `ResourceSpans` de OTLP/JSON, listo para que otro lo suba.\n *\n * La forma es la del estándar y no se improvisa:\n * `resourceSpans[] -> scopeSpans[] -> spans[]`, con `traceId` y `spanId` en\n * hexadecimal y los tiempos en nanosegundos desde epoch como cadena, porque son\n * enteros de 64 bits y un `number` de JavaScript no los sostiene.\n *\n * Una lista vacía devuelve un cuerpo con cero spans y NO un cuerpo vacío: el\n * colector tiene que poder distinguir «esta sesión no tuvo sucesos» de «no se\n * exportó nada».\n */\nexport function cuerpoOtlp(entradas: readonly EntradaDelLibro[]): object {\n\treturn {\n\t\tresourceSpans: [\n\t\t\t{\n\t\t\t\tresource: { attributes: RECURSO.map(([clave, v]) => atributoOtlp(clave, v)) },\n\t\t\t\tscopeSpans: [\n\t\t\t\t\t{\n\t\t\t\t\t\tscope: { name: \"ada.core.audit.libro\", version: \"1\" },\n\t\t\t\t\t\tspans: entradas.map(spanDeSuceso),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n}\n"]}
+{"version":3,"file":"otlp.js","sourceRoot":"","sources":["../../../src/core/telemetria/otlp.ts"],"names":[],"mappings":"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"}

package/dist/core/telemetry/otel-genai.d.ts

@@ -0,0 +1,44 @@
+/**
+ * OTel GenAI semconv sobre el logger persistente (UT1).
+ *
+ * No envía a ningún collector si no hay endpoint configurado (no-op).
+ * Emite spans con atributos `gen_ai.*` según
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/
+ *
+ * Additive — ningún diff upstream.
+ */
+export interface TurnInfo {
+    id?: string;
+    model?: string;
+    provider?: string;
+    operationName?: string;
+}
+export interface ToolCallInfo {
+    name: string;
+    callId?: string;
+    model?: string;
+    provider?: string;
+}
+export interface TokenUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+export interface GenAISpan {
+    name: string;
+    attributes: Record<string, string | number | boolean>;
+    startTimeMs: number;
+    ended: boolean;
+    end(extra?: Record<string, string | number | boolean>): void;
+}
+export declare class OTelGenAI {
+    private readonly enabled;
+    private readonly env;
+    constructor(env?: NodeJS.ProcessEnv);
+    isEnabled(): boolean;
+    spanForTurn(turn: TurnInfo): GenAISpan;
+    spanForToolCall(tool: ToolCallInfo): GenAISpan;
+    emitMetrics(tokens: TokenUsage, latencyMs: number): void;
+}
+export declare const otelGenAI: OTelGenAI;
+//# sourceMappingURL=otel-genai.d.ts.map

package/dist/core/telemetry/otel-genai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-genai.d.ts","sourceRoot":"","sources":["../../../src/core/telemetry/otel-genai.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,QAAQ;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7D;AA8DD,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;gBAE5B,GAAG,GAAE,MAAM,CAAC,UAAwB;IAKhD,SAAS,IAAI,OAAO;IAIpB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS;IAMtC,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS;IAM9C,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAmBxD;AAGD,eAAO,MAAM,SAAS,WAAkB,CAAC"}