@browserbasehq/orca 3.0.9-alpha-3 → 3.1.0-patch.0

package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.js

@@ -0,0 +1,196 @@
+import { applyPredicates, parseXPathSteps, } from "./xpathParser.js";
+const normalizeXPath = (selector) => {
+    const raw = String(selector ?? "").trim();
+    if (!raw)
+        return "";
+    return raw.replace(/^xpath=/i, "").trim();
+};
+export function resolveXPathFirst(rawXp, options) {
+    return resolveXPathAtIndex(rawXp, 0, options);
+}
+export function resolveXPathAtIndex(rawXp, index, options) {
+    if (!Number.isFinite(index) || index < 0)
+        return null;
+    const xp = normalizeXPath(rawXp);
+    if (!xp)
+        return null;
+    const targetIndex = Math.floor(index);
+    const pierceShadow = options?.pierceShadow !== false;
+    const shadowCtx = pierceShadow ? getShadowContext() : null;
+    if (!pierceShadow) {
+        return resolveNativeAtIndexWithError(xp, targetIndex).value;
+    }
+    if (!shadowCtx?.hasShadow) {
+        const native = resolveNativeAtIndexWithError(xp, targetIndex);
+        if (!native.error)
+            return native.value;
+        const composed = resolveXPathComposedMatches(xp, shadowCtx?.getClosedRoot);
+        return composed[targetIndex] ?? null;
+    }
+    const composed = resolveXPathComposedMatches(xp, shadowCtx.getClosedRoot);
+    return composed[targetIndex] ?? null;
+}
+export function countXPathMatches(rawXp, options) {
+    const xp = normalizeXPath(rawXp);
+    if (!xp)
+        return 0;
+    const pierceShadow = options?.pierceShadow !== false;
+    const shadowCtx = pierceShadow ? getShadowContext() : null;
+    if (!pierceShadow) {
+        return resolveNativeCountWithError(xp).count;
+    }
+    if (!shadowCtx?.hasShadow) {
+        const count = resolveNativeCountWithError(xp);
+        if (!count.error)
+            return count.count;
+        return resolveXPathComposedMatches(xp, shadowCtx?.getClosedRoot).length;
+    }
+    return resolveXPathComposedMatches(xp, shadowCtx.getClosedRoot).length;
+}
+export function resolveXPathComposedMatches(rawXp, getClosedRoot) {
+    const xp = normalizeXPath(rawXp);
+    if (!xp)
+        return [];
+    const steps = parseXPathSteps(xp);
+    if (!steps.length)
+        return [];
+    const closedRoot = getClosedRoot ?? null;
+    let current = [
+        document,
+    ];
+    for (const step of steps) {
+        const next = [];
+        const seen = new Set();
+        for (const root of current) {
+            if (!root)
+                continue;
+            const pool = step.axis === "child"
+                ? composedChildren(root, closedRoot)
+                : composedDescendants(root, closedRoot);
+            if (!pool.length)
+                continue;
+            const tagMatches = pool.filter((candidate) => matchesTag(candidate, step));
+            const matches = applyPredicates(tagMatches, step.predicates);
+            for (const candidate of matches) {
+                if (!seen.has(candidate)) {
+                    seen.add(candidate);
+                    next.push(candidate);
+                }
+            }
+        }
+        if (!next.length)
+            return [];
+        current = next;
+    }
+    return current;
+}
+function matchesTag(element, step) {
+    if (step.tag === "*")
+        return true;
+    return element.localName === step.tag;
+}
+function getShadowContext() {
+    const backdoor = window.__stagehandV3__;
+    const getClosedRoot = backdoor && typeof backdoor.getClosedRoot === "function"
+        ? (host) => {
+            try {
+                return backdoor.getClosedRoot(host) ?? null;
+            }
+            catch {
+                return null;
+            }
+        }
+        : null;
+    let hasShadow = false;
+    try {
+        if (backdoor && typeof backdoor.stats === "function") {
+            const stats = backdoor.stats();
+            hasShadow = (stats?.open ?? 0) > 0 || (stats?.closed ?? 0) > 0;
+        }
+    }
+    catch {
+        // ignore stats errors
+    }
+    if (!hasShadow) {
+        try {
+            const walker = document.createTreeWalker(document, NodeFilter.SHOW_ELEMENT);
+            while (walker.nextNode()) {
+                const el = walker.currentNode;
+                if (el.shadowRoot) {
+                    hasShadow = true;
+                    break;
+                }
+            }
+        }
+        catch {
+            // ignore scan errors
+        }
+    }
+    return { getClosedRoot, hasShadow };
+}
+function composedChildren(node, getClosedRoot) {
+    const out = [];
+    if (!node)
+        return out;
+    if (node instanceof Document) {
+        if (node.documentElement)
+            out.push(node.documentElement);
+        return out;
+    }
+    if (node instanceof ShadowRoot || node instanceof DocumentFragment) {
+        out.push(...Array.from(node.children ?? []));
+        return out;
+    }
+    if (node instanceof Element) {
+        out.push(...Array.from(node.children ?? []));
+        const open = node.shadowRoot;
+        if (open)
+            out.push(...Array.from(open.children ?? []));
+        if (getClosedRoot) {
+            const closed = getClosedRoot(node);
+            if (closed)
+                out.push(...Array.from(closed.children ?? []));
+        }
+        return out;
+    }
+    return out;
+}
+function composedDescendants(node, getClosedRoot) {
+    const out = [];
+    const seen = new Set();
+    const stack = [...composedChildren(node, getClosedRoot)].reverse();
+    while (stack.length) {
+        const next = stack.pop();
+        if (!next || seen.has(next))
+            continue;
+        seen.add(next);
+        out.push(next);
+        const children = composedChildren(next, getClosedRoot);
+        for (let i = children.length - 1; i >= 0; i -= 1) {
+            stack.push(children[i]);
+        }
+    }
+    return out;
+}
+function resolveNativeAtIndexWithError(xp, index) {
+    try {
+        const snapshot = document.evaluate(xp, document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);
+        return {
+            value: snapshot.snapshotItem(index),
+            error: false,
+        };
+    }
+    catch {
+        return { value: null, error: true };
+    }
+}
+function resolveNativeCountWithError(xp) {
+    try {
+        const snapshot = document.evaluate(xp, document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);
+        return { count: snapshot.snapshotLength, error: false };
+    }
+    catch {
+        return { count: 0, error: true };
+    }
+}
+//# sourceMappingURL=xpathResolver.js.map

package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpathResolver.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/locatorScripts/xpathResolver.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  applyPredicates,\n  parseXPathSteps,\n  type XPathStep,\n} from \"./xpathParser.js\";\n\ntype ClosedRootGetter = (host: Element) => ShadowRoot | null;\n\nexport type XPathResolveOptions = {\n  pierceShadow?: boolean;\n};\n\ntype ShadowContext = {\n  getClosedRoot: ClosedRootGetter | null;\n  hasShadow: boolean;\n};\n\nconst normalizeXPath = (selector: string): string => {\n  const raw = String(selector ?? \"\").trim();\n  if (!raw) return \"\";\n  return raw.replace(/^xpath=/i, \"\").trim();\n};\n\nexport function resolveXPathFirst(\n  rawXp: string,\n  options?: XPathResolveOptions,\n): Element | null {\n  return resolveXPathAtIndex(rawXp, 0, options);\n}\n\nexport function resolveXPathAtIndex(\n  rawXp: string,\n  index: number,\n  options?: XPathResolveOptions,\n): Element | null {\n  if (!Number.isFinite(index) || index < 0) return null;\n  const xp = normalizeXPath(rawXp);\n  if (!xp) return null;\n\n  const targetIndex = Math.floor(index);\n  const pierceShadow = options?.pierceShadow !== false;\n  const shadowCtx = pierceShadow ? getShadowContext() : null;\n\n  if (!pierceShadow) {\n    return resolveNativeAtIndexWithError(xp, targetIndex).value;\n  }\n\n  if (!shadowCtx?.hasShadow) {\n    const native = resolveNativeAtIndexWithError(xp, targetIndex);\n    if (!native.error) return native.value;\n    const composed = resolveXPathComposedMatches(xp, shadowCtx?.getClosedRoot);\n    return composed[targetIndex] ?? null;\n  }\n\n  const composed = resolveXPathComposedMatches(xp, shadowCtx.getClosedRoot);\n  return composed[targetIndex] ?? null;\n}\n\nexport function countXPathMatches(\n  rawXp: string,\n  options?: XPathResolveOptions,\n): number {\n  const xp = normalizeXPath(rawXp);\n  if (!xp) return 0;\n\n  const pierceShadow = options?.pierceShadow !== false;\n  const shadowCtx = pierceShadow ? getShadowContext() : null;\n\n  if (!pierceShadow) {\n    return resolveNativeCountWithError(xp).count;\n  }\n\n  if (!shadowCtx?.hasShadow) {\n    const count = resolveNativeCountWithError(xp);\n    if (!count.error) return count.count;\n    return resolveXPathComposedMatches(xp, shadowCtx?.getClosedRoot).length;\n  }\n\n  return resolveXPathComposedMatches(xp, shadowCtx.getClosedRoot).length;\n}\n\nexport function resolveXPathComposedMatches(\n  rawXp: string,\n  getClosedRoot?: ClosedRootGetter | null,\n): Element[] {\n  const xp = normalizeXPath(rawXp);\n  if (!xp) return [];\n\n  const steps = parseXPathSteps(xp);\n  if (!steps.length) return [];\n\n  const closedRoot = getClosedRoot ?? null;\n\n  let current: Array<Document | Element | ShadowRoot | DocumentFragment> = [\n    document,\n  ];\n\n  for (const step of steps) {\n    const next: Element[] = [];\n    const seen = new Set<Element>();\n\n    for (const root of current) {\n      if (!root) continue;\n      const pool =\n        step.axis === \"child\"\n          ? composedChildren(root, closedRoot)\n          : composedDescendants(root, closedRoot);\n      if (!pool.length) continue;\n\n      const tagMatches = pool.filter((candidate) =>\n        matchesTag(candidate, step),\n      );\n      const matches = applyPredicates(tagMatches, step.predicates);\n\n      for (const candidate of matches) {\n        if (!seen.has(candidate)) {\n          seen.add(candidate);\n          next.push(candidate);\n        }\n      }\n    }\n\n    if (!next.length) return [];\n    current = next;\n  }\n\n  return current as Element[];\n}\n\nfunction matchesTag(element: Element, step: XPathStep): boolean {\n  if (step.tag === \"*\") return true;\n  return element.localName === step.tag;\n}\n\nfunction getShadowContext(): ShadowContext {\n  const backdoor = window.__stagehandV3__;\n  const getClosedRoot: ClosedRootGetter | null =\n    backdoor && typeof backdoor.getClosedRoot === \"function\"\n      ? (host: Element): ShadowRoot | null => {\n          try {\n            return backdoor.getClosedRoot(host) ?? null;\n          } catch {\n            return null;\n          }\n        }\n      : null;\n\n  let hasShadow = false;\n  try {\n    if (backdoor && typeof backdoor.stats === \"function\") {\n      const stats = backdoor.stats();\n      hasShadow = (stats?.open ?? 0) > 0 || (stats?.closed ?? 0) > 0;\n    }\n  } catch {\n    // ignore stats errors\n  }\n\n  if (!hasShadow) {\n    try {\n      const walker = document.createTreeWalker(\n        document,\n        NodeFilter.SHOW_ELEMENT,\n      );\n      while (walker.nextNode()) {\n        const el = walker.currentNode as Element;\n        if (el.shadowRoot) {\n          hasShadow = true;\n          break;\n        }\n      }\n    } catch {\n      // ignore scan errors\n    }\n  }\n\n  return { getClosedRoot, hasShadow };\n}\n\nfunction composedChildren(\n  node: Node | null | undefined,\n  getClosedRoot: ClosedRootGetter | null,\n): Element[] {\n  const out: Element[] = [];\n  if (!node) return out;\n\n  if (node instanceof Document) {\n    if (node.documentElement) out.push(node.documentElement);\n    return out;\n  }\n\n  if (node instanceof ShadowRoot || node instanceof DocumentFragment) {\n    out.push(...Array.from(node.children ?? []));\n    return out;\n  }\n\n  if (node instanceof Element) {\n    out.push(...Array.from(node.children ?? []));\n    const open = node.shadowRoot;\n    if (open) out.push(...Array.from(open.children ?? []));\n    if (getClosedRoot) {\n      const closed = getClosedRoot(node);\n      if (closed) out.push(...Array.from(closed.children ?? []));\n    }\n    return out;\n  }\n\n  return out;\n}\n\nfunction composedDescendants(\n  node: Node | null | undefined,\n  getClosedRoot: ClosedRootGetter | null,\n): Element[] {\n  const out: Element[] = [];\n  const seen = new Set<Element>();\n  const stack = [...composedChildren(node, getClosedRoot)].reverse();\n\n  while (stack.length) {\n    const next = stack.pop();\n    if (!next || seen.has(next)) continue;\n    seen.add(next);\n    out.push(next);\n\n    const children = composedChildren(next, getClosedRoot);\n    for (let i = children.length - 1; i >= 0; i -= 1) {\n      stack.push(children[i]!);\n    }\n  }\n\n  return out;\n}\n\nfunction resolveNativeAtIndexWithError(\n  xp: string,\n  index: number,\n): { value: Element | null; error: boolean } {\n  try {\n    const snapshot = document.evaluate(\n      xp,\n      document,\n      null,\n      XPathResult.ORDERED_NODE_SNAPSHOT_TYPE,\n      null,\n    );\n    return {\n      value: snapshot.snapshotItem(index) as Element | null,\n      error: false,\n    };\n  } catch {\n    return { value: null, error: true };\n  }\n}\n\nfunction resolveNativeCountWithError(xp: string): {\n  count: number;\n  error: boolean;\n} {\n  try {\n    const snapshot = document.evaluate(\n      xp,\n      document,\n      null,\n      XPathResult.ORDERED_NODE_SNAPSHOT_TYPE,\n      null,\n    );\n    return { count: snapshot.snapshotLength, error: false };\n  } catch {\n    return { count: 0, error: true };\n  }\n}\n"]}

package/dist/esm/lib/v3/dom/piercer.entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/lib/v3/dom/piercer.entry.js

@@ -0,0 +1,3 @@
+import { installV3ShadowPiercer } from "./piercer.runtime.js";
+installV3ShadowPiercer({ debug: true, tagExisting: false });
+//# sourceMappingURL=piercer.entry.js.map

package/dist/esm/lib/v3/dom/piercer.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"piercer.entry.js","sourceRoot":"","sources":["../../../../../lib/v3/dom/piercer.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,sBAAsB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC","sourcesContent":["import { installV3ShadowPiercer } from \"./piercer.runtime.js\";\n\ninstallV3ShadowPiercer({ debug: true, tagExisting: false });\n"]}

package/dist/esm/lib/v3/dom/piercer.runtime.d.ts

@@ -0,0 +1,23 @@
+export interface V3ShadowPatchOptions {
+    debug?: boolean;
+    tagExisting?: boolean;
+}
+export interface StagehandV3Backdoor {
+    /** Closed shadow-root accessors */
+    getClosedRoot(host: Element): ShadowRoot | undefined;
+    /** Stats + quick health check */
+    stats(): {
+        installed: true;
+        url: string;
+        isTop: boolean;
+        open: number;
+        closed: number;
+    };
+}
+declare global {
+    interface Window {
+        __stagehandV3Injected?: boolean;
+        __stagehandV3__?: StagehandV3Backdoor;
+    }
+}
+export declare function installV3ShadowPiercer(opts?: V3ShadowPatchOptions): void;

package/dist/esm/lib/v3/dom/piercer.runtime.js

@@ -0,0 +1,90 @@
+export function installV3ShadowPiercer(opts = {}) {
+    // hardcoded debug (remove later if desired)
+    const DEBUG = true;
+    const bindBackdoor = (state) => {
+        const { hostToRoot } = state;
+        window.__stagehandV3__ = {
+            getClosedRoot: (host) => hostToRoot.get(host),
+            stats: () => ({
+                installed: true,
+                url: location.href,
+                isTop: window.top === window,
+                open: state.openCount,
+                closed: state.closedCount,
+            }),
+        };
+    };
+    // Look at the *current* function on the prototype. If it's already our patched
+    // function, reuse its shared state and rebind the backdoor (no new WeakMap).
+    const currentFn = Element.prototype.attachShadow;
+    if (currentFn.__v3Patched && currentFn.__v3State) {
+        currentFn.__v3State.debug = DEBUG; // keep debug toggle consistent
+        bindBackdoor(currentFn.__v3State);
+        // idempotent: do not log "installed" again
+        return;
+    }
+    // First-time install: create shared state and replace the prototype method
+    const state = {
+        hostToRoot: new WeakMap(),
+        openCount: 0,
+        closedCount: 0,
+        debug: DEBUG,
+    };
+    const original = currentFn; // keep a reference to call through
+    const patched = function (init) {
+        const mode = init?.mode ?? "open";
+        const root = original.call(this, init);
+        try {
+            state.hostToRoot.set(this, root);
+            if (mode === "closed")
+                state.closedCount++;
+            else
+                state.openCount++;
+            if (state.debug) {
+                console.info("[v3-piercer] attachShadow", {
+                    tag: this.tagName?.toLowerCase() ?? "",
+                    mode,
+                    url: location.href,
+                });
+            }
+        }
+        catch {
+            //
+        }
+        return root;
+    };
+    // Mark the *patched* function with metadata so re-entry sees it
+    patched.__v3Patched = true;
+    patched.__v3State = state;
+    Object.defineProperty(Element.prototype, "attachShadow", {
+        configurable: true,
+        writable: true,
+        value: patched,
+    });
+    // Optionally tag existing open roots (closed cannot be discovered post-hoc)
+    if (opts.tagExisting) {
+        try {
+            const walker = document.createTreeWalker(document, NodeFilter.SHOW_ELEMENT);
+            while (walker.nextNode()) {
+                const el = walker.currentNode;
+                if (el.shadowRoot) {
+                    state.hostToRoot.set(el, el.shadowRoot);
+                    state.openCount++;
+                }
+            }
+        }
+        catch {
+            //
+        }
+    }
+    window.__stagehandV3Injected = true;
+    bindBackdoor(state);
+    if (state.debug) {
+        console.info("[v3-piercer] installed", {
+            url: location.href,
+            isTop: window.top === window,
+            readyState: document.readyState,
+        });
+    }
+}
+//# sourceMappingURL=piercer.runtime.js.map

package/dist/esm/lib/v3/dom/piercer.runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"piercer.runtime.js","sourceRoot":"","sources":["../../../../../lib/v3/dom/piercer.runtime.ts"],"names":[],"mappings":"AAgCA,MAAM,UAAU,sBAAsB,CAAC,OAA6B,EAAE;IACpE,4CAA4C;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC;IAOnB,MAAM,YAAY,GAAG,CAAC,KAAsB,EAAQ,EAAE;QACpD,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAE7B,MAAM,CAAC,eAAe,GAAG;YACvB,aAAa,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YACtD,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;gBACZ,SAAS,EAAE,IAAI;gBACf,GAAG,EAAE,QAAQ,CAAC,IAAI;gBAClB,KAAK,EAAE,MAAM,CAAC,GAAG,KAAK,MAAM;gBAC5B,IAAI,EAAE,KAAK,CAAC,SAAS;gBACrB,MAAM,EAAE,KAAK,CAAC,WAAW;aAC1B,CAAC;SAC2B,CAAC;IAClC,CAAC,CAAC;IAEF,+EAA+E;IAC/E,6EAA6E;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,YAAyB,CAAC;IAC9D,IAAI,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACjD,SAAS,CAAC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,+BAA+B;QAClE,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAClC,2CAA2C;QAC3C,OAAO;IACT,CAAC;IAED,2EAA2E;IAC3E,MAAM,KAAK,GAAoB;QAC7B,UAAU,EAAE,IAAI,OAAO,EAAuB;QAC9C,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;QACd,KAAK,EAAE,KAAK;KACb,CAAC;IAEF,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,mCAAmC;IAC/D,MAAM,OAAO,GAAc,UAEzB,IAAoB;QAEpB,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACjC,IAAI,IAAI,KAAK,QAAQ;gBAAE,KAAK,CAAC,WAAW,EAAE,CAAC;;gBACtC,KAAK,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE;oBACxC,GAAG,EAAG,IAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;oBACnD,IAAI;oBACJ,GAAG,EAAE,QAAQ,CAAC,IAAI;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,EAAE;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAc,CAAC;IAEf,gEAAgE;IAChE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC;IAE1B,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE;QACvD,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,OAAO;KACf,CAAC,CAAC;IAEH,4EAA4E;IAC5E,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CACtC,QAAQ,EACR,UAAU,CAAC,YAAY,CACxB,CAAC;YACF,OAAO,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACzB,MAAM,EAAE,GAAG,MAAM,CAAC,WAAsB,CAAC;gBACzC,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;oBAClB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC;oBACxC,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,EAAE;QACJ,CAAC;IACH,CAAC;IAED,MAAM,CAAC,qBAAqB,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,KAAK,CAAC,CAAC;IAEpB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE;YACrC,GAAG,EAAE,QAAQ,CAAC,IAAI;YAClB,KAAK,EAAE,MAAM,CAAC,GAAG,KAAK,MAAM;YAC5B,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;AACH,CAAC","sourcesContent":["export interface V3ShadowPatchOptions {\n  debug?: boolean;\n  tagExisting?: boolean;\n}\n\nexport interface StagehandV3Backdoor {\n  /** Closed shadow-root accessors */\n  getClosedRoot(host: Element): ShadowRoot | undefined;\n  /** Stats + quick health check */\n  stats(): {\n    installed: true;\n    url: string;\n    isTop: boolean;\n    open: number;\n    closed: number;\n  };\n}\n\ntype V3InternalState = {\n  hostToRoot: WeakMap<Element, ShadowRoot>;\n  openCount: number;\n  closedCount: number;\n  debug: boolean;\n};\n\ndeclare global {\n  interface Window {\n    __stagehandV3Injected?: boolean;\n    __stagehandV3__?: StagehandV3Backdoor;\n  }\n}\n\nexport function installV3ShadowPiercer(opts: V3ShadowPatchOptions = {}): void {\n  // hardcoded debug (remove later if desired)\n  const DEBUG = true;\n\n  type PatchedFn = Element[\"attachShadow\"] & {\n    __v3Patched?: boolean;\n    __v3State?: V3InternalState;\n  };\n\n  const bindBackdoor = (state: V3InternalState): void => {\n    const { hostToRoot } = state;\n\n    window.__stagehandV3__ = {\n      getClosedRoot: (host: Element) => hostToRoot.get(host),\n      stats: () => ({\n        installed: true,\n        url: location.href,\n        isTop: window.top === window,\n        open: state.openCount,\n        closed: state.closedCount,\n      }),\n    } satisfies StagehandV3Backdoor;\n  };\n\n  // Look at the *current* function on the prototype. If it's already our patched\n  // function, reuse its shared state and rebind the backdoor (no new WeakMap).\n  const currentFn = Element.prototype.attachShadow as PatchedFn;\n  if (currentFn.__v3Patched && currentFn.__v3State) {\n    currentFn.__v3State.debug = DEBUG; // keep debug toggle consistent\n    bindBackdoor(currentFn.__v3State);\n    // idempotent: do not log \"installed\" again\n    return;\n  }\n\n  // First-time install: create shared state and replace the prototype method\n  const state: V3InternalState = {\n    hostToRoot: new WeakMap<Element, ShadowRoot>(),\n    openCount: 0,\n    closedCount: 0,\n    debug: DEBUG,\n  };\n\n  const original = currentFn; // keep a reference to call through\n  const patched: PatchedFn = function (\n    this: Element,\n    init: ShadowRootInit,\n  ): ShadowRoot {\n    const mode = init?.mode ?? \"open\";\n    const root = original.call(this, init);\n    try {\n      state.hostToRoot.set(this, root);\n      if (mode === \"closed\") state.closedCount++;\n      else state.openCount++;\n      if (state.debug) {\n        console.info(\"[v3-piercer] attachShadow\", {\n          tag: (this as Element).tagName?.toLowerCase() ?? \"\",\n          mode,\n          url: location.href,\n        });\n      }\n    } catch {\n      //\n    }\n    return root;\n  } as PatchedFn;\n\n  // Mark the *patched* function with metadata so re-entry sees it\n  patched.__v3Patched = true;\n  patched.__v3State = state;\n\n  Object.defineProperty(Element.prototype, \"attachShadow\", {\n    configurable: true,\n    writable: true,\n    value: patched,\n  });\n\n  // Optionally tag existing open roots (closed cannot be discovered post-hoc)\n  if (opts.tagExisting) {\n    try {\n      const walker = document.createTreeWalker(\n        document,\n        NodeFilter.SHOW_ELEMENT,\n      );\n      while (walker.nextNode()) {\n        const el = walker.currentNode as Element;\n        if (el.shadowRoot) {\n          state.hostToRoot.set(el, el.shadowRoot);\n          state.openCount++;\n        }\n      }\n    } catch {\n      //\n    }\n  }\n\n  window.__stagehandV3Injected = true;\n  bindBackdoor(state);\n\n  if (state.debug) {\n    console.info(\"[v3-piercer] installed\", {\n      url: location.href,\n      isTop: window.top === window,\n      readyState: document.readyState,\n    });\n  }\n}\n"]}

package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.js

@@ -0,0 +1,3 @@
+import { rerenderMissingShadowHosts } from "./rerenderMissingShadows.runtime.js";
+rerenderMissingShadowHosts();
+//# sourceMappingURL=rerenderMissingShadows.entry.js.map

package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerenderMissingShadows.entry.js","sourceRoot":"","sources":["../../../../../lib/v3/dom/rerenderMissingShadows.entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,0BAA0B,EAAE,CAAC","sourcesContent":["import { rerenderMissingShadowHosts } from \"./rerenderMissingShadows.runtime.js\";\n\nrerenderMissingShadowHosts();\n"]}

package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.d.ts

@@ -0,0 +1 @@
+export declare function rerenderMissingShadowHosts(): void;

package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.js

@@ -0,0 +1,40 @@
+export function rerenderMissingShadowHosts() {
+    try {
+        const piercer = window.__stagehandV3__;
+        if (!piercer || typeof piercer.getClosedRoot !== "function")
+            return;
+        const needsReset = [];
+        const walker = document.createTreeWalker(document, NodeFilter.SHOW_ELEMENT);
+        while (walker.nextNode()) {
+            const el = walker.currentNode;
+            const tag = el.tagName?.toLowerCase() ?? "";
+            if (!tag.includes("-"))
+                continue;
+            if (typeof customElements?.get !== "function")
+                continue;
+            if (!customElements.get(tag))
+                continue;
+            const hasOpen = !!el.shadowRoot;
+            const hasClosed = !!piercer.getClosedRoot(el);
+            if (hasOpen || hasClosed)
+                continue;
+            needsReset.push(el);
+        }
+        for (const host of needsReset) {
+            try {
+                const clone = host.cloneNode(true);
+                host.replaceWith(clone);
+            }
+            catch {
+                // ignore individual failures
+            }
+        }
+        if (piercer.stats && needsReset.length) {
+            console.info("[v3-piercer] rerender", { count: needsReset.length });
+        }
+    }
+    catch (err) {
+        console.info("[v3-piercer] rerender error", { message: String(err ?? "") });
+    }
+}
+//# sourceMappingURL=rerenderMissingShadows.runtime.js.map

package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerenderMissingShadows.runtime.js","sourceRoot":"","sources":["../../../../../lib/v3/dom/rerenderMissingShadows.runtime.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,0BAA0B;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC;QACvC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU;YAAE,OAAO;QAEpE,MAAM,UAAU,GAAc,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,MAAM,CAAC,WAAsB,CAAC;YACzC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,SAAS;YACjC,IAAI,OAAO,cAAc,EAAE,GAAG,KAAK,UAAU;gBAAE,SAAS;YACxD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACvC,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC;YAChC,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,OAAO,IAAI,SAAS;gBAAE,SAAS;YACnC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC","sourcesContent":["export function rerenderMissingShadowHosts(): void {\n  try {\n    const piercer = window.__stagehandV3__;\n    if (!piercer || typeof piercer.getClosedRoot !== \"function\") return;\n\n    const needsReset: Element[] = [];\n    const walker = document.createTreeWalker(document, NodeFilter.SHOW_ELEMENT);\n    while (walker.nextNode()) {\n      const el = walker.currentNode as Element;\n      const tag = el.tagName?.toLowerCase() ?? \"\";\n      if (!tag.includes(\"-\")) continue;\n      if (typeof customElements?.get !== \"function\") continue;\n      if (!customElements.get(tag)) continue;\n      const hasOpen = !!el.shadowRoot;\n      const hasClosed = !!piercer.getClosedRoot(el);\n      if (hasOpen || hasClosed) continue;\n      needsReset.push(el);\n    }\n\n    for (const host of needsReset) {\n      try {\n        const clone = host.cloneNode(true);\n        host.replaceWith(clone);\n      } catch {\n        // ignore individual failures\n      }\n    }\n\n    if (piercer.stats && needsReset.length) {\n      console.info(\"[v3-piercer] rerender\", { count: needsReset.length });\n    }\n  } catch (err) {\n    console.info(\"[v3-piercer] rerender error\", { message: String(err ?? \"\") });\n  }\n}\n"]}

package/dist/esm/lib/v3/dom/screenshotScripts/index.d.ts

@@ -0,0 +1 @@
+export { resolveMaskRect } from "./resolveMaskRect.js";

package/dist/esm/lib/v3/dom/screenshotScripts/index.js

@@ -0,0 +1,2 @@
+export { resolveMaskRect } from "./resolveMaskRect.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/v3/dom/screenshotScripts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/screenshotScripts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export { resolveMaskRect } from \"./resolveMaskRect.js\";\n"]}

package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.d.ts

@@ -0,0 +1,8 @@
+export type MaskRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rootToken?: string | null;
+};
+export declare function resolveMaskRect(this: Element | null, maskToken?: string): MaskRect | null;

package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.js

@@ -0,0 +1,82 @@
+export function resolveMaskRect(maskToken) {
+    function safeClosest(el, selector) {
+        try {
+            return el && typeof el.closest === "function"
+                ? el.closest(selector)
+                : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    function safeMatches(el, selector) {
+        try {
+            return !!el && typeof el.matches === "function" && el.matches(selector);
+        }
+        catch {
+            return false;
+        }
+    }
+    function findTopLayerRoot(el) {
+        const dialog = safeClosest(el, "dialog[open]");
+        if (dialog)
+            return dialog;
+        const popover = safeClosest(el, "[popover]");
+        if (popover && safeMatches(popover, ":popover-open"))
+            return popover;
+        return null;
+    }
+    if (!this || typeof this.getBoundingClientRect !== "function")
+        return null;
+    const rect = this.getBoundingClientRect();
+    if (!rect)
+        return null;
+    const style = window.getComputedStyle(this);
+    if (!style)
+        return null;
+    if (style.visibility === "hidden" || style.display === "none")
+        return null;
+    if (rect.width <= 0 || rect.height <= 0)
+        return null;
+    const root = findTopLayerRoot(this);
+    if (root) {
+        const rootRect = root.getBoundingClientRect();
+        if (!rootRect)
+            return null;
+        let rootToken = null;
+        if (maskToken) {
+            try {
+                const existing = root.getAttribute("data-stagehand-mask-root");
+                if (existing && existing.startsWith(maskToken)) {
+                    rootToken = existing;
+                }
+                else {
+                    rootToken =
+                        maskToken + "_root_" + Math.random().toString(36).slice(2);
+                    root.setAttribute("data-stagehand-mask-root", rootToken);
+                }
+            }
+            catch {
+                rootToken = null;
+            }
+        }
+        return {
+            x: rect.left -
+                rootRect.left -
+                (root.clientLeft || 0) +
+                (root.scrollLeft || 0),
+            y: rect.top - rootRect.top - (root.clientTop || 0) + (root.scrollTop || 0),
+            width: rect.width,
+            height: rect.height,
+            rootToken,
+        };
+    }
+    return {
+        x: rect.left + window.scrollX,
+        y: rect.top + window.scrollY,
+        width: rect.width,
+        height: rect.height,
+        rootToken: null,
+    };
+}
+//# sourceMappingURL=resolveMaskRect.js.map

package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMaskRect.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/screenshotScripts/resolveMaskRect.ts"],"names":[],"mappings":"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","sourcesContent":["export type MaskRect = {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  rootToken?: string | null;\n};\n\nexport function resolveMaskRect(\n  this: Element | null,\n  maskToken?: string,\n): MaskRect | null {\n  function safeClosest(el: Element | null, selector: string): Element | null {\n    try {\n      return el && typeof el.closest === \"function\"\n        ? el.closest(selector)\n        : null;\n    } catch {\n      return null;\n    }\n  }\n\n  function safeMatches(el: Element | null, selector: string): boolean {\n    try {\n      return !!el && typeof el.matches === \"function\" && el.matches(selector);\n    } catch {\n      return false;\n    }\n  }\n\n  function findTopLayerRoot(el: Element | null): Element | null {\n    const dialog = safeClosest(el, \"dialog[open]\");\n    if (dialog) return dialog;\n    const popover = safeClosest(el, \"[popover]\");\n    if (popover && safeMatches(popover, \":popover-open\")) return popover;\n    return null;\n  }\n\n  if (!this || typeof this.getBoundingClientRect !== \"function\") return null;\n  const rect = this.getBoundingClientRect();\n  if (!rect) return null;\n  const style = window.getComputedStyle(this);\n  if (!style) return null;\n  if (style.visibility === \"hidden\" || style.display === \"none\") return null;\n  if (rect.width <= 0 || rect.height <= 0) return null;\n\n  const root = findTopLayerRoot(this);\n  if (root) {\n    const rootRect = root.getBoundingClientRect();\n    if (!rootRect) return null;\n    let rootToken: string | null = null;\n    if (maskToken) {\n      try {\n        const existing = root.getAttribute(\"data-stagehand-mask-root\");\n        if (existing && existing.startsWith(maskToken)) {\n          rootToken = existing;\n        } else {\n          rootToken =\n            maskToken + \"_root_\" + Math.random().toString(36).slice(2);\n          root.setAttribute(\"data-stagehand-mask-root\", rootToken);\n        }\n      } catch {\n        rootToken = null;\n      }\n    }\n    return {\n      x:\n        rect.left -\n        rootRect.left -\n        (root.clientLeft || 0) +\n        (root.scrollLeft || 0),\n      y:\n        rect.top - rootRect.top - (root.clientTop || 0) + (root.scrollTop || 0),\n      width: rect.width,\n      height: rect.height,\n      rootToken,\n    };\n  }\n\n  return {\n    x: rect.left + window.scrollX,\n    y: rect.top + window.scrollY,\n    width: rect.width,\n    height: rect.height,\n    rootToken: null,\n  };\n}\n"]}

package/dist/esm/lib/v3/external_clients/aisdk.d.ts

@@ -0,0 +1,11 @@
+import type { LanguageModelV2 } from "@ai-sdk/provider";
+import { CreateChatCompletionOptions, LLMClient } from "../llm/LLMClient.js";
+import { ChatCompletion } from "openai/resources";
+export declare class AISdkClient extends LLMClient {
+    type: "aisdk";
+    private model;
+    constructor({ model }: {
+        model: LanguageModelV2;
+    });
+    createChatCompletion<T = ChatCompletion>({ options, }: CreateChatCompletionOptions): Promise<T>;
+}