Struct ToolPrefix 

pub struct ToolPrefix(/* private fields */);

A validated McpConfig::tool_prefix value.

Every mcpls tool name gains a {prefix}_ prefix when this is configured, so an MCP client can tell apart tools exposed by multiple concurrently running mcpls bridges. A value must be non-empty, at most MAX_MCP_TOOL_PREFIX_BYTES bytes, contain only ASCII letters, digits, _, and -, and both start and end with an ASCII letter or digit – this last rule rejects (rather than silently strips) a trailing separator, so "optics" and "optics_" cannot become two spellings of the same configuration. The validator runs once, at construction, making an invalid prefix unrepresentable: there is no way to observe a ToolPrefix whose value doesn’t already satisfy these rules.

This differs from title/description/instructions, whose invalid values surface as Error::InvalidConfig from ServerConfig::validate – called explicitly, after loading. A malformed prefix is not merely cosmetic (it would put an invalid tool name on the wire, an MCP protocol violation), and McplsServer::new is pub and infallible, so this type validates eagerly during deserialization instead and surfaces failures as Error::TomlDe, which additionally carries the offending line from the TOML source.

Examples

use mcpls_core::config::ToolPrefix;

let prefix: ToolPrefix = "optics".parse().unwrap();
assert_eq!(prefix.as_str(), "optics");
assert!("optics_".parse::<ToolPrefix>().is_err());

Implementations

impl ToolPrefix

pub fn as_str(&self) -> &str

Returns the validated prefix as a string slice.

Trait Implementations

impl Clone for ToolPrefix

fn clone(&self) -> ToolPrefix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolPrefix

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolPrefix

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ToolPrefix

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

Formats the value using the given formatter.

impl Eq for ToolPrefix

impl FromStr for ToolPrefix

type Err = String

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for ToolPrefix

fn eq(&self, other: &ToolPrefix) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ToolPrefix

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ToolPrefix