memento-mcp-server 1.14.0-b → 1.15.0-c

package/dist/shared/utils/pii-masker.js

@@ -0,0 +1,205 @@
+/**
+ * PII (Personally Identifiable Information) 마스킹 유틸리티
+ *
+ * 로그 파일에 저장되는 rawLLMOutput에서 민감한 정보를 마스킹합니다.
+ *
+ * 마스킹 대상:
+ * - 이메일 주소
+ * - 전화번호
+ * - API 키
+ * - 비밀번호
+ * - 토큰 (Bearer, JWT 등)
+ * - 기타 credential 정보
+ *
+ * 보안 정책:
+ * - 모든 민감 정보는 [TYPE] 형식으로 마스킹
+ * - 원본 정보는 복구 불가능하도록 완전히 제거
+ */
+/**
+ * PII 마스킹기
+ */
+export class PIIMasker {
+    /**
+     * 텍스트에서 모든 PII를 마스킹합니다.
+     *
+     * @param text 원본 텍스트
+     * @param options 마스킹 옵션
+     * @returns 마스킹 결과
+     */
+    static mask(text, options = {}) {
+        if (!text || typeof text !== 'string') {
+            return {
+                masked: text || '',
+                maskedCount: 0,
+                maskedTypes: []
+            };
+        }
+        const usePlaceholder = options.usePlaceholder !== false;
+        const types = options.types || ['email', 'phone', 'api_key', 'password', 'token', 'credential'];
+        let masked = text;
+        const maskedTypes = [];
+        let totalMaskedCount = 0;
+        // 이메일 주소 마스킹
+        if (types.includes('email')) {
+            const emailPattern = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g;
+            const emailMatches = masked.match(emailPattern);
+            if (emailMatches) {
+                masked = masked.replace(emailPattern, usePlaceholder ? '[EMAIL]' : '');
+                maskedTypes.push('email');
+                totalMaskedCount += emailMatches.length;
+            }
+        }
+        // 전화번호 마스킹 (한국 형식 포함)
+        if (types.includes('phone')) {
+            // 한국 전화번호: 010-1234-5678, 01012345678, +82-10-1234-5678 등
+            const koreanPhonePattern = /(\+82[-.\s]?)?0?1[0-9]{1}[-.\s]?[0-9]{3,4}[-.\s]?[0-9]{4}/g;
+            const koreanMatches = masked.match(koreanPhonePattern);
+            if (koreanMatches) {
+                masked = masked.replace(koreanPhonePattern, usePlaceholder ? '[PHONE]' : '');
+                if (!maskedTypes.includes('phone')) {
+                    maskedTypes.push('phone');
+                }
+                totalMaskedCount += koreanMatches.length;
+            }
+            // 국제 전화번호: +1-234-567-8900 등
+            const internationalPhonePattern = /\+\d{1,3}[-.\s]?\d{1,4}[-.\s]?\d{1,4}[-.\s]?\d{1,9}/g;
+            const internationalMatches = masked.match(internationalPhonePattern);
+            if (internationalMatches) {
+                masked = masked.replace(internationalPhonePattern, usePlaceholder ? '[PHONE]' : '');
+                if (!maskedTypes.includes('phone')) {
+                    maskedTypes.push('phone');
+                }
+                totalMaskedCount += internationalMatches.length;
+            }
+        }
+        // API 키 마스킹
+        if (types.includes('api_key')) {
+            // OpenAI API 키: sk-... 또는 sk-proj-...
+            const openaiKeyPattern = /sk-[a-zA-Z0-9]{32,}/g;
+            const openaiMatches = masked.match(openaiKeyPattern);
+            if (openaiMatches) {
+                masked = masked.replace(openaiKeyPattern, usePlaceholder ? '[API_KEY]' : '');
+                if (!maskedTypes.includes('api_key')) {
+                    maskedTypes.push('api_key');
+                }
+                totalMaskedCount += openaiMatches.length;
+            }
+            // Google API 키: AIza...
+            const googleKeyPattern = /AIza[0-9A-Za-z_-]{35}/g;
+            const googleMatches = masked.match(googleKeyPattern);
+            if (googleMatches) {
+                masked = masked.replace(googleKeyPattern, usePlaceholder ? '[API_KEY]' : '');
+                if (!maskedTypes.includes('api_key')) {
+                    maskedTypes.push('api_key');
+                }
+                totalMaskedCount += googleMatches.length;
+            }
+            // 일반 API 키 패턴: api_key=..., apikey=... 등
+            const generalApiKeyPattern = /\b(api[_-]?key|apikey)[=:]\s*[a-zA-Z0-9_-]{20,}/gi;
+            const generalMatches = masked.match(generalApiKeyPattern);
+            if (generalMatches) {
+                masked = masked.replace(generalApiKeyPattern, (match) => {
+                    const prefix = match.match(/^[^=:]+[=:]\s*/)?.[0] || '';
+                    return prefix + (usePlaceholder ? '[API_KEY]' : '');
+                });
+                if (!maskedTypes.includes('api_key')) {
+                    maskedTypes.push('api_key');
+                }
+                totalMaskedCount += generalMatches.length;
+            }
+        }
+        // 비밀번호 마스킹
+        if (types.includes('password')) {
+            const passwordPattern = /\b(password|pwd|passwd)[=:]\s*[^\s&"']+/gi;
+            const passwordMatches = masked.match(passwordPattern);
+            if (passwordMatches) {
+                masked = masked.replace(passwordPattern, (match) => {
+                    const prefix = match.match(/^[^=:]+[=:]\s*/)?.[0] || '';
+                    return prefix + (usePlaceholder ? '[PASSWORD]' : '');
+                });
+                maskedTypes.push('password');
+                totalMaskedCount += passwordMatches.length;
+            }
+        }
+        // 토큰 마스킹 (Bearer, JWT 등)
+        if (types.includes('token')) {
+            // Bearer 토큰
+            const bearerTokenPattern = /\b(bearer|token)[=:]\s*[a-zA-Z0-9._-]{20,}/gi;
+            const bearerMatches = masked.match(bearerTokenPattern);
+            if (bearerMatches) {
+                masked = masked.replace(bearerTokenPattern, (match) => {
+                    const prefix = match.match(/^[^=:]+[=:]\s*/)?.[0] || '';
+                    return prefix + (usePlaceholder ? '[TOKEN]' : '');
+                });
+                maskedTypes.push('token');
+                totalMaskedCount += bearerMatches.length;
+            }
+            // JWT 토큰 (xxx.yyy.zzz 형식)
+            const jwtPattern = /\beyJ[a-zA-Z0-9_-]+\.[a-zA-Z0-9_-]+\.[a-zA-Z0-9_-]+/g;
+            const jwtMatches = masked.match(jwtPattern);
+            if (jwtMatches) {
+                masked = masked.replace(jwtPattern, usePlaceholder ? '[JWT_TOKEN]' : '');
+                if (!maskedTypes.includes('token')) {
+                    maskedTypes.push('token');
+                }
+                totalMaskedCount += jwtMatches.length;
+            }
+        }
+        // 기타 credential 정보 마스킹
+        if (types.includes('credential')) {
+            // secret=..., key=..., token=... 등 (이미 마스킹된 것은 제외)
+            const credentialPattern = /\b(secret|key|token|credential)[=:]\s*[a-zA-Z0-9._-]{10,}/gi;
+            const credentialMatches = masked.match(credentialPattern);
+            if (credentialMatches) {
+                // 이미 마스킹된 패턴은 제외 (예: [API_KEY], [TOKEN] 등)
+                const filteredMatches = credentialMatches.filter(match => !match.includes('[API_KEY]') &&
+                    !match.includes('[TOKEN]') &&
+                    !match.includes('[PASSWORD]'));
+                if (filteredMatches.length > 0) {
+                    masked = masked.replace(credentialPattern, (match) => {
+                        // 이미 마스킹된 것은 건너뛰기
+                        if (match.includes('[') && match.includes(']')) {
+                            return match;
+                        }
+                        const prefix = match.match(/^[^=:]+[=:]\s*/)?.[0] || '';
+                        return prefix + (usePlaceholder ? '[CREDENTIAL]' : '');
+                    });
+                    maskedTypes.push('credential');
+                    totalMaskedCount += filteredMatches.length;
+                }
+            }
+        }
+        return {
+            masked,
+            maskedCount: totalMaskedCount,
+            maskedTypes: [...new Set(maskedTypes)] // 중복 제거
+        };
+    }
+    /**
+     * 텍스트에 PII가 포함되어 있는지 확인합니다.
+     *
+     * @param text 확인할 텍스트
+     * @returns PII 포함 여부
+     */
+    static hasPII(text) {
+        if (!text || typeof text !== 'string') {
+            return false;
+        }
+        const result = this.mask(text, { usePlaceholder: false });
+        return result.maskedCount > 0;
+    }
+    /**
+     * 텍스트에서 마스킹된 PII 타입 목록을 반환합니다.
+     *
+     * @param text 확인할 텍스트
+     * @returns 마스킹된 타입 목록
+     */
+    static detectPIITypes(text) {
+        if (!text || typeof text !== 'string') {
+            return [];
+        }
+        const result = this.mask(text, { usePlaceholder: false });
+        return result.maskedTypes;
+    }
+}
+//# sourceMappingURL=pii-masker.js.map

package/dist/shared/utils/pii-masker.js.map

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

package/dist/shared/utils/prompt-template-loader.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 프롬프트 템플릿 로더 유틸리티
+ * prompts/ 디렉토리에서 템플릿 파일을 읽고 플레이스홀더를 치환합니다.
+ */
+/**
+ * 프롬프트 템플릿 로더
+ */
+export declare class PromptTemplateLoader {
+    /**
+     * 템플릿 파일 로드
+     *
+     * @param templateName 템플릿 파일명 (예: 'triple-extraction')
+     * @returns 템플릿 내용
+     * @throws 파일이 없거나 읽을 수 없는 경우 에러 발생
+     */
+    static loadTemplate(templateName: string): string;
+    /**
+     * 템플릿에 변수 치환
+     *
+     * @param template 템플릿 문자열
+     * @param variables 변수 객체 (예: { observation: '...' })
+     * @returns 치환된 템플릿
+     */
+    static renderTemplate(template: string, variables: Record<string, string>): string;
+    /**
+     * 템플릿 파일을 로드하고 변수 치환
+     *
+     * @param templateName 템플릿 파일명
+     * @param variables 변수 객체
+     * @returns 치환된 프롬프트
+     */
+    static loadAndRender(templateName: string, variables: Record<string, string>): string;
+    /**
+     * 캐시 초기화 (테스트용)
+     */
+    static clearCache(): void;
+    /**
+     * 템플릿 파일 경로 확인 (테스트용)
+     */
+    static getTemplatePath(templateName: string): string;
+}
+//# sourceMappingURL=prompt-template-loader.d.ts.map

package/dist/shared/utils/prompt-template-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-template-loader.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/prompt-template-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAyBjD;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAYlF;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAKrF;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAGrD"}

package/dist/shared/utils/prompt-template-loader.js

@@ -0,0 +1,92 @@
+/**
+ * 프롬프트 템플릿 로더 유틸리티
+ * prompts/ 디렉토리에서 템플릿 파일을 읽고 플레이스홀더를 치환합니다.
+ */
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * 프로젝트 루트 디렉토리 경로
+ * src/shared/utils/에서 prompts/로 가려면 ../../prompts/
+ */
+const PROJECT_ROOT = join(__dirname, '../../..');
+const PROMPTS_DIR = join(PROJECT_ROOT, 'prompts');
+/**
+ * 템플릿 캐시 (메모리 캐시)
+ */
+const templateCache = new Map();
+/**
+ * 프롬프트 템플릿 로더
+ */
+export class PromptTemplateLoader {
+    /**
+     * 템플릿 파일 로드
+     *
+     * @param templateName 템플릿 파일명 (예: 'triple-extraction')
+     * @returns 템플릿 내용
+     * @throws 파일이 없거나 읽을 수 없는 경우 에러 발생
+     */
+    static loadTemplate(templateName) {
+        // 캐시 확인
+        if (templateCache.has(templateName)) {
+            return templateCache.get(templateName);
+        }
+        // 파일 경로 구성
+        const templatePath = join(PROMPTS_DIR, `${templateName}.txt`);
+        try {
+            // 파일 읽기
+            const content = readFileSync(templatePath, 'utf-8');
+            // 캐시에 저장
+            templateCache.set(templateName, content);
+            return content;
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                throw new Error(`프롬프트 템플릿 파일을 찾을 수 없습니다: ${templatePath}`);
+            }
+            throw new Error(`프롬프트 템플릿 파일 읽기 실패: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 템플릿에 변수 치환
+     *
+     * @param template 템플릿 문자열
+     * @param variables 변수 객체 (예: { observation: '...' })
+     * @returns 치환된 템플릿
+     */
+    static renderTemplate(template, variables) {
+        let rendered = template;
+        // {variable} 형태의 플레이스홀더를 변수 값으로 치환
+        for (const [key, value] of Object.entries(variables)) {
+            const placeholder = `{${key}}`;
+            rendered = rendered.replace(new RegExp(placeholder.replace(/[{}]/g, '\\$&'), 'g'), value);
+        }
+        return rendered;
+    }
+    /**
+     * 템플릿 파일을 로드하고 변수 치환
+     *
+     * @param templateName 템플릿 파일명
+     * @param variables 변수 객체
+     * @returns 치환된 프롬프트
+     */
+    static loadAndRender(templateName, variables) {
+        const template = this.loadTemplate(templateName);
+        return this.renderTemplate(template, variables);
+    }
+    /**
+     * 캐시 초기화 (테스트용)
+     */
+    static clearCache() {
+        templateCache.clear();
+    }
+    /**
+     * 템플릿 파일 경로 확인 (테스트용)
+     */
+    static getTemplatePath(templateName) {
+        return join(PROMPTS_DIR, `${templateName}.txt`);
+    }
+}
+//# sourceMappingURL=prompt-template-loader.js.map

package/dist/shared/utils/prompt-template-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-template-loader.js","sourceRoot":"","sources":["../../../src/shared/utils/prompt-template-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;;GAGG;AACH,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,YAAoB;QACtC,QAAQ;QACR,IAAI,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACpC,OAAO,aAAa,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC;QAC1C,CAAC;QAED,WAAW;QACX,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,YAAY,MAAM,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,QAAQ;YACR,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAEpD,SAAS;YACT,aAAa,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAEzC,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACzE,MAAM,IAAI,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,QAAgB,EAAE,SAAiC;QACvE,IAAI,QAAQ,GAAG,QAAQ,CAAC;QAExB,mCAAmC;QACnC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,MAAM,WAAW,GAAG,IAAI,GAAG,GAAG,CAAC;YAC/B,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5F,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,YAAoB,EAAE,SAAiC;QAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU;QACf,aAAa,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,YAAoB;QACzC,OAAO,IAAI,CAAC,WAAW,EAAE,GAAG,YAAY,MAAM,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/shared/utils/triple-cache.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Triple 추출 결과 캐시 서비스
+ *
+ * PRD 7.3: 캐싱 (TTL 조정 및 설정 가능)
+ * - 동일한 content에 대한 Triple 추출 결과 캐싱
+ * - 캐시 키: content의 해시값 (content_hash)
+ * - 캐싱 TTL: 6시간 (기본값, 설정 가능)
+ * - 캐시 크기: 100개 항목 (설정 가능)
+ * - LRU 캐시 활용
+ */
+import type { TripleExtractionResult } from '../types/triple-extraction.js';
+/**
+ * Triple 추출 결과 캐시 서비스
+ */
+export declare class TripleCacheService {
+    private cache;
+    private readonly defaultTTL;
+    private readonly maxSize;
+    /**
+     * @param maxSize 최대 캐시 크기 (기본값: 100)
+     * @param ttl TTL (밀리초, 기본값: 6시간)
+     */
+    constructor(maxSize?: number, ttl?: number);
+    /**
+     * 캐시 키 생성 (content_hash 기반)
+     *
+     * PRD 6.12: 캐시 키 생성 로직 구현
+     * - content의 해시값을 사용하여 캐시 키 생성
+     * - SHA-256 해시 사용 (충돌 방지)
+     *
+     * @param content Episodic Memory의 content (observation 텍스트)
+     * @returns 캐시 키
+     */
+    generateCacheKey(content: string): string;
+    /**
+     * 캐시에서 Triple 추출 결과 가져오기
+     *
+     * PRD 6.14: TripleExtractionService에 캐싱 통합
+     * - 캐시 히트 시 LLM 호출 생략
+     *
+     * @param content Episodic Memory의 content
+     * @returns Triple 추출 결과 또는 null (캐시 미스)
+     */
+    get(content: string): TripleExtractionResult | null;
+    /**
+     * 캐시에 Triple 추출 결과 저장
+     *
+     * PRD 6.14: TripleExtractionService에 캐싱 통합
+     * - 성공한 Triple 추출 결과만 캐시에 저장
+     *
+     * @param content Episodic Memory의 content
+     * @param result Triple 추출 결과
+     * @param ttl TTL (밀리초, 선택사항, 기본값 사용)
+     */
+    set(content: string, result: TripleExtractionResult, ttl?: number): void;
+    /**
+     * 캐시에서 항목 삭제
+     *
+     * @param content Episodic Memory의 content
+     * @returns 삭제 성공 여부
+     */
+    delete(content: string): boolean;
+    /**
+     * 캐시 비우기
+     */
+    clear(): void;
+    /**
+     * 캐시 통계 반환
+     *
+     * @returns 캐시 통계
+     */
+    getStats(): import("../../infrastructure/cache/cache-service.js").CacheStats;
+    /**
+     * TTL 기반 자동 무효화
+     *
+     * PRD 6.13: 캐시 TTL 기반 자동 무효화 구현
+     * - 만료된 항목 자동 제거
+     * - CacheService의 내장 TTL 체크 활용
+     *
+     * @returns 정리된 항목 수
+     */
+    cleanup(): number;
+    /**
+     * 캐시 크기 반환
+     *
+     * @returns 현재 캐시 크기
+     */
+    size(): number;
+}
+//# sourceMappingURL=triple-cache.d.ts.map

package/dist/shared/utils/triple-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triple-cache.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/triple-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAG5E;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;OAGG;gBACS,OAAO,GAAE,MAAY,EAAE,GAAG,GAAE,MAA2B;IAMnE;;;;;;;;;OASG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAQzC;;;;;;;;OAQG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAKnD;;;;;;;;;OASG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IASxE;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,QAAQ;IAIR;;;;;;;;OAQG;IACH,OAAO,IAAI,MAAM;IAMjB;;;;OAIG;IACH,IAAI,IAAI,MAAM;CAGf"}

package/dist/shared/utils/triple-cache.js

@@ -0,0 +1,124 @@
+/**
+ * Triple 추출 결과 캐시 서비스
+ *
+ * PRD 7.3: 캐싱 (TTL 조정 및 설정 가능)
+ * - 동일한 content에 대한 Triple 추출 결과 캐싱
+ * - 캐시 키: content의 해시값 (content_hash)
+ * - 캐싱 TTL: 6시간 (기본값, 설정 가능)
+ * - 캐시 크기: 100개 항목 (설정 가능)
+ * - LRU 캐시 활용
+ */
+import { CacheService } from '../../infrastructure/cache/cache-service.js';
+import { createHash } from 'crypto';
+/**
+ * Triple 추출 결과 캐시 서비스
+ */
+export class TripleCacheService {
+    cache;
+    defaultTTL;
+    maxSize;
+    /**
+     * @param maxSize 최대 캐시 크기 (기본값: 100)
+     * @param ttl TTL (밀리초, 기본값: 6시간)
+     */
+    constructor(maxSize = 100, ttl = 6 * 60 * 60 * 1000) {
+        this.maxSize = maxSize;
+        this.defaultTTL = ttl;
+        this.cache = new CacheService(maxSize, ttl);
+    }
+    /**
+     * 캐시 키 생성 (content_hash 기반)
+     *
+     * PRD 6.12: 캐시 키 생성 로직 구현
+     * - content의 해시값을 사용하여 캐시 키 생성
+     * - SHA-256 해시 사용 (충돌 방지)
+     *
+     * @param content Episodic Memory의 content (observation 텍스트)
+     * @returns 캐시 키
+     */
+    generateCacheKey(content) {
+        // PRD 6.12: content_hash 기반 캐시 키 생성
+        // SHA-256 해시 사용하여 충돌 방지
+        const hash = createHash('sha256');
+        hash.update(content);
+        return `triple:${hash.digest('hex')}`;
+    }
+    /**
+     * 캐시에서 Triple 추출 결과 가져오기
+     *
+     * PRD 6.14: TripleExtractionService에 캐싱 통합
+     * - 캐시 히트 시 LLM 호출 생략
+     *
+     * @param content Episodic Memory의 content
+     * @returns Triple 추출 결과 또는 null (캐시 미스)
+     */
+    get(content) {
+        const cacheKey = this.generateCacheKey(content);
+        return this.cache.get(cacheKey);
+    }
+    /**
+     * 캐시에 Triple 추출 결과 저장
+     *
+     * PRD 6.14: TripleExtractionService에 캐싱 통합
+     * - 성공한 Triple 추출 결과만 캐시에 저장
+     *
+     * @param content Episodic Memory의 content
+     * @param result Triple 추출 결과
+     * @param ttl TTL (밀리초, 선택사항, 기본값 사용)
+     */
+    set(content, result, ttl) {
+        // PRD 7.3: 성공한 Triple 추출 결과만 캐시에 저장
+        // 실패한 결과는 캐시하지 않음 (재시도 가능성 고려)
+        if (result.triples.length > 0) {
+            const cacheKey = this.generateCacheKey(content);
+            this.cache.set(cacheKey, result, ttl);
+        }
+    }
+    /**
+     * 캐시에서 항목 삭제
+     *
+     * @param content Episodic Memory의 content
+     * @returns 삭제 성공 여부
+     */
+    delete(content) {
+        const cacheKey = this.generateCacheKey(content);
+        return this.cache.delete(cacheKey);
+    }
+    /**
+     * 캐시 비우기
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * 캐시 통계 반환
+     *
+     * @returns 캐시 통계
+     */
+    getStats() {
+        return this.cache.getStats();
+    }
+    /**
+     * TTL 기반 자동 무효화
+     *
+     * PRD 6.13: 캐시 TTL 기반 자동 무효화 구현
+     * - 만료된 항목 자동 제거
+     * - CacheService의 내장 TTL 체크 활용
+     *
+     * @returns 정리된 항목 수
+     */
+    cleanup() {
+        // CacheService의 cleanup 메서드 호출
+        // TTL이 만료된 항목 자동 제거
+        return this.cache.cleanup();
+    }
+    /**
+     * 캐시 크기 반환
+     *
+     * @returns 현재 캐시 크기
+     */
+    size() {
+        return this.cache.size();
+    }
+}
+//# sourceMappingURL=triple-cache.js.map

package/dist/shared/utils/triple-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triple-cache.js","sourceRoot":"","sources":["../../../src/shared/utils/triple-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,KAAK,CAAuC;IACnC,UAAU,CAAS;IACnB,OAAO,CAAS;IAEjC;;;OAGG;IACH,YAAY,UAAkB,GAAG,EAAE,MAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QACjE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAyB,OAAO,EAAE,GAAG,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;OASG;IACH,gBAAgB,CAAC,OAAe;QAC9B,oCAAoC;QACpC,wBAAwB;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,GAAG,CAAC,OAAe;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;OASG;IACH,GAAG,CAAC,OAAe,EAAE,MAA8B,EAAE,GAAY;QAC/D,oCAAoC;QACpC,+BAA+B;QAC/B,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAe;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO;QACL,+BAA+B;QAC/B,oBAAoB;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/tools/index.d.ts

@@ -16,6 +16,7 @@ import { SearchLocalTool } from '../domains/anchor/tools/search-local-tool.js';
 import { ClearAnchorTool } from '../domains/anchor/tools/clear-anchor-tool.js';
 import { RestoreAnchorsTool } from '../domains/anchor/tools/restore-anchors-tool.js';
 import { MigrateEmbeddingsTool } from './migrate-embeddings-tool.js';
+import { ConvertEpisodicToSemanticTool } from '../domains/memory/tools/convert-episodic-to-semantic-tool.js';
 /**
  * MCP 클라이언트용 도구 레지스트리 생성 및 등록
  */
@@ -36,5 +37,5 @@ export declare function getAllTools(): import("./types.js").ToolDefinition[];
  * 도구 실행
  */
 export declare function executeTool(name: string, params: any, context: any): Promise<import("./types.js").ToolResult>;
-export { RememberTool, RecallTool, ForgetTool, PinTool, UnpinTool, MemoryInjectionPrompt, GetMemoryNeighborsTool, SetAnchorTool, GetAnchorTool, SearchLocalTool, ClearAnchorTool, RestoreAnchorsTool, MigrateEmbeddingsTool, };
+export { RememberTool, RecallTool, ForgetTool, PinTool, UnpinTool, MemoryInjectionPrompt, GetMemoryNeighborsTool, SetAnchorTool, GetAnchorTool, SearchLocalTool, ClearAnchorTool, RestoreAnchorsTool, MigrateEmbeddingsTool, ConvertEpisodicToSemanticTool, };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AA4BrE;;GAEG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC;AAK/C;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,mDAEnC;AAED;;GAEG;AACH,wBAAgB,WAAW,0CAE1B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,4CAExE;AAGD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,qBAAqB,EACrB,sBAAsB,EAEtB,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,qBAAqB,GAEtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8DAA8D,CAAC;AA6B7G;;GAEG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC;AAK/C;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,mDAEnC;AAED;;GAEG;AACH,wBAAgB,WAAW,0CAE1B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,4CAExE;AAGD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,qBAAqB,EACrB,sBAAsB,EAEtB,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,6BAA6B,GAE9B,CAAC"}

package/dist/tools/index.js

@@ -16,6 +16,7 @@ import { SearchLocalTool } from '../domains/anchor/tools/search-local-tool.js';
 import { ClearAnchorTool } from '../domains/anchor/tools/clear-anchor-tool.js';
 import { RestoreAnchorsTool } from '../domains/anchor/tools/restore-anchors-tool.js';
 import { MigrateEmbeddingsTool } from './migrate-embeddings-tool.js';
+import { ConvertEpisodicToSemanticTool } from '../domains/memory/tools/convert-episodic-to-semantic-tool.js';
 // 관계 엔진 도구들은 HTTP API로만 제공 (MCP에서 제거)
 // 관계 추출은 remember 도구에서 자동으로 수행됨
 /**
@@ -37,6 +38,7 @@ const coreTools = [
     new ClearAnchorTool(),
     new RestoreAnchorsTool(),
     new MigrateEmbeddingsTool(),
+    new ConvertEpisodicToSemanticTool(), // AriGraph Pipeline 수동 변환 도구
     // 관계 엔진 도구들은 제거됨 (HTTP API로만 제공)
     // - extract_relations: remember에서 자동 실행
     // - get_relations, add_relation, remove_relation, visualize_relations: HTTP API로 제공
@@ -74,7 +76,7 @@ export async function executeTool(name, params, context) {
 // 핵심 도구들만 export
 export { RememberTool, RecallTool, ForgetTool, PinTool, UnpinTool, MemoryInjectionPrompt, GetMemoryNeighborsTool, 
 // 앵커 시스템 도구들
-SetAnchorTool, GetAnchorTool, SearchLocalTool, ClearAnchorTool, RestoreAnchorsTool, MigrateEmbeddingsTool,
+SetAnchorTool, GetAnchorTool, SearchLocalTool, ClearAnchorTool, RestoreAnchorsTool, MigrateEmbeddingsTool, ConvertEpisodicToSemanticTool,
 // 관계 엔진 도구들은 HTTP API로만 제공되므로 export하지 않음
  };
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,sCAAsC;AACtC,gCAAgC;AAEhC;;;GAGG;AACH,MAAM,SAAS,GAAG;IAChB,IAAI,YAAY,EAAE,EAAS,gBAAgB;IAC3C,IAAI,UAAU,EAAE;IAChB,IAAI,UAAU,EAAE;IAChB,IAAI,OAAO,EAAE;IACb,IAAI,SAAS,EAAE;IACf,IAAI,qBAAqB,EAAE;IAC3B,IAAI,sBAAsB,EAAE;IAC5B,aAAa;IACb,IAAI,aAAa,EAAE;IACnB,IAAI,aAAa,EAAE;IACnB,IAAI,eAAe,EAAE;IACrB,IAAI,eAAe,EAAE;IACrB,IAAI,kBAAkB,EAAE;IACxB,IAAI,qBAAqB,EAAE;IAC3B,iCAAiC;IACjC,wCAAwC;IACxC,oFAAoF;CACrF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;AAE/C,aAAa;AACb,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,MAAW,EAAE,OAAY;IACvE,OAAO,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,qBAAqB,EACrB,sBAAsB;AACtB,aAAa;AACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,qBAAqB;AACrB,0CAA0C;EAC3C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8DAA8D,CAAC;AAC7G,sCAAsC;AACtC,gCAAgC;AAEhC;;;GAGG;AACH,MAAM,SAAS,GAAG;IAChB,IAAI,YAAY,EAAE,EAAS,gBAAgB;IAC3C,IAAI,UAAU,EAAE;IAChB,IAAI,UAAU,EAAE;IAChB,IAAI,OAAO,EAAE;IACb,IAAI,SAAS,EAAE;IACf,IAAI,qBAAqB,EAAE;IAC3B,IAAI,sBAAsB,EAAE;IAC5B,aAAa;IACb,IAAI,aAAa,EAAE;IACnB,IAAI,aAAa,EAAE;IACnB,IAAI,eAAe,EAAE;IACrB,IAAI,eAAe,EAAE;IACrB,IAAI,kBAAkB,EAAE;IACxB,IAAI,qBAAqB,EAAE;IAC3B,IAAI,6BAA6B,EAAE,EAAE,6BAA6B;IAClE,iCAAiC;IACjC,wCAAwC;IACxC,oFAAoF;CACrF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;AAE/C,aAAa;AACb,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,MAAW,EAAE,OAAY;IACvE,OAAO,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,qBAAqB,EACrB,sBAAsB;AACtB,aAAa;AACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,6BAA6B;AAC7B,0CAA0C;EAC3C,CAAC"}

package/dist/tools/types.d.ts

@@ -91,5 +91,6 @@ export declare const CommonSchemas: {
     SkillName: z.ZodOptional<z.ZodString>;
     TriggerConditions: z.ZodOptional<z.ZodString>;
     UpdateMode: z.ZodOptional<z.ZodEnum<["replace", "incremental", "versioned"]>>;
+    EnableTripleExtraction: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 };
 //# sourceMappingURL=types.d.ts.map