pi-web-providers 3.3.0 → 3.5.0

package/dist/index.js

@@ -1,25 +1,25 @@
 // src/index.ts
-import { randomUUID } from "node:crypto";
-import { mkdir as mkdir2, writeFile as writeFile2 } from "node:fs/promises";
+import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { basename, dirname as dirname2, join as join2, relative } from "node:path";
+import { basename, join as join3 } from "node:path";
 import {
+  copyToClipboard,
   DEFAULT_MAX_BYTES,
   DEFAULT_MAX_LINES,
   formatSize as formatSize2,
-  getMarkdownTheme,
+  getMarkdownTheme as getMarkdownTheme2,
   truncateHead
 } from "@earendil-works/pi-coding-agent";
 import {
   Box,
   Editor,
-  getKeybindings,
-  Key,
-  Markdown,
-  matchesKey,
+  getKeybindings as getKeybindings2,
+  Key as Key2,
+  Markdown as Markdown2,
+  matchesKey as matchesKey2,
   Text,
-  truncateToWidth,
-  visibleWidth,
+  truncateToWidth as truncateToWidth2,
+  visibleWidth as visibleWidth2,
   wrapTextWithAnsi
 } from "@earendil-works/pi-tui";
 import { Type as Type16 } from "typebox";
@@ -1276,6 +1276,12 @@ function literalUnion(values, options) {
     options
   );
 }
+function boolOrConfig(options) {
+  return Type2.Union(
+    [Type2.Boolean(), Type2.Record(Type2.String(), Type2.Any())],
+    options
+  );
+}
 
 // src/providers/claude.ts
 var SEARCH_OUTPUT_SCHEMA = {
@@ -1358,6 +1364,11 @@ var claudeOptionsSchema = Type3.Object(
   },
   { description: "Claude options." }
 );
+var claudeSearchPromptGuidelines = [
+  "Use Claude search when Claude Code's agentic web-browsing and synthesis are useful for finding likely sources.",
+  "Increase effort or maxTurns only for difficult, ambiguous, or multi-step source discovery; keep defaults for simple searches.",
+  "Prefer web_contents after Claude search when the task requires direct inspection of a small set of selected URLs."
+];
 var claudeImplementation = {
   id: "claude",
   label: "Claude",
@@ -1615,6 +1626,7 @@ var claudeProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: claudeImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: claudeSearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await claudeImplementation.search(
@@ -1833,6 +1845,11 @@ var codexSearchOptionsSchema = Type5.Object(
   },
   { description: "Codex search options." }
 );
+var codexSearchPromptGuidelines = [
+  "Use Codex search when the local Codex SDK should perform web-backed source discovery, especially for coding or developer-oriented investigations.",
+  "Use webSearchMode='live' for current information and 'cached' when freshness is less important; do not set 'disabled' for normal web_search calls.",
+  "Increase modelReasoningEffort only for difficult or ambiguous searches where deeper reasoning is worth the extra latency."
+];
 var codexImplementation = {
   id: "codex",
   label: "Codex",
@@ -2013,6 +2030,7 @@ var codexProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: codexImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: codexSearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await codexImplementation.search(
@@ -2454,39 +2472,39 @@ function createDefaultExecutionSettings(overrides = {}) {
 function normalizeDiagnosticDetail(detail) {
   return detail.trim().replace(/[.\s]+$/u, "");
 }
-function startsWithProviderLabel(providerLabel, detail) {
-  return detail.toLowerCase().startsWith(providerLabel.toLowerCase());
+function startsWithProviderLabel(providerLabel2, detail) {
+  return detail.toLowerCase().startsWith(providerLabel2.toLowerCase());
 }
 function readsLikeProviderClause(detail) {
   return /^(is|has|was|returned|did|does|could|cannot|must|should|search\b|contents\b|answer\b|research\b|output\b|response\b|result\b|query\b|no\b|missing\b|deep research\b)/iu.test(
     detail
   );
 }
-function formatProviderDiagnostic(providerLabel, detail) {
+function formatProviderDiagnostic(providerLabel2, detail) {
   const normalized = normalizeDiagnosticDetail(detail);
   if (!normalized) {
-    return `${providerLabel} failed.`;
+    return `${providerLabel2} failed.`;
   }
-  if (startsWithProviderLabel(providerLabel, normalized)) {
+  if (startsWithProviderLabel(providerLabel2, normalized)) {
     return `${normalized}.`;
   }
   if (readsLikeProviderClause(normalized)) {
-    return `${providerLabel} ${normalized}.`;
+    return `${providerLabel2} ${normalized}.`;
   }
-  return `${providerLabel}: ${normalized}.`;
+  return `${providerLabel2}: ${normalized}.`;
 }
-function formatResearchTerminalDiagnostic(providerLabel, status, detail) {
+function formatResearchTerminalDiagnostic(providerLabel2, status, detail) {
   const normalized = detail ? normalizeDiagnosticDetail(detail) : "";
   if (!normalized) {
-    return status === "cancelled" ? `${providerLabel} research was canceled.` : `${providerLabel} research failed.`;
+    return status === "cancelled" ? `${providerLabel2} research was canceled.` : `${providerLabel2} research failed.`;
   }
-  if (startsWithProviderLabel(providerLabel, normalized)) {
+  if (startsWithProviderLabel(providerLabel2, normalized)) {
     return `${normalized}.`;
   }
   if (/^research\b/iu.test(normalized)) {
-    return `${providerLabel} ${normalized}.`;
+    return `${providerLabel2} ${normalized}.`;
   }
-  return status === "cancelled" ? `${providerLabel} research was canceled: ${normalized}.` : `${providerLabel} research failed: ${normalized}.`;
+  return status === "cancelled" ? `${providerLabel2} research was canceled: ${normalized}.` : `${providerLabel2} research failed: ${normalized}.`;
 }
 
 // src/execution-policy.ts
@@ -2532,7 +2550,7 @@ async function runWithExecutionPolicy(label, operation, settings, context) {
   throw new Error(`${label} failed.`);
 }
 async function executeAsyncResearch({
-  providerLabel,
+  providerLabel: providerLabel2,
   providerId,
   context,
   pollIntervalMs = DEFAULT_RESEARCH_POLL_INTERVAL_MS,
@@ -2541,7 +2559,7 @@ async function executeAsyncResearch({
   start,
   poll
 }) {
-  const timeoutMessage = `${providerLabel} research exceeded ${formatDuration(timeoutMs)}.`;
+  const timeoutMessage = `${providerLabel2} research exceeded ${formatDuration(timeoutMs)}.`;
   const deadline = createDeadlineSignal(
     context.signal,
     timeoutMs,
@@ -2555,7 +2573,7 @@ async function executeAsyncResearch({
   let lastProgressStatus;
   const startedAt = Date.now();
   try {
-    researchContext.onProgress?.(`Starting research via ${providerLabel}`);
+    researchContext.onProgress?.(`Starting research via ${providerLabel2}`);
     const job = await withAbortAndOptionalTimeout(
       start(researchContext),
       void 0,
@@ -2564,14 +2582,14 @@ async function executeAsyncResearch({
     );
     const jobId = job.id;
     if (!jobId) {
-      throw new Error(`${providerLabel} research did not return a job id.`);
+      throw new Error(`${providerLabel2} research did not return a job id.`);
     }
-    researchContext.onProgress?.(`${providerLabel} research started: ${jobId}`);
+    researchContext.onProgress?.(`${providerLabel2} research started: ${jobId}`);
     let consecutivePollErrors = 0;
     while (true) {
       throwIfAborted(
         researchContext.signal,
-        `${providerLabel} research aborted.`
+        `${providerLabel2} research aborted.`
       );
       try {
         const result = await withAbortAndOptionalTimeout(
@@ -2584,7 +2602,7 @@ async function executeAsyncResearch({
         const progressStatus = result.statusText ?? result.status;
         if (result.status !== lastStatus || progressStatus !== lastProgressStatus) {
           researchContext.onProgress?.(
-            `Research via ${providerLabel}: ${progressStatus} (${formatElapsed(Date.now() - startedAt)} elapsed)`
+            `Research via ${providerLabel2}: ${progressStatus} (${formatElapsed(Date.now() - startedAt)} elapsed)`
           );
           lastStatus = result.status;
           lastProgressStatus = progressStatus;
@@ -2592,13 +2610,13 @@ async function executeAsyncResearch({
         if (result.status === "completed") {
           return result.output ?? {
             provider: providerId,
-            text: `${providerLabel} research completed without textual output.`
+            text: `${providerLabel2} research completed without textual output.`
           };
         }
         if (result.status === "failed" || result.status === "cancelled") {
           throw new Error(
             formatResearchTerminalDiagnostic(
-              providerLabel,
+              providerLabel2,
               result.status,
               result.error
             )
@@ -2614,11 +2632,11 @@ async function executeAsyncResearch({
         consecutivePollErrors += 1;
         if (consecutivePollErrors >= maxConsecutivePollErrors) {
           throw new Error(
-            `${providerLabel} research polling failed too many times in a row: ${formatErrorMessage(error)}`
+            `${providerLabel2} research polling failed too many times in a row: ${formatErrorMessage(error)}`
           );
         }
         researchContext.onProgress?.(
-          `${providerLabel} research poll is still retrying after transient errors (${consecutivePollErrors}/${maxConsecutivePollErrors} consecutive poll failures). Background job id: ${jobId}`
+          `${providerLabel2} research poll is still retrying after transient errors (${consecutivePollErrors}/${maxConsecutivePollErrors} consecutive poll failures). Background job id: ${jobId}`
         );
       }
       await sleep(pollIntervalMs, researchContext.signal);
@@ -2626,11 +2644,11 @@ async function executeAsyncResearch({
   } catch (error) {
     if (isAbortErrorFromSignal(researchContext.signal, error)) {
       throw new Error(
-        formatProviderDiagnostic(providerLabel, formatErrorMessage(error))
+        formatProviderDiagnostic(providerLabel2, formatErrorMessage(error))
       );
     }
     throw new Error(
-      formatProviderDiagnostic(providerLabel, formatErrorMessage(error))
+      formatProviderDiagnostic(providerLabel2, formatErrorMessage(error))
     );
   } finally {
     deadline.cleanup();
@@ -2806,9 +2824,9 @@ var exaSearchOptionsSchema = Type6.Object(
           "hybrid",
           "fast",
           "instant",
+          "deep-lite",
           "deep",
-          "deep-reasoning",
-          "deep-max"
+          "deep-reasoning"
         ],
         { description: "Exa search mode." }
       )
@@ -2826,6 +2844,14 @@ var exaSearchOptionsSchema = Type6.Object(
     excludeDomains: Type6.Optional(
       Type6.Array(Type6.String(), { description: "Exclude these domains." })
     ),
+    startCrawlDate: Type6.Optional(
+      Type6.String({
+        description: "ISO date string for earliest crawl date."
+      })
+    ),
+    endCrawlDate: Type6.Optional(
+      Type6.String({ description: "ISO date string for latest crawl date." })
+    ),
     startPublishedDate: Type6.Optional(
       Type6.String({
         description: "ISO date string for earliest publish date."
@@ -2834,48 +2860,173 @@ var exaSearchOptionsSchema = Type6.Object(
     endPublishedDate: Type6.Optional(
       Type6.String({ description: "ISO date string for latest publish date." })
     ),
+    includeText: Type6.Optional(
+      Type6.Array(Type6.String(), {
+        description: "Require result page text to contain these terms. Exa currently supports one short phrase."
+      })
+    ),
+    excludeText: Type6.Optional(
+      Type6.Array(Type6.String(), {
+        description: "Require result page text not to contain these terms. Exa currently supports one short phrase."
+      })
+    ),
+    systemPrompt: Type6.Optional(
+      Type6.String({
+        description: "Additional Exa instructions for deep search source selection and synthesis."
+      })
+    ),
+    additionalQueries: Type6.Optional(
+      Type6.Array(Type6.String(), {
+        maxItems: 5,
+        description: "Alternative query formulations for Exa deep search variants."
+      })
+    ),
     userLocation: Type6.Optional(
-      Type6.Object(
-        {
-          country: Type6.Optional(
-            Type6.String({ description: "Country hint for the user location." })
-          ),
-          region: Type6.Optional(
-            Type6.String({ description: "Region hint for the user location." })
-          ),
-          city: Type6.Optional(
-            Type6.String({ description: "City hint for the user location." })
-          ),
-          timezone: Type6.Optional(
-            Type6.String({
-              description: "Timezone hint for the user location."
-            })
-          )
-        },
-        {
-          description: "User location hint passed through to the Exa SDK."
-        }
-      )
+      Type6.String({
+        description: "Two-letter ISO country code for the user location, such as 'US'."
+      })
     ),
     contents: Type6.Optional(
       Type6.Object(
         {
           text: Type6.Optional(
-            Type6.Boolean({ description: "Include text content." })
+            Type6.Union(
+              [
+                Type6.Boolean(),
+                Type6.Object(
+                  {
+                    maxCharacters: Type6.Optional(
+                      Type6.Integer({
+                        minimum: 1,
+                        description: "Maximum text characters per result."
+                      })
+                    ),
+                    includeHtmlTags: Type6.Optional(
+                      Type6.Boolean({
+                        description: "Include HTML tags in returned text."
+                      })
+                    ),
+                    verbosity: Type6.Optional(
+                      literalUnion(["compact", "standard", "full"], {
+                        description: "Verbosity level for returned text."
+                      })
+                    )
+                  },
+                  { additionalProperties: false }
+                )
+              ],
+              { description: "Include text content." }
+            )
           ),
           highlights: Type6.Optional(
-            Type6.Boolean({ description: "Include highlighted excerpts." })
+            Type6.Union(
+              [
+                Type6.Boolean(),
+                Type6.Object(
+                  {
+                    query: Type6.Optional(
+                      Type6.String({
+                        description: "Query to use for highlights."
+                      })
+                    ),
+                    maxCharacters: Type6.Optional(
+                      Type6.Integer({
+                        minimum: 1,
+                        description: "Maximum highlight characters."
+                      })
+                    )
+                  },
+                  { additionalProperties: false }
+                )
+              ],
+              { description: "Include highlighted excerpts." }
+            )
           ),
           summary: Type6.Optional(
-            Type6.Boolean({ description: "Include AI-generated summary." })
+            Type6.Union(
+              [
+                Type6.Boolean(),
+                Type6.Object(
+                  {
+                    query: Type6.Optional(
+                      Type6.String({
+                        description: "Query to guide summary generation."
+                      })
+                    )
+                  },
+                  { additionalProperties: false }
+                )
+              ],
+              { description: "Include AI-generated summary." }
+            )
+          ),
+          livecrawl: Type6.Optional(
+            literalUnion(["never", "fallback", "always", "auto", "preferred"], {
+              description: "Livecrawl mode for fetching fresh content."
+            })
+          ),
+          livecrawlTimeout: Type6.Optional(
+            Type6.Integer({
+              minimum: 0,
+              description: "Livecrawl timeout in milliseconds."
+            })
+          ),
+          maxAgeHours: Type6.Optional(
+            Type6.Number({
+              description: "Maximum age of cached content in hours. Use 0 to always fetch fresh content."
+            })
+          ),
+          filterEmptyResults: Type6.Optional(
+            Type6.Boolean({ description: "Filter results with no contents." })
+          ),
+          subpages: Type6.Optional(
+            Type6.Integer({
+              minimum: 0,
+              description: "Number of subpages to return for each result."
+            })
+          ),
+          subpageTarget: Type6.Optional(
+            Type6.Union([Type6.String(), Type6.Array(Type6.String())], {
+              description: "Text used to match/rank returned subpages."
+            })
+          ),
+          extras: Type6.Optional(
+            Type6.Object(
+              {
+                links: Type6.Optional(
+                  Type6.Integer({
+                    minimum: 0,
+                    description: "Number of page links to include."
+                  })
+                ),
+                imageLinks: Type6.Optional(
+                  Type6.Integer({
+                    minimum: 0,
+                    description: "Number of image links to include."
+                  })
+                )
+              },
+              { additionalProperties: false }
+            )
           )
         },
-        { description: "What content to include in results." }
+        {
+          additionalProperties: false,
+          description: "What content to include in results."
+        }
       )
     )
   },
   { description: "Exa search options." }
 );
+var exaSearchPromptGuidelines = [
+  "Use Exa's neural/auto search modes for semantic source discovery where exact keywords are uncertain; use keyword mode when exact terms, names, or identifiers matter.",
+  "Use Exa category filters such as 'research paper' or 'company' when the user asks for a specific source type.",
+  "Set includeDomains or excludeDomains when the task names preferred sources, requires primary sources, or needs noisy domains filtered out.",
+  "Use startCrawlDate/endCrawlDate or contents.maxAgeHours when freshness of Exa's crawled content matters.",
+  "Use includeText/excludeText for short required or forbidden phrases in page text.",
+  "Request contents.text, contents.highlights, or contents.summary only when snippets are insufficient and richer source context is needed directly in search results."
+];
 var exaImplementation = {
   id: "exa",
   label: "Exa",
@@ -3046,6 +3197,7 @@ var exaProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: exaImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: exaSearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await exaImplementation.search(
@@ -3121,6 +3273,26 @@ var firecrawlSearchOptionsSchema = Type7.Object(
         description: "Search categories to include."
       })
     ),
+    includeDomains: Type7.Optional(
+      Type7.Array(Type7.String(), {
+        description: "Restrict results to these domains."
+      })
+    ),
+    excludeDomains: Type7.Optional(
+      Type7.Array(Type7.String(), {
+        description: "Exclude these domains."
+      })
+    ),
+    tbs: Type7.Optional(
+      Type7.String({
+        description: "Google-style time-based search filter."
+      })
+    ),
+    ignoreInvalidURLs: Type7.Optional(
+      Type7.Boolean({
+        description: "Ignore invalid result URLs returned by search."
+      })
+    ),
     location: Type7.Optional(
       Type7.Object(
         {
@@ -3141,9 +3313,22 @@ var firecrawlSearchOptionsSchema = Type7.Object(
       Type7.Object(
         {
           formats: Type7.Optional(
-            Type7.Array(literalUnion(["markdown", "html", "rawHtml"]), {
-              description: "Output formats."
-            })
+            Type7.Array(
+              literalUnion([
+                "markdown",
+                "html",
+                "rawHtml",
+                "links",
+                "images",
+                "screenshot",
+                "summary",
+                "json",
+                "attributes"
+              ]),
+              {
+                description: "Output formats."
+              }
+            )
           ),
           onlyMainContent: Type7.Optional(
             Type7.Boolean({ description: "Extract only the main content." })
@@ -3157,51 +3342,133 @@ var firecrawlSearchOptionsSchema = Type7.Object(
   },
   { description: "Firecrawl search options." }
 );
+var firecrawlSearchPromptGuidelines = [
+  "Use Firecrawl search when the task benefits from searchable results that can also include scraped page content through scrapeOptions.",
+  "Set scrapeOptions.formats=['markdown'] and onlyMainContent=true when source snippets are not enough and the user needs extracted page context in the search results.",
+  "Use includeDomains/excludeDomains when search should stay within or avoid specific sites.",
+  "Use lang, country, or location when the user asks for language-specific, country-specific, or local results.",
+  "Prefer web_contents with Firecrawl scrape options after search when only a small set of known URLs needs full extraction."
+];
+var firecrawlScrapeTuningProperties = {
+  onlyMainContent: Type7.Optional(
+    Type7.Boolean({ description: "Extract only the main content." })
+  ),
+  includeTags: Type7.Optional(
+    Type7.Array(Type7.String(), { description: "CSS selectors to include." })
+  ),
+  excludeTags: Type7.Optional(
+    Type7.Array(Type7.String(), { description: "CSS selectors to exclude." })
+  ),
+  waitFor: Type7.Optional(
+    Type7.Integer({
+      minimum: 0,
+      description: "Milliseconds to wait before scraping."
+    })
+  ),
+  headers: Type7.Optional(
+    Type7.Record(Type7.String(), Type7.String(), {
+      description: "Headers to send when scraping."
+    })
+  ),
+  location: Type7.Optional(
+    Type7.Object(
+      {
+        country: Type7.Optional(Type7.String({ description: "Country hint." })),
+        region: Type7.Optional(Type7.String({ description: "Region hint." })),
+        city: Type7.Optional(Type7.String({ description: "City hint." }))
+      },
+      { description: "Location hint for scraping." }
+    )
+  ),
+  mobile: Type7.Optional(
+    Type7.Boolean({ description: "Use a mobile browser profile." })
+  ),
+  proxy: Type7.Optional(
+    Type7.String({
+      description: "Proxy mode passed through to the Firecrawl SDK."
+    })
+  ),
+  fastMode: Type7.Optional(
+    Type7.Boolean({ description: "Use Firecrawl fast mode." })
+  ),
+  blockAds: Type7.Optional(
+    Type7.Boolean({ description: "Block ads while scraping." })
+  ),
+  removeBase64Images: Type7.Optional(
+    Type7.Boolean({
+      description: "Remove base64 image data from scraped output."
+    })
+  ),
+  redactPII: Type7.Optional(
+    Type7.Union(
+      [
+        Type7.Boolean(),
+        Type7.Object(
+          {
+            entities: Type7.Optional(
+              Type7.Array(
+                literalUnion([
+                  "PERSON",
+                  "EMAIL",
+                  "PHONE",
+                  "LOCATION",
+                  "FINANCIAL",
+                  "SECRET"
+                ])
+              )
+            )
+          },
+          { additionalProperties: false }
+        )
+      ],
+      { description: "Redact personal or sensitive data from output." }
+    )
+  ),
+  maxAge: Type7.Optional(
+    Type7.Number({
+      description: "Maximum age of cached scrape data in milliseconds."
+    })
+  ),
+  minAge: Type7.Optional(
+    Type7.Number({
+      description: "Minimum age of cached scrape data in milliseconds."
+    })
+  ),
+  storeInCache: Type7.Optional(
+    Type7.Boolean({ description: "Store scrape result in Firecrawl cache." })
+  ),
+  skipTlsVerification: Type7.Optional(
+    Type7.Boolean({ description: "Skip TLS certificate verification." })
+  )
+};
 var firecrawlScrapeOptionsSchema = Type7.Object(
   {
     formats: Type7.Optional(
-      Type7.Array(literalUnion(["markdown", "html", "rawHtml"]), {
-        description: "Output formats for scraping."
-      })
-    ),
-    onlyMainContent: Type7.Optional(
-      Type7.Boolean({ description: "Extract only the main content." })
-    ),
-    includeTags: Type7.Optional(
-      Type7.Array(Type7.String(), { description: "CSS selectors to include." })
-    ),
-    excludeTags: Type7.Optional(
-      Type7.Array(Type7.String(), { description: "CSS selectors to exclude." })
+      Type7.Array(
+        literalUnion([
+          "markdown",
+          "html",
+          "rawHtml",
+          "links",
+          "images",
+          "screenshot",
+          "summary",
+          "json",
+          "attributes",
+          "changeTracking"
+        ]),
+        {
+          description: "Output formats for scraping."
+        }
+      )
     ),
-    waitFor: Type7.Optional(
+    timeout: Type7.Optional(
       Type7.Integer({
         minimum: 0,
-        description: "Milliseconds to wait before scraping."
-      })
-    ),
-    headers: Type7.Optional(
-      Type7.Record(Type7.String(), Type7.String(), {
-        description: "Headers to send when scraping."
+        description: "Request timeout in milliseconds."
       })
     ),
-    location: Type7.Optional(
-      Type7.Object(
-        {
-          country: Type7.Optional(Type7.String({ description: "Country hint." })),
-          region: Type7.Optional(Type7.String({ description: "Region hint." })),
-          city: Type7.Optional(Type7.String({ description: "City hint." }))
-        },
-        { description: "Location hint for scraping." }
-      )
-    ),
-    mobile: Type7.Optional(
-      Type7.Boolean({ description: "Use a mobile browser profile." })
-    ),
-    proxy: Type7.Optional(
-      Type7.String({
-        description: "Proxy mode passed through to the Firecrawl SDK."
-      })
-    )
+    ...firecrawlScrapeTuningProperties
   },
   { description: "Firecrawl scrape options." }
 );
@@ -3211,44 +3478,7 @@ var firecrawlAnswerOptionsSchema = Type7.Object(
       minLength: 1,
       description: "URL of the page to ask about."
     }),
-    onlyMainContent: Type7.Optional(
-      Type7.Boolean({ description: "Extract only the main content." })
-    ),
-    includeTags: Type7.Optional(
-      Type7.Array(Type7.String(), { description: "CSS selectors to include." })
-    ),
-    excludeTags: Type7.Optional(
-      Type7.Array(Type7.String(), { description: "CSS selectors to exclude." })
-    ),
-    waitFor: Type7.Optional(
-      Type7.Integer({
-        minimum: 0,
-        description: "Milliseconds to wait before scraping."
-      })
-    ),
-    headers: Type7.Optional(
-      Type7.Record(Type7.String(), Type7.String(), {
-        description: "Headers to send when scraping."
-      })
-    ),
-    location: Type7.Optional(
-      Type7.Object(
-        {
-          country: Type7.Optional(Type7.String({ description: "Country hint." })),
-          region: Type7.Optional(Type7.String({ description: "Region hint." })),
-          city: Type7.Optional(Type7.String({ description: "City hint." }))
-        },
-        { description: "Location hint for scraping." }
-      )
-    ),
-    mobile: Type7.Optional(
-      Type7.Boolean({ description: "Use a mobile browser profile." })
-    ),
-    proxy: Type7.Optional(
-      Type7.String({
-        description: "Proxy mode passed through to Firecrawl."
-      })
-    )
+    ...firecrawlScrapeTuningProperties
   },
   {
     description: "Firecrawl page-question options. The URL is required; the question comes from the web_answer query."
@@ -3531,6 +3761,7 @@ var firecrawlProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: firecrawlImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: firecrawlSearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await firecrawlImplementation.search(
@@ -3653,6 +3884,12 @@ var geminiSearchOptionsSchema = Type8.Object(
   },
   { description: "Gemini search options." }
 );
+var geminiSearchPromptGuidelines = [
+  "Use Gemini search when a grounded model should perform web-backed source discovery and return likely sources.",
+  "Change model only when the user requests a specific Gemini model or when project configuration requires it.",
+  "Tune generation_config only for explicit output-control needs; avoid disabling tool use for search tasks.",
+  "Prefer web_contents after Gemini search when selected sources need direct extraction or closer reading."
+];
 var geminiAnswerOptionsSchema = Type8.Object(
   {
     model: Type8.Optional(
@@ -3713,7 +3950,7 @@ var geminiImplementation = {
       context.signal
     );
     const results = await Promise.all(
-      extractGoogleSearchResults(interaction.outputs).slice(0, maxResults).map(async (result) => {
+      extractGoogleSearchResults(readInteractionSteps(interaction)).slice(0, maxResults).map(async (result) => {
         const resolvedUrl = await resolveGoogleSearchUrl(
           result.url,
           context.signal
@@ -3800,7 +4037,7 @@ var geminiImplementation = {
     );
     const status = readNonEmptyString3(interaction.status) ?? "unknown";
     if (status === "completed") {
-      const text = formatInteractionOutputs(interaction.outputs);
+      const text = formatInteractionSteps(readInteractionSteps(interaction));
       return {
         status: "completed",
         output: {
@@ -3830,7 +4067,7 @@ var geminiImplementation = {
     if (status === "requires_action") {
       return {
         status: "failed",
-        error: describeGeminiRequiredAction(interaction.outputs)
+        error: describeGeminiRequiredAction(readInteractionSteps(interaction))
       };
     }
     return status === "in_progress" ? { status: "in_progress" } : { status: "in_progress", statusText: status };
@@ -3864,17 +4101,20 @@ function addAbortSignalToGeminiConfig(config, signal) {
     abortSignal: signal
   };
 }
-function extractGoogleSearchResults(outputs) {
+function readInteractionSteps(interaction) {
+  return typeof interaction === "object" && interaction !== null ? interaction.steps : void 0;
+}
+function extractGoogleSearchResults(steps) {
   const seen = /* @__PURE__ */ new Set();
   const results = [];
-  if (!Array.isArray(outputs)) {
+  if (!Array.isArray(steps)) {
     return results;
   }
-  for (const output of outputs) {
-    if (typeof output !== "object" || output === null) {
+  for (const step of steps) {
+    if (typeof step !== "object" || step === null) {
       continue;
     }
-    const content = output;
+    const content = step;
     if (content.type !== "google_search_result") {
       continue;
     }
@@ -4040,16 +4280,21 @@ function extractGroundingSources(chunks) {
   }
   return sources;
 }
-function formatInteractionOutputs(outputs) {
+function formatInteractionSteps(steps) {
   const lines = [];
-  if (!Array.isArray(outputs)) {
+  if (!Array.isArray(steps)) {
     return "";
   }
-  for (const output of outputs) {
-    if (typeof output === "object" && output !== null && "type" in output && output.type === "text" && "text" in output && typeof output.text === "string") {
-      const text = output.text.trim();
-      if (text) {
-        lines.push(text);
+  for (const step of steps) {
+    if (typeof step !== "object" || step === null || !("type" in step) || step.type !== "model_output" || !("content" in step) || !Array.isArray(step.content)) {
+      continue;
+    }
+    for (const part of step.content) {
+      if (typeof part === "object" && part !== null && "type" in part && part.type === "text" && "text" in part && typeof part.text === "string") {
+        const text = part.text.trim();
+        if (text) {
+          lines.push(text);
+        }
       }
     }
   }
@@ -4244,14 +4489,12 @@ function buildGeminiGenerateContentRequest({
     }
   };
 }
-function describeGeminiRequiredAction(outputs) {
-  if (!Array.isArray(outputs) || outputs.length === 0) {
+function describeGeminiRequiredAction(steps) {
+  if (!Array.isArray(steps) || steps.length === 0) {
     return "research requires additional action";
   }
-  const firstOutput = outputs.find(
-    (value) => typeof value === "object" && value !== null
-  );
-  const type = readNonEmptyString3(firstOutput?.type);
+  const lastStep = [...steps].reverse().find((value) => typeof value === "object" && value !== null);
+  const type = readNonEmptyString3(lastStep?.type);
   if (!type) {
     return "research requires additional action";
   }
@@ -4335,6 +4578,7 @@ var geminiProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: geminiImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: geminiSearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await geminiImplementation.search(
@@ -4403,6 +4647,12 @@ var linkupSearchOptionsSchema = Type9.Object(
   },
   { description: "Linkup search options." }
 );
+var linkupSearchPromptGuidelines = [
+  "Use Linkup depth='deep' for exploratory or high-recall source discovery, and 'standard' for quick direct searches.",
+  "Use includeDomains or excludeDomains when the user names source constraints or when limiting the search space improves precision.",
+  "Use fromDate and toDate when the user asks for recent, historical, or bounded-by-date results.",
+  "Enable includeImages only when images are directly useful; otherwise keep search focused on textual source discovery."
+];
 var linkupContentsOptionsSchema = Type9.Object(
   {
     renderJs: Type9.Optional(
@@ -4772,6 +5022,7 @@ var linkupProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: linkupImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: linkupSearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await linkupImplementation.search(
@@ -4981,11 +5232,40 @@ function buildFetchMetadata(data) {
 }
 
 // src/providers/openai.ts
-import { Type as Type10 } from "typebox";
 import OpenAI from "openai";
+import { Type as Type10 } from "typebox";
 var DEFAULT_SEARCH_MODEL2 = "gpt-4.1";
 var DEFAULT_ANSWER_MODEL2 = "gpt-4.1";
 var DEFAULT_RESEARCH_MODEL = "o4-mini-deep-research";
+var openaiWebSearchToolProperties = {
+  searchContextSize: Type10.Optional(
+    literalUnion(["low", "medium", "high"], {
+      description: "Amount of context OpenAI web search should retrieve per search."
+    })
+  ),
+  allowedDomains: Type10.Optional(
+    Type10.Array(Type10.String(), {
+      description: "Restrict OpenAI web search to these domains."
+    })
+  ),
+  userLocation: Type10.Optional(
+    Type10.Object(
+      {
+        city: Type10.Optional(Type10.String({ description: "User city hint." })),
+        country: Type10.Optional(
+          Type10.String({ description: "Two-letter user country code." })
+        ),
+        region: Type10.Optional(
+          Type10.String({ description: "User region hint." })
+        ),
+        timezone: Type10.Optional(
+          Type10.String({ description: "IANA timezone hint." })
+        )
+      },
+      { description: "Approximate user location for OpenAI web search." }
+    )
+  )
+};
 var openaiSearchOptionsSchema = Type10.Object(
   {
     model: Type10.Optional(
@@ -4997,10 +5277,19 @@ var openaiSearchOptionsSchema = Type10.Object(
       Type10.String({
         description: "Optional instructions that shape source selection and result style."
       })
-    )
+    ),
+    ...openaiWebSearchToolProperties
   },
   { description: "OpenAI search options." }
 );
+var openaiSearchPromptGuidelines = [
+  "Use OpenAI web search when an LLM-mediated search pass should identify likely sources from the live web.",
+  "Use instructions to constrain source selection, freshness, geography, or output style only when the user explicitly needs that control.",
+  "Use allowedDomains when the user asks to search only specific sites or primary-source domains.",
+  "Use searchContextSize='high' only when the query needs richer source context; use 'low' for quick source discovery.",
+  "Use userLocation for local, regional, or jurisdiction-specific searches.",
+  "Prefer web_contents after OpenAI search when the task requires direct inspection of selected primary sources."
+];
 var openaiAnswerOptionsSchema = Type10.Object(
   {
     model: Type10.Optional(
@@ -5012,7 +5301,8 @@ var openaiAnswerOptionsSchema = Type10.Object(
       Type10.String({
         description: "Optional instructions that shape the answer structure, tone, and source selection."
       })
-    )
+    ),
+    ...openaiWebSearchToolProperties
   },
   { description: "OpenAI answer options." }
 );
@@ -5033,7 +5323,8 @@ var openaiResearchOptionsSchema = Type10.Object(
         minimum: 1,
         description: "Maximum number of built-in tool calls the model may make during the research run."
       })
-    )
+    ),
+    ...openaiWebSearchToolProperties
   },
   { description: "OpenAI deep research options." }
 );
@@ -5194,7 +5485,7 @@ function buildOpenAISearchRequest(query2, maxResults, config, options) {
       "",
       `User query: ${query2}`
     ].join("\n"),
-    tools: [{ type: "web_search_preview" }],
+    tools: [buildOpenAIWebSearchTool(mergedOptions)],
     text: {
       format: {
         type: "json_schema",
@@ -5213,7 +5504,7 @@ function buildOpenAIAnswerRequest(query2, config, options) {
   return {
     model,
     input: query2,
-    tools: [{ type: "web_search_preview" }],
+    tools: [buildOpenAIWebSearchTool(mergedOptions)],
     ...instructions ? { instructions } : {}
   };
 }
@@ -5226,11 +5517,41 @@ function buildOpenAIResearchRequest(input, config, options) {
     model,
     input,
     background: true,
-    tools: [{ type: "web_search_preview" }],
+    tools: [buildOpenAIWebSearchTool(mergedOptions)],
     ...instructions ? { instructions } : {},
     ...maxToolCalls ? { max_tool_calls: maxToolCalls } : {}
   };
 }
+function buildOpenAIWebSearchTool(options) {
+  const tool = { type: "web_search" };
+  if (options.searchContextSize) {
+    tool.search_context_size = options.searchContextSize;
+  }
+  if (options.allowedDomains && options.allowedDomains.length > 0) {
+    tool.filters = { allowed_domains: options.allowedDomains };
+  }
+  if (options.userLocation) {
+    tool.user_location = {
+      type: "approximate",
+      ...options.userLocation
+    };
+  }
+  return tool;
+}
+function resolveOpenAIWebSearchToolOptions(merged) {
+  const searchContextSize = readStringUnion(merged.searchContextSize, [
+    "low",
+    "medium",
+    "high"
+  ]);
+  const allowedDomains = readStringArray(merged.allowedDomains);
+  const userLocation = readUserLocation(merged.userLocation);
+  return {
+    ...searchContextSize ? { searchContextSize } : {},
+    ...allowedDomains ? { allowedDomains } : {},
+    ...userLocation ? { userLocation } : {}
+  };
+}
 function resolveOpenAISearchOptions(config, options) {
   const mergedOptions = {
     ...config.options?.search ?? {},
@@ -5240,7 +5561,8 @@ function resolveOpenAISearchOptions(config, options) {
   const instructions = readNonEmptyString4(mergedOptions.instructions);
   return {
     ...model ? { model } : {},
-    ...instructions ? { instructions } : {}
+    ...instructions ? { instructions } : {},
+    ...resolveOpenAIWebSearchToolOptions(mergedOptions)
   };
 }
 function resolveOpenAIAnswerOptions(config, options) {
@@ -5252,7 +5574,8 @@ function resolveOpenAIAnswerOptions(config, options) {
   const instructions = readNonEmptyString4(mergedOptions.instructions);
   return {
     ...model ? { model } : {},
-    ...instructions ? { instructions } : {}
+    ...instructions ? { instructions } : {},
+    ...resolveOpenAIWebSearchToolOptions(mergedOptions)
   };
 }
 function resolveOpenAIResearchOptions(config, options) {
@@ -5266,7 +5589,8 @@ function resolveOpenAIResearchOptions(config, options) {
   return {
     ...model ? { model } : {},
     ...instructions ? { instructions } : {},
-    ...maxToolCalls ? { max_tool_calls: maxToolCalls } : {}
+    ...maxToolCalls ? { max_tool_calls: maxToolCalls } : {},
+    ...resolveOpenAIWebSearchToolOptions(mergedOptions)
   };
 }
 function buildRequestOptions2(signal, idempotencyKey) {
@@ -5431,6 +5755,35 @@ function formatIncompleteError(response, operation) {
 function readNonEmptyString4(value) {
   return typeof value === "string" && value.trim().length > 0 ? value : void 0;
 }
+function readStringArray(value) {
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const strings = value.filter(
+    (item) => typeof item === "string" && item.trim() !== ""
+  );
+  return strings.length > 0 ? strings : void 0;
+}
+function readStringUnion(value, values) {
+  return typeof value === "string" && values.includes(value) ? value : void 0;
+}
+function readUserLocation(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  const location = value;
+  const city = readNonEmptyString4(location.city);
+  const country = readNonEmptyString4(location.country);
+  const region = readNonEmptyString4(location.region);
+  const timezone = readNonEmptyString4(location.timezone);
+  const result = {
+    ...city ? { city } : {},
+    ...country ? { country } : {},
+    ...region ? { region } : {},
+    ...timezone ? { timezone } : {}
+  };
+  return Object.keys(result).length > 0 ? result : void 0;
+}
 function readPositiveInteger2(value) {
   return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : void 0;
 }
@@ -5455,6 +5808,7 @@ var openaiProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: openaiImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: openaiSearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await openaiImplementation.search(
@@ -5497,13 +5851,19 @@ import { Type as Type11 } from "typebox";
 var parallelSearchOptionsSchema = Type11.Object(
   {
     mode: Type11.Optional(
-      literalUnion(["agentic", "one-shot"], {
-        description: "Parallel search mode. Use 'agentic' for exploratory or multi-step source discovery and 'one-shot' for direct, simple searches."
+      literalUnion(["advanced", "basic", "turbo"], {
+        description: "Parallel search mode. Use 'advanced' for higher quality, 'basic' for lower latency, or 'turbo' for the fastest responses."
       })
     )
   },
   { description: "Parallel search options." }
 );
+var parallelSearchPromptGuidelines = [
+  "Use Parallel mode='advanced' for exploratory, ambiguous, or multi-hop source discovery where the provider should plan the search.",
+  "Use Parallel mode='basic' for direct factual lookups and simple source finding where low latency is preferred.",
+  "Use Parallel mode='turbo' only when fastest responses matter more than recall or depth.",
+  "Prefer web_contents with Parallel extraction when a URL set is already known and the task needs full page content rather than more source discovery."
+];
 var parallelExtractOptionsSchema = Type11.Object(
   {
     excerpts: Type11.Optional(
@@ -5536,7 +5896,7 @@ var parallelImplementation = {
       credentials: { api: "PARALLEL_API_KEY" },
       options: {
         search: {
-          mode: "agentic"
+          mode: "advanced"
         },
         extract: {
           excerpts: false,
@@ -5551,13 +5911,11 @@ var parallelImplementation = {
   async search(query2, maxResults, config, context, options) {
     const client = createClient6(config);
     const defaults = asJsonObject(config.options?.search) ?? {};
-    const response = await client.beta.search(
-      {
+    const response = await client.search(
+      buildParallelSearchParams(query2, maxResults, {
         ...defaults,
-        ...options ?? {},
-        objective: query2,
-        max_results: maxResults
-      },
+        ...options ?? {}
+      }),
       buildRequestOptions3(context)
     );
     return {
@@ -5572,12 +5930,11 @@ var parallelImplementation = {
   async contents(urls, config, context, options) {
     const client = createClient6(config);
     const defaults = asJsonObject(config.options?.extract) ?? {};
-    const response = await client.beta.extract(
-      {
+    const response = await client.extract(
+      buildParallelExtractParams(urls, {
         ...defaults,
-        ...options ?? {},
-        urls
-      },
+        ...options ?? {}
+      }),
       buildRequestOptions3(context)
     );
     const resultsByUrl = new Map(
@@ -5609,6 +5966,62 @@ var parallelImplementation = {
     };
   }
 };
+function buildParallelSearchParams(query2, maxResults, options) {
+  const {
+    advanced_settings: advancedSettingsValue,
+    max_results: _legacyMaxResults,
+    mode: modeValue,
+    objective: objectiveValue,
+    search_queries: _searchQueries,
+    ...rest
+  } = options;
+  const advancedSettings = readObjectOption(advancedSettingsValue);
+  const mode = normalizeParallelSearchMode(modeValue);
+  const objective = typeof objectiveValue === "string" && objectiveValue.trim() ? objectiveValue.trim() : query2;
+  return {
+    ...rest,
+    search_queries: [query2],
+    objective,
+    ...mode ? { mode } : {},
+    advanced_settings: {
+      ...advancedSettings,
+      max_results: maxResults
+    }
+  };
+}
+function buildParallelExtractParams(urls, options) {
+  const {
+    advanced_settings: advancedSettingsValue,
+    excerpts: excerptsValue,
+    full_content: fullContentValue,
+    ...rest
+  } = options;
+  const advancedSettings = readObjectOption(advancedSettingsValue);
+  if (typeof fullContentValue === "boolean") {
+    advancedSettings.full_content = fullContentValue;
+  }
+  if (typeof excerptsValue === "boolean" && advancedSettings.excerpt_settings === void 0) {
+    advancedSettings.excerpt_settings = excerptsValue ? {} : { max_chars_per_result: 0 };
+  }
+  return {
+    ...rest,
+    urls,
+    advanced_settings: advancedSettings
+  };
+}
+function normalizeParallelSearchMode(value) {
+  switch (value) {
+    case "advanced":
+    case "basic":
+    case "turbo":
+      return value;
+    default:
+      return void 0;
+  }
+}
+function readObjectOption(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? { ...value } : {};
+}
 function createClient6(config) {
   const apiKey = resolveConfigValue(config.credentials?.api);
   if (!apiKey) {
@@ -5639,6 +6052,7 @@ var parallelProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: parallelImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: parallelSearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await parallelImplementation.search(
@@ -5690,6 +6104,12 @@ var perplexitySearchOptionsSchema = Type12.Object(
   },
   { description: "Perplexity search options." }
 );
+var perplexitySearchPromptGuidelines = [
+  "Use Perplexity search for concise web result retrieval with recency and domain filters, not for synthesized answers.",
+  "Set search_recency_filter when freshness matters, such as breaking news, recently updated documentation, prices, or current events.",
+  "Set search_domain_filter when the user asks for primary sources, official documentation, or domain-scoped retrieval.",
+  "Use web_answer or web_research with Perplexity when the user wants synthesis rather than a list of candidate sources."
+];
 var perplexityAnswerOptionsSchema = Type12.Object(
   {
     model: Type12.Optional(
@@ -5959,6 +6379,7 @@ var perplexityProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: perplexityImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: perplexitySearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await perplexityImplementation.search(
@@ -6687,6 +7108,12 @@ var tavilySearchOptionsSchema = Type14.Object(
   },
   { description: "Tavily search options." }
 );
+var tavilySearchPromptGuidelines = [
+  "Use Tavily topic='news' for recent journalism or current events and topic='finance' for market or company-finance research; otherwise leave topic as general.",
+  "Use searchDepth='advanced' for broader or higher-recall source discovery, and 'basic' for quick direct lookups.",
+  "Set timeRange, days, or country when the user asks for freshness, recency, or geography-specific results.",
+  "Set includeRawContent or includeAnswer only when the search response itself should carry more context; prefer web_contents for selected source inspection."
+];
 var tavilyExtractOptionsSchema = Type14.Object(
   {
     extractDepth: Type14.Optional(
@@ -6848,6 +7275,7 @@ var tavilyProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: tavilyImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: tavilySearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await tavilyImplementation.search(
@@ -6890,32 +7318,230 @@ var valyuSearchOptionsSchema = Type15.Object(
     ),
     countryCode: Type15.Optional(
       Type15.String({ description: "Country code to scope search results." })
-    )
-  },
-  { description: "Valyu search options." }
-);
-var valyuAnswerOptionsSchema = Type15.Object(
-  {
-    responseLength: Type15.Optional(
-      literalUnion(["short", "medium", "large", "max"], {
-        description: "Response length for answers."
-      })
     ),
-    countryCode: Type15.Optional(
-      Type15.String({ description: "Country code to scope answer results." })
-    )
-  },
-  { description: "Valyu answer options." }
-);
-var valyuResearchOptionsSchema = Type15.Object(
-  {
-    responseLength: Type15.Optional(
-      literalUnion(["short", "medium", "large", "max"], {
-        description: "Response length for research."
+    maxPrice: Type15.Optional(
+      Type15.Number({
+        minimum: 0,
+        description: "Maximum price per thousand characters (CPM)."
+      })
+    ),
+    relevanceThreshold: Type15.Optional(
+      Type15.Number({
+        minimum: 0,
+        maximum: 1,
+        description: "Minimum result relevance score."
+      })
+    ),
+    includedSources: Type15.Optional(
+      Type15.Array(Type15.String(), {
+        description: "Restrict retrieval to these Valyu sources."
+      })
+    ),
+    excludeSources: Type15.Optional(
+      Type15.Array(Type15.String(), {
+        description: "Exclude these Valyu sources."
+      })
+    ),
+    sourceBiases: Type15.Optional(
+      Type15.Record(Type15.String(), Type15.Number(), {
+        description: "Per-source relevance bias weights."
+      })
+    ),
+    category: Type15.Optional(
+      Type15.String({ description: "Valyu source category to search." })
+    ),
+    startDate: Type15.Optional(
+      Type15.String({ description: "ISO date string for earliest result date." })
+    ),
+    endDate: Type15.Optional(
+      Type15.String({ description: "ISO date string for latest result date." })
+    ),
+    historicalCache: Type15.Optional(
+      Type15.Boolean({
+        description: "Allow Valyu historical cache usage when supported."
+      })
+    ),
+    fastMode: Type15.Optional(
+      Type15.Boolean({
+        description: "Use Valyu fast mode when lower latency is preferred."
+      })
+    ),
+    urlOnly: Type15.Optional(
+      Type15.Boolean({
+        description: "Return URL-focused results with less content."
+      })
+    ),
+    instructions: Type15.Optional(
+      Type15.String({
+        description: "Provider instructions for retrieval and result selection."
+      })
+    )
+  },
+  { description: "Valyu search options." }
+);
+var valyuSearchPromptGuidelines = [
+  "Use Valyu searchType='news' for recent journalism or current events, 'web' for public web results, and 'proprietary' when proprietary Valyu sources are required.",
+  "Use includedSources, excludeSources, category, or source biases from configuration when the user asks for source-specific retrieval.",
+  "Use startDate/endDate and countryCode when the task requires temporal or geographic scoping.",
+  "Set responseLength higher only when search results need richer inline context; otherwise prefer concise results and follow up with web_contents."
+];
+var valyuContentsOptionsSchema = Type15.Object(
+  {
+    summary: Type15.Optional(
+      Type15.Union(
+        [Type15.Boolean(), Type15.String(), Type15.Record(Type15.String(), Type15.Any())],
+        {
+          description: "Whether to include a summary, or instructions for the summary."
+        }
+      )
+    ),
+    extractEffort: Type15.Optional(
+      literalUnion(["normal", "high", "auto"], {
+        description: "Extraction effort. Use 'high' for difficult pages and 'normal' for faster extraction."
+      })
+    ),
+    responseLength: Type15.Optional(
+      Type15.Union(
+        [
+          literalUnion(["short", "medium", "large", "max"]),
+          Type15.Number({ minimum: 0 })
+        ],
+        {
+          description: "Content response length."
+        }
+      )
+    ),
+    maxPriceDollars: Type15.Optional(
+      Type15.Number({
+        minimum: 0,
+        description: "Maximum extraction cost in USD."
+      })
+    ),
+    screenshot: Type15.Optional(
+      Type15.Boolean({
+        description: "Include screenshot capture when supported."
+      })
+    ),
+    startDate: Type15.Optional(
+      Type15.String({
+        description: "ISO date string for earliest content date."
+      })
+    ),
+    endDate: Type15.Optional(
+      Type15.String({ description: "ISO date string for latest content date." })
+    ),
+    historicalCache: Type15.Optional(
+      Type15.Boolean({
+        description: "Allow Valyu historical cache usage when supported."
+      })
+    )
+  },
+  { description: "Valyu contents options." }
+);
+var valyuAnswerOptionsSchema = Type15.Object(
+  {
+    structuredOutput: Type15.Optional(
+      Type15.Record(Type15.String(), Type15.Any(), {
+        description: "JSON schema-like structured output specification."
+      })
+    ),
+    systemInstructions: Type15.Optional(
+      Type15.String({
+        description: "System instructions that guide Valyu answer generation."
+      })
+    ),
+    searchType: Type15.Optional(
+      literalUnion(["all", "web", "proprietary", "news"], {
+        description: "Valyu search type for answer grounding."
+      })
+    ),
+    dataMaxPrice: Type15.Optional(
+      Type15.Number({
+        minimum: 0,
+        description: "Maximum data retrieval price for answer grounding."
       })
     ),
     countryCode: Type15.Optional(
-      Type15.String({ description: "Country code to scope research results." })
+      Type15.String({ description: "Country code to scope answer results." })
+    ),
+    includedSources: Type15.Optional(
+      Type15.Array(Type15.String(), {
+        description: "Restrict answer grounding to these Valyu sources."
+      })
+    ),
+    excludedSources: Type15.Optional(
+      Type15.Array(Type15.String(), {
+        description: "Exclude these Valyu sources from answer grounding."
+      })
+    ),
+    startDate: Type15.Optional(
+      Type15.String({ description: "ISO date string for earliest source date." })
+    ),
+    endDate: Type15.Optional(
+      Type15.String({ description: "ISO date string for latest source date." })
+    ),
+    fastMode: Type15.Optional(
+      Type15.Boolean({
+        description: "Use Valyu fast mode when lower latency is preferred."
+      })
+    )
+  },
+  { description: "Valyu answer options." }
+);
+var valyuResearchOptionsSchema = Type15.Object(
+  {
+    mode: Type15.Optional(
+      literalUnion(["fast", "standard", "lite", "heavy", "max"], {
+        description: "Valyu deep research mode."
+      })
+    ),
+    outputFormats: Type15.Optional(
+      Type15.Array(
+        Type15.Union([
+          literalUnion(["markdown", "pdf", "toon"]),
+          Type15.Record(Type15.String(), Type15.Any())
+        ]),
+        { description: "Requested Valyu research output formats." }
+      )
+    ),
+    search: Type15.Optional(
+      Type15.Object(
+        {
+          searchType: Type15.Optional(
+            literalUnion(["all", "web", "proprietary"], {
+              description: "Valyu source pool for research."
+            })
+          ),
+          includedSources: Type15.Optional(Type15.Array(Type15.String())),
+          excludedSources: Type15.Optional(Type15.Array(Type15.String())),
+          sourceBiases: Type15.Optional(
+            Type15.Record(Type15.String(), Type15.Number())
+          ),
+          startDate: Type15.Optional(Type15.String()),
+          endDate: Type15.Optional(Type15.String()),
+          historicalCache: Type15.Optional(Type15.Boolean()),
+          category: Type15.Optional(Type15.String()),
+          countryCode: Type15.Optional(Type15.String())
+        },
+        {
+          additionalProperties: false,
+          description: "Valyu deep research search configuration."
+        }
+      )
+    ),
+    tools: Type15.Optional(
+      Type15.Object(
+        {
+          code_execution: Type15.Optional(boolOrConfig()),
+          screenshots: Type15.Optional(boolOrConfig()),
+          browser_use: Type15.Optional(boolOrConfig()),
+          charts: Type15.Optional(boolOrConfig())
+        },
+        {
+          additionalProperties: false,
+          description: "Valyu deep research tool configuration."
+        }
+      )
     )
   },
   { description: "Valyu research options." }
@@ -6928,6 +7554,8 @@ var valyuImplementation = {
     switch (capability) {
       case "search":
         return valyuSearchOptionsSchema;
+      case "contents":
+        return valyuContentsOptionsSchema;
       case "answer":
         return valyuAnswerOptionsSchema;
       case "research":
@@ -6975,7 +7603,10 @@ var valyuImplementation = {
   },
   async contents(urls, config, _context, options) {
     const client = createClient9(config);
-    const response = await client.contents(urls, options);
+    const response = await client.contents(urls, {
+      ...asJsonObject(config.options?.contents) ?? {},
+      ...options ?? {}
+    });
     const finalResponse = "jobId" in response ? await client.waitForJob(response.jobId, {}) : response;
     if (!finalResponse.success) {
       throw new Error(finalResponse.error || "contents failed");
@@ -7121,7 +7752,7 @@ var valyuProvider = defineProvider({
   config: {
     createTemplate: () => valyuImplementation.createTemplate(),
     fields: ["credentials", "baseUrl", "options", "settings"],
-    optionCapabilities: ["search", "answer", "research"]
+    optionCapabilities: ["search", "contents", "answer", "research"]
   },
   getCapabilityStatus: (config, cwd, tool, options) => valyuImplementation.getCapabilityStatus(
     config,
@@ -7132,6 +7763,7 @@ var valyuProvider = defineProvider({
   capabilities: {
     search: defineCapability({
       options: valyuImplementation.getToolOptionsSchema?.("search"),
+      promptGuidelines: valyuSearchPromptGuidelines,
       async execute(input, ctx) {
         const { query: query2, maxResults, options } = input;
         return await valyuImplementation.search(
@@ -7849,45 +8481,6 @@ ${JSON.stringify(value, null, 2).trim()}
 \`\`\``;
 }
 
-// src/options.ts
-function buildToolOptionsSchema(_capability, providerSchema) {
-  if (!providerSchema || Object.keys(providerSchema.properties).length === 0) {
-    return void 0;
-  }
-  return closeObjectSchemas(providerSchema);
-}
-function closeObjectSchemas(schema) {
-  if (!isSchemaRecord(schema)) {
-    return schema;
-  }
-  const properties = isSchemaRecord(schema.properties) ? Object.fromEntries(
-    Object.entries(schema.properties).map(([key, value]) => [
-      key,
-      closeObjectSchemas(value)
-    ])
-  ) : schema.properties;
-  const items = isSchemaRecord(schema.items) ? closeObjectSchemas(schema.items) : Array.isArray(schema.items) ? schema.items.map((item) => closeObjectSchemas(item)) : schema.items;
-  return {
-    ...schema,
-    ...properties ? { properties } : {},
-    ...items ? { items } : {},
-    ...mapSchemaArray(schema, "anyOf"),
-    ...mapSchemaArray(schema, "oneOf"),
-    ...mapSchemaArray(schema, "allOf"),
-    ...schema.type === "object" && isSchemaRecord(schema.properties) ? { additionalProperties: false } : {}
-  };
-}
-function mapSchemaArray(schema, key) {
-  const value = schema[key];
-  return Array.isArray(value) ? { [key]: value.map((entry) => closeObjectSchemas(entry)) } : {};
-}
-function isSchemaRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-// src/prefetch-manager.ts
-import { createHash } from "node:crypto";
-
 // src/provider-resolution.ts
 function supportsTool2(provider, tool) {
   return provider.capabilities[tool] !== void 0;
@@ -8029,68 +8622,202 @@ function resolveProviderForTool(config, cwd, tool, explicit) {
   return provider;
 }
 
-// src/provider-runtime.ts
-async function executeProviderRequest(provider, config, request, context) {
-  return await executeProviderExecution(
+// src/managed-tools.ts
+var CAPABILITY_TOOL_NAMES = {
+  search: "web_search",
+  contents: "web_contents",
+  answer: "web_answer",
+  research: "web_research"
+};
+var MANAGED_TOOL_NAMES = Object.values(CAPABILITY_TOOL_NAMES);
+function getAvailableProviderIdsForCapability(config, cwd, capability) {
+  const providerId = getMappedProviderIdForTool(config, capability);
+  if (!providerId) {
+    return [];
+  }
+  const provider = PROVIDERS_BY_ID[providerId];
+  if (!supportsTool2(provider, capability)) {
+    return [];
+  }
+  const status = getProviderCapabilityStatus(
+    config,
+    cwd,
+    providerId,
+    capability,
     {
-      capability: request.capability,
-      providerLabel: provider.label,
-      settings: config.settings,
-      execute: (executionContext) => executeProviderCapability(
-        provider,
-        request.capability,
-        providerInputFromRequest(request),
-        {
-          ...executionContext,
-          config
-        }
-      )
-    },
-    context
+      resolveSecrets: false
+    }
   );
+  return isProviderCapabilityExposable(status) ? [providerId] : [];
 }
-async function executeProviderExecution(execution, context) {
-  if (execution.capability === "research") {
-    const deadline = createResearchDeadlineSignal(
-      context.signal,
-      execution.providerLabel,
-      execution.settings?.researchTimeoutMs
-    );
-    try {
-      const researchContext = deadline ? { ...context, signal: deadline.signal } : context;
-      return await withAbortSignal(
-        execution.execute(researchContext),
-        researchContext.signal
-      );
-    } catch (error) {
-      throw new Error(
-        formatProviderDiagnostic(
-          execution.providerLabel,
-          formatErrorMessage(error)
-        )
-      );
-    } finally {
-      deadline?.cleanup();
+function getProviderStatusForTool(config, cwd, providerId, capability) {
+  return getProviderCapabilityStatus(config, cwd, providerId, capability);
+}
+function getAvailableManagedToolNames(config, cwd) {
+  return Object.keys(CAPABILITY_TOOL_NAMES).filter(
+    (capability) => getAvailableProviderIdsForCapability(config, cwd, capability).length > 0
+  ).map((capability) => CAPABILITY_TOOL_NAMES[capability]);
+}
+function getSyncedActiveTools(config, cwd, activeToolNames, options) {
+  const availableToolNames = new Set(getAvailableManagedToolNames(config, cwd));
+  const nextActiveTools = new Set(activeToolNames);
+  for (const toolName of MANAGED_TOOL_NAMES) {
+    if (availableToolNames.has(toolName)) {
+      if (options.addAvailable) {
+        nextActiveTools.add(toolName);
+      }
+      continue;
     }
+    nextActiveTools.delete(toolName);
   }
-  const requestPolicy = resolveExecutionPolicy(execution.settings);
+  return nextActiveTools;
+}
+async function refreshManagedTools(pi, registerManagedTools2, cwd, options) {
+  const config = await loadConfig();
+  const nextActiveTools = getSyncedActiveTools(
+    config,
+    cwd,
+    pi.getActiveTools(),
+    options
+  );
+  registerManagedTools2({
+    search: getAvailableProviderIdsForCapability(config, cwd, "search"),
+    contents: getAvailableProviderIdsForCapability(config, cwd, "contents"),
+    answer: getAvailableProviderIdsForCapability(config, cwd, "answer"),
+    research: getAvailableProviderIdsForCapability(config, cwd, "research")
+  });
+  await syncManagedToolAvailability(pi, nextActiveTools);
+}
+async function refreshManagedToolsOnStartup(pi, registerManagedTools2, cwd, options) {
   try {
-    return await runWithExecutionPolicy(
-      `${execution.providerLabel} ${execution.capability} request`,
-      execution.execute,
-      requestPolicy,
-      context
-    );
+    await refreshManagedTools(pi, registerManagedTools2, cwd, options);
   } catch (error) {
-    throw new Error(
-      formatProviderDiagnostic(
-        execution.providerLabel,
-        formatErrorMessage(error)
+    pi.sendMessage({
+      customType: "web-providers-config-error",
+      content: formatStartupConfigError(error),
+      display: true
+    });
+    await syncManagedToolAvailability(
+      pi,
+      new Set(
+        pi.getActiveTools().filter((toolName) => !MANAGED_TOOL_NAMES.includes(toolName))
       )
     );
   }
 }
-function providerInputFromRequest(request) {
+function formatStartupConfigError(error) {
+  const detail = error instanceof Error ? error.message : String(error);
+  return `web-providers config error: ${detail.replace(getConfigPath(), "~/.pi/agent/web-providers.json")}`;
+}
+async function syncManagedToolAvailability(pi, nextActiveTools) {
+  const activeTools = pi.getActiveTools();
+  const changed = activeTools.length !== nextActiveTools.size || activeTools.some((toolName) => !nextActiveTools.has(toolName));
+  if (changed) {
+    pi.setActiveTools(Array.from(nextActiveTools));
+  }
+}
+
+// src/options.ts
+function buildToolOptionsSchema(_capability, providerSchema) {
+  if (!providerSchema || Object.keys(providerSchema.properties).length === 0) {
+    return void 0;
+  }
+  return closeObjectSchemas(providerSchema);
+}
+function closeObjectSchemas(schema) {
+  if (!isSchemaRecord(schema)) {
+    return schema;
+  }
+  const properties = isSchemaRecord(schema.properties) ? Object.fromEntries(
+    Object.entries(schema.properties).map(([key, value]) => [
+      key,
+      closeObjectSchemas(value)
+    ])
+  ) : schema.properties;
+  const items = isSchemaRecord(schema.items) ? closeObjectSchemas(schema.items) : Array.isArray(schema.items) ? schema.items.map((item) => closeObjectSchemas(item)) : schema.items;
+  return {
+    ...schema,
+    ...properties ? { properties } : {},
+    ...items ? { items } : {},
+    ...mapSchemaArray(schema, "anyOf"),
+    ...mapSchemaArray(schema, "oneOf"),
+    ...mapSchemaArray(schema, "allOf"),
+    ...schema.type === "object" && isSchemaRecord(schema.properties) ? { additionalProperties: false } : {}
+  };
+}
+function mapSchemaArray(schema, key) {
+  const value = schema[key];
+  return Array.isArray(value) ? { [key]: value.map((entry) => closeObjectSchemas(entry)) } : {};
+}
+function isSchemaRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/prefetch-manager.ts
+import { createHash } from "node:crypto";
+
+// src/provider-runtime.ts
+async function executeProviderRequest(provider, config, request, context) {
+  return await executeProviderExecution(
+    {
+      capability: request.capability,
+      providerLabel: provider.label,
+      settings: config.settings,
+      execute: (executionContext) => executeProviderCapability(
+        provider,
+        request.capability,
+        providerInputFromRequest(request),
+        {
+          ...executionContext,
+          config
+        }
+      )
+    },
+    context
+  );
+}
+async function executeProviderExecution(execution, context) {
+  if (execution.capability === "research") {
+    const deadline = createResearchDeadlineSignal(
+      context.signal,
+      execution.providerLabel,
+      execution.settings?.researchTimeoutMs
+    );
+    try {
+      const researchContext = deadline ? { ...context, signal: deadline.signal } : context;
+      return await withAbortSignal(
+        execution.execute(researchContext),
+        researchContext.signal
+      );
+    } catch (error) {
+      throw new Error(
+        formatProviderDiagnostic(
+          execution.providerLabel,
+          formatErrorMessage(error)
+        )
+      );
+    } finally {
+      deadline?.cleanup();
+    }
+  }
+  const requestPolicy = resolveExecutionPolicy(execution.settings);
+  try {
+    return await runWithExecutionPolicy(
+      `${execution.providerLabel} ${execution.capability} request`,
+      execution.execute,
+      requestPolicy,
+      context
+    );
+  } catch (error) {
+    throw new Error(
+      formatProviderDiagnostic(
+        execution.providerLabel,
+        formatErrorMessage(error)
+      )
+    );
+  }
+}
+function providerInputFromRequest(request) {
   switch (request.capability) {
     case "search":
       return {
@@ -8122,7 +8849,7 @@ function resolveExecutionPolicy(defaults) {
     retryDelayMs: defaults?.retryDelayMs ?? 2e3
   };
 }
-function createResearchDeadlineSignal(signal, providerLabel, timeoutMs) {
+function createResearchDeadlineSignal(signal, providerLabel2, timeoutMs) {
   if (timeoutMs === void 0) {
     return void 0;
   }
@@ -8137,7 +8864,7 @@ function createResearchDeadlineSignal(signal, providerLabel, timeoutMs) {
   const timer = setTimeout(() => {
     controller.abort(
       new Error(
-        `${providerLabel} research exceeded ${formatDuration(timeoutMs)}.`
+        `${providerLabel2} research exceeded ${formatDuration(timeoutMs)}.`
       )
     );
   }, timeoutMs);
@@ -8961,9 +9688,9 @@ var PROVIDER_SETTINGS = {
           "hybrid",
           "fast",
           "instant",
+          "deep-lite",
           "deep",
-          "deep-reasoning",
-          "deep-max"
+          "deep-reasoning"
         ],
         getValue: (config) => readString5(getExaSearchOptions(config)?.type) ?? "default",
         setValue: (config, value) => {
@@ -9191,7 +9918,7 @@ var PROVIDER_SETTINGS = {
         id: "parallelSearchMode",
         label: "Search mode",
         help: "Parallel search mode. 'default' uses the SDK default.",
-        values: ["default", "agentic", "one-shot"],
+        values: ["default", "advanced", "basic", "turbo"],
         getValue: (config) => readString5(getParallelOptions(config)?.search?.mode) ?? "default",
         setValue: (config, value) => {
           const options = ensureParallelOptions(config);
@@ -9285,27 +10012,19 @@ var PROVIDER_SETTINGS = {
         }
       }),
       valuesSetting({
-        id: "valyuAnswerResponseLength",
-        label: "Answer response length",
-        help: "Valyu answer response length. 'default' uses the SDK default.",
-        values: ["default", "short", "medium", "large", "max"],
-        getValue: (config) => readString5(
-          getValyuCapabilityOptions(config, "answer")?.responseLength
-        ) ?? "default",
-        setValue: (config, value) => {
-          setValyuResponseLength(config, "answer", value);
-        }
-      }),
-      valuesSetting({
-        id: "valyuResearchResponseLength",
-        label: "Research response length",
-        help: "Valyu research response length. 'default' uses the SDK default.",
-        values: ["default", "short", "medium", "large", "max"],
-        getValue: (config) => readString5(
-          getValyuCapabilityOptions(config, "research")?.responseLength
-        ) ?? "default",
+        id: "valyuResearchMode",
+        label: "Research mode",
+        help: "Valyu research mode. 'default' uses the SDK default.",
+        values: ["default", "fast", "standard", "lite", "heavy", "max"],
+        getValue: (config) => readString5(getValyuCapabilityOptions(config, "research")?.mode) ?? "default",
         setValue: (config, value) => {
-          setValyuResponseLength(config, "research", value);
+          const options = ensureValyuCapabilityOptions(config, "research");
+          if (value === "default") {
+            delete options.mode;
+          } else {
+            options.mode = value;
+          }
+          cleanupCapabilityOptions(config, ["search", "answer", "research"]);
         }
       })
     ]
@@ -9792,76 +10511,1030 @@ function getFirstLine(text) {
   return text?.split("\n").map((line) => line.trim()).find((line) => line.length > 0);
 }
 
-// src/index.ts
-var DEFAULT_MAX_RESULTS = 5;
-var MAX_ALLOWED_RESULTS = 20;
-var MAX_SEARCH_QUERIES = 10;
-var RESEARCH_HEARTBEAT_MS = 15e3;
-var WEB_RESEARCH_RESULT_MESSAGE_TYPE = "web-research-result";
-var WEB_RESEARCH_WIDGET_KEY = "web-research-jobs";
+// src/web-research-lifecycle.ts
+import { randomUUID } from "node:crypto";
+import { mkdir as mkdir2, readdir, readFile as readFile2, stat, writeFile as writeFile2 } from "node:fs/promises";
+import { dirname as dirname2, join as join2 } from "node:path";
 var RESEARCH_ARTIFACTS_DIR = join2(".pi", "artifacts", "research");
+var MAX_RESEARCH_HISTORY_ITEMS = 20;
+var RESEARCH_PREVIEW_MAX_BYTES = 5e4;
+var RESEARCH_REPORT_MAX_BYTES = 2e5;
 var pendingResearchTasks = /* @__PURE__ */ new Set();
-var CAPABILITY_TOOL_NAMES = {
-  search: "web_search",
-  contents: "web_contents",
-  answer: "web_answer",
-  research: "web_research"
-};
-var MANAGED_TOOL_NAMES = Object.values(CAPABILITY_TOOL_NAMES);
-var DEFAULT_SUMMARY_SYMBOLS = {
-  success: "\u2714",
-  failure: "\u2718"
-};
-function webProvidersExtension(pi) {
-  const activeWebResearchRequests = /* @__PURE__ */ new Map();
-  let latestWidgetContext;
-  let webResearchWidgetTimer;
-  const stopWebResearchWidgetTimer = () => {
-    if (webResearchWidgetTimer) {
-      clearInterval(webResearchWidgetTimer);
-      webResearchWidgetTimer = void 0;
-    }
-  };
-  const ensureWebResearchWidgetTimer = () => {
-    if (webResearchWidgetTimer || activeWebResearchRequests.size === 0) {
-      return;
+async function dispatchWebResearch({
+  activeWebResearchRequests,
+  config,
+  explicitProvider,
+  ctx,
+  options,
+  input,
+  executionOverride,
+  executeResearch,
+  deliverResult,
+  onJobsChanged,
+  resultMessageType
+}) {
+  await cleanupContentStore();
+  const provider = resolveProviderForTool(
+    config,
+    ctx.cwd,
+    "research",
+    explicitProvider
+  );
+  const request = createWebResearchRequest(ctx.cwd, provider.id, input);
+  const abortController = new AbortController();
+  const task = { request, abortController };
+  const providerConfig = getEffectiveProviderConfig(config, provider.id);
+  activeWebResearchRequests.set(request.id, task);
+  onJobsChanged();
+  trackPendingResearchTask(
+    runDispatchedWebResearch({
+      activeWebResearchRequests,
+      task,
+      config,
+      provider,
+      providerConfig,
+      ctx,
+      options,
+      executionOverride,
+      executeResearch,
+      deliverResult,
+      onJobsChanged,
+      resultMessageType
+    })
+  );
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Started web research via ${provider.label}.`
+      }
+    ],
+    details: request,
+    display: {
+      provider: { id: provider.id, label: provider.label },
+      outcome: { success: "started" }
     }
-    webResearchWidgetTimer = setInterval(() => {
-      updateWebResearchWidget();
-    }, 1e3);
   };
-  const updateWebResearchWidget = (ctx) => {
-    const widgetContext = ctx ?? latestWidgetContext;
-    if (!widgetContext) {
-      return;
-    }
-    latestWidgetContext = widgetContext;
-    if (!widgetContext.hasUI) {
-      stopWebResearchWidgetTimer();
-      return;
-    }
-    if (activeWebResearchRequests.size === 0) {
-      stopWebResearchWidgetTimer();
-      widgetContext.ui.setWidget(WEB_RESEARCH_WIDGET_KEY, void 0);
-      return;
+}
+async function runDispatchedWebResearch({
+  activeWebResearchRequests,
+  task,
+  config,
+  provider,
+  providerConfig,
+  ctx,
+  options,
+  executionOverride,
+  executeResearch,
+  deliverResult,
+  onJobsChanged,
+  resultMessageType
+}) {
+  const { request, abortController } = task;
+  let result;
+  let reportText = "";
+  try {
+    const response = await executeResearch({
+      config,
+      provider,
+      providerConfig,
+      ctx,
+      signal: abortController.signal,
+      options,
+      input: request.input,
+      onProgress: (message) => {
+        request.progress = summarizeWebResearchProgress(
+          message,
+          provider.label
+        );
+        onJobsChanged();
+      },
+      executionOverride
+    });
+    result = buildWebResearchResult(request, abortController, task, response);
+    if (result.status === "completed") {
+      reportText = response.text;
     }
-    ensureWebResearchWidgetTimer();
-    widgetContext.ui.setWidget(
-      WEB_RESEARCH_WIDGET_KEY,
-      buildWebResearchWidgetLines(
-        [...activeWebResearchRequests.values()],
-        widgetContext.ui.theme
-      )
-    );
-  };
-  if ("registerMessageRenderer" in pi) {
-    pi.registerMessageRenderer(
-      WEB_RESEARCH_RESULT_MESSAGE_TYPE,
-      (message, state, theme) => renderWebResearchResultMessage(message, state, theme)
+  } catch (error) {
+    result = buildFailedWebResearchResult(
+      request,
+      abortController,
+      task,
+      error
     );
   }
-  pi.registerCommand("web-providers", {
-    description: "Configure web search providers",
+  try {
+    await writeWebResearchArtifact(result, reportText);
+    deliverResult({
+      customType: resultMessageType,
+      content: formatWebResearchResultMessage(result, reportText),
+      display: true,
+      details: result
+    });
+  } finally {
+    activeWebResearchRequests.delete(request.id);
+    onJobsChanged();
+  }
+}
+function buildWebResearchResult(request, abortController, task, response) {
+  const completedAt = (/* @__PURE__ */ new Date()).toISOString();
+  if (abortController.signal.aborted && task.cancelRequestedAt !== void 0) {
+    return {
+      ...request,
+      status: "cancelled",
+      completedAt,
+      elapsedMs: elapsedMs(request.startedAt, completedAt),
+      error: "web research was cancelled by the user."
+    };
+  }
+  return {
+    ...request,
+    status: "completed",
+    completedAt,
+    elapsedMs: elapsedMs(request.startedAt, completedAt),
+    itemCount: response.itemCount
+  };
+}
+function buildFailedWebResearchResult(request, abortController, task, error) {
+  const completedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const cancelled = abortController.signal.aborted && task.cancelRequestedAt !== void 0;
+  return {
+    ...request,
+    status: cancelled ? "cancelled" : "failed",
+    completedAt,
+    elapsedMs: elapsedMs(request.startedAt, completedAt),
+    error: cancelled ? "web research was cancelled by the user." : formatErrorMessage(error)
+  };
+}
+function elapsedMs(startedAt, completedAt) {
+  return Math.max(0, Date.parse(completedAt) - Date.parse(startedAt));
+}
+function getActiveWebResearchRequests(tasks) {
+  return [...tasks.values()].map((task) => task.request);
+}
+function getWebResearchTaskSnapshots(tasks) {
+  return [...tasks.values()].map((task) => ({
+    request: task.request,
+    cancelRequestedAt: task.cancelRequestedAt
+  }));
+}
+function cancelWebResearchTask(tasks, id) {
+  const task = tasks.get(id);
+  if (!task || task.abortController.signal.aborted) return false;
+  task.cancelRequestedAt = (/* @__PURE__ */ new Date()).toISOString();
+  task.request.progress = "cancelling";
+  task.abortController.abort(
+    new Error("web research was cancelled by the user.")
+  );
+  return true;
+}
+function createWebResearchRequest(cwd, provider, input) {
+  const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    tool: "web_research",
+    id: randomUUID(),
+    provider,
+    input,
+    outputPath: buildWebResearchArtifactPath(cwd, input, startedAt),
+    startedAt
+  };
+}
+function buildWebResearchArtifactPath(cwd, input, startedAt) {
+  const timestamp = startedAt.replaceAll(":", "-").replace(".", "-");
+  const slug = slugifyWebResearchInput(input);
+  return join2(cwd, RESEARCH_ARTIFACTS_DIR, `${timestamp}-${slug}.md`);
+}
+function slugifyWebResearchInput(input) {
+  const slug = input.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60).replace(/-+$/g, "");
+  return slug.length > 0 ? slug : "research";
+}
+function getWebResearchProgressIcon(request) {
+  if (request.progress === "poll retrying after transient errors") {
+    return "\u27F3";
+  }
+  if (request.progress === "queued" || request.progress === "cancelling") {
+    return "\u25CC";
+  }
+  if (request.progress === "starting") {
+    return "\u25D4";
+  }
+  if (request.progress?.startsWith("started:")) {
+    return "\u25D1";
+  }
+  return "\u25CF";
+}
+function summarizeWebResearchProgress(message, providerLabel2) {
+  const startingMessage = `Starting research via ${providerLabel2}`;
+  if (message === startingMessage) {
+    return "starting";
+  }
+  const startedPrefix = `${providerLabel2} research started: `;
+  if (message.startsWith(startedPrefix)) {
+    return `started: ${message.slice(startedPrefix.length)}`;
+  }
+  const statusPrefix = `Research via ${providerLabel2}: `;
+  if (message.startsWith(statusPrefix)) {
+    return message.slice(statusPrefix.length).replace(/\s+\([^)]* elapsed\)$/u, "").trim();
+  }
+  const retryPrefix = `${providerLabel2} research poll is still retrying after transient errors`;
+  if (message.startsWith(retryPrefix)) {
+    return "poll retrying after transient errors";
+  }
+  return message.trim();
+}
+function formatWebResearchResultMessage(result, reportText) {
+  const text = reportText.trim();
+  if (text.length > 0) {
+    return `${text}
+`;
+  }
+  if (result.error) {
+    return `${result.error}
+`;
+  }
+  return "";
+}
+async function writeWebResearchArtifact(result, reportText) {
+  await mkdir2(dirname2(result.outputPath), { recursive: true });
+  await writeFile2(
+    result.outputPath,
+    formatWebResearchArtifact(result, reportText),
+    "utf-8"
+  );
+}
+function formatWebResearchArtifact(result, reportText) {
+  const providerLabel2 = PROVIDERS_BY_ID[result.provider]?.label ?? result.provider;
+  const metadata = {
+    query: result.input,
+    provider: providerLabel2,
+    providerId: result.provider,
+    status: result.status,
+    startedAt: result.startedAt,
+    completedAt: result.completedAt,
+    elapsedMs: result.elapsedMs,
+    itemCount: result.itemCount,
+    error: result.error
+  };
+  const lines = [
+    "---",
+    ...Object.entries(metadata).flatMap(
+      ([key, value]) => value === void 0 ? [] : [`${key}: ${formatYamlScalar(value)}`]
+    ),
+    "---",
+    "",
+    "# Web research report"
+  ];
+  if (reportText) {
+    lines.push("", reportText);
+  }
+  return `${lines.join("\n")}
+`;
+}
+function formatYamlScalar(value) {
+  if (typeof value === "number") {
+    return String(value);
+  }
+  return JSON.stringify(value);
+}
+async function loadWebResearchHistory(cwd, maxItems = MAX_RESEARCH_HISTORY_ITEMS) {
+  const dir = join2(cwd, RESEARCH_ARTIFACTS_DIR);
+  let entries;
+  try {
+    entries = await readdir(dir);
+  } catch {
+    return [];
+  }
+  const markdown = entries.filter((name) => name.endsWith(".md"));
+  const withStats = await Promise.all(
+    markdown.map(async (fileName) => {
+      const outputPath = join2(dir, fileName);
+      try {
+        return { fileName, outputPath, stat: await stat(outputPath) };
+      } catch {
+        return void 0;
+      }
+    })
+  );
+  const newest = withStats.filter((item) => item !== void 0).sort((left, right) => right.stat.mtimeMs - left.stat.mtimeMs).slice(0, maxItems);
+  return Promise.all(
+    newest.map(async ({ fileName, outputPath, stat: stat2 }) => {
+      let content = "";
+      try {
+        content = await readFile2(outputPath, "utf-8");
+      } catch {
+      }
+      const metadata = parseWebResearchArtifactMetadata(content);
+      return {
+        outputPath,
+        fileName,
+        query: metadata.query ?? "",
+        title: deriveWebResearchTitle(content, metadata.query ?? ""),
+        provider: metadata.provider ?? "",
+        status: metadata.status ?? "unknown",
+        startedAt: metadata.startedAt ?? "",
+        completedAt: metadata.completedAt ?? "",
+        elapsedMs: computeHistoryElapsedMs(metadata),
+        mtimeMs: stat2.mtimeMs
+      };
+    })
+  );
+}
+function parseWebResearchArtifactMetadata(content) {
+  return parseWebResearchFrontmatter(content) ?? parseLegacyWebResearchArtifactMetadata(content);
+}
+function parseWebResearchFrontmatter(content) {
+  if (!content.startsWith("---\n")) {
+    return void 0;
+  }
+  const end = content.indexOf("\n---", 4);
+  if (end === -1) {
+    return void 0;
+  }
+  const result = {};
+  const frontmatter = content.slice(4, end);
+  for (const line of frontmatter.split(/\r?\n/u)) {
+    const match = /^([A-Za-z][A-Za-z0-9_-]*):\s*(.*)$/u.exec(line);
+    if (!match) {
+      continue;
+    }
+    result[match[1] ?? ""] = parseYamlScalar(match[2] ?? "");
+  }
+  return result;
+}
+function parseYamlScalar(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      return typeof parsed === "string" ? parsed : String(parsed);
+    } catch {
+    }
+  }
+  return trimmed;
+}
+function parseLegacyWebResearchArtifactMetadata(content) {
+  const result = {};
+  const metadataHeadings = /* @__PURE__ */ new Map([
+    ["Query", "query"],
+    ["Provider", "provider"],
+    ["Status", "status"],
+    ["Started", "startedAt"],
+    ["Completed", "completedAt"]
+  ]);
+  const artifactBodyHeadings = /* @__PURE__ */ new Set(["Elapsed", "Items", "Error", "Report"]);
+  const lines = content.split(/\r?\n/u);
+  for (let index = 0; index < lines.length; index++) {
+    const match = /^##\s+(.+)$/u.exec(lines[index] ?? "");
+    if (!match) continue;
+    const heading = match[1] ?? "";
+    if (artifactBodyHeadings.has(heading)) break;
+    const key = metadataHeadings.get(heading);
+    if (key === void 0 || result[key] !== void 0) continue;
+    const values = [];
+    for (let next = index + 1; next < lines.length; next++) {
+      if (/^##\s+/u.test(lines[next] ?? "")) break;
+      if ((lines[next] ?? "").trim() || values.length > 0)
+        values.push(lines[next] ?? "");
+    }
+    result[key] = values.join("\n").trim();
+  }
+  return result;
+}
+var RESEARCH_TITLE_MAX_LENGTH = 80;
+var NON_TITLE_HEADINGS = /* @__PURE__ */ new Set([
+  "Web research report",
+  "Query",
+  "Provider",
+  "Status",
+  "Started",
+  "Completed",
+  "Elapsed",
+  "Items",
+  "Error",
+  "Report"
+]);
+function deriveWebResearchTitle(content, query2) {
+  const body = getWebResearchBody(content);
+  for (const line of body.split(/\r?\n/u)) {
+    const match = /^#{1,2}\s+(.+?)\s*$/u.exec(line);
+    if (!match) continue;
+    const heading = (match[1] ?? "").trim();
+    if (heading.length > 0 && !NON_TITLE_HEADINGS.has(heading)) {
+      return heading;
+    }
+  }
+  const fallback = query2.replace(/\s+/g, " ").trim();
+  if (fallback.length <= RESEARCH_TITLE_MAX_LENGTH) {
+    return fallback;
+  }
+  return `${fallback.slice(0, RESEARCH_TITLE_MAX_LENGTH - 1)}\u2026`;
+}
+function computeHistoryElapsedMs(metadata) {
+  if (metadata.elapsedMs !== void 0) {
+    const parsed = Number(metadata.elapsedMs);
+    if (Number.isFinite(parsed) && parsed >= 0) {
+      return parsed;
+    }
+  }
+  const started = Date.parse(metadata.startedAt ?? "");
+  const completed = Date.parse(metadata.completedAt ?? "");
+  if (Number.isFinite(started) && Number.isFinite(completed)) {
+    return Math.max(0, completed - started);
+  }
+  return void 0;
+}
+function getWebResearchBody(content) {
+  if (!content.startsWith("---\n")) {
+    return content;
+  }
+  const end = content.indexOf("\n---", 4);
+  if (end === -1) {
+    return content;
+  }
+  const afterClose = content.indexOf("\n", end + 4);
+  return afterClose === -1 ? "" : content.slice(afterClose + 1);
+}
+async function loadWebResearchReport(outputPath) {
+  const buffer = await readFile2(outputPath);
+  const truncated = buffer.byteLength > RESEARCH_REPORT_MAX_BYTES;
+  const content = buffer.subarray(0, RESEARCH_REPORT_MAX_BYTES).toString("utf-8");
+  return {
+    body: getWebResearchBody(content).trim(),
+    metadata: parseWebResearchArtifactMetadata(content),
+    truncated
+  };
+}
+async function loadWebResearchPreview(outputPath) {
+  const buffer = await readFile2(outputPath);
+  const truncated = buffer.byteLength > RESEARCH_PREVIEW_MAX_BYTES;
+  const text = buffer.subarray(0, RESEARCH_PREVIEW_MAX_BYTES).toString("utf-8");
+  return truncated ? `${text}
+
+---
+Preview truncated. Open the full report at \`${outputPath}\`.` : `${text}
+
+---
+Full report: \`${outputPath}\``;
+}
+function trackPendingResearchTask(task) {
+  const tracked = task.catch(() => {
+  }).finally(() => {
+    pendingResearchTasks.delete(tracked);
+  });
+  pendingResearchTasks.add(tracked);
+}
+async function waitForPendingResearchTasks() {
+  await Promise.all([...pendingResearchTasks]);
+}
+
+// src/web-research-view.ts
+import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
+import {
+  getKeybindings,
+  Key,
+  Markdown,
+  matchesKey,
+  truncateToWidth,
+  visibleWidth
+} from "@earendil-works/pi-tui";
+var STATUS_MESSAGE_TTL_MS = 1500;
+var PAGE_JUMP = 10;
+var WebResearchManagerView = class {
+  constructor(tui, theme, done, cwd, tasks, onChange, actions, loadHistory = loadWebResearchHistory) {
+    this.tui = tui;
+    this.theme = theme;
+    this.done = done;
+    this.cwd = cwd;
+    this.tasks = tasks;
+    this.onChange = onChange;
+    this.actions = actions;
+    this.loadHistory = loadHistory;
+    void this.reloadHistory();
+  }
+  tui;
+  theme;
+  done;
+  cwd;
+  tasks;
+  onChange;
+  actions;
+  loadHistory;
+  selectedIndex = 0;
+  history = [];
+  confirmCancelId;
+  open;
+  scrollOffset = 0;
+  statusMessage;
+  statusMessageTimer;
+  isReportOpen() {
+    return this.open !== void 0;
+  }
+  render(width) {
+    if (this.open?.kind === "report") {
+      return this.renderReport(this.open, width);
+    }
+    if (this.open?.kind === "detail") {
+      const snapshot = this.findSnapshot(this.open.taskId);
+      if (snapshot) return this.renderDetail(snapshot, width);
+      this.open = void 0;
+    }
+    return this.renderTable(width);
+  }
+  invalidate() {
+  }
+  dispose() {
+    if (this.statusMessageTimer) clearTimeout(this.statusMessageTimer);
+  }
+  handleInput(data) {
+    if (this.open) {
+      this.handleOpenInput(data);
+    } else {
+      this.handleTableInput(data);
+    }
+    this.tui.requestRender();
+  }
+  refresh() {
+    if (this.open?.kind === "detail" && !this.findSnapshot(this.open.taskId)) {
+      this.open = void 0;
+      this.confirmCancelId = void 0;
+    }
+    void this.reloadHistory();
+    this.tui.requestRender();
+  }
+  // --- table mode ---
+  getRows() {
+    const snapshots = getWebResearchTaskSnapshots(this.tasks).sort(
+      (a, b) => a.request.startedAt.localeCompare(b.request.startedAt)
+    );
+    const runningPaths = new Set(
+      snapshots.map((snapshot) => snapshot.request.outputPath)
+    );
+    const rows = snapshots.map((snapshot) => ({
+      kind: "running",
+      snapshot
+    }));
+    for (const item of this.history) {
+      if (runningPaths.has(item.outputPath)) continue;
+      rows.push({ kind: "history", item });
+    }
+    return rows;
+  }
+  border(width) {
+    return this.theme.fg("border", "\u2500".repeat(Math.max(1, width)));
+  }
+  renderTable(width) {
+    const rows = this.getRows();
+    this.selectedIndex = clamp2(this.selectedIndex, 0, rows.length - 1);
+    const lines = [
+      this.border(width),
+      this.theme.fg("accent", " Web research"),
+      ""
+    ];
+    if (rows.length === 0) {
+      lines.push(this.theme.fg("muted", "  No research jobs or reports"));
+    } else {
+      const layout = computeTableLayout(rows, width);
+      const now = Date.now();
+      rows.forEach((row, index) => {
+        lines.push(
+          formatResearchTableRow(
+            row,
+            layout,
+            this.theme,
+            index === this.selectedIndex,
+            now
+          )
+        );
+        if (row.kind === "running" && this.confirmCancelId === row.snapshot.request.id) {
+          lines.push(
+            this.theme.fg(
+              "warning",
+              truncateToWidth(
+                `     Press c again to cancel this ${providerLabel(row.snapshot.request.provider)} research`,
+                width
+              )
+            )
+          );
+        }
+      });
+    }
+    lines.push("");
+    if (this.statusMessage) {
+      lines.push(this.theme.fg("accent", ` ${this.statusMessage}`));
+    }
+    lines.push(
+      this.theme.fg(
+        "dim",
+        " \u2191\u2193 move \xB7 Enter open \xB7 c cancel running \xB7 Esc close"
+      ),
+      this.border(width)
+    );
+    return lines;
+  }
+  handleTableInput(data) {
+    const kb = getKeybindings();
+    const rows = this.getRows();
+    if (kb.matches(data, "tui.select.up")) this.move(rows.length, -1);
+    else if (kb.matches(data, "tui.select.down")) this.move(rows.length, 1);
+    else if (kb.matches(data, "tui.select.pageUp"))
+      this.move(rows.length, -PAGE_JUMP, false);
+    else if (kb.matches(data, "tui.select.pageDown"))
+      this.move(rows.length, PAGE_JUMP, false);
+    else if (kb.matches(data, "tui.select.confirm"))
+      void this.openRow(rows[this.selectedIndex]);
+    else if (data === "c") this.cancelRow(rows[this.selectedIndex]);
+    else if (kb.matches(data, "tui.select.cancel")) {
+      if (this.confirmCancelId) this.confirmCancelId = void 0;
+      else this.done(void 0);
+    }
+  }
+  move(count, delta, wrap = true) {
+    this.confirmCancelId = void 0;
+    if (count === 0) return;
+    const next = this.selectedIndex + delta;
+    this.selectedIndex = wrap ? (next + count) % count : clamp2(next, 0, count - 1);
+  }
+  async openRow(row) {
+    if (!row) return;
+    this.confirmCancelId = void 0;
+    if (row.kind === "running") {
+      this.open = { kind: "detail", taskId: row.snapshot.request.id };
+      this.scrollOffset = 0;
+      return;
+    }
+    try {
+      const report = await loadWebResearchReport(row.item.outputPath);
+      this.open = {
+        kind: "report",
+        title: row.item.title || row.item.query,
+        body: report.body,
+        truncated: report.truncated,
+        item: row.item,
+        markdown: new Markdown(report.body, 1, 0, getMarkdownTheme())
+      };
+      this.scrollOffset = 0;
+    } catch (error) {
+      this.showStatusMessage(
+        `Failed to read ${row.item.outputPath}: ${formatErrorMessage(error)}`
+      );
+    }
+    this.tui.requestRender();
+  }
+  cancelRow(row) {
+    if (!row || row.kind !== "running") return;
+    const id = row.snapshot.request.id;
+    if (this.confirmCancelId !== id) {
+      this.confirmCancelId = id;
+      return;
+    }
+    cancelWebResearchTask(this.tasks, id);
+    this.confirmCancelId = void 0;
+    this.onChange();
+  }
+  // --- report / detail mode ---
+  renderReport(open, width) {
+    const lines = [
+      this.border(width),
+      this.theme.fg("accent", truncateToWidth(` ${open.title}`, width)),
+      this.theme.fg(
+        "dim",
+        " c copy markdown \xB7 i inject into context \xB7 \u2191\u2193/PgUp/PgDn scroll \xB7 Esc back"
+      ),
+      this.border(width),
+      ""
+    ];
+    let body;
+    try {
+      body = open.markdown.render(Math.max(20, width - 2));
+    } catch {
+      body = open.body.split("\n").map((line) => truncateToWidth(line, width));
+    }
+    const viewport = this.viewportHeight();
+    const maxOffset = Math.max(0, body.length - viewport);
+    this.scrollOffset = clamp2(this.scrollOffset, 0, maxOffset);
+    lines.push(...body.slice(this.scrollOffset, this.scrollOffset + viewport));
+    lines.push("");
+    const footer = [];
+    if (body.length > viewport) {
+      const end = Math.min(body.length, this.scrollOffset + viewport);
+      footer.push(`lines ${this.scrollOffset + 1}\u2013${end} of ${body.length}`);
+    }
+    if (open.truncated) {
+      footer.push(`report truncated \xB7 full text: ${open.item.outputPath}`);
+    }
+    if (this.statusMessage) {
+      lines.push(this.theme.fg("accent", ` ${this.statusMessage}`));
+    }
+    if (footer.length > 0) {
+      lines.push(
+        this.theme.fg("dim", truncateToWidth(` ${footer.join(" \xB7 ")}`, width))
+      );
+    }
+    lines.push(this.border(width));
+    return lines;
+  }
+  renderDetail(snapshot, width) {
+    const request = snapshot.request;
+    const elapsed = formatCompactElapsed(
+      Date.now() - Date.parse(request.startedAt)
+    );
+    const progress = snapshot.cancelRequestedAt ? "cancelling" : request.progress ?? "running";
+    const lines = [
+      this.border(width),
+      this.theme.fg(
+        "accent",
+        truncateToWidth(
+          ` Running research via ${providerLabel(request.provider)}`,
+          width
+        )
+      ),
+      this.theme.fg("dim", " c cancel \xB7 Esc back"),
+      this.border(width),
+      "",
+      truncateToWidth(` Status: ${progress} (${elapsed} elapsed)`, width),
+      truncateToWidth(` Report path: ${request.outputPath}`, width),
+      "",
+      this.theme.fg("accent", " Research brief"),
+      ""
+    ];
+    for (const line of request.input.split("\n").slice(0, 100)) {
+      lines.push(truncateToWidth(` ${line}`, width));
+    }
+    if (this.confirmCancelId === request.id) {
+      lines.push(
+        "",
+        this.theme.fg("warning", " Press c again to cancel this research")
+      );
+    }
+    if (this.statusMessage) {
+      lines.push("", this.theme.fg("accent", ` ${this.statusMessage}`));
+    }
+    lines.push(this.border(width));
+    return lines;
+  }
+  handleOpenInput(data) {
+    const kb = getKeybindings();
+    const open = this.open;
+    if (!open) return;
+    if (kb.matches(data, "tui.select.cancel")) {
+      if (this.confirmCancelId) {
+        this.confirmCancelId = void 0;
+        return;
+      }
+      this.open = void 0;
+      this.scrollOffset = 0;
+      return;
+    }
+    if (open.kind === "detail") {
+      if (data === "c") {
+        const snapshot = this.findSnapshot(open.taskId);
+        if (!snapshot) return;
+        if (this.confirmCancelId !== open.taskId) {
+          this.confirmCancelId = open.taskId;
+          return;
+        }
+        cancelWebResearchTask(this.tasks, open.taskId);
+        this.confirmCancelId = void 0;
+        this.onChange();
+        this.showStatusMessage("Cancellation requested");
+      }
+      return;
+    }
+    if (kb.matches(data, "tui.select.up")) this.scrollOffset -= 1;
+    else if (kb.matches(data, "tui.select.down")) this.scrollOffset += 1;
+    else if (kb.matches(data, "tui.select.pageUp"))
+      this.scrollOffset -= this.viewportHeight();
+    else if (kb.matches(data, "tui.select.pageDown"))
+      this.scrollOffset += this.viewportHeight();
+    else if (matchesKey(data, Key.home)) this.scrollOffset = 0;
+    else if (matchesKey(data, Key.end))
+      this.scrollOffset = Number.MAX_SAFE_INTEGER;
+    else if (data === "c") {
+      void this.actions.copyToClipboard(open.body).then(() => this.showStatusMessage("Copied report to clipboard")).catch((error) => {
+        const message = `Copy failed: ${formatErrorMessage(error)}`;
+        this.showStatusMessage(message);
+        this.actions.notify(message, "error");
+      });
+    } else if (data === "i") {
+      this.actions.injectReport({
+        title: open.title,
+        body: open.body,
+        item: open.item
+      });
+      this.showStatusMessage("Report added to conversation context");
+    }
+  }
+  viewportHeight() {
+    return Math.max(5, Math.floor(this.tui.terminal.rows * 0.85) - 6);
+  }
+  showStatusMessage(message) {
+    this.statusMessage = message;
+    if (this.statusMessageTimer) clearTimeout(this.statusMessageTimer);
+    this.statusMessageTimer = setTimeout(() => {
+      this.statusMessage = void 0;
+      this.statusMessageTimer = void 0;
+      this.tui.requestRender();
+    }, STATUS_MESSAGE_TTL_MS);
+  }
+  findSnapshot(taskId) {
+    return getWebResearchTaskSnapshots(this.tasks).find(
+      (snapshot) => snapshot.request.id === taskId
+    );
+  }
+  async reloadHistory() {
+    this.history = await this.loadHistory(this.cwd);
+    this.tui.requestRender();
+  }
+};
+function computeTableLayout(rows, width) {
+  const providerWidth = clamp2(
+    Math.max(0, ...rows.map((row) => visibleWidth(rowProvider(row)))),
+    4,
+    12
+  );
+  const date = 10;
+  const duration = 7;
+  const fixed = 2 + 2 + date + 1 + providerWidth + 1 + duration + 1;
+  return {
+    date,
+    provider: providerWidth,
+    duration,
+    title: Math.max(10, width - fixed)
+  };
+}
+function formatResearchTableRow(row, layout, theme, selected, now = Date.now()) {
+  const cursor = selected ? "\u203A " : "  ";
+  const glyph = statusGlyph(row, theme);
+  const date = padCell(
+    formatRelativeDate(rowTimestampMs(row), now),
+    layout.date
+  );
+  const provider = padCell(
+    truncateToWidth(rowProvider(row), layout.provider),
+    layout.provider
+  );
+  const duration = padCell(rowDuration(row, now), layout.duration, "right");
+  const title = truncateToWidth(rowTitle(row), layout.title);
+  const dim = (text) => row.kind === "history" ? text : theme.fg("dim", text);
+  return `${cursor}${glyph} ${dim(date)} ${provider} ${theme.fg("muted", duration)} ${title}`;
+}
+function statusGlyph(row, theme) {
+  if (row.kind === "running") {
+    const icon = row.snapshot.cancelRequestedAt ? "\u25CC" : getWebResearchProgressIcon(row.snapshot.request);
+    return theme.fg("accent", icon);
+  }
+  switch (row.item.status) {
+    case "completed":
+      return theme.fg("success", "\u2714");
+    case "failed":
+      return theme.fg("error", "\u2718");
+    case "cancelled":
+      return theme.fg("warning", "\u2718");
+    default:
+      return theme.fg("dim", "?");
+  }
+}
+function rowProvider(row) {
+  return row.kind === "running" ? providerLabel(row.snapshot.request.provider) : row.item.provider || "?";
+}
+function rowTimestampMs(row) {
+  if (row.kind === "running") {
+    return Date.parse(row.snapshot.request.startedAt);
+  }
+  const completed = Date.parse(row.item.completedAt);
+  if (Number.isFinite(completed)) return completed;
+  const started = Date.parse(row.item.startedAt);
+  if (Number.isFinite(started)) return started;
+  return row.item.mtimeMs;
+}
+function rowDuration(row, now) {
+  if (row.kind === "running") {
+    return formatCompactElapsed(
+      now - Date.parse(row.snapshot.request.startedAt)
+    );
+  }
+  return row.item.elapsedMs === void 0 ? "\u2014" : formatCompactElapsed(row.item.elapsedMs);
+}
+var REDUNDANT_PROGRESS = /* @__PURE__ */ new Set([
+  "in_progress",
+  "running",
+  "starting",
+  "queued",
+  "cancelling"
+]);
+function rowTitle(row) {
+  if (row.kind === "running") {
+    const request = row.snapshot.request;
+    const progress = row.snapshot.cancelRequestedAt ? void 0 : request.progress;
+    const prefix = progress && !REDUNDANT_PROGRESS.has(progress) ? `${progress} \u2014 ` : "";
+    return `${prefix}${cleanSingleLine(request.input)}`;
+  }
+  return row.item.title || cleanSingleLine(row.item.query);
+}
+function formatRelativeDate(timestampMs, now) {
+  if (!Number.isFinite(timestampMs)) return "?";
+  const diff = Math.max(0, now - timestampMs);
+  if (diff < 6e4) return "now";
+  if (diff < 36e5) return `${Math.floor(diff / 6e4)}m ago`;
+  if (diff < 864e5) return `${Math.floor(diff / 36e5)}h ago`;
+  if (diff < 7 * 864e5) return `${Math.floor(diff / 864e5)}d ago`;
+  const date = new Date(timestampMs);
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  if (date.getFullYear() === new Date(now).getFullYear()) {
+    return `${month}-${day}`;
+  }
+  return `${date.getFullYear()}-${month}-${day}`;
+}
+function providerLabel(providerId) {
+  return PROVIDERS_BY_ID[providerId]?.label ?? providerId;
+}
+function padCell(text, width, align = "left") {
+  const pad = " ".repeat(Math.max(0, width - visibleWidth(text)));
+  return align === "left" ? `${text}${pad}` : `${pad}${text}`;
+}
+function clamp2(value, min, max) {
+  return Math.min(Math.max(value, min), Math.max(min, max));
+}
+function formatCompactElapsed(ms) {
+  const totalSeconds = Math.max(0, Math.floor(ms / 1e3));
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  if (minutes > 0) {
+    return `${minutes}m${seconds}s`;
+  }
+  return `${totalSeconds}s`;
+}
+function cleanSingleLine(text) {
+  return text.replace(/\s+/g, " ").trim();
+}
+
+// src/index.ts
+var DEFAULT_MAX_RESULTS = 5;
+var MAX_ALLOWED_RESULTS = 20;
+var MAX_SEARCH_QUERIES = 10;
+var RESEARCH_HEARTBEAT_MS = 15e3;
+var WEB_RESEARCH_RESULT_MESSAGE_TYPE = "web-research-result";
+var WEB_RESEARCH_REPORT_MESSAGE_TYPE = "web-research-report";
+var WEB_RESEARCH_WIDGET_KEY = "web-research-jobs";
+var DEFAULT_SUMMARY_SYMBOLS = {
+  success: "\u2714",
+  failure: "\u2718"
+};
+function webProvidersExtension(pi) {
+  const activeWebResearchRequests = /* @__PURE__ */ new Map();
+  let latestWidgetContext;
+  let webResearchWidgetTimer;
+  const stopWebResearchWidgetTimer = () => {
+    if (webResearchWidgetTimer) {
+      clearInterval(webResearchWidgetTimer);
+      webResearchWidgetTimer = void 0;
+    }
+  };
+  const ensureWebResearchWidgetTimer = () => {
+    if (webResearchWidgetTimer || activeWebResearchRequests.size === 0) {
+      return;
+    }
+    webResearchWidgetTimer = setInterval(() => {
+      updateWebResearchWidget();
+    }, 1e3);
+  };
+  const updateWebResearchWidget = (ctx) => {
+    const widgetContext = ctx ?? latestWidgetContext;
+    if (!widgetContext) {
+      return;
+    }
+    latestWidgetContext = widgetContext;
+    if (!widgetContext.hasUI) {
+      stopWebResearchWidgetTimer();
+      return;
+    }
+    if (activeWebResearchRequests.size === 0) {
+      stopWebResearchWidgetTimer();
+      widgetContext.ui.setWidget(WEB_RESEARCH_WIDGET_KEY, void 0);
+      return;
+    }
+    ensureWebResearchWidgetTimer();
+    widgetContext.ui.setWidget(
+      WEB_RESEARCH_WIDGET_KEY,
+      buildWebResearchWidgetLines(
+        getActiveWebResearchRequests(activeWebResearchRequests),
+        widgetContext.ui.theme
+      )
+    );
+  };
+  if ("registerMessageRenderer" in pi) {
+    pi.registerMessageRenderer(
+      WEB_RESEARCH_RESULT_MESSAGE_TYPE,
+      (message, state, theme) => renderWebResearchResultMessage(message, state, theme)
+    );
+    pi.registerMessageRenderer(
+      WEB_RESEARCH_REPORT_MESSAGE_TYPE,
+      (message, state, theme) => renderWebResearchReportMessage(message, state, theme)
+    );
+  }
+  pi.registerCommand("web-providers", {
+    description: "Configure web search providers",
     handler: async (_args, ctx) => {
       if (!ctx.hasUI) {
         ctx.ui.notify("web-providers requires interactive mode", "error");
@@ -9874,11 +11547,71 @@ function webProvidersExtension(pi) {
       );
     }
   });
+  pi.registerCommand("web-research", {
+    description: "Browse, inspect, and manage web researches",
+    handler: async (_args, ctx) => {
+      if (!ctx.hasUI) {
+        ctx.ui.notify("web-research requires interactive mode", "error");
+        return;
+      }
+      const actions = {
+        copyToClipboard,
+        injectReport: ({ title, body, item }) => {
+          pi.sendMessage(
+            {
+              customType: WEB_RESEARCH_REPORT_MESSAGE_TYPE,
+              content: formatWebResearchReportMessage(title, body, item),
+              display: true,
+              details: {
+                title,
+                outputPath: item.outputPath,
+                provider: item.provider,
+                query: item.query,
+                status: item.status
+              }
+            },
+            { triggerTurn: false }
+          );
+        },
+        notify: (message, type) => ctx.ui.notify(message, type ?? "info")
+      };
+      let timer;
+      let view;
+      try {
+        await ctx.ui.custom(
+          (tui, theme, _keybindings, done) => {
+            view = new WebResearchManagerView(
+              tui,
+              theme,
+              done,
+              ctx.cwd,
+              activeWebResearchRequests,
+              () => updateWebResearchWidget(ctx),
+              actions
+            );
+            timer = setInterval(() => view?.refresh(), 1e3);
+            return view;
+          },
+          {
+            overlay: true,
+            overlayOptions: () => view?.isReportOpen() ? { anchor: "center", width: "85%", maxHeight: "85%" } : {
+              anchor: "center",
+              width: "75%",
+              maxHeight: "60%",
+              minWidth: 60
+            }
+          }
+        );
+      } finally {
+        if (timer) clearInterval(timer);
+      }
+    }
+  });
   pi.on("session_start", async (_event, ctx) => {
     latestWidgetContext = ctx;
     resetContentStore();
     updateWebResearchWidget(ctx);
-    await refreshManagedToolsOnStartup(
+    await refreshManagedToolsOnStartup2(
       pi,
       { activeWebResearchRequests, updateWebResearchWidget },
       ctx.cwd,
@@ -9889,7 +11622,7 @@ function webProvidersExtension(pi) {
     latestWidgetContext = ctx;
     await cleanupContentStore();
     updateWebResearchWidget(ctx);
-    await refreshManagedToolsOnStartup(
+    await refreshManagedToolsOnStartup2(
       pi,
       { activeWebResearchRequests, updateWebResearchWidget },
       ctx.cwd,
@@ -10112,7 +11845,7 @@ function registerWebResearchTool(pi, webResearchLifecycle, providerIds) {
       "Do not expect the final report in the same turn; tell the user that web research has started and wait for the completion message with the saved report path."
     ]),
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
-      return dispatchWebResearch({
+      return dispatchWebResearch2({
         pi,
         activeWebResearchRequests: webResearchLifecycle.activeWebResearchRequests,
         updateWebResearchWidget: webResearchLifecycle.updateWebResearchWidget,
@@ -10137,109 +11870,38 @@ function registerWebResearchTool(pi, webResearchLifecycle, providerIds) {
     }
   });
 }
-async function runWebProvidersConfig(pi, webResearchLifecycle, ctx) {
-  const config = await loadConfig();
-  const activeProvider = getInitialProviderSelection(config);
-  await ctx.ui.custom(
-    (tui, theme, _keybindings, done) => new WebProvidersSettingsView(
-      tui,
-      theme,
-      done,
-      ctx,
-      config,
-      activeProvider
-    )
-  );
-  await refreshManagedTools(pi, webResearchLifecycle, ctx.cwd, {
-    addAvailable: true
-  });
-}
-function formatStartupConfigError(error) {
-  const detail = error instanceof Error ? error.message : String(error);
-  return `web-providers config error: ${detail.replace(getConfigPath(), "~/.pi/agent/web-providers.json")}`;
-}
-function getAvailableProviderIdsForCapability(config, cwd, capability) {
-  const providerId = getMappedProviderIdForTool(config, capability);
-  if (!providerId) {
-    return [];
-  }
-  const provider = PROVIDERS_BY_ID[providerId];
-  if (!supportsTool2(provider, capability)) {
-    return [];
-  }
-  const status = getProviderCapabilityStatus(
-    config,
-    cwd,
-    providerId,
-    capability,
-    {
-      resolveSecrets: false
-    }
-  );
-  return isProviderCapabilityExposable(status) ? [providerId] : [];
-}
-function getProviderStatusForTool(config, cwd, providerId, capability) {
-  return getProviderCapabilityStatus(config, cwd, providerId, capability);
-}
-function getAvailableManagedToolNames(config, cwd) {
-  return Object.keys(CAPABILITY_TOOL_NAMES).filter(
-    (capability) => getAvailableProviderIdsForCapability(config, cwd, capability).length > 0
-  ).map((capability) => CAPABILITY_TOOL_NAMES[capability]);
-}
-function getSyncedActiveTools(config, cwd, activeToolNames, options) {
-  const availableToolNames = new Set(getAvailableManagedToolNames(config, cwd));
-  const nextActiveTools = new Set(activeToolNames);
-  for (const toolName of MANAGED_TOOL_NAMES) {
-    if (availableToolNames.has(toolName)) {
-      if (options.addAvailable) {
-        nextActiveTools.add(toolName);
-      }
-      continue;
-    }
-    nextActiveTools.delete(toolName);
-  }
-  return nextActiveTools;
-}
-async function refreshManagedTools(pi, webResearchLifecycle, cwd, options) {
+async function runWebProvidersConfig(pi, webResearchLifecycle, ctx) {
   const config = await loadConfig();
-  const nextActiveTools = getSyncedActiveTools(
-    config,
-    cwd,
-    pi.getActiveTools(),
-    options
+  const activeProvider = getInitialProviderSelection(config);
+  await ctx.ui.custom(
+    (tui, theme, _keybindings, done) => new WebProvidersSettingsView(
+      tui,
+      theme,
+      done,
+      ctx,
+      config,
+      activeProvider
+    )
   );
-  registerManagedTools(pi, webResearchLifecycle, {
-    search: getAvailableProviderIdsForCapability(config, cwd, "search"),
-    contents: getAvailableProviderIdsForCapability(config, cwd, "contents"),
-    answer: getAvailableProviderIdsForCapability(config, cwd, "answer"),
-    research: getAvailableProviderIdsForCapability(config, cwd, "research")
+  await refreshManagedTools2(pi, webResearchLifecycle, ctx.cwd, {
+    addAvailable: true
   });
-  await syncManagedToolAvailability(pi, nextActiveTools);
 }
-async function refreshManagedToolsOnStartup(pi, webResearchLifecycle, cwd, options) {
-  try {
-    await refreshManagedTools(pi, webResearchLifecycle, cwd, options);
-  } catch (error) {
-    const message = formatStartupConfigError(error);
-    pi.sendMessage({
-      customType: "web-providers-config-error",
-      content: message,
-      display: true
-    });
-    await syncManagedToolAvailability(
-      pi,
-      new Set(
-        pi.getActiveTools().filter((toolName) => !MANAGED_TOOL_NAMES.includes(toolName))
-      )
-    );
-  }
+async function refreshManagedTools2(pi, webResearchLifecycle, cwd, options) {
+  await refreshManagedTools(
+    pi,
+    (providerIdsByCapability) => registerManagedTools(pi, webResearchLifecycle, providerIdsByCapability),
+    cwd,
+    options
+  );
 }
-async function syncManagedToolAvailability(pi, nextActiveTools) {
-  const activeTools = pi.getActiveTools();
-  const changed = activeTools.length !== nextActiveTools.size || activeTools.some((toolName) => !nextActiveTools.has(toolName));
-  if (changed) {
-    pi.setActiveTools(Array.from(nextActiveTools));
-  }
+async function refreshManagedToolsOnStartup2(pi, webResearchLifecycle, cwd, options) {
+  await refreshManagedToolsOnStartup(
+    pi,
+    (providerIdsByCapability) => registerManagedTools(pi, webResearchLifecycle, providerIdsByCapability),
+    cwd,
+    options
+  );
 }
 function getSearchMaxResultsLimit(providerId) {
   const capabilities = PROVIDERS_BY_ID[providerId].capabilities;
@@ -10456,12 +12118,12 @@ async function executeRawProviderRequest({
     input
   });
 }
-function buildSearchBatchError(outcomes, providerLabel) {
+function buildSearchBatchError(outcomes, providerLabel2) {
   const failed = outcomes.filter((outcome) => outcome.error !== void 0);
   if (failed.length === 1) {
     return new Error(
       formatProviderCapabilityFailure(
-        providerLabel,
+        providerLabel2,
         "search",
         failed[0]?.error ?? ""
       )
@@ -10471,7 +12133,7 @@ function buildSearchBatchError(outcomes, providerLabel) {
     (outcome, index) => `${index + 1}. ${formatQuotedPreview(outcome.query, 40)} \u2014 ${outcome.error}`
   ).join("; ");
   return new Error(
-    `${providerLabel} search failed for ${failed.length} queries: ${summary}`
+    `${providerLabel2} search failed for ${failed.length} queries: ${summary}`
   );
 }
 async function executeSingleSearchQuery({
@@ -10608,12 +12270,12 @@ async function executeAnswerToolInternal({
     })
   };
 }
-function buildAnswerBatchError(outcomes, providerLabel) {
+function buildAnswerBatchError(outcomes, providerLabel2) {
   const failed = outcomes.filter((outcome) => outcome.error !== void 0);
   if (failed.length === 1) {
     return new Error(
       formatProviderCapabilityFailure(
-        providerLabel,
+        providerLabel2,
         "answer",
         failed[0]?.error ?? ""
       )
@@ -10623,7 +12285,7 @@ function buildAnswerBatchError(outcomes, providerLabel) {
     (outcome, index) => `${index + 1}. ${formatQuotedPreview(outcome.query, 40)} \u2014 ${outcome.error}`
   ).join("; ");
   return new Error(
-    `${providerLabel} answer failed for ${failed.length} questions: ${summary}`
+    `${providerLabel2} answer failed for ${failed.length} questions: ${summary}`
   );
 }
 function formatAnswerResponses(outcomes) {
@@ -10839,7 +12501,7 @@ async function executeProviderToolInternal({
     })
   };
 }
-async function dispatchWebResearch({
+async function dispatchWebResearch2({
   pi,
   activeWebResearchRequests,
   updateWebResearchWidget,
@@ -10868,188 +12530,59 @@ async function dispatchWebResearchInternal({
   input,
   executionOverride
 }) {
-  await cleanupContentStore();
-  const provider = resolveProviderForTool(
+  return dispatchWebResearch({
+    activeWebResearchRequests,
     config,
-    ctx.cwd,
-    "research",
-    explicitProvider
-  );
-  const request = createWebResearchRequest(ctx.cwd, provider.id, input);
-  const providerConfig = getEffectiveProviderConfig(config, provider.id);
-  activeWebResearchRequests.set(request.id, request);
-  updateWebResearchWidget(ctx);
-  trackPendingResearchTask(
-    runDispatchedWebResearch({
-      pi,
-      activeWebResearchRequests,
-      updateWebResearchWidget,
-      request,
-      config,
+    explicitProvider,
+    ctx: { cwd: ctx.cwd },
+    options: providerOptions,
+    input,
+    executionOverride,
+    executeResearch: async ({
+      config: config2,
       provider,
       providerConfig,
-      ctx,
-      options: providerOptions,
-      executionOverride
-    })
-  );
-  return {
-    content: [
-      {
-        type: "text",
-        text: `Started web research via ${provider.label}.`
-      }
-    ],
-    details: request,
-    display: buildProviderToolDisplay2({
-      capability: "research",
-      providerId: provider.id,
-      details: { tool: "web_research", provider: provider.id },
-      text: "started"
-    })
-  };
-}
-async function runDispatchedWebResearch({
-  pi,
-  activeWebResearchRequests,
-  updateWebResearchWidget,
-  request,
-  config,
-  provider,
-  providerConfig,
-  ctx,
-  options,
-  executionOverride
-}) {
-  let result;
-  let reportText = "";
-  try {
-    const response = await executeProviderOperation({
+      ctx: ctx2,
+      signal,
+      options,
+      input: input2,
+      onProgress,
+      executionOverride: executionOverride2
+    }) => executeProviderOperation({
       capability: "research",
-      config,
+      config: config2,
       provider,
       providerConfig,
-      ctx,
-      signal: void 0,
+      ctx: ctx2,
+      signal,
       options,
-      input: request.input,
-      onProgress: (message) => {
-        request.progress = summarizeWebResearchProgress(
-          message,
-          provider.label
-        );
-        updateWebResearchWidget();
-      },
-      executionOverride
-    });
-    const completedAt = (/* @__PURE__ */ new Date()).toISOString();
-    result = {
-      ...request,
-      status: "completed",
-      completedAt,
-      elapsedMs: Math.max(
-        0,
-        Date.parse(completedAt) - Date.parse(request.startedAt)
-      ),
-      itemCount: response.itemCount
-    };
-    reportText = response.text;
-  } catch (error) {
-    const completedAt = (/* @__PURE__ */ new Date()).toISOString();
-    result = {
-      ...request,
-      status: "failed",
-      completedAt,
-      elapsedMs: Math.max(
-        0,
-        Date.parse(completedAt) - Date.parse(request.startedAt)
-      ),
-      error: formatErrorMessage(error)
-    };
-  }
-  try {
-    await writeWebResearchArtifact(result, reportText);
-    pi.sendMessage({
-      customType: WEB_RESEARCH_RESULT_MESSAGE_TYPE,
-      content: formatWebResearchResultMessage(result, reportText),
-      display: true,
-      details: result
-    });
-  } finally {
-    activeWebResearchRequests.delete(request.id);
-    updateWebResearchWidget();
-  }
-}
-function createWebResearchRequest(cwd, provider, input) {
-  const startedAt = (/* @__PURE__ */ new Date()).toISOString();
-  return {
-    tool: "web_research",
-    id: randomUUID(),
-    provider,
-    input,
-    outputPath: buildWebResearchArtifactPath(cwd, input, startedAt),
-    startedAt
-  };
-}
-function buildWebResearchArtifactPath(cwd, input, startedAt) {
-  const timestamp = startedAt.replaceAll(":", "-").replace(".", "-");
-  const slug = slugifyWebResearchInput(input);
-  return join2(cwd, RESEARCH_ARTIFACTS_DIR, `${timestamp}-${slug}.md`);
-}
-function slugifyWebResearchInput(input) {
-  const slug = input.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60).replace(/-+$/g, "");
-  return slug.length > 0 ? slug : "research";
+      input: input2,
+      onProgress,
+      executionOverride: executionOverride2
+    }),
+    deliverResult: (message) => pi.sendMessage(message),
+    onJobsChanged: () => updateWebResearchWidget(ctx),
+    resultMessageType: WEB_RESEARCH_RESULT_MESSAGE_TYPE
+  });
 }
 function buildWebResearchWidgetLines(requests, theme, now = Date.now()) {
-  const lines = [theme.fg("accent", "Research jobs:")];
-  for (const request of requests.slice().sort((left, right) => left.startedAt.localeCompare(right.startedAt)).slice(0, 3)) {
-    const providerLabel = PROVIDERS_BY_ID[request.provider]?.label ?? request.provider;
-    const elapsed = formatCompactElapsed(now - Date.parse(request.startedAt));
-    const icon = getWebResearchWidgetIcon(request, now);
-    lines.push(
-      `${icon}${providerLabel} ${theme.fg("muted", `(${elapsed}): `)}${truncateInline(cleanSingleLine(request.input), 70)}`
-    );
-  }
-  if (requests.length > 3) {
-    lines.push(theme.fg("muted", `+${requests.length - 3} more`));
-  }
-  return lines;
-}
-function getWebResearchWidgetIcon(request, _now) {
-  if (request.progress === "poll retrying after transient errors") {
-    return "\u27F3 ";
-  }
-  if (request.progress === "queued") {
-    return "\u25CC ";
-  }
-  if (request.progress === "starting") {
-    return "\u25D4 ";
-  }
-  if (request.progress?.startsWith("started:")) {
-    return "\u25D1 ";
-  }
-  return "\u25CF ";
-}
-function summarizeWebResearchProgress(message, providerLabel) {
-  const startingMessage = `Starting research via ${providerLabel}`;
-  if (message === startingMessage) {
-    return "starting";
-  }
-  const startedPrefix = `${providerLabel} research started: `;
-  if (message.startsWith(startedPrefix)) {
-    return `started: ${message.slice(startedPrefix.length)}`;
-  }
-  const statusPrefix = `Research via ${providerLabel}: `;
-  if (message.startsWith(statusPrefix)) {
-    return message.slice(statusPrefix.length).replace(/\s+\([^)]* elapsed\)$/u, "").trim();
-  }
-  const retryPrefix = `${providerLabel} research poll is still retrying after transient errors`;
-  if (message.startsWith(retryPrefix)) {
-    return "poll retrying after transient errors";
+  const sorted = requests.slice().sort((left, right) => left.startedAt.localeCompare(right.startedAt));
+  const jobs = sorted.slice(0, 3).map((request) => {
+    const providerLabel2 = PROVIDERS_BY_ID[request.provider]?.label ?? request.provider;
+    const elapsed = formatCompactElapsed2(now - Date.parse(request.startedAt));
+    const icon = getWebResearchProgressIcon(request);
+    const status = request.progress === "cancelling" ? " cancelling" : "";
+    return `${icon} ${providerLabel2} ${elapsed}${status}`;
+  });
+  if (sorted.length > 3) {
+    jobs.push(`+${sorted.length - 3} more`);
   }
-  return message.trim();
+  const count = sorted.length === 1 ? "1 research" : `${sorted.length} researches`;
+  return [
+    `${theme.fg("accent", `${count} running`)}${theme.fg("muted", ` \xB7 ${jobs.join(" \xB7 ")} \xB7 /web-research`)}`
+  ];
 }
-function formatCompactElapsed(ms) {
+function formatCompactElapsed2(ms) {
   const totalSeconds = Math.max(0, Math.floor(ms / 1e3));
   const minutes = Math.floor(totalSeconds / 60);
   const seconds = totalSeconds % 60;
@@ -11058,68 +12591,6 @@ function formatCompactElapsed(ms) {
   }
   return `${totalSeconds}s`;
 }
-function formatWebResearchResultMessage(result, reportText) {
-  const text = reportText.trim();
-  if (text.length > 0) {
-    return `${text}
-`;
-  }
-  if (result.error) {
-    return `${result.error}
-`;
-  }
-  return "";
-}
-async function writeWebResearchArtifact(result, reportText) {
-  await mkdir2(dirname2(result.outputPath), { recursive: true });
-  await writeFile2(
-    result.outputPath,
-    formatWebResearchArtifact(result, reportText),
-    "utf-8"
-  );
-}
-function formatWebResearchArtifact(result, reportText) {
-  const providerLabel = PROVIDERS_BY_ID[result.provider]?.label ?? result.provider;
-  const lines = [
-    "# Web research report",
-    "",
-    "## Query",
-    result.input,
-    "",
-    "## Provider",
-    providerLabel,
-    "",
-    "## Status",
-    result.status,
-    "",
-    "## Started",
-    result.startedAt,
-    "",
-    "## Completed",
-    result.completedAt,
-    "",
-    "## Elapsed",
-    formatElapsed(result.elapsedMs)
-  ];
-  if (typeof result.itemCount === "number") {
-    lines.push("", "## Items", String(result.itemCount));
-  }
-  if (result.error) {
-    lines.push("", "## Error", result.error);
-  }
-  if (reportText) {
-    lines.push("", "## Report", reportText);
-  }
-  return `${lines.join("\n")}
-`;
-}
-function trackPendingResearchTask(task) {
-  const tracked = task.catch(() => {
-  }).finally(() => {
-    pendingResearchTasks.delete(tracked);
-  });
-  pendingResearchTasks.add(tracked);
-}
 async function executeBatchedContentsTool({
   config,
   provider,
@@ -11281,10 +12752,10 @@ function createToolProgressReporter(capability, providerId, progress) {
       if (Date.now() - lastUpdateAt < RESEARCH_HEARTBEAT_MS) {
         return;
       }
-      const providerLabel = PROVIDERS_BY_ID[providerId]?.label ?? providerId;
+      const providerLabel2 = PROVIDERS_BY_ID[providerId]?.label ?? providerId;
       const elapsed = formatElapsed(Date.now() - startedAt);
       emit(
-        `Researching via ${providerLabel} (${elapsed} elapsed)`,
+        `Researching via ${providerLabel2} (${elapsed} elapsed)`,
         buildProgressDisplay2(providerId, `Researching ${elapsed}`)
       );
       lastUpdateAt = Date.now();
@@ -11307,38 +12778,38 @@ function renderListCallHeader(toolName, items, theme, suffix, options = {}) {
     invalidate() {
     },
     render(width) {
-      const normalizedItems = items.map((item) => cleanSingleLine(item)).filter((item) => item.length > 0);
+      const normalizedItems = items.map((item) => cleanSingleLine2(item)).filter((item) => item.length > 0);
       const toolTitle = theme.fg("toolTitle", theme.bold(toolName));
       const mutedSuffix = suffix ? theme.fg("muted", suffix) : "";
       if (!options.forceMultiline && normalizedItems.length === 1) {
         const singleItem = options.quoteSingleItem ? formatQuotedPreview(normalizedItems[0], 80) : truncateInline(normalizedItems[0], 120);
         const inline = `${toolTitle} ${theme.fg("accent", singleItem)}${mutedSuffix}`;
-        const line = truncateToWidth(inline.trimEnd(), width);
-        return [line + " ".repeat(Math.max(0, width - visibleWidth(line)))];
+        const line = truncateToWidth2(inline.trimEnd(), width);
+        return [line + " ".repeat(Math.max(0, width - visibleWidth2(line)))];
       }
       let header = toolTitle;
       if (mutedSuffix) {
         header += mutedSuffix;
       }
       const lines = [];
-      const headerLine = truncateToWidth(header.trimEnd(), width);
+      const headerLine = truncateToWidth2(header.trimEnd(), width);
       lines.push(
-        headerLine + " ".repeat(Math.max(0, width - visibleWidth(headerLine)))
+        headerLine + " ".repeat(Math.max(0, width - visibleWidth2(headerLine)))
       );
       for (const item of normalizedItems) {
         const itemLines = options.forceMultiline ? wrapTextWithAnsi(
           theme.fg("accent", item),
           Math.max(1, width - 2)
         ).map((line) => `  ${line}`) : [
-          truncateToWidth(
+          truncateToWidth2(
             `  ${theme.fg("accent", truncateInline(item, 120))}`,
             width
           )
         ];
         for (const itemLine of itemLines) {
-          const line = truncateToWidth(itemLine, width);
+          const line = truncateToWidth2(itemLine, width);
           lines.push(
-            line + " ".repeat(Math.max(0, width - visibleWidth(line)))
+            line + " ".repeat(Math.max(0, width - visibleWidth2(line)))
           );
         }
       }
@@ -11433,7 +12904,8 @@ function renderWebResearchResultMessage(message, { expanded }, theme, symbols =
   const text = typeof message.content === "string" ? message.content : extractTextContent(message.content);
   const details = isWebResearchResult(message.details) ? message.details : void 0;
   const isSuccess = details?.status === "completed";
-  const accent = isSuccess ? "success" : "error";
+  const isCancelled = details?.status === "cancelled";
+  const accent = isSuccess ? "success" : isCancelled ? "warning" : "error";
   const box = new Box(1, 1, (value) => theme.bg("customMessageBg", value));
   if (!expanded) {
     const summary = details ? buildWebResearchResultSummaryLine(details, theme, symbols) : theme.fg(accent, "Web research update");
@@ -11443,10 +12915,42 @@ function renderWebResearchResultMessage(message, { expanded }, theme, symbols =
     return box;
   }
   box.addChild(
-    details ? renderMarkdownBlock(renderWebResearchResultMarkdown(details)) : isSuccess ? renderMarkdownBlock(text ?? "") : renderBlockText(text ?? "", theme, "error")
+    details ? renderMarkdownBlock(renderWebResearchResultMarkdown(details)) : isSuccess ? renderMarkdownBlock(text ?? "") : renderBlockText(
+      text ?? "",
+      theme,
+      isCancelled ? "toolOutput" : "error"
+    )
   );
   return box;
 }
+function formatWebResearchReportMessage(title, body, item) {
+  const provenance = `Saved web research report "${title}" (provider: ${item.provider || "unknown"}, status: ${item.status}, artifact: \`${item.outputPath}\`):`;
+  return `${provenance}
+
+${body}
+`;
+}
+function renderWebResearchReportMessage(message, { expanded }, theme) {
+  const text = typeof message.content === "string" ? message.content : extractTextContent(message.content);
+  const details = isWebResearchReportDetails(message.details) ? message.details : void 0;
+  const box = new Box(1, 1, (value) => theme.bg("customMessageBg", value));
+  if (!expanded) {
+    const title = details?.title ?? "saved report";
+    box.addChild(
+      new Text(
+        `${theme.fg("success", `Injected research report: ${title}`)}${theme.fg("muted", ` (${getExpandHint()})`)}`,
+        0,
+        0
+      )
+    );
+    return box;
+  }
+  box.addChild(renderMarkdownBlock(text ?? ""));
+  return box;
+}
+function isWebResearchReportDetails(details) {
+  return typeof details === "object" && details !== null && "title" in details && "outputPath" in details && !("tool" in details);
+}
 function renderWebResearchRequestMarkdown(request) {
   return [
     "### Web research",
@@ -11472,7 +12976,7 @@ function renderWebResearchResultMarkdown(result) {
   ].join("\n");
 }
 function buildWebResearchResultSummaryLine(result, theme, symbols) {
-  const providerLabel = PROVIDERS_BY_ID[result.provider]?.label ?? result.provider;
+  const providerLabel2 = PROVIDERS_BY_ID[result.provider]?.label ?? result.provider;
   if (result.status === "completed") {
     return renderSuccessSummary(
       `${formatSummaryElapsed(result.elapsedMs)} \xB7 ${basename(result.outputPath)}`,
@@ -11480,8 +12984,8 @@ function buildWebResearchResultSummaryLine(result, theme, symbols) {
       symbols
     );
   }
-  const statusText = result.status === "cancelled" ? `${providerLabel} research canceled after ${formatSummaryElapsed(result.elapsedMs)}` : `${providerLabel} research failed after ${formatSummaryElapsed(result.elapsedMs)}`;
-  const errorSuffix = result.error ? `: ${normalizeProviderFailureDetail(providerLabel, result.error)}` : "";
+  const statusText = result.status === "cancelled" ? `${providerLabel2} research canceled after ${formatSummaryElapsed(result.elapsedMs)}` : `${providerLabel2} research failed after ${formatSummaryElapsed(result.elapsedMs)}`;
+  const errorSuffix = result.error ? `: ${normalizeProviderFailureDetail(providerLabel2, result.error)}` : "";
   return renderFailureSummary(`${statusText}${errorSuffix}`, theme, symbols);
 }
 function isWebResearchRequest(details) {
@@ -11580,7 +13084,7 @@ function renderEntryList(width, theme, entries, selection) {
     const paddedLabel = entry.label.padEnd(labelWidth, " ");
     const label = selected ? theme.fg("accent", paddedLabel) : paddedLabel;
     const value = selected ? theme.fg("accent", entry.currentValue) : theme.fg("muted", entry.currentValue);
-    return truncateToWidth(`${prefix}${label}  ${value}`, width);
+    return truncateToWidth2(`${prefix}${label}  ${value}`, width);
   });
 }
 function renderSelectedEntryDescription(width, theme, entry) {
@@ -11588,7 +13092,7 @@ function renderSelectedEntryDescription(width, theme, entry) {
     return [];
   }
   return wrapTextWithAnsi(entry.description, Math.max(10, width - 2)).map(
-    (line) => truncateToWidth(theme.fg("dim", line), width)
+    (line) => truncateToWidth2(theme.fg("dim", line), width)
   );
 }
 function formatProviderCapabilityChecks(providerId, theme) {
@@ -11769,7 +13273,7 @@ var WebProvidersSettingsView = class {
     }
     lines.push("");
     lines.push(
-      truncateToWidth(
+      truncateToWidth2(
         this.theme.fg(
           "dim",
           "\u2191\u2193 move \xB7 Tab/Shift+Tab switch section \xB7 Enter edit/open \xB7 Esc close"
@@ -11788,7 +13292,7 @@ var WebProvidersSettingsView = class {
       this.tui.requestRender();
       return;
     }
-    const kb = getKeybindings();
+    const kb = getKeybindings2();
     const entries = this.getActiveSectionEntries();
     if (kb.matches(data, "tui.select.up")) {
       if (entries.length > 0) {
@@ -11798,9 +13302,9 @@ var WebProvidersSettingsView = class {
       if (entries.length > 0) {
         this.moveSelection(1);
       }
-    } else if (matchesKey(data, Key.tab)) {
+    } else if (matchesKey2(data, Key2.tab)) {
       this.moveSection(1);
-    } else if (matchesKey(data, Key.shift("tab"))) {
+    } else if (matchesKey2(data, Key2.shift("tab"))) {
       this.moveSection(-1);
     } else if (kb.matches(data, "tui.select.confirm") || data === " ") {
       void this.activateCurrentEntry();
@@ -11933,14 +13437,14 @@ var WebProvidersSettingsView = class {
       Math.max(20, Math.floor(width * 0.45))
     );
     const lines = [
-      truncateToWidth(
+      truncateToWidth2(
         this.activeSection === section ? this.theme.fg("accent", this.theme.bold(title)) : this.theme.bold(title),
         width
       )
     ];
     if (section === "provider") {
       lines.push(
-        truncateToWidth(
+        truncateToWidth2(
           this.theme.fg(
             "dim",
             `  ${"Provider".padEnd(labelWidth, " ")}  S C A R  Status`
@@ -11955,15 +13459,15 @@ var WebProvidersSettingsView = class {
       const paddedLabel = entry.label.padEnd(labelWidth, " ");
       const label = selected ? this.theme.fg("accent", paddedLabel) : paddedLabel;
       if (entry.currentValue.trim().length === 0) {
-        lines.push(truncateToWidth(`${prefix}${label}`, width));
+        lines.push(truncateToWidth2(`${prefix}${label}`, width));
         continue;
       }
       const value = entry.preserveValueStyle ? entry.currentValue : selected ? this.theme.fg("accent", entry.currentValue) : this.theme.fg("muted", entry.currentValue);
-      lines.push(truncateToWidth(`${prefix}${label}  ${value}`, width));
+      lines.push(truncateToWidth2(`${prefix}${label}  ${value}`, width));
     }
     if (section === "provider") {
       lines.push(
-        truncateToWidth(
+        truncateToWidth2(
           this.theme.fg("dim", "  S=Search  C=Contents  A=Answer  R=Research"),
           width
         )
@@ -12098,7 +13602,7 @@ var ToolSettingsSubmenu = class {
     }
     const entries = this.getEntries();
     const lines = [
-      truncateToWidth(
+      truncateToWidth2(
         this.theme.fg("accent", TOOL_INFO[this.toolId].label),
         width
       ),
@@ -12114,7 +13618,7 @@ var ToolSettingsSubmenu = class {
     }
     lines.push("");
     lines.push(
-      truncateToWidth(
+      truncateToWidth2(
         this.theme.fg("dim", "\u2191\u2193 move \xB7 Enter edit/toggle \xB7 Esc back"),
         width
       )
@@ -12130,7 +13634,7 @@ var ToolSettingsSubmenu = class {
       this.tui.requestRender();
       return;
     }
-    const kb = getKeybindings();
+    const kb = getKeybindings2();
     const entries = this.getEntries();
     if (kb.matches(data, "tui.select.up")) {
       if (this.selection > 0) {
@@ -12333,7 +13837,7 @@ var ProviderSettingsSubmenu = class {
     const providerConfig = this.getProviderConfig();
     const entries = this.getEntries();
     const lines = [
-      truncateToWidth(this.theme.fg("accent", provider.label), width),
+      truncateToWidth2(this.theme.fg("accent", provider.label), width),
       "",
       ...renderEntryList(width, this.theme, entries, this.selection)
     ];
@@ -12350,10 +13854,10 @@ var ProviderSettingsSubmenu = class {
     );
     lines.push("");
     lines.push(
-      truncateToWidth(this.theme.fg("dim", `Status: ${status}`), width)
+      truncateToWidth2(this.theme.fg("dim", `Status: ${status}`), width)
     );
     lines.push(
-      truncateToWidth(
+      truncateToWidth2(
         this.theme.fg("dim", "\u2191\u2193 move \xB7 Enter edit/toggle \xB7 Esc back"),
         width
       )
@@ -12369,7 +13873,7 @@ var ProviderSettingsSubmenu = class {
       this.tui.requestRender();
       return;
     }
-    const kb = getKeybindings();
+    const kb = getKeybindings2();
     const entries = this.getEntries();
     if (kb.matches(data, "tui.select.up")) {
       if (this.selection > 0) {
@@ -12504,12 +14008,12 @@ var TextValueSubmenu = class {
   editor;
   render(width) {
     return [
-      truncateToWidth(this.theme.fg("accent", this.title), width),
+      truncateToWidth2(this.theme.fg("accent", this.title), width),
       "",
       ...this.editor.render(width),
       "",
-      truncateToWidth(this.theme.fg("dim", this.help), width),
-      truncateToWidth(
+      truncateToWidth2(this.theme.fg("dim", this.help), width),
+      truncateToWidth2(
         this.theme.fg(
           "dim",
           "Enter to save \xB7 Shift+Enter for newline \xB7 Esc to cancel"
@@ -12522,7 +14026,7 @@ var TextValueSubmenu = class {
     this.editor.invalidate();
   }
   handleInput(data) {
-    if (matchesKey(data, Key.escape)) {
+    if (matchesKey2(data, Key2.escape)) {
       this.done(void 0);
       return;
     }
@@ -12646,7 +14150,7 @@ function getSearchQueriesForDisplay(queries) {
 function getAnswerQueriesForDisplay(queries) {
   return getSearchQueriesForDisplay(queries);
 }
-function createBatchCompletionReporter(verb, providerId, providerLabel, total, report) {
+function createBatchCompletionReporter(verb, providerId, providerLabel2, total, report) {
   if (!report) {
     return {
       start: () => {
@@ -12660,7 +14164,7 @@ function createBatchCompletionReporter(verb, providerId, providerLabel, total, r
   let completedCount = 0;
   let failedCount = 0;
   const emit = () => {
-    let message = `${verb} via ${providerLabel}: ${completedCount}/${total} completed`;
+    let message = `${verb} via ${providerLabel2}: ${completedCount}/${total} completed`;
     if (failedCount > 0) {
       message += `, ${failedCount} failed`;
     }
@@ -12712,8 +14216,8 @@ function renderMarkdownBlock(text) {
   if (!text) {
     return new Text("", 0, 0);
   }
-  return new Markdown(`
-${text}`, 0, 0, getMarkdownTheme());
+  return new Markdown2(`
+${text}`, 0, 0, getMarkdownTheme2());
 }
 function renderBlockText(text, theme, color) {
   if (!text) {
@@ -12747,12 +14251,12 @@ function prefixWithSymbol(text, symbol) {
 }
 function renderToolProgress(display, fallbackText, theme) {
   const progress = display?.progress;
-  const providerLabel = display?.provider?.label;
-  if (!progress || !providerLabel) {
+  const providerLabel2 = display?.provider?.label;
+  if (!progress || !providerLabel2) {
     return renderSimpleText(fallbackText ?? "Working\u2026", theme, "warning");
   }
   return new Text(
-    `${theme.fg("warning", progress.action)} ${theme.fg("muted", `via ${providerLabel}`)}`,
+    `${theme.fg("warning", progress.action)} ${theme.fg("muted", `via ${providerLabel2}`)}`,
     0,
     0
   );
@@ -12804,15 +14308,15 @@ function buildFailureSummary({
   fallback
 }) {
   const detail = stripTrailingSentencePunctuation(getFirstLine2(text) ?? "");
-  const providerLabel = details?.provider !== void 0 ? PROVIDERS_BY_ID[details.provider]?.label ?? details.provider : void 0;
-  if (!providerLabel) {
+  const providerLabel2 = details?.provider !== void 0 ? PROVIDERS_BY_ID[details.provider]?.label ?? details.provider : void 0;
+  if (!providerLabel2) {
     return detail || fallback;
   }
-  return formatProviderCapabilityFailure(providerLabel, capability, detail);
+  return formatProviderCapabilityFailure(providerLabel2, capability, detail);
 }
-function formatProviderCapabilityFailure(providerLabel, capability, detail) {
+function formatProviderCapabilityFailure(providerLabel2, capability, detail) {
   const action = getFailureAction(capability);
-  const base2 = `${providerLabel} ${action} failed`;
+  const base2 = `${providerLabel2} ${action} failed`;
   if (!detail || detail === base2) {
     return base2;
   }
@@ -12820,14 +14324,14 @@ function formatProviderCapabilityFailure(providerLabel, capability, detail) {
     return detail;
   }
   const normalizedDetail = normalizeProviderFailureDetail(
-    providerLabel,
+    providerLabel2,
     detail
   );
   return `${base2}: ${normalizedDetail}`;
 }
-function normalizeProviderFailureDetail(providerLabel, detail) {
+function normalizeProviderFailureDetail(providerLabel2, detail) {
   const normalized = stripTrailingSentencePunctuation(detail);
-  const providerPrefix = `${providerLabel}:`;
+  const providerPrefix = `${providerLabel2}:`;
   return normalized.toLowerCase().startsWith(providerPrefix.toLowerCase()) ? normalized.slice(providerPrefix.length).trim() : normalized;
 }
 function getFailureAction(capability) {
@@ -12876,7 +14380,7 @@ function getFirstLine2(text) {
 }
 function getExpandHint() {
   try {
-    const keys = getKeybindings().getKeys("app.tools.expand");
+    const keys = getKeybindings2().getKeys("app.tools.expand");
     if (keys.length > 0) {
       return `${keys.join("/")} to expand`;
     }
@@ -12884,11 +14388,11 @@ function getExpandHint() {
   }
   return "ctrl+o to expand";
 }
-function cleanSingleLine(text) {
+function cleanSingleLine2(text) {
   return text.replace(/\s+/g, " ").trim();
 }
 function formatQuotedPreview(text, maxLength = 80) {
-  return `"${truncateInline(cleanSingleLine(text), maxLength)}"`;
+  return `"${truncateInline(cleanSingleLine2(text), maxLength)}"`;
 }
 function formatSearchResponses(outcomes, prefetch) {
   const body = outcomes.map(
@@ -12914,10 +14418,10 @@ function formatSearchOutcomeSection(outcome, index, total) {
 ${body}`;
 }
 function formatSearchHeading(query2) {
-  return `"${escapeMarkdownText(cleanSingleLine(query2))}"`;
+  return `"${escapeMarkdownText(cleanSingleLine2(query2))}"`;
 }
 function formatAnswerHeading(query2) {
-  return `"${escapeMarkdownText(cleanSingleLine(query2))}"`;
+  return `"${escapeMarkdownText(cleanSingleLine2(query2))}"`;
 }
 function collectSearchResultUrls(outcomes) {
   return outcomes.flatMap(
@@ -12933,7 +14437,7 @@ function formatSearchResponseMarkdown(response) {
       `${index + 1}. ${formatMarkdownLink(result.title, result.url)}`
     ];
     if (result.snippet) {
-      lines.push(`   ${escapeMarkdownText(cleanSingleLine(result.snippet))}`);
+      lines.push(`   ${escapeMarkdownText(cleanSingleLine2(result.snippet))}`);
     }
     return lines.join("\n");
   }).join("\n\n");
@@ -12942,7 +14446,7 @@ function formatMarkdownLink(label, url2) {
   return `[${escapeMarkdownLinkLabel(label)}](<${url2}>)`;
 }
 function escapeMarkdownLinkLabel(text) {
-  return cleanSingleLine(text).replaceAll("\\", "\\\\").replaceAll("]", "\\]");
+  return cleanSingleLine2(text).replaceAll("\\", "\\\\").replaceAll("]", "\\]");
 }
 function escapeMarkdownText(text) {
   return text.replaceAll("\\", "\\\\").replaceAll("*", "\\*").replaceAll("_", "\\_").replaceAll("`", "\\`").replaceAll("#", "\\#").replaceAll("[", "\\[").replaceAll("]", "\\]");
@@ -12963,10 +14467,10 @@ async function truncateAndSaveWithMetadata(text, prefix) {
       truncated: false
     };
   }
-  const dir = join2(tmpdir(), `pi-web-providers-${prefix}-${Date.now()}`);
-  await mkdir2(dir, { recursive: true });
-  const fullPath = join2(dir, "output.txt");
-  await writeFile2(fullPath, text, "utf-8");
+  const dir = join3(tmpdir(), `pi-web-providers-${prefix}-${Date.now()}`);
+  await mkdir3(dir, { recursive: true });
+  const fullPath = join3(dir, "output.txt");
+  await writeFile3(fullPath, text, "utf-8");
   return {
     text: truncation.content + `
 
@@ -13073,6 +14577,12 @@ var __test__ = {
   }),
   extractTextContent,
   formatWebResearchResultMessage,
+  getActiveWebResearchRequests,
+  getWebResearchTaskSnapshots,
+  cancelWebResearchTask,
+  loadWebResearchHistory,
+  loadWebResearchPreview,
+  loadWebResearchReport,
   getAvailableManagedToolNames,
   getReadyCompatibleProvidersForTool,
   getEnabledCompatibleProvidersForTool: getReadyCompatibleProvidersForTool,
@@ -13090,9 +14600,10 @@ var __test__ = {
   renderProviderToolResult,
   renderWebResearchDispatchResult,
   renderWebResearchResultMessage,
-  waitForPendingResearchTasks: async () => {
-    await Promise.all([...pendingResearchTasks]);
-  },
+  renderWebResearchReportMessage,
+  formatWebResearchReportMessage,
+  buildWebResearchWidgetLines,
+  waitForPendingResearchTasks,
   formatSearchResponses,
   formatAnswerResponses
 };