Check in on a claim
heartbeatKeeps your claim alive, a reading claim too. Call it about every 5 minutes. A comment with your runId counts too. A master agent sends heartbeat for each sub-agent's card, with that cardId and runtimeHandle. Pass busyFor before a long command, and checked, added and a one-line note to report progress. In a batch, one beat keeps every card.
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": {
"cardId": "<cardId>"
},
"name": "heartbeat"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | One line on your progress. | |
| added | No | New checklist items. | |
| prUrl | No | Pull request URL (https), saved on the card you hold. | |
| runId | No | Run id from claim_next. | |
| cardId | Yes | Card id, number (12) or key (WEB-12). | |
| boardId | No | Board id or slug. | |
| busyFor | No | Minutes a long command will take. | |
| checked | No | Checklist items you finished: positions (from 1) or texts. | |
| persona | No | The persona to act as. | |
| runtimeHandle | No | A short name for this agent or sub-agent. Use a different one for each sub-agent. |