memento-mcp-server 1.11.1 → 1.12.0-a1

package/dist/tools/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8DxB;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,EAAE,eAAe;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACtF,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC7C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC9C,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IACpD,oCAAoC;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IACjD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC/C,wBAAwB;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,cAAc;IAC5C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,cAAc;CACvD,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgExB;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,EAAE,eAAe;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACtF,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC7C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC9C,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IACpD,oCAAoC;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IACjD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC/C,wBAAwB;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,cAAc;IAC5C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,cAAc;CACvD,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Visualize Relations Tool - 관계 그래프 시각화 도구
+ * 메모리 간의 관계를 시각화합니다.
+ */
+import { z } from 'zod';
+import { BaseTool } from './base-tool.js';
+import type { ToolContext, ToolResult } from './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" | "simple" | "subgraph";
+    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" | "simple" | "subgraph" | 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/tools/visualize-relations-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualize-relations-tool.d.ts","sourceRoot":"","sources":["../../src/tools/visualize-relations-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK1D,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"}

package/dist/tools/visualize-relations-tool.js

@@ -0,0 +1,157 @@
+/**
+ * Visualize Relations Tool - 관계 그래프 시각화 도구
+ * 메모리 간의 관계를 시각화합니다.
+ */
+import { z } from 'zod';
+import { BaseTool } from './base-tool.js';
+import { DatabaseUtils } from '../utils/database.js';
+import { RelationGraph } from '../services/relation-graph.js';
+import { RelationVisualizer } from '../utils/relation-visualizer.js';
+const VisualizeRelationsSchema = z.object({
+    memory_id: z.string().min(1, 'memory_id는 필수입니다'),
+    max_depth: z.number().int().min(1).max(5).optional().default(2).describe('최대 깊이 (1~5, 기본값: 2)'),
+    format: z.enum(['text', 'subgraph', 'simple', 'json']).optional().default('subgraph').describe('시각화 형식 (text, subgraph, simple, json, 기본값: subgraph)'),
+    min_confidence: z.number().min(0).max(1).optional().describe('최소 신뢰도 (0.0~1.0)'),
+    relation_types: z.array(z.enum(['CAUSES', 'DEPENDS_ON', 'FOLLOWS', 'CONTRASTS_WITH', 'REFERENCES', 'BELONGS_TO'])).optional().describe('관계 유형 필터'),
+    show_memory_ids: z.boolean().optional().default(true).describe('메모리 ID 표시 여부 (기본값: true)'),
+    show_confidence: z.boolean().optional().default(true).describe('신뢰도 표시 여부 (기본값: true)'),
+    show_relation_types: z.boolean().optional().default(true).describe('관계 유형 표시 여부 (기본값: true)')
+});
+export class VisualizeRelationsTool extends BaseTool {
+    constructor() {
+        super('visualize_relations', '메모리 간의 관계를 시각화합니다. text, subgraph, simple, json 형식을 지원합니다.', {
+            type: 'object',
+            properties: {
+                memory_id: {
+                    type: 'string',
+                    description: '중심 메모리 ID'
+                },
+                max_depth: {
+                    type: 'number',
+                    minimum: 1,
+                    maximum: 5,
+                    description: '최대 깊이 (1~5, 기본값: 2)',
+                    default: 2
+                },
+                format: {
+                    type: 'string',
+                    enum: ['text', 'subgraph', 'simple', 'json'],
+                    description: '시각화 형식 (text, subgraph, simple, json, 기본값: subgraph)',
+                    default: 'subgraph'
+                },
+                min_confidence: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                    description: '최소 신뢰도 (0.0~1.0)'
+                },
+                relation_types: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['CAUSES', 'DEPENDS_ON', 'FOLLOWS', 'CONTRASTS_WITH', 'REFERENCES', 'BELONGS_TO']
+                    },
+                    description: '관계 유형 필터'
+                },
+                show_memory_ids: {
+                    type: 'boolean',
+                    description: '메모리 ID 표시 여부 (기본값: true)',
+                    default: true
+                },
+                show_confidence: {
+                    type: 'boolean',
+                    description: '신뢰도 표시 여부 (기본값: true)',
+                    default: true
+                },
+                show_relation_types: {
+                    type: 'boolean',
+                    description: '관계 유형 표시 여부 (기본값: true)',
+                    default: true
+                }
+            },
+            required: ['memory_id']
+        });
+    }
+    /**
+     * Given: memory_id, max_depth, format, 옵션들
+     * When: 관계 그래프 시각화 수행
+     * Then: 시각화된 텍스트 반환
+     */
+    async handle(params, context) {
+        const parsed = VisualizeRelationsSchema.parse(params);
+        const db = context.db;
+        try {
+            // Given: 메모리 존재 확인
+            const memory = DatabaseUtils.get(db, `
+        SELECT id FROM memory_item WHERE id = ?
+      `, [parsed.memory_id]);
+            if (!memory) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'MEMORY_NOT_FOUND',
+                                message: `메모리를 찾을 수 없습니다: ${parsed.memory_id}`
+                            }, null, 2)
+                        }]
+                };
+            }
+            // RelationGraph 인스턴스 생성 (context에 없으면 새로 생성)
+            const relationGraph = context.services.relationGraph || new RelationGraph(db);
+            // When: 관계 조회
+            const relations = await relationGraph.getRelations(parsed.memory_id, {
+                direction: 'both',
+                relationTypes: parsed.relation_types,
+                minConfidence: parsed.min_confidence
+            });
+            // 시각화 옵션 준비
+            const visualizationOptions = {
+                maxDepth: parsed.max_depth,
+                minConfidence: parsed.min_confidence,
+                relationTypes: parsed.relation_types,
+                showMemoryIds: parsed.show_memory_ids,
+                showConfidence: parsed.show_confidence,
+                showRelationTypes: parsed.show_relation_types
+            };
+            let visualization;
+            // Then: 형식에 따라 시각화
+            switch (parsed.format) {
+                case 'text':
+                    visualization = RelationVisualizer.visualizeAsText(relations, visualizationOptions);
+                    break;
+                case 'subgraph':
+                    visualization = RelationVisualizer.visualizeSubgraph(parsed.memory_id, relations, visualizationOptions);
+                    break;
+                case 'simple':
+                    visualization = RelationVisualizer.visualizeSimple(relations);
+                    break;
+                case 'json':
+                    visualization = RelationVisualizer.visualizeAsJSON(relations, true);
+                    break;
+                default:
+                    // 기본값: subgraph
+                    visualization = RelationVisualizer.visualizeSubgraph(parsed.memory_id, relations, visualizationOptions);
+            }
+            return this.createSuccessResult({
+                memory_id: parsed.memory_id,
+                format: parsed.format,
+                relation_count: relations.length,
+                visualization
+            });
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: 'VISUALIZATION_FAILED',
+                            message: error instanceof Error ? error.message : String(error)
+                        }, null, 2)
+                    }]
+            };
+        }
+    }
+}
+//# sourceMappingURL=visualize-relations-tool.js.map

package/dist/tools/visualize-relations-tool.js.map

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

package/dist/types/index.d.ts

@@ -31,6 +31,9 @@ export interface MemorySearchFilters {
     time_to?: string | undefined;
     pinned?: boolean | undefined;
 }
+export type { RelationCandidate, RelationType, RelationCategory, ExtractOptions, ExtractResult, IRelationExtractor } from './relation.js';
+export type { MemoryRelation, RelationMetadata, RelationDirection, GetRelationsOptions, GetRelatedMemoriesOptions, AddRelationOptions, IRelationGraph, RelationTypeRegistry } from './relation-graph.js';
+export { MEMORY_TYPE_RELATION_MAP, RELATION_TYPE_CATEGORY_MAP, RELATION_TYPE_BOOST_MAP, isApplicableRelationType, getRelationCategory, getRelationBoost } from './relation.js';
 export interface MemorySearchResult {
     id: string;
     content: string;
@@ -51,6 +54,7 @@ export interface SearchRankingWeights {
     duplication_penalty: number;
 }
 export type EmbeddingProvider = 'tfidf' | 'lightweight' | 'minilm' | 'openai' | 'gemini';
+export type LLMProvider = 'openai' | 'gemini' | 'ollama' | 'auto';
 export interface MementoConfig {
     dbPath: string;
     serverName: string;
@@ -59,9 +63,13 @@ export interface MementoConfig {
     embeddingProvider: EmbeddingProvider;
     openaiApiKey: string | undefined;
     openaiModel: string;
+    openaiLlmModel: string;
     geminiApiKey: string | undefined;
     geminiModel: string;
     embeddingDimensions: number;
+    llmProvider: LLMProvider;
+    ollamaBaseUrl: string;
+    ollamaModel: string;
     searchDefaultLimit: number;
     searchMaxLimit: number;
     forgetTTL: {

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

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

package/dist/types/index.js

@@ -8,4 +8,5 @@
 export function isMemoryItemType(type) {
     return type === 'working' || type === 'episodic' || type === 'semantic' || type === 'procedural';
 }
+export { MEMORY_TYPE_RELATION_MAP, RELATION_TYPE_CATEGORY_MAP, RELATION_TYPE_BOOST_MAP, isApplicableRelationType, getRelationCategory, getRelationBoost } from './relation.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,YAAY,CAAC;AACnG,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,YAAY,CAAC;AACnG,CAAC;AAkDD,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,eAAe,CAAC"}

package/dist/types/relation-graph.d.ts

@@ -0,0 +1,215 @@
+/**
+ * 관계 그래프 타입 정의
+ * 기억 간의 관계를 저장하고 관리하기 위한 타입들
+ */
+import type { RelationType, RelationCategory } from './relation.js';
+import type { MemoryType } from './index.js';
+/**
+ * 메모리 관계 (데이터베이스 저장용)
+ */
+export interface MemoryRelation {
+    id: number;
+    source_id: string;
+    target_id: string;
+    relation_type: RelationType;
+    confidence: number;
+    created_at: Date;
+    updated_at: Date;
+    metadata?: RelationMetadata;
+}
+/**
+ * 관계 메타데이터 (JSON 형식으로 저장)
+ */
+export interface RelationMetadata {
+    /**
+     * 추출 방법 ('rule' | 'llm')
+     */
+    method?: 'rule' | 'llm';
+    /**
+     * 추출 시점 타임스탬프
+     */
+    extracted_at?: string;
+    /**
+     * 순환 참조 여부
+     */
+    cyclic?: boolean;
+    /**
+     * 추출 근거 (키워드 또는 LLM 설명)
+     */
+    evidence?: string;
+    /**
+     * 신뢰도 개선 이력
+     */
+    refinement_history?: Array<{
+        timestamp: string;
+        old_confidence: number;
+        new_confidence: number;
+        reason: string;
+    }>;
+    /**
+     * 기타 메타데이터
+     */
+    [key: string]: any;
+}
+/**
+ * 관계 조회 방향
+ */
+export type RelationDirection = 'outgoing' | 'incoming' | 'both';
+/**
+ * 관계 조회 옵션
+ */
+export interface GetRelationsOptions {
+    /**
+     * 조회 방향 (기본값: 'both')
+     */
+    direction?: RelationDirection;
+    /**
+     * 관계 유형 필터
+     */
+    relationTypes?: RelationType[];
+    /**
+     * 최소 신뢰도 임계값
+     */
+    minConfidence?: number;
+    /**
+     * 최대 결과 수 제한
+     */
+    limit?: number;
+    /**
+     * 오프셋 (페이지네이션)
+     */
+    offset?: number;
+    /**
+     * 캐시 우회 여부 (기본값: false)
+     * 탐색 중에는 캐시를 우회하고 직접 쿼리하는 것이 더 효율적일 수 있습니다.
+     */
+    bypassCache?: boolean;
+}
+/**
+ * N-hop 관계 탐색 옵션
+ */
+export interface GetRelatedMemoriesOptions {
+    /**
+     * 최대 hop 수 (기본값: 2)
+     */
+    maxHops?: number;
+    /**
+     * 관계 유형 필터
+     */
+    relationTypes?: RelationType[];
+    /**
+     * 최소 신뢰도 임계값
+     */
+    minConfidence?: number;
+    /**
+     * 최대 결과 수 제한
+     */
+    limit?: number;
+    /**
+     * 순환 참조 포함 여부 (기본값: false)
+     */
+    includeCyclic?: boolean;
+}
+/**
+ * 관계 추가 옵션
+ */
+export interface AddRelationOptions {
+    /**
+     * 신뢰도 (기본값: 0.7)
+     */
+    confidence?: number;
+    /**
+     * 메타데이터
+     */
+    metadata?: RelationMetadata;
+    /**
+     * UNIQUE 제약 위반 시 업데이트 여부 (기본값: false)
+     */
+    updateOnConflict?: boolean;
+    /**
+     * 순환 참조 허용 여부 (기본값: false)
+     */
+    allowCyclic?: boolean;
+}
+/**
+ * 관계 그래프 인터페이스
+ */
+export interface IRelationGraph {
+    /**
+     * 관계 추가
+     *
+     * @param sourceId 소스 기억 ID
+     * @param targetId 타겟 기억 ID
+     * @param relationType 관계 유형
+     * @param options 추가 옵션
+     * @returns 추가된 관계 ID
+     * @throws 순환 참조가 감지되고 allowCyclic가 false인 경우
+     */
+    addRelation(sourceId: string, targetId: string, relationType: RelationType, options?: AddRelationOptions): Promise<number>;
+    /**
+     * 관계 조회
+     *
+     * @param memoryId 기억 ID
+     * @param options 조회 옵션
+     * @returns 관계 목록
+     */
+    getRelations(memoryId: string, options?: GetRelationsOptions): Promise<MemoryRelation[]>;
+    /**
+     * 관련 기억 조회 (N-hop 관계 탐색)
+     *
+     * @param memoryId 시작 기억 ID
+     * @param options 탐색 옵션
+     * @returns 관련 기억 ID 목록과 hop 거리
+     */
+    getRelatedMemories(memoryId: string, options?: GetRelatedMemoriesOptions): Promise<Array<{
+        memory_id: string;
+        hop_distance: number;
+        relation_path: Array<{
+            source_id: string;
+            target_id: string;
+            relation_type: RelationType;
+        }>;
+    }>>;
+    /**
+     * 관계 삭제
+     *
+     * @param sourceId 소스 기억 ID
+     * @param targetId 타겟 기억 ID
+     * @param relationType 관계 유형
+     * @returns 삭제 성공 여부
+     */
+    removeRelation(sourceId: string, targetId: string, relationType: RelationType): Promise<boolean>;
+    /**
+     * 신뢰도 갱신
+     *
+     * @param sourceId 소스 기억 ID
+     * @param targetId 타겟 기억 ID
+     * @param relationType 관계 유형
+     * @param newConfidence 새로운 신뢰도
+     * @param reason 갱신 이유
+     * @returns 갱신 성공 여부
+     */
+    updateConfidence(sourceId: string, targetId: string, relationType: RelationType, newConfidence: number, reason?: string): Promise<boolean>;
+    /**
+     * 순환 참조 감지
+     *
+     * @param sourceId 소스 기억 ID
+     * @param targetId 타겟 기억 ID
+     * @param relationType 관계 유형
+     * @returns 순환 참조 여부
+     */
+    detectCycle(sourceId: string, targetId: string, relationType: RelationType): Promise<boolean>;
+}
+/**
+ * 관계 타입 레지스트리 항목
+ */
+export interface RelationTypeRegistry {
+    type_name: RelationType;
+    category: RelationCategory;
+    description: string;
+    applicable_types: MemoryType[];
+    default_confidence: number;
+    search_boost: number;
+    created_at: Date;
+}
+//# sourceMappingURL=relation-graph.d.ts.map

package/dist/types/relation-graph.d.ts.map

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

package/dist/types/relation-graph.js

@@ -0,0 +1,6 @@
+/**
+ * 관계 그래프 타입 정의
+ * 기억 간의 관계를 저장하고 관리하기 위한 타입들
+ */
+export {};
+//# sourceMappingURL=relation-graph.js.map

package/dist/types/relation-graph.js.map

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

package/dist/types/relation.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 관계 추출 엔진 타입 정의
+ * 기억 간의 의미적 관계를 추출하고 관리하기 위한 타입들
+ */
+import type { MemoryItem, MemoryType } from './index.js';
+/**
+ * 관계 추출 후보
+ * 관계 추출 엔진이 발견한 잠재적 관계를 나타냅니다.
+ */
+export interface RelationCandidate {
+    source_id: string;
+    target_id: string;
+    relation_type: RelationType;
+    confidence: number;
+    method: 'rule' | 'llm';
+    evidence?: string;
+}
+/**
+ * 관계 유형
+ * 관계 추론 엔진에서 지원하는 관계 유형들
+ */
+export type RelationType = 'CAUSES' | 'DEPENDS_ON' | 'FOLLOWS' | 'CONTRASTS_WITH' | 'REFERENCES' | 'BELONGS_TO';
+/**
+ * 관계 카테고리
+ * 관계 유형을 그룹화하는 카테고리
+ */
+export type RelationCategory = 'Causal' | 'Temporal' | 'Structural' | 'Semantic';
+/**
+ * 관계 추출 옵션
+ */
+export interface ExtractOptions {
+    /**
+     * 추출 방법 강제 지정 ('rule' | 'llm' | 'hybrid')
+     * 기본값: 'hybrid' (규칙 기반 먼저 시도, 실패 시 LLM)
+     */
+    method?: 'rule' | 'llm' | 'hybrid';
+    /**
+     * 최소 신뢰도 임계값 (이 값 이상인 관계만 반환)
+     * 기본값: 0.5
+     */
+    minConfidence?: number;
+    /**
+     * 관계 추출 대상 기억 수 제한
+     * 기본값: 50 (규칙 기반), 30 (LLM)
+     */
+    candidateLimit?: number;
+    /**
+     * 관계 유형 필터 (특정 관계 유형만 추출)
+     */
+    relationTypes?: RelationType[];
+    /**
+     * 즉시 처리 여부 (false인 경우 배치 처리)
+     * 기본값: false
+     */
+    immediate?: boolean;
+}
+/**
+ * 관계 추출 결과
+ */
+export interface ExtractResult {
+    candidates: RelationCandidate[];
+    method: 'rule' | 'llm' | 'hybrid';
+    processingTime: number;
+    candidateCount: number;
+    extractedCount: number;
+}
+/**
+ * 관계 추출기 인터페이스
+ * 관계 추출 엔진이 구현해야 하는 인터페이스
+ */
+export interface IRelationExtractor {
+    /**
+     * 새로운 기억과 기존 기억들 간의 관계를 추출합니다.
+     *
+     * @param newMemory 새로운 기억
+     * @param existingMemories 기존 기억 목록
+     * @param options 추출 옵션
+     * @returns 관계 후보 목록
+     */
+    extractRelations(newMemory: MemoryItem, existingMemories: MemoryItem[], options?: ExtractOptions): Promise<RelationCandidate[]>;
+}
+/**
+ * 기억 타입별 적용 가능한 관계 유형 매핑
+ */
+export declare const MEMORY_TYPE_RELATION_MAP: Record<MemoryType, RelationType[]>;
+/**
+ * 관계 유형별 카테고리 매핑
+ */
+export declare const RELATION_TYPE_CATEGORY_MAP: Record<RelationType, RelationCategory>;
+/**
+ * 관계 유형별 검색 부스트 가중치 (기본값)
+ * 실제 값은 relation_type_registry 테이블에서 관리
+ */
+export declare const RELATION_TYPE_BOOST_MAP: Record<RelationType, number>;
+/**
+ * 기억 타입에 적용 가능한 관계 유형인지 확인
+ */
+export declare function isApplicableRelationType(memoryType: MemoryType, relationType: RelationType): boolean;
+/**
+ * 관계 유형의 카테고리를 반환
+ */
+export declare function getRelationCategory(relationType: RelationType): RelationCategory;
+/**
+ * 관계 유형의 검색 부스트 가중치를 반환
+ */
+export declare function getRelationBoost(relationType: RelationType): number;
+/**
+ * 모든 관계 유형 목록
+ * 여러 파일에서 중복 정의를 방지하기 위한 공통 상수
+ */
+export declare const ALL_RELATION_TYPES: readonly RelationType[];
+//# sourceMappingURL=relation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/types/relation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,YAAY,GACZ,SAAS,GACT,gBAAgB,GAChB,YAAY,GACZ,YAAY,CAAC;AAEjB;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAEnC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAE/B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,gBAAgB,CACd,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,UAAU,EAAE,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,CAKvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAO7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAOhE,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,GACzB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,gBAAgB,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EAO5C,CAAC"}