@atlaskit/rovo-agent-analytics 0.19.0 → 1.0.0

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

@@ -1,38 +1 @@
-/**
- * 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 */
-export const ACTION_GROUP = 'agentInteractions';
-export let 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;
-}({});
+export {};

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

@@ -1,25 +0,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 */
-export const ACTION_GROUP = 'debug';
-export let 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/es2019/actions/groups/editing.js

@@ -1,20 +1 @@
-/**
- * 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 */
-export const ACTION_GROUP = 'editing';
-export let AgentEditingActions = /*#__PURE__*/function (AgentEditingActions) {
-  /* Agent updated - https://data-portal.internal.atlassian.com/analytics/registry/97122 */
-  AgentEditingActions["UPDATED"] = "updated";
-  return AgentEditingActions;
-}({});
+export {};

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

@@ -1,26 +1 @@
-/**
- * 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 */
-export const ACTION_GROUP = 'tools';
-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";
-  /* When tools execution result is being streamed and user stops the stream e.g. by clicking stop button https://data-portal.internal.atlassian.com/analytics/registry/97750 */
-  AgentToolActions["TOOLS_EXECUTION_STREAM_STOPPED"] = "toolsExecutionStreamStopped";
-  /* When tools execution result is done streaming and user sees the result https://data-portal.internal.atlassian.com/analytics/registry/97751*/
-  AgentToolActions["TOOLS_EXECUTION_RESULT_VIEWED"] = "toolsExecutionResultViewed";
-  /* When tools execution result streaming fails https://data-portal.internal.atlassian.com/analytics/registry/97752 */
-  AgentToolActions["TOOLS_EXECUTION_RESULT_ERROR"] = "toolsExecutionResultError";
-  return AgentToolActions;
-}({});
+export {};

package/dist/es2019/actions/index.js

@@ -1,21 +1,8 @@
 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';
-
-// Backward-compatible aliases
-// TODO: migrate consumers to use group-specific imports, then remove
-export const AgentCommonActions = {
-  ...AgentInteractionActions,
-  ...AgentEditingActions
-};
-
-// TODO: Remove the alias, will be breaking change, this is just for backward compatibility
-export const AgentDebugActions = AgentDebugActionsEnum;
 const globalEventConfig = getDefaultTrackEventConfig();
 export const useRovoAgentActionAnalytics = commonAttributes => {
   const analyticsContext = useContext(AnalyticsReactContext);
@@ -27,6 +14,7 @@ export const useRovoAgentActionAnalytics = commonAttributes => {
     const attributes = {
       ...getAttributesFromContexts(analyticsContext.getAtlaskitAnalyticsContext()),
       ...commonAttributesRef.current,
+      library: LIBRARY_ATTRIBUTE,
       ...event.attributes
     };
     createAnalyticsEvent({
@@ -36,31 +24,26 @@ export const useRovoAgentActionAnalytics = commonAttributes => {
     }).fire(ANALYTICS_CHANNEL);
   }, [createAnalyticsEvent, analyticsContext] // keep number of dependencies minimal to prevent re-rendering
   );
-  const trackAgentAction = useCallback((action, attributes) => {
-    fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+
+  /**
+   * Fully-typed event tracking using discriminated union payload types.
+   * The payload type enforces correct action, actionSubject, and attributes.
+   */
+  const trackAgentEvent = useCallback(payload => {
+    const {
       action,
-      attributes: {
-        ...attributes,
-        actionGroup: ACTION_TO_GROUP[action]
-      }
-    });
-  }, [fireAnalyticsEvent]);
-  const trackAgentActionError = useCallback((action, error, attributes) => {
+      actionSubject,
+      attributes,
+      ...eventProps
+    } = payload;
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgentError',
+      actionSubject,
       action,
-      attributes: {
-        ...attributes,
-        actionGroup: ACTION_TO_GROUP[action],
-        error: {
-          message: error.message
-        }
-      }
+      ...eventProps,
+      attributes
     });
   }, [fireAnalyticsEvent]);
   return {
-    trackAgentAction,
-    trackAgentActionError
+    trackAgentEvent
   };
 };

package/dist/es2019/common/types.js

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

package/dist/es2019/create/index.js

@@ -1,18 +1,29 @@
 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 { ANALYTICS_CHANNEL } from '../common/constants';
 import { useRovoAgentCSID } from '../common/csid';
 import { getAttributesFromContexts, getDefaultTrackEventConfig } from '../common/utils';
+const DefaultActionSubject = 'rovoAgent';
+
+/**
+ * Union type of all valid create agent flow actions.
+ * Includes both CreateFlow and AddToolsPrompt actions.
+ *
+ * Data portal registry links:
+ * - createFlowStart: https://data-portal.internal.atlassian.com/analytics/registry/97089
+ * - createFlowSkipNL: https://data-portal.internal.atlassian.com/analytics/registry/97127
+ * - createFlowReviewNL: https://data-portal.internal.atlassian.com/analytics/registry/97124
+ * - createFlowActivate: https://data-portal.internal.atlassian.com/analytics/registry/97123
+ * - createFlowRestart: https://data-portal.internal.atlassian.com/analytics/registry/97131
+ * - createFlowError: https://data-portal.internal.atlassian.com/analytics/registry/97132
+ * - createLandInStudio: https://data-portal.internal.atlassian.com/analytics/registry/97136
+ * - createDiscard: https://data-portal.internal.atlassian.com/analytics/registry/97137
+ * - saDraft: https://data-portal.internal.atlassian.com/analytics/registry/97924
+ * - addToolsPromptShown: https://data-portal.internal.atlassian.com/analytics/registry/98106
+ * - addToolsPromptBrowse: https://data-portal.internal.atlassian.com/analytics/registry/98107
+ * - addToolsPromptDismiss: https://data-portal.internal.atlassian.com/analytics/registry/98108
+ */
 
-// Backward-compatible alias
-// TODO: migrate consumers to use CreateFlowActions / AddToolsPromptActions directly, then remove
-export const AgentCreateActions = {
-  ...CreateFlowActions,
-  ...AddToolsPromptActions
-};
 const globalEventConfig = getDefaultTrackEventConfig();
 export const useRovoAgentCreateAnalytics = commonAttributes => {
   const [csid, {
@@ -25,12 +36,11 @@ 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],
+      actionGroup: 'createFlow',
       csid,
       referrer
     };
@@ -48,7 +58,7 @@ export const useRovoAgentCreateAnalytics = commonAttributes => {
    */
   const trackCreateSession = useCallback((action, attributes) => {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: DefaultActionSubject,
       action,
       attributes
     });
@@ -59,16 +69,16 @@ export const useRovoAgentCreateAnalytics = commonAttributes => {
    */
   const trackCreateSessionStart = useCallback(attributes => {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
-      action: CreateFlowActions.START,
+      actionSubject: DefaultActionSubject,
+      action: 'createFlowStart',
       attributes
     });
     refreshCSID();
   }, [fireAnalyticsEvent, refreshCSID]);
   const trackCreateSessionError = useCallback((error, attributes) => {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
-      action: CreateFlowActions.ERROR,
+      actionSubject: DefaultActionSubject,
+      action: 'createFlowError',
       attributes: {
         error: {
           message: error.message

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

@@ -1,38 +1 @@
-/**
- * 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 */
-export var ACTION_GROUP = 'agentInteractions';
-export var 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;
-}({});
+export {};

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

@@ -1,25 +0,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 */
-export var ACTION_GROUP = 'debug';
-export var 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/esm/actions/groups/editing.js

@@ -1,20 +1 @@
-/**
- * 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 */
-export var ACTION_GROUP = 'editing';
-export var AgentEditingActions = /*#__PURE__*/function (AgentEditingActions) {
-  /* Agent updated - https://data-portal.internal.atlassian.com/analytics/registry/97122 */
-  AgentEditingActions["UPDATED"] = "updated";
-  return AgentEditingActions;
-}({});
+export {};

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

@@ -1,26 +1 @@
-/**
- * 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 */
-export var ACTION_GROUP = 'tools';
-export var 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";
-  /* When tools execution result is being streamed and user stops the stream e.g. by clicking stop button https://data-portal.internal.atlassian.com/analytics/registry/97750 */
-  AgentToolActions["TOOLS_EXECUTION_STREAM_STOPPED"] = "toolsExecutionStreamStopped";
-  /* When tools execution result is done streaming and user sees the result https://data-portal.internal.atlassian.com/analytics/registry/97751*/
-  AgentToolActions["TOOLS_EXECUTION_RESULT_VIEWED"] = "toolsExecutionResultViewed";
-  /* When tools execution result streaming fails https://data-portal.internal.atlassian.com/analytics/registry/97752 */
-  AgentToolActions["TOOLS_EXECUTION_RESULT_ERROR"] = "toolsExecutionResultError";
-  return AgentToolActions;
-}({});
+export {};

package/dist/esm/actions/index.js

@@ -1,21 +1,13 @@
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+var _excluded = ["action", "actionSubject", "attributes"];
 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) { _defineProperty(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; }
 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';
-
-// Backward-compatible aliases
-// TODO: migrate consumers to use group-specific imports, then remove
-export var AgentCommonActions = _objectSpread(_objectSpread({}, AgentInteractionActions), AgentEditingActions);
-
-// TODO: Remove the alias, will be breaking change, this is just for backward compatibility
-export var AgentDebugActions = AgentDebugActionsEnum;
 var globalEventConfig = getDefaultTrackEventConfig();
 export var useRovoAgentActionAnalytics = function useRovoAgentActionAnalytics(commonAttributes) {
   var analyticsContext = useContext(AnalyticsReactContext);
@@ -23,35 +15,32 @@ export var useRovoAgentActionAnalytics = function useRovoAgentActionAnalytics(co
     createAnalyticsEvent = _useAnalyticsEvents.createAnalyticsEvent;
   var commonAttributesRef = useRef(commonAttributes);
   var fireAnalyticsEvent = useCallback(function (event) {
-    var attributes = _objectSpread(_objectSpread(_objectSpread({}, getAttributesFromContexts(analyticsContext.getAtlaskitAnalyticsContext())), commonAttributesRef.current), event.attributes);
+    var attributes = _objectSpread(_objectSpread(_objectSpread({}, getAttributesFromContexts(analyticsContext.getAtlaskitAnalyticsContext())), commonAttributesRef.current), {}, {
+      library: LIBRARY_ATTRIBUTE
+    }, event.attributes);
     createAnalyticsEvent(_objectSpread(_objectSpread(_objectSpread({}, globalEventConfig), event), {}, {
       attributes: attributes
     })).fire(ANALYTICS_CHANNEL);
   }, [createAnalyticsEvent, analyticsContext] // keep number of dependencies minimal to prevent re-rendering
   );
-  var trackAgentAction = useCallback(function (action, attributes) {
-    fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
-      action: action,
-      attributes: _objectSpread(_objectSpread({}, attributes), {}, {
-        actionGroup: ACTION_TO_GROUP[action]
-      })
-    });
-  }, [fireAnalyticsEvent]);
-  var trackAgentActionError = useCallback(function (action, error, attributes) {
-    fireAnalyticsEvent({
-      actionSubject: 'rovoAgentError',
-      action: action,
-      attributes: _objectSpread(_objectSpread({}, attributes), {}, {
-        actionGroup: ACTION_TO_GROUP[action],
-        error: {
-          message: error.message
-        }
-      })
-    });
+
+  /**
+   * Fully-typed event tracking using discriminated union payload types.
+   * The payload type enforces correct action, actionSubject, and attributes.
+   */
+  var trackAgentEvent = useCallback(function (payload) {
+    var action = payload.action,
+      actionSubject = payload.actionSubject,
+      attributes = payload.attributes,
+      eventProps = _objectWithoutProperties(payload, _excluded);
+    fireAnalyticsEvent(_objectSpread(_objectSpread({
+      actionSubject: actionSubject,
+      action: action
+    }, eventProps), {}, {
+      attributes: attributes
+    }));
   }, [fireAnalyticsEvent]);
   return {
-    trackAgentAction: trackAgentAction,
-    trackAgentActionError: trackAgentActionError
+    trackAgentEvent: trackAgentEvent
   };
 };

package/dist/esm/common/types.js

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

package/dist/esm/create/index.js

@@ -1,19 +1,33 @@
-import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 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) { _defineProperty(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; }
 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 { ANALYTICS_CHANNEL } from '../common/constants';
 import { useRovoAgentCSID } from '../common/csid';
 import { getAttributesFromContexts, getDefaultTrackEventConfig } from '../common/utils';
+var DefaultActionSubject = 'rovoAgent';
+
+/**
+ * Union type of all valid create agent flow actions.
+ * Includes both CreateFlow and AddToolsPrompt actions.
+ *
+ * Data portal registry links:
+ * - createFlowStart: https://data-portal.internal.atlassian.com/analytics/registry/97089
+ * - createFlowSkipNL: https://data-portal.internal.atlassian.com/analytics/registry/97127
+ * - createFlowReviewNL: https://data-portal.internal.atlassian.com/analytics/registry/97124
+ * - createFlowActivate: https://data-portal.internal.atlassian.com/analytics/registry/97123
+ * - createFlowRestart: https://data-portal.internal.atlassian.com/analytics/registry/97131
+ * - createFlowError: https://data-portal.internal.atlassian.com/analytics/registry/97132
+ * - createLandInStudio: https://data-portal.internal.atlassian.com/analytics/registry/97136
+ * - createDiscard: https://data-portal.internal.atlassian.com/analytics/registry/97137
+ * - saDraft: https://data-portal.internal.atlassian.com/analytics/registry/97924
+ * - addToolsPromptShown: https://data-portal.internal.atlassian.com/analytics/registry/98106
+ * - addToolsPromptBrowse: https://data-portal.internal.atlassian.com/analytics/registry/98107
+ * - addToolsPromptDismiss: https://data-portal.internal.atlassian.com/analytics/registry/98108
+ */
 
-// Backward-compatible alias
-// TODO: migrate consumers to use CreateFlowActions / AddToolsPromptActions directly, then remove
-export var AgentCreateActions = _objectSpread(_objectSpread({}, CreateFlowActions), AddToolsPromptActions);
 var globalEventConfig = getDefaultTrackEventConfig();
 export var useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(commonAttributes) {
   var _useRovoAgentCSID = useRovoAgentCSID(),
@@ -26,9 +40,8 @@ export var useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(co
   var commonAttributesRef = useRef(commonAttributes);
   var fireAnalyticsEvent = useCallback(function (event) {
     var referrer = typeof window !== 'undefined' ? window.document.referrer : 'unknown';
-    var action = event.action;
     var attributes = _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, getAttributesFromContexts(analyticsContext.getAtlaskitAnalyticsContext())), commonAttributesRef.current), event.attributes), {}, {
-      actionGroup: ACTION_TO_GROUP[action],
+      actionGroup: 'createFlow',
       csid: csid,
       referrer: referrer
     });
@@ -44,7 +57,7 @@ export var useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(co
    */
   var trackCreateSession = useCallback(function (action, attributes) {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: DefaultActionSubject,
       action: action,
       attributes: attributes
     });
@@ -55,16 +68,16 @@ export var useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(co
    */
   var trackCreateSessionStart = useCallback(function (attributes) {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
-      action: CreateFlowActions.START,
+      actionSubject: DefaultActionSubject,
+      action: 'createFlowStart',
       attributes: attributes
     });
     refreshCSID();
   }, [fireAnalyticsEvent, refreshCSID]);
   var trackCreateSessionError = useCallback(function (error, attributes) {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
-      action: CreateFlowActions.ERROR,
+      actionSubject: DefaultActionSubject,
+      action: 'createFlowError',
       attributes: _objectSpread({
         error: {
           message: error.message