@hoilab/ada-cli 0.84.21 → 0.85.0

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

@@ -0,0 +1,70 @@
+/**
+ * Ada Blobs — los ficheros grandes viajan una vez, no en cada turno.
+ *
+ * Hoy un PDF o una captura de 1,4 MB se adjunta en base64 dentro del cuerpo de
+ * CADA petición del turno. Diez turnos de conversación son diez veces el mismo
+ * fichero subiendo por la red y contando en el prompt. Los proveedores tienen
+ * API de ficheros: se sube una vez, devuelve un id, y el id se referencia.
+ *
+ * Vive entero en ficheros de Ada y se engancha por la API pública de
+ * extensiones (`before_provider_request`), así que no cuesta nada contra el
+ * presupuesto de sincronización con upstream.
+ *
+ * Se desactiva con `ADA_NO_BLOBS=1`.
+ *
+ * LIMITACIÓN CONOCIDA, y por qué no se arregla aquí: la Files API de Anthropic
+ * nació detrás de la cabecera beta `files-api-2025-04-14`. Esa cabecera no se
+ * puede añadir desde `before_provider_headers` sin PISAR las que calcula el SDK
+ * (`interleaved-thinking`, `fine-grained-tool-streaming`), porque el merge de
+ * `anthropic-messages.ts` deja ganar a las nuestras. Perder el pensamiento
+ * intercalado por ahorrar una subida es un mal cambio. Así que la subida —que
+ * es petición nuestra y sí lleva el beta— se hace, y si el proveedor rechaza la
+ * petición de mensajes justo después de recibir referencias, se olvidan los ids
+ * y se apaga la reescritura para el resto del proceso con el motivo a la vista
+ * en `/blobs`. Como mucho se pierde un turno por proceso, y nunca en silencio.
+ *
+ * Ese "como mucho un turno" es la parte que hay que mirar con lupa, porque la
+ * primera versión la prometía y no la cumplía: el apagado colgaba solo de
+ * `after_provider_response`, que con Anthropic NUNCA llega en un 4xx (el SDK
+ * lanza desde `asResponse()` y `packages/ai` invoca `onResponse` en la línea
+ * siguiente). Se perdían todos los turnos, no uno. Por eso el apagado cuelga
+ * también de `message_end`, que es donde el fallo asoma de verdad.
+ */
+import type { ExtensionAPI } from "../extensions/types.ts";
+import { type Diagnostico } from "./broker.ts";
+import { type Credencial, type Fetch, type ModeloParaBlobs } from "./proveedor.ts";
+export { AlmacenDeBlobs } from "./almacen.ts";
+export type { Diagnostico } from "./broker.ts";
+export { BrokerDeBlobs, esRechazoDeReferencias, hashDeContenido, MIN_BYTES_POR_DEFECTO } from "./broker.ts";
+export { bytesDeBase64, localizarBlobs, reescribirBlobs } from "./payload.ts";
+export { capacidadDeBlobs, puedeSubir } from "./proveedor.ts";
+export interface OpcionesDeBlobs {
+    agentDir: string;
+    disabled?: boolean;
+    /** `fetch` inyectable: los tests cuentan peticiones de subida. */
+    fetchImpl?: Fetch;
+    minBytes?: number;
+    /** Resolución de credencial inyectable, para tests sin ModelRegistry real. */
+    resolverCredencial?: (modelo: ModeloParaBlobs) => Promise<Credencial | undefined>;
+}
+export declare function describirDiagnostico(d: Diagnostico | undefined): string;
+/**
+ * Estado HTTP con el que el proveedor rechazó la petición, leído del mensaje de
+ * error del turno.
+ *
+ * Existe porque `after_provider_response` NUNCA ve un 4xx: el SDK de Anthropic
+ * lanza `BadRequestError` desde `asResponse()` y `packages/ai` llama a
+ * `onResponse` en la línea siguiente, que ya no se ejecuta. Comprobado
+ * ejecutándolo contra `stream()` de anthropic-messages con un fetch que
+ * devuelve 400: `onResponse` vio `[]`. El único sitio donde ese fallo asoma a
+ * una extensión es `message_end`, con `stopReason: "error"` y el mensaje de la
+ * APIError, que empieza por el estado: `400 {"type":"error",...}`.
+ *
+ * Quién decide si el estado es atribuible a las referencias vive en
+ * `esRechazoDeReferencias` (broker.ts) y no aquí: los dos caminos que apagan
+ * —este y `after_provider_response`— tienen que opinar lo mismo, y tenerlo
+ * duplicado ya dio la respuesta equivocada una vez.
+ */
+export declare function estadoDeRechazo(errorMessage: string | undefined): number | undefined;
+export declare function crearExtensionDeBlobs(opciones: OpcionesDeBlobs): (pi: ExtensionAPI) => void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/blobs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAiB,KAAK,WAAW,EAAiD,MAAM,aAAa,CAAC;AAC7G,OAAO,EAAE,KAAK,UAAU,EAAoB,KAAK,KAAK,EAAE,KAAK,eAAe,EAAc,MAAM,gBAAgB,CAAC;AAEjH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA8E;IAC9E,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;CAClF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAUvE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKpF;AAOD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,8BAyH9D","sourcesContent":["/**\n * Ada Blobs — los ficheros grandes viajan una vez, no en cada turno.\n *\n * Hoy un PDF o una captura de 1,4 MB se adjunta en base64 dentro del cuerpo de\n * CADA petición del turno. Diez turnos de conversación son diez veces el mismo\n * fichero subiendo por la red y contando en el prompt. Los proveedores tienen\n * API de ficheros: se sube una vez, devuelve un id, y el id se referencia.\n *\n * Vive entero en ficheros de Ada y se engancha por la API pública de\n * extensiones (`before_provider_request`), así que no cuesta nada contra el\n * presupuesto de sincronización con upstream.\n *\n * Se desactiva con `ADA_NO_BLOBS=1`.\n *\n * LIMITACIÓN CONOCIDA, y por qué no se arregla aquí: la Files API de Anthropic\n * nació detrás de la cabecera beta `files-api-2025-04-14`. Esa cabecera no se\n * puede añadir desde `before_provider_headers` sin PISAR las que calcula el SDK\n * (`interleaved-thinking`, `fine-grained-tool-streaming`), porque el merge de\n * `anthropic-messages.ts` deja ganar a las nuestras. Perder el pensamiento\n * intercalado por ahorrar una subida es un mal cambio. Así que la subida —que\n * es petición nuestra y sí lleva el beta— se hace, y si el proveedor rechaza la\n * petición de mensajes justo después de recibir referencias, se olvidan los ids\n * y se apaga la reescritura para el resto del proceso con el motivo a la vista\n * en `/blobs`. Como mucho se pierde un turno por proceso, y nunca en silencio.\n *\n * Ese \"como mucho un turno\" es la parte que hay que mirar con lupa, porque la\n * primera versión la prometía y no la cumplía: el apagado colgaba solo de\n * `after_provider_response`, que con Anthropic NUNCA llega en un 4xx (el SDK\n * lanza desde `asResponse()` y `packages/ai` invoca `onResponse` en la línea\n * siguiente). Se perdían todos los turnos, no uno. Por eso el apagado cuelga\n * también de `message_end`, que es donde el fallo asoma de verdad.\n */\n\nimport type { ExtensionAPI } from \"../extensions/types.ts\";\nimport { AlmacenDeBlobs } from \"./almacen.ts\";\nimport { BrokerDeBlobs, type Diagnostico, esRechazoDeReferencias, MIN_BYTES_POR_DEFECTO } from \"./broker.ts\";\nimport { type Credencial, capacidadDeBlobs, type Fetch, type ModeloParaBlobs, puedeSubir } from \"./proveedor.ts\";\n\nexport { AlmacenDeBlobs } from \"./almacen.ts\";\nexport type { Diagnostico } from \"./broker.ts\";\nexport { BrokerDeBlobs, esRechazoDeReferencias, hashDeContenido, MIN_BYTES_POR_DEFECTO } from \"./broker.ts\";\nexport { bytesDeBase64, localizarBlobs, reescribirBlobs } from \"./payload.ts\";\nexport { capacidadDeBlobs, puedeSubir } from \"./proveedor.ts\";\n\nexport interface OpcionesDeBlobs {\n\tagentDir: string;\n\tdisabled?: boolean;\n\t/** `fetch` inyectable: los tests cuentan peticiones de subida. */\n\tfetchImpl?: Fetch;\n\tminBytes?: number;\n\t/** Resolución de credencial inyectable, para tests sin ModelRegistry real. */\n\tresolverCredencial?: (modelo: ModeloParaBlobs) => Promise<Credencial | undefined>;\n}\n\nexport function describirDiagnostico(d: Diagnostico | undefined): string {\n\tif (!d) return \"todavía no ha salido ninguna petición en esta sesión.\";\n\tif (d.estado === \"no-puedo\") return `no puedo subir ficheros: ${d.motivo}`;\n\tif (d.estado === \"nada-que-subir\") {\n\t\treturn d.pequenos === 0\n\t\t\t? \"no hay ningún adjunto en la conversación.\"\n\t\t\t: `${d.pequenos} adjunto(s), todos por debajo del umbral: van en línea.`;\n\t}\n\tconst omitidos = d.omitidos.length > 0 ? `, ${d.omitidos.length} en línea (${d.omitidos[0].motivo})` : \"\";\n\treturn `${d.subidos} subido(s), ${d.reutilizados} reutilizado(s)${omitidos}.`;\n}\n\n/**\n * Estado HTTP con el que el proveedor rechazó la petición, leído del mensaje de\n * error del turno.\n *\n * Existe porque `after_provider_response` NUNCA ve un 4xx: el SDK de Anthropic\n * lanza `BadRequestError` desde `asResponse()` y `packages/ai` llama a\n * `onResponse` en la línea siguiente, que ya no se ejecuta. Comprobado\n * ejecutándolo contra `stream()` de anthropic-messages con un fetch que\n * devuelve 400: `onResponse` vio `[]`. El único sitio donde ese fallo asoma a\n * una extensión es `message_end`, con `stopReason: \"error\"` y el mensaje de la\n * APIError, que empieza por el estado: `400 {\"type\":\"error\",...}`.\n *\n * Quién decide si el estado es atribuible a las referencias vive en\n * `esRechazoDeReferencias` (broker.ts) y no aquí: los dos caminos que apagan\n * —este y `after_provider_response`— tienen que opinar lo mismo, y tenerlo\n * duplicado ya dio la respuesta equivocada una vez.\n */\nexport function estadoDeRechazo(errorMessage: string | undefined): number | undefined {\n\tconst coincidencia = (errorMessage ?? \"\").trim().match(/^(\\d{3})\\b/);\n\tif (!coincidencia) return undefined;\n\tconst estado = Number(coincidencia[1]);\n\treturn esRechazoDeReferencias(estado) ? estado : undefined;\n}\n\nfunction leerUmbral(): number {\n\tconst bruto = Number(process.env.ADA_BLOBS_MIN_BYTES);\n\treturn Number.isFinite(bruto) && bruto > 0 ? Math.floor(bruto) : MIN_BYTES_POR_DEFECTO;\n}\n\nexport function crearExtensionDeBlobs(opciones: OpcionesDeBlobs) {\n\treturn (pi: ExtensionAPI): void => {\n\t\tif (opciones.disabled || process.env.ADA_NO_BLOBS === \"1\") return;\n\n\t\tconst almacen = new AlmacenDeBlobs(opciones.agentDir);\n\t\tconst broker = new BrokerDeBlobs({\n\t\t\talmacen,\n\t\t\tfetchImpl: opciones.fetchImpl,\n\t\t\tminBytes: opciones.minBytes ?? leerUmbral(),\n\t\t});\n\t\t// La carga y la purga son perezosas: arrancar una sesión no debe esperar\n\t\t// a un fichero de caché que puede no existir.\n\t\tconst listo = almacen\n\t\t\t.cargar()\n\t\t\t.then(() => {\n\t\t\t\talmacen.purgar();\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\t// Una caché ilegible degrada a \"subir siempre\", nunca a \"no arrancar\".\n\t\t\t});\n\n\t\tlet modelo: ModeloParaBlobs | undefined;\n\t\tlet ultimo: Diagnostico | undefined;\n\t\t/** Motivo por el que se apagó la reescritura en este proceso, si se apagó. */\n\t\tlet apagadoPor: string | undefined;\n\t\tlet referenciasEnVuelo = false;\n\n\t\tpi.on(\"model_select\", async (evento) => {\n\t\t\tconst m = (evento as { model?: ModeloParaBlobs }).model;\n\t\t\tif (m) modelo = { provider: m.provider, api: m.api, baseUrl: m.baseUrl };\n\t\t});\n\n\t\tpi.on(\"before_provider_request\", async (evento, ctx) => {\n\t\t\tif (apagadoPor) {\n\t\t\t\tultimo = { estado: \"no-puedo\", motivo: apagadoPor };\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\tawait listo;\n\t\t\tconst activo = modeloActivo(ctx, modelo);\n\t\t\tconst credencial = await resolverCredencial(opciones, ctx, activo);\n\t\t\tconst resultado = await broker.procesar(evento.payload, activo, credencial, ctx?.signal);\n\t\t\tultimo = resultado.diagnostico;\n\t\t\treferenciasEnVuelo =\n\t\t\t\tresultado.diagnostico.estado === \"listo\" &&\n\t\t\t\tresultado.diagnostico.subidos + resultado.diagnostico.reutilizados > 0;\n\t\t\treturn resultado.payload === evento.payload ? undefined : resultado.payload;\n\t\t});\n\n\t\tpi.on(\"after_provider_response\", async (evento) => {\n\t\t\tif (!referenciasEnVuelo) return;\n\t\t\treferenciasEnVuelo = false;\n\t\t\tif (evento.status >= 200 && evento.status < 300) {\n\t\t\t\tbroker.peticionCorrecta();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst olvidados = broker.rechazoDelProveedor(evento.status);\n\t\t\tif (olvidados.length === 0) return;\n\t\t\t// El evento no trae cuerpo, así que no se puede saber si el 4xx fue por\n\t\t\t// las referencias. Se apaga en lugar de reintentar: reintentar con las\n\t\t\t// mismas referencias repetiría el fallo turno tras turno.\n\t\t\tapagadoPor = `el proveedor devolvió ${evento.status} con referencias a fichero (${olvidados.join(\", \")}); se vuelve a mandar el contenido en línea`;\n\t\t});\n\n\t\t// La otra mitad del apagado, y la única que de verdad se ejecuta contra\n\t\t// Anthropic: `after_provider_response` solo llega con 2xx, así que el 400\n\t\t// que devolvería el proveedor si exige el beta para leer un `file_id` solo\n\t\t// asoma aquí. Sin esto la promesa de la cabecera de este fichero (\"como\n\t\t// mucho se pierde un turno por proceso\") era falsa: se perdían todos.\n\t\tpi.on(\"message_end\", async (evento) => {\n\t\t\tif (!referenciasEnVuelo) return;\n\t\t\tconst mensaje = evento.message as { role?: string; stopReason?: string; errorMessage?: string };\n\t\t\tif (mensaje.role !== \"assistant\" || mensaje.stopReason !== \"error\") return;\n\t\t\tconst estado = estadoDeRechazo(mensaje.errorMessage);\n\t\t\t// Corte de red, 5xx, 429: el turno falló, pero no sabemos nada de las\n\t\t\t// referencias. \"No sé\" no es \"no puedo\", y apagar aquí sería confundirlos.\n\t\t\tif (estado === undefined) return;\n\t\t\treferenciasEnVuelo = false;\n\t\t\tconst olvidados = broker.rechazoDelProveedor(estado);\n\t\t\tif (olvidados.length === 0) return;\n\t\t\tapagadoPor = `el proveedor devolvió ${estado} con referencias a fichero (${olvidados.join(\", \")}); se vuelve a mandar el contenido en línea`;\n\t\t});\n\n\t\tpi.on(\"session_shutdown\", async () => {\n\t\t\tawait broker.volcar().catch(() => {});\n\t\t});\n\n\t\tpi.registerCommand(\"blobs\", {\n\t\t\tdescription: \"Ficheros grandes subidos al proveedor: estado, caché y purga\",\n\t\t\thandler: async (args: string, cmdCtx): Promise<void> => {\n\t\t\t\tawait listo;\n\t\t\t\tconst decir = (texto: string) => cmdCtx.ui?.notify(texto, \"info\");\n\t\t\t\tconst sub = args.trim().split(/\\s+/)[0] || \"estado\";\n\n\t\t\t\tif (sub === \"purgar\") {\n\t\t\t\t\t// `-1` y no `0`: la purga compara `ahora - usadoEn > maxEdadMs`, y una\n\t\t\t\t\t// entrada usada en este mismo milisegundo sobrevivía a un \"purgar\".\n\t\t\t\t\tconst purgadas = almacen.purgar({ maxEdadMs: -1 });\n\t\t\t\t\tawait broker.volcar().catch(() => {});\n\t\t\t\t\tdecir(`Purgadas ${purgadas.length} entrada(s) de la caché de ficheros.`);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst capacidad = capacidadDeBlobs(modeloActivo(cmdCtx, modelo));\n\t\t\t\tconst cabecera = puedeSubir(capacidad)\n\t\t\t\t\t? `API de ficheros: ${capacidad.urlFicheros}`\n\t\t\t\t\t: `Sin API de ficheros: ${capacidad.motivo}`;\n\t\t\t\tconst c = broker.contadores;\n\t\t\t\tdecir(\n\t\t\t\t\t[\n\t\t\t\t\t\tcabecera,\n\t\t\t\t\t\t`Último turno: ${describirDiagnostico(ultimo)}`,\n\t\t\t\t\t\t`Acumulado: ${c.subidas} subida(s), ${c.reutilizaciones} reutilización(es), ${c.resubidasPorRechazo} resubida(s) por id muerto.`,\n\t\t\t\t\t\t`Caché: ${almacen.tamano()} entrada(s) en ${almacen.rutaFichero}.`,\n\t\t\t\t\t\tapagadoPor ? `APAGADO: ${apagadoPor}` : \"\",\n\t\t\t\t\t]\n\t\t\t\t\t\t.filter(Boolean)\n\t\t\t\t\t\t.join(\"\\n\"),\n\t\t\t\t);\n\t\t\t},\n\t\t});\n\t};\n}\n\n/** `ctx.model` es la verdad; el rastreado por `model_select` es el respaldo. */\nfunction modeloActivo(ctx: unknown, rastreado: ModeloParaBlobs | undefined): ModeloParaBlobs | undefined {\n\ttry {\n\t\tconst m = (ctx as { model?: ModeloParaBlobs } | undefined)?.model;\n\t\tif (m?.api) return { provider: m.provider, api: m.api, baseUrl: m.baseUrl };\n\t} catch {\n\t\t// El runtime de extensiones lanza si aún no se ha hecho bindCore().\n\t}\n\treturn rastreado;\n}\n\nasync function resolverCredencial(\n\topciones: OpcionesDeBlobs,\n\tctx: unknown,\n\tmodelo: ModeloParaBlobs | undefined,\n): Promise<Credencial | undefined> {\n\tif (!modelo) return undefined;\n\tif (opciones.resolverCredencial) return opciones.resolverCredencial(modelo);\n\ttry {\n\t\tconst registro = (\n\t\t\tctx as {\n\t\t\t\tmodelRegistry?: {\n\t\t\t\t\tgetApiKeyAndHeaders?: (m: unknown) => Promise<{\n\t\t\t\t\t\tok: boolean;\n\t\t\t\t\t\tapiKey?: string;\n\t\t\t\t\t\theaders?: Record<string, string | null>;\n\t\t\t\t\t}>;\n\t\t\t\t};\n\t\t\t}\n\t\t)?.modelRegistry;\n\t\tconst auth = await registro?.getApiKeyAndHeaders?.(modelo);\n\t\tif (!auth?.ok) return undefined;\n\t\tconst cabeceras: Record<string, string> = {};\n\t\tfor (const [clave, valor] of Object.entries(auth.headers ?? {})) {\n\t\t\tif (typeof valor === \"string\") cabeceras[clave] = valor;\n\t\t}\n\t\treturn { apiKey: auth.apiKey, cabeceras: Object.keys(cabeceras).length > 0 ? cabeceras : undefined };\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n"]}

package/dist/core/blobs/index.js

@@ -0,0 +1,232 @@
+/**
+ * Ada Blobs — los ficheros grandes viajan una vez, no en cada turno.
+ *
+ * Hoy un PDF o una captura de 1,4 MB se adjunta en base64 dentro del cuerpo de
+ * CADA petición del turno. Diez turnos de conversación son diez veces el mismo
+ * fichero subiendo por la red y contando en el prompt. Los proveedores tienen
+ * API de ficheros: se sube una vez, devuelve un id, y el id se referencia.
+ *
+ * Vive entero en ficheros de Ada y se engancha por la API pública de
+ * extensiones (`before_provider_request`), así que no cuesta nada contra el
+ * presupuesto de sincronización con upstream.
+ *
+ * Se desactiva con `ADA_NO_BLOBS=1`.
+ *
+ * LIMITACIÓN CONOCIDA, y por qué no se arregla aquí: la Files API de Anthropic
+ * nació detrás de la cabecera beta `files-api-2025-04-14`. Esa cabecera no se
+ * puede añadir desde `before_provider_headers` sin PISAR las que calcula el SDK
+ * (`interleaved-thinking`, `fine-grained-tool-streaming`), porque el merge de
+ * `anthropic-messages.ts` deja ganar a las nuestras. Perder el pensamiento
+ * intercalado por ahorrar una subida es un mal cambio. Así que la subida —que
+ * es petición nuestra y sí lleva el beta— se hace, y si el proveedor rechaza la
+ * petición de mensajes justo después de recibir referencias, se olvidan los ids
+ * y se apaga la reescritura para el resto del proceso con el motivo a la vista
+ * en `/blobs`. Como mucho se pierde un turno por proceso, y nunca en silencio.
+ *
+ * Ese "como mucho un turno" es la parte que hay que mirar con lupa, porque la
+ * primera versión la prometía y no la cumplía: el apagado colgaba solo de
+ * `after_provider_response`, que con Anthropic NUNCA llega en un 4xx (el SDK
+ * lanza desde `asResponse()` y `packages/ai` invoca `onResponse` en la línea
+ * siguiente). Se perdían todos los turnos, no uno. Por eso el apagado cuelga
+ * también de `message_end`, que es donde el fallo asoma de verdad.
+ */
+import { AlmacenDeBlobs } from "./almacen.js";
+import { BrokerDeBlobs, esRechazoDeReferencias, MIN_BYTES_POR_DEFECTO } from "./broker.js";
+import { capacidadDeBlobs, puedeSubir } from "./proveedor.js";
+export { AlmacenDeBlobs } from "./almacen.js";
+export { BrokerDeBlobs, esRechazoDeReferencias, hashDeContenido, MIN_BYTES_POR_DEFECTO } from "./broker.js";
+export { bytesDeBase64, localizarBlobs, reescribirBlobs } from "./payload.js";
+export { capacidadDeBlobs, puedeSubir } from "./proveedor.js";
+export function describirDiagnostico(d) {
+    if (!d)
+        return "todavía no ha salido ninguna petición en esta sesión.";
+    if (d.estado === "no-puedo")
+        return `no puedo subir ficheros: ${d.motivo}`;
+    if (d.estado === "nada-que-subir") {
+        return d.pequenos === 0
+            ? "no hay ningún adjunto en la conversación."
+            : `${d.pequenos} adjunto(s), todos por debajo del umbral: van en línea.`;
+    }
+    const omitidos = d.omitidos.length > 0 ? `, ${d.omitidos.length} en línea (${d.omitidos[0].motivo})` : "";
+    return `${d.subidos} subido(s), ${d.reutilizados} reutilizado(s)${omitidos}.`;
+}
+/**
+ * Estado HTTP con el que el proveedor rechazó la petición, leído del mensaje de
+ * error del turno.
+ *
+ * Existe porque `after_provider_response` NUNCA ve un 4xx: el SDK de Anthropic
+ * lanza `BadRequestError` desde `asResponse()` y `packages/ai` llama a
+ * `onResponse` en la línea siguiente, que ya no se ejecuta. Comprobado
+ * ejecutándolo contra `stream()` de anthropic-messages con un fetch que
+ * devuelve 400: `onResponse` vio `[]`. El único sitio donde ese fallo asoma a
+ * una extensión es `message_end`, con `stopReason: "error"` y el mensaje de la
+ * APIError, que empieza por el estado: `400 {"type":"error",...}`.
+ *
+ * Quién decide si el estado es atribuible a las referencias vive en
+ * `esRechazoDeReferencias` (broker.ts) y no aquí: los dos caminos que apagan
+ * —este y `after_provider_response`— tienen que opinar lo mismo, y tenerlo
+ * duplicado ya dio la respuesta equivocada una vez.
+ */
+export function estadoDeRechazo(errorMessage) {
+    const coincidencia = (errorMessage ?? "").trim().match(/^(\d{3})\b/);
+    if (!coincidencia)
+        return undefined;
+    const estado = Number(coincidencia[1]);
+    return esRechazoDeReferencias(estado) ? estado : undefined;
+}
+function leerUmbral() {
+    const bruto = Number(process.env.ADA_BLOBS_MIN_BYTES);
+    return Number.isFinite(bruto) && bruto > 0 ? Math.floor(bruto) : MIN_BYTES_POR_DEFECTO;
+}
+export function crearExtensionDeBlobs(opciones) {
+    return (pi) => {
+        if (opciones.disabled || process.env.ADA_NO_BLOBS === "1")
+            return;
+        const almacen = new AlmacenDeBlobs(opciones.agentDir);
+        const broker = new BrokerDeBlobs({
+            almacen,
+            fetchImpl: opciones.fetchImpl,
+            minBytes: opciones.minBytes ?? leerUmbral(),
+        });
+        // La carga y la purga son perezosas: arrancar una sesión no debe esperar
+        // a un fichero de caché que puede no existir.
+        const listo = almacen
+            .cargar()
+            .then(() => {
+            almacen.purgar();
+        })
+            .catch(() => {
+            // Una caché ilegible degrada a "subir siempre", nunca a "no arrancar".
+        });
+        let modelo;
+        let ultimo;
+        /** Motivo por el que se apagó la reescritura en este proceso, si se apagó. */
+        let apagadoPor;
+        let referenciasEnVuelo = false;
+        pi.on("model_select", async (evento) => {
+            const m = evento.model;
+            if (m)
+                modelo = { provider: m.provider, api: m.api, baseUrl: m.baseUrl };
+        });
+        pi.on("before_provider_request", async (evento, ctx) => {
+            if (apagadoPor) {
+                ultimo = { estado: "no-puedo", motivo: apagadoPor };
+                return undefined;
+            }
+            await listo;
+            const activo = modeloActivo(ctx, modelo);
+            const credencial = await resolverCredencial(opciones, ctx, activo);
+            const resultado = await broker.procesar(evento.payload, activo, credencial, ctx?.signal);
+            ultimo = resultado.diagnostico;
+            referenciasEnVuelo =
+                resultado.diagnostico.estado === "listo" &&
+                    resultado.diagnostico.subidos + resultado.diagnostico.reutilizados > 0;
+            return resultado.payload === evento.payload ? undefined : resultado.payload;
+        });
+        pi.on("after_provider_response", async (evento) => {
+            if (!referenciasEnVuelo)
+                return;
+            referenciasEnVuelo = false;
+            if (evento.status >= 200 && evento.status < 300) {
+                broker.peticionCorrecta();
+                return;
+            }
+            const olvidados = broker.rechazoDelProveedor(evento.status);
+            if (olvidados.length === 0)
+                return;
+            // El evento no trae cuerpo, así que no se puede saber si el 4xx fue por
+            // las referencias. Se apaga en lugar de reintentar: reintentar con las
+            // mismas referencias repetiría el fallo turno tras turno.
+            apagadoPor = `el proveedor devolvió ${evento.status} con referencias a fichero (${olvidados.join(", ")}); se vuelve a mandar el contenido en línea`;
+        });
+        // La otra mitad del apagado, y la única que de verdad se ejecuta contra
+        // Anthropic: `after_provider_response` solo llega con 2xx, así que el 400
+        // que devolvería el proveedor si exige el beta para leer un `file_id` solo
+        // asoma aquí. Sin esto la promesa de la cabecera de este fichero ("como
+        // mucho se pierde un turno por proceso") era falsa: se perdían todos.
+        pi.on("message_end", async (evento) => {
+            if (!referenciasEnVuelo)
+                return;
+            const mensaje = evento.message;
+            if (mensaje.role !== "assistant" || mensaje.stopReason !== "error")
+                return;
+            const estado = estadoDeRechazo(mensaje.errorMessage);
+            // Corte de red, 5xx, 429: el turno falló, pero no sabemos nada de las
+            // referencias. "No sé" no es "no puedo", y apagar aquí sería confundirlos.
+            if (estado === undefined)
+                return;
+            referenciasEnVuelo = false;
+            const olvidados = broker.rechazoDelProveedor(estado);
+            if (olvidados.length === 0)
+                return;
+            apagadoPor = `el proveedor devolvió ${estado} con referencias a fichero (${olvidados.join(", ")}); se vuelve a mandar el contenido en línea`;
+        });
+        pi.on("session_shutdown", async () => {
+            await broker.volcar().catch(() => { });
+        });
+        pi.registerCommand("blobs", {
+            description: "Ficheros grandes subidos al proveedor: estado, caché y purga",
+            handler: async (args, cmdCtx) => {
+                await listo;
+                const decir = (texto) => cmdCtx.ui?.notify(texto, "info");
+                const sub = args.trim().split(/\s+/)[0] || "estado";
+                if (sub === "purgar") {
+                    // `-1` y no `0`: la purga compara `ahora - usadoEn > maxEdadMs`, y una
+                    // entrada usada en este mismo milisegundo sobrevivía a un "purgar".
+                    const purgadas = almacen.purgar({ maxEdadMs: -1 });
+                    await broker.volcar().catch(() => { });
+                    decir(`Purgadas ${purgadas.length} entrada(s) de la caché de ficheros.`);
+                    return;
+                }
+                const capacidad = capacidadDeBlobs(modeloActivo(cmdCtx, modelo));
+                const cabecera = puedeSubir(capacidad)
+                    ? `API de ficheros: ${capacidad.urlFicheros}`
+                    : `Sin API de ficheros: ${capacidad.motivo}`;
+                const c = broker.contadores;
+                decir([
+                    cabecera,
+                    `Último turno: ${describirDiagnostico(ultimo)}`,
+                    `Acumulado: ${c.subidas} subida(s), ${c.reutilizaciones} reutilización(es), ${c.resubidasPorRechazo} resubida(s) por id muerto.`,
+                    `Caché: ${almacen.tamano()} entrada(s) en ${almacen.rutaFichero}.`,
+                    apagadoPor ? `APAGADO: ${apagadoPor}` : "",
+                ]
+                    .filter(Boolean)
+                    .join("\n"));
+            },
+        });
+    };
+}
+/** `ctx.model` es la verdad; el rastreado por `model_select` es el respaldo. */
+function modeloActivo(ctx, rastreado) {
+    try {
+        const m = ctx?.model;
+        if (m?.api)
+            return { provider: m.provider, api: m.api, baseUrl: m.baseUrl };
+    }
+    catch {
+        // El runtime de extensiones lanza si aún no se ha hecho bindCore().
+    }
+    return rastreado;
+}
+async function resolverCredencial(opciones, ctx, modelo) {
+    if (!modelo)
+        return undefined;
+    if (opciones.resolverCredencial)
+        return opciones.resolverCredencial(modelo);
+    try {
+        const registro = ctx?.modelRegistry;
+        const auth = await registro?.getApiKeyAndHeaders?.(modelo);
+        if (!auth?.ok)
+            return undefined;
+        const cabeceras = {};
+        for (const [clave, valor] of Object.entries(auth.headers ?? {})) {
+            if (typeof valor === "string")
+                cabeceras[clave] = valor;
+        }
+        return { apiKey: auth.apiKey, cabeceras: Object.keys(cabeceras).length > 0 ? cabeceras : undefined };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/blobs/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Ada Blobs — los ficheros grandes viajan una vez, no en cada turno.\n *\n * Hoy un PDF o una captura de 1,4 MB se adjunta en base64 dentro del cuerpo de\n * CADA petición del turno. Diez turnos de conversación son diez veces el mismo\n * fichero subiendo por la red y contando en el prompt. Los proveedores tienen\n * API de ficheros: se sube una vez, devuelve un id, y el id se referencia.\n *\n * Vive entero en ficheros de Ada y se engancha por la API pública de\n * extensiones (`before_provider_request`), así que no cuesta nada contra el\n * presupuesto de sincronización con upstream.\n *\n * Se desactiva con `ADA_NO_BLOBS=1`.\n *\n * LIMITACIÓN CONOCIDA, y por qué no se arregla aquí: la Files API de Anthropic\n * nació detrás de la cabecera beta `files-api-2025-04-14`. Esa cabecera no se\n * puede añadir desde `before_provider_headers` sin PISAR las que calcula el SDK\n * (`interleaved-thinking`, `fine-grained-tool-streaming`), porque el merge de\n * `anthropic-messages.ts` deja ganar a las nuestras. Perder el pensamiento\n * intercalado por ahorrar una subida es un mal cambio. Así que la subida —que\n * es petición nuestra y sí lleva el beta— se hace, y si el proveedor rechaza la\n * petición de mensajes justo después de recibir referencias, se olvidan los ids\n * y se apaga la reescritura para el resto del proceso con el motivo a la vista\n * en `/blobs`. Como mucho se pierde un turno por proceso, y nunca en silencio.\n *\n * Ese \"como mucho un turno\" es la parte que hay que mirar con lupa, porque la\n * primera versión la prometía y no la cumplía: el apagado colgaba solo de\n * `after_provider_response`, que con Anthropic NUNCA llega en un 4xx (el SDK\n * lanza desde `asResponse()` y `packages/ai` invoca `onResponse` en la línea\n * siguiente). Se perdían todos los turnos, no uno. Por eso el apagado cuelga\n * también de `message_end`, que es donde el fallo asoma de verdad.\n */\n\nimport type { ExtensionAPI } from \"../extensions/types.ts\";\nimport { AlmacenDeBlobs } from \"./almacen.ts\";\nimport { BrokerDeBlobs, type Diagnostico, esRechazoDeReferencias, MIN_BYTES_POR_DEFECTO } from \"./broker.ts\";\nimport { type Credencial, capacidadDeBlobs, type Fetch, type ModeloParaBlobs, puedeSubir } from \"./proveedor.ts\";\n\nexport { AlmacenDeBlobs } from \"./almacen.ts\";\nexport type { Diagnostico } from \"./broker.ts\";\nexport { BrokerDeBlobs, esRechazoDeReferencias, hashDeContenido, MIN_BYTES_POR_DEFECTO } from \"./broker.ts\";\nexport { bytesDeBase64, localizarBlobs, reescribirBlobs } from \"./payload.ts\";\nexport { capacidadDeBlobs, puedeSubir } from \"./proveedor.ts\";\n\nexport interface OpcionesDeBlobs {\n\tagentDir: string;\n\tdisabled?: boolean;\n\t/** `fetch` inyectable: los tests cuentan peticiones de subida. */\n\tfetchImpl?: Fetch;\n\tminBytes?: number;\n\t/** Resolución de credencial inyectable, para tests sin ModelRegistry real. */\n\tresolverCredencial?: (modelo: ModeloParaBlobs) => Promise<Credencial | undefined>;\n}\n\nexport function describirDiagnostico(d: Diagnostico | undefined): string {\n\tif (!d) return \"todavía no ha salido ninguna petición en esta sesión.\";\n\tif (d.estado === \"no-puedo\") return `no puedo subir ficheros: ${d.motivo}`;\n\tif (d.estado === \"nada-que-subir\") {\n\t\treturn d.pequenos === 0\n\t\t\t? \"no hay ningún adjunto en la conversación.\"\n\t\t\t: `${d.pequenos} adjunto(s), todos por debajo del umbral: van en línea.`;\n\t}\n\tconst omitidos = d.omitidos.length > 0 ? `, ${d.omitidos.length} en línea (${d.omitidos[0].motivo})` : \"\";\n\treturn `${d.subidos} subido(s), ${d.reutilizados} reutilizado(s)${omitidos}.`;\n}\n\n/**\n * Estado HTTP con el que el proveedor rechazó la petición, leído del mensaje de\n * error del turno.\n *\n * Existe porque `after_provider_response` NUNCA ve un 4xx: el SDK de Anthropic\n * lanza `BadRequestError` desde `asResponse()` y `packages/ai` llama a\n * `onResponse` en la línea siguiente, que ya no se ejecuta. Comprobado\n * ejecutándolo contra `stream()` de anthropic-messages con un fetch que\n * devuelve 400: `onResponse` vio `[]`. El único sitio donde ese fallo asoma a\n * una extensión es `message_end`, con `stopReason: \"error\"` y el mensaje de la\n * APIError, que empieza por el estado: `400 {\"type\":\"error\",...}`.\n *\n * Quién decide si el estado es atribuible a las referencias vive en\n * `esRechazoDeReferencias` (broker.ts) y no aquí: los dos caminos que apagan\n * —este y `after_provider_response`— tienen que opinar lo mismo, y tenerlo\n * duplicado ya dio la respuesta equivocada una vez.\n */\nexport function estadoDeRechazo(errorMessage: string | undefined): number | undefined {\n\tconst coincidencia = (errorMessage ?? \"\").trim().match(/^(\\d{3})\\b/);\n\tif (!coincidencia) return undefined;\n\tconst estado = Number(coincidencia[1]);\n\treturn esRechazoDeReferencias(estado) ? estado : undefined;\n}\n\nfunction leerUmbral(): number {\n\tconst bruto = Number(process.env.ADA_BLOBS_MIN_BYTES);\n\treturn Number.isFinite(bruto) && bruto > 0 ? Math.floor(bruto) : MIN_BYTES_POR_DEFECTO;\n}\n\nexport function crearExtensionDeBlobs(opciones: OpcionesDeBlobs) {\n\treturn (pi: ExtensionAPI): void => {\n\t\tif (opciones.disabled || process.env.ADA_NO_BLOBS === \"1\") return;\n\n\t\tconst almacen = new AlmacenDeBlobs(opciones.agentDir);\n\t\tconst broker = new BrokerDeBlobs({\n\t\t\talmacen,\n\t\t\tfetchImpl: opciones.fetchImpl,\n\t\t\tminBytes: opciones.minBytes ?? leerUmbral(),\n\t\t});\n\t\t// La carga y la purga son perezosas: arrancar una sesión no debe esperar\n\t\t// a un fichero de caché que puede no existir.\n\t\tconst listo = almacen\n\t\t\t.cargar()\n\t\t\t.then(() => {\n\t\t\t\talmacen.purgar();\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\t// Una caché ilegible degrada a \"subir siempre\", nunca a \"no arrancar\".\n\t\t\t});\n\n\t\tlet modelo: ModeloParaBlobs | undefined;\n\t\tlet ultimo: Diagnostico | undefined;\n\t\t/** Motivo por el que se apagó la reescritura en este proceso, si se apagó. */\n\t\tlet apagadoPor: string | undefined;\n\t\tlet referenciasEnVuelo = false;\n\n\t\tpi.on(\"model_select\", async (evento) => {\n\t\t\tconst m = (evento as { model?: ModeloParaBlobs }).model;\n\t\t\tif (m) modelo = { provider: m.provider, api: m.api, baseUrl: m.baseUrl };\n\t\t});\n\n\t\tpi.on(\"before_provider_request\", async (evento, ctx) => {\n\t\t\tif (apagadoPor) {\n\t\t\t\tultimo = { estado: \"no-puedo\", motivo: apagadoPor };\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\tawait listo;\n\t\t\tconst activo = modeloActivo(ctx, modelo);\n\t\t\tconst credencial = await resolverCredencial(opciones, ctx, activo);\n\t\t\tconst resultado = await broker.procesar(evento.payload, activo, credencial, ctx?.signal);\n\t\t\tultimo = resultado.diagnostico;\n\t\t\treferenciasEnVuelo =\n\t\t\t\tresultado.diagnostico.estado === \"listo\" &&\n\t\t\t\tresultado.diagnostico.subidos + resultado.diagnostico.reutilizados > 0;\n\t\t\treturn resultado.payload === evento.payload ? undefined : resultado.payload;\n\t\t});\n\n\t\tpi.on(\"after_provider_response\", async (evento) => {\n\t\t\tif (!referenciasEnVuelo) return;\n\t\t\treferenciasEnVuelo = false;\n\t\t\tif (evento.status >= 200 && evento.status < 300) {\n\t\t\t\tbroker.peticionCorrecta();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst olvidados = broker.rechazoDelProveedor(evento.status);\n\t\t\tif (olvidados.length === 0) return;\n\t\t\t// El evento no trae cuerpo, así que no se puede saber si el 4xx fue por\n\t\t\t// las referencias. Se apaga en lugar de reintentar: reintentar con las\n\t\t\t// mismas referencias repetiría el fallo turno tras turno.\n\t\t\tapagadoPor = `el proveedor devolvió ${evento.status} con referencias a fichero (${olvidados.join(\", \")}); se vuelve a mandar el contenido en línea`;\n\t\t});\n\n\t\t// La otra mitad del apagado, y la única que de verdad se ejecuta contra\n\t\t// Anthropic: `after_provider_response` solo llega con 2xx, así que el 400\n\t\t// que devolvería el proveedor si exige el beta para leer un `file_id` solo\n\t\t// asoma aquí. Sin esto la promesa de la cabecera de este fichero (\"como\n\t\t// mucho se pierde un turno por proceso\") era falsa: se perdían todos.\n\t\tpi.on(\"message_end\", async (evento) => {\n\t\t\tif (!referenciasEnVuelo) return;\n\t\t\tconst mensaje = evento.message as { role?: string; stopReason?: string; errorMessage?: string };\n\t\t\tif (mensaje.role !== \"assistant\" || mensaje.stopReason !== \"error\") return;\n\t\t\tconst estado = estadoDeRechazo(mensaje.errorMessage);\n\t\t\t// Corte de red, 5xx, 429: el turno falló, pero no sabemos nada de las\n\t\t\t// referencias. \"No sé\" no es \"no puedo\", y apagar aquí sería confundirlos.\n\t\t\tif (estado === undefined) return;\n\t\t\treferenciasEnVuelo = false;\n\t\t\tconst olvidados = broker.rechazoDelProveedor(estado);\n\t\t\tif (olvidados.length === 0) return;\n\t\t\tapagadoPor = `el proveedor devolvió ${estado} con referencias a fichero (${olvidados.join(\", \")}); se vuelve a mandar el contenido en línea`;\n\t\t});\n\n\t\tpi.on(\"session_shutdown\", async () => {\n\t\t\tawait broker.volcar().catch(() => {});\n\t\t});\n\n\t\tpi.registerCommand(\"blobs\", {\n\t\t\tdescription: \"Ficheros grandes subidos al proveedor: estado, caché y purga\",\n\t\t\thandler: async (args: string, cmdCtx): Promise<void> => {\n\t\t\t\tawait listo;\n\t\t\t\tconst decir = (texto: string) => cmdCtx.ui?.notify(texto, \"info\");\n\t\t\t\tconst sub = args.trim().split(/\\s+/)[0] || \"estado\";\n\n\t\t\t\tif (sub === \"purgar\") {\n\t\t\t\t\t// `-1` y no `0`: la purga compara `ahora - usadoEn > maxEdadMs`, y una\n\t\t\t\t\t// entrada usada en este mismo milisegundo sobrevivía a un \"purgar\".\n\t\t\t\t\tconst purgadas = almacen.purgar({ maxEdadMs: -1 });\n\t\t\t\t\tawait broker.volcar().catch(() => {});\n\t\t\t\t\tdecir(`Purgadas ${purgadas.length} entrada(s) de la caché de ficheros.`);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst capacidad = capacidadDeBlobs(modeloActivo(cmdCtx, modelo));\n\t\t\t\tconst cabecera = puedeSubir(capacidad)\n\t\t\t\t\t? `API de ficheros: ${capacidad.urlFicheros}`\n\t\t\t\t\t: `Sin API de ficheros: ${capacidad.motivo}`;\n\t\t\t\tconst c = broker.contadores;\n\t\t\t\tdecir(\n\t\t\t\t\t[\n\t\t\t\t\t\tcabecera,\n\t\t\t\t\t\t`Último turno: ${describirDiagnostico(ultimo)}`,\n\t\t\t\t\t\t`Acumulado: ${c.subidas} subida(s), ${c.reutilizaciones} reutilización(es), ${c.resubidasPorRechazo} resubida(s) por id muerto.`,\n\t\t\t\t\t\t`Caché: ${almacen.tamano()} entrada(s) en ${almacen.rutaFichero}.`,\n\t\t\t\t\t\tapagadoPor ? `APAGADO: ${apagadoPor}` : \"\",\n\t\t\t\t\t]\n\t\t\t\t\t\t.filter(Boolean)\n\t\t\t\t\t\t.join(\"\\n\"),\n\t\t\t\t);\n\t\t\t},\n\t\t});\n\t};\n}\n\n/** `ctx.model` es la verdad; el rastreado por `model_select` es el respaldo. */\nfunction modeloActivo(ctx: unknown, rastreado: ModeloParaBlobs | undefined): ModeloParaBlobs | undefined {\n\ttry {\n\t\tconst m = (ctx as { model?: ModeloParaBlobs } | undefined)?.model;\n\t\tif (m?.api) return { provider: m.provider, api: m.api, baseUrl: m.baseUrl };\n\t} catch {\n\t\t// El runtime de extensiones lanza si aún no se ha hecho bindCore().\n\t}\n\treturn rastreado;\n}\n\nasync function resolverCredencial(\n\topciones: OpcionesDeBlobs,\n\tctx: unknown,\n\tmodelo: ModeloParaBlobs | undefined,\n): Promise<Credencial | undefined> {\n\tif (!modelo) return undefined;\n\tif (opciones.resolverCredencial) return opciones.resolverCredencial(modelo);\n\ttry {\n\t\tconst registro = (\n\t\t\tctx as {\n\t\t\t\tmodelRegistry?: {\n\t\t\t\t\tgetApiKeyAndHeaders?: (m: unknown) => Promise<{\n\t\t\t\t\t\tok: boolean;\n\t\t\t\t\t\tapiKey?: string;\n\t\t\t\t\t\theaders?: Record<string, string | null>;\n\t\t\t\t\t}>;\n\t\t\t\t};\n\t\t\t}\n\t\t)?.modelRegistry;\n\t\tconst auth = await registro?.getApiKeyAndHeaders?.(modelo);\n\t\tif (!auth?.ok) return undefined;\n\t\tconst cabeceras: Record<string, string> = {};\n\t\tfor (const [clave, valor] of Object.entries(auth.headers ?? {})) {\n\t\t\tif (typeof valor === \"string\") cabeceras[clave] = valor;\n\t\t}\n\t\treturn { apiKey: auth.apiKey, cabeceras: Object.keys(cabeceras).length > 0 ? cabeceras : undefined };\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n"]}

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

@@ -0,0 +1,55 @@
+/**
+ * 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 type ApiDeBlobs = "anthropic-messages" | "openai-responses";
+export interface BloqueBlob {
+    /**
+     * Dónde está: índice de mensaje, índice de bloque dentro de su contenido y,
+     * si el bloque cuelga del resultado de una herramienta, el índice dentro de
+     * ese resultado. `bloque: -1` = el contenedor ES el item de primer nivel
+     * (así viaja `function_call_output` en OpenAI responses).
+     */
+    ruta: {
+        mensaje: number;
+        bloque: number;
+        anidado?: number;
+    };
+    clase: "imagen" | "documento";
+    mime: string;
+    /** Contenido en base64, sin el prefijo `data:`. */
+    base64: string;
+    /** Tamaño del contenido decodificado. */
+    bytes: number;
+}
+export declare function claveDeRuta(ruta: BloqueBlob["ruta"]): string;
+/** Bytes reales que representa una cadena base64, sin decodificarla. */
+export declare function bytesDeBase64(base64: string): number;
+/** `data:image/png;base64,AAAA` → `{ mime, base64 }`. */
+export declare function partirDataUrl(url: unknown): {
+    mime: string;
+    base64: string;
+} | undefined;
+export declare function localizarBlobs(payload: unknown, api: string): BloqueBlob[] | null;
+/**
+ * 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 declare function reescribirBlobs(payload: unknown, api: string, ids: Map<string, string>): unknown;
+//# sourceMappingURL=payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/core/blobs/payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,kBAAkB,CAAC;AAEnE,MAAM,WAAW,UAAU;IAC1B;;;;;OAKG;IACH,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,KAAK,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,0CAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAE5D;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGpD;AAID,2DAAyD;AACzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAKxF;AAiCD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,IAAI,CAwCjF;AA6BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CA0DhG","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"]}