cortex-mcp 1.2.4 → 1.4.1

package/dist/memory/impact-analyzer.js

@@ -0,0 +1,189 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeImpact = analyzeImpact;
+exports.formatImpact = formatImpact;
+/**
+ * Impact Analyzer — Shows what breaks when you change a file.
+ *
+ * Before editing file A, this module checks the architecture graph
+ * to find all files that import from A (dependents).
+ * Prevents breaking changes by making dependencies visible.
+ *
+ * Like checking "who's using this?" before changing an API.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Analyze the impact of changing a file.
+ * Scans for import statements that reference the target file.
+ */
+function analyzeImpact(targetFile, workspaceRoot) {
+    const result = {
+        targetFile,
+        directDependents: [],
+        indirectDependents: [],
+        totalImpact: 0,
+        exports: [],
+        riskLevel: 'LOW',
+    };
+    if (!workspaceRoot || !fs.existsSync(workspaceRoot))
+        return result;
+    // Normalize target for matching
+    const targetBasename = path.basename(targetFile).replace(/\.(ts|tsx|js|jsx)$/, '');
+    const targetRelative = path.relative(workspaceRoot, targetFile).replace(/\\/g, '/');
+    // Get all source files
+    const allFiles = getAllSourceFiles(workspaceRoot);
+    // Find what the target exports
+    try {
+        const targetContent = fs.readFileSync(fs.existsSync(targetFile) ? targetFile : path.join(workspaceRoot, targetFile), 'utf-8');
+        const exportMatches = targetContent.match(/export\s+(?:function|class|const|let|type|interface|enum)\s+(\w+)/g);
+        if (exportMatches) {
+            result.exports = exportMatches.map(m => {
+                const name = m.match(/\s(\w+)$/);
+                return name ? name[1] : m;
+            });
+        }
+    }
+    catch { /* file read failure is non-fatal */ }
+    // Scan all files for imports from target
+    for (const file of allFiles) {
+        if (file === targetRelative)
+            continue;
+        try {
+            const content = fs.readFileSync(path.join(workspaceRoot, file), 'utf-8');
+            // Check for imports referencing the target file
+            const importPattern = new RegExp(`(?:import|require).*(?:${escapeRegex(targetBasename)}|${escapeRegex(targetRelative.replace(/\.(ts|tsx|js|jsx)$/, ''))})`, 'i');
+            if (importPattern.test(content)) {
+                result.directDependents.push(file);
+            }
+        }
+        catch { /* ignore read failures */ }
+    }
+    // Find indirect dependents (files that import from direct dependents)
+    const directSet = new Set(result.directDependents);
+    for (const depFile of result.directDependents) {
+        const depBasename = path.basename(depFile).replace(/\.(ts|tsx|js|jsx)$/, '');
+        for (const file of allFiles) {
+            if (directSet.has(file) || file === targetRelative)
+                continue;
+            try {
+                const content = fs.readFileSync(path.join(workspaceRoot, file), 'utf-8');
+                if (content.includes(depBasename)) {
+                    result.indirectDependents.push(file);
+                }
+            }
+            catch { /* ignore */ }
+        }
+    }
+    // Deduplicate indirect
+    result.indirectDependents = [...new Set(result.indirectDependents)];
+    result.totalImpact = result.directDependents.length + result.indirectDependents.length;
+    // Risk level
+    if (result.totalImpact === 0)
+        result.riskLevel = 'LOW';
+    else if (result.totalImpact <= 3)
+        result.riskLevel = 'MEDIUM';
+    else if (result.totalImpact <= 8)
+        result.riskLevel = 'HIGH';
+    else
+        result.riskLevel = 'CRITICAL';
+    return result;
+}
+/** Format impact analysis for AI consumption */
+function formatImpact(result) {
+    const riskEmoji = {
+        LOW: '🟢', MEDIUM: '🟡', HIGH: '🟠', CRITICAL: '🔴',
+    };
+    const lines = [
+        `# 💥 Impact Analysis: ${path.basename(result.targetFile)}`,
+        `\n**Risk Level:** ${riskEmoji[result.riskLevel]} ${result.riskLevel} (${result.totalImpact} files affected)`,
+    ];
+    if (result.exports.length > 0) {
+        lines.push(`\n**Exports:** \`${result.exports.slice(0, 10).join('`, `')}\``);
+    }
+    if (result.directDependents.length > 0) {
+        lines.push(`\n## Direct Dependents (${result.directDependents.length} files import this)`);
+        result.directDependents.forEach(f => lines.push(`- 📁 ${f}`));
+    }
+    if (result.indirectDependents.length > 0) {
+        lines.push(`\n## Indirect Dependents (${result.indirectDependents.length} files)`);
+        result.indirectDependents.slice(0, 5).forEach(f => lines.push(`- 📁 ${f}`));
+        if (result.indirectDependents.length > 5) {
+            lines.push(`_...and ${result.indirectDependents.length - 5} more_`);
+        }
+    }
+    if (result.totalImpact === 0) {
+        lines.push('\n✅ **No dependents found.** Safe to modify.');
+    }
+    else if (result.riskLevel === 'CRITICAL' || result.riskLevel === 'HIGH') {
+        lines.push('\n> ⚠️ **Caution:** Many files depend on this. Changing exports or signatures may cause cascading failures.');
+    }
+    return lines.join('\n');
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function getAllSourceFiles(root, maxFiles = 200) {
+    const files = [];
+    const ignore = new Set(['node_modules', '.git', 'dist', 'coverage', '.next', 'build', 'out']);
+    const exts = new Set(['.ts', '.tsx', '.js', '.jsx']);
+    function walk(dir, depth) {
+        if (depth > 4 || files.length >= maxFiles)
+            return;
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (ignore.has(entry.name) || entry.name.startsWith('.'))
+                    continue;
+                const full = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walk(full, depth + 1);
+                }
+                else {
+                    const ext = path.extname(entry.name);
+                    if (exts.has(ext) && !entry.name.endsWith('.d.ts')) {
+                        files.push(path.relative(root, full).replace(/\\/g, '/'));
+                    }
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    walk(root, 0);
+    return files;
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=impact-analyzer.js.map

package/dist/memory/impact-analyzer.js.map

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

package/dist/memory/instructions-generator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Contextual Instructions Generator — Converts raw memories into direct DO/DON'T rules.
+ *
+ * THE GAP THIS FILLS:
+ * Currently, force_recall dumps memories like:
+ *   "[CONVENTION] Arrow functions preferred over function declarations"
+ * But the AI has to interpret this. What it actually needs is:
+ *   "DO: Use arrow functions. DON'T: Use function declarations."
+ *
+ * This module converts conventions, corrections, and preferences into
+ * imperative instructions that the AI can follow without thinking.
+ *
+ * Like a military briefing: clear, direct, no interpretation needed.
+ */
+import { MemoryStore } from '../db/memory-store';
+export interface InstructionSet {
+    dos: string[];
+    donts: string[];
+    watchOuts: string[];
+    style: string[];
+}
+/**
+ * Generate contextual instructions from stored memories.
+ */
+export declare function generateInstructions(memoryStore: MemoryStore): InstructionSet;
+/**
+ * Format instructions as a clear, imperative briefing.
+ */
+export declare function formatInstructions(instructions: InstructionSet): string;
+//# sourceMappingURL=instructions-generator.d.ts.map

package/dist/memory/instructions-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions-generator.d.ts","sourceRoot":"","sources":["../../src/memory/instructions-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAiF7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,cAAc,GAAG,MAAM,CAwBvE"}

package/dist/memory/instructions-generator.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateInstructions = generateInstructions;
+exports.formatInstructions = formatInstructions;
+const types_1 = require("../types");
+/**
+ * Generate contextual instructions from stored memories.
+ */
+function generateInstructions(memoryStore) {
+    const instructions = {
+        dos: [],
+        donts: [],
+        watchOuts: [],
+        style: [],
+    };
+    const active = memoryStore.getActive(200);
+    for (const m of active) {
+        const intent = m.intent.toLowerCase();
+        const full = `${m.intent} ${m.action || ''} ${m.reason || ''}`;
+        // ─── Corrections → DON'Ts ──────────────────────────────────────
+        if (m.type === types_1.MemoryType.CORRECTION) {
+            // Extract the "don't do X" from corrections
+            const noMatch = full.match(/(?:no[,.]?\s+use|don'?t\s+use|never\s+use|avoid|instead\s+of)\s+(\w[\w\s]{3,40})/i);
+            const yesMatch = full.match(/(?:use|prefer|always\s+use|should\s+use|switch\s+to)\s+(\w[\w\s]{3,40})/i);
+            if (noMatch) {
+                instructions.donts.push(`DON'T: ${noMatch[1].trim()}`);
+            }
+            if (yesMatch) {
+                instructions.dos.push(`DO: ${yesMatch[1].trim()}`);
+            }
+            if (!noMatch && !yesMatch) {
+                instructions.watchOuts.push(`⚠️ Past correction: ${m.intent.slice(0, 80)}`);
+            }
+        }
+        // ─── Conventions → DOs ─────────────────────────────────────────
+        if (m.type === types_1.MemoryType.CONVENTION) {
+            // Check if this is a preference (communication style)
+            if (m.tags?.includes('preference')) {
+                instructions.style.push(m.intent.slice(0, 80));
+                continue;
+            }
+            // Auto-detected conventions → direct rules
+            if (m.tags?.includes('auto-detected')) {
+                if (intent.includes('arrow function')) {
+                    instructions.dos.push('DO: Use arrow functions (const fn = () => {})');
+                }
+                else if (intent.includes('function declaration')) {
+                    instructions.dos.push('DO: Use function declarations (function fn() {})');
+                }
+                else if (intent.includes('const over let')) {
+                    instructions.dos.push('DO: Use const by default, let only when reassignment needed');
+                }
+                else if (intent.includes('semicolon')) {
+                    if (intent.includes('always'))
+                        instructions.dos.push('DO: Always use semicolons');
+                    else
+                        instructions.dos.push('DO: Omit semicolons (ASI style)');
+                }
+                else if (intent.includes('single quote')) {
+                    instructions.dos.push('DO: Use single quotes for strings');
+                }
+                else if (intent.includes('double quote')) {
+                    instructions.dos.push('DO: Use double quotes for strings');
+                }
+                else {
+                    instructions.dos.push(`DO: ${m.intent.slice(0, 80)}`);
+                }
+                continue;
+            }
+            instructions.dos.push(`DO: ${m.intent.slice(0, 80)}`);
+        }
+        // ─── Bug Fixes → Watch Outs ───────────────────────────────────
+        if (m.type === types_1.MemoryType.BUG_FIX) {
+            if (m.tags?.includes('error-pattern')) {
+                // These are TS error lessons
+                instructions.watchOuts.push(`⚠️ ${m.intent.replace('[ERROR PATTERN] ', '').slice(0, 80)}`);
+            }
+            else {
+                instructions.watchOuts.push(`⚠️ Known bug: ${m.intent.slice(0, 80)}`);
+            }
+        }
+    }
+    // Deduplicate
+    instructions.dos = [...new Set(instructions.dos)].slice(0, 15);
+    instructions.donts = [...new Set(instructions.donts)].slice(0, 10);
+    instructions.watchOuts = [...new Set(instructions.watchOuts)].slice(0, 10);
+    instructions.style = [...new Set(instructions.style)].slice(0, 5);
+    return instructions;
+}
+/**
+ * Format instructions as a clear, imperative briefing.
+ */
+function formatInstructions(instructions) {
+    const sections = [];
+    if (instructions.dos.length > 0) {
+        sections.push('## ✅ Project Rules (DO)');
+        for (const d of instructions.dos)
+            sections.push(`- ${d}`);
+    }
+    if (instructions.donts.length > 0) {
+        sections.push('\n## ❌ Avoid (DON\'T)');
+        for (const d of instructions.donts)
+            sections.push(`- ${d}`);
+    }
+    if (instructions.watchOuts.length > 0) {
+        sections.push('\n## ⚠️ Watch Out');
+        for (const w of instructions.watchOuts)
+            sections.push(`- ${w}`);
+    }
+    if (instructions.style.length > 0) {
+        sections.push('\n## 🎯 Communication Style');
+        for (const s of instructions.style)
+            sections.push(`- ${s}`);
+    }
+    return sections.length > 0 ? sections.join('\n') : '';
+}
+//# sourceMappingURL=instructions-generator.js.map

package/dist/memory/instructions-generator.js.map

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

package/dist/memory/pre-flight.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pre-Flight Checks — Convention check BEFORE writing code.
+ *
+ * Instead of reviewing code AFTER it's written (review_code),
+ * this tells the AI what conventions and gotchas exist for a file/task
+ * BEFORE a single line is written.
+ *
+ * Like a pilot's pre-flight checklist — don't take off without checking.
+ */
+import { MemoryStore } from '../db/memory-store';
+export interface PreFlightResult {
+    conventions: string[];
+    gotchas: string[];
+    pastBugs: string[];
+    fileNotes: string[];
+    recentCorrections: string[];
+}
+/**
+ * Get everything the AI needs to know BEFORE writing/editing code for a file.
+ */
+export declare function preFlightCheck(memoryStore: MemoryStore, filename?: string, task?: string): PreFlightResult;
+/** Format pre-flight results for AI consumption */
+export declare function formatPreFlight(result: PreFlightResult): string;
+//# sourceMappingURL=pre-flight.d.ts.map

package/dist/memory/pre-flight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-flight.d.ts","sourceRoot":"","sources":["../../src/memory/pre-flight.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,WAAW,EAAE,WAAW,EACxB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACd,eAAe,CA4EjB;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA8C/D"}

package/dist/memory/pre-flight.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preFlightCheck = preFlightCheck;
+exports.formatPreFlight = formatPreFlight;
+/**
+ * Get everything the AI needs to know BEFORE writing/editing code for a file.
+ */
+function preFlightCheck(memoryStore, filename, task) {
+    const result = {
+        conventions: [],
+        gotchas: [],
+        pastBugs: [],
+        fileNotes: [],
+        recentCorrections: [],
+    };
+    // 1. Get ALL conventions (these apply everywhere)
+    const conventions = memoryStore.getByType('CONVENTION', 50);
+    for (const conv of conventions) {
+        // Filter by relevance to file type if filename provided
+        if (filename) {
+            const ext = filename.split('.').pop()?.toLowerCase() || '';
+            const intentLower = conv.intent.toLowerCase();
+            const fileTypeKeywords = {
+                ts: ['typescript', 'type', 'interface', 'const', 'let', 'var', 'import', 'export'],
+                tsx: ['react', 'component', 'hook', 'jsx', 'state', 'prop'],
+                css: ['style', 'css', 'class', 'color', 'font'],
+                py: ['python', 'def', 'class', 'import'],
+                js: ['javascript', 'require', 'module', 'function'],
+            };
+            const keywords = fileTypeKeywords[ext] || [];
+            const isRelevant = keywords.length === 0 || keywords.some(k => intentLower.includes(k))
+                || !Object.values(fileTypeKeywords).flat().some(k => intentLower.includes(k)); // Generic convention
+            if (!isRelevant)
+                continue;
+        }
+        result.conventions.push(`[${conv.id.slice(0, 8)}] ${conv.intent}`);
+    }
+    // 2. Get GOTCHA memories (dangerous patterns)
+    const gotchas = memoryStore.getByType('GOTCHA', 20);
+    for (const g of gotchas) {
+        result.gotchas.push(`⚠️ [${g.id.slice(0, 8)}] ${g.intent}`);
+    }
+    // 3. Get past BUG_FIX patterns for this file
+    const bugFixes = memoryStore.getByType('BUG_FIX', 30);
+    for (const bug of bugFixes) {
+        if (filename && bug.relatedFiles?.some(f => f.includes(filename.split(/[\\/]/).pop() || ''))) {
+            result.pastBugs.push(`🐛 [${bug.id.slice(0, 8)}] ${bug.intent}`);
+        }
+    }
+    // 4. File-specific memories
+    if (filename) {
+        const fileMemories = memoryStore.getByFile(filename, 10);
+        for (const fm of fileMemories) {
+            result.fileNotes.push(`📄 [${fm.type}] ${fm.intent}`);
+        }
+    }
+    // 5. Recent CORRECTIONS (last 20 — most likely to be repeated)
+    const corrections = memoryStore.getByType('CORRECTION', 20);
+    for (const corr of corrections) {
+        // Only include recent ones (last 7 days)
+        if (Date.now() - corr.timestamp < 7 * 24 * 60 * 60 * 1000) {
+            result.recentCorrections.push(`🔄 [${corr.id.slice(0, 8)}] ${corr.intent}`);
+        }
+    }
+    // Task-specific memories via FTS search
+    if (task) {
+        try {
+            const taskResults = memoryStore.searchFTS(task, 5);
+            for (const r of taskResults) {
+                const m = r.memory;
+                if (m.type === 'FAILED_ATTEMPT') {
+                    result.gotchas.push(`❌ [FAILED] ${m.intent}`);
+                }
+            }
+        }
+        catch { /* FTS failure is non-fatal */ }
+    }
+    return result;
+}
+/** Format pre-flight results for AI consumption */
+function formatPreFlight(result) {
+    const sections = ['# ✈️ Pre-Flight Check\n'];
+    let hasContent = false;
+    if (result.recentCorrections.length > 0) {
+        sections.push('## 🔴 Recent Corrections (DON\'T repeat these)\n');
+        result.recentCorrections.forEach(c => sections.push(c));
+        sections.push('');
+        hasContent = true;
+    }
+    if (result.gotchas.length > 0) {
+        sections.push('## ⚠️ Gotchas & Failed Attempts\n');
+        result.gotchas.forEach(g => sections.push(g));
+        sections.push('');
+        hasContent = true;
+    }
+    if (result.pastBugs.length > 0) {
+        sections.push('## 🐛 Past Bugs in This File\n');
+        result.pastBugs.forEach(b => sections.push(b));
+        sections.push('');
+        hasContent = true;
+    }
+    if (result.fileNotes.length > 0) {
+        sections.push('## 📄 File Context\n');
+        result.fileNotes.forEach(f => sections.push(f));
+        sections.push('');
+        hasContent = true;
+    }
+    if (result.conventions.length > 0) {
+        sections.push(`## 📏 Conventions (${result.conventions.length})\n`);
+        result.conventions.slice(0, 10).forEach(c => sections.push(c));
+        if (result.conventions.length > 10) {
+            sections.push(`_...and ${result.conventions.length - 10} more_`);
+        }
+        hasContent = true;
+    }
+    if (!hasContent) {
+        return '# ✈️ Pre-Flight Check\n\n✅ No conventions, gotchas, or past bugs found. Clear for takeoff.';
+    }
+    return sections.join('\n');
+}
+//# sourceMappingURL=pre-flight.js.map

package/dist/memory/pre-flight.js.map

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

package/dist/memory/preference-learner.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Preference Learner — Learns how the user likes to work.
+ *
+ * Detects communication and coding preferences from user messages:
+ * - Verbose vs concise responses
+ * - Asks before changing vs just do it
+ * - Wants explanations vs just code
+ * - Framework/library preferences
+ *
+ * Stores as PREFERENCE memories for AI to adapt to.
+ */
+import { MemoryStore } from '../db/memory-store';
+export interface DetectedPreference {
+    category: 'communication' | 'coding' | 'workflow' | 'style';
+    preference: string;
+    confidence: number;
+    evidence: string;
+}
+/**
+ * Detect user preferences from their message text.
+ * Call this from auto_learn when context is provided.
+ */
+export declare function detectPreferences(userText: string): DetectedPreference[];
+/**
+ * Get all stored preferences for injection into force_recall.
+ */
+export declare function getStoredPreferences(memoryStore: MemoryStore): string;
+//# sourceMappingURL=preference-learner.d.ts.map

package/dist/memory/preference-learner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-learner.d.ts","sourceRoot":"","sources":["../../src/memory/preference-learner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAyGD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAwBxE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAkBrE"}