agentic_core/agents/api.py

"""API Design Agent."""

from __future__ import annotations

from pydantic import BaseModel

from ..prompts import PROMPTS, build_user_prompt
from ..schemas import APIOutput, ProjectContext
from .base import (
    BaseAgent,
    RevisionInstruction,
    project_context_payload,
    revision_instruction_text,
)
from .digest import (
    condense_context,
    digest_architecture,
    digest_database,
    digest_requirements,
    dumps,
    summary_or_digest,
)


class APIAgent(BaseAgent):
    name = "api"
    output_schema: type[BaseModel] = APIOutput
    system_prompt = PROMPTS["api"].system

    async def _execute(
        self, context: ProjectContext, revision: RevisionInstruction | None = None
    ) -> APIOutput:
        user_prompt = build_user_prompt(
            "api",
            project_context=dumps(
                condense_context(project_context_payload(context), downstream=True)
            ),
            requirements=summary_or_digest(
                context, "requirements", digest_requirements(context.requirements or {})
            ),
            architecture=summary_or_digest(
                context, "architecture", digest_architecture(context.architecture or {})
            ),
            database=summary_or_digest(
                context, "database", digest_database(context.database or {})
            ),
        )
        if revision is not None:
            user_prompt += revision_instruction_text(revision)
        return await self._llm.generate(
            self.system_prompt, user_prompt, APIOutput, stats=self._stats
        )