Struct Handoff 

pub struct Handoff<S: HandoffState> {
    data: HandoffRecord,
    _state: PhantomData<S>,
}

A handoff with compile-time state tracking.

The type parameter S indicates the current state of the handoff. Methods are only available in appropriate states:

• Handoff<Initiated>: Can be accepted or rejected
• Handoff<HandoffAccepted>: Can be completed
• Handoff<Rejected>: Terminal, no further transitions
• Handoff<HandoffCompleted>: Terminal, no further transitions

Fields

data: HandoffRecord

_state: PhantomData<S>

Implementations

impl<S: HandoffState> Handoff<S>

pub fn data(&self) -> &HandoffRecord

Access the underlying handoff data (read-only).

pub fn handoff_id(&self) -> HandoffId

Get the handoff ID.

pub fn tenant_id(&self) -> TenantId

Get the tenant ID.

pub fn from_agent_id(&self) -> AgentId

Get the source agent ID.

pub fn to_agent_id(&self) -> AgentId

Get the target agent ID.

pub fn trajectory_id(&self) -> TrajectoryId

Get the trajectory ID.

pub fn scope_id(&self) -> ScopeId

Get the scope ID.

pub fn reason(&self) -> &str

Get the handoff reason.

pub fn context_snapshot(&self) -> &[u8]

Get the context snapshot.

pub fn created_at(&self) -> Timestamp

Get when the handoff was created.

pub fn into_data(self) -> HandoffRecord

Consume and return the underlying data (for serialization).

impl Handoff<Initiated>

pub fn new(data: HandoffRecord) -> Self

Create a new initiated handoff.

pub fn accept(self, accepted_at: Timestamp) -> Handoff<HandoffAccepted>

Accept the handoff.

Transitions to Handoff<HandoffAccepted>. Consumes the current handoff.

pub fn reject(self, reason: String) -> Handoff<Rejected>

Reject the handoff.

Transitions to Handoff<Rejected> (terminal state). Consumes the current handoff.

impl Handoff<HandoffAccepted>

pub fn accepted_at(&self) -> Timestamp

Get when the handoff was accepted.

pub fn complete(self, completed_at: Timestamp) -> Handoff<HandoffCompleted>

Complete the handoff.

Transitions to Handoff<HandoffCompleted> (terminal state). Consumes the current handoff.

impl Handoff<Rejected>

pub fn rejection_reason(&self) -> &str

Get the rejection reason.

impl Handoff<HandoffCompleted>

pub fn accepted_at(&self) -> Timestamp

Get when the handoff was accepted.

pub fn completed_at(&self) -> Timestamp

Get when the handoff was completed.

Trait Implementations

impl<S: Clone + HandoffState> Clone for Handoff<S>

fn clone(&self) -> Handoff<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + HandoffState> Debug for Handoff<S>

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

Formats the value using the given formatter.