Struct ToolDescriptor 

pub struct ToolDescriptor {
    pub tool_id: String,
    pub name: String,
    pub version: String,
    pub description: Option<String>,
    pub input_schema: Option<String>,
    pub output_schema: Option<String>,
    pub requires: Vec<String>,
    pub estimated_time_ms: u32,
    pub stateless: bool,
    pub streaming: bool,
    pub tags: Vec<String>,
    pub node_count: u32,
}

One row in the result of MeshNode::list_tools(...). Aggregates a single (tool_id, version) across however many nodes currently advertise it via the capability fold; node_count is filled by the aggregator and is 0 on a freshly-constructed descriptor.

Source-of-truth fields are pulled from ToolCapability (tool_id / name / version / input_schema / output_schema / requires / estimated_time_ms / stateless) plus CapabilitySet::metadata keys description_metadata_key, streaming_metadata_key, and tags_metadata_key.

Fields

tool_id: String

nRPC service name. Same string the caller passes to TypedMeshRpc::call / call_service / call_service_streaming.

name: String

Human-readable name. Same field as ToolCapability::name.

version: String

Tool version (semver-ish). Aggregation dedupes by (tool_id, version); two nodes advertising the same tool at different versions surface as separate descriptors.

description: Option<String>

Human-readable description; the model reads this to decide when/how to call. None for legacy tools that didn’t go through serve_tool.

input_schema: Option<String>

JSON Schema (draft 2020-12) for the request body. None when the schema is too large for the capability fold’s per-entry budget; fetch via the future tool.metadata.fetch RPC.

output_schema: Option<String>

JSON Schema for the response body. None for non-strict tools (many models don’t require it).

requires: Vec<String>

Required dependencies / sibling capabilities — direct mirror of ToolCapability::requires.

estimated_time_ms: u32

Soft latency hint for the model scheduler / UI spinner. 0 if the host didn’t supply an estimate.

stateless: bool

Tool is a pure function (same input → same output, no session state). Adapters use this to decide caching + parallel-invocation safety.

streaming: bool

true if the handler is server-streaming (serve_tool_streaming). Adapters lower this into their provider’s streaming protocol.

tags: Vec<String>

Free-form tags the host attached at register time.

node_count: u32

How many nodes currently advertise this (tool_id, version) pair across the scope queried. Filled by the aggregator; stays at 0 on a freshly-constructed descriptor.

Implementations

impl ToolDescriptor

pub fn from_capability( cap: &ToolCapability, metadata: &BTreeMap<String, String>, ) -> ToolDescriptor

Build a descriptor from one ToolCapability + the metadata map it was announced with. node_count is left at 0; the MeshNode::list_tools aggregator fills it during the merge pass.

The metadata map is CapabilitySet::metadata — the same hook ToolCapability::input_schema_metadata_key / output_schema_metadata_key use.

Trait Implementations

impl Clone for ToolDescriptor

fn clone(&self) -> ToolDescriptor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolDescriptor

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolDescriptor

fn deserialize<__D>( __deserializer: __D, ) -> Result<ToolDescriptor, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ToolDescriptor

impl PartialEq for ToolDescriptor

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ToolDescriptor

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ToolDescriptor