memento-mcp-server 0.1.0

package/dist/tools/unpin-tool.js

@@ -0,0 +1,233 @@
+/**
+ * Unpin Tool - 기억 고정 해제 도구
+ * 고정된 기억의 고정을 해제하여 일반 관리 대상으로 변경
+ */
+import { z } from 'zod';
+import { BaseTool } from './base-tool.js';
+import { CommonSchemas } from './types.js';
+import { DatabaseUtils } from '../utils/database.js';
+const UnpinSchema = z.object({
+    id: CommonSchemas.MemoryId.optional(),
+    reason: z.string().optional().describe('고정 해제 사유'),
+    batch: z.array(z.string()).optional().describe('배치 고정 해제할 ID 목록'),
+    confirm: z.boolean().optional().describe('고정 해제 확인')
+}).refine((data) => data.id || data.batch, {
+    message: "id 또는 batch 중 하나는 필수입니다"
+});
+export class UnpinTool extends BaseTool {
+    constructor() {
+        super('unpin', '기억 고정을 해제합니다', {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: '고정 해제할 기억의 ID (배치 고정 해제시 무시됨)',
+                    pattern: '^mem_[a-zA-Z0-9_]+$'
+                },
+                reason: {
+                    type: 'string',
+                    description: '고정 해제 사유',
+                    maxLength: 500
+                },
+                batch: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        pattern: '^mem_[a-zA-Z0-9_]+$'
+                    },
+                    description: '배치 고정 해제할 ID 목록',
+                    maxItems: 100
+                },
+                confirm: {
+                    type: 'boolean',
+                    description: '고정 해제 확인',
+                    default: false
+                }
+            },
+            required: ['id']
+        });
+    }
+    async handle(params, context) {
+        const { id, reason, batch, confirm = false } = UnpinSchema.parse(params);
+        // 데이터베이스 연결 확인
+        this.validateDatabase(context);
+        // 배치 고정 해제 처리
+        if (batch && batch.length > 0) {
+            return await this.handleBatchUnpin(batch, reason, confirm, context);
+        }
+        // 단일 고정 해제 처리
+        if (!id) {
+            throw new Error('기억 ID가 필요합니다');
+        }
+        return await this.handleSingleUnpin(id, reason, confirm, context);
+    }
+    /**
+     * 단일 기억 고정 해제
+     */
+    async handleSingleUnpin(id, reason, confirm, 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_unpinned: true
+                });
+            }
+            // 중요도가 높은 기억은 확인 필요
+            if (memory.importance > 0.8 && !confirm) {
+                throw new Error('높은 중요도의 기억은 confirm=true로 확인해야 합니다');
+            }
+            // 고정 해제 로그 기록
+            await this.logUnpinAction(id, reason, context);
+            // 트랜잭션으로 고정 해제 실행
+            await DatabaseUtils.runTransaction(context.db, async () => {
+                const result = await DatabaseUtils.run(context.db, 'UPDATE memory_item SET pinned = FALSE, 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',
+                unpinned_at: new Date().toISOString(),
+                importance: memory.importance
+            });
+        }
+        catch (error) {
+            // 데이터베이스 락 문제 처리
+            if (error.code === 'SQLITE_BUSY') {
+                await this.handleDatabaseLock(context);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 배치 고정 해제 처리
+     */
+    async handleBatchUnpin(ids, reason, confirm, context) {
+        const results = {
+            successful: [],
+            failed: [],
+            already_unpinned: [],
+            requires_confirmation: [],
+            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_unpinned.push(id);
+                    continue;
+                }
+                // 중요도가 높은 기억은 확인 필요
+                if (memory.importance > 0.8 && !confirm) {
+                    results.requires_confirmation.push(id);
+                    continue;
+                }
+                await this.handleSingleUnpin(id, reason, confirm, 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 unpinning',
+            requires_confirmation: results.requires_confirmation.length > 0
+        });
+    }
+    /**
+     * 기억 조회
+     */
+    async getMemoryById(id, context) {
+        return await DatabaseUtils.get(context.db, 'SELECT * FROM memory_item WHERE id = ?', [id]);
+    }
+    /**
+     * 고정 해제 로그 기록
+     */
+    async logUnpinAction(id, reason, context) {
+        try {
+            await DatabaseUtils.run(context.db, `INSERT INTO feedback_event (memory_id, event, score, created_at) 
+         VALUES (?, ?, ?, CURRENT_TIMESTAMP)`, [id, 'edited', 0]);
+        }
+        catch (error) {
+            console.warn('고정 해제 로그 기록 실패:', error);
+        }
+    }
+    /**
+     * 데이터베이스 락 처리
+     */
+    async handleDatabaseLock(context) {
+        try {
+            await DatabaseUtils.checkpointWAL(context.db);
+            console.log('WAL 체크포인트 완료');
+        }
+        catch (error) {
+            console.warn('WAL 체크포인트 실패:', error);
+        }
+    }
+    /**
+     * 고정 해제 가능한 기억 목록 조회
+     */
+    async getUnpinnableMemories(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 ASC, created_at ASC 
+       LIMIT ?`, [limit]);
+    }
+    /**
+     * 고정 해제 통계 조회
+     */
+    async getUnpinStats(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 recentUnpins = await DatabaseUtils.all(context.db, `SELECT memory_id, event, created_at 
+       FROM feedback_event 
+       WHERE event = 'unpinned' 
+       ORDER BY created_at DESC 
+       LIMIT 10`);
+        return {
+            ...stats,
+            recent_unpins: recentUnpins
+        };
+    }
+    /**
+     * 고정 해제 권장 기억 조회
+     */
+    async getRecommendedUnpins(context, limit = 20) {
+        this.validateDatabase(context);
+        return await DatabaseUtils.all(context.db, `SELECT id, content, type, importance, created_at, last_accessed,
+              (julianday('now') - julianday(created_at)) as days_old
+       FROM memory_item 
+       WHERE pinned = TRUE 
+         AND importance < 0.5
+         AND (julianday('now') - julianday(created_at)) > 30
+       ORDER BY importance ASC, days_old DESC 
+       LIMIT ?`, [limit]);
+    }
+}
+//# sourceMappingURL=unpin-tool.js.map

package/dist/tools/unpin-tool.js.map

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

package/dist/types/embedding.types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 임베딩 서비스 공통 타입 정의
+ * 모든 임베딩 서비스가 구현해야 하는 인터페이스
+ */
+export interface EmbeddingResult {
+    embedding: number[];
+    model: string;
+    provider?: EmbeddingProvider;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface SimilarityResult {
+    id: string;
+    content: string;
+    similarity: number;
+    score: number;
+}
+export interface EmbeddingData {
+    id: string;
+    content: string;
+    embedding: number[];
+}
+/**
+ * 임베딩 서비스 공통 인터페이스
+ * 의존성 역전 원칙을 위한 추상화
+ */
+export interface EmbeddingServiceInterface {
+    /**
+     * 텍스트를 임베딩 벡터로 변환
+     */
+    generateEmbedding(text: string): Promise<EmbeddingResult | null>;
+    /**
+     * 쿼리와 유사한 임베딩 검색
+     */
+    searchSimilar(query: string, embeddings: EmbeddingData[], limit?: number, threshold?: number): Promise<SimilarityResult[]>;
+    /**
+     * 서비스 사용 가능 여부 확인
+     */
+    isAvailable(): boolean;
+    /**
+     * 모델 정보 반환
+     */
+    getModelInfo(): {
+        model: string;
+        dimensions: number;
+        maxTokens: number;
+    };
+}
+/**
+ * 임베딩 제공자 타입
+ */
+export type EmbeddingProvider = 'tfidf' | 'minilm' | 'openai' | 'gemini';
+/**
+ * 임베딩 제공자 정보
+ */
+export interface ProviderInfo {
+    name: EmbeddingProvider;
+    available: boolean;
+    priority: number;
+    cost: 'free' | 'paid';
+    performance: 'low' | 'medium' | 'high';
+}
+//# sourceMappingURL=embedding.types.d.ts.map

package/dist/types/embedding.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.types.d.ts","sourceRoot":"","sources":["../../src/types/embedding.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEjE;;OAEG;IACH,aAAa,CACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE/B;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,YAAY,IAAI;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,WAAW,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACxC"}

package/dist/types/embedding.types.js

@@ -0,0 +1,6 @@
+/**
+ * 임베딩 서비스 공통 타입 정의
+ * 모든 임베딩 서비스가 구현해야 하는 인터페이스
+ */
+export {};
+//# sourceMappingURL=embedding.types.js.map

package/dist/types/embedding.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.types.js","sourceRoot":"","sources":["../../src/types/embedding.types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Memento MCP Server 타입 정의
+ */
+export type MemoryType = 'working' | 'episodic' | 'semantic' | 'procedural';
+export type PrivacyScope = 'private' | 'team' | 'public';
+export interface MemoryItem {
+    id: string;
+    type: MemoryType;
+    content: string;
+    importance: number;
+    privacy_scope: PrivacyScope;
+    created_at: Date;
+    last_accessed?: Date;
+    pinned: boolean;
+    tags?: string[];
+    source?: string;
+    embedding?: number[];
+}
+export interface MemorySearchFilters {
+    id?: string[] | undefined;
+    type?: MemoryType[] | undefined;
+    tags?: string[] | undefined;
+    privacy_scope?: PrivacyScope[] | undefined;
+    time_from?: string | undefined;
+    time_to?: string | undefined;
+    pinned?: boolean | undefined;
+}
+export interface MemorySearchResult {
+    id: string;
+    content: string;
+    type: MemoryType;
+    importance: number;
+    created_at: Date;
+    last_accessed?: Date;
+    pinned: boolean;
+    tags?: string[];
+    score: number;
+    recall_reason: string;
+}
+export interface SearchRankingWeights {
+    relevance: number;
+    recency: number;
+    importance: number;
+    usage: number;
+    duplication_penalty: number;
+}
+export type EmbeddingProvider = 'tfidf' | 'lightweight' | 'minilm' | 'openai' | 'gemini';
+export interface MementoConfig {
+    dbPath: string;
+    serverName: string;
+    serverVersion: string;
+    port: number;
+    embeddingProvider: EmbeddingProvider;
+    openaiApiKey: string | undefined;
+    openaiModel: string;
+    geminiApiKey: string | undefined;
+    geminiModel: string;
+    embeddingDimensions: number;
+    searchDefaultLimit: number;
+    searchMaxLimit: number;
+    forgetTTL: {
+        working: number;
+        episodic: number;
+        semantic: number;
+        procedural: number;
+    };
+    logLevel: string;
+    logFile: string | undefined;
+    nodeEnv: string;
+}
+export interface RememberParams {
+    content: string;
+    type?: MemoryType;
+    tags?: string[];
+    importance?: number;
+    source?: string;
+    privacy_scope?: PrivacyScope;
+}
+export interface RecallParams {
+    query: string;
+    filters?: MemorySearchFilters;
+    limit?: number;
+}
+export interface ForgetParams {
+    id: string;
+    hard?: boolean;
+}
+export interface PinParams {
+    id: string;
+}
+export interface UnpinParams {
+    id: string;
+}
+export interface FeedbackParams {
+    memory_id: string;
+    helpful: boolean;
+    score?: number;
+}
+export interface MemoryInjectionParams {
+    query: string;
+    token_budget?: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Memento MCP Server 타입 정의
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/database.d.ts

@@ -0,0 +1,62 @@
+/**
+ * SQLite3 데이터베이스 유틸리티 함수들
+ */
+import Database from 'better-sqlite3';
+export declare class DatabaseUtils {
+    private static transactionStates;
+    /**
+     * 트랜잭션 상태 확인
+     */
+    private static getTransactionState;
+    /**
+     * 트랜잭션 상태 설정
+     */
+    private static setTransactionState;
+    /**
+     * SQLite3 쿼리를 실행 (재시도 로직 포함)
+     */
+    static run(db: Database.Database, sql: string, params?: any[], maxRetries?: number): Database.RunResult;
+    /**
+     * SQLite3 쿼리 결과를 가져오기 (재시도 로직 포함)
+     */
+    static get(db: Database.Database, sql: string, params?: any[], maxRetries?: number): any;
+    /**
+     * SQLite3 쿼리 결과 배열을 가져오기 (재시도 로직 포함)
+     */
+    static all(db: Database.Database, sql: string, params?: any[], maxRetries?: number): any[];
+    /**
+     * SQLite3 exec 실행
+     */
+    static exec(db: Database.Database, sql: string): void;
+    /**
+     * 트랜잭션을 재시도 로직과 함께 실행 (개선된 버전)
+     */
+    static runTransaction<T>(db: Database.Database, transactionFn: () => T | Promise<T>, maxRetries?: number): Promise<T>;
+    /**
+     * WAL 체크포인트 실행 (락 해제용)
+     */
+    static checkpointWAL(db: Database.Database): void;
+    /**
+     * 트랜잭션 상태 확인
+     */
+    static isInTransaction(db: Database.Database): boolean;
+    /**
+     * 트랜잭션 강제 정리 (비상시 사용)
+     */
+    static forceCleanupTransaction(db: Database.Database): void;
+    /**
+     * 데이터베이스 상태 확인
+     */
+    static getDatabaseStatus(db: Database.Database): {
+        journalMode: string;
+        walAutoCheckpoint: number;
+        busyTimeout: number;
+        isLocked: boolean;
+        inTransaction: boolean;
+    };
+    /**
+     * 데이터베이스 초기화 (스키마 생성)
+     */
+    static initializeDatabase(db: Database.Database): Promise<void>;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/utils/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/utils/database.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAKtC,qBAAa,aAAa;IAExB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAwF;IAExH;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAOlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAIlC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,EAAE,UAAU,GAAE,MAAU,GAAG,QAAQ,CAAC,SAAS;IA6B9G;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,EAAE,UAAU,GAAE,MAAU,GAAG,GAAG;IA4B/F;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,EAAE,UAAU,GAAE,MAAU,GAAG,GAAG,EAAE;IA4BjG;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAIrD;;OAEG;WACU,cAAc,CAAC,CAAC,EAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,aAAa,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACnC,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,CAAC,CAAC;IAsEb;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAUjD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO;IAItD;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAe3D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG;QAC/C,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,OAAO,CAAC;KACxB;IA8BD;;OAEG;WACU,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAyKtE"}