Enum MobError 

pub enum MobError {
    ProfileNotFound(ProfileName),
    MemberNotFound(MeerkatId),
    MemberAlreadyExists(MeerkatId),
    NotExternallyAddressable(MeerkatId),
    InvalidTransition {
        from: MobState,
        to: MobState,
    },
    WiringError(String),
    SupervisorRotationIncomplete {
        previous_epoch: u64,
        attempted_epoch: u64,
        attempted_public_peer_id: String,
        rotated_peer_count: usize,
        rollback_succeeded: bool,
        pending_authority_recorded: bool,
        pending_authority_process_local: bool,
        rollback_error: Option<String>,
        reason: String,
    },
    BridgeCommandRejected {
        cause: BridgeRejectionCause,
        reason: String,
    },
    MemberRestoreFailed {
        member_id: MeerkatId,
        session_id: Option<SessionId>,
        reason: String,
    },
    KickoffWaitTimedOut {
        pending_member_ids: Vec<MeerkatId>,
    },
    ReadyWaitTimedOut {
        pending_member_ids: Vec<MeerkatId>,
    },
    DefinitionError(Vec<Diagnostic>),
    FlowNotFound(FlowId),
    FlowFailed {
        run_id: RunId,
        reason: String,
    },
    RunNotFound(RunId),
    RunCanceled(RunId),
    FlowTurnTimedOut,
    FrameDepthLimitExceeded {
        loop_id: LoopId,
        max_frame_depth: u32,
        current_depth: u32,
    },
    FrameAtomicPersistenceUnavailable {
        operation: FrameAtomicOperation,
    },
    SpecRevisionConflict {
        mob_id: MobId,
        expected: Option<u64>,
        actual: u64,
    },
    SchemaValidation {
        step_id: StepId,
        message: String,
    },
    InsufficientTargets {
        step_id: StepId,
        required: u8,
        available: usize,
    },
    TopologyViolation {
        from_role: ProfileName,
        to_role: ProfileName,
    },
    BridgeDeliveryRejected {
        cause: BridgeDeliveryRejectionCause,
        reason: String,
    },
    SupervisorEscalation(String),
    UnsupportedForMode {
        mode: MobRuntimeMode,
        reason: String,
    },
    MissingMemberCapability {
        member_id: MeerkatId,
        capability: MobMemberCapability,
        context: &'static str,
    },
    ResetBarrier,
    StorageError(Box<dyn Error + Send + Sync>),
    SessionError(SessionError),
    CommsError(SendError),
    CallbackPending {
        session_id: SessionId,
        tool_name: String,
        args: Value,
    },
    StaleFenceToken {
        runtime_id: AgentRuntimeId,
        expected: FenceToken,
        actual: FenceToken,
    },
    StaleEventCursor {
        after_cursor: u64,
        latest_cursor: u64,
    },
    WorkNotFound(WorkRef),
    Internal(String),
}

Errors returned by mob operations.

Variants

ProfileNotFound(ProfileName)

The requested profile does not exist in the mob definition.

MemberNotFound(MeerkatId)

The requested mob member does not exist in the roster.

Renamed from MeerkatNotFound by DELETE_ME finding A2 + B8 as part of the 0.6 identity-first cascade. The inner type remains MeerkatId until the full A5 DSL-schema migration flips it to AgentIdentity; the rename lands first so public error matching doesn’t leak the legacy term.

MemberAlreadyExists(MeerkatId)

A mob member with the given ID already exists.

Renamed from MeerkatAlreadyExists by DELETE_ME finding A2 + B8.

NotExternallyAddressable(MeerkatId)

The mob member’s profile does not allow external turns.

InvalidTransition

The requested lifecycle state transition is invalid.

Fields

from: MobState

to: MobState

WiringError(String)

A wiring operation failed.

SupervisorRotationIncomplete

Supervisor rotation reached one or more remote members but did not complete, so local supervisor authority stayed at the pre-rotation epoch.

Fields

previous_epoch: u64

attempted_epoch: u64

attempted_public_peer_id: String

rotated_peer_count: usize

rollback_succeeded: bool

pending_authority_recorded: bool

pending_authority_process_local: bool

rollback_error: Option<String>

reason: String

BridgeCommandRejected

A supervisor bridge command was rejected by the remote member.

Fields

cause: BridgeRejectionCause

reason: String

MemberRestoreFailed

The member failed to restore durable session state and is broken until repaired.

Fields

member_id: MeerkatId

session_id: Option<SessionId>

reason: String

KickoffWaitTimedOut

Waiting for kickoff completion timed out.

Fields

pending_member_ids: Vec<MeerkatId>

ReadyWaitTimedOut

Waiting for startup readiness timed out.

Fields

pending_member_ids: Vec<MeerkatId>

DefinitionError(Vec<Diagnostic>)

The mob definition failed validation.

FlowNotFound(FlowId)

Referenced flow does not exist.

FlowFailed

Run failed with a reason.

Fields

run_id: RunId

reason: String

RunNotFound(RunId)

Referenced run does not exist.

RunCanceled(RunId)

Run was canceled.

FlowTurnTimedOut

Flow turn timed out while awaiting terminal transport outcome.

FrameDepthLimitExceeded

A frame-aware flow exceeded its configured nesting depth.

Fields

loop_id: LoopId

max_frame_depth: u32

current_depth: u32

FrameAtomicPersistenceUnavailable

The selected mob run store cannot provide frame-aware atomic persistence.

Fields

operation: FrameAtomicOperation

SpecRevisionConflict

Spec revision compare-and-swap failed.

Fields

mob_id: MobId

expected: Option<u64>

actual: u64

SchemaValidation

Schema validation failed for a step output.

Fields

step_id: StepId

message: String

InsufficientTargets

Not enough targets to satisfy dispatch/collection policy.

Fields

step_id: StepId

required: u8

available: usize

TopologyViolation

Topology policy denied a dispatch edge.

Fields

from_role: ProfileName

to_role: ProfileName

BridgeDeliveryRejected

A bridge accepted the delivery command but rejected the member input.

Fields

cause: BridgeDeliveryRejectionCause

reason: String

SupervisorEscalation(String)

Supervisor escalation happened.

UnsupportedForMode

Operation is not supported for the member’s runtime mode.

Fields

mode: MobRuntimeMode

reason: String

MissingMemberCapability

A member is missing a required runtime capability for the requested operation.

Fields

member_id: MeerkatId

capability: MobMemberCapability

context: &'static str

ResetBarrier

Operation blocked by reset barrier.

StorageError(Box<dyn Error + Send + Sync>)

A storage operation failed.

SessionError(SessionError)

A session service operation failed.

CommsError(SendError)

A comms operation failed.

CallbackPending

A runtime-backed member turn reached an external callback boundary.

Fields

session_id: SessionId

tool_name: String

args: Value

StaleFenceToken

The fence token does not match the member’s current incarnation.

Fields

runtime_id: AgentRuntimeId

expected: FenceToken

actual: FenceToken

StaleEventCursor

A caller supplied an event replay cursor beyond the store frontier.

Fields

after_cursor: u64

latest_cursor: u64

WorkNotFound(WorkRef)

The referenced work unit does not exist.

Internal(String)

An internal error (unexpected state, logic errors).

Implementations

impl MobError

pub fn bridge_rejection_cause(&self) -> Option<BridgeRejectionCause>

pub fn spawn_many_failure_cause(&self) -> MobSpawnManyFailureCause

Typed failure cause for per-member mob/spawn_many result rows.

This match intentionally has no wildcard arm. Adding a new MobError variant must update the public spawn-many failure projection instead of silently collapsing into string-only error semantics.

Trait Implementations

impl Debug for MobError

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

Formats the value using the given formatter.

impl Display for MobError

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

Formats the value using the given formatter.

impl Error for MobError

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<Box<dyn Error + Sync + Send>> for MobError

fn from(error: Box<dyn Error + Send + Sync>) -> Self

Converts to this type from the input type.

impl From<BridgeRejectionReply> for MobError

fn from(rejection: BridgeRejectionReply) -> Self

Converts to this type from the input type.

impl From<MobError> for MobDestroyError

fn from(source: MobError) -> Self

Converts to this type from the input type.

impl From<MobError> for MobRespawnError

fn from(source: MobError) -> Self

Converts to this type from the input type.

impl From<MobStoreError> for MobError

fn from(error: MobStoreError) -> Self

Converts to this type from the input type.

impl From<SendError> for MobError

fn from(source: SendError) -> Self

Converts to this type from the input type.

impl From<SessionError> for MobError

fn from(source: SessionError) -> Self

Converts to this type from the input type.