Struct HandoffRequest 

pub struct HandoffRequest {
    pub call_id: String,
    pub child_agent_id: String,
    pub reason: String,
    pub max_carry: usize,
    pub carried_context: Vec<Message>,
}

Parsed __handoff_to arguments, surfaced as crate::TurnResult::handoff.

The control plane consumes this to:

1. Slice the parent’s transcript per HandoffRequest::carried_context (the agent crate has already done the slicing).
2. Sign-and-write a Handoff event to the parent’s eventlog partition.
3. Create the child Conversation resource.

Fields

call_id: String

Tool-call id the provider assigned to the __handoff_to call. Echoed back to the provider on the parent’s next turn as the tool_result id, so the function-calling loop on the parent’s resumed turn sees a matched call → result pair (otherwise the provider rejects the turn for a dangling call).

child_agent_id: String

The model’s chosen child agent identifier.

reason: String

Optional free-form reason captured for operator visibility.

max_carry: usize

Sliding-window cap on the carried transcript. The runtime applies it against the current turn’s transcript when packaging the handoff.

carried_context: Vec<Message>

The pre-sliced carried transcript — the last max_carry messages of the parent’s transcript at the moment of the handoff call. Stored as llm messages; the control plane maps them to wire Messages on the way into the Handoff event payload.

Trait Implementations

impl Clone for HandoffRequest

fn clone(&self) -> HandoffRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HandoffRequest

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

Formats the value using the given formatter.