@quanta-intellect/vessel-browser 0.1.95 → 0.1.97

package/out/main/index.js

@@ -15,6 +15,7 @@ const http$1 = require("node:http");
 const os = require("node:os");
 const mcp_js = require("@modelcontextprotocol/sdk/server/mcp.js");
 const streamableHttp_js = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+const promises = require("fs/promises");
 function getEnvFlag(name) {
   const globalProcess = typeof globalThis === "object" && "process" in globalThis ? globalThis.process : void 0;
   return globalProcess?.env?.[name];
@@ -79,7 +80,7 @@ const defaults = {
 const SAVE_DEBOUNCE_MS$6 = 150;
 const CHAT_PROVIDER_SECRET_FILENAME = "vessel-chat-provider-secret";
 const CODEX_TOKENS_FILENAME = "vessel-codex-tokens";
-const logger$n = createLogger("Settings");
+const logger$p = createLogger("Settings");
 const SETTABLE_KEYS = new Set(Object.keys(defaults));
 let settings = null;
 let settingsIssues = [];
@@ -279,7 +280,7 @@ function persistNow() {
       JSON.stringify(buildPersistedSettings(settings), null, 2),
       { encoding: "utf-8", mode: 384 }
     )
-  ).then(() => fs.promises.chmod(getSettingsPath(), 384).catch(() => void 0)).catch((err) => logger$n.error("Failed to save settings:", err));
+  ).then(() => fs.promises.chmod(getSettingsPath(), 384).catch(() => void 0)).catch((err) => logger$p.error("Failed to save settings:", err));
 }
 function saveSettings() {
   saveDirty = true;
@@ -408,7 +409,7 @@ function loadTrustedAppURL(wc, url) {
 }
 const MAX_CUSTOM_HISTORY = 50;
 const READER_MODE_DATA_URL_PREFIX = "data:text/html;charset=utf-8,";
-const logger$m = createLogger("Tab");
+const logger$o = createLogger("Tab");
 const sessionCertExceptions = /* @__PURE__ */ new WeakMap();
 const sessionsWithVerifyProc = /* @__PURE__ */ new WeakSet();
 const CERT_VERIFY_TRUST = 0;
@@ -474,7 +475,7 @@ class Tab {
   guardedLoadURL(url, options) {
     const blockReason = this.getNavigationBlockReason(url);
     if (blockReason) {
-      logger$m.warn(blockReason);
+      logger$o.warn(blockReason);
       return blockReason;
     }
     void this.view.webContents.loadURL(url, options);
@@ -558,7 +559,7 @@ class Tab {
     wc.setWindowOpenHandler(({ url, disposition }) => {
       const error = this.getNavigationBlockReason(url);
       if (error) {
-        logger$m.warn(error);
+        logger$o.warn(error);
         return { action: "deny" };
       }
       this.onOpenUrl?.({
@@ -572,7 +573,7 @@ class Tab {
       const error = this.getNavigationBlockReason(url);
       if (!error) return;
       event.preventDefault();
-      logger$m.warn(`${context}: ${error}`);
+      logger$o.warn(`${context}: ${error}`);
     };
     wc.on("will-navigate", (event, url) => {
       blockNavigation(event, url, "Blocked top-level navigation");
@@ -656,7 +657,7 @@ class Tab {
         ::-webkit-scrollbar-thumb { background: rgba(255,255,255,0.12); border-radius: 999px; }
         ::-webkit-scrollbar-thumb:hover { background: rgba(255,255,255,0.22); }
         ::-webkit-scrollbar-corner { background: transparent; }
-      `).catch((err) => logger$m.warn("Failed to inject scrollbar CSS:", err));
+      `).catch((err) => logger$o.warn("Failed to inject scrollbar CSS:", err));
     });
     wc.on("page-favicon-updated", (_, favicons) => {
       this._state.favicon = favicons[0] || "";
@@ -692,7 +693,7 @@ class Tab {
       ).then((highlightedText) => {
         this.buildContextMenu(wc, params, highlightedText.trim());
       }).catch((err) => {
-        logger$m.warn("Failed to inspect highlighted text for context menu:", err);
+        logger$o.warn("Failed to inspect highlighted text for context menu:", err);
         this.buildContextMenu(wc, params, "");
       });
     });
@@ -893,7 +894,7 @@ class Tab {
         "document.documentElement.outerHTML"
       );
     } catch (err) {
-      logger$m.warn("Failed to retrieve page source:", err);
+      logger$o.warn("Failed to retrieve page source:", err);
       return;
     }
     const escaped = html.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
@@ -1021,7 +1022,7 @@ class Tab {
             document.addEventListener('mouseup', window.__vesselHighlightHandler);
           }
         })()
-      `).catch((err) => logger$m.warn("Failed to inject highlight listener:", err));
+      `).catch((err) => logger$o.warn("Failed to inject highlight listener:", err));
     } else {
       void wc.executeJavaScript(`
         (function() {
@@ -1032,7 +1033,7 @@ class Tab {
             delete window.__vesselHighlightHandler;
           }
         })()
-      `).catch((err) => logger$m.warn("Failed to remove highlight listener:", err));
+      `).catch((err) => logger$o.warn("Failed to remove highlight listener:", err));
     }
   }
   get webContentsId() {
@@ -1069,7 +1070,7 @@ const SEARCH_ENGINE_PRESETS = {
   ecosia: { label: "Ecosia", url: "https://www.ecosia.org/search?q=" },
   kagi: { label: "Kagi", url: "https://kagi.com/search?q=" }
 };
-const logger$l = createLogger("JsonPersistence");
+const logger$n = createLogger("JsonPersistence");
 function canUseSafeStorage() {
   try {
     return electron.safeStorage.isEncryptionAvailable();
@@ -1134,7 +1135,7 @@ function createDebouncedJsonPersistence({
         data,
         typeof data === "string" ? { encoding: "utf-8", mode: 384 } : { mode: 384 }
       )
-    ).then(() => fs.promises.chmod(filePath2, 384).catch(() => void 0)).catch((err) => logger$l.error(`Failed to save ${logLabel}:`, err));
+    ).then(() => fs.promises.chmod(filePath2, 384).catch(() => void 0)).catch((err) => logger$n.error(`Failed to save ${logLabel}:`, err));
   };
   const schedule = () => {
     saveDirty2 = true;
@@ -2815,7 +2816,7 @@ function destroySession(tabId) {
     sessions.delete(tabId);
   }
 }
-const logger$k = createLogger("TabManager");
+const logger$m = createLogger("TabManager");
 function sanitizePdfFilename(title) {
   const clean = title.replace(/[<>:"/\\|?*\x00-\x1f]/g, " ").replace(/\s+/g, " ").trim();
   const base = (clean || "Vessel Page").replace(/\.pdf$/i, "");
@@ -3214,7 +3215,7 @@ class TabManager {
     }));
     if (entries.length > 0) {
       void highlightBatchOnPage(wc, entries).catch(
-        (err) => logger$k.warn("Failed to batch highlight:", err)
+        (err) => logger$m.warn("Failed to batch highlight:", err)
       );
     }
   }
@@ -3236,12 +3237,12 @@ class TabManager {
         const result = await captureSelectionHighlight(wc);
         if (result.success && result.text) {
           await highlightOnPage(wc, null, result.text, void 0, void 0, "yellow").catch(
-            (err) => logger$k.warn("Failed to capture highlight:", err)
+            (err) => logger$m.warn("Failed to capture highlight:", err)
           );
         }
         this.highlightCaptureCallback?.(result);
       } catch (err) {
-        logger$k.warn("Failed to capture highlight from page:", err);
+        logger$m.warn("Failed to capture highlight from page:", err);
         this.highlightCaptureCallback?.({
           success: false,
           message: "Could not capture selection"
@@ -3266,7 +3267,7 @@ class TabManager {
           void this.removeHighlightMarksForText(wc, text);
         }
       } catch (err) {
-        logger$k.warn("Failed to remove highlight from matching tab:", err);
+        logger$m.warn("Failed to remove highlight from matching tab:", err);
       }
     }
     this.highlightCaptureCallback?.({
@@ -3297,12 +3298,12 @@ class TabManager {
               void 0,
               color
             ).catch(
-              (err) => logger$k.warn("Failed to update highlight color:", err)
+              (err) => logger$m.warn("Failed to update highlight color:", err)
             );
           });
         }
       } catch (err) {
-        logger$k.warn("Failed to iterate highlights for color change:", err);
+        logger$m.warn("Failed to iterate highlights for color change:", err);
       }
     }
     this.highlightCaptureCallback?.({
@@ -3343,7 +3344,7 @@ class TabManager {
         });
       })()`
     ).catch(
-      (err) => logger$k.warn("Failed to remove highlight marks:", err)
+      (err) => logger$m.warn("Failed to remove highlight marks:", err)
     );
   }
   broadcastState() {
@@ -3373,6 +3374,7 @@ const Channels = {
   AI_STREAM_CHUNK: "ai:stream-chunk",
   AI_STREAM_END: "ai:stream-end",
   AI_STREAM_IDLE: "ai:stream-idle",
+  AI_RESEARCH_CLARIFICATION: "ai:research-clarification",
   AUTOMATION_ACTIVITY_START: "automation:activity-start",
   AUTOMATION_ACTIVITY_CHUNK: "automation:activity-chunk",
   AUTOMATION_ACTIVITY_END: "automation:activity-end",
@@ -3553,6 +3555,16 @@ const Channels = {
   CLEAR_BROWSING_DATA_OPEN: "browsing-data:open",
   // Picture-in-Picture
   TAB_TOGGLE_PIP: "tab:toggle-pip",
+  // Research Desk
+  RESEARCH_STATE_GET: "research:state-get",
+  RESEARCH_STATE_UPDATE: "research:state-update",
+  RESEARCH_START_BRIEF: "research:start-brief",
+  RESEARCH_CONFIRM_BRIEF: "research:confirm-brief",
+  RESEARCH_APPROVE_OBJECTIVES: "research:approve-objectives",
+  RESEARCH_SET_MODE: "research:set-mode",
+  RESEARCH_SET_TRACES: "research:set-traces",
+  RESEARCH_CANCEL: "research:cancel",
+  RESEARCH_EXPORT_REPORT: "research:export-report",
   // Codex OAuth
   CODEX_START_AUTH: "codex:start-auth",
   CODEX_CANCEL_AUTH: "codex:cancel-auth",
@@ -4522,7 +4534,7 @@ function errorResult(error, value) {
 function getErrorMessage(error, fallback = "Unknown error") {
   return error instanceof Error && error.message ? error.message : fallback;
 }
-const logger$j = createLogger("Premium");
+const logger$l = createLogger("Premium");
 const VERIFICATION_API = process.env.VESSEL_PREMIUM_API || "https://vesselpremium.quantaintellect.com";
 const FREE_TOOL_ITERATION_LIMIT = 50;
 const REVALIDATION_INTERVAL_MS = 24 * 60 * 60 * 1e3;
@@ -4562,7 +4574,10 @@ const PREMIUM_TOOLS = /* @__PURE__ */ new Set([
   "vault_totp",
   "human_vault_list",
   "human_vault_fill",
-  "human_vault_remove"
+  "human_vault_remove",
+  "research_confirm_brief",
+  "research_approve_objectives",
+  "research_export_report"
 ]);
 function isPremium() {
   const { premium } = loadSettings();
@@ -4638,7 +4653,7 @@ async function verifySubscription$1(identifier) {
     });
     if (!res.ok) {
       const detail = await readApiErrorDetail(res);
-      logger$j.warn(
+      logger$l.warn(
         "Verification API returned a non-OK status:",
         res.status,
         detail
@@ -4657,7 +4672,7 @@ async function verifySubscription$1(identifier) {
     setSetting("premium", updated);
     return updated;
   } catch (err) {
-    logger$j.warn("Verification failed:", err);
+    logger$l.warn("Verification failed:", err);
     return current;
   }
 }
@@ -5262,7 +5277,7 @@ const EXTRACT_TIMEOUT_MAX_MS = 2e4;
 const MUTATION_CAPTURE_INTERVAL_MS = 5e3;
 const MUTATION_SETTLE_AFTER_MS = 1500;
 const AGENT_STREAM_IDLE_TIMEOUT_MS = 3e4;
-const logger$i = createLogger("Extractor");
+const logger$k = createLogger("Extractor");
 const EMPTY_PAGE_CONTENT = {
   title: "",
   content: "",
@@ -5988,7 +6003,8 @@ async function waitForDomReady(webContents, timeoutMs = DEFAULT_PAGE_SCRIPT_TIME
       (function() {
         return document.readyState || "";
       })()
-    `
+    `,
+      { label: "ready-state" }
     );
     if (readyState === "interactive" || readyState === "complete") {
       return;
@@ -5996,7 +6012,7 @@ async function waitForDomReady(webContents, timeoutMs = DEFAULT_PAGE_SCRIPT_TIME
     await delay(75);
   }
 }
-async function executeScript(webContents, script) {
+async function executeScript(webContents, script, options = {}) {
   if (webContents.isDestroyed()) {
     return null;
   }
@@ -6012,7 +6028,15 @@ async function executeScript(webContents, script) {
       })
     ]);
   } catch (err) {
-    logger$i.warn("Failed to execute page script:", err);
+    const label = options.label ? ` (${options.label})` : "";
+    const url = webContents.getURL() || "unknown URL";
+    const message = err instanceof Error ? err.message : String(err);
+    const detail = `Failed to execute page script${label} on ${url}: ${message}`;
+    if (options.warnOnFailure) {
+      logger$k.warn(detail);
+    } else {
+      logger$k.debug(detail);
+    }
     return null;
   } finally {
     if (timer) {
@@ -6109,7 +6133,8 @@ async function estimateExtractionTimeout(webContents) {
   try {
     const elementCount = await executeScript(
       webContents,
-      `(function() { try { return document.querySelectorAll('*').length; } catch { return 0; } })()`
+      `(function() { try { return document.querySelectorAll('*').length; } catch { return 0; } })()`,
+      { label: "element-count" }
     );
     if (typeof elementCount === "number" && elementCount > 5e3) {
       const extra = Math.min(
@@ -6119,15 +6144,19 @@ async function estimateExtractionTimeout(webContents) {
       return EXTRACT_TIMEOUT_BASE_MS + extra;
     }
   } catch (err) {
-    logger$i.warn("Failed to estimate extraction timeout, using base timeout:", err);
+    logger$k.warn("Failed to estimate extraction timeout, using base timeout:", err);
   }
   return EXTRACT_TIMEOUT_BASE_MS;
 }
 async function extractContentInner(webContents) {
   await waitForDomReady(webContents);
   const [preloadResult, directResult] = await Promise.all([
-    executeScript(webContents, PRELOAD_EXTRACTION_SCRIPT),
-    executeScript(webContents, DIRECT_EXTRACTION_SCRIPT)
+    executeScript(webContents, PRELOAD_EXTRACTION_SCRIPT, {
+      label: "preload-extraction"
+    }),
+    executeScript(webContents, DIRECT_EXTRACTION_SCRIPT, {
+      label: "direct-extraction"
+    })
   ]);
   return mergePageContent(
     [preloadResult, directResult],
@@ -7007,6 +7036,7 @@ function isClickReadLoop(names) {
   }
   return clickReadPairs >= 2;
 }
+const TERMINAL_TOOL_RESULT = "__VESSEL_TERMINAL_TOOL_RESULT__";
 const ANTHROPIC_MAX_TOKENS = 4096;
 function isRecord$1(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -7210,6 +7240,9 @@ class AnthropicProvider {
             const msg = toolErr instanceof Error ? toolErr.message : String(toolErr);
             result = `Error: Tool execution failed — ${msg}. Try a different approach or call read_page to refresh context.`;
           }
+          if (result === TERMINAL_TOOL_RESULT) {
+            return;
+          }
           let parsedRich = null;
           try {
             const parsed = JSON.parse(result);
@@ -7478,7 +7511,7 @@ const MAX_MCP_NAV_CONTENT_LENGTH = 3e4;
 const MAX_AGENT_DEBUG_CONTENT_LENGTH = 2e4;
 const LLAMA_CPP_MIN_CTX_TOKENS = 16384;
 const LLAMA_CPP_RECOMMENDED_CTX_TOKENS = 32768;
-const logger$h = createLogger("OpenAIProvider");
+const logger$j = createLogger("OpenAIProvider");
 function shouldDebugAgentLoop() {
   const value = process.env.VESSEL_DEBUG_AGENT_LOOP;
   return value === "1" || value === "true";
@@ -8003,9 +8036,9 @@ function resolveToolCallName(rawName, args, availableToolNames) {
 function logAgentLoopDebug(payload) {
   if (!shouldDebugAgentLoop()) return;
   try {
-    logger$h.info(`[agent-debug] ${JSON.stringify(payload)}`);
+    logger$j.info(`[agent-debug] ${JSON.stringify(payload)}`);
   } catch (err) {
-    logger$h.warn("Failed to serialize debug payload:", err);
+    logger$j.warn("Failed to serialize debug payload:", err);
   }
 }
 function recoverTextEncodedToolCalls(text, availableToolNames) {
@@ -8476,6 +8509,9 @@ class OpenAICompatProvider {
             const msg = toolErr instanceof Error ? toolErr.message : String(toolErr);
             result = `Error: Tool execution failed — ${msg}. Try a different approach or call read_page to refresh context.`;
           }
+          if (result === TERMINAL_TOOL_RESULT) {
+            return;
+          }
           let toolContent = result;
           try {
             const parsed = JSON.parse(result);
@@ -8553,7 +8589,7 @@ async function openExternalAllowlisted(url, rule) {
   }
   await electron.shell.openExternal(parsed.toString());
 }
-const logger$g = createLogger("CodexOAuth");
+const logger$i = createLogger("CodexOAuth");
 const ISSUER = "https://auth.openai.com";
 const CLIENT_ID = "app_EMoamEEZ73f0CkXaXp7hrann";
 const SCOPE = "openid profile email offline_access api.connectors.read api.connectors.invoke";
@@ -8802,7 +8838,7 @@ async function startCodexOAuth(onStatus) {
       try {
         onStatus(status, error);
       } catch {
-        logger$g.warn("Codex OAuth status callback failed — window may be closed");
+        logger$i.warn("Codex OAuth status callback failed — window may be closed");
       }
     };
     const wrappedResolve = (tokens) => {
@@ -8842,7 +8878,7 @@ async function startCodexOAuth(onStatus) {
       const authUrl = buildAuthorizeUrl(port, pkce, state2);
       safeOnStatus("waiting");
       openExternalAllowlisted(authUrl, { hosts: ["auth.openai.com"] }).catch((err) => {
-        logger$g.warn("Failed to open browser, user will need the URL:", err);
+        logger$i.warn("Failed to open browser, user will need the URL:", err);
       });
     }).catch(wrappedReject);
   });
@@ -8854,11 +8890,11 @@ function cancelCodexOAuth() {
   try {
     activeFlow.onStatus("idle");
   } catch {
-    logger$g.warn("Codex OAuth cancel status callback failed — window may be closed");
+    logger$i.warn("Codex OAuth cancel status callback failed — window may be closed");
   }
   activeFlow = null;
 }
-const logger$f = createLogger("CodexProvider");
+const logger$h = createLogger("CodexProvider");
 const REFRESH_WINDOW_MS = 5 * 60 * 1e3;
 const CODEX_BACKEND_BASE_URL = "https://chatgpt.com/backend-api/codex";
 const CODEX_CLIENT_VERSION = "0.129.0";
@@ -8901,6 +8937,9 @@ async function createCodexFunctionCallOutput(functionCall, availableToolNames, o
     };
   }
   const output = await onToolCall(name, args);
+  if (output === TERMINAL_TOOL_RESULT) {
+    return { terminal: true };
+  }
   return {
     type: "function_call_output",
     call_id: callId,
@@ -8920,7 +8959,7 @@ class CodexProvider {
   async ensureFreshTokens() {
     if (Date.now() < this.tokens.expiresAt - REFRESH_WINDOW_MS) return;
     try {
-      logger$f.info("Refreshing Codex access token");
+      logger$h.info("Refreshing Codex access token");
       const fresh = await refreshAccessToken(this.tokens);
       this.tokens = fresh;
       writeStoredCodexTokens(fresh);
@@ -9068,7 +9107,7 @@ class CodexProvider {
     } catch (err) {
       if (err.name !== "AbortError") {
         const msg = err instanceof Error ? err.message : String(err);
-        logger$f.error("Codex streamQuery error:", err);
+        logger$h.error("Codex streamQuery error:", err);
         onChunk(`
 
 [Error: ${msg}]`);
@@ -9116,14 +9155,16 @@ class CodexProvider {
         }
         currentInput = [];
         for (const fc of functionCalls) {
-          currentInput.push(
-            await createCodexFunctionCallOutput(
-              fc,
-              availableToolNames,
-              onChunk,
-              onToolCall
-            )
+          const output = await createCodexFunctionCallOutput(
+            fc,
+            availableToolNames,
+            onChunk,
+            onToolCall
           );
+          if ("terminal" in output) {
+            return;
+          }
+          currentInput.push(output);
         }
       }
       if (iterationsUsed >= maxIterations) {
@@ -9134,7 +9175,7 @@ class CodexProvider {
     } catch (err) {
       if (err.name !== "AbortError") {
         const msg = err instanceof Error ? err.message : String(err);
-        logger$f.error("Codex streamAgentQuery error:", err);
+        logger$h.error("Codex streamAgentQuery error:", err);
         onChunk(`
 
 [Error: ${msg}]`);
@@ -9326,7 +9367,7 @@ function createProvider(config) {
   return new OpenAICompatProvider(normalized);
 }
 const require$1 = node_module.createRequire(require("url").pathToFileURL(__filename).href);
-const logger$e = createLogger("DevTrace");
+const logger$g = createLogger("DevTrace");
 let cachedFactory;
 function createNoopTraceSession() {
   return {
@@ -9359,7 +9400,7 @@ function loadLocalFactory() {
         return cachedFactory;
       }
     } catch (err) {
-      logger$e.warn("Failed to load local trace logger:", err);
+      logger$g.warn("Failed to load local trace logger:", err);
     }
   }
   return cachedFactory;
@@ -13478,7 +13519,7 @@ function formatDeadLinkMessage(label, result) {
   const status = result.statusCode ? `HTTP ${result.statusCode}` : "dead link";
   return `Skipped stale link "${label}" because ${destination} returned ${status}. Try a different link or URL instead.`;
 }
-const logger$d = createLogger("Screenshot");
+const logger$f = createLogger("Screenshot");
 const SCREENSHOT_RETRY_COUNT = 3;
 const SCREENSHOT_RETRY_BASE_DELAY_MS = 120;
 async function captureScreenshot(wc) {
@@ -13500,7 +13541,7 @@ async function captureScreenshot(wc) {
         }
       }
     } catch (err) {
-      logger$d.debug(
+      logger$f.debug(
         `capturePage attempt ${attempt + 1} failed; retrying if attempts remain.`,
         getErrorMessage(err)
       );
@@ -14374,7 +14415,15 @@ function buildHuggingFaceSearchShortcut(currentUrl, rawQuery) {
     appliedFilters
   };
 }
-const logger$c = createLogger("PageActions");
+class TabMutex {
+  queue = Promise.resolve();
+  enqueue(fn) {
+    return new Promise((resolve, reject) => {
+      this.queue = this.queue.then(fn).then(resolve, reject);
+    });
+  }
+}
+const logger$e = createLogger("PageActions");
 function getBookmarkMetadataFromArgs(args) {
   return normalizeBookmarkMetadata({
     intent: args.intent ?? args.intent,
@@ -14560,7 +14609,7 @@ async function executePageScript(wc, script, options) {
     return result;
   } catch (err) {
     const label = options?.label ? ` (${options.label})` : "";
-    logger$c.warn(`Failed to execute page script${label}:`, err);
+    logger$e.warn(`Failed to execute page script${label}:`, err);
     return null;
   } finally {
     if (timer) {
@@ -14661,7 +14710,7 @@ Search results snapshot:
 ${truncated}`;
     }
   } catch (err) {
-    logger$c.warn("Failed to build post-search summary, falling back to nav summary:", err);
+    logger$e.warn("Failed to build post-search summary, falling back to nav summary:", err);
   }
   const fallback = await getPostNavSummary(wc);
   return fallback ? `${fallback}
@@ -14684,7 +14733,7 @@ Page snapshot after navigation:
 ${truncated}`;
     }
   } catch (err) {
-    logger$c.warn("Failed to build post-click navigation summary:", err);
+    logger$e.warn("Failed to build post-click navigation summary:", err);
   }
   return "";
 }
@@ -15178,7 +15227,7 @@ async function restoreLocaleSnapshot(wc, snapshot2) {
       }
     }
   } catch (err) {
-    logger$c.warn("Failed to restore locale via history navigation, trying URL reload fallback:", err);
+    logger$e.warn("Failed to restore locale via history navigation, trying URL reload fallback:", err);
   }
   if (snapshot2.url && snapshot2.url !== wc.getURL()) {
     try {
@@ -15187,7 +15236,7 @@ async function restoreLocaleSnapshot(wc, snapshot2) {
       await waitForLoad(wc, 3e3);
       return;
     } catch (err) {
-      logger$c.warn("Failed to restore locale via safe URL load, trying page reload fallback:", err);
+      logger$e.warn("Failed to restore locale via safe URL load, trying page reload fallback:", err);
     }
   }
   if (snapshot2.url) {
@@ -15195,7 +15244,7 @@ async function restoreLocaleSnapshot(wc, snapshot2) {
       await wc.reload();
       await waitForLoad(wc, 3e3);
     } catch (err) {
-      logger$c.warn("Failed to restore locale via page reload:", err);
+      logger$e.warn("Failed to restore locale via page reload:", err);
     }
   }
 }
@@ -15547,7 +15596,7 @@ ${postActivationOverlayHint}`;
           return `${clickText} -> ${hrefFallbackUrl} (recovered via href fallback)`;
         }
       } catch (err) {
-        logger$c.warn("Failed href fallback after click, returning generic click result:", err);
+        logger$e.warn("Failed href fallback after click, returning generic click result:", err);
       }
     }
   }
@@ -15592,7 +15641,7 @@ async function tryAutoDismissCartDialog(wc) {
       return result;
     }
   } catch (err) {
-    logger$c.warn("Failed to auto-dismiss cart dialog, falling back to dialog actions:", err);
+    logger$e.warn("Failed to auto-dismiss cart dialog, falling back to dialog actions:", err);
   }
   return null;
 }
@@ -17536,6 +17585,19 @@ const KNOWN_TOOLS = /* @__PURE__ */ new Set([
 ]);
 async function executeAction(name, args, ctx) {
   name = normalizeToolAlias(name);
+  if (ctx.tabId && ctx._tabMutex) {
+    return ctx._tabMutex.enqueue(async () => {
+      const prevActiveId = ctx.tabManager.getActiveTabId();
+      if (prevActiveId !== ctx.tabId) ctx.tabManager.switchTab(ctx.tabId);
+      try {
+        return await executeAction(name, args, { ...ctx, tabId: void 0, _tabMutex: void 0 });
+      } finally {
+        if (prevActiveId && prevActiveId !== ctx.tabId) {
+          ctx.tabManager.switchTab(prevActiveId);
+        }
+      }
+    });
+  }
   if (!KNOWN_TOOLS.has(name)) {
     for (const known of KNOWN_TOOLS) {
       if (name.startsWith(known) && name.length > known.length) {
@@ -17862,7 +17924,7 @@ async function executeAction(name, args, ctx) {
               )
             ]);
           } catch (err) {
-            logger$c.warn("Failed to extract content for read_page, falling back to lighter recovery:", err);
+            logger$e.warn("Failed to extract content for read_page, falling back to lighter recovery:", err);
             content = null;
           }
           if (!content || content.content.length === 0) {
@@ -17879,12 +17941,12 @@ async function executeAction(name, args, ctx) {
                     new Promise((resolve) => setTimeout(() => resolve(null), 3e3))
                   ]);
                 } catch (err) {
-                  logger$c.warn("Failed to re-extract content after iframe consent dismissal:", err);
+                  logger$e.warn("Failed to re-extract content after iframe consent dismissal:", err);
                   content = null;
                 }
               }
             } catch (err) {
-              logger$c.warn("Failed iframe consent dismissal during read_page recovery:", err);
+              logger$e.warn("Failed iframe consent dismissal during read_page recovery:", err);
             }
           }
           if (content && content.content.length > 0) {
@@ -18297,7 +18359,7 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
           try {
             page = await extractContent(wc);
           } catch (err) {
-            logger$c.warn("Failed to extract content for suggest:", err);
+            logger$e.warn("Failed to extract content for suggest:", err);
             return "Could not read page. Try navigate to a working URL.";
           }
           const suggestions = [];
@@ -18685,7 +18747,80 @@ WARNING: You have clicked ${clickStreakCount} elements on this page without veri
   }
   return formattedResult + await getPostActionState$1(ctx, name) + clickNavSummary + streakWarning + flowCtx;
 }
-async function handleAIQuery(query, provider, activeWebContents, onChunk, onEnd, tabManager, runtime2, history) {
+function buildOrchestratorSystemPrompt() {
+  return `You are the Research Captain of Vessel. You orchestrate deep research on behalf of the user.
+
+YOUR ROLE:
+You are accountable for the final Research Report. The report has YOUR name on it. You do not blindly accept sub-agent findings — you review, challenge, and demand more when needed. You are the captain, and the sub-agents are your crew.
+
+CORE PRINCIPLES:
+- You OWN the research question end-to-end. If the answer is insufficient, you dig deeper.
+- Every factual claim in your final report MUST be backed by a specific source URL and extracted quote. No citation = the claim does not survive synthesis.
+- You are authoritative but honest. Flag contradictions and gaps explicitly. Never invent to fill a hole.
+
+BRIEF PHASE:
+Your first job is to interview the user. Ask one question at a time, and for EVERY question you MUST provide 2–6 concrete answer choices as a bullet list so the user can click instead of typing. Cover:
+- What exactly do they want to know?
+- How deep? How many sources?
+- Who is the report for? Technical or layperson?
+- Any domains to prefer or avoid?
+- What does a good answer look like?
+
+If the user's question is vague, switch into EXPLORATION MODE: proactively suggest 2–3 concrete research angles they might be interested in. Help them discover what they actually want to know.
+
+Never ask a bare question without listed options. Every assistant turn must end with a question and concrete answer choices.
+
+You CANNOT navigate or use tools during the brief. The brief is dialogue only. When you are confident you have enough context, summarize what you heard and ask the user to confirm before moving to planning.
+
+PLANNING PHASE:
+After the brief is confirmed, produce a structured Research Objectives document with 2–5 independent threads. Each thread gets a specific question, suggested search queries, and a source budget. Present this as a clear, structured card for the user to review, edit, or approve.
+
+EXECUTION PHASE:
+Sub-agents run in parallel, each handling one thread. You monitor their progress. If a thread stalls or produces thin findings, rebalance — reassign effort, ask the sub-agent to dig deeper, or spawn a replacement.
+
+SYNTHESIS PHASE:
+Before writing the report, self-audit: "Do I have enough to answer the research question? Am I confident in every claim?" If not, request more from sub-agents.
+
+Write the report with:
+- An executive summary
+- One section per thread with sourced claims
+- Explicit contradictions and gaps
+- A numbered source index
+
+Never use emojis. Be concise. Be precise.`;
+}
+async function handleAIQuery(query, provider, activeWebContents, onChunk, onEnd, tabManager, runtime2, history, researchOrchestrator) {
+  if (researchOrchestrator) {
+    const researchState = researchOrchestrator.getState();
+    if (researchState.phase === "briefing" || researchState.phase === "planning") {
+      const isPlanning = researchState.phase === "planning";
+      const phaseInstruction = isPlanning ? "\n\nNow produce the Research Objectives based on the brief conversation above. Output them as a JSON object with researchQuestion, threads (array of {label, question, searchQueries, sourceBudget}), audience, reportOutline, and totalSourceBudget fields." : "\n\nContinue the briefing interview. You MUST end every assistant turn with one concise question AND 2–6 concrete answer choices formatted as bullet points (e.g. `- Option one`). Never ask a bare question without listed options. Each option should read like something the user could click as their answer. Do not browse, plan the report, or write a prose preamble.";
+      let fullResponse = "";
+      const wrappedOnChunk = (text) => {
+        fullResponse += text;
+        if (text) onChunk(text);
+      };
+      const wrappedOnEnd = () => {
+        if (isPlanning) {
+          const parsed = researchOrchestrator.parseAndSetObjectives(fullResponse);
+          if (!parsed) {
+            onChunk(
+              "\n\n[Failed to parse objectives. Please try confirming the brief again or refine your research question.]"
+            );
+          }
+        }
+        onEnd();
+      };
+      await provider.streamQuery(
+        buildOrchestratorSystemPrompt() + phaseInstruction,
+        query,
+        wrappedOnChunk,
+        wrappedOnEnd,
+        history
+      );
+      return;
+    }
+  }
   const lowerQuery = query.toLowerCase().trim();
   const isSummarize = lowerQuery.startsWith("summarize") || lowerQuery.startsWith("tldr") || lowerQuery === "summary";
   if (provider.streamAgentQuery && tabManager && activeWebContents && runtime2) {
@@ -19622,7 +19757,7 @@ Exception: ${result.exceptionDetails}`);
     }
   );
 }
-const logger$b = createLogger("VaultShared");
+const logger$d = createLogger("VaultShared");
 const ALGORITHM = "aes-256-gcm";
 const IV_LENGTH = 12;
 const AUTH_TAG_LENGTH = 16;
@@ -19716,7 +19851,7 @@ function createVaultIO(vaultFilename, encrypt2, decrypt2) {
       cachedEntries = JSON.parse(json);
       return cachedEntries;
     } catch (err) {
-      logger$b.error("Failed to load vault:", err);
+      logger$d.error("Failed to load vault:", err);
       throw new Error("Could not unlock the vault. Check OS secret storage availability.");
     }
   }
@@ -19799,7 +19934,7 @@ function createAuditLog(filename, maxEntries) {
       } catch {
       }
     } catch (err) {
-      logger$b.error("Failed to write audit log:", err);
+      logger$d.error("Failed to write audit log:", err);
     }
   }
   function readAuditLog2(limit = 100) {
@@ -19809,7 +19944,7 @@ function createAuditLog(filename, maxEntries) {
       const lines = fs$1.readFileSync(auditPath, "utf-8").split("\n").filter((l) => l.trim());
       return lines.slice(-Math.min(limit, maxEntries)).map((line) => JSON.parse(line)).reverse();
     } catch (err) {
-      logger$b.error("Failed to read audit log:", err);
+      logger$d.error("Failed to read audit log:", err);
       return [];
     }
   }
@@ -19913,7 +20048,7 @@ async function requestConsent(request) {
 }
 const AUDIT_FILENAME = "vessel-vault-audit.jsonl";
 const MAX_ENTRIES = 1e3;
-const logger$a = createLogger("VaultAudit");
+const logger$c = createLogger("VaultAudit");
 function getAuditPath() {
   return path$1.join(electron.app.getPath("userData"), AUDIT_FILENAME);
 }
@@ -19927,7 +20062,7 @@ function appendAuditEntry(entry) {
     });
     fs$1.chmodSync(auditPath, 384);
   } catch (err) {
-    logger$a.error("Failed to write audit log:", err);
+    logger$c.error("Failed to write audit log:", err);
   }
 }
 function readAuditLog$1(limit = 100) {
@@ -19937,7 +20072,7 @@ function readAuditLog$1(limit = 100) {
     const lines = fs$1.readFileSync(auditPath, "utf-8").split("\n").filter((l) => l.trim());
     return lines.slice(-Math.min(limit, MAX_ENTRIES)).map((line) => JSON.parse(line)).reverse();
   } catch (err) {
-    logger$a.error("Failed to read audit log:", err);
+    logger$c.error("Failed to read audit log:", err);
     return [];
   }
 }
@@ -20105,7 +20240,7 @@ async function requestHumanVaultConsent(request) {
 }
 let httpServer = null;
 let mcpAuthToken = null;
-const logger$9 = createLogger("MCP");
+const logger$b = createLogger("MCP");
 const MCP_AUTH_FILENAME = "mcp-auth.json";
 function getMcpAuthFilePath() {
   const configDir = process.env.VESSEL_CONFIG_DIR || path$1.join(
@@ -20142,7 +20277,7 @@ function writeMcpAuthFile(endpoint, token) {
     );
     fs$1.chmodSync(filePath2, 384);
   } catch (err) {
-    logger$9.warn("Failed to write auth file:", err);
+    logger$b.warn("Failed to write auth file:", err);
   }
 }
 function clearMcpAuthFile() {
@@ -20168,7 +20303,7 @@ function clearMcpAuthFile() {
     );
     fs$1.chmodSync(filePath2, 384);
   } catch (err) {
-    logger$9.warn("Failed to clear auth file:", err);
+    logger$b.warn("Failed to clear auth file:", err);
   }
 }
 function regenerateMcpAuthToken() {
@@ -20270,7 +20405,7 @@ async function getPostActionState(tabManager, name) {
         }
       }
     } catch (err) {
-      logger$9.warn("Failed to compute post-action state warning:", err);
+      logger$b.warn("Failed to compute post-action state warning:", err);
     }
     return `${warning}
 [state: url=${wc.getURL()}, canGoBack=${tab.canGoBack()}, canGoForward=${tab.canGoForward()}, loading=${wc.isLoading()}]`;
@@ -20373,7 +20508,7 @@ async function waitForConditionMcp(wc, text, selector, timeoutMs) {
         }
       })()
     `).catch((err) => {
-      logger$9.warn("Failed to gather wait_for timeout diagnostic:", err);
+      logger$b.warn("Failed to gather wait_for timeout diagnostic:", err);
       return null;
     });
     if (typeof diagnostic === "string" && diagnostic.trim()) {
@@ -20460,7 +20595,7 @@ function registerTools(server, tabManager, runtime2) {
           const page = await extractContent(wc);
           pageType = detectPageType(page);
         } catch (err) {
-          logger$9.warn("Failed to detect page type for tool scoring, falling back to GENERAL:", err);
+          logger$b.warn("Failed to detect page type for tool scoring, falling back to GENERAL:", err);
         }
       }
       const scored = TOOL_DEFINITIONS.map((def) => {
@@ -21858,7 +21993,7 @@ ${JSON.stringify(otherHighlights, null, 2)}`
             void 0,
             h.color
           ).catch(
-            (err) => logger$9.warn("Failed to restore highlight after removal:", err)
+            (err) => logger$b.warn("Failed to restore highlight after removal:", err)
           );
         }
       }
@@ -22706,7 +22841,7 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
       try {
         page = await extractContent(wc);
       } catch (err) {
-        logger$9.warn("Failed to extract page while generating suggestions:", err);
+        logger$b.warn("Failed to extract page while generating suggestions:", err);
         return asTextResponse(
           "Could not read page. Try navigate to a working URL."
         );
@@ -23315,7 +23450,7 @@ ${JSON.stringify(tableJson, null, 2)}`;
         try {
           targetDomain = new URL(tab.state.url).hostname;
         } catch (err) {
-          logger$9.warn("Failed to parse active tab URL for vault_status:", err);
+          logger$b.warn("Failed to parse active tab URL for vault_status:", err);
           return asErrorTextResponse("Could not parse active tab URL");
         }
       }
@@ -23381,7 +23516,7 @@ Use vault_login to fill the login form. Credentials are filled directly — you
       try {
         hostname = new URL(tab.state.url).hostname;
       } catch (err) {
-        logger$9.warn("Failed to parse active tab URL for vault_login:", err);
+        logger$b.warn("Failed to parse active tab URL for vault_login:", err);
         return asErrorTextResponse("Could not parse active tab URL");
       }
       const matches = findEntriesForDomain(`https://${hostname}`);
@@ -23475,7 +23610,7 @@ Use vault_login to fill the login form. Credentials are filled directly — you
       try {
         hostname = new URL(tab.state.url).hostname;
       } catch (err) {
-        logger$9.warn("Failed to parse active tab URL for vault_totp:", err);
+        logger$b.warn("Failed to parse active tab URL for vault_totp:", err);
         return asErrorTextResponse("Could not parse active tab URL");
       }
       const matches = findEntriesForDomain(`https://${hostname}`);
@@ -23815,7 +23950,7 @@ function startMcpServer(tabManager, runtime2, port) {
         await mcpServer.connect(transport);
         await transport.handleRequest(req, res);
       } catch (error) {
-        logger$9.error("Error handling request:", error);
+        logger$b.error("Error handling request:", error);
         if (!res.headersSent) {
           res.writeHead(500, { "Content-Type": "application/json" });
           res.end(
@@ -23834,7 +23969,7 @@ function startMcpServer(tabManager, runtime2, port) {
     };
     server.once("error", (error) => {
       const message = error.code === "EADDRINUSE" ? `Port ${port} is already in use. MCP server not started.` : error.message;
-      logger$9.error("Server error:", error);
+      logger$b.error("Server error:", error);
       clearMcpAuthFile();
       setMcpHealth({
         configuredPort: port,
@@ -23866,7 +24001,7 @@ function startMcpServer(tabManager, runtime2, port) {
         message: `MCP server listening on ${endpoint}.`
       });
       if (process.env.VESSEL_DEBUG_MCP === "1" || process.env.VESSEL_DEBUG_MCP === "true") {
-        logger$9.info(`Server listening on ${endpoint} (auth enabled)`);
+        logger$b.info(`Server listening on ${endpoint} (auth enabled)`);
       }
       if (mcpAuthToken) {
         writeMcpAuthFile(endpoint, mcpAuthToken);
@@ -23905,7 +24040,7 @@ function stopMcpServer() {
         message: "MCP server is stopped."
       });
       if (process.env.VESSEL_DEBUG_MCP === "1" || process.env.VESSEL_DEBUG_MCP === "true") {
-        logger$9.info("Server stopped");
+        logger$b.info("Server stopped");
       }
       resolve();
     });
@@ -23926,7 +24061,7 @@ const KIT_ID_UNSAFE_CHAR_PATTERN = /[\/\\\0]/;
 function isSafeAutomationKitId(id) {
   return id.length > 0 && !KIT_ID_UNSAFE_CHAR_PATTERN.test(id);
 }
-const logger$8 = createLogger("KitRegistry");
+const logger$a = createLogger("KitRegistry");
 function getUserKitsDir() {
   return path$1.join(electron.app.getPath("userData"), "kits");
 }
@@ -23964,10 +24099,10 @@ function getInstalledKits() {
       if (isValidKit(parsed)) {
         kits.push(parsed);
       } else {
-        logger$8.warn(`Skipping invalid kit file: ${file}`);
+        logger$a.warn(`Skipping invalid kit file: ${file}`);
       }
     } catch (err) {
-      logger$8.warn(`Failed to read kit file: ${file}`, err);
+      logger$a.warn(`Failed to read kit file: ${file}`, err);
     }
   }
   return kits;
@@ -24076,7 +24211,7 @@ function getActiveTabInfo(tabManager) {
   if (wc.isDestroyed()) return null;
   return { tab, wc };
 }
-const logger$7 = createLogger("Scheduler");
+const logger$9 = createLogger("Scheduler");
 let jobs = [];
 let removeIdleListener = null;
 let broadcastFn = null;
@@ -24107,7 +24242,7 @@ function saveJobs() {
     });
     fs$1.chmodSync(jobsPath, 384);
   } catch (err) {
-    logger$7.warn("Failed to save jobs:", err);
+    logger$9.warn("Failed to save jobs:", err);
   }
 }
 function normalizeJob(job, now = /* @__PURE__ */ new Date()) {
@@ -24229,7 +24364,7 @@ async function fireJob(job, windowState, runtime2) {
   };
   startActivity();
   if (!settings2.chatProvider) {
-    logger$7.warn(`Job "${job.kitName}" skipped — no chat provider configured`);
+    logger$9.warn(`Job "${job.kitName}" skipped — no chat provider configured`);
     appendActivity(
       "Chat provider not configured. Open Settings (Ctrl+,) to choose a provider."
     );
@@ -24237,7 +24372,7 @@ async function fireJob(job, windowState, runtime2) {
     return;
   }
   if (process.env.VESSEL_DEBUG_SCHEDULER === "1" || process.env.VESSEL_DEBUG_SCHEDULER === "true") {
-    logger$7.info(`Firing scheduled job: ${job.kitName} (${job.id})`);
+    logger$9.info(`Firing scheduled job: ${job.kitName} (${job.id})`);
   }
   try {
     const provider = createProvider(settings2.chatProvider);
@@ -24290,7 +24425,7 @@ function tick(windowState, runtime2) {
     saveJobs();
     broadcastFn?.(Channels.SCHEDULE_JOBS_UPDATE, jobs);
     void fireJob(job, windowState, runtime2).catch((err) => {
-      logger$7.warn("Unexpected error firing job:", err);
+      logger$9.warn("Unexpected error firing job:", err);
     }).finally(fireNext);
   };
   fireNext();
@@ -24812,6 +24947,777 @@ function registerPageDiffHandlers(windowState, sendToRendererViews) {
     schedulePageSnapshotCapture(wc, sendToRendererViews);
   });
 }
+function renderReportAsMarkdown(report, traces) {
+  const sections = [];
+  sections.push(`# ${report.title}`);
+  sections.push("");
+  sections.push(`*Generated: ${report.generatedAt}*`);
+  sections.push("");
+  sections.push("## Executive Summary");
+  sections.push(report.executiveSummary);
+  sections.push("");
+  for (const section of report.findingsByThread) {
+    sections.push(`## ${section.threadLabel}`);
+    sections.push(section.content);
+    sections.push("");
+  }
+  if (report.contradictions.length > 0) {
+    sections.push("## Contradictions & Discrepancies");
+    for (const c of report.contradictions) {
+      sections.push(`- **Claim:** ${c.claim}`);
+      sections.push(`  - Source A: [${c.sourceA.url}](${c.sourceA.url}) — "${c.sourceA.claim}"`);
+      sections.push(`  - Source B: [${c.sourceB.url}](${c.sourceB.url}) — "${c.sourceB.claim}"`);
+      sections.push(`  - **Resolution:** ${c.resolution}`);
+    }
+    sections.push("");
+  }
+  if (report.gaps.length > 0) {
+    sections.push("## Gaps & Unanswered Questions");
+    for (const gap of report.gaps) {
+      sections.push(`- ${gap}`);
+    }
+    sections.push("");
+  }
+  sections.push("## Source Index");
+  for (const source of report.sourceIndex) {
+    sections.push(
+      `${source.index}. [${source.title}](${source.url}) — accessed ${source.accessedAt}`
+    );
+    sections.push(`   > "${source.supportingQuote}"`);
+  }
+  sections.push("");
+  if (traces && traces.length > 0) {
+    sections.push("---");
+    sections.push("");
+    sections.push("## Appendix: Agent Traces");
+    for (const trace of traces) {
+      sections.push(`### ${trace.threadLabel}`);
+      sections.push(`Started: ${trace.startedAt} | Finished: ${trace.finishedAt}`);
+      sections.push(`Tool calls: ${trace.toolCalls.length}`);
+      if (trace.errors.length > 0) {
+        sections.push(`Errors: ${trace.errors.length}`);
+        for (const err of trace.errors) {
+          sections.push(`- [${err.timestamp}] ${err.message}`);
+        }
+      }
+      sections.push("");
+    }
+  }
+  return sections.join("\n");
+}
+const logger$8 = createLogger("ResearchIPC");
+function registerResearchHandlers(getOrchestrator) {
+  electron.ipcMain.handle(Channels.RESEARCH_STATE_GET, () => {
+    return getOrchestrator().getState();
+  });
+  electron.ipcMain.handle(
+    Channels.RESEARCH_START_BRIEF,
+    async (_event, query) => {
+      try {
+        const trimmedQuery = query.trim();
+        if (!trimmedQuery) {
+          return { accepted: false, reason: "error" };
+        }
+        if (getOrchestrator().getState().phase !== "idle") {
+          return { accepted: false, reason: "busy" };
+        }
+        await getOrchestrator().startBrief(trimmedQuery);
+        return { accepted: true };
+      } catch (err) {
+        logger$8.error("RESEARCH_START_BRIEF failed", err);
+        return { accepted: false, reason: "error" };
+      }
+    }
+  );
+  electron.ipcMain.handle(Channels.RESEARCH_CONFIRM_BRIEF, () => {
+    try {
+      if (isToolGated("research_confirm_brief")) {
+        return { accepted: false, reason: "premium" };
+      }
+      const orchestrator = getOrchestrator();
+      if (orchestrator.getState().phase !== "briefing") {
+        return { accepted: false, reason: "error" };
+      }
+      orchestrator.confirmBrief();
+      return { accepted: true };
+    } catch (err) {
+      logger$8.error("RESEARCH_CONFIRM_BRIEF failed", err);
+      return { accepted: false, reason: "error" };
+    }
+  });
+  electron.ipcMain.handle(
+    Channels.RESEARCH_APPROVE_OBJECTIVES,
+    (_event, options) => {
+      try {
+        if (isToolGated("research_approve_objectives")) {
+          return { accepted: false, reason: "premium" };
+        }
+        const orchestrator = getOrchestrator();
+        const state2 = orchestrator.getState();
+        if (state2.phase !== "awaiting_approval" || !state2.objectives) {
+          return { accepted: false, reason: "error" };
+        }
+        orchestrator.approveObjectives(
+          options.supervisionMode,
+          options.includeTraces
+        );
+        orchestrator.executeSubAgents().catch((err) => {
+          logger$8.error("Background sub-agent execution failed", err);
+        });
+        return { accepted: true };
+      } catch (err) {
+        logger$8.error("RESEARCH_APPROVE_OBJECTIVES failed", err);
+        return { accepted: false, reason: "error" };
+      }
+    }
+  );
+  electron.ipcMain.handle(
+    Channels.RESEARCH_SET_MODE,
+    (_event, mode) => {
+      getOrchestrator().setSupervisionMode(mode);
+    }
+  );
+  electron.ipcMain.handle(
+    Channels.RESEARCH_SET_TRACES,
+    (_event, include) => {
+      getOrchestrator().setIncludeTraces(include);
+    }
+  );
+  electron.ipcMain.handle(Channels.RESEARCH_CANCEL, () => {
+    getOrchestrator().cancel();
+  });
+  electron.ipcMain.handle(Channels.RESEARCH_EXPORT_REPORT, async () => {
+    try {
+      if (isToolGated("research_export_report")) {
+        return { accepted: false, reason: "premium" };
+      }
+      const state2 = getOrchestrator().getState();
+      if (!state2.report) {
+        return { accepted: false, reason: "error", error: "No report to export" };
+      }
+      const markdown = renderReportAsMarkdown(
+        state2.report,
+        state2.includeTraces ? state2.subAgentTraces : void 0
+      );
+      const { filePath: filePath2, canceled } = await electron.dialog.showSaveDialog({
+        title: "Export Research Report",
+        defaultPath: `${state2.report.title.replace(/[^a-zA-Z0-9 _-]/g, "")}.md`,
+        filters: [
+          { name: "Markdown", extensions: ["md"] },
+          { name: "All Files", extensions: ["*"] }
+        ]
+      });
+      if (canceled || !filePath2) {
+        return { accepted: false, reason: "cancelled" };
+      }
+      await promises.writeFile(filePath2, markdown, "utf-8");
+      return { accepted: true, savedPath: filePath2 };
+    } catch (err) {
+      logger$8.error("RESEARCH_EXPORT_REPORT failed", err);
+      return { accepted: false, reason: "error" };
+    }
+  });
+}
+function buildSubAgentSystemPrompt(thread) {
+  const domainBlock = thread.blockedDomains.length > 0 ? `
+BLOCKED DOMAINS (never visit): ${thread.blockedDomains.join(", ")}` : "";
+  const domainPref = thread.preferredDomains.length > 0 ? `
+PREFERRED DOMAINS: ${thread.preferredDomains.join(", ")}` : "";
+  return `You are a Vessel research sub-agent assigned to a specific thread.
+
+YOUR MISSION: ${thread.question}
+
+SEARCH QUERIES TO START WITH:
+${thread.searchQueries.map((q) => `- ${q}`).join("\n")}${domainPref}${domainBlock}
+
+SOURCE BUDGET: You may visit up to ${thread.sourceBudget} sources. Do not exceed this unless the captain explicitly increases it.
+
+RULES:
+1. Every finding you report MUST include the source URL and the verbatim extracted quote that supports it.
+2. Never fabricate. If you cannot find an answer, say so.
+3. Stay on your thread. Do not wander into other research angles.
+4. Report findings incrementally. After visiting each source, report what you found.
+5. If a page is behind a paywall or requires login, note it and move on.
+6. Prefer primary sources over secondary commentary.
+7. Do not use emojis.
+
+When done, report a summary of your execution: pages visited, useful sources found, discarded sources, any errors.`;
+}
+function buildSynthesisPrompt(objectives, findings) {
+  const findingsBlock = findings.map(
+    (f) => `
+### Thread: ${f.threadLabel}
+Question: ${f.threadQuestion}
+Execution: ${f.executionSummary}
+
+Claims:
+${f.claims.map(
+      (c, i) => `${i + 1}. ${c.claim}
+   Source: ${c.sourceUrl}
+   Title: ${c.sourceTitle}
+   Accessed: ${c.extractedAt}
+   Quote: "${c.extractedQuote}"
+   Relevance: ${c.relevanceNote}`
+    ).join("\n")}
+
+${f.discardedSources.length > 0 ? `Discarded sources:
+${f.discardedSources.map((d) => `- ${d.url}: ${d.reason}`).join("\n")}` : ""}`
+  ).join("\n\n---\n");
+  return `Synthesize the following research findings into a structured JSON Research Report.
+
+RESEARCH QUESTION: ${objectives.researchQuestion}
+AUDIENCE: ${objectives.audience}
+EXPECTED OUTLINE:
+${objectives.reportOutline.map((s) => `- ${s}`).join("\n")}
+
+FINDINGS:
+${findingsBlock}
+
+Return ONLY valid JSON — no markdown, no code fences, no commentary. The JSON object must have these exact fields:
+
+{
+  "title": "Report title (string)",
+  "executiveSummary": "2-3 paragraph answer to the research question",
+  "findingsByThread": [
+    { "threadLabel": "Label", "content": "Section content with claims and numbered citations [1], [2], etc." }
+  ],
+  "contradictions": [
+    {
+      "claim": "The disputed claim",
+      "sourceA": { "url": "https://...", "claim": "What source A says" },
+      "sourceB": { "url": "https://...", "claim": "What source B says" },
+      "resolution": "How to resolve the contradiction (or why it cannot be resolved)"
+    }
+  ],
+  "gaps": ["Gap or unanswered question 1", "Gap 2"],
+  "sourceIndex": [
+    {
+      "index": 1,
+      "url": "https://...",
+      "title": "Page title",
+      "accessedAt": "ISO timestamp from claim metadata",
+      "supportingQuote": "Verbatim quote from the claim"
+    }
+  ]
+}
+
+RULES:
+1. Every factual claim MUST cite its source using the numbered index format [1], [2], etc.
+2. The sourceIndex numbers must correspond to the [n] citations in the text.
+3. Do not invent anything. Only use claims from the findings above.
+4. Omit empty arrays entirely (contradictions, gaps) — do not include "contradictions": [] if there are none.
+5. Do not use emojis.`;
+}
+const logger$7 = createLogger("ResearchOrchestrator");
+const MAX_THREADS = 5;
+function clone$1(value) {
+  return structuredClone(value);
+}
+class ResearchOrchestrator {
+  constructor(provider, tabManager, runtime2) {
+    this.provider = provider;
+    this.tabManager = tabManager;
+    this.runtime = runtime2;
+    this.state = this.initialState();
+  }
+  provider;
+  tabManager;
+  runtime;
+  state;
+  updateListener = null;
+  // ── state access ──────────────────────────────────────────────
+  initialState() {
+    return {
+      phase: "idle",
+      supervisionMode: "interactive",
+      includeTraces: false,
+      objectives: null,
+      threads: [],
+      threadFindings: [],
+      report: null,
+      subAgentTraces: [],
+      error: null,
+      startedAt: null,
+      originalQuery: null
+    };
+  }
+  getState() {
+    return clone$1(this.state);
+  }
+  setUpdateListener(listener) {
+    this.updateListener = listener;
+    if (listener) listener(this.getState());
+  }
+  emit() {
+    if (this.updateListener) this.updateListener(this.getState());
+  }
+  setPhase(phase) {
+    this.state.phase = phase;
+    this.emit();
+  }
+  // ── supervision / config ──────────────────────────────────────
+  setSupervisionMode(mode) {
+    this.state.supervisionMode = mode;
+    this.emit();
+  }
+  setIncludeTraces(include) {
+    this.state.includeTraces = include;
+    this.emit();
+  }
+  cancel() {
+    this.state = this.initialState();
+    this.emit();
+  }
+  /**
+   * Swap the AI provider used by this orchestrator.
+   * Safe to call while research is in progress — running sub-agents
+   * pick up the new provider on their next LLM call.
+   */
+  setProvider(provider) {
+    this.provider = provider;
+  }
+  getProvider() {
+    if (!this.provider) {
+      throw new Error("Chat provider not configured - required for Research Desk");
+    }
+    return this.provider;
+  }
+  // ── phase: idle → briefing ────────────────────────────────────
+  async startBrief(userQuery) {
+    const query = userQuery.trim();
+    if (!query) {
+      logger$7.warn("Ignoring empty Research Desk query");
+      return;
+    }
+    if (this.state.phase !== "idle") {
+      logger$7.warn("Research already in progress, ignoring startBrief");
+      return;
+    }
+    this.state = this.initialState();
+    this.state.originalQuery = query;
+    this.state.startedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.setPhase("briefing");
+    logger$7.info(`Brief started for query: ${query.slice(0, 120)}`);
+  }
+  // ── phase: briefing → planning ─────────────────────────────────
+  confirmBrief() {
+    if (this.state.phase !== "briefing") {
+      logger$7.warn("Not in briefing phase, ignoring confirmBrief");
+      return;
+    }
+    this.setPhase("planning");
+  }
+  // ── phase: planning → awaiting_approval ────────────────────────
+  setObjectives(objectives) {
+    if (this.state.phase !== "planning") {
+      logger$7.warn("Not in planning phase, ignoring setObjectives");
+      return;
+    }
+    this.state.objectives = objectives;
+    this.state.threads = objectives.threads.slice(0, MAX_THREADS);
+    this.setPhase("awaiting_approval");
+  }
+  /**
+   * Parse a planning-phase LLM response into ResearchObjectives.
+   * Expects JSON (optionally wrapped in ```json fences).
+   * Returns true if parsing succeeded and objectives were set.
+   */
+  parseAndSetObjectives(text) {
+    if (this.state.phase !== "planning") return false;
+    let json = text;
+    const fenceMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fenceMatch) {
+      json = fenceMatch[1].trim();
+    } else {
+      const objMatch = text.match(/\{[\s\S]*\}/);
+      if (objMatch) json = objMatch[0];
+    }
+    try {
+      const parsed = JSON.parse(json);
+      if (typeof parsed.researchQuestion !== "string" || !parsed.researchQuestion.trim()) {
+        logger$7.warn("Missing researchQuestion in objectives JSON");
+        return false;
+      }
+      if (!Array.isArray(parsed.threads) || parsed.threads.length === 0) {
+        logger$7.warn("Missing or empty threads array in objectives JSON");
+        return false;
+      }
+      const threads = parsed.threads.map((t, i) => {
+        const obj = t;
+        const question = String(obj.question || "").trim();
+        const searchQueries = Array.isArray(obj.searchQueries) ? obj.searchQueries.map((q) => String(q).trim()).filter(Boolean) : [];
+        const sourceBudget = typeof obj.sourceBudget === "number" && Number.isFinite(obj.sourceBudget) ? Math.max(1, Math.floor(obj.sourceBudget)) : 5;
+        return {
+          label: String(obj.label || `Thread ${i + 1}`),
+          question,
+          searchQueries,
+          preferredDomains: Array.isArray(obj.preferredDomains) ? obj.preferredDomains.map((d) => String(d).trim()).filter(Boolean) : [],
+          blockedDomains: Array.isArray(obj.blockedDomains) ? obj.blockedDomains.map((d) => String(d).trim()).filter(Boolean) : [],
+          sourceBudget
+        };
+      }).filter((thread) => thread.question && thread.searchQueries.length > 0).slice(0, MAX_THREADS);
+      if (threads.length === 0) {
+        logger$7.warn("Objectives JSON did not contain any valid research threads");
+        return false;
+      }
+      const objectives = {
+        researchQuestion: String(parsed.researchQuestion).trim(),
+        threads,
+        audience: String(parsed.audience || "general").trim(),
+        reportOutline: Array.isArray(parsed.reportOutline) ? parsed.reportOutline.map((s) => String(s).trim()).filter(Boolean) : [],
+        totalSourceBudget: threads.reduce((sum, t) => sum + t.sourceBudget, 0)
+      };
+      this.setObjectives(objectives);
+      logger$7.info(`Parsed ${objectives.threads.length} threads from objectives`);
+      return true;
+    } catch (err) {
+      logger$7.warn("Failed to parse objectives JSON", err);
+      return false;
+    }
+  }
+  // ── phase: awaiting_approval → executing ───────────────────────
+  approveObjectives(mode, includeTraces) {
+    if (this.state.phase !== "awaiting_approval") {
+      logger$7.warn("Not awaiting approval, ignoring approveObjectives");
+      return;
+    }
+    if (mode) this.state.supervisionMode = mode;
+    if (includeTraces !== void 0) this.state.includeTraces = includeTraces;
+    this.setPhase("executing");
+  }
+  // ── phase: executing → synthesizing ────────────────────────────
+  async executeSubAgents() {
+    if (this.state.phase !== "executing" || !this.state.objectives) return;
+    const tabMutex = new TabMutex();
+    const results = await Promise.all(
+      this.state.threads.map((thread) => {
+        if (this.state.phase !== "executing") return null;
+        return this.runSubAgent(thread, tabMutex).catch((err) => {
+          logger$7.error(`Sub-agent "${thread.label}" failed`, err);
+          return {
+            threadLabel: thread.label,
+            threadQuestion: thread.question,
+            claims: [],
+            discardedSources: [],
+            executionSummary: `Failed: ${String(err)}`
+          };
+        });
+      })
+    );
+    if (this.state.phase !== "executing") return;
+    this.state.threadFindings = results.filter((f) => f !== null);
+    this.setPhase("synthesizing");
+    try {
+      await this.synthesizeReport();
+    } catch (err) {
+      logger$7.error("Auto-synthesis failed", err);
+      this.state.error = `Synthesis failed: ${String(err)}`;
+      this.setPhase("delivered");
+    }
+  }
+  // ── sub-agent loop ─────────────────────────────────────────────
+  async runSubAgent(thread, tabMutex) {
+    const trace = {
+      threadLabel: thread.label,
+      toolCalls: [],
+      errors: [],
+      startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      finishedAt: ""
+    };
+    const tabId = this.tabManager.createTab();
+    let sourcesConsumed = 0;
+    if (tabId) this.tabManager.switchTab(tabId);
+    const discardedSources = [];
+    let transcript = "";
+    try {
+      const provider = this.getProvider();
+      if (!provider.streamAgentQuery) {
+        throw new Error("Provider does not support agent tool loops");
+      }
+      const systemPrompt = buildSubAgentSystemPrompt(thread);
+      const userMessage = `Begin researching: ${thread.question}
+
+Start by searching for: ${thread.searchQueries.join(" or ")}`;
+      const actionCtx = {
+        tabManager: this.tabManager,
+        runtime: this.runtime,
+        toolProfile: provider.agentToolProfile,
+        tabId: tabId ?? void 0,
+        _tabMutex: tabMutex
+      };
+      await provider.streamAgentQuery(
+        systemPrompt,
+        userMessage,
+        AGENT_TOOLS,
+        (chunk) => {
+          transcript += chunk;
+        },
+        async (name, args) => {
+          const t0 = Date.now();
+          if (this.state.phase !== "executing") {
+            const msg = "Research cancelled — stopping.";
+            return msg;
+          }
+          if (name === "navigate" || name === "search") {
+            sourcesConsumed++;
+            if (sourcesConsumed > thread.sourceBudget) {
+              const msg = `Source budget (${thread.sourceBudget}) exceeded. Summarize findings and stop.`;
+              trace.toolCalls.push({
+                tool: name,
+                args,
+                result: msg,
+                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                durationMs: 0
+              });
+              return msg;
+            }
+          }
+          try {
+            const output = await executeAction(name, args, actionCtx);
+            trace.toolCalls.push({
+              tool: name,
+              args,
+              result: output,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              durationMs: Date.now() - t0
+            });
+            return output;
+          } catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes("paywall") || msg.includes("login required") || msg.includes("403")) {
+              discardedSources.push({
+                url: String(args.url || ""),
+                title: String(args.url || "unknown"),
+                reason: msg
+              });
+            }
+            trace.errors.push({
+              message: msg,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString()
+            });
+            trace.toolCalls.push({
+              tool: name,
+              args,
+              result: `Error: ${msg}`,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+              durationMs: Date.now() - t0
+            });
+            return `Error: ${msg}`;
+          }
+        },
+        () => {
+        }
+      );
+    } catch (err) {
+      trace.errors.push({
+        message: String(err),
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    } finally {
+      trace.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+      if (tabId) {
+        try {
+          this.tabManager.closeTab(tabId);
+        } catch (err) {
+          logger$7.warn(`Failed to close sub-agent tab ${tabId}`, err);
+        }
+      }
+    }
+    let claims = [];
+    if (this.state.phase === "executing") {
+      try {
+        claims = await this.extractClaimsFromTranscript(thread, transcript);
+      } catch (err) {
+        logger$7.warn(`Claim extraction failed for "${thread.label}"`, err);
+      }
+    }
+    if (this.state.phase === "executing" && this.state.includeTraces) {
+      this.state.subAgentTraces.push(trace);
+    }
+    const pagesVisited = trace.toolCalls.filter(
+      (t) => ["navigate", "read_page", "search"].includes(t.tool)
+    ).length;
+    return {
+      threadLabel: thread.label,
+      threadQuestion: thread.question,
+      claims,
+      discardedSources,
+      executionSummary: `Visited ${pagesVisited} pages (${trace.toolCalls.length} tool calls, ${sourcesConsumed} sources). ${claims.length} claims extracted. ${discardedSources.length} sources discarded.${trace.errors.length > 0 ? ` ${trace.errors.length} errors.` : ""}`
+    };
+  }
+  /**
+   * Extract structured claims from the sub-agent's research transcript.
+   * Makes a follow-up LLM call asking it to parse claims with source URLs and quotes.
+   */
+  async extractClaimsFromTranscript(thread, transcript) {
+    if (!transcript.trim()) return [];
+    const prompt = `You are a claim extractor. Given a research transcript, extract every factual claim along with its source URL and the exact supporting quote from the page.
+
+CRITICAL RULES:
+- Only extract claims that are explicitly supported by a source URL AND a verbatim quote in the transcript.
+- If a claim has no source URL or no extracted quote, do NOT include it.
+- Do not fabricate claims. Only use what is explicitly stated in the transcript.
+- Return ONLY valid JSON — a JSON array of claim objects.
+
+Each claim object must have these fields:
+- claim: the factual claim text
+- sourceUrl: the URL of the source page
+- sourceTitle: the title of the source page (or "Unknown" if not mentioned)
+- extractedQuote: the verbatim quote from the page that supports this claim
+- relevanceNote: a one-sentence note on why this claim matters to the research question
+
+Return format:
+\`\`\`json
+[{"claim": "...", "sourceUrl": "...", "sourceTitle": "...", "extractedQuote": "...", "relevanceNote": "..."}]
+\`\`\`
+
+RESEARCH QUESTION: ${thread.question}
+THREAD LABEL: ${thread.label}
+
+TRANSCRIPT:
+${transcript.slice(0, 32e3)}`;
+    let response = "";
+    await this.getProvider().streamQuery(
+      prompt,
+      "Extract the claims.",
+      (chunk) => {
+        response += chunk;
+      },
+      () => {
+      }
+    );
+    let json = response;
+    const fenceMatch = response.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fenceMatch) json = fenceMatch[1].trim();
+    else {
+      const arrMatch = response.match(/\[[\s\S]*\]/);
+      if (arrMatch) json = arrMatch[0];
+    }
+    try {
+      const raw = JSON.parse(json);
+      if (!Array.isArray(raw)) return [];
+      return raw.map((item) => {
+        const c = item;
+        return {
+          claim: String(c.claim || "").trim(),
+          sourceUrl: String(c.sourceUrl || "").trim(),
+          sourceTitle: String(c.sourceTitle || c.sourceUrl || "Unknown").trim(),
+          extractedQuote: String(c.extractedQuote || "").trim(),
+          extractedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          threadLabel: thread.label,
+          relevanceNote: String(c.relevanceNote || "").trim()
+        };
+      }).filter(
+        (claim) => claim.claim && claim.sourceUrl && claim.extractedQuote
+      );
+    } catch {
+      logger$7.warn(`Failed to parse claims JSON for "${thread.label}"`);
+      return [];
+    }
+  }
+  // ── phase: synthesizing → delivered ───────────────────────────
+  async synthesizeReport() {
+    if (this.state.phase !== "synthesizing" || !this.state.objectives) {
+      return null;
+    }
+    const objectives = this.state.objectives;
+    const findings = this.state.threadFindings;
+    const synthesisPrompt = buildSynthesisPrompt(objectives, findings);
+    let response = "";
+    await this.getProvider().streamQuery(
+      synthesisPrompt,
+      "Return ONLY the JSON object now.",
+      (chunk) => {
+        response += chunk;
+      },
+      () => {
+      }
+    );
+    const report = this.parseReportFromJson(response, objectives);
+    this.setReport(report);
+    this.setPhase("delivered");
+    return report;
+  }
+  /**
+   * Parse the LLM's JSON synthesis response into a structured ResearchReport.
+   * Handles both bare JSON and JSON wrapped in markdown fences.
+   */
+  parseReportFromJson(text, objectives) {
+    let json = text.trim();
+    const fenceMatch = json.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fenceMatch) json = fenceMatch[1].trim();
+    const objMatch = json.match(/\{[\s\S]*\}/);
+    if (objMatch) json = objMatch[0];
+    try {
+      const parsed = JSON.parse(json);
+      return {
+        title: String(parsed.title || objectives.researchQuestion).trim(),
+        executiveSummary: String(parsed.executiveSummary || "").trim(),
+        findingsByThread: Array.isArray(parsed.findingsByThread) ? parsed.findingsByThread.map((s) => {
+          const obj = s;
+          return {
+            threadLabel: String(obj.threadLabel || "").trim(),
+            content: String(obj.content || "").trim()
+          };
+        }) : [],
+        contradictions: Array.isArray(parsed.contradictions) ? parsed.contradictions.map((c) => {
+          const obj = c;
+          const sourceA = obj.sourceA ?? {};
+          const sourceB = obj.sourceB ?? {};
+          return {
+            claim: String(obj.claim || "").trim(),
+            sourceA: {
+              url: String(sourceA.url || "").trim(),
+              claim: String(sourceA.claim || "").trim()
+            },
+            sourceB: {
+              url: String(sourceB.url || "").trim(),
+              claim: String(sourceB.claim || "").trim()
+            },
+            resolution: String(obj.resolution || "").trim()
+          };
+        }).filter(
+          (c) => c.claim && c.sourceA.url && c.sourceB.url && c.resolution
+        ) : [],
+        gaps: Array.isArray(parsed.gaps) ? parsed.gaps.map((g) => String(g).trim()).filter(Boolean) : [],
+        sourceIndex: Array.isArray(parsed.sourceIndex) ? parsed.sourceIndex.map((s) => {
+          const obj = s;
+          return {
+            index: typeof obj.index === "number" ? obj.index : parseInt(String(obj.index), 10) || 0,
+            url: String(obj.url || "").trim(),
+            title: String(obj.title || "").trim(),
+            accessedAt: String(obj.accessedAt || "").trim(),
+            supportingQuote: String(obj.supportingQuote || "").trim()
+          };
+        }).filter((s) => s.url && s.title) : [],
+        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        objectives
+      };
+    } catch (err) {
+      logger$7.warn("Failed to parse synthesis JSON, using minimal report", err);
+      return {
+        title: objectives.researchQuestion,
+        executiveSummary: `Report generation failed: ${String(err)}`,
+        findingsByThread: [],
+        contradictions: [],
+        gaps: ["Report generation failed — JSON parsing error"],
+        sourceIndex: [],
+        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        objectives
+      };
+    }
+  }
+  // ── report management ──────────────────────────────────────────
+  setReport(report) {
+    this.state.report = report;
+    this.emit();
+  }
+  // ── reset ──────────────────────────────────────────────────────
+  reset() {
+    this.state = this.initialState();
+    this.emit();
+  }
+}
 function registerVaultHandlers() {
   electron.ipcMain.handle(Channels.VAULT_LIST, (event) => {
     assertTrustedIpcSender(event);
@@ -26676,6 +27582,18 @@ function registerIpcHandlers(windowState, runtime2) {
   const requireTrusted = (event) => {
     assertTrustedIpcSender(event);
   };
+  let researchOrchestrator = null;
+  const getResearchOrchestrator = () => {
+    if (!researchOrchestrator) {
+      const settings2 = loadSettings();
+      const provider = settings2.chatProvider ? createProvider(settings2.chatProvider) : null;
+      researchOrchestrator = new ResearchOrchestrator(provider, tabManager, runtime2);
+      researchOrchestrator.setUpdateListener((state2) => {
+        sendToRendererViews(Channels.RESEARCH_STATE_UPDATE, state2);
+      });
+    }
+    return researchOrchestrator;
+  };
   electron.ipcMain.handle(Channels.OPEN_PRIVATE_WINDOW, (event) => {
     requireTrusted(event);
     createPrivateWindow();
@@ -26944,7 +27862,8 @@ function registerIpcHandlers(windowState, runtime2) {
           () => sendToRendererViews(Channels.AI_STREAM_END, "completed"),
           tabManager,
           runtime2,
-          history
+          history,
+          researchOrchestrator
         );
       } catch (err) {
         const msg = err instanceof Error ? err.message : "Unknown error";
@@ -27111,6 +28030,12 @@ function registerIpcHandlers(windowState, runtime2) {
       await stopMcpServer();
       await startMcpServer(tabManager, runtime2, updatedSettings.mcpPort);
     }
+    if (key2 === "chatProvider" && researchOrchestrator) {
+      try {
+        researchOrchestrator.setProvider(createProvider(value));
+      } catch {
+      }
+    }
     const rendererSettings = getRendererSettings();
     sendToRendererViews(Channels.SETTINGS_UPDATE, rendererSettings);
     return rendererSettings;
@@ -27318,6 +28243,7 @@ function registerIpcHandlers(windowState, runtime2) {
   registerScheduleHandlers(windowState, runtime2, sendToRendererViews);
   registerAutofillHandlers(windowState);
   registerPageDiffHandlers(windowState, sendToRendererViews);
+  registerResearchHandlers(() => getResearchOrchestrator());
   electron.ipcMain.handle(Channels.CLEAR_BROWSING_DATA, async (event, options) => {
     requireTrusted(event);
     const { cache, cookies, history, localStorage: clearLs, timeRange } = options;
@@ -27764,6 +28690,10 @@ ${lines.join("\n")}
 }
 const MAX_TRANSCRIPT_TEXT_LENGTH = 8e3;
 const PERSIST_DEBOUNCE_MS = 500;
+const INTERRUPTED_ACTION_STATUSES = /* @__PURE__ */ new Set([
+  "running",
+  "waiting-approval"
+]);
 const logger$3 = createLogger("Runtime");
 function clone(value) {
   return JSON.parse(JSON.stringify(value));
@@ -27786,6 +28716,15 @@ function getRuntimeStatePath() {
   return path$1.join(electron.app.getPath("userData"), "vessel-agent-runtime.json");
 }
 function sanitizePersistence(persisted) {
+  const recoveredAt = (/* @__PURE__ */ new Date()).toISOString();
+  const actions = Array.isArray(persisted?.actions) ? persisted.actions.slice(-120).map(
+    (action) => INTERRUPTED_ACTION_STATUSES.has(action.status) ? {
+      ...action,
+      status: "failed",
+      finishedAt: action.finishedAt ?? recoveredAt,
+      error: action.error ?? "Action was interrupted before the previous Vessel session ended."
+    } : action
+  ) : [];
   return {
     session: persisted?.session ?? null,
     supervisor: {
@@ -27794,7 +28733,7 @@ function sanitizePersistence(persisted) {
       pendingApprovals: [],
       lastError: persisted?.supervisor?.lastError
     },
-    actions: Array.isArray(persisted?.actions) ? persisted.actions.slice(-120) : [],
+    actions,
     checkpoints: Array.isArray(persisted?.checkpoints) ? persisted.checkpoints.slice(-20) : [],
     transcript: [],
     mcpStatus: "stopped",