universal-agent-memory 0.6.3 → 0.7.1

package/dist/memory/memory-consolidator.js

@@ -0,0 +1,514 @@
+/**
+ * Memory Consolidation Service for UAM
+ *
+ * Implements the consolidation rules from CLAUDE.md:
+ * - Trigger: Every 10 working memory entries
+ * - Action: Summarize → session_memories, Extract lessons → semantic memory
+ * - Dedup: Skip if content_hash exists OR similarity > 0.92
+ *
+ * Enhanced with SimpleMem-style recursive consolidation:
+ * - Background async consolidation process
+ * - Hierarchical abstraction (memories → summaries → meta-summaries)
+ * - Quality scoring and automatic pruning
+ */
+import { createHash } from 'crypto';
+import { existsSync } from 'fs';
+import Database from 'better-sqlite3';
+import { summarizeMemories, compressMemoryEntry } from './context-compressor.js';
+import { getEmbeddingService } from './embeddings.js';
+import { createSemanticUnit } from './semantic-compression.js';
+const DEFAULT_CONFIG = {
+    triggerThreshold: 10,
+    minImportanceForLongTerm: 7,
+    similarityThreshold: 0.92,
+    maxSummaryLength: 500,
+    backgroundIntervalMs: 60000, // 1 minute
+    recursiveDepth: 3, // memories → summaries → meta-summaries
+    qualityDecayRate: 0.95, // 5% decay per day unused
+};
+/**
+ * Memory Consolidation Service
+ */
+export class MemoryConsolidator {
+    config;
+    db = null;
+    contentHashes = new Set();
+    lastConsolidationId = 0;
+    backgroundInterval = null;
+    isRunning = false;
+    memoryQualityScores = new Map();
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize with database connection
+     */
+    initialize(dbPath) {
+        if (!existsSync(dbPath)) {
+            throw new Error(`Database not found: ${dbPath}`);
+        }
+        this.db = new Database(dbPath);
+        this.loadContentHashes();
+    }
+    /**
+     * Load existing content hashes for deduplication
+     */
+    loadContentHashes() {
+        if (!this.db)
+            return;
+        try {
+            const stmt = this.db.prepare(`
+        SELECT content FROM memories
+        UNION
+        SELECT content FROM session_memories
+      `);
+            const rows = stmt.all();
+            for (const row of rows) {
+                this.contentHashes.add(this.hashContent(row.content));
+            }
+        }
+        catch {
+            // Tables might not exist yet
+        }
+    }
+    /**
+     * Hash content for deduplication
+     */
+    hashContent(content) {
+        return createHash('md5')
+            .update(content.toLowerCase().trim())
+            .digest('hex');
+    }
+    /**
+     * Check if consolidation should run
+     */
+    shouldConsolidate() {
+        if (!this.db)
+            return false;
+        try {
+            const stmt = this.db.prepare(`
+        SELECT COUNT(*) as count, MAX(id) as maxId
+        FROM memories
+        WHERE id > ?
+      `);
+            const result = stmt.get(this.lastConsolidationId);
+            return result.count >= this.config.triggerThreshold;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Run consolidation process
+     */
+    async consolidate() {
+        if (!this.db) {
+            throw new Error('Database not initialized');
+        }
+        const result = {
+            memoriesProcessed: 0,
+            summariesCreated: 0,
+            lessonsExtracted: 0,
+            duplicatesSkipped: 0,
+            tokensReduced: 0,
+        };
+        // Get memories since last consolidation
+        const stmt = this.db.prepare(`
+      SELECT id, timestamp, type, content
+      FROM memories
+      WHERE id > ?
+      ORDER BY id ASC
+      LIMIT 100
+    `);
+        const memories = stmt.all(this.lastConsolidationId);
+        if (memories.length === 0)
+            return result;
+        result.memoriesProcessed = memories.length;
+        const originalTokens = memories.reduce((sum, m) => sum + m.content.length / 4, 0);
+        // Group by type for summarization
+        const byType = {};
+        for (const mem of memories) {
+            if (!byType[mem.type])
+                byType[mem.type] = [];
+            byType[mem.type].push(mem);
+        }
+        // Create summaries for each type
+        for (const [_type, typeMemories] of Object.entries(byType)) {
+            if (typeMemories.length >= 3) {
+                const summary = summarizeMemories(typeMemories.map(m => ({
+                    content: m.content,
+                    timestamp: m.timestamp,
+                    type: m.type,
+                })), this.config.maxSummaryLength);
+                const summaryHash = this.hashContent(summary);
+                if (!this.contentHashes.has(summaryHash)) {
+                    // Store in session_memories
+                    await this.storeSessionMemory(summary, 'summary', 6);
+                    this.contentHashes.add(summaryHash);
+                    result.summariesCreated++;
+                }
+                else {
+                    result.duplicatesSkipped++;
+                }
+            }
+        }
+        // Extract lessons from high-importance observations
+        const lessons = memories.filter(m => m.type === 'observation' &&
+            this.detectLesson(m.content));
+        for (const lesson of lessons) {
+            const compressed = compressMemoryEntry(lesson.content, { compressionLevel: 'medium' });
+            const hash = this.hashContent(compressed.compressed);
+            if (!this.contentHashes.has(hash)) {
+                // Check semantic similarity
+                const isDuplicate = await this.checkSemanticDuplicate(compressed.compressed);
+                if (!isDuplicate) {
+                    await this.storeLesson(compressed.compressed, lesson.timestamp);
+                    this.contentHashes.add(hash);
+                    result.lessonsExtracted++;
+                }
+                else {
+                    result.duplicatesSkipped++;
+                }
+            }
+            else {
+                result.duplicatesSkipped++;
+            }
+        }
+        // Calculate token reduction
+        const summaryTokens = result.summariesCreated * (this.config.maxSummaryLength / 4);
+        const lessonTokens = result.lessonsExtracted * 100; // Approximate
+        result.tokensReduced = Math.max(0, originalTokens - summaryTokens - lessonTokens);
+        // Update last consolidation pointer
+        this.lastConsolidationId = memories[memories.length - 1].id;
+        return result;
+    }
+    /**
+     * Detect if content contains a lesson/insight
+     */
+    detectLesson(content) {
+        const lessonIndicators = [
+            /learned that/i,
+            /important to/i,
+            /mistake was/i,
+            /better to/i,
+            /should always/i,
+            /should never/i,
+            /key insight/i,
+            /gotcha/i,
+            /watch out for/i,
+            /best practice/i,
+            /pattern/i,
+            /tip:/i,
+        ];
+        return lessonIndicators.some(pattern => pattern.test(content));
+    }
+    /**
+     * Check for semantic duplicates using embeddings
+     */
+    async checkSemanticDuplicate(content) {
+        if (!this.db)
+            return false;
+        try {
+            const embeddingService = getEmbeddingService();
+            const newEmbedding = await embeddingService.embed(content);
+            // Get recent session memories for comparison
+            const stmt = this.db.prepare(`
+        SELECT content FROM session_memories
+        ORDER BY id DESC
+        LIMIT 50
+      `);
+            const existing = stmt.all();
+            for (const { content: existingContent } of existing) {
+                const existingEmbedding = await embeddingService.embed(existingContent);
+                const similarity = embeddingService.cosineSimilarity(newEmbedding, existingEmbedding);
+                if (similarity > this.config.similarityThreshold) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        catch {
+            // Fall back to text comparison
+            const normalizedNew = content.toLowerCase().trim();
+            const stmt = this.db.prepare(`
+        SELECT content FROM session_memories
+        WHERE LOWER(TRIM(content)) = ?
+        LIMIT 1
+      `);
+            const match = stmt.get(normalizedNew);
+            return !!match;
+        }
+    }
+    /**
+     * Store session memory
+     */
+    async storeSessionMemory(content, type, importance) {
+        if (!this.db)
+            return;
+        const stmt = this.db.prepare(`
+      INSERT OR IGNORE INTO session_memories (session_id, timestamp, type, content, importance)
+      VALUES ('consolidation', ?, ?, ?, ?)
+    `);
+        stmt.run(new Date().toISOString(), type, content, importance);
+    }
+    /**
+     * Store lesson in long-term memory
+     */
+    async storeLesson(content, timestamp) {
+        if (!this.db)
+            return;
+        const stmt = this.db.prepare(`
+      INSERT OR IGNORE INTO session_memories (session_id, timestamp, type, content, importance)
+      VALUES ('lessons', ?, 'lesson', ?, ?)
+    `);
+        stmt.run(timestamp, content, this.config.minImportanceForLongTerm);
+    }
+    /**
+     * Run decay on old memories
+     * Formula: effective_importance = importance × (0.95 ^ days_since_access)
+     */
+    async runDecay() {
+        if (!this.db)
+            return 0;
+        try {
+            // SQLite doesn't have POW, so we do this in application code
+            const stmt = this.db.prepare(`
+        SELECT id, importance, timestamp
+        FROM session_memories
+        WHERE importance > 1
+      `);
+            const rows = stmt.all();
+            let updated = 0;
+            const now = Date.now();
+            const updateStmt = this.db.prepare(`
+        UPDATE session_memories
+        SET importance = ?
+        WHERE id = ?
+      `);
+            for (const row of rows) {
+                const daysSince = (now - new Date(row.timestamp).getTime()) / (1000 * 60 * 60 * 24);
+                const decayed = Math.round(row.importance * Math.pow(0.95, daysSince));
+                if (decayed !== row.importance && decayed >= 1) {
+                    updateStmt.run(decayed, row.id);
+                    updated++;
+                }
+            }
+            return updated;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Get consolidation stats
+     */
+    getStats() {
+        if (!this.db) {
+            return {
+                totalMemories: 0,
+                totalSessionMemories: 0,
+                totalLessons: 0,
+                lastConsolidationId: this.lastConsolidationId,
+                uniqueHashes: this.contentHashes.size,
+            };
+        }
+        try {
+            const memoriesStmt = this.db.prepare('SELECT COUNT(*) as count FROM memories');
+            const sessionStmt = this.db.prepare('SELECT COUNT(*) as count FROM session_memories');
+            const lessonsStmt = this.db.prepare(`
+        SELECT COUNT(*) as count FROM session_memories WHERE type = 'lesson'
+      `);
+            const memories = memoriesStmt.get().count;
+            const session = sessionStmt.get().count;
+            const lessons = lessonsStmt.get().count;
+            return {
+                totalMemories: memories,
+                totalSessionMemories: session,
+                totalLessons: lessons,
+                lastConsolidationId: this.lastConsolidationId,
+                uniqueHashes: this.contentHashes.size,
+            };
+        }
+        catch {
+            return {
+                totalMemories: 0,
+                totalSessionMemories: 0,
+                totalLessons: 0,
+                lastConsolidationId: this.lastConsolidationId,
+                uniqueHashes: this.contentHashes.size,
+            };
+        }
+    }
+    /**
+     * Start background consolidation process (SimpleMem-style async)
+     */
+    startBackgroundConsolidation() {
+        if (this.backgroundInterval)
+            return;
+        this.isRunning = true;
+        this.backgroundInterval = setInterval(async () => {
+            if (!this.isRunning)
+                return;
+            try {
+                // Run consolidation if threshold met
+                if (this.shouldConsolidate()) {
+                    await this.consolidate();
+                }
+                // Run recursive consolidation on summaries
+                await this.recursiveConsolidate();
+                // Apply quality decay
+                await this.applyQualityDecay();
+            }
+            catch (error) {
+                console.error('[MemoryConsolidator] Background error:', error);
+            }
+        }, this.config.backgroundIntervalMs);
+        console.log(`[MemoryConsolidator] Background consolidation started (interval: ${this.config.backgroundIntervalMs}ms)`);
+    }
+    /**
+     * Stop background consolidation
+     */
+    stopBackgroundConsolidation() {
+        this.isRunning = false;
+        if (this.backgroundInterval) {
+            clearInterval(this.backgroundInterval);
+            this.backgroundInterval = null;
+        }
+    }
+    /**
+     * Recursive consolidation - merge summaries into meta-summaries
+     * Based on SimpleMem's hierarchical abstraction
+     */
+    async recursiveConsolidate(depth = 0) {
+        if (!this.db || depth >= this.config.recursiveDepth)
+            return 0;
+        let consolidated = 0;
+        try {
+            // Find summaries that can be merged (same type, adjacent time periods)
+            const stmt = this.db.prepare(`
+        SELECT id, timestamp, type, content, importance
+        FROM session_memories
+        WHERE type = 'summary'
+        ORDER BY timestamp ASC
+        LIMIT 20
+      `);
+            const summaries = stmt.all();
+            // Group adjacent summaries (within 24 hours)
+            const groups = [];
+            let currentGroup = [];
+            for (const summary of summaries) {
+                if (currentGroup.length === 0) {
+                    currentGroup.push(summary);
+                }
+                else {
+                    const lastTime = new Date(currentGroup[currentGroup.length - 1].timestamp).getTime();
+                    const thisTime = new Date(summary.timestamp).getTime();
+                    const hoursDiff = (thisTime - lastTime) / (1000 * 60 * 60);
+                    if (hoursDiff <= 24) {
+                        currentGroup.push(summary);
+                    }
+                    else {
+                        if (currentGroup.length >= 3)
+                            groups.push(currentGroup);
+                        currentGroup = [summary];
+                    }
+                }
+            }
+            if (currentGroup.length >= 3)
+                groups.push(currentGroup);
+            // Create meta-summaries from groups
+            for (const group of groups) {
+                const unit = createSemanticUnit(group.map(s => ({ content: s.content, importance: s.importance })));
+                if (unit.compressionRatio > 1.2) {
+                    const metaSummary = unit.atomicFacts.map(f => f.content).join(' ');
+                    const hash = this.hashContent(metaSummary);
+                    if (!this.contentHashes.has(hash)) {
+                        await this.storeSessionMemory(metaSummary, 'meta-summary', 8);
+                        this.contentHashes.add(hash);
+                        consolidated++;
+                        // Remove original summaries
+                        const ids = group.map(s => s.id);
+                        this.db.prepare(`DELETE FROM session_memories WHERE id IN (${ids.join(',')})`).run();
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return consolidated;
+    }
+    /**
+     * Apply quality decay to unused memories (Memory-R1 style)
+     */
+    async applyQualityDecay() {
+        if (!this.db)
+            return 0;
+        const now = Date.now();
+        let updated = 0;
+        try {
+            const stmt = this.db.prepare(`
+        SELECT id, importance, timestamp
+        FROM session_memories
+        WHERE importance > 1
+      `);
+            const rows = stmt.all();
+            const updateStmt = this.db.prepare(`
+        UPDATE session_memories SET importance = ? WHERE id = ?
+      `);
+            for (const row of rows) {
+                const memKey = `session-${row.id}`;
+                const quality = this.memoryQualityScores.get(memKey);
+                // Calculate days since last access (or creation)
+                const lastAccess = quality?.lastAccessed || new Date(row.timestamp);
+                const daysSince = (now - lastAccess.getTime()) / (1000 * 60 * 60 * 24);
+                // Apply decay: importance * (decayRate ^ days)
+                const decayed = Math.round(row.importance * Math.pow(this.config.qualityDecayRate, daysSince));
+                if (decayed !== row.importance && decayed >= 1) {
+                    updateStmt.run(decayed, row.id);
+                    updated++;
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return updated;
+    }
+    /**
+     * Record memory access (for quality scoring)
+     */
+    recordAccess(memoryId) {
+        const existing = this.memoryQualityScores.get(memoryId);
+        this.memoryQualityScores.set(memoryId, {
+            score: (existing?.score || 5) + 0.5,
+            lastAccessed: new Date(),
+            accessCount: (existing?.accessCount || 0) + 1,
+        });
+    }
+    /**
+     * Get memory quality score
+     */
+    getQualityScore(memoryId) {
+        return this.memoryQualityScores.get(memoryId)?.score || 5;
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        this.stopBackgroundConsolidation();
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+}
+// Singleton instance
+let globalConsolidator = null;
+export function getMemoryConsolidator(config) {
+    if (!globalConsolidator) {
+        globalConsolidator = new MemoryConsolidator(config);
+    }
+    return globalConsolidator;
+}
+//# sourceMappingURL=memory-consolidator.js.map

package/dist/memory/memory-consolidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-consolidator.js","sourceRoot":"","sources":["../../src/memory/memory-consolidator.ts"],"names":[],"mappings":"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"}

package/dist/memory/multi-view-memory.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Multi-View Memory System for UAM
+ *
+ * Implements:
+ * 1. Multi-view indexing (entity, temporal, semantic type views)
+ * 2. ENGRAM-style memory typing (episodic, semantic, procedural)
+ * 3. Async embedding generation
+ * 4. Speculative cache integration with task classifier
+ *
+ * Based on SimpleMem (2026) and ENGRAM (2025) research
+ */
+/**
+ * ENGRAM-style memory types
+ */
+export type ENGRAMMemoryType = 'episodic' | 'semantic' | 'procedural';
+/**
+ * Multi-view indexed memory entry
+ */
+export interface MultiViewMemory {
+    id: string;
+    content: string;
+    memoryType: ENGRAMMemoryType;
+    entities: string[];
+    temporalBucket: string;
+    semanticType: string;
+    embedding?: number[];
+    embeddingPending?: boolean;
+    importance: number;
+    accessCount: number;
+    lastAccessed: Date;
+    qualityScore: number;
+}
+/**
+ * Multi-view index structure
+ */
+export interface MultiViewIndex {
+    byEntity: Map<string, Set<string>>;
+    byTemporal: Map<string, Set<string>>;
+    bySemanticType: Map<string, Set<string>>;
+    byENGRAMType: Map<ENGRAMMemoryType, Set<string>>;
+}
+/**
+ * Classify memory into ENGRAM type
+ */
+export declare function classifyENGRAMType(content: string, context?: {
+    type?: string;
+}): ENGRAMMemoryType;
+/**
+ * Extract temporal bucket from content/timestamp
+ */
+export declare function extractTemporalBucket(content: string, timestamp?: string): string;
+/**
+ * Multi-View Memory Manager
+ */
+export declare class MultiViewMemoryManager {
+    private memories;
+    private index;
+    private embeddingQueue;
+    private isProcessingEmbeddings;
+    /**
+     * Add memory with multi-view indexing
+     */
+    add(content: string, options?: {
+        id?: string;
+        semanticType?: string;
+        entities?: string[];
+        timestamp?: string;
+        importance?: number;
+        generateEmbedding?: boolean;
+    }): Promise<MultiViewMemory>;
+    /**
+     * Index memory in all views
+     */
+    private indexMemory;
+    /**
+     * Query by entity
+     */
+    queryByEntity(entity: string): MultiViewMemory[];
+    /**
+     * Query by ENGRAM type
+     */
+    queryByENGRAMType(type: ENGRAMMemoryType): MultiViewMemory[];
+    /**
+     * Query by temporal bucket
+     */
+    queryByTemporal(bucket: string): MultiViewMemory[];
+    /**
+     * Smart query using task classification to select best view
+     */
+    smartQuery(query: string, limit?: number): Promise<MultiViewMemory[]>;
+    /**
+     * Get retrieval strategy based on task classification
+     */
+    private getRetrievalStrategy;
+    /**
+     * Execute a single strategy step
+     */
+    private executeStrategyStep;
+    /**
+     * Semantic search using embeddings
+     */
+    semanticSearch(query: string, limit?: number): Promise<MultiViewMemory[]>;
+    /**
+     * Process embedding queue asynchronously
+     */
+    private processEmbeddingQueue;
+    /**
+     * Extract entities from content
+     */
+    private extractEntities;
+    /**
+     * Record memory access
+     */
+    recordAccess(memoryId: string): void;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        totalMemories: number;
+        byENGRAMType: Record<ENGRAMMemoryType, number>;
+        pendingEmbeddings: number;
+        entitiesIndexed: number;
+    };
+    /**
+     * Export all memories
+     */
+    export(): MultiViewMemory[];
+    /**
+     * Import memories
+     */
+    import(memories: MultiViewMemory[]): Promise<void>;
+}
+export declare function getMultiViewMemoryManager(): MultiViewMemoryManager;
+//# sourceMappingURL=multi-view-memory.d.ts.map

package/dist/memory/multi-view-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-view-memory.d.ts","sourceRoot":"","sources":["../../src/memory/multi-view-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,UAAU,GACV,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAGhB,UAAU,EAAE,gBAAgB,CAAC;IAG7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IAGrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAG3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACnC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACrC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,YAAY,EAAE,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAkCjG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAejF;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,sBAAsB,CAAkB;IAEhD;;OAEG;IACG,GAAG,CACP,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KACxB,GACL,OAAO,CAAC,eAAe,CAAC;IAyC3B;;OAEG;IACH,OAAO,CAAC,WAAW;IA4BnB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAMhD;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,EAAE;IAM5D;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAMlD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAiD/E;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuC5B;;OAEG;YACW,mBAAmB;IAiDjC;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAyBnF;;OAEG;YACW,qBAAqB;IA6BnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IASpC;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC/C,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;KACzB;IAeD;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;IAI3B;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAYzD;AAKD,wBAAgB,yBAAyB,IAAI,sBAAsB,CAKlE"}