Struct WorkflowsConfig 

pub struct WorkflowsConfig {
    pub name: Option<String>,
    pub description: Option<String>,
    pub source_file: Option<PathBuf>,
    pub settings: WorkflowSettings,
    pub states: HashMap<String, StateWorkflow>,
    pub phases: HashMap<String, PhaseWorkflow>,
    pub combos: HashMap<String, ComboPrompts>,
    pub gates: HashMap<String, Vec<GateDefinition>>,
    pub named_workflows: HashMap<String, Arc<WorkflowsConfig>>,
    pub default_workflow_key: Option<String>,
}

Unified workflow configuration.

Fields

name: Option<String>

Short identifier for the workflow (e.g., “swarm”, “relay”, “solo”).

description: Option<String>

Human-readable description of the workflow’s coordination model. Should explain when to choose this workflow and how agents coordinate.

source_file: Option<PathBuf>

Path to the source file this workflow was loaded from. Not deserialized from YAML - populated by the loader.

settings: WorkflowSettings

Global workflow settings.

states: HashMap<String, StateWorkflow>

State definitions with transitions, timing, and prompts.

phases: HashMap<String, PhaseWorkflow>

Phase definitions with prompts.

combos: HashMap<String, ComboPrompts>

State+phase combination prompts (key format: “state+phase”).

gates: HashMap<String, Vec<GateDefinition>>

Gate definitions for status and phase exits. Keys are “status:” or “phase:”, values are lists of gate definitions.

named_workflows: HashMap<String, Arc<WorkflowsConfig>>

Cache of named workflow configs (e.g., “swarm” -> workflow-swarm.yaml). Populated at server startup, not serialized.

default_workflow_key: Option<String>

Key to look up the default workflow in named_workflows cache. If set, workers without a workflow use this instead of the base config.

Implementations

impl WorkflowsConfig

pub fn get_named_workflow(&self, name: &str) -> Option<&Arc<WorkflowsConfig>>

Get a named workflow config, or None if not found.

pub fn get_default_workflow(&self) -> Option<&Arc<WorkflowsConfig>>

Get the default workflow config from the cache, if one is configured.

impl WorkflowsConfig

pub fn get_state_enter_prompt(&self, state: &str) -> Option<&str>

Get the enter prompt for a state.

pub fn get_state_exit_prompt(&self, state: &str) -> Option<&str>

Get the exit prompt for a state.

pub fn get_phase_enter_prompt(&self, phase: &str) -> Option<&str>

Get the enter prompt for a phase.

pub fn get_phase_exit_prompt(&self, phase: &str) -> Option<&str>

Get the exit prompt for a phase.

pub fn get_combo_enter_prompt(&self, state: &str, phase: &str) -> Option<&str>

Get the enter prompt for a state+phase combo.

pub fn get_combo_exit_prompt(&self, state: &str, phase: &str) -> Option<&str>

Get the exit prompt for a state+phase combo.

pub fn get_prompt(&self, trigger: &str) -> Option<&str>

Get a prompt by trigger name.

Trigger format:

• enter~{state} - entering a state
• exit~{state} - exiting a state
• enter%{phase} - entering a phase
• exit%{phase} - exiting a phase
• enter~{state}%{phase} - entering a state+phase combo
• exit~{state}%{phase} - exiting a state+phase combo

pub fn list_prompt_triggers(&self) -> Vec<String>

List all available prompt triggers.

pub fn get_status_exit_gates(&self, status: &str) -> Vec<&GateDefinition>

Get exit gates for a status transition. Returns gates defined under “status:” key.

pub fn get_phase_exit_gates(&self, phase: &str) -> Vec<&GateDefinition>

Get exit gates for a phase transition. Returns gates defined under “phase:” key.

Trait Implementations

impl Clone for WorkflowsConfig

fn clone(&self) -> WorkflowsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkflowsConfig

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

Formats the value using the given formatter.

impl Default for WorkflowsConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for WorkflowsConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&WorkflowsConfig> for PhasesConfig

Convert WorkflowsConfig to PhasesConfig for backwards compatibility.

fn from(workflows: &WorkflowsConfig) -> Self

Converts to this type from the input type.

impl From<&WorkflowsConfig> for StatesConfig

Convert WorkflowsConfig to StatesConfig for backwards compatibility.

fn from(workflows: &WorkflowsConfig) -> Self

Converts to this type from the input type.

impl Serialize for WorkflowsConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.