events syncs the transcript.
events imports the active session into episode records. it resolves the trusted caller identity, normalizes the transcript, and returns recent episode event ids the agent can cite.
episodic memory
grounded in truth.
episodic memory is the evidence layer. it records what actually happened in each session—dialog, tool calls, every event—so that durable writes can trace back to something real. every memory must be justified. nothing is fabricated.
how it works.
evidence references.
durable writes require evidence references that point to specific episode events. the link is a direct foreign key to the exact session moment. no reference, no write.
no fabrication.
if the evidence is ambiguous, shellbrain skips the write. three-layer validation—schema, semantic, integrity—ensures every cited event actually exists and is visible within the repo.
the foundation.
episodic memory is what makes the rest of the system trustworthy. procedural scenarios, semantic facts, associative links—all of them point back to the transcript evidence that produced them. shellbrain would rather have no memory than a memory it cannot justify.