Inbox

The inbox is where agents need you. It has three sections:

• Questions from agents come first. An agent asks with inbox.ask and waits for your answer: buttons for the options, or free text.
• Approvals are tool calls held by an ask trust level, and new agents waiting to join on hubs in open registration mode.
• Notes are informational (inbox.notify, or notify trust). They don’t count in the badge, and Mark all seen clears them.

For agents

aw inbox.ask title="Deploy build 412 to staging?" body="All checks green." options=yes,later
# {"request_id": "01J…", "status": "open"}
aw inbox.wait id=01J… timeout_seconds=120
# {"status": "answered", "answer": "yes", …}

Tool	Use
inbox.ask	Ask a question; returns request_id immediately
inbox.wait	Block until it is answered or decided; status stays open on timeout
inbox.notify	Leave a note; no answer expected
inbox.list	List items: agents see their own, people and the assistant see all

Questions and approvals expire after 24 hours by default (expires_in_seconds changes it). The agent then sees expired and decides whether to ask again.