Struct CSpace 

pub struct CSpace {
    pub agent_id: AgentId,
    /* private fields */
}

An agent’s capability space: the complete set of capabilities it holds.

The CSpace is a HashMap<CapabilityId, Capability>. When the AccessManager checks whether an agent may perform an action, it scans the agent’s CSpace for a capability matching the target resource with sufficient rights.

Fields

agent_id: AgentId

The agent that owns this capability space.

Implementations

impl CSpace

pub fn new(agent_id: AgentId) -> Self

Creates an empty CSpace for the given agent.

pub fn insert(&mut self, cap: Capability) -> Option<Capability>

Inserts a capability into this space, returning the old one if replaced.

pub fn remove(&mut self, id: &CapabilityId) -> Option<Capability>

Removes a capability by ID.

pub fn get(&self, id: &CapabilityId) -> Option<&Capability>

Looks up a capability by ID.

pub fn can(&self, resource: &ResourceRef, required: Rights) -> bool

Returns true if any capability in this space matches the resource and grants the requested rights.

pub fn iter(&self) -> impl Iterator<Item = &Capability>

Returns an iterator over all capabilities in this space.

pub fn len(&self) -> usize

Returns the number of capabilities.

pub fn is_empty(&self) -> bool

Returns true if there are no capabilities.

pub fn retain(&mut self, pred: impl Fn(&Capability) -> bool)

Retains only capabilities for which pred returns true.

pub fn filter_resource( &self, f: impl Fn(&ResourceRef) -> bool, ) -> Vec<&Capability>

Returns capabilities matching a specific resource type filter.

pub fn active_domains(&self) -> Vec<&str>

Returns the unique kernel domain names active in this CSpace.

Useful for building a kernel manifest for the system prompt.

Trait Implementations

impl Clone for CSpace

fn clone(&self) -> CSpace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CSpace

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CSpace

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CSpace

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

where __S: Serializer,

Serialize this value into the given Serde serializer.