einBdZddlmZmZddlmZGddeZdS)z0Abstract base class for cloud browser providers.)ABCabstractmethod)DictceZdZdZedefdZedefdZedede ee ffdZ ededefdZ ededd fd Z d S) CloudBrowserProvideraCInterface for cloud browser backends (Browserbase, Steel, etc.). Implementations live in sibling modules and are registered in ``browser_tool._PROVIDER_REGISTRY``. The user selects a provider via ``hermes setup`` / ``hermes tools``; the choice is persisted as ``config["browser"]["cloud_provider"]``. returncdS)z9Short, human-readable name shown in logs and diagnostics.Nselfs >/home/div/.hermes/hermes-agent/tools/browser_providers/base.py provider_namez"CloudBrowserProvider.provider_namecdS)uReturn True when all required env vars / credentials are present. Called at tool-registration time (``check_browser_requirements``) to gate availability. Must be cheap — no network calls. Nr r s r is_configuredz"CloudBrowserProvider.is_configuredrrtask_idcdS)u|Create a cloud browser session and return session metadata. Must return a dict with at least:: { "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 "features": dict, # feature flags that were enabled } ``bb_session_id`` is a legacy key name kept for backward compat with the rest of browser_tool.py — it holds the provider's session ID regardless of which provider is in use. Nr )r rs r create_sessionz#CloudBrowserProvider.create_sessionrr session_idcdS)zRelease / terminate a cloud session by its provider session ID. Returns True on success, False on failure. Should not raise. Nr r rs r close_sessionz"CloudBrowserProvider.close_session.rrNcdS)uBest-effort session teardown during process exit. Called from atexit / signal handlers. Must tolerate missing credentials, network errors, etc. — log and move on. Nr rs r emergency_cleanupz&CloudBrowserProvider.emergency_cleanup5rr)__name__ __module__ __qualname____doc__rstrrboolrrobjectrrrr rr rrsHsHHH^H t   ^  c d3;.?   ^ "     ^  C D   ^   rrN)rabcrrtypingrrr rr r%si66########4 4 4 4 4 34 4 4 4 4 r