@cortexkit/pi-anthropic-auth 1.2.5 → 1.3.0

package/README.md

@@ -40,7 +40,7 @@ Pi state is stored separately from OpenCode at:
 
 Override the path with `PI_ANTHROPIC_AUTH_FILE`. The package also respects `PI_AGENT_DIR` when deriving the default sidecar path.
 
-The sidecar uses the same JSON shape as the OpenCode package, including `claudeCache`, `cacheKeep`, `claudeFast`, `dump`, `relay`, and fallback `accounts` blocks.
+The sidecar uses the same JSON shape as the OpenCode package, including `routing`, `claudeCache`, `cacheKeep`, `claudeFast`, `dump`, `relay`, and fallback `accounts` blocks.
 
 ## Commands
 
@@ -64,10 +64,14 @@ The sidecar uses the same JSON shape as the OpenCode package, including `claudeC
 /claude-fast on
 /claude-fast off
 
+/claude-routing
+/claude-routing main-first
+/claude-routing fallback-first
+
 /claude-quota
 ```
 
-`/claude-quota` reports sidecar fallback account quota state from `~/.pi/agent/anthropic-auth.json`. `/claude-cachekeep HH-HH` keeps recently used hybrid-mode session caches warm during the configured local time window by sending `max_tokens: 0` pre-warm requests about five minutes before the 1-hour TTL expires. `/claude-fast on` adds Anthropic `speed: "fast"` plus the `fast-mode-2026-02-01` beta header for supported Opus models (`claude-opus-4-6` and `claude-opus-4-7`).
+`/claude-quota` reports sidecar fallback account quota state from `~/.pi/agent/anthropic-auth.json`. `/claude-routing fallback-first` prefers usable fallback accounts before the main account; `/claude-routing main-first` restores the default. `/claude-cachekeep HH-HH` keeps recently used hybrid-mode session caches warm during the configured local time window by sending `max_tokens: 0` pre-warm requests about five minutes before the 1-hour TTL expires. `/claude-fast on` adds Anthropic `speed: "fast"` plus the `fast-mode-2026-02-01` beta header for supported Opus models (`claude-opus-4-6` and `claude-opus-4-7`).
 
 ## Relay
 

package/dist/commands.js

@@ -1,4 +1,4 @@
-import { buildClaudeQuotaSummary, buildFallbackQuotaSummaries, CLAUDE_CACHE_KEEP_COMMAND_NAME, executeCache1hCommand, executeCacheKeepCommand, executeDumpCommand, executeFastModeCommand, getCache1hPersistentMode, getCacheKeepWindow, isCache1hPersistentlyEnabled, isCacheKeepHybridActive, isCacheKeepPersistentlyEnabled, isDumpPersistentlyEnabled, isFastModePersistentlyEnabled, loadAccounts, parseCache1hCommandAction, parseCacheKeepCommandAction, parseDumpCommandAction, parseFastModeCommandAction, setCache1hPersistentEnabled, setCache1hPersistentMode, setCacheKeepPersistentEnabled, setCacheKeepPersistentWindow, setDumpPersistentEnabled, setFastModePersistentEnabled, } from '@cortexkit/anthropic-auth-core';
+import { buildClaudeQuotaSummary, buildFallbackQuotaSummaries, CLAUDE_CACHE_KEEP_COMMAND_NAME, CLAUDE_ROUTING_COMMAND_NAME, executeCache1hCommand, executeCacheKeepCommand, executeDumpCommand, executeFastModeCommand, executeRoutingCommand, getCache1hPersistentMode, getCacheKeepWindow, getRoutingMode, isCache1hPersistentlyEnabled, isCacheKeepHybridActive, isCacheKeepPersistentlyEnabled, isDumpPersistentlyEnabled, isFastModePersistentlyEnabled, loadAccounts, parseCache1hCommandAction, parseCacheKeepCommandAction, parseDumpCommandAction, parseFastModeCommandAction, parseRoutingCommandAction, setCache1hPersistentEnabled, setCache1hPersistentMode, setCacheKeepPersistentEnabled, setCacheKeepPersistentWindow, setDumpPersistentEnabled, setFastModePersistentEnabled, setRoutingMode, } from '@cortexkit/anthropic-auth-core';
 import { getPiAccountStoragePath } from "./paths.js";
 function notify(ctx, message, kind = 'info') {
     ctx.ui.notify(message, kind);
@@ -99,6 +99,21 @@ export function registerCommands(pi) {
             }), action.type === 'usage' ? 'warning' : 'info');
         },
     });
+    pi.registerCommand(CLAUDE_ROUTING_COMMAND_NAME, {
+        description: 'Show or change Claude account routing mode',
+        handler: async (args, ctx) => {
+            const path = getPiAccountStoragePath();
+            let storage = await loadAccounts(path);
+            const action = parseRoutingCommandAction(args ?? '');
+            if (action.type === 'mode') {
+                storage = await setRoutingMode(action.mode, path);
+            }
+            notify(ctx, executeRoutingCommand({
+                argumentsText: args ?? '',
+                mode: getRoutingMode(storage),
+            }), action.type === 'usage' ? 'warning' : 'info');
+        },
+    });
     pi.registerCommand('claude-quota', {
         description: 'Show Claude quota state for fallback accounts',
         handler: async (_args, ctx) => {

package/dist/stream.js

@@ -1,4 +1,4 @@
-import { applyClaudeCodeHeaders, CACHE_KEEP_EXTENDED_TTL_BETA, CacheKeepManager, FAST_MODE_BETA, FallbackAccountManager, getCache1hPersistentMode, getRelayConfig, isCache1hPersistentlyEnabled, isCacheKeepHybridActive, isFastModePersistentlyEnabled, loadAccounts, mergeAnthropicBetas, resolveClaudeCodeIdentity, sendViaRelay, shouldFallbackStatus, } from '@cortexkit/anthropic-auth-core';
+import { applyClaudeCodeHeaders, CACHE_KEEP_EXTENDED_TTL_BETA, CacheKeepManager, FAST_MODE_BETA, FallbackAccountManager, getCache1hPersistentMode, getRelayConfig, getRoutingMode, isCache1hPersistentlyEnabled, isCacheKeepHybridActive, isFastModePersistentlyEnabled, loadAccounts, mergeAnthropicBetas, resolveClaudeCodeIdentity, sendViaRelay, shouldFallbackStatus, } from '@cortexkit/anthropic-auth-core';
 import { calculateCost, createAssistantMessageEventStream, } from '@earendil-works/pi-ai';
 import { buildAnthropicRequest, fromClaudeCodeToolName } from "./convert.js";
 import { getPiAccountStoragePath } from "./paths.js";
@@ -168,6 +168,32 @@ async function executeWithFallback(options) {
         configPath: options.storagePath,
     });
     const storage = await loadAccounts(options.storagePath);
+    async function tryFallbackAccounts() {
+        for (const account of await manager.getUsableFallbackAccounts(storage)) {
+            if (!account.access)
+                continue;
+            const response = await sendAnthropicRequest({
+                ...options,
+                accessToken: account.access,
+            });
+            const preflight = await firstStreamingError(response);
+            if (preflight instanceof Response && preflight.ok) {
+                await manager.markUsed(account);
+                return preflight;
+            }
+            if (preflight instanceof Response &&
+                !shouldFallbackStatus(preflight.status, storage)) {
+                return preflight;
+            }
+        }
+        return null;
+    }
+    const fallbackFirst = getRoutingMode(storage) === 'fallback-first';
+    if (fallbackFirst) {
+        const fallback = await tryFallbackAccounts();
+        if (fallback)
+            return fallback;
+    }
     const primary = await sendAnthropicRequest({
         ...options,
         accessToken: options.primaryAccessToken,
@@ -177,22 +203,10 @@ async function executeWithFallback(options) {
         if (!shouldFallbackStatus(primaryPreflight.status, storage))
             return primaryPreflight;
     }
-    for (const account of await manager.getUsableFallbackAccounts()) {
-        if (!account.access)
-            continue;
-        const response = await sendAnthropicRequest({
-            ...options,
-            accessToken: account.access,
-        });
-        const preflight = await firstStreamingError(response);
-        if (preflight instanceof Response && preflight.ok) {
-            await manager.markUsed(account);
-            return preflight;
-        }
-        if (preflight instanceof Response &&
-            !shouldFallbackStatus(preflight.status, storage)) {
-            return preflight;
-        }
+    if (!fallbackFirst) {
+        const fallback = await tryFallbackAccounts();
+        if (fallback)
+            return fallback;
     }
     return primaryPreflight instanceof Response ? primaryPreflight : primary;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/pi-anthropic-auth",
-  "version": "1.2.5",
+  "version": "1.3.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -35,7 +35,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@cortexkit/anthropic-auth-core": "1.2.5"
+    "@cortexkit/anthropic-auth-core": "1.3.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",