@cortexkit/anthropic-auth-core 1.10.3 → 1.11.0

package/dist/accounts.d.ts

@@ -1,4 +1,5 @@
 import { type Cache1hMode } from './constants.ts';
+import { type LogLevel } from './logger.ts';
 export declare const ACCOUNT_FILE_NAME = "anthropic-auth.json";
 export declare const ACCOUNT_STATE_FILE_NAME = "anthropic-auth-state.json";
 export declare const QUOTA_URL = "https://api.anthropic.com/api/oauth/usage";
@@ -36,6 +37,22 @@ export type AccountOperationError = {
     nextRetryAt?: number;
     retryCount?: number;
     tokenHash?: string;
+    /**
+     * HTTP status of the underlying refresh/quota failure, when known. Lets
+     * consumers distinguish a permanently-dead token (400 invalid_grant →
+     * re-login) from a transient failure (429/5xx → recovers) without a delay
+     * heuristic. Absent on errors persisted before this field existed.
+     */
+    status?: number;
+    /**
+     * Explicit dead-token discriminator, set at construction. True ONLY when the
+     * refresh endpoint returned 400 invalid_grant (token is genuinely dead →
+     * re-login). False for transient failures AND for retry-exhausted/network
+     * errors that get a long backoff but are NOT dead — so they are not nagged
+     * for re-login. Absent on errors persisted before this field existed (those
+     * fall back to status / the 24h-delay heuristic).
+     */
+    permanent?: boolean;
 };
 export type AccountQuotaWindow = {
     usedPercent: number;
@@ -91,6 +108,9 @@ export type AccountStorage = {
     dump?: {
         enabled?: boolean;
     };
+    logging?: {
+        level?: LogLevel;
+    };
     claudeFast?: {
         enabled?: boolean;
     };
@@ -106,6 +126,7 @@ export type AccountStorage = {
         enabled?: boolean;
         startHour?: number;
         endHour?: number;
+        subagents?: boolean;
     };
     relay?: {
         enabled?: boolean;
@@ -157,6 +178,7 @@ export type AccountRefreshError = {
 };
 export declare function getAccountStoragePath(): string;
 export declare function getAccountStatePath(configPath?: string): string;
+export declare function createEmptyStorage(): AccountStorage;
 export declare function loadAccounts(path?: string): Promise<AccountStorage | null>;
 export declare function saveAccounts(storage: AccountStorage, path?: string): Promise<void>;
 export declare function saveAccountState(storage: AccountStorage, path?: string, scope?: AccountStateSaveScope): Promise<void>;
@@ -167,6 +189,7 @@ export declare function acquireRefreshFileLock(options: {
     now?: () => number;
     renew?: boolean;
     renewIntervalMs?: number;
+    onStep?: (step: 'stale-marker-stat' | 'stale-marker-claimed' | 'stale-lock-confirmed' | 'eviction-marker-acquired') => void | Promise<void>;
 }): Promise<{
     release: () => Promise<void>;
 } | null>;
@@ -180,6 +203,8 @@ export declare function isFastModePersistentlyEnabled(storage: AccountStorage |
 export declare function setFastModePersistentEnabled(enabled: boolean, path?: string): Promise<AccountStorage>;
 export declare function setCacheKeepPersistentWindow(startHour: number, endHour: number, path?: string): Promise<AccountStorage>;
 export declare function setCacheKeepPersistentEnabled(enabled: boolean, path?: string): Promise<AccountStorage>;
+export declare function isCacheKeepSubagentsEnabled(storage: AccountStorage | null): boolean;
+export declare function setCacheKeepSubagentsEnabled(enabled: boolean, path?: string): Promise<AccountStorage>;
 export declare function shouldFallbackStatus(status: number, storage: AccountStorage | null): boolean;
 export declare function getRefreshIntervalMs(storage: AccountStorage | null): number;
 export declare function hashRefreshToken(refreshToken: string): string;
@@ -189,8 +214,25 @@ export declare function buildRefreshOperationError(input: {
     refreshToken: string;
     previous?: AccountOperationError;
 }): AccountOperationError;
+/**
+ * True when a refresh error means the token is permanently dead and the account
+ * needs a re-login (vs a transient failure that recovers).
+ *
+ * Precedence:
+ *  1. the explicit `permanent` flag (set at construction from 400 invalid_grant)
+ *     — the authoritative signal; correctly classifies a retry-exhausted/network
+ *     error (long backoff, but NOT dead) as non-permanent;
+ *  2. else the captured HTTP `status` — 400 (for errors built before `permanent`
+ *     existed but after `status`);
+ *  3. else the legacy 24h-delay heuristic — back-compat ONLY for errors persisted
+ *     before either field existed (e.g. an operator's already-dead token: no
+ *     status, ~24h backoff). It still flags those until the next refresh restamps
+ *     the error with the explicit field.
+ */
+export declare function isPermanentRefreshError(error: AccountOperationError | undefined): boolean;
 export declare function refreshBackoffActive(error: AccountOperationError | undefined, refreshToken: string | undefined, now: number): boolean;
 export declare function formatRefreshBackoffMessage(error: AccountOperationError, now: number): string;
+export declare function isQuotaPolicyAuthError(error: unknown): boolean;
 export declare function buildQuotaOperationError(input: {
     error: unknown;
     now: number;
@@ -199,6 +241,8 @@ export declare function buildQuotaOperationError(input: {
 export declare function quotaBackoffActive(error: AccountOperationError | undefined, now: number): boolean;
 export declare function formatQuotaBackoffMessage(error: AccountOperationError, now: number): string;
 export declare function getQuotaCheckIntervalMs(storage: AccountStorage | null): number;
+export declare function getPersistedLogLevel(storage: AccountStorage | null): LogLevel | undefined;
+export declare function setLogLevelPersistent(level: LogLevel, path?: string): Promise<void>;
 export declare function getPersistedMainQuota(storage: AccountStorage | null): {
     quota: OAuthQuotaSnapshot;
     checkedAt: number;
@@ -226,6 +270,10 @@ export declare function killswitchRetryAfterSeconds(mainQuota: OAuthQuotaSnapsho
 }>, now: number): number;
 export declare function getKillswitchConfig(storage: AccountStorage | null): KillswitchConfig;
 export declare function setKillswitchPersistent(config: KillswitchConfig, path?: string): Promise<AccountStorage>;
+export declare function removeAccountPersistent(id: string, path?: string): Promise<boolean>;
+export declare function reorderAccountsPersistent(orderedIds: string[], path?: string): Promise<void>;
+export declare function setAccountEnabledPersistent(id: string, enabled: boolean, path?: string): Promise<boolean>;
+export declare function addAccountPersistent(account: FallbackAccount, path?: string): Promise<void>;
 export declare function getQuotaNextRefreshAt(quota: OAuthQuotaSnapshot | undefined, storage: AccountStorage | null, now: number): number;
 export declare function fetchOAuthQuotaSnapshot(input: {
     accessToken: string;
@@ -235,6 +283,10 @@ export declare function fetchOAuthQuotaSnapshot(input: {
     five_hour: AccountQuotaWindow | undefined;
     seven_day: AccountQuotaWindow | undefined;
 }>;
+export declare function upsertAccount(storage: AccountStorage, account: FallbackAccount): void;
+export declare function removeAccount(storage: AccountStorage, id: string): boolean;
+export declare function reorderAccounts(storage: AccountStorage, orderedIds: string[]): void;
+export declare function setAccountEnabled(storage: AccountStorage, id: string, enabled: boolean): boolean;
 export declare class FallbackAccountManager {
     private readonly now;
     private readonly fetchImpl;