@atlaskit/rovo-agent-analytics 0.20.0 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @atlaskit/rovo-agent-analytics
 
+## 1.0.0
+
+### Major Changes
+
+- [`e4034958fc116`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/e4034958fc116) -
+  Adjust event tracking for agent analytics to use new trackAgentEvent() method. Remove deprecated
+  trackAgentAction() export and exported action const enums
+
 ## 0.20.0
 
 ### Minor Changes

package/README.md

@@ -6,6 +6,18 @@ Rovo Agents analytics library for composing and sending typed analytics events.
 
 ```typescript
 import { useRovoAgentActionAnalytics } from '@atlaskit/rovo-agent-analytics/actions';
+
+const { trackAgentEvent } = useRovoAgentActionAnalytics({});
+
+// Full control over event properties — all fields are type-checked
+trackAgentEvent({
+  action: 'view',
+  actionSubject: 'rovoAgent',
+  attributes: { 
+    agentId: 'agent-123',
+    touchPoint: 'browse-agent-list',
+  },
+});
 ```
 
 Detailed docs and example usage can be found
@@ -13,27 +25,27 @@ Detailed docs and example usage can be found
 
 ## Examples
 
-### Basic usage with `trackAgentAction()` (deprecated)
+### Basic Event Tracking
 
-For simple actions with default `actionSubject: 'rovoAgent'`:
+For fully-typed events with explicit `action`, `actionSubject`, and `attributes`:
 
 ```typescript
-import { useRovoAgentActionAnalytics, AgentCommonActions } from '@atlaskit/rovo-agent-analytics';
+import { useRovoAgentActionAnalytics } from '@atlaskit/rovo-agent-analytics/actions';
 
-const { trackAgentAction } = useRovoAgentActionAnalytics({
-	agentId,
-	touchPoint: 'browse-agent-list',
+const { trackAgentEvent } = useRovoAgentActionAnalytics({
+  agentId,
+  touchPoint: 'browse-agent-list',
 });
 
-// No additional attributes needed - agentId and touchPoint already provided
-trackAgentAction(AgentCommonActions.DUPLICATE, {});
+// Track a user interaction
+trackAgentEvent({
+  action: 'duplicate',
+  actionSubject: 'rovoAgent',
+  attributes: {},
+});
 ```
 
-> **Note:** `trackAgentAction()` is deprecated. Prefer `trackAgentEvent()` for new code.
-
-### Full Event Tracking with `trackAgentEvent()` (recommended)
-
-For fully-typed events with explicit `action`, `actionSubject`, and `attributes`:
+### Event Tracking with Custom Attributes
 
 ```typescript
 import { useRovoAgentActionAnalytics } from '@atlaskit/rovo-agent-analytics/actions';
@@ -52,15 +64,6 @@ trackAgentEvent({
 });
 ```
 
-### When to use `trackAgentEvent()` vs `trackAgentAction()`
-
-| Use Case | Function |
-| --- | --- |
-| New code (recommended) | `trackAgentEvent()` |
-| Events with custom `actionSubject` | `trackAgentEvent()` |
-| Events with `source`, `objectType`, `objectId`, etc. | `trackAgentEvent()` |
-| Legacy code with default `actionSubject: 'rovoAgent'` | `trackAgentAction()` (deprecated) |
-
 ## Payload Types
 
 Each group file in `src/actions/groups/` exports a **discriminated union payload type** that defines all valid event shapes for that group.
@@ -148,13 +151,25 @@ For actions that need additional attributes:
 }
 ```
 
-## Backwards Compatibility
+## Entry Points
+
+| Entry Point | Description |
+| --- | --- |
+| `@atlaskit/rovo-agent-analytics/actions` | Main entry point — exports `useRovoAgentActionAnalytics` hook |
+| `@atlaskit/rovo-agent-analytics/create` | Create agent flow analytics — exports `useRovoAgentCreateAnalytics` hook and `AgentCreateAction` type |
+
+### Create Flow Analytics
+
+The `useRovoAgentCreateAnalytics` hook is used for tracking the agent creation funnel:
 
-The following exports are **deprecated** but still available for existing consumers:
+```typescript
+import { useRovoAgentCreateAnalytics } from '@atlaskit/rovo-agent-analytics/create';
 
-- `trackAgentAction()` — use `trackAgentEvent()` instead
-- `trackAgentActionError()` — use `trackAgentEvent()` instead  
-- Enum exports (e.g. `AgentEditingActions`, `AgentEvalActions`) — use string literals instead
-- `ActionAttributes` type — use `EventPayload` instead
+const [csid, { trackCreateSession, trackCreateSessionStart }] = useRovoAgentCreateAnalytics({
+  touchPoint: 'agent-studio',
+});
 
-These will be removed in a future major version.
+// Track funnel steps using string literal actions
+trackCreateSession('createFlowStart');
+trackCreateSession('createFlowActivate', { agentType: 'custom' });
+```

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

@@ -2,54 +2,4 @@
 
 Object.defineProperty(exports, "__esModule", {
   value: true
-});
-exports.AgentInteractionActions = exports.ACTION_GROUP = void 0;
-/**
- * Action Group: agentInteractions
- *
- * User-initiated interactions with an agent — typically from the overflow menu ("...")
- * or agent profile surfaces (viewing, editing, deleting, duplicating, starring, sharing, verifying).
- *
- * NOTE: This is about UI interactions, not backend "actions" (which are being replaced by "tools").
- *
- * ## Adding a new action
- * 1. Add 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 */
-var ACTION_GROUP = exports.ACTION_GROUP = 'agentInteractions';
-
-/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
-var AgentInteractionActions = exports.AgentInteractionActions = /*#__PURE__*/function (AgentInteractionActions) {
-  /* View agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97125 */
-  AgentInteractionActions["VIEW"] = "view";
-  /* Edit agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97126 */
-  AgentInteractionActions["EDIT"] = "edit";
-  /* Copy link clicked - https://data-portal.internal.atlassian.com/analytics/registry/97128 */
-  AgentInteractionActions["COPY_LINK"] = "copyLink";
-  /* Delete agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97129 */
-  AgentInteractionActions["DELETE"] = "delete";
-  /* Duplicate agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97130 */
-  AgentInteractionActions["DUPLICATE"] = "duplicate";
-  /* Star agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97133 */
-  AgentInteractionActions["STAR"] = "star";
-  /* Chat with agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97095 */
-  AgentInteractionActions["CHAT"] = "chat";
-  /* Verify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97134 */
-  AgentInteractionActions["VERIFY"] = "verify";
-  /* Unverify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97135 */
-  AgentInteractionActions["UNVERIFY"] = "unverify";
-  return AgentInteractionActions;
-}({});
-/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
+});

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

@@ -1,42 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.AgentDebugActions = exports.ACTION_GROUP = void 0;
-/**
- * Action Group: debug
- *
- * Actions related to the agent debug modal (viewing, copying debug data, toggling skill info).
- *
- * ## Adding a new action
- * 1. Add 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 */
-var ACTION_GROUP = exports.ACTION_GROUP = 'debug';
-
-/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
-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;
-}({});
-/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
+"use strict";

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

@@ -2,31 +2,4 @@
 
 Object.defineProperty(exports, "__esModule", {
   value: true
-});
-exports.AgentEditingActions = exports.ACTION_GROUP = void 0;
-/**
- * Action Group: editing
- *
- * Agent editing/mutation events — fired when an agent's configuration is saved or modified.
- * Unlike agentInteractions (user clicks), these track actual data changes.
- *
- * ## Adding a new action
- * 1. Add 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 */
-var ACTION_GROUP = exports.ACTION_GROUP = 'editing';
-
-/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */
-var AgentEditingActions = exports.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/cjs/actions/groups/tools.js

@@ -2,39 +2,4 @@
 
 Object.defineProperty(exports, "__esModule", {
   value: true
-});
-exports.AgentToolActions = exports.ACTION_GROUP = void 0;
-/**
- * Action Group: tools
- *
- * Actions related to agent tool execution during chat
- * (confirming, streaming, viewing results, errors).
- *
- * ## Adding a new action
- * 1. Add 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 */
-var ACTION_GROUP = exports.ACTION_GROUP = 'tools';
-
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-var AgentToolActions = exports.AgentToolActions = /*#__PURE__*/function (AgentToolActions) {
-  /* When chatting with an agent, and tools confirmation being shown, then user click proceed with the possible actions (e.g. confirm, dismiss etc) https://data-portal.internal.atlassian.com/analytics/registry/97675 */
-  AgentToolActions["TOOLS_EXECUTION_CONFIRMED"] = "toolsExecutionConfirmed";
-  /* 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;
-}({});
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
+});

package/dist/cjs/actions/index.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.useRovoAgentActionAnalytics = exports.AgentDebugActions = exports.AgentCommonActions = void 0;
+exports.useRovoAgentActionAnalytics = void 0;
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _react = require("react");
@@ -12,19 +12,9 @@ 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; }
-// 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);
@@ -41,20 +31,6 @@ var useRovoAgentActionAnalytics = exports.useRovoAgentActionAnalytics = function
   }, [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: _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.
@@ -71,24 +47,7 @@ var useRovoAgentActionAnalytics = exports.useRovoAgentActionAnalytics = function
       attributes: attributes
     }));
   }, [fireAnalyticsEvent]);
-
-  /**
-   * @deprecated Use trackAgentEvent() with typed payloads instead
-   */
-  var trackAgentActionError = (0, _react.useCallback)(function (action, error, attributes) {
-    fireAnalyticsEvent({
-      actionSubject: 'rovoAgentError',
-      action: action,
-      attributes: _objectSpread(_objectSpread({}, attributes), {}, {
-        error: {
-          message: error.message
-        }
-      })
-    });
-  }, [fireAnalyticsEvent]);
   return {
-    trackAgentAction: trackAgentAction,
-    trackAgentEvent: trackAgentEvent,
-    trackAgentActionError: trackAgentActionError
+    trackAgentEvent: trackAgentEvent
   };
 };

package/dist/cjs/common/types.js

@@ -7,6 +7,11 @@ exports.LIBRARY_ATTRIBUTE = void 0;
 /** Common library attribute injected into all events */
 var LIBRARY_ATTRIBUTE = exports.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/cjs/create/index.js

@@ -4,22 +4,37 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.useRovoAgentCreateAnalytics = exports.AgentCreateActions = void 0;
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+exports.useRovoAgentCreateAnalytics = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 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; }
-// Backward-compatible alias
-// TODO: migrate consumers to use CreateFlowActions / AddToolsPromptActions directly, then remove
-var AgentCreateActions = exports.AgentCreateActions = _objectSpread(_objectSpread({}, _createFlow.CreateFlowActions), _addToolsPrompt.AddToolsPromptActions);
+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
+ */
+
 var globalEventConfig = (0, _utils.getDefaultTrackEventConfig)();
 var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(commonAttributes) {
   var _useRovoAgentCSID = (0, _csid.useRovoAgentCSID)(),
@@ -33,6 +48,7 @@ var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function
   var fireAnalyticsEvent = (0, _react.useCallback)(function (event) {
     var referrer = typeof window !== 'undefined' ? window.document.referrer : 'unknown';
     var attributes = _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, (0, _utils.getAttributesFromContexts)(analyticsContext.getAtlaskitAnalyticsContext())), commonAttributesRef.current), event.attributes), {}, {
+      actionGroup: 'createFlow',
       csid: csid,
       referrer: referrer
     });
@@ -48,7 +64,7 @@ var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function
    */
   var trackCreateSession = (0, _react.useCallback)(function (action, attributes) {
     fireAnalyticsEvent({
-      actionSubject: _registry.DefaultActionSubject,
+      actionSubject: DefaultActionSubject,
       action: action,
       attributes: attributes
     });
@@ -59,16 +75,16 @@ var useRovoAgentCreateAnalytics = exports.useRovoAgentCreateAnalytics = function
    */
   var trackCreateSessionStart = (0, _react.useCallback)(function (attributes) {
     fireAnalyticsEvent({
-      actionSubject: _registry.DefaultActionSubject,
-      action: _createFlow.CreateFlowActions.START,
+      actionSubject: DefaultActionSubject,
+      action: 'createFlowStart',
       attributes: attributes
     });
     refreshCSID();
   }, [fireAnalyticsEvent, refreshCSID]);
   var trackCreateSessionError = (0, _react.useCallback)(function (error, attributes) {
     fireAnalyticsEvent({
-      actionSubject: _registry.DefaultActionSubject,
-      action: _createFlow.CreateFlowActions.ERROR,
+      actionSubject: DefaultActionSubject,
+      action: 'createFlowError',
       attributes: _objectSpread({
         error: {
           message: error.message

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

@@ -1,50 +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 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 */
+export {};

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

@@ -1,37 +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 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

@@ -1,27 +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 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 */
+export {};

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

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