Browser Pool Migration Guide¶

# This automatically uses UITesterAgentV2 (BrowserPoolClient)
from src.agents import UITesterAgent

agent = UITesterAgent()
result = await agent.execute(test_spec=spec, app_url="https://example.com")

from src.agents import UITesterAgentLegacy

agent = UITesterAgentLegacy()  # Uses E2EBrowserClient

from src.browser import E2EBrowserClient

async with E2EBrowserClient() as client:
    page = await client.new_page("https://example.com")
    await page.act("Click Sign In")
    data = await page.extract({"username": "string"})

from src.browser import BrowserPoolClient

async with BrowserPoolClient() as client:
    # Discover elements (like MCP /observe)
    result = await client.observe("https://example.com")

    # Execute action with self-healing
    result = await client.act("https://example.com", "Click Sign In")

    # Extract data
    result = await client.extract(
        "https://example.com",
        {"username": "string"}
    )

result = await run_test_with_e2e_client(
    url="https://example.com",
    steps=["Click Login", "Type email", "Submit"],
)

from src.browser import BrowserPoolClient

async with BrowserPoolClient() as client:
    result = await client.test(
        url="https://example.com",
        steps=["Click Login", "Type email", "Submit"],
        capture_screenshots=True,
    )

    # Access step-by-step results
    for step in result.steps:
        print(f"Step {step.step_index}: {step.instruction}")
        print(f"  Success: {step.success}")
        print(f"  Mode: {step.execution_mode.value}")  # dom/vision

class BrowserPoolClient:
    async def observe(url: str, instruction: str = None) -> ObserveResult
    async def act(url: str, instruction: str, ...) -> ActResult
    async def test(url: str, steps: list[str], ...) -> TestResult
    async def extract(url: str, schema: dict, ...) -> ExtractResult
    async def screenshot(url: str) -> bytes
    async def health() -> PoolHealth

@dataclass
class ObserveResult:
    success: bool
    url: str
    title: str
    elements: list[ElementInfo]  # Discovered interactive elements
    error: Optional[str]

@dataclass
class ActResult:
    success: bool
    message: str
    actions: list[ActionResult]
    url: str
    screenshot: Optional[str]  # Base64
    execution_mode: ExecutionMode  # dom/vision/hybrid

@dataclass
class TestResult:
    success: bool
    steps: list[StepResult]
    total_steps: int
    passed_steps: int
    failed_steps: int
    total_duration_ms: int