Struct PluginSession 

#[non_exhaustive]
pub struct PluginSession { /* private fields */ }

Reusable in-process plugin session for conformance dispatch checks.

PluginSession is intentionally not cloneable: an Extism plugin instance is mutable execution state and dispatch requires &mut self. Panics inside Extism’s wire-call path are caught by cc_lb_runtime_protocol::dispatch::dispatch_wire_call and surface as DispatchOutcome::Fallback with the dispatched function’s FallbackPolicy. Such a fallback does not poison the session; later dispatches use the same plugin instance normally.

Implementations

impl PluginSession

pub fn new(wasm: &[u8]) -> Result<Self, HandshakeError>

Instantiate a plugin and run handshake with no host capabilities.

pub fn new_with_caps( wasm: &[u8], host_capabilities: &BTreeSet<String>, ) -> Result<Self, HandshakeError>

Instantiate a plugin and run handshake with caller-supplied host capabilities.

pub fn dispatch<F: WireFunction>( &mut self, request: F::Request, ) -> DispatchOutcome<F::Response>

Dispatch one wire call through the existing plugin instance.

This mirrors the protocol layer: wire-call failures never return Result::Err and instead become DispatchOutcome::Fallback. The call is not retried.