@hazeljs/rag 0.2.0-beta.1

package/dist/memory/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EACL,MAAM,EAEN,YAAY,EACZ,OAAO,EACP,MAAM,EACN,WAAW,EACX,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAGjB;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAe;gBAEjB,KAAK,EAAE,WAAW,EAAE,MAAM,GAAE,YAAiB;IAcnD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBvF;;OAEG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAenF;;OAEG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ/D;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpE;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgBrD;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BzE;;OAEG;IACG,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoB3D;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAelF;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUlF;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/D;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC/E;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBlE;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAItF;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxD;;OAEG;IACG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,SAAS,EAAE,WAAW,CAAC;IAM1E;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;YACW,kBAAkB;CAiBjC"}

package/dist/memory/memory-manager.js

@@ -0,0 +1,369 @@
+"use strict";
+/**
+ * Memory Manager - High-level interface for managing different types of memory
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryManager = void 0;
+const types_1 = require("./types");
+const crypto_1 = require("crypto");
+/**
+ * Central manager for all memory operations
+ * Provides high-level APIs for conversation, entity, fact, and working memory
+ */
+class MemoryManager {
+    constructor(store, config = {}) {
+        this.store = store;
+        this.config = {
+            maxConversationLength: config.maxConversationLength || 20,
+            summarizeAfter: config.summarizeAfter || 50,
+            entityExtraction: config.entityExtraction ?? true,
+            importanceScoring: config.importanceScoring ?? true,
+            memoryDecay: config.memoryDecay ?? false,
+            decayRate: config.decayRate || 0.1,
+            maxWorkingMemorySize: config.maxWorkingMemorySize || 10,
+            ...config,
+        };
+    }
+    async initialize() {
+        await this.store.initialize();
+    }
+    // ==================== Conversation Memory ====================
+    /**
+     * Add a message to conversation history
+     */
+    async addMessage(message, sessionId, userId) {
+        const memory = {
+            id: (0, crypto_1.randomUUID)(),
+            type: types_1.MemoryType.CONVERSATION,
+            content: `${message.role}: ${message.content}`,
+            metadata: {
+                timestamp: message.timestamp || new Date(),
+                sessionId,
+                userId,
+                role: message.role,
+                importance: this.calculateImportance(message.content),
+                ...message.metadata,
+            },
+        };
+        const id = await this.store.save(memory);
+        // Check if we need to summarize
+        await this.checkAndSummarize(sessionId);
+        return id;
+    }
+    /**
+     * Get conversation history for a session
+     */
+    async getConversationHistory(sessionId, limit) {
+        const memories = await this.store.retrieve({
+            sessionId,
+            types: [types_1.MemoryType.CONVERSATION],
+            limit: limit || this.config.maxConversationLength,
+        });
+        return memories.map((m) => ({
+            role: m.metadata.role,
+            content: m.content.replace(/^(user|assistant|system): /, ''),
+            timestamp: m.metadata.timestamp,
+            metadata: m.metadata,
+        }));
+    }
+    /**
+     * Summarize conversation history
+     */
+    async summarizeConversation(sessionId) {
+        return this.store.summarize({
+            sessionId,
+            maxLength: 1000,
+            strategy: 'extractive',
+        });
+    }
+    /**
+     * Clear conversation history for a session
+     */
+    async clearConversation(sessionId) {
+        const memories = await this.store.retrieve({
+            sessionId,
+            types: [types_1.MemoryType.CONVERSATION],
+        });
+        const ids = memories.map((m) => m.id);
+        if (ids.length > 0) {
+            await this.store.deleteBatch(ids);
+        }
+    }
+    // ==================== Entity Memory ====================
+    /**
+     * Track an entity mentioned in conversation
+     */
+    async trackEntity(entity, sessionId) {
+        const memory = {
+            id: (0, crypto_1.randomUUID)(),
+            type: types_1.MemoryType.ENTITY,
+            content: JSON.stringify(entity),
+            metadata: {
+                timestamp: new Date(),
+                sessionId,
+                entityName: entity.name,
+                entityType: entity.type,
+                entities: [entity.name],
+                importance: 0.8,
+            },
+        };
+        await this.store.save(memory);
+    }
+    /**
+     * Get entity by name
+     */
+    async getEntity(name) {
+        const memories = await this.store.retrieve({
+            entities: [name],
+            types: [types_1.MemoryType.ENTITY],
+            limit: 1,
+        });
+        if (memories.length === 0)
+            return null;
+        try {
+            return JSON.parse(memories[0].content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Update entity information
+     */
+    async updateEntity(name, updates) {
+        const existing = await this.getEntity(name);
+        if (!existing) {
+            throw new Error(`Entity ${name} not found`);
+        }
+        const updated = {
+            ...existing,
+            ...updates,
+            lastSeen: new Date(),
+            mentions: existing.mentions + 1,
+        };
+        const memories = await this.store.retrieve({
+            entities: [name],
+            types: [types_1.MemoryType.ENTITY],
+            limit: 1,
+        });
+        if (memories.length > 0) {
+            await this.store.update(memories[0].id, {
+                content: JSON.stringify(updated),
+                metadata: {
+                    ...memories[0].metadata,
+                    timestamp: new Date(),
+                },
+            });
+        }
+    }
+    /**
+     * Get all tracked entities
+     */
+    async getAllEntities(sessionId) {
+        const memories = await this.store.retrieve({
+            sessionId,
+            types: [types_1.MemoryType.ENTITY],
+            limit: 1000,
+        });
+        return memories
+            .map((m) => {
+            try {
+                return JSON.parse(m.content);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((e) => e !== null);
+    }
+    // ==================== Semantic Memory (Facts) ====================
+    /**
+     * Store a fact or piece of knowledge
+     */
+    async storeFact(fact, metadata) {
+        const memory = {
+            id: (0, crypto_1.randomUUID)(),
+            type: types_1.MemoryType.FACT,
+            content: fact,
+            metadata: {
+                timestamp: new Date(),
+                importance: this.calculateImportance(fact),
+                ...metadata,
+            },
+        };
+        return this.store.save(memory);
+    }
+    /**
+     * Recall facts related to a query
+     */
+    async recallFacts(query, options) {
+        const memories = await this.store.search(query, {
+            types: [types_1.MemoryType.FACT],
+            topK: options?.topK || 5,
+            ...options,
+        });
+        return memories.map((m) => m.content);
+    }
+    /**
+     * Update a fact
+     */
+    async updateFact(id, newContent) {
+        await this.store.update(id, {
+            content: newContent,
+            metadata: {
+                timestamp: new Date(),
+                updated: true,
+            },
+        });
+    }
+    // ==================== Working Memory ====================
+    /**
+     * Set a value in working memory (temporary context)
+     */
+    async setContext(key, value, sessionId) {
+        // Check if context already exists
+        const existing = await this.store.retrieve({
+            sessionId,
+            types: [types_1.MemoryType.WORKING],
+            limit: 1000,
+        });
+        const existingContext = existing.find((m) => m.metadata.contextKey === key);
+        if (existingContext) {
+            // Update existing
+            await this.store.update(existingContext.id, {
+                content: JSON.stringify(value),
+                metadata: {
+                    ...existingContext.metadata,
+                    timestamp: new Date(),
+                },
+            });
+        }
+        else {
+            // Create new
+            const memory = {
+                id: (0, crypto_1.randomUUID)(),
+                type: types_1.MemoryType.WORKING,
+                content: JSON.stringify(value),
+                metadata: {
+                    timestamp: new Date(),
+                    sessionId,
+                    contextKey: key,
+                    importance: 0.5,
+                },
+            };
+            await this.store.save(memory);
+        }
+        // Enforce max working memory size
+        await this.pruneWorkingMemory(sessionId);
+    }
+    /**
+     * Get a value from working memory
+     */
+    async getContext(key, sessionId) {
+        const memories = await this.store.retrieve({
+            sessionId,
+            types: [types_1.MemoryType.WORKING],
+            limit: 1000,
+        });
+        const memory = memories.find((m) => m.metadata.contextKey === key);
+        if (!memory)
+            return null;
+        try {
+            return JSON.parse(memory.content);
+        }
+        catch {
+            return memory.content;
+        }
+    }
+    /**
+     * Clear working memory for a session
+     */
+    async clearContext(sessionId) {
+        const memories = await this.store.retrieve({
+            sessionId,
+            types: [types_1.MemoryType.WORKING],
+        });
+        const ids = memories.map((m) => m.id);
+        if (ids.length > 0) {
+            await this.store.deleteBatch(ids);
+        }
+    }
+    // ==================== Memory Retrieval ====================
+    /**
+     * Get relevant memories for a query
+     */
+    async relevantMemories(query, options) {
+        return this.store.search(query, options);
+    }
+    /**
+     * Get memories by query parameters
+     */
+    async getMemories(query) {
+        return this.store.retrieve(query);
+    }
+    /**
+     * Get memory statistics
+     */
+    async getStats(sessionId) {
+        return this.store.getStats(sessionId);
+    }
+    // ==================== Private Helper Methods ====================
+    /**
+     * Calculate importance score for content
+     */
+    calculateImportance(content) {
+        if (!this.config.importanceScoring)
+            return 0.5;
+        // Simple heuristic: longer content and questions are more important
+        let score = 0.5;
+        if (content.length > 100)
+            score += 0.2;
+        if (content.includes('?'))
+            score += 0.1;
+        if (content.includes('important') || content.includes('remember'))
+            score += 0.2;
+        return Math.min(score, 1.0);
+    }
+    /**
+     * Check if conversation needs summarization
+     */
+    async checkAndSummarize(sessionId) {
+        if (!this.config.summarizeAfter)
+            return;
+        const memories = await this.store.retrieve({
+            sessionId,
+            types: [types_1.MemoryType.CONVERSATION],
+            limit: 1000,
+        });
+        if (memories.length >= this.config.summarizeAfter) {
+            // Summarize oldest messages
+            const toSummarize = memories.slice(this.config.maxConversationLength);
+            if (toSummarize.length > 0) {
+                await this.store.consolidate(toSummarize);
+                // Delete original messages
+                const ids = toSummarize.map((m) => m.id);
+                await this.store.deleteBatch(ids);
+            }
+        }
+    }
+    /**
+     * Prune working memory to max size
+     */
+    async pruneWorkingMemory(sessionId) {
+        const memories = await this.store.retrieve({
+            sessionId,
+            types: [types_1.MemoryType.WORKING],
+            limit: 1000,
+        });
+        if (memories.length > this.config.maxWorkingMemorySize) {
+            // Remove oldest
+            const toRemove = memories
+                .sort((a, b) => a.metadata.timestamp.getTime() - b.metadata.timestamp.getTime())
+                .slice(0, memories.length - this.config.maxWorkingMemorySize);
+            const ids = toRemove.map((m) => m.id);
+            await this.store.deleteBatch(ids);
+        }
+    }
+}
+exports.MemoryManager = MemoryManager;
+//# sourceMappingURL=memory-manager.js.map

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

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

package/dist/memory/memory-store.interface.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Memory store interface
+ */
+import { Memory, MemoryQuery, MemorySearchOptions, SummarizeOptions, MemoryStats } from './types';
+/**
+ * Interface for memory storage backends
+ */
+export interface MemoryStore {
+    /**
+     * Initialize the memory store
+     */
+    initialize(): Promise<void>;
+    /**
+     * Save a memory
+     */
+    save(memory: Memory): Promise<string>;
+    /**
+     * Save multiple memories
+     */
+    saveBatch(memories: Memory[]): Promise<string[]>;
+    /**
+     * Retrieve memories by query
+     */
+    retrieve(query: MemoryQuery): Promise<Memory[]>;
+    /**
+     * Search memories semantically
+     */
+    search(query: string, options: MemorySearchOptions): Promise<Memory[]>;
+    /**
+     * Get a specific memory by ID
+     */
+    get(id: string): Promise<Memory | null>;
+    /**
+     * Update a memory
+     */
+    update(id: string, updates: Partial<Memory>): Promise<void>;
+    /**
+     * Delete a memory
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Delete multiple memories
+     */
+    deleteBatch(ids: string[]): Promise<void>;
+    /**
+     * Clear all memories for a session
+     */
+    clearSession(sessionId: string): Promise<void>;
+    /**
+     * Clear all memories
+     */
+    clear(): Promise<void>;
+    /**
+     * Summarize memories
+     */
+    summarize(options: SummarizeOptions): Promise<string>;
+    /**
+     * Consolidate similar memories
+     */
+    consolidate(memories: Memory[]): Promise<Memory>;
+    /**
+     * Get memory statistics
+     */
+    getStats(sessionId?: string): Promise<MemoryStats>;
+    /**
+     * Prune old or low-importance memories
+     */
+    prune(options?: {
+        olderThan?: Date;
+        minImportance?: number;
+    }): Promise<number>;
+}
+//# sourceMappingURL=memory-store.interface.d.ts.map

package/dist/memory/memory-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.interface.d.ts","sourceRoot":"","sources":["../../src/memory/memory-store.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvE;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnD;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,IAAI,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChF"}

package/dist/memory/memory-store.interface.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Memory store interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=memory-store.interface.js.map

package/dist/memory/memory-store.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.interface.js","sourceRoot":"","sources":["../../src/memory/memory-store.interface.ts"],"names":[],"mappings":";AAAA;;GAEG"}

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

@@ -0,0 +1,47 @@
+/**
+ * Buffer Memory Store - Simple FIFO buffer for recent memories
+ */
+import { MemoryStore } from '../memory-store.interface';
+import { Memory, MemoryQuery, MemorySearchOptions, SummarizeOptions, MemoryStats } from '../types';
+export interface BufferMemoryConfig {
+    maxSize?: number;
+    ttl?: number;
+}
+/**
+ * In-memory buffer that keeps the most recent memories
+ * Uses FIFO (First In, First Out) strategy
+ */
+export declare class BufferMemory implements MemoryStore {
+    private memories;
+    private sessionBuffers;
+    private maxSize;
+    private ttl?;
+    constructor(config?: BufferMemoryConfig);
+    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>;
+    /**
+     * Clean expired memories
+     */
+    private cleanExpired;
+    /**
+     * Calculate simple text similarity score
+     */
+    private calculateTextScore;
+}
+//# sourceMappingURL=buffer-memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/stores/buffer-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;AAGlB,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAC,CAAS;gBAET,MAAM,GAAE,kBAAuB;IAKrC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkCrC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAShD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmD/C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBtE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKvC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAerD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBhD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsClD,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,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAa3B"}