Struct PluginHandle 

pub struct PluginHandle { /* private fields */ }

Handle to an initialized plugin instance

Implementations

impl PluginHandle

pub fn new( plugin: Box<dyn Plugin>, config: PluginConfig, ) -> Result<PluginHandle, PluginError>

Create a new plugin handle

pub fn id(&self) -> Option<u64>

Get the handle ID

pub fn state(&self) -> LifecycleState

Get the current lifecycle state

pub fn start(&self) -> Result<(), PluginError>

Start the plugin

pub fn call( &self, type_tag: &str, request: &[u8], ) -> Result<Vec<u8>, PluginError>

Handle a request

pub fn shutdown(&self, timeout_ms: u64) -> Result<(), PluginError>

Shutdown the plugin

pub fn set_log_level(&self, level: LogLevel)

Set the log level

pub fn mark_failed(&self)

Mark the plugin as failed

This is called when a panic is caught at the FFI boundary or when an unrecoverable error occurs. It immediately transitions the plugin to the Failed state.

After calling this method, the plugin will reject all further requests. The host should call plugin_shutdown to clean up resources.

pub fn rejected_request_count(&self) -> u64

Get the count of requests rejected due to concurrency limits

Trait Implementations

impl Send for PluginHandle

impl Sync for PluginHandle