engram-core 0.19.0

AI Memory Infrastructure - Persistent memory for AI agents with semantic search
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139

//! Intelligence module for AI-powered features (Phase 4, 8, 9)
//!
//! Provides:
//! - Smart memory suggestions (RML-890)
//! - Automatic memory consolidation (RML-891)
//! - Memory quality scoring (RML-892)
//! - Natural language commands (RML-893)
//! - Auto-capture mode for proactive memory (RML-903)
//! - Project context discovery (AI instruction files)
//! - Entity extraction / NER (RML-925)
//! - Document ingestion (RML-928)
//! - Session transcript indexing with dual-limiter chunking
//! - AI auto-tagging for memories
//! - Context compression and token counting (ENG-34)
//! - Salience scoring and temporal decay (Phase 8 - ENG-66 to ENG-68)
//! - Session context tracking (Phase 8 - ENG-70, ENG-71)
//! - Context quality and deduplication (Phase 9 - ENG-48 to ENG-66)
//! - Semantic structured compression (RML-1208)
//! - Emotional analysis and reflective memory (RML-1215)
//! - Autonomous memory garden maintenance (RML-1222)

pub mod agent_loop;
pub mod auto_capture;
pub mod auto_tagging;
pub mod compression;
pub mod compression_semantic;
pub mod consolidation;
pub mod consolidation_offline;
pub mod content_utils;
pub mod context_builder;
pub mod context_compression;
pub mod context_quality;
pub mod document_ingest;
pub mod emotional;
pub mod entities;
pub mod entity_extraction;
pub mod fact_extraction;
pub mod gardening;
pub mod memory_update;
pub mod natural_language;
pub mod proactive;
pub mod project_context;
pub mod quality;
pub mod salience;
pub mod session_context;
pub mod session_indexing;
pub mod suggestions;
pub mod synthesis;

pub use auto_capture::{
    AutoCaptureConfig, AutoCaptureEngine, CaptureCandidate, CaptureType, ConversationTracker,
};
pub use auto_tagging::{AutoTagConfig, AutoTagResult, AutoTagger, TagSource, TagSuggestion};
pub use consolidation::{ConsolidationEngine, ConsolidationResult, ConsolidationStrategy};
pub use content_utils::{
    compact_preview, content_stats, soft_trim, CompactMemory, ContentStats, SoftTrimConfig,
    SoftTrimResult,
};
pub use document_ingest::{
    DocumentChunk, DocumentFormat, DocumentIngestor, DocumentSection, IngestConfig, IngestResult,
    DEFAULT_CHUNK_SIZE, DEFAULT_MAX_FILE_SIZE, DEFAULT_OVERLAP,
};
pub use entities::{
    Entity, EntityExtractionConfig, EntityExtractor, EntityRelation, EntityType, ExtractedEntity,
    ExtractionResult, MemoryEntity,
};
pub use entity_extraction::{
    auto_link_memory, extract_entities, ExtractedEntity as NerExtractedEntity, ExtractedEntityType,
    ExtractionConfig, ExtractionResult as NerExtractionResult,
};
pub use natural_language::{CommandType, NaturalLanguageParser, ParsedCommand};
pub use project_context::{
    DiscoveredFile, InstructionFileParser, InstructionFileType, ParsedInstructions, ParsedSection,
    ProjectContextConfig, ProjectContextEngine, ScanResult, CORE_INSTRUCTION_FILES,
};
pub use quality::{QualityMetrics, QualityScore, QualityScorer};
pub use salience::{
    boost_memory_salience, demote_memory_salience, get_memory_salience,
    get_memory_salience_with_feedback, get_salience_history, get_salience_stats,
    get_salience_stats_in_workspace, run_salience_decay, run_salience_decay_in_workspace,
    set_memory_importance, DecayResult, SalienceCalculator, SalienceConfig, SalienceHistoryEntry,
    SaliencePercentiles, SalienceScore, SalienceStats, ScoredMemory, StateDistribution,
};
pub use session_context::{
    add_memory_to_session, create_session, end_session, export_session, get_session_context,
    get_session_memories, get_sessions_for_memory, list_sessions_extended,
    remove_memory_from_session, search_session_memories, update_session_context,
    update_session_summary, ContextRole, CreateSessionInput, SessionContext, SessionExport,
    SessionMemoryLink, SessionSearchResult,
};
pub use session_indexing::{
    chunk_conversation, delete_session, get_session, index_conversation, index_conversation_delta,
    list_sessions, ChunkingConfig, ConversationChunk, Message, Session,
};
pub use suggestions::{Suggestion, SuggestionEngine, SuggestionType};

// Phase 2: Context Compression Engine (ENG-34)
pub use compression::{
    check_context_budget, count_tokens, detect_encoding, parse_encoding, CompressionStrategy,
    ContextBudgetInput, ContextBudgetResult, MemoryTokenCount, TokenEncoding,
};

// RML-1232: Automatic fact extraction (SPO triples)
pub use fact_extraction::{
    create_fact, delete_facts_for_memory, get_fact_graph, list_facts, ConversationProcessor,
    ExtractedFact, Fact, FactExtractor, RuleBasedExtractor, CREATE_FACTS_TABLE,
};

// Phase 9: Context Quality (ENG-48 to ENG-66)
pub use context_quality::{
    calculate_quality_score, calculate_text_similarity, detect_conflicts, find_near_duplicates,
    find_semantic_duplicates, generate_quality_report, get_pending_duplicates, get_source_trust,
    get_unresolved_conflicts, resolve_conflict, update_source_trust, ConflictSeverity,
    ConflictType, ContextQualityConfig, DuplicateCandidate, EnhancedQualityScore, MemoryConflict,
    QualityIssue, QualityReport, QualitySuggestion, ResolutionType, SourceTrustScore,
    ValidationStatus,
};

// RML-1208: Semantic Structured Compression
pub use compression_semantic::{CompressedMemory, CompressionConfig, SemanticCompressor};

// RML-1213: Historical Memory Update Detection
pub use memory_update::{
    apply_update, create_update_log, list_update_logs, ConflictType as UpdateConflictType,
    UpdateAction, UpdateCandidate, UpdateDetector, UpdateLogEntry, UpdateResult,
    CREATE_UPDATE_LOG_TABLE,
};

// RML-1215: Emotional & Reflective Memory
pub use emotional::{
    list_reflections, save_reflection, sentiment_timeline, Reflection, ReflectionDepth,
    ReflectionEngine, Sentiment, SentimentAnalyzer, SentimentLabel, SentimentPoint,
    CREATE_REFLECTIONS_TABLE,
};

// RML-1222: Autonomous Memory Garden Maintenance
pub use gardening::{
    GardenAction, GardenConfig, GardenReport, MemoryGardener, CREATE_GARDEN_LOG_TABLE,
};