session_open
Establish an agent session bound to an agent_id and optional workspace_id, returning a session_secret for strict-mode verbs and enabling heartbeat broadcasts.
Instructions
Open a session bound to (agent_id, workspace_id); returns a per-session session_secret (ONLY here - keep it; required by sensitive verbs in strict mode). Heartbeat to receive broadcasts.
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": {
"agent_id": "<agent_id>"
},
"name": "session_open"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | Your agent_id; the session is bound to this identity. REQUIRED. | |
| metadata | No | Free-form JSON object stored with the session (optional). | |
| workspace_id | No | Workspace_id (from workspace_resolve) the session operates in (optional; omit for an unbound session). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||