@zooique/memora 2.0.0 → 3.0.0

package/dist/utils/toError.d.ts

@@ -2,7 +2,7 @@
  * 纯逻辑 toError — 零依赖，浏览器 / Node.js 通用
  *
  * 将 catch 块中的 unknown 值安全转换为 Error 对象。
- * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging（pino）依赖。
+ * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging/ 模块。
  *
  * 转换规则（5 分支，与精灵 shared/toError.ts 行为对齐）：
  *   1. Error 实例：原样返回
@@ -14,4 +14,16 @@
  * null/undefined 返回 '未知错误'，比 'null'/'undefined' 更友好。
  */
 export declare function toError(err: unknown): Error;
+/**
+ * 判断错误对象是否带指定 Node.js 错误码（如 ENOENT）
+ *
+ * 收口「catch 块判断 err.code」的同语义多实现：builtinToolHandlers 4 处与
+ * config/loader 1 处曾各自手写同一判定（typeof/code in/=== 三连）。node:fs 抛出的
+ * 错误为 Error & { code }，IPC 序列化错误亦带 code 字段；非对象/null 安全返回 false。
+ *
+ * @param err catch 块捕获的 unknown 值
+ * @param code 目标错误码（如 'ENOENT'）
+ * @returns 是否命中指定错误码
+ */
+export declare function isNodeErrorCode(err: unknown, code: string): boolean;
 //# sourceMappingURL=toError.d.ts.map

package/dist/utils/toError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toError.d.ts","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAwB3C"}
+{"version":3,"file":"toError.d.ts","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAwB3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOnE"}

package/dist/utils/toError.js

@@ -2,7 +2,7 @@
  * 纯逻辑 toError — 零依赖，浏览器 / Node.js 通用
  *
  * 将 catch 块中的 unknown 值安全转换为 Error 对象。
- * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging（pino）依赖。
+ * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging/ 模块。
  *
  * 转换规则（5 分支，与精灵 shared/toError.ts 行为对齐）：
  *   1. Error 实例：原样返回
@@ -39,4 +39,21 @@ export function toError(err) {
     // 5. 基础类型（number/boolean/symbol/null/undefined）
     return new Error(String(err ?? '未知错误'));
 }
+/**
+ * 判断错误对象是否带指定 Node.js 错误码（如 ENOENT）
+ *
+ * 收口「catch 块判断 err.code」的同语义多实现：builtinToolHandlers 4 处与
+ * config/loader 1 处曾各自手写同一判定（typeof/code in/=== 三连）。node:fs 抛出的
+ * 错误为 Error & { code }，IPC 序列化错误亦带 code 字段；非对象/null 安全返回 false。
+ *
+ * @param err catch 块捕获的 unknown 值
+ * @param code 目标错误码（如 'ENOENT'）
+ * @returns 是否命中指定错误码
+ */
+export function isNodeErrorCode(err, code) {
+    return (err !== null &&
+        typeof err === 'object' &&
+        'code' in err &&
+        err.code === code);
+}
 //# sourceMappingURL=toError.js.map

package/dist/utils/toError.js.map

@@ -1 +1 @@
-{"version":3,"file":"toError.js","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,yBAAyB;IACzB,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC;IACrC,kBAAkB;IAClB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,4CAA4C;IAC5C,IACE,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAQ,GAA6B,CAAC,OAAO,KAAK,QAAQ,EAC1D,CAAC;QACD,OAAO,IAAI,KAAK,CAAE,GAA2B,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,0DAA0D;IAC1D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;YAC7B,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,gDAAgD;IAChD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"toError.js","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,yBAAyB;IACzB,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC;IACrC,kBAAkB;IAClB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACnD,4CAA4C;IAC5C,IACE,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAQ,GAA6B,CAAC,OAAO,KAAK,QAAQ,EAC1D,CAAC;QACD,OAAO,IAAI,KAAK,CAAE,GAA2B,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,0DAA0D;IAC1D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;YAC7B,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,gDAAgD;IAChD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY,EAAE,IAAY;IACxD,OAAO,CACL,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,KAAK,QAAQ;QACvB,MAAM,IAAI,GAAG;QACZ,GAAyB,CAAC,IAAI,KAAK,IAAI,CACzC,CAAC;AACJ,CAAC"}

package/dist/web-fetch/fetchWebFetchProvider.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 基于 fetch 的默认网页抓取实现（FetchWebFetchProvider）
+ * 使用 Node.js 18+ 内置 fetch，零依赖。仅用于"开箱即用"场景，
+ * 生产环境建议宿主实现 IFetchProvider 用专用抓取服务（渲染 / 代理 / 限流）。
+ */
+import type { FetchedPage, FetchOptions, IFetchProvider } from '../web-fetch/types.js';
+/** 默认网页抓取实现：Node 内置 fetch + 正文清洗 + 截断 */
+export declare class FetchWebFetchProvider implements IFetchProvider {
+    /**
+     * 抓取 URL：带超时控制（共享 fetchWithTimeout），返回清洗后的正文纯文本。
+     */
+    fetch(url: string, options?: FetchOptions): Promise<FetchedPage>;
+}
+//# sourceMappingURL=fetchWebFetchProvider.d.ts.map

package/dist/web-fetch/fetchWebFetchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWebFetchProvider.d.ts","sourceRoot":"","sources":["../../src/web-fetch/fetchWebFetchProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAoDtF,yCAAyC;AACzC,qBAAa,qBAAsB,YAAW,cAAc;IAC1D;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAiBvE"}

package/dist/web-fetch/fetchWebFetchProvider.js

@@ -0,0 +1,69 @@
+import { BROWSER_UA, fetchWithTimeout } from '../utils/http.js';
+/** 单次请求超时（ms）：抓取通常 1-3s 返回，10s 覆盖慢网络且不至于拖死主循环 */
+const REQUEST_TIMEOUT_MS = 10_000;
+/** 默认正文截断上限（字符） */
+const DEFAULT_MAX_CHARS = 8_000;
+/** 原始 HTML 可接受上限（字符）：防超大页面占满内存，超限直接截断再清洗 */
+const MAX_RAW_CHARS = 50_000;
+/**
+ * HTML → 正文纯文本：去 script/style/head + 去标签 + 解实体 + 去控制字符 + 压缩空白 + 截断。
+ * 用正则而非 DOM 解析，避免引入 jsdom 依赖（对齐 fetchWebSearchProvider 的零依赖思路）。
+ *
+ * @param html 原始 HTML
+ * @param maxChars 正文截断上限
+ * @returns 清洗后的纯文本
+ */
+function stripHtmlToText(html, maxChars) {
+    const text = html
+        // 先剔除脚本/样式/头部（正文无关且含特殊字符）
+        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+        .replace(/<head[\s\S]*?<\/head>/gi, ' ')
+        // 再剔除剩余标签
+        .replace(/<[^>]+>/g, ' ')
+        // 解码常见 HTML 实体
+        .replace(/&nbsp;/gi, ' ')
+        .replace(/&amp;/gi, '&')
+        .replace(/&lt;/gi, '<')
+        .replace(/&gt;/gi, '>')
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;/gi, "'")
+        // 去控制字符（防转义/终端注入，对齐 toolExecutor.sanitizeExternalText 语义）
+        .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, '')
+        // 压缩空白：行内空格折叠 + 多空行归一
+        .replace(/[ \t]+/g, ' ')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+    return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+}
+/**
+ * 从 <title> 提取页面标题（清洗后截断）
+ */
+function extractTitle(html) {
+    const match = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
+    return match ? stripHtmlToText(match[1], 200) : '';
+}
+/** 默认网页抓取实现：Node 内置 fetch + 正文清洗 + 截断 */
+export class FetchWebFetchProvider {
+    /**
+     * 抓取 URL：带超时控制（共享 fetchWithTimeout），返回清洗后的正文纯文本。
+     */
+    async fetch(url, options) {
+        const maxChars = options?.maxChars ?? DEFAULT_MAX_CHARS;
+        const response = await fetchWithTimeout(url, REQUEST_TIMEOUT_MS, BROWSER_UA);
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status} ${response.statusText}`);
+        }
+        const contentType = response.headers.get('content-type') ?? '';
+        const raw = await response.text();
+        // 超限原始响应直接截断再清洗，防超大页面拖慢/占满内存
+        const content = stripHtmlToText(raw.slice(0, MAX_RAW_CHARS), maxChars);
+        return {
+            url: response.url || url,
+            title: extractTitle(raw),
+            content,
+            contentType,
+        };
+    }
+}
+//# sourceMappingURL=fetchWebFetchProvider.js.map

package/dist/web-fetch/fetchWebFetchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWebFetchProvider.js","sourceRoot":"","sources":["../../src/web-fetch/fetchWebFetchProvider.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,iDAAiD;AACjD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,mBAAmB;AACnB,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC,4CAA4C;AAC5C,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,QAAgB;IACrD,MAAM,IAAI,GAAG,IAAI;QACf,0BAA0B;SACzB,OAAO,CAAC,6BAA6B,EAAE,GAAG,CAAC;SAC3C,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC;SACzC,OAAO,CAAC,yBAAyB,EAAE,GAAG,CAAC;QACxC,UAAU;SACT,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;QACzB,eAAe;SACd,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;QACxB,0DAA0D;SACzD,OAAO,CAAC,iDAAiD,EAAE,EAAE,CAAC;QAC/D,sBAAsB;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAC;IACV,OAAO,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,KAAK,GAAG,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,yCAAyC;AACzC,MAAM,OAAO,qBAAqB;IAChC;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,OAAsB;QAC7C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,EAAE,UAAU,CAAC,CAAC;QAC7E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClC,6BAA6B;QAC7B,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC;QACvE,OAAO;YACL,GAAG,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG;YACxB,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC;YACxB,OAAO;YACP,WAAW;SACZ,CAAC;IACJ,CAAC;CACF"}

package/dist/web-fetch/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 网页抓取提供者接口定义：让 memora 内核具备可注入的网页正文抓取能力。
+ * 宿主实现 IFetchProvider 注入自定义抓取实现（接口注入，遵循 IWebSearchProvider 模式；零依赖）。
+ * 与 web_search 成对构成「搜索→抓取」闭环：web_search 给出候选 URL，web_fetch 读正文。
+ */
+/** 抓取到的网页内容 */
+export interface FetchedPage {
+    /** 页面 URL（若发生重定向则返回实际地址） */
+    url: string;
+    /** 页面标题（无标题时为空串） */
+    title: string;
+    /** 清洗后的正文纯文本 */
+    content: string;
+    /** 内容类型（如 "text/html"、"application/pdf"），无法识别时为空串 */
+    contentType?: string;
+}
+/** 抓取选项 */
+export interface FetchOptions {
+    /** 返回正文最大字符数（默认 8000） */
+    maxChars?: number;
+}
+/**
+ * 网页抓取提供者接口：宿主实现并注入 AgentOptions.fetchProvider 提供抓取能力；
+ * 未注入时 Agent 不会暴露 web_fetch 工具给 LLM。
+ */
+export interface IFetchProvider {
+    /** 抓取 URL 并返回清洗后的正文纯文本 */
+    fetch(url: string, options?: FetchOptions): Promise<FetchedPage>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/web-fetch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web-fetch/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClE"}

package/dist/web-fetch/types.js

@@ -0,0 +1,7 @@
+/**
+ * 网页抓取提供者接口定义：让 memora 内核具备可注入的网页正文抓取能力。
+ * 宿主实现 IFetchProvider 注入自定义抓取实现（接口注入，遵循 IWebSearchProvider 模式；零依赖）。
+ * 与 web_search 成对构成「搜索→抓取」闭环：web_search 给出候选 URL，web_fetch 读正文。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/web-fetch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web-fetch/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/web-fetch/webFetchProvider.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 网页抓取集成入口：提供带超时保护的加载包装，组合默认实现或宿主自定义实现。
+ * 抓取失败时降级返回友好错误信息，不中断对话流程（30s 超时防卡死 Agent 主循环）。
+ */
+import type { FetchedPage, FetchOptions, IFetchProvider } from '../web-fetch/types.js';
+/**
+ * 带超时和错误处理的抓取包装：超时或失败时不抛异常，返回降级提示页。
+ */
+export declare function safeFetch(provider: IFetchProvider, url: string, options?: FetchOptions): Promise<FetchedPage>;
+//# sourceMappingURL=webFetchProvider.d.ts.map

package/dist/web-fetch/webFetchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webFetchProvider.d.ts","sourceRoot":"","sources":["../../src/web-fetch/webFetchProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKtF;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC,CAoBtB"}

package/dist/web-fetch/webFetchProvider.js

@@ -0,0 +1,28 @@
+/** 网页抓取超时时间（毫秒） */
+const FETCH_TIMEOUT_MS = 30_000;
+/**
+ * 带超时和错误处理的抓取包装：超时或失败时不抛异常，返回降级提示页。
+ */
+export async function safeFetch(provider, url, options) {
+    let timer;
+    const timeoutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error('网页抓取超时（30s）')), FETCH_TIMEOUT_MS);
+    });
+    try {
+        return await Promise.race([provider.fetch(url, options), timeoutPromise]);
+    }
+    catch (err) {
+        // 抓取失败不抛异常，返回降级提示页
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            url,
+            title: '网页抓取暂不可用',
+            content: `抓取失败：${message}。请稍后重试，或检查网络连接。`,
+        };
+    }
+    finally {
+        // 成功/失败均清理超时定时器，防残留定时器拖住进程
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=webFetchProvider.js.map

package/dist/web-fetch/webFetchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webFetchProvider.js","sourceRoot":"","sources":["../../src/web-fetch/webFetchProvider.ts"],"names":[],"mappings":"AAMA,mBAAmB;AACnB,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAwB,EACxB,GAAW,EACX,OAAsB;IAEtB,IAAI,KAAgD,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAc,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC5D,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mBAAmB;QACnB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,GAAG;YACH,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,QAAQ,OAAO,iBAAiB;SAC1C,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,2BAA2B;QAC3B,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * 基于 fetch 的默认网络搜索实现（FetchWebSearchProvider）
+ * 多后端降级链：Bing（国内可达，首选）→ DuckDuckGo（备用），各端点独立超时，失败/空结果时降级到下一端点。
+ * 使用 Node.js 18+ 内置 fetch，零依赖。仅用于"开箱即用"场景，生产环境建议宿主实现 IWebSearchProvider 用专用搜索 API。
+ */
+import type { IWebSearchProvider, SearchResult, WebSearchOptions, SearchEndpoint } from '../web-search/types.js';
+/** 可切换的内置搜索引擎名（宿主设置 memora.searchEngine 对应枚举） */
+export type SearchEngineName = 'bing' | 'duckduckgo' | 'baidu' | 'sogou';
+/**
+ * 构建搜索端点降级链：入参为「内核预设名（SearchEngineName）| 宿主自定义 SearchEndpoint」混排，
+ * 按给定顺序组装；宿主传入的自定义端点优先生效，未知预设名忽略。
+ * 全部无效 / 空列表回退默认链（Bing→DuckDuckGo），保证零配置也开箱可用。
+ * 主推宿主接入：生产环境建议宿主自建 SearchEndpoint[]（自带 URL+解析）注入，内核预设仅作保底。
+ */
+export declare function buildSearchEndpoints(items: readonly (SearchEngineName | SearchEndpoint)[]): readonly SearchEndpoint[];
+/** 默认搜索实现：多后端降级链（Bing → DuckDuckGo），每端点独立超时。生产建议宿主自定义 IWebSearchProvider */
+export declare class FetchWebSearchProvider implements IWebSearchProvider {
+    /** 端点降级链（可注入替换，测试与宿主定制用） */
+    private readonly endpoints;
+    constructor(endpoints?: readonly SearchEndpoint[]);
+    /**
+     * 搜索互联网，返回结构化结果。依次尝试各端点，非空结果即成功；
+     * 若某个端点成功响应但无命中视为"无结果"，全部失败（网络/HTTP 错误）时抛聚合错误，由 safeSearch 降级。
+     */
+    search(query: string, options?: WebSearchOptions): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=fetchWebSearchProvider.d.ts.map

package/dist/web-search/fetchWebSearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWebSearchProvider.d.ts","sourceRoot":"","sources":["../../src/web-search/fetchWebSearchProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAyH/B,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC;AAoCzE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,CAAC,gBAAgB,GAAG,cAAc,CAAC,EAAE,GACpD,SAAS,cAAc,EAAE,CAO3B;AAED,4EAA4E;AAC5E,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;gBAE1C,SAAS,GAAE,SAAS,cAAc,EAAsB;IAIpE;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAuCjF"}

package/dist/web-search/fetchWebSearchProvider.js

@@ -0,0 +1,199 @@
+import { BROWSER_UA, fetchWithTimeout } from '../utils/http.js';
+/** 单端点请求超时（ms）：Bing 通常 1-2s 返回，10s 覆盖慢网络且不至于拖死主循环 */
+const ENDPOINT_TIMEOUT_MS = 10_000;
+/**
+ * 从 Bing 结果页 HTML 提取结果：标题+链接在 <h2><a>，摘要在 <p class="b_lineclamp*">。
+ * 用正则而非 DOM 解析，避免引入 jsdom 依赖。
+ */
+function parseBingHtml(html, limit) {
+    const results = [];
+    const titleRegex = /<h2[^>]*><a[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a><\/h2>/g;
+    const snippetRegex = /<p[^>]*class="b_lineclamp[^"]*"[^>]*>([\s\S]*?)<\/p>/g;
+    const titles = [];
+    let match;
+    while ((match = titleRegex.exec(html)) !== null && titles.length < limit) {
+        const url = match[1].replace(/&amp;/g, '&').trim();
+        const title = match[2].replace(/<[^>]*>/g, '').trim();
+        if (title && url) {
+            titles.push({ url, title });
+        }
+    }
+    const snippets = [];
+    while ((match = snippetRegex.exec(html)) !== null && snippets.length < limit) {
+        const snippet = match[1].replace(/<[^>]*>/g, '').trim();
+        if (snippet)
+            snippets.push(snippet);
+    }
+    for (let i = 0; i < Math.min(titles.length, limit); i++) {
+        results.push({
+            title: titles[i].title,
+            url: titles[i].url,
+            snippet: snippets[i] ?? '',
+        });
+    }
+    return results;
+}
+/**
+ * 从 DuckDuckGo HTML 响应提取结果：标题/链接在 <a class="result__a">，摘要在 <a class="result__snippet">。
+ */
+function parseDuckDuckGoHtml(html, limit) {
+    const results = [];
+    const resultRegex = /<a[^>]*class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/g;
+    const snippetRegex = /<a[^>]*class="result__snippet"[^>]*>([\s\S]*?)<\/a>/g;
+    const titles = [];
+    let match;
+    while ((match = resultRegex.exec(html)) !== null && titles.length < limit) {
+        const url = match[1].replace(/\/\/duckduckgo\.com\/l\/\?uddg=/, ''); // 解码跳转链接（两条 URL 前缀指向同一处）
+        const title = match[2].replace(/<[^>]*>/g, '').trim();
+        if (title && url) {
+            titles.push({
+                url: decodeURIComponent(url),
+                title,
+            });
+        }
+    }
+    const snippets = [];
+    while ((match = snippetRegex.exec(html)) !== null && snippets.length < limit) {
+        const snippet = match[1].replace(/<[^>]*>/g, '').trim();
+        if (snippet)
+            snippets.push(snippet);
+    }
+    for (let i = 0; i < Math.min(titles.length, limit); i++) {
+        results.push({
+            title: titles[i].title,
+            url: titles[i].url,
+            snippet: snippets[i] ?? '',
+        });
+    }
+    return results;
+}
+/**
+ * 百度搜索结果页 HTML 解析（中文场景命中质量通常优于 Bing 抓取）。
+ * 结构：结果条目 h3[class*=c-title] 内 <a href>，摘要取紧随的 content-right / c-abstract 块。
+ * 反爬时页面无结果结构 → 返回空数组，由降级链自动切换下一点端。
+ */
+function parseBaiduHtml(html, limit) {
+    const results = [];
+    const itemRegex = /<h3[^>]*>[\s\S]*?<a[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?<\/h3>/gi;
+    let match;
+    while ((match = itemRegex.exec(html)) !== null && results.length < limit) {
+        const url = match[1].replace(/&amp;/g, '&').trim();
+        const title = match[2].replace(/<[^>]*>/g, '').trim();
+        if (!url || !title)
+            continue;
+        // 摘要：标题块之后 800 字符范围内取首个内容摘要块（新版 content-right / 旧版 c-abstract）
+        const after = html.slice(match.index + match[0].length, match.index + match[0].length + 800);
+        const snipMatch = /(?:content-right|c-abstract)[^>]*>([\s\S]*?)<\/span>/i.exec(after);
+        const snippet = snipMatch?.[1]?.replace(/<[^>]*>/g, '').trim() ?? '';
+        results.push({ title, url, snippet });
+    }
+    return results;
+}
+/**
+ * 搜狗搜索结果页 HTML 解析。结构：div.vrwrap > h3.vr-title > a[href]，摘要 .str_info / .space-txt。
+ */
+function parseSogouHtml(html, limit) {
+    const results = [];
+    const itemRegex = /<h3[^>]*>[\s\S]*?<a[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?<\/h3>/gi;
+    let match;
+    while ((match = itemRegex.exec(html)) !== null && results.length < limit) {
+        const url = match[1].replace(/&amp;/g, '&').trim();
+        const title = match[2].replace(/<[^>]*>/g, '').trim();
+        if (!url || !title)
+            continue;
+        const after = html.slice(match.index + match[0].length, match.index + match[0].length + 800);
+        const snipMatch = /(?:str_info|space-txt)[^>]*>([\s\S]*?)<\/(?:div|p)>/i.exec(after);
+        const snippet = snipMatch?.[1]?.replace(/<[^>]*>/g, '').trim() ?? '';
+        results.push({ title, url, snippet });
+    }
+    return results;
+}
+/**
+ * 内置端点注册表（零配置保底基线，非真理源）：端点名 → 定义。
+ * FetchWebSearchProvider 默认链与 buildSearchEndpoints 的预设名均取自此处；
+ * 宿主可传入自定义 SearchEndpoint 覆盖/扩展，无需改这里。
+ */
+const SEARCH_ENDPOINT_REGISTRY = {
+    bing: {
+        name: 'Bing',
+        buildUrl: (query) => `https://www.bing.com/search?q=${encodeURIComponent(query)}`,
+        parse: parseBingHtml,
+    },
+    duckduckgo: {
+        name: 'DuckDuckGo',
+        buildUrl: (query) => `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`,
+        parse: parseDuckDuckGoHtml,
+    },
+    baidu: {
+        name: 'Baidu',
+        buildUrl: (query) => `https://www.baidu.com/s?wd=${encodeURIComponent(query)}`,
+        parse: parseBaiduHtml,
+    },
+    sogou: {
+        name: 'Sogou',
+        buildUrl: (query) => `https://www.sogou.com/web?query=${encodeURIComponent(query)}`,
+        parse: parseSogouHtml,
+    },
+};
+/** 默认端点降级链：Bing（国内可达）→ DuckDuckGo（备用） */
+const DEFAULT_ENDPOINTS = [
+    SEARCH_ENDPOINT_REGISTRY.bing,
+    SEARCH_ENDPOINT_REGISTRY.duckduckgo,
+];
+/**
+ * 构建搜索端点降级链：入参为「内核预设名（SearchEngineName）| 宿主自定义 SearchEndpoint」混排，
+ * 按给定顺序组装；宿主传入的自定义端点优先生效，未知预设名忽略。
+ * 全部无效 / 空列表回退默认链（Bing→DuckDuckGo），保证零配置也开箱可用。
+ * 主推宿主接入：生产环境建议宿主自建 SearchEndpoint[]（自带 URL+解析）注入，内核预设仅作保底。
+ */
+export function buildSearchEndpoints(items) {
+    const picked = items
+        .map((item) => typeof item === 'string' ? SEARCH_ENDPOINT_REGISTRY[item] : item)
+        .filter((e) => e !== undefined && e !== null);
+    return picked.length > 0 ? picked : DEFAULT_ENDPOINTS;
+}
+/** 默认搜索实现：多后端降级链（Bing → DuckDuckGo），每端点独立超时。生产建议宿主自定义 IWebSearchProvider */
+export class FetchWebSearchProvider {
+    /** 端点降级链（可注入替换，测试与宿主定制用） */
+    endpoints;
+    constructor(endpoints = DEFAULT_ENDPOINTS) {
+        this.endpoints = endpoints;
+    }
+    /**
+     * 搜索互联网，返回结构化结果。依次尝试各端点，非空结果即成功；
+     * 若某个端点成功响应但无命中视为"无结果"，全部失败（网络/HTTP 错误）时抛聚合错误，由 safeSearch 降级。
+     */
+    async search(query, options) {
+        const limit = options?.limit ?? 5;
+        const errors = [];
+        // 是否有端点成功响应（HTTP ok）——区分「无命中」与「全部失败」
+        let anyOk = false;
+        for (const endpoint of this.endpoints) {
+            try {
+                const response = await fetchWithTimeout(endpoint.buildUrl(query), ENDPOINT_TIMEOUT_MS, BROWSER_UA);
+                if (!response.ok) {
+                    errors.push(`${endpoint.name}: HTTP ${response.status} ${response.statusText}`);
+                    continue;
+                }
+                anyOk = true;
+                const html = await response.text();
+                const results = endpoint.parse(html, limit);
+                // 空结果（该端点无命中）继续尝试下一端点
+                if (results.length > 0) {
+                    // 打标实际服务的后端名称，供降级透出：同批次结果来自同一端点
+                    return results.map((r) => ({ ...r, endpoint: endpoint.name }));
+                }
+            }
+            catch (err) {
+                errors.push(`${endpoint.name}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // 至少一个端点成功响应但均无命中 → 搜索成功、无结果（非失败，safeSearch 不降级提示）
+        if (anyOk) {
+            return [];
+        }
+        // 全部失败 → 抛聚合错误，由 safeSearch 降级为友好提示
+        throw new Error(`所有搜索端点均失败：${errors.join('；')}`);
+    }
+}
+//# sourceMappingURL=fetchWebSearchProvider.js.map

package/dist/web-search/fetchWebSearchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWebSearchProvider.js","sourceRoot":"","sources":["../../src/web-search/fetchWebSearchProvider.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,qDAAqD;AACrD,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAY,EAAE,KAAa;IAChD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,4DAA4D,CAAC;IAChF,MAAM,YAAY,GAAG,uDAAuD,CAAC;IAE7E,MAAM,MAAM,GAA0C,EAAE,CAAC;IACzD,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QAC7E,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,KAAK;YACvB,GAAG,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,GAAG;YACnB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAAY,EAAE,KAAa;IACtD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,WAAW,GAAG,mEAAmE,CAAC;IACxF,MAAM,YAAY,GAAG,sDAAsD,CAAC;IAE5E,MAAM,MAAM,GAA0C,EAAE,CAAC;IACzD,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QAC1E,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC,CAAC,yBAAyB;QAC/F,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC;gBACV,GAAG,EAAE,kBAAkB,CAAC,GAAG,CAAC;gBAC5B,KAAK;aACN,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QAC7E,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,KAAK;YACvB,GAAG,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,GAAG;YACnB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,KAAa;IACjD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,6EAA6E,CAAC;IAChG,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK;YAAE,SAAS;QAC7B,+DAA+D;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAC7F,MAAM,SAAS,GAAG,uDAAuD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtF,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,KAAa;IACjD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,6EAA6E,CAAC;IAChG,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK;YAAE,SAAS;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAC7F,MAAM,SAAS,GAAG,sDAAsD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrF,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAKD;;;;GAIG;AACH,MAAM,wBAAwB,GAAuD;IACnF,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,kBAAkB,CAAC,KAAK,CAAC,EAAE;QACjF,KAAK,EAAE,aAAa;KACrB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,uCAAuC,kBAAkB,CAAC,KAAK,CAAC,EAAE;QACvF,KAAK,EAAE,mBAAmB;KAC3B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,8BAA8B,kBAAkB,CAAC,KAAK,CAAC,EAAE;QAC9E,KAAK,EAAE,cAAc;KACtB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,mCAAmC,kBAAkB,CAAC,KAAK,CAAC,EAAE;QACnF,KAAK,EAAE,cAAc;KACtB;CACF,CAAC;AAEF,yCAAyC;AACzC,MAAM,iBAAiB,GAA8B;IACnD,wBAAwB,CAAC,IAAI;IAC7B,wBAAwB,CAAC,UAAU;CACpC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAqD;IAErD,MAAM,MAAM,GAAG,KAAK;SACjB,GAAG,CAAC,CAAC,IAAI,EAA8B,EAAE,CACxC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CACjE;SACA,MAAM,CAAC,CAAC,CAAC,EAAuB,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACxD,CAAC;AAED,4EAA4E;AAC5E,MAAM,OAAO,sBAAsB;IACjC,4BAA4B;IACX,SAAS,CAA4B;IAEtD,YAAY,YAAuC,iBAAiB;QAClE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAA0B;QACpD,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,qCAAqC;QACrC,IAAI,KAAK,GAAG,KAAK,CAAC;QAElB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CACrC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EACxB,mBAAmB,EACnB,UAAU,CACX,CAAC;gBAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,UAAU,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;oBAChF,SAAS;gBACX,CAAC;gBAED,KAAK,GAAG,IAAI,CAAC;gBACb,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC5C,sBAAsB;gBACtB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,gCAAgC;oBAChC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,oCAAoC;QACpC,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

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

@@ -0,0 +1,46 @@
+/**
+ * 网络搜索提供者接口定义：让 memora 内核具备可注入的网络搜索能力。
+ * 宿主实现 IWebSearchProvider 注入自定义搜索引擎（接口注入，遵循 LlmProvider 模式；零依赖）。
+ */
+/** 单条搜索结果 */
+export interface SearchResult {
+    /** 搜索结果标题 */
+    title: string;
+    /** 搜索结果链接 */
+    url: string;
+    /** 搜索结果摘要 */
+    snippet: string;
+    /**
+     * 实际服务的搜索后端名称（如 'Bing' / 'DuckDuckGo'）。
+     * 降级发生时由 FetchWebSearchProvider 打标，供宿主/工具结果透出「已降级」提示；
+     * 可选：自定义 IWebSearchProvider 可不填（向后兼容，现有调用方忽略此字段）。
+     */
+    endpoint?: string;
+}
+/** 搜索选项 */
+export interface WebSearchOptions {
+    /** 返回结果数量上限（默认 5） */
+    limit?: number;
+}
+/**
+ * 搜索端点契约：名称 + URL 构造 + HTML 解析。
+ * 宿主可构造自己的 SearchEndpoint 注入 FetchWebSearchProvider / buildSearchEndpoints，
+ * 内核内置 SEARCH_ENDPOINT_REGISTRY 仅作零配置保底基线（非真理源）。
+ */
+export interface SearchEndpoint {
+    /** 端点名称（降级打标 / 结果透出用） */
+    name: string;
+    /** 由查询构造请求 URL */
+    buildUrl(query: string): string;
+    /** 从结果页 HTML 解析出结构化结果 */
+    parse(html: string, limit: number): SearchResult[];
+}
+/**
+ * 网络搜索提供者接口：宿主实现并注入 AgentOptions.webSearchProvider 提供搜索能力；
+ * 未注入时 Agent 不会暴露 web_search 工具给 LLM。
+ */
+export interface IWebSearchProvider {
+    /** 搜索互联网，返回结构化结果列表 */
+    search(query: string, options?: WebSearchOptions): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/web-search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web-search/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,WAAW;AACX,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,yBAAyB;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC5E"}

package/dist/web-search/types.js

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

package/dist/{persona → web-search}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/persona/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web-search/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,10 @@
+/**
+ * 网络搜索集成入口：提供带超时保护的加载包装，组合默认实现或宿主自定义实现。
+ * 搜索失败时降级返回友好错误信息，不中断对话流程（30s 超时防卡死 Agent 主循环）。
+ */
+import type { IWebSearchProvider, SearchResult, WebSearchOptions } from '../web-search/types.js';
+/**
+ * 带超时和错误处理的搜索包装：超时或失败时不抛异常，返回降级提示信息。
+ */
+export declare function safeSearch(provider: IWebSearchProvider, query: string, options?: WebSearchOptions): Promise<SearchResult[]>;
+//# sourceMappingURL=webSearchProvider.d.ts.map

package/dist/web-search/webSearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSearchProvider.d.ts","sourceRoot":"","sources":["../../src/web-search/webSearchProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAKhG;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAsBzB"}

package/dist/web-search/webSearchProvider.js

@@ -0,0 +1,30 @@
+/** 网络搜索超时时间（毫秒） */
+const SEARCH_TIMEOUT_MS = 30_000;
+/**
+ * 带超时和错误处理的搜索包装：超时或失败时不抛异常，返回降级提示信息。
+ */
+export async function safeSearch(provider, query, options) {
+    let timer;
+    const timeoutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error('网络搜索超时（30s）')), SEARCH_TIMEOUT_MS);
+    });
+    try {
+        return await Promise.race([provider.search(query, options), timeoutPromise]);
+    }
+    catch (err) {
+        // 搜索失败不抛异常，返回降级提示
+        const message = err instanceof Error ? err.message : String(err);
+        return [
+            {
+                title: '网络搜索暂不可用',
+                url: '',
+                snippet: `搜索失败：${message}。请稍后重试，或检查网络连接。`,
+            },
+        ];
+    }
+    finally {
+        // 成功/失败均清理超时定时器，防残留定时器拖住进程
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=webSearchProvider.js.map

package/dist/web-search/webSearchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSearchProvider.js","sourceRoot":"","sources":["../../src/web-search/webSearchProvider.ts"],"names":[],"mappings":"AAMA,mBAAmB;AACnB,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAA4B,EAC5B,KAAa,EACb,OAA0B;IAE1B,IAAI,KAAgD,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/D,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC/E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,kBAAkB;QAClB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL;gBACE,KAAK,EAAE,UAAU;gBACjB,GAAG,EAAE,EAAE;gBACP,OAAO,EAAE,QAAQ,OAAO,iBAAiB;aAC1C;SACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,2BAA2B;QAC3B,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}