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

package/dist/domains/memory/tools/memory-injection-prompt.js

@@ -0,0 +1,332 @@
+/**
+ * Memory Injection 프롬프트 도구
+ * MCP 프롬프트 인터페이스를 통한 관련 기억 주입
+ */
+import { BaseTool } from '../../../tools/base-tool.js';
+import { z } from 'zod';
+import { CommonSchemas } from '../../../tools/types.js';
+import { isMemoryItemType } from '../../../shared/types/index.js';
+import { mementoConfig } from '../../../shared/config/index.js';
+import { DatabaseUtils } from '../../../shared/utils/database.js';
+const MemoryInjectionSchema = z.object({
+    query: z.string().describe('검색할 쿼리'),
+    token_budget: z.number().optional().describe('토큰 예산 (기본값: 1000)'),
+    max_memories: z.number().optional().describe('최대 기억 개수 (기본값: 5)'),
+    memory_types: z.array(CommonSchemas.MemoryType).optional().describe('포함할 기억 타입들'),
+    importance_threshold: z.number().optional().describe('중요도 임계값 (기본값: 0.5)')
+});
+export class MemoryInjectionPrompt extends BaseTool {
+    constructor() {
+        super('memory_injection', '관련 기억을 요약하여 프롬프트에 주입', {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: '검색할 쿼리'
+                },
+                token_budget: {
+                    type: 'number',
+                    description: '토큰 예산 (기본값: 1000)',
+                    default: 1000
+                },
+                max_memories: {
+                    type: 'number',
+                    description: '최대 기억 개수 (기본값: 5)',
+                    default: 5
+                },
+                memory_types: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['working', 'episodic', 'semantic', 'procedural', 'core', 'vault']
+                    },
+                    description: '포함할 기억 타입들 (core/vault는 자동으로 제거됩니다)',
+                    default: ['working', 'episodic', 'semantic', 'procedural']
+                },
+                importance_threshold: {
+                    type: 'number',
+                    description: '중요도 임계값 (기본값: 0.5)',
+                    default: 0.5
+                }
+            },
+            required: ['query']
+        });
+    }
+    async handle(params, context) {
+        const { query, token_budget = 1000, max_memories = 5, memory_types = ['working', 'episodic', 'semantic', 'procedural'], importance_threshold = 0.5 } = MemoryInjectionSchema.parse(params);
+        try {
+            console.log(`🧠 Memory Injection 시작: "${query}" (토큰 예산: ${token_budget})`);
+            if (!context.db) {
+                throw new Error('데이터베이스가 연결되지 않았습니다');
+            }
+            if (!context.services?.hybridSearchEngine) {
+                throw new Error('하이브리드 검색 엔진이 사용할 수 없습니다');
+            }
+            // memory_types 배열 전처리 ('core'/'vault' 제거)
+            let filteredMemoryTypes = memory_types;
+            if (memory_types && memory_types.length > 0) {
+                const invalidTypes = memory_types.filter(t => t === 'core' || t === 'vault');
+                if (invalidTypes.length > 0) {
+                    this.logWarning('memory_types 배열에서 core/vault는 memory_item 검색에 사용할 수 없습니다. 자동으로 제거합니다.', {
+                        invalid_types: invalidTypes,
+                        original_memory_types: memory_types,
+                        suggestion: 'Core/Vault 조회는 recall Tool의 type 파라미터를 사용하세요.'
+                    });
+                    filteredMemoryTypes = memory_types.filter(t => t !== 'core' && t !== 'vault');
+                    if (filteredMemoryTypes.length === 0) {
+                        throw new Error("memory_types 배열에 유효한 타입이 없습니다. 'core'와 'vault'는 memory_types에서 사용할 수 없습니다.");
+                    }
+                }
+                // 타입 가드 적용: MemoryTypeRequest[] -> MemoryType[]
+                const validMemoryTypes = filteredMemoryTypes.filter(isMemoryItemType);
+                if (validMemoryTypes.length === 0) {
+                    throw new Error("memory_types 배열에 유효한 타입이 없습니다.");
+                }
+                filteredMemoryTypes = validMemoryTypes;
+            }
+            // 1. 관련 기억 검색
+            const searchResult = await context.services.hybridSearchEngine.search(context.db, {
+                query,
+                filters: {
+                    type: filteredMemoryTypes.length === 4 ? undefined : filteredMemoryTypes,
+                    importance_min: importance_threshold
+                },
+                limit: max_memories * 2, // 더 많은 후보를 가져와서 요약
+                vectorWeight: 0.7, // 의미적 유사성에 더 중점
+                textWeight: 0.3
+            });
+            const memories = searchResult.items;
+            console.log(`🔍 검색된 기억: ${memories.length}개`);
+            // Consolidation Score System 업데이트 (기능 플래그 확인)
+            if (mementoConfig.consolidationScoreEnabled && context.services.consolidationScoreService && memories.length > 0) {
+                await this.updateConsolidationScoreMetadata(context.db, context.services.consolidationScoreService, context.services.writeCoalescingManager, memories);
+            }
+            if (memories.length === 0) {
+                return this.createSuccessResult({
+                    message: '관련 기억을 찾을 수 없습니다.',
+                    memories_used: 0,
+                    token_estimate: 0,
+                    query: query
+                });
+            }
+            // 2. 기억 요약 및 토큰 예산 관리
+            const summary = await this.summarizeMemories(memories, token_budget, max_memories);
+            // 3. 프롬프트 형식으로 포맷팅
+            const formattedPrompt = this.formatMemoryPrompt(summary, query);
+            console.log(`✅ Memory Injection 완료: ${summary.length}개 기억, ${this.estimateTokens(formattedPrompt)} 토큰`);
+            return this.createSuccessResult({
+                message: formattedPrompt,
+                memories_used: summary.length,
+                token_estimate: this.estimateTokens(formattedPrompt),
+                query: query
+            });
+        }
+        catch (error) {
+            console.error('❌ Memory Injection 실패:', error);
+            throw error;
+        }
+    }
+    /**
+     * 기억들을 요약하여 토큰 예산 내에서 관리
+     */
+    async summarizeMemories(memories, tokenBudget, maxMemories) {
+        const summaries = [];
+        let usedTokens = 0;
+        const maxTokensPerMemory = Math.floor(tokenBudget / maxMemories);
+        // 중요도와 점수 순으로 정렬
+        const sortedMemories = memories
+            .sort((a, b) => (b.finalScore + b.importance) - (a.finalScore + a.importance))
+            .slice(0, maxMemories);
+        for (const memory of sortedMemories) {
+            if (usedTokens >= tokenBudget)
+                break;
+            // 기억 내용 요약
+            const summary = this.summarizeMemoryContent(memory.content, maxTokensPerMemory);
+            const summaryTokens = this.estimateTokens(summary);
+            if (usedTokens + summaryTokens <= tokenBudget) {
+                summaries.push({
+                    id: memory.id,
+                    content: memory.content,
+                    type: memory.type,
+                    importance: memory.importance,
+                    summary
+                });
+                usedTokens += summaryTokens;
+            }
+        }
+        return summaries;
+    }
+    /**
+     * 개별 기억 내용 요약
+     */
+    summarizeMemoryContent(content, maxTokens) {
+        // 간단한 요약 로직 (실제로는 더 정교한 요약 알고리즘 사용 가능)
+        const words = content.split(' ');
+        const maxWords = Math.floor(maxTokens / 1.5); // 대략적인 단어 수 계산
+        if (words.length <= maxWords) {
+            return content;
+        }
+        // 중요도 기반 요약 (첫 문장 + 마지막 문장 + 중간 핵심 내용)
+        const sentences = content.split(/[.!?]+/).filter(s => s.trim().length > 0);
+        if (sentences.length <= 2) {
+            return words.slice(0, maxWords).join(' ') + '...';
+        }
+        const firstSentence = sentences[0]?.trim() || '';
+        const lastSentence = sentences[sentences.length - 1]?.trim() || '';
+        const middleSentences = sentences.slice(1, -1);
+        let summary = firstSentence;
+        let remainingWords = maxWords - firstSentence.split(' ').length;
+        if (remainingWords > 0 && middleSentences.length > 0) {
+            const middleText = middleSentences.join('. ');
+            const middleWords = middleText.split(' ');
+            const middleWordsToInclude = Math.min(remainingWords - lastSentence.split(' ').length, middleWords.length);
+            if (middleWordsToInclude > 0) {
+                summary += ' ' + middleWords.slice(0, middleWordsToInclude).join(' ');
+                remainingWords -= middleWordsToInclude;
+            }
+        }
+        if (remainingWords > 0) {
+            summary += ' ' + lastSentence;
+        }
+        return summary + (summary.length < content.length ? '...' : '');
+    }
+    /**
+     * 프롬프트 형식으로 포맷팅
+     */
+    formatMemoryPrompt(summaries, query) {
+        if (summaries.length === 0) {
+            return '관련 기억을 찾을 수 없습니다.';
+        }
+        let prompt = `# 관련 기억 (${summaries.length}개)\n\n`;
+        prompt += `**검색 쿼리**: "${query}"\n\n`;
+        summaries.forEach((memory, index) => {
+            const typeEmoji = this.getMemoryTypeEmoji(memory.type);
+            const importanceStars = '★'.repeat(Math.ceil(memory.importance * 5));
+            prompt += `## ${index + 1}. ${typeEmoji} ${memory.type.toUpperCase()} 기억\n`;
+            prompt += `**중요도**: ${importanceStars} (${memory.importance.toFixed(2)})\n`;
+            prompt += `**내용**: ${memory.summary}\n\n`;
+        });
+        prompt += '---\n';
+        prompt += '*이 기억들은 현재 대화와 관련된 맥락 정보입니다. 참고하여 더 정확하고 관련성 높은 답변을 제공하세요.*';
+        return prompt;
+    }
+    /**
+     * 기억 타입별 이모지
+     */
+    getMemoryTypeEmoji(type) {
+        const emojiMap = {
+            'working': '🧠',
+            'episodic': '📝',
+            'semantic': '📚',
+            'procedural': '⚙️'
+        };
+        return emojiMap[type] || '💭';
+    }
+    /**
+     * 토큰 수 추정 (간단한 추정)
+     */
+    estimateTokens(text) {
+        // 대략적인 토큰 수 추정 (실제로는 더 정확한 토크나이저 사용 가능)
+        return Math.ceil(text.length / 4);
+    }
+    /**
+     * Consolidation Score 메타데이터 업데이트
+     * 검색 결과로 반환된 메모리들의 recall_count, last_accessed_at, g_value 업데이트
+     * Write Coalescing을 사용하여 I/O 부하를 줄입니다.
+     * (recall-tool.ts와 동일한 로직)
+     *
+     * @param db 데이터베이스 연결
+     * @param consolidationScoreService Consolidation Score 서비스
+     * @param writeCoalescingManager Write Coalescing Manager (선택적)
+     * @param searchItems 검색 결과 아이템 배열
+     */
+    async updateConsolidationScoreMetadata(db, consolidationScoreService, writeCoalescingManager, searchItems) {
+        if (!searchItems || searchItems.length === 0) {
+            return;
+        }
+        try {
+            const now = new Date();
+            const nowISO = now.toISOString();
+            // 각 검색 결과에 대해 업데이트
+            for (const item of searchItems) {
+                const memoryId = item.id || item.memory_id;
+                if (!memoryId) {
+                    continue; // ID가 없으면 스킵
+                }
+                try {
+                    // 기존 메모리 정보 조회 (recall_count, last_accessed_at, g_value, created_at, type, pinned)
+                    const memory = DatabaseUtils.get(db, `SELECT 
+              recall_count, 
+              last_accessed_at, 
+              g_value, 
+              created_at, 
+              type, 
+              pinned 
+            FROM memory_item 
+            WHERE id = ?`, [memoryId]);
+                    if (!memory) {
+                        this.logWarning(`메모리를 찾을 수 없습니다: ${memoryId}`);
+                        continue;
+                    }
+                    // recall_count 증가
+                    const newRecallCount = (memory.recall_count || 0) + 1;
+                    // 경과 시간 계산 (last_accessed_at이 있으면 사용, 없으면 created_at 사용)
+                    const lastAccessedAt = memory.last_accessed_at
+                        ? new Date(memory.last_accessed_at)
+                        : new Date(memory.created_at);
+                    const timeElapsed = consolidationScoreService.calculateTimeElapsed(lastAccessedAt, new Date(memory.created_at), now);
+                    // g_value 업데이트
+                    const newGValue = consolidationScoreService.updateGValueForRecall({
+                        previousGValue: memory.g_value,
+                        timeElapsed
+                    });
+                    // consolidation_score 계산
+                    const scoreResult = consolidationScoreService.calculateScore({
+                        recallCount: newRecallCount,
+                        lastAccessedAt: now,
+                        createdAt: new Date(memory.created_at),
+                        gValue: newGValue,
+                        type: memory.type,
+                        pinned: memory.pinned === 1 || memory.pinned === true
+                    });
+                    // Write Coalescing 사용 여부 확인
+                    if (writeCoalescingManager) {
+                        // 버퍼에 추가 (주기적으로 flush됨)
+                        writeCoalescingManager.addWrite({
+                            memoryId,
+                            fields: {
+                                recall_count: newRecallCount,
+                                last_accessed_at: nowISO,
+                                g_value: newGValue,
+                                consolidation_score: scoreResult.score
+                            }
+                        });
+                    }
+                    else {
+                        // Write Coalescing이 없으면 즉시 업데이트
+                        DatabaseUtils.run(db, `UPDATE memory_item 
+               SET 
+                 recall_count = ?,
+                 last_accessed_at = ?,
+                 g_value = ?,
+                 consolidation_score = ?
+               WHERE id = ?`, [newRecallCount, nowISO, newGValue, scoreResult.score, memoryId]);
+                    }
+                }
+                catch (error) {
+                    // 개별 메모리 업데이트 실패해도 다른 메모리는 계속 업데이트
+                    this.logWarning(`메모리 업데이트 실패 (${memoryId})`, {
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            }
+        }
+        catch (error) {
+            // 전체 업데이트 실패해도 검색 결과는 정상 반환
+            this.logError(error, 'Consolidation Score 메타데이터 업데이트 실패', {
+                itemCount: searchItems.length
+            });
+        }
+    }
+}
+//# sourceMappingURL=memory-injection-prompt.js.map

package/dist/domains/memory/tools/memory-injection-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-injection-prompt.js","sourceRoot":"","sources":["../../../../src/domains/memory/tools/memory-injection-prompt.ts"],"names":[],"mappings":"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"}

package/dist/domains/memory/tools/pin-tool.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pin Tool - 기억 고정 도구
+ * 중요한 기억을 고정하여 삭제로부터 보호
+ */
+import { BaseTool } from '../../../tools/base-tool.js';
+import type { ToolContext, ToolResult } from '../../../tools/types.js';
+export declare class PinTool extends BaseTool {
+    constructor();
+    handle(params: any, context: ToolContext): Promise<ToolResult>;
+    /**
+     * 단일 기억 고정
+     */
+    private handleSinglePin;
+    /**
+     * 배치 고정 처리
+     */
+    private handleBatchPin;
+    /**
+     * 기억 조회
+     */
+    private getMemoryById;
+    /**
+     * 고정 로그 기록
+     */
+    private logPinAction;
+    /**
+     * 데이터베이스 락 처리
+     */
+    private handleDatabaseLock;
+    /**
+     * 고정된 기억 목록 조회
+     */
+    getPinnedMemories(context: ToolContext, limit?: number): Promise<any[]>;
+    /**
+     * 고정 통계 조회
+     */
+    getPinStats(context: ToolContext): Promise<any>;
+}
+//# sourceMappingURL=pin-tool.d.ts.map

package/dist/domains/memory/tools/pin-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/memory/tools/pin-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAavE,qBAAa,OAAQ,SAAQ,QAAQ;;IAwC7B,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBpE;;OAEG;YACW,eAAe;IAyD7B;;OAEG;YACW,cAAc;IA4C5B;;OAEG;YACW,aAAa;IAQ3B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;YACW,kBAAkB;IAShC;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAcjF;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;CA2BtD"}

package/dist/domains/memory/tools/pin-tool.js

@@ -0,0 +1,211 @@
+/**
+ * Pin Tool - 기억 고정 도구
+ * 중요한 기억을 고정하여 삭제로부터 보호
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import { CommonSchemas } from '../../../tools/types.js';
+import { DatabaseUtils } from '../../../shared/utils/database.js';
+const PinSchema = z.object({
+    id: CommonSchemas.MemoryId.optional(),
+    reason: z.string().optional().describe('고정 사유'),
+    priority: z.number().min(1).max(5).optional().describe('우선순위 (1-5)'),
+    batch: z.array(z.string()).optional().describe('배치 고정할 ID 목록')
+}).refine((data) => data.id || data.batch, {
+    message: "id 또는 batch 중 하나는 필수입니다"
+});
+export class PinTool extends BaseTool {
+    constructor() {
+        super('pin', '기억을 고정합니다', {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: '고정할 기억의 ID (배치 고정시 무시됨)',
+                    pattern: '^mem_[a-zA-Z0-9_]+$'
+                },
+                reason: {
+                    type: 'string',
+                    description: '고정 사유',
+                    maxLength: 500
+                },
+                priority: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 5,
+                    description: '우선순위 (1-5)',
+                    default: 3
+                },
+                batch: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        pattern: '^mem_[a-zA-Z0-9_]+$'
+                    },
+                    description: '배치 고정할 ID 목록',
+                    maxItems: 100
+                }
+            },
+            required: ['id']
+        });
+    }
+    async handle(params, context) {
+        const { id, reason, priority = 3, batch } = PinSchema.parse(params);
+        // 데이터베이스 연결 확인
+        this.validateDatabase(context);
+        // 배치 고정 처리
+        if (batch && batch.length > 0) {
+            return await this.handleBatchPin(batch, reason, priority, context);
+        }
+        // 단일 고정 처리
+        if (!id) {
+            throw new Error('기억 ID가 필요합니다');
+        }
+        return await this.handleSinglePin(id, reason, priority, context);
+    }
+    /**
+     * 단일 기억 고정
+     */
+    async handleSinglePin(id, reason, priority, context) {
+        try {
+            // 기억 존재 확인
+            const memory = await this.getMemoryById(id, context);
+            if (!memory) {
+                throw new Error(`Memory with ID ${id} not found`);
+            }
+            // 이미 고정된 기억 확인
+            if (memory.pinned) {
+                return this.createSuccessResult({
+                    memory_id: id,
+                    message: `기억이 이미 고정되어 있습니다: ${id}`,
+                    already_pinned: true
+                });
+            }
+            // 고정 로그 기록
+            await this.logPinAction(id, reason, priority, context);
+            // 트랜잭션으로 고정 실행
+            await DatabaseUtils.runTransaction(context.db, async () => {
+                const result = await DatabaseUtils.run(context.db, 'UPDATE memory_item SET pinned = TRUE, last_accessed = CURRENT_TIMESTAMP WHERE id = ?', [id]);
+                if (result.changes === 0) {
+                    throw new Error(`Memory with ID ${id} not found`);
+                }
+                return result;
+            });
+            return this.createSuccessResult({
+                memory_id: id,
+                message: `기억이 고정되었습니다: ${id}`,
+                reason: reason || 'No reason provided',
+                priority,
+                pinned_at: new Date().toISOString()
+            });
+        }
+        catch (error) {
+            // 데이터베이스 락 문제 처리
+            if (error.code === 'SQLITE_BUSY') {
+                await this.handleDatabaseLock(context);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 배치 고정 처리
+     */
+    async handleBatchPin(ids, reason, priority, context) {
+        const results = {
+            successful: [],
+            failed: [],
+            already_pinned: [],
+            total: ids.length
+        };
+        for (const id of ids) {
+            try {
+                const memory = await this.getMemoryById(id, context);
+                if (!memory) {
+                    results.failed.push({ id, error: 'Memory not found' });
+                    continue;
+                }
+                if (memory.pinned) {
+                    results.already_pinned.push(id);
+                    continue;
+                }
+                await this.handleSinglePin(id, reason, priority, context);
+                results.successful.push(id);
+            }
+            catch (error) {
+                results.failed.push({
+                    id,
+                    error: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+        return this.createSuccessResult({
+            batch_result: results,
+            message: `배치 고정 완료: ${results.successful.length}/${results.total} 성공`,
+            reason: reason || 'Batch pinning',
+            priority
+        });
+    }
+    /**
+     * 기억 조회
+     */
+    async getMemoryById(id, context) {
+        return await DatabaseUtils.get(context.db, 'SELECT * FROM memory_item WHERE id = ?', [id]);
+    }
+    /**
+     * 고정 로그 기록
+     */
+    async logPinAction(id, reason, priority, context) {
+        try {
+            await DatabaseUtils.run(context.db, `INSERT INTO feedback_event (memory_id, event, score, created_at) 
+         VALUES (?, ?, ?, CURRENT_TIMESTAMP)`, [id, 'helpful', priority]);
+        }
+        catch (error) {
+            console.warn('고정 로그 기록 실패:', error);
+        }
+    }
+    /**
+     * 데이터베이스 락 처리
+     */
+    async handleDatabaseLock(context) {
+        try {
+            await DatabaseUtils.checkpointWAL(context.db);
+            console.log('WAL 체크포인트 완료');
+        }
+        catch (error) {
+            console.warn('WAL 체크포인트 실패:', error);
+        }
+    }
+    /**
+     * 고정된 기억 목록 조회
+     */
+    async getPinnedMemories(context, limit = 50) {
+        this.validateDatabase(context);
+        return await DatabaseUtils.all(context.db, `SELECT id, content, type, importance, created_at, last_accessed 
+       FROM memory_item 
+       WHERE pinned = TRUE 
+       ORDER BY importance DESC, created_at DESC 
+       LIMIT ?`, [limit]);
+    }
+    /**
+     * 고정 통계 조회
+     */
+    async getPinStats(context) {
+        this.validateDatabase(context);
+        const stats = await DatabaseUtils.get(context.db, `SELECT 
+         COUNT(*) as total_memories,
+         COUNT(CASE WHEN pinned = TRUE THEN 1 END) as pinned_count,
+         COUNT(CASE WHEN pinned = FALSE THEN 1 END) as unpinned_count,
+         AVG(importance) as avg_importance
+       FROM memory_item`);
+        const recentPins = await DatabaseUtils.all(context.db, `SELECT memory_id, event, score, created_at 
+       FROM feedback_event 
+       WHERE event = 'pinned' 
+       ORDER BY created_at DESC 
+       LIMIT 10`);
+        return {
+            ...stats,
+            recent_pins: recentPins
+        };
+    }
+}
+//# sourceMappingURL=pin-tool.js.map

package/dist/domains/memory/tools/pin-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-tool.js","sourceRoot":"","sources":["../../../../src/domains/memory/tools/pin-tool.ts"],"names":[],"mappings":"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"}

package/dist/domains/memory/tools/recall-tool.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Recall Tool - 기억 검색 도구
+ * 하이브리드 검색을 통한 고성능 기억 검색
+ */
+import { BaseTool } from '../../../tools/base-tool.js';
+import type { ToolContext, ToolResult } from '../../../tools/types.js';
+export declare class RecallTool extends BaseTool {
+    constructor();
+    handle(params: any, context: ToolContext): Promise<ToolResult>;
+    /**
+     * 검색 결과 후처리
+     */
+    private processSearchResults;
+    /**
+     * 적용된 필터 정보 반환
+     */
+    private getAppliedFilters;
+    /**
+     * 검색 쿼리 검증
+     */
+    private validateQuery;
+    /**
+     * 필터 검증
+     */
+    private validateFilters;
+    /**
+     * Consolidation Score 메타데이터 업데이트
+     * 검색 결과로 반환된 메모리들의 recall_count, last_accessed_at, g_value 업데이트
+     * Write Coalescing을 사용하여 I/O 부하를 줄입니다.
+     *
+     * @param db 데이터베이스 연결
+     * @param consolidationScoreService Consolidation Score 서비스
+     * @param writeCoalescingManager Write Coalescing Manager (선택적)
+     * @param searchItems 검색 결과 아이템 배열
+     */
+    private updateConsolidationScoreMetadata;
+}
+//# sourceMappingURL=recall-tool.d.ts.map

package/dist/domains/memory/tools/recall-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/memory/tools/recall-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAgEvE,qBAAa,UAAW,SAAQ,QAAQ;;IA8GhC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA8VpE;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwE5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;;;;;;;;OASG;YACW,gCAAgC;CAuH/C"}