`gjLUdZddlmZddlZddlZddlmZmZmZddl m Z eje Z ehdZiZded<ej$Zd d Zdd Zdd Zdd Zy)u TTS Provider Registry ===================== Central map of registered TTS providers. Populated by plugins at import-time via :meth:`PluginContext.register_tts_provider`; consumed by :mod:`tools.tts_tool` to dispatch ``text_to_speech`` tool calls to the active plugin backend **when** the configured ``tts.provider`` name is neither a built-in nor a command-type provider. Built-ins-always-win -------------------- Plugin names that collide with a built-in TTS provider (``edge``, ``openai``, ``elevenlabs``, ``minimax``, ``gemini``, ``mistral``, ``xai``, ``piper``, ``kittentts``, ``neutts``) are rejected at registration with a warning. This invariant is also re-checked at dispatch time in :func:`tools.tts_tool._dispatch_to_plugin_provider`. Command-providers-win-over-plugins ---------------------------------- This registry doesn't enforce the command-vs-plugin precedence — that lives in the dispatcher, which checks for a same-name ``tts.providers.: type: command`` entry before consulting the registry. The rationale is locality: a name declared in the user's ``config.yaml`` is more specific to their setup than a plugin that happens to be installed. ) annotationsN)DictListOptional) TTSProvider> xaiedgepipergeminineuttsopenaiminimaxmistral deepinfra kittentts elevenlabszDict[str, TTSProvider] _providersc t|ts!tdt|j|j }t|t r|js td|jj}|tvr4tjd|djttyt5t j#|}|t |<ddd+tj%d|t|jytj%d|t|jy#1swYaxYw)uRegister a TTS provider. Rejects: - Non-:class:`TTSProvider` instances (raises :class:`TypeError`). - Empty/whitespace ``.name`` (raises :class:`ValueError`). - Names colliding with a built-in (logs a warning, silently ignores — built-ins-always-win invariant). Re-registration (same ``name``) overwrites the previous entry and logs a debug message — makes hot-reload scenarios (tests, dev loops) behave predictably. z8register_provider() expects a TTSProvider instance, got z-TTS provider .name must be a non-empty stringuTTS provider '%s' shadows a built-in name; registration ignored. Built-in TTS providers (%s) always win — pick a different name.z, Nz(TTS provider '%s' re-registered (was %r)z!Registered TTS provider '%s' (%s)) isinstancer TypeErrortype__name__namestrstrip ValueErrorlower_BUILTIN_NAMESloggerwarningjoinsorted_lockrgetdebug)providerrkeyexistings E/root/.hermes/venv/lib/python3.12/site-packages/agent/tts_registry.pyregister_providerr*Cs h ,>**+ -   ==D dC  HII **,   C n P 6.12  #>>#&" 3# 6 h((  / h(( ##s EEct5ttj}dddt dS#1swYxYw)z0Return all registered providers, sorted by name.Nc|jS)Nr)ps r)z list_providers..ts qvv)r')r#listrvaluesr")itemss r)list_providersr4ps; *Z&&()* %- ..**s ;Act|tsytj|j j S)uReturn the provider registered under *name*, or None. Name matching is case-insensitive and whitespace-tolerant — mirrors how ``tools.tts_tool._get_provider`` normalizes the configured ``tts.provider`` value. N)rrrr$rrr-s r) get_providerr6ws/ dC  >>$**,,,. //r0cbt5tjdddy#1swYyxYw)z"Clear the registry. **Test-only.**N)r#rclearr0r)_reset_for_testsr:s& s%.)r&rreturnNone)r;zList[TTSProvider])rrr;zOptional[TTSProvider])r;r<)__doc__ __future__rlogging threadingtypingrrragent.tts_providerr getLoggerrr frozensetrr__annotations__Lockr#r*r4r6r:r9r0r)rGsq8#''*   8 $  &( "' * Z/ 0r0