Enum HostPipeError 

pub enum HostPipeError {
    HostNotConnected,
    WriteFailed(Error),
    Serialize(Error),
    BufferOverflow,
    StaleSession,
}

Reasons send_command / send_event can fail synchronously.

HostNotConnected is reserved for cases where the caller wants to fail-fast instead of buffering (CPD-3 will choose whichever fits per command kind). The default send_command code path buffers; see try_send_command_no_buffer for the fail-fast variant.

Variants

HostNotConnected

No host is currently connected and the caller asked to fail rather than buffer.

WriteFailed(Error)

Underlying write to the pipe failed.

Serialize(Error)

Frame failed to serialize. Should be impossible for well- formed Command / Event variants but kept as a result variant for defense-in-depth.

BufferOverflow

Pending buffer is full and we couldn’t drop the oldest entry to make room (e.g. caller asked for no-overflow semantics). Default send_command does drop-oldest + emit-failed, so callers won’t see this from the public API today.

StaleSession

Caller’s captured host_session_id no longer matches the pipe’s current session (a new host registered, displacing the old one). The caller — typically a per-host fanout task — should exit immediately so it doesn’t write into the new host’s writer. (codex P1 PR #642 round 2.)

Trait Implementations

impl Debug for HostPipeError

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

Formats the value using the given formatter.

impl Display for HostPipeError

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

Formats the value using the given formatter.

impl Error for HostPipeError

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.