Struct ToolkitHooks 

pub struct ToolkitHooks { /* private fields */ }

The registered E1 policy and E2 validators, passed as a PARAMETER to an assembly entry point.

Why a parameter and not a builder field

ServerBuilderExt is implemented for CORE’s pmcp::ServerBuilder, whose fields are private. A Rust extension trait cannot add a field to a foreign type, so a with_request_policy(self) -> Self on that trait would have nowhere to accumulate. Two alternatives were rejected: a newtype wrapper around ServerBuilder would force every existing ServerBuilderExt user to change type, and adding an extension-storage mechanism to core’s ServerBuilder is a core API change this phase did not scope.

Example

use std::sync::Arc;
use pmcp_server_toolkit::{ArgumentRefusal, ArgumentValidator, ToolkitHooks};
use serde_json::Value;

struct Never;
impl ArgumentValidator for Never {
    fn validate(&self, _args: &Value) -> Result<(), ArgumentRefusal> {
        Err(ArgumentRefusal::new("this tool is disabled"))
    }
}

let hooks = ToolkitHooks::default().with_argument_validator("get_line_status", Arc::new(Never));
assert_eq!(hooks.validator_names(), vec!["get_line_status"]);

Implementations

impl ToolkitHooks

pub fn new() -> Self

No policy and no validators — the shape every pre-existing entry point passes, so a server that registers neither behaves exactly as before.

pub fn with_request_policy(self, policy: Arc<dyn RequestPolicy>) -> Self

Register the E1 RequestPolicy, replacing any already set.

pub fn with_argument_validator( self, tool: impl Into<String>, validator: Arc<dyn ArgumentValidator>, ) -> Self

Register an E2 ArgumentValidator for one tool name (last one wins).

pub fn request_policy(&self) -> Option<Arc<dyn RequestPolicy>>

The registered RequestPolicy, if any.

pub fn argument_validator_for( &self, tool: &str, ) -> Option<Arc<dyn ArgumentValidator>>

The ArgumentValidator registered for tool, if any.

Named argument_validator_for and NOT validator_for: the root crate’s tests/v2_schema_tripwires.rs scans every workspace source file for the token validator_for( as the signature of a jsonschema validator being constructed, and requires each site to declare its dialect policy. A method with that name here — and every call to it — would fire that security tripwire on code that has nothing to do with JSON Schema dialects, and the only ways out would be to bloat a dialect allowlist with non-dialect entries or to re-fire on every future call site. Measured: the short name failed the tripwire with two UNKNOWN sites.

pub fn validator_names(&self) -> Vec<&str>

Registered validator tool names, sorted.

pub fn is_empty(&self) -> bool

Whether this value registers nothing at all — the Default shape.

Read by the assembly paths so a hooks value that registers something can be reported in the startup log, and so a path with no surface to apply a policy to can say so rather than accept it silently.

Trait Implementations

impl Clone for ToolkitHooks

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolkitHooks

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

Formats the value using the given formatter.

impl Default for ToolkitHooks

fn default() -> Self

Returns the “default value” for a type.