MEMORY
State and context management failures.
The MEMORY module covers errors in how agents store, retrieve, and manage information across interactions. This includes persistent state, retrieval-augmented generation, and context window management.
Categories
STATE
State management failures.
| Code | Severity | Description | Remediation |
|---|---|---|---|
MEMORY.STATE.CORRUPTED | 5 | State corruption detected | Implement state checksums |
MEMORY.STATE.INCONSISTENT | 4 | Inconsistent state across components | Use transactional state updates |
MEMORY.STATE.LOST | 5 | State was lost | Implement state persistence |
MEMORY.STATE.STALE | 3 | State is outdated | Implement state freshness checks |
MEMORY.STATE.OVERFLOW | 3 | State size exceeded limits | Implement state pruning |
Danger
MEMORY.STATE.CORRUPTED and MEMORY.STATE.LOST are both severity 5 because state loss or corruption can lead to cascading failures across the entire agent workflow.
RETRIEVAL
Memory retrieval failures.
| Code | Severity | Description | Remediation |
|---|---|---|---|
MEMORY.RETRIEVAL.NOT_FOUND | 3 | Requested memory not found | Handle missing memories gracefully |
MEMORY.RETRIEVAL.WRONG_MATCH | 4 | Retrieved wrong memory | Improve retrieval precision |
MEMORY.RETRIEVAL.OUTDATED | 3 | Retrieved outdated memory | Implement memory freshness |
MEMORY.RETRIEVAL.INCOMPLETE | 2 | Retrieved incomplete memory | Store complete memory records |
MEMORY.RETRIEVAL.TOO_MANY | 2 | Too many memories retrieved | Implement result ranking and filtering |
CONTEXT_WINDOW
Context window management failures.
| Code | Severity | Description | Remediation |
|---|---|---|---|
MEMORY.CONTEXT_WINDOW.EXCEEDED | 3 | Context window exceeded | Implement context summarization |
MEMORY.CONTEXT_WINDOW.FRAGMENTED | 2 | Context is fragmented | Implement context consolidation |
MEMORY.CONTEXT_WINDOW.PRIORITY_ERROR | 3 | Wrong context priority | Improve context prioritization |
MEMORY.CONTEXT_WINDOW.DROPPED | 3 | Important context was dropped | Implement context importance scoring |
Note
The CONTEXT_WINDOW category has 4 codes (not 5) because context window issues are a subset of broader memory management. The MEMORY module totals 14 codes across its 3 categories.
Example Diagnosis
{
"error_code": "MEMORY.RETRIEVAL.WRONG_MATCH",
"confidence": 0.78,
"root_cause": "Vector similarity search returned a semantically similar but factually different document, causing the agent to use incorrect context.",
"suggested_fixes": ["parameter", "prompt"]
}