memento-mcp-server 1.13.1-a0 → 1.13.1-a3

package/dist/domains/memory/services/memory-neighbor-service.js

@@ -0,0 +1,297 @@
+/**
+ * Memory Neighbor Service
+ * 벡터 유사도를 기반으로 특정 기억의 이웃 기억을 조회하는 서비스
+ */
+import Database from 'better-sqlite3';
+import { DatabaseUtils } from '../../../shared/utils/database.js';
+/**
+ * 메모리를 찾을 수 없을 때 발생하는 에러
+ */
+export class MemoryNotFoundError extends Error {
+    constructor(memoryId) {
+        super(`Memory with ID '${memoryId}' not found`);
+        this.name = 'MemoryNotFoundError';
+    }
+}
+/**
+ * Memory Neighbor Service
+ * 벡터 유사도를 기반으로 기억의 이웃을 찾는 서비스
+ */
+export class MemoryNeighborService {
+    vectorSearchEngine;
+    embeddingService;
+    db = null;
+    /**
+     * 생성자
+     * @param vectorSearchEngine - 벡터 검색 엔진 인스턴스
+     * @param embeddingService - 메모리 임베딩 서비스 인스턴스
+     */
+    constructor(vectorSearchEngine, embeddingService) {
+        if (!vectorSearchEngine) {
+            throw new Error('VectorSearchEngine is required');
+        }
+        if (!embeddingService) {
+            throw new Error('MemoryEmbeddingService is required');
+        }
+        this.vectorSearchEngine = vectorSearchEngine;
+        this.embeddingService = embeddingService;
+    }
+    /**
+     * 데이터베이스 설정
+     * VectorSearchEngine에도 데이터베이스를 설정합니다.
+     * @param db - 데이터베이스 인스턴스
+     */
+    setDatabase(db) {
+        if (!db) {
+            throw new Error('Database instance is required');
+        }
+        this.db = db;
+        // VectorSearchEngine에도 데이터베이스 설정 (메서드가 있는 경우)
+        if (this.vectorSearchEngine && typeof this.vectorSearchEngine.setDatabase === 'function') {
+            this.vectorSearchEngine.setDatabase(db);
+        }
+    }
+    /**
+     * 특정 기억의 이웃 기억을 조회
+     * @param memoryId - 조회할 기억의 ID
+     * @param options - 조회 옵션 (limit, similarity_threshold)
+     * @returns 이웃 기억 조회 결과
+     * @throws {MemoryNotFoundError} 메모리를 찾을 수 없는 경우
+     * @throws {Error} 데이터베이스 오류, 벡터 검색 오류 등
+     */
+    async getNeighbors(memoryId, options = {}) {
+        const startTime = Date.now();
+        try {
+            // 기본값 설정
+            const limit = options.limit ?? 5;
+            const similarityThreshold = options.similarity_threshold ?? 0.8;
+            // 데이터베이스 확인
+            if (!this.db) {
+                throw new Error('Database is not set. Call setDatabase() first.');
+            }
+            // 1.4 - 메모리 ID 검증 로직
+            let memory;
+            try {
+                memory = await DatabaseUtils.get(this.db, 'SELECT id FROM memory_item WHERE id = ?', [memoryId]);
+            }
+            catch (error) {
+                console.error(`❌ 메모리 조회 실패 (${memoryId}):`, error);
+                throw new Error(`Failed to query memory: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+            if (!memory) {
+                throw new MemoryNotFoundError(memoryId);
+            }
+            // 1.5 - 임베딩 조회 로직
+            // memory_embedding 테이블에서 해당 기억의 임베딩 조회
+            // 가장 최근에 생성된 임베딩을 우선 사용 (여러 제공자가 있을 수 있음)
+            let embeddingRecord;
+            try {
+                embeddingRecord = await DatabaseUtils.get(this.db, `SELECT 
+            embedding,
+            embedding_provider,
+            dimensions,
+            dim
+          FROM memory_embedding
+          WHERE memory_id = ?
+          ORDER BY created_at DESC
+          LIMIT 1`, [memoryId]);
+            }
+            catch (error) {
+                console.error(`❌ 임베딩 조회 실패 (${memoryId}):`, error);
+                throw new Error(`Failed to query embedding: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+            // 1.6 - 임베딩이 없는 경우 처리
+            if (!embeddingRecord || !embeddingRecord.embedding) {
+                // 임베딩이 없으면 빈 결과 반환 (경고 없이)
+                const queryTime = Date.now() - startTime;
+                return {
+                    memory_id: memoryId,
+                    neighbors: [],
+                    total_count: 0,
+                    query_time: queryTime
+                };
+            }
+            // JSON 문자열로 저장된 임베딩을 배열로 파싱
+            let queryVector;
+            try {
+                queryVector = typeof embeddingRecord.embedding === 'string'
+                    ? JSON.parse(embeddingRecord.embedding)
+                    : embeddingRecord.embedding;
+                if (!Array.isArray(queryVector) || queryVector.length === 0) {
+                    // 유효하지 않은 임베딩이면 빈 결과 반환
+                    const queryTime = Date.now() - startTime;
+                    return {
+                        memory_id: memoryId,
+                        neighbors: [],
+                        total_count: 0,
+                        query_time: queryTime
+                    };
+                }
+            }
+            catch (error) {
+                // 파싱 실패 시 빈 결과 반환 (경고 없이)
+                const queryTime = Date.now() - startTime;
+                return {
+                    memory_id: memoryId,
+                    neighbors: [],
+                    total_count: 0,
+                    query_time: queryTime
+                };
+            }
+            const embeddingProvider = embeddingRecord.embedding_provider || 'tfidf';
+            // 1.7 - VectorSearchEngine.search 메서드를 활용하여 유사 기억 검색
+            // VectorSearchEngine에 데이터베이스가 설정되어 있는지 확인
+            // (initialize 메서드가 있는 경우 호출)
+            try {
+                if (typeof this.vectorSearchEngine.initialize === 'function') {
+                    this.vectorSearchEngine.initialize(this.db);
+                }
+            }
+            catch (error) {
+                console.error(`❌ VectorSearchEngine 초기화 실패:`, error);
+                throw new Error(`Failed to initialize VectorSearchEngine: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+            // 벡터 검색 실행
+            // limit을 더 많이 가져와서 필터링 후 최종 limit 적용
+            const searchLimit = limit + 1; // 자기 자신 제외를 위해 +1
+            let searchResults;
+            try {
+                searchResults = await this.vectorSearchEngine.search(queryVector, {
+                    limit: searchLimit,
+                    threshold: 0.0, // 임계값은 나중에 필터링에서 적용
+                    includeContent: true,
+                    includeMetadata: true
+                }, embeddingProvider);
+            }
+            catch (error) {
+                console.error(`❌ 벡터 검색 실패 (${memoryId}):`, error);
+                throw new Error(`Failed to search similar memories: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+            // 1.8 - 결과 필터링: 동일한 memory_id 제외, 유사도 임계값(threshold) 이상만 반환
+            const filteredResults = searchResults
+                .filter(result => {
+                // 동일한 기억 제외
+                if (result.memory_id === memoryId) {
+                    return false;
+                }
+                // 유사도 임계값 이상만 반환
+                return result.similarity >= similarityThreshold;
+            })
+                .slice(0, limit); // 최종 limit 적용
+            // 1.9 - 응답 형식 구성: 이웃 기억 목록, 총 개수, 쿼리 실행 시간 포함
+            const neighbors = filteredResults.map(result => ({
+                id: result.memory_id,
+                content: result.content,
+                type: result.type,
+                similarity: result.similarity,
+                importance: result.importance,
+                created_at: result.created_at,
+                tags: result.tags
+            }));
+            const queryTime = Date.now() - startTime;
+            return {
+                memory_id: memoryId,
+                neighbors,
+                total_count: neighbors.length,
+                query_time: queryTime
+            };
+        }
+        catch (error) {
+            // 1.10 - 에러 처리: 예외 상황에 대한 적절한 에러 메시지 및 로깅
+            const queryTime = Date.now() - startTime;
+            // MemoryNotFoundError는 그대로 전파
+            if (error instanceof MemoryNotFoundError) {
+                throw error;
+            }
+            // 기타 에러는 로깅 후 재던지기
+            console.error(`❌ 이웃 기억 조회 실패 (${memoryId}):`, error);
+            console.error(`   쿼리 시간: ${queryTime}ms`);
+            console.error(`   에러 스택:`, error instanceof Error ? error.stack : 'N/A');
+            // 사용자 친화적인 에러 메시지로 변환
+            if (error instanceof Error) {
+                throw new Error(`Failed to get memory neighbors: ${error.message}`);
+            }
+            throw new Error(`Failed to get memory neighbors: Unknown error`);
+        }
+    }
+    /**
+     * 새로 저장된 기억에 대한 인접 기억 목록 갱신
+     * PRD 3.1-3.3 요구사항: 새 기억 저장 시 기존 기억들과의 유사도 계산 및 인접 기억 식별
+     *
+     * @param newMemoryId - 새로 저장된 기억의 ID
+     * @param similarityThreshold - 유사도 임계값 (기본값: 0.8)
+     * @returns 인접 기억 ID 목록 (유사도가 임계값 이상인 기억들)
+     */
+    async updateNeighborsForNewMemory(newMemoryId, similarityThreshold = 0.8) {
+        if (!this.db) {
+            console.warn('⚠️ 데이터베이스가 설정되지 않아 인접 기억 갱신을 건너뜁니다.');
+            return [];
+        }
+        try {
+            // 새 기억의 임베딩 조회
+            const embeddingRecord = await DatabaseUtils.get(this.db, `SELECT 
+          embedding,
+          embedding_provider,
+          dimensions,
+          dim
+        FROM memory_embedding
+        WHERE memory_id = ?
+        ORDER BY created_at DESC
+        LIMIT 1`, [newMemoryId]);
+            // 임베딩이 없으면 빈 배열 반환 (경고 없이)
+            if (!embeddingRecord || !embeddingRecord.embedding) {
+                return [];
+            }
+            // JSON 문자열로 저장된 임베딩을 배열로 파싱
+            let queryVector;
+            try {
+                queryVector = typeof embeddingRecord.embedding === 'string'
+                    ? JSON.parse(embeddingRecord.embedding)
+                    : embeddingRecord.embedding;
+                if (!Array.isArray(queryVector) || queryVector.length === 0) {
+                    return [];
+                }
+            }
+            catch (error) {
+                // 파싱 실패 시 빈 배열 반환
+                return [];
+            }
+            const embeddingProvider = embeddingRecord.embedding_provider || 'tfidf';
+            // VectorSearchEngine 초기화
+            if (typeof this.vectorSearchEngine.initialize === 'function') {
+                this.vectorSearchEngine.initialize(this.db);
+            }
+            // 기존 모든 기억과의 유사도 계산
+            // sqlite-vec의 최대 제한(4096)을 고려하여 limit 설정
+            // 실제로는 모든 기억을 검색하려는 의도이지만, 벡터 검색 엔진의 제한을 준수
+            const maxLimit = 4096; // sqlite-vec의 최대 k 값 제한
+            const searchResults = await this.vectorSearchEngine.search(queryVector, {
+                limit: maxLimit, // sqlite-vec 최대 제한
+                threshold: 0.0, // 임계값은 나중에 필터링에서 적용
+                includeContent: false, // 성능 최적화: 내용 불필요
+                includeMetadata: false
+            }, embeddingProvider);
+            // 유사도가 임계값 이상인 기억들을 식별 (자기 자신 제외)
+            const neighborIds = searchResults
+                .filter(result => {
+                // 동일한 기억 제외
+                if (result.memory_id === newMemoryId) {
+                    return false;
+                }
+                // 유사도 임계값 이상만 반환
+                return result.similarity >= similarityThreshold;
+            })
+                .map(result => result.memory_id);
+            // PRD 3.4: 인접 기억 정보를 데이터베이스에 저장 (선택적)
+            // 이번 단계에서는 저장하지 않고 계산만 수행
+            // 향후 성능 최적화가 필요한 경우 memory_neighbors 테이블 추가 고려
+            return neighborIds;
+        }
+        catch (error) {
+            // 에러 발생 시 로깅 후 빈 배열 반환 (메모리 저장은 성공했으므로)
+            console.error(`❌ 인접 기억 갱신 실패 (${newMemoryId}):`, error);
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=memory-neighbor-service.js.map

package/dist/domains/memory/services/memory-neighbor-service.js.map

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

package/dist/domains/memory/tools/cleanup-memory-tool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cleanup Memory Tool - 메모리 정리 도구
+ */
+import { BaseTool } from '../../../tools/base-tool.js';
+import type { ToolContext, ToolResult } from '../../../tools/types.js';
+export declare class CleanupMemoryTool extends BaseTool {
+    constructor();
+    handle(params: any, context: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=cleanup-memory-tool.d.ts.map

package/dist/domains/memory/tools/cleanup-memory-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-memory-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/memory/tools/cleanup-memory-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAOvE,qBAAa,iBAAkB,SAAQ,QAAQ;;IAkBvC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA6CrE"}

package/dist/domains/memory/tools/cleanup-memory-tool.js

@@ -0,0 +1,66 @@
+/**
+ * Cleanup Memory Tool - 메모리 정리 도구
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import { CommonSchemas } from '../../../tools/types.js';
+const CleanupMemorySchema = z.object({
+    dry_run: CommonSchemas.DryRun,
+});
+export class CleanupMemoryTool extends BaseTool {
+    constructor() {
+        super('cleanup_memory', '망각 정책에 따라 메모리를 정리합니다', {
+            type: 'object',
+            properties: {
+                dry_run: {
+                    type: 'boolean',
+                    description: '드라이런 모드 (실제 삭제 없이 분석만)',
+                    default: false
+                }
+            }
+        });
+    }
+    async handle(params, context) {
+        const { dry_run } = CleanupMemorySchema.parse(params);
+        // 데이터베이스 연결 확인
+        this.validateDatabase(context);
+        // 망각 정책 서비스 확인
+        this.validateService(context.services.forgettingPolicyService, '망각 정책 서비스');
+        try {
+            if (dry_run) {
+                // 드라이런 모드: 실제 삭제 없이 분석만 수행
+                const stats = await context.services.forgettingPolicyService.generateForgettingStats(context.db);
+                return this.createSuccessResult({
+                    mode: 'dry_run',
+                    stats: {
+                        totalMemories: stats.totalMemories,
+                        forgetCandidates: stats.forgetCandidates,
+                        reviewCandidates: stats.reviewCandidates,
+                        averageForgetScore: stats.averageForgetScore,
+                        memoryDistribution: stats.memoryDistribution
+                    },
+                    message: '망각 후보 분석 완료 (실제 삭제 없음)'
+                });
+            }
+            else {
+                // 실제 정리 실행
+                const result = await context.services.forgettingPolicyService.executeMemoryCleanup(context.db);
+                return this.createSuccessResult({
+                    mode: 'execution',
+                    result: {
+                        softDeleted: result.softDeleted,
+                        hardDeleted: result.hardDeleted,
+                        reviewed: result.reviewed,
+                        totalProcessed: result.totalProcessed,
+                        summary: result.summary
+                    },
+                    message: `메모리 정리 완료: 소프트 삭제 ${result.summary.actualSoftDeletes}개, 하드 삭제 ${result.summary.actualHardDeletes}개, 리뷰 ${result.summary.actualReviews}개`
+                });
+            }
+        }
+        catch (error) {
+            throw new Error(`메모리 정리 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+//# sourceMappingURL=cleanup-memory-tool.js.map

package/dist/domains/memory/tools/cleanup-memory-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-memory-tool.js","sourceRoot":"","sources":["../../../../src/domains/memory/tools/cleanup-memory-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,aAAa,CAAC,MAAM;CAC9B,CAAC,CAAC;AAEH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C;QACE,KAAK,CACH,gBAAgB,EAChB,sBAAsB,EACtB;YACE,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,wBAAwB;oBACrC,OAAO,EAAE,KAAK;iBACf;aACF;SACF,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAW,EAAE,OAAoB;QAC5C,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEtD,eAAe;QACf,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE/B,eAAe;QACf,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,IAAI,OAAO,EAAE,CAAC;gBACZ,2BAA2B;gBAC3B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAEjG,OAAO,IAAI,CAAC,mBAAmB,CAAC;oBAC9B,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,aAAa,EAAE,KAAK,CAAC,aAAa;wBAClC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;wBACxC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;wBACxC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;wBAC5C,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;qBAC7C;oBACD,OAAO,EAAE,wBAAwB;iBAClC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,WAAW;gBACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAE/F,OAAO,IAAI,CAAC,mBAAmB,CAAC;oBAC9B,IAAI,EAAE,WAAW;oBACjB,MAAM,EAAE;wBACN,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,cAAc,EAAE,MAAM,CAAC,cAAc;wBACrC,OAAO,EAAE,MAAM,CAAC,OAAO;qBACxB;oBACD,OAAO,EAAE,qBAAqB,MAAM,CAAC,OAAO,CAAC,iBAAiB,YAAY,MAAM,CAAC,OAAO,CAAC,iBAAiB,SAAS,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG;iBACnJ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;CACF"}

package/dist/domains/memory/tools/forget-tool.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Forget Tool - 기억 삭제 도구
+ * 안전한 기억 삭제 및 복구 기능
+ */
+import { BaseTool } from '../../../tools/base-tool.js';
+import type { ToolContext, ToolResult } from '../../../tools/types.js';
+export declare class ForgetTool extends BaseTool {
+    constructor();
+    /**
+     * 제공자별 vec0 테이블명 반환
+     */
+    private getVectorTableName;
+    handle(params: any, context: ToolContext): Promise<ToolResult>;
+    /**
+     * 단일 기억 삭제
+     */
+    private handleSingleDelete;
+    /**
+     * 배치 삭제 처리
+     */
+    private handleBatchDelete;
+    /**
+     * 하드 삭제 실행
+     */
+    private performHardDelete;
+    /**
+     * 소프트 삭제 실행
+     */
+    private performSoftDelete;
+    /**
+     * 기억 조회
+     */
+    private getMemoryById;
+    /**
+     * 삭제 권한 확인
+     */
+    private validateDeletePermission;
+    /**
+     * 삭제 로그 기록
+     */
+    private logDeleteAction;
+    /**
+     * 임베딩 삭제
+     */
+    private deleteEmbedding;
+    /**
+     * 관련 데이터 정리
+     */
+    private cleanupRelatedData;
+    /**
+     * 데이터베이스 락 처리
+     */
+    private handleDatabaseLock;
+    /**
+     * 삭제 가능한 기억 목록 조회
+     */
+    getDeletableMemories(context: ToolContext, limit?: number): Promise<any[]>;
+    /**
+     * 삭제 통계 조회
+     */
+    getDeleteStats(context: ToolContext): Promise<any>;
+}
+//# sourceMappingURL=forget-tool.d.ts.map

package/dist/domains/memory/tools/forget-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/memory/tools/forget-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAcvE,qBAAa,UAAW,SAAQ,QAAQ;;IA2CtC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAepB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA6DpE;;OAEG;YACW,kBAAkB;IAyDhC;;OAEG;YACW,iBAAiB;IAgC/B;;OAEG;YACW,iBAAiB;IAkC/B;;OAEG;YACW,iBAAiB;IAe/B;;OAEG;YACW,aAAa;IAQ3B;;OAEG;YACW,wBAAwB;IAYtC;;OAEG;YACW,eAAe;IAkB7B;;OAEG;YACW,eAAe;IAQ7B;;OAEG;YACW,kBAAkB;IAwChC;;OAEG;YACW,kBAAkB;IAShC;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAcpF;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;CA2BzD"}