Class ModelManager

src/mcp_cli/model_management/model_manager.py:32–424

Manages LLM providers, models, and client creation. This is a clean, refactored implementation that: - Uses Pydantic models for type safety - Delegates to specialized classes for concerns - Contains ZERO hardcoded model names - Provides a simple, intuitive API

class ModelManager:
    """
    Manages LLM providers, models, and client creation.

    This is a clean, refactored implementation that:
    - Uses Pydantic models for type safety
    - Delegates to specialized classes for concerns
    - Contains ZERO hardcoded model names
    - Provides a simple, intuitive API
    """

    def __init__(self) -> None:
        """Initialize ModelManager with chuk_llm configuration."""
        self._chuk_config = None
        self._active_provider: str | None = None
        self._active_model: str | None = None
        self._custom_providers: dict[str, RuntimeProviderConfig] = {}
        self._client_factory = ClientFactory()

        self._initialize_chuk_llm()
        self._load_custom_providers()
        # Note: Discovery is NOT triggered automatically - call refresh_models() if needed

    # ── Initialization ────────────────────────────────────────────────────────

    def _initialize_chuk_llm(self) -> None:
        """Initialize chuk_llm configuration."""
        try:
            from chuk_llm.configuration import get_config

            self._chuk_config = get_config()
            logger.debug("Loaded chuk_llm configuration")

            # Use configured default provider (from defaults.py)
            if self._chuk_config:
                self._active_provider = DEFAULT_PROVIDER  # type: ignore[unreachable]
                # Defer model resolution to avoid circular dependencies during __init__
                self._active_model = None

        except Exception as e:
            logger.error(f"Failed to initialize chuk_llm: {e}")
            # Minimal fallback - use configured default
            self._chuk_config = None
            self._active_provider = DEFAULT_PROVIDER
            self._active_model = None  # Will be determined on first use

    def _load_custom_providers(self) -> None:
        """Load custom providers from preferences."""
        try:
            from mcp_cli.utils.preferences import get_preference_manager

            prefs = get_preference_manager()
            custom_providers = prefs.get_custom_providers()

            for name, provider_data in custom_providers.items():
                # Convert dict to Pydantic model
                config = RuntimeProviderConfig(
                    name=name,