Struct PluginDeclaration 

pub struct PluginDeclaration {
    pub name: String,
    pub kind: String,
    pub hooks: Vec<String>,
    pub capabilities: Vec<String>,
    pub config: Option<Value>,
    pub on_error: Option<String>,
    pub extra: HashMap<String, Value>,
}

One entry from the root plugins: block. The minimal shape praxis-policy-apl-core needs to make routing + dispatch decisions; richer PPE fields (source, priority, mode, transport blocks, description, version) are captured opaquely under extra so the round-trip preserves them without us modeling every variant for v0.

Fields

name: String

Plugin name — referenced from routes by run(name) and used as the key in PluginRegistry.

kind: String

Implementation kind. Spec defines a closed set (builtin, native, wasm, FQN, external, isolated_venv, PDP kinds) but we parse as a free string so configs using future kinds the runtime understands aren’t rejected at the praxis-policy-apl-core layer.

hooks: Vec<String>

PPE hook names this plugin implements. Invokers pick which hook to dispatch based on this list; v0 uses the first entry, future versions will choose by invocation context (policy vs post_invocation vs pipe-chain).

NOT overridable per-route.

capabilities: Vec<String>

Attribute-extension capabilities (read_subject, read_labels, append_labels, read_headers, …). The runtime uses these for extension filtering before dispatch. v0: parsed but not yet enforced (capability gating is a separately tracked item).

config: Option<Value>

Opaque per-plugin config. Passed to the plugin verbatim by the PPE runtime; praxis-policy-apl-core doesn’t interpret it. The plugin’s own settings, passed through unread.

on_error: Option<String>

fail | ignore | disable. Defaults to fail per spec when None. What happens when the plugin errors: fail, ignore, or disable.

extra: HashMap<String, Value>

Catch-all for source, priority, mode, transport blocks, description, version, etc. Preserved so a future loader can read them without re-parsing the YAML.

Trait Implementations

impl Clone for PluginDeclaration

fn clone(&self) -> PluginDeclaration

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PluginDeclaration

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PluginDeclaration

fn deserialize<__D>( __deserializer: __D, ) -> Result<PluginDeclaration, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PluginDeclaration

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.