cua — the sandbox browser

The browser_* tools drive a headless Chromium-family browser that Local Studio launches on this machine — Chromium, Chrome, or Brave, whichever the user picked in the Browser panel. It has a throwaway profile: no saved logins, no cookies, no extensions, no downloads, one page at a time. Only public http(s) URLs and localhost are reachable. The user can watch it live in the Browser panel. When no browser binary is available the runtime degrades to a read-only fetch of the page rather than failing.

This is not the user's browser. If a page needs their session, this browser will show you the logged-out version of it and you will summarize the wrong thing.

When the task needs the user's own browser — their mail, a dashboard, anything behind a sign-in, or a tab they already have open — use the chrome_* tools instead. If those tools are not in your list, the user has not armed Chrome for this session: say so and tell them the composer's browser button turns it on. Never present a signed-out sandbox page as their account.

Tools

• browser_navigate — open an absolute http(s) URL and wait for load.
• browser_get_url — where this browser actually is right now.
• browser_get_text — visible page text. The default way to read a page.
• browser_get_html — rendered HTML, when you need selectors or attributes.
• browser_screenshot — PNG data URI, when visual layout matters.
• browser_click / browser_fill — act on a CSS selector.
• browser_scroll — pixel delta, for lazy-loaded content.
• browser_back / browser_forward / browser_reload — history and refresh.
• browser_history — what this browser has already done and visited this session.