Enum SubAgentError 

pub enum SubAgentError {
    Parse {
        path: String,
        reason: String,
    },
    Invalid(String),
    NotFound(String),
    Spawn(String),
    ConcurrencyLimit {
        active: usize,
        max: usize,
    },
    Cancelled,
    InvalidCommand(String),
    Transcript(String),
    AmbiguousId(String, usize),
    StillRunning(String),
    Memory {
        name: String,
        reason: String,
    },
    Io {
        path: String,
        reason: String,
    },
    Llm(String),
    Channel(String),
    TaskPanic(String),
    MaxDepthExceeded {
        depth: u32,
        max: u32,
    },
}

All errors that can arise during sub-agent lifecycle operations.

SubAgentError is the single error type for the entire zeph-subagent crate. Every fallible public function returns Result<_, SubAgentError>.

Examples

use zeph_subagent::{SubAgentDef, SubAgentError};

let err = SubAgentDef::parse("missing frontmatter").unwrap_err();
assert!(matches!(err, SubAgentError::Parse { .. }));

Variants

Parse

Frontmatter parsing failed (malformed YAML/TOML or missing delimiters).

Fields

path: String

reason: String

Invalid(String)

Definition semantics are invalid (e.g. empty name, conflicting tool policies).

NotFound(String)

No definition or running agent with the requested name or ID was found.

Spawn(String)

The background task could not be spawned (OS or tokio error).

ConcurrencyLimit

The manager’s concurrency limit is exhausted; no new agents can be spawned.

Fields

active: usize

max: usize

Cancelled

The agent loop was cancelled via its tokio_util::sync::CancellationToken.

InvalidCommand(String)

A slash-command string (/agent, /agents) could not be parsed.

Transcript(String)

An I/O operation on a transcript file failed.

AmbiguousId(String, usize)

An ID prefix matched more than one transcript; provide a longer prefix.

StillRunning(String)

Resume was requested for an agent that is still running.

Memory

A memory directory could not be created or resolved.

Fields

name: String

reason: String

Io

A filesystem I/O error unrelated to transcripts.

Fields

path: String

reason: String

Llm(String)

The underlying LLM provider returned an error during the agent loop.

Channel(String)

A channel send (status watch, secret approval) failed.

TaskPanic(String)

The tokio task panicked and the join handle propagated the panic.

MaxDepthExceeded

The recursion depth for nested sub-agent spawning exceeded the configured limit.

Fields

depth: u32

max: u32

Trait Implementations

impl Debug for SubAgentError

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

Formats the value using the given formatter.

impl Display for SubAgentError

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

Formats the value using the given formatter.

impl Error for SubAgentError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.