@zooique/memora 2.0.0 → 3.0.0

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

@@ -1,198 +0,0 @@
-/**
- * 记忆衰减调度器（从 agent.ts 拆分）
- *
- * 职责：
- *   1. 定期执行记忆 score 衰减（体现"自然遗忘"）
- *   2. 衰减指标统计（执行次数 / 累计衰减记忆数 / 上次衰减时间）
- *   3. 衰减可观测性（Tracer Span 埋点）
- *   4. 衰减完成事件发射（decayCompleted）
- *   5. L2 时效性评估（可选，backgroundProvider + index 注入后启用）
- *
- * 设计理由：
- *   agent.ts 原承担 15+ 职责，记忆衰减是独立的生命周期职责，
- *   拆分后 Agent 聚焦对话编排，MemoryDecayScheduler 聚焦记忆自然遗忘。
- *
- * 衰减范围：
- *   - insight（洞察记忆）
- *   - profile（用户画像记忆）
- *   - work-projection（作品投影）
- *   不衰减 persona/rule/skill（配置型记忆不应衰减）
- *
- * L2 时效性评估（可选增强）：
- *   - 衰减后扫描低分记忆（score < TIMELINESS_LOW_SCORE_THRESHOLD）
- *   - 调用 LLM 判断是否"已过时"（如过时的技术栈、已变更的偏好）
- *   - 过时则进一步降级（score → TIMELINESS_OUTDATED_SCORE）
- *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
- *
- * 自然生长原则：
- *   - 不持有 storage 引用（start 时注入，stop 时释放）
- *   - 通过回调发射事件（不继承 TypedEventEmitter，避免与 Agent 事件系统耦合）
- *   - 指标统计内聚（getMetrics 返回快照，Agent.getMetrics 直接合并）
- */
-import { type ITracer } from '../../agent/tracer.js';
-import type { LlmProvider } from '../../llm/provider.js';
-import type { IMemoryStorage } from '../../memory/storageInterface.js';
-/** 衰减完成的回调类型（Agent 注入 emit('decayCompleted', ...)） */
-export type DecayCompletedCallback = (payload: {
-    decayedCount: number;
-}) => void;
-/** MemoryDecayScheduler 构造选项 */
-export interface MemoryDecaySchedulerOptions {
-    /** 可观测性 Tracer（未注入时降级为 NOOP_TRACER） */
-    readonly tracer?: ITracer;
-    /** 衰减完成事件发射回调（Agent 注入 this.emit.bind(this, 'decayCompleted')） */
-    readonly onDecayCompleted: DecayCompletedCallback;
-    /** 后台 LLM Provider（可选，用于 L2 时效性评估，未注入时跳过） */
-    readonly backgroundProvider?: LlmProvider | null;
-    /** 完整记忆存储（可选，用于 L2 读取低分记忆和降级，未注入时跳过） */
-    readonly index?: IMemoryStorage | null;
-}
-/** 单条记忆的时效性判断结果 */
-export interface TimelinessVerdict {
-    /** 记忆 ID */
-    memoryId: string;
-    /** 是否已过时（true → 降级到 TIMELINESS_OUTDATED_SCORE） */
-    isOutdated: boolean;
-    /** LLM 判断理由 */
-    reason: string;
-}
-/** 时效性评估报告（evaluateTimeliness 返回值） */
-export interface TimelinessReport {
-    /** 扫描的低分记忆总数 */
-    scannedCount: number;
-    /** LLM 判定为过时并执行降级的记忆数 */
-    outdatedCount: number;
-    /** 被降级的记忆 ID 列表 */
-    demotedIds: string[];
-    /** 跳过原因（LLM 不可用 / 无低分记忆 / LLM 失败降级） */
-    skippedReason?: string;
-}
-/** 衰减指标快照（供 Agent.getMetrics 合并） */
-export interface DecayMetrics {
-    /** 衰减执行次数（每次 runOnce 实际执行 +1） */
-    readonly runCount: number;
-    /** 累计衰减记忆数（score 被调低的记忆条数总和） */
-    readonly totalDecayedCount: number;
-    /** 上次衰减时间（ISO 8601，null 表示从未执行过） */
-    readonly lastRunAt: string | null;
-}
-/**
- * 记忆衰减调度器
- *
- * 使用方式：
- *   const scheduler = new MemoryDecayScheduler({ tracer, onDecayCompleted });
- *   scheduler.start(storage, intervalMs);  // 启动定时衰减
- *   scheduler.runOnce();                    // 立即执行一次衰减
- *   scheduler.stop();                       // 停止定时衰减
- *   scheduler.getMetrics();                 // 获取衰减指标快照
- */
-export declare class MemoryDecayScheduler {
-    /** 可观测性 Tracer（默认 NOOP，零开销） */
-    private readonly tracer;
-    /** 衰减完成事件发射回调 */
-    private readonly onDecayCompleted;
-    /** 后台 LLM Provider（可选，用于 L2 时效性评估，未注入时跳过） */
-    private readonly backgroundProvider;
-    /** 完整记忆存储（可选，用于 L2 读取低分记忆和降级，未注入时跳过） */
-    private readonly index;
-    /** 衰减定时器（null 表示未启动） */
-    private decayTimer;
-    /** 衰减目标存储（start 时注入，stop 时释放） */
-    private storage;
-    /** 衰减执行次数（每次 runOnce 实际执行 +1） */
-    private metricDecayRunCount;
-    /** 累计衰减记忆数（score 被调低的记忆条数总和） */
-    private metricTotalDecayedCount;
-    /** 上次衰减时间（ISO 8601，null 表示从未执行过） */
-    private metricLastDecayAt;
-    constructor(opts: MemoryDecaySchedulerOptions);
-    /**
-     * 启动定期衰减
-     *
-     * @param storage 衰减目标存储（IMemoryStorage.decayScores）
-     * @param intervalMs 衰减间隔（毫秒，通常为 1 小时）
-     */
-    start(storage: IMemoryStorageLike, intervalMs: number): void;
-    /**
-     * 停止定期衰减，释放资源
-     *
-     * 清理定时器和 storage 引用，防止 close 后回调触发。
-     */
-    stop(): void;
-    /**
-     * 执行一次记忆衰减
-     *
-     * 对 insight/profile/work-projection 记忆执行 score 衰减，
-     * 长期未访问的记忆 score 逐渐降低，体现"自然遗忘"。
-     * 不影响 persona/rule/skill（这些是配置型记忆，不应衰减）。
-     *
-     * 衰减逻辑委派给 IMemoryStorage.decayScores()，
-     * 宿主（SqliteStorage）可用一条 SQL UPDATE 批量完成，避免 O(n) 全量加载。
-     */
-    runOnce(): void;
-    /**
-     * 获取衰减指标快照
-     *
-     * 供 Agent.getMetrics() 合并到完整 AgentMetrics 中。
-     */
-    getMetrics(): DecayMetrics;
-    /**
-     * 时效性评估：扫描低分记忆，调用 LLM 判断是否已过时
-     *
-     * 流程：
-     *   1. 从 insight/profile/work-projection 加载低分记忆（score < 0.3）
-     *   2. 对每条低分记忆（上限 20 条），调用 LLM 判断是否"已过时"
-     *   3. 过时则进一步降级（score → 0.05，接近物理删除阈值但保留可恢复性）
-     *   4. 返回评估报告
-     *
-     * 使用场景：
-     *   - 衰减后调用（onDecayCompleted 回调中），对低分记忆做 LLM 二次评估
-     *   - 宿主定时任务定期调用（如每天一次）
-     *   - 用户手动触发（记忆管理面板的"清理过时记忆"按钮）
-     *
-     * 安全设计：
-     *   - 不物理删除——仅降级 score，保留可恢复性
-     *   - LLM 失败降级——返回已处理的报告，不阻塞调用方
-     *   - 单条 LLM 失败不阻塞后续评估
-     *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
-     *
-     * @param signal 可选的 AbortSignal（取消正在进行的 LLM 评估）
-     * @returns 评估报告
-     */
-    evaluateTimeliness(signal?: AbortSignal): Promise<TimelinessReport>;
-    /**
-     * 调用 LLM 判断单条记忆的时效性
-     *
-     * 使用结构化 JSON 输出（isOutdated + reason），
-     * 参照 SessionArchiver.generateSummary 的 parseLlmJson 模式。
-     *
-     * LLM 失败时抛出异常（由 evaluateTimeliness 捕获并降级跳过此条）。
-     *
-     * @param memory 待评估的记忆
-     * @param signal 可选的 AbortSignal
-     * @returns LLM 判断结果
-     */
-    private judgeTimeliness;
-    /**
-     * 降级过时记忆（score → TIMELINESS_OUTDATED_SCORE）
-     *
-     * 安全设计：
-     *   - 不物理删除，仅降低 score，保留可恢复性
-     *   - 通过 upsert 覆盖原记忆（保持 id/source/name/createdAt 不变）
-     *   - 更新 accessedAt，标记最近被处理过
-     *
-     * @param memory 待降级的过时记忆
-     */
-    private demoteOutdatedMemory;
-}
-/**
- * IMemoryStorage 的衰减子接口（接口隔离原则）
- *
- * MemoryDecayScheduler 只需要 decayScores 方法，不需要完整 IMemoryStorage。
- * 使用结构子接口便于测试 mock，同时避免对完整接口的过度耦合。
- */
-export interface IMemoryStorageLike {
-    /** 对指定 source 的记忆执行 score 衰减，返回被衰减的记忆条数 */
-    decayScores(sources: readonly string[], now: Date): number;
-}
-//# sourceMappingURL=memoryDecayScheduler.d.ts.map

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

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

package/dist/agent/managers/memoryDecayScheduler.js

@@ -1,349 +0,0 @@
-/**
- * 记忆衰减调度器（从 agent.ts 拆分）
- *
- * 职责：
- *   1. 定期执行记忆 score 衰减（体现"自然遗忘"）
- *   2. 衰减指标统计（执行次数 / 累计衰减记忆数 / 上次衰减时间）
- *   3. 衰减可观测性（Tracer Span 埋点）
- *   4. 衰减完成事件发射（decayCompleted）
- *   5. L2 时效性评估（可选，backgroundProvider + index 注入后启用）
- *
- * 设计理由：
- *   agent.ts 原承担 15+ 职责，记忆衰减是独立的生命周期职责，
- *   拆分后 Agent 聚焦对话编排，MemoryDecayScheduler 聚焦记忆自然遗忘。
- *
- * 衰减范围：
- *   - insight（洞察记忆）
- *   - profile（用户画像记忆）
- *   - work-projection（作品投影）
- *   不衰减 persona/rule/skill（配置型记忆不应衰减）
- *
- * L2 时效性评估（可选增强）：
- *   - 衰减后扫描低分记忆（score < TIMELINESS_LOW_SCORE_THRESHOLD）
- *   - 调用 LLM 判断是否"已过时"（如过时的技术栈、已变更的偏好）
- *   - 过时则进一步降级（score → TIMELINESS_OUTDATED_SCORE）
- *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
- *
- * 自然生长原则：
- *   - 不持有 storage 引用（start 时注入，stop 时释放）
- *   - 通过回调发射事件（不继承 TypedEventEmitter，避免与 Agent 事件系统耦合）
- *   - 指标统计内聚（getMetrics 返回快照，Agent.getMetrics 直接合并）
- */
-import { safeSetInterval, clearSafeInterval } from '../../utils/safeTimer.js';
-import { logger } from '../../logging/logger.js';
-import { toError } from '../../utils/errors.js';
-import { nowIso } from '../../utils/time.js';
-import { SOURCE_LABELS } from '../../memory/types.js';
-import { NOOP_TRACER, TRACE_SPANS } from '../../agent/tracer.js';
-// parseLlmJson 用于解析 LLM 时效性判断结果（与 SessionArchiver 同模式）
-import { parseLlmJson } from '../../utils/json.js';
-import { truncate } from '../../utils/strings.js';
-// ─── L2 时效性评估常量 ────────────────────────────────────
-/** 参与时效性评估的 source 标签（与衰减范围一致） */
-const TIMELINESS_SOURCES = [SOURCE_LABELS.INSIGHT, SOURCE_LABELS.PROFILE, SOURCE_LABELS.WORK_PROJECTION];
-/** 低分记忆阈值（score 低于此值的记忆进入 LLM 时效性评估） */
-const TIMELINESS_LOW_SCORE_THRESHOLD = 0.3;
-/** 单次时效性评估的记忆条数上限（控制 LLM 调用量） */
-const TIMELINESS_EVALUATE_LIMIT = 20;
-/** LLM 时效性判断超时（ms） */
-const TIMELINESS_TIMEOUT_MS = 15_000;
-/** 被判定为过时的记忆降级到此 score（接近物理删除阈值，但保留可恢复性） */
-const TIMELINESS_OUTDATED_SCORE = 0.05;
-/** 候选记忆内容预览长度（截断后送入 LLM） */
-const TIMELINESS_CONTENT_PREVIEW_LEN = 200;
-/**
- * 记忆衰减调度器
- *
- * 使用方式：
- *   const scheduler = new MemoryDecayScheduler({ tracer, onDecayCompleted });
- *   scheduler.start(storage, intervalMs);  // 启动定时衰减
- *   scheduler.runOnce();                    // 立即执行一次衰减
- *   scheduler.stop();                       // 停止定时衰减
- *   scheduler.getMetrics();                 // 获取衰减指标快照
- */
-export class MemoryDecayScheduler {
-    /** 可观测性 Tracer（默认 NOOP，零开销） */
-    tracer;
-    /** 衰减完成事件发射回调 */
-    onDecayCompleted;
-    /** 后台 LLM Provider（可选，用于 L2 时效性评估，未注入时跳过） */
-    backgroundProvider;
-    /** 完整记忆存储（可选，用于 L2 读取低分记忆和降级，未注入时跳过） */
-    index;
-    /** 衰减定时器（null 表示未启动） */
-    decayTimer = null;
-    /** 衰减目标存储（start 时注入，stop 时释放） */
-    storage = null;
-    // ─── 衰减指标统计字段 ──────────────────────────────────
-    /** 衰减执行次数（每次 runOnce 实际执行 +1） */
-    metricDecayRunCount = 0;
-    /** 累计衰减记忆数（score 被调低的记忆条数总和） */
-    metricTotalDecayedCount = 0;
-    /** 上次衰减时间（ISO 8601，null 表示从未执行过） */
-    metricLastDecayAt = null;
-    constructor(opts) {
-        this.tracer = opts.tracer ?? NOOP_TRACER;
-        this.onDecayCompleted = opts.onDecayCompleted;
-        // L2 可选依赖：未注入时 evaluateTimeliness 静默跳过
-        this.backgroundProvider = opts.backgroundProvider ?? null;
-        this.index = opts.index ?? null;
-    }
-    /**
-     * 启动定期衰减
-     *
-     * @param storage 衰减目标存储（IMemoryStorage.decayScores）
-     * @param intervalMs 衰减间隔（毫秒，通常为 1 小时）
-     */
-    start(storage, intervalMs) {
-        this.storage = storage;
-        // 立即执行一次首次衰减
-        this.runOnce();
-        // 注册定期衰减
-        this.decayTimer = safeSetInterval(() => this.runOnce(), intervalMs);
-    }
-    /**
-     * 停止定期衰减，释放资源
-     *
-     * 清理定时器和 storage 引用，防止 close 后回调触发。
-     */
-    stop() {
-        if (this.decayTimer) {
-            clearSafeInterval(this.decayTimer);
-            this.decayTimer = null;
-        }
-        this.storage = null;
-    }
-    /**
-     * 执行一次记忆衰减
-     *
-     * 对 insight/profile/work-projection 记忆执行 score 衰减，
-     * 长期未访问的记忆 score 逐渐降低，体现"自然遗忘"。
-     * 不影响 persona/rule/skill（这些是配置型记忆，不应衰减）。
-     *
-     * 衰减逻辑委派给 IMemoryStorage.decayScores()，
-     * 宿主（SqliteStorage）可用一条 SQL UPDATE 批量完成，避免 O(n) 全量加载。
-     */
-    runOnce() {
-        if (!this.storage)
-            return;
-        // 衰减 Span：记录衰减执行过程，补全衰减可观测性缺口
-        const decaySpan = this.tracer.startSpan(TRACE_SPANS.DECAY);
-        try {
-            const sources = [SOURCE_LABELS.INSIGHT, SOURCE_LABELS.PROFILE, SOURCE_LABELS.WORK_PROJECTION];
-            const decayedCount = this.storage.decayScores(sources, new Date());
-            logger.debug({ decayedCount }, '记忆衰减完成');
-            // 衰减指标统计：累计执行次数和衰减记忆数
-            this.metricDecayRunCount++;
-            this.metricTotalDecayedCount += decayedCount;
-            this.metricLastDecayAt = nowIso();
-            decaySpan.setAttribute('decayedCount', decayedCount);
-            decaySpan.setAttribute('totalRuns', this.metricDecayRunCount);
-            this.onDecayCompleted({ decayedCount });
-        }
-        catch (err) {
-            logger.warn({ err }, '记忆衰减异常，跳过本轮');
-            decaySpan.recordException(toError(err));
-        }
-        finally {
-            decaySpan.end();
-        }
-    }
-    /**
-     * 获取衰减指标快照
-     *
-     * 供 Agent.getMetrics() 合并到完整 AgentMetrics 中。
-     */
-    getMetrics() {
-        return {
-            runCount: this.metricDecayRunCount,
-            totalDecayedCount: this.metricTotalDecayedCount,
-            lastRunAt: this.metricLastDecayAt,
-        };
-    }
-    // ─── L2 时效性评估（可选，backgroundProvider + index 注入后启用） ───
-    /**
-     * 时效性评估：扫描低分记忆，调用 LLM 判断是否已过时
-     *
-     * 流程：
-     *   1. 从 insight/profile/work-projection 加载低分记忆（score < 0.3）
-     *   2. 对每条低分记忆（上限 20 条），调用 LLM 判断是否"已过时"
-     *   3. 过时则进一步降级（score → 0.05，接近物理删除阈值但保留可恢复性）
-     *   4. 返回评估报告
-     *
-     * 使用场景：
-     *   - 衰减后调用（onDecayCompleted 回调中），对低分记忆做 LLM 二次评估
-     *   - 宿主定时任务定期调用（如每天一次）
-     *   - 用户手动触发（记忆管理面板的"清理过时记忆"按钮）
-     *
-     * 安全设计：
-     *   - 不物理删除——仅降级 score，保留可恢复性
-     *   - LLM 失败降级——返回已处理的报告，不阻塞调用方
-     *   - 单条 LLM 失败不阻塞后续评估
-     *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
-     *
-     * @param signal 可选的 AbortSignal（取消正在进行的 LLM 评估）
-     * @returns 评估报告
-     */
-    async evaluateTimeliness(signal) {
-        // 可选依赖未注入时静默降级（向后兼容）
-        if (!this.backgroundProvider || !this.index) {
-            return {
-                scannedCount: 0,
-                outdatedCount: 0,
-                demotedIds: [],
-                skippedReason: 'backgroundProvider 或 index 未注入',
-            };
-        }
-        // ── 步骤 1：加载低分记忆 ──
-        const lowScoreMemories = [];
-        for (const source of TIMELINESS_SOURCES) {
-            const memories = this.index.getBySource(source);
-            // 筛选低分记忆（score 低于阈值）
-            lowScoreMemories.push(...memories.filter((m) => m.score < TIMELINESS_LOW_SCORE_THRESHOLD));
-        }
-        if (lowScoreMemories.length === 0) {
-            return {
-                scannedCount: 0,
-                outdatedCount: 0,
-                demotedIds: [],
-                skippedReason: '无低分记忆需评估',
-            };
-        }
-        // 按 score 升序排列（最低分优先评估），取前 20 条
-        lowScoreMemories.sort((a, b) => a.score - b.score);
-        const limited = lowScoreMemories.slice(0, TIMELINESS_EVALUATE_LIMIT);
-        // ── 步骤 2：逐条调用 LLM 判断时效性 ──
-        const demotedIds = [];
-        let outdatedCount = 0;
-        for (const memory of limited) {
-            try {
-                const verdict = await this.judgeTimeliness(memory, signal);
-                if (verdict.isOutdated) {
-                    this.demoteOutdatedMemory(memory);
-                    demotedIds.push(memory.id);
-                    outdatedCount++;
-                    logger.info({ memoryId: memory.id, reason: verdict.reason }, '时效性评估：降级过时记忆');
-                }
-            }
-            catch (err) {
-                // 单条 LLM 判断失败不阻塞后续评估
-                logger.warn({ err, memoryId: memory.id }, '时效性评估：LLM 判断失败，跳过此条');
-            }
-        }
-        return {
-            scannedCount: limited.length,
-            outdatedCount,
-            demotedIds,
-        };
-    }
-    /**
-     * 调用 LLM 判断单条记忆的时效性
-     *
-     * 使用结构化 JSON 输出（isOutdated + reason），
-     * 参照 SessionArchiver.generateSummary 的 parseLlmJson 模式。
-     *
-     * LLM 失败时抛出异常（由 evaluateTimeliness 捕获并降级跳过此条）。
-     *
-     * @param memory 待评估的记忆
-     * @param signal 可选的 AbortSignal
-     * @returns LLM 判断结果
-     */
-    async judgeTimeliness(memory, signal) {
-        const messages = buildTimelinessMessages(memory);
-        let llmResponse = '';
-        // 流式累积模式（与 TextPolishManager / SessionArchiver 一致）
-        for await (const chunk of this.backgroundProvider.chat(messages, {
-            maxTokens: 200,
-            temperature: 0,
-            timeoutMs: TIMELINESS_TIMEOUT_MS,
-            signal,
-        })) {
-            if (chunk.content)
-                llmResponse += chunk.content;
-        }
-        // 解析 LLM 响应（JSON 格式）
-        const parsed = parseLlmJson(llmResponse.trim());
-        if (!parsed) {
-            throw new Error('LLM 时效性判断返回非法 JSON');
-        }
-        return {
-            memoryId: memory.id,
-            isOutdated: parsed.isOutdated === true,
-            reason: typeof parsed.reason === 'string' ? parsed.reason : '(LLM 未提供理由)',
-        };
-    }
-    /**
-     * 降级过时记忆（score → TIMELINESS_OUTDATED_SCORE）
-     *
-     * 安全设计：
-     *   - 不物理删除，仅降低 score，保留可恢复性
-     *   - 通过 upsert 覆盖原记忆（保持 id/source/name/createdAt 不变）
-     *   - 更新 accessedAt，标记最近被处理过
-     *
-     * @param memory 待降级的过时记忆
-     */
-    demoteOutdatedMemory(memory) {
-        const demoted = {
-            ...memory,
-            score: TIMELINESS_OUTDATED_SCORE,
-            accessedAt: nowIso(),
-        };
-        this.index.upsert(demoted);
-    }
-}
-// ─── L2 时效性评估 Prompt 模板（模块级函数，与 buildDedupMessages 同模式） ───
-/**
- * 构建时效性判断的 LLM 消息
- *
- * 设计要点：
- *   - system 消息定义判断规则（过时 = 信息已失效/不再适用）
- *   - user 消息携带记忆内容和元数据（source/score/createdAt）
- *   - 要求输出结构化 JSON（isOutdated + reason）
- *   - few-shot 示例降低 LLM 误判率
- *
- * @param memory 待评估的记忆
- * @returns system + user 消息数组
- */
-function buildTimelinessMessages(memory) {
-    const content = memory.content.length > TIMELINESS_CONTENT_PREVIEW_LEN
-        ? truncate(memory.content, TIMELINESS_CONTENT_PREVIEW_LEN, '…[截断]')
-        : memory.content;
-    return [
-        {
-            role: 'system',
-            content: `你是记忆时效性评估助手。判断给定的记忆是否已过时（信息已失效或不再适用）。
-
-判断规则：
-- 已过时 = 信息明确失效（如旧版本号、已废弃的 API、已变更的偏好）
-- 未过时 = 信息仍然有效（如通用编程原则、长期偏好、历史事件记录）
-- 不确定时倾向"未过时"（避免误删有效记忆）
-
-输出 JSON 格式：
-{
-  "isOutdated": true/false,
-  "reason": "判断理由（简短说明）"
-}
-
-示例：
-输入: "用户使用 React 16 进行开发"（createdAt: 2020-01-01）
-输出: {"isOutdated": true, "reason": "React 16 已是旧版本，当前普遍使用 React 18+"}
-
-输入: "用户偏好函数式编程风格"
-输出: {"isOutdated": false, "reason": "编程风格偏好通常是长期的"}`,
-        },
-        {
-            role: 'user',
-            content: `请判断以下记忆是否已过时：
-
-记忆详情：
-- 名称：${memory.name}
-- 来源：${memory.source}
-- 当前 score：${memory.score}（低分，可能因长期未访问而衰减）
-- 创建时间：${memory.createdAt}
-- 内容：${content}
-
-请输出 JSON 判断结果。`,
-        },
-    ];
-}
-//# sourceMappingURL=memoryDecayScheduler.js.map

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

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