reticle_snapshot

reticle_snapshot is how an agent gets its bearings. It returns the page as semantic structure, not pixels and not raw HTML, and it comes in three sizes so you can pay for only what you need.

Three modes, three prices

Mode	Returns	Real cost on one page
`status`	Route and title only	25 tokens
`interactive`	Only clickable and focusable elements	65 tokens
`full`	Every element	Depends on the page

`status`. the cheapest possible check

{ "mode": "status" }

{
  "tree": "",
  "nodes": 0,
  "status": { "route": "/", "title": "Reticle · Mission Control" },
  "cost": { "bytes": 98, "tokens": 25 }
}

Ninety-eight bytes to answer “where am I?”. Use it after a navigation instead of re-reading the page.

`interactive`. the default working view

{ "mode": "interactive" }

{
  "tree": "- textbox \"Email\" (ref=e101) [value=\"admin@reticle.dev\"]\n- textbox \"Password\" (ref=e102) [value=\"[REDACTED]\"]\n- button \"Sign in\" (ref=e103)",
  "nodes": 3,
  "truncated": false,
  "status": { "route": "/deployments", "title": "Reticle · Mission Control" },
  "cost": { "bytes": 260, "tokens": 65 }
}

Everything you can act on, with a ref for each, for 65 tokens. Note the password arrives [REDACTED] without anyone configuring it.

Arguments

Argument	What it does
`mode`	`full` · `interactive` · `status`
`scope`	CSS selector or ref, to snapshot one subtree
`diff`	Return only what changed since your last snapshot of the same scope and mode

`diff` is how you keep a long session cheap

{ "mode": "interactive", "diff": true }

After the first snapshot, ask only for the delta. On a page where one row appeared, you get one row rather than the whole list again.

Reach for reticle_query instead when you already know what you’re looking for. Snapshot is for orientation; query is for retrieval, and it’s almost always cheaper.

Refs change across documents

Refs are stable while the element is in the DOM. A full navigation builds a new document, so refs are re-issued. The same “Sign in” button was e5 before a navigation and e103 after. Snapshot after navigating; don’t reuse refs across one.

Tools

Beyond the loop

CLI

Libraries

Grammar

Long form

reticle_snapshot

Three modes, three prices

`status`. the cheapest possible check

`interactive`. the default working view

Arguments

`diff` is how you keep a long session cheap

Refs change across documents

​Three modes, three prices

​status. the cheapest possible check

​interactive. the default working view

​Arguments

​diff is how you keep a long session cheap

​Refs change across documents

Three modes, three prices

`status`. the cheapest possible check

`interactive`. the default working view

Arguments

`diff` is how you keep a long session cheap

Refs change across documents