Struct CapabilitySpec 

pub struct CapabilitySpec {

    pub capability_id: CapabilityId,
    pub kind: CapabilityKind,
    pub source: CapabilitySource,
    pub namespace: CapabilityNamespace,
    pub version: CapabilityVersion,
    pub visibility: CapabilityVisibility,
    pub projection: ProjectionMode,
    pub executor_ref: Option<ExecutorRef>,
    pub policy_ref: PolicyRef,
    pub sidecar_refs: Vec<PackageSidecarRef>,
    pub isolation_ref: Option<PackageSidecarRef>,
    pub privacy: PrivacyClass,
    pub readiness: CapabilityReadiness,
}

Describes the capability spec portion of a runtime package snapshot. Use it when package authors or tests need explicit package configuration; validation and activation happen in package/runtime coordinators.

Fields

capability_id: CapabilityId

Stable capability identifier used for package projection and executable routing.

kind: CapabilityKind

Kind/category for this record, capability, event, or detected resource.

source: CapabilitySource

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

namespace: CapabilityNamespace

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

version: CapabilityVersion

Version string for this capability, package, or protocol surface. Use it for compatibility checks during package or adapter resolution.

visibility: CapabilityVisibility

Visibility class for the capability or result. Discovery and projection use it to decide what callers or models can see.

projection: ProjectionMode

Projection controls for exposing data to a provider or subscriber. Use it to keep provider-visible data separate from private SDK state.

executor_ref: Option<ExecutorRef>

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

policy_ref: PolicyRef

Policy reference that must be resolved by the host or runtime before execution.

sidecar_refs: Vec<PackageSidecarRef>

References to typed package sidecars needed by this capability.

isolation_ref: Option<PackageSidecarRef>

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

privacy: PrivacyClass

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

readiness: CapabilityReadiness

Readiness state for a capability or package feature. Launch and package validation use it to distinguish active, reserved, and blocked surfaces.

Implementations

impl CapabilitySpec

pub fn fake_tool( capability_id: impl Into<CapabilityId>, name: impl Into<String>, schema_ref: PackageSidecarRef, executor_ref: ExecutorRef, policy_ref: PolicyRef, source: SourceRef, ) -> Self

Returns fake tool for the current value. This is a read-only or data-construction helper unless the method body explicitly calls a port or store.

pub fn reserved_inactive( capability_id: impl Into<CapabilityId>, kind: CapabilityKind, policy_ref: PolicyRef, source: SourceRef, ) -> Self

Builds the reserved inactive value with the documented defaults. This is data-only and does not perform I/O, call host ports, append journals, publish events, or start processes.

pub fn provider_visible(&self) -> bool

Computes or returns provider visible for the package::capability contract without external I/O or side effects.

pub fn executable(&self) -> bool

Returns whether executable applies for this state. This is data-only and does not perform I/O, call host ports, append journals, publish events, or start processes.

pub fn project_for_provider( &self, ) -> Result<Option<ProviderCapabilityProjection>, AgentError>

Computes or returns project for provider for the package::capability contract without external I/O or side effects.

pub fn executable_route( &self, ) -> Result<Option<ExecutableCapabilityRoute>, AgentError>

Computes or returns executable route for the package::capability contract without external I/O or side effects.

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

Validates the package::capability 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 CapabilitySpec

fn clone(&self) -> CapabilitySpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CapabilitySpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CapabilitySpec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CapabilitySpec

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

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 CapabilitySpec

impl StructuralPartialEq for CapabilitySpec