AuthorityScope
v1.0.0Agent supervision (S27): declares what an agent is PERMITTED to do. Renders the human-granted authority boundary — grant summary, permitted/denied action list with text labels, notional caps with gold usage bars, expiry, accountable grantor, and a revoke control. Validation gold frames the grant.
import { AuthorityScope } from "@nodus/design-system"Props
| Prop | Type | Default | Description |
|---|---|---|---|
agentreq | string | — | Agent the authority is granted to. |
scopereq | string | — | One-line grant summary. |
actionsreq | AuthorityAction[] | — | Permitted / denied action list. Denied actions render a text label, never color alone. |
caps | AuthorityCap[] | — | Quantitative caps (label / limit / used). Usage renders a gold bar with a text percentage. |
expiresAt | string | — | ISO timestamp — when the grant lapses. Rendered as a static UTC date. |
grantedBy | string | — | Accountable human who granted the authority. |
onRevoke | () => void | — | Renders a "Revoke authority" button when provided. |
agentrequiredstringDefault —Agent the authority is granted to.
scoperequiredstringDefault —One-line grant summary.
actionsrequiredAuthorityAction[]Default —Permitted / denied action list. Denied actions render a text label, never color alone.
capsAuthorityCap[]Default —Quantitative caps (label / limit / used). Usage renders a gold bar with a text percentage.
expiresAtstringDefault —ISO timestamp — when the grant lapses. Rendered as a static UTC date.
grantedBystringDefault —Accountable human who granted the authority.
onRevoke() => voidDefault —Renders a "Revoke authority" button when provided.
This component was designed to express:
Explore Related
Agent supervision (S27): the undo horizon after an agent acts. Shows the executed action (agency red accent), a live time-remaining countdown to the reversal deadline, REVERSIBLE / REVERSED / FINAL text badges, audit reference, and a gold reverse control with optional reason input — the human decision moment.
Agent supervision (S27): interruptible running log of agent actions. Rows carry UTC mono timestamps and text status badges (COMPLETED / IN PROGRESS / QUEUED / BLOCKED); in-progress rows pulse in temporal blue. The gold control rail — Pause / Stop / Hand back — is the human's interruption authority.
Binary approve/deny gate with ceremony-level friction