@orkestrel/browser 0.0.23 → 0.0.25

package/dist/src/core/index.d.cts

@@ -107,7 +107,7 @@ export declare const BROWSER_FRAME_WORLD_NAME = "__orkestrelBrowserFrame";
  */
 export declare const BROWSER_HAR_CREATOR: Readonly<{
     name: "@orkestrel/browser";
-    version: "0.0.23";
+    version: "0.0.25";
 }>;
 
 /** Names accessibility roles that receive actionable outline references. */
@@ -159,7 +159,7 @@ export declare const BROWSER_JOURNEY_STEP_KEYS: readonly string[];
 
 /**
  * Names the journey tools a toolset constructed with `journeys` registers and reserves: `record`,
- * `save`, `journeys`, `edit`, `replay`, and `forget`.
+ * `save`, `journeys`, `edit`, `replay`, `forget`, and `capture`.
  */
 export declare const BROWSER_JOURNEY_TOOL_NAMES: readonly BrowserToolName[];
 
@@ -711,6 +711,7 @@ export declare class BrowserContext implements BrowserContextInterface {
     constructor(client: CDPClientInterface, id?: string, viewport?: BrowserViewport, writer?: BrowserWriterInterface, emulation?: BrowserEmulationOptions, downloads?: BrowserDownloadOptions, options?: BrowserContextOptions);
     get emitter(): EmitterInterface<BrowserContextEventMap>;
     get id(): string | undefined;
+    get disposal(): BrowserContextDisposal | undefined;
     get cookies(): BrowserCookieManagerInterface;
     get permissions(): BrowserPermissionManagerInterface;
     get storage(): BrowserStorageManagerInterface;
@@ -723,6 +724,14 @@ export declare class BrowserContext implements BrowserContextInterface {
     close(): Promise<void>;
 }
 
+/** Records Chromium's disposal acknowledgement or the failure that left disposal unconfirmed. */
+export declare type BrowserContextDisposal = {
+    readonly confirmed: true;
+} | {
+    readonly confirmed: false;
+    readonly error: unknown;
+};
+
 /** Maps the browser-context lifecycle events. */
 export declare type BrowserContextEventMap = {
     readonly page: readonly [page: BrowserPageInterface];
@@ -746,6 +755,8 @@ export declare type BrowserContextEventMap = {
 export declare interface BrowserContextInterface {
     readonly emitter: EmitterInterface<BrowserContextEventMap>;
     readonly id: string | undefined;
+    /** Holds the remote disposal receipt after `close()` attempts disposal; wrapper destruction has none. */
+    readonly disposal: BrowserContextDisposal | undefined;
     readonly cookies: BrowserCookieManagerInterface;
     readonly permissions: BrowserPermissionManagerInterface;
     readonly storage: BrowserStorageManagerInterface;
@@ -1801,7 +1812,7 @@ export declare type BrowserJourneyEditRequest = BrowserJourneyEdit | {
  *
  * @remarks
  * - `store` — keeps the journeys the tools record, list, edit, and replay
- * - `runs` — keeps each replay's run; omitting it writes no run
+ * - `runs` — keeps each replay's run and saves standalone images when it provides `snapshot`
  * - `limit` — positive integer listing cap in characters; Default: the owner's `limit`, including direct construction
  * - `readonly` — if `true`, refuses `record`, `save`, `edit`, and `forget` before any store access, and
  *   `replay` still writes runs; if `false` or omitted, every tool runs
@@ -1930,13 +1941,13 @@ export declare interface BrowserJourneyTarget {
 }
 
 /**
- * Registers the journey tools `record`, `save`, `journeys`, `edit`, `replay`, and `forget` over a toolset
+ * Registers the journey tools `record`, `save`, `journeys`, `edit`, `replay`, `forget`, and `capture` over a toolset
  * and owns the recording and the active replay.
  *
  * @remarks
  * The journey toolset composes the toolset's public members: `perform` reads the view a receipt
  * carries through `look`, `hold` and `emitter` drive the recorder and the replay, `view` converts
- * an edit's `ref` to a target, and `tools` receives the six tools at construction, which refuses
+ * an edit's `ref` to a target, and `tools` receives the journey tools at construction, which refuses
  * with `BROWSER_TOOLSET_RESERVED` when the manager already holds one of the names. Every refusal
  * is a sentence that names the next call, and a reason inside it is a clause without a directive
  * or a final period.
@@ -1952,7 +1963,7 @@ export declare interface BrowserJourneyTarget {
  * by the view after the run.
  *
  * `destroy()` aborts the active replay and waits for it to finish, stops a recording without
- * saving it, and removes the six tools the manager still holds under the instances it added.
+ * saving it, and removes the journey tools the manager still holds under the instances it added.
  *
  * @example
  * ```ts
@@ -1972,7 +1983,7 @@ export declare class BrowserJourneyToolset implements BrowserJourneyToolsetInter
 }
 
 /**
- * Registers the six journey tools over a toolset and owns the recording and the active replay.
+ * Registers the journey tools over a toolset and owns the recording and the active replay.
  *
  * @remarks
  * - `recording` — the name of the journey being recorded, or `undefined` when none is
@@ -1981,7 +1992,7 @@ export declare class BrowserJourneyToolset implements BrowserJourneyToolsetInter
 export declare interface BrowserJourneyToolsetInterface {
     readonly recording: string | undefined;
     readonly replaying: string | undefined;
-    /** Aborts the active replay and removes the six journey tools from the manager. */
+    /** Aborts the active replay and removes the journey tools from the manager. */
     destroy(): Promise<void>;
 }
 
@@ -3483,6 +3494,14 @@ export declare interface BrowserRunStep {
 
 /** Keeps runs by the journey name and run id the run carries. */
 export declare interface BrowserRunStoreInterface {
+    /**
+     * Saves a standalone PNG under the runs root without replacing an existing file.
+     * @param bytes - PNG bytes to persist
+     * @param options - Cancellation options
+     * @returns Absolute path of the saved image
+     * @remarks Stores without standalone file storage omit this capability.
+     */
+    snapshot?(bytes: Uint8Array, options?: BrowserStoreOptions): Promise<string>;
     /** Mints a run id for the journey and creates its run directory exclusively. */
     open(name: string, options?: BrowserStoreOptions): Promise<BrowserRunSlot>;
     /** Returns the run stored under the journey name and id, or `undefined` when none is stored. */
@@ -3967,9 +3986,9 @@ export declare interface BrowserRunStoreInterface {
     /**
      * Names a tool the browser toolset reserves: the generic tools, the staged `dialog`, the
      * opt-in `tabs` and `switch`, and the journey tools `record`, `save`, `journeys`, `edit`,
-     * `replay`, and `forget`, which a toolset constructed with `journeys` reserves.
+     * `replay`, `forget`, and `capture`, which a toolset constructed with `journeys` reserves.
      */
-    export declare type BrowserToolName = 'look' | 'read' | 'plain' | 'click' | 'type' | 'press' | 'navigate' | 'wait' | 'dialog' | 'tabs' | 'switch' | 'record' | 'save' | 'journeys' | 'edit' | 'replay' | 'forget';
+    export declare type BrowserToolName = 'look' | 'read' | 'plain' | 'click' | 'type' | 'press' | 'navigate' | 'wait' | 'dialog' | 'tabs' | 'switch' | 'record' | 'save' | 'journeys' | 'edit' | 'replay' | 'forget' | 'capture';
 
     /** Identifies a removed WebMCP tool by document and name. */
     export declare interface BrowserToolRemoval {
@@ -4753,9 +4772,7 @@ export declare interface BrowserRunStoreInterface {
     }
 
     /**
-     * Reports that a CDP request could not be sent or completed because the client was not in a
-     * connectable state — not connected, closed while connecting, or the connection dropped
-     * mid-request — under the code `BROWSER_CDP_CONNECTION_ERROR`.
+     * Reports that a CDP request could not be sent or completed because the client was not connected, closed while connecting, lost its connection, or lost the request's target session, under the code `BROWSER_CDP_CONNECTION_ERROR`.
      */
     export declare class CDPConnectionError extends BrowserError {
         constructor(message: string, context?: Readonly<Record<string, unknown>>);

package/dist/src/core/index.d.ts

@@ -107,7 +107,7 @@ export declare const BROWSER_FRAME_WORLD_NAME = "__orkestrelBrowserFrame";
  */
 export declare const BROWSER_HAR_CREATOR: Readonly<{
     name: "@orkestrel/browser";
-    version: "0.0.23";
+    version: "0.0.25";
 }>;
 
 /** Names accessibility roles that receive actionable outline references. */
@@ -159,7 +159,7 @@ export declare const BROWSER_JOURNEY_STEP_KEYS: readonly string[];
 
 /**
  * Names the journey tools a toolset constructed with `journeys` registers and reserves: `record`,
- * `save`, `journeys`, `edit`, `replay`, and `forget`.
+ * `save`, `journeys`, `edit`, `replay`, `forget`, and `capture`.
  */
 export declare const BROWSER_JOURNEY_TOOL_NAMES: readonly BrowserToolName[];
 
@@ -711,6 +711,7 @@ export declare class BrowserContext implements BrowserContextInterface {
     constructor(client: CDPClientInterface, id?: string, viewport?: BrowserViewport, writer?: BrowserWriterInterface, emulation?: BrowserEmulationOptions, downloads?: BrowserDownloadOptions, options?: BrowserContextOptions);
     get emitter(): EmitterInterface<BrowserContextEventMap>;
     get id(): string | undefined;
+    get disposal(): BrowserContextDisposal | undefined;
     get cookies(): BrowserCookieManagerInterface;
     get permissions(): BrowserPermissionManagerInterface;
     get storage(): BrowserStorageManagerInterface;
@@ -723,6 +724,14 @@ export declare class BrowserContext implements BrowserContextInterface {
     close(): Promise<void>;
 }
 
+/** Records Chromium's disposal acknowledgement or the failure that left disposal unconfirmed. */
+export declare type BrowserContextDisposal = {
+    readonly confirmed: true;
+} | {
+    readonly confirmed: false;
+    readonly error: unknown;
+};
+
 /** Maps the browser-context lifecycle events. */
 export declare type BrowserContextEventMap = {
     readonly page: readonly [page: BrowserPageInterface];
@@ -746,6 +755,8 @@ export declare type BrowserContextEventMap = {
 export declare interface BrowserContextInterface {
     readonly emitter: EmitterInterface<BrowserContextEventMap>;
     readonly id: string | undefined;
+    /** Holds the remote disposal receipt after `close()` attempts disposal; wrapper destruction has none. */
+    readonly disposal: BrowserContextDisposal | undefined;
     readonly cookies: BrowserCookieManagerInterface;
     readonly permissions: BrowserPermissionManagerInterface;
     readonly storage: BrowserStorageManagerInterface;
@@ -1801,7 +1812,7 @@ export declare type BrowserJourneyEditRequest = BrowserJourneyEdit | {
  *
  * @remarks
  * - `store` — keeps the journeys the tools record, list, edit, and replay
- * - `runs` — keeps each replay's run; omitting it writes no run
+ * - `runs` — keeps each replay's run and saves standalone images when it provides `snapshot`
  * - `limit` — positive integer listing cap in characters; Default: the owner's `limit`, including direct construction
  * - `readonly` — if `true`, refuses `record`, `save`, `edit`, and `forget` before any store access, and
  *   `replay` still writes runs; if `false` or omitted, every tool runs
@@ -1930,13 +1941,13 @@ export declare interface BrowserJourneyTarget {
 }
 
 /**
- * Registers the journey tools `record`, `save`, `journeys`, `edit`, `replay`, and `forget` over a toolset
+ * Registers the journey tools `record`, `save`, `journeys`, `edit`, `replay`, `forget`, and `capture` over a toolset
  * and owns the recording and the active replay.
  *
  * @remarks
  * The journey toolset composes the toolset's public members: `perform` reads the view a receipt
  * carries through `look`, `hold` and `emitter` drive the recorder and the replay, `view` converts
- * an edit's `ref` to a target, and `tools` receives the six tools at construction, which refuses
+ * an edit's `ref` to a target, and `tools` receives the journey tools at construction, which refuses
  * with `BROWSER_TOOLSET_RESERVED` when the manager already holds one of the names. Every refusal
  * is a sentence that names the next call, and a reason inside it is a clause without a directive
  * or a final period.
@@ -1952,7 +1963,7 @@ export declare interface BrowserJourneyTarget {
  * by the view after the run.
  *
  * `destroy()` aborts the active replay and waits for it to finish, stops a recording without
- * saving it, and removes the six tools the manager still holds under the instances it added.
+ * saving it, and removes the journey tools the manager still holds under the instances it added.
  *
  * @example
  * ```ts
@@ -1972,7 +1983,7 @@ export declare class BrowserJourneyToolset implements BrowserJourneyToolsetInter
 }
 
 /**
- * Registers the six journey tools over a toolset and owns the recording and the active replay.
+ * Registers the journey tools over a toolset and owns the recording and the active replay.
  *
  * @remarks
  * - `recording` — the name of the journey being recorded, or `undefined` when none is
@@ -1981,7 +1992,7 @@ export declare class BrowserJourneyToolset implements BrowserJourneyToolsetInter
 export declare interface BrowserJourneyToolsetInterface {
     readonly recording: string | undefined;
     readonly replaying: string | undefined;
-    /** Aborts the active replay and removes the six journey tools from the manager. */
+    /** Aborts the active replay and removes the journey tools from the manager. */
     destroy(): Promise<void>;
 }
 
@@ -3483,6 +3494,14 @@ export declare interface BrowserRunStep {
 
 /** Keeps runs by the journey name and run id the run carries. */
 export declare interface BrowserRunStoreInterface {
+    /**
+     * Saves a standalone PNG under the runs root without replacing an existing file.
+     * @param bytes - PNG bytes to persist
+     * @param options - Cancellation options
+     * @returns Absolute path of the saved image
+     * @remarks Stores without standalone file storage omit this capability.
+     */
+    snapshot?(bytes: Uint8Array, options?: BrowserStoreOptions): Promise<string>;
     /** Mints a run id for the journey and creates its run directory exclusively. */
     open(name: string, options?: BrowserStoreOptions): Promise<BrowserRunSlot>;
     /** Returns the run stored under the journey name and id, or `undefined` when none is stored. */
@@ -3967,9 +3986,9 @@ export declare interface BrowserRunStoreInterface {
     /**
      * Names a tool the browser toolset reserves: the generic tools, the staged `dialog`, the
      * opt-in `tabs` and `switch`, and the journey tools `record`, `save`, `journeys`, `edit`,
-     * `replay`, and `forget`, which a toolset constructed with `journeys` reserves.
+     * `replay`, `forget`, and `capture`, which a toolset constructed with `journeys` reserves.
      */
-    export declare type BrowserToolName = 'look' | 'read' | 'plain' | 'click' | 'type' | 'press' | 'navigate' | 'wait' | 'dialog' | 'tabs' | 'switch' | 'record' | 'save' | 'journeys' | 'edit' | 'replay' | 'forget';
+    export declare type BrowserToolName = 'look' | 'read' | 'plain' | 'click' | 'type' | 'press' | 'navigate' | 'wait' | 'dialog' | 'tabs' | 'switch' | 'record' | 'save' | 'journeys' | 'edit' | 'replay' | 'forget' | 'capture';
 
     /** Identifies a removed WebMCP tool by document and name. */
     export declare interface BrowserToolRemoval {
@@ -4753,9 +4772,7 @@ export declare interface BrowserRunStoreInterface {
     }
 
     /**
-     * Reports that a CDP request could not be sent or completed because the client was not in a
-     * connectable state — not connected, closed while connecting, or the connection dropped
-     * mid-request — under the code `BROWSER_CDP_CONNECTION_ERROR`.
+     * Reports that a CDP request could not be sent or completed because the client was not connected, closed while connecting, lost its connection, or lost the request's target session, under the code `BROWSER_CDP_CONNECTION_ERROR`.
      */
     export declare class CDPConnectionError extends BrowserError {
         constructor(message: string, context?: Readonly<Record<string, unknown>>);

package/dist/src/core/index.js

@@ -162,7 +162,7 @@ var BROWSER_MOUSE_BUTTON_MASKS = Object.freeze({
 */
 var BROWSER_HAR_CREATOR = Object.freeze({
 	name: "@orkestrel/browser",
-	version: "0.0.23"
+	version: "0.0.25"
 });
 /** Names the attribute that tags temporary screenshot styles and masks. */
 var BROWSER_SCREENSHOT_ATTRIBUTE = "data-orkestrel-screenshot";
@@ -741,7 +741,7 @@ var BROWSER_TOOL_COPY = Object.freeze({
 					description: "The journey name, such as add-kettle."
 				}),
 				edits: Object.freeze({
-					description: "The changes, as an array or a JSON string of the array, applied in order; one invalid change refuses them all.",
+					description: "The changes, as an array or its JSON string, applied in order; one invalid change refuses them all.",
 					anyOf: Object.freeze([Object.freeze({
 						type: "array",
 						items: Object.freeze({
@@ -817,6 +817,18 @@ var BROWSER_TOOL_COPY = Object.freeze({
 			required: Object.freeze(["journey"])
 		})
 	}),
+	capture: Object.freeze({
+		name: "capture",
+		description: "Saves the current view as a PNG in the runs directory and returns its path.",
+		parameters: Object.freeze({
+			type: "object",
+			properties: Object.freeze({ full: Object.freeze({
+				type: "boolean",
+				description: "True captures the full page; false captures the viewport."
+			}) }),
+			required: Object.freeze(["full"])
+		})
+	}),
 	forget: Object.freeze({
 		name: "forget",
 		description: "Removes a saved journey and all its runs; the name is free to record again.",
@@ -885,7 +897,7 @@ var BROWSER_ACTION_STAGES = Object.freeze([
 var BROWSER_JOURNEY_EMPTY_LISTING = "No journeys are saved; call record to start one.";
 /**
 * Names the journey tools a toolset constructed with `journeys` registers and reserves: `record`,
-* `save`, `journeys`, `edit`, `replay`, and `forget`.
+* `save`, `journeys`, `edit`, `replay`, `forget`, and `capture`.
 */
 var BROWSER_JOURNEY_TOOL_NAMES = Object.freeze([
 	"record",
@@ -893,7 +905,8 @@ var BROWSER_JOURNEY_TOOL_NAMES = Object.freeze([
 	"journeys",
 	"edit",
 	"replay",
-	"forget"
+	"forget",
+	"capture"
 ]);
 /** Names observation and journey tools that cannot become journey steps. */
 var BROWSER_JOURNEY_NON_STEP_TOOLS = Object.freeze([...BROWSER_OBSERVATION_TOOL_NAMES, ...BROWSER_JOURNEY_TOOL_NAMES]);
@@ -999,9 +1012,7 @@ var CDPError = class extends BrowserError {
 	}
 };
 /**
-* Reports that a CDP request could not be sent or completed because the client was not in a
-* connectable state — not connected, closed while connecting, or the connection dropped
-* mid-request — under the code `BROWSER_CDP_CONNECTION_ERROR`.
+* Reports that a CDP request could not be sent or completed because the client was not connected, closed while connecting, lost its connection, or lost the request's target session, under the code `BROWSER_CDP_CONNECTION_ERROR`.
 */
 var CDPConnectionError = class extends BrowserError {
 	constructor(message, context) {
@@ -5211,6 +5222,7 @@ var CDPClient = class {
 			const listener = signal === void 0 ? void 0 : this.#abort(id, signal);
 			this.#pending.set(id, {
 				method,
+				session: options?.session,
 				resolve,
 				reject,
 				timer,
@@ -5355,6 +5367,16 @@ var CDPClient = class {
 			const method = parsed["method"];
 			const rawParams = parsed["params"];
 			const params = isRecord(rawParams) ? rawParams : Object.freeze({});
+			if (method === "Target.detachedFromTarget" && isString(params["sessionId"])) {
+				const detached = params["sessionId"];
+				for (const [id, entry] of this.#pending) {
+					if (entry.session !== detached) continue;
+					this.#settle(id)?.reject(new CDPConnectionError("CDP session detached", {
+						method: entry.method,
+						session: detached
+					}));
+				}
+			}
 			const global = this.#subscriptions.get(void 0)?.get(method);
 			if (global !== void 0) this.#dispatch(global, method, params);
 			const session = parsed["sessionId"];
@@ -6450,9 +6472,11 @@ var BrowserPageElement = class {
 				object: result["object"]["objectId"],
 				context
 			};
-		} catch {
+		} catch (error) {
 			options?.signal?.throwIfAborted();
-			throw new BrowserElementError(this.reference, "GONE");
+			if (isCDPTimeoutError(error) || isCDPConnectionError(error)) throw error;
+			if (isCDPError(error) && /Could not find node|No node with given id|No node found for given backend id/i.test(error.message)) throw new BrowserElementError(this.reference, "GONE");
+			throw error;
 		}
 	}
 	async #call(declaration, options, target) {
@@ -6481,7 +6505,7 @@ var BrowserPageElement = class {
 	}
 	#failure(options, error) {
 		options?.signal?.throwIfAborted();
-		if (isBrowserElementError(error)) throw error;
+		if (isBrowserElementError(error) || isCDPTimeoutError(error) || isCDPConnectionError(error)) throw error;
 		const message = (isError(error) ? error.message : String(error)).split("\n", 1)[0] ?? "";
 		const known = BROWSER_ELEMENT_REFUSALS.get(message.replace(/^Error: /, ""));
 		if (known !== void 0) throw new BrowserElementError(this.reference, known.reason, known.detail);
@@ -6513,11 +6537,20 @@ var BrowserPageElement = class {
 			session: this.#input.node.session,
 			...options
 		}).catch(this.#failure.bind(this, options));
-		await this.#call(compileActionabilityFunction({
+		await this.#call(`async function() {
+		await (${compileActionabilityFunction({
 			visible: true,
 			enabled: true,
 			stable: true
-		}), options);
+		})}).call(this)
+		let previous
+		for (;;) {
+			await new Promise((resolve) => requestAnimationFrame(resolve))
+			const current = [window.scrollX, window.scrollY]
+			if (previous && current.every((value, index) => value === previous[index])) return true
+			previous = current
+		}
+	}`, options);
 		const geometry = await this.#geometry(options);
 		const point = geometry.page.center;
 		const local = geometry.local.center;
@@ -6528,6 +6561,10 @@ var BrowserPageElement = class {
 		}, {
 			session: this.#input.node.session,
 			...options
+		}).catch((error) => {
+			options?.signal?.throwIfAborted();
+			if (isCDPError(error) && error.context?.["message"] === "No node found at given location") throw new BrowserElementError(this.reference, "OCCLUDED", "hit-test location held no node");
+			throw error;
 		});
 		if (!isRecord(hit) || !isInteger(hit["backendNodeId"]) || hit["frameId"] !== void 0 && hit["frameId"] !== this.#input.frame) throw new BrowserElementError(this.reference, "OCCLUDED");
 		if (hit["backendNodeId"] !== this.#input.backend && await this.#call(compileHitFunction(), options, hit["backendNodeId"]) !== true) {
@@ -7179,10 +7216,12 @@ var BrowserRegistry = class {
 		for (const frame of new Set([...this.tools(), ...this.#pending].map((entry) => entry.frame))) this.#invalidate(frame);
 	}
 	#navigated(params) {
+		if (this.#page.closed || this.#destroying !== void 0) return;
 		const frame = params["frame"];
 		if (isRecord(frame) && isString(frame["id"])) this.#invalidate(frame["id"]);
 	}
 	#detached(params) {
+		if (this.#page.closed || this.#destroying !== void 0) return;
 		if (isString(params["frameId"])) this.#invalidate(params["frameId"]);
 	}
 	#invalidate(frame) {
@@ -7196,6 +7235,7 @@ var BrowserRegistry = class {
 		if (removed) this.#emitter.emit("change");
 	}
 	#add(session, params) {
+		if (this.#page.closed || this.#destroying !== void 0) return;
 		if (!isArray(params["tools"])) return;
 		for (const value of params["tools"]) {
 			const tool = parseBrowserTool(value);
@@ -7206,6 +7246,7 @@ var BrowserRegistry = class {
 		this.#emitter.emit("change");
 	}
 	#remove(params) {
+		if (this.#page.closed || this.#destroying !== void 0) return;
 		if (!isArray(params["tools"])) return;
 		for (const value of params["tools"]) {
 			const key = parseBrowserRemoval(value);
@@ -10141,10 +10182,10 @@ var BrowserPage = class BrowserPage extends BrowserFrame {
 		} catch {}
 	}
 	async #close() {
-		await this.#release();
 		try {
 			await this.#client.send("Target.closeTarget", { targetId: this.#targetId });
 		} catch {}
+		await this.#release();
 	}
 	#release() {
 		const active = this.#releasing;
@@ -10445,12 +10486,14 @@ var BrowserPage = class BrowserPage extends BrowserFrame {
 	}
 	async #attachWorker(session, id, url, category) {
 		try {
-			await this.#client.send("Runtime.enable", void 0, { session });
+			const enabling = this.#client.send("Runtime.enable", void 0, { session });
+			if (category === "service_worker") this.#resumeTarget(session);
+			await enabling;
 			if (this.#closed) {
 				await this.#detachChild(session, this.#sessionId);
 				return;
 			}
-			this.#resumeTarget(session);
+			if (category !== "service_worker") this.#resumeTarget(session);
 			const worker = new BrowserWorker(this.#client, session, id, url, category);
 			this.#workers.set(id, worker);
 			this.#emitter.emit("worker", worker);
@@ -10787,6 +10830,7 @@ var BrowserPage = class BrowserPage extends BrowserFrame {
 		this.#emitter.emit("navigate", params["url"], true);
 	}
 	#handleFrameDetached(session, params) {
+		if (this.#closed) return;
 		const frame = params["frameId"];
 		if (!isString(frame) || !this.#accepts(session, frame)) return;
 		const swapped = params["reason"] === "swap";
@@ -10887,7 +10931,10 @@ var BrowserPage = class BrowserPage extends BrowserFrame {
 		const session = params["sessionId"];
 		if (!isRecord(target) || !isString(target["targetId"]) || !isString(session)) return;
 		const category = target["type"];
-		if (owner !== this.#sessionId && category !== "iframe") return;
+		if (owner !== this.#sessionId && category !== "iframe") {
+			this.#detachChild(session, owner);
+			return;
+		}
 		if (category === "worker" || category === "service_worker" || category === "shared_worker") {
 			this.#attachWorker(session, target["targetId"], isString(target["url"]) ? target["url"] : "", category);
 			return;
@@ -11195,6 +11242,7 @@ var BrowserContext = class {
 	#publishing = /* @__PURE__ */ new Map();
 	#observed = /* @__PURE__ */ new WeakSet();
 	#shutdown;
+	#disposal;
 	#reference = 0;
 	constructor(client, id, viewport, writer, emulation, downloads, options) {
 		this.#client = client;
@@ -11219,6 +11267,9 @@ var BrowserContext = class {
 	get id() {
 		return this.#id;
 	}
+	get disposal() {
+		return this.#disposal;
+	}
 	get cookies() {
 		return this.#cookies;
 	}
@@ -11261,14 +11312,14 @@ var BrowserContext = class {
 	destroy() {
 		const active = this.#shutdown;
 		if (active !== void 0) return active;
-		const shutdown = this.#destroyResources();
+		const shutdown = Promise.resolve().then(() => this.#destroyResources());
 		this.#shutdown = shutdown;
 		return shutdown;
 	}
 	close() {
 		const active = this.#shutdown;
 		if (active !== void 0) return active;
-		const shutdown = this.#closeResources();
+		const shutdown = Promise.resolve().then(() => this.#closeResources());
 		this.#shutdown = shutdown;
 		return shutdown;
 	}
@@ -11390,9 +11441,15 @@ var BrowserContext = class {
 			let failure = await settleBrowserTeardown(...[...this.#pages.values()].map((page) => () => page.close()));
 			this.#pages.clear();
 			const id = this.#id;
-			if (id !== void 0) {
-				const settled = await settleBrowserTeardown(() => this.#client.send("Target.disposeBrowserContext", { browserContextId: id }));
-				failure ??= settled;
+			if (id !== void 0) try {
+				await this.#client.send("Target.disposeBrowserContext", { browserContextId: id });
+				this.#disposal = { confirmed: true };
+			} catch (error) {
+				this.#disposal = {
+					confirmed: false,
+					error
+				};
+				failure ??= error;
 			}
 			if (failure !== void 0) throw failure;
 		} finally {
@@ -12277,13 +12334,13 @@ function createMemoryBrowserRunStore() {
 //#endregion
 //#region src/core/BrowserJourneyToolset.ts
 /**
-* Registers the journey tools `record`, `save`, `journeys`, `edit`, `replay`, and `forget` over a toolset
+* Registers the journey tools `record`, `save`, `journeys`, `edit`, `replay`, `forget`, and `capture` over a toolset
 * and owns the recording and the active replay.
 *
 * @remarks
 * The journey toolset composes the toolset's public members: `perform` reads the view a receipt
 * carries through `look`, `hold` and `emitter` drive the recorder and the replay, `view` converts
-* an edit's `ref` to a target, and `tools` receives the six tools at construction, which refuses
+* an edit's `ref` to a target, and `tools` receives the journey tools at construction, which refuses
 * with `BROWSER_TOOLSET_RESERVED` when the manager already holds one of the names. Every refusal
 * is a sentence that names the next call, and a reason inside it is a clause without a directive
 * or a final period.
@@ -12299,7 +12356,7 @@ function createMemoryBrowserRunStore() {
 * by the view after the run.
 *
 * `destroy()` aborts the active replay and waits for it to finish, stops a recording without
-* saving it, and removes the six tools the manager still holds under the instances it added.
+* saving it, and removes the journey tools the manager still holds under the instances it added.
 *
 * @example
 * ```ts
@@ -12340,7 +12397,8 @@ var BrowserJourneyToolset = class {
 			this.#create("journeys", this.#journeys.bind(this)),
 			this.#create("edit", this.#edit.bind(this)),
 			this.#create("replay", this.#replayJourney.bind(this)),
-			this.#create("forget", this.#forget.bind(this))
+			this.#create("forget", this.#forget.bind(this)),
+			this.#create("capture", this.#capture.bind(this))
 		]);
 		toolset.tools.add(this.#tools);
 	}
@@ -12367,6 +12425,22 @@ var BrowserJourneyToolset = class {
 		signal.throwIfAborted();
 		return handler(args, signal);
 	}
+	async #capture(args, signal) {
+		const full = args["full"];
+		if (!isBoolean(full)) throw new BrowserError("The full parameter must be true or false.", "BROWSER_TOOLSET_ARGUMENT");
+		this.#idleReplay();
+		const view = this.#toolset.view;
+		if (!view.trusted) throw new BrowserError("This view is untrusted; capture requires a trusted browser view.", "BROWSER_CAPTURE_UNTRUSTED");
+		if (view.screenshot === void 0) throw new BrowserError("This view cannot capture an image.", "BROWSER_CAPTURE_UNAVAILABLE");
+		const runs = this.#runs;
+		if (runs?.snapshot === void 0) throw new BrowserError("Capture requires a runs store with standalone file storage.", "BROWSER_CAPTURE_UNAVAILABLE");
+		const screenshot = await view.screenshot({
+			format: "png",
+			full
+		});
+		signal.throwIfAborted();
+		return runs.snapshot(screenshot.bytes, { signal });
+	}
 	async #record(args, signal) {
 		if (this.#readonly) throw new BrowserError(BROWSER_JOURNEY_READONLY_REFUSAL, "BROWSER_JOURNEY_READONLY");
 		this.#idleReplay();