@juspay/neurolink 10.12.2 → 10.12.3

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [10.12.3](https://github.com/juspay/neurolink/compare/v10.12.2...v10.12.3) (2026-08-14)
+
+### Bug Fixes
+
+- **(proxy):** attribute runtime errors internally ([258ca34](https://github.com/juspay/neurolink/commit/258ca3435e4fe0d52abbb327c59a599444ffd302))
+- **(proxy):** diagnose updater health probe failures ([41e3c9e](https://github.com/juspay/neurolink/commit/41e3c9e94d84d89d8c4ad3ff9b020bdb9cb475e4))
+
 ## [10.12.2](https://github.com/juspay/neurolink/compare/v10.12.1...v10.12.2) (2026-08-14)
 
 ### Bug Fixes

package/dist/cli/commands/proxy.d.ts

@@ -11,7 +11,7 @@
  */
 import type { CommandModule } from "yargs";
 import type { Hono } from "hono";
-import type { AccountAllowlist, LoadedProxyConfig, ModelRouterInterface, ProxyGuardArgs, ProxyNeurolinkRuntime, ProxyStartArgs, ProxyStartStrategy, ProxySupervisorState, ProxyStatusArgs, ProxyTelemetryArgs, ProxyReadinessState } from "../../lib/types/index.js";
+import type { AccountAllowlist, LoadedProxyConfig, ModelRouterInterface, ProxyGuardArgs, ProxyHealthProbe, ProxyNeurolinkRuntime, ProxyStartArgs, ProxyStartStrategy, ProxySupervisorState, ProxyStatusArgs, ProxyTelemetryArgs, ProxyReadinessState } from "../../lib/types/index.js";
 import { ProxyRuntimeConfigStore } from "../../lib/proxy/runtimeConfig.js";
 /**
  * Drop a supervisor `version` that is not a string.
@@ -58,6 +58,7 @@ export declare function isRollingHandoffCapable(state: ProxySupervisorState | nu
  *   confirm a mismatch" and falls through to the args-only result.
  */
 export declare function processLooksLikeProxySupervisor(pid: number, expectedStartTimeIso?: string): Promise<boolean>;
+export declare function probeProxyHealth(host: string, port: number, timeoutMs: number): Promise<ProxyHealthProbe>;
 export declare function mapClaudeErrorTypeToStatus(errorType?: string): number;
 export declare function createProxyStartApp(params: {
     neurolink: ProxyNeurolinkRuntime["neurolink"];

package/dist/cli/commands/proxy.js

@@ -41,6 +41,7 @@ import packageJson from "../../../package.json" with { type: "json" };
 const _require = createRequire(import.meta.url);
 const PROXY_VERSION = packageJson.version;
 const PROXY_INTERNAL_ACCOUNT_LABEL = "proxy/internal";
+const PROXY_INTERNAL_ACCOUNT_TYPE = "internal";
 const PROXY_TELEMETRY_SCRIPT_PATH = fileURLToPath(new URL("../../../scripts/observability/manage-local-openobserve.sh", import.meta.url));
 const PROXY_LIFECYCLE_SHUTDOWN_TIMEOUT_MS = 5_000;
 const LEGACY_STATUS_ACCOUNT_CACHE_TTL_MS = 5_000;
@@ -623,17 +624,51 @@ async function clearOpenCodeProxySettings(expectedBaseUrl) {
     fs.writeFileSync(OPENCODE_CONFIG_PATH, JSON.stringify(config, null, 2));
     return hadNeurolink;
 }
-async function isProxyHealthy(host, port, timeoutMs) {
+export async function probeProxyHealth(host, port, timeoutMs) {
+    const startedAt = Date.now();
     try {
         const response = await fetch(`http://${host}:${port}/health`, {
             signal: AbortSignal.timeout(timeoutMs),
         });
-        return response.ok;
+        return {
+            healthy: response.ok,
+            durationMs: Date.now() - startedAt,
+            failure: response.ok ? null : "http_status",
+            statusCode: response.status,
+            errorCode: null,
+        };
     }
-    catch {
-        return false;
+    catch (error) {
+        const candidate = error;
+        const cause = candidate?.cause;
+        const errorCode = typeof candidate?.code === "string"
+            ? candidate.code
+            : typeof cause?.code === "string"
+                ? cause.code
+                : typeof candidate?.name === "string"
+                    ? candidate.name
+                    : null;
+        const isTimeout = candidate?.name === "TimeoutError" || candidate?.name === "AbortError";
+        return {
+            healthy: false,
+            durationMs: Date.now() - startedAt,
+            failure: isTimeout ? "timeout" : "network",
+            statusCode: null,
+            errorCode,
+        };
     }
 }
+function formatProxyHealthProbe(probe) {
+    const details = [
+        `reason=${probe.failure ?? "none"}`,
+        `durationMs=${probe.durationMs}`,
+        probe.statusCode === null ? null : `status=${probe.statusCode}`,
+        probe.errorCode === null
+            ? null
+            : `errorCode=${sanitizeForLog(probe.errorCode)}`,
+    ].filter((detail) => detail !== null);
+    return details.join(" ");
+}
 async function getProxyRuntimeActivity(host, port, timeoutMs = 3_000) {
     try {
         const response = await fetch(`http://${host}:${port}/status`, {
@@ -1312,7 +1347,7 @@ export async function createProxyStartApp(params) {
     const recordRuntimeError = async (metadata, status, errorType, errorMessage, options) => {
         const clientMessage = options?.clientMessage ?? errorMessage;
         const clientErrorType = options?.clientErrorType ?? errorType;
-        recordFinalError(status, undefined, undefined, {
+        recordFinalError(status, PROXY_INTERNAL_ACCOUNT_LABEL, PROXY_INTERNAL_ACCOUNT_TYPE, {
             requestId: metadata.requestId,
             errorType,
             errorCode: options?.errorCode,
@@ -3730,19 +3765,23 @@ export const proxyGuardCommand = {
         const startedAt = Date.now();
         let parentStatus = getProcessStatus(parentPid);
         let consecutiveUnhealthy = 0;
+        let lastUnhealthyProbe = null;
         // Keep monitoring for as long as the parent can affect Claude settings.
         while (true) {
-            const healthy = await isProxyHealthy(host, port, 1_500);
+            const healthProbe = await probeProxyHealth(host, port, 1_500);
+            const healthy = healthProbe.healthy;
             if (healthy) {
                 if (updaterOnly && consecutiveUnhealthy >= failureThreshold) {
-                    logger.always(`[updater] proxy health recovered after ${consecutiveUnhealthy} failed checks`);
+                    logger.always(`[updater] proxy health recovered after ${consecutiveUnhealthy} failed checks; ${formatProxyHealthProbe(lastUnhealthyProbe ?? healthProbe)}`);
                 }
                 consecutiveUnhealthy = 0;
+                lastUnhealthyProbe = null;
             }
             else {
                 consecutiveUnhealthy += 1;
+                lastUnhealthyProbe = healthProbe;
                 if (updaterOnly && consecutiveUnhealthy === failureThreshold) {
-                    logger.always(`[updater] proxy health unavailable after ${consecutiveUnhealthy} checks; worker remains active`);
+                    logger.always(`[updater] proxy health unavailable after ${consecutiveUnhealthy} checks; worker remains active; ${formatProxyHealthProbe(healthProbe)}`);
                 }
             }
             if (parentStatus === "not_running" && !updateRestartInProgress) {

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

@@ -1861,6 +1861,14 @@ export type UpdateCheckResult = {
     latestVersion: string;
     updateAvailable: boolean;
 };
+/** Result of one local proxy health probe by the updater or fail-open guard. */
+export type ProxyHealthProbe = {
+    healthy: boolean;
+    durationMs: number;
+    failure: "http_status" | "network" | "timeout" | null;
+    statusCode: number | null;
+    errorCode: string | null;
+};
 /** Parsed major.minor.patch components of a semver string. */
 export type SemVer = {
     major: number;

package/dist/types/proxy.d.ts

@@ -1861,6 +1861,14 @@ export type UpdateCheckResult = {
     latestVersion: string;
     updateAvailable: boolean;
 };
+/** Result of one local proxy health probe by the updater or fail-open guard. */
+export type ProxyHealthProbe = {
+    healthy: boolean;
+    durationMs: number;
+    failure: "http_status" | "network" | "timeout" | null;
+    statusCode: number | null;
+    errorCode: string | null;
+};
 /** Parsed major.minor.patch components of a semver string. */
 export type SemVer = {
     major: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "10.12.2",
+  "version": "10.12.3",
   "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": {