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

package/dist/{ThreadObject-CnqCuWlA.d.mts → ThreadObject-D_vvj7Qx.d.mts}

@@ -705,18 +705,24 @@ declare const encodeAdminResponse: (input: AdminFailed | ExplainedRecovery | Obl
 } | {
   readonly _tag: "AdminFailed";
   readonly failure: {
-    readonly _tag: "ThreadStoreError";
+    readonly _tag: "DurableAlarmError";
     readonly operation: string;
     readonly message: string;
     readonly cause?: Schema.Json | undefined;
   } | {
-    readonly _tag: "ThreadNotMaterialized";
-    readonly threadId: string;
+    readonly _tag: "HostProtocolError";
+    readonly message: string;
   } | {
     readonly _tag: "LedgerError";
     readonly operation: string;
     readonly message: string;
     readonly cause?: import("effect-agent/failure-diagnostic").Diagnostic | undefined;
+  } | {
+    readonly _tag: "AdmissionPolicyError";
+    readonly reason: "occupied" | "refused" | "unavailable";
+    readonly code: string;
+    readonly cause?: import("effect-agent/failure-diagnostic").Diagnostic | undefined;
+    readonly stack?: string | undefined;
   } | {
     readonly _tag: "AppendConflict";
     readonly threadId: string;
@@ -724,23 +730,6 @@ declare const encodeAdminResponse: (input: AdminFailed | ExplainedRecovery | Obl
     readonly reason: "batch-digest" | "record-identity" | "tail";
     readonly actualTailSequence?: number | undefined;
     readonly actualTailDigest?: string | undefined;
-  } | {
-    readonly _tag: "FenceRejected";
-    readonly threadId: string;
-    readonly actualEpoch: number;
-    readonly attemptedEpoch: number;
-  } | {
-    readonly _tag: "OperationDenied";
-    readonly operation: "abort" | "awaitSettlement" | "explain" | "observe" | "resolveApproval" | "resolveUnknown" | "retry" | "scanObligations" | "verify" | "wake";
-    readonly reason: string;
-    readonly threadId?: string | undefined;
-    readonly submissionId?: string | undefined;
-  } | {
-    readonly _tag: "AdmissionPolicyError";
-    readonly reason: "occupied" | "refused" | "unavailable";
-    readonly code: string;
-    readonly cause?: import("effect-agent/failure-diagnostic").Diagnostic | undefined;
-    readonly stack?: string | undefined;
   } | {
     readonly _tag: "DigestError";
     readonly message: string;
@@ -749,31 +738,42 @@ declare const encodeAdminResponse: (input: AdminFailed | ExplainedRecovery | Obl
     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";
   } | {
-    readonly _tag: "SettlementConflict";
-    readonly submissionId: string;
-    readonly existingOutcome: "aborted" | "completed" | "failed";
-  } | {
-    readonly _tag: "OwnershipLost";
-    readonly submissionId: string;
+    readonly _tag: "FenceRejected";
+    readonly threadId: string;
     readonly actualEpoch: number;
+    readonly attemptedEpoch: number;
   } | {
-    readonly _tag: "RunJournalError";
-    readonly message: string;
-    readonly cause?: Schema.Json | undefined;
+    readonly _tag: "ThreadNotMaterialized";
+    readonly threadId: string;
   } | {
-    readonly _tag: "DurableAlarmError";
+    readonly _tag: "ThreadStoreError";
     readonly operation: string;
     readonly message: string;
     readonly cause?: Schema.Json | undefined;
   } | {
-    readonly _tag: "HostProtocolError";
-    readonly message: string;
+    readonly _tag: "OperationDenied";
+    readonly operation: "abort" | "awaitSettlement" | "explain" | "observe" | "resolveApproval" | "resolveUnknown" | "retry" | "scanObligations" | "verify" | "wake";
+    readonly reason: string;
+    readonly threadId?: string | undefined;
+    readonly submissionId?: string | undefined;
   } | {
     readonly _tag: "RetryRefused";
     readonly submissionId: string;
     readonly refusal: "await-approval-decision" | "await-unknown-resolution" | "settled";
     readonly decisionTag: string;
     readonly message: string;
+  } | {
+    readonly _tag: "RunJournalError";
+    readonly message: string;
+    readonly cause?: Schema.Json | undefined;
+  } | {
+    readonly _tag: "OwnershipLost";
+    readonly submissionId: string;
+    readonly actualEpoch: number;
+  } | {
+    readonly _tag: "SettlementConflict";
+    readonly submissionId: string;
+    readonly existingOutcome: "aborted" | "completed" | "failed";
   };
 }, Schema.SchemaError, never>;
 declare const decodeAdminResponse: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => Effect.Effect<AdminFailed | ExplainedRecovery | ObligationsScanned | RetryExecuted | VerifiedIntegrity, Schema.SchemaError, never>;
@@ -826,4 +826,4 @@ interface Class<EventServices = never> {
 declare const make: <ApplicationServices, ApplicationError, EventServices = never, EventLayerError = never>(applicationLayer: Layer.Layer<CloudflareDurableRuntimeServices | ApplicationServices, ApplicationError, CloudflareBootstrapServices | DurableObjectState$1.DurableObjectState | WorkerEnvironment | DurableObjectContext | ThreadObjectNamespace>, options: Options<ApplicationServices, EventServices, EventLayerError>) => Class<ApplicationServices | EventServices>;
 //#endregion
 export { ThreadPublicationOptions as A, portCall as C, CloudflareDurableRuntimeOptions as D, CloudflareDurableRuntimeInitializationError as E, layerConfig as M, layerHostConfig as N, CloudflareDurableRuntimeServices as O, layerInHost as P, make as S, CloudflareBootstrapServices as T, decodeAdminVerifyRequest as _, AdminVerifyRequest as a, encodeAdminResponse as b, Instance as c, RetryExecuted as d, ThreadObject_d_exports as f, decodeAdminResponse as g, decodeAdminExplainRequest as h, AdminResponse as i, layer as j, ThreadObjectPorts as k, ObligationsScanned as l, VerifiedIntegrity as m, AdminFailed as n, Class as o, ThreadRpcOperation as p, AdminFailure as r, ExplainedRecovery as s, AdminExplainRequest as t, Options as u, decodeObligationThresholds as v, submit as w, handleRpc as x, decodeRetryCommand as y };
-//# sourceMappingURL=ThreadObject-CnqCuWlA.d.mts.map
+//# sourceMappingURL=ThreadObject-D_vvj7Qx.d.mts.map

package/dist/ThreadObject.d.mts

@@ -1,2 +1,2 @@
-import { A as ThreadPublicationOptions, C as portCall, D as CloudflareDurableRuntimeOptions, E as CloudflareDurableRuntimeInitializationError, M as layerConfig, N as layerHostConfig, O as CloudflareDurableRuntimeServices, P as layerInHost, S as make, T as CloudflareBootstrapServices, _ as decodeAdminVerifyRequest, a as AdminVerifyRequest, b as encodeAdminResponse, c as Instance, d as RetryExecuted, g as decodeAdminResponse, h as decodeAdminExplainRequest, i as AdminResponse, j as layer, k as ThreadObjectPorts, l as ObligationsScanned, m as VerifiedIntegrity, n as AdminFailed, o as Class, p as ThreadRpcOperation, r as AdminFailure, s as ExplainedRecovery, t as AdminExplainRequest, u as Options, v as decodeObligationThresholds, w as submit, x as handleRpc, y as decodeRetryCommand } from "./ThreadObject-CnqCuWlA.mjs";
+import { A as ThreadPublicationOptions, C as portCall, D as CloudflareDurableRuntimeOptions, E as CloudflareDurableRuntimeInitializationError, M as layerConfig, N as layerHostConfig, O as CloudflareDurableRuntimeServices, P as layerInHost, S as make, T as CloudflareBootstrapServices, _ as decodeAdminVerifyRequest, a as AdminVerifyRequest, b as encodeAdminResponse, c as Instance, d as RetryExecuted, g as decodeAdminResponse, h as decodeAdminExplainRequest, i as AdminResponse, j as layer, k as ThreadObjectPorts, l as ObligationsScanned, m as VerifiedIntegrity, n as AdminFailed, o as Class, p as ThreadRpcOperation, r as AdminFailure, s as ExplainedRecovery, t as AdminExplainRequest, u as Options, v as decodeObligationThresholds, w as submit, x as handleRpc, y as decodeRetryCommand } from "./ThreadObject-D_vvj7Qx.mjs";
 export { AdminExplainRequest, AdminFailed, AdminFailure, AdminResponse, AdminVerifyRequest, type CloudflareBootstrapServices as BootstrapServices, Class, ExplainedRecovery, type CloudflareDurableRuntimeInitializationError as InitializationError, Instance, ObligationsScanned, Options, type ThreadPublicationOptions as PublicationOptions, RetryExecuted, type CloudflareDurableRuntimeOptions as RuntimeOptions, type CloudflareDurableRuntimeServices as Services, ThreadObjectPorts, ThreadRpcOperation, VerifiedIntegrity, decodeAdminExplainRequest, decodeAdminResponse, decodeAdminVerifyRequest, decodeObligationThresholds, decodeRetryCommand, encodeAdminResponse, handleRpc, layer, layerConfig, layerHostConfig, layerInHost, make, portCall, submit };

package/dist/index.d.mts

@@ -8,6 +8,6 @@ import { t as CloudflareMemory_d_exports } from "./CloudflareMemory.mjs";
 import { t as CloudflareScheduling_d_exports } from "./CloudflareScheduling.mjs";
 import { t as CloudflareSubscriptions_d_exports } from "./CloudflareSubscriptions.mjs";
 import { t as CloudflareThreadClient_d_exports } from "./CloudflareThreadClient.mjs";
-import { f as ThreadObject_d_exports } from "./ThreadObject-CnqCuWlA.mjs";
+import { f as ThreadObject_d_exports } from "./ThreadObject-D_vvj7Qx.mjs";
 import { t as WakeScheduler_d_exports } from "./WakeScheduler.mjs";
 export { Alarm_d_exports as Alarm, CloudflareAiGateway_d_exports as CloudflareAiGateway, CloudflareBindings_d_exports as CloudflareBindings, CloudflareBrowser_d_exports as CloudflareBrowser, CloudflareCodeMode_d_exports as CloudflareCodeMode, CloudflareConfig_d_exports as CloudflareConfig, CloudflareMemory_d_exports as CloudflareMemory, CloudflareScheduling_d_exports as CloudflareScheduling, CloudflareSubscriptions_d_exports as CloudflareSubscriptions, CloudflareThreadClient_d_exports as CloudflareThreadClient, ThreadObject_d_exports as ThreadObject, WakeScheduler_d_exports as WakeScheduler };

package/package.json

@@ -1 +1 @@
-{"name":"@effect-agent/platform-cloudflare","version":"0.1.0-beta.107","dependencies":{"@effect-agent/storage-cloudflare":"0.1.0-beta.107","@effect/platform-browser":"4.0.0-rc.115","@effect/sql-sqlite-do":"4.0.0-rc.115","effect-agent":"0.1.0-beta.107"},"devDependencies":{"@cloudflare/puppeteer":"1.1.0","@cloudflare/vitest-pool-workers":"0.21.3","@cloudflare/workers-types":"5.20260825.1","@effect-agent/testing":"0.1.0-beta.107","@effect/platform-node":"4.0.0-rc.115","@effect/sql-d1":"4.0.0-rc.115","@effect/vitest":"4.0.0-rc.115","effect":"4.0.0-rc.115","effect-cf":"0.44.1","esbuild":"0.28.1","miniflare":"5.20260811.1-alpha","typescript":"7.0.2","vite-plus":"0.3.2","vitest":"4.1.11"},"peerDependencies":{"@cloudflare/puppeteer":"^1.1.0","effect":"^4.0.0-rc.115","effect-cf":"^0.44.1 || ^0.45.0"},"exports":{".":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"./alarm":{"types":"./dist/Alarm.d.mts","default":"./dist/Alarm.mjs"},"./browser-rest-capture":{"types":"./dist/BrowserRestCapture.d.mts","default":"./dist/BrowserRestCapture.mjs"},"./browser-rest-crawl":{"types":"./dist/BrowserRestCrawl.d.mts","default":"./dist/BrowserRestCrawl.mjs"},"./cloudflare-bindings":{"types":"./dist/CloudflareBindings.d.mts","default":"./dist/CloudflareBindings.mjs"},"./cloudflare-browser":{"types":"./dist/CloudflareBrowser.d.mts","default":"./dist/CloudflareBrowser.mjs"},"./cloudflare-code-mode":{"types":"./dist/CloudflareCodeMode.d.mts","default":"./dist/CloudflareCodeMode.mjs"},"./cloudflare-config":{"types":"./dist/CloudflareConfig.d.mts","default":"./dist/CloudflareConfig.mjs"},"./cloudflare-memory":{"types":"./dist/CloudflareMemory.d.mts","default":"./dist/CloudflareMemory.mjs"},"./cloudflare-scheduling":{"types":"./dist/CloudflareScheduling.d.mts","default":"./dist/CloudflareScheduling.mjs"},"./cloudflare-subscriptions":{"types":"./dist/CloudflareSubscriptions.d.mts","default":"./dist/CloudflareSubscriptions.mjs"},"./cloudflare-thread-client":{"types":"./dist/CloudflareThreadClient.d.mts","default":"./dist/CloudflareThreadClient.mjs"},"./interactive-browser":{"types":"./dist/InteractiveBrowser.d.mts","default":"./dist/InteractiveBrowser.mjs"},"./protected-browser":{"types":"./dist/ProtectedBrowser.d.mts","default":"./dist/ProtectedBrowser.mjs"},"./thread-object":{"types":"./dist/ThreadObject.d.mts","default":"./dist/ThreadObject.mjs"},"./wake-scheduler":{"types":"./dist/WakeScheduler.d.mts","default":"./dist/WakeScheduler.mjs"},"./cloudflare-ai-gateway":{"types":"./dist/CloudflareAiGateway.d.mts","default":"./dist/CloudflareAiGateway.mjs"}},"description":"Cloudflare Layer assembly for Effect Agent: Durable Objects and Browser Run adapters.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/danieljvdm/effect-agent.git","directory":"packages/platform-cloudflare"},"files":["dist","src"],"type":"module","sideEffects":[],"publishConfig":{"access":"public"},"scripts":{"build":"vp pack","check":"tsc --noEmit -p tsconfig.json"},"peerDependenciesMeta":{"@cloudflare/puppeteer":{"optional":true}}}
+{"name":"@effect-agent/platform-cloudflare","version":"0.1.0-beta.108","dependencies":{"@effect-agent/storage-cloudflare":"0.1.0-beta.108","@effect/platform-browser":"4.0.0-rc.115","@effect/sql-sqlite-do":"4.0.0-rc.115","effect-agent":"0.1.0-beta.108"},"devDependencies":{"@cloudflare/puppeteer":"1.1.0","@cloudflare/vitest-pool-workers":"0.21.3","@cloudflare/workers-types":"5.20260825.1","@effect-agent/testing":"0.1.0-beta.108","@effect/platform-node":"4.0.0-rc.115","@effect/sql-d1":"4.0.0-rc.115","@effect/vitest":"4.0.0-rc.115","effect":"4.0.0-rc.115","effect-cf":"0.44.1","esbuild":"0.28.1","miniflare":"5.20260811.1-alpha","typescript":"7.0.2","vite-plus":"0.3.2","vitest":"4.1.11"},"peerDependencies":{"@cloudflare/puppeteer":"^1.1.0","effect":"^4.0.0-rc.115","effect-cf":"^0.44.1 || ^0.45.0"},"exports":{".":{"types":"./dist/index.d.mts","default":"./dist/index.mjs"},"./alarm":{"types":"./dist/Alarm.d.mts","default":"./dist/Alarm.mjs"},"./browser-rest-capture":{"types":"./dist/BrowserRestCapture.d.mts","default":"./dist/BrowserRestCapture.mjs"},"./browser-rest-crawl":{"types":"./dist/BrowserRestCrawl.d.mts","default":"./dist/BrowserRestCrawl.mjs"},"./cloudflare-bindings":{"types":"./dist/CloudflareBindings.d.mts","default":"./dist/CloudflareBindings.mjs"},"./cloudflare-browser":{"types":"./dist/CloudflareBrowser.d.mts","default":"./dist/CloudflareBrowser.mjs"},"./cloudflare-code-mode":{"types":"./dist/CloudflareCodeMode.d.mts","default":"./dist/CloudflareCodeMode.mjs"},"./cloudflare-config":{"types":"./dist/CloudflareConfig.d.mts","default":"./dist/CloudflareConfig.mjs"},"./cloudflare-memory":{"types":"./dist/CloudflareMemory.d.mts","default":"./dist/CloudflareMemory.mjs"},"./cloudflare-scheduling":{"types":"./dist/CloudflareScheduling.d.mts","default":"./dist/CloudflareScheduling.mjs"},"./cloudflare-subscriptions":{"types":"./dist/CloudflareSubscriptions.d.mts","default":"./dist/CloudflareSubscriptions.mjs"},"./cloudflare-thread-client":{"types":"./dist/CloudflareThreadClient.d.mts","default":"./dist/CloudflareThreadClient.mjs"},"./interactive-browser":{"types":"./dist/InteractiveBrowser.d.mts","default":"./dist/InteractiveBrowser.mjs"},"./protected-browser":{"types":"./dist/ProtectedBrowser.d.mts","default":"./dist/ProtectedBrowser.mjs"},"./thread-object":{"types":"./dist/ThreadObject.d.mts","default":"./dist/ThreadObject.mjs"},"./wake-scheduler":{"types":"./dist/WakeScheduler.d.mts","default":"./dist/WakeScheduler.mjs"},"./cloudflare-ai-gateway":{"types":"./dist/CloudflareAiGateway.d.mts","default":"./dist/CloudflareAiGateway.mjs"}},"description":"Cloudflare Layer assembly for Effect Agent: Durable Objects and Browser Run adapters.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/danieljvdm/effect-agent.git","directory":"packages/platform-cloudflare"},"files":["dist","src"],"type":"module","sideEffects":[],"publishConfig":{"access":"public"},"scripts":{"build":"vp pack","check":"tsc --noEmit -p tsconfig.json"},"peerDependenciesMeta":{"@cloudflare/puppeteer":{"optional":true}}}

package/src/InteractiveBrowser.ts

@@ -1,6 +1,6 @@
 /// <reference types="@cloudflare/workers-types" />
 
-import puppeteer, {
+import {
   type Browser,
   type BrowserContext,
   type CDPSession,
@@ -8,6 +8,7 @@ import puppeteer, {
   type Page,
 } from "@cloudflare/puppeteer";
 import {
+  Cause,
   Context,
   Clock,
   Duration,
@@ -45,6 +46,12 @@ import {
 import { PageScreenshotResult } from "effect-agent/page-screenshot";
 import { SandboxImplementation } from "effect-agent/sandbox";
 
+import { BrowserRunBinding } from "./internal/browser-binding.ts";
+import {
+  BrowserRunFailure,
+  reportBrowserCause,
+  reportedBrowserError,
+} from "./internal/browser-failure.ts";
 import { makeFileSelection } from "./internal/browser-file-selection.ts";
 import {
   BrowserRunSessionLifecycle,
@@ -379,22 +386,26 @@ export class BrowserRunInteractiveBinding extends Context.Service<
     return Layer.effect(BrowserRunInteractiveBinding)(
       Effect.gen(function* () {
         const lifecycle = yield* BrowserRunSessionLifecycle;
+        const binding = yield* BrowserRunBinding;
 
         const viewport =
           options.viewport === undefined ? undefined : yield* decodeViewport(options.viewport);
 
         return {
           acquire: async (keepAliveMillis: number) =>
-            (await puppeteer.acquire(options.browser, { keep_alive: keepAliveMillis })).sessionId,
+            binding.acquire(keepAliveMillis, "interactive.acquire"),
           connect: async (sessionId: string) =>
-            makeProductionBrowser(await puppeteer.connect(options.browser, sessionId), viewport),
+            makeProductionBrowser(
+              await binding.connect(sessionId, "interactive.connect"),
+              viewport,
+            ),
           closeSession: (sessionId: Redacted.Redacted<string>) =>
             lifecycle
               .close(sessionId)
               .pipe(Effect.mapError((cause) => actionError("close", cause))),
         };
       }),
-    );
+    ).pipe(Layer.provide(BrowserRunBinding.layer(options.browser)));
   }
 }
 
@@ -776,7 +787,14 @@ const makeProductionPage = (page: Page): BrowserRunInteractivePage => {
   const listeners = new Map<BrowserRunInteractiveRequestListener, (request: HTTPRequest) => void>();
 
   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) => {
@@ -1144,7 +1162,14 @@ const makeProductionContext = (
 
     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 = (
@@ -1152,7 +1177,15 @@ const makeProductionBrowser = (
   viewport?: BrowserRunViewport,
 ): BrowserRunInteractiveBrowser => ({
   createContext: async () => makeProductionContext(await browser.createBrowserContext(), viewport),
-  close: () => browser.close(),
+  // Exact-session termination may already have closed the provider transport.
+  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) => {
@@ -1211,7 +1244,7 @@ const causeText = (cause: unknown): string => {
 };
 
 const isCapacityRefusal = (cause: unknown): boolean =>
-  /(^|\D)429(\D|$)|browser time limit|capacity|too many concurrent/i.test(causeText(cause));
+  cause instanceof BrowserRunFailure && cause.status === 429;
 
 const isRemoteClosure = (cause: unknown): boolean =>
   /target closed|browser.*closed|session.*closed|connection.*closed|not connected|websocket.*closed/i.test(
@@ -1270,6 +1303,8 @@ const hostAllowed = (policy: InteractiveBrowserPolicySnapshot, value: string): b
 const keepAliveMillis = (policy: InteractiveBrowserPolicySnapshot): number =>
   Math.max(MIN_KEEP_ALIVE_MILLIS, Math.min(MAX_KEEP_ALIVE_MILLIS, policy.maxElapsedMillis));
 
+class LateBrowserAcquisition extends Error {}
+
 const closeLateAcquisition = async <A>(
   signal: AbortSignal,
   acquire: () => Promise<A>,
@@ -1284,22 +1319,25 @@ const closeLateAcquisition = async <A>(
   try {
     await close(acquired);
   } catch {
-    // No caller remains to observe a late cleanup failure, and provider details
-    // must not escape through an unhandled rejection.
+    // The captured runtime reports cleanup failures before this callback absorbs rejection.
   }
-  throw new Error("The interrupted browser acquisition completed late");
+  throw new LateBrowserAcquisition("The interrupted browser acquisition completed late");
 };
 
 const closeWithWarning = (close: () => Promise<void>, warning: string): Effect.Effect<void> =>
   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* (
@@ -1459,15 +1497,21 @@ const makeRequestListener =
 
     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");
+      .catch((cause) => {
+        state.violation.value = protocolError(
+          "Resolving an intercepted browser request failed",
+          cause,
+        );
       })
       .finally(() => {
         state.pendingRequests.delete(observed);
@@ -1923,10 +1967,31 @@ const cdpCommand = <A>(
 ): Effect.Effect<A, InteractiveBrowserError> =>
   Effect.scoped(
     Effect.gen(function* () {
+      const cleanupContext = yield* Effect.context<never>();
+
       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)),
+                ),
+              ),
+            );
+
+            void pending.then(undefined, (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()
@@ -1949,7 +2014,11 @@ const cdpCommand = <A>(
       });
 
       return yield* Schema.decodeUnknownEffect(output)(raw).pipe(
-        Effect.mapError(() => protocolError(malformedMessage)),
+        Effect.catch((error) =>
+          reportBrowserCause("interactive.command.decode", Cause.fail(error)).pipe(
+            Effect.andThen(Effect.fail(reportedBrowserError(protocolError(malformedMessage)))),
+          ),
+        ),
       );
     }),
   );
@@ -1981,14 +2050,25 @@ const makeHostService = (
     // Remote termination is authoritative. Local cleanup must not veto it or extend the deadline.
     yield* runTeardown(entries).pipe(
       Effect.flatMap((failures) =>
-        Effect.forEach(failures, (failure) => Effect.logWarning(failure.warning), {
-          discard: true,
-        }),
+        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(() =>
-        Effect.logWarning("Local browser teardown incomplete after confirmed termination"),
+      Effect.catchCause((cause) =>
+        reportBrowserCause("interactive.cleanup", cause).pipe(
+          Effect.andThen(
+            Effect.logWarning("Local browser teardown incomplete after confirmed termination"),
+          ),
+        ),
       ),
     );
   });
@@ -1998,10 +2078,10 @@ const makeHostService = (
   ) {
     const sessionId = yield* Effect.try({
       try: browser.sessionId,
-      catch: () => actionError("close"),
+      catch: (cause) => actionError("close", cause),
     }).pipe(
       Effect.flatMap(Schema.decodeUnknownEffect(BrowserRunSessionId)),
-      Effect.mapError(() => actionError("close")),
+      Effect.mapError((cause) => actionError("close", cause)),
       Effect.onError(() =>
         closeWithWarning(browser.close, "Closing an unidentified browser failed"),
       ),
@@ -2018,8 +2098,26 @@ const makeHostService = (
     const scope = yield* Scope.Scope;
     const fixedPolicy = yield* snapshotPolicy(policy);
     const startedAt = yield* Effect.clockWith((clock) => clock.currentTimeMillis);
-    // Late SDK replies outlive the opening fiber; cleanup retains this pass's clock.
-    const runCleanup = Effect.runPromiseWith(Context.make(Clock.Clock, yield* Clock.Clock));
+
+    // Late SDK replies retain this pass's clock and private reporting scope.
+    const runCleanup = <A, E>(effect: Effect.Effect<A, E>) =>
+      Effect.runPromiseWith(cleanupContext)(
+        effect.pipe(
+          Effect.tapCause((cause) => reportBrowserCause("interactive.lateCleanup", cause)),
+        ),
+      );
+
+    const cleanupContext = yield* Effect.context<never>();
+
+    const observeLate = <A>(signal: AbortSignal, pending: Promise<A>): Promise<A> => {
+      // Observe the original Promise without creating another rejected continuation.
+      void pending.then(undefined, (cause) => {
+        if (signal.aborted && !(cause instanceof LateBrowserAcquisition))
+          return runCleanup(reportBrowserCause("interactive.acquire", Cause.fail(cause)));
+      });
+
+      return pending;
+    };
 
     const state: HandleState = {
       closed: { value: false },
@@ -2039,22 +2137,31 @@ const makeHostService = (
       Effect.suspend(() =>
         lifecycle.managedTeardownInstalled
           ? Effect.void
-          : entry.close.pipe(Effect.catchCause(() => Effect.logWarning(entry.warning))),
+          : 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(
+            observeLate(
               signal,
-              () => binding.acquire(keepAliveMillis(fixedPolicy)),
-              (id) =>
-                runCleanup(
-                  Schema.decodeUnknownEffect(BrowserRunSessionId)(id).pipe(
-                    Effect.flatMap((value) => terminate(Redacted.make(value), [])),
+              closeLateAcquisition(
+                signal,
+                () => binding.acquire(keepAliveMillis(fixedPolicy)),
+                (id) =>
+                  runCleanup(
+                    Schema.decodeUnknownEffect(BrowserRunSessionId)(id).pipe(
+                      Effect.flatMap((value) => terminate(Redacted.make(value), [])),
+                    ),
                   ),
-                ),
+              ),
             ),
           catch: (cause) =>
             isCapacityRefusal(cause)
@@ -2080,7 +2187,11 @@ const makeHostService = (
           return lifecycle.managedTeardownInstalled
             ? Effect.void
             : terminate(Redacted.make(id), []).pipe(
-                Effect.catch(() => Effect.logWarning("Whole-browser cleanup remains unconfirmed")),
+                Effect.catchCause((cause) =>
+                  reportBrowserCause("interactive.close", cause).pipe(
+                    Effect.andThen(Effect.logWarning("Whole-browser cleanup remains unconfirmed")),
+                  ),
+                ),
               );
         }),
       { interruptible: true },
@@ -2096,10 +2207,13 @@ const makeHostService = (
           withinDeadline(
             Effect.tryPromise({
               try: (signal) =>
-                closeLateAcquisition(
+                observeLate(
                   signal,
-                  () => binding.connect(sessionIdValue),
-                  (acquired) => runCleanup(closeAcquired(acquired)),
+                  closeLateAcquisition(
+                    signal,
+                    () => binding.connect(sessionIdValue),
+                    (acquired) => runCleanup(closeAcquired(acquired)),
+                  ),
                 ),
               catch: (cause) =>
                 protocolError("Connecting to the Browser Run session failed", cause),
@@ -2156,7 +2270,17 @@ const makeHostService = (
           withinDeadline(
             Effect.tryPromise({
               try: (signal) =>
-                closeLateAcquisition(signal, browser.createContext, (acquired) => acquired.close()),
+                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()
@@ -2178,7 +2302,17 @@ const makeHostService = (
           withinDeadline(
             Effect.tryPromise({
               try: (signal) =>
-                closeLateAcquisition(signal, context.newPage, (acquired) => acquired.close()),
+                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()
@@ -2244,7 +2378,12 @@ const makeHostService = (
 
         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(() =>
@@ -2254,8 +2393,12 @@ const makeHostService = (
                   state.disconnected.value = true;
                 }).pipe(
                   Effect.andThen(cached),
-                  Effect.catch(() =>
-                    Effect.logWarning("Whole-browser cleanup remains unconfirmed"),
+                  Effect.catchCause((cause) =>
+                    reportBrowserCause("interactive.close", cause).pipe(
+                      Effect.andThen(
+                        Effect.logWarning("Whole-browser cleanup remains unconfirmed"),
+                      ),
+                    ),
                   ),
                 ),
               ),