Struct PluginContext 

pub struct PluginContext {
    pub request_id: String,
    pub session_id: String,
    pub request_payload: Value,
    pub response_payload: Option<Value>,
    pub metrics: HookMetrics,
    pub metadata: HashMap<String, String>,
}

Rich context passed to every pre- and post-inference hook.

Hooks receive a shared reference to this struct; they cannot modify the pipeline payload directly — they should use the returned PluginOutput mechanism for that. The hook context is purely informational.

Fields

request_id: String

Unique ID for the in-flight request.

session_id: String

Session the request belongs to.

request_payload: Value

The raw prompt/payload as submitted to the pipeline stage.

response_payload: Option<Value>

The model response, if available (only set for post-inference hooks).

metrics: HookMetrics

Performance / cost metrics for this request.

metadata: HashMap<String, String>

Arbitrary metadata forwarded from the original crate::PromptRequest.

Implementations

impl PluginContext

pub fn pre_inference( request_id: impl Into<String>, session_id: impl Into<String>, request_payload: Value, metadata: HashMap<String, String>, elapsed_ms: u64, ) -> Self

Build a pre-inference context (no response yet).

Panics

This function does not panic.

pub fn post_inference( request_id: impl Into<String>, session_id: impl Into<String>, request_payload: Value, response_payload: Value, metadata: HashMap<String, String>, elapsed_ms: u64, prompt_tokens: Option<u64>, completion_tokens: Option<u64>, estimated_cost_usd: f64, ) -> Self

Build a post-inference context (response is available).

Panics

This function does not panic.

pub fn into_plugin_input(self) -> PluginInput

Convert this context into a PluginInput for use with PluginChain::run.

The request_payload becomes the chain payload; response_payload (if present) is injected into metadata under the key "response_payload_json".

Panics

This function does not panic.

Trait Implementations

impl Clone for PluginContext

fn clone(&self) -> PluginContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PluginContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.