Enum ProviderError 

pub enum ProviderError {
    Transport(String),
    Diagnostics(Vec<Diag>),
    NoNewState,
    PartiallyApplied {
        diags: Vec<Diag>,
        state: Box<DynamicValue>,
    },
    Schema(SchemaError),
}

── THE PROTOCOL DATA MODEL MOVED TO magma-provider-api ──────────── ProviderSchema, PlannedChange, Diag, Severity, ProviderError and is_retryable were defined here. They describe what a provider SAYS, not how it is reached, so they now live in the contract crate — which depends on magma-cty alone, so a native provider can implement the contract without dragging in tonic.

The edge had to point this way: magma-provider-api declares the Provider trait, and THIS crate implements it, so the types could not stay in the crate the trait crate would have had to depend on.

Re-exported unchanged, so every magma_plugin::provider::<T> path still resolves. Relocation, not redesign.

Variants

Transport(String)

Diagnostics(Vec<Diag>)

NoNewState

PartiallyApplied

The provider returned an error diagnostic AND a new_state — the resource IS (at least partially) committed provider-side.

This is not a rare edge: it is how the tfplugin contract expresses a partial apply, and how Terraform core knows to persist a half-created resource. AWS EIP is the canonical shape — AllocateAddress commits, a follow-up call (tagging, association, the post-create read) fails, and the provider returns the allocation id together with an error.

Before this variant existed, check_diags(...)? ran BEFORE new_state was read, so that state was thrown away and the caller recorded nothing. The next reconcile re-planned a CREATE and allocated a SECOND resource. Measured 2026-08-01: two orphaned EIPs (3.151.179.36, 18.227.192.150), each billable, neither in state, while the run reported created: 0.

Carrying the state in the ERROR — rather than returning Ok — keeps the apply correctly failed while making the committed resource impossible to drop on the floor: a caller must destructure this variant to handle the error at all.

Fields

diags: Vec<Diag>

state: Box<DynamicValue>

Schema(SchemaError)

Trait Implementations

impl Debug for ProviderError

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

Formats the value using the given formatter.

impl Display for ProviderError

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

Formats the value using the given formatter.

impl Error for ProviderError

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<SchemaError> for ProviderError

fn from(source: SchemaError) -> ProviderError

Converts to this type from the input type.