Struct ToolRoute 

pub struct ToolRoute {
    pub capability_id: CapabilityId,
    pub canonical_tool_name: CanonicalToolName,
    pub namespace: CapabilityNamespace,
    pub source: SourceRef,
    pub destination: DestinationRef,
    pub executor_ref: Option<ExecutorRef>,
    pub policy_refs: Vec<PolicyRef>,
    pub sidecar_refs: Vec<PackageSidecarRef>,
    pub effect_class: EffectClass,
    pub risk_class: RiskClass,
    pub privacy: PrivacyClass,
    pub retention: RetentionClass,
}

Carries tool route data across a host-port boundary. Constructing the value does not call the host; the port method that receives it documents any adapter, network, or storage effect.

Fields

capability_id: CapabilityId

Stable capability identifier used for package projection and executable routing.

canonical_tool_name: CanonicalToolName

Canonical tool name used by this record or request.

namespace: CapabilityNamespace

Namespace that groups this capability or identifier. Use it to avoid collisions between packages, hosts, and extensions.

source: SourceRef

Source label or ref for this item; it is metadata and does not fetch content by itself.

destination: DestinationRef

Destination label or ref for this item; it is metadata and does not deliver content by itself.

executor_ref: Option<ExecutorRef>

Typed executor ref reference. Resolving or executing it is a separate policy-gated step.

policy_refs: Vec<PolicyRef>

Policy references that govern admission, projection, execution, or delivery.

sidecar_refs: Vec<PackageSidecarRef>

References to typed package sidecars needed by this capability.

effect_class: EffectClass

Classification value for effect class. Policy and projection paths use it for finite routing decisions.

risk_class: RiskClass

Risk classification for the operation or capability. Policy uses it to decide whether approval, sandboxing, or denial is required.

privacy: PrivacyClass

Privacy class used for projection, telemetry, and raw-content access decisions.

retention: RetentionClass

Retention class used by hosts and sinks when storing or exporting this item.

Implementations

impl ToolRoute

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

Validates the ports::tool invariants and returns a typed error on failure. Validation is pure and does not perform I/O, dispatch, journal appends, or adapter calls.

Trait Implementations

impl Clone for ToolRoute

fn clone(&self) -> ToolRoute

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolRoute

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolRoute

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ToolRoute

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ToolRoute

impl StructuralPartialEq for ToolRoute