@zooique/memora 4.0.0 → 5.0.0

package/dist/agent/managers/goalConsistencyChecker.js

@@ -1,178 +0,0 @@
-/**
- * 目标一致性校验器（目标版本一致性校验）。
- * 两层校验：确定性层（关键约束提取 + 文本相似度）+ LLM 层（可选，仅对需确认场景生成解释）。
- * 关键约束由确定性规则提取而非 LLM（防自我引用）。漂移等级：same(>0.7 无需确认)/confirm(0.4-0.7 建议确认)/drift(<0.4 需确认)。
- */
-/** 约束关键词单一真源：提取 pattern（全文匹配）与剥离前缀（checkConstraintsConsistent 用）共用，防双列表漂移 */
-const CONSTRAINT_KEYWORDS = [
-    '必须',
-    '不能',
-    '需要',
-    '确保',
-    '禁止',
-    '只能',
-    '至少',
-    '不允许',
-    '应当',
-    '不得',
-];
-/** 目标一致性校验器：纯函数式（无状态无副作用），SessionManager / Agent 层直接可用，不依赖外部服务 */
-export class GoalConsistencyChecker {
-    /** 提取关键约束：从目标描述中按确定性规则提取"必须/不能/需要/确保"等关键词句段（不依赖 LLM 防自我引用），去重返回 */
-    extractConstraints(goal) {
-        if (!goal || goal.trim() === '')
-            return [];
-        const constraints = [];
-        // 约束关键词匹配模式——由 CONSTRAINT_KEYWORDS 单一真源生成（全文匹配）
-        const constraintPatterns = CONSTRAINT_KEYWORDS.map((kw) => new RegExp(`${kw}[^，。！？；\n,;.!?]*`, 'g'));
-        for (const pattern of constraintPatterns) {
-            const matches = goal.match(pattern);
-            if (matches) {
-                constraints.push(...matches.map((m) => m.trim()));
-            }
-        }
-        // 去重
-        return [...new Set(constraints)];
-    }
-    /** 计算文本相似度：长文本（>20 字符）用 Jaccard，短文本用字符级 bigram（对短文本更敏感） */
-    computeSimilarity(a, b) {
-        if (!a && !b)
-            return 1;
-        if (!a || !b)
-            return 0;
-        const aTrim = a.trim();
-        const bTrim = b.trim();
-        if (aTrim === bTrim)
-            return 1;
-        // 短文本：字符级 bigram（对短文本更敏感）
-        if (aTrim.length <= 20 || bTrim.length <= 20) {
-            return this.bigramSimilarity(aTrim, bTrim);
-        }
-        // 长文本：Jaccard
-        return this.jaccardSimilarity(aTrim, bTrim);
-    }
-    /** 执行一致性校验：提取约束 → 算相似度定漂移等级（>0.7 same / >=0.4 confirm / else drift）→ 检查约束是否仍满足 */
-    checkConsistency(mainGoal, newGoal) {
-        const constraints = this.extractConstraints(mainGoal);
-        const similarity = this.computeSimilarity(mainGoal, newGoal);
-        // 确定漂移等级
-        let level;
-        if (similarity > 0.7) {
-            level = 'same';
-        }
-        else if (similarity >= 0.4) {
-            level = 'confirm';
-        }
-        else {
-            level = 'drift';
-        }
-        // 检查约束一致性
-        const { constraintsConsistent, conflictExplanation } = this.checkConstraintsConsistent(constraints, newGoal);
-        return {
-            level,
-            similarity,
-            constraints,
-            constraintsConsistent,
-            conflictExplanation,
-        };
-    }
-    /** 检查约束在新目标是否仍满足：对每条约束提取核心词，任一命中即视为满足；全不满足则标记冲突 */
-    checkConstraintsConsistent(constraints, newGoal) {
-        if (constraints.length === 0) {
-            return { constraintsConsistent: true };
-        }
-        const conflictConstraints = [];
-        for (const constraint of constraints) {
-            // 提取约束核心词并检查新目标是否包含
-            const keywords = this.extractKeywords(constraint);
-            const satisfied = keywords.some((k) => newGoal.includes(k));
-            if (!satisfied) {
-                conflictConstraints.push(constraint);
-            }
-        }
-        if (conflictConstraints.length > 0) {
-            return {
-                constraintsConsistent: false,
-                conflictExplanation: `以下约束在新目标中未体现：${conflictConstraints.join('；')}`,
-            };
-        }
-        return { constraintsConsistent: true };
-    }
-    /** 提取约束核心词：去除标记词保留核心名词短语（如"必须使用TypeScript" → "使用TypeScript"），再按分隔符切分；剥离前缀由 CONSTRAINT_KEYWORDS 生成 */
-    extractKeywords(constraint) {
-        const cleaned = constraint
-            .replace(new RegExp(`^(${CONSTRAINT_KEYWORDS.join('|')})`), '')
-            .trim();
-        const parts = cleaned.split(/[,，、\s]+/).filter(Boolean);
-        return parts.length > 0 ? parts : [cleaned];
-    }
-    /** Jaccard 相似度：分词后交集/并集。分词策略：中文字符逐字 + 英文单词 + 数字 */
-    jaccardSimilarity(a, b) {
-        const tokensA = this.tokenize(a);
-        const tokensB = this.tokenize(b);
-        if (tokensA.size === 0 && tokensB.size === 0)
-            return 1;
-        if (tokensA.size === 0 || tokensB.size === 0)
-            return 0;
-        let intersection = 0;
-        for (const token of tokensA) {
-            if (tokensB.has(token))
-                intersection++;
-        }
-        const union = tokensA.size + tokensB.size - intersection;
-        return union > 0 ? intersection / union : 0;
-    }
-    /** 字符级 bigram 相似度：拆相邻字符对求交集/并集，适用于短文本 */
-    bigramSimilarity(a, b) {
-        const bigramsA = this.getBigrams(a);
-        const bigramsB = this.getBigrams(b);
-        if (bigramsA.size === 0 && bigramsB.size === 0)
-            return 1;
-        if (bigramsA.size === 0 || bigramsB.size === 0)
-            return 0;
-        let intersection = 0;
-        for (const bigram of bigramsA) {
-            if (bigramsB.has(bigram))
-                intersection++;
-        }
-        const union = bigramsA.size + bigramsB.size - intersection;
-        return union > 0 ? intersection / union : 0;
-    }
-    /** 分词：提取中文字符（逐字，对中文更敏感）+ 英文单词（小写）+ 数字；零外部依赖 */
-    tokenize(text) {
-        const tokens = new Set();
-        // 中文字符序列（逐字作为 token）
-        const chineseChars = text.match(/[\u4e00-\u9fff\u3400-\u4dbf]+/g);
-        if (chineseChars) {
-            for (const seq of chineseChars) {
-                for (const char of seq) {
-                    tokens.add(char);
-                }
-            }
-        }
-        // 英文单词（小写归一化，大小写不敏感）
-        const englishWords = text.match(/[a-zA-Z_][a-zA-Z0-9_]*/g);
-        if (englishWords) {
-            for (const word of englishWords) {
-                tokens.add(word.toLowerCase());
-            }
-        }
-        // 数字
-        const numbers = text.match(/\d+/g);
-        if (numbers) {
-            for (const num of numbers) {
-                tokens.add(num);
-            }
-        }
-        return tokens;
-    }
-    /** 获取字符级 bigram：拆相邻字符对（如 "TypeScript" → ["Ty","yp",...]） */
-    getBigrams(text) {
-        const bigrams = new Set();
-        for (let i = 0; i < text.length - 1; i++) {
-            bigrams.add(text.slice(i, i + 2));
-        }
-        return bigrams;
-    }
-}
-//# sourceMappingURL=goalConsistencyChecker.js.map

package/dist/agent/managers/goalConsistencyChecker.js.map

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

package/dist/agent/managers/llmJudgeHelper.d.ts

@@ -1,21 +0,0 @@
-/**
- * LLM Judge 高阶辅助函数：封装"流式累积 → parseLlmJson → 判 null → 抛 configError"三件套。
- * 由 memoryInspector / memoryAdvisor 复用，消除重复。
- * 统一异常：解析失败抛 configError（MemoraError 体系）；类型参数化，调用方指定返回类型 T。
- */
-import type { LlmProvider, Message } from '../../llm/provider.js';
-/** LLM Judge 调用选项（流式 + 超时 + 取消信号） */
-export interface LlmJudgeOptions {
-    /** 流式响应最大 token 数（控制单次调用成本） */
-    maxTokens: number;
-    /** LLM 调用超时（ms），超时中止请求 */
-    timeoutMs: number;
-    /** 可选取消信号（与 timeoutMs 独立，任一触发即中止） */
-    signal?: AbortSignal;
-}
-/**
- * 调用 LLM 流式累积响应并解析为 JSON 对象 T。
- * 流式累积 → parseLlmJson（容错剥离代码块/修复错误/正则兜底）→ 解析失败抛 configError。
- */
-export declare function judgeWithLlm<T extends object>(provider: LlmProvider, messages: Message[], options: LlmJudgeOptions, errorTitle: string): Promise<T>;
-//# sourceMappingURL=llmJudgeHelper.d.ts.map

package/dist/agent/managers/llmJudgeHelper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"llmJudgeHelper.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/llmJudgeHelper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAK9D,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,EACjD,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAoBZ"}

package/dist/agent/managers/llmJudgeHelper.js

@@ -1,32 +0,0 @@
-/**
- * LLM Judge 高阶辅助函数：封装"流式累积 → parseLlmJson → 判 null → 抛 configError"三件套。
- * 由 memoryInspector / memoryAdvisor 复用，消除重复。
- * 统一异常：解析失败抛 configError（MemoraError 体系）；类型参数化，调用方指定返回类型 T。
- */
-import { parseLlmJson } from '../../utils/json.js';
-import { configError } from '../../utils/errors.js';
-import { accumulateStream } from '../../agent/managers/streamAccumulator.js';
-/**
- * 调用 LLM 流式累积响应并解析为 JSON 对象 T。
- * 流式累积 → parseLlmJson（容错剥离代码块/修复错误/正则兜底）→ 解析失败抛 configError。
- */
-export async function judgeWithLlm(provider, messages, options, errorTitle) {
-    // 流式累积 LLM 响应（复用 accumulateStream，消除重复）
-    const llmResponse = await accumulateStream(provider, messages, {
-        maxTokens: options.maxTokens,
-        temperature: 0,
-        timeoutMs: options.timeoutMs,
-        signal: options.signal,
-    });
-    // 解析 JSON，失败抛 configError（统一 MemoraError 体系）
-    const parsed = parseLlmJson(llmResponse.trim());
-    if (!parsed) {
-        throw configError(errorTitle, 'LLM 返回内容不是有效的 JSON（parseLlmJson 解析失败）', [
-            '检查 backgroundProvider 是否注入并可用',
-            '检查 LLM 模型是否输出预期的 JSON 结构',
-            '若问题持续，可降低候选数量或调整 prompt',
-        ]);
-    }
-    return parsed;
-}
-//# sourceMappingURL=llmJudgeHelper.js.map

package/dist/agent/managers/llmJudgeHelper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"llmJudgeHelper.js","sourceRoot":"","sources":["../../../src/agent/managers/llmJudgeHelper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAYzE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAqB,EACrB,QAAmB,EACnB,OAAwB,EACxB,UAAkB;IAElB,wCAAwC;IACxC,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE;QAC7D,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,6CAA6C;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,WAAW,CAAC,UAAU,EAAE,uCAAuC,EAAE;YACrE,+BAA+B;YAC/B,0BAA0B;YAC1B,yBAAyB;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/agent/managers/memoryAdvisor.d.ts

@@ -1,105 +0,0 @@
-/**
- * 记忆顾问 — sourceHealth()（源健康诊断）+ suggest()（关联推荐）+ detectConflicts()（L3 冲突检测）。
- * 纯只读分析计算，仅依赖 IMemoryStorage 不修改状态；同步返回不调 LLM。
- * L3 冲突检测：异步调 LLM 判断记忆间语义冲突，仅检测不修复（降级哪条由用户决策）。
- */
-import type { Memory } from '../../memory/types.js';
-import type { IMemoryStorage } from '../../memory/storageInterface.js';
-import type { LlmProvider } from '../../llm/provider.js';
-/** 单个 source 的事实观测指标（纯事实，不做健康等级判定） */
-export interface SourceHealthEntry {
-    source: string;
-    /** 记忆数量 */
-    count: number;
-    /** 距上次访问的天数（取该 source 中最近访问的记忆，冷记忆观测） */
-    daysSinceLastAccess: number;
-}
-/** 记忆源诊断报告（纯事实观测，不设健康等级——记忆健康由 supersede/命中体现） */
-export interface SourceHealthReport {
-    /** 各 source 事实观测 */
-    sources: SourceHealthEntry[];
-    /** 诊断时间（ISO 8601） */
-    diagnosedAt: string;
-}
-/** 关联推荐选项 */
-export interface SuggestOptions {
-    /** 返回数量上限（默认 5） */
-    limit?: number;
-    /** 排除的 source 标签（默认空数组——设定记忆已归角色包，不再参与召回排除） */
-    excludeSources?: string[];
-}
-/** 关联推荐结果 */
-export interface SuggestHit {
-    /** 记忆唯一标识（source:name 格式） */
-    id: string;
-    name: string;
-    /** 来源标签 */
-    source: string;
-    /** 推荐分数（0-1，score 退役后为纯时效 recency） */
-    relevance: number;
-    /** 内容预览（截断到 120 字符） */
-    contentPreview: string;
-    /** 推荐理由 */
-    reason: string;
-}
-/** 单对记忆的冲突判断结果 */
-export interface ConflictVerdict {
-    memoryA: Memory;
-    memoryB: Memory;
-    /** 是否存在语义冲突（true → 需用户决策降级哪条） */
-    hasConflict: boolean;
-    /** 冲突描述（hasConflict=true 时提供冲突点） */
-    conflictDescription?: string;
-    /** LLM 建议保留的记忆（'a' / 'b' / 'both'，仅供参考） */
-    recommendation?: 'a' | 'b' | 'both';
-    /** LLM 判断理由 */
-    reason: string;
-}
-/** 冲突检测报告（detectConflicts 返回值） */
-export interface ConflictReport {
-    /** 扫描的候选记忆总数 */
-    scannedCount: number;
-    /** 检测的候选对数 */
-    pairCount: number;
-    /** LLM 判定为存在冲突的对数 */
-    conflictCount: number;
-    /** 冲突详情列表（供宿主 UI 展示和用户决策） */
-    conflicts: ConflictVerdict[];
-    /** 跳过原因（LLM 不可用 / 无候选对） */
-    skippedReason?: string;
-}
-/** 记忆顾问：与 MemoryInspector 分工（Inspector 直接数据查询，Advisor 分析计算：健康诊断 + 推荐排序 + 冲突检测） */
-export declare class MemoryAdvisor {
-    private readonly index;
-    /** 后台 LLM Provider（可选，用于 L3 冲突检测，未注入时跳过） */
-    private readonly backgroundProvider;
-    /** 治理源列表（默认 GOVERNANCE_SOURCES；空治理源时推荐/冲突检测空转，测试可显式注入） */
-    private readonly sources;
-    constructor(index: IMemoryStorage, backgroundProvider?: LlmProvider | null, sources?: readonly string[]);
-    /**
-     * 记忆源健康诊断：逐 source 计算记忆数量 / 最近访问天数（纯事实观测）。
-     * 不设健康等级：记忆健康由 supersede（写时取代）/ 命中体现，
-     * 无需榜单级 status 判定（daysSinceLastAccess 作冷记忆观测）。
-     * 纯只读同步不调 LLM，用 getAllSources() 发现所有 source 标签（替代全量 search）。
-     */
-    sourceHealth(): SourceHealthReport;
-    /**
-     * 关联推荐：不调 LLM 纯计算，综合 accessedAt（时效）+ source 多样性，
-     * 返回"相关但尚未直接搜索到"的记忆。query 提供时结合搜索命中推荐，省略时基于最近使用。
-     * relevance 为纯时效（recency）
-     */
-    suggest(query?: string, options?: SuggestOptions): SuggestHit[];
-    /**
-     * 语义冲突检测：加载候选（每 source top 10）→ 同 source 两两配对（前 10 对）→ LLM 判断冲突。
-     * 仅检测不修复（不自动降级，冲突需用户决策）；LLM 失败不阻塞；provider 未注入静默跳过。
-     */
-    detectConflicts(signal?: AbortSignal): Promise<ConflictReport>;
-    /** 筛选同 source 内候选冲突对：按 source 分组两两配对，限制每 source 配对数避免 O(n²) 爆炸，总上限 10 对 */
-    private findConflictCandidates;
-    /**
-     * 调用 LLM 判断两条记忆是否冲突：结构化 JSON 输出（hasConflict+conflictDescription+recommendation+reason）。
-     * 流式累积/解析/异常封装委托 llmJudgeHelper.judgeWithLlm；失败抛 MemoraError 由调用方捕获跳过。
-     */
-    private judgeConflict;
-}
-//# sourceMappingURL=memoryAdvisor.d.ts.map

package/dist/agent/managers/memoryAdvisor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memoryAdvisor.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/memoryAdvisor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKnE,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,mBAAmB,CAAC;AA6B9D,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,cAAc,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;IACpC,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,kFAAkF;AAClF,qBAAa,aAAa;IAOtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAGzB,KAAK,EAAE,cAAc,EACtC,kBAAkB,GAAE,WAAW,GAAG,IAAW,EAC7C,OAAO,GAAE,SAAS,MAAM,EAAuB;IAQjD;;;;;OAKG;IACH,YAAY,IAAI,kBAAkB;IAsClC;;;;OAIG;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,UAAU,EAAE;IA6EnE;;;OAGG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAwEpE,2EAA2E;IAC3E,OAAO,CAAC,sBAAsB;IA+B9B;;;OAGG;YACW,aAAa;CAiC5B"}