@quanta-intellect/vessel-browser 0.1.60 → 0.1.61

package/README.md

@@ -93,6 +93,8 @@ Today, Vessel provides the browser shell, page visibility, and supervisory surfa
 - **Chat Assistant** — built-in conversational AI in the sidebar Chat tab; supports Anthropic, OpenAI, Ollama, llama.cpp, Mistral, xAI, Google Gemini, OpenRouter, and any OpenAI-compatible endpoint; reads the current page automatically; has full access to the same browser tools as external agents; multi-turn session history; configure provider, model, and API key in Settings
 - **Automation Kits** (Premium) — parameterized workflow templates in the sidebar Automate tab; fill in a short form and the built-in agent executes the workflow autonomously; bundled kits include Research & Collect (multi-source research with bookmark saving) and Price Scout (cross-retailer price comparison); designed for a future kit marketplace
 - **Dev Tools Panel** (`F12`) — inspect console output, network requests, and MCP/agent activity in a resizable panel at the bottom of the window; export logs by category and date range as JSON
+- **Agent-Meaningful Bookmarks** — bookmarks carry structured context the agent can read and act on: `intent` (what the page is for), `expectedContent` (what to expect on the page), `keyFields` (important form fields), `agentHints` (arbitrary directives), and a stored `pageSchema`; all fields are searchable
+- **Page Schema Inference** — Vessel automatically infers a typed schema for every page: `pageType` (article, product, form, search, checkout, login, dashboard), `primaryEntity` (structured fields for products and articles), `formFields` (with names, types, labels, selectors), and `actionButtons` (with inferred intents: submit, addToCart, login, etc.); schema is attached to every content extraction result
 - **Bookmarks for Agents** — save pages into folders, attach one-line folder summaries, and search bookmarks over MCP instead of dumping the entire library
 - **Named Session Persistence** — save cookies, localStorage, and current tab layout under a reusable name, then reload it after a restart
 - **Page Highlights** — agents can visually highlight text or elements on any page with labeled, color-coded markers that persist across navigation; highlight count and navigation controls appear in the sidebar; cleared explicitly or via tool call

package/out/main/index.js

@@ -3903,10 +3903,8 @@ function startBackgroundRevalidation() {
   }, REVALIDATION_INTERVAL_MS);
 }
 function stopBackgroundRevalidation() {
-  if (revalidationTimer) {
-    clearInterval(revalidationTimer);
-    revalidationTimer = null;
-  }
+  clearInterval(revalidationTimer);
+  revalidationTimer = null;
 }
 function isPremiumActiveState(state2) {
   return state2.status === "active" || state2.status === "trialing";
@@ -4011,8 +4009,8 @@ function stopTelemetry() {
   }
   if (flushTimer) {
     clearInterval(flushTimer);
-    flushTimer = null;
   }
+  flushTimer = null;
   void flush();
 }
 async function flush() {
@@ -4113,6 +4111,226 @@ function selectorHelpersJS(attributes = DEFAULT_SELECTOR_ATTRIBUTES) {
     "}"
   ].join("\n");
 }
+function normalizeString(value) {
+  return (value ?? "").trim().toLowerCase();
+}
+function mapInputType(el) {
+  const inputType = el.inputType ?? el.type ?? "text";
+  switch (inputType.toLowerCase()) {
+    case "email":
+      return "email";
+    case "password":
+      return "password";
+    case "number":
+    case "range":
+      return "number";
+    case "select-one":
+    case "select":
+      return "select";
+    case "checkbox":
+    case "radio":
+      return "checkbox";
+    case "date":
+    case "datetime-local":
+    case "time":
+    case "month":
+    case "week":
+      return "date";
+    case "file":
+      return "file";
+    default:
+      return "text";
+  }
+}
+function mapFormFields(forms, interactiveElements) {
+  const fields = [];
+  const formFieldSelectors = /* @__PURE__ */ new Set();
+  for (const form of forms) {
+    for (const el of form.fields ?? []) {
+      formFieldSelectors.add(el.selector || el.name || el.label || String(el.index));
+    }
+  }
+  for (const el of interactiveElements) {
+    const key = el.selector || el.name || el.label || String(el.index);
+    if (formFieldSelectors.has(key)) {
+      fields.push({
+        name: el.name || el.label || key,
+        type: mapInputType(el),
+        label: el.label,
+        required: el.required,
+        selector: el.selector || ""
+      });
+    }
+  }
+  return fields;
+}
+function mapActionButtons(interactiveElements) {
+  const buttons = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const el of interactiveElements) {
+    if (el.type !== "button" && el.type !== "submit" && el.type !== "reset") continue;
+    const label = (el.label || el.textContent || "").trim();
+    if (!label || seen.has(label)) continue;
+    seen.add(label);
+    let intent;
+    const normalized = normalizeString(label);
+    if (/\b(add to cart|buy now|add to bag|add to basket|shop now)\b/.test(normalized)) {
+      intent = "addToCart";
+    } else if (/\b(login|sign in|log in|signin|log-in)\b/.test(normalized)) {
+      intent = "login";
+    } else if (/\b(submit|send|continue|next|proceed|register|create account|sign up)\b/.test(normalized)) {
+      intent = "submit";
+    } else if (/\b(cancel|back|return|go back|close)\b/.test(normalized)) {
+      intent = "cancel";
+    } else if (/\b(download|export|save as)\b/.test(normalized)) {
+      intent = "download";
+    } else if (/\b(search|find|go|submit search)\b/.test(normalized)) {
+      intent = "search";
+    } else if (el.href || el.url) {
+      intent = "navigate";
+    }
+    if (el.selector || el.name || el.label) {
+      buttons.push({
+        label,
+        selector: el.selector || el.name || el.label,
+        intent
+      });
+    }
+  }
+  return buttons;
+}
+function extractPrimaryEntity(pageType, structuredData, metaTags) {
+  if (pageType === "product") {
+    const product = structuredData?.find(
+      (e) => e.types.some((t) => /^product$/i.test(t))
+    );
+    if (product) {
+      const attrs = product.attributes ?? {};
+      return {
+        type: "Product",
+        nameField: typeof attrs.name === "string" ? attrs.name : void 0,
+        priceField: typeof attrs.price === "string" ? attrs.price : typeof attrs.offers === "object" && attrs.offers !== null ? String(attrs.offers["price"] ?? "") : void 0,
+        imageField: typeof attrs.image === "string" ? attrs.image : Array.isArray(attrs.image) ? String(attrs.image[0]) : void 0,
+        descriptionField: typeof attrs.description === "string" ? attrs.description : void 0,
+        reviewsField: typeof attrs.reviews === "string" ? attrs.reviews : void 0,
+        ratingField: typeof attrs.rating === "string" ? attrs.rating : void 0,
+        addToCartField: void 0
+      };
+    }
+  }
+  if (pageType === "article") {
+    const article = structuredData?.find(
+      (e) => e.types.some(
+        (t) => /^(article|newsarticle|blogposting|webpage)$/i.test(t)
+      )
+    );
+    if (article) {
+      const attrs = article.attributes ?? {};
+      return {
+        type: article.types[0] ?? "Article",
+        nameField: typeof attrs.headline === "string" ? attrs.headline : typeof attrs.name === "string" ? attrs.name : void 0,
+        descriptionField: typeof attrs.articleBody === "string" ? attrs.articleBody : typeof attrs.description === "string" ? attrs.description : void 0
+      };
+    }
+  }
+  return void 0;
+}
+function inferPageSchema(page) {
+  let pageType = "unknown";
+  let confidence = 0.5;
+  const structuredData = page.structuredData;
+  const metaTags = page.metaTags;
+  const url = page.url ?? "";
+  const forms = page.forms ?? [];
+  const interactiveElements = page.interactiveElements ?? [];
+  const urlLower = normalizeString(url);
+  const jsonLdTypes = [];
+  for (const entity of structuredData ?? []) {
+    jsonLdTypes.push(...entity.types);
+  }
+  const hasProduct = jsonLdTypes.some((t) => /^product$/i.test(t));
+  const hasArticle = jsonLdTypes.some(
+    (t) => /^(article|newsarticle|blogposting)$/i.test(t)
+  );
+  const hasEvent = jsonLdTypes.some((t) => /^event$/i.test(t));
+  const hasSearchResults = jsonLdTypes.some((t) => /^searchresultspage$/i.test(t));
+  if (hasProduct) {
+    pageType = "product";
+    confidence += 0.2;
+  } else if (hasArticle) {
+    pageType = "article";
+    confidence += 0.2;
+  } else if (hasEvent) {
+    pageType = "form";
+    confidence += 0.15;
+  } else if (hasSearchResults) {
+    pageType = "search";
+    confidence += 0.2;
+  }
+  const ogType = metaTags?.["og:type"];
+  if (ogType) {
+    const normalized = normalizeString(ogType);
+    if (/^product$/i.test(normalized) && pageType !== "product") {
+      pageType = "product";
+      confidence += 0.15;
+    } else if (/^article|blog|news/i.test(normalized) && pageType !== "article") {
+      pageType = "article";
+      confidence += 0.15;
+    }
+  }
+  if (/\/checkout|\/cart|\/payment|\/billing/i.test(urlLower) && pageType === "unknown") {
+    pageType = "checkout";
+    confidence += 0.1;
+  } else if (/\/login|\/signin|\/auth/i.test(urlLower) && pageType === "unknown") {
+    pageType = "login";
+    confidence += 0.1;
+  } else if (/\/dashboard|\/account|\/profile/i.test(urlLower) && pageType === "unknown") {
+    pageType = "dashboard";
+    confidence += 0.1;
+  } else if (/\/search/i.test(urlLower) && pageType === "unknown") {
+    pageType = "search";
+    confidence += 0.1;
+  }
+  const hasFormWithSubmit = forms.some(
+    (f) => f.fields.some(
+      (el) => el.type === "submit" || normalizeString(el.inputType) === "submit" || normalizeString(el.name) === "submit"
+    )
+  );
+  const hasPriceSelectors = interactiveElements.some(
+    (el) => el.selector?.includes("price") || normalizeString(el.label).includes("price") || normalizeString(el.name).includes("price") || el.selector?.includes("cost") || el.selector?.includes("amount")
+  );
+  if (pageType === "unknown") {
+    if (hasFormWithSubmit && forms.length > 0) {
+      pageType = "form";
+      confidence += 0.1;
+    } else if (hasPriceSelectors) {
+      pageType = "product";
+      confidence += 0.1;
+    }
+  }
+  if ((pageType === "checkout" || pageType === "unknown") && forms.length > 0) {
+    if (hasFormWithSubmit) {
+      if (pageType === "unknown") {
+        pageType = "form";
+      }
+      confidence += 0.15;
+    }
+  }
+  if (pageType === "unknown") {
+    confidence = 0.5;
+  }
+  confidence = Math.min(0.95, confidence);
+  const primaryEntity = extractPrimaryEntity(pageType, structuredData);
+  const formFields = pageType === "form" || pageType === "checkout" || pageType === "login" ? mapFormFields(forms, interactiveElements) : void 0;
+  const actionButtons = mapActionButtons(interactiveElements);
+  return {
+    pageType,
+    primaryEntity,
+    formFields,
+    actionButtons,
+    confidence
+  };
+}
 const EMPTY_PAGE_CONTENT = {
   title: "",
   content: "",
@@ -4826,156 +5044,6 @@ const DIRECT_EXTRACTION_SCRIPT = String.raw`
     };
   })()
 `;
-const SAFE_EXTRACTION_SCRIPT = String.raw`
-  (function() {
-    function getCleanBodyText() {
-      var removed = [];
-      document
-        .querySelectorAll('.__vessel-highlight-label[data-vessel-highlight]')
-        .forEach(function(label) {
-          var parent = label.parentNode;
-          if (!parent) return;
-          removed.push({ label: label, parent: parent, nextSibling: label.nextSibling });
-          parent.removeChild(label);
-        });
-      try {
-        return document.body?.innerText || document.documentElement?.innerText || "";
-      } finally {
-        for (var i = removed.length - 1; i >= 0; i--) {
-          var entry = removed[i];
-          entry.parent.insertBefore(entry.label, entry.nextSibling);
-        }
-      }
-    }
-
-    function text(value) {
-      const trimmed = value == null ? "" : String(value).trim();
-      return trimmed || undefined;
-    }
-
-    function labelFor(el) {
-      const aria = text(el.getAttribute && el.getAttribute("aria-label"));
-      if (aria) return aria;
-      const placeholder = text(el.getAttribute && el.getAttribute("placeholder"));
-      if (placeholder) return placeholder;
-      if (el.id) {
-        const directLabel = document.querySelector('label[for="' + String(el.id).replace(/["\\]/g, "\\$&") + '"]');
-        const labelText = text(directLabel && directLabel.textContent);
-        if (labelText) return labelText;
-      }
-      return text(el.textContent);
-    }
-
-    let indexCounter = 0;
-    function nextIndex() {
-      indexCounter += 1;
-      return indexCounter;
-    }
-
-    const headings = Array.from(document.querySelectorAll("h1, h2, h3, h4, h5, h6"))
-      .map((el) => {
-        const headingText = text(el.textContent);
-        if (!headingText) return null;
-        return { level: Number.parseInt(el.tagName[1], 10), text: headingText };
-      })
-      .filter(Boolean);
-
-    const navigation = Array.from(document.querySelectorAll("nav a[href], [role='navigation'] a[href], header nav a[href]"))
-      .map((el) => {
-        const href = text(el.href || el.getAttribute("href"));
-        const linkText = text(el.textContent);
-        if (!href || href.startsWith("#") || !linkText) return null;
-        return {
-          type: "link",
-          text: linkText.slice(0, 100),
-          href: href.slice(0, 500),
-          context: "nav",
-          index: nextIndex(),
-          visible: true,
-          disabled: false,
-        };
-      })
-      .filter(Boolean);
-
-    const interactiveElements = [];
-    Array.from(document.querySelectorAll("button, [role='button'], input[type='submit'], input[type='button']"))
-      .forEach((el) => {
-        interactiveElements.push({
-          type: "button",
-          text: text(el.textContent || el.value || el.getAttribute("aria-label") || "Button")?.slice(0, 100),
-          index: nextIndex(),
-          visible: true,
-          disabled: !!(el.hasAttribute && (el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true")),
-        });
-      });
-
-    Array.from(document.querySelectorAll("a[href]")).forEach((el) => {
-      const href = text(el.href || el.getAttribute("href"));
-      const linkText = text(el.textContent);
-      if (!href || href.startsWith("#") || !linkText) return;
-      interactiveElements.push({
-        type: "link",
-        text: linkText.slice(0, 100),
-        href: href.slice(0, 500),
-        index: nextIndex(),
-        visible: true,
-        disabled: false,
-      });
-    });
-
-    Array.from(document.querySelectorAll("input:not([type='hidden']):not([type='submit']):not([type='button']), select, textarea"))
-      .forEach((el) => {
-        const tag = el.tagName.toLowerCase();
-        var elType = (el.type || "").toLowerCase();
-        interactiveElements.push({
-          type: tag === "select" ? "select" : tag === "textarea" ? "textarea" : "input",
-          label: labelFor(el)?.slice(0, 100),
-          inputType: text(el.getAttribute && el.getAttribute("type")),
-          placeholder: text(el.getAttribute && el.getAttribute("placeholder")),
-          value: shouldExposeFieldValue(el) ? text(el.value) : undefined,
-          options: tag === "select"
-            ? Array.from(el.options || []).map(function(option) { return { label: text(option.textContent || option.value) || option.value, value: option.value }; }).filter(function(o) { return o.label || o.value; }).slice(0, 25)
-            : undefined,
-          required: !!(el.hasAttribute && el.hasAttribute("required")) || undefined,
-          index: nextIndex(),
-          visible: true,
-          disabled: !!(el.hasAttribute && (el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true")),
-          name: el.name || undefined,
-          autocomplete: text(el.getAttribute && el.getAttribute("autocomplete")),
-          checked: (elType === "checkbox" || elType === "radio") ? !!el.checked : undefined,
-        });
-      });
-
-    const forms = Array.from(document.querySelectorAll("form")).map((form) => ({
-      id: text(form.id),
-      action: text(form.getAttribute("action")),
-      method: text(form.getAttribute("method")),
-      fields: [],
-    }));
-
-    return {
-      title: document.title || "",
-      content: getCleanBodyText(),
-      htmlContent: "",
-      byline: "",
-      excerpt: "",
-      url: window.location.href || "",
-      headings,
-      navigation,
-      interactiveElements,
-      forms,
-      viewport: {
-        width: window.innerWidth || document.documentElement?.clientWidth || 0,
-        height: window.innerHeight || document.documentElement?.clientHeight || 0,
-        scrollX: 0,
-        scrollY: 0,
-      },
-      overlays: [],
-      dormantOverlays: [],
-      landmarks: [],
-    };
-  })()
-`;
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -5012,7 +5080,7 @@ async function executeScript(webContents, script) {
   } catch {
     return null;
   } finally {
-    if (typeof timer !== "undefined" && timer) {
+    if (timer) {
       clearTimeout(timer);
     }
   }
@@ -5087,10 +5155,17 @@ function mergePageContent(candidates, webContents) {
     headings: mergedBase.headings,
     metaTags: mergedBase.metaTags
   });
+  const pageSchema = inferPageSchema({
+    ...mergedBase,
+    structuredData: normalizedStructuredData,
+    title: mergedBase.title || webContents.getTitle() || "",
+    url: mergedBase.url || webContents.getURL() || ""
+  });
   return {
     ...mergedBase,
     structuredData: normalizedStructuredData,
     pageIssues,
+    pageSchema,
     title: mergedBase.title || webContents.getTitle() || "",
     url: mergedBase.url || webContents.getURL() || ""
   };
@@ -5116,13 +5191,12 @@ async function estimateExtractionTimeout(webContents) {
 }
 async function extractContentInner(webContents) {
   await waitForDomReady(webContents);
-  const [preloadResult, directResult, safeResult] = await Promise.all([
+  const [preloadResult, directResult] = await Promise.all([
     executeScript(webContents, PRELOAD_EXTRACTION_SCRIPT),
-    executeScript(webContents, DIRECT_EXTRACTION_SCRIPT),
-    executeScript(webContents, SAFE_EXTRACTION_SCRIPT)
+    executeScript(webContents, DIRECT_EXTRACTION_SCRIPT)
   ]);
   return mergePageContent(
-    [preloadResult, directResult, safeResult],
+    [preloadResult, directResult],
     webContents
   );
 }
@@ -5179,7 +5253,8 @@ function normalizePageContent(value) {
     rdfa: Array.isArray(page.rdfa) ? page.rdfa : [],
     metaTags: page.metaTags && typeof page.metaTags === "object" && !Array.isArray(page.metaTags) ? page.metaTags : {},
     structuredData: Array.isArray(page.structuredData) ? page.structuredData : [],
-    pageIssues: Array.isArray(page.pageIssues) ? page.pageIssues : []
+    pageIssues: Array.isArray(page.pageIssues) ? page.pageIssues : [],
+    pageSchema: page.pageSchema
   };
 }
 const latestPageDiffs = /* @__PURE__ */ new Map();
@@ -5189,17 +5264,19 @@ const pendingPageSnapshotDueAt = /* @__PURE__ */ new Map();
 const lastMutationSnapshotAt = /* @__PURE__ */ new Map();
 const lastMutationActivityAt = /* @__PURE__ */ new Map();
 const destroyListenerAttached = /* @__PURE__ */ new WeakSet();
+function cleanupTimersForWcId(wcId) {
+  const timer = pendingPageSnapshotTimers.get(wcId);
+  if (timer) clearTimeout(timer);
+  pendingPageSnapshotTimers.delete(wcId);
+  pendingPageSnapshotDueAt.delete(wcId);
+  lastMutationSnapshotAt.delete(wcId);
+  lastMutationActivityAt.delete(wcId);
+}
 function attachDestroyCleanup(wc) {
   if (destroyListenerAttached.has(wc)) return;
   destroyListenerAttached.add(wc);
   wc.once("destroyed", () => {
-    const wcId = wc.id;
-    const timer = pendingPageSnapshotTimers.get(wcId);
-    if (timer) clearTimeout(timer);
-    pendingPageSnapshotTimers.delete(wcId);
-    pendingPageSnapshotDueAt.delete(wcId);
-    lastMutationSnapshotAt.delete(wcId);
-    lastMutationActivityAt.delete(wcId);
+    cleanupTimersForWcId(wc.id);
   });
 }
 const MIN_MUTATION_CAPTURE_INTERVAL_MS = 5e3;
@@ -5271,8 +5348,7 @@ function scheduleTimerAt(wc, sendToRendererViews, dueAt) {
   const existing = pendingPageSnapshotTimers.get(wcId);
   if (existing) clearTimeout(existing);
   const timer = setTimeout(() => {
-    pendingPageSnapshotTimers.delete(wcId);
-    pendingPageSnapshotDueAt.delete(wcId);
+    cleanupTimersForWcId(wcId);
     if (wc.isDestroyed()) return;
     lastMutationSnapshotAt.set(wcId, Date.now());
     void capturePageSnapshot(wc.getURL(), wc, sendToRendererViews);
@@ -5596,9 +5672,9 @@ function resizeSidebarViews(state2) {
   const contentWidth = width - sidebarWidth;
   sidebarView.setBounds({
     x: width - sidebarWidth - resizeHandleOverlap,
-    y: 0,
+    y: chromeHeight,
     width: sidebarWidth + resizeHandleOverlap,
-    height
+    height: height - chromeHeight
   });
   if (uiState.devtoolsPanelOpen) {
     devtoolsPanelView.setBounds({
@@ -9761,7 +9837,17 @@ const TOOL_DEFINITIONS = [
       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")
+      onDuplicate: zod.z.enum(["ask", "update", "duplicate"]).optional().describe("How to handle duplicate URLs in the same folder"),
+      intent: zod.z.string().optional().describe(
+        "Human-readable description of what this bookmark is for (e.g. 'expense reporting')"
+      ),
+      expectedContent: zod.z.string().optional().describe(
+        "Brief description of the content the agent should expect to find here"
+      ),
+      keyFields: zod.z.array(zod.z.string()).optional().describe(
+        "Important form field names for this page (e.g. ['receipt_id', 'date', 'amount'])"
+      ),
+      agentHints: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Arbitrary key-value hints for the agent")
     },
     tier: 1
   },
@@ -9780,7 +9866,11 @@ const TOOL_DEFINITIONS = [
       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')
+      archive: zod.z.boolean().optional().describe('If true, organize into the default "Archive" folder'),
+      intent: zod.z.string().optional().describe("Human-readable description of what this bookmark is for"),
+      expectedContent: zod.z.string().optional().describe("Brief description of content the agent should expect"),
+      keyFields: zod.z.array(zod.z.string()).optional().describe("Important form field names for this page"),
+      agentHints: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Arbitrary key-value hints for the agent")
     },
     tier: 2
   },
@@ -10352,7 +10442,9 @@ const FIELD_WEIGHTS = {
   note: 5,
   folder: 3,
   folderSummary: 2,
-  url: 1
+  url: 1,
+  intent: 4,
+  expectedContent: 3
 };
 function normalizeBookmarkSearchText(value) {
   let normalized = value.toLowerCase();
@@ -10383,7 +10475,9 @@ function getBookmarkSearchMatch(args) {
     url: args.url,
     note: args.note,
     folder: args.folder,
-    folderSummary: args.folderSummary
+    folderSummary: args.folderSummary,
+    intent: args.intent,
+    expectedContent: args.expectedContent
   };
   for (const field of Object.keys(values)) {
     if (!bookmarkFieldMatchesQuery(values[field], normalizedQuery, tokens)) {
@@ -10523,7 +10617,9 @@ function searchBookmarks(query) {
       url: bookmark.url,
       note: bookmark.note,
       folder: folder?.name,
-      folderSummary: folder?.summary
+      folderSummary: folder?.summary,
+      intent: bookmark.intent,
+      expectedContent: bookmark.expectedContent
     });
     return {
       bookmark,
@@ -10603,6 +10699,9 @@ function saveBookmarkWithPolicy(url, title, folderId, note, options) {
       if (note !== void 0) {
         bookmark2.note = note.trim() || void 0;
       }
+      if (options?.extra) {
+        Object.assign(bookmark2, options.extra);
+      }
       bookmark2.savedAt = (/* @__PURE__ */ new Date()).toISOString();
       save();
       emit();
@@ -10618,7 +10717,8 @@ function saveBookmarkWithPolicy(url, title, folderId, note, options) {
     title: normalizedTitle,
     note: note?.trim() || void 0,
     folderId: targetId,
-    savedAt: (/* @__PURE__ */ new Date()).toISOString()
+    savedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...options?.extra
   };
   state$1.bookmarks.push(bookmark);
   save();
@@ -10654,6 +10754,21 @@ function updateBookmark(id, updates) {
   if (typeof updates.folderId === "string") {
     bookmark.folderId = updates.folderId && updates.folderId !== UNSORTED_ID ? state$1.folders.find((item) => item.id === updates.folderId)?.id ?? UNSORTED_ID : UNSORTED_ID;
   }
+  if (typeof updates.intent === "string") {
+    bookmark.intent = updates.intent.trim() || void 0;
+  }
+  if (typeof updates.expectedContent === "string") {
+    bookmark.expectedContent = updates.expectedContent.trim() || void 0;
+  }
+  if (updates.keyFields !== void 0) {
+    bookmark.keyFields = updates.keyFields;
+  }
+  if (updates.pageSchema !== void 0) {
+    bookmark.pageSchema = updates.pageSchema;
+  }
+  if (updates.agentHints !== void 0) {
+    bookmark.agentHints = updates.agentHints;
+  }
   save();
   emit();
   return { ...bookmark };
@@ -15558,7 +15673,17 @@ ${truncated}`;
             source.title,
             target.folderId,
             note,
-            { onDuplicate }
+            {
+              onDuplicate,
+              extra: {
+                intent: typeof args.intent === "string" && args.intent.trim() ? args.intent.trim() : void 0,
+                expectedContent: typeof args.expectedContent === "string" && args.expectedContent.trim() ? args.expectedContent.trim() : void 0,
+                keyFields: Array.isArray(args.keyFields) ? args.keyFields.filter(
+                  (f) => typeof f === "string"
+                ) : void 0,
+                agentHints: args.agentHints && typeof args.agentHints === "object" ? args.agentHints : void 0
+              }
+            }
           );
           if (result2.status === "conflict" && result2.existing) {
             return composeFolderAwareResponse$1(
@@ -15597,7 +15722,13 @@ ${truncated}`;
             const updated = updateBookmark(existing.id, {
               folderId: target.folderId,
               title: typeof args.title === "string" && args.title.trim() ? args.title.trim() : void 0,
-              note
+              note,
+              intent: typeof args.intent === "string" && args.intent.trim() ? args.intent.trim() : void 0,
+              expectedContent: typeof args.expectedContent === "string" && args.expectedContent.trim() ? args.expectedContent.trim() : void 0,
+              keyFields: Array.isArray(args.keyFields) ? args.keyFields.filter(
+                (f) => typeof f === "string"
+              ) : void 0,
+              agentHints: args.agentHints && typeof args.agentHints === "object" ? args.agentHints : void 0
             });
             if (!updated) {
               return `Bookmark ${existing.id} not found`;
@@ -15608,12 +15739,25 @@ ${truncated}`;
             );
           }
           if ("error" in source) return `Error: ${source.error}`;
-          const bookmark = saveBookmark(
+          const result2 = saveBookmarkWithPolicy(
             source.url,
             source.title,
             target.folderId,
-            note
+            note,
+            {
+              onDuplicate: "update",
+              extra: {
+                intent: typeof args.intent === "string" && args.intent.trim() ? args.intent.trim() : void 0,
+                expectedContent: typeof args.expectedContent === "string" && args.expectedContent.trim() ? args.expectedContent.trim() : void 0,
+                keyFields: Array.isArray(args.keyFields) ? args.keyFields.filter(
+                  (f) => typeof f === "string"
+                ) : void 0,
+                agentHints: args.agentHints && typeof args.agentHints === "object" ? args.agentHints : void 0
+              }
+            }
           );
+          const bookmark = result2.bookmark;
+          if (!bookmark) return "Error: Bookmark save failed";
           return composeFolderAwareResponse$1(
             `Saved and organized "${bookmark.title}" (${bookmark.url}) into "${describeFolder$1(bookmark.folderId)}" (id=${bookmark.id})`,
             target.createdFolder
@@ -22798,7 +22942,7 @@ function registerWindowControlHandlers(mainWindow) {
   });
 }
 let activeChatProvider = null;
-const VALID_APPROVAL_MODES = /* @__PURE__ */ new Set(["auto", "confirm-dangerous", "manual"]);
+const VALID_APPROVAL_MODES = ["auto", "confirm-dangerous", "manual"];
 function registerIpcHandlers(windowState, runtime2) {
   const { tabManager, chromeView, sidebarView, devtoolsPanelView, mainWindow } = windowState;
   let sidebarResizeRecoveryTimer = null;
@@ -22807,10 +22951,9 @@ function registerIpcHandlers(windowState, runtime2) {
   let pendingRuntimeState = null;
   const premiumApiOrigin = process.env.VESSEL_PREMIUM_API ? new URL(process.env.VESSEL_PREMIUM_API).origin : "https://vesselpremium.quantaintellect.com";
   const clearSidebarResizeRecoveryTimer = () => {
-    if (sidebarResizeRecoveryTimer) {
-      clearTimeout(sidebarResizeRecoveryTimer);
-      sidebarResizeRecoveryTimer = null;
-    }
+    if (!sidebarResizeRecoveryTimer) return;
+    clearTimeout(sidebarResizeRecoveryTimer);
+    sidebarResizeRecoveryTimer = null;
   };
   const restoreSidebarLayoutAfterResize = () => {
     clearSidebarResizeRecoveryTimer();
@@ -23085,7 +23228,15 @@ function registerIpcHandlers(windowState, runtime2) {
     sidebarResizeActive = true;
     clearSidebarResizeRecoveryTimer();
     const [width, height] = windowState.mainWindow.getContentSize();
-    windowState.sidebarView.setBounds({ x: 0, y: 0, width, height });
+    const chromeHeight = windowState.uiState.focusMode ? 0 : 110;
+    const sidebarWidth = windowState.uiState.sidebarWidth;
+    const resizeHandleOverlap = 6;
+    windowState.sidebarView.setBounds({
+      x: width - sidebarWidth - resizeHandleOverlap,
+      y: chromeHeight,
+      width: sidebarWidth + resizeHandleOverlap,
+      height: height - chromeHeight
+    });
     scheduleSidebarResizeRecovery();
   });
   electron.ipcMain.handle(Channels.SIDEBAR_RESIZE, (_, width) => {
@@ -23093,7 +23244,6 @@ function registerIpcHandlers(windowState, runtime2) {
     const clamped = Math.max(240, Math.min(800, Math.round(width)));
     windowState.uiState.sidebarWidth = clamped;
     resizeSidebarViews(windowState);
-    scheduleSidebarResizeRecovery();
     return clamped;
   });
   electron.ipcMain.handle(Channels.SIDEBAR_RESIZE_COMMIT, () => {
@@ -23152,7 +23302,7 @@ function registerIpcHandlers(windowState, runtime2) {
     Channels.AGENT_SET_APPROVAL_MODE,
     (_, mode) => {
       assertString(mode, "mode");
-      if (!VALID_APPROVAL_MODES.has(mode)) {
+      if (!VALID_APPROVAL_MODES.includes(mode)) {
         throw new Error(`Invalid approval mode: ${mode}`);
       }
       trackApprovalModeChanged(mode);
@@ -23192,9 +23342,16 @@ function registerIpcHandlers(windowState, runtime2) {
   );
   electron.ipcMain.handle(
     Channels.BOOKMARK_SAVE,
-    (_, url, title, folderId, note) => {
+    (_, url, title, folderId, note, intent, expectedContent, keyFields, agentHints) => {
       trackBookmarkAction("save");
-      return saveBookmark(url, title, folderId, note);
+      return saveBookmarkWithPolicy(url, title, folderId, note, {
+        extra: {
+          intent: intent?.trim() || void 0,
+          expectedContent: expectedContent?.trim() || void 0,
+          keyFields,
+          agentHints
+        }
+      });
     }
   );
   electron.ipcMain.handle(Channels.BOOKMARK_REMOVE, (_, id) => {
@@ -23308,6 +23465,7 @@ function registerIpcHandlers(windowState, runtime2) {
       }
     }
     findWiredWcId = wc.id;
+    if (wc.isDestroyed()) return;
     const listener = (_event, result) => {
       if (!chromeView.webContents.isDestroyed()) {
         chromeView.webContents.send(Channels.FIND_IN_PAGE_RESULT, result);
@@ -23315,8 +23473,9 @@ function registerIpcHandlers(windowState, runtime2) {
     };
     findResultListener = listener;
     wc.on("found-in-page", listener);
+    const capturedWcId = wc.id;
     wc.once("destroyed", () => {
-      if (findWiredWcId === wc.id) {
+      if (findWiredWcId === capturedWcId) {
         findWiredWcId = null;
         findResultListener = null;
       }
@@ -23424,9 +23583,20 @@ function registerIpcHandlers(windowState, runtime2) {
     sendToRendererViews(Channels.PREMIUM_UPDATE, state2);
     return state2;
   });
+  const PREMIUM_TRACKABLE_STEPS = [
+    "chat_banner_viewed",
+    "chat_banner_clicked",
+    "settings_banner_viewed",
+    "settings_banner_clicked",
+    "welcome_banner_clicked",
+    "premium_gate_seen",
+    "premium_gate_clicked",
+    "iteration_limit_seen",
+    "iteration_limit_clicked"
+  ];
   electron.ipcMain.handle(Channels.PREMIUM_TRACK_CONTEXT, (_, step) => {
     assertString(step, "step");
-    if (step === "chat_banner_viewed" || step === "chat_banner_clicked" || step === "settings_banner_viewed" || step === "settings_banner_clicked" || step === "welcome_banner_clicked" || step === "premium_gate_seen" || step === "premium_gate_clicked" || step === "iteration_limit_seen" || step === "iteration_limit_clicked") {
+    if (PREMIUM_TRACKABLE_STEPS.includes(step)) {
       trackPremiumFunnel(step);
     }
   });

package/out/preload/index.js

@@ -259,7 +259,17 @@ const api = {
   },
   bookmarks: {
     get: () => electron.ipcRenderer.invoke(Channels.BOOKMARKS_GET),
-    saveBookmark: (url, title, folderId, note) => electron.ipcRenderer.invoke(Channels.BOOKMARK_SAVE, url, title, folderId, note),
+    saveBookmark: (url, title, folderId, note, intent, expectedContent, keyFields, agentHints) => electron.ipcRenderer.invoke(
+      Channels.BOOKMARK_SAVE,
+      url,
+      title,
+      folderId,
+      note,
+      intent,
+      expectedContent,
+      keyFields,
+      agentHints
+    ),
     removeBookmark: (id) => electron.ipcRenderer.invoke(Channels.BOOKMARK_REMOVE, id),
     createFolder: (name) => electron.ipcRenderer.invoke(Channels.FOLDER_CREATE, name),
     createFolderWithSummary: (name, summary) => electron.ipcRenderer.invoke(Channels.FOLDER_CREATE, name, summary),

package/out/renderer/assets/{index-NKk_lpQh.js → index-Di64dPm5.js}

@@ -1491,32 +1491,34 @@ const [activeTabId, setActiveTabId] = createSignal("");
 let initialized$4 = false;
 let initPromise$3 = null;
 let unsubscribeStateUpdate = null;
+async function doInit() {
+  try {
+    if (unsubscribeStateUpdate) {
+      unsubscribeStateUpdate();
+      unsubscribeStateUpdate = null;
+    }
+    unsubscribeStateUpdate = window.vessel.tabs.onStateUpdate(
+      (newTabs, newActiveId) => {
+        setTabs(newTabs);
+        setActiveTabId(newActiveId);
+      }
+    );
+    const initialState = await window.vessel.tabs.getState();
+    setTabs(initialState.tabs);
+    setActiveTabId(initialState.activeId);
+  } catch (error) {
+    initialized$4 = false;
+    console.error("Failed to initialize tabs store", error);
+    throw error;
+  }
+}
 function init$4() {
   if (initPromise$3) return initPromise$3;
   if (initialized$4) return;
   initialized$4 = true;
-  initPromise$3 = (async () => {
-    try {
-      if (unsubscribeStateUpdate) {
-        unsubscribeStateUpdate();
-        unsubscribeStateUpdate = null;
-      }
-      unsubscribeStateUpdate = window.vessel.tabs.onStateUpdate(
-        (newTabs, newActiveId) => {
-          setTabs(newTabs);
-          setActiveTabId(newActiveId);
-        }
-      );
-      const initialState = await window.vessel.tabs.getState();
-      setTabs(initialState.tabs);
-      setActiveTabId(initialState.activeId);
-    } catch (error) {
-      initialized$4 = false;
-      console.error("Failed to initialize tabs store", error);
-    } finally {
-      initPromise$3 = null;
-    }
-  })();
+  initPromise$3 = doInit().finally(() => {
+    initPromise$3 = null;
+  });
   return initPromise$3;
 }
 const patchTab = (id, patch) => {
@@ -1867,29 +1869,8 @@ const [focusMode, setFocusMode] = createSignal(false);
 const [commandBarOpen, setCommandBarOpen] = createSignal(false);
 const [settingsOpen, setSettingsOpen] = createSignal(false);
 const [devtoolsPanelOpen, setDevtoolsPanelOpen] = createSignal(false);
-let pendingWidth = null;
-let resizeInFlight = null;
-async function flushResize() {
-  if (resizeInFlight) {
-    await resizeInFlight;
-    if (pendingWidth !== null) {
-      return flushResize();
-    }
-    return;
-  }
-  resizeInFlight = (async () => {
-    while (pendingWidth !== null) {
-      const nextWidth = pendingWidth;
-      pendingWidth = null;
-      await window.vessel.ui.resizeSidebar(nextWidth);
-    }
-  })();
-  try {
-    await resizeInFlight;
-  } finally {
-    resizeInFlight = null;
-  }
-}
+let lastIpcTime = 0;
+const IPC_THROTTLE_MS = 8;
 function useUI() {
   return {
     sidebarOpen,
@@ -1909,12 +1890,13 @@ function useUI() {
         Math.min(MAX_SIDEBAR, Math.round(width))
       );
       setSidebarWidth(clamped);
-      pendingWidth = clamped;
-      void flushResize();
+      const now2 = performance.now();
+      if (now2 - lastIpcTime >= IPC_THROTTLE_MS) {
+        lastIpcTime = now2;
+        void window.vessel.ui.resizeSidebar(clamped);
+      }
     },
     commitResize: async () => {
-      pendingWidth = sidebarWidth();
-      await flushResize();
       await window.vessel.ui.commitSidebarResize();
     },
     toggleFocusMode: async () => {
@@ -3533,7 +3515,16 @@ function useBookmarks() {
   void init();
   return {
     bookmarksState,
-    saveBookmark: (url, title, folderId, note) => window.vessel.bookmarks.saveBookmark(url, title, folderId, note),
+    saveBookmark: (url, title, folderId, note, intent, expectedContent, keyFields, agentHints) => window.vessel.bookmarks.saveBookmark(
+      url,
+      title,
+      folderId,
+      note,
+      intent,
+      expectedContent,
+      keyFields,
+      agentHints
+    ),
     removeBookmark: (id) => window.vessel.bookmarks.removeBookmark(id),
     createFolder: (name) => window.vessel.bookmarks.createFolder(name),
     createFolderWithSummary: (name, summary) => window.vessel.bookmarks.createFolderWithSummary(name, summary),
@@ -4981,7 +4972,9 @@ const FIELD_WEIGHTS = {
   note: 5,
   folder: 3,
   folderSummary: 2,
-  url: 1
+  url: 1,
+  intent: 4,
+  expectedContent: 3
 };
 function normalizeBookmarkSearchText(value) {
   let normalized = value.toLowerCase();
@@ -5012,7 +5005,9 @@ function getBookmarkSearchMatch(args) {
     url: args.url,
     note: args.note,
     folder: args.folder,
-    folderSummary: args.folderSummary
+    folderSummary: args.folderSummary,
+    intent: args.intent,
+    expectedContent: args.expectedContent
   };
   for (const field of Object.keys(values)) {
     if (!bookmarkFieldMatchesQuery(values[field], normalizedQuery, tokens)) {
@@ -6671,6 +6666,18 @@ ${contextBlock}` : contextBlock);
     const startX = e.screenX;
     const startWidth = sidebarWidth2();
     let finished = false;
+    const state = {
+      currentX: startX,
+      rafId: null
+    };
+    const flushResizeUpdate = () => {
+      state.rafId = null;
+      if (finished) return;
+      const totalDelta = startX - state.currentX;
+      const targetWidth = startWidth + totalDelta;
+      const newWidth = Math.max(240, Math.min(800, Math.round(targetWidth)));
+      resizeSidebar(newWidth);
+    };
     const clearPointerTracking = () => {
       window.removeEventListener("pointermove", onPointerMove);
       window.removeEventListener("pointerup", onPointerUp);
@@ -6681,14 +6688,25 @@ ${contextBlock}` : contextBlock);
       if (target.hasPointerCapture?.(e.pointerId)) {
         target.releasePointerCapture(e.pointerId);
       }
+      if (state.rafId !== null) {
+        cancelAnimationFrame(state.rafId);
+        state.rafId = null;
+      }
     };
     const onPointerMove = (ev) => {
-      const delta = startX - ev.screenX;
-      resizeSidebar(startWidth + delta);
+      state.currentX = ev.screenX;
+      if (state.rafId === null) {
+        state.rafId = requestAnimationFrame(flushResizeUpdate);
+      }
     };
     const finishResize = () => {
       if (finished) return;
       finished = true;
+      if (state.rafId !== null) {
+        cancelAnimationFrame(state.rafId);
+        state.rafId = null;
+      }
+      flushResizeUpdate();
       setIsDragging(false);
       clearPointerTracking();
       document.body.style.cursor = "";
@@ -10166,17 +10184,19 @@ const App = () => {
       });
     }
   };
-  const applyTheme = async () => {
-    const s = await window.vessel.settings.get();
-    const theme = s.theme ?? "dark";
+  const applyTheme = (theme) => {
     document.documentElement.setAttribute("data-theme", theme);
     try {
       localStorage.setItem("vessel:theme", theme);
     } catch {
     }
   };
+  const loadAndApplyTheme = async () => {
+    const s = await window.vessel.settings.get();
+    applyTheme(s.theme ?? "dark");
+  };
   onMount(() => {
-    void applyTheme();
+    void loadAndApplyTheme();
     window.vessel.ui.rendererReady(view);
     if (view !== "chrome") return;
     const cleanupKeys = setupKeybindings({
@@ -10196,8 +10216,8 @@ const App = () => {
       toggleKeyboardHelp: () => setKeyboardHelpOpen((v) => !v)
     });
     const cleanupCapture = window.vessel.highlights.onCaptureResult(showHighlightResult);
-    const cleanupSettings = window.vessel.settings.onUpdate(() => {
-      void applyTheme();
+    const cleanupSettings = window.vessel.settings.onUpdate((settings) => {
+      applyTheme(settings.theme ?? "dark");
     });
     onCleanup(() => {
       cleanupKeys();

package/out/renderer/index.html

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self'; font-src 'self' data:;" />
     <title>Vessel</title>
-    <script type="module" crossorigin src="./assets/index-NKk_lpQh.js"></script>
+    <script type="module" crossorigin src="./assets/index-Di64dPm5.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-CBe7EN_l.css">
   </head>
   <body>

package/package.json

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