@quanta-intellect/vessel-browser 0.1.9 → 0.1.11

package/out/main/index.js

@@ -6,13 +6,13 @@ const fs = require("fs");
 const crypto = require("crypto");
 const Anthropic = require("@anthropic-ai/sdk");
 const OpenAI = require("openai");
+const zod = require("zod");
 const path$1 = require("node:path");
 const node_crypto = require("node:crypto");
 const http = require("node:http");
 const os = require("node:os");
 const mcp_js = require("@modelcontextprotocol/sdk/server/mcp.js");
 const streamableHttp_js = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
-const zod = require("zod");
 const MAX_CUSTOM_HISTORY = 50;
 class Tab {
   id;
@@ -62,6 +62,26 @@ class Tab {
       isReaderMode: false,
       adBlockingEnabled: options?.adBlockingEnabled ?? true
     };
+    this.view.webContents.on("before-input-event", (event, input) => {
+      if (!input.control && !input.meta) return;
+      const key = input.key.toLowerCase();
+      const wc = this.view.webContents;
+      if (input.type === "keyDown") {
+        if (key === "c") {
+          wc.copy();
+          event.preventDefault();
+        } else if (key === "v") {
+          wc.paste();
+          event.preventDefault();
+        } else if (key === "x") {
+          wc.cut();
+          event.preventDefault();
+        } else if (key === "a") {
+          wc.selectAll();
+          event.preventDefault();
+        }
+      }
+    });
     this.setupListeners();
     if (url) {
       this.lastCommittedUrl = url;
@@ -527,10 +547,12 @@ function resolveColor(color) {
 }
 const VESSEL_HIGHLIGHT_CSS = `
 .__vessel-highlight {
-  outline: 3px solid #f0c636 !important;
-  outline-offset: 2px !important;
-  box-shadow: 0 0 12px rgba(240, 198, 54, 0.5) !important;
-  transition: outline-color 0.3s, box-shadow 0.3s;
+  background: rgba(240, 198, 54, 0.3) !important;
+  outline: 2px solid rgba(240, 198, 54, 0.6) !important;
+  outline-offset: 1px !important;
+  border-radius: 2px !important;
+  box-shadow: 0 0 8px rgba(240, 198, 54, 0.3) !important;
+  transition: background 0.3s, outline-color 0.3s, box-shadow 0.3s;
 }
 .__vessel-highlight-text {
   background: rgba(240, 198, 54, 0.3) !important;
@@ -553,6 +575,11 @@ const VESSEL_HIGHLIGHT_CSS = `
   line-height: 1.3;
   overflow-wrap: break-word;
   box-shadow: 0 2px 6px rgba(0,0,0,0.3);
+  opacity: 0;
+  transition: opacity 0.15s ease-in-out;
+}
+.__vessel-highlight-label.visible {
+  opacity: 1;
 }
 `;
 async function highlightOnPage(wc, resolvedSelector, text, label, durationMs, color) {
@@ -583,14 +610,14 @@ async function highlightOnPage(wc, resolvedSelector, text, label, durationMs, co
             if (!label) return null;
             var anchor = label.__vesselAnchor;
             if (!anchor || !anchor.isConnected) {
-              label.style.opacity = '0';
+              label.classList.remove('visible');
               return null;
             }
             var rect = anchor.getBoundingClientRect();
             var viewportWidth = window.innerWidth || document.documentElement.clientWidth || 0;
             var viewportHeight = window.innerHeight || document.documentElement.clientHeight || 0;
             if (!viewportWidth || !viewportHeight || rect.width === 0 && rect.height === 0) {
-              label.style.opacity = '0';
+              label.classList.remove('visible');
               return null;
             }
             var margin = 8;
@@ -606,7 +633,7 @@ async function highlightOnPage(wc, resolvedSelector, text, label, durationMs, co
             var visible = rect.bottom >= 0 && rect.top <= viewportHeight && rect.right >= 0 && rect.left <= viewportWidth;
             label.style.top = top + 'px';
             label.style.left = left + 'px';
-            label.style.opacity = visible ? '1' : '0';
+            if (!visible) label.classList.remove('visible');
             return {
               left: left,
               top: top,
@@ -655,9 +682,14 @@ async function highlightOnPage(wc, resolvedSelector, text, label, durationMs, co
       (function() {
         var el = document.querySelector(${JSON.stringify(resolvedSelector)});
         if (!el) return 'Element not found';
+        // Remove any existing badge on this element to avoid duplicates
+        document.querySelectorAll('.__vessel-highlight-label[data-vessel-highlight]').forEach(function(b) {
+          if (b.__vesselAnchor === el) b.remove();
+        });
         el.classList.add('__vessel-highlight');
+        el.style.setProperty('background', ${JSON.stringify(c.bg)}, 'important');
         el.style.setProperty('outline-color', ${JSON.stringify(c.solid)}, 'important');
-        el.style.setProperty('box-shadow', '0 0 12px ' + ${JSON.stringify(c.glow)}, 'important');
+        el.style.setProperty('box-shadow', '0 0 8px ' + ${JSON.stringify(c.glow)}, 'important');
         el.scrollIntoView({ behavior: 'smooth', block: 'center' });
         var label = ${JSON.stringify(label || "")};
         var badge = null;
@@ -671,6 +703,8 @@ async function highlightOnPage(wc, resolvedSelector, text, label, durationMs, co
           badge.__vesselAnchor = el;
           document.body.appendChild(badge);
           window.__vesselHighlightLabelManager.positionAll();
+          el.addEventListener('mouseenter', function() { badge.classList.add('visible'); });
+          el.addEventListener('mouseleave', function() { badge.classList.remove('visible'); });
         }
         var duration = ${durationMs ?? 0};
         if (duration > 0) {
@@ -691,6 +725,10 @@ async function highlightOnPage(wc, resolvedSelector, text, label, durationMs, co
         var bgColor = ${JSON.stringify(c.bg)};
         var labelBg = ${JSON.stringify(c.label)};
         var labelText = ${JSON.stringify(c.text)};
+        // Remove any existing badges whose text matches to avoid duplicates
+        document.querySelectorAll('.__vessel-highlight-label[data-vessel-highlight]').forEach(function(b) {
+          if (b.textContent === ${JSON.stringify(label || "")}) b.remove();
+        });
         var SKIP_TAGS = {SCRIPT:1,STYLE:1,NOSCRIPT:1,TEMPLATE:1,IFRAME:1,SVG:1};
         // Collect matching text nodes first, then wrap — avoids TreeWalker
         // seeing newly created nodes from surroundContents and re-matching.
@@ -747,6 +785,11 @@ async function highlightOnPage(wc, resolvedSelector, text, label, durationMs, co
           badge.__vesselAnchor = firstMark;
           document.body.appendChild(badge);
           window.__vesselHighlightLabelManager.positionAll();
+          var marks = document.querySelectorAll('mark.__vessel-highlight-text[data-vessel-highlight]');
+          marks.forEach(function(m) {
+            m.addEventListener('mouseenter', function() { if (badge) { badge.__vesselAnchor = m; window.__vesselHighlightLabelManager.positionAll(); badge.classList.add('visible'); } });
+            m.addEventListener('mouseleave', function() { if (badge) badge.classList.remove('visible'); });
+          });
         }
         var duration = ${durationMs ?? 0};
         if (duration > 0) {
@@ -1836,7 +1879,8 @@ const defaults = {
   obsidianVaultPath: "",
   approvalMode: "confirm-dangerous",
   agentTranscriptMode: "summary",
-  chatProvider: null
+  chatProvider: null,
+  maxToolIterations: 200
 };
 let settings = null;
 let settingsIssues = [];
@@ -1902,6 +1946,28 @@ function setSetting(key, value) {
   saveSettings();
   return { ...settings };
 }
+function enableClipboardShortcuts(view) {
+  view.webContents.on("before-input-event", (event, input) => {
+    if (!input.control && !input.meta) return;
+    const key = input.key.toLowerCase();
+    const wc = view.webContents;
+    if (input.type === "keyDown") {
+      if (key === "c") {
+        wc.copy();
+        event.preventDefault();
+      } else if (key === "v") {
+        wc.paste();
+        event.preventDefault();
+      } else if (key === "x") {
+        wc.cut();
+        event.preventDefault();
+      } else if (key === "a") {
+        wc.selectAll();
+        event.preventDefault();
+      }
+    }
+  });
+}
 const CHROME_HEIGHT = 110;
 const DEFAULT_DEVTOOLS_PANEL_HEIGHT = 250;
 const MIN_DEVTOOLS_PANEL = 120;
@@ -1954,6 +2020,9 @@ function createMainWindow(onTabStateChange) {
   });
   devtoolsPanelView.setBackgroundColor("#00000000");
   mainWindow.contentView.addChildView(devtoolsPanelView);
+  enableClipboardShortcuts(chromeView);
+  enableClipboardShortcuts(sidebarView);
+  enableClipboardShortcuts(devtoolsPanelView);
   const settings2 = loadSettings();
   const uiState = {
     sidebarOpen: false,
@@ -3712,7 +3781,7 @@ function setMcpHealth(update) {
     mcpStatusChangeListener?.(state$1.mcp.status);
   }
 }
-const MAX_AGENT_ITERATIONS$1 = 15;
+const DEFAULT_MAX_ITERATIONS$1 = 200;
 class AnthropicProvider {
   client;
   model;
@@ -3760,7 +3829,10 @@ class AnthropicProvider {
       { role: "user", content: userMessage }
     ];
     try {
-      for (let i = 0; i < MAX_AGENT_ITERATIONS$1; i++) {
+      const maxIterations = loadSettings().maxToolIterations || DEFAULT_MAX_ITERATIONS$1;
+      let iterationsUsed = 0;
+      for (let i = 0; i < maxIterations; i++) {
+        iterationsUsed = i + 1;
         const stream = this.client.messages.stream(
           {
             model: this.model,
@@ -3821,14 +3893,15 @@ class AnthropicProvider {
           });
         }
         messages.push({ role: "assistant", content: assistantContent });
-        if (finalMessage.stop_reason !== "tool_use" || toolUseBlocks.length === 0) {
+        if (toolUseBlocks.length === 0) {
           break;
         }
         const toolResults = [];
         for (const tb of toolUseBlocks) {
           const argSummary = tb.input.url || tb.input.text || tb.input.direction || "";
           onChunk(`
-\`[${tb.name}${argSummary ? ": " + argSummary : ""}]\` `);
+<<tool:${tb.name}${argSummary ? ":" + argSummary : ""}>>
+`);
           const result = await onToolCall(tb.name, tb.input);
           toolResults.push({
             type: "tool_result",
@@ -3838,6 +3911,11 @@ class AnthropicProvider {
         }
         messages.push({ role: "user", content: toolResults });
       }
+      if (iterationsUsed >= maxIterations) {
+        onChunk(`
+
+[Reached maximum tool call limit (${maxIterations} steps). You can adjust this in Settings → Max Tool Iterations, or continue by sending another message.]`);
+      }
     } catch (err) {
       if (err.name !== "AbortError") {
         onChunk(`
@@ -3943,7 +4021,7 @@ const PROVIDERS = {
     apiKeyHint: "Any OpenAI-compatible API endpoint"
   }
 };
-const MAX_AGENT_ITERATIONS = 15;
+const DEFAULT_MAX_ITERATIONS = 200;
 function toOpenAITools(tools) {
   return tools.map((t) => ({
     type: "function",
@@ -4009,7 +4087,10 @@ class OpenAICompatProvider {
       { role: "user", content: userMessage }
     ];
     try {
-      for (let i = 0; i < MAX_AGENT_ITERATIONS; i++) {
+      const maxIterations = loadSettings().maxToolIterations || DEFAULT_MAX_ITERATIONS;
+      let iterationsUsed = 0;
+      for (let i = 0; i < maxIterations; i++) {
+        iterationsUsed = i + 1;
         let textAccum = "";
         const toolCallAccums = {};
         let finishReason = null;
@@ -4066,7 +4147,8 @@ class OpenAICompatProvider {
           }
           const argSummary = args.url || args.text || args.direction || "";
           onChunk(`
-\`[${tc.name}${argSummary ? ": " + argSummary : ""}]\` `);
+<<tool:${tc.name}${argSummary ? ":" + argSummary : ""}>>
+`);
           const result = await onToolCall(tc.name, args);
           messages.push({
             role: "tool",
@@ -4075,6 +4157,11 @@ class OpenAICompatProvider {
           });
         }
       }
+      if (iterationsUsed >= maxIterations) {
+        onChunk(`
+
+[Reached maximum tool call limit (${maxIterations} steps). You can adjust this in Settings → Max Tool Iterations, or continue by sending another message.]`);
+      }
     } catch (err) {
       if (err.name !== "AbortError") {
         onChunk(`
@@ -4633,6 +4720,11 @@ function buildScopedContext(page, mode) {
       const largePageHint = formatLargePageHint(page);
       if (largePageHint) sections.push(`**Reading Hint:** ${largePageHint}`);
       sections.push("");
+      const summaryIntent = analyzePageIntent(page);
+      if (summaryIntent) {
+        sections.push(summaryIntent);
+        sections.push("");
+      }
       if ((page.pageIssues?.length ?? 0) > 0) {
         sections.push("### Page Access Warnings");
         sections.push(formatPageIssues(page.pageIssues ?? []));
@@ -4688,6 +4780,11 @@ function buildScopedContext(page, mode) {
       sections.push(`**Title:** ${page.title}`);
       sections.push(`**Viewport:** ${formatViewport(page)}`);
       sections.push("");
+      const interactivesIntent = analyzePageIntent(page);
+      if (interactivesIntent) {
+        sections.push(interactivesIntent);
+        sections.push("");
+      }
       const interactivesHighlights = getHighlightsForPage(page.url);
       if (interactivesHighlights.length > 0) {
         sections.push("### Highlights & Annotations");
@@ -4864,6 +4961,62 @@ function buildScopedContext(page, mode) {
       return buildStructuredContext(page);
   }
 }
+function analyzePageIntent(page) {
+  const hints = [];
+  const url = page.url.toLowerCase();
+  (page.title || "").toLowerCase();
+  const hasPasswordField = page.forms.some(
+    (f) => f.fields.some((el) => el.inputType === "password")
+  );
+  const hasSearchInput = page.interactiveElements.some(
+    (el) => el.inputType === "search" || el.name === "q" || el.name === "query" || el.name === "search" || (el.placeholder || "").toLowerCase().includes("search")
+  ) || page.forms.some(
+    (f) => f.fields.some(
+      (el) => el.inputType === "search" || el.name === "q" || el.name === "query"
+    )
+  );
+  const formCount = page.forms.length;
+  const hasCart = page.interactiveElements.some(
+    (el) => (el.text || "").toLowerCase().includes("cart") || (el.text || "").toLowerCase().includes("checkout")
+  ) || url.includes("cart") || url.includes("checkout");
+  const hasResults = page.interactiveElements.filter((el) => el.type === "link").length > 10;
+  const hasPagination = page.interactiveElements.some(
+    (el) => (el.text || "").toLowerCase() === "next" || el.text === "›" || el.text === "»" || (el.label || "").toLowerCase().includes("next page")
+  );
+  if (hasPasswordField) {
+    hints.push("Page type: LOGIN/SIGNUP");
+    hints.push("Suggested: vessel_login or vessel_fill_form → auto-fills credentials and submits");
+    const userField = page.forms.flatMap((f) => f.fields).find(
+      (el) => el.inputType === "email" || el.name === "email" || el.name === "username" || el.autocomplete === "username"
+    );
+    if (userField) {
+      hints.push(`Username field: #${userField.index} [${userField.label || userField.name || userField.placeholder || "input"}]`);
+    }
+  } else if (hasSearchInput && !hasResults) {
+    hints.push("Page type: SEARCH READY");
+    hints.push("Suggested: vessel_search → auto-finds search box, types query, and submits");
+  } else if (hasResults && hasSearchInput) {
+    hints.push("Page type: SEARCH RESULTS");
+    hints.push("Suggested: click a result link, or vessel_paginate for more results");
+    if (hasPagination) hints.push("Pagination detected — vessel_paginate available");
+  } else if (hasCart) {
+    hints.push("Page type: SHOPPING/CHECKOUT");
+    hints.push("Suggested: vessel_fill_form for payment/address fields");
+  } else if (formCount > 0 && !hasPasswordField) {
+    const totalFields = page.forms.reduce((n, f) => n + f.fields.length, 0);
+    hints.push(`Page type: FORM (${formCount} form${formCount > 1 ? "s" : ""}, ${totalFields} fields)`);
+    hints.push("Suggested: vessel_fill_form → fill all fields in one call");
+  } else if (hasPagination) {
+    hints.push("Page type: PAGINATED LIST");
+    hints.push("Suggested: vessel_paginate to navigate between pages");
+  } else if (page.content.length > 3e3 && page.interactiveElements.length < 10) {
+    hints.push("Page type: ARTICLE/CONTENT");
+    hints.push("Suggested: vessel_extract_content for readable text");
+  }
+  if (hints.length === 0) return "";
+  return `### Page Intent (Speedee)
+${hints.join("\n")}`;
+}
 function buildStructuredContext(page) {
   const sections = [];
   sections.push("## PAGE STRUCTURE");
@@ -4877,6 +5030,11 @@ function buildStructuredContext(page) {
   if (page.byline) sections.push(`**Author:** ${page.byline}`);
   if (page.excerpt) sections.push(`**Summary:** ${page.excerpt}`);
   sections.push("");
+  const pageIntent = analyzePageIntent(page);
+  if (pageIntent) {
+    sections.push(pageIntent);
+    sections.push("");
+  }
   if ((page.pageIssues?.length ?? 0) > 0) {
     sections.push("### Page Access Warnings");
     sections.push(formatPageIssues(page.pageIssues ?? []));
@@ -4988,567 +5146,432 @@ function buildGeneralPrompt(query) {
     user: query
   };
 }
-const AGENT_TOOLS = [
+const TOOL_DEFINITIONS = [
+  // --- Tab Management ---
   {
     name: "current_tab",
-    description: "Get the browser tab the human is actively looking at right now. Use this instead of list_tabs when you only need the focused tab.",
-    input_schema: {
-      type: "object",
-      properties: {}
-    }
+    title: "Get Active Tab",
+    description: "Get the browser tab the human is actively looking at right now. Use this instead of list_tabs when you only need the focused tab."
   },
   {
     name: "list_tabs",
-    description: "List all open browser tabs with their IDs, titles, and URLs.",
-    input_schema: {
-      type: "object",
-      properties: {}
-    }
+    title: "List Tabs",
+    description: "List all open browser tabs with their IDs, titles, and URLs."
   },
   {
     name: "switch_tab",
+    title: "Switch Tab",
     description: "Switch to a browser tab by tab ID, or by matching part of the title or URL.",
-    input_schema: {
-      type: "object",
-      properties: {
-        tabId: { type: "string", description: "Exact tab ID to switch to" },
-        match: {
-          type: "string",
-          description: "Case-insensitive partial match against tab title or URL"
-        }
-      }
+    inputSchema: {
+      tabId: zod.z.string().optional().describe("Exact tab ID to switch to"),
+      match: zod.z.string().optional().describe(
+        "Case-insensitive partial match against tab title or URL"
+      )
     }
   },
   {
     name: "create_tab",
+    title: "Create Tab",
     description: "Open a new browser tab, optionally navigating to a URL.",
-    input_schema: {
-      type: "object",
-      properties: {
-        url: { type: "string", description: "Optional URL to open" }
-      }
+    inputSchema: {
+      url: zod.z.string().optional().describe("Optional URL to open")
     }
   },
+  // --- Navigation ---
   {
     name: "navigate",
+    title: "Navigate",
     description: "Navigate the browser to a URL.",
-    input_schema: {
-      type: "object",
-      properties: {
-        url: { type: "string", description: "The URL to navigate to" }
-      },
-      required: ["url"]
+    inputSchema: {
+      url: zod.z.string().describe("The URL to navigate to")
     }
   },
   {
     name: "go_back",
-    description: "Go back to the previous page in browser history.",
-    input_schema: {
-      type: "object",
-      properties: {}
-    }
+    title: "Go Back",
+    description: "Go back to the previous page in browser history."
   },
   {
     name: "go_forward",
-    description: "Go forward in browser history.",
-    input_schema: {
-      type: "object",
-      properties: {}
-    }
+    title: "Go Forward",
+    description: "Go forward in browser history."
   },
   {
     name: "reload",
-    description: "Reload the current page.",
-    input_schema: {
-      type: "object",
-      properties: {}
-    }
+    title: "Reload",
+    description: "Reload the current page."
   },
+  // --- Interaction ---
   {
     name: "click",
-    description: "Click an element on the page. Use the element index from the page content listing, or a CSS selector.",
-    input_schema: {
-      type: "object",
-      properties: {
-        index: {
-          type: "number",
-          description: "The element index number from the page content"
-        },
-        selector: {
-          type: "string",
-          description: "CSS selector as fallback if index is not available"
-        }
-      }
+    title: "Click Element",
+    description: "Click an element on the page by its index number or CSS selector.",
+    inputSchema: {
+      index: zod.z.number().optional().describe("Element index from the page content listing"),
+      selector: zod.z.string().optional().describe("CSS selector as fallback")
     }
   },
   {
     name: "type_text",
+    title: "Type Text",
     description: "Type text into an input field or textarea. Clears existing content first.",
-    input_schema: {
-      type: "object",
-      properties: {
-        index: { type: "number", description: "The element index number" },
-        selector: { type: "string", description: "CSS selector as fallback" },
-        text: { type: "string", description: "The text to type" },
-        mode: {
-          type: "string",
-          enum: ["default", "keystroke"],
-          description: '"default" sets value directly and fires input+change events. "keystroke" simulates character-by-character key events for apps that validate on keypress.'
-        }
-      },
-      required: ["text"]
+    inputSchema: {
+      index: zod.z.number().optional().describe("The element index number"),
+      selector: zod.z.string().optional().describe("CSS selector as fallback"),
+      text: zod.z.string().describe("The text to type"),
+      mode: zod.z.enum(["default", "keystroke"]).optional().describe(
+        '"default" sets value directly. "keystroke" simulates character-by-character key events.'
+      )
     }
   },
   {
     name: "select_option",
+    title: "Select Option",
     description: "Select an option in a dropdown by visible label or option value.",
-    input_schema: {
-      type: "object",
-      properties: {
-        index: {
-          type: "number",
-          description: "The select element index number"
-        },
-        selector: { type: "string", description: "CSS selector as fallback" },
-        label: {
-          type: "string",
-          description: "Visible option label to match"
-        },
-        value: {
-          type: "string",
-          description: "Option value attribute to match"
-        }
-      }
+    inputSchema: {
+      index: zod.z.number().optional().describe("The select element index number"),
+      selector: zod.z.string().optional().describe("CSS selector as fallback"),
+      label: zod.z.string().optional().describe("Visible option label to match"),
+      value: zod.z.string().optional().describe("Option value attribute to match")
     }
   },
   {
     name: "submit_form",
+    title: "Submit Form",
     description: "Submit a form using a field index, submit button index, form selector, or button selector.",
-    input_schema: {
-      type: "object",
-      properties: {
-        index: {
-          type: "number",
-          description: "Index of a field or submit button inside the target form"
-        },
-        selector: {
-          type: "string",
-          description: "Form or submit button selector"
-        }
-      }
+    inputSchema: {
+      index: zod.z.number().optional().describe("Index of a form field or submit button"),
+      selector: zod.z.string().optional().describe("Form or submit button selector")
     }
   },
   {
     name: "press_key",
-    description: "Press a keyboard key, optionally targeting a specific element first.",
-    input_schema: {
-      type: "object",
-      properties: {
-        key: {
-          type: "string",
-          description: "Keyboard key, for example Enter or Escape"
-        },
-        index: { type: "number", description: "Element index to focus first" },
-        selector: {
-          type: "string",
-          description: "CSS selector to focus first"
-        }
-      },
-      required: ["key"]
+    title: "Press Key",
+    description: "Press a keyboard key, optionally after focusing an element.",
+    inputSchema: {
+      key: zod.z.string().describe("Keyboard key such as Enter or Escape"),
+      index: zod.z.number().optional().describe("Element index to focus first"),
+      selector: zod.z.string().optional().describe("CSS selector to focus first")
     }
   },
   {
     name: "scroll",
+    title: "Scroll",
     description: "Scroll the page up or down.",
-    input_schema: {
-      type: "object",
-      properties: {
-        direction: {
-          type: "string",
-          enum: ["up", "down"],
-          description: "Scroll direction"
-        },
-        amount: {
-          type: "number",
-          description: "Pixels to scroll (default 500)"
-        }
-      },
-      required: ["direction"]
+    inputSchema: {
+      direction: zod.z.enum(["up", "down"]).describe("Scroll direction"),
+      amount: zod.z.number().optional().describe("Pixels to scroll (default 500)")
     }
   },
   {
     name: "hover",
+    title: "Hover Element",
     description: "Move the mouse pointer over an element to trigger hover states, tooltips, or dropdown menus.",
-    input_schema: {
-      type: "object",
-      properties: {
-        index: { type: "number", description: "Element index number" },
-        selector: { type: "string", description: "CSS selector as fallback" }
-      }
+    inputSchema: {
+      index: zod.z.number().optional().describe("Element index number"),
+      selector: zod.z.string().optional().describe("CSS selector as fallback")
     }
   },
   {
     name: "focus",
+    title: "Focus Element",
     description: "Focus an input, button, or interactive element. Useful before pressing keys or to trigger focus-dependent UI.",
-    input_schema: {
-      type: "object",
-      properties: {
-        index: { type: "number", description: "Element index number" },
-        selector: { type: "string", description: "CSS selector as fallback" }
-      }
+    inputSchema: {
+      index: zod.z.number().optional().describe("Element index number"),
+      selector: zod.z.string().optional().describe("CSS selector as fallback")
     }
   },
+  // --- Page & Content ---
   {
     name: "set_ad_blocking",
-    description: "Enable or disable ad blocking for the active tab or a matched tab. Reload after changes unless you explicitly set reload to false.",
-    input_schema: {
-      type: "object",
-      properties: {
-        enabled: {
-          type: "boolean",
-          description: "Whether ad blocking should be enabled for the tab"
-        },
-        tabId: {
-          type: "string",
-          description: "Exact tab ID to target instead of the active tab"
-        },
-        match: {
-          type: "string",
-          description: "Case-insensitive partial match against tab title or URL"
-        },
-        reload: {
-          type: "boolean",
-          description: "Reload the tab after changing the setting (default true)"
-        }
-      },
-      required: ["enabled"]
+    title: "Set Ad Blocking",
+    description: "Enable or disable ad blocking for the active tab or a matched tab. Reload after changes unless reload is false.",
+    inputSchema: {
+      enabled: zod.z.boolean().describe("Whether ad blocking should be enabled for the tab"),
+      tabId: zod.z.string().optional().describe("Exact tab ID to target instead of the active tab"),
+      match: zod.z.string().optional().describe(
+        "Case-insensitive partial match against tab title or URL"
+      ),
+      reload: zod.z.boolean().optional().describe("Reload the tab after changing (default true)")
     }
   },
   {
     name: "dismiss_popup",
-    description: "Dismiss a modal, popup, newsletter gate, cookie banner, or overlay using common close/decline actions.",
-    input_schema: {
-      type: "object",
-      properties: {}
-    }
+    title: "Dismiss Popup",
+    description: "Dismiss a modal, popup, newsletter gate, cookie banner, or overlay using common close/decline actions."
   },
   {
     name: "read_page",
-    description: "Re-read the current page content. Includes active text selection and visible unsaved highlights on the active tab when present. Use after navigation or interaction to see updated content.",
-    input_schema: {
-      type: "object",
-      properties: {}
-    }
+    title: "Read Page",
+    description: "Re-read the current page content. Includes active text selection and visible unsaved highlights. Use after navigation or interaction to see updated content."
   },
   {
     name: "wait_for",
+    title: "Wait For",
     description: "Wait for a text string or CSS selector to appear on the page before continuing.",
-    input_schema: {
-      type: "object",
-      properties: {
-        text: {
-          type: "string",
-          description: "Text that should appear in the page body"
-        },
-        selector: {
-          type: "string",
-          description: "CSS selector that should match an element"
-        },
-        timeoutMs: {
-          type: "number",
-          description: "Maximum time to wait in milliseconds (default 5000)"
-        }
-      }
+    inputSchema: {
+      text: zod.z.string().optional().describe("Text that should appear in the page body"),
+      selector: zod.z.string().optional().describe("CSS selector that should match an element"),
+      timeoutMs: zod.z.number().optional().describe("Maximum time to wait in milliseconds (default 5000)")
     }
   },
+  // --- Checkpoints & Sessions ---
   {
     name: "create_checkpoint",
+    title: "Create Checkpoint",
     description: "Capture the current browser session as a named checkpoint for later recovery.",
-    input_schema: {
-      type: "object",
-      properties: {
-        name: {
-          type: "string",
-          description: "Short checkpoint name"
-        },
-        note: {
-          type: "string",
-          description: "Optional note about why this checkpoint matters"
-        }
-      }
+    inputSchema: {
+      name: zod.z.string().optional().describe("Short checkpoint name"),
+      note: zod.z.string().optional().describe("Optional note about why this checkpoint matters")
     }
   },
   {
     name: "restore_checkpoint",
+    title: "Restore Checkpoint",
     description: "Restore a previously captured checkpoint by name or ID.",
-    input_schema: {
-      type: "object",
-      properties: {
-        checkpointId: {
-          type: "string",
-          description: "Exact checkpoint ID"
-        },
-        name: {
-          type: "string",
-          description: "Checkpoint name to match if ID is unknown"
-        }
-      }
+    inputSchema: {
+      checkpointId: zod.z.string().optional().describe("Exact checkpoint ID"),
+      name: zod.z.string().optional().describe("Checkpoint name to match if ID is unknown")
     }
   },
   {
     name: "save_session",
+    title: "Save Session",
     description: "Persist the current browser cookies, localStorage, and tab layout under a reusable session name.",
-    input_schema: {
-      type: "object",
-      properties: {
-        name: {
-          type: "string",
-          description: "Session name such as github-logged-in"
-        }
-      },
-      required: ["name"]
+    inputSchema: {
+      name: zod.z.string().describe("Session name such as github-logged-in")
     }
   },
   {
     name: "load_session",
+    title: "Load Session",
     description: "Load a previously saved named session, restoring cookies, localStorage, and saved tabs.",
-    input_schema: {
-      type: "object",
-      properties: {
-        name: {
-          type: "string",
-          description: "Previously saved session name"
-        }
-      },
-      required: ["name"]
+    inputSchema: {
+      name: zod.z.string().describe("Previously saved session name")
     }
   },
   {
     name: "list_sessions",
-    description: "List previously saved named browser sessions with cookie and storage counts.",
-    input_schema: {
-      type: "object",
-      properties: {}
-    }
+    title: "List Sessions",
+    description: "List previously saved named browser sessions with cookie and storage counts."
   },
   {
     name: "delete_session",
+    title: "Delete Session",
     description: "Delete a previously saved named browser session.",
-    input_schema: {
-      type: "object",
-      properties: {
-        name: {
-          type: "string",
-          description: "Saved session name to delete"
-        }
-      },
-      required: ["name"]
+    inputSchema: {
+      name: zod.z.string().describe("Saved session name to delete")
     }
   },
+  // --- Bookmarks ---
   {
     name: "list_bookmarks",
+    title: "List Bookmarks",
     description: "List bookmark folders and saved pages. Optionally filter by folder name or ID.",
-    input_schema: {
-      type: "object",
-      properties: {
-        folderId: {
-          type: "string",
-          description: "Exact bookmark folder ID to filter by"
-        },
-        folderName: {
-          type: "string",
-          description: "Exact bookmark folder name to filter by"
-        }
-      }
+    inputSchema: {
+      folderId: zod.z.string().optional().describe("Exact bookmark folder ID to filter by"),
+      folderName: zod.z.string().optional().describe("Exact bookmark folder name to filter by")
     }
   },
   {
     name: "search_bookmarks",
+    title: "Search Bookmarks",
     description: "Search bookmarks by title, URL, note, folder name, or folder summary.",
-    input_schema: {
-      type: "object",
-      properties: {
-        query: {
-          type: "string",
-          description: "Search term to match against saved bookmarks"
-        }
-      },
-      required: ["query"]
+    inputSchema: {
+      query: zod.z.string().describe("Search term to match against saved bookmarks")
     }
   },
   {
     name: "create_bookmark_folder",
-    description: "Create a bookmark folder for organizing saved pages. If the same folder already exists, return it instead of creating a duplicate.",
-    input_schema: {
-      type: "object",
-      properties: {
-        name: {
-          type: "string",
-          description: "Folder name to create"
-        },
-        summary: {
-          type: "string",
-          description: "Optional one-sentence summary shown in the UI for this folder"
-        }
-      },
-      required: ["name"]
+    title: "Create Bookmark Folder",
+    description: "Create a bookmark folder for organizing saved pages. Returns existing folder if the same name exists.",
+    inputSchema: {
+      name: zod.z.string().describe("Folder name to create"),
+      summary: zod.z.string().optional().describe("Optional one-sentence summary for this folder")
     }
   },
   {
     name: "save_bookmark",
-    description: "Save the current page, a specified URL, or a link target from the current page as a bookmark. If folderName is provided and missing, create it automatically.",
-    input_schema: {
-      type: "object",
-      properties: {
-        url: {
-          type: "string",
-          description: "URL to save. Omit to save the current page, or provide index/selector to save a link target from the page."
-        },
-        title: {
-          type: "string",
-          description: "Title for the bookmark. Omit to use the current page title or the selected link text."
-        },
-        index: {
-          type: "number",
-          description: "Element index of a link on the current page to bookmark without opening it."
-        },
-        selector: {
-          type: "string",
-          description: "CSS selector of a link on the current page to bookmark without opening it."
-        },
-        folderId: {
-          type: "string",
-          description: "Folder ID to save into"
-        },
-        folderName: {
-          type: "string",
-          description: "Folder name to save into. Created automatically if missing."
-        },
-        folderSummary: {
-          type: "string",
-          description: "Optional summary used if a new folder is created"
-        },
-        createFolderIfMissing: {
-          type: "boolean",
-          description: "Create folderName automatically when it does not exist"
-        },
-        note: {
-          type: "string",
-          description: "Optional note about why the page was saved"
-        },
-        onDuplicate: {
-          type: "string",
-          enum: ["ask", "update", "duplicate"],
-          description: 'How to handle an existing bookmark with the same URL in the same folder: "ask" (default), "update", or "duplicate".'
-        }
-      }
+    title: "Save Bookmark",
+    description: "Save the current page, a specified URL, or a link target from the current page as a bookmark.",
+    inputSchema: {
+      url: zod.z.string().optional().describe("URL to save. Omit to save the current page."),
+      title: zod.z.string().optional().describe("Title for the bookmark"),
+      index: zod.z.number().optional().describe("Element index of a link to bookmark without opening"),
+      selector: zod.z.string().optional().describe("CSS selector of a link to bookmark without opening"),
+      folderId: zod.z.string().optional().describe("Folder ID to save into"),
+      folderName: zod.z.string().optional().describe("Folder name to save into. Created automatically if missing."),
+      folderSummary: zod.z.string().optional().describe("Optional summary used if a new folder is created"),
+      createFolderIfMissing: zod.z.boolean().optional().describe("Create folderName automatically when it does not exist"),
+      note: zod.z.string().optional().describe("Optional note about why the page was saved"),
+      onDuplicate: zod.z.enum(["ask", "update", "duplicate"]).optional().describe("How to handle duplicate URLs in the same folder")
     }
   },
   {
     name: "organize_bookmark",
-    description: 'Organize a bookmark by intent: move an existing bookmark or save the current page, a URL, or a link target from the current page into a folder, creating the folder if needed. If archive is true, use the default "Archive" folder.',
-    input_schema: {
-      type: "object",
-      properties: {
-        bookmarkId: {
-          type: "string",
-          description: "Existing bookmark ID to move or update"
-        },
-        url: {
-          type: "string",
-          description: "URL to organize. Omit to use the current page, or provide index/selector to organize a link target from the page."
-        },
-        title: {
-          type: "string",
-          description: "Optional title when saving a new bookmark or retitling an existing one"
-        },
-        index: {
-          type: "number",
-          description: "Element index of a link on the current page to organize without opening it."
-        },
-        selector: {
-          type: "string",
-          description: "CSS selector of a link on the current page to organize without opening it."
-        },
-        folderId: {
-          type: "string",
-          description: "Exact bookmark folder ID target"
-        },
-        folderName: {
-          type: "string",
-          description: "Folder name target. Created automatically if missing"
-        },
-        folderSummary: {
-          type: "string",
-          description: "Optional summary used if a new folder is created"
-        },
-        createFolderIfMissing: {
-          type: "boolean",
-          description: "Create folderName automatically when it does not exist"
-        },
-        note: {
-          type: "string",
-          description: "Optional note to attach or update on the bookmark"
-        },
-        archive: {
-          type: "boolean",
-          description: 'If true, organize into the default "Archive" folder'
-        }
-      }
+    title: "Organize Bookmark",
+    description: "Move an existing bookmark or save the current page into a folder, creating the folder if needed.",
+    inputSchema: {
+      bookmarkId: zod.z.string().optional().describe("Existing bookmark ID to move"),
+      url: zod.z.string().optional().describe("URL to organize"),
+      title: zod.z.string().optional().describe("Optional title"),
+      index: zod.z.number().optional().describe("Element index of a link to organize"),
+      selector: zod.z.string().optional().describe("CSS selector of a link to organize"),
+      folderId: zod.z.string().optional().describe("Target folder ID"),
+      folderName: zod.z.string().optional().describe("Target folder name. Created automatically if missing"),
+      folderSummary: zod.z.string().optional().describe("Optional summary for new folder"),
+      createFolderIfMissing: zod.z.boolean().optional().describe("Create folderName automatically when it does not exist"),
+      note: zod.z.string().optional().describe("Optional note"),
+      archive: zod.z.boolean().optional().describe('If true, organize into the default "Archive" folder')
     }
   },
   {
     name: "archive_bookmark",
-    description: 'Archive the current page, a URL, a link target from the current page, or an existing bookmark into the default "Archive" folder.',
-    input_schema: {
-      type: "object",
-      properties: {
-        bookmarkId: {
-          type: "string",
-          description: "Existing bookmark ID to archive"
-        },
-        url: {
-          type: "string",
-          description: "URL to archive. Omit to use the current page, or provide index/selector to archive a link target from the page."
-        },
-        title: {
-          type: "string",
-          description: "Optional title when saving a new archived bookmark"
-        },
-        index: {
-          type: "number",
-          description: "Element index of a link on the current page to archive without opening it."
-        },
-        selector: {
-          type: "string",
-          description: "CSS selector of a link on the current page to archive without opening it."
-        },
-        note: {
-          type: "string",
-          description: "Optional note about why the page was archived"
-        }
-      }
+    title: "Archive Bookmark",
+    description: 'Archive the current page, a URL, a link target, or an existing bookmark into the "Archive" folder.',
+    inputSchema: {
+      bookmarkId: zod.z.string().optional().describe("Existing bookmark ID to archive"),
+      url: zod.z.string().optional().describe("URL to archive"),
+      title: zod.z.string().optional().describe("Optional title"),
+      index: zod.z.number().optional().describe("Element index of a link to archive"),
+      selector: zod.z.string().optional().describe("CSS selector of a link to archive"),
+      note: zod.z.string().optional().describe("Optional note")
     }
   },
   {
     name: "open_bookmark",
+    title: "Open Bookmark",
     description: "Open a saved bookmark by its bookmark ID. Optionally open it in a new tab.",
-    input_schema: {
-      type: "object",
-      properties: {
-        bookmarkId: {
-          type: "string",
-          description: "Exact bookmark ID to open"
-        },
-        newTab: {
-          type: "boolean",
-          description: "Open the bookmark in a new tab instead of the current tab"
-        }
-      },
-      required: ["bookmarkId"]
+    inputSchema: {
+      bookmarkId: zod.z.string().describe("Exact bookmark ID to open"),
+      newTab: zod.z.boolean().optional().describe("Open in a new tab instead of the current tab")
+    }
+  },
+  // --- Highlights ---
+  {
+    name: "highlight",
+    title: "Highlight Element",
+    description: "Visually highlight an element or text on the page for the user. Use to draw attention to specific content. Highlights persist until cleared.",
+    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)"),
+      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)"),
+      color: zod.z.enum(["yellow", "red", "green", "blue", "purple", "orange"]).optional().describe("Highlight color (default yellow)")
+    }
+  },
+  {
+    name: "clear_highlights",
+    title: "Clear Highlights",
+    description: "Remove all visual highlights from the current page."
+  },
+  // --- Speedee System: Flow State ---
+  {
+    name: "flow_start",
+    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.",
+    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'])"
+      )
+    }
+  },
+  {
+    name: "flow_advance",
+    title: "Advance Workflow Step",
+    description: "Mark the current workflow step as done and move to the next one.",
+    inputSchema: {
+      detail: zod.z.string().optional().describe("Brief note about what was accomplished")
+    }
+  },
+  {
+    name: "flow_status",
+    title: "Workflow Status",
+    description: "Check the current workflow progress."
+  },
+  {
+    name: "flow_end",
+    title: "End Workflow",
+    description: "Clear the active workflow tracker."
+  },
+  // --- 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."
+  },
+  // --- Speedee System: Composable Macros ---
+  {
+    name: "fill_form",
+    title: "Fill Form",
+    description: "Fill multiple form fields at once. Much faster than calling type_text for each field individually.",
+    inputSchema: {
+      fields: zod.z.array(
+        zod.z.object({
+          index: zod.z.number().optional().describe("Element index from page content"),
+          selector: zod.z.string().optional().describe("CSS selector fallback"),
+          value: zod.z.string().describe("Value to enter")
+        })
+      ).describe("Fields to fill"),
+      submit: zod.z.boolean().optional().describe("Submit the form after filling (default false)")
+    }
+  },
+  {
+    name: "login",
+    title: "Login",
+    description: "Compound action: navigate to a login page, fill credentials, and submit. Handles the full login flow in one call.",
+    inputSchema: {
+      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)")
+    }
+  },
+  {
+    name: "search",
+    title: "Search",
+    description: "Find a search box on the current page, type a query, and submit. Returns the resulting page state.",
+    inputSchema: {
+      query: zod.z.string().describe("Search query text"),
+      selector: zod.z.string().optional().describe("CSS selector for search input (auto-detected if omitted)")
+    }
+  },
+  {
+    name: "paginate",
+    title: "Paginate",
+    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 pagination link (auto-detected if omitted)")
     }
   }
 ];
+function toAnthropicTools(defs) {
+  return defs.filter((d) => !d.mcpOnly).map((d) => {
+    let inputSchema;
+    if (d.inputSchema) {
+      const jsonSchema = zod.z.toJSONSchema(zod.z.object(d.inputSchema));
+      delete jsonSchema.$schema;
+      delete jsonSchema.additionalProperties;
+      inputSchema = jsonSchema;
+    } else {
+      inputSchema = {
+        type: "object",
+        properties: {}
+      };
+    }
+    return {
+      name: d.name,
+      description: d.description,
+      input_schema: inputSchema
+    };
+  });
+}
+const AGENT_TOOLS = toAnthropicTools(TOOL_DEFINITIONS);
 function trimText(value) {
   return typeof value === "string" ? value.trim() : "";
 }
@@ -6643,6 +6666,17 @@ async function describeElementForClick$1(wc, selector) {
   };
 }
 async function clickResolvedSelector$1(wc, selector) {
+  if (selector.startsWith("__vessel_idx:")) {
+    const idx = Number(selector.slice("__vessel_idx:".length));
+    const beforeUrl2 = wc.getURL();
+    const result = await wc.executeJavaScript(
+      `window.__vessel?.interactByIndex?.(${idx}, "click") || "Error: interactByIndex not available"`
+    );
+    if (typeof result === "string" && result.startsWith("Error")) return result;
+    await waitForPotentialNavigation$1(wc, beforeUrl2);
+    const afterUrl2 = wc.getURL();
+    return afterUrl2 !== beforeUrl2 ? `${result} -> ${afterUrl2}` : result;
+  }
   const beforeUrl = wc.getURL();
   const elInfo = await describeElementForClick$1(wc, selector);
   if ("error" in elInfo) return `Error: ${elInfo.error}`;
@@ -6750,6 +6784,10 @@ async function dismissPopup$1(wc) {
         document.querySelectorAll("dialog, [role='dialog'], [role='alertdialog'], [aria-modal='true']").forEach((el) => {
           if (isVisible(el)) nodes.push(el);
         });
+        // Detect known consent manager containers by ID/class patterns
+        document.querySelectorAll("#onetrust-consent-sdk, #onetrust-banner-sdk, [id*='onetrust'], [class*='onetrust'], #CybotCookiebotDialog, #truste-consent-track, [id*='cookie-banner'], [id*='consent-banner'], [class*='cookie-consent'], [class*='consent-banner'], [id*='gdpr'], [class*='gdpr']").forEach((el) => {
+          if (el instanceof HTMLElement && isVisible(el)) nodes.push(el);
+        });
         document.querySelectorAll("body *").forEach((el) => {
           if (!(el instanceof HTMLElement) || !isVisible(el)) return;
           const style = window.getComputedStyle(el);
@@ -6779,14 +6817,20 @@ async function dismissPopup$1(wc) {
             el.textContent ||
             el.getAttribute("value"),
         ).toLowerCase();
-        const classText = text(el.className).toLowerCase();
+        const classText = text(typeof el.className === "string" ? el.className : "").toLowerCase();
         const idText = text(el.id).toLowerCase();
+        const combined = classText + " " + idText;
         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/.test(label)) score += 100;
-        if (/close|dismiss|modal-close|overlay-close/.test(classText + " " + idText)) score += 90;
+        if (/no thanks|no, thanks|not now|maybe later|dismiss|close|skip|cancel|continue without|no thank you|reject|decline/.test(label)) score += 100;
+        if (/close|dismiss|modal-close|overlay-close/.test(combined)) score += 90;
+        // Known consent manager dismiss/reject buttons get a big boost
+        if (/onetrust-close|onetrust-reject|cookie.*close|consent.*close|cookie.*reject|consent.*reject/.test(combined)) score += 110;
+        // 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 (/accept|continue|submit|sign up|subscribe|join|start|next/.test(label)) score -= 80;
+        // 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();
         if (rect.top < 120) score += 10;
         if (rect.right > (window.innerWidth || 0) - 120) score += 15;
@@ -6802,13 +6846,26 @@ async function dismissPopup$1(wc) {
           if (!(el instanceof HTMLElement) || !isVisible(el)) return;
           const candidateSelector = selectorFor(el);
           if (!candidateSelector) return;
-          const label = text(
+          var label = text(
             el.getAttribute("aria-label") ||
               el.getAttribute("title") ||
               el.textContent ||
               el.getAttribute("value"),
           );
-          if (!label) return;
+          // Don't skip empty-label buttons from known consent managers
+          if (!label) {
+            var idLower = (el.id || "").toLowerCase();
+            var classLower = (typeof el.className === "string" ? el.className : "").toLowerCase();
+            var combined = idLower + " " + classLower;
+            if (/onetrust|consent|cookie|banner|gdpr|trustarc|cookiebot/.test(combined)) {
+              label = idLower.includes("accept") ? "Accept cookies"
+                : idLower.includes("reject") ? "Reject cookies"
+                : idLower.includes("close") || classLower.includes("close") ? "Close"
+                : "Consent button";
+            } else {
+              return;
+            }
+          }
           results.push({
             selector: candidateSelector,
             label: label.slice(0, 120),
@@ -6877,7 +6934,11 @@ async function resolveSelector$1(wc, index, selector) {
     `
   );
   if (typeof authoritativeSelector === "string" && authoritativeSelector) {
-    return authoritativeSelector;
+    const resolves = await wc.executeJavaScript(
+      `!!document.querySelector(${JSON.stringify(authoritativeSelector)})`
+    );
+    if (resolves) return authoritativeSelector;
+    return `__vessel_idx:${index}`;
   }
   const page = await extractContent(wc);
   const extractedSelector = findSelectorByIndex(page, index);
@@ -6978,10 +7039,20 @@ function isDangerousAction$1(name) {
     "create_tab",
     "switch_tab",
     "restore_checkpoint",
-    "load_session"
+    "load_session",
+    "login",
+    "fill_form",
+    "search",
+    "paginate"
   ].includes(name);
 }
 async function setElementValue$1(wc, selector, value) {
+  if (selector.startsWith("__vessel_idx:")) {
+    const idx = Number(selector.slice("__vessel_idx:".length));
+    return wc.executeJavaScript(
+      `window.__vessel?.interactByIndex?.(${idx}, "value", ${JSON.stringify(value)}) || "Error: interactByIndex not available"`
+    );
+  }
   return wc.executeJavaScript(`
     (function() {
       const el = document.querySelector(${JSON.stringify(selector)});
@@ -7407,9 +7478,12 @@ async function getPostActionState$1(ctx, name) {
     "click",
     "submit_form",
     "reload",
-    "press_key"
+    "press_key",
+    "login",
+    "search",
+    "paginate"
   ];
-  const interactActions = ["type_text", "select_option", "hover", "focus"];
+  const interactActions = ["type_text", "select_option", "hover", "focus", "fill_form"];
   const tabActions = [
     "create_tab",
     "switch_tab",
@@ -7479,7 +7553,12 @@ async function executeAction(name, args, ctx) {
     "save_bookmark",
     "organize_bookmark",
     "archive_bookmark",
-    "open_bookmark"
+    "open_bookmark",
+    "flow_start",
+    "flow_advance",
+    "flow_status",
+    "flow_end",
+    "suggest"
   ].includes(name)) {
     return "Error: No active tab";
   }
@@ -7964,12 +8043,251 @@ ${truncated}`;
           if (!wc) return "Error: No active tab";
           return clearHighlights(wc);
         }
+        // --- Speedee System ---
+        case "flow_start": {
+          const goal = typeof args.goal === "string" ? args.goal : "";
+          const steps = Array.isArray(args.steps) ? args.steps.map(String) : [];
+          if (!goal || steps.length === 0) return "Error: goal and steps are required";
+          const flow = ctx.runtime.startFlow(goal, steps, wc?.getURL());
+          return `Flow started: ${flow.goal}
+${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`;
+        }
+        case "flow_advance": {
+          const flow = ctx.runtime.advanceFlow(
+            typeof args.detail === "string" ? args.detail : void 0
+          );
+          if (!flow) return "No active flow to advance";
+          return `Step completed.${ctx.runtime.getFlowContext()}`;
+        }
+        case "flow_status": {
+          const flow = ctx.runtime.getFlowState();
+          if (!flow) return "No active workflow.";
+          return ctx.runtime.getFlowContext();
+        }
+        case "flow_end": {
+          ctx.runtime.clearFlow();
+          return "Workflow ended.";
+        }
+        case "suggest": {
+          if (!wc) return "No active tab. Use navigate to open a page.";
+          let page;
+          try {
+            page = await extractContent(wc);
+          } catch {
+            return "Could not read page. Try navigate to a working URL.";
+          }
+          const suggestions = [];
+          suggestions.push(`Page: ${page.title || "(untitled)"}`);
+          suggestions.push(`URL: ${page.url}`);
+          suggestions.push("");
+          const flowCtx2 = ctx.runtime.getFlowContext();
+          if (flowCtx2) {
+            suggestions.push(flowCtx2);
+            suggestions.push("");
+          }
+          const hasPasswordField = page.forms.some(
+            (f) => f.fields.some((el) => el.inputType === "password")
+          );
+          const hasSearchInput = page.interactiveElements.some(
+            (el) => el.inputType === "search" || el.name === "q" || el.name === "query" || (el.placeholder || "").toLowerCase().includes("search")
+          );
+          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 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("  → dismiss_popup or click on close/accept button");
+            suggestions.push("");
+          }
+          if (hasPasswordField) {
+            suggestions.push("LOGIN PAGE detected:");
+            suggestions.push("  → login(username, password) — handles the full flow");
+            suggestions.push("  → Or fill_form + submit_form for manual control");
+          } else if (hasSearchInput && linkCount < 10) {
+            suggestions.push("SEARCH PAGE detected:");
+            suggestions.push("  → search(query) — finds the box, types, submits");
+          } else if (hasSearchInput && linkCount >= 10) {
+            suggestions.push("SEARCH RESULTS detected:");
+            suggestions.push("  → click on a result link");
+            if (hasPagination) suggestions.push("  → paginate('next') for more results");
+          } else if (formCount > 0) {
+            suggestions.push(`FORM detected (${totalFields} fields):`);
+            suggestions.push("  → fill_form(fields) — fill all fields at once");
+          } else if (hasPagination) {
+            suggestions.push("PAGINATED CONTENT:");
+            suggestions.push("  → read_page to read this page");
+            suggestions.push("  → paginate('next') for the next page");
+          } else if (page.content.length > 3e3 && page.interactiveElements.length < 10) {
+            suggestions.push("ARTICLE/CONTENT page:");
+            suggestions.push("  → read_page for readable text");
+            suggestions.push("  → scroll to see more");
+          } else {
+            suggestions.push("GENERAL PAGE:");
+            suggestions.push("  → read_page to understand the page structure");
+            suggestions.push("  → click on any element by index");
+            suggestions.push("  → navigate to go somewhere new");
+          }
+          suggestions.push("");
+          suggestions.push(`Available: ${page.interactiveElements.length} interactive elements, ${formCount} forms, ${linkCount} links`);
+          return suggestions.join("\n");
+        }
+        case "fill_form": {
+          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);
+          }
+          if (args.submit) {
+            const firstSel = await resolveSelector$1(wc, fields[0]?.index, fields[0]?.selector);
+            if (firstSel) {
+              const beforeUrl = wc.getURL();
+              const submitResult = await submitForm$1(wc, { selector: firstSel });
+              await waitForPotentialNavigation$1(wc, beforeUrl);
+              const afterUrl = wc.getURL();
+              results.push(
+                afterUrl !== beforeUrl ? `Submitted → ${afterUrl}` : submitResult
+              );
+            }
+          }
+          return `Filled ${results.length} field(s):
+${results.join("\n")}`;
+        }
+        case "login": {
+          if (!wc) return "Error: No active tab";
+          const steps = [];
+          if (typeof args.url === "string" && args.url.trim()) {
+            const id = ctx.tabManager.getActiveTabId();
+            ctx.tabManager.navigateTab(id, args.url);
+            await waitForLoad$1(wc);
+            steps.push(`Navigated to ${wc.getURL()}`);
+          }
+          const userSel = args.username_selector || await wc.executeJavaScript(`
+              (function() {
+                var el = document.querySelector('input[type="email"], input[name="email"], input[name="username"], input[name="user"], input[autocomplete="username"], input[autocomplete="email"], input[type="text"]:not([name="search"]):not([name="q"])');
+                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.";
+          const passSel = args.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.";
+          const userResult = await setElementValue$1(wc, userSel, String(args.username || ""));
+          steps.push(userResult);
+          const passResult = await setElementValue$1(wc, passSel, String(args.password || ""));
+          steps.push(passResult);
+          const beforeUrl = wc.getURL();
+          if (args.submit_selector) {
+            await clickResolvedSelector$1(wc, args.submit_selector);
+          } else {
+            const clicked = await wc.executeJavaScript(`
+              (function() {
+                var btn = document.querySelector('button[type="submit"], input[type="submit"], form button:not([type="button"])');
+                if (btn) { btn.click(); return true; }
+                var form = document.querySelector('input[type="password"]')?.closest('form');
+                if (form) { form.requestSubmit ? form.requestSubmit() : form.submit(); return true; }
+                return false;
+              })()
+            `);
+            if (!clicked) return steps.join("\n") + "\nWarning: Could not find submit button. Credentials filled but form not submitted.";
+          }
+          await waitForPotentialNavigation$1(wc, beforeUrl);
+          const afterUrl = wc.getURL();
+          steps.push(
+            afterUrl !== beforeUrl ? `Submitted → ${afterUrl}` : "Form submitted (same page)"
+          );
+          return `Login flow complete:
+${steps.join("\n")}`;
+        }
+        case "search": {
+          if (!wc) return "Error: No active tab";
+          const searchSel = args.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) {
+                  var inputs = document.querySelectorAll('input[type="text"]');
+                  for (var i = 0; i < inputs.length; i++) {
+                    var form = inputs[i].closest('form');
+                    if (form && (form.getAttribute('role') === 'search' || form.action?.includes('search'))) {
+                      el = inputs[i];
+                      break;
+                    }
+                  }
+                }
+                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$1(wc, searchSel, String(args.query || ""));
+          await wc.executeJavaScript(`
+            (function() {
+              var el = document.querySelector(${JSON.stringify(searchSel)});
+              if (el) el.focus();
+            })()
+          `);
+          await sleep$1(50);
+          const beforeUrl = wc.getURL();
+          wc.sendInputEvent({ type: "keyDown", keyCode: "Return" });
+          await sleep$1(16);
+          wc.sendInputEvent({ type: "keyUp", keyCode: "Return" });
+          await waitForPotentialNavigation$1(wc, beforeUrl);
+          const afterUrl = wc.getURL();
+          return afterUrl !== beforeUrl ? `Searched "${args.query}" → ${afterUrl}` : `Searched "${args.query}" (same page — results may have loaded dynamically)`;
+        }
+        case "paginate": {
+          if (!wc) return "Error: No active tab";
+          const beforeUrl = wc.getURL();
+          if (args.selector) {
+            return clickResolvedSelector$1(wc, args.selector);
+          }
+          const isNext = args.direction === "next";
+          const clicked = await wc.executeJavaScript(`
+            (function() {
+              var patterns = ${isNext ? '["next", "Next", "›", "»", "→", ">", "Next Page", "Load More"]' : '["prev", "Prev", "Previous", "‹", "«", "←", "<", "Previous Page"]'};
+              var links = document.querySelectorAll('a, button');
+              for (var i = 0; i < links.length; i++) {
+                var el = links[i];
+                var text = (el.textContent || '').trim();
+                var ariaLabel = (el.getAttribute('aria-label') || '').toLowerCase();
+                var rel = (el.getAttribute('rel') || '').toLowerCase();
+                if (rel === '${isNext ? "next" : "prev"}') { el.click(); return true; }
+                for (var j = 0; j < patterns.length; j++) {
+                  if (text === patterns[j] || ariaLabel.includes(patterns[j].toLowerCase())) {
+                    el.click();
+                    return true;
+                  }
+                }
+              }
+              return false;
+            })()
+          `);
+          if (!clicked) return `Error: Could not find ${args.direction} pagination control. Try providing a selector.`;
+          await waitForPotentialNavigation$1(wc, beforeUrl);
+          const afterUrl = wc.getURL();
+          return afterUrl !== beforeUrl ? `Paginated ${args.direction} → ${afterUrl}` : `Clicked ${args.direction} (page may have updated dynamically)`;
+        }
         default:
           return `Unknown tool: ${name}`;
       }
     }
   });
-  return result + await getPostActionState$1(ctx, name);
+  const flowCtx = ctx.runtime.getFlowContext();
+  return result + await getPostActionState$1(ctx, name) + flowCtx;
 }
 async function handleAIQuery(query, provider, activeWebContents, onChunk, onEnd, tabManager, runtime, history) {
   const lowerQuery = query.toLowerCase().trim();
@@ -7981,8 +8299,20 @@ async function handleAIQuery(query, provider, activeWebContents, onChunk, onEnd,
       const truncated = pageContent.content.length > 2e4 ? pageContent.content.slice(0, 2e4) + "\n[Content truncated...]" : pageContent.content;
       const runtimeState = runtime.getState();
       const recentCheckpoints = runtimeState.checkpoints.slice(-3).map((item) => `- ${item.name} (${item.id})`).join("\n");
+      const activeTabTitle = pageContent.title || "(untitled)";
+      const activeTabUrl = pageContent.url || activeWebContents.getURL();
+      const allTabs = tabManager.getAllStates();
+      const activeTabId = tabManager.getActiveTabId();
+      const tabSummary = allTabs.length > 1 ? `
+All open tabs: ${allTabs.map((t) => `${t.id === activeTabId ? "→ " : ""}${t.title || "New Tab"} (${t.url})`).join(" | ")}` : "";
       const systemPrompt = `You are Vessel, an AI agent embedded in a web browser. You can see the current page and interact with it using tools.
 
+THE USER IS CURRENTLY LOOKING AT:
+  Title: ${activeTabTitle}
+  URL: ${activeTabUrl}${tabSummary}
+
+When the user says "this page", "this article", "this site", or asks about what they're viewing, they mean the page above. The content below is from that page — answer directly without needing to call read_page or current_tab first.
+
 Current page context:
 ${structuredContext}
 
@@ -8013,7 +8343,9 @@ Instructions:
 - If the page context reports a rate limit, human verification, or access warning, stop using that page and switch to a different source.
 - Reference interactive elements by their index number (shown as [#N] in the listings above).
 - Be concise. Explain what you're doing as you go.
-- For simple questions about the page, just answer directly without using tools.`;
+- For simple questions about the page, just answer directly without using tools.
+- You have a highlight tool that visually marks elements on the page for the user. Use it when the user asks you to highlight, mark, or draw attention to specific content. Colors: yellow (default), red (errors), green (success), blue (info), purple (important), orange (warnings).
+- After completing a task or answering a question, offer 1-2 brief, natural follow-up suggestions that make sense in context (e.g. "Want me to highlight any of these?" or "I can save these to a bookmark folder if you'd like"). Keep suggestions short and conversational — don't list every possible action.`;
       const actionCtx = { tabManager, runtime };
       await provider.streamAgentQuery(
         systemPrompt,
@@ -9130,6 +9462,17 @@ async function describeElementForClick(wc, selector) {
   };
 }
 async function clickResolvedSelector(wc, selector) {
+  if (selector.startsWith("__vessel_idx:")) {
+    const idx = Number(selector.slice("__vessel_idx:".length));
+    const beforeUrl2 = wc.getURL();
+    const result = await wc.executeJavaScript(
+      `window.__vessel?.interactByIndex?.(${idx}, "click") || "Error: interactByIndex not available"`
+    );
+    if (typeof result === "string" && result.startsWith("Error")) return result;
+    await waitForPotentialNavigation(wc, beforeUrl2);
+    const afterUrl2 = wc.getURL();
+    return afterUrl2 !== beforeUrl2 ? `${result} -> ${afterUrl2}` : result;
+  }
   const beforeUrl = wc.getURL();
   const elInfo = await describeElementForClick(wc, selector);
   if ("error" in elInfo) return `Error: ${elInfo.error}`;
@@ -9237,6 +9580,10 @@ async function dismissPopup(wc) {
         document.querySelectorAll("dialog, [role='dialog'], [role='alertdialog'], [aria-modal='true']").forEach((el) => {
           if (isVisible(el)) nodes.push(el);
         });
+        // Detect known consent manager containers
+        document.querySelectorAll("#onetrust-consent-sdk, #onetrust-banner-sdk, [id*='onetrust'], [class*='onetrust'], #CybotCookiebotDialog, #truste-consent-track, [id*='cookie-banner'], [id*='consent-banner'], [class*='cookie-consent'], [class*='consent-banner'], [id*='gdpr'], [class*='gdpr']").forEach((el) => {
+          if (el instanceof HTMLElement && isVisible(el)) nodes.push(el);
+        });
         document.querySelectorAll("body *").forEach((el) => {
           if (!(el instanceof HTMLElement) || !isVisible(el)) return;
           const style = window.getComputedStyle(el);
@@ -9266,14 +9613,17 @@ async function dismissPopup(wc) {
             el.textContent ||
             el.getAttribute("value"),
         ).toLowerCase();
-        const classText = text(el.className).toLowerCase();
+        const classText = text(typeof el.className === "string" ? el.className : "").toLowerCase();
         const idText = text(el.id).toLowerCase();
+        const combined = classText + " " + idText;
         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/.test(label)) score += 100;
-        if (/close|dismiss|modal-close|overlay-close/.test(classText + " " + idText)) score += 90;
+        if (/no thanks|no, thanks|not now|maybe later|dismiss|close|skip|cancel|continue without|no thank you|reject|decline/.test(label)) score += 100;
+        if (/close|dismiss|modal-close|overlay-close/.test(combined)) score += 90;
+        if (/onetrust-close|onetrust-reject|cookie.*close|consent.*close|cookie.*reject|consent.*reject/.test(combined)) score += 110;
+        if (/onetrust-accept|cookie.*accept|consent.*accept/.test(combined)) score += 80;
         if (el.getAttribute("aria-label")) score += 20;
-        if (/accept|continue|submit|sign up|subscribe|join|start|next/.test(label)) score -= 80;
+        if (/accept|continue|submit|sign up|subscribe|join|start|next/.test(label) && !/cookie|consent|onetrust/.test(combined)) score -= 80;
         const rect = el.getBoundingClientRect();
         if (rect.top < 120) score += 10;
         if (rect.right > (window.innerWidth || 0) - 120) score += 15;
@@ -9289,13 +9639,25 @@ async function dismissPopup(wc) {
           if (!(el instanceof HTMLElement) || !isVisible(el)) return;
           const candidateSelector = selectorFor(el);
           if (!candidateSelector) return;
-          const label = text(
+          var label = text(
             el.getAttribute("aria-label") ||
               el.getAttribute("title") ||
               el.textContent ||
               el.getAttribute("value"),
           );
-          if (!label) return;
+          if (!label) {
+            var idLower = (el.id || "").toLowerCase();
+            var classLower = (typeof el.className === "string" ? el.className : "").toLowerCase();
+            var combined = idLower + " " + classLower;
+            if (/onetrust|consent|cookie|banner|gdpr|trustarc|cookiebot/.test(combined)) {
+              label = idLower.includes("accept") ? "Accept cookies"
+                : idLower.includes("reject") ? "Reject cookies"
+                : idLower.includes("close") || classLower.includes("close") ? "Close"
+                : "Consent button";
+            } else {
+              return;
+            }
+          }
           results.push({
             selector: candidateSelector,
             label: label.slice(0, 120),
@@ -9362,7 +9724,11 @@ function isDangerousAction(name) {
     "create_tab",
     "switch_tab",
     "close_tab",
-    "restore_checkpoint"
+    "restore_checkpoint",
+    "login",
+    "fill_form",
+    "search",
+    "paginate"
   ].includes(name);
 }
 function getTabByMatch(tabManager, match) {
@@ -9439,7 +9805,8 @@ async function withAction(runtime, tabManager, name, args, executor) {
       executor
     });
     const stateInfo = await getPostActionState(tabManager, name);
-    return asTextResponse(result + stateInfo);
+    const flowCtx = runtime.getFlowContext();
+    return asTextResponse(result + stateInfo + flowCtx);
   } catch (error) {
     return asTextResponse(
       `Error: ${error instanceof Error ? error.message : "Unknown error"}`
@@ -9447,6 +9814,12 @@ async function withAction(runtime, tabManager, name, args, executor) {
   }
 }
 async function setElementValue(wc, selector, value) {
+  if (selector.startsWith("__vessel_idx:")) {
+    const idx = Number(selector.slice("__vessel_idx:".length));
+    return wc.executeJavaScript(
+      `window.__vessel?.interactByIndex?.(${idx}, "value", ${JSON.stringify(value)}) || "Error: interactByIndex not available"`
+    );
+  }
   return wc.executeJavaScript(`
     (function() {
       const el = document.querySelector(${JSON.stringify(selector)});
@@ -11794,6 +12167,382 @@ ${JSON.stringify(otherHighlights, null, 2)}`
       );
     }
   );
+  server.registerTool(
+    "vessel_flow_start",
+    {
+      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'])")
+      }
+    },
+    async ({ goal, steps }) => {
+      const tab = tabManager.getActiveTab();
+      const flow = runtime.startFlow(goal, steps, tab?.view.webContents.getURL());
+      return asTextResponse(
+        `Flow started: ${flow.goal}
+${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
+      );
+    }
+  );
+  server.registerTool(
+    "vessel_flow_advance",
+    {
+      title: "Advance Workflow Step",
+      description: "Mark the current workflow step as done and move to the next one. Call this after completing each step.",
+      inputSchema: {
+        detail: zod.z.string().optional().describe("Brief note about what was accomplished")
+      }
+    },
+    async ({ detail }) => {
+      const flow = runtime.advanceFlow(detail);
+      if (!flow) return asTextResponse("No active flow to advance");
+      const ctx = runtime.getFlowContext();
+      return asTextResponse(`Step completed.${ctx}`);
+    }
+  );
+  server.registerTool(
+    "vessel_flow_status",
+    {
+      title: "Workflow Status",
+      description: "Check the current workflow progress."
+    },
+    async () => {
+      const flow = runtime.getFlowState();
+      if (!flow) return asTextResponse("No active workflow.");
+      return asTextResponse(runtime.getFlowContext());
+    }
+  );
+  server.registerTool(
+    "vessel_flow_end",
+    {
+      title: "End Workflow",
+      description: "Clear the active workflow tracker."
+    },
+    async () => {
+      runtime.clearFlow();
+      return asTextResponse("Workflow ended.");
+    }
+  );
+  server.registerTool(
+    "vessel_suggest",
+    {
+      title: "What Should I Do?",
+      description: "Analyze the current page and return the most relevant tools and suggested next actions. Call this when you're unsure what to do next — it reads the page context and tells you the optimal approach."
+    },
+    async () => {
+      const tab = tabManager.getActiveTab();
+      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.");
+      }
+      const suggestions = [];
+      suggestions.push(`Page: ${page.title || "(untitled)"}`);
+      suggestions.push(`URL: ${page.url}`);
+      suggestions.push("");
+      const flowCtx = runtime.getFlowContext();
+      if (flowCtx) {
+        suggestions.push(flowCtx);
+        suggestions.push("");
+      }
+      page.url.toLowerCase();
+      const hasPasswordField = page.forms.some(
+        (f) => f.fields.some((el) => el.inputType === "password")
+      );
+      const hasSearchInput = page.interactiveElements.some(
+        (el) => el.inputType === "search" || el.name === "q" || el.name === "query" || (el.placeholder || "").toLowerCase().includes("search")
+      );
+      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 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("");
+      }
+      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");
+      } else if (hasSearchInput && linkCount < 10) {
+        suggestions.push("🔍 SEARCH PAGE detected:");
+        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");
+        if (hasPagination) {
+          suggestions.push("  → vessel_paginate('next') for more results");
+        }
+      } else if (formCount > 0) {
+        suggestions.push(`📝 FORM detected (${totalFields} fields):`);
+        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:");
+        suggestions.push("  → vessel_extract_content to read this page");
+        suggestions.push("  → vessel_paginate('next') for the next page");
+      } else if (page.content.length > 3e3 && page.interactiveElements.length < 10) {
+        suggestions.push("📖 ARTICLE/CONTENT page:");
+        suggestions.push("  → vessel_extract_content for readable text");
+        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_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`);
+      return asTextResponse(suggestions.join("\n"));
+    }
+  );
+  server.registerTool(
+    "vessel_fill_form",
+    {
+      title: "Fill Form",
+      description: "Fill multiple form fields at once. Provide a map of field identifiers to values. Fields are matched by index, name, label, or placeholder. Much faster than calling type for each field individually.",
+      inputSchema: {
+        fields: zod.z.array(
+          zod.z.object({
+            index: zod.z.number().optional().describe("Element index from page content"),
+            selector: zod.z.string().optional().describe("CSS selector fallback"),
+            value: zod.z.string().describe("Value to enter")
+          })
+        ).describe("Fields to fill"),
+        submit: zod.z.boolean().optional().describe("Submit the form after filling (default false)")
+      }
+    },
+    async ({ fields, submit }) => {
+      const tab = tabManager.getActiveTab();
+      if (!tab) return asTextResponse("Error: No active tab");
+      return withAction(
+        runtime,
+        tabManager,
+        "fill_form",
+        { 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);
+          }
+          if (submit) {
+            const firstSel = await resolveSelector(wc, fields[0]?.index, fields[0]?.selector);
+            if (firstSel) {
+              const beforeUrl = wc.getURL();
+              const submitResult = await submitForm(wc, void 0, firstSel);
+              await waitForPotentialNavigation(wc, beforeUrl);
+              const afterUrl = wc.getURL();
+              results.push(
+                afterUrl !== beforeUrl ? `Submitted → ${afterUrl}` : submitResult
+              );
+            }
+          }
+          return `Filled ${results.length} field(s):
+${results.join("\n")}`;
+        }
+      );
+    }
+  );
+  server.registerTool(
+    "vessel_login",
+    {
+      title: "Login",
+      description: "Compound action: navigate to a login page, fill credentials, and submit. Handles the full login flow in one call.",
+      inputSchema: {
+        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)")
+      }
+    },
+    async ({ url, username, password, username_selector, password_selector, submit_selector }) => {
+      const tab = tabManager.getActiveTab();
+      if (!tab) return asTextResponse("Error: No active tab");
+      return withAction(
+        runtime,
+        tabManager,
+        "login",
+        { url, username: username.slice(0, 3) + "***" },
+        async () => {
+          const wc = tab.view.webContents;
+          const steps = [];
+          if (url) {
+            const id = tabManager.getActiveTabId();
+            tabManager.navigateTab(id, url);
+            await waitForLoad(wc);
+            steps.push(`Navigated to ${wc.getURL()}`);
+          }
+          const userSel = username_selector || await wc.executeJavaScript(`
+              (function() {
+                var el = document.querySelector('input[type="email"], input[name="email"], input[name="username"], input[name="user"], input[autocomplete="username"], input[autocomplete="email"], input[type="text"]:not([name="search"]):not([name="q"])');
+                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.";
+          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.";
+          const userResult = await setElementValue(wc, userSel, username);
+          steps.push(userResult);
+          const passResult = await setElementValue(wc, passSel, password);
+          steps.push(passResult);
+          const beforeUrl = wc.getURL();
+          if (submit_selector) {
+            await clickResolvedSelector(wc, submit_selector);
+          } else {
+            const clicked = await wc.executeJavaScript(`
+              (function() {
+                var btn = document.querySelector('button[type="submit"], input[type="submit"], form button:not([type="button"])');
+                if (btn) { btn.click(); return true; }
+                var form = document.querySelector('input[type="password"]')?.closest('form');
+                if (form) { form.requestSubmit ? form.requestSubmit() : form.submit(); return true; }
+                return false;
+              })()
+            `);
+            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();
+          steps.push(
+            afterUrl !== beforeUrl ? `Submitted → ${afterUrl}` : "Form submitted (same page)"
+          );
+          return `Login flow complete:
+${steps.join("\n")}`;
+        }
+      );
+    }
+  );
+  server.registerTool(
+    "vessel_search",
+    {
+      title: "Search",
+      description: "Compound action: find a search box on the current page, type a query, and submit. Returns the resulting page state.",
+      inputSchema: {
+        query: zod.z.string().describe("Search query text"),
+        selector: zod.z.string().optional().describe("CSS selector for search input (auto-detected if omitted)")
+      }
+    },
+    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(`
+              (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) {
+                  var inputs = document.querySelectorAll('input[type="text"]');
+                  for (var i = 0; i < inputs.length; i++) {
+                    var form = inputs[i].closest('form');
+                    if (form && (form.getAttribute('role') === 'search' || form.action?.includes('search'))) {
+                      el = inputs[i];
+                      break;
+                    }
+                  }
+                }
+                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(`
+            (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)`;
+        }
+      );
+    }
+  );
+  server.registerTool(
+    "vessel_paginate",
+    {
+      title: "Paginate",
+      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)")
+      }
+    },
+    async ({ direction, selector }) => {
+      const tab = tabManager.getActiveTab();
+      if (!tab) return asTextResponse("Error: No active tab");
+      return withAction(
+        runtime,
+        tabManager,
+        "paginate",
+        { direction },
+        async () => {
+          const wc = tab.view.webContents;
+          const beforeUrl = wc.getURL();
+          if (selector) {
+            return clickResolvedSelector(wc, selector);
+          }
+          const isNext = direction === "next";
+          const clicked = await wc.executeJavaScript(`
+            (function() {
+              var patterns = ${isNext ? '["next", "Next", "›", "»", "→", ">", "Next Page", "Load More"]' : '["prev", "Prev", "Previous", "‹", "«", "←", "<", "Previous Page"]'};
+              var links = document.querySelectorAll('a, button');
+              for (var i = 0; i < links.length; i++) {
+                var el = links[i];
+                var text = (el.textContent || '').trim();
+                var ariaLabel = (el.getAttribute('aria-label') || '').toLowerCase();
+                var rel = (el.getAttribute('rel') || '').toLowerCase();
+                if (rel === '${isNext ? "next" : "prev"}') { el.click(); return true; }
+                for (var j = 0; j < patterns.length; j++) {
+                  if (text === patterns[j] || ariaLabel.includes(patterns[j].toLowerCase())) {
+                    el.click();
+                    return true;
+                  }
+                }
+              }
+              return false;
+            })()
+          `);
+          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)`;
+        }
+      );
+    }
+  );
 }
 function waitForLoad(wc, timeout = 1e4) {
   return new Promise((resolve) => {
@@ -11843,7 +12592,11 @@ async function resolveSelector(wc, index, selector) {
     `
   );
   if (typeof authoritativeSelector === "string" && authoritativeSelector) {
-    return authoritativeSelector;
+    const resolves = await wc.executeJavaScript(
+      `!!document.querySelector(${JSON.stringify(authoritativeSelector)})`
+    );
+    if (resolves) return authoritativeSelector;
+    return `__vessel_idx:${index}`;
   }
   const page = await extractContent(wc);
   const extractedSelector = findSelectorByIndex(page, index);
@@ -12396,7 +13149,8 @@ function sanitizePersistence(persisted) {
     actions: Array.isArray(persisted?.actions) ? persisted.actions.slice(-120) : [],
     checkpoints: Array.isArray(persisted?.checkpoints) ? persisted.checkpoints.slice(-20) : [],
     transcript: [],
-    mcpStatus: "stopped"
+    mcpStatus: "stopped",
+    flowState: null
   };
 }
 class AgentRuntime {
@@ -12515,6 +13269,67 @@ class AgentRuntime {
     this.emit();
     return this.getState();
   }
+  // --- Speedee Flow State ---
+  startFlow(goal, steps, startUrl) {
+    const flow = {
+      id: node_crypto.randomUUID(),
+      goal,
+      steps: steps.map((label) => ({ label, status: "pending" })),
+      currentStepIndex: 0,
+      startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      startUrl
+    };
+    this.state.flowState = flow;
+    this.emit();
+    return clone(flow);
+  }
+  advanceFlow(detail) {
+    const flow = this.state.flowState;
+    if (!flow) return null;
+    const step = flow.steps[flow.currentStepIndex];
+    if (step) {
+      step.status = "done";
+      step.detail = detail;
+    }
+    flow.currentStepIndex = Math.min(flow.currentStepIndex + 1, flow.steps.length);
+    flow.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.emit();
+    return clone(flow);
+  }
+  failFlowStep(detail) {
+    const flow = this.state.flowState;
+    if (!flow) return null;
+    const step = flow.steps[flow.currentStepIndex];
+    if (step) {
+      step.status = "failed";
+      step.detail = detail;
+    }
+    flow.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.emit();
+    return clone(flow);
+  }
+  getFlowState() {
+    return this.state.flowState ? clone(this.state.flowState) : null;
+  }
+  clearFlow() {
+    this.state.flowState = null;
+    this.emit();
+  }
+  getFlowContext() {
+    const flow = this.state.flowState;
+    if (!flow) return "";
+    const progress = flow.steps.map((s, i) => {
+      const marker = s.status === "done" ? "✓" : s.status === "failed" ? "✗" : s.status === "skipped" ? "-" : i === flow.currentStepIndex ? "→" : " ";
+      const detail = s.detail ? ` (${s.detail})` : "";
+      return `[${marker}] ${s.label}${detail}`;
+    }).join("\n");
+    return `
+--- Active Flow ---
+Goal: ${flow.goal}
+${progress}
+---`;
+  }
   async runControlledAction({
     source,
     name,