@xpert-ai/chatkit-host-automation 0.3.3 → 0.3.5

package/dist/index.js

@@ -1,4 +1,4 @@
-const z = [
+const it = [
   "host_page_snapshot",
   "host_page_click",
   "host_page_fill",
@@ -11,9 +11,9 @@ const z = [
   "host_page_pointer",
   "host_page_screenshot",
   "host_page_wait_for"
-], G = new Set(
-  z
-), K = [
+], rt = new Set(
+  it
+), st = [
   "a[href]",
   "button",
   "input",
@@ -28,116 +28,257 @@ const z = [
   "[data-testid]",
   "[data-test-id]",
   "[data-qa]"
-].join(","), D = 100, J = 1e4, Q = 6e4;
-function Z(t) {
-  return G.has(t);
+].join(","), X = 100, at = 1e4, ct = 6e4;
+function lt(t) {
+  return rt.has(t);
 }
-function g(t) {
+function T(t) {
   return t instanceof Document ? t : t.ownerDocument;
 }
 function N(t) {
-  return g(t).defaultView ?? window;
+  return T(t).defaultView ?? window;
 }
-function h(t) {
+function m(t) {
   return typeof t == "object" && t !== null && !Array.isArray(t) ? t : {};
 }
-function R(t, e) {
+function O(t, e) {
   if (typeof t != "string" || t.trim() === "")
     throw new Error(`${e} must be a non-empty string.`);
   return t;
 }
-function p(t) {
+function x(t) {
   return typeof t == "string" && t.trim() ? t : void 0;
 }
-function tt(t) {
+function ut(t) {
+  return t === "viewport_normalized" ? "viewport_normalized" : "viewport-css-px";
+}
+function U(t, e) {
+  const n = z(e.x, "x"), o = z(e.y, "y");
+  if (ut(e.coordinateSpace) === "viewport_normalized") {
+    const i = N(t);
+    return {
+      x: Number((n * i.innerWidth).toFixed(3)),
+      y: Number((o * i.innerHeight).toFixed(3))
+    };
+  }
+  return { x: n, y: o };
+}
+function dt(t) {
   return typeof t == "number" && Number.isInteger(t) ? t : void 0;
 }
-function M(t, e) {
+function z(t, e) {
   if (typeof t != "number" || !Number.isFinite(t))
     throw new Error(`${e} must be a finite number.`);
   return t;
 }
-function T(t) {
+function k(t) {
   return typeof t == "number" && Number.isFinite(t) ? t : void 0;
 }
-function F(t, e) {
+function Y(t, e) {
   return typeof t == "string" && e.includes(t) ? t : void 0;
 }
-function et(t) {
+function ft(t) {
   if (typeof t == "string")
     return [t];
   if (Array.isArray(t) && t.every((e) => typeof e == "string"))
     return t;
   throw new Error("value or values must be a string or an array of strings.");
 }
-function v(t) {
+function b(t) {
   const e = (t.textContent ?? "").replace(/\s+/g, " ").trim();
   return e ? e.slice(0, 160) : void 0;
 }
-function V(t) {
+function P(t) {
   const e = Array.from(t.childNodes).filter((n) => n.nodeType === Node.TEXT_NODE).map((n) => n.textContent ?? "").join(" ").replace(/\s+/g, " ").trim();
   return e ? e.slice(0, 160) : void 0;
 }
-function nt(t) {
+function F(t) {
   if (t instanceof HTMLInputElement || t instanceof HTMLTextAreaElement || t instanceof HTMLSelectElement)
     return t.value;
 }
-function E(t) {
-  const e = t.getAttribute("aria-label");
-  if (e != null && e.trim())
-    return e.trim();
-  const n = t.getAttribute("title");
-  if (n != null && n.trim())
-    return n.trim();
-  if (t instanceof HTMLInputElement) {
-    const r = Array.from(t.labels ?? []).map((c) => v(c)).filter(Boolean);
-    if (r.length > 0)
-      return r.join(" ").slice(0, 160);
+function Q(t) {
+  return t instanceof HTMLInputElement && (t.type === "checkbox" || t.type === "radio");
+}
+function pt(t) {
+  return t instanceof HTMLInputElement || t instanceof HTMLSelectElement || t instanceof HTMLTextAreaElement ? Array.from(t.labels ?? []) : [];
+}
+function ht(t, e) {
+  var o;
+  return (((o = t.getAttribute(e)) == null ? void 0 : o.trim().split(/\s+/)) ?? []).map((i) => t.ownerDocument.getElementById(i)).filter((i) => !!i).map((i) => b(i)).filter((i) => !!i);
+}
+function gt(t) {
+  const e = ht(t, "aria-labelledby");
+  if (e.length > 0)
+    return e.join(" ").slice(0, 160);
+  const n = pt(t).map((o) => b(o)).filter((o) => !!o);
+  if (n.length > 0)
+    return n.join(" ").slice(0, 160);
+}
+function bt(t) {
+  const e = [];
+  let n = t.nextSibling;
+  for (; n; ) {
+    if (n.nodeType === Node.TEXT_NODE) {
+      const i = (n.textContent ?? "").replace(/\s+/g, " ").trim();
+      i && e.push(i);
+    } else {
+      if (n.nodeType === Node.ELEMENT_NODE && n.tagName.toLowerCase() === "br")
+        break;
+      if (n.nodeType === Node.ELEMENT_NODE) {
+        const i = n;
+        if (i.matches(
+          'input,textarea,select,button,a[href],[role="button"],[role="link"]'
+        ))
+          break;
+        const s = b(i);
+        s && e.push(s);
+        break;
+      }
+    }
+    if (e.join(" ").length >= 120)
+      break;
+    n = n.nextSibling;
+  }
+  const o = e.join(" ").replace(/\s+/g, " ").trim();
+  return o ? o.slice(0, 160) : void 0;
+}
+function G(t, e) {
+  var d;
+  const n = t.ownerDocument, o = n.body;
+  if (!o)
+    return;
+  const i = t.getBoundingClientRect();
+  if (i.width <= 0 || i.height <= 0)
+    return;
+  const s = i.top + i.height / 2, r = [], a = n.createTreeWalker(o, NodeFilter.SHOW_ELEMENT);
+  let c = a.nextNode();
+  for (; c; ) {
+    const u = c;
+    if (u !== t && !u.contains(t) && j(u)) {
+      const l = u.getBoundingClientRect(), f = P(u) ?? b(u);
+      if (f) {
+        const p = l.top + l.height / 2, y = Math.abs(p - s) <= Math.max(28, i.height * 1.25), h = e === "left" ? i.left - l.right : l.left - i.right;
+        y && h >= -8 && h <= 240 && r.push({
+          text: f,
+          score: Math.abs(h) + Math.abs(p - s)
+        });
+      }
+    }
+    c = a.nextNode();
   }
-  const o = X(t)[0];
-  return o || v(t);
+  return (d = r.sort((u, l) => u.score - l.score)[0]) == null ? void 0 : d.text;
 }
-function ot(t) {
-  if (!(t instanceof HTMLElement || t instanceof SVGElement) || !m(t) || t.matches(
+function H(t) {
+  if (!(t instanceof HTMLInputElement || t instanceof HTMLSelectElement || t instanceof HTMLTextAreaElement))
+    return;
+  const e = gt(t);
+  return e || (Q(t) ? G(t, "right") ?? bt(t) ?? C(t)[0] : G(t, "left") ?? C(t)[0]);
+}
+function K(t, e) {
+  const n = e.trim().toLowerCase();
+  return t instanceof HTMLInputElement && t.type === "radio" ? n === "radio" || n === "radio button" : t instanceof HTMLInputElement && t.type === "checkbox" ? n === "checkbox" || n === "check box" : t instanceof HTMLSelectElement ? n === "select" || n === "select menu" || n === "combobox" || n === "combo box" : !1;
+}
+function v(t) {
+  const e = H(t), n = t.getAttribute("aria-label");
+  if (n != null && n.trim() && !K(t, n))
+    return n.trim();
+  const o = t.getAttribute("title");
+  if (o != null && o.trim() && !K(t, o))
+    return o.trim();
+  if (e)
+    return e;
+  const i = C(t)[0];
+  return i || b(t);
+}
+function j(t) {
+  if (!(t instanceof HTMLElement || t instanceof SVGElement) || !_(t) || t.matches(
     'input,textarea,select,button,a[href],[role="button"],[role="link"]'
   ))
     return !1;
-  const e = V(t) ?? v(t);
+  const e = P(t) ?? b(t);
   return !!(e && e.length <= 120);
 }
-function X(t) {
+function Z(t) {
+  var l;
+  if (!Q(t))
+    return;
+  const e = t.closest("fieldset"), n = e == null ? void 0 : e.querySelector("legend"), o = n ? b(n) : void 0;
+  if (o)
+    return o;
+  const i = t.ownerDocument, s = i.body;
+  if (!s)
+    return;
+  const r = t.getBoundingClientRect();
+  if (r.width <= 0 || r.height <= 0)
+    return;
+  const a = r.left + r.width / 2, c = [], d = i.createTreeWalker(s, NodeFilter.SHOW_ELEMENT);
+  let u = d.nextNode();
+  for (; u; ) {
+    const f = u;
+    if (f !== t && !f.contains(t) && f.matches('legend,strong,b,[role="heading"],h1,h2,h3,h4,h5,h6') && j(f)) {
+      const p = f.getBoundingClientRect(), y = P(f) ?? b(f);
+      if (y && p.bottom <= r.top + 8) {
+        const h = r.top - p.bottom, E = p.left + p.width / 2;
+        h <= 160 && E >= r.left - 120 && E <= r.right + 320 && c.push({
+          text: y,
+          score: h + Math.abs(E - a) * 0.25
+        });
+      }
+    }
+    u = d.nextNode();
+  }
+  return (l = c.sort((f, p) => f.score - p.score)[0]) == null ? void 0 : l.text;
+}
+function yt(t) {
+  if (!(t instanceof HTMLSelectElement))
+    return;
+  const e = Array.from(t.options).map((n) => ({
+    label: ((n.label || n.textContent || n.value).replace(/\s+/g, " ").trim() || n.value).slice(0, 160),
+    value: n.value,
+    selected: n.selected || void 0,
+    disabled: n.disabled || void 0
+  }));
+  return e.length ? e : void 0;
+}
+function Et(t) {
+  if (!(t instanceof HTMLSelectElement))
+    return;
+  const e = t.selectedOptions[0], n = e ? (e.label || e.textContent || e.value).replace(/\s+/g, " ").trim() : void 0;
+  return n ? n.slice(0, 160) : void 0;
+}
+function C(t) {
   const e = t.ownerDocument, n = e.body;
   if (!n)
     return [];
   const o = t.getBoundingClientRect();
   if (o.width <= 0 || o.height <= 0)
     return [];
-  const r = o.top + o.height / 2, c = o.left + o.width / 2, s = [], i = e.createTreeWalker(n, NodeFilter.SHOW_ELEMENT);
-  let a = i.nextNode();
-  for (; a; ) {
-    const l = a;
-    if (l !== t && ot(l)) {
-      const u = l.getBoundingClientRect(), f = V(l) ?? v(l);
+  const i = o.top + o.height / 2, s = o.left + o.width / 2, r = [], a = e.createTreeWalker(n, NodeFilter.SHOW_ELEMENT);
+  let c = a.nextNode();
+  for (; c; ) {
+    const u = c;
+    if (u !== t && !u.contains(t) && j(u)) {
+      const l = u.getBoundingClientRect(), f = P(u) ?? b(u);
       if (f) {
-        const b = u.top + u.height / 2, w = u.left + u.width / 2, y = u.right <= o.left + 12 && Math.abs(b - r) <= Math.max(28, o.height * 1.25), S = u.bottom <= o.top + 8 && o.top - u.bottom <= 80 && w >= o.left - 80 && w <= o.right + 80;
-        if (y || S) {
-          const j = y ? o.left - u.right + Math.abs(b - r) : o.top - u.bottom + Math.abs(w - c);
-          s.push({
+        const p = l.top + l.height / 2, y = l.left + l.width / 2, h = l.right <= o.left + 12 && Math.abs(p - i) <= Math.max(28, o.height * 1.25), E = l.left >= o.right - 8 && l.left - o.right <= 240 && Math.abs(p - i) <= Math.max(28, o.height * 1.25), W = l.bottom <= o.top + 8 && o.top - l.bottom <= 80 && y >= o.left - 80 && y <= o.right + 80;
+        if (h || E || W) {
+          const ot = h ? o.left - l.right + Math.abs(p - i) : E ? l.left - o.right + Math.abs(p - i) : o.top - l.bottom + Math.abs(y - s);
+          r.push({
             text: f,
-            score: j + (y ? 0 : 100)
+            score: ot + (h ? 0 : E ? 5 : 100)
           });
         }
       }
     }
-    a = i.nextNode();
+    c = a.nextNode();
   }
   const d = /* @__PURE__ */ new Set();
-  return s.sort((l, u) => l.score - u.score).map((l) => l.text).filter((l) => d.has(l) ? !1 : (d.add(l), !0)).slice(0, 4);
+  return r.sort((u, l) => u.score - l.score).map((u) => u.text).filter((u) => d.has(u) ? !1 : (d.add(u), !0)).slice(0, 4);
 }
-function rt(t) {
+function mt(t) {
   return t.getAttribute("data-testid") ?? t.getAttribute("data-test-id") ?? t.getAttribute("data-qa") ?? void 0;
 }
-function x(t) {
+function S(t) {
   const e = t.getAttribute("role");
   if (e != null && e.trim())
     return e.trim();
@@ -161,65 +302,65 @@ function x(t) {
         return "textbox";
     }
 }
-function q(t) {
+function tt(t) {
   return t instanceof HTMLButtonElement || t instanceof HTMLInputElement || t instanceof HTMLSelectElement || t instanceof HTMLTextAreaElement ? t.disabled || void 0 : t.getAttribute("aria-disabled") === "true" || void 0;
 }
-function it(t) {
+function wt(t) {
   return t instanceof HTMLInputElement && (t.type === "checkbox" || t.type === "radio") ? t.checked : void 0;
 }
-function st(t) {
-  const e = k(t);
+function vt(t) {
+  const e = A(t);
   if (!(e.width <= 0 || e.height <= 0))
     return {
       x: e.x + e.width / 2,
       y: e.y + e.height / 2
     };
 }
-function $(t) {
+function V(t) {
   return {
     tag: t.tagName.toLowerCase(),
-    role: x(t),
-    name: E(t),
-    selector: P(t)
+    role: S(t),
+    name: v(t),
+    selector: q(t)
   };
 }
-function m(t) {
+function _(t) {
   if (!(t instanceof HTMLElement || t instanceof SVGElement) || t instanceof HTMLElement && t.hidden)
     return !1;
   const e = t.ownerDocument.defaultView, n = e == null ? void 0 : e.getComputedStyle(t);
   return !(n && (n.display === "none" || n.visibility === "hidden" || n.opacity === "0"));
 }
-function U(t) {
-  return t.matches(K) && m(t);
+function et(t) {
+  return t.matches(st) && _(t);
 }
-function ct(t) {
-  return q(t) !== !0;
+function xt(t) {
+  return tt(t) !== !0;
 }
-function at(t) {
+function Tt(t) {
   var n;
-  if (U(t))
+  if (et(t))
     return !0;
   if (!(t instanceof HTMLElement))
     return !1;
   const e = (n = t.ownerDocument.defaultView) == null ? void 0 : n.getComputedStyle(t);
-  return ((e == null ? void 0 : e.cursor) === "pointer" || !!t.onclick) && m(t);
+  return ((e == null ? void 0 : e.cursor) === "pointer" || !!t.onclick) && _(t);
 }
-function k(t) {
-  var c, s;
+function A(t) {
+  var s, r;
   const e = t.getBoundingClientRect();
-  let n = e.left, o = e.top, r = null;
+  let n = e.left, o = e.top, i = null;
   try {
-    r = ((c = t.ownerDocument.defaultView) == null ? void 0 : c.frameElement) ?? null;
+    i = ((s = t.ownerDocument.defaultView) == null ? void 0 : s.frameElement) ?? null;
   } catch {
-    r = null;
+    i = null;
   }
-  for (; r; ) {
-    const i = r.getBoundingClientRect();
-    n += i.left, o += i.top;
+  for (; i; ) {
+    const a = i.getBoundingClientRect();
+    n += a.left, o += a.top;
     try {
-      r = ((s = r.ownerDocument.defaultView) == null ? void 0 : s.frameElement) ?? null;
+      i = ((r = i.ownerDocument.defaultView) == null ? void 0 : r.frameElement) ?? null;
     } catch {
-      r = null;
+      i = null;
     }
   }
   return {
@@ -229,21 +370,21 @@ function k(t) {
     height: e.height
   };
 }
-function P(t) {
+function q(t) {
   const e = (o) => typeof CSS < "u" && typeof CSS.escape == "function" ? CSS.escape(o) : o.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
   if (t.id)
     return `#${e(t.id)}`;
   for (const o of ["data-testid", "data-test-id", "data-qa"]) {
-    const r = t.getAttribute(o);
-    if (r)
-      return `[${o}="${e(r)}"]`;
+    const i = t.getAttribute(o);
+    if (i)
+      return `[${o}="${e(i)}"]`;
   }
   const n = t.getAttribute("name");
   return n ? `${t.tagName.toLowerCase()}[name="${e(
     n
   )}"]` : t.tagName.toLowerCase();
 }
-function lt(t) {
+function _t(t) {
   const e = t.getBoundingClientRect();
   if (!(e.width <= 0 || e.height <= 0))
     return {
@@ -251,7 +392,7 @@ function lt(t) {
       y: e.top + e.height / 2
     };
 }
-function W(t, e) {
+function nt(t, e) {
   if (typeof t.elementsFromPoint == "function")
     return t.elementsFromPoint(e.x, e.y);
   if (typeof t.elementFromPoint != "function")
@@ -259,25 +400,25 @@ function W(t, e) {
   const n = t.elementFromPoint(e.x, e.y);
   return n ? [n] : [];
 }
-function ut(t) {
+function St(t) {
   return typeof t.elementsFromPoint == "function" || typeof t.elementFromPoint == "function";
 }
-function C(t, e) {
+function R(t, e) {
   return t === e || t.contains(e);
 }
-function ft(t) {
+function kt(t) {
   let e = t;
   for (; e; ) {
-    if (at(e))
+    if (Tt(e))
       return e;
     e = e.parentElement;
   }
   return t;
 }
-function B(t) {
+function J(t) {
   return (t ?? "").replace(/\([^)]*\)/g, "").replace(/\s+/g, "").trim().toLowerCase();
 }
-function Y(t) {
+function B(t) {
   const e = t.getBoundingClientRect();
   if (e.width <= 0 || e.height <= 0)
     return;
@@ -289,93 +430,158 @@ function Y(t) {
     { x: e.left + e.width / 2, y: e.top + Math.min(8, e.height / 2) },
     { x: e.left + e.width / 2, y: e.bottom - Math.min(8, e.height / 2) }
   ].find(
-    (r) => W(n, r).some(
-      (c) => C(t, c) || C(c, t)
+    (i) => nt(n, i).some(
+      (s) => R(t, s) || R(s, t)
     )
   );
 }
-function dt(t, e) {
-  var c;
-  const n = x(e), o = B(E(e));
-  return o ? ((c = I(t).filter((s) => s !== e).filter((s) => {
-    const i = x(s), a = B(E(s));
-    return n && i && n !== i ? !1 : a.includes(o) || o.includes(a);
-  }).map((s) => ({
-    candidate: s,
-    point: Y(s),
-    rect: k(s)
+function Mt(t, e) {
+  const n = t.getBoundingClientRect(), o = A(t);
+  return {
+    x: e.x + o.x - n.left,
+    y: e.y + o.y - n.top
+  };
+}
+function Lt(t, e) {
+  var s;
+  const n = S(e), o = J(v(e));
+  return o ? ((s = $(t).filter((r) => r !== e).filter((r) => {
+    const a = S(r), c = J(v(r));
+    return n && a && n !== a ? !1 : c.includes(o) || o.includes(c);
+  }).map((r) => ({
+    candidate: r,
+    point: B(r),
+    rect: A(r)
   })).filter(
-    (s) => !!s.point
-  ).sort((s, i) => i.rect.y - s.rect.y)[0]) == null ? void 0 : c.candidate) ?? null : null;
+    (r) => !!r.point
+  ).sort((r, a) => a.rect.y - r.rect.y)[0]) == null ? void 0 : s.candidate) ?? null : null;
 }
-function L(t) {
-  const e = t.ownerDocument, n = lt(t), o = m(t) && !!n, r = ct(t), c = n ? W(e, n) : [], s = c[0], i = !!(s && (C(t, s) || C(s, t)));
+function g(t) {
+  const e = t.ownerDocument, n = _t(t), o = _(t) && !!n, i = xt(t), s = n ? nt(e, n) : [], r = s[0], a = !!(r && (R(t, r) || R(r, t)));
   return {
     visible: o,
-    enabled: r,
-    receivesEvents: i,
-    actionable: o && r && i,
-    center: st(t),
-    hitTarget: s,
-    hitStack: c
+    enabled: i,
+    receivesEvents: a,
+    actionable: o && i && a,
+    center: vt(t),
+    hitTarget: r,
+    hitStack: s
   };
 }
-function ht(t, e) {
-  var i, a, d;
-  const n = p(e.testId);
+function Ct(t, e) {
+  var a, c, d;
+  const n = x(e.testId);
   if (n) {
-    const l = typeof CSS < "u" && typeof CSS.escape == "function" ? CSS.escape(n) : n.replaceAll("\\", "\\\\").replaceAll('"', '\\"'), u = t.querySelector(
-      `[data-testid="${l}"],[data-test-id="${l}"],[data-qa="${l}"]`
+    const u = typeof CSS < "u" && typeof CSS.escape == "function" ? CSS.escape(n) : n.replaceAll("\\", "\\\\").replaceAll('"', '\\"'), l = t.querySelector(
+      `[data-testid="${u}"],[data-test-id="${u}"],[data-qa="${u}"]`
     );
-    if (u)
-      return u;
-  }
-  const o = (i = p(e.role)) == null ? void 0 : i.toLowerCase(), r = (a = p(e.name)) == null ? void 0 : a.toLowerCase(), c = (d = p(e.text)) == null ? void 0 : d.toLowerCase();
-  return !o && !r && !c ? null : I(t).find((l) => {
-    var w, y, S;
-    const u = (w = x(l)) == null ? void 0 : w.toLowerCase(), f = (y = E(l)) == null ? void 0 : y.toLowerCase(), b = (S = v(l)) == null ? void 0 : S.toLowerCase();
-    return !(o && u !== o || r && !(f != null && f.includes(r)) || c && !(b != null && b.includes(c)));
+    if (l)
+      return l;
+  }
+  const o = (a = x(e.role)) == null ? void 0 : a.toLowerCase(), i = (c = x(e.name)) == null ? void 0 : c.toLowerCase(), s = (d = x(e.text)) == null ? void 0 : d.toLowerCase();
+  return !o && !i && !s ? null : $(t).find((u) => {
+    var y, h, E;
+    const l = (y = S(u)) == null ? void 0 : y.toLowerCase(), f = (h = v(u)) == null ? void 0 : h.toLowerCase(), p = (E = b(u)) == null ? void 0 : E.toLowerCase();
+    return !(o && l !== o || i && !(f != null && f.includes(i)) || s && !(p != null && p.includes(s)));
   }) ?? null;
 }
-function I(t) {
-  const e = g(t), n = t instanceof Document ? t.body ?? t.documentElement : t;
+function At(t) {
+  return [
+    v(t),
+    H(t),
+    Z(t),
+    b(t),
+    F(t)
+  ].filter((e) => !!e).join(" ").toLowerCase();
+}
+function Nt(t, e) {
+  const n = e.trim().toLowerCase();
+  let o = t, i = 0;
+  for (; o && i < 5; ) {
+    const s = o.tagName.toLowerCase();
+    if (s === "body" || s === "html")
+      return !1;
+    if (At(o).includes(n))
+      return !0;
+    o = o.parentElement, i += 1;
+  }
+  return !1;
+}
+function Rt(t) {
+  if (!t || typeof t != "object" || Array.isArray(t))
+    return;
+  const e = t;
+  if (e.type === "field_contains" && typeof e.field == "string" && e.field.trim() && typeof e.value == "string")
+    return {
+      type: "field_contains",
+      field: e.field,
+      value: e.value
+    };
+}
+function Pt(t, e) {
+  const n = e.trim().toLowerCase();
+  return Array.from(t.querySelectorAll("input,textarea,select")).find(
+    (o) => [
+      H(o),
+      v(o),
+      o.getAttribute("name") ?? void 0,
+      o.getAttribute("placeholder") ?? void 0,
+      ...C(o)
+    ].some(
+      (s) => s == null ? void 0 : s.trim().toLowerCase().includes(n)
+    )
+  );
+}
+function Ht(t, e) {
+  if (!e)
+    return;
+  const n = Pt(t, e.field), o = n ? F(n) ?? "" : void 0;
+  return {
+    ...e,
+    ok: typeof o == "string" && o.toLowerCase().includes(e.value.toLowerCase()),
+    actual: o,
+    matchedField: n ? V(n) : void 0
+  };
+}
+function $(t) {
+  const e = t instanceof Element ? t.ownerDocument : T(t), n = t instanceof Document ? t.body ?? t.documentElement : t;
   if (!n)
     return [];
-  const o = [], r = (c) => {
-    const s = e.createTreeWalker(c, NodeFilter.SHOW_ELEMENT);
-    let i = s.nextNode();
-    for (; i; ) {
-      const a = i;
-      U(a) && o.push(a);
-      const d = a.shadowRoot;
-      if (d && r(d), a instanceof HTMLIFrameElement)
+  const o = [], i = (s) => {
+    const r = e.createTreeWalker(s, NodeFilter.SHOW_ELEMENT);
+    let a = r.nextNode();
+    for (; a; ) {
+      const c = a;
+      et(c) && o.push(c);
+      const d = c.shadowRoot;
+      if (d && i(d), c instanceof HTMLIFrameElement)
         try {
-          a.contentDocument && r(a.contentDocument);
+          c.contentDocument && i(c.contentDocument);
         } catch {
         }
-      if (o.length >= D)
+      if (o.length >= X)
         return;
-      i = s.nextNode();
+      a = r.nextNode();
     }
   };
-  return r(n), o.slice(0, D);
+  return i(n), o.slice(0, X);
 }
-function gt(t, e) {
-  var r;
+function Ot(t, e) {
+  var i;
   const n = Object.getPrototypeOf(t), o = Object.getOwnPropertyDescriptor(n, "value");
-  (r = o == null ? void 0 : o.set) == null || r.call(t, e);
+  (i = o == null ? void 0 : o.set) == null || i.call(t, e);
 }
-function H(t) {
+function I(t) {
   t.dispatchEvent(new Event("input", { bubbles: !0 })), t.dispatchEvent(new Event("change", { bubbles: !0 }));
 }
-function A(t) {
+function M(t) {
   var e, n;
   (t instanceof HTMLElement || t instanceof SVGElement) && ((e = t.scrollIntoView) == null || e.call(t, { block: "center", inline: "center" })), t instanceof HTMLElement && ((n = t.focus) == null || n.call(t));
 }
-function _(t, e) {
+function L(t, e) {
   return typeof PointerEvent == "function" ? new PointerEvent(t, e) : new MouseEvent(t.replace("pointer", "mouse"), e);
 }
-class pt {
+class It {
   constructor(e = {}) {
     this.options = e, this.refs = /* @__PURE__ */ new Map(), this.nextRef = 1;
   }
@@ -410,10 +616,10 @@ class pt {
     }
   }
   snapshot() {
-    var c, s;
+    var s, r;
     this.refs.clear(), this.nextRef = 1;
-    const e = this.getRoot(), n = g(e), o = N(e), r = I(e).map(
-      (i) => this.snapshotElement(i)
+    const e = this.getRoot(), n = T(e), o = N(e), i = $(e).map(
+      (a) => this.snapshotElement(a)
     );
     return {
       url: o.location.href,
@@ -438,28 +644,28 @@ class pt {
         readyState: n.readyState,
         visibilityState: n.visibilityState,
         focusedElement: n.activeElement && n.activeElement !== n.body ? this.snapshotElementWithoutRef(n.activeElement) : void 0,
-        selection: ((s = (c = n.getSelection) == null ? void 0 : c.call(n)) == null ? void 0 : s.toString()) || void 0
+        selection: ((r = (s = n.getSelection) == null ? void 0 : s.call(n)) == null ? void 0 : r.toString()) || void 0
       },
       navigation: this.getNavigationState(o),
       frames: this.getFrameState(n),
-      accessibility: r.map((i) => ({
-        ref: i.ref,
-        role: i.role,
-        name: i.name,
-        value: i.value,
-        disabled: i.disabled,
-        checked: i.checked,
-        focused: n.activeElement === this.refs.get(i.ref)
+      accessibility: i.map((a) => ({
+        ref: a.ref,
+        role: a.role,
+        name: a.name,
+        value: a.value,
+        disabled: a.disabled,
+        checked: a.checked,
+        focused: n.activeElement === this.refs.get(a.ref)
       })),
-      elements: r
+      elements: i
     };
   }
   getRoot() {
     return this.options.root ?? document;
   }
   getNavigationState(e) {
-    var o, r, c;
-    const n = (c = (r = (o = e.performance) == null ? void 0 : o.getEntriesByType) == null ? void 0 : r.call(o, "navigation")) == null ? void 0 : c[0];
+    var o, i, s;
+    const n = (s = (i = (o = e.performance) == null ? void 0 : o.getEntriesByType) == null ? void 0 : i.call(o, "navigation")) == null ? void 0 : s[0];
     if (!(typeof PerformanceNavigationTiming != "function" || !(n instanceof PerformanceNavigationTiming)))
       return {
         type: n.type,
@@ -470,12 +676,12 @@ class pt {
   }
   getFrameState(e) {
     return Array.from(e.querySelectorAll("iframe")).map((n) => {
-      var r, c;
-      const o = k(n);
+      var i, s;
+      const o = A(n);
       try {
         return {
-          url: (r = n.contentWindow) == null ? void 0 : r.location.href,
-          title: (c = n.contentDocument) == null ? void 0 : c.title,
+          url: (i = n.contentWindow) == null ? void 0 : i.location.href,
+          title: (s = n.contentDocument) == null ? void 0 : s.title,
           sameOrigin: !0,
           rect: o
         };
@@ -496,179 +702,282 @@ class pt {
     return this.createElementSnapshot(e, "");
   }
   createElementSnapshot(e, n) {
-    const o = (e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement) && e.placeholder || void 0, r = L(e);
+    const o = (e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement) && e.placeholder || void 0, i = g(e);
     return {
       ref: n,
       tag: e.tagName.toLowerCase(),
-      role: x(e),
-      name: E(e),
-      text: v(e),
-      nearbyText: X(e),
-      testId: rt(e),
-      value: nt(e),
+      role: S(e),
+      name: v(e),
+      label: H(e),
+      groupLabel: Z(e),
+      text: b(e),
+      nearbyText: C(e),
+      testId: mt(e),
+      value: F(e),
+      selectedLabel: Et(e),
+      options: yt(e),
       placeholder: o,
-      selector: P(e),
-      disabled: q(e),
-      enabled: r.enabled,
-      checked: it(e),
-      visible: r.visible,
-      actionable: r.actionable,
-      rect: k(e),
-      center: r.center,
-      hitTarget: r.hitTarget ? $(r.hitTarget) : void 0,
-      hitStack: r.hitStack.slice(0, 5).map($)
+      selector: q(e),
+      disabled: tt(e),
+      enabled: i.enabled,
+      checked: wt(e),
+      visible: i.visible,
+      actionable: i.actionable,
+      rect: A(e),
+      center: i.center,
+      hitTarget: i.hitTarget ? V(i.hitTarget) : void 0,
+      hitStack: i.hitStack.slice(0, 5).map(V)
     };
   }
   resolveElement(e) {
-    const n = p(e.ref) ?? p(e.axRef);
+    const n = x(e.ref) ?? x(e.axRef);
     if (n) {
-      const c = this.refs.get(n);
-      if (!c)
+      const s = this.refs.get(n);
+      if (!s)
         throw new Error(`Unknown element ref: ${n}. Take a new snapshot.`);
-      return c;
+      return s;
     }
-    const o = p(e.selector);
+    const o = x(e.selector);
     if (o) {
-      const c = this.getRoot().querySelector(o);
-      if (!c)
+      const s = this.getRoot().querySelector(o);
+      if (!s)
         throw new Error(`No element matches selector: ${o}.`);
-      return c;
+      return s;
     }
-    const r = ht(this.getRoot(), e);
-    if (r)
-      return r;
+    const i = Ct(this.getRoot(), e);
+    if (i)
+      return i;
     if (typeof e.x < "u" || typeof e.y < "u") {
-      const c = {
-        x: M(e.x, "x"),
-        y: M(e.y, "y")
-      }, s = g(this.getRoot()).elementFromPoint(
-        c.x,
-        c.y
+      const s = U(this.getRoot(), e), r = T(this.getRoot()).elementFromPoint(
+        s.x,
+        s.y
       );
-      if (!s)
-        throw new Error(`No element found at (${c.x}, ${c.y}).`);
-      return s;
+      if (!r)
+        throw new Error(`No element found at (${s.x}, ${s.y}).`);
+      return r;
     }
     throw new Error(
       "Expected one of ref, selector, role/name/text/testId, or x/y."
     );
   }
-  click(e) {
-    const n = h(e), o = this.resolveElement(n), r = L(o), s = (r.actionable ? null : dt(this.getRoot(), o)) ?? ft(o), i = Y(s);
-    if (!i && !r.actionable && ut(o.ownerDocument))
+  async click(e) {
+    const n = m(e), o = this.resolveElement(n), i = g(o), r = (i.actionable ? null : Lt(this.getRoot(), o)) ?? kt(o);
+    if (!B(r) && !i.actionable && St(o.ownerDocument))
       throw new Error(
-        `Target "${E(o) ?? o.tagName.toLowerCase()}" is not receiving pointer events. Take a screenshot or use host_page_pointer coordinates.`
+        `Target "${v(o) ?? o.tagName.toLowerCase()}" is not receiving pointer events. Take a screenshot or use host_page_pointer coordinates.`
       );
-    return A(s), s instanceof HTMLElement ? s.click() : s.dispatchEvent(new MouseEvent("click", { bubbles: !0 })), {
-      clicked: this.describeElement(s),
+    M(r);
+    const c = B(r), d = g(r), u = g(o), l = c ? Mt(r, c) : d.center ?? i.center;
+    return l && await this.showVisualEffect({
+      type: "click",
+      point: l,
+      anchor: "target",
+      target: r,
+      requested: o
+    }), r instanceof HTMLElement ? r.click() : r.dispatchEvent(new MouseEvent("click", { bubbles: !0 })), {
+      clicked: this.describeElement(r),
       requested: this.describeElement(o),
-      strategy: s === o ? "dom" : "semantic_visible_fallback",
-      point: i ?? r.center,
+      strategy: r === o ? "dom" : "semantic_visible_fallback",
+      point: l,
       actionability: {
-        visible: r.visible,
-        enabled: r.enabled,
-        receivesEvents: r.receivesEvents
+        visible: u.visible,
+        enabled: u.enabled,
+        receivesEvents: u.receivesEvents
       }
     };
   }
-  fill(e) {
-    const n = h(e), o = R(n.value, "value"), r = this.resolveElement(n);
-    if (A(r), r instanceof HTMLInputElement || r instanceof HTMLTextAreaElement)
-      return gt(r, o), H(r), { filled: this.describeElement(r), value: o };
-    if (r instanceof HTMLElement && r.isContentEditable)
-      return r.textContent = o, H(r), { filled: this.describeElement(r), value: o };
+  async fill(e) {
+    const n = m(e), o = O(n.value, "value"), i = this.resolveElement(n);
+    if (M(i), i instanceof HTMLInputElement || i instanceof HTMLTextAreaElement)
+      return await this.showVisualEffect({
+        type: "fill",
+        target: i,
+        requested: i,
+        value: o,
+        anchor: "target",
+        point: g(i).center
+      }), Ot(i, o), I(i), { filled: this.describeElement(i), value: o };
+    if (i instanceof HTMLElement && i.isContentEditable)
+      return await this.showVisualEffect({
+        type: "fill",
+        target: i,
+        requested: i,
+        value: o,
+        anchor: "target",
+        point: g(i).center
+      }), i.textContent = o, I(i), { filled: this.describeElement(i), value: o };
     throw new Error("Target element cannot be filled.");
   }
-  press(e) {
-    const n = h(e), o = R(n.key, "key"), r = n.ref || n.selector || n.x !== void 0 && n.y !== void 0 ? this.resolveElement(n) : g(this.getRoot()).activeElement ?? g(this.getRoot()).body;
-    if (!r)
+  async press(e) {
+    const n = m(e), o = O(n.key, "key"), i = n.ref || n.selector || n.x !== void 0 && n.y !== void 0 ? this.resolveElement(n) : T(this.getRoot()).activeElement ?? T(this.getRoot()).body;
+    if (!i)
       throw new Error("No target element is available for key press.");
-    A(r);
-    const c = { key: o, bubbles: !0, cancelable: !0 };
-    return r.dispatchEvent(new KeyboardEvent("keydown", c)), o.length === 1 && r.dispatchEvent(new KeyboardEvent("keypress", c)), r.dispatchEvent(new KeyboardEvent("keyup", c)), { pressed: o, target: this.describeElement(r) };
+    M(i), await this.showVisualEffect({
+      type: "press",
+      target: i,
+      requested: i,
+      key: o,
+      anchor: "target",
+      point: g(i).center
+    });
+    const s = { key: o, bubbles: !0, cancelable: !0 };
+    return i.dispatchEvent(new KeyboardEvent("keydown", s)), o.length === 1 && i.dispatchEvent(new KeyboardEvent("keypress", s)), i.dispatchEvent(new KeyboardEvent("keyup", s)), { pressed: o, target: this.describeElement(i) };
   }
-  select(e) {
-    const n = h(e), o = et(n.values ?? n.value), r = this.resolveElement(n);
-    if (!(r instanceof HTMLSelectElement))
+  async select(e) {
+    const n = m(e), o = ft(n.values ?? n.value), i = this.resolveElement(n);
+    if (!(i instanceof HTMLSelectElement))
       throw new Error("Target element is not a select.");
-    const c = new Set(o);
-    for (const s of Array.from(r.options))
-      s.selected = c.has(s.value);
-    return H(r), {
-      selected: Array.from(r.selectedOptions).map(
-        (s) => s.value
+    M(i);
+    const s = new Set(o);
+    await this.showVisualEffect({
+      type: "select",
+      target: i,
+      requested: i,
+      values: o,
+      anchor: "target",
+      point: g(i).center
+    });
+    for (const r of Array.from(i.options))
+      r.selected = s.has(r.value);
+    return I(i), {
+      selected: Array.from(i.selectedOptions).map(
+        (r) => r.value
       ),
-      target: this.describeElement(r)
+      target: this.describeElement(i)
     };
   }
-  scroll(e) {
-    var a, d, l, u;
-    const n = h(e), o = n.x !== void 0 || n.y !== void 0 ? {
-      x: T(n.x) ?? 0,
-      y: T(n.y) ?? 0
-    } : null, r = T(n.deltaX) ?? 0, c = T(n.deltaY) ?? 0, s = this.getRoot(), i = N(s);
+  async scroll(e) {
+    var c, d, u, l;
+    const n = m(e), o = n.x !== void 0 || n.y !== void 0 ? {
+      x: k(n.x) ?? 0,
+      y: k(n.y) ?? 0
+    } : null, i = k(n.deltaX) ?? 0, s = k(n.deltaY) ?? 0, r = this.getRoot(), a = N(r);
     if (n.ref || n.selector || n.role || n.name || n.text || n.testId) {
       const f = this.resolveElement(n);
       if (!(f instanceof HTMLElement))
         throw new Error("Target element cannot be scrolled.");
-      return o ? (a = f.scrollTo) == null || a.call(f, o.x, o.y) : (d = f.scrollBy) == null || d.call(f, r, c), {
+      return await this.showVisualEffect({
+        type: "scroll",
+        target: f,
+        requested: f,
+        deltaX: i,
+        deltaY: s,
+        anchor: "target",
+        point: g(f).center
+      }), o ? (c = f.scrollTo) == null || c.call(f, o.x, o.y) : (d = f.scrollBy) == null || d.call(f, i, s), {
         scrolled: this.describeElement(f),
         scroll: { x: f.scrollLeft, y: f.scrollTop }
       };
     }
-    return o ? (l = i.scrollTo) == null || l.call(i, o.x, o.y) : (u = i.scrollBy) == null || u.call(i, r, c), { scroll: { x: i.scrollX, y: i.scrollY } };
+    return await this.showVisualEffect({
+      type: "scroll",
+      deltaX: i,
+      deltaY: s,
+      point: {
+        x: a.innerWidth / 2,
+        y: a.innerHeight / 2
+      }
+    }), o ? (u = a.scrollTo) == null || u.call(a, o.x, o.y) : (l = a.scrollBy) == null || l.call(a, i, s), { scroll: { x: a.scrollX, y: a.scrollY } };
   }
   navigate(e) {
     if (this.options.allowNavigation === !1)
       throw new Error("Navigation is disabled for host page automation.");
-    const n = h(e), o = this.getRoot(), r = N(o), c = R(n.url, "url"), s = new URL(c, r.location.href);
-    if (s.protocol !== "http:" && s.protocol !== "https:")
+    const n = m(e), o = this.getRoot(), i = N(o), s = O(n.url, "url"), r = new URL(s, i.location.href);
+    if (r.protocol !== "http:" && r.protocol !== "https:")
       throw new Error("Navigation only supports HTTP(S) URLs.");
-    return this.refs.clear(), r.location.assign(s.toString()), { navigated: s.toString() };
+    return this.refs.clear(), i.location.assign(r.toString()), { navigated: r.toString() };
   }
-  hover(e) {
-    const n = h(e), o = this.resolveElement(n), r = L(o).center;
-    return o.dispatchEvent(
+  async hover(e) {
+    const n = m(e), o = this.resolveElement(n), i = g(o).center;
+    return await this.showVisualEffect({
+      type: "hover",
+      target: o,
+      requested: o,
+      anchor: "target",
+      point: i
+    }), o.dispatchEvent(
       new MouseEvent("mouseover", {
         bubbles: !0,
         cancelable: !0,
-        clientX: r == null ? void 0 : r.x,
-        clientY: r == null ? void 0 : r.y
+        clientX: i == null ? void 0 : i.x,
+        clientY: i == null ? void 0 : i.y
       })
     ), o.dispatchEvent(
       new MouseEvent("mousemove", {
         bubbles: !0,
         cancelable: !0,
-        clientX: r == null ? void 0 : r.x,
-        clientY: r == null ? void 0 : r.y
+        clientX: i == null ? void 0 : i.x,
+        clientY: i == null ? void 0 : i.y
       })
-    ), { hovered: this.describeElement(o), point: r };
+    ), { hovered: this.describeElement(o), point: i };
   }
-  focus(e) {
-    const n = h(e), o = this.resolveElement(n);
-    return A(o), { focused: this.describeElement(o) };
+  async focus(e) {
+    const n = m(e), o = this.resolveElement(n);
+    return M(o), await this.showVisualEffect({
+      type: "focus",
+      target: o,
+      requested: o,
+      anchor: "target",
+      point: g(o).center
+    }), { focused: this.describeElement(o) };
   }
-  pointer(e) {
-    const n = h(e), o = F(n.action, ["move", "down", "up", "click"]) ?? "click", r = tt(n.button) ?? 0, c = n.ref || n.selector || n.role || n.name || n.text || n.testId ? this.resolveElement(n) : null, s = c ? L(c).center : {
-      x: M(n.x, "x"),
-      y: M(n.y, "y")
-    };
-    if (!s)
+  async pointer(e) {
+    const n = m(e), o = Y(n.action, ["move", "down", "up", "click"]) ?? "click", i = dt(n.button) ?? 0, s = typeof n.x < "u" || typeof n.y < "u", r = x(n.targetText);
+    if (o === "click" && s && !r)
+      throw new Error(
+        "Pointer coordinate clicks require targetText to avoid unintended navigation."
+      );
+    const a = n.ref || n.selector || n.role || n.name || n.text || n.testId ? this.resolveElement(n) : null, c = a ? g(a).center : U(this.getRoot(), n);
+    if (!c)
       throw new Error("Target element has no clickable point.");
-    const i = c ?? g(this.getRoot()).elementFromPoint(s.x, s.y);
-    if (!i)
-      throw new Error(`No element found at (${s.x}, ${s.y}).`);
-    const a = {
+    const d = a ?? T(this.getRoot()).elementFromPoint(c.x, c.y);
+    if (!d)
+      throw new Error(`No element found at (${c.x}, ${c.y}).`);
+    const u = r ? Nt(d, r) : void 0;
+    if (r && !u)
+      throw new Error(
+        `Pointer target text mismatch: expected hit target to contain "${r}".`
+      );
+    const l = {
       bubbles: !0,
       cancelable: !0,
-      clientX: s.x,
-      clientY: s.y,
-      button: r
+      clientX: c.x,
+      clientY: c.y,
+      button: i
     };
-    return o === "move" ? (i.dispatchEvent(_("pointermove", a)), i.dispatchEvent(new MouseEvent("mousemove", a))) : o === "down" ? (i.dispatchEvent(_("pointerdown", a)), i.dispatchEvent(new MouseEvent("mousedown", a))) : o === "up" ? (i.dispatchEvent(_("pointerup", a)), i.dispatchEvent(new MouseEvent("mouseup", a))) : (i.dispatchEvent(_("pointerdown", a)), i.dispatchEvent(new MouseEvent("mousedown", a)), i.dispatchEvent(_("pointerup", a)), i.dispatchEvent(new MouseEvent("mouseup", a)), i instanceof HTMLElement ? i.click() : i.dispatchEvent(new MouseEvent("click", a))), {
+    return o === "move" ? (await this.showVisualEffect({
+      type: "pointer",
+      action: o,
+      anchor: "point",
+      point: c,
+      target: d
+    }), d.dispatchEvent(L("pointermove", l)), d.dispatchEvent(new MouseEvent("mousemove", l))) : o === "down" ? (await this.showVisualEffect({
+      type: "pointer",
+      action: o,
+      anchor: "point",
+      point: c,
+      target: d
+    }), d.dispatchEvent(L("pointerdown", l)), d.dispatchEvent(new MouseEvent("mousedown", l))) : o === "up" ? (await this.showVisualEffect({
+      type: "pointer",
+      action: o,
+      anchor: "point",
+      point: c,
+      target: d
+    }), d.dispatchEvent(L("pointerup", l)), d.dispatchEvent(new MouseEvent("mouseup", l))) : (await this.showVisualEffect({
+      type: "click",
+      anchor: "point",
+      point: c,
+      target: d
+    }), d.dispatchEvent(L("pointerdown", l)), d.dispatchEvent(new MouseEvent("mousedown", l)), d.dispatchEvent(L("pointerup", l)), d.dispatchEvent(new MouseEvent("mouseup", l)), d instanceof HTMLElement ? d.click() : d.dispatchEvent(new MouseEvent("click", l))), {
       pointer: o,
-      point: s,
-      target: this.describeElement(i)
+      point: c,
+      coordinateSpace: "viewport-css-px",
+      target: this.describeElement(d),
+      targetTextMatched: u,
+      expectedAfterClick: o === "click" ? Ht(
+        this.getRoot(),
+        Rt(n.expectedAfterClick)
+      ) : void 0
     };
   }
   screenshot() {
@@ -676,25 +985,48 @@ class pt {
       "host_page_screenshot requires the browser extension CDP adapter."
     );
   }
+  async showVisualEffect(e) {
+    var n, o, i, s;
+    try {
+      await ((o = (n = this.options).showVisualEffect) == null ? void 0 : o.call(n, e));
+    } catch {
+    }
+    if (!(e.type !== "click" || !e.point || !e.target || this.options.showVisualEffect))
+      try {
+        await ((s = (i = this.options).showClickEffect) == null ? void 0 : s.call(i, {
+          point: e.point,
+          target: e.target,
+          requested: e.requested
+        }));
+      } catch {
+      }
+  }
   async waitFor(e) {
-    const n = h(e), o = F(n.state, [
+    const n = m(e), o = Y(n.state, [
       "attached",
       "visible",
       "hidden",
       "detached"
-    ]) ?? "visible", r = T(n.timeoutSeconds), c = Math.min(
-      Q,
-      Math.max(0, (r ?? J / 1e3) * 1e3)
-    ), s = Date.now();
-    for (; Date.now() - s <= c; ) {
-      const i = this.tryResolveElement(n);
-      if (o === "attached" ? !!i : o === "detached" ? !i : o === "hidden" ? !i || !m(i) : !!(i && m(i)))
+    ]) ?? "visible", i = k(n.timeoutSeconds), s = Math.min(
+      ct,
+      Math.max(0, (i ?? at / 1e3) * 1e3)
+    ), r = Date.now(), a = this.tryResolveElement(n);
+    for (await this.showVisualEffect({
+      type: "wait_for",
+      state: o,
+      target: a ?? void 0,
+      requested: a ?? void 0,
+      ...a ? { anchor: "target" } : {},
+      point: a ? g(a).center : void 0
+    }); Date.now() - r <= s; ) {
+      const c = this.tryResolveElement(n);
+      if (o === "attached" ? !!c : o === "detached" ? !c : o === "hidden" ? !c || !_(c) : !!(c && _(c)))
         return {
           waitedFor: o,
-          elapsedMs: Date.now() - s,
-          target: i ? this.describeElement(i) : void 0
+          elapsedMs: Date.now() - r,
+          target: c ? this.describeElement(c) : void 0
         };
-      await new Promise((d) => setTimeout(d, 100));
+      await new Promise((u) => setTimeout(u, 100));
     }
     throw new Error(`Timed out waiting for target to become ${o}.`);
   }
@@ -708,54 +1040,268 @@ class pt {
   describeElement(e) {
     return {
       tag: e.tagName.toLowerCase(),
-      role: x(e),
-      name: E(e),
-      selector: P(e)
+      role: S(e),
+      name: v(e),
+      selector: q(e)
     };
   }
 }
-function Et(t) {
+function Dt(t) {
   return typeof t == "object" && t !== null && !Array.isArray(t) ? t : {};
 }
-function mt(t) {
+function Vt(t) {
   return JSON.stringify(t);
 }
-function O(t, e, n) {
+function D(t, e, n) {
   return {
     tool_call_id: t.tool_call_id ?? t.id,
     name: t.name,
     status: e,
-    content: mt(n)
+    content: Vt(n)
   };
 }
-function bt(t) {
+function qt(t) {
   return t instanceof Error ? t.message : String(t);
 }
-function wt(t = {}) {
-  const e = new pt(t);
+function jt(t = {}) {
+  const e = new It(t);
   return async (n) => {
-    if (!Z(n.name))
-      return O(n, "error", {
+    if (!lt(n.name))
+      return D(n, "error", {
         ok: !1,
         error: `Unknown host page automation tool: ${n.name}`
       });
     try {
       const o = await e.execute(
         n.name,
-        Et(n.params)
+        Dt(n.params)
       );
-      return O(n, "success", { ok: !0, result: o });
+      return D(n, "success", { ok: !0, result: o });
     } catch (o) {
-      return O(n, "error", {
+      return D(n, "error", {
         ok: !1,
-        error: bt(o)
+        error: qt(o)
       });
     }
   };
 }
+const w = {
+  ref: {
+    type: ["string", "number"],
+    description: "Element ref from host_page_snapshot."
+  },
+  axRef: {
+    type: ["string", "number"],
+    description: "Accessibility ref from host_page_snapshot."
+  },
+  selector: {
+    type: "string",
+    description: "CSS selector for the target element."
+  },
+  testId: {
+    type: "string",
+    description: "data-testid, data-test-id, or data-qa value."
+  },
+  role: {
+    type: "string",
+    description: "Accessible role to match."
+  },
+  name: {
+    type: "string",
+    description: "Accessible name to match."
+  },
+  text: {
+    type: "string",
+    description: "Visible text to match."
+  },
+  x: {
+    type: "number",
+    description: "Viewport x coordinate."
+  },
+  y: {
+    type: "number",
+    description: "Viewport y coordinate."
+  }
+}, Bt = {
+  coordinateSpace: {
+    type: "string",
+    enum: ["viewport-css-px", "viewport_normalized"],
+    description: "Coordinate space for x/y. Use viewport_normalized for screenshot-derived points."
+  }
+}, Ft = {
+  type: "object",
+  properties: {
+    type: {
+      const: "field_contains",
+      description: "Currently supported post-click expectation type."
+    },
+    field: {
+      type: "string",
+      description: "Field label/name expected to change after clicking."
+    },
+    value: {
+      type: "string",
+      description: "Expected substring in the field value after clicking."
+    }
+  },
+  required: ["type", "field", "value"],
+  additionalProperties: !1
+}, $t = {
+  host_page_snapshot: {
+    type: "object",
+    properties: {},
+    additionalProperties: !1
+  },
+  host_page_click: {
+    type: "object",
+    properties: {
+      ...w
+    },
+    additionalProperties: !1
+  },
+  host_page_fill: {
+    type: "object",
+    properties: {
+      ...w,
+      value: {
+        type: "string",
+        description: "Text value to set on the target field."
+      }
+    },
+    required: ["value"],
+    additionalProperties: !1
+  },
+  host_page_press: {
+    type: "object",
+    properties: {
+      ...w,
+      key: {
+        type: "string",
+        description: "Keyboard key to press."
+      }
+    },
+    required: ["key"],
+    additionalProperties: !1
+  },
+  host_page_select: {
+    type: "object",
+    properties: {
+      ...w,
+      value: {
+        type: ["string", "array"],
+        description: "Select option value or values.",
+        items: { type: "string" }
+      },
+      values: {
+        type: ["string", "array"],
+        description: "Select option values.",
+        items: { type: "string" }
+      }
+    },
+    additionalProperties: !1
+  },
+  host_page_scroll: {
+    type: "object",
+    properties: {
+      ...w,
+      deltaX: {
+        type: "number",
+        description: "Horizontal scroll delta."
+      },
+      deltaY: {
+        type: "number",
+        description: "Vertical scroll delta."
+      }
+    },
+    additionalProperties: !1
+  },
+  host_page_navigate: {
+    type: "object",
+    properties: {
+      url: {
+        type: "string",
+        description: "HTTP(S) URL to navigate to."
+      }
+    },
+    required: ["url"],
+    additionalProperties: !1
+  },
+  host_page_hover: {
+    type: "object",
+    properties: {
+      ...w
+    },
+    additionalProperties: !1
+  },
+  host_page_focus: {
+    type: "object",
+    properties: {
+      ...w
+    },
+    additionalProperties: !1
+  },
+  host_page_pointer: {
+    type: "object",
+    properties: {
+      ...w,
+      ...Bt,
+      action: {
+        type: "string",
+        enum: ["move", "down", "up", "click"],
+        description: "Pointer action. Defaults to click."
+      },
+      button: {
+        type: ["string", "number"],
+        description: "Mouse button."
+      },
+      clickCount: {
+        type: "number",
+        description: "Number of clicks for CDP mouse click."
+      },
+      targetText: {
+        type: "string",
+        description: "Required for explicit coordinate clicks. The actual hit target or near ancestor must contain this text."
+      },
+      expectedAfterClick: Ft
+    },
+    additionalProperties: !1
+  },
+  host_page_screenshot: {
+    type: "object",
+    properties: {
+      format: {
+        type: "string",
+        enum: ["jpeg", "png"],
+        description: "Screenshot image format."
+      },
+      quality: {
+        type: "number",
+        description: "JPEG quality from 1 to 100."
+      }
+    },
+    additionalProperties: !1
+  },
+  host_page_wait_for: {
+    type: "object",
+    properties: {
+      ...w,
+      state: {
+        type: "string",
+        enum: ["attached", "visible", "hidden", "detached"],
+        description: "Target state to wait for. Defaults to visible."
+      },
+      timeoutSeconds: {
+        type: "number",
+        description: "Maximum wait time in seconds."
+      }
+    },
+    additionalProperties: !1
+  }
+};
 export {
-  z as HOST_PAGE_AUTOMATION_TOOL_NAMES,
-  pt as HostPageAutomationExecutor,
-  wt as createHostPageAutomationClientToolHandler,
-  Z as isHostPageAutomationToolName
+  it as HOST_PAGE_AUTOMATION_TOOL_NAMES,
+  $t as HOST_PAGE_AUTOMATION_TOOL_SCHEMAS,
+  It as HostPageAutomationExecutor,
+  jt as createHostPageAutomationClientToolHandler,
+  lt as isHostPageAutomationToolName
 };