@juspay/neurolink 6.0.0 → 6.2.0

package/dist/lib/mcp/health-monitor.d.ts

@@ -1,257 +0,0 @@
-/**
- * NeuroLink MCP Health Monitoring System
- * Provides periodic health checks, connection status tracking, and auto-recovery
- * Based on health monitoring patterns from Cline
- */
-import type { MCPRegistry } from "./registry.js";
-import type { Unknown } from "../types/common.js";
-import { ErrorManager } from "./error-manager.js";
-/**
- * Connection status states
- */
-export declare enum ConnectionStatus {
-    DISCONNECTED = "DISCONNECTED",
-    CONNECTING = "CONNECTING",
-    CONNECTED = "CONNECTED",
-    CHECKING = "CHECKING",
-    ERROR = "ERROR",
-    RECOVERING = "RECOVERING"
-}
-/**
- * Health check result
- */
-export interface HealthCheckResult {
-    success: boolean;
-    status: ConnectionStatus;
-    message?: string;
-    latency?: number;
-    error?: Error;
-    timestamp: number;
-}
-/**
- * Server health information
- */
-export interface ServerHealth {
-    serverId: string;
-    status: ConnectionStatus;
-    lastCheck?: HealthCheckResult;
-    checkCount: number;
-    errorCount: number;
-    lastSuccessfulCheck?: number;
-    recoveryAttempts: number;
-    nextCheckTime?: number;
-}
-/**
- * Health monitor configuration
- */
-export interface HealthMonitorOptions {
-    checkInterval?: number;
-    checkTimeout?: number;
-    maxRecoveryAttempts?: number;
-    recoveryDelay?: number;
-    enableAutoRecovery?: boolean;
-}
-/**
- * Health check strategy interface
- */
-export interface HealthCheckStrategy {
-    name: string;
-    check(serverId: string, registry: MCPRegistry): Promise<HealthCheckResult>;
-}
-/**
- * Ping health check - Simple availability check
- */
-export declare class PingHealthCheck implements HealthCheckStrategy {
-    name: string;
-    check(serverId: string, registry: MCPRegistry): Promise<HealthCheckResult>;
-}
-/**
- * Tool list validation check - Ensures tools are accessible
- */
-export declare class ToolListValidationCheck implements HealthCheckStrategy {
-    name: string;
-    check(serverId: string, registry: MCPRegistry): Promise<HealthCheckResult>;
-}
-/**
- * Performance baseline check - Monitors response times
- */
-export declare class PerformanceCheck implements HealthCheckStrategy {
-    name: string;
-    private performanceThreshold;
-    constructor(thresholdMs?: number);
-    check(serverId: string, registry: MCPRegistry): Promise<HealthCheckResult>;
-}
-/**
- * Health Monitor for MCP connections
- */
-export declare class HealthMonitor {
-    private registry;
-    private errorManager;
-    private serverHealth;
-    private checkInterval;
-    private checkTimeout;
-    private maxRecoveryAttempts;
-    private recoveryDelay;
-    private enableAutoRecovery;
-    private checkTimers;
-    private strategies;
-    private isMonitoring;
-    private recoveryCallbacks;
-    constructor(registry: MCPRegistry, errorManager: ErrorManager, options?: HealthMonitorOptions);
-    /**
-     * Start monitoring all registered servers
-     */
-    startMonitoring(): void;
-    /**
-     * Stop monitoring all servers
-     */
-    stopMonitoring(): void;
-    /**
-     * Perform health check for a specific server
-     *
-     * @param serverId Server to check
-     * @param strategy Strategy name to use (default: "ping")
-     * @returns Health check result
-     */
-    checkServerHealth(serverId: string, strategy?: string): Promise<HealthCheckResult>;
-    /**
-     * Get health status for all servers
-     *
-     * @returns Map of server health information
-     */
-    getHealthStatus(): Map<string, ServerHealth>;
-    /**
-     * Get health status for a specific server
-     *
-     * @param serverId Server ID
-     * @returns Server health information or null
-     */
-    getServerHealth(serverId: string): ServerHealth | null;
-    /**
-     * Register a recovery callback for a server
-     *
-     * @param serverId Server ID
-     * @param callback Recovery callback function
-     */
-    registerRecoveryCallback(serverId: string, callback: (serverId: string) => Promise<void>): void;
-    /**
-     * Add a custom health check strategy
-     *
-     * @param strategy Health check strategy
-     */
-    addStrategy(strategy: HealthCheckStrategy): void;
-    /**
-     * Schedule periodic health check for a server
-     *
-     * @private
-     */
-    private scheduleHealthCheck;
-    /**
-     * Trigger recovery for a server
-     *
-     * @private
-     */
-    private triggerRecovery;
-    /**
-     * Generate comprehensive health report
-     *
-     * @returns Health report with server statuses and metrics
-     */
-    generateHealthReport(): {
-        summary: {
-            totalServers: number;
-            healthyServers: number;
-            unhealthyServers: number;
-            recoveringServers: number;
-            overallHealth: number;
-        };
-        servers: Array<{
-            serverId: string;
-            status: ConnectionStatus;
-            health: number;
-            uptime: number;
-            avgLatency: number;
-            lastError?: string;
-            metrics: {
-                totalChecks: number;
-                successfulChecks: number;
-                failedChecks: number;
-                recoveryAttempts: number;
-            };
-        }>;
-        trends: {
-            healthHistory: Array<{
-                timestamp: number;
-                health: number;
-            }>;
-            errorRate: number;
-            avgRecoveryTime: number;
-        };
-        recommendations: string[];
-    };
-    /**
-     * Get health metrics for monitoring dashboards
-     *
-     * @returns Simplified metrics for real-time monitoring
-     */
-    getHealthMetrics(): {
-        status: "healthy" | "degraded" | "critical";
-        healthScore: number;
-        activeAlerts: Array<{
-            serverId: string;
-            severity: "low" | "medium" | "high" | "critical";
-            message: string;
-            timestamp: number;
-        }>;
-        serverStatuses: Record<string, ConnectionStatus>;
-        performance: {
-            avgLatency: number;
-            maxLatency: number;
-            successRate: number;
-        };
-    };
-    /**
-     * Subscribe to health events
-     *
-     * @param event Event type to subscribe to
-     * @param callback Callback function
-     */
-    on(event: "health-change" | "recovery-started" | "recovery-failed" | "critical-error", callback: (data: Unknown) => void): void;
-    /**
-     * Get health history for trend analysis
-     *
-     * @private
-     */
-    private getHealthHistory;
-    /**
-     * Calculate error rate
-     *
-     * @private
-     */
-    private calculateErrorRate;
-    /**
-     * Calculate average recovery time
-     *
-     * @private
-     */
-    private calculateAvgRecoveryTime;
-    /**
-     * Generate health recommendations
-     *
-     * @private
-     */
-    private generateRecommendations;
-}
-/**
- * Default health monitor instance (to be initialized with registry and error manager)
- */
-export declare let defaultHealthMonitor: HealthMonitor | null;
-/**
- * Initialize default health monitor
- *
- * @param registry Tool registry
- * @param errorManager Error manager
- * @param options Health monitor options
- * @returns Health monitor instance
- */
-export declare function initializeHealthMonitor(registry: MCPRegistry, errorManager: ErrorManager, options?: HealthMonitorOptions): HealthMonitor;