loopable / api /browser_backend.py
fsanyoto's picture
Deploy AIOS web (React glide grid + FastAPI slice)
8145bee verified
Raw History Blame
1.43 kB
"""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()