@quanta-intellect/vessel-browser 0.1.60 → 0.1.63

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";
@@ -3940,6 +3938,7 @@ let flushTimer = null;
 let sessionStartedAt = null;
 function isEnabled() {
   if (POSTHOG_API_KEY === "YOUR_POSTHOG_KEY_HERE") return false;
+  if (process.env.VESSEL_DEV === "1") return false;
   return loadSettings().telemetryEnabled !== false;
 }
 function trackEvent(event, properties = {}) {
@@ -4011,8 +4010,8 @@ function stopTelemetry() {
   }
   if (flushTimer) {
     clearInterval(flushTimer);
-    flushTimer = null;
   }
+  flushTimer = null;
   void flush();
 }
 async function flush() {
@@ -4113,6 +4112,270 @@ 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 asStructuredObject(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function stringifyStructuredScalar(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed || void 0;
+  }
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return String(value);
+  }
+  return void 0;
+}
+function firstStructuredString(...values) {
+  for (const value of values) {
+    const normalized = stringifyStructuredScalar(value);
+    if (normalized) return normalized;
+  }
+  return void 0;
+}
+function getOfferPrice(offers) {
+  if (Array.isArray(offers)) {
+    for (const offer2 of offers) {
+      const price = getOfferPrice(offer2);
+      if (price) return price;
+    }
+    return void 0;
+  }
+  const offer = asStructuredObject(offers);
+  return firstStructuredString(offer?.price);
+}
+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 ?? {};
+      const aggregateRating = asStructuredObject(attrs.aggregateRating);
+      return {
+        type: "Product",
+        nameField: firstStructuredString(attrs.name),
+        priceField: firstStructuredString(attrs.price) ?? getOfferPrice(attrs.offers),
+        imageField: firstStructuredString(
+          attrs.image,
+          Array.isArray(attrs.image) ? attrs.image[0] : void 0
+        ),
+        descriptionField: firstStructuredString(attrs.description),
+        reviewsField: firstStructuredString(
+          attrs.reviews,
+          attrs.reviewCount,
+          aggregateRating?.reviewCount,
+          aggregateRating?.ratingCount
+        ),
+        ratingField: firstStructuredString(
+          attrs.rating,
+          attrs.ratingValue,
+          aggregateRating?.ratingValue
+        ),
+        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 +5089,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 +5125,7 @@ async function executeScript(webContents, script) {
   } catch {
     return null;
   } finally {
-    if (typeof timer !== "undefined" && timer) {
+    if (timer) {
       clearTimeout(timer);
     }
   }
@@ -5087,10 +5200,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 +5236,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 +5298,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 +5309,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 +5393,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 +5717,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 +9882,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 +9911,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 +10487,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 +10520,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 +10662,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 +10744,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 +10762,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 +10799,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 };
@@ -11634,6 +11794,33 @@ function formatCompactToolResult(name, result) {
       return limitText(result, 18, 1400);
   }
 }
+function normalizeOptionalString(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed || void 0;
+}
+function normalizeKeyFields(value) {
+  if (!Array.isArray(value)) return void 0;
+  const normalized = value.filter((field) => typeof field === "string").map((field) => field.trim()).filter(Boolean);
+  return normalized.length > 0 ? normalized : void 0;
+}
+function normalizeAgentHints(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  const normalized = Object.fromEntries(
+    Object.entries(value).map(([key, hint]) => [key.trim(), normalizeOptionalString(hint)]).filter((entry) => Boolean(entry[0] && entry[1]))
+  );
+  return Object.keys(normalized).length > 0 ? normalized : void 0;
+}
+function normalizeBookmarkMetadata(input) {
+  return {
+    intent: normalizeOptionalString(input.intent),
+    expectedContent: normalizeOptionalString(input.expectedContent),
+    keyFields: normalizeKeyFields(input.keyFields),
+    agentHints: normalizeAgentHints(input.agentHints)
+  };
+}
 const HUGGING_FACE_HUB_HOSTS = /* @__PURE__ */ new Set(["huggingface.co", "www.huggingface.co"]);
 const HUGGING_FACE_MODEL_TASKS = [
   {
@@ -11894,6 +12081,14 @@ function buildHuggingFaceSearchShortcut(currentUrl, rawQuery) {
     appliedFilters
   };
 }
+function getBookmarkMetadataFromArgs(args) {
+  return normalizeBookmarkMetadata({
+    intent: args.intent,
+    expectedContent: args.expectedContent,
+    keyFields: args.keyFields,
+    agentHints: args.agentHints
+  });
+}
 const DEFAULT_PAGE_SCRIPT_TIMEOUT_MS = 1500;
 const PAGE_SCRIPT_TIMEOUT = /* @__PURE__ */ Symbol("page-script-timeout");
 async function loadPermittedUrl$1(wc, url) {
@@ -15558,7 +15753,10 @@ ${truncated}`;
             source.title,
             target.folderId,
             note,
-            { onDuplicate }
+            {
+              onDuplicate,
+              extra: getBookmarkMetadataFromArgs(args)
+            }
           );
           if (result2.status === "conflict" && result2.existing) {
             return composeFolderAwareResponse$1(
@@ -15597,7 +15795,8 @@ ${truncated}`;
             const updated = updateBookmark(existing.id, {
               folderId: target.folderId,
               title: typeof args.title === "string" && args.title.trim() ? args.title.trim() : void 0,
-              note
+              note,
+              ...getBookmarkMetadataFromArgs(args)
             });
             if (!updated) {
               return `Bookmark ${existing.id} not found`;
@@ -15608,12 +15807,18 @@ ${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: getBookmarkMetadataFromArgs(args)
+            }
           );
+          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
@@ -17310,6 +17515,14 @@ function readAuditLog(limit = 100) {
 }
 let httpServer = null;
 let mcpAuthToken = null;
+function getBookmarkMetadataFromToolArgs(args) {
+  return normalizeBookmarkMetadata({
+    intent: args.intent,
+    expectedContent: args.expected_content,
+    keyFields: args.key_fields,
+    agentHints: args.agent_hints
+  });
+}
 const MCP_AUTH_FILENAME = "mcp-auth.json";
 function getMcpAuthFilePath() {
   const configDir = process.env.VESSEL_CONFIG_DIR || path$1.join(
@@ -20137,7 +20350,15 @@ ${JSON.stringify(otherHighlights, null, 2)}`
         note: zod.z.string().optional().describe("Optional note about why this was bookmarked"),
         on_duplicate: zod.z.enum(["ask", "update", "duplicate"]).optional().describe(
           'How to handle an existing bookmark with the same URL in the same folder: "ask" (default), "update", or "duplicate"'
-        )
+        ),
+        intent: zod.z.string().optional().describe(
+          "Human-readable description of what this bookmark is for"
+        ),
+        expected_content: zod.z.string().optional().describe(
+          "Brief description of the content the agent should expect to find here"
+        ),
+        key_fields: zod.z.array(zod.z.string()).optional().describe("Important form field names for this page"),
+        agent_hints: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Arbitrary key-value hints for the agent")
       }
     },
     async ({
@@ -20150,7 +20371,11 @@ ${JSON.stringify(otherHighlights, null, 2)}`
       folder_summary,
       create_folder_if_missing,
       note,
-      on_duplicate
+      on_duplicate,
+      intent,
+      expected_content,
+      key_fields,
+      agent_hints
     }) => {
       return withAction(
         runtime2,
@@ -20165,7 +20390,11 @@ ${JSON.stringify(otherHighlights, null, 2)}`
           folder_name,
           folder_summary,
           create_folder_if_missing,
-          note
+          note,
+          intent,
+          expected_content,
+          key_fields,
+          agent_hints
         },
         async () => {
           const currentTab = tabManager.getActiveTab();
@@ -20195,7 +20424,15 @@ ${JSON.stringify(otherHighlights, null, 2)}`
             source.title,
             target.folderId,
             note,
-            { onDuplicate: on_duplicate ?? "ask" }
+            {
+              onDuplicate: on_duplicate ?? "ask",
+              extra: getBookmarkMetadataFromToolArgs({
+                intent,
+                expected_content,
+                key_fields,
+                agent_hints
+              })
+            }
           );
           if (result.status === "conflict" && result.existing) {
             return composeFolderAwareResponse(
@@ -20292,7 +20529,11 @@ ${JSON.stringify(otherHighlights, null, 2)}`
         folder_summary: zod.z.string().optional().describe("Optional summary used if a new folder is created"),
         create_folder_if_missing: zod.z.boolean().optional().describe("Create folder_name automatically when it does not exist"),
         note: zod.z.string().optional().describe("Optional note to attach or update on the bookmark"),
-        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"),
+        expected_content: zod.z.string().optional().describe("Brief description of content the agent should expect"),
+        key_fields: zod.z.array(zod.z.string()).optional().describe("Important form field names for this page"),
+        agent_hints: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Arbitrary key-value hints for the agent")
       }
     },
     async (args) => {
@@ -20328,7 +20569,8 @@ ${JSON.stringify(otherHighlights, null, 2)}`
             const updated = updateBookmark(existing.id, {
               folderId: target.folderId,
               title: typeof args.title === "string" && args.title.trim() ? args.title.trim() : void 0,
-              note
+              note,
+              ...getBookmarkMetadataFromToolArgs(args)
             });
             if (!updated) {
               return `Bookmark ${existing.id} not found`;
@@ -20339,12 +20581,18 @@ ${JSON.stringify(otherHighlights, null, 2)}`
             );
           }
           if ("error" in source) return `Error: ${source.error}`;
-          const bookmark = saveBookmark(
+          const result = saveBookmarkWithPolicy(
             source.url,
             source.title,
             target.folderId,
-            note
+            note,
+            {
+              onDuplicate: "update",
+              extra: getBookmarkMetadataFromToolArgs(args)
+            }
           );
+          const bookmark = result.bookmark;
+          if (!bookmark) return "Error: Bookmark save failed";
           return composeFolderAwareResponse(
             `Saved and organized "${bookmark.title}" (${bookmark.url}) into "${describeFolder(bookmark.folderId)}" (id=${bookmark.id})`,
             target.createdFolder
@@ -22798,7 +23046,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 +23055,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 +23332,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 +23348,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 +23406,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 +23446,23 @@ 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);
+      const result = saveBookmarkWithPolicy(url, title, folderId, note, {
+        onDuplicate: "update",
+        extra: {
+          ...normalizeBookmarkMetadata({
+            intent,
+            expectedContent,
+            keyFields,
+            agentHints
+          })
+        }
+      });
+      if (!result.bookmark) {
+        throw new Error("Bookmark save failed");
+      }
+      return result.bookmark;
     }
   );
   electron.ipcMain.handle(Channels.BOOKMARK_REMOVE, (_, id) => {
@@ -23308,6 +23576,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 +23584,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 +23694,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);
     }
   });