@juspay/neurolink 9.88.10 → 9.88.12

package/dist/proxy/updateState.js

@@ -15,6 +15,13 @@ import { randomUUID } from "node:crypto";
 // ============================================
 const STATE_FILENAME = "update-state.json";
 const SUPPRESSION_TTL_MS = 86_400_000; // 24 hours
+const UPDATE_FAILURE_STAGES = new Set([
+    "check",
+    "install",
+    "validation",
+    "restart",
+    "health",
+]);
 // ============================================
 // Internal Helpers
 // ============================================
@@ -37,6 +44,18 @@ function ensureParentDir(filePath) {
         fs.mkdirSync(dir, { recursive: true });
     }
 }
+/** Reject malformed persisted failure metadata before it reaches status output. */
+function isValidLastFailure(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.at === "string" &&
+        typeof candidate.version === "string" &&
+        typeof candidate.stage === "string" &&
+        UPDATE_FAILURE_STAGES.has(candidate.stage) &&
+        typeof candidate.message === "string");
+}
 // ============================================
 // Exported Functions
 // ============================================
@@ -50,6 +69,8 @@ export function getDefaultUpdateState() {
         suppressedVersions: {},
         lastUpdateAt: null,
         lastUpdateVersion: null,
+        pendingRestartVersion: null,
+        lastFailure: null,
     };
 }
 /**
@@ -77,7 +98,18 @@ export function loadUpdateState(stateFilePath) {
             typeof parsed.lastCheckAt !== "string") {
             return getDefaultUpdateState();
         }
-        return parsed;
+        const candidate = parsed;
+        return {
+            ...getDefaultUpdateState(),
+            ...candidate,
+            suppressedVersions: candidate.suppressedVersions ?? {},
+            pendingRestartVersion: typeof candidate.pendingRestartVersion === "string"
+                ? candidate.pendingRestartVersion
+                : null,
+            lastFailure: isValidLastFailure(candidate.lastFailure)
+                ? candidate.lastFailure
+                : null,
+        };
     }
     catch {
         // Corrupt or unreadable JSON — return default state
@@ -152,8 +184,48 @@ export function recordSuccessfulUpdate(version, stateFilePath) {
     const state = loadUpdateState(stateFilePath) ?? getDefaultUpdateState();
     state.lastUpdateAt = new Date().toISOString();
     state.lastUpdateVersion = version;
+    state.pendingRestartVersion = null;
+    state.lastFailure = null;
+    delete state.suppressedVersions[version];
+    saveUpdateState(state, stateFilePath);
+}
+/** Record that package installation completed but the live restart is pending. */
+export function recordUpdateInstalled(version, stateFilePath) {
+    const state = loadUpdateState(stateFilePath) ?? getDefaultUpdateState();
+    state.pendingRestartVersion = version;
+    state.lastFailure = null;
     saveUpdateState(state, stateFilePath);
 }
+/** Abandon a matching installed version so the next cycle may reinstall it. */
+export function abandonPendingUpdate(version, stateFilePath) {
+    const state = loadUpdateState(stateFilePath);
+    if (!state || state.pendingRestartVersion !== version) {
+        return false;
+    }
+    state.pendingRestartVersion = null;
+    saveUpdateState(state, stateFilePath);
+    return true;
+}
+/** Persist a stage-specific updater failure so status remains actionable. */
+export function recordUpdateFailure(version, stage, message, stateFilePath) {
+    const state = loadUpdateState(stateFilePath) ?? getDefaultUpdateState();
+    state.lastFailure = {
+        at: new Date().toISOString(),
+        version,
+        stage,
+        message: message.trim().slice(0, 1_000),
+    };
+    saveUpdateState(state, stateFilePath);
+}
+/** Complete an updater-managed install after a manual or automatic restart. */
+export function reconcileRunningUpdate(runningVersion, stateFilePath) {
+    const state = loadUpdateState(stateFilePath);
+    if (!state || state.pendingRestartVersion !== runningVersion) {
+        return false;
+    }
+    recordSuccessfulUpdate(runningVersion, stateFilePath);
+    return true;
+}
 /**
  * Record an update check: set lastCheckAt and lastCheckVersion, then persist.
  *

package/dist/proxy/updaterSupervisor.d.ts

@@ -0,0 +1,3 @@
+import type { UpdaterWorkerSupervisor, UpdaterWorkerSupervisorOptions } from "../types/index.js";
+/** Keep the launchd updater worker alive while its owning proxy is running. */
+export declare function startUpdaterWorkerSupervisor(options: UpdaterWorkerSupervisorOptions): UpdaterWorkerSupervisor;

package/dist/proxy/updaterSupervisor.js

@@ -0,0 +1,57 @@
+/** Keep the launchd updater worker alive while its owning proxy is running. */
+export function startUpdaterWorkerSupervisor(options) {
+    let stopped = false;
+    let pid;
+    /** Return the healthy worker PID or replace an unavailable worker. */
+    const checkNow = () => {
+        if (stopped) {
+            return pid;
+        }
+        if (pid !== undefined && options.isProcessRunning(pid)) {
+            return pid;
+        }
+        const previousPid = pid;
+        try {
+            pid = options.spawnWorker();
+        }
+        catch (error) {
+            pid = undefined;
+            options.log?.(`[proxy] updater worker spawn failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        options.onPidChange?.(pid);
+        if (pid !== undefined) {
+            options.log?.(previousPid === undefined
+                ? `[proxy] updater worker started pid=${pid}`
+                : `[proxy] updater worker restarted oldPid=${previousPid} newPid=${pid}`);
+        }
+        else {
+            options.log?.("[proxy] updater worker unavailable; retrying later");
+        }
+        return pid;
+    };
+    checkNow();
+    const interval = setInterval(checkNow, options.intervalMs ?? 30_000);
+    interval.unref?.();
+    return {
+        currentPid: () => pid,
+        checkNow,
+        stop: () => {
+            if (stopped) {
+                return;
+            }
+            stopped = true;
+            clearInterval(interval);
+            const activePid = pid;
+            if (activePid !== undefined && options.isProcessRunning(activePid)) {
+                try {
+                    options.stopWorker(activePid);
+                }
+                catch (error) {
+                    options.log?.(`[proxy] updater worker stop failed pid=${activePid}: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+            pid = undefined;
+            options.onPidChange?.(undefined);
+        },
+    };
+}

package/dist/proxy/usageStats.d.ts

@@ -6,7 +6,7 @@
 import type { AccountStats, ProxyStats } from "../types/index.js";
 export declare function recordAttempt(accountLabel: string, accountType: string): void;
 export declare function recordFinalSuccess(accountLabel?: string, accountType?: string): void;
-export declare function recordAttemptError(accountLabel: string, accountType: string, status: number): void;
+export declare function recordAttemptError(accountLabel: string, accountType: string, status: number, rateLimitKind?: "transient" | "quota"): void;
 export declare function recordFinalError(_status: number, accountLabel?: string, accountType?: string): void;
 export declare function getStats(): ProxyStats;
 export declare function getAccountStats(label: string): AccountStats | undefined;

package/dist/proxy/usageStats.js

@@ -6,10 +6,13 @@
 const stats = {
     startedAt: Date.now(),
     totalAttempts: 0,
+    totalAttemptErrors: 0,
     totalRequests: 0,
     totalSuccess: 0,
     totalErrors: 0,
     totalRateLimits: 0,
+    totalTransientRateLimits: 0,
+    totalQuotaRateLimits: 0,
     accounts: {},
 };
 export function recordAttempt(accountLabel, accountType) {
@@ -26,13 +29,22 @@ export function recordFinalSuccess(accountLabel, accountType) {
         acct.successCount++;
     }
 }
-export function recordAttemptError(accountLabel, accountType, status) {
+export function recordAttemptError(accountLabel, accountType, status, rateLimitKind) {
     const acct = ensureAccount(accountLabel, accountType);
-    acct.errorCount++;
+    stats.totalAttemptErrors++;
+    acct.attemptErrorCount++;
     acct.lastErrorAt = Date.now();
     if (status === 429) {
         stats.totalRateLimits++;
         acct.rateLimitCount++;
+        if (rateLimitKind === "transient") {
+            stats.totalTransientRateLimits++;
+            acct.transientRateLimitCount++;
+        }
+        else if (rateLimitKind === "quota") {
+            stats.totalQuotaRateLimits++;
+            acct.quotaRateLimitCount++;
+        }
     }
 }
 export function recordFinalError(_status, accountLabel, accountType) {
@@ -58,10 +70,13 @@ export function getAccountStats(label) {
 export function resetStats() {
     stats.startedAt = Date.now();
     stats.totalAttempts = 0;
+    stats.totalAttemptErrors = 0;
     stats.totalRequests = 0;
     stats.totalSuccess = 0;
     stats.totalErrors = 0;
     stats.totalRateLimits = 0;
+    stats.totalTransientRateLimits = 0;
+    stats.totalQuotaRateLimits = 0;
     stats.accounts = {};
 }
 function ensureAccount(label, type) {
@@ -70,9 +85,12 @@ function ensureAccount(label, type) {
             label,
             type,
             attemptCount: 0,
+            attemptErrorCount: 0,
             successCount: 0,
             errorCount: 0,
             rateLimitCount: 0,
+            transientRateLimitCount: 0,
+            quotaRateLimitCount: 0,
             lastAttemptAt: 0,
         };
     }

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

@@ -167,19 +167,11 @@ declare function handleAnthropicAuthRetry(args: {
     };
     enabledAccounts: ProxyPassthroughAccount[];
     orderedAccounts: ProxyPassthroughAccount[];
-    response: Response;
     tracer?: ProxyTracer;
     requestStartTime: number;
-    fetchStartMs: number;
-    attemptNumber: number;
-    finalBodyStr: string;
+    allocateAttemptNumber: () => number;
     upstreamSpan?: import("@opentelemetry/api").Span;
-    logAttempt: (status: number, errorType?: string, errorMessage?: string, extra?: {
-        inputTokens?: number;
-        outputTokens?: number;
-        cacheCreationTokens?: number;
-        cacheReadTokens?: number;
-    }) => void;
+    logAttempt: AnthropicAttemptLogger;
     logProxyBody: ProxyBodyCaptureLogger;
     logFinalRequest: (status: number, accountLabel: string, accountType: string, errorType?: string, errorMessage?: string, extra?: {
         inputTokens?: number;

package/dist/server/routes/claudeProxyRoutes.js

@@ -2825,8 +2825,11 @@ async function handleAnthropicSuccessfulRetryResponse(args) {
     return retryJson;
 }
 async function handleAnthropicAuthRetry(args) {
-    const { ctx, body, account, accountState, headers, buildUpstreamBody, enabledAccounts, orderedAccounts, response: _response, tracer, requestStartTime, fetchStartMs, attemptNumber, finalBodyStr, upstreamSpan, logAttempt, logProxyBody, logFinalRequest, lastError, authFailureMessage, sawRateLimit, sawTransientFailure, sawNetworkError, } = args;
+    const { ctx, body, account, accountState, headers, buildUpstreamBody, enabledAccounts, orderedAccounts, tracer, requestStartTime, allocateAttemptNumber, upstreamSpan, logAttempt, logProxyBody, logFinalRequest, lastError, authFailureMessage, sawRateLimit, sawTransientFailure, sawNetworkError, } = args;
     recordAttemptError(account.label, account.type, 401);
+    logAttempt(401, "authentication_error", "received 401 from Anthropic", {
+        retryable: true,
+    });
     let currentLastError = lastError;
     let currentAuthFailureMessage = authFailureMessage;
     let currentSawRateLimit = sawRateLimit;
@@ -2858,11 +2861,29 @@ async function handleAnthropicAuthRetry(args) {
         }
         await clearAuthCooldownAfterRefresh(account, accountState);
         headers.authorization = `Bearer ${account.token}`;
+        const retryAttemptNumber = allocateAttemptNumber();
+        recordAttempt(account.label, account.type);
+        const retryLogAttempt = (status, errorType, errorMessage, extra) => logAttempt(status, errorType, errorMessage, {
+            ...extra,
+            attempt: retryAttemptNumber,
+        });
+        const retryBodyStr = buildUpstreamBody(account.token).bodyStr;
+        const retryFetchStartMs = Date.now();
+        logProxyBody({
+            phase: "upstream_request",
+            headers,
+            body: retryBodyStr,
+            bodySize: Buffer.byteLength(retryBodyStr, "utf8"),
+            contentType: headers["content-type"] ?? "application/json",
+            account: account.label,
+            accountType: account.type,
+            attempt: retryAttemptNumber,
+        });
         try {
             const retryResp = await fetch("https://api.anthropic.com/v1/messages?beta=true", {
                 method: "POST",
                 headers,
-                body: buildUpstreamBody(account.token).bodyStr,
+                body: retryBodyStr,
                 signal: AbortSignal.timeout(UPSTREAM_FETCH_TIMEOUT_MS),
             });
             if (retryResp.ok) {
@@ -2877,9 +2898,9 @@ async function handleAnthropicAuthRetry(args) {
                     retryResp,
                     tracer,
                     requestStartTime,
-                    fetchStartMs,
-                    attemptNumber,
-                    finalBodyStr,
+                    fetchStartMs: retryFetchStartMs,
+                    attemptNumber: retryAttemptNumber,
+                    finalBodyStr: retryBodyStr,
                     upstreamSpan: currentUpstreamSpan,
                     logProxyBody,
                     logFinalRequest,
@@ -2919,9 +2940,9 @@ async function handleAnthropicAuthRetry(args) {
                 contentType: retryRespHeaders["content-type"] ?? "application/json",
                 account: account.label,
                 accountType: account.type,
-                attempt: attemptNumber,
+                attempt: retryAttemptNumber,
                 responseStatus: retryStatus,
-                durationMs: Date.now() - fetchStartMs,
+                durationMs: Date.now() - retryFetchStartMs,
             });
             authRetryError = `retry ${authRetry + 1}/${MAX_AUTH_RETRIES} failed with status ${retryStatus}`;
             currentLastError = retryBody;
@@ -2929,7 +2950,7 @@ async function handleAnthropicAuthRetry(args) {
             if (retryStatus === 429 &&
                 isAntiAbuseConstruction429(retryRespHeaders, retryBody)) {
                 logger.always(`[proxy] ← 429 account=${account.label} anti-abuse/construction rejection after OAuth refresh — returning non-retryable request error`);
-                logAttempt(429, "construction_rejection", retryBody);
+                retryLogAttempt(429, "construction_rejection", retryBody);
                 tracer?.setError("construction_rejection", retryBody.slice(0, 500));
                 currentUpstreamSpan?.end();
                 return {
@@ -2938,7 +2959,7 @@ async function handleAnthropicAuthRetry(args) {
                         account,
                         tracer,
                         requestStartTime,
-                        attemptNumber,
+                        attemptNumber: retryAttemptNumber,
                         logProxyBody,
                         logFinalRequest,
                     }),
@@ -2951,7 +2972,6 @@ async function handleAnthropicAuthRetry(args) {
                     upstreamSpan: undefined,
                 };
             }
-            recordAttemptError(account.label, account.type, retryStatus);
             // Construction rejections return through the terminal 400 path above.
             // Every 429 reaching this branch is a genuine rate limit and must cool
             // the account according to its reset window before rotating.
@@ -2965,6 +2985,13 @@ async function handleAnthropicAuthRetry(args) {
                     accountState.quota = retryQuota429;
                 }
                 const retryPlan = planCooldownFor429(retryQuota429, parseRetryAfterMs(retryRespHeaders["retry-after"] ?? null), nowRetry, getUnifiedRateLimitStatus(retryRespHeaders));
+                const rateLimitKind = retryPlan.reason === "transient" ? "transient" : "quota";
+                recordAttemptError(account.label, account.type, retryStatus, rateLimitKind);
+                retryLogAttempt(429, "rate_limit_error", retryBody, {
+                    retryable: true,
+                    rateLimitKind,
+                    cooldownReason: retryPlan.reason,
+                });
                 if (!accountState.coolingUntil ||
                     retryPlan.coolingUntil > accountState.coolingUntil) {
                     accountState.coolingUntil = retryPlan.coolingUntil;
@@ -2982,16 +3009,20 @@ async function handleAnthropicAuthRetry(args) {
                 break;
             }
             if (retryStatus === 401 || retryStatus === 402 || retryStatus === 403) {
+                recordAttemptError(account.label, account.type, retryStatus);
+                retryLogAttempt(retryStatus, "authentication_error", summarizeErrorMessage(retryBody), { retryable: true });
                 if (authRetry < MAX_AUTH_RETRIES - 1) {
                     await sleep(1000);
                 }
                 continue;
             }
             if (isTransientHttpFailure(retryStatus, retryBody)) {
+                recordAttemptError(account.label, account.type, retryStatus);
+                retryLogAttempt(retryStatus, "api_error", summarizeErrorMessage(retryBody), { retryable: true });
                 currentSawTransientFailure = true;
                 break;
             }
-            logAttempt(retryStatus, "api_error", summarizeErrorMessage(retryBody));
+            retryLogAttempt(retryStatus, "api_error", summarizeErrorMessage(retryBody));
             recordFinalError(retryStatus, account.label, account.type);
             try {
                 logFinalRequest(retryStatus, account.label, account.type, "api_error", summarizeErrorMessage(retryBody));
@@ -3028,6 +3059,7 @@ async function handleAnthropicAuthRetry(args) {
                 : String(retryFetchErr);
             authRetryError = `network error on retry ${authRetry + 1}: ${message}`;
             currentLastError = authRetryError;
+            retryLogAttempt(502, "network_error", message, { retryable: true });
             logger.debug(`[proxy] ${authRetryError}`);
             break;
         }
@@ -3036,7 +3068,6 @@ async function handleAnthropicAuthRetry(args) {
         // No persistent cooldown — just move to next account for this request.
         currentLastError = authRetryError;
         logger.always(`[proxy] ⚠ account=${account.label} auth retries exhausted, rotating to next account`);
-        logAttempt(401, "authentication_error", authRetryError);
         tracer?.setError("authentication_error", authRetryError);
         tracer?.recordRetry(account.label, "auth_exhausted");
         currentUpstreamSpan?.end();
@@ -3225,11 +3256,17 @@ async function handleAnthropicNonOkResponse(args) {
         };
     }
     if (isTransientHttpFailure(response.status, errBody)) {
-        recordAttemptError(account.label, account.type, response.status);
+        recordAttemptError(account.label, account.type, response.status, response.status === 429 ? "transient" : undefined);
         currentSawTransientFailure = true;
         logger.always(`[proxy] ← ${response.status} account=${account.label} (transient)`);
         currentLastError = errBody;
-        logAttempt(response.status, "api_error", summarizeErrorMessage(errBody));
+        logAttempt(response.status, "api_error", summarizeErrorMessage(errBody), response.status === 429
+            ? {
+                retryable: true,
+                rateLimitKind: "transient",
+                cooldownReason: "transient",
+            }
+            : undefined);
         tracer?.setError("transient_error", summarizeErrorMessage(errBody));
         tracer?.recordRetry(account.label, "transient");
         return {
@@ -3385,7 +3422,7 @@ function createAnthropicAttemptLogger(args) {
         logRequestAttempt({
             timestamp: new Date().toISOString(),
             requestId: ctx.requestId,
-            attempt: attemptNumber,
+            attempt: extra?.attempt ?? attemptNumber,
             method: ctx.method,
             path: ctx.path,
             model: body.model,
@@ -3409,6 +3446,11 @@ function createAnthropicAttemptLogger(args) {
             ...(extra?.cacheReadTokens !== undefined
                 ? { cacheReadTokens: extra.cacheReadTokens }
                 : {}),
+            ...(extra?.retryable !== undefined ? { retryable: extra.retryable } : {}),
+            ...(extra?.rateLimitKind ? { rateLimitKind: extra.rateLimitKind } : {}),
+            ...(extra?.cooldownReason
+                ? { cooldownReason: extra.cooldownReason }
+                : {}),
             ...(traceCtx
                 ? { traceId: traceCtx.traceId, spanId: traceCtx.spanId }
                 : {}),
@@ -3677,7 +3719,6 @@ async function fetchAnthropicAccountResponse(args) {
             };
         }
         sawRateLimit = true;
-        recordAttemptError(account.label, account.type, 429);
         // Parse the unified-window quota headers (present on real rate-limit 429s)
         // and derive a reset-aware cooldown plan. This is the fix for "kept
         // hammering the 5h/7d-exhausted account instead of switching": on an
@@ -3687,12 +3728,18 @@ async function fetchAnthropicAccountResponse(args) {
         const quota = parseQuotaHeaders(errRespHeaders);
         const unifiedStatus = getUnifiedRateLimitStatus(errRespHeaders);
         const cooldownPlan = planCooldownFor429(quota, retryAfterMs, now, unifiedStatus);
+        const rateLimitKind = cooldownPlan.reason === "transient" ? "transient" : "quota";
+        recordAttemptError(account.label, account.type, 429, rateLimitKind);
         logger.always(`[proxy] ← 429 account=${account.label} reason=${cooldownPlan.reason} ` +
             `retry-after=${retryAfterMs}ms 5h-status=${errRespHeaders["anthropic-ratelimit-unified-5h-status"] ?? "unknown"} ` +
             `7d-status=${errRespHeaders["anthropic-ratelimit-unified-7d-status"] ?? "unknown"} ` +
             `unified-status=${unifiedStatus ?? "unknown"} ` +
             `→ ${cooldownPlan.rotateImmediately ? `rotate now, cool ${minutesUntil(cooldownPlan.coolingUntil, now)}m` : "retry same account (transient)"}`);
-        logAttempt(429, "rate_limit_error", String(lastError));
+        logAttempt(429, "rate_limit_error", String(lastError), {
+            retryable: true,
+            rateLimitKind,
+            cooldownReason: cooldownPlan.reason,
+        });
         tracer?.setError("rate_limit_error", String(lastError).slice(0, 500));
         tracer?.recordRetry(account.label, "rate_limit");
         currentUpstreamSpan?.end();
@@ -3940,12 +3987,12 @@ async function handleAnthropicRoutedClaudeRequest(args) {
                     buildUpstreamBody: preparedAttempt.buildUpstreamBody,
                     enabledAccounts,
                     orderedAccounts,
-                    response,
                     tracer,
                     requestStartTime,
-                    fetchStartMs: preparedAttempt.fetchStartMs,
-                    attemptNumber: loopState.attemptNumber,
-                    finalBodyStr: preparedAttempt.finalBodyStr,
+                    allocateAttemptNumber: () => {
+                        loopState.attemptNumber += 1;
+                        return loopState.attemptNumber;
+                    },
                     upstreamSpan,
                     logAttempt,
                     logProxyBody,

package/dist/types/proxy.d.ts

@@ -459,6 +459,12 @@ export type RequestAttemptLogEntry = {
     responseTimeMs: number;
     errorType?: string;
     errorMessage?: string;
+    /** Whether this failed attempt may be retried without changing the request. */
+    retryable?: boolean;
+    /** Distinguishes short-lived admission throttles from exhausted quota windows. */
+    rateLimitKind?: "transient" | "quota";
+    /** Reset-aware cooldown reason selected for a rate-limited attempt. */
+    cooldownReason?: "transient" | "session" | "weekly" | "unified";
     inputTokens?: number;
     outputTokens?: number;
     cacheCreationTokens?: number;
@@ -505,6 +511,11 @@ export type AnthropicAttemptLogger = (status: number, errorType?: string, errorM
     outputTokens?: number;
     cacheCreationTokens?: number;
     cacheReadTokens?: number;
+    retryable?: boolean;
+    rateLimitKind?: "transient" | "quota";
+    cooldownReason?: "transient" | "session" | "weekly" | "unified";
+    /** Override used when one account selection performs an OAuth retry fetch. */
+    attempt?: number;
 }) => void;
 export type AnthropicLoopState = {
     lastError: unknown;
@@ -578,8 +589,9 @@ export type PreparedAnthropicAccountAttempt = {
 };
 /** How to cool an account after a genuine (non-anti-abuse) 429, derived from
  *  the response's quota headers + retry-after. */
+export type RateLimitCoolingReason = Exclude<AccountCoolingReason, "auth">;
 export type AccountCooldownPlan = {
-    reason: AccountCoolingReason;
+    reason: RateLimitCoolingReason;
     /** Epoch-ms until which the account should not be used. */
     coolingUntil: number;
     /** When true (unified/5h/7d rejected), rotate immediately — retrying the
@@ -619,19 +631,29 @@ export type AccountStats = {
     label: string;
     type: string;
     attemptCount: number;
+    /** Failed upstream attempts, including retries that later recovered. */
+    attemptErrorCount: number;
+    /** Final requests successfully completed by this account. */
     successCount: number;
+    /** Final requests that terminated as errors on this account. */
     errorCount: number;
+    /** All upstream attempts that returned 429. */
     rateLimitCount: number;
+    transientRateLimitCount: number;
+    quotaRateLimitCount: number;
     lastAttemptAt: number;
     lastErrorAt?: number;
 };
 export type ProxyStats = {
     startedAt: number;
     totalAttempts: number;
+    totalAttemptErrors: number;
     totalRequests: number;
     totalSuccess: number;
     totalErrors: number;
     totalRateLimits: number;
+    totalTransientRateLimits: number;
+    totalQuotaRateLimits: number;
     accounts: Record<string, AccountStats>;
 };
 export type RefreshableAccount = {
@@ -1093,6 +1115,21 @@ export type UpdateState = {
     suppressedVersions: Record<string, SuppressedVersion>;
     lastUpdateAt: string | null;
     lastUpdateVersion: string | null;
+    /** Installed by the updater but not yet confirmed as the running version. */
+    pendingRestartVersion: string | null;
+    /** Last updater failure, retained until a successful update or replacement. */
+    lastFailure: {
+        at: string;
+        version: string;
+        stage: "check" | "install" | "validation" | "restart" | "health";
+        message: string;
+    } | null;
+};
+/** Result of validating a newly installed CLI through the stable trampoline. */
+export type InstalledVersionValidation = {
+    version?: string;
+    attempts: number;
+    failure?: string;
 };
 /** Supported global package managers for proxy self-updates. */
 export type GlobalInstallerKind = "npm" | "pnpm";
@@ -1122,6 +1159,31 @@ export type ResolveGlobalInstallerOptions = {
     homeDir?: string;
     execFileSync?: GlobalInstallerExecFile;
 };
+/** Options for validating a newly installed CLI through its stable executable. */
+export type ValidateInstalledVersionOptions = {
+    binPath: string;
+    expectedVersion: string;
+    maxAttempts?: number;
+    delayMs?: number;
+    timeoutMs?: number;
+    execFileSync?: GlobalInstallerExecFile;
+    sleep?: (ms: number) => Promise<void>;
+};
+/** Dependencies and callbacks used to supervise the updater worker process. */
+export type UpdaterWorkerSupervisorOptions = {
+    spawnWorker: () => number | undefined;
+    isProcessRunning: (pid: number) => boolean;
+    stopWorker: (pid: number) => void;
+    onPidChange?: (pid: number | undefined) => void;
+    log?: (message: string) => void;
+    intervalMs?: number;
+};
+/** Handle used by the proxy process to inspect and stop updater supervision. */
+export type UpdaterWorkerSupervisor = {
+    currentPid: () => number | undefined;
+    checkNow: () => number | undefined;
+    stop: () => void;
+};
 /** 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. */
@@ -1203,10 +1265,13 @@ export type ProxyStartApp = {
 /** Stats shape consumed by the proxy status printer. */
 export type StatusStats = {
     totalAttempts?: number;
+    totalAttemptErrors?: number;
     totalRequests: number;
     totalSuccess: number;
     totalErrors: number;
     totalRateLimits: number;
+    totalTransientRateLimits?: number;
+    totalQuotaRateLimits?: number;
     accounts?: {
         label: string;
         type: string;
@@ -1214,7 +1279,10 @@ export type StatusStats = {
         requests?: number;
         success?: number;
         errors?: number;
+        attemptErrors?: number;
         rateLimits?: number;
+        transientRateLimits?: number;
+        quotaRateLimits?: number;
         cooling: boolean;
     }[];
 };

package/package.json

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