@hoilab/ada-cli 0.85.0 → 0.85.3

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"}

package/dist/core/terminal/backlog-guard.js

@@ -0,0 +1,122 @@
+/**
+ * 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 const LIMITE_BACKLOG_BYTES = 64 * 1024 * 1024; // 64 MiB
+export class OutputBacklogGuard {
+    #chunks = [];
+    #bytesTotales = 0;
+    #bytesDescartados = 0;
+    #truncado = false;
+    #limite;
+    constructor(limite = LIMITE_BACKLOG_BYTES) {
+        if (limite <= 0) {
+            throw new RangeError(`limite debe ser >0, recibido ${limite}`);
+        }
+        this.#limite = limite;
+    }
+    get limite() {
+        return this.#limite;
+    }
+    get truncado() {
+        return this.#truncado;
+    }
+    get bytesTotales() {
+        return this.#bytesTotales;
+    }
+    get bytesDescartados() {
+        return this.#bytesDescartados;
+    }
+    get chunks() {
+        return this.#chunks;
+    }
+    push(chunk) {
+        // Copia defensiva: el caller puede reutilizar el buffer.
+        const copia = chunk.slice();
+        this.#chunks.push(copia);
+        this.#bytesTotales += copia.length;
+    }
+    excedeLimite() {
+        return this.#bytesTotales > this.#limite;
+    }
+    /**
+     * 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() {
+        if (this.#bytesTotales <= this.#limite) {
+            return 0;
+        }
+        let descartados = 0;
+        while (this.#chunks.length > 0 && this.#bytesTotales > this.#limite) {
+            const frente = this.#chunks.shift();
+            this.#bytesTotales -= frente.length;
+            this.#bytesDescartados += frente.length;
+            descartados += 1;
+        }
+        if (descartados > 0) {
+            this.#truncado = true;
+        }
+        // Caso extremo: un solo chunk > limite. Lo mantenemos pero marcado
+        // como truncado — no hay nada más que descartar sin perder todo.
+        // El caller puede decidir vaciar por completo si lo desea.
+        return descartados;
+    }
+    /**
+     * Atajo: push + recorte automático si se excede. Devuelve el resumen
+     * posterior al posible recorte.
+     */
+    pushConRecorte(chunk) {
+        this.push(chunk);
+        if (this.excedeLimite()) {
+            this.recortar();
+        }
+        return this.resumen();
+    }
+    resumen() {
+        return {
+            bytesTotales: this.#bytesTotales,
+            bytesDescartados: this.#bytesDescartados,
+            truncado: this.#truncado,
+            chunks: this.#chunks.length,
+            limite: this.#limite,
+        };
+    }
+    /** Vuelca el backlog concatenado (útil para tests / snapshot). */
+    concatenar() {
+        const out = new Uint8Array(this.#bytesTotales);
+        let offset = 0;
+        for (const c of this.#chunks) {
+            out.set(c, offset);
+            offset += c.length;
+        }
+        return out;
+    }
+    limpiar() {
+        this.#chunks = [];
+        this.#bytesTotales = 0;
+        this.#bytesDescartados = 0;
+        this.#truncado = false;
+    }
+    /** Mensaje para la UI cuando hubo truncado. */
+    mensajeAviso() {
+        if (!this.#truncado) {
+            return null;
+        }
+        return `[output truncado — se descartaron ${this.#bytesDescartados} bytes del inicio; backlog limitado a ${this.#limite} bytes]`;
+    }
+}
+//# sourceMappingURL=backlog-guard.js.map

package/dist/core/terminal/backlog-guard.js.map

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

package/dist/core/terminal/conpty.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ConPTY chunking — fragmenta payloads grandes en ventanas de 4 KiB para no
+ * saturar el canal PTY (ConPTY en Windows y pty host en POSIX).
+ *
+ * El canal ConPTY tiene un buffer limitado; escribir 64 KiB de golpe puede
+ * bloquear el host o fragmentarse de forma no determinista. Partir en 4 KiB
+ * mantiene latencia baja y permite backpressure por chunk.
+ */
+/**
+ * Fragmenta `buf` en trozos de `tamano` bytes.
+ * - No copia más de lo necesario: cada chunk es una vista nueva (Uint8Array)
+ *   sobre una copia del rango [offset, offset+tamano).
+ * - `tamano` <=0 lanza RangeError (guard rail para no colgar el caller).
+ */
+export declare function fragmentarParaConPTY(buf: Uint8Array, tamano?: number): Uint8Array[];
+/** Writer mínimo compatible con Node Writable y con mocks de test. */
+export interface ConPTYWriter {
+    write(chunk: Uint8Array): boolean;
+    once?(event: "drain", listener: () => void): void;
+    on?(event: "drain", listener: () => void): void;
+}
+/**
+ * Escribe `data` fragmentada por ConPTY, respetando backpressure.
+ * Si `writer.write` devuelve false, espera al evento 'drain' antes de
+ * continuar con el siguiente chunk. Si el writer no expone `once`/`on`,
+ * cede al microtask queue (evita starvation sin bloquear).
+ */
+export declare function escribirConPTY(writer: ConPTYWriter, data: Uint8Array | string, tamano?: number): Promise<void>;
+//# sourceMappingURL=conpty.d.ts.map

package/dist/core/terminal/conpty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conpty.d.ts","sourceRoot":"","sources":["../../../src/core/terminal/conpty.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,SAAqB,GAAG,UAAU,EAAE,CAe/F;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAClC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAClD,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,MAAM,SAAqB,GACzB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/core/terminal/conpty.js

@@ -0,0 +1,67 @@
+/**
+ * ConPTY chunking — fragmenta payloads grandes en ventanas de 4 KiB para no
+ * saturar el canal PTY (ConPTY en Windows y pty host en POSIX).
+ *
+ * El canal ConPTY tiene un buffer limitado; escribir 64 KiB de golpe puede
+ * bloquear el host o fragmentarse de forma no determinista. Partir en 4 KiB
+ * mantiene latencia baja y permite backpressure por chunk.
+ */
+const TAMANO_POR_DEFECTO = 4096;
+/**
+ * Fragmenta `buf` en trozos de `tamano` bytes.
+ * - No copia más de lo necesario: cada chunk es una vista nueva (Uint8Array)
+ *   sobre una copia del rango [offset, offset+tamano).
+ * - `tamano` <=0 lanza RangeError (guard rail para no colgar el caller).
+ */
+export function fragmentarParaConPTY(buf, tamano = TAMANO_POR_DEFECTO) {
+    if (tamano <= 0) {
+        throw new RangeError(`tamano debe ser >0, recibido ${tamano}`);
+    }
+    if (buf.length === 0) {
+        return [];
+    }
+    const out = [];
+    for (let offset = 0; offset < buf.length; offset += tamano) {
+        const end = Math.min(offset + tamano, buf.length);
+        // slice crea una copia; subarray compartiría el buffer subyacente y
+        // podría retener el buf grande en memoria si se guarda un chunk.
+        out.push(buf.slice(offset, end));
+    }
+    return out;
+}
+/**
+ * Escribe `data` fragmentada por ConPTY, respetando backpressure.
+ * Si `writer.write` devuelve false, espera al evento 'drain' antes de
+ * continuar con el siguiente chunk. Si el writer no expone `once`/`on`,
+ * cede al microtask queue (evita starvation sin bloquear).
+ */
+export async function escribirConPTY(writer, data, tamano = TAMANO_POR_DEFECTO) {
+    const buf = typeof data === "string" ? new TextEncoder().encode(data) : data;
+    const chunks = fragmentarParaConPTY(buf, tamano);
+    for (const chunk of chunks) {
+        const ok = writer.write(chunk);
+        if (!ok) {
+            await esperarDrain(writer);
+        }
+    }
+}
+function esperarDrain(writer) {
+    return new Promise((resolve) => {
+        if (typeof writer.once === "function") {
+            writer.once("drain", resolve);
+            return;
+        }
+        if (typeof writer.on === "function") {
+            const handler = () => {
+                // remover tras un disparo si `on` fue usado en lugar de `once`
+                // (best-effort; no hay `off` garantizado en mocks).
+                resolve();
+            };
+            writer.on("drain", handler);
+            return;
+        }
+        // Writer sin señal de drain: cede un tick para no saturar el loop.
+        queueMicrotask(resolve);
+    });
+}
+//# sourceMappingURL=conpty.js.map

package/dist/core/terminal/conpty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conpty.js","sourceRoot":"","sources":["../../../src/core/terminal/conpty.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAe,EAAE,MAAM,GAAG,kBAAkB;IAChF,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,UAAU,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,oEAAoE;QACpE,iEAAiE;QACjE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AASD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,MAAoB,EACpB,IAAyB,EACzB,MAAM,GAAG,kBAAkB;IAE3B,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,EAAE,CAAC;YACT,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,MAAoB;IACzC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9B,OAAO;QACR,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,GAAG,EAAE;gBACpB,+DAA+D;gBAC/D,oDAAoD;gBACpD,OAAO,EAAE,CAAC;YACX,CAAC,CAAC;YACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5B,OAAO;QACR,CAAC;QACD,mEAAmE;QACnE,cAAc,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/terminal/conptyChunking.d.ts

@@ -0,0 +1,2 @@
+export { type ConPTYWriter, escribirConPTY, fragmentarParaConPTY } from "./conpty.ts";
+//# sourceMappingURL=conptyChunking.d.ts.map

package/dist/core/terminal/conptyChunking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conptyChunking.d.ts","sourceRoot":"","sources":["../../../src/core/terminal/conptyChunking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/terminal/conptyChunking.js

@@ -0,0 +1,2 @@
+export { escribirConPTY, fragmentarParaConPTY } from "./conpty.js";
+//# sourceMappingURL=conptyChunking.js.map

package/dist/core/terminal/conptyChunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conptyChunking.js","sourceRoot":"","sources":["../../../src/core/terminal/conptyChunking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/terminal/index.d.ts

@@ -0,0 +1,5 @@
+export { LIMITE_BACKLOG_BYTES, OutputBacklogGuard, type ResumenBacklog, } from "./backlog-guard.ts";
+export { type ConPTYWriter, escribirConPTY, fragmentarParaConPTY } from "./conpty.ts";
+export { type EstadoWatchdog, LoopWatchdog, type LoopWatchdogOpciones } from "./loop-watchdog.ts";
+export { type ResultadoRunner, type RunnerOpciones, TerminalRunner } from "./runner.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/terminal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,cAAc,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/terminal/index.js

@@ -0,0 +1,5 @@
+export { LIMITE_BACKLOG_BYTES, OutputBacklogGuard, } from "./backlog-guard.js";
+export { escribirConPTY, fragmentarParaConPTY } from "./conpty.js";
+export { LoopWatchdog } from "./loop-watchdog.js";
+export { TerminalRunner } from "./runner.js";
+//# sourceMappingURL=index.js.map

package/dist/core/terminal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,kBAAkB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAqB,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAuB,YAAY,EAA6B,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAA6C,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/terminal/loop-watchdog.d.ts

@@ -0,0 +1,43 @@
+/**
+ * LoopWatchdog — detecta bucles de output idéntico.
+ *
+ * Un agente atascado puede emitir la misma línea / chunk miles de veces.
+ * Este watchdog hashea una ventana de 1 KiB de cada chunk (SHA-256) y cuenta
+ * repeticiones idénticas consecutivas. Si `count >= umbral` dispara
+ * `onLoopDetected(hash, count)` y opcionalmente introduce un jitter delay
+ * para frenar el productor sin perder datos.
+ */
+export interface LoopWatchdogOpciones {
+    /** Cuántas repeticiones idénticas consecutivas disparan el callback. */
+    umbral?: number;
+    /** Ventana hasheada por chunk (bytes). Por defecto 1024. */
+    ventanaBytes?: number;
+    /** Delay opcional (ms) tras detectar bucle, para frenar al productor. */
+    jitterMs?: number;
+    onLoopDetected?: (hash: string, count: number) => void;
+}
+export interface EstadoWatchdog {
+    ultimoHash: string | null;
+    repeticionesConsecutivas: number;
+    totalChunks: number;
+    disparos: number;
+    bucleActivo: boolean;
+}
+export declare class LoopWatchdog {
+    #private;
+    constructor(opciones?: LoopWatchdogOpciones);
+    get umbral(): number;
+    get ventanaBytes(): number;
+    get disparos(): number;
+    /**
+     * Registra un chunk y evalúa si hay bucle.
+     * Devuelve true si se detectó bucle en esta llamada.
+     * Si `jitterMs > 0` y hay bucle, espera ese delay antes de retornar.
+     */
+    registrar(chunk: Uint8Array | string): Promise<boolean>;
+    /** Versión síncrona sin jitter (útil en paths no-async). */
+    registrarSync(chunk: Uint8Array | string): boolean;
+    estado(): EstadoWatchdog;
+    reiniciar(): void;
+}
+//# sourceMappingURL=loop-watchdog.d.ts.map

package/dist/core/terminal/loop-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-watchdog.d.ts","sourceRoot":"","sources":["../../../src/core/terminal/loop-watchdog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,oBAAoB;IACpC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wBAAwB,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACrB;AAKD,qBAAa,YAAY;;gBAWZ,QAAQ,GAAE,oBAAyB;IAa/C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;OAIG;IACG,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB7D,4DAA4D;IAC5D,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAsBlD,MAAM,IAAI,cAAc;IAUxB,SAAS,IAAI,IAAI;CAMjB"}

package/dist/core/terminal/loop-watchdog.js

@@ -0,0 +1,117 @@
+/**
+ * LoopWatchdog — detecta bucles de output idéntico.
+ *
+ * Un agente atascado puede emitir la misma línea / chunk miles de veces.
+ * Este watchdog hashea una ventana de 1 KiB de cada chunk (SHA-256) y cuenta
+ * repeticiones idénticas consecutivas. Si `count >= umbral` dispara
+ * `onLoopDetected(hash, count)` y opcionalmente introduce un jitter delay
+ * para frenar el productor sin perder datos.
+ */
+import { createHash } from "node:crypto";
+const VENTANA_POR_DEFECTO = 1024;
+const UMBRAL_POR_DEFECTO = 10;
+export class LoopWatchdog {
+    #ventana;
+    #umbral;
+    #jitterMs;
+    #onLoopDetected;
+    #ultimoHash = null;
+    #repeticiones = 0;
+    #totalChunks = 0;
+    #disparos = 0;
+    constructor(opciones = {}) {
+        this.#ventana = opciones.ventanaBytes ?? VENTANA_POR_DEFECTO;
+        this.#umbral = opciones.umbral ?? UMBRAL_POR_DEFECTO;
+        this.#jitterMs = opciones.jitterMs ?? 0;
+        this.#onLoopDetected = opciones.onLoopDetected;
+        if (this.#ventana <= 0) {
+            throw new RangeError(`ventanaBytes debe ser >0`);
+        }
+        if (this.#umbral <= 0) {
+            throw new RangeError(`umbral debe ser >0`);
+        }
+    }
+    get umbral() {
+        return this.#umbral;
+    }
+    get ventanaBytes() {
+        return this.#ventana;
+    }
+    get disparos() {
+        return this.#disparos;
+    }
+    /**
+     * Registra un chunk y evalúa si hay bucle.
+     * Devuelve true si se detectó bucle en esta llamada.
+     * Si `jitterMs > 0` y hay bucle, espera ese delay antes de retornar.
+     */
+    async registrar(chunk) {
+        const buf = typeof chunk === "string" ? new TextEncoder().encode(chunk) : chunk;
+        const hash = hashearVentana(buf, this.#ventana);
+        this.#totalChunks += 1;
+        if (this.#ultimoHash !== null && hash === this.#ultimoHash) {
+            this.#repeticiones += 1;
+        }
+        else {
+            this.#ultimoHash = hash;
+            this.#repeticiones = 1;
+        }
+        const esBucle = this.#repeticiones >= this.#umbral;
+        if (esBucle) {
+            this.#disparos += 1;
+            if (this.#onLoopDetected) {
+                this.#onLoopDetected(hash, this.#repeticiones);
+            }
+            if (this.#jitterMs > 0) {
+                await delay(this.#jitterMs);
+            }
+        }
+        return esBucle;
+    }
+    /** Versión síncrona sin jitter (útil en paths no-async). */
+    registrarSync(chunk) {
+        const buf = typeof chunk === "string" ? new TextEncoder().encode(chunk) : chunk;
+        const hash = hashearVentana(buf, this.#ventana);
+        this.#totalChunks += 1;
+        if (this.#ultimoHash !== null && hash === this.#ultimoHash) {
+            this.#repeticiones += 1;
+        }
+        else {
+            this.#ultimoHash = hash;
+            this.#repeticiones = 1;
+        }
+        const esBucle = this.#repeticiones >= this.#umbral;
+        if (esBucle) {
+            this.#disparos += 1;
+            if (this.#onLoopDetected) {
+                this.#onLoopDetected(hash, this.#repeticiones);
+            }
+        }
+        return esBucle;
+    }
+    estado() {
+        return {
+            ultimoHash: this.#ultimoHash,
+            repeticionesConsecutivas: this.#repeticiones,
+            totalChunks: this.#totalChunks,
+            disparos: this.#disparos,
+            bucleActivo: this.#repeticiones >= this.#umbral,
+        };
+    }
+    reiniciar() {
+        this.#ultimoHash = null;
+        this.#repeticiones = 0;
+        this.#totalChunks = 0;
+        this.#disparos = 0;
+    }
+}
+function hashearVentana(buf, ventana) {
+    const vista = buf.length > ventana ? buf.subarray(0, ventana) : buf;
+    return createHash("sha256").update(vista).digest("hex");
+}
+function delay(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=loop-watchdog.js.map

package/dist/core/terminal/loop-watchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-watchdog.js","sourceRoot":"","sources":["../../../src/core/terminal/loop-watchdog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAoBzC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,MAAM,OAAO,YAAY;IACxB,QAAQ,CAAS;IACjB,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,eAAe,CAAsD;IAErE,WAAW,GAAkB,IAAI,CAAC;IAClC,aAAa,GAAG,CAAC,CAAC;IAClB,YAAY,GAAG,CAAC,CAAC;IACjB,SAAS,GAAG,CAAC,CAAC;IAEd,YAAY,WAAiC,EAAE;QAC9C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,YAAY,IAAI,mBAAmB,CAAC;QAC7D,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,MAAM,IAAI,kBAAkB,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,cAAc,CAAC;QAC/C,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,UAAU,CAAC,0BAA0B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;QAC5C,CAAC;IACF,CAAC;IAED,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,KAA0B;QACzC,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAChF,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;QAEvB,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5D,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO,CAAC;QACnD,IAAI,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1B,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAChD,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;QACF,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,4DAA4D;IAC5D,aAAa,CAAC,KAA0B;QACvC,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAChF,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;QAEvB,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5D,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO,CAAC;QACnD,IAAI,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1B,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAChD,CAAC;QACF,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,MAAM;QACL,OAAO;YACN,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,wBAAwB,EAAE,IAAI,CAAC,aAAa;YAC5C,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,WAAW,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO;SAC/C,CAAC;IACH,CAAC;IAED,SAAS;QACR,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACpB,CAAC;CACD;AAED,SAAS,cAAc,CAAC,GAAe,EAAE,OAAe;IACvD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACpE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACxB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACpC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACJ,CAAC"}