export type QuotaValue = | { state: "measured"; unit: "percent" | "requests" | "credits" | "currency" | "unknown"; unitLabel?: string | undefined; used?: number | undefined; remaining?: number | undefined; total?: number | undefined; usedPercent?: number | undefined; } | { state: "unlimited" } | { state: "unknown" }; export interface QuotaBucket { id: string; label: string; kind: "allowance" | "balance" | "spend-cap"; observedAt: number; scope?: string | undefined; period?: | { label: string; durationMs?: number | undefined; resetsAt?: number | undefined; } | undefined; value: QuotaValue; } export interface ProviderQuota { provider: string; name: string; buckets: QuotaBucket[]; /** Oldest retained observation when partial header updates are merged. */ observedAt: number; } export interface QuotaProvider { name: string; fetch: (key: string) => Promise; headers?: | ((headers: Record) => ProviderQuota | undefined) | undefined; }