@effect-agent/platform-cloudflare 0.1.0-beta.106 → 0.1.0-beta.108

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

@@ -1,9 +1,173 @@
-import { Clock, Context, Duration, Effect, Layer, Option, Redacted, Ref, Schema, Scope, Semaphore, Stream } from "effect";
+import { Cause, Clock, Context, Data, Duration, Effect, Encoding, ErrorReporter, Layer, Option, Predicate, Redacted, Ref, 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, BrowserNavigationResult, BrowserScreenshotRequest, BrowserScrollRequest, BrowserTextResult, InteractiveBrowser, InteractiveBrowserActionError, InteractiveBrowserBusyError, InteractiveBrowserCapacityError, InteractiveBrowserExpiredError, InteractiveBrowserLimitError, InteractiveBrowserPolicy, InteractiveBrowserPolicyDeniedError, InteractiveBrowserProtocolError, InteractiveBrowserTargetUrl, InteractiveBrowserUnsupportedError } from "effect-agent/interactive-browser";
+import { BrowserActionResult, 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") {
+	[ErrorReporter.severity] = "Error";
+};
+/** A public projection of an already reported private failure must not produce another issue. */
+const reportedBrowserError = (error) => Object.assign(error, { [ErrorReporter.ignore]: true });
+const inheritBrowserReport = (original, error) => ErrorReporter.isIgnored(original) ? reportedBrowserError(error) : error;
+const reasonSchema = Schema.Literals([
+	"provider",
+	"timeout",
+	"malformed",
+	"configuration",
+	"authorization",
+	"rate-limited",
+	"pending"
+]);
+const statusSchema = Schema.Int.check(Schema.isBetween({
+	minimum: 100,
+	maximum: 599
+}));
+const failureNames = /* @__PURE__ */ new Set([
+	"TypeError",
+	"RangeError",
+	"SyntaxError",
+	"TimeoutError",
+	"SchemaError"
+]);
+const browserFailure = (operation, cause) => cause instanceof BrowserRunFailure ? cause : new BrowserRunFailure({
+	operation,
+	reason: Predicate.isObject(cause) && "reason" in cause && Schema.is(reasonSchema)(cause.reason) ? cause.reason : "provider",
+	...Predicate.isObject(cause) && "status" in cause && Schema.is(statusSchema)(cause.status) ? { status: cause.status } : {},
+	...Predicate.isObject(cause) && "cause" in cause && cause.cause instanceof BrowserRunFailure ? { cause: cause.cause } : Predicate.isObject(cause) && "name" in cause && typeof cause.name === "string" && failureNames.has(cause.name) ? { cause: { name: cause.name } } : {}
+});
+/** Keep mixed defects and interruptions distinct while discarding all foreign diagnostic content. */
+const reportBrowserCause = (operation, cause) => ErrorReporter.report(Cause.fromReasons(cause.reasons.filter((reason) => !Cause.isFailReason(reason) || !ErrorReporter.isIgnored(reason.error)).map((reason) => {
+	switch (reason._tag) {
+		case "Fail": return Cause.makeFailReason(browserFailure(operation, reason.error));
+		case "Die": return Cause.makeDieReason(browserFailure(operation, reason.defect));
+		case "Interrupt": return reason;
+	}
+})));
+//#endregion
+//#region src/internal/browser-binding.ts
+const Acquired = Schema.Struct({ sessionId: Schema.String.check(Schema.isUUID()) });
+/** Native transport port shared by both scoped adapters; the Layer owns the foreign binding. */
+var BrowserRunBinding = class extends Context.Service()("@effect-agent/platform-cloudflare/internal/BrowserRunBinding") {
+	static layer(browser) {
+		return Layer.succeed(this)({
+			acquire: async (keepAliveMillis, operation) => {
+				const response = await browser.fetch(`https://browser-rendering.cloudflare.com/v1/devtools/browser?keep_alive=${keepAliveMillis}&recording=false`, { method: "POST" });
+				if (response.status !== 200) {
+					const failure = new BrowserRunFailure({
+						operation,
+						reason: "provider",
+						status: response.status
+					});
+					try {
+						await response.body?.cancel();
+					} catch {}
+					throw failure;
+				}
+				return Schema.decodeUnknownSync(Acquired)(await response.json()).sessionId;
+			},
+			connect: async (sessionId, operation) => {
+				let failure;
+				try {
+					return await puppeteer.connect({ fetch: async (input, init) => {
+						try {
+							const response = await browser.fetch(input, init);
+							if (response.status !== 101) {
+								failure = new BrowserRunFailure({
+									operation,
+									reason: "provider",
+									status: response.status
+								});
+								await response.body?.cancel();
+								throw failure;
+							}
+							return response;
+						} catch (cause) {
+							failure ??= browserFailure(operation, cause);
+							throw failure;
+						}
+					} }, sessionId);
+				} catch (cause) {
+					throw failure ?? browserFailure(operation, cause);
+				}
+			}
+		});
+	}
+};
+//#endregion
+//#region src/internal/browser-file-selection.ts
+function setFileSelection(element, encoded, name, type) {
+	if (Reflect.get(element, "type") !== "file" || Reflect.get(element, "disabled") || Reflect.get(element, "webkitdirectory")) throw new Error("The target is not an enabled file input");
+	const bytes = Uint8Array.from(atob(encoded), (character) => character.charCodeAt(0));
+	const transfer = new (Reflect.get(globalThis, "DataTransfer"))();
+	transfer.items.add(new File([bytes], name, { type }));
+	Reflect.set(element, "files", transfer.files);
+	const selected = Reflect.get(element, "files");
+	if (selected?.length !== 1 || selected[0]?.size !== bytes.length || selected[0]?.name !== name || selected[0]?.type !== type) throw new Error("The input did not retain the selected file");
+	const dispatch = Reflect.get(element, "dispatchEvent");
+	Reflect.apply(dispatch, element, [new Event("input", { bubbles: true })]);
+	Reflect.apply(dispatch, element, [new Event("change", { bubbles: true })]);
+}
+const makeFileSelection = (page) => async (request, signal) => {
+	const encoded = Encoding.encodeBase64(request.bytes);
+	const session = request.target === "chooser" ? await page.createCDPSession() : void 0;
+	if (session !== void 0) try {
+		await session.send("Page.enable");
+		await session.send("Page.setInterceptFileChooserDialog", { enabled: true });
+	} catch (cause) {
+		await session.detach();
+		throw cause;
+	}
+	const select = async (element) => {
+		if (session === void 0) return element.evaluate(setFileSelection, encoded, request.fileName, request.mediaType);
+		let onOpened = () => {};
+		let onAbort = () => {};
+		let timer;
+		const opened = new Promise((resolve, reject) => {
+			onOpened = (event) => event.backendNodeId === void 0 ? reject(/* @__PURE__ */ new Error("The chooser has no file input")) : resolve(event.backendNodeId);
+			onAbort = () => reject(/* @__PURE__ */ new Error("File selection interrupted"));
+			session.on("Page.fileChooserOpened", onOpened);
+			signal.addEventListener("abort", onAbort, { once: true });
+			timer = setTimeout(() => reject(/* @__PURE__ */ new Error("No file chooser opened")), 5e3);
+			if (signal.aborted) onAbort();
+		});
+		try {
+			const [backendNodeId] = await Promise.all([opened, element.click()]);
+			if (signal.aborted) throw new Error("File selection interrupted");
+			const objectId = (await session.send("DOM.resolveNode", { backendNodeId })).object.objectId;
+			if (objectId === void 0) throw new Error("The chooser has no file input");
+			if (signal.aborted) throw new Error("File selection interrupted");
+			if ((await session.send("Runtime.callFunctionOn", {
+				objectId,
+				functionDeclaration: `function(encoded, name, type) { (${setFileSelection.toString()})(this, encoded, name, type); }`,
+				arguments: [
+					{ value: encoded },
+					{ value: request.fileName },
+					{ value: request.mediaType }
+				],
+				returnByValue: true
+			})).exceptionDetails !== void 0) throw new Error("The chooser did not select the file");
+		} finally {
+			clearTimeout(timer);
+			session.off("Page.fileChooserOpened", onOpened);
+			signal.removeEventListener("abort", onAbort);
+		}
+	};
+	return {
+		validate: async (element) => request.target === "chooser" || await element.evaluate((input) => Reflect.get(input, "type") === "file" && !Reflect.get(input, "disabled") && !Reflect.get(input, "webkitdirectory")),
+		select,
+		close: async () => {
+			if (session !== void 0) try {
+				await session.send("Page.setInterceptFileChooserDialog", { enabled: false });
+			} finally {
+				await session.detach();
+			}
+		}
+	};
+};
+//#endregion
 //#region src/internal/browser-session-lifecycle.ts
 var BrowserRunCleanupError = class extends Schema.TaggedError()("BrowserRunCleanupError", {
 	reason: Schema.Literals([
@@ -15,7 +179,8 @@ var BrowserRunCleanupError = class extends Schema.TaggedError()("BrowserRunClean
 		"timeout",
 		"pending"
 	]),
-	status: Schema.optionalKey(Schema.Int)
+	status: Schema.optionalKey(Schema.Int),
+	cause: Schema.optionalKey(Schema.Defect())
 }) {};
 const Identity = Schema.String.check(Schema.isUUID());
 const Account = Schema.String.check(Schema.isPattern(/^[a-f0-9]{32}$/));
@@ -32,7 +197,10 @@ var BrowserRunSessionLifecycle = class extends Context.Service()("@effect-agent/
 			const client = yield* HttpClient.HttpClient;
 			const request = Effect.fn("BrowserRunSessionLifecycle.request")(function* (method, sessionId) {
 				const path = method === "DELETE" ? "browser" : "session";
-				const response = yield* client.execute(HttpClientRequest.make(method)(`https://api.cloudflare.com/client/v4/accounts/${options.accountId}/browser-rendering/devtools/${path}/${sessionId}`).pipe(HttpClientRequest.bearerToken(options.apiToken))).pipe(Effect.provideService(FetchHttpClient.RequestInit, { redirect: "manual" }), Effect.mapError(() => new BrowserRunCleanupError({ reason: "provider" })));
+				const response = yield* client.execute(HttpClientRequest.make(method)(`https://api.cloudflare.com/client/v4/accounts/${options.accountId}/browser-rendering/devtools/${path}/${sessionId}`).pipe(HttpClientRequest.bearerToken(options.apiToken))).pipe(Effect.provideService(FetchHttpClient.RequestInit, { redirect: "manual" }), Effect.mapError((cause) => new BrowserRunCleanupError({
+					reason: "provider",
+					cause: browserFailure("browser.close.request", cause)
+				})));
 				if (response.status === 401 || response.status === 403) return yield* new BrowserRunCleanupError({
 					reason: "authorization",
 					status: response.status
@@ -52,21 +220,33 @@ var BrowserRunSessionLifecycle = class extends Context.Service()("@effect-agent/
 					combined.set(body);
 					combined.set(chunk, body.byteLength);
 					return Effect.succeed(combined);
-				}).pipe(Effect.mapError(() => new BrowserRunCleanupError({ reason: "malformed" })));
+				}).pipe(Effect.mapError((cause) => new BrowserRunCleanupError({
+					reason: "malformed",
+					cause: browserFailure("browser.close.response", cause)
+				})));
 				const body = yield* Effect.try({
 					try: () => new TextDecoder("utf-8", {
 						fatal: true,
 						ignoreBOM: false
 					}).decode(bytes),
-					catch: () => new BrowserRunCleanupError({ reason: "malformed" })
+					catch: (cause) => new BrowserRunCleanupError({
+						reason: "malformed",
+						cause: browserFailure("browser.close.decode", cause)
+					})
 				});
 				if (response.status === 404) {
 					const absent = Schema.decodeOption(Schema.fromJsonString(Absent))(body, { onExcessProperty: "error" });
 					if (Option.isSome(absent)) return true;
 					return yield* new BrowserRunCleanupError({ reason: "malformed" });
 				}
-				if (method === "DELETE") return (yield* Schema.decodeEffect(Schema.fromJsonString(Closed))(body).pipe(Effect.mapError(() => new BrowserRunCleanupError({ reason: "malformed" })))).status === "closed";
-				const result = yield* Schema.decodeEffect(Schema.fromJsonString(Metadata))(body).pipe(Effect.mapError(() => new BrowserRunCleanupError({ reason: "malformed" })));
+				if (method === "DELETE") return (yield* Schema.decodeEffect(Schema.fromJsonString(Closed))(body).pipe(Effect.mapError((cause) => new BrowserRunCleanupError({
+					reason: "malformed",
+					cause: browserFailure("browser.close.response", cause)
+				})))).status === "closed";
+				const result = yield* Schema.decodeEffect(Schema.fromJsonString(Metadata))(body).pipe(Effect.mapError((cause) => new BrowserRunCleanupError({
+					reason: "malformed",
+					cause: browserFailure("browser.close.response", cause)
+				})));
 				if (result.sessionId !== sessionId) return yield* new BrowserRunCleanupError({ reason: "malformed" });
 				return result.endTime !== void 0 && result.endTime > 0;
 			});
@@ -231,13 +411,14 @@ var BrowserRunInteractiveBinding = class BrowserRunInteractiveBinding extends Co
 	static layer(options) {
 		return Layer.effect(BrowserRunInteractiveBinding)(Effect.gen(function* () {
 			const lifecycle = yield* BrowserRunSessionLifecycle;
+			const binding = yield* BrowserRunBinding;
 			const viewport = options.viewport === void 0 ? void 0 : yield* decodeViewport(options.viewport);
 			return {
-				acquire: async (keepAliveMillis) => (await puppeteer.acquire(options.browser, { keep_alive: keepAliveMillis })).sessionId,
-				connect: async (sessionId) => makeProductionBrowser(await puppeteer.connect(options.browser, sessionId), viewport),
+				acquire: async (keepAliveMillis) => binding.acquire(keepAliveMillis, "interactive.acquire"),
+				connect: async (sessionId) => makeProductionBrowser(await binding.connect(sessionId, "interactive.connect"), viewport),
 				closeSession: (sessionId) => lifecycle.close(sessionId).pipe(Effect.mapError((cause) => actionError("close", cause)))
 			};
-		}));
+		})).pipe(Layer.provide(BrowserRunBinding.layer(options.browser)));
 	}
 };
 /** Cloudflare host authority kept separate from the provider-neutral browser handle. */
@@ -413,7 +594,7 @@ 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) => {
+const runObservedPageAction = async (page, selector, signal, onDispatch, action, validate) => {
 	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);
@@ -434,6 +615,7 @@ const runObservedPageAction = async (page, selector, signal, onDispatch, action)
 	};
 	signal.addEventListener("abort", onAbort, { once: true });
 	try {
+		if (validate !== void 0 && !await validate(matches[0])) throw new BrowserRunActionUndispatched(1);
 		tracker = makeActionRequestTracker(page, signal);
 		if (signal.aborted) throw new BrowserRunActionUndispatched(1);
 		onDispatch();
@@ -454,9 +636,17 @@ const runObservedPageAction = async (page, selector, signal, onDispatch, action)
 	}
 };
 const makeProductionPage = (page) => {
+	const prepareFileSelection = makeFileSelection(page);
 	const listeners = /* @__PURE__ */ new Map();
 	return {
-		close: () => page.close(),
+		close: async () => {
+			if (!page.browser().isConnected()) return;
+			try {
+				await page.close();
+			} catch (cause) {
+				if (!isRemoteClosure(cause)) throw cause;
+			}
+		},
 		setBypassServiceWorker: (enabled) => page.setBypassServiceWorker(enabled),
 		setRequestInterception: (enabled) => page.setRequestInterception(enabled),
 		onRequest: (listener) => {
@@ -613,6 +803,14 @@ const makeProductionPage = (page) => {
 			}
 		}, value)),
 		click: (selector, signal, onDispatch) => runObservedPageAction(page, selector, signal, onDispatch, (element) => element.click()),
+		selectFile: async (request, signal, onDispatch) => {
+			const selection = await prepareFileSelection(request, signal);
+			try {
+				return await runObservedPageAction(page, request.selector, signal, onDispatch, selection.select, selection.validate);
+			} finally {
+				await selection.close();
+			}
+		},
 		screenshot: (fullPage) => page.screenshot({
 			type: "png",
 			fullPage
@@ -635,11 +833,25 @@ const makeProductionContext = (context, viewport) => ({
 		if (viewport !== void 0) await page.setViewport(viewport);
 		return makeProductionPage(page);
 	},
-	close: () => context.close()
+	close: async () => {
+		if (!context.browser().isConnected()) return;
+		try {
+			await context.close();
+		} catch (cause) {
+			if (!isRemoteClosure(cause)) throw cause;
+		}
+	}
 });
 const makeProductionBrowser = (browser, viewport) => ({
 	createContext: async () => makeProductionContext(await browser.createBrowserContext(), viewport),
-	close: () => browser.close(),
+	close: async () => {
+		if (!browser.isConnected()) return;
+		try {
+			await browser.close();
+		} catch (cause) {
+			if (!isRemoteClosure(cause)) throw cause;
+		}
+	},
 	sessionId: () => browser.sessionId(),
 	isConnected: () => browser.isConnected(),
 	onDisconnected: (listener) => {
@@ -679,7 +891,7 @@ const causeText = (cause) => {
 	if (cause instanceof Error) return cause.message.slice(0, 8e3);
 	return String(cause).slice(0, 8e3);
 };
-const isCapacityRefusal = (cause) => /(^|\D)429(\D|$)|browser time limit|capacity|too many concurrent/i.test(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 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")));
@@ -708,21 +920,22 @@ const hostAllowed = (policy, value) => {
 	}
 };
 const keepAliveMillis = (policy) => Math.max(MIN_KEEP_ALIVE_MILLIS, Math.min(MAX_KEEP_ALIVE_MILLIS, policy.maxElapsedMillis));
+var LateBrowserAcquisition = class extends Error {};
 const closeLateAcquisition = async (signal, acquire, close) => {
 	const acquired = await acquire();
 	if (!signal.aborted) return acquired;
 	try {
 		await close(acquired);
 	} catch {}
-	throw new Error("The interrupted browser acquisition completed late");
+	throw new LateBrowserAcquisition("The interrupted browser acquisition completed late");
 };
 const closeWithWarning = (close, warning) => Effect.tryPromise({
 	try: close,
-	catch: () => protocolError(warning)
+	catch: (cause) => protocolError(warning, cause)
 }).pipe(Effect.timeoutOrElse({
 	duration: Duration.millis(CLEANUP_STEP_TIMEOUT_MILLIS),
 	orElse: () => Effect.fail(protocolError(warning))
-}), Effect.catchCause(() => Effect.logWarning(warning)));
+}), Effect.catchCause((cause) => reportBrowserCause("interactive.cleanup", cause).pipe(Effect.andThen(Effect.logWarning(warning)))));
 const deadlineError = Effect.fn("BrowserRunInteractive.deadlineError")(function* (policy, startedAt) {
 	const now = yield* Effect.clockWith((clock) => clock.currentTimeMillis);
 	return yield* InteractiveBrowserLimitError.make({
@@ -786,12 +999,12 @@ const makeRequestListener = (policy, state) => (request) => {
 	let settlement;
 	try {
 		settlement = allowed ? request.continue() : request.abort();
-	} catch {
-		state.violation.value = protocolError("Resolving an intercepted browser request failed");
+	} catch (cause) {
+		state.violation.value = protocolError("Resolving an intercepted browser request failed", cause);
 		return;
 	}
-	const observed = settlement.catch(() => {
-		state.violation.value = protocolError("Resolving an intercepted browser request failed");
+	const observed = settlement.catch((cause) => {
+		state.violation.value = protocolError("Resolving an intercepted browser request failed", cause);
 	}).finally(() => {
 		state.pendingRequests.delete(observed);
 	});
@@ -941,6 +1154,17 @@ const makeHandle = Effect.fn("BrowserRunInteractive.makeHandle")(function* (page
 				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));
+				yield* logActionObservation("select-file", observation);
+				const result = yield* decodeActionResult(page, policy);
+				return BrowserFileSelectionResult.make({
+					url: result.url,
+					fileName: decoded.fileName,
+					mediaType: decoded.mediaType,
+					size: decoded.bytes.length
+				});
+			})))),
 			screenshot: (request) => Schema.decodeEffect(BrowserScreenshotRequest)(request).pipe(Effect.mapError(() => policyError("The browser screenshot request is malformed")), Effect.flatMap((decoded) => run(Effect.gen(function* () {
 				const raw = yield* remote("screenshot", () => page.screenshot(decoded.fullPage));
 				const bytes = yield* Schema.decodeUnknownEffect(PngBytes)(raw).pipe(Effect.mapError(() => protocolError("The browser returned a malformed PNG screenshot")));
@@ -992,15 +1216,25 @@ const runTeardown = (entries) => Effect.forEach([...entries].reverse(), (entry)
 	onSuccess: () => void 0
 }))).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 cdp = yield* Effect.acquireRelease(Effect.tryPromise({
-		try: (signal) => closeLateAcquisition(signal, page.createCdpSession, (acquired) => acquired.detach()),
+		try: (signal) => {
+			const pending = closeLateAcquisition(signal, page.createCdpSession, (acquired) => Effect.runPromiseWith(cleanupContext)(Effect.tryPromise({
+				try: () => acquired.detach(),
+				catch: (cause) => actionError("close", cause)
+			}).pipe(Effect.tapCause((cause) => reportBrowserCause("interactive.lateDetach", cause)))));
+			pending.then(void 0, (cause) => {
+				if (signal.aborted && !(cause instanceof LateBrowserAcquisition)) return Effect.runPromiseWith(cleanupContext)(reportBrowserCause("interactive.connect", Cause.fail(cause)));
+			});
+			return pending;
+		},
 		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),
 		catch: (cause) => state.disconnected.value || isRemoteClosure(cause) ? expiredError() : protocolError("The Cloudflare browser control command failed", cause)
 	});
-	return yield* Schema.decodeUnknownEffect(output)(raw).pipe(Effect.mapError(() => protocolError(malformedMessage)));
+	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)))))));
 }));
 const makeHostService = (binding) => {
 	const closeSession = binding.closeSession;
@@ -1012,20 +1246,27 @@ const makeHostService = (binding) => {
 		}));
 		const remaining = deadline - (yield* Clock.currentTimeMillis);
 		if (remaining <= 0) return yield* Effect.logWarning("Local browser teardown skipped after confirmed termination deadline");
-		yield* runTeardown(entries).pipe(Effect.flatMap((failures) => Effect.forEach(failures, (failure) => Effect.logWarning(failure.warning), { discard: true })), Effect.interruptible, Effect.timeout(`${remaining} millis`), Effect.catchCause(() => Effect.logWarning("Local browser teardown incomplete after confirmed termination")));
+		yield* runTeardown(entries).pipe(Effect.flatMap((failures) => Effect.forEach(failures, (failure) => reportBrowserCause("interactive.cleanup", Cause.fail(failure.error)).pipe(Effect.andThen(Effect.logWarning(failure.warning))), { discard: true })), Effect.interruptible, Effect.timeout(`${remaining} millis`), Effect.catchCause((cause) => reportBrowserCause("interactive.cleanup", cause).pipe(Effect.andThen(Effect.logWarning("Local browser teardown incomplete after confirmed termination")))));
 	});
 	const closeAcquired = Effect.fn("BrowserRunInteractiveHost.closeAcquired")(function* (browser) {
 		const sessionId = yield* Effect.try({
 			try: browser.sessionId,
-			catch: () => actionError("close")
-		}).pipe(Effect.flatMap(Schema.decodeUnknownEffect(BrowserRunSessionId)), Effect.mapError(() => actionError("close")), Effect.onError(() => closeWithWarning(browser.close, "Closing an unidentified browser failed")));
+			catch: (cause) => actionError("close", cause)
+		}).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 scope = yield* Scope.Scope;
 		const fixedPolicy = yield* snapshotPolicy(policy);
 		const startedAt = yield* Effect.clockWith((clock) => clock.currentTimeMillis);
-		const runCleanup = Effect.runPromiseWith(Context.make(Clock.Clock, yield* Clock.Clock));
+		const runCleanup = (effect) => Effect.runPromiseWith(cleanupContext)(effect.pipe(Effect.tapCause((cause) => reportBrowserCause("interactive.lateCleanup", cause))));
+		const cleanupContext = yield* Effect.context();
+		const observeLate = (signal, pending) => {
+			pending.then(void 0, (cause) => {
+				if (signal.aborted && !(cause instanceof LateBrowserAcquisition)) return runCleanup(reportBrowserCause("interactive.acquire", Cause.fail(cause)));
+			});
+			return pending;
+		};
 		const state = {
 			closed: { value: false },
 			disconnected: { value: false },
@@ -1035,9 +1276,9 @@ const makeHostService = (binding) => {
 		};
 		const lifecycle = { managedTeardownInstalled: false };
 		const closers = [];
-		const releaseBeforeManaged = (entry) => Effect.suspend(() => lifecycle.managedTeardownInstalled ? Effect.void : entry.close.pipe(Effect.catchCause(() => Effect.logWarning(entry.warning))));
+		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({
-			try: (signal) => closeLateAcquisition(signal, () => binding.acquire(keepAliveMillis(fixedPolicy)), (id) => runCleanup(Schema.decodeUnknownEffect(BrowserRunSessionId)(id).pipe(Effect.flatMap((value) => terminate(Redacted.make(value), []))))),
+			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"
@@ -1045,11 +1286,11 @@ const makeHostService = (binding) => {
 		}).pipe(Effect.flatMap(Schema.decodeUnknownEffect(BrowserRunSessionId)), Effect.catchTag("SchemaError", () => protocolError("The Browser Run session identity was malformed"))), fixedPolicy, startedAt), (id) => Effect.suspend(() => {
 			state.closed.value = true;
 			state.disconnected.value = true;
-			return lifecycle.managedTeardownInstalled ? Effect.void : terminate(Redacted.make(id), []).pipe(Effect.catch(() => Effect.logWarning("Whole-browser cleanup remains unconfirmed")));
+			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")))));
 		}), { interruptible: true });
 		const connect = yield* Effect.cached(Effect.gen(function* () {
 			const browser = yield* Effect.acquireRelease(withinDeadline(Effect.tryPromise({
-				try: (signal) => closeLateAcquisition(signal, () => binding.connect(sessionIdValue), (acquired) => runCleanup(closeAcquired(acquired))),
+				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 });
 			closers.push(closeEntry(browser.close, "Closing the interactive browser failed"));
@@ -1069,12 +1310,18 @@ const makeHostService = (binding) => {
 				return yield* expiredError();
 			}
 			const context = yield* Effect.acquireRelease(withinDeadline(Effect.tryPromise({
-				try: (signal) => closeLateAcquisition(signal, browser.createContext, (acquired) => acquired.close()),
+				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 });
 			closers.push(closeEntry(context.close, "Closing the interactive browser context failed"));
 			const page = yield* Effect.acquireRelease(withinDeadline(Effect.tryPromise({
-				try: (signal) => closeLateAcquisition(signal, context.newPage, (acquired) => acquired.close()),
+				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 });
 			closers.push(closeEntry(page.close, "Closing the interactive browser page failed"));
@@ -1096,12 +1343,12 @@ const makeHostService = (binding) => {
 			const setupFailure = stateFailure(state);
 			if (setupFailure !== void 0) return yield* setupFailure;
 			const teardown = yield* Effect.uninterruptible(Effect.gen(function* () {
-				const cached = yield* Effect.cached(terminate(Redacted.make(sessionIdValue), closers));
+				const cached = yield* Effect.cached(terminate(Redacted.make(sessionIdValue), closers).pipe(Effect.tapCause((cause) => reportBrowserCause("interactive.close", cause)), Effect.mapError(reportedBrowserError)));
 				lifecycle.managedTeardownInstalled = true;
 				yield* Effect.addFinalizer(() => Effect.uninterruptible(Effect.sync(() => {
 					state.closed.value = true;
 					state.disconnected.value = true;
-				}).pipe(Effect.andThen(cached), Effect.catch(() => Effect.logWarning("Whole-browser cleanup remains unconfirmed")))));
+				}).pipe(Effect.andThen(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(() => {
@@ -1175,6 +1422,6 @@ const CloudflareInteractiveBrowser = {
 	hostLayer: (options) => browserRunInteractiveHostLayer().pipe(Layer.provide(interactiveBindingLayer(options)))
 };
 //#endregion
-export { BrowserRunInteractiveHost as a, BrowserRunViewport as c, browserRunInteractiveImplementation as d, browserRunInteractiveLayer as f, 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 };
+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 };
 
-//# sourceMappingURL=InteractiveBrowser-BCS9g0tn.mjs.map
+//# sourceMappingURL=InteractiveBrowser-l6J4eP6T.mjs.map