Enum PluginError 

pub enum PluginError {
    Execution {
        plugin_name: String,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
        code: Option<String>,
        details: HashMap<String, Value>,
        proto_error_code: Option<i64>,
    },
    Timeout {
        plugin_name: String,
        timeout_ms: u64,
        proto_error_code: Option<i64>,
    },
    Violation {
        plugin_name: String,
        violation: PluginViolation,
    },
    Config {
        message: String,
    },
    UnknownHook {
        hook_type: String,
    },
}

Top-level error type for the CPEX framework.

Covers plugin execution failures, policy violations, timeouts, and configuration issues. Each variant carries enough context for the caller to log, report, or recover.

Mirrors the Python framework’s PluginErrorModel with:

• code — business-logic error code (e.g., "rate_limit_exceeded")
• details — structured diagnostic data for logging
• proto_error_code — protocol-level error code for the host to map back to the wire format (MCP JSON-RPC, HTTP status, etc.)

Variants

Execution

A plugin raised an execution error.

Fields

plugin_name: String

message: String

source: Option<Box<dyn Error + Send + Sync>>

Business-logic error code (e.g., "invalid_token").

code: Option<String>

Business-logic error code set by the plugin.

details: HashMap<String, Value>

Structured diagnostic data for logging or debugging.

proto_error_code: Option<i64>

Protocol-level error code for the host to map to the wire format. MCP: JSON-RPC codes (e.g., -32603). HTTP: status codes. The host interprets this; CPEX just carries it.

Timeout

A plugin exceeded its execution timeout.

Fields

plugin_name: String

timeout_ms: u64

proto_error_code: Option<i64>

Protocol-level error code for the host.

Violation

A plugin returned a policy violation (deny).

Fields

plugin_name: String

violation: PluginViolation

Config

Configuration parsing or validation failed.

Fields

message: String

UnknownHook

A hook type was not found in the registry.

Fields

hook_type: String

Implementations

impl PluginError

pub fn boxed(self) -> Box<Self>

Box this error for use in Result<T, Box<PluginError>>.

Public APIs return Result<T, Box<PluginError>> rather than Result<T, Box<PluginError>> because the enum is large (~184 bytes — details: HashMap and the source: Box<dyn Error> push it well past clippy’s result_large_err threshold). Boxing keeps Result<T, _> pointer-sized on the success path; the allocation only happens on the error path.

.boxed() is sugar for Box::new(...) that reads better at construction sites: PluginError::Config { ... }.boxed(). ? already calls From::from, and From<T> for Box<T> is built into std, so existing ? chains keep working.

Trait Implementations

impl Debug for PluginError

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

Formats the value using the given formatter.

impl Display for PluginError

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

Formats the value using the given formatter.

impl Error for PluginError

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<PluginError>> for PluginErrorRecord

Forward &Box<PluginError> to the &PluginError impl.

Public APIs return Result<T, Box<PluginError>> (see PluginError::boxed), which means error-handling code in the pipeline (e.g., Ok(Err(e)) inside executor::run_*_phase) holds e: Box<PluginError>. This blanket forward keeps existing (&e).into() call sites working without forcing every caller to write (&*e).into() after the boxing migration.

fn from(e: &Box<PluginError>) -> Self

Converts to this type from the input type.

impl From<&PluginError> for PluginErrorRecord

fn from(e: &PluginError) -> Self

Converts to this type from the input type.