@elizaos/plugin-memory 1.1.0 → 1.1.2

package/dist/providers/context-summary.d.ts

@@ -0,0 +1,12 @@
+import { type Provider } from '@elizaos/core';
+/**
+ * Context Summary Provider
+ *
+ * Provides summarized context from previous conversations.
+ * Returns session summaries with and without topics for flexible usage.
+ *
+ * Values returned:
+ * - sessionSummaries: Summary text only (without topics)
+ * - sessionSummariesWithTopics: Summary text with topics included
+ */
+export declare const contextSummaryProvider: Provider;

package/dist/providers/long-term-memory.d.ts

@@ -1,24 +1,17 @@
 import { type Provider } from '@elizaos/core';
 /**
- * Long-Term Memory Provider (Facts Only)
+ * Long-term Memory Provider
  *
- * Research: Section 3 "RAG Strategy" - Semantic & Procedural Knowledge
+ * Provides persistent facts about the user that have been learned across
+ * all conversations. This includes:
+ * - User identity and roles
+ * - Domain expertise
+ * - Preferences
+ * - Goals and projects
+ * - Custom definitions
+ * - Behavioral patterns
  *
- * This provider focuses ONLY on persistent knowledge about the user:
- * - **Semantic Facts**: Timeless information (preferences, identity, skills)
- * - **Procedural Patterns**: How the user does things, tool preferences
- *
- * DOES NOT INCLUDE:
- * - Recent messages (handled by RECENT_CONTEXT)
- * - Conversation summaries (handled by RECENT_CONTEXT)
- * - Current message (handled by RECENT_CONTEXT)
- *
- * Design Philosophy:
- * - Pure knowledge retrieval (no conversational context)
- * - Used in FINAL response phase (after planning)
- * - Provides "who is this user" context
- *
- * Template Variables Provided:
- * - `longTermMemories`: Formatted semantic/procedural facts
+ * This provider enriches the context with relevant long-term information
+ * to make the agent's responses more personalized and contextually aware.
  */
 export declare const longTermMemoryProvider: Provider;

package/dist/schemas/index.d.ts

@@ -1,19 +1,9 @@
 /**
- * Database Schemas for the Memory Plugin
+ * Database schemas for the Memory Plugin
  *
- * Research-Based Architecture:
- * - Single unified table for all memory types (Episodic, Semantic, Procedural)
- * - Hierarchical conversation summaries for token-efficient conversation history
- * - Separate embedding tables with dynamic dimension support for flexible vector search
- * - No separate access logs (metadata in memories table is sufficient)
- *
- * Design Philosophy:
- * - Simplicity: Fewer tables = easier to understand and maintain
- * - Flexibility: JSONB metadata allows schema evolution without migrations
- * - Performance: Strategic indexes for common query patterns
- * - Research-aligned: Implements SOTA memory architecture from refactor.md
- *
- * See: refactor.md Sections 4.1, 5.1.2, 6.1, and 6.3
+ * This module exports all database table schemas used by the plugin.
+ * These schemas are automatically migrated by ElizaOS's dynamic migration system.
  */
-export { longTermMemories, longTermMemoryEmbeddings } from './long-term-memories';
-export { conversationSummaries, conversationSummaryEmbeddings } from './conversation-summaries';
+export { longTermMemories } from './long-term-memories';
+export { sessionSummaries } from './session-summaries';
+export { memoryAccessLogs } from './memory-access-logs';

package/dist/schemas/long-term-memories.d.ts

@@ -1,17 +1,6 @@
 /**
- * Long-term Memory Storage Table
- *
- * Research: Section 4.1 "The SOTA Memory Schema"
- *
- * This table stores ALL persistent memories (episodic, semantic, procedural) with:
- * - Memory type taxonomy (3-tier cognitive hierarchy)
- * - Decay parameters for exponential forgetting
- * - Confidence and provenance tracking
- * - Contextual embeddings for superior retrieval
- * - Soft delete for contradiction handling
- *
- * Design Decision: Single unified table vs separate tables per type
- * Rationale: Easier to query across types, unified retrieval logic, flexible type reassignment
+ * Long-term memory storage table
+ * Stores persistent facts about users across all conversations
  */
 export declare const longTermMemories: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "long_term_memories";
@@ -74,27 +63,8 @@ export declare const longTermMemories: import("drizzle-orm/pg-core").PgTableWith
         }, {}, {
             length: 36;
         }>;
-        roomId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "room_id";
-            tableName: "long_term_memories";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 36;
-        }>;
-        type: import("drizzle-orm/pg-core").PgColumn<{
-            name: "type";
+        category: import("drizzle-orm/pg-core").PgColumn<{
+            name: "category";
             tableName: "long_term_memories";
             dataType: "string";
             columnType: "PgText";
@@ -127,48 +97,74 @@ export declare const longTermMemories: import("drizzle-orm/pg-core").PgTableWith
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        embeddingContext: import("drizzle-orm/pg-core").PgColumn<{
-            name: "embedding_context";
+        metadata: import("drizzle-orm/pg-core").PgColumn<{
+            name: "metadata";
             tableName: "long_term_memories";
-            dataType: "string";
-            columnType: "PgText";
-            data: string;
-            driverParam: string;
-            notNull: true;
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
+            enumValues: undefined;
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        confidence: import("drizzle-orm/pg-core").PgColumn<{
-            name: "confidence";
+        embedding: import("drizzle-orm/pg-core").PgColumn<{
+            name: "embedding";
             tableName: "long_term_memories";
-            dataType: "number";
-            columnType: "PgReal";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
+            dataType: "array";
+            columnType: "PgArray";
+            data: number[];
+            driverParam: string | (string | number)[];
+            notNull: false;
+            hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
             enumValues: undefined;
-            baseColumn: never;
+            baseColumn: import("drizzle-orm").Column<{
+                name: "embedding";
+                tableName: "long_term_memories";
+                dataType: "number";
+                columnType: "PgReal";
+                data: number;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
             identity: undefined;
             generated: undefined;
-        }, {}, {}>;
-        decayRate: import("drizzle-orm/pg-core").PgColumn<{
-            name: "decay_rate";
+        }, {}, {
+            baseBuilder: import("drizzle-orm/pg-core").PgColumnBuilder<{
+                name: "embedding";
+                dataType: "number";
+                columnType: "PgReal";
+                data: number;
+                driverParam: string | number;
+                enumValues: undefined;
+            }, {}, {}, import("drizzle-orm").ColumnBuilderExtraConfig>;
+            size: undefined;
+        }>;
+        confidence: import("drizzle-orm/pg-core").PgColumn<{
+            name: "confidence";
             tableName: "long_term_memories";
             dataType: "number";
             columnType: "PgReal";
             data: number;
             driverParam: string | number;
-            notNull: true;
+            notNull: false;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -178,15 +174,15 @@ export declare const longTermMemories: import("drizzle-orm/pg-core").PgTableWith
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        decayFunction: import("drizzle-orm/pg-core").PgColumn<{
-            name: "decay_function";
+        source: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source";
             tableName: "long_term_memories";
             dataType: "string";
             columnType: "PgText";
             data: string;
             driverParam: string;
-            notNull: true;
-            hasDefault: true;
+            notNull: false;
+            hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
@@ -212,81 +208,13 @@ export declare const longTermMemories: import("drizzle-orm/pg-core").PgTableWith
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        lastAccessedAt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "last_accessed_at";
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
             tableName: "long_term_memories";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
             driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        accessCount: import("drizzle-orm/pg-core").PgColumn<{
-            name: "access_count";
-            tableName: "long_term_memories";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        isActive: import("drizzle-orm/pg-core").PgColumn<{
-            name: "is_active";
-            tableName: "long_term_memories";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        source: import("drizzle-orm/pg-core").PgColumn<{
-            name: "source";
-            tableName: "long_term_memories";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: unknown;
-            driverParam: unknown;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        metadata: import("drizzle-orm/pg-core").PgColumn<{
-            name: "metadata";
-            tableName: "long_term_memories";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: unknown;
-            driverParam: unknown;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
@@ -297,157 +225,12 @@ export declare const longTermMemories: import("drizzle-orm/pg-core").PgTableWith
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        supersedesId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "supersedes_id";
+        lastAccessedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_accessed_at";
             tableName: "long_term_memories";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 36;
-        }>;
-    };
-    dialect: "pg";
-}>;
-/**
- * Long-term Memory Embeddings Table
- * Stores vector embeddings for semantic search with dynamic dimension support
- * Research: Section 3 "RAG Strategy"
- */
-export declare const longTermMemoryEmbeddings: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "long_term_memory_embeddings";
-    schema: undefined;
-    columns: {
-        id: import("drizzle-orm/pg-core").PgColumn<{
-            name: "id";
-            tableName: "long_term_memory_embeddings";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 36;
-        }>;
-        memoryId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "memory_id";
-            tableName: "long_term_memory_embeddings";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 36;
-        }>;
-        dim384: import("drizzle-orm/pg-core").PgColumn<{
-            name: "dim_384";
-            tableName: "long_term_memory_embeddings";
-            dataType: "array";
-            columnType: "PgVector";
-            data: number[];
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            dimensions: 384;
-        }>;
-        dim512: import("drizzle-orm/pg-core").PgColumn<{
-            name: "dim_512";
-            tableName: "long_term_memory_embeddings";
-            dataType: "array";
-            columnType: "PgVector";
-            data: number[];
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            dimensions: 512;
-        }>;
-        dim768: import("drizzle-orm/pg-core").PgColumn<{
-            name: "dim_768";
-            tableName: "long_term_memory_embeddings";
-            dataType: "array";
-            columnType: "PgVector";
-            data: number[];
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            dimensions: 768;
-        }>;
-        dim1024: import("drizzle-orm/pg-core").PgColumn<{
-            name: "dim_1024";
-            tableName: "long_term_memory_embeddings";
-            dataType: "array";
-            columnType: "PgVector";
-            data: number[];
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            dimensions: 1024;
-        }>;
-        dim1536: import("drizzle-orm/pg-core").PgColumn<{
-            name: "dim_1536";
-            tableName: "long_term_memory_embeddings";
-            dataType: "array";
-            columnType: "PgVector";
-            data: number[];
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
             driverParam: string;
             notNull: false;
             hasDefault: false;
@@ -458,36 +241,15 @@ export declare const longTermMemoryEmbeddings: import("drizzle-orm/pg-core").PgT
             baseColumn: never;
             identity: undefined;
             generated: undefined;
-        }, {}, {
-            dimensions: 1536;
-        }>;
-        dim3072: import("drizzle-orm/pg-core").PgColumn<{
-            name: "dim_3072";
-            tableName: "long_term_memory_embeddings";
-            dataType: "array";
-            columnType: "PgVector";
-            data: number[];
-            driverParam: string;
+        }, {}, {}>;
+        accessCount: import("drizzle-orm/pg-core").PgColumn<{
+            name: "access_count";
+            tableName: "long_term_memories";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
             notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            dimensions: 3072;
-        }>;
-        createdAt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at";
-            tableName: "long_term_memory_embeddings";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;

package/dist/schemas/memory-access-logs.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Memory access logs (optional - for tracking and improving memory retrieval)
+ */
+export declare const memoryAccessLogs: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "memory_access_logs";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "memory_access_logs";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 36;
+        }>;
+        agentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "agent_id";
+            tableName: "memory_access_logs";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 36;
+        }>;
+        memoryId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "memory_id";
+            tableName: "memory_access_logs";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 36;
+        }>;
+        memoryType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "memory_type";
+            tableName: "memory_access_logs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        accessedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "accessed_at";
+            tableName: "memory_access_logs";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        roomId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "room_id";
+            tableName: "memory_access_logs";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 36;
+        }>;
+        relevanceScore: import("drizzle-orm/pg-core").PgColumn<{
+            name: "relevance_score";
+            tableName: "memory_access_logs";
+            dataType: "number";
+            columnType: "PgReal";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        wasUseful: import("drizzle-orm/pg-core").PgColumn<{
+            name: "was_useful";
+            tableName: "memory_access_logs";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;