@atlaskit/rovo-agent-analytics 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @atlaskit/rovo-agent-analytics
 
+## 0.19.0
+
+### Minor Changes
+
+- [`2ccb8729cef96`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/2ccb8729cef96) -
+  Reorg agent action enums to different files, add the actionGroup to the analytics
+
 ## 0.18.0
 
 ### Minor Changes

package/README.md

@@ -37,29 +37,81 @@ trackAgentAction(AgentDebugActions.VIEW, {});
 trackAgentAction(AgentDebugActions.COPY, {});
 ```
 
-## Adding New Actions
+## Action Groups
 
-### Step 1: Add the action to the appropriate enum
+Actions are organized into **groups** — self-contained files that define their actions, attribute
+types, and a group name that gets automatically sent as `attributes.actionGroup` in every fired event.
 
-Add your new action to either `AgentCommonActions` or `AgentDebugActions` in
-`src/actions/index.tsx`:
+All groups live in **one place**: `src/actions/groups/`.
+
+| Group | File | Hook | Description |
+| --- | --- | --- | --- |
+| `agentInteractions` | `agent-interactions.ts` | actions | User-initiated interactions from overflow menu / profile (view, edit, delete, duplicate, star, chat, verify…) |
+| `editing` | `editing.ts` | actions | Agent save/mutation events (updated) |
+| `debug` | `debug.ts` | actions | Debug modal actions (view, copy, toggle skill info) |
+| `tools` | `tools.ts` | actions | Tool execution actions (confirm, stream stop, result viewed, error) |
+| `createFlow` | `create-flow.ts` | create | Create agent funnel steps (start, skip NL, review, activate, restart, error, land, discard) |
+| `addToolsPrompt` | `add-tools-prompt.ts` | create | Add tools prompt modal shown when activating an agent with no tools (shown, browse, dismiss) |
+
+The `actionGroup` value is visible in Databricks via `attributes.actionGroup`.
+
+## Adding a New Action
+
+### To an existing group
+
+1. Open the group file (e.g. `src/actions/groups/agent-interactions.ts` or `src/actions/groups/create-flow.ts`)
+2. Add the action to the enum with a data-portal registry link:
 
 ```typescript
-export enum AgentCommonActions {
+export enum AgentInteractionActions {
 	// ... existing actions
 	/* My new action - https://data-portal.internal.atlassian.com/analytics/registry/XXXXX */
 	MY_NEW_ACTION = 'myNewAction',
 }
 ```
 
-### Step 2: Define attributes for the action
-
-Add an entry to `ActionAttributes` to specify which attributes this action requires:
+3. Add the attribute type in the same file:
 
 ```typescript
-type ActionAttributes = {
+export type AgentInteractionAttributes = {
 	// ... existing actions
-	[AgentCommonActions.MY_NEW_ACTION]: CommonAnalyticsAttributes;
+	[AgentInteractionActions.MY_NEW_ACTION]: BaseAgentAnalyticsAttributes;
+};
+```
+
+That's it — the action is automatically registered and will fire with `actionGroup: 'agentInteractions'`.
+
+### To a new group
+
+If your action doesn't fit any existing group, create a new one:
+
+1. Create a new file in `src/actions/groups/`. Use any existing group file as a template — each one
+   has a header comment explaining the structure.
+
+2. Register the group in `src/actions/registry.ts`:
+
+```typescript
+// 1. Import the group
+import {
+	MyFeatureActions,
+	type MyFeatureActionAttributes,
+	ACTION_GROUP as MY_FEATURE_GROUP,
+} from './groups/my-feature';
+
+// 2. Add to the combined type
+export type ActionAttributes = AgentInteractionAttributes &
+	EditingActionAttributes &
+	DebugActionAttributes &
+	ToolsActionAttributes &
+	MyFeatureActionAttributes;
+
+// 3. Add to the runtime group map
+export const ACTION_TO_GROUP: Record<string, string> = {
+	...mapActionsToGroup(AgentInteractionActions, AGENT_INTERACTIONS_GROUP),
+	...mapActionsToGroup(AgentEditingActions, EDITING_GROUP),
+	...mapActionsToGroup(AgentDebugActions, DEBUG_GROUP),
+	...mapActionsToGroup(AgentToolActions, TOOLS_GROUP),
+	...mapActionsToGroup(MyFeatureActions, MY_FEATURE_GROUP),
 };
 ```
 
@@ -68,31 +120,30 @@ type ActionAttributes = {
 Each action can have its own specific attributes. The `trackAgentAction` function is generic and
 will enforce the correct attributes based on the action you pass.
 
-### Using CommonAnalyticsAttributes
+### Using BaseAgentAnalyticsAttributes
 
 For actions that only need `touchPoint` and `agentId`:
 
 ```typescript
-type ActionAttributes = {
-	[AgentCommonActions.VIEW]: CommonAnalyticsAttributes;
+export type AgentInteractionAttributes = {
+	[AgentInteractionActions.VIEW]: BaseAgentAnalyticsAttributes;
 };
 ```
 
 ### Using Custom Attributes
 
-For actions that need additional attributes beyond the common ones:
+For actions that need additional attributes beyond the base ones:
 
 ```typescript
-type ActionAttributes = {
-	[AgentCommonActions.STAR]: CommonAnalyticsAttributes & { isStarred: boolean };
+export type EditingActionAttributes = {
+	[AgentEditingActions.UPDATED]: BaseAgentAnalyticsAttributes & { agentType: string; field: string };
 };
 ```
 
 When calling `trackAgentAction`, TypeScript will enforce the custom attributes:
 
 ```typescript
-// TypeScript will require isStarred to be provided
-trackAgentAction(AgentCommonActions.STAR, { isStarred: true });
+trackAgentAction(AgentEditingActions.UPDATED, { agentType: 'custom', field: 'name' });
 ```
 
 ### How Type Inference Works

package/actions/add-tools-prompt/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@atlaskit/rovo-agent-analytics/actions/add-tools-prompt",
+  "main": "../../dist/cjs/actions/groups/add-tools-prompt.js",
+  "module": "../../dist/esm/actions/groups/add-tools-prompt.js",
+  "module:es2019": "../../dist/es2019/actions/groups/add-tools-prompt.js",
+  "sideEffects": [
+    "*.compiled.css"
+  ],
+  "types": "../../dist/types/actions/groups/add-tools-prompt.d.ts",
+  "typesVersions": {
+    ">=4.5 <5.9": {
+      "*": [
+        "../../dist/types-ts4.5/actions/groups/add-tools-prompt.d.ts"
+      ]
+    }
+  }
+}

package/actions/agent-interactions/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@atlaskit/rovo-agent-analytics/actions/agent-interactions",
+  "main": "../../dist/cjs/actions/groups/agent-interactions.js",
+  "module": "../../dist/esm/actions/groups/agent-interactions.js",
+  "module:es2019": "../../dist/es2019/actions/groups/agent-interactions.js",
+  "sideEffects": [
+    "*.compiled.css"
+  ],
+  "types": "../../dist/types/actions/groups/agent-interactions.d.ts",
+  "typesVersions": {
+    ">=4.5 <5.9": {
+      "*": [
+        "../../dist/types-ts4.5/actions/groups/agent-interactions.d.ts"
+      ]
+    }
+  }
+}

package/actions/create-flow/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@atlaskit/rovo-agent-analytics/actions/create-flow",
+  "main": "../../dist/cjs/actions/groups/create-flow.js",
+  "module": "../../dist/esm/actions/groups/create-flow.js",
+  "module:es2019": "../../dist/es2019/actions/groups/create-flow.js",
+  "sideEffects": [
+    "*.compiled.css"
+  ],
+  "types": "../../dist/types/actions/groups/create-flow.d.ts",
+  "typesVersions": {
+    ">=4.5 <5.9": {
+      "*": [
+        "../../dist/types-ts4.5/actions/groups/create-flow.d.ts"
+      ]
+    }
+  }
+}

package/actions/debug/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@atlaskit/rovo-agent-analytics/actions/debug",
+  "main": "../../dist/cjs/actions/groups/debug.js",
+  "module": "../../dist/esm/actions/groups/debug.js",
+  "module:es2019": "../../dist/es2019/actions/groups/debug.js",
+  "sideEffects": [
+    "*.compiled.css"
+  ],
+  "types": "../../dist/types/actions/groups/debug.d.ts",
+  "typesVersions": {
+    ">=4.5 <5.9": {
+      "*": [
+        "../../dist/types-ts4.5/actions/groups/debug.d.ts"
+      ]
+    }
+  }
+}

package/actions/editing/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@atlaskit/rovo-agent-analytics/actions/editing",
+  "main": "../../dist/cjs/actions/groups/editing.js",
+  "module": "../../dist/esm/actions/groups/editing.js",
+  "module:es2019": "../../dist/es2019/actions/groups/editing.js",
+  "sideEffects": [
+    "*.compiled.css"
+  ],
+  "types": "../../dist/types/actions/groups/editing.d.ts",
+  "typesVersions": {
+    ">=4.5 <5.9": {
+      "*": [
+        "../../dist/types-ts4.5/actions/groups/editing.d.ts"
+      ]
+    }
+  }
+}

package/actions/tool-actions/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@atlaskit/rovo-agent-analytics/actions/tool-actions",
-  "main": "../../dist/cjs/actions/tool-actions/index.js",
-  "module": "../../dist/esm/actions/tool-actions/index.js",
-  "module:es2019": "../../dist/es2019/actions/tool-actions/index.js",
+  "main": "../../dist/cjs/actions/groups/tools.js",
+  "module": "../../dist/esm/actions/groups/tools.js",
+  "module:es2019": "../../dist/es2019/actions/groups/tools.js",
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../../dist/types/actions/tool-actions/index.d.ts",
+  "types": "../../dist/types/actions/groups/tools.d.ts",
   "typesVersions": {
     ">=4.5 <5.9": {
       "*": [
-        "../../dist/types-ts4.5/actions/tool-actions/index.d.ts"
+        "../../dist/types-ts4.5/actions/groups/tools.d.ts"
       ]
     }
   }

package/dist/cjs/actions/groups/add-tools-prompt.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AddToolsPromptActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: addToolsPrompt
+ *
+ * Add tools prompt modal — shown when a user tries to activate/publish an agent that has no tools.
+ * The user can browse tools or dismiss and proceed without them.
+ *
+ * This group is intentionally flow-agnostic so the action values stay stable
+ * regardless of whether the prompt fires from the create flow or a future publish flow.
+ *
+ * ## Adding a new action
+ * 1. Add the action to the `AddToolsPromptActions` enum below with a data-portal link
+ * 2. Register this group in ../registry.ts (if this is a new group file)
+ *
+ */
+
+/** The group name sent as `attributes.actionGroup` in analytics events */
+var ACTION_GROUP = exports.ACTION_GROUP = 'addToolsPrompt';
+var AddToolsPromptActions = exports.AddToolsPromptActions = /*#__PURE__*/function (AddToolsPromptActions) {
+  /* Add tools prompt shown (agent has no tools) - https://data-portal.internal.atlassian.com/analytics/registry/98106 */
+  AddToolsPromptActions["SHOWN"] = "addToolsPromptShown";
+  /* User clicked "Browse skills" on the add tools prompt - https://data-portal.internal.atlassian.com/analytics/registry/98107 */
+  AddToolsPromptActions["BROWSE"] = "addToolsPromptBrowse";
+  /* User dismissed the add tools prompt ("No thanks") and proceeded anyway - https://data-portal.internal.atlassian.com/analytics/registry/98108 */
+  AddToolsPromptActions["DISMISS"] = "addToolsPromptDismiss";
+  return AddToolsPromptActions;
+}({});

package/dist/cjs/actions/groups/agent-interactions.js

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AgentInteractionActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: agentInteractions
+ *
+ * User-initiated interactions with an agent — typically from the overflow menu ("...")
+ * or agent profile surfaces (viewing, editing, deleting, duplicating, starring, sharing, verifying).
+ *
+ * NOTE: This is about UI interactions, not backend "actions" (which are being replaced by "tools").
+ *
+ * ## Adding a new action
+ * 1. Add the action to the `AgentInteractionActions` enum below with a data-portal link
+ * 2. Add the corresponding attribute type in `AgentInteractionAttributes`
+ * 3. If this action doesn't fit user interactions, create a new group file instead
+ *    (see other files in this directory for the template)
+ */
+
+/** The group name sent as `attributes.actionGroup` in analytics events */
+var ACTION_GROUP = exports.ACTION_GROUP = 'agentInteractions';
+var AgentInteractionActions = exports.AgentInteractionActions = /*#__PURE__*/function (AgentInteractionActions) {
+  /* View agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97125 */
+  AgentInteractionActions["VIEW"] = "view";
+  /* Edit agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97126 */
+  AgentInteractionActions["EDIT"] = "edit";
+  /* Copy link clicked - https://data-portal.internal.atlassian.com/analytics/registry/97128 */
+  AgentInteractionActions["COPY_LINK"] = "copyLink";
+  /* Delete agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97129 */
+  AgentInteractionActions["DELETE"] = "delete";
+  /* Duplicate agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97130 */
+  AgentInteractionActions["DUPLICATE"] = "duplicate";
+  /* Star agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97133 */
+  AgentInteractionActions["STAR"] = "star";
+  /* Chat with agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97095 */
+  AgentInteractionActions["CHAT"] = "chat";
+  /* Verify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97134 */
+  AgentInteractionActions["VERIFY"] = "verify";
+  /* Unverify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97135 */
+  AgentInteractionActions["UNVERIFY"] = "unverify";
+  return AgentInteractionActions;
+}({});

package/dist/cjs/actions/groups/create-flow.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CreateFlowActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: createFlow
+ *
+ * Create agent funnel steps — from clicking "Create agent" through to activation or discard,
+ *
+ * ## Adding a new action
+ * 1. Add the action to the `CreateFlowActions` enum below with a data-portal link
+ * 2. Register this group in ../registry.ts (if this is a new group file)
+ */
+
+/** The group name sent as `attributes.actionGroup` in analytics events */
+var ACTION_GROUP = exports.ACTION_GROUP = 'createFlow';
+var CreateFlowActions = exports.CreateFlowActions = /*#__PURE__*/function (CreateFlowActions) {
+  /* Start create flow when user clicks on "Create agent" button - https://data-portal.internal.atlassian.com/analytics/registry/97089 */
+  CreateFlowActions["START"] = "createFlowStart";
+  /* Skip natural language - https://data-portal.internal.atlassian.com/analytics/registry/97127 */
+  CreateFlowActions["SKIP_NL"] = "createFlowSkipNL";
+  /* Review natural language - https://data-portal.internal.atlassian.com/analytics/registry/97124 */
+  CreateFlowActions["REVIEW_NL"] = "createFlowReviewNL";
+  /* Activate agent - https://data-portal.internal.atlassian.com/analytics/registry/97123 */
+  CreateFlowActions["ACTIVATE"] = "createFlowActivate";
+  /* Restart create flow - https://data-portal.internal.atlassian.com/analytics/registry/97131 */
+  CreateFlowActions["RESTART"] = "createFlowRestart";
+  /* Error occurred - https://data-portal.internal.atlassian.com/analytics/registry/97132 */
+  CreateFlowActions["ERROR"] = "createFlowError";
+  /* Land in studio - https://data-portal.internal.atlassian.com/analytics/registry/97136 */
+  CreateFlowActions["LAND"] = "createLandInStudio";
+  /* Discard agent - https://data-portal.internal.atlassian.com/analytics/registry/97137 */
+  CreateFlowActions["DISCARD"] = "createDiscard";
+  /* Draft created from solution architect plan card - https://data-portal.internal.atlassian.com/analytics/registry/97924 */
+  CreateFlowActions["SA_DRAFT"] = "saDraft";
+  return CreateFlowActions;
+}({});

package/dist/cjs/actions/groups/debug.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AgentDebugActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: debug
+ *
+ * Actions related to the agent debug modal (viewing, copying debug data, toggling skill info).
+ *
+ * ## Adding a new action
+ * 1. Add the action to the `AgentDebugActions` enum below with a data-portal link
+ * 2. Add the corresponding attribute type in `DebugActionAttributes`
+ * 3. If this action doesn't fit this group, consider creating a new group file instead
+ *    (see other files in this directory for the template)
+ */
+
+/** The group name sent as `attributes.actionGroup` in analytics events */
+var ACTION_GROUP = exports.ACTION_GROUP = 'debug';
+var AgentDebugActions = exports.AgentDebugActions = /*#__PURE__*/function (AgentDebugActions) {
+  /* View debug modal - https://data-portal.internal.atlassian.com/analytics/registry/97183 */
+  AgentDebugActions["VIEW"] = "debugView";
+  /* Copy all debug data - https://data-portal.internal.atlassian.com/analytics/registry/97186 */
+  AgentDebugActions["COPY_ALL"] = "debugCopyAll";
+  /* Copy debug data - https://data-portal.internal.atlassian.com/analytics/registry/97184 */
+  AgentDebugActions["COPY"] = "debugCopy";
+  /* Toggle skill info - https://data-portal.internal.atlassian.com/analytics/registry/97185 */
+  AgentDebugActions["TOGGLE_SKILL_INFO"] = "debugToggleSkillInfo";
+  return AgentDebugActions;
+}({});

package/dist/cjs/actions/groups/editing.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AgentEditingActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: editing
+ *
+ * Agent editing/mutation events — fired when an agent's configuration is saved or modified.
+ * Unlike agentInteractions (user clicks), these track actual data changes.
+ *
+ * ## Adding a new action
+ * 1. Add the action to the `AgentEditingActions` enum below with a data-portal link
+ * 2. Add the corresponding attribute type in `EditingActionAttributes`
+ * 3. If this action doesn't fit editing/mutation events, create a new group file instead
+ *    (see other files in this directory for the template)
+ */
+
+/** The group name sent as `attributes.actionGroup` in analytics events */
+var ACTION_GROUP = exports.ACTION_GROUP = 'editing';
+var AgentEditingActions = exports.AgentEditingActions = /*#__PURE__*/function (AgentEditingActions) {
+  /* Agent updated - https://data-portal.internal.atlassian.com/analytics/registry/97122 */
+  AgentEditingActions["UPDATED"] = "updated";
+  return AgentEditingActions;
+}({});

package/dist/cjs/actions/{tool-actions/index.js → groups/tools.js}

@@ -3,7 +3,22 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.AgentToolActions = void 0;
+exports.AgentToolActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: tools
+ *
+ * Actions related to agent tool execution during chat
+ * (confirming, streaming, viewing results, errors).
+ *
+ * ## Adding a new action
+ * 1. Add the action to the `AgentToolActions` enum below with a data-portal link
+ * 2. Add the corresponding attribute type in `ToolsActionAttributes`
+ * 3. If this action doesn't fit this group, consider creating a new group file instead
+ *    (see other files in this directory for the template)
+ */
+
+/** The group name sent as `attributes.actionGroup` in analytics events */
+var ACTION_GROUP = exports.ACTION_GROUP = 'tools';
 var AgentToolActions = exports.AgentToolActions = /*#__PURE__*/function (AgentToolActions) {
   /* When chatting with an agent, and tools confirmation being shown, then user click proceed with the possible actions (e.g. confirm, dismiss etc) https://data-portal.internal.atlassian.com/analytics/registry/97675 */
   AgentToolActions["TOOLS_EXECUTION_CONFIRMED"] = "toolsExecutionConfirmed";

package/dist/cjs/actions/index.js

@@ -10,42 +10,18 @@ var _react = require("react");
 var _analyticsNext = require("@atlaskit/analytics-next");
 var _constants = require("../common/constants");
 var _utils = require("../common/utils");
+var _agentInteractions = require("./groups/agent-interactions");
+var _debug = require("./groups/debug");
+var _editing = require("./groups/editing");
+var _registry = require("./registry");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-var AgentDebugActions = exports.AgentDebugActions = /*#__PURE__*/function (AgentDebugActions) {
-  /* View debug modal - https://data-portal.internal.atlassian.com/analytics/registry/97183 */
-  AgentDebugActions["VIEW"] = "debugView";
-  /* Copy all debug data - https://data-portal.internal.atlassian.com/analytics/registry/97186 */
-  AgentDebugActions["COPY_ALL"] = "debugCopyAll";
-  /* Copy debug data - https://data-portal.internal.atlassian.com/analytics/registry/97184 */
-  AgentDebugActions["COPY"] = "debugCopy";
-  /* Toggle skill info - https://data-portal.internal.atlassian.com/analytics/registry/97185 */
-  AgentDebugActions["TOGGLE_SKILL_INFO"] = "debugToggleSkillInfo";
-  return AgentDebugActions;
-}({});
-var AgentCommonActions = exports.AgentCommonActions = /*#__PURE__*/function (AgentCommonActions) {
-  /* View agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97125 */
-  AgentCommonActions["VIEW"] = "view";
-  /* Edit agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97126 */
-  AgentCommonActions["EDIT"] = "edit";
-  /* Agent updated - https://data-portal.internal.atlassian.com/analytics/registry/97122 */
-  AgentCommonActions["UPDATED"] = "updated";
-  /* Copy link clicked - https://data-portal.internal.atlassian.com/analytics/registry/97128 */
-  AgentCommonActions["COPY_LINK"] = "copyLink";
-  /* Delete agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97129 */
-  AgentCommonActions["DELETE"] = "delete";
-  /* Duplicate agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97130 */
-  AgentCommonActions["DUPLICATE"] = "duplicate";
-  /* Star agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97133 */
-  AgentCommonActions["STAR"] = "star";
-  /* Chat with agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97095 */
-  AgentCommonActions["CHAT"] = "chat";
-  /* Verify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97134 */
-  AgentCommonActions["VERIFY"] = "verify";
-  /* Unverify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97135 */
-  AgentCommonActions["UNVERIFY"] = "unverify";
-  return AgentCommonActions;
-}({});
+// Backward-compatible aliases
+// TODO: migrate consumers to use group-specific imports, then remove
+var AgentCommonActions = exports.AgentCommonActions = _objectSpread(_objectSpread({}, _agentInteractions.AgentInteractionActions), _editing.AgentEditingActions);
+
+// TODO: Remove the alias, will be breaking change, this is just for backward compatibility
+var AgentDebugActions = exports.AgentDebugActions = _debug.AgentDebugActions;
 var globalEventConfig = (0, _utils.getDefaultTrackEventConfig)();
 var useRovoAgentActionAnalytics = exports.useRovoAgentActionAnalytics = function useRovoAgentActionAnalytics(commonAttributes) {
   var analyticsContext = (0, _react.useContext)(_analyticsNext.AnalyticsReactContext);
@@ -63,7 +39,9 @@ var useRovoAgentActionAnalytics = exports.useRovoAgentActionAnalytics = function
     fireAnalyticsEvent({
       actionSubject: 'rovoAgent',
       action: action,
-      attributes: attributes
+      attributes: _objectSpread(_objectSpread({}, attributes), {}, {
+        actionGroup: _registry.ACTION_TO_GROUP[action]
+      })
     });
   }, [fireAnalyticsEvent]);
   var trackAgentActionError = (0, _react.useCallback)(function (action, error, attributes) {
@@ -71,6 +49,7 @@ var useRovoAgentActionAnalytics = exports.useRovoAgentActionAnalytics = function
       actionSubject: 'rovoAgentError',
       action: action,
       attributes: _objectSpread(_objectSpread({}, attributes), {}, {
+        actionGroup: _registry.ACTION_TO_GROUP[action],
         error: {
           message: error.message
         }

package/dist/cjs/actions/registry.js

@@ -0,0 +1,53 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ACTION_TO_GROUP = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _addToolsPrompt = require("./groups/add-tools-prompt");
+var _agentInteractions = require("./groups/agent-interactions");
+var _createFlow = require("./groups/create-flow");
+var _debug = require("./groups/debug");
+var _editing = require("./groups/editing");
+var _tools = require("./groups/tools");
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; } /**
+ * Action Registry
+ *
+ * Single source of truth for ALL action groups across the library.
+ * This file composes all groups into a type-safe registry and builds the
+ * runtime mapping from action values to their group names, which gets
+ * automatically attached as `attributes.actionGroup` in every fired event.
+ *
+ * Both `useRovoAgentActionAnalytics` and `useRovoAgentCreateAnalytics` hooks
+ * use `ACTION_TO_GROUP` from this registry.
+ *
+ * ## Adding a new action group
+ * 1. Create a new file in ./groups/ following the template of existing group files
+ * 2. Import the group's ACTION_GROUP, action enum, and attribute type below
+ * 3. If the group is used by the actions hook, add the attribute type to `ActionAttributes`
+ * 4. Add the enum + group to `ACTION_TO_GROUP` using `mapActionsToGroup`
+ */
+/**
+ * Combined attribute map for action-hook groups (type-safe attributes).
+ * Create-flow groups are excluded — they use a looser attribute type via the create hook.
+ */
+
+/**
+ * Helper to build a Record mapping each enum value to its group name.
+ */
+var mapActionsToGroup = function mapActionsToGroup(actionEnum, group) {
+  return Object.fromEntries(Object.values(actionEnum).map(function (action) {
+    return [action, group];
+  }));
+};
+
+/**
+ * Runtime lookup: action value → group name.
+ * Used by ALL analytics hooks to auto-inject `attributes.actionGroup`.
+ *
+ * When you add a new group, add it here too.
+ */
+var ACTION_TO_GROUP = exports.ACTION_TO_GROUP = _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, mapActionsToGroup(_agentInteractions.AgentInteractionActions, _agentInteractions.ACTION_GROUP)), mapActionsToGroup(_editing.AgentEditingActions, _editing.ACTION_GROUP)), mapActionsToGroup(_debug.AgentDebugActions, _debug.ACTION_GROUP)), mapActionsToGroup(_tools.AgentToolActions, _tools.ACTION_GROUP)), mapActionsToGroup(_createFlow.CreateFlowActions, _createFlow.ACTION_GROUP)), mapActionsToGroup(_addToolsPrompt.AddToolsPromptActions, _addToolsPrompt.ACTION_GROUP));