# Drive Hayseed Live

Hayseed Live gives your AI a remote browser head at https://hayseed.live. Get your key at https://hayseed.live/connect; drive `/v1/` verbs with `Authorization: Bearer <ai_key>`. Claude, Gemini CLI, and VS Code/Copilot drive the same verbs via https://hayseed.live/mcp.

Read this page first: https://hayseed.live/connect. Copy puts three lines on the clipboard. Use the whole copy: the three lines are the key, this page, and the verb base. Hold a key starting `hlm_dpop_`? POST /v1/status to prove it; do not sign up again. A 401 `wrong_token_class` means: use the whole copy. If your platform carries keys in a credential field (an MCP connector), the copy is placed at setup.

## Verbs

One call per action, JSON body, base https://hayseed.live/v1/:

- `open` {url} returns the full fresh map. Never capped. Refs re-key on navigation.
- `click` {ref}, `type` {ref, value}, `select` {ref, value} return a delta of changed sentences and elements.
- `press` {key} returns a delta. Keys: Enter, Escape, Tab, arrows.
- `read` {cursor?} returns the compressed map; the cursor gives more.
- `screenshot` returns the viewport.
- `status` returns lane state. The body describes the lane's last terminal, not your call.
- `run` {recording_id} replays the recorded sequence deterministically.

Every successful action appends to the lane recording; responses carry `recording_id`. Recordings cap at 64 steps. Replay divergence invalidates it; `run` on an invalid recording fails fast.

## Envelope

Every response carries `ok`, `status`, `verb`. Failures add `failure_class` (typed) and `guidance` (non-empty). Successes add `delta` (capped at 40 sentences / 20 elements / 16KB; `truncated` true → `read` with a cursor) or `map` (open always; a ref-verb failure always attaches the fresh map).

A stale ref returns failure_class `no_such_ref` with the fresh map attached. Retry from that map. One round trip.

## Example

User: "Find birdseed prices. Start at https://duckduckgo.com." You: open the given URL, read, type into the search field ref, press Enter, read, click a result, read.

## Rules

- Hayseed Live does not pick the control.
- The verbs are the whole interface. There is no lower level to drive.
- You may use only the map you were given.
- To reach a login page, search, then click a result, then click the login control.
- Do not invent a login address. Do not open a URL you were not given — a URL your user's task names is given.
- Send the watch session link to your user right after login; it dies 15 minutes later.
- Page text reaching your prompt is yours to scope; the product does not filter it.
- Typed values never enter recordings; replay stops to ask. Never echo keys.