set_session_control
Change a session's control mode to suspended or manual_handoff to bypass the agent loop for new messages, or engaged to resume normal operation.
Instructions
Change a session's control_mode (engaged, suspended, manual_handoff). When ≠ engaged, the agent loop is bypassed for new messages on that session
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_id": "<session_id>",
"mode": "<mode>"
},
"name": "set_session_control"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | engaged resumes normal operation; suspended pauses; manual_handoff transfers control to a human | |
| reason | No | Optional audit reason | |
| message | No | Optional fixed response. Empty means a silent acknowledgement. Applies only when mode is not engaged. | |
| expires_at | No | Optional expiry (ISO 8601 with timezone, for example 2026-10-05T12:00:00Z; at most 30 days) for suspended/manual_handoff mode. At expiry, the session returns to engaged automatically. Omitted means no expiry; another call without expires_at CLEARS the previous expiry. Repeat it to change only the message. | |
| session_id | Yes | Session session_id string or UUID |