cursor-recursive-rag 0.2.0-alpha.2 → 0.2.0

package/dist/services/cursorChatReader.js

@@ -0,0 +1,419 @@
+import Database from 'better-sqlite3';
+import { platform, homedir } from 'os';
+import { join } from 'path';
+import { existsSync } from 'fs';
+/**
+ * Message types in Cursor chat
+ */
+export var MessageType;
+(function (MessageType) {
+    MessageType[MessageType["USER"] = 1] = "USER";
+    MessageType[MessageType["ASSISTANT"] = 2] = "ASSISTANT";
+})(MessageType || (MessageType = {}));
+/**
+ * Reads chat history directly from Cursor's SQLite database
+ *
+ * Cursor stores data in two tables:
+ * - ItemTable: General key-value storage
+ * - cursorDiskKV: Composer (chat) data including conversations and messages
+ *
+ * Conversation structure:
+ * - composerData:{uuid} - Contains conversation metadata and list of bubble IDs
+ * - bubbleId:{conversationId}:{bubbleId} - Contains individual message content
+ */
+export class CursorChatReader {
+    dbPath;
+    constructor(customPath) {
+        this.dbPath = customPath ?? this.getDefaultDbPath();
+    }
+    /**
+     * Get the default database path based on OS
+     */
+    getDefaultDbPath() {
+        const home = homedir();
+        const os = platform();
+        switch (os) {
+            case 'darwin':
+                return join(home, 'Library/Application Support/Cursor/User/globalStorage/state.vscdb');
+            case 'win32':
+                return join(process.env.APPDATA ?? home, 'Cursor/User/globalStorage/state.vscdb');
+            case 'linux':
+                return join(home, '.config/Cursor/User/globalStorage/state.vscdb');
+            default:
+                throw new Error(`Unsupported platform: ${os}`);
+        }
+    }
+    /**
+     * Check if the database exists
+     */
+    isDatabaseAvailable() {
+        return existsSync(this.dbPath);
+    }
+    /**
+     * Get the database path
+     */
+    getDatabasePath() {
+        return this.dbPath;
+    }
+    /**
+     * List all conversations with summaries
+     */
+    listConversations(options) {
+        if (!this.isDatabaseAvailable()) {
+            return [];
+        }
+        const db = new Database(this.dbPath, { readonly: true, fileMustExist: true });
+        try {
+            // Get all composerData keys
+            const rows = db.prepare(`
+        SELECT key, value FROM cursorDiskKV 
+        WHERE key LIKE 'composerData:%'
+      `).all();
+            const conversations = [];
+            for (const row of rows) {
+                try {
+                    const conversationId = row.key.replace('composerData:', '');
+                    const data = JSON.parse(row.value.toString('utf-8'));
+                    // Get message count from fullConversationHeadersOnly
+                    const messageHeaders = data.fullConversationHeadersOnly || [];
+                    const messageCount = messageHeaders.length;
+                    if (messageCount === 0)
+                        continue;
+                    // Get first message timestamp if available
+                    let createdAt = null;
+                    let updatedAt = null;
+                    if (messageHeaders.length > 0) {
+                        const firstBubble = this.getBubble(db, conversationId, messageHeaders[0].bubbleId);
+                        if (firstBubble?.createdAt) {
+                            createdAt = new Date(firstBubble.createdAt);
+                        }
+                        const lastBubble = this.getBubble(db, conversationId, messageHeaders[messageHeaders.length - 1].bubbleId);
+                        if (lastBubble?.createdAt) {
+                            updatedAt = new Date(lastBubble.createdAt);
+                        }
+                    }
+                    // Apply filters
+                    if (options?.since && createdAt && createdAt < options.since) {
+                        continue;
+                    }
+                    // Get preview from first user message
+                    let preview = '';
+                    let hasCodeBlocks = false;
+                    for (const header of messageHeaders) {
+                        if (header.type === MessageType.USER) {
+                            const bubble = this.getBubble(db, conversationId, header.bubbleId);
+                            if (bubble) {
+                                preview = this.extractTextFromRichText(bubble.richText || '');
+                                if (preview)
+                                    break;
+                            }
+                        }
+                    }
+                    // Check for code blocks if filter requested
+                    if (options?.hasCode) {
+                        for (const header of messageHeaders) {
+                            const bubble = this.getBubble(db, conversationId, header.bubbleId);
+                            if (bubble?.suggestedCodeBlocks?.length > 0) {
+                                hasCodeBlocks = true;
+                                break;
+                            }
+                        }
+                        if (!hasCodeBlocks)
+                            continue;
+                    }
+                    conversations.push({
+                        id: conversationId,
+                        messageCount,
+                        createdAt,
+                        updatedAt,
+                        hasCodeBlocks,
+                        preview: preview.substring(0, 200) + (preview.length > 200 ? '...' : ''),
+                    });
+                }
+                catch (e) {
+                    // Skip malformed entries
+                    continue;
+                }
+            }
+            // Sort by updatedAt descending
+            conversations.sort((a, b) => {
+                if (!a.updatedAt && !b.updatedAt)
+                    return 0;
+                if (!a.updatedAt)
+                    return 1;
+                if (!b.updatedAt)
+                    return -1;
+                return b.updatedAt.getTime() - a.updatedAt.getTime();
+            });
+            // Apply limit
+            if (options?.limit) {
+                return conversations.slice(0, options.limit);
+            }
+            return conversations;
+        }
+        finally {
+            db.close();
+        }
+    }
+    /**
+     * Get a full conversation with all messages
+     */
+    getConversation(conversationId) {
+        if (!this.isDatabaseAvailable()) {
+            return null;
+        }
+        const db = new Database(this.dbPath, { readonly: true, fileMustExist: true });
+        try {
+            // Get composerData
+            const row = db.prepare(`
+        SELECT value FROM cursorDiskKV 
+        WHERE key = ?
+      `).get(`composerData:${conversationId}`);
+            if (!row)
+                return null;
+            const data = JSON.parse(row.value.toString('utf-8'));
+            const messageHeaders = data.fullConversationHeadersOnly || [];
+            const messages = [];
+            let createdAt = null;
+            let updatedAt = null;
+            let hasCodeBlocks = false;
+            let preview = '';
+            for (const header of messageHeaders) {
+                const bubble = this.getBubble(db, conversationId, header.bubbleId);
+                if (!bubble)
+                    continue;
+                const content = this.extractTextFromRichText(bubble.richText || '');
+                const codeBlocks = this.extractCodeBlocks(bubble);
+                if (codeBlocks.length > 0)
+                    hasCodeBlocks = true;
+                // Track timestamps
+                if (bubble.createdAt) {
+                    const timestamp = new Date(bubble.createdAt);
+                    if (!createdAt || timestamp < createdAt)
+                        createdAt = timestamp;
+                    if (!updatedAt || timestamp > updatedAt)
+                        updatedAt = timestamp;
+                }
+                // Get preview from first user message
+                if (!preview && header.type === MessageType.USER && content) {
+                    preview = content;
+                }
+                messages.push({
+                    id: header.bubbleId,
+                    type: header.type,
+                    content,
+                    createdAt: bubble.createdAt ? new Date(bubble.createdAt) : new Date(),
+                    codeBlocks,
+                    filesReferenced: this.extractFilesReferenced(bubble),
+                    isAgentic: bubble.isAgentic || false,
+                    toolResults: bubble.toolResults || [],
+                });
+            }
+            return {
+                id: conversationId,
+                messageCount: messages.length,
+                createdAt,
+                updatedAt,
+                hasCodeBlocks,
+                preview: preview.substring(0, 200) + (preview.length > 200 ? '...' : ''),
+                messages,
+            };
+        }
+        finally {
+            db.close();
+        }
+    }
+    /**
+     * Search conversations by content
+     */
+    searchConversations(query, options) {
+        const conversations = this.listConversations({ limit: 100, hasCode: options?.hasCode });
+        const queryLower = query.toLowerCase();
+        const results = [];
+        for (const summary of conversations) {
+            const conversation = this.getConversation(summary.id);
+            if (!conversation)
+                continue;
+            // Search in message content
+            const matches = conversation.messages.some(m => m.content.toLowerCase().includes(queryLower));
+            if (matches) {
+                results.push(conversation);
+                if (options?.maxResults && results.length >= options.maxResults) {
+                    break;
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Get conversation count
+     */
+    getConversationCount() {
+        if (!this.isDatabaseAvailable()) {
+            return 0;
+        }
+        const db = new Database(this.dbPath, { readonly: true, fileMustExist: true });
+        try {
+            const row = db.prepare(`
+        SELECT COUNT(*) as count FROM cursorDiskKV 
+        WHERE key LIKE 'composerData:%'
+      `).get();
+            return row.count;
+        }
+        finally {
+            db.close();
+        }
+    }
+    /**
+     * Get a single bubble (message) from the database
+     */
+    getBubble(db, conversationId, bubbleId) {
+        try {
+            const row = db.prepare(`
+        SELECT value FROM cursorDiskKV 
+        WHERE key = ?
+      `).get(`bubbleId:${conversationId}:${bubbleId}`);
+            if (!row)
+                return null;
+            return JSON.parse(row.value.toString('utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Extract plain text from Cursor's rich text format (Lexical)
+     */
+    extractTextFromRichText(richText) {
+        if (!richText)
+            return '';
+        try {
+            const parsed = JSON.parse(richText);
+            return this.extractTextFromNode(parsed.root);
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Recursively extract text from Lexical nodes
+     */
+    extractTextFromNode(node) {
+        if (!node)
+            return '';
+        let text = '';
+        if (node.text) {
+            text += node.text;
+        }
+        if (node.children && Array.isArray(node.children)) {
+            for (const child of node.children) {
+                text += this.extractTextFromNode(child);
+            }
+            // Add newline after paragraphs
+            if (node.type === 'paragraph') {
+                text += '\n';
+            }
+        }
+        return text;
+    }
+    /**
+     * Extract code blocks from a bubble
+     */
+    extractCodeBlocks(bubble) {
+        const blocks = [];
+        // From suggestedCodeBlocks
+        if (bubble.suggestedCodeBlocks && Array.isArray(bubble.suggestedCodeBlocks)) {
+            for (const block of bubble.suggestedCodeBlocks) {
+                blocks.push({
+                    language: block.language || 'text',
+                    code: block.code || '',
+                    filename: block.filename,
+                });
+            }
+        }
+        // From assistantSuggestedDiffs
+        if (bubble.assistantSuggestedDiffs && Array.isArray(bubble.assistantSuggestedDiffs)) {
+            for (const diff of bubble.assistantSuggestedDiffs) {
+                if (diff.newContent) {
+                    blocks.push({
+                        language: this.guessLanguageFromFilename(diff.filePath || ''),
+                        code: diff.newContent,
+                        filename: diff.filePath,
+                    });
+                }
+            }
+        }
+        return blocks;
+    }
+    /**
+     * Extract files referenced in a bubble
+     */
+    extractFilesReferenced(bubble) {
+        const files = [];
+        if (bubble.attachedFileCodeChunksMetadataOnly) {
+            for (const chunk of bubble.attachedFileCodeChunksMetadataOnly) {
+                if (chunk.relativeWorkspacePath) {
+                    files.push(chunk.relativeWorkspacePath);
+                }
+            }
+        }
+        if (bubble.relevantFiles) {
+            for (const file of bubble.relevantFiles) {
+                if (typeof file === 'string') {
+                    files.push(file);
+                }
+                else if (file.path) {
+                    files.push(file.path);
+                }
+            }
+        }
+        return [...new Set(files)];
+    }
+    /**
+     * Guess programming language from filename
+     */
+    guessLanguageFromFilename(filename) {
+        const ext = filename.split('.').pop()?.toLowerCase();
+        const languageMap = {
+            'ts': 'typescript',
+            'tsx': 'typescript',
+            'js': 'javascript',
+            'jsx': 'javascript',
+            'py': 'python',
+            'rb': 'ruby',
+            'go': 'go',
+            'rs': 'rust',
+            'php': 'php',
+            'java': 'java',
+            'kt': 'kotlin',
+            'swift': 'swift',
+            'cs': 'csharp',
+            'cpp': 'cpp',
+            'c': 'c',
+            'h': 'c',
+            'hpp': 'cpp',
+            'vue': 'vue',
+            'svelte': 'svelte',
+            'html': 'html',
+            'css': 'css',
+            'scss': 'scss',
+            'less': 'less',
+            'json': 'json',
+            'yaml': 'yaml',
+            'yml': 'yaml',
+            'md': 'markdown',
+            'sql': 'sql',
+            'sh': 'bash',
+            'bash': 'bash',
+            'zsh': 'bash',
+        };
+        return languageMap[ext || ''] || 'text';
+    }
+}
+/**
+ * Create a CursorChatReader instance
+ */
+export function createCursorChatReader(customPath) {
+    return new CursorChatReader(customPath);
+}
+//# sourceMappingURL=cursorChatReader.js.map

package/dist/services/cursorChatReader.js.map

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

package/dist/services/decayCalculator.d.ts

@@ -0,0 +1,85 @@
+import type { ChunkMetadata } from '../types/memory.js';
+import type { MemoryMetadataStore } from './memoryMetadataStore.js';
+/**
+ * Configuration for decay calculation
+ */
+export interface DecayCalculatorConfig {
+    halfLifeDays: number;
+    expectedAccessesPerMonth: number;
+    recencyBoostDays: number;
+    recencyBoostMultiplier: number;
+    weights: {
+        age: number;
+        access: number;
+        importance: number;
+    };
+    archivalThreshold: number;
+}
+export declare const DEFAULT_DECAY_CALCULATOR_CONFIG: DecayCalculatorConfig;
+export interface UpdateResult {
+    updated: number;
+    archived: number;
+    duration: number;
+}
+/**
+ * Calculates decay scores for chunks based on multiple factors
+ *
+ * Formula: decayScore = (ageFactor * weightAge) + (accessFactor * weightAccess) + (importanceFactor * weightImportance)
+ *
+ * Where:
+ * - ageFactor = 1.0 / (1.0 + (ageDays / halfLifeDays))
+ * - accessFactor = min(1.0, accessCount / expectedAccesses) * recencyBoost
+ * - importanceFactor = chunk.importance
+ */
+export declare class DecayCalculator {
+    private config;
+    constructor(config?: Partial<DecayCalculatorConfig>);
+    /**
+     * Calculate decay score for a single chunk
+     */
+    calculateDecayScore(chunk: ChunkMetadata, now?: Date): number;
+    /**
+     * Calculate age factor using exponential decay
+     * Returns 1.0 for new chunks, approaches 0 for very old chunks
+     */
+    private calculateAgeFactor;
+    /**
+     * Calculate access factor based on access count and recency
+     */
+    private calculateAccessFactor;
+    /**
+     * Calculate decay scores for multiple chunks
+     */
+    calculateBatchDecayScores(chunks: ChunkMetadata[], now?: Date): Array<{
+        chunkId: string;
+        decayScore: number;
+    }>;
+    /**
+     * Update all decay scores in the metadata store
+     */
+    updateAllDecayScores(store: MemoryMetadataStore, autoArchive?: boolean): UpdateResult;
+    /**
+     * Get chunks that are candidates for archival
+     */
+    getArchivalCandidates(chunks: ChunkMetadata[], threshold?: number): ChunkMetadata[];
+    /**
+     * Simulate decay over time for testing/visualization
+     */
+    simulateDecay(initialImportance: number, accessPattern: Array<{
+        dayOffset: number;
+    }>, daysToSimulate: number): Array<{
+        day: number;
+        decayScore: number;
+    }>;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): DecayCalculatorConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<DecayCalculatorConfig>): void;
+}
+export declare function getDecayCalculator(config?: Partial<DecayCalculatorConfig>): DecayCalculator;
+export declare function resetDecayCalculator(): void;
+//# sourceMappingURL=decayCalculator.d.ts.map

package/dist/services/decayCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decayCalculator.d.ts","sourceRoot":"","sources":["../../src/services/decayCalculator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAqC,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,MAAM,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,+BAA+B,EAAE,qBAW7C,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAWnD;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM;IAczE;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,yBAAyB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,GAAG,GAAE,IAAiB,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAO1H;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,EAAE,WAAW,GAAE,OAAe,GAAG,YAAY;IA2B5F;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAKnF;;OAEG;IACH,aAAa,CACX,iBAAiB,EAAE,MAAM,EACzB,aAAa,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EAC3C,cAAc,EAAE,MAAM,GACrB,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAoC7C;;OAEG;IACH,SAAS,IAAI,qBAAqB;IAIlC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;CAU3D;AAKD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,eAAe,CAK3F;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}