from abc import ABC, abstractmethod
from dataclasses import dataclass
from typing import Any, Optional


@dataclass
class AICompletionResult:
    content: str
    model: str
    prompt_tokens: int
    completion_tokens: int
    total_tokens: int
    cost_microcents: int
    latency_ms: int


class AIProvider(ABC):
    """Abstract interface for LLM completion providers."""

    @abstractmethod
    async def generate_completion(
        self,
        messages: list[dict[str, str]],
        model: str,
        temperature: float = 0.7,
        max_tokens: int = 1000,
        api_key: Optional[str] = None,
    ) -> AICompletionResult:
        pass

    @abstractmethod
    def list_supported_models(self) -> list[dict[str, Any]]:
        pass
