session-memory

Inspectable chat memory for the n8n AI Agent: view, delete and clear session messages

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.2

Documentation

n8n-nodes-session-memory

Chat memory for the n8n AI Agent that you can inspect and edit.

  • Session Memory: plugs into the AI Agent's Memory slot. Works like Simple Memory, but stores every message for the session; Context Window Length only limits what the agent sees.
  • Session Memory Manager: a regular node that works on the same store. For debugging, drop it unconnected into the agent workflow and click Execute step: it runs instantly (no trigger involved), and unconnected nodes never run in production.
    • Show All Memory (default): every session of this workflow with all its messages
    • List Sessions (this workflow or all)
    • Get Messages (one item per message: index, type, content, tool calls)
    • Delete Messages: by index (0, 3, 5-7, -1), last N, first N, or containing text
    • Clear Session / Clear All Sessions

Use the same Session ID in both nodes. With a Chat Trigger, the default {{ $json.sessionId }} works.
The manager only sees sessions of the workflow it runs in (except List/Clear All with scope All Workflows). Put it in the same workflow as the agent, e.g. on a separate Manual Trigger.

Memory lives in the n8n process: it is lost on restart and not shared between workers in queue mode.

Install (self-hosted)

npm install && npm run build
# Option A: custom extensions folder
N8N_CUSTOM_EXTENSIONS=/path/to/session-node n8n start
# Option B: link into ~/.n8n/custom
mkdir -p ~/.n8n/custom && cd ~/.n8n/custom && npm link /path/to/session-node

Test

npm test                                          # local LangChain deps
HOST_N8N=/path/containing/node_modules node test/smoke.js   # against an n8n install's LangChain + agent helpers

Discussion