`gj?UdZddlmZddlZddlZddlmZmZmZddl m Z eje Z ehdZiZded<ej$Zd d Zdd Zdd Zdd Zy)a Transcription Provider Registry ================================ Central map of registered STT providers. Populated by plugins at import-time via :meth:`PluginContext.register_transcription_provider`; consumed by :mod:`tools.transcription_tools` to dispatch :func:`transcribe_audio` calls to the active plugin backend **when** the configured ``stt.provider`` name is not a built-in. Built-ins-always-win -------------------- Plugin names that collide with a built-in STT provider (``local``, ``local_command``, ``groq``, ``openai``, ``mistral``, ``xai``) are rejected at registration with a warning. This invariant is also re-checked at dispatch time in :func:`tools.transcription_tools._dispatch_to_plugin_provider`. ) annotationsN)DictListOptional)TranscriptionProvider>xaigroqlocalopenaimistral deepinfra elevenlabs local_commandz Dict[str, TranscriptionProvider] _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 transcription provider. Rejects: - Non-:class:`TranscriptionProvider` 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. zBregister_provider() expects a TranscriptionProvider instance, got z7Transcription provider .name must be a non-empty stringuTranscription provider '%s' shadows a built-in name; registration ignored. Built-in STT providers (%s) always win — pick a different name.z, Nz2Transcription provider '%s' re-registered (was %r)z+Registered transcription provider '%s' (%s)) isinstancer TypeErrortype__name__namestrstrip ValueErrorlower_BUILTIN_NAMESloggerwarningjoinsorted_lockrgetdebug)providerrkeyexistings O/root/.hermes/venv/lib/python3.12/site-packages/agent/transcription_registry.pyregister_providerr'8s h 5 6>**+ -   ==D dC  RSS **,   C n  6.12   #>>#&" 3# @ h((  9 h(( ##s EEct5ttj}dddt dS#1swYxYw)z0Return all registered providers, sorted by name.Nc|jS)Nr)ps r&z list_providers..js qvv)r$)r listrvaluesr)itemss r&list_providersr1fs; *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.transcription_tools._get_provider`` normalizes the configured ``stt.provider`` value. N)rrrr!rrr*s r& get_providerr3ms/ dC  >>$**,,,. //r-cbt5tjdddy#1swYyxYw)z"Clear the registry. **Test-only.**N)r rclearr-r&_reset_for_testsr7ys& s%.)r#rreturnNone)r8zList[TranscriptionProvider])rrr8zOptional[TranscriptionProvider])r8r9)__doc__ __future__rlogging threadingtypingrrragent.transcription_providerr getLoggerrr frozensetrr__annotations__Lockr r'r1r3r7r6r-r&rDsq&#''>   8 $  02 ,1 + \/ 0r-