@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/telemetria/otlp.js

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

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

@@ -0,0 +1 @@
+{"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"}

package/dist/core/telemetry/otel-genai.js

@@ -0,0 +1,124 @@
+/**
+ * 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.
+ */
+import { logger } from "../utils/logger.js";
+const ENV_ENDPOINT = "OTEL_EXPORTER_OTLP_ENDPOINT";
+function endpointConfigurado(env = process.env) {
+    const v = env[ENV_ENDPOINT];
+    return typeof v === "string" && v.trim().length > 0;
+}
+function attrsTurn(turn) {
+    const a = {
+        "gen_ai.operation.name": turn.operationName ?? "chat",
+    };
+    if (turn.model)
+        a["gen_ai.request.model"] = turn.model;
+    if (turn.provider)
+        a["gen_ai.provider.name"] = turn.provider;
+    if (turn.id)
+        a["gen_ai.turn.id"] = turn.id;
+    // OTel GenAI: system defaults
+    a["gen_ai.system"] = turn.provider ?? "ada";
+    return a;
+}
+function attrsTool(tool) {
+    const a = {
+        "gen_ai.operation.name": "execute_tool",
+        "gen_ai.tool.name": tool.name,
+    };
+    if (tool.callId)
+        a["gen_ai.tool.call.id"] = tool.callId;
+    if (tool.model)
+        a["gen_ai.request.model"] = tool.model;
+    if (tool.provider)
+        a["gen_ai.provider.name"] = tool.provider;
+    return a;
+}
+function makeSpan(name, attributes) {
+    const startTimeMs = Date.now();
+    const span = {
+        name,
+        attributes: { ...attributes },
+        startTimeMs,
+        ended: false,
+        end(extra) {
+            if (span.ended)
+                return;
+            span.ended = true;
+            if (extra)
+                Object.assign(span.attributes, extra);
+            const durationMs = Date.now() - startTimeMs;
+            // Siempre log persistente; envío OTLP solo si hay endpoint (no-op ahora).
+            try {
+                logger.debug(`otel span end: ${name}`, {
+                    attributes: span.attributes,
+                    durationMs,
+                    endpoint: endpointConfigurado() ? "configured" : "no-op",
+                });
+            }
+            catch { }
+            // No fetch / no grpc si no hay endpoint — requisito acceptance.
+            if (!endpointConfigurado())
+                return;
+            // Si hay endpoint, aquí iría el export real (fuera de scope Fase 2;
+            // no se envía todavía para no introducir dependencia OTel SDK).
+        },
+    };
+    try {
+        logger.debug(`otel span start: ${name}`, { attributes });
+    }
+    catch { }
+    return span;
+}
+export class OTelGenAI {
+    enabled;
+    env;
+    constructor(env = process.env) {
+        this.env = env;
+        this.enabled = endpointConfigurado(env);
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    spanForTurn(turn) {
+        const attrs = attrsTurn(turn);
+        const name = turn.id ? `gen_ai.turn ${turn.id}` : "gen_ai.turn";
+        return makeSpan(name, attrs);
+    }
+    spanForToolCall(tool) {
+        const attrs = attrsTool(tool);
+        const name = `gen_ai.tool ${tool.name}`;
+        return makeSpan(name, attrs);
+    }
+    emitMetrics(tokens, latencyMs) {
+        try {
+            const attrs = {
+                "gen_ai.operation.name": "chat",
+            };
+            if (typeof tokens.inputTokens === "number")
+                attrs["gen_ai.usage.input_tokens"] = tokens.inputTokens;
+            if (typeof tokens.outputTokens === "number")
+                attrs["gen_ai.usage.output_tokens"] = tokens.outputTokens;
+            if (typeof tokens.totalTokens === "number")
+                attrs["gen_ai.usage.total_tokens"] = tokens.totalTokens;
+            // latency como métrica
+            attrs["gen_ai.latency_ms"] = latencyMs;
+            logger.debug("otel metrics", { attributes: attrs, endpoint: this.enabled ? "configured" : "no-op" });
+            if (!this.enabled)
+                return;
+            // No-op si no hay collector real; no se hace fetch.
+        }
+        catch {
+            // Nunca throw — acceptance: emitMetrics no throw si no collector.
+        }
+    }
+}
+// Singleton default para uso sencillo
+export const otelGenAI = new OTelGenAI();
+//# sourceMappingURL=otel-genai.js.map

package/dist/core/telemetry/otel-genai.js.map

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

package/dist/core/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/core/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,wBAAgB,yBAAyB,CACxC,eAAe,EAAE,eAAe,EAChC,YAAY,GAAE,MAAM,GAAG,SAAoC,GACzD,OAAO,CAET","sourcesContent":["import type { SettingsManager } from \"./settings-manager.ts\";\n\nfunction isTruthyEnvFlag(value: string | undefined): boolean {\n\tif (!value) return false;\n\treturn value === \"1\" || value.toLowerCase() === \"true\" || value.toLowerCase() === \"yes\";\n}\n\nexport function isInstallTelemetryEnabled(\n\tsettingsManager: SettingsManager,\n\ttelemetryEnv: string | undefined = process.env.PI_TELEMETRY,\n): boolean {\n\treturn telemetryEnv !== undefined ? isTruthyEnvFlag(telemetryEnv) : settingsManager.getEnableInstallTelemetry();\n}\n"]}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/core/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,wBAAgB,yBAAyB,CACxC,eAAe,EAAE,eAAe,EAChC,YAAY,GAAE,MAAM,GAAG,SAAoC,GACzD,OAAO,CAET"}

package/dist/core/telemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/core/telemetry.ts"],"names":[],"mappings":"AAEA,SAAS,eAAe,CAAC,KAAyB,EAAW;IAC5D,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC;AAAA,CACxF;AAED,MAAM,UAAU,yBAAyB,CACxC,eAAgC,EAChC,YAAY,GAAuB,OAAO,CAAC,GAAG,CAAC,YAAY,EACjD;IACV,OAAO,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,yBAAyB,EAAE,CAAC;AAAA,CAChH","sourcesContent":["import type { SettingsManager } from \"./settings-manager.ts\";\n\nfunction isTruthyEnvFlag(value: string | undefined): boolean {\n\tif (!value) return false;\n\treturn value === \"1\" || value.toLowerCase() === \"true\" || value.toLowerCase() === \"yes\";\n}\n\nexport function isInstallTelemetryEnabled(\n\tsettingsManager: SettingsManager,\n\ttelemetryEnv: string | undefined = process.env.PI_TELEMETRY,\n): boolean {\n\treturn telemetryEnv !== undefined ? isTruthyEnvFlag(telemetryEnv) : settingsManager.getEnableInstallTelemetry();\n}\n"]}
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/core/telemetry.ts"],"names":[],"mappings":"AAEA,SAAS,eAAe,CAAC,KAAyB;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,yBAAyB,CACxC,eAAgC,EAChC,eAAmC,OAAO,CAAC,GAAG,CAAC,YAAY;IAE3D,OAAO,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,yBAAyB,EAAE,CAAC;AACjH,CAAC"}

package/dist/core/terminal/backlog-guard.d.ts

@@ -0,0 +1,53 @@
+/**
+ * OutputBacklogGuard — ceiling 64 MiB con política FIFO.
+ *
+ * El TUI / el host PTY acumula output del agente. Un agente en bucle puede
+ * vomitar cientos de MiB y OOMear el proceso. Este guard mantiene el backlog
+ * por debajo de 64 MiB descartando del frente (el contenido más antiguo) y
+ * marcando `truncado` para que la UI pueda avisar: "[output truncado — se
+ * descartaron X bytes del inicio]".
+ *
+ * Diseño:
+ * - `push(chunk)` añade al final y actualiza `bytesTotales`.
+ * - `excedeLimite()` es O(1) (no recalcula).
+ * - `recortar()` descarta chunks FIFO hasta volver por debajo del límite,
+ *   acumula `bytesDescartados` y marca `truncado = true`.
+ * - `resumen()` reporta para la UI.
+ */
+export declare const LIMITE_BACKLOG_BYTES: number;
+export interface ResumenBacklog {
+    bytesTotales: number;
+    bytesDescartados: number;
+    truncado: boolean;
+    chunks: number;
+    limite: number;
+}
+export declare class OutputBacklogGuard {
+    #private;
+    constructor(limite?: number);
+    get limite(): number;
+    get truncado(): boolean;
+    get bytesTotales(): number;
+    get bytesDescartados(): number;
+    get chunks(): readonly Uint8Array[];
+    push(chunk: Uint8Array): void;
+    excedeLimite(): boolean;
+    /**
+     * Descarta chunks del frente hasta que `bytesTotales <= limite`.
+     * Devuelve cuántos chunks se descartaron en esta llamada.
+     * Marca `truncado = true` si se descartó al menos un byte.
+     */
+    recortar(): number;
+    /**
+     * Atajo: push + recorte automático si se excede. Devuelve el resumen
+     * posterior al posible recorte.
+     */
+    pushConRecorte(chunk: Uint8Array): ResumenBacklog;
+    resumen(): ResumenBacklog;
+    /** Vuelca el backlog concatenado (útil para tests / snapshot). */
+    concatenar(): Uint8Array;
+    limpiar(): void;
+    /** Mensaje para la UI cuando hubo truncado. */
+    mensajeAviso(): string | null;
+}
+//# sourceMappingURL=backlog-guard.d.ts.map

package/dist/core/terminal/backlog-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog-guard.d.ts","sourceRoot":"","sources":["../../../src/core/terminal/backlog-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAErD,MAAM,WAAW,cAAc;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,kBAAkB;;gBAOlB,MAAM,SAAuB;IAOzC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,MAAM,IAAI,SAAS,UAAU,EAAE,CAElC;IAED,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAO7B,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAoBlB;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc;IAQjD,OAAO,IAAI,cAAc;IAUzB,kEAAkE;IAClE,UAAU,IAAI,UAAU;IAUxB,OAAO,IAAI,IAAI;IAOf,+CAA+C;IAC/C,YAAY,IAAI,MAAM,GAAG,IAAI;CAM7B"}