@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/blobs/almacen.js

@@ -0,0 +1,198 @@
+/**
+ * Caché en disco de los identificadores que devuelve la API de ficheros del
+ * proveedor, indexada por (proveedor, hash del contenido).
+ *
+ * Por qué en disco y no en memoria: el ahorro grande no es entre turnos de una
+ * sesión —eso lo daría un Map— sino entre SESIONES. La captura de pantalla que
+ * pegaste ayer y vuelves a pegar hoy es el mismo fichero para el proveedor, y
+ * volver a subir 1,4 MB es tiempo y cuota tirados.
+ *
+ * Por qué se relee el fichero antes de escribir: hay más de un proceso de Ada
+ * a la vez (CLI + escritorio + subagentes) y todos apuntan al mismo agentDir.
+ * Escribir el mapa entero desde memoria haría que el último en cerrar borrase
+ * lo que subieron los demás; ya nos pasó con un fichero compartido y varios
+ * escritores. Aquí se funde por entrada, quedándose con la de uso más reciente.
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+const MAX_EDAD_POR_DEFECTO_MS = 30 * 24 * 60 * 60 * 1000;
+const MAX_ENTRADAS_POR_DEFECTO = 500;
+/**
+ * Clave del mapa. El separador es `|` y no un byte NUL a propósito: un NUL en
+ * el fichero lo vuelve binario para `grep` y para `git diff`, y este fichero se
+ * mira a mano cuando algo va mal.
+ */
+export function claveDeBlob(proveedor, hash) {
+    return `${proveedor}|${hash}`;
+}
+function esEntrada(valor) {
+    if (!valor || typeof valor !== "object")
+        return false;
+    const e = valor;
+    return (typeof e.id === "string" &&
+        e.id.length > 0 &&
+        typeof e.bytes === "number" &&
+        typeof e.mime === "string" &&
+        typeof e.subidoEn === "number" &&
+        typeof e.usadoEn === "number");
+}
+function leerFichero(texto) {
+    const mapa = new Map();
+    let crudo;
+    try {
+        crudo = JSON.parse(texto);
+    }
+    catch {
+        // Un fichero corrupto se trata como vacío: como mucho se resube. Fallar
+        // aquí dejaría al agente sin poder mandar adjuntos por un JSON roto.
+        return mapa;
+    }
+    const doc = crudo;
+    if (!doc || typeof doc !== "object" || !doc.entradas || typeof doc.entradas !== "object")
+        return mapa;
+    for (const [clave, valor] of Object.entries(doc.entradas)) {
+        if (esEntrada(valor))
+            mapa.set(clave, valor);
+    }
+    return mapa;
+}
+export class AlmacenDeBlobs {
+    ruta;
+    entradas = new Map();
+    sucio = false;
+    /**
+     * Claves quitadas A PROPÓSITO (id muerto, purga por edad, purga a mano). La
+     * fusión de `volcar()` las tiene que borrar también de la copia en disco: si
+     * no, la entrada que este proceso acaba de tirar vuelve desde el fichero que
+     * dejó otro proceso y la purga no llega nunca al disco.
+     *
+     * Vive aquí y no en quien llama porque el llamador se olvida: la purga
+     * automática del arranque lo hacía y la de `/blobs purgar` no, así que el
+     * fichero crecía sin límite y las entradas de más de 30 días resucitaban en
+     * cada volcado. Comprobado ejecutándolo: purgar + volcar dejaba la clave
+     * `anthropic|aaa` intacta en disco.
+     */
+    olvidadas = new Set();
+    constructor(agentDir, nombreFichero = "blobs.json") {
+        this.ruta = join(agentDir, nombreFichero);
+    }
+    get rutaFichero() {
+        return this.ruta;
+    }
+    async cargar() {
+        try {
+            this.entradas = leerFichero(await readFile(this.ruta, "utf-8"));
+        }
+        catch {
+            // No existe todavía: primer arranque.
+            this.entradas = new Map();
+        }
+    }
+    /** Devuelve la entrada y marca el uso. `undefined` = no la tenemos. */
+    leer(proveedor, hash, ahora = Date.now()) {
+        const entrada = this.entradas.get(claveDeBlob(proveedor, hash));
+        if (!entrada)
+            return undefined;
+        entrada.usadoEn = ahora;
+        this.sucio = true;
+        return entrada;
+    }
+    guardar(proveedor, hash, entrada) {
+        const clave = claveDeBlob(proveedor, hash);
+        this.entradas.set(clave, entrada);
+        // Se ha vuelto a subir: deja de estar olvidada, o la fusión la borraría
+        // justo después de haberla pagado.
+        this.olvidadas.delete(clave);
+        this.sucio = true;
+    }
+    /**
+     * Borra una entrada. Se llama cuando el proveedor rechaza el id: mejor
+     * resubir 1 MB que dejar la conversación atada a un id muerto.
+     */
+    olvidar(proveedor, hash) {
+        const clave = claveDeBlob(proveedor, hash);
+        const borrada = this.entradas.delete(clave);
+        this.olvidadas.add(clave);
+        if (borrada)
+            this.sucio = true;
+        return borrada;
+    }
+    olvidarPorId(id) {
+        const borradas = [];
+        for (const [clave, entrada] of this.entradas) {
+            if (entrada.id !== id)
+                continue;
+            this.entradas.delete(clave);
+            this.olvidadas.add(clave);
+            borradas.push(clave);
+        }
+        if (borradas.length > 0)
+            this.sucio = true;
+        return borradas;
+    }
+    tamano() {
+        return this.entradas.size;
+    }
+    // Aquí vivía `listar()`. Nadie lo llamaba: `/blobs` enseña el tamaño y la
+    // ruta del fichero, que se mira a mano. Borrado por lo mismo que
+    // `borrarFichero`.
+    /** Devuelve las claves purgadas. Por edad primero, por número después. */
+    purgar(opciones = {}) {
+        const ahora = opciones.ahora ?? Date.now();
+        const maxEdadMs = opciones.maxEdadMs ?? MAX_EDAD_POR_DEFECTO_MS;
+        const maxEntradas = opciones.maxEntradas ?? MAX_ENTRADAS_POR_DEFECTO;
+        const purgadas = [];
+        for (const [clave, entrada] of this.entradas) {
+            if (ahora - entrada.usadoEn > maxEdadMs) {
+                this.entradas.delete(clave);
+                purgadas.push(clave);
+            }
+        }
+        if (this.entradas.size > maxEntradas) {
+            const porAntiguedad = [...this.entradas].sort((a, b) => a[1].usadoEn - b[1].usadoEn);
+            const sobran = this.entradas.size - maxEntradas;
+            for (const [clave] of porAntiguedad.slice(0, sobran)) {
+                this.entradas.delete(clave);
+                purgadas.push(clave);
+            }
+        }
+        if (purgadas.length > 0)
+            this.sucio = true;
+        for (const clave of purgadas)
+            this.olvidadas.add(clave);
+        return purgadas;
+    }
+    /**
+     * Escribe fundiendo con lo que haya en disco. Las claves que este proceso ha
+     * borrado a propósito se quitan de la fusión: sin eso, la fusión las
+     * resucitaría desde la copia en disco de otro proceso y volveríamos a mandar
+     * un id que ya sabemos muerto, o a guardar para siempre lo que purgamos.
+     */
+    async volcar(olvidadas = []) {
+        if (!this.sucio)
+            return;
+        let enDisco = new Map();
+        try {
+            enDisco = leerFichero(await readFile(this.ruta, "utf-8"));
+        }
+        catch {
+            // Sin fichero previo: la fusión es la identidad.
+        }
+        for (const clave of this.olvidadas)
+            enDisco.delete(clave);
+        for (const clave of olvidadas)
+            enDisco.delete(clave);
+        for (const [clave, mia] of this.entradas) {
+            const suya = enDisco.get(clave);
+            enDisco.set(clave, !suya || mia.usadoEn >= suya.usadoEn ? mia : suya);
+        }
+        const doc = { version: 1, entradas: Object.fromEntries(enDisco) };
+        await mkdir(dirname(this.ruta), { recursive: true });
+        const temporal = `${this.ruta}.${process.pid}.tmp`;
+        await writeFile(temporal, JSON.stringify(doc, null, "\t"), "utf-8");
+        await rename(temporal, this.ruta);
+        this.entradas = enDisco;
+        this.sucio = false;
+    }
+}
+//# sourceMappingURL=almacen.js.map

package/dist/core/blobs/almacen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"almacen.js","sourceRoot":"","sources":["../../../src/core/blobs/almacen.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Caché en disco de los identificadores que devuelve la API de ficheros del\n * proveedor, indexada por (proveedor, hash del contenido).\n *\n * Por qué en disco y no en memoria: el ahorro grande no es entre turnos de una\n * sesión —eso lo daría un Map— sino entre SESIONES. La captura de pantalla que\n * pegaste ayer y vuelves a pegar hoy es el mismo fichero para el proveedor, y\n * volver a subir 1,4 MB es tiempo y cuota tirados.\n *\n * Por qué se relee el fichero antes de escribir: hay más de un proceso de Ada\n * a la vez (CLI + escritorio + subagentes) y todos apuntan al mismo agentDir.\n * Escribir el mapa entero desde memoria haría que el último en cerrar borrase\n * lo que subieron los demás; ya nos pasó con un fichero compartido y varios\n * escritores. Aquí se funde por entrada, quedándose con la de uso más reciente.\n */\n\nimport { mkdir, readFile, rename, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\n\nexport interface EntradaDeBlob {\n\t/** Identificador que devolvió el proveedor (`file_...` / `file-...`). */\n\tid: string;\n\t/** Tamaño en bytes del contenido original, para el informe de `/blobs`. */\n\tbytes: number;\n\tmime: string;\n\t/** Milisegundos epoch de la subida. */\n\tsubidoEn: number;\n\t/** Milisegundos epoch del último uso; manda en la purga y en la fusión. */\n\tusadoEn: number;\n}\n\nexport interface OpcionesDePurga {\n\t/** Edad máxima desde el último uso. Por defecto 30 días. */\n\tmaxEdadMs?: number;\n\t/** Número máximo de entradas que se conservan. Por defecto 500. */\n\tmaxEntradas?: number;\n\t/** Reloj inyectable; los tests no pueden esperar 30 días. */\n\tahora?: number;\n}\n\nconst MAX_EDAD_POR_DEFECTO_MS = 30 * 24 * 60 * 60 * 1000;\nconst MAX_ENTRADAS_POR_DEFECTO = 500;\n\n/**\n * Clave del mapa. El separador es `|` y no un byte NUL a propósito: un NUL en\n * el fichero lo vuelve binario para `grep` y para `git diff`, y este fichero se\n * mira a mano cuando algo va mal.\n */\nexport function claveDeBlob(proveedor: string, hash: string): string {\n\treturn `${proveedor}|${hash}`;\n}\n\ninterface FicheroDeBlobs {\n\tversion: number;\n\tentradas: Record<string, EntradaDeBlob>;\n}\n\nfunction esEntrada(valor: unknown): valor is EntradaDeBlob {\n\tif (!valor || typeof valor !== \"object\") return false;\n\tconst e = valor as Record<string, unknown>;\n\treturn (\n\t\ttypeof e.id === \"string\" &&\n\t\te.id.length > 0 &&\n\t\ttypeof e.bytes === \"number\" &&\n\t\ttypeof e.mime === \"string\" &&\n\t\ttypeof e.subidoEn === \"number\" &&\n\t\ttypeof e.usadoEn === \"number\"\n\t);\n}\n\nfunction leerFichero(texto: string): Map<string, EntradaDeBlob> {\n\tconst mapa = new Map<string, EntradaDeBlob>();\n\tlet crudo: unknown;\n\ttry {\n\t\tcrudo = JSON.parse(texto);\n\t} catch {\n\t\t// Un fichero corrupto se trata como vacío: como mucho se resube. Fallar\n\t\t// aquí dejaría al agente sin poder mandar adjuntos por un JSON roto.\n\t\treturn mapa;\n\t}\n\tconst doc = crudo as Partial<FicheroDeBlobs> | null;\n\tif (!doc || typeof doc !== \"object\" || !doc.entradas || typeof doc.entradas !== \"object\") return mapa;\n\tfor (const [clave, valor] of Object.entries(doc.entradas)) {\n\t\tif (esEntrada(valor)) mapa.set(clave, valor);\n\t}\n\treturn mapa;\n}\n\nexport class AlmacenDeBlobs {\n\tprivate readonly ruta: string;\n\tprivate entradas = new Map<string, EntradaDeBlob>();\n\tprivate sucio = false;\n\t/**\n\t * Claves quitadas A PROPÓSITO (id muerto, purga por edad, purga a mano). La\n\t * fusión de `volcar()` las tiene que borrar también de la copia en disco: si\n\t * no, la entrada que este proceso acaba de tirar vuelve desde el fichero que\n\t * dejó otro proceso y la purga no llega nunca al disco.\n\t *\n\t * Vive aquí y no en quien llama porque el llamador se olvida: la purga\n\t * automática del arranque lo hacía y la de `/blobs purgar` no, así que el\n\t * fichero crecía sin límite y las entradas de más de 30 días resucitaban en\n\t * cada volcado. Comprobado ejecutándolo: purgar + volcar dejaba la clave\n\t * `anthropic|aaa` intacta en disco.\n\t */\n\tprivate readonly olvidadas = new Set<string>();\n\n\tconstructor(agentDir: string, nombreFichero = \"blobs.json\") {\n\t\tthis.ruta = join(agentDir, nombreFichero);\n\t}\n\n\tget rutaFichero(): string {\n\t\treturn this.ruta;\n\t}\n\n\tasync cargar(): Promise<void> {\n\t\ttry {\n\t\t\tthis.entradas = leerFichero(await readFile(this.ruta, \"utf-8\"));\n\t\t} catch {\n\t\t\t// No existe todavía: primer arranque.\n\t\t\tthis.entradas = new Map();\n\t\t}\n\t}\n\n\t/** Devuelve la entrada y marca el uso. `undefined` = no la tenemos. */\n\tleer(proveedor: string, hash: string, ahora = Date.now()): EntradaDeBlob | undefined {\n\t\tconst entrada = this.entradas.get(claveDeBlob(proveedor, hash));\n\t\tif (!entrada) return undefined;\n\t\tentrada.usadoEn = ahora;\n\t\tthis.sucio = true;\n\t\treturn entrada;\n\t}\n\n\tguardar(proveedor: string, hash: string, entrada: EntradaDeBlob): void {\n\t\tconst clave = claveDeBlob(proveedor, hash);\n\t\tthis.entradas.set(clave, entrada);\n\t\t// Se ha vuelto a subir: deja de estar olvidada, o la fusión la borraría\n\t\t// justo después de haberla pagado.\n\t\tthis.olvidadas.delete(clave);\n\t\tthis.sucio = true;\n\t}\n\n\t/**\n\t * Borra una entrada. Se llama cuando el proveedor rechaza el id: mejor\n\t * resubir 1 MB que dejar la conversación atada a un id muerto.\n\t */\n\tolvidar(proveedor: string, hash: string): boolean {\n\t\tconst clave = claveDeBlob(proveedor, hash);\n\t\tconst borrada = this.entradas.delete(clave);\n\t\tthis.olvidadas.add(clave);\n\t\tif (borrada) this.sucio = true;\n\t\treturn borrada;\n\t}\n\n\tolvidarPorId(id: string): string[] {\n\t\tconst borradas: string[] = [];\n\t\tfor (const [clave, entrada] of this.entradas) {\n\t\t\tif (entrada.id !== id) continue;\n\t\t\tthis.entradas.delete(clave);\n\t\t\tthis.olvidadas.add(clave);\n\t\t\tborradas.push(clave);\n\t\t}\n\t\tif (borradas.length > 0) this.sucio = true;\n\t\treturn borradas;\n\t}\n\n\ttamano(): number {\n\t\treturn this.entradas.size;\n\t}\n\n\t// Aquí vivía `listar()`. Nadie lo llamaba: `/blobs` enseña el tamaño y la\n\t// ruta del fichero, que se mira a mano. Borrado por lo mismo que\n\t// `borrarFichero`.\n\n\t/** Devuelve las claves purgadas. Por edad primero, por número después. */\n\tpurgar(opciones: OpcionesDePurga = {}): string[] {\n\t\tconst ahora = opciones.ahora ?? Date.now();\n\t\tconst maxEdadMs = opciones.maxEdadMs ?? MAX_EDAD_POR_DEFECTO_MS;\n\t\tconst maxEntradas = opciones.maxEntradas ?? MAX_ENTRADAS_POR_DEFECTO;\n\t\tconst purgadas: string[] = [];\n\n\t\tfor (const [clave, entrada] of this.entradas) {\n\t\t\tif (ahora - entrada.usadoEn > maxEdadMs) {\n\t\t\t\tthis.entradas.delete(clave);\n\t\t\t\tpurgadas.push(clave);\n\t\t\t}\n\t\t}\n\n\t\tif (this.entradas.size > maxEntradas) {\n\t\t\tconst porAntiguedad = [...this.entradas].sort((a, b) => a[1].usadoEn - b[1].usadoEn);\n\t\t\tconst sobran = this.entradas.size - maxEntradas;\n\t\t\tfor (const [clave] of porAntiguedad.slice(0, sobran)) {\n\t\t\t\tthis.entradas.delete(clave);\n\t\t\t\tpurgadas.push(clave);\n\t\t\t}\n\t\t}\n\n\t\tif (purgadas.length > 0) this.sucio = true;\n\t\tfor (const clave of purgadas) this.olvidadas.add(clave);\n\t\treturn purgadas;\n\t}\n\n\t/**\n\t * Escribe fundiendo con lo que haya en disco. Las claves que este proceso ha\n\t * borrado a propósito se quitan de la fusión: sin eso, la fusión las\n\t * resucitaría desde la copia en disco de otro proceso y volveríamos a mandar\n\t * un id que ya sabemos muerto, o a guardar para siempre lo que purgamos.\n\t */\n\tasync volcar(olvidadas: Iterable<string> = []): Promise<void> {\n\t\tif (!this.sucio) return;\n\t\tlet enDisco = new Map<string, EntradaDeBlob>();\n\t\ttry {\n\t\t\tenDisco = leerFichero(await readFile(this.ruta, \"utf-8\"));\n\t\t} catch {\n\t\t\t// Sin fichero previo: la fusión es la identidad.\n\t\t}\n\t\tfor (const clave of this.olvidadas) enDisco.delete(clave);\n\t\tfor (const clave of olvidadas) enDisco.delete(clave);\n\t\tfor (const [clave, mia] of this.entradas) {\n\t\t\tconst suya = enDisco.get(clave);\n\t\t\tenDisco.set(clave, !suya || mia.usadoEn >= suya.usadoEn ? mia : suya);\n\t\t}\n\t\tconst doc: FicheroDeBlobs = { version: 1, entradas: Object.fromEntries(enDisco) };\n\t\tawait mkdir(dirname(this.ruta), { recursive: true });\n\t\tconst temporal = `${this.ruta}.${process.pid}.tmp`;\n\t\tawait writeFile(temporal, JSON.stringify(doc, null, \"\\t\"), \"utf-8\");\n\t\tawait rename(temporal, this.ruta);\n\t\tthis.entradas = enDisco;\n\t\tthis.sucio = false;\n\t}\n}\n"]}

package/dist/core/blobs/broker.d.ts

@@ -0,0 +1,103 @@
+/**
+ * El broker: decide, para cada adjunto de una petición, si se sube, se
+ * reutiliza un id que ya teníamos, o se deja en línea como siempre.
+ *
+ * Tres reglas que no son negociables, y por qué:
+ *
+ * 1. Nunca se rompe la conversación. Si la subida falla, si la credencial no
+ *    está, si el proveedor no contesta — el adjunto viaja en línea igual que
+ *    antes de que este módulo existiera. Este módulo solo puede AHORRAR; nunca
+ *    puede ser el motivo de que un turno no salga.
+ *
+ * 2. Un id que viene de una sesión anterior no se usa a ciegas. Se comprueba
+ *    UNA vez por proceso. Si el proveedor dice 404, se olvida y se resube; si
+ *    la red falla no sabemos nada, y "no sé" no es "está muerto": ese turno va
+ *    en línea y se vuelve a intentar en el siguiente.
+ *
+ * 3. El informe distingue tres cosas: "no había nada que subir", "no puedo
+ *    subir y este es el motivo" y "lo he subido/reutilizado". Un `[]` y un
+ *    `null` no significan lo mismo y no se mezclan nunca.
+ */
+import type { AlmacenDeBlobs } from "./almacen.ts";
+import { type Credencial, type Fetch, type ModeloParaBlobs } from "./proveedor.ts";
+/** 1 MiB. Por debajo de esto la subida cuesta más latencia de la que ahorra. */
+export declare const MIN_BYTES_POR_DEFECTO: number;
+export interface OmisionDeBlob {
+    bytes: number;
+    motivo: string;
+}
+export type Diagnostico = {
+    estado: "listo";
+    subidos: number;
+    reutilizados: number;
+    /** Adjuntos que había pero no se pudieron referenciar, con su motivo. */
+    omitidos: OmisionDeBlob[];
+} | {
+    estado: "nada-que-subir";
+    /** Adjuntos vistos pero por debajo del umbral. */
+    pequenos: number;
+} | {
+    estado: "no-puedo";
+    motivo: string;
+};
+export interface ResultadoDeProceso {
+    payload: unknown;
+    diagnostico: Diagnostico;
+}
+export interface OpcionesDeBroker {
+    almacen: AlmacenDeBlobs;
+    fetchImpl?: Fetch;
+    minBytes?: number;
+}
+export declare function hashDeContenido(datos: Uint8Array): string;
+/**
+ * ¿Este estado HTTP se puede achacar a las referencias a fichero que acabamos
+ * de mandar?
+ *
+ * 401, 403 y 429 quedan fuera: son credencial y cuota. Apagar el ahorro para el
+ * resto del proceso en la primera racha de rate limit sería leer "espera" como
+ * "no puedes", que es el defecto que este repositorio persigue. El resto de la
+ * familia 4xx sí: un `file_id` que el proveedor no acepta sale por ahí, y
+ * pagar una subida de más es más barato que repetir el fallo turno tras turno.
+ *
+ * Vive suelta y no dentro de la clase porque la usan los DOS caminos que apagan
+ * la reescritura (`after_provider_response` y `message_end`); tenerlo duplicado
+ * ya hizo que uno de los dos apagara con un 429.
+ */
+export declare function esRechazoDeReferencias(estado: number): boolean;
+export declare class BrokerDeBlobs {
+    private readonly almacen;
+    /**
+     * `undefined` = usar el `fetch` global EN EL MOMENTO DE LA LLAMADA, no el
+     * que hubiera al construir el broker. El despachador HTTP de Ada instala su
+     * propio `globalThis.fetch` (proxy, timeouts) DESPUÉS de cargar las
+     * extensiones; capturarlo en el constructor se saltaría esa configuración.
+     */
+    private readonly fetchImpl;
+    private readonly minBytes;
+    /** Ids que este proceso ya sabe vivos (los subió él o los verificó). */
+    private readonly verificados;
+    /** Referencias que viajaron en la última petición, para atribuir un 4xx. */
+    private ultimosEnviados;
+    /** Contadores para `/blobs`. */
+    readonly contadores: {
+        subidas: number;
+        reutilizaciones: number;
+        resubidasPorRechazo: number;
+    };
+    constructor(opciones: OpcionesDeBroker);
+    procesar(payload: unknown, modelo: ModeloParaBlobs | undefined, credencial: Credencial | undefined, signal?: AbortSignal): Promise<ResultadoDeProceso>;
+    private referenciaPara;
+    /**
+     * El proveedor rechazó la petición justo después de que le mandáramos
+     * referencias. No sabemos si fue por ellas —el evento no trae cuerpo—, pero
+     * un id inválido es la causa más cara de descartar: se olvidan y el turno
+     * siguiente resube. Como mucho se paga una subida de más.
+     */
+    rechazoDelProveedor(estado: number): string[];
+    peticionCorrecta(): void;
+    private red;
+    private olvidar;
+    volcar(): Promise<void>;
+}
+//# sourceMappingURL=broker.d.ts.map

package/dist/core/blobs/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../src/core/blobs/broker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAEN,KAAK,UAAU,EAEf,KAAK,KAAK,EACV,KAAK,eAAe,EAIpB,MAAM,gBAAgB,CAAC;AAExB,iFAAgF;AAChF,eAAO,MAAM,qBAAqB,QAAc,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GACpB;IACA,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,0EAAyE;IACzE,QAAQ,EAAE,aAAa,EAAE,CAAC;CACzB,GACD;IACA,MAAM,EAAE,gBAAgB,CAAC;IACzB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAChB,GACD;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,2EAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,8EAA4E;IAC5E,OAAO,CAAC,eAAe,CAAmB;IAC1C,gCAAgC;IAChC,QAAQ,CAAC,UAAU;;;;MAA8D;IAEjF,YAAY,QAAQ,EAAE,gBAAgB,EAIrC;IAEK,QAAQ,CACb,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAmE7B;YAEa,cAAc;IAgD5B;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAY5C;IAED,gBAAgB,IAAI,IAAI,CAEvB;IAED,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,OAAO;IAIT,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5B;CACD","sourcesContent":["/**\n * El broker: decide, para cada adjunto de una petición, si se sube, se\n * reutiliza un id que ya teníamos, o se deja en línea como siempre.\n *\n * Tres reglas que no son negociables, y por qué:\n *\n * 1. Nunca se rompe la conversación. Si la subida falla, si la credencial no\n *    está, si el proveedor no contesta — el adjunto viaja en línea igual que\n *    antes de que este módulo existiera. Este módulo solo puede AHORRAR; nunca\n *    puede ser el motivo de que un turno no salga.\n *\n * 2. Un id que viene de una sesión anterior no se usa a ciegas. Se comprueba\n *    UNA vez por proceso. Si el proveedor dice 404, se olvida y se resube; si\n *    la red falla no sabemos nada, y \"no sé\" no es \"está muerto\": ese turno va\n *    en línea y se vuelve a intentar en el siguiente.\n *\n * 3. El informe distingue tres cosas: \"no había nada que subir\", \"no puedo\n *    subir y este es el motivo\" y \"lo he subido/reutilizado\". Un `[]` y un\n *    `null` no significan lo mismo y no se mezclan nunca.\n */\n\nimport { createHash } from \"node:crypto\";\nimport type { AlmacenDeBlobs } from \"./almacen.ts\";\nimport { type BloqueBlob, claveDeRuta, localizarBlobs, reescribirBlobs } from \"./payload.ts\";\nimport {\n\ttype CapacidadDeBlobs,\n\ttype Credencial,\n\tcapacidadDeBlobs,\n\ttype Fetch,\n\ttype ModeloParaBlobs,\n\tpuedeSubir,\n\tsubirFichero,\n\tverificarFichero,\n} from \"./proveedor.ts\";\n\n/** 1 MiB. Por debajo de esto la subida cuesta más latencia de la que ahorra. */\nexport const MIN_BYTES_POR_DEFECTO = 1024 * 1024;\n\nexport interface OmisionDeBlob {\n\tbytes: number;\n\tmotivo: string;\n}\n\nexport type Diagnostico =\n\t| {\n\t\t\testado: \"listo\";\n\t\t\tsubidos: number;\n\t\t\treutilizados: number;\n\t\t\t/** Adjuntos que había pero no se pudieron referenciar, con su motivo. */\n\t\t\tomitidos: OmisionDeBlob[];\n\t  }\n\t| {\n\t\t\testado: \"nada-que-subir\";\n\t\t\t/** Adjuntos vistos pero por debajo del umbral. */\n\t\t\tpequenos: number;\n\t  }\n\t| { estado: \"no-puedo\"; motivo: string };\n\nexport interface ResultadoDeProceso {\n\tpayload: unknown;\n\tdiagnostico: Diagnostico;\n}\n\nexport interface OpcionesDeBroker {\n\talmacen: AlmacenDeBlobs;\n\tfetchImpl?: Fetch;\n\tminBytes?: number;\n}\n\ninterface IdEnviado {\n\tproveedor: string;\n\thash: string;\n\tid: string;\n}\n\nexport function hashDeContenido(datos: Uint8Array): string {\n\treturn createHash(\"sha256\").update(datos).digest(\"hex\");\n}\n\n/**\n * ¿Este estado HTTP se puede achacar a las referencias a fichero que acabamos\n * de mandar?\n *\n * 401, 403 y 429 quedan fuera: son credencial y cuota. Apagar el ahorro para el\n * resto del proceso en la primera racha de rate limit sería leer \"espera\" como\n * \"no puedes\", que es el defecto que este repositorio persigue. El resto de la\n * familia 4xx sí: un `file_id` que el proveedor no acepta sale por ahí, y\n * pagar una subida de más es más barato que repetir el fallo turno tras turno.\n *\n * Vive suelta y no dentro de la clase porque la usan los DOS caminos que apagan\n * la reescritura (`after_provider_response` y `message_end`); tenerlo duplicado\n * ya hizo que uno de los dos apagara con un 429.\n */\nexport function esRechazoDeReferencias(estado: number): boolean {\n\tif (estado < 400 || estado >= 500) return false;\n\treturn estado !== 401 && estado !== 403 && estado !== 429;\n}\n\nexport class BrokerDeBlobs {\n\tprivate readonly almacen: AlmacenDeBlobs;\n\t/**\n\t * `undefined` = usar el `fetch` global EN EL MOMENTO DE LA LLAMADA, no el\n\t * que hubiera al construir el broker. El despachador HTTP de Ada instala su\n\t * propio `globalThis.fetch` (proxy, timeouts) DESPUÉS de cargar las\n\t * extensiones; capturarlo en el constructor se saltaría esa configuración.\n\t */\n\tprivate readonly fetchImpl: Fetch | undefined;\n\tprivate readonly minBytes: number;\n\t/** Ids que este proceso ya sabe vivos (los subió él o los verificó). */\n\tprivate readonly verificados = new Set<string>();\n\t/** Referencias que viajaron en la última petición, para atribuir un 4xx. */\n\tprivate ultimosEnviados: IdEnviado[] = [];\n\t/** Contadores para `/blobs`. */\n\treadonly contadores = { subidas: 0, reutilizaciones: 0, resubidasPorRechazo: 0 };\n\n\tconstructor(opciones: OpcionesDeBroker) {\n\t\tthis.almacen = opciones.almacen;\n\t\tthis.fetchImpl = opciones.fetchImpl;\n\t\tthis.minBytes = opciones.minBytes ?? MIN_BYTES_POR_DEFECTO;\n\t}\n\n\tasync procesar(\n\t\tpayload: unknown,\n\t\tmodelo: ModeloParaBlobs | undefined,\n\t\tcredencial: Credencial | undefined,\n\t\tsignal?: AbortSignal,\n\t): Promise<ResultadoDeProceso> {\n\t\tthis.ultimosEnviados = [];\n\t\tconst capacidad = capacidadDeBlobs(modelo);\n\t\tif (!puedeSubir(capacidad)) {\n\t\t\treturn { payload, diagnostico: { estado: \"no-puedo\", motivo: capacidad.motivo } };\n\t\t}\n\t\tif (!credencial || (!credencial.apiKey && !credencial.cabeceras)) {\n\t\t\treturn {\n\t\t\t\tpayload,\n\t\t\t\tdiagnostico: { estado: \"no-puedo\", motivo: `sin credencial resuelta para \"${capacidad.proveedor}\"` },\n\t\t\t};\n\t\t}\n\n\t\tconst candidatos = localizarBlobs(payload, modelo?.api ?? \"\");\n\t\tif (candidatos === null) {\n\t\t\t// El payload no tiene la forma que esperábamos para esta API. Decirlo,\n\t\t\t// no callarlo: si upstream cambia la forma, esto se ve en `/blobs`.\n\t\t\treturn {\n\t\t\t\tpayload,\n\t\t\t\tdiagnostico: { estado: \"no-puedo\", motivo: `el payload de \"${modelo?.api}\" no tiene la forma esperada` },\n\t\t\t};\n\t\t}\n\n\t\tconst grandes = candidatos.filter((bloque) => bloque.bytes >= this.minBytes);\n\t\tif (grandes.length === 0) {\n\t\t\treturn { payload, diagnostico: { estado: \"nada-que-subir\", pequenos: candidatos.length } };\n\t\t}\n\n\t\tconst ids = new Map<string, string>();\n\t\tconst omitidos: OmisionDeBlob[] = [];\n\t\tlet subidos = 0;\n\t\tlet reutilizados = 0;\n\t\t/** Dentro de una misma petición, el mismo contenido se resuelve una vez. */\n\t\tconst resueltosAqui = new Map<string, string>();\n\n\t\tfor (const bloque of grandes) {\n\t\t\tconst datos = Buffer.from(bloque.base64, \"base64\");\n\t\t\tconst hash = hashDeContenido(datos);\n\n\t\t\tconst yaResuelto = resueltosAqui.get(hash);\n\t\t\tif (yaResuelto) {\n\t\t\t\tids.set(claveDeRuta(bloque.ruta), yaResuelto);\n\t\t\t\treutilizados++;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst resultado = await this.referenciaPara(capacidad, credencial, hash, datos, bloque, signal);\n\t\t\tif (!resultado.ok) {\n\t\t\t\tomitidos.push({ bytes: bloque.bytes, motivo: resultado.motivo });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tresueltosAqui.set(hash, resultado.id);\n\t\t\tids.set(claveDeRuta(bloque.ruta), resultado.id);\n\t\t\tthis.ultimosEnviados.push({ proveedor: capacidad.proveedor, hash, id: resultado.id });\n\t\t\tif (resultado.nueva) {\n\t\t\t\tsubidos++;\n\t\t\t\tthis.contadores.subidas++;\n\t\t\t} else {\n\t\t\t\treutilizados++;\n\t\t\t\tthis.contadores.reutilizaciones++;\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\tpayload: reescribirBlobs(payload, modelo?.api ?? \"\", ids),\n\t\t\tdiagnostico: { estado: \"listo\", subidos, reutilizados, omitidos },\n\t\t};\n\t}\n\n\tprivate async referenciaPara(\n\t\tcapacidad: CapacidadDeBlobs,\n\t\tcredencial: Credencial,\n\t\thash: string,\n\t\tdatos: Uint8Array,\n\t\tbloque: BloqueBlob,\n\t\tsignal?: AbortSignal,\n\t): Promise<{ ok: true; id: string; nueva: boolean } | { ok: false; motivo: string }> {\n\t\tconst entrada = this.almacen.leer(capacidad.proveedor, hash);\n\t\tif (entrada) {\n\t\t\tif (this.verificados.has(entrada.id)) return { ok: true, id: entrada.id, nueva: false };\n\t\t\tconst estado = await verificarFichero(capacidad, credencial, entrada.id, this.red(), signal);\n\t\t\tif (estado === \"vivo\") {\n\t\t\t\tthis.verificados.add(entrada.id);\n\t\t\t\treturn { ok: true, id: entrada.id, nueva: false };\n\t\t\t}\n\t\t\tif (estado === \"muerto\") {\n\t\t\t\tthis.olvidar(capacidad.proveedor, hash);\n\t\t\t\tthis.contadores.resubidasPorRechazo++;\n\t\t\t\t// Cae a la subida de abajo: un id caducado se resube, no se falla.\n\t\t\t} else {\n\t\t\t\t// \"desconocido\": no sabemos si sirve. Este turno va en línea.\n\t\t\t\treturn { ok: false, motivo: `no se pudo verificar el id ${entrada.id}; el adjunto va en línea` };\n\t\t\t}\n\t\t}\n\n\t\tconst nombre = `ada-${hash.slice(0, 16)}.${extensionDe(bloque.mime)}`;\n\t\tconst subida = await subirFichero(\n\t\t\tcapacidad,\n\t\t\tcredencial,\n\t\t\t{ datos, mime: bloque.mime, nombre },\n\t\t\tthis.red(),\n\t\t\tsignal,\n\t\t);\n\t\tif (!subida.ok) return { ok: false, motivo: subida.motivo };\n\n\t\tconst ahora = Date.now();\n\t\tthis.almacen.guardar(capacidad.proveedor, hash, {\n\t\t\tid: subida.id,\n\t\t\tbytes: bloque.bytes,\n\t\t\tmime: bloque.mime,\n\t\t\tsubidoEn: ahora,\n\t\t\tusadoEn: ahora,\n\t\t});\n\t\tthis.verificados.add(subida.id);\n\t\treturn { ok: true, id: subida.id, nueva: true };\n\t}\n\n\t/**\n\t * El proveedor rechazó la petición justo después de que le mandáramos\n\t * referencias. No sabemos si fue por ellas —el evento no trae cuerpo—, pero\n\t * un id inválido es la causa más cara de descartar: se olvidan y el turno\n\t * siguiente resube. Como mucho se paga una subida de más.\n\t */\n\trechazoDelProveedor(estado: number): string[] {\n\t\tif (!esRechazoDeReferencias(estado)) return [];\n\t\tif (this.ultimosEnviados.length === 0) return [];\n\t\tconst olvidados: string[] = [];\n\t\tfor (const enviado of this.ultimosEnviados) {\n\t\t\tthis.olvidar(enviado.proveedor, enviado.hash);\n\t\t\tthis.verificados.delete(enviado.id);\n\t\t\tthis.contadores.resubidasPorRechazo++;\n\t\t\tolvidados.push(enviado.id);\n\t\t}\n\t\tthis.ultimosEnviados = [];\n\t\treturn olvidados;\n\t}\n\n\tpeticionCorrecta(): void {\n\t\tthis.ultimosEnviados = [];\n\t}\n\n\tprivate red(): Fetch {\n\t\treturn this.fetchImpl ?? globalThis.fetch;\n\t}\n\n\tprivate olvidar(proveedor: string, hash: string): void {\n\t\tthis.almacen.olvidar(proveedor, hash);\n\t}\n\n\tasync volcar(): Promise<void> {\n\t\tawait this.almacen.volcar();\n\t}\n}\n\nfunction extensionDe(mime: string): string {\n\tconst cola = mime.split(\"/\")[1] ?? \"bin\";\n\treturn cola.replace(/[^a-z0-9]/gi, \"\") || \"bin\";\n}\n"]}

package/dist/core/blobs/broker.js

@@ -0,0 +1,204 @@
+/**
+ * El broker: decide, para cada adjunto de una petición, si se sube, se
+ * reutiliza un id que ya teníamos, o se deja en línea como siempre.
+ *
+ * Tres reglas que no son negociables, y por qué:
+ *
+ * 1. Nunca se rompe la conversación. Si la subida falla, si la credencial no
+ *    está, si el proveedor no contesta — el adjunto viaja en línea igual que
+ *    antes de que este módulo existiera. Este módulo solo puede AHORRAR; nunca
+ *    puede ser el motivo de que un turno no salga.
+ *
+ * 2. Un id que viene de una sesión anterior no se usa a ciegas. Se comprueba
+ *    UNA vez por proceso. Si el proveedor dice 404, se olvida y se resube; si
+ *    la red falla no sabemos nada, y "no sé" no es "está muerto": ese turno va
+ *    en línea y se vuelve a intentar en el siguiente.
+ *
+ * 3. El informe distingue tres cosas: "no había nada que subir", "no puedo
+ *    subir y este es el motivo" y "lo he subido/reutilizado". Un `[]` y un
+ *    `null` no significan lo mismo y no se mezclan nunca.
+ */
+import { createHash } from "node:crypto";
+import { claveDeRuta, localizarBlobs, reescribirBlobs } from "./payload.js";
+import { capacidadDeBlobs, puedeSubir, subirFichero, verificarFichero, } from "./proveedor.js";
+/** 1 MiB. Por debajo de esto la subida cuesta más latencia de la que ahorra. */
+export const MIN_BYTES_POR_DEFECTO = 1024 * 1024;
+export function hashDeContenido(datos) {
+    return createHash("sha256").update(datos).digest("hex");
+}
+/**
+ * ¿Este estado HTTP se puede achacar a las referencias a fichero que acabamos
+ * de mandar?
+ *
+ * 401, 403 y 429 quedan fuera: son credencial y cuota. Apagar el ahorro para el
+ * resto del proceso en la primera racha de rate limit sería leer "espera" como
+ * "no puedes", que es el defecto que este repositorio persigue. El resto de la
+ * familia 4xx sí: un `file_id` que el proveedor no acepta sale por ahí, y
+ * pagar una subida de más es más barato que repetir el fallo turno tras turno.
+ *
+ * Vive suelta y no dentro de la clase porque la usan los DOS caminos que apagan
+ * la reescritura (`after_provider_response` y `message_end`); tenerlo duplicado
+ * ya hizo que uno de los dos apagara con un 429.
+ */
+export function esRechazoDeReferencias(estado) {
+    if (estado < 400 || estado >= 500)
+        return false;
+    return estado !== 401 && estado !== 403 && estado !== 429;
+}
+export class BrokerDeBlobs {
+    almacen;
+    /**
+     * `undefined` = usar el `fetch` global EN EL MOMENTO DE LA LLAMADA, no el
+     * que hubiera al construir el broker. El despachador HTTP de Ada instala su
+     * propio `globalThis.fetch` (proxy, timeouts) DESPUÉS de cargar las
+     * extensiones; capturarlo en el constructor se saltaría esa configuración.
+     */
+    fetchImpl;
+    minBytes;
+    /** Ids que este proceso ya sabe vivos (los subió él o los verificó). */
+    verificados = new Set();
+    /** Referencias que viajaron en la última petición, para atribuir un 4xx. */
+    ultimosEnviados = [];
+    /** Contadores para `/blobs`. */
+    contadores = { subidas: 0, reutilizaciones: 0, resubidasPorRechazo: 0 };
+    constructor(opciones) {
+        this.almacen = opciones.almacen;
+        this.fetchImpl = opciones.fetchImpl;
+        this.minBytes = opciones.minBytes ?? MIN_BYTES_POR_DEFECTO;
+    }
+    async procesar(payload, modelo, credencial, signal) {
+        this.ultimosEnviados = [];
+        const capacidad = capacidadDeBlobs(modelo);
+        if (!puedeSubir(capacidad)) {
+            return { payload, diagnostico: { estado: "no-puedo", motivo: capacidad.motivo } };
+        }
+        if (!credencial || (!credencial.apiKey && !credencial.cabeceras)) {
+            return {
+                payload,
+                diagnostico: { estado: "no-puedo", motivo: `sin credencial resuelta para "${capacidad.proveedor}"` },
+            };
+        }
+        const candidatos = localizarBlobs(payload, modelo?.api ?? "");
+        if (candidatos === null) {
+            // El payload no tiene la forma que esperábamos para esta API. Decirlo,
+            // no callarlo: si upstream cambia la forma, esto se ve en `/blobs`.
+            return {
+                payload,
+                diagnostico: { estado: "no-puedo", motivo: `el payload de "${modelo?.api}" no tiene la forma esperada` },
+            };
+        }
+        const grandes = candidatos.filter((bloque) => bloque.bytes >= this.minBytes);
+        if (grandes.length === 0) {
+            return { payload, diagnostico: { estado: "nada-que-subir", pequenos: candidatos.length } };
+        }
+        const ids = new Map();
+        const omitidos = [];
+        let subidos = 0;
+        let reutilizados = 0;
+        /** Dentro de una misma petición, el mismo contenido se resuelve una vez. */
+        const resueltosAqui = new Map();
+        for (const bloque of grandes) {
+            const datos = Buffer.from(bloque.base64, "base64");
+            const hash = hashDeContenido(datos);
+            const yaResuelto = resueltosAqui.get(hash);
+            if (yaResuelto) {
+                ids.set(claveDeRuta(bloque.ruta), yaResuelto);
+                reutilizados++;
+                continue;
+            }
+            const resultado = await this.referenciaPara(capacidad, credencial, hash, datos, bloque, signal);
+            if (!resultado.ok) {
+                omitidos.push({ bytes: bloque.bytes, motivo: resultado.motivo });
+                continue;
+            }
+            resueltosAqui.set(hash, resultado.id);
+            ids.set(claveDeRuta(bloque.ruta), resultado.id);
+            this.ultimosEnviados.push({ proveedor: capacidad.proveedor, hash, id: resultado.id });
+            if (resultado.nueva) {
+                subidos++;
+                this.contadores.subidas++;
+            }
+            else {
+                reutilizados++;
+                this.contadores.reutilizaciones++;
+            }
+        }
+        return {
+            payload: reescribirBlobs(payload, modelo?.api ?? "", ids),
+            diagnostico: { estado: "listo", subidos, reutilizados, omitidos },
+        };
+    }
+    async referenciaPara(capacidad, credencial, hash, datos, bloque, signal) {
+        const entrada = this.almacen.leer(capacidad.proveedor, hash);
+        if (entrada) {
+            if (this.verificados.has(entrada.id))
+                return { ok: true, id: entrada.id, nueva: false };
+            const estado = await verificarFichero(capacidad, credencial, entrada.id, this.red(), signal);
+            if (estado === "vivo") {
+                this.verificados.add(entrada.id);
+                return { ok: true, id: entrada.id, nueva: false };
+            }
+            if (estado === "muerto") {
+                this.olvidar(capacidad.proveedor, hash);
+                this.contadores.resubidasPorRechazo++;
+                // Cae a la subida de abajo: un id caducado se resube, no se falla.
+            }
+            else {
+                // "desconocido": no sabemos si sirve. Este turno va en línea.
+                return { ok: false, motivo: `no se pudo verificar el id ${entrada.id}; el adjunto va en línea` };
+            }
+        }
+        const nombre = `ada-${hash.slice(0, 16)}.${extensionDe(bloque.mime)}`;
+        const subida = await subirFichero(capacidad, credencial, { datos, mime: bloque.mime, nombre }, this.red(), signal);
+        if (!subida.ok)
+            return { ok: false, motivo: subida.motivo };
+        const ahora = Date.now();
+        this.almacen.guardar(capacidad.proveedor, hash, {
+            id: subida.id,
+            bytes: bloque.bytes,
+            mime: bloque.mime,
+            subidoEn: ahora,
+            usadoEn: ahora,
+        });
+        this.verificados.add(subida.id);
+        return { ok: true, id: subida.id, nueva: true };
+    }
+    /**
+     * El proveedor rechazó la petición justo después de que le mandáramos
+     * referencias. No sabemos si fue por ellas —el evento no trae cuerpo—, pero
+     * un id inválido es la causa más cara de descartar: se olvidan y el turno
+     * siguiente resube. Como mucho se paga una subida de más.
+     */
+    rechazoDelProveedor(estado) {
+        if (!esRechazoDeReferencias(estado))
+            return [];
+        if (this.ultimosEnviados.length === 0)
+            return [];
+        const olvidados = [];
+        for (const enviado of this.ultimosEnviados) {
+            this.olvidar(enviado.proveedor, enviado.hash);
+            this.verificados.delete(enviado.id);
+            this.contadores.resubidasPorRechazo++;
+            olvidados.push(enviado.id);
+        }
+        this.ultimosEnviados = [];
+        return olvidados;
+    }
+    peticionCorrecta() {
+        this.ultimosEnviados = [];
+    }
+    red() {
+        return this.fetchImpl ?? globalThis.fetch;
+    }
+    olvidar(proveedor, hash) {
+        this.almacen.olvidar(proveedor, hash);
+    }
+    async volcar() {
+        await this.almacen.volcar();
+    }
+}
+function extensionDe(mime) {
+    const cola = mime.split("/")[1] ?? "bin";
+    return cola.replace(/[^a-z0-9]/gi, "") || "bin";
+}
+//# sourceMappingURL=broker.js.map

package/dist/core/blobs/broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../../src/core/blobs/broker.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * El broker: decide, para cada adjunto de una petición, si se sube, se\n * reutiliza un id que ya teníamos, o se deja en línea como siempre.\n *\n * Tres reglas que no son negociables, y por qué:\n *\n * 1. Nunca se rompe la conversación. Si la subida falla, si la credencial no\n *    está, si el proveedor no contesta — el adjunto viaja en línea igual que\n *    antes de que este módulo existiera. Este módulo solo puede AHORRAR; nunca\n *    puede ser el motivo de que un turno no salga.\n *\n * 2. Un id que viene de una sesión anterior no se usa a ciegas. Se comprueba\n *    UNA vez por proceso. Si el proveedor dice 404, se olvida y se resube; si\n *    la red falla no sabemos nada, y \"no sé\" no es \"está muerto\": ese turno va\n *    en línea y se vuelve a intentar en el siguiente.\n *\n * 3. El informe distingue tres cosas: \"no había nada que subir\", \"no puedo\n *    subir y este es el motivo\" y \"lo he subido/reutilizado\". Un `[]` y un\n *    `null` no significan lo mismo y no se mezclan nunca.\n */\n\nimport { createHash } from \"node:crypto\";\nimport type { AlmacenDeBlobs } from \"./almacen.ts\";\nimport { type BloqueBlob, claveDeRuta, localizarBlobs, reescribirBlobs } from \"./payload.ts\";\nimport {\n\ttype CapacidadDeBlobs,\n\ttype Credencial,\n\tcapacidadDeBlobs,\n\ttype Fetch,\n\ttype ModeloParaBlobs,\n\tpuedeSubir,\n\tsubirFichero,\n\tverificarFichero,\n} from \"./proveedor.ts\";\n\n/** 1 MiB. Por debajo de esto la subida cuesta más latencia de la que ahorra. */\nexport const MIN_BYTES_POR_DEFECTO = 1024 * 1024;\n\nexport interface OmisionDeBlob {\n\tbytes: number;\n\tmotivo: string;\n}\n\nexport type Diagnostico =\n\t| {\n\t\t\testado: \"listo\";\n\t\t\tsubidos: number;\n\t\t\treutilizados: number;\n\t\t\t/** Adjuntos que había pero no se pudieron referenciar, con su motivo. */\n\t\t\tomitidos: OmisionDeBlob[];\n\t  }\n\t| {\n\t\t\testado: \"nada-que-subir\";\n\t\t\t/** Adjuntos vistos pero por debajo del umbral. */\n\t\t\tpequenos: number;\n\t  }\n\t| { estado: \"no-puedo\"; motivo: string };\n\nexport interface ResultadoDeProceso {\n\tpayload: unknown;\n\tdiagnostico: Diagnostico;\n}\n\nexport interface OpcionesDeBroker {\n\talmacen: AlmacenDeBlobs;\n\tfetchImpl?: Fetch;\n\tminBytes?: number;\n}\n\ninterface IdEnviado {\n\tproveedor: string;\n\thash: string;\n\tid: string;\n}\n\nexport function hashDeContenido(datos: Uint8Array): string {\n\treturn createHash(\"sha256\").update(datos).digest(\"hex\");\n}\n\n/**\n * ¿Este estado HTTP se puede achacar a las referencias a fichero que acabamos\n * de mandar?\n *\n * 401, 403 y 429 quedan fuera: son credencial y cuota. Apagar el ahorro para el\n * resto del proceso en la primera racha de rate limit sería leer \"espera\" como\n * \"no puedes\", que es el defecto que este repositorio persigue. El resto de la\n * familia 4xx sí: un `file_id` que el proveedor no acepta sale por ahí, y\n * pagar una subida de más es más barato que repetir el fallo turno tras turno.\n *\n * Vive suelta y no dentro de la clase porque la usan los DOS caminos que apagan\n * la reescritura (`after_provider_response` y `message_end`); tenerlo duplicado\n * ya hizo que uno de los dos apagara con un 429.\n */\nexport function esRechazoDeReferencias(estado: number): boolean {\n\tif (estado < 400 || estado >= 500) return false;\n\treturn estado !== 401 && estado !== 403 && estado !== 429;\n}\n\nexport class BrokerDeBlobs {\n\tprivate readonly almacen: AlmacenDeBlobs;\n\t/**\n\t * `undefined` = usar el `fetch` global EN EL MOMENTO DE LA LLAMADA, no el\n\t * que hubiera al construir el broker. El despachador HTTP de Ada instala su\n\t * propio `globalThis.fetch` (proxy, timeouts) DESPUÉS de cargar las\n\t * extensiones; capturarlo en el constructor se saltaría esa configuración.\n\t */\n\tprivate readonly fetchImpl: Fetch | undefined;\n\tprivate readonly minBytes: number;\n\t/** Ids que este proceso ya sabe vivos (los subió él o los verificó). */\n\tprivate readonly verificados = new Set<string>();\n\t/** Referencias que viajaron en la última petición, para atribuir un 4xx. */\n\tprivate ultimosEnviados: IdEnviado[] = [];\n\t/** Contadores para `/blobs`. */\n\treadonly contadores = { subidas: 0, reutilizaciones: 0, resubidasPorRechazo: 0 };\n\n\tconstructor(opciones: OpcionesDeBroker) {\n\t\tthis.almacen = opciones.almacen;\n\t\tthis.fetchImpl = opciones.fetchImpl;\n\t\tthis.minBytes = opciones.minBytes ?? MIN_BYTES_POR_DEFECTO;\n\t}\n\n\tasync procesar(\n\t\tpayload: unknown,\n\t\tmodelo: ModeloParaBlobs | undefined,\n\t\tcredencial: Credencial | undefined,\n\t\tsignal?: AbortSignal,\n\t): Promise<ResultadoDeProceso> {\n\t\tthis.ultimosEnviados = [];\n\t\tconst capacidad = capacidadDeBlobs(modelo);\n\t\tif (!puedeSubir(capacidad)) {\n\t\t\treturn { payload, diagnostico: { estado: \"no-puedo\", motivo: capacidad.motivo } };\n\t\t}\n\t\tif (!credencial || (!credencial.apiKey && !credencial.cabeceras)) {\n\t\t\treturn {\n\t\t\t\tpayload,\n\t\t\t\tdiagnostico: { estado: \"no-puedo\", motivo: `sin credencial resuelta para \"${capacidad.proveedor}\"` },\n\t\t\t};\n\t\t}\n\n\t\tconst candidatos = localizarBlobs(payload, modelo?.api ?? \"\");\n\t\tif (candidatos === null) {\n\t\t\t// El payload no tiene la forma que esperábamos para esta API. Decirlo,\n\t\t\t// no callarlo: si upstream cambia la forma, esto se ve en `/blobs`.\n\t\t\treturn {\n\t\t\t\tpayload,\n\t\t\t\tdiagnostico: { estado: \"no-puedo\", motivo: `el payload de \"${modelo?.api}\" no tiene la forma esperada` },\n\t\t\t};\n\t\t}\n\n\t\tconst grandes = candidatos.filter((bloque) => bloque.bytes >= this.minBytes);\n\t\tif (grandes.length === 0) {\n\t\t\treturn { payload, diagnostico: { estado: \"nada-que-subir\", pequenos: candidatos.length } };\n\t\t}\n\n\t\tconst ids = new Map<string, string>();\n\t\tconst omitidos: OmisionDeBlob[] = [];\n\t\tlet subidos = 0;\n\t\tlet reutilizados = 0;\n\t\t/** Dentro de una misma petición, el mismo contenido se resuelve una vez. */\n\t\tconst resueltosAqui = new Map<string, string>();\n\n\t\tfor (const bloque of grandes) {\n\t\t\tconst datos = Buffer.from(bloque.base64, \"base64\");\n\t\t\tconst hash = hashDeContenido(datos);\n\n\t\t\tconst yaResuelto = resueltosAqui.get(hash);\n\t\t\tif (yaResuelto) {\n\t\t\t\tids.set(claveDeRuta(bloque.ruta), yaResuelto);\n\t\t\t\treutilizados++;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst resultado = await this.referenciaPara(capacidad, credencial, hash, datos, bloque, signal);\n\t\t\tif (!resultado.ok) {\n\t\t\t\tomitidos.push({ bytes: bloque.bytes, motivo: resultado.motivo });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tresueltosAqui.set(hash, resultado.id);\n\t\t\tids.set(claveDeRuta(bloque.ruta), resultado.id);\n\t\t\tthis.ultimosEnviados.push({ proveedor: capacidad.proveedor, hash, id: resultado.id });\n\t\t\tif (resultado.nueva) {\n\t\t\t\tsubidos++;\n\t\t\t\tthis.contadores.subidas++;\n\t\t\t} else {\n\t\t\t\treutilizados++;\n\t\t\t\tthis.contadores.reutilizaciones++;\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\tpayload: reescribirBlobs(payload, modelo?.api ?? \"\", ids),\n\t\t\tdiagnostico: { estado: \"listo\", subidos, reutilizados, omitidos },\n\t\t};\n\t}\n\n\tprivate async referenciaPara(\n\t\tcapacidad: CapacidadDeBlobs,\n\t\tcredencial: Credencial,\n\t\thash: string,\n\t\tdatos: Uint8Array,\n\t\tbloque: BloqueBlob,\n\t\tsignal?: AbortSignal,\n\t): Promise<{ ok: true; id: string; nueva: boolean } | { ok: false; motivo: string }> {\n\t\tconst entrada = this.almacen.leer(capacidad.proveedor, hash);\n\t\tif (entrada) {\n\t\t\tif (this.verificados.has(entrada.id)) return { ok: true, id: entrada.id, nueva: false };\n\t\t\tconst estado = await verificarFichero(capacidad, credencial, entrada.id, this.red(), signal);\n\t\t\tif (estado === \"vivo\") {\n\t\t\t\tthis.verificados.add(entrada.id);\n\t\t\t\treturn { ok: true, id: entrada.id, nueva: false };\n\t\t\t}\n\t\t\tif (estado === \"muerto\") {\n\t\t\t\tthis.olvidar(capacidad.proveedor, hash);\n\t\t\t\tthis.contadores.resubidasPorRechazo++;\n\t\t\t\t// Cae a la subida de abajo: un id caducado se resube, no se falla.\n\t\t\t} else {\n\t\t\t\t// \"desconocido\": no sabemos si sirve. Este turno va en línea.\n\t\t\t\treturn { ok: false, motivo: `no se pudo verificar el id ${entrada.id}; el adjunto va en línea` };\n\t\t\t}\n\t\t}\n\n\t\tconst nombre = `ada-${hash.slice(0, 16)}.${extensionDe(bloque.mime)}`;\n\t\tconst subida = await subirFichero(\n\t\t\tcapacidad,\n\t\t\tcredencial,\n\t\t\t{ datos, mime: bloque.mime, nombre },\n\t\t\tthis.red(),\n\t\t\tsignal,\n\t\t);\n\t\tif (!subida.ok) return { ok: false, motivo: subida.motivo };\n\n\t\tconst ahora = Date.now();\n\t\tthis.almacen.guardar(capacidad.proveedor, hash, {\n\t\t\tid: subida.id,\n\t\t\tbytes: bloque.bytes,\n\t\t\tmime: bloque.mime,\n\t\t\tsubidoEn: ahora,\n\t\t\tusadoEn: ahora,\n\t\t});\n\t\tthis.verificados.add(subida.id);\n\t\treturn { ok: true, id: subida.id, nueva: true };\n\t}\n\n\t/**\n\t * El proveedor rechazó la petición justo después de que le mandáramos\n\t * referencias. No sabemos si fue por ellas —el evento no trae cuerpo—, pero\n\t * un id inválido es la causa más cara de descartar: se olvidan y el turno\n\t * siguiente resube. Como mucho se paga una subida de más.\n\t */\n\trechazoDelProveedor(estado: number): string[] {\n\t\tif (!esRechazoDeReferencias(estado)) return [];\n\t\tif (this.ultimosEnviados.length === 0) return [];\n\t\tconst olvidados: string[] = [];\n\t\tfor (const enviado of this.ultimosEnviados) {\n\t\t\tthis.olvidar(enviado.proveedor, enviado.hash);\n\t\t\tthis.verificados.delete(enviado.id);\n\t\t\tthis.contadores.resubidasPorRechazo++;\n\t\t\tolvidados.push(enviado.id);\n\t\t}\n\t\tthis.ultimosEnviados = [];\n\t\treturn olvidados;\n\t}\n\n\tpeticionCorrecta(): void {\n\t\tthis.ultimosEnviados = [];\n\t}\n\n\tprivate red(): Fetch {\n\t\treturn this.fetchImpl ?? globalThis.fetch;\n\t}\n\n\tprivate olvidar(proveedor: string, hash: string): void {\n\t\tthis.almacen.olvidar(proveedor, hash);\n\t}\n\n\tasync volcar(): Promise<void> {\n\t\tawait this.almacen.volcar();\n\t}\n}\n\nfunction extensionDe(mime: string): string {\n\tconst cola = mime.split(\"/\")[1] ?? \"bin\";\n\treturn cola.replace(/[^a-z0-9]/gi, \"\") || \"bin\";\n}\n"]}