@hoilab/ada-cli 0.84.22 → 0.85.1

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

@@ -0,0 +1,85 @@
+/**
+ * Qué proveedores tienen API de ficheros, y cómo se habla con ella.
+ *
+ * La pieza importante de este fichero no es la subida: es `capacidadDeBlobs`,
+ * que NUNCA devuelve un "no" mudo. Un proveedor sin API de ficheros y un
+ * proveedor con la API pero sin credencial son dos cosas distintas, y las dos
+ * son distintas de "no hay ningún adjunto en esta petición". Confundirlas es el
+ * defecto que más veces nos ha mordido: un "no puedo" leído como "no hay".
+ *
+ * Por qué se exige la URL oficial: un modelo `anthropic-messages` servido por
+ * un gateway (OpenRouter, un proxy propio, Bedrock) habla el mismo dialecto de
+ * mensajes pero NO expone `/v1/files`. Subir ahí devuelve 404 y, peor, un id
+ * inventado por el proxy que luego el modelo no reconoce. Si no es la URL
+ * oficial, decimos por qué no y mandamos el contenido en línea como siempre.
+ */
+/** Lo mínimo que necesitamos del modelo. Evita atarnos al tipo `Model<Api>`. */
+export interface ModeloParaBlobs {
+    provider?: string;
+    api?: string;
+    baseUrl?: string;
+}
+export interface CapacidadDeBlobs {
+    /** Clave de caché: los ids no son intercambiables entre proveedores. */
+    proveedor: string;
+    /** Familia de API de ficheros; decide multipart, cabeceras y forma del ref. */
+    familia: "anthropic" | "openai";
+    /** URL absoluta de la colección de ficheros. */
+    urlFicheros: string;
+    /** Cabeceras extra obligatorias (el beta de la Files API de Anthropic). */
+    cabeceras: Record<string, string>;
+}
+export interface SinCapacidad {
+    /** Por qué NO se puede subir. Nunca vacío. */
+    motivo: string;
+}
+export type ResultadoDeCapacidad = CapacidadDeBlobs | SinCapacidad;
+export declare function puedeSubir(resultado: ResultadoDeCapacidad): resultado is CapacidadDeBlobs;
+/** Beta obligatorio de la Files API de Anthropic. Sin él, /v1/files da 404. */
+export declare const BETA_FICHEROS_ANTHROPIC = "files-api-2025-04-14";
+export declare function capacidadDeBlobs(modelo: ModeloParaBlobs | undefined): ResultadoDeCapacidad;
+export interface Credencial {
+    apiKey?: string;
+    cabeceras?: Record<string, string>;
+}
+export type Fetch = typeof globalThis.fetch;
+export interface RespuestaDeSubida {
+    ok: true;
+    id: string;
+}
+export interface FalloDeSubida {
+    ok: false;
+    /**
+     * `rechazado` = el proveedor contestó y dijo que no (4xx). `transporte` = no
+     * se pudo ni preguntar. La diferencia importa: un rechazo se aprende, un
+     * fallo de transporte se reintenta en el turno siguiente.
+     */
+    clase: "rechazado" | "transporte";
+    motivo: string;
+    estado?: number;
+}
+export type ResultadoDeSubida = RespuestaDeSubida | FalloDeSubida;
+/**
+ * Un token de OAuth de Anthropic (Claude Pro/Max: empieza por `sk-ant-oat`) NO
+ * vale como `x-api-key`. `packages/ai` lo sabe y construye el cliente con
+ * `authToken`, que es `Authorization: Bearer`
+ * (anthropic-messages.ts:873 y :923). El mismo criterio, `includes`, y no un
+ * `startsWith`: el token viaja a veces con prefijo de entorno.
+ */
+export declare function esTokenOAuthAnthropic(apiKey: string): boolean;
+export declare function subirFichero(capacidad: CapacidadDeBlobs, credencial: Credencial, fichero: {
+    datos: Uint8Array;
+    mime: string;
+    nombre: string;
+}, fetchImpl?: Fetch, signal?: AbortSignal): Promise<ResultadoDeSubida>;
+export type EstadoDeFichero = "vivo" | "muerto" | "desconocido";
+/**
+ * ¿Sigue existiendo el id? Se pregunta UNA vez por proceso y solo para ids que
+ * vienen de una sesión anterior. Preguntarlo en cada turno costaría una
+ * petición por adjunto y por turno, que es justo lo que este módulo evita.
+ *
+ * `desconocido` no es `muerto`: si la red falla, no sabemos si el id sirve, y
+ * tratarlo como muerto resubiría el fichero cada vez que hubiera un corte.
+ */
+export declare function verificarFichero(capacidad: CapacidadDeBlobs, credencial: Credencial, id: string, fetchImpl?: Fetch, signal?: AbortSignal): Promise<EstadoDeFichero>;
+//# sourceMappingURL=proveedor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proveedor.d.ts","sourceRoot":"","sources":["../../../src/core/blobs/proveedor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC5B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAEnE,wBAAgB,UAAU,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,IAAI,gBAAgB,CAEzF;AAED,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAe9D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,oBAAoB,CAoD1F;AAID,MAAM,WAAW,UAAU;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,KAAK,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,KAAK,CAAC;IACV;;;;OAIG;IACH,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AA8BD,wBAAsB,YAAY,CACjC,SAAS,EAAE,gBAAgB,EAC3B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5D,SAAS,GAAE,KAAwB,EACnC,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,iBAAiB,CAAC,CA0C5B;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACrC,SAAS,EAAE,gBAAgB,EAC3B,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,MAAM,EACV,SAAS,GAAE,KAAwB,EACnC,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CAe1B"}

package/dist/core/blobs/proveedor.js

@@ -0,0 +1,196 @@
+/**
+ * Qué proveedores tienen API de ficheros, y cómo se habla con ella.
+ *
+ * La pieza importante de este fichero no es la subida: es `capacidadDeBlobs`,
+ * que NUNCA devuelve un "no" mudo. Un proveedor sin API de ficheros y un
+ * proveedor con la API pero sin credencial son dos cosas distintas, y las dos
+ * son distintas de "no hay ningún adjunto en esta petición". Confundirlas es el
+ * defecto que más veces nos ha mordido: un "no puedo" leído como "no hay".
+ *
+ * Por qué se exige la URL oficial: un modelo `anthropic-messages` servido por
+ * un gateway (OpenRouter, un proxy propio, Bedrock) habla el mismo dialecto de
+ * mensajes pero NO expone `/v1/files`. Subir ahí devuelve 404 y, peor, un id
+ * inventado por el proxy que luego el modelo no reconoce. Si no es la URL
+ * oficial, decimos por qué no y mandamos el contenido en línea como siempre.
+ */
+export function puedeSubir(resultado) {
+    return "urlFicheros" in resultado;
+}
+/** Beta obligatorio de la Files API de Anthropic. Sin él, /v1/files da 404. */
+export const BETA_FICHEROS_ANTHROPIC = "files-api-2025-04-14";
+function anfitrion(url) {
+    if (!url)
+        return undefined;
+    try {
+        return new URL(url).host.toLowerCase();
+    }
+    catch {
+        return undefined;
+    }
+}
+function sinBarraFinal(url) {
+    return url.replace(/\/+$/, "");
+}
+export function capacidadDeBlobs(modelo) {
+    if (!modelo)
+        return { motivo: "todavía no hay modelo seleccionado en la sesión" };
+    const proveedor = modelo.provider ?? "?";
+    const api = modelo.api ?? "?";
+    const host = anfitrion(modelo.baseUrl);
+    if (api === "anthropic-messages") {
+        if (proveedor !== "anthropic") {
+            return {
+                motivo: `"${proveedor}" habla el dialecto de mensajes de Anthropic pero no es Anthropic: no expone /v1/files`,
+            };
+        }
+        if (host !== "api.anthropic.com") {
+            return {
+                motivo: `el modelo apunta a ${host ?? "una URL ilegible"} y no a api.anthropic.com: un gateway no expone /v1/files`,
+            };
+        }
+        return {
+            proveedor: "anthropic",
+            familia: "anthropic",
+            urlFicheros: `${sinBarraFinal(modelo.baseUrl ?? "")}/v1/files`,
+            cabeceras: { "anthropic-beta": BETA_FICHEROS_ANTHROPIC, "anthropic-version": "2023-06-01" },
+        };
+    }
+    if (api === "openai-responses") {
+        if (proveedor !== "openai") {
+            return { motivo: `"${proveedor}" usa la API de respuestas de OpenAI pero no expone /v1/files propio` };
+        }
+        if (host !== "api.openai.com") {
+            return {
+                motivo: `el modelo apunta a ${host ?? "una URL ilegible"} y no a api.openai.com: un gateway no expone /v1/files`,
+            };
+        }
+        return {
+            proveedor: "openai",
+            familia: "openai",
+            urlFicheros: `${sinBarraFinal(modelo.baseUrl ?? "")}/files`,
+            cabeceras: {},
+        };
+    }
+    // `openai-completions` acepta `file_id` solo en bloques `file` (PDF), no en
+    // `image_url`; como lo que hoy adjunta Ada son imágenes, aquí no hay nada
+    // que ganar y sí un 400 que ganar. Se dice, no se intenta.
+    if (api === "openai-completions") {
+        return {
+            motivo: `la API "openai-completions" no acepta file_id en bloques de imagen; solo URL o base64 en línea`,
+        };
+    }
+    return { motivo: `la API "${api}" del proveedor "${proveedor}" no tiene API de ficheros conocida` };
+}
+/**
+ * Un token de OAuth de Anthropic (Claude Pro/Max: empieza por `sk-ant-oat`) NO
+ * vale como `x-api-key`. `packages/ai` lo sabe y construye el cliente con
+ * `authToken`, que es `Authorization: Bearer`
+ * (anthropic-messages.ts:873 y :923). El mismo criterio, `includes`, y no un
+ * `startsWith`: el token viaja a veces con prefijo de entorno.
+ */
+export function esTokenOAuthAnthropic(apiKey) {
+    return apiKey.includes("sk-ant-oat");
+}
+function cabecerasDeAuth(capacidad, credencial) {
+    // Las de `capacidad` van LAS ÚLTIMAS y ganan: son obligatorias (el beta de la
+    // Files API). Si una cabecera de proveedor traía su propio `anthropic-beta`,
+    // el orden de antes borraba el beta de ficheros y /v1/files contestaba 404 —
+    // un "no puedo" que se leía como "el proveedor no quiere el fichero".
+    const cabeceras = { ...(credencial.cabeceras ?? {}), ...capacidad.cabeceras };
+    if (credencial.apiKey) {
+        // Con OAuth, mandar la clave en `x-api-key` da 401 en TODAS las subidas: el
+        // módulo entero quedaba muerto para quien entra con Claude Pro/Max, que es
+        // la mayoría, y el motivo que salía en `/blobs` era "401 al subir", que
+        // echa la culpa al proveedor en vez de a la cabecera.
+        if (capacidad.familia === "anthropic" && !esTokenOAuthAnthropic(credencial.apiKey)) {
+            cabeceras["x-api-key"] = credencial.apiKey;
+        }
+        else {
+            cabeceras.authorization = `Bearer ${credencial.apiKey}`;
+        }
+    }
+    return cabeceras;
+}
+async function textoBreve(respuesta) {
+    try {
+        return (await respuesta.text()).slice(0, 300);
+    }
+    catch {
+        return "";
+    }
+}
+export async function subirFichero(capacidad, credencial, fichero, fetchImpl = globalThis.fetch, signal) {
+    const formulario = new FormData();
+    // `new Blob([...])` y no `File`: el segundo no existe en todos los runtimes
+    // donde se ejecutan los tests, y el nombre viaja igual en el `append`.
+    formulario.append("file", new Blob([fichero.datos], { type: fichero.mime }), fichero.nombre);
+    // OpenAI exige `purpose`; Anthropic rechaza campos extra, así que va solo donde toca.
+    if (capacidad.familia === "openai")
+        formulario.append("purpose", "vision");
+    let respuesta;
+    try {
+        respuesta = await fetchImpl(capacidad.urlFicheros, {
+            method: "POST",
+            headers: cabecerasDeAuth(capacidad, credencial),
+            body: formulario,
+            signal,
+        });
+    }
+    catch (error) {
+        return { ok: false, clase: "transporte", motivo: error instanceof Error ? error.message : String(error) };
+    }
+    if (!respuesta.ok) {
+        return {
+            ok: false,
+            clase: respuesta.status >= 400 && respuesta.status < 500 ? "rechazado" : "transporte",
+            estado: respuesta.status,
+            motivo: `${respuesta.status} al subir: ${await textoBreve(respuesta)}`,
+        };
+    }
+    let cuerpo;
+    try {
+        cuerpo = await respuesta.json();
+    }
+    catch (error) {
+        return { ok: false, clase: "transporte", motivo: `respuesta ilegible: ${String(error)}` };
+    }
+    const id = cuerpo?.id;
+    if (typeof id !== "string" || id.length === 0) {
+        // 200 sin id es un fallo, no un éxito vacío. Devolverlo como ok dejaría
+        // un `file_id: undefined` viajando en el payload.
+        return { ok: false, clase: "rechazado", motivo: "el proveedor respondió 200 sin id de fichero" };
+    }
+    return { ok: true, id };
+}
+/**
+ * ¿Sigue existiendo el id? Se pregunta UNA vez por proceso y solo para ids que
+ * vienen de una sesión anterior. Preguntarlo en cada turno costaría una
+ * petición por adjunto y por turno, que es justo lo que este módulo evita.
+ *
+ * `desconocido` no es `muerto`: si la red falla, no sabemos si el id sirve, y
+ * tratarlo como muerto resubiría el fichero cada vez que hubiera un corte.
+ */
+export async function verificarFichero(capacidad, credencial, id, fetchImpl = globalThis.fetch, signal) {
+    let respuesta;
+    try {
+        respuesta = await fetchImpl(`${capacidad.urlFicheros}/${encodeURIComponent(id)}`, {
+            method: "GET",
+            headers: cabecerasDeAuth(capacidad, credencial),
+            signal,
+        });
+    }
+    catch {
+        return "desconocido";
+    }
+    if (respuesta.ok)
+        return "vivo";
+    if (respuesta.status === 404 || respuesta.status === 410)
+        return "muerto";
+    // 401/403 no dicen nada del fichero, dicen algo de la credencial.
+    return "desconocido";
+}
+// Aquí vivía `borrarFichero`. No lo llamaba nadie: `/blobs purgar` solo tira la
+// entrada de la caché local, y el proveedor caduca sus ficheros solo. Código
+// escrito, probado y desenchufado; se borra en vez de dejarlo esperando a un
+// llamador que no existe.
+//# sourceMappingURL=proveedor.js.map

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

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

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

@@ -0,0 +1,105 @@
+/**
+ * Espejo de imágenes salientes a URLs públicas — IMG-01.
+ *
+ * La Files API del proveedor es el camino bueno, pero no siempre está: hay
+ * modelos sin API de ficheros, credenciales OAuth que la rechazan, y proveedores
+ * que se cansan. Cuando la cadena `api → uploader → inline` se corta arriba, hoy
+ * el adjunto vuelve al cuerpo de la petición en base64 y se paga en CADA turno
+ * hasta el final de la sesión.
+ *
+ * Los uploaders públicos son el peldaño intermedio: servicios sin
+ * autenticación (tmpfiles.org, 0x0.st, file.io) que devuelven una URL estable.
+ * El modelo la descarga por su cuenta, igual que haría con una URL de la Files
+ * API. Tres reglas duras:
+ *
+ * 1. NUNCA viajan credenciales: los servicios son sin auth, así que no hay
+ *    nada que filtrar; si algún día uno pide auth, va en cabecera y no en la
+ *    URL — una URL con clave acaba en logs, historial y en el contexto del
+ *    propio modelo.
+ * 2. Todo uploader tiene límite de tamaño y timeout (reutiliza
+ *    `raceHandlerWithTimeout` del kit de higiene): un servicio caído cuesta
+ *    segundos, no el turno.
+ * 3. Cuarentena: un uploader que falla 3 veces seguidas se desactiva 10 minutos.
+ *    Es el mismo criterio del apagado del broker (`apagadoPor`) bajado a
+ *    escala de proveedor individual: no castegar a todos por uno malo.
+ *
+ * El journal (`blobs-journal.jsonl`, append-only) registra por qué camino viajó
+ * cada blob y cuántos bytes eran: es la evidencia del ahorro, y se lee a mano
+ * cuando algo va mal, como el resto del estado de blobs.
+ */
+import type { AlmacenDeBlobs } from "./almacen.ts";
+import { type CapacidadDeBlobs, type Credencial, type Fetch } from "./proveedor.ts";
+/** Timeout de cada subida pública. Un servicio lento no debe costar el turno. */
+export declare const TIMEOUT_SUBIDA_MS = 30000;
+/** Fallos seguidos que activan la cuarentena de un uploader. */
+export declare const FALLOS_PARA_CUARENTENA = 3;
+/** Tiempo que un uploader en cuarentena queda desactivado. */
+export declare const CUARENTENA_MS: number;
+export interface ResultadoDeUploader {
+    url: string;
+    /** Milisegundos epoch en los que la URL deja de servir, si se sabe. */
+    expira?: number;
+}
+/**
+ * Sin credenciales, a propósito: ver cabecera del fichero. `subir` recibe el
+ * fetch inyectado para poder probar sin red real.
+ */
+export interface Uploader {
+    nombre: string;
+    /** Límite de tamaño propio del servicio; false = ni intentarlo. */
+    puedeSubir(mime: string, tamano: number): boolean;
+    subir(bytes: Uint8Array, mime: string, fetchImpl?: Fetch, signal?: AbortSignal): Promise<ResultadoDeUploader>;
+}
+/** https://tmpfiles.org/api/v1/upload — multipart campo `file`; caduca a 60 min. */
+export declare const tmpfilesOrg: Uploader;
+/** https://0x0.st — POST form campo `file`; responde el texto de la URL. */
+export declare const ceroPorCero: Uploader;
+/** https://file.io — POST form campo `file`; enlace de UNA descarga. */
+export declare const fileIo: Uploader;
+/** Orden de preferencia: el más veterano y predecible primero. */
+export declare const UPLOADERS_PUBLICOS: readonly Uploader[];
+/**
+ * Mismo criterio que `apagadoPor` en la extensión, pero por uploader: fallos
+ * seguidos apagan SOLO al culpable, durante un tiempo, y un éxito rompe la
+ * racha. En memoria a propósito: la cuarentena caduca sola y no merece disco.
+ */
+export declare class Cuarentena {
+    private readonly fallosSeguidos;
+    private readonly hasta;
+    estaEnCuarentena(nombre: string, ahora?: number): boolean;
+    registrarExito(nombre: string): void;
+    registrarFallo(nombre: string, ahora?: number): void;
+}
+export type ViaDeSubida = "api" | "uploader" | "inline";
+export interface EntradaJournal {
+    hash: string;
+    via: ViaDeSubida;
+    bytes: number;
+    en: number;
+    /** Nombre del uploader público usado, cuando `via === "uploader"`. */
+    uploader?: string;
+}
+export declare function anotarJournal(agentDir: string, entrada: EntradaJournal): Promise<void>;
+export interface OpcionesDeCadena {
+    agentDir: string;
+    capacidad?: CapacidadDeBlobs;
+    credencial?: Credencial;
+    almacen?: AlmacenDeBlobs;
+    fetchImpl?: Fetch;
+    signal?: AbortSignal;
+    uploaders?: readonly Uploader[];
+    cuarentena?: Cuarentena;
+    timeoutMs?: number;
+    journal?: boolean;
+}
+export interface ResultadoDeCadena {
+    hash: string;
+    via: ViaDeSubida;
+    id?: string;
+    url?: string;
+    expira?: number;
+    uploader?: string;
+    motivo?: string;
+}
+export declare function subirConCadena(datos: Uint8Array, mime: string, opciones: OpcionesDeCadena): Promise<ResultadoDeCadena>;
+//# sourceMappingURL=uploaders.d.ts.map

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

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

package/dist/core/blobs/uploaders.js

@@ -0,0 +1,224 @@
+/**
+ * Espejo de imágenes salientes a URLs públicas — IMG-01.
+ *
+ * La Files API del proveedor es el camino bueno, pero no siempre está: hay
+ * modelos sin API de ficheros, credenciales OAuth que la rechazan, y proveedores
+ * que se cansan. Cuando la cadena `api → uploader → inline` se corta arriba, hoy
+ * el adjunto vuelve al cuerpo de la petición en base64 y se paga en CADA turno
+ * hasta el final de la sesión.
+ *
+ * Los uploaders públicos son el peldaño intermedio: servicios sin
+ * autenticación (tmpfiles.org, 0x0.st, file.io) que devuelven una URL estable.
+ * El modelo la descarga por su cuenta, igual que haría con una URL de la Files
+ * API. Tres reglas duras:
+ *
+ * 1. NUNCA viajan credenciales: los servicios son sin auth, así que no hay
+ *    nada que filtrar; si algún día uno pide auth, va en cabecera y no en la
+ *    URL — una URL con clave acaba en logs, historial y en el contexto del
+ *    propio modelo.
+ * 2. Todo uploader tiene límite de tamaño y timeout (reutiliza
+ *    `raceHandlerWithTimeout` del kit de higiene): un servicio caído cuesta
+ *    segundos, no el turno.
+ * 3. Cuarentena: un uploader que falla 3 veces seguidas se desactiva 10 minutos.
+ *    Es el mismo criterio del apagado del broker (`apagadoPor`) bajado a
+ *    escala de proveedor individual: no castegar a todos por uno malo.
+ *
+ * El journal (`blobs-journal.jsonl`, append-only) registra por qué camino viajó
+ * cada blob y cuántos bytes eran: es la evidencia del ahorro, y se lee a mano
+ * cuando algo va mal, como el resto del estado de blobs.
+ */
+import { appendFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { raceHandlerWithTimeout } from "../higiene/race-handler.js";
+import { extensionDe, hashDeContenido } from "./broker.js";
+import { puedeSubir, subirFichero } from "./proveedor.js";
+/** Timeout de cada subida pública. Un servicio lento no debe costar el turno. */
+export const TIMEOUT_SUBIDA_MS = 30_000;
+/** Fallos seguidos que activan la cuarentena de un uploader. */
+export const FALLOS_PARA_CUARENTENA = 3;
+/** Tiempo que un uploader en cuarentena queda desactivado. */
+export const CUARENTENA_MS = 10 * 60 * 1000;
+// ─── Uploaders públicos ──────────────────────────────────────────────────────
+function formaMultipart(bytes, mime, nombre) {
+    const forma = new FormData();
+    forma.append("file", new Blob([bytes], { type: mime }), nombre);
+    return forma;
+}
+async function subirConTimeout(hacerSubida, timeoutMs) {
+    let causa;
+    const handler = hacerSubida().catch((error) => {
+        causa = error instanceof Error ? error.message : String(error);
+        throw error;
+    });
+    // Centinela imposible de confundir con una subida real: si sale, o el
+    // handler reventó (y `causa` lo dice) o venció el timer.
+    const VENCIO = { url: "" };
+    const resultado = await raceHandlerWithTimeout(handler, timeoutMs, VENCIO);
+    if (resultado === VENCIO) {
+        throw new Error(causa ?? `sin respuesta tras ${timeoutMs} ms`);
+    }
+    return resultado;
+}
+const TMPFILES_MAX_BYTES = 100 * 1024 * 1024;
+/** https://tmpfiles.org/api/v1/upload — multipart campo `file`; caduca a 60 min. */
+export const tmpfilesOrg = {
+    nombre: "tmpfiles.org",
+    puedeSubir(_mime, tamano) {
+        return tamano > 0 && tamano <= TMPFILES_MAX_BYTES;
+    },
+    async subir(bytes, mime, fetchImpl = globalThis.fetch, signal) {
+        return subirConTimeout(async () => {
+            const respuesta = await fetchImpl("https://tmpfiles.org/api/v1/upload", {
+                method: "POST",
+                body: formaMultipart(bytes, mime, "blob"),
+                signal,
+            });
+            if (!respuesta.ok)
+                throw new Error(`tmpfiles.org respondió ${respuesta.status}`);
+            const cuerpo = (await respuesta.json());
+            const pagina = cuerpo.data?.url;
+            if (cuerpo.status !== "success" || !pagina)
+                throw new Error("tmpfiles.org no devolvió URL");
+            // La API devuelve la página de visualización; el enlace directo lleva `/dl/`.
+            const url = pagina.replace("tmpfiles.org/", "tmpfiles.org/dl/");
+            return { url, expira: Date.now() + 60 * 60 * 1000 };
+        }, TIMEOUT_SUBIDA_MS);
+    },
+};
+const CEROXCERO_MAX_BYTES = 512 * 1024 * 1024;
+/** https://0x0.st — POST form campo `file`; responde el texto de la URL. */
+export const ceroPorCero = {
+    nombre: "0x0.st",
+    puedeSubir(_mime, tamano) {
+        return tamano > 0 && tamano <= CEROXCERO_MAX_BYTES;
+    },
+    async subir(bytes, mime, fetchImpl = globalThis.fetch, signal) {
+        return subirConTimeout(async () => {
+            const respuesta = await fetchImpl("https://0x0.st", {
+                method: "POST",
+                body: formaMultipart(bytes, mime, "blob"),
+                signal,
+            });
+            if (!respuesta.ok)
+                throw new Error(`0x0.st respondió ${respuesta.status}`);
+            const url = (await respuesta.text()).trim();
+            if (!/^https?:\/\//.test(url))
+                throw new Error("0x0.st no devolvió una URL");
+            return { url };
+        }, TIMEOUT_SUBIDA_MS);
+    },
+};
+const FILEIO_MAX_BYTES = 256 * 1024 * 1024;
+/** https://file.io — POST form campo `file`; enlace de UNA descarga. */
+export const fileIo = {
+    nombre: "file.io",
+    puedeSubir(_mime, tamano) {
+        return tamano > 0 && tamano <= FILEIO_MAX_BYTES;
+    },
+    async subir(bytes, mime, fetchImpl = globalThis.fetch, signal) {
+        return subirConTimeout(async () => {
+            const respuesta = await fetchImpl("https://file.io", {
+                method: "POST",
+                body: formaMultipart(bytes, mime, "blob"),
+                signal,
+            });
+            if (!respuesta.ok)
+                throw new Error(`file.io respondió ${respuesta.status}`);
+            const cuerpo = (await respuesta.json());
+            if (!cuerpo.success || !cuerpo.link)
+                throw new Error("file.io no devolvió enlace");
+            return { url: cuerpo.link };
+        }, TIMEOUT_SUBIDA_MS);
+    },
+};
+/** Orden de preferencia: el más veterano y predecible primero. */
+export const UPLOADERS_PUBLICOS = [tmpfilesOrg, ceroPorCero, fileIo];
+// ─── Cuarentena ──────────────────────────────────────────────────────────────
+/**
+ * Mismo criterio que `apagadoPor` en la extensión, pero por uploader: fallos
+ * seguidos apagan SOLO al culpable, durante un tiempo, y un éxito rompe la
+ * racha. En memoria a propósito: la cuarentena caduca sola y no merece disco.
+ */
+export class Cuarentena {
+    fallosSeguidos = new Map();
+    hasta = new Map();
+    estaEnCuarentena(nombre, ahora = Date.now()) {
+        const limite = this.hasta.get(nombre);
+        if (limite === undefined)
+            return false;
+        if (ahora < limite)
+            return true;
+        this.hasta.delete(nombre);
+        this.fallosSeguidos.delete(nombre);
+        return false;
+    }
+    registrarExito(nombre) {
+        this.fallosSeguidos.delete(nombre);
+        this.hasta.delete(nombre);
+    }
+    registrarFallo(nombre, ahora = Date.now()) {
+        const fallos = (this.fallosSeguidos.get(nombre) ?? 0) + 1;
+        if (fallos >= FALLOS_PARA_CUARENTENA) {
+            this.hasta.set(nombre, ahora + CUARENTENA_MS);
+            this.fallosSeguidos.delete(nombre);
+            return;
+        }
+        this.fallosSeguidos.set(nombre, fallos);
+    }
+}
+export async function anotarJournal(agentDir, entrada) {
+    try {
+        await mkdir(agentDir, { recursive: true });
+        await appendFile(join(agentDir, "blobs-journal.jsonl"), `${JSON.stringify(entrada)}\n`, "utf-8");
+    }
+    catch {
+        // El journal es evidencia del ahorro, no parte del turno: si no se puede
+        // escribir, la subida ya pasó y nadie debe pagar un error por él.
+    }
+}
+export async function subirConCadena(datos, mime, opciones) {
+    const hash = hashDeContenido(datos);
+    const bytes = datos.length;
+    const journal = opciones.journal !== false;
+    const anotar = async (via, extra = {}) => {
+        if (journal)
+            await anotarJournal(opciones.agentDir, { hash, via, bytes, en: Date.now(), ...extra });
+    };
+    // Peldaño 1 — Files API del proveedor (el mismo transporte del broker).
+    const capacidad = opciones.capacidad;
+    const credencial = opciones.credencial;
+    if (capacidad && puedeSubir(capacidad) && credencial && (credencial.apiKey || credencial.cabeceras)) {
+        const subida = await subirFichero(capacidad, credencial, { datos, mime, nombre: `ada-${hash.slice(0, 16)}.${extensionDe(mime)}` }, opciones.fetchImpl, opciones.signal);
+        if (subida.ok) {
+            opciones.almacen?.guardar(capacidad.proveedor, hash, {
+                id: subida.id,
+                bytes,
+                mime,
+                subidoEn: Date.now(),
+                usadoEn: Date.now(),
+            });
+            await anotar("api");
+            return { hash, via: "api", id: subida.id };
+        }
+    }
+    // Peldaño 2 — uploaders públicos, saltando los que no caben o están en cuarentena.
+    const cuarentena = opciones.cuarentena ?? new Cuarentena();
+    const uploaders = opciones.uploaders ?? UPLOADERS_PUBLICOS;
+    for (const uploader of uploaders) {
+        if (!uploader.puedeSubir(mime, bytes) || cuarentena.estaEnCuarentena(uploader.nombre))
+            continue;
+        try {
+            const resultado = await subirConTimeout(() => uploader.subir(datos, mime, opciones.fetchImpl, opciones.signal), opciones.timeoutMs ?? TIMEOUT_SUBIDA_MS);
+            cuarentena.registrarExito(uploader.nombre);
+            await anotar("uploader", { uploader: uploader.nombre });
+            return { hash, via: "uploader", url: resultado.url, expira: resultado.expira, uploader: uploader.nombre };
+        }
+        catch {
+            cuarentena.registrarFallo(uploader.nombre);
+        }
+    }
+    // Último recurso — en línea, como siempre se hizo. Caro pero seguro.
+    await anotar("inline");
+    return { hash, via: "inline" };
+}
+//# sourceMappingURL=uploaders.js.map

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

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