image_gen_registry.py 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. """Image generation provider registry.
  2. Populated by plugins at import-time via ``PluginContext.register_image_gen_provider()``;
  3. the ``image_generate`` tool dispatches to :func:`get_active_provider`. Selection is
  4. ``image_gen.provider`` in config.yaml; when unset: the single *available* provider,
  5. else ``fal`` if registered and available (legacy default), else ``None`` (the tool
  6. points the user at ``hermes tools``).
  7. """
  8. from __future__ import annotations
  9. import logging
  10. from typing import Optional
  11. from agent.image_gen_provider import ImageGenProvider
  12. from agent.provider_registry import ProviderRegistry, configured_provider_name, is_available_safe
  13. logger = logging.getLogger(__name__)
  14. _registry: ProviderRegistry[ImageGenProvider] = ProviderRegistry(
  15. label="Image gen", provider_cls=ImageGenProvider, logger=logger,
  16. )
  17. _registry.export(globals())
  18. def get_active_provider() -> Optional[ImageGenProvider]:
  19. """Resolve the currently-active provider. Availability semantics (mirrors
  20. :mod:`agent.web_search_registry`): an explicitly configured provider is returned
  21. even if ``is_available()`` is False, so the dispatcher surfaces a precise
  22. "X_API_KEY is not set" error instead of silently switching backends; only the
  23. unconfigured fallback path is filtered by availability."""
  24. configured = configured_provider_name("image_gen", logger)
  25. snapshot = _registry.merged()
  26. if configured:
  27. if snapshot.get(configured) is not None:
  28. return snapshot[configured]
  29. logger.debug("image_gen.provider='%s' configured but not registered; falling back", configured)
  30. def _available(p: ImageGenProvider) -> bool:
  31. return is_available_safe(p, logger, "image_gen provider %s.is_available() raised %s")
  32. available = [p for p in snapshot.values() if _available(p)]
  33. if len(available) == 1:
  34. return available[0]
  35. fal = snapshot.get("fal")
  36. return fal if fal is not None and _available(fal) else None