@quanta-intellect/vessel-browser 0.1.58 → 0.1.61

package/out/main/index.js

@@ -2683,6 +2683,8 @@ const Channels = {
   DEVTOOLS_PANEL_TOGGLE: "devtools-panel:toggle",
   DEVTOOLS_PANEL_STATE: "devtools-panel:state",
   DEVTOOLS_PANEL_RESIZE: "devtools-panel:resize",
+  // Ad blocking
+  TAB_TOGGLE_AD_BLOCK: "tab:toggle-ad-block",
   // Find in page
   FIND_IN_PAGE_START: "find:start",
   FIND_IN_PAGE_NEXT: "find:next",
@@ -2706,6 +2708,11 @@ const Channels = {
   PREMIUM_RESET: "premium:reset",
   PREMIUM_TRACK_CONTEXT: "premium:track-context",
   PREMIUM_UPDATE: "premium:update",
+  // Named sessions
+  SESSION_LIST: "session:list",
+  SESSION_SAVE: "session:save",
+  SESSION_LOAD: "session:load",
+  SESSION_DELETE: "session:delete",
   // Agent Credential Vault
   VAULT_LIST: "vault:list",
   VAULT_ADD: "vault:add",
@@ -2740,6 +2747,7 @@ const Channels = {
 };
 const MAX_DETAIL_ITEMS = 3;
 const MIN_BLOCK_SIMILARITY = 0.82;
+const MAX_DIFF_BLOCKS = 500;
 function normalizeText$2(value) {
   return value.replace(/\s+/g, " ").trim();
 }
@@ -2856,8 +2864,10 @@ function diffSnapshots(oldSnap, currentContent, currentTitle, currentHeadings) {
   const oldHeadings = oldSnap.headings.split("\n").filter(Boolean);
   const newHeadings = currentHeadings.split("\n").filter(Boolean);
   if (oldHeadings.join("\n") !== newHeadings.join("\n")) {
-    const added = newHeadings.filter((h) => !oldHeadings.includes(h));
-    const removed = oldHeadings.filter((h) => !newHeadings.includes(h));
+    const oldSet = new Set(oldHeadings);
+    const newSet = new Set(newHeadings);
+    const added = newHeadings.filter((h) => !oldSet.has(h));
+    const removed = oldHeadings.filter((h) => !newSet.has(h));
     const parts = [];
     if (added.length > 0) parts.push(`New: ${added.join(", ")}`);
     if (removed.length > 0) parts.push(`Gone: ${removed.join(", ")}`);
@@ -2871,8 +2881,10 @@ function diffSnapshots(oldSnap, currentContent, currentTitle, currentHeadings) {
       });
     }
   }
-  const oldBlocks = extractTextBlocks(oldSnap.textContent);
-  const newBlocks = extractTextBlocks(currentContent);
+  const rawOldBlocks = extractTextBlocks(oldSnap.textContent);
+  const rawNewBlocks = extractTextBlocks(currentContent);
+  const oldBlocks = rawOldBlocks.slice(0, MAX_DIFF_BLOCKS);
+  const newBlocks = rawNewBlocks.slice(0, MAX_DIFF_BLOCKS);
   const overallSimilarity = similarityScore(oldSnap.textContent, currentContent);
   if (overallSimilarity < 0.98) {
     const ops = diffBlocks(oldBlocks, newBlocks);
@@ -3754,7 +3766,7 @@ async function getCheckoutUrl(email) {
 async function getPortalUrl() {
   return {
     ok: false,
-    error: "Billing portal access is temporarily disabled while we harden the premium API. Use the Stripe billing link from your subscription email for now."
+    error: "Billing portal access is temporarily disabled until authenticated customer access is implemented."
   };
 }
 async function verifySubscription(identifier) {
@@ -3891,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";
@@ -3999,8 +4009,8 @@ function stopTelemetry() {
   }
   if (flushTimer) {
     clearInterval(flushTimer);
-    flushTimer = null;
   }
+  flushTimer = null;
   void flush();
 }
 async function flush() {
@@ -4101,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: "",
@@ -4814,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));
 }
@@ -5000,7 +5080,7 @@ async function executeScript(webContents, script) {
   } catch {
     return null;
   } finally {
-    if (typeof timer !== "undefined" && timer) {
+    if (timer) {
       clearTimeout(timer);
     }
   }
@@ -5075,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() || ""
   };
@@ -5104,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
   );
 }
@@ -5167,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();
@@ -5176,6 +5263,22 @@ const pendingPageSnapshotTimers = /* @__PURE__ */ new Map();
 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", () => {
+    cleanupTimersForWcId(wc.id);
+  });
+}
 const MIN_MUTATION_CAPTURE_INTERVAL_MS = 5e3;
 const SETTLE_AFTER_ACTIVITY_MS = 1500;
 function getLatestPageDiff(rawUrl) {
@@ -5222,6 +5325,7 @@ async function capturePageSnapshot(url, wc, sendToRendererViews) {
         sendToRendererViews(Channels.PAGE_CHANGED, enrichedDiff);
       } else {
         latestPageDiffs.delete(key);
+        recentPageDiffBursts.delete(key);
       }
     } else {
       latestPageDiffs.delete(key);
@@ -5239,12 +5343,12 @@ function computeNextSnapshotDueAt(wcId, now, delayMs) {
   return Math.max(now + delayMs, earliestAllowedAt, stableAfterActivityAt);
 }
 function scheduleTimerAt(wc, sendToRendererViews, dueAt) {
+  attachDestroyCleanup(wc);
   const wcId = wc.id;
   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);
@@ -5568,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({
@@ -9733,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
   },
@@ -9752,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
   },
@@ -10324,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();
@@ -10355,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)) {
@@ -10495,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,
@@ -10575,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();
@@ -10590,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();
@@ -10626,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 };
@@ -15530,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(
@@ -15569,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`;
@@ -15580,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
@@ -22770,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;
@@ -22779,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();
@@ -22820,6 +22991,13 @@ function registerIpcHandlers(windowState, runtime2) {
       flushRuntimeUpdate();
     }, 32);
   };
+  electron.app.on("before-quit", () => {
+    if (runtimeUpdateTimer) {
+      clearTimeout(runtimeUpdateTimer);
+      runtimeUpdateTimer = null;
+    }
+    flushRuntimeUpdate();
+  });
   const sendToRendererViews = (channel, ...args) => {
     chromeView.webContents.send(channel, ...args);
     sidebarView.webContents.send(channel, ...args);
@@ -22944,6 +23122,14 @@ function registerIpcHandlers(windowState, runtime2) {
   electron.ipcMain.handle(Channels.TAB_RELOAD, (_, id) => {
     tabManager.reloadTab(id);
   });
+  electron.ipcMain.handle(Channels.TAB_TOGGLE_AD_BLOCK, (_, id) => {
+    assertString(id, "id");
+    const tab = tabManager.getTab(id);
+    if (!tab) return null;
+    const newState = !tab.state.adBlockingEnabled;
+    tab.setAdBlockingEnabled(newState);
+    return newState;
+  });
   electron.ipcMain.handle(Channels.TAB_STATE_GET, () => ({
     tabs: tabManager.getAllStates(),
     activeId: tabManager.getActiveTabId() || ""
@@ -23042,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) => {
@@ -23050,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, () => {
@@ -23109,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);
@@ -23149,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) => {
@@ -23254,17 +23454,31 @@ function registerIpcHandlers(windowState, runtime2) {
     }
   });
   let findWiredWcId = null;
+  let findResultListener = null;
   function wireFindEvents(wc) {
     if (findWiredWcId === wc.id) return;
-    if (findWiredWcId !== null) {
+    if (findWiredWcId !== null && findResultListener) {
       const prev = tabManager.findTabByWebContentsId(findWiredWcId);
-      if (prev) prev.view.webContents.removeAllListeners("found-in-page");
+      const prevWc = prev?.view.webContents;
+      if (prevWc && !prevWc.isDestroyed()) {
+        prevWc.removeListener("found-in-page", findResultListener);
+      }
     }
     findWiredWcId = wc.id;
-    wc.on("found-in-page", (_event, result) => {
+    if (wc.isDestroyed()) return;
+    const listener = (_event, result) => {
       if (!chromeView.webContents.isDestroyed()) {
         chromeView.webContents.send(Channels.FIND_IN_PAGE_RESULT, result);
       }
+    };
+    findResultListener = listener;
+    wc.on("found-in-page", listener);
+    const capturedWcId = wc.id;
+    wc.once("destroyed", () => {
+      if (findWiredWcId === capturedWcId) {
+        findWiredWcId = null;
+        findResultListener = null;
+      }
     });
   }
   electron.ipcMain.handle(Channels.FIND_IN_PAGE_START, (_, text, options) => {
@@ -23283,6 +23497,7 @@ function registerIpcHandlers(windowState, runtime2) {
     if (!tab) return null;
     const wc = tab.view.webContents;
     if (wc.isDestroyed()) return null;
+    wireFindEvents(wc);
     return wc.findInPage("", { forward: forward ?? true, findNext: true });
   });
   electron.ipcMain.handle(Channels.FIND_IN_PAGE_STOP, (_, action) => {
@@ -23368,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);
     }
   });
@@ -23382,6 +23608,21 @@ function registerIpcHandlers(windowState, runtime2) {
     }
     return result;
   });
+  electron.ipcMain.handle(Channels.SESSION_LIST, () => {
+    return listNamedSessions();
+  });
+  electron.ipcMain.handle(Channels.SESSION_SAVE, async (_, name) => {
+    assertString(name, "name");
+    return await saveNamedSession(tabManager, name);
+  });
+  electron.ipcMain.handle(Channels.SESSION_LOAD, async (_, name) => {
+    assertString(name, "name");
+    return await loadNamedSession(tabManager, name);
+  });
+  electron.ipcMain.handle(Channels.SESSION_DELETE, (_, name) => {
+    assertString(name, "name");
+    return deleteNamedSession(name);
+  });
   registerVaultHandlers();
   registerWindowControlHandlers(mainWindow);
   electron.ipcMain.handle(Channels.AUTOMATION_GET_INSTALLED, () => {