capabilities
diapason.security.capabilities
¶
RBAC capability system — fine-grained permission model for tool dispatch.
AgentPolicy
dataclass
¶
Policy for a specific agent.
Capability
¶
Bases: str, Enum
Fine-grained capability labels.
CapabilityGrant
dataclass
¶
A single capability grant for an agent.
CapabilityPolicy
¶
RBAC capability policy for tool dispatch.
Checks whether an agent has the required capability to invoke a tool. Policy can be loaded from a JSON file or configured programmatically.
Default policy: if no explicit policy exists for an agent, capabilities are denied. Callers must opt into a permissive policy explicitly.
default_deny
property
¶
Whether unmatched capability checks are denied.
has_explicit_policy
property
¶
Whether an administrator supplied a policy file.
check(agent_id, capability, resource='')
¶
Check whether agent_id has capability for resource.
Returns True if allowed, False if denied.
deny(agent_id, capability)
¶
Explicitly deny a capability to an agent.
grant(agent_id, capability, pattern='*')
¶
Grant a capability to an agent.
list_agents()
¶
List all agents with explicit policies.
list_grants(agent_id)
¶
List all grants for an agent.
save(path)
¶
Atomically save policy to an owner-only JSON file.