@mxf-dev/core 1.0.0

package/dist/services/McpToolDocumentationService.js

@@ -0,0 +1,202 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * MCP Tool Documentation Service
+ *
+ * Provides comprehensive documentation, examples, and validation helpers
+ * for MCP tools to improve agent tool calling accuracy.
+ */
+import { Logger } from '../utils/Logger.js';
+import { generateToolDocumentation } from '../protocols/mcp/McpToolSchema.js';
+import { generateToolCallExamples } from '../protocols/mcp/McpToolCallParser.js';
+const logger = new Logger('info', 'McpToolDocumentationService', 'server');
+export class McpToolDocumentationService {
+    static instance;
+    toolCache = new Map();
+    constructor() { }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!McpToolDocumentationService.instance) {
+            McpToolDocumentationService.instance = new McpToolDocumentationService();
+        }
+        return McpToolDocumentationService.instance;
+    }
+    /**
+     * Register a tool for documentation
+     */
+    registerTool(tool) {
+        this.toolCache.set(tool.name, tool);
+    }
+    /**
+     * Get comprehensive help for a specific tool
+     */
+    getToolHelp(toolName) {
+        const tool = this.toolCache.get(toolName);
+        if (!tool) {
+            return `Tool "${toolName}" not found. Use listTools() to see available tools.`;
+        }
+        const lines = [];
+        // Basic documentation
+        lines.push(generateToolDocumentation(tool));
+        lines.push('');
+        // Call format examples
+        lines.push('### How to Call This Tool:');
+        lines.push('');
+        const examples = generateToolCallExamples(tool.name, tool.inputSchema);
+        examples.forEach((example, index) => {
+            lines.push(`#### Format ${index + 1}:`);
+            lines.push('```');
+            lines.push(example);
+            lines.push('```');
+            lines.push('');
+        });
+        // Common mistakes
+        lines.push('### Common Mistakes to Avoid:');
+        lines.push('');
+        lines.push(this.getCommonMistakes(tool));
+        return lines.join('\n');
+    }
+    /**
+     * Get quick reference for all tools
+     */
+    getQuickReference() {
+        const lines = [
+            '# MCP Tools Quick Reference',
+            '',
+            'Format your tool calls using one of these patterns:',
+            '- XML: `<tool>tool_name</tool><parameters>{...}</parameters>`',
+            '- Function: `tool_name({...})`',
+            '- Structured: `TOOL: tool_name PARAMETERS: {...}`',
+            '',
+            '## Available Tools:',
+            ''
+        ];
+        // Group tools by category
+        const categories = new Map();
+        for (const tool of this.toolCache.values()) {
+            const category = tool.metadata?.category || 'general';
+            if (!categories.has(category)) {
+                categories.set(category, []);
+            }
+            categories.get(category).push(tool);
+        }
+        // Display by category
+        for (const [category, tools] of categories) {
+            lines.push(`### ${category.charAt(0).toUpperCase() + category.slice(1)}`);
+            lines.push('');
+            for (const tool of tools) {
+                const required = tool.inputSchema.required || [];
+                lines.push(`- **${tool.name}**: ${tool.description}`);
+                lines.push(`  - Required: ${required.length > 0 ? required.join(', ') : 'none'}`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get validation tips for better tool calling
+     */
+    getValidationTips() {
+        return [
+            'Always provide all required parameters',
+            'Check parameter types match the schema (string, number, boolean, etc.)',
+            'Use proper JSON formatting for parameters',
+            'Don\'t include extra properties not defined in the schema',
+            'For file paths, use absolute paths starting with /',
+            'For enum parameters, use exact values from the allowed list',
+            'Check minimum/maximum constraints for numbers',
+            'Verify string patterns match required formats'
+        ];
+    }
+    /**
+     * Generate common mistakes for a specific tool
+     */
+    getCommonMistakes(tool) {
+        const mistakes = [];
+        const schema = tool.inputSchema;
+        if (schema.required && schema.required.length > 0) {
+            mistakes.push(`- Forgetting required parameters: ${schema.required.join(', ')}`);
+        }
+        if (schema.properties) {
+            for (const [key, prop] of Object.entries(schema.properties)) {
+                if (prop.type === 'string' && prop.minLength) {
+                    mistakes.push(`- Providing empty string for "${key}" (minimum length: ${prop.minLength})`);
+                }
+                if (prop.enum) {
+                    mistakes.push(`- Using invalid value for "${key}" (must be one of: ${prop.enum.join(', ')})`);
+                }
+                if (prop.pattern) {
+                    mistakes.push(`- "${key}" must match pattern: ${prop.pattern}`);
+                }
+            }
+        }
+        if (schema.additionalProperties === false) {
+            mistakes.push('- Including properties not defined in the schema');
+        }
+        mistakes.push('- Using wrong parameter types (e.g., string instead of number)');
+        mistakes.push('- Malformed JSON in parameters');
+        return mistakes.join('\n');
+    }
+    /**
+     * Get suggested fix for a validation error
+     */
+    getSuggestedFix(toolName, error, providedInput) {
+        const tool = this.toolCache.get(toolName);
+        if (!tool) {
+            return 'Tool not found';
+        }
+        const suggestions = [];
+        // Analyze error and provide specific suggestions
+        if (error.includes('Missing required parameter')) {
+            const match = error.match(/Missing required parameter: (\w+)/);
+            if (match) {
+                const param = match[1];
+                const prop = tool.inputSchema.properties?.[param];
+                if (prop) {
+                    suggestions.push(`Add "${param}" parameter of type ${prop.type}`);
+                    if (prop.description) {
+                        suggestions.push(`Description: ${prop.description}`);
+                    }
+                    if (prop.example) {
+                        suggestions.push(`Example: "${param}": ${JSON.stringify(prop.example)}`);
+                    }
+                }
+            }
+        }
+        if (error.includes('must be one of')) {
+            const match = error.match(/(\w+) must be one of: (.+)/);
+            if (match) {
+                suggestions.push(`Change "${match[1]}" to one of the allowed values: ${match[2]}`);
+            }
+        }
+        if (error.includes('type')) {
+            suggestions.push('Check that all parameter types match the schema:');
+            if (tool.inputSchema.properties) {
+                for (const [key, prop] of Object.entries(tool.inputSchema.properties)) {
+                    suggestions.push(`- ${key}: ${prop.type}`);
+                }
+            }
+        }
+        return suggestions.join('\n');
+    }
+}
+//# sourceMappingURL=McpToolDocumentationService.js.map

package/dist/services/McpToolDocumentationService.js.map

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

package/dist/services/MemoryCompressor.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+import { MemoryEntry, MemoryStratum, MemoryConsolidation, ConsolidationType } from '../types/MemoryStrataTypes.js';
+/**
+ * Compression level for different stratum transitions
+ */
+export declare enum CompressionLevel {
+    None = "none",// No compression (Working → Working)
+    Light = "light",// 30% compression (Working → ShortTerm)
+    Moderate = "moderate",// 60% compression (ShortTerm → Episodic/LongTerm)
+    Heavy = "heavy"
+}
+/**
+ * Compression result
+ */
+export interface CompressionResult {
+    originalContent: string;
+    compressedContent: string;
+    originalLength: number;
+    compressedLength: number;
+    compressionRatio: number;
+    method: 'semantic' | 'extractive' | 'abstractive';
+}
+/**
+ * Consolidation options
+ */
+export interface ConsolidationOptions {
+    maxMemories?: number;
+    similarityThreshold?: number;
+    compressionLevel?: CompressionLevel;
+    preserveMetadata?: boolean;
+}
+/**
+ * MemoryCompressor handles memory compression and consolidation
+ */
+export declare class MemoryCompressor {
+    private static instance;
+    private logger;
+    private contextCompressor;
+    private enabled;
+    private readonly compressionRatios;
+    private constructor();
+    static getInstance(): MemoryCompressor;
+    /**
+     * Initialize the MemoryCompressor
+     */
+    initialize(config: {
+        enabled: boolean;
+    }): void;
+    /**
+     * Check if compression is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Compress a memory entry for promotion to a slower stratum
+     */
+    compressMemory(memory: MemoryEntry, targetStratum: MemoryStratum): Promise<MemoryEntry>;
+    /**
+     * Consolidate multiple memories into a single memory
+     */
+    consolidateMemories(memories: MemoryEntry[], type: ConsolidationType, options?: ConsolidationOptions): Promise<MemoryConsolidation>;
+    /**
+     * Determine if memories are similar enough to consolidate
+     */
+    areSimilar(memory1: MemoryEntry, memory2: MemoryEntry, threshold?: number): Promise<boolean>;
+    private getCompressionLevel;
+    private compressContent;
+    private semanticCompress;
+    private extractiveCompress;
+    private mergeMemories;
+    private summarizeMemories;
+    private abstractPattern;
+    private calculateSimilarity;
+}
+//# sourceMappingURL=MemoryCompressor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCompressor.d.ts","sourceRoot":"","sources":["../../src/services/MemoryCompressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAaH,OAAO,EACL,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAGvC;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,IAAI,SAAS,CAAY,qCAAqC;IAC9D,KAAK,UAAU,CAAU,wCAAwC;IACjE,QAAQ,aAAa,CAAI,kDAAkD;IAC3E,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,OAAO,CAAkB;IAGjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAKhC;IAEF,OAAO;WAIO,WAAW,IAAI,gBAAgB;IAO7C;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IASrD;;OAEG;IACI,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACU,cAAc,CACzB,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,WAAW,CAAC;IA+BvB;;OAEG;IACU,mBAAmB,CAC9B,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC;IA2D/B;;OAEG;IACU,UAAU,CACrB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,EACpB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,OAAO,CAAC;IAOnB,OAAO,CAAC,mBAAmB;YAiBb,eAAe;YAiCf,gBAAgB;IAmB9B,OAAO,CAAC,kBAAkB;YAqBZ,aAAa;YAOb,iBAAiB;YASjB,eAAe;IAuB7B,OAAO,CAAC,mBAAmB;CAoB5B"}

package/dist/services/MemoryCompressor.js

@@ -0,0 +1,283 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * MemoryCompressor Service
+ *
+ * Handles memory consolidation and compression when promoting memories
+ * between strata. Integrates with ContextCompressionEngine for semantic
+ * compression and summarization.
+ *
+ * Feature flag: MEMORY_STRATA_ENABLED
+ */
+import { Logger } from '../utils/Logger.js';
+import { MemoryStratum } from '../types/MemoryStrataTypes.js';
+import { ContextCompressionEngine } from '../mxp/ContextCompressionEngine.js';
+/**
+ * Compression level for different stratum transitions
+ */
+export var CompressionLevel;
+(function (CompressionLevel) {
+    CompressionLevel["None"] = "none";
+    CompressionLevel["Light"] = "light";
+    CompressionLevel["Moderate"] = "moderate";
+    CompressionLevel["Heavy"] = "heavy"; // 85% compression (Episodic → Semantic)
+})(CompressionLevel || (CompressionLevel = {}));
+/**
+ * MemoryCompressor handles memory compression and consolidation
+ */
+export class MemoryCompressor {
+    static instance;
+    logger;
+    contextCompressor = null;
+    enabled = false;
+    // Compression ratios per level
+    compressionRatios = {
+        [CompressionLevel.None]: 1.0,
+        [CompressionLevel.Light]: 0.7,
+        [CompressionLevel.Moderate]: 0.4,
+        [CompressionLevel.Heavy]: 0.15
+    };
+    constructor() {
+        this.logger = new Logger('info', 'MemoryCompressor');
+    }
+    static getInstance() {
+        if (!MemoryCompressor.instance) {
+            MemoryCompressor.instance = new MemoryCompressor();
+        }
+        return MemoryCompressor.instance;
+    }
+    /**
+     * Initialize the MemoryCompressor
+     */
+    initialize(config) {
+        this.enabled = config.enabled;
+        if (this.enabled) {
+            this.contextCompressor = ContextCompressionEngine.getInstance();
+            this.logger.info('[MemoryCompressor] Initialized with semantic compression support');
+        }
+    }
+    /**
+     * Check if compression is enabled
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Compress a memory entry for promotion to a slower stratum
+     */
+    async compressMemory(memory, targetStratum) {
+        if (!this.enabled)
+            return memory;
+        const compressionLevel = this.getCompressionLevel(memory.stratum, targetStratum);
+        if (compressionLevel === CompressionLevel.None) {
+            return memory;
+        }
+        const result = await this.compressContent(memory.content, compressionLevel);
+        const compressedMemory = {
+            ...memory,
+            content: result.compressedContent,
+            metadata: {
+                ...memory.metadata,
+                originalLength: result.originalLength,
+                compressionRatio: result.compressionRatio,
+                compressionMethod: result.method,
+                compressedAt: new Date().toISOString()
+            }
+        };
+        this.logger.debug(`[MemoryCompressor] Compressed memory ${memory.id} for ${targetStratum} stratum ` +
+            `(${result.originalLength} → ${result.compressedLength} chars, ${(result.compressionRatio * 100).toFixed(1)}%)`);
+        return compressedMemory;
+    }
+    /**
+     * Consolidate multiple memories into a single memory
+     */
+    async consolidateMemories(memories, type, options = {}) {
+        if (!this.enabled || memories.length === 0) {
+            throw new Error('Cannot consolidate: compression disabled or no memories provided');
+        }
+        let consolidatedContent;
+        let reason;
+        switch (type) {
+            case 'merge':
+                consolidatedContent = await this.mergeMemories(memories);
+                reason = `Merged ${memories.length} similar memories`;
+                break;
+            case 'summarize':
+                consolidatedContent = await this.summarizeMemories(memories);
+                reason = `Summarized ${memories.length} memories`;
+                break;
+            case 'abstract':
+                consolidatedContent = await this.abstractPattern(memories);
+                reason = `Abstracted common pattern from ${memories.length} memories`;
+                break;
+            default:
+                throw new Error(`Unsupported consolidation type: ${type}`);
+        }
+        // Create new consolidated memory
+        const baseMemory = memories[0];
+        const newMemory = {
+            ...baseMemory,
+            id: `consolidated-${Date.now()}`,
+            content: consolidatedContent,
+            importance: Math.max(...memories.map(m => m.importance)),
+            tags: Array.from(new Set(memories.flatMap(m => m.tags))),
+            relatedMemories: memories.map(m => m.id),
+            accessCount: memories.reduce((sum, m) => sum + m.accessCount, 0),
+            createdAt: new Date(),
+            lastAccessed: new Date(),
+            metadata: {
+                consolidationType: type,
+                sourceMemoryCount: memories.length,
+                consolidatedAt: new Date().toISOString()
+            }
+        };
+        this.logger.info(`[MemoryCompressor] Consolidated ${memories.length} memories via ${type}: ${newMemory.id}`);
+        return {
+            consolidatedMemories: memories.map(m => m.id),
+            newMemory,
+            type,
+            reason
+        };
+    }
+    /**
+     * Determine if memories are similar enough to consolidate
+     */
+    async areSimilar(memory1, memory2, threshold = 0.7) {
+        const similarity = this.calculateSimilarity(memory1, memory2);
+        return similarity >= threshold;
+    }
+    // Private helper methods
+    getCompressionLevel(fromStratum, toStratum) {
+        // Define compression levels for stratum transitions
+        const transitions = {
+            [`${MemoryStratum.Working}-${MemoryStratum.ShortTerm}`]: CompressionLevel.Light,
+            [`${MemoryStratum.ShortTerm}-${MemoryStratum.Episodic}`]: CompressionLevel.Moderate,
+            [`${MemoryStratum.ShortTerm}-${MemoryStratum.LongTerm}`]: CompressionLevel.Moderate,
+            [`${MemoryStratum.Episodic}-${MemoryStratum.Semantic}`]: CompressionLevel.Heavy,
+            [`${MemoryStratum.LongTerm}-${MemoryStratum.Semantic}`]: CompressionLevel.Heavy
+        };
+        const key = `${fromStratum}-${toStratum}`;
+        return transitions[key] || CompressionLevel.None;
+    }
+    async compressContent(content, level) {
+        const originalLength = content.length;
+        const targetRatio = this.compressionRatios[level];
+        let compressedContent;
+        let method;
+        if (this.contextCompressor && level !== CompressionLevel.Light) {
+            // Use semantic compression for moderate/heavy compression
+            compressedContent = await this.semanticCompress(content, targetRatio);
+            method = 'semantic';
+        }
+        else {
+            // Use extractive compression for light compression
+            compressedContent = this.extractiveCompress(content, targetRatio);
+            method = 'extractive';
+        }
+        const compressedLength = compressedContent.length;
+        const actualRatio = compressedLength / originalLength;
+        return {
+            originalContent: content,
+            compressedContent,
+            originalLength,
+            compressedLength,
+            compressionRatio: actualRatio,
+            method
+        };
+    }
+    async semanticCompress(content, targetRatio) {
+        // Use ContextCompressionEngine for semantic compression
+        const targetLength = Math.ceil(content.length * targetRatio);
+        // Simple summarization approach
+        const words = content.split(/\s+/);
+        const targetWords = Math.ceil(words.length * targetRatio);
+        if (words.length <= targetWords) {
+            return content;
+        }
+        // Extract key sentences (simple extractive approach)
+        const sentences = content.split(/[.!?]+/).filter(s => s.trim());
+        const targetSentences = Math.max(1, Math.ceil(sentences.length * targetRatio));
+        return sentences.slice(0, targetSentences).join('. ') + '.';
+    }
+    extractiveCompress(content, targetRatio) {
+        // Simple extractive compression: keep first N% of content
+        const targetLength = Math.ceil(content.length * targetRatio);
+        if (content.length <= targetLength) {
+            return content;
+        }
+        // Split on sentences and keep complete sentences up to target
+        const sentences = content.split(/[.!?]+/).filter(s => s.trim());
+        let compressed = '';
+        for (const sentence of sentences) {
+            const candidate = compressed + sentence + '. ';
+            if (candidate.length > targetLength)
+                break;
+            compressed = candidate;
+        }
+        return compressed.trim() || content.substring(0, targetLength) + '...';
+    }
+    async mergeMemories(memories) {
+        // Combine content with deduplication
+        const contents = memories.map(m => m.content);
+        const uniqueContents = Array.from(new Set(contents));
+        return uniqueContents.join('\n\n');
+    }
+    async summarizeMemories(memories) {
+        // Create a summary of key points
+        const contents = memories.map(m => m.content).join('\n\n');
+        // Apply moderate compression
+        const result = await this.compressContent(contents, CompressionLevel.Moderate);
+        return result.compressedContent;
+    }
+    async abstractPattern(memories) {
+        // Extract common patterns
+        const allWords = memories.flatMap(m => m.content.toLowerCase().split(/\s+/));
+        // Count word frequencies
+        const wordCounts = new Map();
+        for (const word of allWords) {
+            wordCounts.set(word, (wordCounts.get(word) || 0) + 1);
+        }
+        // Filter common words (stop words)
+        const stopWords = new Set(['the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for']);
+        const keywords = Array.from(wordCounts.entries())
+            .filter(([word, count]) => !stopWords.has(word) && count > 1)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([word]) => word);
+        return `Common pattern detected across ${memories.length} memories. Key concepts: ${keywords.join(', ')}`;
+    }
+    calculateSimilarity(memory1, memory2) {
+        // Calculate Jaccard similarity based on content words
+        const words1 = new Set(memory1.content.toLowerCase().split(/\s+/));
+        const words2 = new Set(memory2.content.toLowerCase().split(/\s+/));
+        const intersection = new Set([...words1].filter(w => words2.has(w)));
+        const union = new Set([...words1, ...words2]);
+        const contentSimilarity = union.size > 0 ? intersection.size / union.size : 0;
+        // Factor in tag similarity
+        const tags1 = new Set(memory1.tags);
+        const tags2 = new Set(memory2.tags);
+        const tagIntersection = new Set([...tags1].filter(t => tags2.has(t)));
+        const tagUnion = new Set([...tags1, ...tags2]);
+        const tagSimilarity = tagUnion.size > 0 ? tagIntersection.size / tagUnion.size : 0;
+        // Weighted combination
+        return contentSimilarity * 0.8 + tagSimilarity * 0.2;
+    }
+}
+//# sourceMappingURL=MemoryCompressor.js.map

package/dist/services/MemoryCompressor.js.map

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