oc-codex-multi-auth 6.0.0

package/dist/lib/accounts.d.ts

@@ -0,0 +1,134 @@
+import type { Auth } from "@opencode-ai/sdk";
+import { type AccountStorageV3, type CooldownReason, type RateLimitStateV3 } from "./storage.js";
+import type { AccountIdSource, OAuthAuthDetails } from "./types.js";
+import { type ModelFamily } from "./prompts/codex.js";
+import { type HybridSelectionOptions } from "./rotation.js";
+export { extractAccountId, extractAccountEmail, getAccountIdCandidates, selectBestAccountCandidate, shouldUpdateAccountIdFromToken, resolveRequestAccountId, sanitizeEmail, type AccountIdCandidate, } from "./auth/token-utils.js";
+export { parseRateLimitReason, getQuotaKey, clampNonNegativeInt, clearExpiredRateLimits, isRateLimitedForQuotaKey, isRateLimitedForFamily, formatWaitTime, type QuotaKey, type BaseQuotaKey, type RateLimitReason, type RateLimitState, type RateLimitedEntity, } from "./accounts/rate-limits.js";
+import { type RateLimitReason } from "./accounts/rate-limits.js";
+export type CodexCliTokenCacheEntry = {
+    accessToken: string;
+    expiresAt?: number;
+    refreshToken?: string;
+    accountId?: string;
+};
+export declare function lookupCodexCliTokensByEmail(email: string | undefined): Promise<CodexCliTokenCacheEntry | null>;
+export interface ManagedAccount {
+    index: number;
+    accountId?: string;
+    organizationId?: string;
+    accountIdSource?: AccountIdSource;
+    accountLabel?: string;
+    accountTags?: string[];
+    accountNote?: string;
+    email?: string;
+    refreshToken: string;
+    enabled?: boolean;
+    access?: string;
+    expires?: number;
+    addedAt: number;
+    lastUsed: number;
+    lastSwitchReason?: "rate-limit" | "initial" | "rotation";
+    lastRateLimitReason?: RateLimitReason;
+    rateLimitResetTimes: RateLimitStateV3;
+    coolingDownUntil?: number;
+    cooldownReason?: CooldownReason;
+}
+export interface AccountSelectionExplainability {
+    index: number;
+    enabled: boolean;
+    isCurrentForFamily: boolean;
+    eligible: boolean;
+    reasons: string[];
+    healthScore: number;
+    tokensAvailable: number;
+    rateLimitedUntil?: number;
+    coolingDownUntil?: number;
+    cooldownReason?: CooldownReason;
+    lastUsed: number;
+}
+export declare class AccountManager {
+    private accounts;
+    private cursorByFamily;
+    private currentAccountIndexByFamily;
+    private lastToastAccountIndex;
+    private lastToastTime;
+    private saveDebounceTimer;
+    private pendingSave;
+    private authFailuresByRefreshToken;
+    static loadFromDisk(authFallback?: OAuthAuthDetails): Promise<AccountManager>;
+    hasRefreshToken(refreshToken: string): boolean;
+    private hydrateFromCodexCli;
+    constructor(authFallback?: OAuthAuthDetails, stored?: AccountStorageV3 | null);
+    getAccountCount(): number;
+    getActiveIndex(): number;
+    getActiveIndexForFamily(family: ModelFamily): number;
+    getAccountsSnapshot(): ManagedAccount[];
+    getSelectionExplainability(family: ModelFamily, model?: string | null, now?: number): AccountSelectionExplainability[];
+    setActiveIndex(index: number): ManagedAccount | null;
+    getCurrentAccount(): ManagedAccount | null;
+    getCurrentAccountForFamily(family: ModelFamily): ManagedAccount | null;
+    getCurrentOrNext(): ManagedAccount | null;
+    getCurrentOrNextForFamily(family: ModelFamily, model?: string | null): ManagedAccount | null;
+    getNextForFamily(family: ModelFamily, model?: string | null): ManagedAccount | null;
+    getCurrentOrNextForFamilyHybrid(family: ModelFamily, model?: string | null, options?: HybridSelectionOptions): ManagedAccount | null;
+    recordSuccess(account: ManagedAccount, family: ModelFamily, model?: string | null): void;
+    recordRateLimit(account: ManagedAccount, family: ModelFamily, model?: string | null): void;
+    recordFailure(account: ManagedAccount, family: ModelFamily, model?: string | null): void;
+    consumeToken(account: ManagedAccount, family: ModelFamily, model?: string | null): boolean;
+    /**
+     * Refund a token consumed within the refund window (30 seconds).
+     * Use this when a request fails due to network errors (not rate limits).
+     * @returns true if refund was successful, false if no valid consumption found
+     */
+    refundToken(account: ManagedAccount, family: ModelFamily, model?: string | null): boolean;
+    markSwitched(account: ManagedAccount, reason: "rate-limit" | "initial" | "rotation", family: ModelFamily): void;
+    markRateLimited(account: ManagedAccount, retryAfterMs: number, family: ModelFamily, model?: string | null): void;
+    markRateLimitedWithReason(account: ManagedAccount, retryAfterMs: number, family: ModelFamily, reason: RateLimitReason, model?: string | null): void;
+    markAccountCoolingDown(account: ManagedAccount, cooldownMs: number, reason: CooldownReason): void;
+    /**
+     * Mark every in-memory account sharing a refresh token as cooling down.
+     * @returns Number of live accounts updated.
+     */
+    markAccountsWithRefreshTokenCoolingDown(refreshToken: string, cooldownMs: number, reason: CooldownReason): number;
+    isAccountCoolingDown(account: ManagedAccount): boolean;
+    clearAccountCooldown(account: ManagedAccount): void;
+    incrementAuthFailures(account: ManagedAccount): number;
+    /**
+     * Clear the authentication failure counter for the given account's refresh token.
+     *
+     * Notes:
+     * - Failure counts are tracked per refresh token (not per account), so this clears
+     *   shared failure state for all org variants that reuse the same token.
+     * - Failure counts are in-memory only for the current AccountManager instance.
+     */
+    clearAuthFailures(account: ManagedAccount): void;
+    shouldShowAccountToast(accountIndex: number, debounceMs?: number): boolean;
+    markToastShown(accountIndex: number): void;
+    updateFromAuth(account: ManagedAccount, auth: OAuthAuthDetails): void;
+    toAuthDetails(account: ManagedAccount): Auth;
+    getMinWaitTime(): number;
+    getMinWaitTimeForFamily(family: ModelFamily, model?: string | null): number;
+    removeAccount(account: ManagedAccount): boolean;
+    removeAccountByIndex(index: number): boolean;
+    /**
+     * Remove all accounts that share the same refreshToken as the given account.
+     * This is used when auth refresh fails to remove all org variants together.
+     * @returns Number of accounts removed
+     */
+    removeAccountsWithSameRefreshToken(account: ManagedAccount): number;
+    setAccountEnabled(index: number, enabled: boolean): ManagedAccount | null;
+    saveToDisk(): Promise<void>;
+    saveToDiskDebounced(delayMs?: number): void;
+    flushPendingSave(): Promise<void>;
+}
+export declare function formatAccountLabel(account: {
+    email?: string;
+    accountId?: string;
+    accountLabel?: string;
+} | undefined, index: number): string;
+export declare function formatCooldown(account: {
+    coolingDownUntil?: number;
+    cooldownReason?: string;
+}, now?: number): string | null;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/lib/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../lib/accounts.ts"],"names":[],"mappings":"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"}