memento-mcp-server 0.1.0

package/dist/tools/base-tool.js

@@ -0,0 +1,158 @@
+/**
+ * 기본 도구 클래스
+ * 모든 MCP 도구의 기본 구조를 제공
+ */
+export class BaseTool {
+    name;
+    description;
+    inputSchema;
+    constructor(name, description, inputSchema) {
+        this.name = name;
+        this.description = description;
+        this.inputSchema = inputSchema;
+    }
+    /**
+     * 도구 정의 반환
+     */
+    getDefinition() {
+        return {
+            name: this.name,
+            description: this.description,
+            inputSchema: this.inputSchema,
+            handler: this.handle.bind(this),
+        };
+    }
+    /**
+     * 성공 결과 생성
+     */
+    createSuccessResult(data) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * 에러 결과 생성
+     */
+    createErrorResult(error, message, details) {
+        return {
+            error,
+            ...(message && { message }),
+            ...(details && { details }),
+        };
+    }
+    /**
+     * 안전한 JSON 파싱
+     */
+    safeJsonParse(jsonString, fallback = null) {
+        try {
+            return JSON.parse(jsonString);
+        }
+        catch (error) {
+            console.warn(`JSON 파싱 실패: ${error instanceof Error ? error.message : String(error)}`);
+            return fallback;
+        }
+    }
+    /**
+     * 안전한 문자열 검증
+     */
+    validateString(value, fieldName, maxLength = 1000) {
+        if (typeof value !== 'string') {
+            throw new Error(`${fieldName}은 문자열이어야 합니다`);
+        }
+        if (value.length === 0) {
+            throw new Error(`${fieldName}은 비어있을 수 없습니다`);
+        }
+        if (value.length > maxLength) {
+            throw new Error(`${fieldName}은 ${maxLength}자를 초과할 수 없습니다`);
+        }
+        return value.trim();
+    }
+    /**
+     * 안전한 숫자 검증
+     */
+    validateNumber(value, fieldName, min, max) {
+        const num = Number(value);
+        if (isNaN(num)) {
+            throw new Error(`${fieldName}은 유효한 숫자여야 합니다`);
+        }
+        if (min !== undefined && num < min) {
+            throw new Error(`${fieldName}은 ${min} 이상이어야 합니다`);
+        }
+        if (max !== undefined && num > max) {
+            throw new Error(`${fieldName}은 ${max} 이하여야 합니다`);
+        }
+        return num;
+    }
+    /**
+     * 안전한 배열 검증
+     */
+    validateArray(value, fieldName, maxLength = 100) {
+        if (!Array.isArray(value)) {
+            throw new Error(`${fieldName}은 배열이어야 합니다`);
+        }
+        if (value.length > maxLength) {
+            throw new Error(`${fieldName}은 ${maxLength}개를 초과할 수 없습니다`);
+        }
+        return value;
+    }
+    /**
+     * 에러 로깅
+     */
+    logError(error, context, additionalData) {
+        const errorInfo = {
+            tool: this.name,
+            context,
+            error: error.message,
+            stack: error.stack,
+            timestamp: new Date().toISOString(),
+            ...additionalData
+        };
+        console.error(`[${this.name}] ${context}:`, errorInfo);
+    }
+    /**
+     * 경고 로깅
+     */
+    logWarning(message, additionalData) {
+        const warningInfo = {
+            tool: this.name,
+            message,
+            timestamp: new Date().toISOString(),
+            ...additionalData
+        };
+        console.warn(`[${this.name}] ${message}:`, warningInfo);
+    }
+    /**
+     * 정보 로깅
+     */
+    logInfo(message, additionalData) {
+        const infoData = {
+            tool: this.name,
+            message,
+            timestamp: new Date().toISOString(),
+            ...additionalData
+        };
+        console.log(`[${this.name}] ${message}:`, infoData);
+    }
+    /**
+     * 데이터베이스 연결 확인
+     */
+    validateDatabase(context) {
+        if (!context.db) {
+            throw new Error('데이터베이스가 초기화되지 않았습니다');
+        }
+    }
+    /**
+     * 서비스 확인
+     */
+    validateService(service, serviceName) {
+        if (!service) {
+            throw new Error(`${serviceName}이 초기화되지 않았습니다`);
+        }
+    }
+}
+//# sourceMappingURL=base-tool.js.map

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

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

package/dist/tools/cleanup-memory-tool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cleanup Memory Tool - 메모리 정리 도구
+ */
+import { BaseTool } from './base-tool.js';
+import type { ToolContext, ToolResult } from './types.js';
+export declare class CleanupMemoryTool extends BaseTool {
+    constructor();
+    handle(params: any, context: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=cleanup-memory-tool.d.ts.map

package/dist/tools/cleanup-memory-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-memory-tool.d.ts","sourceRoot":"","sources":["../../src/tools/cleanup-memory-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO1D,qBAAa,iBAAkB,SAAQ,QAAQ;;IAkBvC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA6CrE"}

package/dist/tools/cleanup-memory-tool.js

@@ -0,0 +1,66 @@
+/**
+ * Cleanup Memory Tool - 메모리 정리 도구
+ */
+import { z } from 'zod';
+import { BaseTool } from './base-tool.js';
+import { CommonSchemas } from './types.js';
+const CleanupMemorySchema = z.object({
+    dry_run: CommonSchemas.DryRun,
+});
+export class CleanupMemoryTool extends BaseTool {
+    constructor() {
+        super('cleanup_memory', '망각 정책에 따라 메모리를 정리합니다', {
+            type: 'object',
+            properties: {
+                dry_run: {
+                    type: 'boolean',
+                    description: '드라이런 모드 (실제 삭제 없이 분석만)',
+                    default: false
+                }
+            }
+        });
+    }
+    async handle(params, context) {
+        const { dry_run } = CleanupMemorySchema.parse(params);
+        // 데이터베이스 연결 확인
+        this.validateDatabase(context);
+        // 망각 정책 서비스 확인
+        this.validateService(context.services.forgettingPolicyService, '망각 정책 서비스');
+        try {
+            if (dry_run) {
+                // 드라이런 모드: 실제 삭제 없이 분석만 수행
+                const stats = await context.services.forgettingPolicyService.generateForgettingStats(context.db);
+                return this.createSuccessResult({
+                    mode: 'dry_run',
+                    stats: {
+                        totalMemories: stats.totalMemories,
+                        forgetCandidates: stats.forgetCandidates,
+                        reviewCandidates: stats.reviewCandidates,
+                        averageForgetScore: stats.averageForgetScore,
+                        memoryDistribution: stats.memoryDistribution
+                    },
+                    message: '망각 후보 분석 완료 (실제 삭제 없음)'
+                });
+            }
+            else {
+                // 실제 정리 실행
+                const result = await context.services.forgettingPolicyService.executeMemoryCleanup(context.db);
+                return this.createSuccessResult({
+                    mode: 'execution',
+                    result: {
+                        softDeleted: result.softDeleted,
+                        hardDeleted: result.hardDeleted,
+                        reviewed: result.reviewed,
+                        totalProcessed: result.totalProcessed,
+                        summary: result.summary
+                    },
+                    message: `메모리 정리 완료: 소프트 삭제 ${result.summary.actualSoftDeletes}개, 하드 삭제 ${result.summary.actualHardDeletes}개, 리뷰 ${result.summary.actualReviews}개`
+                });
+            }
+        }
+        catch (error) {
+            throw new Error(`메모리 정리 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+//# sourceMappingURL=cleanup-memory-tool.js.map

package/dist/tools/cleanup-memory-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-memory-tool.js","sourceRoot":"","sources":["../../src/tools/cleanup-memory-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,aAAa,CAAC,MAAM;CAC9B,CAAC,CAAC;AAEH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C;QACE,KAAK,CACH,gBAAgB,EAChB,sBAAsB,EACtB;YACE,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,wBAAwB;oBACrC,OAAO,EAAE,KAAK;iBACf;aACF;SACF,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAW,EAAE,OAAoB;QAC5C,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEtD,eAAe;QACf,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE/B,eAAe;QACf,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,IAAI,OAAO,EAAE,CAAC;gBACZ,2BAA2B;gBAC3B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAEjG,OAAO,IAAI,CAAC,mBAAmB,CAAC;oBAC9B,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,aAAa,EAAE,KAAK,CAAC,aAAa;wBAClC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;wBACxC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;wBACxC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;wBAC5C,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;qBAC7C;oBACD,OAAO,EAAE,wBAAwB;iBAClC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,WAAW;gBACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAE/F,OAAO,IAAI,CAAC,mBAAmB,CAAC;oBAC9B,IAAI,EAAE,WAAW;oBACjB,MAAM,EAAE;wBACN,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,cAAc,EAAE,MAAM,CAAC,cAAc;wBACrC,OAAO,EAAE,MAAM,CAAC,OAAO;qBACxB;oBACD,OAAO,EAAE,qBAAqB,MAAM,CAAC,OAAO,CAAC,iBAAiB,YAAY,MAAM,CAAC,OAAO,CAAC,iBAAiB,SAAS,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG;iBACnJ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;CACF"}

package/dist/tools/database-optimize-tool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Database Optimize Tool - 데이터베이스 최적화 도구
+ */
+import { BaseTool } from './base-tool.js';
+import type { ToolContext, ToolResult } from './types.js';
+export declare class DatabaseOptimizeTool extends BaseTool {
+    constructor();
+    handle(params: any, context: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=database-optimize-tool.d.ts.map

package/dist/tools/database-optimize-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-optimize-tool.d.ts","sourceRoot":"","sources":["../../src/tools/database-optimize-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ1D,qBAAa,oBAAqB,SAAQ,QAAQ;;IAuB1C,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAyCrE"}

package/dist/tools/database-optimize-tool.js

@@ -0,0 +1,64 @@
+/**
+ * Database Optimize Tool - 데이터베이스 최적화 도구
+ */
+import { z } from 'zod';
+import { BaseTool } from './base-tool.js';
+import { CommonSchemas } from './types.js';
+const DatabaseOptimizeSchema = z.object({
+    analyze: CommonSchemas.Analyze,
+    create_indexes: CommonSchemas.CreateIndexes,
+});
+export class DatabaseOptimizeTool extends BaseTool {
+    constructor() {
+        super('database_optimize', '데이터베이스 최적화를 수행합니다', {
+            type: 'object',
+            properties: {
+                analyze: {
+                    type: 'boolean',
+                    description: '데이터베이스 분석 실행',
+                    default: false
+                },
+                create_indexes: {
+                    type: 'boolean',
+                    description: '추천 인덱스 생성',
+                    default: false
+                }
+            }
+        });
+    }
+    async handle(params, context) {
+        const { analyze, create_indexes } = DatabaseOptimizeSchema.parse(params);
+        // 데이터베이스 연결 확인
+        this.validateDatabase(context);
+        // 데이터베이스 최적화기 확인
+        this.validateService(context.services.databaseOptimizer, '데이터베이스 최적화기');
+        try {
+            const results = {
+                message: '데이터베이스 최적화 완료',
+                operations: []
+            };
+            if (analyze) {
+                await context.services.databaseOptimizer.analyzeDatabase();
+                results.operations.push('데이터베이스 분석 완료');
+            }
+            if (create_indexes) {
+                const recommendations = await context.services.databaseOptimizer.generateIndexRecommendations();
+                const highPriorityRecs = recommendations.filter((r) => r.priority === 'high');
+                for (const rec of highPriorityRecs) {
+                    const indexName = `idx_${rec.table}_${rec.columns.join('_')}`;
+                    await context.services.databaseOptimizer.createIndex(indexName, rec.table, rec.columns);
+                    results.operations.push(`인덱스 생성: ${indexName}`);
+                }
+            }
+            const report = await context.services.databaseOptimizer.generateOptimizationReport();
+            return this.createSuccessResult({
+                ...results,
+                report: report
+            });
+        }
+        catch (error) {
+            throw new Error(`데이터베이스 최적화 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+//# sourceMappingURL=database-optimize-tool.js.map

package/dist/tools/database-optimize-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-optimize-tool.js","sourceRoot":"","sources":["../../src/tools/database-optimize-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,aAAa,CAAC,OAAO;IAC9B,cAAc,EAAE,aAAa,CAAC,aAAa;CAC5C,CAAC,CAAC;AAEH,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChD;QACE,KAAK,CACH,mBAAmB,EACnB,mBAAmB,EACnB;YACE,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,cAAc;oBAC3B,OAAO,EAAE,KAAK;iBACf;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,WAAW;oBACxB,OAAO,EAAE,KAAK;iBACf;aACF;SACF,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAW,EAAE,OAAoB;QAC5C,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEzE,eAAe;QACf,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE/B,iBAAiB;QACjB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;QAExE,IAAI,CAAC;YACH,MAAM,OAAO,GAAQ;gBACnB,OAAO,EAAE,eAAe;gBACxB,UAAU,EAAE,EAAE;aACf,CAAC;YAEF,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,eAAe,EAAE,CAAC;gBAC3D,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC1C,CAAC;YAED,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,4BAA4B,EAAE,CAAC;gBAChG,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;gBAEnF,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;oBACnC,MAAM,SAAS,GAAG,OAAO,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC9D,MAAM,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;oBACxF,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,SAAS,EAAE,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,CAAC;YAErF,OAAO,IAAI,CAAC,mBAAmB,CAAC;gBAC9B,GAAG,OAAO;gBACV,MAAM,EAAE,MAAM;aACf,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;CACF"}

package/dist/tools/error-stats.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 에러 통계 도구
+ * 에러 로깅 서비스의 통계 정보를 조회하는 MCP 도구
+ */
+import type { ToolContext } from './types.js';
+export declare const errorStatsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            hours: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            severity: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            category: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            includeResolved: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function executeErrorStats(args: any, context: ToolContext): Promise<{
+    success: boolean;
+    error: string;
+    stats: {
+        totalErrors: number;
+        errorsBySeverity: {
+            low: number;
+            medium: number;
+            high: number;
+            critical: number;
+        };
+        errorsByCategory: {
+            database: number;
+            network: number;
+            validation: number;
+            authentication: number;
+            performance: number;
+            memory: number;
+            search: number;
+            embedding: number;
+            cache: number;
+            unknown: number;
+        };
+        errorsByHour: {};
+        averageResolutionTime: number;
+        criticalErrors: number;
+        recentErrors: never[];
+    };
+    alerts?: undefined;
+    summary?: undefined;
+} | {
+    success: boolean;
+    stats: any;
+    alerts: any;
+    summary: {
+        totalErrors: any;
+        criticalErrors: any;
+        activeAlerts: any;
+        averageResolutionTime: number;
+    };
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    stats: null;
+    alerts?: undefined;
+    summary?: undefined;
+}>;
+//# sourceMappingURL=error-stats.d.ts.map

package/dist/tools/error-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-stats.d.ts","sourceRoot":"","sources":["../../src/tools/error-stats.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsC1B,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEtE"}

package/dist/tools/error-stats.js

@@ -0,0 +1,115 @@
+/**
+ * 에러 통계 도구
+ * 에러 로깅 서비스의 통계 정보를 조회하는 MCP 도구
+ */
+import { z } from 'zod';
+export const errorStatsTool = {
+    name: 'error_stats',
+    description: '에러 통계 및 로그 정보를 조회합니다',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            hours: {
+                type: 'number',
+                minimum: 1,
+                maximum: 168,
+                default: 24,
+                description: '조회할 시간 범위 (시간 단위, 1-168)'
+            },
+            severity: {
+                type: 'string',
+                enum: ['low', 'medium', 'high', 'critical'],
+                description: '심각도 필터'
+            },
+            category: {
+                type: 'string',
+                enum: ['database', 'network', 'validation', 'authentication', 'performance', 'memory', 'search', 'embedding', 'cache', 'unknown'],
+                description: '카테고리 필터'
+            },
+            includeResolved: {
+                type: 'boolean',
+                default: false,
+                description: '해결된 에러 포함 여부'
+            },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                default: 50,
+                description: '결과 제한 수'
+            }
+        },
+        required: []
+    }
+};
+export async function executeErrorStats(args, context) {
+    const { hours, severity, category, includeResolved, limit } = args;
+    try {
+        // 에러 로깅 서비스가 없으면 기본 응답
+        if (!context.services.errorLoggingService) {
+            return {
+                success: false,
+                error: 'Error logging service not available',
+                stats: {
+                    totalErrors: 0,
+                    errorsBySeverity: { low: 0, medium: 0, high: 0, critical: 0 },
+                    errorsByCategory: { database: 0, network: 0, validation: 0, authentication: 0, performance: 0, memory: 0, search: 0, embedding: 0, cache: 0, unknown: 0 },
+                    errorsByHour: {},
+                    averageResolutionTime: 0,
+                    criticalErrors: 0,
+                    recentErrors: []
+                }
+            };
+        }
+        const stats = context.services.errorLoggingService.getErrorStats(hours);
+        const alerts = context.services.errorLoggingService.getActiveAlerts();
+        // 필터링된 에러 검색
+        const searchFilters = {};
+        if (severity)
+            searchFilters.severity = severity;
+        if (category)
+            searchFilters.category = category;
+        if (includeResolved !== undefined)
+            searchFilters.resolved = includeResolved;
+        searchFilters.limit = limit;
+        const filteredErrors = context.services.errorLoggingService.searchErrors(searchFilters);
+        return {
+            success: true,
+            stats: {
+                ...stats,
+                filteredErrors: filteredErrors.map((error) => ({
+                    id: error.id,
+                    timestamp: error.timestamp.toISOString(),
+                    severity: error.severity,
+                    category: error.category,
+                    message: error.message,
+                    component: error.context.component,
+                    resolved: error.resolved,
+                    resolvedAt: error.resolvedAt?.toISOString()
+                }))
+            },
+            alerts: alerts.map((alert) => ({
+                id: alert.id,
+                errorId: alert.errorId,
+                severity: alert.severity,
+                message: alert.message,
+                timestamp: alert.timestamp.toISOString(),
+                acknowledged: alert.acknowledged
+            })),
+            summary: {
+                totalErrors: stats.totalErrors,
+                criticalErrors: stats.criticalErrors,
+                activeAlerts: alerts.length,
+                averageResolutionTime: Math.round(stats.averageResolutionTime / 1000) // 초 단위로 변환
+            }
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+            stats: null
+        };
+    }
+}
+//# sourceMappingURL=error-stats.js.map

package/dist/tools/error-stats.js.map

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

package/dist/tools/forget-tool.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Forget Tool - 기억 삭제 도구
+ * 안전한 기억 삭제 및 복구 기능
+ */
+import { BaseTool } from './base-tool.js';
+import type { ToolContext, ToolResult } from './types.js';
+export declare class ForgetTool extends BaseTool {
+    constructor();
+    /**
+     * 제공자별 vec0 테이블명 반환
+     */
+    private getVectorTableName;
+    handle(params: any, context: ToolContext): Promise<ToolResult>;
+    /**
+     * 단일 기억 삭제
+     */
+    private handleSingleDelete;
+    /**
+     * 배치 삭제 처리
+     */
+    private handleBatchDelete;
+    /**
+     * 하드 삭제 실행
+     */
+    private performHardDelete;
+    /**
+     * 소프트 삭제 실행
+     */
+    private performSoftDelete;
+    /**
+     * 기억 조회
+     */
+    private getMemoryById;
+    /**
+     * 삭제 권한 확인
+     */
+    private validateDeletePermission;
+    /**
+     * 삭제 로그 기록
+     */
+    private logDeleteAction;
+    /**
+     * 임베딩 삭제
+     */
+    private deleteEmbedding;
+    /**
+     * 관련 데이터 정리
+     */
+    private cleanupRelatedData;
+    /**
+     * 데이터베이스 락 처리
+     */
+    private handleDatabaseLock;
+    /**
+     * 삭제 가능한 기억 목록 조회
+     */
+    getDeletableMemories(context: ToolContext, limit?: number): Promise<any[]>;
+    /**
+     * 삭제 통계 조회
+     */
+    getDeleteStats(context: ToolContext): Promise<any>;
+}
+//# sourceMappingURL=forget-tool.d.ts.map

package/dist/tools/forget-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget-tool.d.ts","sourceRoot":"","sources":["../../src/tools/forget-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAc1D,qBAAa,UAAW,SAAQ,QAAQ;;IA2CtC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAepB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA6DpE;;OAEG;YACW,kBAAkB;IAyDhC;;OAEG;YACW,iBAAiB;IAgC/B;;OAEG;YACW,iBAAiB;IAkC/B;;OAEG;YACW,iBAAiB;IAe/B;;OAEG;YACW,aAAa;IAQ3B;;OAEG;YACW,wBAAwB;IAYtC;;OAEG;YACW,eAAe;IAkB7B;;OAEG;YACW,eAAe;IAQ7B;;OAEG;YACW,kBAAkB;IAwChC;;OAEG;YACW,kBAAkB;IAShC;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAcpF;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;CA2BzD"}