@redigg/redigg 0.1.0

package/dist/llm/LLMClient.js

@@ -0,0 +1,21 @@
+export class MockLLMClient {
+    async complete(prompt) {
+        return { content: 'Mock response' };
+    }
+    async chat(messages) {
+        // Simple mock logic for testing memory extraction
+        const lastMsg = messages[messages.length - 1].content.toLowerCase();
+        if (lastMsg.includes('extract memory')) {
+            return {
+                content: JSON.stringify({
+                    memories: [
+                        { type: 'preference', content: 'User is interested in oncology' },
+                        { type: 'fact', content: 'User is asking about THBS2' }
+                    ]
+                })
+            };
+        }
+        return { content: 'I am a mock LLM.' };
+    }
+}
+//# sourceMappingURL=LLMClient.js.map

package/dist/llm/LLMClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMClient.js","sourceRoot":"","sources":["../../src/llm/LLMClient.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAA6C;QACtD,kDAAkD;QAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAEpE,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;oBACtB,QAAQ,EAAE;wBACR,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,gCAAgC,EAAE;wBACjE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,EAAE;qBACxD;iBACF,CAAC;aACH,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/llm/OpenAIClient.d.ts

@@ -0,0 +1,16 @@
+import { LLMClient, LLMResponse, LLMStreamHandler } from './LLMClient.js';
+export declare class OpenAIClient implements LLMClient {
+    private openai;
+    private model;
+    constructor(apiKey: string, baseURL?: string, model?: string);
+    complete(prompt: string): Promise<LLMResponse>;
+    chat(messages: {
+        role: string;
+        content: string;
+    }[]): Promise<LLMResponse>;
+    chatStream(messages: {
+        role: string;
+        content: string;
+    }[], handler: LLMStreamHandler): Promise<void>;
+    embed(text: string): Promise<number[]>;
+}

package/dist/llm/OpenAIClient.js

@@ -0,0 +1,58 @@
+import OpenAI from 'openai';
+export class OpenAIClient {
+    openai;
+    model;
+    constructor(apiKey, baseURL, model) {
+        this.openai = new OpenAI({
+            apiKey,
+            baseURL: baseURL || 'https://api.openai.com/v1'
+        });
+        this.model = model || 'gpt-3.5-turbo';
+    }
+    async complete(prompt) {
+        const response = await this.openai.chat.completions.create({
+            model: this.model,
+            messages: [{ role: 'user', content: prompt }],
+        });
+        return { content: response.choices[0].message.content || '' };
+    }
+    async chat(messages) {
+        const response = await this.openai.chat.completions.create({
+            model: this.model,
+            messages: messages,
+            stream: false,
+        });
+        return { content: response.choices[0].message.content || '' };
+    }
+    async chatStream(messages, handler) {
+        try {
+            const stream = await this.openai.chat.completions.create({
+                model: this.model,
+                messages: messages,
+                stream: true,
+            });
+            let fullText = '';
+            for await (const chunk of stream) {
+                const content = chunk.choices[0]?.delta?.content || '';
+                if (content) {
+                    fullText += content;
+                    handler.onToken?.(content);
+                }
+            }
+            handler.onComplete?.(fullText);
+        }
+        catch (error) {
+            handler.onError?.(error);
+            throw error;
+        }
+    }
+    async embed(text) {
+        const response = await this.openai.embeddings.create({
+            model: 'text-embedding-3-small',
+            input: text,
+            encoding_format: 'float',
+        });
+        return response.data[0].embedding;
+    }
+}
+//# sourceMappingURL=OpenAIClient.js.map

package/dist/llm/OpenAIClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIClient.js","sourceRoot":"","sources":["../../src/llm/OpenAIClient.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,OAAO,YAAY;IACf,MAAM,CAAS;IACf,KAAK,CAAS;IAEtB,YAAY,MAAc,EAAE,OAAgB,EAAE,KAAc;QAC1D,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,MAAM;YACN,OAAO,EAAE,OAAO,IAAI,2BAA2B;SAChD,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,eAAe,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACzD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC9C,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAA6C;QACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACzD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,QAAe;YACzB,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAA6C,EAAE,OAAyB;QACvF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;gBACvD,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,QAAe;gBACzB,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;YAEH,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;gBACvD,IAAI,OAAO,EAAE,CAAC;oBACZ,QAAQ,IAAI,OAAO,CAAC;oBACpB,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;YACD,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACzB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;YACnD,KAAK,EAAE,wBAAwB;YAC/B,KAAK,EAAE,IAAI;YACX,eAAe,EAAE,OAAO;SACzB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpC,CAAC;CACF"}

package/dist/memory/MemoryManager.d.ts

@@ -0,0 +1,41 @@
+import { SQLiteStorage } from '../storage/sqlite.js';
+export interface Memory {
+    id: string;
+    user_id: string;
+    type: 'preference' | 'fact' | 'context' | 'paper' | 'experiment' | 'page_index' | 'page_index_node';
+    tier: 'working' | 'short_term' | 'long_term';
+    content: string;
+    metadata?: any;
+    weight: number;
+    last_accessed_at: string;
+    created_at: string;
+    updated_at: string;
+    parent_id?: string;
+    index_path?: string;
+}
+export declare class MemoryManager {
+    storage: SQLiteStorage;
+    constructor(storage: SQLiteStorage);
+    private initializeSchema;
+    addMemory(userId: string, type: Memory['type'], content: string, metadata?: any, weight?: number, tier?: Memory['tier'], parentId?: string): Promise<Memory>;
+    addPaper(userId: string, title: string, authors: string[], url?: string, summary?: string): Promise<Memory>;
+    private parseRow;
+    getMemory(id: string): Promise<Memory>;
+    getUserMemories(userId: string, type?: string): Promise<Memory[]>;
+    updateMemoryWeight(id: string, delta: number): Promise<void>;
+    searchMemories(userId: string, query: string, options?: {
+        limit?: number;
+        type?: Memory['type'];
+        tier?: Memory['tier'];
+    }): Promise<Memory[]>;
+    getFormattedMemories(userId: string, query?: string): Promise<string>;
+    updateMemoryTier(id: string, tier: Memory['tier']): Promise<void>;
+    deleteMemory(id: string): Promise<void>;
+    getMemoriesByTier(userId: string, tier: Memory['tier']): Promise<Memory[]>;
+    consolidateMemories(userId: string): Promise<{
+        moved: number;
+        promoted: number;
+        pruned: number;
+    }>;
+    consolidatePreferences(userId: string): Promise<void>;
+}

package/dist/memory/MemoryManager.js

@@ -0,0 +1,221 @@
+import { v4 as uuidv4 } from 'uuid';
+export class MemoryManager {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+        try {
+            if (this.storage && typeof this.storage.getDb === 'function') {
+                this.initializeSchema();
+            }
+        }
+        catch (e) {
+            // Ignore initialization errors in test/mock envs
+        }
+    }
+    initializeSchema() {
+        if (!this.storage || typeof this.storage.getDb !== 'function')
+            return;
+        try {
+            const db = this.storage.getDb();
+            // Add new columns if not exist (simple migration)
+            try {
+                db.prepare('ALTER TABLE memories ADD COLUMN tier TEXT DEFAULT "working"').run();
+            }
+            catch (e) { }
+            try {
+                db.prepare('ALTER TABLE memories ADD COLUMN last_accessed_at TEXT').run();
+            }
+            catch (e) { }
+            try {
+                db.prepare('ALTER TABLE memories ADD COLUMN parent_id TEXT').run();
+            }
+            catch (e) { }
+            try {
+                db.prepare('ALTER TABLE memories ADD COLUMN index_path TEXT').run();
+            }
+            catch (e) { }
+        }
+        catch (e) {
+            // Ignore DB connection errors
+        }
+    }
+    async addMemory(userId, type, content, metadata, weight = 1.0, tier = 'working', parentId) {
+        const db = this.storage.getDb();
+        const id = uuidv4();
+        const metadataStr = metadata ? JSON.stringify(metadata) : null;
+        const now = new Date().toISOString();
+        // Calculate index_path
+        let indexPath = id;
+        if (parentId) {
+            try {
+                const parent = await this.getMemory(parentId);
+                if (parent && parent.index_path) {
+                    indexPath = `${parent.index_path}/${id}`;
+                }
+                else {
+                    // Fallback if parent has no path or not found (though should be found)
+                    indexPath = `${parentId}/${id}`;
+                }
+            }
+            catch (e) {
+                // Parent might not exist or error
+            }
+        }
+        const stmt = db.prepare(`
+      INSERT INTO memories (id, user_id, type, tier, content, metadata, weight, last_accessed_at, created_at, updated_at, parent_id, index_path)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(id, userId, type, tier, content, metadataStr, weight, now, now, now, parentId || null, indexPath);
+        return this.getMemory(id);
+    }
+    async addPaper(userId, title, authors, url, summary) {
+        const content = `Paper: ${title} by ${authors.join(', ')}`;
+        const metadata = {
+            subtype: 'paper',
+            title,
+            authors,
+            url,
+            summary
+        };
+        return this.addMemory(userId, 'paper', content, metadata, 1.0, 'long_term');
+    }
+    parseRow(row) {
+        if (!row)
+            return row;
+        return {
+            ...row,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined
+        };
+    }
+    async getMemory(id) {
+        const db = this.storage.getDb();
+        const stmt = db.prepare('SELECT * FROM memories WHERE id = ?');
+        const row = stmt.get(id);
+        if (!row)
+            throw new Error(`Memory with id ${id} not found`);
+        return this.parseRow(row);
+    }
+    async getUserMemories(userId, type) {
+        const db = this.storage.getDb();
+        let query = 'SELECT * FROM memories WHERE user_id = ?';
+        const params = [userId];
+        if (type) {
+            query += ' AND type = ?';
+            params.push(type);
+        }
+        query += ' ORDER BY weight DESC, created_at DESC';
+        const stmt = db.prepare(query);
+        const rows = stmt.all(...params);
+        return rows.map(this.parseRow);
+    }
+    async updateMemoryWeight(id, delta) {
+        const db = this.storage.getDb();
+        const stmt = db.prepare('UPDATE memories SET weight = weight + ? WHERE id = ?');
+        stmt.run(delta, id);
+    }
+    async searchMemories(userId, query, options = {}) {
+        const db = this.storage.getDb();
+        const limit = options.limit || 5;
+        let sql = `
+      SELECT * FROM memories 
+      WHERE user_id = ? 
+      AND content LIKE ?
+    `;
+        const params = [userId, `%${query}%`];
+        if (options.type) {
+            sql += ' AND type = ?';
+            params.push(options.type);
+        }
+        if (options.tier) {
+            sql += ' AND tier = ?';
+            params.push(options.tier);
+        }
+        sql += ' ORDER BY weight DESC, created_at DESC LIMIT ?';
+        params.push(limit);
+        const stmt = db.prepare(sql);
+        const rows = stmt.all(...params);
+        return rows.map(this.parseRow);
+    }
+    // Format memories for LLM context injection
+    async getFormattedMemories(userId, query) {
+        let memories;
+        if (query) {
+            memories = await this.searchMemories(userId, query);
+            // If no relevant memories found, fallback to recent high-weight memories
+            if (memories.length === 0) {
+                memories = await this.getUserMemories(userId);
+                memories = memories.slice(0, 5);
+            }
+        }
+        else {
+            memories = await this.getUserMemories(userId);
+            memories = memories.slice(0, 10);
+        }
+        if (memories.length === 0)
+            return '';
+        return memories.map(m => `- [${m.type.toUpperCase()}] ${m.content} (weight: ${m.weight})`).join('\n');
+    }
+    // Example of Memory Evolution logic: consolidating preferences
+    async updateMemoryTier(id, tier) {
+        const db = this.storage.getDb();
+        const now = new Date().toISOString();
+        db.prepare('UPDATE memories SET tier = ?, updated_at = ? WHERE id = ?').run(tier, now, id);
+    }
+    async deleteMemory(id) {
+        const db = this.storage.getDb();
+        db.prepare('DELETE FROM memories WHERE id = ?').run(id);
+    }
+    async getMemoriesByTier(userId, tier) {
+        const db = this.storage.getDb();
+        const rows = db.prepare('SELECT * FROM memories WHERE user_id = ? AND tier = ? ORDER BY weight DESC').all(userId, tier);
+        return rows.map(this.parseRow);
+    }
+    // Consolidate memories: Working -> Short-term -> Long-term
+    // Logic: 
+    // 1. Working memory items older than 1 hour move to Short-term
+    // 2. Short-term items with high weight (> 5) move to Long-term
+    // 3. Short-term items with low weight (< 0.5) and old (> 7 days) are pruned (deleted)
+    async consolidateMemories(userId) {
+        const db = this.storage.getDb();
+        const now = new Date();
+        let stats = { moved: 0, promoted: 0, pruned: 0 };
+        // 1. Working -> Short-term (if > 1 hour old)
+        const workingMemories = await this.getMemoriesByTier(userId, 'working');
+        // Log working memories stats if any
+        if (workingMemories.length > 0) {
+            console.log(`[Memory] Active working memories for ${userId}: ${workingMemories.length}`);
+        }
+        for (const mem of workingMemories) {
+            const age = now.getTime() - new Date(mem.created_at).getTime();
+            if (age > 60 * 60 * 1000) {
+                console.log(`[Memory] Moving ${mem.id} to short-term`);
+                await this.updateMemoryTier(mem.id, 'short_term');
+                stats.moved++;
+            }
+        }
+        // 2. Short-term -> Long-term (if weight > 5)
+        const shortTermMemories = await this.getMemoriesByTier(userId, 'short_term');
+        for (const mem of shortTermMemories) {
+            if (mem.weight > 5) {
+                console.log(`[Memory] Promoting ${mem.id} to long-term (high importance)`);
+                await this.updateMemoryTier(mem.id, 'long_term');
+                stats.promoted++;
+            }
+            else {
+                // Pruning check
+                const age = now.getTime() - new Date(mem.created_at).getTime();
+                if (mem.weight < 0.5 && age > 7 * 24 * 60 * 60 * 1000) {
+                    console.log(`[Memory] Pruning low-value memory ${mem.id}`);
+                    db.prepare('DELETE FROM memories WHERE id = ?').run(mem.id);
+                    stats.pruned++;
+                }
+            }
+        }
+        return stats;
+    }
+    async consolidatePreferences(userId) {
+        // This would involve LLM to summarize preferences, but for now just a placeholder
+        console.log(`Consolidating preferences for user ${userId}...`);
+    }
+}
+//# sourceMappingURL=MemoryManager.js.map

package/dist/memory/MemoryManager.js.map

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

package/dist/memory/evolution/MemoryEvolutionSystem.d.ts

@@ -0,0 +1,17 @@
+import { MemoryManager } from '../MemoryManager.js';
+import { LLMClient } from '../../llm/LLMClient.js';
+export interface ExtractedMemory {
+    type: 'preference' | 'fact' | 'context' | 'paper';
+    content: string;
+    metadata?: any;
+}
+export declare class MemoryEvolutionSystem {
+    private memoryManager;
+    private llm;
+    constructor(memoryManager: MemoryManager, llm: LLMClient);
+    evolve(userId: string, userQuery: string, agentResponse: string, onProgress?: (message: string) => void): Promise<{
+        added: any[];
+        updated: any[];
+    }>;
+    private parseResponse;
+}

package/dist/memory/evolution/MemoryEvolutionSystem.js

@@ -0,0 +1,71 @@
+export class MemoryEvolutionSystem {
+    memoryManager;
+    llm;
+    constructor(memoryManager, llm) {
+        this.memoryManager = memoryManager;
+        this.llm = llm;
+    }
+    // Analyze interaction and extract new memories
+    async evolve(userId, userQuery, agentResponse, onProgress) {
+        const log = (msg) => {
+            if (onProgress) {
+                onProgress(msg);
+            }
+            else {
+                console.log(msg);
+            }
+        };
+        log(`[Evolution] Analyzing interaction for user ${userId}...`);
+        const prompt = `
+      Analyze the following interaction between a User and an AI Assistant.
+      Extract any new information about:
+      1. User's preferences, research interests, or factual constraints (type: preference/fact/context).
+      2. Specific research papers or materials mentioned (type: paper).
+
+      For 'paper' type:
+      - Extract the Title, Authors, and URL (if present in markdown link or text).
+      - Metadata object: { title, authors (array), url (string), summary (string) }.
+
+      Output ONLY a JSON object with a "memories" array. Each item should have "type", "content", and optional "metadata".
+
+      User: "${userQuery}"
+      AI: "${agentResponse}"
+    `;
+        try {
+            const response = await this.llm.chat([
+                { role: 'system', content: 'You are a memory extraction system. You extract structured memories and research materials from conversations.' },
+                { role: 'user', content: prompt }
+            ]);
+            const extracted = this.parseResponse(response.content);
+            const added = [];
+            if (extracted && extracted.length > 0) {
+                log(`[Evolution] Extracted ${extracted.length} new memories.`);
+                for (const mem of extracted) {
+                    await this.memoryManager.addMemory(userId, mem.type, mem.content, mem.metadata);
+                    added.push(mem);
+                }
+            }
+            else {
+                log('[Evolution] No new memories extracted.');
+            }
+            return { added, updated: [] };
+        }
+        catch (error) {
+            console.error('[MemoryEvolution] Failed to evolve memory:', error);
+            return { added: [], updated: [] };
+        }
+    }
+    parseResponse(content) {
+        try {
+            // Simple JSON parsing, might need more robust handling for real LLM output
+            const jsonStr = content.match(/\{[\s\S]*\}/)?.[0] || content;
+            const parsed = JSON.parse(jsonStr);
+            return parsed.memories || [];
+        }
+        catch (e) {
+            console.warn('[MemoryEvolution] Failed to parse LLM response:', content);
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=MemoryEvolutionSystem.js.map

package/dist/memory/evolution/MemoryEvolutionSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryEvolutionSystem.js","sourceRoot":"","sources":["../../../src/memory/evolution/MemoryEvolutionSystem.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,qBAAqB;IACxB,aAAa,CAAgB;IAC7B,GAAG,CAAY;IAEvB,YAAY,aAA4B,EAAE,GAAc;QACtD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,+CAA+C;IACxC,KAAK,CAAC,MAAM,CACjB,MAAc,EACd,SAAiB,EACjB,aAAqB,EACrB,UAAsC;QAEtC,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE;YAC1B,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;QAEF,GAAG,CAAC,8CAA8C,MAAM,KAAK,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAG;;;;;;;;;;;;eAYJ,SAAS;aACX,aAAa;KACrB,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gHAAgH,EAAE;gBAC7I,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;aAClC,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM,KAAK,GAAG,EAAE,CAAC;YAEjB,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,GAAG,CAAC,yBAAyB,SAAS,CAAC,MAAM,gBAAgB,CAAC,CAAC;gBAC/D,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;oBAC5B,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAChF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,wCAAwC,CAAC,CAAC;YAChD,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAEhC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;YACnE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,OAAe;QACnC,IAAI,CAAC;YACH,2EAA2E;YAC3E,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;YAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,iDAAiD,EAAE,OAAO,CAAC,CAAC;YACzE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/memory/search/BM25Search.d.ts

@@ -0,0 +1,22 @@
+export interface SearchDocument {
+    id: string;
+    content: string;
+}
+export declare class BM25Search {
+    private documents;
+    private docLengths;
+    private avgDocLength;
+    private invertedIndex;
+    private k1;
+    private b;
+    private tokenizer;
+    constructor();
+    addDocument(doc: SearchDocument): void;
+    addDocuments(docs: SearchDocument[]): void;
+    private updateStats;
+    search(query: string, limit?: number): {
+        id: string;
+        score: number;
+    }[];
+    free(): void;
+}

package/dist/memory/search/BM25Search.js

@@ -0,0 +1,61 @@
+import { get_encoding } from 'tiktoken';
+export class BM25Search {
+    documents = new Map(); // id -> tokens
+    docLengths = new Map();
+    avgDocLength = 0;
+    invertedIndex = new Map(); // token -> list of doc ids
+    k1 = 1.5;
+    b = 0.75;
+    tokenizer;
+    constructor() {
+        this.tokenizer = get_encoding("cl100k_base");
+    }
+    addDocument(doc) {
+        const tokens = Array.from(this.tokenizer.encode(doc.content));
+        this.documents.set(doc.id, tokens);
+        this.docLengths.set(doc.id, tokens.length);
+        // Update index
+        const uniqueTokens = new Set(tokens);
+        uniqueTokens.forEach(token => {
+            if (!this.invertedIndex.has(token)) {
+                this.invertedIndex.set(token, []);
+            }
+            this.invertedIndex.get(token).push(doc.id);
+        });
+        this.updateStats();
+    }
+    addDocuments(docs) {
+        docs.forEach(doc => this.addDocument(doc));
+    }
+    updateStats() {
+        let totalLength = 0;
+        this.docLengths.forEach(len => totalLength += len);
+        this.avgDocLength = totalLength / Math.max(1, this.documents.size);
+    }
+    search(query, limit = 5) {
+        const queryTokens = Array.from(this.tokenizer.encode(query));
+        const scores = new Map();
+        queryTokens.forEach(token => {
+            const postingList = this.invertedIndex.get(token);
+            if (!postingList)
+                return;
+            const idf = Math.log(1 + (this.documents.size - postingList.length + 0.5) / (postingList.length + 0.5));
+            postingList.forEach(docId => {
+                const docLen = this.docLengths.get(docId) || 0;
+                const tf = this.documents.get(docId).filter(t => t === token).length;
+                const numerator = tf * (this.k1 + 1);
+                const denominator = tf + this.k1 * (1 - this.b + this.b * (docLen / this.avgDocLength));
+                const score = idf * (numerator / denominator);
+                scores.set(docId, (scores.get(docId) || 0) + score);
+            });
+        });
+        return Array.from(scores.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, limit)
+            .map(([id, score]) => ({ id, score }));
+    }
+    free() {
+        this.tokenizer.free();
+    }
+}
+//# sourceMappingURL=BM25Search.js.map

package/dist/memory/search/BM25Search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BM25Search.js","sourceRoot":"","sources":["../../../src/memory/search/BM25Search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAOxC,MAAM,OAAO,UAAU;IACX,SAAS,GAA0B,IAAI,GAAG,EAAE,CAAC,CAAC,eAAe;IAC7D,UAAU,GAAwB,IAAI,GAAG,EAAE,CAAC;IAC5C,YAAY,GAAW,CAAC,CAAC;IACzB,aAAa,GAA0B,IAAI,GAAG,EAAE,CAAC,CAAC,2BAA2B;IAC7E,EAAE,GAAW,GAAG,CAAC;IACjB,CAAC,GAAW,IAAI,CAAC;IACjB,SAAS,CAAM;IAEvB;QACI,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC;IAEM,WAAW,CAAC,GAAmB;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAa,CAAC;QAC1E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAE3C,eAAe;QACf,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACzB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IAEM,YAAY,CAAC,IAAsB;QACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAEO,WAAW;QACf,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IAEM,MAAM,CAAC,KAAa,EAAE,QAAgB,CAAC;QAC1C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAa,CAAC;QACzE,MAAM,MAAM,GAAwB,IAAI,GAAG,EAAE,CAAC;QAE9C,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACxB,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,CAAC,WAAW;gBAAE,OAAO;YAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,WAAW,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;YAExG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBACxB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;gBAEtE,MAAM,SAAS,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACrC,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;gBAExF,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,SAAS,GAAG,WAAW,CAAC,CAAC;gBAC9C,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;YACxD,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;aAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IAEM,IAAI;QACP,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;CACJ"}

package/dist/memory/structure/PageIndex.d.ts

@@ -0,0 +1,26 @@
+import { MemoryManager } from '../MemoryManager.js';
+import { LLMClient } from '../../llm/LLMClient.js';
+export interface PageNode {
+    id: string;
+    title: string;
+    content: string;
+    children: PageNode[];
+    parentId?: string;
+    level: number;
+}
+export declare class PageIndex {
+    private memoryManager;
+    private llm;
+    constructor(memoryManager: MemoryManager, llm: LLMClient);
+    /**
+     * Ingests a long document and creates a hierarchical tree of memories (Page Index).
+     * 1. Create Root Node (Level 0)
+     * 2. Split document into logical sections (Leaf Nodes)
+     * 3. Recursively summarize sections to build the tree bottom-up
+     * 4. Link the top-level summaries to the Root Node
+     */
+    indexDocument(userId: string, title: string, content: string): Promise<string>;
+    private updateIndexPaths;
+    private splitIntoSections;
+    getTree(rootId: string): Promise<PageNode | null>;
+}