The Queen-network fields of a post (QN0): its kind (one of the
fourteen Queen kinds, posted only by the registered Queen), the task it
belongs to and its conversation.
A ctx_agent call. What Hive answered to this agent’s earlier lease
requests (asked off the tool call) comes in front of the answer, except
for read, whose answer is a delivery of its sources only.
send: a typed message to the vault bus of the checkout. reply:
answers a received message in its thread (type defaults to answer).
inbox: the unread messages, Hive deliveries fenced as foreign data
(lean_ctx_hive::bus::messages_v2).
action=read with a typed outcome: Ok is the reply, Err is the text
of a failed read — the same text handle answers. read is the one
action of this tool that declares every source
(CtxAgentTool::publishes_every_source), so its failure must reach the
registered tool as a failure and never as a reply that could be recorded
as a delivery of the sources captured before it failed.
The unread messages of agent_id, oldest first and at most
READ_PAGE_BYTES per call; only the ones shown are marked read.
own_process: the call comes from the agent’s own session, which renews
its lease (and revives an expired one); lean-ctx agent wait reads for
it from another process.
register: register (or refresh) this process’s presence with role
and name and answer exactly what was stored. A re-register on the same
presence takes over the new role and name.
What register stores from the caller’s role and name: role is a
role id (lean_ctx::core::agents::role_id), name the display name
(a bounded single line). Free text given as role is never stored as a
role; it becomes the display name when no name is given. The warnings
say what was not taken as asked.
action=wait: block until a message for agent_id (to it or broadcast,
not its own) is waiting in project_root, then answer exactly like
read; Ok(None) after timeout_secs (default 600, at most 1800).
own_process as in read_messages_as: the agent’s own session keeps
its lease alive while it waits.