@juspay/neurolink 6.1.0 → 6.2.1

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

@@ -1,302 +0,0 @@
-/**
- * NeuroLink MCP Tool Orchestration Engine
- * Central orchestrator for coordinated tool execution with pipeline management
- * Coordinates factory, registry, context, and AI tools for seamless operation
- * Now with semaphore-based race condition prevention
- */
-import type { ToolResult } from "./factory.js";
-import type { JsonValue, UnknownRecord } from "../types/common.js";
-import { MCPToolRegistry, type ToolExecutionOptions } from "./tool-registry.js";
-import { ContextManager, type ContextRequest } from "./context-manager.js";
-import { SemaphoreManager } from "./semaphore-manager.js";
-import { SessionManager, type OrchestratorSession, type SessionOptions } from "./session-manager.js";
-import { ErrorManager } from "./error-manager.js";
-import { HealthMonitor, type HealthMonitorOptions } from "./health-monitor.js";
-import { TransportManager, type TransportConfig, type TransportManagerOptions } from "./transport-manager.js";
-/**
- * Pipeline execution options
- */
-export interface PipelineOptions {
-    stopOnError?: boolean;
-    parallel?: boolean;
-    timeout?: number;
-    trackMetrics?: boolean;
-    validateInputs?: boolean;
-}
-/**
- * Tool execution step in a pipeline
- */
-export interface PipelineStep {
-    toolName: string;
-    params: JsonValue;
-    options?: ToolExecutionOptions;
-    dependsOn?: string[];
-    stepId?: string;
-}
-/**
- * Pipeline execution result
- */
-export interface PipelineResult {
-    success: boolean;
-    results: Map<string, ToolResult>;
-    errors: Map<string, string>;
-    executionTime: number;
-    stepsExecuted: number;
-    stepsSkipped: number;
-    metadata: {
-        pipelineId: string;
-        sessionId: string;
-        timestamp: number;
-        parallel: boolean;
-    };
-}
-/**
- * Text generation pipeline result
- */
-export interface TextPipelineResult {
-    success: boolean;
-    text?: string;
-    provider?: string;
-    model?: string;
-    executionTime: number;
-    usage?: {
-        tokens?: number;
-        cost?: number;
-    };
-    metadata: {
-        sessionId: string;
-        timestamp: number;
-        toolsUsed: string[];
-    };
-}
-/**
- * NeuroLink MCP Tool Orchestrator
- * Central coordination engine for tool execution, pipelines, and AI operations
- */
-export declare class MCPOrchestrator {
-    protected registry: MCPToolRegistry;
-    protected contextManager: ContextManager;
-    protected semaphoreManager: SemaphoreManager;
-    protected sessionManager: SessionManager;
-    protected errorManager: ErrorManager;
-    protected healthMonitor: HealthMonitor | null;
-    protected transportManager: TransportManager | null;
-    protected pipelineCounter: number;
-    constructor(registry?: MCPToolRegistry, contextManager?: ContextManager, semaphoreManager?: SemaphoreManager, sessionManager?: SessionManager, errorManager?: ErrorManager);
-    /**
-     * Initialize with default servers (AI Core)
-     */
-    private initializeDefaultServers;
-    /**
-     * Execute a single tool with full orchestration
-     *
-     * @param toolName Tool name to execute
-     * @param params Tool parameters
-     * @param contextRequest Context creation request
-     * @param options Execution options
-     * @returns Tool execution result
-     */
-    executeTool(toolName: string, params: JsonValue, contextRequest?: ContextRequest, options?: ToolExecutionOptions & {
-        sessionOptions?: SessionOptions;
-    }): Promise<ToolResult>;
-    /**
-     * Execute a pipeline of tools with dependency management
-     *
-     * @param steps Pipeline steps to execute
-     * @param contextRequest Context creation request
-     * @param options Pipeline execution options
-     * @returns Pipeline execution result
-     */
-    executePipeline(steps: PipelineStep[], contextRequest?: ContextRequest, options?: PipelineOptions): Promise<PipelineResult>;
-    /**
-     * Execute AI text generation pipeline (high-level convenience method)
-     *
-     * @param prompt Text prompt for generation
-     * @param contextRequest Context creation request
-     * @param options Additional generation options
-     * @returns Text generation result
-     */
-    executeTextPipeline(prompt: string, contextRequest?: ContextRequest, options?: {
-        provider?: string;
-        model?: string;
-        temperature?: number;
-        maxTokens?: number;
-        systemPrompt?: string;
-        customTools?: string[];
-    }): Promise<TextPipelineResult>;
-    /**
-     * Get orchestrator statistics
-     *
-     * @returns Comprehensive orchestrator statistics
-     */
-    getStats(): {
-        registry: UnknownRecord;
-        context: UnknownRecord;
-        session: UnknownRecord;
-        error: UnknownRecord;
-        health?: UnknownRecord;
-        orchestrator: {
-            pipelinesExecuted: number;
-        };
-    };
-    /**
-     * Get session by ID
-     *
-     * @param sessionId Session identifier
-     * @param extend Whether to extend session expiration
-     * @returns Session or null if not found
-     */
-    getSession(sessionId: string, extend?: boolean): Promise<OrchestratorSession | null>;
-    /**
-     * Create a new session for continuous tool calling
-     *
-     * @param contextRequest Context creation request
-     * @param sessionOptions Session configuration options
-     * @returns Created session
-     */
-    createSession(contextRequest?: ContextRequest, sessionOptions?: SessionOptions): Promise<OrchestratorSession>;
-    /**
-     * Set session state value
-     *
-     * @param sessionId Session identifier
-     * @param key State key
-     * @param value State value
-     * @returns Success status
-     */
-    setSessionState(sessionId: string, key: string, value: JsonValue): Promise<boolean>;
-    /**
-     * Get session state value
-     *
-     * @param sessionId Session identifier
-     * @param key State key
-     * @returns State value or undefined
-     */
-    getSessionState(sessionId: string, key: string): Promise<JsonValue | undefined>;
-    /**
-     * Get all active sessions
-     *
-     * @returns Array of active sessions
-     */
-    getActiveSessions(): Promise<OrchestratorSession[]>;
-    /**
-     * Clean up expired sessions
-     *
-     * @returns Number of sessions cleaned
-     */
-    cleanupSessions(): Promise<number>;
-    /**
-     * Get error history
-     *
-     * @param filter Optional filter criteria
-     * @returns Filtered error history
-     */
-    getErrorHistory(filter?: Parameters<ErrorManager["getErrorHistory"]>[0]): import("./error-manager.js").ErrorEntry[];
-    /**
-     * Clear error history
-     */
-    clearErrorHistory(): void;
-    /**
-     * Get recovery suggestion for last error
-     *
-     * @param sessionId Optional session ID to get last error from
-     * @returns Recovery suggestion or null
-     */
-    getLastErrorRecovery(sessionId?: string): string | null;
-    /**
-     * Initialize health monitoring
-     *
-     * @param options Health monitor options
-     */
-    initializeHealthMonitor(options?: HealthMonitorOptions): void;
-    /**
-     * Start health monitoring for all registered servers
-     */
-    startHealthMonitoring(): void;
-    /**
-     * Stop health monitoring
-     */
-    stopHealthMonitoring(): void;
-    /**
-     * Register recovery callback for a server
-     *
-     * @param serverId Server ID
-     * @param callback Recovery callback
-     */
-    registerRecoveryCallback(serverId: string, callback: (serverId: string) => Promise<void>): void;
-    /**
-     * Get health status for all servers
-     *
-     * @returns Map of server health status
-     */
-    getHealthStatus(): Map<any, any>;
-    /**
-     * Initialize transport manager for MCP connections
-     *
-     * @param options Transport manager options
-     */
-    initializeTransportManager(options?: TransportManagerOptions): void;
-    /**
-     * Connect to MCP server using specified transport
-     *
-     * @param config Transport configuration
-     * @returns Connected MCP client
-     */
-    connectTransport(config: TransportConfig): Promise<unknown>;
-    /**
-     * Disconnect from MCP server
-     */
-    disconnectTransport(): Promise<void>;
-    /**
-     * Get transport connection status
-     */
-    getTransportStatus(): import("./transport-manager.js").TransportStatus;
-    /**
-     * Check if transport is connected
-     */
-    isTransportConnected(): boolean;
-    /**
-     * Execute parallel pipeline with dependency management
-     *
-     * @private
-     */
-    private executeParallelPipeline;
-    /**
-     * Generate unique pipeline ID
-     *
-     * @private
-     */
-    private generatePipelineId;
-}
-/**
- * Default orchestrator instance
- * Ready-to-use orchestrator with pre-configured registry and context manager
- */
-export declare const defaultOrchestrator: MCPOrchestrator;
-/**
- * Utility function to execute tool with default orchestrator
- *
- * @param toolName Tool name to execute
- * @param params Tool parameters
- * @param contextRequest Context creation request
- * @param options Execution options
- * @returns Tool execution result
- */
-export declare function executeTool(toolName: string, params: JsonValue, contextRequest?: ContextRequest, options?: ToolExecutionOptions): Promise<ToolResult>;
-/**
- * Utility function to execute text generation pipeline
- *
- * @param prompt Text prompt for generation
- * @param contextRequest Context creation request
- * @param options Generation options
- * @returns Text generation result
- */
-export declare function executeTextPipeline(prompt: string, contextRequest?: ContextRequest, options?: UnknownRecord): Promise<TextPipelineResult>;
-/**
- * Utility function to execute pipeline with default orchestrator
- *
- * @param steps Pipeline steps
- * @param contextRequest Context creation request
- * @param options Pipeline options
- * @returns Pipeline execution result
- */
-export declare function executePipeline(steps: PipelineStep[], contextRequest?: ContextRequest, options?: PipelineOptions): Promise<PipelineResult>;