@tianshu-ai/tianshu 0.4.19 → 0.4.21

package/plugins/web-search/dist/tools/providers.js

@@ -125,6 +125,285 @@ export const braveProvider = {
         }
     },
 };
+// ─── hosted MCP provider (Parallel / Exa free endpoints) ───────
+//
+// Key-free web search. Both Parallel and Exa expose a hosted MCP
+// endpoint that answers anonymous JSON-RPC `tools/call` requests
+// (a free tier). If the operator supplies an EXA/PARALLEL key we
+// attach it, but the whole point of this provider is that it
+// works with none. Same approach OpenCode uses.
+//
+// `key` here is NOT an API key — it's a JSON blob the tool packs
+// with the chosen backend + optional key:  {"backend":"exa"|
+// "parallel", "apiKey":"..."}. The tool builds it; callers never
+// see it.
+export const PARALLEL_MCP_URL = "https://search.parallel.ai/mcp";
+export const EXA_MCP_URL = "https://mcp.exa.ai/mcp";
+function parseHostedKey(key) {
+    try {
+        const j = JSON.parse(key);
+        return {
+            backend: j.backend === "parallel" ? "parallel" : "exa",
+            apiKey: typeof j.apiKey === "string" && j.apiKey ? j.apiKey : undefined,
+        };
+    }
+    catch {
+        return { backend: "exa" };
+    }
+}
+export const hostedProvider = {
+    name: "hosted",
+    async search(query, key, opts) {
+        const { backend, apiKey } = parseHostedKey(key);
+        const url = backend === "parallel"
+            ? PARALLEL_MCP_URL
+            : apiKey
+                ? `${EXA_MCP_URL}?exaApiKey=${encodeURIComponent(apiKey)}`
+                : EXA_MCP_URL;
+        // MCP tool + args differ per backend.
+        const toolName = backend === "parallel" ? "web_search" : "web_search_exa";
+        const toolArgs = backend === "parallel"
+            ? {
+                objective: query,
+                search_queries: [query],
+            }
+            : {
+                query,
+                numResults: clamp(opts.count, 1, 20),
+                type: "auto",
+            };
+        const headers = {
+            "content-type": "application/json",
+            accept: "application/json, text/event-stream",
+            "user-agent": "tianshu-web-search/0.2",
+        };
+        if (backend === "parallel" && apiKey) {
+            headers.authorization = `Bearer ${apiKey}`;
+        }
+        const rpc = {
+            jsonrpc: "2.0",
+            id: 1,
+            method: "tools/call",
+            params: { name: toolName, arguments: toolArgs },
+        };
+        try {
+            const ctl = new AbortController();
+            const timer = setTimeout(() => ctl.abort(), opts.timeoutMs);
+            const res = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(rpc),
+                signal: ctl.signal,
+            }).finally(() => clearTimeout(timer));
+            if (!res.ok) {
+                return {
+                    error: {
+                        provider: "hosted",
+                        status: res.status,
+                        message: `${backend}: ${await safeText(res)}`,
+                    },
+                };
+            }
+            const raw = await res.text();
+            const text = extractMcpText(raw);
+            if (text === null) {
+                return {
+                    error: {
+                        provider: "hosted",
+                        status: 0,
+                        message: `${backend}: could not parse MCP response`,
+                    },
+                };
+            }
+            // Exa returns a plain-text block (Title:/URL:/Published:/
+            // Highlights:, results split by `---`). Parallel returns
+            // JSON (array or {results:[...]}). Parse per backend, with a
+            // cross-fallback so a format change on either side degrades
+            // gracefully instead of returning nothing.
+            const results = (backend === "exa" ? parseExaText(text) : parseHostedResults(text));
+            const final = (results.length > 0
+                ? results
+                : backend === "exa"
+                    ? parseHostedResults(text)
+                    : parseExaText(text)).slice(0, clamp(opts.count, 1, 20));
+            return { results: final };
+        }
+        catch (err) {
+            return {
+                error: {
+                    provider: "hosted",
+                    status: 0,
+                    message: `${backend}: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            };
+        }
+    },
+};
+/** MCP endpoints answer either as plain JSON or as an SSE stream
+ *  (`data: {...}` lines). Pull the inner `result.content[].text`
+ *  payload out of whichever we got. Returns null if nothing
+ *  usable is found. */
+function extractMcpText(body) {
+    const tryOne = (s) => {
+        try {
+            const j = JSON.parse(s);
+            const item = j.result?.content?.find((c) => typeof c.text === "string");
+            return item?.text ?? null;
+        }
+        catch {
+            return null;
+        }
+    };
+    const trimmed = body.trim();
+    const direct = trimmed ? tryOne(trimmed) : null;
+    if (direct !== null)
+        return direct;
+    // SSE: scan `data:` lines.
+    for (const line of trimmed.split(/\r?\n/)) {
+        if (line.startsWith("data:")) {
+            const got = tryOne(line.slice(5).trim());
+            if (got !== null)
+                return got;
+        }
+    }
+    return null;
+}
+/** The MCP `text` payload is itself JSON (or JSON-ish) describing
+ *  results. Both Exa and Parallel return an array of
+ *  `{title,url,text/snippet,publishedDate}`-ish objects, sometimes
+ *  wrapped in `{ results: [...] }`. Be liberal. */
+function parseHostedResults(text) {
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        // Non-JSON payload: hand it back as a single synthetic result
+        // so the agent at least sees the content.
+        const t = text.trim();
+        return t ? [{ title: "result", url: "", content: t.slice(0, 2000) }] : [];
+    }
+    const arr = Array.isArray(data)
+        ? data
+        : Array.isArray(data?.results)
+            ? data.results
+            : [];
+    return arr.map((raw) => {
+        const r = (raw ?? {});
+        const str = (...keys) => {
+            for (const k of keys) {
+                if (typeof r[k] === "string" && r[k])
+                    return r[k];
+            }
+            return "";
+        };
+        return {
+            title: str("title", "name"),
+            url: str("url", "link"),
+            content: str("text", "snippet", "content", "summary").slice(0, 1000),
+            publishedDate: str("publishedDate", "published_date", "date") || null,
+        };
+    });
+}
+/** Parse Exa's plain-text MCP payload into results. Each block is
+ *  separated by a line containing only `---`, and carries
+ *  `Title:`, `URL:`, `Published:`, and `Highlights:` labels. */
+function parseExaText(text) {
+    const blocks = text
+        .split(/\n\s*---\s*\n/)
+        .map((b) => b.trim())
+        .filter(Boolean);
+    const out = [];
+    for (const block of blocks) {
+        const title = block.match(/^\s*Title:\s*(.+)$/im)?.[1]?.trim() ?? "";
+        const url = block.match(/^\s*URL:\s*(\S+)/im)?.[1]?.trim() ?? "";
+        const published = block.match(/^\s*Published:\s*(.+)$/im)?.[1]?.trim();
+        // Highlights are everything after the `Highlights:` label.
+        const hi = block.split(/^\s*Highlights:\s*$/im)[1] ?? "";
+        const content = hi
+            .replace(/\n\.\.\.\n/g, " ")
+            .replace(/\s+/g, " ")
+            .trim()
+            .slice(0, 1000);
+        if (!title && !url)
+            continue;
+        out.push({
+            title: title || url,
+            url,
+            content,
+            publishedDate: published && published !== "N/A" ? published : null,
+        });
+    }
+    return out;
+}
+// ─── SearXNG provider (self-hosted meta-search) ────────────────
+//
+// `key` is the operator's SearXNG base URL (e.g.
+// "http://localhost:8080" or "https://searx.example.com"). We hit
+// its JSON API (`/search?format=json`). No API key; the endpoint
+// is the credential.
+export const searxngProvider = {
+    name: "searxng",
+    async search(query, key, opts) {
+        const base = key.replace(/\/+$/, "");
+        if (!base) {
+            return {
+                error: {
+                    provider: "searxng",
+                    status: 0,
+                    message: "no SearXNG base URL configured",
+                },
+            };
+        }
+        const params = new URLSearchParams({
+            q: query,
+            format: "json",
+            safesearch: "0",
+        });
+        if (opts.language)
+            params.set("language", opts.language.slice(0, 5));
+        if (opts.freshness) {
+            // SearXNG time_range accepts day/week/month/year directly.
+            params.set("time_range", opts.freshness);
+        }
+        try {
+            const ctl = new AbortController();
+            const timer = setTimeout(() => ctl.abort(), opts.timeoutMs);
+            const res = await fetch(`${base}/search?${params.toString()}`, {
+                headers: { accept: "application/json" },
+                signal: ctl.signal,
+            }).finally(() => clearTimeout(timer));
+            if (!res.ok) {
+                return {
+                    error: {
+                        provider: "searxng",
+                        status: res.status,
+                        message: await safeText(res),
+                    },
+                };
+            }
+            const json = (await res.json());
+            const results = (json.results ?? [])
+                .slice(0, clamp(opts.count, 1, 20))
+                .map((r) => ({
+                title: typeof r.title === "string" ? r.title : "",
+                url: typeof r.url === "string" ? r.url : "",
+                content: typeof r.content === "string" ? r.content : "",
+                publishedDate: r.publishedDate ?? null,
+            }));
+            return { results };
+        }
+        catch (err) {
+            return {
+                error: {
+                    provider: "searxng",
+                    status: 0,
+                    message: err instanceof Error ? err.message : String(err),
+                },
+            };
+        }
+    },
+};
 function clamp(n, lo, hi) {
     return Math.max(lo, Math.min(hi, Math.floor(n)));
 }

package/plugins/web-search/dist/tools/providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/tools/providers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/tools/providers.ts"],"names":[],"mappings":"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"}

package/plugins/web-search/dist/tools/web-fetch.d.ts

@@ -0,0 +1,9 @@
+import type { AgentTool } from "@tianshu-ai/plugin-sdk";
+export interface WebFetchConfig {
+    /** Per-request timeout (ms). Falls back to 8000. */
+    timeoutMs?: number;
+    /** Hard cap on returned characters. Falls back to 20000. */
+    maxCharsDefault?: number;
+}
+export declare function buildWebFetchTool(cfg: WebFetchConfig): AgentTool;
+//# sourceMappingURL=web-fetch.d.ts.map

package/plugins/web-search/dist/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS,CAiIhE"}

package/plugins/web-search/dist/tools/web-fetch.js

@@ -0,0 +1,258 @@
+// `web_fetch(url, extractMode?, maxChars?)`.
+//
+// A plain HTTP GET that extracts readable content and returns it
+// as markdown or text. No JavaScript execution, no API key, no
+// external service — this is the "grab a single page" capability
+// that pairs with web_search. For JS-heavy or login-gated pages
+// the agent should use the browser tool instead.
+//
+// Dependency-free on purpose: the plugin ships without turndown /
+// readability so it stays a tiny self-contained builtin. The
+// extractor below is a pragmatic tag-stripper, not a full DOM
+// parser — good enough for article bodies, docs, and JSON/text
+// endpoints.
+//
+// SSRF: we block private / loopback / link-local / metadata hosts
+// before fetching AND re-check after redirects, so an agent can't
+// be steered into probing the internal network.
+import { Type } from "typebox";
+export function buildWebFetchTool(cfg) {
+    const timeoutMs = cfg.timeoutMs ?? 8000;
+    const maxCharsDefault = cfg.maxCharsDefault ?? 20000;
+    return {
+        schema: {
+            name: "web_fetch",
+            description: "Fetch a single URL over HTTP(S) and return its readable " +
+                "content as markdown or text. No JavaScript is executed, so " +
+                "for JS-heavy or login-gated pages use the browser tool " +
+                "instead. Blocks private/internal hosts. Use this to read a " +
+                "specific page you already have the URL for (e.g. a search " +
+                "result). Returns extracted body text, not raw HTML.",
+            parameters: Type.Object({
+                url: Type.String({
+                    description: "The http(s) URL to fetch.",
+                }),
+                extractMode: Type.Optional(Type.Union([Type.Literal("markdown"), Type.Literal("text")], {
+                    description: "Output format after content extraction. Default \"markdown\".",
+                })),
+                maxChars: Type.Optional(Type.Number({
+                    description: "Truncate output to this many characters. Default 20000.",
+                    minimum: 100,
+                    maximum: 200000,
+                })),
+            }),
+        },
+        async execute(rawArgs, _ctx) {
+            const args = rawArgs;
+            const url = typeof args.url === "string" ? args.url.trim() : "";
+            if (!url)
+                return { ok: false, text: "url is required" };
+            if (!/^https?:\/\//i.test(url)) {
+                return { ok: false, text: "url must start with http:// or https://" };
+            }
+            const guard = await blockedHost(url);
+            if (guard) {
+                return { ok: false, text: `blocked: ${guard}` };
+            }
+            const cap = typeof args.maxChars === "number" ? args.maxChars : maxCharsDefault;
+            const mode = args.extractMode === "text" ? "text" : "markdown";
+            try {
+                const ctl = new AbortController();
+                const timer = setTimeout(() => ctl.abort(), timeoutMs);
+                const res = await fetch(url, {
+                    redirect: "manual",
+                    headers: {
+                        // Chrome-like UA + language so sites don't serve a
+                        // bot-blocked or empty variant.
+                        "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) " +
+                            "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36",
+                        "accept-language": "en,zh-CN;q=0.8",
+                        accept: "text/html,application/xhtml+xml,application/json;q=0.9,*/*;q=0.8",
+                    },
+                    signal: ctl.signal,
+                }).finally(() => clearTimeout(timer));
+                // Follow one redirect manually so we can re-run the SSRF
+                // guard on the target (auto-follow would skip the check).
+                if (res.status >= 300 && res.status < 400) {
+                    const loc = res.headers.get("location");
+                    if (!loc) {
+                        return { ok: false, text: `redirect with no Location (${res.status})` };
+                    }
+                    const next = new URL(loc, url).toString();
+                    const g2 = await blockedHost(next);
+                    if (g2)
+                        return { ok: false, text: `blocked after redirect: ${g2}` };
+                    return await this.execute({ url: next, extractMode: mode, maxChars: cap }, _ctx);
+                }
+                if (!res.ok) {
+                    return {
+                        ok: false,
+                        text: `HTTP ${res.status} fetching ${url}`,
+                    };
+                }
+                const ctype = res.headers.get("content-type") ?? "";
+                const body = await res.text();
+                let out;
+                if (ctype.includes("application/json")) {
+                    out = body;
+                }
+                else if (ctype.includes("text/html") || /<html[\s>]/i.test(body)) {
+                    out = mode === "text" ? htmlToText(body) : htmlToMarkdown(body);
+                }
+                else {
+                    // Plain text, markdown, csv, etc. — return as-is.
+                    out = body;
+                }
+                const truncated = out.length > cap;
+                const text = truncated ? out.slice(0, cap) : out;
+                return {
+                    ok: true,
+                    text,
+                    data: {
+                        url,
+                        contentType: ctype,
+                        chars: text.length,
+                        truncated,
+                    },
+                };
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    text: `fetch failed: ${err instanceof Error ? err.message : String(err)}`,
+                };
+            }
+        },
+    };
+}
+// ─── SSRF guard ────────────────────────────────────────────────
+/** Returns a reason string when the URL's host is disallowed, or
+ *  null when it's safe to fetch. Blocks loopback, private, CGN,
+ *  link-local, ULA, and cloud metadata addresses by literal match;
+ *  we don't resolve DNS here (the host's guarded fetch layer does
+ *  deeper checks), this is a cheap first line of defence. */
+async function blockedHost(rawUrl) {
+    let host;
+    try {
+        host = new URL(rawUrl).hostname.toLowerCase();
+    }
+    catch {
+        return "invalid URL";
+    }
+    if (host === "localhost" || host.endsWith(".localhost")) {
+        return "localhost is not allowed";
+    }
+    // IPv6 literal in brackets is stripped by URL().hostname already.
+    if (host === "::1" || host === "0.0.0.0")
+        return "loopback is not allowed";
+    // Cloud metadata.
+    if (host === "169.254.169.254" || host === "metadata.google.internal") {
+        return "metadata endpoint is not allowed";
+    }
+    // IPv4 literal → range check.
+    const m = host.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+    if (m) {
+        const [a, b] = [Number(m[1]), Number(m[2])];
+        if (a === 127)
+            return "loopback range is not allowed";
+        if (a === 10)
+            return "private range 10/8 is not allowed";
+        if (a === 172 && b >= 16 && b <= 31)
+            return "private range 172.16/12 is not allowed";
+        if (a === 192 && b === 168)
+            return "private range 192.168/16 is not allowed";
+        if (a === 169 && b === 254)
+            return "link-local range is not allowed";
+        if (a === 100 && b >= 64 && b <= 127)
+            return "carrier-grade NAT range is not allowed";
+        if (a === 0)
+            return "reserved range is not allowed";
+    }
+    // IPv6 private / link-local literals.
+    if (host.startsWith("fe80:") || host.startsWith("fc") || host.startsWith("fd")) {
+        return "IPv6 private/link-local range is not allowed";
+    }
+    return null;
+}
+// ─── HTML extraction (dependency-free) ─────────────────────────
+/** Strip an HTML document down to its main textual content and
+ *  convert the structural tags we care about to markdown. This is
+ *  deliberately simple: remove noise elements, unwrap the rest,
+ *  map headings/links/lists/code to markdown, collapse whitespace. */
+function htmlToMarkdown(html) {
+    let s = stripNoise(html);
+    // Headings.
+    s = s.replace(/<h([1-6])[^>]*>([\s\S]*?)<\/h\1>/gi, (_m, lvl, inner) => {
+        const hashes = "#".repeat(Number(lvl));
+        return `\n\n${hashes} ${collapse(stripTags(inner))}\n\n`;
+    });
+    // Links → [text](href).
+    s = s.replace(/<a\b[^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi, (_m, href, inner) => {
+        const text = collapse(stripTags(inner));
+        return text ? `[${text}](${href})` : href;
+    });
+    // Bold / strong, italic / em.
+    s = s.replace(/<(strong|b)\b[^>]*>([\s\S]*?)<\/\1>/gi, (_m, _t, i) => `**${collapse(stripTags(i))}**`);
+    s = s.replace(/<(em|i)\b[^>]*>([\s\S]*?)<\/\1>/gi, (_m, _t, i) => `*${collapse(stripTags(i))}*`);
+    // Inline code + code blocks.
+    s = s.replace(/<pre\b[^>]*>([\s\S]*?)<\/pre>/gi, (_m, inner) => `\n\n\`\`\`\n${decode(stripTags(inner))}\n\`\`\`\n\n`);
+    s = s.replace(/<code\b[^>]*>([\s\S]*?)<\/code>/gi, (_m, inner) => `\`${collapse(stripTags(inner))}\``);
+    // List items.
+    s = s.replace(/<li\b[^>]*>([\s\S]*?)<\/li>/gi, (_m, inner) => `\n- ${collapse(stripTags(inner))}`);
+    // Paragraphs / breaks / block boundaries.
+    s = s.replace(/<\/(p|div|section|article|ul|ol|table|tr|h[1-6])>/gi, "\n\n");
+    s = s.replace(/<br\s*\/?>(\s*)/gi, "\n");
+    // Everything else: drop tags, decode entities, tidy whitespace.
+    s = stripTags(s);
+    s = decode(s);
+    return tidy(s);
+}
+function htmlToText(html) {
+    const s = decode(stripTags(stripNoise(html)));
+    return tidy(s);
+}
+/** Remove script/style/nav/header/footer/svg/noscript blocks and
+ *  HTML comments outright — they're noise for text extraction. */
+function stripNoise(html) {
+    return html
+        .replace(/<!--[\s\S]*?-->/g, "")
+        .replace(/<(script|style|noscript|svg|template)\b[^>]*>[\s\S]*?<\/\1>/gi, "")
+        .replace(/<(nav|header|footer|aside)\b[^>]*>[\s\S]*?<\/\1>/gi, "");
+}
+function stripTags(s) {
+    return s.replace(/<[^>]+>/g, "");
+}
+/** Decode the handful of HTML entities that actually show up in
+ *  body text. Numeric entities handled generically. */
+function decode(s) {
+    return s
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;|&apos;/g, "'")
+        .replace(/&#(\d+);/g, (_m, n) => {
+        const code = Number(n);
+        return Number.isFinite(code) ? String.fromCodePoint(code) : _m;
+    })
+        .replace(/&#x([0-9a-f]+);/gi, (_m, h) => {
+        const code = parseInt(h, 16);
+        return Number.isFinite(code) ? String.fromCodePoint(code) : _m;
+    });
+}
+/** Collapse internal whitespace in an inline fragment. */
+function collapse(s) {
+    return s.replace(/\s+/g, " ").trim();
+}
+/** Final document tidy: trim lines, collapse >2 blank lines. */
+function tidy(s) {
+    return s
+        .split(/\r?\n/)
+        .map((l) => l.replace(/[ \t]+$/g, "").replace(/^[ \t]+/g, (m) => m))
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .replace(/[ \t]{2,}/g, " ")
+        .trim();
+}
+//# sourceMappingURL=web-fetch.js.map

package/plugins/web-search/dist/tools/web-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.js","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"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"}

package/plugins/web-search/dist/tools/web-search.d.ts

@@ -1,9 +1,22 @@
 import type { AgentTool } from "@tianshu-ai/plugin-sdk";
 import { ProviderHealth } from "./health.js";
+/** Which search scheme the operator picked. The plugin supports
+ *  two key-free schemes (hosted MCP + self-hosted SearXNG) and two
+ *  key-based ones (Tavily + Brave) kept from the original plugin. */
+export type SearchScheme = "hosted" | "searxng" | "tavily" | "brave";
 export interface WebSearchPluginConfig {
+    /** Operator's chosen scheme. Defaults to "hosted" (key-free). */
+    scheme?: SearchScheme;
+    /** Backend for the hosted MCP scheme. */
+    hostedBackend?: "exa" | "parallel";
+    /** Optional key for the hosted backend (higher limits; not
+     *  required — the free tier works anonymously). */
+    exaApiKey?: string;
+    parallelApiKey?: string;
+    /** Base URL of a self-hosted SearXNG instance. */
+    searxngBaseUrl?: string;
     tavilyApiKey?: string;
     braveApiKey?: string;
-    preferredProvider?: "tavily" | "brave";
     /** Optional default timeout override (ms). 8000 if unset. */
     timeoutMs?: number;
 }
@@ -12,4 +25,10 @@ export declare function buildWebSearchTool(cfg: WebSearchPluginConfig, health: P
  *  shape this plugin actually uses. Plugin's `activate()` calls
  *  this once at startup. */
 export declare function readWebSearchConfig(raw: unknown): WebSearchPluginConfig;
+/** Resolve the effective scheme. Explicit `scheme` wins; otherwise
+ *  infer from what's configured, preferring the key-free hosted
+ *  scheme so a fresh install works out of the box. */
+export declare function effectiveScheme(cfg: WebSearchPluginConfig): SearchScheme;
+/** True when the effective scheme has everything it needs to run. */
+export declare function isConfigured(cfg: WebSearchPluginConfig): boolean;
 //# sourceMappingURL=web-search.d.ts.map

package/plugins/web-search/dist/tools/web-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAQ1E,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,qBAAqB,EAC1B,MAAM,EAAE,cAAc,GACrB,SAAS,CA0KX;AAED;;4BAE4B;AAC5B,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,CAqBvE"}
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAW1E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;qEAEqE;AACrE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;IACnC;uDACmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,qBAAqB,EAC1B,MAAM,EAAE,cAAc,GACrB,SAAS,CAqLX;AAED;;4BAE4B;AAC5B,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,CA4BvE;AAED;;sDAEsD;AACtD,wBAAgB,eAAe,CAAC,GAAG,EAAE,qBAAqB,GAAG,YAAY,CAMxE;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAWhE"}