Enum ToolkitError 

#[non_exhaustive]
pub enum ToolkitError {
    Parse(Error),
    MissingField(String),
    Synth(String),
    CodeMode(String),
    Io(Error),
    Secret {
        name: String,
        cause: String,
    },
    Validation(ConfigValidationError),
}

Errors surfaced by the pmcp-server-toolkit runtime.

The enum is #[non_exhaustive] — match callers must include a wildcard arm.

Examples

use pmcp_server_toolkit::ToolkitError;
use std::error::Error;

// ToolkitError is a real `std::error::Error`, with a usable `Display` impl.
let err: ToolkitError = ToolkitError::MissingField("database.dsn".into());
assert_eq!(err.to_string(), "missing required config field: database.dsn");
// Implements `std::error::Error`, so it composes with `?` and `Box<dyn Error>`.
let boxed: Box<dyn Error + Send + Sync> = Box::new(err);
assert!(boxed.source().is_none());

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.

Parse(Error)

TOML parse failure while loading a ServerConfig.

MissingField(String)

A required config field was absent during tool synthesis.

Synth(String)

[[tools]] synthesis failed (covers Phase 83 TKIT-07 failure modes).

CodeMode(String)

Code-mode wiring failed (covers Phase 83 TKIT-09 failure modes).

Io(Error)

Filesystem failure while reading a config or fixture.

Secret

Secret resolution failed (env var missing, AWS API error, etc.).

Carries the secret name and a descriptive cause string; the underlying raw value is NEVER carried in this variant — only the lookup-key metadata and the error context. This preserves the SecretValue negative-trait invariants at the error path (review R5 + T-83-02-02).

Fields

name: String

The secret name that could not be resolved.

cause: String

Human-readable cause (provider name + underlying error).

Validation(ConfigValidationError)

Semantic validation of a parsed crate::config::ServerConfig failed.

Wraps a ConfigValidationError surfaced by crate::config::ServerConfig::validate / crate::config::ServerConfig::from_toml_strict_validated. Per Phase 83 review R8 this catches the empty-required-value trap that the Default impls on sub-sections would otherwise hide behind silent successes (e.g. server.name = "" if the [server] header is typo’d).

Trait Implementations

impl Debug for ToolkitError

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

Formats the value using the given formatter.

impl Display for ToolkitError

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

Formats the value using the given formatter.

impl Error for ToolkitError

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<ConfigValidationError> for ToolkitError

fn from(source: ConfigValidationError) -> Self

Converts to this type from the input type.

impl From<Error> for ToolkitError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ToolkitError

fn from(source: Error) -> Self

Converts to this type from the input type.