Struct ProviderToolSpec 

pub struct ProviderToolSpec {
    pub name: String,
    pub capability_id: CapabilityId,
    pub namespace: CapabilityNamespace,
    pub description: Option<String>,
    pub schema_ref: PackageSidecarRef,
    pub policy_refs: Vec<PolicyRef>,
    pub redacted_schema: Option<Value>,
}

Provider-visible tool declaration projected from runtime-package state.

This DTO is safe for provider adapters because it carries only stable names, refs, policy identifiers, and optional redacted schema bodies. Raw tool arguments and executable handles never appear here.

Fields

name: String

Provider-visible canonical function/tool name.

capability_id: CapabilityId

Stable capability id that owns this provider-visible declaration.

namespace: CapabilityNamespace

Capability namespace carried for lineage and collision debugging.

description: Option<String>

Bounded provider-visible tool description from the runtime package.

This is projection metadata only. It does not affect tool execution, approval, policy, or runtime-package identity.

schema_ref: PackageSidecarRef

Tool input schema ref. Resolving it is separate from constructing a provider request.

policy_refs: Vec<PolicyRef>

Policy refs that must still be evaluated by core before execution.

redacted_schema: Option<Value>

Redacted inline schema body, when a package helper has made one safe for provider projection. Adapters must use a bounded fallback when absent.

Implementations

impl ProviderToolSpec

pub fn new( name: impl Into<String>, capability_id: CapabilityId, namespace: CapabilityNamespace, schema_ref: PackageSidecarRef, policy_refs: Vec<PolicyRef>, ) -> Self

Builds a provider tool declaration from package and runtime routing data. This is projection only and performs no provider call or tool execution.

pub fn with_description(self, description: impl Into<String>) -> Self

Returns this declaration with a provider-visible description attached.

pub fn with_redacted_schema(self, schema: Value) -> Self

Returns this declaration with an inline redacted schema attached. The caller is responsible for supplying only provider-safe schema data.

pub fn provider_schema(&self) -> Value

Returns a provider-safe JSON schema body. If no inline schema body is present, the fallback is an object schema with SDK schema-ref metadata.

Trait Implementations

impl Clone for ProviderToolSpec

fn clone(&self) -> ProviderToolSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderToolSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProviderToolSpec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ProviderToolSpec

impl PartialEq for ProviderToolSpec

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

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 ProviderToolSpec