Build AI Agents ThatRemember, Learn & Evolve.

// Enable automatic fact extraction from conversations
var memory = new AgentMemory(embedModel)
{
    ExtractionMode = MemoryExtractionMode.LlmBased,
    ExtractionModel = chatModel,
    MaxExtractionsPerTurn = 5,
    DeduplicationThreshold = 0.85f
};

// Inspect what gets extracted before storage
memory.BeforeMemoryStored += (sender, e) =>
{
    foreach (var m in e.Memories)
        Console.WriteLine($"[{m.MemoryType}] {m.Text}");
};

var chat = new MultiTurnConversation(chatModel) { Memory = memory };

// Every turn, the agent auto-extracts and stores memories
chat.Submit("I'm working on the Acme project. I prefer TypeScript.");
// Extracted: [Semantic] User prefers TypeScript
// Extracted: [Episodic] User is working on the Acme project

using LMKit.Agents.Memory;

// Shared memory store for all users
var sharedMemory = new AgentMemory(embedModel);

// Create user-scoped views - data is fully isolated
var aliceMemory = new UserScopedMemory(sharedMemory, "alice");
var bobMemory = new UserScopedMemory(sharedMemory, "bob");

// Store per-user data
await aliceMemory.SaveInformationAsync("prefs", "Prefers dark mode", "theme");
await bobMemory.SaveInformationAsync("prefs", "Prefers light mode", "theme");

// Apply user scope before conversation - only their data is recalled
aliceMemory.ApplyFilter();
var chat = new MultiTurnConversation(chatModel) { Memory = sharedMemory };

// Persist all users in a single file
sharedMemory.Serialize("all_users_memory.bin");

// Full memory lifecycle: extraction, capacity, decay, consolidation
var memory = new AgentMemory(embedModel)
{
    ExtractionMode = MemoryExtractionMode.LlmBased,
    ExtractionModel = chatModel,
    MaxMemoryEntries = 500,
    EvictionPolicy = MemoryEvictionPolicy.OldestLowestImportanceFirst,
    TimeDecayHalfLife = TimeSpan.FromDays(30)
};

// Consolidate similar memories into concise summaries
memory.ConsolidationSimilarityThreshold = 0.7f;
var result = await memory.ConsolidateAsync(chatModel);
Console.WriteLine($"Merged {result.ClustersMerged} clusters, freed {result.EntriesRemoved} entries");

// Summarize a conversation into episodic memory
var summary = await memory.SummarizeConversationAsync(chat.ChatHistory, chatModel);

// Persist and restore
memory.Serialize("agent_memory.bin");
var restored = AgentMemory.Deserialize("agent_memory.bin", embedModel);