vocalstack 1.0.0a0__py3-none-any.whl

vocalstack/_models.py

@@ -0,0 +1,1745 @@
+# GENERATED by @vocalstack/contract tools/generate.mjs — do not edit.
+from __future__ import annotations
+
+import json
+from typing import Annotated, Any, Dict, List, Literal, Optional, Union
+
+from pydantic import BaseModel, ConfigDict, Field, TypeAdapter
+
+
+class _Base(BaseModel):
+    # extra="ignore": additive contract changes must not break clients.
+    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+
+
+Access = Literal["public", "private"]
+
+ErrorCode = Literal["invalid_audio", "invalid_options", "invalid_token", "capacity_exceeded", "slow_consumer", "engine_unavailable", "internal", "session_expired", "forbidden", "broadcast_archived", "not_found", "conflict", "invalid_state", "password_required", "rate_limited", "preview_pending", "language_unavailable", "suspended", "key_expired", "key_revoked", "key_from_browser", "insufficient_credit", "payment_method_required", "payment_method_in_use", "billing_details_required", "promo_code_invalid", "auto_top_up_off", "range_too_long", "quota_exceeded", "idempotency_key_reused", "method_not_allowed", "payload_too_large", "unsupported_media_type", "invalid_body", "timeout", "unavailable"]
+
+AudioEncoding = Literal["pcm_f32le"]
+
+FixKind = Literal["extension", "scheme", "page_stream"]
+
+SourceProblem = Literal["not_found", "refused", "server_error", "unknown_host", "unreachable", "private_address", "timeout", "web_page", "bad_playlist", "not_audio", "unsupported", "youtube_upcoming", "youtube_not_live", "youtube_unavailable", "youtube_busy"]
+
+AudioSourceState = Literal["ready", "error"]
+
+RecordingState = Literal["pending", "live", "paused", "processing", "ended", "finalized"]
+
+Lifecycle = Literal["active", "archived", "purged"]
+
+LatencyMode = Literal["auto", "fast", "accuracy"]
+
+SpeakerLabels = Literal["auto", "on", "off"]
+
+Decoder = Literal["fast", "accuracy"]
+
+NotVoicedReason = Literal["rewrite"]
+
+DoneReason = Literal["eof", "max_duration", "cancelled"]
+
+ExportFormat = Literal["json", "srt", "xlsx", "pdf"]
+
+HealthStatus = Literal["ok"]
+
+IngestState = Literal["connecting", "streaming", "reconnecting", "stopped", "failed"]
+
+InputKind = Literal["live", "file", "url", "stream"]
+
+JobState = Literal["queued", "fetching", "transcribing", "done", "failed", "cropping"]
+
+LinkKind = Literal["live", "file", "unknown"]
+
+LoadingStage = Literal["download", "model"]
+
+RecordingKind = Literal["live", "upload"]
+
+SourceKind = Literal["file", "url"]
+
+PullState = Literal["connecting", "streaming", "reconnecting", "failed"]
+
+SentenceStatus = Literal["open", "closed", "dropped"]
+
+VoiceStatusState = Literal["preparing", "unavailable"]
+
+
+class Actor(_Base):
+    api_key_id: Optional[str] = Field(default=None, alias="apiKeyId")
+    display_name: Optional[str] = Field(default=None, alias="displayName")
+    user_id: Optional[str] = Field(default=None, alias="userId")
+
+
+class WordAlt(_Base):
+    prob: float
+    text: str
+
+
+class Word(_Base):
+    alts: Optional[List["WordAlt"]] = None
+    end: float
+    llm: Optional[bool] = None
+    prob: Optional[float] = None
+    recognized: Optional[str] = None
+    script: Optional[bool] = None
+    start: float
+    text: str
+
+
+class AmendTail(_Base):
+    """The words an amend gave a segment's end: `words` replace its last
+`replaced` words."""
+
+    replaced: int
+    words: List["Word"]
+
+
+class ErrorData(_Base):
+    details: Optional[Any] = None
+    retryable: bool
+
+
+class ApiErrorBody(_Base):
+    code: ErrorCode
+    data: "ErrorData"
+    defined: bool
+    message: str
+    request_id: Optional[str] = Field(default=None, alias="requestId")
+    status: int
+
+
+class AudioCapabilities(_Base):
+    channels: List[int]
+    encodings: List[AudioEncoding]
+    sample_rates: List[int] = Field(alias="sampleRates")
+
+
+class AudioFormat(_Base):
+    channels: Optional[int] = None
+    encoding: Optional[AudioEncoding] = None
+    sample_rate: Optional[int] = Field(default=None, alias="sampleRate")
+
+
+class AudioSource(_Base):
+    """A stream a broadcast can record from (`Broadcast.audioSources`, design
+78): a YouTube live or an internet radio address kept with the
+broadcast.  `POST /v1/broadcasts/{id}/recordings` with `audioSource` set
+to its id starts a recording of it."""
+
+    id: str
+    name: str
+    url: str
+
+
+class AudioSourceFix(_Base):
+    """An address that was opened and gave audio, offered in place of the one
+that did not."""
+
+    kind: FixKind
+    label: str
+    url: str
+
+
+class AudioSourceCheck(_Base):
+    """`GET /v1/broadcasts/{id}/audio-sources/{source}/check`."""
+
+    checked_at: str = Field(alias="checkedAt")
+    fix: Optional["AudioSourceFix"] = None
+    http_status: Optional[int] = Field(default=None, alias="httpStatus")
+    message: Optional[str] = None
+    problem: Optional[SourceProblem] = None
+    state: AudioSourceState
+
+
+class AutoTopUpAttempt(_Base):
+    amount: float
+    at: str
+    outcome: str
+
+
+class MoneyRange(_Base):
+    """Two amounts, both inclusive."""
+
+    max: float
+    min: float
+
+
+class AutoTopUpChoices(_Base):
+    amount_range: "MoneyRange" = Field(alias="amountRange")
+    amounts: List[float]
+    threshold_range: "MoneyRange" = Field(alias="thresholdRange")
+    thresholds: List[float]
+
+
+class AutoTopUpSettings(_Base):
+    """`PUT /v1/billing/auto-top-up`."""
+
+    amount: Optional[float] = None
+    enabled: bool
+    threshold: Optional[float] = None
+
+
+class AutoTopUpView(_Base):
+    amount: Optional[float] = None
+    available: bool
+    enabled: bool
+    last: Optional["AutoTopUpAttempt"] = None
+    offered: bool
+    threshold: Optional[float] = None
+
+
+class BillingDetails(_Base):
+    """`GET / PUT /v1/billing/details`."""
+
+    city: Optional[str] = None
+    country: Optional[str] = None
+    email: Optional[str] = None
+    line1: Optional[str] = None
+    name: Optional[str] = None
+    postal_code: Optional[str] = Field(default=None, alias="postalCode")
+    tax_id: Optional[str] = Field(default=None, alias="taxId")
+
+
+class CardView(_Base):
+    brand: str
+    declined: bool
+    exp_month: Optional[int] = Field(default=None, alias="expMonth")
+    exp_year: Optional[int] = Field(default=None, alias="expYear")
+    last4: str
+
+
+class Limits2(_Base):
+    """The limits of a version.  `null` is unlimited."""
+
+    concurrent_transcriptions: Optional[int] = Field(default=None, alias="concurrentTranscriptions")
+    creates_per_hour: Optional[int] = Field(default=None, alias="createsPerHour")
+    creates_per_hour_unpaid: Optional[int] = Field(default=None, alias="createsPerHourUnpaid")
+    max_file_bytes: Optional[int] = Field(default=None, alias="maxFileBytes")
+    max_live_seconds: Optional[int] = Field(default=None, alias="maxLiveSeconds")
+    requests_per_min: Optional[int] = Field(default=None, alias="requestsPerMin")
+    retention_audio_days: Optional[int] = Field(default=None, alias="retentionAudioDays")
+    retention_transcriptions_days: Optional[int] = Field(default=None, alias="retentionTranscriptionsDays")
+    retention_voices_days: Optional[int] = Field(default=None, alias="retentionVoicesDays")
+
+
+class LimitsUsage(_Base):
+    """The plan's counted limits, as used now."""
+
+    concurrent_limit: Optional[int] = Field(default=None, alias="concurrentLimit")
+    create_limit: Optional[int] = Field(default=None, alias="createLimit")
+    created_last_hour: int = Field(alias="createdLastHour")
+    resets_at: Optional[str] = Field(default=None, alias="resetsAt")
+    running: int
+
+
+class LowBalanceAlertView(_Base):
+    enabled: bool
+    threshold: float
+
+
+class MonthlyCreditView(_Base):
+    granted: float
+    granted_at: str = Field(alias="grantedAt")
+    remaining: float
+    renews_at: Optional[str] = Field(default=None, alias="renewsAt")
+    used: float
+
+
+class Rates(_Base):
+    """The rates of a version, in dollars per hour."""
+
+    file_per_hour: float = Field(alias="filePerHour")
+    live_per_hour: float = Field(alias="livePerHour")
+
+
+class PendingChange(_Base):
+    applies_at: str = Field(alias="appliesAt")
+    rates: "Rates"
+
+
+class PendingPayment(_Base):
+    amount: float
+    kind: str
+    since: str
+
+
+class DateRange(_Base):
+    """Two days, both inclusive (`YYYY-MM-DD`)."""
+
+    end: str
+    start: str
+
+
+class PlanRef(_Base):
+    id: str
+    kind: str
+    name: str
+
+
+class NextPayment(_Base):
+    amount: float
+    at: str
+
+
+class PendingInterval(_Base):
+    applies_at: str = Field(alias="appliesAt")
+    interval: str
+
+
+class SubscriptionView(_Base):
+    cancel_at_period_end: bool = Field(alias="cancelAtPeriodEnd")
+    current_period_end: Optional[str] = Field(default=None, alias="currentPeriodEnd")
+    current_period_start: Optional[str] = Field(default=None, alias="currentPeriodStart")
+    interval: str
+    next_payment: Optional["NextPayment"] = Field(default=None, alias="nextPayment")
+    past_due_since: Optional[str] = Field(default=None, alias="pastDueSince")
+    pending_interval: Optional["PendingInterval"] = Field(default=None, alias="pendingInterval")
+    status: str
+
+
+class BillingView(_Base):
+    """`GET /v1/billing`: the account as the Dashboard shows it.  The plan's
+debt cap (the grace amount) is never on it: `inGrace` says whether
+running transcriptions go on below zero, never how far."""
+
+    account_created: Optional[str] = Field(default=None, alias="accountCreated")
+    auto_top_up: "AutoTopUpView" = Field(alias="autoTopUp")
+    balance: float
+    can_start: bool = Field(alias="canStart")
+    card: Optional["CardView"] = None
+    enabled: bool
+    has_paid: bool = Field(alias="hasPaid")
+    in_grace: bool = Field(alias="inGrace")
+    limits: Optional["Limits2"] = None
+    limits_usage: Optional["LimitsUsage"] = Field(default=None, alias="limitsUsage")
+    low_balance_alert: "LowBalanceAlertView" = Field(alias="lowBalanceAlert")
+    monthly_credit: Optional["MonthlyCreditView"] = Field(default=None, alias="monthlyCredit")
+    pending_change: Optional["PendingChange"] = Field(default=None, alias="pendingChange")
+    pending_payment: Optional["PendingPayment"] = Field(default=None, alias="pendingPayment")
+    period: Optional["DateRange"] = None
+    plan: Optional["PlanRef"] = None
+    previous_period: Optional["DateRange"] = Field(default=None, alias="previousPeriod")
+    rates: Optional["Rates"] = None
+    retention_deadline: Optional[str] = Field(default=None, alias="retentionDeadline")
+    start_block: Optional[str] = Field(default=None, alias="startBlock")
+    subscription: Optional["SubscriptionView"] = None
+    top_up_url: str = Field(alias="topUpUrl")
+
+
+class CurrentRecording(_Base):
+    """The recording in flight (`currentRecording`): on a transcription, its
+open recording; on a broadcast, the open recording
+of a live transcription feeding it, which is what its listeners are sent."""
+
+    recording_id: str = Field(alias="recordingId")
+    started_at: Optional[str] = Field(default=None, alias="startedAt")
+    state: RecordingState
+    transcription_id: Optional[str] = Field(default=None, alias="transcriptionId")
+
+
+class LastRecording(_Base):
+    """A live transcription's newest recording (`lastRecording`): what
+its row in a list reads from — how long it ran, when, and whether it is
+still running — and the recording a tap on that row opens."""
+
+    duration_s: Optional[float] = Field(default=None, alias="durationS")
+    recording_id: str = Field(alias="recordingId")
+    started_at: Optional[str] = Field(default=None, alias="startedAt")
+    state: RecordingState
+    title: Optional[str] = None
+    transcription_id: Optional[str] = Field(default=None, alias="transcriptionId")
+
+
+class ConfidencePolicy(_Base):
+    """Env defaults, overridden per broadcast, transcription or recording."""
+
+    hide_below: Optional[float] = Field(default=None, alias="hideBelow")
+    low_threshold: Optional[float] = Field(default=None, alias="lowThreshold")
+    suppress_count: Optional[int] = Field(default=None, alias="suppressCount")
+
+
+class Settings(_Base):
+    """A broadcast's, transcription's or recording's capture settings (the
+design's settings sheet): what a recording made in it starts with."""
+
+    confidence: Optional["ConfidencePolicy"] = None
+    latency_mode: Optional[LatencyMode] = Field(default=None, alias="latencyMode")
+    llm_fix: Optional[bool] = Field(default=None, alias="llmFix")
+    max_duration_s: Optional[int] = Field(default=None, alias="maxDurationS")
+    max_pause_s: Optional[int] = Field(default=None, alias="maxPauseS")
+    silence_auto_pause_s: Optional[int] = Field(default=None, alias="silenceAutoPauseS")
+    speaker_labels: Optional[SpeakerLabels] = Field(default=None, alias="speakerLabels")
+    spoken_language: Optional[str] = Field(default=None, alias="spokenLanguage")
+    voice: Optional[bool] = None
+    voice_by_lang: Optional[Dict[str, str]] = Field(default=None, alias="voiceByLang")
+
+
+class TranscriptionRef(_Base):
+    """A live transcription feeding a broadcast (`Broadcast.transcriptions`)."""
+
+    id: str
+    last_recorded_at: Optional[str] = Field(default=None, alias="lastRecordedAt")
+    made: Optional[bool] = None
+    name: str
+    recording: bool
+    source: "CaptureSource"
+
+
+class Broadcast(_Base):
+    """A broadcast: the link listeners open (`code`), fed by the live
+transcriptions attached to it (`transcriptions`) or recording one of
+its own audio sources (`audioSources`). Its recordings are made in
+those live transcriptions."""
+
+    access: Access
+    archived_at: Optional[str] = Field(default=None, alias="archivedAt")
+    audio_sources: Optional[List["AudioSource"]] = Field(default=None, alias="audioSources")
+    code: str
+    created_at: str = Field(alias="createdAt")
+    current_recording: Optional["CurrentRecording"] = Field(default=None, alias="currentRecording")
+    id: str
+    kind: Literal["broadcast"] = "broadcast"
+    last_recorded_at: Optional[str] = Field(default=None, alias="lastRecordedAt")
+    last_recording: Optional["LastRecording"] = Field(default=None, alias="lastRecording")
+    lifecycle: Lifecycle
+    listeners_now: Optional[int] = Field(default=None, alias="listenersNow")
+    name: str
+    owner_principal_id: str = Field(alias="ownerPrincipalId")
+    purge_after: Optional[str] = Field(default=None, alias="purgeAfter")
+    recording_count: int = Field(alias="recordingCount")
+    settings: "Settings"
+    share_url: str = Field(alias="shareUrl")
+    source: "CaptureSource"
+    transcriptions: Optional[List["TranscriptionRef"]] = None
+    updated_at: str = Field(alias="updatedAt")
+
+
+class BroadcastRef(_Base):
+    """A broadcast a live transcription feeds (`Transcription.broadcasts`)."""
+
+    access: Access
+    code: str
+    id: str
+    name: str
+    share_url: str = Field(alias="shareUrl")
+
+
+class Limits(_Base):
+    audio_buffer_s: int = Field(alias="audioBufferS")
+    max_duration_s: int = Field(alias="maxDurationS")
+    max_upload_bytes: int = Field(alias="maxUploadBytes")
+    recording_max_duration_s: Optional[int] = Field(default=None, alias="recordingMaxDurationS")
+    session_token_ttl_s: int = Field(alias="sessionTokenTtlS")
+
+
+class Capabilities(_Base):
+    audio: "AudioCapabilities"
+    languages: List[str]
+    latency_modes: List[LatencyMode] = Field(alias="latencyModes")
+    limits: "Limits"
+    speaker_label_modes: List[SpeakerLabels] = Field(alias="speakerLabelModes")
+
+
+class CaptureSpan(_Base):
+    idx: int
+    media_end: Optional[float] = Field(default=None, alias="mediaEnd")
+    media_start: float = Field(alias="mediaStart")
+    reason: str
+    wall_end: Optional[float] = Field(default=None, alias="wallEnd")
+    wall_start: float = Field(alias="wallStart")
+
+
+class RecordingCharge(_Base):
+    """A charge on the wire (`GET /v1/billing/charges`)."""
+
+    amount: float
+    kind: str
+    name: Optional[str] = None
+    opened_at: str = Field(alias="openedAt")
+    rate_per_hour: float = Field(alias="ratePerHour")
+    recording_id: str = Field(alias="recordingId")
+    seconds_billed: float = Field(alias="secondsBilled")
+    settled_at: Optional[str] = Field(default=None, alias="settledAt")
+    state: str
+    transcription_id: Optional[str] = Field(default=None, alias="transcriptionId")
+
+
+class ChargePage(_Base):
+    """`GET /v1/billing/charges`."""
+
+    charges: List["RecordingCharge"]
+    next_cursor: Optional[str] = Field(default=None, alias="nextCursor")
+
+
+class CheckPromoCode(_Base):
+    """`POST /v1/billing/promo-codes/check`."""
+
+    code: str
+    for_: str = Field(alias="for")
+
+
+class CheckoutView(_Base):
+    """A checkout as the Dashboard sees it."""
+
+    amount: Optional[float] = None
+    checkout_id: str = Field(alias="checkoutId")
+    completed_at: Optional[str] = Field(default=None, alias="completedAt")
+    created_at: str = Field(alias="createdAt")
+    expires_at: Optional[str] = Field(default=None, alias="expiresAt")
+    interval: Optional[str] = None
+    kind: str
+    plan_id: Optional[str] = Field(default=None, alias="planId")
+    status: str
+    url: Optional[str] = None
+
+
+class CommittedSegment(_Base):
+    catchup: Optional[bool] = None
+    confidence: Optional[float] = None
+    decoder: Optional[Decoder] = None
+    end: float
+    gap_before: Optional[float] = Field(default=None, alias="gapBefore")
+    language: Optional[str] = None
+    latency_s: Optional[float] = Field(default=None, alias="latencyS")
+    recognized_text: Optional[str] = Field(default=None, alias="recognizedText")
+    script_from: Optional[int] = Field(default=None, alias="scriptFrom")
+    script_pos: Optional[int] = Field(default=None, alias="scriptPos")
+    seq: int
+    speaker: int
+    speaker_confidence: Optional[float] = Field(default=None, alias="speakerConfidence")
+    speaker_provisional: Optional[bool] = Field(default=None, alias="speakerProvisional")
+    start: float
+    text: str
+    translation_sources: Optional[Dict[str, str]] = Field(default=None, alias="translationSources")
+    translations: Optional[Dict[str, str]] = None
+    words: List["Word"]
+
+
+class Correction(_Base):
+    actor: "Actor"
+    applied_at: str = Field(alias="appliedAt")
+    batch_id: str = Field(alias="batchId")
+    from_: str = Field(alias="from")
+    id: str
+    kind: str
+    not_voiced_reason: Optional[NotVoicedReason] = Field(default=None, alias="notVoicedReason")
+    reverted_at: Optional[str] = Field(default=None, alias="revertedAt")
+    seq: Optional[int] = None
+    speaker: Optional[int] = None
+    to: str
+    voiced: Optional[bool] = None
+    word_idx: Optional[int] = Field(default=None, alias="wordIdx")
+
+
+class WordEdit(_Base):
+    seq: int
+    to: str
+    word_idx: int = Field(alias="wordIdx")
+
+
+class LineEdit(_Base):
+    """Retype a whole segment. The word count may change; the new words are
+timed evenly across the segment's span and all count as settled."""
+
+    seq: int
+    to: str
+
+
+class CorrectionBatch(_Base):
+    edits: Optional[List["WordEdit"]] = None
+    lines: Optional[List["LineEdit"]] = None
+
+
+class CorrectionPage(_Base):
+    """`GET /v1/recordings/{id}/corrections`: one page, newest first."""
+
+    corrections: List["Correction"]
+    next_cursor: Optional[str] = Field(default=None, alias="nextCursor")
+
+
+class CreateAudioSource(_Base):
+    """`POST /v1/broadcasts/{id}/audio-sources`."""
+
+    name: Optional[str] = None
+    url: str
+
+
+class CreateBroadcast(_Base):
+    """`POST /v1/broadcasts`."""
+
+    access: Optional[Access] = None
+    code: Optional[str] = None
+    name: str
+    password: Optional[str] = None
+    settings: Optional["Settings"] = None
+    source: Optional["CaptureSource"] = None
+
+
+class CreateCheckout(_Base):
+    """`POST /v1/billing/checkouts`."""
+
+    accept_terms: Optional[bool] = Field(default=None, alias="acceptTerms")
+    amount: Optional[float] = None
+    interval: Optional[str] = None
+    kind: str
+    plan_id: Optional[str] = Field(default=None, alias="planId")
+    promo_code: Optional[str] = Field(default=None, alias="promoCode")
+    waive_withdrawal: Optional[bool] = Field(default=None, alias="waiveWithdrawal")
+
+
+class CreateLiveTranscription(_Base):
+    """`POST /v1/transcriptions/live`: a transcription captured as it is
+spoken — this device's microphone, or a stream the server pulls.
+It is created idle; `POST /v1/transcriptions/{id}/recordings` starts it."""
+
+    broadcasts: Optional[List[str]] = None
+    name: str
+    settings: Optional["Settings"] = None
+    source: Optional["CaptureSource"] = None
+
+
+class CreateSessionResponse(_Base):
+    expires_at: str = Field(alias="expiresAt")
+    session_id: str = Field(alias="sessionId")
+    stream_url: str = Field(alias="streamUrl")
+
+
+class CreateShareLink(_Base):
+    allow_download: Optional[bool] = Field(default=None, alias="allowDownload")
+    allow_export: Optional[bool] = Field(default=None, alias="allowExport")
+    allow_translate: Optional[bool] = Field(default=None, alias="allowTranslate")
+    label: str
+
+
+class SettingsPatch(_Base):
+    """Partial update (PATCH) — every field optional, `null` for
+`spokenLanguage` means back to auto-detect."""
+
+    confidence: Optional["ConfidencePolicy"] = None
+    latency_mode: Optional[LatencyMode] = Field(default=None, alias="latencyMode")
+    llm_fix: Optional[bool] = Field(default=None, alias="llmFix")
+    max_duration_s: Optional[int] = Field(default=None, alias="maxDurationS")
+    max_pause_s: Optional[int] = Field(default=None, alias="maxPauseS")
+    silence_auto_pause_s: Optional[int] = Field(default=None, alias="silenceAutoPauseS")
+    speaker_labels: Optional[SpeakerLabels] = Field(default=None, alias="speakerLabels")
+    spoken_language: Optional[str] = Field(default=None, alias="spokenLanguage")
+    voice: Optional[bool] = None
+    voice_by_lang: Optional[Dict[str, str]] = Field(default=None, alias="voiceByLang")
+
+
+class CreateTranscription(_Base):
+    """`POST /v1/transcriptions`: JSON for a URL, or the `options` part of a
+multipart upload whose `file` part carries the media."""
+
+    crop: Optional[bool] = None
+    duration_s: Optional[float] = Field(default=None, alias="durationS")
+    end_s: Optional[float] = Field(default=None, alias="endS")
+    name: Optional[str] = None
+    settings: Optional["SettingsPatch"] = None
+    share_link: Optional[bool] = Field(default=None, alias="shareLink")
+    start_s: Optional[float] = Field(default=None, alias="startS")
+    url: Optional[str] = None
+
+
+class CreateVoice(_Base):
+    color: Optional[str] = None
+    consent: Optional[bool] = None
+    draft: Optional[bool] = None
+    gender: Optional[str] = None
+    name: str
+    sample_url: Optional[str] = Field(default=None, alias="sampleUrl")
+
+
+class CreateVoiceFromSpeaker(_Base):
+    color: Optional[str] = None
+    consent: Optional[bool] = None
+    name: str
+    recording_id: str = Field(alias="recordingId")
+    speaker: int
+
+
+class CropRange(_Base):
+    """A window of a file, in seconds into it.  `end_s` absent = to the end."""
+
+    end_s: Optional[float] = Field(default=None, alias="endS")
+    start_s: Optional[float] = Field(default=None, alias="startS")
+
+
+class CropWindow(_Base):
+    """A window of the source, in seconds into it.  `end_s` absent = to the end."""
+
+    end_s: Optional[float] = Field(default=None, alias="endS")
+    start_s: float = Field(alias="startS")
+
+
+class DraftSegment(_Base):
+    speaker: int
+    start: float
+    tentative: bool
+    text: str
+    translations: Optional[Dict[str, str]] = None
+
+
+class EventOptions(_Base):
+    drafts: Optional[bool] = None
+    words: Optional[bool] = None
+
+
+class Fix(_Base):
+    """One word-level correction inside a `transcript.amended` frame."""
+
+    kind: str
+    orig: str
+    repl: str
+
+
+class Health(_Base):
+    status: HealthStatus
+
+
+class InputOptions(_Base):
+    crop: Optional["CropRange"] = None
+    kind: Optional[InputKind] = None
+    prepare: Optional[bool] = None
+    url: Optional[str] = None
+
+
+class JobProgress(_Base):
+    fetch_total_bytes: Optional[int] = Field(default=None, alias="fetchTotalBytes")
+    fetched_bytes: Optional[int] = Field(default=None, alias="fetchedBytes")
+    pct: int
+    phase: Optional[str] = None
+    phase_pct: Optional[int] = Field(default=None, alias="phasePct")
+    processed_s: float = Field(alias="processedS")
+    segments_done: int = Field(alias="segmentsDone")
+    segments_total: Optional[int] = Field(default=None, alias="segmentsTotal")
+    total_s: Optional[float] = Field(default=None, alias="totalS")
+
+
+class KnownVoice(_Base):
+    """One voice a realtime session may recognise a speaker as.
+
+The `id` is a cloned voice's id; the engine loads its embedding from
+the same place it loads the voice itself, so a caller names the voice
+and never carries a vector over the wire.  `name` is what to call the
+person when they are recognised — the voice's own name, ordinarily,
+but the caller's to choose, because a voice called "Marcus —
+narration" belongs to a person called Marcus Reed."""
+
+    color: Optional[str] = None
+    id: str
+    name: str
+
+
+class LanguageInfo(_Base):
+    code: str
+    flag: Optional[str] = None
+    name: str
+    native: str
+    preview_line: Optional[str] = Field(default=None, alias="previewLine")
+    speakers_m: Optional[int] = Field(default=None, alias="speakersM")
+    transcription: bool
+    translation: bool
+    voice: bool
+
+
+class LanguageLists(_Base):
+    languages: List["LanguageInfo"]
+    transcription: List[str]
+    translation: List[str]
+    voice: List[str]
+
+
+class LedgerEntry(_Base):
+    """A ledger entry on the wire (`GET /v1/billing/ledger`)."""
+
+    amount: float
+    balance_after: float = Field(alias="balanceAfter")
+    created_at: str = Field(alias="createdAt")
+    description: str
+    id: str
+    kind: str
+    metadata: Any
+    provider_order_id: Optional[str] = Field(default=None, alias="providerOrderId")
+    realtime_session_id: Optional[str] = Field(default=None, alias="realtimeSessionId")
+    recording_id: Optional[str] = Field(default=None, alias="recordingId")
+    staff_user: Optional[str] = Field(default=None, alias="staffUser")
+    subscription_id: Optional[str] = Field(default=None, alias="subscriptionId")
+
+
+class LedgerPage(_Base):
+    """`GET /v1/billing/ledger`."""
+
+    entries: List["LedgerEntry"]
+    next_cursor: Optional[str] = Field(default=None, alias="nextCursor")
+
+
+class LinkProbe(_Base):
+    kind: LinkKind
+    ok: bool
+    problem: Optional[str] = None
+    source: str
+
+
+class LowBalanceAlertChoices(_Base):
+    default: float
+    presets: List[float]
+    range: "MoneyRange"
+
+
+class LowBalanceAlertSettings(_Base):
+    """`PUT /v1/billing/low-balance-alert`."""
+
+    enabled: bool
+    threshold: Optional[float] = None
+
+
+class MediaSummary(_Base):
+    bytes: int
+    codec: str
+    container: str
+    duration_s: Optional[float] = Field(default=None, alias="durationS")
+    kind: str
+    state: str
+
+
+class NameSpeaker(_Base):
+    name: Optional[str] = None
+
+
+class PatchVoice(_Base):
+    color: Optional[str] = None
+    consent: Optional[bool] = None
+    draft: Optional[bool] = None
+    enabled: Optional[bool] = None
+    gender: Optional[str] = None
+    name: Optional[str] = None
+
+
+class Payment(_Base):
+    """One line of the history."""
+
+    amount: float
+    at: str
+    description: str
+    document: Optional[str] = None
+    id: str
+    kind: str
+    status: str
+
+
+class PaymentDocument(_Base):
+    """`GET /v1/billing/payments/:id/document`: `url` when it is ready,
+`pending: true` (with `202`) while the provider makes it."""
+
+    pending: Optional[bool] = None
+    url: Optional[str] = None
+
+
+class PaymentMethodView(_Base):
+    """One saved method."""
+
+    brand: str
+    declined: bool
+    exp_month: Optional[int] = Field(default=None, alias="expMonth")
+    exp_year: Optional[int] = Field(default=None, alias="expYear")
+    id: str
+    is_default: bool = Field(alias="isDefault")
+    last4: str
+    wallet: Optional[str] = None
+
+
+class PaymentMethodList(_Base):
+    """`GET /v1/billing/payment-methods`."""
+
+    methods: List["PaymentMethodView"]
+
+
+class PaymentPage(_Base):
+    """`GET /v1/billing/payments`."""
+
+    next_cursor: Optional[str] = Field(default=None, alias="nextCursor")
+    payments: List["Payment"]
+
+
+class PlanListing(_Base):
+    """One plan on the price list: its current version's rates, prices,
+credit, limits and features."""
+
+    billed_externally: bool = Field(alias="billedExternally")
+    features: Any
+    grace_on_zero: bool = Field(alias="graceOnZero")
+    id: str
+    kind: str
+    limits: "Limits2"
+    monthly_credit: float = Field(alias="monthlyCredit")
+    name: str
+    price_month: float = Field(alias="priceMonth")
+    price_year: float = Field(alias="priceYear")
+    rates: "Rates"
+    warm_start: str = Field(alias="warmStart")
+
+
+class PlanList(_Base):
+    """`GET /v1/billing/plans`."""
+
+    auto_top_up: "AutoTopUpChoices" = Field(alias="autoTopUp")
+    downgrade_grace_days: int = Field(alias="downgradeGraceDays")
+    enabled: bool
+    low_balance_alert: "LowBalanceAlertChoices" = Field(alias="lowBalanceAlert")
+    plans: List["PlanListing"]
+    signup_credit: float = Field(alias="signupCredit")
+    top_up_amounts: List[float] = Field(alias="topUpAmounts")
+    top_up_range: "MoneyRange" = Field(alias="topUpRange")
+
+
+class PortalLink(_Base):
+    """`GET /v1/billing/portal`."""
+
+    url: str
+
+
+class PromoCodeView(_Base):
+    """What a promo code gives for the purchase it was checked for."""
+
+    bonus_credit: Optional[float] = Field(default=None, alias="bonusCredit")
+    code: str
+    description: str
+    first_payment_discount: Optional[float] = Field(default=None, alias="firstPaymentDiscount")
+
+
+class StreamIngest(_Base):
+    """The server-side publisher of a stream source's recording, on the
+`Recording` DTO as `ingest`."""
+
+    attempts: int
+    bytes_in: int = Field(alias="bytesIn")
+    detected: Optional[str] = None
+    error: Optional[str] = None
+    failures: int
+    finished_at: Optional[str] = Field(default=None, alias="finishedAt")
+    last_audio_at: Optional[str] = Field(default=None, alias="lastAudioAt")
+    media_at: Optional[str] = Field(default=None, alias="mediaAt")
+    media_s: float = Field(alias="mediaS")
+    started_at: Optional[str] = Field(default=None, alias="startedAt")
+    state: IngestState
+    stream_started_at: Optional[str] = Field(default=None, alias="streamStartedAt")
+    updated_at: str = Field(alias="updatedAt")
+    url: str
+
+
+class RecordingMetrics(_Base):
+    settle_p50_s: Optional[float] = Field(default=None, alias="settleP50S")
+    settle_p95_s: Optional[float] = Field(default=None, alias="settleP95S")
+    silence_paused: int = Field(alias="silencePaused")
+    suppressed_segments: Optional[int] = Field(default=None, alias="suppressedSegments")
+    translation_latency_p50_s: Optional[float] = Field(default=None, alias="translationLatencyP50S")
+
+
+class PublisherInfo(_Base):
+    attached: bool
+    lease_expires_at: Optional[str] = Field(default=None, alias="leaseExpiresAt")
+    machine_id: Optional[str] = Field(default=None, alias="machineId")
+
+
+class SourceInfo(_Base):
+    """What the recording was made from (design `j.meta`: "M4A · 34.2 MB",
+"Video URL")."""
+
+    bytes: Optional[int] = None
+    duration_s: Optional[float] = Field(default=None, alias="durationS")
+    format: Optional[str] = None
+    kind: SourceKind
+    mime: Optional[str] = None
+    name: str
+    url: Optional[str] = None
+
+
+class Recording(_Base):
+    created_at: str = Field(alias="createdAt")
+    end_reason: Optional[str] = Field(default=None, alias="endReason")
+    ended_at: Optional[str] = Field(default=None, alias="endedAt")
+    finalized_at: Optional[str] = Field(default=None, alias="finalizedAt")
+    id: str
+    ingest: Optional["StreamIngest"] = None
+    kind: RecordingKind
+    last_seq: int = Field(alias="lastSeq")
+    lifecycle: Lifecycle
+    max_duration_s: int = Field(alias="maxDurationS")
+    max_pause_s: int = Field(alias="maxPauseS")
+    media: List["MediaSummary"]
+    media_duration_s: Optional[float] = Field(default=None, alias="mediaDurationS")
+    metrics: Optional["RecordingMetrics"] = None
+    peak_latency_s: Optional[float] = Field(default=None, alias="peakLatencyS")
+    peak_listeners: Optional[int] = Field(default=None, alias="peakListeners")
+    publisher: "PublisherInfo"
+    script_id: Optional[str] = Field(default=None, alias="scriptId")
+    script_text: Optional[str] = Field(default=None, alias="scriptText")
+    settings: "Settings"
+    source: Optional["SourceInfo"] = None
+    spans: List["CaptureSpan"]
+    speaker_count: Optional[int] = Field(default=None, alias="speakerCount")
+    spoken_language: Optional[str] = Field(default=None, alias="spokenLanguage")
+    started_at: Optional[str] = Field(default=None, alias="startedAt")
+    state: RecordingState
+    summarized_at: Optional[str] = Field(default=None, alias="summarizedAt")
+    summary: Optional[str] = None
+    summary_language: Optional[str] = Field(default=None, alias="summaryLanguage")
+    title: Optional[str] = None
+    transcription_id: str = Field(alias="transcriptionId")
+    wall_duration_s: Optional[float] = Field(default=None, alias="wallDurationS")
+
+
+class PublishGrant(_Base):
+    expires_at: Optional[str] = Field(default=None, alias="expiresAt")
+    recording: "Recording"
+    session_id: Optional[str] = Field(default=None, alias="sessionId")
+    stream_url: Optional[str] = Field(default=None, alias="streamUrl")
+
+
+class RecordingEvent(_Base):
+    """One durable frame of a recording, as the host's screen received it."""
+
+    at: str
+    kind: str
+    payload: Any
+    seq: int
+
+
+class RecordingEvents(_Base):
+    """`GET /v1/recordings/{id}/events`: one page of the log, in order."""
+
+    events: List["RecordingEvent"]
+    next_cursor: Optional[str] = Field(default=None, alias="nextCursor")
+
+
+class RecordingPage(_Base):
+    """A broadcast's or a transcription's recordings, one page, newest first."""
+
+    next_cursor: Optional[str] = Field(default=None, alias="nextCursor")
+    recordings: List["Recording"]
+
+
+class RetranscribeLine(_Base):
+    """Design 50: read one line's audio again in a named language.
+
+Not an edit the caller writes — an edit the caller ASKS FOR: the text
+comes from the recognizer, and lands as the same `line` corrections a
+hand-typed rewrite would."""
+
+    lang: str
+    seqs: List[int]
+
+
+class RtmpStatus(_Base):
+    """`GET /v1/rtmp`: what the setup panel shows."""
+
+    audio: Optional[str] = None
+    enabled: bool
+    live: bool
+    masked_stream_key: str = Field(alias="maskedStreamKey")
+    monitor_url: str = Field(alias="monitorUrl")
+    server_url: str = Field(alias="serverUrl")
+    stream_key: Optional[str] = Field(default=None, alias="streamKey")
+
+
+class SearchHit(_Base):
+    link_code: str = Field(alias="linkCode")
+    link_name: str = Field(alias="linkName")
+    live: bool
+    media_start: float = Field(alias="mediaStart")
+    recorded_at: Optional[str] = Field(default=None, alias="recordedAt")
+    recording_id: str = Field(alias="recordingId")
+    rendered: Optional[str] = None
+    score: float
+    sentence_id: int = Field(alias="sentenceId")
+    speaker: int
+    text: str
+    transcription_id: str = Field(alias="transcriptionId")
+    wall_start: float = Field(alias="wallStart")
+
+
+class SearchResults(_Base):
+    hits: List["SearchHit"]
+    query: str
+    query_en: str = Field(alias="queryEn")
+
+
+class SegmentView(_Base):
+    catchup: bool
+    confidence: Optional[float] = None
+    corrected: bool
+    decoder: Optional[str] = None
+    end: float
+    gap_before: Optional[float] = Field(default=None, alias="gapBefore")
+    language: Optional[str] = None
+    latency_s: Optional[float] = Field(default=None, alias="latencyS")
+    script_from: Optional[int] = Field(default=None, alias="scriptFrom")
+    script_pos: Optional[int] = Field(default=None, alias="scriptPos")
+    seq: int
+    settled: bool
+    speaker: int
+    speaker_confidence: Optional[float] = Field(default=None, alias="speakerConfidence")
+    start: float
+    suppressed: Optional[bool] = None
+    text: str
+    translations: Optional[Dict[str, str]] = None
+    unclear: Optional[bool] = None
+    wall_start: float = Field(alias="wallStart")
+    words: Optional[List["Word"]] = None
+
+
+class SentenceOptions(_Base):
+    enabled: Optional[bool] = None
+    idle_close_s: Optional[float] = Field(default=None, alias="idleCloseS")
+    provisional_translations: Optional[bool] = Field(default=None, alias="provisionalTranslations")
+
+
+class SentenceSegment(_Base):
+    close_reason: Optional[str] = Field(default=None, alias="closeReason")
+    end: float
+    language: Optional[str] = None
+    provisional: Optional[bool] = None
+    sentence_id: int = Field(alias="sentenceId")
+    seqs: List[int]
+    settled: Optional[bool] = None
+    speaker: int
+    start: float
+    status: SentenceStatus
+    text: str
+    translation_latency_s: Optional[Dict[str, float]] = Field(default=None, alias="translationLatencyS")
+    translation_sources: Optional[Dict[str, str]] = Field(default=None, alias="translationSources")
+    translations: Optional[Dict[str, str]] = None
+
+
+class SentenceView(_Base):
+    end: float
+    language: Optional[str] = None
+    provisional: Optional[bool] = None
+    sentence_id: int = Field(alias="sentenceId")
+    seqs: List[int]
+    settled: bool
+    speaker: int
+    start: float
+    status: str
+    suppressed: Optional[bool] = None
+    text: str
+    translations: Optional[Dict[str, str]] = None
+    unclear: Optional[bool] = None
+    wall_start: float = Field(alias="wallStart")
+
+
+class SessionStats(_Base):
+    audio_s: float = Field(alias="audioS")
+    processing_s: float = Field(alias="processingS")
+    realtime_factor: float = Field(alias="realtimeFactor")
+
+
+class SessionOptions(_Base):
+    audio: Optional["AudioFormat"] = None
+    events: Optional["EventOptions"] = None
+    identify_voices: Optional[List["KnownVoice"]] = Field(default=None, alias="identifyVoices")
+    input: Optional["InputOptions"] = None
+    latency_mode: Optional[LatencyMode] = Field(default=None, alias="latencyMode")
+    llm_fix: Optional[bool] = Field(default=None, alias="llmFix")
+    sentences: Optional["SentenceOptions"] = None
+    speaker_labels: Optional[SpeakerLabels] = Field(default=None, alias="speakerLabels")
+    spoken_language: Optional[str] = Field(default=None, alias="spokenLanguage")
+    translate: Optional[List[str]] = None
+    voice: Optional[List[str]] = None
+    voice_by_lang: Optional[Dict[str, str]] = Field(default=None, alias="voiceByLang")
+    voice_cast: Optional[bool] = Field(default=None, alias="voiceCast")
+
+
+class SetInterval(_Base):
+    """`POST /v1/billing/subscription/interval`."""
+
+    interval: str
+
+
+class ShareLink(_Base):
+    """The broadcast or transcription something belongs to (a script, a share
+link): exactly one of `broadcastId` and `transcriptionId` is set.
+Flattened into its owner."""
+
+    allow_download: bool = Field(alias="allowDownload")
+    allow_export: bool = Field(alias="allowExport")
+    allow_translate: bool = Field(alias="allowTranslate")
+    broadcast_id: Optional[str] = Field(default=None, alias="broadcastId")
+    code: str
+    created_at: str = Field(alias="createdAt")
+    id: str
+    label: str
+    last_viewed_at: Optional[str] = Field(default=None, alias="lastViewedAt")
+    revoked_at: Optional[str] = Field(default=None, alias="revokedAt")
+    transcription_id: Optional[str] = Field(default=None, alias="transcriptionId")
+    url: str
+    views: int
+
+
+class SpeakerView(_Base):
+    gender: Optional[str] = None
+    gender_confidence: Optional[float] = Field(default=None, alias="genderConfidence")
+    identified: Optional[bool] = None
+    identified_confidence: Optional[float] = Field(default=None, alias="identifiedConfidence")
+    name: str
+    speaker: int
+    voice_color: Optional[str] = Field(default=None, alias="voiceColor")
+    voice_id: Optional[str] = Field(default=None, alias="voiceId")
+
+
+class StartJob(_Base):
+    """`POST /v1/recordings/{id}/job/start`: the window a job in
+`cropping` should transcribe.  Both bounds optional: the start of the
+file and its end."""
+
+    end_s: Optional[float] = Field(default=None, alias="endS")
+    start_s: Optional[float] = Field(default=None, alias="startS")
+
+
+class StartRecording(_Base):
+    audio_source: Optional[str] = Field(default=None, alias="audioSource")
+    device_id: Optional[str] = Field(default=None, alias="deviceId")
+    script_id: Optional[str] = Field(default=None, alias="scriptId")
+    script_text: Optional[str] = Field(default=None, alias="scriptText")
+    settings: Optional["SettingsPatch"] = None
+    takeover: Optional[bool] = None
+
+
+class StopRequest(_Base):
+    reason: Optional[str] = None
+
+
+class SummaryStatus(_Base):
+    """Where a recording's summary stands, for `POST /v1/recordings/:id/summarize`."""
+
+    lang: Optional[str] = None
+    state: str
+    summary: Optional[str] = None
+    title: Optional[str] = None
+
+
+class TranscriptSnapshot(_Base):
+    lang: Optional[str] = None
+    last_seq: int = Field(alias="lastSeq")
+    recording_id: str = Field(alias="recordingId")
+    segments: List["SegmentView"]
+    sentences: List["SentenceView"]
+    spans: List["CaptureSpan"]
+    speaker_labels: Optional[SpeakerLabels] = Field(default=None, alias="speakerLabels")
+    speakers: List["SpeakerView"]
+    state: RecordingState
+
+
+class TranscriptionJob(_Base):
+    attempts: int
+    created_at: str = Field(alias="createdAt")
+    crop: Optional["CropWindow"] = None
+    error: Optional[str] = None
+    error_code: Optional[str] = Field(default=None, alias="errorCode")
+    finished_at: Optional[str] = Field(default=None, alias="finishedAt")
+    has_audio: bool = Field(alias="hasAudio")
+    peaks: Optional[List[float]] = None
+    preview: Optional[bool] = None
+    progress: "JobProgress"
+    recording_id: str = Field(alias="recordingId")
+    source: Optional["SourceInfo"] = None
+    started_at: Optional[str] = Field(default=None, alias="startedAt")
+    state: JobState
+    transcription_id: str = Field(alias="transcriptionId")
+
+
+class Transcription(_Base):
+    """A transcription: a file, a link (with its `transcription` job), or
+something captured as it is spoken (`live: true`: a microphone, a
+stream, an RTMP encoder), which may feed broadcasts (`broadcasts`)."""
+
+    archived_at: Optional[str] = Field(default=None, alias="archivedAt")
+    broadcasts: Optional[List["BroadcastRef"]] = None
+    code: str
+    created_at: str = Field(alias="createdAt")
+    created_by_api_key_id: Optional[str] = Field(default=None, alias="createdByApiKeyId")
+    current_recording: Optional["CurrentRecording"] = Field(default=None, alias="currentRecording")
+    id: str
+    job: Optional["TranscriptionJob"] = None
+    kind: Literal["transcription"] = "transcription"
+    last_recorded_at: Optional[str] = Field(default=None, alias="lastRecordedAt")
+    last_recording: Optional["LastRecording"] = Field(default=None, alias="lastRecording")
+    lifecycle: Lifecycle
+    live: Optional[bool] = None
+    name: str
+    owner_principal_id: str = Field(alias="ownerPrincipalId")
+    purge_after: Optional[str] = Field(default=None, alias="purgeAfter")
+    recording_count: int = Field(alias="recordingCount")
+    settings: "Settings"
+    share_url: str = Field(alias="shareUrl")
+    source: "CaptureSource"
+    updated_at: str = Field(alias="updatedAt")
+
+
+class TranscriptionPage(_Base):
+    """`GET /v1/transcriptions`: one page, newest first."""
+
+    next_cursor: Optional[str] = Field(default=None, alias="nextCursor")
+    transcriptions: List["Transcription"]
+
+
+class UpdateBroadcast(_Base):
+    """`PATCH /v1/broadcasts/{id}`: fields left out are unchanged."""
+
+    access: Optional[Access] = None
+    code: Optional[str] = None
+    name: Optional[str] = None
+    password: Optional[str] = None
+    settings: Optional["SettingsPatch"] = None
+
+
+class UpdateShareLink(_Base):
+    allow_download: Optional[bool] = Field(default=None, alias="allowDownload")
+    allow_export: Optional[bool] = Field(default=None, alias="allowExport")
+    allow_translate: Optional[bool] = Field(default=None, alias="allowTranslate")
+    label: Optional[str] = None
+
+
+class UpdateTranscription(_Base):
+    """`PATCH /v1/transcriptions/{id}`: fields left out are unchanged. A
+transcription is shared through its share links, so it has no access,
+password or link to change here."""
+
+    name: Optional[str] = None
+    settings: Optional["SettingsPatch"] = None
+
+
+class UploadRecording(_Base):
+    settings: Optional["SettingsPatch"] = None
+    url: Optional[str] = None
+
+
+class UsageRow(_Base):
+    """One day, source and kind."""
+
+    amount: float
+    date: str
+    kind: str
+    seconds: float
+    source: str
+
+
+class UsageSource(_Base):
+    """Where usage came from."""
+
+    id: str
+    name: str
+    prefix: Optional[str] = None
+    revoked: bool
+
+
+class UsageReport(_Base):
+    """`GET /v1/billing/usage`."""
+
+    end_date: str = Field(alias="endDate")
+    rows: List["UsageRow"]
+    sources: List["UsageSource"]
+    start_date: str = Field(alias="startDate")
+    total: float
+    tz: str
+
+
+class Voice(_Base):
+    color: Optional[str] = None
+    consent_at: Optional[str] = Field(default=None, alias="consentAt")
+    created_at: str = Field(alias="createdAt")
+    draft: bool
+    enabled: bool
+    error: Optional[str] = None
+    gender: Optional[str] = None
+    id: str
+    name: str
+    preview_url: Optional[str] = Field(default=None, alias="previewUrl")
+    progress: int
+    sample_s: float = Field(alias="sampleS")
+    speech_s: Optional[float] = Field(default=None, alias="speechS")
+    state: str
+    updated_at: str = Field(alias="updatedAt")
+    uses: int
+
+
+class VoiceOption(_Base):
+    accent: Optional[str] = None
+    cloned: bool
+    default: bool
+    gender: Optional[str] = None
+    id: str
+    lag_s: Optional[float] = Field(default=None, alias="lagS")
+    name: str
+    preview_url: Optional[str] = Field(default=None, alias="previewUrl")
+    quality: int
+    ready: Optional[bool] = None
+    speakers: Optional[int] = None
+
+
+class VoiceCatalogue(_Base):
+    lang: str
+    voices: List["VoiceOption"]
+
+
+class VoiceTrack(_Base):
+    clip_dur: Optional[Dict[str, float]] = Field(default=None, alias="clipDur")
+    clip_parts: Optional[Dict[str, int]] = Field(default=None, alias="clipParts")
+    clip_rev: Optional[Dict[str, str]] = Field(default=None, alias="clipRev")
+    clips: List[int]
+    duration_s: Optional[float] = Field(default=None, alias="durationS")
+    error: Optional[str] = None
+    lang: str
+    state: str
+    voice: Optional[str] = None
+    voice_key: str = Field(alias="voiceKey")
+    word_times: Optional[Dict[str, List[List[float]]]] = Field(default=None, alias="wordTimes")
+
+
+class CaptureSourceMic(_Base):
+    kind: Literal["mic"] = "mic"
+
+
+class CaptureSourceStream(_Base):
+    kind: Literal["stream"] = "stream"
+    url: str
+
+
+CaptureSource = Annotated[Union[CaptureSourceMic, CaptureSourceStream], Field(discriminator="kind")]
+
+class Eof(_Base):
+    type: Literal["eof"] = "eof"
+
+
+class Cancel(_Base):
+    type: Literal["cancel"] = "cancel"
+
+
+class SessionUpdate(_Base):
+    latency_mode: Optional[LatencyMode] = Field(default=None, alias="latencyMode")
+    llm_fix: Optional[bool] = Field(default=None, alias="llmFix")
+    speaker_labels: Optional[SpeakerLabels] = Field(default=None, alias="speakerLabels")
+    spoken_language: Optional[str] = Field(default=None, alias="spokenLanguage")
+    translate: Optional[List[str]] = None
+    type: Literal["session.update"] = "session.update"
+    voice: Optional[List[str]] = None
+    voice_by_lang: Optional[Dict[str, str]] = Field(default=None, alias="voiceByLang")
+
+
+class Clock(_Base):
+    pcm: int
+    type: Literal["clock"] = "clock"
+    wall: float
+
+
+ClientFrame = Annotated[Union[Eof, Cancel, SessionUpdate, Clock], Field(discriminator="type")]
+
+class SessionLoading(_Base):
+    stage: LoadingStage
+    type: Literal["session.loading"] = "session.loading"
+
+
+class SessionReady(_Base):
+    type: Literal["session.ready"] = "session.ready"
+
+
+class TranscriptCommitted(_Base):
+    segment: "CommittedSegment"
+    type: Literal["transcript.committed"] = "transcript.committed"
+
+
+class TranscriptDraft(_Base):
+    segments: List["DraftSegment"]
+    type: Literal["transcript.draft"] = "transcript.draft"
+
+
+class TranscriptWords(_Base):
+    type: Literal["transcript.words"] = "transcript.words"
+    words: List["Word"]
+
+
+class TranscriptAmended(_Base):
+    fixes: Optional[List["Fix"]] = None
+    script_words: Optional[List[int]] = Field(default=None, alias="scriptWords")
+    seq: int
+    speaker: int
+    speaker_confidence: Optional[float] = Field(default=None, alias="speakerConfidence")
+    tail: Optional["AmendTail"] = None
+    text: str
+    type: Literal["transcript.amended"] = "transcript.amended"
+
+
+class TranscriptLatency(_Base):
+    latency_s: float = Field(alias="latencyS")
+    seq: int
+    type: Literal["transcript.latency"] = "transcript.latency"
+
+
+class TranscriptSpeaker(_Base):
+    seq: int
+    speaker: int
+    speaker_confidence: Optional[float] = Field(default=None, alias="speakerConfidence")
+    type: Literal["transcript.speaker"] = "transcript.speaker"
+    verdict: str
+
+
+class TranscriptSpeakerGender(_Base):
+    confidence: Optional[float] = None
+    gender: str
+    speaker: int
+    type: Literal["transcript.speakerGender"] = "transcript.speakerGender"
+
+
+class TranscriptSpeakerIdentified(_Base):
+    color: Optional[str] = None
+    confidence: Optional[float] = None
+    name: str
+    speaker: int
+    tone: Optional[bool] = None
+    type: Literal["transcript.speakerIdentified"] = "transcript.speakerIdentified"
+    voice_id: Optional[str] = Field(default=None, alias="voiceId")
+
+
+class TranscriptSentence(_Base):
+    sentence: "SentenceSegment"
+    type: Literal["transcript.sentence"] = "transcript.sentence"
+
+
+class TranscriptTranslated(_Base):
+    seq: int
+    sources: Optional[Dict[str, str]] = None
+    translations: Dict[str, str]
+    type: Literal["transcript.translated"] = "transcript.translated"
+
+
+class TranscriptVoice(_Base):
+    audio: Optional[str] = None
+    cloned: Optional[bool] = None
+    duration_s: float = Field(alias="durationS")
+    format: str
+    generation: int
+    lang: str
+    latency_s: Optional[float] = Field(default=None, alias="latencyS")
+    part: Optional[int] = None
+    parts: Optional[int] = None
+    queue_wait_s: Optional[float] = Field(default=None, alias="queueWaitS")
+    sentence_id: int = Field(alias="sentenceId")
+    speaker_to_audio_s: Optional[float] = Field(default=None, alias="speakerToAudioS")
+    synth_s: float = Field(alias="synthS")
+    translation_latency_s: Optional[float] = Field(default=None, alias="translationLatencyS")
+    type: Literal["transcript.voice"] = "transcript.voice"
+    url: Optional[str] = None
+    voice: Optional[str] = None
+    voice_key: Optional[str] = Field(default=None, alias="voiceKey")
+
+
+class TranscriptVoiceStatus(_Base):
+    detail: str
+    lang: str
+    state: VoiceStatusState
+    type: Literal["transcript.voiceStatus"] = "transcript.voiceStatus"
+    voice_key: Optional[str] = Field(default=None, alias="voiceKey")
+
+
+class TranscriptProgress(_Base):
+    processed_s: float = Field(alias="processedS")
+    total_s: Optional[float] = Field(default=None, alias="totalS")
+    type: Literal["transcript.progress"] = "transcript.progress"
+
+
+class StreamPull(_Base):
+    bytes_in: int = Field(alias="bytesIn")
+    detected: Optional[str] = None
+    error: Optional[str] = None
+    failures: int
+    media_s: float = Field(alias="mediaS")
+    program_at_ms: Optional[int] = Field(default=None, alias="programAtMs")
+    sequence_offset_ms: Optional[int] = Field(default=None, alias="sequenceOffsetMs")
+    state: PullState
+    type: Literal["stream.pull"] = "stream.pull"
+
+
+class SourceProgress(_Base):
+    bytes: int
+    done_s: float = Field(alias="doneS")
+    phase: str
+    total: Optional[int] = None
+    total_s: Optional[float] = Field(default=None, alias="totalS")
+    type: Literal["source.progress"] = "source.progress"
+
+
+class SourcePrepared(_Base):
+    duration_s: Optional[float] = Field(default=None, alias="durationS")
+    peaks: Optional[List[float]] = None
+    type: Literal["source.prepared"] = "source.prepared"
+
+
+class SessionDone(_Base):
+    reason: DoneReason
+    stats: "SessionStats"
+    type: Literal["session.done"] = "session.done"
+
+
+class ErrorFrame(_Base):
+    code: ErrorCode
+    message: str
+    retryable: bool
+    type: Literal["error"] = "error"
+
+
+ServerFrame = Annotated[Union[SessionLoading, SessionReady, TranscriptCommitted, TranscriptDraft, TranscriptWords, TranscriptAmended, TranscriptLatency, TranscriptSpeaker, TranscriptSpeakerGender, TranscriptSpeakerIdentified, TranscriptSentence, TranscriptTranslated, TranscriptVoice, TranscriptVoiceStatus, TranscriptProgress, StreamPull, SourceProgress, SourcePrepared, SessionDone, ErrorFrame], Field(discriminator="type")]
+
+class SubscribeUpdate(_Base):
+    audio: Optional[bool] = None
+    lang: Optional[str] = None
+    type: Literal["subscribe.update"] = "subscribe.update"
+
+
+class Ping(_Base):
+    type: Literal["ping"] = "ping"
+
+
+SubscriberClientFrame = Annotated[Union[SubscribeUpdate, Ping], Field(discriminator="type")]
+
+class SubscribeReady(_Base):
+    instance: str
+    last_seq: int = Field(alias="lastSeq")
+    recording_id: str = Field(alias="recordingId")
+    state: RecordingState
+    type: Literal["subscribe.ready"] = "subscribe.ready"
+
+
+class RecordingState(_Base):
+    media_s: Optional[float] = Field(default=None, alias="mediaS")
+    reason: Optional[str] = None
+    recording_id: str = Field(alias="recordingId")
+    state: RecordingState
+    type: Literal["recording.state"] = "recording.state"
+
+
+class RecordingSettings(_Base):
+    recording_id: str = Field(alias="recordingId")
+    settings: Any
+    type: Literal["recording.settings"] = "recording.settings"
+
+
+class RecordingSilence(_Base):
+    pauses_in_s: float = Field(alias="pausesInS")
+    recording_id: str = Field(alias="recordingId")
+    silent_s: float = Field(alias="silentS")
+    type: Literal["recording.silence"] = "recording.silence"
+
+
+class RecordingExpiring(_Base):
+    ends_in_s: float = Field(alias="endsInS")
+    recording_id: str = Field(alias="recordingId")
+    type: Literal["recording.expiring"] = "recording.expiring"
+
+
+class TranscriptCorrected(_Base):
+    actor: Optional["Actor"] = None
+    from_: str = Field(alias="from")
+    reverted: bool
+    sentence_id: Optional[int] = Field(default=None, alias="sentenceId")
+    sentence_text: Optional[str] = Field(default=None, alias="sentenceText")
+    seq: int
+    text: str
+    to: str
+    type: Literal["transcript.corrected"] = "transcript.corrected"
+    word_idx: int = Field(alias="wordIdx")
+    words: Optional[List["Word"]] = None
+
+
+class TranscriptSpeakerGender(_Base):
+    confidence: Optional[float] = None
+    gender: str
+    speaker: int
+    type: Literal["transcript.speakerGender"] = "transcript.speakerGender"
+
+
+class TranscriptSpeakerIdentified(_Base):
+    color: Optional[str] = None
+    confidence: Optional[float] = None
+    name: str
+    speaker: int
+    type: Literal["transcript.speakerIdentified"] = "transcript.speakerIdentified"
+    voice_id: Optional[str] = Field(default=None, alias="voiceId")
+
+
+class TranscriptSpeakerNamed(_Base):
+    name: Optional[str] = None
+    speaker: int
+    type: Literal["transcript.speakerNamed"] = "transcript.speakerNamed"
+
+
+class RecordingStarted(_Base):
+    recording_id: str = Field(alias="recordingId")
+    transcription_id: str = Field(alias="transcriptionId")
+    type: Literal["recording.started"] = "recording.started"
+
+
+class JobProgress(_Base):
+    error: Optional[str] = None
+    fetch_total_bytes: Optional[int] = Field(default=None, alias="fetchTotalBytes")
+    fetched_bytes: Optional[int] = Field(default=None, alias="fetchedBytes")
+    pct: int
+    phase: Optional[str] = None
+    phase_pct: Optional[int] = Field(default=None, alias="phasePct")
+    preview: Optional[bool] = None
+    processed_s: float = Field(alias="processedS")
+    recording_id: str = Field(alias="recordingId")
+    segments_done: int = Field(alias="segmentsDone")
+    segments_total: Optional[int] = Field(default=None, alias="segmentsTotal")
+    state: JobState
+    total_s: Optional[float] = Field(default=None, alias="totalS")
+    transcription_id: str = Field(alias="transcriptionId")
+    type: Literal["job.progress"] = "job.progress"
+
+
+class StreamIngest(_Base):
+    detected: Optional[str] = None
+    error: Optional[str] = None
+    failures: Optional[int] = None
+    last_audio_at: Optional[str] = Field(default=None, alias="lastAudioAt")
+    recording_id: str = Field(alias="recordingId")
+    state: IngestState
+    transcription_id: str = Field(alias="transcriptionId")
+    type: Literal["stream.ingest"] = "stream.ingest"
+    url: str
+
+
+class RecordingEnded(_Base):
+    recording_id: str = Field(alias="recordingId")
+    transcription_id: str = Field(alias="transcriptionId")
+    type: Literal["recording.ended"] = "recording.ended"
+
+
+class Audience(_Base):
+    languages: Any
+    listeners: int
+    type: Literal["audience"] = "audience"
+
+
+class SubscribeGap(_Base):
+    expected: int
+    got: int
+    type: Literal["subscribe.gap"] = "subscribe.gap"
+
+
+SubscriberFrame = Annotated[Union[SubscribeReady, RecordingState, RecordingSettings, RecordingSilence, RecordingExpiring, TranscriptCorrected, TranscriptSpeakerGender, TranscriptSpeakerIdentified, TranscriptSpeakerNamed, RecordingStarted, JobProgress, StreamIngest, RecordingEnded, Audience, SubscribeGap], Field(discriminator="type")]
+
+SERVER_FRAME_TYPES = frozenset(["session.loading", "session.ready", "transcript.committed", "transcript.draft", "transcript.words", "transcript.amended", "transcript.latency", "transcript.speaker", "transcript.speakerGender", "transcript.speakerIdentified", "transcript.sentence", "transcript.translated", "transcript.voice", "transcript.voiceStatus", "transcript.progress", "stream.pull", "source.progress", "source.prepared", "session.done", "error"])
+
+_server_frame_adapter: TypeAdapter[ServerFrame] = TypeAdapter(ServerFrame)
+
+
+TranscriptEvent = Union[TranscriptCommitted, TranscriptDraft, TranscriptWords, TranscriptAmended, TranscriptLatency, TranscriptSpeaker, TranscriptSpeakerGender, TranscriptSpeakerIdentified, TranscriptSentence, TranscriptTranslated, TranscriptVoice, TranscriptVoiceStatus, TranscriptProgress]
+
+
+def parse_server_frame(text: str) -> Optional[ServerFrame]:
+    """Parse one WS text frame. Returns None for unknown frame types
+    (forward compatibility)."""
+    raw = json.loads(text)
+    if not isinstance(raw, dict) or raw.get("type") not in SERVER_FRAME_TYPES:
+        return None
+    return _server_frame_adapter.validate_python(raw)