a2a-memory 0.1.2 → 0.6.0

package/dist/lifecycle/tiering.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Memory Tiering Engine
+ *
+ * 메모리 접근 패턴 기반 티어링 시스템:
+ * - hot: 최근 hotThresholdDays 이내 접근 OR tier='core'
+ * - warm: 최근 warmThresholdDays 이내 접근 OR tier='active'
+ * - cold: 나머지 (오래된 메모리)
+ *
+ * Cold 메모리는 zlib 압축으로 저장 공간 절약.
+ */
+import type { Memory, TieringConfig, TieringResult, StorageTier } from '../types/index.js';
+import type { MemoryDatabase } from '../db/database.js';
+/**
+ * 메모리 접근 패턴 기반 티어 결정
+ *
+ * 규칙:
+ * - tier='working' (core) → 항상 hot (강등 불가)
+ * - tier='episodic' (active) → 접근 시간과 관계없이 warm 이상
+ * - 나머지: lastAccessedAt 기준 hot/warm/cold 분류
+ *
+ * @param memory - 메모리 객체
+ * @param config - 티어링 설정
+ * @returns 결정된 storage tier
+ */
+export declare function determineTier(memory: Memory, config: TieringConfig): StorageTier;
+/**
+ * 전체 메모리 티어 재계산 및 재배치
+ *
+ * 1. 모든 메모리의 적절한 티어 결정
+ * 2. 현재 티어와 비교하여 승격/강등 카운트
+ * 3. cold 티어 메모리 압축 (설정 활성화 시)
+ * 4. DB 업데이트
+ *
+ * @param db - 메모리 데이터베이스
+ * @param config - 티어링 설정
+ * @returns 티어링 결과 (승격/강등/압축 수)
+ */
+export declare function rebalanceTiers(db: MemoryDatabase, config: TieringConfig): TieringResult;
+/**
+ * 메모리 접근 시 자동 승격
+ *
+ * autoPromote 설정이 활성화되어 있고,
+ * 현재 cold/warm 티어인 메모리를 hot으로 승격합니다.
+ *
+ * @param db - 메모리 데이터베이스
+ * @param memoryId - 메모리 ID
+ * @param config - 티어링 설정
+ */
+export declare function promoteOnAccess(db: MemoryDatabase, memoryId: string, config: TieringConfig): void;
+//# sourceMappingURL=tiering.d.ts.map

package/dist/lifecycle/tiering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiering.d.ts","sourceRoot":"","sources":["../../src/lifecycle/tiering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,CAwChF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,aAAa,CAgEvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,GACpB,IAAI,CAuBN"}

package/dist/lifecycle/tiering.js

@@ -0,0 +1,235 @@
+/**
+ * Memory Tiering Engine
+ *
+ * 메모리 접근 패턴 기반 티어링 시스템:
+ * - hot: 최근 hotThresholdDays 이내 접근 OR tier='core'
+ * - warm: 최근 warmThresholdDays 이내 접근 OR tier='active'
+ * - cold: 나머지 (오래된 메모리)
+ *
+ * Cold 메모리는 zlib 압축으로 저장 공간 절약.
+ */
+import { gzipSync, gunzipSync } from 'node:zlib';
+const COMPRESSED_PREFIX = 'COMPRESSED:';
+/**
+ * 메모리 접근 패턴 기반 티어 결정
+ *
+ * 규칙:
+ * - tier='working' (core) → 항상 hot (강등 불가)
+ * - tier='episodic' (active) → 접근 시간과 관계없이 warm 이상
+ * - 나머지: lastAccessedAt 기준 hot/warm/cold 분류
+ *
+ * @param memory - 메모리 객체
+ * @param config - 티어링 설정
+ * @returns 결정된 storage tier
+ */
+export function determineTier(memory, config) {
+    // core 티어는 항상 hot
+    if (memory.tier === 'working') {
+        return 'hot';
+    }
+    // episodic 티어는 최소 warm 보장 (접근 시간 무관)
+    if (memory.tier === 'episodic') {
+        // 단, 접근 기록이 있으면 hot 승격 가능
+        if (memory.lastAccessedAt) {
+            const daysSinceAccess = getDaysSince(memory.lastAccessedAt);
+            if (daysSinceAccess <= config.hotThresholdDays) {
+                return 'hot';
+            }
+        }
+        return 'warm';
+    }
+    // semantic 티어: 접근 패턴 기반
+    if (!memory.lastAccessedAt) {
+        // 접근 기록 없음 → createdAt 기준
+        const daysSinceCreation = getDaysSince(memory.createdAt);
+        if (daysSinceCreation <= config.hotThresholdDays) {
+            return 'hot';
+        }
+        if (daysSinceCreation <= config.warmThresholdDays) {
+            return 'warm';
+        }
+        return 'cold';
+    }
+    const daysSinceAccess = getDaysSince(memory.lastAccessedAt);
+    if (daysSinceAccess <= config.hotThresholdDays) {
+        return 'hot';
+    }
+    if (daysSinceAccess <= config.warmThresholdDays) {
+        return 'warm';
+    }
+    return 'cold';
+}
+/**
+ * 전체 메모리 티어 재계산 및 재배치
+ *
+ * 1. 모든 메모리의 적절한 티어 결정
+ * 2. 현재 티어와 비교하여 승격/강등 카운트
+ * 3. cold 티어 메모리 압축 (설정 활성화 시)
+ * 4. DB 업데이트
+ *
+ * @param db - 메모리 데이터베이스
+ * @param config - 티어링 설정
+ * @returns 티어링 결과 (승격/강등/압축 수)
+ */
+export function rebalanceTiers(db, config) {
+    if (!config.enabled) {
+        return { promoted: 0, demoted: 0, compressed: 0, totalProcessed: 0 };
+    }
+    const allMemories = db.listMemories({ limit: 999999 });
+    let promoted = 0;
+    let demoted = 0;
+    let compressed = 0;
+    for (const memory of allMemories) {
+        const currentTier = getStorageTier(memory);
+        const targetTier = determineTier(memory, config);
+        // 티어 변경 필요 여부 확인
+        if (currentTier === targetTier) {
+            // 티어 변경 없음, 압축 상태만 확인
+            if (targetTier === 'cold' && config.coldCompressionEnabled) {
+                if (!isCompressed(memory.content)) {
+                    const compressedContent = compressContent(memory.content);
+                    db.updateMemory(memory.id, { content: compressedContent });
+                    compressed++;
+                }
+            }
+            continue;
+        }
+        // 티어 변경 필요
+        const tierRank = { hot: 2, warm: 1, cold: 0 };
+        if (tierRank[targetTier] > tierRank[currentTier]) {
+            promoted++;
+        }
+        else {
+            demoted++;
+        }
+        // content 압축/해제 처리
+        let newContent = memory.content;
+        if (targetTier === 'cold' && config.coldCompressionEnabled) {
+            // cold로 강등 → 압축
+            if (!isCompressed(memory.content)) {
+                newContent = compressContent(memory.content);
+                compressed++;
+            }
+        }
+        else if (currentTier === 'cold' && isCompressed(memory.content)) {
+            // cold에서 승격 → 압축 해제
+            newContent = decompressContent(memory.content);
+        }
+        // 메타데이터 업데이트 (storage tier는 메타데이터로 추적)
+        // Memory.tier는 semantic tier이므로 변경하지 않음
+        // storage tier는 별도 필드나 tags로 관리 필요
+        // 현재 구현에서는 content만 압축/해제 처리
+        if (newContent !== memory.content) {
+            db.updateMemory(memory.id, { content: newContent });
+        }
+    }
+    return {
+        promoted,
+        demoted,
+        compressed,
+        totalProcessed: allMemories.length,
+    };
+}
+/**
+ * 메모리 접근 시 자동 승격
+ *
+ * autoPromote 설정이 활성화되어 있고,
+ * 현재 cold/warm 티어인 메모리를 hot으로 승격합니다.
+ *
+ * @param db - 메모리 데이터베이스
+ * @param memoryId - 메모리 ID
+ * @param config - 티어링 설정
+ */
+export function promoteOnAccess(db, memoryId, config) {
+    if (!config.enabled || !config.autoPromote) {
+        return;
+    }
+    // DB에서 조회하지 않고, 이미 조회된 메모리를 받아 처리하는 것이 효율적이지만
+    // 현재 API 구조상 id만 받으므로 재조회 필요
+    const memory = db.getMemory(memoryId);
+    if (!memory) {
+        return;
+    }
+    const currentTier = getStorageTier(memory);
+    const targetTier = determineTier(memory, config);
+    // hot으로 승격 필요한 경우
+    if (targetTier === 'hot' && currentTier !== 'hot') {
+        // 압축 해제
+        if (isCompressed(memory.content)) {
+            const decompressedContent = decompressContent(memory.content);
+            db.updateMemory(memoryId, { content: decompressedContent });
+        }
+    }
+}
+// ============================
+// Helper Functions
+// ============================
+/**
+ * 메모리의 현재 storage tier 추정
+ * (실제로는 별도 필드가 필요하지만, 현재는 압축 여부로 판단)
+ */
+function getStorageTier(memory) {
+    // core는 항상 hot
+    if (memory.tier === 'working') {
+        return 'hot';
+    }
+    // 압축되어 있으면 cold
+    if (isCompressed(memory.content)) {
+        return 'cold';
+    }
+    // episodic은 기본 warm
+    if (memory.tier === 'episodic') {
+        return 'warm';
+    }
+    // semantic은 접근 패턴 기반 추정
+    if (!memory.lastAccessedAt) {
+        const daysSinceCreation = getDaysSince(memory.createdAt);
+        if (daysSinceCreation <= 7)
+            return 'hot';
+        if (daysSinceCreation <= 30)
+            return 'warm';
+        return 'cold';
+    }
+    const daysSinceAccess = getDaysSince(memory.lastAccessedAt);
+    if (daysSinceAccess <= 7)
+        return 'hot';
+    if (daysSinceAccess <= 30)
+        return 'warm';
+    return 'cold';
+}
+/**
+ * ISO 8601 문자열에서 현재까지의 일수 계산
+ */
+function getDaysSince(isoDate) {
+    const date = new Date(isoDate);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+}
+/**
+ * content가 압축되어 있는지 확인
+ */
+function isCompressed(content) {
+    return content.startsWith(COMPRESSED_PREFIX);
+}
+/**
+ * content 압축 (zlib gzip)
+ */
+function compressContent(content) {
+    const buffer = Buffer.from(content, 'utf-8');
+    const compressed = gzipSync(buffer);
+    return COMPRESSED_PREFIX + compressed.toString('base64');
+}
+/**
+ * content 압축 해제
+ */
+function decompressContent(content) {
+    if (!isCompressed(content)) {
+        return content;
+    }
+    const base64Data = content.slice(COMPRESSED_PREFIX.length);
+    const compressed = Buffer.from(base64Data, 'base64');
+    const decompressed = gunzipSync(compressed);
+    return decompressed.toString('utf-8');
+}
+//# sourceMappingURL=tiering.js.map

package/dist/lifecycle/tiering.js.map

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

package/dist/llm/client.d.ts

@@ -0,0 +1,37 @@
+/**
+ * LLM Client — AI 기반 분류/요약
+ * npm 의존성 없음, native fetch 사용
+ */
+import type { LLMConfig } from '../types/index.js';
+export interface LLMClient {
+    complete(prompt: string, systemPrompt?: string): Promise<string>;
+    summarize(contents: string[]): Promise<string>;
+    classify(content: string, categories: string[]): Promise<string>;
+}
+export declare class OpenAILLMClient implements LLMClient {
+    private apiKey;
+    private model;
+    private maxTokens;
+    private timeout;
+    constructor(config: LLMConfig);
+    complete(prompt: string, systemPrompt?: string): Promise<string>;
+    summarize(contents: string[]): Promise<string>;
+    classify(content: string, categories: string[]): Promise<string>;
+}
+export declare class AnthropicLLMClient implements LLMClient {
+    private apiKey;
+    private model;
+    private maxTokens;
+    private timeout;
+    constructor(config: LLMConfig);
+    complete(prompt: string, systemPrompt?: string): Promise<string>;
+    summarize(contents: string[]): Promise<string>;
+    classify(content: string, categories: string[]): Promise<string>;
+}
+export declare class NoOpLLMClient implements LLMClient {
+    complete(): Promise<string>;
+    summarize(): Promise<string>;
+    classify(_content: string, categories: string[]): Promise<string>;
+}
+export declare function createLLMClient(config?: LLMConfig): LLMClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/llm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/llm/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClE;AAED,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,SAAS;IAQvB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6ChE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAUvE;AAED,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,SAAS;IAQvB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA4ChE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAUvE;AAED,qBAAa,aAAc,YAAW,SAAS;IACvC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAG3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAG5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAGxE;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAa7D"}

package/dist/llm/client.js

@@ -0,0 +1,154 @@
+/**
+ * LLM Client — AI 기반 분류/요약
+ * npm 의존성 없음, native fetch 사용
+ */
+export class OpenAILLMClient {
+    apiKey;
+    model;
+    maxTokens;
+    timeout;
+    constructor(config) {
+        if (!config.apiKey)
+            throw new Error('OpenAI API key is required');
+        this.apiKey = config.apiKey;
+        this.model = config.model ?? 'gpt-4o-mini';
+        this.maxTokens = config.maxTokens ?? 500;
+        this.timeout = 10000;
+    }
+    async complete(prompt, systemPrompt) {
+        const messages = [];
+        if (systemPrompt) {
+            messages.push({ role: 'system', content: systemPrompt });
+        }
+        messages.push({ role: 'user', content: prompt });
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch('https://api.openai.com/v1/chat/completions', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.model,
+                    messages,
+                    max_tokens: this.maxTokens,
+                    temperature: 0.3,
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`OpenAI API error: ${response.status}`);
+            }
+            const data = await response.json();
+            return data.choices[0]?.message?.content?.trim() ?? '';
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error('LLM request timeout (10s)');
+            }
+            throw error;
+        }
+    }
+    async summarize(contents) {
+        const joined = contents.join('\n---\n').slice(0, 4000);
+        return this.complete(`Summarize the following development session contents in 2-3 concise sentences:\n\n${joined}`, 'You are a technical summarizer. Be concise and focus on key decisions, errors solved, and patterns used.');
+    }
+    async classify(content, categories) {
+        const categoryList = categories.join(', ');
+        const result = await this.complete(`Classify the following content into exactly one of these categories: ${categoryList}\n\nContent:\n${content.slice(0, 2000)}\n\nRespond with ONLY the category name, nothing else.`, 'You are a content classifier. Respond with only the category name.');
+        const cleaned = result.toLowerCase().trim();
+        const match = categories.find((c) => c.toLowerCase() === cleaned);
+        return match ?? categories[categories.length - 1];
+    }
+}
+export class AnthropicLLMClient {
+    apiKey;
+    model;
+    maxTokens;
+    timeout;
+    constructor(config) {
+        if (!config.apiKey)
+            throw new Error('Anthropic API key is required');
+        this.apiKey = config.apiKey;
+        this.model = config.model ?? 'claude-sonnet-4-5-20250929';
+        this.maxTokens = config.maxTokens ?? 500;
+        this.timeout = 10000;
+    }
+    async complete(prompt, systemPrompt) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const body = {
+                model: this.model,
+                max_tokens: this.maxTokens,
+                messages: [{ role: 'user', content: prompt }],
+            };
+            if (systemPrompt) {
+                body.system = systemPrompt;
+            }
+            const response = await fetch('https://api.anthropic.com/v1/messages', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'x-api-key': this.apiKey,
+                    'anthropic-version': '2023-06-01',
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`Anthropic API error: ${response.status}`);
+            }
+            const data = await response.json();
+            return data.content[0]?.text?.trim() ?? '';
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error('LLM request timeout (10s)');
+            }
+            throw error;
+        }
+    }
+    async summarize(contents) {
+        const joined = contents.join('\n---\n').slice(0, 4000);
+        return this.complete(`Summarize the following development session contents in 2-3 concise sentences:\n\n${joined}`, 'You are a technical summarizer. Be concise and focus on key decisions, errors solved, and patterns used.');
+    }
+    async classify(content, categories) {
+        const categoryList = categories.join(', ');
+        const result = await this.complete(`Classify the following content into exactly one of these categories: ${categoryList}\n\nContent:\n${content.slice(0, 2000)}\n\nRespond with ONLY the category name, nothing else.`, 'You are a content classifier. Respond with only the category name.');
+        const cleaned = result.toLowerCase().trim();
+        const match = categories.find((c) => c.toLowerCase() === cleaned);
+        return match ?? categories[categories.length - 1];
+    }
+}
+export class NoOpLLMClient {
+    async complete() {
+        return '';
+    }
+    async summarize() {
+        return '';
+    }
+    async classify(_content, categories) {
+        return categories[categories.length - 1];
+    }
+}
+export function createLLMClient(config) {
+    if (!config || !config.enabled || config.provider === 'none') {
+        return new NoOpLLMClient();
+    }
+    switch (config.provider) {
+        case 'openai':
+            return new OpenAILLMClient(config);
+        case 'anthropic':
+            return new AnthropicLLMClient(config);
+        default:
+            return new NoOpLLMClient();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/llm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/llm/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,OAAO,eAAe;IAClB,MAAM,CAAS;IACf,KAAK,CAAS;IACd,SAAS,CAAS;IAClB,OAAO,CAAS;IAExB,YAAY,MAAiB;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,YAAqB;QAClD,MAAM,QAAQ,GAA6C,EAAE,CAAC;QAC9D,IAAI,YAAY,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEjD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,4CAA4C,EAAE;gBACzE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;iBACzC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,QAAQ;oBACR,UAAU,EAAE,IAAI,CAAC,SAAS;oBAC1B,WAAW,EAAE,GAAG;iBACjB,CAAC;gBACF,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1D,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAE/B,CAAC;YACF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAkB;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,QAAQ,CAClB,qFAAqF,MAAM,EAAE,EAC7F,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,UAAoB;QAClD,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAChC,wEAAwE,YAAY,iBAAiB,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,wDAAwD,EACnL,oEAAoE,CACrE,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC;QAClE,OAAO,KAAK,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAS;IACf,KAAK,CAAS;IACd,SAAS,CAAS;IAClB,OAAO,CAAS;IAExB,YAAY,MAAiB;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,4BAA4B,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,YAAqB;QAClD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,IAAI,GAA4B;gBACpC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,UAAU,EAAE,IAAI,CAAC,SAAS;gBAC1B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;aAC9C,CAAC;YACF,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;YAC7B,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,uCAAuC,EAAE;gBACpE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,mBAAmB,EAAE,YAAY;iBAClC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAE/B,CAAC;YACF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAkB;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,QAAQ,CAClB,qFAAqF,MAAM,EAAE,EAC7F,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,UAAoB;QAClD,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAChC,wEAAwE,YAAY,iBAAiB,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,wDAAwD,EACnL,oEAAoE,CACrE,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC;QAClE,OAAO,KAAK,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,KAAK,CAAC,SAAS;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,UAAoB;QACnD,OAAO,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC7D,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,WAAW;YACd,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACxC;YACE,OAAO,IAAI,aAAa,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/llm/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * LLM Module - AI Classification & Summarization
+ */
+export { createLLMClient, OpenAILLMClient, AnthropicLLMClient, NoOpLLMClient, } from './client.js';
+export type { LLMClient } from './client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,5 @@
+/**
+ * LLM Module - AI Classification & Summarization
+ */
+export { createLLMClient, OpenAILLMClient, AnthropicLLMClient, NoOpLLMClient, } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/search/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Search Module
+ *
+ * 하이브리드 검색 (FTS + Vector + Recency) 통합 모듈.
+ */
+export { HybridRanker } from './ranker.js';
+export type { RankedResult } from './ranker.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/search/index.js

@@ -0,0 +1,7 @@
+/**
+ * Search Module
+ *
+ * 하이브리드 검색 (FTS + Vector + Recency) 통합 모듈.
+ */
+export { HybridRanker } from './ranker.js';
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/search/ranker.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Reciprocal Rank Fusion (RRF) 기반 하이브리드 검색
+ *
+ * FTS, Vector, Recency 결과를 통합하여 최적의 검색 결과 제공.
+ */
+import type { Memory, MemorySearchResult } from '../types/index.js';
+export interface RankedResult {
+    memory: Memory;
+    score: number;
+    sources: Array<{
+        type: 'fts' | 'vector' | 'recency';
+        rank: number;
+    }>;
+}
+/**
+ * RRF (Reciprocal Rank Fusion) 기반 하이브리드 랭커
+ *
+ * RRF 공식: score = sum(1 / (k + rank_i)) for each source
+ * - k: RRF 파라미터 (기본: 60) - 낮을수록 상위 순위에 더 높은 가중치
+ * - rank: 각 소스에서의 순위 (1부터 시작)
+ */
+export declare class HybridRanker {
+    private k;
+    constructor(k?: number);
+    /**
+     * FTS + Vector + Recency 결과를 RRF로 통합
+     */
+    rank(ftsResults: MemorySearchResult[], vectorResults: MemorySearchResult[], recencyResults?: Memory[]): RankedResult[];
+}
+//# sourceMappingURL=ranker.d.ts.map

package/dist/search/ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranker.d.ts","sourceRoot":"","sources":["../../src/search/ranker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,CAAC,CAAS;gBAEN,CAAC,GAAE,MAAW;IAI1B;;OAEG;IACH,IAAI,CACF,UAAU,EAAE,kBAAkB,EAAE,EAChC,aAAa,EAAE,kBAAkB,EAAE,EACnC,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,YAAY,EAAE;CA0ElB"}