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

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-xJ83Qjhu.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-xJ83Qjhu.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.109","dependencies":{"@effect-agent/storage-cloudflare":"0.1.0-beta.109","@effect/platform-browser":"4.0.0-rc.115","@effect/sql-sqlite-do":"4.0.0-rc.115","effect-agent":"0.1.0-beta.109"},"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.109","@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"),
+                      ),
+                    ),
                   ),
                 ),
               ),

package/src/internal/browser-binding.ts

@@ -0,0 +1,82 @@
+/// <reference types="@cloudflare/workers-types" />
+import puppeteer, { type Browser } from "@cloudflare/puppeteer";
+import { Context, Layer, Schema } from "effect";
+
+import { browserFailure, BrowserRunFailure } from "./browser-failure.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. */
+export class BrowserRunBinding extends Context.Service<
+  BrowserRunBinding,
+  {
+    readonly acquire: (
+      keepAliveMillis: number,
+      operation: "protected.acquire" | "interactive.acquire",
+    ) => Promise<string>;
+    readonly connect: (sessionId: string, operation: string) => Promise<Browser>;
+  }
+>()("@effect-agent/platform-cloudflare/internal/BrowserRunBinding") {
+  static layer(browser: Pick<BrowserRun, "fetch">) {
+    return Layer.succeed(this)({
+      // One allocation path, with recording explicitly disabled for private sessions.
+      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 {
+            // Body cancellation cannot replace the acquisition refusal.
+          }
+          throw failure;
+        }
+
+        return Schema.decodeUnknownSync(Acquired)(await response.json()).sessionId;
+      },
+      // The SDK embeds bodies and session IDs in errors; retain status before that loss.
+      connect: async (sessionId, operation) => {
+        let failure: BrowserRunFailure | undefined;
+
+        try {
+          return await puppeteer.connect(
+            {
+              fetch: async (input: RequestInfo | URL, init?: RequestInit) => {
+                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);
+        }
+      },
+    });
+  }
+}

package/src/internal/browser-failure.ts

@@ -0,0 +1,92 @@
+import type { Effect } from "effect";
+import { Cause, Data, ErrorReporter, Predicate, Schema } from "effect";
+
+/** Source-authored stages and classifications only; never retain SDK text or session capabilities. */
+export class BrowserRunFailure extends Data.TaggedError("BrowserRunFailure")<{
+  readonly operation: string;
+  readonly reason:
+    | "provider"
+    | "timeout"
+    | "malformed"
+    | "configuration"
+    | "authorization"
+    | "rate-limited"
+    | "pending";
+  readonly status?: number;
+  readonly cause?: BrowserRunFailure | { readonly name: string };
+}> {
+  readonly [ErrorReporter.severity] = "Error" as const;
+}
+
+/** A public projection of an already reported private failure must not produce another issue. */
+export const reportedBrowserError = <A extends object>(error: A): A =>
+  Object.assign(error, { [ErrorReporter.ignore]: true });
+
+export const inheritBrowserReport = <A extends object>(original: unknown, error: A): A =>
+  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 = new Set([
+  "TypeError",
+  "RangeError",
+  "SyntaxError",
+  "TimeoutError",
+  "SchemaError",
+]);
+
+export const browserFailure = (operation: string, cause?: unknown): BrowserRunFailure =>
+  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. */
+export const reportBrowserCause = <E>(
+  operation: string,
+  cause: Cause.Cause<E>,
+): Effect.Effect<void> =>
+  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;
+          }
+        }),
+    ),
+  );