Skip to main content

Module consolidation

Module consolidation 

Source
Expand description

Memory consolidation service.

Manages memory lifecycle, clustering, and archival.

ยงCircuit Breaker Pattern

LLM calls in consolidation should be wrapped with ResilientLlmProvider for:

  • Automatic retries: Transient failures (timeouts, 5xx errors) retry with exponential backoff
  • Circuit breaker: Opens after consecutive failures to prevent cascading failures
  • Error budget: Tracks error rate and latency SLO violations

See with_llm for usage examples.

Structsยง

ConsolidationService
Service for consolidating and managing memory lifecycle.
ConsolidationStats
Statistics from a consolidation operation.

Constantsยง

ACCESS_CACHE_CAPACITY ๐Ÿ”’
Maximum entries in access tracking caches (HIGH-PERF-001). Using NonZeroUsize directly to avoid runtime expect() calls.
CONTRADICTION_THRESHOLD ๐Ÿ”’
Minimum memories in namespace before flagging contradictions.
DEFAULT_IMPORTANCE ๐Ÿ”’
Default importance score when LLM analysis unavailable.
RECENCY_DECAY_DAYS ๐Ÿ”’
Half-life in days for recency decay.
SECONDS_PER_DAY ๐Ÿ”’
Seconds per day for age calculation.

Functionsยง

cosine_similarity ๐Ÿ”’
Calculates cosine similarity between two embedding vectors.