prompt
Sends a task to an idle agent session, returns any pending approval or question, reopens idle-closed sessions, and blocks until the turn finishes or needs input.
Instructions
Send a task to an IDLE session. In ASKING or QUESTIONING it returns the pending approval or question instead. A session closed for idleness is reopened first. Blocks until the turn is done, needs an approval or asks a question; the server sets no time limit. If your client times out, the turn keeps running and the connection stays: call status for the state and output for the reply instead of sending the task again. Returns "approval_needed" with an approval to answer via approve / allow / reject, or "question_needed" with a question to answer via answer.
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": {
"session": "<session>",
"text": "<text>"
},
"name": "prompt"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| wait | No | Wait for the result (default true). false returns right after sending. | |
| session | Yes | Session id returned by open |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| output | No | ||
| status | Yes | ||
| outcome | No | ||
| turn_id | No | ||
| approval | No | ||
| question | No |