"""LangGraph agent state for HR-ATS workflows.

Pure module: no FastAPI imports and no HTTPException.
"""

from __future__ import annotations

from typing import Literal, TypedDict


class AgentState(TypedDict, total=False):
    """Shared state passed between graph nodes."""

    subject: str
    resume_text: str
    job_posts: list[dict]
    suggested_job_post_ids: list[str]
    reasoning: str
    error: str
    status: Literal["pending", "ready", "matched", "skipped", "failed"]