"""Structured final output for the region agent."""

from __future__ import annotations

from typing import Literal

from pydantic import BaseModel, Field


class AgentIssueUpdate(BaseModel):
    """Final agent output published back to the GitHub issue."""

    issue_number: int
    body: str = Field(description="Markdown comment body to post to the issue")
    autopilot_status: Literal["waiting", "done", "action_required"] | None = Field(
        default=None,
        description="Optional autopilot marker to prepend before posting",
    )
    conclusion: str | None = Field(
        default=None,
        description="Workflow conclusion when autopilot_status is done",
    )