from abc import ABC, abstractmethod class BaseLLMClient(ABC): @abstractmethod def invoke(self, messages) -> tuple[str, dict | None]: """Invoke the LLM. Returns (content_str, token_usage_or_None).""" ...