@atlaskit/rovo-agent-analytics 0.19.0 → 0.20.0

package/dist/cjs/common/types.js

@@ -1 +1,13 @@
-"use strict";
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.LIBRARY_ATTRIBUTE = void 0;
+/** Common library attribute injected into all events */
+var LIBRARY_ATTRIBUTE = exports.LIBRARY_ATTRIBUTE = 'agents-analytics';
+
+/**
+ * Union of all event payload types.
+ * Use with `trackAgentEvent()` for typed event tracking.
+ */

package/dist/cjs/create/index.js

@@ -32,9 +32,7 @@ var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function
   var commonAttributesRef = (0, _react.useRef)(commonAttributes);
   var fireAnalyticsEvent = (0, _react.useCallback)(function (event) {
     var referrer = typeof window !== 'undefined' ? window.document.referrer : 'unknown';
-    var action = event.action;
     var attributes = _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, (0, _utils.getAttributesFromContexts)(analyticsContext.getAtlaskitAnalyticsContext())), commonAttributesRef.current), event.attributes), {}, {
-      actionGroup: _registry.ACTION_TO_GROUP[action],
       csid: csid,
       referrer: referrer
     });
@@ -50,7 +48,7 @@ var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function
    */
   var trackCreateSession = (0, _react.useCallback)(function (action, attributes) {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: _registry.DefaultActionSubject,
       action: action,
       attributes: attributes
     });
@@ -61,7 +59,7 @@ var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function
    */
   var trackCreateSessionStart = (0, _react.useCallback)(function (attributes) {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: _registry.DefaultActionSubject,
       action: _createFlow.CreateFlowActions.START,
       attributes: attributes
     });
@@ -69,7 +67,7 @@ var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function
   }, [fireAnalyticsEvent, refreshCSID]);
   var trackCreateSessionError = (0, _react.useCallback)(function (error, attributes) {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: _registry.DefaultActionSubject,
       action: _createFlow.CreateFlowActions.ERROR,
       attributes: _objectSpread({
         error: {

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

@@ -8,13 +8,24 @@
  * 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)
- *
+ * 1. Add a new variant to the `AddToolsPromptEventPayload` union type below with a data-portal link
+ * 2. If this action doesn't fit this group, consider creating a new group file instead
+ *    (see other files in this directory for the template)
+ */
+
+/**
+ * Discriminated union payload type for add tools prompt events.
+ * Use with `trackAgentEvent()`.
  */
 
-/** The group name sent as `attributes.actionGroup` in analytics events */
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use AddToolsPromptEventPayload with trackAgentEvent() instead */
 export const ACTION_GROUP = 'addToolsPrompt';
+
+/** @deprecated Use AddToolsPromptEventPayload with trackAgentEvent() instead */
 export let AddToolsPromptActions = /*#__PURE__*/function (AddToolsPromptActions) {
   /* Add tools prompt shown (agent has no tools) - https://data-portal.internal.atlassian.com/analytics/registry/98106 */
   AddToolsPromptActions["SHOWN"] = "addToolsPromptShown";

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

@@ -7,14 +7,24 @@
  * 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
+ * 1. Add a new variant to the `AgentInteractionsEventPayload` union type below with a data-portal link
+ * 2. 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 */
+/**
+ * Discriminated union payload type for agent interaction events.
+ * Use with `trackAgentEvent()`.
+ */
+
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
 export const ACTION_GROUP = 'agentInteractions';
+
+/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
 export let AgentInteractionActions = /*#__PURE__*/function (AgentInteractionActions) {
   /* View agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97125 */
   AgentInteractionActions["VIEW"] = "view";
@@ -35,4 +45,6 @@ export let AgentInteractionActions = /*#__PURE__*/function (AgentInteractionActi
   /* Unverify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97135 */
   AgentInteractionActions["UNVERIFY"] = "unverify";
   return AgentInteractionActions;
-}({});
+}({});
+
+/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */

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

@@ -4,12 +4,24 @@
  * 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)
+ * 1. Add a new variant to the `CreateFlowEventPayload` union type below with a data-portal link
+ * 2. 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 */
+/**
+ * Discriminated union payload type for create flow events.
+ * Use with `trackAgentEvent()`.
+ */
+
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use CreateFlowEventPayload with trackAgentEvent() instead */
 export const ACTION_GROUP = 'createFlow';
+
+/** @deprecated Use CreateFlowEventPayload with trackAgentEvent() instead */
 export let 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";

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

@@ -4,14 +4,24 @@
  * 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
+ * 1. Add a new variant to the `DebugEventPayload` union type below with a data-portal link
+ * 2. 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 */
+/**
+ * Discriminated union payload type for debug events.
+ * Use with `trackAgentEvent()`.
+ */
+
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
 export const ACTION_GROUP = 'debug';
+
+/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
 export let AgentDebugActions = /*#__PURE__*/function (AgentDebugActions) {
   /* View debug modal - https://data-portal.internal.atlassian.com/analytics/registry/97183 */
   AgentDebugActions["VIEW"] = "debugView";
@@ -22,4 +32,6 @@ export let AgentDebugActions = /*#__PURE__*/function (AgentDebugActions) {
   /* Toggle skill info - https://data-portal.internal.atlassian.com/analytics/registry/97185 */
   AgentDebugActions["TOGGLE_SKILL_INFO"] = "debugToggleSkillInfo";
   return AgentDebugActions;
-}({});
+}({});
+
+/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */

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

@@ -5,16 +5,23 @@
  * 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
+ * 1. Add a new variant to the `EditingEventPayload` union type below with a data-portal link
+ * 2. 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 */
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */
 export const ACTION_GROUP = 'editing';
+
+/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */
 export let AgentEditingActions = /*#__PURE__*/function (AgentEditingActions) {
   /* Agent updated - https://data-portal.internal.atlassian.com/analytics/registry/97122 */
   AgentEditingActions["UPDATED"] = "updated";
   return AgentEditingActions;
-}({});
+}({});
+
+/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */

package/dist/es2019/actions/groups/tools.js

@@ -5,14 +5,19 @@
  * (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
+ * 1. Add a new variant to the `ToolsEventPayload` union type below with a data-portal link
+ * 2. 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 */
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
 export const ACTION_GROUP = 'tools';
+
+/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
 export let 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";
@@ -23,4 +28,10 @@ export let AgentToolActions = /*#__PURE__*/function (AgentToolActions) {
   /* When tools execution result streaming fails https://data-portal.internal.atlassian.com/analytics/registry/97752 */
   AgentToolActions["TOOLS_EXECUTION_RESULT_ERROR"] = "toolsExecutionResultError";
   return AgentToolActions;
-}({});
+}({});
+
+/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
+
+/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
+
+/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */

package/dist/es2019/actions/index.js

@@ -1,11 +1,12 @@
 import { useCallback, useContext, useRef } from 'react';
 import { AnalyticsReactContext, useAnalyticsEvents } from '@atlaskit/analytics-next';
 import { ANALYTICS_CHANNEL } from '../common/constants';
+import { LIBRARY_ATTRIBUTE } from '../common/types';
 import { getAttributesFromContexts, getDefaultTrackEventConfig } from '../common/utils';
 import { AgentInteractionActions } from './groups/agent-interactions';
 import { AgentDebugActions as AgentDebugActionsEnum } from './groups/debug';
 import { AgentEditingActions } from './groups/editing';
-import { ACTION_TO_GROUP } from './registry';
+import { DefaultActionSubject } from './registry';
 
 // Backward-compatible aliases
 // TODO: migrate consumers to use group-specific imports, then remove
@@ -27,6 +28,7 @@ export const useRovoAgentActionAnalytics = commonAttributes => {
     const attributes = {
       ...getAttributesFromContexts(analyticsContext.getAtlaskitAnalyticsContext()),
       ...commonAttributesRef.current,
+      library: LIBRARY_ATTRIBUTE,
       ...event.attributes
     };
     createAnalyticsEvent({
@@ -36,23 +38,49 @@ export const useRovoAgentActionAnalytics = commonAttributes => {
     }).fire(ANALYTICS_CHANNEL);
   }, [createAnalyticsEvent, analyticsContext] // keep number of dependencies minimal to prevent re-rendering
   );
+
+  /**
+   * Simple tracking of just action + attributes only.
+   * Uses default actionSubject ('rovoAgent').
+   *
+   * @deprecated Use trackAgentEvent() with typed payloads instead
+   */
   const trackAgentAction = useCallback((action, attributes) => {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: DefaultActionSubject,
       action,
-      attributes: {
-        ...attributes,
-        actionGroup: ACTION_TO_GROUP[action]
-      }
+      attributes
     });
   }, [fireAnalyticsEvent]);
+
+  /**
+   * Fully-typed event tracking using discriminated union payload types.
+   * The payload type enforces correct action, actionSubject, and attributes.
+   */
+  const trackAgentEvent = useCallback(payload => {
+    const {
+      action,
+      actionSubject,
+      attributes,
+      ...eventProps
+    } = payload;
+    fireAnalyticsEvent({
+      actionSubject,
+      action,
+      ...eventProps,
+      attributes
+    });
+  }, [fireAnalyticsEvent]);
+
+  /**
+   * @deprecated Use trackAgentEvent() with typed payloads instead
+   */
   const trackAgentActionError = useCallback((action, error, attributes) => {
     fireAnalyticsEvent({
       actionSubject: 'rovoAgentError',
       action,
       attributes: {
         ...attributes,
-        actionGroup: ACTION_TO_GROUP[action],
         error: {
           message: error.message
         }
@@ -61,6 +89,7 @@ export const useRovoAgentActionAnalytics = commonAttributes => {
   }, [fireAnalyticsEvent]);
   return {
     trackAgentAction,
+    trackAgentEvent,
     trackAgentActionError
   };
 };

package/dist/es2019/actions/registry.js

@@ -1,52 +1,20 @@
 /**
- * Action Registry
+ * Action Registry (Backwards Compatibility)
  *
- * 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.
+ * This file contains deprecated exports for backwards compatibility
+ * with consumers using `trackAgentAction()`.
  *
- * Both `useRovoAgentActionAnalytics` and `useRovoAgentCreateAnalytics` hooks
- * use `ACTION_TO_GROUP` from this registry.
+ * For new code, use the payload types from each group file directly
+ * with `trackAgentEvent()`.
  *
- * ## 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`
+ * @deprecated The registry pattern is deprecated. Use EventPayload from types.ts instead.
  */
-import { AddToolsPromptActions, ACTION_GROUP as ADD_TOOLS_PROMPT_GROUP } from './groups/add-tools-prompt';
-import { AgentInteractionActions, ACTION_GROUP as AGENT_INTERACTIONS_GROUP } from './groups/agent-interactions';
-import { CreateFlowActions, ACTION_GROUP as CREATE_FLOW_GROUP } from './groups/create-flow';
-import { AgentDebugActions, ACTION_GROUP as DEBUG_GROUP } from './groups/debug';
-import { AgentEditingActions, ACTION_GROUP as EDITING_GROUP } from './groups/editing';
-import { AgentToolActions, ACTION_GROUP as TOOLS_GROUP } from './groups/tools';
 
-/**
- * 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.
- */
-const mapActionsToGroup = (actionEnum, group) => {
-  return Object.fromEntries(Object.values(actionEnum).map(action => [action, group]));
-};
+export const DefaultActionSubject = 'rovoAgent';
 
 /**
- * Runtime lookup: action value → group name.
- * Used by ALL analytics hooks to auto-inject `attributes.actionGroup`.
+ * Combined attribute map (union of all groups).
+ * Used by the backward-compatible `trackAgentAction` helper.
  *
- * When you add a new group, add it here too.
- */
-export const ACTION_TO_GROUP = {
-  // Action hook groups
-  ...mapActionsToGroup(AgentInteractionActions, AGENT_INTERACTIONS_GROUP),
-  ...mapActionsToGroup(AgentEditingActions, EDITING_GROUP),
-  ...mapActionsToGroup(AgentDebugActions, DEBUG_GROUP),
-  ...mapActionsToGroup(AgentToolActions, TOOLS_GROUP),
-  // Create hook groups
-  ...mapActionsToGroup(CreateFlowActions, CREATE_FLOW_GROUP),
-  ...mapActionsToGroup(AddToolsPromptActions, ADD_TOOLS_PROMPT_GROUP)
-};
+ * @deprecated Use EventPayload with trackAgentEvent() instead
+ */

package/dist/es2019/common/types.js

@@ -0,0 +1,7 @@
+/** Common library attribute injected into all events */
+export const LIBRARY_ATTRIBUTE = 'agents-analytics';
+
+/**
+ * Union of all event payload types.
+ * Use with `trackAgentEvent()` for typed event tracking.
+ */

package/dist/es2019/create/index.js

@@ -2,7 +2,7 @@ import { useCallback, useContext, useRef } from 'react';
 import { AnalyticsReactContext, useAnalyticsEvents } from '@atlaskit/analytics-next';
 import { AddToolsPromptActions } from '../actions/groups/add-tools-prompt';
 import { CreateFlowActions } from '../actions/groups/create-flow';
-import { ACTION_TO_GROUP } from '../actions/registry';
+import { DefaultActionSubject } from '../actions/registry';
 import { ANALYTICS_CHANNEL } from '../common/constants';
 import { useRovoAgentCSID } from '../common/csid';
 import { getAttributesFromContexts, getDefaultTrackEventConfig } from '../common/utils';
@@ -25,12 +25,10 @@ export const useRovoAgentCreateAnalytics = commonAttributes => {
   const commonAttributesRef = useRef(commonAttributes);
   const fireAnalyticsEvent = useCallback(event => {
     const referrer = typeof window !== 'undefined' ? window.document.referrer : 'unknown';
-    const action = event.action;
     const attributes = {
       ...getAttributesFromContexts(analyticsContext.getAtlaskitAnalyticsContext()),
       ...commonAttributesRef.current,
       ...event.attributes,
-      actionGroup: ACTION_TO_GROUP[action],
       csid,
       referrer
     };
@@ -48,7 +46,7 @@ export const useRovoAgentCreateAnalytics = commonAttributes => {
    */
   const trackCreateSession = useCallback((action, attributes) => {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: DefaultActionSubject,
       action,
       attributes
     });
@@ -59,7 +57,7 @@ export const useRovoAgentCreateAnalytics = commonAttributes => {
    */
   const trackCreateSessionStart = useCallback(attributes => {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: DefaultActionSubject,
       action: CreateFlowActions.START,
       attributes
     });
@@ -67,7 +65,7 @@ export const useRovoAgentCreateAnalytics = commonAttributes => {
   }, [fireAnalyticsEvent, refreshCSID]);
   const trackCreateSessionError = useCallback((error, attributes) => {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: DefaultActionSubject,
       action: CreateFlowActions.ERROR,
       attributes: {
         error: {

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

@@ -8,13 +8,24 @@
  * 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)
- *
+ * 1. Add a new variant to the `AddToolsPromptEventPayload` union type below with a data-portal link
+ * 2. If this action doesn't fit this group, consider creating a new group file instead
+ *    (see other files in this directory for the template)
+ */
+
+/**
+ * Discriminated union payload type for add tools prompt events.
+ * Use with `trackAgentEvent()`.
  */
 
-/** The group name sent as `attributes.actionGroup` in analytics events */
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use AddToolsPromptEventPayload with trackAgentEvent() instead */
 export var ACTION_GROUP = 'addToolsPrompt';
+
+/** @deprecated Use AddToolsPromptEventPayload with trackAgentEvent() instead */
 export var AddToolsPromptActions = /*#__PURE__*/function (AddToolsPromptActions) {
   /* Add tools prompt shown (agent has no tools) - https://data-portal.internal.atlassian.com/analytics/registry/98106 */
   AddToolsPromptActions["SHOWN"] = "addToolsPromptShown";

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

@@ -7,14 +7,24 @@
  * 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
+ * 1. Add a new variant to the `AgentInteractionsEventPayload` union type below with a data-portal link
+ * 2. 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 */
+/**
+ * Discriminated union payload type for agent interaction events.
+ * Use with `trackAgentEvent()`.
+ */
+
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
 export var ACTION_GROUP = 'agentInteractions';
+
+/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
 export var AgentInteractionActions = /*#__PURE__*/function (AgentInteractionActions) {
   /* View agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97125 */
   AgentInteractionActions["VIEW"] = "view";
@@ -35,4 +45,6 @@ export var AgentInteractionActions = /*#__PURE__*/function (AgentInteractionActi
   /* Unverify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97135 */
   AgentInteractionActions["UNVERIFY"] = "unverify";
   return AgentInteractionActions;
-}({});
+}({});
+
+/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */

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

@@ -4,12 +4,24 @@
  * 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)
+ * 1. Add a new variant to the `CreateFlowEventPayload` union type below with a data-portal link
+ * 2. 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 */
+/**
+ * Discriminated union payload type for create flow events.
+ * Use with `trackAgentEvent()`.
+ */
+
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use CreateFlowEventPayload with trackAgentEvent() instead */
 export var ACTION_GROUP = 'createFlow';
+
+/** @deprecated Use CreateFlowEventPayload with trackAgentEvent() instead */
 export var 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";

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

@@ -4,14 +4,24 @@
  * 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
+ * 1. Add a new variant to the `DebugEventPayload` union type below with a data-portal link
+ * 2. 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 */
+/**
+ * Discriminated union payload type for debug events.
+ * Use with `trackAgentEvent()`.
+ */
+
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
 export var ACTION_GROUP = 'debug';
+
+/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
 export var AgentDebugActions = /*#__PURE__*/function (AgentDebugActions) {
   /* View debug modal - https://data-portal.internal.atlassian.com/analytics/registry/97183 */
   AgentDebugActions["VIEW"] = "debugView";
@@ -22,4 +32,6 @@ export var AgentDebugActions = /*#__PURE__*/function (AgentDebugActions) {
   /* Toggle skill info - https://data-portal.internal.atlassian.com/analytics/registry/97185 */
   AgentDebugActions["TOGGLE_SKILL_INFO"] = "debugToggleSkillInfo";
   return AgentDebugActions;
-}({});
+}({});
+
+/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */

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

@@ -5,16 +5,23 @@
  * 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
+ * 1. Add a new variant to the `EditingEventPayload` union type below with a data-portal link
+ * 2. 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 */
+// ============================================================================
+// BACKWARDS COMPAT (deprecated): Keep enum and attributes for trackAgentAction() consumers
+// ============================================================================
+
+/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */
 export var ACTION_GROUP = 'editing';
+
+/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */
 export var AgentEditingActions = /*#__PURE__*/function (AgentEditingActions) {
   /* Agent updated - https://data-portal.internal.atlassian.com/analytics/registry/97122 */
   AgentEditingActions["UPDATED"] = "updated";
   return AgentEditingActions;
-}({});
+}({});
+
+/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */