Enum PluginError 

#[non_exhaustive]
pub enum PluginError {
    InvalidManifest(String),
    InvalidName {
        name: String,
        reason: String,
    },
    DisallowedMcpCommand {
        id: String,
        command: String,
    },
    SkillNameConflictWithManaged {
        name: String,
    },
    SkillNameConflictWithBundled {
        name: String,
    },
    SkillNameConflictWithPlugin {
        name: String,
        plugin: String,
    },
    UnsafeOverlay {
        key: String,
    },
    SkillEntryMissing {
        path: PathBuf,
    },
    NotFound {
        name: String,
    },
    InvalidSource {
        path: String,
        reason: String,
    },
    Io {
        path: PathBuf,
        source: Error,
    },
    Toml(Error),
    TomlSer(Error),
    SemanticViolation {
        skill: String,
        reason: String,
    },
    IntegrityCheckFailed {
        expected: String,
        actual: String,
    },
    DownloadFailed {
        url: String,
        reason: String,
    },
    DependencyRequired {
        name: String,
        dependents: String,
        hints: String,
    },
    DependencyCycle {
        name: String,
        cycle: String,
    },
    MissingDependency {
        name: String,
        dependency: String,
    },
    InsecureUrl(String),
}

Errors that can occur during plugin install, remove, or list 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.

InvalidManifest(String)

The plugin manifest (plugin.toml) is missing or cannot be parsed.

InvalidName

The plugin name is invalid (empty, contains path separators, or reserved).

Fields

name: String

reason: String

DisallowedMcpCommand

A plugin MCP entry declares a command not in mcp.allowed_commands.

Fields

id: String

command: String

SkillNameConflictWithManaged

A plugin skill name conflicts with an existing managed (user) skill.

Fields

name: String

SkillNameConflictWithBundled

A plugin skill name conflicts with a compile-time bundled skill.

Fields

name: String

SkillNameConflictWithPlugin

A plugin skill name conflicts with a skill from another installed plugin.

Fields

name: String

plugin: String

UnsafeOverlay

A plugin’s [config] section contains a key not in the tighten-only safelist.

Fields

key: String

SkillEntryMissing

A [[skills]] path entry does not contain a valid SKILL.md file.

Fields

path: PathBuf

NotFound

The plugin directory does not exist or cannot be read.

Fields

name: String

InvalidSource

The plugin source path or URL is invalid.

Fields

path: String

reason: String

Io

A filesystem operation failed.

Fields

path: PathBuf

source: Error

Toml(Error)

TOML serialization/deserialization error.

TomlSer(Error)

TOML serialization error.

SemanticViolation

The SKILL.md semantic compliance scan rejected the skill.

Raised for Stage-1 regex matches treated as blocking in the ephemeral install context (add_remote_ephemeral). Stage-2 LLM scan returns a string error via the command layer, not this variant.

Fields

skill: String

reason: String

IntegrityCheckFailed

SHA-256 digest of a downloaded archive does not match the expected value.

Returned by crate::manager::PluginManager::add_remote when the caller supplies an expected_sha256 and the download does not match. Do not install or extract the archive — it may have been tampered with.

Fields

expected: String

actual: String

DownloadFailed

HTTP download of a remote plugin archive failed.

Fields

url: String

reason: String

DependencyRequired

Attempted to remove or disable a plugin that other enabled plugins depend on.

Fields

name: String

The plugin that was requested to be removed or disabled.

dependents: String

Comma-separated list of dependent plugin names.

hints: String

Newline-separated disable hints, one per dependent.

DependencyCycle

A dependency cycle was detected while enabling a plugin.

Fields

name: String

The plugin being enabled when the cycle was found.

cycle: String

Human-readable description of the cycle path.

MissingDependency

A declared dependency plugin is not installed.

Fields

name: String

The plugin declaring the dependency.

dependency: String

The missing dependency name.

InsecureUrl(String)

The URL supplied to --plugin-url uses a non-HTTPS scheme.

Only https:// is accepted for ephemeral plugin loading. http:// and any other scheme are rejected to prevent MITM attacks against session-scoped plugin archives (security invariant INV-EPH-1).

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

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for PluginError

fn from(source: Error) -> Self

Converts to this type from the input type.