Struct TurnIdentifiers 

#[non_exhaustive]
pub struct TurnIdentifiers {

    pub turn_id: Option<TurnId>,
    pub conversation_id: Option<ConversationId>,
    pub account_hash: Option<String>,
    pub workflow: Option<WorkflowKey>,
    pub workflow_version: Option<WorkflowVersion>,
    pub case_id: Option<CaseId>,
    pub case_revision: Option<CaseRevision>,
    pub interaction_id: Option<InteractionId>,
    pub provider: Option<String>,
    pub model: Option<String>,
    pub attempt: Option<String>,
    pub plan_hash: Option<Digest>,
    pub command_id: Option<CommandId>,
    pub event_ids: Vec<EventId>,
    pub block_ids: Vec<BlockId>,
    pub outbox_id: Option<OutboxId>,
}

The stable identifiers of one turn (spec §26.1).

Every member is an identifier, a version label or a digest. Build one with TurnIdentifiers::of_turn and fill in what a stage knows, or derive a whole one from a persisted ReplayRecord with TurnIdentifiers::from_replay.

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.

turn_id: Option<TurnId>

The turn.

conversation_id: Option<ConversationId>

The conversation the turn belongs to.

account_hash: Option<String>

Digest of the tenant, from account_hash. Never the raw account id.

workflow: Option<WorkflowKey>

Workflow in force.

workflow_version: Option<WorkflowVersion>

Version of that workflow.

case_id: Option<CaseId>

Case the turn acted on.

case_revision: Option<CaseRevision>

Revision that case was loaded at.

interaction_id: Option<InteractionId>

Interaction created or answered.

provider: Option<String>

Provider key of the model call.

model: Option<String>

Model key of the model call.

attempt: Option<String>

Attempt within the stage.

plan_hash: Option<Digest>

Hash of the accepted, normalized plan.

command_id: Option<CommandId>

Command the event concerns.

event_ids: Vec<EventId>

Events committed by the turn.

block_ids: Vec<BlockId>

Response block ids, in order.

outbox_id: Option<OutboxId>

Outbox row of an external side effect.

Implementations

impl TurnIdentifiers

pub fn of_turn( turn_id: TurnId, conversation_id: ConversationId, account_id: &AccountId, ) -> Self

The identifiers every stage of a turn knows.

pub fn from_replay(record: &ReplayRecord) -> Self

Everything spec §26.1 asks for that a persisted replay record holds.

The workflow, case and interaction taken are the first of each list and the provider attempt the last, which is the one a failure concerns; the full lists stay in the replay record itself.

pub fn fields(&self) -> Vec<(&'static str, String)>

Renders the identifiers as (field name, value) pairs in a stable order, omitting what is not known.

This is the exact set a subscriber sees; it is a plain function so a test can assert on it without standing up a subscriber.

Trait Implementations

impl Clone for TurnIdentifiers

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 TurnIdentifiers

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

Formats the value using the given formatter.

impl Default for TurnIdentifiers

fn default() -> Self

Returns the “default value” for a type.

impl Eq for TurnIdentifiers

impl PartialEq for TurnIdentifiers

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TurnIdentifiers