effect-browserbase 0.1.0-beta.102 → 0.1.0-beta.104

package/README.md

@@ -210,6 +210,15 @@ Coordinates are CSS pixels in the main frame's viewport. Each call is one native
 
 `hover` places the pointer on one exact element where it is, by selector or by the node an observation named (`session.hoverElement`). It never scrolls to reach it, because that would hide a scripted scroll inside a native-input operation. If the pointer cannot be placed on the element (it is outside the viewport, has no area, or something covers it) the call fails `not-visible` and `undispatched`.
 
+For a child-frame element, hover checks the commanded point through each ancestor
+frame and then the exact node, including cross-origin documents. The receipt
+still uses main-viewport CSS coordinates. An overlay or clipping ancestor refuses
+input. Frame traversal is bounded at 32 levels, with bounded shadow/DOM ancestry
+checks. Axis-aligned translation and positive scaling are supported; rotation,
+perspective and other unsupported frame mappings are refused rather than guessed.
+These reads and native input are separate operations in the browser: page script
+can still change geometry between validation and dispatch.
+
 An `InputReceipt` carries the target it was sent to, the position this owner commanded (null until it has placed the pointer on that page), and an interval on the same host monotonic clock that stamps `CapturedFrame.receivedMonotonicNanos`. Input and pixels share one timeline, so a compositor can place the pointer on the frame that shows it. A wheel event is dispatched, not awaited: the receipt does not claim the page finished scrolling or that any frame shows it.
 
 ### Real key input
@@ -412,6 +421,34 @@ Live capture frames carry owned JPEG bytes, captured target identity, sequence n
 
 Closing, navigating, detaching a relevant frame, or resizing the captured page ends its interval explicitly without ending a sibling page's capture. `Capture.start(session, { lifetime: "page" })` instead follows a page's main frame across documents: start it before a navigation and it covers the loading in between. The native screencast is never restarted for a navigation, so a boundary is not a gap this package introduced. Each frame carries the `document` it was received during (0, then one more per navigation), and the summary's bounded `documentBoundaries` give the last sequence before each one and the address it committed, with `initialUrl` for document 0. That is attribution by receipt order, not proof of whose pixels a frame shows: one received just after a navigation can still show the document before it. Selecting another page or frame does not invalidate an unrelated interval. Handoff pause, connection loss, an uncertain owner and session closure still invalidate all child intervals. A confirmed native stop releases only its own reservation; a failed stop on a live page keeps that target quarantined. A definitively closed page releases its capture reservation. Stopping a child capture does not close its browser. The frame seam has **no website-audio source**, so this package does not synthesize silent samples or infer audio support from a video container. Caller encoding is demonstrated in `examples/record-video.ts`; the example decodes every generated frame with the caller's FFmpeg and checks presentation timestamps and pixel checksums. Native acceptance requires changing pixels and source-time agreement rather than accepting container headers as video evidence. Filming across a navigation with one page-lifetime interval, resampled onto a constant-rate reel with the address of each document reported, is demonstrated in `examples/realistic-footage`.
 
+### Read metadata while capture is running
+
+```ts
+const interval = yield * Capture.start(session, { lifetime: "page" });
+const current = yield * interval.snapshot;
+// current.phase is "capturing"; initialUrl and recorded documentBoundaries are available now.
+```
+
+`snapshot` copies the bounded metadata already recorded in host memory. It does
+no browser work, consumes no frames, charges no action, and works while the page
+is held. Repeated reads neither stop nor restart capture. `observedMonotonicNanos`
+stamps the read; each boundary retains its own commit observation time. The
+prefix holds at most 64 boundaries; `documentBoundariesTruncated` reports overflow
+and `currentDocument` continues counting. Addresses longer than the existing
+bound remain `null`. The model should not receive these host-only addresses by
+accident merely because it can inspect the page.
+
+While capturing, `reason` and `nativeStop` are `null`. `phase: "stopping"` means
+capture has stopped accepting frames but native cleanup is pending. `"stopped"`
+means that cleanup attempt settled; only `nativeStop: "confirmed"` confirms the
+native stop. All snapshots are observations of accounting so far: buffered frames
+can still be drained after stop. For final accounting, stop or await capture
+termination, finish draining `frames`, then read `completed` to obtain the terminal
+summary with final delivery counts. Preserve the terminal error and loss counters
+when reconciling earlier snapshots. `late` remains included in `dropped`, and
+`upstreamDrops` remains `"unknown"`; live metadata adds no stronger pixel or loss
+guarantee.
+
 ### What a compositor is given, and what it owns
 
 Footage from `capture` is the page surface. It has no pointer, no tab strip and no address bar, so on its own it reads as the inside of a tab rather than as a browser. Drawing those is the application's, exactly as cursor artwork, easing and encoding are: this package has no window-compositing API and will not grow one. What it owes a compositor is the evidence only it can see, on one timeline:
@@ -436,6 +473,43 @@ Partial native failures fence the session as uncertain; there is no success rece
 
 ## Development and evidence
 
-Repository commands use Vite+: `vp run check`, `vp test`, `vp run install:test-browser`, `vp run test:native`, `vp pack`. Native tests use Playwright 1.63.0 Chromium against loopback HTTP fixtures over the real CDP boundary. Unit tests use Effect TestClock and a provider scripted through `fetch` behind the real Client. Those local boundaries remain distinct from hosted Browserbase evidence: a local CDP pass proves native integration, not provider allocation, Live View authorization, provider recording/audio behavior, recording coexistence, or Browserbase network behavior.
+Repository commands use Vite+: `vp run check`, `vp test`, `vp run install:test-browser`, `vp run test:native`, `vp pack`. Native tests use Playwright 1.63.0 Chromium against loopback HTTP fixtures over the real CDP boundary. Hosted-path fixtures script provider allocation/status behind the real Client; the independent local-owner tests use no account service or provider responses. Unit tests use Effect TestClock, with real-process lifecycle tests explicitly using the live clock. These local boundaries remain distinct from hosted Browserbase evidence: a local CDP pass proves native integration, not provider allocation, Live View authorization, provider recording/audio behavior, recording coexistence, or Browserbase network behavior.
 
 `tools/packed-consumer.sh` installs the emitted npm tarballs into separate consumers with exact public dependency versions, checks NodeNext declarations, and runs the unchanged native suites without workspace aliases. It also runs real programs directly on Node and Bun: `test/consumer/resources.ts` with no Playwright and no framework installed, and `test/consumer/native.ts` against a real local Chromium.
+
+## Independent local Chromium
+
+`effect-browserbase/local-browser` provides `LocalBrowser`. It uses the same modeled browser owner, native driver, exact-node observations, bootstrap bindings, capture and page control as a hosted session. It requires no Browserbase client, project, key, allocation response or provider endpoint. `BrowserSession<E>` is their shared modeled capability; `BrowserbaseSession<E>` retains the separate provider reference, artifacts, Live View, handoff and release contracts.
+
+```ts
+import { Effect } from "effect";
+import { BrowserPolicy, NavigateRequest } from "effect-browserbase/browser-data";
+import { LocalBrowser } from "effect-browserbase/local-browser";
+
+const program = Effect.scoped(
+  Effect.gen(function* () {
+    const browser = yield* LocalBrowser;
+    const session = yield* browser.open(BrowserPolicy.unrestricted());
+    yield* session.bind().navigate(NavigateRequest.make({ url: "https://example.com" }));
+    return yield* session.observe({ scope: "viewport" });
+  }),
+).pipe(
+  Effect.provide(
+    LocalBrowser.layer({
+      viewport: { width: 1280, height: 720 },
+      pageControl: true,
+      launch: { headless: true, chromiumSandbox: true },
+    }),
+  ),
+);
+```
+
+Layer construction validates configuration and starts nothing. The optional `playwright-core` peer is loaded only when needed. `acquire(policy, { bootstrap })` starts one owned Chromium process and registers cleanup before waiting for a connection; its cached `connect` yields one `LocalSession<E>`. `open` combines those steps. Bootstrap consumer errors and services remain in the acquisition signatures, just as for hosted sessions. `withBrowser(policy, request, use)` supervises callback failure and checks local cleanup before returning a normal result.
+
+Owned launch currently supports POSIX hosts (Linux and macOS). It uses a fresh temporary profile, an ephemeral loopback debugger port and one maintained CDP connection. The launcher owns those arguments; callers cannot replace them through `args`. `executablePath` selects an installed Chromium explicitly; otherwise the pinned Playwright executable is used. Headless mode and Chromium sandboxing default to enabled. `chromiumSandbox: false` is an explicit host exception, never inferred from `CI`, root execution or a connection failure. Setting the option alone does not prove the operating system's sandbox configuration. Startup waiting is bounded by `startupTimeoutMillis` (15 seconds by default, at most 60 seconds) and the owner's remaining lifetime. Acquisition does not retry a failed launch.
+
+For an externally owned Chromium, use `browser.attach(endpoint, { policy, target?, bootstrap? })`. `endpoint` is a `Redacted<string>` containing the exact `ws://127.0.0.1:PORT/devtools/browser/ID` or IPv6-loopback equivalent advertised by that browser. HTTP discovery URLs, non-loopback hosts, credentials, queries and fragments are refused. This validates the control endpoint's shape; it does not authenticate the host running it. A supplied `target.targetId` must identify an existing page. Without one, several candidate pages are an explicit ambiguity error. Attachment preserves the existing viewport and does not replay the layer's launch arguments or create a replacement browser. Coordinate any independent controllers yourself, especially when enabling page control.
+
+Local identity is `{ provider: "local", id }`, identifying this ownership lifetime. It is not a Browserbase session reference, a PID or an attachment credential. `close` and `cleanupResult` retain `connection` and `process` facts separately. Owned cleanup fences operations, stops capture, disposes initialization, disconnects and terminates its process group; only observed termination permits removing the temporary profile. Failure or timeout remains in `issues` and leaves `process: "unknown"` when exit was not established. Borrowed cleanup disconnects its own client and reports `process: "not-owned"`; it never terminates the external process. Repeated close calls share one result. No local result has a provider `remote: "confirmed"` field. `onCleanup` receives these bounded, host-only facts even when connection setup fails after launch.
+
+`launch.proxy: { server, bypass? }` forwards an existing host-operated proxy to Chromium. With a proxy, the default bypass value is `<-loopback>` so Chromium does not silently exclude loopback destinations; a different bypass is an explicit host choice. Additional reviewed native flags, such as disabling QUIC and non-proxied WebRTC UDP, can be supplied through `launch.args`. This module does not implement a proxy or qualify its transport/DNS coverage. Browser policy remains `Unrestricted`; a local endpoint, URL admission or successful local test never establishes whole-browser egress containment. Preserve and test the selected enforcing proxy independently. Hosted endpoint validation and network policy are unchanged.

package/dist/Browser.d.mts

@@ -10,7 +10,7 @@ import { A as ReadTextRequest, B as TypeRequest, E as PageInfo, G as WheelReques
 import { t as LaunchRecipe } from "./Launch-C8CfaYxb.mjs";
 import { Context, Effect, Layer, Option, Redacted, Scope } from "effect";
 declare namespace Browser_d_exports {
-  export { AttachRequest, BoundTarget, BrowserAcquisition, BrowserOptions, BrowserbaseBrowser, BrowserbaseSession, ElementAdmission, Handoff, LiveView, NavigationOperation, OpenOptions };
+  export { AttachRequest, BoundTarget, BrowserAcquisition, BrowserOptions, BrowserSession, BrowserbaseBrowser, BrowserbaseSession, ElementAdmission, Handoff, LiveView, NavigationOperation, OpenOptions };
 }
 /** Host configuration. Credentials live in the Client; a model never selects these values. */
 export interface BrowserOptions extends AutomationOptions {
@@ -83,8 +83,7 @@ export interface BoundTarget {
  * Host control over one owned browser. This is not a serializable model value: copying a
  * session object cannot copy its capture, page-control or connection authority.
  */
-export interface BrowserbaseSession<E = never> {
-  readonly reference: SessionReference;
+export interface BrowserSession<E = never> {
   /** First fail-session callback cause, preserving the consumer's error type on the host. */
   readonly failure: Effect.Effect<never, E | InitializationError>;
   /** Bounded host-only evidence; consumer causes are never projected into a page reply. */
@@ -133,17 +132,21 @@ export interface BrowserbaseSession<E = never> {
   }) => Effect.Effect<void, BrowserError>;
   /** Navigation observation is registered before the single click dispatch. */
   readonly clickAndWait: (request: ClickRequest) => Effect.Effect<ActionResult, BrowserError>;
-  readonly clickForDownload: (request: ClickRequest) => Effect.Effect<DownloadObservation, BrowserError>;
-  /** Attaches to an existing file input; an uploaded branch needs a receipt for this session. */
-  readonly selectFiles: (request: SelectFilesRequest) => Effect.Effect<ActionResult, BrowserError>;
-  /** Registers the chooser observation before the single click that opens it. */
-  readonly clickForFileSelection: (request: SelectFilesRequest) => Effect.Effect<ActionResult, BrowserError>;
   /**
    * Readiness of the current document only. Dependent operations wait for it themselves;
    * this reports it without charging an action, so a caller can decide what to do about a
    * document that predates the registrations.
    */
   readonly ready: Effect.Effect<ReadinessOutcome, InitializationError>;
+}
+/** Browserbase identity, remote artifacts and provider cleanup remain hosted capabilities. */
+export interface BrowserbaseSession<E = never> extends BrowserSession<E> {
+  readonly reference: SessionReference;
+  readonly clickForDownload: (request: ClickRequest) => Effect.Effect<DownloadObservation, BrowserError>;
+  /** Attaches to an existing file input; an uploaded branch needs a receipt for this session. */
+  readonly selectFiles: (request: SelectFilesRequest) => Effect.Effect<ActionResult, BrowserError>;
+  /** Registers the chooser observation before the single click that opens it. */
+  readonly clickForFileSelection: (request: SelectFilesRequest) => Effect.Effect<ActionResult, BrowserError>;
   readonly liveView: (expiresInSeconds?: number) => Effect.Effect<LiveView, BrowserError>;
   readonly beginHandoff: (expiresInSeconds?: number) => Effect.Effect<Handoff, BrowserError>;
   readonly resume: (token: Redacted.Redacted<string>, operatorReleasedControl: boolean) => Effect.Effect<Observation, BrowserError>;

package/dist/Browser.mjs

@@ -1,2 +1,223 @@
-import { n as BrowserbaseBrowser } from "./Browser-joE4Zgys.mjs";
-export { BrowserbaseBrowser };
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Identifier } from "./References.mjs";
+import { BrowserError } from "./Errors.mjs";
+import { DownloadObservation } from "./Transfers.mjs";
+import { t as BrowserbaseClient } from "./Client-D1_xYM9o.mjs";
+import { ActionResult, AutomationOptions, BrowserPolicy, ClickRequest, InlineFiles, Selector, Viewport } from "./BrowserData.mjs";
+import { t as BrowserbaseSessions } from "./Sessions-CtbseWEh.mjs";
+import { t as issuedUpload } from "./Issued-DejqoMYL.mjs";
+import { d as empty } from "./Bootstrap-BXuzZojd.mjs";
+import { t as BrowserbaseBrowserBinding } from "./BrowserBinding-DlJTGYZL.mjs";
+import { a as decoded, c as preparePlan, i as checked, l as compileBootstrap, n as borrowedRemote, o as makeSession$1, r as ownedRemote, s as makeBindings, t as acquireSession } from "./Session-D4nT9hOO.mjs";
+import { Context, Effect, Layer, Scope } from "effect";
+//#region src/Browser.ts
+var Browser_exports = /* @__PURE__ */ __exportAll({ BrowserbaseBrowser: () => BrowserbaseBrowser });
+/**
+* Uploaded selection is admitted by the identity of a receipt this package issued for this
+* exact session, never by a path read off the caller's value. A fabricated receipt has no
+* issuance record, so an arbitrary server pathname can never become an attached file.
+*/
+const selection = (request, reference, operation) => Effect.suspend(() => {
+	const invalid = BrowserError.make({
+		operation,
+		reason: "configuration",
+		outcome: "undispatched"
+	});
+	if (request.selection._tag === "Inline") return checked(InlineFiles, request.selection.files, operation).pipe(Effect.map((files) => files.map((file) => ({
+		_tag: "Inline",
+		name: file.name,
+		mediaType: file.mediaType,
+		bytes: new Uint8Array(file.bytes)
+	}))));
+	const uploads = request.selection.uploads;
+	if (!Array.isArray(uploads) || uploads.length < 1 || uploads.length > 8) return Effect.fail(invalid);
+	const files = [];
+	for (const receipt of uploads) {
+		const issued = issuedUpload(receipt);
+		if (issued === void 0) return Effect.fail(BrowserError.make({
+			operation,
+			reason: "authorization",
+			outcome: "undispatched"
+		}));
+		if (issued.reference.projectId !== reference.projectId || issued.reference.sessionId !== reference.sessionId) return Effect.fail(BrowserError.make({
+			operation,
+			reason: "authorization",
+			outcome: "undispatched"
+		}));
+		files.push({
+			_tag: "Remote",
+			path: issued.remotePath
+		});
+	}
+	return Effect.succeed(files);
+});
+const makeSession = (controls, bindings) => {
+	const session = makeSession$1(controls, bindings);
+	const navigate = (url) => decoded(ActionResult, "action-result")({ url });
+	return Object.assign(session, {
+		reference: controls.reference,
+		clickForDownload: (request) => checked(ClickRequest, request, "download-action").pipe(Effect.flatMap((value) => controls.clickForDownload(value.selector)), Effect.flatMap((raw) => decoded(DownloadObservation, "download-action")({
+			...raw,
+			reference: controls.reference
+		}))),
+		selectFiles: (request) => checked(Selector, request.selector, "select-files").pipe(Effect.flatMap((selector) => selection(request, controls.reference, "select-files").pipe(Effect.flatMap((files) => controls.selectFiles(selector, files)))), Effect.flatMap(navigate)),
+		clickForFileSelection: (request) => checked(Selector, request.selector, "file-chooser").pipe(Effect.flatMap((selector) => selection(request, controls.reference, "file-chooser").pipe(Effect.flatMap((files) => controls.clickForFileSelection(selector, files)))), Effect.flatMap(navigate)),
+		liveView: (ttl = 60) => controls.liveView(ttl),
+		beginHandoff: (ttl = 60) => controls.beginHandoff(ttl),
+		resume: (token, released) => controls.resume(token, released),
+		detach: controls.detach,
+		reconnect: (released) => controls.reconnect(released),
+		close: controls.close,
+		cleanupResult: controls.cleanupResult
+	});
+};
+/**
+* Credentials, budgets and connection lifetime are fixed when this Layer is built. Building it
+* allocates nothing and loads no native peer; every acquisition is scoped by its caller.
+*/
+var BrowserbaseBrowser = class BrowserbaseBrowser extends Context.Service()("effect-browserbase/Browser") {
+	static layer(options) {
+		return Layer.effect(BrowserbaseBrowser, Effect.gen(function* () {
+			const client = yield* BrowserbaseClient;
+			const sessions = yield* BrowserbaseSessions;
+			const binding = yield* BrowserbaseBrowserBinding;
+			const automation = yield* checked(AutomationOptions, projected(options), "configure");
+			const viewport = yield* checked(Viewport, options.launch.viewport._tag === "Fixed" ? {
+				width: options.launch.viewport.width,
+				height: options.launch.viewport.height
+			} : {
+				width: 1280,
+				height: 720
+			}, "configure");
+			const actionTimeoutMillis = automation.actionTimeoutMillis ?? 1e4;
+			const maxPages = automation.maxPages ?? 10;
+			const pageControl = automation.pageControl ?? false;
+			const popupPolicy = automation.popupPolicy ?? "retain";
+			const dialogPolicy = automation.dialogPolicy ?? "dismiss";
+			if (pageControl && (options.launch.keepAlive === true || popupPolicy === "pause" || dialogPolicy === "pause")) return yield* BrowserError.make({
+				operation: "configure",
+				reason: "unsupported",
+				outcome: "undispatched"
+			});
+			if (options.launch.context?.persist === true && options.contextWriter === void 0) return yield* BrowserError.make({
+				operation: "configure",
+				reason: "context-lease"
+			});
+			if (Object.prototype.hasOwnProperty.call(options, "bootstrap")) return yield* BrowserError.make({
+				operation: "configure",
+				reason: "configuration",
+				outcome: "undispatched"
+			});
+			const driver = {
+				pageControl,
+				viewport,
+				maxPages,
+				popupPolicy,
+				dialogPolicy,
+				preserveViewport: options.launch.viewport._tag !== "Fixed",
+				...automation.initialPage === void 0 ? {} : "targetId" in automation.initialPage ? { initialTargetId: automation.initialPage.targetId } : { newPage: true }
+			};
+			const acquire = Effect.fnUntraced(function* (policy, request = {}) {
+				const fixed = yield* checked(BrowserPolicy, policy, "configure");
+				const plan = yield* preparePlan(request.bootstrap ?? empty);
+				const scope = yield* Scope.fork(yield* Scope.Scope, "sequential");
+				const bindings = yield* makeBindings(plan).pipe(Scope.provide(scope));
+				const bootstrap = compileBootstrap(plan);
+				const acquired = yield* acquireSession({
+					maxActions: fixed.maxActions,
+					maxElapsedMillis: fixed.maxElapsedMillis,
+					actionTimeoutMillis
+				}, {
+					remote: ownedRemote({
+						launch: options.launch,
+						...options.contextWriter === void 0 ? {} : { contextWriter: options.contextWriter },
+						...options.onCleanup === void 0 ? {} : { onCleanup: options.onCleanup },
+						...options.onAllocationUncertain === void 0 ? {} : { onAllocationUncertain: options.onAllocationUncertain }
+					}),
+					keepAlive: options.launch.keepAlive === true,
+					driver: {
+						...driver,
+						...bootstrap === void 0 ? {} : { bootstrap }
+					},
+					connectBindings: bindings.connect,
+					maxReturnedBytes: fixed.maxReturnedBytes
+				}).pipe(Effect.provideService(BrowserbaseClient, client), Effect.provideService(BrowserbaseSessions, sessions), Effect.provideService(BrowserbaseBrowserBinding, binding), Scope.provide(scope));
+				const connected = yield* Effect.cached(acquired.connect.pipe(Effect.map((controls) => makeSession(controls, bindings))));
+				return {
+					reference: acquired.reference,
+					attempt: acquired.lease.attempt,
+					failure: bindings.failure,
+					close: acquired.close,
+					connect: Effect.raceFirst(bindings.failure, acquired.connect.pipe(Effect.andThen(connected))).pipe(Effect.onError(() => acquired.close.pipe(Effect.asVoid)))
+				};
+			});
+			/**
+			* Borrowing a session another process allocated. The launch recipe is not replayed and
+			* no allocation is attempted: the requested target is resolved explicitly, credentials
+			* are fetched fresh because expiry races the caller's own status read, and this scope
+			* disconnects locally without ever requesting release. Detaching and reattaching inside
+			* a borrowed scope is deliberately absent; attaching again is the cross-process path,
+			* and it revalidates the session instead of assuming it is still there.
+			*/
+			const attach = Effect.fnUntraced(function* (reference, request) {
+				const fixed = yield* checked(BrowserPolicy, request.policy, "configure");
+				const plan = yield* preparePlan(request.bootstrap ?? empty);
+				const scope = yield* Scope.fork(yield* Scope.Scope, "sequential");
+				const bindings = yield* makeBindings(plan).pipe(Scope.provide(scope));
+				const bootstrap = compileBootstrap(plan);
+				const targetId = request.target === void 0 ? void 0 : yield* checked(Identifier, request.target.targetId, "configure");
+				const acquired = yield* acquireSession({
+					maxActions: fixed.maxActions,
+					maxElapsedMillis: fixed.maxElapsedMillis,
+					actionTimeoutMillis
+				}, {
+					remote: borrowedRemote({
+						reference,
+						...request.pendingWaitMillis === void 0 ? {} : { pendingWaitMillis: request.pendingWaitMillis },
+						...options.onCleanup === void 0 ? {} : { onCleanup: options.onCleanup }
+					}),
+					keepAlive: false,
+					driver: {
+						...driver,
+						...bootstrap === void 0 ? {} : { bootstrap },
+						newPage: false,
+						preserveViewport: true,
+						...targetId === void 0 ? {} : { initialTargetId: targetId }
+					},
+					maxReturnedBytes: fixed.maxReturnedBytes,
+					connectBindings: bindings.connect
+				}).pipe(Effect.provideService(BrowserbaseClient, client), Effect.provideService(BrowserbaseSessions, sessions), Effect.provideService(BrowserbaseBrowserBinding, binding), Scope.provide(scope));
+				return yield* Effect.raceFirst(bindings.failure, acquired.connect.pipe(Effect.map((controls) => makeSession(controls, bindings)))).pipe(Effect.onError(() => acquired.close.pipe(Effect.asVoid)));
+			});
+			return BrowserbaseBrowser.of({
+				acquire,
+				attach,
+				open: (policy, request) => acquire(policy, request).pipe(Effect.flatMap((acquired) => acquired.connect)),
+				withBrowser: (policy, request, use) => Effect.scoped(Effect.gen(function* () {
+					const session = yield* (yield* acquire(policy, request)).connect;
+					const result = yield* Effect.raceFirst(session.failure, Effect.suspend(() => use(session)));
+					const cleanup = yield* session.close;
+					if (cleanup.remote !== "confirmed" || cleanup.local !== "closed" || cleanup.issues.length > 0) return yield* BrowserError.make({
+						operation: "close",
+						reason: "provider",
+						outcome: "unknown"
+					});
+					return result;
+				}))
+			});
+		}));
+	}
+};
+/** Only the automation fields cross the schema boundary; launch and callbacks are separate. */
+const projected = (options) => ({
+	...options.actionTimeoutMillis === void 0 ? {} : { actionTimeoutMillis: options.actionTimeoutMillis },
+	...options.maxPages === void 0 ? {} : { maxPages: options.maxPages },
+	...options.initialPage === void 0 ? {} : { initialPage: options.initialPage },
+	...options.popupPolicy === void 0 ? {} : { popupPolicy: options.popupPolicy },
+	...options.dialogPolicy === void 0 ? {} : { dialogPolicy: options.dialogPolicy },
+	...options.pageControl === void 0 ? {} : { pageControl: options.pageControl }
+});
+//#endregion
+export { BrowserbaseBrowser, Browser_exports as t };
+
+//# sourceMappingURL=Browser.mjs.map

package/dist/Browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Browser.mjs","names":["makeBrowserSession","Bootstrap.empty"],"sources":["../src/Browser.ts"],"sourcesContent":["import { Context, Effect, Layer, type Option, type Redacted, Scope } from \"effect\";\n\nimport * as Bootstrap from \"./Bootstrap.ts\";\nimport { BrowserbaseBrowserBinding } from \"./BrowserBinding.ts\";\nimport type {\n  Checkpoint,\n  CheckpointOptions,\n  FillRequest,\n  HoverRequest,\n  InputReceipt,\n  KeyStroke,\n  NavigateRequest,\n  NavigationResult,\n  ObservationOptions,\n  ObservedElement,\n  PointerMoveRequest,\n  PressRequest,\n  ReadTextRequest,\n  ScreenshotRequest,\n  ScreenshotResult,\n  ScrollRequest,\n  StartNavigationRequest,\n  TextResult,\n  TypeRequest,\n  WheelRequest,\n} from \"./BrowserData.ts\";\nimport {\n  type ControlFacts,\n  ActionResult,\n  AutomationOptions,\n  BrowserPolicy,\n  ClickRequest,\n  type FrameInfo,\n  InlineFiles,\n  type Observation,\n  type PageInfo,\n  type SelectFilesRequest,\n  Selector,\n  type Target,\n  Viewport,\n} from \"./BrowserData.ts\";\nimport type { CleanupResult } from \"./Cleanup.ts\";\nimport { BrowserbaseClient } from \"./Client.ts\";\nimport type { InitializationError } from \"./Errors.ts\";\nimport {\n  type AllocationError,\n  BrowserError,\n  type BrowserOperation,\n  type ContextError,\n  type SessionError,\n} from \"./Errors.ts\";\nimport { makeBindings, preparePlan, type Bindings } from \"./internal/browser/Bindings.ts\";\nimport { compileBootstrap } from \"./internal/browser/Bootstrap.ts\";\nimport type { NativeFileSelection } from \"./internal/browser/Driver.ts\";\nimport type { LiveView } from \"./internal/browser/LiveView.ts\";\nimport {\n  checked,\n  decoded,\n  makeSession as makeBrowserSession,\n} from \"./internal/browser/PublicSession.ts\";\nimport {\n  acquireSession,\n  borrowedRemote,\n  ownedRemote,\n  type SessionControls,\n} from \"./internal/browser/Session.ts\";\nimport type { ContextWriterPermit } from \"./internal/session/WriterFacts.ts\";\nimport { issuedUpload } from \"./internal/upload/Issued.ts\";\nimport type { LaunchRecipe } from \"./Launch.ts\";\nimport { Identifier, type AllocationAttempt, type SessionReference } from \"./References.ts\";\nimport { BrowserbaseSessions } from \"./Sessions.ts\";\nimport { DownloadObservation } from \"./Transfers.ts\";\n\nexport type { LiveView } from \"./internal/browser/LiveView.ts\";\n\n/** Host configuration. Credentials live in the Client; a model never selects these values. */\nexport interface BrowserOptions extends AutomationOptions {\n  readonly launch: LaunchRecipe;\n  /** Required whenever the launch recipe persists a context. */\n  readonly contextWriter?: ContextWriterPermit;\n  readonly onCleanup?: (result: CleanupResult) => Effect.Effect<void>;\n  readonly onAllocationUncertain?: (attempt: AllocationAttempt) => Effect.Effect<void>;\n}\n\nexport interface Handoff {\n  readonly token: Redacted.Redacted<string>;\n  readonly view: LiveView;\n}\n\n/**\n * A host's decision about one control, made on facts read from the exact node immediately\n * before input. Returning anything but `true`, or throwing, sends nothing and fails `denied`.\n * It is a plain synchronous function on purpose: it runs while the owner's permit is held, where\n * waiting on a model or a network call would stall every other operation. It is not an atomic\n * check-and-input transaction, because page script can still run before the native input lands.\n */\nexport interface ElementAdmission {\n  readonly admit: (facts: ControlFacts) => boolean;\n}\n\n/**\n * A navigation the browser is still performing. The owner's permit was released when it was\n * dispatched, so while it loads a host may read, `checkpoint`, hold and resume this page, and\n * use any other page. Anything that would change this page fails `busy` until it settles.\n *\n * Leaving its scope unsettled fences the session, exactly as an interrupted mutation does,\n * because nothing then knows what the browser did. It is never replayed.\n */\nexport interface NavigationOperation {\n  /** What was navigated, read before dispatch. */\n  readonly target: Target;\n  /**\n   * The document reached DOMContentLoaded. It belongs to this one navigation: a successor that\n   * reaches the same URL fails it instead. Interrupting a waiter stops nothing in the browser.\n   */\n  readonly completed: Effect.Effect<NavigationResult, BrowserError>;\n  /**\n   * Asks the browser to stop loading and waits for this navigation to settle, after which\n   * `completed` fails `interrupted`. Success is a known outcome and the session stays usable:\n   * the page holds whatever had loaded. It does not undo anything the page already did.\n   */\n  readonly stop: Effect.Effect<void, BrowserError>;\n}\n\n/** One selected page and frame at one connection generation, never the current DOM. */\nexport interface BoundTarget {\n  readonly navigate: (request: NavigateRequest) => Effect.Effect<NavigationResult, BrowserError>;\n  /** `navigate`, left in flight: the same single dispatch, completed by the caller. */\n  readonly startNavigation: (\n    request: StartNavigationRequest,\n  ) => Effect.Effect<NavigationOperation, BrowserError, Scope.Scope>;\n  readonly readText: (request: ReadTextRequest) => Effect.Effect<TextResult, BrowserError>;\n  readonly click: (request: ClickRequest) => Effect.Effect<ActionResult, BrowserError>;\n  readonly fill: (request: FillRequest) => Effect.Effect<ActionResult, BrowserError>;\n  /** Script in the page: instantaneous, and it raises no wheel event. */\n  readonly scroll: (request: ScrollRequest) => Effect.Effect<ActionResult, BrowserError>;\n  /** One real pointer move, in main-frame viewport pixels. */\n  readonly pointerMove: (request: PointerMoveRequest) => Effect.Effect<InputReceipt, BrowserError>;\n  /** Places the pointer on one exact element where it is, or fails `not-visible` unsent. */\n  readonly hover: (request: HoverRequest) => Effect.Effect<InputReceipt, BrowserError>;\n  /** One real wheel event; the browser decides what under the pointer scrolls. */\n  readonly wheel: (request: WheelRequest) => Effect.Effect<InputReceipt, BrowserError>;\n  /** One real key stroke to whatever has focus, or fails `not-focused` unsent if `into` lacks it. */\n  readonly press: (request: PressRequest) => Effect.Effect<InputReceipt, BrowserError>;\n  /** Text as the real key strokes that produce it, under the same focus rule as `press`. */\n  readonly type: (request: TypeRequest) => Effect.Effect<InputReceipt, BrowserError>;\n  readonly screenshot: (\n    request: ScreenshotRequest,\n  ) => Effect.Effect<ScreenshotResult, BrowserError>;\n}\n\n/**\n * Host control over one owned browser. This is not a serializable model value: copying a\n * session object cannot copy its capture, page-control or connection authority.\n */\nexport interface BrowserSession<E = never> {\n  /** First fail-session callback cause, preserving the consumer's error type on the host. */\n  readonly failure: Effect.Effect<never, E | InitializationError>;\n  /** Bounded host-only evidence; consumer causes are never projected into a page reply. */\n  readonly bindingDiagnostics: Effect.Effect<Bootstrap.BindingDiagnostics<E>>;\n  readonly bind: () => BoundTarget;\n  /** Re-reads the live selection first, so a stale generation fails before any dispatch. */\n  readonly currentTarget: Effect.Effect<BoundTarget, BrowserError>;\n  readonly target: Effect.Effect<Target, BrowserError>;\n  /**\n   * The one observation whose nodes later actions may name. `scope: \"viewport\"` keeps only text\n   * and controls that are on screen and reachable; the default reads the whole document. It is\n   * safe to show a model: it carries no destination, form or field value.\n   */\n  readonly observe: (options?: ObservationOptions) => Effect.Effect<Observation, BrowserError>;\n  /**\n   * Passive evidence for a recorder, with a picture when asked. It issues no references and\n   * leaves the observation above exactly as it was. Host-only: it carries control facts.\n   */\n  readonly checkpoint: (options?: CheckpointOptions) => Effect.Effect<Checkpoint, BrowserError>;\n  /** Host-only facts about one observed control, read from that exact node just now. */\n  readonly controlFacts: (reference: ObservedElement) => Effect.Effect<ControlFacts, BrowserError>;\n  /**\n   * After a page hold, nothing observed on that page may be acted on unchecked. This checks one\n   * reference: still attached, and still the control that was inspected. It never searches by\n   * selector or label for a substitute, and it sends nothing.\n   */\n  readonly revalidateElement: (\n    reference: ObservedElement,\n  ) => Effect.Effect<ObservedElement, BrowserError>;\n  readonly clickElement: (\n    reference: ObservedElement,\n    admission?: ElementAdmission,\n  ) => Effect.Effect<ActionResult, BrowserError>;\n  readonly fillElement: (\n    reference: ObservedElement,\n    value: string,\n    admission?: ElementAdmission,\n  ) => Effect.Effect<ActionResult, BrowserError>;\n  readonly hoverElement: (\n    reference: ObservedElement,\n    admission?: ElementAdmission,\n  ) => Effect.Effect<InputReceipt, BrowserError>;\n  /** A key stroke sent only if the exact node an observation named already has focus. */\n  readonly pressElement: (\n    reference: ObservedElement,\n    stroke: KeyStroke,\n    admission?: ElementAdmission,\n  ) => Effect.Effect<InputReceipt, BrowserError>;\n  /** Real typing with `fillElement`'s exactness: that node must already have focus. */\n  readonly typeElement: (\n    reference: ObservedElement,\n    text: string,\n    admission?: ElementAdmission,\n  ) => Effect.Effect<InputReceipt, BrowserError>;\n  readonly pages: Effect.Effect<ReadonlyArray<PageInfo>, BrowserError>;\n  readonly frames: Effect.Effect<ReadonlyArray<FrameInfo>, BrowserError>;\n  readonly selectPage: (pageId: string) => Effect.Effect<BoundTarget, BrowserError>;\n  readonly selectFrame: (frameId: string) => Effect.Effect<BoundTarget, BrowserError>;\n  /** Create a tab without selecting it. */\n  readonly createPage: Effect.Effect<string, BrowserError>;\n  readonly closePage: (pageId: string) => Effect.Effect<void, BrowserError>;\n  readonly resizeViewport: (viewport: Viewport) => Effect.Effect<void, BrowserError>;\n  readonly waitFor: (request: {\n    readonly selector: string;\n    readonly state: \"visible\" | \"hidden\" | \"attached\" | \"detached\";\n  }) => Effect.Effect<void, BrowserError>;\n  /** Navigation observation is registered before the single click dispatch. */\n  readonly clickAndWait: (request: ClickRequest) => Effect.Effect<ActionResult, BrowserError>;\n  /**\n   * Readiness of the current document only. Dependent operations wait for it themselves;\n   * this reports it without charging an action, so a caller can decide what to do about a\n   * document that predates the registrations.\n   */\n  readonly ready: Effect.Effect<Bootstrap.ReadinessOutcome, InitializationError>;\n}\n\n/** Browserbase identity, remote artifacts and provider cleanup remain hosted capabilities. */\nexport interface BrowserbaseSession<E = never> extends BrowserSession<E> {\n  readonly reference: SessionReference;\n  readonly clickForDownload: (\n    request: ClickRequest,\n  ) => Effect.Effect<DownloadObservation, BrowserError>;\n  /** Attaches to an existing file input; an uploaded branch needs a receipt for this session. */\n  readonly selectFiles: (request: SelectFilesRequest) => Effect.Effect<ActionResult, BrowserError>;\n  /** Registers the chooser observation before the single click that opens it. */\n  readonly clickForFileSelection: (\n    request: SelectFilesRequest,\n  ) => Effect.Effect<ActionResult, BrowserError>;\n  readonly liveView: (expiresInSeconds?: number) => Effect.Effect<LiveView, BrowserError>;\n  readonly beginHandoff: (expiresInSeconds?: number) => Effect.Effect<Handoff, BrowserError>;\n  readonly resume: (\n    token: Redacted.Redacted<string>,\n    operatorReleasedControl: boolean,\n  ) => Effect.Effect<Observation, BrowserError>;\n  readonly detach: Effect.Effect<\n    { readonly reference: SessionReference; readonly targetId: string },\n    BrowserError\n  >;\n  readonly reconnect: (\n    operatorReleasedControl: boolean,\n  ) => Effect.Effect<Observation, BrowserError | InitializationError>;\n  readonly close: Effect.Effect<CleanupResult, BrowserError>;\n  readonly cleanupResult: Effect.Effect<Option.Option<CleanupResult>>;\n}\n\n/** Dependencies are captured at acquisition, not erased into an environment-free service Layer. */\nexport interface OpenOptions<E = never, R = never> {\n  readonly bootstrap?: Bootstrap.Plan<E, R>;\n}\n\nexport interface AttachRequest<E = never, R = never> extends OpenOptions<E, R> {\n  readonly policy: BrowserPolicy;\n  /** The exact page to resume; without it the session must have exactly one page. */\n  readonly target?: { readonly targetId: string };\n  /** Bounded admission of a session the provider has not finished starting. */\n  readonly pendingWaitMillis?: number;\n}\n\nexport interface BrowserAcquisition<E = never> {\n  readonly reference: SessionReference;\n  readonly attempt: AllocationAttempt;\n  readonly failure: Effect.Effect<never, E | InitializationError>;\n  readonly connect: Effect.Effect<BrowserbaseSession<E>, BrowserError | E | InitializationError>;\n  readonly close: Effect.Effect<CleanupResult, BrowserError>;\n}\n\n/**\n * Uploaded selection is admitted by the identity of a receipt this package issued for this\n * exact session, never by a path read off the caller's value. A fabricated receipt has no\n * issuance record, so an arbitrary server pathname can never become an attached file.\n */\nconst selection = (\n  request: SelectFilesRequest,\n  reference: SessionReference,\n  operation: BrowserOperation,\n): Effect.Effect<ReadonlyArray<NativeFileSelection>, BrowserError> =>\n  Effect.suspend(() => {\n    const invalid = BrowserError.make({\n      operation,\n      reason: \"configuration\",\n      outcome: \"undispatched\",\n    });\n\n    if (request.selection._tag === \"Inline\") {\n      return checked(InlineFiles, request.selection.files, operation).pipe(\n        Effect.map((files) =>\n          files.map((file) => ({\n            _tag: \"Inline\" as const,\n            name: file.name,\n            mediaType: file.mediaType,\n            // The dispatched bytes cannot change after they were validated.\n            bytes: new Uint8Array(file.bytes),\n          })),\n        ),\n      );\n    }\n\n    const uploads = request.selection.uploads;\n\n    if (!Array.isArray(uploads) || uploads.length < 1 || uploads.length > 8)\n      return Effect.fail(invalid);\n    const files: NativeFileSelection[] = [];\n\n    for (const receipt of uploads) {\n      const issued = issuedUpload(receipt);\n\n      if (issued === undefined)\n        return Effect.fail(\n          BrowserError.make({ operation, reason: \"authorization\", outcome: \"undispatched\" }),\n        );\n      if (\n        issued.reference.projectId !== reference.projectId ||\n        issued.reference.sessionId !== reference.sessionId\n      )\n        return Effect.fail(\n          BrowserError.make({ operation, reason: \"authorization\", outcome: \"undispatched\" }),\n        );\n      files.push({ _tag: \"Remote\", path: issued.remotePath });\n    }\n\n    return Effect.succeed(files);\n  });\n\nconst makeSession = <E>(\n  controls: SessionControls,\n  bindings: Bindings<E>,\n): BrowserbaseSession<E> => {\n  const session = makeBrowserSession(controls, bindings);\n  const navigate = (url: string) => decoded(ActionResult, \"action-result\")({ url });\n\n  return Object.assign(session, {\n    reference: controls.reference,\n    clickForDownload: (request) =>\n      checked(ClickRequest, request, \"download-action\").pipe(\n        Effect.flatMap((value) => controls.clickForDownload(value.selector)),\n        Effect.flatMap((raw) =>\n          decoded(\n            DownloadObservation,\n            \"download-action\",\n          )({ ...raw, reference: controls.reference }),\n        ),\n      ),\n    selectFiles: (request) =>\n      checked(Selector, request.selector, \"select-files\").pipe(\n        Effect.flatMap((selector) =>\n          selection(request, controls.reference, \"select-files\").pipe(\n            Effect.flatMap((files) => controls.selectFiles(selector, files)),\n          ),\n        ),\n        Effect.flatMap(navigate),\n      ),\n    clickForFileSelection: (request) =>\n      checked(Selector, request.selector, \"file-chooser\").pipe(\n        Effect.flatMap((selector) =>\n          selection(request, controls.reference, \"file-chooser\").pipe(\n            Effect.flatMap((files) => controls.clickForFileSelection(selector, files)),\n          ),\n        ),\n        Effect.flatMap(navigate),\n      ),\n    liveView: (ttl = 60) => controls.liveView(ttl),\n    beginHandoff: (ttl = 60) => controls.beginHandoff(ttl),\n    resume: (token, released) => controls.resume(token, released),\n    detach: controls.detach,\n    reconnect: (released) => controls.reconnect(released),\n    close: controls.close,\n    cleanupResult: controls.cleanupResult,\n  } satisfies Omit<BrowserbaseSession<E>, keyof BrowserSession<E>>);\n};\n\n/**\n * Credentials, budgets and connection lifetime are fixed when this Layer is built. Building it\n * allocates nothing and loads no native peer; every acquisition is scoped by its caller.\n */\nexport class BrowserbaseBrowser extends Context.Service<\n  BrowserbaseBrowser,\n  {\n    readonly acquire: <E = never, R = never>(\n      policy: BrowserPolicy,\n      request?: OpenOptions<E, R>,\n    ) => Effect.Effect<\n      BrowserAcquisition<E>,\n      AllocationError | BrowserError | ContextError,\n      Scope.Scope | Exclude<R, Scope.Scope>\n    >;\n    /** Borrowed control of a session this process did not allocate and will not release. */\n    readonly attach: <E = never, R = never>(\n      reference: SessionReference,\n      request: AttachRequest<E, R>,\n    ) => Effect.Effect<\n      BrowserbaseSession<E>,\n      BrowserError | SessionError | E | InitializationError,\n      Scope.Scope | Exclude<R, Scope.Scope>\n    >;\n    readonly open: <E = never, R = never>(\n      policy: BrowserPolicy,\n      request?: OpenOptions<E, R>,\n    ) => Effect.Effect<\n      BrowserbaseSession<E>,\n      AllocationError | BrowserError | ContextError | E | InitializationError,\n      Scope.Scope | Exclude<R, Scope.Scope>\n    >;\n    /** Race the consumer with typed callback failure and confirm cleanup before normal success. */\n    readonly withBrowser: <E, R, A, E2, R2>(\n      policy: BrowserPolicy,\n      request: OpenOptions<E, R>,\n      use: (session: BrowserbaseSession<E>) => Effect.Effect<A, E2, R2>,\n    ) => Effect.Effect<\n      A,\n      AllocationError | BrowserError | ContextError | InitializationError | E | E2,\n      Exclude<R | R2, Scope.Scope>\n    >;\n  }\n>()(\"effect-browserbase/Browser\") {\n  static layer(\n    options: BrowserOptions,\n  ): Layer.Layer<BrowserbaseBrowser, BrowserError, BrowserbaseClient | BrowserbaseSessions> {\n    return Layer.effect(\n      BrowserbaseBrowser,\n      Effect.gen(function* () {\n        const client = yield* BrowserbaseClient;\n        const sessions = yield* BrowserbaseSessions;\n        // The engine is fixed where the Layer is built, like the account it connects for.\n        const binding = yield* BrowserbaseBrowserBinding;\n        const automation = yield* checked(AutomationOptions, projected(options), \"configure\");\n\n        const viewport = yield* checked(\n          Viewport,\n          options.launch.viewport._tag === \"Fixed\"\n            ? { width: options.launch.viewport.width, height: options.launch.viewport.height }\n            : { width: 1280, height: 720 },\n          \"configure\",\n        );\n\n        const actionTimeoutMillis = automation.actionTimeoutMillis ?? 10_000;\n        const maxPages = automation.maxPages ?? 10;\n        const pageControl = automation.pageControl ?? false;\n        const popupPolicy = automation.popupPolicy ?? \"retain\";\n        const dialogPolicy = automation.dialogPolicy ?? \"dismiss\";\n\n        if (\n          pageControl &&\n          (options.launch.keepAlive === true || popupPolicy === \"pause\" || dialogPolicy === \"pause\")\n        )\n          return yield* BrowserError.make({\n            operation: \"configure\",\n            reason: \"unsupported\",\n            outcome: \"undispatched\",\n          });\n\n        if (options.launch.context?.persist === true && options.contextWriter === undefined)\n          return yield* BrowserError.make({ operation: \"configure\", reason: \"context-lease\" });\n\n        // A retired layer-level bootstrap must not be silently discarded for JavaScript callers.\n        if (Object.prototype.hasOwnProperty.call(options, \"bootstrap\"))\n          return yield* BrowserError.make({\n            operation: \"configure\",\n            reason: \"configuration\",\n            outcome: \"undispatched\",\n          });\n\n        const driver = {\n          pageControl,\n          viewport,\n          maxPages,\n          popupPolicy,\n          dialogPolicy,\n          preserveViewport: options.launch.viewport._tag !== \"Fixed\",\n          ...(automation.initialPage === undefined\n            ? {}\n            : \"targetId\" in automation.initialPage\n              ? { initialTargetId: automation.initialPage.targetId }\n              : { newPage: true }),\n        };\n\n        const acquire = Effect.fnUntraced(function* <E = never, R = never>(\n          policy: BrowserPolicy,\n          request: OpenOptions<E, R> = {},\n        ) {\n          const fixed = yield* checked(BrowserPolicy, policy, \"configure\");\n          const plan = yield* preparePlan<E, R>(request.bootstrap ?? Bootstrap.empty);\n          // The sequential child keeps remote cleanup ahead of callback-scope finalization even\n          // when a consumer deliberately gives its outer Scope parallel finalizers.\n          const scope = yield* Scope.fork(yield* Scope.Scope, \"sequential\");\n          const bindings = yield* makeBindings(plan).pipe(Scope.provide(scope));\n          const bootstrap = compileBootstrap(plan);\n\n          const acquired = yield* acquireSession(\n            {\n              maxActions: fixed.maxActions,\n              maxElapsedMillis: fixed.maxElapsedMillis,\n              actionTimeoutMillis,\n            },\n            {\n              remote: ownedRemote({\n                launch: options.launch,\n                ...(options.contextWriter === undefined\n                  ? {}\n                  : { contextWriter: options.contextWriter }),\n                ...(options.onCleanup === undefined ? {} : { onCleanup: options.onCleanup }),\n                ...(options.onAllocationUncertain === undefined\n                  ? {}\n                  : { onAllocationUncertain: options.onAllocationUncertain }),\n              }),\n              keepAlive: options.launch.keepAlive === true,\n              driver: { ...driver, ...(bootstrap === undefined ? {} : { bootstrap }) },\n              connectBindings: bindings.connect,\n              maxReturnedBytes: fixed.maxReturnedBytes,\n            },\n          ).pipe(\n            // The Layer owns the one account and resource service; acquisition never re-resolves them.\n            Effect.provideService(BrowserbaseClient, client),\n            Effect.provideService(BrowserbaseSessions, sessions),\n            Effect.provideService(BrowserbaseBrowserBinding, binding),\n            Scope.provide(scope),\n          );\n\n          // One public session object is shared by repeated connect calls in this scope.\n          const connected = yield* Effect.cached(\n            acquired.connect.pipe(Effect.map((controls) => makeSession(controls, bindings))),\n          );\n\n          return {\n            reference: acquired.reference,\n            attempt: acquired.lease.attempt,\n            failure: bindings.failure,\n            close: acquired.close,\n            connect: Effect.raceFirst(\n              bindings.failure,\n              acquired.connect.pipe(Effect.andThen(connected)),\n            ).pipe(Effect.onError(() => acquired.close.pipe(Effect.asVoid))),\n          } satisfies BrowserAcquisition<E>;\n        });\n\n        /**\n         * Borrowing a session another process allocated. The launch recipe is not replayed and\n         * no allocation is attempted: the requested target is resolved explicitly, credentials\n         * are fetched fresh because expiry races the caller's own status read, and this scope\n         * disconnects locally without ever requesting release. Detaching and reattaching inside\n         * a borrowed scope is deliberately absent; attaching again is the cross-process path,\n         * and it revalidates the session instead of assuming it is still there.\n         */\n        const attach = Effect.fnUntraced(function* <E = never, R = never>(\n          reference: SessionReference,\n          request: AttachRequest<E, R>,\n        ) {\n          const fixed = yield* checked(BrowserPolicy, request.policy, \"configure\");\n          const plan = yield* preparePlan<E, R>(request.bootstrap ?? Bootstrap.empty);\n          const scope = yield* Scope.fork(yield* Scope.Scope, \"sequential\");\n          const bindings = yield* makeBindings(plan).pipe(Scope.provide(scope));\n          const bootstrap = compileBootstrap(plan);\n\n          const targetId =\n            request.target === undefined\n              ? undefined\n              : yield* checked(Identifier, request.target.targetId, \"configure\");\n\n          const acquired = yield* acquireSession(\n            {\n              maxActions: fixed.maxActions,\n              maxElapsedMillis: fixed.maxElapsedMillis,\n              actionTimeoutMillis,\n            },\n            {\n              remote: borrowedRemote({\n                reference,\n                ...(request.pendingWaitMillis === undefined\n                  ? {}\n                  : { pendingWaitMillis: request.pendingWaitMillis }),\n                ...(options.onCleanup === undefined ? {} : { onCleanup: options.onCleanup }),\n              }),\n              keepAlive: false,\n              driver: {\n                ...driver,\n                ...(bootstrap === undefined ? {} : { bootstrap }),\n                newPage: false,\n                preserveViewport: true,\n                ...(targetId === undefined ? {} : { initialTargetId: targetId }),\n              },\n              maxReturnedBytes: fixed.maxReturnedBytes,\n              connectBindings: bindings.connect,\n            },\n          ).pipe(\n            Effect.provideService(BrowserbaseClient, client),\n            Effect.provideService(BrowserbaseSessions, sessions),\n            Effect.provideService(BrowserbaseBrowserBinding, binding),\n            Scope.provide(scope),\n          );\n\n          return yield* Effect.raceFirst(\n            bindings.failure,\n            acquired.connect.pipe(Effect.map((controls) => makeSession(controls, bindings))),\n          ).pipe(Effect.onError(() => acquired.close.pipe(Effect.asVoid)));\n        });\n\n        return BrowserbaseBrowser.of({\n          acquire,\n          attach,\n          open: (policy, request) =>\n            acquire(policy, request).pipe(Effect.flatMap((acquired) => acquired.connect)),\n          withBrowser: (policy, request, use) =>\n            Effect.scoped(\n              Effect.gen(function* () {\n                const acquired = yield* acquire(policy, request);\n                const session = yield* acquired.connect;\n\n                const result = yield* Effect.raceFirst(\n                  session.failure,\n                  Effect.suspend(() => use(session)),\n                );\n\n                const cleanup = yield* session.close;\n\n                if (\n                  cleanup.remote !== \"confirmed\" ||\n                  cleanup.local !== \"closed\" ||\n                  cleanup.issues.length > 0\n                )\n                  return yield* BrowserError.make({\n                    operation: \"close\",\n                    reason: \"provider\",\n                    outcome: \"unknown\",\n                  });\n\n                return result;\n              }),\n            ),\n        });\n      }),\n    );\n  }\n}\n\n/** Only the automation fields cross the schema boundary; launch and callbacks are separate. */\nconst projected = (options: BrowserOptions) => ({\n  ...(options.actionTimeoutMillis === undefined\n    ? {}\n    : { actionTimeoutMillis: options.actionTimeoutMillis }),\n  ...(options.maxPages === undefined ? {} : { maxPages: options.maxPages }),\n  ...(options.initialPage === undefined ? {} : { initialPage: options.initialPage }),\n  ...(options.popupPolicy === undefined ? {} : { popupPolicy: options.popupPolicy }),\n  ...(options.dialogPolicy === undefined ? {} : { dialogPolicy: options.dialogPolicy }),\n  ...(options.pageControl === undefined ? {} : { pageControl: options.pageControl }),\n});\n"],"mappings":"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"}

package/dist/{BrowserBinding-qbQA6JhH.mjs → BrowserBinding-DlJTGYZL.mjs}

@@ -1878,10 +1878,64 @@ const makeObservation = (targets, events) => {
 //#endregion
 //#region src/internal/browser/Pointer.ts
 const Reach = Schema.Struct({
-	viewportWidth: Schema.Finite,
-	viewportHeight: Schema.Finite,
+	x: Schema.Finite,
+	y: Schema.Finite,
 	reachable: Schema.Boolean
 });
+/** Runs in each document on the path to the exact node, including cross-origin frames. */
+const hitPoint = (node, input) => {
+	const refused = {
+		x: input.x,
+		y: input.y,
+		reachable: false
+	};
+	if (!(node instanceof Element) || !node.isConnected || input.x < 0 || input.y < 0 || input.x >= innerWidth || input.y >= innerHeight) return refused;
+	let hit = node.ownerDocument.elementFromPoint(input.x, input.y);
+	for (let depth = 0; hit?.shadowRoot; depth++) {
+		if (depth >= 32) return refused;
+		const inner = hit.shadowRoot.elementFromPoint(input.x, input.y);
+		if (inner === null || inner === hit) break;
+		hit = inner;
+	}
+	if (hit === null || hit !== node && !node.contains(hit)) return refused;
+	if (!input.child) return {
+		x: input.x,
+		y: input.y,
+		reachable: true
+	};
+	if (!(node instanceof HTMLElement)) return refused;
+	let ancestor = node;
+	for (let depth = 0; ancestor !== null; depth++) {
+		if (depth >= 128) return refused;
+		const style = getComputedStyle(ancestor);
+		const rotation = style.getPropertyValue("rotate");
+		const scale = style.getPropertyValue("scale");
+		if (rotation !== "" && rotation !== "none" && rotation !== "0deg" || scale !== "" && scale !== "none" && scale.split(/\s+/).some((axis) => !(Number.parseFloat(axis) > 0)) || style.perspective !== "none" || style.offsetPath !== "" && style.offsetPath !== "none") return refused;
+		if (style.transform !== "none") {
+			const matrix = new DOMMatrixReadOnly(style.transform);
+			if (!matrix.is2D || matrix.b !== 0 || matrix.c !== 0 || matrix.a <= 0 || matrix.d <= 0) return refused;
+		}
+		const root = ancestor.getRootNode();
+		ancestor = ancestor.parentElement ?? (root instanceof ShadowRoot ? root.host : null);
+	}
+	const rect = node.getBoundingClientRect();
+	const scaleX = rect.width / node.offsetWidth;
+	const scaleY = rect.height / node.offsetHeight;
+	if (!Number.isFinite(scaleX) || !Number.isFinite(scaleY) || scaleX <= 0 || scaleY <= 0) return refused;
+	const style = getComputedStyle(node);
+	const left = Number.parseFloat(style.paddingLeft);
+	const top = Number.parseFloat(style.paddingTop);
+	const right = Number.parseFloat(style.paddingRight);
+	const bottom = Number.parseFloat(style.paddingBottom);
+	const x = (input.x - rect.left) / scaleX - node.clientLeft - left;
+	const y = (input.y - rect.top) / scaleY - node.clientTop - top;
+	if (!Number.isFinite(x) || !Number.isFinite(y) || x < 0 || y < 0 || x >= node.clientWidth - left - right || y >= node.clientHeight - top - bottom) return refused;
+	return {
+		x,
+		y,
+		reachable: true
+	};
+};
 /**
 * Real pointer input to the selected page. Every command is one the browser would receive from
 * a person, so handlers see trusted events and the browser decides what is under the pointer.
@@ -1915,33 +1969,35 @@ const makePointer = (targets, actions) => {
 			x: box.x + box.width / 2,
 			y: box.y + box.height / 2
 		};
-		const reach = safeDecode(Reach, await element.evaluate((node) => {
-			const rect = node.getBoundingClientRect();
-			const x = rect.left + rect.width / 2;
-			const y = rect.top + rect.height / 2;
-			let hit = node.ownerDocument.elementFromPoint(x, y);
-			while (hit?.shadowRoot) {
-				const inner = hit.shadowRoot.elementFromPoint(x, y);
-				if (inner === null || inner === hit) break;
-				hit = inner;
+		const ancestors = [];
+		try {
+			let frame = await element.ownerFrame();
+			if (frame === null || frame.page() !== page) throw failure("stale", "undispatched");
+			while (frame !== page.mainFrame()) {
+				if (ancestors.length >= 32) throw failure("limit", "undispatched");
+				ancestors.push(await frame.frameElement());
+				frame = frame.parentFrame();
+				if (frame === null) throw failure("stale", "undispatched");
 			}
-			return {
-				viewportWidth: window.top === window ? window.innerWidth : Number.POSITIVE_INFINITY,
-				viewportHeight: window.top === window ? window.innerHeight : Number.POSITIVE_INFINITY,
-				reachable: hit !== null && (hit === node || node.contains(hit))
-			};
-		}));
-		const viewport = Number.isFinite(reach.viewportWidth) ? {
-			width: reach.viewportWidth,
-			height: reach.viewportHeight
-		} : safeDecode(Schema.Struct({
-			width: Schema.Finite,
-			height: Schema.Finite
-		}), await page.evaluate(() => ({
-			width: window.innerWidth,
-			height: window.innerHeight
-		})));
-		if (!reach.reachable || point.x < 0 || point.y < 0 || point.x >= viewport.width || point.y >= viewport.height) throw failure("not-visible", "undispatched");
+			let localPoint = point;
+			for (const ancestor of ancestors.reverse()) {
+				const reached = safeDecode(Reach, await ancestor.evaluate(hitPoint, {
+					...localPoint,
+					child: true
+				}));
+				if (!reached.reachable) throw failure("not-visible", "undispatched");
+				localPoint = {
+					x: reached.x,
+					y: reached.y
+				};
+			}
+			if (!safeDecode(Reach, await element.evaluate(hitPoint, {
+				...localPoint,
+				child: false
+			})).reachable) throw failure("not-visible", "undispatched");
+		} finally {
+			await Promise.all(ancestors.map((ancestor) => ancestor.dispose()));
+		}
 		return point;
 	};
 	const hover = (target, ticket, policy) => sanitize(async () => {
@@ -2447,6 +2503,6 @@ const BrowserbaseBrowserBinding = Context.Reference("effect-browserbase/BrowserB
 const layer = (binding) => Layer.succeed(BrowserbaseBrowserBinding, binding);
 const layerPlaywright = layer(defaultBinding);
 //#endregion
-export { bindingImplementation as a, playwright as i, layer as n, layerPlaywright as r, BrowserbaseBrowserBinding as t };
+export { connectPlaywrightEndpoint as a, playwright as i, layer as n, bindingImplementation as o, layerPlaywright as r, fromNativeAttempt as s, BrowserbaseBrowserBinding as t };
 
-//# sourceMappingURL=BrowserBinding-qbQA6JhH.mjs.map
+//# sourceMappingURL=BrowserBinding-DlJTGYZL.mjs.map