Struct DeclareCapabilityRequest 

pub struct DeclareCapabilityRequest {
    pub provider_id: String,
    pub contract_id: String,
    pub transport: i32,
    pub endpoint: String,
    pub params: Option<TransportParams>,
    pub description: String,
}

Fields

provider_id: String

Owning CapabilityProvider (primitive/service/skill); MUST already be registered.

contract_id: String

contract_id, e.g. “robonix/primitive/camera/depth”.

transport: i32

endpoint: String

Preferred address string. Format is transport-specific: grpc: “127.0.0.1:50105” (caller binds first) ros2: “/scanner/cloud” (“” => Atlas mints) mcp: “http://host:port/mcp"

Conflict resolution:

• empty proposal + mintable transport (ros2) -> Atlas mints /rbnx/<dotted-contract>/<uuid8>
• empty proposal + non-mintable transport (grpc, mcp) -> InvalidArgument
• non-empty + no collision -> stored verbatim
• non-empty + collision + mintable -> Atlas rewrites by appending __<uuid8>
• non-empty + collision + non-mintable -> AlreadyExists (caller picks new and retries)

CALLER MUST USE the returned endpoint.

params: Option<TransportParams>

Transport-specific params; the oneof variant MUST match transport.

description: String

Instance-specific natural-language description for THIS particular Capability instance – the part that’s specific to this provider’s setup, on top of whatever the contract already says generically. Example: contract robonix/primitive/camera/rgb already explains “returns current RGB image as sensor_msgs/Image”; this field adds “front-facing, 640x480 @ 30 Hz, no exposure compensation” for the front_camera instance specifically. Surfaced to Pilot / LLM.

Filled by the CapabilityProvider – either explicitly, or auto- filled by the framework from the handler’s docstring (e.g. robonix_api’s @cap.mcp(...) / @cap.grpc(...) wrappers read the wrapped function’s docstring into this field before calling DeclareCapability). Either way, only this single field hits the wire.

SHOULD be one short line (~200 chars or less); longer prose belongs in CAPABILITY.md.

Optional; may be empty when the contract’s description already says everything that needs saying. Consumers MERGE this with ContractDescriptor.description at consume time – the two are not alternatives; they cover generic vs instance-specific aspects of the same Capability and may overlap. The CapabilityProvider’s CAPABILITY.md is a separate, long-form per-CapabilityProvider doc (see RegisterRequest.capability_md_path), surfaced alongside.

Implementations

impl DeclareCapabilityRequest

pub fn transport(&self) -> Transport

Returns the enum value of transport, or the default if the field is set to an invalid enum value.

pub fn set_transport(&mut self, value: Transport)

Sets transport to the provided enum value.

Trait Implementations

impl Clone for DeclareCapabilityRequest

fn clone(&self) -> DeclareCapabilityRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeclareCapabilityRequest

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

Formats the value using the given formatter.

impl Default for DeclareCapabilityRequest

fn default() -> Self

Returns the “default value” for a type.

impl Eq for DeclareCapabilityRequest

impl Hash for DeclareCapabilityRequest

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Message for DeclareCapabilityRequest

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for DeclareCapabilityRequest

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