@juspay/neurolink 12.49.1 → 12.49.2

package/dist/core/geminiLoopAdapter.js

@@ -220,9 +220,15 @@ export function createGeminiLoopAdapter(config) {
         },
         mapFinishReason(rawStopReason, hadToolCallsAtCap) {
             const mapped = mapGeminiFinishReason(rawStopReason);
-            // A turn cut off at the step cap ended because of the cap, not because
-            // the last response said "STOP".
-            return hadToolCallsAtCap && mapped === "stop" ? "tool-calls" : mapped;
+            // "tool-calls" from this hook means the step cap cut the turn off with
+            // calls still pending, so a last response that said "STOP" does not make
+            // it a finished turn. Gemini's own tool-call limit (TOO_MANY_TOOL_CALLS)
+            // also maps to "tool-calls" on the turn's result, but it is not that
+            // cap, so it counts here only when the cap was actually hit.
+            if (mapped === "stop" || mapped === "tool-calls") {
+                return hadToolCallsAtCap ? "tool-calls" : "stop";
+            }
+            return mapped;
         },
     };
 }

package/dist/providers/googleNativeGemini3/utils.d.ts

@@ -110,21 +110,35 @@ export declare function computeMaxSteps(rawMaxSteps?: number): number;
  * Map a `@google/genai` `Candidate.finishReason` enum value onto NeuroLink's
  * unified finish reason, mirroring anthropic.ts `mapAnthropicStopReason`.
  *
- * Enum values per `@google/genai` `FinishReason`: STOP, MAX_TOKENS, SAFETY,
- * RECITATION, LANGUAGE, OTHER, BLOCKLIST, PROHIBITED_CONTENT, SPII,
- * MALFORMED_FUNCTION_CALL, IMAGE_SAFETY, UNEXPECTED_TOOL_CALL,
- * FINISH_REASON_UNSPECIFIED. Unknown / unset / non-terminal values default to
- * "stop" (a clean completion is the safe assumption).
+ * Every member of `@google/genai`'s `FinishReason` and where it lands:
+ *
+ * - "length": MAX_TOKENS, and CONTINUATION (the response hit the per-request
+ *   token limit before the model was done; it can be continued with the
+ *   returned continuation token)
+ * - "tool-calls": TOO_MANY_TOOL_CALLS (the model called tools consecutively
+ *   until the system cut the turn off, so it still wanted tools)
+ * - "error": MALFORMED_FUNCTION_CALL, UNEXPECTED_TOOL_CALL
+ * - "content-filter": SAFETY, RECITATION, BLOCKLIST, PROHIBITED_CONTENT, SPII,
+ *   LANGUAGE (generation stopped over an unsupported language), and the image
+ *   refusals IMAGE_SAFETY, IMAGE_PROHIBITED_CONTENT, IMAGE_RECITATION
+ * - "stop": STOP, and the members that name no cause the unified type can
+ *   carry: OTHER, IMAGE_OTHER, NO_IMAGE, FINISH_REASON_UNSPECIFIED. An unknown
+ *   or unset value also reads "stop" (a clean completion is the safe
+ *   assumption), so a member a newer SDK adds needs an explicit case here.
  *
  * Returns a plain string (not a `{ unified, raw }` object): the Vertex result
  * builders and the consuming layer (neurolink.ts `finishReason || "unknown"`
  * and `finishReason === "length"`) compare against plain strings.
  *
  * MALFORMED_FUNCTION_CALL / UNEXPECTED_TOOL_CALL map to "error", NOT
- * "tool-calls": they are provider/model failures, while "tool-calls" is the
- * exclusive contract for "step budget exhausted while the model still wanted
- * tools" — consumers (e.g. curator's step-cap intercept) branch on it and
- * were rendering fake step-limit messages for 2-4-step malformed-call turns.
+ * "tool-calls": they are provider/model failures, while "tool-calls" means the
+ * turn ended with the model still wanting tools because a tool-call budget ran
+ * out: the loop's own step cap, or Gemini's TOO_MANY_TOOL_CALLS limit. Consumers
+ * (e.g. curator's step-cap intercept) branch on it and were rendering fake
+ * step-limit messages for 2-4-step malformed-call turns. `stopReason` is the
+ * discriminator that tells the two budgets apart: TOO_MANY_TOOL_CALLS reads
+ * "tool-calls" here but stays `stopReason: "completed"`, because `maxSteps` did
+ * not run out.
  */
 export declare function mapGeminiFinishReason(raw: string | null | undefined): "stop" | "length" | "tool-calls" | "content-filter" | "error";
 /**

package/dist/providers/googleNativeGemini3/utils.js

@@ -491,26 +491,43 @@ export function computeMaxSteps(rawMaxSteps) {
  * Map a `@google/genai` `Candidate.finishReason` enum value onto NeuroLink's
  * unified finish reason, mirroring anthropic.ts `mapAnthropicStopReason`.
  *
- * Enum values per `@google/genai` `FinishReason`: STOP, MAX_TOKENS, SAFETY,
- * RECITATION, LANGUAGE, OTHER, BLOCKLIST, PROHIBITED_CONTENT, SPII,
- * MALFORMED_FUNCTION_CALL, IMAGE_SAFETY, UNEXPECTED_TOOL_CALL,
- * FINISH_REASON_UNSPECIFIED. Unknown / unset / non-terminal values default to
- * "stop" (a clean completion is the safe assumption).
+ * Every member of `@google/genai`'s `FinishReason` and where it lands:
+ *
+ * - "length": MAX_TOKENS, and CONTINUATION (the response hit the per-request
+ *   token limit before the model was done; it can be continued with the
+ *   returned continuation token)
+ * - "tool-calls": TOO_MANY_TOOL_CALLS (the model called tools consecutively
+ *   until the system cut the turn off, so it still wanted tools)
+ * - "error": MALFORMED_FUNCTION_CALL, UNEXPECTED_TOOL_CALL
+ * - "content-filter": SAFETY, RECITATION, BLOCKLIST, PROHIBITED_CONTENT, SPII,
+ *   LANGUAGE (generation stopped over an unsupported language), and the image
+ *   refusals IMAGE_SAFETY, IMAGE_PROHIBITED_CONTENT, IMAGE_RECITATION
+ * - "stop": STOP, and the members that name no cause the unified type can
+ *   carry: OTHER, IMAGE_OTHER, NO_IMAGE, FINISH_REASON_UNSPECIFIED. An unknown
+ *   or unset value also reads "stop" (a clean completion is the safe
+ *   assumption), so a member a newer SDK adds needs an explicit case here.
  *
  * Returns a plain string (not a `{ unified, raw }` object): the Vertex result
  * builders and the consuming layer (neurolink.ts `finishReason || "unknown"`
  * and `finishReason === "length"`) compare against plain strings.
  *
  * MALFORMED_FUNCTION_CALL / UNEXPECTED_TOOL_CALL map to "error", NOT
- * "tool-calls": they are provider/model failures, while "tool-calls" is the
- * exclusive contract for "step budget exhausted while the model still wanted
- * tools" — consumers (e.g. curator's step-cap intercept) branch on it and
- * were rendering fake step-limit messages for 2-4-step malformed-call turns.
+ * "tool-calls": they are provider/model failures, while "tool-calls" means the
+ * turn ended with the model still wanting tools because a tool-call budget ran
+ * out: the loop's own step cap, or Gemini's TOO_MANY_TOOL_CALLS limit. Consumers
+ * (e.g. curator's step-cap intercept) branch on it and were rendering fake
+ * step-limit messages for 2-4-step malformed-call turns. `stopReason` is the
+ * discriminator that tells the two budgets apart: TOO_MANY_TOOL_CALLS reads
+ * "tool-calls" here but stays `stopReason: "completed"`, because `maxSteps` did
+ * not run out.
  */
 export function mapGeminiFinishReason(raw) {
     switch (raw) {
         case "MAX_TOKENS":
+        case "CONTINUATION":
             return "length";
+        case "TOO_MANY_TOOL_CALLS":
+            return "tool-calls";
         case "MALFORMED_FUNCTION_CALL":
         case "UNEXPECTED_TOOL_CALL":
             return "error";
@@ -519,7 +536,10 @@ export function mapGeminiFinishReason(raw) {
         case "BLOCKLIST":
         case "PROHIBITED_CONTENT":
         case "SPII":
+        case "LANGUAGE":
         case "IMAGE_SAFETY":
+        case "IMAGE_PROHIBITED_CONTENT":
+        case "IMAGE_RECITATION":
             return "content-filter";
         default:
             return "stop";

package/docs-site/static/search-index.json

@@ -4604,6 +4604,7 @@
 {"objectID":"8569960f5df3455464e766e118794ee1116e63943713b4e396669abb164ea759","title":"stopReason — the turn-exit discriminator","url":"/docs/features/turn-time-budget#stopreason-the-turn-exit-discriminator","content":"finishReason is provider-shaped and historically overloaded (\"tool-calls\"\ncovered both step-cap exits and Gemini MALFORMED_FUNCTION_CALL failures).\nBranch on result.stopReason instead:\n\n| stopReason     | Meaning                                                            |\n| ---------------- | ------------------------------------------------------------------ |\n| completed      | The model finished on its own (text answer or final_result)      |\n| step-cap       | The maxSteps budget ran out while the model still wanted tools   |\n| time-limit     | The turnTimeoutMs (or defensive) wall-clock deadline passed      |\n| stalled        | No progress for stallTimeoutMs                                   |\n| aborted        | The caller's abortSignal ended the turn                          |\n| context-cap    | The in-loop context guard stopped the turn (Vertex loops only)     |\n| provider-error | Provider/model failure (e.g. persistent MALFORMED_FUNCTION_CALL) |\n\nA loop only reports what it can observe. The AI Studio loops never report\ncontext-cap, because their context guard reclaims room or does nothing — it\nhas no stop-the-turn branch to report.\n\nAlso on the result: rawFinishReason (the verbatim provider value, e.g.\nMALFORMED_FUNCTION_CALL, max_tokens) and stepsUsed. On stream()\nresults, read metadata.stopReason / metadata.rawFinishReason /\nmetadata.stepsUsed after draining the stream — background loops resolve\nthem at close, and metadata is the mutable reference that survives wrapper\nspreads.\n\nProviders without a native loop leave stopReason undefined — keep any\nlegacy finishReason heuristics as a fallback.","hierarchy":{"lvl0":"Features","lvl1":"Turn Time Budget","lvl2":"stopReason — the turn-exit discriminator","lvl3":""}},
 {"objectID":"beefbc9fd412625dfb71572fe43e8c19a1634aa91a3778825806507e43eb5f84","title":"Honest terminal messages","url":"/docs/features/turn-time-budget#honest-terminal-messages","content":"Each exit cause has its own user-facing message; the step-cap text\n(\"...reached the N-step limit...\") is emitted only when step >= maxSteps\ngenuinely terminated the loop:\ntime-limit: _\"I had to stop after Xm Ys — this turn hit its processing time\n  limit. I completed N tool calls before stopping; ask me to continue and\n  I'll pick up from there.\"_\nstalled: _\"I had to stop because this turn made no progress for Xs — a tool\n  or model call appears to be stuck. ...\"_\naborted: \"This turn was stopped before I could finish. ...\"","hierarchy":{"lvl0":"Features","lvl1":"Turn Time Budget","lvl2":"Honest terminal messages","lvl3":""}},
 {"objectID":"8a1f451537135b3f1ef892866610bb0dbabfe58ed1764bac2753046b8da98222","title":"MALFORMED_FUNCTION_CALL handling","url":"/docs/features/turn-time-budget#malformed_function_call-handling","content":"Gemini's MALFORMED_FUNCTION_CALL / UNEXPECTED_TOOL_CALL finish reasons\nmap to unified finishReason: \"error\" (never \"tool-calls\"). A\nMALFORMED_FUNCTION_CALL step is retried once with a corrective note;\nif it persists, the turn ends with stopReason: \"provider-error\" — usually\nworth a caller-side retry.","hierarchy":{"lvl0":"Features","lvl1":"Turn Time Budget","lvl2":"MALFORMED_FUNCTION_CALL handling","lvl3":""}},
+{"objectID":"b858770b3853e797dfaac8ecfbd0c1f86c320e6a94e46a2e60f8407f328f6090","title":"Other Gemini finish reasons","url":"/docs/features/turn-time-budget#other-gemini-finish-reasons","content":"The native Gemini loops (AI Studio and Vertex) map the SDK's finish reason onto\nthe unified values below and keep the verbatim value in rawFinishReason.\nVertex puts the unified value on finishReason; on AI Studio it is the\nunified field of the finish part that model middleware receives.\n\n| Gemini finish reason                                                                      | finishReason   |\n| ----------------------------------------------------------------------------------------- | ---------------- |\n| MAX_TOKENS, CONTINUATION (token limit reached before the model was done)              | length         |\n| TOO_MANY_TOOL_CALLS (the model called tools until the system cut the turn off)          | tool-calls     |\n| MALFORMED_FUNCTION_CALL, UNEXPECTED_TOOL_CALL                                         | error          |\n| SAFETY, RECITATION, BLOCKLIST, PROHIBITED_CONTENT, SPII, LANGUAGE, IMAGE_*¹ | content-filter |\n| STOP, OTHER, FINISH_REASON_UNSPECIFIED, IMAGE_OTHER, NO_IMAGE                   | stop           |\n\n¹ IMAGE_SAFETY, IMAGE_PROHIBITED_CONTENT and IMAGE_RECITATION.\n\ntool-calls also marks a turn that ran out of maxSteps, so branch on\nstopReason to tell the two apart: TOO_MANY_TOOL_CALLS leaves\nstopReason: \"completed\", a spent step budget reports step-cap. A value the\nSDK adds later reads stop until it is mapped.","hierarchy":{"lvl0":"Features","lvl1":"Turn Time Budget","lvl2":"Other Gemini finish reasons","lvl3":""}},
 {"objectID":"a975fa8c9a970f09409f0cd78f26180dbef30bebfc60396f0eebda7776d8a3c3","title":"Telemetry","url":"/docs/features/turn-time-budget#telemetry","content":"result.analytics (when enableAnalytics is on) carries stepsUsed,\n  toolCallCount, stopReason, elapsedMs, rawFinishReason.\nThe SDK emitter fires turn:lifecycle events (alongside\n  tool:start/tool:end) for non-completed exits, tool timeouts, and\n  malformed-call retries:","hierarchy":{"lvl0":"Features","lvl1":"Turn Time Budget","lvl2":"Telemetry","lvl3":""}},
 {"objectID":"4237dd71854673dfa0c8c155353abb6bf61149758ab7cd851436a49841b8dba3","title":"Video Analysis","url":"/docs/features/video-analysis","content":"Video Analysis\n\nComprehensive video analysis for NeuroLink, powered by Gemini 2.0 Flash. This feature goes beyond basic visual description—it provides a deep logical audit of video sequences to understand \"why\" and \"how\" events occur.\n\nKey Capabilities\nLogical Analysis: Dissect any video to extract the underlying intent, cause-and-effect, and logical progression.\nAction-Reaction Chain: A step-by-step audit of user or system actions and their immediate visual results.\nEvidence-Based Reporting: Detailed reasoning backed by structured visual indicators (colors, labels, text) in JSON format.\nStrategic Verdicts: High-level assessments of whether a workflow succeeded or failed logically.\n\nQuick Start\n\nHow It Works\nFrame Extraction: The system uses ffmpeg to extract high-quality keyframes from the video at calculated intervals.\nAnalysis Pipeline: These frames are sent to Gemini 2.0 Flash with a specialized system instruction focused on critical logic auditing.\nUnified Results: The resulting report is added directly to your standard generation output.\n\nUsage\n\nCLI Usage\n\nAnalyze any video file with a natural language prompt.\n\nSDK Usage\n\nIntegrate video analysis into your TypeScript/JavaScript projects.\n\nAdvanced SDK Examples\n\nCustom Model Configuration\nFine-tune the analysis by adjusting token limits and temperature.\n\nDisabling Tool Interference\nBy default, the model might try to use available tools. For pure video analysis, you can disable them.\n\nExamples\nUI/UX Bug Analysis\n\nIdentify why a user is unable to complete a form or where the interface is misleading.\n\nPrompt: \"Find why the user is getting stuck at the payment step. Look for validation errors or hidden UI elements.\"\nSilent Failure Detection\n\nDetect cases where an action is taken but the system provides no feedback (no loaders, no success messages).\n\nPrompt: \"Audit the 'Submit' button click. Is there a visual 'bond' between the click and the next state? Report any lag or missing loading indicators.\"\nWorkflow Validation\n\nVerify if a complex multi-step process follows the intended business logic.\n\nPrompt: \"Trace the logical progression from 'Item Selection' to 'Checkout'. Does every state change correspond to a user action?\"\nComparison Analysis\n\nCompare two recordings to find discrepancies in behavior.\n\nPrompt: \"Compare these two clips. The first one is the expected behavior and the second one has a bug. Identify the exact frame or timestamp where the logic deviates.\"\n\nCommand Gallery\n\nQuick CLI recipes for common tasks:\n\nThe Analysis Report\n\nThe output is structured into four major sections designed to give you a complete understanding of the video:\nStrategic Overview & Intent: Defines the core activity, expected logic, and provides a primary verdict.\nThe Action-Reaction Chain: A granular, step-by-step audit of attempts, results, and technical inferences.\nCritical Findings: Categorized milestones or anomalies with root cause analysis and visual evidence in JSON.\nFinal Assessment: A conclusive summary of the logical flow based on the observed evidence.\n\nBest Practices\nFrame Depth: Short videos (under 10s) get high-density frame coverage (1 per second), while long ones are intelligently sampled.\nPrompt Precision: While the model is a \"Critical Logic Auditor,\" you can guide it with specific questions about the activity.\nFormat: The analysis is returned as text in result.content, making it easy to store, display, or pipe to other tools.","hierarchy":{"lvl0":"Features","lvl1":"Video Analysis","lvl2":"","lvl3":""}},
 {"objectID":"288c031674e78fd4fcd753b2d753bff8b085367a321fac3e9845113df6361a2d","title":"Video Analysis","url":"/docs/features/video-analysis#video-analysis","content":"Comprehensive video analysis for NeuroLink, powered by Gemini 2.0 Flash. This feature goes beyond basic visual description—it provides a deep logical audit of video sequences to understand \"why\" and \"how\" events occur.","hierarchy":{"lvl0":"Features","lvl1":"Video Analysis","lvl2":"Video Analysis","lvl3":""}},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "12.49.1",
+  "version": "12.49.2",
   "packageManager": "pnpm@10.15.1",
   "description": "The pipe layer of an AI nervous system: one interface connecting provider neurons to your application, across three inference types — generate, stream and decide. `decide` returns typed, calibrated judgements from a non-generative model (~400ms, ~$0.00002/call) for routing, tool selection and context budgeting. MCP-native (4 transports), voice TTS/STT/realtime, RAG, agents, memory, compaction, 9 observability exporters. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · TypeSafe Jev and more.",
   "author": {