@zooique/memora 0.3.0 → 2.0.0

package/dist/eval/evalRunner.js.map

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

package/dist/eval/evalTypes.d.ts

@@ -62,14 +62,23 @@ export interface EvalExpectation {
      *
      * 验证召回管线是否排除了应排除的 source 类型。
      * 例如：{ 'rule': 0 } 表示不应召回 rule 类型的记忆
+     *
+     * 注意：当前 collectAgentChunks 只收集 recallCount（数量），
+     * 不收集 source 分布。此字段为未来扩展预留，当前 evaluateResult 不检查。
+     * 若需验证 source 分布，请在宿主层自行实现。
      */
     recallSources?: Record<string, number>;
     /**
-     * 护栏阻断检查
+     * 期望的召回记忆数量范围
      *
-     * 如果为 true，期望输入被护栏规则阻断
+     * 验证召回管线是否返回了预期数量的记忆。
+     * 例如：{ min: 1 } 表示应至少召回 1 条记忆；
+     *       { max: 0 } 表示不应召回任何记忆（空召回降级场景）。
      */
-    guardrailBlocked?: boolean;
+    recallCount?: {
+        min?: number;
+        max?: number;
+    };
     /**
      * 工具调用次数范围
      */
@@ -77,6 +86,27 @@ export interface EvalExpectation {
         min?: number;
         max?: number;
     };
+    /**
+     * 期望护栏是否阻断
+     *
+     * true 表示期望护栏触发阻断（输入或输出被 block）；
+     * false 表示期望护栏不阻断；
+     * undefined 表示不检查（默认）。
+     *
+     * 与 collected.guardrailBlocked 比对，后者通过结构化标志
+     * AgentChunk.guardrailBlocked 收集，而非中文文案匹配。
+     */
+    guardrailBlocked?: boolean;
+    /**
+     * 期望对话是否正常完成
+     *
+     * true 表示期望对话正常完成（收到 done chunk）；
+     * false 表示期望对话未正常完成（如被中断、出错）；
+     * undefined 表示不检查（默认）。
+     *
+     * 与 collected.done 比对。
+     */
+    done?: boolean;
 }
 /**
  * 评估结果

package/dist/eval/evalTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evalTypes.d.ts","sourceRoot":"","sources":["../../src/eval/evalTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH;;;;OAIG;IACH,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,SAAS,EAAE;QACT,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;IACF,kBAAkB;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,GAChD,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAgClC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,EAClC,MAAM,EAAE,eAAe,GACtB,UAAU,CA+CZ"}
+{"version":3,"file":"evalTypes.d.ts","sourceRoot":"","sources":["../../src/eval/evalTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH;;;;OAIG;IACH,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE7C;;OAEG;IACH,aAAa,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE/C;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,SAAS,EAAE;QACT,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;IACF,kBAAkB;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,GAChD,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAiClC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,EAClC,MAAM,EAAE,eAAe,GACtB,UAAU,CAgEZ"}

package/dist/eval/evalTypes.js

@@ -38,8 +38,9 @@ export async function collectAgentChunks(chunks) {
                 }
                 break;
             case 'text':
-                // 检查护栏阻断/警告消息
-                if (chunk.content.includes('输入被护栏规则') || chunk.content.includes('输出被护栏规则')) {
+                // 通过结构化标志判断护栏阻断（替代中文文案子串匹配）
+                // AgentChunk.text.guardrailBlocked 由 AgentLoop 在护栏 block 时显式置 true
+                if (chunk.guardrailBlocked) {
                     collected.guardrailBlocked = true;
                 }
                 break;
@@ -86,12 +87,27 @@ export function evaluateResult(name, collected, expect) {
             failures.push(`工具调用次数 ${count} > 期望最大值 ${expect.toolCallCount.max}`);
         }
     }
+    // 检查召回数量
+    if (expect.recallCount) {
+        if (expect.recallCount.min !== undefined && collected.recallCount < expect.recallCount.min) {
+            failures.push(`召回数量 ${collected.recallCount} < 期望最小值 ${expect.recallCount.min}`);
+        }
+        if (expect.recallCount.max !== undefined && collected.recallCount > expect.recallCount.max) {
+            failures.push(`召回数量 ${collected.recallCount} > 期望最大值 ${expect.recallCount.max}`);
+        }
+    }
     // 检查护栏阻断
     if (expect.guardrailBlocked !== undefined) {
         if (expect.guardrailBlocked !== collected.guardrailBlocked) {
             failures.push(`期望护栏阻断=${expect.guardrailBlocked}，实际=${collected.guardrailBlocked}`);
         }
     }
+    // 检查完成状态
+    if (expect.done !== undefined) {
+        if (expect.done !== collected.done) {
+            failures.push(`期望完成状态=${expect.done}，实际=${collected.done}`);
+        }
+    }
     return {
         name,
         passed: failures.length === 0,

package/dist/eval/evalTypes.js.map

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

package/dist/eval/scenarios.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Agent 行为评估场景库
+ *
+ * 定义标准 EvalScenario，用于 Agent 行为回归测试。
+ * 场景定义是"期望契约"——描述 Agent 在特定输入下应有的行为特征，
+ * 由 EvalRunner 负责构造条件（MockProvider 返回值 + guardrail 规则配置）执行验证。
+ *
+ * 设计原则：
+ *   - 场景通用，不耦合任何领域逻辑
+ *   - 每个场景聚焦一个验证维度，失败原因可定位
+ *   - input 是真实用户输入风格，非人造测试桩
+ *   - expect 至少定义一项检查
+ *
+ * 当前覆盖的 EvalExpectation 维度（8 个场景）：
+ *   - guardrailBlocked（场景 1, 5, 7）
+ *   - toolsCalled + toolsNotCalled（场景 2, 5）
+ *   - toolCallCount（场景 3）
+ *   - recallCount（场景 4, 8）
+ *   - done（场景 6, 7, 8）
+ *   - recalledMemories 预设（场景 4）
+ *
+ * 未覆盖 recallSources：当前 evaluateResult 不检查该字段（见 evalTypes.ts 注释），
+ * 待宿主层按需扩展。
+ */
+import type { EvalScenario } from './evalTypes.js';
+/**
+ * 评估场景集（8 个场景）
+ *
+ * 覆盖护栏阻断 / 工具调用决策 / 调用次数范围 / 召回数量 / 完成状态 / 长输入处理六个维度。
+ * EvalRunner 实现后可在 CI 中运行这些场景作为回归基线。
+ */
+export declare const EVAL_SCENARIOS: readonly EvalScenario[];
+//# sourceMappingURL=scenarios.d.ts.map

package/dist/eval/scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../../src/eval/scenarios.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EA8EjD,CAAC"}

package/dist/eval/scenarios.js

@@ -0,0 +1,109 @@
+/**
+ * Agent 行为评估场景库
+ *
+ * 定义标准 EvalScenario，用于 Agent 行为回归测试。
+ * 场景定义是"期望契约"——描述 Agent 在特定输入下应有的行为特征，
+ * 由 EvalRunner 负责构造条件（MockProvider 返回值 + guardrail 规则配置）执行验证。
+ *
+ * 设计原则：
+ *   - 场景通用，不耦合任何领域逻辑
+ *   - 每个场景聚焦一个验证维度，失败原因可定位
+ *   - input 是真实用户输入风格，非人造测试桩
+ *   - expect 至少定义一项检查
+ *
+ * 当前覆盖的 EvalExpectation 维度（8 个场景）：
+ *   - guardrailBlocked（场景 1, 5, 7）
+ *   - toolsCalled + toolsNotCalled（场景 2, 5）
+ *   - toolCallCount（场景 3）
+ *   - recallCount（场景 4, 8）
+ *   - done（场景 6, 7, 8）
+ *   - recalledMemories 预设（场景 4）
+ *
+ * 未覆盖 recallSources：当前 evaluateResult 不检查该字段（见 evalTypes.ts 注释），
+ * 待宿主层按需扩展。
+ */
+/**
+ * 评估场景集（8 个场景）
+ *
+ * 覆盖护栏阻断 / 工具调用决策 / 调用次数范围 / 召回数量 / 完成状态 / 长输入处理六个维度。
+ * EvalRunner 实现后可在 CI 中运行这些场景作为回归基线。
+ */
+export const EVAL_SCENARIOS = [
+    {
+        name: 'empty-input-guardrail',
+        description: '空输入应被输入护栏阻断（需配置匹配空白输入的 guardrail 规则）',
+        input: '',
+        expect: {
+            guardrailBlocked: true,
+        },
+    },
+    {
+        name: 'read-file-tool-call',
+        description: '用户请求读取文件时，Agent 应调用 read_file 且不调用 write_file',
+        input: '请读取 README.md 文件',
+        expect: {
+            toolsCalled: ['read_file'],
+            toolsNotCalled: ['write_file'],
+        },
+    },
+    {
+        name: 'multi-tool-call-count',
+        description: '复合请求应触发多个工具调用（读取文件 + 搜索记忆）',
+        input: '读取项目配置并搜索相关记忆',
+        expect: {
+            toolCallCount: { min: 2 },
+        },
+    },
+    {
+        name: 'recall-memory-present',
+        description: '用户提问时应有记忆召回（需预写入匹配记忆到存储）',
+        input: '根据之前的记忆，帮我回忆上次讨论的架构设计内容',
+        recalledMemories: [
+            {
+                name: '架构设计讨论',
+                content: '上次讨论了分层架构和模块解耦方案',
+                source: 'insight',
+            },
+        ],
+        expect: {
+            recallCount: { min: 1 },
+        },
+    },
+    {
+        name: 'readonly-query-guardrail',
+        description: '只读查询场景不应调用 write_file（防止误写），且不被护栏阻断',
+        input: '查询当前项目的目录结构，列出所有文件',
+        expect: {
+            toolsNotCalled: ['write_file'],
+            guardrailBlocked: false,
+        },
+    },
+    {
+        name: 'normal-completion',
+        description: '正常对话应正常完成（收到 done 事件）',
+        input: '你好，请介绍一下自己',
+        expect: {
+            done: true,
+        },
+    },
+    {
+        name: 'long-input-handling',
+        description: '较长输入应被正常处理（不触发长度限制，不崩溃，正常完成）',
+        input: '请分析以下需求文档的可行性并给出技术方案建议：\n' +
+            '系统需要支持高并发、低延迟的实时数据处理，同时保证数据一致性。'.repeat(200),
+        expect: {
+            done: true,
+            guardrailBlocked: false,
+        },
+    },
+    {
+        name: 'empty-recall-degrade',
+        description: '无匹配记忆时不应崩溃，正常完成对话（空召回降级）',
+        input: 'asdfqwerty 无意义输入不匹配任何记忆',
+        expect: {
+            recallCount: { max: 0 },
+            done: true,
+        },
+    },
+];
+//# sourceMappingURL=scenarios.js.map

package/dist/eval/scenarios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.js","sourceRoot":"","sources":["../../src/eval/scenarios.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,sCAAsC;QACnD,KAAK,EAAE,EAAE;QACT,MAAM,EAAE;YACN,gBAAgB,EAAE,IAAI;SACvB;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE,kBAAkB;QACzB,MAAM,EAAE;YACN,WAAW,EAAE,CAAC,WAAW,CAAC;YAC1B,cAAc,EAAE,CAAC,YAAY,CAAC;SAC/B;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE;YACN,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;SAC1B;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,0BAA0B;QACvC,KAAK,EAAE,yBAAyB;QAChC,gBAAgB,EAAE;YAChB;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,kBAAkB;gBAC3B,MAAM,EAAE,SAAS;aAClB;SACF;QACD,MAAM,EAAE;YACN,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;SACxB;KACF;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,qCAAqC;QAClD,KAAK,EAAE,oBAAoB;QAC3B,MAAM,EAAE;YACN,cAAc,EAAE,CAAC,YAAY,CAAC;YAC9B,gBAAgB,EAAE,KAAK;SACxB;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,uBAAuB;QACpC,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE;YACN,IAAI,EAAE,IAAI;SACX;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,8BAA8B;QAC3C,KAAK,EACH,2BAA2B;YAC3B,iCAAiC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC/C,MAAM,EAAE;YACN,IAAI,EAAE,IAAI;YACV,gBAAgB,EAAE,KAAK;SACxB;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,0BAA0B;QACvC,KAAK,EAAE,yBAAyB;QAChC,MAAM,EAAE;YACN,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;YACvB,IAAI,EAAE,IAAI;SACX;KACF;CACF,CAAC"}

package/dist/index.d.ts

@@ -1,25 +1,57 @@
 /**
  * Memora — 通用 Agent 架构（纯逻辑库）
  *
- * 零 native 依赖。宿主项目通过注入 IMemoryStorage 实现持久化。
+ * Node.js 专用纯逻辑库（零 native 编译依赖，详见 ADR-002 §定位澄清）。
+ * 宿主项目通过注入 IMemoryStorage 实现持久化。
  * CLI 由宿主项目提供（hosts/memora-sprite/）。
  *
  * 设计哲学：万物皆记忆（详见 architecture_philosophy_rules.md §1）
  * 决策追溯：详见 .trae/rules/decisions/ 下的 ADR
+ *
+ * ─── 类型依赖图 ────────────────────────────────────────────
+ *
+ * 各模块独立 types.ts，跨模块类型追踪可按以下依赖图定位：
+ *
+ *   agent/types.ts ─┬─→ llm/provider.ts (LlmProvider, ChatOptions)
+ *                   ├─→ memory/vectorStore.ts (IVectorStore, EmbeddingService)
+ *                   ├─→ memory/storageInterface.ts (IMemoryStorage)
+ *                   ├─→ memory/relationStore.ts (IMemoryRelationStore)
+ *                   ├─→ memory/sessionStore.ts (ISessionStore, SessionMessage)
+ *                   ├─→ agent/tracer.ts (ITracer, ISpan, AgentMetrics)
+ *                   └─→ memory/projectManager.ts (AgentProjectEntry)
+ *
+ *   memory/types.ts ──→ 纯类型定义（Memory, MemoryRelation, SOURCE_LABELS 等）
+ *
+ *   llm/types.ts ─────→ 纯类型定义（LlmChunk）
+ *
+ *   persona/types.ts ─→ 纯类型定义（Persona, PersonaMode）
+ *
+ *   skill/types.ts ───→ 纯类型定义（SkillEntry, SkillMatch）
+ *
+ *   eval/evalTypes.ts ─→ 纯类型定义（EvalScenario, EvalResult）
+ *
+ *   security/pathGuard.ts ─→ AuditEvent 等安全类型（与 agent/types.ts 解耦）
+ *
+ * 依赖方向（单向）：agent → memory → utils；agent → llm；agent → security
+ * 内核不反向依赖宿主，所有宿主交互通过接口注入（ADR-002 §三层架构）
  */
 export { Agent } from './agent/agent.js';
-export type { AgentChunk, ThinkingPhase, UIMessages, ArchiveMode } from './agent/types.js';
+export type { AgentChunk, ThinkingPhase, UIMessages, ArchiveMode, RecalledMemorySummary, AgentOptions, AgentContext, AgentProjectEntry } from './agent/types.js';
 export { AGENT_CONSTANTS, LOOP_CONSTANTS } from './agent/constants.js';
-export type { AgentOptions, AgentContext, AgentProjectEntry, } from './agent/agent.js';
 export { type AgentForkResult } from './agent/managers/sessionManager.js';
 export type { ToolDefinition, ToolHandler, ToolContext, WriteExtensions } from './agent/toolExecutor.js';
 export type { PersonaMode, Persona } from './persona/types.js';
 export type { MemoryKeywords } from './agent/managers/insightExtractor.js';
-export type { MemorySnapshot, WorkingMemorySnapshot, BootstrapSnapshot, ArchiveSnapshot, AgentSearchHit, AgentStats, SuggestOptions, SuggestHit, SourceHealthStatus, SourceHealthEntry, SourceHealthReport, } from './agent/managers/memoryInspector.js';
+export { RelationBuilder } from './agent/managers/relationBuilder.js';
+export type { ConflictInfo } from './agent/managers/relationBuilder.js';
+export type { MemorySnapshot, WorkingMemorySnapshot, BootstrapSnapshot, ArchiveSnapshot, AgentSearchHit, AgentStats, SuggestOptions, SuggestHit, SourceHealthStatus, SourceHealthEntry, SourceHealthReport, DedupPair, DedupVerdict, DedupVerdictSummary, DedupReport, } from './agent/managers/memoryInspector.js';
 export type { ConfigSuggestion, ConfigSuggestionHandler } from './agent/managers/configManager.js';
 export type { AutoConfigRefinerOptions } from './agent/managers/autoConfigRefiner.js';
 export type { SessionArchiveResult } from './agent/managers/sessionArchiver.js';
+export type { TimelinessVerdict, TimelinessReport } from './agent/managers/memoryDecayScheduler.js';
+export type { ConflictVerdict, ConflictReport } from './agent/managers/memoryAdvisor.js';
 export type { WorkProjectionEntry } from './agent/managers/workProjection.js';
+export type { PolishResult } from './agent/managers/textPolishManager.js';
 export { loadConfig } from './config/loader.js';
 export { createLlmProvider, createProviderFromConfig } from './llm/factory.js';
 export type { ProviderConfig } from './llm/factory.js';
@@ -32,26 +64,33 @@ export { TypedEventEmitter } from './utils/eventEmitter.js';
 export type { AgentEventMap, AgentEventName, AgentEventHandler } from './utils/eventEmitter.js';
 export type { ITracer, ISpan, AgentMetrics } from './agent/tracer.js';
 export { NOOP_TRACER, TRACE_SPANS } from './agent/tracer.js';
-export { SOURCE_LABELS, inferSource, escapeLike, validateSource } from './memory/types.js';
-export type { Memory, SourceValidationSeverity } from './memory/types.js';
+export { SOURCE_LABELS } from './memory/types.js';
+export type { Memory } from './memory/types.js';
+export { inferSource, escapeLike, validateSource } from './memory/sourceValidation.js';
+export type { SourceValidationSeverity } from './memory/sourceValidation.js';
 export { RELATION_TYPES, RELATION_WEIGHTS } from './memory/types.js';
 export type { MemoryRelation, RelationDirection, RelationPath, RelationNeighbor } from './memory/types.js';
 export type { IMemoryStorage } from './memory/storageInterface.js';
 export { InMemoryStorage } from './memory/inMemoryStorage.js';
 export type { IMemoryRelationStore } from './memory/relationStore.js';
 export { InMemoryRelationStore } from './memory/inMemoryRelationStore.js';
+export { ProjectRegistry } from './memory/projectRegistry.js';
+export type { ProjectEntry } from './memory/projectRegistry.js';
+export { LockManager } from './memory/lockManager.js';
 export type { UserProfileEntry, ProfileCategory, ExtractedFact } from './memory/userProfile.js';
-export { VectorStore } from './memory/vectorStore.js';
-export type { EmbeddingService } from './memory/vectorStore.js';
+export { JsonVectorStore } from './memory/vectorStore.js';
+export type { IVectorStore, EmbeddingService } from './memory/vectorStore.js';
 export { EmbeddingProvider } from './llm/embedding.js';
 export type { EmbeddingConfig, EmbeddingResult } from './llm/embedding.js';
+export type { EmbeddingOptions } from './memory/vectorStore.js';
 export type { ISessionStore, SessionMessage } from './memory/sessionStore.js';
 export type { ForkResult } from './agent/messageHistory.js';
 export { recall, extractKeywords } from './memory/recall.js';
 export type { RecallOptions } from './memory/recall.js';
 export type { ILogger } from './logging/loggerInterface.js';
 export { setLogger, logger } from './logging/logger.js';
-export { segmentText } from './utils/segmenter.js';
+export { segmentText, segmentLower } from './utils/segmenter.js';
+export { isPlainObject } from './utils/objects.js';
 export { parseFrontmatter, serializeFrontmatter } from './utils/frontmatter.js';
 export { safeSetTimeout, safeSetInterval, clearSafeTimeout, clearSafeInterval } from './utils/safeTimer.js';
 export type { SkillEntry, SkillMatch } from './skill/types.js';
@@ -61,4 +100,7 @@ export { toError } from './utils/toError.js';
 export type { ToolErrorCodeValue } from './utils/errors.js';
 export type { EvalScenario, EvalExpectation, EvalResult } from './eval/evalTypes.js';
 export { collectAgentChunks, evaluateResult } from './eval/evalTypes.js';
+export { EVAL_SCENARIOS } from './eval/scenarios.js';
+export { EvalRunner } from './eval/evalRunner.js';
+export type { EvalRunnerOptions, EvalSummary } from './eval/evalRunner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,15 +1,45 @@
 /**
  * Memora — 通用 Agent 架构（纯逻辑库）
  *
- * 零 native 依赖。宿主项目通过注入 IMemoryStorage 实现持久化。
+ * Node.js 专用纯逻辑库（零 native 编译依赖，详见 ADR-002 §定位澄清）。
+ * 宿主项目通过注入 IMemoryStorage 实现持久化。
  * CLI 由宿主项目提供（hosts/memora-sprite/）。
  *
  * 设计哲学：万物皆记忆（详见 architecture_philosophy_rules.md §1）
  * 决策追溯：详见 .trae/rules/decisions/ 下的 ADR
+ *
+ * ─── 类型依赖图 ────────────────────────────────────────────
+ *
+ * 各模块独立 types.ts，跨模块类型追踪可按以下依赖图定位：
+ *
+ *   agent/types.ts ─┬─→ llm/provider.ts (LlmProvider, ChatOptions)
+ *                   ├─→ memory/vectorStore.ts (IVectorStore, EmbeddingService)
+ *                   ├─→ memory/storageInterface.ts (IMemoryStorage)
+ *                   ├─→ memory/relationStore.ts (IMemoryRelationStore)
+ *                   ├─→ memory/sessionStore.ts (ISessionStore, SessionMessage)
+ *                   ├─→ agent/tracer.ts (ITracer, ISpan, AgentMetrics)
+ *                   └─→ memory/projectManager.ts (AgentProjectEntry)
+ *
+ *   memory/types.ts ──→ 纯类型定义（Memory, MemoryRelation, SOURCE_LABELS 等）
+ *
+ *   llm/types.ts ─────→ 纯类型定义（LlmChunk）
+ *
+ *   persona/types.ts ─→ 纯类型定义（Persona, PersonaMode）
+ *
+ *   skill/types.ts ───→ 纯类型定义（SkillEntry, SkillMatch）
+ *
+ *   eval/evalTypes.ts ─→ 纯类型定义（EvalScenario, EvalResult）
+ *
+ *   security/pathGuard.ts ─→ AuditEvent 等安全类型（与 agent/types.ts 解耦）
+ *
+ * 依赖方向（单向）：agent → memory → utils；agent → llm；agent → security
+ * 内核不反向依赖宿主，所有宿主交互通过接口注入（ADR-002 §三层架构）
  */
 // ─── 库导出：供宿主项目 import 接入 ──────────────────────
 export { Agent } from './agent/agent.js';
 export { AGENT_CONSTANTS, LOOP_CONSTANTS } from './agent/constants.js';
+// RelationBuilder 从 InsightExtractor 提取，封装 ADR-014 关系构建逻辑
+export { RelationBuilder } from './agent/managers/relationBuilder.js';
 export { loadConfig } from './config/loader.js';
 export { createLlmProvider, createProviderFromConfig } from './llm/factory.js';
 export { OpenAICompatibleProvider } from './llm/openaiCompatible.js';
@@ -17,13 +47,20 @@ export { OpenAICompatibleProvider } from './llm/openaiCompatible.js';
 export { TypedEventEmitter } from './utils/eventEmitter.js';
 export { NOOP_TRACER, TRACE_SPANS } from './agent/tracer.js';
 // ─── 记忆层导出 ──────────────────────────────────────────
-export { SOURCE_LABELS, inferSource, escapeLike, validateSource } from './memory/types.js';
+export { SOURCE_LABELS } from './memory/types.js';
+// Source 校验工具（从 types.ts 拆分到 sourceValidation.ts，公共 API 不变）
+export { inferSource, escapeLike, validateSource } from './memory/sourceValidation.js';
 // 记忆关系图谱（ADR-014 侧车模型）
 export { RELATION_TYPES, RELATION_WEIGHTS } from './memory/types.js';
 export { InMemoryStorage } from './memory/inMemoryStorage.js';
 export { InMemoryRelationStore } from './memory/inMemoryRelationStore.js';
-// 向量存储：宿主注入 EmbeddingService 后创建 VectorStore，传入 AgentOptions 启用语义搜索
-export { VectorStore } from './memory/vectorStore.js';
+// 项目注册表 + 锁文件管理（从 ProjectManager 提取）
+// 宿主可直接使用 ProjectRegistry/LockManager 管理多项目，或通过 ProjectManager 间接委托
+export { ProjectRegistry } from './memory/projectRegistry.js';
+export { LockManager } from './memory/lockManager.js';
+// 向量存储：宿主注入 EmbeddingService 后创建 JsonVectorStore，传入 AgentOptions 启用语义搜索
+// 宿主也可实现 IVectorStore 接口注入自定义向量库（如 SqliteVectorStore / LanceDBVectorStore）
+export { JsonVectorStore } from './memory/vectorStore.js';
 // Embedding Provider：OpenAI 兼容 /embeddings 端点实现（满足 EmbeddingService 接口）
 export { EmbeddingProvider } from './llm/embedding.js';
 // 召回函数：简化关键词搜索
@@ -31,8 +68,9 @@ export { recall, extractKeywords } from './memory/recall.js';
 export { setLogger, logger } from './logging/logger.js';
 // ─── 工具导出 ────────────────────────────────────────────
 // 分词工具：宿主项目（如 SqliteStorage）依赖
-// 工具导出
-export { segmentText } from './utils/segmenter.js';
+export { segmentText, segmentLower } from './utils/segmenter.js';
+// 对象类型守卫：宿主项目（如 spriteConfig）依赖，校验 JSON.parse 结果
+export { isPlainObject } from './utils/objects.js';
 // Frontmatter 解析/序列化：宿主项目（如 skillInstaller）依赖
 export { parseFrontmatter, serializeFrontmatter } from './utils/frontmatter.js';
 // 安全定时器：宿主主进程统一使用 safeSetTimeout/safeSetInterval 跟踪清理
@@ -42,4 +80,6 @@ export { MemoraError, ToolErrorCode, isRetryableErrorCode } from './utils/errors
 // toError 独立导出，浏览器端可直接 import 而不引入 logging（pino）依赖
 export { toError } from './utils/toError.js';
 export { collectAgentChunks, evaluateResult } from './eval/evalTypes.js';
+export { EVAL_SCENARIOS } from './eval/scenarios.js';
+export { EvalRunner } from './eval/evalRunner.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iDAAiD;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA8BvE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAI/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO;AACP,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAK5D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7D,uDAAuD;AACvD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE3F,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAG1E,oEAAoE;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,wEAAwE;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAMvD,eAAe;AACf,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK7D,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAExD,wDAAwD;AACxD,+BAA+B;AAC/B,OAAO;AACP,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,8CAA8C;AAC9C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAChF,sDAAsD;AACtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAc5G,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrF,mDAAmD;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAK7C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,iDAAiD;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMvE,0DAA0D;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAgCtE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAI/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO;AACP,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAK5D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7D,uDAAuD;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,4DAA4D;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEvF,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,qCAAqC;AACrC,oEAAoE;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,wEAAwE;AACxE,2EAA2E;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,wEAAwE;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAQvD,eAAe;AACf,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK7D,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAExD,wDAAwD;AACxD,+BAA+B;AAC/B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,iDAAiD;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,8CAA8C;AAC9C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAChF,sDAAsD;AACtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAc5G,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrF,mDAAmD;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAO7C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/llm/abortSignal.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AbortSignal 合并工具
+ *
+ * 从 openaiCompatible.ts 和 embedding.ts 提取的公共"外部信号 + 超时信号"合并逻辑
+ * （ADR-017 枝叶层 2 次提取原则，embedding.ts 原注释已自证"与 openaiCompatible.ts 同构"）。
+ *
+ * 确保用户取消（optsSignal）和请求超时都能中断 fetch 和流读取。
+ */
+/**
+ * 合并外部 AbortSignal + 超时 AbortSignal
+ *
+ * 创建内部 AbortController，将外部 optsSignal 和超时信号合并到其 signal 上。
+ * 返回 signal 供 fetch 使用，以及两个清理函数：
+ *   - clearTimer：只清超时定时器（流式读取前调用，保留 optsSignal 监听用于 SSE 取消）
+ *   - dispose：完整清理（清超时 + 移除 optsSignal 监听，最终清理时调用）
+ *
+ * @param optsSignal 外部传入的 AbortSignal（可选，用户取消信号）
+ * @param timeoutMs 超时毫秒数
+ * @param timeoutErrorName 超时错误名称（如 'LLM 请求超时' / 'Embedding 请求超时'）
+ * @returns { signal, clearTimer, dispose } 合并后的 signal 和清理函数
+ */
+export declare function mergeAbortSignals(optsSignal: AbortSignal | undefined, timeoutMs: number, timeoutErrorName: string): {
+    signal: AbortSignal;
+    clearTimer: () => void;
+    dispose: () => void;
+};
+//# sourceMappingURL=abortSignal.d.ts.map

package/dist/llm/abortSignal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortSignal.d.ts","sourceRoot":"","sources":["../../src/llm/abortSignal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB;IACD,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAwBA"}

package/dist/llm/abortSignal.js

@@ -0,0 +1,44 @@
+/**
+ * AbortSignal 合并工具
+ *
+ * 从 openaiCompatible.ts 和 embedding.ts 提取的公共"外部信号 + 超时信号"合并逻辑
+ * （ADR-017 枝叶层 2 次提取原则，embedding.ts 原注释已自证"与 openaiCompatible.ts 同构"）。
+ *
+ * 确保用户取消（optsSignal）和请求超时都能中断 fetch 和流读取。
+ */
+/**
+ * 合并外部 AbortSignal + 超时 AbortSignal
+ *
+ * 创建内部 AbortController，将外部 optsSignal 和超时信号合并到其 signal 上。
+ * 返回 signal 供 fetch 使用，以及两个清理函数：
+ *   - clearTimer：只清超时定时器（流式读取前调用，保留 optsSignal 监听用于 SSE 取消）
+ *   - dispose：完整清理（清超时 + 移除 optsSignal 监听，最终清理时调用）
+ *
+ * @param optsSignal 外部传入的 AbortSignal（可选，用户取消信号）
+ * @param timeoutMs 超时毫秒数
+ * @param timeoutErrorName 超时错误名称（如 'LLM 请求超时' / 'Embedding 请求超时'）
+ * @returns { signal, clearTimer, dispose } 合并后的 signal 和清理函数
+ */
+export function mergeAbortSignals(optsSignal, timeoutMs, timeoutErrorName) {
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => abortController.abort(new DOMException(timeoutErrorName, 'TimeoutError')), timeoutMs);
+    const onOptsAbort = () => abortController.abort(optsSignal?.reason);
+    if (optsSignal) {
+        if (optsSignal.aborted) {
+            abortController.abort(optsSignal.reason);
+        }
+        else {
+            optsSignal.addEventListener('abort', onOptsAbort, { once: true });
+        }
+    }
+    // 只清超时定时器（流式读取前调用，保留 optsSignal 监听用于 SSE 阶段取消）
+    const clearTimer = () => clearTimeout(timeoutId);
+    // 完整清理：清超时 + 移除 optsSignal 监听（最终清理时调用，防止监听器常驻泄漏）
+    const dispose = () => {
+        clearTimeout(timeoutId);
+        if (optsSignal)
+            optsSignal.removeEventListener('abort', onOptsAbort);
+    };
+    return { signal: abortController.signal, clearTimer, dispose };
+}
+//# sourceMappingURL=abortSignal.js.map

package/dist/llm/abortSignal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortSignal.js","sourceRoot":"","sources":["../../src/llm/abortSignal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAmC,EACnC,SAAiB,EACjB,gBAAwB;IAMxB,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,UAAU,CAC1B,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,EAC/E,SAAS,CACV,CAAC;IACF,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACjD,iDAAiD;IACjD,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,IAAI,UAAU;YAAE,UAAU,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACvE,CAAC,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjE,CAAC"}

package/dist/llm/embedding.d.ts

@@ -1,3 +1,4 @@
+import type { EmbeddingOptions } from '../memory/vectorStore.js';
 /**
  * Embedding 配置（与 OpenAICompatibleConfig 共用 baseUrl/apiKey）
  */
@@ -25,6 +26,8 @@ export declare class EmbeddingProvider {
     private readonly config;
     /** 缓存最大条目数（LRU 上限，防止无界增长导致内存泄漏） */
     private static readonly CACHE_MAX_SIZE;
+    /** 默认请求超时：60 秒（embedding 无流式推理，比 chat 的 120s 更短） */
+    private static readonly DEFAULT_TIMEOUT_MS;
     /** 本地缓存：text → vector（LRU，Map 迭代顺序 = 最近访问顺序） */
     private readonly cache;
     constructor(config: EmbeddingConfig);
@@ -40,16 +43,18 @@ export declare class EmbeddingProvider {
     /**
      * 嵌入单条文本
      * @param text 待嵌入的文本
+     * @param options 调用选项（signal 外部取消 + timeoutMs 超时）
      * @returns 向量
      */
-    embed(text: string): Promise<number[]>;
+    embed(text: string, options?: EmbeddingOptions): Promise<number[]>;
     /**
      * 批量嵌入多条文本
      * OpenAI 兼容 API 支持一次请求嵌入多条文本，减少 API 调用
      * @param texts 待嵌入的文本数组
+     * @param options 调用选项（signal 外部取消 + timeoutMs 超时）
      * @returns 嵌入结果数组（顺序与输入一致）
      */
-    batchEmbed(texts: string[]): Promise<EmbeddingResult[]>;
+    batchEmbed(texts: string[], options?: EmbeddingOptions): Promise<EmbeddingResult[]>;
     /**
      * 获取缓存大小（调试用）
      */