Struct ScopeConfig 

pub struct ScopeConfig {
    pub scopes: Vec<String>,
    pub sub: String,
    pub expires_at: u64,
    pub rate_config: Option<RateConfig>,
}

Scope configuration — constructed from JWT claims or programmatically.

Fields

scopes: Vec<String>

Parsed scope strings (e.g. [“tool:web_search”, “tool:github:*”, “help”]).

sub: String

Agent identity (from JWT sub claim).

expires_at: u64

Expiry timestamp (from JWT exp claim). 0 = no expiry.

rate_config: Option<RateConfig>

Per-tool rate limits parsed from JWT claims.

Implementations

impl ScopeConfig

pub fn from_jwt(claims: &TokenClaims) -> Self

Build a ScopeConfig from JWT TokenClaims.

pub fn unrestricted() -> Self

Create an unrestricted scope config (for dev mode / no JWT set).

pub fn is_expired(&self) -> bool

Check if the scopes have expired.

pub fn is_allowed(&self, tool_scope: &str) -> bool

Check if a specific tool scope is allowed.

Supports:

• Exact match: "tool:web_search" matches "tool:web_search"
• Wildcard suffix: "tool:github:*" matches "tool:github:search_repos"
• Global wildcard: "*" matches everything
• Empty tool scope: always allowed (tool has no scope requirement)

pub fn check_access( &self, tool_name: &str, tool_scope: &str, ) -> Result<(), ScopeError>

Check access for a tool, returning an error if denied.

pub fn time_remaining(&self) -> Option<u64>

Get time remaining until expiry, in seconds. Returns None if no expiry.

pub fn tool_scope_count(&self) -> usize

Number of tool scopes (those starting with “tool:”).

pub fn skill_scope_count(&self) -> usize

Number of skill scopes (those starting with “skill:”).

pub fn help_enabled(&self) -> bool

Check if help is enabled.

pub fn is_wildcard(&self) -> bool

Check if this is an unrestricted (wildcard) scope.

Trait Implementations

impl Clone for ScopeConfig

fn clone(&self) -> ScopeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScopeConfig

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

Formats the value using the given formatter.