inbox_peek
Triage pending unread and in-flight messages without consuming them. Returns read-only envelopes with previews and sizes by default; opt in to full bodies or parked messages.
Instructions
Triage pending messages (unread + in-flight) WITHOUT consuming. READ-ONLY, envelope-only by default (body_preview + body_bytes). include_parked/include_bodies opt in.
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": "inbox_peek"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max messages to return (optional; default 50, max 200; must be a positive integer). | |
| profile | No | Response size profile - one of: default, summary, full (optional; summary trims per-call tokens). | |
| agent_id | Yes | Your agent_id - the GLOBAL inbox to read (a direct message reaches you in any workspace). REQUIRED. | |
| include_bodies | No | Return the FULL body instead of the envelope-only body_preview (first 200 chars) + body_bytes (optional; default false; inbox_pull is the way to consume a message). | |
| include_parked | No | Also show parked (dead-letter) messages that exhausted redelivery (optional; default false). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||