effect-browserbase 0.1.0-beta.102 → 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, 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,126 +23,15 @@ 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 BrowserbaseSession<E = never> {
+/** Browserbase identity, remote artifacts and provider cleanup remain hosted capabilities. */
+export interface BrowserbaseSession<E = never> extends BrowserSession<E> {
   readonly reference: SessionReference;
-  /** 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>;
+  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>;
   /** 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>;
   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>;
@@ -152,13 +40,9 @@ export interface BrowserbaseSession<E = never> {
     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. */
@@ -173,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,2 +1,267 @@
-import { n as BrowserbaseBrowser } from "./Browser-joE4Zgys.mjs";
+import { SessionError } from "./Errors.mjs";
+import { DownloadObservation } from "./Transfers.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 { 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"
+});
+/**
+* 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 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"
+	}))))
+});
+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",
+		files: request.selection.files
+	});
+	const uploads = request.selection.uploads;
+	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 || issued.reference.projectId !== reference.projectId || issued.reference.sessionId !== reference.sessionId) return Effect.fail(BrowserError.make({
+			operation,
+			reason: Reasons.Authorization.make({}),
+			outcome: "undispatched"
+		}));
+		paths.push(issued.remotePath);
+	}
+	return Effect.succeed({
+		_tag: "Stored",
+		paths
+	});
+});
+const makeSession = (connection, lifetime) => {
+	const { session, operations } = connection;
+	return Object.assign(session, {
+		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
+		}))),
+		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
+	});
+};
+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;
+			if (options.launch.context?.persist === true && options.contextWriter === void 0) return yield* BrowserError.make({
+				operation: "configure",
+				reason: Reasons.ContextLease.make({}),
+				outcome: "undispatched"
+			});
+			if (Object.prototype.hasOwnProperty.call(options, "bootstrap")) return yield* BrowserError.make({
+				operation: "configure",
+				reason: Reasons.Configuration.make({}),
+				outcome: "undispatched"
+			});
+			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",
+				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 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.lifetime.attempt,
+					failure: acquired.failure,
+					close: acquired.close,
+					connect: acquired.connect.pipe(Effect.andThen(connected))
+				};
+			});
+			const attach = Effect.fnUntraced(function* (reference, request) {
+				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))
+			});
+		}));
+	}
+};
+/** 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 },
+	...options.popupPolicy === void 0 ? {} : { popupPolicy: options.popupPolicy },
+	...options.dialogPolicy === void 0 ? {} : { dialogPolicy: options.dialogPolicy },
+	...options.pageControl === void 0 ? {} : { pageControl: options.pageControl }
+});
+//#endregion
 export { BrowserbaseBrowser };
+
+//# sourceMappingURL=Browser.mjs.map

package/dist/Browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Browser.mjs","names":[],"sources":["../src/internal/session/Attachment.ts","../src/internal/session/Browser.ts","../src/Browser.ts"],"sourcesContent":["import { Effect, Exit, Option, Scope } from \"effect\";\n\nimport type { CleanupResult } from \"../../Cleanup.ts\";\nimport { BrowserbaseClient } from \"../../Client.ts\";\nimport { SessionError } from \"../../Errors.ts\";\nimport type { SessionReference } from \"../../References.ts\";\nimport { isTerminalSessionStatus } from \"../../SessionData.ts\";\nimport { BrowserbaseSessions } from \"../../Sessions.ts\";\nimport { connectionAddress } from \"../provider/Connection.ts\";\nimport {\n  makeCleanup,\n  noLocalConnection,\n  reported,\n  type CleanupLimits,\n  type LocalCleanup,\n} from \"./Cleanup.ts\";\nimport { reportCleanup } from \"./Diagnostics.ts\";\n\nexport interface AttachmentOptions {\n  readonly reference: SessionReference;\n  /** Bounded admission of a session the provider has not finished starting. */\n  readonly pendingWaitMillis?: number;\n  readonly onCleanup?: (result: CleanupResult) => Effect.Effect<void>;\n}\n\nconst failure = (reason: SessionError[\"reason\"]) =>\n  SessionError.make({ operation: \"session-attach\", reason, outcome: \"undispatched\" });\n\n/**\n * Borrowing an already running session. This scope owns its local connection and nothing\n * else: no allocation attempt is made, no release is requested, and no Context-writer\n * authority is claimed. Whoever allocated the session keeps all three.\n */\nexport const attachRemote = Effect.fnUntraced(function* (\n  options: AttachmentOptions,\n  local: LocalCleanup = noLocalConnection,\n  limits?: CleanupLimits,\n) {\n  const client = yield* BrowserbaseClient;\n  const sessions = yield* BrowserbaseSessions;\n  const parent = yield* Scope.Scope;\n  const pendingWaitMillis = options.pendingWaitMillis ?? 0;\n\n  if (\n    !Number.isSafeInteger(pendingWaitMillis) ||\n    pendingWaitMillis < 0 ||\n    pendingWaitMillis > 600_000\n  )\n    return yield* failure(\"configuration\");\n\n  // The status read validates project authority before anything is borrowed. A terminal\n  // session needs a fresh allocation from durable state, never a reattachment.\n  const observed = yield* sessions.retrieve(options.reference);\n\n  if (isTerminalSessionStatus(observed.status)) return yield* failure(\"expired\");\n  if (observed.status !== \"RUNNING\") {\n    if (pendingWaitMillis === 0) return yield* failure(\"active\");\n    yield* sessions.waitUntilRunning(observed.reference, { timeoutMillis: pendingWaitMillis });\n  }\n  const reference = observed.reference;\n\n  return yield* Effect.uninterruptible(\n    Effect.gen(function* () {\n      const resourceScope = yield* Scope.make();\n      let closing = false;\n      let cleanup: CleanupResult | undefined;\n\n      const terminate = yield* Effect.cached(\n        Effect.uninterruptible(\n          Effect.gen(function* () {\n            closing = true;\n\n            const coordinator = yield* makeCleanup(\n              reference,\n              \"borrowed\",\n              sessions,\n              local,\n              (result) => {\n                cleanup = result;\n              },\n              limits,\n            );\n\n            yield* coordinator.close;\n            const result = cleanup;\n            const notify = options.onCleanup;\n\n            if (result !== undefined) {\n              yield* reported(Effect.suspend(() => reportCleanup(result)));\n              if (notify !== undefined) yield* reported(Effect.suspend(() => notify(result)));\n            }\n          }),\n        ),\n      );\n\n      const closeScope = yield* Effect.cached(Scope.close(resourceScope, Exit.void));\n\n      // Teardown is registered before the first connection, exactly as an owned scope does.\n      yield* Scope.addFinalizer(resourceScope, terminate);\n      yield* Scope.addFinalizer(parent, closeScope);\n\n      return {\n        reference,\n        status: observed,\n        connection: (timeoutMillis: number) =>\n          Effect.suspend(() =>\n            closing\n              ? Effect.fail(\n                  SessionError.make({\n                    operation: \"session-connect\",\n                    reason: \"expired\",\n                    outcome: \"undispatched\",\n                  }),\n                )\n              : // Credentials are fetched fresh: an expiry can race the caller's own read.\n                connectionAddress(client, sessions, reference, timeoutMillis),\n          ),\n        release: closeScope.pipe(\n          Effect.andThen(\n            Effect.suspend(() =>\n              cleanup === undefined\n                ? Effect.die(new Error(\"Borrowed session closed without cleanup evidence\"))\n                : Effect.succeed(cleanup),\n            ),\n          ),\n        ),\n        cleanupResult: Effect.sync(() => Option.fromNullishOr(cleanup)),\n      };\n    }),\n  );\n});\n","import { Effect, Option, type Redacted } from \"effect\";\nimport type { Lifetime, Source } from \"effect-browser/browser-runtime\";\nimport { BrowserError, Reasons } from \"effect-browser/errors\";\n\nimport type { CleanupResult } from \"../../Cleanup.ts\";\nimport { BrowserbaseClient } from \"../../Client.ts\";\nimport type { AllocationError, ContextError, SessionError } from \"../../Errors.ts\";\nimport type { LaunchRecipe } from \"../../Launch.ts\";\nimport type { AllocationAttempt, SessionReference } from \"../../References.ts\";\nimport { BrowserbaseSessions } from \"../../Sessions.ts\";\nimport { issueLiveView, type LiveView } from \"../browser/LiveView.ts\";\nimport { browserRequestFailure } from \"../browser/RequestFailure.ts\";\nimport { acquireRemote } from \"./Acquisition.ts\";\nimport { attachRemote } from \"./Attachment.ts\";\nimport type { ContextWriterPermit } from \"./WriterFacts.ts\";\n\nexport interface RemoteLease extends Lifetime {\n  readonly reference: SessionReference;\n  readonly closeChecked: Effect.Effect<CleanupResult, BrowserError>;\n  readonly attempt?: AllocationAttempt;\n  readonly release: Effect.Effect<CleanupResult>;\n  readonly cleanupResult: Effect.Effect<Option.Option<CleanupResult>>;\n  readonly liveView: (ttl: number) => Effect.Effect<LiveView, BrowserError>;\n}\n\ntype RemoteSource<L extends Lifetime, E> = Source<L, E, BrowserbaseClient | BrowserbaseSessions>;\n\n/** A borrowed connection closes without requiring or requesting remote termination. */\nconst checkedCleanup = (\n  close: Effect.Effect<CleanupResult>,\n): Effect.Effect<CleanupResult, BrowserError> =>\n  close.pipe(\n    Effect.filterOrFail(\n      (result) =>\n        result.local === \"closed\" &&\n        result.issues.length === 0 &&\n        (result.ownership === \"borrowed\"\n          ? result.remote === \"not-owned\"\n          : result.remote === \"confirmed\"),\n      () =>\n        BrowserError.make({\n          operation: \"close\",\n          reason: Reasons.Provider.make({}),\n          outcome: \"unknown\",\n        }),\n    ),\n  );\n\nconst withConnection = <\n  A extends {\n    readonly reference: SessionReference;\n    readonly connection: (\n      timeoutMillis: number,\n    ) => Effect.Effect<Redacted.Redacted<string>, SessionError>;\n    readonly release: Effect.Effect<CleanupResult>;\n    readonly cleanupResult: Effect.Effect<Option.Option<CleanupResult>>;\n  },\n>(\n  acquired: A,\n) => ({\n  ...acquired,\n  connection: (timeoutMillis: number) =>\n    acquired\n      .connection(timeoutMillis)\n      .pipe(Effect.mapError((error) => browserRequestFailure(\"connect\", error))),\n  closeChecked: checkedCleanup(acquired.release),\n  controlRetired: acquired.cleanupResult.pipe(\n    Effect.map(\n      (result) =>\n        Option.isSome(result) &&\n        result.value.ownership === \"owned\" &&\n        result.value.remote === \"confirmed\",\n    ),\n  ),\n});\n\nexport interface OwnedLease extends RemoteLease {\n  readonly attempt: AllocationAttempt;\n}\n\nexport interface OwnedOptions {\n  /** The single provider-faithful launch description; the owner adds no second default body. */\n  readonly launch: LaunchRecipe;\n  /** Required for a persistent context; the writer permit, not this owner, holds that authority. */\n  readonly contextWriter?: ContextWriterPermit;\n  readonly onCleanup?: (result: CleanupResult) => Effect.Effect<void>;\n  readonly onAllocationUncertain?: (attempt: AllocationAttempt) => Effect.Effect<void>;\n}\n\n/** Allocates the session, and therefore owns releasing it. */\nconst providerControls = (\n  client: BrowserbaseClient[\"Service\"],\n  sessions: BrowserbaseSessions[\"Service\"],\n  reference: SessionReference,\n) => ({\n  liveView: (ttl: number) => issueLiveView(client, reference, ttl),\n  verifyReconnect: sessions.retrieve(reference).pipe(\n    Effect.mapError((error) => browserRequestFailure(\"reconnect\", error)),\n    Effect.flatMap((status) =>\n      status.status === \"RUNNING\"\n        ? Effect.void\n        : Effect.fail(\n            BrowserError.make({\n              operation: \"reconnect\",\n              reason: Reasons.Expired.make({}),\n              outcome: \"undispatched\",\n            }),\n          ),\n    ),\n  ),\n});\n\nexport const ownedRemote =\n  (\n    options: OwnedOptions,\n  ): RemoteSource<OwnedLease, AllocationError | BrowserError | ContextError> =>\n  (local, lifetimeDeadline) =>\n    Effect.gen(function* () {\n      const client = yield* BrowserbaseClient;\n      const sessions = yield* BrowserbaseSessions;\n\n      const acquired = yield* acquireRemote(\n        {\n          launch: options.launch,\n          ...(options.contextWriter === undefined ? {} : { contextWriter: options.contextWriter }),\n          allocationDeadline: lifetimeDeadline,\n          ...(options.onCleanup === undefined ? {} : { onCleanup: options.onCleanup }),\n          ...(options.onAllocationUncertain === undefined\n            ? {}\n            : { onAllocationUncertain: options.onAllocationUncertain }),\n        },\n        local,\n      );\n\n      return {\n        ...withConnection(acquired),\n        ...providerControls(client, sessions, acquired.reference),\n      };\n    });\n\n/** Borrows a running session: local connection only, and never a release request. */\nexport const borrowedRemote =\n  (options: {\n    readonly reference: SessionReference;\n    readonly pendingWaitMillis?: number;\n    readonly onCleanup?: (result: CleanupResult) => Effect.Effect<void>;\n  }): RemoteSource<RemoteLease, SessionError> =>\n  (local) =>\n    Effect.gen(function* () {\n      const client = yield* BrowserbaseClient;\n      const sessions = yield* BrowserbaseSessions;\n      const acquired = yield* attachRemote(options, local);\n\n      return {\n        ...withConnection(acquired),\n        ...providerControls(client, sessions, acquired.reference),\n      };\n    });\n","import { Context, Effect, Layer, type Option, type Redacted, Schema, type Scope } from \"effect\";\nimport type { BrowserSession, OpenOptions } from \"effect-browser/browser\";\nimport type {\n  ActionResult,\n  AutomationOptions,\n  BrowserPolicy,\n  ClickRequest,\n  Observation,\n} from \"effect-browser/browser-data\";\nimport * as BrowserRuntime from \"effect-browser/browser-runtime\";\nimport {\n  BrowserError,\n  Reasons,\n  type BrowserOperation,\n  type InitializationError,\n} from \"effect-browser/errors\";\n\nimport { BrowserbaseBrowserBinding } from \"./BrowserBinding.ts\";\nimport type { CleanupResult } from \"./Cleanup.ts\";\nimport { BrowserbaseClient } from \"./Client.ts\";\nimport type { AllocationError, ContextError, SessionError } from \"./Errors.ts\";\nimport type { LiveView } from \"./internal/browser/LiveView.ts\";\nimport { borrowedRemote, ownedRemote, type RemoteLease } from \"./internal/session/Browser.ts\";\nimport type { ContextWriterPermit } from \"./internal/session/WriterFacts.ts\";\nimport { issuedUpload } from \"./internal/upload/Issued.ts\";\nimport type { LaunchRecipe } from \"./Launch.ts\";\nimport type { AllocationAttempt, SessionReference } from \"./References.ts\";\nimport { BrowserbaseSessions } from \"./Sessions.ts\";\nimport { DownloadObservation, type SelectFilesRequest } from \"./Transfers.ts\";\n\nexport type { LiveView } from \"./internal/browser/LiveView.ts\";\nexport type { FileSelection, SelectFilesRequest } from \"./Transfers.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/** Browserbase identity, remote artifacts and provider cleanup remain hosted capabilities. */\nexport interface BrowserbaseSession<E = never> extends BrowserSession<E> {\n  readonly reference: SessionReference;\n  readonly closeChecked: Effect.Effect<CleanupResult, BrowserError>;\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>;\n  readonly cleanupResult: Effect.Effect<Option.Option<CleanupResult>>;\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>;\n}\n\n/** Only receipts issued for this exact provider session may resolve to stored paths. */\nconst selection = (\n  request: SelectFilesRequest,\n  reference: SessionReference,\n  operation: BrowserOperation,\n): Effect.Effect<BrowserRuntime.ResolvedFileSelection, BrowserError> =>\n  Effect.suspend(() => {\n    if (request.selection._tag === \"Inline\")\n      return Effect.succeed<BrowserRuntime.ResolvedFileSelection>({\n        _tag: \"Inline\",\n        files: request.selection.files,\n      });\n\n    const uploads = request.selection.uploads;\n\n    if (!Array.isArray(uploads) || uploads.length < 1 || uploads.length > 8)\n      return Effect.fail(\n        BrowserError.make({\n          operation,\n          reason: Reasons.Configuration.make({}),\n          outcome: \"undispatched\",\n        }),\n      );\n    const paths: string[] = [];\n\n    for (const receipt of uploads) {\n      const issued = issuedUpload(receipt);\n\n      if (\n        issued === undefined ||\n        issued.reference.projectId !== reference.projectId ||\n        issued.reference.sessionId !== reference.sessionId\n      )\n        return Effect.fail(\n          BrowserError.make({\n            operation,\n            reason: Reasons.Authorization.make({}),\n            outcome: \"undispatched\",\n          }),\n        );\n      paths.push(issued.remotePath);\n    }\n\n    return Effect.succeed<BrowserRuntime.ResolvedFileSelection>({ _tag: \"Stored\", paths });\n  });\n\nconst makeSession = <E>(\n  connection: BrowserRuntime.Connection<SessionReference, E>,\n  lifetime: RemoteLease,\n): BrowserbaseSession<E> => {\n  const { session, operations } = connection;\n\n  // Decorating the same object preserves its private capture and page-control associations.\n  return Object.assign(session, {\n    reference: lifetime.reference,\n    closeChecked: session.closeChecked.pipe(Effect.andThen(lifetime.closeChecked)),\n    clickForDownload: (request) =>\n      operations.clickForDownload(request).pipe(\n        Effect.flatMap((event) =>\n          Schema.decodeEffect(DownloadObservation)({\n            ...event,\n            reference: lifetime.reference,\n          }).pipe(\n            Effect.mapError(() =>\n              BrowserError.make({\n                operation: \"download-action\",\n                reason: Reasons.Malformed.make({}),\n                outcome: \"unknown\",\n              }),\n            ),\n          ),\n        ),\n      ),\n    selectFiles: (request) =>\n      selection(request, lifetime.reference, \"select-files\").pipe(\n        Effect.flatMap((files) =>\n          operations.selectFiles({ selector: request.selector, selection: files }),\n        ),\n      ),\n    clickForFileSelection: (request) =>\n      selection(request, lifetime.reference, \"file-chooser\").pipe(\n        Effect.flatMap((files) =>\n          operations.clickForFileSelection({ selector: request.selector, selection: files }),\n        ),\n      ),\n    liveView: (ttl = 60) => operations.liveView(lifetime.liveView(ttl)),\n    beginHandoff: (ttl = 60) => operations.beginHandoff(lifetime.liveView(ttl)),\n    resume: operations.resume,\n    detach: operations.detach,\n    reconnect: operations.reconnect,\n    close: lifetime.release,\n    cleanupResult: lifetime.cleanupResult,\n  } satisfies Omit<BrowserbaseSession<E>, Exclude<keyof BrowserSession<E>, \"closeChecked\">>);\n};\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  }\n>()(\"effect-browserbase/Browser\") {\n  /** Open through the configured account and browser service, in the caller's scope. */\n  static open<E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>) {\n    return Effect.flatMap(BrowserbaseBrowser, (browser) => browser.open(policy, request));\n  }\n\n  /** Allocate the provider lifetime before connecting, preserving its attempt and cleanup. */\n  static acquire<E = never, R = never>(policy: BrowserPolicy, request?: OpenOptions<E, R>) {\n    return Effect.flatMap(BrowserbaseBrowser, (browser) => browser.acquire(policy, request));\n  }\n\n  /** Borrow a provider session without acquiring release authority over it. */\n  static attach<E = never, R = never>(reference: SessionReference, request: AttachRequest<E, R>) {\n    return Effect.flatMap(BrowserbaseBrowser, (browser) => browser.attach(reference, request));\n  }\n\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        const binding = yield* BrowserbaseBrowserBinding;\n\n        if (options.launch.context?.persist === true && options.contextWriter === undefined)\n          return yield* BrowserError.make({\n            operation: \"configure\",\n            reason: Reasons.ContextLease.make({}),\n            outcome: \"undispatched\",\n          });\n        if (Object.prototype.hasOwnProperty.call(options, \"bootstrap\"))\n          return yield* BrowserError.make({\n            operation: \"configure\",\n            reason: Reasons.Configuration.make({}),\n            outcome: \"undispatched\",\n          });\n\n        const runtime = yield* BrowserRuntime.make({\n          implementation: \"browserbase-playwright-cdp\",\n          binding,\n          automation: projected(options),\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          preserveViewport: options.launch.viewport._tag !== \"Fixed\",\n          keepAlive: options.launch.keepAlive === true,\n        });\n\n        const source =\n          <L extends BrowserRuntime.Lifetime, E>(\n            remote: BrowserRuntime.Source<L, E, BrowserbaseClient | BrowserbaseSessions>,\n          ): BrowserRuntime.Source<L, E> =>\n          (cleanup, deadline) =>\n            remote(cleanup, deadline).pipe(\n              Effect.provideService(BrowserbaseClient, client),\n              Effect.provideService(BrowserbaseSessions, sessions),\n            );\n\n        const acquire = Effect.fnUntraced(function* <E = never, R = never>(\n          policy: BrowserPolicy,\n          request: OpenOptions<E, R> = {},\n        ) {\n          const acquired = yield* runtime.acquire(\n            policy,\n            source(\n              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            ),\n            request,\n          );\n\n          const connected = yield* Effect.cached(\n            acquired.connect.pipe(\n              Effect.map((connection) => makeSession(connection, acquired.lifetime)),\n            ),\n          );\n\n          return {\n            reference: acquired.reference,\n            attempt: acquired.lifetime.attempt,\n            failure: acquired.failure,\n            close: acquired.close,\n            connect: acquired.connect.pipe(Effect.andThen(connected)),\n          } satisfies BrowserAcquisition<E>;\n        });\n\n        const attach = Effect.fnUntraced(function* <E = never, R = never>(\n          reference: SessionReference,\n          request: AttachRequest<E, R>,\n        ) {\n          const acquired = yield* runtime.acquire(\n            request.policy,\n            source(\n              borrowedRemote({\n                reference,\n                ...(request.pendingWaitMillis === undefined\n                  ? {}\n                  : { pendingWaitMillis: request.pendingWaitMillis }),\n                ...(options.onCleanup === undefined ? {} : { onCleanup: options.onCleanup }),\n              }),\n            ),\n            {\n              ...(request.bootstrap === undefined ? {} : { bootstrap: request.bootstrap }),\n              existingTarget: request.target ?? {},\n            },\n          );\n\n          return yield* acquired.connect.pipe(\n            Effect.map((connection) => makeSession(connection, acquired.lifetime)),\n          );\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        });\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.maxHostReads === undefined ? {} : { maxHostReads: options.maxHostReads }),\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.d.mts

@@ -1,40 +1,13 @@
-import { BrowserError } from "./Errors.mjs";
-import { Context, Effect, Layer, Redacted } from "effect";
+import { Context, Layer } from "effect";
+import * as BrowserRuntime from "effect-browser/browser-runtime";
 //#region src/BrowserBinding.d.ts
-/**
- * The trusted native engine an owned or borrowed browser connects through. It is opaque: only
- * this module issues one, so a value that merely has this shape is refused before allocation
- * rather than trusted with a connection.
- */
-export interface BrowserBinding {
-  readonly _tag: "BrowserbaseBrowserBinding";
-}
-export interface PlaywrightOptions {
-  /**
-   * Trusted host routing. It runs only after the provider-issued address passed the same strict
-   * checks as the default, and returns the CDP endpoint to connect to instead. A local engine
-   * reached this way says nothing about how a hosted connection behaves.
-   */
-  readonly resolveEndpoint?: (provider: {
-    readonly url: Redacted.Redacted<string>;
-  }) => Effect.Effect<string, BrowserError>;
-  /**
-   * Trusted instrumentation of the engine's own browser object, called once per connection with
-   * the endpoint it reached, before the owner drives it. The object is typed `unknown` so that
-   * no declaration of this package names the optional native peer; it is host configuration,
-   * never model-facing.
-   */
-  readonly onConnected?: (connection: {
-    readonly native: unknown;
-    readonly endpoint: string;
-  }) => void;
-}
-/** Playwright over CDP, lazily loaded at connection time and never at Layer construction. */
+export type BrowserBinding = BrowserRuntime.BrowserBinding;
+export type PlaywrightOptions = BrowserRuntime.PlaywrightOptions;
+/** Validate provider authority before invoking any trusted host routing. */
 export declare const playwright: (options?: PlaywrightOptions) => BrowserBinding;
-/** Defaults to Playwright with the provider's own address, so no consumer has to provide it. */
-export declare const BrowserbaseBrowserBinding: Context.Reference<BrowserBinding>;
-/** Supply a binding to every browser Layer built beneath it. */
+export declare const BrowserbaseBrowserBinding: Context.Reference<BrowserRuntime.BrowserBinding>;
 export declare const layer: (binding: BrowserBinding) => Layer.Layer<never>;
 export declare const layerPlaywright: Layer.Layer<never>;
 //#endregion
+export {};
 //# sourceMappingURL=BrowserBinding.d.mts.map

package/dist/BrowserBinding.mjs

@@ -1,2 +1,31 @@
-import { i as playwright, n as layer, r as layerPlaywright, t as BrowserbaseBrowserBinding } from "./BrowserBinding-qbQA6JhH.mjs";
+import { n as validateConnection } from "./Connection-DcvJZEdc.mjs";
+import { Context, Effect, Layer, Redacted } from "effect";
+import { BrowserError, Reasons } from "effect-browser/errors";
+import * as BrowserRuntime from "effect-browser/browser-runtime";
+//#region src/BrowserBinding.ts
+/** Validate provider authority before invoking any trusted host routing. */
+const playwright = (options = {}) => {
+	const { resolveEndpoint, onConnected } = options;
+	return BrowserRuntime.playwright({
+		resolveEndpoint: ({ url }) => Effect.gen(function* () {
+			const validated = yield* Effect.try({
+				try: () => validateConnection(Redacted.value(url)),
+				catch: (error) => error instanceof BrowserError ? error : BrowserError.make({
+					operation: "connect",
+					reason: Reasons.Malformed.make({}),
+					outcome: "undispatched"
+				})
+			});
+			return yield* resolveEndpoint === void 0 ? Effect.succeed(validated) : resolveEndpoint({ url: Redacted.make(validated) });
+		}),
+		...onConnected === void 0 ? {} : { onConnected }
+	});
+};
+const defaultBinding = playwright();
+const BrowserbaseBrowserBinding = Context.Reference("effect-browserbase/BrowserBinding", { defaultValue: () => defaultBinding });
+const layer = (binding) => Layer.succeed(BrowserbaseBrowserBinding, binding);
+const layerPlaywright = layer(defaultBinding);
+//#endregion
 export { BrowserbaseBrowserBinding, layer, layerPlaywright, playwright };
+
+//# sourceMappingURL=BrowserBinding.mjs.map