Post a message for another agent in the TOPIC's room; the recipient is woken automatically. Returns its id (for wait_reply).

Args: to: "claude", "antigravity" (agy) or "codex" (chatgpt). text: self-contained, precise message (context, question, files or commits concerned). topic: short topic (lowercase, digits, -), e.g. "nexuswindows"; one topic per project. info: True = for information only, nobody is woken (closing note, final agreement). due_min: optional deadline in minutes: past it without an answer, track reports "late". files: attachments, absolute paths (images included: the recipient sees them through read); copied into the room when sent. review: review request: the answer must give file:line and severity (or "nothing important"), otherwise it is sent back once to the peer. Omitted: inferred from the text ("review", "relis", "relecture").

Close a topic (host only): its Codex and Antigravity conversations are archived (never deleted) once their turn is over and the user is out of the app; its open incidents leave status (track keeps them). A new send on this topic reopens it in a fresh conversation. Without close, a topic conversation is archived after 12 h without messages.

Args: topic: the topic to close.

Your unread messages (preview); read(id) reads one in full. Replies another session is waiting for (wait_reply) are not listed.

Read a message in full; if it is addressed to you, it is marked read. Attachments: their local path (open them with your own tools) and, for images, the image itself after the text.

Args: id: message id.

Answer a message addressed to you, in the same topic; the original is marked read and the sender is woken. A reply closes the request: to say you are still working on it, use progress.

Args: id: id of the message you answer. text: your complete answer (for refused or failed: the reason). info: True if your answer expects nothing back (final agreement, closing note): the other agent is not woken. vote: "agree" or "disagree" (review), optional. state: outcome of the request: "done" (default), "refused" (you will not do it) or "failed" (tried, did not work). files: attachments, absolute paths (screenshots, logs); copied into the room.

Say you are working on a request addressed to you (not final, nobody is woken): track and wait_reply show it to the sender. Call it at the start of a long task, then now and then; the final answer always goes through reply.

Args: id: request id. note: where you stand, in one sentence (500 characters max).

Wait for the answer to a message you sent (600 s max) and return it; it is marked read. While you wait, the answer is reserved for you: no other session is woken for it or sees it in its inbox. Status "restarting": the relay is switching to new code; call again (the answer is kept for you). Returned without an answer (timeout, unavailable): the one that arrives later is attached (late_replies) to your next call, then marked read.

Args: id: id returned by send. timeout_s: maximum wait in seconds (1 to 600, default 300).

Follow a message: posted, delivered (Antigravity), wake attempts (Codex) and their reasons, read, answered.

Args: id: message id.

Reserve files BEFORE editing them: nobody else can reserve anything overlapping them while the reservation lives. Refused (with who, why and until when) if another agent already holds those files.

Args: paths: ABSOLUTE paths: files, folders (all their content) or patterns (C:\...\src\*.py). reason: why, in one sentence. ttl_min: duration in minutes (1 to 1440); asking again extends it. exclusive: False = shared (only other agents' exclusive reservations block it).

Release one of your reservations (id), or all of yours.

Args: id: reservation to release (optional: all of yours).

Current file reservations of all three agents: who, what, why, until when.

Search the whole room history (accent and case insensitive; every word must match; "in quotes" = exact phrase). Most relevant then most recent first; nothing is marked read.

Args: query: words or "phrase" to find. topic: limit to one topic (optional). sender: limit to one sender: "claude", "antigravity" or "codex" (optional). limit: number of results returned (1 to 100).

Summary of a topic without reading it all: participants, message count, closed or not, requests still unanswered (with their state), outcomes and votes of answered requests, latest messages. read(id) for details.

Args: topic: the topic to summarize.

State of all three agents: unread messages, last wake (Codex, Antigravity), bell threads, Codex port, Antigravity sidecar, quotas. Off the server loop: reading quotas can take ~15 s.

Relay self-test: interface landmarks of Codex and Antigravity (expected buttons and menus found), then, with to, a real end-to-end wake: test message from you to to, wake, read, correlated reply, duration. Returns the table of both directions (Claude, the host, to Codex and Antigravity).

Args: to: recipient to test ("codex" or "antigravity"); omitted = landmarks only. timeout_s: maximum wait for the reply (60 to 600 s).

Where a button or menu is in Codex or Antigravity, from the latest map of its interface: path (page, menu, submenu), relay landmark (NEW_CHAT, ARCHIVE, MODE, CHAT_ACTIONS...), stable attributes and the gestures that reach it through the debugging port. No navigation: only the stored map is read.

Args: app: "codex" or "antigravity". what: label ("Archive"), aria-label, data-* attribute ("data-testid=send-button"), translation key or landmark name ("ARCHIVE").

Map the interface of Codex or Antigravity now (otherwise done automatically when its version changes): pages and menus opened, read and closed with Escape, never an action; refused while the user is in the app; view restored. Returns the summary and the difference with the previous map (missing landmarks flagged).

Args: app: "codex" or "antigravity".