Memory Types
HyperSpark Memory classifies information using a three-tier system: rings, domains, and categories. This structure enables intelligent organization and precise retrieval.
Memory Classification Hierarchy
Memory Rings
Memory rings represent the fundamental type of information being stored, inspired by how human memory works. Each ring captures a different aspect of knowledge.
Episodic
episodicEvents, interactions, and moments in time. What happened.
- -"Meeting with John about Q4 planning"
- -"User reported a bug in the login flow"
- -"Celebrated team milestone yesterday"
Semantic
semanticFacts, knowledge, and truths about the world. What is.
- -"John is the CTO of Acme Corp"
- -"The project deadline is March 15th"
- -"User prefers dark mode"
Procedural
proceduralPatterns, preferences, and how things are done. How to.
- -"Always CC the manager on important emails"
- -"Prefers bullet points over paragraphs"
- -"Deploy on Tuesdays after standup"
Life Domains
Domains classify memories by the area of life they relate to. This enables focused retrieval and context building for specific situations.
workWorkJob, career, workplace matters
financeFinanceMoney, budgets, investments
projectsProjectsActive projects and initiatives
goalsGoalsObjectives and aspirations
get_context or recall, use the focus parameter to filter by specific domains.Memory Categories
Categories provide granular classification within each ring. They help the AI understand what type of information is being stored and how to use it.
| Category | Ring | Description |
|---|---|---|
interaction | episodic | Conversation, meeting, call |
event | episodic | Something that happened |
decision | episodic | Choice that was made |
milestone | episodic | Achievement, completion |
observation | episodic | Something noticed |
fact | semantic | Objective truth |
identity | semantic | Who someone/something is |
attribute | semantic | Property or characteristic |
relationship_fact | semantic | How things relate |
belief | semantic | Held opinion or view |
preference | procedural | Like/dislike, choice tendency |
habit | procedural | Regular behavior |
workflow | procedural | How to do something |
rule | procedural | Constraint or requirement |
pattern | procedural | Observed regularity |
decision_trace | episodic | Full decision with context |
exception_granted | episodic | Policy exception |
precedent_set | episodic | Creates precedent for future |
policy_applied | episodic | Standard policy application |
Usage Example
// Recall only semantic facts about work
const result = await memory.recall({
userId: 'user_123',
query: 'project deadlines',
filters: {
rings: ['semantic'],
domains: ['work', 'projects'],
categories: ['fact', 'attribute']
}
});
// Get context focused on specific domains
const context = await memory.getContext({
userId: 'user_123',
focus: ['work', 'projects'],
maxTokens: 2000
});