File size: 1,434 Bytes
8145bee | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 | """Select a browser executor without importing optional browser packages."""
import os
from typing import Protocol
class BrowserRefusal(RuntimeError):
"""Expose a fixed refusal code without provider text or arguments."""
def __init__(self, code="backend_unavailable"):
self.code = code if code in {"backend_unavailable", "blocked_origin", "sign_in_failed",
"read_only", "needs_code", "needs_human"} else "backend_unavailable"
super().__init__(self.code)
class BrowserBackend(Protocol):
"""Keep browser and credential operations behind the executor seam."""
def open(self, origin, *, origin_guard): ...
def goto(self, url): ...
def snapshot_text(self): ...
def click(self, handle, *, executor=False): ...
def type_handle(self, handle, text): ...
def fill_secret(self, handle, value, *, origin): ...
def close(self): ...
def get_backend():
"""Refuse an unconfigured executor before any model or browser call."""
selected = os.environ.get("AIOS_BROWSER_BACKEND", "").strip().lower()
if selected == "local":
from browser_local import LocalBrowser
return LocalBrowser()
if selected == "agentcore":
try:
from browser_agentcore import AgentCoreBackend
return AgentCoreBackend()
except Exception:
raise BrowserRefusal() from None
raise BrowserRefusal()
|