rafaelrcamargo · Aug 25, 2026 · Aug 25, 2026 · Aug 25, 2026 · Aug 25, 2026 · Aug 26, 2026
diff --git a/.changeset/add-agent-action-approval.md b/.changeset/add-agent-action-approval.md
@@ -0,0 +1,12 @@
+---
+'@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
+---
+
+Add an experimental `AgentActionApproval` component with an interactive mock approval flow, account and workspace switching, and an unavailable-request state.
diff --git a/packages/clerk-js/sandbox/app.ts b/packages/clerk-js/sandbox/app.ts
@@ -36,6 +36,7 @@ const AVAILABLE_COMPONENTS = [
   'configureSSO',
   'configureDirectorySync',
   'oauthConsent',
+  'agentActionApproval',
   'oauthDeviceVerification',
   'taskChooseOrganization',
   'taskResetPassword',
@@ -157,6 +158,7 @@ const componentControls: Record<AvailableComponent, ComponentPropsControl> = {
   configureSSO: buildComponentControls('configureSSO'),
   configureDirectorySync: buildComponentControls('configureDirectorySync'),
   oauthConsent: buildComponentControls('oauthConsent'),
+  agentActionApproval: buildComponentControls('agentActionApproval'),
   oauthDeviceVerification: buildComponentControls('oauthDeviceVerification'),
   taskChooseOrganization: buildComponentControls('taskChooseOrganization'),
   taskResetPassword: buildComponentControls('taskResetPassword'),
@@ -429,6 +431,10 @@ void (async () => {
     '/pricing-table': { mount: 'mountPricingTable', component: 'pricingTable' },
     '/api-keys': { mount: 'mountAPIKeys', component: 'apiKeys' },
     '/configure-sso': { mount: '__internal_mountConfigureSSO', component: 'configureSSO' },
+    '/agent-action-approval': {
+      mount: '__experimental_mountAgentActionApproval',
+      component: 'agentActionApproval',
+    },
     '/oauth-device-verification': {
       mount: '__internal_mountOAuthDeviceVerification',
       component: 'oauthDeviceVerification',

diff --git a/packages/clerk-js/sandbox/scenarios/agent-action-approval.ts b/packages/clerk-js/sandbox/scenarios/agent-action-approval.ts
@@ -0,0 +1,26 @@
+import {
+  clerkHandlers,
+  EnvironmentService,
+  type MockScenario,
+  SessionService,
+  setClerkState,
+  UserService,
+} from '@clerk/msw';
+
+export function AgentActionApproval(): MockScenario {
+  const user = UserService.create();
+  const session = SessionService.create(user);
+
+  setClerkState({
+    environment: EnvironmentService.MULTI_SESSION,
+    session,
+    user,
+  });
+
+  return {
+    description: 'Interactive agent-action approval prototype',
+    handlers: clerkHandlers,
+    initialState: { session, user },
+    name: 'agent-action-approval',
+  };
+}
diff --git a/packages/clerk-js/sandbox/scenarios/index.ts b/packages/clerk-js/sandbox/scenarios/index.ts
@@ -5,3 +5,4 @@ export { OrgProfileSeatLimit } from './org-profile-seat-limit';
 export { PricingTableSBB } from './pricing-table-sbb';
 export { AnnualOnlyPlans } from './annual-only-plans';
 export { XProviderEnabled } from './x-provider-enabled';
+export { AgentActionApproval } from './agent-action-approval';
diff --git a/packages/clerk-js/sandbox/template.html b/packages/clerk-js/sandbox/template.html
@@ -259,6 +259,11 @@
             label="OAuth Consent"
             component="<OAuthConsent />"
           ></nav-link>
+          <nav-link
+            href="/agent-action-approval?scenario=AgentActionApproval"
+            label="Agent Action Approval"
+            component="<AgentActionApproval />"
+          ></nav-link>
           <nav-link
             href="/oauth-device-verification"
             label="OAuth Device Verification"

diff --git a/packages/clerk-js/src/core/clerk.ts b/packages/clerk-js/src/core/clerk.ts
@@ -64,6 +64,7 @@ import type {
   __internal_PlanDetailsProps,
   __internal_SubscriptionDetailsProps,
   __internal_UserVerificationModalProps,
+  AgentActionApprovalProps,
   APIKeysNamespace,
   APIKeysProps,
   AuthenticateWithBaseParams,
@@ -1539,6 +1540,25 @@ export class Clerk implements ClerkInterface {
     void this.#clerkUI?.then(ui => ui.ensureMounted()).then(controls => controls.unmountComponent({ node }));
   };
 
+  public __experimental_mountAgentActionApproval = (node: HTMLDivElement, props?: AgentActionApprovalProps) => {
+    this.assertComponentsReady(this.#clerkUI);
+    const component = 'AgentActionApproval';
+    void this.#clerkUI
+      .then(ui => ui.ensureMounted({ preloadHint: component }))
+      .then(controls =>
+        controls.mountComponent({
+          name: component,
+          appearanceKey: '__experimental_agentActionApproval',
+          node,
+          props,
+        }),
+      );
+  };
+
+  public __experimental_unmountAgentActionApproval = (node: HTMLDivElement) => {
+    void this.#clerkUI?.then(ui => ui.ensureMounted()).then(controls => controls.unmountComponent({ node }));
+  };
+
   /**
    * @deprecated Use mountOAuthConsent instead.
    */

diff --git a/packages/localizations/src/ar-SA.ts b/packages/localizations/src/ar-SA.ts
@@ -19,6 +19,32 @@ export const arSA: LocalizationResource = {
     title: undefined,
     traceIdLabel: undefined,
   },
+  agentActionApproval: {
+    action__approve: undefined,
+    action__deny: undefined,
+    action__switchAccount: undefined,
+    commentLabel: undefined,
+    commentOptional: undefined,
+    commentPlaceholder: undefined,
+    copyParameter: undefined,
+    detailsLabel: undefined,
+    expiresIn: undefined,
+    parameterCopied: undefined,
+    requestedAt: undefined,
+    signedInAs: undefined,
+    terminal: {
+      approvedSubtitle: undefined,
+      approvedTitle: undefined,
+      deniedSubtitle: undefined,
+      deniedTitle: undefined,
+      expiredSubtitle: undefined,
+      expiredTitle: undefined,
+    },
+    title: undefined,
+    unavailableSubtitle: undefined,
+    unavailableTitle: undefined,
+    workspace: undefined,
+  },
   apiKeys: {
     action__add: undefined,
     action__search: undefined,

diff --git a/packages/localizations/src/be-BY.ts b/packages/localizations/src/be-BY.ts
@@ -19,6 +19,32 @@ export const beBY: LocalizationResource = {
     title: undefined,
     traceIdLabel: undefined,
   },
+  agentActionApproval: {
+    action__approve: undefined,
+    action__deny: undefined,
+    action__switchAccount: undefined,
+    commentLabel: undefined,
+    commentOptional: undefined,
+    commentPlaceholder: undefined,
+    copyParameter: undefined,
+    detailsLabel: undefined,
+    expiresIn: undefined,
+    parameterCopied: undefined,
+    requestedAt: undefined,
+    signedInAs: undefined,
+    terminal: {
+      approvedSubtitle: undefined,
+      approvedTitle: undefined,
+      deniedSubtitle: undefined,
+      deniedTitle: undefined,
+      expiredSubtitle: undefined,
+      expiredTitle: undefined,
+    },
+    title: undefined,
+    unavailableSubtitle: undefined,
+    unavailableTitle: undefined,
+    workspace: undefined,
+  },
   apiKeys: {
     action__add: undefined,
     action__search: undefined,

diff --git a/packages/localizations/src/bg-BG.ts b/packages/localizations/src/bg-BG.ts
@@ -19,6 +19,32 @@ export const bgBG: LocalizationResource = {
     title: undefined,
     traceIdLabel: undefined,
   },
+  agentActionApproval: {
+    action__approve: undefined,
+    action__deny: undefined,
+    action__switchAccount: undefined,
+    commentLabel: undefined,
+    commentOptional: undefined,
+    commentPlaceholder: undefined,
+    copyParameter: undefined,
+    detailsLabel: undefined,
+    expiresIn: undefined,
+    parameterCopied: undefined,
+    requestedAt: undefined,
+    signedInAs: undefined,
+    terminal: {
+      approvedSubtitle: undefined,
+      approvedTitle: undefined,
+      deniedSubtitle: undefined,
+      deniedTitle: undefined,
+      expiredSubtitle: undefined,
+      expiredTitle: undefined,
+    },
+    title: undefined,
+    unavailableSubtitle: undefined,
+    unavailableTitle: undefined,
+    workspace: undefined,
+  },
   apiKeys: {
     action__add: undefined,
     action__search: undefined,

diff --git a/packages/localizations/src/bn-IN.ts b/packages/localizations/src/bn-IN.ts
@@ -19,6 +19,32 @@ export const bnIN: LocalizationResource = {
     title: undefined,
     traceIdLabel: undefined,
   },
+  agentActionApproval: {
+    action__approve: undefined,
+    action__deny: undefined,
+    action__switchAccount: undefined,
+    commentLabel: undefined,
+    commentOptional: undefined,
+    commentPlaceholder: undefined,
+    copyParameter: undefined,
+    detailsLabel: undefined,
+    expiresIn: undefined,
+    parameterCopied: undefined,
+    requestedAt: undefined,
+    signedInAs: undefined,
+    terminal: {
+      approvedSubtitle: undefined,
+      approvedTitle: undefined,
+      deniedSubtitle: undefined,
+      deniedTitle: undefined,
+      expiredSubtitle: undefined,
+      expiredTitle: undefined,
+    },
+    title: undefined,
+    unavailableSubtitle: undefined,
+    unavailableTitle: undefined,
+    workspace: undefined,
+  },
   apiKeys: {
     action__add: 'নতুন কী যোগ করুন',
     action__search: 'কী অনুসন্ধান করুন',

diff --git a/packages/localizations/src/ca-ES.ts b/packages/localizations/src/ca-ES.ts
@@ -19,6 +19,32 @@ export const caES: LocalizationResource = {
     title: undefined,
     traceIdLabel: undefined,
   },
+  agentActionApproval: {
+    action__approve: undefined,
+    action__deny: undefined,
+    action__switchAccount: undefined,
+    commentLabel: undefined,
+    commentOptional: undefined,
+    commentPlaceholder: undefined,
+    copyParameter: undefined,
+    detailsLabel: undefined,
+    expiresIn: undefined,
+    parameterCopied: undefined,
+    requestedAt: undefined,
+    signedInAs: undefined,
+    terminal: {
+      approvedSubtitle: undefined,
+      approvedTitle: undefined,
+      deniedSubtitle: undefined,
+      deniedTitle: undefined,
+      expiredSubtitle: undefined,
+      expiredTitle: undefined,
+    },
+    title: undefined,
+    unavailableSubtitle: undefined,
+    unavailableTitle: undefined,
+    workspace: undefined,
+  },
   apiKeys: {
     action__add: undefined,
     action__search: undefined,

diff --git a/packages/localizations/src/cs-CZ.ts b/packages/localizations/src/cs-CZ.ts
@@ -19,6 +19,32 @@ export const csCZ: LocalizationResource = {
     title: undefined,
     traceIdLabel: undefined,
   },
+  agentActionApproval: {
+    action__approve: undefined,
+    action__deny: undefined,
+    action__switchAccount: undefined,
+    commentLabel: undefined,
+    commentOptional: undefined,
+    commentPlaceholder: undefined,
+    copyParameter: undefined,
+    detailsLabel: undefined,
+    expiresIn: undefined,
+    parameterCopied: undefined,
+    requestedAt: undefined,
+    signedInAs: undefined,
+    terminal: {
+      approvedSubtitle: undefined,
+      approvedTitle: undefined,
+      deniedSubtitle: undefined,
+      deniedTitle: undefined,
+      expiredSubtitle: undefined,
+      expiredTitle: undefined,
+    },
+    title: undefined,
+    unavailableSubtitle: undefined,
+    unavailableTitle: undefined,
+    workspace: undefined,
+  },
   apiKeys: {
     action__add: 'Přidat nový klíč',
     action__search: 'Vyhledat klíče',

diff --git a/packages/localizations/src/da-DK.ts b/packages/localizations/src/da-DK.ts
@@ -19,6 +19,32 @@ export const daDK: LocalizationResource = {
     title: undefined,
     traceIdLabel: undefined,
   },
+  agentActionApproval: {
+    action__approve: undefined,
+    action__deny: undefined,
+    action__switchAccount: undefined,
+    commentLabel: undefined,
+    commentOptional: undefined,
+    commentPlaceholder: undefined,
+    copyParameter: undefined,
+    detailsLabel: undefined,
+    expiresIn: undefined,
+    parameterCopied: undefined,
+    requestedAt: undefined,
+    signedInAs: undefined,
+    terminal: {
+      approvedSubtitle: undefined,
+      approvedTitle: undefined,
+      deniedSubtitle: undefined,
+      deniedTitle: undefined,
+      expiredSubtitle: undefined,
+      expiredTitle: undefined,
+    },
+    title: undefined,
+    unavailableSubtitle: undefined,
+    unavailableTitle: undefined,
+    workspace: undefined,
+  },
   apiKeys: {
     action__add: undefined,
     action__search: undefined,

diff --git a/packages/localizations/src/de-DE.ts b/packages/localizations/src/de-DE.ts
@@ -19,6 +19,32 @@ export const deDE: LocalizationResource = {
     title: undefined,
     traceIdLabel: undefined,
   },
+  agentActionApproval: {
+    action__approve: undefined,
+    action__deny: undefined,
+    action__switchAccount: undefined,
+    commentLabel: undefined,
+    commentOptional: undefined,
+    commentPlaceholder: undefined,
+    copyParameter: undefined,
+    detailsLabel: undefined,
+    expiresIn: undefined,
+    parameterCopied: undefined,
+    requestedAt: undefined,
+    signedInAs: undefined,
+    terminal: {
+      approvedSubtitle: undefined,
+      approvedTitle: undefined,
+      deniedSubtitle: undefined,
+      deniedTitle: undefined,
+      expiredSubtitle: undefined,
+      expiredTitle: undefined,
+    },
+    title: undefined,
+    unavailableSubtitle: undefined,
+    unavailableTitle: undefined,
+    workspace: undefined,
+  },
   apiKeys: {
     action__add: 'Neuen API-Key hinzufügen',
     action__search: 'Suche',