Struct SkillCard 

pub struct SkillCard {

    pub id: String,
    pub symbol: Symbol,
    pub aliases: Vec<Symbol>,
    pub origin: Symbol,
    pub title: String,
    pub description: String,
    pub input_shape: ShapeRef,
    pub output_shape: ShapeRef,
    pub roles: Vec<SkillRole>,
    pub capabilities: Vec<CapabilityName>,
    pub policy: SkillPolicy,
    pub transport_id: String,
    pub transport_kind: String,
    pub operation: String,
}

Full runtime description of a single skill.

A card carries the skill’s identity and symbol, its input and output shape contracts, the roles it plays, the capabilities required to call it, its SkillPolicy, and the transport coordinates (id, kind, and operation) used to dispatch a call. It is a shape-bearing runtime handle; its serializable projection is the SkillCardDescriptor (skill/Card).

Fields

id: String

Stable string identifier for the skill.

symbol: Symbol

Symbol the skill is registered and called under.

aliases: Vec<Symbol>

Additional symbols that also resolve to this skill.

origin: Symbol

Symbol naming where the card came from (for example fixture).

title: String

Human-readable title.

description: String

Human-readable description of what the skill does.

input_shape: ShapeRef

Shape contract the call arguments must satisfy.

output_shape: ShapeRef

Shape contract the call result must satisfy.

roles: Vec<SkillRole>

Roles this skill plays for an agent.

capabilities: Vec<CapabilityName>

Capabilities a caller must hold to invoke the skill.

policy: SkillPolicy

Privacy, caching, and recording policy.

transport_id: String

Identifier of the transport that runs the skill.

transport_kind: String

Kind of the transport (for example fixture, mcp, http).

operation: String

Operation name the transport dispatches for this skill.

Implementations

impl SkillCard

pub fn fixture(spec: FixtureSkillSpec) -> Self

Builds a fixture skill card from spec.

The card is given the fixture origin, the SkillRole::Tool role, a default SkillPolicy, and a single skill-specific call capability.

pub fn with_capability(self, capability: CapabilityName) -> Self

Returns the card with capability appended to its required capabilities.

pub fn with_role(self, role: SkillRole) -> Self

Returns the card with role added if it is not already present.

pub fn with_policy(self, policy: SkillPolicy) -> Self

Returns the card with its policy replaced by policy.

pub fn with_cache_mode(self, cache: SkillCacheMode) -> Self

Returns the card with its cache mode set to cache.

pub fn with_cassette_mode(self, cassette: SkillCassetteMode) -> Self

Returns the card with its cassette mode set to cassette.

pub fn with_idempotent(self, idempotent: bool) -> Self

Returns the card with its idempotency flag set to idempotent.

pub fn with_semantic_key(self, semantic_key: impl Into<String>) -> Self

Returns the card with its semantic key set to semantic_key.

pub fn with_privacy(self, privacy: SkillPrivacyPolicy) -> Self

Returns the card with its privacy policy set to privacy.

pub fn value(&self, cx: &mut Cx) -> Result<Value>

Wraps the card in an opaque runtime Value.

pub fn table_value(&self, cx: &mut Cx) -> Result<Value>

Projects the card into a table Value describing its fields.

impl SkillCard

pub fn to_expr(&self, cx: &mut Cx) -> Result<Expr>

Encodes the card as a skill/card map Expr, the inverse of SkillCard::from_expr.

pub fn from_expr(expr: &Expr) -> Result<Self>

Decodes a card from a skill/card map Expr, the inverse of SkillCard::to_expr.

Missing policy fields fall back to SkillPolicy::default.

Trait Implementations

impl Clone for SkillCard

fn clone(&self) -> SkillCard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Object for SkillCard

fn display(&self, _cx: &mut Cx) -> Result<String>

Render the object as a human-readable display string.

fn as_any(&self) -> &dyn Any

Expose the object for Rust downcasting.

fn header(&self) -> &ObjectHeader

Identity and trust header for the object; defaults to the shared anonymous header.

fn op(&self, _key: &OpKey) -> Option<&dyn Op>

Resolve the operation registered under key, if any.

fn claims( &self, _cx: &mut Cx, _pattern: &ClaimPattern, _sink: &mut dyn ClaimSink, ) -> Result<(), Error>

Emit the object’s claims matching pattern into sink.

fn snapshot(&self, _cx: &mut Cx) -> Result<Option<Datum>, Error>

Optional content-addressable snapshot of the object’s state.

impl ObjectCompat for SkillCard

fn as_expr(&self, cx: &mut Cx) -> Result<Expr>

Expression form of the object; defaults to an opaque extension node.

fn as_table(&self, cx: &mut Cx) -> Result<Value>

Project the object into a table value; the default exposes its display.

fn class(&self, cx: &mut Cx) -> Result<Value, Error>

Class object this value belongs to; defaults to nil.

fn as_callable(&self) -> Option<&dyn Callable>

Callable view, if the object can be invoked.

fn as_class(&self) -> Option<&dyn Class>

Class view, if the object is a class.

fn as_shape(&self) -> Option<&dyn Shape>

Shape view, if the object is a shape.

fn as_object_encoder(&self) -> Option<&dyn ObjectEncode>

Object-encoder view, if the object encodes other objects.

fn as_read_constructor(&self) -> Option<&dyn ReadConstructor>

Read-constructor view, if the object decodes data forms.

fn as_number_domain(&self) -> Option<&(dyn NumberDomain + 'static)>

Number-domain view, if the object is a number domain.

fn as_number_value(&self) -> Option<&dyn NumberValue>

Number-value view, if the object is a domain number.

fn as_eval_fabric(&self) -> Option<&dyn EvalFabric>

Eval-fabric view, if the object is a distributed eval surface.

fn as_stream(&self) -> Option<&dyn Stream>

Stream view, if the object is a stream.

fn as_sequence(&self) -> Option<&dyn Sequence>

Sequence view, if the object is a sequence.

fn as_thunk(&self) -> Option<&dyn Thunk>

Thunk view, if the object is a deferred computation.

fn as_list(&self) -> Option<&(dyn ListValue + 'static)>

List view, if the object is a list value.

fn as_table_impl(&self) -> Option<&(dyn Table + 'static)>

Table-implementation view, if the object is a table.

fn as_dir(&self) -> Option<&(dyn Dir + 'static)>

Directory view, if the object is a directory.

fn truth(&self, _cx: &mut Cx) -> Result<bool, Error>

Truthiness of the object; defaults to true.

fn publish_shape_satisfaction_claims( &self, _cx: &mut Cx, _shape: &Ref, ) -> Result<bool, Error>

Publish claims asserting that the object satisfies shape; returns whether any were published.