@juspay/neurolink 10.12.7 → 10.12.8

package/dist/types/proxy.d.ts

@@ -430,6 +430,21 @@ export type ProxyAccountRoutingStrategy = (typeof PROXY_ACCOUNT_ROUTING_STRATEGI
 export type ProxyAccountRoutingMode = (typeof PROXY_ACCOUNT_ROUTING_MODES)[number];
 export type ProxyAccountRoutingReason = (typeof PROXY_ACCOUNT_ROUTING_REASONS)[number];
 export type ProxyAccountType = (typeof PROXY_ACCOUNT_TYPES)[number];
+export type ProxyQuotaFreshness = "unknown" | "fresh" | "stale_known" | "refresh_due";
+export type ProxyQuotaRefreshReason = "startup_unknown" | "handoff_prewarm" | "ambiguous_snapshot" | "manual";
+export type ProxyQuotaSaturationKind = "none" | "soft" | "hard";
+export type ProxyTransportScope = "shared_provider_transport" | "connection_transport" | "account_specific";
+export type ProxyNetworkTransportScope = Exclude<ProxyTransportScope, "account_specific">;
+export type ProxyProviderTransportProbeOutcome = "recovered" | "failed" | "abandoned";
+export type ProxyProviderTransportPermit = {
+    allowed: true;
+    probe: boolean;
+    generation: number;
+} | {
+    allowed: false;
+    errorCode: string | null;
+    transportScope: ProxyNetworkTransportScope;
+};
 export type ProxyAccountRoutingCandidate = {
     account: string;
     accountType: ProxyAccountType;
@@ -440,6 +455,15 @@ export type ProxyAccountRoutingCandidate = {
     saturated: boolean;
     quotaObserved: boolean;
     quotaStale: boolean;
+    quotaFreshness?: ProxyQuotaFreshness;
+    refreshNeeded?: boolean;
+    refreshReason?: ProxyQuotaRefreshReason | null;
+    refreshInFlight?: boolean;
+    lastRefreshAttemptAt?: number | null;
+    lastRefreshSuccessAt?: number | null;
+    nextRefreshEligibleAt?: number | null;
+    saturationKind?: ProxyQuotaSaturationKind;
+    softLimitOverrideReason?: "overage" | "weekly_expiry" | null;
     quotaLastUpdated: number | null;
     quotaAgeMs: number | null;
     coolingActive: boolean;
@@ -478,7 +502,17 @@ export type ProxyAccountSortMetrics = {
     usable: boolean;
     saturated: boolean;
     hasQuota: boolean;
+    quotaEvidenceRank: number;
     quotaStale: boolean;
+    quotaFreshness: ProxyQuotaFreshness;
+    refreshNeeded: boolean;
+    refreshReason: ProxyQuotaRefreshReason | null;
+    refreshInFlight: boolean;
+    lastRefreshAttemptAt: number | null;
+    lastRefreshSuccessAt: number | null;
+    nextRefreshEligibleAt: number | null;
+    saturationKind: ProxyQuotaSaturationKind;
+    softLimitOverrideReason: "overage" | "weekly_expiry" | null;
     quotaLastUpdated: number | null;
     quotaAgeMs: number | null;
     coolingActive: boolean;
@@ -514,6 +548,8 @@ export type RequestLogEntry = {
     errorMessage?: string;
     /** Low-level transport code such as ETIMEDOUT or EADDRNOTAVAIL. */
     errorCode?: string;
+    /** Whether changing credentials can affect this transport failure. */
+    transportScope?: ProxyTransportScope;
     inputTokens?: number;
     outputTokens?: number;
     cacheCreationTokens?: number;
@@ -545,6 +581,8 @@ export type RequestAttemptLogEntry = {
     errorMessage?: string;
     /** Low-level transport code such as ETIMEDOUT or EADDRNOTAVAIL. */
     errorCode?: string;
+    /** Whether changing credentials can affect this transport failure. */
+    transportScope?: ProxyTransportScope;
     /** Whether this failed attempt may be retried without changing the request. */
     retryable?: boolean;
     /** Distinguishes short-lived admission throttles from exhausted quota windows. */
@@ -579,11 +617,15 @@ export type ClaudeFinalRequestLogger = (status: number, accountLabel: string, ac
     outputTokens?: number;
     cacheCreationTokens?: number;
     cacheReadTokens?: number;
+    errorCode?: string;
+    transportScope?: ProxyTransportScope;
 }) => void;
 export type ClaudeLoggedErrorBuilder = (status: number, message: string, errorType?: string, extra?: {
     account?: string;
     accountType?: string;
     attempt?: number;
+    errorCode?: string;
+    transportScope?: ProxyTransportScope;
 }) => ClaudeErrorResponse;
 export type ClaudeRequestRuntimeContext = {
     tracer?: ProxyTracer;
@@ -603,6 +645,7 @@ export type AnthropicAttemptLogger = (status: number, errorType?: string, errorM
     retryable?: boolean;
     /** Low-level transport code such as ETIMEDOUT or EADDRNOTAVAIL. */
     errorCode?: string;
+    transportScope?: ProxyTransportScope;
     rateLimitKind?: "transient" | "quota";
     cooldownReason?: "transient" | "session" | "weekly" | "unified";
     /** Override for nested retries whose attempt starts after this logger. */
@@ -624,6 +667,8 @@ export type AnthropicLoopState = {
     authCooldownMessage: string | null;
     fallbackFailureMessage?: string;
     attemptNumber: number;
+    lastTransportErrorCode?: string;
+    lastTransportScope?: ProxyNetworkTransportScope;
 };
 export type AnthropicUpstreamBody = {
     bodyStr: string;
@@ -765,6 +810,8 @@ export type TransientRateLimitRetryBudget = {
 export type AnthropicUpstreamFetchResult = {
     continueLoop: boolean;
     retrySameAccount?: boolean;
+    transportScope?: ProxyNetworkTransportScope;
+    errorCode?: string;
     /** When set, the caller should wait this many ms before retrying (from upstream retry-after). */
     retryAfterMs?: number;
     /** Set on a genuine 429: how long / why to cool this account before rotating. */
@@ -1033,6 +1080,35 @@ export type AccountUsageFetchResult = {
     error: string;
     status?: number;
 };
+export type ProxyQuotaRefreshRuntimeState = {
+    inFlight: boolean;
+    lastAttemptAt?: number;
+    lastSuccessAt?: number;
+    nextEligibleAt?: number;
+    consecutiveFailures: number;
+    lastFailureReason?: string;
+    lastCompletedTrigger?: string;
+    coalesced: number;
+};
+export type ProxyQuotaRefreshMetrics = {
+    attempted: number;
+    succeeded: number;
+    failed: number;
+    coalesced: number;
+    backoffSuppressed: number;
+    triggerDeduplicated: number;
+};
+export type ProxyQuotaRefreshRunResult = {
+    kind: "completed";
+    result: AccountUsageFetchResult;
+    /** Lower bound for the freshness of the returned usage snapshot. */
+    startedAt: number;
+} | {
+    kind: "backoff";
+    nextEligibleAt: number;
+} | {
+    kind: "not_due";
+};
 /** Per-account result inside a GET /limits response. */
 export type ProxyLimitsAccountResult = {
     /** Account label (quota-store key). */
@@ -1053,6 +1129,8 @@ export type ProxyLimitsRefreshResponse = {
     /** True when served from stored state without contacting Anthropic. */
     snapshot: boolean;
     results: ProxyLimitsAccountResult[];
+    /** Process-local refresh activity; contains no credentials or response body. */
+    refreshMetrics?: ProxyQuotaRefreshMetrics;
 };
 /**
  * Provenance of the quota numbers attached to a single proxy response.
@@ -1518,6 +1596,7 @@ export type ProxyAnalysisReport = {
         errors: number;
         errorTypes: Record<string, number>;
         errorCodes: Record<string, number>;
+        transportScopes: Record<string, number>;
     };
     rateLimits: {
         attemptRateLimits: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "10.12.7",
+  "version": "10.12.8",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {