browser-live-follow-read git:20260915.6664392A

Immutable. This exact content is served forever at /api/v1/blob/00334b351dac654a.

---
name: browser-live-follow-read
description: Follows an observed same-tab HTTP(S) link in the operator's live browser and reads the destination in the same call, either as visible content (mode scene) or as a region map (mode regions). Use when the link target is already observed and the page needs no click handler.
---

This package declares the callable tool `keeper_compose_browser-live-follow-read`:
`BrowserInteract action=follow_link` on an observed anchor, then `BrowserRead`
on the same live client and tab, guarded by the follow receipt's
`destinationUrl` and `navigationSource`. 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 follow semantics and recovery rules
a Keeper needs therefore live in the TOML description. The automation
counterpart is `browser-navigate-read`; the broader navigation guidance is in
`browser-lanes/references/composition.md`.

```toml composition
[[compositions]]
name = "browser-live-follow-read"
description = "Live lane only: follow one observed same-tab HTTP(S) anchor in the operator's browser, then read the destination in the same call. follow_link goes straight to the anchor's href and does not run page click handlers; if the page needs its handler, use an ordinary BrowserInteract click instead. New-window targets and downloads are refused before navigating. mode=scene returns visible content; mode=regions returns landmarks whose references scope a later read. The read is pinned to the follow receipt's destinationUrl and navigationSource. If the follow succeeded and only the read failed, never call this again: retry BrowserRead alone on the same clientId/tabId with navigationSource. For a same-URL follow keep expectedUrl as well: a reload counts only with a new document identity. To inspect a redirect, drop only expectedUrl and verify the destination before using its URL. A matching URL does not show the site is ready: check title and content."
execution = "inline"

[[compositions.params]]
name = "clientId"
type = "string"
description = "Observed live browser connection UUID from BrowserTabs or BrowserRead."

[[compositions.params]]
name = "tabId"
type = "integer"
description = "Observed live tab that holds the link."

[[compositions.params]]
name = "documentId"
type = "string"
description = "Observed document identity of the page that holds the link."

[[compositions.params]]
name = "nodeId"
type = "string"
description = "Observed same-tab anchor identity from a scene read, never a guessed selector."

[[compositions.params]]
name = "expectedUrl"
type = "string"
description = "URL observed on the tab before following the link."

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

[[compositions.nodes]]
id = "follow"
tool = "BrowserInteract"
input = { kind = "object", fields = [
  { name = "lane", value = { kind = "literal", value = "live" } },
  { name = "action", value = { kind = "literal", value = "follow_link" } },
  { name = "clientId", value = { kind = "param", name = "clientId" } },
  { name = "tabId", value = { kind = "param", name = "tabId" } },
  { name = "documentId", value = { kind = "param", name = "documentId" } },
  { name = "nodeId", value = { kind = "param", name = "nodeId" } },
  { name = "expectedUrl", value = { kind = "param", name = "expectedUrl" } }
] }

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