Interface MemoryAdapter

Memory Adapter interface for molroo SDK.

Abstracts episode storage and recall so consumers can:

Store chat episodes to their own database (SQLite, Pinecone, Supabase)
Recall relevant memories for LLM context enrichment
Optionally store reflections generated from LLM

Implementations are provided by the consumer — SDK only defines the interface.

interface MemoryAdapter {
    getReflections?(sourceEntity?: string): Promise<Reflection[]>;
    recall(query: RecallQuery): Promise<Episode[]>;
    saveEpisode(episode: Episode): Promise<void>;
    saveReflection?(reflection: Reflection): Promise<void>;
}

Index

Methods

getReflections? recall saveEpisode saveReflection?

Methods

`Optional`getReflections

getReflections?(sourceEntity?: string): Promise<Reflection[]>
Retrieve reflections for a source entity. Optional.
Parameters
- OptionalsourceEntity: string
Returns Promise<Reflection[]>
- Defined in src/memory/types.ts:24

recall

recall(query: RecallQuery): Promise<Episode[]>
Recall relevant episodes for LLM context enrichment.
Parameters
- query: RecallQuery
Returns Promise<Episode[]>
- Defined in src/memory/types.ts:18

saveEpisode

saveEpisode(episode: Episode): Promise<void>
Save an episode returned by the API's AgentResponse.
Parameters
- episode: Episode
Returns Promise<void>
- Defined in src/memory/types.ts:15

`Optional`saveReflection

saveReflection?(reflection: Reflection): Promise<void>
Save a reflection generated by LLM. Optional — omit for episode-only storage.
Parameters
- reflection: Reflection
Returns Promise<void>
- Defined in src/memory/types.ts:21