handoff_claim
Atomically claim an OPEN handoff so only one agent wins; others receive a structured error. Returns the payload, claimed_by, and lease_expires_at; strict mode requires session credentials.
Instructions
Atomically claim an OPEN handoff; single winner, others get a structured error. Returns the payload + claimed_by/lease_expires_at. In strict mode pass session_id + session_secret.
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>",
"handoff_id": "<handoff_id>",
"agent_id": "<agent_id>"
},
"name": "handoff_claim"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | Your agent_id (the worker); scopes visibility/eligibility and ownership. REQUIRED. | |
| handoff_id | Yes | The handoff_id to act on. REQUIRED. | |
| session_id | No | Your session_id from session_open (optional in trust_mode=open; REQUIRED together with session_secret in trust_mode=strict). | |
| project_root | Yes | Absolute path to the project (defines the workspace scope). | |
| session_secret | No | session_secret from session_open for session_id (optional in open mode but VALIDATED if supplied; REQUIRED in strict mode). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||