Struct ReceiptQuery 

pub struct ReceiptQuery {

    pub capability_id: Option<String>,
    pub tool_server: Option<String>,
    pub tool_name: Option<String>,
    pub outcome: Option<String>,
    pub since: Option<u64>,
    pub until: Option<u64>,
    pub min_cost: Option<u64>,
    pub max_cost: Option<u64>,
    pub cost_currency: Option<String>,
    pub cursor: Option<u64>,
    pub limit: usize,
    pub agent_subject: Option<String>,
    pub tenant_filter: Option<String>,
    pub read_context: Option<ReceiptReadContext>,
}

Query parameters for filtering and paginating tool receipts.

Fields

capability_id: Option<String>

Filter by capability ID (exact match).

tool_server: Option<String>

Filter by tool server name (exact match).

tool_name: Option<String>

Filter by tool name (exact match).

outcome: Option<String>

Filter by decision outcome (maps to decision_kind column: “allow”, “deny”, “cancelled”, “incomplete”).

since: Option<u64>

Include only receipts with timestamp >= since (Unix seconds, inclusive).

until: Option<u64>

Include only receipts with timestamp <= until (Unix seconds, inclusive).

min_cost: Option<u64>

Include only receipts with financial cost_charged >= min_cost (minor units). Receipts without financial metadata are excluded when this filter is set.

max_cost: Option<u64>

Include only receipts with financial cost_charged <= max_cost (minor units). Receipts without financial metadata are excluded when this filter is set.

cost_currency: Option<String>

Currency for cost filters. Required when either cost bound is present.

cursor: Option<u64>

Cursor for forward pagination: return only receipts with seq > cursor (exclusive).

limit: usize

Maximum number of receipts to return per page (capped at MAX_QUERY_LIMIT).

agent_subject: Option<String>

Filter by agent subject public key (hex-encoded Ed25519). Resolved through capability_lineage JOIN – does not replay issuance logs.

tenant_filter: Option<String>

Optional tenant narrowing filter. This is never authority by itself: callers must also provide a matching explicit read_context.

read_context: Option<ReceiptReadContext>

Explicit read context resolved from authenticated authority.

Implementations

impl ReceiptQuery

pub fn validated_cost_currency(&self) -> Result<Option<&str>, String>

pub fn with_read_context(self, read_context: ReceiptReadContext) -> Self

pub fn local_operator_admin(self) -> Self

pub fn authenticated_tenant(self, tenant: impl Into<String>) -> Self

pub fn effective_read_scope(&self) -> Result<EffectiveReceiptReadScope, String>

Trait Implementations

impl Clone for ReceiptQuery

fn clone(&self) -> ReceiptQuery

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ReceiptQuery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ReceiptQuery

fn default() -> ReceiptQuery

Returns the “default value” for a type.