@elizaos/plugin-memory 1.1.0 → 1.1.2

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

@@ -1,53 +0,0 @@
-import type { IAgentRuntime, UUID } from '@elizaos/core';
-import { type LongTermMemory, type LongTermMemoryRetrievalResult, type LongTermMemorySearchParams, type EmbeddingDimensionColumn, MemoryType } from '../types/index';
-/**
- * Long-Term Memory Repository
- *
- * Handles all database operations for long-term memories
- * Provides clean data access layer separated from business logic
- */
-export declare class LongTermMemoryRepository {
-    private runtime;
-    private embeddingDimension?;
-    constructor(runtime: IAgentRuntime, embeddingDimension?: EmbeddingDimensionColumn);
-    /**
-     * Get database instance with health check
-     */
-    private getDb;
-    /**
-     * Insert a new memory into database
-     */
-    insert(memory: Omit<LongTermMemory, 'id' | 'createdAt' | 'lastAccessedAt' | 'accessCount' | 'isActive' | 'embedding'>, embedding?: number[]): Promise<LongTermMemory>;
-    /**
-     * Find memory by ID
-     */
-    findById(id: UUID): Promise<LongTermMemory | null>;
-    /**
-     * Update existing memory
-     */
-    update(id: UUID, updates: Partial<LongTermMemory>, newEmbedding?: number[]): Promise<void>;
-    /**
-     * Delete memory (hard delete)
-     */
-    delete(id: UUID): Promise<void>;
-    /**
-     * Find memories by entity with optional filters
-     */
-    findByEntity(entityId: UUID, type?: MemoryType, limit?: number, includeInactive?: boolean): Promise<LongTermMemory[]>;
-    /**
-     * Vector search for memories
-     */
-    vectorSearch(params: LongTermMemorySearchParams, queryEmbedding: number[], similarityThreshold?: number): Promise<LongTermMemoryRetrievalResult[]>;
-    /**
-     * Fetch all active memories for BM25 indexing
-     */
-    fetchAllActive(): Promise<Array<{
-        id: UUID;
-        content: string;
-        embeddingContext: string;
-    }>>;
-    /**
-     * Update access metadata (lastAccessedAt and accessCount)
-     */
-    updateAccessMetadata(memoryIds: UUID[]): Promise<void>;
-}

package/dist/schemas/conversation-summaries.d.ts

@@ -1,494 +0,0 @@
-/**
- * Conversation Summaries Table - Hierarchical Summarization
- *
- * Research: Section 5.1.2 "Hierarchical Episodic Summarization"
- *
- * This table implements recursive, multi-level summarization for long conversations:
- * - Level 0: Raw messages (stored elsewhere)
- * - Level 1: Summary of 50-100 messages
- * - Level 2: Summary of 5-10 Level 1 summaries
- * - Level 3+: Recursive summarization for very long sessions
- *
- * Benefits:
- * - Dramatic token reduction (10x compression)
- * - Better context management for 100+ message sessions
- * - Preserves conversational narrative without exploding context window
- *
- * Design Philosophy:
- * - Summaries reference other summaries (parentSummaryId for tree structure)
- * - Each summary has a level (depth in the hierarchy)
- * - Token count tracked for precise budget management
- * - Time ranges tracked for temporal queries
- *
- * Note: "Conversation Summaries" provide narrative context, distinct from "Facts" which are discrete knowledge units.
- */
-export declare const conversationSummaries: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "conversation_summaries";
-    schema: undefined;
-    columns: {
-        id: import("drizzle-orm/pg-core").PgColumn<{
-            name: "id";
-            tableName: "conversation_summaries";
-            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: "conversation_summaries";
-            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;
-        }>;
-        entityId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "entity_id";
-            tableName: "conversation_summaries";
-            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;
-        }>;
-        roomId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "room_id";
-            tableName: "conversation_summaries";
-            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;
-        }>;
-        level: import("drizzle-orm/pg-core").PgColumn<{
-            name: "level";
-            tableName: "conversation_summaries";
-            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;
-        }, {}, {}>;
-        parentSummaryId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "parent_summary_id";
-            tableName: "conversation_summaries";
-            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;
-        }>;
-        content: import("drizzle-orm/pg-core").PgColumn<{
-            name: "content";
-            tableName: "conversation_summaries";
-            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;
-        }, {}, {}>;
-        tokenCount: import("drizzle-orm/pg-core").PgColumn<{
-            name: "token_count";
-            tableName: "conversation_summaries";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        startTime: import("drizzle-orm/pg-core").PgColumn<{
-            name: "start_time";
-            tableName: "conversation_summaries";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        endTime: import("drizzle-orm/pg-core").PgColumn<{
-            name: "end_time";
-            tableName: "conversation_summaries";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        sourceCount: import("drizzle-orm/pg-core").PgColumn<{
-            name: "source_count";
-            tableName: "conversation_summaries";
-            dataType: "number";
-            columnType: "PgInteger";
-            data: number;
-            driverParam: string | number;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        sourceIds: import("drizzle-orm/pg-core").PgColumn<{
-            name: "source_ids";
-            tableName: "conversation_summaries";
-            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;
-        }, {}, {}>;
-        createdAt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at";
-            tableName: "conversation_summaries";
-            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;
-        }, {}, {}>;
-        lastAccessedAt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "last_accessed_at";
-            tableName: "conversation_summaries";
-            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: "conversation_summaries";
-            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;
-        }, {}, {}>;
-        metadata: import("drizzle-orm/pg-core").PgColumn<{
-            name: "metadata";
-            tableName: "conversation_summaries";
-            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;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * Conversation Summary Embeddings Table
- * Stores vector embeddings for semantic search of summaries with dynamic dimension support
- * Research: Section 5.1.2 "Hierarchical Episodic Summarization" + Section 3 "RAG Strategy"
- */
-export declare const conversationSummaryEmbeddings: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "conversation_summary_embeddings";
-    schema: undefined;
-    columns: {
-        id: import("drizzle-orm/pg-core").PgColumn<{
-            name: "id";
-            tableName: "conversation_summary_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;
-        }>;
-        summaryId: import("drizzle-orm/pg-core").PgColumn<{
-            name: "summary_id";
-            tableName: "conversation_summary_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: "conversation_summary_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: "conversation_summary_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: "conversation_summary_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: "conversation_summary_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: "conversation_summary_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: 1536;
-        }>;
-        dim3072: import("drizzle-orm/pg-core").PgColumn<{
-            name: "dim_3072";
-            tableName: "conversation_summary_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: 3072;
-        }>;
-        createdAt: import("drizzle-orm/pg-core").PgColumn<{
-            name: "created_at";
-            tableName: "conversation_summary_embeddings";
-            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;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;

package/dist/utils/db-mapping.d.ts

@@ -1,20 +0,0 @@
-import { type LongTermMemory, type ConversationSummary } from '../types/index';
-/**
- * Database Row Mapping Utilities
- *
- * Maps raw database rows to strongly-typed domain objects
- */
-/**
- * Map database row to LongTermMemory object
- *
- * @param row - Raw database row
- * @returns Typed LongTermMemory object
- */
-export declare function mapDbRowToLongTermMemory(row: any): LongTermMemory;
-/**
- * Map database row to ConversationSummary object
- *
- * @param row - Raw database row
- * @returns Typed ConversationSummary object
- */
-export declare function mapDbRowToConversationSummary(row: any): ConversationSummary;

package/dist/utils/decay-scoring.d.ts

@@ -1,41 +0,0 @@
-import { DecayFunction, type LongTermMemoryRetrievalResult } from '../types/index';
-/**
- * Decay Scoring Utilities
- *
- * Research: Section 4.2 "Mathematical Model for Memory Decay"
- *
- * Implements exponential and linear decay functions to model natural
- * forgetting curves inspired by cognitive science research (Ebbinghaus forgetting curve)
- */
-/**
- * Calculate decay factor based on decay function type
- *
- * Research: Section 4.2 "Mathematical Model for Memory Decay"
- * Formula: Score = Relevance * Confidence * exp(-λ * (t_now - t_last))
- *
- * @param decayFunction - Type of decay function (EXPONENTIAL, LINEAR, NONE)
- * @param decayRate - Decay rate (lambda λ)
- * @param timeDeltaDays - Time since last access in days
- * @returns Decay factor (0.0 to 1.0)
- */
-export declare function calculateDecayFactor(decayFunction: DecayFunction, decayRate: number, timeDeltaDays: number): number;
-/**
- * Calculate access boost factor from access count
- *
- * Research: Section 4.2.2 "Reinforcement"
- * More accesses = stronger memory
- *
- * @param accessCount - Number of times memory has been accessed
- * @returns Boost factor (>= 1.0)
- */
-export declare function calculateAccessBoost(accessCount: number): number;
-/**
- * Apply decay scoring to a set of memories
- *
- * Research: Section 4.2 "Mathematical Model for Memory Decay"
- * Calculates activation score and final score for each memory
- *
- * @param memories - Array of memory retrieval results
- * @returns Array with decay scores applied
- */
-export declare function applyDecayScoring(memories: LongTermMemoryRetrievalResult[]): LongTermMemoryRetrievalResult[];

package/dist/utils/embedding.d.ts

@@ -1,21 +0,0 @@
-import { type IAgentRuntime } from '@elizaos/core';
-/**
- * Embedding Generation Utility
- *
- * Research: Section 3.2.1 "Contextual Embeddings"
- */
-/**
- * Generate embedding for text using the runtime's embedding model
- *
- * @param runtime - Agent runtime instance
- * @param text - Text to generate embedding for
- * @returns Embedding vector
- */
-export declare function generateEmbedding(runtime: IAgentRuntime, text: string): Promise<number[]>;
-/**
- * Clean and normalize an embedding vector
- *
- * @param embedding - Raw embedding vector
- * @returns Cleaned vector with finite numbers and fixed precision
- */
-export declare function cleanEmbedding(embedding: number[]): number[];

package/dist/utils/formatting.d.ts

@@ -1,17 +0,0 @@
-import { type LongTermMemoryRetrievalResult } from '../types/index';
-/**
- * Memory Formatting Utilities
- *
- * Research: Section 5.1.3 "Tier 3: Just-In-Time Injection"
- * Formats memories for LLM context in a human-readable format
- */
-/**
- * Format memories for context injection
- *
- * Research: Section 5.1.3 "Tier 3: Just-In-Time Injection"
- * Groups by type and formats in a human-readable markdown format
- *
- * @param memories - Array of memories to format
- * @returns Formatted string for LLM context
- */
-export declare function formatMemoriesForContext(memories: LongTermMemoryRetrievalResult[]): string;

package/dist/utils/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * Utility Functions for Memory Plugin
- *
- * This module exports reusable utility functions for:
- * - Embedding generation and cleaning
- * - Decay scoring calculations
- * - Search result merging
- * - Memory formatting
- * - Database row mapping
- * - Token counting and budget enforcement
- */
-export * from './embedding';
-export * from './decay-scoring';
-export * from './search-merging';
-export * from './formatting';
-export * from './db-mapping';
-export * from './token-counter';

package/dist/utils/search-merging.d.ts

@@ -1,18 +0,0 @@
-import type { LongTermMemoryRetrievalResult } from '../types/index';
-/**
- * Search Result Merging Utilities
- *
- * Research: Section 3.2.1 "Contextual Retrieval"
- * Combines multiple ranking methods (Vector + BM25) for superior retrieval
- */
-/**
- * Merge vector and BM25 search results
- *
- * Research: Section 3.2.1 "Contextual Retrieval"
- * When a memory appears in both result sets, average their scores
- *
- * @param vectorResults - Results from vector search
- * @param bm25Results - Results from BM25 search
- * @returns Merged results with combined scores
- */
-export declare function mergeSearchResults(vectorResults: LongTermMemoryRetrievalResult[], bm25Results: LongTermMemoryRetrievalResult[]): LongTermMemoryRetrievalResult[];