@effect-agent/platform-cloudflare 0.1.0-beta.110 → 0.1.0-beta.112

package/dist/{InteractiveBrowser-l6J4eP6T.mjs → InteractiveBrowser-CBUFAECo.mjs}

@@ -1,9 +1,9 @@
-import { Cause, Clock, Context, Data, Duration, Effect, Encoding, ErrorReporter, Layer, Option, Predicate, Redacted, Ref, Schema, Scope, Semaphore, Stream } from "effect";
+import { Cause, Clock, Context, Data, Duration, Effect, Encoding, ErrorReporter, Layer, Option, Predicate, Redacted, Schema, Scope, Semaphore, Stream } from "effect";
 import { PageScreenshotResult } from "effect-agent/page-screenshot";
 import { SandboxImplementation } from "effect-agent/sandbox";
 import { FetchHttpClient, HttpClient, HttpClientRequest } from "effect/unstable/http";
 import puppeteer from "@cloudflare/puppeteer";
-import { BrowserActionResult, BrowserFileSelectionResult, BrowserNavigationResult, BrowserScreenshotRequest, BrowserScrollRequest, BrowserSelectFileRequest, BrowserTextResult, InteractiveBrowser, InteractiveBrowserActionError, InteractiveBrowserBusyError, InteractiveBrowserCapacityError, InteractiveBrowserExpiredError, InteractiveBrowserLimitError, InteractiveBrowserPolicy, InteractiveBrowserPolicyDeniedError, InteractiveBrowserProtocolError, InteractiveBrowserTargetUrl, InteractiveBrowserUnsupportedError } from "effect-agent/interactive-browser";
+import { BrowserActionResult, BrowserExpectedTargetState, BrowserFileSelectionResult, BrowserNavigationResult, BrowserScreenshotRequest, BrowserScrollRequest, BrowserSelectFileRequest, BrowserTextResult, InteractiveBrowser, InteractiveBrowserActionError, InteractiveBrowserBusyError, InteractiveBrowserCapacityError, InteractiveBrowserExpiredError, InteractiveBrowserLimitError, InteractiveBrowserPolicy, InteractiveBrowserPolicyDeniedError, InteractiveBrowserProtocolError, InteractiveBrowserTargetUrl, InteractiveBrowserUnsupportedError } from "effect-agent/interactive-browser";
 //#region src/internal/browser-failure.ts
 /** Source-authored stages and classifications only; never retain SDK text or session capabilities. */
 var BrowserRunFailure = class extends Data.TaggedError("BrowserRunFailure") {
@@ -328,22 +328,19 @@ const ActionObservation = Schema.Struct({
 	before: ActionTargetState,
 	after: Schema.optionalKey(ActionTargetState),
 	afterUnavailable: Schema.Boolean,
-	network: ActionNetworkState
+	network: ActionNetworkState,
+	inputMillis: Schema.optionalKey(Schema.Finite),
+	observationMillis: Schema.optionalKey(Schema.Finite)
 });
-const PageObservation = Schema.fromJsonString(Schema.Struct({
+const BrowserRunPageObservation = Schema.fromJsonString(Schema.Struct({
+	documentId: Schema.NonEmptyString,
 	pageText: BoundedRemoteText,
 	selectorMatchCount: Schema.Natural,
 	controlsTruncated: Schema.Boolean,
 	controls: Schema.Array(Schema.Struct({
+		nodeId: Schema.NonEmptyString,
 		selector: BoundedRemoteText,
-		kind: BoundedRemoteText,
-		label: Schema.optionalKey(Schema.String.check(Schema.isMaxLength(200))),
-		checked: Schema.optionalKey(Schema.Boolean),
-		selected: Schema.optionalKey(Schema.Boolean),
-		disabled: Schema.optionalKey(Schema.Boolean),
-		required: Schema.optionalKey(Schema.Boolean),
-		valid: Schema.optionalKey(Schema.Boolean),
-		formValid: Schema.optionalKey(Schema.Boolean)
+		...BrowserExpectedTargetState.fields
 	})).check(Schema.isMaxLength(MAX_OBSERVED_CONTROLS))
 }));
 const PngBytes = Schema.Uint8Array.check(Schema.isMaxLength(MAX_SCREENSHOT_BYTES), Schema.makeFilter((bytes) => bytes.length >= 8 && bytes[0] === 137 && bytes[1] === 80 && bytes[2] === 78 && bytes[3] === 71 && bytes[4] === 13 && bytes[5] === 10 && bytes[6] === 26 && bytes[7] === 10, { title: "PNG bytes" }));
@@ -421,6 +418,24 @@ var BrowserRunInteractiveBinding = class BrowserRunInteractiveBinding extends Co
 		})).pipe(Layer.provide(BrowserRunBinding.layer(options.browser)));
 	}
 };
+/** Private target identity; never include this checkpoint in model-visible records. */
+var BrowserRunPageIdentity = class extends Schema.Class("BrowserRunPageIdentity")({
+	contextId: BrowserRunSessionId,
+	targetId: BrowserRunSessionId
+}) {};
+/** Host-owned recovery data. Persist with the application's input receipts and ownership fence. */
+var BrowserRunInteractiveCheckpoint = class extends Schema.Class("BrowserRunInteractiveCheckpoint")({
+	sessionId: Schema.RedactedFromValue(BrowserRunSessionId),
+	page: BrowserRunPageIdentity,
+	policy: InteractiveBrowserPolicy,
+	startedAt: Schema.Natural,
+	consumedActions: Schema.Natural.check(Schema.isLessThanOrEqualTo(1e3)),
+	inputState: Schema.Literals([
+		"idle",
+		"running",
+		"unknown"
+	])
+}) {};
 /** Cloudflare host authority kept separate from the provider-neutral browser handle. */
 var BrowserRunInteractiveHost = class extends Context.Service()("@effect-agent/platform-cloudflare/BrowserRunInteractiveHost") {};
 const makeProductionRequest = (request) => ({
@@ -594,7 +609,186 @@ const makeActionRequestTracker = (page, signal) => {
 const disposeActionHandles = async (handles) => {
 	await boundedBestEffort(Promise.allSettled(handles.map(async (handle) => handle.dispose())), ACTION_POST_STATE_MILLIS);
 };
-const runObservedPageAction = async (page, selector, signal, onDispatch, action, validate) => {
+/** Runs entirely in the page realm for both observations and the last bound-element guard. */
+const observePage = (target, requestedSelector, maximum, maximumControls, input) => {
+	const pageDocument = Reflect.get(globalThis, "document");
+	const matches = requestedSelector === void 0 ? void 0 : Reflect.apply(Reflect.get(pageDocument, "querySelectorAll"), pageDocument, [requestedSelector]);
+	const selectorMatchCount = matches === void 0 || matches === null ? 1 : Math.min(1e4, Reflect.get(matches, "length"));
+	const element = target ?? (matches === void 0 || matches === null ? Reflect.get(pageDocument, "body") : Reflect.get(matches, 0));
+	if (target !== void 0 && Reflect.get(target, "isConnected") !== true) return { _tag: "MissingElement" };
+	if (element === null) return { _tag: "MissingElement" };
+	if (element === void 0) return { _tag: "MissingElement" };
+	const innerText = Reflect.get(element, "innerText");
+	const textContent = Reflect.get(element, "textContent");
+	const pageText = typeof innerText === "string" ? innerText : typeof textContent === "string" ? textContent : "";
+	const primaryControlSelector = "input,select,textarea,label,button,[role=\"checkbox\"],[role=\"radio\"],[role=\"option\"],[role=\"switch\"],[role=\"tab\"],[role=\"button\"]";
+	const optionSelector = "select option";
+	const secondaryControlSelector = "a[href]";
+	const controlSelector = `${primaryControlSelector},${optionSelector},${secondaryControlSelector}`;
+	const selectorFor = (candidate) => {
+		const parts = [];
+		let current = candidate;
+		while (current !== null && current !== void 0) {
+			const tagName = String(Reflect.get(current, "tagName") ?? "").toLowerCase();
+			if (tagName === "") break;
+			const parent = Reflect.get(current, "parentElement");
+			if (parent === null) {
+				parts.push(tagName);
+				break;
+			}
+			let sibling = Reflect.get(current, "previousElementSibling");
+			let index = 1;
+			while (sibling !== null && sibling !== void 0) {
+				if (String(Reflect.get(sibling, "tagName") ?? "").toLowerCase() === tagName) index++;
+				sibling = Reflect.get(sibling, "previousElementSibling");
+			}
+			parts.push(`${tagName}:nth-of-type(${index})`);
+			current = parent;
+		}
+		return parts.reverse().join(" > ");
+	};
+	const visible = (candidate) => {
+		const hidden = Reflect.get(candidate, "hidden");
+		const ariaHidden = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-hidden"]);
+		const rects = Reflect.apply(Reflect.get(candidate, "getClientRects"), candidate, []);
+		return hidden !== true && ariaHidden !== "true" && typeof rects === "object" && rects !== null && Reflect.get(rects, "length") > 0;
+	};
+	const candidates = [];
+	let controlsTruncated = false;
+	const consider = (candidate) => {
+		const tagName = String(Reflect.get(candidate, "tagName") ?? "").toLowerCase();
+		const visibilityTarget = tagName === "option" ? Reflect.apply(Reflect.get(candidate, "closest"), candidate, ["select"]) : candidate;
+		if (!(tagName !== "label" || Reflect.get(candidate, "control") !== null) || typeof visibilityTarget !== "object" || visibilityTarget === null || !visible(visibilityTarget)) return;
+		candidates.push(candidate);
+		if (candidates.length > maximumControls) controlsTruncated = true;
+	};
+	const elementMatches = Reflect.get(element, "matches");
+	if (typeof elementMatches === "function" && Reflect.apply(elementMatches, element, [controlSelector])) consider(element);
+	const considerSelector = (candidateSelector) => {
+		const descendants = Reflect.apply(Reflect.get(element, "querySelectorAll"), element, [candidateSelector]);
+		if (typeof descendants !== "object" || descendants === null) return;
+		const descendantCount = Reflect.get(descendants, "length");
+		for (let index = 0; index < descendantCount && !controlsTruncated; index++) consider(Reflect.get(descendants, index));
+	};
+	considerSelector(primaryControlSelector);
+	if (!controlsTruncated) considerSelector(optionSelector);
+	if (!controlsTruncated) considerSelector(secondaryControlSelector);
+	const identityKey = Symbol.for("@effect-agent/browser-observation");
+	let identity = Reflect.get(globalThis, identityKey);
+	if (identity === void 0 || identity.document !== pageDocument) {
+		identity = {
+			document: pageDocument,
+			documentId: crypto.getRandomValues(/* @__PURE__ */ new Uint32Array(4)).join("-"),
+			nodes: /* @__PURE__ */ new WeakMap()
+		};
+		Reflect.set(globalThis, identityKey, identity);
+	}
+	const controls = candidates.slice(0, maximumControls).map((candidate) => {
+		let nodeId = identity.nodes.get(candidate);
+		if (nodeId === void 0) {
+			nodeId = crypto.getRandomValues(/* @__PURE__ */ new Uint32Array(4)).join("-");
+			identity.nodes.set(candidate, nodeId);
+		}
+		const associated = Reflect.get(candidate, "control") ?? candidate;
+		const tagName = String(Reflect.get(candidate, "tagName") ?? "").toLowerCase();
+		const inputType = String(Reflect.get(associated, "type") ?? "").toLowerCase();
+		const role = String(Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["role"]) ?? "").toLowerCase();
+		const ariaLabel = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-label"]);
+		const candidateText = tagName === "textarea" || tagName === "input" || tagName === "select" ? void 0 : Reflect.get(candidate, tagName === "option" ? "label" : "innerText");
+		const associatedLabels = Reflect.get(associated, "labels");
+		const associatedLabel = associatedLabels !== void 0 && associatedLabels !== null && Reflect.get(associatedLabels, "length") > 0 ? Reflect.get(Reflect.get(associatedLabels, 0), "innerText") : void 0;
+		const label = String(typeof ariaLabel === "string" && ariaLabel !== "" ? ariaLabel : typeof candidateText === "string" && candidateText !== "" ? candidateText : associatedLabel ?? "").replace(/\s+/g, " ").trim().slice(0, 200);
+		const checked = Reflect.get(associated, "checked");
+		const selected = tagName === "select" ? Reflect.get(associated, "selectedIndex") >= 0 : Reflect.get(associated, "selected");
+		const disabled = Reflect.get(associated, "disabled");
+		const required = Reflect.get(associated, "required");
+		const validity = Reflect.get(associated, "validity");
+		const form = Reflect.get(associated, "form");
+		const formMatches = form === null || form === void 0 ? void 0 : Reflect.get(form, "matches");
+		const ariaChecked = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-checked"]);
+		const ariaSelected = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-selected"]);
+		const ariaDisabled = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-disabled"]);
+		return {
+			nodeId,
+			...inputType === "" ? {} : { inputType: inputType.slice(0, 64) },
+			selector: selectorFor(candidate),
+			kind: (tagName === "label" ? `label:${inputType || "control"}` : tagName === "input" ? `input:${inputType || "text"}` : role !== "" ? `role:${role}` : tagName).slice(0, 128),
+			...label === "" ? {} : { label },
+			...typeof checked === "boolean" ? { checked } : ariaChecked === "true" || ariaChecked === "false" ? { checked: ariaChecked === "true" } : {},
+			...typeof selected === "boolean" ? { selected } : ariaSelected === "true" || ariaSelected === "false" ? { selected: ariaSelected === "true" } : {},
+			...typeof disabled === "boolean" ? { disabled } : ariaDisabled === "true" || ariaDisabled === "false" ? { disabled: ariaDisabled === "true" } : {},
+			...typeof required === "boolean" ? { required } : {},
+			...validity !== void 0 && typeof Reflect.get(validity, "valid") === "boolean" ? { valid: Reflect.get(validity, "valid") } : {},
+			...typeof formMatches === "function" ? { formValid: Reflect.apply(formMatches, form, [":valid"]) } : {}
+		};
+	});
+	if (input !== void 0) {
+		const expected = input.expectedTarget;
+		const control = controls.find((candidate) => candidate.nodeId === expected.nodeId);
+		if (target === void 0 || identity.documentId !== expected.documentId || identity.nodes.get(target) !== expected.nodeId || control === void 0 || expected.state !== void 0 && [
+			"kind",
+			"inputType",
+			"label",
+			"checked",
+			"selected",
+			"disabled",
+			"required",
+			"valid",
+			"formValid"
+		].some((field) => control[field] !== expected.state?.[field]) || Reflect.get(target, "isConnected") !== true) return { _tag: "MissingElement" };
+		if (expected.scopeSelector !== void 0) {
+			let roots;
+			try {
+				roots = Reflect.apply(Reflect.get(pageDocument, "querySelectorAll"), pageDocument, [expected.scopeSelector]);
+			} catch {
+				return { _tag: "MissingElement" };
+			}
+			if (typeof roots !== "object" || roots === null) return { _tag: "MissingElement" };
+			const root = Reflect.get(roots, 0);
+			if (Reflect.get(roots, "length") !== 1 || root === void 0 || !Reflect.apply(Reflect.get(root, "contains"), root, [target])) return { _tag: "MissingElement" };
+		}
+		if (input.mode === "click") {
+			const prototype = Reflect.get(Reflect.get(globalThis, "HTMLElement"), "prototype");
+			Reflect.apply(Reflect.get(prototype, "click"), target, []);
+		} else {
+			let prototype = Reflect.getPrototypeOf(target);
+			let setValue;
+			while (prototype !== null) {
+				const setter = Reflect.getOwnPropertyDescriptor(prototype, "value")?.set;
+				if (typeof setter === "function") {
+					setValue = setter;
+					break;
+				}
+				prototype = Reflect.getPrototypeOf(prototype);
+			}
+			if (setValue === void 0 || input.value === void 0) return { _tag: "MissingElement" };
+			Reflect.apply(setValue, target, [input.value]);
+			const dispatchEvent = Reflect.get(target, "dispatchEvent");
+			Reflect.apply(dispatchEvent, target, [new Event("input", { bubbles: true })]);
+			Reflect.apply(dispatchEvent, target, [new Event("change", { bubbles: true })]);
+		}
+		return {
+			_tag: "Text",
+			text: ""
+		};
+	}
+	const text = JSON.stringify({
+		documentId: identity.documentId,
+		pageText,
+		selectorMatchCount,
+		controls,
+		controlsTruncated
+	});
+	const observed = new TextEncoder().encode(text).byteLength;
+	return observed > maximum ? {
+		_tag: "OverLimit",
+		observed
+	} : {
+		_tag: "Text",
+		text
+	};
+};
+const runObservedPageAction = async (page, selector, signal, onDispatch, action, validate, onComplete) => {
 	if (signal.aborted) throw new BrowserRunActionUndispatched(0);
 	const before = Schema.decodeUnknownSync(ActionTargetState)(await readActionTarget(page, selector));
 	if (before.matchCount !== 1 || before.invalidSelector === true) throw new BrowserRunActionUndispatched(before.matchCount);
@@ -619,12 +813,17 @@ const runObservedPageAction = async (page, selector, signal, onDispatch, action,
 		tracker = makeActionRequestTracker(page, signal);
 		if (signal.aborted) throw new BrowserRunActionUndispatched(1);
 		onDispatch();
+		const inputStarted = performance.now();
 		await action(matches[0]);
+		const inputFinished = performance.now();
+		onComplete?.();
 		tracker.markActionSettled();
 		const network = await tracker.wait();
 		const after = signal.aborted ? void 0 : await readActionTargetAfter(page, selector);
 		return {
 			before,
+			inputMillis: Math.max(0, inputFinished - inputStarted),
+			observationMillis: Math.max(0, performance.now() - inputFinished),
 			...after === void 0 ? {} : { after },
 			afterUnavailable: after === void 0,
 			network
@@ -635,10 +834,29 @@ const runObservedPageAction = async (page, selector, signal, onDispatch, action,
 		await dispose();
 	}
 };
+const guardedPageInput = async (element, expectedTarget, mode, value) => {
+	if (Schema.decodeUnknownSync(TextObservation)(await element.evaluate(observePage, void 0, 262144, 1, {
+		mode,
+		expectedTarget,
+		...value === void 0 ? {} : { value }
+	}))._tag !== "Text") throw new BrowserRunActionUndispatched(1);
+};
 const makeProductionPage = (page) => {
 	const prepareFileSelection = makeFileSelection(page);
 	const listeners = /* @__PURE__ */ new Map();
 	return {
+		identity: async () => {
+			const cdp = await page.createCDPSession();
+			try {
+				const { targetInfo } = await cdp.send("Target.getTargetInfo");
+				return Schema.decodeUnknownSync(BrowserRunPageIdentity)({
+					contextId: targetInfo.browserContextId,
+					targetId: targetInfo.targetId
+				});
+			} finally {
+				await cdp.detach();
+			}
+		},
 		close: async () => {
 			if (!page.browser().isConnected()) return;
 			try {
@@ -669,119 +887,11 @@ const makeProductionPage = (page) => {
 		},
 		url: () => page.url(),
 		readText: async (selector, maximumBytes) => {
-			const observation = Schema.decodeUnknownSync(TextObservation)(await page.evaluate((requestedSelector, maximum, maximumControls) => {
-				const pageDocument = Reflect.get(globalThis, "document");
-				const matches = requestedSelector === void 0 ? void 0 : Reflect.apply(Reflect.get(pageDocument, "querySelectorAll"), pageDocument, [requestedSelector]);
-				const selectorMatchCount = matches === void 0 || matches === null ? 1 : Math.min(1e4, Reflect.get(matches, "length"));
-				const element = matches === void 0 || matches === null ? Reflect.get(pageDocument, "body") : Reflect.get(matches, 0);
-				if (element === null) return { _tag: "MissingElement" };
-				if (element === void 0) return { _tag: "MissingElement" };
-				const innerText = Reflect.get(element, "innerText");
-				const textContent = Reflect.get(element, "textContent");
-				const pageText = typeof innerText === "string" ? innerText : typeof textContent === "string" ? textContent : "";
-				const primaryControlSelector = "input,select,textarea,label,button,[role=\"checkbox\"],[role=\"radio\"],[role=\"option\"],[role=\"switch\"],[role=\"tab\"],[role=\"button\"]";
-				const optionSelector = "select option";
-				const secondaryControlSelector = "a[href]";
-				const controlSelector = `${primaryControlSelector},${optionSelector},${secondaryControlSelector}`;
-				const selectorFor = (candidate) => {
-					const parts = [];
-					let current = candidate;
-					while (current !== null && current !== void 0) {
-						const tagName = String(Reflect.get(current, "tagName") ?? "").toLowerCase();
-						if (tagName === "") break;
-						const parent = Reflect.get(current, "parentElement");
-						if (parent === null) {
-							parts.push(tagName);
-							break;
-						}
-						let sibling = Reflect.get(current, "previousElementSibling");
-						let index = 1;
-						while (sibling !== null && sibling !== void 0) {
-							if (String(Reflect.get(sibling, "tagName") ?? "").toLowerCase() === tagName) index++;
-							sibling = Reflect.get(sibling, "previousElementSibling");
-						}
-						parts.push(`${tagName}:nth-of-type(${index})`);
-						current = parent;
-					}
-					return parts.reverse().join(" > ");
-				};
-				const visible = (candidate) => {
-					const hidden = Reflect.get(candidate, "hidden");
-					const ariaHidden = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-hidden"]);
-					const rects = Reflect.apply(Reflect.get(candidate, "getClientRects"), candidate, []);
-					return hidden !== true && ariaHidden !== "true" && typeof rects === "object" && rects !== null && Reflect.get(rects, "length") > 0;
-				};
-				const candidates = [];
-				let controlsTruncated = false;
-				const consider = (candidate) => {
-					const tagName = String(Reflect.get(candidate, "tagName") ?? "").toLowerCase();
-					const visibilityTarget = tagName === "option" ? Reflect.apply(Reflect.get(candidate, "closest"), candidate, ["select"]) : candidate;
-					if (!(tagName !== "label" || Reflect.get(candidate, "control") !== null) || typeof visibilityTarget !== "object" || visibilityTarget === null || !visible(visibilityTarget)) return;
-					candidates.push(candidate);
-					if (candidates.length > maximumControls) controlsTruncated = true;
-				};
-				const elementMatches = Reflect.get(element, "matches");
-				if (typeof elementMatches === "function" && Reflect.apply(elementMatches, element, [controlSelector])) consider(element);
-				const considerSelector = (candidateSelector) => {
-					const descendants = Reflect.apply(Reflect.get(element, "querySelectorAll"), element, [candidateSelector]);
-					if (typeof descendants !== "object" || descendants === null) return;
-					const descendantCount = Reflect.get(descendants, "length");
-					for (let index = 0; index < descendantCount && !controlsTruncated; index++) consider(Reflect.get(descendants, index));
-				};
-				considerSelector(primaryControlSelector);
-				if (!controlsTruncated) considerSelector(optionSelector);
-				if (!controlsTruncated) considerSelector(secondaryControlSelector);
-				const controls = candidates.slice(0, maximumControls).map((candidate) => {
-					const associated = Reflect.get(candidate, "control") ?? candidate;
-					const tagName = String(Reflect.get(candidate, "tagName") ?? "").toLowerCase();
-					const inputType = String(Reflect.get(associated, "type") ?? "").toLowerCase();
-					const role = String(Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["role"]) ?? "").toLowerCase();
-					const ariaLabel = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-label"]);
-					const candidateText = tagName === "textarea" || tagName === "input" || tagName === "select" ? void 0 : Reflect.get(candidate, tagName === "option" ? "label" : "innerText");
-					const associatedLabels = Reflect.get(associated, "labels");
-					const associatedLabel = associatedLabels !== void 0 && associatedLabels !== null && Reflect.get(associatedLabels, "length") > 0 ? Reflect.get(Reflect.get(associatedLabels, 0), "innerText") : void 0;
-					const label = String(typeof ariaLabel === "string" && ariaLabel !== "" ? ariaLabel : typeof candidateText === "string" && candidateText !== "" ? candidateText : associatedLabel ?? "").replace(/\s+/g, " ").trim().slice(0, 200);
-					const checked = Reflect.get(associated, "checked");
-					const selected = tagName === "select" ? Reflect.get(associated, "selectedIndex") >= 0 : Reflect.get(associated, "selected");
-					const disabled = Reflect.get(associated, "disabled");
-					const required = Reflect.get(associated, "required");
-					const validity = Reflect.get(associated, "validity");
-					const form = Reflect.get(associated, "form");
-					const formMatches = form === null || form === void 0 ? void 0 : Reflect.get(form, "matches");
-					const ariaChecked = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-checked"]);
-					const ariaSelected = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-selected"]);
-					const ariaDisabled = Reflect.apply(Reflect.get(candidate, "getAttribute"), candidate, ["aria-disabled"]);
-					return {
-						selector: selectorFor(candidate),
-						kind: tagName === "label" ? `label:${inputType || "control"}` : tagName === "input" ? `input:${inputType || "text"}` : role !== "" ? `role:${role}` : tagName,
-						...label === "" ? {} : { label },
-						...typeof checked === "boolean" ? { checked } : ariaChecked === "true" || ariaChecked === "false" ? { checked: ariaChecked === "true" } : {},
-						...typeof selected === "boolean" ? { selected } : ariaSelected === "true" || ariaSelected === "false" ? { selected: ariaSelected === "true" } : {},
-						...typeof disabled === "boolean" ? { disabled } : ariaDisabled === "true" || ariaDisabled === "false" ? { disabled: ariaDisabled === "true" } : {},
-						...typeof required === "boolean" ? { required } : {},
-						...validity !== void 0 && typeof Reflect.get(validity, "valid") === "boolean" ? { valid: Reflect.get(validity, "valid") } : {},
-						...typeof formMatches === "function" ? { formValid: Reflect.apply(formMatches, form, [":valid"]) } : {}
-					};
-				});
-				const text = JSON.stringify({
-					pageText,
-					selectorMatchCount,
-					controls,
-					controlsTruncated
-				});
-				const observed = new TextEncoder().encode(text).byteLength;
-				return observed > maximum ? {
-					_tag: "OverLimit",
-					observed
-				} : {
-					_tag: "Text",
-					text
-				};
-			}, selector, maximumBytes, MAX_OBSERVED_CONTROLS));
-			if (observation._tag === "Text") Schema.decodeSync(PageObservation)(observation.text);
+			const observation = Schema.decodeUnknownSync(TextObservation)(await page.evaluate(observePage, void 0, selector, maximumBytes, MAX_OBSERVED_CONTROLS));
+			if (observation._tag === "Text") Schema.decodeSync(BrowserRunPageObservation)(observation.text);
 			return observation;
 		},
-		fill: (selector, value, signal, onDispatch) => runObservedPageAction(page, selector, signal, onDispatch, (element) => element.evaluate((element, nextValue) => {
+		fill: (selector, value, signal, onDispatch, onComplete, expectedTarget) => runObservedPageAction(page, selector, signal, onDispatch, (element) => expectedTarget !== void 0 ? guardedPageInput(element, expectedTarget, "fill", value) : element.evaluate((element, nextValue) => {
 			let prototype = Reflect.getPrototypeOf(element);
 			let setValue;
 			while (prototype !== null) {
@@ -801,12 +911,12 @@ const makeProductionPage = (page) => {
 				Reflect.apply(dispatchEvent, element, [new Event("input", { bubbles: true })]);
 				Reflect.apply(dispatchEvent, element, [new Event("change", { bubbles: true })]);
 			}
-		}, value)),
-		click: (selector, signal, onDispatch) => runObservedPageAction(page, selector, signal, onDispatch, (element) => element.click()),
-		selectFile: async (request, signal, onDispatch) => {
+		}, value), void 0, onComplete),
+		click: (selector, signal, onDispatch, onComplete, expectedTarget) => runObservedPageAction(page, selector, signal, onDispatch, (element) => expectedTarget === void 0 ? element.click() : guardedPageInput(element, expectedTarget, "click"), void 0, onComplete),
+		selectFile: async (request, signal, onDispatch, onComplete) => {
 			const selection = await prepareFileSelection(request, signal);
 			try {
-				return await runObservedPageAction(page, request.selector, signal, onDispatch, selection.select, selection.validate);
+				return await runObservedPageAction(page, request.selector, signal, onDispatch, selection.select, selection.validate, onComplete);
 			} finally {
 				await selection.close();
 			}
@@ -843,6 +953,20 @@ const makeProductionContext = (context, viewport) => ({
 	}
 });
 const makeProductionBrowser = (browser, viewport) => ({
+	detach: () => browser.disconnect(),
+	reattach: async (identity) => {
+		const context = browser.browserContexts().find((candidate) => candidate.id === identity.contextId);
+		if (context === void 0) return void 0;
+		const pages = await context.pages();
+		if (pages.length > 64) throw new Error("The browser target inventory exceeds its bound");
+		for (const candidate of pages) {
+			const page = makeProductionPage(candidate);
+			if ((await page.identity?.())?.targetId === identity.targetId) return {
+				context: makeProductionContext(context),
+				page
+			};
+		}
+	},
 	createContext: async () => makeProductionContext(await browser.createBrowserContext(), viewport),
 	close: async () => {
 		if (!browser.isConnected()) return;
@@ -866,26 +990,42 @@ const protocolError = (message, cause) => InteractiveBrowserProtocolError.make({
 	message,
 	...cause === void 0 ? {} : { cause }
 });
-const actionError = (operation, cause) => InteractiveBrowserActionError.make({
+const failReportedProtocol = (operation, error, evidence = error.evidence) => reportBrowserCause(operation, Cause.fail(error)).pipe(Effect.andThen(Effect.fail(reportedBrowserError(InteractiveBrowserProtocolError.make({
+	implementation: browserRunInteractiveImplementation,
+	message: error.message,
+	...evidence === void 0 ? {} : { evidence }
+})))));
+const actionError = (operation, cause, evidence) => InteractiveBrowserActionError.make({
 	implementation: browserRunInteractiveImplementation,
 	operation,
+	...evidence === void 0 ? {} : { evidence },
 	message: `The interactive browser ${operation} operation failed`,
 	...cause === void 0 ? {} : { cause }
 });
 const undispatchedActionError = (operation) => InteractiveBrowserActionError.make({
 	implementation: browserRunInteractiveImplementation,
 	operation,
-	message: `The interactive browser ${operation} operation was not dispatched`
+	message: `The interactive browser ${operation} operation was not dispatched`,
+	evidence: {
+		stage: "preparation",
+		dispatch: "not-dispatched",
+		session: "attached"
+	}
 });
 /** Recognizes a local pre-dispatch refusal without exposing selector or page content. */
-const isBrowserRunUndispatchedActionError = (error) => Schema.is(InteractiveBrowserActionError)(error) && error.implementation.identity === browserRunInteractiveImplementation.identity && (error.operation === "click" || error.operation === "fill") && error.message === `The interactive browser ${error.operation} operation was not dispatched`;
+const isBrowserRunUndispatchedActionError = (error) => Schema.is(InteractiveBrowserActionError)(error) && error.implementation.identity === browserRunInteractiveImplementation.identity && error.evidence?.dispatch === "not-dispatched";
 const policyError = (message) => InteractiveBrowserPolicyDeniedError.make({
 	implementation: browserRunInteractiveImplementation,
 	message
 });
-const expiredError = () => InteractiveBrowserExpiredError.make({
+const expiredError = (session = "lost") => InteractiveBrowserExpiredError.make({
 	implementation: browserRunInteractiveImplementation,
-	message: "The remote browser is no longer usable"
+	message: "The remote browser is no longer usable",
+	evidence: {
+		stage: "preparation",
+		dispatch: "not-dispatched",
+		session
+	}
 });
 const causeText = (cause) => {
 	if (cause instanceof Error) return cause.message.slice(0, 8e3);
@@ -893,6 +1033,7 @@ const causeText = (cause) => {
 };
 const isCapacityRefusal = (cause) => cause instanceof BrowserRunFailure && cause.status === 429;
 const isRemoteClosure = (cause) => /target closed|browser.*closed|session.*closed|connection.*closed|not connected|websocket.*closed/i.test(causeText(cause));
+const inputMayStillRun = (cause) => isRemoteClosure(cause) || cause instanceof Error && cause.name === "TimeoutError" || cause instanceof BrowserRunFailure && cause.reason === "timeout";
 const snapshotPolicy = Effect.fn("BrowserRunInteractive.snapshotPolicy")(function* (input) {
 	const decoded = yield* Schema.decodeEffect(InteractiveBrowserPolicy, { onExcessProperty: "error" })(input).pipe(Effect.mapError(() => policyError("The interactive browser policy is malformed")));
 	if (decoded.network._tag === "PublicWeb") return yield* InteractiveBrowserUnsupportedError.make({
@@ -956,9 +1097,28 @@ const withinDeadline = Effect.fn("BrowserRunInteractive.withinDeadline")(functio
 		orElse: () => Effect.sync(() => onTimeout?.()).pipe(Effect.andThen(deadlineError(policy, startedAt)))
 	}));
 });
+const trackPendingInput = (state, pending) => {
+	state.pendingInputs.add(pending);
+	pending.then(() => state.pendingInputs.delete(pending), (cause) => {
+		state.pendingInputs.delete(pending);
+		if (state.disconnected.value || inputMayStillRun(cause)) state.uncertain.value = true;
+		if (isRemoteClosure(cause)) state.disconnected.value = true;
+	});
+	return pending;
+};
+const makeHostInputObserver = Effect.fnUntraced(function* (state, operation) {
+	const reporterContext = yield* Effect.context();
+	return (pending, signal) => {
+		pending.then(void 0, (cause) => {
+			if (signal.aborted) return Effect.runPromiseWith(reporterContext)(reportBrowserCause(operation, Cause.fail(cause)));
+		});
+		return trackPendingInput(state, pending);
+	};
+});
 const stateFailure = (state) => {
 	if (state.violation.value !== void 0) return state.violation.value;
-	if (state.closed.value || state.disconnected.value || state.uncertain.value) return expiredError();
+	if (state.closed.value) return expiredError();
+	if (state.disconnected.value) return expiredError("disconnected");
 };
 var BrowserRunRemoteFailure = class {
 	cause;
@@ -1012,46 +1172,92 @@ const makeRequestListener = (policy, state) => (request) => {
 };
 const makeHandle = Effect.fn("BrowserRunInteractive.makeHandle")(function* (page, policy, startedAt, state, close) {
 	const permits = yield* Semaphore.make(1);
-	const actions = yield* Ref.make(0);
-	const remote = (operation, evaluate) => Effect.tryPromise({
-		try: evaluate,
-		catch: (cause) => new BrowserRunRemoteFailure(cause)
-	}).pipe(Effect.catch((failure) => {
-		const cause = failure.cause;
-		if (cause instanceof BrowserRunActionUndispatched) return Effect.logInfo("Browser interactive action was not dispatched").pipe(Effect.annotateLogs({
-			"browser.action": operation,
-			"browser.selector_match_count": cause.matchCount
-		}), Effect.andThen(Effect.fail(undispatchedActionError(operation))));
-		if (state.disconnected.value || isRemoteClosure(cause)) {
-			state.disconnected.value = true;
-			return Effect.fail(expiredError());
-		}
-		return Effect.fail(actionError(operation, cause));
-	}));
-	const observedAction = (operation, evaluate) => Effect.suspend(() => {
-		let dispatched = false;
-		let pending;
-		return remote(operation, (signal) => {
-			pending = evaluate(signal, () => {
-				dispatched = true;
-			});
-			return pending;
-		}).pipe(Effect.onInterrupt(() => Effect.gen(function* () {
-			state.uncertain.value = true;
-			yield* Effect.logWarning("Browser interactive action interrupted").pipe(Effect.annotateLogs({
+	let currentOperation;
+	let generation = 0;
+	let evidence = {
+		stage: "preparation",
+		dispatch: "not-dispatched",
+		session: "attached"
+	};
+	const reporterContext = yield* Effect.context();
+	const remote = (operation, evaluate, observed = false) => Effect.suspend(() => {
+		currentOperation = operation;
+		const mutating = operation !== "read-text" && operation !== "screenshot";
+		const currentGeneration = ++generation;
+		evidence = {
+			stage: observed ? "preparation" : mutating ? "input" : "observation",
+			dispatch: observed || !mutating ? "not-dispatched" : "running",
+			session: "attached"
+		};
+		return Effect.tryPromise({
+			try: (signal) => {
+				const pending = evaluate(signal);
+				if (mutating) trackPendingInput(state, pending);
+				pending.then(() => {
+					if (mutating && generation === currentGeneration) evidence = {
+						...evidence,
+						stage: "observation",
+						dispatch: "completed"
+					};
+				}, (cause) => {
+					if (state.disconnected.value || isRemoteClosure(cause)) {
+						state.disconnected.value = true;
+						if (mutating) state.uncertain.value = true;
+					}
+					if (generation === currentGeneration && evidence.dispatch === "running") evidence = {
+						...evidence,
+						dispatch: "unknown"
+					};
+					if (signal.aborted && !(cause instanceof BrowserRunActionUndispatched)) Effect.runPromiseWith(reporterContext)(reportBrowserCause("interactive.input.late", Cause.fail(cause)));
+				});
+				return pending;
+			},
+			catch: (cause) => new BrowserRunRemoteFailure(cause)
+		}).pipe(Effect.catch((failure) => {
+			if (failure.cause instanceof BrowserRunActionUndispatched) return Effect.logInfo("Browser interactive action was not dispatched").pipe(Effect.annotateLogs({
 				"browser.action": operation,
-				"browser.action_dispatched": dispatched,
-				"browser.action_outcome_unknown": dispatched
-			}));
-			const completion = pending;
-			if (completion !== void 0) yield* Effect.promise(() => boundedBestEffort(completion, 500));
-		})));
+				"browser.selector_match_count": failure.cause.matchCount
+			}), Effect.andThen(Effect.fail(undispatchedActionError(operation))));
+			if (mutating && inputMayStillRun(failure.cause)) state.uncertain.value = true;
+			if (isRemoteClosure(failure.cause)) {
+				state.disconnected.value = true;
+				if (mutating) state.uncertain.value = true;
+			}
+			evidence = {
+				...evidence,
+				dispatch: evidence.dispatch === "running" ? "unknown" : evidence.dispatch,
+				session: state.disconnected.value ? "disconnected" : "attached"
+			};
+			return reportBrowserCause(`interactive.${operation}.${evidence.stage}.${evidence.dispatch}`, Cause.fail(failure.cause)).pipe(Effect.andThen(Effect.fail(reportedBrowserError(actionError(operation, void 0, evidence)))));
+		}));
 	});
+	const observedAction = (operation, evaluate) => remote(operation, (signal) => {
+		const observedGeneration = generation;
+		return evaluate(signal, () => {
+			if (generation === observedGeneration) evidence = {
+				...evidence,
+				stage: "input",
+				dispatch: "running"
+			};
+		}, () => {
+			if (generation === observedGeneration) evidence = {
+				...evidence,
+				stage: "observation",
+				dispatch: "completed"
+			};
+		});
+	}, true).pipe(Effect.onInterrupt(() => Effect.logWarning("Browser interactive action interrupted").pipe(Effect.annotateLogs({
+		"browser.action": operation,
+		"browser.action_dispatched": evidence.dispatch !== "not-dispatched",
+		"browser.action_outcome_unknown": evidence.dispatch === "running" || evidence.dispatch === "unknown"
+	}))));
 	const decodeActionObservation = Effect.fn("BrowserRunInteractive.decodeActionObservation")(function* (raw) {
 		return yield* Schema.decodeUnknownEffect(ActionObservation)(raw).pipe(Effect.mapError((cause) => protocolError("The browser returned a malformed action observation", cause)));
 	});
 	const logActionObservation = (operation, observation) => Effect.logInfo("Browser interactive action observed").pipe(Effect.annotateLogs({
 		"browser.action": operation,
+		"browser.input_millis": observation.inputMillis,
+		"browser.observation_millis": observation.observationMillis,
 		"browser.selector_match_count": observation.before.matchCount,
 		...observation.before.kind === void 0 ? {} : { "browser.target_kind": observation.before.kind },
 		...observation.before.checked === void 0 ? {} : { "browser.target_checked_before": observation.before.checked },
@@ -1076,18 +1282,38 @@ const makeHandle = Effect.fn("BrowserRunInteractive.makeHandle")(function* (page
 		"browser.fetch_xhr_pending": observation.network.pending,
 		"browser.network_settle_timed_out": observation.network.settleTimedOut
 	}));
-	const run = (effect, preflight = Effect.void, consumeAction = true) => permits.withPermitsIfAvailable(1)(Effect.gen(function* () {
+	const run = (effect, preflight = Effect.void, consumeAction = true, mutating = true) => permits.withPermitsIfAvailable(1)(Effect.gen(function* () {
 		const unavailable = stateFailure(state);
-		if (unavailable !== void 0) return yield* unavailable;
+		if (unavailable !== void 0) {
+			if (unavailable._tag === "InteractiveBrowserProtocolError") {
+				yield* reportBrowserCause("interactive.policy", Cause.fail(unavailable));
+				const safe = reportedBrowserError(InteractiveBrowserProtocolError.make({
+					implementation: browserRunInteractiveImplementation,
+					message: unavailable.message,
+					evidence: unavailable.evidence ?? {
+						stage: "preparation",
+						dispatch: "not-dispatched",
+						session: "attached"
+					}
+				}));
+				if (state.violation.value === unavailable) state.violation.value = safe;
+				return yield* safe;
+			}
+			return yield* unavailable;
+		}
+		if (mutating && (state.uncertain.value || state.pendingInputs.size > 0)) return yield* InteractiveBrowserBusyError.make({
+			implementation: browserRunInteractiveImplementation,
+			message: "Earlier browser input has not been proven stopped"
+		});
+		currentOperation = void 0;
+		generation++;
 		yield* preflight;
 		if (consumeAction) {
-			const admitted = yield* Ref.modify(actions, (count) => count >= policy.maxActions ? [{
-				allowed: false,
-				observed: count + 1
-			}, count] : [{
-				allowed: true,
-				observed: count + 1
-			}, count + 1]);
+			const admitted = {
+				allowed: state.actions.value < policy.maxActions,
+				observed: state.actions.value + 1
+			};
+			if (admitted.allowed) state.actions.value++;
 			if (!admitted.allowed) return yield* InteractiveBrowserLimitError.make({
 				implementation: browserRunInteractiveImplementation,
 				limit: "actions",
@@ -1096,22 +1322,29 @@ const makeHandle = Effect.fn("BrowserRunInteractive.makeHandle")(function* (page
 				message: "The browser action limit was reached"
 			});
 		}
-		const completed = effect.pipe(Effect.catch((error) => {
-			const failure = stateFailure(state);
-			return Effect.fail(failure ?? error);
-		}), Effect.flatMap((result) => awaitPendingRequests(state).pipe(Effect.flatMap(() => {
+		const completed = effect.pipe(Effect.flatMap((result) => awaitPendingRequests(state).pipe(Effect.andThen(Effect.suspend(() => {
 			const failure = stateFailure(state);
 			return failure === void 0 ? Effect.succeed(result) : Effect.fail(failure);
-		}))));
-		return yield* withinDeadline(completed, policy, startedAt, () => {
-			state.uncertain.value = true;
-		}).pipe(Effect.onInterrupt(() => Effect.sync(() => {
-			state.uncertain.value = true;
-		})), Effect.catch((error) => {
-			if (Schema.is(InteractiveBrowserLimitError)(error) && error.limit === "elapsed") return Effect.fail(error);
-			const failure = stateFailure(state);
-			if (Schema.is(InteractiveBrowserActionError)(error) && !isBrowserRunUndispatchedActionError(error)) state.uncertain.value = true;
-			return Effect.fail(failure ?? error);
+		})))));
+		return yield* withinDeadline(completed, policy, startedAt).pipe(Effect.mapError((error) => currentOperation === void 0 ? error : error._tag === "InteractiveBrowserLimitError" ? InteractiveBrowserLimitError.make({
+			implementation: error.implementation,
+			limit: error.limit,
+			maximum: error.maximum,
+			observed: error.observed,
+			message: error.message,
+			evidence
+		}) : error._tag === "InteractiveBrowserPolicyDeniedError" ? InteractiveBrowserPolicyDeniedError.make({
+			implementation: error.implementation,
+			message: error.message,
+			evidence
+		}) : error), Effect.catchIf((error) => currentOperation !== void 0 && error._tag !== "InteractiveBrowserActionError" && error._tag !== "InteractiveBrowserLimitError" && error._tag !== "InteractiveBrowserPolicyDeniedError" && error._tag !== "InteractiveBrowserExpiredError", (error) => {
+			const safe = reportedBrowserError(error._tag === "InteractiveBrowserProtocolError" ? InteractiveBrowserProtocolError.make({
+				implementation: browserRunInteractiveImplementation,
+				message: error.message,
+				evidence
+			}) : actionError(currentOperation ?? "read-text", void 0, evidence));
+			if (state.violation.value === error) state.violation.value = safe;
+			return reportBrowserCause(`interactive.${currentOperation}.observation`, Cause.fail(error)).pipe(Effect.andThen(Effect.fail(safe)));
 		}));
 	})).pipe(Effect.flatMap(Effect.fromOption(() => InteractiveBrowserBusyError.make({
 		implementation: browserRunInteractiveImplementation,
@@ -1126,7 +1359,7 @@ const makeHandle = Effect.fn("BrowserRunInteractive.makeHandle")(function* (page
 			readText: (request) => run(Effect.gen(function* () {
 				const raw = yield* remote("read-text", () => page.readText(request.selector, policy.maxReturnedBytes));
 				const observation = yield* Schema.decodeUnknownEffect(TextObservation)(raw).pipe(Effect.mapError((cause) => protocolError("The browser returned a malformed text observation", cause)));
-				if (observation._tag === "MissingElement") return yield* actionError("read-text");
+				if (observation._tag === "MissingElement") return yield* actionError("read-text", void 0, evidence);
 				if (observation._tag === "OverLimit") return yield* InteractiveBrowserLimitError.make({
 					implementation: browserRunInteractiveImplementation,
 					limit: "returned-bytes",
@@ -1143,19 +1376,19 @@ const makeHandle = Effect.fn("BrowserRunInteractive.makeHandle")(function* (page
 					message: "The browser returned-text limit was reached"
 				});
 				return yield* Schema.decodeEffect(BrowserTextResult)({ text: observation.text }).pipe(Effect.mapError((cause) => protocolError("The browser returned malformed page text", cause)));
-			})),
+			}), Effect.void, true, false),
 			fill: (request) => run(Effect.gen(function* () {
-				const observation = yield* observedAction("fill", (signal, onDispatch) => page.fill(request.selector, request.value, signal, onDispatch)).pipe(Effect.flatMap(decodeActionObservation));
+				const observation = yield* observedAction("fill", (signal, onDispatch, onComplete) => page.fill(request.selector, request.value, signal, onDispatch, onComplete, request.expectedTarget)).pipe(Effect.flatMap(decodeActionObservation));
 				yield* logActionObservation("fill", observation);
 				return yield* decodeActionResult(page, policy);
 			})),
 			click: (request) => run(Effect.gen(function* () {
-				const observation = yield* observedAction("click", (signal, onDispatch) => page.click(request.selector, signal, onDispatch)).pipe(Effect.flatMap(decodeActionObservation));
+				const observation = yield* observedAction("click", (signal, onDispatch, onComplete) => page.click(request.selector, signal, onDispatch, onComplete, request.expectedTarget)).pipe(Effect.flatMap(decodeActionObservation));
 				yield* logActionObservation("click", observation);
 				return yield* decodeActionResult(page, policy);
 			})),
 			selectFile: (request) => Schema.decodeEffect(BrowserSelectFileRequest)(request).pipe(Effect.mapError(() => policyError("The browser file selection request is malformed")), Effect.flatMap((decoded) => run(Effect.gen(function* () {
-				const observation = yield* observedAction("select-file", (signal, onDispatch) => page.selectFile(decoded, signal, onDispatch)).pipe(Effect.flatMap(decodeActionObservation));
+				const observation = yield* observedAction("select-file", (signal, onDispatch, onComplete) => page.selectFile(decoded, signal, onDispatch, onComplete)).pipe(Effect.flatMap(decodeActionObservation));
 				yield* logActionObservation("select-file", observation);
 				const result = yield* decodeActionResult(page, policy);
 				return BrowserFileSelectionResult.make({
@@ -1180,7 +1413,7 @@ const makeHandle = Effect.fn("BrowserRunInteractive.makeHandle")(function* (page
 					mediaType: "image/png",
 					bytes: new Uint8Array(bytes)
 				}).pipe(Effect.mapError(() => protocolError("The browser returned a malformed PNG screenshot")));
-			}), decodeActionResult(page, policy).pipe(Effect.asVoid)))),
+			}), decodeActionResult(page, policy).pipe(Effect.asVoid), true, false))),
 			scroll: (request) => Schema.decodeEffect(BrowserScrollRequest)(request).pipe(Effect.mapError(() => policyError("The browser scroll request is malformed")), Effect.flatMap((decoded) => run(remote("scroll", () => page.scroll(decoded.deltaX, decoded.deltaY)).pipe(Effect.andThen(decodeActionResult(page, policy))), decodeActionResult(page, policy).pipe(Effect.asVoid)))),
 			close
 		},
@@ -1217,6 +1450,7 @@ const runTeardown = (entries) => Effect.forEach([...entries].reverse(), (entry)
 }))).pipe(Effect.map((failures) => failures.filter((failure) => failure !== void 0)));
 const cdpCommand = (page, state, command, parameters, output, malformedMessage) => Effect.scoped(Effect.gen(function* () {
 	const cleanupContext = yield* Effect.context();
+	const observeInput = yield* makeHostInputObserver(state, "interactive.control.late");
 	const cdp = yield* Effect.acquireRelease(Effect.tryPromise({
 		try: (signal) => {
 			const pending = closeLateAcquisition(signal, page.createCdpSession, (acquired) => Effect.runPromiseWith(cleanupContext)(Effect.tryPromise({
@@ -1231,13 +1465,19 @@ const cdpCommand = (page, state, command, parameters, output, malformedMessage)
 		catch: (cause) => state.disconnected.value || isRemoteClosure(cause) ? expiredError() : protocolError("Creating the Cloudflare browser control session failed", cause)
 	}), (acquired) => closeWithWarning(acquired.detach, "Detaching the Cloudflare browser control session failed"), { interruptible: true });
 	const raw = yield* Effect.tryPromise({
-		try: () => cdp.send(command, parameters),
+		try: (signal) => {
+			const pending = cdp.send(command, parameters);
+			return command === "Cloudflare.getHandoffState" ? pending : observeInput(pending, signal);
+		},
 		catch: (cause) => state.disconnected.value || isRemoteClosure(cause) ? expiredError() : protocolError("The Cloudflare browser control command failed", cause)
 	});
 	return yield* Schema.decodeUnknownEffect(output)(raw).pipe(Effect.catch((error) => reportBrowserCause("interactive.command.decode", Cause.fail(error)).pipe(Effect.andThen(Effect.fail(reportedBrowserError(protocolError(malformedMessage)))))));
-}));
+})).pipe(Effect.catchTag("InteractiveBrowserProtocolError", (error) => failReportedProtocol("interactive.control", error)));
 const makeHostService = (binding) => {
-	const closeSession = binding.closeSession;
+	const owners = /* @__PURE__ */ new Map();
+	const closeSession = (sessionId) => binding.closeSession(sessionId).pipe(Effect.tap(() => Effect.sync(() => {
+		owners.delete(Redacted.value(sessionId));
+	})));
 	const terminate = Effect.fn("BrowserRunInteractiveHost.terminate")(function* (sessionId, entries) {
 		const deadline = (yield* Clock.currentTimeMillis) + 1e4;
 		yield* closeSession(sessionId).pipe(Effect.interruptible, Effect.timeoutOrElse({
@@ -1255,10 +1495,10 @@ const makeHostService = (binding) => {
 		}).pipe(Effect.flatMap(Schema.decodeUnknownEffect(BrowserRunSessionId)), Effect.mapError((cause) => actionError("close", cause)), Effect.onError(() => closeWithWarning(browser.close, "Closing an unidentified browser failed")));
 		yield* terminate(Redacted.make(sessionId), [closeEntry(browser.close, "Closing the local browser connection failed")]);
 	});
-	const acquire = Effect.fn("BrowserRunInteractiveHost.acquire")(function* (policy) {
+	const acquire = Effect.fn("BrowserRunInteractiveHost.acquire")(function* (policy, resume, pendingInput = false) {
 		const scope = yield* Scope.Scope;
 		const fixedPolicy = yield* snapshotPolicy(policy);
-		const startedAt = yield* Effect.clockWith((clock) => clock.currentTimeMillis);
+		const startedAt = resume?.startedAt ?? (yield* Clock.currentTimeMillis);
 		const runCleanup = (effect) => Effect.runPromiseWith(cleanupContext)(effect.pipe(Effect.tapCause((cause) => reportBrowserCause("interactive.lateCleanup", cause))));
 		const cleanupContext = yield* Effect.context();
 		const observeLate = (signal, pending) => {
@@ -1270,29 +1510,56 @@ const makeHostService = (binding) => {
 		const state = {
 			closed: { value: false },
 			disconnected: { value: false },
-			uncertain: { value: false },
+			uncertain: { value: pendingInput || resume !== void 0 && resume.inputState !== "idle" },
+			pendingInputs: /* @__PURE__ */ new Set(),
+			actions: { value: resume?.consumedActions ?? 0 },
 			violation: { value: void 0 },
 			pendingRequests: /* @__PURE__ */ new Set()
 		};
-		const lifecycle = { managedTeardownInstalled: false };
+		const lifecycle = {
+			managedTeardownInstalled: false,
+			retained: resume !== void 0
+		};
 		const closers = [];
-		const releaseBeforeManaged = (entry) => Effect.suspend(() => lifecycle.managedTeardownInstalled ? Effect.void : entry.close.pipe(Effect.catchCause((cause) => reportBrowserCause("interactive.cleanup", cause).pipe(Effect.andThen(Effect.logWarning(entry.warning))))));
-		const sessionIdValue = yield* Effect.acquireRelease(withinDeadline(Effect.tryPromise({
+		const releaseBeforeManaged = (entry) => Effect.suspend(() => lifecycle.managedTeardownInstalled || lifecycle.retained ? Effect.void : entry.close.pipe(Effect.catchCause((cause) => reportBrowserCause("interactive.cleanup", cause).pipe(Effect.andThen(Effect.logWarning(entry.warning))))));
+		const sessionIdValue = yield* Effect.acquireRelease(withinDeadline(resume === void 0 ? Effect.tryPromise({
 			try: (signal) => observeLate(signal, closeLateAcquisition(signal, () => binding.acquire(keepAliveMillis(fixedPolicy)), (id) => runCleanup(Schema.decodeUnknownEffect(BrowserRunSessionId)(id).pipe(Effect.flatMap((value) => terminate(Redacted.make(value), [])))))),
 			catch: (cause) => isCapacityRefusal(cause) ? InteractiveBrowserCapacityError.make({
 				implementation: browserRunInteractiveImplementation,
 				message: "Browser Run has no capacity for a new browser session"
 			}) : protocolError("Acquiring the Browser Run session failed", cause)
-		}).pipe(Effect.flatMap(Schema.decodeUnknownEffect(BrowserRunSessionId)), Effect.catchTag("SchemaError", () => protocolError("The Browser Run session identity was malformed"))), fixedPolicy, startedAt), (id) => Effect.suspend(() => {
+		}).pipe(Effect.flatMap(Schema.decodeUnknownEffect(BrowserRunSessionId)), Effect.catchTag("SchemaError", () => protocolError("The Browser Run session identity was malformed"))) : Effect.succeed(Redacted.value(resume.sessionId)), fixedPolicy, startedAt), (id) => Effect.suspend(() => {
 			state.closed.value = true;
 			state.disconnected.value = true;
-			return lifecycle.managedTeardownInstalled ? Effect.void : terminate(Redacted.make(id), []).pipe(Effect.catchCause((cause) => reportBrowserCause("interactive.close", cause).pipe(Effect.andThen(Effect.logWarning("Whole-browser cleanup remains unconfirmed")))));
+			return lifecycle.managedTeardownInstalled || lifecycle.retained ? Effect.void : terminate(Redacted.make(id), []).pipe(Effect.catchCause((cause) => reportBrowserCause("interactive.close", cause).pipe(Effect.andThen(Effect.logWarning("Whole-browser cleanup remains unconfirmed")))));
 		}), { interruptible: true });
+		const owner = Symbol();
+		const releaseOwner = () => {
+			if (owners.get(sessionIdValue) === owner) owners.delete(sessionIdValue);
+		};
 		const connect = yield* Effect.cached(Effect.gen(function* () {
+			if (owners.has(sessionIdValue)) return yield* InteractiveBrowserBusyError.make({
+				implementation: browserRunInteractiveImplementation,
+				message: "The previous local browser owner must detach before resuming"
+			});
+			yield* Effect.acquireRelease(Effect.sync(() => {
+				owners.set(sessionIdValue, owner);
+			}), () => Effect.sync(() => {
+				if (!lifecycle.managedTeardownInstalled) releaseOwner();
+			}));
 			const browser = yield* Effect.acquireRelease(withinDeadline(Effect.tryPromise({
-				try: (signal) => observeLate(signal, closeLateAcquisition(signal, () => binding.connect(sessionIdValue), (acquired) => runCleanup(closeAcquired(acquired)))),
-				catch: (cause) => protocolError("Connecting to the Browser Run session failed", cause)
-			}), fixedPolicy, startedAt), (acquired) => releaseBeforeManaged(closeEntry(acquired.close, "Closing the local browser connection failed")), { interruptible: true });
+				try: (signal) => observeLate(signal, closeLateAcquisition(signal, () => binding.connect(sessionIdValue), (acquired) => runCleanup(resume === void 0 ? closeAcquired(acquired) : closeEntry(acquired.detach ?? (async () => {}), "Detaching the browser failed").close))),
+				catch: (cause) => resume !== void 0 && cause instanceof BrowserRunFailure && (cause.status === 404 || cause.status === 410) ? expiredError() : protocolError("Connecting to the Browser Run session failed", cause)
+			}).pipe(Effect.timeoutOrElse({
+				duration: "10 seconds",
+				orElse: () => Effect.fail(protocolError("Connecting to the Browser Run session timed out"))
+			})), fixedPolicy, startedAt), (acquired) => lifecycle.managedTeardownInstalled ? Effect.void : lifecycle.retained ? closeEntry(acquired.detach ?? (async () => {}), "Detaching the browser failed").close.pipe(Effect.tap(() => Effect.sync(releaseOwner)), Effect.catchCause((cause) => reportBrowserCause("interactive.detach", cause))) : releaseBeforeManaged(closeEntry(acquired.close, "Closing the local browser connection failed")), { interruptible: true });
+			if (resume !== void 0) {
+				if ((yield* Effect.try({
+					try: browser.sessionId,
+					catch: (cause) => protocolError("Reading the reattached browser identity failed", cause)
+				})) !== sessionIdValue) return yield* protocolError("The reattached browser session identity did not match");
+			}
 			closers.push(closeEntry(browser.close, "Closing the interactive browser failed"));
 			const disconnected = () => {
 				state.disconnected.value = true;
@@ -1309,21 +1576,32 @@ const makeHostService = (binding) => {
 				state.disconnected.value = true;
 				return yield* expiredError();
 			}
-			const context = yield* Effect.acquireRelease(withinDeadline(Effect.tryPromise({
+			const reattached = resume === void 0 ? void 0 : yield* withinDeadline(Effect.tryPromise({
+				try: async () => {
+					if (browser.reattach === void 0 || browser.detach === void 0) throw new Error("The browser binding does not support exact reattachment");
+					return await browser.reattach(resume.page);
+				},
+				catch: (cause) => protocolError("Reattaching the exact browser page failed", cause)
+			}).pipe(Effect.timeoutOrElse({
+				duration: "10 seconds",
+				orElse: () => Effect.fail(protocolError("Reattaching the exact browser page timed out"))
+			})), fixedPolicy, startedAt);
+			if (resume !== void 0 && reattached === void 0) return yield* expiredError();
+			const context = reattached?.context ?? (yield* Effect.acquireRelease(withinDeadline(Effect.tryPromise({
 				try: (signal) => observeLate(signal, closeLateAcquisition(signal, browser.createContext, (acquired) => runCleanup(Effect.tryPromise({
 					try: () => acquired.close(),
 					catch: (cause) => actionError("close", cause)
 				})))),
 				catch: (cause) => state.disconnected.value || isRemoteClosure(cause) ? expiredError() : protocolError("Creating the browser context failed", cause)
-			}), fixedPolicy, startedAt), (acquired) => releaseBeforeManaged(closeEntry(acquired.close, "Closing the interactive browser context failed")), { interruptible: true });
+			}), fixedPolicy, startedAt), (acquired) => releaseBeforeManaged(closeEntry(acquired.close, "Closing the interactive browser context failed")), { interruptible: true }));
 			closers.push(closeEntry(context.close, "Closing the interactive browser context failed"));
-			const page = yield* Effect.acquireRelease(withinDeadline(Effect.tryPromise({
+			const page = reattached?.page ?? (yield* Effect.acquireRelease(withinDeadline(Effect.tryPromise({
 				try: (signal) => observeLate(signal, closeLateAcquisition(signal, context.newPage, (acquired) => runCleanup(Effect.tryPromise({
 					try: () => acquired.close(),
 					catch: (cause) => actionError("close", cause)
 				})))),
 				catch: (cause) => state.disconnected.value || isRemoteClosure(cause) ? expiredError() : protocolError("Creating the browser page failed", cause)
-			}), fixedPolicy, startedAt), (acquired) => releaseBeforeManaged(closeEntry(acquired.close, "Closing the interactive browser page failed")), { interruptible: true });
+			}), fixedPolicy, startedAt), (acquired) => releaseBeforeManaged(closeEntry(acquired.close, "Closing the interactive browser page failed")), { interruptible: true }));
 			closers.push(closeEntry(page.close, "Closing the interactive browser page failed"));
 			yield* withinDeadline(Effect.tryPromise({
 				try: () => page.setBypassServiceWorker(true),
@@ -1342,27 +1620,66 @@ const makeHostService = (binding) => {
 			yield* withinDeadline(awaitPendingRequests(state), fixedPolicy, startedAt);
 			const setupFailure = stateFailure(state);
 			if (setupFailure !== void 0) return yield* setupFailure;
+			const detach = yield* Effect.cached(Effect.uninterruptible(Effect.gen(function* () {
+				if (browser.detach === void 0) return yield* protocolError("The browser binding does not support detachment");
+				lifecycle.retained = true;
+				state.closed.value = true;
+				state.disconnected.value = true;
+				if (state.pendingInputs.size > 0) state.uncertain.value = true;
+				yield* closeEntry(async () => {
+					page.offRequest(requestListener);
+					browser.offDisconnected(disconnected);
+					await browser.detach?.();
+				}, "Detaching the browser transport failed").close;
+				releaseOwner();
+			}).pipe(Effect.catchTag("InteractiveBrowserActionError", (error) => reportBrowserCause("interactive.detach", Cause.fail(error)).pipe(Effect.andThen(Effect.fail(reportedBrowserError(actionError("close")))))), Effect.catchTag("InteractiveBrowserProtocolError", (error) => failReportedProtocol("interactive.detach", error)))));
 			const teardown = yield* Effect.uninterruptible(Effect.gen(function* () {
 				const cached = yield* Effect.cached(terminate(Redacted.make(sessionIdValue), closers).pipe(Effect.tapCause((cause) => reportBrowserCause("interactive.close", cause)), Effect.mapError(reportedBrowserError)));
 				lifecycle.managedTeardownInstalled = true;
+				lifecycle.retained = false;
 				yield* Effect.addFinalizer(() => Effect.uninterruptible(Effect.sync(() => {
 					state.closed.value = true;
 					state.disconnected.value = true;
-				}).pipe(Effect.andThen(cached), Effect.catchCause((cause) => reportBrowserCause("interactive.close", cause).pipe(Effect.andThen(Effect.logWarning("Whole-browser cleanup remains unconfirmed")))))));
+				}).pipe(Effect.andThen(Effect.suspend(() => lifecycle.retained ? detach : cached)), Effect.catchCause((cause) => reportBrowserCause("interactive.close", cause).pipe(Effect.andThen(Effect.logWarning("Whole-browser cleanup remains unconfirmed")))))));
 				return cached;
 			}));
-			const close = Effect.uninterruptible(Effect.sync(() => {
+			const close = Effect.uninterruptible(Effect.suspend(() => {
+				if (lifecycle.retained || owners.get(sessionIdValue) !== owner) return Effect.void;
 				state.closed.value = true;
 				state.disconnected.value = true;
-			}).pipe(Effect.andThen(teardown)));
+				return teardown;
+			}));
 			const runtime = yield* makeHandle(page, fixedPolicy, startedAt, state, close);
 			const currentPagePreflight = decodeActionResult(page, fixedPolicy).pipe(Effect.asVoid);
 			const requestFitsSession = (requestedMillis) => remainingMillis(fixedPolicy, startedAt).pipe(Effect.flatMap((remaining) => remaining > 0 && requestedMillis <= remaining ? Effect.void : Effect.fail(policyError("The host browser request exceeds the remaining session time"))));
+			const inputState = Effect.sync(() => state.uncertain.value ? "unknown" : state.pendingInputs.size > 0 ? "running" : "idle");
+			const pageIdentity = yield* Effect.cached(Effect.tryPromise({
+				try: async () => {
+					if (page.identity === void 0) throw new Error("The browser binding does not expose page identity");
+					return await page.identity();
+				},
+				catch: (cause) => protocolError("Reading the exact browser page identity failed", cause)
+			}).pipe(Effect.catchTag("InteractiveBrowserProtocolError", (error) => failReportedProtocol("interactive.checkpoint", error))));
+			const observeResize = yield* makeHostInputObserver(state, "interactive.resize.late");
 			return {
 				handle: runtime.handle,
+				checkpoint: withinDeadline(Effect.gen(function* () {
+					const identity = resume?.page ?? (yield* pageIdentity);
+					return BrowserRunInteractiveCheckpoint.make({
+						sessionId: Redacted.make(sessionIdValue),
+						page: identity,
+						policy: InteractiveBrowserPolicy.make(fixedPolicy),
+						startedAt,
+						consumedActions: state.actions.value,
+						inputState: yield* inputState
+					});
+				}), fixedPolicy, startedAt),
+				detach,
+				inputState,
+				drainInput: Effect.suspend(() => Effect.promise(() => boundedBestEffort(Promise.allSettled(state.pendingInputs), 500)).pipe(Effect.andThen(inputState))),
 				sessionId: Redacted.make(sessionIdValue),
 				resizeViewport: (viewport) => decodeViewport(viewport).pipe(Effect.flatMap((decoded) => runtime.run(Effect.tryPromise({
-					try: () => page.setViewport(decoded),
+					try: (signal) => observeResize(page.setViewport(decoded), signal),
 					catch: (cause) => {
 						if (state.disconnected.value || isRemoteClosure(cause)) {
 							state.disconnected.value = true;
@@ -1370,11 +1687,11 @@ const makeHostService = (binding) => {
 						}
 						return protocolError("Resizing the browser viewport failed", cause);
 					}
-				}), currentPagePreflight, false))),
+				}).pipe(Effect.catchTag("InteractiveBrowserProtocolError", (error) => failReportedProtocol("interactive.resize", error))), currentPagePreflight, false))),
 				getLiveView: (request) => Schema.decodeEffect(BrowserRunLiveViewRequest)(request).pipe(Effect.mapError(() => policyError("The Live View request is malformed")), Effect.flatMap((decoded) => runtime.run(cdpCommand(page, state, "Cloudflare.getLiveView", {
 					mode: decoded.mode,
 					expiresInMs: decoded.expiresInMs
-				}, LiveViewObservation, "Cloudflare returned a malformed Live View response").pipe(Effect.flatMap((observation) => Schema.decodeEffect(BrowserRunLiveViewResult)({ devtoolsFrontendUrl: Redacted.make(observation.devtoolsFrontendUrl) }).pipe(Effect.mapError(() => protocolError("Cloudflare returned a malformed Live View response"))))), currentPagePreflight.pipe(Effect.andThen(requestFitsSession(decoded.expiresInMs)))))),
+				}, LiveViewObservation, "Cloudflare returned a malformed Live View response").pipe(Effect.flatMap((observation) => Schema.decodeEffect(BrowserRunLiveViewResult)({ devtoolsFrontendUrl: Redacted.make(observation.devtoolsFrontendUrl) }).pipe(Effect.mapError(() => protocolError("Cloudflare returned a malformed Live View response"))))), currentPagePreflight.pipe(Effect.andThen(requestFitsSession(decoded.expiresInMs))), true, true))),
 				handoff: (request) => Schema.decodeEffect(BrowserRunHandoffRequest)(request).pipe(Effect.mapError(() => policyError("The browser handoff request is malformed")), Effect.flatMap((decoded) => runtime.run(cdpCommand(page, state, "Cloudflare.handoff", {
 					instructions: decoded.instructions,
 					timeout: decoded.timeout
@@ -1383,7 +1700,7 @@ const makeHostService = (binding) => {
 					active: observation.active,
 					...observation.handoffId === void 0 ? {} : { handoffId: Redacted.make(observation.handoffId) },
 					...observation.durationMs === void 0 ? {} : { durationMs: observation.durationMs }
-				}).pipe(Effect.mapError(() => protocolError("Cloudflare returned a malformed browser handoff state"))))), currentPagePreflight),
+				}).pipe(Effect.mapError(() => protocolError("Cloudflare returned a malformed browser handoff state"))))), currentPagePreflight, true, false),
 				close
 			};
 		}).pipe(Effect.provideService(Scope.Scope, scope)));
@@ -1395,6 +1712,11 @@ const makeHostService = (binding) => {
 	return BrowserRunInteractiveHost.of({
 		acquire,
 		open: (policy) => acquire(policy).pipe(Effect.flatMap((acquired) => acquired.connect)),
+		resume: (checkpoint, options) => Schema.decodeEffect(Schema.toType(BrowserRunInteractiveCheckpoint))(checkpoint).pipe(Effect.mapError(() => policyError("The browser checkpoint is malformed")), Effect.flatMap((decoded) => acquire(decoded.policy, decoded, options.pendingInput)), Effect.flatMap((acquired) => acquired.connect), Effect.catchTag("InteractiveBrowserProtocolError", (error) => failReportedProtocol("interactive.resume", error, {
+			stage: "preparation",
+			dispatch: "not-dispatched",
+			session: "disconnected"
+		}))),
 		closeSession,
 		cleanupSemantics: "confirmed-terminal"
 	});
@@ -1422,6 +1744,6 @@ const CloudflareInteractiveBrowser = {
 	hostLayer: (options) => browserRunInteractiveHostLayer().pipe(Layer.provide(interactiveBindingLayer(options)))
 };
 //#endregion
-export { BrowserRunFailure as _, BrowserRunInteractiveHost as a, reportBrowserCause as b, BrowserRunViewport as c, browserRunInteractiveImplementation as d, browserRunInteractiveLayer as f, BrowserRunBinding as g, BrowserRunSessionLifecycle as h, BrowserRunInteractiveBinding as i, CloudflareInteractiveBrowser as l, BrowserRunCleanupError as m, BrowserRunHandoffResult as n, BrowserRunLiveViewRequest as o, isBrowserRunUndispatchedActionError as p, BrowserRunHandoffState as r, BrowserRunLiveViewResult as s, BrowserRunHandoffRequest as t, browserRunInteractiveHostLayer as u, browserFailure as v, reportedBrowserError as x, inheritBrowserReport as y };
+export { reportBrowserCause as C, inheritBrowserReport as S, BrowserRunCleanupError as _, BrowserRunInteractiveCheckpoint as a, BrowserRunFailure as b, BrowserRunLiveViewResult as c, BrowserRunViewport as d, CloudflareInteractiveBrowser as f, isBrowserRunUndispatchedActionError as g, browserRunInteractiveLayer as h, BrowserRunInteractiveBinding as i, BrowserRunPageIdentity as l, browserRunInteractiveImplementation as m, BrowserRunHandoffResult as n, BrowserRunInteractiveHost as o, browserRunInteractiveHostLayer as p, BrowserRunHandoffState as r, BrowserRunLiveViewRequest as s, BrowserRunHandoffRequest as t, BrowserRunPageObservation as u, BrowserRunSessionLifecycle as v, reportedBrowserError as w, browserFailure as x, BrowserRunBinding as y };
 
-//# sourceMappingURL=InteractiveBrowser-l6J4eP6T.mjs.map
+//# sourceMappingURL=InteractiveBrowser-CBUFAECo.mjs.map