from __future__ import annotations from typing import Literal from pydantic import BaseModel, Field VideoStatus = Literal["queued", "processing", "completed", "failed"] ResultSource = Literal["speech", "visual"] SearchDetail = Literal["fine", "medium", "coarse"] class UploadVideoResponse(BaseModel): video_id: str status: VideoStatus class VideoStatusResponse(BaseModel): video_id: str status: VideoStatus error: str | None = None class TranscriptChunkResponse(BaseModel): start: float end: float text: str class TranscriptResponse(BaseModel): video_id: str chunks: list[TranscriptChunkResponse] class SearchRequest(BaseModel): query: str = Field(min_length=1) include_visual: bool = False limit: int = Field(default=10, ge=1, le=100) detail: SearchDetail = "fine" window_seconds: float | None = Field(default=None, ge=2.0, le=120.0) merge_gap_seconds: float | None = Field(default=None, ge=0.0, le=30.0) class SearchResultResponse(BaseModel): start: float end: float start_time: str end_time: str timestamp: str text: str score: float source: ResultSource class SearchResponse(BaseModel): video_id: str query: str results: list[SearchResultResponse]