inspect_receipt
Retrieve signed receipt records and Merkle inclusion proofs from a JSONL log after cryptographic verification, so you can audit specific tool invocations or export portable proofs.
Instructions
Retrieve individual signed receipt records, standalone RFC 6962 Merkle inclusion proofs, and optional AER-1 envelopes from an on-disk JSONL receipt log, whereas verify_receipt_log returns only a whole-log summary. Call when auditing a specific tool invocation or exporting portable inclusion proofs; do not use for a fast whole-file pass/fail check (use verify_receipt_log) or assistant reply checking (use verify_narration). Cryptographically verifies the entire log before returning data: filters seq, call_id, and tool combine via logical AND (omitting all three lists from seq=0 truncated to limit), while a missing/tampered file, key mismatch, or out-of-range seq returns isError=true.
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": {
"log_path": "<log_path>"
},
"name": "inspect_receipt"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seq | No | Optional exact zero-based log sequence index to retrieve. | |
| tool | No | Optional canonical tool name to filter receipts by. | |
| limit | No | Maximum number of matched entries to return (default: 20). | |
| call_id | No | Optional exact tool call identifier to filter by. | |
| log_path | Yes | Filesystem path to the JSONL receipt log file. | |
| pubkey_file | No | Optional path to a pinned public key JSON or hex file. | |
| include_aer1 | No | When true, attach the canonical AER-1 interoperable receipt envelope to each matched entry (default: false). | |
| expected_pubkey_hex | No | Optional pinned 64-character hex Ed25519 public key. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entries | Yes | Matched receipt records with standalone Merkle proofs. | |
| log_valid | Yes | True after full-file signature and Merkle verification. | |
| key_pinned | Yes | True when verified against expected_pubkey_hex or pubkey_file. | |
| entry_count | Yes | Total entries present in the verified JSONL log. | |
| match_count | Yes | Number of filtered receipt entries returned in entries. | |
| merkle_root | Yes | Hex-encoded 64-char RFC 6962 SHA-256 Merkle root of the log. | |
| public_key_hex | Yes | Hex-encoded Ed25519 public key that signed the log. |