File size: 1,434 Bytes
89af3b2
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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()