Register this Claude session in the mailbox and start heartbeating.

project/branch/worktree are auto-detected from git. Auto-claims leadership if on the main branch. Idempotent for the connection's lifetime (one process per session under stdio; one entry per connection under HTTP). Also captures the live session so peer messages can be pushed as claude/channel events.

Manually pump a heartbeat and return role + inbox (the background thread heartbeats automatically; call it to force a fresh read).

Update this session's advertised objective.

Set this session's status: active | idle | blocked | done.

List other live Claude sessions: who is working, on what, where.

Who is the current leader/orchestrator (the session on main)?

Attempt to become leader. Only succeeds on the main branch unless force. force is restricted to stdio (global-tvr) — an HTTP caller force-claiming leadership would gain delegate() over every session.

Voluntarily give up leadership.

Broadcast a message to a channel. Defaults to this session's own project channel, so only sessions in the same repo are interrupted. Pass channel="general" to reach every project on the machine — do that only when the other projects genuinely need to know.

Read recent messages on a channel (newest first).

Send a direct message to a specific session.

Read messages/delegations addressed to this session. Closes DMs when mark_read is true (a closed DM = read).

Ask another session a question and block (up to timeout_s) for its answer.

Creates a request bead (not ephemeral — an unanswered question must not evaporate) assigned to the target (surfaces in their poll_inbox); they reply via respond_info, which comments the answer and closes the bead. Returns {request_id, answer, resolved, timed_out}. If it times out, keep the request_id and poll later with check_request — the request stays open.

Answer an info-request (from poll_inbox 'requests'): comment + close, which unblocks the asking session. Only the session the request is assigned to may answer it (global-5yn) — otherwise any connection could forge an answer to another agent's blocking request_info call.

Non-blocking: has an info-request been answered yet? Only the session that created the request may poll it — otherwise any connection could read another agent's answer by guessing/enumerating request_ids.

Leader-only: assign a work item to a secondary session.

Cleanly leave the mailbox: release leadership, mark done, close bead.