@quanta-intellect/vessel-browser 0.1.12 → 0.1.14

package/out/main/index.js

@@ -710,7 +710,8 @@ async function highlightOnPage(wc, resolvedSelector, text, label, durationMs, co
   if (text) {
     return wc.executeJavaScript(`
       (function() {
-        var searchText = ${JSON.stringify(text)};
+        var searchText = (${JSON.stringify(text)} || '').trim();
+        var foldedSearchText = searchText.toLowerCase();
         var solidColor = ${JSON.stringify(c.solid)};
         var bgColor = ${JSON.stringify(c.bg)};
         var labelBg = ${JSON.stringify(c.label)};
@@ -748,7 +749,11 @@ async function highlightOnPage(wc, resolvedSelector, text, label, durationMs, co
           });
           var n;
           while ((n = w.nextNode())) {
-            var idx = n.textContent.indexOf(searchText);
+            var haystack = n.textContent || '';
+            var idx = haystack.indexOf(searchText);
+            if (idx === -1 && foldedSearchText) {
+              idx = haystack.toLowerCase().indexOf(foldedSearchText);
+            }
             if (idx !== -1) {
               matches.push({ node: n, idx: idx });
               if (matches.length >= limit) break;
@@ -2004,6 +2009,7 @@ const Channels = {
   BOOKMARKS_UPDATE: "bookmarks:update",
   BOOKMARK_SAVE: "bookmarks:save",
   BOOKMARK_REMOVE: "bookmarks:remove",
+  BOOKMARK_ADD_CONTEXT_TO_CHAT: "bookmarks:add-context-to-chat",
   FOLDER_CREATE: "bookmarks:folder-create",
   FOLDER_REMOVE: "bookmarks:folder-remove",
   FOLDER_RENAME: "bookmarks:folder-rename",
@@ -2062,6 +2068,10 @@ async function getSidebarContextTarget(sidebarView, x, y) {
         return {
           inHighlightNav: !!nav,
           canRemoveCurrent: /\\d+\\s*\\/\\s*\\d+/.test(label),
+          bookmarkId:
+            el && typeof el.closest === "function"
+              ? el.closest("[data-bookmark-id]")?.getAttribute("data-bookmark-id") || undefined
+              : undefined,
         };
       })()`,
       true
@@ -2095,6 +2105,20 @@ async function showSidebarContextMenu(mainWindow, sidebarView, params) {
       })
     );
   }
+  if (target.bookmarkId) {
+    if (menu.items.length > 0) {
+      menu.append(new electron.MenuItem({ type: "separator" }));
+    }
+    menu.append(
+      new electron.MenuItem({
+        label: "Add Context to Chat",
+        click: () => sidebarView.webContents.send(
+          Channels.BOOKMARK_ADD_CONTEXT_TO_CHAT,
+          target.bookmarkId
+        )
+      })
+    );
+  }
   if (params.isEditable) {
     if (menu.items.length > 0) {
       menu.append(new electron.MenuItem({ type: "separator" }));
@@ -2226,7 +2250,14 @@ function createMainWindow(onTabStateChange) {
   return state2;
 }
 function layoutViews(state2) {
-  const { mainWindow, chromeView, sidebarView, devtoolsPanelView, tabManager, uiState } = state2;
+  const {
+    mainWindow,
+    chromeView,
+    sidebarView,
+    devtoolsPanelView,
+    tabManager,
+    uiState
+  } = state2;
   const [width, height] = mainWindow.getContentSize();
   const chromeHeight = uiState.focusMode ? 0 : CHROME_HEIGHT;
   const sidebarWidth = uiState.sidebarOpen ? uiState.sidebarWidth : 0;
@@ -2971,11 +3002,25 @@ const DIRECT_EXTRACTION_SCRIPT = String.raw`
     }
 
     function viewportWidth() {
-      return window.innerWidth || document.documentElement?.clientWidth || 0;
+      return Math.max(
+        window.innerWidth || 0,
+        window.visualViewport?.width || 0,
+        document.documentElement?.clientWidth || 0,
+        document.scrollingElement?.clientWidth || 0,
+        document.body?.clientWidth || 0,
+        window.screen?.availWidth || 0,
+      );
     }
 
     function viewportHeight() {
-      return window.innerHeight || document.documentElement?.clientHeight || 0;
+      return Math.max(
+        window.innerHeight || 0,
+        window.visualViewport?.height || 0,
+        document.documentElement?.clientHeight || 0,
+        document.scrollingElement?.clientHeight || 0,
+        document.body?.clientHeight || 0,
+        window.screen?.availHeight || 0,
+      );
     }
 
     function scrollingElement() {
@@ -3032,6 +3077,60 @@ const DIRECT_EXTRACTION_SCRIPT = String.raw`
         rect.bottom >= centerY;
     }
 
+    function touchesViewportEdge(rect) {
+      const edgePadding = 24;
+      return rect.left <= edgePadding ||
+        rect.top <= edgePadding ||
+        rect.right >= viewportWidth() - edgePadding ||
+        rect.bottom >= viewportHeight() - edgePadding;
+    }
+
+    function hasFixedAncestor(el) {
+      var cur = el.parentElement;
+      while (cur && cur !== document.body) {
+        var ps = getComputedStyle(cur).position;
+        if (ps === "fixed" || ps === "sticky") return true;
+        cur = cur.parentElement;
+      }
+      return false;
+    }
+
+    function isPositioned(style) {
+      return style.position === "fixed" || style.position === "sticky" ||
+        style.position === "absolute";
+    }
+
+    function effectiveZIndex(style, el) {
+      var z = parseZIndex(style);
+      if (z > 0) return z;
+      var cur = el.parentElement;
+      while (cur && cur !== document.body) {
+        var pz = parseZIndex(getComputedStyle(cur));
+        if (pz > 0) return pz;
+        cur = cur.parentElement;
+      }
+      return 0;
+    }
+
+    function looksLikeDrawer(style, rect, areaRatio, el) {
+      if (rect.width < 220 || rect.height < 160 || areaRatio < 0.08) return false;
+      if (!touchesViewportEdge(rect)) return false;
+      if (style.position === "fixed" || style.position === "sticky") {
+        return effectiveZIndex(style, el) >= 5;
+      }
+      if (style.position === "absolute" && hasFixedAncestor(el)) {
+        return effectiveZIndex(style, el) >= 5;
+      }
+      return false;
+    }
+
+    function looksLikeCartConfirmation(node) {
+      var t = (node.textContent || "").slice(0, 500).toLowerCase();
+      var signals = ["added to cart", "added to bag", "added to basket",
+        "added to your cart", "added to your bag", "added to your basket"];
+      return signals.some(function(s) { return t.indexOf(s) !== -1; });
+    }
+
     function detectOverlays() {
       if (!document.body) return [];
       const viewportArea = Math.max(1, viewportWidth() * viewportHeight());
@@ -3070,7 +3169,13 @@ const DIRECT_EXTRACTION_SCRIPT = String.raw`
         var type = overlayType(node);
         var dialogLike = type === "dialog" || type === "modal";
         var areaRatio = (rect.width * rect.height) / viewportArea;
+        var drawerLike = looksLikeDrawer(style, rect, areaRatio, node);
+        var cartConfirm = !dialogLike && !drawerLike && isPositioned(style) &&
+          rect.width >= 160 && rect.height >= 100 &&
+          looksLikeCartConfirmation(node);
         var blocksInteraction = dialogLike ||
+          drawerLike ||
+          cartConfirm ||
           ((style.position === "fixed" || style.position === "sticky") &&
             parseZIndex(style) >= 10 &&
             areaRatio >= 0.3 &&
@@ -3188,6 +3293,11 @@ const DIRECT_EXTRACTION_SCRIPT = String.raw`
     }
 
     function contextOf(el) {
+      const overlayRoot = overlays.find(
+        (overlay) => overlay.element === el || overlay.element.contains(el),
+      );
+      if (overlayRoot) return "dialog";
+
       let current = el.parentElement;
       while (current) {
         const tag = current.tagName.toLowerCase();
@@ -4466,6 +4576,158 @@ function createProvider(config) {
   }
   return new OpenAICompatProvider(normalized);
 }
+const CORRECT_HINT_RE = /\b(correct|right choice|this is correct|correct answer|pick this|select this|choose this|right answer)\b/i;
+const WRONG_HINT_RE = /\b(wrong|incorrect|not this|don't pick|do not pick|bad option|decoy)\b/i;
+function elementLabel(el) {
+  return el.text?.trim() || el.label?.trim() || el.value?.trim() || el.placeholder?.trim() || void 0;
+}
+function isOverlayAction(el) {
+  if (el.type === "button" || el.type === "link") return true;
+  if (el.type !== "input") return false;
+  return ["button", "submit", "radio", "checkbox"].includes(
+    (el.inputType || "").toLowerCase()
+  );
+}
+function isRadioOption(el) {
+  return el.role === "radio" || el.type === "input" && (el.inputType || "").toLowerCase() === "radio";
+}
+function normalizeAction(el) {
+  return {
+    index: el.index,
+    label: elementLabel(el),
+    selector: el.selector,
+    role: el.role,
+    labelSource: el.labelSource,
+    looksCorrect: el.looksCorrect !== void 0 ? el.looksCorrect : looksLikeCorrectOption(elementLabel(el))
+  };
+}
+function normalizeStoredAction(action) {
+  return {
+    label: action.label,
+    selector: action.selector,
+    role: action.kind === "radio" ? "radio" : void 0
+  };
+}
+function normalizeStoredRadioOption(option) {
+  return {
+    label: option.label,
+    selector: option.selector,
+    role: "radio",
+    labelSource: option.labelSource,
+    looksCorrect: option.looksCorrect !== void 0 ? option.looksCorrect : looksLikeCorrectOption(option.label)
+  };
+}
+function dedupeCandidates(actions) {
+  const seen = /* @__PURE__ */ new Set();
+  return actions.filter((action) => {
+    const key = [
+      action.selector || "",
+      action.label || "",
+      action.role || "",
+      action.labelSource || ""
+    ].join("::");
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+}
+function classifyOverlayKind(overlay, radioOptions) {
+  if (overlay.kind) {
+    return overlay.kind;
+  }
+  const haystack = [overlay.label, overlay.text, overlay.role].filter(Boolean).join(" ").toLowerCase();
+  if (/cookie|consent|privacy|gdpr|ccpa|onetrust|trustarc|cookiebot/.test(
+    haystack
+  )) {
+    return "cookie_consent";
+  }
+  if (radioOptions.length > 0) return "selection_modal";
+  if (overlay.role === "alertdialog" || /\b(alert|warning|error)\b/.test(haystack)) {
+    return "alert";
+  }
+  if (overlay.type === "dialog") return "dialog";
+  if (overlay.type === "modal") return "modal";
+  return "overlay";
+}
+function findAction(actions, matcher) {
+  return actions.find(
+    (action) => matcher.test((action.label || "").toLowerCase())
+  );
+}
+function looksLikeCorrectOption(label) {
+  const text = label?.trim();
+  if (!text) return void 0;
+  if (CORRECT_HINT_RE.test(text)) return true;
+  if (WRONG_HINT_RE.test(text)) return false;
+  return void 0;
+}
+function getBlockingOverlaySignature(overlays) {
+  return overlays.filter((overlay) => overlay.blocksInteraction).map(
+    (overlay) => [
+      overlay.kind,
+      overlay.selector || "",
+      overlay.label || "",
+      overlay.text || "",
+      overlay.actions.map((action) => `${action.selector || ""}:${action.label || ""}`).join("|"),
+      overlay.radioOptions.map((option) => `${option.selector || ""}:${option.label || ""}`).join("|")
+    ].join("::")
+  ).join("||");
+}
+function buildOverlayInventory(page) {
+  if (page.overlays.length === 0) return [];
+  return page.overlays.map((overlay) => {
+    const controls = dedupeCandidates([
+      ...page.interactiveElements.filter((el) => {
+        if (overlay.selector && el.parentOverlay === overlay.selector) {
+          return true;
+        }
+        return page.overlays.length === 1 && el.context === "dialog";
+      }).filter(isOverlayAction).map(normalizeAction),
+      ...(overlay.actions || []).map(normalizeStoredAction)
+    ]).filter((action) => action.label || action.selector);
+    const radioOptions = dedupeCandidates([
+      ...page.interactiveElements.filter((el) => {
+        if (!isRadioOption(el)) return false;
+        if (overlay.selector && el.parentOverlay === overlay.selector) {
+          return true;
+        }
+        return page.overlays.length === 1 && el.context === "dialog";
+      }).map(normalizeAction),
+      ...(overlay.radioOptions || []).map(normalizeStoredRadioOption)
+    ]).filter((action) => action.label || action.selector);
+    const kind = classifyOverlayKind(overlay, radioOptions);
+    const dismissAction = findAction(
+      controls,
+      /\b(close|dismiss|skip|cancel|reject|decline|no thanks|not now|maybe later|continue without)\b/
+    );
+    const acceptAction = findAction(
+      controls,
+      /\b(accept|allow|agree|got it|ok|okay|consent)\b/
+    );
+    const submitAction = findAction(
+      controls,
+      /\b(submit|continue|confirm|done|next|save|apply|finish)\b/
+    );
+    const correctOption = radioOptions.find(
+      (option) => option.looksCorrect === true
+    );
+    return {
+      type: overlay.type,
+      kind,
+      role: overlay.role,
+      label: overlay.label,
+      selector: overlay.selector,
+      text: overlay.text,
+      blocksInteraction: overlay.blocksInteraction,
+      actions: controls,
+      radioOptions,
+      dismissAction,
+      acceptAction,
+      submitAction,
+      correctOption
+    };
+  });
+}
 const MAX_CONTENT_LENGTH = 6e4;
 const MAX_STRUCTURED_ITEMS = 100;
 const LARGE_PAGE_HINT_THRESHOLD = 12e3;
@@ -4533,10 +4795,18 @@ function formatElementMeta(el) {
   if (el.pattern) {
     meta.push(`pattern="${el.pattern}"`);
   }
+  if (el.labelSource) {
+    meta.push(`source=${el.labelSource}`);
+  }
+  if (el.looksCorrect === true) {
+    meta.push("likely-correct");
+  } else if (el.looksCorrect === false) {
+    meta.push("likely-wrong");
+  }
   if (el.description) {
     meta.push(`desc="${el.description.slice(0, 80)}"`);
   }
-  if (el.value) {
+  if (el.value !== void 0 && el.value !== null && el.value !== "") {
     meta.push(`value="${el.value.slice(0, 60)}"`);
   }
   if (el.selector) {
@@ -4545,14 +4815,207 @@ function formatElementMeta(el) {
   }
   return meta;
 }
+function summarizeElementValue(el) {
+  const value = typeof el.value === "string" && el.value.trim() ? el.value.trim() : "";
+  if (!value) return null;
+  if (el.type === "select") {
+    return { label: "selected", value: value.slice(0, 60) };
+  }
+  if (el.type === "textarea") {
+    return { label: "current", value: value.slice(0, 60) };
+  }
+  if (el.type === "input") {
+    return { label: "current", value: value.slice(0, 60) };
+  }
+  return null;
+}
+function isQuantityLike(el) {
+  const text = [
+    el.label,
+    el.name,
+    el.placeholder,
+    el.text,
+    el.description,
+    el.selector
+  ].filter(Boolean).join(" ").toLowerCase();
+  return /\b(qty|quantity|count|items?)\b/.test(text) || el.inputType === "number" && (/\b(quantity|qty|count|items?)\b/.test(text) || el.name === "quantity" || el.name === "qty");
+}
+function getQuantityElements(page) {
+  const seen = /* @__PURE__ */ new Set();
+  const elements = [
+    ...page.interactiveElements,
+    ...page.forms.flatMap((form) => form.fields)
+  ];
+  return elements.filter((el) => {
+    if (!isQuantityLike(el)) return false;
+    const key = String(
+      el.index ?? el.selector ?? `${el.type}|${el.name || ""}|${el.label || ""}|${el.value || ""}`
+    );
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+}
+function formatQuantityElements(elements) {
+  if (elements.length === 0) return "None detected";
+  return limitItems(elements, 12).map((el) => {
+    const prefix = el.index ? `[#${el.index}]` : "-";
+    const name = el.label || el.name || el.placeholder || "Quantity";
+    const summary = summarizeElementValue(el);
+    const parts = [prefix, `[${name}]`, el.type];
+    if (summary) {
+      parts.push(`${summary.label}="${summary.value}"`);
+    }
+    const meta = formatElementMeta({
+      ...el,
+      value: void 0
+    });
+    if (meta.length > 0) {
+      parts.push(`(${meta.join(", ")})`);
+    }
+    return parts.join(" ");
+  }).join("\n");
+}
+function isCartLikePage(page) {
+  const url = page.url.toLowerCase();
+  const text = `${page.title}
+${page.content}`.toLowerCase();
+  return url.includes("cart") || url.includes("checkout") || url.includes("basket") || url.includes("bag") || getQuantityElements(page).length > 0 || /\b(subtotal|order total|cart total|checkout|shopping cart)\b/.test(text);
+}
+function getCartItemLinks(page) {
+  const blockedText = /\b(remove|delete|wishlist|save for later|move to|checkout|view cart|continue shopping|edit|details?)\b/i;
+  const blockedHref = /\/(cart|checkout|wishlist|account|login|signin|remove|delete)(\/|$)|[?&](remove|delete|wishlist)=/i;
+  const seen = /* @__PURE__ */ new Set();
+  return page.interactiveElements.filter((el) => el.type === "link").filter((el) => {
+    const text = (el.text || "").trim();
+    const href = (el.href || "").trim();
+    if (!text || text.length < 3 || !href) return false;
+    if (el.context === "nav" || el.context === "footer" || el.context === "sidebar") {
+      return false;
+    }
+    if (blockedText.test(text) || blockedHref.test(href)) return false;
+    const key = `${normalizeComparable(text)}|${normalizeUrlForMatch(href) || href}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  }).slice(0, 12);
+}
+function extractCartTotals(content) {
+  const lines = content.split(/\n+/).map((line) => line.trim()).filter(Boolean);
+  const totalLines = [];
+  const seen = /* @__PURE__ */ new Set();
+  const keyword = /\b(subtotal|order total|estimated total|total|tax|shipping|discount|savings?)\b/i;
+  const money = /([$€£]\s?\d[\d,]*(?:\.\d{2})?|\d[\d,]*(?:\.\d{2})?\s?(?:usd|eur|gbp))/i;
+  for (const line of lines) {
+    if (!keyword.test(line)) continue;
+    if (!money.test(line) && line.length > 90) continue;
+    const cleaned = line.replace(/\s+/g, " ").trim();
+    if (seen.has(cleaned.toLowerCase())) continue;
+    seen.add(cleaned.toLowerCase());
+    totalLines.push(cleaned);
+    if (totalLines.length >= 6) break;
+  }
+  return totalLines;
+}
+function formatCartSnapshot(page) {
+  if (!isCartLikePage(page)) return null;
+  const itemLinks = getCartItemLinks(page);
+  const quantityElements = getQuantityElements(page);
+  const quantityValues = quantityElements.map((el) => summarizeElementValue(el)?.value || "").filter(Boolean);
+  const numericQuantities = quantityValues.map((value) => Number.parseFloat(value)).filter((value) => Number.isFinite(value) && value >= 0);
+  const totalLines = extractCartTotals(page.content);
+  const lines = [];
+  if (itemLinks.length > 0) {
+    lines.push(`Distinct items: ${itemLinks.length}`);
+    lines.push(
+      `Items: ${itemLinks.slice(0, 8).map((item) => item.text || item.label || "Untitled item").join(" | ")}`
+    );
+  }
+  if (quantityElements.length > 0) {
+    if (numericQuantities.length === quantityElements.length && numericQuantities.length > 0) {
+      const unique = Array.from(new Set(numericQuantities));
+      const totalUnits = numericQuantities.reduce(
+        (sum, value) => sum + value,
+        0
+      );
+      lines.push(
+        unique.length === 1 ? `Quantity controls: ${quantityElements.length} (all set to ${unique[0]})` : `Quantity controls: ${quantityElements.length} (${numericQuantities.join(", ")})`
+      );
+      lines.push(`Total units inferred: ${totalUnits}`);
+      if (itemLinks.length > 0 && totalUnits > itemLinks.length) {
+        lines.push(
+          `Attention: ${itemLinks.length} distinct items but ${totalUnits} total units. Check for duplicate quantities.`
+        );
+      }
+    } else {
+      lines.push(
+        `Quantity controls: ${quantityElements.length}${quantityValues.length > 0 ? ` (${quantityValues.join(", ")})` : ""}`
+      );
+    }
+  }
+  if (totalLines.length > 0) {
+    lines.push("Totals:");
+    totalLines.forEach((line) => lines.push(`- ${line}`));
+  }
+  if (lines.length === 0) return null;
+  return lines.join("\n");
+}
 function isVisibleToUser(el) {
   return el.visible === true && el.inViewport === true && el.obscured !== true && el.blockedByOverlay !== true;
 }
+function getDialogFocusedElements(page) {
+  return page.interactiveElements.filter(
+    (el) => isVisibleToUser(el) && el.context === "dialog"
+  );
+}
+function normalizeOverlayText(value) {
+  return (value || "").trim().toLowerCase();
+}
+function isCartConfirmationLike(page) {
+  const overlayText = page.overlays.map(
+    (overlay) => normalizeOverlayText(
+      [overlay.label, overlay.text].filter(Boolean).join(" ")
+    )
+  ).join(" ");
+  const dialogText = getDialogFocusedElements(page).map((el) => normalizeOverlayText(el.text || el.label || el.description)).join(" ");
+  const haystack = `${overlayText} ${dialogText}`.trim();
+  if (!haystack) return false;
+  const cartSignals = [
+    "added to cart",
+    "added to bag",
+    "added to basket",
+    "shopping cart",
+    "view cart",
+    "go to cart",
+    "continue shopping",
+    "keep shopping",
+    "checkout"
+  ];
+  return cartSignals.some((signal) => haystack.includes(signal));
+}
+function formatDialogFocus(page) {
+  const dialogElements = getDialogFocusedElements(page);
+  if (dialogElements.length === 0) return null;
+  const lines = [];
+  lines.push(
+    "A live dialog/modal is open. Prioritize its controls before acting on the page behind it."
+  );
+  if (isCartConfirmationLike(page)) {
+    lines.push(
+      "Cart confirmation detected: choose a dialog action such as Continue Shopping, View Cart, or Checkout. Do not click background Add to Cart again."
+    );
+  }
+  lines.push("");
+  lines.push("Visible dialog controls:");
+  lines.push(formatInteractiveElements(dialogElements));
+  return lines.join("\n");
+}
 function formatInteractiveElements(elements) {
   if (elements.length === 0) return "None";
   const sorted = [...elements].sort((a, b) => {
     const scoreEl = (el) => {
       let s = 0;
+      if (el.context === "dialog") s -= 40;
       if (el.visible === false) s += 100;
       if (el.inViewport === false) s += 50;
       if (el.context === "nav" || el.context === "footer" || el.context === "sidebar")
@@ -4569,7 +5032,7 @@ function formatInteractiveElements(elements) {
     const parts = [prefix];
     if (el.type === "button") {
       parts.push(`[${el.text || "Button"}]`);
-      parts.push("button");
+      parts.push(el.role === "radio" ? "radio" : "button");
     } else if (el.type === "link") {
       parts.push(`[${el.text || "Link"}]`);
       parts.push("link");
@@ -4578,10 +5041,14 @@ function formatInteractiveElements(elements) {
       parts.push(`[${el.label || el.placeholder || "Input"}]`);
       parts.push(el.inputType || "text");
       parts.push("input");
+      const summary = summarizeElementValue(el);
+      if (summary) parts.push(`${summary.label}="${summary.value}"`);
       if (el.required) parts.push("(required)");
     } else if (el.type === "select") {
       parts.push(`[${el.label || "Select"}]`);
       parts.push("dropdown");
+      const summary = summarizeElementValue(el);
+      if (summary) parts.push(`${summary.label}="${summary.value}"`);
       if (el.options?.length) {
         parts.push(
           `options=${el.options.slice(0, 5).map((o) => typeof o === "string" ? o : o.label || o.value).join("|")}`
@@ -4590,6 +5057,8 @@ function formatInteractiveElements(elements) {
     } else if (el.type === "textarea") {
       parts.push(`[${el.label || "Text Area"}]`);
       parts.push("textarea");
+      const summary = summarizeElementValue(el);
+      if (summary) parts.push(`${summary.label}="${summary.value}"`);
     }
     const meta = formatElementMeta(el);
     if (meta.length > 0) parts.push(`(${meta.join(", ")})`);
@@ -4628,14 +5097,18 @@ function formatForms(forms) {
         ];
         if (field.type === "button") {
           fieldParts.push(`[${field.text || "Submit"}]`);
-          fieldParts.push("button");
+          fieldParts.push(field.role === "radio" ? "radio" : "button");
         } else if (field.type === "input") {
           fieldParts.push(`[${field.label || field.placeholder || "Input"}]`);
           fieldParts.push(field.inputType || "text");
+          const summary = summarizeElementValue(field);
+          if (summary) fieldParts.push(`${summary.label}="${summary.value}"`);
           if (field.required) fieldParts.push("(required)");
         } else if (field.type === "select") {
           fieldParts.push(`[${field.label || "Select"}]`);
           fieldParts.push("dropdown");
+          const summary = summarizeElementValue(field);
+          if (summary) fieldParts.push(`${summary.label}="${summary.value}"`);
           if (field.options?.length) {
             fieldParts.push(
               `options=${field.options.slice(0, 5).map((o) => typeof o === "string" ? o : o.label || o.value).join("|")}`
@@ -4644,6 +5117,8 @@ function formatForms(forms) {
         } else if (field.type === "textarea") {
           fieldParts.push(`[${field.label || "Text"}]`);
           fieldParts.push("textarea");
+          const summary = summarizeElementValue(field);
+          if (summary) fieldParts.push(`${summary.label}="${summary.value}"`);
         }
         const meta = formatElementMeta(field);
         if (meta.length > 0) fieldParts.push(`(${meta.join(", ")})`);
@@ -4669,18 +5144,51 @@ function formatLandmarks(landmarks) {
 function formatViewport(page) {
   return `${page.viewport.width}x${page.viewport.height} at scroll (${page.viewport.scrollX}, ${page.viewport.scrollY})`;
 }
-function formatOverlays(overlays) {
-  if (overlays.length === 0) return "None detected";
-  const items = limitItems(overlays, 10);
+function formatOverlays(page) {
+  if (page.overlays.length === 0) return "None detected";
+  const items = limitItems(buildOverlayInventory(page), 10);
   return items.map((overlay) => {
-    const parts = [`- ${overlay.type}`];
-    if (overlay.role) parts.push(`role=${overlay.role}`);
-    if (overlay.blocksInteraction) parts.push("blocking");
-    if (overlay.label) parts.push(`label="${overlay.label.slice(0, 80)}"`);
-    if (overlay.text) parts.push(`text="${overlay.text.slice(0, 100)}"`);
-    return parts.join(" ");
+    const lines = [
+      [
+        `- ${overlay.kind}`,
+        overlay.role ? `role=${overlay.role}` : "",
+        overlay.blocksInteraction ? "blocking" : "",
+        overlay.label ? `label="${overlay.label.slice(0, 80)}"` : "",
+        overlay.text ? `text="${overlay.text.slice(0, 100)}"` : ""
+      ].filter(Boolean).join(" ")
+    ];
+    if (overlay.radioOptions.length > 0) {
+      const options = overlay.radioOptions.slice(0, 4).map((option) => {
+        const tags = [];
+        if (option.labelSource) tags.push(`source=${option.labelSource}`);
+        if (option.looksCorrect === true) tags.push("likely-correct");
+        if (option.looksCorrect === false) tags.push("likely-wrong");
+        const suffix = tags.length > 0 ? ` (${tags.join(", ")})` : "";
+        return `${option.label || option.selector || "radio"}${suffix}`;
+      }).join(" | ");
+      lines.push(`  options: ${options}`);
+    }
+    const actionLabels = [
+      overlay.dismissAction?.label ? `dismiss="${overlay.dismissAction.label}"` : "",
+      overlay.acceptAction?.label ? `accept="${overlay.acceptAction.label}"` : "",
+      overlay.submitAction?.label ? `submit="${overlay.submitAction.label}"` : ""
+    ].filter(Boolean);
+    if (actionLabels.length > 0) {
+      lines.push(`  actions: ${actionLabels.join(" ")}`);
+    }
+    return lines.join("\n");
   }).join("\n");
 }
+function getScrollHints(page) {
+  const candidates = page.interactiveElements.filter(
+    (el) => el.visible !== false && el.inViewport === false && el.context !== "nav" && el.context !== "footer" && el.context !== "sidebar" && el.blockedByOverlay !== true && (el.type === "input" || el.type === "textarea" || el.type === "select" || el.type === "button")
+  );
+  if (candidates.length === 0) return [];
+  const labels = limitItems(candidates, 3).map((el) => el.text || el.label || el.placeholder || el.type).filter(Boolean);
+  return [
+    `Scroll to reveal offscreen controls: ${labels.join(", ")}${candidates.length > labels.length ? ", ..." : ""}`
+  ];
+}
 function formatDormantOverlays(overlays) {
   if (overlays.length === 0) return "None detected";
   const items = limitItems(overlays, 10);
@@ -5009,6 +5517,7 @@ function buildScopedContext(page, mode) {
   switch (mode) {
     case "summary": {
       const sections = [];
+      const cartSnapshot = formatCartSnapshot(page);
       sections.push(`**URL:** ${page.url}`);
       sections.push(`**Title:** ${page.title}`);
       sections.push(`**Viewport:** ${formatViewport(page)}`);
@@ -5016,12 +5525,21 @@ function buildScopedContext(page, mode) {
       if (page.excerpt) sections.push(`**Summary:** ${page.excerpt}`);
       const largePageHint = formatLargePageHint(page);
       if (largePageHint) sections.push(`**Reading Hint:** ${largePageHint}`);
+      const scrollHints = getScrollHints(page);
+      if (scrollHints.length > 0) {
+        sections.push(`**Scroll Hint:** ${scrollHints[0]}`);
+      }
       sections.push("");
       const summaryIntent = analyzePageIntent(page);
       if (summaryIntent) {
         sections.push(summaryIntent);
         sections.push("");
       }
+      if (cartSnapshot) {
+        sections.push("### Cart Snapshot");
+        sections.push(cartSnapshot);
+        sections.push("");
+      }
       if ((page.pageIssues?.length ?? 0) > 0) {
         sections.push("### Page Access Warnings");
         sections.push(formatPageIssues(page.pageIssues ?? []));
@@ -5073,9 +5591,16 @@ function buildScopedContext(page, mode) {
     }
     case "interactives_only": {
       const sections = [];
+      const quantityElements = getQuantityElements(page);
+      const cartSnapshot = formatCartSnapshot(page);
+      const dialogFocus = formatDialogFocus(page);
       sections.push(`**URL:** ${page.url}`);
       sections.push(`**Title:** ${page.title}`);
       sections.push(`**Viewport:** ${formatViewport(page)}`);
+      const interactivesScrollHints = getScrollHints(page);
+      if (interactivesScrollHints.length > 0) {
+        sections.push(`**Scroll Hint:** ${interactivesScrollHints[0]}`);
+      }
       sections.push("");
       const interactivesIntent = analyzePageIntent(page);
       if (interactivesIntent) {
@@ -5088,6 +5613,11 @@ function buildScopedContext(page, mode) {
         sections.push(formatHighlights(interactivesHighlights));
         sections.push("");
       }
+      if (cartSnapshot) {
+        sections.push("### Cart Snapshot");
+        sections.push(cartSnapshot);
+        sections.push("");
+      }
       if ((page.pageIssues?.length ?? 0) > 0) {
         sections.push("### Page Access Warnings");
         sections.push(formatPageIssues(page.pageIssues ?? []));
@@ -5095,7 +5625,12 @@ function buildScopedContext(page, mode) {
       }
       if (page.overlays.length > 0) {
         sections.push("### Active Overlays");
-        sections.push(formatOverlays(page.overlays));
+        sections.push(formatOverlays(page));
+        sections.push("");
+      }
+      if (dialogFocus) {
+        sections.push("### Immediate Overlay Actions");
+        sections.push(dialogFocus);
         sections.push("");
       }
       if (page.dormantOverlays.length > 0) {
@@ -5108,6 +5643,11 @@ function buildScopedContext(page, mode) {
         sections.push(formatNavigation(page.navigation));
         sections.push("");
       }
+      if (quantityElements.length > 0) {
+        sections.push("### Quantity / Count Controls");
+        sections.push(formatQuantityElements(quantityElements));
+        sections.push("");
+      }
       if (page.interactiveElements.length > 0) {
         sections.push(
           `### Interactive Elements (${page.interactiveElements.length})`
@@ -5118,9 +5658,15 @@ function buildScopedContext(page, mode) {
     }
     case "forms_only": {
       const sections = [];
+      const quantityElements = getQuantityElements(page);
+      const cartSnapshot = formatCartSnapshot(page);
       sections.push(`**URL:** ${page.url}`);
       sections.push(`**Title:** ${page.title}`);
       sections.push(`**Viewport:** ${formatViewport(page)}`);
+      const visibleScrollHints = getScrollHints(page);
+      if (visibleScrollHints.length > 0) {
+        sections.push(`**Scroll Hint:** ${visibleScrollHints[0]}`);
+      }
       sections.push("");
       const formsHighlights = getHighlightsForPage(page.url);
       if (formsHighlights.length > 0) {
@@ -5128,6 +5674,11 @@ function buildScopedContext(page, mode) {
         sections.push(formatHighlights(formsHighlights));
         sections.push("");
       }
+      if (cartSnapshot) {
+        sections.push("### Cart Snapshot");
+        sections.push(cartSnapshot);
+        sections.push("");
+      }
       if ((page.pageIssues?.length ?? 0) > 0) {
         sections.push("### Page Access Warnings");
         sections.push(formatPageIssues(page.pageIssues ?? []));
@@ -5135,7 +5686,7 @@ function buildScopedContext(page, mode) {
       }
       if (page.overlays.length > 0) {
         sections.push("### Active Overlays");
-        sections.push(formatOverlays(page.overlays));
+        sections.push(formatOverlays(page));
         sections.push("");
       }
       if (page.dormantOverlays.length > 0) {
@@ -5143,6 +5694,11 @@ function buildScopedContext(page, mode) {
         sections.push(formatDormantOverlays(page.dormantOverlays));
         sections.push("");
       }
+      if (quantityElements.length > 0) {
+        sections.push("### Quantity / Count Controls");
+        sections.push(formatQuantityElements(quantityElements));
+        sections.push("");
+      }
       if (page.forms.length > 0) {
         sections.push(`### Forms (${page.forms.length})`);
         sections.push(formatForms(page.forms));
@@ -5175,10 +5731,21 @@ function buildScopedContext(page, mode) {
     case "visible_only": {
       const visibleElements = page.interactiveElements.filter(isVisibleToUser);
       const visibleNav = page.navigation.filter(isVisibleToUser);
-      const visibleForms = page.forms.map((form) => ({
-        ...form,
-        fields: form.fields.filter(isVisibleToUser)
-      })).filter((form) => form.fields.length > 0);
+      const dialogFocusedElements = getDialogFocusedElements(page);
+      const visiblePage = {
+        ...page,
+        interactiveElements: dialogFocusedElements.length > 0 ? dialogFocusedElements : visibleElements,
+        forms: page.forms.map((form) => ({
+          ...form,
+          fields: form.fields.filter(
+            (field) => isVisibleToUser(field) && (dialogFocusedElements.length === 0 || field.context === "dialog")
+          )
+        })).filter((form) => form.fields.length > 0)
+      };
+      const quantityElements = getQuantityElements(visiblePage);
+      const cartSnapshot = formatCartSnapshot(visiblePage);
+      const visibleForms = visiblePage.forms;
+      const dialogFocus = formatDialogFocus(page);
       const sections = [];
       sections.push(`**URL:** ${page.url}`);
       sections.push(`**Title:** ${page.title}`);
@@ -5190,6 +5757,11 @@ function buildScopedContext(page, mode) {
         sections.push(formatHighlights(visibleHighlights));
         sections.push("");
       }
+      if (cartSnapshot) {
+        sections.push("### Cart Snapshot");
+        sections.push(cartSnapshot);
+        sections.push("");
+      }
       if ((page.pageIssues?.length ?? 0) > 0) {
         sections.push("### Page Access Warnings");
         sections.push(formatPageIssues(page.pageIssues ?? []));
@@ -5197,7 +5769,18 @@ function buildScopedContext(page, mode) {
       }
       if (page.overlays.length > 0) {
         sections.push("### Active Overlays");
-        sections.push(formatOverlays(page.overlays));
+        sections.push(formatOverlays(page));
+        sections.push("");
+      }
+      if (dialogFocus) {
+        sections.push("### Immediate Overlay Actions");
+        sections.push(dialogFocus);
+        if (visibleElements.length > dialogFocusedElements.length) {
+          sections.push("");
+          sections.push(
+            `Background controls hidden while the dialog is active: ${visibleElements.length - dialogFocusedElements.length}`
+          );
+        }
         sections.push("");
       }
       if (page.dormantOverlays.length > 0) {
@@ -5210,11 +5793,18 @@ function buildScopedContext(page, mode) {
         sections.push(formatNavigation(visibleNav));
         sections.push("");
       }
-      if (visibleElements.length > 0) {
+      if (quantityElements.length > 0) {
+        sections.push("### Quantity / Count Controls");
+        sections.push(formatQuantityElements(quantityElements));
+        sections.push("");
+      }
+      if (visiblePage.interactiveElements.length > 0) {
+        sections.push(
+          `### Visible In-Viewport Interactive Elements (${visiblePage.interactiveElements.length})`
+        );
         sections.push(
-          `### Visible In-Viewport Interactive Elements (${visibleElements.length})`
+          formatInteractiveElements(visiblePage.interactiveElements)
         );
-        sections.push(formatInteractiveElements(visibleElements));
         sections.push("");
       }
       if (visibleForms.length > 0) {
@@ -5364,6 +5954,10 @@ function buildStructuredContext(page) {
   sections.push(`**Viewport:** ${formatViewport(page)}`);
   if (page.byline) sections.push(`**Author:** ${page.byline}`);
   if (page.excerpt) sections.push(`**Summary:** ${page.excerpt}`);
+  const structuredScrollHints = getScrollHints(page);
+  if (structuredScrollHints.length > 0) {
+    sections.push(`**Scroll Hint:** ${structuredScrollHints[0]}`);
+  }
   sections.push("");
   const pageIntent = analyzePageIntent(page);
   if (pageIntent) {
@@ -5402,7 +5996,7 @@ function buildStructuredContext(page) {
   sections.push(formatLandmarks(page.landmarks));
   sections.push("");
   sections.push("### Active Overlays / Modals");
-  sections.push(formatOverlays(page.overlays));
+  sections.push(formatOverlays(page));
   sections.push("");
   sections.push("### Dormant Consent / Modal UI");
   sections.push(formatDormantOverlays(page.dormantOverlays));
@@ -5481,6 +6075,83 @@ function buildGeneralPrompt(query) {
     user: query
   };
 }
+const WRAPPING_QUOTES = /* @__PURE__ */ new Set(['"', "'", "`"]);
+function stripWrappingQuotes(value) {
+  const trimmed = value.trim();
+  if (trimmed.length < 2) return trimmed;
+  const first = trimmed[0];
+  const last = trimmed[trimmed.length - 1];
+  if (first === last && WRAPPING_QUOTES.has(first)) {
+    return trimmed.slice(1, -1).trim();
+  }
+  return trimmed;
+}
+function normalizeArrayItem(value) {
+  if (typeof value === "string") {
+    return stripWrappingQuotes(value).trim();
+  }
+  return String(value).trim();
+}
+function normalizeLooseString(value) {
+  if (typeof value !== "string") return void 0;
+  const normalized = stripWrappingQuotes(value);
+  return normalized ? normalized : void 0;
+}
+function coerceOptionalNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  const normalized = normalizeLooseString(value);
+  if (!normalized) return void 0;
+  const parsed = Number(normalized);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function coerceStringArray(value) {
+  if (Array.isArray(value)) {
+    return value.map(normalizeArrayItem).filter(Boolean);
+  }
+  const normalized = normalizeLooseString(value);
+  if (!normalized) return [];
+  try {
+    const parsed = JSON.parse(normalized);
+    if (Array.isArray(parsed)) {
+      return parsed.map(normalizeArrayItem).filter(Boolean);
+    }
+  } catch {
+  }
+  const lines = normalized.split(/\r?\n/).map((line) => line.replace(/^\s*[-*]\s+/, "").trim()).filter(Boolean);
+  if (lines.length > 1) {
+    return lines;
+  }
+  return [normalized];
+}
+function optionalNumberLikeSchema() {
+  return zod.z.preprocess(
+    (value) => {
+      if (value == null) return void 0;
+      return coerceOptionalNumber(value) ?? value;
+    },
+    zod.z.number().finite().optional()
+  );
+}
+function normalizedOptionalStringSchema() {
+  return zod.z.preprocess(
+    (value) => {
+      if (value == null) return void 0;
+      return normalizeLooseString(value) ?? value;
+    },
+    zod.z.string().optional()
+  );
+}
+function stringArrayLikeSchema() {
+  return zod.z.preprocess(
+    (value) => {
+      if (value == null) return value;
+      return coerceStringArray(value) ?? value;
+    },
+    zod.z.array(zod.z.string().min(1)).min(1)
+  );
+}
 const TOOL_DEFINITIONS = [
   // --- Tab Management ---
   {
@@ -5609,7 +6280,9 @@ const TOOL_DEFINITIONS = [
     description: "Scroll the page up or down.",
     inputSchema: {
       direction: zod.z.enum(["up", "down"]).describe("Scroll direction"),
-      amount: zod.z.number().optional().describe("Pixels to scroll (default 500)")
+      amount: optionalNumberLikeSchema().describe(
+        "Pixels to scroll (default 500)"
+      )
     },
     tier: 0,
     relevance: ["ARTICLE", "SEARCH_RESULTS", "PAGINATED_LIST"]
@@ -5654,6 +6327,29 @@ const TOOL_DEFINITIONS = [
     description: "Dismiss a modal, popup, newsletter gate, cookie banner, or overlay using common close/decline actions.",
     tier: 1
   },
+  {
+    name: "clear_overlays",
+    title: "Clear Overlays",
+    description: "Work through blocking overlays and modals until the page is unblocked, using overlay-specific heuristics for consent banners and radio-selection dialogs.",
+    inputSchema: {
+      strategy: zod.z.enum(["auto", "interactive"]).optional().describe(
+        'How aggressively to clear overlays. "auto" uses heuristics; "interactive" stops earlier when human judgment may be needed.'
+      )
+    },
+    tier: 1
+  },
+  {
+    name: "inspect_element",
+    title: "Inspect Element",
+    description: "Inspect one element and its nearest local UI region such as a product card, result row, form section, or modal. Use this instead of reading the whole page when you only need local context.",
+    inputSchema: {
+      index: zod.z.number().optional().describe("Element index to inspect"),
+      selector: zod.z.string().optional().describe("CSS selector to inspect"),
+      limit: zod.z.number().optional().describe("Maximum nearby controls to include (default 8)")
+    },
+    tier: 1,
+    relevance: ["SEARCH_RESULTS", "SHOPPING", "FORM"]
+  },
   {
     name: "read_page",
     title: "Read Page",
@@ -5841,7 +6537,9 @@ const TOOL_DEFINITIONS = [
     inputSchema: {
       index: zod.z.number().optional().describe("Element index from page content to highlight"),
       selector: zod.z.string().optional().describe("CSS selector of element to highlight"),
-      text: zod.z.string().optional().describe("Text to find and highlight on the page (all occurrences)"),
+      text: normalizedOptionalStringSchema().describe(
+        "Text to find and highlight on the page (all occurrences)"
+      ),
       label: zod.z.string().optional().describe("Annotation label to display near the highlight"),
       durationMs: zod.z.number().optional().describe(
         "Auto-clear after this many milliseconds (omit for permanent)"
@@ -5866,11 +6564,12 @@ const TOOL_DEFINITIONS = [
       goal: zod.z.string().describe(
         "What this workflow accomplishes (e.g. 'Purchase item from Amazon')"
       ),
-      steps: zod.z.array(zod.z.string()).describe(
+      steps: stringArrayLikeSchema().describe(
         "Ordered list of step labels (e.g. ['Log in', 'Search', 'Select item', 'Checkout'])"
       )
     },
-    tier: 1
+    tier: 1,
+    hiddenByDefault: true
   },
   {
     name: "flow_advance",
@@ -5879,26 +6578,30 @@ const TOOL_DEFINITIONS = [
     inputSchema: {
       detail: zod.z.string().optional().describe("Brief note about what was accomplished")
     },
-    tier: 1
+    tier: 1,
+    hiddenByDefault: true
   },
   {
     name: "flow_status",
     title: "Workflow Status",
     description: "Check the current workflow progress.",
-    tier: 2
+    tier: 2,
+    hiddenByDefault: true
   },
   {
     name: "flow_end",
     title: "End Workflow",
     description: "Clear the active workflow tracker.",
-    tier: 2
+    tier: 2,
+    hiddenByDefault: true
   },
   // --- Speedee System: Suggestion Engine ---
   {
     name: "suggest",
     title: "What Should I Do?",
     description: "Analyze the current page and return the most relevant tools and suggested next actions. Call this when unsure what to do.",
-    tier: 1
+    tier: 1,
+    hiddenByDefault: true
   },
   // --- Speedee System: Composable Macros ---
   {
@@ -5910,9 +6613,14 @@ const TOOL_DEFINITIONS = [
         zod.z.object({
           index: zod.z.number().optional().describe("Element index from page content"),
           selector: zod.z.string().optional().describe("CSS selector fallback"),
+          name: zod.z.string().optional().describe("Field name or id, such as custname"),
+          label: zod.z.string().optional().describe("Visible label or aria-label text"),
+          placeholder: zod.z.string().optional().describe("Placeholder text shown in the field"),
           value: zod.z.string().describe("Value to enter")
         })
-      ).describe("Fields to fill"),
+      ).describe(
+        "Fields to fill, matched by index, selector, name, label, or placeholder"
+      ),
       submit: zod.z.boolean().optional().describe("Submit the form after filling (default false)")
     },
     tier: 1,
@@ -5998,14 +6706,16 @@ const TOOL_DEFINITIONS = [
     inputSchema: {
       timeoutMs: zod.z.number().optional().describe("Maximum time to wait in milliseconds (default 10000)")
     },
-    tier: 1
+    tier: 1,
+    hiddenByDefault: true
   },
   // --- Speedee System: Metrics ---
   {
     name: "metrics",
     title: "Session Metrics",
     description: "Show performance metrics for this session: total tool calls, average duration, per-tool breakdown, and error rates.",
-    tier: 2
+    tier: 2,
+    hiddenByDefault: true
   }
 ];
 function toAnthropicTools(defs) {
@@ -6047,16 +6757,19 @@ const CONTEXT_HINTS = {
   SEARCH_RESULTS: {
     paginate: "⚡ PAGINATION DETECTED — ",
     search: "⚡ Refine search — ",
+    inspect_element: "⚡ Inspect one result card without reading the whole page — ",
     highlight: "💡 Mark interesting results — "
   },
   SHOPPING: {
     fill_form: "⚡ CHECKOUT FIELDS DETECTED — ",
-    select_option: "⚡ Payment/shipping options available — "
+    select_option: "⚡ Payment/shipping options available — ",
+    inspect_element: "⚡ Inspect the current product card or option group — "
   },
   FORM: {
     fill_form: "⚡ FORM DETECTED — ",
     select_option: "⚡ Dropdown fields on page — ",
-    submit_form: "⚡ Form ready to submit — "
+    submit_form: "⚡ Form ready to submit — ",
+    inspect_element: "⚡ Inspect just this form section — "
   },
   PAGINATED_LIST: {
     paginate: "⚡ PAGINATION DETECTED — ",
@@ -6079,23 +6792,122 @@ function scoreForContext(toolName, pageType) {
   if (tier === 2 && isRelevant) return 20;
   return 40;
 }
-function pruneToolsForContext(tools, pageType) {
-  const ctx = pageType ?? "GENERAL";
-  const hints = CONTEXT_HINTS[ctx] ?? {};
-  const scored = tools.map((tool) => ({
-    tool,
-    score: scoreForContext(tool.name, ctx)
-  }));
-  scored.sort((a, b) => a.score - b.score);
-  return scored.map(({ tool, score }) => {
-    const hint = hints[tool.name];
-    if (hint && score <= 20) {
-      return {
-        ...tool,
-        description: hint + tool.description
-      };
-    }
-    return tool;
+const ALWAYS_FAST_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "current_tab",
+  "navigate",
+  "click",
+  "type_text",
+  "press_key",
+  "search",
+  "scroll",
+  "dismiss_popup",
+  "clear_overlays",
+  "accept_cookies",
+  "wait_for",
+  "read_page",
+  "inspect_element"
+]);
+function inferIntent(query) {
+  const lowered = query.toLowerCase();
+  const intents = /* @__PURE__ */ new Set();
+  if (/\b(tab|tabs|window|windows)\b/.test(lowered)) intents.add("tabs");
+  if (/\b(bookmark|bookmarks|save this|folder)\b/.test(lowered)) {
+    intents.add("bookmarks");
+  }
+  if (/\b(session|cookies|log in|login|sign in|sign-in|resume)\b/.test(lowered)) {
+    intents.add("sessions");
+  }
+  if (/\b(flow|workflow|checkpoint|step|progress|plan)\b/.test(lowered)) {
+    intents.add("workflow");
+  }
+  if (/\b(metric|metrics|performance|slow|latency)\b/.test(lowered)) {
+    intents.add("metrics");
+  }
+  if (/\b(highlight|mark|annotate)\b/.test(lowered)) intents.add("highlight");
+  if (/\b(table|csv|rows|columns)\b/.test(lowered)) intents.add("table");
+  if (/\b(overlay|modal|popup|consent|cookie|blocking ui)\b/.test(lowered)) {
+    intents.add("debug");
+  }
+  if (/\b(debug|diagnose|what should i do|stuck|inspect)\b/.test(lowered)) {
+    intents.add("debug");
+  }
+  return intents;
+}
+function shouldIncludeTool(toolName, pageType, intents) {
+  if (ALWAYS_FAST_TOOL_NAMES.has(toolName)) return true;
+  switch (toolName) {
+    case "select_option":
+    case "submit_form":
+    case "fill_form":
+      return pageType === "FORM" || pageType === "SHOPPING" || pageType === "LOGIN";
+    case "paginate":
+      return pageType === "SEARCH_RESULTS" || pageType === "PAGINATED_LIST";
+    case "login":
+      return pageType === "LOGIN" || intents.has("sessions");
+    case "focus":
+      return pageType === "FORM" || pageType === "LOGIN" || pageType === "SEARCH_READY";
+    case "scroll_to_element":
+      return pageType === "SEARCH_RESULTS" || pageType === "SHOPPING" || intents.has("debug");
+    case "go_back":
+      return true;
+    case "go_forward":
+    case "reload":
+    case "hover":
+      return intents.has("debug");
+    case "highlight":
+    case "clear_highlights":
+      return intents.has("highlight");
+    case "list_tabs":
+    case "switch_tab":
+    case "create_tab":
+    case "set_ad_blocking":
+      return intents.has("tabs") || intents.has("debug");
+    case "save_session":
+    case "load_session":
+    case "list_sessions":
+    case "delete_session":
+      return intents.has("sessions");
+    case "list_bookmarks":
+    case "search_bookmarks":
+    case "create_bookmark_folder":
+    case "save_bookmark":
+    case "organize_bookmark":
+    case "archive_bookmark":
+    case "open_bookmark":
+      return intents.has("bookmarks");
+    case "flow_start":
+    case "flow_advance":
+    case "flow_status":
+    case "flow_end":
+      return intents.has("workflow");
+    case "suggest":
+    case "wait_for_navigation":
+    case "metrics":
+      return intents.has("debug") || intents.has("metrics");
+    case "extract_table":
+      return intents.has("table");
+    default:
+      return !defByName[toolName]?.hiddenByDefault;
+  }
+}
+function pruneToolsForContext(tools, pageType, query = "") {
+  const ctx = pageType ?? "GENERAL";
+  const hints = CONTEXT_HINTS[ctx] ?? {};
+  const intents = inferIntent(query);
+  const scored = tools.filter((tool) => shouldIncludeTool(tool.name, ctx, intents)).map((tool) => ({
+    tool,
+    score: scoreForContext(tool.name, ctx)
+  }));
+  scored.sort((a, b) => a.score - b.score);
+  return scored.map(({ tool, score }) => {
+    const hint = hints[tool.name];
+    if (hint && score <= 20) {
+      return {
+        ...tool,
+        description: hint + tool.description
+      };
+    }
+    return tool;
   });
 }
 function trimText(value) {
@@ -6682,7 +7494,7 @@ async function validateLinkDestination(url, timeoutMs = 3500) {
 function formatDeadLinkMessage(label, result) {
   const destination = result.finalUrl || result.checkedUrl;
   const status = result.statusCode ? `HTTP ${result.statusCode}` : "dead link";
-  return `Skipped stale link "${label}" because ${destination} returned ${status}.`;
+  return `Skipped stale link "${label}" because ${destination} returned ${status}. Try a different link or URL instead.`;
 }
 const SESSION_VERSION = 1;
 function getSessionsDir() {
@@ -7320,10 +8132,297 @@ async function describeElementForClick$1(wc, selector) {
     href: "href" in result && typeof result.href === "string" ? result.href : void 0
   };
 }
+async function inspectElement(wc, selector, limit = 8) {
+  const result = await executePageScript(
+    wc,
+    `
+    (function() {
+      function text(value) {
+        const trimmed = value == null ? "" : String(value).trim();
+        return trimmed || undefined;
+      }
+
+      function escapeSelectorValue(value) {
+        if (typeof CSS !== "undefined" && typeof CSS.escape === "function") {
+          return CSS.escape(value);
+        }
+        return String(value).replace(/["\\\\]/g, "\\\\$&");
+      }
+
+      function uniqueSelector(candidate) {
+        if (!candidate) return null;
+        try {
+          return document.querySelectorAll(candidate).length === 1 ? candidate : null;
+        } catch {
+          return null;
+        }
+      }
+
+      function uniqueAttributeSelector(el, attribute) {
+        const value = text(el.getAttribute && el.getAttribute(attribute));
+        if (!value) return null;
+        const candidate = el.tagName.toLowerCase() + "[" + attribute + "=\\"" + escapeSelectorValue(value) + "\\"]";
+        return uniqueSelector(candidate);
+      }
+
+      function selectorFor(el) {
+        if (!el) return null;
+        if (el.id) return "#" + escapeSelectorValue(el.id);
+        for (const attribute of ["data-testid", "name", "form", "aria-label", "title"]) {
+          const candidate = uniqueAttributeSelector(el, attribute);
+          if (candidate) return candidate;
+        }
+        const parts = [];
+        let current = el;
+        while (current) {
+          if (current.id) {
+            parts.unshift("#" + escapeSelectorValue(current.id));
+            break;
+          }
+          const tag = current.tagName.toLowerCase();
+          const parent = current.parentElement;
+          if (!parent) { parts.unshift(tag); break; }
+          const siblings = Array.from(parent.children).filter((child) => child.tagName === current.tagName);
+          const index = siblings.indexOf(current) + 1;
+          parts.unshift(siblings.length > 1 ? tag + ":nth-of-type(" + index + ")" : tag);
+          current = parent;
+        }
+        const selector = parts.join(" > ");
+        return uniqueSelector(selector) || selector;
+      }
+
+      function isVisible(el) {
+        if (!(el instanceof HTMLElement)) return true;
+        const style = window.getComputedStyle(el);
+        if (style.display === "none" || style.visibility === "hidden" || style.opacity === "0") {
+          return false;
+        }
+        const rect = el.getBoundingClientRect();
+        return rect.width > 0 && rect.height > 0;
+      }
+
+      function labelFor(el) {
+        return text(
+          el.getAttribute("aria-label") ||
+          el.getAttribute("title") ||
+          el.getAttribute("name") ||
+          el.getAttribute("placeholder") ||
+          el.textContent ||
+          el.getAttribute("value") ||
+          el.tagName
+        ) || "element";
+      }
+
+      function chooseRegion(target) {
+        const preferred = target.closest(
+          "[data-testid], article, [role='article'], [role='listitem'], li, tr, form, section, aside, dialog, [role='dialog']"
+        );
+        if (preferred) return preferred;
+        let current = target.parentElement;
+        let depth = 0;
+        while (current && depth < 5) {
+          const count = current.querySelectorAll("a[href], button, input, select, textarea").length;
+          if (count >= 2 && count <= 16) return current;
+          current = current.parentElement;
+          depth += 1;
+        }
+        return target.parentElement || target;
+      }
+
+      const target = document.querySelector(${JSON.stringify(selector)});
+      if (!target) return { error: "Element not found" };
+      if (target instanceof HTMLElement) {
+        target.scrollIntoView({ behavior: "instant", block: "center", inline: "center" });
+      }
+
+      const region = chooseRegion(target);
+      const nearby = [];
+      const seen = new Set();
+      region.querySelectorAll("a[href], button, input:not([type='hidden']), select, textarea").forEach((el) => {
+        if (!(el instanceof HTMLElement) || !isVisible(el)) return;
+        const candidateSelector = selectorFor(el);
+        if (!candidateSelector || seen.has(candidateSelector)) return;
+        seen.add(candidateSelector);
+        nearby.push({
+          label: labelFor(el).slice(0, 100),
+          type: el.tagName.toLowerCase(),
+          selector: candidateSelector,
+          href: el instanceof HTMLAnchorElement ? text(el.href) : undefined,
+        });
+      });
+
+      return {
+        target: {
+          label: labelFor(target).slice(0, 120),
+          tag: target.tagName.toLowerCase(),
+          text: text(target.textContent)?.slice(0, 240),
+          href: target instanceof HTMLAnchorElement ? text(target.href) : undefined,
+          value: target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement || target instanceof HTMLSelectElement
+            ? text(target.value)?.slice(0, 120)
+            : undefined,
+        },
+        region: {
+          tag: region.tagName.toLowerCase(),
+          label: labelFor(region).slice(0, 120),
+          text: text(region.textContent)?.slice(0, 400),
+        },
+        nearby: nearby.slice(0, ${Math.max(1, Math.min(20, limit))}),
+      };
+    })()
+  `,
+    {
+      timeoutMs: 2e3,
+      label: "inspect element"
+    }
+  );
+  if (result === PAGE_SCRIPT_TIMEOUT) {
+    return pageBusyError("inspect_element");
+  }
+  if (!result || typeof result !== "object") {
+    return "Error: Could not inspect element";
+  }
+  if ("error" in result && typeof result.error === "string") {
+    return `Error: ${result.error}`;
+  }
+  const lines = [];
+  if (result.target) {
+    lines.push(`Target: ${result.target.label} <${result.target.tag}>`);
+    if (result.target.text) lines.push(`Target text: ${result.target.text}`);
+    if (result.target.href) lines.push(`Target href: ${result.target.href}`);
+    if (result.target.value) lines.push(`Target value: ${result.target.value}`);
+  }
+  if (result.region) {
+    lines.push(`Region: ${result.region.label} <${result.region.tag}>`);
+    if (result.region.text) lines.push(`Region text: ${result.region.text}`);
+  }
+  if (Array.isArray(result.nearby) && result.nearby.length > 0) {
+    lines.push("Nearby controls:");
+    for (const item of result.nearby) {
+      const hrefSuffix = item.href ? ` -> ${item.href}` : "";
+      lines.push(
+        `- ${item.label} [${item.type}] selector=${item.selector}${hrefSuffix}`
+      );
+    }
+  }
+  return lines.join("\n");
+}
+async function getLocaleSnapshot(wc) {
+  const snapshot = await executePageScript(
+    wc,
+    `
+    (function() {
+      return {
+        lang:
+          document.documentElement?.lang ||
+          document.body?.lang ||
+          navigator.language ||
+          "",
+        url: window.location.href || "",
+        title: document.title || "",
+      };
+    })()
+  `,
+    {
+      label: "locale snapshot"
+    }
+  );
+  if (!snapshot || snapshot === PAGE_SCRIPT_TIMEOUT || typeof snapshot !== "object") {
+    return null;
+  }
+  return {
+    lang: typeof snapshot.lang === "string" ? snapshot.lang.trim() : "",
+    url: typeof snapshot.url === "string" ? snapshot.url : wc.getURL(),
+    title: typeof snapshot.title === "string" ? snapshot.title : wc.getTitle()
+  };
+}
+function primaryLanguageTag(value) {
+  return value.trim().toLowerCase().split(/[-_]/)[0] || "";
+}
+function localeChanged(before, after) {
+  if (!before || !after) return false;
+  const beforeLang = primaryLanguageTag(before.lang);
+  const afterLang = primaryLanguageTag(after.lang);
+  if (beforeLang && afterLang && beforeLang !== afterLang) {
+    return true;
+  }
+  const localeHint = /[?&](lang|locale|language|hl)=|\/(ja|jp|en|fr|de|es|it|ko|zh)(\/|$)/i;
+  return before.url !== after.url && localeHint.test(after.url);
+}
+async function restoreLocaleSnapshot(wc, snapshot) {
+  if (!snapshot || wc.isDestroyed()) return;
+  try {
+    if (typeof wc.canGoBack === "function" && wc.canGoBack()) {
+      wc.goBack();
+      await waitForLoad$1(wc, 3e3);
+      const reverted = await getLocaleSnapshot(wc);
+      if (!localeChanged(snapshot, reverted)) {
+        return;
+      }
+    }
+  } catch {
+  }
+  if (snapshot.url && snapshot.url !== wc.getURL()) {
+    try {
+      await wc.loadURL(snapshot.url);
+      await waitForLoad$1(wc, 3e3);
+      return;
+    } catch {
+    }
+  }
+  if (snapshot.url) {
+    try {
+      await wc.reload();
+      await waitForLoad$1(wc, 3e3);
+    } catch {
+    }
+  }
+}
+const ADD_TO_CART_PATTERNS = [
+  "add to cart",
+  "add to bag",
+  "add to basket",
+  "add to my cart",
+  "add to my bag",
+  "add to my basket",
+  "add item to cart",
+  "add item to bag",
+  "add item to basket"
+];
+const recentCartClicks = /* @__PURE__ */ new Map();
+const CART_CLICK_COOLDOWN_MS = 15e3;
+function isAddToCartText(text) {
+  const normalized = text.toLowerCase().replace(/\s+/g, " ").trim();
+  return ADD_TO_CART_PATTERNS.some((p) => normalized.includes(p));
+}
+function recordCartClick(url, text) {
+  recentCartClicks.set(url, { text, ts: Date.now() });
+  for (const [key, entry] of recentCartClicks) {
+    if (Date.now() - entry.ts > CART_CLICK_COOLDOWN_MS) {
+      recentCartClicks.delete(key);
+    }
+  }
+}
+function isDuplicateCartClick(url, text) {
+  const recent = recentCartClicks.get(url);
+  if (!recent) return false;
+  if (Date.now() - recent.ts > CART_CLICK_COOLDOWN_MS) {
+    recentCartClicks.delete(url);
+    return false;
+  }
+  return isAddToCartText(text);
+}
 async function clickResolvedSelector$1(wc, selector) {
   if (selector.startsWith("__vessel_idx:")) {
     const idx = Number(selector.slice("__vessel_idx:".length));
     const beforeUrl2 = wc.getURL();
+    const idxLabel = await executePageScript(
+      wc,
+      `window.__vessel?.getElementText?.(${idx}) || ""`,
+      { label: "shadow element text" }
+    );
+    if (typeof idxLabel === "string" && isAddToCartText(idxLabel) && isDuplicateCartClick(beforeUrl2, idxLabel)) {
+      return `Blocked: "${idxLabel}" was already clicked on this page. The item is in your cart. Call read_page to see available actions (e.g. View Cart, Continue Shopping).`;
+    }
     const result = await executePageScript(
       wc,
       `window.__vessel?.interactByIndex?.(${idx}, "click") || "Error: interactByIndex not available"`,
@@ -7333,12 +8432,29 @@ async function clickResolvedSelector$1(wc, selector) {
     );
     if (result === PAGE_SCRIPT_TIMEOUT) return pageBusyError("click");
     if (typeof result === "string" && result.startsWith("Error")) return result;
+    if (typeof idxLabel === "string" && isAddToCartText(idxLabel)) {
+      recordCartClick(beforeUrl2, idxLabel);
+    }
     await waitForPotentialNavigation$1(wc, beforeUrl2);
     const afterUrl2 = wc.getURL();
-    return afterUrl2 !== beforeUrl2 ? `${result} -> ${afterUrl2}` : result;
+    if (afterUrl2 !== beforeUrl2) return `${result} -> ${afterUrl2}`;
+    const idxOverlay = await detectPostClickOverlay$1(wc);
+    return idxOverlay ? `${result}
+${idxOverlay}` : result;
   }
   if (selector.includes(" >>> ")) {
     const beforeUrl2 = wc.getURL();
+    const shadowLabel = await executePageScript(
+      wc,
+      `(function() {
+        var el = window.__vessel?.resolveShadowSelector?.(${JSON.stringify(selector)});
+        return el ? (el.getAttribute("aria-label") || el.textContent?.trim().slice(0, 60) || "") : "";
+      })()`,
+      { label: "shadow element text" }
+    );
+    if (typeof shadowLabel === "string" && isAddToCartText(shadowLabel) && isDuplicateCartClick(beforeUrl2, shadowLabel)) {
+      return `Blocked: "${shadowLabel}" was already clicked on this page. The item is in your cart. Call read_page to see available actions (e.g. View Cart, Continue Shopping).`;
+    }
     const result = await executePageScript(
       wc,
       `
@@ -7355,19 +8471,48 @@ async function clickResolvedSelector$1(wc, selector) {
     );
     if (result === PAGE_SCRIPT_TIMEOUT) return pageBusyError("click");
     if (typeof result === "string" && result.startsWith("Error")) return result;
+    if (typeof shadowLabel === "string" && isAddToCartText(shadowLabel)) {
+      recordCartClick(beforeUrl2, shadowLabel);
+    }
     await waitForPotentialNavigation$1(wc, beforeUrl2);
     const afterUrl2 = wc.getURL();
-    return afterUrl2 !== beforeUrl2 ? `${result} -> ${afterUrl2}` : result;
+    if (afterUrl2 !== beforeUrl2) return `${result} -> ${afterUrl2}`;
+    const shadowOverlay = await detectPostClickOverlay$1(wc);
+    return shadowOverlay ? `${result}
+${shadowOverlay}` : result;
   }
   const beforeUrl = wc.getURL();
   const elInfo = await describeElementForClick$1(wc, selector);
   if ("error" in elInfo) return `Error: ${elInfo.error}`;
+  const cartMatch = isAddToCartText(elInfo.text);
+  console.log(
+    `[Vessel cart-guard] text="${elInfo.text}" cartMatch=${cartMatch} url=${beforeUrl} hasPrior=${recentCartClicks.has(beforeUrl)}`
+  );
+  if (cartMatch && isDuplicateCartClick(beforeUrl, elInfo.text)) {
+    console.log(`[Vessel cart-guard] BLOCKED duplicate add-to-cart click`);
+    return `Blocked: "${elInfo.text}" was already clicked on this page. The item is in your cart. Call read_page to see available actions (e.g. View Cart, Continue Shopping).`;
+  }
+  if (!cartMatch && recentCartClicks.has(beforeUrl)) {
+    const dialogActions = await getCartDialogActions$1(wc);
+    if (dialogActions) {
+      console.log(
+        `[Vessel cart-guard] BLOCKED background click while cart dialog is open`
+      );
+      return `Blocked: a cart confirmation dialog is open. Do not click background elements.
+${dialogActions}
+Click one of these dialog actions instead.`;
+    }
+  }
   if (elInfo.href) {
     const validation = await validateLinkDestination(elInfo.href);
     if (validation.status === "dead") {
       return formatDeadLinkMessage(elInfo.text, validation);
     }
   }
+  if (cartMatch) {
+    console.log(`[Vessel cart-guard] RECORDED cart click for url=${beforeUrl}`);
+    recordCartClick(beforeUrl, elInfo.text);
+  }
   const clickText = `Clicked: ${elInfo.text}`;
   const clickResult = await clickElement$1(wc, selector);
   if (clickResult.startsWith("Error:")) return clickResult;
@@ -7376,6 +8521,18 @@ async function clickResolvedSelector$1(wc, selector) {
   if (afterUrl !== beforeUrl) {
     return `${clickText} -> ${afterUrl}`;
   }
+  const overlayHint = await detectPostClickOverlay$1(wc);
+  if (overlayHint) {
+    const dialogActions = cartMatch ? await getCartDialogActions$1(wc) : null;
+    const actionsSuffix = dialogActions ? `
+${dialogActions}
+Click one of these dialog actions. Do NOT click any other element.` : "";
+    return `${clickText} (${clickResult})
+${overlayHint}${actionsSuffix}`;
+  }
+  if (cartMatch) {
+    return `${clickText} (${clickResult})`;
+  }
   const activationResult = await activateElement$1(wc, selector);
   if (!activationResult.startsWith("Error:")) {
     await waitForPotentialNavigation$1(wc, beforeUrl);
@@ -7384,14 +8541,226 @@ async function clickResolvedSelector$1(wc, selector) {
       return `${clickText} -> ${fallbackUrl} (recovered via DOM activation)`;
     }
   }
+  const postActivationOverlayHint = await detectPostClickOverlay$1(wc);
+  if (postActivationOverlayHint) {
+    return `${clickText} (${clickResult})
+${postActivationOverlayHint}`;
+  }
   return `${clickText} (${clickResult})`;
 }
+async function getCartDialogActions$1(wc) {
+  const result = await executePageScript(
+    wc,
+    `
+    (function() {
+      var dialog = document.querySelector('[role="dialog"], dialog[open], [role="alertdialog"], [aria-modal="true"]');
+      if (!dialog) return { found: false, actions: [] };
+      var cs = getComputedStyle(dialog);
+      if (cs.display === 'none' || cs.visibility === 'hidden') return { found: false, actions: [] };
+      var text = (dialog.textContent || '').slice(0, 500).toLowerCase();
+      var cartSignals = ['added to cart','added to bag','added to basket',
+        'item added','your basket','your cart','your bag',
+        'view basket','view cart','continue shopping'];
+      var isCart = cartSignals.some(function(s) { return text.indexOf(s) !== -1; });
+      if (!isCart) return { found: false, actions: [] };
+      var actions = [];
+      dialog.querySelectorAll('button, a[href], [role="button"]').forEach(function(el) {
+        var cs2 = getComputedStyle(el);
+        if (cs2.display === 'none' || cs2.visibility === 'hidden') return;
+        var r = el.getBoundingClientRect();
+        if (r.width < 20 || r.height < 10) return;
+        var label = (el.getAttribute('aria-label') || el.textContent || '').trim().slice(0, 80);
+        if (!label || label.length < 2) return;
+        var href = el.getAttribute('href') || '';
+        var sel = el.id ? '#' + el.id
+          : el.getAttribute('data-test') ? '[data-test="' + el.getAttribute('data-test') + '"]'
+          : el.getAttribute('aria-label') ? '[aria-label="' + el.getAttribute('aria-label') + '"]'
+          : null;
+        if (sel) actions.push({ label: label, selector: sel, href: href });
+      });
+      return {
+        found: true,
+        actions: actions.map(function(a) {
+          return '- "' + a.label + '"' + (a.href ? ' → ' + a.href : '') + (a.selector ? ' (selector: ' + a.selector + ')' : '');
+        }),
+      };
+    })()
+    `,
+    { timeoutMs: 800, label: "get cart dialog actions" }
+  );
+  if (!result || result === PAGE_SCRIPT_TIMEOUT || !result.found) return null;
+  if (result.actions.length === 0) return null;
+  return `Available dialog actions:
+${result.actions.join("\n")}`;
+}
+async function detectPostClickOverlay$1(wc) {
+  const result = await executePageScript(
+    wc,
+    `
+    (function() {
+      var vw = window.innerWidth || document.documentElement.clientWidth;
+      var vh = window.innerHeight || document.documentElement.clientHeight;
+      var vpArea = Math.max(1, vw * vh);
+
+      function isVis(el) {
+        var cs = getComputedStyle(el);
+        return cs.display !== 'none' && cs.visibility !== 'hidden' &&
+          el.getBoundingClientRect().width > 0;
+      }
+
+      function hasFixedAncestor(el) {
+        var cur = el.parentElement;
+        while (cur && cur !== document.body) {
+          var ps = getComputedStyle(cur).position;
+          if (ps === 'fixed' || ps === 'sticky') return true;
+          cur = cur.parentElement;
+        }
+        return false;
+      }
+
+      function effectiveZ(el) {
+        var cur = el;
+        while (cur && cur !== document.body) {
+          var z = parseInt(getComputedStyle(cur).zIndex, 10);
+          if (z > 0) return z;
+          cur = cur.parentElement;
+        }
+        return 0;
+      }
+
+      function edgePad(r) {
+        return r.left <= 24 || r.top <= 24 ||
+          r.right >= vw - 24 || r.bottom >= vh - 24;
+      }
+
+      var cartPhrases = ['added to cart','added to bag','added to basket',
+        'added to your cart','added to your bag','added to your basket'];
+      var cartActions = ['view cart','go to cart','continue shopping',
+        'keep shopping','checkout','view basket','go to basket'];
+
+      // Phase 1: semantic dialog elements
+      var selectors = 'dialog[open], [role="dialog"], [role="alertdialog"], [aria-modal="true"]';
+      var candidates = document.querySelectorAll(selectors);
+      var hit = null;
+      for (var j = 0; j < candidates.length; j++) {
+        if (isVis(candidates[j])) { hit = candidates[j]; break; }
+      }
+
+      // Phase 2: positioned drawer-like elements
+      if (!hit) {
+        var els = document.querySelectorAll('*');
+        for (var i = 0; i < els.length; i++) {
+          var s = getComputedStyle(els[i]);
+          if (s.display === 'none' || s.visibility === 'hidden') continue;
+          var pos = s.position;
+          var isFixed = pos === 'fixed' || pos === 'sticky';
+          var isAbs = pos === 'absolute';
+          if (!isFixed && !isAbs) continue;
+          if (isAbs && !hasFixedAncestor(els[i])) continue;
+          if (effectiveZ(els[i]) < 5) continue;
+          var r = els[i].getBoundingClientRect();
+          var area = (r.width * r.height) / vpArea;
+          if (r.width >= 160 && r.height >= 100 && area >= 0.05 && edgePad(r)) {
+            hit = els[i]; break;
+          }
+        }
+      }
+
+      // Phase 3: text-based fallback — any positioned element with cart confirmation text
+      if (!hit) {
+        var els2 = document.querySelectorAll('*');
+        for (var k = 0; k < els2.length; k++) {
+          var s2 = getComputedStyle(els2[k]);
+          if (s2.display === 'none' || s2.visibility === 'hidden') continue;
+          var p2 = s2.position;
+          if (p2 !== 'fixed' && p2 !== 'sticky' && p2 !== 'absolute') continue;
+          var r2 = els2[k].getBoundingClientRect();
+          if (r2.width < 120 || r2.height < 80) continue;
+          var innerText = (els2[k].textContent || '').slice(0, 500).toLowerCase();
+          var hasConfirm = cartPhrases.some(function(ph) { return innerText.indexOf(ph) !== -1; });
+          if (hasConfirm) { hit = els2[k]; break; }
+        }
+      }
+
+      if (!hit) return { found: false, label: '', cartLike: false };
+      var text = (hit.textContent || '').slice(0, 500).toLowerCase();
+      var cartLike = cartPhrases.concat(cartActions).some(function(s) { return text.indexOf(s) !== -1; });
+      var label = (hit.getAttribute('aria-label') || (hit.querySelector('h1,h2,h3,h4') || {}).textContent || '').trim().slice(0, 80);
+      return { found: true, label: label, cartLike: cartLike };
+    })()
+    `,
+    { timeoutMs: 800, label: "post-click overlay check" }
+  );
+  if (!result || result === PAGE_SCRIPT_TIMEOUT || !result.found) return null;
+  if (result.cartLike) {
+    const desc2 = result.label ? ` ("${result.label}")` : "";
+    return `A cart confirmation dialog appeared${desc2}. Call read_page to see available actions — do not click Add to Cart again.`;
+  }
+  const desc = result.label ? ` ("${result.label}")` : "";
+  return `A dialog or overlay appeared${desc}. Call read_page to see available actions.`;
+}
 async function dismissPopup$1(wc) {
   const before = await extractContent(wc);
   const initialBlocking = before.overlays.filter(
     (overlay) => overlay.blocksInteraction
   ).length;
+  if (initialBlocking > 0) {
+    const overlayText = before.overlays.map((o) => [o.label, o.text].filter(Boolean).join(" ")).join(" ").toLowerCase();
+    const cartSignals = [
+      "added to cart",
+      "added to bag",
+      "added to basket",
+      "item added",
+      "items in your basket",
+      "items in your cart",
+      "items in your bag",
+      "your basket",
+      "your cart",
+      "your bag",
+      "view basket",
+      "view cart",
+      "continue shopping"
+    ];
+    if (cartSignals.some((s) => overlayText.includes(s))) {
+      const continueResult = await executePageScript(
+        wc,
+        `
+        (function() {
+          var dialog = document.querySelector('[role="dialog"], dialog[open], [role="alertdialog"], [aria-modal="true"]');
+          if (!dialog) return "Error: dialog not found";
+          var buttons = dialog.querySelectorAll('button, a[href], [role="button"]');
+          var continueBtn = null;
+          var viewCartBtn = null;
+          for (var i = 0; i < buttons.length; i++) {
+            var label = (buttons[i].getAttribute('aria-label') || buttons[i].textContent || '').trim().toLowerCase();
+            if (/continue shopping|keep shopping/.test(label)) { continueBtn = buttons[i]; break; }
+            if (/view (basket|cart|bag)|checkout/.test(label) && !viewCartBtn) { viewCartBtn = buttons[i]; }
+          }
+          var target = continueBtn || viewCartBtn;
+          if (!target) return "Error: no dialog action found";
+          var actionLabel = (target.getAttribute('aria-label') || target.textContent || '').trim();
+          if (target.tagName === 'A' && target.href) {
+            window.location.href = target.href;
+            return "Clicked: " + actionLabel + " -> " + target.href;
+          }
+          target.click();
+          return "Clicked: " + actionLabel;
+        })()
+        `,
+        { timeoutMs: 1500, label: "cart dialog continue shopping" }
+      );
+      if (continueResult && continueResult !== PAGE_SCRIPT_TIMEOUT && typeof continueResult === "string" && !continueResult.startsWith("Error")) {
+        console.log(
+          `[Vessel cart-guard] dismiss_popup auto-clicked dialog action: ${continueResult}`
+        );
+        return `Cart confirmation handled: ${continueResult}. Item was already added to your cart.`;
+      }
+      const dialogActions = await getCartDialogActions$1(wc);
+      return `Cannot dismiss: this is a cart confirmation dialog. Item is in your cart.${dialogActions ? "\n" + dialogActions + "\nClick one of these instead." : " Use read_page to see dialog actions."}`;
+    }
+  }
   const initialDormant = before.dormantOverlays.length;
+  const initialLocale = await getLocaleSnapshot(wc);
   const candidates = await executePageScript(
     wc,
     `
@@ -7503,7 +8872,8 @@ async function dismissPopup$1(wc) {
         ).toLowerCase();
         const classText = text(typeof el.className === "string" ? el.className : "").toLowerCase();
         const idText = text(el.id).toLowerCase();
-        const combined = classText + " " + idText;
+        const hrefText = text(el.getAttribute && el.getAttribute("href")).toLowerCase();
+        const combined = label + " " + classText + " " + idText + " " + hrefText;
         let score = rooted ? 30 : 0;
         if (/^x$|^×$/.test(label)) score += 120;
         if (/no thanks|no, thanks|not now|maybe later|dismiss|close|skip|cancel|continue without|no thank you|reject|decline/.test(label)) score += 100;
@@ -7513,6 +8883,11 @@ async function dismissPopup$1(wc) {
         // OneTrust "Accept" is valid for dismissing the banner (user just wants it gone)
         if (/onetrust-accept|cookie.*accept|consent.*accept/.test(combined)) score += 80;
         if (el.getAttribute("aria-label")) score += 20;
+        if (/(language|locale|region|country|currency)\b/.test(combined)) score -= 320;
+        if (/\b(english|japanese|japan|francais|espanol|deutsch|italiano|portuguese|nihongo)\b/.test(label)) score -= 280;
+        if (/日本語|中文|한국어/.test(label)) score -= 280;
+        if (/[?&](lang|locale|language|hl)=/.test(hrefText)) score -= 260;
+        if (//(ja|jp|en|fr|de|es|it|ko|zh)(/|$)/.test(hrefText)) score -= 220;
         // Penalize general accept/subscribe buttons that aren't consent-related
         if (/accept|continue|submit|sign up|subscribe|join|start|next/.test(label) && !/cookie|consent|onetrust/.test(combined)) score -= 80;
         const rect = el.getBoundingClientRect();
@@ -7590,6 +8965,11 @@ async function dismissPopup$1(wc) {
       const result = await clickElement$1(wc, candidate.selector);
       if (result.startsWith("Error:")) continue;
       await sleep$1(250);
+      const postClickLocale = await getLocaleSnapshot(wc);
+      if (localeChanged(initialLocale, postClickLocale)) {
+        await restoreLocaleSnapshot(wc, initialLocale);
+        continue;
+      }
       const after = await extractContent(wc);
       const blocking = after.overlays.filter(
         (overlay) => overlay.blocksInteraction
@@ -7613,6 +8993,93 @@ async function dismissPopup$1(wc) {
   }
   return initialBlocking > 0 ? "Could not dismiss the blocking popup automatically" : initialDormant > 0 ? `No active blocking popup detected. Found ${initialDormant} dormant consent/modal surface(s) in the DOM, likely geo-gated or inactive in this session.` : "No blocking popup detected";
 }
+function describeOverlayState(page) {
+  const inventory = buildOverlayInventory(page);
+  return {
+    inventory,
+    blocking: inventory.filter((overlay) => overlay.blocksInteraction).length,
+    total: inventory.length,
+    signature: getBlockingOverlaySignature(inventory)
+  };
+}
+async function clickOverlayCandidate(wc, action) {
+  if (!action?.selector) return null;
+  const result = await clickResolvedSelector$1(wc, action.selector);
+  return `${action.label || action.selector}: ${result}`;
+}
+async function clearOverlays(wc, strategy = "auto") {
+  const steps = [];
+  let cleared = 0;
+  const maxIterations = 8;
+  for (let iteration = 0; iteration < maxIterations; iteration += 1) {
+    const before = await extractContent(wc);
+    const beforeState = describeOverlayState(before);
+    const blockingOverlays = beforeState.inventory.filter(
+      (overlay2) => overlay2.blocksInteraction
+    );
+    if (blockingOverlays.length === 0) {
+      if (cleared === 0) return "No blocking overlays detected";
+      steps.push(`Overlays remaining: ${beforeState.total}`);
+      steps.push("Page still blocked: false");
+      return steps.join("\n");
+    }
+    const overlay = blockingOverlays[0];
+    let actionMessage = null;
+    if (overlay.kind === "cookie_consent") {
+      actionMessage = await clickOverlayCandidate(
+        wc,
+        overlay.acceptAction || overlay.dismissAction || overlay.actions[0]
+      );
+    } else if (overlay.kind === "selection_modal") {
+      if (!overlay.correctOption?.selector) {
+        if (strategy === "interactive") {
+          steps.push(
+            "Stopped: selection modal needs human judgment because no likely-correct option was detected."
+          );
+          steps.push(`Overlays remaining: ${beforeState.total}`);
+          steps.push("Page still blocked: true");
+          return steps.join("\n");
+        }
+      } else {
+        const optionResult = await clickOverlayCandidate(
+          wc,
+          overlay.correctOption
+        );
+        if (optionResult) {
+          actionMessage = `Selected likely-correct option: ${optionResult}`;
+          await sleep$1(120);
+          const submitResult = await clickOverlayCandidate(
+            wc,
+            overlay.submitAction || overlay.acceptAction
+          );
+          if (submitResult) {
+            actionMessage += `
+Submitted modal: ${submitResult}`;
+          }
+        }
+      }
+    }
+    if (!actionMessage) {
+      actionMessage = `Fallback popup handling: ${await dismissPopup$1(wc)}`;
+    }
+    steps.push(actionMessage);
+    await sleep$1(250);
+    const after = await extractContent(wc);
+    const afterState = describeOverlayState(after);
+    steps.push(`Overlays remaining: ${afterState.total}`);
+    steps.push(`Page still blocked: ${afterState.blocking > 0}`);
+    if (afterState.blocking === 0) {
+      return steps.join("\n");
+    }
+    const progressMade = afterState.blocking < beforeState.blocking || afterState.total !== beforeState.total || afterState.signature !== beforeState.signature;
+    if (progressMade) {
+      cleared += 1;
+      continue;
+    }
+    return steps.join("\n");
+  }
+  return steps.join("\n");
+}
 async function resolveSelector$1(wc, index, selector) {
   if (selector) return selector;
   if (index == null) return null;
@@ -7727,6 +9194,197 @@ async function resolveSelector$1(wc, index, selector) {
   if (extractedSelector) return extractedSelector;
   return null;
 }
+function normalizeFieldToken(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function describeFillField(field) {
+  if (field.selector) return `selector=${field.selector}`;
+  if (field.index != null) return `index=${field.index}`;
+  if (field.name) return `name=${field.name}`;
+  if (field.label) return `label=${field.label}`;
+  if (field.placeholder) return `placeholder=${field.placeholder}`;
+  return "field";
+}
+async function resolveFieldSelector(wc, field) {
+  const directSelector = await resolveSelector$1(wc, field.index, field.selector);
+  if (directSelector) return directSelector;
+  const name = normalizeFieldToken(field.name);
+  const label = normalizeFieldToken(field.label);
+  const placeholder = normalizeFieldToken(field.placeholder);
+  if (!name && !label && !placeholder) return null;
+  const selector = await executePageScript(
+    wc,
+    `
+      (function() {
+        function normalize(value) {
+          return value == null ? "" : String(value).trim().toLowerCase();
+        }
+
+        function text(value) {
+          return value == null ? "" : String(value).trim();
+        }
+
+        function isVisible(el) {
+          if (!(el instanceof HTMLElement)) return true;
+          const style = window.getComputedStyle(el);
+          if (style.display === "none" || style.visibility === "hidden" || style.opacity === "0") {
+            return false;
+          }
+          if (el.hasAttribute("hidden") || el.getAttribute("aria-hidden") === "true") {
+            return false;
+          }
+          const rect = el.getBoundingClientRect();
+          return rect.width > 0 && rect.height > 0;
+        }
+
+        function escapeSelectorValue(value) {
+          if (typeof CSS !== "undefined" && typeof CSS.escape === "function") {
+            return CSS.escape(value);
+          }
+          return String(value).replace(/["\\\\]/g, "\\\\$&");
+        }
+
+        function uniqueSelector(candidate) {
+          if (!candidate) return null;
+          try {
+            return document.querySelectorAll(candidate).length === 1 ? candidate : null;
+          } catch {
+            return null;
+          }
+        }
+
+        function uniqueAttributeSelector(el, attribute) {
+          const value = text(el.getAttribute && el.getAttribute(attribute));
+          if (!value) return null;
+          const candidate = el.tagName.toLowerCase() + "[" + attribute + "=\\"" + escapeSelectorValue(value) + "\\"]";
+          return uniqueSelector(candidate);
+        }
+
+        function selectorFor(el) {
+          if (!el) return null;
+          if (el.id) return "#" + escapeSelectorValue(el.id);
+          const attributes = ["data-testid", "name", "form", "aria-label", "placeholder"];
+          for (const attribute of attributes) {
+            const attributeCandidate = uniqueAttributeSelector(el, attribute);
+            if (attributeCandidate) return attributeCandidate;
+          }
+          const parts = [];
+          let current = el;
+          while (current) {
+            if (current.id) {
+              parts.unshift("#" + escapeSelectorValue(current.id));
+              break;
+            }
+            const tag = current.tagName.toLowerCase();
+            const parent = current.parentElement;
+            if (!parent) {
+              parts.unshift(tag);
+              break;
+            }
+            const siblings = Array.from(parent.children).filter((child) => child.tagName === current.tagName);
+            const index = siblings.indexOf(current) + 1;
+            parts.unshift(siblings.length > 1 ? tag + ":nth-of-type(" + index + ")" : tag);
+            current = parent;
+          }
+          const candidate = parts.join(" > ");
+          return uniqueSelector(candidate) || candidate;
+        }
+
+        function getLabelText(el) {
+          const parts = [];
+          if (el.labels) {
+            Array.from(el.labels).forEach((labelEl) => {
+              const value = text(labelEl.textContent);
+              if (value) parts.push(value);
+            });
+          }
+          const ariaLabel = text(el.getAttribute && el.getAttribute("aria-label"));
+          if (ariaLabel) parts.push(ariaLabel);
+          const labelledBy = text(el.getAttribute && el.getAttribute("aria-labelledby"));
+          if (labelledBy) {
+            labelledBy.split(/\\s+/).forEach((id) => {
+              const ref = document.getElementById(id);
+              const value = text(ref && ref.textContent);
+              if (value) parts.push(value);
+            });
+          }
+          return normalize(parts.join(" "));
+        }
+
+        function scoreField(el) {
+          if (!(el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement)) {
+            return -1;
+          }
+          if (!isVisible(el) || el.disabled || el.getAttribute("aria-disabled") === "true") {
+            return -1;
+          }
+
+          const normalizedName = normalize(el.getAttribute("name")) || normalize(el.id);
+          const normalizedLabel = getLabelText(el);
+          const normalizedPlaceholder = normalize(el.getAttribute("placeholder"));
+          let score = 0;
+
+          if (${JSON.stringify(name)}) {
+            if (normalizedName === ${JSON.stringify(name.toLowerCase())}) score += 120;
+            else if (normalizedName.includes(${JSON.stringify(name.toLowerCase())})) score += 70;
+          }
+
+          if (${JSON.stringify(label)}) {
+            if (normalizedLabel === ${JSON.stringify(label.toLowerCase())}) score += 110;
+            else if (normalizedLabel.includes(${JSON.stringify(label.toLowerCase())})) score += 65;
+          }
+
+          if (${JSON.stringify(placeholder)}) {
+            if (normalizedPlaceholder === ${JSON.stringify(placeholder.toLowerCase())}) score += 105;
+            else if (normalizedPlaceholder.includes(${JSON.stringify(placeholder.toLowerCase())})) score += 60;
+          }
+
+          if (score === 0) return -1;
+          if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) score += 5;
+          return score;
+        }
+
+        const candidates = Array.from(document.querySelectorAll("input, textarea, select"));
+        let best = null;
+        let bestScore = -1;
+        for (const el of candidates) {
+          const score = scoreField(el);
+          if (score > bestScore) {
+            best = el;
+            bestScore = score;
+          }
+        }
+
+        return best ? selectorFor(best) : null;
+      })()
+    `,
+    {
+      label: "resolve form field"
+    }
+  );
+  return typeof selector === "string" && selector ? selector : null;
+}
+async function fillFormFields(wc, fields) {
+  const results = [];
+  for (const field of fields) {
+    const selector = await resolveFieldSelector(wc, field);
+    if (!selector) {
+      results.push({
+        field,
+        selector: null,
+        result: `Skipped: no selector for ${describeFillField(field)}`
+      });
+      continue;
+    }
+    const result = await setElementValue$1(
+      wc,
+      selector,
+      String(field.value || "")
+    );
+    results.push({ field, selector, result });
+  }
+  return results;
+}
 function getTabByMatch$1(tabManager, match) {
   if (!match) return null;
   const lowered = match.toLowerCase();
@@ -8327,7 +9985,9 @@ async function getPostActionState$1(ctx, name) {
     "select_option",
     "hover",
     "focus",
-    "fill_form"
+    "fill_form",
+    "inspect_element",
+    "clear_overlays"
   ];
   const tabActions = [
     "create_tab",
@@ -8367,6 +10027,7 @@ const KNOWN_TOOLS = /* @__PURE__ */ new Set([
   "go_forward",
   "reload",
   "click",
+  "inspect_element",
   "type_text",
   "select_option",
   "submit_form",
@@ -8376,6 +10037,7 @@ const KNOWN_TOOLS = /* @__PURE__ */ new Set([
   "focus",
   "set_ad_blocking",
   "dismiss_popup",
+  "clear_overlays",
   "read_page",
   "wait_for",
   "create_checkpoint",
@@ -8508,6 +10170,10 @@ async function executeAction(name, args, ctx) {
         }
         case "navigate": {
           if (!wc || !tabId) return "Error: No active tab";
+          const navValidation = await validateLinkDestination(args.url);
+          if (navValidation.status === "dead") {
+            return `Navigation blocked: ${args.url} returned ${navValidation.detail || "dead link"}. Try a different URL or go back and choose another link.`;
+          }
           ctx.tabManager.navigateTab(tabId, args.url);
           await waitForLoad$1(wc);
           return `Navigated to ${wc.getURL()}${getPostNavSummary(wc)}`;
@@ -8546,6 +10212,16 @@ async function executeAction(name, args, ctx) {
           if (!selector) return "Error: No element index or selector provided";
           return clickResolvedSelector$1(wc, selector);
         }
+        case "inspect_element": {
+          if (!wc) return "Error: No active tab";
+          const selector = await resolveSelector$1(wc, args.index, args.selector);
+          if (!selector) return "Error: No element index or selector provided";
+          return inspectElement(
+            wc,
+            selector,
+            typeof args.limit === "number" ? args.limit : 8
+          );
+        }
         case "type_text": {
           if (!wc) return "Error: No active tab";
           const selector = await resolveSelector$1(wc, args.index, args.selector);
@@ -8589,7 +10265,7 @@ async function executeAction(name, args, ctx) {
         }
         case "scroll": {
           if (!wc) return "Error: No active tab";
-          const pixels = args.amount || 500;
+          const pixels = coerceOptionalNumber(args.amount) ?? 500;
           const dir = args.direction === "up" ? -pixels : pixels;
           const result2 = await scrollPage$1(wc, dir);
           return `Scrolled ${args.direction} by ${pixels}px (moved ${Math.abs(result2.movedY)}px, now at y=${Math.round(result2.afterY)})`;
@@ -8634,6 +10310,11 @@ async function executeAction(name, args, ctx) {
           if (!wc) return "Error: No active tab";
           return dismissPopup$1(wc);
         }
+        case "clear_overlays": {
+          if (!wc) return "Error: No active tab";
+          const strategy = args.strategy === "interactive" ? "interactive" : "auto";
+          return clearOverlays(wc, strategy);
+        }
         case "read_page": {
           if (!wc) return "Error: No active tab";
           console.log("[Vessel read_page] starting extraction with 6s timeout");
@@ -9000,9 +10681,9 @@ ${truncated}`;
           if (!wc) return "Error: No active tab";
           const selector = await resolveSelector$1(wc, args.index, args.selector);
           const highlightColor = args.color || "yellow";
+          const highlightText = normalizeLooseString(args.text);
           const url = wc.getURL();
           if (url && url !== "about:blank") {
-            const highlightText = typeof args.text === "string" ? args.text : void 0;
             addHighlight(
               url,
               typeof selector === "string" ? selector : void 0,
@@ -9015,7 +10696,7 @@ ${truncated}`;
           return highlightOnPage(
             wc,
             selector,
-            args.text,
+            highlightText,
             args.label,
             args.durationMs,
             highlightColor
@@ -9028,7 +10709,7 @@ ${truncated}`;
         // --- Speedee System ---
         case "flow_start": {
           const goal = typeof args.goal === "string" ? args.goal : "";
-          const steps = Array.isArray(args.steps) ? args.steps.map(String) : [];
+          const steps = coerceStringArray(args.steps) ?? [];
           if (!goal || steps.length === 0)
             return "Error: goal and steps are required";
           const flow = ctx.runtime.startFlow(goal, steps, wc?.getURL());
@@ -9088,9 +10769,8 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
           const hasOverlays = page.overlays.some((o) => o.blocksInteraction);
           if (hasOverlays) {
             suggestions.push("BLOCKING OVERLAY detected — dismiss it first:");
-            suggestions.push(
-              "  → dismiss_popup or click on close/accept button"
-            );
+            suggestions.push("  → clear_overlays for stacked modals");
+            suggestions.push("  → or dismiss_popup for a single popup");
             suggestions.push("");
           }
           if (hasPasswordField) {
@@ -9108,6 +10788,9 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
             );
           } else if (hasSearchInput && linkCount >= 10) {
             suggestions.push("SEARCH RESULTS detected:");
+            suggestions.push(
+              "  → inspect_element(index) to inspect one result card"
+            );
             suggestions.push("  → click on a result link");
             if (hasPagination)
               suggestions.push("  → paginate('next') for more results");
@@ -9145,26 +10828,10 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
           if (!wc) return "Error: No active tab";
           const fields = Array.isArray(args.fields) ? args.fields : [];
           if (fields.length === 0) return "Error: No fields provided";
-          const results = [];
-          for (const field of fields) {
-            const sel = await resolveSelector$1(wc, field.index, field.selector);
-            if (!sel) {
-              results.push(`Skipped: no selector for index=${field.index}`);
-              continue;
-            }
-            const result2 = await setElementValue$1(
-              wc,
-              sel,
-              String(field.value || "")
-            );
-            results.push(result2);
-          }
+          const fillResults = await fillFormFields(wc, fields);
+          const results = fillResults.map((item) => item.result);
           if (args.submit) {
-            const firstSel = await resolveSelector$1(
-              wc,
-              fields[0]?.index,
-              fields[0]?.selector
-            );
+            const firstSel = fillResults.find((item) => item.selector)?.selector ?? null;
             if (firstSel) {
               const beforeUrl = wc.getURL();
               const submitResult = await submitForm$1(wc, { selector: firstSel });
@@ -9264,6 +10931,36 @@ ${steps.join("\n")}`;
           if (!wc) return "Error: No active tab";
           const query = String(args.query || "");
           if (!query) return "Error: No search query provided.";
+          const queryLower = query.toLowerCase().trim();
+          const buttonLikePatterns = [
+            "add to cart",
+            "add to bag",
+            "add to basket",
+            "buy now",
+            "buy it now",
+            "purchase",
+            "continue shopping",
+            "keep shopping",
+            "view cart",
+            "view bag",
+            "view basket",
+            "go to cart",
+            "go to checkout",
+            "checkout",
+            "check out",
+            "proceed to checkout",
+            "place order",
+            "submit",
+            "subscribe",
+            "sign up",
+            "sign in",
+            "log in",
+            "register",
+            "continue"
+          ];
+          if (buttonLikePatterns.some((p) => queryLower.includes(p))) {
+            return `Error: "${query}" looks like a button label, not a search query. Use the click tool to interact with this element instead.`;
+          }
           const searchInfo = args.selector ? { selector: args.selector, formAction: null, formMethod: null } : await executePageScript(
             wc,
             `
@@ -9634,8 +11331,11 @@ Instructions:
 - Prefer select_option for dropdowns and submit_form for forms instead of guessing with clicks.
 - After navigating to a new site, DO NOT call read_page immediately. Instead, act on what you already know: use the search tool to search the site, type_text to enter queries in search bars, or click on known navigation patterns. You know what major sites look like — use that knowledge. Only call read_page if you're genuinely stuck and need to discover unfamiliar page structure.
 - The page brief you start with is intentionally sparse. It is optimized for navigation speed, not completeness.
+- When you only need detail on one product/result/card/form section, use inspect_element instead of reading the page.
 - Escalate page reads progressively: read_page(mode="visible_only"), read_page(mode="results_only"), read_page(mode="forms_only"), read_page(mode="summary"), or read_page(mode="text_only") depending on what you need.
 - Use read_page(mode="debug") only as a last resort when the narrower modes are insufficient.
+- VIEWPORT SYNC: Treat scrolling as a real, user-visible browser action. If you say you are going to scroll, call scroll or scroll_to_element so the human sees the page move too.
+- read_page inspects the page without moving the human-visible viewport. Do not describe read_page as scrolling. If you want more context without changing the user's view, say you're reading the page; if you want the user to follow along lower on the page, actually scroll first.
 - After clicking or submitting a form, prefer wait_for on a specific result signal or a narrow read_page mode. Do not jump straight to read_page(mode="debug").
 - If the user says they highlighted or selected text, use read_page before falling back to screenshots because it includes active selection and visible unsaved highlights.
 - If a page behaves abnormally or key UI fails to load, consider disabling ad blocking for that tab and reloading before retrying.
@@ -9652,7 +11352,11 @@ Instructions:
 - USE YOUR KNOWLEDGE: You have broad, practical knowledge about technology, products, cooking, travel, finance, and countless other domains. When the user asks for recommendations, GIVE them — don't deflect to Reddit, YouTubers, or other sources. You know enough to recommend PC parts, suggest restaurants, pick a good laptop, or advise on most consumer decisions. Make a clear recommendation, explain your reasoning briefly, and then execute. If there's genuine ambiguity (e.g. AMD vs Intel is preference-dependent), state your pick and why, then ask only the questions that would actually change your recommendation. Never refuse a recommendation by claiming you're "not an expert" — the user chose to ask you, so help them.
 - NEVER USE EMOJIS unless the user uses them first.`;
       const actionCtx = { tabManager, runtime };
-      const contextualTools = pruneToolsForContext(AGENT_TOOLS, pageType);
+      const contextualTools = pruneToolsForContext(
+        AGENT_TOOLS,
+        pageType,
+        query
+      );
       await provider.streamAgentQuery(
         systemPrompt,
         query,
@@ -10777,16 +12481,42 @@ async function clickResolvedSelector(wc, selector) {
   if (selector.startsWith("__vessel_idx:")) {
     const idx = Number(selector.slice("__vessel_idx:".length));
     const beforeUrl2 = wc.getURL();
+    const idxLabel = await wc.executeJavaScript(
+      `window.__vessel?.getElementText?.(${idx}) || ""`
+    );
+    if (typeof idxLabel === "string" && isAddToCartText(idxLabel) && isDuplicateCartClick(beforeUrl2, idxLabel)) {
+      return `Blocked: "${idxLabel}" was already clicked on this page. The item is in your cart. Call read_page to see available actions (e.g. View Cart, Continue Shopping).`;
+    }
     const result = await wc.executeJavaScript(
       `window.__vessel?.interactByIndex?.(${idx}, "click") || "Error: interactByIndex not available"`
     );
     if (typeof result === "string" && result.startsWith("Error")) return result;
+    if (typeof idxLabel === "string" && isAddToCartText(idxLabel)) {
+      recordCartClick(beforeUrl2, idxLabel);
+    }
     await waitForPotentialNavigation(wc, beforeUrl2);
     const afterUrl2 = wc.getURL();
-    return afterUrl2 !== beforeUrl2 ? `${result} -> ${afterUrl2}` : result;
+    if (afterUrl2 !== beforeUrl2) return `${result} -> ${afterUrl2}`;
+    const overlayHint2 = await detectPostClickOverlay(wc);
+    if (!overlayHint2) return result;
+    const dialogActions = typeof idxLabel === "string" && isAddToCartText(idxLabel) ? await getCartDialogActions(wc) : null;
+    const actionsSuffix = dialogActions ? `
+${dialogActions}
+Click one of these dialog actions. Do NOT click any other element.` : "";
+    return `${result}
+${overlayHint2}${actionsSuffix}`;
   }
   if (selector.includes(" >>> ")) {
     const beforeUrl2 = wc.getURL();
+    const shadowLabel = await wc.executeJavaScript(`
+      (function() {
+        var el = window.__vessel?.resolveShadowSelector?.(${JSON.stringify(selector)});
+        return el ? (el.getAttribute("aria-label") || el.textContent?.trim().slice(0, 60) || "") : "";
+      })()
+    `);
+    if (typeof shadowLabel === "string" && isAddToCartText(shadowLabel) && isDuplicateCartClick(beforeUrl2, shadowLabel)) {
+      return `Blocked: "${shadowLabel}" was already clicked on this page. The item is in your cart. Call read_page to see available actions (e.g. View Cart, Continue Shopping).`;
+    }
     const result = await wc.executeJavaScript(`
       (function() {
         var el = window.__vessel?.resolveShadowSelector?.(${JSON.stringify(selector)});
@@ -10796,19 +12526,45 @@ async function clickResolvedSelector(wc, selector) {
       })()
     `);
     if (typeof result === "string" && result.startsWith("Error")) return result;
+    if (typeof shadowLabel === "string" && isAddToCartText(shadowLabel)) {
+      recordCartClick(beforeUrl2, shadowLabel);
+    }
     await waitForPotentialNavigation(wc, beforeUrl2);
     const afterUrl2 = wc.getURL();
-    return afterUrl2 !== beforeUrl2 ? `${result} -> ${afterUrl2}` : result;
+    if (afterUrl2 !== beforeUrl2) return `${result} -> ${afterUrl2}`;
+    const overlayHint2 = await detectPostClickOverlay(wc);
+    if (!overlayHint2) return result;
+    const dialogActions = typeof shadowLabel === "string" && isAddToCartText(shadowLabel) ? await getCartDialogActions(wc) : null;
+    const actionsSuffix = dialogActions ? `
+${dialogActions}
+Click one of these dialog actions. Do NOT click any other element.` : "";
+    return `${result}
+${overlayHint2}${actionsSuffix}`;
   }
   const beforeUrl = wc.getURL();
   const elInfo = await describeElementForClick(wc, selector);
   if ("error" in elInfo) return `Error: ${elInfo.error}`;
+  const cartMatch = isAddToCartText(elInfo.text);
+  if (cartMatch && isDuplicateCartClick(beforeUrl, elInfo.text)) {
+    return `Blocked: "${elInfo.text}" was already clicked on this page. The item is in your cart. Call read_page to see available actions (e.g. View Cart, Continue Shopping).`;
+  }
+  if (!cartMatch) {
+    const dialogActions = await getCartDialogActions(wc);
+    if (dialogActions) {
+      return `Blocked: a cart confirmation dialog is open. Do not click background elements.
+${dialogActions}
+Click one of these dialog actions instead.`;
+    }
+  }
   if (elInfo.href) {
     const validation = await validateLinkDestination(elInfo.href);
     if (validation.status === "dead") {
       return formatDeadLinkMessage(elInfo.text, validation);
     }
   }
+  if (cartMatch) {
+    recordCartClick(beforeUrl, elInfo.text);
+  }
   const clickText = `Clicked: ${elInfo.text}`;
   const clickResult = await clickElement(wc, selector);
   if (clickResult.startsWith("Error:")) return clickResult;
@@ -10817,6 +12573,18 @@ async function clickResolvedSelector(wc, selector) {
   if (afterUrl !== beforeUrl) {
     return `${clickText} -> ${afterUrl}`;
   }
+  const overlayHint = await detectPostClickOverlay(wc);
+  if (overlayHint) {
+    const dialogActions = cartMatch ? await getCartDialogActions(wc) : null;
+    const actionsSuffix = dialogActions ? `
+${dialogActions}
+Click one of these dialog actions. Do NOT click any other element.` : "";
+    return `${clickText} (${clickResult})
+${overlayHint}${actionsSuffix}`;
+  }
+  if (cartMatch) {
+    return `${clickText} (${clickResult})`;
+  }
   const activationResult = await activateElement(wc, selector);
   if (!activationResult.startsWith("Error:")) {
     await waitForPotentialNavigation(wc, beforeUrl);
@@ -10825,13 +12593,239 @@ async function clickResolvedSelector(wc, selector) {
       return `${clickText} -> ${fallbackUrl} (recovered via DOM activation)`;
     }
   }
+  const postActivationOverlayHint = await detectPostClickOverlay(wc);
+  if (postActivationOverlayHint) {
+    return `${clickText} (${clickResult})
+${postActivationOverlayHint}`;
+  }
   return `${clickText} (${clickResult})`;
 }
+async function getCartDialogActions(wc) {
+  const result = await wc.executeJavaScript(`
+    (function() {
+      function isVisible(el) {
+        if (!(el instanceof HTMLElement)) return false;
+        const style = getComputedStyle(el);
+        if (style.display === "none" || style.visibility === "hidden") return false;
+        const rect = el.getBoundingClientRect();
+        return rect.width >= 20 && rect.height >= 10;
+      }
+
+      function findDialogRoot() {
+        const selectors = [
+          '[data-test="basket-flyout"]',
+          '[role="dialog"]',
+          'dialog[open]',
+          '[role="alertdialog"]',
+          '[aria-modal="true"]',
+        ];
+        for (const selector of selectors) {
+          const nodes = document.querySelectorAll(selector);
+          for (const node of nodes) {
+            if (!(node instanceof HTMLElement) || !isVisible(node)) continue;
+            const text = (node.textContent || "").slice(0, 800).toLowerCase();
+            const cartSignals = [
+              "added to cart", "added to bag", "added to basket",
+              "item added", "your basket", "your cart", "your bag",
+              "view basket", "view cart", "continue shopping",
+            ];
+            if (cartSignals.some((signal) => text.includes(signal))) {
+              return node;
+            }
+          }
+        }
+        return null;
+      }
+
+      const dialog = findDialogRoot();
+      if (!dialog) return { found: false, actions: [] };
+
+      const actions = [];
+      dialog.querySelectorAll('button, a[href], [role="button"]').forEach((el) => {
+        if (!(el instanceof HTMLElement) || !isVisible(el)) return;
+        const label = (el.getAttribute("aria-label") || el.textContent || "").trim().slice(0, 80);
+        if (!label || label.length < 2) return;
+        const href = el.getAttribute("href") || "";
+        const selector = el.id ? "#" + el.id
+          : el.getAttribute("data-test") ? '[data-test="' + el.getAttribute("data-test") + '"]'
+          : el.getAttribute("aria-label") ? '[aria-label="' + el.getAttribute("aria-label") + '"]'
+          : null;
+        if (selector) {
+          actions.push({ label: label, href: href, selector: selector });
+        }
+      });
+
+      return {
+        found: true,
+        actions: actions.map((action) =>
+          '- "' + action.label + '"' +
+          (action.href ? ' -> ' + action.href : "") +
+          (action.selector ? ' (selector: ' + action.selector + ')' : "")
+        ),
+      };
+    })()
+  `);
+  if (!result || typeof result !== "object" || !("found" in result) || !result.found) {
+    return null;
+  }
+  if (!("actions" in result) || !Array.isArray(result.actions) || result.actions.length === 0) {
+    return null;
+  }
+  return `Available dialog actions:
+${result.actions.join("\n")}`;
+}
+async function detectPostClickOverlay(wc) {
+  const result = await wc.executeJavaScript(`
+    (function() {
+      var vw = window.innerWidth || document.documentElement.clientWidth;
+      var vh = window.innerHeight || document.documentElement.clientHeight;
+      var vpArea = Math.max(1, vw * vh);
+
+      function isVisible(el) {
+        if (!(el instanceof HTMLElement)) return false;
+        var style = getComputedStyle(el);
+        if (style.display === "none" || style.visibility === "hidden") return false;
+        return el.getBoundingClientRect().width > 0;
+      }
+
+      function hasFixedAncestor(el) {
+        var current = el.parentElement;
+        while (current && current !== document.body) {
+          var position = getComputedStyle(current).position;
+          if (position === "fixed" || position === "sticky") return true;
+          current = current.parentElement;
+        }
+        return false;
+      }
+
+      function effectiveZ(el) {
+        var current = el;
+        while (current && current !== document.body) {
+          var z = parseInt(getComputedStyle(current).zIndex, 10);
+          if (z > 0) return z;
+          current = current.parentElement;
+        }
+        return 0;
+      }
+
+      function touchesViewportEdge(rect) {
+        return rect.left <= 24 || rect.top <= 24 ||
+          rect.right >= vw - 24 || rect.bottom >= vh - 24;
+      }
+
+      var cartPhrases = [
+        "added to cart", "added to bag", "added to basket",
+        "added to your cart", "added to your bag", "added to your basket",
+      ];
+      var cartActions = [
+        "view cart", "go to cart", "view basket", "go to basket",
+        "continue shopping", "keep shopping", "checkout",
+      ];
+
+      var selectors = 'dialog[open], [role="dialog"], [role="alertdialog"], [aria-modal="true"], [data-test="basket-flyout"]';
+      var candidates = document.querySelectorAll(selectors);
+      var hit = null;
+      for (var i = 0; i < candidates.length; i++) {
+        if (isVisible(candidates[i])) {
+          hit = candidates[i];
+          break;
+        }
+      }
+
+      if (!hit) {
+        var elements = document.querySelectorAll("*");
+        for (var j = 0; j < elements.length; j++) {
+          var el = elements[j];
+          if (!(el instanceof HTMLElement) || !isVisible(el)) continue;
+          var style = getComputedStyle(el);
+          var position = style.position;
+          var isFixed = position === "fixed" || position === "sticky";
+          var isAbsolute = position === "absolute";
+          if (!isFixed && !isAbsolute) continue;
+          if (isAbsolute && !hasFixedAncestor(el)) continue;
+          if (effectiveZ(el) < 5) continue;
+          var rect = el.getBoundingClientRect();
+          var areaRatio = (rect.width * rect.height) / vpArea;
+          if (rect.width >= 160 && rect.height >= 100 && areaRatio >= 0.05 && touchesViewportEdge(rect)) {
+            hit = el;
+            break;
+          }
+        }
+      }
+
+      if (!hit) return { found: false, label: "", cartLike: false };
+      var text = (hit.textContent || "").slice(0, 800).toLowerCase();
+      var cartLike = cartPhrases.concat(cartActions).some(function(signal) {
+        return text.indexOf(signal) !== -1;
+      });
+      var heading = hit.querySelector("h1,h2,h3,h4");
+      var label = (hit.getAttribute("aria-label") || (heading && heading.textContent) || "").trim().slice(0, 80);
+      return { found: true, label: label, cartLike: cartLike };
+    })()
+  `);
+  if (!result || typeof result !== "object" || !("found" in result) || !result.found) {
+    return null;
+  }
+  const label = typeof result.label === "string" && result.label ? ` ("${result.label}")` : "";
+  if ("cartLike" in result && result.cartLike) {
+    return `A cart confirmation dialog appeared${label}. Call read_page to see available actions — do not click Add to Cart again.`;
+  }
+  return `A dialog or overlay appeared${label}. Call read_page to see available actions.`;
+}
 async function dismissPopup(wc) {
   const before = await extractContent(wc);
   const initialBlocking = before.overlays.filter(
     (overlay) => overlay.blocksInteraction
   ).length;
+  if (initialBlocking > 0) {
+    const overlayText = before.overlays.map(
+      (o) => [o.label, o.text].filter(Boolean).join(" ")
+    ).join(" ").toLowerCase();
+    const cartSignals = [
+      "added to cart",
+      "added to bag",
+      "added to basket",
+      "item added",
+      "items in your basket",
+      "items in your cart",
+      "items in your bag",
+      "your basket",
+      "your cart",
+      "your bag",
+      "view basket",
+      "view cart",
+      "continue shopping"
+    ];
+    if (cartSignals.some((s) => overlayText.includes(s))) {
+      const continueResult = await wc.executeJavaScript(`
+        (function() {
+          var dialog = document.querySelector('[role="dialog"], dialog[open], [role="alertdialog"], [aria-modal="true"]');
+          if (!dialog) return "Error: dialog not found";
+          var buttons = dialog.querySelectorAll('button, a[href], [role="button"]');
+          var continueBtn = null;
+          var viewCartBtn = null;
+          for (var i = 0; i < buttons.length; i++) {
+            var label = (buttons[i].getAttribute('aria-label') || buttons[i].textContent || '').trim().toLowerCase();
+            if (/continue shopping|keep shopping/.test(label)) { continueBtn = buttons[i]; break; }
+            if (/view (basket|cart|bag)|checkout/.test(label) && !viewCartBtn) { viewCartBtn = buttons[i]; }
+          }
+          var target = continueBtn || viewCartBtn;
+          if (!target) return "Error: no dialog action found";
+          var actionLabel = (target.getAttribute('aria-label') || target.textContent || '').trim();
+          if (target.tagName === 'A' && target.href) {
+            window.location.href = target.href;
+            return "Clicked: " + actionLabel + " -> " + target.href;
+          }
+          target.click();
+          return "Clicked: " + actionLabel;
+        })()
+      `);
+      if (typeof continueResult === "string" && !continueResult.startsWith("Error")) {
+        return `Cart confirmation handled: ${continueResult}. Item was already added to your cart.`;
+      }
+      return "Cannot dismiss: this is a cart confirmation dialog. Item is in your cart. Use read_page to see dialog actions (e.g. View Basket, Continue Shopping) and click one of them instead.";
+    }
+  }
   const initialDormant = before.dormantOverlays.length;
   const candidates = await wc.executeJavaScript(`
     (function() {
@@ -11077,7 +13071,13 @@ async function getPostActionState(tabManager, name) {
     "reload",
     "press_key"
   ];
-  const interactActions = ["type", "type_text", "select_option", "hover", "focus"];
+  const interactActions = [
+    "type",
+    "type_text",
+    "select_option",
+    "hover",
+    "focus"
+  ];
   const tabActions = ["create_tab", "switch_tab", "close_tab"];
   if (navActions.includes(name)) {
     let warning = "";
@@ -11260,7 +13260,8 @@ async function hoverElement(wc, selector) {
   if ("error" in pos && typeof pos.error === "string") return pos.error;
   const x = typeof pos.x === "number" ? pos.x : null;
   const y = typeof pos.y === "number" ? pos.y : null;
-  if (x == null || y == null) return "Error: Could not resolve hover coordinates";
+  if (x == null || y == null)
+    return "Error: Could not resolve hover coordinates";
   wc.sendInputEvent({ type: "mouseMove", x, y });
   const label = typeof pos.label === "string" ? pos.label : "element";
   return `Hovered: ${label}`;
@@ -11479,7 +13480,10 @@ async function waitForCondition(wc, text, selector, timeoutMs) {
   const expectedText = (text || "").trim();
   const expectedSelector = (selector || "").trim();
   if (!expectedText && !expectedSelector) {
-    return JSON.stringify({ matched: false, error: "wait_for requires text or selector" });
+    return JSON.stringify({
+      matched: false,
+      error: "wait_for requires text or selector"
+    });
   }
   if (wc.isLoading()) {
     await waitForLoad(wc, Math.min(effectiveTimeout, 5e3));
@@ -11503,13 +13507,26 @@ async function waitForCondition(wc, text, selector, timeoutMs) {
     `);
     const elapsedMs2 = Date.now() - startedAt;
     if (result === "selector") {
-      return JSON.stringify({ matched: true, type: "selector", value: expectedSelector, elapsed_ms: elapsedMs2 });
+      return JSON.stringify({
+        matched: true,
+        type: "selector",
+        value: expectedSelector,
+        elapsed_ms: elapsedMs2
+      });
     }
     if (result === "text") {
-      return JSON.stringify({ matched: true, type: "text", value: expectedText.slice(0, 80), elapsed_ms: elapsedMs2 });
+      return JSON.stringify({
+        matched: true,
+        type: "text",
+        value: expectedText.slice(0, 80),
+        elapsed_ms: elapsedMs2
+      });
     }
     if (typeof result === "string" && result.startsWith("invalid_selector:")) {
-      return JSON.stringify({ matched: false, error: `Invalid selector "${expectedSelector}" — ${result.slice(17)}` });
+      return JSON.stringify({
+        matched: false,
+        error: `Invalid selector "${expectedSelector}" — ${result.slice(17)}`
+      });
     }
     await new Promise((resolve) => setTimeout(resolve, 150));
   }
@@ -11653,7 +13670,12 @@ function registerTools(server, tabManager, runtime) {
         pageType,
         pageUrl,
         pageTitle,
-        recommended: scored.filter((t) => t.score <= 20).map(({ name, title, description, relevance }) => ({ name, title, description, relevance })),
+        recommended: scored.filter((t) => t.score <= 20).map(({ name, title, description, relevance }) => ({
+          name,
+          title,
+          description,
+          relevance
+        })),
         available: scored.filter((t) => t.score > 20).map(({ name, title, relevance }) => ({ name, title, relevance }))
       };
       return {
@@ -11685,8 +13707,12 @@ function registerTools(server, tabManager, runtime) {
       description: "Publish or stream agent reasoning/status text into Vessel's in-browser transcript monitor. Intended for external harnesses that want to mirror live thinking into the browser UI.",
       inputSchema: {
         text: zod.z.string().describe("Transcript text chunk to publish"),
-        stream_id: zod.z.string().optional().describe("Stable stream ID for incremental updates to the same entry"),
-        mode: zod.z.enum(["append", "replace", "final"]).optional().describe("append (default), replace current stream text, or mark the stream final"),
+        stream_id: zod.z.string().optional().describe(
+          "Stable stream ID for incremental updates to the same entry"
+        ),
+        mode: zod.z.enum(["append", "replace", "final"]).optional().describe(
+          "append (default), replace current stream text, or mark the stream final"
+        ),
         kind: zod.z.enum(["thinking", "message", "status"]).optional().describe("Visual style for the transcript entry"),
         title: zod.z.string().optional().describe("Optional short label such as Plan, Search, or Summary")
       }
@@ -11737,7 +13763,9 @@ function registerTools(server, tabManager, runtime) {
   ];
   async function buildExtractResponse(pageContent, mode, adBlockingEnabled, wc) {
     const adBlockLine = `**Ad Blocking:** ${adBlockingEnabled ? "On" : "Off"}`;
-    const savedHighlights = getHighlightsForUrl(pageContent.url);
+    const savedHighlights = getHighlightsForUrl(
+      pageContent.url
+    );
     const liveSelectionSection = wc ? formatLiveSelectionSection(
       await captureLiveHighlightSnapshot(wc, savedHighlights)
     ) : null;
@@ -11854,10 +13882,18 @@ ${buildScopedContext(pageContent, mode)}`;
     async ({ url }) => {
       const tab = tabManager.getActiveTab();
       if (!tab) return asTextResponse("Error: No active tab");
+      const preCheck = await validateLinkDestination(url);
+      if (preCheck.status === "dead") {
+        return asTextResponse(
+          `Navigation blocked: ${url} returned ${preCheck.detail || "dead link"}. Try a different URL or go back and choose another link.`
+        );
+      }
       return withAction(runtime, tabManager, "navigate", { url }, async () => {
         const id = tabManager.getActiveTabId();
         tabManager.navigateTab(id, url);
-        const { httpStatus } = await waitForLoadWithStatus(tab.view.webContents);
+        const { httpStatus } = await waitForLoadWithStatus(
+          tab.view.webContents
+        );
         const finalUrl = tab.view.webContents.getURL();
         const statusNote = httpStatus !== null && httpStatus >= 400 ? ` [HTTP ${httpStatus} — page may be missing or unavailable, consider navigating back and trying a different link]` : "";
         return `Navigated to ${finalUrl}${statusNote}`;
@@ -11927,7 +13963,9 @@ ${buildScopedContext(pageContent, mode)}`;
         const pageContent = await extractContent(tab.view.webContents);
         const requestedType = typeof type === "string" && type.trim() ? type.trim().toLowerCase() : "";
         const entities = (pageContent.structuredData ?? []).filter(
-          (entity) => requestedType ? entity.types.some((entry) => entry.toLowerCase() === requestedType) : true
+          (entity) => requestedType ? entity.types.some(
+            (entry) => entry.toLowerCase() === requestedType
+          ) : true
         );
         const sourceCounts = {
           json_ld: pageContent.jsonLd?.length ?? 0,
@@ -12166,7 +14204,9 @@ ${buildScopedContext(pageContent, mode)}`;
         })()
       `);
       if (!result || typeof result !== "object") {
-        return asTextResponse("Error: Element text extraction returned no result");
+        return asTextResponse(
+          "Error: Element text extraction returned no result"
+        );
       }
       if ("error" in result && typeof result.error === "string") {
         return asTextResponse(`Error: ${result.error}`);
@@ -12216,11 +14256,7 @@ ${buildScopedContext(pageContent, mode)}`;
             return "Error: No index or selector provided";
           }
           if (mode === "keystroke") {
-            return typeKeystroke(
-              tab.view.webContents,
-              resolvedSelector,
-              text
-            );
+            return typeKeystroke(tab.view.webContents, resolvedSelector, text);
           }
           return setElementValue(tab.view.webContents, resolvedSelector, text);
         }
@@ -12259,11 +14295,7 @@ ${buildScopedContext(pageContent, mode)}`;
             return "Error: No index or selector provided";
           }
           if (mode === "keystroke") {
-            return typeKeystroke(
-              tab.view.webContents,
-              resolvedSelector,
-              text
-            );
+            return typeKeystroke(tab.view.webContents, resolvedSelector, text);
           }
           return setElementValue(tab.view.webContents, resolvedSelector, text);
         }
@@ -12368,7 +14400,9 @@ ${buildScopedContext(pageContent, mode)}`;
       description: "Scroll the page up or down.",
       inputSchema: {
         direction: zod.z.enum(["up", "down"]).describe("Scroll direction"),
-        amount: zod.z.number().optional().describe("Pixels to scroll (default 500)")
+        amount: optionalNumberLikeSchema().describe(
+          "Pixels to scroll (default 500)"
+        )
       }
     },
     async ({ direction, amount }) => {
@@ -12380,7 +14414,7 @@ ${buildScopedContext(pageContent, mode)}`;
         "scroll",
         { direction, amount },
         async () => {
-          const pixels = amount || 500;
+          const pixels = coerceOptionalNumber(amount) ?? 500;
           const dir = direction === "up" ? -pixels : pixels;
           const result = await scrollPage(tab.view.webContents, dir);
           return `Scrolled ${direction} by ${pixels}px (moved ${Math.abs(result.movedY)}px, now at y=${Math.round(result.afterY)})`;
@@ -12406,6 +14440,32 @@ ${buildScopedContext(pageContent, mode)}`;
       );
     }
   );
+  server.registerTool(
+    "vessel_clear_overlays",
+    {
+      title: "Clear Overlays",
+      description: "Work through blocking overlays and modals until the page is unblocked, using overlay-specific heuristics for consent banners and radio-selection dialogs.",
+      inputSchema: {
+        strategy: zod.z.enum(["auto", "interactive"]).optional().describe(
+          'How aggressively to clear overlays. "auto" uses heuristics; "interactive" stops earlier when human judgment may be needed.'
+        )
+      }
+    },
+    async ({ strategy }) => {
+      const tab = tabManager.getActiveTab();
+      if (!tab) return asTextResponse("Error: No active tab");
+      return withAction(
+        runtime,
+        tabManager,
+        "clear_overlays",
+        { strategy: strategy || "auto" },
+        async () => clearOverlays(
+          tab.view.webContents,
+          strategy === "interactive" ? "interactive" : "auto"
+        )
+      );
+    }
+  );
   server.registerTool(
     "vessel_wait_for",
     {
@@ -12667,8 +14727,14 @@ ${buildScopedContext(pageContent, mode)}`;
             `Error capturing screenshot: ${screenshot.error}`
           );
         }
-        const screenshotPath = path$1.join(os.tmpdir(), `vessel_screenshot_${Date.now()}.png`);
-        fs$1.writeFileSync(screenshotPath, Buffer.from(screenshot.base64, "base64"));
+        const screenshotPath = path$1.join(
+          os.tmpdir(),
+          `vessel_screenshot_${Date.now()}.png`
+        );
+        fs$1.writeFileSync(
+          screenshotPath,
+          Buffer.from(screenshot.base64, "base64")
+        );
         return {
           content: [
             {
@@ -12699,7 +14765,7 @@ To analyze visually, call vision_analyze with image_url="${screenshotPath}"`
       inputSchema: {
         index: zod.z.number().optional().describe("Element index from extracted content to highlight"),
         selector: zod.z.string().optional().describe("CSS selector of element to highlight"),
-        text: zod.z.string().optional().describe(
+        text: normalizedOptionalStringSchema().describe(
           "Text to find and highlight on the page (highlights all occurrences)"
         ),
         label: zod.z.string().optional().describe("Optional annotation label to display near the highlight"),
@@ -12717,18 +14783,27 @@ To analyze visually, call vision_analyze with image_url="${screenshotPath}"`
     async ({ index, selector, text, label, durationMs, persist, color }) => {
       const tab = tabManager.getActiveTab();
       if (!tab) return asTextResponse("Error: No active tab");
+      const normalizedText = normalizeLooseString(text);
       return withAction(
         runtime,
         tabManager,
         "highlight",
-        { index, selector, text, label, durationMs, persist, color },
+        {
+          index,
+          selector,
+          text: normalizedText,
+          label,
+          durationMs,
+          persist,
+          color
+        },
         async () => {
           const wc = tab.view.webContents;
           const resolvedSelector = await resolveSelector(wc, index, selector);
           const result = await highlightOnPage(
             wc,
             resolvedSelector,
-            text,
+            normalizedText,
             label,
             durationMs,
             color
@@ -12738,7 +14813,7 @@ To analyze visually, call vision_analyze with image_url="${screenshotPath}"`
             addHighlight(
               url,
               resolvedSelector ?? void 0,
-              text,
+              normalizedText,
               label,
               color,
               "agent"
@@ -12758,12 +14833,18 @@ To analyze visually, call vision_analyze with image_url="${screenshotPath}"`
     async () => {
       const tab = tabManager.getActiveTab();
       if (!tab) return asTextResponse("Error: No active tab");
-      return withAction(runtime, tabManager, "clear_highlights", {}, async () => {
-        const wc = tab.view.webContents;
-        const url = normalizeUrl(wc.getURL());
-        clearHighlightsForUrl(url);
-        return clearHighlights(wc);
-      });
+      return withAction(
+        runtime,
+        tabManager,
+        "clear_highlights",
+        {},
+        async () => {
+          const wc = tab.view.webContents;
+          const url = normalizeUrl(wc.getURL());
+          clearHighlightsForUrl(url);
+          return clearHighlights(wc);
+        }
+      );
     }
   );
   server.registerTool(
@@ -12934,12 +15015,22 @@ ${JSON.stringify(otherHighlights, null, 2)}`
       title: "Save Bookmark",
       description: "Save the current page, a specific URL, or a link target from the current page into a bookmark folder. You can provide folder_id or folder_name; missing folder names can be created automatically.",
       inputSchema: {
-        url: zod.z.string().optional().describe("URL to bookmark. Omit to use the current page or provide index/selector to bookmark a link target from the page"),
-        title: zod.z.string().optional().describe("Human-readable title for the bookmark. Omit to use the page or link text"),
-        index: zod.z.number().optional().describe("Element index of a link on the current page to bookmark without opening it"),
-        selector: zod.z.string().optional().describe("CSS selector of a link on the current page to bookmark without opening it"),
+        url: zod.z.string().optional().describe(
+          "URL to bookmark. Omit to use the current page or provide index/selector to bookmark a link target from the page"
+        ),
+        title: zod.z.string().optional().describe(
+          "Human-readable title for the bookmark. Omit to use the page or link text"
+        ),
+        index: zod.z.number().optional().describe(
+          "Element index of a link on the current page to bookmark without opening it"
+        ),
+        selector: zod.z.string().optional().describe(
+          "CSS selector of a link on the current page to bookmark without opening it"
+        ),
         folder_id: zod.z.string().optional().describe("Folder ID to save into (omit for Unsorted)"),
-        folder_name: zod.z.string().optional().describe("Folder name to save into. Created automatically if missing"),
+        folder_name: zod.z.string().optional().describe(
+          "Folder name to save into. Created automatically if missing"
+        ),
         folder_summary: zod.z.string().optional().describe("Optional one-sentence summary if a new folder is created"),
         create_folder_if_missing: zod.z.boolean().optional().describe("Create folder_name automatically when it does not exist"),
         note: zod.z.string().optional().describe("Optional note about why this was bookmarked"),
@@ -13085,10 +15176,16 @@ ${JSON.stringify(otherHighlights, null, 2)}`
       description: "Organize a bookmark by intent: save or move a bookmark into a folder, creating the folder if needed. Works with bookmark_id, url, a link target from the current page, or the current page itself.",
       inputSchema: {
         bookmark_id: zod.z.string().optional().describe("Existing bookmark ID to move or update"),
-        url: zod.z.string().optional().describe("URL to organize. Omit to use the current page or provide index/selector to target a link"),
+        url: zod.z.string().optional().describe(
+          "URL to organize. Omit to use the current page or provide index/selector to target a link"
+        ),
         title: zod.z.string().optional().describe("Optional title when saving a new bookmark"),
-        index: zod.z.number().optional().describe("Element index of a link on the current page to organize without opening it"),
-        selector: zod.z.string().optional().describe("CSS selector of a link on the current page to organize without opening it"),
+        index: zod.z.number().optional().describe(
+          "Element index of a link on the current page to organize without opening it"
+        ),
+        selector: zod.z.string().optional().describe(
+          "CSS selector of a link on the current page to organize without opening it"
+        ),
         folder_id: zod.z.string().optional().describe("Folder ID to organize into"),
         folder_name: zod.z.string().optional().describe("Folder name to organize into"),
         folder_summary: zod.z.string().optional().describe("Optional summary used if a new folder is created"),
@@ -13215,10 +15312,16 @@ ${JSON.stringify(otherHighlights, null, 2)}`
       description: 'Archive the current page, a URL, a link target from the current page, or an existing bookmark into the default "Archive" folder.',
       inputSchema: {
         bookmark_id: zod.z.string().optional().describe("Existing bookmark ID to archive"),
-        url: zod.z.string().optional().describe("URL to archive. Omit to use the current page or provide index/selector to target a link"),
+        url: zod.z.string().optional().describe(
+          "URL to archive. Omit to use the current page or provide index/selector to target a link"
+        ),
         title: zod.z.string().optional().describe("Optional title when saving a new archived bookmark"),
-        index: zod.z.number().optional().describe("Element index of a link on the current page to archive without opening it"),
-        selector: zod.z.string().optional().describe("CSS selector of a link on the current page to archive without opening it"),
+        index: zod.z.number().optional().describe(
+          "Element index of a link on the current page to archive without opening it"
+        ),
+        selector: zod.z.string().optional().describe(
+          "CSS selector of a link on the current page to archive without opening it"
+        ),
         note: zod.z.string().optional().describe("Optional note to store with the archived bookmark")
       }
     },
@@ -13374,7 +15477,11 @@ ${JSON.stringify(otherHighlights, null, 2)}`
               `Folder "${existing.name}" already exists (id=${existing.id})`
             );
           }
-          const folder = renameFolder(folder_id, new_name, summary);
+          const folder = renameFolder(
+            folder_id,
+            new_name,
+            summary
+          );
           return folder ? composeFolderAwareResponse(`Renamed folder to "${folder.name}"`) : `Folder ${folder_id} not found`;
         }
       );
@@ -13575,13 +15682,22 @@ ${JSON.stringify(otherHighlights, null, 2)}`
       title: "Start Workflow",
       description: "Begin tracking a multi-step web workflow. Vessel will show progress after every action so you always know where you are in the flow.",
       inputSchema: {
-        goal: zod.z.string().describe("What this workflow accomplishes (e.g. 'Purchase item from Amazon')"),
-        steps: zod.z.array(zod.z.string()).describe("Ordered list of step labels (e.g. ['Log in', 'Search', 'Select item', 'Checkout'])")
+        goal: zod.z.string().describe(
+          "What this workflow accomplishes (e.g. 'Purchase item from Amazon')"
+        ),
+        steps: stringArrayLikeSchema().describe(
+          "Ordered list of step labels (e.g. ['Log in', 'Search', 'Select item', 'Checkout'])"
+        )
       }
     },
     async ({ goal, steps }) => {
+      const normalizedSteps = coerceStringArray(steps) ?? [];
       const tab = tabManager.getActiveTab();
-      const flow = runtime.startFlow(goal, steps, tab?.view.webContents.getURL());
+      const flow = runtime.startFlow(
+        goal,
+        normalizedSteps,
+        tab?.view.webContents.getURL()
+      );
       return asTextResponse(
         `Flow started: ${flow.goal}
 ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
@@ -13635,13 +15751,18 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
     },
     async () => {
       const tab = tabManager.getActiveTab();
-      if (!tab) return asTextResponse("No active tab. Use vessel_navigate to open a page.");
+      if (!tab)
+        return asTextResponse(
+          "No active tab. Use vessel_navigate to open a page."
+        );
       const wc = tab.view.webContents;
       let page;
       try {
         page = await extractContent(wc);
       } catch {
-        return asTextResponse("Could not read page. Try vessel_navigate to a working URL.");
+        return asTextResponse(
+          "Could not read page. Try vessel_navigate to a working URL."
+        );
       }
       const suggestions = [];
       suggestions.push(`Page: ${page.title || "(untitled)"}`);
@@ -13661,23 +15782,32 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
       );
       const formCount = page.forms.length;
       const totalFields = page.forms.reduce((n, f) => n + f.fields.length, 0);
-      const linkCount = page.interactiveElements.filter((el) => el.type === "link").length;
+      const linkCount = page.interactiveElements.filter(
+        (el) => el.type === "link"
+      ).length;
       const hasPagination = page.interactiveElements.some(
         (el) => (el.text || "").toLowerCase() === "next" || el.text === "›" || el.text === "»"
       );
       const hasOverlays = page.overlays.some((o) => o.blocksInteraction);
       if (hasOverlays) {
         suggestions.push("⚠ BLOCKING OVERLAY detected — dismiss it first:");
-        suggestions.push("  → vessel_dismiss_popup or vessel_click on close/accept button");
+        suggestions.push("  → vessel_clear_overlays for stacked modals");
+        suggestions.push("  → or vessel_dismiss_popup for a single popup");
         suggestions.push("");
       }
       if (hasPasswordField) {
         suggestions.push("🔑 LOGIN PAGE detected:");
-        suggestions.push("  → vessel_login(username, password) — handles the full flow");
-        suggestions.push("  → Or vessel_fill_form + vessel_submit_form for manual control");
+        suggestions.push(
+          "  → vessel_login(username, password) — handles the full flow"
+        );
+        suggestions.push(
+          "  → Or vessel_fill_form + vessel_submit_form for manual control"
+        );
       } else if (hasSearchInput && linkCount < 10) {
         suggestions.push("🔍 SEARCH PAGE detected:");
-        suggestions.push("  → vessel_search(query) — finds the box, types, submits");
+        suggestions.push(
+          "  → vessel_search(query) — finds the box, types, submits"
+        );
       } else if (hasSearchInput && linkCount >= 10) {
         suggestions.push("📋 SEARCH RESULTS detected:");
         suggestions.push("  → vessel_click on a result link");
@@ -13686,7 +15816,9 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
         }
       } else if (formCount > 0) {
         suggestions.push(`📝 FORM detected (${totalFields} fields):`);
-        suggestions.push("  → vessel_fill_form(fields) — fill all fields at once");
+        suggestions.push(
+          "  → vessel_fill_form(fields) — fill all fields at once"
+        );
         suggestions.push("  → Or vessel_type for individual fields");
       } else if (hasPagination) {
         suggestions.push("📄 PAGINATED CONTENT:");
@@ -13698,12 +15830,16 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
         suggestions.push("  → vessel_scroll to see more");
       } else {
         suggestions.push("🌐 GENERAL PAGE:");
-        suggestions.push("  → vessel_extract_content to understand the page structure");
+        suggestions.push(
+          "  → vessel_extract_content to understand the page structure"
+        );
         suggestions.push("  → vessel_click on any element by index");
         suggestions.push("  → vessel_navigate to go somewhere new");
       }
       suggestions.push("");
-      suggestions.push(`Available: ${page.interactiveElements.length} interactive elements, ${formCount} forms, ${linkCount} links`);
+      suggestions.push(
+        `Available: ${page.interactiveElements.length} interactive elements, ${formCount} forms, ${linkCount} links`
+      );
       return asTextResponse(suggestions.join("\n"));
     }
   );
@@ -13717,9 +15853,14 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
           zod.z.object({
             index: zod.z.number().optional().describe("Element index from page content"),
             selector: zod.z.string().optional().describe("CSS selector fallback"),
+            name: zod.z.string().optional().describe("Field name or id, such as custname"),
+            label: zod.z.string().optional().describe("Visible label or aria-label text"),
+            placeholder: zod.z.string().optional().describe("Placeholder text shown in the field"),
             value: zod.z.string().describe("Value to enter")
           })
-        ).describe("Fields to fill"),
+        ).describe(
+          "Fields to fill, matched by index, selector, name, label, or placeholder"
+        ),
         submit: zod.z.boolean().optional().describe("Submit the form after filling (default false)")
       }
     },
@@ -13733,18 +15874,10 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
         { fieldCount: fields.length, submit },
         async () => {
           const wc = tab.view.webContents;
-          const results = [];
-          for (const field of fields) {
-            const sel = await resolveSelector(wc, field.index, field.selector);
-            if (!sel) {
-              results.push(`Skipped: no selector for index=${field.index}`);
-              continue;
-            }
-            const result = await setElementValue(wc, sel, field.value);
-            results.push(result);
-          }
+          const fillResults = await fillFormFields(wc, fields);
+          const results = fillResults.map((item) => item.result);
           if (submit) {
-            const firstSel = await resolveSelector(wc, fields[0]?.index, fields[0]?.selector);
+            const firstSel = fillResults.find((item) => item.selector)?.selector ?? null;
             if (firstSel) {
               const beforeUrl = wc.getURL();
               const submitResult = await submitForm(wc, void 0, firstSel);
@@ -13770,12 +15903,25 @@ ${results.join("\n")}`;
         url: zod.z.string().optional().describe("Login page URL (skip if already on login page)"),
         username: zod.z.string().describe("Username or email"),
         password: zod.z.string().describe("Password"),
-        username_selector: zod.z.string().optional().describe("CSS selector for username field (auto-detected if omitted)"),
-        password_selector: zod.z.string().optional().describe("CSS selector for password field (auto-detected if omitted)"),
-        submit_selector: zod.z.string().optional().describe("CSS selector for submit button (auto-detected if omitted)")
+        username_selector: zod.z.string().optional().describe(
+          "CSS selector for username field (auto-detected if omitted)"
+        ),
+        password_selector: zod.z.string().optional().describe(
+          "CSS selector for password field (auto-detected if omitted)"
+        ),
+        submit_selector: zod.z.string().optional().describe(
+          "CSS selector for submit button (auto-detected if omitted)"
+        )
       }
     },
-    async ({ url, username, password, username_selector, password_selector, submit_selector }) => {
+    async ({
+      url,
+      username,
+      password,
+      username_selector,
+      password_selector,
+      submit_selector
+    }) => {
       const tab = tabManager.getActiveTab();
       if (!tab) return asTextResponse("Error: No active tab");
       return withAction(
@@ -13798,14 +15944,16 @@ ${results.join("\n")}`;
                 return el ? (el.id ? '#' + CSS.escape(el.id) : el.name ? 'input[name="' + el.name + '"]' : null) : null;
               })()
             `);
-          if (!userSel) return "Error: Could not find username/email field. Try providing username_selector.";
+          if (!userSel)
+            return "Error: Could not find username/email field. Try providing username_selector.";
           const passSel = password_selector || await wc.executeJavaScript(`
               (function() {
                 var el = document.querySelector('input[type="password"]');
                 return el ? (el.id ? '#' + CSS.escape(el.id) : el.name ? 'input[name="' + el.name + '"]' : null) : null;
               })()
             `);
-          if (!passSel) return "Error: Could not find password field. Try providing password_selector.";
+          if (!passSel)
+            return "Error: Could not find password field. Try providing password_selector.";
           const userResult = await setElementValue(wc, userSel, username);
           steps.push(userResult);
           const passResult = await setElementValue(wc, passSel, password);
@@ -13823,7 +15971,8 @@ ${results.join("\n")}`;
                 return false;
               })()
             `);
-            if (!clicked) return steps.join("\n") + "\nWarning: Could not find submit button. Credentials filled but form not submitted.";
+            if (!clicked)
+              return steps.join("\n") + "\nWarning: Could not find submit button. Credentials filled but form not submitted.";
           }
           await waitForPotentialNavigation(wc, beforeUrl);
           const afterUrl = wc.getURL();
@@ -13849,14 +15998,41 @@ ${steps.join("\n")}`;
     async ({ query, selector }) => {
       const tab = tabManager.getActiveTab();
       if (!tab) return asTextResponse("Error: No active tab");
-      return withAction(
-        runtime,
-        tabManager,
-        "search",
-        { query },
-        async () => {
-          const wc = tab.view.webContents;
-          const searchSel = selector || await wc.executeJavaScript(`
+      const qLower = query.toLowerCase().trim();
+      const buttonLabels = [
+        "add to cart",
+        "add to bag",
+        "add to basket",
+        "buy now",
+        "buy it now",
+        "purchase",
+        "continue shopping",
+        "keep shopping",
+        "view cart",
+        "view bag",
+        "view basket",
+        "go to cart",
+        "go to checkout",
+        "checkout",
+        "check out",
+        "proceed to checkout",
+        "place order",
+        "submit",
+        "subscribe",
+        "sign up",
+        "sign in",
+        "log in",
+        "register",
+        "continue"
+      ];
+      if (buttonLabels.some((p) => qLower.includes(p))) {
+        return asTextResponse(
+          `Error: "${query}" looks like a button label, not a search query. Use the click tool to interact with this element instead.`
+        );
+      }
+      return withAction(runtime, tabManager, "search", { query }, async () => {
+        const wc = tab.view.webContents;
+        const searchSel = selector || await wc.executeJavaScript(`
               (function() {
                 var el = document.querySelector('input[type="search"], input[name="q"], input[name="query"], input[name="search"], input[role="searchbox"], input[aria-label*="search" i], input[placeholder*="search" i]');
                 if (!el) {
@@ -13872,24 +16048,24 @@ ${steps.join("\n")}`;
                 return el ? (el.id ? '#' + CSS.escape(el.id) : el.name ? 'input[name="' + el.name + '"]' : null) : null;
               })()
             `);
-          if (!searchSel) return "Error: Could not find search input. Try providing a selector.";
-          await setElementValue(wc, searchSel, query);
-          await wc.executeJavaScript(`
+        if (!searchSel)
+          return "Error: Could not find search input. Try providing a selector.";
+        await setElementValue(wc, searchSel, query);
+        await wc.executeJavaScript(`
             (function() {
               var el = document.querySelector(${JSON.stringify(searchSel)});
               if (el) el.focus();
             })()
           `);
-          await new Promise((r) => setTimeout(r, 50));
-          const beforeUrl = wc.getURL();
-          wc.sendInputEvent({ type: "keyDown", keyCode: "Return" });
-          await new Promise((r) => setTimeout(r, 16));
-          wc.sendInputEvent({ type: "keyUp", keyCode: "Return" });
-          await waitForPotentialNavigation(wc, beforeUrl);
-          const afterUrl = wc.getURL();
-          return afterUrl !== beforeUrl ? `Searched "${query}" → ${afterUrl}` : `Searched "${query}" (same page — results may have loaded dynamically)`;
-        }
-      );
+        await new Promise((r) => setTimeout(r, 50));
+        const beforeUrl = wc.getURL();
+        wc.sendInputEvent({ type: "keyDown", keyCode: "Return" });
+        await new Promise((r) => setTimeout(r, 16));
+        wc.sendInputEvent({ type: "keyUp", keyCode: "Return" });
+        await waitForPotentialNavigation(wc, beforeUrl);
+        const afterUrl = wc.getURL();
+        return afterUrl !== beforeUrl ? `Searched "${query}" → ${afterUrl}` : `Searched "${query}" (same page — results may have loaded dynamically)`;
+      });
     }
   );
   server.registerTool(
@@ -13899,7 +16075,9 @@ ${steps.join("\n")}`;
       description: "Navigate to the next or previous page of results. Auto-detects pagination controls.",
       inputSchema: {
         direction: zod.z.enum(["next", "prev"]).describe("Pagination direction"),
-        selector: zod.z.string().optional().describe("CSS selector for the pagination link (auto-detected if omitted)")
+        selector: zod.z.string().optional().describe(
+          "CSS selector for the pagination link (auto-detected if omitted)"
+        )
       }
     },
     async ({ direction, selector }) => {
@@ -13937,7 +16115,8 @@ ${steps.join("\n")}`;
               return false;
             })()
           `);
-          if (!clicked) return `Error: Could not find ${direction} pagination control. Try providing a selector.`;
+          if (!clicked)
+            return `Error: Could not find ${direction} pagination control. Try providing a selector.`;
           await waitForPotentialNavigation(wc, beforeUrl);
           const afterUrl = wc.getURL();
           return afterUrl !== beforeUrl ? `Paginated ${direction} → ${afterUrl}` : `Clicked ${direction} (page may have updated dynamically)`;
@@ -13953,12 +16132,15 @@ ${steps.join("\n")}`;
       inputSchema: zod.z.object({})
     },
     async () => {
+      const tab = tabManager.getActiveTab();
+      if (!tab) return asTextResponse("Error: No active tab");
       return withAction(
-        tabManager,
         runtime,
+        tabManager,
         "vessel_accept_cookies",
         {},
-        async (wc) => {
+        async () => {
+          const wc = tab.view.webContents;
           const dismissed = await wc.executeJavaScript(`
             (function() {
               var selectors = [
@@ -14008,12 +16190,15 @@ ${steps.join("\n")}`;
       })
     },
     async ({ index, selector: rawSelector }) => {
+      const tab = tabManager.getActiveTab();
+      if (!tab) return asTextResponse("Error: No active tab");
       return withAction(
-        tabManager,
         runtime,
+        tabManager,
         "vessel_extract_table",
         { index, selector: rawSelector },
-        async (wc) => {
+        async () => {
+          const wc = tab.view.webContents;
           const sel = rawSelector || (index != null ? await resolveSelector(wc, index) : null);
           const tableJson = await wc.executeJavaScript(`
             (function() {
@@ -14060,12 +16245,15 @@ ${JSON.stringify(tableJson, null, 2)}`;
       })
     },
     async ({ index, selector: rawSelector, position }) => {
+      const tab = tabManager.getActiveTab();
+      if (!tab) return asTextResponse("Error: No active tab");
       return withAction(
-        tabManager,
         runtime,
+        tabManager,
         "vessel_scroll_to_element",
         { index, selector: rawSelector, position },
-        async (wc) => {
+        async () => {
+          const wc = tab.view.webContents;
           const sel = rawSelector || (index != null ? await resolveSelector(wc, index) : null);
           if (!sel) return "Error: Provide an index or selector.";
           const block = position === "top" ? "start" : position === "bottom" ? "end" : "center";
@@ -14115,12 +16303,15 @@ ${JSON.stringify(tableJson, null, 2)}`;
       })
     },
     async ({ timeoutMs }) => {
+      const tab = tabManager.getActiveTab();
+      if (!tab) return asTextResponse("Error: No active tab");
       return withAction(
-        tabManager,
         runtime,
+        tabManager,
         "vessel_wait_for_navigation",
         { timeoutMs },
-        async (wc) => {
+        async () => {
+          const wc = tab.view.webContents;
           const timeout = timeoutMs || 1e4;
           const beforeUrl = wc.getURL();
           if (wc.isLoading()) {
@@ -14134,9 +16325,12 @@ ${JSON.stringify(tableJson, null, 2)}`;
           } else {
             await new Promise((resolve) => {
               let navigated = false;
-              const timer = setTimeout(() => {
-                if (!navigated) resolve();
-              }, Math.min(timeout, 2e3));
+              const timer = setTimeout(
+                () => {
+                  if (!navigated) resolve();
+                },
+                Math.min(timeout, 2e3)
+              );
               wc.once("did-start-loading", () => {
                 navigated = true;
                 clearTimeout(timer);
@@ -14174,7 +16368,9 @@ ${JSON.stringify(tableJson, null, 2)}`;
         `Tool breakdown:`
       ];
       for (const [name, stats] of Object.entries(m.toolBreakdown)) {
-        lines.push(`  ${name}: ${stats.count} calls, avg ${stats.avgMs}ms${stats.errors > 0 ? `, ${stats.errors} errors` : ""}`);
+        lines.push(
+          `  ${name}: ${stats.count} calls, avg ${stats.avgMs}ms${stats.errors > 0 ? `, ${stats.errors} errors` : ""}`
+        );
       }
       return asTextResponse(lines.join("\n"));
     }