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

package/dist/services/conversationProcessor.js

@@ -0,0 +1,311 @@
+import { randomUUID } from 'crypto';
+const DEFAULT_OPTIONS = {
+    includeCodeChunks: true,
+    minExchangeLength: 50,
+    maxChunkSize: 2000,
+    extractEntities: true,
+};
+/**
+ * Processes raw conversations into structured chunks for RAG storage
+ */
+export class ConversationProcessor {
+    options;
+    constructor(options) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Process a conversation into chunks for storage
+     */
+    processConversation(conversation) {
+        const chunks = [];
+        const allFilesReferenced = [];
+        const allLanguages = new Set();
+        let codeBlockCount = 0;
+        // 1. Group messages into exchanges (user question + assistant responses)
+        const exchanges = this.groupIntoExchanges(conversation.messages);
+        // 2. Create chunks for each exchange
+        for (let i = 0; i < exchanges.length; i++) {
+            const exchange = exchanges[i];
+            const exchangeChunk = this.createExchangeChunk(exchange, conversation, i);
+            if (exchangeChunk.content.length >= (this.options.minExchangeLength || 50)) {
+                chunks.push(exchangeChunk);
+            }
+            // Collect files referenced
+            for (const msg of [exchange.userMessage, ...exchange.assistantMessages]) {
+                allFilesReferenced.push(...msg.filesReferenced);
+            }
+        }
+        // 3. Create separate chunks for significant code blocks
+        if (this.options.includeCodeChunks) {
+            for (let msgIdx = 0; msgIdx < conversation.messages.length; msgIdx++) {
+                const message = conversation.messages[msgIdx];
+                for (const codeBlock of message.codeBlocks) {
+                    codeBlockCount++;
+                    allLanguages.add(codeBlock.language);
+                    // Only create separate chunk for substantial code blocks
+                    if (codeBlock.code.length > 100) {
+                        const codeChunk = this.createCodeChunk(codeBlock, message, conversation, msgIdx);
+                        chunks.push(codeChunk);
+                    }
+                }
+            }
+        }
+        // 4. Extract entities
+        const entities = this.options.extractEntities
+            ? this.extractEntities(conversation, allLanguages)
+            : [];
+        return {
+            conversationId: conversation.id,
+            chunks,
+            entities,
+            metadata: {
+                messageCount: conversation.messages.length,
+                exchangeCount: exchanges.length,
+                codeBlockCount,
+                filesReferenced: [...new Set(allFilesReferenced)],
+                languages: [...allLanguages],
+            },
+        };
+    }
+    /**
+     * Group messages into user-assistant exchanges
+     */
+    groupIntoExchanges(messages) {
+        const exchanges = [];
+        let currentExchange = null;
+        for (const message of messages) {
+            if (message.type === 1) { // USER
+                // Save previous exchange if exists
+                if (currentExchange) {
+                    exchanges.push(currentExchange);
+                }
+                // Start new exchange
+                currentExchange = {
+                    userMessage: message,
+                    assistantMessages: [],
+                    timestamp: message.createdAt,
+                };
+            }
+            else if (message.type === 2 && currentExchange) { // ASSISTANT
+                currentExchange.assistantMessages.push(message);
+            }
+        }
+        // Don't forget the last exchange
+        if (currentExchange && currentExchange.assistantMessages.length > 0) {
+            exchanges.push(currentExchange);
+        }
+        return exchanges;
+    }
+    /**
+     * Create a chunk from a message exchange
+     */
+    createExchangeChunk(exchange, conversation, exchangeIndex) {
+        const content = this.formatExchange(exchange);
+        const importance = this.calculateExchangeImportance(exchange);
+        return {
+            id: `chat-${conversation.id.substring(0, 8)}-ex${exchangeIndex}-${randomUUID().substring(0, 8)}`,
+            content: this.truncateContent(content),
+            source: `cursor-chat:${conversation.id}`,
+            chunkType: 'solution',
+            importance,
+            metadata: {
+                type: 'exchange',
+                exchangeIndex,
+                hasCode: exchange.assistantMessages.some(m => m.codeBlocks.length > 0),
+                filesReferenced: [
+                    ...exchange.userMessage.filesReferenced,
+                    ...exchange.assistantMessages.flatMap(m => m.filesReferenced),
+                ],
+                isAgentic: exchange.assistantMessages.some(m => m.isAgentic),
+                timestamp: exchange.timestamp.toISOString(),
+            },
+            sourceConversationId: conversation.id,
+        };
+    }
+    /**
+     * Create a chunk from a code block
+     */
+    createCodeChunk(codeBlock, message, conversation, messageIndex) {
+        // Include context around the code
+        const content = this.formatCodeBlockWithContext(codeBlock, message);
+        const importance = this.calculateCodeImportance(codeBlock);
+        return {
+            id: `chat-${conversation.id.substring(0, 8)}-code-${randomUUID().substring(0, 8)}`,
+            content: this.truncateContent(content),
+            source: `cursor-chat:${conversation.id}`,
+            chunkType: 'code',
+            importance,
+            metadata: {
+                type: 'code',
+                language: codeBlock.language,
+                filename: codeBlock.filename,
+                messageIndex,
+                timestamp: message.createdAt.toISOString(),
+            },
+            sourceConversationId: conversation.id,
+            sourceMessageIndex: messageIndex,
+        };
+    }
+    /**
+     * Format an exchange as readable text
+     */
+    formatExchange(exchange) {
+        const parts = [];
+        // User question
+        if (exchange.userMessage.content.trim()) {
+            parts.push(`## User Question\n${exchange.userMessage.content.trim()}`);
+        }
+        // Assistant response(s)
+        const responses = exchange.assistantMessages
+            .map(m => m.content.trim())
+            .filter(c => c.length > 0)
+            .join('\n\n');
+        if (responses) {
+            parts.push(`## Assistant Response\n${responses}`);
+        }
+        // Include code blocks inline
+        const codeBlocks = exchange.assistantMessages.flatMap(m => m.codeBlocks);
+        if (codeBlocks.length > 0) {
+            const codeSection = codeBlocks
+                .map(cb => `\`\`\`${cb.language}${cb.filename ? ` (${cb.filename})` : ''}\n${cb.code}\n\`\`\``)
+                .join('\n\n');
+            parts.push(`## Code\n${codeSection}`);
+        }
+        // Files referenced
+        const files = [
+            ...exchange.userMessage.filesReferenced,
+            ...exchange.assistantMessages.flatMap(m => m.filesReferenced),
+        ];
+        if (files.length > 0) {
+            const uniqueFiles = [...new Set(files)];
+            parts.push(`## Files Referenced\n${uniqueFiles.join(', ')}`);
+        }
+        return parts.join('\n\n');
+    }
+    /**
+     * Format a code block with surrounding context
+     */
+    formatCodeBlockWithContext(codeBlock, message) {
+        const parts = [];
+        // Add filename as title if available
+        if (codeBlock.filename) {
+            parts.push(`# ${codeBlock.filename}`);
+        }
+        // Add language info
+        parts.push(`Language: ${codeBlock.language}`);
+        // Add the code
+        parts.push(`\`\`\`${codeBlock.language}\n${codeBlock.code}\n\`\`\``);
+        // Add context from the message (truncated)
+        if (message.content) {
+            const context = message.content.substring(0, 500);
+            parts.push(`Context: ${context}${message.content.length > 500 ? '...' : ''}`);
+        }
+        return parts.join('\n\n');
+    }
+    /**
+     * Calculate importance score for an exchange
+     */
+    calculateExchangeImportance(exchange) {
+        let importance = 0.5;
+        // Boost for code-containing responses
+        if (exchange.assistantMessages.some(m => m.codeBlocks.length > 0)) {
+            importance += 0.15;
+        }
+        // Boost for longer, detailed responses
+        const totalLength = exchange.assistantMessages.reduce((sum, m) => sum + m.content.length, 0);
+        if (totalLength > 2000)
+            importance += 0.1;
+        if (totalLength > 5000)
+            importance += 0.05;
+        // Boost for file modifications (agentic responses)
+        if (exchange.assistantMessages.some(m => m.isAgentic)) {
+            importance += 0.1;
+        }
+        // Boost for file references
+        const filesCount = exchange.assistantMessages.reduce((sum, m) => sum + m.filesReferenced.length, 0);
+        if (filesCount > 0)
+            importance += 0.05;
+        if (filesCount > 5)
+            importance += 0.05;
+        return Math.min(1.0, importance);
+    }
+    /**
+     * Calculate importance score for a code block
+     */
+    calculateCodeImportance(codeBlock) {
+        let importance = 0.6; // Code blocks start higher
+        // Boost for longer code
+        if (codeBlock.code.length > 200)
+            importance += 0.1;
+        if (codeBlock.code.length > 500)
+            importance += 0.1;
+        // Boost for code with filename (more specific)
+        if (codeBlock.filename)
+            importance += 0.1;
+        return Math.min(1.0, importance);
+    }
+    /**
+     * Extract entities from the conversation
+     */
+    extractEntities(conversation, languages) {
+        const entities = [];
+        const content = conversation.messages.map(m => m.content).join(' ').toLowerCase();
+        // Languages from code blocks
+        for (const lang of languages) {
+            entities.push({
+                type: 'language',
+                value: lang,
+                confidence: 1.0,
+            });
+        }
+        // Common frameworks/tools (simple pattern matching)
+        const patterns = [
+            { pattern: /\breact\b/i, type: 'framework', value: 'react' },
+            { pattern: /\bvue\b/i, type: 'framework', value: 'vue' },
+            { pattern: /\bangular\b/i, type: 'framework', value: 'angular' },
+            { pattern: /\bnext\.?js\b/i, type: 'framework', value: 'nextjs' },
+            { pattern: /\bnuxt\b/i, type: 'framework', value: 'nuxt' },
+            { pattern: /\blaravel\b/i, type: 'framework', value: 'laravel' },
+            { pattern: /\bdjango\b/i, type: 'framework', value: 'django' },
+            { pattern: /\bexpress\b/i, type: 'framework', value: 'express' },
+            { pattern: /\bpostgres(?:ql)?\b/i, type: 'tool', value: 'postgresql' },
+            { pattern: /\bmysql\b/i, type: 'tool', value: 'mysql' },
+            { pattern: /\bredis\b/i, type: 'tool', value: 'redis' },
+            { pattern: /\bdocker\b/i, type: 'tool', value: 'docker' },
+            { pattern: /\bkubernetes\b/i, type: 'tool', value: 'kubernetes' },
+            { pattern: /\baws\b/i, type: 'tool', value: 'aws' },
+            { pattern: /\bcloudflare\b/i, type: 'tool', value: 'cloudflare' },
+            { pattern: /\btailwind\b/i, type: 'framework', value: 'tailwindcss' },
+        ];
+        for (const { pattern, type, value } of patterns) {
+            if (pattern.test(content)) {
+                entities.push({ type, value, confidence: 0.8 });
+            }
+        }
+        // Deduplicate
+        const seen = new Set();
+        return entities.filter(e => {
+            const key = `${e.type}:${e.value}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+    }
+    /**
+     * Truncate content to max chunk size
+     */
+    truncateContent(content) {
+        const maxSize = this.options.maxChunkSize || 2000;
+        if (content.length <= maxSize)
+            return content;
+        return content.substring(0, maxSize - 3) + '...';
+    }
+}
+/**
+ * Create a conversation processor
+ */
+export function createConversationProcessor(options) {
+    return new ConversationProcessor(options);
+}
+//# sourceMappingURL=conversationProcessor.js.map

package/dist/services/conversationProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationProcessor.js","sourceRoot":"","sources":["../../src/services/conversationProcessor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAmDpC,MAAM,eAAe,GAAsB;IACzC,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,EAAE;IACrB,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,IAAI;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACxB,OAAO,CAAoB;IAEnC,YAAY,OAAoC;QAC9C,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,YAA0B;QAC5C,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,MAAM,kBAAkB,GAAa,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QACvC,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,yEAAyE;QACzE,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAEjE,qCAAqC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAE1E,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC3E,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC7B,CAAC;YAED,2BAA2B;YAC3B,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACxE,kBAAkB,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,IAAI,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACnC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;gBACrE,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAE9C,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;oBAC3C,cAAc,EAAE,CAAC;oBACjB,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;oBAErC,yDAAyD;oBACzD,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;wBAChC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;wBACjF,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe;YAC3C,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,YAAY,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,cAAc,EAAE,YAAY,CAAC,EAAE;YAC/B,MAAM;YACN,QAAQ;YACR,QAAQ,EAAE;gBACR,YAAY,EAAE,YAAY,CAAC,QAAQ,CAAC,MAAM;gBAC1C,aAAa,EAAE,SAAS,CAAC,MAAM;gBAC/B,cAAc;gBACd,eAAe,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBACjD,SAAS,EAAE,CAAC,GAAG,YAAY,CAAC;aAC7B;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,QAAuB;QAChD,MAAM,SAAS,GAAsB,EAAE,CAAC;QACxC,IAAI,eAAe,GAA2B,IAAI,CAAC;QAEnD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO;gBAC/B,mCAAmC;gBACnC,IAAI,eAAe,EAAE,CAAC;oBACpB,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAClC,CAAC;gBACD,qBAAqB;gBACrB,eAAe,GAAG;oBAChB,WAAW,EAAE,OAAO;oBACpB,iBAAiB,EAAE,EAAE;oBACrB,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC;YACJ,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,YAAY;gBAC9D,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,IAAI,eAAe,IAAI,eAAe,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpE,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,mBAAmB,CACzB,QAAyB,EACzB,YAA0B,EAC1B,aAAqB;QAErB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QAE9D,OAAO;YACL,EAAE,EAAE,QAAQ,YAAY,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,aAAa,IAAI,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAChG,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;YACtC,MAAM,EAAE,eAAe,YAAY,CAAC,EAAE,EAAE;YACxC,SAAS,EAAE,UAAuB;YAClC,UAAU;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,aAAa;gBACb,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;gBACtE,eAAe,EAAE;oBACf,GAAG,QAAQ,CAAC,WAAW,CAAC,eAAe;oBACvC,GAAG,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;iBAC9D;gBACD,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC5D,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE;aAC5C;YACD,oBAAoB,EAAE,YAAY,CAAC,EAAE;SACtC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,SAAoB,EACpB,OAAoB,EACpB,YAA0B,EAC1B,YAAoB;QAEpB,kCAAkC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,0BAA0B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;QAE3D,OAAO;YACL,EAAE,EAAE,QAAQ,YAAY,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAClF,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;YACtC,MAAM,EAAE,eAAe,YAAY,CAAC,EAAE,EAAE;YACxC,SAAS,EAAE,MAAmB;YAC9B,UAAU;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,YAAY;gBACZ,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE;aAC3C;YACD,oBAAoB,EAAE,YAAY,CAAC,EAAE;YACrC,kBAAkB,EAAE,YAAY;SACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,QAAyB;QAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,gBAAgB;QAChB,IAAI,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,qBAAqB,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,wBAAwB;QACxB,MAAM,SAAS,GAAG,QAAQ,CAAC,iBAAiB;aACzC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aACzB,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,6BAA6B;QAC7B,MAAM,UAAU,GAAG,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACzE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,WAAW,GAAG,UAAU;iBAC3B,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,UAAU,CAAC;iBAC9F,IAAI,CAAC,MAAM,CAAC,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,mBAAmB;QACnB,MAAM,KAAK,GAAG;YACZ,GAAG,QAAQ,CAAC,WAAW,CAAC,eAAe;YACvC,GAAG,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;SAC9D,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,wBAAwB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,0BAA0B,CAAC,SAAoB,EAAE,OAAoB;QAC3E,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,qCAAqC;QACrC,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,oBAAoB;QACpB,KAAK,CAAC,IAAI,CAAC,aAAa,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE9C,eAAe;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,IAAI,UAAU,CAAC,CAAC;QAErE,2CAA2C;QAC3C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,2BAA2B,CAAC,QAAyB;QAC3D,IAAI,UAAU,GAAG,GAAG,CAAC;QAErB,sCAAsC;QACtC,IAAI,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YAClE,UAAU,IAAI,IAAI,CAAC;QACrB,CAAC;QAED,uCAAuC;QACvC,MAAM,WAAW,GAAG,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7F,IAAI,WAAW,GAAG,IAAI;YAAE,UAAU,IAAI,GAAG,CAAC;QAC1C,IAAI,WAAW,GAAG,IAAI;YAAE,UAAU,IAAI,IAAI,CAAC;QAE3C,mDAAmD;QACnD,IAAI,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;YACtD,UAAU,IAAI,GAAG,CAAC;QACpB,CAAC;QAED,4BAA4B;QAC5B,MAAM,UAAU,GAAG,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACpG,IAAI,UAAU,GAAG,CAAC;YAAE,UAAU,IAAI,IAAI,CAAC;QACvC,IAAI,UAAU,GAAG,CAAC;YAAE,UAAU,IAAI,IAAI,CAAC;QAEvC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,SAAoB;QAClD,IAAI,UAAU,GAAG,GAAG,CAAC,CAAC,2BAA2B;QAEjD,wBAAwB;QACxB,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG;YAAE,UAAU,IAAI,GAAG,CAAC;QACnD,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG;YAAE,UAAU,IAAI,GAAG,CAAC;QAEnD,+CAA+C;QAC/C,IAAI,SAAS,CAAC,QAAQ;YAAE,UAAU,IAAI,GAAG,CAAC;QAE1C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,YAA0B,EAAE,SAAsB;QACxE,MAAM,QAAQ,GAAgB,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAElF,6BAA6B;QAC7B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,UAAwB;gBAC9B,KAAK,EAAE,IAAI;gBACX,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;QAED,oDAAoD;QACpD,MAAM,QAAQ,GAAgE;YAC5E,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,WAAyB,EAAE,KAAK,EAAE,OAAO,EAAE;YAC1E,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAyB,EAAE,KAAK,EAAE,KAAK,EAAE;YACtE,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,WAAyB,EAAE,KAAK,EAAE,SAAS,EAAE;YAC9E,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAyB,EAAE,KAAK,EAAE,QAAQ,EAAE;YAC/E,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,WAAyB,EAAE,KAAK,EAAE,MAAM,EAAE;YACxE,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,WAAyB,EAAE,KAAK,EAAE,SAAS,EAAE;YAC9E,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,WAAyB,EAAE,KAAK,EAAE,QAAQ,EAAE;YAC5E,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,WAAyB,EAAE,KAAK,EAAE,SAAS,EAAE;YAC9E,EAAE,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAoB,EAAE,KAAK,EAAE,YAAY,EAAE;YACpF,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAoB,EAAE,KAAK,EAAE,OAAO,EAAE;YACrE,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAoB,EAAE,KAAK,EAAE,OAAO,EAAE;YACrE,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE;YACvE,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAoB,EAAE,KAAK,EAAE,YAAY,EAAE;YAC/E,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAoB,EAAE,KAAK,EAAE,KAAK,EAAE;YACjE,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAoB,EAAE,KAAK,EAAE,YAAY,EAAE;YAC/E,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,WAAyB,EAAE,KAAK,EAAE,aAAa,EAAE;SACpF,CAAC;QAEF,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;YAChD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,cAAc;QACd,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACzB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAe;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;QAClD,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC9C,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IACnD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAoC;IAC9E,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/services/cursorChatReader.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Message types in Cursor chat
+ */
+export declare enum MessageType {
+    USER = 1,
+    ASSISTANT = 2
+}
+/**
+ * Code block extracted from a message
+ */
+export interface CodeBlock {
+    language: string;
+    code: string;
+    filename?: string;
+}
+/**
+ * A single message (bubble) in a conversation
+ */
+export interface ChatMessage {
+    id: string;
+    type: MessageType;
+    content: string;
+    createdAt: Date;
+    codeBlocks: CodeBlock[];
+    filesReferenced: string[];
+    isAgentic: boolean;
+    toolResults: any[];
+}
+/**
+ * Summary of a conversation
+ */
+export interface ConversationSummary {
+    id: string;
+    messageCount: number;
+    createdAt: Date | null;
+    updatedAt: Date | null;
+    hasCodeBlocks: boolean;
+    preview: string;
+}
+/**
+ * Full conversation with messages
+ */
+export interface Conversation extends ConversationSummary {
+    messages: ChatMessage[];
+}
+/**
+ * Options for listing conversations
+ */
+export interface ListConversationsOptions {
+    limit?: number;
+    since?: Date;
+    hasCode?: boolean;
+    includeMessages?: boolean;
+}
+/**
+ * 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 declare class CursorChatReader {
+    private dbPath;
+    constructor(customPath?: string);
+    /**
+     * Get the default database path based on OS
+     */
+    private getDefaultDbPath;
+    /**
+     * Check if the database exists
+     */
+    isDatabaseAvailable(): boolean;
+    /**
+     * Get the database path
+     */
+    getDatabasePath(): string;
+    /**
+     * List all conversations with summaries
+     */
+    listConversations(options?: ListConversationsOptions): ConversationSummary[];
+    /**
+     * Get a full conversation with all messages
+     */
+    getConversation(conversationId: string): Conversation | null;
+    /**
+     * Search conversations by content
+     */
+    searchConversations(query: string, options?: {
+        maxResults?: number;
+        hasCode?: boolean;
+    }): Conversation[];
+    /**
+     * Get conversation count
+     */
+    getConversationCount(): number;
+    /**
+     * Get a single bubble (message) from the database
+     */
+    private getBubble;
+    /**
+     * Extract plain text from Cursor's rich text format (Lexical)
+     */
+    private extractTextFromRichText;
+    /**
+     * Recursively extract text from Lexical nodes
+     */
+    private extractTextFromNode;
+    /**
+     * Extract code blocks from a bubble
+     */
+    private extractCodeBlocks;
+    /**
+     * Extract files referenced in a bubble
+     */
+    private extractFilesReferenced;
+    /**
+     * Guess programming language from filename
+     */
+    private guessLanguageFromFilename;
+}
+/**
+ * Create a CursorChatReader instance
+ */
+export declare function createCursorChatReader(customPath?: string): CursorChatReader;
+//# sourceMappingURL=cursorChatReader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursorChatReader.d.ts","sourceRoot":"","sources":["../../src/services/cursorChatReader.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,oBAAY,WAAW;IACrB,IAAI,IAAI;IACR,SAAS,IAAI;CACd;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,GAAG,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACvD,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAEX,UAAU,CAAC,EAAE,MAAM;IAI/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,mBAAmB,EAAE;IA2G5E;;OAEG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAwE5D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,YAAY,EAAE;IAyBxG;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAmB9B;;OAEG;IACH,OAAO,CAAC,SAAS;IAcjB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAqClC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAE5E"}