memento-mcp-server 0.1.0

package/backup/legacy-removal-20250930-201816/rollback-to-legacy.ps1

@@ -0,0 +1,46 @@
+# 롤백 스크립트: HTTP 서버 v2에서 Legacy 버전으로 롤백
+Write-Host "🔄 HTTP 서버 Legacy 버전으로 롤백 중..." -ForegroundColor Yellow
+
+# 1. 현재 http-server.ts를 http-server-v2-backup.ts로 백업
+if (Test-Path "src/server/http-server.ts") {
+    Write-Host "📦 현재 v2 버전을 백업 중..." -ForegroundColor Blue
+    Copy-Item "src/server/http-server.ts" "src/server/http-server-v2-backup.ts"
+    Write-Host "✅ v2 백업 완료: src/server/http-server-v2-backup.ts" -ForegroundColor Green
+}
+
+# 2. Legacy 버전을 메인으로 복원
+if (Test-Path "src/server/http-server-legacy.ts") {
+    Write-Host "🔄 Legacy 버전을 메인으로 복원 중..." -ForegroundColor Blue
+    Copy-Item "src/server/http-server-legacy.ts" "src/server/http-server.ts"
+    Write-Host "✅ Legacy 복원 완료" -ForegroundColor Green
+} else {
+    Write-Host "❌ Legacy 버전을 찾을 수 없습니다: src/server/http-server-legacy.ts" -ForegroundColor Red
+    exit 1
+}
+
+# 3. 빌드
+Write-Host "🔨 애플리케이션 빌드 중..." -ForegroundColor Blue
+npm run build
+
+if ($LASTEXITCODE -eq 0) {
+    Write-Host "✅ 빌드 성공" -ForegroundColor Green
+} else {
+    Write-Host "❌ 빌드 실패" -ForegroundColor Red
+    exit 1
+}
+
+# 4. Docker 컨테이너 재시작
+Write-Host "🐳 Docker 컨테이너 재시작 중..." -ForegroundColor Blue
+docker-compose down
+docker-compose up -d
+
+if ($LASTEXITCODE -eq 0) {
+    Write-Host "✅ Docker 컨테이너 재시작 완료" -ForegroundColor Green
+    Write-Host "🌐 서버 주소: http://localhost:9001" -ForegroundColor Cyan
+    Write-Host "❤️  헬스 체크: http://localhost:9001/health" -ForegroundColor Cyan
+} else {
+    Write-Host "❌ Docker 컨테이너 재시작 실패" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "🎉 롤백 완료! Legacy 버전이 실행 중입니다." -ForegroundColor Green

package/backup/legacy-removal-20250930-201816/rollback-to-legacy.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+
+# 롤백 스크립트: HTTP 서버 v2에서 Legacy 버전으로 롤백
+echo "🔄 HTTP 서버 Legacy 버전으로 롤백 중..."
+
+# 1. 현재 http-server.ts를 http-server-v2-backup.ts로 백업
+if [ -f "src/server/http-server.ts" ]; then
+    echo "📦 현재 v2 버전을 백업 중..."
+    cp src/server/http-server.ts src/server/http-server-v2-backup.ts
+    echo "✅ v2 백업 완료: src/server/http-server-v2-backup.ts"
+fi
+
+# 2. Legacy 버전을 메인으로 복원
+if [ -f "src/server/http-server-legacy.ts" ]; then
+    echo "🔄 Legacy 버전을 메인으로 복원 중..."
+    cp src/server/http-server-legacy.ts src/server/http-server.ts
+    echo "✅ Legacy 복원 완료"
+else
+    echo "❌ Legacy 버전을 찾을 수 없습니다: src/server/http-server-legacy.ts"
+    exit 1
+fi
+
+# 3. 빌드
+echo "🔨 애플리케이션 빌드 중..."
+npm run build
+
+if [ $? -eq 0 ]; then
+    echo "✅ 빌드 성공"
+else
+    echo "❌ 빌드 실패"
+    exit 1
+fi
+
+# 4. Docker 컨테이너 재시작
+echo "🐳 Docker 컨테이너 재시작 중..."
+docker-compose down
+docker-compose up -d
+
+if [ $? -eq 0 ]; then
+    echo "✅ Docker 컨테이너 재시작 완료"
+    echo "🌐 서버 주소: http://localhost:9001"
+    echo "❤️  헬스 체크: http://localhost:9001/health"
+else
+    echo "❌ Docker 컨테이너 재시작 실패"
+    exit 1
+fi
+
+echo "🎉 롤백 완료! Legacy 버전이 실행 중입니다."

package/dist/algorithms/forgetting-algorithm.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 망각 알고리즘 구현
+ * Memento-Goals.md의 망각 공식 구현
+ */
+export interface ForgettingFeatures {
+    recency: number;
+    usage: number;
+    duplication_ratio: number;
+    importance: number;
+    pinned: boolean;
+}
+export interface ForgettingWeights {
+    recency: number;
+    usage: number;
+    duplication: number;
+    importance: number;
+    pinned: number;
+}
+export interface ForgettingResult {
+    memory_id: string;
+    forget_score: number;
+    should_forget: boolean;
+    reason: string;
+    features: ForgettingFeatures;
+}
+export declare class ForgettingAlgorithm {
+    private readonly weights;
+    constructor(weights?: Partial<ForgettingWeights>);
+    /**
+     * 망각 점수 계산
+     * F = U1 * (1 - recency) + U2 * (1 - usage) + U3 * dupRatio - U4 * importance - U5 * pinned
+     */
+    calculateForgetScore(features: ForgettingFeatures): number;
+    /**
+     * 망각 후보 선정
+     */
+    shouldForget(forgetScore: number, threshold?: number): boolean;
+    /**
+     * 망각 이유 생성
+     */
+    generateForgetReason(features: ForgettingFeatures, forgetScore: number): string;
+    /**
+     * 메모리 특징 계산
+     */
+    calculateFeatures(memory: {
+        created_at: string;
+        last_accessed?: string;
+        importance: number;
+        pinned: boolean;
+        type: string;
+        view_count?: number;
+        cite_count?: number;
+        edit_count?: number;
+    }, duplicates?: number, totalMemories?: number): ForgettingFeatures;
+    /**
+     * 최근성 계산 (반감기 기반)
+     */
+    private calculateRecency;
+    /**
+     * 사용성 계산
+     */
+    private calculateUsage;
+    /**
+     * 접근 점수 계산
+     */
+    private calculateAccessScore;
+    /**
+     * 나이 계산 (일 단위)
+     */
+    private getAgeInDays;
+    /**
+     * 타입별 반감기 (일 단위)
+     */
+    private getHalfLife;
+    /**
+     * 망각 후보들 분석
+     */
+    analyzeForgetCandidates(memories: Array<{
+        id: string;
+        created_at: string;
+        last_accessed?: string;
+        importance: number;
+        pinned: boolean;
+        type: string;
+        view_count?: number;
+        cite_count?: number;
+        edit_count?: number;
+    }>): ForgettingResult[];
+}
+//# sourceMappingURL=forgetting-algorithm.d.ts.map

package/dist/algorithms/forgetting-algorithm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgetting-algorithm.d.ts","sourceRoot":"","sources":["../../src/algorithms/forgetting-algorithm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAWhD;;;OAGG;IACH,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM;IAY1D;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,OAAO;IAInE;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IA0B/E;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,EAAE,UAAU,GAAE,MAAU,EAAE,aAAa,GAAE,MAAU,GAAG,kBAAkB;IA2BzE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,uBAAuB,CAAC,QAAQ,EAAE,KAAK,CAAC;QACtC,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GAAG,gBAAgB,EAAE;CA8BxB"}

package/dist/algorithms/forgetting-algorithm.js

@@ -0,0 +1,160 @@
+/**
+ * 망각 알고리즘 구현
+ * Memento-Goals.md의 망각 공식 구현
+ */
+export class ForgettingAlgorithm {
+    weights;
+    constructor(weights) {
+        this.weights = {
+            recency: 0.35, // U1: 최근성 가중치
+            usage: 0.25, // U2: 사용성 가중치
+            duplication: 0.20, // U3: 중복 가중치
+            importance: 0.15, // U4: 중요도 가중치
+            pinned: 0.30, // U5: 고정 가중치
+            ...weights
+        };
+    }
+    /**
+     * 망각 점수 계산
+     * F = U1 * (1 - recency) + U2 * (1 - usage) + U3 * dupRatio - U4 * importance - U5 * pinned
+     */
+    calculateForgetScore(features) {
+        const { recency, usage, duplication_ratio, importance, pinned } = features;
+        const recencyScore = this.weights.recency * (1 - recency);
+        const usageScore = this.weights.usage * (1 - usage);
+        const duplicationScore = this.weights.duplication * duplication_ratio;
+        const importanceScore = this.weights.importance * importance;
+        const pinnedScore = this.weights.pinned * (pinned ? 1 : 0);
+        return recencyScore + usageScore + duplicationScore - importanceScore - pinnedScore;
+    }
+    /**
+     * 망각 후보 선정
+     */
+    shouldForget(forgetScore, threshold = 0.6) {
+        return forgetScore >= threshold;
+    }
+    /**
+     * 망각 이유 생성
+     */
+    generateForgetReason(features, forgetScore) {
+        const reasons = [];
+        if (features.recency < 0.3) {
+            reasons.push('오래된 기억');
+        }
+        if (features.usage < 0.2) {
+            reasons.push('사용되지 않음');
+        }
+        if (features.duplication_ratio > 0.7) {
+            reasons.push('중복도 높음');
+        }
+        if (features.importance < 0.3) {
+            reasons.push('중요도 낮음');
+        }
+        if (!features.pinned) {
+            reasons.push('고정되지 않음');
+        }
+        if (reasons.length === 0) {
+            return `망각 점수 높음 (${forgetScore.toFixed(3)})`;
+        }
+        return reasons.join(', ');
+    }
+    /**
+     * 메모리 특징 계산
+     */
+    calculateFeatures(memory, duplicates = 0, totalMemories = 1) {
+        // 최근성 계산 (반감기 기반)
+        const recency = this.calculateRecency(new Date(memory.created_at), memory.type);
+        // 사용성 계산
+        const usage = this.calculateUsage(memory.last_accessed ? new Date(memory.last_accessed) : undefined, memory.view_count || 0, memory.cite_count || 0, memory.edit_count || 0);
+        // 중복 비율 계산
+        const duplication_ratio = totalMemories > 0 ? duplicates / totalMemories : 0;
+        // 중요도 (사용자 설정값)
+        const importance = memory.importance;
+        return {
+            recency,
+            usage,
+            duplication_ratio,
+            importance,
+            pinned: memory.pinned
+        };
+    }
+    /**
+     * 최근성 계산 (반감기 기반)
+     */
+    calculateRecency(createdAt, type) {
+        const ageDays = this.getAgeInDays(createdAt);
+        const halfLife = this.getHalfLife(type);
+        return Math.exp(-Math.log(2) * ageDays / halfLife);
+    }
+    /**
+     * 사용성 계산
+     */
+    calculateUsage(lastAccessed, viewCount = 0, citeCount = 0, editCount = 0) {
+        // 접근 빈도 기반 점수
+        const accessScore = lastAccessed ? this.calculateAccessScore(lastAccessed) : 0;
+        // 사용 빈도 기반 점수
+        const usageScore = Math.log(1 + viewCount) +
+            2 * Math.log(1 + citeCount) +
+            0.5 * Math.log(1 + editCount);
+        // 정규화 (0-1 범위)
+        const normalizedUsage = Math.min(1, usageScore / 10); // 10은 경험적 최대값
+        return Math.max(accessScore, normalizedUsage);
+    }
+    /**
+     * 접근 점수 계산
+     */
+    calculateAccessScore(lastAccessed) {
+        const daysSinceAccess = this.getAgeInDays(lastAccessed);
+        // 30일 반감기
+        return Math.exp(-daysSinceAccess / 30);
+    }
+    /**
+     * 나이 계산 (일 단위)
+     */
+    getAgeInDays(date) {
+        const now = new Date();
+        const diffTime = now.getTime() - date.getTime();
+        return diffTime / (1000 * 60 * 60 * 24);
+    }
+    /**
+     * 타입별 반감기 (일 단위)
+     */
+    getHalfLife(type) {
+        switch (type) {
+            case 'working': return 2; // 2일
+            case 'episodic': return 30; // 30일
+            case 'semantic': return 180; // 180일
+            case 'procedural': return 90; // 90일
+            default: return 30;
+        }
+    }
+    /**
+     * 망각 후보들 분석
+     */
+    analyzeForgetCandidates(memories) {
+        const results = [];
+        const totalMemories = memories.length;
+        // 중복 계산을 위한 간단한 구현
+        const contentMap = new Map();
+        memories.forEach(memory => {
+            const key = memory.type; // 실제로는 내용 유사도로 계산해야 함
+            contentMap.set(key, (contentMap.get(key) || 0) + 1);
+        });
+        for (const memory of memories) {
+            const duplicates = (contentMap.get(memory.type) || 1) - 1;
+            const features = this.calculateFeatures(memory, duplicates, totalMemories);
+            const forgetScore = this.calculateForgetScore(features);
+            const shouldForget = this.shouldForget(forgetScore);
+            const reason = this.generateForgetReason(features, forgetScore);
+            results.push({
+                memory_id: memory.id,
+                forget_score: forgetScore,
+                should_forget: shouldForget,
+                reason,
+                features
+            });
+        }
+        return results.sort((a, b) => b.forget_score - a.forget_score);
+    }
+}
+//# sourceMappingURL=forgetting-algorithm.js.map

package/dist/algorithms/forgetting-algorithm.js.map

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

package/dist/algorithms/hybrid-search-engine.d.ts

@@ -0,0 +1,108 @@
+/**
+ * 하이브리드 검색 엔진
+ * FTS5 텍스트 검색 + 벡터 검색 결합
+ */
+import type { MemorySearchFilters } from '../types/index.js';
+export interface HybridSearchQuery {
+    query: string;
+    filters?: MemorySearchFilters | undefined;
+    limit?: number | undefined;
+    vectorWeight?: number | undefined;
+    textWeight?: number | undefined;
+}
+export interface HybridSearchResult {
+    id: string;
+    content: string;
+    type: string;
+    importance: number;
+    created_at: string;
+    last_accessed?: string | undefined;
+    pinned: boolean;
+    tags?: string[] | undefined;
+    textScore: number;
+    vectorScore: number;
+    finalScore: number;
+    recall_reason: string;
+}
+export declare class HybridSearchEngine {
+    private textSearchEngine;
+    private embeddingService;
+    private vectorSearchEngine;
+    private readonly defaultVectorWeight;
+    private readonly defaultTextWeight;
+    private searchStats;
+    private adaptiveWeights;
+    constructor();
+    /**
+     * 하이브리드 검색 실행 - 적응형 가중치 적용
+     */
+    search(db: any, query: HybridSearchQuery): Promise<{
+        items: HybridSearchResult[];
+        total_count: number;
+        query_time: number;
+    }>;
+    /**
+     * 검색 시작 로깅
+     */
+    private logSearchStart;
+    /**
+     * 검색 완료 로깅
+     */
+    private logSearchComplete;
+    /**
+     * 검색 에러 로깅
+     */
+    private logSearchError;
+    /**
+     * 검색 단계 로깅
+     */
+    private logSearchStep;
+    /**
+     * 텍스트 검색과 벡터 검색 결과 결합
+     */
+    private combineResults;
+    /**
+     * 하이브리드 검색 이유 생성
+     */
+    private generateHybridReason;
+    /**
+     * 적응형 가중치 계산
+     */
+    private calculateAdaptiveWeights;
+    /**
+     * 쿼리 특성 분석
+     */
+    private analyzeQuery;
+    /**
+     * 쿼리 정규화
+     */
+    private normalizeQuery;
+    /**
+     * 검색 통계 업데이트
+     */
+    private updateSearchStats;
+    /**
+     * 검색 통계 정보
+     */
+    getSearchStats(db: any): Promise<{
+        textSearchAvailable: boolean;
+        vectorSearchAvailable: boolean;
+        embeddingStats: any;
+        searchStats: Map<string, {
+            textHits: number;
+            vectorHits: number;
+            totalSearches: number;
+        }>;
+        adaptiveWeights: Map<string, {
+            vectorWeight: number;
+            textWeight: number;
+        }>;
+    }>;
+    /**
+     * 임베딩 서비스 사용 가능 여부 확인
+     */
+    isEmbeddingAvailable(): boolean;
+}
+export declare function getHybridSearchEngine(): HybridSearchEngine;
+export declare function createHybridSearchEngine(): HybridSearchEngine;
+//# sourceMappingURL=hybrid-search-engine.d.ts.map

package/dist/algorithms/hybrid-search-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-search-engine.d.ts","sourceRoot":"","sources":["../../src/algorithms/hybrid-search-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,kBAAkB,CAA2C;IACrE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAO;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IACzC,OAAO,CAAC,WAAW,CAA2F;IAC9G,OAAO,CAAC,eAAe,CAAwE;;IAQ/F;;OAEG;IACG,MAAM,CACV,EAAE,EAAE,GAAG,EACP,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC;QAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA+LpF;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwChC;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC;QACrC,mBAAmB,EAAE,OAAO,CAAC;QAC7B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,cAAc,EAAE,GAAG,CAAC;QACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1F,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5E,CAAC;IAYF;;OAEG;IACH,oBAAoB,IAAI,OAAO;CAGhC;AAKD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}