list_receipts
Query and paginate receipts from SQLite storage with filters like agent, action, status, and more. Sort by timestamp or cost to audit agent activity or generate reports.
Instructions
Query and paginate receipts from local SQLite storage with optional filtering by agent, action, status, environment, type, chain, or tag. Supports sorting by timestamp, cost, or latency. Returns paginated results with total count, page info, and has_next/has_prev flags. Default: 50 receipts per page, sorted by timestamp descending. Use to audit agent activity, generate reports, or find specific receipts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | No | Filter by agent ID (exact match) | |
| action | No | Filter by action name (exact match) | |
| status | No | Filter by status: "pending", "completed", "failed", or "timeout" | |
| environment | No | Filter by environment: "development", "production", "staging", or "test" | |
| receipt_type | No | Filter by type: "action", "verification", "judgment", or "arbitration" | |
| chain_id | No | Filter to receipts in a specific chain | |
| tag | No | Filter to receipts containing this tag | |
| page | No | Page number, starting at 1 (default: 1) | |
| limit | No | Results per page, 1 to 100 (default: 50) | |
| sort | No | Sort field and direction in format "field:asc" or "field:desc" (e.g., "timestamp:desc", "cost_usd:asc") |