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

package/dist/domains/anchor/tools/set-anchor-tool.js

@@ -0,0 +1,70 @@
+/**
+ * Set Anchor Tool - 앵커 설정 도구
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+const SetAnchorSchema = z.object({
+    memory_id: z.string().min(1, 'Memory ID cannot be empty'),
+    slot: z.enum(['A', 'B', 'C'], {
+        errorMap: () => ({ message: 'Slot must be A, B, or C' })
+    }),
+    agent_id: z.string().optional().default('default')
+});
+export class SetAnchorTool extends BaseTool {
+    constructor() {
+        super('set_anchor', '특정 메모리를 앵커로 설정합니다', {
+            type: 'object',
+            properties: {
+                memory_id: {
+                    type: 'string',
+                    description: '앵커로 설정할 메모리 ID'
+                },
+                slot: {
+                    type: 'string',
+                    enum: ['A', 'B', 'C'],
+                    description: '앵커 슬롯 (A: 즉시 컨텍스트, B: 보조 컨텍스트, C: 확장 컨텍스트)'
+                },
+                agent_id: {
+                    type: 'string',
+                    description: '에이전트 ID (기본값: "default")',
+                    default: 'default'
+                }
+            },
+            required: ['memory_id', 'slot']
+        });
+    }
+    async handle(params, context) {
+        try {
+            // 파라미터 검증
+            const { memory_id, slot, agent_id } = SetAnchorSchema.parse(params);
+            // 데이터베이스 연결 확인
+            this.validateDatabase(context);
+            // AnchorManager 서비스 확인
+            this.validateService(context.services.anchorManager, '앵커 관리자');
+            // 메모리 존재 확인
+            const memory = context.db.prepare(`
+        SELECT id FROM memory_item WHERE id = ?
+      `).get(memory_id);
+            if (!memory) {
+                throw new Error(`메모리를 찾을 수 없습니다: ${memory_id}`);
+            }
+            // 앵커 설정
+            await context.services.anchorManager.setAnchor(agent_id, memory_id, slot);
+            return this.createSuccessResult({
+                success: true,
+                agent_id,
+                slot,
+                memory_id,
+                message: `앵커가 설정되었습니다: ${agent_id}/${slot} -> ${memory_id}`
+            });
+        }
+        catch (error) {
+            this.logError(error, '앵커 설정 실패', { params });
+            if (error instanceof z.ZodError) {
+                throw new Error(`입력 검증 실패: ${error.errors.map(e => e.message).join(', ')}`);
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=set-anchor-tool.js.map

package/dist/domains/anchor/tools/set-anchor-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-anchor-tool.js","sourceRoot":"","sources":["../../../../src/domains/anchor/tools/set-anchor-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAGvD,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IACzD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;QAC5B,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;KACzD,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;CACnD,CAAC,CAAC;AAEH,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC;QACE,KAAK,CACH,YAAY,EACZ,mBAAmB,EACnB;YACE,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gBAAgB;iBAC9B;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;oBACrB,WAAW,EAAE,4CAA4C;iBAC1D;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;oBACvC,OAAO,EAAE,SAAS;iBACnB;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;SAChC,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAW,EAAE,OAAoB;QAC5C,IAAI,CAAC;YACH,UAAU;YACV,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAEpE,eAAe;YACf,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAE/B,uBAAuB;YACvB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YAE/D,YAAY;YACZ,MAAM,MAAM,GAAG,OAAO,CAAC,EAAG,CAAC,OAAO,CAAC;;OAElC,CAAC,CAAC,GAAG,CAAC,SAAS,CAA+B,CAAC;YAEhD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;YAClD,CAAC;YAED,QAAQ;YACR,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAc,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YAE3E,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,OAAO,EAAE,IAAI;gBACb,QAAQ;gBACR,IAAI;gBACJ,SAAS;gBACT,OAAO,EAAE,gBAAgB,QAAQ,IAAI,IAAI,OAAO,SAAS,EAAE;aAC5D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,KAAc,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAEtD,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/domains/embedding/providers/embedding-provider-factory.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 임베딩 제공자 팩토리
+ * 전략 패턴을 사용하여 순환 의존성 방지
+ *
+ * 클린코드 원칙:
+ * - 단일 책임 원칙: 제공자 생성만 담당
+ * - 의존성 역전: 인터페이스에 의존
+ * - 개방-폐쇄: 새로운 제공자 추가 용이
+ */
+import type { EmbeddingServiceInterface, EmbeddingProvider, ProviderInfo } from '../../../shared/types/embedding.types.js';
+import type { ProviderFallbackDecision } from '../../../shared/types/embedding-provider-monitoring.types.js';
+/**
+ * 임베딩 제공자 팩토리
+ * 순환 의존성을 방지하기 위해 팩토리 패턴 사용
+ */
+export declare class EmbeddingProviderFactory {
+    private static instance;
+    private providers;
+    private readonly availabilityService;
+    private constructor();
+    /**
+     * 싱글톤 인스턴스 반환
+     */
+    static getInstance(): EmbeddingProviderFactory;
+    /**
+     * 제공자 초기화
+     * 클린코드: 단일 책임 원칙 - 초기화만 담당
+     */
+    private initializeProviders;
+    /**
+     * 제공자 반환
+     * 클린코드: 단일 책임 원칙 - 제공자 반환만 담당
+     */
+    getProvider(provider: EmbeddingProvider): EmbeddingServiceInterface | null;
+    /**
+     * 사용 가능한 제공자 목록 반환
+     * TDD: 각 제공자의 사용 가능 여부 확인
+     */
+    getAvailableProviders(): ProviderInfo[];
+    /**
+     * 우선순위에 따른 제공자 선택
+     * TDD: 사용 가능한 제공자 중 우선순위가 높은 것 선택
+     */
+    selectProvider(preferredProvider?: EmbeddingProvider): EmbeddingServiceInterface | null;
+    selectProviderWithHealthCheck(preferredProvider?: EmbeddingProvider): Promise<{
+        service: EmbeddingServiceInterface | null;
+        decision: ProviderFallbackDecision;
+    }>;
+    /**
+     * 제공자 등록 (확장성)
+     * 클린코드: 개방-폐쇄 원칙 - 확장에는 열려있음
+     */
+    registerProvider(provider: EmbeddingProvider, service: EmbeddingServiceInterface): void;
+    /**
+     * 제공자 제거
+     */
+    unregisterProvider(provider: EmbeddingProvider): boolean;
+    private resolveAvailability;
+    /**
+     * 모든 제공자 초기화
+     */
+    reset(): void;
+    private normalizeProviderName;
+    private getPriorityProviders;
+    handleProviderFailure(provider: EmbeddingProvider): void;
+    getProviderName(service: EmbeddingServiceInterface | null): EmbeddingProvider | null;
+    private createService;
+}
+//# sourceMappingURL=embedding-provider-factory.d.ts.map

package/dist/domains/embedding/providers/embedding-provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider-factory.d.ts","sourceRoot":"","sources":["../../../../src/domains/embedding/providers/embedding-provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC3H,OAAO,KAAK,EAAE,wBAAwB,EAAwB,MAAM,8DAA8D,CAAC;AAQnI;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,SAAS,CAAgE;IACjF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA2B;IAE/D,OAAO;IAQP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,wBAAwB;IAO9C;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,IAAI;IAQ1E;;;OAGG;IACH,qBAAqB,IAAI,YAAY,EAAE;IAiDvC;;;OAGG;IACH,cAAc,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,IAAI;IAoCjF,6BAA6B,CACjC,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC;QAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,wBAAwB,CAAA;KAAE,CAAC;IAM7F;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI;IAQvF;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IAKxD,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,qBAAqB;IAqB7B,OAAO,CAAC,oBAAoB;IAI5B,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IASxD,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,iBAAiB,GAAG,IAAI;IAYpF,OAAO,CAAC,aAAa;CActB"}

package/dist/domains/embedding/providers/embedding-provider-factory.js

@@ -0,0 +1,233 @@
+/**
+ * 임베딩 제공자 팩토리
+ * 전략 패턴을 사용하여 순환 의존성 방지
+ *
+ * 클린코드 원칙:
+ * - 단일 책임 원칙: 제공자 생성만 담당
+ * - 의존성 역전: 인터페이스에 의존
+ * - 개방-폐쇄: 새로운 제공자 추가 용이
+ */
+import { mementoConfig } from '../../../shared/config/index.js';
+import { MiniLMEmbeddingService } from '../services/minilm-embedding-service.js';
+import { LightweightEmbeddingService } from '../services/lightweight-embedding-service.js';
+import { GeminiEmbeddingService } from '../services/gemini-embedding-service.js';
+import { OpenAIEmbeddingService } from '../services/openai-embedding-service.js';
+import { ModelAvailabilityService } from './model-availability-service.js';
+/**
+ * 임베딩 제공자 팩토리
+ * 순환 의존성을 방지하기 위해 팩토리 패턴 사용
+ */
+export class EmbeddingProviderFactory {
+    static instance;
+    providers = new Map();
+    availabilityService;
+    constructor() {
+        this.initializeProviders();
+        this.availabilityService = new ModelAvailabilityService(provider => this.providers.get(provider) ?? null, () => this.getPriorityProviders());
+    }
+    /**
+     * 싱글톤 인스턴스 반환
+     */
+    static getInstance() {
+        if (!EmbeddingProviderFactory.instance) {
+            EmbeddingProviderFactory.instance = new EmbeddingProviderFactory();
+        }
+        return EmbeddingProviderFactory.instance;
+    }
+    /**
+     * 제공자 초기화
+     * 클린코드: 단일 책임 원칙 - 초기화만 담당
+     */
+    initializeProviders() {
+        this.providers.set('minilm', this.createService('minilm'));
+        this.providers.set('tfidf', this.createService('tfidf'));
+        this.providers.set('gemini', this.createService('gemini'));
+        this.providers.set('openai', this.createService('openai'));
+    }
+    /**
+     * 제공자 반환
+     * 클린코드: 단일 책임 원칙 - 제공자 반환만 담당
+     */
+    getProvider(provider) {
+        const normalized = this.normalizeProviderName(provider);
+        if (!normalized) {
+            return null;
+        }
+        return this.providers.get(normalized) || null;
+    }
+    /**
+     * 사용 가능한 제공자 목록 반환
+     * TDD: 각 제공자의 사용 가능 여부 확인
+     */
+    getAvailableProviders() {
+        const providerInfos = [];
+        // MiniLM
+        const minilm = this.providers.get('minilm');
+        const minilmStatus = this.availabilityService.getLastStatus('minilm');
+        providerInfos.push({
+            name: 'minilm',
+            available: this.resolveAvailability('minilm', minilm, minilmStatus),
+            priority: 3,
+            cost: 'free',
+            performance: 'high'
+        });
+        // TF-IDF (항상 사용 가능)
+        const tfidf = this.providers.get('tfidf');
+        providerInfos.push({
+            name: 'tfidf',
+            available: this.resolveAvailability('tfidf', tfidf, this.availabilityService.getLastStatus('tfidf')),
+            priority: 4,
+            cost: 'free',
+            performance: 'low'
+        });
+        // Gemini
+        const gemini = this.providers.get('gemini');
+        const geminiStatus = this.availabilityService.getLastStatus('gemini');
+        providerInfos.push({
+            name: 'gemini',
+            available: this.resolveAvailability('gemini', gemini, geminiStatus),
+            priority: 2,
+            cost: 'paid',
+            performance: 'high'
+        });
+        // OpenAI
+        const openai = this.providers.get('openai');
+        const openaiStatus = this.availabilityService.getLastStatus('openai');
+        providerInfos.push({
+            name: 'openai',
+            available: this.resolveAvailability('openai', openai, openaiStatus),
+            priority: 1,
+            cost: 'paid',
+            performance: 'high'
+        });
+        return providerInfos.sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * 우선순위에 따른 제공자 선택
+     * TDD: 사용 가능한 제공자 중 우선순위가 높은 것 선택
+     */
+    selectProvider(preferredProvider) {
+        const availableProviders = this.getAvailableProviders();
+        // 1. 명시적으로 요청된 제공자 우선
+        if (preferredProvider) {
+            const normalizedPreferred = this.normalizeProviderName(preferredProvider);
+            const preferred = normalizedPreferred
+                ? availableProviders.find(p => p.name === normalizedPreferred && p.available)
+                : undefined;
+            if (preferred) {
+                console.log(`🎯 요청된 제공자 사용: ${preferred.name}`);
+                return this.getProvider(preferred.name);
+            }
+        }
+        // 2. 설정에서 기본 제공자 사용
+        const defaultProvider = this.normalizeProviderName(mementoConfig.embeddingProvider);
+        const defaultAvailable = defaultProvider
+            ? availableProviders.find(p => p.name === defaultProvider && p.available)
+            : undefined;
+        if (defaultAvailable) {
+            console.log(`⚙️ 설정된 기본 제공자 사용: ${defaultAvailable.name}`);
+            return this.getProvider(defaultAvailable.name);
+        }
+        // 3. 사용 가능한 첫 번째 제공자 반환
+        const firstAvailable = availableProviders.find(p => p.available);
+        if (firstAvailable) {
+            console.log(`🔄 사용 가능한 첫 번째 제공자 사용: ${firstAvailable.name}`);
+            return this.getProvider(firstAvailable.name);
+        }
+        console.log('❌ 사용 가능한 제공자가 없습니다');
+        return null;
+    }
+    async selectProviderWithHealthCheck(preferredProvider) {
+        const decision = await this.availabilityService.selectBestProvider(preferredProvider);
+        const service = this.getProvider(decision.selectedProvider);
+        return { service, decision };
+    }
+    /**
+     * 제공자 등록 (확장성)
+     * 클린코드: 개방-폐쇄 원칙 - 확장에는 열려있음
+     */
+    registerProvider(provider, service) {
+        const normalized = this.normalizeProviderName(provider);
+        if (!normalized) {
+            return;
+        }
+        this.providers.set(normalized, service);
+    }
+    /**
+     * 제공자 제거
+     */
+    unregisterProvider(provider) {
+        const normalized = this.normalizeProviderName(provider);
+        return normalized ? this.providers.delete(normalized) : false;
+    }
+    resolveAvailability(provider, service, status) {
+        if (status) {
+            return status.state === 'available';
+        }
+        return service?.isAvailable() ?? false;
+    }
+    /**
+     * 모든 제공자 초기화
+     */
+    reset() {
+        this.providers.clear();
+        this.initializeProviders();
+    }
+    normalizeProviderName(provider) {
+        if (!provider) {
+            return null;
+        }
+        const normalized = provider.toLowerCase();
+        switch (normalized) {
+            case 'tfidf':
+                return 'tfidf';
+            case 'minilm':
+                return 'minilm';
+            case 'openai':
+                return 'openai';
+            case 'gemini':
+                return 'gemini';
+            case 'lightweight':
+                return 'tfidf';
+            default:
+                return null;
+        }
+    }
+    getPriorityProviders() {
+        return Array.from(this.providers.keys());
+    }
+    handleProviderFailure(provider) {
+        const normalized = this.normalizeProviderName(provider);
+        if (!normalized) {
+            return;
+        }
+        console.warn(`⚠️ ${normalized} 제공자 재초기화 시도`);
+        this.providers.set(normalized, this.createService(normalized));
+    }
+    getProviderName(service) {
+        if (!service) {
+            return null;
+        }
+        for (const [name, instance] of this.providers.entries()) {
+            if (instance === service) {
+                return name;
+            }
+        }
+        return null;
+    }
+    createService(provider) {
+        switch (provider) {
+            case 'minilm':
+                return new MiniLMEmbeddingService();
+            case 'tfidf':
+                return new LightweightEmbeddingService();
+            case 'gemini':
+                return new GeminiEmbeddingService();
+            case 'openai':
+                return new OpenAIEmbeddingService();
+            default:
+                return new LightweightEmbeddingService();
+        }
+    }
+}
+//# sourceMappingURL=embedding-provider-factory.js.map

package/dist/domains/embedding/providers/embedding-provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider-factory.js","sourceRoot":"","sources":["../../../../src/domains/embedding/providers/embedding-provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IAC3B,MAAM,CAAC,QAAQ,CAA2B;IAC1C,SAAS,GAAsD,IAAI,GAAG,EAAE,CAAC;IAChE,mBAAmB,CAA2B;IAE/D;QACE,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,mBAAmB,GAAG,IAAI,wBAAwB,CACrD,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAChD,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,CAAC;YACvC,wBAAwB,CAAC,QAAQ,GAAG,IAAI,wBAAwB,EAAE,CAAC;QACrE,CAAC;QACD,OAAO,wBAAwB,CAAC,QAAQ,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACK,mBAAmB;QACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,QAA2B;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,MAAM,aAAa,GAAmB,EAAE,CAAC;QAEzC,SAAS;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtE,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC;YACnE,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC;QAEH,oBAAoB;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACpG,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,SAAS;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtE,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC;YACnE,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC;QAEH,SAAS;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtE,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC;YACnE,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,iBAAqC;QAClD,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAExD,sBAAsB;QACtB,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,mBAAmB,GAAG,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;YAC1E,MAAM,SAAS,GAAG,mBAAmB;gBACnC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,IAAI,CAAC,CAAC,SAAS,CAAC;gBAC7E,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,kBAAkB,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChD,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,eAAe,GAAG,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;QACpF,MAAM,gBAAgB,GAAG,eAAe;YACtC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,SAAS,CAAC;YACzE,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,qBAAqB,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QAED,wBAAwB;QACxB,MAAM,cAAc,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACjE,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,0BAA0B,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,6BAA6B,CACjC,iBAAqC;QAErC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QACtF,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,QAA2B,EAAE,OAAkC;QAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAA2B;QAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACxD,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChE,CAAC;IAEO,mBAAmB,CACzB,QAA2B,EAC3B,OAAqD,EACrD,MAA6B;QAE7B,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,CAAC;QACtC,CAAC;QACD,OAAO,OAAO,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAEO,qBAAqB,CAAC,QAAwB;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1C,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,OAAO;gBACV,OAAO,OAAO,CAAC;YACjB,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAC;YAClB,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAC;YAClB,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAC;YAClB,KAAK,aAAa;gBAChB,OAAO,OAAO,CAAC;YACjB;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,oBAAoB;QAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,qBAAqB,CAAC,QAA2B;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,MAAM,UAAU,cAAc,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,eAAe,CAAC,OAAyC;QACvD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YACxD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,aAAa,CAAC,QAA2B;QAC/C,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,QAAQ;gBACX,OAAO,IAAI,sBAAsB,EAAE,CAAC;YACtC,KAAK,OAAO;gBACV,OAAO,IAAI,2BAA2B,EAAE,CAAC;YAC3C,KAAK,QAAQ;gBACX,OAAO,IAAI,sBAAsB,EAAE,CAAC;YACtC,KAAK,QAAQ;gBACX,OAAO,IAAI,sBAAsB,EAAE,CAAC;YACtC;gBACE,OAAO,IAAI,2BAA2B,EAAE,CAAC;QAC7C,CAAC;IACH,CAAC;CACF"}

package/dist/domains/embedding/providers/model-availability-service.d.ts

@@ -0,0 +1,22 @@
+import type { EmbeddingProvider } from '../../../shared/types/embedding.types.js';
+import type { ProviderFallbackDecision, ProviderHealthCheckOptions, ProviderHealthStatus } from '../../../shared/types/embedding-provider-monitoring.types.js';
+export type ProviderResolver = (provider: EmbeddingProvider) => {
+    generateEmbedding(text: string): Promise<unknown>;
+    isAvailable(): boolean;
+} | null;
+export type ProviderPriorityResolver = () => EmbeddingProvider[];
+export declare class ModelAvailabilityService {
+    private readonly resolveProvider;
+    private readonly resolvePriority;
+    private readonly lastStatus;
+    private readonly subscribers;
+    constructor(resolveProvider: ProviderResolver, resolvePriority: ProviderPriorityResolver);
+    checkProviderHealth(provider: EmbeddingProvider, options?: ProviderHealthCheckOptions): Promise<ProviderHealthStatus>;
+    getLastStatus(provider: EmbeddingProvider): ProviderHealthStatus | undefined;
+    getAllStatuses(): ProviderHealthStatus[];
+    subscribe(listener: (status: ProviderHealthStatus) => void): () => void;
+    selectBestProvider(preferredProvider?: EmbeddingProvider, options?: ProviderHealthCheckOptions): Promise<ProviderFallbackDecision>;
+    private getPriorityList;
+    private broadcast;
+}
+//# sourceMappingURL=model-availability-service.d.ts.map

package/dist/domains/embedding/providers/model-availability-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-availability-service.d.ts","sourceRoot":"","sources":["../../../../src/domains/embedding/providers/model-availability-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,8DAA8D,CAAC;AAStE,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,iBAAiB,KAAK;IAC9D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,WAAW,IAAI,OAAO,CAAC;CACxB,GAAG,IAAI,CAAC;AAET,MAAM,MAAM,wBAAwB,GAAG,MAAM,iBAAiB,EAAE,CAAC;AAEjE,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2D;IACtF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0D;gBAE1E,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,wBAAwB;IAKlF,mBAAmB,CACvB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,oBAAoB,CAAC;IAuEhC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,oBAAoB,GAAG,SAAS;IAI5E,cAAc,IAAI,oBAAoB,EAAE;IAMxC,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IAQjE,kBAAkB,CACtB,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,wBAAwB,CAAC;IAuCpC,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,SAAS;CAKlB"}

package/dist/domains/embedding/providers/model-availability-service.js

@@ -0,0 +1,140 @@
+import { alertNotificationService } from '../../monitoring/services/alert-notification-service.js';
+const DEFAULT_HEALTH_SAMPLE = 'System health check';
+function now() {
+    return new Date();
+}
+export class ModelAvailabilityService {
+    resolveProvider;
+    resolvePriority;
+    lastStatus = new Map();
+    subscribers = new Set();
+    constructor(resolveProvider, resolvePriority) {
+        this.resolveProvider = resolveProvider;
+        this.resolvePriority = resolvePriority;
+    }
+    async checkProviderHealth(provider, options = {}) {
+        const sample = options.sampleText ?? DEFAULT_HEALTH_SAMPLE;
+        const startedAt = Date.now();
+        const previousStatus = this.lastStatus.get(provider);
+        try {
+            const service = this.resolveProvider(provider);
+            if (!service || !service.isAvailable()) {
+                throw new Error('Provider unavailable or not registered');
+            }
+            const timeout = options.timeoutMs && options.timeoutMs > 0 ? options.timeoutMs : undefined;
+            if (timeout) {
+                await Promise.race([
+                    service.generateEmbedding(sample),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Health check timeout')), timeout))
+                ]);
+            }
+            else {
+                await service.generateEmbedding(sample);
+            }
+            const status = {
+                provider,
+                state: 'available',
+                latencyMs: Date.now() - startedAt,
+                lastCheckedAt: now()
+            };
+            this.lastStatus.set(provider, status);
+            options.onProgress?.(status);
+            this.broadcast(status);
+            if (!previousStatus || previousStatus.state !== status.state) {
+                alertNotificationService.emitAlert({
+                    id: `provider-${provider}-${Date.now()}`,
+                    source: 'model-availability',
+                    severity: 'info',
+                    message: `${provider} provider is available`,
+                    metadata: {
+                        provider,
+                        state: status.state,
+                        previousState: previousStatus?.state ?? 'unknown',
+                        latencyMs: status.latencyMs
+                    }
+                });
+            }
+            return status;
+        }
+        catch (error) {
+            const status = {
+                provider,
+                state: 'unavailable',
+                lastCheckedAt: now(),
+                message: error instanceof Error ? error.message : 'Unknown error'
+            };
+            this.lastStatus.set(provider, status);
+            options.onProgress?.(status);
+            this.broadcast(status);
+            if (!previousStatus || previousStatus.state !== status.state) {
+                alertNotificationService.emitAlert({
+                    id: `provider-${provider}-${Date.now()}`,
+                    source: 'model-availability',
+                    severity: 'warning',
+                    message: `${provider} provider became unavailable` + (status.message ? `: ${status.message}` : ''),
+                    metadata: {
+                        provider,
+                        state: status.state,
+                        previousState: previousStatus?.state ?? 'unknown'
+                    }
+                });
+            }
+            return status;
+        }
+    }
+    getLastStatus(provider) {
+        return this.lastStatus.get(provider);
+    }
+    getAllStatuses() {
+        return Array.from(this.lastStatus.values()).sort((a, b) => a.provider.localeCompare(b.provider));
+    }
+    subscribe(listener) {
+        this.subscribers.add(listener);
+        this.getAllStatuses().forEach(status => listener(status));
+        return () => {
+            this.subscribers.delete(listener);
+        };
+    }
+    async selectBestProvider(preferredProvider, options = {}) {
+        const attempted = [];
+        const orderedProviders = preferredProvider !== undefined
+            ? [preferredProvider, ...this.getPriorityList().filter(p => p !== preferredProvider)]
+            : this.getPriorityList();
+        if (orderedProviders.length === 0) {
+            return {
+                selectedProvider: preferredProvider ?? 'minilm',
+                reason: 'no-registered-providers',
+                attemptedProviders: []
+            };
+        }
+        for (const provider of orderedProviders) {
+            const status = await this.checkProviderHealth(provider, options);
+            attempted.push({
+                provider,
+                state: status.state,
+                error: status.state === 'unavailable' ? status.message : undefined
+            });
+            if (status.state === 'available') {
+                return {
+                    selectedProvider: provider,
+                    reason: options.onProgress ? 'health-check-success' : 'default',
+                    attemptedProviders: attempted
+                };
+            }
+        }
+        return {
+            selectedProvider: orderedProviders[0] ?? preferredProvider ?? 'minilm',
+            reason: 'fallback-failed',
+            attemptedProviders: attempted
+        };
+    }
+    getPriorityList() {
+        return this.resolvePriority();
+    }
+    broadcast(status) {
+        for (const subscriber of this.subscribers) {
+            subscriber(status);
+        }
+    }
+}
+//# sourceMappingURL=model-availability-service.js.map

package/dist/domains/embedding/providers/model-availability-service.js.map

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

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

@@ -0,0 +1,24 @@
+import type { Database } from 'better-sqlite3';
+import type { EmbeddingProvider } from '../../../shared/types/embedding.types.js';
+import type { EmbeddingMigrationPlan, EmbeddingMigrationTarget, MigrationHistoryRecord, MigrationMonitorOptions, MigrationProgress, MigrationRollbackEntry, MigrationResult } from '../../../shared/types/migration.types.js';
+/**
+ * 임베딩 마이그레이션 서비스
+ * - 기존 임베딩 벡터를 목표 제공자의 차원에 맞게 재투영
+ * - 마이그레이션 플랜/실행/진행 상태 관리
+ */
+export declare class EmbeddingMigrationService {
+    private createSnapshot;
+    private resolveRunStatus;
+    private notifyProgress;
+    private beginStep;
+    private completeStep;
+    createPlan(sourceProvider: EmbeddingProvider, targetProvider: EmbeddingProvider, overrides?: Partial<EmbeddingMigrationPlan>): EmbeddingMigrationPlan;
+    listTargets(db: Database, plan: EmbeddingMigrationPlan, limit?: number): EmbeddingMigrationTarget[];
+    initializeProgress(total: number, resumeFromId?: string): MigrationProgress;
+    execute(db: Database, plan: EmbeddingMigrationPlan, monitor?: MigrationMonitorOptions): Promise<MigrationResult>;
+    private safeParseEmbedding;
+    rollback(db: Database, entries: ReadonlyArray<MigrationRollbackEntry>): void;
+    listHistory(db: Database, limit?: number): MigrationHistoryRecord[];
+}
+export declare const embeddingMigrationService: EmbeddingMigrationService;
+//# sourceMappingURL=embedding-migration-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-migration-service.d.ts","sourceRoot":"","sources":["../../../../src/domains/embedding/services/embedding-migration-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAuC,MAAM,0CAA0C,CAAC;AACvH,OAAO,KAAK,EAEV,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAEjB,sBAAsB,EACtB,eAAe,EAIhB,MAAM,0CAA0C,CAAC;AA+BlD;;;;GAIG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,YAAY;IAcpB,UAAU,CACR,cAAc,EAAE,iBAAiB,EACjC,cAAc,EAAE,iBAAiB,EACjC,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,sBAAsB;IAiCzB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,wBAAwB,EAAE;IAsCnG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAcrE,OAAO,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,sBAAsB,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,eAAe,CAAC;IA2O3B,OAAO,CAAC,kBAAkB;IAc1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,IAAI;IA+D5E,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAW,GAAG,sBAAsB,EAAE;CAGxE;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAC"}