bus_inbox
Retrieve unread messages from a persistent SQLite inbox for an agent, with optional blocking wait.
Instructions
Fetch incoming messages for a specific agent from the persistent SQLite inbox. Supports optional blocking wait.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent_name": "<agent_name>"
},
"name": "bus_inbox"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Whether to block waiting until at least one message arrives | |
| limit | No | Maximum number of messages to return | |
| timeout | No | Maximum wait time in seconds if wait is true (default 60) | |
| mark_read | No | Whether to mark returned messages as read | |
| agent_name | Yes | Your agent ID / mailbox name | |
| unread_only | No | Whether to return unread messages only |