Enum ChannelError 

pub enum ChannelError {
    Io(Error),
    ChannelClosed,
    ConfirmCancelled,
    NoActiveSession,
    Telegram(String),
    Other(String),
}

Typed error for channel operations.

Variants

Io(Error)

Underlying I/O failure.

ChannelClosed

Channel closed (mpsc send/recv failure).

ConfirmCancelled

Confirmation dialog cancelled.

NoActiveSession

No active session is established yet (no message has been received).

Occurs when send or related methods are called before any message has arrived on the channel (i.e., recv has never returned successfully).

Telegram(String)

A Telegram Bot API request failed.

Wraps the teloxide RequestError as a string to avoid a direct teloxide dependency in zeph-core. The zeph-channels adapter constructs this variant before returning ChannelError to the agent.

Other(String)

Catch-all for third-party API errors that do not map to a more specific variant.

Implementations

impl ChannelError

pub fn telegram(e: impl Display) -> Self

Create a Telegram error from any displayable teloxide error.

Examples

use zeph_core::channel::ChannelError;

let err = ChannelError::telegram(teloxide_err);
assert!(matches!(err, ChannelError::Telegram(_)));

pub fn other(e: impl Display) -> Self

Create a catch-all error from any displayable error.

Converts the error message to a string and wraps it in the Other variant. Useful for wrapping provider-specific errors from third-party libraries.

Trait Implementations

impl Debug for ChannelError

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

Formats the value using the given formatter.

impl Display for ChannelError

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

Formats the value using the given formatter.

impl Error for ChannelError

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<ChannelError> for AgentError

fn from(source: ChannelError) -> Self

Converts to this type from the input type.

impl From<Error> for ChannelError

fn from(source: Error) -> Self

Converts to this type from the input type.