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

package/dist/CloudflareThreadClient.d.mts

@@ -475,13 +475,13 @@ export declare const encodeUnknownResolutionCommand: (input: UnknownResolutionCo
   readonly author: string;
   readonly reason: string;
   readonly resolution: {
-    readonly _tag: "SafeToRetry";
-  } | {
     readonly _tag: "CompletedWithResult";
     readonly result: Schema.Json;
     readonly isFailure: boolean;
   } | {
     readonly _tag: "NeverHappened";
+  } | {
+    readonly _tag: "SafeToRetry";
   } | {
     readonly _tag: "AbortSubmission";
   };
@@ -645,11 +645,6 @@ export declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorde
       readonly createdAt: string;
       readonly deploymentId: string;
       readonly payload: {
-        readonly _tag: "AbortRequested";
-        readonly submissionId: string;
-        readonly author: string;
-        readonly reason: string;
-      } | {
         readonly _tag: "ThreadCreated";
         readonly agentId: string;
         readonly definitions: {
@@ -927,6 +922,11 @@ export declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorde
         readonly runDisposition?: Schema.Json | undefined;
         readonly finishReason?: "budget-exhausted" | undefined;
         readonly exhausted?: "tokens" | "tool-calls" | "turns" | undefined;
+      } | {
+        readonly _tag: "AbortRequested";
+        readonly submissionId: string;
+        readonly author: string;
+        readonly reason: string;
       } | {
         readonly _tag: "SubmissionSettled";
         readonly submissionId: string;
@@ -1465,13 +1465,13 @@ export declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorde
     readonly author: string;
     readonly reason: string;
     readonly resolution: {
-      readonly _tag: "SafeToRetry";
-    } | {
       readonly _tag: "CompletedWithResult";
       readonly result: Schema.Json;
       readonly isFailure: boolean;
     } | {
       readonly _tag: "NeverHappened";
+    } | {
+      readonly _tag: "SafeToRetry";
     } | {
       readonly _tag: "AbortSubmission";
     };
@@ -1481,6 +1481,21 @@ export declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorde
 } | {
   readonly _tag: "HostFailed";
   readonly failure: {
+    readonly _tag: "DurableAlarmError";
+    readonly operation: string;
+    readonly message: string;
+    readonly cause?: Schema.Json | undefined;
+  } | {
+    readonly _tag: "HostProtocolError";
+    readonly message: string;
+  } | {
+    readonly _tag: "AgentInputError";
+    readonly message: string;
+  } | {
+    readonly _tag: "DigestError";
+    readonly message: string;
+    readonly cause?: Schema.Json | undefined;
+  } | {
     readonly _tag: "AdmissionConflict";
     readonly threadId: string;
     readonly principal: string;
@@ -1497,6 +1512,15 @@ export declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorde
     readonly _tag: "SettlementConflict";
     readonly submissionId: string;
     readonly existingOutcome: "aborted" | "completed" | "failed";
+  } | {
+    readonly _tag: "ApprovalConflict";
+    readonly submissionId: string;
+    readonly toolCallId: string;
+    readonly existingDecision: "approved" | "denied";
+  } | {
+    readonly _tag: "UnknownResolutionConflict";
+    readonly submissionId: string;
+    readonly toolCallId: string;
   } | {
     readonly _tag: "JoinedToHost";
     readonly submissionId: string;
@@ -1526,25 +1550,6 @@ export declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorde
     readonly threadId: string;
     readonly actualEpoch: number;
     readonly attemptedEpoch: number;
-  } | {
-    readonly _tag: "HostProtocolError";
-    readonly message: string;
-  } | {
-    readonly _tag: "AgentInputError";
-    readonly message: string;
-  } | {
-    readonly _tag: "DigestError";
-    readonly message: string;
-    readonly cause?: Schema.Json | undefined;
-  } | {
-    readonly _tag: "ApprovalConflict";
-    readonly submissionId: string;
-    readonly toolCallId: string;
-    readonly existingDecision: "approved" | "denied";
-  } | {
-    readonly _tag: "UnknownResolutionConflict";
-    readonly submissionId: string;
-    readonly toolCallId: string;
   } | {
     readonly _tag: "DurableRuntimeFailpointError";
     readonly location: "abort:after-intent" | "approval:after-request-append" | "approval:after-suspend" | "checkpoint:after-save" | "checkpoint:before-save" | "claim:after-claim" | "compaction:after-canonical-append" | "compaction:before-canonical-append" | "input:after-canonical-append" | "join:after-canonical-append" | "join:after-claim" | "policy:after-reservation-append" | "policy:before-reservation-append" | "resolve:after-intent" | "run:after-duration-append" | "run:after-start-append" | "run:before-duration-append" | "run:before-start-append" | "step:after-step-append" | "subagent:after-admit" | "subagent:after-child-abort-intent" | "subagent:after-child-ready" | "subagent:after-join-append" | "subagent:after-release" | "subagent:after-release-pending" | "subagent:after-request-append" | "subagent:after-reserve" | "subagent:after-sibling-settle" | "subagent:after-start-append" | "subagent:after-suspend" | "subagent:before-join-append" | "submit:after-admit" | "submit:after-materialize" | "terminalize:after-canonical-append" | "terminalize:after-reserve" | "tools:after-prepared-append" | "tools:after-unavailable-append" | "tools:before-prepared-append" | "tools:before-unavailable-append" | "turn:after-canonical-append" | "turn:after-response-append" | "turn:after-results-append" | "update:after-canonical-append" | "update:after-delivery-insert" | "update:before-canonical-append" | "update:before-delivery-insert" | "worker:after-completion-append" | "worker:after-origin-append" | "worker:after-report-append" | "worker:after-report-delivery" | "worker:after-source-append" | "worker:after-subtree-append" | "worker:before-completion-append" | "worker:before-origin-append" | "worker:before-report-append" | "worker:before-report-delivery" | "worker:before-source-append" | "worker:before-subtree-append";
@@ -1553,11 +1558,6 @@ export declare const encodeHostResponse: (input: AbortRecorded | ApprovalRecorde
     readonly limit: "database-bytes" | "input-bytes" | "queue-depth";
     readonly actual: number;
     readonly maximum: number;
-  } | {
-    readonly _tag: "DurableAlarmError";
-    readonly operation: string;
-    readonly message: string;
-    readonly cause?: Schema.Json | undefined;
   } | {
     readonly _tag: "OperationDenied";
     readonly operation: "abort" | "awaitSettlement" | "explain" | "observe" | "resolveApproval" | "resolveUnknown" | "retry" | "scanObligations" | "verify" | "wake";

package/dist/{InteractiveBrowser-B3S8if51.d.mts → InteractiveBrowser-CKp6pqmw.d.mts}

@@ -6,6 +6,7 @@ import { BrowserHandle, BrowserSelectFileRequest, InteractiveBrowser, Interactiv
 declare const BrowserRunCleanupError_base: Schema.Class<BrowserRunCleanupError, Schema.TaggedStruct<"BrowserRunCleanupError", {
   readonly reason: Schema.Literals<readonly ["configuration", "authorization", "rate-limited", "provider", "malformed", "timeout", "pending"]>;
   readonly status: Schema.optionalKey<Schema.Int>;
+  readonly cause: Schema.optionalKey<Schema.Defect>;
 }>, import("effect/Cause").YieldableError>;
 declare class BrowserRunCleanupError extends BrowserRunCleanupError_base {}
 interface BrowserRunLifecycleOptions {
@@ -167,4 +168,4 @@ declare const CloudflareInteractiveBrowser: {
 };
 //#endregion
 export { isBrowserRunUndispatchedActionError as C, browserRunInteractiveLayer as S, BrowserRunSessionLifecycle as T, BrowserRunViewport as _, BrowserRunInteractiveAcquisition as a, browserRunInteractiveHostLayer as b, BrowserRunInteractiveCdpSession as c, BrowserRunInteractivePage as d, BrowserRunInteractiveRequest as f, BrowserRunLiveViewResult as g, BrowserRunLiveViewRequest as h, BrowserRunHandoffState as i, BrowserRunInteractiveContext as l, BrowserRunInteractiveSession as m, BrowserRunHandoffRequest as n, BrowserRunInteractiveBinding as o, BrowserRunInteractiveRequestListener as p, BrowserRunHandoffResult as r, BrowserRunInteractiveBrowser as s, BrowserRunCloudflareCommand as t, BrowserRunInteractiveHost as u, CloudflareInteractiveBrowser as v, BrowserRunCleanupError as w, browserRunInteractiveImplementation as x, CloudflareInteractiveBrowserOptions as y };
-//# sourceMappingURL=InteractiveBrowser-B3S8if51.d.mts.map
+//# sourceMappingURL=InteractiveBrowser-CKp6pqmw.d.mts.map

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

@@ -1,9 +1,102 @@
-import { Clock, Context, Duration, Effect, Encoding, 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, 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");
@@ -86,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}$/));
@@ -103,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
@@ -123,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;
 			});
@@ -302,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. */
@@ -529,7 +639,14 @@ 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) => {
@@ -716,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) => {
@@ -760,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")));
@@ -789,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({
@@ -867,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);
 	});
@@ -1084,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;
@@ -1104,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 },
@@ -1127,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"
@@ -1137,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"));
@@ -1161,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"));
@@ -1188,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(() => {
@@ -1267,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-xVNX7ARl.mjs.map
+//# sourceMappingURL=InteractiveBrowser-l6J4eP6T.mjs.map