Consolidation

Consolidate similar memories to reduce noise and improve retrieval quality.

consolidateMemories

Over time, agents accumulate similar memories. Consolidation merges related entries:

import { consolidateMemories } from '@ahzan-agentforge/core';

await consolidateMemories(store, {
  namespace: 'customer_123',
  similarityThreshold: 0.9,
});

How It Works

Scans all memories in a namespace
Groups memories with similarity above the threshold
Merges groups into single consolidated entries
Removes the original duplicates

When to Consolidate

After batch processing many similar inputs
On a scheduled basis (e.g., nightly)
When retrieval quality degrades due to noise

Next Steps

Cleanup — scheduled memory cleanup
Types — memory type reference

Retrieval

Query and retrieve memories — search, filtering, and namespace resolution.

Cleanup

Manage memory lifecycle with MemoryCleanupManager — TTL, limits, and scheduled cleanup.

On this page

consolidateMemories How It Works When to Consolidate Next Steps