Memory System
Give your AI persistent memory across conversations. Build AI that truly remembers.
Memory Hierarchy
Super Agent Stack provides a three-tier memory system that gives you complete control over what your AI remembers and for how long.
Session Memory
Persists within a single conversation. Perfect for maintaining context during a chat session.
User Memory
Persists across all sessions for a user. Build AI that knows your users over time.
Global Knowledge
Self-improving knowledge shared across all users. Anonymized patterns that make every AI smarter.
Quick Example
Enable memory with just two parameters:
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://www.superagentstack.com/api/v1',
apiKey: process.env.OPENROUTER_KEY,
defaultHeaders: { 'superAgentKey': process.env.SUPER_AGENT_KEY },
});
// First message - AI learns user's name
await client.chat.completions.create({
model: 'openai/gpt-4o-mini',
messages: [{ role: 'user', content: 'My name is Sarah and I love TypeScript.' }],
sessionId: 'session-123', // Enable session memory
saveToMemory: true, // Save to memory
});
// Later message - AI remembers!
const response = await client.chat.completions.create({
model: 'openai/gpt-4o-mini',
messages: [{ role: 'user', content: 'What do you know about me?' }],
sessionId: 'session-123',
saveToMemory: true,
});
// Response: "I know your name is Sarah and you love TypeScript!"OpenAI SDK Compatible
Memory Features
Session Memory
Automatic conversation persistence within sessions. Your AI remembers the entire conversation.
User-level Memory
Memory that persists across all sessions. Build AI that truly knows your users.
Explicit Commands
Natural language commands: "remember", "forget", "recall". Users control their memory.
Summarization
Automatic conversation summarization to preserve context within token limits.
Memory Parameters
| Parameter | Type | Description |
|---|---|---|
sessionId | string | Unique identifier for the session. Required for memory. |
saveToMemory | boolean | Whether to save messages to session memory. |
useUserMemory | boolean | Include user-level memory in context. |
autoMemory | boolean | Enable explicit memory commands detection. |
memoryStrategy | string | "truncate" | "summarize" | "sliding_window" |