tts_registry.py 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. """TTS Provider Registry.
  2. Registered plugin TTS providers, populated at import-time via
  3. :meth:`PluginContext.register_tts_provider` and consulted by :mod:`tools.tts_tool`
  4. only when ``tts.provider`` is neither a built-in nor a command-type provider.
  5. Built-ins always win: a colliding plugin name is rejected here with a warning
  6. (re-checked at dispatch). Command-providers-win-over-plugins is enforced by the
  7. dispatcher (a name in the user's config.yaml is more specific than a plugin).
  8. """
  9. from __future__ import annotations
  10. import logging
  11. from agent.provider_registry import ProviderRegistry, lower_key
  12. from agent.tts_provider import TTSProvider
  13. logger = logging.getLogger(__name__)
  14. # Names reserved for native built-in TTS handlers. **Kept in sync with
  15. # ``BUILTIN_TTS_PROVIDERS`` in :mod:`tools.tts_tool`** (``TestBuiltinSync`` in
  16. # ``tests/agent/test_tts_registry.py`` fails on drift); importing it directly
  17. # would be a circular import.
  18. _BUILTIN_NAMES = frozenset({
  19. "edge", "elevenlabs", "openai", "minimax", "xai", "mistral", "gemini", "neutts", "kittentts",
  20. "piper", "deepinfra",
  21. })
  22. def _warn_builtin_collision(key: str) -> None:
  23. logger.warning(
  24. "TTS provider '%s' shadows a built-in name; registration ignored. "
  25. "Built-in TTS providers (%s) always win — pick a different name.",
  26. key, ", ".join(sorted(_BUILTIN_NAMES)),
  27. )
  28. # Case-insensitive, whitespace-tolerant keys mirror how
  29. # ``tools.tts_tool._get_provider`` normalizes the configured ``tts.provider``.
  30. _registry: ProviderRegistry[TTSProvider] = ProviderRegistry(
  31. label="TTS", provider_cls=TTSProvider, logger=logger, normalize=lower_key,
  32. builtin_names=_BUILTIN_NAMES, on_builtin_collision=_warn_builtin_collision,
  33. )
  34. _registry.export(globals())