@juspay/neurolink 9.20.0 → 9.21.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [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/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/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/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/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.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",