@juspay/neurolink 9.55.11 → 9.56.1

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.
@@ -911,12 +936,16 @@ export class RedisConversationMemoryManager {
             const titleGenerator = new NeuroLink({
                 conversationMemory: { enabled: false },
             });
-            const titlePrompt = `Generate a clear, concise, and descriptive title (5–8 words maximum) for a conversation based on the following user message.
+            const defaultTitlePrompt = `Generate a clear, concise, and descriptive title (20-25 letters maximum) for a conversation based on the following user message.
 The title must meaningfully reflect the topic or intent of the message.
 Do not output anything unrelated, vague, or generic.
 Do not say you cannot create a title. Always return a valid title.
 
 User message: "${userMessage}"`;
+            const customPrompt = process.env.NEUROLINK_TITLE_PROMPT;
+            const titlePrompt = customPrompt
+                ? customPrompt.replace(/\$\{userMessage\}/g, userMessage)
+                : defaultTitlePrompt;
             const result = await titleGenerator.generate({
                 input: { text: titlePrompt },
                 provider: this.config.summarizationProvider || "vertex",

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.
@@ -911,12 +936,16 @@ export class RedisConversationMemoryManager {
             const titleGenerator = new NeuroLink({
                 conversationMemory: { enabled: false },
             });
-            const titlePrompt = `Generate a clear, concise, and descriptive title (5–8 words maximum) for a conversation based on the following user message.
+            const defaultTitlePrompt = `Generate a clear, concise, and descriptive title (20-25 letters maximum) for a conversation based on the following user message.
 The title must meaningfully reflect the topic or intent of the message.
 Do not output anything unrelated, vague, or generic.
 Do not say you cannot create a title. Always return a valid title.
 
 User message: "${userMessage}"`;
+            const customPrompt = process.env.NEUROLINK_TITLE_PROMPT;
+            const titlePrompt = customPrompt
+                ? customPrompt.replace(/\$\{userMessage\}/g, userMessage)
+                : defaultTitlePrompt;
             const result = await titleGenerator.generate({
                 input: { text: titlePrompt },
                 provider: this.config.summarizationProvider || "vertex",

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/lib/utils/messageBuilder.js

@@ -397,6 +397,9 @@ function toModelMessage(message) {
     if (message.role === "user" ||
         message.role === "assistant" ||
         message.role === "system") {
+        if (message.content.trim() === "") {
+            return null;
+        }
         return {
             role: message.role,
             content: message.content,

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/dist/utils/messageBuilder.js

@@ -397,6 +397,9 @@ function toModelMessage(message) {
     if (message.role === "user" ||
         message.role === "assistant" ||
         message.role === "system") {
+        if (message.content.trim() === "") {
+            return null;
+        }
         return {
             role: message.role,
             content: message.content,

package/package.json

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