autosnippet 3.3.6 → 3.3.8

package/dist/lib/agent/memory/MemoryStore.d.ts

@@ -1,10 +1,8 @@
 /**
- * MemoryStore — 持久化记忆 SQLite 存储层
+ * MemoryStore — 持久化记忆 SQLite 存储层（Drizzle 类型安全版）
  *
  * 从 PersistentMemory.js 提取的 CRUD + SQL 基础设施。
  * 负责:
- *   - 表结构确保 (#ensureTable)
- *   - SQL 预编译 (#prepareStatements)
  *   - 基本 CRUD: add, update, delete, get
  *   - 批量查询: getAllActive, size, getStats
  *   - 访问计数: touchAccess
@@ -13,8 +11,9 @@
  *   - 统计: getStats, clearBootstrapMemories
  *
  * 设计原则:
- *   - 拥有 #db 和 #stmts，其他组件通过 MemoryStore 访问数据
- *   - update() 使用动态 SQL 但通过 named parameters 防注入
+ *   - 大部分操作通过 Drizzle 类型安全 API
+ *   - update() 使用 Drizzle 类型安全 partial update
+ *   - embedding 已迁移至 MemoryEmbeddingStore (JSON sidecar)
  *   - 数据序列化/反序列化统一在此层处理
  *
  * @module MemoryStore
@@ -34,7 +33,7 @@ export interface SqliteStatement {
     get(...params: unknown[]): Record<string, unknown> | undefined;
     all(...params: unknown[]): Record<string, unknown>[];
 }
-/** 数据库行 (raw row from SQLite) */
+/** 数据库行 (raw row from SQLite — 保持向后兼容) */
 export interface MemoryRow {
     id: string;
     type: string;
@@ -52,8 +51,6 @@ export interface MemoryRow {
     source_evidence: string | null;
     bootstrap_session: string | null;
     tags: string;
-    /** 向量嵌入 (Float32Array BLOB) */
-    embedding: Buffer | null;
     /** findSimilar 附加字段 */
     similarity?: number;
     related_memories_raw?: string;
@@ -76,8 +73,6 @@ export interface DeserializedMemory {
     sourceEvidence: string | null;
     bootstrapSession: string | null;
     tags: string[];
-    /** 向量嵌入 (Float32Array) */
-    embedding: number[] | null;
 }
 /** 添加记忆时的输入 */
 export interface MemoryInput {
@@ -91,8 +86,6 @@ export interface MemoryInput {
     sourceEvidence?: string | null;
     bootstrapSession?: string | null;
     tags?: string[];
-    /** 向量嵌入 */
-    embedding?: number[] | null;
 }
 /** 更新记忆时的字段 */
 export interface MemoryUpdates {
@@ -102,8 +95,6 @@ export interface MemoryUpdates {
     relatedEntities?: string[];
     relatedMemories?: string[];
     tags?: string[];
-    /** 向量嵌入 */
-    embedding?: number[] | null;
 }
 export declare class MemoryStore {
     #private;
@@ -119,7 +110,9 @@ export declare class MemoryStore {
         id: string;
         action: string;
     };
-    /** 更新已有记忆 */
+    /**
+     * 更新已有记忆
+     */
     update(id: string, updates: MemoryUpdates): boolean;
     /** 删除一条记忆 */
     delete(id: string): boolean;
@@ -184,30 +177,4 @@ export declare class MemoryStore {
     /** 反序列化数据库行为域对象 */
     static deserialize(row: MemoryRow): DeserializedMemory;
     static safeParseJSON<T>(str: string | null | undefined, fallback: T): T;
-    /**
-     * 更新单条记忆的向量嵌入
-     * @param id 记忆 ID
-     * @param embedding 向量数组
-     */
-    updateEmbedding(id: string, embedding: number[]): boolean;
-    /**
-     * 批量更新向量嵌入
-     * @param entries Array of { id, embedding }
-     */
-    batchUpdateEmbeddings(entries: Array<{
-        id: string;
-        embedding: number[];
-    }>): number;
-    /**
-     * 获取缺少向量嵌入的记忆 ID 和内容
-     * @param limit 最大返回数
-     */
-    getWithoutEmbedding(limit?: number): Array<{
-        id: string;
-        content: string;
-    }>;
-    /** 将 number[] 序列化为 Buffer (Float32Array → BLOB) */
-    static serializeEmbedding(embedding: number[]): Buffer;
-    /** 将 Buffer (BLOB) 反序列化为 number[] */
-    static deserializeEmbedding(blob: Buffer): number[];
 }