memento-mcp-server 0.1.0

package/dist/npm-client/memento-client.js

@@ -0,0 +1,391 @@
+/**
+ * MementoClient - Memento MCP Server와 통신하는 메인 클라이언트
+ *
+ * @example
+ * ```typescript
+ * import { MementoClient } from '@memento/client';
+ *
+ * const client = new MementoClient({
+ *   serverUrl: 'http://localhost:8080',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * await client.connect();
+ *
+ * const memory = await client.remember({
+ *   content: 'React Hook에 대해 학습했다',
+ *   type: 'episodic',
+ *   importance: 0.8
+ * });
+ * ```
+ */
+import axios from 'axios';
+import { EventEmitter } from 'events';
+import { MementoError, ConnectionError, AuthenticationError, ValidationError, NotFoundError } from './types.js';
+export class MementoClient extends EventEmitter {
+    httpClient;
+    isConnected = false;
+    options;
+    constructor(options = {}) {
+        super();
+        this.options = {
+            serverUrl: 'http://localhost:8080',
+            apiKey: '',
+            timeout: 10000,
+            retryCount: 3,
+            logLevel: 'info',
+            ...options
+        };
+        this.httpClient = this.createHttpClient();
+    }
+    /**
+     * HTTP 클라이언트 생성
+     */
+    createHttpClient() {
+        const client = axios.create({
+            baseURL: this.options.serverUrl,
+            timeout: this.options.timeout,
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': '@memento/client/0.1.0'
+            }
+        });
+        // 요청 인터셉터
+        client.interceptors.request.use((config) => {
+            if (this.options.apiKey) {
+                config.headers.Authorization = `Bearer ${this.options.apiKey}`;
+            }
+            if (this.options.logLevel === 'debug') {
+                console.debug('[MementoClient] Request:', {
+                    method: config.method?.toUpperCase(),
+                    url: config.url,
+                    data: config.data
+                });
+            }
+            return config;
+        }, (error) => {
+            this.emit('error', new ConnectionError('Request failed', error));
+            return Promise.reject(error);
+        });
+        // 응답 인터셉터
+        client.interceptors.response.use((response) => {
+            if (this.options.logLevel === 'debug') {
+                console.debug('[MementoClient] Response:', {
+                    status: response.status,
+                    data: response.data
+                });
+            }
+            return response;
+        }, (error) => {
+            const mementoError = this.handleHttpError(error);
+            this.emit('error', mementoError);
+            return Promise.reject(mementoError);
+        });
+        return client;
+    }
+    /**
+     * HTTP 에러를 MementoError로 변환
+     */
+    handleHttpError(error) {
+        if (error.response) {
+            const { status, data } = error.response;
+            const message = data?.error?.message || data?.message || error.message;
+            switch (status) {
+                case 400:
+                    return new ValidationError(message, data);
+                case 401:
+                    return new AuthenticationError(message, data);
+                case 404:
+                    return new NotFoundError(message, data);
+                case 500:
+                    return new MementoError(message, 'INTERNAL_ERROR', status, data);
+                default:
+                    return new MementoError(message, 'HTTP_ERROR', status, data);
+            }
+        }
+        else if (error.request) {
+            return new ConnectionError('Network error - no response received', error);
+        }
+        else {
+            return new ConnectionError('Request setup error', error);
+        }
+    }
+    /**
+     * 서버에 연결
+     */
+    async connect() {
+        try {
+            const health = await this.healthCheck();
+            this.isConnected = true;
+            this.emit('connected');
+            if (this.options.logLevel !== 'silent') {
+                console.log('✅ Memento 서버에 연결되었습니다:', {
+                    version: health.version,
+                    status: health.status
+                });
+            }
+        }
+        catch (error) {
+            this.isConnected = false;
+            this.emit('error', error);
+            throw new ConnectionError('Failed to connect to Memento server', error);
+        }
+    }
+    /**
+     * 연결 해제
+     */
+    async disconnect() {
+        this.isConnected = false;
+        this.emit('disconnected');
+        if (this.options.logLevel !== 'silent') {
+            console.log('🔌 Memento 서버 연결이 해제되었습니다');
+        }
+    }
+    /**
+     * 연결 상태 확인
+     */
+    get connected() {
+        return this.isConnected;
+    }
+    /**
+     * 서버 상태 확인
+     */
+    async healthCheck() {
+        const response = await this.httpClient.get('/health');
+        return response.data;
+    }
+    // ============================================================================
+    // 기억 관리 메서드들
+    // ============================================================================
+    /**
+     * 기억 저장
+     */
+    async remember(params) {
+        this.ensureConnected();
+        const response = await this.httpClient.post('/tools/remember', params);
+        const result = response.data.result;
+        this.emit('memory:created', result);
+        return result;
+    }
+    /**
+     * 기억 검색
+     */
+    async recall(query, filters, limit) {
+        this.ensureConnected();
+        const response = await this.httpClient.post('/tools/recall', {
+            query,
+            filters,
+            limit
+        });
+        // 서버 응답에서 result 객체 추출
+        const result = response.data.result;
+        // 중첩된 구조 처리: { items: { items: [...] } }
+        if (result.items && result.items.items && Array.isArray(result.items.items)) {
+            // 중첩된 구조를 평면화
+            return {
+                ...result,
+                items: result.items.items,
+                total_count: result.items.total_count || result.items.items.length,
+                query_time: result.items.query_time || 0
+            };
+        }
+        return result;
+    }
+    /**
+     * 하이브리드 검색
+     */
+    async hybridSearch(params) {
+        this.ensureConnected();
+        // recall API를 사용하여 하이브리드 검색 수행
+        const searchResult = await this.recall(params.query, params.filters, params.limit);
+        // SearchResult를 HybridSearchResult로 변환
+        return {
+            items: searchResult.items.map(item => ({
+                ...item,
+                textScore: item.score || 0,
+                vectorScore: 0, // 벡터 점수는 현재 사용하지 않음
+                finalScore: item.score || 0
+            })),
+            total_count: searchResult.total_count,
+            query_time: searchResult.query_time,
+            search_type: 'hybrid'
+        };
+    }
+    /**
+     * 기억 조회
+     */
+    async getMemory(id) {
+        this.ensureConnected();
+        // MCP 서버는 개별 기억 조회를 지원하지 않으므로 검색으로 대체
+        // ID로 직접 검색하기 위해 의미있는 쿼리 사용
+        const searchResult = await this.recall('memory', { id: [id] }, 1);
+        // 서버 응답 구조 처리: { items: { items: [...] } }
+        let items;
+        if (searchResult.items && Array.isArray(searchResult.items)) {
+            // 정상적인 구조: { items: [...] }
+            items = searchResult.items;
+        }
+        else if (searchResult.items && typeof searchResult.items === 'object' && 'items' in searchResult.items && Array.isArray(searchResult.items.items)) {
+            // 중첩된 구조: { items: { items: [...] } }
+            items = searchResult.items.items;
+        }
+        else {
+            throw new Error(`Memory with ID ${id} not found`);
+        }
+        if (items.length === 0) {
+            throw new Error(`Memory with ID ${id} not found`);
+        }
+        const memory = items[0];
+        if (!memory || memory.id !== id) {
+            throw new Error(`Memory with ID ${id} not found`);
+        }
+        return memory;
+    }
+    /**
+     * 기억 업데이트
+     */
+    async updateMemory(id, params) {
+        this.ensureConnected();
+        // 기존 기억 정보 가져오기
+        const existingMemory = await this.getMemory(id);
+        // MCP 서버는 기억 업데이트를 지원하지 않으므로 삭제 후 재생성
+        await this.forget(id);
+        // UpdateMemoryParams를 CreateMemoryParams로 변환 (기존 값과 병합)
+        const createParams = {
+            content: params.content || existingMemory.content,
+            type: params.type || existingMemory.type,
+            tags: params.tags || existingMemory.tags,
+            importance: params.importance !== undefined ? params.importance : existingMemory.importance,
+            source: params.source || existingMemory.source,
+            privacy_scope: params.privacy_scope || existingMemory.privacy_scope,
+            project_id: params.project_id || existingMemory.project_id,
+            metadata: params.metadata || existingMemory.metadata
+        };
+        const rememberResult = await this.remember(createParams);
+        // RememberResult를 MemoryItem으로 변환
+        const memoryItem = {
+            id: rememberResult.memory_id,
+            content: createParams.content,
+            type: createParams.type || 'episodic',
+            importance: createParams.importance || 0.5,
+            created_at: rememberResult.created_at,
+            pinned: false,
+            privacy_scope: createParams.privacy_scope || 'private',
+            tags: createParams.tags,
+            source: createParams.source,
+            project_id: createParams.project_id,
+            metadata: createParams.metadata
+        };
+        this.emit('memory:updated', memoryItem);
+        return memoryItem;
+    }
+    /**
+     * 기억 삭제
+     */
+    async forget(memoryId, hard = false) {
+        this.ensureConnected();
+        const response = await this.httpClient.post('/tools/forget', {
+            id: memoryId,
+            hard
+        });
+        const result = response.data.result;
+        this.emit('memory:deleted', memoryId);
+        return result;
+    }
+    /**
+     * 기억 고정
+     */
+    async pin(memoryId) {
+        this.ensureConnected();
+        const response = await this.httpClient.post('/tools/pin', {
+            id: memoryId
+        });
+        const result = response.data.result;
+        this.emit('memory:pinned', memoryId);
+        return result;
+    }
+    /**
+     * 기억 고정 해제
+     */
+    async unpin(memoryId) {
+        this.ensureConnected();
+        const response = await this.httpClient.post('/tools/unpin', {
+            id: memoryId
+        });
+        const result = response.data.result;
+        this.emit('memory:unpinned', memoryId);
+        return result;
+    }
+    // ============================================================================
+    // 고급 기능들
+    // ============================================================================
+    /**
+     * 기억 간 관계 생성
+     */
+    async link(sourceId, targetId, relationType) {
+        this.ensureConnected();
+        const response = await this.httpClient.post('/tools/link', {
+            source_id: sourceId,
+            target_id: targetId,
+            relation_type: relationType
+        });
+        return response.data;
+    }
+    /**
+     * 기억 내보내기
+     */
+    async export(format, filters) {
+        this.ensureConnected();
+        const response = await this.httpClient.post('/tools/export', {
+            format,
+            filters
+        });
+        return response.data;
+    }
+    /**
+     * 피드백 제공
+     */
+    async feedback(memoryId, helpful, comment, score) {
+        this.ensureConnected();
+        const response = await this.httpClient.post('/tools/feedback', {
+            memory_id: memoryId,
+            helpful,
+            comment,
+            score
+        });
+        return response.data;
+    }
+    /**
+     * 컨텍스트 주입
+     */
+    async injectContext(params) {
+        this.ensureConnected();
+        const response = await this.httpClient.post('/prompts/memory_injection', params);
+        return response.data;
+    }
+    // ============================================================================
+    // 유틸리티 메서드들
+    // ============================================================================
+    /**
+     * 연결 상태 확인
+     */
+    ensureConnected() {
+        if (!this.isConnected) {
+            throw new ConnectionError('Client is not connected. Call connect() first.');
+        }
+    }
+    /**
+     * 클라이언트 설정 업데이트
+     */
+    updateOptions(newOptions) {
+        this.options = { ...this.options, ...newOptions };
+        this.httpClient = this.createHttpClient();
+    }
+    /**
+     * 현재 설정 조회
+     */
+    getOptions() {
+        return { ...this.options };
+    }
+}
+//# sourceMappingURL=memento-client.js.map

package/dist/npm-client/memento-client.js.map

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

package/dist/npm-client/memory-manager.d.ts

@@ -0,0 +1,137 @@
+/**
+ * MemoryManager - 기억 관리를 위한 고수준 API
+ * MementoClient를 래핑하여 더 편리한 기억 관리 기능을 제공합니다.
+ *
+ * @example
+ * ```typescript
+ * import { MemoryManager } from '@memento/client';
+ *
+ * const manager = new MemoryManager(client);
+ *
+ * // 기억 저장
+ * const memory = await manager.create({
+ *   content: 'React Hook 학습',
+ *   type: 'episodic',
+ *   tags: ['react', 'frontend']
+ * });
+ *
+ * // 기억 검색
+ * const results = await manager.search('React Hook');
+ * ```
+ */
+import { MementoClient } from './memento-client.js';
+import type { MemoryItem, CreateMemoryParams, UpdateMemoryParams, SearchFilters, SearchResult, MemoryType, PrivacyScope } from './types.js';
+export declare class MemoryManager {
+    private client;
+    constructor(client: MementoClient);
+    /**
+     * 기억 생성
+     */
+    create(params: CreateMemoryParams): Promise<MemoryItem>;
+    /**
+     * 기억 조회
+     */
+    get(id: string): Promise<MemoryItem | null>;
+    /**
+     * 기억 업데이트
+     */
+    update(id: string, params: UpdateMemoryParams): Promise<MemoryItem>;
+    /**
+     * 기억 삭제
+     */
+    delete(id: string, hard?: boolean): Promise<boolean>;
+    /**
+     * 기억 검색
+     */
+    search(query: string, options?: {
+        filters?: SearchFilters;
+        limit?: number;
+        useHybrid?: boolean;
+    }): Promise<SearchResult>;
+    /**
+     * 태그로 기억 검색
+     */
+    searchByTags(tags: string[], limit?: number): Promise<SearchResult>;
+    /**
+     * 타입별 기억 검색
+     */
+    searchByType(type: MemoryType, limit?: number): Promise<SearchResult>;
+    /**
+     * 프로젝트별 기억 검색
+     */
+    searchByProject(projectId: string, limit?: number): Promise<SearchResult>;
+    /**
+     * 최근 기억 검색
+     */
+    searchRecent(days?: number, limit?: number): Promise<SearchResult>;
+    /**
+     * 고정된 기억 검색
+     */
+    searchPinned(limit?: number): Promise<SearchResult>;
+    /**
+     * 의미적 유사 기억 검색
+     */
+    findSimilar(memoryId: string, limit?: number): Promise<SearchResult>;
+    /**
+     * 관련 기억 검색 (태그 기반)
+     */
+    findRelated(memoryId: string, limit?: number): Promise<SearchResult>;
+    /**
+     * 기억 고정
+     */
+    pin(id: string): Promise<boolean>;
+    /**
+     * 기억 고정 해제
+     */
+    unpin(id: string): Promise<boolean>;
+    /**
+     * 기억 중요도 설정
+     */
+    setImportance(id: string, importance: number): Promise<MemoryItem>;
+    /**
+     * 기억 태그 추가
+     */
+    addTags(id: string, tags: string[]): Promise<MemoryItem>;
+    /**
+     * 기억 태그 제거
+     */
+    removeTags(id: string, tags: string[]): Promise<MemoryItem>;
+    /**
+     * 기억 태그 업데이트
+     */
+    setTags(id: string, tags: string[]): Promise<MemoryItem>;
+    /**
+     * 기억 공개 범위 설정
+     */
+    setPrivacyScope(id: string, privacyScope: PrivacyScope): Promise<MemoryItem>;
+    /**
+     * 여러 기억 일괄 생성
+     */
+    createBatch(params: CreateMemoryParams[]): Promise<MemoryItem[]>;
+    /**
+     * 여러 기억 일괄 삭제
+     */
+    deleteBatch(ids: string[], hard?: boolean): Promise<number>;
+    /**
+     * 여러 기억 일괄 고정/해제
+     */
+    pinBatch(ids: string[], pin?: boolean): Promise<number>;
+    /**
+     * 기억 통계 조회
+     */
+    getStats(): Promise<{
+        total: number;
+        byType: Record<MemoryType, number>;
+        byPrivacyScope: Record<PrivacyScope, number>;
+        pinned: number;
+        recent: number;
+    }>;
+    /**
+     * 인기 태그 조회
+     */
+    getPopularTags(limit?: number): Promise<Array<{
+        tag: string;
+        count: number;
+    }>>;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/npm-client/memory-manager.d.ts.map

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