@sema-agent/server 3.17.0 → 3.18.0

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

@@ -24,7 +24,11 @@
  *    ⚠️ 判据留痕:我第一轮把这条判成了「约束被静默丢弃」的安全缺口,是**亲读 core 结果侧代码**
  *    才推翻的。「别处已经处理了」这种声明必须验证 —— 这次它是真的,但真假只能靠读。
  *
- * ② **searxng 腿是自铸的第二真源**。core 2.10 起已导出 `createSearxngSearchBackend`
+ * ② ~~**searxng 腿是自铸的第二真源**~~ —— ✅ **已还(2026-08-01,[2229] 裁定 searxng 为国内可达性
+ *    主路线之后)**:本腿改为消费 core 的 `createSearxngSearchBackend`,外层保住 maxResults 截断 /
+ *    统一形状 / 坏 payload 观测器三样(各有红先钉 + 变异实测),白得 `site:` 原生下推、`extraParams`、
+ *    自带 timeout。以下为原始立案文本,留档:
+ *    core 2.10 起已导出 `createSearxngSearchBackend`
  *    (+`SearxngBackendOptions`),而且比本文件的实现多三样:`allowedDomains` 拼 `site:` 原生下推、
  *    `extraParams`(实例特定的 `engines=`/`language=` 等)、**自带 timeout**
  *    (`AbortSignal.any([signal, timeout])`;本文件的 searxng 腿只吃外部 signal)。
@@ -48,6 +52,9 @@ export interface WebSearchBackendConfig {
     readonly provider: WebSearchProvider;
     /** API key (brave/tavily). From `WEB_SEARCH_API_KEY` — never reaches the model. */
     readonly apiKey?: string;
+    /** SearXNG 实例特定查询参数(`engines=` / `language=` 等)——透传给 core adapter 的 `extraParams`。
+     *  一键装 SearXNG 的向导用它把「选了哪些上游引擎」落到引擎侧。仅 searxng 腿消费。 */
+    readonly searxngParams?: Record<string, string>;
     /** SearXNG instance base URL (REQUIRED for searxng); for brave/tavily an optional base-URL override (proxy/test). */
     readonly endpoint?: string;
     /** Max results returned to the model (clamped 1..20; default 10). */

package/dist/plugins/web-search.js

@@ -24,7 +24,11 @@
  *    ⚠️ 判据留痕:我第一轮把这条判成了「约束被静默丢弃」的安全缺口,是**亲读 core 结果侧代码**
  *    才推翻的。「别处已经处理了」这种声明必须验证 —— 这次它是真的,但真假只能靠读。
  *
- * ② **searxng 腿是自铸的第二真源**。core 2.10 起已导出 `createSearxngSearchBackend`
+ * ② ~~**searxng 腿是自铸的第二真源**~~ —— ✅ **已还(2026-08-01,[2229] 裁定 searxng 为国内可达性
+ *    主路线之后)**:本腿改为消费 core 的 `createSearxngSearchBackend`,外层保住 maxResults 截断 /
+ *    统一形状 / 坏 payload 观测器三样(各有红先钉 + 变异实测),白得 `site:` 原生下推、`extraParams`、
+ *    自带 timeout。以下为原始立案文本,留档:
+ *    core 2.10 起已导出 `createSearxngSearchBackend`
  *    (+`SearxngBackendOptions`),而且比本文件的实现多三样:`allowedDomains` 拼 `site:` 原生下推、
  *    `extraParams`(实例特定的 `engines=`/`language=` 等)、**自带 timeout**
  *    (`AbortSignal.any([signal, timeout])`;本文件的 searxng 腿只吃外部 signal)。
@@ -42,6 +46,7 @@
  *    验证搜索配对不对。挂哪儿(boot 期一次性 warn / `/health` 子字段 / 显式端点)未定 ——
  *    注意 boot 期探活会给每次启动加一次出网,多租/离线部署要能关。
  */
+import { createSearxngSearchBackend } from "@sema-agent/core";
 const DEFAULT_MAX_RESULTS = 10;
 const DEFAULT_TIMEOUT_MS = 10_000;
 const BRAVE_BASE = "https://api.search.brave.com/res/v1/web/search";
@@ -130,17 +135,45 @@ async function tavilySearch(fetchImpl, cfg, query, max, signal, opts) {
     const data = (await res.json());
     return normalize(data.results, (r) => ({ title: r.title, url: r.url, snippet: r.content }), max, "tavily");
 }
-async function searxngSearch(fetchImpl, cfg, query, max, signal) {
+/**
+ * SearXNG 腿 —— **消费 core 的 `createSearxngSearchBackend`,不再自铸**(#81② 还债;[2190] 表态、
+ * [2229] 裁定 searxng 是国内可达性主路线之后该还的那笔)。
+ *
+ * core 的 adapter 比本文件此前的手写实现多三样,换过来就白得:
+ *   · `allowedDomains` **原生下推**成 `site:a OR site:b` 前缀(此前本腿完全忽略 opts —— core 工具层
+ *     有结果侧 FLOOR 兜底所以不是正确性缺口,但白搜一趟、白花配额,极端情况下限域搜索回 0 条);
+ *   · `extraParams`(实例特定的 `engines=` / `language=` 等)——一键装 SearXNG 的向导要用;
+ *   · **自带 timeout**(`AbortSignal.any([signal, timeout])`;此前本腿只吃外部 signal)。
+ *
+ * ⚠️ core adapter **不管**这三样,必须留在外层(换真源最容易丢的就是它们,已上红先钉):
+ *   ① `maxResults` 截断 ② 统一形状 `{title,url,snippet}` ③ 坏 payload 观测器。
+ */
+async function searxngSearch(fetchImpl, cfg, query, max, signal, opts) {
     if (!cfg.endpoint)
         throw new Error("WEB_SEARCH_ENDPOINT (the SearXNG instance URL) is required for the searxng provider");
-    const url = new URL("/search", cfg.endpoint); // endpoint is the deployment-configured instance base (trusted, not model-controlled)
-    url.searchParams.set("q", query);
-    url.searchParams.set("format", "json");
-    const res = await fetchImpl(url, { headers: { Accept: "application/json" }, signal }); // SearXNG needs no auth
-    if (!res.ok)
-        throw new Error(`searxng search failed (${res.status}): ${await errorText(res)}`);
-    const data = (await res.json());
-    return normalize(data.results, (r) => ({ title: r.title, url: r.url, snippet: r.content }), max, "searxng");
+    const search = createSearxngSearchBackend(cfg.endpoint, {
+        fetchImpl,
+        ...(cfg.searxngParams ? { extraParams: cfg.searxngParams } : {}),
+    });
+    let rows;
+    try {
+        rows = await search(query, signal, opts);
+    }
+    catch (e) {
+        // core 对「results 不是数组」抛具名错;本腿的既有契约是**不抛给上层、走观测器**(review LOW:
+        // 畸形 payload 不该变成裸 TypeError 上抛)。保持既有契约,把它翻译回观测器 + 空结果。
+        const msg = e instanceof Error ? e.message : String(e);
+        if (/no results array/i.test(msg)) {
+            try {
+                onBadPayload?.("searxng");
+            }
+            catch { /* observability never breaks search */ }
+            return [];
+        }
+        throw e;
+    }
+    // core 已回 `{title,url,snippet}` 形;仍过一遍 normalize —— ① 截断 ② 形状兜底 ③ 观测器同源。
+    return normalize(rows, (r) => ({ title: r.title, url: r.url, snippet: r.snippet }), max, "searxng");
 }
 /**
  * Build the `WebSearchConfig` (a `search` fn + `maxResults`) for `assembleFullBodyTools({ webSearch })`. The API key
@@ -159,7 +192,7 @@ export function createWebSearchBackend(cfg) {
             switch (cfg.provider) {
                 case "brave": return await braveSearch(fetchImpl, cfg, q, maxResults, sig);
                 case "tavily": return await tavilySearch(fetchImpl, cfg, q, maxResults, sig, opts);
-                case "searxng": return await searxngSearch(fetchImpl, cfg, q, maxResults, sig);
+                case "searxng": return await searxngSearch(fetchImpl, cfg, q, maxResults, sig, opts);
             }
         }
         finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/server",
-  "version": "3.17.0",
+  "version": "3.18.0",
   "description": "Sema Server — the server/API implementation layer for Sema, wiring core, registry, model providers, and cloud agent execution. Built on @sema-agent/core.",
   "type": "module",
   "license": "BUSL-1.1",