@juspay/neurolink 9.5.3 → 9.7.0

package/dist/lib/types/ragTypes.d.ts

@@ -0,0 +1,489 @@
+/**
+ * RAG Type Definitions
+ *
+ * Canonical type file for all RAG (Retrieval-Augmented Generation) interfaces.
+ * All exported interfaces from src/lib/rag/ are collected here as type aliases.
+ */
+import type { BaseChunkerConfig, BM25Result, Chunk, ChunkingStrategy, DocumentType, ExtractionResult, ExtractParams, HybridSearchConfig, MetadataFilter, RerankResult, RerankerOptions, VectorQueryResult } from "../rag/types.js";
+/**
+ * Citation format options
+ */
+export type CitationFormat = "inline" | "footnote" | "numbered" | "none";
+/**
+ * Chunker type - all chunking strategies implement this
+ */
+export type Chunker = {
+    /** Strategy name for identification */
+    readonly strategy: ChunkingStrategy;
+    /**
+     * Split text into chunks
+     * @param text - The text to chunk
+     * @param config - Strategy-specific configuration
+     * @returns Array of chunks
+     */
+    chunk(text: string, config?: BaseChunkerConfig): Promise<Chunk[]>;
+};
+/**
+ * Context assembly options
+ */
+export type ContextAssemblyOptions = {
+    /** Maximum characters in assembled context */
+    maxChars?: number;
+    /** Maximum tokens (approximate, 4 chars/token) */
+    maxTokens?: number;
+    /** Citation format to use */
+    citationFormat?: CitationFormat;
+    /** Separator between chunks */
+    separator?: string;
+    /** Include chunk metadata in context */
+    includeMetadata?: boolean;
+    /** Deduplicate overlapping content */
+    deduplicate?: boolean;
+    /** Similarity threshold for deduplication (0-1) */
+    dedupeThreshold?: number;
+    /** Order by relevance score */
+    orderByRelevance?: boolean;
+    /** Include section headers */
+    includeSectionHeaders?: boolean;
+    /** Header template (use {index}, {source}, {score} placeholders) */
+    headerTemplate?: string;
+};
+/**
+ * Context window representation
+ */
+export type ContextWindow = {
+    /** Assembled context text */
+    text: string;
+    /** Number of chunks included */
+    chunkCount: number;
+    /** Total character count */
+    charCount: number;
+    /** Estimated token count */
+    tokenCount: number;
+    /** Chunks that were truncated/excluded */
+    truncatedChunks: number;
+    /** Citation map (id -> citation text) */
+    citations: Map<string, string>;
+};
+/**
+ * Supported metadata extractor types
+ */
+export type MetadataExtractorType = "llm" | "title" | "summary" | "keywords" | "questions" | "custom" | "composite";
+/**
+ * Metadata Extractor type - all extractors implement this
+ */
+export type MetadataExtractor = {
+    /** Extractor type identifier */
+    readonly type: MetadataExtractorType;
+    /**
+     * Extract metadata from chunks
+     * @param chunks - Array of chunks to extract metadata from
+     * @param params - Extraction parameters
+     * @returns Array of extraction results
+     */
+    extract(chunks: Chunk[], params?: ExtractParams): Promise<ExtractionResult[]>;
+};
+/**
+ * Metadata extractor configuration
+ */
+export type MetadataExtractorConfig = {
+    /** Extractor type */
+    type: MetadataExtractorType;
+    /** Language model provider */
+    provider?: string;
+    /** Model name for LLM-based extraction */
+    modelName?: string;
+    /** Custom prompt template */
+    promptTemplate?: string;
+    /** Maximum tokens for LLM response */
+    maxTokens?: number;
+    /** Temperature for LLM generation */
+    temperature?: number;
+};
+/**
+ * Metadata extractor metadata for discovery and documentation
+ */
+export type MetadataExtractorMetadata = {
+    /** Human-readable description */
+    description: string;
+    /** Default configuration */
+    defaultConfig: Partial<MetadataExtractorConfig>;
+    /** Supported configuration options */
+    supportedOptions: string[];
+    /** Recommended use cases */
+    useCases: string[];
+    /** Alternative names for this extractor */
+    aliases: string[];
+    /** Whether this extractor requires an AI model */
+    requiresModel: boolean;
+    /** Extraction types this extractor can produce */
+    extractionTypes: string[];
+};
+/**
+ * RAG-specific retry configuration
+ */
+export type RAGRetryConfig = {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries: number;
+    /** Initial delay in ms (default: 1000) */
+    initialDelay: number;
+    /** Maximum delay in ms (default: 30000) */
+    maxDelay: number;
+    /** Backoff multiplier (default: 2) */
+    backoffMultiplier: number;
+    /** Whether to add jitter (default: true) */
+    jitter: boolean;
+    /**
+     * Custom function to determine if error is retryable.
+     *
+     * Note: In `isRetryable()`, this callback is invoked *before* the built-in
+     * abort-error check. If you provide a custom `shouldRetry`, it should
+     * explicitly handle abort errors (e.g. return `false` for them) when
+     * cancellation correctness is required. Otherwise an aborted operation
+     * could be retried instead of propagating immediately.
+     */
+    shouldRetry?: (error: Error) => boolean;
+    /** Retryable error codes */
+    retryableErrorCodes?: string[];
+    /** Retryable HTTP status codes */
+    retryableStatusCodes?: number[];
+};
+/**
+ * Circuit breaker configuration
+ */
+export type RAGCircuitBreakerConfig = {
+    /** Number of failures before opening circuit (default: 5) */
+    failureThreshold: number;
+    /** Time in ms before attempting reset (default: 60000) */
+    resetTimeout: number;
+    /** Max calls allowed in half-open state (default: 3) */
+    halfOpenMaxCalls: number;
+    /** Operation timeout in ms (default: 30000) */
+    operationTimeout: number;
+    /** Minimum calls before calculating failure rate (default: 10) */
+    minimumCallsBeforeCalculation: number;
+    /** Time window for statistics in ms (default: 300000 - 5 minutes) */
+    statisticsWindowSize: number;
+};
+/**
+ * Circuit breaker statistics
+ */
+export type RAGCircuitBreakerStats = {
+    state: CircuitState;
+    totalCalls: number;
+    successfulCalls: number;
+    failedCalls: number;
+    failureRate: number;
+    windowCalls: number;
+    lastStateChange: Date;
+    nextRetryTime?: Date;
+    halfOpenCalls: number;
+    averageLatency: number;
+    p95Latency: number;
+};
+import type { CircuitState } from "../rag/resilience/CircuitBreaker.js";
+/**
+ * Embedding model configuration
+ */
+export type EmbeddingModelConfig = {
+    provider: string;
+    modelName: string;
+};
+/**
+ * Generation model configuration
+ */
+export type GenerationModelConfig = {
+    provider: string;
+    modelName: string;
+    temperature?: number;
+    maxTokens?: number;
+};
+/**
+ * RAG pipeline configuration
+ */
+export type RAGPipelineConfig = {
+    /** Pipeline identifier */
+    id?: string;
+    /** Vector store instance (defaults to in-memory) */
+    vectorStore?: VectorStore;
+    /** BM25 index for hybrid search (defaults to in-memory) */
+    bm25Index?: BM25Index;
+    /** Index name for vector store */
+    indexName?: string;
+    /** Embedding model configuration */
+    embeddingModel: EmbeddingModelConfig;
+    /** Generation model configuration (for RAG responses) */
+    generationModel?: GenerationModelConfig;
+    /** Default chunking strategy */
+    defaultChunkingStrategy?: ChunkingStrategy;
+    /** Default chunk size */
+    defaultChunkSize?: number;
+    /** Default chunk overlap */
+    defaultChunkOverlap?: number;
+    /** Enable hybrid search (vector + BM25) */
+    enableHybridSearch?: boolean;
+    /** Enable Graph RAG */
+    enableGraphRAG?: boolean;
+    /** Graph RAG similarity threshold */
+    graphThreshold?: number;
+    /** Default number of results to retrieve */
+    defaultTopK?: number;
+    /** Enable reranking */
+    enableReranking?: boolean;
+    /** Reranking model configuration */
+    rerankingModel?: EmbeddingModelConfig;
+};
+/**
+ * Ingestion options
+ */
+export type IngestOptions = {
+    /** Chunking strategy override */
+    strategy?: ChunkingStrategy;
+    /** Chunk size override */
+    chunkSize?: number;
+    /** Chunk overlap override */
+    chunkOverlap?: number;
+    /** Custom metadata to add */
+    metadata?: Record<string, unknown>;
+    /** Extract metadata using LLM */
+    extractMetadata?: boolean;
+};
+/**
+ * Query options
+ */
+export type QueryOptions = {
+    /** Number of chunks to retrieve */
+    topK?: number;
+    /** Use hybrid search */
+    hybrid?: boolean;
+    /** Use Graph RAG */
+    graph?: boolean;
+    /** Enable reranking */
+    rerank?: boolean;
+    /** Metadata filter */
+    filter?: Record<string, unknown>;
+    /** Include sources in response */
+    includeSources?: boolean;
+    /** Generate response (vs just retrieve) */
+    generate?: boolean;
+    /** Custom system prompt for generation */
+    systemPrompt?: string;
+    /** Temperature for generation */
+    temperature?: number;
+};
+/**
+ * Query response
+ */
+export type RAGResponse = {
+    /** Generated answer (if generate=true) */
+    answer?: string;
+    /** Retrieved context chunks */
+    context: string;
+    /** Source documents/chunks */
+    sources: Array<{
+        id: string;
+        text: string;
+        score: number;
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Query metadata */
+    metadata: {
+        queryTime: number;
+        retrievalMethod: string;
+        chunksRetrieved: number;
+        reranked: boolean;
+    };
+};
+/**
+ * Pipeline statistics
+ */
+export type PipelineStats = {
+    totalDocuments: number;
+    totalChunks: number;
+    indexName: string;
+    embeddingDimension?: number;
+    hybridSearchEnabled: boolean;
+    graphRAGEnabled: boolean;
+};
+/**
+ * Supported reranker types
+ */
+export type RerankerType = "llm" | "cross-encoder" | "cohere" | "simple" | "batch";
+/**
+ * Reranker type - all rerankers implement this
+ */
+export type Reranker = {
+    /** Reranker type identifier */
+    readonly type: RerankerType;
+    /**
+     * Rerank results based on query relevance
+     * @param results - Vector search results to rerank
+     * @param query - Original search query
+     * @param options - Reranking options
+     * @returns Reranked results with scores
+     */
+    rerank(results: VectorQueryResult[], query: string, options?: RerankerOptions): Promise<RerankResult[]>;
+};
+/**
+ * Reranker configuration
+ */
+export type RerankerConfig = {
+    /** Reranker type */
+    type: RerankerType;
+    /** Model name for LLM-based rerankers */
+    model?: string;
+    /** Provider for the model */
+    provider?: string;
+    /** Number of results to return after reranking */
+    topK?: number;
+    /** Scoring weights */
+    weights?: {
+        semantic?: number;
+        vector?: number;
+        position?: number;
+    };
+    /** API key for external services (e.g., Cohere) */
+    apiKey?: string;
+};
+/**
+ * Reranker metadata for discovery and documentation
+ */
+export type RerankerMetadata = {
+    /** Human-readable description */
+    description: string;
+    /** Default configuration */
+    defaultConfig: Partial<RerankerConfig>;
+    /** Supported configuration options */
+    supportedOptions: string[];
+    /** Recommended use cases */
+    useCases: string[];
+    /** Alternative names for this reranker */
+    aliases: string[];
+    /** Whether this reranker requires an AI model */
+    requiresModel: boolean;
+    /** Whether this reranker requires external API */
+    requiresExternalAPI: boolean;
+};
+/**
+ * BM25 Index type
+ * Implementations should provide sparse retrieval capabilities
+ */
+export type BM25Index = {
+    /**
+     * Search documents using BM25 algorithm
+     * @param query - Search query string
+     * @param topK - Number of results to return
+     * @returns Array of BM25 results
+     */
+    search(query: string, topK?: number): Promise<BM25Result[]>;
+    /**
+     * Add documents to the index
+     * @param documents - Documents to index
+     */
+    addDocuments(documents: Array<{
+        id: string;
+        text: string;
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+};
+/**
+ * Hybrid search configuration for creating a search function
+ */
+export type HybridSearchOptions = {
+    /** Vector store instance */
+    vectorStore: VectorStore;
+    /** BM25 index instance */
+    bm25Index: BM25Index;
+    /** Index name for vector store */
+    indexName: string;
+    /** Embedding model configuration (optional - uses defaults from ProviderFactory if not specified) */
+    embeddingModel?: {
+        provider?: string;
+        modelName?: string;
+    };
+    /** Default search configuration */
+    defaultConfig?: HybridSearchConfig;
+};
+/**
+ * Abstract vector store type
+ * Vector stores should implement this type to work with the query tool
+ */
+export type VectorStore = {
+    query(params: {
+        indexName: string;
+        queryVector: number[];
+        topK?: number;
+        filter?: MetadataFilter;
+        includeVectors?: boolean;
+    }): Promise<VectorQueryResult[]>;
+};
+/**
+ * Document loader options
+ */
+export type LoaderOptions = {
+    /** Custom metadata to add to document */
+    metadata?: Record<string, unknown>;
+    /** Encoding for text files */
+    encoding?: BufferEncoding;
+    /** Document type override */
+    type?: DocumentType;
+};
+/**
+ * Web loader options
+ */
+export type WebLoaderOptions = LoaderOptions & {
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Custom headers for request */
+    headers?: Record<string, string>;
+    /** Extract only main content (remove navigation, ads, etc.) */
+    extractMainContent?: boolean;
+    /** Selector for main content (CSS selector) */
+    contentSelector?: string;
+    /** User agent string */
+    userAgent?: string;
+};
+/**
+ * PDF loader options
+ */
+export type PDFLoaderOptions = LoaderOptions & {
+    /** Page range to extract (e.g., "1-5" or "1,3,5") */
+    pageRange?: string;
+    /** Extract images as base64 */
+    extractImages?: boolean;
+    /** OCR for scanned documents */
+    enableOCR?: boolean;
+    /** Preserve layout formatting */
+    preserveLayout?: boolean;
+};
+/**
+ * CSV loader options
+ */
+export type CSVLoaderOptions = LoaderOptions & {
+    /** Delimiter character */
+    delimiter?: string;
+    /** Whether first row is header */
+    hasHeader?: boolean;
+    /** Column names (if no header) */
+    columns?: string[];
+    /** Output format */
+    outputFormat?: "text" | "json" | "markdown";
+};
+/**
+ * Abstract document loader type
+ */
+export type DocumentLoader = {
+    /**
+     * Load document from source
+     * @param source - File path, URL, or content
+     * @param options - Loader options
+     * @returns Promise resolving to MDocument
+     */
+    load(source: string, options?: LoaderOptions): Promise<import("../rag/document/MDocument.js").MDocument>;
+    /**
+     * Check if loader can handle the source
+     * @param source - File path, URL, or content
+     * @returns True if loader can handle the source
+     */
+    canHandle(source: string): boolean;
+};

package/dist/lib/types/ragTypes.js

@@ -0,0 +1,8 @@
+/**
+ * RAG Type Definitions
+ *
+ * Canonical type file for all RAG (Retrieval-Augmented Generation) interfaces.
+ * All exported interfaces from src/lib/rag/ are collected here as type aliases.
+ */
+export {};
+//# sourceMappingURL=ragTypes.js.map

package/dist/lib/types/sdkTypes.d.ts

@@ -5,21 +5,20 @@
  * when integrating with the NeuroLink SDK. Maximum type exposure for
  * comprehensive TypeScript support across the NeuroLink ecosystem.
  */
-export type { StreamResult, StreamingProgressData, StreamingMetadata, ProgressCallback, ToolCall as StreamToolCall, // Note: Renamed in main index to avoid conflict with tools.js ToolCall
-ToolResult as StreamToolResult, // Note: Renamed in main index to avoid conflict with tools.js ToolResult
-ToolCallResults, ToolCalls, StreamOptions, StreamingOptions, EnhancedStreamProvider, StreamTextResult, AISDKUsage, StreamAnalyticsCollector, ResponseMetadata, AudioInputSpec, AudioChunk, PCMEncoding, } from "./streamTypes.js";
-export type { TypedEventEmitter, NeuroLinkEvents, StreamEvent, AsyncFunction, SyncFunction, AnyFunction, } from "./common.js";
-export type { NeuroLinkConfig, ProviderConfig, PerformanceConfig, CacheConfig, FallbackConfig, RetryConfig, AnalyticsConfig, ToolConfig, BackupInfo, BackupMetadata, ConfigValidationResult, ConfigUpdateOptions, } from "./configTypes.js";
-export type { AISDKModel, ProviderError, AIModelProviderConfig, ProviderName, ModelCapability, ModelUseCase, ModelFilter, ModelResolutionContext, ModelStats, ModelPricing, ProviderCapabilities, } from "./providers.js";
-export type { GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
-UnifiedGenerationOptions, EnhancedProvider, FactoryEnhancedProvider, TextGenerationOptions, TextGenerationResult, EnhancedGenerateResult, } from "./generateTypes.js";
-export type { TokenUsage, AnalyticsData } from "./analytics.js";
-export type { TextContent, ImageContent, Content, VisionCapability, ProviderImageFormat, ProcessedImage, MultimodalMessage, ProviderMultimodalPayload, } from "./content.js";
-export type { MCPTransportType, MCPServerConnectionStatus, MCPServerCategory, MCPServerStatus, MCPDiscoveredServer, MCPConnectedServer, MCPToolInfo, MCPExecutableTool, MCPServerMetadata, MCPToolMetadata, MCPServerRegistryEntry, } from "./mcpTypes.js";
-export type { ExternalMCPServerInstance, ExternalMCPServerStatus, ExternalMCPToolInfo, ExternalMCPServerHealth, ExternalMCPConfigValidation, ExternalMCPOperationResult, ExternalMCPToolContext, ExternalMCPToolResult, ExternalMCPServerEvents, ExternalMCPManagerConfig, } from "./externalMcp.js";
-export type { BaseCommandArgs, GenerateCommandArgs, MCPCommandArgs, ModelsCommandArgs, CommandResult, GenerateResult as CLIGenerateResult, StreamChunk, } from "./cli.js";
-export type { Unknown, UnknownRecord, UnknownArray, JsonValue, JsonObject, JsonArray, ErrorInfo, Result, FunctionParameters, } from "./common.js";
-export type { EvaluationData, EvaluationContext, EnhancedEvaluationResult, EvaluationRequest, EvaluationCriteria, } from "./evaluation.js";
-export type { TaskType, TaskClassification, ClassificationScores, ClassificationStats, ClassificationValidation, } from "./taskClassificationTypes.js";
-export type { DomainType, DomainConfig, DomainTemplate, DomainConfigOptions, DomainEvaluationCriteria, DomainValidationRule, } from "./domainTypes.js";
-export type { ConversationMemoryConfig, SessionMemory, ChatMessage, MessageContent, MultimodalChatMessage, ConversationMemoryEvents, ConversationMemoryError, SessionIdentifier, SessionMetadata, RedisConversationObject, RedisStorageConfig, StoreConversationTurnOptions, } from "./conversation.js";
+export type { AnyFunction, AsyncFunction, NeuroLinkEvents, StreamEvent, SyncFunction, TypedEventEmitter, } from "./common.js";
+export type { AnalyticsConfig, BackupInfo, BackupMetadata, CacheConfig, ConfigUpdateOptions, ConfigValidationResult, FallbackConfig, NeuroLinkConfig, PerformanceConfig, ProviderConfig, RetryConfig, ToolConfig, } from "./configTypes.js";
+export type { AISDKUsage, AudioChunk, AudioInputSpec, EnhancedStreamProvider, PCMEncoding, ProgressCallback, ResponseMetadata, StreamAnalyticsCollector, StreamingMetadata, StreamingOptions, StreamingProgressData, StreamOptions, StreamResult, StreamTextResult, ToolCall as StreamToolCall, // Note: Renamed in main index to avoid conflict with tools.js ToolCall
+ToolCallResults, ToolCalls, ToolResult as StreamToolResult, } from "./streamTypes.js";
+export type { AnalyticsData, TokenUsage } from "./analytics.js";
+export type { BaseCommandArgs, CommandResult, GenerateCommandArgs, GenerateResult as CLIGenerateResult, MCPCommandArgs, ModelsCommandArgs, StreamChunk, } from "./cli.js";
+export type { ErrorInfo, FunctionParameters, JsonArray, JsonObject, JsonValue, ProcessResult, Result, TestFunction, TestResult, Unknown, UnknownArray, UnknownRecord, } from "./common.js";
+export type { Content, ImageContent, MultimodalMessage, ProcessedImage, ProviderImageFormat, ProviderMultimodalPayload, TextContent, VisionCapability, } from "./content.js";
+export type { ChatMessage, ConversationMemoryConfig, ConversationMemoryError, ConversationMemoryEvents, MessageContent, MultimodalChatMessage, RedisConversationObject, RedisStorageConfig, SessionIdentifier, SessionMemory, SessionMetadata, StoreConversationTurnOptions, } from "./conversation.js";
+export type { DomainConfig, DomainConfigOptions, DomainEvaluationCriteria, DomainTemplate, DomainType, DomainValidationRule, } from "./domainTypes.js";
+export type { EnhancedEvaluationResult, EvaluationContext, EvaluationCriteria, EvaluationData, EvaluationRequest, } from "./evaluation.js";
+export type { ExternalMCPConfigValidation, ExternalMCPManagerConfig, ExternalMCPOperationResult, ExternalMCPServerEvents, ExternalMCPServerHealth, ExternalMCPServerInstance, ExternalMCPServerStatus, ExternalMCPToolContext, ExternalMCPToolInfo, ExternalMCPToolResult, } from "./externalMcp.js";
+export type { EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
+TextGenerationOptions, TextGenerationResult, UnifiedGenerationOptions, } from "./generateTypes.js";
+export type { MCPConnectedServer, MCPDiscoveredServer, MCPExecutableTool, MCPServerCategory, MCPServerConnectionStatus, MCPServerMetadata, MCPServerRegistryEntry, MCPServerStatus, MCPToolInfo, MCPToolMetadata, MCPTransportType, } from "./mcpTypes.js";
+export type { AIModelProviderConfig, AISDKModel, ModelCapability, ModelFilter, ModelPricing, ModelResolutionContext, ModelStats, ModelUseCase, ProviderCapabilities, ProviderError, ProviderName, } from "./providers.js";
+export type { ClassificationScores, ClassificationStats, ClassificationValidation, TaskClassification, TaskType, } from "./taskClassificationTypes.js";

package/dist/lib/types/streamTypes.d.ts

@@ -202,7 +202,7 @@ export type StreamOptions = {
         csvFiles?: Array<Buffer | string>;
         pdfFiles?: Array<Buffer | string>;
         videoFiles?: Array<Buffer | string>;
-        files?: Array<Buffer | string>;
+        files?: Array<Buffer | string | import("./fileTypes.js").FileWithMetadata>;
         content?: Content[];
     };
     output?: {
@@ -321,8 +321,21 @@ export type StreamOptions = {
     schema?: ValidationSchema;
     tools?: Record<string, Tool>;
     timeout?: number | string;
+    /** AbortSignal for external cancellation of the AI call */
+    abortSignal?: AbortSignal;
     disableTools?: boolean;
     maxSteps?: number;
+    /** Include only these tools by name (whitelist). If set, only matching tools are available. */
+    toolFilter?: string[];
+    /** Exclude these tools by name (blacklist). Applied after toolFilter. */
+    excludeTools?: string[];
+    /**
+     * Skip injecting tool schemas into the system prompt.
+     * When true, tools are ONLY passed natively via the provider's `tools` parameter,
+     * avoiding duplicate tool definitions (~30K tokens savings per call).
+     * Default: false (backward compatible — tool schemas are injected into system prompt).
+     */
+    skipToolPromptInjection?: boolean;
     enableEvaluation?: boolean;
     enableAnalytics?: boolean;
     context?: UnknownRecord;
@@ -370,6 +383,16 @@ export type StreamOptions = {
      * ```
      */
     rag?: RAGConfig;
+    /**
+     * File reference registry for on-demand file processing (internal).
+     *
+     * When set, files above the "tiny" size tier (>10KB) will be registered
+     * as lightweight references instead of being fully loaded into the prompt.
+     * The LLM can then access file content on-demand via file tools.
+     *
+     * @internal Set by NeuroLink SDK — not typically used directly by consumers.
+     */
+    fileRegistry?: unknown;
 };
 /**
  * Stream function result type - Primary output format for streaming

package/dist/lib/utils/async/retry.d.ts

@@ -6,7 +6,7 @@
 /**
  * Configuration options for retry operations.
  */
-export interface RetryOptions {
+export type RetryOptions = {
     /**
      * Maximum number of retry attempts (not including the initial attempt).
      * @default 3
@@ -37,7 +37,7 @@ export interface RetryOptions {
      * Useful for logging or metrics.
      */
     onRetry?: (error: Error, attempt: number, delayMs: number) => void;
-}
+};
 /**
  * Default retry configuration.
  */

package/dist/lib/utils/async/withTimeout.js

@@ -67,7 +67,9 @@ export async function withTimeout(promise, ms, message) {
         return await Promise.race([promise, timeoutPromise]);
     }
     finally {
-        clearTimeout(timeoutId);
+        if (timeoutId !== undefined) {
+            clearTimeout(timeoutId);
+        }
     }
 }
 /**

package/dist/lib/utils/conversationMemory.d.ts

@@ -2,9 +2,9 @@
  * Conversation Memory Utilities
  * Handles configuration merging and conversation memory operations
  */
-import type { ConversationMemoryConfig, ChatMessage, SessionMemory } from "../types/conversation.js";
 import type { ConversationMemoryManager } from "../core/conversationMemoryManager.js";
 import type { RedisConversationMemoryManager } from "../core/redisConversationMemoryManager.js";
+import type { ChatMessage, ConversationMemoryConfig, SessionMemory } from "../types/conversation.js";
 import type { TextGenerationOptions, TextGenerationResult } from "../types/generateTypes.js";
 /**
  * Apply conversation memory defaults to user configuration
@@ -35,13 +35,14 @@ export declare function buildContextFromPointer(session: SessionMemory): ChatMes
  */
 export declare function createSummarizationPrompt(history: ChatMessage[], previousSummary?: string): string;
 /**
- * Calculate token threshold based on model's output token limit
- * Uses existing provider token limits as proxy for context window
+ * Calculate token threshold based on model's context window and available input tokens
+ * Uses context window registry for accurate per-provider, per-model limits
  * @param provider - AI provider name
  * @param model - Model name
- * @returns Token threshold (80% of model's token limit)
+ * @param maxTokens - Optional explicit maxTokens for output reserve calculation
+ * @returns Token threshold (80% of available input tokens)
  */
-export declare function calculateTokenThreshold(provider: string, model: string): number;
+export declare function calculateTokenThreshold(provider?: string, model?: string, maxTokens?: number): number;
 /**
  * Get effective token threshold for a session
  * Priority: session override > env var > model-based (80%) > fallback
@@ -61,4 +62,9 @@ export declare function getEffectiveTokenThreshold(provider: string, model: stri
  * @param logPrefix - Prefix for log messages (e.g., "[ConversationMemory]" or "[RedisConversationMemoryManager]")
  * @returns Summary text or null if generation fails
  */
-export declare function generateSummary(messages: ChatMessage[], config: ConversationMemoryConfig, logPrefix?: string, previousSummary?: string): Promise<string | null>;
+export declare function generateSummary(messages: ChatMessage[], config: Partial<ConversationMemoryConfig>, logPrefix?: string, previousSummary?: string): Promise<string | null>;
+/**
+ * Check if Redis is available for conversation memory.
+ * Migrated from the deprecated conversationMemoryUtils.ts.
+ */
+export declare function checkRedisAvailability(): Promise<boolean>;