Memory ArchitectureOperations
Configuration
Constants, thresholds, and configuration values for the memory system
Reference of all configurable values in the memory system.
Similarity Thresholds
| Constant | Value | Location | Purpose |
|---|---|---|---|
DEDUP_SIMILARITY_THRESHOLD | 0.92 | memory.service.ts | Cosine similarity above which memories are considered duplicates |
| Consolidation similarity | 0.80 | memory.service.ts | Minimum similarity for clustering related memories |
| Min cluster size | 3 | memory.service.ts | Minimum memories in a cluster to trigger consolidation |
| Consolidation threshold | 20 | memory-cron.service.ts | Minimum active memories before consolidation runs |
Embedding Configuration
| Setting | Value | Notes |
|---|---|---|
| Model | text-embedding-3-small | OpenAI embedding model |
| Dimensions | 1536 | Vector column size |
| Index type | HNSW | Approximate nearest neighbor |
| Distance function | Cosine (<=>) | pgvector operator |
Token Budgets
Used by pipeline/context-assembly:
| Layer | Budget | Description |
|---|---|---|
| Total | 16,000 | Maximum context size |
| L1 (Identity + Instructions) | Unlimited | Never truncated |
| L3 (Daily files) | 3,000 | Last 7 days of activity |
| L4 (Team memories) | 2,000 | Top 5 by relevance |
| L5 (Agent memories) | 2,000 | Top 5 by relevance |
| L7 (Knowledge) | 2,000 | KNOWLEDGE.md content |
Token estimation: Math.ceil(text.length / 4)
Scoring Weights
Used by pipeline/scoring:
| Signal | Weight |
|---|---|
| Cosine similarity | 0.5 |
| Importance | 0.3 |
| Recency decay | 0.2 |
| Decay rate | 0.05 per day |
Cron Schedules
See operations/cron-jobs for details:
| Job | Cron Expression | UTC Time |
|---|---|---|
| Daily transitions | 0 3 * * * | 03:00 daily |
| Stale pruning | 0 4 * * * | 04:00 daily |
| Consolidation | 0 5 * * 0 | 05:00 Sundays |
Memory Types
Agent Memory Types
fact, preference, skill, insight
Team Memory Types
decision, summary, context, knowledge
Extraction Categories
decision, position, task, open_question, learning, preference
Daily File Settings
| Setting | Value |
|---|---|
| Active window | 7 days |
| Warm window | 7–30 days |
| Archive threshold | 30 days |
| Scope types | agent, team |
Default Values
| Field | Default | Table |
|---|---|---|
importance | 0.5 | All memory tables |
status | active | agent_memories, daily_memory_files |
source_type | arena | agent_memories, team_memories |
Related Pages
- pipeline/scoring — How these values affect retrieval
- pipeline/lifecycle — Status transitions and timing
- operations/cron-jobs — Scheduled maintenance using these thresholds