Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

4.0 KB
Raw Blame
import {
  isUserCallableAntigravityModelId,
  toClientAntigravityModelId,
} from "@omniroute/open-sse/config/antigravityModelAliases.ts";
import { isUserVisibleAgyQuotaModelId } from "@omniroute/open-sse/config/agyModels.ts";

type JsonRecord = Record<string, unknown>;

export function isRecord(value: unknown): value is JsonRecord {
  return value !== null && typeof value === "object" && !Array.isArray(value);
}

// Family aggregate buckets from retrieveUserQuotaSummary are not model ids. Dropping
// them here is why Token Monitor only ever saw the 5-hour bar (#15359); the session
// windows are the family 5-hour pools (#13739). Any other *_weekly key is a quota
// window too, not a model id, so it is preserved alongside the family buckets.
const ANTIGRAVITY_FAMILY_QUOTA_KEYS = new Set([
  "gemini_session",
  "gemini_weekly",
  "claude_gpt_session",
  "claude_gpt_weekly",
]);

/**
 * Whether a quota bucket may be shown for `provider`.
 *
 * `liveModelIds` is the provider's live discovery catalog when the caller has it: a model
 * the connection actually reports is always allowed, so a tier Google ships between two
 * OmniRoute releases keeps its quota instead of being dropped. The static catalogs stay as
 * the fallback for cold start / logged-out / discovery-failure.
 */
export function isUsageQuotaKeyAllowed(
  provider: string,
  quotaKey: string,
  liveModelIds?: ReadonlySet<string>
): boolean {
  if (quotaKey === "credits" || quotaKey === "models" || quotaKey.endsWith("_weekly")) return true;
  if (provider !== "antigravity" && provider !== "agy") return true;
  if (ANTIGRAVITY_FAMILY_QUOTA_KEYS.has(quotaKey)) return true;
  if (liveModelIds?.has(quotaKey)) return true;
  if (provider === "antigravity") return isUserCallableAntigravityModelId(quotaKey);
  return isUserVisibleAgyQuotaModelId(quotaKey);
}

export function normalizeUsageQuotaKey(
  provider: string,
  quotaKey: string,
  liveModelIds?: ReadonlySet<string>
): string | null {
  if (quotaKey === "credits" || quotaKey === "models" || quotaKey.endsWith("_weekly")) {
    return quotaKey;
  }
  if (
    (provider === "antigravity" || provider === "agy") &&
    ANTIGRAVITY_FAMILY_QUOTA_KEYS.has(quotaKey)
  ) {
    return quotaKey;
  }
  if (provider === "antigravity" || provider === "agy") {
    const clientKey = toClientAntigravityModelId(quotaKey);
    return isUsageQuotaKeyAllowed(provider, clientKey, liveModelIds) ? clientKey : null;
  }
  return isUsageQuotaKeyAllowed(provider, quotaKey, liveModelIds) ? quotaKey : null;
}

export function normalizeUsageQuotasForProvider(
  provider: string,
  quotas: JsonRecord | null | undefined,
  liveModelIds?: ReadonlySet<string>
): JsonRecord | null {
  if (!isRecord(quotas)) return quotas ?? null;

  const normalized: JsonRecord = {};
  let changed = false;

  for (const [quotaKey, quota] of Object.entries(quotas)) {
    const normalizedKey = normalizeUsageQuotaKey(provider, quotaKey, liveModelIds);
    if (!normalizedKey) {
      changed = true;
      continue;
    }

    const existing = normalized[normalizedKey];
    if (existing && isRecord(existing) && isRecord(quota)) {
      const existingSource = String(existing.quotaSource ?? "");
      const nextSource = String(quota.quotaSource ?? "");
      const sourceRank: Record<string, number> = {
        fetchAvailableModels: 0,
        localUsageHistory: 1,
        retrieveUserQuota: 2,
      };
      if ((sourceRank[existingSource] ?? 0) > (sourceRank[nextSource] ?? 0)) {
        continue;
      }
    }

    normalized[normalizedKey] = quota as JsonRecord;
    if (normalizedKey !== quotaKey) changed = true;
  }

  return changed ? normalized : quotas;
}

export function sanitizeUsageQuotasForProvider(
  provider: string,
  usage: JsonRecord,
  liveModelIds?: ReadonlySet<string>
): JsonRecord {
  if (provider !== "antigravity" && provider !== "agy") return usage;
  if (!isRecord(usage.quotas)) return usage;

  const sanitizedQuotas = normalizeUsageQuotasForProvider(provider, usage.quotas, liveModelIds);
  return sanitizedQuotas === usage.quotas ? usage : { ...usage, quotas: sanitizedQuotas };
}