Struct Delegation 

pub struct Delegation<S: DelegationState> {
    data: DelegationRecord,
    _state: PhantomData<S>,
}

A delegation with compile-time state tracking.

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

• Delegation<Pending>: Can be accepted, rejected, or timeout
• Delegation<DelegationAccepted>: Can be started or fail
• Delegation<InProgress>: Can be completed or fail
• Delegation<DelegationCompleted>: Terminal, has result
• Delegation<DelegationRejected>: Terminal
• Delegation<DelegationFailed>: Terminal, has failure reason

Fields

data: DelegationRecord

_state: PhantomData<S>

Implementations

impl<S: DelegationState> Delegation<S>

pub fn data(&self) -> &DelegationRecord

Access the underlying delegation data (read-only).

pub fn delegation_id(&self) -> DelegationId

Get the delegation ID.

pub fn tenant_id(&self) -> TenantId

Get the tenant ID.

pub fn from_agent_id(&self) -> AgentId

Get the delegating agent ID.

pub fn to_agent_id(&self) -> AgentId

Get the delegate agent ID.

pub fn trajectory_id(&self) -> TrajectoryId

Get the trajectory ID.

pub fn scope_id(&self) -> ScopeId

Get the scope ID.

pub fn task_description(&self) -> &str

Get the task description.

pub fn created_at(&self) -> Timestamp

Get when the delegation was created.

pub fn expected_completion(&self) -> Option<Timestamp>

Get the expected completion time.

pub fn context(&self) -> Option<&Value>

Get the context.

pub fn into_data(self) -> DelegationRecord

Consume and return the underlying data (for serialization).

impl Delegation<Pending>

pub fn new(data: DelegationRecord) -> Self

Create a new pending delegation.

pub fn accept(self, accepted_at: Timestamp) -> Delegation<DelegationAccepted>

Accept the delegation.

Transitions to Delegation<DelegationAccepted>. Consumes the current delegation.

pub fn reject(self, reason: String) -> Delegation<DelegationRejected>

Reject the delegation.

Transitions to Delegation<DelegationRejected> (terminal state). Consumes the current delegation.

pub fn fail(self, reason: String) -> Delegation<DelegationFailed>

Mark the delegation as failed (e.g., timeout).

Transitions to Delegation<DelegationFailed> (terminal state). Consumes the current delegation.

impl Delegation<DelegationAccepted>

pub fn accepted_at(&self) -> Timestamp

Get when the delegation was accepted.

pub fn start(self, started_at: Timestamp) -> Delegation<InProgress>

Start working on the delegation.

Transitions to Delegation<InProgress>. Consumes the current delegation.

pub fn fail(self, reason: String) -> Delegation<DelegationFailed>

Mark the delegation as failed before starting.

Transitions to Delegation<DelegationFailed> (terminal state). Consumes the current delegation.

impl Delegation<InProgress>

pub fn accepted_at(&self) -> Timestamp

Get when the delegation was accepted.

pub fn started_at(&self) -> Timestamp

Get when work started.

pub fn complete( self, completed_at: Timestamp, result: DelegationResult, ) -> Delegation<DelegationCompleted>

Complete the delegation with a result.

Transitions to Delegation<DelegationCompleted> (terminal state). Consumes the current delegation.

pub fn fail(self, reason: String) -> Delegation<DelegationFailed>

Mark the delegation as failed during execution.

Transitions to Delegation<DelegationFailed> (terminal state). Consumes the current delegation.

impl Delegation<DelegationCompleted>

pub fn accepted_at(&self) -> Timestamp

Get when the delegation was accepted.

pub fn started_at(&self) -> Timestamp

Get when work started.

pub fn completed_at(&self) -> Timestamp

Get when the delegation was completed.

pub fn result(&self) -> &DelegationResult

Get the delegation result.

impl Delegation<DelegationRejected>

pub fn rejection_reason(&self) -> &str

Get the rejection reason.

impl Delegation<DelegationFailed>

pub fn failure_reason(&self) -> &str

Get the failure reason.

Trait Implementations

impl<S: Clone + DelegationState> Clone for Delegation<S>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + DelegationState> Debug for Delegation<S>

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

Formats the value using the given formatter.