@juspay/neurolink 11.12.0 → 11.13.1

package/dist/lib/neurolink.d.ts

@@ -1,2662 +0,0 @@
-/**
- * NeuroLink - Unified AI Interface with Real MCP Tool Integration
- *
- * REDESIGNED FALLBACK CHAIN - NO CIRCULAR DEPENDENCIES
- * Enhanced AI provider system with natural MCP tool access.
- * Uses real MCP infrastructure for tool discovery and execution.
- */
-import type { AgentDefinition, AgentNetworkConfig, AgentRunOptions, AgentRunOutcome, AgentToolRegistrationOptions, IsolatedAgentDefinition, NetworkExecutionInput, NetworkExecutionOptions, NetworkExecutionResult, NetworkStreamChunk, WorkerInstanceOptions } from "./types/index.js";
-import type { CompactionConfig, CompactionResult, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, AuthProvider, 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, StreamGenerationEndContext, ToolRoutingServerDescriptor, ToolDedupConfig, ToolConfig, KnowledgeEngineStatus } from "./types/index.js";
-import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
-import type { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
-import { ExternalServerManager } from "./mcp/externalServerManager.js";
-import { MCPToolRegistry } from "./mcp/toolRegistry.js";
-import type { DynamicOptions } from "./types/index.js";
-import { SkillsManager } from "./skills/skillsManager.js";
-import type { CostAnalysisOptions, CostAnalysisResult, ProviderMetricsOptions, ProviderMetricsResult, TeamAnalyticsOptions, TeamAnalyticsResult } from "./types/index.js";
-import { TaskManager } from "./tasks/taskManager.js";
-import type { SessionExport, SessionListItem } from "./types/index.js";
-/**
- * Curator P2-4 dedup (concurrency-safe): native providers emit
- * `generation:end` on the shared SDK emitter. We attach a fresh
- * mutable `dedupContext` object directly to the per-call
- * `StreamOptions` (under `_streamDedupContext`) so each stream gets
- * its own instance — concurrent streams have different option objects
- * and therefore different contexts, so they cannot interfere.
- *
- * Native provider emit sites read `options._streamDedupContext` and
- * flip `.providerEmitted = true` before emitting; the orchestration's
- * finally block reads the same closed-over reference and skips its
- * own emit when the flag is set.
- *
- * This avoids the AsyncLocalStorage approach which doesn't reliably
- * propagate through async-generator yield boundaries when iteration
- * happens from outside the original `run()` scope (e.g. when the
- * consumer drives `for await of result.stream` after `sdk.stream(...)`
- * returns).
- */
-export declare const STREAM_DEDUP_CONTEXT_KEY: "_streamDedupContext";
-/**
- * Native providers call this from their `generation:end` emit sites,
- * passing the same `options` object they received. Safe no-op when
- * the field isn't set.
- */
-export declare function markStreamProviderEmittedGenerationEnd(options: {
-    _streamDedupContext?: StreamGenerationEndContext;
-} | undefined): void;
-/**
- * Symbol-based brand for cross-module identification without circular imports.
- *
- * Provider constructors receive `sdk?: unknown` (the factory layer's
- * contract). Rather than duck-typing via `"getInMemoryServers" in sdk`,
- * use `isNeuroLink(value)` from this module to do a brand check —
- * survives minification AND doesn't rely on method-name stability.
- */
-export declare const NEUROLINK_BRAND: unique symbol;
-/**
- * Type-guard for opaque values that should be a {@link NeuroLink} instance.
- *
- * Designed for the provider-factory boundary where TS can't carry the type
- * through `UnknownRecord` without forcing every caller into a circular
- * dependency. Cheap to call and unaffected by minification.
- */
-export declare function isNeuroLink(value: unknown): value is NeuroLink;
-export declare class NeuroLink {
-    private mcpInitialized;
-    private mcpSkipped;
-    private mcpInitPromise;
-    private emitter;
-    private _taskManager?;
-    private _taskManagerConfig?;
-    private toolRegistry;
-    private autoDiscoveredServerInfos;
-    private externalServerManager;
-    private toolCache;
-    private readonly toolCacheDuration;
-    private modelAliasConfig?;
-    private lastCompactionMessageCount;
-    /** Extract sessionId from options context for compaction watermark keying */
-    private getCompactionSessionId;
-    private mcpToolResultCache?;
-    private mcpToolRouter?;
-    private mcpToolBatcher?;
-    private mcpEnhancedDiscovery?;
-    private mcpToolMiddlewares;
-    /** Artifact store for externalized MCP tool outputs (set when strategy=externalize). */
-    private mcpArtifactStore?;
-    private _disableToolCacheForCurrentRequest;
-    private mcpEnhancementsConfig?;
-    private toolCircuitBreakers;
-    private toolExecutionMetrics;
-    private currentStreamToolExecutions;
-    private toolExecutionHistory;
-    private activeToolExecutions;
-    /**
-     * Helper method to emit tool end event in a consistent way
-     * Used by executeTool in both success and error paths
-     * @param toolName - Name of the tool
-     * @param startTime - Timestamp when tool execution started
-     * @param success - Whether the tool execution was successful
-     * @param result - The result of the tool execution (optional)
-     * @param error - The error if execution failed (optional)
-     */
-    private emitToolEndEvent;
-    conversationMemory?: ConversationMemoryManager | RedisConversationMemoryManager | null;
-    private conversationMemoryNeedsInit;
-    private conversationMemoryConfig?;
-    private toolRoutingConfig?;
-    private toolRoutingCacheInstance?;
-    private toolRoutingVectorCache?;
-    private knowledgeGroundingEngine?;
-    private toolDedupConfig?;
-    private toolsConfig?;
-    /** Session-scoped pins of tools discovered via search_tools (tools.discovery mode). */
-    private discoveryPins;
-    private enableOrchestration;
-    private authProvider?;
-    private pendingAuthConfig?;
-    private authInitPromise?;
-    private credentials?;
-    private readonly fallbackConfig;
-    private readonly modelPool;
-    private readonly requestRouter;
-    private readonly classifierRouter;
-    /**
-     * Merge instance-level credentials with per-call credentials.
-     *
-     * Semantics: **deep merge at the provider level.** For each provider key
-     * present in both `this.credentials` and `callCredentials`, the per-call
-     * fields are merged ON TOP of the instance-level fields, so fields not
-     * mentioned in the per-call slice are preserved.
-     *
-     * Example:
-     * ```
-     * instance:  { openai: { apiKey: "key1", baseURL: "url1" } }
-     * per-call:  { openai: { apiKey: "key2" } }
-     * merged:    { openai: { apiKey: "key2", baseURL: "url1" } }   // baseURL preserved
-     * ```
-     *
-     * Providers present only in one source are carried through unchanged.
-     * Unrelated providers (not overridden in callCredentials) are carried through
-     * from instance credentials unchanged.
-     */
-    private resolveCredentials;
-    private hitlManager?;
-    private _sessionCostUsd;
-    private fileRegistry;
-    private cachedFileTools;
-    private memoryInstance?;
-    private memorySDKConfig?;
-    private skillsManagerInstance?;
-    private skillsConfig?;
-    /**
-     * Extract and set Langfuse context from options with proper async scoping
-     */
-    private setLangfuseContextFromOptions;
-    private createMetricsTraceContext;
-    private enforceSessionBudget;
-    private assertInputText;
-    private applyAuthenticatedRequestContext;
-    private applyGenerateLifecycleMiddleware;
-    private applyStreamLifecycleMiddleware;
-    private initializeMemoryConfig;
-    /**
-     * Lazy initialization for memory — called during generate/stream.
-     */
-    private ensureMemoryReady;
-    /**
-     * Context storage for tool execution
-     * This context will be merged with any runtime context passed by the AI model
-     */
-    private toolExecutionContext?;
-    /**
-     * Set when registerAgentTool() has registered at least one delegation
-     * tool — gates the per-turn delegation scope in generate().
-     */
-    private hasAgentTools;
-    /**
-     * Creates a new NeuroLink instance for AI text generation with MCP tool integration.
-     *
-     * @param config - Optional configuration object
-     * @param config.conversationMemory - Configuration for conversation memory features
-     * @param config.conversationMemory.enabled - Whether to enable conversation memory (default: false)
-     * @param config.conversationMemory.maxSessions - Maximum number of concurrent sessions (default: 100)
-     * @param config.conversationMemory.maxTurnsPerSession - Maximum conversation turns per session (default: 50)
-     * @param config.enableOrchestration - Whether to enable smart model orchestration (default: false)
-     * @param config.hitl - Configuration for Human-in-the-Loop safety features
-     * @param config.hitl.enabled - Whether to enable HITL tool confirmation (default: false)
-     * @param config.hitl.dangerousActions - Keywords that trigger confirmation (default: ['delete', 'remove', 'drop'])
-     * @param config.hitl.timeout - Confirmation timeout in milliseconds (default: 30000)
-     * @param config.hitl.allowArgumentModification - Allow users to modify tool parameters (default: true)
-     * @param config.toolRegistry - Optional tool registry instance for advanced use cases (default: new MCPToolRegistry())
-     *
-     * @example
-     * ```typescript
-     * // Basic usage
-     * const neurolink = new NeuroLink();
-     *
-     * // With conversation memory
-     * const neurolink = new NeuroLink({
-     *   conversationMemory: {
-     *     enabled: true,
-     *     maxSessions: 50,
-     *     maxTurnsPerSession: 20
-     *   }
-     * });
-     *
-     * // With orchestration enabled
-     * const neurolink = new NeuroLink({
-     *   enableOrchestration: true
-     * });
-     *
-     * // With HITL safety features
-     * const neurolink = new NeuroLink({
-     *   hitl: {
-     *     enabled: true,
-     *     dangerousActions: ['delete', 'remove', 'drop', 'truncate'],
-     *     timeout: 30000,
-     *     allowArgumentModification: true
-     *   }
-     * });
-     * ```
-     *
-     * @throws {Error} When provider registry setup fails
-     * @throws {Error} When conversation memory initialization fails (if enabled)
-     * @throws {Error} When external server manager initialization fails
-     * @throws {Error} When HITL configuration is invalid (if enabled)
-     */
-    private observabilityConfig?;
-    private metricsAggregator;
-    private analyticsService;
-    /**
-     * Per-request metrics trace context backed by AsyncLocalStorage.
-     * Safe for concurrent requests on the same SDK instance.
-     * Context is set via metricsTraceContextStorage.run() in generate/stream.
-     */
-    private get _metricsTraceContext();
-    constructor(config?: NeurolinkConstructorConfig);
-    /**
-     * TaskManager — scheduled and self-running tasks.
-     * Lazy-initialized on first access. Configurable via constructor `tasks` option.
-     * The actual async initialization (Redis connect, backend start) happens
-     * lazily inside TaskManager on first operation.
-     */
-    get tasks(): TaskManager;
-    /**
-     * Initialize provider registry with security settings
-     */
-    private initializeProviderRegistry;
-    /**
-     * Initialize conversation memory if enabled
-     */
-    private initializeConversationMemory;
-    /**
-     * Initialize HITL (Human-in-the-Loop) if enabled
-     */
-    private initializeHITL;
-    /**
-     * Initialize MCP enhancement modules (cache, router, batcher, discovery).
-     * Wires standalone MCP modules into the core SDK execution path.
-     */
-    private initializeMCPEnhancements;
-    /**
-     * 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;
-    /**
-     * Register task management tools bound to a TaskManager instance.
-     * Follows the same factory + registry pattern as registerFileTools().
-     * Called when TaskManager is created (eagerly or lazily via the `tasks` getter).
-     */
-    private registerTaskTools;
-    /**
-     * Register memory retrieval tools that allow the AI to access
-     * conversation history, including full tool outputs.
-     * Only registered when Redis conversation memory is active.
-     */
-    private registerMemoryRetrievalTools;
-    /**
-     * Lazy initialization for the skills subsystem — mirrors ensureMemoryReady().
-     * Returns null (and stays null) when skills are not configured or the
-     * store failed to initialize; read paths fail open on that null.
-     */
-    private ensureSkillsReady;
-    /**
-     * Register the built-in skill tools (list_skills, plus
-     * mutation tools when allowMutations is set). Follows the
-     * registerMemoryRetrievalTools() pattern: registered via registerTool()
-     * so they land in the "user-defined" category that reaches the LLM tool
-     * schema, with the manager resolved lazily at execution time.
-     */
-    private registerSkillTools;
-    /**
-     * Skills augmentation for one generate()/stream() call:
-     *  1. Discovery — surface the skills listing per the resolved mode:
-     *     embedded in the use_skill tool description ("tool", default) or
-     *     appended to the system prompt ("system-prompt").
-     *  2. Per-call tools — inject use_skill + read_skill_resource into
-     *     options.tools (the RAG-tool pattern; same-name entries shadow
-     *     registered tools) with the sessionId closure-bound so activations
-     *     pin to the session.
-     *  3. Preload — activate host-requested skills up front, injecting their
-     *     instructions into this call's system prompt and pinning them.
-     * Fails open: any error leaves the call untouched.
-     */
-    private applySkillsAugmentation;
-    /** Session id for skill activation tracking, from the call context. */
-    private resolveSkillSessionId;
-    /** User id for skill-session hydration (Redis keys sessions by userId). */
-    private resolveSkillUserId;
-    /**
-     * Activate host-requested skills before the model runs: instructions go
-     * into this call's system prompt; when persisting, the activation is
-     * pinned so later turns replay it from history instead. Unknown or
-     * already-active names are skipped with a warn/debug log (fail-open).
-     */
-    private preloadSkills;
-    /**
-     * Pinned skill messages recorded during this turn, ready for
-     * StoreConversationTurnOptions.skillMessages. Empty when skills are off
-     * or nothing was activated.
-     */
-    private drainPendingSkillMessages;
-    /**
-     * Programmatic access to the skills subsystem (search/list/get/mutations).
-     * Returns null when skills are not configured or failed to initialize.
-     */
-    getSkillsManager(): SkillsManager | null;
-    /** Format memory context for prompt inclusion */
-    private formatMemoryContext;
-    /**
-     * Format memory context from multiple users into a labeled block.
-     */
-    private formatMultiUserMemoryContext;
-    /**
-     * Determine whether memory should be read (retrieved) for this call.
-     * Respects both the global memory SDK config and per-call overrides.
-     */
-    private shouldReadMemory;
-    /**
-     * Determine whether memory should be written (stored) for this call.
-     * Respects both the global memory SDK config and per-call overrides.
-     */
-    private shouldWriteMemory;
-    /**
-     * Retrieve condensed memory for a user (and optionally additional users).
-     * Returns the input text enhanced with memory context, or unchanged if no memory.
-     */
-    private retrieveMemory;
-    /**
-     * Store a conversation turn in memory (non-blocking).
-     * Calls add(userId, content) which internally condenses old + new via LLM.
-     * Supports additional users with per-user prompt and maxWords overrides.
-     */
-    private storeMemoryInBackground;
-    /**
-     * Set up HITL event forwarding to main emitter
-     */
-    private setupHITLEventForwarding;
-    /**
-     * Initialize external server manager with event handlers
-     */
-    private initializeExternalServerManager;
-    /**
-     * Setup event handlers for external server manager
-     */
-    private setupExternalServerEventHandlers;
-    /**
-     * Initialize Langfuse observability for AI operations tracking
-     */
-    private initializeLangfuse;
-    /**
-     * Log constructor completion with final state summary
-     */
-    private logConstructorComplete;
-    /**
-     * Initialize MCP registry with enhanced error handling and resource cleanup
-     * Uses isolated async context to prevent hanging
-     */
-    private initializeMCP;
-    /**
-     * Actual one-shot MCP initialization logic. Called at most once per
-     * NeuroLink instance lifetime (unless cleanup() resets the flag).
-     */
-    private performMCPInitializationOnce;
-    /**
-     * Import performance manager with error handling
-     */
-    private importPerformanceManager;
-    /**
-     * Perform main MCP initialization logic
-     */
-    private performMCPInitialization;
-    /**
-     * Initialize tool registry with timeout protection
-     */
-    private initializeToolRegistryInternal;
-    /**
-     * Initialize provider registry
-     */
-    private initializeProviderRegistryInternal;
-    /**
-     * Register direct tools server
-     */
-    private registerDirectToolsServerInternal;
-    /**
-     * Load MCP configuration from .mcp-config.json with parallel loading for improved performance
-     */
-    private loadMCPConfigurationInternal;
-    /**
-     * Log MCP initialization completion
-     */
-    private logMCPInitComplete;
-    /**
-     * Apply orchestration to determine optimal provider and model
-     * @param options - Original GenerateOptions
-     * @returns Modified options with orchestrated provider marked in context, or empty object if validation fails
-     */
-    private applyOrchestration;
-    /**
-     * Apply orchestration to determine optimal provider and model for streaming
-     * @param options - Original StreamOptions
-     * @returns Modified options with orchestrated provider marked in context, or empty object if validation fails
-     */
-    private applyStreamOrchestration;
-    /**
-     * MAIN ENTRY POINT: Enhanced generate method with new function signature
-     * Replaces both generateText and legacy methods
-     */
-    /**
-     * Extracts the original prompt text from the provided input.
-     * If a string is provided, it returns the string directly.
-     * If a GenerateOptions object is provided, it returns the input text from the object.
-     * @param optionsOrPrompt The prompt input, either as a string or a GenerateOptions object.
-     * @returns The original prompt text as a string.
-     */
-    private _extractOriginalPrompt;
-    /**
-     * Generate AI content using the best available provider with MCP tool integration.
-     * This is the primary method for text generation with full feature support.
-     *
-     * @param optionsOrPrompt - Either a string prompt or a comprehensive GenerateOptions object
-     * @param optionsOrPrompt.input - Input configuration object
-     * @param optionsOrPrompt.input.text - The text prompt to send to the AI (required)
-     * @param optionsOrPrompt.provider - AI provider to use ('auto', 'openai', 'anthropic', etc.)
-     * @param optionsOrPrompt.model - Specific model to use (e.g., 'gpt-4', 'claude-3-opus')
-     * @param optionsOrPrompt.temperature - Randomness in response (0.0 = deterministic, 2.0 = very random)
-     * @param optionsOrPrompt.maxTokens - Maximum tokens in response
-     * @param optionsOrPrompt.systemPrompt - System message to set AI behavior
-     * @param optionsOrPrompt.disableTools - Whether to disable MCP tool usage
-     * @param optionsOrPrompt.enableAnalytics - Whether to include usage analytics
-     * @param optionsOrPrompt.enableEvaluation - Whether to include response quality evaluation
-     * @param optionsOrPrompt.context - Additional context for the request
-     * @param optionsOrPrompt.evaluationDomain - Domain for specialized evaluation
-     * @param optionsOrPrompt.toolUsageContext - Context for tool usage decisions
-     *
-     * @returns Promise resolving to GenerateResult with content, usage data, and optional analytics
-     *
-     * @example
-     * ```typescript
-     * // Simple usage with string prompt
-     * const result = await neurolink.generate("What is artificial intelligence?");
-     * console.log(result.content);
-     *
-     * // Advanced usage with options
-     * const result = await neurolink.generate({
-     *   input: { text: "Explain quantum computing" },
-     *   provider: "openai",
-     *   model: "gpt-4",
-     *   temperature: 0.7,
-     *   maxTokens: 500,
-     *   enableAnalytics: true,
-     *   enableEvaluation: true,
-     *   context: { domain: "science", level: "intermediate" }
-     * });
-     *
-     * // Access analytics and evaluation data
-     * console.log(result.analytics?.usage);
-     * console.log(result.evaluation?.relevance);
-     * ```
-     *
-     * @throws {Error} When input text is missing or invalid
-     * @throws {Error} When all providers fail to generate content
-     * @throws {Error} When conversation memory operations fail (if enabled)
-     */
-    /**
-     * Get observability configuration
-     */
-    getObservabilityConfig(): ObservabilityConfig | undefined;
-    /**
-     * Check if Langfuse telemetry is enabled
-     * Centralized utility to avoid duplication across providers
-     */
-    isTelemetryEnabled(): boolean;
-    /**
-     * Get comprehensive telemetry status including Langfuse, OTel, and exporter health
-     */
-    getTelemetryStatus(): {
-        enabled: boolean;
-        langfuse?: {
-            enabled: boolean;
-            baseUrl?: string;
-            environment?: string;
-        };
-        openTelemetry?: {
-            enabled: boolean;
-            endpoint?: string;
-            serviceName?: string;
-        };
-        exporters?: Array<{
-            name: string;
-            enabled: boolean;
-            healthy: boolean;
-            pendingSpans: number;
-            lastExportTime?: string;
-            latencyMs?: number;
-            errors?: string[];
-        }>;
-    };
-    /**
-     * Get aggregated observability metrics (latency, tokens, cost, success rate)
-     */
-    getMetrics(): MetricsSummary;
-    /**
-     * Get all recorded spans
-     */
-    getSpans(): SpanData[];
-    /**
-     * Get traces (spans grouped by traceId with parent-child hierarchy)
-     */
-    getTraces(): TraceView[];
-    /**
-     * Reset all collected metrics and spans
-     */
-    resetMetrics(): void;
-    /**
-     * Record a span for metrics tracking
-     */
-    recordMetricsSpan(span: SpanData): void;
-    /**
-     * Get provider metrics analysis
-     * Retrieves aggregated performance, token usage, latency, and success rates per provider.
-     *
-     * @param options - Filtering options
-     * @returns Comprehensive provider metrics result
-     */
-    getProviderMetrics(options?: ProviderMetricsOptions): Promise<ProviderMetricsResult>;
-    /**
-     * Get cost analysis breakdown
-     * Analyzes AI generation costs across requested groups and provides future projections.
-     *
-     * @param options - Cost configuration options
-     * @returns Detailed cost analysis breakdown
-     */
-    getCostAnalysis(options?: CostAnalysisOptions): Promise<CostAnalysisResult>;
-    /**
-     * Get team-wide usage analytics
-     * Retrieves request counts, unique active users, provider breakdown, and quality scoring.
-     *
-     * @param options - Team query options
-     * @returns Comprehensive team analytics report
-     */
-    getTeamAnalytics(options?: TeamAnalyticsOptions): Promise<TeamAnalyticsResult>;
-    /**
-     * Record a memory operation span to both instance and global metrics aggregators.
-     * This ensures memory spans are visible via sdk.getSpans() and getMetricsAggregator().getSpans().
-     */
-    private recordMemorySpan;
-    /**
-     * Public method to initialize Langfuse observability
-     * This method can be called externally to ensure Langfuse is properly initialized
-     */
-    initializeLangfuseObservability(): Promise<void>;
-    /**
-     * Gracefully shutdown NeuroLink and all MCP connections
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Fire-and-forget analytics tracking with rejection logging.
-     */
-    private enqueueAnalyticsTrackRequest;
-    /**
-     * Estimate cost using the canonical SDK pricing table (same source as
-     * AnalyticsService.trackRequest) — avoids diverging TokenTracker rates.
-     */
-    private estimateCostFromUsage;
-    /**
-     * Handle generation:end for Pipeline B spans + advanced analytics.
-     * When pipelineAHandled is set, skips Pipeline B spans but still tracks
-     * analytics so successful AI-SDK generate/stream calls are recorded.
-     * Stream analytics are owned here (not stream:complete) to avoid duplicates.
-     */
-    private handleGenerationEndMetrics;
-    /**
-     * Pipeline B span recording for stream:complete.
-     * Advanced analytics are recorded from generation:end only (avoids duplicates
-     * when both stream:complete and generation:end fire for the same request).
-     */
-    private handleStreamCompleteMetrics;
-    private handleToolEndMetrics;
-    /**
-     * Pipeline B span recording for stream:error.
-     * Analytics for failed streams come from generation:end (success: false).
-     */
-    private handleStreamErrorMetrics;
-    /**
-     * Initialize event listeners that feed span data to MetricsAggregator.
-     * Listens to generation:end, stream:complete, and tool:end events.
-     */
-    private initializeMetricsListeners;
-    /**
-     * Generate AI response with comprehensive feature support.
-     *
-     * Primary method for AI generation with support for all NeuroLink features:
-     * - Multi-provider support (14+ providers)
-     * - MCP tool integration
-     * - Structured JSON output with Zod schemas
-     * - Conversation memory (Redis or in-memory)
-     * - HITL security workflows
-     * - Middleware execution
-     * - Multimodal inputs (images, PDFs, CSV)
-     *
-     * @category Generation
-     *
-     * @param optionsOrPrompt - Generation options or simple text prompt
-     * @param optionsOrPrompt.input - Input text and optional files
-     * @param optionsOrPrompt.provider - AI provider name (e.g., 'vertex', 'openai', 'anthropic')
-     * @param optionsOrPrompt.model - Model name to use
-     * @param optionsOrPrompt.tools - MCP tools to enable for this generation
-     * @param optionsOrPrompt.schema - Zod schema for structured output validation
-     * @param optionsOrPrompt.temperature - Sampling temperature (0-2, default: 1.0)
-     * @param optionsOrPrompt.maxTokens - Maximum tokens to generate
-     * @param optionsOrPrompt.thinkingConfig - Extended thinking configuration (thinkingLevel: 'minimal'|'low'|'medium'|'high')
-     * @param optionsOrPrompt.context - Context with conversationId and userId for memory
-     * @param optionsOrPrompt.useKnowledgeGrounding - Whether to use the instance's configured knowledge for this call
-     * @returns Promise resolving to generation result with content and metadata
-     *
-     * @example Basic text generation
-     * ```typescript
-     * const result = await neurolink.generate({
-     *   input: { text: 'Explain quantum computing' }
-     * });
-     * console.log(result.content);
-     * ```
-     *
-     * @example With specific provider
-     * ```typescript
-     * const result = await neurolink.generate({
-     *   input: { text: 'Write a poem' },
-     *   provider: 'anthropic',
-     *   model: 'claude-3-opus'
-     * });
-     * ```
-     *
-     * @example With MCP tools
-     * ```typescript
-     * const result = await neurolink.generate({
-     *   input: { text: 'Read README.md and summarize it' },
-     *   tools: ['readFile']
-     * });
-     * ```
-     *
-     * @example With structured output
-     * ```typescript
-     * import { z } from 'zod';
-     *
-     * const schema = z.object({
-     *   name: z.string(),
-     *   age: z.number(),
-     *   city: z.string()
-     * });
-     *
-     * const result = await neurolink.generate({
-     *   input: { text: 'Extract person info: John is 30 years old from NYC' },
-     *   schema: schema
-     * });
-     * // result.structuredData is type-safe!
-     * ```
-     *
-     * @example With conversation memory
-     * ```typescript
-     * const result = await neurolink.generate({
-     *   input: { text: 'What did we discuss earlier?' },
-     *   context: {
-     *     conversationId: 'conv-123',
-     *     userId: 'user-456'
-     *   }
-     * });
-     * ```
-     *
-     * @example With multimodal input
-     * ```typescript
-     * const result = await neurolink.generate({
-     *   input: {
-     *     text: 'Describe this image',
-     *     images: ['/path/to/image.jpg']
-     *   },
-     *   provider: 'vertex'
-     * });
-     * ```
-     *
-     * @throws {Error} When input text is missing or invalid
-     * @throws {Error} When all providers fail to generate content
-     * @throws {Error} When structured output validation fails
-     * @throws {Error} When HITL approval is denied
-     *
-     * @see {@link GenerateOptions} for all available options
-     * @see {@link GenerateResult} for result structure
-     * @see {@link stream} for streaming generation
-     * @since 1.0.0
-     */
-    generate(optionsOrPrompt: GenerateOptions | DynamicOptions | string): Promise<GenerateResult>;
-    private fireConsumerOnErrorIfNotFired;
-    /**
-     * Curator P2-3: wraps a generate/stream call with the fallback
-     * orchestration (`providerFallback` callback + `modelChain` walker).
-     *
-     * On a qualifying error from the inner call:
-     *  1. Resolve the effective callback (per-call > instance > synthesised
-     *     from modelChain) and the effective chain (per-call > instance).
-     *  2. Walk attempts: invoke callback (or pop next chain entry) → emit
-     *     `model.fallback` event → re-call inner with the new {provider,
-     *     model}.
-     *  3. Stop on first success, on a callback returning null, or after
-     *     exhausting the chain (throw the most recent error).
-     *
-     * What qualifies depends on how fallback was configured: an EXPLICIT
-     * `providerFallback` callback is consulted for any error except client
-     * aborts (the callback owns the decision — it receives the error
-     * unmodified and can return null to bubble), while modelChain-only
-     * configs keep the narrow model-access-denied gate.
-     */
-    private runWithFallbackOrchestration;
-    private attemptInner;
-    private executeGenerateWithMetricsContext;
-    private executeGenerateRequest;
-    private prepareGenerateRequest;
-    private maybeHandleEarlyGenerateResult;
-    private runStandardGenerateRequest;
-    private maybeApplyGenerateOrchestration;
-    /**
-     * Applies the host-configured `requestRouter` to `options` in place.
-     *
-     * The router is skipped when:
-     *   - no `requestRouter` is configured on this instance, or
-     *   - the caller explicitly set both `options.provider` AND `options.model`
-     *     (we only skip the router if BOTH are set; a caller setting only one
-     *     still lets the router fill in the other field).
-     *
-     * Fails open: any router error is logged at WARN level and the call
-     * continues with the original options unmodified.
-     *
-     * @param options — the mutable options object (generate or stream).
-     * @param promptText — the text prompt used to build the RouterInputContext.
-     * @param hasTools — true when at least one tool is available for this call.
-     * @param requiresVision — true when the call includes image attachments.
-     * @param thinkingLevel — optional thinking level string from the call options.
-     */
-    private applyRequestRouter;
-    /**
-     * Applies the host-configured `classifierRouter` to `options` in place.
-     *
-     * Classifies the request by difficulty and selects a provider/model from the
-     * configured base pool (cheaper/faster for easy tasks, more capable for hard
-     * ones), and optionally narrows the tool set via `toolFilter`/`excludeTools`.
-     *
-     * Skipped when: no router is configured; the inbound call is the classifier's
-     * own generate() (marked `__classifierRouted`); the caller pinned BOTH
-     * provider and model; or a ModelPool is configured (the pool owns selection).
-     * Fails open — any error leaves options unchanged.
-     */
-    private applyClassifierRouting;
-    private prepareGenerateAugmentations;
-    private buildGenerateTextOptions;
-    /**
-     * Provider-agnostic JSON recovery for schema requests. Structured-output
-     * enforcement makes valid JSON the overwhelming case; for every other
-     * provider path — including generate() overrides (Vertex, Anthropic,
-     * Bedrock, Google AI Studio) — object/array roots are recovered here via
-     * balanced-scan + jsonrepair and scalar JSON roots via plain JSON.parse,
-     * with the parsed value exposed as `structuredData`. If nothing JSON-shaped
-     * is recoverable (pure prose), the raw text is returned, `structuredData`
-     * stays undefined, and a WARN makes the case observable.
-     *
-     * Mutates `textResult` in place, and must run BEFORE the end-of-generation
-     * emits so event consumers see the same content/structuredData the caller
-     * receives.
-     */
-    private recoverStructuredData;
-    private finalizeGenerateRequestResult;
-    private emitGenerateErrorEvent;
-    /**
-     * Schedule non-blocking memory storage after generate completes.
-     */
-    private scheduleGenerateMemoryStorage;
-    /**
-     * Handle PPT generation mode
-     */
-    private generateWithPPT;
-    /**
-     * Dispatch a music-generation request to the registered music handler
-     * for the provider named in `options.output.music.provider`.
-     */
-    private generateWithMusic;
-    /**
-     * Dispatch an avatar (lip-sync) request to the registered avatar handler
-     * for the provider named in `options.output.avatar.provider`.
-     */
-    private generateWithAvatar;
-    /**
-     * Generate with workflow engine integration
-     * Returns both original and processed responses for AB testing
-     */
-    private generateWithWorkflow;
-    /**
-     * Stream with workflow engine integration
-     * Progressive streaming: yields preliminary response (first model) then final synthesis
-     */
-    private streamWithWorkflow;
-    /**
-     * BACKWARD COMPATIBILITY: Legacy generateText method
-     * Internally calls generate() and converts result format
-     */
-    generateText(options: TextGenerationOptions): Promise<TextGenerationResult>;
-    /**
-     * REDESIGNED INTERNAL GENERATION - NO CIRCULAR DEPENDENCIES
-     *
-     * This method implements a clean fallback chain:
-     * 1. Initialize conversation memory if enabled
-     * 2. Inject conversation history into prompt
-     * 3. Try MCP-enhanced generation if available
-     * 4. Fall back to direct provider generation
-     * 5. Store conversation turn for future context
-     */
-    private generateTextInternal;
-    private executeGenerateTextInternalWithSpan;
-    private initializeGenerateTextInternalContext;
-    private runGenerateTextInternalFlow;
-    private captureOriginalConversationMessagesForRecovery;
-    private finalizeGenerateTextInternalResult;
-    private handleGenerateTextInternalFailure;
-    private tryRecoverGenerateTextOverflow;
-    /**
-     * Log generateTextInternal start with comprehensive analysis
-     */
-    private logGenerateTextInternalStart;
-    /**
-     * Emit generation start events
-     */
-    private emitGenerationStartEvents;
-    /**
-     * Initialize conversation memory for generation
-     * Lazily initializes memory if needed from constructor flags
-     */
-    private initializeConversationMemoryForGeneration;
-    /**
-     * Attempt MCP generation with retry logic
-     */
-    private attemptMCPGeneration;
-    /**
-     * Non-retryable tool-error predicate shared by `performMCPGenerationRetries`
-     * and `tryMCPGeneration`. Returns `true` when the error indicates the model
-     * hallucinated a tool name or sent invalid arguments — retrying would
-     * re-trigger the same deterministic failure with the same tool set.
-     *
-     * Belt-and-suspenders: prefers class-identity `.isInstance()` (stable across
-     * Phase 5+ native substitution) but falls back to `error.name` and message
-     * substring checks so cross-module-boundary errors (Jest, bundlers, wrapped
-     * errors) are still caught. The name fallback covers both
-     * `AI_InvalidToolInputError` (current v5/v6 SDK) and the legacy
-     * `AI_InvalidToolArgumentsError` (v4).
-     */
-    private static isNonRetryableToolError;
-    /**
-     * Perform MCP generation with retry logic
-     */
-    private performMCPGenerationRetries;
-    /**
-     * Try MCP-enhanced generation (no fallback recursion)
-     */
-    private tryMCPGeneration;
-    private prepareMCPGenerationContext;
-    private logMCPConversationSummary;
-    private ensureMCPGenerationBudget;
-    private compactMCPConversationForBudget;
-    private generateWithMCPProvider;
-    /**
-     * Direct provider generation (no MCP, no recursion)
-     */
-    private directProviderGeneration;
-    /**
-     * Create tool-aware system prompt that informs AI about available tools
-     */
-    /**
-     * Apply per-call tool filtering (whitelist/blacklist) to a ToolInfo array.
-     * Used to filter the tool list before building the system prompt.
-     *
-     * Resolves the SAME policy as the native gate (`BaseProvider`
-     * `applyToolFiltering`) — per-call options plus the instance-level `tools`
-     * config — so what the model is told about tools never diverges from the
-     * tools it can actually call.
-     */
-    private applyToolInfoFiltering;
-    private createToolAwareSystemPrompt;
-    /**
-     * Execute tools if available through centralized registry
-     * Simplified approach without domain detection - relies on tool registry
-     */
-    private detectAndExecuteTools;
-    /**
-     * BACKWARD COMPATIBILITY: Legacy streamText method
-     * Internally calls stream() and converts result format
-     */
-    streamText(prompt: string, options?: Partial<StreamOptions>): Promise<AsyncIterable<string>>;
-    /**
-     * Stream AI-generated content in real-time using the best available provider.
-     * This method provides real-time streaming of AI responses with full MCP tool integration.
-     *
-     * @param options - Stream configuration options
-     * @param options.input - Input configuration object
-     * @param options.input.text - The text prompt to send to the AI (required)
-     * @param options.provider - AI provider to use ('auto', 'openai', 'anthropic', etc.)
-     * @param options.model - Specific model to use (e.g., 'gpt-4', 'claude-3-opus')
-     * @param options.temperature - Randomness in response (0.0 = deterministic, 2.0 = very random)
-     * @param options.maxTokens - Maximum tokens in response
-     * @param options.systemPrompt - System message to set AI behavior
-     * @param options.disableTools - Whether to disable MCP tool usage
-     * @param options.enableAnalytics - Whether to include usage analytics
-     * @param options.enableEvaluation - Whether to include response quality evaluation
-     * @param options.context - Additional context for the request
-     * @param options.evaluationDomain - Domain for specialized evaluation
-     * @param options.useKnowledgeGrounding - Whether to use the instance's configured knowledge for this call
-     *
-     * @returns Promise resolving to StreamResult with an async iterable stream
-     *
-     * @example
-     * ```typescript
-     * // Basic streaming usage
-     * const result = await neurolink.stream({
-     *   input: { text: "Tell me a story about space exploration" }
-     * });
-     *
-     * // Consume the stream
-     * for await (const chunk of result.stream) {
-     *   process.stdout.write(chunk.content);
-     * }
-     *
-     * // Advanced streaming with options
-     * const result = await neurolink.stream({
-     *   input: { text: "Explain machine learning" },
-     *   provider: "openai",
-     *   model: "gpt-4",
-     *   temperature: 0.7,
-     *   enableAnalytics: true,
-     *   context: { domain: "education", audience: "beginners" }
-     * });
-     *
-     * // Access metadata and analytics
-     * console.log(result.provider);
-     * console.log(result.analytics?.usage);
-     * ```
-     *
-     * @throws {Error} When input text is missing or invalid
-     * @throws {Error} When all providers fail to generate content
-     * @throws {Error} When conversation memory operations fail (if enabled)
-     */
-    stream(options: StreamOptions | DynamicOptions): Promise<StreamResult>;
-    /**
-     * Curator P2-3 / Reviewer Finding #2: stream-fallback that also covers
-     * errors thrown during async iteration (e.g. LiteLLM throwing inside
-     * `createLiteLLMTransformedStream`). The standard
-     * `runWithFallbackOrchestration` only catches errors thrown while the
-     * `StreamResult` is being created — once we hand the iterator back to
-     * the caller, errors raised during consumption used to bypass
-     * `providerFallback` / `modelChain`.
-     *
-     * This wrapper runs the orchestration to get an initial StreamResult,
-     * then wraps `result.stream` so that:
-     *   - chunks are forwarded transparently while consumption succeeds
-     *   - if iteration throws a model-access-denied error AND no chunks
-     *     have been yielded yet, we resolve the next fallback target,
-     *     emit `model.fallback`, and recurse
-     *   - if chunks were already yielded, the error propagates (mid-stream
-     *     recovery isn't safe — the consumer has half a response)
-     */
-    private streamWithIterationFallback;
-    private executeStreamRequest;
-    /**
-     * Pre-call tool routing for both stream() and generate() turns: runs the
-     * router LLM once per turn and appends the unpicked servers' registered tool
-     * names to `options.excludeTools` — the per-call denylist enforced by
-     * `baseProvider.applyToolFiltering`. No-op unless `toolRouting.enabled` is
-     * true and a non-empty server catalog has been supplied. Never throws (the
-     * resolver fails open to an empty exclusion list). Accepts both StreamOptions
-     * and GenerateOptions since both share the required fields.
-     */
-    private applyToolRoutingExclusions;
-    /**
-     * Loads a bounded window of prior conversation turns for the router so a
-     * follow-up turn carries the context it needs to classify intent. Reads this
-     * turn's conversation memory (keyed by `context.sessionId`) with
-     * summarization disabled to keep the router cheap. Fails open to an empty
-     * list — routing then falls back to the current query alone (prior
-     * behaviour). On the first turn of a conversation memory may not be
-     * initialised yet; that also yields an empty list, which is fine since the
-     * opening message already carries its own context.
-     */
-    private fetchRecentRoutingHistory;
-    /**
-     * Supplies (or replaces) the pre-call tool routing server catalog.
-     *
-     * For hosts that only know their tool servers after constructing NeuroLink
-     * (e.g. tools are registered per session/conversation). Routing must still
-     * be enabled via the constructor's `toolRouting.enabled` — setting servers
-     * alone does not activate it.
-     */
-    setToolRoutingServers(servers: ToolRoutingServerDescriptor[]): void;
-    /** Knowledge-grounding engine health (null when it was not configured). */
-    getKnowledgeStatus(): KnowledgeEngineStatus | null;
-    private appendKnowledgeGroundingBlockToSystemPrompt;
-    /**
-     * Retrieve knowledge grounding for a public generate/stream call without
-     * mutating its options. The outer call boundary decides how to apply the
-     * returned context. Returns undefined when the call does not opt in,
-     * grounding is disabled/not applicable, or retrieval fails open.
-     */
-    private retrieveKnowledgeGrounding;
-    private validateStreamRequestOptions;
-    private maybeHandleWorkflowStreamRequest;
-    private runStandardStreamRequest;
-    /**
-     * TTS Mode 2 synthesis helper for the stream() pipeline.
-     *
-     * m5 — extracted from runStandardStreamRequest so the surrounding generator
-     * stays under the max-lines-per-function lint budget. Behaviour preserved
-     * exactly:
-     * - When Mode 2 is enabled (`tts.enabled && tts.useAiResponse`) AND the
-     *   model produced non-empty content: synthesises one final audio buffer
-     *   and returns it as an `audioChunk` for the caller to `yield`. Resolves
-     *   `ttsResolver` with the `TTSResult`.
-     * - When Mode 2 is enabled but synthesis fails: logs a warning and resolves
-     *   `ttsResolver` with `undefined`.
-     * - When Mode 2 is requested but skipped (empty content / wrong mode):
-     *   resolves `ttsResolver` with `undefined` early so callers awaiting
-     *   `result.audio` unblock before the surrounding `finally` cleanup
-     *   completes (Issue 7 latency micro-opt — the finally block also resolves
-     *   defensively, so this is a redundant early signal, not a coverage fix).
-     */
-    private synthesizeStreamModeTwo;
-    /**
-     * Prepare stream options: initialize memory, MCP, 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 conversation memory storage in the background.
-     */
-    private storeStreamConversationMemory;
-    /**
-     * Validate stream input with comprehensive error reporting
-     */
-    private validateStreamInput;
-    /**
-     * Emit stream start events
-     */
-    private emitStreamStartEvents;
-    /**
-     * Create MCP stream
-     */
-    private createMCPStream;
-    /**
-     * Process stream result
-     */
-    private processStreamResult;
-    /**
-     * Emit stream end events
-     */
-    private emitStreamEndEvents;
-    /**
-     * Create stream response
-     */
-    private createStreamResponse;
-    /**
-     * Handle stream error with fallback
-     */
-    private handleStreamError;
-    /**
-     * Get the EventEmitter instance to listen to NeuroLink events for real-time monitoring and debugging.
-     * This method provides access to the internal event system that emits events during AI generation,
-     * tool execution, streaming, and other operations for comprehensive observability.
-     *
-     * @returns EventEmitter instance that emits various NeuroLink operation events
-     *
-     * @example
-     * ```typescript
-     * // Basic event listening setup
-     * const neurolink = new NeuroLink();
-     * const emitter = neurolink.getEventEmitter();
-     *
-     * // Listen to generation events
-     * emitter.on('generation:start', (event) => {
-     *   console.log(`Generation started with provider: ${event.provider}`);
-     *   console.log(`Started at: ${new Date(event.timestamp)}`);
-     * });
-     *
-     * emitter.on('generation:end', (event) => {
-     *   console.log(`Generation completed in ${event.responseTime}ms`);
-     *   console.log(`Tools used: ${event.toolsUsed?.length || 0}`);
-     * });
-     *
-     * // Listen to streaming events
-     * emitter.on('stream:start', (event) => {
-     *   console.log(`Streaming started with provider: ${event.provider}`);
-     * });
-     *
-     * emitter.on('stream:end', (event) => {
-     *   console.log(`Streaming completed in ${event.responseTime}ms`);
-     *   if (event.fallback) console.log('Used fallback streaming');
-     * });
-     *
-     * // Listen to tool execution events
-     * emitter.on('tool:start', (event) => {
-     *   console.log(`Tool execution started: ${event.toolName}`);
-     * });
-     *
-     * emitter.on('tool:end', (event) => {
-     *   console.log(`Tool ${event.toolName} ${event.success ? 'succeeded' : 'failed'}`);
-     *   console.log(`Execution time: ${event.responseTime}ms`);
-     * });
-     *
-     * // Listen to tool registration events
-     * emitter.on('tools-register:start', (event) => {
-     *   console.log(`Registering tool: ${event.toolName}`);
-     * });
-     *
-     * emitter.on('tools-register:end', (event) => {
-     *   console.log(`Tool registration ${event.success ? 'succeeded' : 'failed'}: ${event.toolName}`);
-     * });
-     *
-     * // Listen to external MCP server events
-     * emitter.on('externalMCP:serverConnected', (event) => {
-     *   console.log(`External MCP server connected: ${event.serverId}`);
-     *   console.log(`Tools available: ${event.toolCount || 0}`);
-     * });
-     *
-     * emitter.on('externalMCP:serverDisconnected', (event) => {
-     *   console.log(`External MCP server disconnected: ${event.serverId}`);
-     *   console.log(`Reason: ${event.reason || 'Unknown'}`);
-     * });
-     *
-     * emitter.on('externalMCP:toolDiscovered', (event) => {
-     *   console.log(`New tool discovered: ${event.toolName} from ${event.serverId}`);
-     * });
-     *
-     * // Advanced usage with error handling
-     * emitter.on('error', (error) => {
-     *   console.error('NeuroLink error:', error);
-     * });
-     *
-     * // Clean up event listeners when done
-     * function cleanup() {
-     *   emitter.removeAllListeners();
-     * }
-     *
-     * process.on('SIGINT', cleanup);
-     * process.on('SIGTERM', cleanup);
-     * ```
-     *
-     * @example
-     * ```typescript
-     * // Advanced monitoring with metrics collection
-     * const neurolink = new NeuroLink();
-     * const emitter = neurolink.getEventEmitter();
-     * const metrics = {
-     *   generations: 0,
-     *   totalResponseTime: 0,
-     *   toolExecutions: 0,
-     *   failures: 0
-     * };
-     *
-     * // Collect performance metrics
-     * emitter.on('generation:end', (event) => {
-     *   metrics.generations++;
-     *   metrics.totalResponseTime += event.responseTime;
-     *   metrics.toolExecutions += event.toolsUsed?.length || 0;
-     * });
-     *
-     * emitter.on('tool:end', (event) => {
-     *   if (!event.success) {
-     *     metrics.failures++;
-     *   }
-     * });
-     *
-     * // Log metrics every 10 seconds
-     * setInterval(() => {
-     *   const avgResponseTime = metrics.generations > 0
-     *     ? metrics.totalResponseTime / metrics.generations
-     *     : 0;
-     *
-     *   console.log('NeuroLink Metrics:', {
-     *     totalGenerations: metrics.generations,
-     *     averageResponseTime: `${avgResponseTime.toFixed(2)}ms`,
-     *     totalToolExecutions: metrics.toolExecutions,
-     *     failureRate: `${((metrics.failures / (metrics.toolExecutions || 1)) * 100).toFixed(2)}%`
-     *   });
-     * }, 10000);
-     * ```
-     *
-     * **Available Events:**
-     *
-     * **Generation Events:**
-     * - `generation:start` - Fired when text generation begins
-     *   - `{ provider: string, timestamp: number }`
-     * - `generation:end` - Fired when text generation completes (or fails / is aborted)
-     *   - `{ provider: string, responseTime: number, toolsUsed?: string[], timestamp: number, success?: boolean, aborted?: boolean, error?: string }`
-     *   - `success` is `false` for both failures and client aborts; `aborted: true`
-     *     distinguishes the latter so consumers can route cancellations
-     *     differently from real errors. Pipeline B's metrics span maps
-     *     `aborted: true` events to `SpanStatus.WARNING` (not ERROR).
-     *
-     * **Streaming Events:**
-     * - `stream:start` - Fired when streaming begins
-     *   - `{ provider: string, timestamp: number }`
-     * - `stream:end` - Fired when streaming completes
-     *   - `{ provider: string, responseTime: number, fallback?: boolean }`
-     *
-     * **Tool Events:**
-     * - `tool:start` - Fired when tool execution begins
-     *   - `{ toolName: string, timestamp: number }`
-     * - `tool:end` - Fired when tool execution completes
-     *   - `{ toolName: string, responseTime: number, success: boolean, timestamp: number }`
-     * - `tools-register:start` - Fired when tool registration begins
-     *   - `{ toolName: string, timestamp: number }`
-     * - `tools-register:end` - Fired when tool registration completes
-     *   - `{ toolName: string, success: boolean, timestamp: number }`
-     *
-     * **External MCP Events:**
-     * - `externalMCP:serverConnected` - Fired when external MCP server connects
-     *   - `{ serverId: string, toolCount?: number, timestamp: number }`
-     * - `externalMCP:serverDisconnected` - Fired when external MCP server disconnects
-     *   - `{ serverId: string, reason?: string, timestamp: number }`
-     * - `externalMCP:serverFailed` - Fired when external MCP server fails
-     *   - `{ serverId: string, error: string, timestamp: number }`
-     * - `externalMCP:toolDiscovered` - Fired when external MCP tool is discovered
-     *   - `{ toolName: string, serverId: string, timestamp: number }`
-     * - `externalMCP:toolRemoved` - Fired when external MCP tool is removed
-     *   - `{ toolName: string, serverId: string, timestamp: number }`
-     * - `externalMCP:serverAdded` - Fired when external MCP server is added
-     *   - `{ serverId: string, config: MCPServerInfo, toolCount: number, timestamp: number }`
-     * - `externalMCP:serverRemoved` - Fired when external MCP server is removed
-     *   - `{ serverId: string, timestamp: number }`
-     *
-     * **Error Events:**
-     * - `error` - Fired when an error occurs
-     *   - `{ error: Error, context?: object }`
-     *
-     * @throws {Error} This method does not throw errors as it returns the internal EventEmitter
-     *
-     * @since 1.0.0
-     * @see {@link https://nodejs.org/api/events.html} Node.js EventEmitter documentation
-     * @see {@link NeuroLink.generate} for events related to text generation
-     * @see {@link NeuroLink.stream} for events related to streaming
-     * @see {@link NeuroLink.executeTool} for events related to tool execution
-     */
-    getEventEmitter(): TypedEventEmitter<NeuroLinkEvents>;
-    /**
-     * Returns the instance-level tool-dedup configuration, or `undefined` when
-     * toolDedup was not provided at construction time.
-     *
-     * The stored object is returned as-is whenever `toolDedup` was supplied,
-     * including when `enabled: false` — only the complete absence of a `toolDedup`
-     * option results in `undefined`.
-     *
-     * Called by `BaseProvider.applyToolFiltering` so the dedup pass uses the
-     * same config for every generate/stream call without threading an extra
-     * parameter through the full call stack.
-     */
-    getToolDedupConfig(): ToolDedupConfig | undefined;
-    /**
-     * Returns the instance-level `tools` config (master switch, include/exclude
-     * lists, discovery mode), or `undefined` when not provided at construction.
-     *
-     * Called by `BaseProvider.applyToolFiltering` so the tool gate composes the
-     * instance policy with per-call options on every generate/stream call.
-     */
-    getToolsConfig(): ToolConfig | undefined;
-    /**
-     * Tools discovered via `search_tools` for a session (`tools.discovery`
-     * mode). Pinned tools are sent in full on every subsequent call of that
-     * session instead of being deferred — discovery cost is paid once.
-     * Reading refreshes the session's recency (LRU), so active conversations
-     * are never the ones evicted at the session cap.
-     */
-    getDiscoveryPins(sessionKey: string): ReadonlySet<string>;
-    /**
-     * Pin discovered tools to a session (called by the `search_tools`
-     * meta-tool on hydration). Append-only within a session; the map is
-     * bounded by evicting the least-recently-used session past 1000 sessions.
-     */
-    pinDiscoveredTools(sessionKey: string, toolNames: string[]): void;
-    /**
-     * Curator P1-1: synchronous credential health check for a single provider.
-     *
-     * Drives a tiny real call against the provider (1-token completion or
-     * `/models` listing depending on provider) to confirm the configured
-     * credentials are valid. Useful at startup so a service can refuse to
-     * boot if its primary provider's credentials are broken instead of
-     * discovering the problem on first user request.
-     *
-     * @example
-     * ```ts
-     * const health = await neurolink.checkCredentials({ provider: "litellm" });
-     * if (health.status !== "ok") {
-     *   throw new Error(`provider not ready: ${health.detail}`);
-     * }
-     * ```
-     *
-     * @param input - the provider to check
-     * @returns `{ provider, status, detail }`. Possible status values:
-     *   - `"ok"` — credentials valid and provider reachable
-     *   - `"missing"` — required env / credentials not configured
-     *   - `"expired"` — credentials present but rejected (401/403)
-     *   - `"denied"` — credentials valid but team not whitelisted for any model
-     *   - `"network"` — provider unreachable (timeout, ECONNREFUSED, DNS)
-     *   - `"unknown"` — other error; consult `detail`
-     */
-    checkCredentials(input: {
-        provider: string;
-        model?: string;
-    }): Promise<{
-        provider: string;
-        status: "ok" | "missing" | "expired" | "denied" | "network" | "unknown";
-        detail: string;
-    }>;
-    /**
-     * Emit tool start event with execution tracking
-     * @param toolName - Name of the tool being executed
-     * @param input - Input parameters for the tool
-     * @param startTime - Timestamp when execution started
-     * @returns executionId for tracking this specific execution
-     */
-    emitToolStart(toolName: string, input: unknown, startTime?: number): string;
-    /**
-     * Emit tool end event with execution summary
-     * @param toolName - Name of the tool that finished
-     * @param result - Result from the tool execution
-     * @param error - Error message if execution failed
-     * @param startTime - When execution started
-     * @param endTime - When execution finished
-     * @param executionId - Optional execution ID for tracking
-     */
-    emitToolEnd(toolName: string, result?: unknown, error?: string, startTime?: number, endTime?: number, executionId?: string): void;
-    /**
-     * Get current tool execution contexts for stream metadata
-     */
-    getCurrentToolExecutions(): ToolExecutionContext[];
-    /**
-     * Get tool execution history
-     */
-    getToolExecutionHistory(): ToolExecutionSummary[];
-    /**
-     * Clear current stream tool executions (called at stream start)
-     */
-    clearCurrentStreamExecutions(): void;
-    /**
-     * Register a custom tool that will be available to all AI providers
-     * @param name - Unique name for the tool
-     * @param tool - Tool in MCPExecutableTool format (unified MCP protocol type)
-     */
-    registerTool(name: string, tool: MCPExecutableTool, options?: ToolRegistrationOptions): void;
-    /**
-     * Set the context that will be passed to tools during execution
-     * This context will be merged with any runtime context passed by the AI model
-     * @param context - Context object containing session info, tokens, shop data, etc.
-     */
-    setToolContext(context: Record<string, unknown>): void;
-    /**
-     * Get the current tool execution context
-     * @returns Current context or undefined if not set
-     */
-    getToolContext(): Record<string, unknown> | undefined;
-    /**
-     * Clear the tool execution context
-     */
-    clearToolContext(): void;
-    /**
-     * Register multiple tools at once - Supports both object and array formats
-     * @param tools - Object mapping tool names to MCPExecutableTool format OR Array of tools with names
-     *
-     * Object format (existing): { toolName: MCPExecutableTool, ... }
-     * Array format (Lighthouse compatible): [{ name: string, tool: MCPExecutableTool }, ...]
-     */
-    registerTools(tools: Record<string, MCPExecutableTool> | Array<{
-        name: string;
-        tool: MCPExecutableTool;
-    }>): void;
-    /**
-     * Unregister a custom tool
-     * @param name - Name of the tool to remove
-     * @returns true if the tool was removed, false if it didn't exist
-     */
-    unregisterTool(name: string): boolean;
-    /**
-     * Register a global tool middleware that runs on every tool execution.
-     * Middleware receives the tool, params, context, and a next() function.
-     * @param middleware - The middleware function to register
-     * @returns this (for chaining)
-     */
-    useToolMiddleware(middleware: import("./types/index.js").ToolMiddleware): this;
-    /**
-     * Get all registered tool middlewares
-     */
-    getToolMiddlewares(): import("./types/index.js").ToolMiddleware[];
-    /**
-     * Flush any pending batched tool calls immediately
-     */
-    flushToolBatch(): Promise<void>;
-    /**
-     * Get the current MCP enhancements configuration
-     */
-    getMCPEnhancementsConfig(): MCPEnhancementsConfig | undefined;
-    /**
-     * Update agentic loop report metadata for a conversation session.
-     * Upserts a report entry by reportId — updates existing or adds new.
-     * Only supported when using Redis conversation memory.
-     *
-     * @param sessionId The session identifier
-     * @param report The agentic loop report metadata to upsert
-     * @param userId Optional user identifier
-     * @throws Error if conversation memory is not initialized or is not Redis-backed
-     *
-     * @example
-     * ```typescript
-     * await neurolink.updateAgenticLoopReport("session-123", {
-     *   reportId: "report-abc",
-     *   reportType: "META",
-     *   reportStatus: "INPROGRESS",
-     * });
-     * ```
-     */
-    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
-     */
-    getCustomTools(): Map<string, MCPExecutableTool>;
-    /**
-     * Add an in-memory MCP server (from git diff)
-     * Allows registration of pre-instantiated server objects
-     * @param serverId - Unique identifier for the server
-     * @param serverInfo - Server configuration
-     */
-    addInMemoryMCPServer(serverId: string, serverInfo: MCPServerInfo): Promise<void>;
-    /**
-     * Get all registered in-memory servers as a Map for ID-based lookup.
-     *
-     * This method is primarily used when you need O(1) lookup by server ID,
-     * such as in `testMCPServer()` for checking if a specific server exists.
-     *
-     * @returns Map of server IDs to MCPServerInfo
-     * @see {@link getInMemoryServerInfos} for array-based access (useful for iteration/spreading)
-     */
-    getInMemoryServers(): Map<string, MCPServerInfo>;
-    /**
-     * Get in-memory servers as an array of MCPServerInfo.
-     *
-     * This method is the canonical source for in-memory server filtering.
-     * It fetches from the centralized tool registry and filters servers
-     * with the "in-memory" category.
-     *
-     * Use this method when you need to:
-     * - Iterate over all in-memory servers
-     * - Spread servers into another array (e.g., in `listMCPServers()`)
-     * - Get a count of in-memory servers
-     *
-     * @returns Array of MCPServerInfo for in-memory servers
-     * @see {@link getInMemoryServers} for Map-based access (useful for ID lookups)
-     */
-    getInMemoryServerInfos(): MCPServerInfo[];
-    /**
-     * Get auto-discovered servers as MCPServerInfo - ZERO conversion needed
-     * @returns Array of MCPServerInfo
-     */
-    getAutoDiscoveredServerInfos(): MCPServerInfo[];
-    /**
-     * Execute a specific tool by name with robust error handling
-     * Supports both custom tools and MCP server tools with timeout, retry, and circuit breaker patterns
-     * @param toolName - Name of the tool to execute
-     * @param params - Parameters to pass to the tool
-     * @param options - Execution options including optional authentication context
-     * @returns Tool execution result
-     */
-    executeTool<T = unknown>(toolName: string, params?: unknown, options?: {
-        timeout?: number;
-        maxRetries?: number;
-        retryDelayMs?: number;
-        /** Disable tool result caching for this call */
-        disableToolCache?: boolean;
-        /** Bypass the request batcher for this call */
-        bypassBatcher?: boolean;
-        authContext?: {
-            userId?: string;
-            sessionId?: string;
-            user?: Record<string, unknown>;
-            [key: string]: unknown;
-        };
-    }): Promise<T>;
-    private createToolExecutionContext;
-    private executeToolWithSpan;
-    private prepareToolExecutionState;
-    private runPreparedToolExecution;
-    private handleSuccessfulToolExecution;
-    private handleFailedToolExecution;
-    /**
-     * Internal tool execution method with MCP enhancements wired in:
-     * - ToolCache: check/store cached results for non-destructive tools
-     * - ToolRouter: route to best server when same tool exists on multiple servers
-     * - Annotations: skip cache for destructive tools, retry safe tools on failure
-     * - Middleware: apply global middleware chain before execution
-     */
-    private executeToolInternal;
-    /**
-     * Get tool annotations for execution decisions (cache, retry).
-     * Checks cached tool list first, falls back to inference from tool name.
-     */
-    private getToolAnnotationsForExecution;
-    /**
-     * Get all available tools including custom and in-memory ones
-     * @returns Array of available tools with metadata
-     */
-    private invalidateToolCache;
-    getAllAvailableTools(): Promise<ToolInfo[]>;
-    /**
-     * Get comprehensive status of all AI providers
-     * Primary method for provider health checking and diagnostics
-     */
-    getProviderStatus(options?: {
-        quiet?: boolean;
-    }): Promise<ProviderStatus[]>;
-    /**
-     * Test a specific AI provider's connectivity and authentication
-     * @param providerName - Name of the provider to test
-     * @returns Promise resolving to true if provider is working
-     */
-    testProvider(providerName: string): Promise<boolean>;
-    /**
-     * Internal method to test provider connection with minimal generation call
-     */
-    private testProviderConnection;
-    /**
-     * Get the best available AI provider based on configuration and availability
-     * @param requestedProvider - Optional preferred provider name
-     * @returns Promise resolving to the best provider name
-     */
-    getBestProvider(requestedProvider?: string): Promise<string>;
-    /**
-     * Get list of all available AI provider names
-     * @returns Array of supported provider names
-     */
-    getAvailableProviders(): Promise<string[]>;
-    /**
-     * Validate if a provider name is supported
-     * @param providerName - Provider name to validate
-     * @returns True if provider name is valid
-     */
-    isValidProvider(providerName: string): Promise<boolean>;
-    /**
-     * Get comprehensive MCP (Model Context Protocol) status information
-     * @returns Promise resolving to MCP status details
-     */
-    getMCPStatus(): Promise<MCPStatus>;
-    /**
-     * List all configured MCP servers with their status
-     * @returns Promise resolving to array of MCP server information
-     */
-    listMCPServers(): Promise<MCPServerInfo[]>;
-    /**
-     * Test connectivity to a specific MCP server
-     * @param serverId - ID of the MCP server to test
-     * @returns Promise resolving to true if server is reachable
-     */
-    testMCPServer(serverId: string): Promise<boolean>;
-    /**
-     * Check if a provider has the required environment variables configured
-     * @param providerName - Name of the provider to check
-     * @returns Promise resolving to true if provider has required env vars
-     */
-    hasProviderEnvVars(providerName: string): Promise<boolean>;
-    /**
-     * Perform comprehensive health check on a specific provider
-     * @param providerName - Name of the provider to check
-     * @param options - Health check options
-     * @returns Promise resolving to detailed health status
-     */
-    checkProviderHealth(providerName: string, options?: {
-        timeout?: number;
-        includeConnectivityTest?: boolean;
-        includeModelValidation?: boolean;
-        cacheResults?: boolean;
-    }): Promise<{
-        provider: string;
-        isHealthy: boolean;
-        isConfigured: boolean;
-        hasApiKey: boolean;
-        lastChecked: Date;
-        error?: string;
-        warning?: string;
-        responseTime?: number;
-        configurationIssues: string[];
-        recommendations: string[];
-    }>;
-    /**
-     * Check health of all supported providers
-     * @param options - Health check options
-     * @returns Promise resolving to array of health statuses for all providers
-     */
-    checkAllProvidersHealth(options?: {
-        timeout?: number;
-        includeConnectivityTest?: boolean;
-        includeModelValidation?: boolean;
-        cacheResults?: boolean;
-    }): Promise<Array<{
-        provider: string;
-        isHealthy: boolean;
-        isConfigured: boolean;
-        hasApiKey: boolean;
-        lastChecked: Date;
-        error?: string;
-        warning?: string;
-        responseTime?: number;
-        configurationIssues: string[];
-        recommendations: string[];
-    }>>;
-    /**
-     * Get a summary of provider health across all supported providers
-     * @returns Promise resolving to health summary statistics
-     */
-    getProviderHealthSummary(): Promise<{
-        total: number;
-        healthy: number;
-        configured: number;
-        hasIssues: number;
-        healthyProviders: string[];
-        unhealthyProviders: string[];
-        recommendations: string[];
-    }>;
-    /**
-     * Clear provider health cache (useful for re-testing after configuration changes)
-     * @param providerName - Optional specific provider to clear cache for
-     */
-    clearProviderHealthCache(providerName?: string): Promise<void>;
-    /**
-     * Get execution metrics for all tools
-     * @returns Object with execution metrics for each tool
-     */
-    getToolExecutionMetrics(): Record<string, {
-        totalExecutions: number;
-        successfulExecutions: number;
-        failedExecutions: number;
-        successRate: number;
-        averageExecutionTime: number;
-        lastExecutionTime: number;
-        errorCategories: Record<string, number>;
-    }>;
-    /**
-     * NL-004: Set model alias/deprecation configuration.
-     * 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/index.js").ModelAliasConfig): void;
-    /**
-     * Get circuit breaker status for all tools
-     * @returns Object with circuit breaker status for each tool
-     */
-    getToolCircuitBreakerStatus(): Record<string, {
-        state: "closed" | "open" | "half-open";
-        failureCount: number;
-        isHealthy: boolean;
-    }>;
-    /**
-     * Reset circuit breaker for a specific tool
-     * @param toolName - Name of the tool to reset circuit breaker for
-     */
-    resetToolCircuitBreaker(toolName: string): void;
-    /**
-     * Clear all tool execution metrics
-     */
-    clearToolExecutionMetrics(): void;
-    /**
-     * Get comprehensive tool health report
-     * @returns Detailed health report for all tools
-     */
-    getToolHealthReport(): Promise<{
-        totalTools: number;
-        healthyTools: number;
-        unhealthyTools: number;
-        tools: Record<string, {
-            name: string;
-            isHealthy: boolean;
-            metrics: {
-                totalExecutions: number;
-                successRate: number;
-                averageExecutionTime: number;
-                lastExecutionTime: number;
-                errorCategories: Record<string, number>;
-            };
-            circuitBreaker: {
-                state: "closed" | "open" | "half-open";
-                failureCount: number;
-            };
-            issues: string[];
-            recommendations: string[];
-        }>;
-    }>;
-    /**
-     * Initialize conversation memory if enabled (public method for explicit initialization)
-     * This is useful for testing or when you want to ensure conversation memory is ready
-     * @returns Promise resolving to true if initialization was successful, false otherwise
-     */
-    ensureConversationMemoryInitialized(): Promise<boolean>;
-    /**
-     * Get conversation memory statistics (public API)
-     */
-    getConversationStats(): Promise<import("./types/conversation.js").ConversationMemoryStats>;
-    /**
-     * Get complete conversation history for a specific session (public API)
-     * @param sessionId - The session ID to retrieve history for
-     * @returns Array of ChatMessage objects in chronological order, or empty array if session doesn't exist
-     */
-    getConversationHistory(sessionId: string): Promise<ChatMessage[]>;
-    /**
-     * Clear conversation history for a specific session (public API)
-     */
-    clearConversationSession(sessionId: string): Promise<boolean>;
-    /**
-     * Clear all conversation history (public API)
-     */
-    clearAllConversations(): Promise<void>;
-    /**
-     * List all conversation sessions with metadata (public API)
-     * @param userId - Optional user ID to filter sessions (required for Redis storage)
-     * @returns Array of session list items with metadata
-     */
-    listSessions(userId?: string): Promise<SessionListItem[]>;
-    /**
-     * Export a single session with full history and metadata (public API)
-     * @param sessionId - The session ID to export
-     * @param options - Export options
-     * @returns Session export object with full history
-     */
-    exportSession(sessionId: string, options?: {
-        includeMetadata?: boolean;
-        format?: "json" | "csv";
-    }): Promise<SessionExport | null>;
-    /**
-     * Export all sessions for a user (public API)
-     * @param userId - Optional user ID (required for Redis storage)
-     * @param options - Export options
-     * @returns Array of session exports
-     */
-    exportAllSessions(userId?: string, options?: {
-        includeMetadata?: boolean;
-        format?: "json" | "csv";
-    }): Promise<SessionExport[]>;
-    /**
-     * Store tool executions in conversation memory if enabled and Redis is configured
-     * @param sessionId - Session identifier
-     * @param userId - User identifier (optional)
-     * @param toolCalls - Array of tool calls
-     * @param toolResults - Array of tool results
-     * @param currentTime - Date when the tool execution occurred (optional)
-     * @returns Promise resolving when storage is complete
-     */
-    storeToolExecutions(sessionId: string, userId: string | undefined, toolCalls: Array<{
-        toolCallId?: string;
-        toolName?: string;
-        args?: Record<string, unknown>;
-        [key: string]: unknown;
-    }>, toolResults: Array<{
-        toolCallId?: string;
-        result?: unknown;
-        error?: string;
-        [key: string]: unknown;
-    }>, currentTime?: Date): Promise<void>;
-    /**
-     * Check if tool execution storage is available.
-     *
-     * Now capability-based rather than Redis-specific: any configured memory
-     * backend implementing `storeToolExecution` qualifies. The old check
-     * required `STORAGE_TYPE === "redis"` AND a Redis manager by class name, so
-     * in-memory sessions reported false and silently skipped tool persistence.
-     *
-     * @returns whether the active memory backend can persist tool executions
-     */
-    isToolExecutionStorageAvailable(): boolean;
-    /**
-     * Get the raw messages array for a session.
-     * Returns the full messages list without context filtering or summarization.
-     * @param sessionId - The session ID to retrieve messages for
-     * @returns Array of ChatMessage objects, or empty array if session doesn't exist
-     */
-    getSessionMessages(sessionId: string, userId?: string): Promise<ChatMessage[]>;
-    /**
-     * Replace the entire messages array for a session.
-     * @param sessionId - The session ID to update
-     * @param messages - The new messages array
-     * @param userId - Optional user ID for scoped Redis key lookup
-     */
-    setSessionMessages(sessionId: string, messages: ChatMessage[], userId?: string): Promise<void>;
-    /**
-     * Modify the last assistant message in a session using a transformer function.
-     * Convenience wrapper around getSessionMessages/setSessionMessages.
-     * @param sessionId - The session ID to modify
-     * @param transformer - Function that receives the last assistant message content and returns the modified content
-     * @param userId - Optional user ID for scoped Redis key lookup
-     * @returns true if a message was modified, false if no assistant message was found
-     */
-    modifyLastAssistantMessage(sessionId: string, transformer: (content: string) => string, userId?: string): Promise<boolean>;
-    /**
-     * Add an external MCP server
-     * Automatically discovers and registers tools from the server
-     * @param serverId - Unique identifier for the server
-     * @param config - External MCP server configuration
-     * @returns Operation result with server instance
-     */
-    addExternalMCPServer(serverId: string, config: MCPServerInfo): Promise<ExternalMCPOperationResult<ExternalMCPServerInstance>>;
-    /**
-     * Remove an external MCP server
-     * Stops the server and removes all its tools
-     * @param serverId - ID of the server to remove
-     * @returns Operation result
-     */
-    removeExternalMCPServer(serverId: string): Promise<ExternalMCPOperationResult<void>>;
-    /**
-     * List all external MCP servers
-     * @returns Array of server health information
-     */
-    listExternalMCPServers(): Array<{
-        serverId: string;
-        status: string;
-        toolCount: number;
-        uptime: number;
-        isHealthy: boolean;
-        config: MCPServerInfo;
-    }>;
-    /**
-     * Get external MCP server status
-     * @param serverId - ID of the server
-     * @returns Server instance or undefined if not found
-     */
-    getExternalMCPServer(serverId: string): ExternalMCPServerInstance | undefined;
-    /**
-     * Execute a tool from an external MCP server
-     * @param serverId - ID of the server
-     * @param toolName - Name of the tool
-     * @param parameters - Tool parameters
-     * @param options - Execution options
-     * @returns Tool execution result
-     */
-    executeExternalMCPTool(serverId: string, toolName: string, parameters: JsonObject, options?: {
-        timeout?: number;
-    }): Promise<unknown>;
-    /**
-     * Get all tools from external MCP servers
-     * @returns Array of external tool information
-     */
-    getExternalMCPTools(): ExternalMCPToolInfo[];
-    /**
-     * Get tools from a specific external MCP server
-     * @param serverId - ID of the server
-     * @returns Array of tool information for the server
-     */
-    getExternalMCPServerTools(serverId: string): ExternalMCPToolInfo[];
-    /**
-     * Test connection to an external MCP server
-     * @param config - Server configuration to test
-     * @returns Test result with connection status
-     */
-    testExternalMCPConnection(config: MCPServerInfo): Promise<BatchOperationResult>;
-    /**
-     * Get external MCP server manager statistics
-     * @returns Statistics about external servers and tools
-     */
-    getExternalMCPStatistics(): {
-        totalServers: number;
-        connectedServers: number;
-        failedServers: number;
-        totalTools: number;
-        totalConnections: number;
-        totalErrors: number;
-    };
-    /**
-     * Shutdown all external MCP servers
-     * Called automatically on process exit
-     */
-    shutdownExternalMCPServers(): Promise<void>;
-    /**
-     * Get the global elicitation manager for interactive tool input
-     * Elicitation allows tools to request additional information from users during execution
-     * @returns The global ElicitationManager instance
-     * @example
-     * ```typescript
-     * const elicitationManager = neurolink.getElicitationManager();
-     *
-     * // Register a handler for confirmations
-     * elicitationManager.registerHandler(async (request) => {
-     *   if (request.type === 'confirmation') {
-     *     const answer = await askUser(request.message);
-     *     return { confirmed: answer === 'yes' };
-     *   }
-     * });
-     * ```
-     */
-    getElicitationManager(): Promise<any>;
-    /**
-     * Register an elicitation handler for interactive tool input
-     * Handlers are called when tools need user input during execution
-     * @param handler - Function to handle elicitation requests
-     * @example
-     * ```typescript
-     * neurolink.registerElicitationHandler(async (request) => {
-     *   switch (request.type) {
-     *     case 'confirmation':
-     *       return { confirmed: await confirmWithUser(request.message) };
-     *     case 'text':
-     *       return { value: await promptUser(request.message) };
-     *     case 'select':
-     *       return { value: await selectFromOptions(request.options) };
-     *   }
-     * });
-     * ```
-     */
-    registerElicitationHandler(handler: (request: unknown) => Promise<unknown>): Promise<void>;
-    /**
-     * Get the multi-server manager for load balancing and coordination
-     * Allows managing multiple MCP servers with failover and load balancing
-     * @returns The global MultiServerManager instance
-     * @example
-     * ```typescript
-     * const multiServer = neurolink.getMultiServerManager();
-     *
-     * // Create a server group with load balancing
-     * await multiServer.createServerGroup('ai-tools', {
-     *   servers: ['openai-server', 'anthropic-server'],
-     *   strategy: 'round-robin'
-     * });
-     * ```
-     */
-    getMultiServerManager(): Promise<any>;
-    /**
-     * Get the enhanced tool discovery service
-     * Provides advanced search, filtering, and compatibility checking for tools
-     * @returns EnhancedToolDiscovery instance
-     * @example
-     * ```typescript
-     * const discovery = neurolink.getEnhancedToolDiscovery();
-     *
-     * // Search for tools by criteria
-     * const results = await discovery.searchTools({
-     *   category: 'data-processing',
-     *   capabilities: ['streaming', 'batch'],
-     *   minReliability: 0.9
-     * });
-     * ```
-     */
-    getEnhancedToolDiscovery(): Promise<any>;
-    /**
-     * Get the MCP registry client for discovering servers from registries
-     * Supports multiple registry sources (official, community, custom)
-     * @returns The global MCPRegistryClient instance
-     * @example
-     * ```typescript
-     * const registryClient = neurolink.getMCPRegistryClient();
-     *
-     * // Search for servers
-     * const servers = await registryClient.searchServers({
-     *   query: 'database',
-     *   categories: ['data', 'storage']
-     * });
-     *
-     * // Get a well-known server config
-     * const githubServer = registryClient.getWellKnownServer('github');
-     * ```
-     */
-    getMCPRegistryClient(): Promise<any>;
-    /**
-     * Expose a NeuroLink agent as an MCP tool
-     * This allows agents to be called by other systems via MCP
-     * @param agent - The agent to expose (must include id, name, description, and execute)
-     * @param options - Exposure configuration options (prefix, defaultAnnotations, etc.)
-     * @returns The exposed tool definition
-     * @example
-     * ```typescript
-     * const agent = {
-     *   id: 'my-agent',
-     *   name: 'My Agent',
-     *   description: 'An agent that processes data',
-     *   execute: async (params) => { ... }
-     * };
-     * const tool = await neurolink.exposeAgentAsTool(agent, {
-     *   prefix: 'agent_'
-     * });
-     * ```
-     */
-    exposeAgentAsTool(agent: {
-        id: string;
-        name: string;
-        description: string;
-        execute: (params: unknown, context?: unknown) => Promise<unknown>;
-    }, options?: {
-        prefix?: string;
-        includeMetadataInDescription?: boolean;
-        wrapWithContext?: boolean;
-        executionTimeout?: number;
-        enableLogging?: boolean;
-    }): Promise<import("./types/mcp.js").ExposureResult>;
-    /**
-     * Expose a workflow as an MCP tool
-     * This allows workflows to be called by other systems via MCP
-     * @param workflow - The workflow to expose (must include id, name, description, and execute)
-     * @param options - Exposure configuration options (prefix, defaultAnnotations, etc.)
-     * @returns The exposed tool definition
-     * @example
-     * ```typescript
-     * const workflow = {
-     *   id: 'data-pipeline',
-     *   name: 'Data Pipeline',
-     *   description: 'Runs the data processing pipeline',
-     *   execute: async (params) => { ... }
-     * };
-     * const tool = await neurolink.exposeWorkflowAsTool(workflow, {
-     *   prefix: 'workflow_'
-     * });
-     * ```
-     */
-    exposeWorkflowAsTool(workflow: {
-        id: string;
-        name: string;
-        description: string;
-        execute: (params: unknown, context?: unknown) => Promise<unknown>;
-        steps?: Array<{
-            id: string;
-            name: string;
-            description?: string;
-        }>;
-    }, options?: {
-        prefix?: string;
-        includeMetadataInDescription?: boolean;
-        wrapWithContext?: boolean;
-        executionTimeout?: number;
-        enableLogging?: boolean;
-    }): Promise<import("./types/mcp.js").ExposureResult>;
-    /**
-     * Get the tool integration manager for middleware and elicitation
-     * Provides advanced tool wrapping with confirmation, timeout, retry, etc.
-     * @returns The global ToolIntegrationManager instance
-     * @example
-     * ```typescript
-     * const integration = neurolink.getToolIntegrationManager();
-     *
-     * // Register a tool with middleware
-     * integration.registerTool(myTool, {
-     *   timeout: 30000,
-     *   retries: 3,
-     *   requireConfirmation: true
-     * });
-     * ```
-     */
-    getToolIntegrationManager(): Promise<any>;
-    /**
-     * Convert NeuroLink tools to MCP format
-     * Useful for exposing local tools to external MCP clients
-     * @param tools - Array of NeuroLink tool definitions
-     * @param options - Conversion options
-     * @returns Array of MCP-formatted tools
-     * @example
-     * ```typescript
-     * const mcpTools = neurolink.convertToolsToMCPFormat([
-     *   { name: 'myTool', description: 'Does something', execute: async () => {} }
-     * ]);
-     * ```
-     */
-    convertToolsToMCPFormat(tools: Array<{
-        name: string;
-        description: string;
-        execute?: (params: unknown) => unknown;
-    }>, options?: {
-        namespacePrefix?: string;
-    }): Promise<any>;
-    /**
-     * Convert MCP tools to NeuroLink format
-     * Useful for importing tools from external MCP servers
-     * @param tools - Array of MCP tool definitions
-     * @param options - Conversion options
-     * @returns Array of NeuroLink-formatted tools
-     * @example
-     * ```typescript
-     * const neurolinkTools = neurolink.convertToolsFromMCPFormat(externalTools, {
-     *   removeNamespacePrefix: 'external_'
-     * });
-     * ```
-     */
-    convertToolsFromMCPFormat(tools: Array<{
-        name: string;
-        description: string;
-        inputSchema?: unknown;
-    }>, options?: {
-        removeNamespacePrefix?: string;
-    }): Promise<any>;
-    /**
-     * Get tool annotations and safety information
-     * Provides insights about tool behavior, safety levels, and retry-ability
-     * @param toolName - Name of the tool to analyze
-     * @returns Tool annotation summary
-     * @example
-     * ```typescript
-     * const annotations = await neurolink.getToolAnnotations('deleteFile');
-     * // Returns: { destructive: true, requiresConfirmation: true, safeToRetry: false }
-     * ```
-     */
-    getToolAnnotations(toolName: string): Promise<{
-        annotations: MCPToolAnnotations;
-        summary: string;
-    } | null>;
-    /**
-     * Convert external MCP tools to Vercel AI SDK tool format
-     * This allows AI providers to use external tools directly
-     */
-    private convertExternalMCPToolsToAISDKFormat;
-    /**
-     * Convert JSON Schema to AI SDK compatible format
-     * For now, we'll skip schema validation and let the AI SDK handle parameters dynamically
-     */
-    private convertJSONSchemaToAISDKFormat;
-    /**
-     * Unregister external MCP tools from a specific server
-     */
-    private unregisterExternalMCPToolsFromRegistry;
-    /**
-     * Unregister a specific external MCP tool from the main registry
-     */
-    private unregisterExternalMCPToolFromRegistry;
-    /**
-     * Lazily initialize conversation memory when needed
-     * This is called the first time a generate or stream operation is performed
-     */
-    private lazyInitializeConversationMemory;
-    /**
-     * Unregister all external MCP tools from the main registry
-     */
-    private unregisterAllExternalMCPToolsFromRegistry;
-    /**
-     * Create an evaluation pipeline with the specified configuration or preset.
-     * Pipelines orchestrate multiple scorers to evaluate AI responses comprehensively.
-     *
-     * @param configOrPreset - Pipeline configuration object or preset name
-     * @returns Initialized evaluation pipeline
-     *
-     * @example Using a preset
-     * ```typescript
-     * const neurolink = new NeuroLink();
-     * const pipeline = await neurolink.createEvaluationPipeline('rag');
-     * const result = await pipeline.execute({
-     *   query: 'What is the capital of France?',
-     *   response: 'Paris is the capital of France.',
-     *   context: ['France is a country in Europe. Paris is its capital.']
-     * });
-     * console.log(result.overallScore, result.passed);
-     * ```
-     *
-     * @example Using custom configuration
-     * ```typescript
-     * const pipeline = await neurolink.createEvaluationPipeline({
-     *   name: 'custom-quality',
-     *   scorers: [
-     *     { id: 'toxicity', config: { threshold: 0.9 } },
-     *     { id: 'hallucination', config: { weight: 1.5 } },
-     *     { id: 'answer-relevancy' }
-     *   ],
-     *   aggregation: { method: 'weighted' },
-     *   passThreshold: 0.8
-     * });
-     * ```
-     */
-    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.
-     *
-     * @param input - Scorer input containing query, response, and optional context
-     * @param options - Evaluation options including pipeline preset or custom scorers
-     * @returns Evaluation pipeline result with scores and pass/fail status
-     *
-     * @example Using a preset
-     * ```typescript
-     * const neurolink = new NeuroLink();
-     * const result = await neurolink.evaluate(
-     *   {
-     *     query: 'Explain quantum computing',
-     *     response: 'Quantum computing uses qubits...'
-     *   },
-     *   { pipeline: 'quality' }
-     * );
-     * console.log(`Score: ${result.overallScore}, Passed: ${result.passed}`);
-     * ```
-     *
-     * @example Using specific scorers
-     * ```typescript
-     * const result = await neurolink.evaluate(
-     *   {
-     *     query: 'What causes rain?',
-     *     response: 'Rain is caused by water vapor...',
-     *     context: ['The water cycle involves evaporation...']
-     *   },
-     *   { scorers: ['hallucination', 'faithfulness', 'answer-relevancy'] }
-     * );
-     * ```
-     *
-     * @example Full RAG evaluation
-     * ```typescript
-     * const result = await neurolink.evaluate(
-     *   {
-     *     query: 'Who wrote Hamlet?',
-     *     response: 'Shakespeare wrote Hamlet in 1600.',
-     *     context: ['William Shakespeare wrote Hamlet around 1600-1601.'],
-     *     groundTruth: 'William Shakespeare'
-     *   },
-     *   { pipeline: 'rag' }
-     * );
-     * ```
-     */
-    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) */
-        scorers?: string[];
-        /** Pass threshold override (0-1) */
-        passThreshold?: number;
-        /** Execution mode */
-        executionMode?: "parallel" | "sequential";
-        /** Correlation ID for tracing */
-        correlationId?: string;
-        /** Overall evaluation timeout in milliseconds */
-        timeoutMs?: number;
-    }): 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.
-     *
-     * @param scorerId - The ID of the scorer to use (e.g., 'toxicity', 'hallucination')
-     * @param input - Scorer input containing query, response, and optional context
-     * @param config - Optional scorer configuration overrides
-     * @returns Score result with value, reasoning, and pass/fail status
-     *
-     * @example Basic scoring
-     * ```typescript
-     * const neurolink = new NeuroLink();
-     * const result = await neurolink.score('toxicity', {
-     *   query: '',
-     *   response: 'This is a helpful response about cooking recipes.'
-     * });
-     * console.log(`Toxicity Score: ${result.score}/10, Passed: ${result.passed}`);
-     * ```
-     *
-     * @example Hallucination detection
-     * ```typescript
-     * const result = await neurolink.score('hallucination', {
-     *   query: 'What year was the Eiffel Tower built?',
-     *   response: 'The Eiffel Tower was built in 1889.',
-     *   context: ['The Eiffel Tower was constructed from 1887-1889.']
-     * });
-     * console.log(`Score: ${result.score}, Reasoning: ${result.reasoning}`);
-     * ```
-     *
-     * @example With custom threshold
-     * ```typescript
-     * const result = await neurolink.score(
-     *   'faithfulness',
-     *   {
-     *     query: 'Summarize the article',
-     *     response: 'The article discusses...',
-     *     context: ['Article content here...']
-     *   },
-     *   { threshold: 0.85, weight: 1.5 }
-     * );
-     * ```
-     */
-    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.
-     *
-     * @param options - Filter options
-     * @returns Array of scorer metadata
-     *
-     * @example List all scorers
-     * ```typescript
-     * const neurolink = new NeuroLink();
-     * const scorers = await neurolink.getAvailableScorers();
-     * for (const scorer of scorers) {
-     *   console.log(`${scorer.id}: ${scorer.description} (${scorer.type})`);
-     * }
-     * ```
-     *
-     * @example Filter by category
-     * ```typescript
-     * const safetyScorers = await neurolink.getAvailableScorers({
-     *   category: 'safety'
-     * });
-     * console.log('Safety scorers:', safetyScorers.map(s => s.id));
-     * ```
-     *
-     * @example Filter by type
-     * ```typescript
-     * const ruleBasedScorers = await neurolink.getAvailableScorers({
-     *   type: 'rule'
-     * });
-     * ```
-     */
-    getAvailableScorers(options?: {
-        /** Filter by category */
-        category?: import("./types/index.js").ScorerCategory;
-        /** Filter by type */
-        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.
-     *
-     * @returns Array of preset names
-     *
-     * @example
-     * ```typescript
-     * const neurolink = new NeuroLink();
-     * const presets = await neurolink.getEvaluationPresets();
-     * console.log('Available presets:', presets);
-     * // Output: ['safety', 'rag', 'quality', 'comprehensive', 'minimal', ...]
-     * ```
-     */
-    getEvaluationPresets(): Promise<string[]>;
-    /**
-     * Get details of a specific evaluation preset.
-     *
-     * @param presetName - Name of the preset
-     * @returns Pipeline configuration for the preset
-     *
-     * @example
-     * ```typescript
-     * const neurolink = new NeuroLink();
-     * const ragPreset = await neurolink.getEvaluationPreset('rag');
-     * console.log('RAG preset scorers:', ragPreset.scorers.map(s => s.id));
-     * console.log('Pass threshold:', ragPreset.passThreshold);
-     * ```
-     */
-    getEvaluationPreset(presetName: "safety" | "rag" | "quality" | "comprehensive" | "minimal" | "summarization" | "customerSupport" | "codeGeneration"): Promise<import("./types/index.js").PipelineConfig>;
-    /**
-     * Create an Agent instance for multi-agent orchestration.
-     *
-     * Agents are specialized AI entities with defined instructions, tools, and behavior.
-     * They can be composed into networks for complex task orchestration.
-     *
-     * @param definition - Agent definition specifying behavior and capabilities
-     * @returns A new Agent instance
-     *
-     * @example
-     * ```typescript
-     * const researcher = neurolink.createAgent({
-     *   id: 'researcher',
-     *   name: 'Research Agent',
-     *   description: 'Searches and analyzes information from various sources',
-     *   instructions: 'You are a research assistant. Search thoroughly and cite sources.',
-     *   tools: ['websearchGrounding', 'readFile'],
-     *   model: 'gpt-4o'
-     * });
-     *
-     * const result = await researcher.execute('Find recent AI breakthroughs');
-     * ```
-     *
-     * @see {@link AgentDefinition} for definition options
-     * @see {@link Agent} for agent methods
-     * @since 8.38.0
-     */
-    createAgent(definition: AgentDefinition): Promise<import("./agent/agent.js").Agent>;
-    /**
-     * Create an AgentNetwork for multi-agent orchestration.
-     *
-     * Networks coordinate multiple agents, workflows, and tools with intelligent
-     * LLM-powered routing. The router agent analyzes tasks and delegates to
-     * the most appropriate primitive.
-     *
-     * @param config - Network configuration with agents, workflows, and routing settings
-     * @returns A new AgentNetwork instance
-     *
-     * @example
-     * ```typescript
-     * const network = neurolink.createNetwork({
-     *   name: 'Content Team',
-     *   description: 'Collaborative content creation pipeline',
-     *   agents: [
-     *     {
-     *       id: 'researcher',
-     *       name: 'Researcher',
-     *       description: 'Finds and verifies information',
-     *       instructions: 'Research topics thoroughly...',
-     *     },
-     *     {
-     *       id: 'writer',
-     *       name: 'Writer',
-     *       description: 'Creates engaging content',
-     *       instructions: 'Write clear, engaging content...',
-     *     },
-     *     {
-     *       id: 'editor',
-     *       name: 'Editor',
-     *       description: 'Reviews and improves content',
-     *       instructions: 'Review for clarity and accuracy...',
-     *     }
-     *   ],
-     *   router: {
-     *     model: 'gpt-4o',
-     *     confidenceThreshold: 0.7
-     *   }
-     * });
-     *
-     * const result = await network.execute({
-     *   message: 'Write an article about quantum computing'
-     * });
-     * ```
-     *
-     * @see {@link AgentNetworkConfig} for configuration options
-     * @see {@link AgentNetwork} for network methods
-     * @since 8.38.0
-     */
-    createNetwork(config: AgentNetworkConfig): Promise<import("./agent/agentNetwork.js").AgentNetwork>;
-    /**
-     * Create a worker-mode NeuroLink instance for sub-agent execution.
-     *
-     * Worker mode is the framework-provided version of the config block every
-     * consumer used to copy by hand: conversation memory OFF, orchestration
-     * OFF, observability inherited from this instance with
-     * `autoDetectExternalProvider: true` + `skipLangfuseSpanProcessor: true`
-     * (worker spans join the host's tracer without duplicate Langfuse
-     * exports), credentials inherited, the host's tool registry shared (so
-     * worker tool calls reuse the host's connections), and an internal log
-     * bridge attached with a caller-supplied tag.
-     *
-     * Dispose the worker (`worker.dispose()`) when done — `runIsolatedAgent`
-     * does this automatically in a `finally`.
-     *
-     * @param options - Worker options (log tag/sink, registry sharing, config)
-     * @returns A new worker-mode NeuroLink instance
-     * @see {@link WorkerInstanceOptions}
-     */
-    createWorkerInstance(options?: WorkerInstanceOptions): NeuroLink;
-    /**
-     * Run an isolated sub-agent: a worker instance (see
-     * {@link createWorkerInstance}) executes a tool-using research pass under
-     * the turn budget (wrap-up nudge, stall watchdog, honest `stopReason`),
-     * then an extraction pass ALWAYS runs tools-off on its own timeout with a
-     * structured-recovery ladder and corrective re-asks. A non-empty execution
-     * record never produces an empty result (mechanical digest fallback), a
-     * parent `abortSignal` stops everything cleanly, and `options.leg` enables
-     * leashed mode with TTL'd resume handles ({@link continueAgent} /
-     * {@link stopAgent}).
-     *
-     * @param definition - Agent definition (+ optional structured extraction)
-     * @param input - Task input: string or structured object
-     * @param options - Run options (abort, overrides, tool context, events, leg)
-     * @returns The run outcome
-     * @see {@link IsolatedAgentDefinition}
-     * @see {@link AgentRunOptions}
-     * @see {@link AgentRunOutcome}
-     */
-    runIsolatedAgent(definition: IsolatedAgentDefinition, input: string | Record<string, unknown>, options?: AgentRunOptions): Promise<AgentRunOutcome>;
-    /**
-     * Resume a leashed isolated-agent run by handle. `guidance`, when given,
-     * is appended as a user turn before the next leg — the supervisor's
-     * re-steering channel. An expired handle returns its tombstoned final
-     * outcome exactly once.
-     *
-     * @param handle - Handle from an `in_progress` {@link AgentRunOutcome}
-     * @param guidance - Optional supervisor guidance for the next leg
-     * @returns The next leg's outcome (or the final outcome)
-     */
-    continueAgent(handle: string, guidance?: string): Promise<AgentRunOutcome>;
-    /**
-     * Stop a leashed isolated-agent run: dispose its worker and return the
-     * final outcome (mechanical digest over everything gathered so far).
-     *
-     * @param handle - Handle from an `in_progress` {@link AgentRunOutcome}
-     * @returns The final outcome
-     */
-    stopAgent(handle: string): Promise<AgentRunOutcome>;
-    /**
-     * Register an isolated agent as a delegation tool on THIS instance, so
-     * its existing generate() loop can delegate — no second router generate.
-     * Framework policy (per-turn caps, depth withholding, a process-wide
-     * concurrency pool with queue timeout) is enforced in the loop itself,
-     * and every refusal carries its recovery instruction in the error text.
-     *
-     * @param definition - Agent definition (+ optional structured extraction)
-     * @param options - Registration options (name, caps, depth, pool, leg)
-     * @returns The registered tool name
-     * @see {@link AgentToolRegistrationOptions}
-     */
-    registerAgentTool(definition: IsolatedAgentDefinition, options?: AgentToolRegistrationOptions): Promise<{
-        name: string;
-    }>;
-    /**
-     * Execute an agent network with the given input.
-     *
-     * @param network - The agent network to execute
-     * @param input - Execution input (message and context)
-     * @param options - Optional execution options
-     * @returns Network execution result with content, trace, and usage
-     *
-     * @see {@link NetworkExecutionInput} for input options
-     * @see {@link NetworkExecutionResult} for result structure
-     * @since 8.38.0
-     */
-    executeNetwork(network: import("./agent/agentNetwork.js").AgentNetwork, input: NetworkExecutionInput, options?: NetworkExecutionOptions): Promise<NetworkExecutionResult>;
-    /**
-     * Stream agent network execution with real-time events.
-     *
-     * @param network - The agent network to stream
-     * @param input - Execution input (message and context)
-     * @param options - Optional execution options
-     * @returns Async iterable of network stream chunks
-     *
-     * @see {@link NetworkStreamChunk} for chunk types
-     * @since 8.38.0
-     */
-    streamNetwork(network: import("./agent/agentNetwork.js").AgentNetwork, input: NetworkExecutionInput, options?: NetworkExecutionOptions): AsyncIterable<NetworkStreamChunk>;
-    /**
-     * Create a NetworkOrchestrator for managing multiple agent networks.
-     *
-     * @param config - Orchestrator configuration options
-     * @returns A new NetworkOrchestrator instance
-     * @since 8.38.0
-     */
-    createOrchestrator(config?: import("./types/index.js").OrchestratorConfig): Promise<import("./agent/orchestration/index.js").NetworkOrchestrator>;
-    /**
-     * Create an AgentCoordinator for managing agent coordination strategies.
-     *
-     * @param config - Coordinator configuration options
-     * @returns A new AgentCoordinator instance
-     * @since 8.38.0
-     */
-    createCoordinator(config?: import("./types/index.js").CoordinatorConfig): Promise<import("./agent/coordination/index.js").AgentCoordinator>;
-    /**
-     * Create a MessageBus for inter-agent communication.
-     *
-     * @param config - Message bus configuration options
-     * @returns A new MessageBus instance
-     * @since 8.38.0
-     */
-    createMessageBus(config?: import("./types/index.js").MessageBusConfig): Promise<import("./agent/communication/index.js").MessageBus>;
-    /**
-     * Dispose of all resources and cleanup connections
-     * Call this method when done using the NeuroLink instance to prevent resource leaks
-     * Especially important in test environments where multiple instances are created
-     */
-    dispose(): Promise<void>;
-    /**
-     * Get the tool registry instance
-     * Used internally by server adapters for tool management
-     * @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;
-    /**
-     * Set the authentication provider for the NeuroLink instance
-     *
-     * @param config - Auth provider or configuration to create one
-     */
-    setAuthProvider(config: NeuroLinkAuthConfig): Promise<void>;
-    private initializeAuthProviderFromConfig;
-    /**
-     * Get the currently configured authentication provider
-     */
-    getAuthProvider(): AuthProvider | undefined;
-    /**
-     * Lazily initialize the auth provider from pendingAuthConfig.
-     * Called on first use (generate/stream with auth token) to avoid
-     * async work in the synchronous constructor.
-     */
-    private ensureAuthProvider;
-    /**
-     * Set the current authentication context for request handling.
-     *
-     * Delegates to the global AuthContextHolder so that auth state is NOT
-     * stored as an instance field (which would leak between concurrent requests
-     * sharing the same NeuroLink singleton). Prefer `runWithAuthContext()` from
-     * `authContext.ts` for proper request-scoped context via AsyncLocalStorage.
-     *
-     * @param context - The authenticated user context
-     */
-    setAuthContext(context: AuthenticatedContext): Promise<void>;
-    /**
-     * Get the current authentication context.
-     *
-     * Checks AsyncLocalStorage first, then falls back to the global holder.
-     */
-    getAuthContext(): Promise<AuthenticatedContext | undefined>;
-    /**
-     * Clear the current authentication context
-     */
-    clearAuthContext(): Promise<void>;
-    /**
-     * Get the external server manager instance
-     * Used internally by server adapters for external MCP server management
-     * @returns The ExternalServerManager instance
-     */
-    getExternalServerManager(): ExternalServerManager;
-    private buildResolutionContext;
-    /**
-     * Resolve dynamic arguments in GenerateOptions, mutating the options in place.
-     * Only resolves fields that are functions; static values pass through unchanged.
-     */
-    private resolveDynamicOptions;
-    private resolveDynamicFields;
-}
-export declare const neurolink: NeuroLink;
-export default neurolink;