@ppagent/memory 0.1.2 → 0.3.1

package/dist/index.d.ts

@@ -305,7 +305,18 @@ interface KnowledgeSearchResult {
 }
 
 interface MemoryConfig {
+    /**
+     * 向量存储后端：
+     * - "auto"（默认）：运行时探测 @lancedb/lancedb 原生绑定，可用则 lancedb，否则回退 sqlite
+     *   （覆盖 Intel Mac / musl 等无预编译二进制的平台）。首次选定后写入数据目录 marker 固化，
+     *   避免环境变化导致静默换库（表现为「记忆丢失」）。
+     * - "lancedb" / "sqlite"：显式指定。
+     * 注意：两个后端的数据文件互不相通，切换需自行迁移。
+     */
+    provider?: "auto" | "lancedb" | "sqlite";
     lancedbPath: string;
+    /** sqlite 后端的数据库文件路径（默认 lancedbPath 同级目录下的 memory.sqlite3） */
+    sqlitePath?: string;
     grafeoPath: string;
     embeddingBaseUrl: string;
     embeddingApiKey: string;
@@ -371,7 +382,17 @@ interface MemoryConfig {
      * 不阻塞启动；嵌入式单进程使用时建议保持开启，否则 LanceDB 版本目录会无限膨胀、启动越来越慢。
      */
     autoOptimizeOnInit?: boolean;
-    /** 压实时保留多久内的历史版本（毫秒，默认 0 即仅保留当前版本）。*/
+    /**
+     * 运行期定期压实的间隔（毫秒，默认 6 小时；设为 0 或负数关闭定时任务）。
+     * 长驻服务不重启时版本仍会随写入累积，靠该定时任务周期性回收。
+     * 定时器已 unref，不会阻止进程退出；destroy() 会清除。
+     */
+    autoOptimizeIntervalMs?: number;
+    /**
+     * 压实时保留多久内的历史版本（毫秒，默认 0 即仅保留当前版本）。
+     * 注意：运行期定期压实会对该值强制施加 60 秒下限，避免误删仍被在途查询引用的版本；
+     * 启动时的那次压实无在途查询，按原值执行。
+     */
     optimizeVersionRetentionMs?: number;
     /** 启动时恢复各会话历史窗口的并发数（默认 8，旧行为为逐会话串行）。*/
     restoreConcurrency?: number;
@@ -379,7 +400,122 @@ interface MemoryConfig {
 interface ResolvedConfig extends Required<MemoryConfig> {
 }
 
-/** 单表压实结果（compaction + 历史版本清理）*/
+/**
+ * 向量存储后端抽象层的类型定义。
+ *
+ * 设计原则：接口只表达「语义」（结果意味着什么），不表达「机制」（怎么算出来的）。
+ * - 混合检索（RRF 融合）、回退策略、业务重排等组合逻辑在共享域层 memory.store.ts 实现，
+ *   provider 只需提供 vectorSearch / ftsSearch 两个检索原语，保证跨后端行为一致。
+ * - ANN、索引维护、存储压实等机制细节由各 provider 自行决定，接口仅以声明式
+ *   IndexSpec 提示与 capabilities 能力声明的方式暴露。
+ * - 过滤条件为结构化对象（而非 SQL 字符串），各 provider 翻译为自己的方言，
+ *   从根上消除转义/注入问题。
+ */
+type FilterCondition = 
+/** 等值匹配 */
+{
+    op: "eq";
+    field: string;
+    value: string | number;
+}
+/** 数值大于 */
+ | {
+    op: "gt";
+    field: string;
+    value: number;
+}
+/** 数值大于等于 */
+ | {
+    op: "gte";
+    field: string;
+    value: number;
+}
+/** 字段值属于集合。values 为空数组表示「不匹配任何行」 */
+ | {
+    op: "in";
+    field: string;
+    values: string[];
+}
+/**
+ * 匹配序列化为 JSON 字符串的 metadata 列中的键值对。
+ * 语义等同旧 LanceService.buildMetadataFilter 的 LIKE '%"key":value%' 模式：
+ * 仅适合标量值精确匹配，嵌套对象/含特殊字符的值不保证可靠。
+ */
+ | {
+    op: "jsonContains";
+    field: string;
+    key: string;
+    value: string | number | boolean;
+};
+/** 多个条件为 AND 关系。空数组等同于不过滤。 */
+type Filter = FilterCondition[];
+type ColumnType = 
+/** UTF-8 文本 */
+"text"
+/** 32 位整数 */
+ | "int"
+/** 64 位整数（毫秒时间戳等）。JS 侧统一以 number 读写 */
+ | "long"
+/** 定长 float32 向量，维度由 TableDef.vectorDimension 决定 */
+ | "vector";
+interface ColumnDef {
+    name: string;
+    type: ColumnType;
+    /** 默认 false。nullable 列用于 schema 演进的兼容（旧数据无此列） */
+    nullable?: boolean;
+}
+interface IndexSpec {
+    column: string;
+    /**
+     * - scalar：标量索引（btree 等价物），加速等值/范围过滤
+     * - fts：全文检索索引（BM25）
+     * - vector：向量检索加速提示。当前所有 provider 均为精确暴力扫描（ANN 暂不启用，
+     *   见 plans/vector-db-replacement-research.md 决议），该值仅作为将来启用 ANN 的声明位。
+     */
+    kind: "scalar" | "fts" | "vector";
+}
+interface TableDef {
+    name: string;
+    columns: ColumnDef[];
+    /** 有 vector 列时必填 */
+    vectorDimension?: number;
+    indexes: IndexSpec[];
+}
+interface OrderBySpec {
+    column: string;
+    ascending: boolean;
+}
+interface QueryOptions {
+    filter?: Filter;
+    orderBy?: OrderBySpec[];
+    limit?: number;
+    /** 只取指定列（性能优化，如 trendDaily 只读 created_at）。省略取全部列 */
+    select?: string[];
+}
+interface VectorSearchOptions {
+    filter?: Filter;
+    limit: number;
+}
+interface FtsSearchOptions {
+    /** 参与全文匹配的列（须已建 fts 索引） */
+    columns: string[];
+    filter?: Filter;
+    limit: number;
+}
+/** 通用行类型：列名 → 值。vector 列为 number[]，long 列为 number */
+type Row = Record<string, unknown>;
+/**
+ * 向量检索结果附带 _distance（L2 平方距离，越小越相近）。
+ * 各 provider 必须保持相同度量（L2），依赖距离阈值的上层逻辑才能跨后端一致。
+ */
+type ScoredRow = Row & {
+    _distance: number;
+};
+/** FTS 检索结果附带 _score（BM25 相关度，越大越相关；仅用于排序，绝对值跨后端无可比性） */
+type FtsRow = Row & {
+    _score: number;
+};
+/** 单表压实结果。不同后端的语义映射：LanceDB=碎片合并+版本清理；SQLite=incremental vacuum 等 */
 interface StorageOptimizeResult {
     table: string;
     fragmentsRemoved: number;
@@ -388,133 +524,46 @@ interface StorageOptimizeResult {
     oldVersionsRemoved: number;
     bytesRemoved: number;
 }
-declare class LanceService {
-    private readonly config;
-    private conn;
-    private messagesTable;
-    private topicsTable;
-    private factsTable;
-    private sessionsTable;
-    private documentsTable;
-    private chunksTable;
-    private isNewMessagesTable;
-    private isNewTopicsTable;
-    private isNewSessionsTable;
-    private isNewDocumentsTable;
-    private isNewChunksTable;
-    constructor(config: ResolvedConfig);
-    init(): Promise<void>;
-    /**
-     * 按需补齐索引：先经 listIndices 判存在，缺失的列才 createIndex（且 replace:false）。
-     * createIndex 默认 replace:true 会在每次启动时全量重建索引并提交新表版本——
-     * 这正是历史上「启动越来越慢 + _versions 目录膨胀」的根源，绝不可回退到无条件 createIndex。
-     */
-    private ensureIndexes;
-    /**
-     * 存储压实：逐表执行碎片合并 + 清理 retentionMs 之前的历史版本。
-     * 嵌入式场景下 LanceDB 不会自动做这件事，长期运行后版本/碎片无限累积会显著拖慢启动与查询。
-     */
-    optimizeStorage(retentionMs?: number): Promise<StorageOptimizeResult[]>;
-    /**
-     * 为存量 messages 表添加 parts 列（如果缺失）。
-     * LanceDB 0.14+ 支持 addColumns；旧版本会 throw，此时 rowToMessage 的 ?? "[]" 兜底。
-     */
-    private _ensurePartsColumn;
-    /**
-     * 为存量 topics 表添加 title 列（如果缺失）。
-     * 旧版本不支持 addColumns 时忽略，读取时 rowToTopic 的 ?? "" 兜底。
-     */
-    private _ensureTopicTitleColumn;
-    addMessages(messages: StoredMessage[]): Promise<void>;
-    addTopic(topic: Topic): Promise<void>;
-    updateTopicRecallCount(summaryId: string, count: number): Promise<void>;
-    getRecentTopics(chatId: string, userId: string, n1: number, n2: number, n3: number): Promise<{
-        detail: Topic[];
-        summary: Topic[];
-        concise: Topic[];
-    }>;
-    getMessagesSince(sessionId: string, since: number, limit?: number): Promise<StoredMessage[]>;
-    getLatestMessages(sessionId: string, limit: number): Promise<StoredMessage[]>;
-    /** 取某会话的全部消息（按 createdAt 升序），供管理面板分页切片使用 */
-    getAllMessagesBySession(sessionId: string): Promise<StoredMessage[]>;
-    searchMessages(vector: number[], filter?: string, limit?: number): Promise<Array<StoredMessage & {
-        _distance: number;
-    }>>;
-    hybridSearchMessages(query: string, vector: number[], filter?: string, limit?: number): Promise<StoredMessage[]>;
-    hybridSearchTopics(query: string, vector: number[], filter?: string, limit?: number): Promise<Topic[]>;
-    saveFact(fact: Fact): Promise<void>;
-    getAllFacts(): Promise<Fact[]>;
-    getAllSessionIds(): Promise<string[]>;
-    insertSession(session: Session): Promise<void>;
-    upsertSession(session: Session): Promise<void>;
-    getAllSessions(): Promise<Session[]>;
-    deleteSession(sessionId: string): Promise<void>;
-    /** 全量读取 topics（管理面板列表用，不做 recall 加权排序，按 endTime 倒序）*/
-    getAllTopics(): Promise<Topic[]>;
-    /** 删除单条 fact */
-    deleteFact(factId: string): Promise<void>;
-    /** 删除某会话下的全部消息（级联删除会话时使用）*/
-    deleteMessagesBySession(sessionId: string): Promise<void>;
-    /** 删除某会话下的全部 topics（级联删除会话时使用）*/
-    deleteTopicsBySession(sessionId: string): Promise<void>;
-    /** 各表行数统计（概览卡片用）*/
-    countAll(): Promise<{
-        sessions: number;
-        messages: number;
-        topics: number;
-        facts: number;
-    }>;
-    /**
-     * 按天聚合最近 days 天的活跃趋势（概览图表用）。
-     * 返回连续日期序列（含无数据的零值天），按本地日期分桶。
-     */
-    trendDaily(days: number): Promise<{
-        date: string;
-        sessions: number;
-        messages: number;
-        facts: number;
-    }[]>;
-    addDocument(doc: Document): Promise<void>;
-    addChunks(chunks: Chunk[]): Promise<void>;
-    updateDocumentGraphFlag(docId: string, hasGraph: boolean): Promise<void>;
-    getDocument(docId: string): Promise<Document | null>;
-    /** 查找同域同 hash 的文档（去重用）*/
-    findDocumentByHash(contentHash: string, filter?: string): Promise<Document | null>;
-    /** 按域过滤返回 docId 列表（chunkRedundantIds=false 时用于 chunk 过滤）*/
-    getDocIdsByDomain(filter?: string): Promise<string[]>;
-    /** 文档级粗召回：对摘要向量做向量搜索，定位候选文档 */
-    searchDocuments(vector: number[], filter?: string, limit?: number): Promise<Array<Document & {
-        _distance: number;
-    }>>;
-    /** 知识片段混合检索（BM25 + 向量），失败回退纯向量 */
-    searchChunks(query: string, vector: number[], filter?: string, limit?: number): Promise<Chunk[]>;
-    deleteDocument(docId: string): Promise<void>;
-    deleteChunksByDoc(docId: string): Promise<void>;
-    /** 全量读取文档（管理面板用），按更新时间倒序 */
-    getAllDocuments(): Promise<Document[]>;
-    /** 知识库行数统计 */
-    countKnowledge(): Promise<{
-        documents: number;
-        chunks: number;
-    }>;
-    /**
-     * 根据 metadata 字段内容构建 SQL LIKE 过滤条件。
-     *
-     * metadata 以 JSON 字符串存储，此方法将键值对转换为 SQL LIKE 表达式，
-     * 可直接传给 searchMessages / hybridSearchTopics 的 filter 参数。
-     *
-     * 示例：buildMetadataFilter({ env: "prod", version: 2 })
-     *   → `metadata LIKE '%"env":"prod"%' AND metadata LIKE '%"version":2%'`
-     *
-     * 注意：仅适合简单标量值（字符串、数字、布尔）的精确匹配。
-     * 复杂嵌套对象或含空格的 JSON 值可能无法可靠匹配。
-     */
-    static buildMetadataFilter(conditions: Record<string, string | number | boolean>): string;
+interface ProviderCapabilities {
+    /** 是否支持原生 FTS（BM25）。false 时域层混合检索自动降级为纯向量 */
+    fts: boolean;
+    /** 向量检索是否为 ANN 近似（false = 精确暴力）。当前所有 provider 均为 false */
+    ann: boolean;
+    /** optimize() 是否有实际效果（LanceDB 版本回收必需；SQLite 可选） */
+    optimize: boolean;
+}
+/**
+ * 向量存储后端需要实现的最小原语集合。
+ *
+ * 实现约定：
+ * - init 必须幂等：表已存在则打开并按 TableDef 补齐缺失的列（schema 演进）与索引；
+ *   不存在则创建。
+ * - 所有 filter 参数为结构化 Filter，provider 内部翻译为自己的方言并负责转义/参数化。
+ * - vectorSearch 使用 L2 距离，返回按 _distance 升序的前 limit 行。
+ * - ftsSearch 返回按 _score（BM25）降序的前 limit 行；查询词的分词由 provider 负责
+ *   （中文场景 sqlite provider 使用 jieba；lancedb provider 使用 tantivy 内置分词）。
+ * - add/update/delete 需保证同一表内的派生结构（如 sqlite 的 FTS 影子表）事务一致。
+ */
+interface VectorStoreProvider {
+    /** provider 标识，用于日志与数据目录 marker */
+    readonly kind: string;
+    init(tables: TableDef[]): Promise<void>;
+    add(table: string, rows: Row[]): Promise<void>;
+    update(table: string, values: Row, filter: Filter): Promise<void>;
+    deleteWhere(table: string, filter: Filter): Promise<void>;
+    query(table: string, opts?: QueryOptions): Promise<Row[]>;
+    vectorSearch(table: string, vector: number[], opts: VectorSearchOptions): Promise<ScoredRow[]>;
+    ftsSearch(table: string, query: string, opts: FtsSearchOptions): Promise<FtsRow[]>;
+    count(table: string, filter?: Filter): Promise<number>;
+    /** 存储压实与历史版本回收。retentionMs：保留多久内的历史版本（不支持版本概念的后端可忽略） */
+    optimize(retentionMs: number): Promise<StorageOptimizeResult[]>;
+    capabilities(): ProviderCapabilities;
+    close(): Promise<void>;
 }
 
 declare class MemoryManager {
     private readonly config;
-    private readonly lance;
+    private readonly store;
     private readonly grafeo;
     private readonly embed;
     private readonly llm;
@@ -523,8 +572,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
@@ -553,7 +606,7 @@ declare class MemoryManager {
      */
     getFactsForContext(userId: string, chatId: string): Promise<string>;
     getHistoryWindow(sessionId: string): string;
-    private buildLanceFilter;
+    private buildScopeFilter;
     private deserializeSession;
     private serializeSession;
     getRecentMessages(sessionId: string, limit: number): Promise<StoredMessage[]>;
@@ -692,6 +745,117 @@ declare class MemoryManager {
     destroy(): void;
 }
 
+/**
+ * 记忆系统的存储域层：保持原 LanceService 的公开方法面，内部组合
+ * VectorStoreProvider 的通用原语实现。业务逻辑（混合检索融合、话题回退、
+ * recall 加权重排）全部在此层，各后端 provider 不感知。
+ */
+declare class MemoryStore {
+    private readonly config;
+    private provider;
+    private readonly providerOverride?;
+    /** provider 省略时在 init() 阶段经 provider.resolver 自动探测创建（测试可显式注入） */
+    constructor(config: ResolvedConfig, provider?: VectorStoreProvider);
+    /** 当前后端 provider 标识（日志/诊断用） */
+    get providerKind(): string;
+    init(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * 存储压实（碎片合并 + 历史版本清理）。
+     * LanceDB 后端长期运行必须定期执行；SQLite 后端为可选的空间回收。
+     */
+    optimizeStorage(retentionMs?: number): Promise<StorageOptimizeResult[]>;
+    addMessages(messages: StoredMessage[]): Promise<void>;
+    getMessagesSince(sessionId: string, since: number, limit?: number): Promise<StoredMessage[]>;
+    getLatestMessages(sessionId: string, limit: number): Promise<StoredMessage[]>;
+    /** 取某会话的全部消息（按 createdAt 升序），供管理面板分页切片使用 */
+    getAllMessagesBySession(sessionId: string): Promise<StoredMessage[]>;
+    searchMessages(vector: number[], filter?: Filter, limit?: number): Promise<Array<StoredMessage & {
+        _distance: number;
+    }>>;
+    hybridSearchMessages(query: string, vector: number[], filter?: Filter, limit?: number): Promise<StoredMessage[]>;
+    hybridSearchTopics(query: string, vector: number[], filter?: Filter, limit?: number): Promise<Topic[]>;
+    /**
+     * 通用混合检索：FTS（BM25）与向量两路各取 limit*HYBRID_OVERFETCH 候选，RRF 融合。
+     * FTS 不可用（后端不支持或查询失败）时降级为纯向量。返回融合后的完整候选序列（未截断）。
+     */
+    private hybridSearch;
+    private keyColumnOf;
+    addTopic(topic: Topic): Promise<void>;
+    updateTopicRecallCount(summaryId: string, count: number): Promise<void>;
+    getRecentTopics(chatId: string, userId: string, n1: number, n2: number, n3: number): Promise<{
+        detail: Topic[];
+        summary: Topic[];
+        concise: Topic[];
+    }>;
+    /** 全量读取 topics（管理面板列表用，不做 recall 加权排序，按 endTime 倒序）*/
+    getAllTopics(): Promise<Topic[]>;
+    deleteTopicsBySession(sessionId: string): Promise<void>;
+    saveFact(fact: Fact): Promise<void>;
+    getAllFacts(): Promise<Fact[]>;
+    /** 删除单条 fact */
+    deleteFact(factId: string): Promise<void>;
+    getAllSessionIds(): Promise<string[]>;
+    insertSession(session: Session): Promise<void>;
+    upsertSession(session: Session): Promise<void>;
+    getAllSessions(): Promise<Session[]>;
+    deleteSession(sessionId: string): Promise<void>;
+    /** 删除某会话下的全部消息（级联删除会话时使用）*/
+    deleteMessagesBySession(sessionId: string): Promise<void>;
+    /** 各表行数统计（概览卡片用）*/
+    countAll(): Promise<{
+        sessions: number;
+        messages: number;
+        topics: number;
+        facts: number;
+    }>;
+    /**
+     * 按天聚合最近 days 天的活跃趋势（概览图表用）。
+     * 返回连续日期序列（含无数据的零值天），按本地日期分桶。
+     */
+    trendDaily(days: number): Promise<{
+        date: string;
+        sessions: number;
+        messages: number;
+        facts: number;
+    }[]>;
+    addDocument(doc: Document): Promise<void>;
+    addChunks(chunks: Chunk[]): Promise<void>;
+    updateDocumentGraphFlag(docId: string, hasGraph: boolean): Promise<void>;
+    getDocument(docId: string): Promise<Document | null>;
+    /** 查找同域同 hash 的文档（去重用）*/
+    findDocumentByHash(contentHash: string, filter?: Filter): Promise<Document | null>;
+    /** 按域过滤返回 docId 列表（chunkRedundantIds=false 时用于 chunk 过滤）*/
+    getDocIdsByDomain(filter?: Filter): Promise<string[]>;
+    /** 文档级粗召回：对摘要向量做向量搜索，定位候选文档 */
+    searchDocuments(vector: number[], filter?: Filter, limit?: number): Promise<Array<Document & {
+        _distance: number;
+    }>>;
+    /** 知识片段混合检索（BM25 + 向量），失败回退纯向量 */
+    searchChunks(query: string, vector: number[], filter?: Filter, limit?: number): Promise<Chunk[]>;
+    deleteDocument(docId: string): Promise<void>;
+    deleteChunksByDoc(docId: string): Promise<void>;
+    /** 全量读取文档（管理面板用），按更新时间倒序 */
+    getAllDocuments(): Promise<Document[]>;
+    /** 知识库行数统计 */
+    countKnowledge(): Promise<{
+        documents: number;
+        chunks: number;
+    }>;
+    /**
+     * 根据 metadata 字段内容构建结构化过滤条件。
+     *
+     * metadata 以 JSON 字符串存储，此方法将键值对转换为 jsonContains 条件，
+     * 可直接传给 searchMessages / hybridSearchTopics 的 filter 参数。
+     *
+     * 注意：仅适合简单标量值（字符串、数字、布尔）的精确匹配。
+     * 复杂嵌套对象或含空格的 JSON 值可能无法可靠匹配。
+     */
+    static buildMetadataFilter(conditions: Record<string, string | number | boolean>): Filter;
+}
+
+type ProviderKind = "lancedb" | "sqlite";
+
 declare const DEFAULT_NODE_TYPES: readonly ["Person", "Group", "Organization", "Project", "Task", "Decision", "Plan", "Event", "Product", "Technology", "Data", "Document", "Topic", "Concept", "Preference", "Habit", "Goal", "Skill", "Attribute", "Value", "Status", "Time", "Location", "Resource", "Relationship"];
 declare const DEFAULT_RELATION_TYPES: readonly ["is_a", "part_of", "belongs_to", "contains", "has_member", "mentioned_in", "refers_to", "same_as", "alias_of", "related_to", "associated_with", "uses", "creates", "updates", "buys", "owns", "consumes", "works_on", "prefers", "likes", "dislikes", "interested_in", "favorite", "plans", "decides", "habit_of", "tends_to", "avoids", "skilled_in", "learning", "knows", "friends_with", "married_to", "parent_of", "child_of", "lives_with", "depends_on", "built_with", "integrates_with", "deployed_on", "inputs", "outputs", "trained_on", "predicts", "happens_at", "started_at", "ended_at", "affects", "causes", "leads_to", "improves", "reduces", "assigned_to", "executed_by", "blocks", "completes", "describes", "explains", "references"];
 type NodeType = (typeof DEFAULT_NODE_TYPES)[number];
@@ -700,4 +864,4 @@ type RelationType = (typeof DEFAULT_RELATION_TYPES)[number];
 declare const KIND_CONVERSATION = "conversation";
 declare const KIND_KNOWLEDGE = "knowledge";
 
-export { type AddDocumentOptions, type BuildGraphMode, type Chunk, type ChunkHit, type ChunkPiece, type CompressOutput, type ContentPart, DEFAULT_NODE_TYPES, DEFAULT_RELATION_TYPES, type Document, type DomainIds, type Entity, type EntityMeta, type Fact, type FactLevel, KIND_CONVERSATION, KIND_KNOWLEDGE, type KnowledgeSearchOptions, type KnowledgeSearchResult, LanceService, type MemoryConfig, MemoryManager, type MessageType, type NodeType, type PageParams, type Paginated, type RawMessage, type Relation, type RelationType, type SearchMode, type SearchOptions, type SearchResult, type SearchScope, type Session, type SessionEntry, type SessionSearchOptions, type SessionView, type StorageOptimizeResult, type StoredMessage, type Topic, type UpdateChatOptions, type UpdateEntityOptions, type UpdateSessionOptions };
+export { type AddDocumentOptions, type BuildGraphMode, type Chunk, type ChunkHit, type ChunkPiece, type CompressOutput, type ContentPart, DEFAULT_NODE_TYPES, DEFAULT_RELATION_TYPES, type Document, type DomainIds, type Entity, type EntityMeta, type Fact, type FactLevel, type Filter, type FilterCondition, KIND_CONVERSATION, KIND_KNOWLEDGE, type KnowledgeSearchOptions, type KnowledgeSearchResult, type MemoryConfig, MemoryManager, MemoryStore, type MessageType, type NodeType, type PageParams, type Paginated, type ProviderCapabilities, type ProviderKind, type RawMessage, type Relation, type RelationType, type SearchMode, type SearchOptions, type SearchResult, type SearchScope, type Session, type SessionEntry, type SessionSearchOptions, type SessionView, type StorageOptimizeResult, type StoredMessage, type Topic, type UpdateChatOptions, type UpdateEntityOptions, type UpdateSessionOptions, type VectorStoreProvider };