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 apl-core needs to make routing + dispatch decisions; richer CPEX 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 plugin(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 apl-core layer.

hooks: Vec<String>

CPEX 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_policy vs pipe-chain).

Per spec §“Hook dispatch”: 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 CPEX runtime; apl-core doesn’t interpret it.

on_error: Option<String>

fail | ignore | disable. Defaults to fail per spec when None.

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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.