elicitation 0.10.0

Conversational elicitation of strongly-typed Rust values via MCP
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

//! [`PluginContext`] — marker trait for plugin-specific server-side state.
//!
//! Each shadow crate that needs long-lived resources (connection pools,
//! credentials, transaction registries) defines its own context struct and
//! implements [`PluginContext`].  The context is held behind `Arc` and shared
//! across all tool calls on the same server instance.
//!
//! Stateless plugins that require no server-side state use [`NoContext`].

/// Marker trait for plugin-specific server-side state.
///
/// Implement this on a struct that holds the resources a plugin needs across
/// tool calls (e.g. an HTTP client, a database pool).  The struct is wrapped
/// in `Arc` and passed to every context-aware tool handler.
///
/// # Example
///
/// ```rust
/// use elicitation::plugin::PluginContext;
///
/// pub struct MyContext {
///     pub value: u32,
/// }
///
/// impl PluginContext for MyContext {}
/// ```
pub trait PluginContext: std::any::Any + Send + Sync + 'static {}

/// No-op context for stateless plugins.
///
/// Plugins that require no server-side state use `NoContext` as their context
/// type.  `#[derive(ElicitPlugin)]` on a unit struct automatically uses this.
#[derive(Debug, Default, Clone)]
pub struct NoContext;

impl PluginContext for NoContext {}