Struct PendingWaitpointInfo 

#[non_exhaustive]
pub struct PendingWaitpointInfo {
    pub waitpoint_id: WaitpointId,
    pub waitpoint_key: String,
    pub state: String,
    pub required_signal_names: Vec<String>,
    pub created_at: TimestampMs,
    pub activated_at: Option<TimestampMs>,
    pub expires_at: Option<TimestampMs>,
    pub execution_id: ExecutionId,
    pub token_kid: String,
    pub token_fingerprint: String,
}

One entry in the read-only view of an execution’s active waitpoints.

Returned by EngineBackend::list_pending_waitpoints (and the GET /v1/executions/{id}/pending-waitpoints REST endpoint).

RFC-017 §8 schema rewrite (Stage D1). This struct no longer carries the raw HMAC waitpoint_token at the trait boundary — the backend emits only the sanitised (token_kid, token_fingerprint) pair. The HTTP handler (see ff-server::api::list_pending_waitpoints) wraps the trait response and re-injects the real token on the v0.7.x wire for one-release deprecation warning; the wire field is removed entirely at v0.8.0.

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.

waitpoint_id: WaitpointId

waitpoint_key: String

state: String

Current waitpoint state: pending, active, closed. Callers typically filter to pending or active.

required_signal_names: Vec<String>

Signal names the resume condition is waiting for. Reviewers that need to drive a specific waitpoint — particularly when multiple concurrent waitpoints exist on one execution — filter on this to pick the right target.

An EMPTY vec means the condition matches any signal (wildcard, per lua/helpers.lua initialize_condition). Callers must not infer “no waitpoint” from empty; check state / length of the outer list for that.

created_at: TimestampMs

Timestamp when the waitpoint record was first written.

activated_at: Option<TimestampMs>

Timestamp when the waitpoint was activated (suspension landed). None while the waitpoint is still pending.

expires_at: Option<TimestampMs>

Scheduled expiration timestamp. None if no timeout configured.

execution_id: ExecutionId

Owning execution — surfaces without a separate lookup.

token_kid: String

HMAC key identifier (the <kid> prefix of the stored waitpoint_token). Safe to expose — identifies which signing key minted the token without revealing the key material.

token_fingerprint: String

16-hex-char (8-byte) fingerprint of the HMAC digest. Audit-friendly handle that correlates across logs without being replayable.

Implementations

impl PendingWaitpointInfo

pub fn new( waitpoint_id: WaitpointId, waitpoint_key: String, state: String, created_at: TimestampMs, execution_id: ExecutionId, token_kid: String, token_fingerprint: String, ) -> Self

Construct a PendingWaitpointInfo with the 7 required fields. Optional fields (activated_at, expires_at) default to None; use Self::with_activated_at / Self::with_expires_at to populate them. required_signal_names defaults to empty (wildcard condition); use Self::with_required_signal_names to set it.

pub fn with_activated_at(self, activated_at: TimestampMs) -> Self

pub fn with_expires_at(self, expires_at: TimestampMs) -> Self

pub fn with_required_signal_names(self, names: Vec<String>) -> Self

Trait Implementations

impl Clone for PendingWaitpointInfo

fn clone(&self) -> PendingWaitpointInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PendingWaitpointInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PendingWaitpointInfo

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PendingWaitpointInfo

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for PendingWaitpointInfo

impl StructuralPartialEq for PendingWaitpointInfo