@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/blobs/payload.js

@@ -0,0 +1,255 @@
+/**
+ * Encontrar adjuntos en línea dentro del payload del proveedor y sustituirlos
+ * por referencias a un fichero ya subido.
+ *
+ * Todo aquí es puro: entra un payload, sale otro. Ni red ni disco. Así el
+ * troceado se puede probar con el payload EXACTO que construye `packages/ai`
+ * sin montar una sesión.
+ *
+ * La distinción que sostiene la puerta 2 vive en el tipo de retorno de
+ * `localizarBlobs`:
+ *
+ *   null  → "no sé leer este payload" (API desconocida, o la forma no es la
+ *           esperada). No es lo mismo que no haber encontrado nada.
+ *   []    → "sé leerlo y no hay ningún adjunto que subir".
+ *
+ * Devolver `[]` en los dos casos convertiría un fallo de lectura en un informe
+ * tranquilizador de "no había nada", que es exactamente el defecto que este
+ * repositorio persigue.
+ */
+export function claveDeRuta(ruta) {
+    return `${ruta.mensaje}:${ruta.bloque}:${ruta.anidado ?? -1}`;
+}
+/** Bytes reales que representa una cadena base64, sin decodificarla. */
+export function bytesDeBase64(base64) {
+    const sinRelleno = base64.replace(/=+$/, "");
+    return Math.floor((sinRelleno.length * 3) / 4);
+}
+const DATA_URL = /^data:([^;,]+);base64,(.*)$/s;
+/** `data:image/png;base64,AAAA` → `{ mime, base64 }`. */
+export function partirDataUrl(url) {
+    if (typeof url !== "string")
+        return undefined;
+    const coincidencia = url.match(DATA_URL);
+    if (!coincidencia)
+        return undefined;
+    return { mime: coincidencia[1], base64: coincidencia[2] };
+}
+function comoObjeto(valor) {
+    return valor && typeof valor === "object" && !Array.isArray(valor) ? valor : undefined;
+}
+/** Los mensajes viven en `messages` (Anthropic) o en `input` (OpenAI responses). */
+function listaDeMensajes(payload, api) {
+    const bruto = api === "anthropic-messages" ? payload.messages : payload.input;
+    return Array.isArray(bruto) ? bruto : undefined;
+}
+/**
+ * Nombre del campo donde un resultado de herramienta guarda sus adjuntos, o
+ * `undefined` si este bloque no es un resultado de herramienta.
+ *
+ * Existe porque las imágenes grandes de verdad casi nunca las pega el usuario:
+ * las trae una herramienta (`read` de una captura, `computer`). Y esas NO
+ * cuelgan del mensaje, van anidadas un nivel más adentro: Anthropic las mete en
+ * `tool_result.content[]` (anthropic-messages.ts:1141) y OpenAI responses en
+ * `function_call_output.output[]` (openai-responses-shared.ts:308). Sin mirar
+ * ahí, `localizarBlobs` devolvía `[]` con una captura de 2 MB delante y
+ * `/blobs` informaba "no hay ningún adjunto en la conversación" — un "no lo he
+ * mirado" disfrazado de "no hay".
+ */
+function campoAnidado(bloque, api) {
+    if (api === "anthropic-messages") {
+        return bloque.type === "tool_result" && Array.isArray(bloque.content) ? "content" : undefined;
+    }
+    const esSalida = bloque.type === "function_call_output" || bloque.type === "custom_tool_call_output";
+    return esSalida && Array.isArray(bloque.output) ? "output" : undefined;
+}
+export function localizarBlobs(payload, api) {
+    if (api !== "anthropic-messages" && api !== "openai-responses")
+        return null;
+    const objeto = comoObjeto(payload);
+    if (!objeto)
+        return null;
+    const mensajes = listaDeMensajes(objeto, api);
+    if (!mensajes)
+        return null;
+    const encontrados = [];
+    const recoger = (lista, mensaje, bloque) => {
+        for (const [anidado, hijo] of lista.entries()) {
+            const encontrado = leerBloque(hijo, api);
+            if (encontrado)
+                encontrados.push({ ...encontrado, ruta: { mensaje, bloque, anidado } });
+        }
+    };
+    for (const [indiceMensaje, mensaje] of mensajes.entries()) {
+        const cuerpo = comoObjeto(mensaje);
+        if (!cuerpo)
+            continue;
+        // OpenAI responses: el resultado de herramienta es un item de primer nivel,
+        // no un bloque dentro de un mensaje. De ahí el `-1`.
+        const directo = campoAnidado(cuerpo, api);
+        if (directo) {
+            recoger(cuerpo[directo], indiceMensaje, -1);
+            continue;
+        }
+        // El contenido puede ser una cadena (Anthropic lo hace cuando solo hay
+        // texto): no es un fallo de lectura, es un mensaje sin adjuntos.
+        if (!Array.isArray(cuerpo.content))
+            continue;
+        for (const [indiceBloque, bloque] of cuerpo.content.entries()) {
+            const objetoBloque = comoObjeto(bloque);
+            const campo = objetoBloque && campoAnidado(objetoBloque, api);
+            if (objetoBloque && campo) {
+                recoger(objetoBloque[campo], indiceMensaje, indiceBloque);
+                continue;
+            }
+            const encontrado = leerBloque(bloque, api);
+            if (encontrado)
+                encontrados.push({ ...encontrado, ruta: { mensaje: indiceMensaje, bloque: indiceBloque } });
+        }
+    }
+    return encontrados;
+}
+function leerBloque(bloque, api) {
+    const objeto = comoObjeto(bloque);
+    if (!objeto)
+        return undefined;
+    if (api === "anthropic-messages") {
+        if (objeto.type !== "image" && objeto.type !== "document")
+            return undefined;
+        const fuente = comoObjeto(objeto.source);
+        if (!fuente || fuente.type !== "base64")
+            return undefined;
+        const base64 = fuente.data;
+        const mime = fuente.media_type;
+        if (typeof base64 !== "string" || typeof mime !== "string")
+            return undefined;
+        return { clase: objeto.type === "image" ? "imagen" : "documento", mime, base64, bytes: bytesDeBase64(base64) };
+    }
+    if (objeto.type === "input_image") {
+        const partes = partirDataUrl(objeto.image_url);
+        if (!partes)
+            return undefined;
+        return { clase: "imagen", mime: partes.mime, base64: partes.base64, bytes: bytesDeBase64(partes.base64) };
+    }
+    if (objeto.type === "input_file") {
+        const partes = partirDataUrl(objeto.file_data);
+        if (!partes)
+            return undefined;
+        return { clase: "documento", mime: partes.mime, base64: partes.base64, bytes: bytesDeBase64(partes.base64) };
+    }
+    return undefined;
+}
+/**
+ * Devuelve un payload nuevo con los bloques indicados sustituidos por su
+ * referencia. Copia solo la rama que cambia: el resto se comparte, para no
+ * duplicar en memoria un contexto que puede pesar megas.
+ */
+export function reescribirBlobs(payload, api, ids) {
+    if (ids.size === 0)
+        return payload;
+    if (api !== "anthropic-messages" && api !== "openai-responses")
+        return payload;
+    const objeto = comoObjeto(payload);
+    if (!objeto)
+        return payload;
+    const mensajes = listaDeMensajes(objeto, api);
+    if (!mensajes)
+        return payload;
+    /** Devuelve la lista anidada reescrita, o `undefined` si no cambió nada. */
+    const reescribirAnidados = (lista, mensaje, bloque) => {
+        let cambiadoAqui = false;
+        const nueva = lista.map((hijo, anidado) => {
+            const id = ids.get(claveDeRuta({ mensaje, bloque, anidado }));
+            if (!id)
+                return hijo;
+            const referencia = referenciaDeFichero(hijo, api, id);
+            if (!referencia)
+                return hijo;
+            cambiadoAqui = true;
+            return referencia;
+        });
+        return cambiadoAqui ? nueva : undefined;
+    };
+    let cambiado = false;
+    const nuevosMensajes = mensajes.map((mensaje, indiceMensaje) => {
+        const cuerpo = comoObjeto(mensaje);
+        if (!cuerpo)
+            return mensaje;
+        const directo = campoAnidado(cuerpo, api);
+        if (directo) {
+            const nuevos = reescribirAnidados(cuerpo[directo], indiceMensaje, -1);
+            if (!nuevos)
+                return mensaje;
+            cambiado = true;
+            return { ...cuerpo, [directo]: nuevos };
+        }
+        if (!Array.isArray(cuerpo.content))
+            return mensaje;
+        let cambiadoAqui = false;
+        const nuevoContenido = cuerpo.content.map((bloque, indiceBloque) => {
+            const objetoBloque = comoObjeto(bloque);
+            const campo = objetoBloque && campoAnidado(objetoBloque, api);
+            if (objetoBloque && campo) {
+                const nuevos = reescribirAnidados(objetoBloque[campo], indiceMensaje, indiceBloque);
+                if (!nuevos)
+                    return bloque;
+                cambiadoAqui = true;
+                return { ...objetoBloque, [campo]: nuevos };
+            }
+            const id = ids.get(claveDeRuta({ mensaje: indiceMensaje, bloque: indiceBloque }));
+            if (!id)
+                return bloque;
+            const referencia = referenciaDeFichero(bloque, api, id);
+            if (!referencia)
+                return bloque;
+            cambiadoAqui = true;
+            return referencia;
+        });
+        if (!cambiadoAqui)
+            return mensaje;
+        cambiado = true;
+        return { ...cuerpo, content: nuevoContenido };
+    });
+    if (!cambiado)
+        return payload;
+    return api === "anthropic-messages" ? { ...objeto, messages: nuevosMensajes } : { ...objeto, input: nuevosMensajes };
+}
+/**
+ * Se conserva TODO lo demás del bloque y solo se cambia de dónde salen los
+ * bytes.
+ *
+ * Antes se construía un bloque nuevo con `type` y la referencia, y eso tiraba
+ * en silencio las propiedades hermanas. La cara: `packages/ai` pone el
+ * breakpoint de caché de conversación en el ÚLTIMO bloque del último mensaje de
+ * usuario, y ese bloque es la imagen cuando la imagen va la última
+ * (anthropic-messages.ts:1296-1306). Comprobado ejecutándolo con el payload que
+ * construye `buildParams`: entraba `cache_control: {"type":"ephemeral"}` y salía
+ * sin él. Un módulo que existe para ahorrar rompía la caché de prompt y lo
+ * informaba como "1 subido". También se perdían `title`, `context` y
+ * `citations` de los bloques `document`.
+ */
+function referenciaDeFichero(bloque, api, id) {
+    const objeto = comoObjeto(bloque);
+    if (!objeto)
+        return undefined;
+    if (api === "anthropic-messages") {
+        if (objeto.type !== "image" && objeto.type !== "document")
+            return undefined;
+        // Se copia el bloque entero y solo se cambia `source`. Esta es LA rama
+        // donde vive el `cache_control`: el breakpoint solo se pone en bloques
+        // `text`, `image` y `tool_result`, todos de Anthropic.
+        return { ...objeto, source: { type: "file", file_id: id } };
+    }
+    if (objeto.type === "input_image") {
+        // `detail` sobrevive con el resto: es la palanca de coste de visión de
+        // OpenAI y perderla cambiaría en silencio lo que paga el usuario.
+        const { image_url: _fuera, ...resto } = objeto;
+        return { ...resto, file_id: id };
+    }
+    if (objeto.type === "input_file") {
+        const { file_data: _fuera, ...resto } = objeto;
+        return { ...resto, file_id: id };
+    }
+    return undefined;
+}
+//# sourceMappingURL=payload.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../src/core/blobs/payload.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Encontrar adjuntos en línea dentro del payload del proveedor y sustituirlos\n * por referencias a un fichero ya subido.\n *\n * Todo aquí es puro: entra un payload, sale otro. Ni red ni disco. Así el\n * troceado se puede probar con el payload EXACTO que construye `packages/ai`\n * sin montar una sesión.\n *\n * La distinción que sostiene la puerta 2 vive en el tipo de retorno de\n * `localizarBlobs`:\n *\n *   null  → \"no sé leer este payload\" (API desconocida, o la forma no es la\n *           esperada). No es lo mismo que no haber encontrado nada.\n *   []    → \"sé leerlo y no hay ningún adjunto que subir\".\n *\n * Devolver `[]` en los dos casos convertiría un fallo de lectura en un informe\n * tranquilizador de \"no había nada\", que es exactamente el defecto que este\n * repositorio persigue.\n */\n\nexport type ApiDeBlobs = \"anthropic-messages\" | \"openai-responses\";\n\nexport interface BloqueBlob {\n\t/**\n\t * Dónde está: índice de mensaje, índice de bloque dentro de su contenido y,\n\t * si el bloque cuelga del resultado de una herramienta, el índice dentro de\n\t * ese resultado. `bloque: -1` = el contenedor ES el item de primer nivel\n\t * (así viaja `function_call_output` en OpenAI responses).\n\t */\n\truta: { mensaje: number; bloque: number; anidado?: number };\n\tclase: \"imagen\" | \"documento\";\n\tmime: string;\n\t/** Contenido en base64, sin el prefijo `data:`. */\n\tbase64: string;\n\t/** Tamaño del contenido decodificado. */\n\tbytes: number;\n}\n\nexport function claveDeRuta(ruta: BloqueBlob[\"ruta\"]): string {\n\treturn `${ruta.mensaje}:${ruta.bloque}:${ruta.anidado ?? -1}`;\n}\n\n/** Bytes reales que representa una cadena base64, sin decodificarla. */\nexport function bytesDeBase64(base64: string): number {\n\tconst sinRelleno = base64.replace(/=+$/, \"\");\n\treturn Math.floor((sinRelleno.length * 3) / 4);\n}\n\nconst DATA_URL = /^data:([^;,]+);base64,(.*)$/s;\n\n/** `data:image/png;base64,AAAA` → `{ mime, base64 }`. */\nexport function partirDataUrl(url: unknown): { mime: string; base64: string } | undefined {\n\tif (typeof url !== \"string\") return undefined;\n\tconst coincidencia = url.match(DATA_URL);\n\tif (!coincidencia) return undefined;\n\treturn { mime: coincidencia[1], base64: coincidencia[2] };\n}\n\nfunction comoObjeto(valor: unknown): Record<string, unknown> | undefined {\n\treturn valor && typeof valor === \"object\" && !Array.isArray(valor) ? (valor as Record<string, unknown>) : undefined;\n}\n\n/** Los mensajes viven en `messages` (Anthropic) o en `input` (OpenAI responses). */\nfunction listaDeMensajes(payload: Record<string, unknown>, api: ApiDeBlobs): unknown[] | undefined {\n\tconst bruto = api === \"anthropic-messages\" ? payload.messages : payload.input;\n\treturn Array.isArray(bruto) ? bruto : undefined;\n}\n\n/**\n * Nombre del campo donde un resultado de herramienta guarda sus adjuntos, o\n * `undefined` si este bloque no es un resultado de herramienta.\n *\n * Existe porque las imágenes grandes de verdad casi nunca las pega el usuario:\n * las trae una herramienta (`read` de una captura, `computer`). Y esas NO\n * cuelgan del mensaje, van anidadas un nivel más adentro: Anthropic las mete en\n * `tool_result.content[]` (anthropic-messages.ts:1141) y OpenAI responses en\n * `function_call_output.output[]` (openai-responses-shared.ts:308). Sin mirar\n * ahí, `localizarBlobs` devolvía `[]` con una captura de 2 MB delante y\n * `/blobs` informaba \"no hay ningún adjunto en la conversación\" — un \"no lo he\n * mirado\" disfrazado de \"no hay\".\n */\nfunction campoAnidado(bloque: Record<string, unknown>, api: ApiDeBlobs): \"content\" | \"output\" | undefined {\n\tif (api === \"anthropic-messages\") {\n\t\treturn bloque.type === \"tool_result\" && Array.isArray(bloque.content) ? \"content\" : undefined;\n\t}\n\tconst esSalida = bloque.type === \"function_call_output\" || bloque.type === \"custom_tool_call_output\";\n\treturn esSalida && Array.isArray(bloque.output) ? \"output\" : undefined;\n}\n\nexport function localizarBlobs(payload: unknown, api: string): BloqueBlob[] | null {\n\tif (api !== \"anthropic-messages\" && api !== \"openai-responses\") return null;\n\tconst objeto = comoObjeto(payload);\n\tif (!objeto) return null;\n\tconst mensajes = listaDeMensajes(objeto, api);\n\tif (!mensajes) return null;\n\n\tconst encontrados: BloqueBlob[] = [];\n\tconst recoger = (lista: unknown[], mensaje: number, bloque: number) => {\n\t\tfor (const [anidado, hijo] of lista.entries()) {\n\t\t\tconst encontrado = leerBloque(hijo, api);\n\t\t\tif (encontrado) encontrados.push({ ...encontrado, ruta: { mensaje, bloque, anidado } });\n\t\t}\n\t};\n\n\tfor (const [indiceMensaje, mensaje] of mensajes.entries()) {\n\t\tconst cuerpo = comoObjeto(mensaje);\n\t\tif (!cuerpo) continue;\n\t\t// OpenAI responses: el resultado de herramienta es un item de primer nivel,\n\t\t// no un bloque dentro de un mensaje. De ahí el `-1`.\n\t\tconst directo = campoAnidado(cuerpo, api);\n\t\tif (directo) {\n\t\t\trecoger(cuerpo[directo] as unknown[], indiceMensaje, -1);\n\t\t\tcontinue;\n\t\t}\n\t\t// El contenido puede ser una cadena (Anthropic lo hace cuando solo hay\n\t\t// texto): no es un fallo de lectura, es un mensaje sin adjuntos.\n\t\tif (!Array.isArray(cuerpo.content)) continue;\n\t\tfor (const [indiceBloque, bloque] of (cuerpo.content as unknown[]).entries()) {\n\t\t\tconst objetoBloque = comoObjeto(bloque);\n\t\t\tconst campo = objetoBloque && campoAnidado(objetoBloque, api);\n\t\t\tif (objetoBloque && campo) {\n\t\t\t\trecoger(objetoBloque[campo] as unknown[], indiceMensaje, indiceBloque);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst encontrado = leerBloque(bloque, api);\n\t\t\tif (encontrado) encontrados.push({ ...encontrado, ruta: { mensaje: indiceMensaje, bloque: indiceBloque } });\n\t\t}\n\t}\n\treturn encontrados;\n}\n\nfunction leerBloque(bloque: unknown, api: ApiDeBlobs): Omit<BloqueBlob, \"ruta\"> | undefined {\n\tconst objeto = comoObjeto(bloque);\n\tif (!objeto) return undefined;\n\n\tif (api === \"anthropic-messages\") {\n\t\tif (objeto.type !== \"image\" && objeto.type !== \"document\") return undefined;\n\t\tconst fuente = comoObjeto(objeto.source);\n\t\tif (!fuente || fuente.type !== \"base64\") return undefined;\n\t\tconst base64 = fuente.data;\n\t\tconst mime = fuente.media_type;\n\t\tif (typeof base64 !== \"string\" || typeof mime !== \"string\") return undefined;\n\t\treturn { clase: objeto.type === \"image\" ? \"imagen\" : \"documento\", mime, base64, bytes: bytesDeBase64(base64) };\n\t}\n\n\tif (objeto.type === \"input_image\") {\n\t\tconst partes = partirDataUrl(objeto.image_url);\n\t\tif (!partes) return undefined;\n\t\treturn { clase: \"imagen\", mime: partes.mime, base64: partes.base64, bytes: bytesDeBase64(partes.base64) };\n\t}\n\tif (objeto.type === \"input_file\") {\n\t\tconst partes = partirDataUrl(objeto.file_data);\n\t\tif (!partes) return undefined;\n\t\treturn { clase: \"documento\", mime: partes.mime, base64: partes.base64, bytes: bytesDeBase64(partes.base64) };\n\t}\n\treturn undefined;\n}\n\n/**\n * Devuelve un payload nuevo con los bloques indicados sustituidos por su\n * referencia. Copia solo la rama que cambia: el resto se comparte, para no\n * duplicar en memoria un contexto que puede pesar megas.\n */\nexport function reescribirBlobs(payload: unknown, api: string, ids: Map<string, string>): unknown {\n\tif (ids.size === 0) return payload;\n\tif (api !== \"anthropic-messages\" && api !== \"openai-responses\") return payload;\n\tconst objeto = comoObjeto(payload);\n\tif (!objeto) return payload;\n\tconst mensajes = listaDeMensajes(objeto, api);\n\tif (!mensajes) return payload;\n\n\t/** Devuelve la lista anidada reescrita, o `undefined` si no cambió nada. */\n\tconst reescribirAnidados = (lista: unknown[], mensaje: number, bloque: number): unknown[] | undefined => {\n\t\tlet cambiadoAqui = false;\n\t\tconst nueva = lista.map((hijo, anidado) => {\n\t\t\tconst id = ids.get(claveDeRuta({ mensaje, bloque, anidado }));\n\t\t\tif (!id) return hijo;\n\t\t\tconst referencia = referenciaDeFichero(hijo, api, id);\n\t\t\tif (!referencia) return hijo;\n\t\t\tcambiadoAqui = true;\n\t\t\treturn referencia;\n\t\t});\n\t\treturn cambiadoAqui ? nueva : undefined;\n\t};\n\n\tlet cambiado = false;\n\tconst nuevosMensajes = mensajes.map((mensaje, indiceMensaje) => {\n\t\tconst cuerpo = comoObjeto(mensaje);\n\t\tif (!cuerpo) return mensaje;\n\t\tconst directo = campoAnidado(cuerpo, api);\n\t\tif (directo) {\n\t\t\tconst nuevos = reescribirAnidados(cuerpo[directo] as unknown[], indiceMensaje, -1);\n\t\t\tif (!nuevos) return mensaje;\n\t\t\tcambiado = true;\n\t\t\treturn { ...cuerpo, [directo]: nuevos };\n\t\t}\n\t\tif (!Array.isArray(cuerpo.content)) return mensaje;\n\t\tlet cambiadoAqui = false;\n\t\tconst nuevoContenido = (cuerpo.content as unknown[]).map((bloque, indiceBloque) => {\n\t\t\tconst objetoBloque = comoObjeto(bloque);\n\t\t\tconst campo = objetoBloque && campoAnidado(objetoBloque, api);\n\t\t\tif (objetoBloque && campo) {\n\t\t\t\tconst nuevos = reescribirAnidados(objetoBloque[campo] as unknown[], indiceMensaje, indiceBloque);\n\t\t\t\tif (!nuevos) return bloque;\n\t\t\t\tcambiadoAqui = true;\n\t\t\t\treturn { ...objetoBloque, [campo]: nuevos };\n\t\t\t}\n\t\t\tconst id = ids.get(claveDeRuta({ mensaje: indiceMensaje, bloque: indiceBloque }));\n\t\t\tif (!id) return bloque;\n\t\t\tconst referencia = referenciaDeFichero(bloque, api, id);\n\t\t\tif (!referencia) return bloque;\n\t\t\tcambiadoAqui = true;\n\t\t\treturn referencia;\n\t\t});\n\t\tif (!cambiadoAqui) return mensaje;\n\t\tcambiado = true;\n\t\treturn { ...cuerpo, content: nuevoContenido };\n\t});\n\n\tif (!cambiado) return payload;\n\treturn api === \"anthropic-messages\" ? { ...objeto, messages: nuevosMensajes } : { ...objeto, input: nuevosMensajes };\n}\n\n/**\n * Se conserva TODO lo demás del bloque y solo se cambia de dónde salen los\n * bytes.\n *\n * Antes se construía un bloque nuevo con `type` y la referencia, y eso tiraba\n * en silencio las propiedades hermanas. La cara: `packages/ai` pone el\n * breakpoint de caché de conversación en el ÚLTIMO bloque del último mensaje de\n * usuario, y ese bloque es la imagen cuando la imagen va la última\n * (anthropic-messages.ts:1296-1306). Comprobado ejecutándolo con el payload que\n * construye `buildParams`: entraba `cache_control: {\"type\":\"ephemeral\"}` y salía\n * sin él. Un módulo que existe para ahorrar rompía la caché de prompt y lo\n * informaba como \"1 subido\". También se perdían `title`, `context` y\n * `citations` de los bloques `document`.\n */\nfunction referenciaDeFichero(bloque: unknown, api: ApiDeBlobs, id: string): Record<string, unknown> | undefined {\n\tconst objeto = comoObjeto(bloque);\n\tif (!objeto) return undefined;\n\tif (api === \"anthropic-messages\") {\n\t\tif (objeto.type !== \"image\" && objeto.type !== \"document\") return undefined;\n\t\t// Se copia el bloque entero y solo se cambia `source`. Esta es LA rama\n\t\t// donde vive el `cache_control`: el breakpoint solo se pone en bloques\n\t\t// `text`, `image` y `tool_result`, todos de Anthropic.\n\t\treturn { ...objeto, source: { type: \"file\", file_id: id } };\n\t}\n\tif (objeto.type === \"input_image\") {\n\t\t// `detail` sobrevive con el resto: es la palanca de coste de visión de\n\t\t// OpenAI y perderla cambiaría en silencio lo que paga el usuario.\n\t\tconst { image_url: _fuera, ...resto } = objeto;\n\t\treturn { ...resto, file_id: id };\n\t}\n\tif (objeto.type === \"input_file\") {\n\t\tconst { file_data: _fuera, ...resto } = objeto;\n\t\treturn { ...resto, file_id: id };\n\t}\n\treturn undefined;\n}\n"]}

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,iFAAgF;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,yEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChC,iDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC5B,gDAA8C;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,gFAA+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","sourcesContent":["/**\n * Qué proveedores tienen API de ficheros, y cómo se habla con ella.\n *\n * La pieza importante de este fichero no es la subida: es `capacidadDeBlobs`,\n * que NUNCA devuelve un \"no\" mudo. Un proveedor sin API de ficheros y un\n * proveedor con la API pero sin credencial son dos cosas distintas, y las dos\n * son distintas de \"no hay ningún adjunto en esta petición\". Confundirlas es el\n * defecto que más veces nos ha mordido: un \"no puedo\" leído como \"no hay\".\n *\n * Por qué se exige la URL oficial: un modelo `anthropic-messages` servido por\n * un gateway (OpenRouter, un proxy propio, Bedrock) habla el mismo dialecto de\n * mensajes pero NO expone `/v1/files`. Subir ahí devuelve 404 y, peor, un id\n * inventado por el proxy que luego el modelo no reconoce. Si no es la URL\n * oficial, decimos por qué no y mandamos el contenido en línea como siempre.\n */\n\n/** Lo mínimo que necesitamos del modelo. Evita atarnos al tipo `Model<Api>`. */\nexport interface ModeloParaBlobs {\n\tprovider?: string;\n\tapi?: string;\n\tbaseUrl?: string;\n}\n\nexport interface CapacidadDeBlobs {\n\t/** Clave de caché: los ids no son intercambiables entre proveedores. */\n\tproveedor: string;\n\t/** Familia de API de ficheros; decide multipart, cabeceras y forma del ref. */\n\tfamilia: \"anthropic\" | \"openai\";\n\t/** URL absoluta de la colección de ficheros. */\n\turlFicheros: string;\n\t/** Cabeceras extra obligatorias (el beta de la Files API de Anthropic). */\n\tcabeceras: Record<string, string>;\n}\n\nexport interface SinCapacidad {\n\t/** Por qué NO se puede subir. Nunca vacío. */\n\tmotivo: string;\n}\n\nexport type ResultadoDeCapacidad = CapacidadDeBlobs | SinCapacidad;\n\nexport function puedeSubir(resultado: ResultadoDeCapacidad): resultado is CapacidadDeBlobs {\n\treturn \"urlFicheros\" in resultado;\n}\n\n/** Beta obligatorio de la Files API de Anthropic. Sin él, /v1/files da 404. */\nexport const BETA_FICHEROS_ANTHROPIC = \"files-api-2025-04-14\";\n\nfunction anfitrion(url: string | undefined): string | undefined {\n\tif (!url) return undefined;\n\ttry {\n\t\treturn new URL(url).host.toLowerCase();\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction sinBarraFinal(url: string): string {\n\treturn url.replace(/\\/+$/, \"\");\n}\n\nexport function capacidadDeBlobs(modelo: ModeloParaBlobs | undefined): ResultadoDeCapacidad {\n\tif (!modelo) return { motivo: \"todavía no hay modelo seleccionado en la sesión\" };\n\tconst proveedor = modelo.provider ?? \"?\";\n\tconst api = modelo.api ?? \"?\";\n\tconst host = anfitrion(modelo.baseUrl);\n\n\tif (api === \"anthropic-messages\") {\n\t\tif (proveedor !== \"anthropic\") {\n\t\t\treturn {\n\t\t\t\tmotivo: `\"${proveedor}\" habla el dialecto de mensajes de Anthropic pero no es Anthropic: no expone /v1/files`,\n\t\t\t};\n\t\t}\n\t\tif (host !== \"api.anthropic.com\") {\n\t\t\treturn {\n\t\t\t\tmotivo: `el modelo apunta a ${host ?? \"una URL ilegible\"} y no a api.anthropic.com: un gateway no expone /v1/files`,\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tproveedor: \"anthropic\",\n\t\t\tfamilia: \"anthropic\",\n\t\t\turlFicheros: `${sinBarraFinal(modelo.baseUrl ?? \"\")}/v1/files`,\n\t\t\tcabeceras: { \"anthropic-beta\": BETA_FICHEROS_ANTHROPIC, \"anthropic-version\": \"2023-06-01\" },\n\t\t};\n\t}\n\n\tif (api === \"openai-responses\") {\n\t\tif (proveedor !== \"openai\") {\n\t\t\treturn { motivo: `\"${proveedor}\" usa la API de respuestas de OpenAI pero no expone /v1/files propio` };\n\t\t}\n\t\tif (host !== \"api.openai.com\") {\n\t\t\treturn {\n\t\t\t\tmotivo: `el modelo apunta a ${host ?? \"una URL ilegible\"} y no a api.openai.com: un gateway no expone /v1/files`,\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tproveedor: \"openai\",\n\t\t\tfamilia: \"openai\",\n\t\t\turlFicheros: `${sinBarraFinal(modelo.baseUrl ?? \"\")}/files`,\n\t\t\tcabeceras: {},\n\t\t};\n\t}\n\n\t// `openai-completions` acepta `file_id` solo en bloques `file` (PDF), no en\n\t// `image_url`; como lo que hoy adjunta Ada son imágenes, aquí no hay nada\n\t// que ganar y sí un 400 que ganar. Se dice, no se intenta.\n\tif (api === \"openai-completions\") {\n\t\treturn {\n\t\t\tmotivo: `la API \"openai-completions\" no acepta file_id en bloques de imagen; solo URL o base64 en línea`,\n\t\t};\n\t}\n\n\treturn { motivo: `la API \"${api}\" del proveedor \"${proveedor}\" no tiene API de ficheros conocida` };\n}\n\n// ─── Transporte ─────────────────────────────────────────────────────────────\n\nexport interface Credencial {\n\tapiKey?: string;\n\tcabeceras?: Record<string, string>;\n}\n\nexport type Fetch = typeof globalThis.fetch;\n\nexport interface RespuestaDeSubida {\n\tok: true;\n\tid: string;\n}\n\nexport interface FalloDeSubida {\n\tok: false;\n\t/**\n\t * `rechazado` = el proveedor contestó y dijo que no (4xx). `transporte` = no\n\t * se pudo ni preguntar. La diferencia importa: un rechazo se aprende, un\n\t * fallo de transporte se reintenta en el turno siguiente.\n\t */\n\tclase: \"rechazado\" | \"transporte\";\n\tmotivo: string;\n\testado?: number;\n}\n\nexport type ResultadoDeSubida = RespuestaDeSubida | FalloDeSubida;\n\n/**\n * Un token de OAuth de Anthropic (Claude Pro/Max: empieza por `sk-ant-oat`) NO\n * vale como `x-api-key`. `packages/ai` lo sabe y construye el cliente con\n * `authToken`, que es `Authorization: Bearer`\n * (anthropic-messages.ts:873 y :923). El mismo criterio, `includes`, y no un\n * `startsWith`: el token viaja a veces con prefijo de entorno.\n */\nexport function esTokenOAuthAnthropic(apiKey: string): boolean {\n\treturn apiKey.includes(\"sk-ant-oat\");\n}\n\nfunction cabecerasDeAuth(capacidad: CapacidadDeBlobs, credencial: Credencial): Record<string, string> {\n\t// Las de `capacidad` van LAS ÚLTIMAS y ganan: son obligatorias (el beta de la\n\t// Files API). Si una cabecera de proveedor traía su propio `anthropic-beta`,\n\t// el orden de antes borraba el beta de ficheros y /v1/files contestaba 404 —\n\t// un \"no puedo\" que se leía como \"el proveedor no quiere el fichero\".\n\tconst cabeceras: Record<string, string> = { ...(credencial.cabeceras ?? {}), ...capacidad.cabeceras };\n\tif (credencial.apiKey) {\n\t\t// Con OAuth, mandar la clave en `x-api-key` da 401 en TODAS las subidas: el\n\t\t// módulo entero quedaba muerto para quien entra con Claude Pro/Max, que es\n\t\t// la mayoría, y el motivo que salía en `/blobs` era \"401 al subir\", que\n\t\t// echa la culpa al proveedor en vez de a la cabecera.\n\t\tif (capacidad.familia === \"anthropic\" && !esTokenOAuthAnthropic(credencial.apiKey)) {\n\t\t\tcabeceras[\"x-api-key\"] = credencial.apiKey;\n\t\t} else {\n\t\t\tcabeceras.authorization = `Bearer ${credencial.apiKey}`;\n\t\t}\n\t}\n\treturn cabeceras;\n}\n\nasync function textoBreve(respuesta: Response): Promise<string> {\n\ttry {\n\t\treturn (await respuesta.text()).slice(0, 300);\n\t} catch {\n\t\treturn \"\";\n\t}\n}\n\nexport async function subirFichero(\n\tcapacidad: CapacidadDeBlobs,\n\tcredencial: Credencial,\n\tfichero: { datos: Uint8Array; mime: string; nombre: string },\n\tfetchImpl: Fetch = globalThis.fetch,\n\tsignal?: AbortSignal,\n): Promise<ResultadoDeSubida> {\n\tconst formulario = new FormData();\n\t// `new Blob([...])` y no `File`: el segundo no existe en todos los runtimes\n\t// donde se ejecutan los tests, y el nombre viaja igual en el `append`.\n\tformulario.append(\"file\", new Blob([fichero.datos], { type: fichero.mime }), fichero.nombre);\n\t// OpenAI exige `purpose`; Anthropic rechaza campos extra, así que va solo donde toca.\n\tif (capacidad.familia === \"openai\") formulario.append(\"purpose\", \"vision\");\n\n\tlet respuesta: Response;\n\ttry {\n\t\trespuesta = await fetchImpl(capacidad.urlFicheros, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: cabecerasDeAuth(capacidad, credencial),\n\t\t\tbody: formulario,\n\t\t\tsignal,\n\t\t});\n\t} catch (error) {\n\t\treturn { ok: false, clase: \"transporte\", motivo: error instanceof Error ? error.message : String(error) };\n\t}\n\n\tif (!respuesta.ok) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tclase: respuesta.status >= 400 && respuesta.status < 500 ? \"rechazado\" : \"transporte\",\n\t\t\testado: respuesta.status,\n\t\t\tmotivo: `${respuesta.status} al subir: ${await textoBreve(respuesta)}`,\n\t\t};\n\t}\n\n\tlet cuerpo: unknown;\n\ttry {\n\t\tcuerpo = await respuesta.json();\n\t} catch (error) {\n\t\treturn { ok: false, clase: \"transporte\", motivo: `respuesta ilegible: ${String(error)}` };\n\t}\n\tconst id = (cuerpo as { id?: unknown })?.id;\n\tif (typeof id !== \"string\" || id.length === 0) {\n\t\t// 200 sin id es un fallo, no un éxito vacío. Devolverlo como ok dejaría\n\t\t// un `file_id: undefined` viajando en el payload.\n\t\treturn { ok: false, clase: \"rechazado\", motivo: \"el proveedor respondió 200 sin id de fichero\" };\n\t}\n\treturn { ok: true, id };\n}\n\nexport type EstadoDeFichero = \"vivo\" | \"muerto\" | \"desconocido\";\n\n/**\n * ¿Sigue existiendo el id? Se pregunta UNA vez por proceso y solo para ids que\n * vienen de una sesión anterior. Preguntarlo en cada turno costaría una\n * petición por adjunto y por turno, que es justo lo que este módulo evita.\n *\n * `desconocido` no es `muerto`: si la red falla, no sabemos si el id sirve, y\n * tratarlo como muerto resubiría el fichero cada vez que hubiera un corte.\n */\nexport async function verificarFichero(\n\tcapacidad: CapacidadDeBlobs,\n\tcredencial: Credencial,\n\tid: string,\n\tfetchImpl: Fetch = globalThis.fetch,\n\tsignal?: AbortSignal,\n): Promise<EstadoDeFichero> {\n\tlet respuesta: Response;\n\ttry {\n\t\trespuesta = await fetchImpl(`${capacidad.urlFicheros}/${encodeURIComponent(id)}`, {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: cabecerasDeAuth(capacidad, credencial),\n\t\t\tsignal,\n\t\t});\n\t} catch {\n\t\treturn \"desconocido\";\n\t}\n\tif (respuesta.ok) return \"vivo\";\n\tif (respuesta.status === 404 || respuesta.status === 410) return \"muerto\";\n\t// 401/403 no dicen nada del fichero, dicen algo de la credencial.\n\treturn \"desconocido\";\n}\n\n// Aquí vivía `borrarFichero`. No lo llamaba nadie: `/blobs purgar` solo tira la\n// entrada de la caché local, y el proveedor caduca sus ficheros solo. Código\n// escrito, probado y desenchufado; se borra en vez de dejarlo esperando a un\n// llamador que no existe.\n"]}

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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","sourcesContent":["/**\n * Qué proveedores tienen API de ficheros, y cómo se habla con ella.\n *\n * La pieza importante de este fichero no es la subida: es `capacidadDeBlobs`,\n * que NUNCA devuelve un \"no\" mudo. Un proveedor sin API de ficheros y un\n * proveedor con la API pero sin credencial son dos cosas distintas, y las dos\n * son distintas de \"no hay ningún adjunto en esta petición\". Confundirlas es el\n * defecto que más veces nos ha mordido: un \"no puedo\" leído como \"no hay\".\n *\n * Por qué se exige la URL oficial: un modelo `anthropic-messages` servido por\n * un gateway (OpenRouter, un proxy propio, Bedrock) habla el mismo dialecto de\n * mensajes pero NO expone `/v1/files`. Subir ahí devuelve 404 y, peor, un id\n * inventado por el proxy que luego el modelo no reconoce. Si no es la URL\n * oficial, decimos por qué no y mandamos el contenido en línea como siempre.\n */\n\n/** Lo mínimo que necesitamos del modelo. Evita atarnos al tipo `Model<Api>`. */\nexport interface ModeloParaBlobs {\n\tprovider?: string;\n\tapi?: string;\n\tbaseUrl?: string;\n}\n\nexport interface CapacidadDeBlobs {\n\t/** Clave de caché: los ids no son intercambiables entre proveedores. */\n\tproveedor: string;\n\t/** Familia de API de ficheros; decide multipart, cabeceras y forma del ref. */\n\tfamilia: \"anthropic\" | \"openai\";\n\t/** URL absoluta de la colección de ficheros. */\n\turlFicheros: string;\n\t/** Cabeceras extra obligatorias (el beta de la Files API de Anthropic). */\n\tcabeceras: Record<string, string>;\n}\n\nexport interface SinCapacidad {\n\t/** Por qué NO se puede subir. Nunca vacío. */\n\tmotivo: string;\n}\n\nexport type ResultadoDeCapacidad = CapacidadDeBlobs | SinCapacidad;\n\nexport function puedeSubir(resultado: ResultadoDeCapacidad): resultado is CapacidadDeBlobs {\n\treturn \"urlFicheros\" in resultado;\n}\n\n/** Beta obligatorio de la Files API de Anthropic. Sin él, /v1/files da 404. */\nexport const BETA_FICHEROS_ANTHROPIC = \"files-api-2025-04-14\";\n\nfunction anfitrion(url: string | undefined): string | undefined {\n\tif (!url) return undefined;\n\ttry {\n\t\treturn new URL(url).host.toLowerCase();\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction sinBarraFinal(url: string): string {\n\treturn url.replace(/\\/+$/, \"\");\n}\n\nexport function capacidadDeBlobs(modelo: ModeloParaBlobs | undefined): ResultadoDeCapacidad {\n\tif (!modelo) return { motivo: \"todavía no hay modelo seleccionado en la sesión\" };\n\tconst proveedor = modelo.provider ?? \"?\";\n\tconst api = modelo.api ?? \"?\";\n\tconst host = anfitrion(modelo.baseUrl);\n\n\tif (api === \"anthropic-messages\") {\n\t\tif (proveedor !== \"anthropic\") {\n\t\t\treturn {\n\t\t\t\tmotivo: `\"${proveedor}\" habla el dialecto de mensajes de Anthropic pero no es Anthropic: no expone /v1/files`,\n\t\t\t};\n\t\t}\n\t\tif (host !== \"api.anthropic.com\") {\n\t\t\treturn {\n\t\t\t\tmotivo: `el modelo apunta a ${host ?? \"una URL ilegible\"} y no a api.anthropic.com: un gateway no expone /v1/files`,\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tproveedor: \"anthropic\",\n\t\t\tfamilia: \"anthropic\",\n\t\t\turlFicheros: `${sinBarraFinal(modelo.baseUrl ?? \"\")}/v1/files`,\n\t\t\tcabeceras: { \"anthropic-beta\": BETA_FICHEROS_ANTHROPIC, \"anthropic-version\": \"2023-06-01\" },\n\t\t};\n\t}\n\n\tif (api === \"openai-responses\") {\n\t\tif (proveedor !== \"openai\") {\n\t\t\treturn { motivo: `\"${proveedor}\" usa la API de respuestas de OpenAI pero no expone /v1/files propio` };\n\t\t}\n\t\tif (host !== \"api.openai.com\") {\n\t\t\treturn {\n\t\t\t\tmotivo: `el modelo apunta a ${host ?? \"una URL ilegible\"} y no a api.openai.com: un gateway no expone /v1/files`,\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tproveedor: \"openai\",\n\t\t\tfamilia: \"openai\",\n\t\t\turlFicheros: `${sinBarraFinal(modelo.baseUrl ?? \"\")}/files`,\n\t\t\tcabeceras: {},\n\t\t};\n\t}\n\n\t// `openai-completions` acepta `file_id` solo en bloques `file` (PDF), no en\n\t// `image_url`; como lo que hoy adjunta Ada son imágenes, aquí no hay nada\n\t// que ganar y sí un 400 que ganar. Se dice, no se intenta.\n\tif (api === \"openai-completions\") {\n\t\treturn {\n\t\t\tmotivo: `la API \"openai-completions\" no acepta file_id en bloques de imagen; solo URL o base64 en línea`,\n\t\t};\n\t}\n\n\treturn { motivo: `la API \"${api}\" del proveedor \"${proveedor}\" no tiene API de ficheros conocida` };\n}\n\n// ─── Transporte ─────────────────────────────────────────────────────────────\n\nexport interface Credencial {\n\tapiKey?: string;\n\tcabeceras?: Record<string, string>;\n}\n\nexport type Fetch = typeof globalThis.fetch;\n\nexport interface RespuestaDeSubida {\n\tok: true;\n\tid: string;\n}\n\nexport interface FalloDeSubida {\n\tok: false;\n\t/**\n\t * `rechazado` = el proveedor contestó y dijo que no (4xx). `transporte` = no\n\t * se pudo ni preguntar. La diferencia importa: un rechazo se aprende, un\n\t * fallo de transporte se reintenta en el turno siguiente.\n\t */\n\tclase: \"rechazado\" | \"transporte\";\n\tmotivo: string;\n\testado?: number;\n}\n\nexport type ResultadoDeSubida = RespuestaDeSubida | FalloDeSubida;\n\n/**\n * Un token de OAuth de Anthropic (Claude Pro/Max: empieza por `sk-ant-oat`) NO\n * vale como `x-api-key`. `packages/ai` lo sabe y construye el cliente con\n * `authToken`, que es `Authorization: Bearer`\n * (anthropic-messages.ts:873 y :923). El mismo criterio, `includes`, y no un\n * `startsWith`: el token viaja a veces con prefijo de entorno.\n */\nexport function esTokenOAuthAnthropic(apiKey: string): boolean {\n\treturn apiKey.includes(\"sk-ant-oat\");\n}\n\nfunction cabecerasDeAuth(capacidad: CapacidadDeBlobs, credencial: Credencial): Record<string, string> {\n\t// Las de `capacidad` van LAS ÚLTIMAS y ganan: son obligatorias (el beta de la\n\t// Files API). Si una cabecera de proveedor traía su propio `anthropic-beta`,\n\t// el orden de antes borraba el beta de ficheros y /v1/files contestaba 404 —\n\t// un \"no puedo\" que se leía como \"el proveedor no quiere el fichero\".\n\tconst cabeceras: Record<string, string> = { ...(credencial.cabeceras ?? {}), ...capacidad.cabeceras };\n\tif (credencial.apiKey) {\n\t\t// Con OAuth, mandar la clave en `x-api-key` da 401 en TODAS las subidas: el\n\t\t// módulo entero quedaba muerto para quien entra con Claude Pro/Max, que es\n\t\t// la mayoría, y el motivo que salía en `/blobs` era \"401 al subir\", que\n\t\t// echa la culpa al proveedor en vez de a la cabecera.\n\t\tif (capacidad.familia === \"anthropic\" && !esTokenOAuthAnthropic(credencial.apiKey)) {\n\t\t\tcabeceras[\"x-api-key\"] = credencial.apiKey;\n\t\t} else {\n\t\t\tcabeceras.authorization = `Bearer ${credencial.apiKey}`;\n\t\t}\n\t}\n\treturn cabeceras;\n}\n\nasync function textoBreve(respuesta: Response): Promise<string> {\n\ttry {\n\t\treturn (await respuesta.text()).slice(0, 300);\n\t} catch {\n\t\treturn \"\";\n\t}\n}\n\nexport async function subirFichero(\n\tcapacidad: CapacidadDeBlobs,\n\tcredencial: Credencial,\n\tfichero: { datos: Uint8Array; mime: string; nombre: string },\n\tfetchImpl: Fetch = globalThis.fetch,\n\tsignal?: AbortSignal,\n): Promise<ResultadoDeSubida> {\n\tconst formulario = new FormData();\n\t// `new Blob([...])` y no `File`: el segundo no existe en todos los runtimes\n\t// donde se ejecutan los tests, y el nombre viaja igual en el `append`.\n\tformulario.append(\"file\", new Blob([fichero.datos], { type: fichero.mime }), fichero.nombre);\n\t// OpenAI exige `purpose`; Anthropic rechaza campos extra, así que va solo donde toca.\n\tif (capacidad.familia === \"openai\") formulario.append(\"purpose\", \"vision\");\n\n\tlet respuesta: Response;\n\ttry {\n\t\trespuesta = await fetchImpl(capacidad.urlFicheros, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: cabecerasDeAuth(capacidad, credencial),\n\t\t\tbody: formulario,\n\t\t\tsignal,\n\t\t});\n\t} catch (error) {\n\t\treturn { ok: false, clase: \"transporte\", motivo: error instanceof Error ? error.message : String(error) };\n\t}\n\n\tif (!respuesta.ok) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tclase: respuesta.status >= 400 && respuesta.status < 500 ? \"rechazado\" : \"transporte\",\n\t\t\testado: respuesta.status,\n\t\t\tmotivo: `${respuesta.status} al subir: ${await textoBreve(respuesta)}`,\n\t\t};\n\t}\n\n\tlet cuerpo: unknown;\n\ttry {\n\t\tcuerpo = await respuesta.json();\n\t} catch (error) {\n\t\treturn { ok: false, clase: \"transporte\", motivo: `respuesta ilegible: ${String(error)}` };\n\t}\n\tconst id = (cuerpo as { id?: unknown })?.id;\n\tif (typeof id !== \"string\" || id.length === 0) {\n\t\t// 200 sin id es un fallo, no un éxito vacío. Devolverlo como ok dejaría\n\t\t// un `file_id: undefined` viajando en el payload.\n\t\treturn { ok: false, clase: \"rechazado\", motivo: \"el proveedor respondió 200 sin id de fichero\" };\n\t}\n\treturn { ok: true, id };\n}\n\nexport type EstadoDeFichero = \"vivo\" | \"muerto\" | \"desconocido\";\n\n/**\n * ¿Sigue existiendo el id? Se pregunta UNA vez por proceso y solo para ids que\n * vienen de una sesión anterior. Preguntarlo en cada turno costaría una\n * petición por adjunto y por turno, que es justo lo que este módulo evita.\n *\n * `desconocido` no es `muerto`: si la red falla, no sabemos si el id sirve, y\n * tratarlo como muerto resubiría el fichero cada vez que hubiera un corte.\n */\nexport async function verificarFichero(\n\tcapacidad: CapacidadDeBlobs,\n\tcredencial: Credencial,\n\tid: string,\n\tfetchImpl: Fetch = globalThis.fetch,\n\tsignal?: AbortSignal,\n): Promise<EstadoDeFichero> {\n\tlet respuesta: Response;\n\ttry {\n\t\trespuesta = await fetchImpl(`${capacidad.urlFicheros}/${encodeURIComponent(id)}`, {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: cabecerasDeAuth(capacidad, credencial),\n\t\t\tsignal,\n\t\t});\n\t} catch {\n\t\treturn \"desconocido\";\n\t}\n\tif (respuesta.ok) return \"vivo\";\n\tif (respuesta.status === 404 || respuesta.status === 410) return \"muerto\";\n\t// 401/403 no dicen nada del fichero, dicen algo de la credencial.\n\treturn \"desconocido\";\n}\n\n// Aquí vivía `borrarFichero`. No lo llamaba nadie: `/blobs purgar` solo tira la\n// entrada de la caché local, y el proveedor caduca sus ficheros solo. Código\n// escrito, probado y desenchufado; se borra en vez de dejarlo esperando a un\n// llamador que no existe.\n"]}