Struct Invocation 

pub struct Invocation {
    pub targets: Vec<Target>,
    pub context: ContextScope,
    pub join: Join,
    pub executor: ExecutorHint,
    pub tools: ToolPolicy,
}

One agent dispatch — synchronous or asynchronous, single or fan-out, local or remote. The orchestrator validates this at the entry point and then stamps the resolved fields onto the child task row(s).

Fields

targets: Vec<Target>

1..N targets. Join::Single requires exactly 1; the others accept any positive count.

context: ContextScope

What the child task sees on its first turn.

join: Join

How the parent waits.

executor: ExecutorHint

Which orchestrator runs the agent loop. Auto resolves at invocation time from (agent.runtime ∩ caller.runtime ∩ available runners). Force is for tests and debugging.

tools: ToolPolicy

Tool inheritance policy for the child. Defaults to Inherit (external = ["*"] — child borrows the parent session’s full external tool pool, like claude-code’s useExactTools).

Implementations

impl Invocation

pub fn validate(&self) -> Result<(), InvocationValidationError>

One-shot validation called at the orchestrator’s entry point. Downstream code can assume the invariants below hold:

• targets.len() >= 1
• Join::Single ⇒ targets.len() == 1
• every target has a non-empty agent identity

impl Invocation

pub fn single(target: Target) -> Self

Build a Join::Single invocation. The simplest path; matches today’s default call_agent({agent, prompt}).

pub fn all(targets: Vec<Target>) -> Self

Build a Join::All fan-out.

pub fn detached(targets: Vec<Target>) -> Self

Build a Join::Detached fire-and-forget. Cancellation cascades from the parent (no opt-out yet).

pub fn with_context(self, context: ContextScope) -> Self

Builder: set context scope.

pub fn with_executor(self, executor: ExecutorHint) -> Self

Builder: set executor hint.

pub fn with_tools(self, tools: ToolPolicy) -> Self

Builder: set tool policy.

Trait Implementations

impl Clone for Invocation

fn clone(&self) -> Invocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Invocation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Invocation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Invocation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.