browser-operations

1# Browser Operations
2 
3Operate the user's Cloud Space browser. Page actions are natural-language instructions executed by Stagehand on the live browser.
4 
5## Tools
6 
7Space lifecycle (call these first):
8 
9- `list_cloud_spaces` / `get_cloud_space`: find the user's spaces and their status. Never guess a `cloudSpaceId`.
10- `start_cloud_space`: start a stopped space, or attach if already running. Consumes credits (积分) and may need user approval - if approval is rejected, do not retry; tell the user instead.
11- `stop_cloud_space`: stop the space and release its session when the user no longer needs the browser.
12- `list_cloud_space_pages`: list tabs with `pageId`, `title`, and `url`.
13 
14Page actions (the space must be running; every call takes `cloudSpaceId`, optional `pageId` defaults to the first tab):
15 
16- `browser_goto`: navigate a tab to a URL.
17- `browser_act`: perform ONE natural-language action (click, type, select, press, scroll).
18- `browser_observe`: list candidate actions on the page - use it to explore an unfamiliar page or plan a multi-step flow before acting.
19- `browser_extract`: pull text and links off the page.
20- `browser_screenshot`: capture the page as an image URL for visual verification.
21 
22## Workflow
23 
241. Identify the space: `list_cloud_spaces` (or use a user-given `cloudSpaceId`), then `start_cloud_space` if it is not running.
25…