effect-browser 0.2.0-beta.6 → 0.2.0-beta.8

package/dist/Testing.mjs

@@ -1,13 +1,16 @@
 import { BrowserError, InitializationError, Reasons } from "./Errors.mjs";
-import { BrowserPolicy, ControlFacts, FrameInfo, Identifier, ObservedControl, PageExecutionState, PageInfo, PageSuspension, SafeFilename, TargetUrl, ViewportEvidence, ViewportRect } from "./BrowserData.mjs";
-import { a as cleanupStep, c as checked, l as fromNativeAttempt, n as make, s as reported, u as issueBinding } from "./BrowserRuntime-DImn_Oe_.mjs";
+import { BrowserPolicy, ControlFacts, DocumentScroll, FrameInfo, Identifier, ObservedControl, ObservedElement, PageExecutionState, PageInfo, PageSuspension, SafeFilename, TargetUrl, ViewportEvidence, ViewportRect } from "./BrowserData.mjs";
+import { a as stableIdentityOf, c as issueBinding, i as identityOf, n as make, o as MaximumGroupNodes, s as fromNativeAttempt } from "./BrowserRuntime-HJ1yYlFS.mjs";
+import { l as reported, s as cleanupStep, t as checked } from "./PublicSession-Bs61Eal8.mjs";
+import { n as pngGeometry } from "./Images-CaaPNeed.mjs";
 import { Crypto, Effect, Layer, Option, PlatformError, Redacted, Schema } from "effect";
 //#region src/internal/testing/Crypto.ts
 /**
 * A `Crypto` whose bytes count up from one, so every id and handoff token a scripted browser draws
-* is predictable. It is not random and computes no digest.
+* is predictable. A namespace occupies UUID bytes untouched by its version/variant bits.
+* It is not random and computes no digest.
 */
-const makeSequentialCrypto = () => {
+const makeSequentialCrypto = (namespace = 0) => {
 	let draws = 0;
 	return Crypto.make({
 		randomBytes: (size) => {
@@ -17,6 +20,12 @@ const makeSequentialCrypto = () => {
 				bytes[index] = rest % 256;
 				rest = Math.floor(rest / 256);
 			}
+			let scope = BigInt(namespace);
+			for (let index = 0; index < size - 8 && scope > 0n; index++) {
+				if (index === 6) continue;
+				bytes[index] = Number(scope % 256n);
+				scope /= 256n;
+			}
 			return bytes;
 		},
 		digest: () => Effect.fail(PlatformError.badArgument({
@@ -97,6 +106,11 @@ const DocumentScript = Schema.Struct({
 	url: TargetUrl,
 	title: Schema.optionalKey(Schema.String.check(Schema.isMaxLength(512))),
 	text: Schema.String.check(Schema.isMaxLength(131072)),
+	/**
+	* Authored root-document geometry, not inferred layout. Readings carry this exact snapshot;
+	* use document.update to supply the next state after a scripted scroll or resize.
+	*/
+	documentScroll: Schema.optionalKey(DocumentScroll),
 	controls: Schema.optionalKey(Schema.Array(ControlScript).check(Schema.isMaxLength(64), uniqueBy((control) => control.id, "unique control ids")))
 });
 /**
@@ -155,6 +169,9 @@ const ScriptableOperation = Schema.Literals([
 	"read-text",
 	"screenshot",
 	"wait",
+	"resolve",
+	"run",
+	"settled",
 	"click",
 	"fill",
 	"fill-form",
@@ -170,9 +187,9 @@ const ScriptableOperation = Schema.Literals([
 	"press",
 	"type",
 	"list-pages",
+	"describe-page",
 	"list-frames",
 	"select-page",
-	"select-frame",
 	"new-page",
 	"close-page",
 	"resize",
@@ -300,6 +317,7 @@ const makeScriptedBrowser = (script, timers) => {
 		url: document.url,
 		title: document.title ?? "",
 		text: document.text,
+		...document.documentScroll === void 0 ? {} : { documentScroll: { ...document.documentScroll } },
 		controls: (document.controls ?? []).map(controlState)
 	});
 	const documentFor = (url) => {
@@ -320,6 +338,11 @@ const makeScriptedBrowser = (script, timers) => {
 			registeredEpoch: registered ? 0 : -1,
 			values: /* @__PURE__ */ new Map(),
 			files: /* @__PURE__ */ new Map(),
+			scroll: {
+				x: 0,
+				y: 0
+			},
+			mutations: 0,
 			focused: void 0,
 			closed: false,
 			held: void 0,
@@ -328,6 +351,7 @@ const makeScriptedBrowser = (script, timers) => {
 			capture: void 0
 		};
 		pages.set(page.pageId, page);
+		for (const connection of live) connection.opened(page.pageId);
 		return page;
 	};
 	const openPages = () => [...pages.values()].filter((page) => !page.closed);
@@ -338,12 +362,17 @@ const makeScriptedBrowser = (script, timers) => {
 	/** The page shows a new document: nodes go stale, values reset, captures learn of it. */
 	const commit = (page, document) => {
 		page.document = document;
+		page.cachedTitle = void 0;
 		page.epoch++;
 		page.values.clear();
 		page.files.clear();
 		page.focused = void 0;
+		page.scroll.x = 0;
+		page.scroll.y = 0;
+		page.mutations++;
 		page.navigation = void 0;
 		for (const connection of live) connection.retire(page.pageId);
+		for (const connection of live) connection.navigated(page.pageId, false);
 		if (page.capture !== void 0) {
 			const { start } = page.capture;
 			if (start.document === void 0) start.invalidate("target-changed");
@@ -354,6 +383,8 @@ const makeScriptedBrowser = (script, timers) => {
 	};
 	/** In-document change: identity survives by control id, so retained nodes and waits carry on. */
 	const update = (page, document) => {
+		const previousUrl = page.document.url;
+		const before = JSON.stringify(page.document);
 		const previous = new Map(page.document.controls.map((control) => [control.script.id, control]));
 		const controls = (document.controls ?? []).map((script) => {
 			const existing = previous.get(script.id);
@@ -367,9 +398,15 @@ const makeScriptedBrowser = (script, timers) => {
 			url: document.url,
 			title: document.title ?? "",
 			text: document.text,
+			...document.documentScroll === void 0 ? {} : { documentScroll: { ...document.documentScroll } },
 			controls
 		};
+		if (JSON.stringify(page.document) !== before) page.mutations++;
 		if (page.focused !== void 0 && !previous.has(page.focused)) page.focused = void 0;
+		if (previousUrl !== document.url) {
+			for (const connection of live) connection.navigated(page.pageId, true);
+			page.capture?.start.document?.(document.url, true);
+		}
 		notify(page);
 	};
 	const take = (operation) => {
@@ -392,11 +429,13 @@ const makeScriptedBrowser = (script, timers) => {
 			throw new Error("The scripted browser refused this connection");
 		}
 		const bindings = options.bindings ?? [];
-		let viewport = { ...options.viewport };
+		const viewport = { ...options.viewport };
 		const positions = /* @__PURE__ */ new Map();
 		let pointer = null;
 		let selectedId;
-		let snapshot;
+		const snapshots = /* @__PURE__ */ new Map();
+		const privateSnapshots = /* @__PURE__ */ new Set();
+		const resolvedElements = /* @__PURE__ */ new WeakMap();
 		let disconnected = false;
 		let index = -1;
 		const place = (pageId, point) => {
@@ -410,8 +449,16 @@ const makeScriptedBrowser = (script, timers) => {
 		const dispatchObservers = /* @__PURE__ */ new WeakMap();
 		const receipt = (pageId) => ({ position: positions.get(pageId) ?? null });
 		const select = (pageId) => {
+			const previous = selectedId;
 			selectedId = pageId;
 			lastSelected = pageId;
+			for (const id of previous === pageId ? [pageId] : [previous, pageId]) {
+				const page = id === void 0 ? void 0 : pages.get(id);
+				if (page !== void 0 && !page.closed) events.pageLifecycle?.({
+					_tag: "Display",
+					page: cachedPage(page)
+				});
+			}
 		};
 		const selectedPage = (operation = "target") => {
 			const page = selectedId === void 0 ? void 0 : pages.get(selectedId);
@@ -419,7 +466,6 @@ const makeScriptedBrowser = (script, timers) => {
 			return page;
 		};
 		const current = (target, operation) => {
-			if (target === void 0) return selectedPage(operation);
 			if (disconnected) throw fail(operation, Reasons.Closed.make({}));
 			const page = pages.get(target.pageId);
 			if (page === void 0 || page.closed || page.frameId !== target.frameId) throw fail(operation, Reasons.Stale.make({}));
@@ -431,26 +477,91 @@ const makeScriptedBrowser = (script, timers) => {
 			if (page.closed || page.targetId !== info.targetId) throw fail(operation, Reasons.Stale.make({}));
 			return page;
 		};
-		const info = (page) => PageInfo.make({
+		const cachedPage = (page) => Object.freeze({
 			pageId: page.pageId,
+			frameId: page.frameId,
 			targetId: page.targetId,
-			url: page.document.url,
-			title: page.document.title,
-			selected: page.pageId === selectedId
+			documentEpoch: page.epoch,
+			url: page.document.url.length <= 8192 ? page.document.url : null,
+			urlQualification: page.document.url.length <= 8192 ? "NativeCached" : "Omitted",
+			title: page.cachedTitle ?? null,
+			titleQualification: page.cachedTitle === void 0 ? "Unread" : page.cachedTitle === null ? "Omitted" : "ObservedCached",
+			selected: page.pageId === selectedId,
+			displayState: options.pageControl === true ? page.held === void 0 ? "running" : "suspended" : "unknown"
 		});
+		const info = (page) => {
+			page.cachedTitle = page.document.title.length <= 512 ? page.document.title : null;
+			const value = PageInfo.make({
+				pageId: page.pageId,
+				targetId: page.targetId,
+				url: page.document.url,
+				title: page.document.title,
+				selected: page.pageId === selectedId
+			});
+			events.pageLifecycle?.({
+				_tag: "Metadata",
+				page: cachedPage(page)
+			});
+			return value;
+		};
+		const picture = (page, ticket) => {
+			const target = {
+				pageId: page.pageId,
+				frameId: page.frameId
+			};
+			const geometry = pngGeometry(PNG);
+			ticket.picture?.({
+				phase: "Requested",
+				target,
+				documentEpoch: page.epoch,
+				geometry
+			});
+			const bytes = new Uint8Array(PNG);
+			ticket.picture?.({
+				phase: "Returned",
+				target,
+				documentEpoch: page.epoch,
+				geometry,
+				byteLength: bytes.length
+			});
+			return bytes;
+		};
 		const frameInfo = (page) => FrameInfo.make({
 			frameId: page.frameId,
 			parentFrameId: null,
 			url: page.document.url,
 			name: ""
 		});
-		const invalidateSnapshot = (scope = "all") => {
-			if (snapshot !== void 0 && scope !== "none" && (scope === "all" || scope.pageId === snapshot.pageId)) snapshot.validity = "invalid";
+		const invalidateSnapshot = (scope = "all", origin) => {
+			for (const snapshot of [...snapshots.values(), ...privateSnapshots]) if (scope !== "none" && (scope === "all" || scope.pageId === snapshot.pageId && (scope.frameId === void 0 || scope.frameId === snapshot.frameId))) {
+				if (privateSnapshots.has(snapshot) && origin !== void 0 && snapshot.origin === origin) continue;
+				snapshot.validity = "invalid";
+			}
+		};
+		/** The page closes as a browser closes it: every connection learns, and nothing on it lasts. */
+		const close = (target) => {
+			target.closed = true;
+			target.navigation?.drop();
+			target.capture?.start.invalidate("target-changed");
+			target.capture = void 0;
+			notify(target);
+			if (selectedId === target.pageId) select(void 0);
+			snapshots.delete(target.frameId);
+			events.pageClosed?.(target.pageId, cachedPage(target));
+			events.invalidate("target-changed", { pageId: target.pageId });
+			for (const other of live) {
+				if (other === connection) continue;
+				other.closed(target.pageId);
+				other.announce(target.pageId);
+			}
 		};
 		/** This connection ends: what it held on the browser's pages ends with it. */
 		const dropConnection = (announce, ended = "dropped") => {
 			if (disconnected) return;
 			disconnected = true;
+			invalidateSnapshot();
+			snapshots.clear();
+			privateSnapshots.clear();
 			connections[index] = ended;
 			live.delete(connection);
 			for (const page of pages.values()) {
@@ -460,6 +571,7 @@ const makeScriptedBrowser = (script, timers) => {
 				notify(page);
 			}
 			if (announce) events.disconnected();
+			events.retired?.();
 		};
 		const dispatch = (ticket, record) => {
 			if (record.dispatched) return;
@@ -532,13 +644,14 @@ const makeScriptedBrowser = (script, timers) => {
 				if (ticket !== void 0) await applyArmed(operation, ticket, record);
 				const value = await body(record);
 				record.settled = "completed";
+				if (ticket !== void 0 && isTicket(ticket)) ticket.acknowledge?.();
 				return value;
 			} catch (error) {
 				record.settled = "failed";
 				throw error;
 			}
 		};
-		const meta = (target) => target === void 0 ? {} : typeof target === "string" ? { selector: target } : { elementId: target.elementId };
+		const meta = (target) => target === void 0 ? {} : typeof target === "string" ? { selector: target } : { elementId: "_tag" in target ? resolvedElements.get(target)?.node.script.id : target.elementId };
 		const facts = (control) => {
 			const { script: value } = control;
 			const extra = value.facts ?? {};
@@ -553,7 +666,7 @@ const makeScriptedBrowser = (script, timers) => {
 				editable: extra.editable ?? isEditable(value),
 				...value.inputType === void 0 ? {} : { inputType: value.inputType },
 				...extra.autocomplete === void 0 ? {} : { autocomplete: extra.autocomplete },
-				...value.destination === void 0 ? {} : { destination: value.destination },
+				...value.destination === void 0 || value.destination.length > 2048 ? {} : { destination: value.destination },
 				...extra.formMethod === void 0 ? {} : { formMethod: extra.formMethod },
 				box: ViewportRect.make(extra.box ?? {
 					x: 0,
@@ -588,33 +701,62 @@ const makeScriptedBrowser = (script, timers) => {
 			return control;
 		};
 		/** A retained node is only as current as the observation that produced it. */
-		const retained = (target, ticket, operation, allowSuspended = false, attached = true) => {
+		const retained = (target, ticket, operation, allowSuspended = false, attached = true, browserTarget) => {
 			ticket.check();
 			const stale = () => fail(operation, Reasons.Stale.make({}));
-			const current = snapshot;
-			if (current === void 0 || current.id !== target.observationId) throw stale();
-			const node = current.nodes.get(target.elementId);
+			const page = current(browserTarget, operation);
+			const snapshot = snapshots.get(page.frameId);
+			if (snapshot === void 0 || snapshot.pageId !== page.pageId || snapshot.id !== target.observationId) throw stale();
+			const node = snapshot.nodes.get(target.elementId);
 			if (node === void 0) throw stale();
-			if (current.validity === "invalid" || current.generation !== ticket.generation) throw stale();
-			const page = pages.get(current.pageId);
-			if (page === void 0 || page.closed || page.epoch !== current.epoch) throw stale();
-			if (selectedId !== current.pageId) throw stale();
-			if (current.validity === "suspended" && !allowSuspended && !current.revalidated.has(target.elementId)) throw stale();
+			if (snapshot.validity === "invalid" || snapshot.generation !== ticket.generation) throw stale();
+			if (page.epoch !== snapshot.epoch) throw stale();
+			if (snapshot.validity === "suspended" && !allowSuspended && !snapshot.revalidated.has(target.elementId)) throw stale();
 			if (attached && !page.document.controls.includes(node)) throw stale();
 			return {
 				node,
 				page,
-				snapshot: current
+				snapshot
 			};
 		};
+		const privateRetained = (target, ticket, operation, browserTarget, attached = true) => {
+			ticket.check();
+			const record = resolvedElements.get(target);
+			const page = current(browserTarget, operation);
+			if (record === void 0 || record.snapshot.validity !== "valid" || !privateSnapshots.has(record.snapshot) || record.snapshot.generation !== ticket.generation || record.snapshot.pageId !== page.pageId || record.snapshot.frameId !== page.frameId || record.snapshot.epoch !== page.epoch || attached && !page.document.controls.includes(record.node) || record.parent !== void 0 && (!page.document.controls.includes(record.parent) || record.node.script.selectElementId !== record.parent.script.id)) throw fail(operation, Reasons.Stale.make({}));
+			return {
+				...record,
+				page
+			};
+		};
+		const retainedElement = (target, ticket, operation, allowSuspended = false, attached = true, browserTarget) => "_tag" in target ? privateRetained(target, ticket, operation, browserTarget, attached) : retained(target, ticket, operation, allowSuspended, attached, browserTarget);
+		const sample = (node, fresh, scope, descriptor) => ({
+			facts: fresh,
+			scope,
+			frameComplete: true,
+			completeness: {
+				label: "complete",
+				inputType: node.script.inputType === void 0 ? "absent" : "complete",
+				autocomplete: node.script.facts?.autocomplete === void 0 ? "absent" : "complete",
+				destination: node.script.destination === void 0 ? "absent" : node.script.destination.length > 2048 ? "omitted" : "complete",
+				formMethod: node.script.facts?.formMethod === void 0 ? "absent" : "complete"
+			},
+			...descriptor?.ordinal === void 0 ? {} : { ordinal: descriptor.ordinal }
+		});
 		const resolve = (target, ticket, operation, policy, browserTarget, allowSuspended = false, enablement = false) => {
 			let node;
 			let page;
 			if (typeof target === "string") {
 				page = current(browserTarget, operation);
 				node = bySelector(page, target, operation);
-			} else ({node, page} = retained(target, ticket, operation, allowSuspended));
+			} else ({node, page} = retainedElement(target, ticket, operation, allowSuspended, true, browserTarget));
 			const fresh = facts(node);
+			const captured = ControlFacts.make({
+				...fresh,
+				box: ViewportRect.make({ ...fresh.box })
+			});
+			const privateTarget = typeof target !== "string" && "_tag" in target ? resolvedElements.get(target) : void 0;
+			if (privateTarget !== void 0 && (enablement ? stableIdentityOf(fresh) !== privateTarget.stable : identityOf(fresh) !== privateTarget.identity)) throw fail(operation, Reasons.Stale.make({}));
 			if (enablement && node.script.disabled === true) throw fail(operation, Reasons.Disabled.make({}));
 			if (policy !== void 0) {
 				let admitted = false;
@@ -626,17 +768,189 @@ const makeScriptedBrowser = (script, timers) => {
 				if (!admitted) throw fail(operation, Reasons.Denied.make({}));
 			}
 			ticket.check();
+			if (isTicket(ticket)) {
+				const scope = privateTarget?.scope ?? (typeof target === "string" ? "document" : snapshots.get(page.frameId)?.scope ?? "document");
+				ticket.captureTarget?.(target, sample(node, captured, scope, privateTarget?.descriptor));
+			}
 			return {
 				node,
 				page,
 				facts: fresh
 			};
 		};
+		/** The complete scripted document, never a previously clipped observation, proves cardinality. */
+		const descriptorNode = (descriptor, page, operation, contextual, parent) => {
+			if (descriptor.frame !== void 0) throw fail(operation, Reasons.Unsupported.make({}));
+			const matches = page.document.controls.filter((node) => {
+				const fresh = facts(node);
+				const identity = descriptor.identity;
+				return fresh.kind === descriptor.kind && fresh.label === descriptor.label && (parent === void 0 || parent.script.kind === "select" && node.script.selectElementId === parent.script.id) && (descriptor.destination === void 0 || fresh.destination === descriptor.destination) && (identity?.inputType === void 0 || fresh.inputType === identity.inputType) && (identity?.autocomplete === void 0 || fresh.autocomplete === identity.autocomplete) && (identity?.formMethod === void 0 || fresh.formMethod === identity.formMethod);
+			});
+			const viewportMatches = matches.filter((node) => facts(node).hitTest === "self");
+			if (descriptor.matchScope === "viewport") {
+				if (matches.some((node) => {
+					const fresh = facts(node);
+					return fresh.hitTest === "uncertain" && fresh.placement !== "outside";
+				})) throw fail(operation, Reasons.Incomplete.make({}));
+				if (!contextual && matches.length > 1) throw fail(operation, Reasons.Ambiguous.make({ count: matches.length }));
+			}
+			const candidates = descriptor.matchScope === "viewport" ? viewportMatches : matches;
+			if (candidates.length === 0) throw fail(operation, Reasons.Missing.make({}));
+			if (descriptor.ordinal !== void 0 && descriptor.ordinal.of !== candidates.length) throw fail(operation, Reasons.Incomplete.make({}));
+			if (descriptor.ordinal === void 0 && candidates.length !== 1) throw fail(operation, Reasons.Ambiguous.make({ count: candidates.length }));
+			const picked = candidates[descriptor.ordinal?.index ?? 0];
+			if (picked === void 0) throw fail(operation, Reasons.Incomplete.make({}));
+			return picked;
+		};
+		const expectations = (conditions, ticket, browserTarget) => {
+			ticket.check();
+			const page = current(browserTarget, "run");
+			const size = page.viewport ?? viewport;
+			if (conditions.length > 16) throw fail("run", Reasons.Limit.make({
+				dimension: "controls",
+				maximum: 16,
+				observed: conditions.length
+			}));
+			for (const condition of conditions) {
+				ticket.check();
+				let matches;
+				switch (condition._tag) {
+					case "Origin":
+						matches = originOf(page.document.url) === condition.value;
+						break;
+					case "Path":
+						matches = new URL(page.document.url).pathname === condition.value;
+						break;
+					case "Viewport":
+						matches = size.width === condition.width && size.height === condition.height;
+						break;
+					case "Scroll":
+						matches = page.scroll.x === condition.x && page.scroll.y === condition.y;
+						break;
+					case "Text":
+						if (condition.scope === "viewport") throw fail("run", Reasons.Unsupported.make({}));
+						matches = condition.match === "equals" ? page.document.text === condition.value : page.document.text.includes(condition.value);
+						break;
+					case "Geometry": {
+						const node = descriptorNode(condition.target, page, "run", false);
+						const box = facts(node).box;
+						matches = box.x === condition.box.x && box.y === condition.box.y && box.width === condition.box.width && box.height === condition.box.height;
+						break;
+					}
+				}
+				if (!matches) throw fail("run", Reasons.Denied.make({}));
+			}
+			ticket.check();
+		};
+		const resolveGroup = (requests, ticket, browserTarget, guard) => {
+			ticket.check();
+			const page = current(browserTarget, "resolve");
+			if (requests.length === 0 || requests.length > 2081) throw fail("resolve", Reasons.Limit.make({
+				dimension: "controls",
+				maximum: MaximumGroupNodes,
+				observed: requests.length
+			}));
+			if (guard._tag === "ViewportContext") expectations(guard.before, ticket, browserTarget);
+			const retainedSnapshots = [...snapshots.values(), ...privateSnapshots];
+			const perPage = retainedSnapshots.filter((snapshot) => snapshot.pageId === page.pageId).length;
+			const pageMaximum = options.observationLimits?.maxSnapshotsPerPage ?? 16;
+			const sessionMaximum = options.observationLimits?.maxSnapshotsPerSession ?? 64;
+			if (perPage >= pageMaximum || retainedSnapshots.length >= sessionMaximum) throw fail("resolve", Reasons.Limit.make({
+				dimension: "observation-snapshots",
+				maximum: perPage >= pageMaximum ? pageMaximum : sessionMaximum,
+				observed: perPage >= pageMaximum ? perPage + 1 : retainedSnapshots.length + 1
+			}));
+			const snapshot = {
+				id: `observation-${++observationSerial}`,
+				pageId: page.pageId,
+				frameId: page.frameId,
+				epoch: page.epoch,
+				generation: ticket.generation,
+				scope: "document",
+				validity: "valid",
+				nodes: /* @__PURE__ */ new Map(),
+				identities: /* @__PURE__ */ new Map(),
+				revalidated: /* @__PURE__ */ new Set()
+			};
+			const elements = [];
+			const records = [];
+			const samples = [];
+			privateSnapshots.add(snapshot);
+			const release = async () => {
+				snapshot.validity = "invalid";
+				privateSnapshots.delete(snapshot);
+			};
+			try {
+				for (const [index, request] of requests.entries()) {
+					ticket.check();
+					if (request.parent !== void 0 && (!Number.isInteger(request.parent) || request.parent < 0 || request.parent >= index)) throw fail("resolve", Reasons.Malformed.make({}));
+					const parent = request.parent === void 0 ? void 0 : records[request.parent]?.node;
+					let node;
+					let scope;
+					let identity;
+					let stable;
+					if (request.target._tag === "Ref") {
+						const source = retained(request.target.reference, ticket, "resolve", false, true, browserTarget);
+						const captured = source.snapshot.identities.get(request.target.reference.elementId);
+						if (captured === void 0) throw fail("resolve", Reasons.Incomplete.make({}));
+						node = source.node;
+						scope = source.snapshot.scope;
+						({identity, stable} = captured);
+					} else {
+						node = descriptorNode(request.target.descriptor, page, "resolve", guard._tag === "ViewportContext", parent);
+						scope = request.target.descriptor.matchScope;
+						const fresh = facts(node);
+						identity = identityOf(fresh);
+						stable = stableIdentityOf(fresh);
+					}
+					if (parent !== void 0 && (parent.script.kind !== "select" || node.script.selectElementId !== parent.script.id)) throw fail("resolve", Reasons.Stale.make({}));
+					const element = Object.freeze({
+						_tag: "ResolvedElement",
+						target: Object.freeze({
+							pageId: page.pageId,
+							frameId: page.frameId
+						})
+					});
+					const record = {
+						node,
+						snapshot,
+						scope,
+						identity,
+						stable,
+						...parent === void 0 ? {} : { parent },
+						...request.target._tag === "Descriptor" ? { descriptor: request.target.descriptor } : {}
+					};
+					snapshot.nodes.set(node.script.id, node);
+					snapshot.identities.set(node.script.id, {
+						identity,
+						stable
+					});
+					resolvedElements.set(element, record);
+					elements.push(element);
+					records.push(record);
+					samples.push(request.target._tag === "Descriptor" || request.captureInitial === true && ticket.captureTarget !== void 0 ? sample(node, facts(node), scope, record.descriptor) : void 0);
+				}
+				ticket.check();
+				return {
+					elements: Object.freeze(elements),
+					samples: Object.freeze(samples),
+					activate: (next) => {
+						for (const element of elements) privateRetained(element, next, "run", browserTarget);
+						snapshot.origin = next.signal;
+					},
+					release
+				};
+			} catch (error) {
+				snapshot.validity = "invalid";
+				privateSnapshots.delete(snapshot);
+				throw error;
+			}
+		};
 		const requireRunning = (page, operation) => {
 			if (page.held !== void 0) throw fail(operation, Reasons.Busy.make({}));
 		};
 		const heldObservation = (pageId) => {
-			if (snapshot?.pageId === pageId && snapshot.validity === "valid") {
+			for (const snapshot of snapshots.values()) if (snapshot.pageId === pageId && snapshot.validity === "valid") {
 				snapshot.validity = "suspended";
 				snapshot.revalidated.clear();
 			}
@@ -661,13 +975,29 @@ const makeScriptedBrowser = (script, timers) => {
 			if (focused !== void 0 && isEditable(focused.script)) page.values.set(focused.script.id, (page.values.get(focused.script.id) ?? "") + text);
 		};
 		/** Issued options of one select, refused exactly where native selection refuses them. */
-		const chosen = (node, ids, operation) => {
-			const current = snapshot;
-			if (current === void 0) throw fail(operation, Reasons.Stale.make({}));
+		const chosen = (page, node, ids, ticket, operation, enablement = false) => {
 			if (!isSelectable(node.script.kind)) throw fail(operation, Reasons.Unsupported.make({}));
 			const options = ids.map((id) => {
-				const option = current.nodes.get(id);
-				if (option === void 0 || option.script.selectElementId !== node.script.id) throw fail(operation, Reasons.Stale.make({}));
+				let option;
+				if (typeof id === "string") {
+					const snapshot = snapshots.get(page.frameId);
+					const kept = snapshot?.nodes.get(id);
+					if (snapshot === void 0 || kept === void 0 || snapshot.nodes.get(node.script.id) !== node) throw fail(operation, Reasons.Stale.make({}));
+					option = kept;
+				} else {
+					const kept = privateRetained(id, ticket, operation, {
+						pageId: page.pageId,
+						frameId: page.frameId
+					});
+					const fresh = facts(kept.node);
+					if (kept.parent !== node || (enablement ? stableIdentityOf(fresh) !== kept.stable : identityOf(fresh) !== kept.identity)) throw fail(operation, Reasons.Stale.make({}));
+					option = kept.node;
+				}
+				if (option.script.selectElementId !== node.script.id || !page.document.controls.includes(option)) throw fail(operation, Reasons.Stale.make({}));
+				ticket.captureTarget?.(typeof id === "string" ? ObservedElement.make({
+					observationId: snapshots.get(page.frameId)?.id ?? "",
+					elementId: id
+				}) : id, sample(option, facts(option), typeof id === "string" ? snapshots.get(page.frameId)?.scope ?? "document" : resolvedElements.get(id)?.scope ?? "document", typeof id === "string" ? void 0 : resolvedElements.get(id)?.descriptor));
 				return option;
 			});
 			if (node.script.disabled === true || options.some((option) => option.script.disabled === true)) throw fail(operation, Reasons.Disabled.make({}));
@@ -695,7 +1025,7 @@ const makeScriptedBrowser = (script, timers) => {
 			let act;
 			let input;
 			if (field.options !== void 0) {
-				const options = chosen(node, field.options, "fill-form");
+				const options = chosen(page, node, field.options, ticket, "fill-form", true);
 				act = () => choose(page, node, options);
 			} else if (field.checked !== void 0) {
 				if (node.checked === void 0) throw fail("fill-form", Reasons.Unsupported.make({}));
@@ -801,6 +1131,98 @@ const makeScriptedBrowser = (script, timers) => {
 			page.watchers.add(check);
 			check();
 		});
+		/** Quiet in the finite scripted source; the actual Chromium observer owns native root metrics. */
+		const waitSettled = (options, ticket, page, record) => new Promise((resolve, reject) => {
+			const epoch = page.epoch;
+			const started = ticket.deadline - ticket.remainingMillis();
+			const elapsed = () => Math.max(0, ticket.deadline - ticket.remainingMillis() - started);
+			const geometry = () => JSON.stringify(page.document.controls.map((node) => facts(node).box));
+			const size = () => page.viewport ?? viewport;
+			let previousGeometry = geometry();
+			let previousViewport = JSON.stringify(size());
+			let previousScroll = JSON.stringify(page.scroll);
+			let previousMutations = page.mutations;
+			let lastChanged = 0;
+			let samples = 0;
+			let mutations = 0;
+			let scrollChanges = 0;
+			let geometryChanges = 0;
+			let viewportChanges = 0;
+			let finished = false;
+			let timer;
+			const cleanup = () => {
+				timer?.cancel();
+				timer = void 0;
+				page.watchers.delete(check);
+				ticket.signal.removeEventListener("abort", onAbort);
+			};
+			const failWait = (error) => {
+				if (finished) return;
+				finished = true;
+				cleanup();
+				record.settled = "failed";
+				reject(error);
+			};
+			const onAbort = () => failWait(aborted(ticket, "settled"));
+			const check = () => {
+				if (finished) return;
+				try {
+					ticket.check();
+					if (disconnected) throw fail("settled", Reasons.Disconnected.make({}));
+					if (page.closed || page.epoch !== epoch) throw fail("settled", Reasons.Stale.make({}));
+					const now = elapsed();
+					const nextGeometry = geometry();
+					const nextViewport = JSON.stringify(size());
+					const nextScroll = JSON.stringify(page.scroll);
+					const changed = page.mutations !== previousMutations || nextGeometry !== previousGeometry || nextViewport !== previousViewport || nextScroll !== previousScroll;
+					samples = Math.min(Number.MAX_SAFE_INTEGER, samples + 1);
+					mutations = Math.min(Number.MAX_SAFE_INTEGER, mutations + Math.max(0, page.mutations - previousMutations));
+					if (nextGeometry !== previousGeometry) geometryChanges++;
+					if (nextViewport !== previousViewport) viewportChanges++;
+					if (nextScroll !== previousScroll) scrollChanges++;
+					previousMutations = page.mutations;
+					previousGeometry = nextGeometry;
+					previousViewport = nextViewport;
+					previousScroll = nextScroll;
+					if (changed) lastChanged = now;
+					if (now >= options.withinMillis) throw fail("settled", Reasons.Timeout.make({}));
+					if (now - lastChanged >= options.quietMillis) {
+						finished = true;
+						cleanup();
+						resolve({
+							quietMillis: options.quietMillis,
+							withinMillis: options.withinMillis,
+							observedMillis: now,
+							signals: [
+								"dom-mutation",
+								"scroll",
+								"root-geometry",
+								"viewport"
+							],
+							samples,
+							mutations,
+							scrollChanges,
+							geometryChanges,
+							viewportChanges,
+							visibility: "visible"
+						});
+						return;
+					}
+					timer?.cancel();
+					timer = timers.sleep(Math.min(25, options.quietMillis - (now - lastChanged), options.withinMillis - now, ticket.remainingMillis()));
+					timer.done.then(check, () => {});
+				} catch (error) {
+					failWait(error);
+				}
+			};
+			if (ticket.signal.aborted) {
+				onAbort();
+				return;
+			}
+			ticket.signal.addEventListener("abort", onAbort, { once: true });
+			page.watchers.add(check);
+			check();
+		});
 		const invokeBinding = async (name, input, origin) => {
 			const binding = bindings.find((candidate) => candidate.name === name);
 			if (binding === void 0) return { ok: false };
@@ -820,6 +1242,7 @@ const makeScriptedBrowser = (script, timers) => {
 			};
 			try {
 				const reply = await binding.invoke({
+					origin: documentOrigin,
 					read: async (signal) => {
 						await check(signal);
 						return text;
@@ -857,6 +1280,7 @@ const makeScriptedBrowser = (script, timers) => {
 			select(previous !== void 0 && !previous.closed ? previous.pageId : openPages()[0]?.pageId);
 		}
 		const driver = {
+			cachedPages: () => Object.freeze(openPages().map(cachedPage)),
 			...options.pageControl === true ? { pageControl: {
 				state: async (page, ticket) => {
 					ticket.check();
@@ -877,6 +1301,11 @@ const makeScriptedBrowser = (script, timers) => {
 						by: connection
 					};
 					heldObservation(target.pageId);
+					ticket.acknowledge?.();
+					events.pageLifecycle?.({
+						_tag: "Display",
+						page: cachedPage(target)
+					});
 					return PageSuspension.make({
 						pageId: target.pageId,
 						targetId: target.targetId,
@@ -889,6 +1318,11 @@ const makeScriptedBrowser = (script, timers) => {
 					dispatch(ticket, record);
 					target.held = void 0;
 					heldObservation(target.pageId);
+					ticket.acknowledge?.();
+					events.pageLifecycle?.({
+						_tag: "Display",
+						page: cachedPage(target)
+					});
 				}),
 				checkTarget: async (target, ticket) => {
 					ticket.check();
@@ -904,6 +1338,7 @@ const makeScriptedBrowser = (script, timers) => {
 			},
 			selectedTargetId: async () => selectedPage().targetId,
 			listPages: (ticket) => attempt("list-pages", ticket, {}, async () => openPages().map(info)),
+			describePage: (page, ticket) => attempt("describe-page", ticket, { pageId: page.pageId }, async () => info(pageOf(page, "describe-page"))),
 			resolvePage: async (page, ticket) => {
 				ticket.check();
 				const target = pageOf(page, "target");
@@ -929,24 +1364,20 @@ const makeScriptedBrowser = (script, timers) => {
 					text: ""
 				}), false));
 			}),
-			closePage: (page, ticket) => attempt("close-page", ticket, { pageId: page.pageId }, async (record) => {
+			closePage: (page, ticket, onDispatch) => attempt("close-page", ticket, { pageId: page.pageId }, async (record) => {
 				const target = pageOf(page, "close-page");
 				dispatch(ticket, record);
-				target.closed = true;
-				target.navigation?.drop();
-				target.capture?.start.invalidate("target-changed");
-				target.capture = void 0;
-				notify(target);
-				if (selectedId === target.pageId) select(void 0);
-				invalidateSnapshot({ pageId: target.pageId });
-				events.invalidate("target-changed", { pageId: target.pageId });
-				for (const other of live) {
-					if (other === connection) continue;
-					other.retire(target.pageId);
-					other.announce(target.pageId);
-				}
+				close(target);
+			}, onDispatch),
+			containPage: (pageId) => attempt("close-page", void 0, { pageId }, async (record) => {
+				const target = pages.get(pageId);
+				if (target === void 0 || target.closed) return;
+				const outcome = take("close-page");
+				record.dispatched = true;
+				if (outcome?._tag === "Fail") throw fail("close-page", outcome.reason, outcome.outcome);
+				close(target);
 			}),
-			listFrames: (ticket, page) => attempt("list-frames", ticket, {}, async () => [frameInfo(page === void 0 ? selectedPage("list-frames") : pageOf(page, "list-frames"))]),
+			listFrames: (ticket, page) => attempt("list-frames", ticket, {}, async () => [frameInfo(pageOf(page, "list-frames"))]),
 			resolveFrame: async (page, frame, ticket) => {
 				ticket.check();
 				const target = pageOf(page, "target");
@@ -956,11 +1387,7 @@ const makeScriptedBrowser = (script, timers) => {
 					frameId: target.frameId
 				};
 			},
-			selectFrame: (id, ticket) => attempt("select-frame", ticket, {}, async () => {
-				if (id !== selectedPage("select-frame").frameId) throw fail("select-frame", Reasons.NotFound.make({}));
-				events.invalidate("target-changed", "none");
-			}),
-			beginNavigation: (url, timeoutMillis, ticket, target) => attempt("navigate", void 0, { pageId: target?.pageId }, async (record) => {
+			beginNavigation: (url, timeoutMillis, ticket, target) => attempt("navigate", void 0, { pageId: target.pageId }, async (record) => {
 				ticket.check();
 				const page = current(target, "navigate");
 				requireRunning(page, "navigate");
@@ -1023,7 +1450,7 @@ const makeScriptedBrowser = (script, timers) => {
 				};
 			}),
 			readText: (selector, maximumBytes, ticket, target) => attempt("read-text", ticket, {
-				pageId: target?.pageId,
+				pageId: target.pageId,
 				...meta(selector)
 			}, async () => {
 				const page = current(target, "read-text");
@@ -1031,11 +1458,12 @@ const makeScriptedBrowser = (script, timers) => {
 				const control = bySelector(page, selector, "read-text");
 				return bounded(control.script.text ?? control.script.label, maximumBytes).text;
 			}),
-			observe: (scope, maximumBytes, controls, ticket, match) => attempt("observe", ticket, {}, async () => {
-				const page = selectedPage("observe");
+			observe: (scope, maximumBytes, controls, ticket, match, target) => attempt("observe", ticket, { pageId: target.pageId }, async () => {
+				const page = current(target, "observe");
+				const size = page.viewport ?? viewport;
 				const needle = match?.toLowerCase();
 				const matches = (value) => needle === void 0 || value.toLowerCase().includes(needle);
-				snapshot = void 0;
+				snapshots.delete(page.frameId);
 				const selects = new Set(page.document.controls.filter((control) => isSelectable(control.script.kind) && (matches(control.script.label) || page.document.controls.some((option) => option.script.selectElementId === control.script.id && matches(option.script.label)))).map((control) => control.script.id));
 				const matching = page.document.controls.filter((control) => control.script.selectElementId !== void 0 ? selects.has(control.script.selectElementId) : isSelectable(control.script.kind) ? selects.has(control.script.id) : matches(control.script.label));
 				const reachable = matching.filter((control) => scope === "document" || control.script.offscreen !== true);
@@ -1044,13 +1472,22 @@ const makeScriptedBrowser = (script, timers) => {
 				const next = {
 					id: `observation-${++observationSerial}`,
 					pageId: page.pageId,
+					frameId: page.frameId,
 					epoch: page.epoch,
 					generation: ticket.generation,
+					scope,
 					validity: "valid",
 					nodes: new Map(kept.map((control) => [control.script.id, control])),
+					identities: new Map(kept.map((control) => {
+						const fresh = facts(control);
+						return [control.script.id, {
+							identity: identityOf(fresh),
+							stable: stableIdentityOf(fresh)
+						}];
+					})),
 					revalidated: /* @__PURE__ */ new Set()
 				};
-				snapshot = next;
+				snapshots.set(page.frameId, next);
 				return {
 					observationId: next.id,
 					scope,
@@ -1061,8 +1498,9 @@ const makeScriptedBrowser = (script, timers) => {
 					controls: kept.map(observed),
 					controlsTruncated: kept.length < reachable.length,
 					viewport: ViewportEvidence.make({
-						width: viewport.width,
-						height: viewport.height,
+						width: size.width,
+						height: size.height,
+						...page.document.documentScroll === void 0 ? {} : { documentScroll: { ...page.document.documentScroll } },
 						clippedText: 0,
 						coveredText: 0,
 						uncertainText: 0,
@@ -1071,8 +1509,9 @@ const makeScriptedBrowser = (script, timers) => {
 					})
 				};
 			}),
-			checkpoint: (maximumBytes, controls, pictureBytes, ticket) => attempt("checkpoint", ticket, {}, async () => {
-				const page = selectedPage("checkpoint");
+			checkpoint: (maximumBytes, controls, pictureBytes, ticket, target) => attempt("checkpoint", ticket, { pageId: target.pageId }, async () => {
+				const page = current(target, "checkpoint");
+				const size = page.viewport ?? viewport;
 				const text = bounded(page.document.text, maximumBytes);
 				const reachable = page.document.controls.filter((control) => control.script.offscreen !== true);
 				return {
@@ -1082,8 +1521,9 @@ const makeScriptedBrowser = (script, timers) => {
 					controls: reachable.slice(0, controls).map(facts),
 					controlsTruncated: reachable.length > controls,
 					viewport: ViewportEvidence.make({
-						width: viewport.width,
-						height: viewport.height,
+						width: size.width,
+						height: size.height,
+						...page.document.documentScroll === void 0 ? {} : { documentScroll: { ...page.document.documentScroll } },
 						clippedText: 0,
 						coveredText: 0,
 						uncertainText: 0,
@@ -1091,19 +1531,53 @@ const makeScriptedBrowser = (script, timers) => {
 						exhausted: false
 					}),
 					documentChanged: false,
-					...pictureBytes === void 0 ? {} : { picture: new Uint8Array(PNG) }
+					...pictureBytes === void 0 ? {} : { picture: picture(page, ticket) }
 				};
 			}),
-			controlFacts: (target, ticket) => attempt("control-facts", ticket, meta(target), async () => {
-				selectedPage("control-facts");
-				return resolve(target, ticket, "control-facts").facts;
+			controlFacts: (target, ticket, browserTarget) => attempt("control-facts", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async () => resolve(target, ticket, "control-facts", void 0, browserTarget).facts),
+			resolveDescriptor: (descriptor, ticket, target, guard = { _tag: "Strict" }) => attempt("resolve", ticket, { pageId: target.pageId }, async () => {
+				const group = resolveGroup([{ target: {
+					_tag: "Descriptor",
+					descriptor
+				} }], ticket, target, guard);
+				const element = group.elements[0];
+				const resolved = element === void 0 ? void 0 : resolvedElements.get(element);
+				if (resolved === void 0) {
+					await group.release();
+					throw fail("resolve", Reasons.Malformed.make({}));
+				}
+				try {
+					ticket.check();
+					const previous = snapshots.get(resolved.snapshot.frameId);
+					if (previous !== void 0) previous.validity = "invalid";
+					privateSnapshots.delete(resolved.snapshot);
+					snapshots.set(resolved.snapshot.frameId, {
+						...resolved.snapshot,
+						scope: resolved.scope
+					});
+					return ObservedElement.make({
+						observationId: resolved.snapshot.id,
+						elementId: resolved.node.script.id
+					});
+				} catch (error) {
+					await group.release();
+					throw error;
+				}
 			}),
-			revalidate: (target, ticket) => attempt("revalidate", ticket, meta(target), async () => {
-				const { snapshot: current } = retained(target, ticket, "revalidate", true);
+			resolveGroup: (requests, ticket, target, guard) => attempt("resolve", ticket, { pageId: target.pageId }, async () => resolveGroup(requests, ticket, target, guard)),
+			expectations: (conditions, ticket, target) => attempt("run", ticket, { pageId: target.pageId }, async () => expectations(conditions, ticket, target)),
+			revalidate: (target, ticket, browserTarget) => attempt("revalidate", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async () => {
+				const { snapshot: current } = retained(target, ticket, "revalidate", true, true, browserTarget);
 				current.revalidated.add(target.elementId);
 			}),
 			click: (target, ticket, capture, policy, browserTarget) => attempt("click", ticket, {
-				pageId: browserTarget?.pageId,
+				pageId: browserTarget.pageId,
 				...meta(target)
 			}, async (record) => {
 				const { node, page } = resolve(target, ticket, "click", policy, browserTarget);
@@ -1117,9 +1591,9 @@ const makeScriptedBrowser = (script, timers) => {
 					url,
 					input
 				};
-			}, () => invalidatePointer(browserTarget?.pageId ?? selectedId ?? "")),
+			}, () => invalidatePointer(browserTarget.pageId)),
 			fill: (target, value, ticket, policy, browserTarget) => attempt("fill", ticket, {
-				pageId: browserTarget?.pageId,
+				pageId: browserTarget.pageId,
 				...meta(target)
 			}, async (record) => {
 				const { node, page } = resolve(target, ticket, "fill", policy, browserTarget);
@@ -1131,25 +1605,34 @@ const makeScriptedBrowser = (script, timers) => {
 				page.values.set(node.script.id, value);
 				return page.document.url;
 			}),
-			selectOption: (target, ids, ticket, policy) => attempt("select-option", ticket, meta(target), async (record) => {
-				const { node, page } = resolve(target, ticket, "select-option", policy);
+			selectOption: (target, ids, ticket, policy, browserTarget) => attempt("select-option", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async (record) => {
+				const { node, page } = resolve(target, ticket, "select-option", policy, browserTarget);
 				requireRunning(page, "select-option");
-				const options = chosen(node, ids, "select-option");
+				const options = chosen(page, node, ids, ticket, "select-option");
 				dispatch(ticket, record);
 				choose(page, node, options);
 				return page.document.url;
 			}),
-			formStep: (target, field, ticket, policy, _settleMillis, capture) => attempt("fill-form", ticket, meta(target), async (record) => {
-				const { node, page } = resolve(target, ticket, "fill-form", policy, void 0, false, true);
+			formStep: (target, field, ticket, policy, _settleMillis, capture, browserTarget) => attempt("fill-form", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async (record) => {
+				const { node, page } = resolve(target, ticket, "fill-form", policy, browserTarget, false, true);
 				requireRunning(page, "fill-form");
 				return formStep(page, node, field, ticket, record, capture);
-			}, field.checked === void 0 ? void 0 : () => invalidatePointer(selectedId ?? "")),
-			formState: (targets, ticket) => attempt("fill-form", ticket, {}, async () => targets.map((target) => {
-				const { node, page } = retained(target, ticket, "fill-form", false, false);
+			}, field.checked === void 0 ? void 0 : () => invalidatePointer(browserTarget.pageId)),
+			formState: (targets, ticket, browserTarget) => attempt("fill-form", ticket, { pageId: browserTarget.pageId }, async () => targets.map((target) => {
+				const { node, page } = retainedElement(target, ticket, "fill-form", false, false, browserTarget);
 				return page.document.controls.includes(node) ? fieldState(page, node) : void 0;
 			})),
-			formSubmit: (target, ticket, capture, policy) => attempt("fill-form", ticket, meta(target), async (record) => {
-				const { node, page } = resolve(target, ticket, "fill-form", policy, void 0, false, true);
+			formSubmit: (target, ticket, capture, policy, browserTarget) => attempt("fill-form", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async (record) => {
+				const { node, page } = resolve(target, ticket, "fill-form", policy, browserTarget, false, true);
 				requireRunning(page, "fill-form");
 				dispatch(ticket, record);
 				let url = "";
@@ -1160,14 +1643,29 @@ const makeScriptedBrowser = (script, timers) => {
 					url,
 					input
 				};
-			}, () => invalidatePointer(selectedId ?? "")),
-			scroll: (_deltaX, _deltaY, ticket, target) => attempt("scroll", ticket, { pageId: target?.pageId }, async (record) => {
+			}, () => invalidatePointer(browserTarget.pageId)),
+			scroll: (deltaX, deltaY, ticket, target) => attempt("scroll", ticket, { pageId: target.pageId }, async (record) => {
 				const page = current(target, "scroll");
 				requireRunning(page, "scroll");
 				dispatch(ticket, record);
+				page.scroll.x += deltaX;
+				page.scroll.y += deltaY;
+				notify(page);
+				return page.document.url;
+			}),
+			scrollTo: (target, ticket, browserTarget) => attempt("scroll", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async (record) => {
+				const { page, facts: fresh } = resolve(target, ticket, "scroll", void 0, browserTarget);
+				requireRunning(page, "scroll");
+				dispatch(ticket, record);
+				page.scroll.x += fresh.box.x;
+				page.scroll.y += fresh.box.y;
+				notify(page);
 				return page.document.url;
 			}),
-			pointerMove: (to, ticket, target) => attempt("pointer-move", ticket, { pageId: target?.pageId }, async (record) => {
+			pointerMove: (to, ticket, target) => attempt("pointer-move", ticket, { pageId: target.pageId }, async (record) => {
 				const page = current(target, "pointer-move");
 				requireRunning(page, "pointer-move");
 				dispatch(ticket, record);
@@ -1178,7 +1676,7 @@ const makeScriptedBrowser = (script, timers) => {
 				return receipt(page.pageId);
 			}),
 			hover: (target, ticket, policy, browserTarget) => attempt("hover", ticket, {
-				pageId: browserTarget?.pageId,
+				pageId: browserTarget.pageId,
 				...meta(target)
 			}, async (record) => {
 				const { node, page, facts: fresh } = resolve(target, ticket, "hover", policy, browserTarget);
@@ -1191,7 +1689,7 @@ const makeScriptedBrowser = (script, timers) => {
 				});
 				return receipt(page.pageId);
 			}),
-			wheel: (_deltaX, _deltaY, at, ticket, target) => attempt("wheel", ticket, { pageId: target?.pageId }, async (record) => {
+			wheel: (deltaX, deltaY, at, ticket, target) => attempt("wheel", ticket, { pageId: target.pageId }, async (record) => {
 				const page = current(target, "wheel");
 				requireRunning(page, "wheel");
 				dispatch(ticket, record);
@@ -1199,10 +1697,13 @@ const makeScriptedBrowser = (script, timers) => {
 					x: at.x,
 					y: at.y
 				});
+				page.scroll.x += deltaX;
+				page.scroll.y += deltaY;
+				notify(page);
 				return receipt(page.pageId);
 			}),
 			press: (key, _modifiers, into, ticket, policy, browserTarget) => attempt("press", ticket, {
-				pageId: browserTarget?.pageId,
+				pageId: browserTarget.pageId,
 				...meta(into)
 			}, async (record) => {
 				const page = focusedOrRefuse(into, ticket, "press", policy, browserTarget);
@@ -1212,7 +1713,7 @@ const makeScriptedBrowser = (script, timers) => {
 				return receipt(page.pageId);
 			}),
 			type: (text, into, ticket, policy, browserTarget) => attempt("type", ticket, {
-				pageId: browserTarget?.pageId,
+				pageId: browserTarget.pageId,
 				...meta(into)
 			}, async (record) => {
 				const page = focusedOrRefuse(into, ticket, "type", policy, browserTarget);
@@ -1221,19 +1722,19 @@ const makeScriptedBrowser = (script, timers) => {
 				typed(page, text);
 				return receipt(page.pageId);
 			}),
-			screenshot: (_fullPage, _maximumBytes, ticket, target) => attempt("screenshot", ticket, { pageId: target?.pageId }, async () => {
-				current(target, "screenshot");
-				return new Uint8Array(PNG);
+			screenshot: (_fullPage, _maximumBytes, ticket, target) => attempt("screenshot", ticket, { pageId: target.pageId }, async () => {
+				const page = current(target, "screenshot");
+				return picture(page, ticket);
 			}),
-			resize: (next, ticket) => attempt("resize", ticket, {}, async (record) => {
-				const page = selectedPage("resize");
+			resize: (next, ticket, target) => attempt("resize", ticket, { pageId: target.pageId }, async (record) => {
+				const page = current(target, "resize");
 				dispatch(ticket, record);
-				viewport = {
+				page.viewport = {
 					width: next.width,
 					height: next.height
 				};
 				page.capture?.start.invalidate("resized");
-				events.invalidate("resized");
+				events.invalidate("resized", { pageId: page.pageId });
 			}),
 			waitFor: (selector, state, ticket, target) => attempt("wait", ticket, {
 				pageId: target.pageId,
@@ -1257,12 +1758,17 @@ const makeScriptedBrowser = (script, timers) => {
 					}
 				}, () => page.closed || page.epoch !== epoch);
 			}).finally(() => ticket.retire()),
+			settled: (options, ticket, target) => attempt("settled", ticket, { pageId: target.pageId }, async (record) => {
+				const page = current(target, "settled");
+				requireRunning(page, "settled");
+				return waitSettled(options, ticket, page, record);
+			}).finally(() => ticket.retire()),
 			waitForElement: (reference, state, ticket, target) => attempt("wait", ticket, {
 				pageId: target.pageId,
-				elementId: reference.elementId
+				...meta(reference)
 			}, async (record) => {
 				const page = current(target, "wait");
-				const { node } = retained(reference, ticket, "wait", true);
+				const { node } = retainedElement(reference, ticket, "wait", true, true, target);
 				const epoch = page.epoch;
 				await waitUntil(ticket, page, "wait", record, () => {
 					const present = page.document.controls.includes(node);
@@ -1275,8 +1781,11 @@ const makeScriptedBrowser = (script, timers) => {
 					}
 				}, () => page.closed || page.epoch !== epoch);
 			}).finally(() => ticket.retire()),
-			clickAndWait: (target, ticket, capture) => attempt("click-and-wait", ticket, meta(target), async (record) => {
-				const { node, page } = resolve(target, ticket, "click-and-wait");
+			clickAndWait: (target, ticket, capture, browserTarget) => attempt("click-and-wait", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async (record) => {
+				const { node, page } = resolve(target, ticket, "click-and-wait", void 0, browserTarget);
 				requireRunning(page, "click-and-wait");
 				dispatch(ticket, record);
 				let url = "";
@@ -1287,9 +1796,12 @@ const makeScriptedBrowser = (script, timers) => {
 					url,
 					input
 				};
-			}, () => invalidatePointer(selectedId ?? "")),
-			clickForDownload: (target, ticket) => attempt("download-action", ticket, meta(target), async (record) => {
-				const { node, page } = resolve(target, ticket, "download-action");
+			}, () => invalidatePointer(browserTarget.pageId)),
+			clickForDownload: (target, ticket, browserTarget) => attempt("download-action", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async (record) => {
+				const { node, page } = resolve(target, ticket, "download-action", void 0, browserTarget);
 				requireRunning(page, "download-action");
 				if (node.script.download === void 0) throw fail("download-action", Reasons.Unsupported.make({}));
 				dispatch(ticket, record);
@@ -1300,8 +1812,14 @@ const makeScriptedBrowser = (script, timers) => {
 					state: "completed"
 				};
 			}),
-			selectFiles: (target, files, ticket) => attempt("select-files", ticket, meta(target), async (record) => selectFilesOn(target, files, ticket, record, "select-files")),
-			clickForFileSelection: (target, files, ticket) => attempt("file-chooser", ticket, meta(target), async (record) => selectFilesOn(target, files, ticket, record, "file-chooser")),
+			selectFiles: (target, files, ticket, browserTarget) => attempt("select-files", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async (record) => selectFilesOn(target, files, ticket, record, "select-files", browserTarget)),
+			clickForFileSelection: (target, files, ticket, browserTarget) => attempt("file-chooser", ticket, {
+				pageId: browserTarget.pageId,
+				...meta(target)
+			}, async (record) => selectFilesOn(target, files, ticket, record, "file-chooser", browserTarget)),
 			documentReadiness: async (ticket, target) => {
 				ticket.check();
 				const page = current(target, "ready");
@@ -1313,7 +1831,7 @@ const makeScriptedBrowser = (script, timers) => {
 			},
 			dismissDialogs: async () => {},
 			capture: async (target) => {
-				const page = target === void 0 ? selectedPage("capture") : pageOf(PageInfo.make({
+				const page = pageOf(PageInfo.make({
 					pageId: target.pageId,
 					targetId: target.targetId,
 					url: "",
@@ -1341,8 +1859,8 @@ const makeScriptedBrowser = (script, timers) => {
 					}
 				};
 			},
-			invalidateObservation: (scope) => {
-				invalidateSnapshot(scope);
+			invalidateObservation: (scope, origin) => {
+				invalidateSnapshot(scope, origin);
 			},
 			disconnect: async () => {
 				if (disconnected) return;
@@ -1359,8 +1877,8 @@ const makeScriptedBrowser = (script, timers) => {
 				dropConnection(false, "closed");
 			}
 		};
-		const selectFilesOn = (target, files, ticket, record, operation) => {
-			const { node, page } = resolve(target, ticket, operation);
+		const selectFilesOn = (target, files, ticket, record, operation, browserTarget) => {
+			const { node, page } = resolve(target, ticket, operation, void 0, browserTarget);
 			requireRunning(page, operation);
 			if (node.script.kind !== "input" || node.script.inputType !== "file") throw fail(operation, Reasons.Unsupported.make({}));
 			dispatch(ticket, record);
@@ -1368,12 +1886,43 @@ const makeScriptedBrowser = (script, timers) => {
 			return page.document.url;
 		};
 		const connection = {
+			opened: (pageId) => {
+				const page = pages.get(pageId);
+				if (page !== void 0) events.pageLifecycle?.({
+					_tag: "Opened",
+					page: cachedPage(page)
+				});
+			},
+			navigated: (pageId, sameDocument) => {
+				const page = pages.get(pageId);
+				if (page !== void 0) events.pageLifecycle?.({
+					_tag: "Navigated",
+					page: cachedPage(page),
+					frameId: page.frameId,
+					documentEpoch: page.epoch,
+					sameDocument,
+					url: page.document.url.length <= 8192 ? page.document.url : null,
+					urlQualification: page.document.url.length <= 8192 ? "NativeCached" : "Omitted"
+				});
+			},
+			metadata: (pageId) => {
+				const page = pages.get(pageId);
+				if (page !== void 0) events.pageLifecycle?.({
+					_tag: "Metadata",
+					page: cachedPage(page)
+				});
+			},
 			retire: (pageId) => invalidateSnapshot({ pageId }),
+			closed: (pageId) => {
+				const page = pages.get(pageId);
+				if (page !== void 0) snapshots.delete(page.frameId);
+				events.pageClosed?.(pageId, page === void 0 ? void 0 : cachedPage(page));
+			},
 			announce: (pageId) => events.invalidate("target-changed", { pageId }),
 			drop: () => dropConnection(true),
 			invoke: invokeBinding,
 			pointer: () => pointer,
-			viewport: () => viewport
+			viewport: (pageId) => pages.get(pageId)?.viewport ?? viewport
 		};
 		index = connections.push("open") - 1;
 		live.add(connection);
@@ -1384,6 +1933,7 @@ const makeScriptedBrowser = (script, timers) => {
 		url: document.url,
 		title: document.title,
 		text: document.text,
+		...document.documentScroll === void 0 ? {} : { documentScroll: { ...document.documentScroll } },
 		controls: document.controls.map((control) => ({
 			...control.script,
 			...control.checked === void 0 ? {} : { checked: control.checked },
@@ -1422,7 +1972,7 @@ const makeScriptedBrowser = (script, timers) => {
 				const running = page.capture?.start;
 				if (running === void 0) return Effect.fail(fail("capture-consume", Reasons.NotFound.make({})));
 				const timestamp = frame.timestamp ?? lastTimestamp + 40;
-				const viewport = page.capture?.by.viewport() ?? {
+				const viewport = page.capture?.by.viewport(page.pageId) ?? {
 					width: 0,
 					height: 0
 				};
@@ -1535,23 +2085,24 @@ const makeEngine = Effect.fnUntraced(function* (script) {
 * Open one scripted browser in the caller's Scope. The session is the real owner over a
 * scripted native engine: admission, budgets, staleness, dispatch evidence, capture, page holds
 * and typed callbacks are the production code paths. Only the page and its outcomes are scripted,
-* and the owner's ids and handoff tokens come from `sequentialCrypto`.
+* and the owner's ids and handoff tokens use deterministic Crypto namespaced by this
+* scripted reference, so independently opened sessions have distinct evidence domains.
 */
 const open = Effect.fnUntraced(function* (script, options = {}) {
 	const fixed = yield* checked(Script, script, "configure");
 	const policy = yield* checked(BrowserPolicy, options.policy ?? BrowserPolicy.unrestricted(), "configure");
 	const engine = yield* makeEngine(fixed);
-	const runtime = yield* make({
+	const namespace = ++references;
+	const reference = Object.freeze(ScriptedReference.make({
+		provider: "scripted",
+		id: `scripted-${namespace}`
+	}));
+	const acquired = yield* (yield* make({
 		implementation: "scripted",
 		binding: engine.binding,
 		...options.automation === void 0 ? {} : { automation: options.automation },
 		...options.viewport === void 0 ? {} : { viewport: options.viewport }
-	}).pipe(Effect.provide(sequentialCrypto));
-	const reference = Object.freeze(ScriptedReference.make({
-		provider: "scripted",
-		id: `scripted-${++references}`
-	}));
-	const acquired = yield* runtime.acquire(policy, scriptedSource(reference, options.onCleanup), options.bootstrap === void 0 ? {} : { bootstrap: options.bootstrap });
+	}).pipe(Effect.provide(Layer.sync(Crypto.Crypto, () => makeSequentialCrypto(namespace))))).acquire(policy, scriptedSource(reference, options.onCleanup), options.bootstrap === void 0 ? {} : { bootstrap: options.bootstrap });
 	const connection = yield* acquired.connect;
 	const control = engine.controls().at(-1);
 	if (control === void 0) return yield* BrowserError.make({
@@ -1570,7 +2121,8 @@ const open = Effect.fnUntraced(function* (script, options = {}) {
 /**
 * The `Crypto` scripted browsers draw their ids and handoff tokens from. Its bytes count up from
 * one on each build, so every value is predictable; it is not random and computes no digest.
-* `open` uses it already. A provider Layer built over `binding` still requires a `Crypto`, and
+* `open` uses the same counter with its original scripted-reference namespace. A provider
+* Layer built over `binding` still requires a `Crypto`, and
 * this one keeps such a test free of a platform package.
 */
 const sequentialCrypto = Layer.sync(Crypto.Crypto, makeSequentialCrypto);