@code-yeongyu/senpi 2026.6.15 → 2026.6.16

package/dist/core/extensions/builtin/websearch/websearch/renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderers.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/websearch/websearch/renderers.ts"],"names":[],"mappings":"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","sourcesContent":["import { Text } from \"@earendil-works/pi-tui\";\n\nimport type { SearchDetails, SearchErrorDetails, SearchProgressDetails, SearchRenderDetails } from \"./types.ts\";\n\ninterface ThemeLike {\n\tbold(value: string): string;\n\tfg(key: string, value: string): string;\n}\n\ninterface SearchArgs {\n\tquery: string;\n\tallowed_domains?: string[];\n\tblocked_domains?: string[];\n}\n\ninterface ResultLike<TDetails> {\n\tcontent: ReadonlyArray<{ type: string; text?: string }>;\n\tdetails?: TDetails;\n}\n\ninterface RenderResultOptions {\n\texpanded?: boolean;\n\tisPartial?: boolean;\n}\n\nfunction shorten(value: string, max: number): string {\n\treturn value.length <= max ? value : `${value.slice(0, max - 1)}…`;\n}\n\nfunction durationText(durationMs: number): string {\n\treturn durationMs >= 1000 ? `${Math.round(durationMs / 1000)}s` : `${durationMs}ms`;\n}\n\nfunction attemptLabel(details: SearchDetails): string {\n\treturn details.attempts\n\t\t? details.attempts\n\t\t\t\t.map(\n\t\t\t\t\t(attempt) =>\n\t\t\t\t\t\t`${attempt.entryId ? `${attempt.provider}/${attempt.entryId}` : attempt.provider}:${attempt.error ? \"failed\" : attempt.resultsCount}`,\n\t\t\t\t)\n\t\t\t\t.join(\" -> \")\n\t\t: \"\";\n}\n\nfunction isSearchProgressDetails(details: SearchRenderDetails | undefined): details is SearchProgressDetails {\n\treturn details !== undefined && \"phase\" in details && details.phase === \"searching\";\n}\n\nfunction isSearchErrorDetails(details: SearchRenderDetails): details is SearchErrorDetails {\n\treturn \"phase\" in details && details.phase === \"error\";\n}\n\nexport function renderSearchCall(args: SearchArgs, theme: ThemeLike): Text {\n\tconst head = theme.fg(\"toolTitle\", theme.bold(\"web_search \"));\n\tconst query = theme.fg(\"accent\", `\"${shorten(args.query, 90)}\"`);\n\tconst domains = args.allowed_domains ?? args.blocked_domains;\n\tconst filter = domains?.length ? theme.fg(\"muted\", ` domains:${domains.length}`) : \"\";\n\treturn new Text(head + query + filter, 0, 0);\n}\n\nexport function renderSearchResult(\n\tresult: ResultLike<SearchRenderDetails>,\n\toptions: RenderResultOptions,\n\ttheme: ThemeLike,\n): Text {\n\tif (options.isPartial) {\n\t\tconst details = result.details;\n\t\tif (isSearchProgressDetails(details)) {\n\t\t\tconst route = details.providerLabels.length > 0 ? details.providerLabels.join(\" -> \") : \"configured providers\";\n\t\t\treturn new Text(\n\t\t\t\ttheme.fg(\"warning\", `Searching \"${shorten(details.query, 80)}\" via ${route} (max ${details.maxResults})`),\n\t\t\t\t0,\n\t\t\t\t0,\n\t\t\t);\n\t\t}\n\t\treturn new Text(theme.fg(\"warning\", result.content[0]?.text ?? \"Searching the web...\"), 0, 0);\n\t}\n\n\tconst details = result.details;\n\tif (!details) return new Text(theme.fg(\"muted\", result.content[0]?.text ?? \"\"), 0, 0);\n\tif (isSearchProgressDetails(details)) return new Text(theme.fg(\"muted\", result.content[0]?.text ?? \"\"), 0, 0);\n\tif (isSearchErrorDetails(details)) return new Text(theme.fg(\"error\", details.error), 0, 0);\n\tif (details.error) return new Text(theme.fg(\"error\", details.error), 0, 0);\n\n\tconst count = details.results.length;\n\tconst provider = details.entryId ? `${details.provider}/${details.entryId}` : details.provider;\n\tconst summary =\n\t\ttheme.fg(\"success\", `${count} result${count === 1 ? \"\" : \"s\"}`) +\n\t\ttheme.fg(\n\t\t\t\"muted\",\n\t\t\t` via ${provider}${details.strategy ? ` (${details.strategy})` : \"\"} in ${durationText(details.durationMs)}`,\n\t\t) +\n\t\t(details.truncated ? theme.fg(\"warning\", \" (truncated)\") : \"\");\n\n\tif (count === 0) return new Text(summary, 0, 0);\n\n\tconst attempts = attemptLabel(details);\n\tconst rows = options.expanded && attempts ? [summary, theme.fg(\"muted\", `route ${attempts}`)] : [summary];\n\tconst visibleLimit = options.expanded ? 8 : 3;\n\tfor (const item of details.results.slice(0, visibleLimit)) {\n\t\trows.push(`${theme.fg(\"accent\", shorten(item.title, 80))} ${theme.fg(\"dim\", shorten(item.url, 100))}`);\n\t\tif (item.snippet) rows.push(theme.fg(\"muted\", `  ${shorten(item.snippet, 140)}`));\n\t}\n\tif (details.results.length > visibleLimit) {\n\t\trows.push(theme.fg(\"dim\", `… ${details.results.length - visibleLimit} more sources`));\n\t}\n\treturn new Text(rows.join(\"\\n\"), 0, 0);\n}\n"]}

package/dist/core/extensions/builtin/websearch/websearch/search.d.ts

@@ -0,0 +1,9 @@
+import type { SearchDetails, SearchRequest, WebsearchConfig } from "./types.ts";
+export interface SearchRoutingState {
+    roundRobinCursor: number;
+    successCounts: number[];
+}
+export declare function createSearchRoutingState(providerCount: number): SearchRoutingState;
+export declare function performSearch(config: WebsearchConfig, request: SearchRequest, signal?: AbortSignal, routingState?: SearchRoutingState): Promise<SearchDetails>;
+export declare function formatSearchText(details: SearchDetails): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/core/extensions/builtin/websearch/websearch/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/websearch/websearch/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIX,aAAa,EAEb,aAAa,EACb,eAAe,EACf,MAAM,YAAY,CAAC;AAkCpB,MAAM,WAAW,kBAAkB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB,CAElF;AA0ID,wBAAsB,aAAa,CAClC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,kBAAkB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAgExB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CA0B/D"}

package/dist/core/extensions/builtin/websearch/websearch/search.js

@@ -0,0 +1,261 @@
+import { buildSearchRequest, normalizeSearchResponse } from "./providers.js";
+const MAX_ERROR_DETAIL_LENGTH = 500;
+function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function truncate(value, max) {
+    return value.length > max ? `${value.slice(0, max - 1)}…` : value;
+}
+function extractErrorDetail(payload, bodyText) {
+    if (isJsonObject(payload)) {
+        const obj = payload;
+        const error = obj["error"];
+        if (typeof error === "string" && error.length > 0)
+            return truncate(error, MAX_ERROR_DETAIL_LENGTH);
+        if (isJsonObject(error)) {
+            const message = error["message"];
+            if (typeof message === "string" && message.length > 0)
+                return truncate(message, MAX_ERROR_DETAIL_LENGTH);
+        }
+        const message = obj["message"];
+        if (typeof message === "string" && message.length > 0)
+            return truncate(message, MAX_ERROR_DETAIL_LENGTH);
+    }
+    const trimmed = bodyText.trim();
+    if (!trimmed)
+        return "";
+    return truncate(trimmed, MAX_ERROR_DETAIL_LENGTH);
+}
+function httpErrorMessage(status, payload, bodyText) {
+    const detail = extractErrorDetail(payload, bodyText);
+    return detail ? `Search failed with HTTP ${status}: ${detail}` : `Search failed with HTTP ${status}`;
+}
+export function createSearchRoutingState(providerCount) {
+    return { roundRobinCursor: 0, successCounts: Array.from({ length: providerCount }, () => 0) };
+}
+function entryLabel(entry) {
+    if ("entryId" in entry && entry.entryId)
+        return `${entry.provider}/${entry.entryId}`;
+    if ("id" in entry && entry.id)
+        return `${entry.provider}/${entry.id}`;
+    return entry.provider;
+}
+function sortedPriorityIndices(providers) {
+    return providers
+        .map((provider, index) => ({ index, priority: provider.priority ?? index }))
+        .sort((left, right) => left.priority - right.priority || left.index - right.index)
+        .map((item) => item.index);
+}
+function weightedIndices(providers) {
+    const indices = [];
+    for (const [index, provider] of providers.entries()) {
+        const weight = Math.max(1, Math.trunc(provider.weight ?? 1));
+        for (let count = 0; count < weight; count += 1)
+            indices.push(index);
+    }
+    return indices.length > 0 ? indices : providers.map((_provider, index) => index);
+}
+function rotateUnique(indices, start, providerCount) {
+    const order = [];
+    for (let offset = 0; offset < indices.length; offset += 1) {
+        const index = indices[(start + offset) % indices.length];
+        if (index !== undefined && !order.includes(index))
+            order.push(index);
+    }
+    for (let index = 0; index < providerCount; index += 1) {
+        if (!order.includes(index))
+            order.push(index);
+    }
+    return order;
+}
+function selectOrder(strategy, providers, state) {
+    if (strategy === "priority")
+        return sortedPriorityIndices(providers);
+    if (strategy === "round-robin") {
+        const indices = weightedIndices(providers);
+        const order = rotateUnique(indices, state.roundRobinCursor % indices.length, providers.length);
+        state.roundRobinCursor = (state.roundRobinCursor + 1) % indices.length;
+        return order;
+    }
+    let selected = 0;
+    let selectedCount = state.successCounts[0] ?? 0;
+    for (let index = 1; index < providers.length; index += 1) {
+        const count = state.successCounts[index] ?? 0;
+        if (count < selectedCount) {
+            selected = index;
+            selectedCount = count;
+        }
+    }
+    return [selected, ...providers.map((_provider, index) => index).filter((index) => index !== selected)];
+}
+async function performProviderSearch(config, request, signal) {
+    const startedAt = Date.now();
+    const built = buildSearchRequest(config, request);
+    let response;
+    try {
+        const init = {
+            ...built.init,
+        };
+        if (built.body !== undefined)
+            init.body = JSON.stringify(built.body);
+        if (signal !== undefined)
+            init.signal = signal;
+        response = await fetch(built.url, init);
+    }
+    catch (error) {
+        const details = {
+            provider: config.provider,
+            query: request.query,
+            results: [],
+            durationMs: Date.now() - startedAt,
+            truncated: false,
+            error: error instanceof Error ? error.message : "Search request failed",
+        };
+        if (config.id !== undefined)
+            details.entryId = config.id;
+        return details;
+    }
+    let bodyText = "";
+    try {
+        bodyText = await response.text();
+    }
+    catch {
+        bodyText = "";
+    }
+    let payload = {};
+    if (config.provider === "duckduckgo-html") {
+        payload = { html: bodyText };
+    }
+    else if (bodyText.length > 0) {
+        try {
+            payload = JSON.parse(bodyText);
+        }
+        catch {
+            payload = {};
+        }
+    }
+    if (!response.ok) {
+        const details = {
+            provider: config.provider,
+            query: request.query,
+            results: [],
+            durationMs: Date.now() - startedAt,
+            truncated: false,
+            error: httpErrorMessage(response.status, payload, bodyText),
+        };
+        if (config.id !== undefined)
+            details.entryId = config.id;
+        return details;
+    }
+    const results = normalizeSearchResponse(config.provider, payload);
+    const max = request.maxResults;
+    const details = {
+        provider: config.provider,
+        query: request.query,
+        results: results.slice(0, max),
+        durationMs: Date.now() - startedAt,
+        truncated: results.length > max,
+    };
+    if (config.id !== undefined)
+        details.entryId = config.id;
+    return details;
+}
+function attemptFromDetails(details) {
+    const attempt = {
+        provider: details.provider,
+        durationMs: details.durationMs,
+        resultsCount: details.results.length,
+    };
+    if (details.entryId)
+        attempt.entryId = details.entryId;
+    if (details.error)
+        attempt.error = details.error;
+    return attempt;
+}
+export async function performSearch(config, request, signal, routingState) {
+    const startedAt = Date.now();
+    const state = routingState ?? createSearchRoutingState(config.providers.length);
+    const order = selectOrder(config.strategy, config.providers, state);
+    const attempts = [];
+    const collected = new Map();
+    let selectedDetails;
+    for (const index of order) {
+        const provider = config.providers[index];
+        if (!provider)
+            continue;
+        const details = await performProviderSearch(provider, request, signal);
+        attempts.push(attemptFromDetails(details));
+        if (details.error) {
+            if (!config.fallback)
+                return { ...details, strategy: config.strategy, attempts };
+            selectedDetails = details;
+            continue;
+        }
+        state.successCounts[index] = (state.successCounts[index] ?? 0) + 1;
+        if (config.strategy !== "fill-first") {
+            return { ...details, strategy: config.strategy, attempts };
+        }
+        selectedDetails = details;
+        for (const item of details.results) {
+            if (collected.size >= request.maxResults)
+                break;
+            collected.set(item.url, item);
+        }
+        if (collected.size >= request.maxResults)
+            break;
+    }
+    if (collected.size > 0 && selectedDetails) {
+        const results = [...collected.values()];
+        const details = {
+            provider: selectedDetails.provider,
+            query: request.query,
+            results,
+            durationMs: Date.now() - startedAt,
+            truncated: results.length >= request.maxResults,
+            strategy: config.strategy,
+            attempts,
+        };
+        if (selectedDetails.entryId !== undefined)
+            details.entryId = selectedDetails.entryId;
+        return details;
+    }
+    const failed = selectedDetails ?? {
+        provider: config.providers[0]?.provider ?? "exa",
+        query: request.query,
+        results: [],
+        durationMs: Date.now() - startedAt,
+        truncated: false,
+        error: "All configured search providers failed.",
+    };
+    return {
+        ...failed,
+        durationMs: Date.now() - startedAt,
+        strategy: config.strategy,
+        attempts,
+        error: `All configured search providers failed: ${attempts.map((attempt) => `${entryLabel(attempt)} ${attempt.error ?? "failed"}`).join("; ")}`,
+    };
+}
+export function formatSearchText(details) {
+    if (details.error)
+        return details.error;
+    if (details.results.length === 0)
+        return `No web search results found for "${details.query}".`;
+    const route = details.strategy
+        ? ` via ${details.entryId ? `${details.provider}/${details.entryId}` : details.provider} (${details.strategy})`
+        : ` via ${details.provider}`;
+    const lines = [`Web search results for "${details.query}"${route}:`, ""];
+    if (details.attempts && details.attempts.length > 0) {
+        lines.push(`Routing attempts: ${details.attempts
+            .map((attempt) => `${entryLabel(attempt)} ${attempt.error ? `failed: ${attempt.error}` : `${attempt.resultsCount} result${attempt.resultsCount === 1 ? "" : "s"}`}`)
+            .join(" -> ")}`, "");
+    }
+    for (const [index, item] of details.results.entries()) {
+        lines.push(`${index + 1}. ${item.title}`);
+        lines.push(`   ${item.url}`);
+        if (item.snippet)
+            lines.push(`   ${item.snippet}`);
+    }
+    lines.push("", "REMINDER: Include relevant sources from the URLs above in the final answer.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=search.js.map

package/dist/core/extensions/builtin/websearch/websearch/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/websearch/websearch/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAW7E,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,SAAS,YAAY,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,GAAW;IAC3C,OAAO,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACnE,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAgB,EAAE,QAAgB;IAC7D,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,OAAO,CAAC;QACpB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;QACnG,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;YACjC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;QAC1G,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,OAAgB,EAAE,QAAgB;IAC3E,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,CAAC,CAAC,2BAA2B,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,2BAA2B,MAAM,EAAE,CAAC;AACtG,CAAC;AAOD,MAAM,UAAU,wBAAwB,CAAC,aAAqB;IAC7D,OAAO,EAAE,gBAAgB,EAAE,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/F,CAAC;AAED,SAAS,UAAU,CAAC,KAAmE;IACtF,IAAI,SAAS,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;IACrF,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK,CAAC,EAAE;QAAE,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;IACtE,OAAO,KAAK,CAAC,QAAQ,CAAC;AACvB,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAgC;IAC9D,OAAO,SAAS;SACd,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;SAC3E,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;SACjF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,eAAe,CAAC,SAAgC;IACxD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,YAAY,CAAC,OAAiB,EAAE,KAAa,EAAE,aAAqB;IAC5E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,aAAa,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,QAAyB,EAAE,SAAgC,EAAE,KAAyB;IAC1G,IAAI,QAAQ,KAAK,UAAU;QAAE,OAAO,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACrE,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/F,KAAK,CAAC,gBAAgB,GAAG,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QACvE,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,KAAK,GAAG,aAAa,EAAE,CAAC;YAC3B,QAAQ,GAAG,KAAK,CAAC;YACjB,aAAa,GAAG,KAAK,CAAC;QACvB,CAAC;IACF,CAAC;IACD,OAAO,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,KAAK,UAAU,qBAAqB,CACnC,MAA2B,EAC3B,OAAsB,EACtB,MAAoB;IAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACJ,MAAM,IAAI,GAAgB;YACzB,GAAG,KAAK,CAAC,IAAI;SACb,CAAC;QACF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAC/C,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAkB;YAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;SACvE,CAAC;QACF,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS;YAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;QACzD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACJ,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACR,QAAQ,GAAG,EAAE,CAAC;IACf,CAAC;IACD,IAAI,OAAO,GAAY,EAAE,CAAC;IAC1B,IAAI,MAAM,CAAC,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QAC3C,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;SAAM,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YACJ,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,GAAG,EAAE,CAAC;QACd,CAAC;IACF,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,OAAO,GAAkB;YAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;SAC3D,CAAC;QACF,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS;YAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;QACzD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAC/B,MAAM,OAAO,GAAkB;QAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAC9B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QAClC,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,GAAG;KAC/B,CAAC;IACF,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS;QAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;IACzD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAsB;IACjD,MAAM,OAAO,GAAkB;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;KACpC,CAAC;IACF,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACvD,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACjD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAAuB,EACvB,OAAsB,EACtB,MAAoB,EACpB,YAAiC;IAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,YAAY,IAAI,wBAAwB,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4C,CAAC;IACtE,IAAI,eAA0C,CAAC;IAE/C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACvE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;QAE3C,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAAE,OAAO,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;YACjF,eAAe,GAAG,OAAO,CAAC;YAC1B,SAAS;QACV,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAEnE,IAAI,MAAM,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACtC,OAAO,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAC5D,CAAC;QAED,eAAe,GAAG,OAAO,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,UAAU;gBAAE,MAAM;YAChD,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,UAAU;YAAE,MAAM;IACjD,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,MAAM,OAAO,GAAkB;YAC9B,QAAQ,EAAE,eAAe,CAAC,QAAQ;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,SAAS,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,UAAU;YAC/C,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ;SACR,CAAC;QACF,IAAI,eAAe,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC;QACrF,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,IAAI;QACjC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,KAAK;QAChD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QAClC,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,yCAAyC;KAChD,CAAC;IACF,OAAO;QACN,GAAG,MAAM;QACT,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ;QACR,KAAK,EAAE,2CAA2C,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC/I,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACtD,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IACxC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,oCAAoC,OAAO,CAAC,KAAK,IAAI,CAAC;IAE/F,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ;QAC7B,CAAC,CAAC,QAAQ,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,GAAG;QAC/G,CAAC,CAAC,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,2BAA2B,OAAO,CAAC,KAAK,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CACT,qBAAqB,OAAO,CAAC,QAAQ;aACnC,GAAG,CACH,CAAC,OAAO,EAAE,EAAE,CACX,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,UAAU,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAClJ;aACA,IAAI,CAAC,MAAM,CAAC,EAAE,EAChB,EAAE,CACF,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,6EAA6E,CAAC,CAAC;IAC9F,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC","sourcesContent":["import { buildSearchRequest, normalizeSearchResponse } from \"./providers.ts\";\nimport type {\n\tJsonObject,\n\tRoutingStrategy,\n\tSearchAttempt,\n\tSearchDetails,\n\tSearchProviderEntry,\n\tSearchRequest,\n\tWebsearchConfig,\n} from \"./types.ts\";\n\nconst MAX_ERROR_DETAIL_LENGTH = 500;\n\nfunction isJsonObject(value: unknown): value is JsonObject {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction truncate(value: string, max: number): string {\n\treturn value.length > max ? `${value.slice(0, max - 1)}…` : value;\n}\n\nfunction extractErrorDetail(payload: unknown, bodyText: string): string {\n\tif (isJsonObject(payload)) {\n\t\tconst obj = payload;\n\t\tconst error = obj[\"error\"];\n\t\tif (typeof error === \"string\" && error.length > 0) return truncate(error, MAX_ERROR_DETAIL_LENGTH);\n\t\tif (isJsonObject(error)) {\n\t\t\tconst message = error[\"message\"];\n\t\t\tif (typeof message === \"string\" && message.length > 0) return truncate(message, MAX_ERROR_DETAIL_LENGTH);\n\t\t}\n\t\tconst message = obj[\"message\"];\n\t\tif (typeof message === \"string\" && message.length > 0) return truncate(message, MAX_ERROR_DETAIL_LENGTH);\n\t}\n\tconst trimmed = bodyText.trim();\n\tif (!trimmed) return \"\";\n\treturn truncate(trimmed, MAX_ERROR_DETAIL_LENGTH);\n}\n\nfunction httpErrorMessage(status: number, payload: unknown, bodyText: string): string {\n\tconst detail = extractErrorDetail(payload, bodyText);\n\treturn detail ? `Search failed with HTTP ${status}: ${detail}` : `Search failed with HTTP ${status}`;\n}\n\nexport interface SearchRoutingState {\n\troundRobinCursor: number;\n\tsuccessCounts: number[];\n}\n\nexport function createSearchRoutingState(providerCount: number): SearchRoutingState {\n\treturn { roundRobinCursor: 0, successCounts: Array.from({ length: providerCount }, () => 0) };\n}\n\nfunction entryLabel(entry: Pick<SearchProviderEntry, \"provider\" | \"id\"> | SearchAttempt): string {\n\tif (\"entryId\" in entry && entry.entryId) return `${entry.provider}/${entry.entryId}`;\n\tif (\"id\" in entry && entry.id) return `${entry.provider}/${entry.id}`;\n\treturn entry.provider;\n}\n\nfunction sortedPriorityIndices(providers: SearchProviderEntry[]): number[] {\n\treturn providers\n\t\t.map((provider, index) => ({ index, priority: provider.priority ?? index }))\n\t\t.sort((left, right) => left.priority - right.priority || left.index - right.index)\n\t\t.map((item) => item.index);\n}\n\nfunction weightedIndices(providers: SearchProviderEntry[]): number[] {\n\tconst indices: number[] = [];\n\tfor (const [index, provider] of providers.entries()) {\n\t\tconst weight = Math.max(1, Math.trunc(provider.weight ?? 1));\n\t\tfor (let count = 0; count < weight; count += 1) indices.push(index);\n\t}\n\treturn indices.length > 0 ? indices : providers.map((_provider, index) => index);\n}\n\nfunction rotateUnique(indices: number[], start: number, providerCount: number): number[] {\n\tconst order: number[] = [];\n\tfor (let offset = 0; offset < indices.length; offset += 1) {\n\t\tconst index = indices[(start + offset) % indices.length];\n\t\tif (index !== undefined && !order.includes(index)) order.push(index);\n\t}\n\tfor (let index = 0; index < providerCount; index += 1) {\n\t\tif (!order.includes(index)) order.push(index);\n\t}\n\treturn order;\n}\n\nfunction selectOrder(strategy: RoutingStrategy, providers: SearchProviderEntry[], state: SearchRoutingState): number[] {\n\tif (strategy === \"priority\") return sortedPriorityIndices(providers);\n\tif (strategy === \"round-robin\") {\n\t\tconst indices = weightedIndices(providers);\n\t\tconst order = rotateUnique(indices, state.roundRobinCursor % indices.length, providers.length);\n\t\tstate.roundRobinCursor = (state.roundRobinCursor + 1) % indices.length;\n\t\treturn order;\n\t}\n\n\tlet selected = 0;\n\tlet selectedCount = state.successCounts[0] ?? 0;\n\tfor (let index = 1; index < providers.length; index += 1) {\n\t\tconst count = state.successCounts[index] ?? 0;\n\t\tif (count < selectedCount) {\n\t\t\tselected = index;\n\t\t\tselectedCount = count;\n\t\t}\n\t}\n\treturn [selected, ...providers.map((_provider, index) => index).filter((index) => index !== selected)];\n}\n\nasync function performProviderSearch(\n\tconfig: SearchProviderEntry,\n\trequest: SearchRequest,\n\tsignal?: AbortSignal,\n): Promise<SearchDetails> {\n\tconst startedAt = Date.now();\n\tconst built = buildSearchRequest(config, request);\n\tlet response: Response;\n\ttry {\n\t\tconst init: RequestInit = {\n\t\t\t...built.init,\n\t\t};\n\t\tif (built.body !== undefined) init.body = JSON.stringify(built.body);\n\t\tif (signal !== undefined) init.signal = signal;\n\t\tresponse = await fetch(built.url, init);\n\t} catch (error) {\n\t\tconst details: SearchDetails = {\n\t\t\tprovider: config.provider,\n\t\t\tquery: request.query,\n\t\t\tresults: [],\n\t\t\tdurationMs: Date.now() - startedAt,\n\t\t\ttruncated: false,\n\t\t\terror: error instanceof Error ? error.message : \"Search request failed\",\n\t\t};\n\t\tif (config.id !== undefined) details.entryId = config.id;\n\t\treturn details;\n\t}\n\n\tlet bodyText = \"\";\n\ttry {\n\t\tbodyText = await response.text();\n\t} catch {\n\t\tbodyText = \"\";\n\t}\n\tlet payload: unknown = {};\n\tif (config.provider === \"duckduckgo-html\") {\n\t\tpayload = { html: bodyText };\n\t} else if (bodyText.length > 0) {\n\t\ttry {\n\t\t\tpayload = JSON.parse(bodyText);\n\t\t} catch {\n\t\t\tpayload = {};\n\t\t}\n\t}\n\tif (!response.ok) {\n\t\tconst details: SearchDetails = {\n\t\t\tprovider: config.provider,\n\t\t\tquery: request.query,\n\t\t\tresults: [],\n\t\t\tdurationMs: Date.now() - startedAt,\n\t\t\ttruncated: false,\n\t\t\terror: httpErrorMessage(response.status, payload, bodyText),\n\t\t};\n\t\tif (config.id !== undefined) details.entryId = config.id;\n\t\treturn details;\n\t}\n\n\tconst results = normalizeSearchResponse(config.provider, payload);\n\tconst max = request.maxResults;\n\tconst details: SearchDetails = {\n\t\tprovider: config.provider,\n\t\tquery: request.query,\n\t\tresults: results.slice(0, max),\n\t\tdurationMs: Date.now() - startedAt,\n\t\ttruncated: results.length > max,\n\t};\n\tif (config.id !== undefined) details.entryId = config.id;\n\treturn details;\n}\n\nfunction attemptFromDetails(details: SearchDetails): SearchAttempt {\n\tconst attempt: SearchAttempt = {\n\t\tprovider: details.provider,\n\t\tdurationMs: details.durationMs,\n\t\tresultsCount: details.results.length,\n\t};\n\tif (details.entryId) attempt.entryId = details.entryId;\n\tif (details.error) attempt.error = details.error;\n\treturn attempt;\n}\n\nexport async function performSearch(\n\tconfig: WebsearchConfig,\n\trequest: SearchRequest,\n\tsignal?: AbortSignal,\n\troutingState?: SearchRoutingState,\n): Promise<SearchDetails> {\n\tconst startedAt = Date.now();\n\tconst state = routingState ?? createSearchRoutingState(config.providers.length);\n\tconst order = selectOrder(config.strategy, config.providers, state);\n\tconst attempts: SearchAttempt[] = [];\n\tconst collected = new Map<string, SearchDetails[\"results\"][number]>();\n\tlet selectedDetails: SearchDetails | undefined;\n\n\tfor (const index of order) {\n\t\tconst provider = config.providers[index];\n\t\tif (!provider) continue;\n\t\tconst details = await performProviderSearch(provider, request, signal);\n\t\tattempts.push(attemptFromDetails(details));\n\n\t\tif (details.error) {\n\t\t\tif (!config.fallback) return { ...details, strategy: config.strategy, attempts };\n\t\t\tselectedDetails = details;\n\t\t\tcontinue;\n\t\t}\n\n\t\tstate.successCounts[index] = (state.successCounts[index] ?? 0) + 1;\n\n\t\tif (config.strategy !== \"fill-first\") {\n\t\t\treturn { ...details, strategy: config.strategy, attempts };\n\t\t}\n\n\t\tselectedDetails = details;\n\t\tfor (const item of details.results) {\n\t\t\tif (collected.size >= request.maxResults) break;\n\t\t\tcollected.set(item.url, item);\n\t\t}\n\t\tif (collected.size >= request.maxResults) break;\n\t}\n\n\tif (collected.size > 0 && selectedDetails) {\n\t\tconst results = [...collected.values()];\n\t\tconst details: SearchDetails = {\n\t\t\tprovider: selectedDetails.provider,\n\t\t\tquery: request.query,\n\t\t\tresults,\n\t\t\tdurationMs: Date.now() - startedAt,\n\t\t\ttruncated: results.length >= request.maxResults,\n\t\t\tstrategy: config.strategy,\n\t\t\tattempts,\n\t\t};\n\t\tif (selectedDetails.entryId !== undefined) details.entryId = selectedDetails.entryId;\n\t\treturn details;\n\t}\n\n\tconst failed = selectedDetails ?? {\n\t\tprovider: config.providers[0]?.provider ?? \"exa\",\n\t\tquery: request.query,\n\t\tresults: [],\n\t\tdurationMs: Date.now() - startedAt,\n\t\ttruncated: false,\n\t\terror: \"All configured search providers failed.\",\n\t};\n\treturn {\n\t\t...failed,\n\t\tdurationMs: Date.now() - startedAt,\n\t\tstrategy: config.strategy,\n\t\tattempts,\n\t\terror: `All configured search providers failed: ${attempts.map((attempt) => `${entryLabel(attempt)} ${attempt.error ?? \"failed\"}`).join(\"; \")}`,\n\t};\n}\n\nexport function formatSearchText(details: SearchDetails): string {\n\tif (details.error) return details.error;\n\tif (details.results.length === 0) return `No web search results found for \"${details.query}\".`;\n\n\tconst route = details.strategy\n\t\t? ` via ${details.entryId ? `${details.provider}/${details.entryId}` : details.provider} (${details.strategy})`\n\t\t: ` via ${details.provider}`;\n\tconst lines = [`Web search results for \"${details.query}\"${route}:`, \"\"];\n\tif (details.attempts && details.attempts.length > 0) {\n\t\tlines.push(\n\t\t\t`Routing attempts: ${details.attempts\n\t\t\t\t.map(\n\t\t\t\t\t(attempt) =>\n\t\t\t\t\t\t`${entryLabel(attempt)} ${attempt.error ? `failed: ${attempt.error}` : `${attempt.resultsCount} result${attempt.resultsCount === 1 ? \"\" : \"s\"}`}`,\n\t\t\t\t)\n\t\t\t\t.join(\" -> \")}`,\n\t\t\t\"\",\n\t\t);\n\t}\n\tfor (const [index, item] of details.results.entries()) {\n\t\tlines.push(`${index + 1}. ${item.title}`);\n\t\tlines.push(`   ${item.url}`);\n\t\tif (item.snippet) lines.push(`   ${item.snippet}`);\n\t}\n\tlines.push(\"\", \"REMINDER: Include relevant sources from the URLs above in the final answer.\");\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/core/extensions/builtin/websearch/websearch/tool.d.ts

@@ -0,0 +1,18 @@
+import { Type } from "typebox";
+import { defineTool } from "../../../types.ts";
+import type { ConfigLoadResult, SearchRenderDetails } from "./types.ts";
+declare const Params: Type.TObject<{
+    query: Type.TString;
+    allowed_domains: Type.TOptional<Type.TArray<Type.TString>>;
+    blocked_domains: Type.TOptional<Type.TArray<Type.TString>>;
+}>;
+export type ConfigProvider = () => ConfigLoadResult;
+type WebSearchTool = ReturnType<typeof defineTool<typeof Params, SearchRenderDetails>>;
+export declare function createWebSearchTool(getConfig: ConfigProvider): WebSearchTool;
+export declare const web_search: import("../../../types.ts").ToolDefinition<Type.TObject<{
+    query: Type.TString;
+    allowed_domains: Type.TOptional<Type.TArray<Type.TString>>;
+    blocked_domains: Type.TOptional<Type.TArray<Type.TString>>;
+}>, SearchRenderDetails, any> & import("../../../types.ts").ToolDefinition<any, any, any>;
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/dist/core/extensions/builtin/websearch/websearch/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/websearch/websearch/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C,OAAO,KAAK,EACX,gBAAgB,EAIhB,mBAAmB,EAEnB,MAAM,YAAY,CAAC;AAEpB,QAAA,MAAM,MAAM;;;;EAWX,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC;AACpD,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,OAAO,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;AA0BvF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,cAAc,GAAG,aAAa,CA6D5E;AAED,eAAO,MAAM,UAAU;;;;yFAIpB,CAAC"}

package/dist/core/extensions/builtin/websearch/websearch/tool.js

@@ -0,0 +1,88 @@
+import { Type } from "typebox";
+import { defineTool } from "../../../types.js";
+import { buildNativeEntry } from "./native.js";
+import { renderSearchCall, renderSearchResult } from "./renderers.js";
+import { createSearchRoutingState, formatSearchText, performSearch } from "./search.js";
+const Params = Type.Object({
+    query: Type.String({ minLength: 2, description: "The search query to use" }),
+    allowed_domains: Type.Optional(Type.Array(Type.String(), { description: "Only include search results from these domains" })),
+    blocked_domains: Type.Optional(Type.Array(Type.String(), { description: "Never include search results from these domains" })),
+}, { additionalProperties: false });
+async function configWithNativeRoute(config, ctx) {
+    if (!config.auto)
+        return config;
+    const nativeEntry = await buildNativeEntry(ctx?.model, ctx?.modelRegistry);
+    return nativeEntry ? { ...config, providers: [nativeEntry, ...config.providers] } : config;
+}
+function providerLabel(provider) {
+    return provider.id ? `${provider.id}/${provider.provider}` : provider.provider;
+}
+function formatSearchProgressText(details) {
+    const route = details.providerLabels.length > 0 ? details.providerLabels.join(" -> ") : "configured providers";
+    return `Searching "${details.query}" via ${route} (max ${details.maxResults})`;
+}
+function searchErrorDetails(query, error, reason) {
+    return { phase: "error", query, error, ...(reason ? { reason } : {}) };
+}
+export function createWebSearchTool(getConfig) {
+    let routingState;
+    let routingKey = "";
+    return defineTool({
+        name: "web_search",
+        label: "Web Search",
+        description: "Search the web for current information and return source URLs for citation.",
+        promptSnippet: "Search the web for current information, documentation, news, or external facts.",
+        promptGuidelines: ["After using web_search, cite relevant returned URLs in the final answer."],
+        parameters: Params,
+        async execute(_toolCallId, params, signal, onUpdate, ctx) {
+            if (params.allowed_domains?.length && params.blocked_domains?.length) {
+                const message = "Error: Cannot specify both allowed_domains and blocked_domains in the same request";
+                const details = searchErrorDetails(params.query, message);
+                return { content: [{ type: "text", text: message }], details };
+            }
+            const loaded = getConfig();
+            if (!loaded.ok) {
+                const details = searchErrorDetails(params.query, loaded.message, loaded.reason);
+                return { content: [{ type: "text", text: loaded.message }], details };
+            }
+            const maxResults = loaded.config.providers[0]?.maxResults ?? 10;
+            const config = await configWithNativeRoute(loaded.config, ctx);
+            const progressDetails = {
+                phase: "searching",
+                query: params.query,
+                providerLabels: config.providers.map(providerLabel),
+                maxResults,
+                strategy: config.strategy,
+                ...(params.allowed_domains ? { allowedDomains: params.allowed_domains } : {}),
+                ...(params.blocked_domains ? { blockedDomains: params.blocked_domains } : {}),
+            };
+            onUpdate?.({
+                content: [{ type: "text", text: formatSearchProgressText(progressDetails) }],
+                details: progressDetails,
+            });
+            const nextRoutingKey = `${config.strategy}:${config.providers.map((provider) => provider.id ?? provider.provider).join("|")}`;
+            if (!routingState ||
+                routingKey !== nextRoutingKey ||
+                routingState.successCounts.length !== config.providers.length) {
+                routingState = createSearchRoutingState(config.providers.length);
+                routingKey = nextRoutingKey;
+            }
+            const request = {
+                query: params.query,
+                maxResults,
+                ...(params.allowed_domains === undefined ? {} : { allowedDomains: params.allowed_domains }),
+                ...(params.blocked_domains === undefined ? {} : { blockedDomains: params.blocked_domains }),
+            };
+            const details = await performSearch(config, request, signal, routingState);
+            return { content: [{ type: "text", text: formatSearchText(details) }], details };
+        },
+        renderCall: (args, theme) => renderSearchCall(args, theme),
+        renderResult: (result, options, theme) => renderSearchResult(result, options, theme),
+    });
+}
+export const web_search = createWebSearchTool(() => ({
+    ok: false,
+    reason: "missing_config",
+    message: "Missing websearch config. Create .pi/websearch.json or ~/.pi/websearch.json before starting pi.",
+}));
+//# sourceMappingURL=tool.js.map

package/dist/core/extensions/builtin/websearch/websearch/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/websearch/websearch/tool.ts"],"names":[],"mappings":"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","sourcesContent":["import { Type } from \"typebox\";\nimport { defineTool } from \"../../../types.ts\";\n\nimport { buildNativeEntry, type NativeModelInfo, type NativeModelRegistry } from \"./native.ts\";\nimport { renderSearchCall, renderSearchResult } from \"./renderers.ts\";\nimport { createSearchRoutingState, formatSearchText, performSearch, type SearchRoutingState } from \"./search.ts\";\nimport type {\n\tConfigLoadResult,\n\tSearchErrorDetails,\n\tSearchProgressDetails,\n\tSearchProviderEntry,\n\tSearchRenderDetails,\n\tWebsearchConfig,\n} from \"./types.ts\";\n\nconst Params = Type.Object(\n\t{\n\t\tquery: Type.String({ minLength: 2, description: \"The search query to use\" }),\n\t\tallowed_domains: Type.Optional(\n\t\t\tType.Array(Type.String(), { description: \"Only include search results from these domains\" }),\n\t\t),\n\t\tblocked_domains: Type.Optional(\n\t\t\tType.Array(Type.String(), { description: \"Never include search results from these domains\" }),\n\t\t),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport type ConfigProvider = () => ConfigLoadResult;\ntype WebSearchTool = ReturnType<typeof defineTool<typeof Params, SearchRenderDetails>>;\n\ninterface WebSearchToolContext {\n\tmodel: NativeModelInfo | undefined;\n\tmodelRegistry: NativeModelRegistry;\n}\n\nasync function configWithNativeRoute(config: WebsearchConfig, ctx?: WebSearchToolContext): Promise<WebsearchConfig> {\n\tif (!config.auto) return config;\n\tconst nativeEntry = await buildNativeEntry(ctx?.model, ctx?.modelRegistry);\n\treturn nativeEntry ? { ...config, providers: [nativeEntry, ...config.providers] } : config;\n}\n\nfunction providerLabel(provider: SearchProviderEntry): string {\n\treturn provider.id ? `${provider.id}/${provider.provider}` : provider.provider;\n}\n\nfunction formatSearchProgressText(details: SearchProgressDetails): string {\n\tconst route = details.providerLabels.length > 0 ? details.providerLabels.join(\" -> \") : \"configured providers\";\n\treturn `Searching \"${details.query}\" via ${route} (max ${details.maxResults})`;\n}\n\nfunction searchErrorDetails(query: string, error: string, reason?: SearchErrorDetails[\"reason\"]): SearchErrorDetails {\n\treturn { phase: \"error\", query, error, ...(reason ? { reason } : {}) };\n}\n\nexport function createWebSearchTool(getConfig: ConfigProvider): WebSearchTool {\n\tlet routingState: SearchRoutingState | undefined;\n\tlet routingKey = \"\";\n\n\treturn defineTool<typeof Params, SearchRenderDetails>({\n\t\tname: \"web_search\",\n\t\tlabel: \"Web Search\",\n\t\tdescription: \"Search the web for current information and return source URLs for citation.\",\n\t\tpromptSnippet: \"Search the web for current information, documentation, news, or external facts.\",\n\t\tpromptGuidelines: [\"After using web_search, cite relevant returned URLs in the final answer.\"],\n\t\tparameters: Params,\n\t\tasync execute(_toolCallId, params, signal, onUpdate, ctx?: WebSearchToolContext) {\n\t\t\tif (params.allowed_domains?.length && params.blocked_domains?.length) {\n\t\t\t\tconst message = \"Error: Cannot specify both allowed_domains and blocked_domains in the same request\";\n\t\t\t\tconst details = searchErrorDetails(params.query, message);\n\t\t\t\treturn { content: [{ type: \"text\", text: message }], details };\n\t\t\t}\n\n\t\t\tconst loaded = getConfig();\n\t\t\tif (!loaded.ok) {\n\t\t\t\tconst details = searchErrorDetails(params.query, loaded.message, loaded.reason);\n\t\t\t\treturn { content: [{ type: \"text\", text: loaded.message }], details };\n\t\t\t}\n\n\t\t\tconst maxResults = loaded.config.providers[0]?.maxResults ?? 10;\n\t\t\tconst config = await configWithNativeRoute(loaded.config, ctx);\n\t\t\tconst progressDetails: SearchProgressDetails = {\n\t\t\t\tphase: \"searching\",\n\t\t\t\tquery: params.query,\n\t\t\t\tproviderLabels: config.providers.map(providerLabel),\n\t\t\t\tmaxResults,\n\t\t\t\tstrategy: config.strategy,\n\t\t\t\t...(params.allowed_domains ? { allowedDomains: params.allowed_domains } : {}),\n\t\t\t\t...(params.blocked_domains ? { blockedDomains: params.blocked_domains } : {}),\n\t\t\t};\n\t\t\tonUpdate?.({\n\t\t\t\tcontent: [{ type: \"text\", text: formatSearchProgressText(progressDetails) }],\n\t\t\t\tdetails: progressDetails,\n\t\t\t});\n\n\t\t\tconst nextRoutingKey = `${config.strategy}:${config.providers.map((provider) => provider.id ?? provider.provider).join(\"|\")}`;\n\t\t\tif (\n\t\t\t\t!routingState ||\n\t\t\t\troutingKey !== nextRoutingKey ||\n\t\t\t\troutingState.successCounts.length !== config.providers.length\n\t\t\t) {\n\t\t\t\troutingState = createSearchRoutingState(config.providers.length);\n\t\t\t\troutingKey = nextRoutingKey;\n\t\t\t}\n\t\t\tconst request = {\n\t\t\t\tquery: params.query,\n\t\t\t\tmaxResults,\n\t\t\t\t...(params.allowed_domains === undefined ? {} : { allowedDomains: params.allowed_domains }),\n\t\t\t\t...(params.blocked_domains === undefined ? {} : { blockedDomains: params.blocked_domains }),\n\t\t\t};\n\t\t\tconst details = await performSearch(config, request, signal, routingState);\n\t\t\treturn { content: [{ type: \"text\", text: formatSearchText(details) }], details };\n\t\t},\n\t\trenderCall: (args, theme) => renderSearchCall(args, theme),\n\t\trenderResult: (result, options, theme) => renderSearchResult(result, options, theme),\n\t});\n}\n\nexport const web_search = createWebSearchTool(() => ({\n\tok: false,\n\treason: \"missing_config\",\n\tmessage: \"Missing websearch config. Create .pi/websearch.json or ~/.pi/websearch.json before starting pi.\",\n}));\n"]}

package/dist/core/extensions/builtin/websearch/websearch/types.d.ts

@@ -0,0 +1,115 @@
+export type SearchProvider = "exa" | "tavily" | "brave" | "duckduckgo-html" | "serper" | "google-cse" | "z-ai" | "openai" | "codex" | "anthropic" | "perplexity" | "xai" | "kimi";
+export type SearchContextSize = "low" | "medium" | "high";
+export type CodexSearchMode = "cached" | "live";
+export type RoutingStrategy = "priority" | "round-robin" | "fill-first";
+export interface SearchProviderConfig {
+    id?: string;
+    provider: SearchProvider;
+    apiKey?: string;
+    baseUrl?: string;
+    searchEngineId?: string;
+    maxResults?: number;
+    model?: string;
+    codexMode?: CodexSearchMode;
+    searchContextSize?: SearchContextSize;
+    allowedDomains?: string[];
+    blockedDomains?: string[];
+    userLocation?: SearchUserLocation;
+}
+export interface SearchProviderEntry extends SearchProviderConfig {
+    priority?: number;
+    weight?: number;
+}
+export interface WebsearchConfig {
+    strategy: RoutingStrategy;
+    fallback: boolean;
+    auto: boolean;
+    providers: SearchProviderEntry[];
+}
+export interface SearchUserLocation {
+    country?: string;
+    region?: string;
+    city?: string;
+    timezone?: string;
+}
+export interface SearchRequest {
+    query: string;
+    maxResults: number;
+    allowedDomains?: string[];
+    blockedDomains?: string[];
+}
+export interface BuiltSearchRequest {
+    url: string;
+    init: {
+        method: "GET" | "POST";
+        headers: Record<string, string>;
+    };
+    body?: JsonObject;
+}
+export interface SearchResultItem {
+    title: string;
+    url: string;
+    snippet?: string;
+    score?: number;
+    source?: string;
+    publishedAt?: string;
+}
+export interface SearchDetails {
+    provider: SearchProvider;
+    entryId?: string;
+    query: string;
+    results: SearchResultItem[];
+    durationMs: number;
+    truncated: boolean;
+    strategy?: RoutingStrategy;
+    attempts?: SearchAttempt[];
+    answer?: string;
+    error?: string;
+}
+export interface SearchProgressDetails {
+    phase: "searching";
+    query: string;
+    providerLabels: string[];
+    maxResults: number;
+    strategy?: RoutingStrategy;
+    allowedDomains?: string[];
+    blockedDomains?: string[];
+}
+export type ConfigLoadFailureReason = "missing_config" | "invalid_config" | "missing_api_key" | "provider_native_bypass";
+export interface SearchErrorDetails {
+    phase: "error";
+    query: string;
+    error: string;
+    reason?: ConfigLoadFailureReason;
+}
+export type SearchRenderDetails = SearchDetails | SearchProgressDetails | SearchErrorDetails;
+export interface SearchAttempt {
+    provider: SearchProvider;
+    entryId?: string;
+    durationMs: number;
+    resultsCount: number;
+    error?: string;
+}
+export type JsonValue = string | number | boolean | null | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type ConfigLoadResult = {
+    ok: true;
+    config: WebsearchConfig;
+    source: string;
+} | {
+    ok: false;
+    reason: ConfigLoadFailureReason;
+    message: string;
+    source?: string;
+};
+export type ProviderValidationResult = {
+    ok: true;
+    config: SearchProviderEntry;
+} | {
+    ok: false;
+    reason: "invalid_config" | "missing_api_key";
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/extensions/builtin/websearch/websearch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/websearch/websearch/types.ts"],"names":[],"mappings":"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"}

package/dist/core/extensions/builtin/websearch/websearch/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/extensions/builtin/websearch/websearch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/core/extensions/builtin/websearch/websearch/types.ts"],"names":[],"mappings":"","sourcesContent":["export type SearchProvider =\n\t| \"exa\"\n\t| \"tavily\"\n\t| \"brave\"\n\t| \"duckduckgo-html\"\n\t| \"serper\"\n\t| \"google-cse\"\n\t| \"z-ai\"\n\t| \"openai\"\n\t| \"codex\"\n\t| \"anthropic\"\n\t| \"perplexity\"\n\t| \"xai\"\n\t| \"kimi\";\n\nexport type SearchContextSize = \"low\" | \"medium\" | \"high\";\nexport type CodexSearchMode = \"cached\" | \"live\";\nexport type RoutingStrategy = \"priority\" | \"round-robin\" | \"fill-first\";\n\nexport interface SearchProviderConfig {\n\tid?: string;\n\tprovider: SearchProvider;\n\tapiKey?: string;\n\tbaseUrl?: string;\n\tsearchEngineId?: string;\n\tmaxResults?: number;\n\tmodel?: string;\n\tcodexMode?: CodexSearchMode;\n\tsearchContextSize?: SearchContextSize;\n\tallowedDomains?: string[];\n\tblockedDomains?: string[];\n\tuserLocation?: SearchUserLocation;\n}\n\nexport interface SearchProviderEntry extends SearchProviderConfig {\n\tpriority?: number;\n\tweight?: number;\n}\n\nexport interface WebsearchConfig {\n\tstrategy: RoutingStrategy;\n\tfallback: boolean;\n\tauto: boolean;\n\tproviders: SearchProviderEntry[];\n}\n\nexport interface SearchUserLocation {\n\tcountry?: string;\n\tregion?: string;\n\tcity?: string;\n\ttimezone?: string;\n}\n\nexport interface SearchRequest {\n\tquery: string;\n\tmaxResults: number;\n\tallowedDomains?: string[];\n\tblockedDomains?: string[];\n}\n\nexport interface BuiltSearchRequest {\n\turl: string;\n\tinit: {\n\t\tmethod: \"GET\" | \"POST\";\n\t\theaders: Record<string, string>;\n\t};\n\tbody?: JsonObject;\n}\n\nexport interface SearchResultItem {\n\ttitle: string;\n\turl: string;\n\tsnippet?: string;\n\tscore?: number;\n\tsource?: string;\n\tpublishedAt?: string;\n}\n\nexport interface SearchDetails {\n\tprovider: SearchProvider;\n\tentryId?: string;\n\tquery: string;\n\tresults: SearchResultItem[];\n\tdurationMs: number;\n\ttruncated: boolean;\n\tstrategy?: RoutingStrategy;\n\tattempts?: SearchAttempt[];\n\tanswer?: string;\n\terror?: string;\n}\n\nexport interface SearchProgressDetails {\n\tphase: \"searching\";\n\tquery: string;\n\tproviderLabels: string[];\n\tmaxResults: number;\n\tstrategy?: RoutingStrategy;\n\tallowedDomains?: string[];\n\tblockedDomains?: string[];\n}\n\nexport type ConfigLoadFailureReason =\n\t| \"missing_config\"\n\t| \"invalid_config\"\n\t| \"missing_api_key\"\n\t| \"provider_native_bypass\";\n\nexport interface SearchErrorDetails {\n\tphase: \"error\";\n\tquery: string;\n\terror: string;\n\treason?: ConfigLoadFailureReason;\n}\n\nexport type SearchRenderDetails = SearchDetails | SearchProgressDetails | SearchErrorDetails;\n\nexport interface SearchAttempt {\n\tprovider: SearchProvider;\n\tentryId?: string;\n\tdurationMs: number;\n\tresultsCount: number;\n\terror?: string;\n}\n\nexport type JsonValue = string | number | boolean | null | JsonObject | JsonValue[];\n\nexport interface JsonObject {\n\t[key: string]: JsonValue;\n}\n\nexport type ConfigLoadResult =\n\t| { ok: true; config: WebsearchConfig; source: string }\n\t| {\n\t\t\tok: false;\n\t\t\treason: ConfigLoadFailureReason;\n\t\t\tmessage: string;\n\t\t\tsource?: string;\n\t  };\n\nexport type ProviderValidationResult =\n\t| { ok: true; config: SearchProviderEntry }\n\t| { ok: false; reason: \"invalid_config\" | \"missing_api_key\"; message: string };\n"]}