Send a message to another agent or all agents. Use priority='urgent' for time-sensitive messages. Optional: thread_id groups messages into conversations, reply_to references a specific message, payload carries structured data (dict), ttl sets expiry in seconds, must_read=true prevents auto-expiry. Returns confirmation plus any pending messages for you.

Read incoming messages without deleting them. By default returns only NEW (unread) messages with full bodies. Set include_read=true to see ALL unacknowledged messages. Filter by thread_id to see a specific conversation. Use ack() to acknowledge messages when you're done with them. Also returns delivery receipts for your recently sent messages.

Modes:

• mode='full' (default): each message returned with full content + payload.

• mode='metadata': each message returned as {id, from, ts, priority, preview_120, size_bytes, thread_id, state} — no full body. ~80% smaller; use this for defensive polling.

since: ISO8601 timestamp filter — only return messages with timestamp >= since.

Acknowledge and delete messages by their IDs. This is the only way to permanently remove messages from your inbox (besides TTL expiry). Pass a list of message IDs to acknowledge.

List all currently connected agents and their status.