remember
Store a memory with tags, importance, and type. Use a key to update facts without duplicates, ensuring recall returns the latest value.
Instructions
Store a memory (append-only; raw text is never edited afterward). tags group memories into
cohorts; value (>=1) is its importance — higher-value memories outrank merely-similar ones at
recall, and recall itself nudges value up. mtype ∈ {episodic, semantic, procedural} sets the
decay prior — episodic (events) fades fast, semantic (durable facts) slow, procedural (rules /
preferences) barely; pass it when you know the kind, else it's inferred.
Optional key is a deterministic (subject, relation) supersession key (e.g. "billing-api::auth-method"):
storing a new value with the same key retires the old one so recall never returns the stale value — no
similarity threshold, no extra LLM call. Use it for facts that get updated (config, prices, versions,
status). Pass object = the asserted VALUE (e.g. "frankfurt") alongside key: with the echo guard on
(default here), a later RE-STATEMENT of an already-retired value cannot resurrect it (a corrected fact
stays corrected even if the old value is said again). Without object the guard still catches a verbatim
restatement (text hash), but a reworded one needs the value in object to be caught. Set reaffirm=True
to intentionally revert to a previously-retired value (an explicit change-of-mind, not an echo).
Returns the new id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | ||
| tags | No | ||
| text | Yes | ||
| mtype | No | ||
| value | No | ||
| object | No | ||
| reaffirm | No |