stagehand 4.2.0a0.dev1533__tar.gz → 4.2.0a0.dev1535__tar.gz

{stagehand-4.2.0a0.dev1533 → stagehand-4.2.0a0.dev1535}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stagehand
-Version: 4.2.0a0.dev1533
+Version: 4.2.0a0.dev1535
 Summary: Browserbase's SDK for building browser agents
 Keywords: ai,browser,automation,web-scraping,testing
 Author: Browserbase

{stagehand-4.2.0a0.dev1533 → stagehand-4.2.0a0.dev1535}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stagehand"
-version = "4.2.0a0.dev1533"
+version = "4.2.0a0.dev1535"
 description = "Browserbase's SDK for building browser agents"
 readme = "README.md"
 requires-python = ">=3.11"

{stagehand-4.2.0a0.dev1533 → stagehand-4.2.0a0.dev1535}/src/stagehand/_extension/service-worker.js

@@ -7359,7 +7359,7 @@ function isRecord$1(value) {
 }
 var package_default$1 = {
 	name: "@browserbasehq/stagehand-protocol",
-	version: "2.1.0-alpha-2c098f44857665045dbed31168ac36af920774d9",
+	version: "2.1.0-alpha-f3543d321e6c0edc800d9e73c79dd9d47f622189",
 	"private": true,
 	type: "module",
 	exports: {
@@ -14633,6 +14633,13 @@ var Locator = class Locator {
 };
 //#endregion
 //#region understudy/frameLocator.ts
+/** Best-effort readiness budget for frame transitions, not an overall operation timeout. */
+var FRAME_LOCATOR_READY_TIMEOUT_MS = 1200;
+/**
+* Best-effort timeout for each locator-world attempt. Fallback eligibility can
+* extend an attempt while it waits for the main world.
+*/
+var LOCATOR_WORLD_ATTEMPT_TIMEOUT_MS = 200;
 /**
 * FrameLocator: resolves iframe elements to their child Frames and allows
 * creating locators scoped to that frame. Supports chaining.
@@ -14658,12 +14665,18 @@ var FrameLocator = class FrameLocator {
 			await parentSession.send("DOM.enable").catch(() => {});
 			const iframeBackendNodeId = (await parentSession.send("DOM.describeNode", { objectId })).node.backendNodeId;
 			const childIds = await listDirectChildFrameIdsFromRegistry(this.page, parentFrame.frameId, 1e3);
-			for (const fid of childIds) try {
-				if ((await parentSession.send("DOM.getFrameOwner", { frameId: fid })).backendNodeId === iframeBackendNodeId) {
-					await ensureChildFrameReady(this.page, parentFrame, fid, 1200);
+			for (const fid of childIds) {
+				let owner;
+				try {
+					owner = await parentSession.send("DOM.getFrameOwner", { frameId: fid });
+				} catch {
+					continue;
+				}
+				if (owner.backendNodeId === iframeBackendNodeId) {
+					await ensureChildFrameReady(this.page, fid, FRAME_LOCATOR_READY_TIMEOUT_MS);
 					return this.page.frameForId(fid);
 				}
-			} catch {}
+			}
 			throw new Error(`Unable to obtain a content frame for selector: ${this.selector}`);
 		} finally {
 			await parentSession.send("Runtime.releaseObject", { objectId }).catch(() => {});
@@ -14758,66 +14771,25 @@ function findFrameNode(tree, targetId) {
 	}
 }
 /**
-* Ensure we can evaluate in the child frame with minimal delay.
-* - If the child is same-process: parent session owns it and main world appears quickly.
-* - If OOPIF and adoption not finished: wait briefly for ownership change, then main world.
+* Block until the Stagehand locator/extension world is usable in the child frame.
+* Re-resolves CDP session ownership on each attempt so OOPIF adoption cannot pin
+* the wait to a stale session for the full budget.
 */
-async function ensureChildFrameReady(page, parentFrame, childFrameId, budgetMs) {
-	const parentSession = parentFrame.session;
+async function ensureChildFrameReady(page, childFrameId, budgetMs) {
 	const deadline = Date.now() + Math.max(0, budgetMs);
-	const owner = page.getSessionForFrame(childFrameId);
-	if (owner && owner !== parentSession) {
-		try {
-			await executionContexts.waitForMainWorld(owner, childFrameId, 600);
-		} catch {}
-		return;
-	}
-	const hasMainWorldOnParent = () => {
+	let lastError;
+	while (Date.now() < deadline) {
+		const session = page.getSessionForFrame(childFrameId);
+		const remaining = deadline - Date.now();
+		if (remaining <= 0) break;
 		try {
-			return executionContexts.getMainWorld(parentSession, childFrameId) !== null;
-		} catch {
-			return false;
+			await executionContexts.waitForLocatorWorld(session, childFrameId, Math.min(remaining, LOCATOR_WORLD_ATTEMPT_TIMEOUT_MS));
+			if (page.getSessionForFrame(childFrameId) === session) return;
+		} catch (error) {
+			lastError = error;
 		}
-	};
-	if (hasMainWorldOnParent()) return;
-	await parentSession.send("Page.setLifecycleEventsEnabled", { enabled: true }).catch(() => {});
-	await parentSession.send("Runtime.enable").catch(() => {});
-	await new Promise((resolve) => {
-		let done = false;
-		const finish = () => {
-			if (done) return;
-			done = true;
-			parentSession.off("Page.lifecycleEvent", onLifecycle);
-			resolve();
-		};
-		const onLifecycle = (evt) => {
-			if (evt.frameId !== childFrameId || evt.name !== "DOMContentLoaded" && evt.name !== "load" && evt.name !== "networkIdle" && evt.name !== "networkidle") return;
-			if (hasMainWorldOnParent()) return finish();
-			try {
-				const nowOwner = page.getSessionForFrame(childFrameId);
-				if (nowOwner && nowOwner !== parentSession) {
-					const left = Math.max(150, deadline - Date.now());
-					executionContexts.waitForMainWorld(nowOwner, childFrameId, left).finally(finish);
-				}
-			} catch {}
-		};
-		parentSession.on("Page.lifecycleEvent", onLifecycle);
-		const tick = () => {
-			if (done) return;
-			if (hasMainWorldOnParent()) return finish();
-			try {
-				const nowOwner = page.getSessionForFrame(childFrameId);
-				if (nowOwner && nowOwner !== parentSession) {
-					const left = Math.max(150, deadline - Date.now());
-					executionContexts.waitForMainWorld(nowOwner, childFrameId, left).finally(finish);
-					return;
-				}
-			} catch {}
-			if (Date.now() >= deadline) return finish();
-			setTimeout(tick, 50);
-		};
-		tick();
-	});
+	}
+	throw new Error(`Locator world not ready for frame ${childFrameId}: exhausted ${budgetMs} ms frame-readiness budget`, { cause: lastError });
 }
 //#endregion
 //#region understudy/a11y/snapshot/xpathUtils.ts
@@ -15179,27 +15151,39 @@ var DeepLocatorDelegate = class DeepLocatorDelegate {
 function deepLocatorFromPage(page, root, selector) {
 	return new DeepLocatorDelegate(page, root, selector);
 }
-async function resolveDeepXPathTarget(page, root, xpathOrSelector) {
+/**
+* Plan deep-XPath frame hops without resolving frames.
+* An iframe/frame step becomes a hop only when further selector steps follow it,
+* so a trailing iframe remains a parent-frame element target.
+*/
+function planDeepXPathTarget(xpathOrSelector) {
 	let path = xpathOrSelector.trim();
 	if (path.startsWith("xpath=")) path = path.slice(6).trim();
 	if (!path.startsWith("/")) path = "/" + path;
 	const steps = parseXPath(path);
-	let fl;
+	const frameHopSelectors = [];
 	let buf = [];
-	const flushIntoFrameLocator = () => {
-		if (!buf.length) return;
-		const selectorForIframe = "xpath=" + buildXPathFromSteps(buf);
-		fl = fl ? fl.frameLocator(selectorForIframe) : frameLocatorFromFrame(page, root, selectorForIframe);
-		buf = [];
-	};
-	for (const st of steps) {
+	for (let i = 0; i < steps.length; i++) {
+		const st = steps[i];
 		buf.push(st);
-		if (IFRAME_STEP_RE.test(st.name)) flushIntoFrameLocator();
+		const hasStepsAfter = i < steps.length - 1;
+		if (IFRAME_STEP_RE.test(st.name) && hasStepsAfter) {
+			frameHopSelectors.push("xpath=" + buildXPathFromSteps(buf));
+			buf = [];
+		}
 	}
-	const finalSelector = "xpath=" + buildXPathFromSteps(buf);
+	return {
+		frameHopSelectors,
+		finalSelector: "xpath=" + buildXPathFromSteps(buf)
+	};
+}
+async function resolveDeepXPathTarget(page, root, xpathOrSelector) {
+	const plan = planDeepXPathTarget(xpathOrSelector);
+	let fl;
+	for (const hop of plan.frameHopSelectors) fl = fl ? fl.frameLocator(hop) : frameLocatorFromFrame(page, root, hop);
 	return {
 		frame: fl ? await fl.resolveFrame() : root,
-		selector: finalSelector
+		selector: plan.finalSelector
 	};
 }
 //#endregion
@@ -53981,7 +53965,7 @@ var WebTracerProvider = class extends BasicTracerProvider {
 };
 var package_default = {
 	name: "@browserbasehq/stagehand-extension",
-	version: "1.1.0-alpha-2c098f44857665045dbed31168ac36af920774d9",
+	version: "1.1.0-alpha-f3543d321e6c0edc800d9e73c79dd9d47f622189",
 	"private": true,
 	type: "module",
 	scripts: {

{stagehand-4.2.0a0.dev1533 → stagehand-4.2.0a0.dev1535}/src/stagehand/_generated/protocol_version.py

@@ -1,4 +1,4 @@
 """Generated from packages/protocol/package.json. Do not edit."""
 
 PROTOCOL_SEMVER_PATTERN = '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+([0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?$'
-STAGEHAND_PROTOCOL_VERSION = '2.1.0-alpha-2c098f44857665045dbed31168ac36af920774d9'
+STAGEHAND_PROTOCOL_VERSION = '2.1.0-alpha-f3543d321e6c0edc800d9e73c79dd9d47f622189'