browser_page_registry.py 1.1 KB

1234567891011121314151617181920212223242526272829
  1. """Browser page backends registered by plugins via :meth:`PluginContext.register_browser_page_backend`,
  2. consumed by ``tools.browser_vault_tool``. The backend holding the task's live page wins over the CDP
  3. session; with none, the vault uses the CDP supervisor as before."""
  4. from __future__ import annotations
  5. import logging
  6. from typing import Optional
  7. from agent.browser_page_backend import BrowserPageBackend
  8. from agent.provider_registry import ProviderRegistry
  9. logger = logging.getLogger(__name__)
  10. _registry: ProviderRegistry[BrowserPageBackend] = ProviderRegistry(
  11. label="Browser page backend", provider_cls=BrowserPageBackend, logger=logger,
  12. )
  13. _registry.export(globals())
  14. def backend_for_task(task_id: str) -> Optional[BrowserPageBackend]:
  15. """The registered backend holding ``task_id``'s live page, or ``None``."""
  16. for backend in _registry.list_providers():
  17. try:
  18. if backend.has_page(task_id):
  19. return backend
  20. except Exception as exc: # health: allow BLE001 -- a probing failure means "no page here"
  21. logger.debug("browser page backend %s.has_page raised %s", backend.name, exc)
  22. return None