+ lHjRt^RIHt^RIt^RIt^RIHtHtHtH t ^RI H t H t H t Ht^RIHt]P"!R4tRRR R /R R lltR RltRRltRRltRRltRRltRRltR#)aaPlugin-registered TTS providers for ``tools.tts_tool``: routes ``tts.provider: `` values that are neither built-in nor ``type: command`` to a plugin :class:`agent.tts_provider.TTSProvider`. Discovery goes through ``hermes_cli.plugins._ensure_plugins_discovered`` (imported lazily so the tool module stays importable without the plugin machinery). ) annotationsN)AnyDictOptionalTuple)BUILTIN_TTS_PROVIDERS!DEFAULT_COMMAND_TTS_OUTPUT_FORMAT_get_named_provider_config_is_command_provider_config)NOUS_MANAGED_PROVIDERztools.tts_tooldiscoverTretryFc$V^8dQhRRRRRR/#)keystrr boolr )formats";/home/ubuntu/.hermes/hermes-agent/tools/tts_tool_plugins.py __annotate__rs!   4 t c^RIHpV'd^RIHpV!4V!V4pVfV'dX!RR7V!V4pV#)uThe registered ``TTSProvider`` named *key*, or None. ``discover`` runs plugin discovery first; ``retry`` re-discovers with ``force=True`` on a miss (a long-lived session may predate the plugin's install). Raises on registry/discovery failure — callers decide if fatal.) get_provider)_ensure_plugins_discoveredT)force)agent.tts_registryrhermes_cli.pluginsr)rr r rrplugin_providers&$$ r_lookup_plugin_providerrs=0A"$"3'O5".&s+ rc$V^8dQhRRRRRR/#)rproviderr tts_configdict[str, Any]return Optional[str]r)rs"rrr$s!MrcT;'gRP4P4pV'dV\9g V\8XdR#\ \ W44'dR#V#)zNormalized *provider* when a plugin may service it, else None: built-in names never reach the registry and a same-named ``type: command`` provider wins (config is more local than a plugin).N)lowerstriprr r r )r!r"rs&& r_plugin_route_keyr*$sP >>r " ( ( *C #..#9N2N"#=j#NOO Jrc V^8dQhRRRR/#)rr"r#r$r)rs"rrr/sPP^PPrc z\V\4'dTM/pVPR4VPR4VPR4rCpR\V\4'd V'dTMRR\V\4'd V'dTMRR\V\\ 34'd \ V4/#R/#)z``voice`` / ``model`` / ``speed`` for a plugin call (None = provider default). Shared by ``synthesize`` and the streaming path so a streamed reply keeps the configured voice.voicemodelspeedN) isinstancedictgetrintfloat)r"cfgr-r.r/s& r_plugin_voice_kwargsr6/s#:t44*"C'''*CGGG,N%E j44UD j44UD ZU|%D%DU5\ PPJN PPrc$V^8dQhRRRRRR/#)rr!rr"r#r$zOptional[tuple[Any, int]]r)rs"rrr9s"SnQjrc\W4pVfR#\V4pVe)VP'dVP4'gR#VPp\T\4'g@\T\\34'd$\P!T4'dT^8d\ PRY$4R#T\T43# \ d\ PRTRR7R#i;i)up``(plugin, sample_rate)`` when the plugin servicing *provider* opted into raw-PCM streaming. Opt-in = ``streams_pcm`` truthy AND ``stream_sample_rate`` a finite number >= 1 Hz AND ``is_available()`` — read once per resolve, so per-profile state (key present, user opted out) belongs there. A bad rate is refused loudly: PCM played at a guessed rate garbles speech. Nz+plugin TTS streaming lookup failed for '%s'T)exc_infozpTTS provider '%s' sets streams_pcm without a valid stream_sample_rate (%r); using per-sentence synthesis instead)r*r streams_pcm is_availablestream_sample_rate Exceptionloggerdebugr0rr3r4mathisfinitewarning)r!r"rpluginrates&& r_plugin_pcm_streaming_providerrE9s H 1C {(- >!3!3!36;N;N;P;P(($ZsEl%C%C4==Y]K^K^bfijbj>?B J 3t9   BCRV Ws CC C#C98C9c ,V^8dQhRRRRRRRRRR/#) rtextr output_pathr!r"r#r$r%r)rs"rrrRs8LLsLLLYgLlyLrc\W#4pVfR#\VRR7pTfR#\ T\ 4'dTM/PR\4p\PRT4TP!Y3RT'd\T4P4MR/\T4Bp\ T\4'd T'dT#T# \d"p\P RT4Rp?R#Rp?ii;i) aRoute to a plugin-registered TTS provider; None means "fall through". Invariants re-checked here so a caller refactor can't break them: built-in names never reach the registry; a same-named ``type: command`` provider wins; only an exact registered name dispatches. Plugin exceptions propagate to ``text_to_speech_tool``'s error envelope. Resolution invariants enforced here (matches issue #30398): 1. The caller is responsible for the elif chain that handles ``edge``/``openai``/etc.; this function explicitly rejects those names defensively. 2. 3. Plugin dispatch fires only when ``provider`` matches a registered :class:`TTSProvider` whose ``name`` equals the configured value. Unknown names return None (caller falls through to Edge default). See #17843. NT)r z2tts plugin dispatch skipped (discovery failed): %s output_formatz2Generating speech with plugin TTS provider '%s'...rmp3)r*rr=r>r?r0r1r2rinfo synthesizerr(r6) rGrHr!r"rrexcfmtwrittens &&&& r_dispatch_to_plugin_providerrQRs H 1C {1#TB#J55:2 B B: False).r'F)r Nz5tts plugin voice_compatible check failed for '%s': %s) r(r)rrrvoice_compatibler=r>r?)r!rrrNs& r$_plugin_provider_is_voice_compatiblerVqs~ >>r " ( ( *C #..1#Fd*UUtO4T4T/UU  LcWsA-A-- B8BBc V^8dQhRRRR/#rSr)rs"rrr~sCDrc\V4p\T;'dVP44# \dR#i;i)zh``check_fn`` leg for plugin names: discovered provider reports ``is_available()``; any failure is False.F)rrr;r=)r!rCs& r_plugin_provider_is_availablerY~s?(2F44v22455 s00 ??)__doc__ __future__rloggingr@typingrrrrtools.tts_command_providerrrr r tools.tool_backend_helpersr getLoggerr>rr*r6rErQrVrYrrrrasn # --!!=   + , $ e P2L> r