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

package/dist/{Browser-joE4Zgys.mjs → Session-D4nT9hOO.mjs}

@@ -1,20 +1,17 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { Identifier } from "./References.mjs";
 import { BrowserError, InitializationError, SessionError } from "./Errors.mjs";
-import { DownloadObservation } from "./Transfers.mjs";
 import { t as BrowserbaseClient } from "./Client-D1_xYM9o.mjs";
-import { ActionResult, AutomationOptions, BrowserPolicy, Checkpoint, CheckpointOptions, ClickRequest, FillRequest, HoverRequest, InlineFiles, InputReceipt, KeyStroke, NavigateRequest, NavigationResult, Observation, ObservationOptions, ObservedElement, PointerMoveRequest, PressRequest, ReadTextRequest, ScreenshotRequest, ScreenshotResult, ScrollRequest, Selector, StartNavigationRequest, Target, TextResult, TypeRequest, Viewport, WheelRequest } from "./BrowserData.mjs";
+import { ActionResult, Checkpoint, CheckpointOptions, ClickRequest, FillRequest, HoverRequest, InputReceipt, KeyStroke, NavigateRequest, NavigationResult, Observation, ObservationOptions, ObservedElement, PointerMoveRequest, PressRequest, ReadTextRequest, ScreenshotRequest, ScreenshotResult, ScrollRequest, StartNavigationRequest, Target, TextResult, TypeRequest, Viewport, WheelRequest } from "./BrowserData.mjs";
 import { isTerminalSessionStatus } from "./SessionData.mjs";
 import { n as nowMillis, r as until, t as deadlineAfter } from "./Deadline-CrViaogr.mjs";
 import { o as issueLiveView, t as BrowserbaseSessions } from "./Sessions-CtbseWEh.mjs";
-import { t as issuedUpload } from "./Issued-DejqoMYL.mjs";
 import { a as reported, i as noLocalConnection, n as reportCleanup, o as connectionAddress, r as makeCleanup, t as acquireRemote } from "./Acquisition-WBafHwXH.mjs";
-import { d as empty, h as snapshot, m as invoke, s as Plan } from "./Bootstrap-BXuzZojd.mjs";
+import { h as snapshot, m as invoke, s as Plan } from "./Bootstrap-BXuzZojd.mjs";
 import { o as publicError } from "./Images-DgscEfSf.mjs";
-import { a as bindingImplementation, t as BrowserbaseBrowserBinding } from "./BrowserBinding-qbQA6JhH.mjs";
+import { o as bindingImplementation, t as BrowserbaseBrowserBinding } from "./BrowserBinding-DlJTGYZL.mjs";
 import { t as associate } from "./Association-CEps4hYP.mjs";
 import { t as associatePageControl } from "./PageControlAssociation-DabEg5AR.mjs";
-import { Cause, Clock, Context, Deferred, Effect, Exit, FiberSet, Layer, Option, Redacted, Schema, Scope, Semaphore } from "effect";
+import { Cause, Clock, Deferred, Effect, Exit, FiberSet, Option, Redacted, Schema, Scope, Semaphore } from "effect";
 //#region src/internal/browser/BindingRunner.ts
 const makeBindingRunner = (capacity, handle, onFault) => {
 	if (!Number.isSafeInteger(capacity) || capacity < 1) throw new RangeError("Invalid binding callback capacity");
@@ -333,6 +330,136 @@ const makeBindings = Effect.fnUntraced(function* (plan) {
 	};
 });
 //#endregion
+//#region src/internal/browser/PublicSession.ts
+const checked = (schema, value, operation) => Schema.decodeUnknownEffect(schema)(value, { onExcessProperty: "error" }).pipe(Effect.mapError(() => BrowserError.make({
+	operation,
+	reason: "configuration",
+	outcome: "undispatched"
+})));
+const decoded = (schema, operation) => (value) => Schema.decodeUnknownEffect(schema)(value).pipe(Effect.mapError(() => BrowserError.make({
+	operation,
+	reason: "malformed"
+})));
+const action = decoded(ActionResult, "action-result");
+const pointerMoved = decoded(InputReceipt, "pointer-move");
+const hovered = decoded(InputReceipt, "hover");
+const wheeled = decoded(InputReceipt, "wheel");
+const pressed = decoded(InputReceipt, "press");
+const typed = decoded(InputReceipt, "type");
+const makeTarget = (bound) => ({
+	navigate: (request) => checked(NavigateRequest, request, "navigate").pipe(Effect.flatMap((value) => bound.navigate(value.url)), Effect.flatMap((url) => decoded(NavigationResult, "navigate")({ url }))),
+	startNavigation: (request) => checked(StartNavigationRequest, request, "navigate").pipe(Effect.flatMap((value) => bound.startNavigation(value.url, value.timeoutMillis)), Effect.map((operation) => ({
+		target: operation.target,
+		completed: operation.completed.pipe(Effect.flatMap((url) => decoded(NavigationResult, "navigate")({ url }))),
+		stop: operation.stop
+	}))),
+	readText: (request) => checked(ReadTextRequest, request, "read-text").pipe(Effect.flatMap((value) => bound.readText(value.selector)), Effect.flatMap((text) => decoded(TextResult, "read-text")({ text }))),
+	click: (request) => checked(ClickRequest, request, "click").pipe(Effect.flatMap((value) => bound.click(value.selector)), Effect.flatMap((url) => action({ url }))),
+	fill: (request) => checked(FillRequest, request, "fill").pipe(Effect.flatMap((value) => bound.fill(value.selector, value.value)), Effect.flatMap((url) => action({ url }))),
+	scroll: (request) => checked(ScrollRequest, request, "scroll").pipe(Effect.flatMap((value) => bound.scroll(value.deltaX, value.deltaY)), Effect.flatMap((url) => action({ url }))),
+	pointerMove: (request) => checked(PointerMoveRequest, request, "pointer-move").pipe(Effect.flatMap((value) => bound.pointerMove(value.to)), Effect.flatMap((input) => pointerMoved({
+		...input,
+		kind: "pointer-move"
+	}))),
+	hover: (request) => checked(HoverRequest, request, "hover").pipe(Effect.flatMap((value) => bound.hover(value.selector)), Effect.flatMap((input) => hovered({
+		...input,
+		kind: "hover"
+	}))),
+	wheel: (request) => checked(WheelRequest, request, "wheel").pipe(Effect.flatMap((value) => bound.wheel(value.deltaX, value.deltaY, value.at).pipe(Effect.flatMap((input) => wheeled({
+		...input,
+		kind: "wheel",
+		delta: {
+			x: value.deltaX,
+			y: value.deltaY
+		}
+	}))))),
+	press: (request) => checked(PressRequest, request, "press").pipe(Effect.flatMap((value) => bound.press(value.key, value.modifiers ?? [], value.into)), Effect.flatMap((input) => pressed({
+		...input,
+		kind: "press"
+	}))),
+	type: (request) => checked(TypeRequest, request, "type").pipe(Effect.flatMap((value) => bound.type(value.text, value.into)), Effect.flatMap((input) => typed({
+		...input,
+		kind: "type"
+	}))),
+	screenshot: (request) => checked(ScreenshotRequest, request, "screenshot").pipe(Effect.flatMap((value) => bound.screenshot(value.fullPage)), Effect.flatMap((bytes) => decoded(ScreenshotResult, "screenshot")({
+		mediaType: "image/png",
+		bytes: new Uint8Array(bytes)
+	})))
+});
+/** A browser-operation failure keeps its meaning when it is reported as an initialization one. */
+const initialization = (reason) => reason === "busy" ? "busy" : reason === "closed" || reason === "disconnected" ? "closed" : reason === "timeout" ? "timeout" : reason === "stale" ? "stale" : reason === "unsupported" ? "unsupported" : reason === "configuration" ? "configuration" : "native";
+const makeSession = (controls, bindings) => {
+	const currentTarget = controls.currentTarget.pipe(Effect.map(() => makeTarget(controls.bind())));
+	const Wait = Schema.Struct({
+		selector: ClickRequest.fields.selector,
+		state: Schema.Literals([
+			"visible",
+			"hidden",
+			"attached",
+			"detached"
+		])
+	});
+	const navigate = (url) => action({ url });
+	const session = {
+		failure: bindings.failure,
+		bindingDiagnostics: bindings.diagnostics,
+		bind: () => makeTarget(controls.bind()),
+		currentTarget,
+		target: controls.currentTarget,
+		observe: (options = {}) => checked(ObservationOptions, options, "observe").pipe(Effect.flatMap((value) => controls.observe({
+			...value,
+			scope: value.scope ?? "document"
+		}))),
+		checkpoint: (options = {}) => checked(CheckpointOptions, options, "checkpoint").pipe(Effect.flatMap((value) => controls.checkpoint({
+			...value,
+			picture: value.picture ?? false
+		})), Effect.flatMap(({ picture, ...sampled }) => decoded(Checkpoint, "checkpoint")({
+			...sampled,
+			...picture === void 0 ? {} : { picture: {
+				mediaType: "image/png",
+				bytes: new Uint8Array(picture)
+			} }
+		}))),
+		controlFacts: (reference) => checked(ObservedElement, reference, "control-facts").pipe(Effect.flatMap(controls.controlFacts)),
+		revalidateElement: (reference) => checked(ObservedElement, reference, "revalidate").pipe(Effect.flatMap((value) => controls.revalidate(value).pipe(Effect.as(value)))),
+		clickElement: (reference, admission) => checked(ObservedElement, reference, "click").pipe(Effect.flatMap((value) => controls.bind().click(value, admission?.admit)), Effect.flatMap(navigate)),
+		fillElement: (reference, value, admission) => checked(ObservedElement, reference, "fill").pipe(Effect.flatMap((element) => checked(FillRequest.fields.value, value, "fill").pipe(Effect.flatMap((text) => controls.bind().fill(element, text, admission?.admit)))), Effect.flatMap(navigate)),
+		hoverElement: (reference, admission) => checked(ObservedElement, reference, "hover").pipe(Effect.flatMap((value) => controls.bind().hover(value, admission?.admit)), Effect.flatMap((input) => hovered({
+			...input,
+			kind: "hover"
+		}))),
+		pressElement: (reference, stroke, admission) => checked(ObservedElement, reference, "press").pipe(Effect.flatMap((element) => checked(KeyStroke, stroke, "press").pipe(Effect.flatMap((value) => controls.bind().press(value.key, value.modifiers ?? [], element, admission?.admit)))), Effect.flatMap((input) => pressed({
+			...input,
+			kind: "press"
+		}))),
+		typeElement: (reference, text, admission) => checked(ObservedElement, reference, "type").pipe(Effect.flatMap((element) => checked(TypeRequest.fields.text, text, "type").pipe(Effect.flatMap((value) => controls.bind().type(value, element, admission?.admit)))), Effect.flatMap((input) => typed({
+			...input,
+			kind: "type"
+		}))),
+		pages: controls.pages,
+		frames: controls.frames,
+		selectPage: (id) => checked(Identifier, id, "select-page").pipe(Effect.flatMap(controls.selectPage), Effect.andThen(currentTarget)),
+		selectFrame: (id) => checked(Identifier, id, "select-frame").pipe(Effect.flatMap(controls.selectFrame), Effect.andThen(currentTarget)),
+		createPage: controls.createPage(),
+		closePage: (id) => checked(Identifier, id, "close-page").pipe(Effect.flatMap(controls.closePage)),
+		resizeViewport: (viewport) => checked(Viewport, viewport, "resize").pipe(Effect.flatMap(controls.resize)),
+		waitFor: (request) => checked(Wait, request, "wait").pipe(Effect.flatMap((value) => controls.waitFor(value.selector, value.state))),
+		clickAndWait: (request) => checked(ClickRequest, request, "click-and-wait").pipe(Effect.flatMap((value) => controls.clickAndWait(value.selector)), Effect.flatMap((url) => action({ url }))),
+		ready: controls.readiness.pipe(Effect.mapError((error) => InitializationError.make({
+			operation: "ready",
+			step: "session",
+			reason: initialization(error.reason)
+		})), Effect.flatMap((state) => state._tag === "NotReady" ? Effect.fail(InitializationError.make({
+			operation: "ready",
+			step: state.step,
+			reason: state.reason === "failed" ? "output" : state.reason
+		})) : Effect.succeed({ _tag: state._tag })))
+	};
+	associate(session, controls.capture);
+	associatePageControl(session, controls.pageControl);
+	return session;
+};
+//#endregion
 //#region src/internal/session/Attachment.ts
 const failure = (reason) => SessionError.make({
 	operation: "session-attach",
@@ -580,28 +707,52 @@ const native = (operation, ticket, body) => Effect.callback((resume) => {
 //#endregion
 //#region src/internal/browser/Session.ts
 /** Allocates the session, and therefore owns releasing it. */
-const ownedRemote = (options) => (local, lifetimeDeadline) => 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);
+const providerControls = (client, sessions, reference) => ({
+	liveView: (ttl) => issueLiveView(client, reference, ttl),
+	verifyReconnect: sessions.retrieve(reference).pipe(Effect.mapError((error) => BrowserError.make({
+		operation: "reconnect",
+		reason: error.reason
+	})), Effect.flatMap((status) => status.status === "RUNNING" ? Effect.void : Effect.fail(BrowserError.make({
+		operation: "reconnect",
+		reason: "expired"
+	}))))
+});
+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 {
+		...acquired,
+		...providerControls(client, sessions, acquired.reference)
+	};
+});
 /** Borrows a running session: local connection only, and never a release request. */
-const borrowedRemote = (options) => (local) => attachRemote(options, local);
+const borrowedRemote = (options) => (local) => Effect.gen(function* () {
+	const client = yield* BrowserbaseClient;
+	const sessions = yield* BrowserbaseSessions;
+	const acquired = yield* attachRemote(options, local);
+	return {
+		...acquired,
+		...providerControls(client, sessions, acquired.reference)
+	};
+});
 /**
 * The one owned browser. Remote allocation, release and terminal observation belong to the
 * canonical control plane; this owner supplies only the local connection's cleanup evidence.
 */
 const acquireSession = Effect.fnUntraced(function* (limits, options) {
-	const engine = bindingImplementation(yield* BrowserbaseBrowserBinding);
+	const engine = options.engine ?? bindingImplementation(yield* BrowserbaseBrowserBinding);
 	if (engine === void 0) return yield* BrowserError.make({
 		operation: "connect",
 		reason: "configuration",
 		outcome: "undispatched"
 	});
-	const client = yield* BrowserbaseClient;
-	const sessions = yield* BrowserbaseSessions;
 	const parentScope = yield* Scope.Scope;
 	const bindingLifetime = yield* Scope.fork(parentScope, "sequential");
 	const ended = yield* Deferred.make();
@@ -685,6 +836,7 @@ const acquireSession = Effect.fnUntraced(function* (limits, options) {
 			owner.fence("closing", "closed");
 			handoffToken = void 0;
 			activeConnection = void 0;
+			Deferred.doneUnsafe(ended, Effect.void);
 		}),
 		capture: Effect.suspend(() => Effect.forEach([...capture.captureLeases.values()], (lease) => lease.stop, { discard: true })),
 		initialization: disposeBindings,
@@ -705,6 +857,8 @@ const acquireSession = Effect.fnUntraced(function* (limits, options) {
 	};
 	const acquired = yield* options.remote(local, owner.lifetimeDeadline);
 	const ref = acquired.reference;
+	const release = acquired.release;
+	const cleanupResult = acquired.cleanupResult;
 	const closeScope = acquired.release.pipe(Effect.ensuring(Deferred.succeed(ended, void 0)), Effect.asVoid);
 	const connectionEvents = (connectionLease) => ({
 		invalidate: (reason) => {
@@ -1058,8 +1212,8 @@ const acquireSession = Effect.fnUntraced(function* (limits, options) {
 		capture,
 		bind,
 		currentTarget: readSelected,
-		cleanupResult: acquired.cleanupResult,
-		close: acquired.release.pipe(Effect.ensuring(Deferred.succeed(ended, void 0))),
+		cleanupResult,
+		close: release,
 		observe: (reading = { scope: "document" }) => textBudget("observe", reading.maxTextBytes).pipe(Effect.flatMap((bytes) => owner.guard("observe", (ticket) => observeInside(ticket, bytes, reading.maxControls ?? 32, true, reading.scope)))),
 		/**
 		* Passive: not a mutation, so the action observation and the selection are left exactly as
@@ -1110,19 +1264,23 @@ const acquireSession = Effect.fnUntraced(function* (limits, options) {
 		clickForDownload: (target) => nativeOperation("download-action", (driver, ticket) => driver.clickForDownload(target, ticket), { mutation: true }),
 		selectFiles: (target, files) => nativeOperation("select-files", (driver, ticket) => driver.selectFiles(target, files, ticket), { mutation: true }),
 		clickForFileSelection: (target, files) => nativeOperation("file-chooser", (driver, ticket) => driver.clickForFileSelection(target, files, ticket), { mutation: true }),
-		liveView: (ttl) => owner.guard("live-view", () => issueLiveView(client, ref, ttl), {
+		liveView: (ttl) => owner.guard("live-view", () => acquired.liveView === void 0 ? Effect.fail(BrowserError.make({
+			operation: "live-view",
+			reason: "unsupported",
+			outcome: "undispatched"
+		})) : acquired.liveView(ttl), {
 			charge: false,
 			phases: ["open", "paused"]
 		}),
 		beginHandoff: (ttl) => owner.guard("handoff", () => Effect.gen(function* () {
-			if (options.driver.pageControl) return yield* BrowserError.make({
+			if (options.driver.pageControl || acquired.liveView === void 0) return yield* BrowserError.make({
 				operation: "handoff",
 				reason: "unsupported",
 				outcome: "undispatched"
 			});
 			if (owner.state.phase === "open") owner.fence("paused", "paused");
 			handoffToken ??= globalThis.crypto.randomUUID();
-			const view = yield* issueLiveView(client, ref, ttl);
+			const view = yield* acquired.liveView(ttl);
 			return {
 				token: Redacted.make(handoffToken),
 				view
@@ -1178,18 +1336,12 @@ const acquireSession = Effect.fnUntraced(function* (limits, options) {
 			verifyAfter: false
 		}).pipe(Effect.onError(() => Effect.sync(() => owner.fence("uncertain", "uncertain")))),
 		reconnect: (operatorReleasedControl) => owner.guard("reconnect", (ticket) => Effect.gen(function* () {
-			if (!options.keepAlive || reconnectTarget === void 0 || !operatorReleasedControl) return yield* BrowserError.make({
+			if (!options.keepAlive || reconnectTarget === void 0 || !operatorReleasedControl || acquired.verifyReconnect === void 0) return yield* BrowserError.make({
 				operation: "reconnect",
 				reason: "unsupported",
 				outcome: "undispatched"
 			});
-			if ((yield* sessions.retrieve(ref).pipe(Effect.mapError((error) => BrowserError.make({
-				operation: "reconnect",
-				reason: error.reason
-			})))).status !== "RUNNING") return yield* BrowserError.make({
-				operation: "reconnect",
-				reason: "expired"
-			});
+			yield* acquired.verifyReconnect;
 			owner.state.phase = "acquiring";
 			const endpoint = yield* connectionUrl("reconnect");
 			yield* connectNative(endpoint, {
@@ -1222,336 +1374,6 @@ const acquireSession = Effect.fnUntraced(function* (limits, options) {
 	};
 });
 //#endregion
-//#region src/Browser.ts
-var Browser_exports = /* @__PURE__ */ __exportAll({ BrowserbaseBrowser: () => BrowserbaseBrowser });
-const checked = (schema, value, operation) => Schema.decodeUnknownEffect(schema)(value, { onExcessProperty: "error" }).pipe(Effect.mapError(() => BrowserError.make({
-	operation,
-	reason: "configuration",
-	outcome: "undispatched"
-})));
-const decoded = (schema, operation) => (value) => Schema.decodeUnknownEffect(schema)(value).pipe(Effect.mapError(() => BrowserError.make({
-	operation,
-	reason: "malformed"
-})));
-const action = decoded(ActionResult, "action-result");
-const pointerMoved = decoded(InputReceipt, "pointer-move");
-const hovered = decoded(InputReceipt, "hover");
-const wheeled = decoded(InputReceipt, "wheel");
-const pressed = decoded(InputReceipt, "press");
-const typed = decoded(InputReceipt, "type");
-const makeTarget = (bound) => ({
-	navigate: (request) => checked(NavigateRequest, request, "navigate").pipe(Effect.flatMap((value) => bound.navigate(value.url)), Effect.flatMap((url) => decoded(NavigationResult, "navigate")({ url }))),
-	startNavigation: (request) => checked(StartNavigationRequest, request, "navigate").pipe(Effect.flatMap((value) => bound.startNavigation(value.url, value.timeoutMillis)), Effect.map((operation) => ({
-		target: operation.target,
-		completed: operation.completed.pipe(Effect.flatMap((url) => decoded(NavigationResult, "navigate")({ url }))),
-		stop: operation.stop
-	}))),
-	readText: (request) => checked(ReadTextRequest, request, "read-text").pipe(Effect.flatMap((value) => bound.readText(value.selector)), Effect.flatMap((text) => decoded(TextResult, "read-text")({ text }))),
-	click: (request) => checked(ClickRequest, request, "click").pipe(Effect.flatMap((value) => bound.click(value.selector)), Effect.flatMap((url) => action({ url }))),
-	fill: (request) => checked(FillRequest, request, "fill").pipe(Effect.flatMap((value) => bound.fill(value.selector, value.value)), Effect.flatMap((url) => action({ url }))),
-	scroll: (request) => checked(ScrollRequest, request, "scroll").pipe(Effect.flatMap((value) => bound.scroll(value.deltaX, value.deltaY)), Effect.flatMap((url) => action({ url }))),
-	pointerMove: (request) => checked(PointerMoveRequest, request, "pointer-move").pipe(Effect.flatMap((value) => bound.pointerMove(value.to)), Effect.flatMap((input) => pointerMoved({
-		...input,
-		kind: "pointer-move"
-	}))),
-	hover: (request) => checked(HoverRequest, request, "hover").pipe(Effect.flatMap((value) => bound.hover(value.selector)), Effect.flatMap((input) => hovered({
-		...input,
-		kind: "hover"
-	}))),
-	wheel: (request) => checked(WheelRequest, request, "wheel").pipe(Effect.flatMap((value) => bound.wheel(value.deltaX, value.deltaY, value.at).pipe(Effect.flatMap((input) => wheeled({
-		...input,
-		kind: "wheel",
-		delta: {
-			x: value.deltaX,
-			y: value.deltaY
-		}
-	}))))),
-	press: (request) => checked(PressRequest, request, "press").pipe(Effect.flatMap((value) => bound.press(value.key, value.modifiers ?? [], value.into)), Effect.flatMap((input) => pressed({
-		...input,
-		kind: "press"
-	}))),
-	type: (request) => checked(TypeRequest, request, "type").pipe(Effect.flatMap((value) => bound.type(value.text, value.into)), Effect.flatMap((input) => typed({
-		...input,
-		kind: "type"
-	}))),
-	screenshot: (request) => checked(ScreenshotRequest, request, "screenshot").pipe(Effect.flatMap((value) => bound.screenshot(value.fullPage)), Effect.flatMap((bytes) => decoded(ScreenshotResult, "screenshot")({
-		mediaType: "image/png",
-		bytes: new Uint8Array(bytes)
-	})))
-});
-/**
-* 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);
-});
-/** A browser-operation failure keeps its meaning when it is reported as an initialization one. */
-const initialization = (reason) => reason === "busy" ? "busy" : reason === "closed" || reason === "disconnected" ? "closed" : reason === "timeout" ? "timeout" : reason === "stale" ? "stale" : reason === "unsupported" ? "unsupported" : reason === "configuration" ? "configuration" : "native";
-const makeSession = (controls, bindings) => {
-	const currentTarget = controls.currentTarget.pipe(Effect.map(() => makeTarget(controls.bind())));
-	const Wait = Schema.Struct({
-		selector: ClickRequest.fields.selector,
-		state: Schema.Literals([
-			"visible",
-			"hidden",
-			"attached",
-			"detached"
-		])
-	});
-	const navigate = (url) => action({ url });
-	const session = {
-		reference: controls.reference,
-		failure: bindings.failure,
-		bindingDiagnostics: bindings.diagnostics,
-		bind: () => makeTarget(controls.bind()),
-		currentTarget,
-		target: controls.currentTarget,
-		observe: (options = {}) => checked(ObservationOptions, options, "observe").pipe(Effect.flatMap((value) => controls.observe({
-			...value,
-			scope: value.scope ?? "document"
-		}))),
-		checkpoint: (options = {}) => checked(CheckpointOptions, options, "checkpoint").pipe(Effect.flatMap((value) => controls.checkpoint({
-			...value,
-			picture: value.picture ?? false
-		})), Effect.flatMap(({ picture, ...sampled }) => decoded(Checkpoint, "checkpoint")({
-			...sampled,
-			...picture === void 0 ? {} : { picture: {
-				mediaType: "image/png",
-				bytes: new Uint8Array(picture)
-			} }
-		}))),
-		controlFacts: (reference) => checked(ObservedElement, reference, "control-facts").pipe(Effect.flatMap(controls.controlFacts)),
-		revalidateElement: (reference) => checked(ObservedElement, reference, "revalidate").pipe(Effect.flatMap((value) => controls.revalidate(value).pipe(Effect.as(value)))),
-		clickElement: (reference, admission) => checked(ObservedElement, reference, "click").pipe(Effect.flatMap((value) => controls.bind().click(value, admission?.admit)), Effect.flatMap(navigate)),
-		fillElement: (reference, value, admission) => checked(ObservedElement, reference, "fill").pipe(Effect.flatMap((element) => checked(FillRequest.fields.value, value, "fill").pipe(Effect.flatMap((text) => controls.bind().fill(element, text, admission?.admit)))), Effect.flatMap(navigate)),
-		hoverElement: (reference, admission) => checked(ObservedElement, reference, "hover").pipe(Effect.flatMap((value) => controls.bind().hover(value, admission?.admit)), Effect.flatMap((input) => hovered({
-			...input,
-			kind: "hover"
-		}))),
-		pressElement: (reference, stroke, admission) => checked(ObservedElement, reference, "press").pipe(Effect.flatMap((element) => checked(KeyStroke, stroke, "press").pipe(Effect.flatMap((value) => controls.bind().press(value.key, value.modifiers ?? [], element, admission?.admit)))), Effect.flatMap((input) => pressed({
-			...input,
-			kind: "press"
-		}))),
-		typeElement: (reference, text, admission) => checked(ObservedElement, reference, "type").pipe(Effect.flatMap((element) => checked(TypeRequest.fields.text, text, "type").pipe(Effect.flatMap((value) => controls.bind().type(value, element, admission?.admit)))), Effect.flatMap((input) => typed({
-			...input,
-			kind: "type"
-		}))),
-		pages: controls.pages,
-		frames: controls.frames,
-		selectPage: (id) => checked(Identifier, id, "select-page").pipe(Effect.flatMap(controls.selectPage), Effect.andThen(currentTarget)),
-		selectFrame: (id) => checked(Identifier, id, "select-frame").pipe(Effect.flatMap(controls.selectFrame), Effect.andThen(currentTarget)),
-		createPage: controls.createPage(),
-		closePage: (id) => checked(Identifier, id, "close-page").pipe(Effect.flatMap(controls.closePage)),
-		resizeViewport: (viewport) => checked(Viewport, viewport, "resize").pipe(Effect.flatMap(controls.resize)),
-		waitFor: (request) => checked(Wait, request, "wait").pipe(Effect.flatMap((value) => controls.waitFor(value.selector, value.state))),
-		clickAndWait: (request) => checked(ClickRequest, request, "click-and-wait").pipe(Effect.flatMap((value) => controls.clickAndWait(value.selector)), Effect.flatMap((url) => action({ url }))),
-		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)),
-		ready: controls.readiness.pipe(Effect.mapError((error) => InitializationError.make({
-			operation: "ready",
-			step: "session",
-			reason: initialization(error.reason)
-		})), Effect.flatMap((state) => state._tag === "NotReady" ? Effect.fail(InitializationError.make({
-			operation: "ready",
-			step: state.step,
-			reason: state.reason === "failed" ? "output" : state.reason
-		})) : Effect.succeed({ _tag: state._tag }))),
-		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
-	};
-	associate(session, controls.capture);
-	associatePageControl(session, controls.pageControl);
-	return session;
-};
-/**
-* 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 as n, Browser_exports as t };
+export { decoded as a, preparePlan as c, checked as i, compileBootstrap as l, borrowedRemote as n, makeSession as o, ownedRemote as r, makeBindings as s, acquireSession as t };
 
-//# sourceMappingURL=Browser-joE4Zgys.mjs.map
+//# sourceMappingURL=Session-D4nT9hOO.mjs.map