"""Schemas — unified communication + optional audio/confidence analysis."""

from typing import Any
from uuid import UUID

from pydantic import BaseModel, Field, model_validator

from app.schemas.audio_analysis import (
    AudioQualityInfo,
    ConfidenceIndicators,
    DeliveryScore,
    PauseStats,
    SpeechPatterns,
)
from app.schemas.common import StubMeta
from app.schemas.interviews import TranscriptTurn


class CommunicationAnalysisRequest(BaseModel):
    """Internal communication + optional audio/confidence analysis.

    No public HTTP route — used by final-evaluation / services. Text
    communication is scored from transcript/answer text. Optional audio
    (base64 or URL) adds vocal delivery / pacing / pauses /
    confidence-related delivery — never inferred from text alone.
    """

    correlation_id: UUID | None = None
    interview_id: str | None = None
    role_title: str | None = None
    question: str | None = Field(
        default=None,
        description="Optional question for relevance scoring (not technical correctness)",
    )
    text: str | None = Field(
        default=None,
        description="Single answer text; optional if transcript/answers provided",
    )
    transcript: list[TranscriptTurn] = Field(default_factory=list)
    answers: list[dict[str, Any]] = Field(
        default_factory=list,
        description="Optional [{question, answer}, ...]",
    )
    audio_base64: str | None = Field(
        default=None,
        description="Optional interview audio (exactly one of audio_base64 | source_url)",
    )
    source_url: str | None = Field(
        default=None,
        description="Optional HTTP(S) audio URL (exactly one of audio_base64 | source_url)",
    )
    audio_mime_type: str = Field(default="audio/wav")
    audio_features: dict[str, Any] = Field(
        default_factory=dict,
        description=(
            "Optional precomputed acoustic features (from a prior audio pass). "
            "Used only for delivery/confidence — never as text feedback ground truth."
        ),
    )
    include_voice_delivery: bool = Field(
        default=True,
        description="When audio or audio_features present, score delivery/confidence",
    )
    run_transcription: bool = Field(
        default=False,
        description=(
            "If true and no text/transcript is supplied with audio, run STT once "
            "and reuse that transcript for communication + delivery scoring"
        ),
    )
    language: str = Field(default="en", min_length=2, max_length=10)
    options: dict[str, Any] = Field(default_factory=dict)

    @model_validator(mode="after")
    def audio_sources_exclusive(self) -> "CommunicationAnalysisRequest":
        if self.audio_base64 and self.source_url:
            raise ValueError("Provide at most one of audio_base64 or source_url")
        return self


class CommunicationDimension(BaseModel):
    key: str
    label: str
    score: float = Field(..., ge=0.0, le=1.0)
    evidence: list[str] = Field(default_factory=list)
    gaps: list[str] = Field(default_factory=list)


class CommunicationAnalysisResponse(StubMeta):
    """Unified communication quality (+ optional audio delivery/confidence).

    Does not score technical correctness — that belongs to interview evaluation.
    """

    correlation_id: UUID | None = None
    interview_id: str | None = None

    # Primary communication fields (always present)
    communication_score: float | None = Field(
        default=None,
        ge=0.0,
        le=1.0,
        description="Overall text communication quality (0–1); excludes technical correctness",
    )
    overall_score: float | None = Field(
        default=None,
        ge=0.0,
        le=1.0,
        description="Alias of communication_score (backward compatible)",
    )
    clarity: CommunicationDimension
    structure: CommunicationDimension = Field(
        ...,
        description="Discourse structure / organization",
    )
    relevance: CommunicationDimension
    organization: CommunicationDimension = Field(
        ...,
        description="Alias of structure (backward compatible)",
    )
    conciseness: CommunicationDimension | None = Field(
        default=None,
        description="Optional conciseness dimension (backward compatible)",
    )
    strengths: list[str] = Field(default_factory=list, max_length=5)
    weaknesses: list[str] = Field(
        default_factory=list,
        max_length=5,
        description="Communication gaps derived from transcript/audio evidence",
    )
    improvement_areas: list[str] = Field(
        default_factory=list,
        max_length=5,
        description="Alias of weaknesses (backward compatible)",
    )
    actionable_feedback: list[str] = Field(
        default_factory=list,
        max_length=3,
        description="1–3 actionable communication suggestions",
    )
    summary: str | None = None

    # Optional audio / confidence (null when audio unavailable)
    vocal_delivery: float | None = Field(
        default=None,
        ge=0.0,
        le=1.0,
        description="Overall vocal delivery score; null without audio evidence",
    )
    pacing: float | None = Field(
        default=None,
        ge=0.0,
        le=1.0,
        description="Pacing score from audio; null without audio",
    )
    pauses: PauseStats | None = Field(
        default=None,
        description="Pause statistics from audio; null without audio",
    )
    confidence_score: float | None = Field(
        default=None,
        ge=0.0,
        le=1.0,
        description=(
            "Confidence-related delivery score from audio evidence only; "
            "null when audio is unavailable (never inferred from text alone)"
        ),
    )
    certainty_band: str | None = Field(
        default=None,
        description="high | medium | low from audio confidence indicators; null without audio",
    )
    delivery: DeliveryScore | None = Field(
        default=None,
        description="Detailed delivery breakdown when audio scored",
    )
    speech_patterns: SpeechPatterns | None = None
    confidence_indicators: ConfidenceIndicators | None = None
    # Compact acoustic metrics (null/empty without audio) — replaces standalone audio-analysis
    audio_duration_seconds: float | None = None
    speech_duration_seconds: float | None = None
    silence_percentage: float | None = None
    words_per_minute: float | None = None
    audio_quality: AudioQualityInfo | None = None
    audio_features: dict[str, Any] = Field(
        default_factory=dict,
        description="Compact feature map for passthrough; empty without audio",
    )
    audio_delivery_paused: bool = Field(
        default=True,
        description="True when no audio delivery/confidence was scored",
    )
    transcript_used: bool = False
    transcription_status: str | None = None
    limitations: list[str] = Field(default_factory=list)
