@juspay/neurolink 9.19.1 → 9.20.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [9.20.0](https://github.com/juspay/neurolink/compare/v9.19.1...v9.20.0) (2026-03-09)
+
+### Features
+
+- **(landing):** redesign nervous system visualization with performance and mobile fixes ([a4c7e91](https://github.com/juspay/neurolink/commit/a4c7e91a22622b41821db09e17885a54b26c66aa))
+
 ## [9.19.1](https://github.com/juspay/neurolink/compare/v9.19.0...v9.19.1) (2026-03-07)
 
 ### Bug Fixes

package/dist/context/stages/slidingWindowTruncator.js

@@ -11,10 +11,19 @@
  * - Small conversation handling (BUG-005): for <= 4 messages, truncates
  *   message content proportionally instead of returning no-op.
  */
-import { randomUUID } from "crypto";
 import { estimateTokens, estimateMessagesTokens, truncateToTokenBudget, } from "../../utils/tokenEstimation.js";
 import { logger } from "../../utils/logger.js";
+import { randomUUID } from "crypto";
 const TRUNCATION_MARKER_CONTENT = "[Earlier conversation history was truncated to fit within context limits]";
+function validateRoleAlternation(messages) {
+    for (let i = 1; i < messages.length; i++) {
+        if (messages[i].role === messages[i - 1].role &&
+            messages[i].role !== "system") {
+            logger.warn(`[SlidingWindowTruncator] Role alternation broken at index ${i}: consecutive "${messages[i].role}" messages`);
+            break;
+        }
+    }
+}
 /**
  * For conversations with <= 4 messages that exceed token budget,
  * truncate the CONTENT of the longest messages rather than removing messages.
@@ -122,18 +131,19 @@ export function truncateWithSlidingWindow(messages, config) {
             break;
         }
         const keptAfterTruncation = remainingMessages.slice(evenRemoveCount);
-        const truncationMarker = {
-            id: `truncation-${randomUUID()}`,
-            role: "user",
+        // Insert a dedicated system-role truncation marker with machine-readable
+        // metadata so effectiveHistory.ts can detect it via isTruncationMarker /
+        // truncationId and removeTruncationTags can rewind it.
+        const truncId = randomUUID();
+        const marker = {
+            id: `truncation-marker-${truncId}`,
+            role: "system",
             content: TRUNCATION_MARKER_CONTENT,
-            timestamp: new Date().toISOString(),
-            metadata: { isSummary: false, truncated: true },
+            isTruncationMarker: true,
+            truncationId: truncId,
         };
-        const candidateMessages = [
-            ...firstPair,
-            truncationMarker,
-            ...keptAfterTruncation,
-        ];
+        const candidateMessages = [...firstPair, marker, ...keptAfterTruncation];
+        validateRoleAlternation(candidateMessages);
         // If we have token targets, verify the result fits
         if (config?.targetTokens) {
             const candidateTokens = estimateMessagesTokens(candidateMessages, config.provider);
@@ -160,16 +170,20 @@ export function truncateWithSlidingWindow(messages, config) {
     const evenMaxRemove = maxRemove - (maxRemove % 2);
     if (evenMaxRemove > 0) {
         const keptMessages = remainingMessages.slice(evenMaxRemove);
-        const truncationMarker = {
-            id: `truncation-${randomUUID()}`,
-            role: "user",
+        // Insert a dedicated system-role truncation marker (see iterative block above)
+        const fallbackTruncId = randomUUID();
+        const fallbackMarker = {
+            id: `truncation-marker-${fallbackTruncId}`,
+            role: "system",
             content: TRUNCATION_MARKER_CONTENT,
-            timestamp: new Date().toISOString(),
-            metadata: { isSummary: false, truncated: true },
+            isTruncationMarker: true,
+            truncationId: fallbackTruncId,
         };
+        const fallbackMessages = [...firstPair, fallbackMarker, ...keptMessages];
+        validateRoleAlternation(fallbackMessages);
         return {
             truncated: true,
-            messages: [...firstPair, truncationMarker, ...keptMessages],
+            messages: fallbackMessages,
             messagesRemoved: evenMaxRemove,
         };
     }

package/dist/lib/context/stages/slidingWindowTruncator.js

@@ -11,10 +11,19 @@
  * - Small conversation handling (BUG-005): for <= 4 messages, truncates
  *   message content proportionally instead of returning no-op.
  */
-import { randomUUID } from "crypto";
 import { estimateTokens, estimateMessagesTokens, truncateToTokenBudget, } from "../../utils/tokenEstimation.js";
 import { logger } from "../../utils/logger.js";
+import { randomUUID } from "crypto";
 const TRUNCATION_MARKER_CONTENT = "[Earlier conversation history was truncated to fit within context limits]";
+function validateRoleAlternation(messages) {
+    for (let i = 1; i < messages.length; i++) {
+        if (messages[i].role === messages[i - 1].role &&
+            messages[i].role !== "system") {
+            logger.warn(`[SlidingWindowTruncator] Role alternation broken at index ${i}: consecutive "${messages[i].role}" messages`);
+            break;
+        }
+    }
+}
 /**
  * For conversations with <= 4 messages that exceed token budget,
  * truncate the CONTENT of the longest messages rather than removing messages.
@@ -122,18 +131,19 @@ export function truncateWithSlidingWindow(messages, config) {
             break;
         }
         const keptAfterTruncation = remainingMessages.slice(evenRemoveCount);
-        const truncationMarker = {
-            id: `truncation-${randomUUID()}`,
-            role: "user",
+        // Insert a dedicated system-role truncation marker with machine-readable
+        // metadata so effectiveHistory.ts can detect it via isTruncationMarker /
+        // truncationId and removeTruncationTags can rewind it.
+        const truncId = randomUUID();
+        const marker = {
+            id: `truncation-marker-${truncId}`,
+            role: "system",
             content: TRUNCATION_MARKER_CONTENT,
-            timestamp: new Date().toISOString(),
-            metadata: { isSummary: false, truncated: true },
+            isTruncationMarker: true,
+            truncationId: truncId,
         };
-        const candidateMessages = [
-            ...firstPair,
-            truncationMarker,
-            ...keptAfterTruncation,
-        ];
+        const candidateMessages = [...firstPair, marker, ...keptAfterTruncation];
+        validateRoleAlternation(candidateMessages);
         // If we have token targets, verify the result fits
         if (config?.targetTokens) {
             const candidateTokens = estimateMessagesTokens(candidateMessages, config.provider);
@@ -160,16 +170,20 @@ export function truncateWithSlidingWindow(messages, config) {
     const evenMaxRemove = maxRemove - (maxRemove % 2);
     if (evenMaxRemove > 0) {
         const keptMessages = remainingMessages.slice(evenMaxRemove);
-        const truncationMarker = {
-            id: `truncation-${randomUUID()}`,
-            role: "user",
+        // Insert a dedicated system-role truncation marker (see iterative block above)
+        const fallbackTruncId = randomUUID();
+        const fallbackMarker = {
+            id: `truncation-marker-${fallbackTruncId}`,
+            role: "system",
             content: TRUNCATION_MARKER_CONTENT,
-            timestamp: new Date().toISOString(),
-            metadata: { isSummary: false, truncated: true },
+            isTruncationMarker: true,
+            truncationId: fallbackTruncId,
         };
+        const fallbackMessages = [...firstPair, fallbackMarker, ...keptMessages];
+        validateRoleAlternation(fallbackMessages);
         return {
             truncated: true,
-            messages: [...firstPair, truncationMarker, ...keptMessages],
+            messages: fallbackMessages,
             messagesRemoved: evenMaxRemove,
         };
     }

package/dist/lib/providers/googleAiStudio.d.ts

@@ -59,7 +59,7 @@ export declare class GoogleAIStudioProvider extends BaseProvider {
      * Estimate token count from text using centralized estimation with provider multipliers
      */
     private estimateTokenCount;
-    protected executeStream(options: StreamOptions, _analysisSchema?: ZodUnknownSchema | Schema<unknown>): Promise<StreamResult>;
+    protected executeStream(options: StreamOptions, analysisSchema?: ZodUnknownSchema | Schema<unknown>): Promise<StreamResult>;
     /**
      * Execute stream using native @google/genai SDK for Gemini 3 models
      * This bypasses @ai-sdk/google to properly handle thought_signature

package/dist/lib/providers/googleAiStudio.js

@@ -385,12 +385,15 @@ export class GoogleAIStudioProvider extends BaseProvider {
         return estimateTokens(text, "google-ai");
     }
     // executeGenerate removed - BaseProvider handles all generation with tools
-    async executeStream(options, _analysisSchema) {
+    async executeStream(options, analysisSchema) {
         // Check if this is a Gemini 3 model with tools - use native SDK for thought_signature
         const gemini3CheckModelName = options.model || this.modelName;
+        // Structured output (analysisSchema, JSON format, or schema) is incompatible with tools on Gemini.
+        // Compute once and reuse in both the native Gemini 3 gate and the streamText fallback path.
+        const wantsStructuredOutput = analysisSchema || options.output?.format === "json" || options.schema;
         // Check for tools from options AND from SDK (MCP tools)
         // Need to check early if we should route to native SDK
-        const gemini3CheckShouldUseTools = !options.disableTools && this.supportsTools();
+        const gemini3CheckShouldUseTools = !options.disableTools && this.supportsTools() && !wantsStructuredOutput;
         const optionTools = options.tools || {};
         const sdkTools = gemini3CheckShouldUseTools ? await this.getAllTools() : {};
         const combinedToolCount = Object.keys(optionTools).length + Object.keys(sdkTools).length;
@@ -442,7 +445,13 @@ export class GoogleAIStudioProvider extends BaseProvider {
         const timeoutController = createTimeoutController(timeout, this.providerName, "stream");
         try {
             // Get tools consistently with generate method (include user-provided RAG tools)
-            const shouldUseTools = !options.disableTools && this.supportsTools();
+            // wantsStructuredOutput already computed before the Gemini 3 native-routing gate
+            if (wantsStructuredOutput &&
+                !options.disableTools &&
+                this.supportsTools()) {
+                logger.warn("[GoogleAIStudio] Structured output active — disabling tools (Gemini limitation).");
+            }
+            const shouldUseTools = !options.disableTools && this.supportsTools() && !wantsStructuredOutput;
             const baseTools = shouldUseTools ? await this.getAllTools() : {};
             const rawTools = shouldUseTools
                 ? { ...baseTools, ...(options.tools || {}) }

package/dist/lib/providers/googleNativeGemini3.js

@@ -88,6 +88,18 @@ export function sanitizeSchemaForGemini(schema) {
             result[key] = value;
         }
     }
+    // Recurse through composed schema branches
+    if (Array.isArray(result.allOf)) {
+        result.allOf = result.allOf.map((s) => sanitizeSchemaForGemini(s));
+    }
+    if (result.not && typeof result.not === "object") {
+        result.not = sanitizeSchemaForGemini(result.not);
+    }
+    for (const branch of ["if", "then", "else"]) {
+        if (result[branch] && typeof result[branch] === "object") {
+            result[branch] = sanitizeSchemaForGemini(result[branch]);
+        }
+    }
     return result;
 }
 /**
@@ -111,6 +123,10 @@ export function sanitizeToolsForGemini(tools) {
                 typeof params.parse === "function") {
                 const rawJsonSchema = convertZodToJsonSchema(params);
                 const inlined = inlineJsonSchema(rawJsonSchema);
+                // Gemini sanitization strips Zod-only features not supported by the Gemini API:
+                // union types (anyOf/oneOf) are collapsed to string, default values and
+                // additionalProperties are removed. The resulting schema is Gemini-compatible
+                // but loses some type constraints from the original Zod schema.
                 const sanitizedSchema = sanitizeSchemaForGemini(inlined);
                 sanitized[name] = createAISDKTool({
                     description: tool.description || `Tool: ${name}`,
@@ -119,13 +135,28 @@ export function sanitizeToolsForGemini(tools) {
                     execute: tool.execute,
                 });
             }
+            else if (params &&
+                typeof params === "object" &&
+                "jsonSchema" in params) {
+                // Non-Zod JSON schema (e.g., from ai SDK jsonSchema() helper) — still needs sanitization
+                const rawSchema = params
+                    .jsonSchema;
+                const sanitizedSchema = sanitizeSchemaForGemini(inlineJsonSchema(rawSchema));
+                sanitized[name] = createAISDKTool({
+                    description: tool.description || `Tool: ${name}`,
+                    parameters: aiJsonSchema(sanitizedSchema),
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    execute: tool.execute,
+                });
+            }
             else {
                 sanitized[name] = tool;
             }
         }
         catch (error) {
-            logger.warn(`[Gemini] Failed to sanitize tool "${name}", using original`, { error: error instanceof Error ? error.message : String(error) });
-            sanitized[name] = tool;
+            logger.warn(`[Gemini] Failed to sanitize tool "${name}", skipping: ${error instanceof Error ? error.message : String(error)}`);
+            // Don't fall back to the original tool — an incompatible schema would fail the Gemini request
+            continue;
         }
     }
     return sanitized;

package/dist/lib/providers/googleVertex.js

@@ -784,7 +784,7 @@ export class GoogleVertexProvider extends BaseProvider {
         const sdkTools = gemini3CheckShouldUseTools ? await this.getAllTools() : {};
         const combinedToolCount = Object.keys(optionTools).length + Object.keys(sdkTools).length;
         const hasTools = gemini3CheckShouldUseTools && combinedToolCount > 0;
-        if (isGemini3Model(gemini3CheckModelName) && hasTools) {
+        if (isGemini3Model(gemini3CheckModelName) && hasTools && !analysisSchema) {
             // Process CSV files before routing to native SDK (bypasses normal message builder)
             const processedOptions = await this.processCSVFilesForNativeSDK(options);
             // Merge SDK tools into options for native SDK path
@@ -792,6 +792,16 @@ export class GoogleVertexProvider extends BaseProvider {
                 ...processedOptions,
                 tools: { ...sdkTools, ...optionTools },
             };
+            // Gemini cannot use tools and JSON schema simultaneously
+            const wantsStructuredOutput = analysisSchema ||
+                processedOptions.output?.format === "json" ||
+                processedOptions.schema;
+            if (wantsStructuredOutput) {
+                mergedOptions.tools = {};
+                mergedOptions.toolChoice = undefined;
+                mergedOptions.maxSteps = undefined;
+                logger.warn("[GoogleVertex] Structured output active — disabling tools for Gemini 3 (Gemini limitation).");
+            }
             logger.info("[GoogleVertex] Routing Gemini 3 to native SDK for tool calling", {
                 model: gemini3CheckModelName,
                 optionToolCount: Object.keys(optionTools).length,

package/dist/providers/googleAiStudio.d.ts

@@ -59,7 +59,7 @@ export declare class GoogleAIStudioProvider extends BaseProvider {
      * Estimate token count from text using centralized estimation with provider multipliers
      */
     private estimateTokenCount;
-    protected executeStream(options: StreamOptions, _analysisSchema?: ZodUnknownSchema | Schema<unknown>): Promise<StreamResult>;
+    protected executeStream(options: StreamOptions, analysisSchema?: ZodUnknownSchema | Schema<unknown>): Promise<StreamResult>;
     /**
      * Execute stream using native @google/genai SDK for Gemini 3 models
      * This bypasses @ai-sdk/google to properly handle thought_signature

package/dist/providers/googleAiStudio.js

@@ -385,12 +385,15 @@ export class GoogleAIStudioProvider extends BaseProvider {
         return estimateTokens(text, "google-ai");
     }
     // executeGenerate removed - BaseProvider handles all generation with tools
-    async executeStream(options, _analysisSchema) {
+    async executeStream(options, analysisSchema) {
         // Check if this is a Gemini 3 model with tools - use native SDK for thought_signature
         const gemini3CheckModelName = options.model || this.modelName;
+        // Structured output (analysisSchema, JSON format, or schema) is incompatible with tools on Gemini.
+        // Compute once and reuse in both the native Gemini 3 gate and the streamText fallback path.
+        const wantsStructuredOutput = analysisSchema || options.output?.format === "json" || options.schema;
         // Check for tools from options AND from SDK (MCP tools)
         // Need to check early if we should route to native SDK
-        const gemini3CheckShouldUseTools = !options.disableTools && this.supportsTools();
+        const gemini3CheckShouldUseTools = !options.disableTools && this.supportsTools() && !wantsStructuredOutput;
         const optionTools = options.tools || {};
         const sdkTools = gemini3CheckShouldUseTools ? await this.getAllTools() : {};
         const combinedToolCount = Object.keys(optionTools).length + Object.keys(sdkTools).length;
@@ -442,7 +445,13 @@ export class GoogleAIStudioProvider extends BaseProvider {
         const timeoutController = createTimeoutController(timeout, this.providerName, "stream");
         try {
             // Get tools consistently with generate method (include user-provided RAG tools)
-            const shouldUseTools = !options.disableTools && this.supportsTools();
+            // wantsStructuredOutput already computed before the Gemini 3 native-routing gate
+            if (wantsStructuredOutput &&
+                !options.disableTools &&
+                this.supportsTools()) {
+                logger.warn("[GoogleAIStudio] Structured output active — disabling tools (Gemini limitation).");
+            }
+            const shouldUseTools = !options.disableTools && this.supportsTools() && !wantsStructuredOutput;
             const baseTools = shouldUseTools ? await this.getAllTools() : {};
             const rawTools = shouldUseTools
                 ? { ...baseTools, ...(options.tools || {}) }

package/dist/providers/googleNativeGemini3.js

@@ -88,6 +88,18 @@ export function sanitizeSchemaForGemini(schema) {
             result[key] = value;
         }
     }
+    // Recurse through composed schema branches
+    if (Array.isArray(result.allOf)) {
+        result.allOf = result.allOf.map((s) => sanitizeSchemaForGemini(s));
+    }
+    if (result.not && typeof result.not === "object") {
+        result.not = sanitizeSchemaForGemini(result.not);
+    }
+    for (const branch of ["if", "then", "else"]) {
+        if (result[branch] && typeof result[branch] === "object") {
+            result[branch] = sanitizeSchemaForGemini(result[branch]);
+        }
+    }
     return result;
 }
 /**
@@ -111,6 +123,10 @@ export function sanitizeToolsForGemini(tools) {
                 typeof params.parse === "function") {
                 const rawJsonSchema = convertZodToJsonSchema(params);
                 const inlined = inlineJsonSchema(rawJsonSchema);
+                // Gemini sanitization strips Zod-only features not supported by the Gemini API:
+                // union types (anyOf/oneOf) are collapsed to string, default values and
+                // additionalProperties are removed. The resulting schema is Gemini-compatible
+                // but loses some type constraints from the original Zod schema.
                 const sanitizedSchema = sanitizeSchemaForGemini(inlined);
                 sanitized[name] = createAISDKTool({
                     description: tool.description || `Tool: ${name}`,
@@ -119,13 +135,28 @@ export function sanitizeToolsForGemini(tools) {
                     execute: tool.execute,
                 });
             }
+            else if (params &&
+                typeof params === "object" &&
+                "jsonSchema" in params) {
+                // Non-Zod JSON schema (e.g., from ai SDK jsonSchema() helper) — still needs sanitization
+                const rawSchema = params
+                    .jsonSchema;
+                const sanitizedSchema = sanitizeSchemaForGemini(inlineJsonSchema(rawSchema));
+                sanitized[name] = createAISDKTool({
+                    description: tool.description || `Tool: ${name}`,
+                    parameters: aiJsonSchema(sanitizedSchema),
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    execute: tool.execute,
+                });
+            }
             else {
                 sanitized[name] = tool;
             }
         }
         catch (error) {
-            logger.warn(`[Gemini] Failed to sanitize tool "${name}", using original`, { error: error instanceof Error ? error.message : String(error) });
-            sanitized[name] = tool;
+            logger.warn(`[Gemini] Failed to sanitize tool "${name}", skipping: ${error instanceof Error ? error.message : String(error)}`);
+            // Don't fall back to the original tool — an incompatible schema would fail the Gemini request
+            continue;
         }
     }
     return sanitized;

package/dist/providers/googleVertex.js

@@ -784,7 +784,7 @@ export class GoogleVertexProvider extends BaseProvider {
         const sdkTools = gemini3CheckShouldUseTools ? await this.getAllTools() : {};
         const combinedToolCount = Object.keys(optionTools).length + Object.keys(sdkTools).length;
         const hasTools = gemini3CheckShouldUseTools && combinedToolCount > 0;
-        if (isGemini3Model(gemini3CheckModelName) && hasTools) {
+        if (isGemini3Model(gemini3CheckModelName) && hasTools && !analysisSchema) {
             // Process CSV files before routing to native SDK (bypasses normal message builder)
             const processedOptions = await this.processCSVFilesForNativeSDK(options);
             // Merge SDK tools into options for native SDK path
@@ -792,6 +792,16 @@ export class GoogleVertexProvider extends BaseProvider {
                 ...processedOptions,
                 tools: { ...sdkTools, ...optionTools },
             };
+            // Gemini cannot use tools and JSON schema simultaneously
+            const wantsStructuredOutput = analysisSchema ||
+                processedOptions.output?.format === "json" ||
+                processedOptions.schema;
+            if (wantsStructuredOutput) {
+                mergedOptions.tools = {};
+                mergedOptions.toolChoice = undefined;
+                mergedOptions.maxSteps = undefined;
+                logger.warn("[GoogleVertex] Structured output active — disabling tools for Gemini 3 (Gemini limitation).");
+            }
             logger.info("[GoogleVertex] Routing Gemini 3 to native SDK for tool calling", {
                 model: gemini3CheckModelName,
                 optionToolCount: Object.keys(optionTools).length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.19.1",
+  "version": "9.20.0",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",