snow-flow 2.0.3 → 2.0.5

package/dist/memory/memory-system.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Snow-Flow Memory System
+ * SQLite-based persistent memory with caching for agent coordination
+ */
+import { EventEmitter } from 'events';
+export interface MemoryOptions {
+    dbPath: string;
+    schema?: {
+        version: string;
+        autoMigrate: boolean;
+    };
+    cache?: {
+        enabled: boolean;
+        maxSize: number;
+        ttl: number;
+    };
+    ttl?: {
+        default: number;
+        session: number;
+        artifact: number;
+        metric: number;
+    };
+}
+export interface MemoryEntry {
+    key: string;
+    value: any;
+    ttl?: number;
+    createdAt: Date;
+    expiresAt?: Date;
+    metadata?: Record<string, any>;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    evictions: number;
+}
+export interface DatabaseStats {
+    size: number;
+    tableCount: number;
+    rowCounts: Record<string, number>;
+}
+export declare class MemorySystem extends EventEmitter {
+    private db?;
+    private logger;
+    private options;
+    private cache;
+    private cacheStats;
+    private cleanupTimer?;
+    private initialized;
+    constructor(options: MemoryOptions);
+    /**
+     * 🔧 CRIT-003 FIX: Store data with agent isolation
+     * Implements agentId::contextKey namespacing for complete memory isolation
+     */
+    storeShared(agentId: string, contextKey: string, value: any, ttl?: number): Promise<void>;
+    /**
+     * 🔧 CRIT-003 FIX: Retrieve data with agent isolation
+     * Implements agentId::contextKey namespacing with backward compatibility
+     */
+    retrieveShared(agentId: string, contextKey: string): Promise<any>;
+    /**
+     * 🔧 CRIT-003 FIX: Check if agent has specific context
+     */
+    hasSharedContext(agentId: string, contextKey: string): Promise<boolean>;
+    /**
+     * 🔧 CRIT-003 FIX: List all context keys for an agent
+     */
+    listAgentContexts(agentId: string): Promise<string[]>;
+    /**
+     * 🔧 CRIT-003 FIX: Core store method for memory operations
+     */
+    store(key: string, value: any, ttl?: number): Promise<void>;
+    /**
+     * 🔧 CRIT-003 FIX: Core get method for memory operations
+     */
+    get(key: string): Promise<any>;
+    /**
+     * 🔧 CRIT-003 FIX: Check if key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * 🔧 CRIT-003 FIX: List all keys
+     */
+    listKeys(): Promise<string[]>;
+    /**
+     * Initialize the memory system
+     */
+    initialize(): Promise<void>;
+    /**
+     * Update an existing value
+     */
+    update(key: string, value: any): Promise<void>;
+    /**
+     * Execute a raw SQL query
+     */
+    execute(sql: string, params?: any[]): Promise<void>;
+    /**
+     * Query the database
+     */
+    query<T = any>(sql: string, params?: any[]): Promise<T[]>;
+    /**
+     * Insert data into a table
+     */
+    insert(table: string, data: Record<string, any>): Promise<void>;
+    /**
+     * Delete a key from memory
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Upsert data (insert or update)
+     */
+    upsert(table: string, data: Record<string, any>, uniqueKeys: string[]): Promise<void>;
+    /**
+     * Create a transaction
+     */
+    transaction<T>(fn: () => T): T;
+    /**
+     * Get database statistics
+     */
+    getDatabaseStats(): Promise<DatabaseStats>;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): Promise<CacheStats>;
+    /**
+     * Invalidate cache
+     */
+    invalidateCache(pattern?: string): Promise<void>;
+    /**
+     * Create emergency backup
+     */
+    createEmergencyBackup(): Promise<string>;
+    /**
+     * Close the memory system
+     */
+    close(): Promise<void>;
+    /**
+     * Private helper methods
+     */
+    private createCoreTables;
+    private runMigrations;
+    private startCleanupTimer;
+    private cleanup;
+    /**
+     * 🔴 SNOW-003 FIX: Emergency cleanup when memory pressure is high
+     */
+    private memoryPressureCleanup;
+    private checkCacheSize;
+    private estimateCacheSize;
+}
+//# sourceMappingURL=memory-system.d.ts.map