@tianshu-ai/tianshu 0.3.0

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

@@ -0,0 +1,31 @@
+export type ProviderName = "tavily" | "brave";
+export interface DeadProviderEntry {
+    /** HTTP status that flagged it dead. 401 / 403 are the only
+     *  values that get persisted today. */
+    status: number;
+    /** Truncated provider message; surfaced in the next call's
+     *  error text so the operator knows why it's parked. */
+    message: string;
+    /** ms timestamp when we marked it dead. Used by the admin UI to
+     *  show "dead since 5m ago". */
+    deadSince: number;
+}
+export declare class ProviderHealth {
+    private dead;
+    isDead(name: ProviderName): DeadProviderEntry | null;
+    markDead(name: ProviderName, status: number, message: string): void;
+    /** Clear ALL provider entries. Used by the admin "Reset cache"
+     *  button. */
+    reset(): void;
+    /** Clear one provider — useful after the operator updates a
+     *  specific key. We don't auto-detect config changes per-key
+     *  (the plugin re-activates on any config write, which builds a
+     *  fresh ProviderHealth instance), but the primitive is here
+     *  for a future per-field clear button. */
+    resetOne(name: ProviderName): void;
+    /** Snapshot for the admin endpoint. */
+    snapshot(): Array<{
+        provider: ProviderName;
+    } & DeadProviderEntry>;
+}
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC;2CACuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf;4DACwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB;oCACgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAA8C;IAE1D,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,GAAG,IAAI;IAIpD,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQnE;kBACc;IACd,KAAK,IAAI,IAAI;IAIb;;;;+CAI2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIlC,uCAAuC;IACvC,QAAQ,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,GAAG,iBAAiB,CAAC;CAMlE"}

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

@@ -0,0 +1,59 @@
+// Provider health cache.
+//
+// Why we need it: a worker that triggers `web_search` ten times in
+// a row shouldn't pay the latency of trying Tavily first every
+// time when Tavily's key has been wrong since the operator last
+// saved config. The cache is in-memory, scoped per
+// (tenantId, pluginId), and gets cleared automatically when the
+// plugin re-activates (config change) or when the operator clicks
+// the "Reset cache" button in the admin panel.
+//
+// Two failure shapes get treated differently:
+//
+//   - Auth (401 / 403)         → mark dead permanently (until
+//                                 manual reset). The key is wrong;
+//                                 retrying every search is just
+//                                 spam.
+//   - Server / network / 429   → NOT cached. These are usually
+//                                 transient; we want the next call
+//                                 to retry as if nothing happened.
+//                                 Logging stays in the per-call
+//                                 errors array so the operator can
+//                                 see the trail if they look.
+//
+// "Empty results" is not a health concern — a working API can
+// legitimately return zero hits for an obscure query.
+export class ProviderHealth {
+    dead = new Map();
+    isDead(name) {
+        return this.dead.get(name) ?? null;
+    }
+    markDead(name, status, message) {
+        this.dead.set(name, {
+            status,
+            message: message.slice(0, 200),
+            deadSince: Date.now(),
+        });
+    }
+    /** Clear ALL provider entries. Used by the admin "Reset cache"
+     *  button. */
+    reset() {
+        this.dead.clear();
+    }
+    /** Clear one provider — useful after the operator updates a
+     *  specific key. We don't auto-detect config changes per-key
+     *  (the plugin re-activates on any config write, which builds a
+     *  fresh ProviderHealth instance), but the primitive is here
+     *  for a future per-field clear button. */
+    resetOne(name) {
+        this.dead.delete(name);
+    }
+    /** Snapshot for the admin endpoint. */
+    snapshot() {
+        return [...this.dead.entries()].map(([provider, e]) => ({
+            provider,
+            ...e,
+        }));
+    }
+}
+//# sourceMappingURL=health.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,EAAE;AACF,mEAAmE;AACnE,+DAA+D;AAC/D,gEAAgE;AAChE,mDAAmD;AACnD,gEAAgE;AAChE,kEAAkE;AAClE,+CAA+C;AAC/C,EAAE;AACF,8CAA8C;AAC9C,EAAE;AACF,8DAA8D;AAC9D,mEAAmE;AACnE,gEAAgE;AAChE,wCAAwC;AACxC,+DAA+D;AAC/D,mEAAmE;AACnE,mEAAmE;AACnE,gEAAgE;AAChE,mEAAmE;AACnE,8DAA8D;AAC9D,EAAE;AACF,8DAA8D;AAC9D,sDAAsD;AAgBtD,MAAM,OAAO,cAAc;IACjB,IAAI,GAAG,IAAI,GAAG,EAAmC,CAAC;IAE1D,MAAM,CAAC,IAAkB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,QAAQ,CAAC,IAAkB,EAAE,MAAc,EAAE,OAAe;QAC1D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YAClB,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED;kBACc;IACd,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED;;;;+CAI2C;IAC3C,QAAQ,CAAC,IAAkB;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,uCAAuC;IACvC,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,QAAQ;YACR,GAAG,CAAC;SACL,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

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

@@ -0,0 +1,3 @@
+export { buildWebSearchTool, readWebSearchConfig, type WebSearchPluginConfig, } from "./web-search.js";
+export { type SearchResult, type SearchOpts, type SearchProvider, } from "./providers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,2 @@
+export { buildWebSearchTool, readWebSearchConfig, } from "./web-search.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAEpB,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,43 @@
+export interface SearchResult {
+    title: string;
+    url: string;
+    /** 1-3 sentence snippet. Empty when the provider didn't supply
+     *  one (Tavily always supplies, Brave usually does). */
+    content: string;
+    /** ISO-8601 string from the provider, when available. Useful for
+     *  recency filtering downstream; agents reading the JSON should
+     *  treat this as best-effort and not parse strictly. */
+    publishedDate?: string | null;
+}
+export interface SearchOpts {
+    /** 1-20. Tavily max 20, Brave max 20. The tool clamps. */
+    count: number;
+    /** Free-text language hint, passed through where the provider
+     *  supports it. e.g. `"zh-CN"`, `"en"`. */
+    language?: string;
+    /** Recency window. Maps to provider-specific values; absence
+     *  means "no recency filter". */
+    freshness?: "day" | "week" | "month" | "year";
+    /** Network timeout per fetch (ms). 8000 is the tool's default. */
+    timeoutMs: number;
+}
+export interface ProviderError {
+    provider: string;
+    /** http status if the provider responded; 0 for transport errors. */
+    status: number;
+    message: string;
+}
+/** Each provider implements this. `key` is the API key from
+ *  `pluginConfig`; the surrounding tool decides which provider(s)
+ *  to call based on which keys are present. */
+export interface SearchProvider {
+    readonly name: "tavily" | "brave";
+    search(query: string, key: string, opts: SearchOpts): Promise<{
+        results: SearchResult[];
+    } | {
+        error: ProviderError;
+    }>;
+}
+export declare const tavilyProvider: SearchProvider;
+export declare const braveProvider: SearchProvider;
+//# sourceMappingURL=providers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/tools/providers.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ;4DACwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB;;4DAEwD;IACxD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd;+CAC2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;qCACiC;IACjC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;+CAE+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClC,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,eAAO,MAAM,cAAc,EAAE,cA6D5B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAwE3B,CAAC"}

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

@@ -0,0 +1,140 @@
+// Two adapters with the same shape so the surrounding tool can
+// fall back from one to the other without branching on provider
+// names. Both providers serve a JSON API; the only async is one
+// fetch + json parse per call.
+//
+// Why the contract is `(query, opts) => SearchResult[]` and not
+// the provider's native shape:
+//   - the agent shouldn't have to know which provider answered
+//   - errors are uniform (one place that throws, one error log)
+//   - if we add Exa / Serper / a self-hosted SearXNG later it
+//     drops in here without touching the tool
+export const tavilyProvider = {
+    name: "tavily",
+    async search(query, key, opts) {
+        // Tavily's "advanced" mode summarises content; "basic" returns
+        // bare snippets. We pick basic — the agent will fetch the page
+        // when it needs the body, and basic is faster + cheaper.
+        const body = {
+            api_key: key,
+            query,
+            search_depth: "basic",
+            include_answer: false,
+            include_raw_content: false,
+            include_images: false,
+            max_results: clamp(opts.count, 1, 20),
+        };
+        if (opts.freshness) {
+            body.time_range = opts.freshness;
+        }
+        try {
+            const ctl = new AbortController();
+            const timer = setTimeout(() => ctl.abort(), opts.timeoutMs);
+            const res = await fetch("https://api.tavily.com/search", {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(body),
+                signal: ctl.signal,
+            }).finally(() => clearTimeout(timer));
+            if (!res.ok) {
+                return {
+                    error: {
+                        provider: "tavily",
+                        status: res.status,
+                        message: await safeText(res),
+                    },
+                };
+            }
+            const json = (await res.json());
+            const results = (json.results ?? []).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.published_date ?? null,
+            }));
+            return { results };
+        }
+        catch (err) {
+            return {
+                error: {
+                    provider: "tavily",
+                    status: 0,
+                    message: err instanceof Error ? err.message : String(err),
+                },
+            };
+        }
+    },
+};
+export const braveProvider = {
+    name: "brave",
+    async search(query, key, opts) {
+        // Brave's web search returns up to 20 in `web.results`; news /
+        // images live in sibling sections we ignore for now.
+        const params = new URLSearchParams({
+            q: query,
+            count: String(clamp(opts.count, 1, 20)),
+            safesearch: "off",
+            // Brave understands ISO 639-1 + locale; we only forward the
+            // first 5 chars to keep the param valid (`zh-CN` → `zh-CN`,
+            // `en` → `en`).
+            ...(opts.language ? { search_lang: opts.language.slice(0, 5) } : {}),
+            // Recency: Brave uses pd / pw / pm / py.
+            ...(opts.freshness
+                ? {
+                    freshness: { day: "pd", week: "pw", month: "pm", year: "py" }[opts.freshness],
+                }
+                : {}),
+        });
+        try {
+            const ctl = new AbortController();
+            const timer = setTimeout(() => ctl.abort(), opts.timeoutMs);
+            const res = await fetch(`https://api.search.brave.com/res/v1/web/search?${params.toString()}`, {
+                headers: {
+                    "x-subscription-token": key,
+                    accept: "application/json",
+                    "accept-encoding": "gzip",
+                },
+                signal: ctl.signal,
+            }).finally(() => clearTimeout(timer));
+            if (!res.ok) {
+                return {
+                    error: {
+                        provider: "brave",
+                        status: res.status,
+                        message: await safeText(res),
+                    },
+                };
+            }
+            const json = (await res.json());
+            const results = (json.web?.results ?? []).map((r) => ({
+                title: typeof r.title === "string" ? r.title : "",
+                url: typeof r.url === "string" ? r.url : "",
+                content: typeof r.description === "string" ? r.description : "",
+                publishedDate: r.page_age ?? null,
+            }));
+            return { results };
+        }
+        catch (err) {
+            return {
+                error: {
+                    provider: "brave",
+                    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)));
+}
+async function safeText(res) {
+    try {
+        const t = await res.text();
+        return t.slice(0, 300);
+    }
+    catch {
+        return "<failed to read response body>";
+    }
+}
+//# sourceMappingURL=providers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/tools/providers.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gEAAgE;AAChE,gEAAgE;AAChE,+BAA+B;AAC/B,EAAE;AACF,gEAAgE;AAChE,+BAA+B;AAC/B,+DAA+D;AAC/D,gEAAgE;AAChE,8DAA8D;AAC9D,8CAA8C;AA8C9C,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,QAAQ;IACd,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI;QAC3B,+DAA+D;QAC/D,+DAA+D;QAC/D,yDAAyD;QACzD,MAAM,IAAI,GAA4B;YACpC,OAAO,EAAE,GAAG;YACZ,KAAK;YACL,YAAY,EAAE,OAAO;YACrB,cAAc,EAAE,KAAK;YACrB,mBAAmB,EAAE,KAAK;YAC1B,cAAc,EAAE,KAAK;YACrB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;SACtC,CAAC;QACF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QACnC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;gBACvD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO;oBACL,KAAK,EAAE;wBACL,QAAQ,EAAE,QAAQ;wBAClB,MAAM,EAAE,GAAG,CAAC,MAAM;wBAClB,OAAO,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC;qBAC7B;iBACF,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAO7B,CAAC;YACF,MAAM,OAAO,GAAmB,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/D,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBACjD,GAAG,EAAE,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBAC3C,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBACvD,aAAa,EAAE,CAAC,CAAC,cAAc,IAAI,IAAI;aACxC,CAAC,CAAC,CAAC;YACJ,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,KAAK,EAAE;oBACL,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D;aACF,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,OAAO;IACb,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI;QAC3B,+DAA+D;QAC/D,qDAAqD;QACrD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,CAAC,EAAE,KAAK;YACR,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,UAAU,EAAE,KAAK;YACjB,4DAA4D;YAC5D,4DAA4D;YAC5D,gBAAgB;YAChB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,yCAAyC;YACzC,GAAG,CAAC,IAAI,CAAC,SAAS;gBAChB,CAAC,CAAC;oBACE,SAAS,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAC3D,IAAI,CAAC,SAAS,CACf;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5D,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,kDAAkD,MAAM,CAAC,QAAQ,EAAE,EAAE,EACrE;gBACE,OAAO,EAAE;oBACP,sBAAsB,EAAE,GAAG;oBAC3B,MAAM,EAAE,kBAAkB;oBAC1B,iBAAiB,EAAE,MAAM;iBAC1B;gBACD,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CACF,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO;oBACL,KAAK,EAAE;wBACL,QAAQ,EAAE,OAAO;wBACjB,MAAM,EAAE,GAAG,CAAC,MAAM;wBAClB,OAAO,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC;qBAC7B;iBACF,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAS7B,CAAC;YACF,MAAM,OAAO,GAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpE,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBACjD,GAAG,EAAE,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBAC3C,OAAO,EAAE,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;gBAC/D,aAAa,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;aAClC,CAAC,CAAC,CAAC;YACJ,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,KAAK,EAAE;oBACL,QAAQ,EAAE,OAAO;oBACjB,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D;aACF,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,KAAK,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gCAAgC,CAAC;IAC1C,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { AgentTool } from "@tianshu/plugin-sdk";
+import { ProviderHealth } from "./health.js";
+export interface WebSearchPluginConfig {
+    tavilyApiKey?: string;
+    braveApiKey?: string;
+    preferredProvider?: "tavily" | "brave";
+    /** Optional default timeout override (ms). 8000 if unset. */
+    timeoutMs?: number;
+}
+export declare function buildWebSearchTool(cfg: WebSearchPluginConfig, health: ProviderHealth): AgentTool;
+/** Read raw `pluginConfig` (an opaque Record) into the typed
+ *  shape this plugin actually uses. Plugin's `activate()` calls
+ *  this once at startup. */
+export declare function readWebSearchConfig(raw: unknown): WebSearchPluginConfig;
+//# sourceMappingURL=web-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,qBAAqB,CAAC;AAQvE,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"}

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

@@ -0,0 +1,244 @@
+// `web_search(query, count?, language?, freshness?, provider?)`.
+//
+// One tool, two provider adapters, optional fallback. The plugin's
+// `activate()` reads its API keys from `ctx.pluginConfig` and
+// hands them into `buildWebSearchTool(cfg)` as a closure. The
+// host re-activates the plugin when config changes, so the keys
+// stay current without per-call config plumbing.
+//
+// Tenant config shape:
+//
+//   {
+//     "plugins": {
+//       "web-search": {
+//         "config": {
+//           "tavilyApiKey": "tvly-...",
+//           "braveApiKey":  "BSA...",
+//           "preferredProvider": "tavily" | "brave"  // optional
+//         }
+//       }
+//     }
+//   }
+//
+// If both keys are configured we prefer `preferredProvider` (or
+// "tavily" by default) and fall back to the other one ONLY when
+// the first returns a clearly transient error (network reset, 5xx,
+// 429, or zero results when both providers are available). Bad
+// keys (401/403) don't trigger fallback — that's a config problem
+// the user needs to fix, not a runtime hiccup.
+import { Type } from "typebox";
+import { braveProvider, tavilyProvider, } from "./providers.js";
+export function buildWebSearchTool(cfg, health) {
+    return {
+        schema: {
+            name: "web_search",
+            description: "Search the web for up-to-date information. Returns a JSON " +
+                "array of `{ title, url, content, publishedDate }` objects, " +
+                "ranked by the underlying provider. Backed by Tavily or " +
+                "Brave Search depending on which API key the host has " +
+                "configured. Use this for current events, recent docs, " +
+                "anything that may have changed since training. Don't loop " +
+                "many tiny searches \u2014 refine the query and increase `count`.",
+            parameters: Type.Object({
+                query: Type.String({
+                    description: "Free-text search query, 1-300 chars.",
+                }),
+                count: Type.Optional(Type.Number({
+                    description: "Number of results (1-20). Default 5.",
+                    minimum: 1,
+                    maximum: 20,
+                })),
+                language: Type.Optional(Type.String({
+                    description: "Language hint, ISO 639-1 or locale (e.g. \"zh-CN\", \"en\"). " +
+                        "Only applied by providers that accept it.",
+                })),
+                freshness: Type.Optional(Type.Union([
+                    Type.Literal("day"),
+                    Type.Literal("week"),
+                    Type.Literal("month"),
+                    Type.Literal("year"),
+                ], {
+                    description: "Recency filter. Default is no filter (all results, ranked by relevance).",
+                })),
+                provider: Type.Optional(Type.Union([Type.Literal("tavily"), Type.Literal("brave")], {
+                    description: "Force a specific provider. Default uses the host's preferred provider with automatic fallback.",
+                })),
+            }),
+        },
+        available(_ctx) {
+            return Boolean(cfg.tavilyApiKey ?? cfg.braveApiKey);
+        },
+        async execute(rawArgs, _ctx) {
+            const args = rawArgs;
+            const query = typeof args.query === "string" ? args.query.trim() : "";
+            if (!query) {
+                return { ok: false, text: "query is required" };
+            }
+            if (query.length > 300) {
+                return {
+                    ok: false,
+                    text: "query too long (max 300 chars). Trim or split into separate searches.",
+                };
+            }
+            const fullOrder = providerOrder(cfg, args.provider);
+            if (fullOrder.length === 0) {
+                return {
+                    ok: false,
+                    text: "web_search has no API keys configured. Open Settings → Plugins → Web Search and add a Tavily or Brave API key.",
+                };
+            }
+            // Apply health cache: skip providers we already know are
+            // dead (bad key). The agent gets to see the cached reason
+            // in the error trail, so a stale cache shows up loudly.
+            const skipped = [];
+            const order = fullOrder.filter(({ provider }) => {
+                const dead = health.isDead(provider.name);
+                if (dead) {
+                    skipped.push({
+                        provider: provider.name,
+                        status: dead.status,
+                        message: `cached as dead since ${new Date(dead.deadSince).toISOString()}: ${dead.message}`,
+                    });
+                    return false;
+                }
+                return true;
+            });
+            if (order.length === 0) {
+                return {
+                    ok: false,
+                    text: `web_search: every configured provider is in the dead-cache. ` +
+                        `Update the bad key(s) and click "Reset health cache" in ` +
+                        `Settings → Plugins → Web Search, or PATCH ` +
+                        `/api/p/web-search/health/reset.\n\nDead providers:\n` +
+                        skipped
+                            .map((s) => `- ${s.provider} (status ${s.status}): ${s.message}`)
+                            .join("\n"),
+                    data: { skipped },
+                };
+            }
+            const opts = {
+                count: typeof args.count === "number" ? args.count : 5,
+                language: args.language,
+                freshness: args.freshness,
+                timeoutMs: cfg.timeoutMs ?? 8000,
+            };
+            const errors = [...skipped];
+            for (const { provider, key } of order) {
+                const out = await provider.search(query, key, opts);
+                if ("results" in out) {
+                    if (out.results.length === 0 && order.length > 1) {
+                        // Empty isn't an error per se, but if we have a fallback
+                        // it's worth one more shot — small queries sometimes
+                        // return nothing on Brave but plenty on Tavily.
+                        errors.push({
+                            provider: provider.name,
+                            status: 200,
+                            message: "zero results",
+                        });
+                        continue;
+                    }
+                    return formatSuccess(provider.name, query, out.results, errors);
+                }
+                const e = out.error;
+                errors.push(e);
+                // Auth errors: park the provider in the health cache so
+                // future calls skip it without paying the round-trip.
+                // Only auth gets cached — 5xx / network / 429 are usually
+                // transient and would bake a bad cache entry.
+                if (e.status === 401 || e.status === 403) {
+                    health.markDead(provider.name, e.status, e.message);
+                    // Don't fall back on auth errors — the operator needs to
+                    // fix the key. (Falling back to a probably-also-broken
+                    // sibling key just papers over the real problem.)
+                    break;
+                }
+            }
+            return {
+                ok: false,
+                text: formatFailure(query, errors),
+                data: { query, errors },
+            };
+        },
+    };
+}
+/** Read raw `pluginConfig` (an opaque Record) into the typed
+ *  shape this plugin actually uses. Plugin's `activate()` calls
+ *  this once at startup. */
+export function readWebSearchConfig(raw) {
+    if (!raw || typeof raw !== "object")
+        return {};
+    const r = raw;
+    return {
+        tavilyApiKey: typeof r.tavilyApiKey === "string" && r.tavilyApiKey
+            ? r.tavilyApiKey
+            : undefined,
+        braveApiKey: typeof r.braveApiKey === "string" && r.braveApiKey
+            ? r.braveApiKey
+            : undefined,
+        preferredProvider: r.preferredProvider === "tavily" || r.preferredProvider === "brave"
+            ? r.preferredProvider
+            : undefined,
+        timeoutMs: typeof r.timeoutMs === "number" && Number.isFinite(r.timeoutMs)
+            ? r.timeoutMs
+            : undefined,
+    };
+}
+/** Decide which providers to try, in order. Returns at most two
+ *  entries (the configured pair, preferred first). */
+function providerOrder(cfg, override) {
+    const haveTavily = !!cfg.tavilyApiKey;
+    const haveBrave = !!cfg.braveApiKey;
+    if (override) {
+        if (override === "tavily" && haveTavily) {
+            return [{ provider: tavilyProvider, key: cfg.tavilyApiKey }];
+        }
+        if (override === "brave" && haveBrave) {
+            return [{ provider: braveProvider, key: cfg.braveApiKey }];
+        }
+        // Override asked for a provider with no key configured; skip
+        // it and fall through to the default ordering rather than
+        // returning [], so the agent still gets results.
+    }
+    const preferTavily = (cfg.preferredProvider ?? "tavily") === "tavily";
+    const order = [];
+    if (preferTavily) {
+        if (haveTavily)
+            order.push({ provider: tavilyProvider, key: cfg.tavilyApiKey });
+        if (haveBrave)
+            order.push({ provider: braveProvider, key: cfg.braveApiKey });
+    }
+    else {
+        if (haveBrave)
+            order.push({ provider: braveProvider, key: cfg.braveApiKey });
+        if (haveTavily)
+            order.push({ provider: tavilyProvider, key: cfg.tavilyApiKey });
+    }
+    return order;
+}
+function formatSuccess(provider, query, results, priorErrors) {
+    const head = priorErrors.length === 0
+        ? `${results.length} result${results.length === 1 ? "" : "s"} from ${provider} for "${query}":`
+        : `${results.length} result${results.length === 1 ? "" : "s"} from ${provider} (after ${priorErrors.length} fallback attempt${priorErrors.length === 1 ? "" : "s"}) for "${query}":`;
+    const lines = results.map((r, i) => {
+        const date = r.publishedDate ? ` (${r.publishedDate})` : "";
+        const snippet = (r.content ?? "").trim().slice(0, 280);
+        return `${i + 1}. ${r.title}\n   ${r.url}${date}\n   ${snippet}`;
+    });
+    return {
+        ok: true,
+        text: [head, "", ...lines].join("\n"),
+        data: { query, provider, results },
+    };
+}
+function formatFailure(query, errors) {
+    const lines = errors.map((e) => `- ${e.provider} (status ${e.status}): ${e.message}`);
+    return [
+        `web_search failed for "${query}". Provider attempts:`,
+        ...lines,
+        "",
+        "If this is a config problem (status 401 / 403), update the key " +
+            "in tenant config under `plugins.web-search.config`. If it's a " +
+            "transient network error, retry the query.",
+    ].join("\n");
+}
+//# sourceMappingURL=web-search.js.map

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

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