feat(ui): add agent action approval component

[rafaelrcamargo]

Description

Adds an experimental <AgentActionApproval /> component across Clerk React SDKs. The component currently uses a focused mock approval request so the interaction can be reviewed while the API and SDK integration are still being developed.

The approval flow includes a Codex-requested refund, request metadata and parameters, an optional comment, an expiration countdown, and approve, reject, and expired terminal states. It is wired through Clerk JS mounting, React and Next.js exports, React Router and TanStack React Start exports, appearance customization, localization, and the Clerk JS sandbox.

Preview it in the Clerk JS sandbox at /agent-action-approval?scenario=AgentActionApproval and exercise the approve, reject, and expiration paths.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated (not applicable for this experimental mocked prototype)

Type of change

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

[changeset-bot]

🦋 Changeset detected

Latest commit: 3e87106

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 23 packages

Name	Type
@clerk/shared	Minor
@clerk/clerk-js	Minor
@clerk/ui	Minor
@clerk/react	Minor
@clerk/react-router	Minor
@clerk/nextjs	Minor
@clerk/tanstack-react-start	Minor
@clerk/localizations	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/chrome-extension	Patch
@clerk/electron	Patch
@clerk/expo-passkeys	Patch
@clerk/expo	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/headless	Patch
@clerk/hono	Patch
@clerk/msw	Patch
@clerk/nuxt	Patch
@clerk/testing	Patch
@clerk/vue	Patch
@clerk/swingset	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
clerk-js-sandbox	Ready	Preview	Sep 3, 2026 9:28pm UTC
swingset	Ready	Preview	Sep 3, 2026 9:28pm UTC

[pkg-pr-new]

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9554

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9554

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9554

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9554

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9554

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9554

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9554

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9554

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9554

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9554

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9554

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9554

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9554

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9554

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9554

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9554

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9554

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9554

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9554

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9554

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9554

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9554

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9554

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9554

commit: 3e87106

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

_{Comment @coderabbitai help to get the list of available commands.}