@orkestrel/browser 0.0.26 → 0.0.28

package/dist/src/server/index.js

@@ -1,10 +1,10 @@
-import { BROWSER_DEFAULT_TIMEOUT_MS, BROWSER_JOURNEY_FORMAT_VERSION, BROWSER_JOURNEY_NAME_PATTERN, BROWSER_JOURNEY_TOOL_NAMES, BROWSER_RUN_ID_PATTERN, BROWSER_TOOL_COPY, BROWSER_TOOL_NAMES, BrowserConnectionError, BrowserContext, BrowserError, BrowserTransition, CDPClient, createBrowserToolset, createCDPClient, generateBrowserRunId, isBrowserConnectionError, isBrowserError, isCDPConnectionError, isCDPTimeoutError, normalizeBrowserJourneyReason, validateBrowserContextOptions, validateBrowserJourney, validateBrowserRun, validateBrowserStorePage } from "../core/index.js";
-import { attempt, isArray, isError, isInstance, isInteger, isNumber, isRecord, isString, parseInteger, parseJSON } from "@orkestrel/contract";
 import { existsSync, globSync, realpathSync } from "node:fs";
 import { lstat, mkdir, mkdtemp, open, readFile, readdir, rename, rm, rmdir, unlink, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { basename, dirname, join, posix, relative, resolve, sep, win32 } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
+import { attempt, isArray, isError, isInteger, isJSONValue, isNumber, isRecord, isString, parseInteger, parseJSON } from "@orkestrel/contract";
+import { BROWSER_DEFAULT_TIMEOUT_MS, BROWSER_JOURNEY_FORMAT_VERSION, BROWSER_JOURNEY_NAME_PATTERN, BROWSER_JOURNEY_TOOL_NAMES, BROWSER_RUN_ID_PATTERN, BROWSER_TOOL_COPY, BROWSER_TOOL_CUT_FOOTER, BROWSER_TOOL_LIMIT, BROWSER_TOOL_NAMES, BrowserContext, BrowserError, BrowserTransition, CDPClient, boundBrowserText, createBrowserToolset, createCDPClient, generateBrowserRunId, isBrowserError, normalizeBrowserJourneyReason, validateBrowserContextOptions, validateBrowserJourney, validateBrowserJourneyWriteOptions, validateBrowserRun, validateBrowserStorePage } from "../core/index.js";
 import { randomBytes, randomUUID } from "node:crypto";
 import { request } from "node:http";
 import { request as request$1 } from "node:https";
@@ -226,9 +226,9 @@ var BROWSER_RUN_DIRECTORY = "runs";
 /** Bounds a file-store listing page by default. */
 var BROWSER_FILE_STORE_LIMIT = 100;
 /** Names the refusal when no browser can serve a call. */
-var BROWSER_SERVER_UNAVAILABLE = "BROWSER_SERVER_UNAVAILABLE";
+var BROWSER_SERVER_UNAVAILABLE = "SERVER_UNAVAILABLE";
 /** Names a failed attempt to warm a browser. */
-var BROWSER_SERVER_LAUNCH = "BROWSER_SERVER_LAUNCH";
+var BROWSER_SERVER_LAUNCH = "SERVER_LAUNCH";
 /** Sets the default number of warm browsers to 1. */
 var BROWSER_SERVER_POOL_SIZE = 1;
 /** Sets the default context capacity per browser, including the shared holder. */
@@ -242,21 +242,21 @@ var BROWSER_SERVER_RESTARTS = 1;
 /** Names the browser process record in each profile. */
 var BROWSER_SERVER_RECORD = "browse.json";
 /** Names the diagnostic when the warm floor spends its restart bound. */
-var BROWSER_SERVER_EXHAUSTED = "BROWSER_SERVER_EXHAUSTED";
+var BROWSER_SERVER_EXHAUSTED = "SERVER_EXHAUSTED";
 /** Names a failed browser server teardown. */
-var BROWSER_SERVER_TEARDOWN = "BROWSER_SERVER_TEARDOWN";
+var BROWSER_SERVER_TEARDOWN = "SERVER_TEARDOWN";
 /** Names a failed profile sweep. */
-var BROWSER_SERVER_SWEEP = "BROWSER_SERVER_SWEEP";
+var BROWSER_SERVER_SWEEP = "SERVER_SWEEP";
 /** Names a refused browser server option. */
-var BROWSER_SERVER_OPTIONS = "BROWSER_SERVER_OPTIONS";
+var BROWSER_SERVER_OPTIONS = "ARGUMENT";
 /** Names the notice that a browser and its session state were lost. */
-var BROWSER_SERVER_CRASH = "BROWSER_SERVER_CRASH";
+var BROWSER_SERVER_CRASH = "SERVER_CRASH";
 /** Names an interrupted call whose outcome is unknown. */
-var BROWSER_SERVER_UNRESOLVED = "BROWSER_SERVER_UNRESOLVED";
+var BROWSER_SERVER_UNRESOLVED = "SERVER_UNRESOLVED";
 /** Names the refusal when every browser is admitted to a holder. */
-var BROWSER_SERVER_BUSY = "BROWSER_SERVER_BUSY";
+var BROWSER_SERVER_BUSY = "SERVER_BUSY";
 /** Names the refusal for an unknown or ended holder. */
-var BROWSER_SERVER_HOLDER = "BROWSER_SERVER_HOLDER";
+var BROWSER_SERVER_HOLDER = "SERVER_HOLDER";
 /** Defines the holder tools independently of the shared browser's vocabulary. */
 var BROWSER_SERVER_COPY = Object.freeze({
 	acquire: Object.freeze({
@@ -332,46 +332,6 @@ var BROWSER_SERVER_COPY = Object.freeze({
 	})
 });
 //#endregion
-//#region src/server/errors.ts
-/**
-* Reports that an operation requiring an active connection was attempted while disconnected,
-* under the code `BROWSER_NOT_CONNECTED_ERROR`.
-*/
-var BrowserNotConnectedError = class extends BrowserError {
-	constructor(context) {
-		super("Browser is not connected", "BROWSER_NOT_CONNECTED_ERROR", context);
-		this.name = "BrowserNotConnectedError";
-	}
-};
-/**
-* Reports that an operation was attempted after the browser wrapper was destroyed, under the
-* code `BROWSER_DESTROYED_ERROR`.
-*/
-var BrowserDestroyedError = class extends BrowserError {
-	constructor(context) {
-		super("Browser has been destroyed", "BROWSER_DESTROYED_ERROR", context);
-		this.name = "BrowserDestroyedError";
-	}
-};
-/**
-* Narrows an unknown value to a `BrowserNotConnectedError`.
-*
-* @param value - Value to check
-* @returns True if value is a BrowserNotConnectedError instance; false otherwise
-*/
-function isBrowserNotConnectedError(value) {
-	return isInstance(value, BrowserNotConnectedError);
-}
-/**
-* Narrows an unknown value to a `BrowserDestroyedError`.
-*
-* @param value - Value to check
-* @returns True if value is a BrowserDestroyedError instance; false otherwise
-*/
-function isBrowserDestroyedError(value) {
-	return isInstance(value, BrowserDestroyedError);
-}
-//#endregion
 //#region src/server/helpers.ts
 /**
 * Parses positive integer viewport dimensions in WIDTHxHEIGHT form.
@@ -434,15 +394,15 @@ function parseBrowserProfileRecord(text) {
 * @param url - The lost page's last URL, when known
 * @returns The coded diagnostic and any operation-lifecycle guidance
 * @example
-* describeBrowserServerLoss('BROWSER_SERVER_UNAVAILABLE', new Error('Browser exited'))
+* describeBrowserServerLoss('SERVER_UNAVAILABLE', new Error('Browser exited'))
 */
 function describeBrowserServerLoss(code, cause, url) {
 	const pid = isBrowserError(cause) ? cause.context?.["pid"] : void 0;
 	const message = `${code}: ${(cause === void 0 ? "Browser session lost" : isError(cause) ? cause.message : String(cause)).replace(/\.+$/u, "")}${isNumber(pid) ? ` (pid ${pid})` : ""}.`;
-	if (code !== "BROWSER_SERVER_CRASH" && code !== "BROWSER_SERVER_UNRESOLVED") return message;
-	const lost = `Lost the page${url === void 0 ? "" : ` at ${url}`}, its tabs, every element reference, the retained reading, dialogs, holds, an unsaved recording, the active replay, and the isolated context's cookies.`;
+	if (code !== "SERVER_CRASH" && code !== "SERVER_UNRESOLVED") return message;
+	const lost = `Lost the page${url === void 0 ? "" : ` at ${url}`}, its tabs, every element reference, the last projection, dialogs, holds, an unsaved recording, the active replay, and the isolated context's cookies.`;
 	const next = `The next call acquires a browser that starts at about:blank, or answers ${BROWSER_SERVER_UNAVAILABLE} when none can serve.`;
-	return code === "BROWSER_SERVER_UNRESOLVED" ? `${message} The outcome is unknown. ${lost} Browse did not repeat the call. ${next}` : `${message} ${lost}`;
+	return code === "SERVER_UNRESOLVED" ? `${message} The outcome is unknown. ${lost} Browse did not repeat the call. ${next}` : `${message} ${lost}`;
 }
 /**
 * Formats a process identifier and UUID token as a lock entry name.
@@ -517,16 +477,6 @@ function findSystemBrowsers(options) {
 	return browsers;
 }
 /**
-* Locates a Chrome/Chromium/Edge executable on this machine — the first entry
-* of {@link findSystemBrowsers}.
-*
-* @param options - Overrides for the candidate sources; see {@link SystemBrowserOptions}
-* @returns The first discovered browser, or undefined
-*/
-function findSystemBrowser(options) {
-	return findSystemBrowsers(options)[0];
-}
-/**
 * Classifies an executable path/name into a {@link BrowserEngine} by
 * case-insensitive hint, checked in the order edge → chromium → chrome.
 *
@@ -582,7 +532,7 @@ async function removeBrowserProfile(profile) {
 	if (!profile.temporary) return;
 	const path = resolve(profile.path);
 	const temporary = resolve(tmpdir());
-	if (dirname(path) !== temporary || !basename(path).startsWith("orkestrel-browser-")) throw new BrowserError("Refusing to remove an unsafe browser profile path", void 0, { path });
+	if (dirname(path) !== temporary || !basename(path).startsWith("orkestrel-browser-")) throw new BrowserError("ARGUMENT", "Refusing to remove an unsafe browser profile path", { path });
 	await rm(path, {
 		recursive: true,
 		force: true,
@@ -772,18 +722,18 @@ function readBrowserEndpoint(stream, signal) {
 	stream.on("close", () => {
 		const endpoint = found ? void 0 : BROWSER_DEVTOOLS_PATTERN.exec(pending)?.[1];
 		if (endpoint !== void 0) read.resolve(endpoint);
-		else read.reject(new BrowserConnectionError("Browser closed its standard error before reporting a CDP endpoint"));
+		else read.reject(new BrowserError("CONNECTION", "Browser closed its standard error before reporting a CDP endpoint"));
 	});
 	return read.promise;
 }
 /**
 * Fetches the current CDP target list from a browser's `/json/list` endpoint, as a `Result`
-* carrying either the targets or a coded `BrowserConnectionError`.
+* carrying either the targets or a coded `BrowserError`.
 *
 * @remarks
 * The endpoint is a network boundary, so an unreachable host, a non-2xx
 * response, and a body that is not a JSON array each come back as a failed
-* `Result` carrying a coded `BrowserConnectionError`. An entry missing a
+* `Result` carrying a coded `BrowserError`. An entry missing a
 * required string field is skipped rather than failing the whole list.
 *
 * @param port - Port the browser exposes its CDP endpoint on
@@ -808,7 +758,7 @@ async function fetchCDPTargets(port, timeout, host = BROWSER_DEFAULT_HOST) {
 		const response = await fetch(url, { signal: controller.signal });
 		if (!response.ok) return {
 			success: false,
-			error: new BrowserConnectionError("CDP target list request was refused", {
+			error: new BrowserError("CONNECTION", "CDP target list request was refused", {
 				url,
 				status: response.status
 			})
@@ -816,7 +766,7 @@ async function fetchCDPTargets(port, timeout, host = BROWSER_DEFAULT_HOST) {
 		const list = await response.json();
 		if (!isArray(list)) return {
 			success: false,
-			error: new BrowserConnectionError("CDP target list is not a JSON array", { url })
+			error: new BrowserError("CONNECTION", "CDP target list is not a JSON array", { url })
 		};
 		const targets = [];
 		for (const entry of list) {
@@ -836,9 +786,9 @@ async function fetchCDPTargets(port, timeout, host = BROWSER_DEFAULT_HOST) {
 	} catch (error) {
 		return {
 			success: false,
-			error: new BrowserConnectionError("CDP target list is unreachable", {
+			error: new BrowserError("CONNECTION", "CDP target list is unreachable", {
 				url,
-				error
+				error: isJSONValue(error) ? error : String(error)
 			})
 		};
 	} finally {
@@ -904,7 +854,7 @@ var WebSocketCDPTransport = class {
 	}
 	async send(data) {
 		const socket = this.#socket;
-		if (socket === void 0 || socket.readyState !== WEBSOCKET_READY_OPEN) throw new BrowserConnectionError("WebSocket CDP transport is not open", { url: this.#url });
+		if (socket === void 0 || socket.readyState !== WEBSOCKET_READY_OPEN) throw new BrowserError("CONNECTION", "WebSocket CDP transport is not open", { url: this.#url });
 		socket.send(data);
 	}
 	async close() {
@@ -912,12 +862,12 @@ var WebSocketCDPTransport = class {
 	}
 	async #start() {
 		const parsed = attempt(() => new URL(this.#url));
-		if (!parsed.success) throw new BrowserConnectionError(`WebSocket CDP URL is invalid: ${this.#url}`, {
+		if (!parsed.success) throw new BrowserError("CONNECTION", `WebSocket CDP URL is invalid: ${this.#url}`, {
 			url: this.#url,
-			error: parsed.error
+			error: isJSONValue(parsed.error) ? parsed.error : String(parsed.error)
 		});
 		const url = parsed.value;
-		if (url.protocol !== "ws:" && url.protocol !== "wss:") throw new BrowserConnectionError(`WebSocket CDP connection requires a ws: or wss: URL: ${this.#url}`, { url: this.#url });
+		if (url.protocol !== "ws:" && url.protocol !== "wss:") throw new BrowserError("CONNECTION", `WebSocket CDP connection requires a ws: or wss: URL: ${this.#url}`, { url: this.#url });
 		const key = randomBytes(16).toString("base64");
 		const deferred = Promise.withResolvers();
 		const options = {
@@ -949,7 +899,7 @@ var WebSocketCDPTransport = class {
 	async #close() {
 		const request = this.#request;
 		if (request !== void 0) {
-			this.#rejectRequest(request, new BrowserConnectionError(`WebSocket CDP connection to ${this.#url} was closed before it finished connecting`, { url: this.#url }));
+			this.#rejectRequest(request, new BrowserError("CONNECTION", `WebSocket CDP connection to ${this.#url} was closed before it finished connecting`, { url: this.#url }));
 			request.destroy();
 		}
 		await this.#starting.pending?.catch(() => void 0);
@@ -978,7 +928,7 @@ var WebSocketCDPTransport = class {
 		const accept = response.headers["sec-websocket-accept"];
 		if (!isString(accept) || accept !== computeWebSocketAccept(key)) {
 			socket.destroy();
-			this.#rejectRequest(request, new BrowserConnectionError(`WebSocket CDP connection to ${this.#url} failed: Sec-WebSocket-Accept mismatch`, { url: this.#url }));
+			this.#rejectRequest(request, new BrowserError("CONNECTION", `WebSocket CDP connection to ${this.#url} failed: Sec-WebSocket-Accept mismatch`, { url: this.#url }));
 			return;
 		}
 		try {
@@ -994,13 +944,13 @@ var WebSocketCDPTransport = class {
 	#decline(request, response) {
 		response.resume();
 		const reason = response.statusCode === void 0 ? "upgrade was declined without a status code" : `upgrade declined with status ${response.statusCode}`;
-		this.#rejectRequest(request, new BrowserConnectionError(`WebSocket CDP connection to ${this.#url} failed: ${reason}`, { url: this.#url }));
+		this.#rejectRequest(request, new BrowserError("CONNECTION", `WebSocket CDP connection to ${this.#url} failed: ${reason}`, { url: this.#url }));
 	}
 	#fail(request, error) {
-		this.#rejectRequest(request, new BrowserConnectionError(`WebSocket CDP connection to ${this.#url} failed: ${error.message}`, { url: this.#url }));
+		this.#rejectRequest(request, new BrowserError("CONNECTION", `WebSocket CDP connection to ${this.#url} failed: ${error.message}`, { url: this.#url }));
 	}
 	#expire(request) {
-		this.#rejectRequest(request, new BrowserConnectionError(`WebSocket CDP connection to ${this.#url} timed out after ${this.#timeout}ms`, {
+		this.#rejectRequest(request, new BrowserError("CONNECTION", `WebSocket CDP connection to ${this.#url} timed out after ${this.#timeout}ms`, {
 			url: this.#url,
 			timeout: this.#timeout
 		}));
@@ -1072,7 +1022,7 @@ var FileBrowserWriter = class {
 };
 //#endregion
 //#region package.json
-var version = "0.0.26";
+var version = "0.0.28";
 //#endregion
 //#region src/server/BrowserMCPServer.ts
 /**
@@ -1080,9 +1030,9 @@ var version = "0.0.26";
 * the Model Context Protocol on stdio, and warms Chromium at server start.
 *
 * @remarks
-* The server's own manager holds one dispatcher per name of the vocabulary — `look`, `read`, `plain`,
-* `click`, `type`, `press`, `navigate`, `wait`, `dialog`, `tabs`, `switch`, `record`, `save`,
-* `journeys`, `edit`, `replay`, and `forget` — each carrying the description, parameters, and annotations
+* The server's own manager holds one dispatcher per name of the vocabulary — `read`, `click`,
+* `type`, `press`, `navigate`, `wait`, `dialog`, `switch`, `record`, `save`, `journeys`, `edit`,
+* `replay`, `forget`, and `capture` — each carrying the description, parameters, and annotations
 * `BROWSER_TOOL_COPY` gives, so `tools/list` answers before Chromium starts and with Chromium
 * absent. After the launch, a tool the toolset's manager adds under another name, such as a page
 * tool it adopts, is mirrored as a dispatcher with that tool's definition, and the mirror is
@@ -1119,7 +1069,7 @@ var version = "0.0.26";
 * ```ts
 * import { BrowserMCPServer } from '@orkestrel/browser/server'
 *
-* const server = new BrowserMCPServer({ root: 'tmp/browsers', readonly: true })
+* const server = new BrowserMCPServer({ root: 'tmp/browsers', journeys: { readonly: true } })
 * await server.start()
 * await server.destroy()
 * ```
@@ -1182,8 +1132,8 @@ var BrowserMCPServer = class {
 	constructor(options) {
 		const size = options?.pool?.size ?? 1;
 		const contexts = options?.pool?.contexts ?? 2;
-		if (!isInteger(size) || size < 1 || size > 3) throw new BrowserError(`pool.size must be an integer from 1 through 3`, BROWSER_SERVER_OPTIONS);
-		if (!isInteger(contexts) || contexts < 1 || contexts > 4) throw new BrowserError(`pool.contexts must be an integer from 1 through 4`, BROWSER_SERVER_OPTIONS);
+		if (!isInteger(size) || size < 1 || size > 3) throw new BrowserError(BROWSER_SERVER_OPTIONS, `pool.size must be an integer from 1 through 3`, { subject: "server" });
+		if (!isInteger(contexts) || contexts < 1 || contexts > 4) throw new BrowserError(BROWSER_SERVER_OPTIONS, `pool.contexts must be an integer from 1 through 4`, { subject: "server" });
 		this.#admission = size * contexts;
 		this.#log = options?.log ?? process.stderr;
 		this.#reference = this.#issue.bind(this);
@@ -1198,11 +1148,11 @@ var BrowserMCPServer = class {
 			restarts: 1
 		});
 		this.#root = resolve(options?.root ?? "tmp/browsers");
-		this.#headless = options?.headless ?? true;
-		this.#executable = options?.executable;
-		this.#viewport = options?.viewport;
-		this.#readonly = options?.readonly ?? false;
-		this.#launcher = options?.launch ?? createBrowser;
+		this.#headless = options?.browser?.headless ?? true;
+		this.#executable = options?.browser?.executable;
+		this.#viewport = options?.browser?.viewport;
+		this.#readonly = options?.journeys?.readonly ?? false;
+		this.#launcher = options?.pool?.launch ?? createBrowser;
 		this.#input = options?.stdio?.input ?? process.stdin;
 		this.#tools = createToolManager();
 		const names = [...BROWSER_TOOL_NAMES, ...BROWSER_JOURNEY_TOOL_NAMES];
@@ -1266,7 +1216,7 @@ var BrowserMCPServer = class {
 			warming.then(this.#exhaust.bind(this));
 		} catch (error) {
 			if (this.#closing !== void 0) return;
-			if (isBrowserError(error) && error.code === "BROWSER_SERVER_UNAVAILABLE") throw error;
+			if (isBrowserError(error) && error.code === "SERVER_UNAVAILABLE") throw error;
 			throw this.#unavailable(isPoolError(error) ? error.cause ?? this.#failure : error);
 		}
 	}
@@ -1316,12 +1266,16 @@ var BrowserMCPServer = class {
 			signal: context.signal,
 			...context.caller === void 0 ? {} : { caller: context.caller }
 		});
-		if (!result.success || typeof result.value !== "string") return result;
+		if (!result.success) return {
+			...result,
+			error: boundBrowserText(result.error, BROWSER_TOOL_LIMIT, BROWSER_TOOL_CUT_FOOTER)
+		};
+		if (typeof result.value !== "string") return result;
 		return {
 			resultType: "complete",
 			content: [{
 				type: "text",
-				text: result.value
+				text: context.call.name === "acquire" || context.call.name === "tools" ? result.value : boundBrowserText(result.value, BROWSER_TOOL_LIMIT, BROWSER_TOOL_CUT_FOOTER)
 			}]
 		};
 	}
@@ -1337,8 +1291,8 @@ var BrowserMCPServer = class {
 		context.signal.throwIfAborted();
 		if (this.#closing !== void 0) throw this.#ended();
 		const purpose = args["purpose"];
-		if (!isString(purpose) || purpose.trim().length === 0) throw new BrowserError("purpose must describe the work", "BROWSER_TOOLSET_ARGUMENT");
-		if (this.#holders.size >= this.#admission) throw new BrowserError(`${BROWSER_SERVER_BUSY}: ${[...this.#holders.values()].map((holder) => `${holder.id} (${holder.purpose})`).join(", ")}. Call destroy for a holder no longer needed or call the named tools to share the shared browser.`, BROWSER_SERVER_BUSY);
+		if (!isString(purpose) || purpose.trim().length === 0) throw new BrowserError("ARGUMENT", "purpose must describe the work", { subject: "toolset" });
+		if (this.#holders.size >= this.#admission) throw new BrowserError(BROWSER_SERVER_BUSY, `${BROWSER_SERVER_BUSY}: ${[...this.#holders.values()].map((holder) => `${holder.id} (${holder.purpose})`).join(", ")}. Call destroy for a holder no longer needed or call the named tools to share the shared browser.`);
 		const holder = {
 			id: randomUUID(),
 			purpose,
@@ -1365,14 +1319,14 @@ var BrowserMCPServer = class {
 	}
 	#holder(value) {
 		const holder = isString(value) ? this.#holders.get(value) : void 0;
-		if (holder === void 0 || holder === this.#shared || holder.abort.signal.aborted) throw new BrowserError(`${BROWSER_SERVER_HOLDER}: unknown or ended holder`, BROWSER_SERVER_HOLDER);
+		if (holder === void 0 || holder === this.#shared || holder.abort.signal.aborted) throw new BrowserError(BROWSER_SERVER_HOLDER, `${BROWSER_SERVER_HOLDER}: unknown or ended holder`);
 		return holder;
 	}
 	async #dispatch(args, context) {
 		const holder = this.#holder(args["holder"]);
 		const name = args["name"];
 		const parameters = args["arguments"];
-		if (!isString(name) || !isRecord(parameters)) throw new BrowserError("execute requires name and arguments", "BROWSER_TOOLSET_ARGUMENT");
+		if (!isString(name) || !isRecord(parameters)) throw new BrowserError("ARGUMENT", "execute requires name and arguments", { subject: "toolset" });
 		return this.#forward(holder, name, parameters, context);
 	}
 	async #catalog(args, context) {
@@ -1389,8 +1343,8 @@ var BrowserMCPServer = class {
 			return this.#annotate(holder, JSON.stringify(catalog));
 		} catch (error) {
 			context.signal.throwIfAborted();
-			if (holder.abort.signal.aborted) throw new BrowserError(`${BROWSER_SERVER_UNRESOLVED}: the holder ended during the call`, BROWSER_SERVER_UNRESOLVED);
-			if (isBrowserError(error)) throw new BrowserError(this.#annotate(holder, `${error.code}: ${error.message}`), error.code);
+			if (holder.abort.signal.aborted) throw new BrowserError(BROWSER_SERVER_UNRESOLVED, `${BROWSER_SERVER_UNRESOLVED}: the holder ended during the call`);
+			if (isBrowserError(error)) throw new BrowserError(error.code, this.#annotate(holder, `${error.code}: ${error.message}`));
 			throw error;
 		}
 	}
@@ -1427,7 +1381,7 @@ var BrowserMCPServer = class {
 		context.signal.throwIfAborted();
 		const journey = args["journey"];
 		if (name !== "replay" && name !== "forget" || !isString(journey)) return this.#perform(holder, name, args, context);
-		if (this.#writers.has(journey) || name === "forget" && this.#readers.has(journey)) throw new BrowserError(`BROWSER_JOURNEY_LOCKED: Journey ${journey} is locked; call ${name} again.`, "BROWSER_JOURNEY_LOCKED", { name: journey });
+		if (this.#writers.has(journey) || name === "forget" && this.#readers.has(journey)) throw new BrowserError("STORE_LOCKED", `STORE_LOCKED: Journey ${journey} is locked; call ${name} again.`, { name: journey });
 		const reader = Symbol(journey);
 		if (name === "forget") this.#writers.add(journey);
 		else {
@@ -1453,8 +1407,8 @@ var BrowserMCPServer = class {
 			lease = await this.#serve(holder, signal);
 		} catch (error) {
 			context.signal.throwIfAborted();
-			if (holder !== this.#shared && holder.abort.signal.aborted) throw new BrowserError(`${BROWSER_SERVER_UNRESOLVED}: the holder ended during the call`, BROWSER_SERVER_UNRESOLVED);
-			if (isBrowserError(error)) throw new BrowserError(this.#annotate(holder, `${error.code}: ${error.message}`), error.code);
+			if (holder !== this.#shared && holder.abort.signal.aborted) throw new BrowserError(BROWSER_SERVER_UNRESOLVED, `${BROWSER_SERVER_UNRESOLVED}: the holder ended during the call`);
+			if (isBrowserError(error)) throw new BrowserError(error.code, this.#annotate(holder, `${error.code}: ${error.message}`));
 			throw error;
 		}
 		let result;
@@ -1479,7 +1433,7 @@ var BrowserMCPServer = class {
 			};
 		}
 		context.signal.throwIfAborted();
-		if (holder !== this.#shared && holder.abort.signal.aborted) throw new BrowserError(BROWSER_SERVER_UNRESOLVED + ": the holder ended during the call", BROWSER_SERVER_UNRESOLVED);
+		if (holder !== this.#shared && holder.abort.signal.aborted) throw new BrowserError(BROWSER_SERVER_UNRESOLVED, BROWSER_SERVER_UNRESOLVED + ": the holder ended during the call");
 		if (!result.success) {
 			if (this.#leases.get(holder) === lease && !context.signal.aborted) try {
 				await this.#race(this.#ping(lease.token.value), context.signal);
@@ -1487,9 +1441,9 @@ var BrowserMCPServer = class {
 			context.signal.throwIfAborted();
 			if (this.#leases.get(holder) !== lease) {
 				const loss = this.#departures.get(lease);
-				throw new BrowserError(this.#annotate(holder, describeBrowserServerLoss(BROWSER_SERVER_UNRESOLVED, loss?.cause, loss?.url), lease), BROWSER_SERVER_UNRESOLVED);
+				throw new BrowserError(BROWSER_SERVER_UNRESOLVED, this.#annotate(holder, describeBrowserServerLoss(BROWSER_SERVER_UNRESOLVED, loss?.cause, loss?.url), lease));
 			}
-			throw new BrowserError(this.#annotate(holder, result.error, lease));
+			throw new BrowserError("PROTOCOL", boundBrowserText(this.#annotate(holder, result.error, lease), BROWSER_TOOL_LIMIT, BROWSER_TOOL_CUT_FOOTER));
 		}
 		return typeof result.value === "string" ? this.#annotate(holder, result.value, lease) : result.value;
 	}
@@ -1503,6 +1457,10 @@ var BrowserMCPServer = class {
 		}
 		return [...notes, value].join("\n");
 	}
+	#notice(context) {
+		const entry = [...this.#leases].find(([, lease]) => lease.generation.context === context);
+		return entry === void 0 ? "" : this.#annotate(entry[0], "");
+	}
 	async #handshake(options) {
 		try {
 			await this.#race(this.#starting, options.signal);
@@ -1653,7 +1611,7 @@ var BrowserMCPServer = class {
 		if (this.#leases.get(holder) !== lease || this.#holders.get(holder.id) !== holder) return;
 		this.#departures.set(lease, {
 			cause,
-			url: lease.generation.toolset.view.url
+			url: lease.generation.toolset.redact(lease.generation.toolset.view.url)
 		});
 		if (holder === this.#shared) this.#unmirror();
 		this.#leases.delete(holder);
@@ -1795,6 +1753,7 @@ var BrowserMCPServer = class {
 			}
 			toolset = createBrowserToolset(page, {
 				context,
+				notes: this.#notice.bind(this, context),
 				journeys: {
 					store: createFileBrowserJourneyStore({ root: this.#root }),
 					runs: createFileBrowserRunStore({ root: this.#root }),
@@ -1814,7 +1773,7 @@ var BrowserMCPServer = class {
 		} catch (error) {
 			await toolset?.destroy().catch(this.#fault.bind(this));
 			await context?.close().catch((failure) => {
-				if (!this.#losses.has(slot) && slot.browser.status === "connected" && this.#closing === void 0 && !isCDPConnectionError(failure)) this.#fault(failure);
+				if (!this.#losses.has(slot) && slot.browser.status === "connected" && this.#closing === void 0 && !(isBrowserError(failure) && failure.code === "DISCONNECTED")) this.#fault(failure);
 			});
 			await rm(directory, {
 				recursive: true,
@@ -1824,7 +1783,8 @@ var BrowserMCPServer = class {
 		}
 	}
 	async #destroyRecord(slot) {
-		if (isCDPTimeoutError(this.#losses.get(slot)?.cause) && slot.browser.pid !== void 0) try {
+		const cause = this.#losses.get(slot)?.cause;
+		if (isBrowserError(cause) && cause.code === "TIMEOUT" && slot.browser.pid !== void 0) try {
 			process.kill(slot.browser.pid, "SIGKILL");
 		} catch (error) {
 			if (!isError(error) || !("code" in error) || error.code !== "ESRCH") this.#faults.add(error);
@@ -1849,7 +1809,7 @@ var BrowserMCPServer = class {
 	}
 	async #warm() {
 		if (this.#closing !== void 0) throw this.#ended();
-		if (this.#stranded !== void 0) throw new BrowserError(isError(this.#stranded) ? this.#stranded.message : String(this.#stranded), BROWSER_SERVER_TEARDOWN, isBrowserError(this.#stranded) ? this.#stranded.context : void 0);
+		if (this.#stranded !== void 0) throw new BrowserError(BROWSER_SERVER_TEARDOWN, isError(this.#stranded) ? this.#stranded.message : String(this.#stranded), isBrowserError(this.#stranded) ? this.#stranded.context : void 0);
 		const profile = join(this.#root, ".profiles", formatBrowserLockEntry(process.pid, randomUUID()));
 		let browser;
 		let slot;
@@ -1922,7 +1882,7 @@ var BrowserMCPServer = class {
 					const record = parseBrowserProfileRecord(await readFile(join(folder, BROWSER_SERVER_RECORD), "utf8"));
 					if (record === void 0) continue;
 					if (probeProcess(record.pid)) {
-						const transport = createCDPTransport({ url: record.endpoint });
+						const transport = createWebSocketCDPTransport({ url: record.endpoint });
 						const client = createCDPClient({ transport });
 						try {
 							this.#abort.signal.throwIfAborted();
@@ -1964,7 +1924,7 @@ var BrowserMCPServer = class {
 	}
 	#unavailable(cause) {
 		const message = describeBrowserServerLoss(BROWSER_SERVER_UNAVAILABLE, cause);
-		return new BrowserError(message.slice(BROWSER_SERVER_UNAVAILABLE.length + 2), BROWSER_SERVER_UNAVAILABLE);
+		return new BrowserError(BROWSER_SERVER_UNAVAILABLE, message.slice(BROWSER_SERVER_UNAVAILABLE.length + 2));
 	}
 	#issue() {
 		return `e${++this.#references}`;
@@ -1996,7 +1956,7 @@ var BrowserMCPServer = class {
 		tools.emitter.off("clear", mirrored.cleared);
 	}
 	#ended() {
-		return new BrowserError("the browser session ended", "BROWSER_TOOLSET_ENDED");
+		return new BrowserError("CLOSED", "the browser session ended", { subject: "toolset" });
 	}
 };
 //#endregion
@@ -2009,31 +1969,32 @@ var BrowserMCPServer = class {
 * const files = new FileBrowserStore({ root: directory })
 * files.validateName('check-ready')
 */
-var FileBrowserStore = class {
+var FileBrowserStore = class FileBrowserStore {
+	static #locks = /* @__PURE__ */ new Map();
 	#root;
 	#limit;
 	constructor(options) {
 		this.#limit = options.limit ?? 100;
-		if (!Number.isSafeInteger(this.#limit) || this.#limit < 1) throw new BrowserError("The listing cap must be a positive integer", "BROWSER_JOURNEY_ARGUMENT");
+		if (!Number.isSafeInteger(this.#limit) || this.#limit < 1) throw new BrowserError("ARGUMENT", "The listing cap must be a positive integer", { subject: "store" });
 		try {
 			this.#root = realpathSync(options.root);
 		} catch (error) {
-			if (error instanceof Error && "code" in error && error.code === "ENOENT") throw new BrowserError(`Missing root: ${options.root}`, "BROWSER_JOURNEY_PATH", { path: options.root });
+			if (error instanceof Error && "code" in error && error.code === "ENOENT") throw new BrowserError("STORE_PATH", `Missing root: ${options.root}`, { path: options.root });
 			throw this.translateError(options.root, error);
 		}
 	}
 	/** Checks a journey name before filesystem access. @param name - Journey name */
 	validateName(name) {
-		if (!BROWSER_JOURNEY_NAME_PATTERN.test(name)) throw new BrowserError(`Refused journey name: ${name}`, "BROWSER_JOURNEY_PATH");
+		if (!BROWSER_JOURNEY_NAME_PATTERN.test(name)) throw new BrowserError("STORE_PATH", `Refused journey name: ${name}`);
 	}
 	/** Checks a run id before filesystem access. @param id - Producer id */
 	validateId(id) {
-		if (!BROWSER_RUN_ID_PATTERN.test(id)) throw new BrowserError(`Refused run id: ${id}`, "BROWSER_JOURNEY_PATH");
+		if (!BROWSER_RUN_ID_PATTERN.test(id)) throw new BrowserError("STORE_PATH", `Refused run id: ${id}`);
 	}
 	/** Resolves a confined target. @param parts - Relative components @returns Absolute target */
 	resolvePath(...parts) {
 		const path = resolve(this.#root, ...parts);
-		if (path !== this.#root && !path.startsWith(this.#root.endsWith(sep) ? this.#root : this.#root + sep)) throw new BrowserError(`Refused path: ${path}`, "BROWSER_JOURNEY_PATH");
+		if (path !== this.#root && !path.startsWith(this.#root.endsWith(sep) ? this.#root : this.#root + sep)) throw new BrowserError("STORE_PATH", `Refused path: ${path}`);
 		return path;
 	}
 	/**
@@ -2051,8 +2012,8 @@ var FileBrowserStore = class {
 			try {
 				const status = await lstat(current);
 				options?.signal?.throwIfAborted();
-				if (status.isSymbolicLink()) throw new BrowserError(`Refused symbolic link: ${current}`, "BROWSER_JOURNEY_PATH");
-				if (index < parts.length && !status.isDirectory()) throw new BrowserError(`Not a directory: ${current}`, "BROWSER_JOURNEY_PATH");
+				if (status.isSymbolicLink()) throw new BrowserError("STORE_PATH", `Refused symbolic link: ${current}`);
+				if (index < parts.length && !status.isDirectory()) throw new BrowserError("STORE_PATH", `Not a directory: ${current}`);
 			} catch (error) {
 				options?.signal?.throwIfAborted();
 				if (error instanceof Error && "code" in error && error.code === "ENOENT") return false;
@@ -2066,7 +2027,7 @@ var FileBrowserStore = class {
 	/** Creates checked directories one component at a time. @param path - Directory @param options - Cancellation options */
 	async createDirectory(path, options) {
 		if (await this.check(path, options)) return;
-		if (path === this.#root) throw new BrowserError(`Missing root: ${path}`, "BROWSER_JOURNEY_PATH");
+		if (path === this.#root) throw new BrowserError("STORE_PATH", `Missing root: ${path}`);
 		await this.createDirectory(dirname(path), options);
 		options?.signal?.throwIfAborted();
 		try {
@@ -2116,7 +2077,7 @@ var FileBrowserStore = class {
 				await rename(temporary, path);
 			} catch (error) {
 				const target = await lstat(path).catch(() => void 0);
-				if (error instanceof Error && "code" in error && (error.code === "EISDIR" || error.code === "EPERM") && target?.isDirectory()) throw new BrowserError(`Cannot replace directory: ${path}`, "BROWSER_JOURNEY_FILE", { path });
+				if (error instanceof Error && "code" in error && (error.code === "EISDIR" || error.code === "EPERM") && target?.isDirectory()) throw new BrowserError("STORE_FILE", `Cannot replace directory: ${path}`, { path });
 				throw error;
 			}
 			owned = false;
@@ -2147,6 +2108,20 @@ var FileBrowserStore = class {
 	* @returns The mutation result
 	*/
 	async lock(path, action, options) {
+		const key = this.resolvePath(path);
+		const previous = FileBrowserStore.#locks.get(key);
+		const released = Promise.withResolvers();
+		FileBrowserStore.#locks.set(key, released.promise);
+		try {
+			await previous;
+			options?.signal?.throwIfAborted();
+			return await this.#lockFile(key, action, options);
+		} finally {
+			released.resolve();
+			if (FileBrowserStore.#locks.get(key) === released.promise) FileBrowserStore.#locks.delete(key);
+		}
+	}
+	async #lockFile(path, action, options) {
 		await this.createDirectory(dirname(path), options);
 		const name = formatBrowserLockEntry(process.pid, randomUUID());
 		const entry = this.resolvePath(path, name);
@@ -2189,7 +2164,7 @@ var FileBrowserStore = class {
 				await this.#removeLock(path);
 			}
 		}
-		throw new BrowserError(`Journey is locked: ${path}`, "BROWSER_JOURNEY_LOCKED");
+		throw new BrowserError("STORE_LOCKED", `Journey is locked: ${path}`);
 	}
 	/**
 	* Lists readable entries in sorted order with a bounded page and one extra readable probe.
@@ -2236,7 +2211,7 @@ var FileBrowserStore = class {
 				const reason = error instanceof BrowserError ? error.context?.["reason"] : void 0;
 				faults.push({
 					name,
-					reason: typeof reason === "string" ? reason : error instanceof BrowserError && error.code === "BROWSER_JOURNEY_PATH" ? "The entry path is refused" : error instanceof BrowserError && error.code === "BROWSER_JOURNEY_ACCESS" ? "Permission denied" : error instanceof BrowserError && error.code === "BROWSER_JOURNEY_FORMAT" ? "Unknown file format" : "The stored entry is malformed or unreadable"
+					reason: typeof reason === "string" ? reason : error instanceof BrowserError && error.code === "STORE_PATH" ? "The entry path is refused" : error instanceof BrowserError && error.code === "STORE_ACCESS" ? "Permission denied" : error instanceof BrowserError && error.code === "STORE_FORMAT" ? "Unknown file format" : "The stored entry is malformed or unreadable"
 				});
 			}
 		}
@@ -2279,7 +2254,7 @@ var FileBrowserStore = class {
 	/** Translates filesystem and validation failures with their path. @param path - Failed path @param error - Cause @returns Coded error */
 	translateError(path, error) {
 		const code = error instanceof Error && "code" in error ? error.code : void 0;
-		return new BrowserError(`${path}: ${error instanceof Error ? error.message : String(error)}`, code === "EACCES" || code === "EPERM" ? "BROWSER_JOURNEY_ACCESS" : error instanceof BrowserError && code !== "BROWSER_JOURNEY_INVALID" ? error.code : "BROWSER_JOURNEY_FILE", { path });
+		return new BrowserError(code === "EACCES" || code === "EPERM" ? "STORE_ACCESS" : error instanceof BrowserError && code !== "JOURNEY_INVALID" ? error.code : "STORE_FILE", `${path}: ${error instanceof Error ? error.message : String(error)}`, { path });
 	}
 	async #readLock(path, options) {
 		await this.check(path, options);
@@ -2287,13 +2262,13 @@ var FileBrowserStore = class {
 			const entries = await readdir(path, { withFileTypes: true });
 			for (const entry of entries) {
 				await this.check(this.resolvePath(path, entry.name), options);
-				if (!entry.isFile()) throw new BrowserError(`Journey is locked: ${path}`, "BROWSER_JOURNEY_LOCKED");
+				if (!entry.isFile()) throw new BrowserError("STORE_LOCKED", `Journey is locked: ${path}`);
 			}
 			return entries.map((entry) => entry.name);
 		} catch (error) {
 			if (error instanceof Error && "code" in error) {
 				if (error.code === "ENOENT") return void 0;
-				if (error.code === "ENOTDIR") throw new BrowserError(`Journey is locked: ${path}`, "BROWSER_JOURNEY_LOCKED");
+				if (error.code === "ENOTDIR") throw new BrowserError("STORE_LOCKED", `Journey is locked: ${path}`);
 			}
 			throw this.translateError(path, error);
 		}
@@ -2305,7 +2280,7 @@ var FileBrowserStore = class {
 			return true;
 		} catch (error) {
 			if (error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTEMPTY")) return false;
-			throw new BrowserError(`Cannot remove lock entry: ${path}`, "BROWSER_JOURNEY_ACCESS", { path });
+			throw new BrowserError("STORE_ACCESS", `Cannot remove lock entry: ${path}`, { path });
 		}
 	}
 	async #removeLock(path) {
@@ -2321,7 +2296,7 @@ var FileBrowserStore = class {
 					if (cause instanceof Error && "code" in cause && cause.code === "ENOENT") return;
 				}
 			}
-			throw new BrowserError(`Cannot remove lock directory: ${path}`, "BROWSER_JOURNEY_ACCESS", { path });
+			throw new BrowserError("STORE_ACCESS", `Cannot remove lock directory: ${path}`, { path });
 		}
 	}
 };
@@ -2347,24 +2322,29 @@ var FileBrowserJourneyStore = class {
 		if (source === void 0) return void 0;
 		try {
 			const value = parseJSON(source);
-			if (!isRecord(value) || typeof value["revision"] !== "number" || !Number.isSafeInteger(value["revision"]) || value["revision"] < 1) throw new BrowserError("Malformed journey revision", "BROWSER_JOURNEY_FILE");
-			if (!isRecord(value["journey"]) || !("format" in value["journey"])) throw new BrowserError("Missing journey format", "BROWSER_JOURNEY_FILE");
+			if (!isRecord(value) || typeof value["revision"] !== "number" || !Number.isSafeInteger(value["revision"]) || value["revision"] < 1) throw new BrowserError("STORE_FILE", "Malformed journey revision");
+			if (!isRecord(value["journey"]) || !("format" in value["journey"])) throw new BrowserError("STORE_FILE", "Missing journey format");
 			validateBrowserJourney(value["journey"]);
-			if (value["journey"].name !== name) throw new BrowserError("Journey name differs from its directory", "BROWSER_JOURNEY_FILE");
+			if (value["journey"].name !== name) throw new BrowserError("STORE_FILE", "Journey name differs from its directory");
 			return {
 				journey: value["journey"],
 				revision: value["revision"]
 			};
 		} catch (error) {
 			const translated = this.#files.translateError(path, error);
-			throw new BrowserError(translated.message, translated.code, {
+			throw new BrowserError(translated.code, translated.message, {
 				...translated.context,
 				reason: normalizeBrowserJourneyReason(error)
 			});
 		}
 	}
-	async set(journey, expected, options) {
+	async set(journey, options) {
 		options?.signal?.throwIfAborted();
+		validateBrowserJourneyWriteOptions(options);
+		const condition = {
+			revision: options?.revision,
+			exclusive: options?.exclusive
+		};
 		this.#files.validateName(journey.name);
 		validateBrowserJourney(journey);
 		const owned = structuredClone(journey);
@@ -2372,12 +2352,12 @@ var FileBrowserJourneyStore = class {
 		const counter = this.#files.resolvePath(owned.name, BROWSER_JOURNEY_REVISION_FILE);
 		return this.#files.lock(this.#files.resolvePath(owned.name, BROWSER_JOURNEY_LOCK_DIRECTORY), async () => {
 			const current = await this.get(owned.name, options);
-			if (expected !== void 0 && expected !== (current?.revision ?? 0)) throw new BrowserError(`Journey ${owned.name} changed since you read it`, "BROWSER_JOURNEY_STALE");
+			if (condition.exclusive === true && current !== void 0 || condition.revision !== void 0 && condition.revision !== current?.revision) throw new BrowserError("JOURNEY_STALE", `Journey ${owned.name} changed since you read it`);
 			const source = await this.#files.read(counter, options);
 			const previous = source === void 0 ? 0 : Number(source);
-			if (!Number.isSafeInteger(previous) || previous < 0 || source?.trim() === "") throw new BrowserError(`Malformed revision: ${counter}`, "BROWSER_JOURNEY_FILE");
+			if (!Number.isSafeInteger(previous) || previous < 0 || source?.trim() === "") throw new BrowserError("STORE_FILE", `Malformed revision: ${counter}`);
 			const revision = Math.max(previous, current?.revision ?? 0) + 1;
-			if (!Number.isSafeInteger(revision)) throw new BrowserError(`Exhausted revision: ${counter}`, "BROWSER_JOURNEY_FILE");
+			if (!Number.isSafeInteger(revision)) throw new BrowserError("STORE_FILE", `Exhausted revision: ${counter}`);
 			const saved = {
 				journey: owned,
 				revision
@@ -2402,7 +2382,7 @@ var FileBrowserJourneyStore = class {
 			const counter = this.#files.resolvePath(name, BROWSER_JOURNEY_REVISION_FILE);
 			const source = await this.#files.read(counter, options);
 			const previous = source === void 0 ? 0 : Number(source);
-			if (!Number.isSafeInteger(previous) || previous < 0 || source?.trim() === "") throw new BrowserError(`Malformed revision: ${counter}`, "BROWSER_JOURNEY_FILE");
+			if (!Number.isSafeInteger(previous) || previous < 0 || source?.trim() === "") throw new BrowserError("STORE_FILE", `Malformed revision: ${counter}`);
 			await this.#files.write(counter, String(Math.max(previous, current.revision ?? 0)), options);
 			await this.#files.remove(this.#files.resolvePath(name, BROWSER_JOURNEY_SNAPSHOT_FILE), options);
 		}, options);
@@ -2424,7 +2404,7 @@ var FileBrowserJourneyStore = class {
 * still refuses conflicting mutations and allocations from another process.
 * @example
 * const store = new FileBrowserRunStore({ root: directory })
-* const slot = await store.open('check-ready')
+* const slot = await store.create('check-ready')
 */
 var FileBrowserRunStore = class FileBrowserRunStore {
 	static #allocations = /* @__PURE__ */ new Map();
@@ -2434,7 +2414,7 @@ var FileBrowserRunStore = class FileBrowserRunStore {
 	constructor(options) {
 		this.#files = new FileBrowserStore(options);
 	}
-	async snapshot(bytes, options) {
+	async write(bytes, options) {
 		options?.signal?.throwIfAborted();
 		const owned = new Uint8Array(bytes);
 		const directory = await this.#files.allocate(this.#files.resolvePath(BROWSER_RUN_DIRECTORY), generateBrowserRunId, options);
@@ -2452,7 +2432,7 @@ var FileBrowserRunStore = class FileBrowserRunStore {
 			throw this.#files.translateError(path, error);
 		}
 	}
-	async open(name, options) {
+	async create(name, options) {
 		options?.signal?.throwIfAborted();
 		this.#files.validateName(name);
 		const path = this.#files.resolvePath(name, BROWSER_JOURNEY_LOCK_DIRECTORY);
@@ -2486,10 +2466,10 @@ var FileBrowserRunStore = class FileBrowserRunStore {
 		if (source === void 0) return void 0;
 		try {
 			const value = parseJSON(source);
-			if (!isRecord(value) || !("format" in value)) throw new BrowserError("Missing run format", "BROWSER_JOURNEY_FILE");
-			if (value["format"] === BROWSER_JOURNEY_FORMAT_VERSION && (!isRecord(value["journey"]) || !("format" in value["journey"]))) throw new BrowserError("Missing run journey format", "BROWSER_JOURNEY_FILE");
+			if (!isRecord(value) || !("format" in value)) throw new BrowserError("STORE_FILE", "Missing run format");
+			if (value["format"] === BROWSER_JOURNEY_FORMAT_VERSION && (!isRecord(value["journey"]) || !("format" in value["journey"]))) throw new BrowserError("STORE_FILE", "Missing run journey format");
 			validateBrowserRun(value);
-			if (value.id !== id || value.journey.name !== name) throw new BrowserError("Run identity differs from its directory", "BROWSER_JOURNEY_FILE");
+			if (value.id !== id || value.journey.name !== name) throw new BrowserError("STORE_FILE", "Run identity differs from its directory");
 			return value;
 		} catch (error) {
 			throw this.#files.translateError(path, error);
@@ -2508,7 +2488,7 @@ var FileBrowserRunStore = class FileBrowserRunStore {
 	async capture(slot, name, bytes, options) {
 		options?.signal?.throwIfAborted();
 		const directory = this.#slots.get(slot);
-		if (directory === void 0 || !/^s[1-9]\d*\.png$/.test(name)) throw new BrowserError("Capture requires an opened slot and an sN.png name", "BROWSER_JOURNEY_PATH");
+		if (directory === void 0 || !/^s[1-9]\d*\.png$/.test(name)) throw new BrowserError("STORE_PATH", "Capture requires an opened slot and an sN.png name");
 		const owned = new Uint8Array(bytes);
 		await this.#requireDirectory(directory, options);
 		await this.#files.write(this.#files.resolvePath(directory, name), owned, options);
@@ -2561,12 +2541,12 @@ var FileBrowserRunStore = class FileBrowserRunStore {
 		return this.#files.list(this.#files.resolvePath(name, BROWSER_RUN_DIRECTORY), (id) => this.get(name, id, options), options);
 	}
 	async #requireDirectory(directory, options) {
-		if (!this.#directories.has(directory) || !await this.#files.check(directory, options)) throw new BrowserError(`Run directory was not opened or is missing: ${directory}`, "BROWSER_JOURNEY_PATH");
+		if (!this.#directories.has(directory) || !await this.#files.check(directory, options)) throw new BrowserError("STORE_PATH", `Run directory was not opened or is missing: ${directory}`);
 		try {
 			options?.signal?.throwIfAborted();
 			const status = await lstat(directory);
 			options?.signal?.throwIfAborted();
-			if (!status.isDirectory()) throw new BrowserError(`Run directory is not a directory: ${directory}`, "BROWSER_JOURNEY_PATH");
+			if (!status.isDirectory()) throw new BrowserError("STORE_PATH", `Run directory is not a directory: ${directory}`);
 		} catch (error) {
 			options?.signal?.throwIfAborted();
 			throw this.#files.translateError(directory, error);
@@ -2603,7 +2583,7 @@ function createBrowser(options) {
 * @param options - The CDP WebSocket debugger URL (and optional timeout)
 * @returns A {@link CDPTransportInterface}
 */
-function createCDPTransport(options) {
+function createWebSocketCDPTransport(options) {
 	return new WebSocketCDPTransport(options);
 }
 /**
@@ -2612,7 +2592,7 @@ function createCDPTransport(options) {
 *
 * @returns A {@link BrowserWriterInterface} that persists bytes through `node:fs/promises`
 */
-function createBrowserWriter() {
+function createFileBrowserWriter() {
 	return new FileBrowserWriter();
 }
 /**
@@ -2646,7 +2626,7 @@ function createFileBrowserRunStore(options) {
 * ```ts
 * import { createBrowserMCPServer } from '@orkestrel/browser/server'
 *
-* const server = createBrowserMCPServer({ root: 'tmp/browsers', headless: true })
+* const server = createBrowserMCPServer({ root: 'tmp/browsers', browser: { headless: true } })
 * await server.start() // resolves after leasing a connected browser
 * await server.destroy()
 * ```
@@ -2701,7 +2681,7 @@ var Browser = class {
 			...options?.error !== void 0 ? { error: options.error } : {}
 		});
 		this.#options = options ?? {};
-		this.#engine = this.#options.engine ?? (this.#options.executable !== void 0 ? parseBrowserEngine(this.#options.executable) ?? "chromium" : "chromium");
+		this.#engine = this.#options.executable !== void 0 ? parseBrowserEngine(this.#options.executable) ?? "chromium" : this.#options.browsers?.engine ?? "chromium";
 		this.#cdpPort = this.#options.cdp?.port ?? 9222;
 		this.#cdpHost = this.#options.cdp?.host ?? "127.0.0.1";
 		queueMicrotask(() => this.#emitter.emit("idle"));
@@ -2728,9 +2708,9 @@ var Browser = class {
 		return this.#endpoint;
 	}
 	async ping(options) {
-		if (this.#destroyed) throw new BrowserDestroyedError();
+		if (this.#destroyed) throw new BrowserError("CLOSED", "Browser has been destroyed", { subject: "browser" });
 		const client = this.#client;
-		if (this.#status !== "connected" || client === void 0) throw new BrowserNotConnectedError();
+		if (this.#status !== "connected" || client === void 0) throw new BrowserError("DISCONNECTED", "Browser is not connected");
 		await client.send("Browser.getVersion", void 0, options);
 	}
 	async discover() {
@@ -2739,7 +2719,7 @@ var Browser = class {
 		return result;
 	}
 	async connect() {
-		if (this.#destroyed) throw new BrowserDestroyedError();
+		if (this.#destroyed) throw new BrowserError("CLOSED", "Browser has been destroyed", { subject: "browser" });
 		const active = this.#connecting.pending;
 		if (active !== void 0) {
 			await active;
@@ -2749,8 +2729,8 @@ var Browser = class {
 		await this.#connecting.execute(() => this.#establish());
 	}
 	adopt() {
-		if (this.#destroyed) throw new BrowserDestroyedError();
-		if (this.#status !== "connected" || this.#client === void 0 || this.#endpoint === void 0) throw new BrowserNotConnectedError();
+		if (this.#destroyed) throw new BrowserError("CLOSED", "Browser has been destroyed", { subject: "browser" });
+		if (this.#status !== "connected" || this.#client === void 0 || this.#endpoint === void 0) throw new BrowserError("DISCONNECTED", "Browser is not connected");
 		this.#owned = true;
 	}
 	async disconnect() {
@@ -2781,12 +2761,15 @@ var Browser = class {
 		}
 	}
 	async create(options) {
-		if (this.#destroyed) throw new BrowserDestroyedError();
+		if (this.#destroyed) throw new BrowserError("CLOSED", "Browser has been destroyed", { subject: "browser" });
 		const client = this.#client;
-		if (this.#status !== "connected" || client === void 0) throw new BrowserNotConnectedError();
+		if (this.#status !== "connected" || client === void 0) throw new BrowserError("DISCONNECTED", "Browser is not connected");
 		let context = this.#contexts[0];
 		if (context === void 0) {
-			context = new BrowserContext(client, void 0, this.#options.viewport, createBrowserWriter());
+			context = new BrowserContext(client, {
+				...this.#options.viewport === void 0 ? {} : { viewport: this.#options.viewport },
+				writer: createFileBrowserWriter()
+			});
 			this.#registerContext(context);
 		}
 		const page = await context.create(options);
@@ -2814,10 +2797,11 @@ var Browser = class {
 		return shutdown;
 	}
 	async #isolate(options) {
-		if (this.#destroyed) throw new BrowserDestroyedError();
+		if (this.#destroyed) throw new BrowserError("CLOSED", "Browser has been destroyed", { subject: "browser" });
 		const client = this.#client;
-		if (this.#status !== "connected" || client === void 0) throw new BrowserNotConnectedError();
+		if (this.#status !== "connected" || client === void 0) throw new BrowserError("DISCONNECTED", "Browser is not connected");
 		validateBrowserContextOptions(options);
+		if (options !== void 0 && "id" in options && options.id !== void 0) throw new BrowserError("ARGUMENT", "An isolated context receives its id from the browser");
 		const params = { disposeOnDetach: false };
 		if (options?.proxy !== void 0) {
 			params["proxyServer"] = options.proxy.server;
@@ -2825,18 +2809,25 @@ var Browser = class {
 		}
 		if (options?.origins !== void 0) params["originsWithUniversalNetworkAccess"] = [...options.origins];
 		const result = await client.send("Target.createBrowserContext", params);
-		if (!isRecord(result) || !isString(result["browserContextId"])) throw new BrowserConnectionError("Failed to create isolated browser context");
+		if (!isRecord(result) || !isString(result["browserContextId"])) throw new BrowserError("CONNECTION", "Failed to create isolated browser context");
 		const id = result["browserContextId"];
-		const context = new BrowserContext(client, id, options?.emulation?.viewport ?? this.#options.viewport, createBrowserWriter(), options?.emulation, options?.downloads, options);
+		const { proxy: _proxy, origins: _origins, ...defaults } = options ?? {};
+		const viewport = options?.viewport ?? options?.emulation?.viewport ?? this.#options.viewport;
+		const context = new BrowserContext(client, {
+			...defaults,
+			id,
+			...viewport === void 0 ? {} : { viewport },
+			writer: options?.writer ?? createFileBrowserWriter()
+		});
 		try {
-			if (this.#destroyed || this.#client !== client) throw new BrowserDestroyedError();
+			if (this.#destroyed || this.#client !== client) throw new BrowserError("CLOSED", "Browser has been destroyed", { subject: "browser" });
 			if (options?.downloads !== void 0) await client.send("Browser.setDownloadBehavior", {
 				behavior: options.downloads.named === true ? "allowAndName" : "allow",
 				browserContextId: id,
 				downloadPath: options.downloads.path,
 				eventsEnabled: true
 			});
-			if (this.#destroyed || this.#client !== client) throw new BrowserDestroyedError();
+			if (this.#destroyed || this.#client !== client) throw new BrowserError("CLOSED", "Browser has been destroyed", { subject: "browser" });
 		} catch (error) {
 			await context.close().catch(() => void 0);
 			throw error;
@@ -2848,7 +2839,7 @@ var Browser = class {
 		const disconnecting = this.#disconnecting.pending;
 		if (disconnecting !== void 0) await disconnecting;
 		await this.#settleExit();
-		if (this.#destroyed) throw new BrowserDestroyedError();
+		if (this.#destroyed) throw new BrowserError("CLOSED", "Browser has been destroyed", { subject: "browser" });
 		if (this.#status === "connected") return;
 		this.#assertNotAborted();
 		this.#status = "connecting";
@@ -2873,12 +2864,12 @@ var Browser = class {
 			this.#assertNotAborted();
 			await this.#launch();
 		} catch (error) {
-			if (this.#destroyed) throw new BrowserDestroyedError();
+			if (this.#destroyed) throw new BrowserError("CLOSED", "Browser has been destroyed", { subject: "browser" });
 			this.#status = "error";
 			this.#emitter.emit("error", error);
-			if (isBrowserConnectionError(error)) throw error;
+			if (isBrowserError(error) && error.code === "CONNECTION") throw error;
 			const message = isError(error) ? error.message : String(error);
-			throw new BrowserConnectionError(message, { executable: this.#options.executable });
+			throw new BrowserError("CONNECTION", message, this.#options.executable === void 0 ? void 0 : { executable: this.#options.executable });
 		}
 	}
 	async #detach() {
@@ -2899,7 +2890,7 @@ var Browser = class {
 		this.#emitter.emit("idle");
 	}
 	#assertNotAborted() {
-		if (this.#signal().aborted) throw new BrowserConnectionError("Connection aborted");
+		if (this.#signal().aborted) throw new BrowserError("CONNECTION", "Connection aborted");
 	}
 	#signal() {
 		const external = this.#options.signal;
@@ -2907,10 +2898,10 @@ var Browser = class {
 	}
 	async #raceAbort(promise) {
 		const signal = this.#signal();
-		if (signal.aborted) throw new BrowserConnectionError("Connection aborted");
+		if (signal.aborted) throw new BrowserError("CONNECTION", "Connection aborted");
 		const aborted = Promise.withResolvers();
 		const listener = addAbortListener(signal, () => {
-			aborted.reject(new BrowserConnectionError("Connection aborted"));
+			aborted.reject(new BrowserError("CONNECTION", "Connection aborted"));
 		});
 		try {
 			return await Promise.race([promise, aborted.promise]);
@@ -2938,7 +2929,7 @@ var Browser = class {
 		this.#owned = void 0;
 		this.#endpoint = void 0;
 		if (connected) this.#status = "disconnected";
-		this.#emitter.emit("error", new BrowserConnectionError("The browser process exited unexpectedly", { cause: BROWSER_PROCESS_EXIT_CAUSE }));
+		this.#emitter.emit("error", new BrowserError("CONNECTION", "The browser process exited unexpectedly", { cause: BROWSER_PROCESS_EXIT_CAUSE }));
 		if (connected) {
 			this.#emitter.emit("disconnect");
 			this.#emitter.emit("idle");
@@ -2976,7 +2967,7 @@ var Browser = class {
 		}
 		this.#destroyContextList(contexts);
 		this.#closeClient(client);
-		this.#emitter.emit("error", new BrowserConnectionError("The CDP transport connection was lost", { cause: BROWSER_TRANSPORT_LOSS_CAUSE }));
+		this.#emitter.emit("error", new BrowserError("CONNECTION", "The CDP transport connection was lost", { cause: BROWSER_TRANSPORT_LOSS_CAUSE }));
 		this.#emitter.emit("disconnect");
 		this.#emitter.emit("idle");
 	}
@@ -3029,7 +3020,7 @@ var Browser = class {
 		};
 	}
 	async #assertPortFree() {
-		if (await this.#probePort()) throw new BrowserConnectionError(`Port ${this.#cdpPort} on ${this.#cdpHost} is already occupied by another CDP endpoint`, {
+		if (await this.#probePort()) throw new BrowserError("CONNECTION", `Port ${this.#cdpPort} on ${this.#cdpHost} is already occupied by another CDP endpoint`, {
 			port: this.#cdpPort,
 			host: this.#cdpHost
 		});
@@ -3043,7 +3034,7 @@ var Browser = class {
 		}
 	}
 	async #connectCDP(endpoint) {
-		const transport = createCDPTransport({
+		const transport = createWebSocketCDPTransport({
 			url: endpoint,
 			timeout: this.#timeout()
 		});
@@ -3076,20 +3067,20 @@ var Browser = class {
 		}
 	}
 	async #launch() {
-		if (this.#process !== void 0) throw new BrowserConnectionError("A browser process is already active on this instance");
-		const requestedEngine = this.#options.engine ?? this.#options.browsers?.engine;
+		if (this.#process !== void 0) throw new BrowserError("CONNECTION", "A browser process is already active on this instance");
+		const requestedEngine = this.#options.browsers?.engine;
 		let executable = this.#options.executable;
 		let resolvedEngine;
 		if (executable !== void 0) resolvedEngine = parseBrowserEngine(executable) ?? "chromium";
 		else {
-			const found = findSystemBrowser({
+			const found = findSystemBrowsers({
 				...this.#options.browsers,
 				...requestedEngine !== void 0 ? { engine: requestedEngine } : {}
-			});
+			})[0];
 			executable = found?.executable;
 			resolvedEngine = found?.engine;
 		}
-		if (executable === void 0) throw new BrowserConnectionError("No Chromium browser found. Install Chrome, Edge, or Chromium.", requestedEngine === void 0 ? void 0 : { engine: requestedEngine });
+		if (executable === void 0) throw new BrowserError("CONNECTION", "No Chromium browser found. Install Chrome, Edge, or Chromium.", requestedEngine === void 0 ? void 0 : { engine: requestedEngine });
 		this.#engine = resolvedEngine ?? "chromium";
 		await this.#releaseProfile();
 		const profile = await createBrowserProfile(this.#options.profile);
@@ -3105,7 +3096,7 @@ var Browser = class {
 		let client;
 		try {
 			const endpoint = await this.#waitForLaunch(process, executable, this.#options.args);
-			const transport = createCDPTransport({
+			const transport = createWebSocketCDPTransport({
 				url: endpoint,
 				timeout: this.#timeout()
 			});
@@ -3169,9 +3160,9 @@ var Browser = class {
 		}
 		if (pid === void 0) {
 			await this.#closeRemote(client);
-			throw new BrowserConnectionError("The browser launcher exited without naming the process serving its CDP endpoint", {
-				executable: this.#options.executable,
-				pid: process.pid
+			throw new BrowserError("CONNECTION", "The browser launcher exited without naming the process serving its CDP endpoint", {
+				...this.#options.executable === void 0 ? {} : { executable: this.#options.executable },
+				...process.pid === void 0 ? {} : { pid: process.pid }
 			});
 		}
 		this.#servingPid = pid;
@@ -3179,7 +3170,7 @@ var Browser = class {
 	async #waitForLaunch(process, executable, args) {
 		const context = {
 			executable,
-			args
+			...args === void 0 ? {} : { args }
 		};
 		const timeout = this.#timeout();
 		const controller = new AbortController();
@@ -3190,32 +3181,32 @@ var Browser = class {
 			deadline
 		]);
 		const stderr = process.stderr;
-		if (stderr === null) throw new BrowserConnectionError("The browser process has no standard error to read", context);
+		if (stderr === null) throw new BrowserError("CONNECTION", "The browser process has no standard error to read", context);
 		const exit = once(process, "exit", { signal });
 		exit.catch(() => void 0);
 		const ready = readBrowserEndpoint(stderr, signal).catch(async (error) => {
 			if (signal.aborted) throw error;
 			const values = await exit;
 			if (values[0] === 0 && values[1] === null) throw error;
-			throw new BrowserConnectionError(this.#formatLaunchExit(isInteger(values[0]) ? values[0] : null, isString(values[1]) ? values[1] : null), context);
+			throw new BrowserError("CONNECTION", this.#formatLaunchExit(isInteger(values[0]) ? values[0] : null, isString(values[1]) ? values[1] : null), context);
 		});
 		const exited = exit.then((values) => {
 			const code = isInteger(values[0]) ? values[0] : null;
 			const exitSignal = isString(values[1]) ? values[1] : null;
 			if (code === 0 && exitSignal === null) return ready;
-			throw new BrowserConnectionError(this.#formatLaunchExit(code, exitSignal), context);
+			throw new BrowserError("CONNECTION", this.#formatLaunchExit(code, exitSignal), context);
 		});
 		try {
 			return await Promise.race([ready, exited]);
 		} catch (error) {
-			if (isBrowserConnectionError(error)) throw error;
-			if (this.#signal().aborted) throw new BrowserConnectionError("Connection aborted", context);
-			if (deadline.aborted) throw new BrowserConnectionError(`Browser did not report a CDP endpoint within ${timeout}ms`, {
+			if (isBrowserError(error) && error.code === "CONNECTION") throw error;
+			if (this.#signal().aborted) throw new BrowserError("CONNECTION", "Connection aborted", context);
+			if (deadline.aborted) throw new BrowserError("CONNECTION", `Browser did not report a CDP endpoint within ${timeout}ms`, {
 				...context,
 				timeout
 			});
 			const message = isError(error) ? error.message : String(error);
-			throw new BrowserConnectionError(message, context);
+			throw new BrowserError("CONNECTION", message, context);
 		} finally {
 			controller.abort();
 			ready.catch(() => void 0);
@@ -3252,7 +3243,10 @@ var Browser = class {
 			});
 		}
 		if (pages.length === 0 || this.#contexts.length > 0) return;
-		const context = new BrowserContext(client, void 0, this.#options.viewport, createBrowserWriter());
+		const context = new BrowserContext(client, {
+			...this.#options.viewport === void 0 ? {} : { viewport: this.#options.viewport },
+			writer: createFileBrowserWriter()
+		});
 		await context.sync(pages);
 		this.#registerContext(context);
 	}
@@ -3332,7 +3326,7 @@ var Browser = class {
 		let remote = client;
 		let temporary = false;
 		if (remote === void 0 && this.#owned === true && this.#endpoint !== void 0) {
-			const transport = createCDPTransport({
+			const transport = createWebSocketCDPTransport({
 				url: this.#endpoint,
 				timeout: this.#timeout()
 			});
@@ -3435,10 +3429,11 @@ var Browser = class {
 			const code = isError(error) && "code" in error && isString(error.code) ? error.code : void 0;
 			if (code === "ESRCH") return false;
 			if (signal === 0) return code === "EPERM" ? true : void 0;
-			throw new BrowserConnectionError("Failed to signal the browser process", {
-				pid: serving ?? pid,
+			const target = serving ?? pid;
+			throw new BrowserError("CONNECTION", "Failed to signal the browser process", {
+				...target === void 0 ? {} : { pid: target },
 				signal,
-				cause: error
+				cause: isJSONValue(error) ? error : String(error)
 			});
 		}
 	}
@@ -3477,7 +3472,8 @@ var Browser = class {
 			if (await this.#waitForTerminationWithin(process, 3e3)) return;
 			if (this.#signalProcess(process, "SIGKILL") === false) return;
 			if (await this.#waitForTerminationWithin(process, 3e3, true)) return;
-			throw new BrowserConnectionError("Browser process did not exit after SIGKILL", { pid: this.#servingPid ?? process.pid });
+			const target = this.#servingPid ?? process.pid;
+			throw new BrowserError("CONNECTION", "Browser process did not exit after SIGKILL", { ...target === void 0 ? {} : { pid: target } });
 		} finally {
 			await this.#closeProcessPipe(process);
 		}
@@ -3506,6 +3502,6 @@ var Browser = class {
 	}
 };
 //#endregion
-export { BROWSER_CDP_LIST_PATH, BROWSER_CDP_PROTOCOL, BROWSER_CDP_VERSION_PATH, BROWSER_DEFAULT_CDP_PORT, BROWSER_DEFAULT_HOST, BROWSER_DEVTOOLS_PATTERN, BROWSER_DRAIN_INTERVAL_MS, BROWSER_ENGINE_HINTS, BROWSER_ENV_PATH_KEYS, BROWSER_EXECUTABLE_NAMES, BROWSER_EXECUTABLE_PATHS, BROWSER_FILE_STORE_LIMIT, BROWSER_HEADLESS_ARG, BROWSER_JOURNEY_LOCK_ATTEMPTS, BROWSER_JOURNEY_LOCK_DIRECTORY, BROWSER_JOURNEY_REVISION_FILE, BROWSER_JOURNEY_SNAPSHOT_FILE, BROWSER_KILL_GRACE_MS, BROWSER_LAUNCH_ARGS, BROWSER_PORT_PROBE_TIMEOUT_MS, BROWSER_PROCESS_EXIT_CAUSE, BROWSER_PROFILE_PREFIX, BROWSER_RUN_DIRECTORY, BROWSER_RUN_FILE, BROWSER_SERVER_BUSY, BROWSER_SERVER_CONTEXTS, BROWSER_SERVER_CONTEXTS_LIMIT, BROWSER_SERVER_COPY, BROWSER_SERVER_CRASH, BROWSER_SERVER_EXHAUSTED, BROWSER_SERVER_HOLDER, BROWSER_SERVER_LAUNCH, BROWSER_SERVER_OPTIONS, BROWSER_SERVER_POOL_LIMIT, BROWSER_SERVER_POOL_SIZE, BROWSER_SERVER_RECORD, BROWSER_SERVER_RESTARTS, BROWSER_SERVER_SWEEP, BROWSER_SERVER_TEARDOWN, BROWSER_SERVER_UNAVAILABLE, BROWSER_SERVER_UNRESOLVED, BROWSER_STORE_CACHE_DIRS, BROWSER_STORE_DEFAULT_DIRS, BROWSER_STORE_ENV_KEY, BROWSER_STORE_GLOBS, BROWSER_STORE_LINK_NAME, BROWSER_TRANSPORT_LOSS_CAUSE, BROWSER_TRANSPORT_LOSS_DEFER_MS, BROWSER_WINDOWS_ROOT_FALLBACKS, BROWSER_WINDOWS_SUFFIXES, Browser, BrowserDestroyedError, BrowserMCPServer, BrowserNotConnectedError, FileBrowserJourneyStore, FileBrowserRunStore, FileBrowserWriter, WebSocketCDPTransport, browserToEngine, buildInstallPaths, buildStoreBases, buildWindowsRoots, createBrowser, createBrowserMCPServer, createBrowserProfile, createBrowserWriter, createCDPTransport, createFileBrowserJourneyStore, createFileBrowserRunStore, describeBrowserServerLoss, fetchCDPTargets, findEnvOverrides, findInstallPaths, findStorePaths, findSystemBrowser, findSystemBrowsers, formatBrowserLockEntry, isBrowserDestroyedError, isBrowserNotConnectedError, launchBrowserProcess, normalizeExecutablePath, parseBrowserEngine, parseBrowserLockEntry, parseBrowserProfileRecord, parseBrowserViewport, probePathNames, probeProcess, readBrowserEndpoint, readFirstLine, removeBrowserProfile };
+export { BROWSER_CDP_LIST_PATH, BROWSER_CDP_PROTOCOL, BROWSER_CDP_VERSION_PATH, BROWSER_DEFAULT_CDP_PORT, BROWSER_DEFAULT_HOST, BROWSER_DEVTOOLS_PATTERN, BROWSER_DRAIN_INTERVAL_MS, BROWSER_ENGINE_HINTS, BROWSER_ENV_PATH_KEYS, BROWSER_EXECUTABLE_NAMES, BROWSER_EXECUTABLE_PATHS, BROWSER_FILE_STORE_LIMIT, BROWSER_HEADLESS_ARG, BROWSER_JOURNEY_LOCK_ATTEMPTS, BROWSER_JOURNEY_LOCK_DIRECTORY, BROWSER_JOURNEY_REVISION_FILE, BROWSER_JOURNEY_SNAPSHOT_FILE, BROWSER_KILL_GRACE_MS, BROWSER_LAUNCH_ARGS, BROWSER_PORT_PROBE_TIMEOUT_MS, BROWSER_PROCESS_EXIT_CAUSE, BROWSER_PROFILE_PREFIX, BROWSER_RUN_DIRECTORY, BROWSER_RUN_FILE, BROWSER_SERVER_BUSY, BROWSER_SERVER_CONTEXTS, BROWSER_SERVER_CONTEXTS_LIMIT, BROWSER_SERVER_COPY, BROWSER_SERVER_CRASH, BROWSER_SERVER_EXHAUSTED, BROWSER_SERVER_HOLDER, BROWSER_SERVER_LAUNCH, BROWSER_SERVER_OPTIONS, BROWSER_SERVER_POOL_LIMIT, BROWSER_SERVER_POOL_SIZE, BROWSER_SERVER_RECORD, BROWSER_SERVER_RESTARTS, BROWSER_SERVER_SWEEP, BROWSER_SERVER_TEARDOWN, BROWSER_SERVER_UNAVAILABLE, BROWSER_SERVER_UNRESOLVED, BROWSER_STORE_CACHE_DIRS, BROWSER_STORE_DEFAULT_DIRS, BROWSER_STORE_ENV_KEY, BROWSER_STORE_GLOBS, BROWSER_STORE_LINK_NAME, BROWSER_TRANSPORT_LOSS_CAUSE, BROWSER_TRANSPORT_LOSS_DEFER_MS, BROWSER_WINDOWS_ROOT_FALLBACKS, BROWSER_WINDOWS_SUFFIXES, Browser, BrowserMCPServer, FileBrowserJourneyStore, FileBrowserRunStore, FileBrowserWriter, WebSocketCDPTransport, browserToEngine, buildInstallPaths, buildStoreBases, buildWindowsRoots, createBrowser, createBrowserMCPServer, createBrowserProfile, createFileBrowserJourneyStore, createFileBrowserRunStore, createFileBrowserWriter, createWebSocketCDPTransport, describeBrowserServerLoss, fetchCDPTargets, findEnvOverrides, findInstallPaths, findStorePaths, findSystemBrowsers, formatBrowserLockEntry, launchBrowserProcess, normalizeExecutablePath, parseBrowserEngine, parseBrowserLockEntry, parseBrowserProfileRecord, parseBrowserViewport, probePathNames, probeProcess, readBrowserEndpoint, readFirstLine, removeBrowserProfile };
 
 //# sourceMappingURL=index.js.map