@hoilab/ada-cli 0.84.22 → 0.85.1

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

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

@@ -0,0 +1,55 @@
+/**
+ * TerminalRunner — consumidor real que integra ConPTY chunking +
+ * OutputBacklogGuard (64 MiB) + LoopWatchdog en un único camino de escritura.
+ *
+ * Es el wiring verificable: no es un mock, es el código que el TUI / el
+ * host PTY usaría para volcar output del agente. Los tests de
+ * terminal-robustez lo ejercitan con un stream sintético de 1000 líneas
+ * idénticas para probar los tres estados: ok / truncado / bucle-detectado.
+ */
+import { OutputBacklogGuard } from "./backlog-guard.ts";
+import { type ConPTYWriter } from "./conpty.ts";
+import { LoopWatchdog } from "./loop-watchdog.ts";
+export interface RunnerOpciones {
+    limiteBacklog?: number;
+    umbralBucle?: number;
+    ventanaBucleBytes?: number;
+    jitterMs?: number;
+    onLoopDetected?: (hash: string, count: number) => void;
+    onTruncado?: (resumen: {
+        bytesTotales: number;
+        bytesDescartados: number;
+    }) => void;
+}
+export interface ResultadoRunner {
+    bytesEscritos: number;
+    chunksEscritos: number;
+    truncado: boolean;
+    bytesDescartados: number;
+    bucleDetectado: boolean;
+    disparosWatchdog: number;
+    mensajeAviso: string | null;
+}
+export declare class TerminalRunner {
+    #private;
+    constructor(opciones?: RunnerOpciones);
+    get guard(): OutputBacklogGuard;
+    get watchdog(): LoopWatchdog;
+    /**
+     * Escribe un chunk a través del pipeline:
+     * 1. Registra en watchdog (detecta bucle).
+     * 2. Push al backlog guard (con recorte FIFO si excede 64 MiB).
+     * 3. Envía por ConPTY chunking al writer (con backpressure).
+     */
+    escribir(writer: ConPTYWriter, chunk: Uint8Array | string): Promise<void>;
+    /**
+     * Atajo para simular un agente vomitando `lineas` líneas idénticas o
+     * variadas. Usado por tests de integración.
+     */
+    simularStream(writer: ConPTYWriter, lineas: string[] | {
+        count: number;
+        linea: string;
+    }): Promise<ResultadoRunner>;
+    estado(): ResultadoRunner;
+}
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/core/terminal/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAwB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,cAAc;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACnF;AAED,MAAM,WAAW,eAAe;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,qBAAa,cAAc;;gBAQd,QAAQ,GAAE,cAAmB;IAgBzC,IAAI,KAAK,IAAI,kBAAkB,CAE9B;IAED,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/E;;;OAGG;IACG,aAAa,CAClB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,eAAe,CAAC;IAmB3B,MAAM,IAAI,eAAe;CAYzB"}

package/dist/core/terminal/runner.js

@@ -0,0 +1,102 @@
+/**
+ * TerminalRunner — consumidor real que integra ConPTY chunking +
+ * OutputBacklogGuard (64 MiB) + LoopWatchdog en un único camino de escritura.
+ *
+ * Es el wiring verificable: no es un mock, es el código que el TUI / el
+ * host PTY usaría para volcar output del agente. Los tests de
+ * terminal-robustez lo ejercitan con un stream sintético de 1000 líneas
+ * idénticas para probar los tres estados: ok / truncado / bucle-detectado.
+ */
+import { LIMITE_BACKLOG_BYTES, OutputBacklogGuard } from "./backlog-guard.js";
+import { escribirConPTY } from "./conpty.js";
+import { LoopWatchdog } from "./loop-watchdog.js";
+export class TerminalRunner {
+    #guard;
+    #watchdog;
+    #onTruncado;
+    #bytesEscritos = 0;
+    #chunksEscritos = 0;
+    #bucleDetectado = false;
+    constructor(opciones = {}) {
+        this.#guard = new OutputBacklogGuard(opciones.limiteBacklog ?? LIMITE_BACKLOG_BYTES);
+        this.#onTruncado = opciones.onTruncado;
+        this.#watchdog = new LoopWatchdog({
+            umbral: opciones.umbralBucle,
+            ventanaBytes: opciones.ventanaBucleBytes,
+            jitterMs: opciones.jitterMs,
+            onLoopDetected: (hash, count) => {
+                this.#bucleDetectado = true;
+                if (opciones.onLoopDetected) {
+                    opciones.onLoopDetected(hash, count);
+                }
+            },
+        });
+    }
+    get guard() {
+        return this.#guard;
+    }
+    get watchdog() {
+        return this.#watchdog;
+    }
+    /**
+     * Escribe un chunk a través del pipeline:
+     * 1. Registra en watchdog (detecta bucle).
+     * 2. Push al backlog guard (con recorte FIFO si excede 64 MiB).
+     * 3. Envía por ConPTY chunking al writer (con backpressure).
+     */
+    async escribir(writer, chunk) {
+        const buf = typeof chunk === "string" ? new TextEncoder().encode(chunk) : chunk;
+        const esBucle = await this.#watchdog.registrar(buf);
+        // El bucle no bloquea la escritura; solo avisa y aplica jitter.
+        // El caller puede decidir frenar si `esBucle` es true.
+        void esBucle;
+        this.#guard.push(buf);
+        if (this.#guard.excedeLimite()) {
+            const antes = this.#guard.bytesDescartados;
+            this.#guard.recortar();
+            if (this.#guard.truncado && this.#onTruncado) {
+                const r = this.#guard.resumen();
+                // Solo avisa si hubo descarte nuevo en esta llamada.
+                if (r.bytesDescartados !== antes) {
+                    this.#onTruncado({ bytesTotales: r.bytesTotales, bytesDescartados: r.bytesDescartados });
+                }
+            }
+        }
+        await escribirConPTY(writer, buf);
+        this.#bytesEscritos += buf.length;
+        this.#chunksEscritos += 1;
+    }
+    /**
+     * Atajo para simular un agente vomitando `lineas` líneas idénticas o
+     * variadas. Usado por tests de integración.
+     */
+    async simularStream(writer, lineas) {
+        const lista = Array.isArray(lineas) ? lineas : Array.from({ length: lineas.count }, () => lineas.linea);
+        for (const l of lista) {
+            await this.escribir(writer, l);
+        }
+        const resumen = this.#guard.resumen();
+        return {
+            bytesEscritos: this.#bytesEscritos,
+            chunksEscritos: this.#chunksEscritos,
+            truncado: resumen.truncado,
+            bytesDescartados: resumen.bytesDescartados,
+            bucleDetectado: this.#bucleDetectado,
+            disparosWatchdog: this.#watchdog.disparos,
+            mensajeAviso: this.#guard.mensajeAviso(),
+        };
+    }
+    estado() {
+        const r = this.#guard.resumen();
+        return {
+            bytesEscritos: this.#bytesEscritos,
+            chunksEscritos: this.#chunksEscritos,
+            truncado: r.truncado,
+            bytesDescartados: r.bytesDescartados,
+            bucleDetectado: this.#bucleDetectado,
+            disparosWatchdog: this.#watchdog.disparos,
+            mensajeAviso: this.#guard.mensajeAviso(),
+        };
+    }
+}
+//# sourceMappingURL=runner.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"timings.d.ts","sourceRoot":"","sources":["../../src/core/timings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,KAAK,WAAW,GAAG,MAAM,GAAG,YAAY,CAAC;AAIzC,wBAAgB,YAAY,CAAC,SAAS,GAAE,WAAoB,GAAG,IAAI,CAGlE;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,WAAoB,GAAG,IAAI,CAWzE;AAaD,wBAAgB,YAAY,IAAI,IAAI,CAKnC","sourcesContent":["/**\n * Central timing instrumentation for startup profiling.\n * Enable with PI_TIMING=1 environment variable.\n */\n\nconst ENABLED = process.env.PI_TIMING === \"1\";\ninterface TimingNamespace {\n\ttimings: Array<{ label: string; ms: number }>;\n\tlastTime: number;\n}\n\ntype TimingLabel = \"main\" | \"extensions\";\n\nconst timingNamespaces = new Map<TimingLabel, TimingNamespace>();\n\nexport function resetTimings(namespace: TimingLabel = \"main\"): void {\n\tif (!ENABLED) return;\n\ttimingNamespaces.set(namespace, { timings: [], lastTime: Date.now() });\n}\n\nexport function time(label: string, namespace: TimingLabel = \"main\"): void {\n\tif (!ENABLED) return;\n\tconst now = Date.now();\n\n\tif (!timingNamespaces.has(namespace)) {\n\t\tresetTimings(namespace);\n\t}\n\n\tconst timingNamespace = timingNamespaces.get(namespace)!;\n\ttimingNamespace.timings.push({ label, ms: now - timingNamespace.lastTime });\n\ttimingNamespace.lastTime = now;\n}\n\nfunction printTimingGroup(title: string, timings: TimingNamespace[\"timings\"]): void {\n\tconst printableTimings = timings.filter((timing) => timing.ms >= 0);\n\tif (printableTimings.length === 0) return;\n\tconsole.error(`\\n--- ${title} ---`);\n\tfor (const t of printableTimings) {\n\t\tconsole.error(`  ${t.label}: ${t.ms}ms`);\n\t}\n\tconsole.error(`  TOTAL: ${printableTimings.reduce((a, b) => a + b.ms, 0)}ms`);\n\tconsole.error(`${\"-\".repeat(title.length + 8)}\\n`);\n}\n\nexport function printTimings(): void {\n\tif (!ENABLED) return;\n\tfor (const [namespace, timingNamespace] of timingNamespaces) {\n\t\tprintTimingGroup(`Startup Timings: ${namespace}`, timingNamespace.timings);\n\t}\n}\n"]}
+{"version":3,"file":"timings.d.ts","sourceRoot":"","sources":["../../src/core/timings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,KAAK,WAAW,GAAG,MAAM,GAAG,YAAY,CAAC;AAIzC,wBAAgB,YAAY,CAAC,SAAS,GAAE,WAAoB,GAAG,IAAI,CAGlE;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,WAAoB,GAAG,IAAI,CAWzE;AAaD,wBAAgB,YAAY,IAAI,IAAI,CAKnC"}

package/dist/core/timings.js.map

@@ -1 +1 @@
-{"version":3,"file":"timings.js","sourceRoot":"","sources":["../../src/core/timings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC;AAQ9C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAgC,CAAC;AAEjE,MAAM,UAAU,YAAY,CAAC,SAAS,GAAgB,MAAM,EAAQ;IACnE,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAAA,CACvE;AAED,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,SAAS,GAAgB,MAAM,EAAQ;IAC1E,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,YAAY,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,eAAe,GAAG,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;IACzD,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,eAAe,CAAC,QAAQ,GAAG,GAAG,CAAC;AAAA,CAC/B;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,OAAmC,EAAQ;IACnF,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACpE,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC1C,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,YAAY,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AAAA,CACnD;AAED,MAAM,UAAU,YAAY,GAAS;IACpC,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,KAAK,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAC7D,gBAAgB,CAAC,oBAAoB,SAAS,EAAE,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5E,CAAC;AAAA,CACD","sourcesContent":["/**\n * Central timing instrumentation for startup profiling.\n * Enable with PI_TIMING=1 environment variable.\n */\n\nconst ENABLED = process.env.PI_TIMING === \"1\";\ninterface TimingNamespace {\n\ttimings: Array<{ label: string; ms: number }>;\n\tlastTime: number;\n}\n\ntype TimingLabel = \"main\" | \"extensions\";\n\nconst timingNamespaces = new Map<TimingLabel, TimingNamespace>();\n\nexport function resetTimings(namespace: TimingLabel = \"main\"): void {\n\tif (!ENABLED) return;\n\ttimingNamespaces.set(namespace, { timings: [], lastTime: Date.now() });\n}\n\nexport function time(label: string, namespace: TimingLabel = \"main\"): void {\n\tif (!ENABLED) return;\n\tconst now = Date.now();\n\n\tif (!timingNamespaces.has(namespace)) {\n\t\tresetTimings(namespace);\n\t}\n\n\tconst timingNamespace = timingNamespaces.get(namespace)!;\n\ttimingNamespace.timings.push({ label, ms: now - timingNamespace.lastTime });\n\ttimingNamespace.lastTime = now;\n}\n\nfunction printTimingGroup(title: string, timings: TimingNamespace[\"timings\"]): void {\n\tconst printableTimings = timings.filter((timing) => timing.ms >= 0);\n\tif (printableTimings.length === 0) return;\n\tconsole.error(`\\n--- ${title} ---`);\n\tfor (const t of printableTimings) {\n\t\tconsole.error(`  ${t.label}: ${t.ms}ms`);\n\t}\n\tconsole.error(`  TOTAL: ${printableTimings.reduce((a, b) => a + b.ms, 0)}ms`);\n\tconsole.error(`${\"-\".repeat(title.length + 8)}\\n`);\n}\n\nexport function printTimings(): void {\n\tif (!ENABLED) return;\n\tfor (const [namespace, timingNamespace] of timingNamespaces) {\n\t\tprintTimingGroup(`Startup Timings: ${namespace}`, timingNamespace.timings);\n\t}\n}\n"]}
+{"version":3,"file":"timings.js","sourceRoot":"","sources":["../../src/core/timings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC;AAQ9C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAgC,CAAC;AAEjE,MAAM,UAAU,YAAY,CAAC,YAAyB,MAAM;IAC3D,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,YAAyB,MAAM;IAClE,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,YAAY,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,eAAe,GAAG,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;IACzD,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,eAAe,CAAC,QAAQ,GAAG,GAAG,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,OAAmC;IAC3E,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IACpE,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC1C,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,YAAY,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,KAAK,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAC7D,gBAAgB,CAAC,oBAAoB,SAAS,EAAE,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5E,CAAC;AACF,CAAC"}