Components › Human Control & Oversight › Human-in-the-Loop
HC01 · Control

Human-in-the-Loop

Purpose Intercepts agent execution before irreversible or high-consequence actions, requiring explicit human approval.
Use when An agent is about to write data, send communications, execute transactions, modify records, or take any action that cannot be trivially undone.
Do not use For read-only operations, informational queries, or low-stakes previews.
Failure mode prevented Agents executing consequential actions without human awareness, creating liability without accountability.
Example Dark Academia
Dark Academia
The Atelier
Neon Tide
The Archive
Candlelight
The Conservatory
Overview
hitl-standard — single approve/reject decisionhitl-scoped — shows exact scope of what will be changedhitl-timed — adds countdown before auto-cancellation (never auto-approve)
Design rule

Consequential decisions require explicit human approval before execution. "Implicit consent" from prior sessions or blanket authorization is not acceptable for high-stakes actions.

Theming API

Override these CSS custom properties to apply your own visual treatment without touching the component's behavioral contracts.

Shared semantic tokens

These are used across multiple RAD components. Define them once in your theme root.

Token Controls
--rad-surface-card Card background
--rad-border-subtle Card border
--rad-color-approve Approve button fill
--rad-color-approve-hover Approve button hover fill
--rad-color-reject Reject button label and border
--rad-color-reject-hover-bg Reject button hover background
--rad-color-text-primary Title and primary content
--rad-color-text-secondary Description body text
--rad-color-text-meta ID label, scope text, monospace metadata
--rad-color-emphasis <strong> inline emphasis (e.g. entity name)
--rad-color-focus Default focus ring color
--rad-radius-card Card border radius
--rad-radius-btn Button border radius

Component-scoped tokens

These are specific to rad-hitl and do not apply to other components.

Token Controls
--rad-hitl-scope-bg Scope line background tint
--rad-hitl-defer-color Defer button label color
--rad-hitl-defer-border Defer button border color
--rad-hitl-defer-hover-color Defer button label on hover
--rad-hitl-defer-hover-border Defer button border on hover

"*This component exists to make sure you ask a human before doing something irreversible. Implement it like you mean it.*"

← Previous Algorithmic Nudge Disclosure Next → Impact Assessment

Intellectual Property

RAD is the original work of Jackie Curry. All rights reserved. No portion may be reproduced, adapted, or incorporated into any product or system without express written permission.

Permitted: citation in academic or editorial contexts with full attribution.

Licensing

© 2025 Jackie Curry. All rights reserved. Publication date: 2025.

For licensing inquiries, connect on LinkedIn →