@hazeljs/rag 0.2.0-beta.1

package/dist/memory/stores/buffer-memory.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * Buffer Memory Store - Simple FIFO buffer for recent memories
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BufferMemory = void 0;
+const types_1 = require("../types");
+const crypto_1 = require("crypto");
+/**
+ * In-memory buffer that keeps the most recent memories
+ * Uses FIFO (First In, First Out) strategy
+ */
+class BufferMemory {
+    constructor(config = {}) {
+        this.memories = new Map();
+        this.sessionBuffers = new Map();
+        this.maxSize = config.maxSize || 100;
+        this.ttl = config.ttl;
+    }
+    async initialize() {
+        // No initialization needed for in-memory store
+    }
+    async save(memory) {
+        const id = memory.id || (0, crypto_1.randomUUID)();
+        const memoryWithId = { ...memory, id };
+        // Add expiration if TTL is set
+        if (this.ttl && !memoryWithId.metadata.expiresAt) {
+            memoryWithId.metadata.expiresAt = new Date(Date.now() + this.ttl);
+        }
+        this.memories.set(id, memoryWithId);
+        // Track in session buffer
+        if (memory.metadata.sessionId) {
+            const buffer = this.sessionBuffers.get(memory.metadata.sessionId) || [];
+            buffer.push(id);
+            // Enforce max size per session
+            if (buffer.length > this.maxSize) {
+                const removedId = buffer.shift();
+                this.memories.delete(removedId);
+            }
+            this.sessionBuffers.set(memory.metadata.sessionId, buffer);
+        }
+        // Enforce global max size
+        if (this.memories.size > this.maxSize * 10) {
+            const oldestId = Array.from(this.memories.keys())[0];
+            this.memories.delete(oldestId);
+        }
+        return id;
+    }
+    async saveBatch(memories) {
+        const ids = [];
+        for (const memory of memories) {
+            const id = await this.save(memory);
+            ids.push(id);
+        }
+        return ids;
+    }
+    async retrieve(query) {
+        this.cleanExpired();
+        let results = Array.from(this.memories.values());
+        // Filter by session
+        if (query.sessionId) {
+            results = results.filter((m) => m.metadata.sessionId === query.sessionId);
+        }
+        // Filter by user
+        if (query.userId) {
+            results = results.filter((m) => m.metadata.userId === query.userId);
+        }
+        // Filter by types
+        if (query.types && query.types.length > 0) {
+            results = results.filter((m) => query.types.includes(m.type));
+        }
+        // Filter by date range
+        if (query.startDate) {
+            results = results.filter((m) => m.metadata.timestamp >= query.startDate);
+        }
+        if (query.endDate) {
+            results = results.filter((m) => m.metadata.timestamp <= query.endDate);
+        }
+        // Filter by importance
+        if (query.minImportance !== undefined) {
+            results = results.filter((m) => (m.metadata.importance || 0) >= query.minImportance);
+        }
+        // Filter by entities
+        if (query.entities && query.entities.length > 0) {
+            results = results.filter((m) => m.metadata.entities?.some((e) => query.entities.includes(e)));
+        }
+        // Sort by timestamp (newest first)
+        results.sort((a, b) => b.metadata.timestamp.getTime() - a.metadata.timestamp.getTime());
+        // Apply limit
+        if (query.limit) {
+            results = results.slice(0, query.limit);
+        }
+        return results;
+    }
+    async search(query, options) {
+        // Simple text-based search (no semantic search in buffer)
+        const memories = await this.retrieve(options);
+        const queryLower = query.toLowerCase();
+        const scored = memories
+            .map((memory) => ({
+            memory,
+            score: this.calculateTextScore(memory.content, queryLower),
+        }))
+            .filter((item) => item.score > (options.minScore || 0))
+            .sort((a, b) => b.score - a.score);
+        const results = scored.map((item) => ({
+            ...item.memory,
+            metadata: {
+                ...item.memory.metadata,
+                searchScore: item.score,
+            },
+        }));
+        return results.slice(0, options.topK || 10);
+    }
+    async get(id) {
+        this.cleanExpired();
+        return this.memories.get(id) || null;
+    }
+    async update(id, updates) {
+        const memory = this.memories.get(id);
+        if (!memory) {
+            throw new Error(`Memory with id ${id} not found`);
+        }
+        const updated = {
+            ...memory,
+            ...updates,
+            metadata: {
+                ...memory.metadata,
+                ...updates.metadata,
+            },
+        };
+        this.memories.set(id, updated);
+    }
+    async delete(id) {
+        this.memories.delete(id);
+        // Remove from session buffers
+        for (const [sessionId, buffer] of this.sessionBuffers.entries()) {
+            const index = buffer.indexOf(id);
+            if (index !== -1) {
+                buffer.splice(index, 1);
+                this.sessionBuffers.set(sessionId, buffer);
+            }
+        }
+    }
+    async deleteBatch(ids) {
+        for (const id of ids) {
+            await this.delete(id);
+        }
+    }
+    async clearSession(sessionId) {
+        const buffer = this.sessionBuffers.get(sessionId);
+        if (buffer) {
+            for (const id of buffer) {
+                this.memories.delete(id);
+            }
+            this.sessionBuffers.delete(sessionId);
+        }
+    }
+    async clear() {
+        this.memories.clear();
+        this.sessionBuffers.clear();
+    }
+    async summarize(options) {
+        const memories = await this.retrieve({
+            sessionId: options.sessionId,
+            limit: options.maxLength || 50,
+        });
+        if (memories.length === 0) {
+            return 'No memories to summarize.';
+        }
+        // Simple concatenation summary
+        const contents = memories.map((m) => m.content).join('\n');
+        return contents.slice(0, options.maxLength || 1000);
+    }
+    async consolidate(memories) {
+        if (memories.length === 0) {
+            throw new Error('No memories to consolidate');
+        }
+        // Merge memories into one
+        const consolidated = {
+            id: (0, crypto_1.randomUUID)(),
+            type: memories[0].type,
+            content: memories.map((m) => m.content).join('\n\n'),
+            metadata: {
+                ...memories[0].metadata,
+                timestamp: new Date(),
+                consolidated: true,
+                sourceIds: memories.map((m) => m.id),
+            },
+        };
+        return consolidated;
+    }
+    async getStats(sessionId) {
+        this.cleanExpired();
+        let memories = Array.from(this.memories.values());
+        if (sessionId) {
+            memories = memories.filter((m) => m.metadata.sessionId === sessionId);
+        }
+        const byType = {
+            [types_1.MemoryType.CONVERSATION]: 0,
+            [types_1.MemoryType.ENTITY]: 0,
+            [types_1.MemoryType.FACT]: 0,
+            [types_1.MemoryType.EVENT]: 0,
+            [types_1.MemoryType.WORKING]: 0,
+        };
+        let totalImportance = 0;
+        let oldestTime = Date.now();
+        let newestTime = 0;
+        for (const memory of memories) {
+            byType[memory.type]++;
+            totalImportance += memory.metadata.importance || 0;
+            const time = memory.metadata.timestamp.getTime();
+            if (time < oldestTime)
+                oldestTime = time;
+            if (time > newestTime)
+                newestTime = time;
+        }
+        return {
+            totalMemories: memories.length,
+            byType,
+            oldestMemory: new Date(oldestTime),
+            newestMemory: new Date(newestTime),
+            averageImportance: memories.length > 0 ? totalImportance / memories.length : 0,
+        };
+    }
+    async prune(options) {
+        this.cleanExpired();
+        let pruned = 0;
+        const toDelete = [];
+        for (const [id, memory] of this.memories.entries()) {
+            let shouldPrune = false;
+            if (options?.olderThan && memory.metadata.timestamp < options.olderThan) {
+                shouldPrune = true;
+            }
+            if (options?.minImportance !== undefined &&
+                (memory.metadata.importance || 0) < options.minImportance) {
+                shouldPrune = true;
+            }
+            if (shouldPrune) {
+                toDelete.push(id);
+                pruned++;
+            }
+        }
+        await this.deleteBatch(toDelete);
+        return pruned;
+    }
+    /**
+     * Clean expired memories
+     */
+    cleanExpired() {
+        if (!this.ttl)
+            return;
+        const now = Date.now();
+        const toDelete = [];
+        for (const [id, memory] of this.memories.entries()) {
+            if (memory.metadata.expiresAt && memory.metadata.expiresAt.getTime() < now) {
+                toDelete.push(id);
+            }
+        }
+        for (const id of toDelete) {
+            this.memories.delete(id);
+        }
+    }
+    /**
+     * Calculate simple text similarity score
+     */
+    calculateTextScore(content, query) {
+        const contentLower = content.toLowerCase();
+        const words = query.split(/\s+/);
+        let score = 0;
+        for (const word of words) {
+            if (contentLower.includes(word)) {
+                score += 1;
+            }
+        }
+        return score / words.length;
+    }
+}
+exports.BufferMemory = BufferMemory;
+//# sourceMappingURL=buffer-memory.js.map

package/dist/memory/stores/buffer-memory.js.map

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

package/dist/memory/stores/hybrid-memory.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Hybrid Memory Store - Combines buffer and vector memory strategies
+ */
+import { MemoryStore } from '../memory-store.interface';
+import { Memory, MemoryQuery, MemorySearchOptions, SummarizeOptions, MemoryStats } from '../types';
+import { BufferMemory } from './buffer-memory';
+import { VectorMemory } from './vector-memory';
+export interface HybridMemoryConfig {
+    bufferSize?: number;
+    archiveThreshold?: number;
+    ttl?: number;
+}
+/**
+ * Hybrid memory that combines short-term buffer and long-term vector storage
+ * Recent memories stay in fast buffer, older ones move to vector store
+ */
+export declare class HybridMemory implements MemoryStore {
+    private buffer;
+    private vectorStore;
+    private archiveThreshold;
+    constructor(buffer: BufferMemory, vectorStore: VectorMemory, config?: HybridMemoryConfig);
+    initialize(): Promise<void>;
+    save(memory: Memory): Promise<string>;
+    saveBatch(memories: Memory[]): Promise<string[]>;
+    retrieve(query: MemoryQuery): Promise<Memory[]>;
+    search(query: string, options: MemorySearchOptions): Promise<Memory[]>;
+    get(id: string): Promise<Memory | null>;
+    update(id: string, updates: Partial<Memory>): Promise<void>;
+    delete(id: string): Promise<void>;
+    deleteBatch(ids: string[]): Promise<void>;
+    clearSession(sessionId: string): Promise<void>;
+    clear(): Promise<void>;
+    summarize(options: SummarizeOptions): Promise<string>;
+    consolidate(memories: Memory[]): Promise<Memory>;
+    getStats(sessionId?: string): Promise<MemoryStats>;
+    prune(options?: {
+        olderThan?: Date;
+        minImportance?: number;
+    }): Promise<number>;
+    /**
+     * Archive old memories from buffer to vector store
+     */
+    private archiveOldMemories;
+    /**
+     * Merge and deduplicate results from multiple stores
+     */
+    private mergeResults;
+}
+//# sourceMappingURL=hybrid-memory.d.ts.map

package/dist/memory/stores/hybrid-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/stores/hybrid-memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,MAAM,EACN,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EAEZ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAE,kBAAuB;IAMtF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUrC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWhD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgB/C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAatE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASvC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUrD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAWhD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkClD,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,IAAI,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IASpF;;OAEG;YACW,kBAAkB;IAqBhC;;OAEG;IACH,OAAO,CAAC,YAAY;CAsBrB"}

package/dist/memory/stores/hybrid-memory.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Hybrid Memory Store - Combines buffer and vector memory strategies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HybridMemory = void 0;
+const types_1 = require("../types");
+/**
+ * Hybrid memory that combines short-term buffer and long-term vector storage
+ * Recent memories stay in fast buffer, older ones move to vector store
+ */
+class HybridMemory {
+    constructor(buffer, vectorStore, config = {}) {
+        this.buffer = buffer;
+        this.vectorStore = vectorStore;
+        this.archiveThreshold = config.archiveThreshold || 20;
+    }
+    async initialize() {
+        await this.buffer.initialize();
+        await this.vectorStore.initialize();
+    }
+    async save(memory) {
+        // Save to buffer first
+        const id = await this.buffer.save(memory);
+        // Check if we need to archive old memories
+        await this.archiveOldMemories(memory.metadata.sessionId);
+        return id;
+    }
+    async saveBatch(memories) {
+        const ids = await this.buffer.saveBatch(memories);
+        // Archive if needed
+        if (memories.length > 0 && memories[0].metadata.sessionId) {
+            await this.archiveOldMemories(memories[0].metadata.sessionId);
+        }
+        return ids;
+    }
+    async retrieve(query) {
+        // Get from both stores
+        const [bufferResults, vectorResults] = await Promise.all([
+            this.buffer.retrieve(query),
+            this.vectorStore.retrieve(query),
+        ]);
+        // Merge and deduplicate
+        const merged = this.mergeResults(bufferResults, vectorResults);
+        // Sort by timestamp
+        merged.sort((a, b) => b.metadata.timestamp.getTime() - a.metadata.timestamp.getTime());
+        return merged.slice(0, query.limit || 100);
+    }
+    async search(query, options) {
+        // Search in both stores
+        const [bufferResults, vectorResults] = await Promise.all([
+            this.buffer.search(query, options),
+            this.vectorStore.search(query, options),
+        ]);
+        // Merge results, prioritizing vector store scores
+        const merged = this.mergeResults(bufferResults, vectorResults);
+        return merged.slice(0, options.topK || 10);
+    }
+    async get(id) {
+        // Try buffer first (faster)
+        const memory = await this.buffer.get(id);
+        if (memory)
+            return memory;
+        // Fall back to vector store
+        return this.vectorStore.get(id);
+    }
+    async update(id, updates) {
+        // Try to update in buffer first
+        try {
+            await this.buffer.update(id, updates);
+        }
+        catch {
+            // If not in buffer, update in vector store
+            await this.vectorStore.update(id, updates);
+        }
+    }
+    async delete(id) {
+        // Delete from both stores
+        await Promise.all([
+            this.buffer.delete(id).catch(() => { }),
+            this.vectorStore.delete(id).catch(() => { }),
+        ]);
+    }
+    async deleteBatch(ids) {
+        await Promise.all([
+            this.buffer.deleteBatch(ids).catch(() => { }),
+            this.vectorStore.deleteBatch(ids).catch(() => { }),
+        ]);
+    }
+    async clearSession(sessionId) {
+        await Promise.all([
+            this.buffer.clearSession(sessionId),
+            this.vectorStore.clearSession(sessionId),
+        ]);
+    }
+    async clear() {
+        await Promise.all([this.buffer.clear(), this.vectorStore.clear()]);
+    }
+    async summarize(options) {
+        // Summarize from both stores
+        const [bufferSummary, vectorSummary] = await Promise.all([
+            this.buffer.summarize(options),
+            this.vectorStore.summarize(options),
+        ]);
+        return `${bufferSummary}\n\n${vectorSummary}`;
+    }
+    async consolidate(memories) {
+        // Consolidate and save to vector store
+        const consolidated = await this.vectorStore.consolidate(memories);
+        // Remove originals from buffer
+        const ids = memories.map((m) => m.id);
+        await this.buffer.deleteBatch(ids).catch(() => { });
+        return consolidated;
+    }
+    async getStats(sessionId) {
+        const [bufferStats, vectorStats] = await Promise.all([
+            this.buffer.getStats(sessionId),
+            this.vectorStore.getStats(sessionId),
+        ]);
+        // Combine stats
+        const byType = {
+            [types_1.MemoryType.CONVERSATION]: 0,
+            [types_1.MemoryType.ENTITY]: 0,
+            [types_1.MemoryType.FACT]: 0,
+            [types_1.MemoryType.EVENT]: 0,
+            [types_1.MemoryType.WORKING]: 0,
+        };
+        for (const type of Object.keys(byType)) {
+            byType[type] = bufferStats.byType[type] + vectorStats.byType[type];
+        }
+        return {
+            totalMemories: bufferStats.totalMemories + vectorStats.totalMemories,
+            byType,
+            oldestMemory: bufferStats.oldestMemory < vectorStats.oldestMemory
+                ? bufferStats.oldestMemory
+                : vectorStats.oldestMemory,
+            newestMemory: bufferStats.newestMemory > vectorStats.newestMemory
+                ? bufferStats.newestMemory
+                : vectorStats.newestMemory,
+            averageImportance: (bufferStats.averageImportance + vectorStats.averageImportance) / 2,
+        };
+    }
+    async prune(options) {
+        const [bufferPruned, vectorPruned] = await Promise.all([
+            this.buffer.prune(options),
+            this.vectorStore.prune(options),
+        ]);
+        return bufferPruned + vectorPruned;
+    }
+    /**
+     * Archive old memories from buffer to vector store
+     */
+    async archiveOldMemories(sessionId) {
+        if (!sessionId)
+            return;
+        const bufferMemories = await this.buffer.retrieve({
+            sessionId,
+            limit: 1000,
+        });
+        // If buffer has more than threshold, archive oldest
+        if (bufferMemories.length > this.archiveThreshold) {
+            const toArchive = bufferMemories.slice(this.archiveThreshold);
+            // Move to vector store
+            await this.vectorStore.saveBatch(toArchive);
+            // Remove from buffer
+            const ids = toArchive.map((m) => m.id);
+            await this.buffer.deleteBatch(ids);
+        }
+    }
+    /**
+     * Merge and deduplicate results from multiple stores
+     */
+    mergeResults(bufferResults, vectorResults) {
+        const seen = new Set();
+        const merged = [];
+        // Add buffer results first (more recent)
+        for (const memory of bufferResults) {
+            if (!seen.has(memory.id)) {
+                seen.add(memory.id);
+                merged.push(memory);
+            }
+        }
+        // Add vector results
+        for (const memory of vectorResults) {
+            if (!seen.has(memory.id)) {
+                seen.add(memory.id);
+                merged.push(memory);
+            }
+        }
+        return merged;
+    }
+}
+exports.HybridMemory = HybridMemory;
+//# sourceMappingURL=hybrid-memory.js.map

package/dist/memory/stores/hybrid-memory.js.map

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

package/dist/memory/stores/vector-memory.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Vector Memory Store - Stores memories as embeddings for semantic search
+ */
+import { MemoryStore } from '../memory-store.interface';
+import { Memory, MemoryQuery, MemorySearchOptions, SummarizeOptions, MemoryStats } from '../types';
+import { VectorStore } from '../../types';
+import { EmbeddingProvider } from '../../types';
+export interface VectorMemoryConfig {
+    collectionName?: string;
+    namespace?: string;
+}
+/**
+ * Memory store that uses vector embeddings for semantic search
+ * Leverages existing vector store infrastructure
+ */
+export declare class VectorMemory implements MemoryStore {
+    private vectorStore;
+    private embeddings;
+    private config;
+    constructor(vectorStore: VectorStore, embeddings: EmbeddingProvider, config?: VectorMemoryConfig);
+    initialize(): Promise<void>;
+    save(memory: Memory): Promise<string>;
+    saveBatch(memories: Memory[]): Promise<string[]>;
+    retrieve(query: MemoryQuery): Promise<Memory[]>;
+    search(query: string, options: MemorySearchOptions): Promise<Memory[]>;
+    get(id: string): Promise<Memory | null>;
+    update(id: string, updates: Partial<Memory>): Promise<void>;
+    delete(id: string): Promise<void>;
+    deleteBatch(ids: string[]): Promise<void>;
+    clearSession(sessionId: string): Promise<void>;
+    clear(): Promise<void>;
+    summarize(options: SummarizeOptions): Promise<string>;
+    consolidate(memories: Memory[]): Promise<Memory>;
+    getStats(sessionId?: string): Promise<MemoryStats>;
+    prune(options?: {
+        olderThan?: Date;
+        minImportance?: number;
+    }): Promise<number>;
+    /**
+     * Convert search result to memory
+     */
+    private searchResultToMemory;
+    /**
+     * Convert document to memory
+     */
+    private documentToMemory;
+}
+//# sourceMappingURL=vector-memory.d.ts.map

package/dist/memory/stores/vector-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/stores/vector-memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,MAAM,EACN,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EAEZ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,MAAM,CAAqB;gBAGjC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,iBAAiB,EAC7B,MAAM,GAAE,kBAAuB;IAO3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BrC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA6BhD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgD/C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0CtE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQvC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcrD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BhD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoClD,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,IAAI,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BpF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAiBzB"}