@quanta-intellect/vessel-browser 0.1.148 → 0.1.153

package/out/main/index.js

@@ -11482,9 +11482,7 @@ async function fetchCodexBackendModelsWithRefresh(tokens) {
     return await fetchCodexBackendModels(freshTokens);
   } catch (err) {
     if (err instanceof CodexBackendModelDiscoveryError && err.status === 401) {
-      return fetchCodexBackendModels(
-        await refreshCodexTokensForDiscovery(freshTokens)
-      );
+      return fetchCodexBackendModels(await refreshCodexTokensForDiscovery(freshTokens));
     }
     throw err;
   }
@@ -11511,38 +11509,65 @@ async function fetchProviderModels(config) {
   if (error) {
     throw new Error(error);
   }
-  if (normalized.id === "anthropic") {
-    const client2 = new Anthropic({ apiKey: normalized.apiKey });
-    const page2 = await client2.models.list();
-    return okResult({ models: page2.data.map((model) => model.id) });
+  const handler = PROVIDER_HANDLERS.get(normalized.id) ?? openAICompatHandler;
+  return handler.listModels(normalized);
+}
+function createProvider(config) {
+  const normalized = sanitizeProviderConfig(config);
+  const error = validateProviderConfig(normalized);
+  if (error) {
+    throw new Error(error);
   }
-  if (normalized.id === "openai_codex") {
-    const tokens = readStoredCodexTokens();
-    if (!tokens) {
-      throw new Error("Codex provider requires authentication. Connect your ChatGPT account in settings.");
-    }
-    try {
-      const models2 = await fetchCodexBackendModelsWithRefresh(tokens);
-      if (models2.length > 0) {
-        return okResult({ models: models2 });
-      }
-      throw new Error("Codex backend model discovery returned no models");
-    } catch (err) {
-      return okResult({
-        models: PROVIDERS.openai_codex.models,
-        warning: `Using built-in Codex model list because live discovery failed: ${err instanceof Error ? err.message : "Unknown error"}`
-      });
+  const handler = PROVIDER_HANDLERS.get(normalized.id) ?? openAICompatHandler;
+  return handler.create(normalized);
+}
+async function listAnthropicModels(config) {
+  const client = new Anthropic({ apiKey: config.apiKey });
+  const page = await client.models.list();
+  return okResult({ models: page.data.map((model) => model.id) });
+}
+function createAnthropicProvider(config) {
+  return new AnthropicProvider(config.apiKey, config.model, config.reasoningEffort ?? "off");
+}
+async function listCodexModels(_config) {
+  const tokens = readStoredCodexTokens();
+  if (!tokens) {
+    throw new Error(
+      "Codex provider requires authentication. Connect your ChatGPT account in settings."
+    );
+  }
+  try {
+    const models = await fetchCodexBackendModelsWithRefresh(tokens);
+    if (models.length > 0) {
+      return okResult({ models });
     }
+    throw new Error("Codex backend model discovery returned no models");
+  } catch (err) {
+    return okResult({
+      models: PROVIDERS.openai_codex.models,
+      warning: `Using built-in Codex model list because live discovery failed: ${err instanceof Error ? err.message : "Unknown error"}`
+    });
   }
-  const meta = PROVIDERS[normalized.id];
-  const baseURL = normalized.baseUrl || meta?.defaultBaseUrl || "https://api.openai.com/v1";
+}
+function createCodexProvider(config) {
+  const tokens = readStoredCodexTokens();
+  if (!tokens) {
+    throw new Error(
+      "OpenAI Codex requires authentication. Open settings to connect your ChatGPT account."
+    );
+  }
+  return new CodexProvider(tokens, config.model);
+}
+async function listOpenAICompatModels(config) {
+  const meta = PROVIDERS[config.id];
+  const baseURL = config.baseUrl || meta?.defaultBaseUrl || "https://api.openai.com/v1";
   const client = new OpenAI({
-    apiKey: normalized.apiKey || "ollama",
+    apiKey: config.apiKey || "ollama",
     baseURL
   });
   const page = await client.models.list();
   const models = page.data.map((model) => model.id);
-  const warning = normalized.id === "llama_cpp" ? await probeLlamaCppCtxWarning(baseURL) : void 0;
+  const warning = config.id === "llama_cpp" ? await probeLlamaCppCtxWarning(baseURL) : void 0;
   return {
     ...okResult({
       models,
@@ -11550,30 +11575,25 @@ async function fetchProviderModels(config) {
     })
   };
 }
-function createProvider(config) {
-  const normalized = sanitizeProviderConfig(config);
-  const error = validateProviderConfig(normalized);
-  if (error) {
-    throw new Error(error);
-  }
-  if (normalized.id === "anthropic") {
-    return new AnthropicProvider(
-      normalized.apiKey,
-      normalized.model,
-      normalized.reasoningEffort
-    );
-  }
-  if (normalized.id === "openai_codex") {
-    const tokens = readStoredCodexTokens();
-    if (!tokens) {
-      throw new Error(
-        "OpenAI Codex requires authentication. Open settings to connect your ChatGPT account."
-      );
-    }
-    return new CodexProvider(tokens, normalized.model);
-  }
-  return new OpenAICompatProvider(normalized);
+function createOpenAICompatProvider(config) {
+  return new OpenAICompatProvider(config);
 }
+const anthropicHandler = {
+  create: createAnthropicProvider,
+  listModels: listAnthropicModels
+};
+const codexHandler = {
+  create: createCodexProvider,
+  listModels: listCodexModels
+};
+const openAICompatHandler = {
+  create: createOpenAICompatProvider,
+  listModels: listOpenAICompatModels
+};
+const PROVIDER_HANDLERS = /* @__PURE__ */ new Map([
+  ["anthropic", anthropicHandler],
+  ["openai_codex", codexHandler]
+]);
 function buildSubAgentSystemPrompt(thread) {
   const domainBlock = thread.blockedDomains.length > 0 ? `
 BLOCKED DOMAINS (never visit): ${thread.blockedDomains.join(", ")}` : "";
@@ -13071,16 +13091,9 @@ function isTextEntryControl$1(el) {
   if (el.disabled) return false;
   if (el.type !== "input" && el.type !== "textarea") return false;
   const inputType = (el.inputType || "text").toLowerCase();
-  return ![
-    "button",
-    "checkbox",
-    "file",
-    "hidden",
-    "image",
-    "radio",
-    "reset",
-    "submit"
-  ].includes(inputType);
+  return !["button", "checkbox", "file", "hidden", "image", "radio", "reset", "submit"].includes(
+    inputType
+  );
 }
 function hasRenderedValue(el) {
   return Boolean(summarizeElementValue(el));
@@ -13111,22 +13124,12 @@ function appendFieldAffordances(parts, el) {
   if (hint) parts.push(hint);
 }
 function isQuantityLike(el) {
-  const text = [
-    el.label,
-    el.name,
-    el.placeholder,
-    el.text,
-    el.description,
-    el.selector
-  ].filter(Boolean).join(" ").toLowerCase();
+  const text = [el.label, el.name, el.placeholder, el.text, el.description, el.selector].filter(Boolean).join(" ").toLowerCase();
   return /\b(qty|quantity|count|items?)\b/.test(text) || el.inputType === "number" && (/\b(quantity|qty|count|items?)\b/.test(text) || el.name === "quantity" || el.name === "qty");
 }
 function getQuantityElements(page) {
   const seen = /* @__PURE__ */ new Set();
-  const elements = [
-    ...page.interactiveElements,
-    ...page.forms.flatMap((form) => form.fields)
-  ];
+  const elements = [...page.interactiveElements, ...page.forms.flatMap((form) => form.fields)];
   return elements.filter((el) => {
     if (!isQuantityLike(el)) return false;
     const key2 = String(
@@ -13215,10 +13218,7 @@ function formatCartSnapshot(page) {
   if (quantityElements.length > 0) {
     if (numericQuantities.length === quantityElements.length && numericQuantities.length > 0) {
       const unique = Array.from(new Set(numericQuantities));
-      const totalUnits = numericQuantities.reduce(
-        (sum, value) => sum + value,
-        0
-      );
+      const totalUnits = numericQuantities.reduce((sum, value) => sum + value, 0);
       lines.push(
         unique.length === 1 ? `Quantity controls: ${quantityElements.length} (all set to ${unique[0]})` : `Quantity controls: ${quantityElements.length} (${numericQuantities.join(", ")})`
       );
@@ -13279,9 +13279,7 @@ function dateOrShowtimeControlPriority(el) {
   )) {
     return 0;
   }
-  if (/\b(showtimes?|showings?|screenings?|movie times?|date|calendar)\b/.test(
-    haystack
-  )) {
+  if (/\b(showtimes?|showings?|screenings?|movie times?|date|calendar)\b/.test(haystack)) {
     return 1;
   }
   if (/\b(ticketing|tickets?|formovietickets|seat selection)\b/.test(haystack)) {
@@ -13333,19 +13331,13 @@ function getOffscreenPurchaseActionElements(page) {
   });
 }
 function getDialogFocusedElements(page) {
-  return page.interactiveElements.filter(
-    (el) => isVisibleToUser(el) && el.context === "dialog"
-  );
+  return page.interactiveElements.filter((el) => isVisibleToUser(el) && el.context === "dialog");
 }
 function normalizeOverlayText(value) {
   return (value || "").trim().toLowerCase();
 }
 function isCartConfirmationLike(page) {
-  const overlayText = page.overlays.map(
-    (overlay) => normalizeOverlayText(
-      [overlay.label, overlay.text].filter(Boolean).join(" ")
-    )
-  ).join(" ");
+  const overlayText = page.overlays.map((overlay) => normalizeOverlayText([overlay.label, overlay.text].filter(Boolean).join(" "))).join(" ");
   const dialogText = getDialogFocusedElements(page).map((el) => normalizeOverlayText(el.text || el.label || el.description)).join(" ");
   const haystack = `${overlayText} ${dialogText}`.trim();
   if (!haystack) return false;
@@ -13473,17 +13465,13 @@ function formatNavigation(nav) {
 function formatForms(forms) {
   if (forms.length === 0) return "None";
   return forms.map((form, index) => {
-    const parts = [
-      `Form ${index + 1}${form.id ? ` (#${form.id})` : ""}:`
-    ];
+    const parts = [`Form ${index + 1}${form.id ? ` (#${form.id})` : ""}:`];
     if (form.action) parts.push(`  Action: ${form.action}`);
     if (form.method) parts.push(`  Method: ${form.method.toUpperCase()}`);
     if (form.fields.length > 0) {
       parts.push("  Fields:");
       form.fields.forEach((field) => {
-        const fieldParts = [
-          field.index ? `    [#${field.index}]` : "    -"
-        ];
+        const fieldParts = [field.index ? `    [#${field.index}]` : "    -"];
         if (field.type === "button") {
           fieldParts.push(`[${field.text || "Submit"}]`);
           fieldParts.push(field.role === "radio" ? "radio" : "button");
@@ -13502,9 +13490,7 @@ function formatForms(forms) {
           appendFieldAffordances(fieldParts, field);
           if (field.options?.length) {
             const maxOptions = isDateOrShowtimeControl(field) ? 10 : 5;
-            fieldParts.push(
-              `options=${formatElementOptions(field.options, maxOptions)}`
-            );
+            fieldParts.push(`options=${formatElementOptions(field.options, maxOptions)}`);
           }
         } else if (field.type === "textarea") {
           fieldParts.push(`[${field.label || "Text"}]`);
@@ -13527,10 +13513,7 @@ function formatLandmarks(landmarks) {
   return items.map((lm) => {
     const parts = [`- ${lm.role}`];
     if (lm.label) parts.push(`(label: "${lm.label}")`);
-    if (lm.text)
-      parts.push(
-        `- "${lm.text.slice(0, 100)}${lm.text.length > 100 ? "..." : ""}"`
-      );
+    if (lm.text) parts.push(`- "${lm.text.slice(0, 100)}${lm.text.length > 100 ? "..." : ""}"`);
     return parts.join(" ");
   }).join("\n");
 }
@@ -13630,10 +13613,7 @@ function formatStructuredEntities(entities) {
     if (entity.url && entity.url !== entity.name) {
       lines.push(`  url: ${entity.url}`);
     }
-    for (const [key2, value] of Object.entries(entity.attributes).slice(
-      0,
-      8
-    )) {
+    for (const [key2, value] of Object.entries(entity.attributes).slice(0, 8)) {
       const rendered = formatStructuredValue(value);
       if (rendered) {
         lines.push(`  ${key2}: ${rendered}`);
@@ -13676,13 +13656,7 @@ function getHighlightsForPage(url) {
 function formatJsonLd(items) {
   if (!items || items.length === 0) return "";
   const lines = [];
-  const SKIP = /* @__PURE__ */ new Set([
-    "@context",
-    "image",
-    "logo",
-    "thumbnail",
-    "potentialAction"
-  ]);
+  const SKIP = /* @__PURE__ */ new Set(["@context", "image", "logo", "thumbnail", "potentialAction"]);
   const TYPE_FIELDS = {
     Recipe: [
       "name",
@@ -13695,15 +13669,7 @@ function formatJsonLd(items) {
       "recipeIngredient",
       "recipeInstructions"
     ],
-    Article: [
-      "headline",
-      "name",
-      "url",
-      "datePublished",
-      "dateModified",
-      "author",
-      "description"
-    ],
+    Article: ["headline", "name", "url", "datePublished", "dateModified", "author", "description"],
     Product: ["name", "url", "description", "offers"],
     BreadcrumbList: ["itemListElement"],
     Organization: ["name", "url", "description"]
@@ -13716,8 +13682,7 @@ function formatJsonLd(items) {
     const renderValue = (val, depth = 0) => {
       if (val === null || val === void 0) return "";
       if (typeof val === "string") return val;
-      if (typeof val === "number" || typeof val === "boolean")
-        return String(val);
+      if (typeof val === "number" || typeof val === "boolean") return String(val);
       if (Array.isArray(val)) {
         if (depth > 0)
           return val.map((v) => renderValue(v, depth + 1)).filter(Boolean).join(", ");
@@ -13752,22 +13717,18 @@ function formatJsonLd(items) {
 }
 function chooseAgentReadMode(page) {
   const pageType = detectPageType(page);
-  switch (pageType) {
-    case "SEARCH_RESULTS":
-    case "PAGINATED_LIST":
-      return "results_only";
-    case "LOGIN":
-    case "SEARCH_READY":
-    case "SHOPPING":
-    case "FORM":
-      return "visible_only";
-    case "ARTICLE":
-      return "summary";
-    case "GENERAL":
-    default:
-      return "visible_only";
-  }
-}
+  return PAGE_TYPE_READ_MODE[pageType];
+}
+const PAGE_TYPE_READ_MODE = {
+  LOGIN: "visible_only",
+  SEARCH_READY: "visible_only",
+  SEARCH_RESULTS: "results_only",
+  SHOPPING: "visible_only",
+  FORM: "visible_only",
+  PAGINATED_LIST: "results_only",
+  ARTICLE: "summary",
+  GENERAL: "visible_only"
+};
 const SITE_RESULT_FILTERS = [
   {
     hostname: "news.ycombinator.com",
@@ -13829,12 +13790,7 @@ function isSiteUtilityLink(element) {
 function isSearchOrListingPage(page) {
   if (isSiteListingPage(page.url)) return true;
   const haystack = normalizeComparable(
-    [
-      page.url,
-      page.title,
-      page.excerpt,
-      page.headings.map((heading) => heading.text).join(" ")
-    ].filter(Boolean).join(" ")
+    [page.url, page.title, page.excerpt, page.headings.map((heading) => heading.text).join(" ")].filter(Boolean).join(" ")
   );
   return /\b(search|results|find|discover|browse|repositories|repository|issues|pull requests|prs|users|events|listings)\b/.test(
     haystack
@@ -13850,9 +13806,7 @@ function collectJsonLdEntityItems(input, results = []) {
   const item = input;
   const type = item["@type"];
   const types = Array.isArray(type) ? type : [type];
-  const typeNames = types.filter(
-    (entry) => typeof entry === "string"
-  );
+  const typeNames = types.filter((entry) => typeof entry === "string");
   if ((typeof item.name === "string" || typeof item.url === "string") && !typeNames.some(
     (entry) => ["BreadcrumbList", "Organization", "WebSite", "WebPage"].includes(entry)
   )) {
@@ -13867,14 +13821,10 @@ function collectJsonLdEntityItems(input, results = []) {
 function getResultCandidates(page) {
   const entityItems = collectJsonLdEntityItems(page.jsonLd ?? []);
   const entityNames = new Set(
-    entityItems.map(
-      (item) => typeof item.name === "string" ? normalizeComparable(item.name) : ""
-    ).filter(Boolean)
+    entityItems.map((item) => typeof item.name === "string" ? normalizeComparable(item.name) : "").filter(Boolean)
   );
   const entityUrls = new Set(
-    entityItems.map(
-      (item) => typeof item.url === "string" ? normalizeUrlForMatch(item.url) : null
-    ).filter((value) => Boolean(value))
+    entityItems.map((item) => typeof item.url === "string" ? normalizeUrlForMatch(item.url) : null).filter((value) => Boolean(value))
   );
   const pageHost = normalizeUrlForMatch(page.url);
   const searchOrListingPage = isSearchOrListingPage(page);
@@ -13897,8 +13847,7 @@ function getResultCandidates(page) {
       score += 4;
     }
     if (element.context === "article") score += 3;
-    else if (element.context === "main" || element.context === "content")
-      score += 1;
+    else if (element.context === "main" || element.context === "content") score += 1;
     if (href && pageHost) {
       try {
         if (new URL(href).origin === new URL(pageHost).origin) score += 1;
@@ -13912,9 +13861,7 @@ function getResultCandidates(page) {
       score += 2;
     }
     if (/\b(card|tile|result|rating|review)\b/.test(haystack)) score += 1;
-    if (/\b(item|list|row|repo|repository|issue|pull request|event)\b/.test(
-      haystack
-    )) {
+    if (/\b(item|list|row|repo|repository|issue|pull request|event)\b/.test(haystack)) {
       score += 1;
     }
     if (text.length >= 12 && text.split(/\s+/).length >= 2) score += 1;
@@ -13933,9 +13880,7 @@ function getResultCandidates(page) {
       return score >= 4 || score >= 3 && (element.context === "article" || element.context === "main" || element.context === "content");
     }
     return score >= 4 || score >= 3 && element.context === "article";
-  }).sort(
-    (a, b) => b.score - a.score || (a.element.index ?? 0) - (b.element.index ?? 0)
-  );
+  }).sort((a, b) => b.score - a.score || (a.element.index ?? 0) - (b.element.index ?? 0));
   const seen = /* @__PURE__ */ new Set();
   return scored.map(({ element }) => element).filter((element) => {
     const key2 = `${normalizeComparable(element.text || "")}|${normalizeUrlForMatch(element.href) || ""}`;
@@ -13945,365 +13890,362 @@ function getResultCandidates(page) {
   });
 }
 function buildScopedContext(page, mode) {
-  switch (mode) {
-    case "summary": {
-      const sections = [];
-      const cartSnapshot = formatCartSnapshot(page);
-      sections.push(`**URL:** ${page.url}`);
-      sections.push(`**Title:** ${page.title}`);
-      sections.push(`**Viewport:** ${formatViewport(page)}`);
-      if (page.byline) sections.push(`**Author:** ${page.byline}`);
-      if (page.excerpt) sections.push(`**Summary:** ${page.excerpt}`);
-      const largePageHint = formatLargePageHint(page);
-      if (largePageHint) sections.push(`**Reading Hint:** ${largePageHint}`);
-      const scrollHints = getScrollHints(page);
-      if (scrollHints.length > 0) {
-        sections.push(`**Scroll Hint:** ${scrollHints[0]}`);
-      }
-      sections.push("");
-      const summaryIntent = analyzePageIntent(page);
-      if (summaryIntent) {
-        sections.push(summaryIntent);
-        sections.push("");
-      }
-      if (cartSnapshot) {
-        sections.push("### Cart Snapshot");
-        sections.push(cartSnapshot);
-        sections.push("");
-      }
-      if ((page.pageIssues?.length ?? 0) > 0) {
-        sections.push("### Page Access Warnings");
-        sections.push(formatPageIssues(page.pageIssues ?? []));
-        sections.push("");
-      }
-      sections.push("### Document Outline");
-      sections.push(formatHeadings(page.headings));
-      sections.push("");
-      const summaryHighlights = getHighlightsForPage(page.url);
-      sections.push(
-        `Stats: ${page.interactiveElements.length} interactives, ${page.forms.length} forms, ${page.navigation.length} nav links, ${page.headings.length} headings, ${page.content.length} chars`
-      );
-      if (summaryHighlights.length > 0) {
-        sections.push("");
-        sections.push("### Highlights & Annotations");
-        sections.push(formatHighlights(summaryHighlights));
-      }
-      if ((page.structuredData?.length ?? 0) > 0) {
-        if (hasOnlyFallbackStructuredData(page)) {
-          const rawSources = [
-            (page.jsonLd?.length ?? 0) > 0 ? `${page.jsonLd.length} JSON-LD` : "",
-            (page.microdata?.length ?? 0) > 0 ? `${page.microdata.length} microdata` : "",
-            (page.rdfa?.length ?? 0) > 0 ? `${page.rdfa.length} RDFa` : ""
-          ].filter(Boolean);
-          if (rawSources.length > 0) {
-            sections.push(
-              `Structured data: generic page metadata only (raw sources present: ${rawSources.join(", ")} — use extract_structured_data or read_page with mode=structured for details)`
-            );
-          } else {
-            sections.push("Structured data: generic page metadata only");
-          }
-        } else {
-          sections.push(
-            `Structured entities: ${page.structuredData?.map((entity) => entity.types[0]).join(", ")}`
-          );
-        }
-      }
-      if (page.overlays.length > 0) {
-        sections.push(
-          `Blocking overlays: ${page.overlays.filter((overlay) => overlay.blocksInteraction).length}`
-        );
-      }
-      if (page.dormantOverlays.length > 0) {
-        sections.push(
-          `Dormant consent/modal surfaces: ${page.dormantOverlays.length}`
-        );
-      }
-      return sections.join("\n");
-    }
-    case "interactives_only": {
-      const sections = [];
-      const quantityElements = getQuantityElements(page);
-      const cartSnapshot = formatCartSnapshot(page);
-      const dialogFocus = formatDialogFocus(page);
-      sections.push(`**URL:** ${page.url}`);
-      sections.push(`**Title:** ${page.title}`);
-      sections.push(`**Viewport:** ${formatViewport(page)}`);
-      const interactivesScrollHints = getScrollHints(page);
-      if (interactivesScrollHints.length > 0) {
-        sections.push(`**Scroll Hint:** ${interactivesScrollHints[0]}`);
-      }
-      sections.push("");
-      const interactivesIntent = analyzePageIntent(page);
-      if (interactivesIntent) {
-        sections.push(interactivesIntent);
-        sections.push("");
-      }
-      const interactivesHighlights = getHighlightsForPage(page.url);
-      if (interactivesHighlights.length > 0) {
-        sections.push("### Highlights & Annotations");
-        sections.push(formatHighlights(interactivesHighlights));
-        sections.push("");
-      }
-      if (cartSnapshot) {
-        sections.push("### Cart Snapshot");
-        sections.push(cartSnapshot);
-        sections.push("");
-      }
-      if ((page.pageIssues?.length ?? 0) > 0) {
-        sections.push("### Page Access Warnings");
-        sections.push(formatPageIssues(page.pageIssues ?? []));
-        sections.push("");
-      }
-      if (page.overlays.length > 0) {
-        sections.push("### Active Overlays");
-        sections.push(formatOverlays(page));
-        sections.push("");
-      }
-      if (dialogFocus) {
-        sections.push("### Immediate Overlay Actions");
-        sections.push(dialogFocus);
-        sections.push("");
-      }
-      if (page.dormantOverlays.length > 0) {
-        sections.push("### Dormant Consent / Modal UI");
-        sections.push(formatDormantOverlays(page.dormantOverlays));
-        sections.push("");
-      }
-      if (page.navigation.length > 0) {
-        sections.push("### Navigation");
-        sections.push(formatNavigation(page.navigation));
-        sections.push("");
-      }
-      if (quantityElements.length > 0) {
-        sections.push("### Quantity / Count Controls");
-        sections.push(formatQuantityElements(quantityElements));
-        sections.push("");
-      }
-      if (page.interactiveElements.length > 0) {
+  const render = SCOPED_CONTEXT_RENDERERS.get(mode) ?? buildStructuredContext;
+  return render(page);
+}
+function buildSummaryContext(page) {
+  const sections = [];
+  const cartSnapshot = formatCartSnapshot(page);
+  sections.push(`**URL:** ${page.url}`);
+  sections.push(`**Title:** ${page.title}`);
+  sections.push(`**Viewport:** ${formatViewport(page)}`);
+  if (page.byline) sections.push(`**Author:** ${page.byline}`);
+  if (page.excerpt) sections.push(`**Summary:** ${page.excerpt}`);
+  const largePageHint = formatLargePageHint(page);
+  if (largePageHint) sections.push(`**Reading Hint:** ${largePageHint}`);
+  const scrollHints = getScrollHints(page);
+  if (scrollHints.length > 0) {
+    sections.push(`**Scroll Hint:** ${scrollHints[0]}`);
+  }
+  sections.push("");
+  const summaryIntent = analyzePageIntent(page);
+  if (summaryIntent) {
+    sections.push(summaryIntent);
+    sections.push("");
+  }
+  if (cartSnapshot) {
+    sections.push("### Cart Snapshot");
+    sections.push(cartSnapshot);
+    sections.push("");
+  }
+  if ((page.pageIssues?.length ?? 0) > 0) {
+    sections.push("### Page Access Warnings");
+    sections.push(formatPageIssues(page.pageIssues ?? []));
+    sections.push("");
+  }
+  sections.push("### Document Outline");
+  sections.push(formatHeadings(page.headings));
+  sections.push("");
+  const summaryHighlights = getHighlightsForPage(page.url);
+  sections.push(
+    `Stats: ${page.interactiveElements.length} interactives, ${page.forms.length} forms, ${page.navigation.length} nav links, ${page.headings.length} headings, ${page.content.length} chars`
+  );
+  if (summaryHighlights.length > 0) {
+    sections.push("");
+    sections.push("### Highlights & Annotations");
+    sections.push(formatHighlights(summaryHighlights));
+  }
+  if ((page.structuredData?.length ?? 0) > 0) {
+    if (hasOnlyFallbackStructuredData(page)) {
+      const rawSources = [
+        (page.jsonLd?.length ?? 0) > 0 ? `${page.jsonLd.length} JSON-LD` : "",
+        (page.microdata?.length ?? 0) > 0 ? `${page.microdata.length} microdata` : "",
+        (page.rdfa?.length ?? 0) > 0 ? `${page.rdfa.length} RDFa` : ""
+      ].filter(Boolean);
+      if (rawSources.length > 0) {
         sections.push(
-          `### Interactive Elements (${page.interactiveElements.length})`
+          `Structured data: generic page metadata only (raw sources present: ${rawSources.join(", ")} — use extract_structured_data or read_page with mode=structured for details)`
         );
-        sections.push(formatInteractiveElements(page.interactiveElements));
-      }
-      return sections.join("\n");
-    }
-    case "forms_only": {
-      const sections = [];
-      const quantityElements = getQuantityElements(page);
-      const cartSnapshot = formatCartSnapshot(page);
-      sections.push(`**URL:** ${page.url}`);
-      sections.push(`**Title:** ${page.title}`);
-      sections.push(`**Viewport:** ${formatViewport(page)}`);
-      const visibleScrollHints = getScrollHints(page);
-      if (visibleScrollHints.length > 0) {
-        sections.push(`**Scroll Hint:** ${visibleScrollHints[0]}`);
-      }
-      sections.push("");
-      const formsHighlights = getHighlightsForPage(page.url);
-      if (formsHighlights.length > 0) {
-        sections.push("### Highlights & Annotations");
-        sections.push(formatHighlights(formsHighlights));
-        sections.push("");
-      }
-      if (cartSnapshot) {
-        sections.push("### Cart Snapshot");
-        sections.push(cartSnapshot);
-        sections.push("");
-      }
-      if ((page.pageIssues?.length ?? 0) > 0) {
-        sections.push("### Page Access Warnings");
-        sections.push(formatPageIssues(page.pageIssues ?? []));
-        sections.push("");
-      }
-      if (page.overlays.length > 0) {
-        sections.push("### Active Overlays");
-        sections.push(formatOverlays(page));
-        sections.push("");
-      }
-      if (page.dormantOverlays.length > 0) {
-        sections.push("### Dormant Consent / Modal UI");
-        sections.push(formatDormantOverlays(page.dormantOverlays));
-        sections.push("");
-      }
-      if (quantityElements.length > 0) {
-        sections.push("### Quantity / Count Controls");
-        sections.push(formatQuantityElements(quantityElements));
-        sections.push("");
-      }
-      if (page.forms.length > 0) {
-        sections.push(`### Forms (${page.forms.length})`);
-        sections.push(formatForms(page.forms));
       } else {
-        sections.push("No forms found on this page.");
-      }
-      return sections.join("\n");
-    }
-    case "text_only": {
-      const sections = [];
-      sections.push(`**URL:** ${page.url}`);
-      sections.push(`**Title:** ${page.title}`);
-      sections.push(`**Viewport:** ${formatViewport(page)}`);
-      sections.push("");
-      const textHighlights = getHighlightsForPage(page.url);
-      if (textHighlights.length > 0) {
-        sections.push("### Highlights & Annotations");
-        sections.push(formatHighlights(textHighlights));
-        sections.push("");
-      }
-      if ((page.pageIssues?.length ?? 0) > 0) {
-        sections.push("### Page Access Warnings");
-        sections.push(formatPageIssues(page.pageIssues ?? []));
-        sections.push("");
-      }
-      const truncated = page.content.length > MAX_CONTEXT_CONTENT_LENGTH ? page.content.slice(0, MAX_CONTEXT_CONTENT_LENGTH) + "\n[Content truncated...]" : page.content;
-      sections.push(truncated);
-      return sections.join("\n");
-    }
-    case "visible_only": {
-      const visibleElements = page.interactiveElements.filter(isVisibleToUser);
-      const visibleNav = page.navigation.filter(isVisibleToUser);
-      const dialogFocusedElements = getDialogFocusedElements(page);
-      const visiblePage = {
-        ...page,
-        interactiveElements: dialogFocusedElements.length > 0 ? dialogFocusedElements : visibleElements,
-        forms: page.forms.map((form) => ({
-          ...form,
-          fields: form.fields.filter(
-            (field) => isVisibleToUser(field) && (dialogFocusedElements.length === 0 || field.context === "dialog")
-          )
-        })).filter((form) => form.fields.length > 0)
-      };
-      const quantityElements = getQuantityElements(visiblePage);
-      const purchaseActions = getPurchaseActionElements(visiblePage, {
-        visibleOnly: true
-      });
-      const offscreenPurchaseActions = getOffscreenPurchaseActionElements(page);
-      const cartSnapshot = formatCartSnapshot(visiblePage);
-      const visibleForms = visiblePage.forms;
-      const dialogFocus = formatDialogFocus(page);
-      const flightBookingFormHint = getFlightBookingFormHint(page);
-      const sections = [];
-      sections.push(`**URL:** ${page.url}`);
-      sections.push(`**Title:** ${page.title}`);
-      sections.push(`**Viewport:** ${formatViewport(page)}`);
-      sections.push("");
-      const visibleHighlights = getHighlightsForPage(page.url);
-      if (visibleHighlights.length > 0) {
-        sections.push("### Highlights & Annotations");
-        sections.push(formatHighlights(visibleHighlights));
-        sections.push("");
-      }
-      if (cartSnapshot) {
-        sections.push("### Cart Snapshot");
-        sections.push(cartSnapshot);
-        sections.push("");
-      }
-      if ((page.pageIssues?.length ?? 0) > 0) {
-        sections.push("### Page Access Warnings");
-        sections.push(formatPageIssues(page.pageIssues ?? []));
-        sections.push("");
-      }
-      if (flightBookingFormHint) {
-        sections.push("### Flight Booking Hint");
-        sections.push(flightBookingFormHint);
-        sections.push("");
-      }
-      if (page.overlays.length > 0) {
-        sections.push("### Active Overlays");
-        sections.push(formatOverlays(page));
-        sections.push("");
-      }
-      if (dialogFocus) {
-        sections.push("### Immediate Overlay Actions");
-        sections.push(dialogFocus);
-        if (visibleElements.length > dialogFocusedElements.length) {
-          sections.push("");
-          sections.push(
-            `Background controls hidden while the dialog is active: ${visibleElements.length - dialogFocusedElements.length}`
-          );
-        }
-        sections.push("");
-      }
-      if (page.dormantOverlays.length > 0) {
-        sections.push("### Dormant Consent / Modal UI");
-        sections.push(formatDormantOverlays(page.dormantOverlays));
-        sections.push("");
-      }
-      if (visibleNav.length > 0) {
-        sections.push("### Visible Navigation");
-        sections.push(formatNavigation(visibleNav));
-        sections.push("");
-      }
-      if (quantityElements.length > 0) {
-        sections.push("### Quantity / Count Controls");
-        sections.push(formatQuantityElements(quantityElements));
-        sections.push("");
-      }
-      if (purchaseActions.length > 0) {
-        sections.push("### Primary Purchase Actions");
-        sections.push(formatInteractiveElements(purchaseActions));
-        sections.push("");
-      }
-      if (offscreenPurchaseActions.length > 0) {
-        sections.push("### Offscreen Purchase Actions");
-        sections.push(
-          "These purchase controls are present on the page but currently outside the viewport. You can scroll to reveal them or click them by index."
-        );
-        sections.push(formatInteractiveElements(offscreenPurchaseActions));
-        sections.push("");
-      }
-      if (visiblePage.interactiveElements.length > 0) {
-        sections.push(
-          `### Visible In-Viewport Interactive Elements (${visiblePage.interactiveElements.length})`
-        );
-        sections.push(
-          formatInteractiveElements(visiblePage.interactiveElements)
-        );
-        sections.push("");
-      }
-      if (visibleForms.length > 0) {
-        sections.push("### Visible Forms");
-        sections.push(formatForms(visibleForms));
-      } else if (visibleElements.length === 0 && visibleNav.length === 0) {
-        sections.push(
-          "No currently visible, unobstructed interactive elements were detected in the viewport."
-        );
+        sections.push("Structured data: generic page metadata only");
       }
-      return sections.join("\n");
+    } else {
+      sections.push(
+        `Structured entities: ${page.structuredData?.map((entity) => entity.types[0]).join(", ")}`
+      );
     }
-    case "results_only": {
-      const resultElements = getResultCandidates(page);
-      const sections = [];
-      sections.push(`**URL:** ${page.url}`);
-      sections.push(`**Title:** ${page.title}`);
-      sections.push(`**Viewport:** ${formatViewport(page)}`);
+  }
+  if (page.overlays.length > 0) {
+    sections.push(
+      `Blocking overlays: ${page.overlays.filter((overlay) => overlay.blocksInteraction).length}`
+    );
+  }
+  if (page.dormantOverlays.length > 0) {
+    sections.push(`Dormant consent/modal surfaces: ${page.dormantOverlays.length}`);
+  }
+  return sections.join("\n");
+}
+function buildInteractivesOnlyContext(page) {
+  const sections = [];
+  const quantityElements = getQuantityElements(page);
+  const cartSnapshot = formatCartSnapshot(page);
+  const dialogFocus = formatDialogFocus(page);
+  sections.push(`**URL:** ${page.url}`);
+  sections.push(`**Title:** ${page.title}`);
+  sections.push(`**Viewport:** ${formatViewport(page)}`);
+  const interactivesScrollHints = getScrollHints(page);
+  if (interactivesScrollHints.length > 0) {
+    sections.push(`**Scroll Hint:** ${interactivesScrollHints[0]}`);
+  }
+  sections.push("");
+  const interactivesIntent = analyzePageIntent(page);
+  if (interactivesIntent) {
+    sections.push(interactivesIntent);
+    sections.push("");
+  }
+  const interactivesHighlights = getHighlightsForPage(page.url);
+  if (interactivesHighlights.length > 0) {
+    sections.push("### Highlights & Annotations");
+    sections.push(formatHighlights(interactivesHighlights));
+    sections.push("");
+  }
+  if (cartSnapshot) {
+    sections.push("### Cart Snapshot");
+    sections.push(cartSnapshot);
+    sections.push("");
+  }
+  if ((page.pageIssues?.length ?? 0) > 0) {
+    sections.push("### Page Access Warnings");
+    sections.push(formatPageIssues(page.pageIssues ?? []));
+    sections.push("");
+  }
+  if (page.overlays.length > 0) {
+    sections.push("### Active Overlays");
+    sections.push(formatOverlays(page));
+    sections.push("");
+  }
+  if (dialogFocus) {
+    sections.push("### Immediate Overlay Actions");
+    sections.push(dialogFocus);
+    sections.push("");
+  }
+  if (page.dormantOverlays.length > 0) {
+    sections.push("### Dormant Consent / Modal UI");
+    sections.push(formatDormantOverlays(page.dormantOverlays));
+    sections.push("");
+  }
+  if (page.navigation.length > 0) {
+    sections.push("### Navigation");
+    sections.push(formatNavigation(page.navigation));
+    sections.push("");
+  }
+  if (quantityElements.length > 0) {
+    sections.push("### Quantity / Count Controls");
+    sections.push(formatQuantityElements(quantityElements));
+    sections.push("");
+  }
+  if (page.interactiveElements.length > 0) {
+    sections.push(`### Interactive Elements (${page.interactiveElements.length})`);
+    sections.push(formatInteractiveElements(page.interactiveElements));
+  }
+  return sections.join("\n");
+}
+function buildFormsOnlyContext(page) {
+  const sections = [];
+  const quantityElements = getQuantityElements(page);
+  const cartSnapshot = formatCartSnapshot(page);
+  sections.push(`**URL:** ${page.url}`);
+  sections.push(`**Title:** ${page.title}`);
+  sections.push(`**Viewport:** ${formatViewport(page)}`);
+  const visibleScrollHints = getScrollHints(page);
+  if (visibleScrollHints.length > 0) {
+    sections.push(`**Scroll Hint:** ${visibleScrollHints[0]}`);
+  }
+  sections.push("");
+  const formsHighlights = getHighlightsForPage(page.url);
+  if (formsHighlights.length > 0) {
+    sections.push("### Highlights & Annotations");
+    sections.push(formatHighlights(formsHighlights));
+    sections.push("");
+  }
+  if (cartSnapshot) {
+    sections.push("### Cart Snapshot");
+    sections.push(cartSnapshot);
+    sections.push("");
+  }
+  if ((page.pageIssues?.length ?? 0) > 0) {
+    sections.push("### Page Access Warnings");
+    sections.push(formatPageIssues(page.pageIssues ?? []));
+    sections.push("");
+  }
+  if (page.overlays.length > 0) {
+    sections.push("### Active Overlays");
+    sections.push(formatOverlays(page));
+    sections.push("");
+  }
+  if (page.dormantOverlays.length > 0) {
+    sections.push("### Dormant Consent / Modal UI");
+    sections.push(formatDormantOverlays(page.dormantOverlays));
+    sections.push("");
+  }
+  if (quantityElements.length > 0) {
+    sections.push("### Quantity / Count Controls");
+    sections.push(formatQuantityElements(quantityElements));
+    sections.push("");
+  }
+  if (page.forms.length > 0) {
+    sections.push(`### Forms (${page.forms.length})`);
+    sections.push(formatForms(page.forms));
+  } else {
+    sections.push("No forms found on this page.");
+  }
+  return sections.join("\n");
+}
+function buildTextOnlyContext(page) {
+  const sections = [];
+  sections.push(`**URL:** ${page.url}`);
+  sections.push(`**Title:** ${page.title}`);
+  sections.push(`**Viewport:** ${formatViewport(page)}`);
+  sections.push("");
+  const textHighlights = getHighlightsForPage(page.url);
+  if (textHighlights.length > 0) {
+    sections.push("### Highlights & Annotations");
+    sections.push(formatHighlights(textHighlights));
+    sections.push("");
+  }
+  if ((page.pageIssues?.length ?? 0) > 0) {
+    sections.push("### Page Access Warnings");
+    sections.push(formatPageIssues(page.pageIssues ?? []));
+    sections.push("");
+  }
+  const truncated = page.content.length > MAX_CONTEXT_CONTENT_LENGTH ? page.content.slice(0, MAX_CONTEXT_CONTENT_LENGTH) + "\n[Content truncated...]" : page.content;
+  sections.push(truncated);
+  return sections.join("\n");
+}
+function buildVisibleOnlyContext(page) {
+  const visibleElements = page.interactiveElements.filter(isVisibleToUser);
+  const visibleNav = page.navigation.filter(isVisibleToUser);
+  const dialogFocusedElements = getDialogFocusedElements(page);
+  const visiblePage = {
+    ...page,
+    interactiveElements: dialogFocusedElements.length > 0 ? dialogFocusedElements : visibleElements,
+    forms: page.forms.map((form) => ({
+      ...form,
+      fields: form.fields.filter(
+        (field) => isVisibleToUser(field) && (dialogFocusedElements.length === 0 || field.context === "dialog")
+      )
+    })).filter((form) => form.fields.length > 0)
+  };
+  const quantityElements = getQuantityElements(visiblePage);
+  const purchaseActions = getPurchaseActionElements(visiblePage, {
+    visibleOnly: true
+  });
+  const offscreenPurchaseActions = getOffscreenPurchaseActionElements(page);
+  const cartSnapshot = formatCartSnapshot(visiblePage);
+  const visibleForms = visiblePage.forms;
+  const dialogFocus = formatDialogFocus(page);
+  const flightBookingFormHint = getFlightBookingFormHint(page);
+  const sections = [];
+  sections.push(`**URL:** ${page.url}`);
+  sections.push(`**Title:** ${page.title}`);
+  sections.push(`**Viewport:** ${formatViewport(page)}`);
+  sections.push("");
+  const visibleHighlights = getHighlightsForPage(page.url);
+  if (visibleHighlights.length > 0) {
+    sections.push("### Highlights & Annotations");
+    sections.push(formatHighlights(visibleHighlights));
+    sections.push("");
+  }
+  if (cartSnapshot) {
+    sections.push("### Cart Snapshot");
+    sections.push(cartSnapshot);
+    sections.push("");
+  }
+  if ((page.pageIssues?.length ?? 0) > 0) {
+    sections.push("### Page Access Warnings");
+    sections.push(formatPageIssues(page.pageIssues ?? []));
+    sections.push("");
+  }
+  if (flightBookingFormHint) {
+    sections.push("### Flight Booking Hint");
+    sections.push(flightBookingFormHint);
+    sections.push("");
+  }
+  if (page.overlays.length > 0) {
+    sections.push("### Active Overlays");
+    sections.push(formatOverlays(page));
+    sections.push("");
+  }
+  if (dialogFocus) {
+    sections.push("### Immediate Overlay Actions");
+    sections.push(dialogFocus);
+    if (visibleElements.length > dialogFocusedElements.length) {
       sections.push("");
-      const resultsHighlights = getHighlightsForPage(page.url);
-      if (resultsHighlights.length > 0) {
-        sections.push("### Highlights & Annotations");
-        sections.push(formatHighlights(resultsHighlights));
-        sections.push("");
-      }
-      if ((page.pageIssues?.length ?? 0) > 0) {
-        sections.push("### Page Access Warnings");
-        sections.push(formatPageIssues(page.pageIssues ?? []));
-        sections.push("");
-      }
-      if (resultElements.length > 0) {
-        sections.push(`### Likely Search Results (${resultElements.length})`);
-        sections.push(formatInteractiveElements(resultElements));
-      } else {
-        sections.push(
-          "No likely primary result links were detected on this page."
-        );
-      }
-      return sections.join("\n");
+      sections.push(
+        `Background controls hidden while the dialog is active: ${visibleElements.length - dialogFocusedElements.length}`
+      );
     }
-    case "full":
-    default:
-      return buildStructuredContext(page);
+    sections.push("");
+  }
+  if (page.dormantOverlays.length > 0) {
+    sections.push("### Dormant Consent / Modal UI");
+    sections.push(formatDormantOverlays(page.dormantOverlays));
+    sections.push("");
+  }
+  if (visibleNav.length > 0) {
+    sections.push("### Visible Navigation");
+    sections.push(formatNavigation(visibleNav));
+    sections.push("");
+  }
+  if (quantityElements.length > 0) {
+    sections.push("### Quantity / Count Controls");
+    sections.push(formatQuantityElements(quantityElements));
+    sections.push("");
+  }
+  if (purchaseActions.length > 0) {
+    sections.push("### Primary Purchase Actions");
+    sections.push(formatInteractiveElements(purchaseActions));
+    sections.push("");
+  }
+  if (offscreenPurchaseActions.length > 0) {
+    sections.push("### Offscreen Purchase Actions");
+    sections.push(
+      "These purchase controls are present on the page but currently outside the viewport. You can scroll to reveal them or click them by index."
+    );
+    sections.push(formatInteractiveElements(offscreenPurchaseActions));
+    sections.push("");
+  }
+  if (visiblePage.interactiveElements.length > 0) {
+    sections.push(
+      `### Visible In-Viewport Interactive Elements (${visiblePage.interactiveElements.length})`
+    );
+    sections.push(formatInteractiveElements(visiblePage.interactiveElements));
+    sections.push("");
   }
+  if (visibleForms.length > 0) {
+    sections.push("### Visible Forms");
+    sections.push(formatForms(visibleForms));
+  } else if (visibleElements.length === 0 && visibleNav.length === 0) {
+    sections.push(
+      "No currently visible, unobstructed interactive elements were detected in the viewport."
+    );
+  }
+  return sections.join("\n");
+}
+function buildResultsOnlyContext(page) {
+  const resultElements = getResultCandidates(page);
+  const sections = [];
+  sections.push(`**URL:** ${page.url}`);
+  sections.push(`**Title:** ${page.title}`);
+  sections.push(`**Viewport:** ${formatViewport(page)}`);
+  sections.push("");
+  const resultsHighlights = getHighlightsForPage(page.url);
+  if (resultsHighlights.length > 0) {
+    sections.push("### Highlights & Annotations");
+    sections.push(formatHighlights(resultsHighlights));
+    sections.push("");
+  }
+  if ((page.pageIssues?.length ?? 0) > 0) {
+    sections.push("### Page Access Warnings");
+    sections.push(formatPageIssues(page.pageIssues ?? []));
+    sections.push("");
+  }
+  if (resultElements.length > 0) {
+    sections.push(`### Likely Search Results (${resultElements.length})`);
+    sections.push(formatInteractiveElements(resultElements));
+  } else {
+    sections.push("No likely primary result links were detected on this page.");
+  }
+  return sections.join("\n");
 }
+const SCOPED_CONTEXT_RENDERERS = /* @__PURE__ */ new Map([
+  ["summary", buildSummaryContext],
+  ["interactives_only", buildInteractivesOnlyContext],
+  ["forms_only", buildFormsOnlyContext],
+  ["text_only", buildTextOnlyContext],
+  ["visible_only", buildVisibleOnlyContext],
+  ["results_only", buildResultsOnlyContext]
+]);
 function detectPageType(page) {
   const url = page.url.toLowerCase();
   const hasPasswordField = page.forms.some(
@@ -14313,9 +14255,7 @@ function detectPageType(page) {
     (el) => el.inputType === "search" || el.name === "q" || el.name === "query" || el.name === "search" || (el.placeholder || "").toLowerCase().includes("search")
   );
   const hasSearchInput = searchInputs.length > 0 || page.forms.some(
-    (f) => f.fields.some(
-      (el) => el.inputType === "search" || el.name === "q" || el.name === "query"
-    )
+    (f) => f.fields.some((el) => el.inputType === "search" || el.name === "q" || el.name === "query")
   );
   const hasVisibleSearchInput = searchInputs.some(
     (el) => el.visible === true && el.inViewport === true && el.obscured !== true && el.blockedByOverlay !== true
@@ -14342,8 +14282,7 @@ function detectPageType(page) {
   if (isSiteListingPage(page.url)) return "PAGINATED_LIST";
   if (hasPagination && listingLike) return "PAGINATED_LIST";
   if (hasSearchInput && !listingLike) return "SEARCH_READY";
-  if (page.content.length > 3e3 && page.interactiveElements.length < 10)
-    return "ARTICLE";
+  if (page.content.length > 3e3 && page.interactiveElements.length < 10) return "ARTICLE";
   return "GENERAL";
 }
 function isFlightBookingPage(page) {
@@ -14356,18 +14295,13 @@ function isFlightBookingPage(page) {
   if (/google\.com\/travel\/flights|google flights/.test(pageText)) {
     return true;
   }
-  const controlsText = [
-    ...page.interactiveElements,
-    ...page.forms.flatMap((form) => form.fields)
-  ].map(
+  const controlsText = [...page.interactiveElements, ...page.forms.flatMap((form) => form.fields)].map(
     (el) => [el.label, el.placeholder, el.name, el.text, el.role, el.inputType].filter(Boolean).join(" ")
   ).join(" ").toLowerCase();
   const hasRouteControls = /\b(?:where from|where to|origin|destination|from|to)\b/.test(
     controlsText
   );
-  const hasDateControls = /\b(?:departure|depart|return|date)\b/.test(
-    controlsText
-  );
+  const hasDateControls = /\b(?:departure|depart|return|date)\b/.test(controlsText);
   const hasFlightLanguage = /\b(?:flight|flights|airfare|airline)\b/.test(
     `${pageText} ${controlsText}`
   );
@@ -14377,70 +14311,77 @@ function getFlightBookingFormHint(page) {
   if (!isFlightBookingPage(page)) return null;
   return "Flight booking form: use the visible route, destination, and date controls with type_text/select_option/click/submit_form before constructing direct Google Flights or travel-search URLs. Direct travel URLs are a fallback only after visible controls fail or the page is unusable.";
 }
+function buildLoginIntentHints(ctx) {
+  const { page } = ctx;
+  const hints = [
+    "Page type: LOGIN/SIGNUP",
+    "Suggested: vessel_login or vessel_fill_form → auto-fills credentials and submits"
+  ];
+  const userField = page.forms.flatMap((f) => f.fields).find(
+    (el) => el.inputType === "email" || el.name === "email" || el.name === "username" || el.autocomplete === "username"
+  );
+  if (userField) {
+    hints.push(
+      `Username field: #${userField.index} [${userField.label || userField.name || userField.placeholder || "input"}]`
+    );
+  }
+  return hints;
+}
+function buildSearchReadyIntentHints(ctx) {
+  const hints = [
+    "Page type: SEARCH READY",
+    "Suggested: vessel_search → auto-finds search box, types query, and submits",
+    "Treat the visible site search box as the primary navigation control before jumping to direct URLs."
+  ];
+  if (ctx.flightBookingFormHint) hints.push(ctx.flightBookingFormHint);
+  return hints;
+}
+function buildSearchResultsIntentHints(ctx) {
+  const hints = [
+    "Page type: SEARCH RESULTS",
+    "Suggested: click a result link, or vessel_paginate for more results"
+  ];
+  if (ctx.hasPagination) hints.push("Pagination detected — vessel_paginate available");
+  return hints;
+}
+function buildShoppingIntentHints(_ctx) {
+  return ["Page type: SHOPPING/CHECKOUT", "Suggested: vessel_fill_form for payment/address fields"];
+}
+function buildFormIntentHints(ctx) {
+  const { page } = ctx;
+  const formCount = page.forms.length;
+  const totalFields = page.forms.reduce((n, f) => n + f.fields.length, 0);
+  const hints = [
+    `Page type: FORM (${formCount} form${formCount > 1 ? "s" : ""}, ${totalFields} fields)`,
+    "Suggested: vessel_fill_form → fill all fields in one call"
+  ];
+  if (ctx.flightBookingFormHint) hints.push(ctx.flightBookingFormHint);
+  return hints;
+}
+function buildPaginatedListIntentHints(_ctx) {
+  return ["Page type: PAGINATED LIST", "Suggested: vessel_paginate to navigate between pages"];
+}
+function buildArticleIntentHints(_ctx) {
+  return ["Page type: ARTICLE/CONTENT", "Suggested: vessel_extract_content for readable text"];
+}
+const PAGE_INTENT_BUILDERS = /* @__PURE__ */ new Map([
+  ["LOGIN", buildLoginIntentHints],
+  ["SEARCH_READY", buildSearchReadyIntentHints],
+  ["SEARCH_RESULTS", buildSearchResultsIntentHints],
+  ["SHOPPING", buildShoppingIntentHints],
+  ["FORM", buildFormIntentHints],
+  ["PAGINATED_LIST", buildPaginatedListIntentHints],
+  ["ARTICLE", buildArticleIntentHints]
+]);
 function analyzePageIntent(page) {
-  const hints = [];
   const pageType = detectPageType(page);
   const flightBookingFormHint = getFlightBookingFormHint(page);
   const hasPagination = page.interactiveElements.some(
     (el) => (el.text || "").toLowerCase() === "next" || el.text === "›" || el.text === "»" || (el.label || "").toLowerCase().includes("next page")
   );
-  switch (pageType) {
-    case "LOGIN": {
-      hints.push("Page type: LOGIN/SIGNUP");
-      hints.push(
-        "Suggested: vessel_login or vessel_fill_form → auto-fills credentials and submits"
-      );
-      const userField = page.forms.flatMap((f) => f.fields).find(
-        (el) => el.inputType === "email" || el.name === "email" || el.name === "username" || el.autocomplete === "username"
-      );
-      if (userField) {
-        hints.push(
-          `Username field: #${userField.index} [${userField.label || userField.name || userField.placeholder || "input"}]`
-        );
-      }
-      break;
-    }
-    case "SEARCH_READY":
-      hints.push("Page type: SEARCH READY");
-      hints.push(
-        "Suggested: vessel_search → auto-finds search box, types query, and submits"
-      );
-      hints.push(
-        "Treat the visible site search box as the primary navigation control before jumping to direct URLs."
-      );
-      if (flightBookingFormHint) hints.push(flightBookingFormHint);
-      break;
-    case "SEARCH_RESULTS":
-      hints.push("Page type: SEARCH RESULTS");
-      hints.push(
-        "Suggested: click a result link, or vessel_paginate for more results"
-      );
-      if (hasPagination)
-        hints.push("Pagination detected — vessel_paginate available");
-      break;
-    case "SHOPPING":
-      hints.push("Page type: SHOPPING/CHECKOUT");
-      hints.push("Suggested: vessel_fill_form for payment/address fields");
-      break;
-    case "FORM": {
-      const formCount = page.forms.length;
-      const totalFields = page.forms.reduce((n, f) => n + f.fields.length, 0);
-      hints.push(
-        `Page type: FORM (${formCount} form${formCount > 1 ? "s" : ""}, ${totalFields} fields)`
-      );
-      hints.push("Suggested: vessel_fill_form → fill all fields in one call");
-      if (flightBookingFormHint) hints.push(flightBookingFormHint);
-      break;
-    }
-    case "PAGINATED_LIST":
-      hints.push("Page type: PAGINATED LIST");
-      hints.push("Suggested: vessel_paginate to navigate between pages");
-      break;
-    case "ARTICLE":
-      hints.push("Page type: ARTICLE/CONTENT");
-      hints.push("Suggested: vessel_extract_content for readable text");
-      break;
-  }
+  const ctx = { page, flightBookingFormHint, hasPagination };
+  const builder = PAGE_INTENT_BUILDERS.get(pageType);
+  const hints = builder ? builder(ctx) : [];
   if (hints.length === 0 && !flightBookingFormHint) return "";
   if (flightBookingFormHint && pageType !== "SEARCH_READY" && pageType !== "FORM") {
     hints.push(flightBookingFormHint);
@@ -14515,9 +14456,7 @@ function buildStructuredContext(page) {
   }
   if (page.interactiveElements.length > 0) {
     sections.push("### Interactive Elements");
-    sections.push(
-      `Found ${page.interactiveElements.length} interactive elements:`
-    );
+    sections.push(`Found ${page.interactiveElements.length} interactive elements:`);
     sections.push(formatInteractiveElements(page.interactiveElements));
     sections.push("");
   }
@@ -14537,9 +14476,7 @@ function buildStructuredContext(page) {
   sections.push(
     `**Blocking Overlays:** ${page.overlays.filter((overlay) => overlay.blocksInteraction).length}`
   );
-  sections.push(
-    `**Dormant Consent / Modal UI:** ${page.dormantOverlays.length}`
-  );
+  sections.push(`**Dormant Consent / Modal UI:** ${page.dormantOverlays.length}`);
   sections.push(`**Landmarks:** ${page.landmarks.length}`);
   return sections.join("\n");
 }
@@ -23624,6 +23561,12 @@ const GroupIdSchema = zod.z.string().min(1);
 const UrlSchema = zod.z.string().min(1);
 const ColorSchema = zod.z.string().min(1);
 const FindActionSchema = zod.z.enum(["clearSelection", "keepSelection", "activateSelection"]);
+const FindTextSchema = zod.z.string().min(1).max(1e4);
+const FindOptionsSchema = zod.z.object({
+  forward: zod.z.boolean().optional(),
+  findNext: zod.z.boolean().optional()
+}).optional();
+const FindForwardSchema = zod.z.boolean().optional();
 function registerTabHandlers(windowState, _sendToRendererViews) {
   const { tabManager, mainWindow } = windowState;
   electron.ipcMain.handle(Channels.OPEN_PRIVATE_WINDOW, (event) => {
@@ -23738,16 +23681,13 @@ function registerTabHandlers(windowState, _sendToRendererViews) {
     assertTrustedIpcSender(event);
     return tabManager.toggleGroupCollapsed(parseIpc(GroupIdSchema, groupId, "groupId"));
   });
-  electron.ipcMain.handle(
-    Channels.TAB_GROUP_SET_COLOR,
-    (event, groupId, color) => {
-      assertTrustedIpcSender(event);
-      tabManager.setGroupColor(
-        parseIpc(GroupIdSchema, groupId, "groupId"),
-        parseIpc(ColorSchema, color, "color")
-      );
-    }
-  );
+  electron.ipcMain.handle(Channels.TAB_GROUP_SET_COLOR, (event, groupId, color) => {
+    assertTrustedIpcSender(event);
+    tabManager.setGroupColor(
+      parseIpc(GroupIdSchema, groupId, "groupId"),
+      parseIpc(ColorSchema, color, "color")
+    );
+  });
   electron.ipcMain.handle(Channels.TAB_TOGGLE_MUTE, (event, id) => {
     assertTrustedIpcSender(event);
     return tabManager.toggleMuted(parseIpc(TabIdSchema$1, id, "id"));
@@ -23762,7 +23702,12 @@ function registerTabHandlers(windowState, _sendToRendererViews) {
   });
   electron.ipcMain.on(Channels.TAB_CONTEXT_MENU, (event, id) => {
     assertTrustedIpcSender(event);
-    showTabContextMenu(tabManager, parseIpc(TabIdSchema$1, id, "id"), mainWindow, () => layoutViews(windowState));
+    showTabContextMenu(
+      tabManager,
+      parseIpc(TabIdSchema$1, id, "id"),
+      mainWindow,
+      () => layoutViews(windowState)
+    );
   });
   electron.ipcMain.on(Channels.TAB_GROUP_CONTEXT_MENU, (event, groupId) => {
     assertTrustedIpcSender(event);
@@ -23778,16 +23723,22 @@ function registerTabHandlers(windowState, _sendToRendererViews) {
   const findBridge = createFindInPageBridge(tabManager, windowState.chromeView);
   electron.ipcMain.handle(Channels.FIND_IN_PAGE_START, (event, text, options) => {
     assertTrustedIpcSender(event);
-    return findBridge.start(text, options);
+    return findBridge.start(
+      parseIpc(FindTextSchema, text, "text"),
+      parseIpc(FindOptionsSchema, options, "options")
+    );
   });
   electron.ipcMain.handle(Channels.FIND_IN_PAGE_NEXT, (event, forward) => {
     assertTrustedIpcSender(event);
-    return findBridge.next(forward);
-  });
-  electron.ipcMain.handle(Channels.FIND_IN_PAGE_STOP, (event, action) => {
-    assertTrustedIpcSender(event);
-    findBridge.stop(action ? parseIpc(FindActionSchema, action, "action") : void 0);
+    return findBridge.next(parseIpc(FindForwardSchema, forward, "forward"));
   });
+  electron.ipcMain.handle(
+    Channels.FIND_IN_PAGE_STOP,
+    (event, action) => {
+      assertTrustedIpcSender(event);
+      findBridge.stop(action ? parseIpc(FindActionSchema, action, "action") : void 0);
+    }
+  );
 }
 const require$1 = node_module.createRequire(require("url").pathToFileURL(__filename).href);
 const logger$l = createLogger("DevTrace");
@@ -24932,13 +24883,14 @@ function setMcpHealth(update) {
 }
 const ApprovalModeSchema = zod.z.enum(["auto", "confirm-dangerous", "manual"]);
 const CheckpointIdSchema = zod.z.string().min(1);
+const ApprovalIdSchema = zod.z.string().min(1);
+const OptionalCheckpointNameSchema = zod.z.string().trim().max(200).optional();
+const OptionalNoteSchema = zod.z.string().trim().max(2e4).optional();
+const BooleanSchema$2 = zod.z.boolean();
 const TaskTextSchema = zod.z.string().trim().min(1).max(2e4);
 const OptionalTaskTextSchema = zod.z.string().trim().max(2e4).optional();
 const OptionalNullableTaskTextSchema = zod.z.string().trim().max(2e4).nullable().optional();
-const TaskFactsSchema = zod.z.record(
-  zod.z.string().trim().min(1).max(200),
-  zod.z.string().max(2e4)
-);
+const TaskFactsSchema = zod.z.record(zod.z.string().trim().min(1).max(200), zod.z.string().max(2e4));
 const TaskMemoryPatchSchema = zod.z.object({
   nextStep: OptionalNullableTaskTextSchema,
   facts: TaskFactsSchema.optional()
@@ -24999,55 +24951,55 @@ function registerAgentRuntimeHandlers(runtime2, chromeView, sidebarView, sendToR
     Channels.AGENT_APPROVAL_RESOLVE,
     (event, approvalId, approved) => {
       assertTrustedIpcSender(event);
-      return runtime2.resolveApproval(approvalId, approved);
-    }
-  );
-  electron.ipcMain.handle(
-    Channels.AGENT_CHECKPOINT_CREATE,
-    (event, name, note) => {
-      assertTrustedIpcSender(event);
-      return runtime2.createCheckpoint(name, note);
+      return runtime2.resolveApproval(
+        parseIpc(ApprovalIdSchema, approvalId, "approvalId"),
+        parseIpc(BooleanSchema$2, approved, "approved")
+      );
     }
   );
-  electron.ipcMain.handle(Channels.AGENT_CHECKPOINT_RESTORE, (event, checkpointId) => {
+  electron.ipcMain.handle(Channels.AGENT_CHECKPOINT_CREATE, (event, name, note) => {
     assertTrustedIpcSender(event);
-    return runtime2.restoreCheckpoint(parseIpc(CheckpointIdSchema, checkpointId, "checkpointId"));
+    return runtime2.createCheckpoint(
+      name == null ? void 0 : parseIpc(OptionalCheckpointNameSchema, name, "name"),
+      note == null ? void 0 : parseIpc(OptionalNoteSchema, note, "note")
+    );
   });
-  electron.ipcMain.handle(Channels.AGENT_CHECKPOINT_UPDATE_NOTE, (event, checkpointId, note) => {
+  electron.ipcMain.handle(Channels.AGENT_CHECKPOINT_RESTORE, (event, checkpointId) => {
     assertTrustedIpcSender(event);
-    return runtime2.updateCheckpointNote(
-      parseIpc(CheckpointIdSchema, checkpointId, "checkpointId"),
-      note || ""
-    );
+    return runtime2.restoreCheckpoint(parseIpc(CheckpointIdSchema, checkpointId, "checkpointId"));
   });
+  electron.ipcMain.handle(
+    Channels.AGENT_CHECKPOINT_UPDATE_NOTE,
+    (event, checkpointId, note) => {
+      assertTrustedIpcSender(event);
+      return runtime2.updateCheckpointNote(
+        parseIpc(CheckpointIdSchema, checkpointId, "checkpointId"),
+        note == null ? "" : parseIpc(OptionalNoteSchema, note, "note")
+      );
+    }
+  );
   electron.ipcMain.handle(Channels.AGENT_UNDO_LAST_ACTION, (event) => {
     assertTrustedIpcSender(event);
     return runtime2.undoLastAction();
   });
   electron.ipcMain.handle(Channels.AGENT_SESSION_CAPTURE, (event, note) => {
     assertTrustedIpcSender(event);
-    return runtime2.captureSession(note);
+    return runtime2.captureSession(
+      note == null ? void 0 : parseIpc(OptionalNoteSchema, note, "note")
+    );
+  });
+  electron.ipcMain.handle(Channels.AGENT_SESSION_RESTORE, (event, snapshot2) => {
+    assertTrustedIpcSender(event);
+    return runtime2.restoreSession(snapshot2);
   });
-  electron.ipcMain.handle(
-    Channels.AGENT_SESSION_RESTORE,
-    (event, snapshot2) => {
-      assertTrustedIpcSender(event);
-      return runtime2.restoreSession(snapshot2);
-    }
-  );
   electron.ipcMain.handle(Channels.AGENT_TASK_START, (event, goal) => {
     assertTrustedIpcSender(event);
     return runtime2.startTaskMemory(parseIpc(TaskTextSchema, goal, "goal"));
   });
-  electron.ipcMain.handle(
-    Channels.AGENT_TASK_UPDATE,
-    (event, patch) => {
-      assertTrustedIpcSender(event);
-      return runtime2.updateTaskMemory(
-        parseIpc(TaskMemoryPatchSchema, patch ?? {}, "patch")
-      );
-    }
-  );
+  electron.ipcMain.handle(Channels.AGENT_TASK_UPDATE, (event, patch) => {
+    assertTrustedIpcSender(event);
+    return runtime2.updateTaskMemory(parseIpc(TaskMemoryPatchSchema, patch ?? {}, "patch"));
+  });
   electron.ipcMain.handle(Channels.AGENT_TASK_NOTE, (event, text) => {
     assertTrustedIpcSender(event);
     return runtime2.addTaskNote(parseIpc(TaskTextSchema, text, "text"));
@@ -31638,17 +31590,20 @@ function stopScheduler() {
 const KitIdSchema = zod.z.string().min(1);
 const SkillSourceSchema = zod.z.string().min(1).max(1e5);
 const OriginSchema = zod.z.string().min(1);
+const DownloadIdSchema = zod.z.string().min(1);
 const DevToolsHeightSchema = zod.z.number().finite().min(0).max(2e3);
+const ClearDataTimeRangeSchema = zod.z.enum(["hour", "day", "week", "month", "all"]);
+const ClearDataOptionsSchema = zod.z.object({
+  cache: zod.z.boolean(),
+  cookies: zod.z.boolean(),
+  history: zod.z.boolean(),
+  localStorage: zod.z.boolean(),
+  timeRange: ClearDataTimeRangeSchema
+});
 const DevToolsPageMapRevealSchema = zod.z.object({
   selector: zod.z.string().min(1)
 });
-const DevToolsPanelTabSchema = zod.z.enum([
-  "console",
-  "network",
-  "activity",
-  "agentTrace",
-  "pageMap"
-]);
+const DevToolsPanelTabSchema = zod.z.enum(["console", "network", "activity", "agentTrace", "pageMap"]);
 const RendererViewSchema = zod.z.enum(["chrome", "sidebar", "devtools"]);
 function registerSystemHandlers(windowState, sendToRendererViews) {
   const { tabManager } = windowState;
@@ -31783,18 +31738,11 @@ function registerSystemHandlers(windowState, sendToRendererViews) {
     }
     return await refreshDevToolsPageMap(tabManager);
   });
-  electron.ipcMain.handle(
-    Channels.DEVTOOLS_PAGE_MAP_REVEAL,
-    async (event, payload) => {
-      assertTrustedIpcSender(event);
-      const { selector } = parseIpc(
-        DevToolsPageMapRevealSchema,
-        payload,
-        "payload"
-      );
-      return await revealPageMapElement(tabManager, selector);
-    }
-  );
+  electron.ipcMain.handle(Channels.DEVTOOLS_PAGE_MAP_REVEAL, async (event, payload) => {
+    assertTrustedIpcSender(event);
+    const { selector } = parseIpc(DevToolsPageMapRevealSchema, payload, "payload");
+    return await revealPageMapElement(tabManager, selector);
+  });
   electron.ipcMain.handle(Channels.DEVTOOLS_PANEL_HOST_STATE_GET, (event) => {
     assertTrustedIpcSender(event);
     return getDevToolsPanelHostState(windowState);
@@ -31822,29 +31770,33 @@ function registerSystemHandlers(windowState, sendToRendererViews) {
   electron.ipcMain.handle(Channels.AUTOMATION_CREATE_FROM_TEXT, async (event, source) => {
     assertTrustedIpcSender(event);
     assertFeatureUnlocked("automation_kits", "Skills");
-    return await createKitFromText(
-      parseIpc(SkillSourceSchema, source, "source")
-    );
-  });
-  electron.ipcMain.handle(Channels.AUTOMATION_UPDATE_FROM_TEXT, async (event, id, source) => {
-    assertTrustedIpcSender(event);
-    assertFeatureUnlocked("automation_kits", "Skills");
-    return await updateKitFromText(
-      parseIpc(KitIdSchema, id, "id"),
-      parseIpc(SkillSourceSchema, source, "source")
-    );
+    return await createKitFromText(parseIpc(SkillSourceSchema, source, "source"));
   });
+  electron.ipcMain.handle(
+    Channels.AUTOMATION_UPDATE_FROM_TEXT,
+    async (event, id, source) => {
+      assertTrustedIpcSender(event);
+      assertFeatureUnlocked("automation_kits", "Skills");
+      return await updateKitFromText(
+        parseIpc(KitIdSchema, id, "id"),
+        parseIpc(SkillSourceSchema, source, "source")
+      );
+    }
+  );
   electron.ipcMain.handle(Channels.AUTOMATION_UNINSTALL, async (event, id) => {
     assertTrustedIpcSender(event);
     assertFeatureUnlocked("automation_kits", "Skills");
-    return await uninstallKit(
-      parseIpc(KitIdSchema, id, "id"),
-      getScheduledKitIds()
-    );
+    return await uninstallKit(parseIpc(KitIdSchema, id, "id"), getScheduledKitIds());
   });
   electron.ipcMain.handle(Channels.CLEAR_BROWSING_DATA, async (event, options) => {
     assertTrustedIpcSender(event);
-    const { cache, cookies, history, localStorage: clearLs, timeRange } = options;
+    const {
+      cache,
+      cookies,
+      history,
+      localStorage: clearLs,
+      timeRange
+    } = parseIpc(ClearDataOptionsSchema, options, "options");
     if (cache) {
       await electron.session.defaultSession.clearCache();
     }
@@ -31871,11 +31823,11 @@ function registerSystemHandlers(windowState, sendToRendererViews) {
   });
   electron.ipcMain.handle(Channels.DOWNLOADS_OPEN, (event, id) => {
     assertTrustedIpcSender(event);
-    return openDownload(id);
+    return openDownload(parseIpc(DownloadIdSchema, id, "id"));
   });
   electron.ipcMain.handle(Channels.DOWNLOADS_SHOW_IN_FOLDER, (event, id) => {
     assertTrustedIpcSender(event);
-    return showDownloadInFolder(id);
+    return showDownloadInFolder(parseIpc(DownloadIdSchema, id, "id"));
   });
   electron.ipcMain.handle(Channels.PERMISSIONS_GET, (event) => {
     assertTrustedIpcSender(event);
@@ -35111,16 +35063,15 @@ async function createSplashWindow() {
     backgroundColor: "#1a1a1e",
     webPreferences: {
       nodeIntegration: false,
-      contextIsolation: true
+      contextIsolation: true,
+      sandbox: true
     }
   });
   splash.once("ready-to-show", () => splash.show());
   const iconSrc = await findIconBase64();
   const html = buildSplashHTML(iconSrc);
   try {
-    const tmpDir = await promises.mkdtemp(
-      path.join(os.tmpdir(), "vessel-splash-")
-    );
+    const tmpDir = await promises.mkdtemp(path.join(os.tmpdir(), "vessel-splash-"));
     const tmpPath = path.join(tmpDir, "index.html");
     splash.once("closed", () => {
       void rmSafe(tmpDir);