@hoilab/ada-cli 0.84.22 → 0.85.1

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

@@ -0,0 +1,71 @@
+/**
+ * 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 { anotarJournal, CUARENTENA_MS, Cuarentena, ceroPorCero, type EntradaJournal, FALLOS_PARA_CUARENTENA, fileIo, type OpcionesDeCadena, subirConCadena, TIMEOUT_SUBIDA_MS, tmpfilesOrg, UPLOADERS_PUBLICOS, type Uploader, type ViaDeSubida, } from "./uploaders.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;AAC9D,OAAO,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,WAAW,EACX,KAAK,cAAc,EACnB,sBAAsB,EACtB,MAAM,EACN,KAAK,gBAAgB,EACrB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,WAAW,GAChB,MAAM,gBAAgB,CAAC;AAExB,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,8EAA8E;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,IACtD,IAAI,YAAY,KAAG,IAAI,CAwH/B"}

package/dist/core/blobs/index.js

@@ -0,0 +1,233 @@
+/**
+ * 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 { anotarJournal, CUARENTENA_MS, Cuarentena, ceroPorCero, FALLOS_PARA_CUARENTENA, fileIo, subirConCadena, TIMEOUT_SUBIDA_MS, tmpfilesOrg, UPLOADERS_PUBLICOS, } from "./uploaders.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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"}

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,yCAAyC;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,yDAAyD;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"}

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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAoBH,MAAM,UAAU,WAAW,CAAC,IAAwB;IACnD,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,MAAc;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,QAAQ,GAAG,8BAA8B,CAAC;AAEhD,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,GAAY;IACzC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IACjC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrH,CAAC;AAED,oFAAoF;AACpF,SAAS,eAAe,CAAC,OAAgC,EAAE,GAAe;IACzE,MAAM,KAAK,GAAG,GAAG,KAAK,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC9E,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,YAAY,CAAC,MAA+B,EAAE,GAAe;IACrE,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/F,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,KAAK,sBAAsB,IAAI,MAAM,CAAC,IAAI,KAAK,yBAAyB,CAAC;IACrG,OAAO,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,GAAW;IAC3D,IAAI,GAAG,KAAK,oBAAoB,IAAI,GAAG,KAAK,kBAAkB;QAAE,OAAO,IAAI,CAAC;IAC5E,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,CAAC,KAAgB,EAAE,OAAe,EAAE,MAAc,EAAE,EAAE;QACrE,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACzC,IAAI,UAAU;gBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACzF,CAAC;IACF,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,4EAA4E;QAC5E,qDAAqD;QACrD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,OAAO,CAAc,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;YACzD,SAAS;QACV,CAAC;QACD,uEAAuE;QACvE,iEAAiE;QACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,SAAS;QAC7C,KAAK,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,IAAK,MAAM,CAAC,OAAqB,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9E,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,YAAY,IAAI,YAAY,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;YAC9D,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;gBAC3B,OAAO,CAAC,YAAY,CAAC,KAAK,CAAc,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;gBACvE,SAAS;YACV,CAAC;YACD,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC3C,IAAI,UAAU;gBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;QAC7G,CAAC;IACF,CAAC;IACD,OAAO,WAAW,CAAC;AACpB,CAAC;AAED,SAAS,UAAU,CAAC,MAAe,EAAE,GAAe;IACnD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,SAAS,CAAC;QAC5E,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;QAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC7E,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;IAChH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAC3G,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9G,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,GAAW,EAAE,GAAwB;IACtF,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACnC,IAAI,GAAG,KAAK,oBAAoB,IAAI,GAAG,KAAK,kBAAkB;QAAE,OAAO,OAAO,CAAC;IAC/E,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAC5B,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC;IAE9B,4EAA4E;IAC5E,MAAM,kBAAkB,GAAG,CAAC,KAAgB,EAAE,OAAe,EAAE,MAAc,EAAyB,EAAE;QACvG,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACzC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YACrB,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAC;YAC7B,YAAY,GAAG,IAAI,CAAC;YACpB,OAAO,UAAU,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACzC,CAAC,CAAC;IAEF,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE;QAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC;QAC5B,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAc,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;YACnF,IAAI,CAAC,MAAM;gBAAE,OAAO,OAAO,CAAC;YAC5B,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QACnD,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,MAAM,cAAc,GAAI,MAAM,CAAC,OAAqB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE;YACjF,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,YAAY,IAAI,YAAY,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;YAC9D,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC,KAAK,CAAc,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;gBACjG,IAAI,CAAC,MAAM;oBAAE,OAAO,MAAM,CAAC;gBAC3B,YAAY,GAAG,IAAI,CAAC;gBACpB,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;YAC7C,CAAC;YACD,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAClF,IAAI,CAAC,EAAE;gBAAE,OAAO,MAAM,CAAC;YACvB,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,UAAU;gBAAE,OAAO,MAAM,CAAC;YAC/B,YAAY,GAAG,IAAI,CAAC;YACpB,OAAO,UAAU,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY;YAAE,OAAO,OAAO,CAAC;QAClC,QAAQ,GAAG,IAAI,CAAC;QAChB,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC9B,OAAO,GAAG,KAAK,oBAAoB,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AACtH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,mBAAmB,CAAC,MAAe,EAAE,GAAe,EAAE,EAAU;IACxE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,SAAS,CAAC;QAC5E,uEAAuE;QACvE,uEAAuE;QACvE,uDAAuD;QACvD,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACnC,uEAAuE;QACvE,kEAAkE;QAClE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAC/C,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAClC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAC/C,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}