list_message_states
Read back the agent's own per-message state — the record claim_message and complete_message write. Returns one row per message: its messageId, the state (pending, processing, done or failed), the labels and note the agent attached, who holds the claim and when. The rows belong to the CALLING credential, so another credential of the same tenant does not read them; domainId is required because the state is scoped to the domain whose mailbox received the message. Use it after a restart to find the messages this agent took and never finished: state: "processing" is that list.
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": {
"domainId": "<domainId>"
},
"name": "list_message_states"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Optional: the page size. | |
| state | No | Optional: only the states in this one. `processing` is the list a restarted agent wants — the messages it took and never finished. | |
| domainId | Yes | The id of the domain whose mailbox received the messages — from `list_domains`. Required: the state belongs to one domain's mailbox. | |
| messageId | No | Optional: narrow to one message. |