@zooique/memora 2.0.3 → 3.0.0

package/dist/agent/managers/relationBuilder.js

@@ -1,192 +0,0 @@
-import { RELATION_WEIGHTS } from '../../memory/types.js';
-import { escapeLikeSnippet } from '../../memory/sourceValidation.js';
-import { logger } from '../../logging/logger.js';
-import { nowIso } from '../../utils/time.js';
-import { truncate } from '../../utils/strings.js';
-// ─── 常量 ────────────────────────────────────────────────
-/** 关系判断：召回候选记忆数量上限（top-5） */
-const RELATION_CANDIDATE_LIMIT = 5;
-/** 关系判断：候选记忆 content 注入 prompt 的截断上限（字符） */
-const RELATION_CANDIDATE_CONTENT_LIMIT = 100;
-// ─── 类 ──────────────────────────────────────────────────
-/**
- * 关系构建器
- *
- * 封装 ADR-014 记忆关系构建的全部逻辑，从 InsightExtractor 拆分。
- * relationStore 未注入时所有方法静默降级（返回空/no-op）。
- */
-export class RelationBuilder {
-    index;
-    relationStore;
-    /** 冲突检测回调（由 Agent 通过 bindOnConflict 注入，检测到 contradicts 时触发） */
-    onConflict = null;
-    /**
-     * @param index 记忆存储（用于候选召回的关键词搜索）
-     * @param relationStore 记忆关系存储（可选，未注入时所有方法静默降级）
-     */
-    constructor(index, relationStore = null) {
-        this.index = index;
-        this.relationStore = relationStore;
-    }
-    /** 关系构建是否启用（relationStore 已注入时为 true） */
-    get enabled() {
-        return this.relationStore !== null;
-    }
-    /**
-     * 绑定冲突检测回调
-     *
-     * 由 Agent.init() 在创建 InsightExtractor 后调用（与 bindGetRecentHistory 同模式），
-     * 解决 Agent 实例晚于 InsightExtractor 创建的时序循环依赖。
-     * buildRelations 检测到 contradicts 关系时调用此回调，Agent 在回调中 emit('conflictDetected')。
-     *
-     * @param fn 冲突检测回调（传入 null 可解除绑定）
-     */
-    bindOnConflict(fn) {
-        this.onConflict = fn;
-    }
-    // ─── 候选召回 + Prompt 构建 ───────────────────────────
-    /**
-     * 召回关系判断候选记忆（top-5）
-     *
-     * 用用户输入关键词搜索已有记忆，作为 LLM 关系判断的参考。
-     * 用户输入与提取出的 insight 通常相关，候选记忆也相关。
-     * relationStore 未注入时返回空数组（降级）。
-     *
-     * @param userInput 用户输入（用于关键词搜索）
-     * @returns 候选记忆列表（id + content 截断）
-     */
-    recallRelationCandidates(userInput) {
-        if (!this.relationStore)
-            return [];
-        const snippet = escapeLikeSnippet(userInput);
-        return this.index.search(snippet, RELATION_CANDIDATE_LIMIT);
-    }
-    /**
-     * 构建候选记忆列表的 prompt 片段
-     *
-     * 格式：
-     *   已有记忆（供关系判断参考）：
-     *   [1] id: xxx, content: xxx
-     *   [2] id: xxx, content: xxx
-     *
-     * @param candidates 候选记忆列表
-     * @returns prompt 片段（空候选时返回空字符串）
-     */
-    buildCandidatesPrompt(candidates) {
-        if (candidates.length === 0)
-            return '';
-        const lines = candidates.map((m, i) => {
-            const safeContent = m.content.length > RELATION_CANDIDATE_CONTENT_LIMIT
-                ? truncate(m.content, RELATION_CANDIDATE_CONTENT_LIMIT)
-                : m.content;
-            return `[${i + 1}] id: ${m.id}, content: ${safeContent}`;
-        });
-        return '\n\n已有记忆（供关系判断参考）：\n' + lines.join('\n');
-    }
-    /**
-     * 构建关系判断的 prompt 指令片段
-     *
-     * 包含 relations 字段格式说明 + 关系类型说明 + 注意事项。
-     * relationStore 未注入时返回空字符串（降级，不影响 insight 提取主流程）。
-     *
-     * @returns prompt 指令片段（relationStore 未注入时为空字符串）
-     */
-    buildRelationsPrompt() {
-        if (!this.relationStore)
-            return '';
-        return `\n\n如果提取了 insight，还需判断它与已有记忆的关系，输出 relations 字段：
-relations: [{"targetId": "已有记忆ID", "type": "contradicts|supports|follows|refines|caused|related"}]
-
-关系类型说明：
-- contradicts：矛盾（新信息与已有记忆冲突）
-- supports：支持（新信息佐证已有记忆）
-- follows：时间先后（新信息在已有记忆之后发生）
-- refines：细化/演化（新信息细化已有记忆）
-- caused：因果（新信息由已有记忆导致）
-- related：泛相关（有关但非上述类型）
-
-注意：
-- targetId 必须是上方"已有记忆"列表中的 ID
-- 无关系时输出空数组 []
-- 不增加额外 LLM 调用，在本次提取中一并完成`;
-    }
-    // ─── 关系写入 + 冲突检测 ─────────────────────────────
-    /**
-     * 构建关系（写入 IMemoryRelationStore）
-     *
-     * 解析 LLM 输出的 relations 字段，验证 targetId 在候选列表中，写入关系存储。
-     * 降级策略：relationStore 未注入/relations 为空/targetId 无效 → 跳过，不阻塞主流程。
-     *
-     * 检测到 contradicts 关系时，通过 onConflict 回调通知 Agent，
-     * Agent emit('conflictDetected') 触发宿主消费链路（ProactiveBanner 通知用户）。
-     *
-     * @param insightId 新写入的 insight ID
-     * @param insightContent 新写入的 insight 内容（用于冲突通知 UI 展示）
-     * @param relations LLM 输出的关系列表
-     * @param candidates 候选记忆列表（用于验证 targetId + 查找 targetContent）
-     */
-    buildRelations(insightId, insightContent, relations, candidates) {
-        if (!this.relationStore || relations.length === 0)
-            return;
-        const candidateIds = new Set(candidates.map((m) => m.id));
-        const candidateMap = new Map(candidates.map((m) => [m.id, m]));
-        const now = nowIso();
-        let built = 0;
-        for (const rel of relations) {
-            // 运行时类型校验（不可信的 LLM 输出）
-            if (typeof rel.targetId !== 'string' || typeof rel.type !== 'string')
-                continue;
-            // targetId 必须在候选列表中（LLM 可能输出不存在的 ID）
-            if (!candidateIds.has(rel.targetId))
-                continue;
-            this.relationStore.addRelation({
-                sourceId: insightId,
-                targetId: rel.targetId,
-                type: rel.type,
-                weight: this.weightByType(rel.type),
-                createdAt: now,
-            });
-            built++;
-            // contradicts 关系写入时，通过 onConflict 回调通知宿主
-            if (rel.type === 'contradicts' && this.onConflict) {
-                const targetMemory = candidateMap.get(rel.targetId);
-                if (targetMemory) {
-                    this.onConflict({
-                        newMemoryId: insightId,
-                        newInsight: insightContent,
-                        targetId: rel.targetId,
-                        targetContent: targetMemory.content,
-                    });
-                }
-            }
-        }
-        if (built > 0) {
-            logger.info({ insightId, built }, 'RelationBuilder: 关系构建完成');
-        }
-    }
-    // ─── 私有：工具方法 ───────────────────────────────────
-    /**
-     * 根据关系类型推断 weight（ADR-014 §4）
-     *
-     * LLM 只输出 type，weight 由代码层推断：
-     * - contradicts → 1.0（确定关系，矛盾是强关系）
-     * - supports/follows/refines/caused → 0.7（强相关）
-     * - related → 0.3（弱相关）
-     * - 未知类型 → 0.5（未判断兜底）
-     *
-     * 设计理由：降低 LLM 认知负担，离散值比连续浮点稳定
-     */
-    weightByType(type) {
-        switch (type) {
-            case 'contradicts': return RELATION_WEIGHTS.CERTAIN;
-            case 'supports':
-            case 'follows':
-            case 'refines':
-            case 'caused':
-                return RELATION_WEIGHTS.STRONG;
-            case 'related': return RELATION_WEIGHTS.WEAK;
-            default: return RELATION_WEIGHTS.UNDEFINED;
-        }
-    }
-}
-//# sourceMappingURL=relationBuilder.js.map

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

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

package/dist/agent/personaMatcher.d.ts

@@ -1,29 +0,0 @@
-/**
- * 角色语义匹配器 — LLM 辅助角色匹配（agent 层纯函数模块）
- *
- * 从 PersonaManager.matchByLlm 迁移至此，遵循 backend_layers_rules §分层职责：
- * persona/ 不直接调 LLM，agent/ 可通过 provider 接口调 LLM。
- *
- * 与 userFactExtractor.ts 同级，为 agent/ 根级纯函数模块（非有状态 Manager）。
- */
-import type { LlmProvider } from '../llm/provider.js';
-import type { Persona } from '../persona/types.js';
-/**
- * LLM 辅助语义角色匹配
- *
- * 当关键词匹配低置信度或无命中时，由 agent 层调用此函数进行语义级匹配。
- *
- * 降级策略：
- *   - LLM 调用失败/超时 → 返回 null（由调用方降级处理）
- *   - LLM 返回无效角色名 → 返回 null（防止幻觉）
- *   - LLM 返回 "none" → 返回 null（明确无匹配）
- *   - 候选列表为空（排除当前角色后） → 返回 null
- *
- * @param provider 后台 LLM Provider
- * @param personaList 完整角色列表（函数内部排除当前激活角色）
- * @param activePersonaName 当前激活角色名（排除自身，避免无意义切换）
- * @param userInput 用户输入文本
- * @returns 匹配的角色名，无匹配/失败返回 null
- */
-export declare function matchPersonaByLlm(provider: LlmProvider, personaList: Persona[], activePersonaName: string | undefined, userInput: string): Promise<string | null>;
-//# sourceMappingURL=personaMatcher.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"personaMatcher.d.ts","sourceRoot":"","sources":["../../src/agent/personaMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAMlD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,OAAO,EAAE,EACtB,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2CxB"}

package/dist/agent/personaMatcher.js

@@ -1,60 +0,0 @@
-import { logger } from '../logging/logger.js';
-/** LLM 辅助匹配的 maxTokens 上限（角色名很短，无需长响应） */
-const LLM_MATCH_MAX_TOKENS = 50;
-/**
- * LLM 辅助语义角色匹配
- *
- * 当关键词匹配低置信度或无命中时，由 agent 层调用此函数进行语义级匹配。
- *
- * 降级策略：
- *   - LLM 调用失败/超时 → 返回 null（由调用方降级处理）
- *   - LLM 返回无效角色名 → 返回 null（防止幻觉）
- *   - LLM 返回 "none" → 返回 null（明确无匹配）
- *   - 候选列表为空（排除当前角色后） → 返回 null
- *
- * @param provider 后台 LLM Provider
- * @param personaList 完整角色列表（函数内部排除当前激活角色）
- * @param activePersonaName 当前激活角色名（排除自身，避免无意义切换）
- * @param userInput 用户输入文本
- * @returns 匹配的角色名，无匹配/失败返回 null
- */
-export async function matchPersonaByLlm(provider, personaList, activePersonaName, userInput) {
-    // 排除当前激活角色（避免无意义切换）
-    const candidates = personaList.filter((p) => p.name !== activePersonaName);
-    if (candidates.length === 0)
-        return null;
-    // 构造角色列表描述（name + description/content 前缀 + keywords）
-    const personaListText = candidates
-        .map((p) => {
-        const desc = p.description ?? p.content.substring(0, 50).trim();
-        return `- ${p.name}：${desc}（关键词：${p.keywords.join(', ')}）`;
-    })
-        .join('\n');
-    try {
-        const stream = provider.chat([
-            {
-                role: 'system',
-                content: '你是角色匹配助手。根据用户输入，从以下角色中选择最匹配的一个。\n\n' +
-                    `角色列表：\n${personaListText}\n\n` +
-                    '规则：\n1. 只返回角色名，不解释\n2. 无匹配返回 "none"',
-            },
-            { role: 'user', content: userInput },
-        ], { maxTokens: LLM_MATCH_MAX_TOKENS, temperature: 0 });
-        let result = '';
-        for await (const chunk of stream) {
-            if (chunk.content)
-                result += chunk.content;
-        }
-        const trimmed = result.trim();
-        if (!trimmed || trimmed === 'none')
-            return null;
-        // 验证返回的角色名在候选列表中（防止 LLM 幻觉）
-        const matched = candidates.find((p) => p.name === trimmed);
-        return matched ? matched.name : null;
-    }
-    catch (err) {
-        logger.warn({ err }, 'LLM 辅助角色匹配失败，降级为关键词匹配');
-        return null;
-    }
-}
-//# sourceMappingURL=personaMatcher.js.map

package/dist/agent/personaMatcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"personaMatcher.js","sourceRoot":"","sources":["../../src/agent/personaMatcher.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,0CAA0C;AAC1C,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAqB,EACrB,WAAsB,EACtB,iBAAqC,EACrC,SAAiB;IAEjB,oBAAoB;IACpB,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;IAC3E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,qDAAqD;IACrD,MAAM,eAAe,GAAG,UAAU;SAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7D,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAC1B;YACE;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EACL,qCAAqC;oBACrC,UAAU,eAAe,MAAM;oBAC/B,qCAAqC;aACxC;YACD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;SACrC,EACD,EAAE,SAAS,EAAE,oBAAoB,EAAE,WAAW,EAAE,CAAC,EAAE,CACpD,CAAC;QAEF,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;QAC7C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAEhD,4BAA4B;QAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QAC3D,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,uBAAuB,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/agent/userFactExtractor.d.ts

@@ -1,25 +0,0 @@
-/**
- * 用户事实提取器 — 从对话输入中提取结构化用户画像
- *
- * 职责：
- *   - 正则 + 关键词规则提取用户身份、偏好、专长等事实
- *   - 输出结构化 ExtractedFact，供 UserProfile 归档
- *
- * 设计原则：
- *   - 语义解析属于 agent/ 层，memory/ 只做存储
- *   - 兼顾阶段一低成本需求（正则规则），后续可升级为 LLM 提取
- */
-import type { ExtractedFact } from '../memory/userProfile.js';
-export type { ExtractedFact } from '../memory/userProfile.js';
-/**
- * 从用户输入中提取事实
- *
- * 使用正则 + 关键词规则，兼顾阶段一的低成本需求。
- * 高置信度规则（≥0.9）→ 直接归档
- * 中置信度（0.7-0.8）→ 标记待确认
- *
- * @param input 用户原始输入
- * @param turnIndex 当前轮次标识
- */
-export declare function extractUserFacts(input: string, turnIndex: string): ExtractedFact[];
-//# sourceMappingURL=userFactExtractor.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,88 +0,0 @@
-/**
- * 从用户输入中提取事实
- *
- * 使用正则 + 关键词规则，兼顾阶段一的低成本需求。
- * 高置信度规则（≥0.9）→ 直接归档
- * 中置信度（0.7-0.8）→ 标记待确认
- *
- * @param input 用户原始输入
- * @param turnIndex 当前轮次标识
- */
-export function extractUserFacts(input, turnIndex) {
-    const facts = [];
-    // ── 高置信度：身份声明 ──
-    // "我叫张三" "我是张三" "我的名字是张三"
-    // 排除问句关键词（谁/哪/什/吗），防止 "我是谁" "我是哪个" 误匹配
-    const identityMatch = input.match(/我(?:叫|是|的名字是)\s*([^\s，。,\.!！?？\n谁哪什吗]{1,15})/);
-    if (identityMatch) {
-        facts.push({
-            category: 'identity',
-            // 显式 fieldName，冲突检测基于 category + fieldName
-            fieldName: '姓名',
-            value: `姓名: ${identityMatch[1]}`,
-            sourceTurn: turnIndex,
-            confidence: 0.95,
-        });
-    }
-    // "我住在北京" "我家在上海"
-    const locationMatch = input.match(/(?:我住在?|我家在)\s*([^\s，。,\.!！?？\n]{1,15})/);
-    if (locationMatch) {
-        facts.push({
-            category: 'identity',
-            fieldName: '住址',
-            value: `住址: ${locationMatch[1]}`,
-            sourceTurn: turnIndex,
-            confidence: 0.9,
-        });
-    }
-    // "我(是|当|做).*?(的)" —— 职业声明
-    const jobMatch = input.match(/我(?:是|当|做)(?:一[个名位])?\s*([^\s，。,\.!！?？\n谁哪什吗]{1,10})(?:的)?/);
-    if (jobMatch && !identityMatch) {
-        // 避免与 identityMatch 重复
-        facts.push({
-            category: 'identity',
-            fieldName: '职业',
-            value: `职业: ${jobMatch[1]}`,
-            sourceTurn: turnIndex,
-            confidence: 0.85,
-        });
-    }
-    // ── 高置信度：偏好声明 ──
-    // "我喜欢TS" "我更喜欢Python" "我习惯用VS Code"
-    const prefMatch = input.match(/(?:我(?:很|非常|最|更)?(?:喜欢|爱|习惯|偏好)(?:用|写|做|的))\s*([^\s，。,\.!！?？\n]{1,20})/);
-    if (prefMatch) {
-        facts.push({
-            category: 'preference',
-            fieldName: '偏好',
-            value: `偏好: ${prefMatch[1]}`,
-            sourceTurn: turnIndex,
-            confidence: 0.85,
-        });
-    }
-    // ── 中置信度：工具/环境声明 ──
-    // "我用VS Code" "我的环境是Windows"
-    const toolMatch = input.match(/我(?:用|使用|的环境是)\s*([^\s，。,\.!！?？\n]{1,20})/);
-    if (toolMatch && !prefMatch) {
-        facts.push({
-            category: 'preference',
-            fieldName: '工具',
-            value: `工具: ${toolMatch[1]}`,
-            sourceTurn: turnIndex,
-            confidence: 0.8,
-        });
-    }
-    // ── 较低置信度：专长声明 ──
-    // "我熟悉React" "我擅长后端"
-    const expertiseMatch = input.match(/我(?:熟悉|擅长|精通|会)\s*([^\s，。,\.!！?？\n]{1,20})/);
-    if (expertiseMatch) {
-        facts.push({
-            category: 'expertise',
-            fieldName: '专长',
-            value: `专长: ${expertiseMatch[1]}`,
-            sourceTurn: turnIndex,
-            confidence: 0.75,
-        });
-    }
-    return facts;
-}
-//# sourceMappingURL=userFactExtractor.js.map

package/dist/agent/userFactExtractor.js.map

@@ -1 +0,0 @@
-{"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/eval/evalRunner.d.ts

@@ -1,94 +0,0 @@
-/**
- * EvalRunner — Agent 行为评估执行器
- *
- * 职责：通过 createAgent 工厂构造测试条件 → 执行场景 →
- *   收集 AgentChunk → 评估结果 → 汇总报告
- *
- * 设计要点：
- *   - 每个场景创建独立 Agent（通过工厂函数），避免状态污染
- *   - 场景执行后 close()，避免资源泄漏
- *   - 错误隔离：单个场景失败不中断其他场景
- *   - 超时保护：scenarioTimeoutMs 防止卡死（Promise.race + AbortController）
- *
- * 内核零依赖约束：仅使用 memora 内部模块，不引入新依赖。
- */
-import type { Agent } from '../agent/agent.js';
-import type { EvalScenario, EvalResult } from './evalTypes.js';
-/**
- * EvalRunner 构造选项
- */
-export interface EvalRunnerOptions {
-    /**
-     * Agent 工厂函数（每个场景创建新 Agent）
-     *
-     * 工厂函数负责配置 MockProvider、guardrail 规则、预写入记忆等测试条件。
-     * EvalRunner 负责调用 init() / chat() / close() 管理 Agent 生命周期。
-     */
-    createAgent: () => Agent;
-    /**
-     * 单个场景超时_ms（默认 10000）
-     *
-     * 超时后通过 AbortController 中断 agent.chat，
-     * 返回 passed=false 的 EvalResult。
-     */
-    scenarioTimeoutMs?: number;
-}
-/**
- * 批量执行汇总报告
- */
-export interface EvalSummary {
-    /** 每个场景的评估结果（按执行顺序） */
-    results: EvalResult[];
-    /** 通过场景数 */
-    passed: number;
-    /** 失败场景数 */
-    failed: number;
-    /** 场景总数 */
-    total: number;
-    /** 执行总耗时_ms */
-    durationMs: number;
-    /** 失败场景名列表 */
-    failedScenarios: string[];
-}
-/**
- * Agent 行为评估执行器
- *
- * @example
- * ```ts
- * const runner = new EvalRunner({
- *   createAgent: () => new Agent({ projectPath, provider, configDir, dataDir, ... }),
- *   scenarioTimeoutMs: 15000,
- * });
- * const summary = await runner.runScenarios(EVAL_SCENARIOS);
- * console.log(`通过 ${summary.passed}/${summary.total}，耗时 ${summary.durationMs}ms`);
- * ```
- */
-export declare class EvalRunner {
-    #private;
-    constructor(opts: EvalRunnerOptions);
-    /**
-     * 执行单个评估场景
-     *
-     * 流程：创建 Agent → init() → chat(input) → collectAgentChunks → evaluateResult
-     *
-     * 错误隔离：任何异常（超时、Agent 抛错）都返回 passed=false 的 EvalResult，
-     * 不向上抛出，确保 runScenarios 批量执行时单个失败不中断其他场景。
-     *
-     * Agent 生命周期：每个场景执行后 close()，避免资源泄漏（try/finally 保证）。
-     *
-     * @param scenario 评估场景定义
-     * @returns 评估结果（始终返回，不抛异常）
-     */
-    runScenario(scenario: EvalScenario): Promise<EvalResult>;
-    /**
-     * 批量执行评估场景并汇总报告
-     *
-     * 顺序执行（非并行），每个场景创建独立 Agent，避免状态污染。
-     * 错误隔离：单个场景失败不中断其他场景（由 runScenario 保证）。
-     *
-     * @param scenarios 场景列表
-     * @returns 汇总报告
-     */
-    runScenarios(scenarios: readonly EvalScenario[]): Promise<EvalSummary>;
-}
-//# sourceMappingURL=evalRunner.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"evalRunner.d.ts","sourceRoot":"","sources":["../../src/eval/evalRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG/D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,KAAK,CAAC;IAEzB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAKD;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;;gBAMT,IAAI,EAAE,iBAAiB;IAKnC;;;;;;;;;;;;OAYG;IACG,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IA0B9D;;;;;;;;OAQG;IACG,YAAY,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;CA6D7E"}

package/dist/eval/evalRunner.js

@@ -1,141 +0,0 @@
-/**
- * EvalRunner — Agent 行为评估执行器
- *
- * 职责：通过 createAgent 工厂构造测试条件 → 执行场景 →
- *   收集 AgentChunk → 评估结果 → 汇总报告
- *
- * 设计要点：
- *   - 每个场景创建独立 Agent（通过工厂函数），避免状态污染
- *   - 场景执行后 close()，避免资源泄漏
- *   - 错误隔离：单个场景失败不中断其他场景
- *   - 超时保护：scenarioTimeoutMs 防止卡死（Promise.race + AbortController）
- *
- * 内核零依赖约束：仅使用 memora 内部模块，不引入新依赖。
- */
-import { collectAgentChunks, evaluateResult } from './evalTypes.js';
-/** 默认场景超时_ms */
-const DEFAULT_SCENARIO_TIMEOUT_MS = 10_000;
-/**
- * Agent 行为评估执行器
- *
- * @example
- * ```ts
- * const runner = new EvalRunner({
- *   createAgent: () => new Agent({ projectPath, provider, configDir, dataDir, ... }),
- *   scenarioTimeoutMs: 15000,
- * });
- * const summary = await runner.runScenarios(EVAL_SCENARIOS);
- * console.log(`通过 ${summary.passed}/${summary.total}，耗时 ${summary.durationMs}ms`);
- * ```
- */
-export class EvalRunner {
-    /** Agent 工厂函数 */
-    #createAgent;
-    /** 单场景超时_ms */
-    #scenarioTimeoutMs;
-    constructor(opts) {
-        this.#createAgent = opts.createAgent;
-        this.#scenarioTimeoutMs = opts.scenarioTimeoutMs ?? DEFAULT_SCENARIO_TIMEOUT_MS;
-    }
-    /**
-     * 执行单个评估场景
-     *
-     * 流程：创建 Agent → init() → chat(input) → collectAgentChunks → evaluateResult
-     *
-     * 错误隔离：任何异常（超时、Agent 抛错）都返回 passed=false 的 EvalResult，
-     * 不向上抛出，确保 runScenarios 批量执行时单个失败不中断其他场景。
-     *
-     * Agent 生命周期：每个场景执行后 close()，避免资源泄漏（try/finally 保证）。
-     *
-     * @param scenario 评估场景定义
-     * @returns 评估结果（始终返回，不抛异常）
-     */
-    async runScenario(scenario) {
-        const agent = this.#createAgent();
-        try {
-            await agent.init();
-            const collected = await this.#runWithTimeout(agent, scenario.input);
-            return evaluateResult(scenario.name, collected, scenario.expect);
-        }
-        catch (err) {
-            // 错误隔离：返回 passed=false 的 EvalResult，不向上抛出
-            return {
-                name: scenario.name,
-                passed: false,
-                collected: {
-                    toolsCalled: [],
-                    recallCount: 0,
-                    guardrailBlocked: false,
-                    done: false,
-                },
-                failures: [
-                    `场景执行异常：${err instanceof Error ? err.message : String(err)}`,
-                ],
-            };
-        }
-        finally {
-            await agent.close();
-        }
-    }
-    /**
-     * 批量执行评估场景并汇总报告
-     *
-     * 顺序执行（非并行），每个场景创建独立 Agent，避免状态污染。
-     * 错误隔离：单个场景失败不中断其他场景（由 runScenario 保证）。
-     *
-     * @param scenarios 场景列表
-     * @returns 汇总报告
-     */
-    async runScenarios(scenarios) {
-        const start = Date.now();
-        const results = [];
-        for (const scenario of scenarios) {
-            const result = await this.runScenario(scenario);
-            results.push(result);
-        }
-        const passed = results.filter((r) => r.passed).length;
-        const failed = results.length - passed;
-        return {
-            results,
-            passed,
-            failed,
-            total: results.length,
-            durationMs: Date.now() - start,
-            failedScenarios: results.filter((r) => !r.passed).map((r) => r.name),
-        };
-    }
-    /**
-     * 带超时执行单个场景的 chat
-     *
-     * 使用 Promise.race 实现超时：
-     *   - 正常完成 → 返回 collected 行为数据
-     *   - 超时 → reject Error（被 runScenario 的 catch 捕获）
-     *
-     * 超时后通过 AbortController.abort() 中断 agent.chat，
-     * 避免后台 generator 无限挂起。agent.close() 在 runScenario 的 finally 中调用，
-     * 确保即使超时后资源也被正确清理。
-     */
-    async #runWithTimeout(agent, input) {
-        const controller = new AbortController();
-        let timer;
-        const timeoutPromise = new Promise((_, reject) => {
-            timer = setTimeout(() => {
-                controller.abort();
-                reject(new Error(`场景超时（${this.#scenarioTimeoutMs}ms）`));
-            }, this.#scenarioTimeoutMs);
-        });
-        const runPromise = collectAgentChunks(agent.chat(input, controller.signal));
-        // 抑制超时后 runPromise 可能产生的 unhandled rejection
-        // （超时后 agent.chat 被 abort，collectAgentChunks 可能在后台 resolve/reject，
-        //   但 Promise.race 已通过 timeoutPromise 返回，runPromise 的结果被丢弃）
-        void runPromise.catch(() => { });
-        try {
-            return await Promise.race([runPromise, timeoutPromise]);
-        }
-        finally {
-            if (timer)
-                clearTimeout(timer);
-        }
-    }
-}
-//# sourceMappingURL=evalRunner.js.map