@agent-relay/memory 0.1.0

package/dist/context-compaction.js

@@ -0,0 +1,453 @@
+/**
+ * Context Compaction for Long Agent Sessions
+ *
+ * Manages conversation context to prevent token limit exhaustion.
+ * Provides token counting, message summarization, and context pruning.
+ *
+ * Inspired by russian-code-ts context management targets:
+ * - Token estimation: <20ms
+ * - Embeddings-based semantic search for relevant context
+ *
+ * Strategies:
+ * 1. Fast token estimation (character-based heuristic)
+ * 2. Importance-weighted message retention
+ * 3. Sliding window with summary injection
+ * 4. Semantic deduplication of similar messages
+ */
+// =============================================================================
+// Default Configuration
+// =============================================================================
+const DEFAULT_CONFIG = {
+    maxTokens: 100000, // 100k tokens (Claude's typical limit)
+    targetUsage: 0.7, // Target 70% after compaction
+    compactionThreshold: 0.85, // Trigger at 85% usage
+    minImportanceRetain: 30, // Keep messages with importance >= 30
+    keepRecentCount: 10, // Always keep last 10 messages
+    enableSummarization: true,
+    enableDeduplication: true,
+    deduplicationThreshold: 0.85,
+};
+// =============================================================================
+// Token Estimation
+// =============================================================================
+/**
+ * Fast token estimation using character-based heuristic.
+ * Targets <20ms latency for large texts.
+ *
+ * Heuristic: ~4 characters per token for English text.
+ * Adjusts for code (more tokens per char) and whitespace.
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    const length = text.length;
+    // Fast path for short texts
+    if (length < 100) {
+        return Math.ceil(length / 3.5);
+    }
+    // Sample-based estimation for longer texts
+    // Count different character types in sample
+    const sampleSize = Math.min(1000, length);
+    const sample = text.substring(0, sampleSize);
+    let codeChars = 0;
+    let whitespaceChars = 0;
+    let _punctuationChars = 0;
+    for (let i = 0; i < sample.length; i++) {
+        const char = sample[i];
+        if (/\s/.test(char)) {
+            whitespaceChars++;
+        }
+        else if (/[{}[\]();:,.<>!=+\-*/&|^~`@#$%]/.test(char)) {
+            _punctuationChars++;
+            codeChars++;
+        }
+    }
+    const codeRatio = codeChars / sampleSize;
+    const whitespaceRatio = whitespaceChars / sampleSize;
+    // Adjust chars per token based on content type
+    // Heuristics based on tokenization patterns:
+    // - Base prose: ~4 chars/token (average English text)
+    // - Code: ~3 chars/token (more tokens due to symbols/structure)
+    // - High whitespace: ~3.5 chars/token (more word boundaries = more tokens)
+    const baseCharsPerToken = 4;
+    const codeAdjustment = codeRatio * 1.5; // Code reduces chars/token (more tokens)
+    const whitespaceAdjustment = whitespaceRatio * 0.5; // Whitespace reduces chars/token (more word boundaries)
+    const charsPerToken = baseCharsPerToken - codeAdjustment - whitespaceAdjustment;
+    const adjustedCharsPerToken = Math.max(2.5, Math.min(5, charsPerToken));
+    return Math.ceil(length / adjustedCharsPerToken);
+}
+/**
+ * Estimate tokens for a message (uses caching).
+ */
+export function estimateMessageTokens(message) {
+    if (message.tokenCount !== undefined) {
+        return message.tokenCount;
+    }
+    // Role overhead: ~4 tokens for role markers
+    const roleOverhead = 4;
+    const contentTokens = estimateTokens(message.content);
+    message.tokenCount = roleOverhead + contentTokens;
+    return message.tokenCount;
+}
+/**
+ * Estimate tokens for entire context.
+ */
+export function estimateContextTokens(messages) {
+    let total = 0;
+    for (const msg of messages) {
+        total += estimateMessageTokens(msg);
+    }
+    // Add overhead for message separators (~2 tokens per message)
+    total += messages.length * 2;
+    return total;
+}
+// =============================================================================
+// Importance Scoring
+// =============================================================================
+/**
+ * Calculate importance score for a message.
+ * Higher scores = more important to retain.
+ */
+export function calculateImportance(message, index, total) {
+    let score = 50; // Base score
+    // Recency bonus (0-20 points)
+    const recencyRatio = index / total;
+    score += recencyRatio * 20;
+    // System messages are important
+    if (message.role === 'system') {
+        score += 30;
+    }
+    // Check for important content patterns
+    const content = message.content.toLowerCase();
+    // Task-related keywords
+    if (/\b(todo|task|implement|fix|bug|error|important|critical|urgent)\b/.test(content)) {
+        score += 15;
+    }
+    // Code blocks are often important context
+    if (/```[\s\S]*```/.test(message.content)) {
+        score += 10;
+    }
+    // Questions that might need answers retained
+    if (/\?/.test(content) && message.role === 'user') {
+        score += 10;
+    }
+    // Acknowledgments and status updates can be lower priority
+    if (/^(ok|ack|got it|understood|done|completed)/i.test(content)) {
+        score -= 20;
+    }
+    // Very short messages are usually less important
+    if (message.content.length < 50) {
+        score -= 10;
+    }
+    // Summaries should be kept
+    if (message.isSummary) {
+        score += 25;
+    }
+    // User-specified importance overrides
+    if (message.importance !== undefined) {
+        score = (score + message.importance) / 2;
+    }
+    return Math.max(0, Math.min(100, score));
+}
+// =============================================================================
+// Similarity Detection
+// =============================================================================
+/**
+ * Simple similarity score between two strings (Jaccard on word set).
+ * Returns 0-1 where 1 = identical.
+ */
+export function calculateSimilarity(a, b) {
+    const wordsA = new Set(a.toLowerCase().split(/\s+/).filter(w => w.length > 2));
+    const wordsB = new Set(b.toLowerCase().split(/\s+/).filter(w => w.length > 2));
+    if (wordsA.size === 0 || wordsB.size === 0) {
+        return 0;
+    }
+    let intersection = 0;
+    for (const word of wordsA) {
+        if (wordsB.has(word)) {
+            intersection++;
+        }
+    }
+    const union = wordsA.size + wordsB.size - intersection;
+    return intersection / union;
+}
+/**
+ * Find duplicate/similar messages.
+ */
+export function findDuplicates(messages, threshold = 0.85) {
+    const duplicates = new Map();
+    for (let i = 0; i < messages.length; i++) {
+        for (let j = i + 1; j < messages.length; j++) {
+            const similarity = calculateSimilarity(messages[i].content, messages[j].content);
+            if (similarity >= threshold) {
+                const key = messages[i].id;
+                const existing = duplicates.get(key) ?? [];
+                existing.push(messages[j].id);
+                duplicates.set(key, existing);
+            }
+        }
+    }
+    return duplicates;
+}
+// =============================================================================
+// Summarization
+// =============================================================================
+/**
+ * Create a summary of multiple messages.
+ * This is a simple extractive summary - in production, use an LLM.
+ */
+export function createSummary(messages) {
+    const messageCount = messages.length;
+    const roles = new Set(messages.map(m => m.role));
+    const threads = new Set(messages.filter(m => m.thread).map(m => m.thread));
+    // Extract key sentences (first sentence of each message, or first 100 chars)
+    const keyPoints = [];
+    for (const msg of messages.slice(0, 5)) { // Take up to 5 key points
+        const firstSentence = msg.content.split(/[.!?]\s/)[0];
+        if (firstSentence && firstSentence.length < 200) {
+            keyPoints.push(`- ${firstSentence}`);
+        }
+    }
+    const content = [
+        `[Summary of ${messageCount} messages]`,
+        `Participants: ${Array.from(roles).join(', ')}`,
+        threads.size > 0 ? `Threads: ${Array.from(threads).join(', ')}` : '',
+        'Key points:',
+        ...keyPoints,
+        `[End summary]`,
+    ].filter(Boolean).join('\n');
+    return {
+        id: `summary_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`,
+        role: 'system',
+        content,
+        timestamp: Date.now(),
+        importance: 70,
+        isSummary: true,
+        summarizes: messages.map(m => m.id),
+    };
+}
+// =============================================================================
+// Context Compaction
+// =============================================================================
+/**
+ * Context compaction manager.
+ */
+export class ContextCompactor {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Get current context window status.
+     */
+    getContextWindow(messages) {
+        const totalTokens = estimateContextTokens(messages);
+        return {
+            messages,
+            totalTokens,
+            maxTokens: this.config.maxTokens,
+            usagePercent: totalTokens / this.config.maxTokens,
+        };
+    }
+    /**
+     * Check if compaction is needed.
+     */
+    needsCompaction(messages) {
+        const window = this.getContextWindow(messages);
+        return window.usagePercent >= this.config.compactionThreshold;
+    }
+    /**
+     * Perform context compaction.
+     */
+    compact(messages) {
+        const window = this.getContextWindow(messages);
+        // No compaction needed
+        if (window.usagePercent < this.config.compactionThreshold) {
+            return {
+                messages,
+                messagesRemoved: 0,
+                tokensSaved: 0,
+                strategy: 'none',
+            };
+        }
+        const targetTokens = Math.floor(this.config.maxTokens * this.config.targetUsage);
+        let result = [...messages];
+        let strategy = 'none';
+        const originalTokens = window.totalTokens;
+        // Calculate importance for all messages
+        const importanceMap = new Map();
+        for (let i = 0; i < result.length; i++) {
+            importanceMap.set(result[i].id, calculateImportance(result[i], i, result.length));
+        }
+        // Strategy 1: Deduplicate similar messages
+        if (this.config.enableDeduplication) {
+            const duplicates = findDuplicates(result, this.config.deduplicationThreshold);
+            if (duplicates.size > 0) {
+                const toRemove = new Set();
+                for (const [, dups] of duplicates) {
+                    for (const id of dups) {
+                        toRemove.add(id);
+                    }
+                }
+                result = result.filter(m => !toRemove.has(m.id));
+                if (toRemove.size > 0) {
+                    strategy = 'deduplicate';
+                }
+            }
+        }
+        // Check if we've met target
+        if (estimateContextTokens(result) <= targetTokens) {
+            return {
+                messages: result,
+                messagesRemoved: messages.length - result.length,
+                tokensSaved: originalTokens - estimateContextTokens(result),
+                strategy,
+            };
+        }
+        // Strategy 2: Remove low-importance messages (keep recent)
+        const recentIds = new Set(result.slice(-this.config.keepRecentCount).map(m => m.id));
+        result = result.filter(m => {
+            if (recentIds.has(m.id))
+                return true;
+            if (m.isSummary)
+                return true;
+            if (m.role === 'system')
+                return true;
+            const importance = importanceMap.get(m.id) ?? 50;
+            return importance >= this.config.minImportanceRetain;
+        });
+        if (result.length < messages.length) {
+            strategy = 'trim_low_importance';
+        }
+        // Check if we've met target
+        if (estimateContextTokens(result) <= targetTokens) {
+            return {
+                messages: result,
+                messagesRemoved: messages.length - result.length,
+                tokensSaved: originalTokens - estimateContextTokens(result),
+                strategy,
+            };
+        }
+        // Strategy 3: Summarize old messages
+        if (this.config.enableSummarization) {
+            const messagesToSummarize = result.slice(0, -this.config.keepRecentCount)
+                .filter(m => !m.isSummary && m.role !== 'system');
+            if (messagesToSummarize.length >= 3) {
+                const summary = createSummary(messagesToSummarize);
+                const summaryIds = new Set(messagesToSummarize.map(m => m.id));
+                result = [
+                    summary,
+                    ...result.filter(m => !summaryIds.has(m.id)),
+                ];
+                strategy = 'summarize';
+                return {
+                    messages: result,
+                    messagesRemoved: messages.length - result.length,
+                    tokensSaved: originalTokens - estimateContextTokens(result),
+                    summaryAdded: summary,
+                    strategy,
+                };
+            }
+        }
+        // Strategy 4: Aggressive trim (last resort)
+        while (estimateContextTokens(result) > targetTokens && result.length > this.config.keepRecentCount + 1) {
+            // Remove oldest non-system, non-summary message
+            const removeIndex = result.findIndex(m => !m.isSummary && m.role !== 'system');
+            if (removeIndex === -1)
+                break;
+            result.splice(removeIndex, 1);
+        }
+        strategy = 'aggressive';
+        return {
+            messages: result,
+            messagesRemoved: messages.length - result.length,
+            tokensSaved: originalTokens - estimateContextTokens(result),
+            strategy,
+        };
+    }
+    /**
+     * Add a message to context with automatic compaction if needed.
+     */
+    addMessage(messages, newMessage) {
+        const updated = [...messages, newMessage];
+        if (this.needsCompaction(updated)) {
+            const result = this.compact(updated);
+            return {
+                messages: result.messages,
+                compacted: true,
+                result,
+            };
+        }
+        return {
+            messages: updated,
+            compacted: false,
+        };
+    }
+    /**
+     * Get token budget remaining.
+     */
+    getTokenBudget(messages) {
+        const used = estimateContextTokens(messages);
+        return {
+            used,
+            remaining: this.config.maxTokens - used,
+            percentUsed: (used / this.config.maxTokens) * 100,
+        };
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create a context compactor with the given configuration.
+ */
+export function createContextCompactor(config) {
+    return new ContextCompactor(config);
+}
+// =============================================================================
+// Utilities
+// =============================================================================
+/**
+ * Format token count for display.
+ */
+export function formatTokenCount(tokens) {
+    if (tokens >= 1000000) {
+        return `${(tokens / 1000000).toFixed(1)}M`;
+    }
+    if (tokens >= 1000) {
+        return `${(tokens / 1000).toFixed(1)}k`;
+    }
+    return tokens.toString();
+}
+/**
+ * Benchmark token estimation performance.
+ */
+export function benchmarkTokenEstimation(iterations = 10000) {
+    const testTexts = [
+        'Hello world',
+        'This is a longer piece of text that contains multiple sentences and should take more time to process.',
+        '```typescript\nfunction hello() {\n  console.log("Hello");\n}\n```',
+        'A'.repeat(10000), // 10k chars
+    ];
+    let maxNs = 0;
+    let totalTokens = 0;
+    const start = process.hrtime.bigint();
+    for (let i = 0; i < iterations; i++) {
+        for (const text of testTexts) {
+            const s = process.hrtime.bigint();
+            const tokens = estimateTokens(text);
+            totalTokens += tokens;
+            const elapsed = Number(process.hrtime.bigint() - s);
+            if (elapsed > maxNs)
+                maxNs = elapsed;
+        }
+    }
+    const totalNs = Number(process.hrtime.bigint() - start);
+    const totalMs = totalNs / 1_000_000;
+    return {
+        avgNs: totalNs / (iterations * testTexts.length),
+        maxNs,
+        tokensPerMs: totalTokens / totalMs,
+    };
+}
+//# sourceMappingURL=context-compaction.js.map

package/dist/context-compaction.js.map

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

package/dist/factory.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Memory Adapter Factory
+ *
+ * Creates memory adapters based on configuration.
+ * Supports environment variables for configuration.
+ */
+import type { MemoryAdapter, MemoryConfig } from './types.js';
+/**
+ * Get memory configuration from environment variables
+ *
+ * Environment variables:
+ * - AGENT_RELAY_MEMORY_TYPE: 'inmemory', 'supermemory', 'claude'
+ * - AGENT_RELAY_MEMORY_API_KEY: API key for external services
+ * - AGENT_RELAY_MEMORY_ENDPOINT: Custom API endpoint
+ * - SUPERMEMORY_API_KEY: Supermemory-specific API key (fallback)
+ */
+export declare function getMemoryConfigFromEnv(): MemoryConfig;
+/**
+ * Create a memory adapter based on configuration
+ *
+ * @param config - Memory configuration (merged with env vars)
+ * @returns Initialized memory adapter
+ *
+ * @example
+ * ```typescript
+ * // Use environment variables
+ * const memory = await createMemoryAdapter();
+ *
+ * // Explicit configuration
+ * const memory = await createMemoryAdapter({
+ *   type: 'supermemory',
+ *   apiKey: 'my-api-key',
+ * });
+ * ```
+ */
+export declare function createMemoryAdapter(config?: Partial<MemoryConfig>): Promise<MemoryAdapter>;
+/**
+ * Check if a memory adapter type is available
+ *
+ * @param type - Adapter type to check
+ * @returns Whether the adapter is available
+ */
+export declare function isMemoryAdapterAvailable(type: string): boolean;
+/**
+ * Get list of available memory adapter types
+ */
+export declare function getAvailableMemoryAdapters(): string[];
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI9D;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAarD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,aAAa,CAAC,CAoExB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAyB9D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAQrD"}

package/dist/factory.js

@@ -0,0 +1,143 @@
+/**
+ * Memory Adapter Factory
+ *
+ * Creates memory adapters based on configuration.
+ * Supports environment variables for configuration.
+ */
+import { InMemoryAdapter } from './adapters/inmemory.js';
+import { SupermemoryAdapter } from './adapters/supermemory.js';
+/**
+ * Get memory configuration from environment variables
+ *
+ * Environment variables:
+ * - AGENT_RELAY_MEMORY_TYPE: 'inmemory', 'supermemory', 'claude'
+ * - AGENT_RELAY_MEMORY_API_KEY: API key for external services
+ * - AGENT_RELAY_MEMORY_ENDPOINT: Custom API endpoint
+ * - SUPERMEMORY_API_KEY: Supermemory-specific API key (fallback)
+ */
+export function getMemoryConfigFromEnv() {
+    const type = process.env.AGENT_RELAY_MEMORY_TYPE ?? 'inmemory';
+    const apiKey = process.env.AGENT_RELAY_MEMORY_API_KEY ??
+        process.env.SUPERMEMORY_API_KEY;
+    return {
+        type,
+        apiKey,
+        endpoint: process.env.AGENT_RELAY_MEMORY_ENDPOINT,
+        defaultAgentId: process.env.AGENT_RELAY_AGENT_ID,
+        defaultProjectId: process.env.AGENT_RELAY_PROJECT_ID,
+    };
+}
+/**
+ * Create a memory adapter based on configuration
+ *
+ * @param config - Memory configuration (merged with env vars)
+ * @returns Initialized memory adapter
+ *
+ * @example
+ * ```typescript
+ * // Use environment variables
+ * const memory = await createMemoryAdapter();
+ *
+ * // Explicit configuration
+ * const memory = await createMemoryAdapter({
+ *   type: 'supermemory',
+ *   apiKey: 'my-api-key',
+ * });
+ * ```
+ */
+export async function createMemoryAdapter(config) {
+    // Merge with environment config
+    const envConfig = getMemoryConfigFromEnv();
+    const finalConfig = {
+        type: config?.type ?? envConfig.type ?? 'inmemory',
+        apiKey: config?.apiKey ?? envConfig.apiKey,
+        endpoint: config?.endpoint ?? envConfig.endpoint,
+        defaultAgentId: config?.defaultAgentId ?? envConfig.defaultAgentId,
+        defaultProjectId: config?.defaultProjectId ?? envConfig.defaultProjectId,
+        options: { ...envConfig.options, ...config?.options },
+    };
+    const adapterType = finalConfig.type.toLowerCase();
+    let adapter;
+    switch (adapterType) {
+        case 'supermemory':
+        case 'supermemory.ai': {
+            if (!finalConfig.apiKey) {
+                throw new Error('Supermemory adapter requires an API key. ' +
+                    'Set AGENT_RELAY_MEMORY_API_KEY or SUPERMEMORY_API_KEY environment variable, ' +
+                    'or provide apiKey in config.');
+            }
+            adapter = new SupermemoryAdapter({
+                apiKey: finalConfig.apiKey,
+                endpoint: finalConfig.endpoint,
+                defaultAgentId: finalConfig.defaultAgentId,
+                defaultProjectId: finalConfig.defaultProjectId,
+                container: finalConfig.options?.container,
+                timeout: finalConfig.options?.timeout,
+            });
+            break;
+        }
+        case 'claude':
+        case 'claude-memory': {
+            // Claude memory is not yet available as a public API
+            // Fall back to in-memory with a warning
+            console.warn('[memory] Claude memory adapter not yet available. ' +
+                'Using in-memory adapter as fallback.');
+            adapter = new InMemoryAdapter({
+                defaultAgentId: finalConfig.defaultAgentId,
+                defaultProjectId: finalConfig.defaultProjectId,
+                maxMemories: finalConfig.options?.maxMemories,
+            });
+            break;
+        }
+        case 'inmemory':
+        case 'memory':
+        case 'none':
+        default: {
+            adapter = new InMemoryAdapter({
+                defaultAgentId: finalConfig.defaultAgentId,
+                defaultProjectId: finalConfig.defaultProjectId,
+                maxMemories: finalConfig.options?.maxMemories,
+            });
+            break;
+        }
+    }
+    await adapter.init();
+    return adapter;
+}
+/**
+ * Check if a memory adapter type is available
+ *
+ * @param type - Adapter type to check
+ * @returns Whether the adapter is available
+ */
+export function isMemoryAdapterAvailable(type) {
+    const adapterType = type.toLowerCase();
+    switch (adapterType) {
+        case 'inmemory':
+        case 'memory':
+        case 'none':
+            return true;
+        case 'supermemory':
+        case 'supermemory.ai':
+            // Available if API key is configured
+            return !!(process.env.AGENT_RELAY_MEMORY_API_KEY ||
+                process.env.SUPERMEMORY_API_KEY);
+        case 'claude':
+        case 'claude-memory':
+            // Not yet available
+            return false;
+        default:
+            return false;
+    }
+}
+/**
+ * Get list of available memory adapter types
+ */
+export function getAvailableMemoryAdapters() {
+    const adapters = ['inmemory'];
+    if (process.env.AGENT_RELAY_MEMORY_API_KEY || process.env.SUPERMEMORY_API_KEY) {
+        adapters.push('supermemory');
+    }
+    return adapters;
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

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