effect-browserbase 0.1.0-beta.104 → 0.2.0-beta.0

package/dist/Browser.d.mts

@@ -1,17 +1,16 @@
-import { o as SessionReference, t as AllocationAttempt } from "./References-URDAtapt.mjs";
-import { AllocationError, BrowserError, ContextError, InitializationError, SessionError } from "./Errors.mjs";
-import { t as BrowserbaseClient } from "./Client-Ca0zSg1n.mjs";
-import { s as LiveView, t as BrowserbaseSessions } from "./Sessions-B8E4kMxo.mjs";
-import { r as DownloadObservation } from "./Transfers-Czv5IZzJ.mjs";
-import { n as CleanupResult } from "./Cleanup-G2YpTCuU.mjs";
-import { n as ContextWriterPermit } from "./WriterFacts-osvYAsIx.mjs";
-import { f as Plan, g as ReadinessOutcome, s as Bootstrap_d_exports, t as BindingDiagnostics } from "./Bootstrap-m7lHgj0D.mjs";
-import { A as ReadTextRequest, B as TypeRequest, E as PageInfo, G as WheelRequest, I as StartNavigationRequest, L as Target, M as ScreenshotResult, N as ScrollRequest, O as PointerMoveRequest, P as SelectFilesRequest, S as ObservationOptions, V as Viewport, _ as KeyStroke, a as Checkpoint, b as NavigationResult, c as ControlFacts, d as FrameInfo, f as HoverRequest, h as InputReceipt, i as BrowserPolicy, j as ScreenshotRequest, k as PressRequest, n as AutomationOptions, o as CheckpointOptions, s as ClickRequest, t as ActionResult, u as FillRequest, w as ObservedElement, x as Observation, y as NavigateRequest, z as TextResult } from "./BrowserData-LpcAuAub.mjs";
-import { t as LaunchRecipe } from "./Launch-C8CfaYxb.mjs";
+import { a as SessionReference, t as AllocationAttempt } from "./References-DOH3Wu44.mjs";
+import { AllocationError, ContextError, SessionError } from "./Errors.mjs";
+import { BrowserbaseClient } from "./Client.mjs";
+import { o as LiveView, t as BrowserbaseSessions } from "./Sessions-tFJYaXFq.mjs";
+import { f as SelectFilesRequest, i as FileSelection, r as DownloadObservation } from "./Transfers-GVqzrDWl.mjs";
+import { n as CleanupResult } from "./Cleanup-DMTDBir8.mjs";
+import { n as ContextWriterPermit } from "./WriterFacts-5CPBGG1P.mjs";
+import { LaunchRecipe } from "./Launch.mjs";
 import { Context, Effect, Layer, Option, Redacted, Scope } from "effect";
-declare namespace Browser_d_exports {
-  export { AttachRequest, BoundTarget, BrowserAcquisition, BrowserOptions, BrowserSession, BrowserbaseBrowser, BrowserbaseSession, ElementAdmission, Handoff, LiveView, NavigationOperation, OpenOptions };
-}
+import { ActionResult, AutomationOptions, BrowserPolicy, ClickRequest, Observation } from "effect-browser/browser-data";
+import { BrowserError, InitializationError } from "effect-browser/errors";
+import { BrowserSession, OpenOptions } from "effect-browser/browser";
+//#region src/Browser.d.ts
 /** Host configuration. Credentials live in the Client; a model never selects these values. */
 export interface BrowserOptions extends AutomationOptions {
   readonly launch: LaunchRecipe;
@@ -24,124 +23,10 @@ export interface Handoff {
   readonly token: Redacted.Redacted<string>;
   readonly view: LiveView;
 }
-/**
- * A host's decision about one control, made on facts read from the exact node immediately
- * before input. Returning anything but `true`, or throwing, sends nothing and fails `denied`.
- * It is a plain synchronous function on purpose: it runs while the owner's permit is held, where
- * waiting on a model or a network call would stall every other operation. It is not an atomic
- * check-and-input transaction, because page script can still run before the native input lands.
- */
-export interface ElementAdmission {
-  readonly admit: (facts: ControlFacts) => boolean;
-}
-/**
- * A navigation the browser is still performing. The owner's permit was released when it was
- * dispatched, so while it loads a host may read, `checkpoint`, hold and resume this page, and
- * use any other page. Anything that would change this page fails `busy` until it settles.
- *
- * Leaving its scope unsettled fences the session, exactly as an interrupted mutation does,
- * because nothing then knows what the browser did. It is never replayed.
- */
-export interface NavigationOperation {
-  /** What was navigated, read before dispatch. */
-  readonly target: Target;
-  /**
-   * The document reached DOMContentLoaded. It belongs to this one navigation: a successor that
-   * reaches the same URL fails it instead. Interrupting a waiter stops nothing in the browser.
-   */
-  readonly completed: Effect.Effect<NavigationResult, BrowserError>;
-  /**
-   * Asks the browser to stop loading and waits for this navigation to settle, after which
-   * `completed` fails `interrupted`. Success is a known outcome and the session stays usable:
-   * the page holds whatever had loaded. It does not undo anything the page already did.
-   */
-  readonly stop: Effect.Effect<void, BrowserError>;
-}
-/** One selected page and frame at one connection generation, never the current DOM. */
-export interface BoundTarget {
-  readonly navigate: (request: NavigateRequest) => Effect.Effect<NavigationResult, BrowserError>;
-  /** `navigate`, left in flight: the same single dispatch, completed by the caller. */
-  readonly startNavigation: (request: StartNavigationRequest) => Effect.Effect<NavigationOperation, BrowserError, Scope.Scope>;
-  readonly readText: (request: ReadTextRequest) => Effect.Effect<TextResult, BrowserError>;
-  readonly click: (request: ClickRequest) => Effect.Effect<ActionResult, BrowserError>;
-  readonly fill: (request: FillRequest) => Effect.Effect<ActionResult, BrowserError>;
-  /** Script in the page: instantaneous, and it raises no wheel event. */
-  readonly scroll: (request: ScrollRequest) => Effect.Effect<ActionResult, BrowserError>;
-  /** One real pointer move, in main-frame viewport pixels. */
-  readonly pointerMove: (request: PointerMoveRequest) => Effect.Effect<InputReceipt, BrowserError>;
-  /** Places the pointer on one exact element where it is, or fails `not-visible` unsent. */
-  readonly hover: (request: HoverRequest) => Effect.Effect<InputReceipt, BrowserError>;
-  /** One real wheel event; the browser decides what under the pointer scrolls. */
-  readonly wheel: (request: WheelRequest) => Effect.Effect<InputReceipt, BrowserError>;
-  /** One real key stroke to whatever has focus, or fails `not-focused` unsent if `into` lacks it. */
-  readonly press: (request: PressRequest) => Effect.Effect<InputReceipt, BrowserError>;
-  /** Text as the real key strokes that produce it, under the same focus rule as `press`. */
-  readonly type: (request: TypeRequest) => Effect.Effect<InputReceipt, BrowserError>;
-  readonly screenshot: (request: ScreenshotRequest) => Effect.Effect<ScreenshotResult, BrowserError>;
-}
-/**
- * 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 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. */
-  readonly bindingDiagnostics: Effect.Effect<BindingDiagnostics<E>>;
-  readonly bind: () => BoundTarget;
-  /** Re-reads the live selection first, so a stale generation fails before any dispatch. */
-  readonly currentTarget: Effect.Effect<BoundTarget, BrowserError>;
-  readonly target: Effect.Effect<Target, BrowserError>;
-  /**
-   * The one observation whose nodes later actions may name. `scope: "viewport"` keeps only text
-   * and controls that are on screen and reachable; the default reads the whole document. It is
-   * safe to show a model: it carries no destination, form or field value.
-   */
-  readonly observe: (options?: ObservationOptions) => Effect.Effect<Observation, BrowserError>;
-  /**
-   * Passive evidence for a recorder, with a picture when asked. It issues no references and
-   * leaves the observation above exactly as it was. Host-only: it carries control facts.
-   */
-  readonly checkpoint: (options?: CheckpointOptions) => Effect.Effect<Checkpoint, BrowserError>;
-  /** Host-only facts about one observed control, read from that exact node just now. */
-  readonly controlFacts: (reference: ObservedElement) => Effect.Effect<ControlFacts, BrowserError>;
-  /**
-   * After a page hold, nothing observed on that page may be acted on unchecked. This checks one
-   * reference: still attached, and still the control that was inspected. It never searches by
-   * selector or label for a substitute, and it sends nothing.
-   */
-  readonly revalidateElement: (reference: ObservedElement) => Effect.Effect<ObservedElement, BrowserError>;
-  readonly clickElement: (reference: ObservedElement, admission?: ElementAdmission) => Effect.Effect<ActionResult, BrowserError>;
-  readonly fillElement: (reference: ObservedElement, value: string, admission?: ElementAdmission) => Effect.Effect<ActionResult, BrowserError>;
-  readonly hoverElement: (reference: ObservedElement, admission?: ElementAdmission) => Effect.Effect<InputReceipt, BrowserError>;
-  /** A key stroke sent only if the exact node an observation named already has focus. */
-  readonly pressElement: (reference: ObservedElement, stroke: KeyStroke, admission?: ElementAdmission) => Effect.Effect<InputReceipt, BrowserError>;
-  /** Real typing with `fillElement`'s exactness: that node must already have focus. */
-  readonly typeElement: (reference: ObservedElement, text: string, admission?: ElementAdmission) => Effect.Effect<InputReceipt, BrowserError>;
-  readonly pages: Effect.Effect<ReadonlyArray<PageInfo>, BrowserError>;
-  readonly frames: Effect.Effect<ReadonlyArray<FrameInfo>, BrowserError>;
-  readonly selectPage: (pageId: string) => Effect.Effect<BoundTarget, BrowserError>;
-  readonly selectFrame: (frameId: string) => Effect.Effect<BoundTarget, BrowserError>;
-  /** Create a tab without selecting it. */
-  readonly createPage: Effect.Effect<string, BrowserError>;
-  readonly closePage: (pageId: string) => Effect.Effect<void, BrowserError>;
-  readonly resizeViewport: (viewport: Viewport) => Effect.Effect<void, BrowserError>;
-  readonly waitFor: (request: {
-    readonly selector: string;
-    readonly state: "visible" | "hidden" | "attached" | "detached";
-  }) => Effect.Effect<void, BrowserError>;
-  /** Navigation observation is registered before the single click dispatch. */
-  readonly clickAndWait: (request: ClickRequest) => 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 closeChecked: Effect.Effect<CleanupResult, 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>;
@@ -155,13 +40,9 @@ export interface BrowserbaseSession<E = never> extends BrowserSession<E> {
     readonly targetId: string;
   }, BrowserError>;
   readonly reconnect: (operatorReleasedControl: boolean) => Effect.Effect<Observation, BrowserError | InitializationError>;
-  readonly close: Effect.Effect<CleanupResult, BrowserError>;
+  readonly close: Effect.Effect<CleanupResult>;
   readonly cleanupResult: Effect.Effect<Option.Option<CleanupResult>>;
 }
-/** Dependencies are captured at acquisition, not erased into an environment-free service Layer. */
-export interface OpenOptions<E = never, R = never> {
-  readonly bootstrap?: Plan<E, R>;
-}
 export interface AttachRequest<E = never, R = never> extends OpenOptions<E, R> {
   readonly policy: BrowserPolicy;
   /** The exact page to resume; without it the session must have exactly one page. */
@@ -176,23 +57,24 @@ export interface BrowserAcquisition<E = never> {
   readonly attempt: AllocationAttempt;
   readonly failure: Effect.Effect<never, E | InitializationError>;
   readonly connect: Effect.Effect<BrowserbaseSession<E>, BrowserError | E | InitializationError>;
-  readonly close: Effect.Effect<CleanupResult, BrowserError>;
+  readonly close: Effect.Effect<CleanupResult>;
 }
 declare const BrowserbaseBrowser_base: Context.ServiceClass<BrowserbaseBrowser, "effect-browserbase/Browser", {
   readonly acquire: <E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>) => Effect.Effect<BrowserAcquisition<E>, AllocationError | BrowserError | ContextError, Scope.Scope | Exclude<R, Scope.Scope>>;
   /** Borrowed control of a session this process did not allocate and will not release. */
   readonly attach: <E = never, R = never>(reference: SessionReference, request: AttachRequest<E, R>) => Effect.Effect<BrowserbaseSession<E>, BrowserError | SessionError | E | InitializationError, Scope.Scope | Exclude<R, Scope.Scope>>;
   readonly open: <E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>) => Effect.Effect<BrowserbaseSession<E>, AllocationError | BrowserError | ContextError | E | InitializationError, Scope.Scope | Exclude<R, Scope.Scope>>;
-  /** Race the consumer with typed callback failure and confirm cleanup before normal success. */
-  readonly withBrowser: <E, R, A, E2, R2>(policy: BrowserPolicy, request: OpenOptions<E, R>, use: (session: BrowserbaseSession<E>) => Effect.Effect<A, E2, R2>) => Effect.Effect<A, AllocationError | BrowserError | ContextError | InitializationError | E | E2, Exclude<R | R2, Scope.Scope>>;
 }>;
-/**
- * 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.
- */
 export declare class BrowserbaseBrowser extends BrowserbaseBrowser_base {
+  /** Open through the configured account and browser service, in the caller's scope. */
+  static open<E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>): Effect.Effect<BrowserbaseSession<E>, E | AllocationError | BrowserError | ContextError | InitializationError, BrowserbaseBrowser | Scope.Scope | Exclude<R, Scope.Scope>>;
+  /** Allocate the provider lifetime before connecting, preserving its attempt and cleanup. */
+  static acquire<E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>): Effect.Effect<BrowserAcquisition<E>, AllocationError | BrowserError | ContextError, BrowserbaseBrowser | Scope.Scope | Exclude<R, Scope.Scope>>;
+  /** Borrow a provider session without acquiring release authority over it. */
+  static attach<E = never, R = never>(reference: SessionReference, request: AttachRequest<E, R>): Effect.Effect<BrowserbaseSession<E>, E | BrowserError | InitializationError | SessionError, BrowserbaseBrowser | Scope.Scope | Exclude<R, Scope.Scope>>;
   static layer(options: BrowserOptions): Layer.Layer<BrowserbaseBrowser, BrowserError, BrowserbaseClient | BrowserbaseSessions>;
 }
 //#endregion
-export { type LiveView, Browser_d_exports as t };
+export type { FileSelection, LiveView, SelectFilesRequest };
+export {};
 //# sourceMappingURL=Browser.d.mts.map

package/dist/Browser.mjs

@@ -1,215 +1,259 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
-import { Identifier } from "./References.mjs";
-import { BrowserError } from "./Errors.mjs";
+import { SessionError } 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 BrowserbaseClient } from "./Client-BQteUePT.mjs";
+import { isTerminalSessionStatus } from "./SessionData.mjs";
+import { a as issueLiveView, o as browserRequestFailure, t as BrowserbaseSessions } from "./Sessions-DoQGg9nB.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 });
+import { t as connectionAddress } from "./Connection-DcvJZEdc.mjs";
+import { a as reported, i as noLocalConnection, n as reportCleanup, r as makeCleanup, t as acquireRemote } from "./Acquisition-D8o4jtCg.mjs";
+import { BrowserbaseBrowserBinding } from "./BrowserBinding.mjs";
+import { Context, Effect, Exit, Layer, Option, Schema, Scope } from "effect";
+import { BrowserError, Reasons } from "effect-browser/errors";
+import * as BrowserRuntime from "effect-browser/browser-runtime";
+//#region src/internal/session/Attachment.ts
+const failure = (reason) => SessionError.make({
+	operation: "session-attach",
+	reason,
+	outcome: "undispatched"
+});
 /**
-* 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.
+* Borrowing an already running session. This scope owns its local connection and nothing
+* else: no allocation attempt is made, no release is requested, and no Context-writer
+* authority is claimed. Whoever allocated the session keeps all three.
 */
-const selection = (request, reference, operation) => Effect.suspend(() => {
-	const invalid = BrowserError.make({
-		operation,
-		reason: "configuration",
+const attachRemote = Effect.fnUntraced(function* (options, local = noLocalConnection, limits) {
+	const client = yield* BrowserbaseClient;
+	const sessions = yield* BrowserbaseSessions;
+	const parent = yield* Scope.Scope;
+	const pendingWaitMillis = options.pendingWaitMillis ?? 0;
+	if (!Number.isSafeInteger(pendingWaitMillis) || pendingWaitMillis < 0 || pendingWaitMillis > 6e5) return yield* failure("configuration");
+	const observed = yield* sessions.retrieve(options.reference);
+	if (isTerminalSessionStatus(observed.status)) return yield* failure("expired");
+	if (observed.status !== "RUNNING") {
+		if (pendingWaitMillis === 0) return yield* failure("active");
+		yield* sessions.waitUntilRunning(observed.reference, { timeoutMillis: pendingWaitMillis });
+	}
+	const reference = observed.reference;
+	return yield* Effect.uninterruptible(Effect.gen(function* () {
+		const resourceScope = yield* Scope.make();
+		let closing = false;
+		let cleanup;
+		const terminate = yield* Effect.cached(Effect.uninterruptible(Effect.gen(function* () {
+			closing = true;
+			yield* (yield* makeCleanup(reference, "borrowed", sessions, local, (result) => {
+				cleanup = result;
+			}, limits)).close;
+			const result = cleanup;
+			const notify = options.onCleanup;
+			if (result !== void 0) {
+				yield* reported(Effect.suspend(() => reportCleanup(result)));
+				if (notify !== void 0) yield* reported(Effect.suspend(() => notify(result)));
+			}
+		})));
+		const closeScope = yield* Effect.cached(Scope.close(resourceScope, Exit.void));
+		yield* Scope.addFinalizer(resourceScope, terminate);
+		yield* Scope.addFinalizer(parent, closeScope);
+		return {
+			reference,
+			status: observed,
+			connection: (timeoutMillis) => Effect.suspend(() => closing ? Effect.fail(SessionError.make({
+				operation: "session-connect",
+				reason: "expired",
+				outcome: "undispatched"
+			})) : connectionAddress(client, sessions, reference, timeoutMillis)),
+			release: closeScope.pipe(Effect.andThen(Effect.suspend(() => cleanup === void 0 ? Effect.die(/* @__PURE__ */ new Error("Borrowed session closed without cleanup evidence")) : Effect.succeed(cleanup)))),
+			cleanupResult: Effect.sync(() => Option.fromNullishOr(cleanup))
+		};
+	}));
+});
+//#endregion
+//#region src/internal/session/Browser.ts
+/** A borrowed connection closes without requiring or requesting remote termination. */
+const checkedCleanup = (close) => close.pipe(Effect.filterOrFail((result) => result.local === "closed" && result.issues.length === 0 && (result.ownership === "borrowed" ? result.remote === "not-owned" : result.remote === "confirmed"), () => BrowserError.make({
+	operation: "close",
+	reason: Reasons.Provider.make({}),
+	outcome: "unknown"
+})));
+const withConnection = (acquired) => ({
+	...acquired,
+	connection: (timeoutMillis) => acquired.connection(timeoutMillis).pipe(Effect.mapError((error) => browserRequestFailure("connect", error))),
+	closeChecked: checkedCleanup(acquired.release),
+	controlRetired: acquired.cleanupResult.pipe(Effect.map((result) => Option.isSome(result) && result.value.ownership === "owned" && result.value.remote === "confirmed"))
+});
+/** Allocates the session, and therefore owns releasing it. */
+const providerControls = (client, sessions, reference) => ({
+	liveView: (ttl) => issueLiveView(client, reference, ttl),
+	verifyReconnect: sessions.retrieve(reference).pipe(Effect.mapError((error) => browserRequestFailure("reconnect", error)), Effect.flatMap((status) => status.status === "RUNNING" ? Effect.void : Effect.fail(BrowserError.make({
+		operation: "reconnect",
+		reason: Reasons.Expired.make({}),
 		outcome: "undispatched"
-	});
-	if (request.selection._tag === "Inline") return checked(InlineFiles, request.selection.files, operation).pipe(Effect.map((files) => files.map((file) => ({
+	}))))
+});
+const ownedRemote = (options) => (local, lifetimeDeadline) => Effect.gen(function* () {
+	const client = yield* BrowserbaseClient;
+	const sessions = yield* BrowserbaseSessions;
+	const acquired = yield* acquireRemote({
+		launch: options.launch,
+		...options.contextWriter === void 0 ? {} : { contextWriter: options.contextWriter },
+		allocationDeadline: lifetimeDeadline,
+		...options.onCleanup === void 0 ? {} : { onCleanup: options.onCleanup },
+		...options.onAllocationUncertain === void 0 ? {} : { onAllocationUncertain: options.onAllocationUncertain }
+	}, local);
+	return {
+		...withConnection(acquired),
+		...providerControls(client, sessions, acquired.reference)
+	};
+});
+/** Borrows a running session: local connection only, and never a release request. */
+const borrowedRemote = (options) => (local) => Effect.gen(function* () {
+	const client = yield* BrowserbaseClient;
+	const sessions = yield* BrowserbaseSessions;
+	const acquired = yield* attachRemote(options, local);
+	return {
+		...withConnection(acquired),
+		...providerControls(client, sessions, acquired.reference)
+	};
+});
+//#endregion
+//#region src/Browser.ts
+/** Only receipts issued for this exact provider session may resolve to stored paths. */
+const selection = (request, reference, operation) => Effect.suspend(() => {
+	if (request.selection._tag === "Inline") return Effect.succeed({
 		_tag: "Inline",
-		name: file.name,
-		mediaType: file.mediaType,
-		bytes: new Uint8Array(file.bytes)
-	}))));
+		files: request.selection.files
+	});
 	const uploads = request.selection.uploads;
-	if (!Array.isArray(uploads) || uploads.length < 1 || uploads.length > 8) return Effect.fail(invalid);
-	const files = [];
+	if (!Array.isArray(uploads) || uploads.length < 1 || uploads.length > 8) return Effect.fail(BrowserError.make({
+		operation,
+		reason: Reasons.Configuration.make({}),
+		outcome: "undispatched"
+	}));
+	const paths = [];
 	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({
+		if (issued === void 0 || issued.reference.projectId !== reference.projectId || issued.reference.sessionId !== reference.sessionId) return Effect.fail(BrowserError.make({
 			operation,
-			reason: "authorization",
+			reason: Reasons.Authorization.make({}),
 			outcome: "undispatched"
 		}));
-		files.push({
-			_tag: "Remote",
-			path: issued.remotePath
-		});
+		paths.push(issued.remotePath);
 	}
-	return Effect.succeed(files);
+	return Effect.succeed({
+		_tag: "Stored",
+		paths
+	});
 });
-const makeSession = (controls, bindings) => {
-	const session = makeSession$1(controls, bindings);
-	const navigate = (url) => decoded(ActionResult, "action-result")({ url });
+const makeSession = (connection, lifetime) => {
+	const { session, operations } = connection;
 	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
+		reference: lifetime.reference,
+		closeChecked: session.closeChecked.pipe(Effect.andThen(lifetime.closeChecked)),
+		clickForDownload: (request) => operations.clickForDownload(request).pipe(Effect.flatMap((event) => Schema.decodeEffect(DownloadObservation)({
+			...event,
+			reference: lifetime.reference
+		}).pipe(Effect.mapError(() => BrowserError.make({
+			operation: "download-action",
+			reason: Reasons.Malformed.make({}),
+			outcome: "unknown"
+		}))))),
+		selectFiles: (request) => selection(request, lifetime.reference, "select-files").pipe(Effect.flatMap((files) => operations.selectFiles({
+			selector: request.selector,
+			selection: files
+		}))),
+		clickForFileSelection: (request) => selection(request, lifetime.reference, "file-chooser").pipe(Effect.flatMap((files) => operations.clickForFileSelection({
+			selector: request.selector,
+			selection: files
 		}))),
-		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
+		liveView: (ttl = 60) => operations.liveView(lifetime.liveView(ttl)),
+		beginHandoff: (ttl = 60) => operations.beginHandoff(lifetime.liveView(ttl)),
+		resume: operations.resume,
+		detach: operations.detach,
+		reconnect: operations.reconnect,
+		close: lifetime.release,
+		cleanupResult: lifetime.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") {
+	/** Open through the configured account and browser service, in the caller's scope. */
+	static open(policy, request) {
+		return Effect.flatMap(BrowserbaseBrowser, (browser) => browser.open(policy, request));
+	}
+	/** Allocate the provider lifetime before connecting, preserving its attempt and cleanup. */
+	static acquire(policy, request) {
+		return Effect.flatMap(BrowserbaseBrowser, (browser) => browser.acquire(policy, request));
+	}
+	/** Borrow a provider session without acquiring release authority over it. */
+	static attach(reference, request) {
+		return Effect.flatMap(BrowserbaseBrowser, (browser) => browser.attach(reference, request));
+	}
 	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"
+				reason: Reasons.ContextLease.make({}),
+				outcome: "undispatched"
 			});
 			if (Object.prototype.hasOwnProperty.call(options, "bootstrap")) return yield* BrowserError.make({
 				operation: "configure",
-				reason: "configuration",
+				reason: Reasons.Configuration.make({}),
 				outcome: "undispatched"
 			});
-			const driver = {
-				pageControl,
-				viewport,
-				maxPages,
-				popupPolicy,
-				dialogPolicy,
+			const runtime = yield* BrowserRuntime.make({
+				implementation: "browserbase-playwright-cdp",
+				binding,
+				automation: projected(options),
+				viewport: options.launch.viewport._tag === "Fixed" ? {
+					width: options.launch.viewport.width,
+					height: options.launch.viewport.height
+				} : {
+					width: 1280,
+					height: 720
+				},
 				preserveViewport: options.launch.viewport._tag !== "Fixed",
-				...automation.initialPage === void 0 ? {} : "targetId" in automation.initialPage ? { initialTargetId: automation.initialPage.targetId } : { newPage: true }
-			};
+				keepAlive: options.launch.keepAlive === true
+			});
+			const source = (remote) => (cleanup, deadline) => remote(cleanup, deadline).pipe(Effect.provideService(BrowserbaseClient, client), Effect.provideService(BrowserbaseSessions, sessions));
 			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))));
+				const acquired = yield* runtime.acquire(policy, source(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 }
+				})), request);
+				const connected = yield* Effect.cached(acquired.connect.pipe(Effect.map((connection) => makeSession(connection, acquired.lifetime))));
 				return {
 					reference: acquired.reference,
-					attempt: acquired.lease.attempt,
-					failure: bindings.failure,
+					attempt: acquired.lifetime.attempt,
+					failure: acquired.failure,
 					close: acquired.close,
-					connect: Effect.raceFirst(bindings.failure, acquired.connect.pipe(Effect.andThen(connected))).pipe(Effect.onError(() => acquired.close.pipe(Effect.asVoid)))
+					connect: acquired.connect.pipe(Effect.andThen(connected))
 				};
 			});
-			/**
-			* 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)));
+				const acquired = yield* runtime.acquire(request.policy, source(borrowedRemote({
+					reference,
+					...request.pendingWaitMillis === void 0 ? {} : { pendingWaitMillis: request.pendingWaitMillis },
+					...options.onCleanup === void 0 ? {} : { onCleanup: options.onCleanup }
+				})), {
+					...request.bootstrap === void 0 ? {} : { bootstrap: request.bootstrap },
+					existingTarget: request.target ?? {}
+				});
+				return yield* acquired.connect.pipe(Effect.map((connection) => makeSession(connection, acquired.lifetime)));
 			});
 			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;
-				}))
+				open: (policy, request) => acquire(policy, request).pipe(Effect.flatMap((acquired) => acquired.connect))
 			});
 		}));
 	}
 };
 /** Only the automation fields cross the schema boundary; launch and callbacks are separate. */
 const projected = (options) => ({
+	...options.maxHostReads === void 0 ? {} : { maxHostReads: options.maxHostReads },
 	...options.actionTimeoutMillis === void 0 ? {} : { actionTimeoutMillis: options.actionTimeoutMillis },
 	...options.maxPages === void 0 ? {} : { maxPages: options.maxPages },
 	...options.initialPage === void 0 ? {} : { initialPage: options.initialPage },
@@ -218,6 +262,6 @@ const projected = (options) => ({
 	...options.pageControl === void 0 ? {} : { pageControl: options.pageControl }
 });
 //#endregion
-export { BrowserbaseBrowser, Browser_exports as t };
+export { BrowserbaseBrowser };
 
 //# sourceMappingURL=Browser.mjs.map