@ninebix/nmt-system 1.0.0

package/dist/services/adaptive-fallback.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Adaptive Fallback Service
+ * 검색 품질 저하 시 자동 복구 로직
+ *
+ * 설계 문서: NMT_Updated.md 3.3절
+ * - 검색 품질이 낮거나 컨텍스트 부족 시:
+ *   1) Top-K 증가 (k↑)
+ *   2) efSearch 조정 (리콜↑)
+ *   3) 임베딩 모델 교체/업그레이드
+ *   4) 상위 모델로 업그레이드 라우팅
+ *
+ * @module services/adaptive-fallback
+ */
+import type { ComplexityLevel } from './llm-router.js';
+/**
+ * 품질 평가 결과
+ */
+export interface QualityAssessment {
+    score: number;
+    searchQuality: number;
+    contextQuality: number;
+    coverageRatio: number;
+    issues: QualityIssue[];
+    needsFallback: boolean;
+    suggestedAction: FallbackAction | null;
+}
+/**
+ * 품질 이슈 유형
+ */
+export type QualityIssue = 'low_search_score' | 'few_results' | 'low_diversity' | 'context_too_short' | 'low_relevance' | 'query_mismatch';
+/**
+ * Fallback 액션 유형
+ */
+export type FallbackAction = {
+    type: 'increase_k';
+    newK: number;
+} | {
+    type: 'increase_ef';
+    newEf: number;
+} | {
+    type: 'retry_with_expanded_query';
+    expandedQuery: string;
+} | {
+    type: 'upgrade_model';
+    newLevel: ComplexityLevel;
+} | {
+    type: 'use_alternative_embedding';
+} | {
+    type: 'request_more_context';
+} | {
+    type: 'abstain';
+    reason: string;
+};
+/**
+ * Fallback 설정
+ */
+export interface FallbackConfig {
+    minSearchScore: number;
+    minResultCount: number;
+    minContextTokens: number;
+    minCoverageRatio: number;
+    maxKIncrease: number;
+    maxEfIncrease: number;
+    maxRetries: number;
+    autoUpgradeModel: boolean;
+    upgradeOnLowQuality: boolean;
+}
+/**
+ * Fallback 실행 결과
+ */
+export interface FallbackResult<T> {
+    success: boolean;
+    finalResult: T | null;
+    attemptsCount: number;
+    actionsApplied: FallbackAction[];
+    qualityHistory: QualityAssessment[];
+    totalTimeMs: number;
+}
+/**
+ * 검색 결과 인터페이스
+ */
+export interface SearchResultLike {
+    id: string;
+    score: number;
+    content?: string;
+}
+/**
+ * Adaptive Fallback Manager
+ */
+export declare class AdaptiveFallbackManager {
+    private config;
+    private stats;
+    constructor(config?: Partial<FallbackConfig>);
+    /**
+     * 품질 평가
+     */
+    assessQuality(query: string, results: SearchResultLike[], contexts: string[]): QualityAssessment;
+    /**
+     * Fallback 액션 결정
+     */
+    private determineFallbackAction;
+    /**
+     * 액션 기록
+     */
+    private recordAction;
+    /**
+     * Fallback 실행 (재시도 루프)
+     */
+    executeWithFallback<T>(initialParams: {
+        k: number;
+        efSearch: number;
+        modelLevel: ComplexityLevel;
+    }, searchFn: (params: {
+        k: number;
+        efSearch: number;
+    }) => Promise<SearchResultLike[]>, processFn: (results: SearchResultLike[], modelLevel: ComplexityLevel) => Promise<T>, query: string): Promise<FallbackResult<T>>;
+    /**
+     * 분산 계산
+     */
+    private calculateVariance;
+    /**
+     * 설정 업데이트
+     */
+    updateConfig(config: Partial<FallbackConfig>): void;
+    /**
+     * 통계 조회
+     */
+    getStats(): {
+        totalAssessments: number;
+        fallbackRate: number;
+        recoveryRate: number;
+        actionDistribution: Record<string, number>;
+    };
+    /**
+     * 통계 초기화
+     */
+    resetStats(): void;
+}
+export declare const adaptiveFallback: AdaptiveFallbackManager;
+//# sourceMappingURL=adaptive-fallback.d.ts.map

package/dist/services/adaptive-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-fallback.d.ts","sourceRoot":"","sources":["../../src/services/adaptive-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,aAAa,GACb,eAAe,GACf,mBAAmB,GACnB,eAAe,GACf,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,2BAA2B,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,sBAAsB,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IAGnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAA2B;IAGzC,OAAO,CAAC,KAAK,CAMX;gBAEU,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAchD;;OAEG;IACH,aAAa,CACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,EAAE,EAC3B,QAAQ,EAAE,MAAM,EAAE,GACjB,iBAAiB;IA4EpB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0C/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACG,mBAAmB,CAAC,CAAC,EACzB,aAAa,EAAE;QACb,CAAC,EAAE,MAAM,CAAC;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,eAAe,CAAC;KAC7B,EACD,QAAQ,EAAE,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC,EAClF,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,UAAU,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,EACnF,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAwF7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAInD;;OAEG;IACH,QAAQ,IAAI;QACV,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC5C;IAgBD;;OAEG;IACH,UAAU,IAAI,IAAI;CASnB;AAGD,eAAO,MAAM,gBAAgB,yBAAgC,CAAC"}

package/dist/services/adaptive-fallback.js

@@ -0,0 +1,273 @@
+/**
+ * Adaptive Fallback Service
+ * 검색 품질 저하 시 자동 복구 로직
+ *
+ * 설계 문서: NMT_Updated.md 3.3절
+ * - 검색 품질이 낮거나 컨텍스트 부족 시:
+ *   1) Top-K 증가 (k↑)
+ *   2) efSearch 조정 (리콜↑)
+ *   3) 임베딩 모델 교체/업그레이드
+ *   4) 상위 모델로 업그레이드 라우팅
+ *
+ * @module services/adaptive-fallback
+ */
+/**
+ * Adaptive Fallback Manager
+ */
+export class AdaptiveFallbackManager {
+    config;
+    // 통계
+    stats = {
+        totalAssessments: 0,
+        fallbackTriggered: 0,
+        successfulRecoveries: 0,
+        failedRecoveries: 0,
+        actionCounts: new Map()
+    };
+    constructor(config = {}) {
+        this.config = {
+            minSearchScore: config.minSearchScore ?? 0.5,
+            minResultCount: config.minResultCount ?? 3,
+            minContextTokens: config.minContextTokens ?? 100,
+            minCoverageRatio: config.minCoverageRatio ?? 0.4,
+            maxKIncrease: config.maxKIncrease ?? 3,
+            maxEfIncrease: config.maxEfIncrease ?? 200,
+            maxRetries: config.maxRetries ?? 2,
+            autoUpgradeModel: config.autoUpgradeModel ?? true,
+            upgradeOnLowQuality: config.upgradeOnLowQuality ?? true
+        };
+    }
+    /**
+     * 품질 평가
+     */
+    assessQuality(query, results, contexts) {
+        this.stats.totalAssessments++;
+        const issues = [];
+        // 1. 검색 점수 평가
+        const avgScore = results.length > 0
+            ? results.reduce((sum, r) => sum + r.score, 0) / results.length
+            : 0;
+        const maxScore = results.length > 0
+            ? Math.max(...results.map(r => r.score))
+            : 0;
+        const searchQuality = (avgScore + maxScore) / 2;
+        if (maxScore < this.config.minSearchScore) {
+            issues.push('low_search_score');
+        }
+        // 2. 결과 수 평가
+        if (results.length < this.config.minResultCount) {
+            issues.push('few_results');
+        }
+        // 3. 컨텍스트 평가
+        const totalContextLength = contexts.join(' ').length;
+        const estimatedTokens = Math.ceil(totalContextLength / 4);
+        const contextQuality = Math.min(1, estimatedTokens / this.config.minContextTokens);
+        if (estimatedTokens < this.config.minContextTokens) {
+            issues.push('context_too_short');
+        }
+        // 4. 커버리지 평가 (쿼리 키워드가 컨텍스트에 있는 비율)
+        const queryWords = query.toLowerCase().split(/\s+/).filter(w => w.length > 2);
+        const contextLower = contexts.join(' ').toLowerCase();
+        const matchedWords = queryWords.filter(w => contextLower.includes(w));
+        const coverageRatio = queryWords.length > 0
+            ? matchedWords.length / queryWords.length
+            : 0;
+        if (coverageRatio < this.config.minCoverageRatio) {
+            issues.push('query_mismatch');
+        }
+        // 5. 다양성 평가
+        if (results.length >= 3) {
+            const scoreVariance = this.calculateVariance(results.map(r => r.score));
+            if (scoreVariance < 0.01) {
+                issues.push('low_diversity');
+            }
+        }
+        // 6. 종합 점수 계산
+        const score = (searchQuality * 0.4 + contextQuality * 0.3 + coverageRatio * 0.3);
+        // 7. Fallback 필요 여부 결정
+        const needsFallback = issues.length > 0 && score < 0.6;
+        // 8. 제안 액션 결정
+        let suggestedAction = null;
+        if (needsFallback) {
+            suggestedAction = this.determineFallbackAction(issues, results.length);
+            this.stats.fallbackTriggered++;
+        }
+        return {
+            score,
+            searchQuality,
+            contextQuality,
+            coverageRatio,
+            issues,
+            needsFallback,
+            suggestedAction
+        };
+    }
+    /**
+     * Fallback 액션 결정
+     */
+    determineFallbackAction(issues, currentResultCount) {
+        // 우선순위에 따라 액션 결정
+        // 1. 결과가 너무 적으면 k 증가
+        if (issues.includes('few_results')) {
+            const newK = Math.min(currentResultCount * 2, currentResultCount * this.config.maxKIncrease);
+            this.recordAction('increase_k');
+            return { type: 'increase_k', newK };
+        }
+        // 2. 검색 점수가 낮으면 efSearch 증가
+        if (issues.includes('low_search_score')) {
+            this.recordAction('increase_ef');
+            return { type: 'increase_ef', newEf: this.config.maxEfIncrease };
+        }
+        // 3. 쿼리 불일치면 쿼리 확장
+        if (issues.includes('query_mismatch')) {
+            this.recordAction('retry_with_expanded_query');
+            return { type: 'retry_with_expanded_query', expandedQuery: '' }; // 외부에서 확장
+        }
+        // 4. 컨텍스트 부족이면 더 많은 컨텍스트 요청
+        if (issues.includes('context_too_short')) {
+            this.recordAction('request_more_context');
+            return { type: 'request_more_context' };
+        }
+        // 5. 기타 문제는 모델 업그레이드
+        if (this.config.autoUpgradeModel) {
+            this.recordAction('upgrade_model');
+            return { type: 'upgrade_model', newLevel: 'complex' };
+        }
+        // 6. 최후 수단: 답변 거부
+        this.recordAction('abstain');
+        return { type: 'abstain', reason: '충분한 정보를 찾을 수 없습니다.' };
+    }
+    /**
+     * 액션 기록
+     */
+    recordAction(actionType) {
+        this.stats.actionCounts.set(actionType, (this.stats.actionCounts.get(actionType) ?? 0) + 1);
+    }
+    /**
+     * Fallback 실행 (재시도 루프)
+     */
+    async executeWithFallback(initialParams, searchFn, processFn, query) {
+        const startTime = Date.now();
+        const actionsApplied = [];
+        const qualityHistory = [];
+        let currentParams = { ...initialParams };
+        let attempts = 0;
+        while (attempts <= this.config.maxRetries) {
+            attempts++;
+            try {
+                // 1. 검색 실행
+                const results = await searchFn({
+                    k: currentParams.k,
+                    efSearch: currentParams.efSearch
+                });
+                const contexts = results
+                    .filter(r => r.content)
+                    .map(r => r.content);
+                // 2. 품질 평가
+                const assessment = this.assessQuality(query, results, contexts);
+                qualityHistory.push(assessment);
+                // 3. 품질이 충분하면 처리 진행
+                if (!assessment.needsFallback || attempts > this.config.maxRetries) {
+                    const finalResult = await processFn(results, currentParams.modelLevel);
+                    if (attempts > 1) {
+                        this.stats.successfulRecoveries++;
+                    }
+                    return {
+                        success: true,
+                        finalResult,
+                        attemptsCount: attempts,
+                        actionsApplied,
+                        qualityHistory,
+                        totalTimeMs: Date.now() - startTime
+                    };
+                }
+                // 4. Fallback 액션 적용
+                const action = assessment.suggestedAction;
+                actionsApplied.push(action);
+                switch (action.type) {
+                    case 'increase_k':
+                        currentParams.k = action.newK;
+                        break;
+                    case 'increase_ef':
+                        currentParams.efSearch = action.newEf;
+                        break;
+                    case 'upgrade_model':
+                        currentParams.modelLevel = action.newLevel;
+                        break;
+                    case 'abstain':
+                        // 답변 거부 - 루프 종료
+                        this.stats.failedRecoveries++;
+                        return {
+                            success: false,
+                            finalResult: null,
+                            attemptsCount: attempts,
+                            actionsApplied,
+                            qualityHistory,
+                            totalTimeMs: Date.now() - startTime
+                        };
+                }
+            }
+            catch (error) {
+                console.error(`[AdaptiveFallback] Attempt ${attempts} failed:`, error);
+            }
+        }
+        // 최대 재시도 초과
+        this.stats.failedRecoveries++;
+        return {
+            success: false,
+            finalResult: null,
+            attemptsCount: attempts,
+            actionsApplied,
+            qualityHistory,
+            totalTimeMs: Date.now() - startTime
+        };
+    }
+    /**
+     * 분산 계산
+     */
+    calculateVariance(values) {
+        if (values.length === 0)
+            return 0;
+        const mean = values.reduce((a, b) => a + b, 0) / values.length;
+        const squaredDiffs = values.map(v => Math.pow(v - mean, 2));
+        return squaredDiffs.reduce((a, b) => a + b, 0) / values.length;
+    }
+    /**
+     * 설정 업데이트
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * 통계 조회
+     */
+    getStats() {
+        const total = this.stats.fallbackTriggered;
+        const recovered = this.stats.successfulRecoveries;
+        return {
+            totalAssessments: this.stats.totalAssessments,
+            fallbackRate: this.stats.totalAssessments > 0
+                ? this.stats.fallbackTriggered / this.stats.totalAssessments
+                : 0,
+            recoveryRate: total > 0
+                ? recovered / total
+                : 0,
+            actionDistribution: Object.fromEntries(this.stats.actionCounts)
+        };
+    }
+    /**
+     * 통계 초기화
+     */
+    resetStats() {
+        this.stats = {
+            totalAssessments: 0,
+            fallbackTriggered: 0,
+            successfulRecoveries: 0,
+            failedRecoveries: 0,
+            actionCounts: new Map()
+        };
+    }
+}
+// 싱글톤 인스턴스
+export const adaptiveFallback = new AdaptiveFallbackManager();
+//# sourceMappingURL=adaptive-fallback.js.map

package/dist/services/adaptive-fallback.js.map

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

package/dist/services/answer-gate.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Answer Gate Service
+ * 근거 기반 응답 강제 및 할루시네이션 억제
+ *
+ * 설계 문서: NMT_Updated.md Step 6 (3.2절)
+ * - 근거 chunk에서만 답변
+ * - 근거가 부족하면 "정보 부족"으로 답변
+ * - 결과에 sources(neuronId/score/snippet) 첨부
+ *
+ * @module services/answer-gate
+ */
+/**
+ * 출처 참조
+ */
+export interface SourceReference {
+    id: string;
+    content: string;
+    score: number;
+    snippet?: string;
+    verified?: boolean;
+}
+/**
+ * 근거 기반 응답
+ */
+export interface GroundedAnswer {
+    answer: string;
+    grounded: boolean;
+    groundingScore: number;
+    sources: SourceReference[];
+    abstained: boolean;
+    confidence: number;
+    warnings: string[];
+}
+/**
+ * Answer Gate 설정
+ */
+export interface AnswerGateConfig {
+    minSources: number;
+    minSourceScore: number;
+    minGroundingScore: number;
+    enforceSourceCitation: boolean;
+    abstainOnLowConfidence: boolean;
+    confidenceThreshold: number;
+}
+/**
+ * 근거 기반 시스템 프롬프트 생성
+ */
+export declare function createGroundingSystemPrompt(config?: Partial<AnswerGateConfig>): string;
+/**
+ * 간단한 근거 기반 프롬프트 (토큰 절약용)
+ */
+export declare function createCompactGroundingPrompt(): string;
+/**
+ * Answer Gate 클래스
+ */
+export declare class AnswerGate {
+    private config;
+    private stats;
+    constructor(config?: Partial<AnswerGateConfig>);
+    /**
+     * 시스템 프롬프트 생성
+     */
+    getSystemPrompt(compact?: boolean): string;
+    /**
+     * 응답 검증 및 후처리
+     */
+    validateAndProcess(rawAnswer: string, sources: SourceReference[]): GroundedAnswer;
+    /**
+     * 근거 점수 계산
+     */
+    private calculateGroundingScore;
+    /**
+     * 출처 인용 확인
+     */
+    private checkCitations;
+    /**
+     * 신뢰도 계산
+     */
+    private calculateConfidence;
+    /**
+     * 답변 거부 여부 결정
+     */
+    private shouldAbstain;
+    /**
+     * 답변 거부 응답 생성
+     */
+    private generateAbstainResponse;
+    /**
+     * 출처 섹션 추가
+     */
+    private appendSourceSection;
+    /**
+     * 통계 조회
+     */
+    getStats(): {
+        totalResponses: number;
+        groundedRate: number;
+        abstainRate: number;
+        avgSourcesPerResponse: number;
+        avgGroundingScore: number;
+    };
+    /**
+     * 통계 초기화
+     */
+    resetStats(): void;
+    /**
+     * 설정 변경
+     */
+    updateConfig(config: Partial<AnswerGateConfig>): void;
+}
+export declare const answerGate: AnswerGate;
+//# sourceMappingURL=answer-gate.d.ts.map

package/dist/services/answer-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-gate.d.ts","sourceRoot":"","sources":["../../src/services/answer-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,sBAAsB,EAAE,OAAO,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CA2CtF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA6B;IAG3C,OAAO,CAAC,KAAK,CAMX;gBAEU,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAWlD;;OAEG;IACH,eAAe,CAAC,OAAO,GAAE,OAAe,GAAG,MAAM;IAMjD;;OAEG;IACH,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,EAAE,GACzB,cAAc;IAqDjB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,QAAQ,IAAI;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,iBAAiB,EAAE,MAAM,CAAC;KAC3B;IAgBD;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;CAGtD;AAGD,eAAO,MAAM,UAAU,YAAmB,CAAC"}