Struct Capabilities 

pub struct Capabilities {
    pub fs_read: Vec<PathPattern>,
    pub fs_write: Vec<PathPattern>,
    pub env_read: Vec<String>,
    pub net: Vec<NetPattern>,
    pub stdio: StdioCapability,
}

Plugin capability declarations

Plugins declare what system resources they need access to. The host will prompt users to grant these permissions before execution.

Example

use sen_plugin_api::{Capabilities, PathPattern, StdioCapability};

let caps = Capabilities::default()
    .with_fs_read(vec![PathPattern::new("./data").recursive()])
    .with_fs_write(vec![PathPattern::new("./output")])
    .with_stdio(StdioCapability::stdout_stderr());

Fields

fs_read: Vec<PathPattern>

Filesystem read access paths Relative paths resolved from CWD, supports ~ expansion

fs_write: Vec<PathPattern>

Filesystem write access paths

env_read: Vec<String>

Environment variable access patterns Supports glob: “MY_*”, exact: “HOME”

net: Vec<NetPattern>

Network access patterns (WASI Preview 2)

stdio: StdioCapability

Standard I/O access

Implementations

impl Capabilities

pub fn none() -> Self

Create empty capabilities (no permissions)

pub fn is_empty(&self) -> bool

Check if no capabilities are requested

pub fn with_fs_read(self, paths: Vec<PathPattern>) -> Self

Add filesystem read paths

pub fn with_fs_write(self, paths: Vec<PathPattern>) -> Self

Add filesystem write paths

pub fn with_env_read(self, patterns: Vec<String>) -> Self

Add environment variable patterns

pub fn with_net(self, patterns: Vec<NetPattern>) -> Self

Add network patterns

pub fn with_stdio(self, stdio: StdioCapability) -> Self

Set stdio capabilities

pub fn is_subset_of(&self, other: &Capabilities) -> bool

Check if self is a subset of other (all requested capabilities are granted)

pub fn compute_hash(&self) -> String

Compute hash for change detection

Uses blake3 for cross-process stability (unlike DefaultHasher which may produce different hashes across processes/runs).

Trait Implementations

impl Clone for Capabilities

fn clone(&self) -> Capabilities

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Capabilities

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

Formats the value using the given formatter.

impl Default for Capabilities

fn default() -> Capabilities

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Capabilities

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Capabilities

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

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 Capabilities

impl StructuralPartialEq for Capabilities