manage_session
Create, checkpoint, or restore agent sessions to save and reload working memory, goals, and progress across conversations.
Instructions
Manage sessions for checkpoint/restore of agent state across conversations.
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_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | checkpoint: agent state to save as JSON string (working memory, goals, progress, etc.). Required. | |
| action | Yes | 'create' a session, 'checkpoint' agent state into it, or 'restore' saved state. | |
| agent_id | No | create: agent running this session. | |
| metadata | No | create: session metadata as JSON string. | |
| session_id | No | Session UUID. Required for checkpoint/restore; optional for create (None = auto-generate). | |
| checkpoint_id | No | restore: specific checkpoint ID. None = latest checkpoint. | |
| parent_session_id | No | create: parent session ID for forked sessions. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||