Enum TelemetryError 

pub enum TelemetryError {
    Unavailable(String),
    HookProtocol(String),
    Internal(String),
}

Telemetry-side errors. The variants name the failure classes the spec uses for telemetry-derived receipts:

• TelemetryError::Unavailable → telemetry_unavailable
• TelemetryError::HookProtocol → hook_protocol_error
• TelemetryError::Internal → internal_error (the only one of the three currently named in docs/specs/lifecycle-contract/body.md).

The first two are pending as LifecycleReceipt::failure_class variants — they are added to the receipt enum in a follow-up issue once the spec body names them. Until then, callers wishing to emit a failed receipt for these conditions should use internal_error and attach the precise class via warnings.

Variants

Unavailable(String)

The telemetry source (file, directory, db) was missing, empty, or stale. Distinct from internal_error because it’s an expected, observable absence rather than a Lifeloop bug.

HookProtocol(String)

The shape of a parsed telemetry artifact violated the adapter’s hook protocol contract (e.g. expected JSONL but lines were not objects). Distinct from Unavailable because something was there and it was wrong.

Internal(String)

Lifeloop failed unexpectedly while parsing telemetry.

Implementations

impl TelemetryError

pub fn failure_class(&self) -> &'static str

Stable wire string for the failure class this error maps to.

Trait Implementations

impl Debug for TelemetryError

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

Formats the value using the given formatter.

impl Display for TelemetryError

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

Formats the value using the given formatter.

impl Error for TelemetryError

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 TelemetryError

fn from(error: Error) -> Self

Converts to this type from the input type.