@ninebix/nmt-system 1.0.0

package/dist/services/context-compressor.js

@@ -0,0 +1,234 @@
+/**
+ * Smart Context Compressor
+ * LLM 토큰 비용 절감을 위한 컨텍스트 압축
+ *
+ * @module services/context-compressor
+ */
+import { cosineSimilarity } from '../utils/similarity.js';
+/**
+ * 토큰 추정 (간단한 휴리스틱)
+ */
+function estimateTokens(text) {
+    // 영어: ~4자 = 1토큰, 한글: ~2자 = 1토큰
+    const englishChars = text.replace(/[가-힣]/g, '').length;
+    const koreanChars = text.length - englishChars;
+    return Math.ceil(englishChars / 4 + koreanChars / 2);
+}
+/**
+ * 문장 추출 (핵심 문장만)
+ */
+function extractKeySentences(text, maxSentences = 3) {
+    // 문장 분리
+    const sentences = text
+        .split(/[.!?。！？]\s*/)
+        .map(s => s.trim())
+        .filter(s => s.length > 10);
+    if (sentences.length <= maxSentences) {
+        return text;
+    }
+    // 점수 기반 문장 선택 (길이 + 키워드 밀도)
+    const scored = sentences.map(s => ({
+        text: s,
+        score: s.length * 0.1 + (s.match(/[A-Z가-힣]/g)?.length || 0) * 0.5
+    }));
+    scored.sort((a, b) => b.score - a.score);
+    return scored
+        .slice(0, maxSentences)
+        .map(s => s.text)
+        .join('. ') + '.';
+}
+/**
+ * Context Compressor 클래스
+ */
+export class ContextCompressor {
+    defaultOptions = {
+        maxTokens: 2000,
+        maxChunks: 5,
+        minScore: 0.3,
+        diversityThreshold: 0.85,
+        strategy: 'hybrid'
+    };
+    /**
+     * 컨텍스트 압축
+     */
+    compress(chunks, queryEmbedding, options = {}) {
+        const opts = { ...this.defaultOptions, ...options };
+        const originalCount = chunks.length;
+        let originalTokens = 0;
+        // 원본 토큰 수 계산
+        for (const chunk of chunks) {
+            originalTokens += estimateTokens(chunk.content);
+        }
+        // 1단계: 최소 점수 필터링
+        let filtered = chunks.filter(c => c.score >= opts.minScore);
+        // 2단계: 전략별 처리
+        let selected;
+        switch (opts.strategy) {
+            case 'relevance':
+                selected = this.selectByRelevance(filtered, opts);
+                break;
+            case 'diversity':
+                selected = this.selectByDiversity(filtered, queryEmbedding, opts);
+                break;
+            case 'hybrid':
+            default:
+                selected = this.selectHybrid(filtered, queryEmbedding, opts);
+        }
+        // 3단계: 토큰 제한 내에서 청크 선택 + 압축
+        const result = this.fitToTokenLimit(selected, opts.maxTokens);
+        // 결과 계산
+        let compressedTokens = 0;
+        for (const chunk of result) {
+            compressedTokens += estimateTokens(chunk.content);
+        }
+        return {
+            chunks: result,
+            originalCount,
+            compressedCount: result.length,
+            totalTokens: compressedTokens,
+            savedTokens: originalTokens - compressedTokens,
+            compressionRatio: originalTokens > 0
+                ? (originalTokens - compressedTokens) / originalTokens
+                : 0
+        };
+    }
+    /**
+     * 관련도 기반 선택
+     */
+    selectByRelevance(chunks, opts) {
+        return [...chunks]
+            .sort((a, b) => b.score - a.score)
+            .slice(0, opts.maxChunks);
+    }
+    /**
+     * 다양성 기반 선택 (MMR 스타일)
+     */
+    selectByDiversity(chunks, queryEmbedding, opts) {
+        if (chunks.length === 0)
+            return [];
+        const selected = [];
+        const remaining = [...chunks];
+        // 첫 번째: 가장 관련도 높은 것
+        remaining.sort((a, b) => b.score - a.score);
+        selected.push(remaining.shift());
+        // 나머지: 다양성 고려
+        while (selected.length < opts.maxChunks && remaining.length > 0) {
+            let bestIdx = 0;
+            let bestScore = -Infinity;
+            for (let i = 0; i < remaining.length; i++) {
+                const candidate = remaining[i];
+                // 기존 선택된 것들과의 최대 유사도
+                let maxSim = 0;
+                if (candidate.embedding) {
+                    for (const s of selected) {
+                        if (s.embedding) {
+                            const sim = cosineSimilarity(candidate.embedding, s.embedding);
+                            maxSim = Math.max(maxSim, sim);
+                        }
+                    }
+                }
+                // MMR 점수: 관련도 - λ * 중복도
+                const mmrScore = candidate.score - 0.5 * maxSim;
+                if (mmrScore > bestScore) {
+                    bestScore = mmrScore;
+                    bestIdx = i;
+                }
+            }
+            // 중복이 너무 높으면 스킵
+            const candidate = remaining[bestIdx];
+            let maxSim = 0;
+            if (candidate.embedding) {
+                for (const s of selected) {
+                    if (s.embedding) {
+                        maxSim = Math.max(maxSim, cosineSimilarity(candidate.embedding, s.embedding));
+                    }
+                }
+            }
+            if (maxSim < opts.diversityThreshold) {
+                selected.push(remaining.splice(bestIdx, 1)[0]);
+            }
+            else {
+                remaining.splice(bestIdx, 1); // 너무 유사하면 제거
+            }
+        }
+        return selected;
+    }
+    /**
+     * 하이브리드 선택 (관련도 + 다양성)
+     */
+    selectHybrid(chunks, queryEmbedding, opts) {
+        // 상위 50%는 관련도 기반
+        const topK = Math.ceil(opts.maxChunks * 0.5);
+        const relevanceBased = this.selectByRelevance(chunks, { ...opts, maxChunks: topK });
+        // 나머지는 다양성 기반
+        const remaining = chunks.filter(c => !relevanceBased.includes(c));
+        const diversityBased = this.selectByDiversity(remaining, queryEmbedding, { ...opts, maxChunks: opts.maxChunks - topK });
+        return [...relevanceBased, ...diversityBased];
+    }
+    /**
+     * 토큰 제한에 맞게 조정
+     */
+    fitToTokenLimit(chunks, maxTokens) {
+        const result = [];
+        let totalTokens = 0;
+        for (const chunk of chunks) {
+            const tokens = estimateTokens(chunk.content);
+            if (totalTokens + tokens <= maxTokens) {
+                // 그대로 추가
+                result.push(chunk);
+                totalTokens += tokens;
+            }
+            else {
+                // 압축 시도
+                const remaining = maxTokens - totalTokens;
+                if (remaining > 100) { // 최소 100토큰은 있어야 의미 있음
+                    const compressed = this.compressChunk(chunk, remaining);
+                    result.push(compressed);
+                    totalTokens += estimateTokens(compressed.content);
+                }
+                break;
+            }
+        }
+        return result;
+    }
+    /**
+     * 개별 청크 압축
+     */
+    compressChunk(chunk, targetTokens) {
+        const currentTokens = estimateTokens(chunk.content);
+        if (currentTokens <= targetTokens) {
+            return chunk;
+        }
+        // 핵심 문장만 추출
+        const maxSentences = Math.max(1, Math.floor(targetTokens / 50));
+        const compressed = extractKeySentences(chunk.content, maxSentences);
+        return {
+            ...chunk,
+            content: compressed
+        };
+    }
+    /**
+     * 빠른 압축 (시간 우선)
+     */
+    quickCompress(chunks, maxTokens = 1500) {
+        return this.compress(chunks, undefined, {
+            maxTokens,
+            maxChunks: 3,
+            strategy: 'relevance'
+        });
+    }
+    /**
+     * 품질 압축 (정확도 우선)
+     */
+    qualityCompress(chunks, queryEmbedding, maxTokens = 3000) {
+        return this.compress(chunks, queryEmbedding, {
+            maxTokens,
+            maxChunks: 7,
+            strategy: 'hybrid',
+            diversityThreshold: 0.8
+        });
+    }
+}
+// 싱글톤 인스턴스
+export const contextCompressor = new ContextCompressor();
+//# sourceMappingURL=context-compressor.js.map

package/dist/services/context-compressor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compressor.js","sourceRoot":"","sources":["../../src/services/context-compressor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAoC1D;;GAEG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,+BAA+B;IAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;IACvD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAAY,EAAE,eAAuB,CAAC;IACjE,QAAQ;IACR,MAAM,SAAS,GAAG,IAAI;SACnB,KAAK,CAAC,aAAa,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAE9B,IAAI,SAAS,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4BAA4B;IAC5B,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,GAAG;KAClE,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAEzC,OAAO,MAAM;SACV,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAChB,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,cAAc,GAAiC;QACrD,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,GAAG;QACb,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,QAAQ;KACnB,CAAC;IAEF;;OAEG;IACH,QAAQ,CACN,MAA2B,EAC3B,cAA6B,EAC7B,UAA8B,EAAE;QAEhC,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;QACpD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;QACpC,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,aAAa;QACb,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,cAAc,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;QAED,iBAAiB;QACjB,IAAI,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE5D,cAAc;QACd,IAAI,QAA6B,CAAC;QAElC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,KAAK,WAAW;gBACd,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAClD,MAAM;YACR,KAAK,WAAW;gBACd,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;gBAClE,MAAM;YACR,KAAK,QAAQ,CAAC;YACd;gBACE,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;QACjE,CAAC;QAED,4BAA4B;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAE9D,QAAQ;QACR,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,gBAAgB,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;QAED,OAAO;YACL,MAAM,EAAE,MAAM;YACd,aAAa;YACb,eAAe,EAAE,MAAM,CAAC,MAAM;YAC9B,WAAW,EAAE,gBAAgB;YAC7B,WAAW,EAAE,cAAc,GAAG,gBAAgB;YAC9C,gBAAgB,EAAE,cAAc,GAAG,CAAC;gBAClC,CAAC,CAAC,CAAC,cAAc,GAAG,gBAAgB,CAAC,GAAG,cAAc;gBACtD,CAAC,CAAC,CAAC;SACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,MAA2B,EAC3B,IAAkC;QAElC,OAAO,CAAC,GAAG,MAAM,CAAC;aACf,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,MAA2B,EAC3B,cAAwC,EACxC,IAAkC;QAElC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAE9B,oBAAoB;QACpB,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC,CAAC;QAElC,cAAc;QACd,OAAO,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,SAAS,GAAG,CAAC,QAAQ,CAAC;YAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAE/B,qBAAqB;gBACrB,IAAI,MAAM,GAAG,CAAC,CAAC;gBACf,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;oBACxB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;wBACzB,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;4BAChB,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;4BAC/D,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;wBACjC,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,wBAAwB;gBACxB,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC;gBAEhD,IAAI,QAAQ,GAAG,SAAS,EAAE,CAAC;oBACzB,SAAS,GAAG,QAAQ,CAAC;oBACrB,OAAO,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC;YAED,gBAAgB;YAChB,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YACrC,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;gBACxB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;wBAChB,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;oBAChF,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,YAAY,CAClB,MAA2B,EAC3B,cAAwC,EACxC,IAAkC;QAElC,iBAAiB;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpF,cAAc;QACd,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAC3C,SAAS,EACT,cAAc,EACd,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,CAC9C,CAAC;QAEF,OAAO,CAAC,GAAG,cAAc,EAAE,GAAG,cAAc,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,MAA2B,EAC3B,SAAiB;QAEjB,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAE7C,IAAI,WAAW,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;gBACtC,SAAS;gBACT,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,WAAW,IAAI,MAAM,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,QAAQ;gBACR,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;gBAC1C,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC,sBAAsB;oBAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;oBACxD,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBACxB,WAAW,IAAI,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACpD,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,aAAa,CACnB,KAAwB,EACxB,YAAoB;QAEpB,MAAM,aAAa,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEpD,IAAI,aAAa,IAAI,YAAY,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,YAAY;QACZ,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAEpE,OAAO;YACL,GAAG,KAAK;YACR,OAAO,EAAE,UAAU;SACpB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CACX,MAA2B,EAC3B,YAAoB,IAAI;QAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE;YACtC,SAAS;YACT,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,WAAW;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,eAAe,CACb,MAA2B,EAC3B,cAA4B,EAC5B,YAAoB,IAAI;QAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE;YAC3C,SAAS;YACT,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,QAAQ;YAClB,kBAAkB,EAAE,GAAG;SACxB,CAAC,CAAC;IACL,CAAC;CACF;AAED,WAAW;AACX,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/services/efficient-rag.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Efficient RAG Pipeline
+ * 비용 최적화된 RAG 파이프라인
+ *
+ * @module services/efficient-rag
+ */
+import { QueryService } from './query.js';
+import { ComplexityLevel } from './llm-router.js';
+import { LLMProvider } from './llm.js';
+import type { Embedding384 } from '../types/index.js';
+/**
+ * RAG 요청
+ */
+export interface EfficientRAGRequest {
+    query: string;
+    options?: {
+        k?: number;
+        maxTokens?: number;
+        forceComplexity?: ComplexityLevel;
+        skipCache?: boolean;
+        includeProof?: boolean;
+        systemPrompt?: string;
+        tags?: string[];
+    };
+}
+/**
+ * RAG 응답
+ */
+export interface EfficientRAGResponse {
+    answer: string;
+    sources: Array<{
+        id: string;
+        content: string;
+        score: number;
+        proof?: string;
+    }>;
+    metrics: {
+        searchTimeMs: number;
+        compressionTimeMs: number;
+        llmTimeMs: number;
+        totalTimeMs: number;
+        cacheHit: boolean;
+        cacheType?: 'exact' | 'semantic';
+        complexity: ComplexityLevel;
+        model: string;
+        tokensUsed: number;
+        estimatedCost: number;
+        savedCost: number;
+        compressionRatio: number;
+    };
+}
+/**
+ * 파이프라인 설정
+ */
+export interface PipelineConfig {
+    enableCache?: boolean;
+    enableCompression?: boolean;
+    enableSmartRouting?: boolean;
+    defaultK?: number;
+    defaultMaxTokens?: number;
+    apiKeys?: Partial<Record<LLMProvider, string>>;
+}
+/**
+ * Efficient RAG Pipeline 클래스
+ */
+export declare class EfficientRAGPipeline {
+    private queryService;
+    private compressor;
+    private cache;
+    private router;
+    private config;
+    private embedFn;
+    private stats;
+    constructor(queryService: QueryService, config?: PipelineConfig);
+    /**
+     * 임베딩 함수 설정
+     */
+    setEmbeddingFunction(fn: (text: string) => Promise<Embedding384>): void;
+    /**
+     * API 키 설정
+     */
+    setApiKey(provider: LLMProvider, apiKey: string): void;
+    /**
+     * 메인 RAG 실행
+     */
+    query(request: EfficientRAGRequest): Promise<EfficientRAGResponse>;
+    /**
+     * 빠른 쿼리 (캐시 우선, 압축 최대)
+     */
+    quickQuery(query: string): Promise<EfficientRAGResponse>;
+    /**
+     * 정밀 쿼리 (캐시 스킵, 압축 최소)
+     */
+    preciseQuery(query: string, tags?: string[]): Promise<EfficientRAGResponse>;
+    /**
+     * 통계 조회
+     */
+    getStats(): {
+        pipeline: {
+            totalRequests: number;
+            cacheHitRate: number;
+            avgSearchTimeMs: number;
+            avgLLMTimeMs: number;
+            totalCostUSD: number;
+            totalSavedUSD: number;
+            savingsRate: number;
+        };
+        cache: import("./query-cache.js").CacheStats;
+        router: {
+            totalRequests: number;
+            byComplexity: {
+                simple: number;
+                medium: number;
+                complex: number;
+            };
+            totalCost: number;
+            savedCost: number;
+        } & {
+            avgCostPerRequest: number;
+            savingsRate: number;
+        };
+    };
+    /**
+     * 캐시 워밍
+     */
+    warmupCache(queries: string[]): Promise<number>;
+    /**
+     * 캐시 클리어
+     */
+    clearCache(): void;
+    /**
+     * 통계 초기화
+     */
+    resetStats(): void;
+}
+/**
+ * 파이프라인 팩토리 함수
+ */
+export declare function createEfficientRAGPipeline(queryService: QueryService, config?: PipelineConfig): EfficientRAGPipeline;
+//# sourceMappingURL=efficient-rag.d.ts.map

package/dist/services/efficient-rag.d.ts.map

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