@juspay/neurolink 9.54.2 → 9.54.4

package/dist/lib/mcp/toolConverter.d.ts

@@ -8,98 +8,7 @@
  * @module mcp/toolConverter
  * @since 8.39.0
  */
-import type { JsonObject, JsonValue } from "../types/common.js";
-import type { NeuroLinkExecutionContext, ToolResult } from "../types/mcpTypes.js";
-import type { MCPServerTool, MCPToolAnnotations } from "./toolAnnotations.js";
-/**
- * NeuroLink internal tool format
- */
-export type NeuroLinkTool = {
-    /**
-     * Tool name
-     */
-    name: string;
-    /**
-     * Tool description
-     */
-    description: string;
-    /**
-     * Input parameters schema
-     */
-    parameters?: JsonObject;
-    /**
-     * Tool execution function
-     */
-    execute: (params: unknown, context?: NeuroLinkExecutionContext) => Promise<ToolResult | unknown>;
-    /**
-     * Category for organization
-     */
-    category?: string;
-    /**
-     * Tags for filtering
-     */
-    tags?: string[];
-    /**
-     * Whether the tool is async
-     */
-    isAsync?: boolean;
-    /**
-     * Custom metadata
-     */
-    metadata?: Record<string, JsonValue>;
-};
-/**
- * MCP protocol tool format (from @modelcontextprotocol/sdk)
- */
-export type MCPProtocolTool = {
-    /**
-     * Tool name
-     */
-    name: string;
-    /**
-     * Tool description
-     */
-    description?: string;
-    /**
-     * JSON Schema for input
-     */
-    inputSchema: {
-        type: "object";
-        properties?: Record<string, JsonObject>;
-        required?: string[];
-    };
-    /**
-     * Optional annotations (MCP 2024-11-05+)
-     */
-    annotations?: {
-        title?: string;
-        readOnlyHint?: boolean;
-        destructiveHint?: boolean;
-        idempotentHint?: boolean;
-        openWorldHint?: boolean;
-    };
-};
-/**
- * Tool converter options
- */
-export type ToolConverterOptions = {
-    /**
-     * Automatically infer annotations from tool definition
-     */
-    inferAnnotations?: boolean;
-    /**
-     * Default annotations to apply
-     */
-    defaultAnnotations?: MCPToolAnnotations;
-    /**
-     * Whether to preserve original metadata
-     */
-    preserveMetadata?: boolean;
-    /**
-     * Namespace prefix for tool names
-     */
-    namespacePrefix?: string;
-};
+import type { JsonObject, MCPServerTool, MCPToolAnnotations, NeuroLinkExecutionContext, ToolResult, MCPProtocolTool, NeuroLinkTool, ToolConverterOptions } from "../types/index.js";
 /**
  * Convert NeuroLink tool to MCP server tool format
  */

package/dist/lib/mcp/toolDiscoveryService.d.ts

@@ -5,9 +5,7 @@
  */
 import { EventEmitter } from "events";
 import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import type { ExternalMCPToolInfo, ExternalMCPToolResult } from "../types/externalMcp.js";
-import type { ToolDiscoveryResult, ExternalToolExecutionOptions } from "../types/mcpTypes.js";
-import type { JsonObject } from "../types/common.js";
+import type { ExternalMCPToolInfo, ExternalMCPToolResult, ToolDiscoveryResult, ExternalToolExecutionOptions, JsonObject } from "../types/index.js";
 import type { McpOutputNormalizer } from "./mcpOutputNormalizer.js";
 /**
  * ToolDiscoveryService

package/dist/lib/mcp/toolIntegration.d.ts

@@ -7,48 +7,8 @@
  * @module mcp/toolIntegration
  * @since 8.39.0
  */
-import type { NeuroLinkExecutionContext, ToolResult } from "../types/mcpTypes.js";
-import type { MCPServerTool, MCPToolAnnotations } from "./toolAnnotations.js";
-import type { ElicitationContext, ElicitationHandler } from "./elicitation/types.js";
+import type { NeuroLinkExecutionContext, MCPServerTool, ToolResult, ToolMiddleware, ToolWrapperOptions, ElicitationContext, ElicitationHandler } from "../types/index.js";
 import { ElicitationManager } from "./elicitation/elicitationManager.js";
-/**
- * Tool execution context with elicitation support
- */
-export type EnhancedExecutionContext = NeuroLinkExecutionContext & {
-    /**
-     * Elicitation context for interactive input
-     */
-    elicitation: ElicitationContext;
-    /**
-     * Tool metadata
-     */
-    toolMeta: {
-        name: string;
-        serverId?: string;
-        annotations?: MCPToolAnnotations;
-    };
-};
-/**
- * Tool wrapper options
- */
-export type ToolWrapperOptions = {
-    /**
-     * Elicitation manager to use
-     */
-    elicitationManager?: ElicitationManager;
-    /**
-     * Auto-confirm destructive operations
-     */
-    autoConfirmDestructive?: boolean;
-    /**
-     * Default timeout for elicitations
-     */
-    elicitationTimeout?: number;
-    /**
-     * Enable logging
-     */
-    enableLogging?: boolean;
-};
 /**
  * Create elicitation context for a tool
  */
@@ -61,10 +21,6 @@ export declare function wrapToolWithElicitation(tool: MCPServerTool, options?: T
  * Batch wrap tools with elicitation support
  */
 export declare function wrapToolsWithElicitation(tools: MCPServerTool[], options?: ToolWrapperOptions): MCPServerTool[];
-/**
- * Tool execution middleware
- */
-export type ToolMiddleware = (tool: MCPServerTool, params: unknown, context: EnhancedExecutionContext, next: () => Promise<ToolResult | unknown>) => Promise<ToolResult | unknown>;
 /**
  * Create a middleware chain for tool execution
  */

package/dist/lib/mcp/toolRegistry.d.ts

@@ -2,10 +2,8 @@
  * MCP Tool Registry - Extended Registry with Tool Management
  * Updated to match industry standard camelCase interfaces
  */
-import type { MCPServerInfo } from "../types/mcpTypes.js";
-import type { ToolImplementation, ToolInfo, ExecutionContext } from "../types/tools.js";
+import type { MCPServerInfo, ToolImplementation, ToolInfo, ExecutionContext, HITLManager } from "../types/index.js";
 import { MCPRegistry } from "./registry.js";
-import type { HITLManager } from "../types/hitlTypes.js";
 export declare class MCPToolRegistry extends MCPRegistry {
     private tools;
     private toolImplementations;

package/dist/lib/memory/hippocampusInitializer.d.ts

@@ -1,6 +1,3 @@
 import { Hippocampus, type HippocampusConfig, type StorageConfig } from "@juspay/hippocampus";
 export type { HippocampusConfig, StorageConfig };
-export type Memory = HippocampusConfig & {
-    enabled?: boolean;
-};
 export declare function initializeHippocampus(config: HippocampusConfig): Hippocampus | null;

package/dist/lib/memory/memoryRetrievalTools.d.ts

@@ -7,7 +7,7 @@
  * @module
  */
 import type { RedisConversationMemoryManager } from "../core/redisConversationMemoryManager.js";
-import type { ArtifactStore } from "../artifacts/artifactStore.js";
+import type { ArtifactStore } from "../types/index.js";
 /**
  * Factory function that creates memory retrieval tools bound to a memory manager.
  *

package/dist/lib/memory/memoryRetrievalTools.js

@@ -10,8 +10,7 @@ import { tool } from "ai";
 import { z } from "zod";
 import { logger } from "../utils/logger.js";
 import { withTimeout } from "../utils/errorHandling.js";
-import { SpanSerializer, SpanType, SpanStatus, } from "../observability/index.js";
-import { getMetricsAggregator } from "../observability/index.js";
+import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../observability/index.js";
 /** Maximum characters returned per retrieval request */
 const DEFAULT_RETRIEVAL_LIMIT = 50_000;
 /** Hard maximum for user/LLM-supplied limit to prevent massive tool outputs */

package/dist/lib/middleware/builtin/analytics.d.ts

@@ -1,4 +1,4 @@
-import type { NeuroLinkMiddleware } from "../../types/middlewareTypes.js";
+import type { NeuroLinkMiddleware } from "../../types/index.js";
 /**
  * Create analytics middleware for tracking AI model usage
  * Collects metrics on token usage, response times, and model performance

package/dist/lib/middleware/builtin/autoEvaluation.d.ts

@@ -1,7 +1,7 @@
 /**
  * @file Implements the Auto-Evaluation Middleware for ensuring response quality.
  */
-import type { NeuroLinkMiddleware, AutoEvaluationConfig } from "../../types/middlewareTypes.js";
+import type { NeuroLinkMiddleware, AutoEvaluationConfig } from "../../types/index.js";
 /**
  * Creates the Auto-Evaluation middleware, which intercepts generation requests
  * to evaluate the quality of the response. If the response quality is below a

package/dist/lib/middleware/builtin/guardrails.d.ts

@@ -1,5 +1,4 @@
-import type { NeuroLinkMiddleware } from "../../types/middlewareTypes.js";
-import type { GuardrailsMiddlewareConfig } from "../../types/guardrails.js";
+import type { NeuroLinkMiddleware, GuardrailsMiddlewareConfig } from "../../types/index.js";
 /**
  * Create Guardrails AI middleware for content filtering and policy enforcement
  * @param config Configuration for the guardrails middleware

package/dist/lib/middleware/builtin/lifecycle.d.ts

@@ -7,5 +7,5 @@
  * This middleware is automatically enabled when lifecycle callbacks
  * (onFinish, onError, onChunk) are passed in GenerateOptions or StreamOptions.
  */
-import type { NeuroLinkMiddleware, LifecycleMiddlewareConfig } from "../../types/middlewareTypes.js";
+import type { NeuroLinkMiddleware, LifecycleMiddlewareConfig } from "../../types/index.js";
 export declare function createLifecycleMiddleware(config?: LifecycleMiddlewareConfig): NeuroLinkMiddleware;

package/dist/lib/middleware/factory.d.ts

@@ -1,5 +1,5 @@
 import type { LanguageModel } from "ai";
-import type { MiddlewareContext, MiddlewareConfig, MiddlewareFactoryOptions, MiddlewareChainStats, MiddlewarePreset, NeuroLinkMiddleware, MiddlewareRegistrationOptions } from "../types/middlewareTypes.js";
+import type { MiddlewareContext, MiddlewareConfig, MiddlewareFactoryOptions, MiddlewareChainStats, MiddlewarePreset, NeuroLinkMiddleware, MiddlewareRegistrationOptions } from "../types/index.js";
 import { MiddlewareRegistry } from "./registry.js";
 /**
  * Middleware factory for creating and applying middleware chains.

package/dist/lib/middleware/index.d.ts

@@ -6,8 +6,6 @@
  * of language models with features like analytics, guardrails, caching, and more.
  */
 import { MiddlewareFactory } from "./factory.js";
-export type { NeuroLinkMiddleware, MiddlewareConfig, MiddlewareContext, MiddlewareConditions, MiddlewareRegistrationOptions, MiddlewareExecutionResult, MiddlewareChainStats, MiddlewarePreset, MiddlewareFactoryOptions, BuiltInMiddlewareType, } from "../types/middlewareTypes.js";
-export type { LanguageModelMiddleware } from "ai";
 export { MiddlewareFactory };
 export { createLifecycleMiddleware } from "./builtin/lifecycle.js";
 export default MiddlewareFactory;

package/dist/lib/middleware/index.js

@@ -7,6 +7,7 @@
  */
 // Import types and classes
 import { MiddlewareFactory } from "./factory.js";
+// Core types and interfaces
 // Factory for creating and applying middleware chains
 export { MiddlewareFactory };
 // Built-in middleware creators

package/dist/lib/middleware/registry.d.ts

@@ -1,5 +1,5 @@
 import type { LanguageModelMiddleware } from "ai";
-import type { NeuroLinkMiddleware, MiddlewareConfig, MiddlewareContext, MiddlewareRegistrationOptions, MiddlewareExecutionResult } from "../types/middlewareTypes.js";
+import type { NeuroLinkMiddleware, MiddlewareConfig, MiddlewareContext, MiddlewareRegistrationOptions, MiddlewareExecutionResult } from "../types/index.js";
 /**
  * Manages the registration, configuration, and execution of middleware for a single factory instance.
  */

package/dist/lib/middleware/utils/guardrailsUtils.d.ts

@@ -1,4 +1,4 @@
-import type { BadWordsConfig, ContentFilteringResult, EvaluationActionResult, PrecallEvaluationConfig, PrecallEvaluationResult } from "../../types/guardrails.js";
+import type { BadWordsConfig, ContentFilteringResult, EvaluationActionResult, PrecallEvaluationConfig, PrecallEvaluationResult } from "../../types/index.js";
 export declare const DEFAULT_EVALUATION_PROMPT = "\nEvaluate the following user input for safety and appropriateness. Respond ONLY with valid JSON:\n\n{\n  \"overall\": \"safe|unsafe|suspicious|inappropriate\",\n  \"safetyScore\": <1-10>,\n  \"appropriatenessScore\": <1-10>,\n  \"confidenceLevel\": <1-10>,\n  \"issues\": [\n    {\n      \"category\": \"explicit_content|hate_speech|violence|personal_info|spam|other\",\n      \"severity\": \"low|medium|high|critical\",\n      \"description\": \"Brief description\"\n    }\n  ],\n  \"suggestedAction\": \"allow|block|sanitize|warn\",\n  \"reasoning\": \"Brief explanation\"\n}\n\nUser Input: \"{USER_INPUT}\"\n";
 /**
  * Extract user input from middleware params

package/dist/lib/models/anthropicModels.d.ts

@@ -4,8 +4,8 @@
  * This module defines Anthropic Claude models, their availability by subscription tier,
  * model capabilities, and provides helper functions for tier-based access control.
  */
-import type { ClaudeSubscriptionTier, AnthropicModelMetadata } from "../types/subscriptionTypes.js";
-import { ModelAccessError } from "../types/errors.js";
+import type { ClaudeSubscriptionTier, AnthropicModelMetadata } from "../types/index.js";
+import { ModelAccessError } from "../types/index.js";
 export type { ClaudeSubscriptionTier, AnthropicModelMetadata };
 export { ModelAccessError };
 /**

package/dist/lib/models/anthropicModels.js

@@ -4,7 +4,7 @@
  * This module defines Anthropic Claude models, their availability by subscription tier,
  * model capabilities, and provides helper functions for tier-based access control.
  */
-import { ModelAccessError } from "../types/errors.js";
+import { ModelAccessError } from "../types/index.js";
 export { ModelAccessError };
 // ============================================================================
 // ANTHROPIC MODEL ENUM

package/dist/lib/models/modelRegistry.d.ts

@@ -4,8 +4,7 @@
  * Part of Phase 4.1 - Models Command System
  */
 import { AIProviderName } from "../constants/enums.js";
-import type { JsonValue } from "../types/common.js";
-import type { ModelInfo } from "../types/modelTypes.js";
+import type { JsonValue, ModelInfo } from "../types/index.js";
 /**
  * Comprehensive model registry
  */

package/dist/lib/models/modelRegistry.js

@@ -3,7 +3,7 @@
  * Provides centralized model data for models command system
  * Part of Phase 4.1 - Models Command System
  */
-import { DEFAULT_MODEL_ALIASES } from "../types/providers.js";
+import { DEFAULT_MODEL_ALIASES } from "../types/index.js";
 import { AIProviderName, OpenAIModels, AzureOpenAIModels, GoogleAIModels, AnthropicModels, BedrockModels, MistralModels, OllamaModels, } from "../constants/enums.js";
 /**
  * Comprehensive model registry

package/dist/lib/models/modelResolver.d.ts

@@ -3,8 +3,7 @@
  * Provides model resolution, search, and recommendation functionality
  * Part of Phase 4.1 - Models Command System
  */
-import type { JsonValue } from "../types/common.js";
-import type { ModelComparison, ModelInfo, ModelRecommendation, ModelSearchFilters, ModelSearchResult, RecommendationContext } from "../types/modelTypes.js";
+import type { JsonValue, ModelComparison, ModelInfo, ModelRecommendation, ModelSearchFilters, ModelSearchResult, RecommendationContext } from "../types/index.js";
 /**
  * Model resolver class with advanced search and recommendation functionality
  */

package/dist/lib/neurolink.d.ts

@@ -5,27 +5,12 @@
  * Enhanced AI provider system with natural MCP tool access.
  * Uses real MCP infrastructure for tool discovery and execution.
  */
-import { type CompactionConfig, type CompactionResult } from "./context/contextCompactor.js";
+import type { CompactionConfig, CompactionResult, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, MastraAuthProvider, JsonObject, NeuroLinkEvents, TypedEventEmitter, MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig, ChatMessage, ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo, GenerateOptions, GenerateResult, ProviderStatus, TextGenerationOptions, TextGenerationResult, MCPExecutableTool, MCPServerInfo, MCPStatus, StreamOptions, StreamResult, ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions, BatchOperationResult } from "./types/index.js";
 import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
 import type { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
 import { ExternalServerManager } from "./mcp/externalServerManager.js";
-import type { MCPToolAnnotations } from "./mcp/toolAnnotations.js";
 import { MCPToolRegistry } from "./mcp/toolRegistry.js";
-import type { MetricsSummary, TraceView } from "./observability/metricsAggregator.js";
-import type { SpanData } from "./observability/types/spanTypes.js";
 import { TaskManager } from "./tasks/taskManager.js";
-import type { AuthenticatedContext, MastraAuthProvider } from "./types/authTypes.js";
-import type { JsonObject, NeuroLinkEvents, TypedEventEmitter } from "./types/common.js";
-import type { MCPEnhancementsConfig, NeuroLinkAuthConfig, 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, 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";
-import type { ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions } from "./types/tools.js";
-import type { BatchOperationResult } from "./types/typeAliases.js";
 export declare class NeuroLink {
     private mcpInitialized;
     private mcpSkipped;
@@ -1017,11 +1002,11 @@ export declare class NeuroLink {
      * @param middleware - The middleware function to register
      * @returns this (for chaining)
      */
-    useToolMiddleware(middleware: import("./mcp/toolIntegration.js").ToolMiddleware): this;
+    useToolMiddleware(middleware: import("./types/index.js").ToolMiddleware): this;
     /**
      * Get all registered tool middlewares
      */
-    getToolMiddlewares(): import("./mcp/toolIntegration.js").ToolMiddleware[];
+    getToolMiddlewares(): import("./types/index.js").ToolMiddleware[];
     /**
      * Flush any pending batched tool calls immediately
      */
@@ -1049,7 +1034,7 @@ export declare class NeuroLink {
      * });
      * ```
      */
-    updateAgenticLoopReport(sessionId: string, report: import("./types/conversation.js").AgenticLoopReportMetadata, userId?: string): Promise<void>;
+    updateAgenticLoopReport(sessionId: string, report: import("./types/index.js").AgenticLoopReportMetadata, userId?: string): Promise<void>;
     /**
      * Get all registered custom tools
      * @returns Map of tool names to MCPExecutableTool format
@@ -1278,7 +1263,7 @@ export declare class NeuroLink {
      * Models in the alias map will be warned, redirected, or blocked based on their action.
      * @param config - Model alias configuration with aliases map
      */
-    setModelAliasConfig(config: import("./types/generateTypes.js").ModelAliasConfig): void;
+    setModelAliasConfig(config: import("./types/index.js").ModelAliasConfig): void;
     /**
      * Get circuit breaker status for all tools
      * @returns Object with circuit breaker status for each tool
@@ -1592,7 +1577,7 @@ export declare class NeuroLink {
         wrapWithContext?: boolean;
         executionTimeout?: number;
         enableLogging?: boolean;
-    }): Promise<import("./mcp/agentExposure.js").ExposureResult>;
+    }): Promise<import("./types/mcp.js").ExposureResult>;
     /**
      * Expose a workflow as an MCP tool
      * This allows workflows to be called by other systems via MCP
@@ -1628,7 +1613,7 @@ export declare class NeuroLink {
         wrapWithContext?: boolean;
         executionTimeout?: number;
         enableLogging?: boolean;
-    }): Promise<import("./mcp/agentExposure.js").ExposureResult>;
+    }): Promise<import("./types/mcp.js").ExposureResult>;
     /**
      * Get the tool integration manager for middleware and elicitation
      * Provides advanced tool wrapping with confirmation, timeout, retry, etc.
@@ -1761,7 +1746,7 @@ export declare class NeuroLink {
      * });
      * ```
      */
-    createEvaluationPipeline(configOrPreset: import("./types/scorerTypes.js").PipelineConfig | "safety" | "rag" | "quality" | "comprehensive" | "minimal" | "summarization" | "customerSupport" | "codeGeneration"): Promise<import("./evaluation/pipeline/evaluationPipeline.js").EvaluationPipeline>;
+    createEvaluationPipeline(configOrPreset: import("./types/index.js").PipelineConfig | "safety" | "rag" | "quality" | "comprehensive" | "minimal" | "summarization" | "customerSupport" | "codeGeneration"): Promise<import("./evaluation/pipeline/evaluationPipeline.js").EvaluationPipeline>;
     /**
      * Evaluate an AI response using the specified pipeline or scorers.
      * This is a convenience method that creates a pipeline and executes it in one call.
@@ -1808,7 +1793,7 @@ export declare class NeuroLink {
      * );
      * ```
      */
-    evaluate(input: import("./types/scorerTypes.js").ScorerInput, options?: {
+    evaluate(input: import("./types/index.js").ScorerInput, options?: {
         /** Pipeline preset to use */
         pipeline?: "safety" | "rag" | "quality" | "comprehensive" | "minimal" | "summarization" | "customerSupport" | "codeGeneration";
         /** Specific scorers to use (alternative to pipeline) */
@@ -1821,7 +1806,7 @@ export declare class NeuroLink {
         correlationId?: string;
         /** Overall evaluation timeout in milliseconds */
         timeoutMs?: number;
-    }): Promise<import("./evaluation/pipeline/evaluationPipeline.js").PipelineResult>;
+    }): Promise<import("./types/index.js").PipelineResult>;
     /**
      * Score a response using a single scorer.
      * Useful for quick, targeted evaluations without the overhead of a full pipeline.
@@ -1864,7 +1849,7 @@ export declare class NeuroLink {
      * );
      * ```
      */
-    score(scorerId: string, input: import("./types/scorerTypes.js").ScorerInput, config?: import("./types/scorerTypes.js").ScorerConfig): Promise<import("./types/scorerTypes.js").ScoreResult>;
+    score(scorerId: string, input: import("./types/index.js").ScorerInput, config?: import("./types/index.js").ScorerConfig): Promise<import("./types/index.js").ScoreResult>;
     /**
      * Get a list of all available scorers and their metadata.
      * Useful for discovering what evaluation capabilities are available.
@@ -1898,10 +1883,10 @@ export declare class NeuroLink {
      */
     getAvailableScorers(options?: {
         /** Filter by category */
-        category?: import("./types/scorerTypes.js").ScorerCategory;
+        category?: import("./types/index.js").ScorerCategory;
         /** Filter by type */
-        type?: import("./types/scorerTypes.js").ScorerType;
-    }): Promise<import("./types/scorerTypes.js").ScorerMetadata[]>;
+        type?: import("./types/index.js").ScorerType;
+    }): Promise<import("./types/index.js").ScorerMetadata[]>;
     /**
      * Get a list of available evaluation pipeline presets.
      * Presets are pre-configured pipelines for common evaluation scenarios.
@@ -1931,7 +1916,7 @@ export declare class NeuroLink {
      * console.log('Pass threshold:', ragPreset.passThreshold);
      * ```
      */
-    getEvaluationPreset(presetName: "safety" | "rag" | "quality" | "comprehensive" | "minimal" | "summarization" | "customerSupport" | "codeGeneration"): Promise<import("./types/scorerTypes.js").PipelineConfig>;
+    getEvaluationPreset(presetName: "safety" | "rag" | "quality" | "comprehensive" | "minimal" | "summarization" | "customerSupport" | "codeGeneration"): Promise<import("./types/index.js").PipelineConfig>;
     /**
      * Dispose of all resources and cleanup connections
      * Call this method when done using the NeuroLink instance to prevent resource leaks

package/dist/lib/neurolink.js

@@ -22,7 +22,7 @@ import pLimit from "p-limit";
 import { ErrorCategory, ErrorSeverity } from "./constants/enums.js";
 import { CIRCUIT_BREAKER, CIRCUIT_BREAKER_RESET_MS, MEMORY_THRESHOLDS, NANOSECOND_TO_MS_DIVISOR, PERFORMANCE_THRESHOLDS, PROVIDER_TIMEOUTS, RETRY_ATTEMPTS, RETRY_DELAYS, TOOL_TIMEOUTS, } from "./constants/index.js";
 import { checkContextBudget } from "./context/budgetChecker.js";
-import { ContextCompactor, } from "./context/contextCompactor.js";
+import { ContextCompactor } from "./context/contextCompactor.js";
 import { emergencyContentTruncation } from "./context/emergencyTruncation.js";
 import { getContextOverflowProvider, isContextOverflowError, parseProviderOverflowDetails, } from "./context/errorDetection.js";
 import { ContextBudgetExceededError } from "./context/errors.js";
@@ -50,16 +50,14 @@ import { MCPToolRegistry } from "./mcp/toolRegistry.js";
 import { initializeHippocampus, } from "./memory/hippocampusInitializer.js";
 import { createMemoryRetrievalTools } from "./memory/memoryRetrievalTools.js";
 import { getMetricsAggregator, MetricsAggregator, } from "./observability/metricsAggregator.js";
-import { SpanStatus, SpanType } from "./observability/types/spanTypes.js";
+import { SpanStatus, SpanType, CircuitBreakerOpenError, ConversationMemoryError, AuthenticationError, AuthorizationError, InvalidModelError, } from "./types/index.js";
 import { SpanSerializer } from "./observability/utils/spanSerializer.js";
 import { flushOpenTelemetry, getLangfuseHealthStatus, initializeOpenTelemetry, isOpenTelemetryInitialized, runWithCurrentLangfuseContext, setLangfuseContext, shutdownOpenTelemetry, } from "./services/server/ai/observability/instrumentation.js";
 import { TaskManager } from "./tasks/taskManager.js";
 import { createTaskTools } from "./tasks/tools/taskTools.js";
 import { ATTR } from "./telemetry/attributes.js";
 import { tracers } from "./telemetry/tracers.js";
-import { CircuitBreakerOpenError } from "./types/circuitBreakerErrors.js";
-import { ConversationMemoryError } from "./types/conversation.js";
-import { AuthenticationError, AuthorizationError, InvalidModelError, } from "./types/errors.js";
+// NEW: Generate function imports
 import { getConversationMessages, storeConversationTurn, } from "./utils/conversationMemory.js";
 // Enhanced error handling imports
 import { CircuitBreaker, ERROR_CODES, ErrorFactory, isAbortError, isRetriableError, logStructuredError, NeuroLinkError, withRetry, withTimeout, } from "./utils/errorHandling.js";
@@ -4831,15 +4829,31 @@ Current user's request: ${currentInput}`;
         catch {
             /* non-blocking */
         }
-        const fallbackRoute = ModelRouter.getFallbackRoute(originalPrompt || enhancedOptions.input.text || "", {
+        // BZ-1341: Support fallback provider override via options or env vars
+        const optFallbackProvider = enhancedOptions.fallbackProvider?.trim() || undefined;
+        const optFallbackModel = enhancedOptions.fallbackModel?.trim() || undefined;
+        const envFallbackProvider = process.env.FALLBACK_PROVIDER?.trim() || undefined;
+        const envFallbackModel = process.env.FALLBACK_MODEL?.trim() || undefined;
+        const modelConfigRoute = ModelRouter.getFallbackRoute(originalPrompt || enhancedOptions.input.text || "", {
             provider: providerName,
             model: enhancedOptions.model || "gpt-4o",
             reasoning: "primary failed",
             confidence: 0.5,
         }, { fallbackStrategy: "auto" });
+        const fallbackRoute = {
+            ...modelConfigRoute,
+            provider: optFallbackProvider ?? envFallbackProvider ?? modelConfigRoute.provider,
+            model: optFallbackModel ?? envFallbackModel ?? modelConfigRoute.model,
+        };
         logger.warn("Retrying with fallback provider", {
             originalProvider: providerName,
             fallbackProvider: fallbackRoute.provider,
+            fallbackModel: fallbackRoute.model,
+            fallbackSource: optFallbackProvider || optFallbackModel
+                ? "options"
+                : envFallbackProvider || envFallbackModel
+                    ? "env"
+                    : "model_config",
             reason: errorMsg,
         });
         try {

package/dist/lib/observability/exporterRegistry.d.ts

@@ -4,7 +4,7 @@
  */
 import type { BaseExporter } from "./exporters/baseExporter.js";
 import type { Sampler } from "./sampling/samplers.js";
-import type { ExporterHealthStatus, ExportResult, SpanData } from "./types/index.js";
+import type { ExporterHealthStatus, ExportResult, SpanData } from "../types/index.js";
 /**
  * Circuit breaker state for an exporter
  */

package/dist/lib/observability/exporters/arizeExporter.d.ts

@@ -2,7 +2,7 @@
  * Arize Exporter
  * Exports spans to Arize ML monitoring platform
  */
-import type { ArizeExporterConfig, ExporterHealthStatus, ExportResult, SpanData } from "../types/index.js";
+import type { ArizeExporterConfig, ExporterHealthStatus, ExportResult, SpanData } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * Arize exporter for ML monitoring and prediction logs

package/dist/lib/observability/exporters/baseExporter.d.ts

@@ -2,7 +2,7 @@
  * Abstract base class for all observability exporters
  * Follows NeuroLink's factory pattern and Mastra's unified exporter interface
  */
-import type { ExporterConfig, ExporterHealthStatus, ExportResult, SpanData } from "../types/index.js";
+import type { ExporterConfig, ExporterHealthStatus, ExportResult, SpanData } from "../../types/index.js";
 /**
  * Abstract base class for all observability exporters
  * Provides common functionality: buffering, flush intervals, health checks, retry logic

package/dist/lib/observability/exporters/braintrustExporter.d.ts

@@ -2,7 +2,7 @@
  * Braintrust Exporter
  * Exports spans to Braintrust AI evaluation platform
  */
-import type { BraintrustExporterConfig, ExporterHealthStatus, ExportResult, SpanData } from "../types/index.js";
+import type { BraintrustExporterConfig, ExporterHealthStatus, ExportResult, SpanData } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * Braintrust exporter for AI evaluation and scoring

package/dist/lib/observability/exporters/datadogExporter.d.ts

@@ -2,7 +2,7 @@
  * Datadog Exporter
  * Exports spans to Datadog APM platform
  */
-import type { DatadogExporterConfig, ExporterHealthStatus, ExportResult, SpanData } from "../types/index.js";
+import type { DatadogExporterConfig, ExporterHealthStatus, ExportResult, SpanData } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * Datadog exporter for enterprise APM integration

package/dist/lib/observability/exporters/datadogExporter.js

@@ -3,7 +3,7 @@
  * Exports spans to Datadog APM platform
  */
 import { logger } from "../../utils/logger.js";
-import { SpanStatus } from "../types/spanTypes.js";
+import { SpanStatus } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * Datadog exporter for enterprise APM integration

package/dist/lib/observability/exporters/laminarExporter.d.ts

@@ -3,7 +3,7 @@
  * Exports spans to Laminar LLM tracing platform
  * @see https://docs.laminar.run/
  */
-import type { ExporterHealthStatus, ExportResult, LaminarExporterConfig, SpanData } from "../types/index.js";
+import type { ExporterHealthStatus, ExportResult, LaminarExporterConfig, SpanData } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * Laminar exporter for LLM pipeline tracing and monitoring

package/dist/lib/observability/exporters/laminarExporter.js

@@ -4,7 +4,7 @@
  * @see https://docs.laminar.run/
  */
 import { logger } from "../../utils/logger.js";
-import { SpanStatus, SpanType } from "../types/spanTypes.js";
+import { SpanStatus, SpanType } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * Laminar exporter for LLM pipeline tracing and monitoring