Struct ReclaimGrant 

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 reclaim grant issued for a resumed (attempt_interrupted) execution.

Issued by a producer (typically ff-scheduler once a Batch-C reclaim scanner is in place; test fixtures in the interim — no production Rust caller exists in-tree today). Consumed by FlowFabricWorker::claim_from_reclaim_grant, which calls ff_claim_resumed_execution atomically: that FCALL validates the grant, consumes it, and transitions attempt_interrupted → started while preserving the existing attempt_index + attempt_id (a resumed execution re-uses its attempt; it does not start a new one).

Mirrors ClaimGrant for the resume path. Differences:

• ClaimGrant is issued against a freshly-eligible execution and ff_claim_execution creates a new attempt.
• ReclaimGrant is issued against an attempt_interrupted execution; ff_claim_resumed_execution re-uses the existing attempt and bumps the lease epoch.

The grant itself is written to the same claim_grant Valkey key that ClaimGrant uses; the distinction is which Lua FCALL consumes it (ff_claim_execution for new attempts, ff_claim_resumed_execution for resumes).

Lane asymmetry with ClaimGrant: ReclaimGrant CARRIES lane_id as a field. The issuing path already knows the lane (it’s read from exec_core at grant time); carrying it here spares the consumer a HGET exec_core lane_id round trip on the hot claim path. The asymmetry is intentional — prefer one-fewer-HGET on a type that already lives with the resumer’s lifecycle over strict handle symmetry with ClaimGrant.

Shared wire-level type between the eventual ff-scheduler producer (Batch-C reclaim scanner — not yet in-tree; test fixtures construct this type today) and ff-sdk (consumer, via FlowFabricWorker::claim_from_reclaim_grant). Lives in ff-core so neither crate needs a dep on the other.

Fields

execution_id: ExecutionId

The execution granted for resumption.

partition_key: PartitionKey

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

Same wire-opacity contract as ClaimGrant::partition_key. Internal consumers call Self::partition for the parsed form.

grant_key: String

Valkey key of the grant hash — same key shape as ClaimGrant.

expires_at_ms: u64

Monotonic ms when the grant expires; unconsumed grants vanish.

lane_id: LaneId

Lane the execution belongs to. Needed by ff_claim_resumed_execution for KEYS[3] (eligible_zset) and KEYS[9] (active_index).

Implementations

impl ReclaimGrant

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

Parse partition_key into a typed crate::partition::Partition. See ClaimGrant::partition for the alias-collapse note.

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