memento-mcp-server 1.13.1-a2 → 1.13.1-a4

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

@@ -0,0 +1,340 @@
+/**
+ * Forget 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 ForgetSchema = z.object({
+    id: CommonSchemas.MemoryId.optional(),
+    hard: CommonSchemas.HardDelete,
+    reason: z.string().optional().describe('삭제 사유'),
+    confirm: z.boolean().optional().describe('삭제 확인'),
+    batch: z.array(z.string()).optional().describe('배치 삭제할 ID 목록')
+}).refine((data) => data.id || data.batch, {
+    message: "id 또는 batch 중 하나는 필수입니다"
+});
+export class ForgetTool extends BaseTool {
+    constructor() {
+        super('forget', '기억을 삭제합니다', {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: '삭제할 기억의 ID (배치 삭제시 무시됨)',
+                    pattern: '^mem_[a-zA-Z0-9_]+$'
+                },
+                hard: {
+                    type: 'boolean',
+                    description: '완전 삭제 여부 (복구 불가능)',
+                    default: false
+                },
+                reason: {
+                    type: 'string',
+                    description: '삭제 사유',
+                    maxLength: 500
+                },
+                confirm: {
+                    type: 'boolean',
+                    description: '삭제 확인 (하드 삭제시 필수)',
+                    default: false
+                },
+                batch: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        pattern: '^mem_[a-zA-Z0-9_]+$'
+                    },
+                    description: '배치 삭제할 ID 목록',
+                    maxItems: 100
+                }
+            },
+            required: ['id']
+        });
+    }
+    /**
+     * 제공자별 vec0 테이블명 반환
+     */
+    getVectorTableName(provider) {
+        switch (provider) {
+            case 'tfidf':
+                return 'memory_item_vec_tfidf';
+            case 'minilm':
+                return 'memory_item_vec_minilm';
+            case 'openai':
+                return 'memory_item_vec_openai';
+            case 'gemini':
+                return 'memory_item_vec_gemini';
+            default:
+                return 'memory_item_vec_tfidf'; // 기본값
+        }
+    }
+    async handle(params, context) {
+        this.logInfo('Forget 도구 호출됨', { params });
+        try {
+            // 파라미터 검증 및 파싱
+            const { id, hard, reason, confirm, batch } = ForgetSchema.parse(params);
+            this.logInfo('파라미터 파싱 완료', { id, hard, reason, confirm, batch });
+            // 입력 검증
+            if (batch && batch.length > 0) {
+                this.validateArray(batch, '배치 삭제 ID 목록', 100);
+                for (const batchId of batch) {
+                    this.validateString(batchId, '배치 ID', 50);
+                }
+            }
+            else {
+                this.validateString(id, '메모리 ID', 50);
+            }
+            if (reason) {
+                this.validateString(reason, '삭제 사유', 500);
+            }
+            // 데이터베이스 연결 확인
+            this.validateDatabase(context);
+            // 하드 삭제 확인
+            if (hard && !confirm) {
+                throw new Error('하드 삭제는 confirm=true로 확인해야 합니다');
+            }
+            // 배치 삭제 처리
+            if (batch && batch.length > 0) {
+                this.logInfo('배치 삭제 시작', { count: batch.length, hard });
+                return await this.handleBatchDelete(batch, hard, reason, context);
+            }
+            // 단일 삭제 처리
+            this.logInfo('단일 삭제 시작', { id, hard });
+            if (!id) {
+                throw new Error('기억 ID가 필요합니다');
+            }
+            return await this.handleSingleDelete(id, hard, reason, context);
+        }
+        catch (error) {
+            this.logError(error, 'Forget 도구 실행 실패', { params });
+            // 사용자 친화적인 에러 메시지 반환
+            if (error instanceof Error) {
+                if (error.message.includes('validation')) {
+                    throw new Error(`입력 검증 실패: ${error.message}`);
+                }
+                else if (error.message.includes('database')) {
+                    throw new Error(`데이터베이스 오류: ${error.message}`);
+                }
+                else if (error.message.includes('not found')) {
+                    throw new Error(`메모리를 찾을 수 없습니다: ${error.message}`);
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * 단일 기억 삭제
+     */
+    async handleSingleDelete(id, hard, reason, context) {
+        try {
+            // 기억 존재 확인
+            const memory = await this.getMemoryById(id, context);
+            if (!memory) {
+                throw new Error(`Memory with ID ${id} not found`);
+            }
+            // 삭제 권한 확인
+            await this.validateDeletePermission(memory, context);
+            // 삭제 로그 기록
+            await this.logDeleteAction(id, hard, reason, context);
+            // 트랜잭션으로 삭제 실행
+            const result = await DatabaseUtils.runTransaction(context.db, async () => {
+                if (hard) {
+                    // 하드 삭제: 완전 제거
+                    return await this.performHardDelete(id, context);
+                }
+                else {
+                    // 소프트 삭제: TTL에 의해 나중에 삭제
+                    return await this.performSoftDelete(id, context);
+                }
+            });
+            // 임베딩 삭제 (하드 삭제인 경우)
+            if (hard && context.services.embeddingService?.isAvailable()) {
+                await this.deleteEmbedding(id, context);
+            }
+            // 관련 데이터 정리
+            await this.cleanupRelatedData(id, hard, context);
+            return this.createSuccessResult({
+                memory_id: id,
+                deleted_type: hard ? 'hard' : 'soft',
+                message: hard
+                    ? `기억이 완전히 삭제되었습니다: ${id}`
+                    : `기억이 삭제 대상으로 표시되었습니다: ${id}`,
+                reason: reason || 'No reason provided',
+                deleted_at: new Date().toISOString()
+            });
+        }
+        catch (error) {
+            // 데이터베이스 락 문제 처리
+            if (error.code === 'SQLITE_BUSY') {
+                await this.handleDatabaseLock(context);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 배치 삭제 처리
+     */
+    async handleBatchDelete(ids, hard, reason, context) {
+        const results = {
+            successful: [],
+            failed: [],
+            total: ids.length
+        };
+        for (const id of ids) {
+            try {
+                await this.handleSingleDelete(id, hard, reason, 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} 성공`,
+            deleted_type: hard ? 'hard' : 'soft',
+            reason: reason || 'Batch deletion'
+        });
+    }
+    /**
+     * 하드 삭제 실행
+     */
+    async performHardDelete(id, context) {
+        // 메인 테이블에서 삭제
+        const deleteResult = await DatabaseUtils.run(context.db, 'DELETE FROM memory_item WHERE id = ?', [id]);
+        if (deleteResult.changes === 0) {
+            throw new Error(`Memory with ID ${id} not found`);
+        }
+        // 관련 테이블에서도 삭제
+        await DatabaseUtils.run(context.db, 'DELETE FROM memory_item_tag WHERE memory_id = ?', [id]);
+        await DatabaseUtils.run(context.db, 'DELETE FROM memory_link WHERE source_id = ? OR target_id = ?', [id, id]);
+        await DatabaseUtils.run(context.db, 'DELETE FROM feedback_event WHERE memory_id = ?', [id]);
+        return { type: 'hard', changes: deleteResult.changes };
+    }
+    /**
+     * 소프트 삭제 실행
+     */
+    async performSoftDelete(id, context) {
+        // pinned 해제하고 삭제 플래그 설정
+        const updateResult = await DatabaseUtils.run(context.db, 'UPDATE memory_item SET pinned = FALSE, last_accessed = CURRENT_TIMESTAMP WHERE id = ?', [id]);
+        if (updateResult.changes === 0) {
+            throw new Error(`Memory with ID ${id} not found`);
+        }
+        return { type: 'soft', changes: updateResult.changes };
+    }
+    /**
+     * 기억 조회
+     */
+    async getMemoryById(id, context) {
+        return await DatabaseUtils.get(context.db, 'SELECT * FROM memory_item WHERE id = ?', [id]);
+    }
+    /**
+     * 삭제 권한 확인
+     */
+    async validateDeletePermission(memory, context) {
+        // 핀된 기억은 하드 삭제 전에 확인 필요
+        if (memory.pinned) {
+            throw new Error('핀된 기억은 먼저 핀을 해제해야 합니다');
+        }
+        // 중요도가 높은 기억은 확인 필요
+        if (memory.importance > 0.8) {
+            console.warn(`⚠️ 높은 중요도의 기억 삭제: ${memory.id} (중요도: ${memory.importance})`);
+        }
+    }
+    /**
+     * 삭제 로그 기록
+     */
+    async logDeleteAction(id, hard, reason, context) {
+        try {
+            await DatabaseUtils.run(context.db, `INSERT INTO feedback_event (memory_id, event, score, created_at) 
+         VALUES (?, ?, ?, CURRENT_TIMESTAMP)`, [id, 'neglected', 0]);
+        }
+        catch (error) {
+            console.warn('삭제 로그 기록 실패:', error);
+        }
+    }
+    /**
+     * 임베딩 삭제
+     */
+    async deleteEmbedding(id, context) {
+        try {
+            await context.services.embeddingService.deleteEmbedding(context.db, id);
+        }
+        catch (error) {
+            console.warn(`⚠️ 임베딩 삭제 실패 (${id}):`, error);
+        }
+    }
+    /**
+     * 관련 데이터 정리
+     */
+    async cleanupRelatedData(id, hard, context) {
+        if (!hard)
+            return; // 소프트 삭제는 관련 데이터 유지
+        try {
+            // FTS 테이블에서 삭제
+            await DatabaseUtils.run(context.db, 'DELETE FROM memory_item_fts WHERE rowid = (SELECT rowid FROM memory_item WHERE id = ?)', [id]);
+            // 제공자별 vec0 테이블에서 삭제
+            const embeddingInfo = await DatabaseUtils.get(context.db, 'SELECT embedding_provider FROM memory_embedding WHERE memory_id = ?', [id]);
+            if (embeddingInfo) {
+                const provider = embeddingInfo.embedding_provider || 'tfidf';
+                const tableName = this.getVectorTableName(provider);
+                await DatabaseUtils.run(context.db, `DELETE FROM ${tableName} WHERE rowid = ?`, [id]);
+            }
+            // 임베딩 테이블에서 삭제
+            await DatabaseUtils.run(context.db, 'DELETE FROM memory_embedding WHERE memory_id = ?', [id]);
+        }
+        catch (error) {
+            console.warn(`관련 데이터 정리 실패 (${id}):`, error);
+        }
+    }
+    /**
+     * 데이터베이스 락 처리
+     */
+    async handleDatabaseLock(context) {
+        try {
+            await DatabaseUtils.checkpointWAL(context.db);
+            console.log('WAL 체크포인트 완료');
+        }
+        catch (error) {
+            console.warn('WAL 체크포인트 실패:', error);
+        }
+    }
+    /**
+     * 삭제 가능한 기억 목록 조회
+     */
+    async getDeletableMemories(context, limit = 50) {
+        this.validateDatabase(context);
+        return await DatabaseUtils.all(context.db, `SELECT id, content, type, importance, pinned, created_at 
+       FROM memory_item 
+       WHERE pinned = FALSE 
+       ORDER BY importance ASC, created_at ASC 
+       LIMIT ?`, [limit]);
+    }
+    /**
+     * 삭제 통계 조회
+     */
+    async getDeleteStats(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 deletable_count,
+         AVG(importance) as avg_importance
+       FROM memory_item`);
+        const recentDeletes = await DatabaseUtils.all(context.db, `SELECT memory_id, event, created_at 
+       FROM feedback_event 
+       WHERE event IN ('soft_deleted', 'hard_deleted') 
+       ORDER BY created_at DESC 
+       LIMIT 10`);
+        return {
+            ...stats,
+            recent_deletes: recentDeletes
+        };
+    }
+}
+//# sourceMappingURL=forget-tool.js.map

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

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

package/dist/domains/memory/tools/get-memory-neighbors-tool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Get Memory Neighbors Tool - 이웃 기억 조회 도구
+ * 벡터 유사도를 기반으로 특정 기억의 이웃 기억을 조회
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import type { ToolContext, ToolResult } from '../../../tools/types.js';
+declare const GetMemoryNeighborsSchema: z.ZodObject<{
+    memory_id: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    similarity_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    memory_id: string;
+    similarity_threshold: number;
+}, {
+    memory_id: string;
+    limit?: number | undefined;
+    similarity_threshold?: number | undefined;
+}>;
+export { GetMemoryNeighborsSchema };
+export declare class GetMemoryNeighborsTool extends BaseTool {
+    constructor();
+    handle(params: any, context: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=get-memory-neighbors-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-memory-neighbors-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/memory/tools/get-memory-neighbors-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAOvE,QAAA,MAAM,wBAAwB;;;;;;;;;;;;EAI5B,CAAC;AAEH,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAEpC,qBAAa,sBAAuB,SAAQ,QAAQ;;IAgC5C,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAwFrE"}

package/dist/domains/memory/tools/get-memory-neighbors-tool.js

@@ -0,0 +1,125 @@
+/**
+ * Get Memory Neighbors Tool - 이웃 기억 조회 도구
+ * 벡터 유사도를 기반으로 특정 기억의 이웃 기억을 조회
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import { CommonSchemas } from '../../../tools/types.js';
+import { MemoryNeighborService } from '../services/memory-neighbor-service.js';
+import { getVectorSearchEngine } from '../../search/algorithms/vector-search-engine.js';
+import { MemoryEmbeddingService } from '../services/memory-embedding-service.js';
+import { MemoryNotFoundError } from '../services/memory-neighbor-service.js';
+const GetMemoryNeighborsSchema = z.object({
+    memory_id: CommonSchemas.MemoryId,
+    limit: z.number().min(1).max(50).optional().default(5),
+    similarity_threshold: z.number().min(0).max(1).optional().default(0.8),
+});
+export { GetMemoryNeighborsSchema };
+export class GetMemoryNeighborsTool extends BaseTool {
+    constructor() {
+        super('get_memory_neighbors', '특정 기억과 유사한 이웃 기억을 조회합니다', {
+            type: 'object',
+            properties: {
+                memory_id: {
+                    type: 'string',
+                    description: '조회할 기억의 ID'
+                },
+                limit: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 50,
+                    description: '반환할 이웃 기억의 최대 개수',
+                    default: 5
+                },
+                similarity_threshold: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                    description: '유사도 임계값 (0.0 ~ 1.0)',
+                    default: 0.8
+                }
+            },
+            required: ['memory_id']
+        });
+    }
+    async handle(params, context) {
+        this.logInfo('Get Memory Neighbors 도구 호출됨', { params });
+        try {
+            // 파라미터 검증 및 파싱
+            const { memory_id, limit, similarity_threshold } = GetMemoryNeighborsSchema.parse(params);
+            // 데이터베이스 연결 확인
+            this.validateDatabase(context);
+            // MemoryNeighborService 인스턴스 생성
+            let vectorSearchEngine;
+            try {
+                vectorSearchEngine = getVectorSearchEngine();
+            }
+            catch (error) {
+                this.logError(error, 'VectorSearchEngine 초기화 실패');
+                throw new Error(`벡터 검색 엔진 초기화 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+            const embeddingService = context.services.embeddingService || new MemoryEmbeddingService();
+            let neighborService;
+            try {
+                neighborService = new MemoryNeighborService(vectorSearchEngine, embeddingService);
+            }
+            catch (error) {
+                this.logError(error, 'MemoryNeighborService 생성 실패');
+                throw new Error(`이웃 기억 서비스 생성 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+            // 데이터베이스 설정
+            try {
+                neighborService.setDatabase(context.db);
+            }
+            catch (error) {
+                this.logError(error, '데이터베이스 설정 실패');
+                throw new Error(`데이터베이스 설정 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+            // 이웃 기억 조회
+            const result = await neighborService.getNeighbors(memory_id, {
+                limit,
+                similarity_threshold
+            });
+            this.logInfo('이웃 기억 조회 성공', {
+                memory_id: result.memory_id,
+                total_count: result.total_count,
+                query_time: result.query_time
+            });
+            return this.createSuccessResult({
+                memory_id: result.memory_id,
+                neighbors: result.neighbors,
+                total_count: result.total_count,
+                query_time: result.query_time
+            });
+        }
+        catch (error) {
+            this.logError(error, 'Get Memory Neighbors 도구 실행 실패', { params });
+            // MemoryNotFoundError는 그대로 전파 (명확한 에러 메시지)
+            if (error instanceof MemoryNotFoundError) {
+                throw new Error(`메모리를 찾을 수 없습니다: ${error.message}`);
+            }
+            // Zod 스키마 검증 에러 처리
+            if (error instanceof z.ZodError) {
+                const errorMessages = error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ');
+                throw new Error(`입력 검증 실패: ${errorMessages}`);
+            }
+            // 사용자 친화적인 에러 메시지 반환
+            if (error instanceof Error) {
+                if (error.message.includes('validation') || error.message.includes('검증')) {
+                    throw new Error(`입력 검증 실패: ${error.message}`);
+                }
+                else if (error.message.includes('database') || error.message.includes('데이터베이스')) {
+                    throw new Error(`데이터베이스 오류: ${error.message}`);
+                }
+                else if (error.message.includes('search') || error.message.includes('검색')) {
+                    throw new Error(`검색 오류: ${error.message}`);
+                }
+                else if (error.message.includes('not found') || error.message.includes('찾을 수 없습니다')) {
+                    throw error; // 이미 처리된 에러는 그대로 전파
+                }
+            }
+            throw new Error(`이웃 기억 조회 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+//# sourceMappingURL=get-memory-neighbors-tool.js.map

package/dist/domains/memory/tools/get-memory-neighbors-tool.js.map

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

package/dist/domains/memory/tools/memory-injection-prompt.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Memory Injection 프롬프트 도구
+ * MCP 프롬프트 인터페이스를 통한 관련 기억 주입
+ */
+import { BaseTool } from '../../../tools/base-tool.js';
+import type { ToolContext } from '../../../tools/types.js';
+export declare class MemoryInjectionPrompt extends BaseTool {
+    constructor();
+    handle(params: any, context: ToolContext): Promise<any>;
+    /**
+     * 기억들을 요약하여 토큰 예산 내에서 관리
+     */
+    private summarizeMemories;
+    /**
+     * 개별 기억 내용 요약
+     */
+    private summarizeMemoryContent;
+    /**
+     * 프롬프트 형식으로 포맷팅
+     */
+    private formatMemoryPrompt;
+    /**
+     * 기억 타입별 이모지
+     */
+    private getMemoryTypeEmoji;
+    /**
+     * 토큰 수 추정 (간단한 추정)
+     */
+    private estimateTokens;
+    /**
+     * 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 검색 결과 아이템 배열
+     */
+    private updateConsolidationScoreMetadata;
+}
+//# sourceMappingURL=memory-injection-prompt.d.ts.map

package/dist/domains/memory/tools/memory-injection-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-injection-prompt.d.ts","sourceRoot":"","sources":["../../../../src/domains/memory/tools/memory-injection-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAiB3D,qBAAa,qBAAsB,SAAQ,QAAQ;;IA0C3C,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAmG7D;;OAEG;YACW,iBAAiB;IAoC/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyC9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;;;;;;;OAUG;YACW,gCAAgC;CAuH/C"}