Simple Memory

Experimental plugin used to prove out the Vellum assistant plugin system end-to-end. Every hook a memory system would need is wired with the thinnest possible implementation behind it; the value of this plugin is the surface, not the behavior.

It is the canonical reference implementation for the external plugin convention: a package.json manifest, lifecycle hooks/, model-visible tools/, and internal src/ helpers.

Layout

simple-memory/
├── package.json               # Manifest (name + @vellumai/plugin-api peer dep)
├── hooks/
│   ├── init.ts                # Hydrate the store from disk
│   ├── shutdown.ts            # Flush the store back to disk
│   └── user-prompt-submit.ts  # Per-turn message-list transform
├── tools/
│   ├── recall.ts              # Regex search across remembered entries
│   └── remember.ts            # Append a freeform note
├── src/
│   └── state.ts               # Shared in-process store + helpers
└── __tests__/                 # Behavioral tests (run with `bun test`)

Develop

bun install
bun test

The plugin imports types from @vellumai/plugin-api. Those imports are type-only, so they are erased at runtime and the test suite runs without the package installed.

Install into an assistant

assistant plugins install simple-memory

This resolves the plugin through the curated marketplace.json in the vellum-assistant repo, which pins this repository at an immutable commit.

Details