Skip to content

"Vibe-Trading: Your Personal Trading Agent"

11.6 KB
Raw Blame
"""Startup preflight checks for data sources and LLM provider.

Runs connectivity checks at startup and prints a status table.
Non-critical failures are warnings (degraded functionality),
LLM provider failure is critical (blocks startup).
"""

from __future__ import annotations

import os
from dataclasses import dataclass
from importlib.util import find_spec
from typing import List, Optional

from rich.console import Console
from rich.table import Table

from src.config.accessor import get_env_config, reset_env_config


@dataclass(frozen=True)
class CheckResult:
    """Result of a single preflight check."""

    name: str
    status: str  # "ready", "error", "not_configured", "skipped"
    message: str
    impact: str  # what breaks if this fails
    critical: bool = False


def _check_llm_provider() -> CheckResult:
    """Verify LLM provider connectivity."""
    from src.providers.llm import _ensure_dotenv, _sync_provider_env, provider_diagnostics

    _ensure_dotenv()
    # The EnvConfig singleton may have been cached before _ensure_dotenv()
    # loaded the .env file (e.g. by theme.py's import-time _is_dark_terminal
    # call). Reset it so get_env_config() rebuilds from the now-populated
    # os.environ.
    reset_env_config()
    _cfg = get_env_config()
    provider = _cfg.llm.langchain_provider.strip()
    model = _cfg.llm.langchain_model_name.strip()

    if not provider:
        return CheckResult(
            name="LLM Provider",
            status="not_configured",
            message="LANGCHAIN_PROVIDER not set in .env",
            impact="agent cannot function",
            critical=True,
        )
    if not model:
        return CheckResult(
            name=f"LLM ({provider})",
            status="not_configured",
            message="LANGCHAIN_MODEL_NAME not set in .env",
            impact="agent cannot function",
            critical=True,
        )

    _sync_provider_env()
    diagnostics = provider_diagnostics()
    base_url = os.getenv("OPENAI_BASE_URL", "") or os.getenv("OPENAI_API_BASE", "")  # noqa: env-gate — diagnostic base URL fallback
    proxy_label = ",".join(sorted(diagnostics.get("proxy", {}).keys())) or "none"
    diag_hint = (
        f"base={diagnostics['base_url']} "
        f"timeout={diagnostics['timeout_seconds']}s "
        f"retries={diagnostics['max_retries']} "
        f"proxy={proxy_label}"
    )

    if provider.lower() in {"openai-codex", "openai_codex"}:
        try:
            from src.providers.openai_codex import get_openai_codex_login_status

            token = get_openai_codex_login_status()
        except Exception as exc:
            return CheckResult(
                name=f"LLM ({provider})",
                status="error",
                message=f"OAuth status unavailable: {exc}",
                impact="run `vibe-trading provider login openai-codex`",
                critical=True,
            )
        if not token:
            return CheckResult(
                name=f"LLM ({provider})",
                status="not_configured",
                message="ChatGPT OAuth login not found",
                impact="run `vibe-trading provider login openai-codex`",
                critical=True,
            )
        account = getattr(token, "account_id", None) or "authenticated account"
        return CheckResult(
            name=f"LLM ({provider})",
            status="ready",
            message=f"{model} via ChatGPT OAuth ({account}) | {diag_hint}",
            impact="",
        )

    if provider.lower() in {"copilot", "github-copilot"}:
        from src.providers.copilot_auth import get_copilot_auth_status

        authenticated, status_message = get_copilot_auth_status()
        if not authenticated:
            return CheckResult(
                name=f"LLM ({provider})",
                status="not_configured",
                message=f"Copilot SDK: {status_message}",
                impact="run `gh auth login`, `copilot`, or set COPILOT_GITHUB_TOKEN",
                critical=True,
            )
        return CheckResult(
            name=f"LLM ({provider})",
            status="ready",
            message=f"{model} via Copilot SDK ({status_message}) | {diag_hint}",
            impact="",
        )

    if provider.lower() == "claude-cli":
        from src.providers.claude_cli import get_claude_cli_auth_status

        logged_in, auth_method = get_claude_cli_auth_status()
        if not logged_in:
            return CheckResult(
                name=f"LLM ({provider})",
                status="not_configured",
                message=f"Claude Code CLI: {auth_method}",
                impact="install Claude Code and run `claude auth login`, or set CLAUDE_CLI_PATH",
                critical=True,
            )
        return CheckResult(
            name=f"LLM ({provider})",
            status="ready",
            message=f"{model} via local claude -p ({auth_method}) | {diag_hint}",
            impact="",
        )

    if not base_url:
        return CheckResult(
            name=f"LLM ({provider})",
            status="not_configured",
            message=f"base URL not set for {provider} | {diag_hint}",
            impact="agent cannot function",
            critical=True,
        )

    # Ping the base URL
    try:
        import requests

        # Strip /v1 suffix for health check, just test TCP+SSL
        ping_url = base_url.rstrip("/")
        if ping_url.endswith("/v1"):
            ping_url = ping_url[:-3]
        requests.get(ping_url, timeout=10, allow_redirects=False)
        return CheckResult(
            name=f"LLM ({provider})",
            status="ready",
            message=f"{model} via {diagnostics['base_url']} | {diag_hint}",
            impact="",
        )
    except Exception as exc:
        return CheckResult(
            name=f"LLM ({provider})",
            status="error",
            message=f"{type(exc).__name__}: {exc} | {diag_hint}",
            impact="agent cannot function",
            critical=True,
        )


def _check_okx() -> CheckResult:
    """Check OKX public API reachability."""
    try:
        import requests

        resp = requests.get(
            "https://www.okx.com/api/v5/market/candles",
            params={"instId": "BTC-USDT", "bar": "1D", "limit": "1"},
            timeout=10,
        )
        data = resp.json()
        if data.get("code") == "0":
            return CheckResult(name="OKX API", status="ready", message="reachable", impact="")
        return CheckResult(
            name="OKX API",
            status="error",
            message=f"API returned code={data.get('code')}: {data.get('msg', '')}",
            impact="crypto backtest unavailable",
        )
    except Exception as exc:
        return CheckResult(
            name="OKX API",
            status="error",
            message=f"{type(exc).__name__}: {exc}",
            impact="crypto backtest unavailable",
        )


def _check_yfinance() -> CheckResult:
    """Check yfinance availability."""
    try:
        import yfinance  # noqa: F401
    except ImportError:
        return CheckResult(
            name="yfinance",
            status="skipped",
            message="package not installed",
            impact="US/HK equity backtest unavailable",
        )

    try:
        import yfinance as yf

        ticker = yf.Ticker("AAPL")
        info = ticker.fast_info
        if hasattr(info, "last_price") and info.last_price:
            return CheckResult(name="yfinance", status="ready", message="reachable", impact="")
        return CheckResult(name="yfinance", status="ready", message="reachable (no price data)", impact="")
    except Exception as exc:
        return CheckResult(
            name="yfinance",
            status="error",
            message=f"{type(exc).__name__}: {exc}",
            impact="US/HK equity backtest unavailable",
        )


def _check_tushare() -> CheckResult:
    """Check Tushare token configuration."""
    token = get_env_config().data.tushare_token.strip()
    if not token or token == "your-tushare-token":
        return CheckResult(
            name="Tushare",
            status="not_configured",
            message="TUSHARE_TOKEN not set (optional)",
            impact="A-share data unavailable",
        )

    try:
        import tushare  # noqa: F401
    except ImportError:
        return CheckResult(
            name="Tushare",
            status="skipped",
            message="package not installed",
            impact="A-share data unavailable",
        )

    return CheckResult(name="Tushare", status="ready", message="token configured", impact="")


def _check_akshare() -> CheckResult:
    """Check akshare availability."""
    if find_spec("akshare") is None:
        return CheckResult(
            name="akshare",
            status="skipped",
            message="package not installed",
            impact="A-share/forex fallback unavailable",
        )
    return CheckResult(name="akshare", status="ready", message="installed", impact="")


def _check_content_filter_threshold() -> CheckResult:
    """Report the configured content filter warning threshold."""
    threshold = get_env_config().agent_tuning.content_filter_warning_threshold
    return CheckResult(
        name="Content Filter Threshold",
        status="ready",
        message=f"{threshold:.0%} (set via CONTENT_FILTER_WARNING_THRESHOLD)",
        impact="",
    )


def _check_ccxt() -> CheckResult:
    """Check ccxt availability."""
    try:
        import ccxt  # noqa: F401
    except ImportError:
        return CheckResult(
            name="ccxt",
            status="skipped",
            message="package not installed",
            impact="crypto fallback unavailable",
        )
    return CheckResult(name="ccxt", status="ready", message="installed", impact="")


# -- Status icons and colors --------------------------------------------------

_STATUS_DISPLAY = {
    "ready": ("[green]OK[/green]", "green"),
    "error": ("[red]FAIL[/red]", "red"),
    "not_configured": ("[yellow]N/A[/yellow]", "yellow"),
    "skipped": ("[dim]SKIP[/dim]", "dim"),
}


def run_preflight(console: Optional[Console] = None) -> List[CheckResult]:
    """Run all preflight checks and print results.

    Args:
        console: Rich console for output. Creates one if not provided.

    Returns:
        List of check results.
    """
    if console is None:
        console = Console()

    checks = [
        _check_llm_provider,
        _check_okx,
        _check_yfinance,
        _check_tushare,
        _check_akshare,
        _check_ccxt,
        _check_content_filter_threshold,
    ]

    results: List[CheckResult] = []
    for check_fn in checks:
        results.append(check_fn())

    # Build display table
    table = Table(show_header=False, show_edge=False, padding=(0, 1), expand=False)
    table.add_column(width=4)   # icon
    table.add_column(width=18)  # name
    table.add_column()          # message

    for r in results:
        icon, color = _STATUS_DISPLAY[r.status]
        detail = r.message
        if r.status in ("error", "not_configured") and r.impact:
            detail = f"{r.message} ({r.impact})"
        table.add_row(icon, f"[{color}]{r.name}[/{color}]", f"[{color}]{detail}[/{color}]")

    console.print()
    console.print("[bold]Preflight Check[/bold]")
    console.print(table)

    has_critical = any(r.critical and r.status != "ready" for r in results)
    if has_critical:
        console.print("\n[bold red]Critical check failed - agent cannot start without a working LLM provider.[/bold red]")
        console.print("[dim]  See: agent/.env.example for configuration reference[/dim]")
    else:
        ready_count = sum(1 for r in results if r.status == "ready")
        console.print(f"\n[dim]{ready_count}/{len(results)} services ready[/dim]")

    console.print()
    return results