Log inGet started
World

Builtin Library

Branchmain
Branchesmainpublish
Commitde6456fdd6

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.