@cicctencent/agent-core 0.1.1 → 0.1.3

package/dist/esm/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAI5D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEvF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,YAAY,CAAC;IACxB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,qEAAqE;IACrE,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxF,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,aAAa,CAAC,EAAE,OAAO,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE;;;;;OAKG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAID,MAAM,WAAW,SAAS;IACxB,gBAAgB;IAChB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,eAAe;IACf,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEvC,aAAa;IACb,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvE,qBAAqB;IACrB,aAAa,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAEtF,mBAAmB;IACnB,YAAY,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C,WAAW;IACX,UAAU,IAAI,IAAI,CAAC;IAEnB,WAAW;IACX,WAAW,IAAI,OAAO,CAAC;CACxB"}

package/dist/esm/mcp/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// MCP Client 类型定义
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D"}

package/dist/esm/memory/checkpoint.d.ts

@@ -0,0 +1,62 @@
+/** 检查点数据 */
+export interface CheckpointData {
+    /** 上次 L2 聚合时的 L1 条目总数 */
+    lastL1Count: number;
+    /** 上次 L3 生成时的 L2 条目总数 */
+    lastL2Count: number;
+    /** 最后执行时间（ISO 字符串） */
+    lastRunAt: string;
+    /** 累计执行次数 */
+    runCount: number;
+}
+/**
+ * 记忆管道检查点
+ *
+ * 用于管道调度器判断是否需要触发 L2/L3：
+ * - 当 L1 增量（当前 - lastL1Count）达到阈值时触发 L2
+ * - 当 L2 增量（当前 - lastL2Count）达到阈值时触发 L3
+ */
+export declare class MemoryCheckpoint {
+    private filePath;
+    private data;
+    /**
+     * @param filePath 检查点文件路径，默认为 {cwd}/data/memories/checkpoint.json
+     */
+    constructor(filePath?: string);
+    /** 获取当前检查点数据 */
+    get(): CheckpointData;
+    /**
+     * 判断是否应触发 L2 聚合
+     * @param currentL1Count 当前 L1 条目总数
+     * @param threshold L2 触发阈值
+     */
+    shouldTriggerL2(currentL1Count: number, threshold: number): boolean;
+    /**
+     * 判断是否应触发 L3 画像更新
+     * @param currentL2Count 当前 L2 条目总数
+     * @param threshold L3 触发阈值
+     */
+    shouldTriggerL3(currentL2Count: number, threshold: number): boolean;
+    /**
+     * 更新检查点（L2 聚合完成后调用）
+     */
+    updateL2(currentL1Count: number): void;
+    /**
+     * 更新检查点（L3 画像完成后调用）
+     */
+    updateL3(currentL2Count: number): void;
+    /**
+     * 重置检查点（用于手动触发全量重建）
+     */
+    reset(): void;
+    private load;
+    private persist;
+}
+/**
+ * 获取全局检查点实例
+ * @param filePath 可选，首次调用时指定自定义路径
+ */
+export declare function getMemoryCheckpoint(filePath?: string): MemoryCheckpoint;
+/** 重置全局实例（用于测试或路径变更场景） */
+export declare function resetMemoryCheckpoint(): void;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/esm/memory/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../src/memory/checkpoint.ts"],"names":[],"mappings":"AAWA,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAiB;IAE7B;;OAEG;gBACS,QAAQ,CAAC,EAAE,MAAM;IAK7B,gBAAgB;IAChB,GAAG,IAAI,cAAc;IAIrB;;;;OAIG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAInE;;;;OAIG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAInE;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAOtC;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAMtC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,OAAO;CAWhB;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAKvE;AAED,0BAA0B;AAC1B,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/esm/memory/checkpoint.js

@@ -0,0 +1,121 @@
+// ============================================================
+// MemoryCheckpoint — 记忆管道检查点
+// ============================================================
+// 记录管道调度器的执行状态，避免重复处理：
+// - 上次 L2 聚合时的 L1 条目数
+// - 上次 L3 生成时的 L2 条目数
+// - 最后执行时间
+import * as fs from 'fs';
+import * as path from 'path';
+const DEFAULT_CHECKPOINT = {
+    lastL1Count: 0,
+    lastL2Count: 0,
+    lastRunAt: '',
+    runCount: 0,
+};
+/** 默认检查点文件路径（基于 process.cwd()） */
+const DEFAULT_CHECKPOINT_PATH = 'data/memories/checkpoint.json';
+/**
+ * 记忆管道检查点
+ *
+ * 用于管道调度器判断是否需要触发 L2/L3：
+ * - 当 L1 增量（当前 - lastL1Count）达到阈值时触发 L2
+ * - 当 L2 增量（当前 - lastL2Count）达到阈值时触发 L3
+ */
+export class MemoryCheckpoint {
+    filePath;
+    data;
+    /**
+     * @param filePath 检查点文件路径，默认为 {cwd}/data/memories/checkpoint.json
+     */
+    constructor(filePath) {
+        this.filePath = filePath ?? path.join(process.cwd(), DEFAULT_CHECKPOINT_PATH);
+        this.data = this.load();
+    }
+    /** 获取当前检查点数据 */
+    get() {
+        return { ...this.data };
+    }
+    /**
+     * 判断是否应触发 L2 聚合
+     * @param currentL1Count 当前 L1 条目总数
+     * @param threshold L2 触发阈值
+     */
+    shouldTriggerL2(currentL1Count, threshold) {
+        return (currentL1Count - this.data.lastL1Count) >= threshold;
+    }
+    /**
+     * 判断是否应触发 L3 画像更新
+     * @param currentL2Count 当前 L2 条目总数
+     * @param threshold L3 触发阈值
+     */
+    shouldTriggerL3(currentL2Count, threshold) {
+        return (currentL2Count - this.data.lastL2Count) >= threshold;
+    }
+    /**
+     * 更新检查点（L2 聚合完成后调用）
+     */
+    updateL2(currentL1Count) {
+        this.data.lastL1Count = currentL1Count;
+        this.data.lastRunAt = new Date().toISOString();
+        this.data.runCount++;
+        this.persist();
+    }
+    /**
+     * 更新检查点（L3 画像完成后调用）
+     */
+    updateL3(currentL2Count) {
+        this.data.lastL2Count = currentL2Count;
+        this.data.lastRunAt = new Date().toISOString();
+        this.persist();
+    }
+    /**
+     * 重置检查点（用于手动触发全量重建）
+     */
+    reset() {
+        this.data = { ...DEFAULT_CHECKPOINT };
+        this.persist();
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.filePath)) {
+                const raw = fs.readFileSync(this.filePath, 'utf-8');
+                const data = JSON.parse(raw);
+                return { ...DEFAULT_CHECKPOINT, ...data };
+            }
+        }
+        catch (err) {
+            console.warn('[MemoryCheckpoint] Failed to load:', err);
+        }
+        return { ...DEFAULT_CHECKPOINT };
+    }
+    persist() {
+        try {
+            const dir = path.dirname(this.filePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(this.filePath, JSON.stringify(this.data, null, 2), 'utf-8');
+        }
+        catch (err) {
+            console.warn('[MemoryCheckpoint] Failed to persist:', err);
+        }
+    }
+}
+/** 全局单例（可配置路径） */
+let checkpointInstance = null;
+/**
+ * 获取全局检查点实例
+ * @param filePath 可选，首次调用时指定自定义路径
+ */
+export function getMemoryCheckpoint(filePath) {
+    if (!checkpointInstance) {
+        checkpointInstance = new MemoryCheckpoint(filePath);
+    }
+    return checkpointInstance;
+}
+/** 重置全局实例（用于测试或路径变更场景） */
+export function resetMemoryCheckpoint() {
+    checkpointInstance = null;
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/esm/memory/checkpoint.js.map

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

package/dist/esm/memory/extractor.d.ts

@@ -0,0 +1,59 @@
+import type { LLMProvider } from '../llm/types.ts';
+import type { Message } from '../types.ts';
+/** 从对话中提取的原子事实 */
+export interface AtomFact {
+    /** 记忆键（snake_case，用于 upsert） */
+    key: string;
+    /** 事实内容 */
+    content: string;
+    /** 分类 */
+    category: 'user_preference' | 'project_knowledge' | 'learned_fact' | 'custom';
+    /** 重要程度 1-5 */
+    importance: number;
+    /** 来源会话 ID */
+    sourceSessionId: string;
+}
+/** 提取配置 */
+export interface ExtractorOptions {
+    /** LLM Provider 实例 */
+    llmProvider: LLMProvider;
+    /** 单次提取最大原子事实数，默认 5 */
+    maxFactsPerSession?: number;
+    /** 触发提取的最小迭代次数，默认 3 */
+    minIterations?: number;
+    /** 提取超时（毫秒），默认 30000 */
+    timeoutMs?: number;
+}
+/**
+ * LLM 驱动的原子事实提取器
+ * 从对话历史中提取持久性、可复用的结构化事实（L1 Atom）
+ */
+export declare class MemoryExtractor {
+    private llmProvider;
+    private maxFactsPerSession;
+    private minIterations;
+    private timeoutMs;
+    constructor(opts: ExtractorOptions);
+    /**
+     * 从对话消息中提取原子事实
+     * @param messages 对话消息列表
+     * @param sessionId 当前会话 ID
+     * @param existingKeys 已有的记忆键（用于去重）
+     * @returns 提取到的原子事实数组
+     */
+    extract(messages: Message[], sessionId: string, existingKeys: string[]): Promise<AtomFact[]>;
+    /**
+     * 调用 LLM 提取事实
+     */
+    private callLLM;
+    /**
+     * 解析 LLM 输出的 JSON 数组
+     */
+    private parseFacts;
+    private normalizeCategory;
+    /**
+     * 构建对话摘要（将消息列表压缩为文本，限制总字符数）
+     */
+    private buildMessagesSummary;
+}
+//# sourceMappingURL=extractor.d.ts.map

package/dist/esm/memory/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/memory/extractor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,kBAAkB;AAClB,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,QAAQ,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,cAAc,GAAG,QAAQ,CAAC;IAC9E,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,WAAW;AACX,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,uBAAuB;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,gBAAgB;IAOlC;;;;;;OAMG;IACG,OAAO,CACX,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,QAAQ,EAAE,CAAC;IAetB;;OAEG;YACW,OAAO;IAqBrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAuB7B"}

package/dist/esm/memory/extractor.js

@@ -0,0 +1,117 @@
+// ============================================================
+// MemoryExtractor — LLM 驱动的原子事实提取器
+// ============================================================
+import { EXTRACTION_SYSTEM_PROMPT, buildExtractionUserPrompt, } from "./prompts.js";
+/**
+ * LLM 驱动的原子事实提取器
+ * 从对话历史中提取持久性、可复用的结构化事实（L1 Atom）
+ */
+export class MemoryExtractor {
+    llmProvider;
+    maxFactsPerSession;
+    minIterations;
+    timeoutMs;
+    constructor(opts) {
+        this.llmProvider = opts.llmProvider;
+        this.maxFactsPerSession = opts.maxFactsPerSession ?? 5;
+        this.minIterations = opts.minIterations ?? 3;
+        this.timeoutMs = opts.timeoutMs ?? 30000;
+    }
+    /**
+     * 从对话消息中提取原子事实
+     * @param messages 对话消息列表
+     * @param sessionId 当前会话 ID
+     * @param existingKeys 已有的记忆键（用于去重）
+     * @returns 提取到的原子事实数组
+     */
+    async extract(messages, sessionId, existingKeys) {
+        // 构建对话摘要（避免超长对话）
+        const summary = this.buildMessagesSummary(messages);
+        const userPrompt = buildExtractionUserPrompt(summary, existingKeys);
+        try {
+            const result = await this.callLLM(userPrompt);
+            return this.parseFacts(result, sessionId);
+        }
+        catch (err) {
+            console.warn(`[MemoryExtractor] Extraction failed: ${err?.message || err}`);
+            return [];
+        }
+    }
+    /**
+     * 调用 LLM 提取事实
+     */
+    async callLLM(userPrompt) {
+        const messages = [
+            { role: 'system', content: EXTRACTION_SYSTEM_PROMPT },
+            { role: 'user', content: userPrompt },
+        ];
+        const chunks = [];
+        const stream = this.llmProvider.chatStream({
+            messages,
+            abortSignal: AbortSignal.timeout(this.timeoutMs),
+        });
+        for await (const chunk of stream) {
+            if (chunk.delta.content) {
+                chunks.push(chunk.delta.content);
+            }
+        }
+        return chunks.join('');
+    }
+    /**
+     * 解析 LLM 输出的 JSON 数组
+     */
+    parseFacts(raw, sessionId) {
+        // 尝试提取 JSON 数组（LLM 可能输出额外文本）
+        const jsonMatch = raw.match(/\[[\s\S]*\]/);
+        if (!jsonMatch)
+            return [];
+        try {
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (!Array.isArray(parsed))
+                return [];
+            return parsed
+                .filter((item) => item.key && item.content)
+                .slice(0, this.maxFactsPerSession)
+                .map((item) => ({
+                key: String(item.key).replace(/[^a-z0-9_]/g, '_').toLowerCase(),
+                content: String(item.content),
+                category: this.normalizeCategory(item.category),
+                importance: Math.min(5, Math.max(1, Number(item.importance) || 3)),
+                sourceSessionId: sessionId,
+            }));
+        }
+        catch {
+            console.warn('[MemoryExtractor] Failed to parse LLM output as JSON');
+            return [];
+        }
+    }
+    normalizeCategory(cat) {
+        const valid = ['user_preference', 'project_knowledge', 'learned_fact', 'custom'];
+        return valid.includes(cat) ? cat : 'custom';
+    }
+    /**
+     * 构建对话摘要（将消息列表压缩为文本，限制总字符数）
+     */
+    buildMessagesSummary(messages) {
+        const maxChars = 6000;
+        const lines = [];
+        let totalLen = 0;
+        for (const msg of messages) {
+            if (msg.role === 'system')
+                continue;
+            const role = msg.role === 'user' ? 'USER' : msg.role === 'assistant' ? 'ASSISTANT' : 'TOOL';
+            const content = typeof msg.content === 'string'
+                ? msg.content.slice(0, 500)
+                : JSON.stringify(msg.content).slice(0, 500);
+            const line = `[${role}] ${content}`;
+            if (totalLen + line.length > maxChars) {
+                lines.push(`... (${messages.length - lines.length} more messages truncated)`);
+                break;
+            }
+            lines.push(line);
+            totalLen += line.length;
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=extractor.js.map

package/dist/esm/memory/extractor.js.map

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

package/dist/esm/memory/persona.d.ts

@@ -0,0 +1,38 @@
+import type { LLMProvider } from '../llm/types.ts';
+import type { SceneBlock } from './scene.ts';
+/** 画像维度 */
+export interface PersonaFacet {
+    /** 维度键（如 coding_style, tool_preference） */
+    key: string;
+    /** 维度内容（markdown） */
+    content: string;
+}
+/** 画像生成器配置 */
+export interface PersonaGeneratorOptions {
+    llmProvider: LLMProvider;
+    /** 超时（毫秒），默认 30000 */
+    timeoutMs?: number;
+}
+/**
+ * L3 用户画像生成器
+ *
+ * 工作流程：
+ * 1. 接收 L2 场景块列表
+ * 2. 通过 LLM 从场景中提炼稳定用户特征
+ * 3. 增量更新画像（保留已有内容，仅修改受影响的部分）
+ */
+export declare class PersonaGenerator {
+    private llmProvider;
+    private timeoutMs;
+    constructor(opts: PersonaGeneratorOptions);
+    /**
+     * 生成或更新用户画像
+     * @param scenes L2 场景块列表
+     * @param existingPersona 已有画像（markdown 文本，用于增量更新）
+     * @returns 更新后的画像 markdown
+     */
+    generate(scenes: SceneBlock[], existingPersona?: string): Promise<string>;
+    private buildUserPrompt;
+    private callLLM;
+}
+//# sourceMappingURL=persona.d.ts.map

package/dist/esm/memory/persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["../../../src/memory/persona.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,cAAc;AACd,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE,uBAAuB;IAKzC;;;;;OAKG;IACG,QAAQ,CACZ,MAAM,EAAE,UAAU,EAAE,EACpB,eAAe,GAAE,MAAW,GAC3B,OAAO,CAAC,MAAM,CAAC;IAalB,OAAO,CAAC,eAAe;YAoBT,OAAO;CAoBtB"}

package/dist/esm/memory/persona.js

@@ -0,0 +1,75 @@
+// ============================================================
+// PersonaGenerator — L3 用户画像生成器
+// ============================================================
+// 基于 L2 场景块生成/增量更新用户画像（L3 Persona），
+// 画像以 markdown 格式存储，注入 prompt 时提供用户全貌
+import { PERSONA_GENERATION_SYSTEM_PROMPT } from "./prompts.js";
+/**
+ * L3 用户画像生成器
+ *
+ * 工作流程：
+ * 1. 接收 L2 场景块列表
+ * 2. 通过 LLM 从场景中提炼稳定用户特征
+ * 3. 增量更新画像（保留已有内容，仅修改受影响的部分）
+ */
+export class PersonaGenerator {
+    llmProvider;
+    timeoutMs;
+    constructor(opts) {
+        this.llmProvider = opts.llmProvider;
+        this.timeoutMs = opts.timeoutMs ?? 30000;
+    }
+    /**
+     * 生成或更新用户画像
+     * @param scenes L2 场景块列表
+     * @param existingPersona 已有画像（markdown 文本，用于增量更新）
+     * @returns 更新后的画像 markdown
+     */
+    async generate(scenes, existingPersona = '') {
+        if (scenes.length === 0 && !existingPersona)
+            return '';
+        const userPrompt = this.buildUserPrompt(scenes, existingPersona);
+        try {
+            return await this.callLLM(userPrompt);
+        }
+        catch (err) {
+            console.warn(`[PersonaGenerator] Generation failed: ${err?.message || err}`);
+            return existingPersona;
+        }
+    }
+    buildUserPrompt(scenes, existingPersona) {
+        let prompt = '';
+        if (scenes.length > 0) {
+            const scenesText = scenes
+                .map(s => `### ${s.title}\n${s.description}\nAtoms: ${s.atomIds.length}`)
+                .join('\n\n');
+            prompt += `**Scenario blocks:**\n${scenesText}\n\n`;
+        }
+        if (existingPersona) {
+            prompt += `**Existing persona (update incrementally, preserve unaffected sections):**\n${existingPersona}\n\n`;
+            prompt += `Update the persona based on the new scenario blocks above. Preserve sections not affected by new data.`;
+        }
+        else {
+            prompt += `Generate a user persona based on the scenario blocks above. Use markdown with clear section headers.`;
+        }
+        return prompt;
+    }
+    async callLLM(userPrompt) {
+        const messages = [
+            { role: 'system', content: PERSONA_GENERATION_SYSTEM_PROMPT },
+            { role: 'user', content: userPrompt },
+        ];
+        const chunks = [];
+        const stream = this.llmProvider.chatStream({
+            messages,
+            abortSignal: AbortSignal.timeout(this.timeoutMs),
+        });
+        for await (const chunk of stream) {
+            if (chunk.delta.content) {
+                chunks.push(chunk.delta.content);
+            }
+        }
+        return chunks.join('').trim();
+    }
+}
+//# sourceMappingURL=persona.js.map

package/dist/esm/memory/persona.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.js","sourceRoot":"","sources":["../../../src/memory/persona.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gCAAgC;AAChC,+DAA+D;AAC/D,oCAAoC;AACpC,sCAAsC;AAItC,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAkBhE;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IACnB,WAAW,CAAc;IACzB,SAAS,CAAS;IAE1B,YAAY,IAA6B;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,MAAoB,EACpB,kBAA0B,EAAE;QAE5B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,EAAE,CAAC;QAEvD,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAEjE,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,yCAAyC,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;YAC7E,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,MAAoB,EAAE,eAAuB;QACnE,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,MAAM;iBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,WAAW,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;iBACxE,IAAI,CAAC,MAAM,CAAC,CAAC;YAChB,MAAM,IAAI,yBAAyB,UAAU,MAAM,CAAC;QACtD,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,IAAI,+EAA+E,eAAe,MAAM,CAAC;YAC/G,MAAM,IAAI,wGAAwG,CAAC;QACrH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,sGAAsG,CAAC;QACnH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,UAAkB;QACtC,MAAM,QAAQ,GAAc;YAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gCAAgC,EAAE;YAC7D,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;SACtC,CAAC;QAEF,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;YACzC,QAAQ;YACR,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;SACjD,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/esm/memory/pipeline.d.ts

@@ -0,0 +1,50 @@
+import type { LLMProvider } from '../llm/types.ts';
+import type { MemoryServiceLike } from './types.ts';
+import { type SceneBlock } from './scene.ts';
+import type { Message } from '../types.ts';
+/** 管道配置 */
+export interface PipelineOptions {
+    llmProvider: LLMProvider;
+    /** 触发 L2 聚合的 L1 增量阈值（新 L1 条目数），默认 5 */
+    l2Threshold?: number;
+    /** 触发 L3 画像更新的 L2 增量阈值，默认 3 */
+    l3Threshold?: number;
+}
+/** 管道执行结果 */
+export interface PipelineResult {
+    /** 本次提取的 L1 原子事实数 */
+    l1Extracted: number;
+    /** 是否触发了 L2 聚合 */
+    l2Triggered: boolean;
+    /** 是否触发了 L3 画像更新 */
+    l3Triggered: boolean;
+    /** 新的场景块（如果触发了 L2） */
+    newScenes?: SceneBlock[];
+    /** 更新的画像（如果触发了 L3） */
+    newPersona?: string;
+}
+/**
+ * 记忆管道调度器
+ *
+ * 调度策略：
+ * 1. 每次对话结束：提取 L1 原子事实
+ * 2. L1 累积达到阈值：触发 L2 场景聚合
+ * 3. L2 累积达到阈值：触发 L3 画像生成
+ *
+ * 所有操作均为 fire-and-forget，不阻塞对话响应
+ */
+export declare class MemoryPipeline {
+    private llmProvider;
+    private l2Threshold;
+    private l3Threshold;
+    constructor(opts: PipelineOptions);
+    /**
+     * 执行完整管道（L1 提取 → 条件触发 L2 → 条件触发 L3）
+     *
+     * @param messages 对话消息
+     * @param sessionId 会话 ID
+     * @param memoryService MemoryService 实例（延迟导入避免循环依赖）
+     */
+    run(messages: Message[], sessionId: string, memoryService: MemoryServiceLike): Promise<PipelineResult>;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/esm/memory/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/memory/pipeline.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAA4B,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9E,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,WAAW;AACX,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;IACzB,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;gBAEhB,IAAI,EAAE,eAAe;IAMjC;;;;;;OAMG;IACG,GAAG,CACP,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,iBAAiB,GAC/B,OAAO,CAAC,cAAc,CAAC;CAwH3B"}