@jee1/memento-client 0.1.0

package/dist/context-injector.d.ts

@@ -0,0 +1,106 @@
+/**
+ * ContextInjector - AI Agent의 컨텍스트에 관련 기억을 주입하는 클래스
+ * 대화나 작업 중에 관련된 기억을 자동으로 찾아 컨텍스트에 주입합니다.
+ *
+ * @example
+ * ```typescript
+ * import { ContextInjector } from '@jee1/memento-client';
+ *
+ * const injector = new ContextInjector(client);
+ *
+ * // 컨텍스트 주입
+ * const context = await injector.inject({
+ *   query: 'React Hook에 대해 질문',
+ *   tokenBudget: 1000
+ * });
+ *
+ * console.log(context.content);
+ * ```
+ */
+import { MementoClient } from './memento-client.js';
+import type { ContextInjectionResult } from './types.js';
+export interface ContextInjectionOptions {
+    /** 최대 검색 결과 수 (기본값: 10) */
+    maxResults?: number;
+    /** 토큰 예산 (기본값: 1200) */
+    tokenBudget?: number;
+    /** 컨텍스트 타입 */
+    contextType?: 'conversation' | 'task' | 'general';
+    /** 기억 타입 필터 */
+    memoryTypes?: Array<'working' | 'episodic' | 'semantic' | 'procedural'>;
+    /** 최근 기간 필터 (일 단위) */
+    recentDays?: number;
+    /** 중요도 임계값 (0-1) */
+    importanceThreshold?: number;
+    /** 고정된 기억만 포함할지 여부 */
+    pinnedOnly?: boolean;
+}
+export declare class ContextInjector {
+    private client;
+    constructor(client: MementoClient);
+    /**
+     * 컨텍스트 주입
+     */
+    inject(query: string, options?: ContextInjectionOptions): Promise<ContextInjectionResult>;
+    /**
+     * 관련 기억 검색
+     */
+    private searchRelevantMemories;
+    /**
+     * 기억 압축 (토큰 예산에 맞게)
+     */
+    private compressMemories;
+    /**
+     * 기억 요약
+     */
+    private summarizeMemory;
+    /**
+     * 컨텍스트 생성
+     */
+    private generateContext;
+    /**
+     * 컨텍스트 헤더 생성
+     */
+    private getContextHeader;
+    /**
+     * 기억 포맷팅
+     */
+    private formatMemories;
+    /**
+     * 타입별 이모지
+     */
+    private getTypeEmoji;
+    /**
+     * 중요도 바 생성
+     */
+    private getImportanceBar;
+    /**
+     * 컨텍스트 푸터 생성
+     */
+    private getContextFooter;
+    /**
+     * 빈 컨텍스트 생성
+     */
+    private generateEmptyContext;
+    /**
+     * 토큰 수 추정 (간단한 추정)
+     */
+    private estimateTokenCount;
+    /**
+     * 대화 컨텍스트 주입
+     */
+    injectConversationContext(query: string, tokenBudget?: number): Promise<ContextInjectionResult>;
+    /**
+     * 작업 컨텍스트 주입
+     */
+    injectTaskContext(query: string, projectId?: string, tokenBudget?: number): Promise<ContextInjectionResult>;
+    /**
+     * 학습 컨텍스트 주입
+     */
+    injectLearningContext(topic: string, tokenBudget?: number): Promise<ContextInjectionResult>;
+    /**
+     * 프로젝트 컨텍스트 주입
+     */
+    injectProjectContext(projectId: string, query: string, tokenBudget?: number): Promise<ContextInjectionResult>;
+}
+//# sourceMappingURL=context-injector.d.ts.map

package/dist/context-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-injector.d.ts","sourceRoot":"","sources":["../src/context-injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EACV,sBAAsB,EAIvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,WAAW,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,eAAe;IACf,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC,CAAC;IACxE,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC;IAgDlC;;OAEG;YACW,sBAAsB;IAiDpC;;OAEG;YACW,gBAAgB;IA2C9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACG,yBAAyB,CAC7B,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,MAAa,GACzB,OAAO,CAAC,sBAAsB,CAAC;IAUlC;;OAEG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,GAAE,MAAa,GACzB,OAAO,CAAC,sBAAsB,CAAC;IAelC;;OAEG;IACG,qBAAqB,CACzB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,MAAa,GACzB,OAAO,CAAC,sBAAsB,CAAC;IAUlC;;OAEG;IACG,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,MAAa,GACzB,OAAO,CAAC,sBAAsB,CAAC;CAsBnC"}

package/dist/context-injector.js

@@ -0,0 +1,299 @@
+/**
+ * ContextInjector - AI Agent의 컨텍스트에 관련 기억을 주입하는 클래스
+ * 대화나 작업 중에 관련된 기억을 자동으로 찾아 컨텍스트에 주입합니다.
+ *
+ * @example
+ * ```typescript
+ * import { ContextInjector } from '@jee1/memento-client';
+ *
+ * const injector = new ContextInjector(client);
+ *
+ * // 컨텍스트 주입
+ * const context = await injector.inject({
+ *   query: 'React Hook에 대해 질문',
+ *   tokenBudget: 1000
+ * });
+ *
+ * console.log(context.content);
+ * ```
+ */
+export class ContextInjector {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 컨텍스트 주입
+     */
+    async inject(query, options = {}) {
+        const startTime = Date.now();
+        const { maxResults = 10, tokenBudget = 1200, contextType = 'general', memoryTypes, recentDays, importanceThreshold = 0.3, pinnedOnly = false } = options;
+        // 1. 관련 기억 검색
+        const searchResult = await this.searchRelevantMemories(query, {
+            maxResults,
+            memoryTypes: memoryTypes || undefined,
+            recentDays: recentDays || undefined,
+            importanceThreshold,
+            pinnedOnly
+        });
+        // 2. 토큰 예산에 맞게 기억 압축
+        const compressedMemories = await this.compressMemories(searchResult.items, tokenBudget);
+        // 3. 컨텍스트 생성
+        const context = this.generateContext(query, compressedMemories, contextType);
+        const searchTime = Date.now() - startTime;
+        return {
+            role: 'system',
+            content: context,
+            metadata: {
+                memories_used: compressedMemories.length,
+                token_count: this.estimateTokenCount(context),
+                search_time: searchTime
+            }
+        };
+    }
+    /**
+     * 관련 기억 검색
+     */
+    async searchRelevantMemories(query, options) {
+        const filters = {};
+        // 메모리 타입 필터
+        if (options.memoryTypes && options.memoryTypes.length > 0) {
+            filters.type = options.memoryTypes;
+        }
+        // 최근 기간 필터
+        if (options.recentDays) {
+            const timeFrom = new Date();
+            timeFrom.setDate(timeFrom.getDate() - options.recentDays);
+            filters.time_from = timeFrom.toISOString();
+        }
+        // 고정된 기억만
+        if (options.pinnedOnly) {
+            filters.pinned = true;
+        }
+        // 하이브리드 검색 사용 (의미적 유사도 + 키워드 매칭)
+        const hybridResult = await this.client.hybridSearch({
+            query,
+            filters,
+            limit: options.maxResults,
+            vectorWeight: 0.7, // 의미적 유사도에 더 가중치
+            textWeight: 0.3
+        });
+        // HybridSearchResult를 SearchResult로 변환
+        return {
+            items: hybridResult.items.map(item => ({
+                ...item,
+                score: item.finalScore
+            })),
+            total_count: hybridResult.total_count,
+            query_time: hybridResult.query_time
+        };
+    }
+    /**
+     * 기억 압축 (토큰 예산에 맞게)
+     */
+    async compressMemories(memories, tokenBudget) {
+        if (memories.length === 0)
+            return [];
+        // 중요도와 점수 기준으로 정렬
+        const sortedMemories = memories.sort((a, b) => {
+            // MemoryItem에 score 필드가 없을 수 있으므로 타입 확장 사용
+            const itemA = a;
+            const itemB = b;
+            const scoreA = itemA.score || 0;
+            const scoreB = itemB.score || 0;
+            return (scoreB + a.importance) - (scoreA + b.importance);
+        });
+        const compressed = [];
+        let currentTokens = 0;
+        for (const memory of sortedMemories) {
+            const memoryTokens = this.estimateTokenCount(memory.content);
+            if (currentTokens + memoryTokens <= tokenBudget) {
+                compressed.push(memory);
+                currentTokens += memoryTokens;
+            }
+            else {
+                // 토큰 예산이 부족하면 더 짧은 요약으로 시도
+                const summary = this.summarizeMemory(memory);
+                const summaryTokens = this.estimateTokenCount(summary);
+                if (currentTokens + summaryTokens <= tokenBudget) {
+                    compressed.push({
+                        ...memory,
+                        content: summary
+                    });
+                    currentTokens += summaryTokens;
+                }
+            }
+        }
+        return compressed;
+    }
+    /**
+     * 기억 요약
+     */
+    summarizeMemory(memory) {
+        const content = memory.content;
+        const maxLength = 200; // 최대 200자로 제한
+        if (content.length <= maxLength) {
+            return content;
+        }
+        // 문장 단위로 자르기
+        const sentences = content.split(/[.!?]+/);
+        let summary = '';
+        for (const sentence of sentences) {
+            if (summary.length + sentence.length <= maxLength) {
+                summary += sentence + '.';
+            }
+            else {
+                break;
+            }
+        }
+        return summary || content.substring(0, maxLength) + '...';
+    }
+    /**
+     * 컨텍스트 생성
+     */
+    generateContext(query, memories, contextType) {
+        if (memories.length === 0) {
+            return this.generateEmptyContext(query, contextType);
+        }
+        const contextHeader = this.getContextHeader(contextType);
+        const memorySections = this.formatMemories(memories);
+        const contextFooter = this.getContextFooter(query, memories.length);
+        return `${contextHeader}\n\n${memorySections}\n\n${contextFooter}`;
+    }
+    /**
+     * 컨텍스트 헤더 생성
+     */
+    getContextHeader(contextType) {
+        const headers = {
+            conversation: '💬 관련 대화 기록:',
+            task: '📋 관련 작업 기록:',
+            general: '🧠 관련 기억:'
+        };
+        return headers[contextType] || headers.general;
+    }
+    /**
+     * 기억 포맷팅
+     */
+    formatMemories(memories) {
+        return memories.map((memory, index) => {
+            const typeEmoji = this.getTypeEmoji(memory.type);
+            const importanceBar = this.getImportanceBar(memory.importance);
+            const tags = memory.tags && memory.tags.length > 0
+                ? ` [${memory.tags.join(', ')}]`
+                : '';
+            const memoryWithScore = memory;
+            const score = memoryWithScore.score ? ` (관련도: ${(memoryWithScore.score * 100).toFixed(1)}%)` : '';
+            return `${index + 1}. ${typeEmoji} ${memory.content}${tags}${score}\n   ${importanceBar} ${memory.created_at}`;
+        }).join('\n\n');
+    }
+    /**
+     * 타입별 이모지
+     */
+    getTypeEmoji(type) {
+        const emojis = {
+            working: '⚡',
+            episodic: '📅',
+            semantic: '🧠',
+            procedural: '🔧'
+        };
+        return emojis[type] || '📝';
+    }
+    /**
+     * 중요도 바 생성
+     */
+    getImportanceBar(importance) {
+        const filled = Math.round(importance * 5);
+        const empty = 5 - filled;
+        return '★'.repeat(filled) + '☆'.repeat(empty);
+    }
+    /**
+     * 컨텍스트 푸터 생성
+     */
+    getContextFooter(query, memoryCount) {
+        return `\n💡 위의 ${memoryCount}개 기억을 참고하여 "${query}"에 대해 답변해주세요.`;
+    }
+    /**
+     * 빈 컨텍스트 생성
+     */
+    generateEmptyContext(query, contextType) {
+        const messages = {
+            conversation: '💬 관련 대화 기록이 없습니다.',
+            task: '📋 관련 작업 기록이 없습니다.',
+            general: '🧠 관련 기억이 없습니다.'
+        };
+        return `${messages[contextType] || messages.general}\n\n💡 "${query}"에 대해 새로운 정보로 답변해주세요.`;
+    }
+    /**
+     * 토큰 수 추정 (간단한 추정)
+     */
+    estimateTokenCount(text) {
+        // 대략적인 토큰 수 추정 (한국어: 1글자 = 1토큰, 영어: 1단어 = 1.3토큰)
+        const koreanChars = (text.match(/[가-힣]/g) || []).length;
+        const englishWords = (text.match(/[a-zA-Z]+/g) || []).length;
+        const otherChars = text.length - koreanChars - (text.match(/[a-zA-Z]/g) || []).length;
+        return koreanChars + Math.ceil(englishWords * 1.3) + otherChars;
+    }
+    // ============================================================================
+    // 고급 컨텍스트 주입 기능
+    // ============================================================================
+    /**
+     * 대화 컨텍스트 주입
+     */
+    async injectConversationContext(query, tokenBudget = 1000) {
+        return await this.inject(query, {
+            tokenBudget,
+            contextType: 'conversation',
+            memoryTypes: ['episodic', 'semantic'],
+            recentDays: 30,
+            importanceThreshold: 0.4
+        });
+    }
+    /**
+     * 작업 컨텍스트 주입
+     */
+    async injectTaskContext(query, projectId, tokenBudget = 1200) {
+        const filters = {};
+        if (projectId) {
+            filters.project_id = projectId;
+        }
+        return await this.inject(query, {
+            tokenBudget,
+            contextType: 'task',
+            memoryTypes: ['procedural', 'semantic'],
+            importanceThreshold: 0.5,
+            pinnedOnly: false
+        });
+    }
+    /**
+     * 학습 컨텍스트 주입
+     */
+    async injectLearningContext(topic, tokenBudget = 1500) {
+        return await this.inject(topic, {
+            tokenBudget,
+            contextType: 'general',
+            memoryTypes: ['semantic', 'procedural'],
+            importanceThreshold: 0.6,
+            pinnedOnly: false
+        });
+    }
+    /**
+     * 프로젝트 컨텍스트 주입
+     */
+    async injectProjectContext(projectId, query, tokenBudget = 1000) {
+        const searchResult = await this.client.recall(query, {
+            project_id: projectId
+        }, 10);
+        const compressedMemories = await this.compressMemories(searchResult.items, tokenBudget);
+        const context = this.generateContext(query, compressedMemories, 'task');
+        return {
+            role: 'system',
+            content: context,
+            metadata: {
+                memories_used: compressedMemories.length,
+                token_count: this.estimateTokenCount(context),
+                search_time: searchResult.query_time
+            }
+        };
+    }
+}
+//# sourceMappingURL=context-injector.js.map

package/dist/context-injector.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @jee1/memento-client - Memento MCP Server 클라이언트 라이브러리
+ *
+ * AI Agent의 기억을 관리하고 컨텍스트를 주입하는 TypeScript 라이브러리입니다.
+ *
+ * @example
+ * ```typescript
+ * import { MementoClient, MemoryManager, ContextInjector } from '@jee1/memento-client';
+ *
+ * // 클라이언트 생성 및 연결
+ * const client = new MementoClient({
+ *   serverUrl: 'http://localhost:8080',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * await client.connect();
+ *
+ * // 기억 관리
+ * const manager = new MemoryManager(client);
+ * const memory = await manager.create({
+ *   content: 'React Hook에 대해 학습했다',
+ *   type: 'episodic',
+ *   importance: 0.8
+ * });
+ *
+ * // 컨텍스트 주입
+ * const injector = new ContextInjector(client);
+ * const context = await injector.inject('React Hook 질문', {
+ *   tokenBudget: 1000
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { MementoClient } from './memento-client.js';
+export { MemoryManager } from './memory-manager.js';
+export { ContextInjector } from './context-injector.js';
+export { MementoError, ConnectionError, AuthenticationError, ValidationError, NotFoundError } from './types.js';
+export type { MementoClientOptions, MemoryItem, CreateMemoryParams, UpdateMemoryParams, MemoryType, PrivacyScope, SearchFilters, RecallCallOptions, SearchResult, MemorySearchResult, HybridSearchParams, HybridSearchResult, HybridSearchItem, RememberResult, PinResult, ForgetResult, LinkResult, ExportResult, FeedbackResult, FeedbackCallOptions, RecordRecallFeedbackOptions, ContextInjectionParams, ContextInjectionResult, MementoClientEvents, PaginationParams, PaginatedResult, HealthCheck, AgentEventEnvelopeLike, AgentObservationQuery, AgentOperationsStatusQuery, AgentProvenanceQuery, AgentProvenanceLinkInput } from './types.js';
+export type { ContextInjectionOptions } from './context-injector.js';
+export { createMementoClient } from './utils.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EAEV,oBAAoB,EAGpB,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,YAAY,EAGZ,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAGhB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,2BAA2B,EAG3B,sBAAsB,EACtB,sBAAsB,EAItB,mBAAmB,EAGnB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * @jee1/memento-client - Memento MCP Server 클라이언트 라이브러리
+ *
+ * AI Agent의 기억을 관리하고 컨텍스트를 주입하는 TypeScript 라이브러리입니다.
+ *
+ * @example
+ * ```typescript
+ * import { MementoClient, MemoryManager, ContextInjector } from '@jee1/memento-client';
+ *
+ * // 클라이언트 생성 및 연결
+ * const client = new MementoClient({
+ *   serverUrl: 'http://localhost:8080',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * await client.connect();
+ *
+ * // 기억 관리
+ * const manager = new MemoryManager(client);
+ * const memory = await manager.create({
+ *   content: 'React Hook에 대해 학습했다',
+ *   type: 'episodic',
+ *   importance: 0.8
+ * });
+ *
+ * // 컨텍스트 주입
+ * const injector = new ContextInjector(client);
+ * const context = await injector.inject('React Hook 질문', {
+ *   tokenBudget: 1000
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// 메인 클래스들
+export { MementoClient } from './memento-client.js';
+export { MemoryManager } from './memory-manager.js';
+export { ContextInjector } from './context-injector.js';
+// 에러 클래스들
+export { MementoError, ConnectionError, AuthenticationError, ValidationError, NotFoundError } from './types.js';
+// 편의 함수들
+export { createMementoClient } from './utils.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,UAAU;AACV,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAuDpB,SAAS;AACT,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,cAAc,YAAY,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Minimal logger for @jee1/memento-client (no dependency on repo shared).
+ * Uses console; level can be set via LOG_LEVEL (debug | info | warn | error).
+ */
+export declare const logger: {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,eAAO,MAAM,MAAM;qBACA,OAAO,EAAE;oBACV,OAAO,EAAE;oBACT,OAAO,EAAE;qBACR,OAAO,EAAE;CAC3B,CAAC"}

package/dist/logger.js

@@ -0,0 +1,27 @@
+/**
+ * Minimal logger for @jee1/memento-client (no dependency on repo shared).
+ * Uses console; level can be set via LOG_LEVEL (debug | info | warn | error).
+ */
+const levelOrder = ['debug', 'info', 'warn', 'error'];
+const currentLevel = (() => {
+    const env = typeof process !== 'undefined' && process.env?.LOG_LEVEL?.toLowerCase();
+    if (env && levelOrder.includes(env))
+        return env;
+    return 'info';
+})();
+function shouldLog(level) {
+    return levelOrder.indexOf(level) >= levelOrder.indexOf(currentLevel);
+}
+function log(level, ...args) {
+    if (!shouldLog(level))
+        return;
+    const fn = level === 'error' ? console.error : level === 'warn' ? console.warn : console.log;
+    fn(`[MementoClient][${level}]`, ...args);
+}
+export const logger = {
+    debug: (...args) => log('debug', ...args),
+    info: (...args) => log('info', ...args),
+    warn: (...args) => log('warn', ...args),
+    error: (...args) => log('error', ...args),
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAG/D,MAAM,YAAY,GAAU,CAAC,GAAG,EAAE;IAChC,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IACpF,IAAI,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAY,CAAC;QAAE,OAAO,GAAY,CAAC;IAClE,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,EAAE,CAAC;AAEL,SAAS,SAAS,CAAC,KAAY;IAC7B,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,GAAG,CAAC,KAAY,EAAE,GAAG,IAAe;IAC3C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO;IAC9B,MAAM,EAAE,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAC7F,EAAE,CAAC,mBAAmB,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;CACrD,CAAC"}

package/dist/memento-client.d.ts

@@ -0,0 +1,64 @@
+/**
+ * MementoClient - Memento MCP Server와 통신하는 메인 클라이언트
+ *
+ * @example
+ * ```typescript
+ * import { MementoClient } from '@jee1/memento-client';
+ *
+ * const client = new MementoClient({
+ *   serverUrl: 'http://localhost:8080',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * await client.connect();
+ *
+ * const memory = await client.remember({
+ *   content: 'React Hook에 대해 학습했다',
+ *   type: 'episodic',
+ *   importance: 0.8
+ * });
+ * ```
+ */
+import { EventEmitter } from 'events';
+import type { AxiosInstance } from 'axios';
+import type { MementoClientOptions, MemoryItem, CreateMemoryParams, UpdateMemoryParams, SearchFilters, RecallCallOptions, SearchResult, HybridSearchParams, HybridSearchResult, RememberResult, PinResult, ForgetResult, LinkResult, ExportResult, FeedbackResult, FeedbackCallOptions, RecordRecallFeedbackOptions, ContextInjectionParams, ContextInjectionResult, HealthCheck, AgentEventEnvelopeLike, AgentObservationQuery, AgentOperationsStatusQuery, AgentProvenanceQuery, AgentProvenanceLinkInput } from './types.js';
+import type { MementoClientCore } from './client/client-context.js';
+export declare class MementoClient extends EventEmitter implements MementoClientCore {
+    httpClient: AxiosInstance;
+    isConnected: boolean;
+    options: Required<MementoClientOptions>;
+    constructor(options?: MementoClientOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    get connected(): boolean;
+    healthCheck(): Promise<HealthCheck>;
+    remember(params: CreateMemoryParams): Promise<RememberResult>;
+    recall(query: string, filters?: SearchFilters, limit?: number, recallOptions?: RecallCallOptions): Promise<SearchResult>;
+    hybridSearch(params: HybridSearchParams): Promise<HybridSearchResult>;
+    getMemory(id: string): Promise<MemoryItem>;
+    updateMemory(id: string, params: UpdateMemoryParams): Promise<MemoryItem>;
+    forget(memoryId: string, hard?: boolean): Promise<ForgetResult>;
+    pin(memoryId: string): Promise<PinResult>;
+    unpin(memoryId: string): Promise<PinResult>;
+    link(sourceId: string, targetId: string, relationType: 'cause_of' | 'derived_from' | 'duplicates' | 'contradicts'): Promise<LinkResult>;
+    export(format: 'json' | 'csv' | 'markdown', filters?: SearchFilters): Promise<ExportResult>;
+    feedback(memoryId: string, helpful: boolean, comment?: string, score?: number, score_breakdown?: unknown, options?: FeedbackCallOptions): Promise<FeedbackResult>;
+    recordRecallFeedback(recallResult: SearchResult, memoryId: string, helpful: boolean, options?: RecordRecallFeedbackOptions): Promise<FeedbackResult>;
+    injectContext(params: ContextInjectionParams): Promise<ContextInjectionResult>;
+    getAgentCapabilities<T = Record<string, unknown>>(): Promise<T>;
+    getAgentOperationsStatus<T = Record<string, unknown>>(query?: AgentOperationsStatusQuery): Promise<T>;
+    startAgentSession<T = Record<string, unknown>>(event: AgentEventEnvelopeLike): Promise<T>;
+    ingestAgentObservations<T = Record<string, unknown>>(events: AgentEventEnvelopeLike[]): Promise<T>;
+    preCompactAgentSession<T = Record<string, unknown>>(sessionId: string, event: AgentEventEnvelopeLike): Promise<T>;
+    stopAgentSession<T = Record<string, unknown>>(sessionId: string, event: AgentEventEnvelopeLike): Promise<T>;
+    getAgentSession<T = Record<string, unknown>>(sessionId: string): Promise<T>;
+    listAgentObservations<T = Record<string, unknown>>(sessionId: string, query?: AgentObservationQuery): Promise<T>;
+    getAgentProvenance<T = Record<string, unknown>>(query: AgentProvenanceQuery): Promise<T>;
+    linkAgentProvenance<T = Record<string, unknown>>(input: AgentProvenanceLinkInput): Promise<T>;
+    exportAgentSession<T = Record<string, unknown>>(sessionId: string): Promise<T>;
+    deleteAgentSession(sessionId: string): Promise<void>;
+    ensureConnected(): void;
+    updateOptions(newOptions: Partial<MementoClientOptions>): void;
+    getOptions(): Readonly<MementoClientOptions>;
+}
+//# sourceMappingURL=memento-client.d.ts.map

package/dist/memento-client.d.ts.map

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