Living Memory

Ask the human who owns this world for help, when a person is waiting and neither your own knowledge nor this memory can answer them. You do not choose or learn the channel — the world routes it — and you will not get a reply inside this turn. Search memory first: this spends a person's attention, and only one raise per world per minute is carried.

world_raise

DESTRUCTIVE. Permanently deletes every episodic memory whose content contains the query as a case-insensitive substring — not semantic, not a single-item delete, and there is no undo. A short query deletes broadly. Use only when the user corrects a stored fact or explicitly asks you to forget something, and prefer a long distinctive phrase; check memory_state first if unsure.

memory_forget

See every live note in this shared workspace — id, label, sender, age and size, but NOT the text. Use it when handoff_read returned a note that is not the one you were told about, or when you need the id of an older note that is still live. Read a specific one with handoff_read({ id }). Listing permanently deletes expired notes during mailbox cleanup.

handoff_list

Show the memory worlds this connection can reach: id, human title, and which one is used when no world is named. Call it when the human refers to a shared project or asks which world you are in. It reads nothing from inside a world and changes nothing.

world_list

Summarize what is currently in memory: counts plus the most recently stored facts. Reads the store directly — no embedding call, no network. Use to orient yourself at session start, or when the user asks what you remember. (selfFacets is always 0: this server does not run the engine's consolidation pass, so crystallization never happens.)

memory_state

Leave a RAW ephemeral note (up to 64KB of text) for the next agent working in this shared workspace — a work handoff, spec, or state dump that must survive verbatim, not as memory. Expires after ttl_hours (default 24h, max 72h) and is then deleted. Not searchable and never embedded: the reader gets the exact bytes via handoff_read. Subscribed clients may receive a handoff.created webhook with note identifiers at their external callback. Posting also permanently deletes expired notes during mailbox cleanup.

handoff_post

Read the latest raw handoff note left in this shared workspace (or a specific one by id). Returns the exact posted text. Use at the start of a session to pick up work another agent handed off. Reading permanently deletes expired notes during mailbox cleanup; live notes are not consumed.

handoff_read

Recall relevant stored memories when the user asks about past context, preferences, decisions, commitments, or project history. Returns relevant memories via MMR retrieval (not a text match). If unsure whether you know something, search first.

memory_search

Store a durable fact, preference, decision, or correction so FUTURE sessions remember it. Use when the user explicitly asks to remember something, or clearly says a durable preference, project fact, decision, or correction should carry forward. Memory persists across sessions and processes.

memory_add