Struct ToolEntry 

pub struct ToolEntry {
    pub name: String,
    pub description: String,
    pub discovery_summary: String,
    pub description_templates: Option<ToolDescriptionLibrary>,
    pub effect: EffectKind,
    pub risk: RiskClass,
    pub schema: Value,
    pub footprint: FootprintSpec,
    pub proposal_bindings: Vec<ProposalBinding>,
    pub durable: bool,
    pub origin: ToolOrigin,
    pub hot: bool,
}

One tool in the catalog.

Fields

name: String

description: String

discovery_summary: String

Trusted text tool_search ranks by, when non-empty (PSP-10 system 25). Separate from the model-facing description so untrusted external descriptions never steer discovery.

description_templates: Option<ToolDescriptionLibrary>

Optional per-route presentation library; absent means the route-neutral description serves every route.

effect: EffectKind

risk: RiskClass

schema: Value

JSON Schema for the tool’s arguments.

footprint: FootprintSpec

Declarative selectors mapping validated arguments to resources.

proposal_bindings: Vec<ProposalBinding>

Deterministic argument-to-proposal bindings.

durable: bool

Whether the tool mutates durable state (gates R5 bracketing).

origin: ToolOrigin

hot: bool

Part of the hot set: visible without discovery. The domain’s common operating loop (read, edit, test, build, format) stays hot; deferred discovery is for rare tools and external servers, never the basic loop. Context economy only — authority is still the kernel’s.

Implementations

impl ToolEntry

pub fn hot(self) -> Self

Mark this entry hot (visible without discovery).

pub fn validate(&self) -> Result<()>

Validate the entry at catalog-assembly time (Gates J and P).

The schema must be an object schema; the footprint must reference only declared arguments; and a mutating effect must declare a footprint.

pub fn validate_arguments(&self, arguments: &Value) -> Result<()>

Validate provider-supplied arguments locally. Provider strict-schema support is only an optimization; this is the harness trust boundary. Catalog assembly guarantees the schema belongs to the profile this validator implements completely.

pub fn to_spec(&self, strict: bool) -> ToolSpec

The wire-neutral spec sent to a model.

pub fn to_spec_for_route(&self, route: &PromptRoute, strict: bool) -> ToolSpec

The spec compiled for one prompt route (PSP-10 system 25). With no description library this equals ToolEntry::to_spec byte for byte; with one, the first matching override (exact "adapter/family", then adapter, then family) replaces only the description — never authority fields.

pub fn discovery_text(&self) -> &str

The text tool_search ranks: the discovery summary when present, else the route-neutral description.

Trait Implementations

impl Clone for ToolEntry

fn clone(&self) -> ToolEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ToolEntry

fn eq(&self, other: &ToolEntry) -> 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 ToolEntry

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 ToolEntry