@ppagent/memory 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -371,7 +371,17 @@ interface MemoryConfig {
      * 不阻塞启动；嵌入式单进程使用时建议保持开启，否则 LanceDB 版本目录会无限膨胀、启动越来越慢。
      */
     autoOptimizeOnInit?: boolean;
-    /** 压实时保留多久内的历史版本（毫秒，默认 0 即仅保留当前版本）。*/
+    /**
+     * 运行期定期压实的间隔（毫秒，默认 6 小时；设为 0 或负数关闭定时任务）。
+     * 长驻服务不重启时版本仍会随写入累积，靠该定时任务周期性回收。
+     * 定时器已 unref，不会阻止进程退出；destroy() 会清除。
+     */
+    autoOptimizeIntervalMs?: number;
+    /**
+     * 压实时保留多久内的历史版本（毫秒，默认 0 即仅保留当前版本）。
+     * 注意：运行期定期压实会对该值强制施加 60 秒下限，避免误删仍被在途查询引用的版本；
+     * 启动时的那次压实无在途查询，按原值执行。
+     */
     optimizeVersionRetentionMs?: number;
     /** 启动时恢复各会话历史窗口的并发数（默认 8，旧行为为逐会话串行）。*/
     restoreConcurrency?: number;
@@ -523,8 +533,12 @@ declare class MemoryManager {
     private readonly compressManager;
     private readonly knowledgeManager;
     private readonly sessionMap;
+    private optimizeTimer?;
+    private optimizeRunning;
     constructor(config: MemoryConfig);
     init(): Promise<void>;
+    /** 后台压实的统一入口：防重入（上一轮未结束则跳过），失败仅告警不影响服务。*/
+    private runBackgroundOptimize;
     /**
      * 手动触发存储压实与历史版本清理（init 后台会自动执行一次；上层维护任务也可调用）。
      * @param retentionMs 保留多久内的历史版本，默认取配置 optimizeVersionRetentionMs

package/dist/index.js

@@ -47,6 +47,7 @@ function resolveConfig(config) {
     graphExtractConcurrency: config.graphExtractConcurrency ?? 2,
     graphBuildTimeoutMs: config.graphBuildTimeoutMs ?? 12e4,
     autoOptimizeOnInit: config.autoOptimizeOnInit ?? true,
+    autoOptimizeIntervalMs: config.autoOptimizeIntervalMs ?? 6 * 36e5,
     optimizeVersionRetentionMs: config.optimizeVersionRetentionMs ?? 0,
     restoreConcurrency: config.restoreConcurrency ?? 8
   };
@@ -1251,9 +1252,13 @@ var LanceService = class {
     }
   }
   async getLatestMessages(sessionId, limit) {
+    if (limit <= 0) return [];
     try {
-      const rows = await this.messagesTable.query().where(eqFilter("session_id", sessionId)).limit(limit * 3).toArray();
-      return rows.sort((a, b) => Number(b.created_at) - Number(a.created_at)).slice(0, limit).reverse().map(rowToMessage);
+      const rows = await this.messagesTable.query().where(eqFilter("session_id", sessionId)).orderBy([
+        { columnName: "created_at", ascending: false },
+        { columnName: "message_id", ascending: false }
+      ]).limit(limit).toArray();
+      return rows.reverse().map(rowToMessage);
     } catch {
       return [];
     }
@@ -2658,6 +2663,8 @@ var MemoryManager = class {
   compressManager;
   knowledgeManager;
   sessionMap = /* @__PURE__ */ new Map();
+  optimizeTimer;
+  optimizeRunning = false;
   constructor(config) {
     this.config = resolveConfig(config);
     this.lance = new LanceService(this.config);
@@ -2693,17 +2700,33 @@ var MemoryManager = class {
     }
     await this.restoreFromStorage();
     if (this.config.autoOptimizeOnInit) {
-      void this.optimizeStorage().then((results) => {
-        const versions = results.reduce((s, r) => s + r.oldVersionsRemoved, 0);
-        const fragments = results.reduce((s, r) => s + r.fragmentsRemoved, 0);
-        if (versions > 0 || fragments > 0) {
-          console.info(
-            `[MemoryManager] \u540E\u53F0\u5B58\u50A8\u538B\u5B9E\u5B8C\u6210\uFF1A\u6E05\u7406\u5386\u53F2\u7248\u672C ${versions} \u4E2A\uFF0C\u5408\u5E76\u788E\u7247 ${fragments} \u4E2A`
-          );
-        }
-      }).catch((err) => {
-        console.warn("[MemoryManager] \u540E\u53F0\u5B58\u50A8\u538B\u5B9E\u5931\u8D25\uFF08\u4E0D\u5F71\u54CD\u670D\u52A1\uFF09:", err);
-      });
+      void this.runBackgroundOptimize(this.config.optimizeVersionRetentionMs);
+    }
+    if (this.config.autoOptimizeIntervalMs > 0) {
+      const retention = Math.max(this.config.optimizeVersionRetentionMs, 6e4);
+      this.optimizeTimer = setInterval(() => {
+        void this.runBackgroundOptimize(retention);
+      }, this.config.autoOptimizeIntervalMs);
+      this.optimizeTimer.unref?.();
+    }
+  }
+  /** 后台压实的统一入口：防重入（上一轮未结束则跳过），失败仅告警不影响服务。*/
+  async runBackgroundOptimize(retentionMs) {
+    if (this.optimizeRunning) return;
+    this.optimizeRunning = true;
+    try {
+      const results = await this.optimizeStorage(retentionMs);
+      const versions = results.reduce((s, r) => s + r.oldVersionsRemoved, 0);
+      const fragments = results.reduce((s, r) => s + r.fragmentsRemoved, 0);
+      if (versions > 0 || fragments > 0) {
+        console.info(
+          `[MemoryManager] \u540E\u53F0\u5B58\u50A8\u538B\u5B9E\u5B8C\u6210\uFF1A\u6E05\u7406\u5386\u53F2\u7248\u672C ${versions} \u4E2A\uFF0C\u5408\u5E76\u788E\u7247 ${fragments} \u4E2A`
+        );
+      }
+    } catch (err) {
+      console.warn("[MemoryManager] \u540E\u53F0\u5B58\u50A8\u538B\u5B9E\u5931\u8D25\uFF08\u4E0D\u5F71\u54CD\u670D\u52A1\uFF09:", err);
+    } finally {
+      this.optimizeRunning = false;
     }
   }
   /**
@@ -3113,6 +3136,10 @@ var MemoryManager = class {
     return page ? this.knowledgeManager.listDocuments(filter, page) : this.knowledgeManager.listDocuments(filter);
   }
   destroy() {
+    if (this.optimizeTimer) {
+      clearInterval(this.optimizeTimer);
+      this.optimizeTimer = void 0;
+    }
     this.grafeo.close();
   }
 };

package/llms.txt

@@ -573,9 +573,9 @@ Context:
 
 Returns the compressed history window for a session. This is prompt-ready text built from recent `Topic` records using `topicRatio` and `historyWindowTokenLimit`.
 
-### `getRecentMessages(sessionId, limit): Promise<StoredMessage[]>`
-
-Returns recent messages for a session.
+### `getRecentMessages(sessionId, limit): Promise<StoredMessage[]>`
+
+Returns the globally latest `limit` messages for a session in chronological order (oldest to newest within the returned window). The storage query orders by `createdAt` and uses `messageId` as a deterministic same-timestamp tiebreak before applying the limit, so long sessions do not return an early candidate window.
 
 ### Session APIs
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ppagent/memory",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "独立记忆系统模块，基于 LanceDB + Grafeo 实现向量存储与知识图谱",
   "type": "module",
   "main": "dist/index.js",