@fudrouter/fsrouter 0.6.64 → 0.6.65

package/open-sse/config/embeddingRegistry.js

@@ -0,0 +1,264 @@
+/**
+ * Embedding Provider Registry
+ *
+ * Defines providers that support the /v1/embeddings endpoint.
+ */
+
+export const EMBEDDING_PROVIDERS = {
+  cohere: {
+    id: "cohere", baseUrl: "https://api.cohere.com/v2/embed",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "embed-v4.0", name: "Embed v4.0" },
+      { id: "embed-multilingual-v3.0", name: "Embed Multilingual v3.0" },
+      { id: "embed-multilingual-v3.0-images", name: "Embed Multilingual v3.0 Image" },
+      { id: "embed-multilingual-light-v3.0", name: "Embed Multilingual Light v3.0" },
+      { id: "embed-multilingual-light-v3.0-images", name: "Embed Multilingual Light v3.0 Image" },
+    ],
+  },
+  nebius: {
+    id: "nebius", baseUrl: "https://api.tokenfactory.nebius.com/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [{ id: "Qwen/Qwen3-Embedding-8B", name: "Qwen3 Embedding 8B", dimensions: 4096 }],
+  },
+  openai: {
+    id: "openai", baseUrl: "https://api.openai.com/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "text-embedding-3-small", name: "Text Embedding 3 Small", dimensions: 1536 },
+      { id: "text-embedding-3-large", name: "Text Embedding 3 Large", dimensions: 3072 },
+      { id: "text-embedding-ada-002", name: "Text Embedding Ada 002", dimensions: 1536 },
+    ],
+  },
+  "vercel-ai-gateway": {
+    id: "vercel-ai-gateway", baseUrl: "https://ai-gateway.vercel.sh/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "text-embedding-3-small", name: "Text Embedding 3 Small", dimensions: 1536 },
+      { id: "text-embedding-3-large", name: "Text Embedding 3 Large", dimensions: 3072 },
+    ],
+  },
+  upstage: {
+    id: "upstage", baseUrl: "https://api.upstage.ai/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "embedding-query", name: "Embedding Query", dimensions: 4096 },
+      { id: "embedding-passage", name: "Embedding Passage", dimensions: 4096 },
+    ],
+  },
+  mistral: {
+    id: "mistral", baseUrl: "https://api.mistral.ai/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [{ id: "mistral-embed", name: "Mistral Embed", dimensions: 1024 }],
+  },
+  together: {
+    id: "together", baseUrl: "https://api.together.xyz/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "BAAI/bge-large-en-v1.5", name: "BGE Large EN v1.5", dimensions: 1024 },
+      { id: "togethercomputer/m2-bert-80M-8k-retrieval", name: "M2 BERT 80M 8K", dimensions: 768 },
+    ],
+  },
+  fireworks: {
+    id: "fireworks", baseUrl: "https://api.fireworks.ai/inference/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "nomic-ai/nomic-embed-text-v1.5", name: "Nomic Embed Text v1.5", dimensions: 768 },
+      { id: "accounts/fireworks/models/qwen3-embedding-8b", name: "Qwen3 Embedding 8B", dimensions: 4096 },
+    ],
+  },
+  nvidia: {
+    id: "nvidia", baseUrl: "https://integrate.api.nvidia.com/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [{
+      id: "nvidia/nv-embedqa-e5-v5", name: "NV EmbedQA E5 v5", dimensions: 1024,
+      defaultParams: { input_type: "query" },
+    }],
+  },
+  deepinfra: {
+    id: "deepinfra", baseUrl: "https://api.deepinfra.com/v1/openai/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "Qwen/Qwen3-Embedding-8B", name: "Qwen3 Embedding 8B", dimensions: 4096 },
+      { id: "Qwen/Qwen3-Embedding-4B", name: "Qwen3 Embedding 4B", dimensions: 2560 },
+      { id: "Qwen/Qwen3-Embedding-0.6B", name: "Qwen3 Embedding 0.6B", dimensions: 1024 },
+      { id: "BAAI/bge-large-en-v1.5", name: "BGE Large EN v1.5", dimensions: 1024 },
+      { id: "BAAI/bge-base-en-v1.5", name: "BGE Base EN v1.5", dimensions: 768 },
+      { id: "BAAI/bge-m3", name: "BGE-M3", dimensions: 1024 },
+      { id: "intfloat/e5-large-v2", name: "E5 Large v2", dimensions: 1024 },
+      { id: "thenlper/gte-large", name: "GTE Large", dimensions: 1024 },
+    ],
+  },
+  openrouter: {
+    id: "openrouter", baseUrl: "https://openrouter.ai/api/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "openai/text-embedding-3-small", name: "Text Embedding 3 Small (OpenRouter)", dimensions: 1536 },
+      { id: "openai/text-embedding-3-large", name: "Text Embedding 3 Large (OpenRouter)", dimensions: 3072 },
+      { id: "openai/text-embedding-ada-002", name: "Text Embedding Ada 002 (OpenRouter)", dimensions: 1536 },
+    ],
+  },
+  gemini: {
+    id: "gemini", baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "gemini-embedding-2", name: "Gemini Embedding 2", dimensions: 768 },
+      { id: "gemini-embedding-001", name: "Gemini Embedding 001", dimensions: 768 },
+    ],
+  },
+  "voyage-ai": {
+    id: "voyage-ai", baseUrl: "https://api.voyageai.com/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "voyage-4-large", name: "Voyage 4 Large", dimensions: 1024 },
+      { id: "voyage-4", name: "Voyage 4", dimensions: 1024 },
+      { id: "voyage-4-lite", name: "Voyage 4 Lite", dimensions: 1024 },
+      { id: "voyage-3-large", name: "Voyage 3 Large", dimensions: 1024 },
+      { id: "voyage-multilingual-3.5", name: "Voyage Multilingual 3.5", dimensions: 1024 },
+      { id: "voyage-code-3", name: "Voyage Code 3", dimensions: 1024 },
+      { id: "voyage-code-2", name: "Voyage Code 2", dimensions: 1536 },
+      { id: "voyage-finance-2", name: "Voyage Finance 2", dimensions: 1024 },
+      { id: "voyage-law-2", name: "Voyage Law 2", dimensions: 1024 },
+    ],
+  },
+  github: {
+    id: "github", baseUrl: "https://models.inference.ai.azure.com/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "text-embedding-3-small", name: "Text Embedding 3 Small (GitHub)", dimensions: 1536 },
+      { id: "text-embedding-3-large", name: "Text Embedding 3 Large (GitHub)", dimensions: 3072 },
+    ],
+  },
+  "jina-ai": {
+    id: "jina-ai", baseUrl: "https://api.jina.ai/v1/embeddings",
+    authType: "apikey", authHeader: "bearer",
+    models: [
+      { id: "jina-embeddings-v5-text-small", name: "Jina Embeddings v5 Text Small", dimensions: 1024 },
+      { id: "jina-embeddings-v5-text-nano", name: "Jina Embeddings v5 Text Nano", dimensions: 768 },
+      { id: "jina-code-embeddings-1.5b", name: "Jina Code Embeddings 1.5B", dimensions: 1536 },
+      { id: "jina-code-embeddings-0.5b", name: "Jina Code Embeddings 0.5B", dimensions: 896 },
+      { id: "jina-embeddings-v4", name: "Jina Embeddings v4", dimensions: 2048 },
+      { id: "jina-clip-v2", name: "Jina CLIP v2", dimensions: 1024 },
+      { id: "jina-colbert-v2", name: "Jina ColBERT v2", dimensions: 128 },
+    ],
+  },
+};
+
+const EMBEDDING_PROVIDER_ALIASES = { jina: "jina-ai", voyage: "voyage-ai" };
+
+function resolveEmbeddingProviderId(providerId) {
+  return EMBEDDING_PROVIDER_ALIASES[providerId] || providerId;
+}
+
+function normalizeProviderScopedModelId(providerId, modelId) {
+  const resolvedProvider = resolveEmbeddingProviderId(providerId);
+  const provider = EMBEDDING_PROVIDERS[resolvedProvider];
+  if (provider?.models.some((model) => model.id === modelId)) return modelId;
+  const providerScopedModelId = `${resolvedProvider}/${modelId}`;
+  if (provider?.models.some((model) => model.id === providerScopedModelId)) {
+    return providerScopedModelId;
+  }
+  return modelId.startsWith(`${providerId}/`) ? modelId.slice(providerId.length + 1) : modelId;
+}
+
+function toProviderScopedModelId(providerId, modelId) {
+  return modelId.startsWith(`${providerId}/`) ? modelId : `${providerId}/${modelId}`;
+}
+
+export function getEmbeddingProvider(providerId) {
+  return EMBEDDING_PROVIDERS[resolveEmbeddingProviderId(providerId)] || null;
+}
+
+export function parseEmbeddingModel(modelStr, dynamicProviders) {
+  if (!modelStr) return { provider: null, model: null };
+  const slashIdx = modelStr.indexOf("/");
+  if (slashIdx > 0) {
+    const rawProvider = modelStr.slice(0, slashIdx);
+    const resolvedProvider = resolveEmbeddingProviderId(rawProvider);
+    if (EMBEDDING_PROVIDERS[resolvedProvider]) {
+      return {
+        provider: resolvedProvider,
+        model: normalizeProviderScopedModelId(resolvedProvider, modelStr.slice(slashIdx + 1)),
+      };
+    }
+    for (const [providerId] of Object.entries(EMBEDDING_PROVIDERS)) {
+      if (modelStr.startsWith(providerId + "/")) {
+        return {
+          provider: providerId,
+          model: normalizeProviderScopedModelId(providerId, modelStr.slice(providerId.length + 1)),
+        };
+      }
+    }
+    if (dynamicProviders) {
+      for (const dp of dynamicProviders) {
+        if (modelStr.startsWith(dp.id + "/")) {
+          return { provider: dp.id, model: modelStr.slice(dp.id.length + 1) };
+        }
+      }
+    }
+    const provider = modelStr.slice(0, slashIdx);
+    const model = modelStr.slice(slashIdx + 1);
+    return { provider, model };
+  }
+  for (const [providerId, config] of Object.entries(EMBEDDING_PROVIDERS)) {
+    if (config.models.some((m) => m.id === modelStr)) {
+      return { provider: providerId, model: modelStr };
+    }
+  }
+  return { provider: null, model: modelStr };
+}
+
+export function getEmbeddingDimension(modelStr) {
+  const { provider, model } = parseEmbeddingModel(modelStr);
+  if (!provider || !model) return undefined;
+  const config = getEmbeddingProvider(provider);
+  if (!config) return undefined;
+  return config.models.find((m) => m.id === model)?.dimensions;
+}
+
+export function detectEmbeddingDimensionConflict(modelStrs) {
+  const dimensions = {};
+  for (const modelStr of modelStrs) {
+    const dim = getEmbeddingDimension(modelStr);
+    if (typeof dim === "number") dimensions[modelStr] = dim;
+  }
+  const distinct = [...new Set(Object.values(dimensions))].sort((a, b) => a - b);
+  return { conflict: distinct.length > 1, dimensions, distinct };
+}
+
+export function getEmbeddingModelDefaultParams(providerConfig, modelId) {
+  if (!providerConfig || !modelId) return undefined;
+  return providerConfig.models.find((m) => m.id === modelId)?.defaultParams;
+}
+
+export function getAllEmbeddingModels() {
+  const models = [];
+  for (const [providerId, config] of Object.entries(EMBEDDING_PROVIDERS)) {
+    for (const model of config.models) {
+      models.push({
+        id: toProviderScopedModelId(providerId, model.id),
+        name: model.name,
+        provider: providerId,
+        dimensions: model.dimensions,
+      });
+    }
+  }
+  return models;
+}
+
+export function buildDynamicEmbeddingProvider(node) {
+  if (!node.prefix || !node.baseUrl) {
+    throw new Error(`Invalid provider_node: missing prefix or baseUrl`);
+  }
+  if (node.prefix.includes("/") || node.prefix.includes(" ")) {
+    throw new Error(`Invalid provider_node prefix "${node.prefix}": must not contain / or spaces`);
+  }
+  const baseUrl = node.baseUrl.replace(/\/+$/, "");
+  return {
+    id: node.prefix,
+    baseUrl: `${baseUrl}/embeddings`,
+    authType: "none",
+    authHeader: "none",
+    models: [],
+  };
+}

package/open-sse/config/errorConfig.js

@@ -0,0 +1,96 @@
+// OpenAI-compatible error types mapping (client-facing)
+export const ERROR_TYPES = {
+  400: { type: "invalid_request_error", code: "bad_request" },
+  401: { type: "authentication_error", code: "invalid_api_key" },
+  402: { type: "billing_error", code: "payment_required" },
+  403: { type: "permission_error", code: "insufficient_quota" },
+  404: { type: "invalid_request_error", code: "model_not_found" },
+  406: { type: "invalid_request_error", code: "model_not_supported" },
+  429: { type: "rate_limit_error", code: "rate_limit_exceeded" },
+  500: { type: "server_error", code: "internal_server_error" },
+  502: { type: "server_error", code: "bad_gateway" },
+  503: { type: "server_error", code: "service_unavailable" },
+  504: { type: "server_error", code: "gateway_timeout" }
+};
+
+// Default error messages per status code (client-facing)
+export const DEFAULT_ERROR_MESSAGES = {
+  400: "Bad request",
+  401: "Invalid API key provided",
+  402: "Payment required",
+  403: "You exceeded your current quota",
+  404: "Model not found",
+  406: "Model not supported",
+  429: "Rate limit exceeded",
+  500: "Internal server error",
+  502: "Bad gateway - upstream provider error",
+  503: "Service temporarily unavailable",
+  504: "Gateway timeout"
+};
+
+// Exponential backoff config for rate limits
+export const BACKOFF_CONFIG = {
+  base: 2000,
+  max: 5 * 60 * 1000,
+  maxLevel: 15
+};
+
+// Default cooldown for transient/unknown errors
+export const TRANSIENT_COOLDOWN_MS = 30 * 1000;
+
+// Hard cap for provider-reported rate limit cooldown (e.g. codex resets_at can be 5-6h)
+export const MAX_RATE_LIMIT_COOLDOWN_MS = 30 * 60 * 1000;
+
+// Cooldown durations (ms)
+const COOLDOWN = {
+  long: 2 * 60 * 1000,
+  short: 5 * 1000,
+  exhausted: 24 * 60 * 60 * 1000, // 24 hours
+};
+
+/**
+ * Unified error classification rules.
+ * Checked top-to-bottom: text rules first (by order), then status rules.
+ * Each rule: { text?, status?, cooldownMs?, backoff? }
+ *   - text: substring match (case-insensitive) on error message
+ *   - status: HTTP status code match
+ *   - cooldownMs: fixed cooldown duration
+ *   - backoff: true = use exponential backoff (rate limit)
+ */
+export const ERROR_RULES = [
+  // --- Text-based rules (checked first, order = priority) ---
+  { text: "exhausted",                cooldownMs: COOLDOWN.exhausted },
+  { text: "insufficient credits",     cooldownMs: COOLDOWN.exhausted },
+  { text: "1076",                     cooldownMs: COOLDOWN.exhausted },
+  { text: "only available on paid plans", cooldownMs: COOLDOWN.exhausted },
+  { text: "failed to capture weavy firebase id token", cooldownMs: COOLDOWN.exhausted },
+  { text: "trial version is not yet", cooldownMs: COOLDOWN.exhausted },
+  { text: "neurons",                  cooldownMs: COOLDOWN.exhausted }, // CF Workers AI daily quota
+  { text: "daily free allocation",    cooldownMs: COOLDOWN.exhausted }, // CF Workers AI daily quota
+  { text: "upgrade to cloudflare",    cooldownMs: COOLDOWN.exhausted }, // CF Workers AI paid plan prompt
+  { text: "4006",                     cooldownMs: COOLDOWN.exhausted }, // CF Workers AI error code
+  { text: "no credentials",           cooldownMs: COOLDOWN.long },
+  { text: "request not allowed",      cooldownMs: COOLDOWN.short },
+  { text: "improperly formed request", cooldownMs: COOLDOWN.long },
+  { text: "rate limit",               backoff: true },
+  { text: "too many requests",        backoff: true },
+  { text: "quota exceeded",           backoff: true },
+  { text: "capacity",                 backoff: true },
+  { text: "overloaded",               backoff: true },
+
+  // --- Status-based rules (fallback when text doesn't match) ---
+  { status: 401, cooldownMs: COOLDOWN.long },
+  { status: 402, cooldownMs: COOLDOWN.long },
+  { status: 403, cooldownMs: COOLDOWN.long },
+  { status: 404, cooldownMs: COOLDOWN.long },
+  { status: 429, backoff: true },
+];
+
+// Backward compat: COOLDOWN_MS object (used by index.js re-export)
+export const COOLDOWN_MS = {
+  unauthorized: COOLDOWN.long,
+  paymentRequired: COOLDOWN.long,
+  notFound: COOLDOWN.long,
+  transient: TRANSIENT_COOLDOWN_MS,
+  requestNotAllowed: COOLDOWN.short,
+};

package/open-sse/config/freeModelCatalog.data.js

@@ -0,0 +1,121 @@
+// AUTO-GENERATED — refreshed by the 2026-06-17 per-provider free-tier research pass.
+// Source: _tasks/features-v3.8.28/free-tier-research-2026-06-17.raw.json (50-agent web research + adversarial verification).
+// Methodology: honest pool-deduped recurring tokens. "recurring-uncapped" = permanently free but no
+// published token cap (rate/concurrency-limited) — NOT summed into the steady headline (see freeModelCatalog.js).
+// Deposit-unlock boosts (e.g. OpenRouter $10 -> 1000 RPD) live in FREE_TIER_BOOSTS, not per-record.
+// Do not edit by hand — re-run the patch generator to refresh.
+
+export const FREE_MODEL_BUDGETS = [
+  { provider: "agentrouter", modelId: "claude-opus-4-6", displayName: "Claude 4.6 Opus", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "agentrouter", modelId: "claude-haiku-4-5-20251001", displayName: "Claude 4.5 Haiku", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "agentrouter", modelId: "glm-5.1", displayName: "GLM 5.1", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "agentrouter", modelId: "deepseek-v3.2", displayName: "DeepSeek V3.2", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "agentrouter", modelId: "gpt-4.1-mini", displayName: "GPT 4.1 Mini", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "agentrouter", modelId: "gpt-4.1-nano", displayName: "GPT 4.1 Nano", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "agentrouter", modelId: "gemini-2.5-flash", displayName: "Gemini 2.5 Flash", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "agentrouter", modelId: "gemini-2.5-pro", displayName: "Gemini 2.5 Pro", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "agentrouter", modelId: "grok-3", displayName: "Grok 3", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "agentrouter", modelId: "claude-sonnet-4-20250514", displayName: "Claude Sonnet 4", monthlyTokens: 0, creditTokens: 200000000, freeType: "one-time-initial", poolKey: "agentrouter", tos: "caution" },
+  { provider: "google-ai-studio", modelId: "gemini-2.5-flash", displayName: "Gemini 2.5 Flash", monthlyTokens: 1500000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "google-ai-studio", tos: "ok" },
+  { provider: "google-ai-studio", modelId: "gemini-2.5-pro", displayName: "Gemini 2.5 Pro", monthlyTokens: 150000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "google-ai-studio", tos: "ok" },
+  { provider: "google-ai-studio", modelId: "gemini-2.0-flash", displayName: "Gemini 2.0 Flash", monthlyTokens: 1500000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "google-ai-studio", tos: "ok" },
+  { provider: "google-ai-studio", modelId: "gemma-3-27b-it", displayName: "Gemma 3 27B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "openrouter", modelId: "google/gemini-2.5-flash", displayName: "Gemini 2.5 Flash", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "openrouter-free", tos: "ok" },
+  { provider: "openrouter", modelId: "deepseek/deepseek-chat-v3-0324:free", displayName: "DeepSeek V3 0324", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "openrouter-free", tos: "ok" },
+  { provider: "openrouter", modelId: "deepseek/deepseek-r1-0528:free", displayName: "DeepSeek R1 0528", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "openrouter-free", tos: "ok" },
+  { provider: "openrouter", modelId: "meta-llama/llama-4-maverick:free", displayName: "Llama 4 Maverick", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "openrouter-free", tos: "ok" },
+  { provider: "openrouter", modelId: "qwen/qwen3-235b-a22b:free", displayName: "Qwen3 235B", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "openrouter-free", tos: "ok" },
+  { provider: "openrouter", modelId: "mistralai/mistral-small-3.1-24b-instruct:free", displayName: "Mistral Small 3.1 24B", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "openrouter-free", tos: "ok" },
+  { provider: "openrouter", modelId: "microsoft/mai-ds-r1:free", displayName: "MAI DS R1", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "openrouter-free", tos: "ok" },
+  { provider: "openrouter", modelId: "moonshotai/kimi-k2:free", displayName: "Kimi K2", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "openrouter-free", tos: "ok" },
+  { provider: "openrouter", modelId: "nvidia/llama-3.1-nemotron-ultra-253b-v1:free", displayName: "Nemotron Ultra 253B", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-daily", poolKey: "openrouter-free", tos: "ok" },
+  { provider: "mistral", modelId: "mistral-small-latest", displayName: "Mistral Small", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "mistral", modelId: "mistral-medium-latest", displayName: "Mistral Medium", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "mistral", modelId: "codestral-latest", displayName: "Codestral", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "mistral", modelId: "pixtral-large-latest", displayName: "Pixtral Large", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "cloudflare", modelId: "@cf/meta/llama-3.3-70b-instruct-fp8", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "cloudflare", modelId: "@cf/meta/llama-3.1-8b-instruct-fp8", displayName: "Llama 3.1 8B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "cloudflare", modelId: "@cf/mistralai/mistral-small-3.1-24b-instruct", displayName: "Mistral Small 3.1", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "cloudflare", modelId: "@cf/deepseek-ai/deepseek-r1-distill-qwen-32b", displayName: "DeepSeek R1 32B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "cloudflare", modelId: "@cf/qwen/qwen2.5-coder-32b-instruct", displayName: "Qwen2.5 Coder 32B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "cerebras", modelId: "llama3.3-70b", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "cerebras", modelId: "llama3.1-8b", displayName: "Llama 3.1 8B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "cerebras", modelId: "qwen-2.5-32b", displayName: "Qwen 2.5 32B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "sambanova", modelId: "DeepSeek-V3-0324", displayName: "DeepSeek V3", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "sambanova", modelId: "DeepSeek-R1-Distill-Llama-70B", displayName: "DeepSeek R1 70B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "sambanova", modelId: "Llama-4-Maverick-17B-128E-Instruct", displayName: "Llama 4 Maverick", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "groq", modelId: "llama-3.3-70b-versatile", displayName: "Llama 3.3 70B", monthlyTokens: 1000000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "groq-free", tos: "ok" },
+  { provider: "groq", modelId: "llama-3.1-8b-instant", displayName: "Llama 3.1 8B Instant", monthlyTokens: 500000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "groq-free", tos: "ok" },
+  { provider: "groq", modelId: "gemma2-9b-it", displayName: "Gemma 2 9B", monthlyTokens: 500000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "groq-free", tos: "ok" },
+  { provider: "huggingface", modelId: "meta-llama/Llama-3.3-70B-Instruct", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "huggingface", modelId: "Qwen/Qwen2.5-72B-Instruct", displayName: "Qwen 2.5 72B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "huggingface", modelId: "deepseek-ai/DeepSeek-R1-Distill-Qwen-32B", displayName: "DeepSeek R1 32B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "huggingface", modelId: "mistralai/Mistral-Small-3.1-24B-Instruct-2503", displayName: "Mistral Small 3.1", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "together", modelId: "meta-llama/Llama-3.3-70B-Instruct-Turbo", displayName: "Llama 3.3 70B Turbo", monthlyTokens: 0, creditTokens: 600000000, freeType: "one-time-initial", poolKey: "together-free", tos: "ok" },
+  { provider: "together", modelId: "deepseek-ai/DeepSeek-R1", displayName: "DeepSeek R1", monthlyTokens: 0, creditTokens: 600000000, freeType: "one-time-initial", poolKey: "together-free", tos: "ok" },
+  { provider: "together", modelId: "Qwen/Qwen3-235B-A22B-fp8", displayName: "Qwen3 235B", monthlyTokens: 0, creditTokens: 600000000, freeType: "one-time-initial", poolKey: "together-free", tos: "ok" },
+  { provider: "nvidia", modelId: "nvidia/llama-3.1-nemotron-ultra-253b-v1", displayName: "Nemotron Ultra 253B", monthlyTokens: 0, creditTokens: 500000000, freeType: "one-time-initial", poolKey: "nvidia-free", tos: "ok" },
+  { provider: "nvidia", modelId: "nvidia/llama-3.3-nemotron-super-49b-v1", displayName: "Nemotron Super 49B", monthlyTokens: 0, creditTokens: 500000000, freeType: "one-time-initial", poolKey: "nvidia-free", tos: "ok" },
+  { provider: "nvidia", modelId: "deepseek-ai/deepseek-r1", displayName: "DeepSeek R1", monthlyTokens: 0, creditTokens: 500000000, freeType: "one-time-initial", poolKey: "nvidia-free", tos: "ok" },
+  { provider: "nvidia", modelId: "meta/llama-3.3-70b-instruct", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 500000000, freeType: "one-time-initial", poolKey: "nvidia-free", tos: "ok" },
+  { provider: "nvidia", modelId: "qwen/qwen2.5-72b-instruct", displayName: "Qwen 2.5 72B", monthlyTokens: 0, creditTokens: 500000000, freeType: "one-time-initial", poolKey: "nvidia-free", tos: "ok" },
+  { provider: "pollinations", modelId: "openai", displayName: "OpenAI (via Pollinations)", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "pollinations", modelId: "openai-fast", displayName: "OpenAI Fast", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "pollinations", modelId: "openai-large", displayName: "OpenAI Large", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "pollinations", modelId: "deepseek", displayName: "DeepSeek", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "pollinations", modelId: "deepseek-reasoning", displayName: "DeepSeek Reasoning", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "pollinations", modelId: "gemini", displayName: "Gemini", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "pollinations", modelId: "gemini-thinking", displayName: "Gemini Thinking", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "pollinations", modelId: "mistral", displayName: "Mistral", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "pollinations", modelId: "qwen", displayName: "Qwen", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "chutes", modelId: "deepseek-ai/DeepSeek-R1", displayName: "DeepSeek R1", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "chutes", modelId: "deepseek-ai/DeepSeek-V3-0324", displayName: "DeepSeek V3", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "chutes", modelId: "Qwen/Qwen3-235B-A22B", displayName: "Qwen3 235B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "chutes", modelId: "meta-llama/Llama-4-Maverick-17B-128E-Instruct", displayName: "Llama 4 Maverick", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "chutes", modelId: "moonshotai/Kimi-K2-Instruct", displayName: "Kimi K2", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "chutes", modelId: "microsoft/MAI-DS-R1", displayName: "MAI DS R1", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "aimlapi", modelId: "meta-llama/Llama-3.3-70B-Instruct", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "aimlapi", modelId: "mistralai/Mistral-Small-3.1-24B-Instruct-2503", displayName: "Mistral Small 3.1", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "aimlapi", modelId: "Qwen/Qwen3-235B-A22B", displayName: "Qwen3 235B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "aimlapi", modelId: "google/gemma-3-27b-it", displayName: "Gemma 3 27B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "xai", modelId: "grok-3-mini", displayName: "Grok 3 Mini", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "volcengine", modelId: "doubao-1.5-pro-32k", displayName: "Doubao 1.5 Pro 32K", monthlyTokens: 500000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "volcengine-free", tos: "ok" },
+  { provider: "volcengine", modelId: "doubao-1.5-lite-32k", displayName: "Doubao 1.5 Lite 32K", monthlyTokens: 500000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "volcengine-free", tos: "ok" },
+  { provider: "volcengine", modelId: "deepseek-v3-250324", displayName: "DeepSeek V3", monthlyTokens: 500000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "volcengine-free", tos: "ok" },
+  { provider: "volcengine", modelId: "deepseek-r1-250528", displayName: "DeepSeek R1", monthlyTokens: 500000000, creditTokens: 0, freeType: "recurring-monthly", poolKey: "volcengine-free", tos: "ok" },
+  { provider: "baidu", modelId: "ernie-4.5-8k", displayName: "ERNIE 4.5 8K", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "baidu", modelId: "ernie-4.5-128k", displayName: "ERNIE 4.5 128K", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "alibaba", modelId: "qwen-plus", displayName: "Qwen Plus", monthlyTokens: 0, creditTokens: 1000000000, freeType: "one-time-initial", poolKey: "alibaba-free", tos: "ok" },
+  { provider: "alibaba", modelId: "qwen-turbo", displayName: "Qwen Turbo", monthlyTokens: 0, creditTokens: 1000000000, freeType: "one-time-initial", poolKey: "alibaba-free", tos: "ok" },
+  { provider: "alibaba", modelId: "qwen3-235b-a22b", displayName: "Qwen3 235B", monthlyTokens: 0, creditTokens: 1000000000, freeType: "one-time-initial", poolKey: "alibaba-free", tos: "ok" },
+  { provider: "alibaba", modelId: "qwen-long", displayName: "Qwen Long", monthlyTokens: 0, creditTokens: 1000000000, freeType: "one-time-initial", poolKey: "alibaba-free", tos: "ok" },
+  { provider: "zhipu", modelId: "glm-4-flash", displayName: "GLM 4 Flash", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "zhipu", modelId: "glm-4v-flash", displayName: "GLM 4V Flash", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "zhipu", modelId: "glm-z1-air", displayName: "GLM Z1 Air", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "zhipu", modelId: "glm-z1-airx", displayName: "GLM Z1 AirX", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "moonshot", modelId: "moonshot-v1-8k", displayName: "Moonshot V1 8K", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "siliconflow", modelId: "deepseek-ai/DeepSeek-V3", displayName: "DeepSeek V3", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "siliconflow", modelId: "deepseek-ai/DeepSeek-R1", displayName: "DeepSeek R1", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "siliconflow", modelId: "Qwen/Qwen3-235B-A22B", displayName: "Qwen3 235B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "siliconflow", modelId: "Qwen/Qwen2.5-7B-Instruct", displayName: "Qwen 2.5 7B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "novita", modelId: "deepseek/deepseek-r1", displayName: "DeepSeek R1", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "novita", modelId: "deepseek/deepseek-chat-v3-0324", displayName: "DeepSeek V3", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "novita", modelId: "meta-llama/llama-4-maverick-17b-128e-instruct", displayName: "Llama 4 Maverick", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "hyperbolic", modelId: "meta-llama/Llama-3.3-70B-Instruct", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "hyperbolic", modelId: "deepseek-ai/DeepSeek-R1", displayName: "DeepSeek R1", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "fireworks", modelId: "accounts/fireworks/models/deepseek-v3-0324", displayName: "DeepSeek V3", monthlyTokens: 0, creditTokens: 100000000, freeType: "one-time-initial", poolKey: "fireworks-free", tos: "ok" },
+  { provider: "fireworks", modelId: "accounts/fireworks/models/llama-v3p3-70b-instruct", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 100000000, freeType: "one-time-initial", poolKey: "fireworks-free", tos: "ok" },
+  { provider: "fireworks", modelId: "accounts/fireworks/models/qwen3-235b-a22b", displayName: "Qwen3 235B", monthlyTokens: 0, creditTokens: 100000000, freeType: "one-time-initial", poolKey: "fireworks-free", tos: "ok" },
+  { provider: "yi", modelId: "yi-lightning", displayName: "Yi Lightning", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "yi", modelId: "yi-large", displayName: "Yi Large", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "targon", modelId: "deepseek-ai/DeepSeek-R1", displayName: "DeepSeek R1", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "targon", modelId: "moonshotai/Kimi-K2-Instruct", displayName: "Kimi K2", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "targon", modelId: "Qwen/Qwen3-235B-A22B", displayName: "Qwen3 235B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "nebius", modelId: "meta-llama/Llama-3.3-70B-Instruct-fast", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 1000000000, freeType: "one-time-initial", poolKey: "nebius-free", tos: "ok" },
+  { provider: "nebius", modelId: "deepseek-ai/DeepSeek-V3-0324", displayName: "DeepSeek V3", monthlyTokens: 0, creditTokens: 1000000000, freeType: "one-time-initial", poolKey: "nebius-free", tos: "ok" },
+  { provider: "featherless", modelId: "meta-llama/Llama-3.3-70B-Instruct", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "featherless", modelId: "deepseek-ai/DeepSeek-R1-Distill-Qwen-32B", displayName: "DeepSeek R1 32B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "featherless", modelId: "Qwen/Qwen3-235B-A22B", displayName: "Qwen3 235B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "unify", modelId: "llama-3.3-70b@nebius", displayName: "Llama 3.3 70B", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+  { provider: "unify", modelId: "deepseek-v3-0324@nebius", displayName: "DeepSeek V3", monthlyTokens: 0, creditTokens: 0, freeType: "recurring-uncapped", poolKey: null, tos: "ok" },
+];

package/open-sse/config/freeModelCatalog.js

@@ -0,0 +1,90 @@
+import { FREE_MODEL_BUDGETS } from "./freeModelCatalog.data.js";
+
+export { FREE_MODEL_BUDGETS } from "./freeModelCatalog.data.js";
+
+const RECURRING = new Set(["recurring-daily", "recurring-monthly", "keyless"]);
+
+/**
+ * Deposit-unlock boosts: a one-time small top-up that permanently raises a
+ * provider's recurring free quota. Kept OUT of the steady headline and surfaced
+ * as a separate "unlock more" figure. Keyed by the provider's recurring poolKey.
+ */
+export const FREE_TIER_BOOSTS = {
+  "openrouter-free": {
+    provider: "openrouter",
+    boostMonthlyTokens: 24_000_000,
+    note: "A one-time $10 lifetime top-up raises the free pool from 50 to 1000 requests/day (~24M tokens/month).",
+  },
+};
+
+function fmt(n) {
+  return n >= 1e9 ? (n / 1e9).toFixed(2) + "B" : Math.round(n / 1e6) + "M";
+}
+
+// Sum a per-model numeric field, counting each shared pool once (max within the pool);
+// poolKey null => the model is independent and counts on its own.
+function dedupedSum(models, pick, include) {
+  const poolMax = new Map();
+  let loose = 0;
+  for (const m of models) {
+    if (!include(m)) continue;
+    const key = m.poolKey;
+    if (key) poolMax.set(key, Math.max(poolMax.get(key) ?? 0, pick(m)));
+    else loose += pick(m);
+  }
+  for (const v of poolMax.values()) loose += v;
+  return loose;
+}
+
+export function computeFreeModelTotals(opts = {}) {
+  const models = FREE_MODEL_BUDGETS.filter((m) => !(opts.excludeTosAvoid && m.tos === "avoid"));
+
+  const steadyRecurringTokens = dedupedSum(
+    models,
+    (m) => m.monthlyTokens,
+    (m) => RECURRING.has(m.freeType),
+  );
+  const recurringCredits = dedupedSum(
+    models,
+    (m) => m.creditTokens,
+    (m) => m.freeType === "recurring-credit",
+  );
+  const oneTimeCredits = dedupedSum(
+    models,
+    (m) => m.creditTokens,
+    (m) => m.freeType === "one-time-initial",
+  );
+
+  const steadyWithRecurringCreditsTokens = steadyRecurringTokens + recurringCredits;
+  const firstMonthRealisticTokens = steadyWithRecurringCreditsTokens + oneTimeCredits;
+
+  const poolCount = new Set(
+    models.filter((m) => RECURRING.has(m.freeType) && m.poolKey).map((m) => m.poolKey),
+  ).size;
+
+  // Deposit-unlock boost: sum the FREE_TIER_BOOSTS whose pool still has a live
+  // recurring model in the (optionally ToS-filtered) set.
+  const livePools = new Set(
+    models.filter((m) => RECURRING.has(m.freeType) && m.poolKey).map((m) => m.poolKey),
+  );
+  const boostMonthlyTokens = Object.entries(FREE_TIER_BOOSTS)
+    .filter(([pool]) => livePools.has(pool))
+    .reduce((s, [, b]) => s + b.boostMonthlyTokens, 0);
+
+  // Permanently-free-but-uncapped providers (real access, no published cap).
+  const uncappedProviders = [
+    ...new Set(models.filter((m) => m.freeType === "recurring-uncapped").map((m) => m.provider)),
+  ].sort();
+
+  return {
+    steadyRecurringTokens,
+    steadyWithRecurringCreditsTokens,
+    firstMonthRealisticTokens,
+    boostMonthlyTokens,
+    uncappedProviders,
+    modelCount: models.length,
+    poolCount,
+    perModel: models.slice().sort((a, b) => b.monthlyTokens - a.monthlyTokens),
+    headline: `~${fmt(steadyRecurringTokens)} documented free tokens/month (steady), up to ~${fmt(firstMonthRealisticTokens)} in your first month with signup credits`,
+  };
+}