@agentprodready/memory

Execution-derived memory for AgentProdReady — capture, store, search, and recall context from agent runs (distinct from Knowledge / RAG).

| | | |---|---| | Status | Production contracts published (1.1.x) | | Install | npm install @agentprodready/memory | | Module | ESM | | License | MIT |

Installation

npm install @agentprodready/memory

# Durable memory (host also needs Persistence)
npm install @agentprodready/persistence @agentprodready/persistence-postgres

# Semantic / hybrid search (optional)
npm install @agentprodready/vector-store @agentprodready/vector-store-pgvector

Features

| Feature | Description | |---|---| | Memory lifecycle | Capture → store → retrieve → recall | | In-memory provider | Process-local default for demos/tests | | FileBackedMemoryProvider | JSON file durability for Simple fileMemory() | | Persistence-backed provider | Durable records via Persistence repository memory-records | | Search provider surface | Pluggable MemorySearchProvider | | Vector / hybrid search | Additive when host enables vector stack | | Security boundary | Scoped by tenant / authorization outcomes | | No vendor lock-in | Does not import pg or OpenAI |

Providers

| Provider | Use when | |---|---| | InMemoryMemoryProvider | Local development, unit tests | | FileBackedMemoryProvider | Single-node file durability (Simple fileMemory) | | PersistenceBackedMemoryProvider | Cross-process Postgres durability |

Host configuration (reference product)

| Environment variable | Meaning | |---|---| | MEMORY_PROVIDER=in-memory | Default | | MEMORY_PROVIDER=persistent | Persistence-backed Memory | | PERSISTENCE_PROVIDER=postgres | Required for durable Memory | | VECTOR_SEARCH_ENABLED=true | Enable semantic / hybrid retrieval |

Usage (conceptual)

import type { MemoryProvider } from '@agentprodready/memory';

declare const memory: MemoryProvider; // from Composition

// Capture / store / search APIs are on the Memory contracts —
// wire through your host composition (see monorepo platform-host).

Runnable wiring: clone the monorepo and follow the Memory guide.

Related packages

| Package | Role | |---|---| | @agentprodready/persistence | Durability contracts | | @agentprodready/persistence-postgres | Postgres provider | | @agentprodready/vector-store | Vector NN contracts | | @agentprodready/agent-framework | Agent declarations for memory resources |

Documentation

• Durable Memory guide
• Memory guide
• Vector search
• Blueprint 11

License

MIT © 2026 ameenmari