Enum EmbedError 

pub enum EmbedError {
    MissingProtocolPlugin,
    MissingModelSpec,
    MissingEffectHost,
    MissingAttachmentStore,
    MissingProcessEnvStore,
    StoreFactory {
        session_id: String,
        message: String,
    },
    StoreSessionMismatch {
        loaded: String,
        requested: String,
    },
    MissingProcessWorkerStoreFactory,
    DurableStorePeerRequired {
        facet: &'static str,
    },
    DurableProcessRegistryRequiresStoreFactory,
    ProcessRegistryRequiresStoreFactory,
    MissingProcessRegistry,
    MissingSessionStoreFactory,
    SessionDeleteProcess {
        session_id: String,
        message: String,
    },
    MissingPluginTurnInput {
        plugin_id: &'static str,
    },
    SessionStillInUse,
    TraceFlush(TraceSinkError),
    DurableEffectHostRequiresHandlerContext {
        operation: &'static str,
    },
    StaticTurnStreamRequiresStaticEffectHost,
    Session(SessionError),
    Runtime(RuntimeError),
    Plugin(PluginError),
    RemoteProtocol(RemoteProtocolError),
    ProtocolTurnOptions(Error),
    DecodeProtocolTurnOptions(ProtocolTurnOptionsError),
    Control(PluginOperationInvokeError),
}

Variants

MissingProtocolPlugin

MissingModelSpec

MissingEffectHost

MissingAttachmentStore

MissingProcessEnvStore

StoreFactory

Fields

session_id: String

message: String

StoreSessionMismatch

Fields

loaded: String

requested: String

MissingProcessWorkerStoreFactory

DurableStorePeerRequired

Fields

facet: &'static str

DurableProcessRegistryRequiresStoreFactory

ProcessRegistryRequiresStoreFactory

MissingProcessRegistry

MissingSessionStoreFactory

SessionDeleteProcess

Fields

session_id: String

message: String

MissingPluginTurnInput

Fields

plugin_id: &'static str

SessionStillInUse

TraceFlush(TraceSinkError)

DurableEffectHostRequiresHandlerContext

Fields

operation: &'static str

StaticTurnStreamRequiresStaticEffectHost

Session(SessionError)

Runtime(RuntimeError)

Plugin(PluginError)

RemoteProtocol(RemoteProtocolError)

ProtocolTurnOptions(Error)

DecodeProtocolTurnOptions(ProtocolTurnOptionsError)

Control(PluginOperationInvokeError)

Implementations

impl EmbedError

pub fn is_retryable(&self) -> bool

True only when a typed signal says the failed operation is safe to retry as-is; false means “no typed retryable signal”, not “known permanent” (see is_terminal for that).

The retryable set is enumerated deliberately from RuntimeErrorCode:

• SessionExecutionBusy: another executor currently holds the session-execution lease; the turn was rejected before any state changed, so retrying after a backoff is safe.
• SessionExecutionLeaseLost: the lease was fenced away mid-turn. The final commit is fenced on the same lease, so the failed attempt committed nothing and its queued-work/turn-input claims were released; a fresh attempt can re-claim safely.

Everything else is false. Notably StoreCommitFailed stays false: the code does not distinguish transient store I/O from conflicts, so there is no typed signal that a retry is safe.

Provider failures never surface as EmbedError — a failed LLM call finishes the turn with TurnOutcome::Stopped(ProviderError) — so their typed retryability is carried on TurnIssue::retryable instead.

pub fn is_terminal(&self) -> bool

True only when a typed signal says retrying can never succeed without host-side changes (wiring, configuration, or invariant violations that a retry cannot repair). Errors that are neither is_retryable nor terminal are simply unknown.

The terminal set:

• builder/wiring variants of this enum (missing protocol plugin, model spec, effect host, stores, registries, handler context, and store/session mismatches) — the same call fails identically until the host changes its wiring;
• RuntimeErrorCode wiring codes: MissingExecutionScopeId, ExecutionScopeTurnIdMismatch, MissingProcessExecutionId, DurableStoreRequired, DurableEffectLiveProtocolExtension, DurableEffectLivePluginInput;
• session provider-configuration errors (ProviderMismatch, ProviderUnconfigured, ProviderUnavailable, CodeExecutionUnavailable).

Trait Implementations

impl Debug for EmbedError

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

Formats the value using the given formatter.

impl Display for EmbedError

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

Formats the value using the given formatter.

impl Error for EmbedError

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<Error> for EmbedError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<PluginError> for EmbedError

fn from(source: PluginError) -> Self

Converts to this type from the input type.

impl From<PluginOperationInvokeError> for EmbedError

fn from(source: PluginOperationInvokeError) -> Self

Converts to this type from the input type.

impl From<ProtocolTurnOptionsError> for EmbedError

fn from(source: ProtocolTurnOptionsError) -> Self

Converts to this type from the input type.

impl From<RemoteProtocolError> for EmbedError

fn from(source: RemoteProtocolError) -> Self

Converts to this type from the input type.

impl From<RuntimeError> for EmbedError

fn from(source: RuntimeError) -> Self

Converts to this type from the input type.

impl From<SessionError> for EmbedError

fn from(source: SessionError) -> Self

Converts to this type from the input type.

impl From<TraceSinkError> for EmbedError

fn from(source: TraceSinkError) -> Self

Converts to this type from the input type.