@juspay/neurolink 9.55.11 → 9.56.0

package/dist/core/redisConversationMemoryManager.js

@@ -631,6 +631,11 @@ export class RedisConversationMemoryManager {
      * Applies sendToolPreview toggle and hydrates result.result for backward compat
      */
     async buildContextMessages(sessionId, userId, enableSummarization, requestId) {
+        logger.debug("[RedisConversationMemoryManager] Building context messages", {
+            sessionId,
+            userId,
+            enableSummarization,
+        });
         await this.ensureInitialized();
         if (!this.redisClient) {
             logger.warn("[RedisConversationMemoryManager] Redis client not available in buildContextMessages");
@@ -654,6 +659,11 @@ export class RedisConversationMemoryManager {
                 const redisKey = getSessionKey(this.redisConfig, sessionId, userId);
                 const conversationData = await withTimeout(redisClient.get(redisKey), REDIS_TIMEOUT_MS);
                 const conversation = deserializeConversation(conversationData || null);
+                logger.debug("[RedisConversationMemoryManager] Retrieved conversation for context building", {
+                    sessionId,
+                    userId,
+                    conversationFound: !!conversation,
+                });
                 if (!conversation) {
                     span.setAttribute("session.found", false);
                     span.setStatus({ code: SpanStatusCode.OK });
@@ -672,6 +682,12 @@ export class RedisConversationMemoryManager {
                     lastActivity: new Date(conversation.updatedAt).getTime(),
                 };
                 const contextMessages = buildContextFromPointer(session, requestId);
+                logger.debug("[RedisConversationMemoryManager] Built context messages from pointer", {
+                    sessionId,
+                    userId,
+                    contextMessageCount: contextMessages.length,
+                    pointerMessageId: session.summarizedUpToMessageId || "none",
+                });
                 const sendToolPreview = this.config?.contextCompaction?.sendToolPreview === true;
                 // Map tool_result messages: apply preview toggle + hydrate result.result
                 const finalMessages = contextMessages.map((msg) => {
@@ -695,6 +711,15 @@ export class RedisConversationMemoryManager {
                         }
                         hydratedResult = { ...msg.result, result: parsedResult };
                     }
+                    logger.debug("[RedisConversationMemoryManager] Processing tool_result message for context", {
+                        sessionId,
+                        userId,
+                        messageId: msg.id,
+                        sendToolPreview,
+                        hasPreview: !!msg.metadata?.toolOutputPreview,
+                        contentLength: content ? String(content).length : 0,
+                        resultHydrated: hydratedResult !== msg.result,
+                    });
                     return { ...msg, content, result: hydratedResult };
                 });
                 // Tool messages now have real content and participate in context properly.

package/dist/lib/core/redisConversationMemoryManager.js

@@ -631,6 +631,11 @@ export class RedisConversationMemoryManager {
      * Applies sendToolPreview toggle and hydrates result.result for backward compat
      */
     async buildContextMessages(sessionId, userId, enableSummarization, requestId) {
+        logger.debug("[RedisConversationMemoryManager] Building context messages", {
+            sessionId,
+            userId,
+            enableSummarization,
+        });
         await this.ensureInitialized();
         if (!this.redisClient) {
             logger.warn("[RedisConversationMemoryManager] Redis client not available in buildContextMessages");
@@ -654,6 +659,11 @@ export class RedisConversationMemoryManager {
                 const redisKey = getSessionKey(this.redisConfig, sessionId, userId);
                 const conversationData = await withTimeout(redisClient.get(redisKey), REDIS_TIMEOUT_MS);
                 const conversation = deserializeConversation(conversationData || null);
+                logger.debug("[RedisConversationMemoryManager] Retrieved conversation for context building", {
+                    sessionId,
+                    userId,
+                    conversationFound: !!conversation,
+                });
                 if (!conversation) {
                     span.setAttribute("session.found", false);
                     span.setStatus({ code: SpanStatusCode.OK });
@@ -672,6 +682,12 @@ export class RedisConversationMemoryManager {
                     lastActivity: new Date(conversation.updatedAt).getTime(),
                 };
                 const contextMessages = buildContextFromPointer(session, requestId);
+                logger.debug("[RedisConversationMemoryManager] Built context messages from pointer", {
+                    sessionId,
+                    userId,
+                    contextMessageCount: contextMessages.length,
+                    pointerMessageId: session.summarizedUpToMessageId || "none",
+                });
                 const sendToolPreview = this.config?.contextCompaction?.sendToolPreview === true;
                 // Map tool_result messages: apply preview toggle + hydrate result.result
                 const finalMessages = contextMessages.map((msg) => {
@@ -695,6 +711,15 @@ export class RedisConversationMemoryManager {
                         }
                         hydratedResult = { ...msg.result, result: parsedResult };
                     }
+                    logger.debug("[RedisConversationMemoryManager] Processing tool_result message for context", {
+                        sessionId,
+                        userId,
+                        messageId: msg.id,
+                        sendToolPreview,
+                        hasPreview: !!msg.metadata?.toolOutputPreview,
+                        contentLength: content ? String(content).length : 0,
+                        resultHydrated: hydratedResult !== msg.result,
+                    });
                     return { ...msg, content, result: hydratedResult };
                 });
                 // Tool messages now have real content and participate in context properly.

package/dist/lib/neurolink.js

@@ -4486,6 +4486,16 @@ Current user's request: ${currentInput}`;
      * @throws {Error} When conversation memory operations fail (if enabled)
      */
     async stream(options) {
+        logger.debug("[NeuroLink] stream() called with options", {
+            provider: options.provider,
+            model: options.model,
+            inputLength: options.input?.text?.length || 0,
+            disableTools: options.disableTools,
+            enableAnalytics: options.enableAnalytics,
+            enableEvaluation: options.enableEvaluation,
+            contextKeys: options.context ? Object.keys(options.context) : [],
+            optionKeys: Object.keys(options),
+        });
         return metricsTraceContextStorage.run(this.createMetricsTraceContext(), () => this.executeStreamRequest({ ...options }));
     }
     async executeStreamRequest(options) {
@@ -4578,8 +4588,26 @@ Current user's request: ${currentInput}`;
     }
     async runStandardStreamRequest(params) {
         const { options, streamSpan, spanStartTime, startTime, hrTimeStart, streamId, originalPrompt, } = params;
+        logger.debug("[NeuroLink] Running standard stream request", {
+            streamId,
+            provider: options.provider,
+            model: options.model,
+            inputLength: options.input?.text?.length || 0,
+            disableTools: options.disableTools,
+            enableAnalytics: options.enableAnalytics,
+            enableEvaluation: options.enableEvaluation,
+            contextKeys: options.context ? Object.keys(options.context) : [],
+            optionKeys: Object.keys(options),
+            sessionId: options.context?.sessionId,
+        });
         try {
             const { enhancedOptions, factoryResult } = await this.prepareStreamOptions(options, streamId, startTime, hrTimeStart);
+            logger.debug("[NeuroLink] Stream options prepared", {
+                streamId,
+                options: enhancedOptions,
+                factoryResult,
+                sessionId: enhancedOptions.context?.sessionId,
+            });
             const { stream: mcpStream, provider: providerName, usage: streamUsage, model: streamModel, finishReason: streamFinishReason, toolCalls: streamToolCalls, toolResults: streamToolResults, analytics: streamAnalytics, } = await this.createMCPStream(enhancedOptions);
             const streamState = {
                 finishReason: streamFinishReason ?? "stop",
@@ -4669,6 +4697,16 @@ Current user's request: ${currentInput}`;
                     });
                 }
                 catch (error) {
+                    logger.debug("[NeuroLink.stream] Stream error occurred", {
+                        error: error instanceof Error ? error.message : String(error),
+                        name: error instanceof Error ? error.name : "UnknownError",
+                        provider: providerName,
+                        model: enhancedOptions.model,
+                        chunkCount,
+                        totalLength: accumulatedContent.length,
+                        durationMs: Date.now() - streamStartTime,
+                        sessionId,
+                    });
                     streamError = error;
                     self.emitter.emit("stream:error", {
                         type: "stream:error",
@@ -4687,6 +4725,16 @@ Current user's request: ${currentInput}`;
                     throw error;
                 }
                 finally {
+                    logger.debug("[NeuroLink.stream] Stream finished, performing cleanup", {
+                        provider: providerName,
+                        model: enhancedOptions.model,
+                        totalChunks: chunkCount,
+                        totalLength: accumulatedContent.length,
+                        durationMs: Date.now() - streamStartTime,
+                        fallbackAttempted: metadata.fallbackAttempted,
+                        guardrailsBlocked: metadata.guardrailsBlocked,
+                        error: metadata.error,
+                    });
                     self._disableToolCacheForCurrentRequest = false;
                     cleanupListeners();
                     streamSpan.setAttribute("neurolink.response_time_ms", Date.now() - spanStartTime);
@@ -5084,6 +5132,11 @@ Current user's request: ${currentInput}`;
      */
     async storeStreamConversationMemory(params) {
         const { enhancedOptions, providerName, originalPrompt, accumulatedContent, startTime, eventSequence, } = params;
+        logger.debug("[NeuroLink.stream] Preparing to store conversation turn in memory", {
+            options: JSON.stringify(enhancedOptions),
+            sessionId: enhancedOptions.context
+                ?.sessionId,
+        });
         // Guard: skip storing if no meaningful content was produced (no text AND no tool activity)
         const hasToolEvents = eventSequence.some((e) => e.type === "tool:start" || e.type === "tool:end");
         if (!accumulatedContent.trim() && !hasToolEvents) {
@@ -5093,6 +5146,12 @@ Current user's request: ${currentInput}`;
             });
             return;
         }
+        logger.debug("[NeuroLink.stream] Storing conversation turn in memory", {
+            options: JSON.stringify(enhancedOptions),
+            sessionId: enhancedOptions.context
+                ?.sessionId,
+            conversationMemoryExists: this.conversationMemory ? true : false,
+        });
         // Store memory after stream consumption is complete
         if (this.conversationMemory && enhancedOptions.context?.sessionId) {
             const sessionId = enhancedOptions.context

package/dist/lib/utils/conversationMemory.js

@@ -27,8 +27,21 @@ export function applyConversationMemoryDefaults(userConfig) {
  * Get conversation history as message array, summarizing if needed.
  */
 export async function getConversationMessages(conversationMemory, options) {
+    logger.debug("[conversationMemoryUtils] getConversationMessages called", {
+        hasMemory: !!conversationMemory,
+        memoryType: conversationMemory?.constructor?.name || "NONE",
+        hasContext: !!options.context,
+        enableSummarization: options.enableSummarization ?? false,
+        options: JSON.stringify(options, null, 2),
+    });
     if (!conversationMemory || !options.context) {
-        logger.warn("[conversationMemoryUtils] No memory or context, returning empty messages");
+        logger.warn("[conversationMemoryUtils] No memory or context, returning empty messages", {
+            hasMemory: !!conversationMemory,
+            memoryType: conversationMemory?.constructor?.name || "NONE",
+            hasContext: !!options.context,
+            enableSummarization: options.enableSummarization ?? false,
+            options: JSON.stringify(options, null, 2),
+        });
         return [];
     }
     const sessionId = options.context?.sessionId;

package/dist/neurolink.js

@@ -4486,6 +4486,16 @@ Current user's request: ${currentInput}`;
      * @throws {Error} When conversation memory operations fail (if enabled)
      */
     async stream(options) {
+        logger.debug("[NeuroLink] stream() called with options", {
+            provider: options.provider,
+            model: options.model,
+            inputLength: options.input?.text?.length || 0,
+            disableTools: options.disableTools,
+            enableAnalytics: options.enableAnalytics,
+            enableEvaluation: options.enableEvaluation,
+            contextKeys: options.context ? Object.keys(options.context) : [],
+            optionKeys: Object.keys(options),
+        });
         return metricsTraceContextStorage.run(this.createMetricsTraceContext(), () => this.executeStreamRequest({ ...options }));
     }
     async executeStreamRequest(options) {
@@ -4578,8 +4588,26 @@ Current user's request: ${currentInput}`;
     }
     async runStandardStreamRequest(params) {
         const { options, streamSpan, spanStartTime, startTime, hrTimeStart, streamId, originalPrompt, } = params;
+        logger.debug("[NeuroLink] Running standard stream request", {
+            streamId,
+            provider: options.provider,
+            model: options.model,
+            inputLength: options.input?.text?.length || 0,
+            disableTools: options.disableTools,
+            enableAnalytics: options.enableAnalytics,
+            enableEvaluation: options.enableEvaluation,
+            contextKeys: options.context ? Object.keys(options.context) : [],
+            optionKeys: Object.keys(options),
+            sessionId: options.context?.sessionId,
+        });
         try {
             const { enhancedOptions, factoryResult } = await this.prepareStreamOptions(options, streamId, startTime, hrTimeStart);
+            logger.debug("[NeuroLink] Stream options prepared", {
+                streamId,
+                options: enhancedOptions,
+                factoryResult,
+                sessionId: enhancedOptions.context?.sessionId,
+            });
             const { stream: mcpStream, provider: providerName, usage: streamUsage, model: streamModel, finishReason: streamFinishReason, toolCalls: streamToolCalls, toolResults: streamToolResults, analytics: streamAnalytics, } = await this.createMCPStream(enhancedOptions);
             const streamState = {
                 finishReason: streamFinishReason ?? "stop",
@@ -4669,6 +4697,16 @@ Current user's request: ${currentInput}`;
                     });
                 }
                 catch (error) {
+                    logger.debug("[NeuroLink.stream] Stream error occurred", {
+                        error: error instanceof Error ? error.message : String(error),
+                        name: error instanceof Error ? error.name : "UnknownError",
+                        provider: providerName,
+                        model: enhancedOptions.model,
+                        chunkCount,
+                        totalLength: accumulatedContent.length,
+                        durationMs: Date.now() - streamStartTime,
+                        sessionId,
+                    });
                     streamError = error;
                     self.emitter.emit("stream:error", {
                         type: "stream:error",
@@ -4687,6 +4725,16 @@ Current user's request: ${currentInput}`;
                     throw error;
                 }
                 finally {
+                    logger.debug("[NeuroLink.stream] Stream finished, performing cleanup", {
+                        provider: providerName,
+                        model: enhancedOptions.model,
+                        totalChunks: chunkCount,
+                        totalLength: accumulatedContent.length,
+                        durationMs: Date.now() - streamStartTime,
+                        fallbackAttempted: metadata.fallbackAttempted,
+                        guardrailsBlocked: metadata.guardrailsBlocked,
+                        error: metadata.error,
+                    });
                     self._disableToolCacheForCurrentRequest = false;
                     cleanupListeners();
                     streamSpan.setAttribute("neurolink.response_time_ms", Date.now() - spanStartTime);
@@ -5084,6 +5132,11 @@ Current user's request: ${currentInput}`;
      */
     async storeStreamConversationMemory(params) {
         const { enhancedOptions, providerName, originalPrompt, accumulatedContent, startTime, eventSequence, } = params;
+        logger.debug("[NeuroLink.stream] Preparing to store conversation turn in memory", {
+            options: JSON.stringify(enhancedOptions),
+            sessionId: enhancedOptions.context
+                ?.sessionId,
+        });
         // Guard: skip storing if no meaningful content was produced (no text AND no tool activity)
         const hasToolEvents = eventSequence.some((e) => e.type === "tool:start" || e.type === "tool:end");
         if (!accumulatedContent.trim() && !hasToolEvents) {
@@ -5093,6 +5146,12 @@ Current user's request: ${currentInput}`;
             });
             return;
         }
+        logger.debug("[NeuroLink.stream] Storing conversation turn in memory", {
+            options: JSON.stringify(enhancedOptions),
+            sessionId: enhancedOptions.context
+                ?.sessionId,
+            conversationMemoryExists: this.conversationMemory ? true : false,
+        });
         // Store memory after stream consumption is complete
         if (this.conversationMemory && enhancedOptions.context?.sessionId) {
             const sessionId = enhancedOptions.context

package/dist/utils/conversationMemory.js

@@ -27,8 +27,21 @@ export function applyConversationMemoryDefaults(userConfig) {
  * Get conversation history as message array, summarizing if needed.
  */
 export async function getConversationMessages(conversationMemory, options) {
+    logger.debug("[conversationMemoryUtils] getConversationMessages called", {
+        hasMemory: !!conversationMemory,
+        memoryType: conversationMemory?.constructor?.name || "NONE",
+        hasContext: !!options.context,
+        enableSummarization: options.enableSummarization ?? false,
+        options: JSON.stringify(options, null, 2),
+    });
     if (!conversationMemory || !options.context) {
-        logger.warn("[conversationMemoryUtils] No memory or context, returning empty messages");
+        logger.warn("[conversationMemoryUtils] No memory or context, returning empty messages", {
+            hasMemory: !!conversationMemory,
+            memoryType: conversationMemory?.constructor?.name || "NONE",
+            hasContext: !!options.context,
+            enableSummarization: options.enableSummarization ?? false,
+            options: JSON.stringify(options, null, 2),
+        });
         return [];
     }
     const sessionId = options.context?.sessionId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.55.11",
+  "version": "9.56.0",
   "packageManager": "pnpm@10.15.1",
   "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": {