߲jy bdZddlmZddlZddlmZddlmZGddeZddlm Z dd lm Z y) u0Browser Provider ABC: pluggable cloud browser backends (Browserbase, Browser Use, Firecrawl, …). Providers register via :meth:`PluginContext.register_browser_provider`; the active one (selected by ``browser.cloud_provider``) services every cloud-mode ``browser_*`` tool call. They live in ``/plugins/browser//`` (built-in) or ``~/.hermes/plugins/browser//`` (user). Session metadata contract (legacy ``CloudBrowserProvider`` shape; ``tools.browser_tool`` needs no translation). ``bb_session_id`` is a legacy key name kept verbatim — it holds the provider's session ID regardless of provider:: { "session_name": str, # unique name for agent-browser --session "bb_session_id": str, # provider session ID (for close/cleanup) "cdp_url": str, # CDP websocket URL "expires_at": str, # optional provider-authoritative ISO timestamp "features": dict, # feature flags that were enabled "external_call_id": str, # optional, managed-gateway billing key } ) annotationsN)Dict) ProviderBaseceZdZdZej ddZej ddZej d dZej d dZ y) BrowserProviderakAbstract base class for a cloud browser backend. Subclasses implement :attr:`name` (the ``browser.cloud_provider`` value), :meth:`is_available`, and the lifecycle trio :meth:`create_session` / :meth:`close_session` / :meth:`emergency_cleanup`. ``get_setup_schema`` may add ``"post_setup"`` (e.g. ``"agent_browser"``) to trigger the install hook. cy)uTrue when this provider can service calls. Cheap check only (env var, token readable, dep importable) — must NOT make network calls; runs at tool-registration time and on every ``hermes tools`` paint.N)selfs ;/home/ubuntu/.hermes/hermes-agent/agent/browser_provider.py is_availablezBrowserProvider.is_available%cy)zCreate a cloud browser session and return the metadata dict from the module docstring. May raise ``ValueError`` (missing credentials) or ``RuntimeError`` (network / API failure); the dispatcher surfaces these to the user.Nr )r task_ids r create_sessionzBrowserProvider.create_session+r rcy)zRelease a cloud session by provider session ID. Returns True on success, False on failure; should not raise (log and return False so the dispatcher's cleanup loop keeps moving).Nr r session_ids r close_sessionzBrowserProvider.close_session1r rcy)zBest-effort teardown from atexit / signal handlers. Must tolerate missing credentials and network errors; must not raise.Nr rs r emergency_cleanupz!BrowserProvider.emergency_cleanup6r rN)returnbool)rstrrzDict[str, object])rrrr)rrrNone) __name__ __module__ __qualname____doc__abcabstractmethodr rrrr rr rrsq ##  66  bb ++rr)Any)Optional) r __future__rr typingragent.provider_baserrr"r#r rr r's-(# ,+l+Fr