@quanta-intellect/vessel-browser 0.1.97 → 0.1.101

package/out/main/index.js

@@ -65,6 +65,7 @@ const defaults = {
   chatProvider: null,
   maxToolIterations: 200,
   domainPolicy: { allowedDomains: [], blockedDomains: [] },
+  sourceDoNotAllowList: [],
   downloadPath: "",
   telemetryEnabled: true,
   defaultSearchEngine: "duckduckgo",
@@ -231,6 +232,11 @@ function sanitizePort(value) {
 function sanitizeReasoningEffortLevel$1(value) {
   return value === "low" || value === "medium" || value === "high" || value === "max" || value === "off" ? value : "off";
 }
+function sanitizeStringList(value) {
+  return Array.isArray(value) ? Array.from(
+    new Set(value.map((item) => String(item).trim()).filter(Boolean))
+  ) : [];
+}
 function sanitizeChatProvider(provider) {
   return provider ? {
     ...provider,
@@ -252,6 +258,9 @@ function loadSettings() {
         mergeChatProviderSecret(parsed.chatProvider ?? null)
       ),
       mcpPort: sanitizePort(parsed.mcpPort ?? defaults.mcpPort),
+      sourceDoNotAllowList: sanitizeStringList(
+        parsed.sourceDoNotAllowList ?? defaults.sourceDoNotAllowList
+      ),
       agentTranscriptMode: parsed.agentTranscriptMode === "off" || parsed.agentTranscriptMode === "summary" || parsed.agentTranscriptMode === "full" ? parsed.agentTranscriptMode : parsed.showAgentTranscript === false ? "off" : defaults.agentTranscriptMode
     };
   } catch (error) {
@@ -296,6 +305,8 @@ function setSetting(key2, value) {
   loadSettings();
   if (key2 === "mcpPort") {
     settings.mcpPort = sanitizePort(value);
+  } else if (key2 === "sourceDoNotAllowList") {
+    settings.sourceDoNotAllowList = sanitizeStringList(value);
   } else if (key2 === "chatProvider") {
     const nextProvider = value;
     if (!nextProvider) {
@@ -3564,6 +3575,7 @@ const Channels = {
   RESEARCH_SET_MODE: "research:set-mode",
   RESEARCH_SET_TRACES: "research:set-traces",
   RESEARCH_CANCEL: "research:cancel",
+  RESEARCH_STOP_AND_SYNTHESIZE: "research:stop-and-synthesize",
   RESEARCH_EXPORT_REPORT: "research:export-report",
   // Codex OAuth
   CODEX_START_AUTH: "codex:start-auth",
@@ -25086,6 +25098,9 @@ function registerResearchHandlers(getOrchestrator) {
   electron.ipcMain.handle(Channels.RESEARCH_CANCEL, () => {
     getOrchestrator().cancel();
   });
+  electron.ipcMain.handle(Channels.RESEARCH_STOP_AND_SYNTHESIZE, () => {
+    getOrchestrator().stopAndSynthesizeCurrentFindings();
+  });
   electron.ipcMain.handle(Channels.RESEARCH_EXPORT_REPORT, async () => {
     try {
       if (isToolGated("research_export_report")) {
@@ -25213,6 +25228,96 @@ const MAX_THREADS = 5;
 function clone$1(value) {
   return structuredClone(value);
 }
+function normalizeSourceDomain(value) {
+  const trimmed = value.trim().toLowerCase();
+  if (!trimmed) return "";
+  try {
+    return new URL(
+      trimmed.includes("://") ? trimmed : `https://${trimmed}`
+    ).hostname.replace(/^www\./, "");
+  } catch {
+    return trimmed.replace(/^www\./, "");
+  }
+}
+function mergeBlockedSourceDomains(thread) {
+  const globalBlocked = loadSettings().sourceDoNotAllowList.map(normalizeSourceDomain).filter(Boolean);
+  if (globalBlocked.length === 0) return thread;
+  const blockedDomains = Array.from(
+    /* @__PURE__ */ new Set([
+      ...thread.blockedDomains.map(normalizeSourceDomain).filter(Boolean),
+      ...globalBlocked
+    ])
+  );
+  return {
+    ...thread,
+    blockedDomains
+  };
+}
+function matchesSourceDomain(hostname, domain) {
+  return hostname === domain || hostname.endsWith(`.${domain}`);
+}
+function getBlockedSourceNavigation(url, blockedDomains) {
+  if (typeof url !== "string" || blockedDomains.length === 0) return null;
+  try {
+    const hostname = new URL(url).hostname.toLowerCase().replace(/^www\./, "");
+    return blockedDomains.find(
+      (domain) => matchesSourceDomain(hostname, normalizeSourceDomain(domain))
+    ) ?? null;
+  } catch {
+    return null;
+  }
+}
+function buildFallbackSourceIndex(findings) {
+  const seen = /* @__PURE__ */ new Set();
+  const sources = [];
+  for (const claim of findings.flatMap((finding) => finding.claims)) {
+    if (!claim.sourceUrl || seen.has(claim.sourceUrl)) continue;
+    seen.add(claim.sourceUrl);
+    sources.push({
+      index: sources.length + 1,
+      url: claim.sourceUrl,
+      title: claim.sourceTitle || claim.sourceUrl,
+      accessedAt: claim.extractedAt,
+      supportingQuote: claim.extractedQuote
+    });
+  }
+  return sources;
+}
+function citationForClaim(claim, sourceIndex) {
+  const index = sourceIndex.find((source) => source.url === claim.sourceUrl)?.index ?? 0;
+  return index > 0 ? `[${index}]` : "";
+}
+function buildFallbackFindingsByThread(findings, sourceIndex = buildFallbackSourceIndex(findings)) {
+  return findings.map((finding) => {
+    const claimLines = finding.claims.map((claim) => {
+      const citation = citationForClaim(claim, sourceIndex);
+      return citation ? `${claim.claim} ${citation}` : claim.claim;
+    });
+    return {
+      threadLabel: finding.threadLabel,
+      content: claimLines.length > 0 ? claimLines.join("\n\n") : `No citeable claims were extracted for this thread. ${finding.executionSummary}`
+    };
+  });
+}
+function buildFallbackReport(objectives, findings, reason) {
+  const sourceIndex = buildFallbackSourceIndex(findings);
+  const findingsByThread = buildFallbackFindingsByThread(findings, sourceIndex);
+  const claimCount = findings.reduce(
+    (sum, finding) => sum + finding.claims.length,
+    0
+  );
+  const executiveSummary = claimCount > 0 ? `The model's final synthesis response could not be parsed, so Vessel generated this sourced fallback from ${claimCount} extracted claim${claimCount === 1 ? "" : "s"} across ${sourceIndex.length} source${sourceIndex.length === 1 ? "" : "s"}.` : `The model's final synthesis response could not be parsed, and no citeable claims were extracted from the research threads.`;
+  return {
+    title: objectives.researchQuestion,
+    executiveSummary,
+    findingsByThread,
+    contradictions: [],
+    gaps: [`Final synthesis JSON could not be parsed: ${reason}`],
+    sourceIndex,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    objectives
+  };
+}
 class ResearchOrchestrator {
   constructor(provider, tabManager, runtime2) {
     this.provider = provider;
@@ -25225,6 +25330,8 @@ class ResearchOrchestrator {
   runtime;
   state;
   updateListener = null;
+  stopRequested = false;
+  synthesizeAfterStop = false;
   // ── state access ──────────────────────────────────────────────
   initialState() {
     return {
@@ -25233,6 +25340,7 @@ class ResearchOrchestrator {
       includeTraces: false,
       objectives: null,
       threads: [],
+      threadProgress: [],
       threadFindings: [],
       report: null,
       subAgentTraces: [],
@@ -25265,9 +25373,30 @@ class ResearchOrchestrator {
     this.emit();
   }
   cancel() {
+    this.stopRequested = true;
+    this.synthesizeAfterStop = false;
+    this.provider?.cancel();
     this.state = this.initialState();
     this.emit();
   }
+  stopAndSynthesizeCurrentFindings() {
+    if (this.state.phase !== "executing") {
+      logger$7.warn("Not executing, ignoring stopAndSynthesizeCurrentFindings");
+      return;
+    }
+    this.stopRequested = true;
+    this.synthesizeAfterStop = true;
+    this.state.threadProgress = this.state.threadProgress.map(
+      (progress) => progress.status === "completed" || progress.status === "failed" ? progress : {
+        ...progress,
+        status: "stopping",
+        message: "Stopping and preparing to synthesize current findings",
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    );
+    this.emit();
+    this.provider?.cancel();
+  }
   /**
    * Swap the AI provider used by this orchestrator.
    * Safe to call while research is in progress — running sub-agents
@@ -25313,8 +25442,12 @@ class ResearchOrchestrator {
       logger$7.warn("Not in planning phase, ignoring setObjectives");
       return;
     }
-    this.state.objectives = objectives;
-    this.state.threads = objectives.threads.slice(0, MAX_THREADS);
+    const threads = objectives.threads.slice(0, MAX_THREADS).map(mergeBlockedSourceDomains);
+    this.state.objectives = {
+      ...objectives,
+      threads
+    };
+    this.state.threads = threads;
     this.setPhase("awaiting_approval");
   }
   /**
@@ -25383,8 +25516,28 @@ class ResearchOrchestrator {
     }
     if (mode) this.state.supervisionMode = mode;
     if (includeTraces !== void 0) this.state.includeTraces = includeTraces;
+    this.stopRequested = false;
+    this.synthesizeAfterStop = false;
+    this.state.threadFindings = [];
+    this.state.threadProgress = this.state.threads.map((thread) => ({
+      threadLabel: thread.label,
+      status: "queued",
+      message: "Queued",
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    }));
     this.setPhase("executing");
   }
+  updateThreadProgress(threadLabel, status, message) {
+    const updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const existingIndex = this.state.threadProgress.findIndex(
+      (progress) => progress.threadLabel === threadLabel
+    );
+    const next = { threadLabel, status, message, updatedAt };
+    this.state.threadProgress = existingIndex >= 0 ? this.state.threadProgress.map(
+      (progress, index) => index === existingIndex ? next : progress
+    ) : [...this.state.threadProgress, next];
+    this.emit();
+  }
   // ── phase: executing → synthesizing ────────────────────────────
   async executeSubAgents() {
     if (this.state.phase !== "executing" || !this.state.objectives) return;
@@ -25404,8 +25557,20 @@ class ResearchOrchestrator {
         });
       })
     );
+    const shouldSynthesize = this.synthesizeAfterStop;
     if (this.state.phase !== "executing") return;
     this.state.threadFindings = results.filter((f) => f !== null);
+    this.stopRequested = false;
+    this.synthesizeAfterStop = false;
+    if (!shouldSynthesize) {
+      for (const finding of this.state.threadFindings) {
+        this.updateThreadProgress(
+          finding.threadLabel,
+          finding.claims.length > 0 ? "completed" : "failed",
+          finding.claims.length > 0 ? `${finding.claims.length} claim${finding.claims.length === 1 ? "" : "s"} extracted` : "No citeable claims extracted"
+        );
+      }
+    }
     this.setPhase("synthesizing");
     try {
       await this.synthesizeReport();
@@ -25426,6 +25591,7 @@ class ResearchOrchestrator {
     };
     const tabId = this.tabManager.createTab();
     let sourcesConsumed = 0;
+    this.updateThreadProgress(thread.label, "running", "Researching sources");
     if (tabId) this.tabManager.switchTab(tabId);
     const discardedSources = [];
     let transcript = "";
@@ -25454,10 +25620,32 @@ Start by searching for: ${thread.searchQueries.join(" or ")}`;
         },
         async (name, args) => {
           const t0 = Date.now();
-          if (this.state.phase !== "executing") {
+          if (this.state.phase !== "executing" || this.stopRequested) {
             const msg = "Research cancelled — stopping.";
             return msg;
           }
+          if (name === "navigate") {
+            const blockedDomain = getBlockedSourceNavigation(
+              args.url,
+              thread.blockedDomains
+            );
+            if (blockedDomain) {
+              const msg = `Source skipped: ${String(args.url)} matches the Research Desk source do-not-allow list (${blockedDomain}). Choose a different source.`;
+              discardedSources.push({
+                url: String(args.url || ""),
+                title: String(args.url || "excluded source"),
+                reason: msg
+              });
+              trace.toolCalls.push({
+                tool: name,
+                args,
+                result: msg,
+                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                durationMs: 0
+              });
+              return msg;
+            }
+          }
           if (name === "navigate" || name === "search") {
             sourcesConsumed++;
             if (sourcesConsumed > thread.sourceBudget) {
@@ -25513,6 +25701,9 @@ Start by searching for: ${thread.searchQueries.join(" or ")}`;
         message: String(err),
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       });
+      if (this.state.phase === "executing") {
+        this.updateThreadProgress(thread.label, "stopping", "Stopping thread");
+      }
     } finally {
       trace.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
       if (tabId) {
@@ -25537,6 +25728,13 @@ Start by searching for: ${thread.searchQueries.join(" or ")}`;
     const pagesVisited = trace.toolCalls.filter(
       (t) => ["navigate", "read_page", "search"].includes(t.tool)
     ).length;
+    if (this.state.phase === "executing") {
+      this.updateThreadProgress(
+        thread.label,
+        claims.length > 0 ? "completed" : this.stopRequested ? "stopping" : "failed",
+        claims.length > 0 ? `${claims.length} claim${claims.length === 1 ? "" : "s"} extracted` : this.stopRequested ? "Stopped before citeable claims were extracted" : "No citeable claims extracted"
+      );
+    }
     return {
       threadLabel: thread.label,
       threadQuestion: thread.question,
@@ -25633,7 +25831,7 @@ ${transcript.slice(0, 32e3)}`;
       () => {
       }
     );
-    const report = this.parseReportFromJson(response, objectives);
+    const report = this.parseReportFromJson(response, objectives, findings);
     this.setReport(report);
     this.setPhase("delivered");
     return report;
@@ -25642,7 +25840,7 @@ ${transcript.slice(0, 32e3)}`;
    * Parse the LLM's JSON synthesis response into a structured ResearchReport.
    * Handles both bare JSON and JSON wrapped in markdown fences.
    */
-  parseReportFromJson(text, objectives) {
+  parseReportFromJson(text, objectives, findings) {
     let json = text.trim();
     const fenceMatch = json.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
     if (fenceMatch) json = fenceMatch[1].trim();
@@ -25650,16 +25848,27 @@ ${transcript.slice(0, 32e3)}`;
     if (objMatch) json = objMatch[0];
     try {
       const parsed = JSON.parse(json);
+      const 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) : [];
+      const findingsByThread = Array.isArray(parsed.findingsByThread) ? parsed.findingsByThread.map((s) => {
+        const obj = s;
+        return {
+          threadLabel: String(obj.threadLabel || "").trim(),
+          content: String(obj.content || "").trim()
+        };
+      }) : [];
       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()
-          };
-        }) : [],
+        findingsByThread: findingsByThread.length > 0 ? findingsByThread : buildFallbackFindingsByThread(findings),
         contradictions: Array.isArray(parsed.contradictions) ? parsed.contradictions.map((c) => {
           const obj = c;
           const sourceA = obj.sourceA ?? {};
@@ -25680,31 +25889,13 @@ ${transcript.slice(0, 32e3)}`;
           (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) : [],
+        sourceIndex: sourceIndex.length > 0 ? sourceIndex : buildFallbackSourceIndex(findings),
         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
-      };
+      logger$7.warn("Failed to parse synthesis JSON, using sourced fallback report", err);
+      return buildFallbackReport(objectives, findings, String(err));
     }
   }
   // ── report management ──────────────────────────────────────────

package/out/preload/index.js

@@ -204,6 +204,7 @@ const Channels = {
   RESEARCH_SET_MODE: "research:set-mode",
   RESEARCH_SET_TRACES: "research:set-traces",
   RESEARCH_CANCEL: "research:cancel",
+  RESEARCH_STOP_AND_SYNTHESIZE: "research:stop-and-synthesize",
   RESEARCH_EXPORT_REPORT: "research:export-report",
   // Codex OAuth
   CODEX_START_AUTH: "codex:start-auth",
@@ -332,6 +333,7 @@ const api = {
     setMode: (mode) => electron.ipcRenderer.invoke(Channels.RESEARCH_SET_MODE, mode),
     setTraces: (include) => electron.ipcRenderer.invoke(Channels.RESEARCH_SET_TRACES, include),
     cancel: () => electron.ipcRenderer.invoke(Channels.RESEARCH_CANCEL),
+    stopAndSynthesize: () => electron.ipcRenderer.invoke(Channels.RESEARCH_STOP_AND_SYNTHESIZE),
     exportReport: () => electron.ipcRenderer.invoke(Channels.RESEARCH_EXPORT_REPORT)
   },
   content: {