@zooique/memora 1.0.1 → 2.0.3

package/dist/agent/types.d.ts

@@ -14,6 +14,44 @@
  *
  * error 事件：流式过程中发生错误（如 LLM 超时、连接断开），
  * 替代裸 throw 让宿主能优雅展示错误并清理 UI（避免未处理 rejection 静默卡死）。
+ *
+ * ─── agent/ 模块依赖图（最后更新：2026-07-16） ─────────────────
+ * 如需精确依赖关系，请阅读各文件 import 语句。本图仅展示高层模块关系。
+ *
+ *   agent.ts（门面，Agent 类）
+ *     ├─ assembler.ts（组件装配，init 阶段）
+ *     ├─ loop.ts（主循环，chat 阶段）
+ *     │    ├─ toolExecutor.ts（工具执行）
+ *     │    ├─ contextManager.ts（上下文窗口管理）
+ *     │    ├─ messageHistory.ts（历史消息存储）
+ *     │    ├─ guardrail.ts（护栏规则）
+ *     │    └─ tracer.ts（可观测性 span）
+ *     ├─ personaMatcher.ts（LLM 角色匹配，从 persona 迁入）
+ *     ├─ userFactExtractor.ts（用户事实提取，纯函数）
+ *     ├─ builtinToolHandlers.ts（内置工具处理器）
+ *     └─ managers/（12 个专职 Manager）
+ *          ├─ chatLockManager.ts（并发锁，token 机制）
+ *          ├─ configManager.ts（配置加载）
+ *          ├─ contextManager.ts（上下文管理）
+ *          ├─ insightExtractor.ts（LLM 提炼，prompt 独立函数）
+ *          ├─ memoryInspector.ts（记忆读写统一入口，ADR-014）
+ *          ├─ memoryDecayScheduler.ts（记忆衰减调度）
+ *          ├─ memoryAdvisor.ts（记忆建议）
+ *          ├─ relationBuilder.ts（记忆关系构建，ADR-014 侧车）
+ *          ├─ archiveCoordinator.ts（归档协调，emit archiveFailed）
+ *          ├─ sessionArchiver.ts（会话归档）
+ *          ├─ sessionManager.ts（会话状态）
+ *          ├─ textPolishManager.ts（文本润色）
+ *          ├─ autoConfigRefiner.ts（配置自动优化）
+ *          └─ workProjection.ts（作品投影）
+ *
+ * 分层依赖方向（ADR-008）：
+ *   agent/ → memory/ → storage/（不可反向）
+ *   agent/ → persona/（不可反向，persona 不调 LLM）
+ *   agent/ → llm/（provider 注入）
+ *   agent/ → skill/（技能加载）
+ *   agent/ → config/（配置加载）
+ * ──────────────────────────────────────────────────────────
  */
 /** thinking 事件的阶段标识 */
 export type ThinkingPhase = 'recalling' | 'processing' | 'archiving';
@@ -118,6 +156,15 @@ export interface UIMessages {
     guardrailWarningPrefix?: string;
     /** 输出被护栏阻断提示模板 */
     outputBlockedByGuard?: (rule: string) => string;
+    /**
+     * Reflection（反思/自修正）提示生成函数
+     *
+     * 工具调用失败且错误可重试时，在 LLM 上下文中追加此提示，帮助 LLM 聚焦于修正而非放弃。
+     *
+     * @param remaining 剩余反思次数
+     * @returns 系统消息内容
+     */
+    reflectionHint?: (remaining: number) => string;
 }
 /**
  * Agent 归档模式三态控制
@@ -132,4 +179,90 @@ export interface UIMessages {
  * 归档行为保持一致——`insights-only` 下都自动，`manual` 下都需手动。
  */
 export type ArchiveMode = 'full' | 'insights-only' | 'manual';
+import type { LlmProvider } from '../llm/provider.js';
+import type { IVectorStore } from '../memory/vectorStore.js';
+import type { IMemoryStorage } from '../memory/storageInterface.js';
+import type { IMemoryRelationStore } from '../memory/relationStore.js';
+import type { ISessionStore } from '../memory/sessionStore.js';
+import type { ITracer } from '../agent/tracer.js';
+import type { ProjectContext } from '../memory/projectManager.js';
+/** Agent 构造选项 */
+export interface AgentOptions {
+    /** 项目路径（必须） */
+    projectPath: string;
+    /** 前台 LLM Provider（必须，宿主负责创建） */
+    provider: LlmProvider;
+    /** 后台 LLM Provider（可选，用于投影等后台操作，不配时复用前台） */
+    backgroundProvider?: LlmProvider;
+    /** 配置目录（personas/rules/skills） */
+    configDir?: string;
+    /** 记忆数据目录（由宿主显式注入） */
+    dataDir?: string;
+    /** 项目注册表目录（默认与 dataDir 相同）。设为用户级路径可避免每项目重复存储 */
+    registryDir?: string;
+    /** 最大上下文 token 数（默认 120000） */
+    maxContextTokens?: number;
+    /** 默认角色名 */
+    persona?: string;
+    /** 安全权限 */
+    permission?: 'owner' | 'guest';
+    /** 允许的路径白名单 */
+    allowedPaths?: string[];
+    /** 写入确认 */
+    confirmWrites?: boolean;
+    /** 向量存储（可选，提供时启用语义搜索召回；宿主可注入任意 IVectorStore 实现） */
+    vectorStore?: IVectorStore;
+    /** 召回时排除的 source 标签（默认 ['persona', 'rule', 'skill']，这些已由 bootstrap 注入） */
+    recallExcludeSources?: string[];
+    /** 外部注入的存储实例（可选，不传则内部创建 InMemoryStorage） */
+    storage?: IMemoryStorage;
+    /** 外部注入的记忆关系存储（可选，ADR-014 侧车模型，不传则跳过关系构建） */
+    relationStore?: IMemoryRelationStore;
+    /** 外部注入的会话存储（可选，不传则仅在内存中保存） */
+    sessionStore?: ISessionStore;
+    /** 可观测性 Tracer（可选，不传则使用 NoopTracer 静默丢弃所有 span） */
+    tracer?: ITracer;
+    /** 宿主可覆盖的 UI 消息文本（默认英文，宿主覆盖为中文等） */
+    messages?: UIMessages;
+    /** 上下文超限时是否自动生成摘要（默认 true，开启后首次截断时增加 ~1-2s 延迟） */
+    enableContextSummary?: boolean;
+    /**
+     * 归档模式（ADR-015，默认 'full'）
+     *
+     * - 'full'：profile facts + insight 自动归档（对话原始内容待会话归档实现后自动）
+     * - 'insights-only'：profile facts + insight 自动归档，对话原始内容需手动
+     * - 'manual'：所有归档都需手动触发
+     */
+    archiveMode?: ArchiveMode;
+}
+/** Agent 初始化后暴露的运行时上下文 */
+export type AgentContext = ProjectContext;
+/** Agent 项目条目（来自 ProjectManager 注册表） */
+export interface AgentProjectEntry {
+    name: string;
+    path: string;
+    lastOpened: string;
+}
+/** Agent 内部配置（构造参数分组） */
+export interface AgentConfig {
+    dataDir: string;
+    registryDir: string | undefined;
+    maxContextTokens: number;
+    personaName: string | undefined;
+    permission: 'owner' | 'guest';
+    allowedPaths: string[];
+    confirmWrites: boolean;
+    vectorStore: IVectorStore | undefined;
+    recallExcludeSources: string[];
+    storage: IMemoryStorage | undefined;
+    relationStore: IMemoryRelationStore | undefined;
+    sessionStore: ISessionStore | undefined;
+    projectPath: string;
+    configDir: string | undefined;
+    tracer: ITracer | undefined;
+    messages: UIMessages | undefined;
+    enableContextSummary: boolean;
+    /** 归档模式（ADR-015，默认 'full'） */
+    archiveMode: ArchiveMode;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/agent/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,uBAAuB;AACvB,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,qBAAqB,EAAE,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC1C;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GACD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAIrB;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,yCAAyC;IACzC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,uCAAuC;IACvC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB;IAClB,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD;AAID;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,eAAe,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"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"}

package/dist/agent/types.js

@@ -14,6 +14,44 @@
  *
  * error 事件：流式过程中发生错误（如 LLM 超时、连接断开），
  * 替代裸 throw 让宿主能优雅展示错误并清理 UI（避免未处理 rejection 静默卡死）。
+ *
+ * ─── agent/ 模块依赖图（最后更新：2026-07-16） ─────────────────
+ * 如需精确依赖关系，请阅读各文件 import 语句。本图仅展示高层模块关系。
+ *
+ *   agent.ts（门面，Agent 类）
+ *     ├─ assembler.ts（组件装配，init 阶段）
+ *     ├─ loop.ts（主循环，chat 阶段）
+ *     │    ├─ toolExecutor.ts（工具执行）
+ *     │    ├─ contextManager.ts（上下文窗口管理）
+ *     │    ├─ messageHistory.ts（历史消息存储）
+ *     │    ├─ guardrail.ts（护栏规则）
+ *     │    └─ tracer.ts（可观测性 span）
+ *     ├─ personaMatcher.ts（LLM 角色匹配，从 persona 迁入）
+ *     ├─ userFactExtractor.ts（用户事实提取，纯函数）
+ *     ├─ builtinToolHandlers.ts（内置工具处理器）
+ *     └─ managers/（12 个专职 Manager）
+ *          ├─ chatLockManager.ts（并发锁，token 机制）
+ *          ├─ configManager.ts（配置加载）
+ *          ├─ contextManager.ts（上下文管理）
+ *          ├─ insightExtractor.ts（LLM 提炼，prompt 独立函数）
+ *          ├─ memoryInspector.ts（记忆读写统一入口，ADR-014）
+ *          ├─ memoryDecayScheduler.ts（记忆衰减调度）
+ *          ├─ memoryAdvisor.ts（记忆建议）
+ *          ├─ relationBuilder.ts（记忆关系构建，ADR-014 侧车）
+ *          ├─ archiveCoordinator.ts（归档协调，emit archiveFailed）
+ *          ├─ sessionArchiver.ts（会话归档）
+ *          ├─ sessionManager.ts（会话状态）
+ *          ├─ textPolishManager.ts（文本润色）
+ *          ├─ autoConfigRefiner.ts（配置自动优化）
+ *          └─ workProjection.ts（作品投影）
+ *
+ * 分层依赖方向（ADR-008）：
+ *   agent/ → memory/ → storage/（不可反向）
+ *   agent/ → persona/（不可反向，persona 不调 LLM）
+ *   agent/ → llm/（provider 注入）
+ *   agent/ → skill/（技能加载）
+ *   agent/ → config/（配置加载）
+ * ──────────────────────────────────────────────────────────
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG"}

package/dist/agent/userFactExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"userFactExtractor.d.ts","sourceRoot":"","sources":["../../src/agent/userFactExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAgFlF"}
+{"version":3,"file":"userFactExtractor.d.ts","sourceRoot":"","sources":["../../src/agent/userFactExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAuFlF"}

package/dist/agent/userFactExtractor.js

@@ -17,6 +17,8 @@ export function extractUserFacts(input, turnIndex) {
     if (identityMatch) {
         facts.push({
             category: 'identity',
+            // 显式 fieldName，冲突检测基于 category + fieldName
+            fieldName: '姓名',
             value: `姓名: ${identityMatch[1]}`,
             sourceTurn: turnIndex,
             confidence: 0.95,
@@ -27,6 +29,7 @@ export function extractUserFacts(input, turnIndex) {
     if (locationMatch) {
         facts.push({
             category: 'identity',
+            fieldName: '住址',
             value: `住址: ${locationMatch[1]}`,
             sourceTurn: turnIndex,
             confidence: 0.9,
@@ -38,6 +41,7 @@ export function extractUserFacts(input, turnIndex) {
         // 避免与 identityMatch 重复
         facts.push({
             category: 'identity',
+            fieldName: '职业',
             value: `职业: ${jobMatch[1]}`,
             sourceTurn: turnIndex,
             confidence: 0.85,
@@ -49,6 +53,7 @@ export function extractUserFacts(input, turnIndex) {
     if (prefMatch) {
         facts.push({
             category: 'preference',
+            fieldName: '偏好',
             value: `偏好: ${prefMatch[1]}`,
             sourceTurn: turnIndex,
             confidence: 0.85,
@@ -60,6 +65,7 @@ export function extractUserFacts(input, turnIndex) {
     if (toolMatch && !prefMatch) {
         facts.push({
             category: 'preference',
+            fieldName: '工具',
             value: `工具: ${toolMatch[1]}`,
             sourceTurn: turnIndex,
             confidence: 0.8,
@@ -71,6 +77,7 @@ export function extractUserFacts(input, turnIndex) {
     if (expertiseMatch) {
         facts.push({
             category: 'expertise',
+            fieldName: '专长',
             value: `专长: ${expertiseMatch[1]}`,
             sourceTurn: turnIndex,
             confidence: 0.75,

package/dist/agent/userFactExtractor.js.map

@@ -1 +1 @@
-{"version":3,"file":"userFactExtractor.js","sourceRoot":"","sources":["../../src/agent/userFactExtractor.ts"],"names":[],"mappings":"AAeA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IAC/D,MAAM,KAAK,GAAoB,EAAE,CAAC;IAElC,kBAAkB;IAClB,0BAA0B;IAC1B,uCAAuC;IACzC,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAChF,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE;YAChC,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7E,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE;YAChC,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAC1B,4DAA4D,CAC7D,CAAC;IACF,IAAI,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;QAC/B,uBAAuB;QACvB,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE;YAC3B,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,qCAAqC;IACrC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAC3B,wEAAwE,CACzE,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE;YAC5B,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;IACrB,6BAA6B;IAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3E,IAAI,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE;YAC5B,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB;IACnB,qBAAqB;IACrB,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACjF,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE;YACjC,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"userFactExtractor.js","sourceRoot":"","sources":["../../src/agent/userFactExtractor.ts"],"names":[],"mappings":"AAeA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IAC/D,MAAM,KAAK,GAAoB,EAAE,CAAC;IAElC,kBAAkB;IAClB,0BAA0B;IAC1B,uCAAuC;IACzC,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAChF,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,UAAU;YACpB,2CAA2C;YAC3C,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE;YAChC,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7E,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE;YAChC,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAC1B,4DAA4D,CAC7D,CAAC;IACF,IAAI,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;QAC/B,uBAAuB;QACvB,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE;YAC3B,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,qCAAqC;IACrC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAC3B,wEAAwE,CACzE,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE;YAC5B,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;IACrB,6BAA6B;IAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3E,IAAI,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE;YAC5B,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB;IACnB,qBAAqB;IACrB,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACjF,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ,EAAE,WAAW;YACrB,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE;YACjC,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/config/loader.d.ts

@@ -1,246 +1,134 @@
-import { z } from 'zod';
-declare const ConfigSchema: z.ZodObject<{
-    llm: z.ZodDefault<z.ZodObject<{
-        provider: z.ZodDefault<z.ZodString>;
-        model: z.ZodDefault<z.ZodString>;
-        baseUrl: z.ZodOptional<z.ZodString>;
-        apiKey: z.ZodOptional<z.ZodString>;
-        temperature: z.ZodDefault<z.ZodNumber>;
-        /**
-         * 多 Provider 映射表
-         *
-         * key 为 Provider 别名（如 "deepseek"、"openai"），value 为 Provider 配置。
-         * 配置后，旧扁平字段（provider/model/baseUrl/apiKey）被忽略。
-         * 不配置时回退到旧的单 provider 行为——完全向后兼容。
-         */
-        providers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-            provider: z.ZodString;
-            model: z.ZodString;
-            baseUrl: z.ZodOptional<z.ZodString>;
-            apiKey: z.ZodOptional<z.ZodString>;
-            /** 该 Provider 的 temperature，未配置时回退到全局 llm.temperature */
-            temperature: z.ZodOptional<z.ZodNumber>;
-            /** 该 Provider 的上下文窗口大小（token 数），未配置时回退到 memory.maxContextTokens */
-            contextWindow: z.ZodOptional<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-            contextWindow?: number | undefined;
-        }, {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-            contextWindow?: number | undefined;
-        }>>>;
-        /**
-         * 当前激活的 Provider 别名
-         *
-         * 必须与 providers 中的某个 key 一致。
-         * 不配置时默认使用 providers 的第一个 key。
-         */
-        active: z.ZodOptional<z.ZodString>;
-        /**
-         * 后台通道配置（多 Provider 路由预留）
-         *
-         * 不配时所有消费者复用前台（llm）配置——零破坏性，完全向后兼容。
-         * 配置后，归档/投影/画像等后台操作使用此通道，降低成本。
-         * 详见接入指南 §九
-         */
-        background: z.ZodOptional<z.ZodObject<{
-            provider: z.ZodString;
-            model: z.ZodString;
-            baseUrl: z.ZodOptional<z.ZodString>;
-            apiKey: z.ZodOptional<z.ZodString>;
-            temperature: z.ZodDefault<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            temperature: number;
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            baseUrl?: string | undefined;
-        }, {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        temperature: number;
-        model: string;
-        provider: string;
-        apiKey?: string | undefined;
-        active?: string | undefined;
-        baseUrl?: string | undefined;
-        providers?: Record<string, {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-            contextWindow?: number | undefined;
-        }> | undefined;
-        background?: {
-            temperature: number;
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            baseUrl?: string | undefined;
-        } | undefined;
-    }, {
-        apiKey?: string | undefined;
-        temperature?: number | undefined;
-        model?: string | undefined;
-        active?: string | undefined;
-        provider?: string | undefined;
-        baseUrl?: string | undefined;
-        providers?: Record<string, {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-            contextWindow?: number | undefined;
-        }> | undefined;
-        background?: {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-        } | undefined;
-    }>>;
-    memory: z.ZodDefault<z.ZodObject<{
-        dataDir: z.ZodDefault<z.ZodString>;
-        maxContextTokens: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        maxContextTokens: number;
-        dataDir: string;
-    }, {
-        maxContextTokens?: number | undefined;
-        dataDir?: string | undefined;
-    }>>;
-    security: z.ZodDefault<z.ZodObject<{
-        permission: z.ZodDefault<z.ZodEnum<["owner", "guest"]>>;
-        confirmWrites: z.ZodDefault<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        permission: "owner" | "guest";
-        confirmWrites: boolean;
-    }, {
-        permission?: "owner" | "guest" | undefined;
-        confirmWrites?: boolean | undefined;
-    }>>;
-    allowedPaths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    persona: z.ZodOptional<z.ZodString>;
+interface ProviderConfig {
     /**
-     * Embedding 配置（可选，配置后启用向量语义召回）
+     * Provider 标识（仅用于日志，不影响路由）
      *
-     * 复用 OpenAI 兼容协议的 /embeddings 端点。
-     * 不配置时降级为纯关键词召回（当前行为）。
+     * 宿主 UI 用此字段存储模式标识（'cloud' / 'local' / 厂商名），
+     * 内核仅作透传，不依据此字段做路由决策。
      */
-    embedding: z.ZodOptional<z.ZodObject<{
-        model: z.ZodString;
-        baseUrl: z.ZodOptional<z.ZodString>;
-        apiKey: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        model: string;
-        apiKey?: string | undefined;
-        baseUrl?: string | undefined;
-    }, {
-        model: string;
-        apiKey?: string | undefined;
-        baseUrl?: string | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    llm: {
-        temperature: number;
-        model: string;
-        provider: string;
-        apiKey?: string | undefined;
-        active?: string | undefined;
-        baseUrl?: string | undefined;
-        providers?: Record<string, {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-            contextWindow?: number | undefined;
-        }> | undefined;
-        background?: {
-            temperature: number;
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            baseUrl?: string | undefined;
-        } | undefined;
-    };
-    security: {
-        permission: "owner" | "guest";
-        confirmWrites: boolean;
-    };
-    memory: {
-        maxContextTokens: number;
-        dataDir: string;
-    };
+    provider: string;
+    /** 模型名称 */
+    model: string;
+    /** API 基础 URL（可选——内核不做预设回退，缺失时工厂会报错） */
+    baseUrl?: string;
+    /** API 密钥（可选，从环境变量读取。本地 LLM 如 Ollama 可为空字符串） */
+    apiKey?: string;
+    /** 该 Provider 的 temperature，未配置时回退到全局 llm.temperature */
+    temperature?: number;
+    /** 该 Provider 的上下文窗口大小（token 数），未配置时回退到 memory.maxContextTokens */
+    contextWindow?: number;
+}
+/**
+ * 后台通道配置接口（多 Provider 路由预留）
+ *
+ * 不配时所有消费者复用前台（llm）配置——零破坏性，完全向后兼容。
+ * 配置后，归档/投影/画像等后台操作使用此通道，降低成本。
+ * 详见接入指南 §九
+ */
+interface BackgroundConfig {
+    /** Provider 名称 */
+    provider: string;
+    /** 模型名称 */
+    model: string;
+    /** API 基础 URL（可选） */
+    baseUrl?: string;
+    /** API 密钥（可选，从环境变量读取） */
+    apiKey?: string;
+    /** 该通道的 temperature */
+    temperature: number;
+}
+/**
+ * LLM 配置接口
+ *
+ * provider 允许任意字符串：内核仅内置 'mock' 一种机制（用于无 API Key 的测试/降级），
+ * 其他厂商 provider（deepseek/openai/doubao 等）需宿主或用户显式配置 baseUrl + model。
+ * 详见 ADR-003（内核只提供机制，不预设厂商策略）
+ */
+interface LlmConfig {
+    /** Provider 名称 */
+    provider: string;
+    /** 模型名称 */
+    model: string;
+    /** API 基础 URL（可选） */
+    baseUrl?: string;
+    /** API 密钥（可选，从环境变量读取。本地 LLM 可为空） */
+    apiKey?: string;
+    /** 采样温度（0-2） */
+    temperature: number;
+    /**
+     * 多 Provider 映射表
+     *
+     * key 为 Provider 别名（如 "deepseek"、"openai"），value 为 Provider 配置。
+     * 配置后，旧扁平字段（provider/model/baseUrl/apiKey）被忽略。
+     * 不配置时回退到旧的单 provider 行为——完全向后兼容。
+     */
+    providers?: Record<string, ProviderConfig>;
+    /**
+     * 当前激活的 Provider 别名
+     *
+     * 必须与 providers 中的某个 key 一致。
+     * 不配置时默认使用 providers 的第一个 key。
+     */
+    active?: string;
+    /**
+     * 后台通道配置（多 Provider 路由预留）
+     *
+     * 不配时所有消费者复用前台（llm）配置——零破坏性，完全向后兼容。
+     * 配置后，归档/投影/画像等后台操作使用此通道，降低成本。
+     * 详见接入指南 §九
+     */
+    background?: BackgroundConfig;
+}
+/** 内存配置接口 */
+interface MemoryConfig {
+    /** 数据存储目录 */
+    dataDir: string;
+    /** 最大上下文 token 数 */
+    maxContextTokens: number;
+}
+/** 安全配置接口 */
+interface SecurityConfig {
+    /** 权限级别：owner（所有者）或 guest（访客） */
+    permission: 'owner' | 'guest';
+    /** 是否确认写入操作 */
+    confirmWrites: boolean;
+}
+/**
+ * Embedding 配置接口（可选，配置后启用向量语义召回）
+ *
+ * 复用 OpenAI 兼容协议的 /embeddings 端点。
+ * 不配置时降级为纯关键词召回（当前行为）。
+ */
+interface EmbeddingConfig {
+    /** Embedding 模型名称 */
+    model: string;
+    /** API 基础 URL（可选） */
+    baseUrl?: string;
+    /** API 密钥（可选，从环境变量读取） */
+    apiKey?: string;
+}
+/** 完整配置接口 */
+export interface Config {
+    /** LLM 配置 */
+    llm: LlmConfig;
+    /** 内存配置 */
+    memory: MemoryConfig;
+    /** 安全配置 */
+    security: SecurityConfig;
+    /** 允许的路径白名单（绝对路径） */
     allowedPaths: string[];
-    persona?: string | undefined;
-    embedding?: {
-        model: string;
-        apiKey?: string | undefined;
-        baseUrl?: string | undefined;
-    } | undefined;
-}, {
-    persona?: string | undefined;
-    llm?: {
-        apiKey?: string | undefined;
-        temperature?: number | undefined;
-        model?: string | undefined;
-        active?: string | undefined;
-        provider?: string | undefined;
-        baseUrl?: string | undefined;
-        providers?: Record<string, {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-            contextWindow?: number | undefined;
-        }> | undefined;
-        background?: {
-            model: string;
-            provider: string;
-            apiKey?: string | undefined;
-            temperature?: number | undefined;
-            baseUrl?: string | undefined;
-        } | undefined;
-    } | undefined;
-    security?: {
-        permission?: "owner" | "guest" | undefined;
-        confirmWrites?: boolean | undefined;
-    } | undefined;
-    memory?: {
-        maxContextTokens?: number | undefined;
-        dataDir?: string | undefined;
-    } | undefined;
-    allowedPaths?: string[] | undefined;
-    embedding?: {
-        model: string;
-        apiKey?: string | undefined;
-        baseUrl?: string | undefined;
-    } | undefined;
-}>;
-export type Config = z.infer<typeof ConfigSchema>;
+    /** 默认角色名（对应 personas/*.md） */
+    persona?: string;
+    /** Embedding 配置（可选） */
+    embedding?: EmbeddingConfig;
+}
 /**
  * 加载配置
  *
- * 单一真理源：所有默认值由 ConfigSchema 的 .default() 声明，
- * 不再维护独立的 DEFAULT_CONFIG 常量（避免两处真理源打架）。
+ * 单一真理源：所有默认值由 DEFAULT_CONFIG 声明，
+ * 不再维护独立的 schema（避免两处真理源打架）。
+ *
+ * 查找顺序：显式 configPath → 项目级 .memora/config.json → 内置默认值。
+ * 用户级配置路径由宿主通过 configPath 显式传入。
  *
  * @param configPath 显式指定的配置文件路径
  */

package/dist/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgCxB,QAAA,MAAM,YAAY;;;;;;;QASZ;;;;;;WAMG;;;;;;YA7BP,yDAAyD;;YAEzD,mEAAmE;;;;;;;;;;;;;;;;;QA6B/D;;;;;WAKG;;QAEH;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BP;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQH,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrE"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAgCA,UAAU,cAAc;IACtB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,UAAU,gBAAgB;IACxB,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,UAAU,SAAS;IAEjB,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,aAAa;AACb,UAAU,YAAY;IACpB,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,aAAa;AACb,UAAU,cAAc;IACtB,iCAAiC;IACjC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,eAAe;IACf,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,UAAU,eAAe;IACvB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,aAAa;AACb,MAAM,WAAW,MAAM;IACrB,aAAa;IACb,GAAG,EAAE,SAAS,CAAC;IACf,WAAW;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW;IACX,QAAQ,EAAE,cAAc,CAAC;IACzB,qBAAqB;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAgSD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBrE"}