Memory Node

The memory node operates on the in-workflow key-value store that persists within a single execution thread. It is distinct from the long-term memory system (see Memory System).

What It Does

The memory node reads from or clears the in-execution memory dictionary — a key-value store that persists within a single execution thread. Agent nodes can write to this dictionary via the memory_store tool.

Configuration Fields

Modes

retrieve

Searches the in-execution memory dictionary for keys/values matching memoryQuery (case-insensitive substring match). Returns up to memoryTopK results:

{
  "memories": [
    { "key": "user_preference", "value": "dark mode", "text": "dark mode" }
  ],
  "count": 1,
  "query": "preference"
}

clear

Clears the in-workflow memory dictionary. Returns { "__clearMemory": true, "scope": "thread" }.

smart

Passthrough mode — returns the current memory snapshot for an upstream agent to reason about:

{ "memory": { "key": "value", ... }, "count": 2 }

Example Config

{
  "memoryMode": "retrieve",
  "memoryQuery": "user preference",
  "memoryTopK": 3
}