Sessions start in observation-only mode. Actions require explicit escalation.

Args:
    name: Unique name for the session (e.g., "main", "test-session")
    headless: If True, run browser without visible window
    viewport_width: Browser viewport width in pixels (default: 1280)
    viewport_height: Browser viewport height in pixels (default: 720)

Returns:
    Confirmation message with session name and status

Sessions start in observation-only mode. Actions require explicit escalation.

Args:
    name: Unique name for the session (e.g., "main", "test-session")
    cdp_url: CDP websocket URL (e.g., ws://127.0.0.1:9222/devtools/browser/...)

Returns:
    Confirmation message with session name and status

Returns:
    List of sessions showing name, status (active/escalated), and current URL

Args:
    name: Name of the session to destroy

Returns:
    Confirmation message

WARNING: This enables side effects. Actions will be logged.

Args:
    name: Name of the session to escalate
    reason: Justification for why actions are needed

Returns:
    Warning message and confirmation

Navigation is considered an inspect operation because it sets up
what you want to observe.

Args:
    session: Name of the browser session
    url: URL to navigate to (https:// added if no protocol specified)

Returns:
    The page title and final URL after navigation

Args:
    session: Name of the browser session
    full_page: If True, capture the entire scrollable page

Returns:
    Base64-encoded PNG screenshot with data URI prefix

Args:
    session: Name of the browser session
    selector: Optional CSS selector to get specific element's HTML

Returns:
    HTML content (truncated if over 100KB)

Args:
    session: Name of the browser session
    selector: Optional CSS selector to get specific element's text

Returns:
    Text content of the page or element

Args:
    session: Name of the browser session

Returns:
    JSON array of console entries with level, message, and timestamp

Args:
    session: Name of the browser session

Returns:
    JSON array of network entries with method, url, status, and timestamp

The event log is append-only and records all tool calls made to this session.

Args:
    session: Name of the browser session

Returns:
    JSON array of all events in chronological order

REQUIRES: Session must be escalated first via browser_session_escalate.

Args:
    session: Name of the browser session
    selector: CSS selector for the element to click
    reason: Justification for why this click is necessary

Returns:
    Observed changes after the click (NOT success/failure)

REQUIRES: Session must be escalated first via browser_session_escalate.

Args:
    session: Name of the browser session
    selector: CSS selector for the input element
    text: Text to type
    reason: Justification for why this input is necessary
    clear_first: If True, clear the input before typing

Returns:
    Observed changes after typing (NOT success/failure)

REQUIRES: Session must be escalated first via browser_session_escalate.

Args:
    session: Name of the browser session
    script: JavaScript code to execute
    reason: Justification for why this script is necessary

Returns:
    Observed changes after execution (NOT success/failure)