Struct ReclaimGrant 

#[non_exhaustive]
pub struct ReclaimGrant {
    pub execution_id: ExecutionId,
    pub partition_key: PartitionKey,
    pub grant_key: String,
    pub expires_at_ms: u64,
    pub lane_id: LaneId,
}

A lease-reclaim grant issued for an execution in lease_expired_reclaimable or lease_revoked state (RFC-024 §3.1).

Distinct from ResumeGrant: the reclaim grant routes to ff_reclaim_execution (Valkey) / the new-attempt reclaim impl (PG/SQLite), which creates a NEW attempt row and bumps the execution’s lease_reclaim_count. The resume grant, by contrast, re-uses the existing attempt under ff_claim_resumed_execution.

Carries lane_id for symmetry with ResumeGrant — the Lua ff_reclaim_execution needs the lane for key construction, and the consuming worker would otherwise pay a round-trip to recover it from exec_core.

Backend impl bodies ship under PR-D (PG) / PR-E (SQLite) / PR-F (Valkey). This PR lands only the type + trait surface; default crate::engine_backend::EngineBackend::issue_reclaim_grant and crate::engine_backend::EngineBackend::reclaim_execution return crate::engine_error::EngineError::Unavailable until each backend PR wires its real body.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

execution_id: ExecutionId

The execution granted for lease-reclaim.

partition_key: PartitionKey

Opaque partition handle for this execution’s hash-tag slot.

grant_key: String

Backend-scoped grant key (Valkey key / PG+SQLite ff_claim_grant.grant_id).

expires_at_ms: u64

Monotonic ms when the grant expires; unconsumed grants vanish.

lane_id: LaneId

Lane the execution belongs to — needed by ff_reclaim_execution for KEYS[*] construction.

Implementations

impl ReclaimGrant

pub fn new( execution_id: ExecutionId, partition_key: PartitionKey, grant_key: String, expires_at_ms: u64, lane_id: LaneId, ) -> Self

Construct a reclaim grant. Added alongside #[non_exhaustive] per RFC-024 §3.1 + feedback_non_exhaustive_needs_constructor.

pub fn partition(&self) -> Result<Partition, PartitionKeyParseError>

Parse partition_key into a typed crate::partition::Partition.

Trait Implementations

impl Clone for ReclaimGrant

fn clone(&self) -> ReclaimGrant

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReclaimGrant

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

Formats the value using the given formatter.

impl PartialEq for ReclaimGrant

fn eq(&self, other: &ReclaimGrant) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ReclaimGrant

impl StructuralPartialEq for ReclaimGrant