@juspay/neurolink 9.62.0 → 9.63.0

package/dist/lib/server/routes/claudeProxyRoutes.js

@@ -47,6 +47,11 @@ const BLOCKED_UPSTREAM_HEADERS = new Set([
 let primaryAccountIndex = 0;
 /** Track account count so we can reset primaryAccountIndex when it changes. */
 let lastKnownAccountCount = 0;
+/** Stable account key (e.g. "anthropic:user@example.com") of the configured
+ *  home/primary account. Set once at proxy boot from routing.primaryAccount.
+ *  When undefined, home semantics fall back to enabledAccounts[0] (insertion
+ *  order) — preserves pre-existing behavior. */
+let configuredPrimaryAccountKey;
 const MAX_AUTH_RETRIES = 5;
 const MAX_CONSECUTIVE_REFRESH_FAILURES = 15;
 const MAX_TRANSIENT_SAME_ACCOUNT_RETRIES = 2;
@@ -82,22 +87,40 @@ function advancePrimaryIfCurrent(accountKey, enabledCount, primaryAccountKey) {
     }
     primaryAccountIndex = (primaryAccountIndex + 1) % enabledCount;
 }
-/** If the configured home primary (index 0) is no longer cooling, reset
- *  primaryAccountIndex back to 0 so traffic returns to the preferred account
- *  once its rate limit window expires. Called at the start of each request. */
+/** Resolve the configured primary's stable key to its current index in the
+ *  request's enabledAccounts list. Returns 0 (insertion-order fallback) when
+ *  no key is configured or the key cannot be matched (account disabled/
+ *  removed). The resolution is per-request because enabledAccounts membership
+ *  can shift between requests. */
+function resolveHomeIndex(enabledAccounts) {
+    if (!configuredPrimaryAccountKey) {
+        return 0;
+    }
+    const idx = enabledAccounts.findIndex((a) => a.key === configuredPrimaryAccountKey);
+    return idx >= 0 ? idx : 0;
+}
+/** If the configured home primary is no longer cooling, reset
+ *  primaryAccountIndex back to its index so traffic returns to the preferred
+ *  account once its rate limit window expires. Called at the start of each
+ *  request. Home is resolved fresh per call via resolveHomeIndex. */
 function maybeResetPrimaryToHome(enabledAccounts) {
-    if (enabledAccounts.length <= 1 || primaryAccountIndex === 0) {
+    if (enabledAccounts.length <= 1) {
+        return;
+    }
+    const homeIndex = resolveHomeIndex(enabledAccounts);
+    if (primaryAccountIndex === homeIndex) {
         return;
     }
-    const homeState = accountRuntimeState.get(enabledAccounts[0].key);
+    const homeAccount = enabledAccounts[homeIndex];
+    const homeState = accountRuntimeState.get(homeAccount.key);
     if (!homeState ||
         !homeState.coolingUntil ||
         Date.now() >= homeState.coolingUntil) {
         // Home account is no longer cooling — reset to it
-        primaryAccountIndex = 0;
+        primaryAccountIndex = homeIndex;
         if (homeState?.coolingUntil) {
             homeState.coolingUntil = undefined;
-            logger.always(`[proxy] home primary account=${enabledAccounts[0].label} cooling expired, resetting primaryAccountIndex to 0`);
+            logger.always(`[proxy] home primary account=${homeAccount.label} cooling expired, resetting primaryAccountIndex to ${homeIndex}`);
         }
     }
 }
@@ -1239,7 +1262,7 @@ async function loadClaudeProxyAccounts(args) {
     const orderedAccounts = [...enabledAccounts];
     if (accountStrategy === "round-robin" &&
         orderedAccounts.length !== lastKnownAccountCount) {
-        primaryAccountIndex = 0;
+        primaryAccountIndex = resolveHomeIndex(orderedAccounts);
         lastKnownAccountCount = orderedAccounts.length;
     }
     if (orderedAccounts.length > 1) {
@@ -3232,7 +3255,8 @@ async function handleAnthropicRoutedClaudeRequest(args) {
  * @param basePath    - Base path prefix (default: "" since Claude API uses /v1/...).
  * @returns RouteGroup with Claude-compatible endpoints.
  */
-export function createClaudeProxyRoutes(modelRouter, basePath = "", accountStrategy = "fill-first", passthroughMode = false) {
+export function createClaudeProxyRoutes(modelRouter, basePath = "", accountStrategy = "fill-first", passthroughMode = false, primaryAccountKey) {
+    configuredPrimaryAccountKey = primaryAccountKey;
     return {
         prefix: `${basePath}/v1`,
         routes: [
@@ -3691,4 +3715,32 @@ export function isTransientHttpFailure(status, errBody) {
         normalized.includes("cloudflare") ||
         normalized.includes("internal server error"));
 }
+// ---------------------------------------------------------------------------
+// Test hooks (not part of the public SDK API). Only consumed by the proxy
+// continuous-test-suite to drive the in-process resolver/reset logic without
+// spinning up a full proxy. Keep this surface small.
+// ---------------------------------------------------------------------------
+export const __testHooks = {
+    resolveHomeIndex,
+    maybeResetPrimaryToHome,
+    setConfiguredPrimaryAccountKey: (key) => {
+        configuredPrimaryAccountKey = key;
+    },
+    getConfiguredPrimaryAccountKey: () => configuredPrimaryAccountKey,
+    setPrimaryAccountIndex: (index) => {
+        primaryAccountIndex = index;
+    },
+    getPrimaryAccountIndex: () => primaryAccountIndex,
+    setAccountRuntimeState: (key, state) => {
+        const existing = accountRuntimeState.get(key) ?? getOrCreateRuntimeState(key);
+        Object.assign(existing, state);
+        accountRuntimeState.set(key, existing);
+    },
+    resetAllRuntimeState: () => {
+        accountRuntimeState.clear();
+        primaryAccountIndex = 0;
+        lastKnownAccountCount = 0;
+        configuredPrimaryAccountKey = undefined;
+    },
+};
 //# sourceMappingURL=claudeProxyRoutes.js.map

package/dist/lib/types/cli.d.ts

@@ -859,6 +859,10 @@ export type AuthCommandArgs = BaseCommandArgs & {
     label?: string;
     account?: string;
     force?: boolean;
+    /** Path to the proxy config YAML, used by set-/get-/clear-primary */
+    config?: string;
+    /** Email passed to `auth set-primary <email>` */
+    email?: string;
     /** Yargs positional arguments */
     _?: (string | number)[];
 };

package/dist/lib/types/proxy.d.ts

@@ -981,13 +981,35 @@ export type UpdateState = {
     lastUpdateAt: string | null;
     lastUpdateVersion: string | null;
 };
-/** Shape of the dynamically-imported js-yaml module. */
+/** Shape of the dynamically-imported js-yaml module. `dump` is optional —
+ *  read-only consumers (proxy config loader) only need `load`; writers
+ *  (CLI primary-account commands) check `dump` before calling. */
 export type YamlModule = {
     load(content: string): unknown;
+    dump?: (obj: unknown, opts?: Record<string, unknown>) => string;
     default?: {
         load(content: string): unknown;
+        dump?: (obj: unknown, opts?: Record<string, unknown>) => string;
     };
 };
+/** Snapshot of a parsed proxy config file used by CLI primary-account
+ *  read/edit/write helpers. Tracks the original format and whether comments
+ *  were present (so the CLI can warn that comments will not round-trip). */
+export type CliProxyConfigDoc = {
+    data: Record<string, unknown>;
+    format: "yaml" | "json";
+    hadComments: boolean;
+};
+/** Primary-account info exposed by the proxy `/status` endpoint.
+ *  `source` is "configured" when the operator's `routing.primaryAccount` is
+ *  authenticated and enabled, otherwise "fallback" — either no primary set
+ *  or the configured one is missing/disabled. */
+export type ProxyStatusPrimaryAccount = {
+    configured: string | null;
+    key: string | null;
+    label: string | null;
+    source: "configured" | "fallback";
+};
 /** Parsed fields captured from a Claude Code client request body. */
 export type ClaudeSnapshotBody = {
     metadataUserId?: string;

package/dist/lib/types/subscription.d.ts

@@ -909,6 +909,11 @@ export type ProxyRoutingConfig = {
     modelMappings: ModelMapping[];
     fallbackChain: FallbackEntry[];
     passthroughModels?: string[];
+    /** Email/label of the Anthropic account that should be tried first
+     *  ("home"). When absent, falls back to insertion-order index 0.
+     *  Resolved per-request to a stable key (anthropic:<email>); does not
+     *  encode an index. */
+    primaryAccount?: string;
 };
 /** Cloaking plugin config */
 export type CloakingConfig = {

package/dist/proxy/proxyConfig.js

@@ -336,6 +336,20 @@ function parseRoutingConfig(raw) {
     if (Array.isArray(rawPassthrough)) {
         result.passthroughModels = rawPassthrough.map(String);
     }
+    // Primary account (accept kebab-case or camelCase). Email or label of the
+    // Anthropic account that should be tried first ("home"). Resolved to a
+    // stable key (anthropic:<email>) at proxy boot; absence preserves the
+    // pre-existing insertion-order behavior.
+    const rawPrimary = (raw["primary-account"] ?? raw.primaryAccount);
+    if (rawPrimary !== undefined) {
+        if (typeof rawPrimary === "string" && rawPrimary.trim() !== "") {
+            result.primaryAccount = rawPrimary.trim();
+        }
+        else {
+            logger.warn(`[proxy-config] Ignoring routing.primaryAccount: expected non-empty ` +
+                `string, got ${typeof rawPrimary}`);
+        }
+    }
     return result;
 }
 // ---------------------------------------------------------------------------

package/dist/server/routes/claudeProxyRoutes.d.ts

@@ -10,7 +10,18 @@
  * Without a router, models are passed through to the Anthropic provider.
  */
 import type { ModelRouter } from "../../proxy/modelRouter.js";
-import type { ParsedClaudeError, ParsedClaudeRequest, RouteGroup } from "../../types/index.js";
+import type { ParsedClaudeError, ParsedClaudeRequest, ProxyPassthroughAccount, RouteGroup, RuntimeAccountState } from "../../types/index.js";
+/** Resolve the configured primary's stable key to its current index in the
+ *  request's enabledAccounts list. Returns 0 (insertion-order fallback) when
+ *  no key is configured or the key cannot be matched (account disabled/
+ *  removed). The resolution is per-request because enabledAccounts membership
+ *  can shift between requests. */
+declare function resolveHomeIndex(enabledAccounts: ProxyPassthroughAccount[]): number;
+/** If the configured home primary is no longer cooling, reset
+ *  primaryAccountIndex back to its index so traffic returns to the preferred
+ *  account once its rate limit window expires. Called at the start of each
+ *  request. Home is resolved fresh per call via resolveHomeIndex. */
+declare function maybeResetPrimaryToHome(enabledAccounts: ProxyPassthroughAccount[]): void;
 /**
  * Create Claude-compatible proxy routes.
  *
@@ -21,7 +32,7 @@ import type { ParsedClaudeError, ParsedClaudeRequest, RouteGroup } from "../../t
  * @param basePath    - Base path prefix (default: "" since Claude API uses /v1/...).
  * @returns RouteGroup with Claude-compatible endpoints.
  */
-export declare function createClaudeProxyRoutes(modelRouter?: ModelRouter, basePath?: string, accountStrategy?: "round-robin" | "fill-first", passthroughMode?: boolean): RouteGroup;
+export declare function createClaudeProxyRoutes(modelRouter?: ModelRouter, basePath?: string, accountStrategy?: "round-robin" | "fill-first", passthroughMode?: boolean, primaryAccountKey?: string): RouteGroup;
 export declare function getTransientSameAccountRetryDelayMs(retryNumber: number): number;
 /**
  * Parse a Claude error payload when available.
@@ -42,3 +53,14 @@ export declare function buildProxyFallbackOptions(parsed: ParsedClaudeRequest, o
  * carry transient HTML responses (e.g. 520 pages) inside `error.message`.
  */
 export declare function isTransientHttpFailure(status: number, errBody: string): boolean;
+export declare const __testHooks: {
+    resolveHomeIndex: typeof resolveHomeIndex;
+    maybeResetPrimaryToHome: typeof maybeResetPrimaryToHome;
+    setConfiguredPrimaryAccountKey: (key: string | undefined) => void;
+    getConfiguredPrimaryAccountKey: () => string | undefined;
+    setPrimaryAccountIndex: (index: number) => void;
+    getPrimaryAccountIndex: () => number;
+    setAccountRuntimeState: (key: string, state: Partial<RuntimeAccountState>) => void;
+    resetAllRuntimeState: () => void;
+};
+export {};

package/dist/server/routes/claudeProxyRoutes.js

@@ -47,6 +47,11 @@ const BLOCKED_UPSTREAM_HEADERS = new Set([
 let primaryAccountIndex = 0;
 /** Track account count so we can reset primaryAccountIndex when it changes. */
 let lastKnownAccountCount = 0;
+/** Stable account key (e.g. "anthropic:user@example.com") of the configured
+ *  home/primary account. Set once at proxy boot from routing.primaryAccount.
+ *  When undefined, home semantics fall back to enabledAccounts[0] (insertion
+ *  order) — preserves pre-existing behavior. */
+let configuredPrimaryAccountKey;
 const MAX_AUTH_RETRIES = 5;
 const MAX_CONSECUTIVE_REFRESH_FAILURES = 15;
 const MAX_TRANSIENT_SAME_ACCOUNT_RETRIES = 2;
@@ -82,22 +87,40 @@ function advancePrimaryIfCurrent(accountKey, enabledCount, primaryAccountKey) {
     }
     primaryAccountIndex = (primaryAccountIndex + 1) % enabledCount;
 }
-/** If the configured home primary (index 0) is no longer cooling, reset
- *  primaryAccountIndex back to 0 so traffic returns to the preferred account
- *  once its rate limit window expires. Called at the start of each request. */
+/** Resolve the configured primary's stable key to its current index in the
+ *  request's enabledAccounts list. Returns 0 (insertion-order fallback) when
+ *  no key is configured or the key cannot be matched (account disabled/
+ *  removed). The resolution is per-request because enabledAccounts membership
+ *  can shift between requests. */
+function resolveHomeIndex(enabledAccounts) {
+    if (!configuredPrimaryAccountKey) {
+        return 0;
+    }
+    const idx = enabledAccounts.findIndex((a) => a.key === configuredPrimaryAccountKey);
+    return idx >= 0 ? idx : 0;
+}
+/** If the configured home primary is no longer cooling, reset
+ *  primaryAccountIndex back to its index so traffic returns to the preferred
+ *  account once its rate limit window expires. Called at the start of each
+ *  request. Home is resolved fresh per call via resolveHomeIndex. */
 function maybeResetPrimaryToHome(enabledAccounts) {
-    if (enabledAccounts.length <= 1 || primaryAccountIndex === 0) {
+    if (enabledAccounts.length <= 1) {
+        return;
+    }
+    const homeIndex = resolveHomeIndex(enabledAccounts);
+    if (primaryAccountIndex === homeIndex) {
         return;
     }
-    const homeState = accountRuntimeState.get(enabledAccounts[0].key);
+    const homeAccount = enabledAccounts[homeIndex];
+    const homeState = accountRuntimeState.get(homeAccount.key);
     if (!homeState ||
         !homeState.coolingUntil ||
         Date.now() >= homeState.coolingUntil) {
         // Home account is no longer cooling — reset to it
-        primaryAccountIndex = 0;
+        primaryAccountIndex = homeIndex;
         if (homeState?.coolingUntil) {
             homeState.coolingUntil = undefined;
-            logger.always(`[proxy] home primary account=${enabledAccounts[0].label} cooling expired, resetting primaryAccountIndex to 0`);
+            logger.always(`[proxy] home primary account=${homeAccount.label} cooling expired, resetting primaryAccountIndex to ${homeIndex}`);
         }
     }
 }
@@ -1239,7 +1262,7 @@ async function loadClaudeProxyAccounts(args) {
     const orderedAccounts = [...enabledAccounts];
     if (accountStrategy === "round-robin" &&
         orderedAccounts.length !== lastKnownAccountCount) {
-        primaryAccountIndex = 0;
+        primaryAccountIndex = resolveHomeIndex(orderedAccounts);
         lastKnownAccountCount = orderedAccounts.length;
     }
     if (orderedAccounts.length > 1) {
@@ -3232,7 +3255,8 @@ async function handleAnthropicRoutedClaudeRequest(args) {
  * @param basePath    - Base path prefix (default: "" since Claude API uses /v1/...).
  * @returns RouteGroup with Claude-compatible endpoints.
  */
-export function createClaudeProxyRoutes(modelRouter, basePath = "", accountStrategy = "fill-first", passthroughMode = false) {
+export function createClaudeProxyRoutes(modelRouter, basePath = "", accountStrategy = "fill-first", passthroughMode = false, primaryAccountKey) {
+    configuredPrimaryAccountKey = primaryAccountKey;
     return {
         prefix: `${basePath}/v1`,
         routes: [
@@ -3691,3 +3715,31 @@ export function isTransientHttpFailure(status, errBody) {
         normalized.includes("cloudflare") ||
         normalized.includes("internal server error"));
 }
+// ---------------------------------------------------------------------------
+// Test hooks (not part of the public SDK API). Only consumed by the proxy
+// continuous-test-suite to drive the in-process resolver/reset logic without
+// spinning up a full proxy. Keep this surface small.
+// ---------------------------------------------------------------------------
+export const __testHooks = {
+    resolveHomeIndex,
+    maybeResetPrimaryToHome,
+    setConfiguredPrimaryAccountKey: (key) => {
+        configuredPrimaryAccountKey = key;
+    },
+    getConfiguredPrimaryAccountKey: () => configuredPrimaryAccountKey,
+    setPrimaryAccountIndex: (index) => {
+        primaryAccountIndex = index;
+    },
+    getPrimaryAccountIndex: () => primaryAccountIndex,
+    setAccountRuntimeState: (key, state) => {
+        const existing = accountRuntimeState.get(key) ?? getOrCreateRuntimeState(key);
+        Object.assign(existing, state);
+        accountRuntimeState.set(key, existing);
+    },
+    resetAllRuntimeState: () => {
+        accountRuntimeState.clear();
+        primaryAccountIndex = 0;
+        lastKnownAccountCount = 0;
+        configuredPrimaryAccountKey = undefined;
+    },
+};

package/dist/types/cli.d.ts

@@ -859,6 +859,10 @@ export type AuthCommandArgs = BaseCommandArgs & {
     label?: string;
     account?: string;
     force?: boolean;
+    /** Path to the proxy config YAML, used by set-/get-/clear-primary */
+    config?: string;
+    /** Email passed to `auth set-primary <email>` */
+    email?: string;
     /** Yargs positional arguments */
     _?: (string | number)[];
 };

package/dist/types/proxy.d.ts

@@ -981,13 +981,35 @@ export type UpdateState = {
     lastUpdateAt: string | null;
     lastUpdateVersion: string | null;
 };
-/** Shape of the dynamically-imported js-yaml module. */
+/** Shape of the dynamically-imported js-yaml module. `dump` is optional —
+ *  read-only consumers (proxy config loader) only need `load`; writers
+ *  (CLI primary-account commands) check `dump` before calling. */
 export type YamlModule = {
     load(content: string): unknown;
+    dump?: (obj: unknown, opts?: Record<string, unknown>) => string;
     default?: {
         load(content: string): unknown;
+        dump?: (obj: unknown, opts?: Record<string, unknown>) => string;
     };
 };
+/** Snapshot of a parsed proxy config file used by CLI primary-account
+ *  read/edit/write helpers. Tracks the original format and whether comments
+ *  were present (so the CLI can warn that comments will not round-trip). */
+export type CliProxyConfigDoc = {
+    data: Record<string, unknown>;
+    format: "yaml" | "json";
+    hadComments: boolean;
+};
+/** Primary-account info exposed by the proxy `/status` endpoint.
+ *  `source` is "configured" when the operator's `routing.primaryAccount` is
+ *  authenticated and enabled, otherwise "fallback" — either no primary set
+ *  or the configured one is missing/disabled. */
+export type ProxyStatusPrimaryAccount = {
+    configured: string | null;
+    key: string | null;
+    label: string | null;
+    source: "configured" | "fallback";
+};
 /** Parsed fields captured from a Claude Code client request body. */
 export type ClaudeSnapshotBody = {
     metadataUserId?: string;

package/dist/types/subscription.d.ts

@@ -909,6 +909,11 @@ export type ProxyRoutingConfig = {
     modelMappings: ModelMapping[];
     fallbackChain: FallbackEntry[];
     passthroughModels?: string[];
+    /** Email/label of the Anthropic account that should be tried first
+     *  ("home"). When absent, falls back to insertion-order index 0.
+     *  Resolved per-request to a stable key (anthropic:<email>); does not
+     *  encode an index. */
+    primaryAccount?: string;
 };
 /** Cloaking plugin config */
 export type CloakingConfig = {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.62.0",
+  "version": "9.63.0",
   "packageManager": "pnpm@10.15.1",
-  "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
+  "description": "Universal AI Development Platform with working MCP integration, multi-provider support, voice (TTS/STT/realtime), and professional CLI. 58+ external MCP servers discoverable, multimodal file processing, RAG pipelines. Build, test, and deploy AI applications with 21+ providers: OpenAI, Anthropic, Google AI Studio, Google Vertex, AWS Bedrock, Azure OpenAI, Mistral, LiteLLM, SageMaker, Hugging Face, Ollama, OpenAI-compatible, OpenRouter, DeepSeek, NVIDIA NIM, LM Studio, llama.cpp, plus voice (OpenAI TTS, ElevenLabs, Deepgram, Azure Speech).",
   "author": {
     "name": "Juspay Technologies",
     "email": "support@juspay.in",
@@ -378,6 +378,25 @@
     "google",
     "bedrock",
     "vertex",
+    "azure",
+    "mistral",
+    "ollama",
+    "huggingface",
+    "litellm",
+    "openrouter",
+    "deepseek",
+    "nvidia-nim",
+    "lm-studio",
+    "llama-cpp",
+    "tts",
+    "stt",
+    "voice",
+    "realtime",
+    "elevenlabs",
+    "deepgram",
+    "whisper",
+    "azure-speech",
+    "rag",
     "streaming",
     "tools",
     "neurolink",