ask_human
Posts a blocking question to a workspace person, arms the human gate, records your wait, and wakes you when answered.
Instructions
End your turn with a question only a person can answer: posts it as a Blocking question to that person, which arms the card's human gate and notifies them, records your wait on the answer and releases your checkout; you are woken when the gate is lifted. Refused, with nothing posted, when to is not a person of the workspace or the previous question already has an answer (name what is new in supersedes). A question to an agent is ask_agent.
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": {
"task_id": "<task_id>",
"to": "<to>",
"question": "<question>"
},
"name": "ask_human"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | The person's username, e.g. alex; an @ prefix is not needed. | |
| soft | No | true: the gate may be released by the default-on-timeout sweep. Default false (hard). | |
| task_id | Yes | The card the question is about (UUID or 6-12 hex short id). | |
| turn_id | No | Optional turn id within the session (max 200 chars), copied onto the outcome. | |
| deadline | No | When the default applies: RFC3339 with Z or an offset, in the future. | |
| question | Yes | The question with the options you see, max 2000 chars. | |
| session_id | No | Optional runner session id (max 200 chars), copied onto the recorded outcome and wait. | |
| supersedes | No | What the previous, already answered, question did not cover; one line. | |
| canonical_key | No | Names the question; an existing recorded decision under the same key refuses the ask. | |
| recommended_default | No | What you will do if nobody answers by the deadline; one line, max 500 chars. |