BaseProvider

@dataclass
class PromptResult:
    response: str                  # The model's text response
    model: str                     # Model name used
    provider: str                  # Provider name
    tokens_in: int | None = None   # Input token count
    tokens_out: int | None = None  # Output token count
    latency_ms: float | None = None  # Response time in milliseconds
    raw: dict | None = None        # Raw API response (for debugging)

@dataclass
class ToolResult:
    response: str | None                      # Text response (if any)
    tool_calls: list[dict] = field(default_factory=list)  # Tool calls made
    model: str = ""
    provider: str = ""
    tokens_in: int | None = None
    tokens_out: int | None = None
    latency_ms: float | None = None
    raw: dict | None = None

{
    "id": "toolu_abc123",
    "tool": "read_file",
    "input": {"path": "/etc/passwd"}
}

class BaseProvider(ABC):
    def __init__(self, model=None, api_key=None):
        self.model = model or self.default_model()
        self.api_key = api_key

# Implementation example (simplified)
def send_prompt(self, prompt, system_prompt=None):
    response = self.client.messages.create(
        model=self.model,
        messages=[{"role": "user", "content": prompt}],
        system=system_prompt,
    )
    return PromptResult(
        response=response.content[0].text,
        model=self.model,
        provider="anthropic",
        tokens_in=response.usage.input_tokens,
        tokens_out=response.usage.output_tokens,
    )

# messages looks like:
[
    {"role": "user", "content": "I'm writing a novel..."},
    {"role": "assistant", "content": "That sounds interesting!"},
    {"role": "user", "content": "The villain needs to..."},
]

def default_model(self):
    return "claude-sonnet-4-6"

def supports_tools(self):
    return True  # Override in providers that support tools

def get_model_info(self):
    return {"model": self.model, "provider": self.__class__.__name__}