@cicctencent/agent-core 0.1.1 → 0.1.3

package/dist/cjs/mcp/proxy-agent.js

@@ -0,0 +1,195 @@
+"use strict";
+// ============================================================
+// Proxy Agent — 通用 HTTP/HTTPS/SOCKS 代理解析工具
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PROXY_SETTINGS = void 0;
+exports.getWindowsSystemProxy = getWindowsSystemProxy;
+exports.clearSystemProxyCache = clearSystemProxyCache;
+exports.getSystemProxyUrl = getSystemProxyUrl;
+exports.resolveProxyAgentForCategory = resolveProxyAgentForCategory;
+exports.resolveProxyUrlForCategory = resolveProxyUrlForCategory;
+const undici_1 = require("undici");
+const socks_proxy_agent_1 = require("socks-proxy-agent");
+const child_process_1 = require("child_process");
+/** 默认代理设置：全部分类走系统代理 */
+exports.DEFAULT_PROXY_SETTINGS = {
+    llm: { mode: 'system' },
+    mcp: { mode: 'system' },
+    fetch: { mode: 'system' },
+};
+// ---- macOS 系统代理检测 ----
+/**
+ * 从 macOS 系统偏好设置读取代理配置
+ * 通过 scutil --proxy 查询，仅 macOS 平台生效
+ */
+function getMacOSSystemProxy() {
+    if (process.platform !== 'darwin')
+        return undefined;
+    try {
+        const output = (0, child_process_1.execSync)('scutil --proxy', { encoding: 'utf-8', timeout: 3000 });
+        const parsed = {};
+        // scutil 输出格式: "  Key : Value"
+        for (const line of output.split('\n')) {
+            const m = line.trim().match(/^(\w+)\s*:\s*(.+)$/);
+            if (m)
+                parsed[m[1]] = m[2].trim();
+        }
+        // 优先 HTTPS 代理，其次 HTTP 代理，最后 SOCKS 代理
+        if (parsed['HTTPSEnable'] === '1' && parsed['HTTPSProxy']) {
+            const port = parsed['HTTPSPort'] || '443';
+            const url = `http://${parsed['HTTPSProxy']}:${port}`;
+            console.debug(`[Proxy] macOS system HTTPS proxy detected: ${url}`);
+            return url;
+        }
+        if (parsed['HTTPEnable'] === '1' && parsed['HTTPProxy']) {
+            const port = parsed['HTTPPort'] || '80';
+            const url = `http://${parsed['HTTPProxy']}:${port}`;
+            console.debug(`[Proxy] macOS system HTTP proxy detected: ${url}`);
+            return url;
+        }
+        if (parsed['SOCKSEnable'] === '1' && parsed['SOCKSProxy']) {
+            const port = parsed['SOCKSPort'] || '1080';
+            const url = `socks5://${parsed['SOCKSProxy']}:${port}`;
+            console.debug(`[Proxy] macOS system SOCKS proxy detected: ${url}`);
+            return url;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ---- Windows 系统代理检测 ----
+let _cachedSystemProxy = null;
+/**
+ * 从 Windows 注册表读取系统代理配置
+ * 仅 Windows 平台生效，其他平台返回 undefined
+ * 结果缓存，避免重复查询注册表
+ */
+function getWindowsSystemProxy() {
+    if (_cachedSystemProxy !== null)
+        return _cachedSystemProxy || undefined;
+    if (process.platform !== 'win32') {
+        _cachedSystemProxy = undefined;
+        return undefined;
+    }
+    try {
+        const regPath = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings';
+        const output = (0, child_process_1.execSync)(`reg query "${regPath}" /v ProxyEnable`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
+        const enabledMatch = output.match(/ProxyEnable\s+REG_DWORD\s+0x(\d+)/i);
+        if (!enabledMatch || enabledMatch[1] === '0') {
+            _cachedSystemProxy = undefined;
+            return undefined;
+        }
+        const serverOutput = (0, child_process_1.execSync)(`reg query "${regPath}" /v ProxyServer`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
+        const serverMatch = serverOutput.match(/ProxyServer\s+REG_SZ\s+(.+)/i);
+        if (!serverMatch) {
+            _cachedSystemProxy = undefined;
+            return undefined;
+        }
+        const proxyServer = serverMatch[1].trim();
+        // Windows 代理可能是 ip:port 格式，需要补全协议
+        const proxyUrl = proxyServer.includes('://') ? proxyServer : `http://${proxyServer}`;
+        _cachedSystemProxy = proxyUrl;
+        console.debug(`[Proxy] Windows system proxy detected: ${proxyUrl}`);
+        return proxyUrl;
+    }
+    catch {
+        _cachedSystemProxy = undefined;
+        return undefined;
+    }
+}
+/** 清除系统代理缓存（设置变更时可调用） */
+function clearSystemProxyCache() {
+    _cachedSystemProxy = null;
+}
+/**
+ * 获取系统代理 URL
+ * 优先级：环境变量 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY > macOS scutil > Windows 注册表
+ */
+function getSystemProxyUrl() {
+    return process.env.HTTPS_PROXY
+        || process.env.https_proxy
+        || process.env.HTTP_PROXY
+        || process.env.http_proxy
+        || process.env.ALL_PROXY
+        || process.env.all_proxy
+        || getMacOSSystemProxy()
+        || getWindowsSystemProxy();
+}
+// ---- Dispatcher 创建 ----
+/**
+ * 根据代理 URL 创建对应的 dispatcher
+ *
+ * 自动识别协议：
+ * - `http://proxy:8080`  → undici ProxyAgent（HTTP 代理）
+ * - `https://proxy:8443` → undici ProxyAgent（HTTPS 代理）
+ * - `socks5://proxy:1080`→ SocksProxyAgent（SOCKS5）
+ * - `socks4://proxy:1080`→ SocksProxyAgent（SOCKS4）
+ *
+ * @returns dispatcher 实例，无代理时返回 undefined
+ */
+function createDispatcherFromUrl(proxyUrl, label = 'Proxy') {
+    if (proxyUrl.startsWith('socks')) {
+        console.debug(`[${label}] using SOCKS proxy: ${proxyUrl}`);
+        return new socks_proxy_agent_1.SocksProxyAgent(proxyUrl);
+    }
+    console.debug(`[${label}] using HTTP proxy: ${proxyUrl}`);
+    return new undici_1.ProxyAgent(proxyUrl);
+}
+// ---- 新版分类代理解析 ----
+/**
+ * 根据分类代理配置创建 dispatcher
+ *
+ * - `mode='system'`：自动检测系统代理（环境变量 + Windows 注册表）
+ * - `mode='custom'`：使用用户指定的代理 URL
+ * - `mode='direct'`：不走代理，返回 undefined
+ *
+ * @param category 分类代理配置
+ * @param label 日志标签（如 'LLM', 'MCP', 'Fetch'）
+ * @returns dispatcher 实例，无代理时返回 undefined
+ */
+function resolveProxyAgentForCategory(category, label = 'Proxy') {
+    if (!category)
+        return undefined;
+    switch (category.mode) {
+        case 'direct':
+            console.debug(`[${label}] proxy mode: direct (no proxy)`);
+            return undefined;
+        case 'custom':
+            if (!category.url) {
+                console.debug(`[${label}] proxy mode: custom but no URL configured, falling back to direct`);
+                return undefined;
+            }
+            return createDispatcherFromUrl(category.url, label);
+        case 'system':
+        default: {
+            const systemUrl = getSystemProxyUrl();
+            if (!systemUrl) {
+                console.debug(`[${label}] proxy mode: system, no system proxy detected`);
+                return undefined;
+            }
+            return createDispatcherFromUrl(systemUrl, label);
+        }
+    }
+}
+/**
+ * 获取分类代理的有效 URL（用于 axios 等不支持 undici Dispatcher 的场景）
+ *
+ * @returns 代理 URL 字符串，无代理时返回 undefined
+ */
+function resolveProxyUrlForCategory(category) {
+    if (!category)
+        return undefined;
+    switch (category.mode) {
+        case 'direct':
+            return undefined;
+        case 'custom':
+            return category.url || undefined;
+        case 'system':
+        default:
+            return getSystemProxyUrl();
+    }
+}
+//# sourceMappingURL=proxy-agent.js.map

package/dist/cjs/mcp/proxy-agent.js.map

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

package/dist/cjs/mcp/stdio-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-client.d.ts","sourceRoot":"","sources":["../../../src/mcp/stdio-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAM;cAEJ,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDjE,SAAS,CAAC,YAAY,IAAI,IAAI;IAQ9B,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAgBhH,OAAO,CAAC,WAAW;CAkBpB"}

package/dist/cjs/mcp/stdio-client.js

@@ -0,0 +1,95 @@
+"use strict";
+// ============================================================
+// StdioMCPClient — 通过子进程 stdio 通信的 MCP 客户端
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StdioMCPClient = void 0;
+const child_process_1 = require("child_process");
+const base_client_ts_1 = require("./base-client.js");
+class StdioMCPClient extends base_client_ts_1.MCPClientBase {
+    process = null;
+    buffer = '';
+    async doConnect(config) {
+        if (!config.command) {
+            throw new Error('stdio transport requires a "command" in config');
+        }
+        return new Promise((resolve, reject) => {
+            const child = (0, child_process_1.spawn)(config.command, config.args || [], {
+                env: { ...process.env, ...(config.env || {}) },
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            this.process = child;
+            // 超时检查
+            const timer = setTimeout(() => {
+                reject(new Error(`stdio MCP server '${config.name}' failed to start within 10s`));
+            }, 10000);
+            child.on('spawn', () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            child.on('error', (err) => {
+                clearTimeout(timer);
+                reject(new Error(`Failed to start MCP server '${config.name}': ${err.message}`));
+            });
+            // stdout 接收 JSON-RPC 响应（逐行）
+            child.stdout?.on('data', (chunk) => {
+                this.buffer += chunk.toString();
+                this.flushBuffer();
+            });
+            // stderr 用于日志
+            child.stderr?.on('data', (chunk) => {
+                const msg = chunk.toString().trim();
+                if (msg)
+                    console.debug(`[MCP:${config.name}] ${msg}`);
+            });
+            child.on('exit', (code) => {
+                if (this.connected) {
+                    console.warn(`[MCP:${config.name}] process exited with code ${code}`);
+                    this.connected = false;
+                }
+            });
+        });
+    }
+    doDisconnect() {
+        if (this.process) {
+            this.process.kill('SIGTERM');
+            this.process = null;
+        }
+        this.buffer = '';
+    }
+    send(request) {
+        if (!this.process?.stdin?.writable) {
+            throw new Error('MCP stdio process is not writable');
+        }
+        // 通知 (id=0) 不发 content-length，用 JSON-RPC notification 格式
+        if (request.id === 0) {
+            const msg = JSON.stringify({ jsonrpc: request.jsonrpc, method: request.method, params: request.params });
+            this.process.stdin.write(msg + '\n');
+            return;
+        }
+        const msg = JSON.stringify(request);
+        this.process.stdin.write(msg + '\n');
+    }
+    // ---- 内部 ----
+    flushBuffer() {
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() || ''; // 最后一行可能不完整
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const data = JSON.parse(trimmed);
+                // 只处理有 id 的响应（非 notification）
+                if (data.id !== undefined && data.id !== 0) {
+                    this.handleResponse(data);
+                }
+            }
+            catch {
+                // 非 JSON 行忽略
+            }
+        }
+    }
+}
+exports.StdioMCPClient = StdioMCPClient;
+//# sourceMappingURL=stdio-client.js.map

package/dist/cjs/mcp/stdio-client.js.map

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

package/dist/cjs/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/cjs/mcp/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// MCP Client 类型定义
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/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/cjs/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/cjs/memory/checkpoint.js

@@ -0,0 +1,160 @@
+"use strict";
+// ============================================================
+// MemoryCheckpoint — 记忆管道检查点
+// ============================================================
+// 记录管道调度器的执行状态，避免重复处理：
+// - 上次 L2 聚合时的 L1 条目数
+// - 上次 L3 生成时的 L2 条目数
+// - 最后执行时间
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryCheckpoint = void 0;
+exports.getMemoryCheckpoint = getMemoryCheckpoint;
+exports.resetMemoryCheckpoint = resetMemoryCheckpoint;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("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
+ */
+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);
+        }
+    }
+}
+exports.MemoryCheckpoint = MemoryCheckpoint;
+/** 全局单例（可配置路径） */
+let checkpointInstance = null;
+/**
+ * 获取全局检查点实例
+ * @param filePath 可选，首次调用时指定自定义路径
+ */
+function getMemoryCheckpoint(filePath) {
+    if (!checkpointInstance) {
+        checkpointInstance = new MemoryCheckpoint(filePath);
+    }
+    return checkpointInstance;
+}
+/** 重置全局实例（用于测试或路径变更场景） */
+function resetMemoryCheckpoint() {
+    checkpointInstance = null;
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/cjs/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/cjs/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/cjs/memory/extractor.js

@@ -0,0 +1,121 @@
+"use strict";
+// ============================================================
+// MemoryExtractor — LLM 驱动的原子事实提取器
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryExtractor = void 0;
+const prompts_ts_1 = require("./prompts.js");
+/**
+ * LLM 驱动的原子事实提取器
+ * 从对话历史中提取持久性、可复用的结构化事实（L1 Atom）
+ */
+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 = (0, prompts_ts_1.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: prompts_ts_1.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');
+    }
+}
+exports.MemoryExtractor = MemoryExtractor;
+//# sourceMappingURL=extractor.js.map

package/dist/cjs/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/cjs/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"}