@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/colaboracion/autoresearch.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Bucle autoresearch mínimo — EVAL-02 (Fase 4).
+ *
+ * Referencia omp: autoresearch/{storage,state,helpers}.ts (sesiones/runs en
+ * SQLite, parseo METRIC/ASI, keep=commit / discard=revert, reinyección de
+ * estado). La versión mínima que cierra el hueco "goal-engine sin protocolo
+ * experimental auditable":
+ *
+ *   hipótesis → ejecuta banco (ejecutor INYECTABLE: los tests corren sin
+ *   gastar una sola llamada, el uso real pasa un ejecutor que corre el banco
+ *   de fiabilidad de core/banco) → parsea líneas `METRIC nombre=valor` →
+ *   registra hipótesis Y resultado en el journal arbolado (reusado) →
+ *   decide keep/discard sobre la métrica principal.
+ *
+ * Keep/discard en el árbol: keep deja la leaf en el resultado (la siguiente
+ * hipótesis parte del mejor estado); discard hace fork hacia atrás, al
+ * último resultado conservado — exactamente la semántica revert de omp,
+ * pero con ramas de árbol en vez de git. Toda decisión queda registrada:
+ * el journal ES la evidencia auditable.
+ */
+import type { JournalTree } from "../sesion/journal-tree.ts";
+export interface RegistroRun {
+    readonly idHipotesis: string;
+    readonly idResultado: string;
+    readonly enunciado: string;
+    readonly metricas: Record<string, number>;
+    /** Valor de la métrica principal (undefined si la salida no la trajo). */
+    readonly valorPrincipal?: number;
+    readonly decision: "keep" | "discard";
+}
+export interface SalidaExperimento {
+    salida: string;
+}
+export interface EjecutorExperimento {
+    ejecutar(enunciado: string): Promise<SalidaExperimento>;
+}
+export interface OpcionesBucle {
+    /** Métrica a optimizar; por defecto la primera que aparezca. */
+    metrica?: string;
+    /** Dirección de optimización. Por defecto maximizar (p. ej. precisión). */
+    maximizar?: boolean;
+}
+/** Parsea las líneas `METRIC nombre=valor` de la salida del experimento. */
+export declare function parsearMetricas(salida: string): Record<string, number>;
+export declare class BucleAutoresearch {
+    private readonly journal;
+    private readonly opciones;
+    constructor(journal: JournalTree, opciones?: OpcionesBucle);
+    ejecutar(hipotesis: readonly string[], ejecutor: EjecutorExperimento): Promise<RegistroRun[]>;
+    /** Half de lectura: los runs registrados, en orden de inserción. */
+    runs(): Array<{
+        tipo: string;
+        data: unknown;
+    }>;
+}
+//# sourceMappingURL=autoresearch.d.ts.map

package/dist/core/colaboracion/autoresearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoresearch.d.ts","sourceRoot":"","sources":["../../../src/core/colaboracion/autoresearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,aAAa;IAC7B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtE;AAED,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAC7B,OAAO,EAAE,WAAW,EAAE,QAAQ,GAAE,aAAkB;IAKxD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkDnG,oEAAoE;IACpE,IAAI,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;CAM9C"}

package/dist/core/colaboracion/autoresearch.js

@@ -0,0 +1,95 @@
+/**
+ * Bucle autoresearch mínimo — EVAL-02 (Fase 4).
+ *
+ * Referencia omp: autoresearch/{storage,state,helpers}.ts (sesiones/runs en
+ * SQLite, parseo METRIC/ASI, keep=commit / discard=revert, reinyección de
+ * estado). La versión mínima que cierra el hueco "goal-engine sin protocolo
+ * experimental auditable":
+ *
+ *   hipótesis → ejecuta banco (ejecutor INYECTABLE: los tests corren sin
+ *   gastar una sola llamada, el uso real pasa un ejecutor que corre el banco
+ *   de fiabilidad de core/banco) → parsea líneas `METRIC nombre=valor` →
+ *   registra hipótesis Y resultado en el journal arbolado (reusado) →
+ *   decide keep/discard sobre la métrica principal.
+ *
+ * Keep/discard en el árbol: keep deja la leaf en el resultado (la siguiente
+ * hipótesis parte del mejor estado); discard hace fork hacia atrás, al
+ * último resultado conservado — exactamente la semántica revert de omp,
+ * pero con ramas de árbol en vez de git. Toda decisión queda registrada:
+ * el journal ES la evidencia auditable.
+ */
+import { randomUUID } from "node:crypto";
+const RE_METRIC = /^\s*METRIC\s+([A-Za-z_]\w*)\s*=\s*(-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?)\s*$/gm;
+/** Parsea las líneas `METRIC nombre=valor` de la salida del experimento. */
+export function parsearMetricas(salida) {
+    const out = {};
+    RE_METRIC.lastIndex = 0;
+    for (let m = RE_METRIC.exec(salida); m !== null; m = RE_METRIC.exec(salida)) {
+        out[m[1]] = Number(m[2]);
+    }
+    return out;
+}
+export class BucleAutoresearch {
+    journal;
+    opciones;
+    constructor(journal, opciones = {}) {
+        this.journal = journal;
+        this.opciones = opciones;
+    }
+    async ejecutar(hipotesis, ejecutor) {
+        if (hipotesis.length === 0)
+            throw new Error("autoresearch: se necesita al menos una hipótesis");
+        const registros = [];
+        let anclaMejor = this.journal.getLeaf()?.id ?? null;
+        let mejorValor;
+        for (const enunciado of hipotesis) {
+            const sufijo = randomUUID().slice(0, 8);
+            const idHipotesis = `ar-h-${sufijo}`;
+            this.journal.append({
+                id: idHipotesis,
+                parentId: this.journal.getLeaf()?.id ?? anclaMejor,
+                type: "autoresearch-hipotesis",
+                data: { enunciado },
+            });
+            const res = await ejecutor.ejecutar(enunciado);
+            const metricas = parsearMetricas(res.salida);
+            const clave = this.opciones.metrica ?? Object.keys(metricas)[0];
+            const valorPrincipal = clave === undefined ? undefined : metricas[clave];
+            let decision;
+            if (valorPrincipal === undefined || mejorValor === undefined) {
+                // Sin métrica comparable no hay base para descartar: se conserva.
+                decision = "keep";
+            }
+            else if (this.opciones.maximizar === false) {
+                decision = valorPrincipal < mejorValor ? "keep" : "discard";
+            }
+            else {
+                decision = valorPrincipal > mejorValor ? "keep" : "discard";
+            }
+            const idResultado = `ar-r-${sufijo}`;
+            this.journal.append({
+                id: idResultado,
+                parentId: idHipotesis,
+                type: "autoresearch-resultado",
+                data: { enunciado, metricas, decision },
+            });
+            registros.push({ idHipotesis, idResultado, enunciado, metricas, valorPrincipal, decision });
+            if (decision === "keep") {
+                mejorValor = valorPrincipal;
+                anclaMejor = this.journal.getLeaf()?.id ?? idResultado;
+            }
+            else if (anclaMejor !== null) {
+                this.journal.fork(anclaMejor);
+            }
+        }
+        return registros;
+    }
+    /** Half de lectura: los runs registrados, en orden de inserción. */
+    runs() {
+        return this.journal
+            .entries()
+            .filter((e) => e.type.startsWith("autoresearch-"))
+            .map((e) => ({ tipo: e.type, data: e.data }));
+    }
+}
+//# sourceMappingURL=autoresearch.js.map

package/dist/core/colaboracion/autoresearch.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * Barrel de colaboración — CO1/EVAL (Fase 4).
+ */
+export type { EjecutorExperimento, OpcionesBucle, RegistroRun, SalidaExperimento, } from "./autoresearch.ts";
+export { BucleAutoresearch, parsearMetricas } from "./autoresearch.ts";
+export type { LenguajeKernel, ResultadoCelda } from "./kernels.ts";
+export { KernelJs, PoolKernels } from "./kernels.ts";
+export type { ResultadoSincronizacion } from "./sesion-colaborativa.ts";
+export { RAIZ_COLABORACION, SesionColaborativa } from "./sesion-colaborativa.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/colaboracion/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACX,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,iBAAiB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/colaboracion/index.js

@@ -0,0 +1,7 @@
+/**
+ * Barrel de colaboración — CO1/EVAL (Fase 4).
+ */
+export { BucleAutoresearch, parsearMetricas } from "./autoresearch.js";
+export { KernelJs, PoolKernels } from "./kernels.js";
+export { RAIZ_COLABORACION, SesionColaborativa } from "./sesion-colaborativa.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/colaboracion/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/colaboracion/kernels.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Kernels de lenguaje persistentes por proyecto — EVAL-01 (Fase 4), versión
+ * mínima JS en proceso.
+ *
+ * Referencia omp: eval/kernel-session-registry.ts (registry de sesiones con
+ * reinicio y claves owner-scoped) + eval/js/{context-manager,worker-*}.ts.
+ * El hallazgo pide "el agente programa y ejecuta experimentos iterativos sin
+ * perder variables". La pieza esencial que falta hoy en ada-cli es ESTADO
+ * VIVO entre llamadas: cada ejecución de bash/workflow arranca de cero.
+ *
+ * Diseño:
+ * - KernelJs mantiene UN contexto vm (node:vm) entre celdas: `let`, `var` e
+ *   implícitos globales persisten; cada celda devuelve su valor de
+ *   completitud (la última expresión).
+ * - PoolKernels registra el kernel como daemon del proyecto EN EL BROKER
+ *   existente (src/core/broker/, reusado sin tocar): un kernel por
+ *   (proyecto, lenguaje), latido en cada ejecución, y los tres estados del
+ *   broker (activo/caducado/huerfano) son los del kernel.
+ *   desenchufado: todo lo registrado es inspeccionable por estados()/ps.
+ * - Py/Rb/Jl llegan cuando haya subprocess runner (mismo pool, otro backend);
+ *   el tipo LenguajeKernel ya deja el hueco tipado.
+ */
+import { Broker } from "../broker/broker.ts";
+import type { PsEntry } from "../broker/types.ts";
+export type LenguajeKernel = "js";
+export interface ResultadoCelda {
+    /** Valor de completitud de la celda (última expresión). */
+    valor: unknown;
+    /** Salida capturada de console.log dentro de la celda. */
+    salida: string[];
+    /** Mensaje de error si la celda falló (el kernel NO muere: sigue vivo). */
+    error?: string;
+}
+export declare class KernelJs {
+    #private;
+    get celdas(): number;
+    ejecutar(codigo: string): ResultadoCelda;
+    reset(): void;
+}
+/**
+ * Un kernel por (projectRoot, lenguaje). El broker lleva la parte de proceso
+ * (un registro por proyecto); el mapa lleva la parte de lenguaje.
+ */
+export declare class PoolKernels {
+    #private;
+    private readonly broker;
+    constructor(broker?: Broker);
+    private clave;
+    /** Devuelve el kernel del proyecto, registrándolo en el broker si no estaba. */
+    obtener(projectRoot: string, lenguaje?: LenguajeKernel): KernelJs;
+    ejecutar(projectRoot: string, codigo: string, lenguaje?: LenguajeKernel): ResultadoCelda;
+    /** Reinicia SOLO ese kernel: estado perdido narrable, registro intacto. */
+    reset(projectRoot: string, lenguaje?: LenguajeKernel): boolean;
+    /** Los tres estados del broker, ahora aplicados a kernels. */
+    estados(): PsEntry[];
+    reapOrphans(): {
+        reaped: readonly PsEntry[];
+        narrativa: string;
+    };
+    /** Cierra todos los kernels y limpia el registro del broker. */
+    cerrar(): void;
+}
+//# sourceMappingURL=kernels.d.ts.map

package/dist/core/colaboracion/kernels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernels.d.ts","sourceRoot":"","sources":["../../../src/core/colaboracion/kernels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC;AAElC,MAAM,WAAW,cAAc;IAC9B,2DAA2D;IAC3D,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAID,qBAAa,QAAQ;;IAIpB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc;IAYxC,KAAK,IAAI,IAAI;CAIb;AAED;;;GAGG;AACH,qBAAa,WAAW;;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,GAAE,MAAsD;IAG1E,OAAO,CAAC,KAAK;IAIb,gFAAgF;IAChF,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAqB,GAAG,QAAQ;IAYvE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAqB,GAAG,cAAc;IAI9F,2EAA2E;IAC3E,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAqB,GAAG,OAAO;IAOpE,8DAA8D;IAC9D,OAAO,IAAI,OAAO,EAAE;IAIpB,WAAW,IAAI;QAAE,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAIhE,gEAAgE;IAChE,MAAM,IAAI,IAAI;CAId"}

package/dist/core/colaboracion/kernels.js

@@ -0,0 +1,99 @@
+/**
+ * Kernels de lenguaje persistentes por proyecto — EVAL-01 (Fase 4), versión
+ * mínima JS en proceso.
+ *
+ * Referencia omp: eval/kernel-session-registry.ts (registry de sesiones con
+ * reinicio y claves owner-scoped) + eval/js/{context-manager,worker-*}.ts.
+ * El hallazgo pide "el agente programa y ejecuta experimentos iterativos sin
+ * perder variables". La pieza esencial que falta hoy en ada-cli es ESTADO
+ * VIVO entre llamadas: cada ejecución de bash/workflow arranca de cero.
+ *
+ * Diseño:
+ * - KernelJs mantiene UN contexto vm (node:vm) entre celdas: `let`, `var` e
+ *   implícitos globales persisten; cada celda devuelve su valor de
+ *   completitud (la última expresión).
+ * - PoolKernels registra el kernel como daemon del proyecto EN EL BROKER
+ *   existente (src/core/broker/, reusado sin tocar): un kernel por
+ *   (proyecto, lenguaje), latido en cada ejecución, y los tres estados del
+ *   broker (activo/caducado/huerfano) son los del kernel.
+ *   desenchufado: todo lo registrado es inspeccionable por estados()/ps.
+ * - Py/Rb/Jl llegan cuando haya subprocess runner (mismo pool, otro backend);
+ *   el tipo LenguajeKernel ya deja el hueco tipado.
+ */
+import * as vm from "node:vm";
+import { Broker } from "../broker/broker.js";
+const TTL_KERNEL_MS = 60_000;
+export class KernelJs {
+    #contexto = vm.createContext({ console: { log: () => { } } });
+    #celda = 0;
+    get celdas() {
+        return this.#celda;
+    }
+    ejecutar(codigo) {
+        const salida = [];
+        this.#contexto.console = { log: (...args) => salida.push(args.map(String).join(" ")) };
+        this.#celda++;
+        try {
+            const valor = vm.runInContext(codigo, this.#contexto);
+            return { valor, salida };
+        }
+        catch (e) {
+            return { valor: undefined, salida, error: e instanceof Error ? e.message : String(e) };
+        }
+    }
+    reset() {
+        this.#contexto = vm.createContext({ console: { log: () => { } } });
+        this.#celda = 0;
+    }
+}
+/**
+ * Un kernel por (projectRoot, lenguaje). El broker lleva la parte de proceso
+ * (un registro por proyecto); el mapa lleva la parte de lenguaje.
+ */
+export class PoolKernels {
+    #kernels = new Map();
+    broker;
+    constructor(broker = new Broker({ heartbeatTtlMs: TTL_KERNEL_MS })) {
+        this.broker = broker;
+    }
+    clave(projectRoot, lenguaje) {
+        return `${projectRoot}::${lenguaje}`;
+    }
+    /** Devuelve el kernel del proyecto, registrándolo en el broker si no estaba. */
+    obtener(projectRoot, lenguaje = "js") {
+        const clave = this.clave(projectRoot, lenguaje);
+        let k = this.#kernels.get(clave);
+        if (!k) {
+            k = new KernelJs();
+            this.#kernels.set(clave, k);
+            this.broker.register(projectRoot);
+        }
+        this.broker.heartbeat(projectRoot);
+        return k;
+    }
+    ejecutar(projectRoot, codigo, lenguaje = "js") {
+        return this.obtener(projectRoot, lenguaje).ejecutar(codigo);
+    }
+    /** Reinicia SOLO ese kernel: estado perdido narrable, registro intacto. */
+    reset(projectRoot, lenguaje = "js") {
+        const k = this.#kernels.get(this.clave(projectRoot, lenguaje));
+        if (!k)
+            return false;
+        k.reset();
+        return true;
+    }
+    /** Los tres estados del broker, ahora aplicados a kernels. */
+    estados() {
+        return this.broker.list();
+    }
+    reapOrphans() {
+        return this.broker.reapOrphans();
+    }
+    /** Cierra todos los kernels y limpia el registro del broker. */
+    cerrar() {
+        for (const root of this.broker.list().map((e) => e.projectRoot))
+            this.broker.unregister(root);
+        this.#kernels.clear();
+    }
+}
+//# sourceMappingURL=kernels.js.map

package/dist/core/colaboracion/kernels.js.map

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

package/dist/core/colaboracion/rele/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Barrel del relay AG8 — streamProxy local para colaboración E2E (CO1).
+ */
+export type { EstadoSala, EventoRele } from "./rele-servidor.ts";
+export { ReleServidor } from "./rele-servidor.ts";
+export type { OpcionesSuscripcion, Suscripcion } from "./suscriptor.ts";
+export { suscribirse } from "./suscriptor.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/colaboracion/rele/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/colaboracion/rele/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/colaboracion/rele/index.js

@@ -0,0 +1,6 @@
+/**
+ * Barrel del relay AG8 — streamProxy local para colaboración E2E (CO1).
+ */
+export { ReleServidor } from "./rele-servidor.js";
+export { suscribirse } from "./suscriptor.js";
+//# sourceMappingURL=index.js.map

package/dist/core/colaboracion/rele/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/colaboracion/rele/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/colaboracion/rele/rele-servidor.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Relay de sala para colaboración E2E — AG8 (streamProxy) / CO1.
+ *
+ * Referencias omp: packages/wire/src/index.ts (relay tonto) y collab-web/
+ * src/lib/{socket,codec,link}.ts (AES-256-GCM). El hallazgo CO1 pide
+ * colaboración cifrada E2E y el AG8 el sustrato de retransmisión; este
+ * servidor es el punto de encuentro de ambos: UN proceso escucha SOLO en
+ * loopback y retransmite a N suscriptores el stream de eventos de una sesión,
+ * con cada evento sellado (scrypt + AES-256-GCM, primitiva de
+ * src/core/share/cifrado.ts, nunca duplicada) bajo el token de sala.
+ *
+ * Postura de secretos:
+ * - El token de sala son 256 bits aleatorios que NUNCA van en argv, ni en
+ *   URLs, ni en logs: viaja en la cabecera `x-rele-token` y es TAMBIÉN la
+ *   clave de sellado. Quien no lo tiene ve ruido autenticado, nada más.
+ * - Sin dependencias nuevas: solo node:*.
+ *
+ * Los tres estados de la sala:
+ * - "activa": hay al menos un suscriptor recibiendo.
+ * - "sin-suscriptores": el relay vive pero nadie escucha en vivo; los
+ *   eventos publicados quedan en el anillo de replay y un cliente que
+ *   reconecte con `x-rele-desde-seq` los recupera.
+ * - "cerrada": cerrarSala(); los suscriptores terminan limpio al recibir 410.
+ */
+/** Estado observable de la sala. */
+export type EstadoSala = "activa" | "sin-suscriptores" | "cerrada";
+/** Un evento de sesión que cruza el relay. */
+export interface EventoRele {
+    readonly tipo: string;
+    readonly datos?: unknown;
+    /** Secuencia monotónica asignada por el relay (replay/dedup en reconexión). */
+    readonly seq?: number;
+}
+export declare class ReleServidor {
+    #private;
+    private constructor();
+    /** Levanta el relay en un puerto efímero de loopback. */
+    static iniciar(): Promise<ReleServidor>;
+    /** Token de sala: clave de acceso Y de sellado. Nunca serializar ni loguear. */
+    get token(): string;
+    get puerto(): number;
+    get url(): string;
+    /** activa (≥1 suscriptor) / sin-suscriptores / cerrada. */
+    get estado(): EstadoSala;
+    /**
+     * Puerta determinista sobre el recuento de suscriptores: resuelve cuando
+     * hay ≥ n conectados (o exactamente 0 si n es 0), o en cuanto la sala
+     * cierra. Evita sondeos con temporizadores reales.
+     */
+    esperarSuscriptores(n: number): Promise<void>;
+    /**
+     * Publica un evento: le asigna seq, lo guarda en el anillo de replay y se
+     * sella (scrypt+AES-256-GCM sobre el token de sala) para retransmitirlo a
+     * los suscriptores actuales. Sin suscriptores el evento ya NO se pierde:
+     * queda en el anillo y un cliente que reconecte con `x-rele-desde-seq`
+     * lo recupera.
+     */
+    publicar(eventoBase: EventoRele): void;
+    /**
+     * Corta las conexiones de suscriptores sin cerrar la sala: simula un
+     * corte de red para que los clientes ejerciten su reconexión con backoff.
+     */
+    cortar(): void;
+    /** Cierra la sala: los suscriptores conectados terminan y recibirán 410. */
+    cerrarSala(): void;
+    /** Apaga el servidor HTTP. Idempotente tras cerrarSala. */
+    parar(): Promise<void>;
+}
+//# sourceMappingURL=rele-servidor.d.ts.map

package/dist/core/colaboracion/rele/rele-servidor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rele-servidor.d.ts","sourceRoot":"","sources":["../../../../src/core/colaboracion/rele/rele-servidor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,oCAAoC;AACpC,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAEnE,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACtB;AAiBD,qBAAa,YAAY;;IAQxB,OAAO;IAYP,yDAAyD;WAC5C,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAS7C,gFAAgF;IAChF,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAMnB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,2DAA2D;IAC3D,IAAI,MAAM,IAAI,UAAU,CAKvB;IAED;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB7C;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAWtC;;;OAGG;IACH,MAAM,IAAI,IAAI;IAQd,4EAA4E;IAC5E,UAAU,IAAI,IAAI;IASlB,2DAA2D;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA+C5B"}