write.tool
This package holds more than this page lists. See all of its files in its world.
README.md
write
Create a memory, or replace one. Each entry is a short name (lowercase
letters, digits and dashes), a one-line description (what the brief shows)
and a markdown body of at most 16 KiB. A scope keeps at most 256 entries
and 1 MiB of them.
scope = "world" (the default) writes this world's memories, read by every
writer of the world and their agents. scope = "personal" writes the
person's personal memories, kept in their home world and read by their own
agents in every world: what the person will want any of their agents to know
later. The person is shown each personal write, with the call that undoes
it.
Replacing an existing entry takes the revision read or list answered
for it. When the entry changed since (another agent wrote it), or no revision
is given, nothing is written: the answer is ok = false with the reason
and the current entry, to merge into and write again with its revision.
edit changes one part of an entry without replacing the rest. The version
a write replaces is kept, and previous in the answer names it.
The entry records who wrote it (the agent's name and the person it works for), the world it was written in for a personal one, and when. Text that reads as a credential is refused, naming what it found.
For example, after settling the world's palette with the person, an agent
writes palette with the description "Muted earth tones; accents only in
teal #2a9d8f" and the swatches in the body. After the person says twice that
they want a failing test before a fix, an agent writes the personal entry
code-style saying so.