Skip to main content

Interface: MemoryConfig

Defined in: packages/agentos/src/memory/facade/types.ts:198

Top-level configuration object for the Memory facade.

All fields are optional; sensible defaults are applied per field. A minimal {} config is valid and will use a temporary SQLite brain file with graph + self-improvement enabled.

Properties​

consolidation?​

optional consolidation: ExtendedConsolidationConfig

Defined in: packages/agentos/src/memory/facade/types.ts:246

Consolidation schedule and thresholds.

decay?​

optional decay: boolean

Defined in: packages/agentos/src/memory/facade/types.ts:243

Whether memory traces lose strength over time following an Ebbinghaus forgetting-curve model.

Default​

true

embeddings?​

optional embeddings: EmbeddingConfig

Defined in: packages/agentos/src/memory/facade/types.ts:222

Embedding model configuration.

graph?​

optional graph: boolean

Defined in: packages/agentos/src/memory/facade/types.ts:229

Whether to build and maintain a knowledge graph alongside the vector store. When enabled, entity co-occurrence and semantic edges are tracked.

Default​

false

ingestion?​

optional ingestion: IngestionConfig

Defined in: packages/agentos/src/memory/facade/types.ts:249

Document ingestion settings applied to all ingest() calls by default.

path?​

optional path: string

Defined in: packages/agentos/src/memory/facade/types.ts:219

File-system path for stores that require one (e.g. SQLite db file). Ignored by in-memory and remote stores.

Example​

'./data/agent-memory.sqlite'

selfImprove?​

optional selfImprove: boolean

Defined in: packages/agentos/src/memory/facade/types.ts:236

Whether the agent may autonomously refine and restructure its own memories (write new insight traces, prune contradictions, merge redundancies).

Default​

false

store?​

optional store: "memory" | "qdrant" | "sqlite" | "neo4j" | "hnsw"

Defined in: packages/agentos/src/memory/facade/types.ts:212

Persistence backend for memory traces.

The Phase 1 facade currently implements the SQLite path at runtime. Other values are reserved for future backends and will throw if selected.

  • 'sqlite' – file-based SQLite (implemented; recommended).
  • 'memory' – reserved for a future in-process backend.
  • 'qdrant' – reserved for a future vector-database backend.
  • 'neo4j' – reserved for a future graph-database backend.
  • 'hnsw' – reserved for a future ANN-only backend.

Default​

'sqlite'