CapabilityGrant

stable

Single permission grant card with conditions (time-bounded, value-bounded, approval-gated), audit trail toggle, and revoke trigger

Human-in-the-Loop/Storybook ↗

import { CapabilityGrant } from "@nodus/design-system/patterns"

transactonUSD payments ≤ $500K, SEPA only→ExecutorAgent

Active

⏱Time-bounded— Expires Apr 15, 2026

$Value-bounded— Up to $500,000 per transaction

✓Approval-gated— Requires Treasury Manager

Granted by K. Patel (Treasury Manager)On Apr 7, 2026, 02:33 AMID: grant-48

No audit trail

Loading demo…

Props

Prop	Type	Default	Description
`grantId`req	`string`	—	Unique grant identifier.
`agentName`req	`string`	—	Agent receiving the grant.
`capability`req	`string`	—	Capability name (e.g. TRANSACT).
`scope`req	`string`	—	Resource scope (e.g. treasury/accounts/*).
`status`req	`'active' \| 'conditional' \| 'revoked' \| 'expired'`	—	Grant status.
`grantedBy`req	`string`	—	Granting authority display name.
`grantedAt`req	`string`	—	ISO timestamp of grant issuance.
`conditions`	`GrantCondition[]`	—	Array of grant conditions.
`auditTrail`	`ProvenanceStep[]`	—	Audit events as ProvenanceChain steps.
`onRevoke`	`(grantId: string) => void`	—	Shows revoke button for active/conditional grants.

grantIdrequired

Type stringDefault —

Unique grant identifier.

agentNamerequired

Type stringDefault —

Agent receiving the grant.

capabilityrequired

Type stringDefault —

Capability name (e.g. TRANSACT).

scoperequired

Type stringDefault —

Resource scope (e.g. treasury/accounts/*).

statusrequired

Type 'active' | 'conditional' | 'revoked' | 'expired'Default —

Grant status.

grantedByrequired

Type stringDefault —

Granting authority display name.

grantedAtrequired

Type stringDefault —

ISO timestamp of grant issuance.

conditions

Type GrantCondition[]Default —

Array of grant conditions.

auditTrail

Type ProvenanceStep[]Default —

Audit events as ProvenanceChain steps.

onRevoke

Type (grantId: string) => voidDefault —

Shows revoke button for active/conditional grants.

Metadatasemantic type border surface

Design Rationale

This component was designed to express:

View all principles →

Explore Related

AgentCapabilityMatrix→

Scannable grid of agents × capability dimensions — blue=granted, gold=conditional, red=denied — designed for treasury dashboards at 3am

CapabilityRevokeFlow→

Two-step revocation ceremony: Step 1 shows task impact preview (will-fail / may-degrade), Step 2 requires written reason — non-repudiable audit trail

ProvenanceChain→

Linked chain of data sources showing transformation provenance

Was this helpful?