@juspay/neurolink 9.5.3 → 9.6.0

package/dist/memory/mem0Initializer.d.ts

@@ -6,7 +6,7 @@ import { MemoryClient } from "mem0ai";
 /**
  * Mem0 cloud API configuration
  */
-export interface Mem0Config {
+export type Mem0Config = {
     apiKey: string;
     /**
      * Optional organization ID - if not provided, will be auto-populated from ping() response
@@ -39,7 +39,7 @@ export interface Mem0Config {
          */
         custom_categories?: Array<Record<string, unknown>>;
     };
-}
+};
 /**
  * Initialize mem0 memory instance with cloud API and optional project settings
  */

package/dist/neurolink.d.ts

@@ -5,7 +5,7 @@
  * Enhanced AI provider system with natural MCP tool access.
  * Uses real MCP infrastructure for tool discovery and execution.
  */
-import type { TextGenerationOptions, TextGenerationResult } from "./types/index.js";
+import { type CompactionConfig, type CompactionResult } from "./context/contextCompactor.js";
 import type { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
 import type { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
 import { ExternalServerManager } from "./mcp/externalServerManager.js";
@@ -15,7 +15,7 @@ import type { NeurolinkConstructorConfig } from "./types/configTypes.js";
 import type { ChatMessage } from "./types/conversation.js";
 import type { ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo } from "./types/externalMcp.js";
 import type { GenerateOptions, GenerateResult } from "./types/generateTypes.js";
-import type { ProviderStatus } from "./types/index.js";
+import type { ProviderStatus, TextGenerationOptions, TextGenerationResult } from "./types/index.js";
 import type { MCPExecutableTool, MCPServerInfo, MCPStatus } from "./types/mcpTypes.js";
 import type { ObservabilityConfig } from "./types/observability.js";
 import type { StreamOptions, StreamResult } from "./types/streamTypes.js";
@@ -123,6 +123,8 @@ export declare class NeuroLink {
     private hitlManager?;
     private mem0Instance?;
     private mem0Config?;
+    private fileRegistry;
+    private cachedFileTools;
     /**
      * Extract and set Langfuse context from options with proper async scoping
      */
@@ -205,6 +207,14 @@ export declare class NeuroLink {
      * Initialize HITL (Human-in-the-Loop) if enabled
      */
     private initializeHITL;
+    /**
+     * Register file reference tools with the MCP tool registry.
+     *
+     * Creates file access tools (list_attached_files, read_file_section,
+     * search_in_file, get_file_preview) bound to the FileReferenceRegistry
+     * and registers them as direct tools so they're available to LLMs.
+     */
+    private registerFileTools;
     /** Format memory context for prompt inclusion */
     private formatMemoryContext;
     /** Extract memory context from search results */
@@ -455,6 +465,10 @@ export declare class NeuroLink {
      * @since 1.0.0
      */
     generate(optionsOrPrompt: GenerateOptions | string): Promise<GenerateResult>;
+    /**
+     * Schedule non-blocking Mem0 memory storage after generate completes.
+     */
+    private scheduleGenerateMem0Storage;
     /**
      * Generate with workflow engine integration
      * Returns both original and processed responses for AB testing
@@ -576,6 +590,31 @@ export declare class NeuroLink {
      * @throws {Error} When conversation memory operations fail (if enabled)
      */
     stream(options: StreamOptions): Promise<StreamResult>;
+    /**
+     * Prepare stream options: initialize memory, MCP, Mem0 retrieval, orchestration,
+     * Ollama tool auto-disable, factory processing, and tool detection.
+     */
+    private prepareStreamOptions;
+    /**
+     * Auto-disable tools for Ollama models that don't support them (stream mode).
+     * Prevents overwhelming smaller models with massive tool descriptions in the system message.
+     */
+    private autoDisableOllamaStreamTools;
+    /**
+     * Set up event listeners for stream event capture (tool calls, HITL, UI components).
+     * Returns the shared event sequence array and a cleanup function to remove all listeners.
+     */
+    private setupStreamEventListeners;
+    /**
+     * Handle fallback when the primary stream returns 0 chunks.
+     * Yields chunks from a fallback provider and updates metadata accordingly.
+     */
+    private handleStreamFallback;
+    /**
+     * Store conversation memory after stream consumption is complete (called from finally block).
+     * Handles both conversation memory storage and Mem0 background storage.
+     */
+    private storeStreamConversationMemory;
     /**
      * Validate stream input with comprehensive error reporting
      */
@@ -1259,6 +1298,26 @@ export declare class NeuroLink {
      * @returns The MCPToolRegistry instance
      */
     getToolRegistry(): MCPToolRegistry;
+    /**
+     * Manually trigger context compaction for a session.
+     * Runs the full 4-stage compaction pipeline.
+     */
+    compactSession(sessionId: string, config?: CompactionConfig): Promise<CompactionResult | null>;
+    /**
+     * Get context usage statistics for a session.
+     * Returns token counts, usage ratio, and breakdown by category.
+     */
+    getContextStats(sessionId: string, provider?: string, model?: string): Promise<{
+        estimatedInputTokens: number;
+        availableInputTokens: number;
+        usageRatio: number;
+        shouldCompact: boolean;
+        messageCount: number;
+    } | null>;
+    /**
+     * Check if a session needs compaction.
+     */
+    needsCompaction(sessionId: string, provider?: string, model?: string): boolean;
     /**
      * Get the external server manager instance
      * Used internally by server adapters for external MCP server management