manage_sessions
Establish agent session boundaries and track multi-turn workflows with start, end, list, and bootstrap actions. Returns session records or context snapshots.
Instructions
Manage agent tracking sessions and multi-turn workflow attribution (actions: start, end, list, bootstrap). Use manage_sessions instead of manage_tasks when establishing agent session boundaries and tracking multi-turn workflows rather than individual work items.
Returns session record, bootstrap context snapshot, or active session listing.
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": {
"action": "<action>"
},
"name": "manage_sessions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of sessions to list (1-1000). | |
| action | Yes | The session management action to execute: start, end, list, bootstrap. | |
| project | No | Target project name or slug. | |
| agent_id | No | Agent identifier for session tracking and change attribution. | |
| metadata | No | Arbitrary session metadata. | |
| session_id | No | Unique session identifier for end. | |
| task_limit | No | Maximum runnable tasks to return on bootstrap. | |
| active_only | No | Whether to return only active unclosed sessions on list. |