"""Schemas — Librosa audio analysis + speech pattern / delivery scoring."""

from typing import Any
from uuid import UUID

from pydantic import BaseModel, Field, model_validator

from app.schemas.common import StubMeta


class AudioQualityInfo(BaseModel):
    clipping_detected: bool = False
    clipping_ratio: float | None = Field(
        default=None,
        description="Fraction of samples near full-scale (|x| >= threshold)",
    )
    snr_estimate_db: float | None = Field(
        default=None,
        description="Rough speech vs non-speech power ratio in dB; null if unreliable",
    )
    quality_warnings: list[str] = Field(default_factory=list)


class PauseStats(BaseModel):
    pause_count: int = 0
    long_pause_count: int = 0
    pause_durations_seconds: list[float] = Field(default_factory=list)
    long_pause_threshold_ms: float | None = None


class SpeechPatterns(BaseModel):
    speaking_rate_band: str | None = None
    speaking_rate_score: float | None = None
    words_per_minute: float | None = None
    pause_pattern: str | None = None
    pause_score: float | None = None
    fluency_score: float | None = None
    evidence: list[str] = Field(default_factory=list)


class DeliveryScore(BaseModel):
    score: float | None = None
    pacing_score: float | None = None
    silence_management_score: float | None = None
    energy_stability_score: float | None = None
    pitch_stability_score: float | None = None
    evidence: list[str] = Field(default_factory=list)
    gaps: list[str] = Field(default_factory=list)


class ConfidenceIndicators(BaseModel):
    score: float | None = None
    band: str | None = None  # high | medium | low
    linguistic_score: float | None = None
    acoustic_score: float | None = None
    linguistic_cues: list[str] = Field(default_factory=list)
    acoustic_cues: list[str] = Field(default_factory=list)
    note: str | None = None


class AudioAnalysisRequest(BaseModel):
    """Internal audio analysis request (Librosa + delivery/confidence).

    Used by CommunicationAnalysisService / final-evaluation. No public HTTP route.
    Provide exactly one audio source. Optionally pass an existing transcript for
    WPM, speech-pattern, and confidence-indicator scoring.
    """

    correlation_id: UUID | None = None
    interview_id: str | None = Field(
        default=None,
        description=(
            "Optional correlation label. Paste auto-generated id from sessions/start "
            "when tying to a live interview; omit for standalone Try-it-out."
        ),
    )
    audio_base64: str | None = Field(
        default=None,
        description="Base64-encoded audio. Provide this OR source_url (exactly one).",
    )
    source_url: str | None = Field(
        default=None,
        description="HTTP(S) URL to a WAV/MP3 sample for analysis.",
        examples=[
            "https://www.voiptroubleshooter.com/open_speech/american/OSR_us_000_0010_8k.wav"
        ],
    )
    audio_mime_type: str = Field(default="audio/wav")
    transcript_text: str | None = Field(
        default=None,
        description="Existing transcript; when set, STT is skipped for WPM / linguistic cues",
    )
    run_transcription: bool = Field(
        default=False,
        description=(
            "If true and transcript_text is empty, run existing Whisper STT once "
            "for speech-rate and linguistic confidence cues"
        ),
    )
    language: str = Field(default="en", min_length=2, max_length=10)
    options: dict[str, Any] = Field(default_factory=dict)

    model_config = {
        "json_schema_extra": {
            "examples": [
                {
                    "source_url": (
                        "https://www.voiptroubleshooter.com/open_speech/american/"
                        "OSR_us_000_0010_8k.wav"
                    ),
                    "audio_mime_type": "audio/wav",
                    "language": "en",
                    "run_transcription": False,
                }
            ]
        }
    }

    @model_validator(mode="after")
    def require_one_source(self) -> "AudioAnalysisRequest":
        if bool(self.audio_base64) == bool(self.source_url):
            raise ValueError("Provide exactly one of audio_base64 or source_url")
        return self


class AudioAnalysisResponse(StubMeta):
    """Acoustic metrics + speech patterns / delivery / confidence indicators.

    Not a hiring or personality assessment.
    """

    correlation_id: UUID | None = None
    interview_id: str | None = None
    audio_duration_seconds: float | None = None
    sample_rate: int | None = None
    speech_duration_seconds: float | None = None
    silence_duration_seconds: float | None = None
    silence_percentage: float | None = None
    pause_count: int | None = None
    pause_stats: PauseStats | None = None
    words_per_minute: float | None = None
    word_count: int | None = None
    pitch_median_hz: float | None = None
    pitch_range_hz: float | None = None
    pitch_std_hz: float | None = None
    pitch_available: bool = False
    zero_crossing_rate_mean: float | None = None
    spectral_centroid_mean_hz: float | None = None
    rms_energy_mean: float | None = None
    rms_energy_std: float | None = None
    audio_quality: AudioQualityInfo = Field(default_factory=AudioQualityInfo)
    # Voice evaluation (completed on this same endpoint)
    overall_delivery_score: float | None = None
    speech_patterns: SpeechPatterns | None = None
    delivery: DeliveryScore | None = None
    confidence_indicators: ConfidenceIndicators | None = None
    strengths: list[str] = Field(default_factory=list)
    improvement_areas: list[str] = Field(default_factory=list)
    summary: str | None = None
    transcript_used: bool = False
    transcription_status: str | None = Field(
        default=None,
        description="skipped | succeeded | failed | not_requested",
    )
    features: dict[str, Any] = Field(
        default_factory=dict,
        description="Compact feature map for confidence/behavioral/communication passthrough",
    )
    limitations: list[str] = Field(default_factory=list)
    error_code: str | None = None
