,Vj UdZddlZddlZddlZddlZddlZddlZddlmZddl m Z m Z m Z ddl mZddlmZddlmZddlmZmZejeZdJd ZddlmZd ed efd Zed Z edZ!edZ"dZ#dZ$dZ%ej&ddZ'ej&ddZ(ej&ddZ)dZ*dZ+dZ,ej&ddZ-ej&ddZ.ej&d d!Z/hd"Z0hd#Z1d$Z2hd%Z3hd&Z4da5e e6e7d'<da8e ee7d(<d e9fd)Z:dJd*e e9d efd+Z;d efd,Zd e efd0Z?d e efd1Z@d efd2ZAd3e ed efd4ZBd3e ed efd5ZCd*e9d efd6ZDd7ed e e ee ffd8ZEd9ZFd:eGd efd;ZHd3efd<ZId7ed3ed e ee ffd=ZJd7ed>ed eKe ee effd?ZLd7ed3ed e ee ffd@ZMd7ed3ed e ee ffdAZNd7ed3ed e ee ffdBZOd7ed3ed e ee ffdCZPd7ed3ed e ee ffdDZQdJd7edEe ed e ee ffdFZRd eKeeffdGZSdHe d efdIZTdS)Ku Transcription Tools Module Provides speech-to-text transcription with six providers: - **local** (default, free) — faster-whisper running locally, no API key needed. Auto-downloads the model (~150 MB for ``base``) on first use. - **groq** (free tier) — Groq Whisper API, requires ``GROQ_API_KEY``. - **openai** (paid) — OpenAI Whisper API, requires ``VOICE_TOOLS_OPENAI_KEY``. - **mistral** — Mistral Voxtral Transcribe API, requires ``MISTRAL_API_KEY``. - **xai** — xAI Grok STT API, requires ``XAI_API_KEY``. High accuracy, Inverse Text Normalization, diarization, 21 languages. Used by the messaging gateway to automatically transcribe voice messages sent by users on Telegram, Discord, WhatsApp, Slack, and Signal. Supported input formats: mp3, mp4, mpeg, mpga, m4a, wav, webm, ogg, aac Usage:: from tools.transcription_tools import transcribe_audio result = transcribe_audio("/path/to/audio.ogg") if result["success"]: print(result["transcript"]) N)Path)OptionalDictAny)urljoin)is_truthy_value)resolve_managed_tool_gateway)managed_nous_tools_enabledresolve_openai_audio_api_keyc~ ddlm}n%#t$rtj||cYSwxYw||}||n|S)aRead env values through the live config module. Tests may monkeypatch and later restore ``hermes_cli.config.get_env_value`` before this module is imported. Resolve the helper at call time so STT does not keep a stale imported function for the rest of the test process. r) get_env_value)hermes_cli.configr ImportErrorosgetenv)namedefault_get_env_valuevalues 7/root/.hermes/hermes-agent/tools/transcription_tools.pyr r -sl(EEEEEEE (((yw'''''( N4 Em77.s  ++ module_namereturnc tj|duS#ttf$r&|t vp|t jjvcYSwxYwN)_ilu find_specr ValueErrorglobalsrsysmodules)rs r_safe_find_specr!BsdI~k**$66  $IIIgii'H;"&.+HHHHIs4AAfaster_whisperopenai mistralailocalbaseenSTT_OPENAI_MODEL whisper-1STT_GROQ_MODELwhisper-large-v3-turboSTT_MISTRAL_MODELzvoxtral-mini-latestHERMES_LOCAL_STT_COMMANDHERMES_LOCAL_STT_LANGUAGE)z/opt/homebrew/binz/usr/local/bin GROQ_BASE_URLzhttps://api.groq.com/openai/v1STT_OPENAI_BASE_URLzhttps://api.openai.com/v1XAI_STT_BASE_URLzhttps://api.x.ai/v1> .aac.m4a.mp3.mp4.ogg.flac.mpeg.mpga.webm.wav>.aif.aiffr;i>gpt-4o-transcribegpt-4o-mini-transcriber)>whisper-large-v3distil-whisper-large-v3-enr+ _local_model_local_model_namecp ddlm}|diS#t$ricYSwxYw)zDLoad the ``stt`` section from user config, falling back to defaults.r load_configstt)rrFget ExceptionrEs r_load_stt_configrJqsY111111{}}  +++  s #& 55 stt_configcp|t}|dd}t|dS)z(Return whether STT is enabled in config.NenabledT)r)rJrHr)rKrMs ris_stt_enabledrNzs9%'' nnY--G 7D 1 1 11cF tdS#t$rYdSwxYw)zbReturn True when OpenAI audio can use config credentials, env credentials, or the managed gateway.TF)#_resolve_openai_audio_client_configrrOr_has_openai_audio_backendrSs:+---t uus    binary_namectD]X}t||z }|r0tj|tjrt |cSYtj|S)zMFind a local binary, checking common Homebrew/local prefixes as well as PATH.) COMMON_LOCAL_BIN_DIRSrexistsraccessX_OKstrshutilwhich)rT directory candidates r _find_binaryr_sm*"" OOk1      "")Irw"?"? "y>> ! ! ! < $ $$rOc tdS)Nffmpegr_rRrOr_find_ffmpeg_binaryrcs  ! !!rOc tdS)NwhisperrbrRrOr_find_whisper_binaryrfs  " ""rOctjtd}|r|St }|rt j|}|dSdS)Nza {input_path} --model {model} --output_format txt --output_dir {output_dir} --language {language})rrLOCAL_STT_COMMAND_ENVstriprfshlexquote) configuredwhisper_binary quoted_binarys r_get_local_command_templaterpsn0"55;;==J)++N  N33  > > >  4rOc"tduSr)rprRrOr_has_local_commandrrs & ( ( 44rO model_namec|r|tvs |tvr<|r3|tvs |tvr!td|ttS|S)aReturn a valid faster-whisper model size, mapping cloud-only names to the default. Cloud providers like OpenAI use names such as ``whisper-1`` which are not valid for faster-whisper (which expects ``tiny``, ``base``, ``small``, ``medium``, or ``large-v*``). When such a name is detected we fall back to the default local model and emit a warning so the user knows what happened. zSTT model '%s' is a cloud-only name and cannot be used with the local provider. Falling back to '%s'. Set stt.local.model to a valid faster-whisper size (tiny, base, small, medium, large-v3).) OPENAI_MODELS GROQ_MODELSloggerwarningDEFAULT_LOCAL_MODELrss r_normalize_local_modelr{sn  #}44 k8Q8Q  :66* :S:S NNM#    #" rOc t|Sr)r{rzs r_normalize_local_command_modelr}s !* - --rOct|sdSd|v}|dt}|rr|dkr5trdSt rdSt ddS|dkrOt rdStrt ddSt ddS|dkr4trtd rdSt d dS|d kr3trtrd St d dS|d kr4trtdrd St ddS|dkr-tdrdSt ddS|StrdSt rdStr+td rt ddStr*trt dd Str+tdrt dd Stdrt ddSdS)uDetermine which STT provider to use. When ``stt.provider`` is explicitly set in config, that choice is honoured — no silent cloud fallback. When no provider is configured, auto-detect tries: local > groq (free) > openai (paid). noneproviderr% local_commandzhSTT provider 'local' configured but unavailable (install faster-whisper or set HERMES_LOCAL_STT_COMMAND)z9Local STT command unavailable, using local faster-whisperz7STT provider 'local_command' configured but unavailablegroq GROQ_API_KEYz7STT provider 'groq' configured but GROQ_API_KEY not setr#z9STT provider 'openai' configured but no API key availablemistralMISTRAL_API_KEYz`STT provider 'mistral' configured but mistralai package not installed or MISTRAL_API_KEY not setxai XAI_API_KEYz5STT provider 'xai' configured but XAI_API_KEY not setz.No local STT available, using Groq Whisper APIz0No local STT available, using OpenAI Whisper APIzValidate the audio file. Returns an error dict or None if OK.FrhzAudio file not found: success transcripterrorzPath is not a file: zUnsupported format: z . Supported: z, zFile too large: iz.1fzMB (max z.0fzMB)zFailed to access file: N) rrWis_filesuffixlowerSUPPORTED_FORMATSjoinsortedstatst_size MAX_FILE_SIZEOSError)r audio_path file_sizees r_validate_audio_filer*siJ     c =aV_=a=abbb     a =_T]=_=_```  (999rJ,=rrDIIV\]nVoVoLpLprr   \OO%%- } $ $  uI,CuuuQ^bkQluuuu  % \\\ =ZWX=Z=Z[[[[[[[[\ 4s!=C C=*C82C=8C=) libcublaslibcudnn libcudartzcannot be loadedzcannot open shared objectzno kernel image is availablezno CUDA-capable devicez#CUDA driver version is insufficientexccbt|tfdtDS)agHeuristic: is this exception a missing/broken CUDA runtime library? ctranslate2 raises plain RuntimeError with messages like ``Library libcublas.so.12 is not found or cannot be loaded``. We want to catch missing/unloadable shared libs and driver-mismatch errors, NOT legitimate runtime failures ("CUDA out of memory", model bugs, etc.). c3 K|]}|vV dSrrR).0markermsgs r z-_looks_like_cuda_lib_error..hs'CCv}CCCCCCrO)rZany_CUDA_LIB_ERROR_MARKERS)rrs @r_looks_like_cuda_lib_errorr_s4 c((C CCCC+BCCC C CCrOcddlm} ||ddS#t$rC}t|std|||ddcYd}~Sd}~wwxYw) ucLoad faster-whisper with graceful CUDA → CPU fallback. faster-whisper's ``device="auto"`` picks CUDA when the ctranslate2 wheel ships CUDA shared libs, even on hosts where the NVIDIA runtime (``libcublas.so.12`` / ``libcudnn*``) isn't installed — common on WSL2 without CUDA-on-WSL, headless servers, and CPU-only developer machines. On those hosts the load itself sometimes succeeds and the dlopen failure only surfaces at first ``transcribe()`` call. We try ``auto`` first (fast CUDA path when it works), and on any CUDA library load failure fall back to CPU + int8. r WhisperModelautodevice compute_typeufaster-whisper CUDA load failed (%s) — falling back to CPU (int8). Install the NVIDIA CUDA runtime (libcublas/libcudnn) to use GPU.cpuint8N)r"rrIrrwrx)rsrrs r_load_local_whisper_modelrks,+++++ K|JvFKKKK KKK)#..   O    |Ju6JJJJJJJJJKs  A#8AA#A#ctsddddS t t|kr,td|t |a|at didptj tpd}d d i}|r||d< tj |fi|\}}d d |D}n#t$r}t|std |dadaddlm}||dda|atj |fi|\}}d d|D}Yd}~nd}~wwxYwtdt%|j||j|jd|ddS#t$r0} td| dddd| dcYd} ~ Sd} ~ wwxYw)z.Transcribe using faster-whisper (local, free).Frhzfaster-whisper not installedrNzELoading faster-whisper model '%s' (first load downloads the model)...r%language beam_size c3HK|]}|jVdSrtextrjrsegments rrz$_transcribe_local..0!O!O7',"4"4"6"6!O!O!O!O!O!OrOulfaster-whisper CUDA runtime failed mid-transcribe (%s) — evicting cached model and retrying on CPU (int8).rrrrrc3HK|]}|jVdSrrrs rrz$_transcribe_local..rrOz;Transcribed %s via local whisper (%s, lang=%s, %.1fs audio)TrrrzLocal transcription failed: %sexc_infoLocal transcription failed: )rrBrCrwrrrJrHrrLOCAL_STT_LANGUAGE_ENV transcriberrIrrxr"rrrrdurationr) rrs _forced_langtranscribe_kwargssegmentsrrrrrs r_transcribe_localrs ] =[\\\2a  #4 #B#B KK_ak l l l4Z@@L *     " "7B / / 3 3J ? ? y/00   )!,  9,8 j ) P)4YTTBSTTNHd!O!Oh!O!O!OOOJJ P P P .c22  NND     L $  3 3 3 3 3 3'< 5vVVVL * )4YTTBSTTNHd!O!Oh!O!O!OOOJJJJJJ' P*  I OO *dmT]    zwOOO aaa 5q4 HHH =_\]=_=_````````asJBF.)4CF. E+(A9E&!F.&E++AF.. G(8%G#G(#G(work_dirc$t|}|jtvr|dfSt }|sdSt j||jd}|dd||g} tj |ddd|dfS#tj $rn}|j p'|j pt|}t d||dd |fcYd}~Sd}~wwxYw) z.Normalize audio for local CLI STT when needed.N)NzOLocal STT fallback requires ffmpeg for non-WAV inputs, but ffmpeg was not foundr;z-yz-iT)checkcapture_outputrz#ffmpeg conversion failed for %s: %sz'Failed to convert audio for local STT: )rrrLOCAL_NATIVE_AUDIO_FORMATSrcrpathrstem subprocessrunCalledProcessErrorstderrrjstdoutrZrwr)rrrraconverted_pathcommandrdetailss r_prepare_local_audiors3iJ  $>>>$ " "F gffW\\(z,D,D,DEENtT9n=GIwd4dKKKKt##  (III(..""@ahnn&6&6@#a&& :IwOOOHwHHHHHHHHHIs6BD!A#D D Dc t}|sddtddStdidpt jt pt}t|} tj d5}t||\}}|rdd|dcd d d S| tj|tj|tj|tj| }tj|d d d d t#t%|d } | sddddcd d d S| dd} t,dt%|j|t3| d | ddcd d d S#1swxYwYd S#t4$r} dddtd| dcYd } ~ Sd } ~ wtj$rp} | jp'| jpt=| } t,d|| ddd| dcYd } ~ Sd } ~ wt@$r0} t,d| d ddd| dcYd } ~ Sd } ~ wwxYw)zNRun the configured local STT command template and read back a .txt transcript.Frhz5 not configured and no local whisper binary was foundrr%rzhermes-local-stt-)prefixN) input_path output_dirrmodelT)shellrrrz*.txtzALocal STT command completed but did not produce a .txt transcriptrzutf-8)encodingz3Transcribed %s via local STT command (%s, %d chars)rrzInvalid z template, missing placeholder: z#Local STT command failed for %s: %szLocal STT failed: z7Unexpected error during local command transcription: %srr)!rprirJrHrrrDEFAULT_LOCAL_STT_LANGUAGEr}tempfileTemporaryDirectoryrformatrkrlrrrrglob read_textrjrwrrlenKeyErrorrrrrZrrI) rrscommand_templaternormalized_modelrprepared_input prep_errorr txt_filestranscript_textrrs r_transcribe_local_commandrs244  (___     w++// ;; & 9+ , , & % 6jAA+a  (0C D D D a )=i)T)T &NJ Q#(ZPP a a a a a a a a '-- ;~66 ;z22X..k"233 .G N7$d4VZ [ [ [ [tJ//44W==>>I $"$` a a a a a a a a*(l44g4FFLLNNO KKEY$ O$$     $?P_``9 a a a a a a a a a a a a a a a a a a<    Z 5ZZWXZZ         (]]](..""@ahnn&6&6@#a&& :IwOOO =[RY=[=[\\\\\\\\ aaa NPQ\` aaa =_\]=_=_````````asHG:4 HB0G:1 H>A/G:- H:G>>HG>H K!H'!K!'K!9A%J$K!$ K!1%KK!K!c&td}|sddddStsddddS|tvr(td|t t } dd lm}m}m }m }||td d } t|d 5}|j j||d } dddn #1swxYwYt!| } tdt%|j|t)| d| ddt+|dd} t-| r | SS#t+|dd} t-| r | wwxYw#t.$r ddd|dcYS|$r} ddd| dcYd} ~ Sd} ~ w|$r} ddd| dcYd} ~ Sd} ~ w|$r} ddd| dcYd} ~ Sd} ~ wt0$r0} td| dddd| dcYd} ~ Sd} ~ wwxYw)z8Transcribe using Groq Whisper API (free tier available).rFrhzGROQ_API_KEY not setropenai package not installedz(Model %s not available on Groq, using %srOpenAIAPIErrorAPIConnectionErrorAPITimeoutErrorapi_keybase_urltimeout max_retriesrbrrfileresponse_formatNz*Transcribed %s via Groq API (%s, %d chars)TrrclosePermission denied: Connection error: Request timeout: API error: zGroq transcription failed: %srTranscription failed: )r rrurwrDEFAULT_GROQ_STT_MODELr#rrrrr/openaudiotranscriptionscreaterZrjrrrgetattrcallablePermissionErrorrIr) rrsrrrrrclient audio_file transcriptionrrrs r_transcribe_groqrshN++G U =STTT ] =[\\\]"" > Lbccc+ [PPPPPPPPPPPP-YZ[[[ i&& * & ; B B$#$*!C!!                "-006688O KKDi-z3;O;O Q Q Q $?PVWWFGT22E  FGT22E   ``` =^S\=^=^_____ WWW =URS=U=UVVVVVVVV VVV =TQR=T=TUUUUUUUU PPP =N1=N=NOOOOOOOO [[[ 4a$ GGG =YVW=Y=YZZZZZZZZ[s F8E#B7+ E7B;;E>B;?A%E$*F-E==FHHF'!H'H/F=7H=HG H H %H H HcT t\}}n*#t$r}ddt|dcYd}~Sd}~wwxYwtsddddS|tvr(t d|tt} ddlm }m }m }m }|||d d } t|d 5} | jj|| |d krd nd} dddn #1swxYwYt#| } t dt%|j|t)| d| ddt+| dd} t-| r | SS#t+| dd} t-| r | wwxYw#t.$r ddd|dcYS|$r}ddd|dcYd}~Sd}~w|$r}ddd|dcYd}~Sd}~w|$r}ddd|dcYd}~Sd}~wt0$r0}t d|dddd|dcYd}~Sd}~wwxYw)z+Transcribe using OpenAI Whisper API (paid).FrhrNrz*Model %s not available on OpenAI, using %srrrrrr)rjsonrz,Transcribed %s via OpenAI API (%s, %d chars)Tr#rrr r r r zOpenAI transcription failed: %srr )rQrrZrrvrwrDEFAULT_STT_MODELr#rrrrrrrr_extract_transcript_textrrrrrrrIr)rrsrrrrrrrrrrrrrs r_transcribe_openairRs ?AA    XX          ] =[\\\[   @*N_```& [PPPPPPPPPPPP(BTUVVV i&& * & ; B B$#.8K.G.GFFV!C!!                7}EEO KKFi-z3;O;O Q Q Q $?PXYYFGT22E  FGT22E   ``` =^S\=^=^_____ WWW =URS=U=UVVVVVVVV VVV =TQR=T=TUUUUUUUU PPP =N1=N=NOOOOOOOO [[[ 6D III =YVW=Y=YZZZZZZZZ[s ;6;;=FE')+C  E' C$$E''C$(AE';*F'-FFH',H'0F>8H'>H'GH'H'G*$H'* H'7%H"H'"H'c td}|sddddS ddlm}||5}t|d 5}|jj||t|jd  }d d d n #1swxYwYt|}t d t|j|t|d|ddcd d d S#1swxYwYd S#t$r ddd|dcYSt$rB}td|ddddt!|jdcYd }~Sd }~wwxYw)zTranscribe using Mistral Voxtral Transcribe API. Uses the ``mistralai`` Python SDK to call ``/v1/audio/transcriptions``. Requires ``MISTRAL_API_KEY`` environment variable. rFrhzMISTRAL_API_KEY not setrr)Mistral)rr)content file_name)rrNz-Transcribed %s via Mistral API (%s, %d chars)Trrr z Mistral transcription failed: %srzMistral transcription failed: )r mistralai.clientr rrrcompleterrrrwrrrrIrtype__name__) rrsrr rrresultrrs r_transcribe_mistralr(s[ -..G X =VWWWr,,,,,, WW % % % [i&& *4==$%/d9oo>RSS>                7v>>O KK?Y$j#o2F2F    $?PYZZ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ``` =^S\=^=^_____ rrr 7T JJJ =p^bcd^e^e^n=p=pqqqqqqqqrsjC4C'7A?3 C'?B C'B AC' C4'C++C4.C+/C44E E7E EEc td}|sddddSt}|di}t|dptdptd }t|d ptjd pt}t|d d }t|dd} ddl } ddl m } i} |r|| d <|rd| d <|rd| d<t|d5} | |dd|| ddt!|j| fi| d} dddn #1swxYwY| jdkrd} | }|diddp| jdd}n#t*$r| jdd}YnwxYwddd| jd|dS| }|d d}|sddd!dSt,d"t!|j|d ||d#dt1|d |dd$S#t2$r ddd%|dcYSt*$r0}t,d&|d 'ddd(|dcYd}~Sd}~wwxYw))zTranscribe using xAI Grok STT API. Uses the ``POST /v1/stt`` REST endpoint with multipart/form-data. Supports Inverse Text Normalization, diarization, and word-level timestamps. Requires ``XAI_API_KEY`` environment variable. rFrhzXAI_API_KEY not setrrrr1/rr.rTdiarizerN)hermes_xai_user_agenttruerz/sttzBearer ) Authorizationz User-Agentrx)headersfilesdatarrmessagei,zxAI STT API error (HTTP z): rz!xAI STT returned empty transcriptz@Transcribed %s via xAI Grok STT (lang=%s, %.1fs audio, %d chars)rrr z xAI STT transcription failed: %srzxAI STT transcription failed: )r rJrHrZr1rjrstriprrrrrequeststools.xai_httpr,rpostrr status_coderrrIrwrrrr)rrsrrK xai_configrr use_format use_diarizer6r,r2rresponsedetailerr_bodyr'rrs r_transcribe_xair@sEM**G T =RSSS!##Jr**Jz""  + , ,   eggffSkk  z"" & 90 1 1 & % egg  !$!?!?@@J!*..E"B"BCCK?c888888!  ('D   $#DN  %$DO )T " " j}}!!!%8w%8%8"7"7"9"9 T)__1:>%  H                 3 & &F -#==??!gr2266y"EE\W[X[W[I\ - - -!tt, -! UH4HUUVUU   **VR006688   <   N OO JJz8 , , JJz1 % %      ERRR ``` =^S\=^=^_____ ccc 7T JJJ =a^_=a=abbbbbbbbcs|/1K4 AF." K4.F22K45F26K4A HK4H1.K40H11K4AK4 A*K44M M%L=7M=Mrct|}|r|St}t|sddddSt|}|dkrP|di}t |p|dt }t||S|dkrP|di}t|p|dt }t||S|dkr|pt}t||S|d krC|d i}|p|dt}t||S|d krC|d i}|p|dt}t||S|d kr|pd }t!||Sddd t"ddS)a Transcribe an audio file using the configured STT provider. Provider priority: 1. User config (``stt.provider`` in config.yaml) 2. Auto-detect: local faster-whisper (free) > Groq (free tier) > OpenAI (paid) Args: file_path: Absolute path to the audio file to transcribe. model: Override the model. If None, uses config or provider default. Returns: dict with keys: - "success" (bool): Whether transcription succeeded - "transcript" (str): The transcribed text (empty on failure) - "error" (str, optional): Error message if success is False - "provider" (str, optional): Which provider was used Frhz4STT is disabled in config.yaml (stt.enabled: false).rr%rrrr#rrzgrok-sttzZNo STT provider available. Install faster-whisper for free local transcription, configure z or install a local whisper CLI, set GROQ_API_KEY for free Groq Whisper, set MISTRAL_API_KEY for Mistral Voxtral Transcribe, set XAI_API_KEY for xAI Grok STT, or set VOICE_TOOLS_OPENAI_KEY or OPENAI_API_KEY for the OpenAI Whisper API.)rrJrNrrHr{ryrr}rrrrrDEFAULT_MISTRAL_STT_MODELr(r@ri) rrrrKr local_cfgrs openai_cfg mistral_cfgs rtranscribe_audiorFs( ! + +E  "##J * % % K   Z((H7NN7B// +  @Y]]7,?@@  !J777?""NN7B// 3  @Y]]7,?@@  )J???644  :6668^^Hb11 HjnnW6GHH !)Z8889 nnY33 Qkoog7PQQ "9j9995(j y*555 <(= < < <   rOct}|di}|dd}|dd}|r ||ptfSt}|r |tfSt d}|$d}t r|dz }t ||jt|j d d d fS) z@Return direct OpenAI audio config or a managed gateway fallback.r#rrhrz openai-audioNzUNeither stt.openai.api_key in config nor VOICE_TOOLS_OPENAI_KEY/OPENAI_API_KEY is setz5, and the managed OpenAI audio gateway is unavailabler*v1) rJrHOPENAI_BASE_URLr r r rnous_user_tokenrgateway_originr5)rKrD cfg_api_key cfg_base_urldirect_api_keymanaged_gatewayr4s rrQrQgs!##J"--J..B//K>>*b11L>\<_==133N/..2>BBOi % ' ' O N NG!!!  *G  ) 0 0 5 5888$-- rOrct|tr|St|dr9t |d}t|tr|St|t r>|d}t|tr|St|S)zBNormalize text and JSON transcription responses to a plain string.r) isinstancerZrjhasattrrdictrH)rrs rrrs-%%%""$$$}f%%! v.. eS ! ! !;;== -&&!!!&)) eS ! ! !;;== }   # # % %%rOr)U__doc__loggingrrkr[rrpathlibrtypingrrr urllib.parserutilsrtools.managed_tool_gatewayr tools.tool_backend_helpersr r getLoggerr&rwr importlib.utilutilrrZboolr!rrrrryrrrrrBrirrVr/rIr1rrrrurvrBobject__annotations__rCrSrJrNrSr_rcrfrprrr{r}rrr BaseExceptionrrrtuplerrrrr(r@rFrQrrRrOrrds6 &&&&&&&&&& !!!!!!CCCCCC________  8 $ $ / / / /$IIIIII&o&677oh'' {++ !BI0+>>"#35MNN%BI&9;PQQ24? /+KLL ")13NOO29/1FGGhhh666 MLL ZZZ "& hv%%%#'8C='''$22x~222224%c%hsm%%%%"Xc]""""#hsm#### Xc]    5D5555x}*.x}.....[d[s[[[[DCHT#s(^,DR  DM Dd D D D DK#KKKK69a9a#9a$sCx.9a9a9a9axICI3I5#PXY\P]A];^IIII,?a?a#?a$sCx.?a?a?a?aL-[-[-[c3h-[-[-[-[h2[#2[32[4S>2[2[2[2[rr3rCrDcNrrrrN[cs[c[cS#X[c[c[c[cFOOOHSMOT#s(^OOOOdU38_2&C&C&&&&&&rO