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

package/dist/domains/relation/tools/extract-relations-tool.js

@@ -0,0 +1,159 @@
+/**
+ * Extract Relations Tool - 관계 추출 도구
+ * 특정 메모리에 대해 관계를 추출합니다.
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import { DatabaseUtils } from '../../../shared/utils/database.js';
+import { RelationExtractor } from '../services/relation-extractor.js';
+import { RelationGraph } from '../services/relation-graph.js';
+import { logger } from '../../../shared/utils/logger.js';
+import { isMemoryRow, convertMemoryRowToItem } from '../../../shared/utils/type-guards.js';
+const ExtractRelationsSchema = z.object({
+    memory_id: z.string().min(1, 'memory_id는 필수입니다'),
+    force: z.boolean().optional().default(false).describe('강제 재추출 여부 (캐시 무시)')
+});
+export class ExtractRelationsTool extends BaseTool {
+    constructor() {
+        super('extract_relations', '특정 메모리에 대해 기존 메모리들과의 관계를 추출합니다', {
+            type: 'object',
+            properties: {
+                memory_id: {
+                    type: 'string',
+                    description: '관계를 추출할 메모리 ID'
+                },
+                force: {
+                    type: 'boolean',
+                    description: '강제 재추출 여부 (캐시 무시, 기본값: false)',
+                    default: false
+                }
+            },
+            required: ['memory_id']
+        });
+    }
+    /**
+     * Given: memory_id와 force 옵션
+     * When: 관계 추출 수행
+     * Then: 추출된 관계 목록 반환
+     */
+    async handle(params, context) {
+        const { memory_id, force } = ExtractRelationsSchema.parse(params);
+        const db = context.db;
+        try {
+            // Given: 메모리 존재 확인
+            const memoryResult = DatabaseUtils.get(db, `
+        SELECT id, type, content, importance, privacy_scope, created_at
+        FROM memory_item
+        WHERE id = ?
+      `, [memory_id]);
+            if (!memoryResult || !isMemoryRow(memoryResult)) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'MEMORY_NOT_FOUND',
+                                message: `메모리를 찾을 수 없습니다: ${memory_id}`
+                            }, null, 2)
+                        }]
+                };
+            }
+            // MemoryItem으로 변환 (타입 안전성 보장)
+            const memoryItem = convertMemoryRowToItem(memoryResult);
+            if (!memoryItem) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'INVALID_MEMORY_TYPE',
+                                message: `메모리 타입이 유효하지 않습니다: ${memory_id}`
+                            }, null, 2)
+                        }]
+                };
+            }
+            // 기존 메모리 목록 조회 (자기 자신 제외)
+            const existingMemoriesResult = DatabaseUtils.all(db, `
+        SELECT id, type, content, importance, privacy_scope, created_at
+        FROM memory_item
+        WHERE id != ?
+        ORDER BY created_at DESC
+        LIMIT 1000
+      `, [memory_id]);
+            // 타입 가드를 사용하여 안전하게 변환
+            const existingMemoryItems = existingMemoriesResult
+                .map(row => {
+                if (!isMemoryRow(row)) {
+                    logger.warn('기존 메모리 조회 결과 타입 검증 실패', { row });
+                    return null;
+                }
+                return convertMemoryRowToItem(row);
+            })
+                .filter((item) => item !== null);
+            if (existingMemoryItems.length === 0) {
+                return this.createSuccessResult({
+                    memory_id,
+                    extracted_count: 0,
+                    relations: [],
+                    message: '관계를 추출할 기존 메모리가 없습니다'
+                });
+            }
+            // When: 관계 추출 수행
+            const relationExtractor = new RelationExtractor();
+            // force가 true이면 캐시를 무시하고 즉시 처리
+            const extractOptions = {
+                immediate: force, // force가 true면 즉시 처리 (캐시 무시), false면 캐시 사용
+                minConfidence: 0.5
+            };
+            const candidates = await relationExtractor.extractRelations(memoryItem, existingMemoryItems, extractOptions);
+            // 추출된 관계를 RelationGraph에 저장
+            let savedCount = 0;
+            if (candidates.length > 0) {
+                // RelationGraph 인스턴스 생성 (context에 없으면 새로 생성)
+                const relationGraph = context.services.relationGraph || new RelationGraph(db);
+                for (const candidate of candidates) {
+                    try {
+                        await relationGraph.addRelation(candidate.source_id, candidate.target_id, candidate.relation_type, { confidence: candidate.confidence });
+                        savedCount++;
+                    }
+                    catch (error) {
+                        // 중복 관계나 순환 관계는 무시
+                        const errorMessage = error instanceof Error ? error.message : String(error);
+                        logger.warn('관계 저장 실패', {
+                            source_id: candidate.source_id,
+                            target_id: candidate.target_id,
+                            relation_type: candidate.relation_type,
+                            error: errorMessage
+                        });
+                    }
+                }
+            }
+            // Then: 결과 반환
+            return this.createSuccessResult({
+                memory_id,
+                extracted_count: candidates.length,
+                saved_count: savedCount,
+                relations: candidates.map(c => ({
+                    source_id: c.source_id,
+                    target_id: c.target_id,
+                    relation_type: c.relation_type,
+                    confidence: c.confidence
+                })),
+                message: `${candidates.length}개의 관계를 추출했습니다 (${savedCount}개 저장됨)`
+            });
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: 'EXTRACTION_FAILED',
+                            message: error instanceof Error ? error.message : String(error)
+                        }, null, 2)
+                    }]
+            };
+        }
+    }
+}
+//# sourceMappingURL=extract-relations-tool.js.map

package/dist/domains/relation/tools/extract-relations-tool.js.map

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

package/dist/domains/relation/tools/get-relations-tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Get Relations Tool - 관계 조회 도구
+ * 특정 메모리의 관계를 조회합니다.
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import type { ToolContext, ToolResult } from '../../../tools/types.js';
+declare const GetRelationsSchema: z.ZodObject<{
+    memory_id: z.ZodString;
+    relation_type: z.ZodOptional<z.ZodEnum<["CAUSES", "DEPENDS_ON", "FOLLOWS", "CONTRASTS_WITH", "REFERENCES", "BELONGS_TO"]>>;
+    category: z.ZodOptional<z.ZodEnum<["Causal", "Temporal", "Structural", "Semantic"]>>;
+    direction: z.ZodDefault<z.ZodOptional<z.ZodEnum<["incoming", "outgoing", "both"]>>>;
+}, "strip", z.ZodTypeAny, {
+    direction: "outgoing" | "incoming" | "both";
+    memory_id: string;
+    relation_type?: "CAUSES" | "DEPENDS_ON" | "FOLLOWS" | "CONTRASTS_WITH" | "REFERENCES" | "BELONGS_TO" | undefined;
+    category?: "Causal" | "Temporal" | "Structural" | "Semantic" | undefined;
+}, {
+    memory_id: string;
+    relation_type?: "CAUSES" | "DEPENDS_ON" | "FOLLOWS" | "CONTRASTS_WITH" | "REFERENCES" | "BELONGS_TO" | undefined;
+    direction?: "outgoing" | "incoming" | "both" | undefined;
+    category?: "Causal" | "Temporal" | "Structural" | "Semantic" | undefined;
+}>;
+export declare class GetRelationsTool extends BaseTool {
+    constructor();
+    /**
+     * Given: memory_id와 필터 옵션
+     * When: 관계 조회 수행
+     * Then: 조회된 관계 목록 반환
+     */
+    handle(params: z.infer<typeof GetRelationsSchema>, context: ToolContext): Promise<ToolResult>;
+}
+export {};
+//# sourceMappingURL=get-relations-tool.d.ts.map

package/dist/domains/relation/tools/get-relations-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-relations-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/relation/tools/get-relations-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,kBAAkB;;;;;;;;;;;;;;;EAKtB,CAAC;AAEH,qBAAa,gBAAiB,SAAQ,QAAQ;;IAkC5C;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAkHpG"}

package/dist/domains/relation/tools/get-relations-tool.js

@@ -0,0 +1,155 @@
+/**
+ * Get Relations Tool - 관계 조회 도구
+ * 특정 메모리의 관계를 조회합니다.
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import { DatabaseUtils } from '../../../shared/utils/database.js';
+import { RelationGraph } from '../services/relation-graph.js';
+import { RELATION_TYPE_CATEGORY_MAP, getRelationCategory } from '../../../shared/types/relation.js';
+const GetRelationsSchema = z.object({
+    memory_id: z.string().min(1, 'memory_id는 필수입니다'),
+    relation_type: z.enum(['CAUSES', 'DEPENDS_ON', 'FOLLOWS', 'CONTRASTS_WITH', 'REFERENCES', 'BELONGS_TO']).optional(),
+    category: z.enum(['Causal', 'Temporal', 'Structural', 'Semantic']).optional(),
+    direction: z.enum(['incoming', 'outgoing', 'both']).optional().default('both')
+});
+export class GetRelationsTool extends BaseTool {
+    constructor() {
+        super('get_relations', '특정 메모리의 관계를 조회합니다', {
+            type: 'object',
+            properties: {
+                memory_id: {
+                    type: 'string',
+                    description: '관계를 조회할 메모리 ID'
+                },
+                relation_type: {
+                    type: 'string',
+                    enum: ['CAUSES', 'DEPENDS_ON', 'FOLLOWS', 'CONTRASTS_WITH', 'REFERENCES', 'BELONGS_TO'],
+                    description: '관계 유형 필터 (선택)'
+                },
+                category: {
+                    type: 'string',
+                    enum: ['Causal', 'Temporal', 'Structural', 'Semantic'],
+                    description: '관계 카테고리 필터 (선택)'
+                },
+                direction: {
+                    type: 'string',
+                    enum: ['incoming', 'outgoing', 'both'],
+                    description: '관계 방향 (기본값: both)',
+                    default: 'both'
+                }
+            },
+            required: ['memory_id']
+        });
+    }
+    /**
+     * Given: memory_id와 필터 옵션
+     * When: 관계 조회 수행
+     * Then: 조회된 관계 목록 반환
+     */
+    async handle(params, context) {
+        const { memory_id, relation_type, category, direction } = GetRelationsSchema.parse(params);
+        const db = context.db;
+        try {
+            // Given: 메모리 존재 확인
+            const memory = DatabaseUtils.get(db, `
+        SELECT id FROM memory_item WHERE id = ?
+      `, [memory_id]);
+            if (!memory) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'MEMORY_NOT_FOUND',
+                                message: `메모리를 찾을 수 없습니다: ${memory_id}`
+                            }, null, 2)
+                        }]
+                };
+            }
+            // RelationGraph 인스턴스 생성 (context에 없으면 새로 생성)
+            const relationGraph = context.services.relationGraph || new RelationGraph(db);
+            // When: 관계 조회 수행
+            const options = {
+                direction: direction || 'both',
+                minConfidence: 0.0 // 모든 신뢰도 포함
+            };
+            // relation_type 필터 적용
+            if (relation_type) {
+                options.relationTypes = [relation_type];
+            }
+            // category 필터 적용
+            if (category) {
+                // category를 relation_type 배열로 변환 (RELATION_TYPE_CATEGORY_MAP의 역방향 매핑)
+                const categoryToTypes = [];
+                for (const [relationType, relationCategory] of Object.entries(RELATION_TYPE_CATEGORY_MAP)) {
+                    if (relationCategory === category) {
+                        categoryToTypes.push(relationType);
+                    }
+                }
+                if (categoryToTypes.length > 0) {
+                    if (options.relationTypes && options.relationTypes.length > 0) {
+                        // relation_type과 category 모두 지정된 경우 교집합
+                        options.relationTypes = options.relationTypes.filter((type) => categoryToTypes.includes(type));
+                        // 교집합이 비어있으면 빈 배열로 설정하여 결과 없음을 명시
+                    }
+                    else {
+                        options.relationTypes = categoryToTypes;
+                    }
+                }
+                else {
+                    // category에 해당하는 relation_type이 없으면 빈 배열로 설정
+                    options.relationTypes = [];
+                }
+            }
+            // relationTypes가 빈 배열이면 조회하지 않고 빈 결과 반환
+            if (options.relationTypes && options.relationTypes.length === 0) {
+                return this.createSuccessResult({
+                    memory_id,
+                    relation_count: 0,
+                    relations: [],
+                    filters: {
+                        relation_type: relation_type || null,
+                        category: category || null,
+                        direction: direction || 'both'
+                    },
+                    message: '0개의 관계를 찾았습니다'
+                });
+            }
+            const relations = await relationGraph.getRelations(memory_id, options);
+            // Then: 결과 반환
+            return this.createSuccessResult({
+                memory_id,
+                relation_count: relations.length,
+                relations: relations.map((r) => ({
+                    relation_id: r.id,
+                    source_id: r.source_id,
+                    target_id: r.target_id,
+                    relation_type: r.relation_type,
+                    confidence: r.confidence,
+                    metadata: r.metadata,
+                    created_at: r.created_at
+                })),
+                filters: {
+                    relation_type: relation_type || null,
+                    category: category || null,
+                    direction: direction || 'both'
+                },
+                message: `${relations.length}개의 관계를 찾았습니다`
+            });
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: 'QUERY_FAILED',
+                            message: error instanceof Error ? error.message : String(error)
+                        }, null, 2)
+                    }]
+            };
+        }
+    }
+}
+//# sourceMappingURL=get-relations-tool.js.map

package/dist/domains/relation/tools/get-relations-tool.js.map

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

package/dist/domains/relation/tools/remove-relation-tool.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Remove Relation Tool - 관계 삭제 도구
+ * 메모리 간의 관계를 삭제합니다.
+ * relation_id 또는 source_id/target_id/relation_type 조합으로 삭제 가능합니다.
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import type { ToolContext, ToolResult } from '../../../tools/types.js';
+declare const RemoveRelationSchema: z.ZodEffects<z.ZodObject<{
+    relation_id: z.ZodOptional<z.ZodNumber>;
+    source_id: z.ZodOptional<z.ZodString>;
+    target_id: z.ZodOptional<z.ZodString>;
+    relation_type: z.ZodOptional<z.ZodEnum<["CAUSES", "DEPENDS_ON", "FOLLOWS", "CONTRASTS_WITH", "REFERENCES", "BELONGS_TO"]>>;
+}, "strip", z.ZodTypeAny, {
+    source_id?: string | undefined;
+    target_id?: string | undefined;
+    relation_type?: "CAUSES" | "DEPENDS_ON" | "FOLLOWS" | "CONTRASTS_WITH" | "REFERENCES" | "BELONGS_TO" | undefined;
+    relation_id?: number | undefined;
+}, {
+    source_id?: string | undefined;
+    target_id?: string | undefined;
+    relation_type?: "CAUSES" | "DEPENDS_ON" | "FOLLOWS" | "CONTRASTS_WITH" | "REFERENCES" | "BELONGS_TO" | undefined;
+    relation_id?: number | undefined;
+}>, {
+    source_id?: string | undefined;
+    target_id?: string | undefined;
+    relation_type?: "CAUSES" | "DEPENDS_ON" | "FOLLOWS" | "CONTRASTS_WITH" | "REFERENCES" | "BELONGS_TO" | undefined;
+    relation_id?: number | undefined;
+}, {
+    source_id?: string | undefined;
+    target_id?: string | undefined;
+    relation_type?: "CAUSES" | "DEPENDS_ON" | "FOLLOWS" | "CONTRASTS_WITH" | "REFERENCES" | "BELONGS_TO" | undefined;
+    relation_id?: number | undefined;
+}>;
+export declare class RemoveRelationTool extends BaseTool {
+    constructor();
+    /**
+     * Given: relation_id 또는 source_id/target_id/relation_type
+     * When: 관계 삭제 수행
+     * Then: 삭제 성공 여부 반환
+     */
+    handle(params: z.infer<typeof RemoveRelationSchema>, context: ToolContext): Promise<ToolResult>;
+}
+export {};
+//# sourceMappingURL=remove-relation-tool.d.ts.map

package/dist/domains/relation/tools/remove-relation-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-relation-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/relation/tools/remove-relation-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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;AAKvE,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;EAgBzB,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,QAAQ;;IA8B9C;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAoGtG"}

package/dist/domains/relation/tools/remove-relation-tool.js

@@ -0,0 +1,142 @@
+/**
+ * Remove Relation Tool - 관계 삭제 도구
+ * 메모리 간의 관계를 삭제합니다.
+ * relation_id 또는 source_id/target_id/relation_type 조합으로 삭제 가능합니다.
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import { DatabaseUtils } from '../../../shared/utils/database.js';
+import { RelationGraph } from '../services/relation-graph.js';
+const RemoveRelationSchema = z.object({
+    relation_id: z.number().int().positive().optional().describe('관계 ID (relation_id 또는 source_id/target_id/relation_type 조합 중 하나는 필수)'),
+    source_id: z.string().min(1).optional().describe('소스 메모리 ID'),
+    target_id: z.string().min(1).optional().describe('타겟 메모리 ID'),
+    relation_type: z.enum(['CAUSES', 'DEPENDS_ON', 'FOLLOWS', 'CONTRASTS_WITH', 'REFERENCES', 'BELONGS_TO']).optional().describe('관계 유형')
+}).refine((data) => {
+    // relation_id가 있거나, source_id/target_id/relation_type이 모두 있어야 함
+    if (data.relation_id) {
+        return true;
+    }
+    return !!(data.source_id && data.target_id && data.relation_type);
+}, {
+    message: 'relation_id 또는 source_id/target_id/relation_type 조합 중 하나는 필수입니다'
+});
+export class RemoveRelationTool extends BaseTool {
+    constructor() {
+        super('remove_relation', '메모리 간의 관계를 삭제합니다. relation_id 또는 source_id/target_id/relation_type 조합으로 삭제 가능합니다.', {
+            type: 'object',
+            properties: {
+                relation_id: {
+                    type: 'number',
+                    description: '관계 ID (relation_id 또는 source_id/target_id/relation_type 조합 중 하나는 필수)'
+                },
+                source_id: {
+                    type: 'string',
+                    description: '소스 메모리 ID'
+                },
+                target_id: {
+                    type: 'string',
+                    description: '타겟 메모리 ID'
+                },
+                relation_type: {
+                    type: 'string',
+                    enum: ['CAUSES', 'DEPENDS_ON', 'FOLLOWS', 'CONTRASTS_WITH', 'REFERENCES', 'BELONGS_TO'],
+                    description: '관계 유형'
+                }
+            }
+        });
+    }
+    /**
+     * Given: relation_id 또는 source_id/target_id/relation_type
+     * When: 관계 삭제 수행
+     * Then: 삭제 성공 여부 반환
+     */
+    async handle(params, context) {
+        const parsed = RemoveRelationSchema.parse(params);
+        const db = context.db;
+        try {
+            // RelationGraph 인스턴스 생성 (context에 없으면 새로 생성)
+            const relationGraph = context.services.relationGraph || new RelationGraph(db);
+            let deleted = false;
+            let relationInfo = null;
+            // Given: relation_id로 삭제
+            if (parsed.relation_id) {
+                // 관계 정보 조회
+                const relation = DatabaseUtils.get(db, `
+          SELECT source_id, target_id, relation_type
+          FROM memory_relation
+          WHERE id = ?
+        `, [parsed.relation_id]);
+                if (!relation) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: 'RELATION_NOT_FOUND',
+                                    message: `관계를 찾을 수 없습니다: relation_id=${parsed.relation_id}`
+                                }, null, 2)
+                            }]
+                    };
+                }
+                relationInfo = relation;
+                // When: removeRelation 메서드 사용 (캐시 무효화 포함)
+                deleted = await relationGraph.removeRelation(relation.source_id, relation.target_id, relation.relation_type);
+            }
+            else {
+                // Given: source_id/target_id/relation_type 조합으로 삭제
+                const { source_id, target_id, relation_type } = parsed;
+                if (!source_id || !target_id || !relation_type) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: 'INVALID_PARAMS',
+                                    message: 'source_id, target_id, relation_type이 모두 필요합니다'
+                                }, null, 2)
+                            }]
+                    };
+                }
+                relationInfo = { source_id, target_id, relation_type };
+                // When: removeRelation 메서드 사용
+                deleted = await relationGraph.removeRelation(source_id, target_id, relation_type);
+            }
+            // Then: 결과 반환
+            if (deleted && relationInfo) {
+                return this.createSuccessResult({
+                    deleted: true,
+                    ...relationInfo,
+                    message: `관계가 삭제되었습니다: ${relationInfo.source_id} --[${relationInfo.relation_type}]--> ${relationInfo.target_id}`
+                });
+            }
+            else {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'RELATION_NOT_FOUND',
+                                message: relationInfo
+                                    ? `관계를 찾을 수 없습니다: ${relationInfo.source_id} --[${relationInfo.relation_type}]--> ${relationInfo.target_id}`
+                                    : '관계를 찾을 수 없습니다'
+                            }, null, 2)
+                        }]
+                };
+            }
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: 'REMOVE_RELATION_FAILED',
+                            message: error instanceof Error ? error.message : String(error)
+                        }, null, 2)
+                    }]
+            };
+        }
+    }
+}
+//# sourceMappingURL=remove-relation-tool.js.map

package/dist/domains/relation/tools/remove-relation-tool.js.map

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

package/dist/domains/relation/tools/visualize-relations-tool.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Visualize Relations Tool - 관계 그래프 시각화 도구
+ * 메모리 간의 관계를 시각화합니다.
+ */
+import { z } from 'zod';
+import { BaseTool } from '../../../tools/base-tool.js';
+import type { ToolContext, ToolResult } from '../../../tools/types.js';
+declare const VisualizeRelationsSchema: z.ZodObject<{
+    memory_id: z.ZodString;
+    max_depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["text", "subgraph", "simple", "json"]>>>;
+    min_confidence: z.ZodOptional<z.ZodNumber>;
+    relation_types: z.ZodOptional<z.ZodArray<z.ZodEnum<["CAUSES", "DEPENDS_ON", "FOLLOWS", "CONTRASTS_WITH", "REFERENCES", "BELONGS_TO"]>, "many">>;
+    show_memory_ids: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    show_confidence: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    show_relation_types: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    memory_id: string;
+    max_depth: number;
+    format: "text" | "json" | "subgraph" | "simple";
+    show_memory_ids: boolean;
+    show_confidence: boolean;
+    show_relation_types: boolean;
+    min_confidence?: number | undefined;
+    relation_types?: ("CAUSES" | "DEPENDS_ON" | "FOLLOWS" | "CONTRASTS_WITH" | "REFERENCES" | "BELONGS_TO")[] | undefined;
+}, {
+    memory_id: string;
+    max_depth?: number | undefined;
+    format?: "text" | "json" | "subgraph" | "simple" | undefined;
+    min_confidence?: number | undefined;
+    relation_types?: ("CAUSES" | "DEPENDS_ON" | "FOLLOWS" | "CONTRASTS_WITH" | "REFERENCES" | "BELONGS_TO")[] | undefined;
+    show_memory_ids?: boolean | undefined;
+    show_confidence?: boolean | undefined;
+    show_relation_types?: boolean | undefined;
+}>;
+export declare class VisualizeRelationsTool extends BaseTool {
+    constructor();
+    /**
+     * Given: memory_id, max_depth, format, 옵션들
+     * When: 관계 그래프 시각화 수행
+     * Then: 시각화된 텍스트 반환
+     */
+    handle(params: z.infer<typeof VisualizeRelationsSchema>, context: ToolContext): Promise<ToolResult>;
+}
+export {};
+//# sourceMappingURL=visualize-relations-tool.d.ts.map

package/dist/domains/relation/tools/visualize-relations-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualize-relations-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/relation/tools/visualize-relations-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;AAKvE,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,qBAAa,sBAAuB,SAAQ,QAAQ;;IA4DlD;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAgG1G"}