@juspay/neurolink 9.20.0 → 9.22.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [9.22.0](https://github.com/juspay/neurolink/compare/v9.21.0...v9.22.0) (2026-03-12)
+
+### Features
+
+- **(landing):** comprehensive mobile redesign across all 13 landing page components ([405e3e5](https://github.com/juspay/neurolink/commit/405e3e5eb8672b50ee1fc319088fb8c2b4fb78a0))
+
+## [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

package/dist/context/stages/slidingWindowTruncator.js

@@ -20,7 +20,6 @@ function validateRoleAlternation(messages) {
         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;
         }
     }
 }
@@ -131,13 +130,13 @@ export function truncateWithSlidingWindow(messages, config) {
             break;
         }
         const keptAfterTruncation = remainingMessages.slice(evenRemoveCount);
-        // Insert a dedicated system-role truncation marker with machine-readable
-        // metadata so effectiveHistory.ts can detect it via isTruncationMarker /
+        // Insert a 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",
+            role: "user",
             content: TRUNCATION_MARKER_CONTENT,
             isTruncationMarker: true,
             truncationId: truncId,
@@ -170,11 +169,11 @@ export function truncateWithSlidingWindow(messages, config) {
     const evenMaxRemove = maxRemove - (maxRemove % 2);
     if (evenMaxRemove > 0) {
         const keptMessages = remainingMessages.slice(evenMaxRemove);
-        // Insert a dedicated system-role truncation marker (see iterative block above)
+        // Insert a truncation marker (see iterative block above)
         const fallbackTruncId = randomUUID();
         const fallbackMarker = {
             id: `truncation-marker-${fallbackTruncId}`,
-            role: "system",
+            role: "user",
             content: TRUNCATION_MARKER_CONTENT,
             isTruncationMarker: true,
             truncationId: fallbackTruncId,

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

@@ -20,7 +20,6 @@ function validateRoleAlternation(messages) {
         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;
         }
     }
 }
@@ -131,13 +130,13 @@ export function truncateWithSlidingWindow(messages, config) {
             break;
         }
         const keptAfterTruncation = remainingMessages.slice(evenRemoveCount);
-        // Insert a dedicated system-role truncation marker with machine-readable
-        // metadata so effectiveHistory.ts can detect it via isTruncationMarker /
+        // Insert a 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",
+            role: "user",
             content: TRUNCATION_MARKER_CONTENT,
             isTruncationMarker: true,
             truncationId: truncId,
@@ -170,11 +169,11 @@ export function truncateWithSlidingWindow(messages, config) {
     const evenMaxRemove = maxRemove - (maxRemove % 2);
     if (evenMaxRemove > 0) {
         const keptMessages = remainingMessages.slice(evenMaxRemove);
-        // Insert a dedicated system-role truncation marker (see iterative block above)
+        // Insert a truncation marker (see iterative block above)
         const fallbackTruncId = randomUUID();
         const fallbackMarker = {
             id: `truncation-marker-${fallbackTruncId}`,
-            role: "system",
+            role: "user",
             content: TRUNCATION_MARKER_CONTENT,
             isTruncationMarker: true,
             truncationId: fallbackTruncId,

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.js

@@ -457,9 +457,20 @@ export class GoogleAIStudioProvider extends BaseProvider {
                 ? { ...baseTools, ...(options.tools || {}) }
                 : {};
             // Sanitize tool schemas for Gemini proto compatibility (converts anyOf/oneOf unions to string)
-            const tools = Object.keys(rawTools).length > 0
-                ? sanitizeToolsForGemini(rawTools)
-                : rawTools;
+            let tools;
+            if (Object.keys(rawTools).length > 0) {
+                const sanitized = sanitizeToolsForGemini(rawTools);
+                if (sanitized.dropped.length > 0) {
+                    logger.warn(`[GoogleAIStudio] Dropped ${sanitized.dropped.length} incompatible tool(s): ${sanitized.dropped.join(", ")}`);
+                }
+                tools =
+                    Object.keys(sanitized.tools).length > 0
+                        ? sanitized.tools
+                        : undefined;
+            }
+            else {
+                tools = undefined;
+            }
             // Build message array from options with multimodal support
             // Using protected helper from BaseProvider to eliminate code duplication
             const messages = await this.buildMessagesForStream(options);
@@ -470,7 +481,7 @@ export class GoogleAIStudioProvider extends BaseProvider {
                 maxTokens: options.maxTokens, // No default limit - unlimited unless specified
                 tools,
                 maxSteps: options.maxSteps || DEFAULT_MAX_STEPS,
-                toolChoice: shouldUseTools ? "auto" : "none",
+                toolChoice: shouldUseTools && tools ? "auto" : "none",
                 abortSignal: composeAbortSignals(options.abortSignal, timeoutController?.controller.signal),
                 experimental_telemetry: this.telemetryHandler.getTelemetryConfig(options),
                 // Gemini 3: use thinkingLevel via providerOptions

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

@@ -66,7 +66,10 @@ export declare function sanitizeSchemaForGemini(schema: Record<string, unknown>)
  * This function pre-converts each tool's Zod parameters to sanitized JSON Schema
  * and re-wraps with the Vercel AI SDK's jsonSchema() helper.
  */
-export declare function sanitizeToolsForGemini(tools: Record<string, Tool>): Record<string, Tool>;
+export declare function sanitizeToolsForGemini(tools: Record<string, Tool>): {
+    tools: Record<string, Tool>;
+    dropped: string[];
+};
 /**
  * Convert Vercel AI SDK tools to @google/genai FunctionDeclarations and an execute map.
  *

package/dist/lib/providers/googleNativeGemini3.js

@@ -114,6 +114,7 @@ export function sanitizeSchemaForGemini(schema) {
  */
 export function sanitizeToolsForGemini(tools) {
     const sanitized = {};
+    const dropped = [];
     for (const [name, tool] of Object.entries(tools)) {
         try {
             const params = tool.parameters;
@@ -156,10 +157,11 @@ export function sanitizeToolsForGemini(tools) {
         catch (error) {
             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
+            dropped.push(name);
             continue;
         }
     }
-    return sanitized;
+    return { tools: sanitized, dropped };
 }
 /**
  * Convert Vercel AI SDK tools to @google/genai FunctionDeclarations and an execute map.

package/dist/lib/providers/googleVertex.js

@@ -777,14 +777,17 @@ export class GoogleVertexProvider extends BaseProvider {
     async executeStream(options, analysisSchema) {
         // Check if this is a Gemini 3 model with tools - use native SDK for thought_signature
         const gemini3CheckModelName = this.resolveAlias(options.model || this.modelName || getDefaultVertexModel());
+        // 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;
         const hasTools = gemini3CheckShouldUseTools && combinedToolCount > 0;
-        if (isGemini3Model(gemini3CheckModelName) && hasTools && !analysisSchema) {
+        if (isGemini3Model(gemini3CheckModelName) && hasTools) {
             // 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,16 +795,6 @@ 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,
@@ -831,15 +824,30 @@ export class GoogleVertexProvider extends BaseProvider {
                 : {};
             // Only sanitize for Gemini models (not Anthropic/Claude models routed through Vertex)
             const isAnthropic = isAnthropicModel(gemini3CheckModelName);
-            const tools = Object.keys(rawTools).length > 0 && !isAnthropic
-                ? sanitizeToolsForGemini(rawTools)
-                : rawTools;
+            let tools;
+            if (Object.keys(rawTools).length > 0 && !isAnthropic) {
+                const sanitized = sanitizeToolsForGemini(rawTools);
+                if (sanitized.dropped.length > 0) {
+                    logger.warn(`[GoogleVertex] Dropped ${sanitized.dropped.length} incompatible tool(s): ${sanitized.dropped.join(", ")}`);
+                }
+                tools =
+                    Object.keys(sanitized.tools).length > 0
+                        ? sanitized.tools
+                        : undefined;
+            }
+            else if (isAnthropic && Object.keys(rawTools).length > 0) {
+                // Anthropic models don't need Gemini sanitization — pass tools through
+                tools = rawTools;
+            }
+            else {
+                tools = undefined;
+            }
             logger.debug(`${functionTag}: Tools for streaming`, {
                 shouldUseTools,
                 baseToolCount: Object.keys(baseStreamTools).length,
                 externalToolCount: Object.keys(options.tools || {}).length,
-                toolCount: Object.keys(tools).length,
-                toolNames: Object.keys(tools),
+                toolCount: Object.keys(tools ?? {}).length,
+                toolNames: Object.keys(tools ?? {}),
             });
             // Model-specific maxTokens handling
             const modelName = this.resolveAlias(options.model || this.modelName || getDefaultVertexModel());
@@ -857,6 +865,7 @@ export class GoogleVertexProvider extends BaseProvider {
                 ...(maxTokens && { maxTokens }),
                 maxRetries: 0, // NL11: Disable AI SDK's invisible internal retries; we handle retries with OTel instrumentation
                 ...(shouldUseTools &&
+                    tools &&
                     Object.keys(tools).length > 0 && {
                     tools,
                     toolChoice: "auto",

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.js

@@ -457,9 +457,20 @@ export class GoogleAIStudioProvider extends BaseProvider {
                 ? { ...baseTools, ...(options.tools || {}) }
                 : {};
             // Sanitize tool schemas for Gemini proto compatibility (converts anyOf/oneOf unions to string)
-            const tools = Object.keys(rawTools).length > 0
-                ? sanitizeToolsForGemini(rawTools)
-                : rawTools;
+            let tools;
+            if (Object.keys(rawTools).length > 0) {
+                const sanitized = sanitizeToolsForGemini(rawTools);
+                if (sanitized.dropped.length > 0) {
+                    logger.warn(`[GoogleAIStudio] Dropped ${sanitized.dropped.length} incompatible tool(s): ${sanitized.dropped.join(", ")}`);
+                }
+                tools =
+                    Object.keys(sanitized.tools).length > 0
+                        ? sanitized.tools
+                        : undefined;
+            }
+            else {
+                tools = undefined;
+            }
             // Build message array from options with multimodal support
             // Using protected helper from BaseProvider to eliminate code duplication
             const messages = await this.buildMessagesForStream(options);
@@ -470,7 +481,7 @@ export class GoogleAIStudioProvider extends BaseProvider {
                 maxTokens: options.maxTokens, // No default limit - unlimited unless specified
                 tools,
                 maxSteps: options.maxSteps || DEFAULT_MAX_STEPS,
-                toolChoice: shouldUseTools ? "auto" : "none",
+                toolChoice: shouldUseTools && tools ? "auto" : "none",
                 abortSignal: composeAbortSignals(options.abortSignal, timeoutController?.controller.signal),
                 experimental_telemetry: this.telemetryHandler.getTelemetryConfig(options),
                 // Gemini 3: use thinkingLevel via providerOptions

package/dist/providers/googleNativeGemini3.d.ts

@@ -66,7 +66,10 @@ export declare function sanitizeSchemaForGemini(schema: Record<string, unknown>)
  * This function pre-converts each tool's Zod parameters to sanitized JSON Schema
  * and re-wraps with the Vercel AI SDK's jsonSchema() helper.
  */
-export declare function sanitizeToolsForGemini(tools: Record<string, Tool>): Record<string, Tool>;
+export declare function sanitizeToolsForGemini(tools: Record<string, Tool>): {
+    tools: Record<string, Tool>;
+    dropped: string[];
+};
 /**
  * Convert Vercel AI SDK tools to @google/genai FunctionDeclarations and an execute map.
  *

package/dist/providers/googleNativeGemini3.js

@@ -114,6 +114,7 @@ export function sanitizeSchemaForGemini(schema) {
  */
 export function sanitizeToolsForGemini(tools) {
     const sanitized = {};
+    const dropped = [];
     for (const [name, tool] of Object.entries(tools)) {
         try {
             const params = tool.parameters;
@@ -156,10 +157,11 @@ export function sanitizeToolsForGemini(tools) {
         catch (error) {
             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
+            dropped.push(name);
             continue;
         }
     }
-    return sanitized;
+    return { tools: sanitized, dropped };
 }
 /**
  * Convert Vercel AI SDK tools to @google/genai FunctionDeclarations and an execute map.

package/dist/providers/googleVertex.js

@@ -777,14 +777,17 @@ export class GoogleVertexProvider extends BaseProvider {
     async executeStream(options, analysisSchema) {
         // Check if this is a Gemini 3 model with tools - use native SDK for thought_signature
         const gemini3CheckModelName = this.resolveAlias(options.model || this.modelName || getDefaultVertexModel());
+        // 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;
         const hasTools = gemini3CheckShouldUseTools && combinedToolCount > 0;
-        if (isGemini3Model(gemini3CheckModelName) && hasTools && !analysisSchema) {
+        if (isGemini3Model(gemini3CheckModelName) && hasTools) {
             // 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,16 +795,6 @@ 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,
@@ -831,15 +824,30 @@ export class GoogleVertexProvider extends BaseProvider {
                 : {};
             // Only sanitize for Gemini models (not Anthropic/Claude models routed through Vertex)
             const isAnthropic = isAnthropicModel(gemini3CheckModelName);
-            const tools = Object.keys(rawTools).length > 0 && !isAnthropic
-                ? sanitizeToolsForGemini(rawTools)
-                : rawTools;
+            let tools;
+            if (Object.keys(rawTools).length > 0 && !isAnthropic) {
+                const sanitized = sanitizeToolsForGemini(rawTools);
+                if (sanitized.dropped.length > 0) {
+                    logger.warn(`[GoogleVertex] Dropped ${sanitized.dropped.length} incompatible tool(s): ${sanitized.dropped.join(", ")}`);
+                }
+                tools =
+                    Object.keys(sanitized.tools).length > 0
+                        ? sanitized.tools
+                        : undefined;
+            }
+            else if (isAnthropic && Object.keys(rawTools).length > 0) {
+                // Anthropic models don't need Gemini sanitization — pass tools through
+                tools = rawTools;
+            }
+            else {
+                tools = undefined;
+            }
             logger.debug(`${functionTag}: Tools for streaming`, {
                 shouldUseTools,
                 baseToolCount: Object.keys(baseStreamTools).length,
                 externalToolCount: Object.keys(options.tools || {}).length,
-                toolCount: Object.keys(tools).length,
-                toolNames: Object.keys(tools),
+                toolCount: Object.keys(tools ?? {}).length,
+                toolNames: Object.keys(tools ?? {}),
             });
             // Model-specific maxTokens handling
             const modelName = this.resolveAlias(options.model || this.modelName || getDefaultVertexModel());
@@ -857,6 +865,7 @@ export class GoogleVertexProvider extends BaseProvider {
                 ...(maxTokens && { maxTokens }),
                 maxRetries: 0, // NL11: Disable AI SDK's invisible internal retries; we handle retries with OTel instrumentation
                 ...(shouldUseTools &&
+                    tools &&
                     Object.keys(tools).length > 0 && {
                     tools,
                     toolChoice: "auto",

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.20.0",
+  "version": "9.22.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",