Skip to content

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.