Skip to content

Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠

Qualify the page-1 placeholder rule in the tree documentation

Claude1f6eea12f656
diff --git a/docs/accessibility-tree-and-refs.md b/docs/accessibility-tree-and-refs.md
index 658544128..82874fead 100644
--- a/docs/accessibility-tree-and-refs.md
+++ b/docs/accessibility-tree-and-refs.md
@@ -117,11 +117,17 @@ window reduces model round trips; it does not turn a multi-page tree into proof
of complete coverage. `tree_revision` binds page 2 and later to the snapshot
created by page 1. Page 1 always starts or restarts a fresh snapshot, so the
runtime ignores a stale revision if a model carries one into a page-1 call.
-For the same reason, a `continuationArgs` object for page 1 without a revision,
-on a call that names no revision either, continues nothing and is dropped: the
-call's own top-level fields are the read. Some models fill every field of the
-schema and send such an object with each first read, often with other values,
-and that read used to fail as invalid arguments. A continuation for page 2 or
+For the same reason, a schema-filling `continuationArgs` object for page 1
+without a revision, on a call that names no revision either, continues nothing
+and is dropped: the call's own top-level fields are the read. That applies
+only to a placeholder, that is an object that names no `ref_id` beside a
+top-level read, or an anchored one that disagrees with the call's own fields.
+The restart the tool itself returns after a revision change (page 1, with the
+original `ref_id`, filter and paging scope, and no revision) is kept when it is
+nested alone or beside top-level fields that agree with it, and is the read.
+Some models fill every field of the schema and send a placeholder with each
+first read, often with other values, and that read used to fail as invalid
+arguments. A continuation for page 2 or
later must still match the call's top-level fields exactly.
Pagination also cannot prove that an application rendered hidden conversation