transcription_registry.py 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. """Transcription Provider Registry.
  2. Central map of registered STT providers, populated by plugins via
  3. :meth:`PluginContext.register_transcription_provider` and consumed by
  4. :mod:`tools.transcription_tools` to dispatch :func:`transcribe_audio` to the active plugin
  5. backend **when** ``stt.provider`` is not a built-in. Built-ins always win: a colliding name is
  6. rejected at registration with a warning (re-checked at dispatch time).
  7. """
  8. from __future__ import annotations
  9. import logging
  10. from agent.provider_registry import ProviderRegistry, lower_key
  11. from agent.transcription_provider import TranscriptionProvider
  12. logger = logging.getLogger(__name__)
  13. # Native built-in STT handlers. **Kept in sync with ``BUILTIN_STT_PROVIDERS`` in
  14. # :mod:`tools.transcription_tools`** (TestBuiltinSync fails on drift); importing it
  15. # directly would be a circular import.
  16. _BUILTIN_NAMES = frozenset({
  17. "local", "local_command", "groq", "openai", "mistral", "xai", "elevenlabs", "deepinfra",
  18. })
  19. def _warn_builtin_collision(key: str) -> None:
  20. logger.warning(
  21. "Transcription provider '%s' shadows a built-in name; registration ignored. "
  22. "Built-in STT providers (%s) always win — pick a different name.",
  23. key, ", ".join(sorted(_BUILTIN_NAMES)),
  24. )
  25. # Case-insensitive, whitespace-tolerant keys mirror ``tools.transcription_tools``.
  26. _registry: ProviderRegistry[TranscriptionProvider] = ProviderRegistry(
  27. label="Transcription",
  28. provider_cls=TranscriptionProvider,
  29. logger=logger,
  30. normalize=lower_key,
  31. builtin_names=_BUILTIN_NAMES,
  32. on_builtin_collision=_warn_builtin_collision,
  33. )
  34. _registry.export(globals())