"""Base LLM agent scaffolding for GooseStrike."""
from __future__ import annotations

from dataclasses import dataclass
from typing import Any, Dict

from .llm_router import LLMProviderError, call_llm_with_fallback


def llm_call(prompt: str) -> str:
    """Call the configured LLM providers with fallback behavior."""

    try:
        return call_llm_with_fallback(prompt)
    except LLMProviderError as exc:
        return f"LLM providers unavailable: {exc}"


@dataclass
class AgentResult:
    prompt: str
    raw_response: str
    recommendations: Dict[str, Any]


class BaseAgent:
    name = "base"

    def run(self, context: Dict[str, Any]) -> AgentResult:
        prompt = self.build_prompt(context)
        raw = llm_call(prompt)
        return AgentResult(prompt=prompt, raw_response=raw, recommendations=self.parse(raw))

    def build_prompt(self, context: Dict[str, Any]) -> str:
        raise NotImplementedError

    def parse(self, raw: str) -> Dict[str, Any]:
        return {"notes": raw.strip()}