Enum ErrorData 

pub enum ErrorData {
    InvalidCommand {
        message: String,
    },
    CommandNotFound {
        command_id: String,
    },
    CommandTargetNotFound {
        resource_id: String,
        deployment_id: String,
    },
    CommandTargetAmbiguous {
        deployment_id: String,
    },
    NoCommandTargets {
        deployment_id: String,
    },
    CommandTargetIdInvalid {
        resource_id: String,
    },
    CommandReceiverConfigInvalid {
        message: String,
        env_var: String,
    },
    CommandReceiverUnauthorized {
        operation: String,
        url: String,
    },
    CommandReceiverRequestRejected {
        operation: String,
        status: u16,
        url: String,
    },
    InvalidStateTransition {
        from: String,
        to: String,
    },
    CommandExpired {
        command_id: String,
    },
    StorageOperationFailed {
        message: String,
        operation: Option<String>,
        path: Option<String>,
    },
    KvOperationFailed {
        operation: String,
        key: String,
        message: String,
    },
    TransportDispatchFailed {
        message: String,
        transport_type: Option<String>,
        target: Option<String>,
    },
    TransportDispatchRejected {
        message: String,
        transport_type: Option<String>,
        target: Option<String>,
    },
    InvalidEnvelope {
        message: String,
        field: Option<String>,
    },
    AgentError {
        message: String,
        deployment_id: Option<String>,
    },
    SerializationFailed {
        message: String,
        data_type: Option<String>,
    },
    HttpOperationFailed {
        message: String,
        method: Option<String>,
        url: Option<String>,
    },
    OperationNotSupported {
        message: String,
        operation: Option<String>,
    },
    Conflict {
        message: String,
        resource_id: Option<String>,
    },
    LeaseNotFound {
        lease_id: String,
    },
    Other {
        message: String,
    },
}

Errors that occur in the commands protocol.

Variants

InvalidCommand

Command validation failed or contains invalid data.

Fields

message: String

Human-readable description of what makes the command invalid

CommandNotFound

Requested command ID was not found.

Fields

command_id: String

ID of the command that was not found

CommandTargetNotFound

Explicitly requested command target does not exist in the deployment (or is not command-capable). Also returned for an empty resource id.

404 mirrors the crate’s other lookup failures (COMMAND_NOT_FOUND, LEASE_NOT_FOUND): the named resource does not exist.

Fields

resource_id: String

Resource ID that was requested but not found

deployment_id: String

Deployment the target was looked up in

CommandTargetAmbiguous

Single-target shorthand was used but the deployment has multiple command-capable targets.

409 mirrors CONFLICT: the request conflicts with the deployment’s current state and the client resolves it by naming a target.

Fields

deployment_id: String

Deployment with more than one command-capable target

NoCommandTargets

The deployment has no command-capable targets at all.

422: the request is well-formed but unsatisfiable for this deployment (no resource has commands enabled) — unlike 400 (malformed) or 404 (a specific named thing missing).

Fields

deployment_id: String

Deployment without any command-capable targets

CommandTargetIdInvalid

A command target resource id contains :, which would break the pending-index and idempotency-key delimiter grammar.

400: the request (or a stored target) is malformed. The commands layer permits every resource-id character except :, which delimits key segments.

Fields

resource_id: String

The offending resource id

CommandReceiverConfigInvalid

Pull command receiver configuration from the environment is missing or invalid (e.g. a required ALIEN_COMMANDS_* variable is absent).

Fields

message: String

Human-readable description of what is missing or invalid

env_var: String

Environment variable that is missing or invalid

CommandReceiverUnauthorized

The command receiver bearer token was rejected by the commands API.

Fields

operation: String

Command API operation that was rejected

url: String

Commands API URL that rejected the token

CommandReceiverRequestRejected

The command receiver request was permanently rejected by the commands API.

Fields

operation: String

Command API operation that was rejected

status: u16

HTTP status returned by the commands API

url: String

Commands API URL that rejected the request

InvalidStateTransition

Invalid state transition attempted on command.

Fields

from: String

Current state of the command

to: String

Attempted new state

CommandExpired

Command has expired and can no longer be processed.

Fields

command_id: String

ID of the expired command

StorageOperationFailed

Storage backend operation failed.

Fields

message: String

Human-readable description of the storage failure

operation: Option<String>

Storage operation type (upload, download, etc.)

path: Option<String>

Storage path or URL that failed

KvOperationFailed

Key-value store operation failed.

Fields

operation: String

Type of KV operation that failed

key: String

Key that was being operated on

message: String

Human-readable description of the failure

TransportDispatchFailed

Transport dispatch to agent failed.

Fields

message: String

Human-readable description of the dispatch failure

transport_type: Option<String>

Transport type that failed

target: Option<String>

Target endpoint or agent identifier

TransportDispatchRejected

Transport rejected a command before accepting it for execution.

Unlike an acknowledgement timeout, this is a definite non-delivery: the command server may safely record a terminal delivery failure.

Fields

message: String

Safe description that contains no endpoint credentials or body.

transport_type: Option<String>

Transport type that rejected the command.

target: Option<String>

Command identifier (never a credential-bearing URL).

InvalidEnvelope

Command envelope validation or parsing failed.

Fields

message: String

Human-readable description of the envelope issue

field: Option<String>

Envelope field that caused the validation failure

AgentError

Agent reported an error during command processing.

Fields

message: String

Human-readable description of the agent error

deployment_id: Option<String>

Agent identifier if available

SerializationFailed

Serialization or deserialization operation failed.

Fields

message: String

Human-readable description of the serialization failure

data_type: Option<String>

Data type that failed to serialize/deserialize

HttpOperationFailed

HTTP operation failed during command processing.

Fields

message: String

Human-readable description of the HTTP failure

method: Option<String>

HTTP method if available

url: Option<String>

URL that failed if available

OperationNotSupported

Operation is not supported by the current configuration.

Fields

message: String

Human-readable description of what operation is not supported

operation: Option<String>

Operation type that was attempted

Conflict

Resource conflict detected (e.g., concurrent modification).

Fields

message: String

Human-readable description of the conflict

resource_id: Option<String>

Resource identifier that has the conflict

LeaseNotFound

Requested lease ID was not found.

Fields

lease_id: String

ID of the lease that was not found

Other

Generic commands error for uncommon cases.

Fields

message: String

Human-readable description of the error

Trait Implementations

impl AlienErrorData for ErrorData

fn code(&self) -> &'static str

Short machine-readable identifier (“NOT_FOUND”, “TIMEOUT”, …).

fn retryable(&self) -> bool

Whether the failing operation can be retried.

fn internal(&self) -> bool

Whether the error is internal (should not be shown to end users).

fn http_status_code(&self) -> u16

HTTP status code for this error (defaults to 500).

fn message(&self) -> String

Human-readable message (defaults to Display).

fn hint(&self) -> Option<String>

Optional actionable hint for human-facing CLI output.

fn context(&self) -> Option<Value>

Optional diagnostic payload built from struct/enum fields.

fn retryable_inherit(&self) -> Option<bool>

Whether to inherit the retryable flag from the source error. Returns None if this error should inherit from source, Some(value) for explicit value.

fn internal_inherit(&self) -> Option<bool>

Whether to inherit the internal flag from the source error. Returns None if this error should inherit from source, Some(value) for explicit value.

fn http_status_code_inherit(&self) -> Option<u16>

Whether to inherit the HTTP status code from the source error. Returns None if this error should inherit from source, Some(value) for explicit value.

fn human_layer_presentation(&self) -> HumanLayerPresentation

Controls whether this error layer should be shown in the default human CLI renderer.

impl Clone for ErrorData

fn clone(&self) -> ErrorData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ErrorData

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorData

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorData

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

Formats the value using the given formatter.

impl Serialize for ErrorData

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

where __S: Serializer,

Serialize this value into the given Serde serializer.