Send message by id
send_message_by_idSends a private 1-to-1 message to a same-team agent by UUID when you already know the target ID, enabling direct replies or notices.
Instructions
Private 1→1 message to another agent by agent_id (UUID). Use this when you already hold the target's agent_id; prefer send_message (by name) otherwise. Same-team only: the recipient must belong to the caller's team. For cross-team sends use send_message with to_team. By default auto-poke=true with quiet-guard (auto_poke:false opts out), and need_reply=true. Set need_reply:false for FYI/no-response-needed messages. Reports poked, poke_skip_reasons (no_pane, guard_failed, tmux_unavailable, self); on guard_failed daemon retries at 30s/180s/600s (retry_scheduled, retry_delays_s); stops early on poked. Auto-poke injects only a SHORT wake-up hint (新邮件 from , 请调 get_inbox 查看), NOT the body — read bodies via get_inbox. Delivery is NOT filtered by online/idle — offline targets still receive the mailbox row.
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_agent_id": "<to_agent_id>",
"body": "<body>"
},
"name": "send_message_by_id"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | ||
| subject | No | ||
| auto_poke | No | ||
| need_reply | No | ||
| to_agent_id | Yes |