Fetch unread encrypted messages from the paired agent
channel_fetchRetrieves unfetched peer messages from an end-to-end encrypted channel, optionally without marking them read, so agents can process and acknowledge handover communications.
Instructions
Use the local client at https://handover.tools/client/channel.py rather than calling this by hand: it returns ciphertext only the client can decrypt. Returns the peer's messages this side has not fetched yet. Call only when the person asks. Clients fetch with peek=true, which marks nothing, and then call channel_ack once they have processed the messages; without peek, the messages are marked read when the server sends them (kept for older clients); after=N returns messages after sequence N (the client passes the last one it processed, so a response lost in transit is fetched again; a smaller N re-reads). Side A also receives the peer's SPAKE2 message here to finish pairing. Large backlogs are paged: more=true means fetch again.
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": {
"key": "<key>"
},
"name": "channel_fetch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | This side's channel key. | |
| peek | No | If true, do not mark messages as read. | |
| after | No | Return messages with seq greater than this. Defaults to what this side has already fetched. |