Struct OrchestrationConfig 

pub struct OrchestrationConfig {

    pub enabled: bool,
    pub max_tasks: u32,
    pub max_parallel: u32,
    pub default_failure_strategy: String,
    pub default_max_retries: u32,
    pub task_timeout_secs: u64,
    pub planner_provider: ProviderName,
    pub planner_max_tokens: u32,
    pub dependency_context_budget: usize,
    pub confirm_before_execute: bool,
    pub aggregator_max_tokens: u32,
    pub deferral_backoff_ms: u64,
    pub plan_cache: PlanCacheConfig,
    pub topology_selection: bool,
    pub verify_provider: ProviderName,
    pub verify_max_tokens: u32,
    pub max_replans: u32,
    pub verify_completeness: bool,
    pub tool_provider: ProviderName,
    pub completeness_threshold: f32,
    pub cascade_routing: bool,
    pub cascade_failure_threshold: f32,
    pub tree_optimized_dispatch: bool,
}

Configuration for the task orchestration subsystem ([orchestration] TOML section).

Fields

enabled: bool

Enable the orchestration subsystem.

max_tasks: u32

Maximum number of tasks in a single graph.

max_parallel: u32

Maximum number of tasks that can run in parallel.

default_failure_strategy: String

Default failure strategy for all tasks unless overridden per-task.

default_max_retries: u32

Default number of retries for the retry failure strategy.

task_timeout_secs: u64

Timeout in seconds for a single task. 0 means no timeout.

planner_provider: ProviderName

Provider name from [[llm.providers]] for planning LLM calls. Empty string = use the agent’s primary provider.

planner_max_tokens: u32

Maximum tokens budget hint for planner responses. Reserved for future use when per-call token limits are added to the LlmProvider::chat API.

dependency_context_budget: usize

Total character budget for cross-task dependency context injection.

confirm_before_execute: bool

Whether to show a confirmation prompt before executing a plan.

aggregator_max_tokens: u32

Maximum tokens budget for aggregation LLM calls. Default: 4096.

deferral_backoff_ms: u64

Base backoff for ConcurrencyLimit retries; grows exponentially (×2 each attempt) up to 5 s.

plan_cache: PlanCacheConfig

Plan template caching configuration.

topology_selection: bool

Enable topology-aware concurrency selection. When true, TopologyClassifier adjusts max_parallel based on the DAG structure. Default: false (opt-in).

verify_provider: ProviderName

Provider name from [[llm.providers]] for verification LLM calls. Empty string = use the agent’s primary provider. Should be a cheap/fast provider.

verify_max_tokens: u32

Maximum tokens budget for verification LLM calls. Default: 1024.

max_replans: u32

Maximum number of replan cycles per graph execution. Default: 2.

Prevents infinite verify-replan loops. 0 = disable replan (verification still runs, gaps are logged only).

verify_completeness: bool

Enable post-task completeness verification. Default: false (opt-in).

When true, completed tasks are evaluated by PlanVerifier. Task stays Completed during verification; downstream tasks are unblocked immediately. Verification is best-effort and does not gate dispatch.

tool_provider: ProviderName

Provider name from [[llm.providers]] for tool-dispatch routing. When set, tool-heavy tasks prefer this provider over the primary. Prefer mid-tier models (e.g., qwen2.5:14b) for reliability per arXiv:2601.16280. Empty string = use the primary provider.

completeness_threshold: f32

Minimum completeness score (0.0–1.0) for the plan to be accepted without replanning. Default: 0.7. When the verifier reports confidence < completeness_threshold AND gaps exist, a replan cycle is triggered. Used by both per-task and whole-plan verification. Values outside [0.0, 1.0] are rejected at startup by Config::validate().

cascade_routing: bool

Enable cascade-aware routing for Mixed-topology DAGs. Requires topology_selection = true. When enabled, tasks in failing subtrees are deprioritized in favour of healthy branches. Default: false (opt-in).

cascade_failure_threshold: f32

Failure rate threshold (0.0–1.0) above which a DAG region is considered “cascading”. Must be in (0.0, 1.0]. Default: 0.5.

tree_optimized_dispatch: bool

Enable tree-optimized dispatch for FanOut/FanIn topologies. Sorts the ready queue by critical-path distance (deepest tasks first) to minimize end-to-end latency. Default: false (opt-in).

Trait Implementations

impl Clone for OrchestrationConfig

fn clone(&self) -> OrchestrationConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OrchestrationConfig

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

Formats the value using the given formatter.

impl Default for OrchestrationConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OrchestrationConfig

where OrchestrationConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for OrchestrationConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.