Class AgentMemory

Access the underlying manager for advanced usage.

Access the underlying standalone Memory facade for advanced usage.

Create an AgentMemory wrapping an existing CognitiveMemoryManager. Use this in wunderland where the manager is already constructed.

Create an AgentMemory wrapping the standalone SQLite-first Memory facade.

Create an initialized SQLite-backed AgentMemory for standalone usage.

Initialize the cognitive-manager path. Only needed when constructing the legacy cognitive backend directly (not via AgentMemory.wrap() or AgentMemory.sqlite()).

Store information in long-term memory.

Example

await memory.remember("User prefers dark mode");
await memory.remember("Deploy by Friday", { type: 'prospective', tags: ['deadline'] });
Copy

Recall memories relevant to a query.

Example

const results = await memory.recall("what does the user prefer?");
for (const m of results.memories) {
  console.log(m.content, m.retrievalScore);
}
Copy

Search memories (alias for recall with simpler return).

Feed a conversation turn to the observational memory system. The Observer creates dense notes when the token threshold is reached.

Example

await memory.observe('user', "Can you help me debug this?");
await memory.observe('assistant', "Sure! The issue is in your useEffect...");
Copy

Get assembled memory context for prompt injection within a token budget.

Register a prospective memory (reminder/intention).

List active reminders.

Run consolidation cycle.

Memory health diagnostics.

Shutdown and release resources.

Ingest files, directories, or URLs. Available only when backed by the standalone SQLite-first Memory facade.

Import previously exported memory data. Available only when backed by the standalone SQLite-first Memory facade.

Export memory data. Available only when backed by the standalone SQLite-first Memory facade.

Record used/ignored retrieval feedback. Available only when backed by the standalone SQLite-first Memory facade.