@hoilab/ada-cli 0.84.22 → 0.85.0

package/dist/core/usage/cuota/google-gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-gemini.d.ts","sourceRoot":"","sources":["../../../../src/core/usage/cuota/google-gemini.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAyC,MAAM,YAAY,CAAC;AAwDxF,eAAO,MAAM,qBAAqB,EAAE,cA0CnC,CAAC","sourcesContent":["/**\n * Cuota de Gemini (Google Code Assist / Antigravity) — dos llamadas: primero\n * `loadCodeAssist` para resolver el proyecto de Cloud, luego\n * `retrieveUserQuota` con ese proyecto. Si la credencial ya trae un\n * `projectId` guardado se usa ese y se ahorra la primera petición.\n */\n\nimport { type ConsultorCuota, ErrorConsultaCuota, type VentanaCuota } from \"./tipos.ts\";\n\nconst BASE_URL = \"https://cloudcode-pa.googleapis.com\";\nconst PROVEEDOR = \"google\";\n\ninterface CargaCodeAssist {\n\tcloudaicompanionProject?: string | { id?: string };\n}\n\ninterface CuboBruto {\n\tmodelId?: string;\n\tremainingFraction?: number;\n\tresetTime?: string;\n}\n\ninterface RespuestaCuota {\n\tbuckets?: CuboBruto[];\n}\n\nfunction proyectoDe(carga: CargaCodeAssist | undefined): string | undefined {\n\tconst p = carga?.cloudaicompanionProject;\n\tif (typeof p === \"string\") return p;\n\tif (p && typeof p === \"object\") return p.id;\n\treturn undefined;\n}\n\nasync function pedir<T>(\n\tfetchImpl: typeof fetch,\n\turl: string,\n\ttoken: string,\n\tcuerpo: unknown,\n\tseñal: AbortSignal | undefined,\n): Promise<T> {\n\tlet respuesta: Response;\n\ttry {\n\t\trespuesta = await fetchImpl(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { authorization: `Bearer ${token}`, \"content-type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(cuerpo),\n\t\t\tsignal: señal,\n\t\t});\n\t} catch (error) {\n\t\tthrow new ErrorConsultaCuota(PROVEEDOR, `no se pudo contactar con Google: ${String(error)}`, { cause: error });\n\t}\n\tif (!respuesta.ok) {\n\t\tthrow new ErrorConsultaCuota(PROVEEDOR, `Google respondió ${respuesta.status} ${respuesta.statusText}`);\n\t}\n\ttry {\n\t\treturn (await respuesta.json()) as T;\n\t} catch (error) {\n\t\tthrow new ErrorConsultaCuota(PROVEEDOR, `la respuesta de Google no es JSON válido: ${String(error)}`, {\n\t\t\tcause: error,\n\t\t});\n\t}\n}\n\nexport const consultorGoogleGemini: ConsultorCuota = {\n\tid: PROVEEDOR,\n\tsoporta: (credencial) => credencial.type === \"oauth\",\n\tasync consultar({ credencial, fetch: fetchImpl = fetch, señal }) {\n\t\tif (credencial.type !== \"oauth\") return null;\n\n\t\tconst proyectoGuardado = typeof credencial.projectId === \"string\" ? credencial.projectId : undefined;\n\t\tlet proyecto = proyectoGuardado;\n\t\tif (!proyecto) {\n\t\t\tconst carga = await pedir<CargaCodeAssist>(\n\t\t\t\tfetchImpl,\n\t\t\t\t`${BASE_URL}/v1internal:loadCodeAssist`,\n\t\t\t\tcredencial.access,\n\t\t\t\t{ metadata: { ideType: \"IDE_UNSPECIFIED\", platform: \"PLATFORM_UNSPECIFIED\", pluginType: \"GEMINI\" } },\n\t\t\t\tseñal,\n\t\t\t);\n\t\t\tproyecto = proyectoDe(carga);\n\t\t}\n\n\t\tconst cuota = await pedir<RespuestaCuota>(\n\t\t\tfetchImpl,\n\t\t\t`${BASE_URL}/v1internal:retrieveUserQuota`,\n\t\t\tcredencial.access,\n\t\t\tproyecto ? { project: proyecto } : {},\n\t\t\tseñal,\n\t\t);\n\n\t\tconst ventanas = (cuota.buckets ?? [])\n\t\t\t.filter((b): b is CuboBruto & { remainingFraction: number } => typeof b.remainingFraction === \"number\")\n\t\t\t.map((b): VentanaCuota => {\n\t\t\t\tconst restante = Math.min(Math.max(b.remainingFraction, 0), 1);\n\t\t\t\tconst seReiniciaBruto = b.resetTime ? Date.parse(b.resetTime) : Number.NaN;\n\t\t\t\treturn {\n\t\t\t\t\tetiqueta: b.modelId ?? \"Gemini\",\n\t\t\t\t\tusado: Math.round((1 - restante) * 1000) / 10,\n\t\t\t\t\tlimite: 100,\n\t\t\t\t\tseReinicia: Number.isFinite(seReiniciaBruto) ? seReiniciaBruto : null,\n\t\t\t\t\tunidad: \"porcentaje\",\n\t\t\t\t};\n\t\t\t});\n\t\treturn ventanas.length > 0 ? ventanas : null;\n\t},\n};\n"]}

package/dist/core/usage/cuota/google-gemini.js

@@ -0,0 +1,72 @@
+/**
+ * Cuota de Gemini (Google Code Assist / Antigravity) — dos llamadas: primero
+ * `loadCodeAssist` para resolver el proyecto de Cloud, luego
+ * `retrieveUserQuota` con ese proyecto. Si la credencial ya trae un
+ * `projectId` guardado se usa ese y se ahorra la primera petición.
+ */
+import { ErrorConsultaCuota } from "./tipos.js";
+const BASE_URL = "https://cloudcode-pa.googleapis.com";
+const PROVEEDOR = "google";
+function proyectoDe(carga) {
+    const p = carga?.cloudaicompanionProject;
+    if (typeof p === "string")
+        return p;
+    if (p && typeof p === "object")
+        return p.id;
+    return undefined;
+}
+async function pedir(fetchImpl, url, token, cuerpo, señal) {
+    let respuesta;
+    try {
+        respuesta = await fetchImpl(url, {
+            method: "POST",
+            headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+            body: JSON.stringify(cuerpo),
+            signal: señal,
+        });
+    }
+    catch (error) {
+        throw new ErrorConsultaCuota(PROVEEDOR, `no se pudo contactar con Google: ${String(error)}`, { cause: error });
+    }
+    if (!respuesta.ok) {
+        throw new ErrorConsultaCuota(PROVEEDOR, `Google respondió ${respuesta.status} ${respuesta.statusText}`);
+    }
+    try {
+        return (await respuesta.json());
+    }
+    catch (error) {
+        throw new ErrorConsultaCuota(PROVEEDOR, `la respuesta de Google no es JSON válido: ${String(error)}`, {
+            cause: error,
+        });
+    }
+}
+export const consultorGoogleGemini = {
+    id: PROVEEDOR,
+    soporta: (credencial) => credencial.type === "oauth",
+    async consultar({ credencial, fetch: fetchImpl = fetch, señal }) {
+        if (credencial.type !== "oauth")
+            return null;
+        const proyectoGuardado = typeof credencial.projectId === "string" ? credencial.projectId : undefined;
+        let proyecto = proyectoGuardado;
+        if (!proyecto) {
+            const carga = await pedir(fetchImpl, `${BASE_URL}/v1internal:loadCodeAssist`, credencial.access, { metadata: { ideType: "IDE_UNSPECIFIED", platform: "PLATFORM_UNSPECIFIED", pluginType: "GEMINI" } }, señal);
+            proyecto = proyectoDe(carga);
+        }
+        const cuota = await pedir(fetchImpl, `${BASE_URL}/v1internal:retrieveUserQuota`, credencial.access, proyecto ? { project: proyecto } : {}, señal);
+        const ventanas = (cuota.buckets ?? [])
+            .filter((b) => typeof b.remainingFraction === "number")
+            .map((b) => {
+            const restante = Math.min(Math.max(b.remainingFraction, 0), 1);
+            const seReiniciaBruto = b.resetTime ? Date.parse(b.resetTime) : Number.NaN;
+            return {
+                etiqueta: b.modelId ?? "Gemini",
+                usado: Math.round((1 - restante) * 1000) / 10,
+                limite: 100,
+                seReinicia: Number.isFinite(seReiniciaBruto) ? seReiniciaBruto : null,
+                unidad: "porcentaje",
+            };
+        });
+        return ventanas.length > 0 ? ventanas : null;
+    },
+};
+//# sourceMappingURL=google-gemini.js.map

package/dist/core/usage/cuota/google-gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-gemini.js","sourceRoot":"","sources":["../../../../src/core/usage/cuota/google-gemini.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cuota de Gemini (Google Code Assist / Antigravity) — dos llamadas: primero\n * `loadCodeAssist` para resolver el proyecto de Cloud, luego\n * `retrieveUserQuota` con ese proyecto. Si la credencial ya trae un\n * `projectId` guardado se usa ese y se ahorra la primera petición.\n */\n\nimport { type ConsultorCuota, ErrorConsultaCuota, type VentanaCuota } from \"./tipos.ts\";\n\nconst BASE_URL = \"https://cloudcode-pa.googleapis.com\";\nconst PROVEEDOR = \"google\";\n\ninterface CargaCodeAssist {\n\tcloudaicompanionProject?: string | { id?: string };\n}\n\ninterface CuboBruto {\n\tmodelId?: string;\n\tremainingFraction?: number;\n\tresetTime?: string;\n}\n\ninterface RespuestaCuota {\n\tbuckets?: CuboBruto[];\n}\n\nfunction proyectoDe(carga: CargaCodeAssist | undefined): string | undefined {\n\tconst p = carga?.cloudaicompanionProject;\n\tif (typeof p === \"string\") return p;\n\tif (p && typeof p === \"object\") return p.id;\n\treturn undefined;\n}\n\nasync function pedir<T>(\n\tfetchImpl: typeof fetch,\n\turl: string,\n\ttoken: string,\n\tcuerpo: unknown,\n\tseñal: AbortSignal | undefined,\n): Promise<T> {\n\tlet respuesta: Response;\n\ttry {\n\t\trespuesta = await fetchImpl(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { authorization: `Bearer ${token}`, \"content-type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(cuerpo),\n\t\t\tsignal: señal,\n\t\t});\n\t} catch (error) {\n\t\tthrow new ErrorConsultaCuota(PROVEEDOR, `no se pudo contactar con Google: ${String(error)}`, { cause: error });\n\t}\n\tif (!respuesta.ok) {\n\t\tthrow new ErrorConsultaCuota(PROVEEDOR, `Google respondió ${respuesta.status} ${respuesta.statusText}`);\n\t}\n\ttry {\n\t\treturn (await respuesta.json()) as T;\n\t} catch (error) {\n\t\tthrow new ErrorConsultaCuota(PROVEEDOR, `la respuesta de Google no es JSON válido: ${String(error)}`, {\n\t\t\tcause: error,\n\t\t});\n\t}\n}\n\nexport const consultorGoogleGemini: ConsultorCuota = {\n\tid: PROVEEDOR,\n\tsoporta: (credencial) => credencial.type === \"oauth\",\n\tasync consultar({ credencial, fetch: fetchImpl = fetch, señal }) {\n\t\tif (credencial.type !== \"oauth\") return null;\n\n\t\tconst proyectoGuardado = typeof credencial.projectId === \"string\" ? credencial.projectId : undefined;\n\t\tlet proyecto = proyectoGuardado;\n\t\tif (!proyecto) {\n\t\t\tconst carga = await pedir<CargaCodeAssist>(\n\t\t\t\tfetchImpl,\n\t\t\t\t`${BASE_URL}/v1internal:loadCodeAssist`,\n\t\t\t\tcredencial.access,\n\t\t\t\t{ metadata: { ideType: \"IDE_UNSPECIFIED\", platform: \"PLATFORM_UNSPECIFIED\", pluginType: \"GEMINI\" } },\n\t\t\t\tseñal,\n\t\t\t);\n\t\t\tproyecto = proyectoDe(carga);\n\t\t}\n\n\t\tconst cuota = await pedir<RespuestaCuota>(\n\t\t\tfetchImpl,\n\t\t\t`${BASE_URL}/v1internal:retrieveUserQuota`,\n\t\t\tcredencial.access,\n\t\t\tproyecto ? { project: proyecto } : {},\n\t\t\tseñal,\n\t\t);\n\n\t\tconst ventanas = (cuota.buckets ?? [])\n\t\t\t.filter((b): b is CuboBruto & { remainingFraction: number } => typeof b.remainingFraction === \"number\")\n\t\t\t.map((b): VentanaCuota => {\n\t\t\t\tconst restante = Math.min(Math.max(b.remainingFraction, 0), 1);\n\t\t\t\tconst seReiniciaBruto = b.resetTime ? Date.parse(b.resetTime) : Number.NaN;\n\t\t\t\treturn {\n\t\t\t\t\tetiqueta: b.modelId ?? \"Gemini\",\n\t\t\t\t\tusado: Math.round((1 - restante) * 1000) / 10,\n\t\t\t\t\tlimite: 100,\n\t\t\t\t\tseReinicia: Number.isFinite(seReiniciaBruto) ? seReiniciaBruto : null,\n\t\t\t\t\tunidad: \"porcentaje\",\n\t\t\t\t};\n\t\t\t});\n\t\treturn ventanas.length > 0 ? ventanas : null;\n\t},\n};\n"]}

package/dist/core/usage/cuota/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Registro de consultores de cuota, uno por proveedor.
+ *
+ * `ada-cli usage` (ver `../aggregate.ts`) dice lo GASTADO. Esto dice lo que
+ * QUEDA: se lo pregunta al proveedor, con la credencial que ya tiene
+ * guardada en `auth.json`, y cachea la respuesta unos minutos para no sumar
+ * una petición HTTP a cada turno.
+ */
+import type { Credential } from "@earendil-works/pi-ai";
+import type { ContextoConsulta, VentanaCuota } from "./tipos.ts";
+export { limpiarCacheCuota } from "./cache.ts";
+export { type ConsultorCuota, type ContextoConsulta, ErrorConsultaCuota, type UnidadCuota, type VentanaCuota, } from "./tipos.ts";
+/** Proveedores para los que hay un consultor de cuota, en el orden en que se enseñan. */
+export declare const PROVEEDORES_CON_CUOTA: readonly string[];
+/**
+ * Cuánto queda del plan para un proveedor, con la credencial dada.
+ *
+ * `null` = no hay credencial, el proveedor no la reconoce, o el proveedor no
+ * publica cuota para ese tipo de credencial (p.ej. la API key de Anthropic).
+ * Lanza {@link ErrorConsultaCuota} si la consulta llega a intentarse y falla:
+ * eso NUNCA se reporta como `null`, o un fallo de red se leería como "sin
+ * límite".
+ */
+export declare function consultarCuota(proveedor: string, credencial: Credential | undefined, opciones?: Omit<ContextoConsulta, "credencial">): Promise<VentanaCuota[] | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/usage/cuota/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/usage/cuota/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAOxD,OAAO,KAAK,EAAkB,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,GACjB,MAAM,YAAY,CAAC;AAUpB,0FAAyF;AACzF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAA6B,CAAC;AAYjF;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CACnC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,QAAQ,GAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAM,GACjD,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAIhC","sourcesContent":["/**\n * Registro de consultores de cuota, uno por proveedor.\n *\n * `ada-cli usage` (ver `../aggregate.ts`) dice lo GASTADO. Esto dice lo que\n * QUEDA: se lo pregunta al proveedor, con la credencial que ya tiene\n * guardada en `auth.json`, y cachea la respuesta unos minutos para no sumar\n * una petición HTTP a cada turno.\n */\n\nimport type { Credential } from \"@earendil-works/pi-ai\";\nimport { consultorAnthropic } from \"./anthropic.ts\";\nimport { conCache } from \"./cache.ts\";\nimport { consultorGithubCopilot } from \"./github-copilot.ts\";\nimport { consultorGoogleGemini } from \"./google-gemini.ts\";\nimport { consultorOpenAiCodex } from \"./openai-codex.ts\";\nimport { consultorOpenRouter } from \"./openrouter.ts\";\nimport type { ConsultorCuota, ContextoConsulta, VentanaCuota } from \"./tipos.ts\";\n\nexport { limpiarCacheCuota } from \"./cache.ts\";\nexport {\n\ttype ConsultorCuota,\n\ttype ContextoConsulta,\n\tErrorConsultaCuota,\n\ttype UnidadCuota,\n\ttype VentanaCuota,\n} from \"./tipos.ts\";\n\nconst CONSULTORES: Record<string, ConsultorCuota> = {\n\tanthropic: consultorAnthropic,\n\topenrouter: consultorOpenRouter,\n\t\"openai-codex\": consultorOpenAiCodex,\n\t\"github-copilot\": consultorGithubCopilot,\n\tgoogle: consultorGoogleGemini,\n};\n\n/** Proveedores para los que hay un consultor de cuota, en el orden en que se enseñan. */\nexport const PROVEEDORES_CON_CUOTA: readonly string[] = Object.keys(CONSULTORES);\n\n/**\n * Los últimos caracteres del secreto bastan para distinguir dos credenciales\n * del mismo proveedor sin quedarse el secreto entero más tiempo del\n * necesario dentro de la clave de caché.\n */\nfunction claveCache(proveedor: string, credencial: Credential): string {\n\tconst identidad = credencial.type === \"oauth\" ? credencial.access : (credencial.key ?? \"\");\n\treturn `${proveedor}:${identidad.slice(-12)}`;\n}\n\n/**\n * Cuánto queda del plan para un proveedor, con la credencial dada.\n *\n * `null` = no hay credencial, el proveedor no la reconoce, o el proveedor no\n * publica cuota para ese tipo de credencial (p.ej. la API key de Anthropic).\n * Lanza {@link ErrorConsultaCuota} si la consulta llega a intentarse y falla:\n * eso NUNCA se reporta como `null`, o un fallo de red se leería como \"sin\n * límite\".\n */\nexport async function consultarCuota(\n\tproveedor: string,\n\tcredencial: Credential | undefined,\n\topciones: Omit<ContextoConsulta, \"credencial\"> = {},\n): Promise<VentanaCuota[] | null> {\n\tconst consultor = CONSULTORES[proveedor];\n\tif (!consultor || !credencial || !consultor.soporta(credencial)) return null;\n\treturn conCache(claveCache(proveedor, credencial), () => consultor.consultar({ ...opciones, credencial }));\n}\n"]}

package/dist/core/usage/cuota/index.js

@@ -0,0 +1,50 @@
+/**
+ * Registro de consultores de cuota, uno por proveedor.
+ *
+ * `ada-cli usage` (ver `../aggregate.ts`) dice lo GASTADO. Esto dice lo que
+ * QUEDA: se lo pregunta al proveedor, con la credencial que ya tiene
+ * guardada en `auth.json`, y cachea la respuesta unos minutos para no sumar
+ * una petición HTTP a cada turno.
+ */
+import { consultorAnthropic } from "./anthropic.js";
+import { conCache } from "./cache.js";
+import { consultorGithubCopilot } from "./github-copilot.js";
+import { consultorGoogleGemini } from "./google-gemini.js";
+import { consultorOpenAiCodex } from "./openai-codex.js";
+import { consultorOpenRouter } from "./openrouter.js";
+export { limpiarCacheCuota } from "./cache.js";
+export { ErrorConsultaCuota, } from "./tipos.js";
+const CONSULTORES = {
+    anthropic: consultorAnthropic,
+    openrouter: consultorOpenRouter,
+    "openai-codex": consultorOpenAiCodex,
+    "github-copilot": consultorGithubCopilot,
+    google: consultorGoogleGemini,
+};
+/** Proveedores para los que hay un consultor de cuota, en el orden en que se enseñan. */
+export const PROVEEDORES_CON_CUOTA = Object.keys(CONSULTORES);
+/**
+ * Los últimos caracteres del secreto bastan para distinguir dos credenciales
+ * del mismo proveedor sin quedarse el secreto entero más tiempo del
+ * necesario dentro de la clave de caché.
+ */
+function claveCache(proveedor, credencial) {
+    const identidad = credencial.type === "oauth" ? credencial.access : (credencial.key ?? "");
+    return `${proveedor}:${identidad.slice(-12)}`;
+}
+/**
+ * Cuánto queda del plan para un proveedor, con la credencial dada.
+ *
+ * `null` = no hay credencial, el proveedor no la reconoce, o el proveedor no
+ * publica cuota para ese tipo de credencial (p.ej. la API key de Anthropic).
+ * Lanza {@link ErrorConsultaCuota} si la consulta llega a intentarse y falla:
+ * eso NUNCA se reporta como `null`, o un fallo de red se leería como "sin
+ * límite".
+ */
+export async function consultarCuota(proveedor, credencial, opciones = {}) {
+    const consultor = CONSULTORES[proveedor];
+    if (!consultor || !credencial || !consultor.soporta(credencial))
+        return null;
+    return conCache(claveCache(proveedor, credencial), () => consultor.consultar({ ...opciones, credencial }));
+}
+//# sourceMappingURL=index.js.map

package/dist/core/usage/cuota/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/usage/cuota/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAGN,kBAAkB,GAGlB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,GAAmC;IACnD,SAAS,EAAE,kBAAkB;IAC7B,UAAU,EAAE,mBAAmB;IAC/B,cAAc,EAAE,oBAAoB;IACpC,gBAAgB,EAAE,sBAAsB;IACxC,MAAM,EAAE,qBAAqB;CAC7B,CAAC;AAEF,0FAAyF;AACzF,MAAM,CAAC,MAAM,qBAAqB,GAAsB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAEjF;;;;GAIG;AACH,SAAS,UAAU,CAAC,SAAiB,EAAE,UAAsB,EAAU;IACtE,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAC3F,OAAO,GAAG,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAAA,CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,SAAiB,EACjB,UAAkC,EAClC,QAAQ,GAAyC,EAAE,EAClB;IACjC,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,OAAO,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AAAA,CAC3G","sourcesContent":["/**\n * Registro de consultores de cuota, uno por proveedor.\n *\n * `ada-cli usage` (ver `../aggregate.ts`) dice lo GASTADO. Esto dice lo que\n * QUEDA: se lo pregunta al proveedor, con la credencial que ya tiene\n * guardada en `auth.json`, y cachea la respuesta unos minutos para no sumar\n * una petición HTTP a cada turno.\n */\n\nimport type { Credential } from \"@earendil-works/pi-ai\";\nimport { consultorAnthropic } from \"./anthropic.ts\";\nimport { conCache } from \"./cache.ts\";\nimport { consultorGithubCopilot } from \"./github-copilot.ts\";\nimport { consultorGoogleGemini } from \"./google-gemini.ts\";\nimport { consultorOpenAiCodex } from \"./openai-codex.ts\";\nimport { consultorOpenRouter } from \"./openrouter.ts\";\nimport type { ConsultorCuota, ContextoConsulta, VentanaCuota } from \"./tipos.ts\";\n\nexport { limpiarCacheCuota } from \"./cache.ts\";\nexport {\n\ttype ConsultorCuota,\n\ttype ContextoConsulta,\n\tErrorConsultaCuota,\n\ttype UnidadCuota,\n\ttype VentanaCuota,\n} from \"./tipos.ts\";\n\nconst CONSULTORES: Record<string, ConsultorCuota> = {\n\tanthropic: consultorAnthropic,\n\topenrouter: consultorOpenRouter,\n\t\"openai-codex\": consultorOpenAiCodex,\n\t\"github-copilot\": consultorGithubCopilot,\n\tgoogle: consultorGoogleGemini,\n};\n\n/** Proveedores para los que hay un consultor de cuota, en el orden en que se enseñan. */\nexport const PROVEEDORES_CON_CUOTA: readonly string[] = Object.keys(CONSULTORES);\n\n/**\n * Los últimos caracteres del secreto bastan para distinguir dos credenciales\n * del mismo proveedor sin quedarse el secreto entero más tiempo del\n * necesario dentro de la clave de caché.\n */\nfunction claveCache(proveedor: string, credencial: Credential): string {\n\tconst identidad = credencial.type === \"oauth\" ? credencial.access : (credencial.key ?? \"\");\n\treturn `${proveedor}:${identidad.slice(-12)}`;\n}\n\n/**\n * Cuánto queda del plan para un proveedor, con la credencial dada.\n *\n * `null` = no hay credencial, el proveedor no la reconoce, o el proveedor no\n * publica cuota para ese tipo de credencial (p.ej. la API key de Anthropic).\n * Lanza {@link ErrorConsultaCuota} si la consulta llega a intentarse y falla:\n * eso NUNCA se reporta como `null`, o un fallo de red se leería como \"sin\n * límite\".\n */\nexport async function consultarCuota(\n\tproveedor: string,\n\tcredencial: Credential | undefined,\n\topciones: Omit<ContextoConsulta, \"credencial\"> = {},\n): Promise<VentanaCuota[] | null> {\n\tconst consultor = CONSULTORES[proveedor];\n\tif (!consultor || !credencial || !consultor.soporta(credencial)) return null;\n\treturn conCache(claveCache(proveedor, credencial), () => consultor.consultar({ ...opciones, credencial }));\n}\n"]}

package/dist/core/usage/cuota/openai-codex.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cuota de OpenAI Codex (ChatGPT) — endpoint interno de cuenta, no la API de
+ * pago por token. Vive en `chatgpt.com`, no en `api.openai.com`: no hay
+ * override de `baseUrl` que valga aquí, un proxy de streaming lo devolvería
+ * en 404.
+ */
+import { type ConsultorCuota } from "./tipos.ts";
+export declare const consultorOpenAiCodex: ConsultorCuota;
+//# sourceMappingURL=openai-codex.d.ts.map

package/dist/core/usage/cuota/openai-codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-codex.d.ts","sourceRoot":"","sources":["../../../../src/core/usage/cuota/openai-codex.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAyC,MAAM,YAAY,CAAC;AA4BxF,eAAO,MAAM,oBAAoB,EAAE,cA4ClC,CAAC","sourcesContent":["/**\n * Cuota de OpenAI Codex (ChatGPT) — endpoint interno de cuenta, no la API de\n * pago por token. Vive en `chatgpt.com`, no en `api.openai.com`: no hay\n * override de `baseUrl` que valga aquí, un proxy de streaming lo devolvería\n * en 404.\n */\n\nimport { type ConsultorCuota, ErrorConsultaCuota, type VentanaCuota } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://chatgpt.com/backend-api/wham/usage\";\n\ninterface VentanaBruta {\n\tused_percent?: number;\n\treset_at?: number;\n}\n\ninterface RespuestaCodex {\n\trate_limit?: {\n\t\tprimary_window?: VentanaBruta | null;\n\t\tsecondary_window?: VentanaBruta | null;\n\t} | null;\n}\n\nfunction aVentana(etiqueta: string, cubo: VentanaBruta | null | undefined): VentanaCuota | undefined {\n\tif (!cubo || typeof cubo.used_percent !== \"number\") return undefined;\n\tconst seReinicia = typeof cubo.reset_at === \"number\" && cubo.reset_at > 0 ? cubo.reset_at * 1000 : null;\n\treturn {\n\t\tetiqueta,\n\t\tusado: Math.min(Math.max(cubo.used_percent, 0), 100),\n\t\tlimite: 100,\n\t\tseReinicia,\n\t\tunidad: \"porcentaje\",\n\t};\n}\n\nexport const consultorOpenAiCodex: ConsultorCuota = {\n\tid: \"openai-codex\",\n\tsoporta: (credencial) => credencial.type === \"oauth\",\n\tasync consultar({ credencial, fetch: fetchImpl = fetch, señal }) {\n\t\tif (credencial.type !== \"oauth\") return null;\n\n\t\tconst headers: Record<string, string> = { authorization: `Bearer ${credencial.access}` };\n\t\tconst accountId = credencial.accountId;\n\t\tif (typeof accountId === \"string\" && accountId) headers[\"chatgpt-account-id\"] = accountId;\n\n\t\tlet respuesta: Response;\n\t\ttry {\n\t\t\trespuesta = await fetchImpl(ENDPOINT, { headers, signal: señal });\n\t\t} catch (error) {\n\t\t\tthrow new ErrorConsultaCuota(\"openai-codex\", `no se pudo contactar con OpenAI Codex: ${String(error)}`, {\n\t\t\t\tcause: error,\n\t\t\t});\n\t\t}\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new ErrorConsultaCuota(\n\t\t\t\t\"openai-codex\",\n\t\t\t\t`OpenAI Codex respondió ${respuesta.status} ${respuesta.statusText}`,\n\t\t\t);\n\t\t}\n\n\t\tlet datos: RespuestaCodex;\n\t\ttry {\n\t\t\tdatos = (await respuesta.json()) as RespuestaCodex;\n\t\t} catch (error) {\n\t\t\tthrow new ErrorConsultaCuota(\n\t\t\t\t\"openai-codex\",\n\t\t\t\t`la respuesta de OpenAI Codex no es JSON válido: ${String(error)}`,\n\t\t\t\t{\n\t\t\t\t\tcause: error,\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\n\t\tconst ventanas = [\n\t\t\taVentana(\"Ventana principal\", datos.rate_limit?.primary_window),\n\t\t\taVentana(\"Ventana secundaria\", datos.rate_limit?.secondary_window),\n\t\t].filter((v): v is VentanaCuota => v !== undefined);\n\t\treturn ventanas.length > 0 ? ventanas : null;\n\t},\n};\n"]}

package/dist/core/usage/cuota/openai-codex.js

@@ -0,0 +1,59 @@
+/**
+ * Cuota de OpenAI Codex (ChatGPT) — endpoint interno de cuenta, no la API de
+ * pago por token. Vive en `chatgpt.com`, no en `api.openai.com`: no hay
+ * override de `baseUrl` que valga aquí, un proxy de streaming lo devolvería
+ * en 404.
+ */
+import { ErrorConsultaCuota } from "./tipos.js";
+const ENDPOINT = "https://chatgpt.com/backend-api/wham/usage";
+function aVentana(etiqueta, cubo) {
+    if (!cubo || typeof cubo.used_percent !== "number")
+        return undefined;
+    const seReinicia = typeof cubo.reset_at === "number" && cubo.reset_at > 0 ? cubo.reset_at * 1000 : null;
+    return {
+        etiqueta,
+        usado: Math.min(Math.max(cubo.used_percent, 0), 100),
+        limite: 100,
+        seReinicia,
+        unidad: "porcentaje",
+    };
+}
+export const consultorOpenAiCodex = {
+    id: "openai-codex",
+    soporta: (credencial) => credencial.type === "oauth",
+    async consultar({ credencial, fetch: fetchImpl = fetch, señal }) {
+        if (credencial.type !== "oauth")
+            return null;
+        const headers = { authorization: `Bearer ${credencial.access}` };
+        const accountId = credencial.accountId;
+        if (typeof accountId === "string" && accountId)
+            headers["chatgpt-account-id"] = accountId;
+        let respuesta;
+        try {
+            respuesta = await fetchImpl(ENDPOINT, { headers, signal: señal });
+        }
+        catch (error) {
+            throw new ErrorConsultaCuota("openai-codex", `no se pudo contactar con OpenAI Codex: ${String(error)}`, {
+                cause: error,
+            });
+        }
+        if (!respuesta.ok) {
+            throw new ErrorConsultaCuota("openai-codex", `OpenAI Codex respondió ${respuesta.status} ${respuesta.statusText}`);
+        }
+        let datos;
+        try {
+            datos = (await respuesta.json());
+        }
+        catch (error) {
+            throw new ErrorConsultaCuota("openai-codex", `la respuesta de OpenAI Codex no es JSON válido: ${String(error)}`, {
+                cause: error,
+            });
+        }
+        const ventanas = [
+            aVentana("Ventana principal", datos.rate_limit?.primary_window),
+            aVentana("Ventana secundaria", datos.rate_limit?.secondary_window),
+        ].filter((v) => v !== undefined);
+        return ventanas.length > 0 ? ventanas : null;
+    },
+};
+//# sourceMappingURL=openai-codex.js.map

package/dist/core/usage/cuota/openai-codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-codex.js","sourceRoot":"","sources":["../../../../src/core/usage/cuota/openai-codex.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAuB,kBAAkB,EAAqB,MAAM,YAAY,CAAC;AAExF,MAAM,QAAQ,GAAG,4CAA4C,CAAC;AAc9D,SAAS,QAAQ,CAAC,QAAgB,EAAE,IAAqC,EAA4B;IACpG,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACrE,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACxG,OAAO;QACN,QAAQ;QACR,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC;QACpD,MAAM,EAAE,GAAG;QACX,UAAU;QACV,MAAM,EAAE,YAAY;KACpB,CAAC;AAAA,CACF;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IACnD,EAAE,EAAE,cAAc;IAClB,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,OAAO;IACpD,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,MAAK,EAAE,EAAE;QAChE,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QAE7C,MAAM,OAAO,GAA2B,EAAE,aAAa,EAAE,UAAU,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QACzF,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACvC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS;YAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,SAAS,CAAC;QAE1F,IAAI,SAAmB,CAAC;QACxB,IAAI,CAAC;YACJ,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAK,EAAE,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,0CAA0C,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;gBACvG,KAAK,EAAE,KAAK;aACZ,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,kBAAkB,CAC3B,cAAc,EACd,2BAA0B,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,UAAU,EAAE,CACpE,CAAC;QACH,CAAC;QAED,IAAI,KAAqB,CAAC;QAC1B,IAAI,CAAC;YACJ,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAmB,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,kBAAkB,CAC3B,cAAc,EACd,oDAAmD,MAAM,CAAC,KAAK,CAAC,EAAE,EAClE;gBACC,KAAK,EAAE,KAAK;aACZ,CACD,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG;YAChB,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC;YAC/D,QAAQ,CAAC,oBAAoB,EAAE,KAAK,CAAC,UAAU,EAAE,gBAAgB,CAAC;SAClE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QACpD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAAA,CAC7C;CACD,CAAC","sourcesContent":["/**\n * Cuota de OpenAI Codex (ChatGPT) — endpoint interno de cuenta, no la API de\n * pago por token. Vive en `chatgpt.com`, no en `api.openai.com`: no hay\n * override de `baseUrl` que valga aquí, un proxy de streaming lo devolvería\n * en 404.\n */\n\nimport { type ConsultorCuota, ErrorConsultaCuota, type VentanaCuota } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://chatgpt.com/backend-api/wham/usage\";\n\ninterface VentanaBruta {\n\tused_percent?: number;\n\treset_at?: number;\n}\n\ninterface RespuestaCodex {\n\trate_limit?: {\n\t\tprimary_window?: VentanaBruta | null;\n\t\tsecondary_window?: VentanaBruta | null;\n\t} | null;\n}\n\nfunction aVentana(etiqueta: string, cubo: VentanaBruta | null | undefined): VentanaCuota | undefined {\n\tif (!cubo || typeof cubo.used_percent !== \"number\") return undefined;\n\tconst seReinicia = typeof cubo.reset_at === \"number\" && cubo.reset_at > 0 ? cubo.reset_at * 1000 : null;\n\treturn {\n\t\tetiqueta,\n\t\tusado: Math.min(Math.max(cubo.used_percent, 0), 100),\n\t\tlimite: 100,\n\t\tseReinicia,\n\t\tunidad: \"porcentaje\",\n\t};\n}\n\nexport const consultorOpenAiCodex: ConsultorCuota = {\n\tid: \"openai-codex\",\n\tsoporta: (credencial) => credencial.type === \"oauth\",\n\tasync consultar({ credencial, fetch: fetchImpl = fetch, señal }) {\n\t\tif (credencial.type !== \"oauth\") return null;\n\n\t\tconst headers: Record<string, string> = { authorization: `Bearer ${credencial.access}` };\n\t\tconst accountId = credencial.accountId;\n\t\tif (typeof accountId === \"string\" && accountId) headers[\"chatgpt-account-id\"] = accountId;\n\n\t\tlet respuesta: Response;\n\t\ttry {\n\t\t\trespuesta = await fetchImpl(ENDPOINT, { headers, signal: señal });\n\t\t} catch (error) {\n\t\t\tthrow new ErrorConsultaCuota(\"openai-codex\", `no se pudo contactar con OpenAI Codex: ${String(error)}`, {\n\t\t\t\tcause: error,\n\t\t\t});\n\t\t}\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new ErrorConsultaCuota(\n\t\t\t\t\"openai-codex\",\n\t\t\t\t`OpenAI Codex respondió ${respuesta.status} ${respuesta.statusText}`,\n\t\t\t);\n\t\t}\n\n\t\tlet datos: RespuestaCodex;\n\t\ttry {\n\t\t\tdatos = (await respuesta.json()) as RespuestaCodex;\n\t\t} catch (error) {\n\t\t\tthrow new ErrorConsultaCuota(\n\t\t\t\t\"openai-codex\",\n\t\t\t\t`la respuesta de OpenAI Codex no es JSON válido: ${String(error)}`,\n\t\t\t\t{\n\t\t\t\t\tcause: error,\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\n\t\tconst ventanas = [\n\t\t\taVentana(\"Ventana principal\", datos.rate_limit?.primary_window),\n\t\t\taVentana(\"Ventana secundaria\", datos.rate_limit?.secondary_window),\n\t\t].filter((v): v is VentanaCuota => v !== undefined);\n\t\treturn ventanas.length > 0 ? ventanas : null;\n\t},\n};\n"]}

package/dist/core/usage/cuota/openrouter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cuota de OpenRouter — saldo de créditos, no una ventana de tiempo.
+ *
+ * `GET /credits` devuelve el total comprado y el total gastado. Una cuenta de
+ * pago-por-uso que nunca compró crédito no tiene techo: eso también es "no
+ * publica cuota", no "cero disponible".
+ */
+import { type ConsultorCuota } from "./tipos.ts";
+export declare const consultorOpenRouter: ConsultorCuota;
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/core/usage/cuota/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../../../src/core/usage/cuota/openrouter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAsB,MAAM,YAAY,CAAC;AAQrE,eAAO,MAAM,mBAAmB,EAAE,cAmCjC,CAAC","sourcesContent":["/**\n * Cuota de OpenRouter — saldo de créditos, no una ventana de tiempo.\n *\n * `GET /credits` devuelve el total comprado y el total gastado. Una cuenta de\n * pago-por-uso que nunca compró crédito no tiene techo: eso también es \"no\n * publica cuota\", no \"cero disponible\".\n */\n\nimport { type ConsultorCuota, ErrorConsultaCuota } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://openrouter.ai/api/v1/credits\";\n\ninterface RespuestaOpenRouter {\n\tdata?: { total_credits?: number; total_usage?: number };\n}\n\nexport const consultorOpenRouter: ConsultorCuota = {\n\tid: \"openrouter\",\n\tsoporta: (credencial) => credencial.type === \"api_key\" && Boolean(credencial.key),\n\tasync consultar({ credencial, fetch: fetchImpl = fetch, señal }) {\n\t\tif (credencial.type !== \"api_key\" || !credencial.key) return null;\n\n\t\tlet respuesta: Response;\n\t\ttry {\n\t\t\trespuesta = await fetchImpl(ENDPOINT, {\n\t\t\t\theaders: { authorization: `Bearer ${credencial.key}` },\n\t\t\t\tsignal: señal,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tthrow new ErrorConsultaCuota(\"openrouter\", `no se pudo contactar con OpenRouter: ${String(error)}`, {\n\t\t\t\tcause: error,\n\t\t\t});\n\t\t}\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new ErrorConsultaCuota(\"openrouter\", `OpenRouter respondió ${respuesta.status} ${respuesta.statusText}`);\n\t\t}\n\n\t\tlet datos: RespuestaOpenRouter;\n\t\ttry {\n\t\t\tdatos = (await respuesta.json()) as RespuestaOpenRouter;\n\t\t} catch (error) {\n\t\t\tthrow new ErrorConsultaCuota(\"openrouter\", `la respuesta de OpenRouter no es JSON válido: ${String(error)}`, {\n\t\t\t\tcause: error,\n\t\t\t});\n\t\t}\n\n\t\tconst limite = datos.data?.total_credits;\n\t\tconst usado = datos.data?.total_usage;\n\t\tif (typeof limite !== \"number\" || limite <= 0 || typeof usado !== \"number\") return null;\n\t\treturn [{ etiqueta: \"Saldo\", usado, limite, seReinicia: null, unidad: \"usd\" }];\n\t},\n};\n"]}

package/dist/core/usage/cuota/openrouter.js

@@ -0,0 +1,47 @@
+/**
+ * Cuota de OpenRouter — saldo de créditos, no una ventana de tiempo.
+ *
+ * `GET /credits` devuelve el total comprado y el total gastado. Una cuenta de
+ * pago-por-uso que nunca compró crédito no tiene techo: eso también es "no
+ * publica cuota", no "cero disponible".
+ */
+import { ErrorConsultaCuota } from "./tipos.js";
+const ENDPOINT = "https://openrouter.ai/api/v1/credits";
+export const consultorOpenRouter = {
+    id: "openrouter",
+    soporta: (credencial) => credencial.type === "api_key" && Boolean(credencial.key),
+    async consultar({ credencial, fetch: fetchImpl = fetch, señal }) {
+        if (credencial.type !== "api_key" || !credencial.key)
+            return null;
+        let respuesta;
+        try {
+            respuesta = await fetchImpl(ENDPOINT, {
+                headers: { authorization: `Bearer ${credencial.key}` },
+                signal: señal,
+            });
+        }
+        catch (error) {
+            throw new ErrorConsultaCuota("openrouter", `no se pudo contactar con OpenRouter: ${String(error)}`, {
+                cause: error,
+            });
+        }
+        if (!respuesta.ok) {
+            throw new ErrorConsultaCuota("openrouter", `OpenRouter respondió ${respuesta.status} ${respuesta.statusText}`);
+        }
+        let datos;
+        try {
+            datos = (await respuesta.json());
+        }
+        catch (error) {
+            throw new ErrorConsultaCuota("openrouter", `la respuesta de OpenRouter no es JSON válido: ${String(error)}`, {
+                cause: error,
+            });
+        }
+        const limite = datos.data?.total_credits;
+        const usado = datos.data?.total_usage;
+        if (typeof limite !== "number" || limite <= 0 || typeof usado !== "number")
+            return null;
+        return [{ etiqueta: "Saldo", usado, limite, seReinicia: null, unidad: "usd" }];
+    },
+};
+//# sourceMappingURL=openrouter.js.map

package/dist/core/usage/cuota/openrouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.js","sourceRoot":"","sources":["../../../../src/core/usage/cuota/openrouter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAuB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,QAAQ,GAAG,sCAAsC,CAAC;AAMxD,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IAClD,EAAE,EAAE,YAAY;IAChB,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;IACjF,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,MAAK,EAAE,EAAE;QAChE,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAElE,IAAI,SAAmB,CAAC;QACxB,IAAI,CAAC;YACJ,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;gBACrC,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,CAAC,GAAG,EAAE,EAAE;gBACtD,MAAM,EAAE,MAAK;aACb,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,kBAAkB,CAAC,YAAY,EAAE,wCAAwC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;gBACnG,KAAK,EAAE,KAAK;aACZ,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,kBAAkB,CAAC,YAAY,EAAE,yBAAwB,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;QAChH,CAAC;QAED,IAAI,KAA0B,CAAC;QAC/B,IAAI,CAAC;YACJ,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAwB,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,kBAAkB,CAAC,YAAY,EAAE,kDAAiD,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;gBAC5G,KAAK,EAAE,KAAK;aACZ,CAAC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC;QACtC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACxF,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAAA,CAC/E;CACD,CAAC","sourcesContent":["/**\n * Cuota de OpenRouter — saldo de créditos, no una ventana de tiempo.\n *\n * `GET /credits` devuelve el total comprado y el total gastado. Una cuenta de\n * pago-por-uso que nunca compró crédito no tiene techo: eso también es \"no\n * publica cuota\", no \"cero disponible\".\n */\n\nimport { type ConsultorCuota, ErrorConsultaCuota } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://openrouter.ai/api/v1/credits\";\n\ninterface RespuestaOpenRouter {\n\tdata?: { total_credits?: number; total_usage?: number };\n}\n\nexport const consultorOpenRouter: ConsultorCuota = {\n\tid: \"openrouter\",\n\tsoporta: (credencial) => credencial.type === \"api_key\" && Boolean(credencial.key),\n\tasync consultar({ credencial, fetch: fetchImpl = fetch, señal }) {\n\t\tif (credencial.type !== \"api_key\" || !credencial.key) return null;\n\n\t\tlet respuesta: Response;\n\t\ttry {\n\t\t\trespuesta = await fetchImpl(ENDPOINT, {\n\t\t\t\theaders: { authorization: `Bearer ${credencial.key}` },\n\t\t\t\tsignal: señal,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tthrow new ErrorConsultaCuota(\"openrouter\", `no se pudo contactar con OpenRouter: ${String(error)}`, {\n\t\t\t\tcause: error,\n\t\t\t});\n\t\t}\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new ErrorConsultaCuota(\"openrouter\", `OpenRouter respondió ${respuesta.status} ${respuesta.statusText}`);\n\t\t}\n\n\t\tlet datos: RespuestaOpenRouter;\n\t\ttry {\n\t\t\tdatos = (await respuesta.json()) as RespuestaOpenRouter;\n\t\t} catch (error) {\n\t\t\tthrow new ErrorConsultaCuota(\"openrouter\", `la respuesta de OpenRouter no es JSON válido: ${String(error)}`, {\n\t\t\t\tcause: error,\n\t\t\t});\n\t\t}\n\n\t\tconst limite = datos.data?.total_credits;\n\t\tconst usado = datos.data?.total_usage;\n\t\tif (typeof limite !== \"number\" || limite <= 0 || typeof usado !== \"number\") return null;\n\t\treturn [{ etiqueta: \"Saldo\", usado, limite, seReinicia: null, unidad: \"usd\" }];\n\t},\n};\n"]}

package/dist/core/usage/cuota/tipos.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Cuánto QUEDA del plan, por proveedor — no cuánto se ha gastado.
+ *
+ * `ada-cli usage` (ver `../aggregate.ts`) lee los JSONL de sesión y suma lo
+ * que ya se consumió. Eso no dice si a un equipo le quedan dos peticiones o
+ * dos mil: ese dato no vive en la sesión, vive en el proveedor, así que hay
+ * que preguntárselo a él.
+ */
+import type { Credential } from "@earendil-works/pi-ai";
+export type UnidadCuota = "porcentaje" | "peticiones" | "usd";
+/** Una ventana de cuota ya lista para mostrar (p.ej. "5 horas" o "Semanal"). */
+export interface VentanaCuota {
+    etiqueta: string;
+    usado: number;
+    limite: number;
+    /** Epoch ms en que se reinicia esta ventana; `null` si el proveedor no lo dice. */
+    seReinicia: number | null;
+    unidad: UnidadCuota;
+}
+/**
+ * La consulta a la cuota falló de verdad (red, HTTP, JSON roto).
+ *
+ * A propósito NO es lo mismo que "el proveedor no publica cuota"
+ * (`consultar` devuelve `null` para eso): confundir ambos casos hace que un
+ * fallo de red se enseñe como "sin límite", que es la mentira que esta pieza
+ * existe para evitar.
+ */
+export declare class ErrorConsultaCuota extends Error {
+    readonly proveedor: string;
+    constructor(proveedor: string, mensaje: string, options?: ErrorOptions);
+}
+/** Lo mínimo para preguntarle a un proveedor: con qué credencial y por qué canal. */
+export interface ContextoConsulta {
+    credencial: Credential;
+    fetch?: typeof fetch;
+    señal?: AbortSignal;
+}
+/** Un proveedor: cómo se llama y cómo se le pregunta cuánto queda. */
+export interface ConsultorCuota {
+    id: string;
+    /** true si esta credencial es del tipo que este proveedor sabe consultar. */
+    soporta(credencial: Credential): boolean;
+    /**
+     * `null` = el proveedor no publica cuota para esta credencial (p.ej. la
+     * API key de pago-por-token de Anthropic no tiene techo que consultar).
+     * Lanza {@link ErrorConsultaCuota} si la consulta falla de verdad.
+     */
+    consultar(ctx: ContextoConsulta): Promise<VentanaCuota[] | null>;
+}
+//# sourceMappingURL=tipos.d.ts.map

package/dist/core/usage/cuota/tipos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.d.ts","sourceRoot":"","sources":["../../../../src/core/usage/cuota/tipos.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,KAAK,CAAC;AAE9D,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAIrE;CACD;AAED,wFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAK,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,yEAAsE;AACtE,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;IACzC;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;CACjE","sourcesContent":["/**\n * Cuánto QUEDA del plan, por proveedor — no cuánto se ha gastado.\n *\n * `ada-cli usage` (ver `../aggregate.ts`) lee los JSONL de sesión y suma lo\n * que ya se consumió. Eso no dice si a un equipo le quedan dos peticiones o\n * dos mil: ese dato no vive en la sesión, vive en el proveedor, así que hay\n * que preguntárselo a él.\n */\n\nimport type { Credential } from \"@earendil-works/pi-ai\";\n\nexport type UnidadCuota = \"porcentaje\" | \"peticiones\" | \"usd\";\n\n/** Una ventana de cuota ya lista para mostrar (p.ej. \"5 horas\" o \"Semanal\"). */\nexport interface VentanaCuota {\n\tetiqueta: string;\n\tusado: number;\n\tlimite: number;\n\t/** Epoch ms en que se reinicia esta ventana; `null` si el proveedor no lo dice. */\n\tseReinicia: number | null;\n\tunidad: UnidadCuota;\n}\n\n/**\n * La consulta a la cuota falló de verdad (red, HTTP, JSON roto).\n *\n * A propósito NO es lo mismo que \"el proveedor no publica cuota\"\n * (`consultar` devuelve `null` para eso): confundir ambos casos hace que un\n * fallo de red se enseñe como \"sin límite\", que es la mentira que esta pieza\n * existe para evitar.\n */\nexport class ErrorConsultaCuota extends Error {\n\treadonly proveedor: string;\n\n\tconstructor(proveedor: string, mensaje: string, options?: ErrorOptions) {\n\t\tsuper(mensaje, options);\n\t\tthis.name = \"ErrorConsultaCuota\";\n\t\tthis.proveedor = proveedor;\n\t}\n}\n\n/** Lo mínimo para preguntarle a un proveedor: con qué credencial y por qué canal. */\nexport interface ContextoConsulta {\n\tcredencial: Credential;\n\tfetch?: typeof fetch;\n\tseñal?: AbortSignal;\n}\n\n/** Un proveedor: cómo se llama y cómo se le pregunta cuánto queda. */\nexport interface ConsultorCuota {\n\tid: string;\n\t/** true si esta credencial es del tipo que este proveedor sabe consultar. */\n\tsoporta(credencial: Credential): boolean;\n\t/**\n\t * `null` = el proveedor no publica cuota para esta credencial (p.ej. la\n\t * API key de pago-por-token de Anthropic no tiene techo que consultar).\n\t * Lanza {@link ErrorConsultaCuota} si la consulta falla de verdad.\n\t */\n\tconsultar(ctx: ContextoConsulta): Promise<VentanaCuota[] | null>;\n}\n"]}

package/dist/core/usage/cuota/tipos.js

@@ -0,0 +1,25 @@
+/**
+ * Cuánto QUEDA del plan, por proveedor — no cuánto se ha gastado.
+ *
+ * `ada-cli usage` (ver `../aggregate.ts`) lee los JSONL de sesión y suma lo
+ * que ya se consumió. Eso no dice si a un equipo le quedan dos peticiones o
+ * dos mil: ese dato no vive en la sesión, vive en el proveedor, así que hay
+ * que preguntárselo a él.
+ */
+/**
+ * La consulta a la cuota falló de verdad (red, HTTP, JSON roto).
+ *
+ * A propósito NO es lo mismo que "el proveedor no publica cuota"
+ * (`consultar` devuelve `null` para eso): confundir ambos casos hace que un
+ * fallo de red se enseñe como "sin límite", que es la mentira que esta pieza
+ * existe para evitar.
+ */
+export class ErrorConsultaCuota extends Error {
+    proveedor;
+    constructor(proveedor, mensaje, options) {
+        super(mensaje, options);
+        this.name = "ErrorConsultaCuota";
+        this.proveedor = proveedor;
+    }
+}
+//# sourceMappingURL=tipos.js.map

package/dist/core/usage/cuota/tipos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.js","sourceRoot":"","sources":["../../../../src/core/usage/cuota/tipos.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACnC,SAAS,CAAS;IAE3B,YAAY,SAAiB,EAAE,OAAe,EAAE,OAAsB,EAAE;QACvE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAAA,CAC3B;CACD","sourcesContent":["/**\n * Cuánto QUEDA del plan, por proveedor — no cuánto se ha gastado.\n *\n * `ada-cli usage` (ver `../aggregate.ts`) lee los JSONL de sesión y suma lo\n * que ya se consumió. Eso no dice si a un equipo le quedan dos peticiones o\n * dos mil: ese dato no vive en la sesión, vive en el proveedor, así que hay\n * que preguntárselo a él.\n */\n\nimport type { Credential } from \"@earendil-works/pi-ai\";\n\nexport type UnidadCuota = \"porcentaje\" | \"peticiones\" | \"usd\";\n\n/** Una ventana de cuota ya lista para mostrar (p.ej. \"5 horas\" o \"Semanal\"). */\nexport interface VentanaCuota {\n\tetiqueta: string;\n\tusado: number;\n\tlimite: number;\n\t/** Epoch ms en que se reinicia esta ventana; `null` si el proveedor no lo dice. */\n\tseReinicia: number | null;\n\tunidad: UnidadCuota;\n}\n\n/**\n * La consulta a la cuota falló de verdad (red, HTTP, JSON roto).\n *\n * A propósito NO es lo mismo que \"el proveedor no publica cuota\"\n * (`consultar` devuelve `null` para eso): confundir ambos casos hace que un\n * fallo de red se enseñe como \"sin límite\", que es la mentira que esta pieza\n * existe para evitar.\n */\nexport class ErrorConsultaCuota extends Error {\n\treadonly proveedor: string;\n\n\tconstructor(proveedor: string, mensaje: string, options?: ErrorOptions) {\n\t\tsuper(mensaje, options);\n\t\tthis.name = \"ErrorConsultaCuota\";\n\t\tthis.proveedor = proveedor;\n\t}\n}\n\n/** Lo mínimo para preguntarle a un proveedor: con qué credencial y por qué canal. */\nexport interface ContextoConsulta {\n\tcredencial: Credential;\n\tfetch?: typeof fetch;\n\tseñal?: AbortSignal;\n}\n\n/** Un proveedor: cómo se llama y cómo se le pregunta cuánto queda. */\nexport interface ConsultorCuota {\n\tid: string;\n\t/** true si esta credencial es del tipo que este proveedor sabe consultar. */\n\tsoporta(credencial: Credential): boolean;\n\t/**\n\t * `null` = el proveedor no publica cuota para esta credencial (p.ej. la\n\t * API key de pago-por-token de Anthropic no tiene techo que consultar).\n\t * Lanza {@link ErrorConsultaCuota} si la consulta falla de verdad.\n\t */\n\tconsultar(ctx: ContextoConsulta): Promise<VentanaCuota[] | null>;\n}\n"]}

package/dist/core/web/busqueda-nativa.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Búsqueda web con la credencial que el usuario YA tiene.
+ *
+ * Hasta ahora `web_search` exigía una clave de Serper aparte, así que la
+ * respuesta de fábrica era «Búsqueda web no configurada». Un agente de código
+ * que no puede mirar la documentación de una librería está cojo, y pedir una
+ * segunda cuenta para eso es una fricción que el usuario paga antes de haber
+ * visto ningún valor.
+ *
+ * Los modelos de Anthropic traen búsqueda de servidor (`web_search_20250305`).
+ * Si hay credencial de Anthropic —y la hay, porque es con lo que corre el
+ * agente— buscar puede funcionar sin configurar nada.
+ *
+ * Dos detalles que no son evidentes y que se descubrieron probándolo:
+ *
+ * 1. **Los resultados no llegan por el contenido del mensaje.** Nuestra capa de
+ *    modelos normaliza la respuesta a texto/razonamiento/llamadas, y los
+ *    bloques `web_search_tool_result` se pierden por el camino. Pedirle al
+ *    modelo que los liste en el texto tampoco vale: se probó, y contesta la
+ *    pregunta en vez de listar fuentes. Hay que leer el flujo crudo.
+ *
+ * 2. **Se lee sin tocar la capa de modelos**, pasando un `fetch` propio que
+ *    duplica el cuerpo con `tee()`: una rama sigue al SDK intacta y la otra se
+ *    analiza aquí. `agent-session.ts` y `packages/ai` son de upstream y el
+ *    presupuesto de fork está en el tope; esto no cuesta ni un hunk.
+ */
+/** Un resultado, ya normalizado. */
+export interface ResultadoWeb {
+    titulo: string;
+    url: string;
+    /** Antigüedad tal y como la da el proveedor ("3 weeks ago", "June 8, 2026"). */
+    edad?: string;
+}
+/** Proveedores cuyo modelo sabe buscar por su cuenta. */
+export declare function soportaBusquedaNativa(proveedor: string): boolean;
+/**
+ * Añade la tool de búsqueda a la carga de la petición, sin pisar las que haya.
+ *
+ * Pura y separada para poder probarla: si esto machacara `tools`, el modelo se
+ * quedaría sin sus herramientas y el fallo aparecería en cualquier otro sitio.
+ */
+export declare function conToolDeBusqueda(carga: unknown, maxUsos?: number): unknown;
+/**
+ * Recorre cualquier estructura y recoge los resultados de búsqueda.
+ *
+ * Se busca por el campo `type` en vez de por la ruta exacta del evento a
+ * propósito: el formato de los eventos SSE puede cambiar de sitio los bloques,
+ * y un recolector que dependa de la ruta se rompe en silencio —devolviendo cero
+ * resultados, que se lee igual que «no hay nada»—.
+ */
+export declare function recolectarResultados(valor: unknown, acumulado?: ResultadoWeb[]): ResultadoWeb[];
+/** Quita repetidos por URL, conservando el orden de aparición. */
+export declare function sinRepetidos(resultados: ResultadoWeb[]): ResultadoWeb[];
+/**
+ * Envuelve un `fetch` para leer los resultados sin estorbar a quien lo usa.
+ *
+ * `tee()` da dos flujos: uno se devuelve intacto —el SDK tiene que recibir
+ * exactamente lo que habría recibido— y el otro se analiza aquí. Si el análisis
+ * falla, falla solo: una búsqueda sin fuentes es peor que una con fuentes, pero
+ * una sesión rota por el analizador es mucho peor que las dos.
+ */
+export declare function fetchQueRecolecta(base: typeof fetch, destino: ResultadoWeb[]): typeof fetch;
+/** Lo que hace falta para buscar, inyectado para poder probarlo sin red. */
+export interface DependenciasBusqueda {
+    /** Ejecuta una consulta contra el modelo con las opciones dadas. */
+    completar: (consulta: string, opciones: {
+        fetch: typeof fetch;
+        onPayload: (c: unknown) => unknown;
+    }) => Promise<void>;
+    fetchBase?: typeof fetch;
+    maxResultados?: number;
+}
+/**
+ * Busca y devuelve las fuentes.
+ *
+ * No devuelve la síntesis del modelo a propósito: quien llama es el agente, que
+ * ya sabe leer. Lo que necesita de una búsqueda son URLs a las que ir con
+ * `web_fetch`, no un resumen de segunda mano que ya viene con la
+ * interpretación de otro modelo encima.
+ */
+export declare function buscarConElModelo(consulta: string, deps: DependenciasBusqueda): Promise<ResultadoWeb[]>;
+//# sourceMappingURL=busqueda-nativa.d.ts.map

package/dist/core/web/busqueda-nativa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"busqueda-nativa.d.ts","sourceRoot":"","sources":["../../../src/core/web/busqueda-nativa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAKD,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAI,GAAG,OAAO,CAKtE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,GAAE,YAAY,EAAO,GAAG,YAAY,EAAE,CAgBnG;AAED,mEAAkE;AAClE,wBAAgB,YAAY,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CASvE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,KAAK,CAgD3F;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACpC,oEAAoE;IACpE,SAAS,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;QAAE,KAAK,EAAE,OAAO,KAAK,CAAC;QAAC,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAA;KAAE,KACjE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAO7G","sourcesContent":["/**\n * Búsqueda web con la credencial que el usuario YA tiene.\n *\n * Hasta ahora `web_search` exigía una clave de Serper aparte, así que la\n * respuesta de fábrica era «Búsqueda web no configurada». Un agente de código\n * que no puede mirar la documentación de una librería está cojo, y pedir una\n * segunda cuenta para eso es una fricción que el usuario paga antes de haber\n * visto ningún valor.\n *\n * Los modelos de Anthropic traen búsqueda de servidor (`web_search_20250305`).\n * Si hay credencial de Anthropic —y la hay, porque es con lo que corre el\n * agente— buscar puede funcionar sin configurar nada.\n *\n * Dos detalles que no son evidentes y que se descubrieron probándolo:\n *\n * 1. **Los resultados no llegan por el contenido del mensaje.** Nuestra capa de\n *    modelos normaliza la respuesta a texto/razonamiento/llamadas, y los\n *    bloques `web_search_tool_result` se pierden por el camino. Pedirle al\n *    modelo que los liste en el texto tampoco vale: se probó, y contesta la\n *    pregunta en vez de listar fuentes. Hay que leer el flujo crudo.\n *\n * 2. **Se lee sin tocar la capa de modelos**, pasando un `fetch` propio que\n *    duplica el cuerpo con `tee()`: una rama sigue al SDK intacta y la otra se\n *    analiza aquí. `agent-session.ts` y `packages/ai` son de upstream y el\n *    presupuesto de fork está en el tope; esto no cuesta ni un hunk.\n */\n\n/** Un resultado, ya normalizado. */\nexport interface ResultadoWeb {\n\ttitulo: string;\n\turl: string;\n\t/** Antigüedad tal y como la da el proveedor (\"3 weeks ago\", \"June 8, 2026\"). */\n\tedad?: string;\n}\n\n/** La tool de servidor de Anthropic. */\nconst TOOL_BUSQUEDA = \"web_search_20250305\";\n\n/** Proveedores cuyo modelo sabe buscar por su cuenta. */\nexport function soportaBusquedaNativa(proveedor: string): boolean {\n\treturn proveedor === \"anthropic\";\n}\n\n/**\n * Añade la tool de búsqueda a la carga de la petición, sin pisar las que haya.\n *\n * Pura y separada para poder probarla: si esto machacara `tools`, el modelo se\n * quedaría sin sus herramientas y el fallo aparecería en cualquier otro sitio.\n */\nexport function conToolDeBusqueda(carga: unknown, maxUsos = 5): unknown {\n\tif (!carga || typeof carga !== \"object\") return carga;\n\tconst p = carga as { tools?: unknown[] };\n\tp.tools = [...(p.tools ?? []), { type: TOOL_BUSQUEDA, name: \"web_search\", max_uses: maxUsos }];\n\treturn p;\n}\n\n/**\n * Recorre cualquier estructura y recoge los resultados de búsqueda.\n *\n * Se busca por el campo `type` en vez de por la ruta exacta del evento a\n * propósito: el formato de los eventos SSE puede cambiar de sitio los bloques,\n * y un recolector que dependa de la ruta se rompe en silencio —devolviendo cero\n * resultados, que se lee igual que «no hay nada»—.\n */\nexport function recolectarResultados(valor: unknown, acumulado: ResultadoWeb[] = []): ResultadoWeb[] {\n\tif (Array.isArray(valor)) {\n\t\tfor (const v of valor) recolectarResultados(v, acumulado);\n\t\treturn acumulado;\n\t}\n\tif (!valor || typeof valor !== \"object\") return acumulado;\n\tconst o = valor as Record<string, unknown>;\n\tif (o.type === \"web_search_result\" && typeof o.url === \"string\") {\n\t\tacumulado.push({\n\t\t\ttitulo: typeof o.title === \"string\" ? o.title : o.url,\n\t\t\turl: o.url,\n\t\t\tedad: typeof o.page_age === \"string\" ? o.page_age : undefined,\n\t\t});\n\t}\n\tfor (const v of Object.values(o)) recolectarResultados(v, acumulado);\n\treturn acumulado;\n}\n\n/** Quita repetidos por URL, conservando el orden de aparición. */\nexport function sinRepetidos(resultados: ResultadoWeb[]): ResultadoWeb[] {\n\tconst vistas = new Set<string>();\n\tconst unicos: ResultadoWeb[] = [];\n\tfor (const r of resultados) {\n\t\tif (vistas.has(r.url)) continue;\n\t\tvistas.add(r.url);\n\t\tunicos.push(r);\n\t}\n\treturn unicos;\n}\n\n/**\n * Envuelve un `fetch` para leer los resultados sin estorbar a quien lo usa.\n *\n * `tee()` da dos flujos: uno se devuelve intacto —el SDK tiene que recibir\n * exactamente lo que habría recibido— y el otro se analiza aquí. Si el análisis\n * falla, falla solo: una búsqueda sin fuentes es peor que una con fuentes, pero\n * una sesión rota por el analizador es mucho peor que las dos.\n */\nexport function fetchQueRecolecta(base: typeof fetch, destino: ResultadoWeb[]): typeof fetch {\n\treturn async (...args) => {\n\t\tconst respuesta = await base(...args);\n\t\tif (!respuesta.body) return respuesta;\n\t\tconst [paraElSdk, paraNosotros] = respuesta.body.tee();\n\n\t\tvoid (async () => {\n\t\t\tconst lector = paraNosotros.getReader();\n\t\t\tconst decodificador = new TextDecoder();\n\t\t\tlet pendiente = \"\";\n\t\t\ttry {\n\t\t\t\tfor (;;) {\n\t\t\t\t\tconst { done, value } = await lector.read();\n\t\t\t\t\tif (done) break;\n\t\t\t\t\tpendiente += decodificador.decode(value, { stream: true });\n\t\t\t\t\tconst lineas = pendiente.split(\"\\n\");\n\t\t\t\t\t// La última puede estar a medias: se queda para la próxima vuelta.\n\t\t\t\t\tpendiente = lineas.pop() ?? \"\";\n\t\t\t\t\tfor (const linea of lineas) {\n\t\t\t\t\t\tif (!linea.startsWith(\"data: \")) continue;\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\trecolectarResultados(JSON.parse(linea.slice(6)), destino);\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t// Una línea que no es JSON no dice nada del resto del flujo.\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\t// El flujo puede acabar sin salto final, y entonces el último evento\n\t\t\t\t// se queda en `pendiente`. Perderlo silenciosamente equivaldría a\n\t\t\t\t// devolver una fuente menos sin que nadie lo note.\n\t\t\t\tif (pendiente.startsWith(\"data: \")) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\trecolectarResultados(JSON.parse(pendiente.slice(6)), destino);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Una cola incompleta no es un error: es una cola incompleta.\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// La rama de análisis nunca puede tumbar la petición.\n\t\t\t}\n\t\t})();\n\n\t\treturn new Response(paraElSdk, {\n\t\t\tstatus: respuesta.status,\n\t\t\tstatusText: respuesta.statusText,\n\t\t\theaders: respuesta.headers,\n\t\t});\n\t};\n}\n\n/** Lo que hace falta para buscar, inyectado para poder probarlo sin red. */\nexport interface DependenciasBusqueda {\n\t/** Ejecuta una consulta contra el modelo con las opciones dadas. */\n\tcompletar: (\n\t\tconsulta: string,\n\t\topciones: { fetch: typeof fetch; onPayload: (c: unknown) => unknown },\n\t) => Promise<void>;\n\tfetchBase?: typeof fetch;\n\tmaxResultados?: number;\n}\n\n/**\n * Busca y devuelve las fuentes.\n *\n * No devuelve la síntesis del modelo a propósito: quien llama es el agente, que\n * ya sabe leer. Lo que necesita de una búsqueda son URLs a las que ir con\n * `web_fetch`, no un resumen de segunda mano que ya viene con la\n * interpretación de otro modelo encima.\n */\nexport async function buscarConElModelo(consulta: string, deps: DependenciasBusqueda): Promise<ResultadoWeb[]> {\n\tconst encontrados: ResultadoWeb[] = [];\n\tawait deps.completar(consulta, {\n\t\tfetch: fetchQueRecolecta(deps.fetchBase ?? fetch, encontrados),\n\t\tonPayload: (carga) => conToolDeBusqueda(carga),\n\t});\n\treturn sinRepetidos(encontrados).slice(0, deps.maxResultados ?? 10);\n}\n"]}