@juspay/neurolink 7.11.1 → 7.13.0

package/dist/types/conversationTypes.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Conversation Memory Types for NeuroLink
+ * Provides type-safe conversation storage and context management
+ */
+/**
+ * Configuration for conversation memory feature
+ */
+export interface ConversationMemoryConfig {
+    /** Enable conversation memory feature */
+    enabled: boolean;
+    /** Maximum number of sessions to keep in memory (default: 50) */
+    maxSessions?: number;
+    /** Maximum number of conversation turns to keep per session (default: 20) */
+    maxTurnsPerSession?: number;
+}
+/**
+ * Complete memory for a conversation session
+ * ULTRA-OPTIMIZED: Direct ChatMessage[] storage - zero conversion overhead
+ */
+export interface SessionMemory {
+    /** Unique session identifier */
+    sessionId: string;
+    /** User identifier (optional) */
+    userId?: string;
+    /** Direct message storage - ready for immediate AI consumption */
+    messages: ChatMessage[];
+    /** When this session was created */
+    createdAt: number;
+    /** When this session was last active */
+    lastActivity: number;
+    /** Optional session metadata */
+    metadata?: {
+        /** User role or permissions */
+        userRole?: string;
+        /** Tags for categorizing this session */
+        tags?: string[];
+        /** Custom data specific to the organization */
+        customData?: Record<string, unknown>;
+    };
+}
+/**
+ * Statistics about conversation memory usage (simplified for pure in-memory storage)
+ */
+export interface ConversationMemoryStats {
+    /** Total number of active sessions */
+    totalSessions: number;
+    /** Total number of conversation turns across all sessions */
+    totalTurns: number;
+}
+/**
+ * Chat message format for conversation history
+ */
+export interface ChatMessage {
+    /** Role of the message sender */
+    role: "user" | "assistant" | "system";
+    /** Content of the message */
+    content: string;
+}
+/**
+ * Events emitted by conversation memory system
+ */
+export interface ConversationMemoryEvents {
+    /** Emitted when a new session is created */
+    "session:created": {
+        sessionId: string;
+        userId?: string;
+        timestamp: number;
+    };
+    /** Emitted when a conversation turn is stored */
+    "turn:stored": {
+        sessionId: string;
+        turnIndex: number;
+        timestamp: number;
+    };
+    /** Emitted when a session is cleaned up */
+    "session:cleanup": {
+        sessionId: string;
+        reason: "expired" | "limit_exceeded";
+        timestamp: number;
+    };
+    /** Emitted when context is injected */
+    "context:injected": {
+        sessionId: string;
+        turnsIncluded: number;
+        timestamp: number;
+    };
+}
+/**
+ * Error types specific to conversation memory
+ */
+export declare class ConversationMemoryError extends Error {
+    code: "STORAGE_ERROR" | "CONFIG_ERROR" | "SESSION_NOT_FOUND" | "CLEANUP_ERROR";
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: "STORAGE_ERROR" | "CONFIG_ERROR" | "SESSION_NOT_FOUND" | "CLEANUP_ERROR", details?: Record<string, unknown> | undefined);
+}

package/dist/types/conversationTypes.js

@@ -0,0 +1,17 @@
+/**
+ * Conversation Memory Types for NeuroLink
+ * Provides type-safe conversation storage and context management
+ */
+/**
+ * Error types specific to conversation memory
+ */
+export class ConversationMemoryError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "ConversationMemoryError";
+    }
+}

package/dist/types/streamTypes.d.ts

@@ -2,6 +2,7 @@ import type { ZodType, ZodTypeDef } from "zod";
 import type { Tool, Schema } from "ai";
 import type { AIProviderName, AnalyticsData, EvaluationData } from "../core/types.js";
 import type { UnknownRecord, JsonValue } from "./common.js";
+import type { ChatMessage } from "./conversationTypes.js";
 /**
  * Interface for tool execution calls (AI SDK compatible)
  */
@@ -107,6 +108,7 @@ export interface StreamOptions {
         enableProgress?: boolean;
         fallbackToGenerate?: boolean;
     };
+    conversationMessages?: ChatMessage[];
 }
 /**
  * Stream function result interface - Primary output format for streaming

package/dist/utils/conversationMemoryUtils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Conversation Memory Utilities
+ * Handles configuration merging and conversation memory operations
+ */
+import type { ConversationMemoryConfig, ChatMessage } from "../types/conversationTypes.js";
+import type { ConversationMemoryManager } from "../core/conversationMemoryManager.js";
+import type { TextGenerationOptions, TextGenerationResult } from "../core/types.js";
+/**
+ * Apply conversation memory defaults to user configuration
+ * Merges user config with environment variables and default values
+ */
+export declare function applyConversationMemoryDefaults(userConfig?: Partial<ConversationMemoryConfig>): ConversationMemoryConfig;
+/**
+ * Get conversation history as message array (PREFERRED METHOD)
+ * Returns proper message array format for AI providers
+ */
+export declare function getConversationMessages(conversationMemory: ConversationMemoryManager | undefined, options: TextGenerationOptions): Promise<ChatMessage[]>;
+/**
+ * Store conversation turn for future context
+ * Saves user messages and AI responses for conversation memory
+ */
+export declare function storeConversationTurn(conversationMemory: ConversationMemoryManager | undefined, originalOptions: TextGenerationOptions, result: TextGenerationResult): Promise<void>;

package/dist/utils/conversationMemoryUtils.js

@@ -0,0 +1,77 @@
+/**
+ * Conversation Memory Utilities
+ * Handles configuration merging and conversation memory operations
+ */
+import { getConversationMemoryDefaults } from "../config/conversationMemoryConfig.js";
+import { logger } from "./logger.js";
+/**
+ * Apply conversation memory defaults to user configuration
+ * Merges user config with environment variables and default values
+ */
+export function applyConversationMemoryDefaults(userConfig) {
+    const defaults = getConversationMemoryDefaults();
+    return {
+        enabled: userConfig?.enabled ?? defaults.enabled,
+        maxSessions: userConfig?.maxSessions ?? defaults.maxSessions,
+        maxTurnsPerSession: userConfig?.maxTurnsPerSession ?? defaults.maxTurnsPerSession,
+    };
+}
+/**
+ * Get conversation history as message array (PREFERRED METHOD)
+ * Returns proper message array format for AI providers
+ */
+export async function getConversationMessages(conversationMemory, options) {
+    if (!conversationMemory || !options.context) {
+        return [];
+    }
+    const sessionId = options.context?.sessionId;
+    if (typeof sessionId !== "string" || !sessionId) {
+        return [];
+    }
+    try {
+        const messages = conversationMemory.buildContextMessages(sessionId);
+        logger.debug("Conversation messages retrieved", {
+            sessionId,
+            messageCount: messages.length,
+        });
+        return messages;
+    }
+    catch (error) {
+        logger.warn("Failed to get conversation messages", {
+            sessionId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return [];
+    }
+}
+/**
+ * Store conversation turn for future context
+ * Saves user messages and AI responses for conversation memory
+ */
+export async function storeConversationTurn(conversationMemory, originalOptions, result) {
+    if (!conversationMemory || !originalOptions.context) {
+        return;
+    }
+    const context = originalOptions.context;
+    const sessionId = context.sessionId;
+    const userId = typeof context.userId === "string" ? context.userId : undefined;
+    if (typeof sessionId !== "string" || !sessionId) {
+        return;
+    }
+    try {
+        await conversationMemory.storeConversationTurn(sessionId, userId, originalOptions.prompt || "", result.content);
+        logger.debug("Conversation turn stored", {
+            sessionId,
+            userId,
+            promptLength: originalOptions.prompt?.length || 0,
+            responseLength: result.content.length,
+        });
+    }
+    catch (error) {
+        logger.warn("Failed to store conversation turn", {
+            sessionId,
+            userId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}

package/dist/utils/messageBuilder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Message Builder Utility
+ * Centralized logic for building message arrays from TextGenerationOptions
+ */
+import type { ChatMessage } from "../types/conversationTypes.js";
+import type { TextGenerationOptions } from "../core/types.js";
+import type { StreamOptions } from "../types/streamTypes.js";
+/**
+ * Build a properly formatted message array for AI providers
+ * Combines system prompt, conversation history, and current user prompt
+ * Supports both TextGenerationOptions and StreamOptions
+ */
+export declare function buildMessagesArray(options: TextGenerationOptions | StreamOptions): ChatMessage[];

package/dist/utils/messageBuilder.js

@@ -0,0 +1,48 @@
+/**
+ * Message Builder Utility
+ * Centralized logic for building message arrays from TextGenerationOptions
+ */
+import { CONVERSATION_INSTRUCTIONS } from "../config/conversationMemoryConfig.js";
+/**
+ * Build a properly formatted message array for AI providers
+ * Combines system prompt, conversation history, and current user prompt
+ * Supports both TextGenerationOptions and StreamOptions
+ */
+export function buildMessagesArray(options) {
+    const messages = [];
+    // Check if conversation history exists
+    const hasConversationHistory = options.conversationMessages && options.conversationMessages.length > 0;
+    // Build enhanced system prompt
+    let systemPrompt = options.systemPrompt?.trim() || "";
+    // Add conversation-aware instructions when history exists
+    if (hasConversationHistory) {
+        systemPrompt = `${systemPrompt.trim()}${CONVERSATION_INSTRUCTIONS}`;
+    }
+    // Add system message if we have one
+    if (systemPrompt.trim()) {
+        messages.push({
+            role: "system",
+            content: systemPrompt.trim(),
+        });
+    }
+    // Add conversation history if available
+    if (hasConversationHistory && options.conversationMessages) {
+        messages.push(...options.conversationMessages);
+    }
+    // Add current user prompt (required)
+    // Handle both TextGenerationOptions (prompt field) and StreamOptions (input.text field)
+    let currentPrompt;
+    if ("prompt" in options && options.prompt) {
+        currentPrompt = options.prompt;
+    }
+    else if ("input" in options && options.input?.text) {
+        currentPrompt = options.input.text;
+    }
+    if (currentPrompt?.trim()) {
+        messages.push({
+            role: "user",
+            content: currentPrompt.trim(),
+        });
+    }
+    return messages;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.11.1",
+  "version": "7.13.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 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",