@atlaskit/rovo-agent-analytics 0.18.0 → 0.20.0

package/dist/cjs/actions/index.js

@@ -5,47 +5,26 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useRovoAgentActionAnalytics = exports.AgentDebugActions = exports.AgentCommonActions = void 0;
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _react = require("react");
 var _analyticsNext = require("@atlaskit/analytics-next");
 var _constants = require("../common/constants");
+var _types = require("../common/types");
 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");
+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) { (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);
@@ -53,19 +32,49 @@ var useRovoAgentActionAnalytics = exports.useRovoAgentActionAnalytics = function
     createAnalyticsEvent = _useAnalyticsEvents.createAnalyticsEvent;
   var commonAttributesRef = (0, _react.useRef)(commonAttributes);
   var fireAnalyticsEvent = (0, _react.useCallback)(function (event) {
-    var attributes = _objectSpread(_objectSpread(_objectSpread({}, (0, _utils.getAttributesFromContexts)(analyticsContext.getAtlaskitAnalyticsContext())), commonAttributesRef.current), event.attributes);
+    var attributes = _objectSpread(_objectSpread(_objectSpread({}, (0, _utils.getAttributesFromContexts)(analyticsContext.getAtlaskitAnalyticsContext())), commonAttributesRef.current), {}, {
+      library: _types.LIBRARY_ATTRIBUTE
+    }, event.attributes);
     createAnalyticsEvent(_objectSpread(_objectSpread(_objectSpread({}, globalEventConfig), event), {}, {
       attributes: attributes
     })).fire(_constants.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
+   */
   var trackAgentAction = (0, _react.useCallback)(function (action, attributes) {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
+      actionSubject: _registry.DefaultActionSubject,
       action: action,
       attributes: attributes
     });
   }, [fireAnalyticsEvent]);
+
+  /**
+   * Fully-typed event tracking using discriminated union payload types.
+   * The payload type enforces correct action, actionSubject, and attributes.
+   */
+  var trackAgentEvent = (0, _react.useCallback)(function (payload) {
+    var action = payload.action,
+      actionSubject = payload.actionSubject,
+      attributes = payload.attributes,
+      eventProps = (0, _objectWithoutProperties2.default)(payload, _excluded);
+    fireAnalyticsEvent(_objectSpread(_objectSpread({
+      actionSubject: actionSubject,
+      action: action
+    }, eventProps), {}, {
+      attributes: attributes
+    }));
+  }, [fireAnalyticsEvent]);
+
+  /**
+   * @deprecated Use trackAgentEvent() with typed payloads instead
+   */
   var trackAgentActionError = (0, _react.useCallback)(function (action, error, attributes) {
     fireAnalyticsEvent({
       actionSubject: 'rovoAgentError',
@@ -79,6 +88,7 @@ var useRovoAgentActionAnalytics = exports.useRovoAgentActionAnalytics = function
   }, [fireAnalyticsEvent]);
   return {
     trackAgentAction: trackAgentAction,
+    trackAgentEvent: trackAgentEvent,
     trackAgentActionError: trackAgentActionError
   };
 };

package/dist/cjs/actions/registry.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DefaultActionSubject = void 0;
+/**
+ * Action Registry (Backwards Compatibility)
+ *
+ * This file contains deprecated exports for backwards compatibility
+ * with consumers using `trackAgentAction()`.
+ *
+ * For new code, use the payload types from each group file directly
+ * with `trackAgentEvent()`.
+ *
+ * @deprecated The registry pattern is deprecated. Use EventPayload from types.ts instead.
+ */
+
+var DefaultActionSubject = exports.DefaultActionSubject = 'rovoAgent';
+
+/**
+ * Combined attribute map (union of all groups).
+ * Used by the backward-compatible `trackAgentAction` helper.
+ *
+ * @deprecated Use EventPayload with trackAgentEvent() instead
+ */

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

@@ -5,42 +5,21 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.useRovoAgentCreateAnalytics = exports.AgentCreateActions = void 0;
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _react = require("react");
 var _analyticsNext = require("@atlaskit/analytics-next");
+var _addToolsPrompt = require("../actions/groups/add-tools-prompt");
+var _createFlow = require("../actions/groups/create-flow");
+var _registry = require("../actions/registry");
 var _constants = require("../common/constants");
 var _csid = require("../common/csid");
 var _utils = require("../common/utils");
 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 AgentCreateActions = exports.AgentCreateActions = /*#__PURE__*/function (AgentCreateActions) {
-  /* Start create flow when user clicks on "Create agent" button - https://data-portal.internal.atlassian.com/analytics/registry/97089 */
-  AgentCreateActions["START"] = "createFlowStart";
-  /* Skip natural language - https://data-portal.internal.atlassian.com/analytics/registry/97127 */
-  AgentCreateActions["SKIP_NL"] = "createFlowSkipNL";
-  /* Review natural language - https://data-portal.internal.atlassian.com/analytics/registry/97124 */
-  AgentCreateActions["REVIEW_NL"] = "createFlowReviewNL";
-  /* Activate agent - https://data-portal.internal.atlassian.com/analytics/registry/97123 */
-  AgentCreateActions["ACTIVATE"] = "createFlowActivate";
-  /* Restart create flow - https://data-portal.internal.atlassian.com/analytics/registry/97131 */
-  AgentCreateActions["RESTART"] = "createFlowRestart";
-  /* Error occurred - https://data-portal.internal.atlassian.com/analytics/registry/97132 */
-  AgentCreateActions["ERROR"] = "createFlowError";
-  /* Land in studio - https://data-portal.internal.atlassian.com/analytics/registry/97136 */
-  AgentCreateActions["LAND"] = "createLandInStudio";
-  /* Discard agent - https://data-portal.internal.atlassian.com/analytics/registry/97137 */
-  AgentCreateActions["DISCARD"] = "createDiscard";
-  /* Show no skills modal - https://data-portal.internal.atlassian.com/analytics/registry/97435 */
-  AgentCreateActions["SHOW_NO_SKILLS_MODAL"] = "showNoSkillsModal";
-  /* Browse click no skills modal - https://data-portal.internal.atlassian.com/analytics/registry/97436 */
-  AgentCreateActions["BROWSE_CLICK_NO_SKILLS_MODAL"] = "browseClickNoSkillsModal";
-  /* Discard no skills modal - https://data-portal.internal.atlassian.com/analytics/registry/97437 */
-  AgentCreateActions["DISCARD_NO_SKILLS_MODAL"] = "discardNoSkillsModal";
-  /* Draft created from solution architect plan card - https://data-portal.internal.atlassian.com/analytics/registry/97924 */
-  AgentCreateActions["SA_DRAFT"] = "saDraft";
-  return AgentCreateActions;
-}({});
+// Backward-compatible alias
+// TODO: migrate consumers to use CreateFlowActions / AddToolsPromptActions directly, then remove
+var AgentCreateActions = exports.AgentCreateActions = _objectSpread(_objectSpread({}, _createFlow.CreateFlowActions), _addToolsPrompt.AddToolsPromptActions);
 var globalEventConfig = (0, _utils.getDefaultTrackEventConfig)();
 var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(commonAttributes) {
   var _useRovoAgentCSID = (0, _csid.useRovoAgentCSID)(),
@@ -69,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
     });
@@ -80,16 +59,16 @@ var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function
    */
   var trackCreateSessionStart = (0, _react.useCallback)(function (attributes) {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
-      action: AgentCreateActions.START,
+      actionSubject: _registry.DefaultActionSubject,
+      action: _createFlow.CreateFlowActions.START,
       attributes: attributes
     });
     refreshCSID();
   }, [fireAnalyticsEvent, refreshCSID]);
   var trackCreateSessionError = (0, _react.useCallback)(function (error, attributes) {
     fireAnalyticsEvent({
-      actionSubject: 'rovoAgent',
-      action: AgentCreateActions.ERROR,
+      actionSubject: _registry.DefaultActionSubject,
+      action: _createFlow.CreateFlowActions.ERROR,
       attributes: _objectSpread({
         error: {
           message: error.message

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

@@ -0,0 +1,37 @@
+/**
+ * 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 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()`.
+ */
+
+// ============================================================================
+// 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";
+  /* 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/es2019/actions/groups/agent-interactions.js

@@ -0,0 +1,50 @@
+/**
+ * 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 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)
+ */
+
+/**
+ * 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";
+  /* 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;
+}({});
+
+/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */

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

@@ -0,0 +1,45 @@
+/**
+ * Action Group: createFlow
+ *
+ * Create agent funnel steps — from clicking "Create agent" through to activation or discard,
+ *
+ * ## Adding a new action
+ * 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)
+ */
+
+/**
+ * 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";
+  /* 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/es2019/actions/groups/debug.js

@@ -0,0 +1,37 @@
+/**
+ * Action Group: debug
+ *
+ * Actions related to the agent debug modal (viewing, copying debug data, toggling skill info).
+ *
+ * ## Adding a new action
+ * 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)
+ */
+
+/**
+ * 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";
+  /* 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;
+}({});
+
+/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */

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

@@ -0,0 +1,27 @@
+/**
+ * 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 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)
+ */
+
+// ============================================================================
+// 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/{tool-actions/index.js → groups/tools.js}

@@ -1,3 +1,23 @@
+/**
+ * Action Group: tools
+ *
+ * Actions related to agent tool execution during chat
+ * (confirming, streaming, viewing results, errors).
+ *
+ * ## Adding a new action
+ * 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)
+ */
+
+// ============================================================================
+// 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";
@@ -8,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,41 +1,22 @@
 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';
-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;
-}({});
-export let 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;
-}({});
+import { AgentInteractionActions } from './groups/agent-interactions';
+import { AgentDebugActions as AgentDebugActionsEnum } from './groups/debug';
+import { AgentEditingActions } from './groups/editing';
+import { DefaultActionSubject } 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);
@@ -47,6 +28,7 @@ export const useRovoAgentActionAnalytics = commonAttributes => {
     const attributes = {
       ...getAttributesFromContexts(analyticsContext.getAtlaskitAnalyticsContext()),
       ...commonAttributesRef.current,
+      library: LIBRARY_ATTRIBUTE,
       ...event.attributes
     };
     createAnalyticsEvent({
@@ -56,13 +38,43 @@ 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
     });
   }, [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',
@@ -77,6 +89,7 @@ export const useRovoAgentActionAnalytics = commonAttributes => {
   }, [fireAnalyticsEvent]);
   return {
     trackAgentAction,
+    trackAgentEvent,
     trackAgentActionError
   };
 };

package/dist/es2019/actions/registry.js

@@ -0,0 +1,20 @@
+/**
+ * Action Registry (Backwards Compatibility)
+ *
+ * This file contains deprecated exports for backwards compatibility
+ * with consumers using `trackAgentAction()`.
+ *
+ * For new code, use the payload types from each group file directly
+ * with `trackAgentEvent()`.
+ *
+ * @deprecated The registry pattern is deprecated. Use EventPayload from types.ts instead.
+ */
+
+export const DefaultActionSubject = 'rovoAgent';
+
+/**
+ * Combined attribute map (union of all groups).
+ * Used by the backward-compatible `trackAgentAction` helper.
+ *
+ * @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.
+ */