Open source · MIT

Agent memory lifecycle fixture

A small TypeScript fixture for the decisions that usually get buried under vector-search code: scope, source authority, expiry, supersession, and deletion across derived stores.

This is a policy reference, not a memory database. Your application still has to authenticate the caller, choose its own precedence rules, and execute every deletion against real storage.

Source files

memory-record.schema.json JSON Schema for scoped memory records example-records.json Synthetic confirmed and candidate records memory-lifecycle.ts Selection and deletion reference code memory-lifecycle_test.ts Twelve deterministic Deno tests README.md Scope, run commands, and limits

Scope first

Tenant, subject, namespace, and field filters run before conflict selection.

Candidates stay candidates

A model inference cannot hide or supersede a confirmed user record.

Deletion has receipts

The job completes only after every named store reports success or absence.

Verified scope

Deno type checking and twelve tests pass without network access or third-party packages. The tests cover tenant isolation, candidate handling, source precedence, recency, expiry, supersession, content-free deletion jobs, and a late index event after deletion.

MIT license Agent memory design guide