mcp-stdio-proxy 0.1.64

//! SSE 模式处理
//!
//! Server-Sent Events 协议的实现和连接管理

use anyhow::Result;
use std::sync::Arc;
use std::time::Duration;
use tracing::error;

use super::common::HealthChecker;
use crate::client::support::{
    ConvertArgs, classify_error, print_diagnostic_report, summarize_error, truncate_str,
};
use crate::proxy::{McpClientConfig, ProxyHandler, SseClientConnection, ToolFilter};

use mcp_sse_proxy::{ServiceExt, stdio as sse_stdio};

/// 为 ProxyHandler 实现 HealthChecker trait
impl HealthChecker for ProxyHandler {
    fn is_backend_available(&self) -> bool {
        self.is_backend_available()
    }

    async fn is_terminated_async(&self) -> bool {
        self.is_terminated_async().await
    }
}

/// SSE 模式处理（使用 mcp-sse-proxy，rmcp 0.10）
pub async fn run_sse_mode(
    config: McpClientConfig,
    args: ConvertArgs,
    tool_filter: ToolFilter,
    verbose: bool,
    quiet: bool,
) -> Result<()> {
    tracing::info!("========================================");
    tracing::info!("Starting SSE mode");
    tracing::info!("Target URL: {}", config.url);
    tracing::info!(
        "Ping config: interval={}s, timeout={}s",
        args.ping_interval,
        args.ping_timeout
    );
    tracing::info!("========================================");

    if !quiet {
        eprintln!("🔗 Connecting to backend service (SSE)...");
    }

    // 1. 使用高层 API 连接
    let connect_timeout = Duration::from_secs(30);
    tracing::info!(
        "Connecting to backend (timeout: {}s)",
        connect_timeout.as_secs()
    );
    let connect_start = std::time::Instant::now();

    let conn = tokio::time::timeout(
        connect_timeout,
        SseClientConnection::connect(config.clone()),
    )
    .await
    .map_err(|_| {
        tracing::error!(
            "Backend connection timeout ({}s)",
            connect_timeout.as_secs()
        );
        anyhow::anyhow!(
            "Backend connection timeout ({}s)",
            connect_timeout.as_secs()
        )
    })?
    .map_err(|e| {
        tracing::error!("Backend connection failed: {}", e);
        anyhow::anyhow!("Backend connection failed: {}", e)
    })?;

    let connect_duration = connect_start.elapsed();
    tracing::info!(
        "Backend connected successfully (duration: {:?})",
        connect_duration
    );

    if !quiet {
        eprintln!("✅ Backend connected successfully");
        // 打印工具列表
        print_sse_tools(&conn, quiet).await;
        if args.ping_interval > 0 {
            eprintln!(
                "💓 Health ping: every {}s (timeout {}s)",
                args.ping_interval, args.ping_timeout
            );
        }
    }

    // 2. 创建 handler（消耗 conn）
    tracing::debug!("Creating ProxyHandler...");
    let handler = Arc::new(conn.into_handler("cli".to_string(), tool_filter.clone()));
    tracing::debug!("ProxyHandler created");

    // 3. 启动 stdio server
    tracing::info!("Starting stdio server...");
    let server = (*handler).clone().serve(sse_stdio()).await?;
    tracing::info!("Stdio server started");

    if !quiet {
        eprintln!("💡 Stdio server started, proxying traffic...");
    }

    // 4. 启动 watchdog 任务
    let handler_for_watchdog = handler.clone();
    let mut watchdog_handle = tokio::spawn(run_sse_watchdog(
        handler_for_watchdog,
        args,
        config,
        tool_filter,
        verbose,
        quiet,
    ));
    tracing::debug!("Watchdog task started");

    // 5. 等待 stdio server 退出
    tracing::info!("Waiting for stdio/watchdog events...");
    tokio::select! {
        result = server.waiting() => {
            tracing::info!("========================================");
            tracing::info!("Stdio server exited (EOF)");
            tracing::info!("========================================");
            watchdog_handle.abort();
            result?;
        }
        watchdog_result = &mut watchdog_handle => {
            tracing::info!("========================================");
            tracing::info!("Watchdog task exited");
            tracing::info!("========================================");
            if let Err(e) = watchdog_result
                && !e.is_cancelled()
            {
                error!("SSE Watchdog task failed: {:?}", e);
            }
        }
    }

    tracing::info!("SSE mode exited normally");
    Ok(())
}

/// 打印 SSE 连接的工具列表
async fn print_sse_tools(conn: &SseClientConnection, quiet: bool) {
    if quiet {
        return;
    }
    match conn.list_tools().await {
        Ok(tools) => {
            if tools.is_empty() {
                eprintln!("⚠️  Tool list is empty (tools/list returned 0 tools)");
            } else {
                eprintln!("🔧 Available tools ({}):", tools.len());
                for tool in &tools {
                    let desc = tool.description.as_deref().unwrap_or("no description");
                    let desc_short = truncate_str(desc, 50);
                    eprintln!("   - {} : {}", tool.name, desc_short);
                }
            }
        }
        Err(e) => {
            eprintln!("⚠️  Failed to list tools: {}", e);
        }
    }
}

/// SSE 模式的 watchdog：负责监控连接健康、断开时重连
async fn run_sse_watchdog(
    handler: Arc<ProxyHandler>,
    args: ConvertArgs,
    config: McpClientConfig,
    _tool_filter: ToolFilter,
    verbose: bool,
    quiet: bool,
) {
    tracing::info!("========================================");
    tracing::info!("Starting SSE watchdog");
    tracing::info!("Max retries: {}", args.retries);
    tracing::info!("========================================");

    let max_retries = args.retries;
    let mut attempt = 0u32;
    let mut backoff_secs = 1u64;
    const MAX_BACKOFF_SECS: u64 = 30;
    const EVENT_DISCONNECTED: &str = "EVENT_DISCONNECTED";
    const EVENT_RECONNECTED: &str = "EVENT_RECONNECTED";
    const EVENT_RETRY_BACKOFF: &str = "EVENT_RETRY_BACKOFF";
    let initial_connection_start = std::time::Instant::now();

    // 首先监控现有连接的健康状态
    tracing::info!("Monitoring initial connection health");
    let disconnect_reason =
        monitor_sse_connection(&handler, args.ping_interval, args.ping_timeout, quiet).await;

    // 连接断开，标记后端不可用
    tracing::warn!("Initial connection disconnected: {}", disconnect_reason);
    handler.swap_backend(None);

    let alive_duration = initial_connection_start.elapsed();
    tracing::info!(
        "Initial connection alive duration: {}s",
        alive_duration.as_secs()
    );

    if !quiet {
        eprintln!(
            "⚠️ [{}] Connection disconnected: {}",
            EVENT_DISCONNECTED, disconnect_reason
        );
    }

    // 生成诊断报告（首次断开）
    print_diagnostic_report(
        "SSE",
        &config.url,
        alive_duration.as_secs(),
        &disconnect_reason,
        None,
        args.logging.diagnostic,
    );

    // 进入重连循环
    loop {
        attempt += 1;
        tracing::info!("========================================");
        if max_retries == 0 {
            tracing::info!("Reconnect attempt #{} (unlimited mode)", attempt);
        } else {
            tracing::info!("Reconnect attempt {}/{}", attempt, max_retries);
        }
        tracing::info!("Backoff: {}s", backoff_secs);

        if !quiet {
            eprintln!("🔗 Reconnecting (attempt #{})...", attempt);
        }

        // 尝试建立连接
        tracing::debug!("Attempting to establish connection...");
        let connect_start = std::time::Instant::now();
        let connect_result = SseClientConnection::connect(config.clone()).await;
        let connect_duration = connect_start.elapsed();

        match connect_result {
            Ok(conn) => {
                tracing::info!("Reconnect succeeded (duration: {:?})", connect_duration);

                // 连接成功，获取 RunningService 并热替换后端
                let running = conn.into_running_service();
                handler.swap_backend(Some(running));
                backoff_secs = 1;

                if !quiet {
                    eprintln!(
                        "✅ [{}] Reconnected, proxy service resumed",
                        EVENT_RECONNECTED
                    );
                }

                // 监控连接健康
                tracing::info!("Monitoring connection after reconnect");
                let reconnect_start = std::time::Instant::now();
                let disconnect_reason =
                    monitor_sse_connection(&handler, args.ping_interval, args.ping_timeout, quiet)
                        .await;

                // 连接断开，标记后端不可用
                tracing::warn!("Reconnected session disconnected: {}", disconnect_reason);
                handler.swap_backend(None);
                let reconnect_alive_duration = reconnect_start.elapsed();
                tracing::info!(
                    "Reconnected session alive duration: {}s",
                    reconnect_alive_duration.as_secs()
                );

                if !quiet {
                    eprintln!(
                        "⚠️ [{}] Connection disconnected: {}",
                        EVENT_DISCONNECTED, disconnect_reason
                    );
                }

                // 生成诊断报告（重连后断开）
                print_diagnostic_report(
                    "SSE",
                    &config.url,
                    reconnect_alive_duration.as_secs(),
                    &disconnect_reason,
                    None,
                    args.logging.diagnostic,
                );
            }
            Err(e) => {
                let error_type = classify_error(&e);
                tracing::error!(
                    "Connection failed [{}]: {} (duration: {:?})",
                    error_type,
                    summarize_error(&e),
                    connect_duration
                );

                if max_retries > 0 && attempt >= max_retries {
                    tracing::error!("Max retries reached: {}", max_retries);
                    if !quiet {
                        eprintln!(
                            "❌ Connection failed, max retries reached ({})",
                            max_retries
                        );
                        eprintln!("   Error type: {}", error_type);
                        eprintln!("   Error detail: {}", e);
                    }
                    // 生成最终诊断报告
                    print_diagnostic_report(
                        "SSE",
                        &config.url,
                        0,
                        "Connection failed: max retries reached",
                        Some(&error_type),
                        args.logging.diagnostic,
                    );
                    break;
                }

                if !quiet {
                    if max_retries == 0 {
                        eprintln!(
                            "⚠️ [{}] Connection failed [{}]: {}; retrying in {}s (attempt #{})...",
                            EVENT_RETRY_BACKOFF,
                            error_type,
                            summarize_error(&e),
                            backoff_secs,
                            attempt
                        );
                    } else {
                        eprintln!(
                            "⚠️ [{}] Connection failed [{}]: {}; retrying in {}s ({}/{})...",
                            EVENT_RETRY_BACKOFF,
                            error_type,
                            summarize_error(&e),
                            backoff_secs,
                            attempt,
                            max_retries
                        );
                    }
                }

                if verbose && !quiet {
                    eprintln!("   Full error: {}", e);
                }
            }
        }

        tracing::debug!("Waiting {}s before next reconnect attempt", backoff_secs);
        tokio::time::sleep(Duration::from_secs(backoff_secs)).await;
        backoff_secs = (backoff_secs * 2).min(MAX_BACKOFF_SECS);
    }

    tracing::info!("SSE watchdog exited");
}

/// 监控 SSE 连接健康状态
///
/// 委托给 common::monitor_connection_health 公共函数
async fn monitor_sse_connection(
    handler: &ProxyHandler,
    ping_interval: u64,
    ping_timeout: u64,
    quiet: bool,
) -> String {
    super::common::monitor_connection_health(handler, ping_interval, ping_timeout, quiet, "SSE")
        .await
}