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ยง
- Consolidation
Service - Service for consolidating and managing memory lifecycle.
- Consolidation
Stats - Statistics from a consolidation operation.
Constantsยง
- ACCESS_
CACHE_ ๐CAPACITY - Maximum entries in access tracking caches (HIGH-PERF-001).
Using
NonZeroUsizedirectly to avoid runtimeexpect()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.