Struct Interaction 

pub struct Interaction {

    pub id: InteractionId,
    pub account_id: AccountId,
    pub conversation_id: ConversationId,
    pub case_ref: CaseRef,
    pub created_by_turn: TurnId,
    pub kind: InteractionKind,
    pub blocking: bool,
    pub payload: InteractionPayload,
    pub payload_hash: Digest,
    pub status: InteractionStatus,
    pub revision_independent: bool,
    pub text_resolution: TextResolutionPolicy,
    pub confirms_risk: RiskClass,
    pub created_at: DateTime<Utc>,
    pub expires_at: Option<DateTime<Utc>>,
    pub resolved_at: Option<DateTime<Utc>>,
    pub resolved_option_id: Option<OptionId>,
}

A persisted interaction (spec §15.1).

Fields

id: InteractionId

Identifier.

account_id: AccountId

Owning tenant.

conversation_id: ConversationId

Owning conversation.

case_ref: CaseRef

Case and the revision the card was rendered against (the bound revision).

created_by_turn: TurnId

Turn that created it.

kind: InteractionKind

Shape.

blocking: bool

Whether it owns unqualified answers for the case.

payload: InteractionPayload

Immutable content.

payload_hash: Digest

Hash of payload at creation.

status: InteractionStatus

Lifecycle status.

revision_independent: bool

true when a revision change does not invalidate it.

text_resolution: TextResolutionPolicy

Whether typed text may resolve it.

confirms_risk: RiskClass

Highest risk class of the commands an answer authorizes. Conservative (RiskClass::Irreversible) when a stored record predates the field.

created_at: DateTime<Utc>

Creation time.

expires_at: Option<DateTime<Utc>>

Expiry, if any.

resolved_at: Option<DateTime<Utc>>

Resolution time, if resolved.

resolved_option_id: Option<OptionId>

Option chosen, if resolved.

Implementations

impl Interaction

pub fn from_spec( spec: InteractionSpec, id: InteractionId, account_id: AccountId, conversation_id: ConversationId, created_by_turn: TurnId, now: DateTime<Utc>, ) -> Result<Self, InteractionError>

Materializes a spec into a new Active interaction, computing the payload hash and the expiry.

Fails closed: a card that cannot be answered (InteractionSpec::validate) or whose time to live cannot be applied is never persisted. Silently dropping an out-of-range TTL would produce a card that never expires, which is a fail-open on a safety timeout.

pub fn bound_revision(&self) -> Option<CaseRevision>

The revision the card is bound to, or None when revision independent.

pub fn is_expired(&self, now: DateTime<Utc>) -> bool

Returns true when now is past the expiry.

pub fn verify_payload_hash(&self) -> Result<bool, HashError>

Recomputes the payload hash and compares it with the stored one.

pub fn transition( &mut self, to: InteractionStatus, ) -> Result<(), InteractionError>

Applies a status transition, refusing illegal ones.

pub fn begin_resolution( &mut self, option_id: OptionId, now: DateTime<Utc>, ) -> Result<(), InteractionError>

Records the chosen option and moves to Resolving.

pub fn view(&self) -> InteractionView

The client-facing projection without server actions.

Trait Implementations

impl Clone for Interaction

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Interaction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Interaction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Interaction

impl PartialEq for Interaction

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Interaction

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Interaction