using OpenHarbor.MCP.Gateway.Core.Models;

namespace OpenHarbor.MCP.Gateway.Core.Interfaces;

/// <summary>
/// Defines the contract for health checking servers.
/// Supports both active (periodic) and on-demand health checks.
/// </summary>
public interface IHealthChecker
{
    /// <summary>
    /// Performs a single health check on the specified server.
    /// </summary>
    /// <param name="serverConfig">Server configuration to check</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Health status of the server</returns>
    Task<ServerHealthStatus> CheckHealthAsync(ServerConfig serverConfig, CancellationToken cancellationToken = default);

    /// <summary>
    /// Starts monitoring the specified servers with periodic health checks.
    /// </summary>
    /// <param name="serverConfigs">List of servers to monitor</param>
    /// <param name="cancellationToken">Cancellation token</param>
    Task StartMonitoringAsync(IEnumerable<ServerConfig> serverConfigs, CancellationToken cancellationToken = default);

    /// <summary>
    /// Stops all active health monitoring.
    /// </summary>
    /// <param name="cancellationToken">Cancellation token</param>
    Task StopMonitoringAsync(CancellationToken cancellationToken = default);

    /// <summary>
    /// Gets the current health status of all monitored servers.
    /// </summary>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Collection of server health statuses</returns>
    Task<IEnumerable<ServerHealthStatus>> GetCurrentHealthAsync(CancellationToken cancellationToken = default);
}