@cortexkit/anthropic-auth-core 1.2.5 → 1.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @cortexkit/anthropic-auth-core
 
-Shared Anthropic OAuth, quota, cache, cache-keepalive, fast mode, relay, dump, and request-signing helpers used by CortexKit's OpenCode and Pi integrations.
+Shared Anthropic OAuth, quota, routing, cache, cache-keepalive, fast mode, relay, dump, and request-signing helpers used by CortexKit's OpenCode and Pi integrations.
 
 User-facing packages:
 

package/dist/accounts.d.ts

@@ -30,12 +30,16 @@ export type AccountQuotaWindow = {
     resetsAt?: string;
     checkedAt: number;
 };
+export type RoutingMode = 'main-first' | 'fallback-first';
 export type AccountStorage = {
     version: 1;
     main?: {
         type: 'opencode';
         provider: 'anthropic';
     };
+    routing?: {
+        mode?: RoutingMode;
+    };
     fallbackOn?: number[];
     refresh?: {
         enabled?: boolean;

package/dist/accounts.js

@@ -114,6 +114,7 @@ function normalizeStorage(value) {
     return {
         version: 1,
         main: { type: 'opencode', provider: 'anthropic' },
+        routing: isRecord(value.routing) ? value.routing : undefined,
         fallbackOn: Array.isArray(value.fallbackOn)
             ? value.fallbackOn.filter((status) => Number.isInteger(status))
             : undefined,

package/dist/index.d.ts

@@ -11,3 +11,4 @@ export * from './logger.ts';
 export * from './pkce.ts';
 export * from './quotas.ts';
 export * from './relay.ts';
+export * from './routing.ts';

package/dist/index.js

@@ -11,3 +11,4 @@ export * from "./logger.js";
 export * from "./pkce.js";
 export * from "./quotas.js";
 export * from "./relay.js";
+export * from "./routing.js";

package/dist/routing.d.ts

@@ -0,0 +1,23 @@
+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"];
+export declare const DEFAULT_ROUTING_MODE: RoutingMode;
+type RoutingCommandAction = {
+    type: 'status';
+} | {
+    type: 'mode';
+    mode: RoutingMode;
+} | {
+    type: 'usage';
+};
+export declare function getRoutingMode(storage: AccountStorage | null): RoutingMode;
+export declare function setRoutingMode(mode: RoutingMode, path?: string): Promise<AccountStorage>;
+export declare function parseRoutingCommandAction(argumentsText: string): RoutingCommandAction;
+export declare function buildRoutingStatusSummary(input?: {
+    mode?: RoutingMode;
+}): string;
+export declare function executeRoutingCommand(input: {
+    argumentsText: string;
+    mode?: RoutingMode;
+}): string;
+export {};

package/dist/routing.js

@@ -0,0 +1,80 @@
+import { getAccountStoragePath, loadAccounts, saveAccounts, } from "./accounts.js";
+export const CLAUDE_ROUTING_COMMAND_NAME = 'claude-routing';
+export const ROUTING_MODES = ['main-first', 'fallback-first'];
+export const DEFAULT_ROUTING_MODE = 'main-first';
+const ROUTING_USAGE = 'Usage: `/claude-routing`, `/claude-routing main-first`, or `/claude-routing fallback-first`.';
+function normalizeRoutingMode(value) {
+    return typeof value === 'string' &&
+        ROUTING_MODES.includes(value)
+        ? value
+        : DEFAULT_ROUTING_MODE;
+}
+export function getRoutingMode(storage) {
+    return normalizeRoutingMode(storage?.routing?.mode);
+}
+export async function setRoutingMode(mode, path = getAccountStoragePath()) {
+    const storage = (await loadAccounts(path)) ?? {
+        version: 1,
+        main: { type: 'opencode', provider: 'anthropic' },
+        accounts: [],
+    };
+    storage.routing = {
+        ...(storage.routing ?? {}),
+        mode,
+    };
+    await saveAccounts(storage, path);
+    return storage;
+}
+export function parseRoutingCommandAction(argumentsText) {
+    const tokens = argumentsText.trim().toLowerCase().split(/\s+/).filter(Boolean);
+    if (tokens.length === 0)
+        return { type: 'status' };
+    if (tokens.length === 1 && ROUTING_MODES.includes(tokens[0])) {
+        return { type: 'mode', mode: tokens[0] };
+    }
+    if (tokens.length === 2 &&
+        tokens[0] === 'mode' &&
+        ROUTING_MODES.includes(tokens[1])) {
+        return { type: 'mode', mode: tokens[1] };
+    }
+    return { type: 'usage' };
+}
+function routingDescription(mode) {
+    if (mode === 'fallback-first') {
+        return 'Try usable fallback accounts before the main account. If no fallback succeeds, try the main account.';
+    }
+    return 'Try the main account first. Use fallback accounts only when quota policy or fallback errors require it.';
+}
+export function buildRoutingStatusSummary(input) {
+    const mode = input?.mode ?? DEFAULT_ROUTING_MODE;
+    return [
+        '## Claude Routing Status',
+        '',
+        `- Mode: \`${mode}\``,
+        `- Behavior: ${routingDescription(mode)}`,
+        '',
+        ROUTING_USAGE,
+    ].join('\n');
+}
+export function executeRoutingCommand(input) {
+    const action = parseRoutingCommandAction(input.argumentsText);
+    const mode = input.mode ?? DEFAULT_ROUTING_MODE;
+    if (action.type === 'status')
+        return buildRoutingStatusSummary({ mode });
+    if (action.type === 'mode') {
+        return [
+            '## Claude Routing Updated',
+            '',
+            `Mode updated to \`${action.mode}\`.`,
+            '',
+            ...buildRoutingStatusSummary({ mode: action.mode }).split('\n').slice(2),
+        ].join('\n');
+    }
+    return [
+        '## Claude Routing Usage',
+        '',
+        ROUTING_USAGE,
+        '',
+        ...buildRoutingStatusSummary({ mode }).split('\n').slice(2),
+    ].join('\n');
+}

package/package.json

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