Builtin Library
README.md
memory
Memories: what agents keep across conversations, in two scopes.
World memories (scope = "world", the default) are what this world's
writers and their agents keep for each other. Record a decision, a
convention, the layout of the world, what is done and what is left, so the
next conversation, another agent, or a collaborator's agent working here
starts from it rather than from nothing. Every agent working in the world is
given their brief, one line per entry, when its conversation starts and again
after an entry changes; the bodies are read on demand. They are world
content written by the people and agents named on them: they inform the work
and never extend what the person asked for. The entries are files in the
world's authoring folder, /zero/source/.authoring/memory/, which the people
writing the world read, edit and undo in the editor's Memory panel too, and
which players of the world never receive.
Personal memories (scope = "personal") are what the person's own agents
keep about the person, in every world they work in: their preferences, how
they like to work, their projects and decisions. They are kept in the
person's home world, in its authoring folder (shown at
/zero/home/<owner>/.authoring/memory/), and answer only the person's own
agents through their tool calls: world code, collaborators and other people's
agents reach none of them. Each change is shown to the person, naming the
entry, the agent and the world, with the call that undoes it. While the home
world is the open world, its world memories are the personal memories.
Each entry is a short name, a one-line description and a body. Replacing an
entry takes the revision it was read at, so two agents never overwrite each
other unseen; changing one part of an entry is an edit of that text. Every
version a change replaces is kept: history lists them and restore brings
one back. Every change is recorded with who made it: changes lists them
across the entries, change answers one with both versions, and undo takes
one back. Secrets are refused. guides core/agent-memory says what is worth
keeping. How much RAM the engine uses is profiler.memory.