/**
 * Rate limit store — captures `SDKRateLimitInfo` events emitted by
 * `@anthropic-ai/claude-agent-sdk`'s `query()` stream.
 *
 * The SDK reports the live Claude Max subscription quota state as
 * `rate_limit_event` events in the form:
 *
 *   {
 *     type: "rate_limit_event",
 *     rate_limit_info: {
 *       status: "allowed" | "allowed_warning" | "rejected",
 *       resetsAt?: number,                              // epoch ms
 *       rateLimitType?: "five_hour" | "seven_day"
 *                     | "seven_day_opus" | "seven_day_sonnet"
 *                     | "overage",
 *       utilization?: number,                           // 0..1
 *       overageStatus?: "allowed" | "allowed_warning" | "rejected",
 *       overageResetsAt?: number,
 *       isUsingOverage?: boolean,
 *       surpassedThreshold?: number,
 *       ...
 *     },
 *     uuid, session_id
 *   }
 *
 * We keep the most recent entry per `rateLimitType` (or "default" if absent)
 * in memory. State resets on proxy restart — that's fine because the SDK will
 * push a fresh event on the next request.
 *
 * Singleton — one Meridian process holds one snapshot at a time. With
 * multi-profile setups (`x-meridian-profile` / `POST /profiles/active`)
 * each profile is a separate Claude Max subscription with separate quotas,
 * so the store is **cleared on profile switch and on `/auth/refresh`** —
 * the next SDK call repopulates it for the active profile. Consumers of
 * `/v1/usage/quota` should treat the snapshot as "the active profile's
 * latest known state" and re-fetch after switching profiles.
 */
import type { SDKRateLimitInfo } from "@anthropic-ai/claude-agent-sdk";
export interface RateLimitEntry extends SDKRateLimitInfo {
    /** When this entry was captured (epoch ms). */
    observedAt: number;
}
/** Type discriminator for the entry's bucket key. */
export type RateLimitBucketKey = NonNullable<SDKRateLimitInfo["rateLimitType"]> | "default";
declare class RateLimitStore {
    private entries;
    /**
     * Record a rate-limit info snapshot.
     * Last-write-wins per bucket key (rateLimitType). Older entries for the
     * same key are overwritten — clients should treat the latest as canonical.
     */
    record(info: SDKRateLimitInfo | undefined | null): void;
    /** Snapshot all current entries, newest-first by observedAt. */
    getAll(): RateLimitEntry[];
    /** Snapshot a single bucket, or undefined if not yet seen. */
    get(key: RateLimitBucketKey): RateLimitEntry | undefined;
    /** Number of distinct buckets observed. */
    get size(): number;
    /**
     * Drop all stored entries. Wired into the `POST /profiles/active` and
     * `POST /auth/refresh` handlers so quotas can't leak across profiles or
     * stale credential boundaries. Also used by tests for isolation.
     */
    clear(): void;
}
/**
 * Process-wide singleton. Importers should always use this instance — do
 * not instantiate `RateLimitStore` directly outside of tests.
 */
export declare const rateLimitStore: RateLimitStore;
/** Exported for test isolation only. */
export { RateLimitStore as _RateLimitStoreForTests };
//# sourceMappingURL=rateLimitStore.d.ts.map