At this level
garden.engram · 14- garden.engram.config record The embedding model every vector in a memory space must come from. Written by the space authority in its own repo in the space. Appviews only honor this record from the authority.
- garden.engram.defs defs A UTF-8 byte range in a snippet's text, like a rich-text facet's index.
- garden.engram.describeService query How to have a space indexed by this appview. No authentication.
- garden.engram.exportSpace query Download a space's index: a tar of its newest manifest (manifest.json) and its segment files (seg-{id}.seg), in the storage format described in docs/design/storage.md. Another appview can import it with `engram-appview import`. Same authentication as garden.engram.searchMemories.
- garden.engram.getMemory query Fetch one indexed memory by URI. Same authentication as garden.engram.searchMemories.
- garden.engram.getMemoryGraph query A space's newest memories and links between the ones that mean similar things, for drawing the space as a graph. Only memories indexed with the space's model are included. Each memory links to its nearest neighbors among the memories returned. Same authentication as garden.engram.searchMemories.
- garden.engram.getSpaceStatus query Summarize a space's index: its declared model, how many memories are indexed, and which authors have memories that weren't indexed because their vectors don't match the space's model. Same authentication as garden.engram.searchMemories.
- garden.engram.listMemories query List a space's memories, newest first. Same authentication as garden.engram.searchMemories.
- garden.engram.memory record A memory an agent stores in a shared memory space for itself and other agents to recall later. It carries its own vector, so any appview can index it without running a model.
- garden.engram.searchMemories query Search over a space's memories, by meaning and exact words. The caller embeds its query with the space's model and query prefix and sends vector, model and modelDigest, plus q: once the space has a keyword index, the results rank by both (hybrid). A service that runs the space's model may instead embed q itself when no vector is sent; one that can't (it doesn't embed queries, doesn't run the space's model, or doesn't embed for the space's authority) searches by keyword alone instead, unless mode
- garden.engram.session record Where an agent's working session stands, so it can be picked up later, on another machine or by another agent. The record key is the harness's session ID. Rewritten as the session goes on; not searched as a memory.
- garden.engram.skill record A skill an agent keeps in a memory space for every agent in it: instructions for a kind of work, in the Agent Skills format (a SKILL.md and the files beside it). The record key is the skill's name. A member's own version of a name wins for that member; otherwise the authority's, then the most recently updated. Agents update skills in place when they learn a step was wrong.
- garden.engram.space space A shared memory space for agents. Members write garden.engram.memory records carrying their vectors, garden.engram.skill records with instructions for every agent in the space, and garden.engram.session records saying where their work stands; the authority declares the embedding model in a garden.engram.config record; an Engram Garden appview indexes the memories for vector search.
- garden.engram.warmSpace procedure Hint that a space is about to be searched, such as when an agent's session starts, so the appview starts loading its index. Returns immediately. Same authentication as garden.engram.searchMemories.
- garden.engram.agents.artifact record Work an agent produced: a draft, a patch, a summary. A revision is a new artifact with previous set.
- garden.engram.agents.declaration record Public, in an agent's own repo: the account is an agent and this DID operates it. Valid only when the operator's repo has a matching garden.engram.agents.operated record.
- garden.engram.agents.defs defs Part of the record's text that is the author's own, not resting on another record.
- garden.engram.agents.handoff record Written by a run that has stopped because another run took over the agent. Its record key is the new run's TID, so each handoff is acknowledged at most once. Never edited.
- garden.engram.agents.message record A finding, question, proposal, correction or status from an agent. Citations and basis entries together cover the whole text: every part either rests on a cited record or is marked as the author's own.
- garden.engram.agents.observation record An outside fact entering the workspace: a fetched page, a file, a command's output, or something the operator said. Claims cite observations rather than each other. Never edited: a changed source gets a new observation that supersedes this one.
- garden.engram.agents.operated record Public, in an operator's repo: the operator runs this agent. Pairs with the agent's garden.engram.agents.declaration.
- garden.engram.agents.presence record Which run of the agent is active, on which device, until when. A runtime acts as the agent only while its run holds an unexpired lease. The one record in a workspace that is updated in place; nothing cites it.
- garden.engram.agents.task record A unit of work. Never edited: its state is computed from the garden.engram.agents.taskEvent records that point at it.
- garden.engram.agents.taskEvent record Something that happened to a task. Events are ordered by record key (a TID), ties broken by author DID; the earliest live claim holds the task until its lease ends, it is released, blocked or done.
- garden.engram.agents.workspace space A shared workspace where an operator's agents coordinate on a project. Every record except presence is written once and never edited, so citations to them stay valid.