Responses

from tzafon import Computer

client = Computer()
with client.create(kind="browser") as computer:
    # Each action returns ActionResult
    nav_result = computer.navigate("https://example.com")
    
    if nav_result.status == "SUCCESS":
        print(f"✓ Navigation successful at {nav_result.timestamp}")
    else:
        print(f"✗ Failed: {nav_result.error_message}")
        exit()
    
    # Screenshot returns URL in result dict
    screenshot = computer.screenshot()
    if screenshot.status == "SUCCESS":
        url = screenshot.result['screenshot_url']
        print(f"Screenshot saved: {url}")

from tzafon import Computer

client = Computer()
with client.create(kind="browser") as computer:
    computer.navigate("https://example.com")

    # Request page context with any action
    result = computer.execute_action({
        "type": "screenshot",
        "include_context": True
    })

    context = result.page_context
    print(f"URL: {context.url}")
    print(f"Title: {context.title}")
    print(f"Viewport: {context.viewport_width}x{context.viewport_height}")
    print(f"Page size: {context.page_width}x{context.page_height}")
    print(f"Scroll: ({context.scroll_x}, {context.scroll_y})")
    print(f"Scale: {context.device_scale_factor}x")
    print(f"Tab ID: {context.tab_id}")
    print(f"Is main tab: {context.is_main_tab}")

from tzafon import Computer

client = Computer()
with client.create(kind="browser") as computer:
    computer.navigate("https://example.com/long-page")

    # Get current context
    result = computer.execute_action({
        "type": "screenshot",
        "include_context": True
    })

    context = result.page_context

    # Calculate if we need to scroll to reach the bottom
    current_bottom = context.scroll_y + context.viewport_height
    page_height = context.page_height

    if current_bottom < page_height:
        # Scroll to bottom
        scroll_amount = page_height - current_bottom
        computer.scroll(dx=0, dy=scroll_amount)
        print(f"Scrolled {scroll_amount}px to reach bottom")
    else:
        print("Already at bottom of page")

from tzafon import Computer

client = Computer()
with client.create(kind="browser") as computer:
    result = computer.navigate("https://example.com")
    
    if result.status == "ERROR":
        print(f"Navigation failed: {result.error_message}")
        # Handle error: retry, log, exit, etc.
        exit()
    
    # Continue only if successful
    computer.click(100, 200)

import tzafon
from tzafon import Computer

try:
    client = Computer()
    computer = client.create(kind="browser")
    computer.navigate("https://example.com")
except tzafon.AuthenticationError:
    print("Invalid API key - check TZAFON_API_KEY")
except tzafon.RateLimitError:
    print("Rate limited - too many requests or concurrent sessions")
except tzafon.NotFoundError:
    print("Session not found - may have been terminated")
except tzafon.APIStatusError as e:
    if e.status_code == 402:
        print("Payment required - add credits at tzafon.ai/billing")
    else:
        print(f"API error {e.status_code}: {e.message}")
except tzafon.APIConnectionError:
    print("Connection failed - check network")
except tzafon.APITimeoutError:
    print("Request timed out - retry")
except tzafon.APIError as e:
    print(f"API error: {e}")