+ lHj‰aRt0tRt^RIHt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI t ^RI t ^RI t ^RIt^RIHt^RIHtHtHtHtHt^RIt^RIHt] P4!]4tRRlt^RIHtH t H!t!H"t"H#t#H$t$^R I%H&t&^R I'H(t(H)t)H*t*H+t+H,t,H-t-H.t.^R I/H0t0H1t1H2t2H3t3H4t4H5t5H6t6^R I7H8t8H9t9H:t:^R I;Ht>^RI?H@t@HAtAHBtBRRRRRR/tCRRRlltD]D!RRR7tE]D!RRRR7tF]D!RR4tG]D!RRRR7tH]D!R4tI]D!R R!4tJ]D!R"R#4tKR$R%ltLR&R'ltMR(R)ltNR*R+ltOR,R-ltPR.tQR/R0ltR]R!4;tStTR1R2ltUR3R4ltVR5R6ltW]X!0Rm4tY] P!R7] P4t\]X!0Rm4t]]X!0Rm4t^R8R=RR>R?]!R4 23RR@RARBRC3RDRERFRGRH3R;RR`` and plugin-registered ones. Output is Opus (.ogg) on voice-bubble platforms, MP3 elsewhere. Sibling ``tts_tool_*`` modules hold backends/delivery/lifecycle; they read the seams defined here (config, provider resolution, lazy SDK importers) through ``_origin()`` at call time. ) install_hintN)Path)CallableDictAnyListOptional)display_hermes_homec<V^8dQhR\R\R\/#)env_var provider_idreturnstr)formats"3/home/ubuntu/.hermes/hermes-agent/tools/tts_tool.py __annotate__r s!9939S9S9c^RIHpV!W4#)z\Resolve a TTS provider API key via the shared voice-key resolver (config > env/.env > pool).)resolve_provider_secret)tools.tool_backend_helpersr)r r rs&& r_resolve_provider_keyr sB "7 88r)BUILTIN_TTS_PROVIDERS#_configured_command_tts_output_path_generate_command_tts_get_command_tts_output_format _is_command_tts_voice_compatible _resolve_command_provider_config)NOUS_MANAGED_PROVIDER)_resolve_max_text_length_build_audio_delivery_files_convert_to_opus_remove_quietly_repair_ogg_container_resolve_audio_delivery_profile_split_text_for_tts)_generate_edge_tts_generate_elevenlabs_generate_gemini_tts_generate_minimax_tts_generate_mistral_tts_generate_xai_tts_resolve_minimax_tts_runtime)_generate_kittentts_generate_neutts_generate_piper_tts)_dispatch_to_plugin_provider_plugin_provider_is_available$_plugin_provider_is_voice_compatible)_generate_deepinfra_tts_generate_openai_tts_has_openai_audio_backendztts.edgeedge-ttsztts.elevenlabs tts-premiumz tts.mistralmistralc V^8dQhR\R\\,R\\,R\.\3,/#)r moduleattrfeaturer)rrrr)rs"rrr:s=#Xc]HSM]efhjmfm]nrc\aaaVVV3RlpRSPR4^, 2VnV#)aqLazy SDK importer: returns ``module`` (or ``module.attr``), raising ImportError when absent. ``feature`` names a ``pm.ensure_import`` extra to best-effort install first (users who enabled a provider in config.yaml never ran the post-setup hook); any failure there falls through so the raw import still raises cleanly. sounddevice also raises OSError without PortAudio.c,<S'dN\P!\4;_uu_4^RIHpV!\ P SS44RRR4\P!S4pS'd \VS4#T# +'giL<;i)) ensure_importN) contextlibsuppress ExceptionpmrA_PM_FEATURE_ALIASESget importlib import_modulegetattr) _pm_ensuremodr<r=r;s r_import_sdk_importer.._import@sd $$Y//:.227GDE0%%f-%)wsD!2s2 0/s #B B _import_.)split__name__)r;r<r=rMsfff r _sdk_importerrS:s- 3"&,,s"3A"6!78G Nredge_tts)r=zelevenlabs.client ElevenLabsopenaiOpenAIzmistralai.clientMistral sounddevice kittentts KittenTTSpiper PiperVoicecJV^8dQhR\.\3,R\/#)r importerr)rrbool)rs"rrrTs#(2s7+rc:V!4R# \dR#i;iTF) ImportError)r_s&r _importablerdTs!  s  c0V^8dQhR\R\/#)r namerrr`)rs"rrr\sSTrcj\PPV4RJ# \dR#i;i)NF)rHutil find_specrD)rfs&r_package_installedrk\s3~~''-T99 s # 22c$V^8dQhR\/#r rr`)rs"rrrcs JJJrc\R4#)neuttsrkrr_check_neutts_availablerscs .@.J'Jrc$V^8dQhR\/#rmrn)rs"rrrds PPDPrc\R4#)rZrqrrrr_check_kittentts_availablervds 1CK1P*Prc$V^8dQhR\/#rmrn)rs"rrres HHHrc\R4#)r\rqrrrr_check_piper_availableryes -?-H&Hredgec$V^8dQhR\/#rmr)rs"rrrls===rc2^RIHp\V!RR44#)r@get_hermes_dirz cache/audio audio_cache)hermes_constantsr~rr}s r_get_default_output_dirrls/ ~m]; <>.>EEGMMOH#888FhFrz,media:\s*[`'\"*_]*(?:[`'\"]|[a-z]:[/\\]|~?/) elevenlabsgeminirpminimaxxaic \\4#N)rd_import_elevenlabsrrrrrs ;'9:rr(zJElevenLabs provider selected but 'elevenlabs' package not installed. Run: c \\4#rrd_import_openai_clientrrrrrrs {#89rz OpenAI TTSr5z.s'++0xLMr)ThreadPoolExecutor) max_workers)timeoutN)concurrent.futuresrsubmitresult RuntimeError)rrrrrpoolsfff r _run_edge_ttsrsY MC9 A . .$ KK  # #B # // . . .  s.A$"AA$ A! A$!A$$A:9A:c0V^8dQhR\R\/#r rr)rtuple)rs"rrrsLLSLULrc2\PV4pVe&Vwr#rEYeV!4'g \V43#R3#\\4'dVR3#\ 4'd\ PR4R#V\R\R4 R243#)zSDK check -> ``(engine, None)`` or ``(provider, error_json)``. Unknown names take the Edge default; without edge-tts NeuTTS is the fallback (engine != provider).Nz9Edge TTS not available, falling back to NeuTTS (local)...z1No TTS provider available. Enable Edge TTS with: r7zA or run 'hermes setup tts' and choose NeuTTS for local synthesis.)rpN) _BUILTIN_DISPATCHrGrrd_import_edge_ttsrsrinfor)rentry available_label _generator missing_errors& r_select_builtin_enginers  ! !( +E 7<4 :8MV_VaVa+m4llgkll#$$~   OP [;  # $%K KL LLrc V^8dQhR\R\R\R\\\3,R\\,RR/#)r enginerrr instructionsrN)rrrr)rs"rrrsI 8 8 83 8# 84PSUXPX> 8iqruiv 8{ 8rc \PV4p\PRV'd V^,MR4Vf\ WV4R#VR8Xd\ WW4R7R#\ 4V^,,!WV4R#)z+Run the already-selected built-in *engine*.zGenerating speech with %s...zEdge TTSNrV)r)rrGrrrr5globals)rrrrrrs&&&&& r_synthesize_builtinrs_  ! !& )E KK.EazR }dj1 8 TZS %(DJ7rc V^8dQhR\R\R\\\\3,,R\R\ /#)r rrcommand_provider_config want_opusr)rrrrr`r)rs"rrrsA/// /;CDcN;S/`d/ /rcVe \V4pMV\9d \V4pMtV'd>V\9d3VP R4'g\ V4pV'dVR3#VR3#V\ 9pY;'dT;'dVP R43#V'gVR3#VP R4'g\ V4;'gTpWP R43#)aFVoice-bubble eligibility (Opus-converting when needed) -> ``(path, voice_compatible)``. Command/plugin providers are documents unless they opt in via ``voice_compatible``; native-Opus built-ins qualify when the platform wants Opus and they wrote .ogg; MP3/WAV built-ins are ffmpeg-converted only when the platform needs Opus.z.oggTF)rrr3_FFMPEG_OPUS_PROVIDERSendswithr"_NATIVE_OPUS_PROVIDERS)rrrropted_in opus_pathnatives&&&& r_finalize_voice_deliveryrs*34KL . .7A x#99(BSBSTZB[B[$X. $- 4 DHe3DD33KKIKK(2C2CF2KKK    V $ $#H-99 &&v. ..rc4V^8dQhR\R\RR/#)r requested configuredrNr)rs"rrrs!3CDrcV'gR#RV3pV\9dR#\PV4\PRVV4R#)uGOnce-per-process (per distinct requested value) warning for ignored per-call provider overrides — a stale session whose cached tool schema still advertises the param would otherwise repeat it every call; and callers with no tts config at all are silent (nothing to disagree WITH — default resolution just runs). See #90109.Ntts_provider_overridez>Ignoring per-call TTS provider override %r; tts.provider is %r)_once_warningsaddrr)rrkeys&& r#_warn_ignored_tts_provider_overridersB  "I .C ns NNHrcV^8dQhR\\\3,R\\,R\\,/#)r rspeedr)rrrrfloat)rs"rrr#s4++d38n+Xe_+X`adXe+rc Ve&/VCR\R\R\V444/Cp\V4pV'd8VP 4P 4pV'dWC8wd \ WC4W3#)uApply per-call ``speed`` (clamped, on a shallow copy so the cached config isn't mutated) and resolve the provider name. ``tts.provider`` in config.yaml is the authoritative backend selector (#90109): the per-call argument stays for internal/test callers, but a value that disagrees with the configured provider is ignored — the model-facing schema no longer advertises the override, and a leaked platform hint passing one anyway must not reroute speech to another vendor behind the operator's back.rg?g@)maxminrrrrr)rrrconfigured_providerrs&&& r_apply_call_overridesr#si O OGSs3e 7M-NO ' 3NN$**, 9 / O  **rc$V^8dQhR\/#rm)r)rs"rrr4s6656rcP^RIHpV!RR4P4pW\93#)u]``(platform, wants_opus)`` — platforms delivering voice bubbles only as Ogg/Opus want Opus.)get_session_envHERMES_SESSION_PLATFORM)gateway.session_contextrrOPUS_VOICE_PLATFORMS)rplatforms r_session_platformr4s*78"=CCEH !55 55rc V^8dQhR\\,R\R\\\\3,,R\R\ /#)r output_pathrrrr)rrrrr`r)rs"rrr;sJ''#'*-'HPQUVY[^V^Q_H`'mq' 'rcV'd^RIHpHpV!V4'dR\R43#\P V4'dR\R43#V!V4'dR\RV R243#\ V4P4pVe \Wb4p^RI H pH pV!\V44'gV!\V44'dR\RV R 243#MtVe \V4p MV'dV\9dR MR p \PP!4P#R 4p \ \%44R V RV 2, pVP&P)RRR7VR3#)aVPick the output file -> ``(Path, None)`` or ``(None, error_json)``. A caller path is rejected on ``..`` traversal (bug or prompt-injection; absolute is fine) and on protected credential/system locations. Default ``