"""Schemas — Step 22 semantic skill matching via embeddings."""

from typing import Any
from uuid import UUID

from pydantic import BaseModel, Field

from app.schemas.common import StubMeta
from app.schemas.interviews import TranscriptTurn


class SemanticSkillMatchRequest(BaseModel):
    """POST /api/v1/semantic-skill-match"""

    correlation_id: UUID | None = None
    interview_id: str | None = None
    role_title: str
    job_description: str = Field(..., min_length=20)
    required_skills: list[str] = Field(default_factory=list)
    candidate_answers: list[str] = Field(
        default_factory=list,
        description="Raw answer texts",
    )
    transcript: list[TranscriptTurn] = Field(default_factory=list)
    demonstrated_competencies: list[str] = Field(
        default_factory=list,
        description="Optional competency labels from behavioral analysis",
    )
    language: str = Field(default="en", min_length=2, max_length=10)
    options: dict[str, Any] = Field(default_factory=dict)


class SkillMatchItem(BaseModel):
    skill: str
    similarity: float = Field(..., ge=0.0, le=1.0)
    matched: bool = False
    best_answer_excerpt: str | None = None
    evidence: str | None = None


class SemanticSkillMatchResponse(StubMeta):
    correlation_id: UUID | None = None
    interview_id: str | None = None
    role_title: str
    overall_similarity: float | None = None
    embedding_provider: str | None = None
    skill_matches: list[SkillMatchItem] = Field(default_factory=list)
    competency_matches: list[SkillMatchItem] = Field(default_factory=list)
    summary: str | None = None
