smart-web-mcp 0.43.8 → 0.44.1

package/dist/smartsearch.js

@@ -109,6 +109,18 @@ export function projectSmartsearchOutput(response, preset = "compact") {
     const fallbacks = budgetList(response.fallbacks_tried, policy.maxFallbacks);
     recordListMetadata(metadata, "fallbacks_tried", fallbacks.metadata);
     const projectedFallbacks = fallbacks.items.map((fallback, index) => projectText(fallback, policy.maxFallbackChars, `fallbacks_tried.${index}`));
+    const execution = response.execution ? (() => {
+        const attempts = budgetList(response.execution.attempts, policy.maxFallbacks);
+        recordListMetadata(metadata, "execution.attempts", attempts.metadata);
+        return {
+            ...response.execution,
+            attempts: attempts.items.map((attempt, index) => ({
+                ...attempt,
+                provider: projectText(attempt.provider, policy.maxEngineChars, `execution.attempts.${index}.provider`),
+                ...(attempt.error === undefined ? {} : { error: projectText(attempt.error, policy.maxNoteChars, `execution.attempts.${index}.error`) }),
+            })),
+        };
+    })() : undefined;
     const handoff = response.handoff ? (() => {
         const items = budgetList(response.handoff.items, policy.maxHandoffItems);
         recordListMetadata(metadata, "handoff.items", items.metadata);
@@ -157,6 +169,7 @@ export function projectSmartsearchOutput(response, preset = "compact") {
         results: projectedResults,
         fallbacks_tried: projectedFallbacks,
         notes: projectedNotes,
+        ...(execution ? { execution } : {}),
         ...(handoff ? { handoff } : {}),
         ...(assessment ? { assessment } : {}),
         budget: {
@@ -166,6 +179,21 @@ export function projectSmartsearchOutput(response, preset = "compact") {
         },
     };
 }
+export function isSmartsearchExecutionFailure(response) {
+    return response.execution?.status === "failed";
+}
+function completedProviderSearch(results, note) {
+    return { ok: results.length > 0, status: "succeeded", results, note };
+}
+function failedProviderSearch(note) {
+    return { ok: false, status: "failed", results: [], note };
+}
+function smartsearchExecution(attempts) {
+    return {
+        status: attempts.some((attempt) => attempt.status === "succeeded") ? "succeeded" : "failed",
+        attempts,
+    };
+}
 function localOnlyMode() {
     return configEnabled("network.localOnly", false, { private: true });
 }
@@ -429,7 +457,7 @@ async function searchVelog(query, numResults, timeoutMs) {
         }),
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `Velog search error ${result.status}` };
+        return failedProviderSearch(result.error || `Velog search error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.data?.searchPosts?.posts) ? data.data.searchPosts.posts : [];
@@ -439,11 +467,11 @@ async function searchVelog(query, numResults, timeoutMs) {
             snippet: String(item?.short_description || "").trim(),
             engine: "velog",
         })).filter((item) => item.url)).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "Velog search returned no results" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "Velog search returned no results");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `Velog search parse error: ${message}` };
+        return failedProviderSearch(`Velog search parse error: ${message}`);
     }
 }
 async function searchStackExchange(query, numResults, timeoutMs) {
@@ -463,7 +491,7 @@ async function searchStackExchange(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `StackExchange error ${result.status}` };
+        return failedProviderSearch(result.error || `StackExchange error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.items) ? data.items : [];
@@ -473,11 +501,11 @@ async function searchStackExchange(query, numResults, timeoutMs) {
             snippet: String(item?.tags?.join(", ") || "").trim(),
             engine: "stackexchange",
         })).filter((item) => item.url)).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "StackExchange search returned no results" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "StackExchange search returned no results");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `StackExchange parse error: ${message}` };
+        return failedProviderSearch(`StackExchange parse error: ${message}`);
     }
 }
 async function searchHackerNews(query, numResults, timeoutMs) {
@@ -489,7 +517,7 @@ async function searchHackerNews(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `Hacker News error ${result.status}` };
+        return failedProviderSearch(result.error || `Hacker News error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.hits) ? data.hits : [];
@@ -514,11 +542,11 @@ async function searchHackerNews(query, numResults, timeoutMs) {
                 engine: "hackernews",
             };
         }).filter((item) => item.url)).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "Hacker News search returned no results" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "Hacker News search returned no results");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `Hacker News parse error: ${message}` };
+        return failedProviderSearch(`Hacker News parse error: ${message}`);
     }
 }
 function redditSubredditScope(query) {
@@ -552,11 +580,12 @@ async function searchReddit(query, numResults, timeoutMs) {
     const subreddit = redditSubredditScope(query);
     const notes = [];
     let collected = [];
+    let completed = false;
     const collect = (results) => {
         collected = uniqueResults([...collected, ...results]).slice(0, numResults);
         return collected.length >= numResults;
     };
-    const success = () => ({ ok: true, results: collected, note: "" });
+    const success = () => completedProviderSearch(collected, "");
     const keepScope = (results) => {
         if (!subreddit)
             return results;
@@ -581,6 +610,7 @@ async function searchReddit(query, numResults, timeoutMs) {
         },
     });
     if (rss.ok) {
+        completed = true;
         const feed = parseFeed(rss.text, rssUrl);
         const results = keepScope(uniqueResults((feed?.entries || []).map((entry) => {
             let compatibleUrl = "";
@@ -631,6 +661,7 @@ async function searchReddit(query, numResults, timeoutMs) {
                 else {
                     notes.push("Arctic Shift returned no matching Reddit posts");
                 }
+                completed = true;
             }
             catch (error) {
                 notes.push(`Arctic Shift parse error: ${error instanceof Error ? error.message : String(error)}`);
@@ -659,6 +690,7 @@ async function searchReddit(query, numResults, timeoutMs) {
             else {
                 notes.push("PullPush returned no matching historical Reddit posts");
             }
+            completed = true;
         }
         catch (error) {
             notes.push(`PullPush parse error: ${error instanceof Error ? error.message : String(error)}`);
@@ -687,6 +719,7 @@ async function searchReddit(query, numResults, timeoutMs) {
             else {
                 notes.push("Reddit JSON returned no matching posts");
             }
+            completed = true;
         }
         catch (error) {
             notes.push(`Reddit JSON parse error: ${error instanceof Error ? error.message : String(error)}`);
@@ -697,7 +730,8 @@ async function searchReddit(query, numResults, timeoutMs) {
     }
     if (collected.length > 0)
         return success();
-    return { ok: false, note: notes.filter(Boolean).join("; ") || "Reddit search returned no results" };
+    const note = notes.filter(Boolean).join("; ") || "Reddit search returned no results";
+    return completed ? completedProviderSearch([], note) : failedProviderSearch(note);
 }
 async function searchGitHub(query, numResults, timeoutMs) {
     const q = stripSiteOperators(query) || query;
@@ -708,7 +742,7 @@ async function searchGitHub(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `GitHub error ${result.status}` };
+        return failedProviderSearch(result.error || `GitHub error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.items) ? data.items : [];
@@ -722,17 +756,17 @@ async function searchGitHub(query, numResults, timeoutMs) {
             ].filter(Boolean).join(" · "),
             engine: "github",
         }))).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "GitHub search returned no results" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "GitHub search returned no results");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `GitHub parse error: ${message}` };
+        return failedProviderSearch(`GitHub parse error: ${message}`);
     }
 }
 async function searchGitHubRepoDocs(query, numResults, timeoutMs) {
     const repoScope = parseGitHubRepoScope(query);
     if (!repoScope)
-        return { ok: false, note: "GitHub repository docs fallback skipped without owner/repo site scope" };
+        return failedProviderSearch("GitHub repository docs fallback skipped without owner/repo site scope");
     const repoResult = await fetchText(`https://api.github.com/repos/${encodeURIComponent(repoScope.owner)}/${encodeURIComponent(repoScope.repo)}`, timeoutMs, {
         headers: {
             accept: "application/vnd.github+json",
@@ -740,7 +774,7 @@ async function searchGitHubRepoDocs(query, numResults, timeoutMs) {
         },
     });
     if (!repoResult.ok)
-        return { ok: false, note: repoResult.error || `GitHub repository metadata error ${repoResult.status}` };
+        return failedProviderSearch(repoResult.error || `GitHub repository metadata error ${repoResult.status}`);
     let defaultBranch = "main";
     try {
         const repoData = repoResult.text ? JSON.parse(repoResult.text) : {};
@@ -756,7 +790,7 @@ async function searchGitHubRepoDocs(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `GitHub repository docs error ${result.status}` };
+        return failedProviderSearch(result.error || `GitHub repository docs error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.tree) ? data.tree : [];
@@ -782,11 +816,11 @@ async function searchGitHubRepoDocs(query, numResults, timeoutMs) {
             snippet: `GitHub repository document · path:${item.path}`,
             engine: "github_repo_docs",
         }))).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "GitHub repository docs search returned no matching documents" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "GitHub repository docs search returned no matching documents");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `GitHub repository docs parse error: ${message}` };
+        return failedProviderSearch(`GitHub repository docs parse error: ${message}`);
     }
 }
 async function searchMdn(query, numResults, timeoutMs) {
@@ -798,7 +832,7 @@ async function searchMdn(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `MDN error ${result.status}` };
+        return failedProviderSearch(result.error || `MDN error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.documents) ? data.documents : [];
@@ -811,11 +845,11 @@ async function searchMdn(query, numResults, timeoutMs) {
                 engine: "mdn",
             };
         }).filter((item) => item.url && item.url !== "https://developer.mozilla.org/")).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "MDN search returned no results" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "MDN search returned no results");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `MDN parse error: ${message}` };
+        return failedProviderSearch(`MDN parse error: ${message}`);
     }
 }
 async function searchCrates(query, numResults, timeoutMs) {
@@ -827,7 +861,7 @@ async function searchCrates(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `crates.io error ${result.status}` };
+        return failedProviderSearch(result.error || `crates.io error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.crates) ? data.crates : [];
@@ -845,11 +879,11 @@ async function searchCrates(query, numResults, timeoutMs) {
                 engine: "crates",
             };
         }).filter((item) => item.url)).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "crates.io search returned no results" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "crates.io search returned no results");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `crates.io parse error: ${message}` };
+        return failedProviderSearch(`crates.io parse error: ${message}`);
     }
 }
 async function searchNpmPackage(packageName, timeoutMs) {
@@ -860,7 +894,7 @@ async function searchNpmPackage(packageName, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `npm package error ${result.status}` };
+        return failedProviderSearch(result.error || `npm package error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const record = data;
@@ -877,11 +911,11 @@ async function searchNpmPackage(packageName, timeoutMs) {
                 ].filter(Boolean).join(" · "),
                 engine: "npm",
             }]);
-        return { ok: results.length > 0, results, note: "" };
+        return completedProviderSearch(results, "");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `npm package parse error: ${message}` };
+        return failedProviderSearch(`npm package parse error: ${message}`);
     }
 }
 async function searchNpm(query, numResults, timeoutMs) {
@@ -893,7 +927,7 @@ async function searchNpm(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `npm error ${result.status}` };
+        return failedProviderSearch(result.error || `npm error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.objects) ? data.objects : [];
@@ -911,11 +945,11 @@ async function searchNpm(query, numResults, timeoutMs) {
                 engine: "npm",
             };
         }).filter((item) => item.url)).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "npm search returned no results" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "npm search returned no results");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `npm parse error: ${message}` };
+        return failedProviderSearch(`npm parse error: ${message}`);
     }
 }
 function braveHtmlEnabled() {
@@ -935,7 +969,7 @@ async function searchWikipedia(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `Wikipedia error ${result.status}` };
+        return failedProviderSearch(result.error || `Wikipedia error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.query?.search) ? data.query.search : [];
@@ -950,11 +984,11 @@ async function searchWikipedia(query, numResults, timeoutMs) {
                 engine: "wikipedia",
             };
         }).filter((item) => item.url)).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "Wikipedia search returned no results" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "Wikipedia search returned no results");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `Wikipedia parse error: ${message}` };
+        return failedProviderSearch(`Wikipedia parse error: ${message}`);
     }
 }
 async function searchDuckDuckGo(query, numResults, timeoutMs) {
@@ -964,9 +998,9 @@ async function searchDuckDuckGo(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `DuckDuckGo error ${result.status}` };
+        return failedProviderSearch(result.error || `DuckDuckGo error ${result.status}`);
     if (/anomaly\.js|sending automated queries|captcha/i.test(result.text)) {
-        return { ok: false, note: "DuckDuckGo blocked the automated HTML fallback" };
+        return failedProviderSearch("DuckDuckGo blocked the automated HTML fallback");
     }
     const blocks = result.text.split(/<div class="result[^"]*"/i).slice(1);
     const results = uniqueResults(blocks.map((block) => {
@@ -981,7 +1015,7 @@ async function searchDuckDuckGo(query, numResults, timeoutMs) {
             engine: "duckduckgo",
         };
     }).filter((item) => item.url)).slice(0, numResults);
-    return { ok: results.length > 0, results, note: results.length > 0 ? "" : "DuckDuckGo returned no results" };
+    return completedProviderSearch(results, results.length > 0 ? "" : "DuckDuckGo returned no results");
 }
 async function searchBraveHtml(query, numResults, timeoutMs) {
     const result = await fetchText(`https://search.brave.com/search?q=${encodeURIComponent(query)}&source=web`, timeoutMs, {
@@ -991,7 +1025,7 @@ async function searchBraveHtml(query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `Brave HTML error ${result.status}` };
+        return failedProviderSearch(result.error || `Brave HTML error ${result.status}`);
     const results = [];
     const regex = /<a href="(https?:\/\/[^"#]+)"[^>]*>[\s\S]*?<div class="title[^>]*"[^>]*>([\s\S]*?)<\/div>[\s\S]*?<\/a>[\s\S]*?<div class="generic-snippet[\s\S]*?<div class="content[^>]*"[^>]*>([\s\S]*?)<\/div>/gi;
     for (const match of result.text.matchAll(regex)) {
@@ -1005,7 +1039,7 @@ async function searchBraveHtml(query, numResults, timeoutMs) {
             break;
     }
     const unique = uniqueResults(results);
-    return { ok: unique.length > 0, results: unique, note: unique.length > 0 ? "" : "Brave HTML returned no results" };
+    return completedProviderSearch(unique, unique.length > 0 ? "" : "Brave HTML returned no results");
 }
 async function searchSearxng(baseUrl, query, numResults, timeoutMs) {
     const normalizedBase = baseUrl.replace(/\/+$/, "");
@@ -1016,7 +1050,7 @@ async function searchSearxng(baseUrl, query, numResults, timeoutMs) {
         },
     });
     if (!result.ok)
-        return { ok: false, note: result.error || `SearXNG error ${result.status}` };
+        return failedProviderSearch(result.error || `SearXNG error ${result.status}`);
     try {
         const data = result.text ? JSON.parse(result.text) : {};
         const raw = Array.isArray(data?.results) ? data.results : [];
@@ -1026,11 +1060,11 @@ async function searchSearxng(baseUrl, query, numResults, timeoutMs) {
             snippet: String(item?.content || item?.description || item?.text || "").trim(),
             engine: "searxng",
         }))).slice(0, numResults);
-        return { ok: results.length > 0, results, note: results.length > 0 ? "" : "SearXNG returned no results" };
+        return completedProviderSearch(results, results.length > 0 ? "" : "SearXNG returned no results");
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return { ok: false, note: `SearXNG parse error: ${message}` };
+        return failedProviderSearch(`SearXNG parse error: ${message}`);
     }
 }
 export async function runSmartsearch(options, runtime = {}) {
@@ -1042,6 +1076,15 @@ export async function runSmartsearch(options, runtime = {}) {
     const searxngBaseUrl = (options.searxngBaseUrl || configText("search.searxngBaseUrl") || "").trim();
     const fallbacks = [];
     const notes = [];
+    const attempts = [];
+    const recordAttempt = (provider, outcome) => {
+        attempts.push({
+            provider,
+            status: outcome.status,
+            result_count: outcome.results.length,
+            ...(outcome.status === "failed" && outcome.note ? { error: outcome.note } : {}),
+        });
+    };
     try {
         const siteOperator = extractSiteOperator(query);
         if (siteOperator === "velog.io") {
@@ -1052,8 +1095,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else {
                 const velog = await searchVelog(query, numResults, timeoutMs);
                 fallbacks.push("velog");
+                recordAttempt("velog", velog);
                 if (velog.ok)
-                    return maybeRunCrawlHandoff({ engine: "velog", query, results: velog.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "velog", query, results: velog.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (velog.note)
                     notes.push(velog.note);
             }
@@ -1066,8 +1110,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else {
                 const stackexchange = await searchStackExchange(query, numResults, timeoutMs);
                 fallbacks.push("stackexchange");
+                recordAttempt("stackexchange", stackexchange);
                 if (stackexchange.ok)
-                    return maybeRunCrawlHandoff({ engine: "stackexchange", query, results: stackexchange.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "stackexchange", query, results: stackexchange.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (stackexchange.note)
                     notes.push(stackexchange.note);
             }
@@ -1080,8 +1125,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else {
                 const hackernews = await searchHackerNews(query, numResults, timeoutMs);
                 fallbacks.push("hackernews");
+                recordAttempt("hackernews", hackernews);
                 if (hackernews.ok)
-                    return maybeRunCrawlHandoff({ engine: "hackernews", query, results: hackernews.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "hackernews", query, results: hackernews.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (hackernews.note)
                     notes.push(hackernews.note);
             }
@@ -1094,8 +1140,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else {
                 const reddit = await searchReddit(query, numResults, timeoutMs);
                 fallbacks.push("reddit");
+                recordAttempt("reddit", reddit);
                 if (reddit.ok)
-                    return maybeRunCrawlHandoff({ engine: "reddit", query, results: reddit.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "reddit", query, results: reddit.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (reddit.note)
                     notes.push(reddit.note);
             }
@@ -1108,8 +1155,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else if (parseGitHubRepoScope(query)) {
                 const githubRepoDocs = await searchGitHubRepoDocs(query, numResults, timeoutMs);
                 fallbacks.push("github_repo_docs");
+                recordAttempt("github_repo_docs", githubRepoDocs);
                 if (githubRepoDocs.ok)
-                    return maybeRunCrawlHandoff({ engine: "github_repo_docs", query, results: githubRepoDocs.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "github_repo_docs", query, results: githubRepoDocs.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (githubRepoDocs.note)
                     notes.push(githubRepoDocs.note);
             }
@@ -1119,8 +1167,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else {
                 const github = await searchGitHub(query, numResults, timeoutMs);
                 fallbacks.push("github");
+                recordAttempt("github", github);
                 if (github.ok)
-                    return maybeRunCrawlHandoff({ engine: "github", query, results: github.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "github", query, results: github.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (github.note)
                     notes.push(github.note);
             }
@@ -1136,8 +1185,9 @@ export async function runSmartsearch(options, runtime = {}) {
                     ? await searchNpmPackage(exactPackage, timeoutMs)
                     : await searchNpm(query, numResults, timeoutMs);
                 fallbacks.push("npm");
+                recordAttempt("npm", npm);
                 if (npm.ok)
-                    return maybeRunCrawlHandoff({ engine: "npm", query, results: npm.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "npm", query, results: npm.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (npm.note)
                     notes.push(npm.note);
             }
@@ -1150,8 +1200,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else {
                 const mdn = await searchMdn(query, numResults, timeoutMs);
                 fallbacks.push("mdn");
+                recordAttempt("mdn", mdn);
                 if (mdn.ok)
-                    return maybeRunCrawlHandoff({ engine: "mdn", query, results: mdn.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "mdn", query, results: mdn.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (mdn.note)
                     notes.push(mdn.note);
             }
@@ -1164,8 +1215,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else {
                 const crates = await searchCrates(query, numResults, timeoutMs);
                 fallbacks.push("crates");
+                recordAttempt("crates", crates);
                 if (crates.ok)
-                    return maybeRunCrawlHandoff({ engine: "crates", query, results: crates.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "crates", query, results: crates.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (crates.note)
                     notes.push(crates.note);
             }
@@ -1178,8 +1230,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else {
                 const wikipedia = await searchWikipedia(query, numResults, timeoutMs);
                 fallbacks.push("wikipedia");
+                recordAttempt("wikipedia", wikipedia);
                 if (wikipedia.ok)
-                    return maybeRunCrawlHandoff({ engine: "wikipedia", query, results: wikipedia.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "wikipedia", query, results: wikipedia.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (wikipedia.note)
                     notes.push(wikipedia.note);
             }
@@ -1192,8 +1245,9 @@ export async function runSmartsearch(options, runtime = {}) {
             else {
                 const searxng = await searchSearxng(searxngBaseUrl, query, numResults, timeoutMs);
                 fallbacks.push("searxng");
+                recordAttempt("searxng", searxng);
                 if (searxng.ok)
-                    return maybeRunCrawlHandoff({ engine: "searxng", query, results: searxng.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                    return maybeRunCrawlHandoff({ engine: "searxng", query, results: searxng.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
                 if (searxng.note)
                     notes.push(searxng.note);
             }
@@ -1204,8 +1258,9 @@ export async function runSmartsearch(options, runtime = {}) {
         if (duckduckgoEnabled()) {
             const ddg = await searchDuckDuckGo(query, numResults, timeoutMs);
             fallbacks.push("duckduckgo");
+            recordAttempt("duckduckgo", ddg);
             if (ddg.ok)
-                return maybeRunCrawlHandoff({ engine: "duckduckgo", query, results: ddg.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                return maybeRunCrawlHandoff({ engine: "duckduckgo", query, results: ddg.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
             if (ddg.note)
                 notes.push(ddg.note);
         }
@@ -1215,19 +1270,27 @@ export async function runSmartsearch(options, runtime = {}) {
         if (braveHtmlEnabled()) {
             const braveHtml = await searchBraveHtml(query, numResults, timeoutMs);
             fallbacks.push("brave_html");
+            recordAttempt("brave_html", braveHtml);
             if (braveHtml.ok)
-                return maybeRunCrawlHandoff({ engine: "brave_html", query, results: braveHtml.results, fallbacks_tried: fallbacks, notes }, options, runtime);
+                return maybeRunCrawlHandoff({ engine: "brave_html", query, results: braveHtml.results, fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
             if (braveHtml.note)
                 notes.push(braveHtml.note);
         }
         else {
             notes.push("Brave HTML disabled by configuration");
         }
-        return maybeRunCrawlHandoff({ engine: "none", query, results: [], fallbacks_tried: fallbacks, notes }, options, runtime);
+        return maybeRunCrawlHandoff({ engine: "none", query, results: [], fallbacks_tried: fallbacks, notes, execution: smartsearchExecution(attempts) }, options, runtime);
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return maybeRunCrawlHandoff({ engine: "error", query, results: [], fallbacks_tried: fallbacks, notes: [...notes, message] }, options, runtime);
+        return maybeRunCrawlHandoff({
+            engine: "error",
+            query,
+            results: [],
+            fallbacks_tried: fallbacks,
+            notes: [...notes, message],
+            execution: { status: "failed", attempts: [...attempts, { provider: "smartsearch", status: "failed", result_count: 0, error: message }] },
+        }, options, runtime);
     }
 }
 export function renderSmartsearch(response) {