Wait for Handoff
wait_for_handoffLong-poll a Handoff until the human resolves it, it expires, or the bounded timeout elapses. For the onboarding Question returned by activate_agent_inbox, success requires an answered result with activation_completed true; use a bounded local deadline and treat any terminal answer without that stamp as incomplete.
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": {
"handoff_id": "<handoff_id>"
},
"name": "wait_for_handoff"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| timeout | No | Seconds to hold the request open; use 0 for an immediate state read. | |
| handoff_id | Yes | Handoff id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Purpose-built PingRoom result with credential and account fields removed. |