handoff_cancel
Cancel an OPEN handoff as its creator to retract a task nobody should take. Use when a handoff, such as a pool target matching zero agents, needs removing.
Instructions
Creator-only OPEN -> CANCELLED; retract a handoff nobody should take (e.g. a pool target matching zero agents). Only OPEN handoffs cancel. In strict mode pass session creds.
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_cancel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Human-readable reason recorded with the handoff.cancelled event (optional). | |
| agent_id | Yes | Your agent_id; must be the handoff's creator. 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 | |||