memento-mcp-server 0.1.0

package/dist/services/embedding-service.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 통합 임베딩 서비스 (레거시)
+ * 새로운 UnifiedEmbeddingService로 대체됨
+ *
+ * @deprecated 이 클래스는 더 이상 사용되지 않습니다.
+ * @see UnifiedEmbeddingService 새로운 통합 서비스를 사용하세요.
+ * @since 0.1.0
+ * @removed 0.2.0 이 클래스는 제거될 예정입니다.
+ */
+export interface EmbeddingResult {
+    embedding: number[];
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface SimilarityResult {
+    id: string;
+    content: string;
+    similarity: number;
+    score: number;
+}
+export declare class EmbeddingService {
+    private openai;
+    private geminiService;
+    private lightweightService;
+    private readonly model;
+    private readonly maxTokens;
+    private embeddingCache;
+    private batchQueue;
+    private batchTimeout;
+    constructor();
+    /**
+     * OpenAI 클라이언트 초기화
+     */
+    private initializeOpenAI;
+    /**
+     * 텍스트를 임베딩으로 변환 - 캐시 최적화
+     */
+    generateEmbedding(text: string): Promise<EmbeddingResult | null>;
+    /**
+     * OpenAI 임베딩 생성
+     */
+    private generateOpenAIEmbedding;
+    /**
+     * Gemini 임베딩 생성
+     */
+    private generateGeminiEmbedding;
+    /**
+     * 경량 임베딩 생성
+     */
+    private generateLightweightEmbedding;
+    /**
+     * 쿼리와 유사한 임베딩 검색
+     */
+    searchSimilar(query: string, embeddings: Array<{
+        id: string;
+        content: string;
+        embedding: number[];
+    }>, limit?: number, threshold?: number): Promise<SimilarityResult[]>;
+    /**
+     * 코사인 유사도 계산
+     */
+    private cosineSimilarity;
+    /**
+     * 캐시 키 생성
+     */
+    private generateCacheKey;
+    /**
+     * 텍스트 해시 생성
+     */
+    private hashText;
+    /**
+     * 캐시 정리
+     */
+    private cleanupCache;
+    /**
+     * 텍스트를 토큰 제한에 맞게 자르기
+     */
+    private truncateText;
+    /**
+     * 서비스 사용 가능 여부 확인
+     */
+    isAvailable(): boolean;
+    /**
+     * 모델 정보 반환
+     */
+    getModelInfo(): {
+        model: string;
+        dimensions: number;
+        maxTokens: number;
+    };
+}
+//# sourceMappingURL=embedding-service.d.ts.map

package/dist/services/embedding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-service.d.ts","sourceRoot":"","sources":["../../src/services/embedding-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,YAAY,CAA+B;;IAQnD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA6CtE;;OAEG;YACW,uBAAuB;IA4BrC;;OAEG;YACW,uBAAuB;IAarC;;OAEG;YACW,4BAA4B;IAa1C;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,EACvE,KAAK,GAAE,MAAW,EAClB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAyB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAUhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,WAAW,IAAI,OAAO;IAetB;;OAEG;IACH,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAkBzE"}

package/dist/services/embedding-service.js

@@ -0,0 +1,276 @@
+/**
+ * 통합 임베딩 서비스 (레거시)
+ * 새로운 UnifiedEmbeddingService로 대체됨
+ *
+ * @deprecated 이 클래스는 더 이상 사용되지 않습니다.
+ * @see UnifiedEmbeddingService 새로운 통합 서비스를 사용하세요.
+ * @since 0.1.0
+ * @removed 0.2.0 이 클래스는 제거될 예정입니다.
+ */
+import OpenAI from 'openai';
+import { mementoConfig } from '../config/index.js';
+import { GeminiEmbeddingService } from './gemini-embedding-service.js';
+import { LightweightEmbeddingService } from './lightweight-embedding-service.js';
+export class EmbeddingService {
+    openai = null;
+    geminiService;
+    lightweightService;
+    model = 'text-embedding-3-small'; // 1536차원
+    maxTokens = 8191; // text-embedding-3-small 최대 토큰
+    embeddingCache = new Map(); // 임베딩 캐시
+    batchQueue = []; // 배치 처리 큐
+    batchTimeout = null;
+    constructor() {
+        this.geminiService = new GeminiEmbeddingService();
+        this.lightweightService = new LightweightEmbeddingService();
+        this.initializeOpenAI();
+    }
+    /**
+     * OpenAI 클라이언트 초기화
+     */
+    initializeOpenAI() {
+        if (!mementoConfig.openaiApiKey) {
+            console.warn('⚠️ OpenAI API 키가 설정되지 않았습니다. 임베딩 기능이 비활성화됩니다.');
+            return;
+        }
+        try {
+            this.openai = new OpenAI({
+                apiKey: mementoConfig.openaiApiKey,
+            });
+            console.log('✅ OpenAI 임베딩 서비스 초기화 완료');
+        }
+        catch (error) {
+            console.error('❌ OpenAI 초기화 실패:', error);
+            this.openai = null;
+        }
+    }
+    /**
+     * 텍스트를 임베딩으로 변환 - 캐시 최적화
+     */
+    async generateEmbedding(text) {
+        if (!text || text.trim().length === 0) {
+            throw new Error('텍스트가 비어있습니다');
+        }
+        // 1. 캐시 확인
+        const cacheKey = this.generateCacheKey(text);
+        const cached = this.embeddingCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // 2. 설정에 따른 제공자 선택
+        const provider = mementoConfig.embeddingProvider;
+        let result = null;
+        try {
+            switch (provider) {
+                case 'openai':
+                    result = await this.generateOpenAIEmbedding(text);
+                    break;
+                case 'gemini':
+                    result = await this.generateGeminiEmbedding(text);
+                    break;
+                case 'lightweight':
+                    result = await this.generateLightweightEmbedding(text);
+                    break;
+                default:
+                    console.warn(`⚠️ 알 수 없는 임베딩 제공자: ${provider}, 경량 서비스로 fallback`);
+                    result = await this.generateLightweightEmbedding(text);
+            }
+        }
+        catch (error) {
+            console.warn(`⚠️ ${provider} 임베딩 실패, 경량 서비스로 fallback:`, error);
+            result = await this.generateLightweightEmbedding(text);
+        }
+        if (result) {
+            // 캐시에 저장
+            this.embeddingCache.set(cacheKey, result);
+            this.cleanupCache();
+        }
+        return result;
+    }
+    /**
+     * OpenAI 임베딩 생성
+     */
+    async generateOpenAIEmbedding(text) {
+        if (!this.openai) {
+            throw new Error('OpenAI 클라이언트가 초기화되지 않았습니다');
+        }
+        const truncatedText = this.truncateText(text);
+        const response = await this.openai.embeddings.create({
+            model: this.model,
+            input: truncatedText,
+            encoding_format: 'float',
+        });
+        const embedding = response.data[0]?.embedding;
+        if (!embedding) {
+            throw new Error('임베딩 생성에 실패했습니다');
+        }
+        return {
+            embedding,
+            model: this.model,
+            usage: {
+                prompt_tokens: response.usage.prompt_tokens,
+                total_tokens: response.usage.total_tokens,
+            },
+        };
+    }
+    /**
+     * Gemini 임베딩 생성
+     */
+    async generateGeminiEmbedding(text) {
+        const geminiResult = await this.geminiService.generateEmbedding(text);
+        if (!geminiResult) {
+            return null;
+        }
+        return {
+            embedding: geminiResult.embedding,
+            model: geminiResult.model,
+            usage: geminiResult.usage,
+        };
+    }
+    /**
+     * 경량 임베딩 생성
+     */
+    async generateLightweightEmbedding(text) {
+        const lightweightResult = await this.lightweightService.generateEmbedding(text);
+        if (!lightweightResult) {
+            return null;
+        }
+        return {
+            embedding: lightweightResult.embedding,
+            model: lightweightResult.model,
+            usage: lightweightResult.usage,
+        };
+    }
+    /**
+     * 쿼리와 유사한 임베딩 검색
+     */
+    async searchSimilar(query, embeddings, limit = 10, threshold = 0.7) {
+        // 쿼리 임베딩 생성 (fallback 로직 포함)
+        const queryEmbedding = await this.generateEmbedding(query);
+        if (!queryEmbedding) {
+            return [];
+        }
+        // 코사인 유사도 계산
+        const similarities = embeddings.map(item => {
+            const similarity = this.cosineSimilarity(queryEmbedding.embedding, item.embedding);
+            return {
+                id: item.id,
+                content: item.content,
+                similarity,
+                score: similarity
+            };
+        });
+        // 유사도 순으로 정렬하고 임계값 필터링
+        return similarities
+            .filter(item => item.similarity >= threshold)
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, limit);
+    }
+    /**
+     * 코사인 유사도 계산
+     */
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length) {
+            throw new Error('벡터 차원이 일치하지 않습니다');
+        }
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            const aVal = a[i] || 0;
+            const bVal = b[i] || 0;
+            dotProduct += aVal * bVal;
+            normA += aVal * aVal;
+            normB += bVal * bVal;
+        }
+        normA = Math.sqrt(normA);
+        normB = Math.sqrt(normB);
+        if (normA === 0 || normB === 0) {
+            return 0;
+        }
+        return dotProduct / (normA * normB);
+    }
+    /**
+     * 캐시 키 생성
+     */
+    generateCacheKey(text) {
+        // 텍스트 해시를 사용하여 캐시 키 생성
+        return `embedding:${this.hashText(text)}`;
+    }
+    /**
+     * 텍스트 해시 생성
+     */
+    hashText(text) {
+        let hash = 0;
+        for (let i = 0; i < text.length; i++) {
+            const char = text.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // 32비트 정수로 변환
+        }
+        return Math.abs(hash).toString(36);
+    }
+    /**
+     * 캐시 정리
+     */
+    cleanupCache() {
+        const maxCacheSize = 1000;
+        if (this.embeddingCache.size > maxCacheSize) {
+            const entries = Array.from(this.embeddingCache.entries());
+            this.embeddingCache.clear();
+            // 최신 500개만 유지
+            entries.slice(-500).forEach(([key, value]) => {
+                this.embeddingCache.set(key, value);
+            });
+        }
+    }
+    /**
+     * 텍스트를 토큰 제한에 맞게 자르기
+     */
+    truncateText(text) {
+        // 간단한 토큰 추정 (1 토큰 ≈ 4 문자)
+        const estimatedTokens = text.length / 4;
+        if (estimatedTokens <= this.maxTokens) {
+            return text;
+        }
+        // 토큰 제한에 맞게 자르기
+        const maxChars = this.maxTokens * 4;
+        return text.substring(0, maxChars);
+    }
+    /**
+     * 서비스 사용 가능 여부 확인
+     */
+    isAvailable() {
+        const provider = mementoConfig.embeddingProvider;
+        switch (provider) {
+            case 'openai':
+                return this.openai !== null;
+            case 'gemini':
+                return this.geminiService.isAvailable();
+            case 'lightweight':
+                return this.lightweightService.isAvailable();
+            default:
+                return this.lightweightService.isAvailable();
+        }
+    }
+    /**
+     * 모델 정보 반환
+     */
+    getModelInfo() {
+        const provider = mementoConfig.embeddingProvider;
+        switch (provider) {
+            case 'openai':
+                return {
+                    model: this.model,
+                    dimensions: 1536, // text-embedding-3-small 차원
+                    maxTokens: this.maxTokens,
+                };
+            case 'gemini':
+                return this.geminiService.getModelInfo();
+            case 'lightweight':
+                return this.lightweightService.getModelInfo();
+            default:
+                return this.lightweightService.getModelInfo();
+        }
+    }
+}
+//# sourceMappingURL=embedding-service.js.map

package/dist/services/embedding-service.js.map

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

package/dist/services/error-logging-service.d.ts

@@ -0,0 +1,134 @@
+/**
+ * 에러 로깅 서비스
+ * 구조화된 에러 로깅, 분류, 모니터링, 알림 시스템
+ */
+export declare enum ErrorSeverity {
+    LOW = "low",
+    MEDIUM = "medium",
+    HIGH = "high",
+    CRITICAL = "critical"
+}
+export declare enum ErrorCategory {
+    DATABASE = "database",
+    NETWORK = "network",
+    VALIDATION = "validation",
+    AUTHENTICATION = "authentication",
+    PERFORMANCE = "performance",
+    MEMORY = "memory",
+    SEARCH = "search",
+    EMBEDDING = "embedding",
+    CACHE = "cache",
+    UNKNOWN = "unknown"
+}
+export interface ErrorLog {
+    id: string;
+    timestamp: Date;
+    severity: ErrorSeverity;
+    category: ErrorCategory;
+    message: string;
+    stack?: string;
+    context: {
+        userId?: string;
+        sessionId?: string;
+        requestId?: string;
+        operation?: string;
+        component?: string;
+        [key: string]: any;
+    };
+    metadata: {
+        userAgent?: string;
+        ipAddress?: string;
+        memoryUsage?: NodeJS.MemoryUsage;
+        cpuUsage?: NodeJS.CpuUsage;
+        [key: string]: any;
+    };
+    resolved: boolean;
+    resolvedAt?: Date;
+    resolvedBy?: string;
+}
+export interface ErrorStats {
+    totalErrors: number;
+    errorsBySeverity: Record<ErrorSeverity, number>;
+    errorsByCategory: Record<ErrorCategory, number>;
+    errorsByHour: Record<string, number>;
+    averageResolutionTime: number;
+    criticalErrors: number;
+    recentErrors: ErrorLog[];
+}
+export interface ErrorAlert {
+    id: string;
+    errorId: string;
+    severity: ErrorSeverity;
+    message: string;
+    timestamp: Date;
+    acknowledged: boolean;
+    acknowledgedAt?: Date;
+    acknowledgedBy?: string;
+}
+export declare class ErrorLoggingService {
+    private errors;
+    private alerts;
+    private maxErrors;
+    private maxAlerts;
+    private alertThresholds;
+    /**
+     * 에러 로깅
+     */
+    logError(error: Error | string, severity?: ErrorSeverity, category?: ErrorCategory, context?: Partial<ErrorLog['context']>, metadata?: Partial<ErrorLog['metadata']>): string;
+    /**
+     * 에러 해결 처리
+     */
+    resolveError(errorId: string, resolvedBy?: string): boolean;
+    /**
+     * 에러 통계 조회
+     */
+    getErrorStats(hours?: number): ErrorStats;
+    /**
+     * 활성 알림 조회
+     */
+    getActiveAlerts(): ErrorAlert[];
+    /**
+     * 알림 확인 처리
+     */
+    acknowledgeAlert(alertId: string, acknowledgedBy?: string): boolean;
+    /**
+     * 에러 검색
+     */
+    searchErrors(filters?: {
+        severity?: ErrorSeverity;
+        category?: ErrorCategory;
+        resolved?: boolean;
+        startDate?: Date;
+        endDate?: Date;
+        limit?: number;
+    }): ErrorLog[];
+    /**
+     * 에러 ID 생성
+     */
+    private generateErrorId;
+    /**
+     * 오래된 에러 정리
+     */
+    private cleanupOldErrors;
+    /**
+     * 알림 임계값 확인
+     */
+    private checkAlertThresholds;
+    /**
+     * 알림 생성
+     */
+    private createAlert;
+    /**
+     * 오래된 알림 정리
+     */
+    private cleanupOldAlerts;
+    /**
+     * 콘솔 로깅
+     */
+    private logToConsole;
+    /**
+     * 서비스 정리
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=error-logging-service.d.ts.map

package/dist/services/error-logging-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-logging-service.d.ts","sourceRoot":"","sources":["../../src/services/error-logging-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,QAAQ,aAAa;CACtB;AAED,oBAAY,aAAa;IACvB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;IAC3B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAChD,gBAAgB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAChD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,QAAQ,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,eAAe,CAKpB;IAEH;;OAEG;IACH,QAAQ,CACN,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,QAAQ,GAAE,aAAoC,EAC9C,QAAQ,GAAE,aAAqC,EAC/C,OAAO,GAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAM,EAC1C,QAAQ,GAAE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAM,GAC3C,MAAM;IAsCT;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAiB,GAAG,OAAO;IAarE;;OAEG;IACH,aAAa,CAAC,KAAK,GAAE,MAAW,GAAG,UAAU;IAwD7C;;OAEG;IACH,eAAe,IAAI,UAAU,EAAE;IAM/B;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,GAAE,MAAiB,GAAG,OAAO;IAa7E;;OAEG;IACH,YAAY,CAAC,OAAO,GAAE;QACpB,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,OAAO,CAAC,EAAE,IAAI,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,QAAQ,EAAE;IAgCnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}