Struct CapabilityConstraints 

pub struct CapabilityConstraints {
    pub max_uses: Option<u64>,
    pub current_uses: u64,
    pub rate_limit: Option<RateLimit>,
    pub recent_use_timestamps: Vec<i64>,
    pub time_windows: Vec<TimeWindow>,
    pub requires_approval: bool,
    pub approval_timeout_ms: Option<u64>,
    pub custom: HashMap<String, String>,
}

Constraints on capability usage.

Fields

max_uses: Option<u64>

Maximum invocations.

current_uses: u64

Current usage count.

rate_limit: Option<RateLimit>

Rate limit.

recent_use_timestamps: Vec<i64>

Recent usage timestamps for rate limit enforcement (Unix ms). Entries older than the rate limit period are pruned on check.

time_windows: Vec<TimeWindow>

Time windows when capability is valid.

requires_approval: bool

Required approval for each use.

approval_timeout_ms: Option<u64>

Approval timeout in milliseconds.

custom: HashMap<String, String>

Custom constraints as key-value pairs.

Implementations

impl CapabilityConstraints

pub fn new() -> Self

Create empty constraints.

pub fn with_max_uses(self, max: u64) -> Self

Set max uses.

pub fn with_rate_limit(self, limit: RateLimit) -> Self

Set rate limit.

pub fn with_time_window(self, window: TimeWindow) -> Self

Add a time window.

pub fn with_requires_approval(self, timeout: Duration) -> Self

Require approval for each use.

pub fn with_custom( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Add a custom constraint.

pub fn approval_timeout(&self) -> Option<Duration>

Get approval timeout as Duration.

pub fn is_usage_limit_reached(&self) -> bool

Check if usage limit is reached.

pub fn increment_usage(&mut self) -> Result<()>

Increment usage count. Returns error if limit reached.

pub fn is_rate_limited(&self, now: i64) -> bool

Check if the rate limit is exceeded at the given timestamp.

Returns true if the number of recent uses within the rate limit period meets or exceeds max_requests.

pub fn record_rate_limit_use(&mut self, now: i64)

Record a usage for rate limiting purposes.

Prunes timestamps older than the rate limit window.

Trait Implementations

impl Clone for CapabilityConstraints

fn clone(&self) -> CapabilityConstraints

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CapabilityConstraints

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

Formats the value using the given formatter.

impl Default for CapabilityConstraints

fn default() -> CapabilityConstraints

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CapabilityConstraints

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CapabilityConstraints

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

where __S: Serializer,

Serialize this value into the given Serde serializer.