crystal_extension_comms
Send messages and inspect inboxes, outboxes, and audit logs within a crystal's comms boundary. Use it to route agent messages, acknowledge and drain inbox items, or pull mailbox stats.
Instructions
Send messages or inspect inboxes/outboxes/audit logs via the embedded Crystal Comms extension.
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": "crystal_extension_comms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | List of recipient IDs (or single '@all', '@channel', 'grp_*') for send | |
| ack | No | When true, automatically acknowledges and drains listed inbox messages (for list, default: false) | |
| body | No | Message body text / payload (for send) | |
| from | No | Sender entity ID (required for send; optional outbox filter for list) | |
| inbox | No | Recipient entity ID to inspect inbox (for list/clear/ack) | |
| limit | No | Maximum messages to return (for list) | |
| action | Yes | Action: send, list, ack (drain message), clear (drain inbox), or stats (mailbox metrics) | |
| outbox | No | Sender entity ID to inspect outbox (for list) | |
| channel | No | Topic channel (default: 'general') | |
| subject | No | Message subject line (for send) | |
| reply_to | No | Optional causal parent message ID | |
| crystal_id | No | Target crystal ID providing the comms boundary (optional for cave-wide stats) | |
| message_id | No | Message ID to acknowledge and drain from inbox (for ack) | |
| record_dag | No | When true, records the message as a causal DAG transition node in the crystal (default: false) | |
| json_output | No | Return JSON array of CommsMessage objects (default: false) |