handoff_list_available
Expire stale leases, then list open handoffs visible and eligible to your agent, paginated; preview metadata only until claimed.
Instructions
Expire leases, then list OPEN handoffs visible+eligible to the caller (paginated); entries are metadata-only until claimed.
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": {
"project_root": "<project_root>",
"agent_id": "<agent_id>"
},
"name": "handoff_list_available"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max handoffs per page (optional; default applied by the server, clamped to the maximum). | |
| cursor | No | Opaque pagination cursor: pass back the next_cursor from the previous page to continue (optional; omit or '0' to start from the beginning). | |
| agent_id | Yes | Your agent_id (the worker); scopes visibility/eligibility and ownership. REQUIRED. | |
| project_root | Yes | Absolute path to the project (defines the workspace scope). | |
| timeout_seconds | No | Long-poll bound in SECONDS (optional). 0/omitted = non-blocking snapshot; >0 OPTS IN to blocking until a claimable handoff appears or the timeout elapses. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||