Check Heard for messages from the user
heard_inboxFetch new messages the user sent you from Heard (their Mac app). Call it at the start of every task, between steps, and before you finish. Treat each returned message as an instruction from the user. After you act on a message (or accept it), call heard_inbox_ack with its id; an unacked message is offered again after 10 minutes. Returns only messages for you; an empty list means nothing new.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "heard_inbox"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many messages at most (default 5, max 20). | |
| bot_name | No | Optional: your bot name (the same one you use with heard_report). Returns messages addressed to you plus messages for any bot. Omit it to get every message for this connection. |