session_send
Send an intent or pointer to another live session or broadcast it to every project session; keep large context in project state and send a reference because payloads cap at 16KB.
Instructions
Send an event to another live session (direct) or to every session in the project (broadcast, by omitting to_session). Events carry intents and pointers, not bulk content: payloads are capped at 16KB, so store large context in project state and send a reference. Delivered once per receiving session, kept for 24h.
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": {
"kind": "<kind>"
},
"name": "session_send"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Short event type, e.g. 'handoff', 'heads-up', 'done', 'request'. | |
| payload | No | Event body (max 16KB). Any string including JSON. | |
| session_id | No | Leave out: events are always sent as this server's own session, and any other id is refused. | |
| to_session | No | Target session id from session_peers; it must be live in this session's project. Omit to broadcast to the whole project. | |
| project_path | No | Defaults to the project this session joined; a different project is refused. |