Enum RunLogError 

#[non_exhaustive]
pub enum RunLogError {
    Store(String),
    NotFound(RunId),
    Projection(String),
    Replay(String),
    NoLlmCall,
    ReplayMismatch {
        step: u32,
        kind: StepKind,
        expected: String,
        actual: String,
    },
    ReplayStep {
        step: u32,
        source: Box<dyn Error + Send + Sync>,
    },
    Compaction(String),
    CaptureBackend {
        source: Box<dyn Error + Send + Sync>,
    },
    CaptureCodec {
        source: Box<dyn Error + Send + Sync>,
    },
}

Errors raised by klieo-runlog operations.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Store(String)

Backend store failure (I/O, serialisation, SQL).

NotFound(RunId)

get/delete requested a run_id that does not exist.

Projection(String)

Projection from Episode stream into a RunLog aggregate failed.

Replay(String)

👎Deprecated:

use ReplayMismatch, ReplayStep, or NoLlmCall

Free-form structural replay failure retained for back-compat; all in-crate paths now emit a typed variant instead.

NoLlmCall

The RunLog carried no LlmCall step, so strict replay has no final assistant text to return.

ReplayMismatch

A replay double produced output that differs from the recording — the strict replay path’s stop condition. Carries both sides so callers inspect the divergence without parsing the Display string.

Fields

step: u32

Zero-based index into the source RunLog.steps.

kind: StepKind

Copied from the diverging step; only LlmCall/ToolCall reach here, since other kinds re-issue no I/O on replay.

expected: String

Recorded output, normalized for comparison (see flatten_output).

actual: String

Replayed output, normalized the same way as expected.

ReplayStep

A replay double failed to produce output for a step (the LLM/tool call errored or a scripted double exhausted) — distinct from a value mismatch, which surfaces as ReplayMismatch rather than an error.

Fields

step: u32

Zero-based index into the source RunLog.steps.

source: Box<dyn Error + Send + Sync>

The LlmError or ToolError the double returned, boxed so the typed cause stays reachable via std::error::Error::source.

Compaction(String)

Compaction policy failed (e.g. LLM summariser returned non-text).

CaptureBackend

A capture-persistence backend operation (KvStore put/get/keys/delete) failed. Carries the backend error as a typed source.

Fields

source: Box<dyn Error + Send + Sync>

Downcast to klieo_core::BusError to branch on the backend failure kind (unsupported, conflict, transport).

CaptureCodec

A capture blob failed to serialize on persist or deserialize on load (e.g. a corrupt or truncated stored value).

Fields

source: Box<dyn Error + Send + Sync>

Downcast to serde_json::Error for the byte offset of the malformed blob.

Trait Implementations

impl Debug for RunLogError

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

Formats the value using the given formatter.

impl Display for RunLogError

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

Formats the value using the given formatter.

impl Error for RunLogError

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.