@quanta-intellect/vessel-browser 0.1.44 → 0.1.45

package/out/main/index.js

@@ -5380,7 +5380,7 @@ function buildPhaseReminder(userMessage, assistantText) {
   const multiClickSelectionSignals = /i(?:'| a)?ll start by clicking on the following books|i will start by clicking on the following books|i will click on the following books|clicked on five different book titles|clicked on \d+ different book titles|clicking through the selected titles|click each of the selected titles/.test(
     text
   );
-  const staleSelectionSignals = /cannot locate the elements to click|page structure is not being reliably captured|specific titles failed|page may have changed|stale-index/.test(
+  const staleSelectionSignals = /cannot locate the elements to click|page structure is not being reliably captured|specific titles failed|page may have changed|stale-index|no visible area|not visible/.test(
     text
   );
   const intermediateCartDialogSignals = /(added to cart|has been added to the cart|cart confirmation)/.test(text) && /(continue shopping|search results page|return to the search results page|back button|go back)/.test(
@@ -8212,6 +8212,8 @@ const COMPACT_FOCUS_INSTRUCTIONS = [
   "When read_page or inspect_element gives you an element index, prefer click(index=N) over selector-based clicks.",
   'If a product page has no visible purchase control, scroll and call read_page(mode="visible_only") again. Do not loop on generic inspect_element calls against navigation or unrelated regions.',
   "After adding an item to cart and going back, ALWAYS call read_page to see the current results. The system shows which products are already in your cart — do NOT click those again. Pick a DIFFERENT product from the list. If all visible results are already in cart, scroll down for more.",
+  'On search results pages, always call read_page(mode="results_only") first. Click products by their [#N] index from the Results section. Never click filter or sort links (e.g. Used, New, Format, Price).',
+  "After go_back, always call read_page before clicking. The page may have changed.",
   "Keep your reasoning short. Prefer taking the next tool action over writing a long plan."
 ];
 function buildInstructionBlock(instructions) {
@@ -8563,11 +8565,11 @@ function buildCompactScopedContext(page, mode, pageType = detectPageType(page))
   const primaryResultElements = getPrimaryResultLinks(page);
   const primaryResults = primaryResultElements.map(formatElement);
   if (primaryResults.length > 0) {
-    pushSection(
-      lines,
-      "### Primary Results",
-      primaryResults
-    );
+    lines.push("");
+    lines.push("### Results — click one of these to open a product");
+    lines.push(...primaryResults.map((item) => `- ${item}`));
+    lines.push("");
+    lines.push("IMPORTANT: Use click(index=N) on a result above. Do NOT click filter or sort links.");
   }
   if (pageType === "FORM" || pageType === "LOGIN" || mode === "forms_only") {
     pushSection(
@@ -8583,7 +8585,7 @@ function buildCompactScopedContext(page, mode, pageType = detectPageType(page))
     ).map(formatElement);
     pushSection(
       lines,
-      "### Visible Controls",
+      "### Page Controls (filters, sorts — avoid when selecting products)",
       visibleControls
     );
   }
@@ -10661,6 +10663,17 @@ function resolveTextTargetInDocument(doc, rawQuery, mode) {
       score += 30;
     }
     if (inViewport(el)) score += 25;
+    if (tag === "a") {
+      const href = htmlEl.href || "";
+      const filterParams = /\b(condition|binding|format|availability|sort|filter|price|category_id)\b=[^&]/i;
+      const filterPath = /\/(condition|binding|format|availability|sort|filter|price|category)\/[^/?#]+/i;
+      if (filterParams.test(href) || filterPath.test(href)) {
+        score -= 40;
+      }
+      if (/\b(used|new|paperback|hardcover|hardback|ebook|kindle|refine|clear all|remove filter)\b/.test(label)) {
+        score -= 30;
+      }
+    }
     return score;
   }
   function regionBonus(el) {
@@ -11080,9 +11093,9 @@ function waitForLoad$1(wc, timeout = 5e3) {
       finish();
       return;
     }
-    wc.on("did-finish-load", onLoadEvent);
-    wc.on("did-stop-loading", onLoadEvent);
-    wc.on("did-fail-load", onLoadEvent);
+    wc.once("did-finish-load", onLoadEvent);
+    wc.once("did-stop-loading", onLoadEvent);
+    wc.once("did-fail-load", onLoadEvent);
   });
 }
 function waitForPotentialNavigation$1(wc, beforeUrl, timeout = 2500) {
@@ -11135,8 +11148,8 @@ function waitForPotentialNavigation$1(wc, beforeUrl, timeout = 2500) {
     wc.once("did-start-loading", onStart);
     wc.once("did-navigate", onNavigate);
     wc.once("did-navigate-in-page", onNavigateInPage);
-    wc.on("did-stop-loading", onNativeChange);
-    wc.on("page-title-updated", onNativeChange);
+    wc.once("did-stop-loading", onNativeChange);
+    wc.once("page-title-updated", onNativeChange);
   });
 }
 async function getPostNavSummary(wc) {
@@ -11336,7 +11349,7 @@ async function clickElement$1(wc, selector) {
 
       const rect = el.getBoundingClientRect();
       if (rect.width <= 0 || rect.height <= 0) {
-        return { error: "Error[hidden]: Element has no visible area" };
+        return { error: "Error[hidden]: Element has no visible area. It may be inside a collapsed, lazy-loaded, or virtual-scroll section. Scroll toward it (scroll or scroll_to_element) then call read_page to refresh visible elements before clicking again." };
       }
 
       const points = samplePoints(rect);
@@ -11903,6 +11916,12 @@ function getCartAddedSummary(url) {
 Already in cart (${count} items):
 ${items}`;
 }
+function clearCartState() {
+  cartAddedProducts.clear();
+  recentCartClicks.clear();
+  clickStreakUrl = null;
+  clickStreakCount = 0;
+}
 async function buildCartSuccessSuffix(wc, productUrl, overlayHint) {
   const productTitle = await getProductPageTitle(wc);
   recordProductAddedToCart(productUrl, productTitle);
@@ -14480,6 +14499,18 @@ WARNING: You drifted to ${drift.targetDomain} but the task requires staying on $
         warnings += `${cartSummary}
 Select a DIFFERENT product that is not in the cart. Call read_page if needed to see available results.`;
       }
+      if (ctx.toolProfile === "compact" && name === "go_back") {
+        warnings += `
+Call read_page(mode="results_only") to see available products before clicking.`;
+      }
+    }
+    if (name === "click" && ctx.toolProfile === "compact") {
+      const filterParams = /\b(condition|binding|format|availability|sort|filter|price|category_id|view)\b=[^&]/i;
+      const filterPath = /\/(condition|binding|format|availability|sort|filter|price|category)\/[^/?#]+/i;
+      if (filterParams.test(currentUrl) || filterPath.test(currentUrl)) {
+        warnings += `
+WARNING: The clicked link appears to be a filter or sort control, not a product. If you intended to click a product, call go_back and use click(index=N) on a result from read_page(mode="results_only").`;
+      }
     }
     return `
 [state: url=${currentUrl}, title=${JSON.stringify(wc.getTitle() || "")}, canGoBack=${tab.canGoBack()}, canGoForward=${tab.canGoForward()}, loading=${wc.isLoading()}]${warnings}`;
@@ -15713,9 +15744,14 @@ async function handleAIQuery(query, provider, activeWebContents, onChunk, onEnd,
       const pageType = detectPageType(pageContent);
       const defaultReadMode = chooseAgentReadMode(pageContent);
       if (provider.agentToolProfile === "compact") {
+        const prevGoal = runtime2.getState().taskTracker?.goal?.trim();
         runtime2.ensureTaskTracker(query, pageContent.url || activeWebContents.getURL());
+        if (prevGoal !== query.trim()) {
+          clearCartState();
+        }
       } else {
         runtime2.clearTaskTracker();
+        clearCartState();
       }
       const structuredContext = provider.agentToolProfile === "compact" ? buildCompactScopedContext(
         pageContent,
@@ -16938,7 +16974,7 @@ async function clickElement(wc, selector) {
 
       const rect = el.getBoundingClientRect();
       if (rect.width <= 0 || rect.height <= 0) {
-        return { error: "Element is not visible" };
+        return { error: "Element is not visible. It may be inside a collapsed, lazy-loaded, or virtual-scroll section. Scroll toward it (scroll or scroll_to_element) then call read_page to refresh visible elements before clicking again." };
       }
 
       const points = samplePoints(rect);
@@ -17841,7 +17877,7 @@ async function hoverElement(wc, selector) {
         el.scrollIntoView({ behavior: 'instant', block: 'center', inline: 'center' });
       }
       const rect = el.getBoundingClientRect();
-      if (rect.width <= 0 || rect.height <= 0) return { error: 'Error[hidden]: Element has no visible area' };
+      if (rect.width <= 0 || rect.height <= 0) return { error: 'Error[hidden]: Element has no visible area. It may be inside a collapsed, lazy-loaded, or virtual-scroll section. Scroll toward it then call read_page to refresh visible elements.' };
       el.dispatchEvent(new MouseEvent('mouseover', { bubbles: true, cancelable: true }));
       el.dispatchEvent(new MouseEvent('mouseenter', { bubbles: false }));
       const label = (el.textContent || el.tagName || 'Element').trim().slice(0, 80);

package/out/preload/content-script.js

@@ -3209,6 +3209,11 @@ function interactByIndex(index, action, value) {
     return "Error[stale-index]: Element not found — the page may have changed. Call read_page to refresh.";
   }
   if (action === "click") {
+    el.scrollIntoView({ behavior: "instant", block: "center", inline: "center" });
+    const rect = el.getBoundingClientRect();
+    if (rect.width <= 0 || rect.height <= 0) {
+      return "Error[hidden]: Element has no visible area. It may be inside a collapsed, lazy-loaded, or virtual-scroll section. Scroll toward it, then call read_page to refresh visible elements.";
+    }
     el.focus();
     el.click();
     if (el instanceof HTMLInputElement) {
@@ -3235,6 +3240,7 @@ function interactByIndex(index, action, value) {
     return "Clicked: " + (el.getAttribute("aria-label") || el.textContent?.trim().slice(0, 60) || el.tagName.toLowerCase()) + (href ? "\nhref: " + href : "");
   }
   if (action === "focus") {
+    el.scrollIntoView({ behavior: "instant", block: "center", inline: "center" });
     el.focus();
     return "Focused: " + (el.getAttribute("aria-label") || el.textContent?.trim().slice(0, 60) || el.tagName.toLowerCase());
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@quanta-intellect/vessel-browser",
   "mcpName": "io.github.unmodeled-tyler/vessel-browser",
-  "version": "0.1.44",
+  "version": "0.1.45",
   "description": "AI-native web browser runtime for autonomous agents with human supervision",
   "main": "./out/main/index.js",
   "bin": {