@wenathlan/devthink 2.0.14 → 2.0.19

package/dist/quota.d.ts

@@ -1,453 +0,0 @@
-/**
- * @fileoverview quota.ts — the full quota manager of the merged provider lineage
- * @module auth/quota
- * @description
- *  Merged module. Lineage A (dual-source Antigravity + Gemini CLI quota with
- *  adaptive TTL cache, soft 90% threshold, background refresh, resilient
- *  parsing of v1internal:retrieveUserQuotaSummary) is the canonical surface.
- *
- *  v2.1.16 dead-code cleanup: the unused resilient lineage-B quota engine
- *  (zero consumers) was deleted. It duplicated lineage A as a second complete
- *  engine under aliased names — resolveQuotaPoolGroup (+ resolveGroup /
- *  getQuotaGroupForModel / modelToGroup), parseQuotaResponseResilient,
- *  retrieveUserQuotaSummaryResilient, checkQuotaFromSummary,
- *  isQuotaExhaustedBySummary, shouldSkipAccountBySummary,
- *  QuotaManagerResilient (+ getQuotaManager / resetQuotaManager /
- *  fetchQuotaWithCache / refreshQuotaBackground), getAdaptiveTtlMs,
- *  resolveBaseTtlFromConfig, parseRateLimitHeaders, hashToken's engine
- *  cluster, QUOTA_INFO and the Quota facade — every one verified by grep to
- *  have zero consumers outside quota.ts before deletion.
- *
- *  Canonical (lineage A) surface: OAUTH_CLIENT_ID/OAUTH_CLIENT_SECRET/GEMINI_CLI_SCOPES,
- *  PROJECT_FALLBACK, ENDPOINTS/ENDPOINTS_DAILY/QUOTA_ENDPOINTS + QuotaSource,
- *  QUOTA_GROUP_DEFS/QuotaGroupId/ResilientQuotaGroupDef, QUOTA_METHOD,
- *  QuotaWindow, QuotaBucketRaw/Parsed,
- *  QuotaGroupRaw/Parsed, QuotaSummaryRaw/Parsed, computeAdaptiveTtlMs,
- *  getQuotaRefreshIntervalMs, listQuotaGroups/getQuotaGroup, buildQuotaHeaders(token,source),
- *  parseQuotaBucket/parseQuotaGroup, QuotaFetchError, retrieveUserQuotaSummary,
- *  retrieveDualQuota, QuotaCacheManager + getQuotaCacheManager, QuotaManager +
- *  getDefaultQuotaManager, canProceedWithRequest, QuotaConfig/DEFAULT_QUOTA_CONFIG/
- *  resolveQuotaConfig, QUOTA_CACHE_FILE, hashToken.
- *
- *  Production-ready, only node:* builtins + global fetch. Zero external deps.
- *
- * @author ONDA 3 - Core Modules (A) + the provider lineage (B)
- * @license MIT
- * @since 2026
- */
-import { PROJECT_FALLBACK, QUOTA_SOFT_THRESHOLD, QUOTA_CACHE_TTL_MIN_MS, QUOTA_CACHE_TTL_MS, QUOTA_TIMEOUT_MS, JITTER_MIN_MS, JITTER_MAX_MS, ANTIGRAVITY_VERSION_FALLBACK, ANTIGRAVITY_USER_AGENT_FALLBACK, ANTIGRAVITY_CLIENT_ID_IS_BLINDED, ANTIGRAVITY_CLIENT_SECRET_IS_BLINDED, ANTIGRAVITY_ENDPOINT_FALLBACKS, GEMINI_CLI_ENDPOINT, QUOTA_ENDPOINT, PROJECT_ID_FALLBACK, PROJECT_NAME_FALLBACK } from "./constants.js";
-import { isRetryableStatus } from "./core.js";
-import { getXGoogApiClient } from "./fingerprint.js";
-import type { QuotaGroup } from "./constants.js";
-import { ANTIGRAVITY_VERSION_MIN, isGeminiCLIOnlyModel } from "./models.js";
-import { CLIENT_METADATA_STRING } from "./constants.js";
-import { X_GOOG_API_CLIENT_GEMINI_CLI as X_GOOG_API_CLIENT } from "./fingerprint.js";
-export { PROJECT_FALLBACK, QUOTA_SOFT_THRESHOLD, QUOTA_CACHE_TTL_MIN_MS, QUOTA_CACHE_TTL_MS, QUOTA_TIMEOUT_MS, JITTER_MIN_MS, JITTER_MAX_MS, ANTIGRAVITY_VERSION_FALLBACK, ANTIGRAVITY_USER_AGENT_FALLBACK, ANTIGRAVITY_CLIENT_ID_IS_BLINDED, ANTIGRAVITY_CLIENT_SECRET_IS_BLINDED, ANTIGRAVITY_ENDPOINT_FALLBACKS, GEMINI_CLI_ENDPOINT, QUOTA_ENDPOINT, PROJECT_ID_FALLBACK, PROJECT_NAME_FALLBACK, getXGoogApiClient, ANTIGRAVITY_VERSION_MIN, isRetryableStatus, X_GOOG_API_CLIENT, CLIENT_METADATA_STRING, };
-export { GEMINI_CLI_OAUTH_CLIENT_ID as OAUTH_CLIENT_ID, GEMINI_CLI_OAUTH_CLIENT_SECRET as OAUTH_CLIENT_SECRET, } from "./constants.js";
-export type { QuotaGroup };
-/**
- * Dual quota mapping: Antigravity uses the daily endpoint (real quota),
- * Gemini CLI uses the base endpoint (historically returns 1.0 but still queried).
- */
-export declare const QUOTA_ENDPOINTS: {
-    readonly antigravity: "https://daily-cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary";
-    readonly "gemini-cli": "https://cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary";
-};
-export type QuotaSource = keyof typeof QUOTA_ENDPOINTS;
-export declare const GEMINI_CLI_USER_AGENT_ANTIGRAVITY: "antigravity/1.12.8 (linux; x64; VSCode/1.90.0; Antigravity) google-api-nodejs-client/9.15.1";
-export declare const CLIENT_METADATA_ANTIGRAVITY: "ideType=IDE_VSCODE,platform=PLATFORM_UNSPECIFIED,pluginType=ANTIGRAVITY";
-/**
- * Default interval for quota refresh (minutes).
- * Can be overridden via config or env QUOTA_REFRESH_INTERVAL_MINUTES.
- */
-export declare const QUOTA_REFRESH_INTERVAL_MINUTES_DEFAULT: 15;
-export declare const QUOTA_REFRESH_INTERVAL_MS_DEFAULT: number;
-export declare const QUOTA_SOFT_REMAINING: number;
-export declare const QUOTA_CACHE_TTL_MS_DEFAULT: number;
-export declare const QUOTA_CACHE_FILE: string;
-export declare const QUOTA_REQUEST_TIMEOUT_MS: 10000;
-export type QuotaGroupId = "gemini-3-pro" | "gemini-3.1-pro" | "gemini-3-flash" | "gemini-2.5-pro" | "gemini-2.5-flash" | "claude-sonnet" | "claude-opus" | "gemini" | "claude-3p" | "unknown";
-export interface ResilientQuotaGroupDef {
-    id: QuotaGroupId;
-    displayNamePattern: RegExp;
-    models: readonly string[];
-    dailyLimit: number;
-    rpm: number;
-    tpm: number;
-}
-/**
- * Quota-group routing table. models.ts owns ALL model identification
- * (catalog, rosters, aliases); this table is quota-group routing derived
- * from the models.ts catalog (v2.1.16 dedup note): the ids below are the
- * quota-specific routing keys, and the antigravity-prefixed claude ids are
- * quota-route spellings with no single-id export in models.ts — kept local
- * so quota routing stays byte-identical (no behavior change).
- */
-export declare const QUOTA_GROUP_DEFS: readonly ResilientQuotaGroupDef[];
-export type QuotaWindow = "weekly" | "5h" | "daily" | "hourly" | "monthly" | string;
-export interface QuotaBucketRaw {
-    bucketId: string;
-    displayName?: string;
-    window?: QuotaWindow;
-    resetTime?: string;
-    description?: string;
-    remainingFraction?: number;
-    remaining?: number;
-    limit?: number;
-    used?: number;
-}
-export interface QuotaGroupRaw {
-    displayName?: string;
-    description?: string;
-    buckets?: QuotaBucketRaw[];
-    quotaGroup?: string;
-}
-export interface QuotaSummaryRaw {
-    groups?: QuotaGroupRaw[];
-    quotaGroup?: QuotaGroupRaw[];
-    buckets?: QuotaBucketRaw[];
-}
-export interface QuotaBucketParsed {
-    bucketId: string;
-    displayName: string;
-    window: QuotaWindow;
-    resetTime: string | null;
-    resetTimeMs: number | null;
-    remainingFraction: number;
-    remainingPercent: number;
-    isExhausted: boolean;
-    isSoftExhausted: boolean;
-    description: string;
-}
-export interface QuotaGroupParsed {
-    id: QuotaGroupId;
-    displayName: string;
-    description: string;
-    rawDisplayName: string;
-    source: QuotaSource;
-    buckets: QuotaBucketParsed[];
-    weeklyRemaining: number | null;
-    fiveHourRemaining: number | null;
-    minRemainingFraction: number;
-    minBucket: QuotaBucketParsed | null;
-    isExhausted: boolean;
-    isSoftExhausted: boolean;
-}
-export interface QuotaSummaryParsed {
-    groups: QuotaGroupParsed[];
-    fetchedAt: number;
-    expiresAt: number;
-    ttlMs: number;
-    source: QuotaSource;
-    projectId: string;
-    globalMinRemaining: number;
-    isAnyExhausted: boolean;
-    isAnySoftExhausted: boolean;
-}
-export interface QuotaCacheEntry {
-    summary: QuotaSummaryParsed;
-    raw: QuotaSummaryRaw;
-    tokenHash: string;
-    cachedAt: number;
-    expiresAt: number;
-    ttlMs: number;
-}
-export interface CheckQuotaResult {
-    allowed: boolean;
-    groupId: QuotaGroupId | null;
-    bucketId: string | null;
-    remainingFraction: number | null;
-    remainingPercent: number | null;
-    resetTime: string | null;
-    resetTimeMs: number | null;
-    reason: string;
-    isSoftThreshold: boolean;
-    isHardExhausted: boolean;
-    shouldSkipAccount: boolean;
-    source: QuotaSource;
-    group?: QuotaGroupParsed | undefined;
-    bucket?: QuotaBucketParsed | undefined;
-}
-/**
- * Adaptive TTL: the lower the remaining fraction, the shorter the TTL so
- * refresh happen sooner.
- * - <10% => 2min
- * - <20% => 5min
- * - <50% => 10min
- * - >=50% => 15min default, still honoring a nearby resetTime
- */
-export declare function computeAdaptiveTtlMs(summary: QuotaSummaryRaw | QuotaSummaryParsed, baseTtlMs?: number): number;
-export declare function getQuotaRefreshIntervalMs(configMinutes?: number): number;
-export declare function resolveQuotaGroup(model: string): QuotaGroupId;
-/**
- * Returns the group definition for a model or groupId.
- * Returns null when the groupId is unknown.
- */
-export declare function getQuotaGroup(input: string): ResilientQuotaGroupDef | null;
-/**
- * Lists every available group definition.
- */
-export declare function listQuotaGroups(): readonly ResilientQuotaGroupDef[];
-export declare function buildQuotaHeaders(token: string, source?: QuotaSource): Record<string, string>;
-export declare function parseQuotaBucket(raw: QuotaBucketRaw, source: QuotaSource): QuotaBucketParsed;
-export declare function parseQuotaGroup(raw: QuotaGroupRaw, source: QuotaSource): QuotaGroupParsed;
-/**
- * Parse principal do payload v1internal:retrieveUserQuotaSummary
- */
-export declare function parseQuotaResponse(raw: QuotaSummaryRaw, opts?: {
-    source?: QuotaSource;
-    projectId?: string;
-    fetchedAt?: number;
-    baseTtlMs?: number;
-}): QuotaSummaryParsed;
-export interface RetrieveQuotaOptions {
-    source?: QuotaSource;
-    timeoutMs?: number;
-    retries?: number;
-    baseTtlMs?: number;
-    signal?: AbortSignal;
-}
-export declare class QuotaFetchError extends Error {
-    status?: number | undefined;
-    body?: string | undefined;
-    source: QuotaSource;
-    constructor(message: string, source: QuotaSource, status?: number, body?: string);
-}
-/**
- * Direct call to the v1internal:retrieveUserQuotaSummary endpoint.
- * POST {"project": "<projectId>"}
- *
- * @param token - OAuth Bearer access_token
- * @param projectId - cloudaicompanionProject id, fallback rising-fact-p41fc
- * @param opts - source antigravity|gemini-cli, timeout, retries
- */
-export declare function retrieveUserQuotaSummary(token: string, projectId?: string, opts?: RetrieveQuotaOptions): Promise<QuotaSummaryParsed>;
-/**
- * Dual fetch: tries antigravity (daily) first, then gemini-cli as fallback.
- * Returns the merged parsed summary with the primary source.
- */
-export declare function retrieveDualQuota(token: string, projectId?: string, opts?: RetrieveQuotaOptions): Promise<{
-    antigravity: QuotaSummaryParsed | null;
-    geminiCli: QuotaSummaryParsed | null;
-    primary: QuotaSummaryParsed;
-}>;
-export declare class QuotaCacheManager {
-    private memory;
-    private requestCount;
-    private lastRefreshAt;
-    private refreshIntervalMs;
-    softThreshold: number;
-    constructor(opts?: {
-        refreshIntervalMinutes?: number;
-        softThreshold?: number;
-    });
-    private getKey;
-    getCached(token: string, projectId: string, source?: QuotaSource): QuotaSummaryParsed | null;
-    isCacheExpired(token: string, projectId: string, source?: QuotaSource): boolean;
-    setCached(token: string, projectId: string, source: QuotaSource, raw: QuotaSummaryRaw, parsed: QuotaSummaryParsed): void;
-    /**
-     * Clears the cache for a token/project or everything.
-     */
-    clear(token?: string, projectId?: string, source?: QuotaSource): void;
-    /**
-     * Background refresh without blocking the caller.
-     * Deduplicates in-flight requests per key.
-     */
-    refreshInBackground(token: string, projectId: string, source?: QuotaSource): void;
-    /**
-     * Called after each successful request to decide whether to schedule a refresh.
-     */
-    trackRequestAndMaybeRefresh(token: string, projectId: string, source?: QuotaSource): void;
-    getStats(): {
-        size: number;
-        requestCount: number;
-        lastRefreshAt: number;
-        refreshIntervalMs: number;
-    };
-}
-export declare function getQuotaCacheManager(opts?: {
-    refreshIntervalMinutes?: number | undefined;
-}): QuotaCacheManager;
-/**
- * Checks quota for a specific group.
- * Returns an allowed boolean plus metadata.
- *
- * @param token - access token
- * @param projectId - project id
- * @param group - group id ou model string (ex: "gemini-3-pro" ou "antigravity-gemini-3-pro")
- * @param opts - source, softThreshold override, useCache
- */
-export declare function checkQuota(token: string, projectId?: string, group?: string | null, opts?: {
-    source?: QuotaSource;
-    softThreshold?: number;
-    useCache?: boolean;
-    refreshIntervalMinutes?: number | undefined;
-}): Promise<CheckQuotaResult>;
-/**
- * Reports whether quota is exhausted (hard threshold).
- * Thin wrapper over checkQuota kept for compatibility.
- */
-export declare function isQuotaExhausted(token: string, projectId?: string, group?: string | null, opts?: {
-    source?: QuotaSource;
-    useCache?: boolean;
-}): Promise<boolean>;
-/**
- * Decides whether the account should be skipped (soft 90% threshold).
- * Used during multi-account rotation.
- */
-export declare function shouldSkipAccount(token: string, projectId?: string, group?: string | null, opts?: {
-    source?: QuotaSource;
-    softThreshold?: number;
-    useCache?: boolean;
-}): Promise<boolean>;
-/**
- * Lists the current parsed groups (cache first, otherwise fetch).
- */
-export declare function getQuotaGroups(token: string, projectId?: string, opts?: {
-    source?: QuotaSource;
-    useCache?: boolean;
-}): Promise<QuotaGroupParsed[]>;
-export interface QuotaManagerOptions {
-    refreshIntervalMinutes?: number;
-    softThreshold?: number;
-    hardThreshold?: number;
-    projectId?: string;
-    source?: QuotaSource;
-    enableDual?: boolean;
-}
-export declare class QuotaManager {
-    readonly projectId: string;
-    readonly source: QuotaSource;
-    readonly refreshIntervalMinutes: number;
-    readonly softThreshold: number;
-    readonly hardThreshold: number;
-    readonly enableDual: boolean;
-    private cacheMgr;
-    private token;
-    private lastGroups;
-    constructor(opts?: QuotaManagerOptions);
-    setToken(token: string): void;
-    getToken(): string | null;
-    /**
-     * Forces an immediate refresh (primary + secondary when dual).
-     */
-    refresh(token?: string, projectId?: string): Promise<QuotaSummaryParsed>;
-    /**
-     * Non-blocking background refresh.
-     */
-    refreshInBackground(token?: string, projectId?: string, source?: QuotaSource): void;
-    /**
-     * Called after each successful generateContent request.
-     */
-    notifyRequestSuccess(token?: string, projectId?: string): void;
-    checkQuota(group?: string | null, token?: string): Promise<CheckQuotaResult>;
-    isQuotaExhausted(group?: string | null, token?: string): Promise<boolean>;
-    shouldSkipAccount(group?: string | null, token?: string): Promise<boolean>;
-    getQuotaGroups(token?: string): Promise<QuotaGroupParsed[]>;
-    resolveQuotaGroup(model: string): QuotaGroupId;
-    getQuotaGroup(input: string): ResilientQuotaGroupDef | null;
-    getCacheStats(): {
-        size: number;
-        requestCount: number;
-        lastRefreshAt: number;
-        refreshIntervalMs: number;
-    };
-    clearCache(token?: string, source?: QuotaSource): void;
-}
-export declare function getDefaultQuotaManager(opts?: QuotaManagerOptions): QuotaManager;
-/**
- * Helper for the opencode plugin: verifies quota before routing a request.
- * Returns true when the request may proceed.
- */
-export declare function canProceedWithRequest(token: string, model: string, projectId?: string, opts?: {
-    source?: QuotaSource | undefined;
-    refreshIntervalMinutes?: number | undefined;
-}): Promise<{
-    allowed: boolean;
-    check: CheckQuotaResult;
-}>;
-export interface QuotaConfig {
-    quota_refresh_interval_minutes: number;
-    quota_soft_threshold_percent: number;
-    quota_hard_threshold_percent: number;
-    quota_source: QuotaSource;
-    quota_dual_enabled: boolean;
-    quota_cache_ttl_ms_default: number;
-    project_fallback: string;
-}
-export declare const DEFAULT_QUOTA_CONFIG: QuotaConfig;
-export declare function resolveQuotaConfig(partial?: Partial<QuotaConfig>): QuotaConfig;
-/**
- * Three public OAuth client IDs circulate in public binaries:
- * - 1071006060591-tmhssin2h21lcre235vtolojh4g403ep... (Antigravity primary, accounts.ts)
- * - 681255809395-oo8ft2oq6bda7b6t5a2prl1saaq1hhs... (Gemini CLI secondary)
- * - 681255809395-oo8f…b135j... (Gemini CLI official)
- * These are public client IDs (not confidential). The client secrets below are
- * likewise public in those binaries but flagged as blinded for log redaction.
- */
-/** Version fallback (governance keeps 1.19.2 as last known to bypass ban) + floor. */
-/**
- * Cloud Code Assist quota method path — the historical QUOTA_METHOD name
- * consumed by plugin.ts. v2.1.16 dedup: derived from the constants.js
- * QUOTA_ENDPOINT owner (itself derived from CODE_ASSIST_PATH_MAP
- * .RETRIEVE_USER_QUOTA_SUMMARY) instead of a duplicated path literal.
- */
-export declare const QUOTA_METHOD: "/v1internal:retrieveUserQuotaSummary";
-/**
- * SHA-256 token hash truncated to 32 hex chars (FNV-1a fallback) — the cache
- * key primitive of the live lineage-A file cache (makeCacheKey / setCached).
- */
-export declare function hashToken(token: string): string;
-declare const quotaModule: {
-    OAUTH_CLIENT_ID: string;
-    OAUTH_CLIENT_SECRET: string;
-    PROJECT_FALLBACK: "rising-fact-p41fc";
-    ENDPOINTS: {
-        readonly loadCodeAssist: "https://cloudcode-pa.googleapis.com/v1internal:loadCodeAssist";
-        readonly onboardUser: "https://cloudcode-pa.googleapis.com/v1internal:onboardUser";
-        readonly fetchAvailableModels: "https://cloudcode-pa.googleapis.com/v1internal:fetchAvailableModels";
-        readonly generateContent: "https://cloudcode-pa.googleapis.com/v1internal:generateContent";
-        readonly streamGenerateContent: "https://cloudcode-pa.googleapis.com/v1internal:streamGenerateContent";
-        readonly retrieveUserQuotaSummary: "https://cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary";
-    };
-    ENDPOINTS_DAILY: {
-        readonly loadCodeAssist: "https://daily-cloudcode-pa.googleapis.com/v1internal:loadCodeAssist";
-        readonly retrieveUserQuotaSummary: "https://daily-cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary";
-    };
-    QUOTA_ENDPOINTS: {
-        readonly antigravity: "https://daily-cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary";
-        readonly "gemini-cli": "https://cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary";
-    };
-    QUOTA_METHOD: "/v1internal:retrieveUserQuotaSummary";
-    MODELS_2026: readonly ["antigravity-gemini-3-pro", "antigravity-gemini-3.1-pro", "antigravity-gemini-3-flash", "antigravity-claude-sonnet-4-6", "antigravity-claude-opus-4-6-thinking", "gemini-2.5-flash", "gemini-2.5-pro", "gemini-3-flash-preview", "gemini-3-pro-preview", "gemini-3.1-pro-preview", "gemini-3.1-pro-preview-customtools"];
-    QUOTA_GROUP_DEFS: readonly ResilientQuotaGroupDef[];
-    QUOTA_REFRESH_INTERVAL_MINUTES_DEFAULT: 15;
-    QUOTA_SOFT_THRESHOLD: 0.9;
-    QUOTA_HARD_THRESHOLD: 0.98;
-    retrieveUserQuotaSummary: typeof retrieveUserQuotaSummary;
-    retrieveDualQuota: typeof retrieveDualQuota;
-    parseQuotaResponse: typeof parseQuotaResponse;
-    parseQuotaBucket: typeof parseQuotaBucket;
-    parseQuotaGroup: typeof parseQuotaGroup;
-    computeAdaptiveTtlMs: typeof computeAdaptiveTtlMs;
-    getQuotaRefreshIntervalMs: typeof getQuotaRefreshIntervalMs;
-    resolveQuotaGroup: typeof resolveQuotaGroup;
-    getQuotaGroup: typeof getQuotaGroup;
-    listQuotaGroups: typeof listQuotaGroups;
-    isGeminiCLIOnlyModel: typeof isGeminiCLIOnlyModel;
-    checkQuota: typeof checkQuota;
-    isQuotaExhausted: typeof isQuotaExhausted;
-    shouldSkipAccount: typeof shouldSkipAccount;
-    getQuotaGroups: typeof getQuotaGroups;
-    canProceedWithRequest: typeof canProceedWithRequest;
-    QuotaCacheManager: typeof QuotaCacheManager;
-    getQuotaCacheManager: typeof getQuotaCacheManager;
-    QuotaManager: typeof QuotaManager;
-    getDefaultQuotaManager: typeof getDefaultQuotaManager;
-    DEFAULT_QUOTA_CONFIG: QuotaConfig;
-    resolveQuotaConfig: typeof resolveQuotaConfig;
-    buildQuotaHeaders: typeof buildQuotaHeaders;
-    hashToken: typeof hashToken;
-};
-export default quotaModule;
-//# sourceMappingURL=quota.d.ts.map