Registry & Profiles

The AccessRegistry stores users, groups, custom roles, and agent profiles. Permission resolution merges role defaults with group and user-level overrides.

Registry Contents

StoreKeyValue Type
usersUserIdUserProfile (display_name, role, overrides, group_ids, enabled)
groupsGroupIdGroup (role, overrides, entity_scope, member_user_ids, member_agent_ids)
custom_rolesCustomRoleIdCustomRoleDefinition (base_role, permissions)
agent_profilesAgentProfileIdAgentProfile (agent_type, role, overrides, entity_scope)

Agent Types

TypePresets
LlmReadOnly, Operator, Full, Custom
ControlNamed agent_id (e.g. "hvac_controller")

Permission Resolution

Text
// Resolution order (later overrides earlier):
// 1. User role → default_permissions()
// 2. Group role → default_permissions()
// 3. Group permission_overrides
// 4. User permission_overrides
//
// For agents: profile role + profile overrides

Questions?

Reach out for help with integration, deployment, or custom domain codecs.