remember
Store a fact in durable local memory with optional links to existing memories and metadata tags for later filtering. Set a time-to-live to automatically expire the fact.
Instructions
Store a fact in durable local memory. Optionally link it to existing memories (graph) and tag it with structured metadata like project/author/type/status/date (ColumnStore) for later filtering. Set ttl_seconds to make the fact expire after a delay (a durable TTL that survives restarts); omit it for a permanent memory. Returns the fact's stable id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fact | Yes | The fact to store in memory. | |
| links | No | Optional typed links from this fact to existing memories. | |
| metadata | No | Optional structured metadata for later filtering (e.g. `{"project": "veles", "author": "julien", "status": "open"}`). | |
| ttl_seconds | No | Optional time-to-live in seconds. When set, the fact expires (and stops being recalled) after this many seconds — a durable TTL that survives a restart. Omit for a permanent memory. Falls back to the server's `VELESDB_MEMORY_DEFAULT_TTL` when unset. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Stable id assigned to the remembered fact. |