Enum DciError 

#[non_exhaustive]
pub enum DciError {
    InvalidRoot {
        path: PathBuf,
        reason: String,
    },
    PathEscape {
        requested: String,
    },
    NotFound {
        requested: String,
    },
    InvalidPattern(String),
    InvalidGlob {
        glob: String,
        reason: String,
    },
    Timeout {
        millis: u64,
    },
    Io {
        path: PathBuf,
        source: Error,
    },
    Worker(String),
}

Errors produced by corpus-interaction operations.

These are surfaced to the agent as tool-call errors, so their Display text is written to be intelligible to a language model deciding what to do next (e.g. “path escapes the corpus root” tells it to pick a path inside the corpus).

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.

InvalidRoot

The corpus root could not be established (missing, not a directory, or not canonicalizable).

Fields

path: PathBuf

The offending path.

reason: String

Human-readable reason.

PathEscape

A requested path resolved outside the corpus root (path traversal or a symlink escaping the jail).

Fields

requested: String

The path the caller asked for.

NotFound

A requested path does not exist inside the corpus.

Fields

requested: String

The path the caller asked for.

InvalidPattern(String)

The caller supplied an invalid regular expression.

InvalidGlob

The caller supplied an invalid glob.

Fields

glob: String

The offending glob.

reason: String

Why it failed to compile.

Timeout

An operation exceeded its time budget.

Fields

millis: u64

The configured budget in milliseconds.

Io

An underlying I/O failure.

Fields

path: PathBuf

The path being operated on, if known.

source: Error

The underlying error.

Worker(String)

A background worker task failed to complete (runtime/cancellation).

Trait Implementations

impl Debug for DciError

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

Formats the value using the given formatter.

impl Display for DciError

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

Formats the value using the given formatter.

impl Error for DciError

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.