Struct PluginManager 

pub struct PluginManager { /* private fields */ }

Coordinates plugin discovery, caching, and dispatch settings.

Implementations

impl PluginManager

pub fn refresh(&self)

Clears both passive and dispatch discovery caches.

impl PluginManager

pub fn dispatch( &self, command: &str, args: &[String], context: &PluginDispatchContext, ) -> Result<ResponseV1, PluginDispatchError>

Runs a plugin command and returns its validated structured response.

pub fn dispatch_passthrough( &self, command: &str, args: &[String], context: &PluginDispatchContext, ) -> Result<RawPluginOutput, PluginDispatchError>

Runs a plugin command and returns raw stdout, stderr, and exit status.

impl PluginManager

pub fn new(explicit_dirs: Vec<PathBuf>) -> Self

Creates a plugin manager with the provided explicit search roots.

Examples

use osp_cli::plugin::PluginManager;
use std::path::PathBuf;

let manager = PluginManager::new(vec![PathBuf::from("/plugins")]);

assert_eq!(manager.explicit_dirs().len(), 1);

pub fn explicit_dirs(&self) -> &[PathBuf]

Returns the explicit plugin search roots configured for this manager.

pub fn with_roots( self, config_root: Option<PathBuf>, cache_root: Option<PathBuf>, ) -> Self

Sets config and cache roots used for persisted plugin metadata and preferences.

Examples

use osp_cli::plugin::PluginManager;
use std::path::PathBuf;

let manager = PluginManager::new(Vec::new()).with_roots(
    Some(PathBuf::from("/config")),
    Some(PathBuf::from("/cache")),
);

assert_eq!(manager.config_root(), Some(PathBuf::from("/config").as_path()));
assert_eq!(manager.cache_root(), Some(PathBuf::from("/cache").as_path()));

pub fn config_root(&self) -> Option<&Path>

Returns the configured config root used for persisted plugin metadata.

pub fn cache_root(&self) -> Option<&Path>

Returns the configured cache root used for persisted plugin state.

pub fn with_process_timeout(self, timeout: Duration) -> Self

Sets the subprocess timeout used for plugin describe and dispatch calls.

Timeout values are clamped to at least one millisecond so the manager never stores a zero-duration subprocess timeout.

Examples

use osp_cli::plugin::PluginManager;
use std::time::Duration;

let manager = PluginManager::new(Vec::new())
    .with_process_timeout(Duration::from_millis(0));

assert_eq!(manager.process_timeout(), Duration::from_millis(1));

pub fn process_timeout(&self) -> Duration

Returns the subprocess timeout used for describe and dispatch calls.

pub fn with_path_discovery(self, allow_path_discovery: bool) -> Self

Enables or disables fallback discovery through the process PATH.

Examples

use osp_cli::plugin::PluginManager;

let manager = PluginManager::new(Vec::new()).with_path_discovery(true);

assert!(manager.path_discovery_enabled());

pub fn path_discovery_enabled(&self) -> bool

Returns whether fallback discovery through the process PATH is enabled.

pub fn list_plugins(&self) -> Result<Vec<PluginSummary>>

Lists discovered plugins with health, command, and enablement status.

pub fn command_catalog(&self) -> Result<Vec<CommandCatalogEntry>>

Builds the effective command catalog after provider resolution and health filtering.

pub fn command_policy_registry(&self) -> Result<CommandPolicyRegistry>

Builds a command policy registry from active plugin describe metadata.

pub fn completion_words(&self) -> Result<Vec<String>>

Returns completion words derived from the current plugin command catalog.

pub fn repl_help_text(&self) -> Result<String>

Renders a plain-text help view for plugin commands in the REPL.

pub fn command_providers(&self, command: &str) -> Result<Vec<String>>

Returns the available provider labels for a command.

pub fn selected_provider_label(&self, command: &str) -> Result<Option<String>>

Returns the selected provider label when command resolution is unambiguous.

pub fn doctor(&self) -> Result<DoctorReport>

Produces a doctor report with plugin health summaries and command conflicts.

pub fn set_preferred_provider( &self, command: &str, plugin_id: &str, ) -> Result<()>

Persists an explicit provider preference for a command.

pub fn clear_preferred_provider(&self, command: &str) -> Result<bool>

Clears any stored provider preference for a command.

pub fn validate_preferred_provider( &self, command: &str, plugin_id: &str, ) -> Result<()>

Verifies that a plugin is a healthy provider for a command before storing it.