@cortexkit/anthropic-auth-core 1.19.1 → 1.21.0

package/dist/quotas.d.ts

@@ -11,13 +11,13 @@ export type QuotaAccountSummary = {
 };
 export declare function formatQuotaMoney(money: QuotaMoney): string;
 export declare function buildFallbackQuotaSummaries(storage: AccountStorage | null, errors?: ReadonlyMap<string, string>): {
-    error?: string | undefined;
-    lastRefreshedAt: number | undefined;
-    tierLabel?: string | undefined;
     name: string;
-    role: "fallback";
+    role: 'fallback';
     enabled: boolean;
     quota: OAuthQuotaSnapshot | undefined;
+    tierLabel?: string | undefined;
+    lastRefreshedAt: number | undefined;
+    error?: string | undefined;
 }[];
 export declare function buildClaudeQuotaSummary(input: {
     accounts: QuotaAccountSummary[];

package/dist/quotas.js

@@ -1,5 +1,5 @@
-import { isOAuthAccount } from "./accounts.js";
-import { formatOAuthAccountTier } from "./oauth-profile.js";
+import { isOAuthAccount } from './accounts.js';
+import { formatOAuthAccountTier } from './oauth-profile.js';
 export const CLAUDE_QUOTAS_COMMAND_NAME = 'claude-quota';
 const WINDOW_LABELS = {
     five_hour: '5h',

package/dist/relay.d.ts

@@ -31,6 +31,8 @@ export declare function sendViaRelay(options: {
      * within an attempt are ignored.
      */
     onResponseHeaders?: (headers: Headers) => void;
+    dumpTag?: import('./dump.ts').DumpTag;
+    onDumpCreated?: (handle: import('./dump.ts').DumpHandle) => void;
     setTimeoutImpl?: typeof globalThis.setTimeout;
     clearTimeoutImpl?: typeof globalThis.clearTimeout;
 }): Promise<Response>;

package/dist/relay.js

@@ -1,7 +1,7 @@
 import { Buffer } from 'node:buffer';
 import { createHash, randomBytes } from 'node:crypto';
-import { dumpRelayRequest } from "./dump.js";
-import { relayLog } from "./logger.js";
+import { dumpRelayRequest } from './dump.js';
+import { relayLog } from './logger.js';
 class RelayStateMismatchError extends Error {
 }
 class RelayWebSocketConnectionResetError extends Error {
@@ -752,7 +752,7 @@ function getPersistentRelaySession(config, affinity, timers) {
     return session;
 }
 export async function sendViaRelay(options) {
-    const { config, input, init, headers, body, fallback, affinity: explicitAffinity, optimisticResponse, onResponseHeaders, setTimeoutImpl = globalThis.setTimeout, clearTimeoutImpl = globalThis.clearTimeout, } = options;
+    const { config, input, init, headers, body, fallback, affinity: explicitAffinity, optimisticResponse, onResponseHeaders, dumpTag, onDumpCreated, setTimeoutImpl = globalThis.setTimeout, clearTimeoutImpl = globalThis.clearTimeout, } = options;
     if (!config || !isRelayableAnthropicRequest(input, body))
         return fallback();
     const affinity = explicitAffinity ||
@@ -848,7 +848,7 @@ export async function sendViaRelay(options) {
         });
         relayLog(`used relay transport=${result.transport} protocol=${result.protocol} mode=${result.payload.mode} status=${result.response.status} session=${shortAffinity(affinity)} bodyBytes=${bodyText.length} relayBytes=${actualPayloadBytes}`);
         const dumpStart = perfNowMs();
-        await dumpRelayRequest({
+        const dumpHandle = await dumpRelayRequest({
             affinity,
             transport: result.transport,
             protocol: result.protocol,
@@ -858,7 +858,13 @@ export async function sendViaRelay(options) {
             previousBodyText: previous?.body,
             payload: result.payload,
             relayBytes: actualPayloadBytes,
+            tag: dumpTag,
         });
+        try {
+            if (dumpHandle)
+                onDumpCreated?.(dumpHandle);
+        }
+        catch { }
         relayPerfLog('dump', {
             session: shortAffinity(affinity),
             ms: formatMs(perfNowMs() - dumpStart),

package/dist/routing.d.ts

@@ -1,6 +1,6 @@
 import { type AccountStorage, type RoutingMode } from './accounts.ts';
 export declare const CLAUDE_ROUTING_COMMAND_NAME = "claude-routing";
-export declare const ROUTING_MODES: readonly ["main-first", "fallback-first", "sticky-balanced"];
+export declare const ROUTING_MODES: readonly ['main-first', 'fallback-first', 'sticky-balanced'];
 export declare const DEFAULT_ROUTING_MODE: RoutingMode;
 type RoutingCommandAction = {
     type: 'status';

package/dist/routing.js

@@ -1,4 +1,4 @@
-import { createEmptyStorage, getAccountStoragePath, loadAccounts, saveAccounts, } from "./accounts.js";
+import { createEmptyStorage, getAccountStoragePath, loadAccounts, saveAccounts, } from './accounts.js';
 export const CLAUDE_ROUTING_COMMAND_NAME = 'claude-routing';
 export const ROUTING_MODES = [
     'main-first',

package/dist/start.d.ts

@@ -0,0 +1,13 @@
+export declare const CLAUDE_START_COMMAND_NAME = "claude-start";
+export type LaneStartCommandAction = {
+    type: 'fire';
+} | {
+    type: 'usage';
+};
+export declare function parseLaneStartCommandAction(input: string): LaneStartCommandAction;
+export declare function executeLaneStartCommand(input: {
+    argumentsText: string;
+}): {
+    action: LaneStartCommandAction;
+    text: string;
+};

package/dist/start.js

@@ -0,0 +1,29 @@
+export const CLAUDE_START_COMMAND_NAME = 'claude-start';
+const START_STATUS_TITLE = '## Claude Lane Start Status';
+const START_QUEUED_TITLE = '## Claude Lane Start Queued';
+const START_USAGE_TITLE = '## Claude Lane Start Usage';
+const START_USAGE = 'Usage: `/claude-start`.';
+export function parseLaneStartCommandAction(input) {
+    const normalized = input.trim().split(/\s+/).filter(Boolean);
+    if (normalized.length === 0)
+        return { type: 'fire' };
+    return { type: 'usage' };
+}
+export function executeLaneStartCommand(input) {
+    const action = parseLaneStartCommandAction(input.argumentsText);
+    if (action.type === 'fire') {
+        return {
+            action,
+            text: [
+                START_QUEUED_TITLE,
+                '',
+                '- Queued an explicit lane-start request.',
+                '- This is a billed request: the one-token limit does not remove prompt-cache read or write charges.',
+            ].join('\n'),
+        };
+    }
+    return {
+        action,
+        text: [START_USAGE_TITLE, '', START_USAGE, '', START_STATUS_TITLE].join('\n'),
+    };
+}

package/dist/sticky-routing.d.ts

@@ -3,9 +3,21 @@ export declare const STICKY_ROUTING_MAIN_ACCOUNT_ID = "main";
 export declare const STICKY_ROUTING_SHORT_RESET_GRACE_MS: number;
 export declare const STICKY_ROUTING_ASSIGNMENT_TTL_MS: number;
 export type StickyRouteFamily = 'fable' | 'opus' | 'general';
-export type StickyRouteCandidate = {
+export type IdentityState = {
+    kind: 'known';
     accountId: string;
+} | {
+    kind: 'unknown';
+};
+export type QuotaState = {
+    kind: 'known';
     quota: OAuthQuotaSnapshot;
+} | {
+    kind: 'unknown';
+};
+export type StickyRouteCandidate = {
+    accountId: string;
+    quota: OAuthQuotaSnapshot | QuotaState;
     order: number;
 };
 export type StickyRouteAssignment = {
@@ -40,6 +52,7 @@ export type StickyQuotaFailureDecision = {
  */
 export declare function createStickyNoRouteResponse(input: {
     mainRefreshError?: AccountOperationError;
+    fallbackReauthLabels?: readonly string[];
     routeQuotas: readonly OAuthQuotaSnapshot[];
     modelId?: string;
     now?: number;
@@ -55,7 +68,7 @@ export declare function stickyRouteCandidateWeight(input: {
 }): number;
 export declare function stickyRouteKnownFableExhausted(candidate: StickyRouteCandidate, storage: AccountStorage | null, now?: number): boolean;
 export declare function decideStickyQuotaFailure(input: {
-    quota: OAuthQuotaSnapshot | undefined;
+    quota: OAuthQuotaSnapshot | QuotaState | undefined;
     modelId?: string;
     now?: number;
 }): StickyQuotaFailureDecision;

package/dist/sticky-routing.js

@@ -1,8 +1,8 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
 import { basename, dirname, join } from 'node:path';
-import { acquireRefreshFileLock, getKillswitchThresholdsForAccount, getQuotaCheckIntervalMs, getQuotaMinimumRemainingThresholds, getScopedQuotaWindowForModel, isKillswitchEnabled, isPermanentRefreshError, killswitchRetryAfterSeconds, quotaSnapshotPassesModelScope, } from "./accounts.js";
-import { isClaudeFableOrMythos5Model } from "./models.js";
+import { acquireRefreshFileLock, getKillswitchThresholdsForAccount, getQuotaCheckIntervalMs, getQuotaMinimumRemainingThresholds, getScopedQuotaWindowForModel, isKillswitchEnabled, isPermanentRefreshError, killswitchRetryAfterSeconds, quotaSnapshotPassesModelScope, } from './accounts.js';
+import { isClaudeFableOrMythos5Model } from './models.js';
 export const STICKY_ROUTING_MAIN_ACCOUNT_ID = 'main';
 export const STICKY_ROUTING_SHORT_RESET_GRACE_MS = 15 * 60_000;
 export const STICKY_ROUTING_ASSIGNMENT_TTL_MS = 7 * 24 * 60 * 60_000;
@@ -24,13 +24,23 @@ export function createStickyNoRouteResponse(input) {
             .map((quota) => getScopedQuotaWindowForModel(quota, modelId))
             .find(Boolean)?.modelName
         : undefined;
+    let authenticationMessage;
     if (isPermanentRefreshError(input.mainRefreshError)) {
-        const message = modelName
+        authenticationMessage = modelName
             ? `Main Claude OAuth account requires re-login, and no fallback OAuth account is currently routable for ${modelName}.`
             : 'Main Claude OAuth account requires re-login, and no fallback OAuth account is currently routable.';
+    }
+    else if (input.fallbackReauthLabels?.length) {
+        const scope = modelName ? ` for ${modelName}` : '';
+        authenticationMessage = `No OAuth account is currently routable${scope}. Fallback Claude OAuth accounts require re-login: ${input.fallbackReauthLabels.join(', ')}.`;
+    }
+    if (authenticationMessage) {
         return new Response(JSON.stringify({
             type: 'error',
-            error: { type: 'authentication_error', message },
+            error: {
+                type: 'authentication_error',
+                message: authenticationMessage,
+            },
         }), {
             status: 401,
             headers: { 'content-type': 'application/json' },
@@ -126,6 +136,13 @@ export function stickyQuotaSnapshotIsFresh(quota, storage, now = Date.now(), mod
 function snapshotCheckedAt(quota) {
     return Math.max(quota.checkedAt ?? 0, quota.five_hour?.checkedAt ?? 0, quota.seven_day?.checkedAt ?? 0, ...(quota.scoped ?? []).map((window) => window.checkedAt ?? 0));
 }
+function knownQuota(quota) {
+    if (!quota)
+        return undefined;
+    if ('kind' in quota)
+        return quota.kind === 'known' ? quota.quota : undefined;
+    return quota;
+}
 function remainingThreshold(storage, accountId, key) {
     const quotaMinimum = getQuotaMinimumRemainingThresholds(storage);
     const quotaThreshold = key === 'five_hour'
@@ -160,18 +177,21 @@ export function stickyRouteFamilyForModel(model) {
 export function stickyRouteCandidateWeight(input) {
     const now = input.now ?? Date.now();
     const { candidate, storage } = input;
-    if (!stickyQuotaSnapshotIsFresh(candidate.quota, storage, now, input.modelId)) {
+    const quota = knownQuota(candidate.quota);
+    if (!quota)
+        return 0;
+    if (!stickyQuotaSnapshotIsFresh(quota, storage, now, input.modelId)) {
         return 0;
     }
     const weights = [];
     for (const key of ['five_hour', 'seven_day']) {
-        const window = candidate.quota[key];
+        const window = quota[key];
         if (!window || !Number.isFinite(window.remainingPercent))
             return 0;
         weights.push(sustainableWindowWeight(window.remainingPercent, remainingThreshold(storage, candidate.accountId, key), window.resetsAt, now));
     }
     if (input.family === 'fable') {
-        const window = getScopedQuotaWindowForModel(candidate.quota, input.modelId);
+        const window = getScopedQuotaWindowForModel(quota, input.modelId);
         if (window && Number.isFinite(window.remainingPercent)) {
             weights.push(sustainableWindowWeight(window.remainingPercent, remainingThreshold(storage, candidate.accountId, 'scoped'), window.resetsAt, now));
         }
@@ -179,29 +199,31 @@ export function stickyRouteCandidateWeight(input) {
     return Math.min(...weights);
 }
 export function stickyRouteKnownFableExhausted(candidate, storage, now = Date.now()) {
-    const window = getScopedQuotaWindowForModel(candidate.quota, 'claude-fable-5');
+    const quota = knownQuota(candidate.quota);
+    const window = getScopedQuotaWindowForModel(quota, 'claude-fable-5');
     return Boolean(window &&
-        stickyQuotaSnapshotIsFresh(candidate.quota, storage, now, 'claude-fable-5') &&
+        stickyQuotaSnapshotIsFresh(quota, storage, now, 'claude-fable-5') &&
         Number.isFinite(window.remainingPercent) &&
         window.remainingPercent <= 0);
 }
 export function decideStickyQuotaFailure(input) {
     const now = input.now ?? Date.now();
-    if (!input.quota)
+    const quota = knownQuota(input.quota);
+    if (!quota)
         return { action: 'retain', reason: 'unknown' };
-    const scoped = getScopedQuotaWindowForModel(input.quota, input.modelId);
+    const scoped = getScopedQuotaWindowForModel(quota, input.modelId);
     if (scoped &&
         Number.isFinite(scoped.remainingPercent) &&
         scoped.remainingPercent <= 0) {
         return { action: 'migrate', reason: 'model-scoped' };
     }
-    const sevenDay = input.quota.seven_day;
+    const sevenDay = quota.seven_day;
     if (sevenDay &&
         Number.isFinite(sevenDay.remainingPercent) &&
         sevenDay.remainingPercent <= 0) {
         return { action: 'migrate', reason: 'seven-day' };
     }
-    const fiveHour = input.quota.five_hour;
+    const fiveHour = quota.five_hour;
     if (fiveHour &&
         Number.isFinite(fiveHour.remainingPercent) &&
         fiveHour.remainingPercent <= 0) {
@@ -376,14 +398,18 @@ export class StickySessionRouter {
             });
             return weight > 0 ? [{ candidate, weight }] : [];
         });
-        if (weighted.length === 0)
-            return undefined;
+        if (weighted.length === 0 &&
+            candidates.every((candidate) => !knownQuota(candidate.quota))) {
+            return [...candidates].sort((left, right) => left.order - right.order ||
+                left.accountId.localeCompare(right.accountId))[0];
+        }
         const pendingBytes = new Map();
         for (const assignment of Object.values(input.state.assignments)) {
             const candidate = weighted.find((entry) => entry.candidate.accountId === assignment.accountId)?.candidate;
             if (!candidate)
                 continue;
-            if (assignment.quotaCheckedAt !== snapshotCheckedAt(candidate.quota))
+            const quota = knownQuota(candidate.quota);
+            if (quota && assignment.quotaCheckedAt !== snapshotCheckedAt(quota))
                 continue;
             pendingBytes.set(assignment.accountId, (pendingBytes.get(assignment.accountId) ?? 0) +
                 assignment.initialInputBytes);
@@ -456,13 +482,14 @@ export class StickySessionRouter {
                 return null;
             }
             const now = this.now();
+            const selectedQuota = knownQuota(selected.quota);
             const assignment = {
                 accountId: selected.accountId,
                 family: input.family,
                 assignedAt: now,
                 lastSeenAt: now,
                 initialInputBytes: Math.max(1, input.inputBytes),
-                quotaCheckedAt: snapshotCheckedAt(selected.quota),
+                quotaCheckedAt: selectedQuota ? snapshotCheckedAt(selectedQuota) : 0,
             };
             state.assignments[key] = assignment;
             await this.writeState(state);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/anthropic-auth-core",
-  "version": "1.19.1",
+  "version": "1.21.0",
   "type": "module",
   "repository": {
     "type": "git",