o 3>i@s|dZddlmZddlZddlmZmZddlmZm Z ddl m Z m Z m Z eeZeGdddZGd d d eZdS) u Abstract base class for Speech-to-Text providers. Every provider must implement `transcribe(audio_url, callid)` and return an `STTResult`. New providers (Deepgram, Whisper, …) just subclass BaseSTT and register in the factory. ) annotationsN)ABCabstractmethod) dataclassfield)AnyDictListc@sNeZdZUdZded<eedZded<dZded <d Z ded <dddZ dS) STTResultz@Normalised transcription output shared across all STT providers.str transcript)default_factoryzList[Dict[str, Any]]speaker_segmentsgfloatdurationproviderreturnDict[str, Any]cCs|j|j|j|jdS)Nr rrrrselfr3/home/aiteam/pcaa-dev/dashboard-backend/stt/base.pyto_dicts zSTTResult.to_dictN)rr) __name__ __module__ __qualname____doc____annotations__rlistrrrrrrrrr s   r c@s0eZdZdZeed ddZed d d Zd S)BaseSTTz!Abstract speech-to-text provider.rr cCdS)z2Short identifier used in `stt_provider` DB column.Nrrrrr provider_name'zBaseSTT.provider_name audio_urlcallidr cCr")zDownload audio from *audio_url* and return an STTResult. Raises `RuntimeError` on unrecoverable failure so the caller can mark the call as failed without swallowing the reason. Nr)rr%r&rrr transcribe,r$zBaseSTT.transcribeN)rr )r%r r&r rr )rrrrpropertyrr#r'rrrrr!$sr!)r __future__rloggingabcrr dataclassesrrtypingrrr getLoggerrloggerr r!rrrrs