| Prop | Type | Default | Description |
|---|---|---|---|
title | string | — | The headline action being requested (e.g., "Refund 3 orders"). |
amount | string | — | Optional numeric or monetary amount displayed alongside the title. |
agentName | string | "Ops agent" | Name of the requesting AI agent. |
agentRole | string | "wants to" | Action descriptor following the agent's name. |
agentAvatarUrl | string | — | Optional custom avatar image source for the agent. |
status | "pending" | "approved" | "rejected" | "pending" | Controlled status of the card. |
items | AgentApprovalItem[] | [] | List of itemized records or orders being affected. |
tags | AgentApprovalBadge[] | [] | Permission, category, or policy tags for contextual boundaries. |
holdDurationMs | number | 1500 | Duration in milliseconds required to hold before approving. |
allowRevert | boolean | true | Allows resetting an approved or rejected card back to pending state. |
onApprove | () => void | — | Callback fired when the hold-to-approve interaction successfully completes. |
onReject | () => void | — | Callback fired when the deny button is clicked. |
onReset | () => void | — | Callback fired when reset is clicked in a completed state. |
| Prop | Type | Default | Description |
|---|---|---|---|
onApprove | () => void | — | Callback triggered upon holding for the full duration. |
holdDurationMs | number | 1500 | Required hold duration in milliseconds. |
status | "pending" | "approved" | "rejected" | "pending" | Current state affecting button appearance and interaction. |
disabled | boolean | false | Whether button interaction is disabled. |