Enum AgentError 

pub enum AgentError {
    MissingRequiredField {
        field: String,
    },
    ContractViolation {
        message: String,
    },
    HostConfigurationNeeded {
        message: String,
    },
    Classified {
        kind: AgentErrorKind,
        retry: RetryClassification,
        context: Box<ErrorContext>,
        causal_ids: Box<CausalIds>,
    },
}

Enumerates the finite agent error cases. Serialized names are part of the SDK contract; update fixtures when variants change.

Variants

MissingRequiredField

Use this variant when the contract needs to represent missing required field; selecting it has no side effect by itself.

Fields

field: String

Field used by this record or request.

ContractViolation

Use this variant when the contract needs to represent contract violation; selecting it has no side effect by itself.

Fields

message: String

Message used by this record or request.

HostConfigurationNeeded

Use this variant when the contract needs to represent host configuration needed; selecting it has no side effect by itself.

Fields

message: String

Message used by this record or request.

Classified

Use this variant when the contract needs to represent classified; selecting it has no side effect by itself.

Fields

kind: AgentErrorKind

Kind/category for this record, capability, event, or detected resource.

retry: RetryClassification

Retry used by this record or request.

context: Box<ErrorContext>

Context used by this record or request.

causal_ids: Box<CausalIds>

Identifiers used to select or correlate causal values. Use them for typed lookup, filtering, or lineage instead of stringly typed matching.

Implementations

impl AgentError

pub fn new( kind: AgentErrorKind, retry: RetryClassification, message: impl Into<String>, ) -> Self

Creates a new domain::error value with explicit caller-provided inputs. This constructor is data-only and performs no I/O or external side effects.

pub fn kind(&self) -> AgentErrorKind

Builds the kind value. This is data construction and performs no I/O, journal append, event publication, or process work.

pub fn retry(&self) -> RetryClassification

Builds the retry value. This is data construction and performs no I/O, journal append, event publication, or process work.

pub fn context(&self) -> ErrorContext

Builds the context value. This is data construction and performs no I/O, journal append, event publication, or process work.

pub fn causal_ids(&self) -> CausalIds

Builds the causal ids value. This is data construction and performs no I/O, journal append, event publication, or process work.

pub fn with_policy_ref(self, policy_ref: PolicyRef) -> Self

Returns this value with its policy ref setting replaced. The method follows builder-style data construction and does not execute external work.

pub fn with_source(self, source: SourceRef) -> Self

Returns this value with its source setting replaced. The method follows builder-style data construction and does not execute external work.

pub fn with_destination(self, destination: DestinationRef) -> Self

Returns this value with its destination setting replaced. The method follows builder-style data construction and does not execute external work.

pub fn with_subject(self, subject: EntityRef) -> Self

Returns this value with its subject setting replaced. The method follows builder-style data construction and does not execute external work.

pub fn with_causal_ids(self, causal_ids: CausalIds) -> Self

Returns this value with its causal ids setting replaced. The method follows builder-style data construction and does not execute external work.

pub fn missing_required_field(field: impl Into<String>) -> Self

Builds the missing required field value. This is data construction and performs no I/O, journal append, event publication, or process work.

pub fn contract_violation(message: impl Into<String>) -> Self

Builds the contract violation value. This is data construction and performs no I/O, journal append, event publication, or process work.

pub fn host_configuration_needed(message: impl Into<String>) -> Self

Builds the host configuration needed value. This is data construction and performs no I/O, journal append, event publication, or process work.

Trait Implementations

impl Clone for AgentError

fn clone(&self) -> AgentError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentError

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for AgentError

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

Formats the value using the given formatter.

impl Error for AgentError

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.

impl From<TypedOutputError> for AgentError

fn from(error: TypedOutputError) -> Self

Converts to this type from the input type.

impl PartialEq for AgentError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AgentError

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AgentError

impl StructuralPartialEq for AgentError