Read the map: every read is one call, query with the name of what to read and its params. With no name, every name with what it answers. actions says what one takes, whole: params read (a read or view, such as flat), action (or change, for its ops) or verb. An agent is given each answer without its empty fields and with long lists cut to what is read (params.full: true for all of it). The reads and their params: schema (type?, full?); search (q?, type?, status?, owner?, open?, include_archived?, limit?, full?); get (id, history?, full?); events (since?, target?, actor?, by?, before?, origin?, limit?, full?); proposals (status?, full?); picture (result?, look?); watch (after?, wait_seconds?); packs (none); acts (none); document (id, drawn?); publish_plan (within); published (id); share_figure (via, id); backup_download (none); places (canvas?); look (entity?, query?, lens?, style?, width?, height?, scheme?, fresh?, marks?); seeing (run?). Every other name is a view: flat, changed_since, spent, usage, notifications, sessions, saved_views, style, instructions, story, attention, graph, tree, hubs, brief. flat is the query: filter { find, only, not }, walk { over, steps }, limit.

The only way to change the map: a list of ops with a reason. A create’s ref lets later ops link to it, and a title or note in the same change names what it makes as {ref}. Give the source the facts came from. To add to a note or change a passage, send append or replace, not the whole body. An update with only the id says you checked the item and it is still true. Checked as a whole, then applied or held as a proposal for a human, by policy. A refused change is kept for a few minutes under a name the refusal gives: send retry and fixes (the ops that were wrong, by number), not all of it again. Closing a decision or hypothesis is held for the human, unless the workspace applies agents’ changes: then a decision must carry props.outcome and props.rationale, and is put to the owner later (attention, to_confirm). Each op is { op, ...its fields }: create (ref?, type, title, body?, status?, owner?, visibility?, confidence?, props?, source?); update (id, title?, body?, append?, replace?, status?, owner?, visibility?, confidence?, props?); link (type, from, to, props?, confidence?, source?); unlink (relation); archive (id); forget (id, reasons?); restore (id); merge (keep, drop); define_type (type). query actions with action change says each field.

Reverse one change set (its id is on every event it logged) by applying the opposite as a new change: created items are archived, edits put back, links removed or restored. An edit changed again since is left alone and reported. Subject to the same policy as any change.

Put something on the map: an item and its links, or a record of what happened. Call with the action and its params. Its actions: session_start (title?, task?, surface?, cwd?, remote?, session_id?, branch?, source?); picture_put (result, data, content_type); backup (none); import_audit (connection). query actions says what each does.

Give work to someone, inside the map or outside it: an owner, a person waited on, a party asked to act. Call with the action and its params. Its actions: claim (resource, holder, for?, reason). query actions says what each does.

Say that something happened or is so: progress, a result, a payment received, a check that it is still true. Also answers the owner with a view: show, with a kept view or an ad-hoc lens and style. Call with the action and its params. Its actions: session_update (run, status?, note?, task?, branch?, title?); session_end (run, outcome?, reason?, summary?, still_true?, cannot_tell?, cannot_tell_rest?); tell (run, said, about?, links?, replaces?, finding?); run_report (repo, title, ok?, tokens?, cost_usd?, turns?, link?, summary?, surface?); rechecked (repo, summary?); show (entity?, query?, lens?, style?, screen?, note?, look?, width?, height?, scheme?, pane?, run?); check_connections (none); health (heartbeat?, monitor?, msg?, live?, idle?, said?). query actions says what each does.

Put a question to someone and wait for the answer. Call with the action and its params. Its actions: notify (title, body?, level?, about?); publish_ask (within, reason?). query actions says what each does.

Close a question by someone's word or by evidence: a decision made, a hypothesis borne out. Call with the action and its params. Its actions: confirmed (upto, basis). query actions says what each does.

Change, correct or undo what is on the map. Call with the action and its params. Its actions: release (resource, holder?, reason); places_put (canvas?, moves?, clear?); publish (id, authority?); publish_all (within, authority?); undo (changeset). query actions says what each does.

Draw a view in this chat, for the person reading it, in a client that draws MCP Apps (Claude chat). Elsewhere nothing is drawn: report show opens it on their canvas, query look gives you the picture.