Struct ResumeGrant 

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

A resume 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_resume_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).

Naming history (RFC-024). This type was historically called ReclaimGrant, but its semantic has always been resume-after- suspend (the routing FCALL is ff_claim_resumed_execution, not ff_reclaim_execution). RFC-024 PR-A renamed the type to ResumeGrant — the name now matches the semantic. RFC-024 PR-B+C dropped the transitional ReclaimGrant = ResumeGrant alias and introduced a distinct new ReclaimGrant for the lease-reclaim path (reclaim_execution / ff_reclaim_execution).

Mirrors ClaimGrant for the resume path. Differences:

• ClaimGrant is issued against a freshly-eligible execution and ff_claim_execution creates a new attempt.
• ResumeGrant 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: ResumeGrant 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_resume_grant). Lives in ff-core so neither crate needs a dep on the other.

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 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 ResumeGrant

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

Construct a resume 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. See ClaimGrant::partition for the alias-collapse note.

Trait Implementations

impl Clone for ResumeGrant

fn clone(&self) -> ResumeGrant

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResumeGrant

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

Formats the value using the given formatter.

impl PartialEq for ResumeGrant

fn eq(&self, other: &ResumeGrant) -> 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 ResumeGrant

impl StructuralPartialEq for ResumeGrant