@juspay/neurolink 9.19.1 → 9.21.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [9.21.0](https://github.com/juspay/neurolink/compare/v9.20.0...v9.21.0) (2026-03-09)
+
+### Features
+
+- **(reports-conversation):** Add support for report metaData in getUserAllSessionsHistory ([2273af0](https://github.com/juspay/neurolink/commit/2273af00f2089dba4f691f771b8e16a6a71274b5))
+
+## [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/core/redisConversationMemoryManager.d.ts

@@ -2,7 +2,7 @@
  * Redis Conversation Memory Manager for NeuroLink
  * Redis-based implementation of conversation storage with same interface as ConversationMemoryManager
  */
-import type { ChatMessage, ConversationMemoryConfig, ConversationMemoryStats, RedisConversationObject, RedisStorageConfig, SessionMemory, SessionMetadata, StoreConversationTurnOptions } from "../types/conversation.js";
+import type { ChatMessage, ConversationMemoryConfig, ConversationMemoryStats, RedisConversationObject, RedisStorageConfig, SessionMemory, SessionMetadata, StoreConversationTurnOptions, AgenticLoopReportMetadata } from "../types/conversation.js";
 import type { IConversationMemoryManager } from "../types/conversationMemoryInterface.js";
 /**
  * Redis-based implementation of the ConversationMemoryManager
@@ -184,4 +184,14 @@ export declare class RedisConversationMemoryManager implements IConversationMemo
      * Flush pending tool execution data for a session and merge into conversation
      */
     private flushPendingToolData;
+    /**
+     * Update agentic loop report metadata for a conversation session.
+     * Upserts a report entry by reportId — updates existing or adds new.
+     * Follows the read → patch → write pattern (same as title generation).
+     *
+     * @param sessionId The session identifier
+     * @param userId The user identifier (optional)
+     * @param report The report metadata to upsert
+     */
+    updateAgenticLoopReport(sessionId: string, userId: string | undefined, report: AgenticLoopReportMetadata): Promise<void>;
 }

package/dist/core/redisConversationMemoryManager.js

@@ -10,6 +10,7 @@ import { generateToolOutputPreview } from "../context/toolOutputLimits.js";
 import { SummarizationEngine } from "../context/summarizationEngine.js";
 import { NeuroLink } from "../neurolink.js";
 import { ConversationMemoryError } from "../types/conversation.js";
+import { withTimeout } from "../utils/errorHandling.js";
 import { buildContextFromPointer, getEffectiveTokenThreshold, } from "../utils/conversationMemory.js";
 import { runWithCurrentLangfuseContext } from "../services/server/ai/observability/instrumentation.js";
 import { logger } from "../utils/logger.js";
@@ -749,6 +750,11 @@ export class RedisConversationMemoryManager {
                     title: conversation.title,
                     createdAt: conversation.createdAt,
                     updatedAt: conversation.updatedAt,
+                    metadata: conversation.additionalMetadata?.agenticLoopReports
+                        ? {
+                            agenticLoopReports: conversation.additionalMetadata.agenticLoopReports,
+                        }
+                        : undefined,
                 };
             }
             logger.debug("[RedisConversationMemoryManager] No valid conversation data found", {
@@ -1345,4 +1351,85 @@ User message: "${userMessage}"`;
             this.pendingToolExecutions.delete(pendingKey);
         }
     }
+    /**
+     * Update agentic loop report metadata for a conversation session.
+     * Upserts a report entry by reportId — updates existing or adds new.
+     * Follows the read → patch → write pattern (same as title generation).
+     *
+     * @param sessionId The session identifier
+     * @param userId The user identifier (optional)
+     * @param report The report metadata to upsert
+     */
+    async updateAgenticLoopReport(sessionId, userId, report) {
+        logger.debug("[RedisConversationMemoryManager] Updating agentic loop report", {
+            sessionId,
+            userId,
+            reportId: report.reportId,
+            reportType: report.reportType,
+            reportStatus: report.reportStatus,
+        });
+        await this.ensureInitialized();
+        if (!this.redisClient) {
+            logger.warn("[RedisConversationMemoryManager] Redis client not available for report update", { sessionId, userId });
+            return;
+        }
+        try {
+            const redisKey = getSessionKey(this.redisConfig, sessionId, userId || undefined);
+            const conversationData = await withTimeout(this.redisClient.get(redisKey), 5000);
+            if (!conversationData) {
+                logger.warn("[RedisConversationMemoryManager] No conversation found for report update", { sessionId, userId });
+                return;
+            }
+            const conversation = deserializeConversation(conversationData);
+            if (!conversation) {
+                logger.warn("[RedisConversationMemoryManager] Failed to deserialize conversation for report update", { sessionId, userId });
+                return;
+            }
+            // Initialize additionalMetadata and agenticLoopReports if needed
+            if (!conversation.additionalMetadata) {
+                conversation.additionalMetadata = {};
+            }
+            if (!conversation.additionalMetadata.agenticLoopReports) {
+                conversation.additionalMetadata.agenticLoopReports = [];
+            }
+            // Upsert: find existing report by reportId and update, or push new entry
+            const existingIndex = conversation.additionalMetadata.agenticLoopReports.findIndex((r) => r.reportId === report.reportId);
+            if (existingIndex >= 0) {
+                conversation.additionalMetadata.agenticLoopReports[existingIndex] =
+                    report;
+                logger.debug("[RedisConversationMemoryManager] Updated existing agentic loop report", { sessionId, reportId: report.reportId });
+            }
+            else {
+                conversation.additionalMetadata.agenticLoopReports.push(report);
+                logger.debug("[RedisConversationMemoryManager] Added new agentic loop report", { sessionId, reportId: report.reportId });
+            }
+            conversation.updatedAt = new Date().toISOString();
+            // Write back to Redis
+            const serializedData = serializeConversation(conversation);
+            await withTimeout(this.redisClient.set(redisKey, serializedData), 5000);
+            if (this.redisConfig.ttl > 0) {
+                await withTimeout(this.redisClient.expire(redisKey, this.redisConfig.ttl), 5000);
+            }
+            logger.info("[RedisConversationMemoryManager] Successfully updated agentic loop report", {
+                sessionId,
+                userId,
+                reportId: report.reportId,
+                reportStatus: report.reportStatus,
+            });
+        }
+        catch (error) {
+            logger.error("[RedisConversationMemoryManager] Failed to update agentic loop report", {
+                sessionId,
+                userId,
+                reportId: report.reportId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new ConversationMemoryError("Failed to update agentic loop report", "STORAGE_ERROR", {
+                sessionId,
+                userId,
+                reportId: report.reportId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
 }

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/core/redisConversationMemoryManager.d.ts

@@ -2,7 +2,7 @@
  * Redis Conversation Memory Manager for NeuroLink
  * Redis-based implementation of conversation storage with same interface as ConversationMemoryManager
  */
-import type { ChatMessage, ConversationMemoryConfig, ConversationMemoryStats, RedisConversationObject, RedisStorageConfig, SessionMemory, SessionMetadata, StoreConversationTurnOptions } from "../types/conversation.js";
+import type { ChatMessage, ConversationMemoryConfig, ConversationMemoryStats, RedisConversationObject, RedisStorageConfig, SessionMemory, SessionMetadata, StoreConversationTurnOptions, AgenticLoopReportMetadata } from "../types/conversation.js";
 import type { IConversationMemoryManager } from "../types/conversationMemoryInterface.js";
 /**
  * Redis-based implementation of the ConversationMemoryManager
@@ -184,4 +184,14 @@ export declare class RedisConversationMemoryManager implements IConversationMemo
      * Flush pending tool execution data for a session and merge into conversation
      */
     private flushPendingToolData;
+    /**
+     * Update agentic loop report metadata for a conversation session.
+     * Upserts a report entry by reportId — updates existing or adds new.
+     * Follows the read → patch → write pattern (same as title generation).
+     *
+     * @param sessionId The session identifier
+     * @param userId The user identifier (optional)
+     * @param report The report metadata to upsert
+     */
+    updateAgenticLoopReport(sessionId: string, userId: string | undefined, report: AgenticLoopReportMetadata): Promise<void>;
 }

package/dist/lib/core/redisConversationMemoryManager.js

@@ -10,6 +10,7 @@ import { generateToolOutputPreview } from "../context/toolOutputLimits.js";
 import { SummarizationEngine } from "../context/summarizationEngine.js";
 import { NeuroLink } from "../neurolink.js";
 import { ConversationMemoryError } from "../types/conversation.js";
+import { withTimeout } from "../utils/errorHandling.js";
 import { buildContextFromPointer, getEffectiveTokenThreshold, } from "../utils/conversationMemory.js";
 import { runWithCurrentLangfuseContext } from "../services/server/ai/observability/instrumentation.js";
 import { logger } from "../utils/logger.js";
@@ -749,6 +750,11 @@ export class RedisConversationMemoryManager {
                     title: conversation.title,
                     createdAt: conversation.createdAt,
                     updatedAt: conversation.updatedAt,
+                    metadata: conversation.additionalMetadata?.agenticLoopReports
+                        ? {
+                            agenticLoopReports: conversation.additionalMetadata.agenticLoopReports,
+                        }
+                        : undefined,
                 };
             }
             logger.debug("[RedisConversationMemoryManager] No valid conversation data found", {
@@ -1345,5 +1351,86 @@ User message: "${userMessage}"`;
             this.pendingToolExecutions.delete(pendingKey);
         }
     }
+    /**
+     * Update agentic loop report metadata for a conversation session.
+     * Upserts a report entry by reportId — updates existing or adds new.
+     * Follows the read → patch → write pattern (same as title generation).
+     *
+     * @param sessionId The session identifier
+     * @param userId The user identifier (optional)
+     * @param report The report metadata to upsert
+     */
+    async updateAgenticLoopReport(sessionId, userId, report) {
+        logger.debug("[RedisConversationMemoryManager] Updating agentic loop report", {
+            sessionId,
+            userId,
+            reportId: report.reportId,
+            reportType: report.reportType,
+            reportStatus: report.reportStatus,
+        });
+        await this.ensureInitialized();
+        if (!this.redisClient) {
+            logger.warn("[RedisConversationMemoryManager] Redis client not available for report update", { sessionId, userId });
+            return;
+        }
+        try {
+            const redisKey = getSessionKey(this.redisConfig, sessionId, userId || undefined);
+            const conversationData = await withTimeout(this.redisClient.get(redisKey), 5000);
+            if (!conversationData) {
+                logger.warn("[RedisConversationMemoryManager] No conversation found for report update", { sessionId, userId });
+                return;
+            }
+            const conversation = deserializeConversation(conversationData);
+            if (!conversation) {
+                logger.warn("[RedisConversationMemoryManager] Failed to deserialize conversation for report update", { sessionId, userId });
+                return;
+            }
+            // Initialize additionalMetadata and agenticLoopReports if needed
+            if (!conversation.additionalMetadata) {
+                conversation.additionalMetadata = {};
+            }
+            if (!conversation.additionalMetadata.agenticLoopReports) {
+                conversation.additionalMetadata.agenticLoopReports = [];
+            }
+            // Upsert: find existing report by reportId and update, or push new entry
+            const existingIndex = conversation.additionalMetadata.agenticLoopReports.findIndex((r) => r.reportId === report.reportId);
+            if (existingIndex >= 0) {
+                conversation.additionalMetadata.agenticLoopReports[existingIndex] =
+                    report;
+                logger.debug("[RedisConversationMemoryManager] Updated existing agentic loop report", { sessionId, reportId: report.reportId });
+            }
+            else {
+                conversation.additionalMetadata.agenticLoopReports.push(report);
+                logger.debug("[RedisConversationMemoryManager] Added new agentic loop report", { sessionId, reportId: report.reportId });
+            }
+            conversation.updatedAt = new Date().toISOString();
+            // Write back to Redis
+            const serializedData = serializeConversation(conversation);
+            await withTimeout(this.redisClient.set(redisKey, serializedData), 5000);
+            if (this.redisConfig.ttl > 0) {
+                await withTimeout(this.redisClient.expire(redisKey, this.redisConfig.ttl), 5000);
+            }
+            logger.info("[RedisConversationMemoryManager] Successfully updated agentic loop report", {
+                sessionId,
+                userId,
+                reportId: report.reportId,
+                reportStatus: report.reportStatus,
+            });
+        }
+        catch (error) {
+            logger.error("[RedisConversationMemoryManager] Failed to update agentic loop report", {
+                sessionId,
+                userId,
+                reportId: report.reportId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new ConversationMemoryError("Failed to update agentic loop report", "STORAGE_ERROR", {
+                sessionId,
+                userId,
+                reportId: report.reportId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
 }
 //# sourceMappingURL=redisConversationMemoryManager.js.map

package/dist/lib/neurolink.d.ts

@@ -925,6 +925,26 @@ export declare class NeuroLink {
      * @returns true if the tool was removed, false if it didn't exist
      */
     unregisterTool(name: string): boolean;
+    /**
+     * Update agentic loop report metadata for a conversation session.
+     * Upserts a report entry by reportId — updates existing or adds new.
+     * Only supported when using Redis conversation memory.
+     *
+     * @param sessionId The session identifier
+     * @param report The agentic loop report metadata to upsert
+     * @param userId Optional user identifier
+     * @throws Error if conversation memory is not initialized or is not Redis-backed
+     *
+     * @example
+     * ```typescript
+     * await neurolink.updateAgenticLoopReport("session-123", {
+     *   reportId: "report-abc",
+     *   reportType: "META",
+     *   reportStatus: "INPROGRESS",
+     * });
+     * ```
+     */
+    updateAgenticLoopReport(sessionId: string, report: import("./types/conversation.js").AgenticLoopReportMetadata, userId?: string): Promise<void>;
     /**
      * Get all registered custom tools
      * @returns Map of tool names to MCPExecutableTool format

package/dist/lib/neurolink.js

@@ -38,6 +38,7 @@ import { initializeMem0 } from "./memory/mem0Initializer.js";
 import { createMemoryRetrievalTools } from "./memory/memoryRetrievalTools.js";
 import { initializeHippocampus, } from "./memory/hippocampusInitializer.js";
 import { flushOpenTelemetry, getLangfuseHealthStatus, initializeOpenTelemetry, isOpenTelemetryInitialized, setLangfuseContext, shutdownOpenTelemetry, } from "./services/server/ai/observability/instrumentation.js";
+import { ConversationMemoryError } from "./types/conversation.js";
 import { getConversationMessages, storeConversationTurn, } from "./utils/conversationMemory.js";
 // Enhanced error handling imports
 import { CircuitBreaker, ERROR_CODES, ErrorFactory, isAbortError, isRetriableError, logStructuredError, NeuroLinkError, withRetry, withTimeout, } from "./utils/errorHandling.js";
@@ -4641,6 +4642,38 @@ Current user's request: ${currentInput}`;
         }
         return removed;
     }
+    /**
+     * Update agentic loop report metadata for a conversation session.
+     * Upserts a report entry by reportId — updates existing or adds new.
+     * Only supported when using Redis conversation memory.
+     *
+     * @param sessionId The session identifier
+     * @param report The agentic loop report metadata to upsert
+     * @param userId Optional user identifier
+     * @throws Error if conversation memory is not initialized or is not Redis-backed
+     *
+     * @example
+     * ```typescript
+     * await neurolink.updateAgenticLoopReport("session-123", {
+     *   reportId: "report-abc",
+     *   reportType: "META",
+     *   reportStatus: "INPROGRESS",
+     * });
+     * ```
+     */
+    async updateAgenticLoopReport(sessionId, report, userId) {
+        if (!this.conversationMemory) {
+            throw new ConversationMemoryError("Conversation memory is not initialized. Enable conversationMemory in NeuroLink options.", "CONFIG_ERROR");
+        }
+        // Check if the memory manager is Redis-backed (has updateAgenticLoopReport method)
+        if (!("updateAgenticLoopReport" in this.conversationMemory) ||
+            typeof this.conversationMemory
+                .updateAgenticLoopReport !== "function") {
+            throw new ConversationMemoryError("updateAgenticLoopReport is only supported with Redis conversation memory.", "CONFIG_ERROR");
+        }
+        await withTimeout(this
+            .conversationMemory.updateAgenticLoopReport(sessionId, userId, report), 5000);
+    }
     /**
      * Get all registered custom tools
      * @returns Map of tool names to MCPExecutableTool format

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/lib/types/conversation.d.ts

@@ -377,6 +377,36 @@ export type SessionMetadata = {
     title: string;
     createdAt: string;
     updatedAt: string;
+    /** Additional metadata including agentic loop reports */
+    metadata?: {
+        agenticLoopReports?: AgenticLoopReportMetadata[];
+    };
+};
+/**
+ * Report type for agentic loop reports
+ * Identifies the platform or category of the report
+ */
+export type AgenticLoopReportType = "META" | "GOOGLEADS" | "GOOGLEGA4" | "OTHER";
+/**
+ * Status of an agentic loop report
+ */
+export type AgenticLoopReportStatus = "INPROGRESS" | "COMPLETED";
+/**
+ * Metadata for an individual agentic loop report
+ * A conversation session can have multiple reports tracked via this type
+ */
+export type AgenticLoopReportMetadata = {
+    /** Unique identifier for this report */
+    reportId: string;
+    /** Platform/category of the report */
+    reportType: AgenticLoopReportType;
+    /** Current status of the report */
+    reportStatus: AgenticLoopReportStatus;
+    /** Optional audit period date range for the report */
+    auditPeriod?: {
+        startDate: string;
+        endDate: string;
+    };
 };
 /**
  * Base conversation metadata (shared fields across all conversation types)
@@ -413,6 +443,13 @@ export type ConversationBase = {
         cacheReadTokens?: number;
         cacheWriteTokens?: number;
     };
+    /** Additional metadata for extensible conversation-level data */
+    additionalMetadata?: {
+        /** Agentic loop reports associated with this conversation */
+        agenticLoopReports?: AgenticLoopReportMetadata[];
+        /** Allow future extensibility */
+        [key: string]: unknown;
+    };
 };
 /**
  * Redis conversation storage object format

package/dist/neurolink.d.ts

@@ -925,6 +925,26 @@ export declare class NeuroLink {
      * @returns true if the tool was removed, false if it didn't exist
      */
     unregisterTool(name: string): boolean;
+    /**
+     * Update agentic loop report metadata for a conversation session.
+     * Upserts a report entry by reportId — updates existing or adds new.
+     * Only supported when using Redis conversation memory.
+     *
+     * @param sessionId The session identifier
+     * @param report The agentic loop report metadata to upsert
+     * @param userId Optional user identifier
+     * @throws Error if conversation memory is not initialized or is not Redis-backed
+     *
+     * @example
+     * ```typescript
+     * await neurolink.updateAgenticLoopReport("session-123", {
+     *   reportId: "report-abc",
+     *   reportType: "META",
+     *   reportStatus: "INPROGRESS",
+     * });
+     * ```
+     */
+    updateAgenticLoopReport(sessionId: string, report: import("./types/conversation.js").AgenticLoopReportMetadata, userId?: string): Promise<void>;
     /**
      * Get all registered custom tools
      * @returns Map of tool names to MCPExecutableTool format

package/dist/neurolink.js

@@ -38,6 +38,7 @@ import { initializeMem0 } from "./memory/mem0Initializer.js";
 import { createMemoryRetrievalTools } from "./memory/memoryRetrievalTools.js";
 import { initializeHippocampus, } from "./memory/hippocampusInitializer.js";
 import { flushOpenTelemetry, getLangfuseHealthStatus, initializeOpenTelemetry, isOpenTelemetryInitialized, setLangfuseContext, shutdownOpenTelemetry, } from "./services/server/ai/observability/instrumentation.js";
+import { ConversationMemoryError } from "./types/conversation.js";
 import { getConversationMessages, storeConversationTurn, } from "./utils/conversationMemory.js";
 // Enhanced error handling imports
 import { CircuitBreaker, ERROR_CODES, ErrorFactory, isAbortError, isRetriableError, logStructuredError, NeuroLinkError, withRetry, withTimeout, } from "./utils/errorHandling.js";
@@ -4641,6 +4642,38 @@ Current user's request: ${currentInput}`;
         }
         return removed;
     }
+    /**
+     * Update agentic loop report metadata for a conversation session.
+     * Upserts a report entry by reportId — updates existing or adds new.
+     * Only supported when using Redis conversation memory.
+     *
+     * @param sessionId The session identifier
+     * @param report The agentic loop report metadata to upsert
+     * @param userId Optional user identifier
+     * @throws Error if conversation memory is not initialized or is not Redis-backed
+     *
+     * @example
+     * ```typescript
+     * await neurolink.updateAgenticLoopReport("session-123", {
+     *   reportId: "report-abc",
+     *   reportType: "META",
+     *   reportStatus: "INPROGRESS",
+     * });
+     * ```
+     */
+    async updateAgenticLoopReport(sessionId, report, userId) {
+        if (!this.conversationMemory) {
+            throw new ConversationMemoryError("Conversation memory is not initialized. Enable conversationMemory in NeuroLink options.", "CONFIG_ERROR");
+        }
+        // Check if the memory manager is Redis-backed (has updateAgenticLoopReport method)
+        if (!("updateAgenticLoopReport" in this.conversationMemory) ||
+            typeof this.conversationMemory
+                .updateAgenticLoopReport !== "function") {
+            throw new ConversationMemoryError("updateAgenticLoopReport is only supported with Redis conversation memory.", "CONFIG_ERROR");
+        }
+        await withTimeout(this
+            .conversationMemory.updateAgenticLoopReport(sessionId, userId, report), 5000);
+    }
     /**
      * Get all registered custom tools
      * @returns Map of tool names to MCPExecutableTool format

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/dist/types/conversation.d.ts

@@ -377,6 +377,36 @@ export type SessionMetadata = {
     title: string;
     createdAt: string;
     updatedAt: string;
+    /** Additional metadata including agentic loop reports */
+    metadata?: {
+        agenticLoopReports?: AgenticLoopReportMetadata[];
+    };
+};
+/**
+ * Report type for agentic loop reports
+ * Identifies the platform or category of the report
+ */
+export type AgenticLoopReportType = "META" | "GOOGLEADS" | "GOOGLEGA4" | "OTHER";
+/**
+ * Status of an agentic loop report
+ */
+export type AgenticLoopReportStatus = "INPROGRESS" | "COMPLETED";
+/**
+ * Metadata for an individual agentic loop report
+ * A conversation session can have multiple reports tracked via this type
+ */
+export type AgenticLoopReportMetadata = {
+    /** Unique identifier for this report */
+    reportId: string;
+    /** Platform/category of the report */
+    reportType: AgenticLoopReportType;
+    /** Current status of the report */
+    reportStatus: AgenticLoopReportStatus;
+    /** Optional audit period date range for the report */
+    auditPeriod?: {
+        startDate: string;
+        endDate: string;
+    };
 };
 /**
  * Base conversation metadata (shared fields across all conversation types)
@@ -413,6 +443,13 @@ export type ConversationBase = {
         cacheReadTokens?: number;
         cacheWriteTokens?: number;
     };
+    /** Additional metadata for extensible conversation-level data */
+    additionalMetadata?: {
+        /** Agentic loop reports associated with this conversation */
+        agenticLoopReports?: AgenticLoopReportMetadata[];
+        /** Allow future extensibility */
+        [key: string]: unknown;
+    };
 };
 /**
  * Redis conversation storage object format

package/package.json

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