|+jKUdZddlZddlZddlZddlZddlZddlZddlmZddl m Z m Z m Z ddl mZddlmZddlmZddlmZmZmZejeZdvd ZddlmZd ed efd Z e d Z!e dZ"e dZ#dZ$dZ%dZ&ej'ddZ(ej'ddZ)ej'ddZ*ej'ddZ+dZ,dZ-dZ.ej'ddZ/ej'd d!Z0ej'd"d#Z1ej'd$d%Z2hd&Z3hd'Z4d(Z5hd)Z6hd*Z7da8e e9e:d+<da;e ee:d,<d ed efd0Z?d1ed e efd2Z@d e efd3ZAd e efd4ZBd e efd5ZCd efd6ZDd7e ed efd8ZEd7e ed efd9ZFd efd:ZGeHhd;ZIdZMd.e ee fd?ed e ee ffd@ZNd.e ee fd?ed e ee ffdAZOdBe ee fd efdCZPdDed.e ee fd e e ee ffdEZQd.e ee ffdFZRdvd.e e ee fd efdGZSdBe ee fd eTfdHZUdBe ee fd efdIZVdJedKeWd e efdLZXdMedNe ed efdOZYdJedPe eefd efdQZZdRej[d dfdSZ\dTedUeTd ej]fdVZ^dWedXedYed efdZZ_ dvd[ed\edBe ee fd.e ee fd]e ed e ee ff d^Z`d.e .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)rrJget ExceptionrIs r_load_stt_configrNxsY111111{}}  +++  s #& 55 stt_configcp|t}|dd}t|dS)z(Return whether STT is enabled in config.NenabledT)r)rNrLr)rOrQs ris_stt_enabledrRs9%'' 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_configrrSr_has_openai_audio_backendrWs:+---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)rX directory candidates r _find_binaryrcsm*"" OOk1      "")Irw"?"? "y>> ! ! ! < $ $$rSc tdS)NffmpegrcrVrSr_find_ffmpeg_binaryrgs  ! !!rSc tdS)NwhisperrfrVrSr_find_whisper_binaryrjs  " ""rSctjtd}|r|St }|rt j|}|dSdS)Nza {input_path} --model {model} --output_format txt --output_dir {output_dir} --language {language})rrLOCAL_STT_COMMAND_ENVstriprjshlexquote) configuredwhisper_binary quoted_binarys r_get_local_command_templatertsn0"55;;==J)++N  N33  > > >  4rSc"tduSr)rtrVrSr_has_local_commandrvs & ( ( 44rS 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_MODELrws r_normalize_local_modelrsn  #}44 k8Q8Q  :66* :S:S NNM#    #" rSc t|Sr)rr~s r_normalize_local_command_modelrs !* - --rSc ddlm}|ddddlm}|drdSn2#t $r%}t d |Yd}~nd}~wwxYwdS) aoAttempt to lazy-install faster-whisper and return True on success. The module-level ``_HAS_FASTER_WHISPER`` flag is set at import time and cached. If the package wasn't installed at startup, calling ``ensure()`` installs it. This function re-checks dynamically after installation so the provider can use it immediately without a process restart. rensurezstt.faster_whisperFpromptNr#Tz)Lazy install of faster-whisper failed: %s)tools.lazy_depsrimportlib.utilutilrrMr{debug)r_iuexcs r_try_lazy_install_sttrs G****** #E2222$$$$$$ ==) * * 4  GGG @#FFFFFFFFG 5s.3 A"AA">xaigroqr&r$mistral local_command,txt>srtrvttjsonrct|tsiS||}t|tr|niS)z=Return an stt sub-section if it's a dict, else an empty dict.) isinstancedictrL)rOrsections r_get_stt_sectionrsC j$ ' ' nnT""G $// 777R7rSc t|d}t|tr||nd}t|tr|S|t vrt||}|r|SiS)uReturn the config dict for a user-declared STT command provider. Looks up ``stt.providers.`` first (the canonical location), and falls back to ``stt.`` so users who followed the built-in layout still work. Returns an empty dict when the provider is not declared. Built-in names are NOT special-cased here — the caller short-circuits them before this is consulted, AND ``_is_command_stt_provider_config`` requires an explicit ``command:`` value, so a built-in section like ``stt.openai`` (which has ``model``/``language`` but no ``command``) can't accidentally be treated as a command provider. providersN)rrrrLlowerBUILTIN_STT_PROVIDERS)rOrrrlegacys r_get_named_stt_provider_configrs ![99I%/ 4%@%@JimmD!!!dG'4   zz||000!*d33  M IrSconfigcjt|tsdSt|dpd}|r|dkrdS|d}t|to t |S)z?Return True when *config* declares a command-type STT provider.Ftyperlcommand)rrr^rLrnrbool)rptypers r_is_command_stt_provider_configr7s fd # #u  6""(b ) ) / / 1 1 7 7 9 9E )##ujj##G gs # # =W]]__(=(==rSproviderc|sdS|}|tvs|dkrdSt||}t |r|SdS)zReturn the provider config if *provider* resolves to a command type. Built-in provider names are rejected (they have native handlers). Returns None when the name is a built-in, ``"none"``, unknown, or not a command type. Nnone)rrnrrr)rrOkeyrs r$_resolve_command_stt_provider_configrBsn t ..   " "C ###sf}}t +J < > ttt 5rSc|d|dt} t|}n+#ttf$rttcYSwxYw|dkrttS|S)z5Return timeout in seconds, falling back when invalid.timeouttimeout_secondsr)rL#DEFAULT_COMMAND_STT_TIMEOUT_SECONDSfloat TypeErrorr)rrawrs r_get_command_stt_timeoutrks **Y +<>a b b c cC:c  z ":::899999: zz8999 LsA%A)(A)c|dp|dpt}t|d}|t vr|ntS)z6Return the validated output format (txt/json/srt/vtt).format output_format.)rL!DEFAULT_COMMAND_STT_OUTPUT_FORMATr^rrnlstripCOMMAND_STT_OUTPUT_FORMATS)rrfmts r_get_command_stt_output_formatrws{  8 - ::o & & - , c((..   " " ) )# . .C333339ZZrScommand_templatepositioncd}d}d}||kr\||}|dkr |dkrd}n:|dkr|rd}n/|dkrd}n&|dkrd}n|dkrd}n|dkrd}n |dkr|dz }|dz }||k\|S) uReturn the shell quote character active right before *position*. Mirrors ``tools.tts_tool._shell_quote_context`` — kept local to avoid cross-module import of a private helper. Returns ``"'"`` / ``'"'`` when inside a quoted region, ``None`` for bare context. NFr'"\TrV)rrrpescapedichars r_shell_quote_context_sttrs EG A h,," C<<s{{ c\\  S[[EE S[[EE T\\ FA Q% h,,& LrSr quote_contextc\|dkr|ddS|dkrR|ddddddd d Stjd krtj|gSt j|S) zQuote a placeholder value for its position in a shell command template. Mirrors ``tools.tts_tool._quote_command_tts_placeholder``. rz'\''rrz\\z\"$z\$`z\`nt)replacerr subprocess list2cmdlinerorp)rrs r_quote_command_stt_placeholderrs }}S'***  WT6 " " WS% WS% WS%   w$&w/// ;u  rS placeholderscr ddldfdD}d|d|d}g dd d tf fd }||}|d d dd} D]\}}|||}|S)aReplace supported placeholders while preserving ``{{`` / ``}}``. Mirrors ``tools.tts_tool._render_command_tts_template``. Placeholders are shell-quote-aware: ``{voice}`` inside single quotes gets single-quote-safe escaping, inside double quotes gets ``$``/`` ` ``/`` " `` escaping, outside quotes gets ``shlex.quote``. Doubled braces ``{{`` and ``}}`` are preserved as literal ``{`` / ``}`` for users who want to embed JSON snippets in their command. rN|c3BK|]}|VdSr)escape).0rres r z/_render_command_stt_template..s->>RYYt__>>>>>>rSz(?z)\}\}|\{(?Pz)\})matchz re.Match[str]rc |dp|d}dtd}|t|t |f|S)Ndoublesingle__HERMES_STT_PLACEHOLDER___)grouplenappendrrstart)rrtokenrr replacementss r replace_matchz3_render_command_stt_template..replace_matchs{{8$$= H(=(=AC ,=,=AAA  *T"()95;;==II       rSz{{{z}}})rjoincompiler^subr) rrnamespatternrrenderedrrrrs `` @@r_render_command_stt_templatersIII HH>>>>>>> > >EjjPuPPEPPPG+-L _         {{=*:;;Hc**224==H$22 u##E511 OrSprocc |dStjdkrv tjddddt |jgtjtjdtjn$#t$r| YnwxYwdS d dl }nf#t$rY|  | d n)#tj$r| YnwxYwYdSwxYw ||j}|d D]'} | #|j$rY$wxYw| n0#|j$rYdSt$r| YnwxYw | d dS#tj$rYnwxYw ||j}|d D]'} | #|j$rY$wxYw| dS#|j$rYdSt$r| YdSwxYw)zBest-effort termination of a shell process and all of its children. Mirrors ``tools.tts_tool._terminate_command_tts_process_tree``. Nrtaskkillz/Fz/Tz/PID)stdoutstderrrstdinrrT) recursive)pollrrrrunr^pidDEVNULLrMkillpsutilr terminatewaitTimeoutExpiredProcesschildren NoSuchProcess)rrparentchilds r#_terminate_command_stt_process_treers   yy{{ w$  NT4TX?!)!) (          IIKKKKK      IIaI (    IIKKKKK  ))__t_44  E !!!!'          !   $      ))__t_44  E  '        sAA77BBB##DCD#C?<D>C??DD 2E7=EE7 EE7EE77 F$F$#F$(GGG2I HI H+(I*H++I I2I21I2rrcdtjtjdd}tjdkrt tdd|d<nd|d<tj|fi|dtji} || \}}n#tj$rz}t| |d \}}n2#t$r%t |d d }t |d d }YnwxYwtj|||||d }~wwxYw|j rtj |j |||tj ||j ||S)z~Run a command-provider shell command with process-tree timeout cleanup. Mirrors ``tools.tts_tool._run_command_tts``. T)shellrrtextrCREATE_NEW_PROCESS_GROUPr creationflagsstart_new_sessionrrroutputNr)rr)rPIPErrgetattrPopenr communicater rrM returncodeCalledProcessErrorCompletedProcess)rr popen_kwargsrrrrs r_run_command_sttr!s // $$L  w$(/ D ?,C.+D -C..D  D output_pathrrc|ry |d}nK#t$r>|dd}YnwxYw|r|S|r(|r|St d|d)uReturn the transcript text from a command-provider invocation. Resolution: 1. If ``output_path`` exists and is non-empty → read it (raw text). 2. Else if ``stdout`` is non-empty → use stdout (lets users write curl-style one-liners that emit transcript to stdout instead of writing a file). 3. Else → raise RuntimeError (no usable output produced). For JSON format, we still return the raw bytes — extracting a ``text`` field is out of scope; users either configure ``format: txt`` or post-process JSON downstream. (Same trade-off as TTS: the runner doesn't try to be clever about output shape.) utf-8encodingr)errorsz-Command STT provider wrote no output file at z and produced no stdout)r[ read_textrnUnicodeDecodeError read_bytesdecode RuntimeError)r"rrcontents r_read_command_stt_outputr.Js Y!++W+==CCEEGG! Y Y Y!,,..55gi5PPVVXXGGG Y  N &,,..||~~  "  " " "  s(?ABB file_path provider_namemodel_overridec t|dpd}|s dd|d|ddSt|}|s dd|d|dSt |}t|}|dp|dpt} |p|d pd} tj d |d  5} t| d |z } t| t| t| j |t| t| d} t|| }td|j| t#||}n#t$j$rdd|d|d|dddcYcdddSt$j$r}g}|jr/|d|j|jr/|d|jd|pd}dd|d|d|jd|dcYd}~cdddSd}~wwxYw t5| |jpd|}n7#t6$r*}dd|t|dcYd}~cdddSd}~wwxYw dddn #1swxYwYn$#t8$r}dd|d|d|dcYd}~Sd}~wwxYwtd|j|t;|d||dS)a,Transcribe via a user-declared ``stt.providers.: type: command``. Placeholder grammar: | Placeholder | Substituted with | |-------------------|-----------------------------------------------------------| | ``{input_path}`` | absolute path to the audio file (original location) | | ``{output_path}`` | absolute path the provider should write its transcript to | | ``{output_dir}`` | parent dir of ``{output_path}`` | | ``{format}`` | configured output format (``txt`` / ``json`` / ``srt`` / ``vtt``) | | ``{language}`` | configured language code (default ``en``) | | ``{model}`` | configured model id (empty when not set) | All placeholders are shell-quote-aware (see ``_render_command_stt_template``). Doubled braces ``{{`` and ``}}`` are preserved as literal braces. Returns the standard transcribe-response envelope (``success``, ``transcript``, ``provider``, ``error``). rrlFzstt.providers.z.command is not configured)success transcriptrerrorAudio file not found: languagemodelzhermes-cmd-stt--prefixz transcript.) input_pathr" output_dirrr7r8z0Transcribing %s via command STT provider '%s'...zSTT command provider 'z' timed out after gsNzstderr: zstdout: z; zno command outputz' exited with code z: z ' failed: z7Transcribed %s via command STT provider '%s' (%d chars)Tr3r4r)r^rLrnr expanduserr[rrDEFAULT_COMMAND_STT_LANGUAGEtempfileTemporaryDirectoryresolverrr{inforr!rr rrrrrrr.r,OSErrorr)r/r0rrOr1raudiorrr7r8tmpdirr"rrresultr detail_partsdetailtranscript_texts r_transcribe_command_sttrNhs<46::i006B77==??  %OmOOO     OO & & ( (E <<>> %9i99    'v..G26::M : ( >>* % % ( '  7fjj11 7RE?  (0R-0R0R0R S S S6 W]v,,)F})F)FFK!%--//22";//!+"455'MMU L33C\RRG KKB M    )'7;;,   $"$ -((("((( %6 6 6 6 6 6 6 6 60   ! :I ''(G3:3C3C3E3E(G(GHHH:I ''(G3:3C3C3E3E(G(GHHH<00G4G$"$ -666>66-366 E6 6 6 6 6 6 6 6 6 " ":!4"m##    $"$ - XX c6 6 6 6 6 6 6 6 `  [6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 p    %LmLLsLL           KKA M3#7#7 %!  s,LB(L .F?>L ?J)L  L+J)9BJ$J)L  L$J))L -KL  K:K5#K:$L ( L5K::L > L LLLL L7 L2,L72L7crt|sdSd|v}|dt}|r|dkrEtrdSt rdSt rdSt ddS|dkrOt rdStrt ddSt ddS|dkr4trtd rdSt d dS|d kr3trtrd St d dS|d kr4trtdrd St ddS|dkrAddl m}|drdSt ddS|dkr-tdrdSt ddS|StrdSt rdSt rdStr+td rt ddStr*trt dd Str+tdrt dd S ddl m}|drt ddSn#t$rYnwxYwtdrt 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). rrr&rzhSTT 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 unavailabler GROQ_API_KEYz7STT provider 'groq' configured but GROQ_API_KEY not setr$z9STT provider 'openai' configured but no API key availablerMISTRAL_API_KEYz`STT provider 'mistral' configured but mistralai package not installed or MISTRAL_API_KEY not setrrresolve_xai_http_credentialsapi_keyzBSTT provider 'xai' configured but no xAI credentials are available elevenlabsELEVENLABS_API_KEYzCSTT provider 'elevenlabs' configured but ELEVENLABS_API_KEY not setz.No local STT available, using Groq Whisper APIz0No local STT available, using OpenAI Whisper APIz: type: command`` wins over a plugin. The caller short-circuits to the command runner before reaching us, but we re-verify here so a refactor of the caller can't silently break the invariant (matches TTS PR #17843 precedence rule). 3. Plugin dispatch fires only when ``provider`` matches a registered :class:`TranscriptionProvider` whose ``name`` equals the configured value. Unknown names with no plugin registered return None (caller surfaces the legacy "No STT provider" message). 4. Availability gating: when the matched plugin reports ``is_available() == False`` (missing API key, missing optional SDK, etc.) this returns an error envelope identifying the plugin as unavailable — **not** ``None`` — because the user explicitly opted into this plugin via ``stt.provider`` and the generic fallthrough message would be misleading. Provider exceptions are caught and converted into the standard error envelope (matches the legacy built-in error shapes — the gateway/CLI caller already expects ``{success: False, error: "...", transcript: ""}`` on failure). Nrr) get_provider)_ensure_plugins_discoveredT)forcez2STT plugin dispatch skipped (discovery failed): %suNSTT plugin provider '%s' is_available() raised: %s — treating as unavailableexc_infoFzRSTT plugin provider '%s' reports not available; returning unavailability envelope.rlz STT plugin 'uY' is not available — check that its required credentials / dependencies are configured.)r3r4r5rz-Transcribing with plugin STT provider '%s'...r^z#STT plugin provider '%s' raised: %sz ' raised: z' returned a non-dict resultr)rrnrrragent.transcription_registryr`hermes_cli.pluginsrarMr{r is_availabler|rF transcriberr setdefault) r/rrOr8r7rr`raplugin_providerr availablerJs r_dispatch_to_plugin_providerrlis#X t ..   " "C ###sf}}t"A&z377##t======AAAAAA""$$$&,s++  " ' &T 2 2 2 2*l3//O  I3OOOtttttt#0022  &'*C$          '(+   FsFFF    KK?EEE  ++ ,        13d    8C88388           fd # # ECEEE     j#&&& MsN:B C #CC C&& D0 DD!E:: F9*F4.F94F9c Tt|}tj|r ddd|dS|s ddd|dS|s ddd|dS|jtvr6ddd|jdd ttdS | j }|tkrddd |d z d d td z dddSn #t$r}ddd|dcYd}~Sd}~wwxYwdS)z>Validate the audio file. Returns an error dict or None if OK.FrlzPath is a symbolic link: r3r4r5r6zPath is not a file: zUnsupported format: z . Supported: z, zFile too large: iz.1fzMB (max z.0fzMB)zFailed to access file: N)rrpathislinkr[is_filesuffixrSUPPORTED_FORMATSrsortedstatst_size MAX_FILE_SIZErG)r/ audio_path file_sizees r_validate_audio_filer{siJ w~~j!!f =dYb=d=deee     c =aV_=a=abbb     a =_T]=_=_```  (999rJ,=rrDIIV\]nVoVoLpLprr   \OO%%- } $ $  uI,CuuuQ^bkQluuuu  % \\\ =ZWX=Z=Z[[[[[[[[\ 4s =D D%D D% D%) libcublaslibcudnn libcudartzcannot be loadedzcannot open shared objectzno kernel image is availablezno CUDA-capable devicez#CUDA driver version is insufficientrcbt|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 dSrrV)rmarkermsgs rrz-_looks_like_cuda_lib_error..=s'CCv}CCCCCCrS)r^any_CUDA_LIB_ERROR_MARKERS)rrs @r_looks_like_cuda_lib_errorr4s4 c((C CCCC+BCCC C CCrScddlm} ||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#rrMrr{r|)rwrrs r_load_local_whisper_modelr@s,+++++ K|JvFKKKK KKK)#..   O    |Ju6JJJJJJJJJKs  A#8AA#A#ctstsddddS t t|kr,td|t |a|atdidptj 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).Frlzfaster-whisper not installedrnNzELoading faster-whisper model '%s' (first load downloads the model)...r&r7 beam_sizer c3HK|]}|jVdSrrrnrsegments rrz$_transcribe_local..v0!O!O7',"4"4"6"6!O!O!O!O!O!OrSulfaster-whisper CUDA runtime failed mid-transcribe (%s) — evicting cached model and retrying on CPU (int8).rrrrrc3HK|]}|jVdSrrrs rrz$_transcribe_local..rrSz;Transcribed %s via local whisper (%s, lang=%s, %.1fs audio)Tr@zLocal transcription failed: %srcLocal transcription failed: )rXrrFrGr{rFrrNrLrrLOCAL_STT_LANGUAGE_ENVrhrrMrr|r#rrrr7durationr5) r/rw _forced_langtranscribe_kwargssegmentsrFr4rrrzs r_transcribe_localr[s a$&& a$BA_`` `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<74C,+F<, E96A9E4/F<4E99AF<< G6%G1+G61G6work_dirct|}|jtvr|dfSt }|sdSt j||jd}|dd||g} tj |ddddtj |dfS#tj $rtd |Yd Stj$rn}|jp'|jpt'|}td ||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-iTrcheckcapture_outputrrrz"ffmpeg conversion timed out for %s)Nz(Audio conversion for local STT timed outz#ffmpeg conversion failed for %s: %sz'Failed to convert audio for local STT: )rrrrLOCAL_NATIVE_AUDIO_FORMATSrgrrorstemrrrr r{r5rrrnrr^)r/rrxreconverted_pathrrzdetailss r_prepare_local_audiorsriJ  $>>>$ " "F gffW\\(z,D,D,DEENtT9n=G Iwd4dTW_i_qrrrrt##  $@@@ 99EEE???  (III(..""@ahnn&6&6@#a&& :IwOOOHwHHHHHHHHHIs%6'B*E EA#E<EEc t}|sddtddStdidpt jt pt}t|} tj d5}t||\}}|rdd|dcd d d S| tj|tj|tj|tj| }tt jtd} | r&t#j|d d d d d t"j n6t#jtj|d d d d t"jt+t-|d} | sddddcd d d S| dd} t2dt-|j|t9| d | ddcd d d S#1swxYwYd S#t:$r} dddtd| dcYd } ~ Sd } ~ wt"j$rp} | jp'| j ptC| } t2"d|| ddd| dcYd } ~ Sd } ~ wtF$r0} t2"d| d ddd| dcYd } ~ Sd } ~ wwxYw)zNRun the configured local STT command template and read back a .txt transcript.Frlz5 not configured and no local whisper binary was foundrnr&r7zhermes-local-stt-r:N)r<r=r7r8Tr)rrrrrrrz*.txtzALocal STT command completed but did not produce a .txt transcriptrr$r%z3Transcribed %s via local STT command (%s, %d chars)rr@zInvalid z template, missing placeholder: z#Local STT command failed for %s: %szLocal STT failed: z7Unexpected error during local command transcription: %srcr)$rtrmrNrLrrrDEFAULT_LOCAL_STT_LANGUAGErrCrDrrrorprrnrrrsplitrtrglobr(r{rFrrKeyErrorrrrr^r5rM)r/rwrr7normalized_modelr=prepared_input prep_errorr use_shell txt_filesrMrzrs r_transcribe_local_commandrs244  (___     w++// ;; & 9+ , , & % 6jAA1a  (0C D D D" a )=i)T)T &NJ Q#(ZPP" a" a" a" a" a" a" a" a '-- ;~66 ;z22X..k"233 .GRY'>I $"$`+" a" a" a" a" a" a" a" a6(l44g4FFLLNNO KKEY$ O$$     $?P_``E" a" a" a" a" a" a" a" a" a" a" a" a" a" a" a" a" a" aH    Z 5ZZWXZZ         (]]](..""@ahnn&6&6@#a&& :IwOOO =[RY=[=[\\\\\\\\ aaa NPQ\` aaa =_\]=_=_````````asJI84 JD.I8/ J 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).FrlrnNrz*Model %s not available on OpenAI, using %srrrrrr*rrrz,Transcribed %s via OpenAI API (%s, %d chars)Tr$r@rrrrrzOpenAI transcription failed: %srcr)rUrr^rYrzr{rFDEFAULT_STT_MODELr$rrrrrrHrr_extract_transcript_textrrrrrrrMr5)r/rwrTrrrrrrrrrrMrrzs r_transcribe_openair1s ?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}|dd n#t$rYnwxYwdd lm}|| 5}t |d 5}|jj ||t|j d }dddn #1swxYwYt|}tdt|j |t|d|ddcdddS#1swxYwYdS#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. rQFrlzMISTRAL_API_KEY not setrnrrz stt.mistralr)Mistral)rTr)r- file_name)r8rNz-Transcribed %s via Mistral API (%s, %d chars)Trr@rz Mistral transcription failed: %srczMistral transcription failed: )rrrrmistralai.clientrrrHrcompleterrrr{rFrrrMr5r__name__) r/rwrT _lazy_ensurerrrrJrMrzs r_transcribe_mistralrjs -..G X =VWWWr  > > > > > > Lu 5 5 5 5 5    D ,,,,,, WW % % % [i&& *4==$%/d9oo>RSS>                7v>>O KK?Y$j#o2F2F    $?PYZZ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ``` =^S\=^=^_____ rrr 7T JJJ =p^bcd^e^e^n=p=pqqqqqqqqrs.D ;D;DD !7B$ D $B( (D +B( ,AD ? D DDDDE9. E977E4.E94E9c "ddlm}|}t|dpd}|sddddSt }|di}t|d p*t d p|d ptd }t|d ptj d pt}t|dd} t|dd} ddl } ddlm} 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$dt3|d|dd%S#t4$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. rrRrTrlFzRNo xAI credentials found. Configure xAI OAuth in `hermes model` or set XAI_API_KEYrnrrr4/r7r1rTdiarizeN)hermes_xai_user_agenttruerz/sttzBearer ) Authorizationz User-Agentrxheadersfilesdatarr5messagerzxAI STT API error (HTTP ): rz!xAI STT returned empty transcriptz@Transcribed %s via xAI Grok STT (lang=%s, %.1fs audio, %d chars)rr@rz xAI STT transcription failed: %srczxAI STT transcription failed: )r[rSr^rLrnrNrr4rstriprrrrrequestsrrpostrr status_coderrrMr{rFrrr5)r/rwrScredsrTrO xai_configrr7 use_format use_diarizerrrrresponserLerr_bodyrJrMrzs r_transcribe_xairs<;;;;; ( ( * *E%))I&&,"--3355G  i   "##Jr**Jz""  + , ,  99Z      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|;1M,AG:. M:G>>MG>MA I! M!I=:M<I==MAMA*MN N%N N Nc Dtd}|sddddSt}|di}t|dptdptd }t|d pd}t|d d}t|d d} d dl} ||rdnd|rdndd} |r|| d <t|d5} | |dd|idt|j | fi| d} dddn #1swxYwY| j dkrd} | }|dp|d}t|t r%t|dp|} n!|rt|} n| jdd} n#t$$r| jdd} YnwxYwddd| j d| dS| }t'|}|sddddSt(d t|j |t-|d!|dd"S#t.$r ddd#|dcYSt$$r0}t(d$|d!%ddd&|dcYd}~Sd}~wwxYw)'z+Transcribe using ElevenLabs Scribe STT API.rVFrlzELEVENLABS_API_KEY not setrnrUrr5r language_codetag_audio_eventsrrNrfalse)model_idrrrz/speech-to-textz xi-api-keyrrrrrLr5rrzElevenLabs STT API error (HTTP rz(ElevenLabs STT returned empty transcriptz3Transcribed %s via ElevenLabs Scribe (%s, %d chars)Tr@rz'ElevenLabs STT transcription failed: %srcz%ElevenLabs STT transcription failed: )rrNrLr^r5rnrrrrrrrrrrrrrMrr{rFrrr5)r/rwrTrOelevenlabs_configrrrrrrrrrLr error_valuerJrMrzs r_transcribe_elevenlabsrs011G [ =YZZZ!##J"|R88j)) # 2 3 3 # " eggffSkk  )--o>>D"EEKKMMM&'8'<'<=OQV'W'WXX/33IuEEFFG=j#*: G!(5vvg    2$1D ! )T " " j}},,,%w/Y 4jAB %H                 3 & &F -#==??&ll844M W8M8M k4001 !;!;!J{KKFF 1 --FF%]4C40F - - -!tt, -! \8;O\\TZ\\  26::   C   A OO       LYYY ``` =^S\=^=^_____ jjj >D QQQ =hef=h=hiiiiiiiijsz)K?6F5 KFKF KBH43K4I KIK$*KAKL& L/%LLLc~t|}|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!||S|d krC|d i} |p| dt"}t%||St'||} | t)||| ||St+||t,r||ini} | d} |p| d} t/|||| | }||Sdddt0ddS)a Transcribe an audio file using the configured STT provider. Provider priority: 1. User config (``stt.provider`` in config.yaml) 2. Auto-detect: local > Groq > OpenAI > Mistral > xAI > ElevenLabs 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 Frlz4STT is disabled in config.yaml (stt.enabled: false).rnr&r8rrr$rrzgrok-sttrUrN)r1r7r^zZNo STT provider available. Install faster-whisper for free local transcription, configure a/ or install a local whisper CLI, set GROQ_API_KEY for free Groq Whisper, set MISTRAL_API_KEY for Mistral Voxtral Transcribe, configure xAI OAuth or set XAI_API_KEY for xAI Grok STT, set ELEVENLABS_API_KEY for ElevenLabs Scribe, or set VOICE_TOOLS_OPENAI_KEY or OPENAI_API_KEY for the OpenAI Whisper API.)r{rNrRr]rLrr}rrrrrrrDEFAULT_MISTRAL_STT_MODELrrDEFAULT_ELEVENLABS_STT_MODELrrrNrrrlrm)r/r8r5rOr local_cfgrw openai_cfg mistral_cfgelevenlabs_cfgcommand_provider_config plugin_cfgplugin_language plugin_model plugin_results rtranscribe_audior Ws,( ! + +E  "##J * % % K   Z((H7NN7B// +  @Y]]7,?@@  !J777?""NN7B// 3  @Y]]7,?@@  )J???644  :6668^^Hb11 HjnnW6GHH !)Z8889 nnY33 Qkoog7PQQ "9j9995(j y*555<# b99Zn00=YZZ %i<<<C8ZXX*&   #      *2>*b11L>\<_==133N/..2>BBOi % ' '  7< G !!!  *G  ) 0 0 5 5888$-- rSrct|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)rr^rnhasattrrrrL)rrs rrrs-%%%""$$$}f%%! v.. eS ! ! !;;== -&&!!!&)) eS ! ! !;;== }   # # % %%rSr)t__doc__loggingrror_rrCpathlibrtypingrrr urllib.parserutilsrtools.managed_tool_gatewayr tools.tool_backend_helpersr r r getLoggerrr{rrrrr^rr"rXrYrZrWr}rrrrrrrmrrZr2rr4r5rsrrwryrzrFobject__annotations__rGrrNrRrWrcrgrjrtrvrrr frozensetrrrBrrrrrrrrrrrintrrrrrrr!r.rNr]rlr{r BaseExceptionrrrtuplerrrrrrrr rUrrVrSrr(sQ 8 &&&&&&&&&& !!!!!!CCCCCC  8 $ $ / / / /$IIIIII&o&677oh'' {++ !BI0+>>"#35MNN%BI&9;PQQ(ry)?MM24? /+KLL ")13NOO29/1FGG#")$=?]^^hhh666 MLL ZZZ "& hv%%%#'8C='''$22x~222224%c%hsm%%%%"Xc]""""#hsm#### Xc]    5D5555x}*.x}.....t<" ###<'*##$)!&Y'D'D'DEE8c3h8s8tCH~8888S#X  #s(^<>DcN>t>>>>S#Xd38n* DcN    htCH~.FRV T#s(^     [4S>[c[[[[schsm@#hsmPS(%%sCx.% %%%%P>j.>>4>>>>B(Qc(QE(Qj6Q(Q(Q(Q(QV$##F%) ~~~~ cN~S#X ~ SM ~  #s(^ ~~~~BxdxsxxxxF,0L  " LLLLLc3h(L C= L sm Ld38nLLLLhCHT#s(^,DV  DM Dd D D D DK#KKKK6:a:a#:a$sCx.:a:a:a:azICI3I5#PXY\P]A];^IIII2EaEa#Ea$sCx.EaEaEaEaX-[-[-[c3h-[-[-[-[h2[#2[32[4S>2[2[2[2[r$r3$rC$rDcN$r$r$r$rXccsccccS#XccccccccVNjcNjsNjtCH~NjNjNjNjlHSMT#s(^DU38_<&C&C&&&&&&rS