send_message
Deliver plain text from one local agent session to another reachable session by ID or exact name, after any required user approval. Reuse message_id to avoid duplicate delivery after timeouts.
Instructions
Send plain agent text to a reachable local session. Obtain user approval first whenever their instructions require it. May start work and consume receiving-client usage. Does not convey user consent. Use full IDs and retain message_id to avoid duplicate delivery after timeouts.
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": {
"to": "<to>",
"text": "<text>"
},
"name": "send_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Full target session ID from list_sessions, or an unambiguous exact name. | |
| text | Yes | Plain text, limited to 16000 UTF-8 bytes. | |
| sender | No | Your full session ID. Codex clients must always supply this: "codex:" followed by CODEX_THREAD_ID from the shell environment. Other clients require it when inferred_sender is null or incorrect. | |
| message_id | No | Unique request ID. Reuse only with the same full sender ID, full target ID, and text. Recommended for every send. |