+ iHj LRt^RIHt^RIt^RIHt^RIHt!RR]4tR#)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) ProviderBasec]tRt^tRt]P RRl4t]P RRl4t]P RRl4t ]P RR l4t R t R #) BrowserProvidera[Abstract 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. cV^8dQhRR/#)returnbool)formats";/home/ubuntu/.hermes/hermes-agent/agent/browser_provider.py __annotate__BrowserProvider.__annotate__&s##d#c R#)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.Nr )selfs&r is_availableBrowserProvider.is_available%rc V^8dQhRRRR/#)rtask_idstrr zdict[str, object]r )r s"r rr,s66c6.?6rc R#)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 )rrs&&r create_sessionBrowserProvider.create_session+rrc V^8dQhRRRR/#)r session_idrr r r )r s"r rr2sbbbbrc R#)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 rrs&&r close_sessionBrowserProvider.close_session1rrc V^8dQhRRRR/#)rrrr Noner )r s"r rr7s++C+D+rc R#)zyBest-effort teardown from atexit / signal handlers. Must tolerate missing credentials and network errors; must not raise.Nr rs&&r emergency_cleanup!BrowserProvider.emergency_cleanup6rrr N) __name__ __module__ __qualname____firstlineno____doc__abcabstractmethodrrr r%__static_attributes__r rr rrsq ##  66  bb ++rr) r+ __future__rr,typingragent.provider_baserrr rr r2s$(# ,+l+r