renew
Prevent lease expiry during long-running tasks by extending every held lease for its original TTL and restarting the four-TTL age limit.
Instructions
Extend every lease you hold by its original TTL and restart the four-TTL age limit that ends a lease however active you are. Needed only during long work with no other call, because any tool call already renews; to take new paths use claim. Returns how many leases were renewed and the latest expiry; not_found when you hold none.
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": "<agent>"
},
"name": "renew"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | Yes | Your stable agent name. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | The caller. | |
| count | No | Leases renewed. | |
| status | Yes | ok. not_found: you hold no claims. invalid: bad input. | |
| message | No | Human-readable detail, on most outcomes other than ok. | |
| expires_at | No | RFC 3339 latest expiry among the renewed leases. |