@juspay/neurolink 9.80.2 → 9.80.4

package/dist/types/generate.d.ts

@@ -296,6 +296,19 @@ export type GenerateOptions = {
      * ```
      */
     enabledToolNames?: string[];
+    /**
+     * Request timeout (e.g. 30000, '30s', '2m').
+     *
+     * PER-STEP semantics in agentic loops: on providers that run a native
+     * multi-step tool loop (Vertex Gemini / Vertex Claude), this bounds EACH
+     * model call in the loop, not the whole turn — a tool-heavy turn may run
+     * far longer than this value in total. Size it for the slowest single
+     * step (default 300s), and use `abortSignal` for a total-turn deadline.
+     *
+     * When set explicitly, a step timeout is surfaced immediately instead of
+     * burning internal retries/fallbacks that would re-run the same
+     * provider+model with the same doomed budget.
+     */
     timeout?: number | string;
     /** AbortSignal for external cancellation of the AI call */
     abortSignal?: AbortSignal;

package/dist/types/stream.d.ts

@@ -536,6 +536,7 @@ export type StreamResult = {
         hasToolErrors?: boolean;
         guardrailsBlocked?: boolean;
         error?: string;
+        finishReason?: string;
         thoughtSignature?: string;
         thoughts?: Array<{
             id?: string;

package/dist/utils/conversationMemory.js

@@ -5,6 +5,7 @@
 import { SpanKind, SpanStatusCode } from "@opentelemetry/api";
 import { tracers } from "../telemetry/tracers.js";
 import { withTimeout } from "./errorHandling.js";
+import { safeDebugSerialize, sanitizeRecord } from "./logSanitize.js";
 import { DEFAULT_FALLBACK_THRESHOLD, getConversationMemoryDefaults, MEMORY_THRESHOLD_PERCENTAGE, } from "../config/conversationMemory.js";
 import { getAvailableInputTokens } from "../constants/contextWindows.js";
 import { buildSummarizationPrompt } from "../context/prompts/summarizationPrompt.js";
@@ -106,20 +107,30 @@ export function applyConversationMemoryDefaults(userConfig) {
  * Get conversation history as message array, summarizing if needed.
  */
 export async function getConversationMessages(conversationMemory, options) {
-    logger.debug("[conversationMemoryUtils] getConversationMessages called", {
-        hasMemory: !!conversationMemory,
-        memoryType: conversationMemory?.constructor?.name || "NONE",
-        hasContext: !!options.context,
-        enableSummarization: options.enableSummarization ?? false,
-        options: JSON.stringify(options, null, 2),
-    });
+    // Logger Guard: options carries the full conversation history + tool
+    // outputs; eager JSON.stringify of it can throw RangeError: Invalid string
+    // length and abort the turn. Serialize lazily, bounded, never-throwing,
+    // and redacted (sanitizeRecord strips credential/PII keys).
+    if (logger.shouldLog("debug")) {
+        logger.debug("[conversationMemoryUtils] getConversationMessages called", {
+            hasMemory: !!conversationMemory,
+            memoryType: conversationMemory?.constructor?.name || "NONE",
+            hasContext: !!options.context,
+            enableSummarization: options.enableSummarization ?? false,
+            options: safeDebugSerialize(sanitizeRecord(options)),
+        });
+    }
     if (!conversationMemory || !options.context) {
         logger.warn("[conversationMemoryUtils] No memory or context, returning empty messages", {
             hasMemory: !!conversationMemory,
             memoryType: conversationMemory?.constructor?.name || "NONE",
             hasContext: !!options.context,
             enableSummarization: options.enableSummarization ?? false,
-            options: JSON.stringify(options, null, 2),
+            // The options dump is debug-grade detail — don't pay for (or leak)
+            // the serialization on every memory-disabled call at warn level.
+            ...(logger.shouldLog("debug")
+                ? { options: safeDebugSerialize(sanitizeRecord(options)) }
+                : {}),
         });
         return [];
     }

package/dist/utils/logSanitize.d.ts

@@ -26,6 +26,32 @@
  * @param maxLen - Maximum number of characters to keep (default 500).
  */
 export declare function sanitizeForLog(text: string, maxLen?: number): string;
+/**
+ * Stringify non-string message/tool content without ever throwing.
+ * JSON.stringify on a giant multimodal/tool-result payload can exceed V8's
+ * maximum string length and throw `RangeError: Invalid string length` — a
+ * generation turn must degrade to a placeholder, not abort, when that
+ * happens. Shared by the SDK core and providers (single source of truth).
+ */
+export declare function stringifyContentSafe(content: unknown): string;
+/**
+ * Serialize an arbitrary value for a debug log without ever throwing or
+ * producing an unbounded string.
+ *
+ * `JSON.stringify` on a full options object (conversation history + tool
+ * outputs) can exceed V8's maximum string length and throw
+ * `RangeError: Invalid string length`, which — when evaluated eagerly inside
+ * a logger call — aborts the surrounding generation turn (observed in
+ * production). This helper caps the output and converts any stringify
+ * failure (RangeError, circular structure, BigInt, …) into a placeholder.
+ *
+ * Callers MUST still gate on `logger.shouldLog("debug")` per the Logger
+ * Guard rule — this helper makes serialization safe, not free.
+ *
+ * @param value  - Arbitrary value to serialize.
+ * @param maxLen - Maximum number of characters to keep (default 10 000).
+ */
+export declare function safeDebugSerialize(value: unknown, maxLen?: number): string;
 /**
  * Strip embedded `user:pass@` credentials from a URL's authority component
  * before logging it or surfacing it in a user-facing error.

package/dist/utils/logSanitize.js

@@ -74,6 +74,13 @@ const SENSITIVE_OBJECT_KEYS = [
     "oauth",
     "oauthToken",
     "credentials",
+    "authContext",
+    "authToken",
+    "sessionToken",
+    "serviceAccountKey",
+    "secretAccessKey",
+    // PII, not a secret — but it has no business in debug log dumps.
+    "userEmail",
 ];
 /**
  * Truncate `text` to `maxLen` chars then replace embedded secrets with `***`.
@@ -91,6 +98,55 @@ export function sanitizeForLog(text, maxLen = 500) {
     }
     return text.slice(0, maxLen).replace(SECRET_PATTERN, "***");
 }
+/**
+ * Stringify non-string message/tool content without ever throwing.
+ * JSON.stringify on a giant multimodal/tool-result payload can exceed V8's
+ * maximum string length and throw `RangeError: Invalid string length` — a
+ * generation turn must degrade to a placeholder, not abort, when that
+ * happens. Shared by the SDK core and providers (single source of truth).
+ */
+export function stringifyContentSafe(content) {
+    if (typeof content === "string") {
+        return content;
+    }
+    try {
+        return JSON.stringify(content) ?? String(content);
+    }
+    catch {
+        return "[content too large to serialize]";
+    }
+}
+/**
+ * Serialize an arbitrary value for a debug log without ever throwing or
+ * producing an unbounded string.
+ *
+ * `JSON.stringify` on a full options object (conversation history + tool
+ * outputs) can exceed V8's maximum string length and throw
+ * `RangeError: Invalid string length`, which — when evaluated eagerly inside
+ * a logger call — aborts the surrounding generation turn (observed in
+ * production). This helper caps the output and converts any stringify
+ * failure (RangeError, circular structure, BigInt, …) into a placeholder.
+ *
+ * Callers MUST still gate on `logger.shouldLog("debug")` per the Logger
+ * Guard rule — this helper makes serialization safe, not free.
+ *
+ * @param value  - Arbitrary value to serialize.
+ * @param maxLen - Maximum number of characters to keep (default 10 000).
+ */
+export function safeDebugSerialize(value, maxLen = 10_000) {
+    try {
+        const json = JSON.stringify(value);
+        if (json === undefined) {
+            return String(value);
+        }
+        return json.length > maxLen
+            ? `${json.slice(0, maxLen)}…[truncated ${json.length - maxLen} chars]`
+            : json;
+    }
+    catch (error) {
+        return `[unserializable: ${error instanceof Error ? error.message : String(error)}]`;
+    }
+}
 /**
  * Strip embedded `user:pass@` credentials from a URL's authority component
  * before logging it or surfacing it in a user-facing error.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.80.2",
+  "version": "9.80.4",
   "packageManager": "pnpm@10.15.1",
   "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": {
@@ -96,6 +96,7 @@
     "test:tool-reliability": "npx tsx test/continuous-test-suite-tool-reliability.ts",
     "test:google-native": "npx tsx test/continuous-test-suite-google-native.ts",
     "test:gemini-abort": "npx tsx test/continuous-test-suite-gemini-abort.ts",
+    "test:anthropic-cap": "npx tsx test/continuous-test-suite-anthropic-cap.ts",
     "test:tts": "npx tsx test/continuous-test-suite-tts.ts",
     "test:voice": "npx tsx test/continuous-test-suite-voice.ts",
     "test:voice-server": "npx tsx test/continuous-test-suite-voice-server.ts",