Struct PluginHost 

pub struct PluginHost { /* private fields */ }

Manages the lifecycle of WASM plugins.

Implementations

impl PluginHost

pub fn new(workspace_dir: &Path) -> Result<Self, PluginError>

Create a new plugin host rooted at workspace_dir, scanning its plugins/ subdirectory.

pub fn with_security( workspace_dir: &Path, signature_mode: SignatureMode, trusted_publisher_keys: Vec<String>, ) -> Result<Self, PluginError>

Create a host rooted at workspace_dir (scanning workspace_dir/plugins) with signature verification settings.

pub fn from_plugins_dir(plugins_dir: &Path) -> Result<Self, PluginError>

Create a host that scans plugins_dir directly (no plugins/ suffix is appended). Use this when the caller already holds the fully resolved plugin directory, e.g. PluginsConfig::resolved_plugins_dir().

pub fn from_plugins_dir_with_security( plugins_dir: &Path, signature_mode: SignatureMode, trusted_publisher_keys: Vec<String>, ) -> Result<Self, PluginError>

Self::from_plugins_dir with signature verification settings.

pub fn parse_signature_mode(mode: &str) -> Option<SignatureMode>

pub fn resolve_signature_mode(mode: &str) -> SignatureMode

pub fn list_plugins(&self) -> Vec<PluginInfo>

List all discovered plugins.

pub fn get_plugin(&self, name: &str) -> Option<PluginInfo>

Get info about a specific plugin.

pub fn install(&mut self, source: &str) -> Result<String, PluginError>

Install a plugin from a directory path. Returns the installed plugin’s manifest name so callers can key follow-up work (config seeding, messaging) off the canonical name rather than the source path.

pub fn remove(&mut self, name: &str) -> Result<(), PluginError>

Remove a plugin by name.

pub fn tool_plugins(&self) -> Vec<&PluginManifest>

Get tool-capable plugins.

pub fn tool_plugin_details(&self) -> Vec<(&PluginManifest, &Path)>

Get tool-capable plugins with their resolved WASM file paths. Returns (manifest, resolved_wasm_path) tuples for building WasmTools. Tool plugins without a wasm_path are skipped.

pub fn channel_plugins(&self) -> Vec<&PluginManifest>

Get channel-capable plugins.

pub fn channel_plugin_details(&self) -> Vec<(&PluginManifest, &Path)>

pub fn skill_plugins(&self) -> Vec<&PluginManifest>

Get skill-capable plugins.

pub fn skill_plugin_details(&self) -> Vec<(&PluginManifest, PathBuf)>

pub fn plugins_dir(&self) -> &Path

Returns the plugins directory path.