Struct StateDefinition 

pub struct StateDefinition {

    pub prompt: Option<String>,
    pub prompt_mode: PromptMode,
    pub llm: Option<String>,
    pub skills: Vec<String>,
    pub tools: Option<Vec<ToolRef>>,
    pub transitions: Vec<Transition>,
    pub max_turns: Option<u32>,
    pub timeout_to: Option<String>,
    pub initial: Option<String>,
    pub states: Option<HashMap<String, StateDefinition>>,
    pub inherit_parent: bool,
    pub on_enter: Vec<StateAction>,
    pub on_reenter: Vec<StateAction>,
    pub on_exit: Vec<StateAction>,
    pub regenerate_on_enter: Option<bool>,
    pub extract: Vec<ContextExtractor>,
    pub reasoning: Option<ReasoningConfig>,
    pub reflection: Option<ReflectionConfig>,
    pub disambiguation: Option<StateDisambiguationOverride>,
    pub process: Option<ProcessConfig>,
    pub delegate: Option<String>,
    pub delegate_context: Option<DelegateContextMode>,
    pub concurrent: Option<ConcurrentStateConfig>,
    pub group_chat: Option<GroupChatStateConfig>,
    pub pipeline: Option<PipelineStateConfig>,
    pub handoff: Option<HandoffStateConfig>,
}

Fields

prompt: Option<String>

prompt_mode: PromptMode

llm: Option<String>

skills: Vec<String>

tools: Option<Vec<ToolRef>>

Tool availability for this state.

• None (omitted in YAML): inherit from parent or agent-level tools
• Some([]) (tools: [] in YAML): explicitly no tools available
• Some([...]): only these tools available

transitions: Vec<Transition>

max_turns: Option<u32>

timeout_to: Option<String>

initial: Option<String>

states: Option<HashMap<String, StateDefinition>>

inherit_parent: bool

on_enter: Vec<StateAction>

on_reenter: Vec<StateAction>

Actions on re-entering a previously visited state. Falls back to on_enter if empty.

on_exit: Vec<StateAction>

regenerate_on_enter: Option<bool>

Per-state override: skip re-generation on entering this state.

extract: Vec<ContextExtractor>

Context extractors: pull structured data from user input into context.

reasoning: Option<ReasoningConfig>

reflection: Option<ReflectionConfig>

disambiguation: Option<StateDisambiguationOverride>

process: Option<ProcessConfig>

Per-state process pipeline override (replaces agent-level pipeline for this state).

delegate: Option<String>

Delegate state messages to a registry agent by ID.

delegate_context: Option<DelegateContextMode>

Context mode for delegated states.

concurrent: Option<ConcurrentStateConfig>

Run multiple registry agents concurrently in this state.

group_chat: Option<GroupChatStateConfig>

Run a multi-agent group chat in this state.

pipeline: Option<PipelineStateConfig>

Run a sequential agent pipeline in this state.

handoff: Option<HandoffStateConfig>

Run an LLM-directed handoff chain in this state.

Implementations

impl StateDefinition

pub fn has_sub_states(&self) -> bool

pub fn get_effective_tools<'a>( &'a self, parent: Option<&'a StateDefinition>, ) -> Option<Vec<&'a ToolRef>>

pub fn get_effective_skills<'a>( &'a self, parent: Option<&'a StateDefinition>, ) -> Vec<&'a String>

Trait Implementations

impl Clone for StateDefinition

fn clone(&self) -> StateDefinition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateDefinition

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

Formats the value using the given formatter.

impl Default for StateDefinition

fn default() -> StateDefinition

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StateDefinition

fn deserialize<__D>( __deserializer: __D, ) -> Result<StateDefinition, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StateDefinition

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

where __S: Serializer,

Serialize this value into the given Serde serializer.