Enum DelegationMode 

#[non_exhaustive]
pub enum DelegationMode {
    Disabled,
    ExplicitRequestOnly,
    Proactive,
}

Tri-state control over whether the main agent may spawn sub-agents, and who may trigger it (spec 042-subagent-delegation-mode-parity, issue #5857).

Orthogonal to SubAgentConfig::enabled, which remains the outer kill switch: when enabled = false, the effective mode is always DelegationMode::Disabled regardless of this field’s value (FR-002). Also orthogonal to PermissionMode — that governs what a spawned sub-agent may do; this governs whether a spawn may happen at all and who may trigger it.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Disabled

No spawn may proceed from any code path (slash command, orchestration planner/scheduler, scheduled task). Read-only operations (/agent list, definition inspection, status queries) remain available.

ExplicitRequestOnly

Only spawns attributable to a direct, explicit user action (e.g. /agent spawn) are permitted; spawns originating from autonomous planner/scheduler decision-making are rejected.

Proactive

Both explicit and autonomous spawn paths are permitted, subject to the pre-existing constraints (max_concurrent, max_spawn_depth, permission grants, worktree isolation). Matches the subsystem’s behavior prior to this field’s introduction.

Implementations

impl DelegationMode

pub fn permits_explicit(self) -> bool

Whether a spawn/resume attempt attributable to a direct, explicit user action (e.g. /agent spawn, /agent resume, /subagent spawn) is permitted under this mode.

Expressed as an allow-list (Proactive and ExplicitRequestOnly match; every other value, including any future #[non_exhaustive] variant, does not) rather than a deny-list (self != Disabled), so it fails closed automatically on a variant this crate doesn’t yet recognize instead of silently permitting it. Shared by every origin-agnostic “is this explicit action even allowed at all” check — the ACP /subagent spawn gate and SubAgentManager::resume — so the two enforcement points cannot drift out of sync with each other. Does not cover Autonomous-origin spawns; SubAgentManager::spawn’s own origin-aware gate handles that distinction directly.

Examples

use zeph_config::DelegationMode;

assert!(DelegationMode::Proactive.permits_explicit());
assert!(DelegationMode::ExplicitRequestOnly.permits_explicit());
assert!(!DelegationMode::Disabled.permits_explicit());

Trait Implementations

impl Clone for DelegationMode

fn clone(&self) -> DelegationMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DelegationMode

impl Debug for DelegationMode

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

Formats the value using the given formatter.

impl Default for DelegationMode

fn default() -> DelegationMode

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DelegationMode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for DelegationMode

impl PartialEq for DelegationMode

fn eq(&self, other: &DelegationMode) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for DelegationMode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DelegationMode