memento-mcp-server 0.1.0

package/dist/npm-client/context-injector.js

@@ -0,0 +1,296 @@
+/**
+ * ContextInjector - AI Agent의 컨텍스트에 관련 기억을 주입하는 클래스
+ * 대화나 작업 중에 관련된 기억을 자동으로 찾아 컨텍스트에 주입합니다.
+ *
+ * @example
+ * ```typescript
+ * import { ContextInjector } from '@memento/client';
+ *
+ * const injector = new ContextInjector(client);
+ *
+ * // 컨텍스트 주입
+ * const context = await injector.inject({
+ *   query: 'React Hook에 대해 질문',
+ *   tokenBudget: 1000
+ * });
+ *
+ * console.log(context.content);
+ * ```
+ */
+import { MementoClient } from './memento-client.js';
+export class ContextInjector {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 컨텍스트 주입
+     */
+    async inject(query, options = {}) {
+        const startTime = Date.now();
+        const { maxResults = 10, tokenBudget = 1200, contextType = 'general', memoryTypes, recentDays, importanceThreshold = 0.3, pinnedOnly = false } = options;
+        // 1. 관련 기억 검색
+        const searchResult = await this.searchRelevantMemories(query, {
+            maxResults,
+            memoryTypes: memoryTypes || undefined,
+            recentDays: recentDays || undefined,
+            importanceThreshold,
+            pinnedOnly
+        });
+        // 2. 토큰 예산에 맞게 기억 압축
+        const compressedMemories = await this.compressMemories(searchResult.items, tokenBudget);
+        // 3. 컨텍스트 생성
+        const context = this.generateContext(query, compressedMemories, contextType);
+        const searchTime = Date.now() - startTime;
+        return {
+            role: 'system',
+            content: context,
+            metadata: {
+                memories_used: compressedMemories.length,
+                token_count: this.estimateTokenCount(context),
+                search_time: searchTime
+            }
+        };
+    }
+    /**
+     * 관련 기억 검색
+     */
+    async searchRelevantMemories(query, options) {
+        const filters = {};
+        // 메모리 타입 필터
+        if (options.memoryTypes && options.memoryTypes.length > 0) {
+            filters.type = options.memoryTypes;
+        }
+        // 최근 기간 필터
+        if (options.recentDays) {
+            const timeFrom = new Date();
+            timeFrom.setDate(timeFrom.getDate() - options.recentDays);
+            filters.time_from = timeFrom.toISOString();
+        }
+        // 고정된 기억만
+        if (options.pinnedOnly) {
+            filters.pinned = true;
+        }
+        // 하이브리드 검색 사용 (의미적 유사도 + 키워드 매칭)
+        const hybridResult = await this.client.hybridSearch({
+            query,
+            filters,
+            limit: options.maxResults,
+            vectorWeight: 0.7, // 의미적 유사도에 더 가중치
+            textWeight: 0.3
+        });
+        // HybridSearchResult를 SearchResult로 변환
+        return {
+            items: hybridResult.items.map(item => ({
+                ...item,
+                score: item.finalScore
+            })),
+            total_count: hybridResult.total_count,
+            query_time: hybridResult.query_time
+        };
+    }
+    /**
+     * 기억 압축 (토큰 예산에 맞게)
+     */
+    async compressMemories(memories, tokenBudget) {
+        if (memories.length === 0)
+            return [];
+        // 중요도와 점수 기준으로 정렬
+        const sortedMemories = memories.sort((a, b) => {
+            const scoreA = a.score || 0;
+            const scoreB = b.score || 0;
+            return (scoreB + a.importance) - (scoreA + b.importance);
+        });
+        const compressed = [];
+        let currentTokens = 0;
+        for (const memory of sortedMemories) {
+            const memoryTokens = this.estimateTokenCount(memory.content);
+            if (currentTokens + memoryTokens <= tokenBudget) {
+                compressed.push(memory);
+                currentTokens += memoryTokens;
+            }
+            else {
+                // 토큰 예산이 부족하면 더 짧은 요약으로 시도
+                const summary = this.summarizeMemory(memory);
+                const summaryTokens = this.estimateTokenCount(summary);
+                if (currentTokens + summaryTokens <= tokenBudget) {
+                    compressed.push({
+                        ...memory,
+                        content: summary
+                    });
+                    currentTokens += summaryTokens;
+                }
+            }
+        }
+        return compressed;
+    }
+    /**
+     * 기억 요약
+     */
+    summarizeMemory(memory) {
+        const content = memory.content;
+        const maxLength = 200; // 최대 200자로 제한
+        if (content.length <= maxLength) {
+            return content;
+        }
+        // 문장 단위로 자르기
+        const sentences = content.split(/[.!?]+/);
+        let summary = '';
+        for (const sentence of sentences) {
+            if (summary.length + sentence.length <= maxLength) {
+                summary += sentence + '.';
+            }
+            else {
+                break;
+            }
+        }
+        return summary || content.substring(0, maxLength) + '...';
+    }
+    /**
+     * 컨텍스트 생성
+     */
+    generateContext(query, memories, contextType) {
+        if (memories.length === 0) {
+            return this.generateEmptyContext(query, contextType);
+        }
+        const contextHeader = this.getContextHeader(contextType);
+        const memorySections = this.formatMemories(memories);
+        const contextFooter = this.getContextFooter(query, memories.length);
+        return `${contextHeader}\n\n${memorySections}\n\n${contextFooter}`;
+    }
+    /**
+     * 컨텍스트 헤더 생성
+     */
+    getContextHeader(contextType) {
+        const headers = {
+            conversation: '💬 관련 대화 기록:',
+            task: '📋 관련 작업 기록:',
+            general: '🧠 관련 기억:'
+        };
+        return headers[contextType] || headers.general;
+    }
+    /**
+     * 기억 포맷팅
+     */
+    formatMemories(memories) {
+        return memories.map((memory, index) => {
+            const typeEmoji = this.getTypeEmoji(memory.type);
+            const importanceBar = this.getImportanceBar(memory.importance);
+            const tags = memory.tags && memory.tags.length > 0
+                ? ` [${memory.tags.join(', ')}]`
+                : '';
+            const score = memory.score ? ` (관련도: ${(memory.score * 100).toFixed(1)}%)` : '';
+            return `${index + 1}. ${typeEmoji} ${memory.content}${tags}${score}\n   ${importanceBar} ${memory.created_at}`;
+        }).join('\n\n');
+    }
+    /**
+     * 타입별 이모지
+     */
+    getTypeEmoji(type) {
+        const emojis = {
+            working: '⚡',
+            episodic: '📅',
+            semantic: '🧠',
+            procedural: '🔧'
+        };
+        return emojis[type] || '📝';
+    }
+    /**
+     * 중요도 바 생성
+     */
+    getImportanceBar(importance) {
+        const filled = Math.round(importance * 5);
+        const empty = 5 - filled;
+        return '★'.repeat(filled) + '☆'.repeat(empty);
+    }
+    /**
+     * 컨텍스트 푸터 생성
+     */
+    getContextFooter(query, memoryCount) {
+        return `\n💡 위의 ${memoryCount}개 기억을 참고하여 "${query}"에 대해 답변해주세요.`;
+    }
+    /**
+     * 빈 컨텍스트 생성
+     */
+    generateEmptyContext(query, contextType) {
+        const messages = {
+            conversation: '💬 관련 대화 기록이 없습니다.',
+            task: '📋 관련 작업 기록이 없습니다.',
+            general: '🧠 관련 기억이 없습니다.'
+        };
+        return `${messages[contextType] || messages.general}\n\n💡 "${query}"에 대해 새로운 정보로 답변해주세요.`;
+    }
+    /**
+     * 토큰 수 추정 (간단한 추정)
+     */
+    estimateTokenCount(text) {
+        // 대략적인 토큰 수 추정 (한국어: 1글자 = 1토큰, 영어: 1단어 = 1.3토큰)
+        const koreanChars = (text.match(/[가-힣]/g) || []).length;
+        const englishWords = (text.match(/[a-zA-Z]+/g) || []).length;
+        const otherChars = text.length - koreanChars - (text.match(/[a-zA-Z]/g) || []).length;
+        return koreanChars + Math.ceil(englishWords * 1.3) + otherChars;
+    }
+    // ============================================================================
+    // 고급 컨텍스트 주입 기능
+    // ============================================================================
+    /**
+     * 대화 컨텍스트 주입
+     */
+    async injectConversationContext(query, tokenBudget = 1000) {
+        return await this.inject(query, {
+            tokenBudget,
+            contextType: 'conversation',
+            memoryTypes: ['episodic', 'semantic'],
+            recentDays: 30,
+            importanceThreshold: 0.4
+        });
+    }
+    /**
+     * 작업 컨텍스트 주입
+     */
+    async injectTaskContext(query, projectId, tokenBudget = 1200) {
+        const filters = {};
+        if (projectId) {
+            filters.project_id = projectId;
+        }
+        return await this.inject(query, {
+            tokenBudget,
+            contextType: 'task',
+            memoryTypes: ['procedural', 'semantic'],
+            importanceThreshold: 0.5,
+            pinnedOnly: false
+        });
+    }
+    /**
+     * 학습 컨텍스트 주입
+     */
+    async injectLearningContext(topic, tokenBudget = 1500) {
+        return await this.inject(topic, {
+            tokenBudget,
+            contextType: 'general',
+            memoryTypes: ['semantic', 'procedural'],
+            importanceThreshold: 0.6,
+            pinnedOnly: false
+        });
+    }
+    /**
+     * 프로젝트 컨텍스트 주입
+     */
+    async injectProjectContext(projectId, query, tokenBudget = 1000) {
+        const searchResult = await this.client.recall(query, {
+            project_id: projectId
+        }, 10);
+        const compressedMemories = await this.compressMemories(searchResult.items, tokenBudget);
+        const context = this.generateContext(query, compressedMemories, 'task');
+        return {
+            role: 'system',
+            content: context,
+            metadata: {
+                memories_used: compressedMemories.length,
+                token_count: this.estimateTokenCount(context),
+                search_time: searchResult.query_time
+            }
+        };
+    }
+}
+//# sourceMappingURL=context-injector.js.map

package/dist/npm-client/context-injector.js.map

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

package/dist/npm-client/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @memento/client - Memento MCP Server 클라이언트 라이브러리
+ *
+ * AI Agent의 기억을 관리하고 컨텍스트를 주입하는 TypeScript 라이브러리입니다.
+ *
+ * @example
+ * ```typescript
+ * import { MementoClient, MemoryManager, ContextInjector } from '@memento/client';
+ *
+ * // 클라이언트 생성 및 연결
+ * const client = new MementoClient({
+ *   serverUrl: 'http://localhost:8080',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * await client.connect();
+ *
+ * // 기억 관리
+ * const manager = new MemoryManager(client);
+ * const memory = await manager.create({
+ *   content: 'React Hook에 대해 학습했다',
+ *   type: 'episodic',
+ *   importance: 0.8
+ * });
+ *
+ * // 컨텍스트 주입
+ * const injector = new ContextInjector(client);
+ * const context = await injector.inject('React Hook 질문', {
+ *   tokenBudget: 1000
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { MementoClient } from './memento-client.js';
+export { MemoryManager } from './memory-manager.js';
+export { ContextInjector } from './context-injector.js';
+export { MementoError, ConnectionError, AuthenticationError, ValidationError, NotFoundError } from './types.js';
+export type { MementoClientOptions, MemoryItem, CreateMemoryParams, UpdateMemoryParams, MemoryType, PrivacyScope, SearchFilters, SearchResult, MemorySearchResult, HybridSearchParams, HybridSearchResult, HybridSearchItem, RememberResult, PinResult, ForgetResult, LinkResult, ExportResult, FeedbackResult, ContextInjectionParams, ContextInjectionResult, MementoClientEvents, PaginationParams, PaginatedResult, HealthCheck } from './types.js';
+export type { ContextInjectionOptions } from './context-injector.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/npm-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/npm-client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EAEV,oBAAoB,EAGpB,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,YAAY,EAGZ,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAGhB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,cAAc,EAGd,sBAAsB,EACtB,sBAAsB,EAItB,mBAAmB,EAGnB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACZ,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE,cAAc,YAAY,CAAC"}

package/dist/npm-client/index.js

@@ -0,0 +1,43 @@
+/**
+ * @memento/client - Memento MCP Server 클라이언트 라이브러리
+ *
+ * AI Agent의 기억을 관리하고 컨텍스트를 주입하는 TypeScript 라이브러리입니다.
+ *
+ * @example
+ * ```typescript
+ * import { MementoClient, MemoryManager, ContextInjector } from '@memento/client';
+ *
+ * // 클라이언트 생성 및 연결
+ * const client = new MementoClient({
+ *   serverUrl: 'http://localhost:8080',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * await client.connect();
+ *
+ * // 기억 관리
+ * const manager = new MemoryManager(client);
+ * const memory = await manager.create({
+ *   content: 'React Hook에 대해 학습했다',
+ *   type: 'episodic',
+ *   importance: 0.8
+ * });
+ *
+ * // 컨텍스트 주입
+ * const injector = new ContextInjector(client);
+ * const context = await injector.inject('React Hook 질문', {
+ *   tokenBudget: 1000
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// 메인 클래스들
+export { MementoClient } from './memento-client.js';
+export { MemoryManager } from './memory-manager.js';
+export { ContextInjector } from './context-injector.js';
+// 에러 클래스들
+export { MementoError, ConnectionError, AuthenticationError, ValidationError, NotFoundError } from './types.js';
+// 편의 함수들
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/npm-client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/npm-client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,UAAU;AACV,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AA+CpB,SAAS;AACT,cAAc,YAAY,CAAC"}

package/dist/npm-client/memento-client.d.ts

@@ -0,0 +1,114 @@
+/**
+ * MementoClient - Memento MCP Server와 통신하는 메인 클라이언트
+ *
+ * @example
+ * ```typescript
+ * import { MementoClient } from '@memento/client';
+ *
+ * const client = new MementoClient({
+ *   serverUrl: 'http://localhost:8080',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * await client.connect();
+ *
+ * const memory = await client.remember({
+ *   content: 'React Hook에 대해 학습했다',
+ *   type: 'episodic',
+ *   importance: 0.8
+ * });
+ * ```
+ */
+import { EventEmitter } from 'events';
+import type { MementoClientOptions, MemoryItem, CreateMemoryParams, UpdateMemoryParams, SearchFilters, SearchResult, HybridSearchParams, HybridSearchResult, RememberResult, PinResult, ForgetResult, LinkResult, ExportResult, FeedbackResult, ContextInjectionParams, ContextInjectionResult, HealthCheck } from './types.js';
+export declare class MementoClient extends EventEmitter {
+    private httpClient;
+    private isConnected;
+    private options;
+    constructor(options?: MementoClientOptions);
+    /**
+     * HTTP 클라이언트 생성
+     */
+    private createHttpClient;
+    /**
+     * HTTP 에러를 MementoError로 변환
+     */
+    private handleHttpError;
+    /**
+     * 서버에 연결
+     */
+    connect(): Promise<void>;
+    /**
+     * 연결 해제
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 연결 상태 확인
+     */
+    get connected(): boolean;
+    /**
+     * 서버 상태 확인
+     */
+    healthCheck(): Promise<HealthCheck>;
+    /**
+     * 기억 저장
+     */
+    remember(params: CreateMemoryParams): Promise<RememberResult>;
+    /**
+     * 기억 검색
+     */
+    recall(query: string, filters?: SearchFilters, limit?: number): Promise<SearchResult>;
+    /**
+     * 하이브리드 검색
+     */
+    hybridSearch(params: HybridSearchParams): Promise<HybridSearchResult>;
+    /**
+     * 기억 조회
+     */
+    getMemory(id: string): Promise<MemoryItem>;
+    /**
+     * 기억 업데이트
+     */
+    updateMemory(id: string, params: UpdateMemoryParams): Promise<MemoryItem>;
+    /**
+     * 기억 삭제
+     */
+    forget(memoryId: string, hard?: boolean): Promise<ForgetResult>;
+    /**
+     * 기억 고정
+     */
+    pin(memoryId: string): Promise<PinResult>;
+    /**
+     * 기억 고정 해제
+     */
+    unpin(memoryId: string): Promise<PinResult>;
+    /**
+     * 기억 간 관계 생성
+     */
+    link(sourceId: string, targetId: string, relationType: 'cause_of' | 'derived_from' | 'duplicates' | 'contradicts'): Promise<LinkResult>;
+    /**
+     * 기억 내보내기
+     */
+    export(format: 'json' | 'csv' | 'markdown', filters?: SearchFilters): Promise<ExportResult>;
+    /**
+     * 피드백 제공
+     */
+    feedback(memoryId: string, helpful: boolean, comment?: string, score?: number): Promise<FeedbackResult>;
+    /**
+     * 컨텍스트 주입
+     */
+    injectContext(params: ContextInjectionParams): Promise<ContextInjectionResult>;
+    /**
+     * 연결 상태 확인
+     */
+    private ensureConnected;
+    /**
+     * 클라이언트 설정 업데이트
+     */
+    updateOptions(newOptions: Partial<MementoClientOptions>): void;
+    /**
+     * 현재 설정 조회
+     */
+    getOptions(): Readonly<MementoClientOptions>;
+}
+//# sourceMappingURL=memento-client.d.ts.map

package/dist/npm-client/memento-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memento-client.d.ts","sourceRoot":"","sources":["../../src/npm-client/memento-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACZ,MAAM,YAAY,CAAC;AASpB,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,OAAO,CAAiC;gBAEpC,OAAO,GAAE,oBAAyB;IAe9C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsDxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IASzC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAUnE;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC;IA0BxB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoB3E;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA6BhD;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0C/E;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAa5E;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAY/C;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAgBjD;;OAEG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,GACvE,OAAO,CAAC,UAAU,CAAC;IAYtB;;OAEG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,EACnC,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAWxB;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC;IAa1B;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAWpF;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAK9D;;OAEG;IACH,UAAU,IAAI,QAAQ,CAAC,oBAAoB,CAAC;CAG7C"}