@lov3kaizen/agentsea-memory 0.5.1

package/dist/core.types-lkxKv-bW.d.cts

@@ -0,0 +1,242 @@
+/**
+ * Core Memory Types
+ *
+ * Core type definitions for memory management.
+ */
+/**
+ * Memory entry type
+ */
+type MemoryType = 'fact' | 'preference' | 'event' | 'context' | 'summary' | 'entity' | 'relation' | 'conversation' | 'custom';
+/**
+ * Memory source
+ */
+type MemorySource = 'explicit' | 'inferred' | 'extracted' | 'system' | 'agent';
+/**
+ * Entity extracted from memory
+ */
+interface Entity {
+    type: string;
+    value: string;
+    confidence: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Relation between entities
+ */
+interface Relation {
+    subject: string;
+    predicate: string;
+    object: string;
+    confidence: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Memory entry metadata
+ */
+interface MemoryMetadata {
+    userId?: string;
+    agentId?: string;
+    conversationId?: string;
+    sessionId?: string;
+    source: MemorySource;
+    confidence: number;
+    entities?: Entity[];
+    relations?: Relation[];
+    tags?: string[];
+    namespace?: string;
+    [key: string]: unknown;
+}
+/**
+ * Memory entry
+ */
+interface MemoryEntry {
+    id: string;
+    content: string;
+    embedding?: number[];
+    type: MemoryType;
+    importance: number;
+    metadata: MemoryMetadata;
+    timestamp: number;
+    expiresAt?: number;
+    parentId?: string;
+    accessCount: number;
+    lastAccessedAt?: number;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Memory input for adding
+ */
+interface MemoryInput {
+    content: string;
+    type?: MemoryType;
+    importance?: number;
+    metadata?: Partial<MemoryMetadata>;
+    expiresAt?: number;
+    parentId?: string;
+}
+/**
+ * Memory update input
+ */
+interface MemoryUpdateInput {
+    content?: string;
+    type?: MemoryType;
+    importance?: number;
+    metadata?: Partial<MemoryMetadata>;
+    expiresAt?: number;
+    lastAccessedAt?: number;
+    accessCount?: number;
+}
+/**
+ * Memory query options
+ */
+interface MemoryQueryOptions {
+    query?: string;
+    userId?: string;
+    agentId?: string;
+    conversationId?: string;
+    sessionId?: string;
+    namespace?: string;
+    types?: MemoryType[];
+    tags?: string[];
+    minImportance?: number;
+    startTime?: number;
+    endTime?: number;
+    limit?: number;
+    offset?: number;
+    includeExpired?: boolean;
+}
+/**
+ * Memory query result
+ */
+interface MemoryQueryResult {
+    entries: MemoryEntry[];
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Scored memory entry (retrieval result)
+ */
+interface ScoredMemory {
+    entry: MemoryEntry;
+    score: number;
+    explanation?: string;
+}
+/**
+ * Memory retrieval options
+ */
+interface RetrievalOptions {
+    userId?: string;
+    agentId?: string;
+    conversationId?: string;
+    namespace?: string;
+    limit?: number;
+    minScore?: number;
+    types?: MemoryType[];
+    timeRange?: {
+        start?: number;
+        end?: number;
+    };
+    filters?: Record<string, unknown>;
+}
+/**
+ * Memory manager configuration
+ */
+interface MemoryManagerConfig {
+    store: MemoryStoreInterface;
+    embedding?: EmbeddingProviderInterface;
+    retrieval?: RetrievalStrategyInterface;
+    defaultNamespace?: string;
+    autoEmbed?: boolean;
+    importanceCalculator?: ImportanceCalculator;
+}
+/**
+ * Memory store interface
+ */
+interface MemoryStoreInterface {
+    add(entry: MemoryEntry): Promise<string>;
+    get(id: string): Promise<MemoryEntry | null>;
+    update(id: string, updates: MemoryUpdateInput): Promise<boolean>;
+    delete(id: string): Promise<boolean>;
+    query(options: MemoryQueryOptions): Promise<MemoryQueryResult>;
+    search(embedding: number[], options: VectorSearchOptions): Promise<ScoredMemory[]>;
+    clear(options?: {
+        namespace?: string;
+        userId?: string;
+    }): Promise<number>;
+    count(options?: MemoryQueryOptions): Promise<number>;
+    close?(): Promise<void>;
+}
+/**
+ * Vector search options
+ */
+interface VectorSearchOptions {
+    topK: number;
+    minScore?: number;
+    filter?: Record<string, unknown>;
+    namespace?: string;
+}
+/**
+ * Embedding provider interface
+ */
+interface EmbeddingProviderInterface {
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    dimensions: number;
+}
+/**
+ * Retrieval strategy interface
+ */
+interface RetrievalStrategyInterface {
+    readonly name: string;
+    retrieve(query: string, store: MemoryStoreInterface, embedding: EmbeddingProviderInterface, options: RetrievalOptions): Promise<ScoredMemory[]>;
+}
+/**
+ * Importance calculator function
+ */
+type ImportanceCalculator = (content: string, type: MemoryType, metadata: MemoryMetadata) => number;
+/**
+ * LLM provider interface (simplified for memory processing)
+ */
+interface LLMProviderInterface {
+    complete(options: {
+        model: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<{
+        content: string;
+    }>;
+}
+/**
+ * Memory event types
+ */
+type MemoryEventType = 'memory:added' | 'memory:updated' | 'memory:deleted' | 'memory:retrieved' | 'memory:expired' | 'memory:consolidated' | 'memory:summarized';
+/**
+ * Memory event
+ */
+interface MemoryEvent {
+    type: MemoryEventType;
+    memoryId?: string;
+    memory?: MemoryEntry;
+    metadata?: Record<string, unknown>;
+    timestamp: number;
+}
+/**
+ * Memory statistics
+ */
+interface MemoryStats {
+    totalCount: number;
+    byType: Record<MemoryType, number>;
+    byNamespace: Record<string, number>;
+    sizeBytes: number;
+    oldestTimestamp: number;
+    newestTimestamp: number;
+    averageImportance: number;
+    embeddedCount: number;
+}
+
+export type { EmbeddingProviderInterface as E, ImportanceCalculator as I, LLMProviderInterface as L, MemoryEvent as M, RetrievalOptions as R, ScoredMemory as S, VectorSearchOptions as V, MemoryManagerConfig as a, MemoryInput as b, MemoryEntry as c, MemoryUpdateInput as d, MemoryQueryOptions as e, MemoryQueryResult as f, MemoryStats as g, RetrievalStrategyInterface as h, MemoryStoreInterface as i, MemoryType as j, MemoryMetadata as k };

package/dist/core.types-lkxKv-bW.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Core Memory Types
+ *
+ * Core type definitions for memory management.
+ */
+/**
+ * Memory entry type
+ */
+type MemoryType = 'fact' | 'preference' | 'event' | 'context' | 'summary' | 'entity' | 'relation' | 'conversation' | 'custom';
+/**
+ * Memory source
+ */
+type MemorySource = 'explicit' | 'inferred' | 'extracted' | 'system' | 'agent';
+/**
+ * Entity extracted from memory
+ */
+interface Entity {
+    type: string;
+    value: string;
+    confidence: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Relation between entities
+ */
+interface Relation {
+    subject: string;
+    predicate: string;
+    object: string;
+    confidence: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Memory entry metadata
+ */
+interface MemoryMetadata {
+    userId?: string;
+    agentId?: string;
+    conversationId?: string;
+    sessionId?: string;
+    source: MemorySource;
+    confidence: number;
+    entities?: Entity[];
+    relations?: Relation[];
+    tags?: string[];
+    namespace?: string;
+    [key: string]: unknown;
+}
+/**
+ * Memory entry
+ */
+interface MemoryEntry {
+    id: string;
+    content: string;
+    embedding?: number[];
+    type: MemoryType;
+    importance: number;
+    metadata: MemoryMetadata;
+    timestamp: number;
+    expiresAt?: number;
+    parentId?: string;
+    accessCount: number;
+    lastAccessedAt?: number;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Memory input for adding
+ */
+interface MemoryInput {
+    content: string;
+    type?: MemoryType;
+    importance?: number;
+    metadata?: Partial<MemoryMetadata>;
+    expiresAt?: number;
+    parentId?: string;
+}
+/**
+ * Memory update input
+ */
+interface MemoryUpdateInput {
+    content?: string;
+    type?: MemoryType;
+    importance?: number;
+    metadata?: Partial<MemoryMetadata>;
+    expiresAt?: number;
+    lastAccessedAt?: number;
+    accessCount?: number;
+}
+/**
+ * Memory query options
+ */
+interface MemoryQueryOptions {
+    query?: string;
+    userId?: string;
+    agentId?: string;
+    conversationId?: string;
+    sessionId?: string;
+    namespace?: string;
+    types?: MemoryType[];
+    tags?: string[];
+    minImportance?: number;
+    startTime?: number;
+    endTime?: number;
+    limit?: number;
+    offset?: number;
+    includeExpired?: boolean;
+}
+/**
+ * Memory query result
+ */
+interface MemoryQueryResult {
+    entries: MemoryEntry[];
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Scored memory entry (retrieval result)
+ */
+interface ScoredMemory {
+    entry: MemoryEntry;
+    score: number;
+    explanation?: string;
+}
+/**
+ * Memory retrieval options
+ */
+interface RetrievalOptions {
+    userId?: string;
+    agentId?: string;
+    conversationId?: string;
+    namespace?: string;
+    limit?: number;
+    minScore?: number;
+    types?: MemoryType[];
+    timeRange?: {
+        start?: number;
+        end?: number;
+    };
+    filters?: Record<string, unknown>;
+}
+/**
+ * Memory manager configuration
+ */
+interface MemoryManagerConfig {
+    store: MemoryStoreInterface;
+    embedding?: EmbeddingProviderInterface;
+    retrieval?: RetrievalStrategyInterface;
+    defaultNamespace?: string;
+    autoEmbed?: boolean;
+    importanceCalculator?: ImportanceCalculator;
+}
+/**
+ * Memory store interface
+ */
+interface MemoryStoreInterface {
+    add(entry: MemoryEntry): Promise<string>;
+    get(id: string): Promise<MemoryEntry | null>;
+    update(id: string, updates: MemoryUpdateInput): Promise<boolean>;
+    delete(id: string): Promise<boolean>;
+    query(options: MemoryQueryOptions): Promise<MemoryQueryResult>;
+    search(embedding: number[], options: VectorSearchOptions): Promise<ScoredMemory[]>;
+    clear(options?: {
+        namespace?: string;
+        userId?: string;
+    }): Promise<number>;
+    count(options?: MemoryQueryOptions): Promise<number>;
+    close?(): Promise<void>;
+}
+/**
+ * Vector search options
+ */
+interface VectorSearchOptions {
+    topK: number;
+    minScore?: number;
+    filter?: Record<string, unknown>;
+    namespace?: string;
+}
+/**
+ * Embedding provider interface
+ */
+interface EmbeddingProviderInterface {
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    dimensions: number;
+}
+/**
+ * Retrieval strategy interface
+ */
+interface RetrievalStrategyInterface {
+    readonly name: string;
+    retrieve(query: string, store: MemoryStoreInterface, embedding: EmbeddingProviderInterface, options: RetrievalOptions): Promise<ScoredMemory[]>;
+}
+/**
+ * Importance calculator function
+ */
+type ImportanceCalculator = (content: string, type: MemoryType, metadata: MemoryMetadata) => number;
+/**
+ * LLM provider interface (simplified for memory processing)
+ */
+interface LLMProviderInterface {
+    complete(options: {
+        model: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<{
+        content: string;
+    }>;
+}
+/**
+ * Memory event types
+ */
+type MemoryEventType = 'memory:added' | 'memory:updated' | 'memory:deleted' | 'memory:retrieved' | 'memory:expired' | 'memory:consolidated' | 'memory:summarized';
+/**
+ * Memory event
+ */
+interface MemoryEvent {
+    type: MemoryEventType;
+    memoryId?: string;
+    memory?: MemoryEntry;
+    metadata?: Record<string, unknown>;
+    timestamp: number;
+}
+/**
+ * Memory statistics
+ */
+interface MemoryStats {
+    totalCount: number;
+    byType: Record<MemoryType, number>;
+    byNamespace: Record<string, number>;
+    sizeBytes: number;
+    oldestTimestamp: number;
+    newestTimestamp: number;
+    averageImportance: number;
+    embeddedCount: number;
+}
+
+export type { EmbeddingProviderInterface as E, ImportanceCalculator as I, LLMProviderInterface as L, MemoryEvent as M, RetrievalOptions as R, ScoredMemory as S, VectorSearchOptions as V, MemoryManagerConfig as a, MemoryInput as b, MemoryEntry as c, MemoryUpdateInput as d, MemoryQueryOptions as e, MemoryQueryResult as f, MemoryStats as g, RetrievalStrategyInterface as h, MemoryStoreInterface as i, MemoryType as j, MemoryMetadata as k };