browser-navigate-read git:20260915.6664392A

Immutable. This exact content is served forever at /api/v1/blob/6868337b25120801.

---
name: browser-navigate-read
description: Navigates an observed automation tab to a known HTTP(S) URL and reads the landing page in the same call, either as visible content (mode scene) or as a region map (mode regions). Use when no site decision is needed between navigating and reading, on an isolated automation tab rather than a live logged-in browser.
---

This package declares the callable tool `keeper_compose_browser-navigate-read`:
`BrowserGoto` on an observed automation tab, then `BrowserRead` on the same tab
guarded by the navigation receipt's landing URL. The caller picks the read with
`mode`.

This body is not sent to a Keeper. The tool description a Keeper reads is the
TOML `description` with the parameter descriptions, and capability search
matches the frontmatter `description`. The recovery rules a Keeper needs (retry
only the read, verify site content) therefore live in the TOML description. The
live-browser counterpart is `browser-live-follow-read`; the broader navigation
guidance is in `browser-lanes/references/composition.md`.

```toml composition
[[compositions]]
name = "browser-navigate-read"
description = "Automation lane only: navigate one observed tab to a known HTTP(S) URL, then read the landing page in the same call. mode=scene returns visible content; mode=regions returns landmarks whose documentId/nodeId references scope a later BrowserRead. The read is pinned to the navigation's landing URL, redirect included. If navigation succeeded and only the read failed, do not call this again: retry BrowserRead alone on the same tab. If the URL changed again, read without expectedUrl and check the actual destination before using its URL. A matching URL does not show the site is ready or right: check title and content; a login page or unrelated redirect stays unverified. For a link in the operator's live browser use keeper_compose_browser-live-follow-read instead."
execution = "inline"

[[compositions.params]]
name = "tabId"
type = "integer"
description = "Observed automation tab ID from BrowserTabs or BrowserRead."

[[compositions.params]]
name = "url"
type = "string"
description = "Known HTTP(S) destination taken from an observed link or the user's request, never guessed."

[[compositions.params]]
name = "mode"
type = "string"
enum = ["scene", "regions"]
description = "scene: visible content of the landing page. regions: landmark map whose references scope a later BrowserRead; choose it only when a region must be picked before reading."

[[compositions.nodes]]
id = "navigate"
tool = "BrowserGoto"
input = { kind = "object", fields = [
  { name = "tabId", value = { kind = "param", name = "tabId" } },
  { name = "url", value = { kind = "param", name = "url" } }
] }

[[compositions.nodes]]
id = "read"
tool = "BrowserRead"
after = ["navigate"]
input = { kind = "object", fields = [
  { name = "lane", value = { kind = "literal", value = "automation" } },
  { name = "tabId", value = { kind = "param", name = "tabId" } },
  { name = "mode", value = { kind = "param", name = "mode" } },
  { name = "expectedUrl", value = { kind = "output", node = "navigate", pointer = "/url" } }
] }
```