@atlaskit/rovo-agent-analytics 0.18.0 → 0.20.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @atlaskit/rovo-agent-analytics
 
+## 0.20.0
+
+### Minor Changes
+
+- [`30edbd0d978ea`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/30edbd0d978ea) -
+  Deprecate trackAgentAction() and enums exports, introduce trackAgentEvent()
+
+## 0.19.0
+
+### Minor Changes
+
+- [`2ccb8729cef96`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/2ccb8729cef96) -
+  Reorg agent action enums to different files, add the actionGroup to the analytics
+
 ## 0.18.0
 
 ### Minor Changes

package/README.md

@@ -1,17 +1,21 @@
 # RovoAgentAnalytics
 
-Rovo Agents analytics
+Rovo Agents analytics library for composing and sending typed analytics events.
 
 ## Usage
 
-`import RovoAgentAnalytics from '@atlaskit/rovo-agent-analytics';`
+```typescript
+import { useRovoAgentActionAnalytics } from '@atlaskit/rovo-agent-analytics/actions';
+```
 
 Detailed docs and example usage can be found
 [here](https://atlaskit.atlassian.com/packages/ai-mate/rovo-agent-analytics).
 
 ## Examples
 
-### Basic usage with common attributes
+### Basic usage with `trackAgentAction()` (deprecated)
+
+For simple actions with default `actionSubject: 'rovoAgent'`:
 
 ```typescript
 import { useRovoAgentActionAnalytics, AgentCommonActions } from '@atlaskit/rovo-agent-analytics';
@@ -25,91 +29,132 @@ const { trackAgentAction } = useRovoAgentActionAnalytics({
 trackAgentAction(AgentCommonActions.DUPLICATE, {});
 ```
 
-### Usage with debug actions (no attributes required)
+> **Note:** `trackAgentAction()` is deprecated. Prefer `trackAgentEvent()` for new code.
 
-```typescript
-import { useRovoAgentActionAnalytics, AgentDebugActions } from '@atlaskit/rovo-agent-analytics';
+### Full Event Tracking with `trackAgentEvent()` (recommended)
 
-const { trackAgentAction } = useRovoAgentActionAnalytics({});
+For fully-typed events with explicit `action`, `actionSubject`, and `attributes`:
 
-// Debug actions don't require any attributes
-trackAgentAction(AgentDebugActions.VIEW, {});
-trackAgentAction(AgentDebugActions.COPY, {});
+```typescript
+import { useRovoAgentActionAnalytics } from '@atlaskit/rovo-agent-analytics/actions';
+
+const { trackAgentEvent } = useRovoAgentActionAnalytics({});
+
+// Full control over event properties — all fields are type-checked
+trackAgentEvent({
+  action: 'created',
+  actionSubject: 'batchEvaluationDataset',
+  attributes: { 
+    totalQuestions: 5 
+  },
+  objectType: 'batchEvaluationDataset',
+  objectId: 'dataset-123',
+});
 ```
 
-## Adding New Actions
+### When to use `trackAgentEvent()` vs `trackAgentAction()`
 
-### Step 1: Add the action to the appropriate enum
+| 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) |
 
-Add your new action to either `AgentCommonActions` or `AgentDebugActions` in
-`src/actions/index.tsx`:
+## Payload Types
 
-```typescript
-export enum AgentCommonActions {
-	// ... existing actions
-	/* My new action - https://data-portal.internal.atlassian.com/analytics/registry/XXXXX */
-	MY_NEW_ACTION = 'myNewAction',
-}
-```
+Each group file in `src/actions/groups/` exports a **discriminated union payload type** that defines all valid event shapes for that group.
+
+| File | Payload Type | Description |
+| --- | --- | --- |
+| `agent-interactions.ts` | `AgentInteractionsEventPayload` | User-initiated interactions (view, edit, delete, duplicate, star, chat, verify…) |
+| `editing.ts` | `EditingEventPayload` | Agent save/mutation events (updated) |
+| `debug.ts` | `DebugEventPayload` | Debug modal actions (view, copy, toggle skill info) |
+| `tools.ts` | `ToolsEventPayload` | Tool execution actions (confirm, stream stop, result viewed, error) |
+| `evaluation.ts` | `EvaluationEventPayload` | Batch evaluation events (dataset CRUD, job lifecycle, results viewed) |
+| `create-flow.ts` | `CreateFlowEventPayload` | Create agent funnel steps |
+| `add-tools-prompt.ts` | `AddToolsPromptEventPayload` | Add tools prompt modal events |
+
+The combined `EventPayload` type (exported from `types.ts`) is a union of all these payload types.
+
+## Adding a New Action
 
-### Step 2: Define attributes for the action
+### To an existing payload type
 
-Add an entry to `ActionAttributes` to specify which attributes this action requires:
+1. Open the group file (e.g. `src/actions/groups/agent-interactions.ts`)
+2. Add a new variant to the payload union type with a data-portal registry link:
 
 ```typescript
-type ActionAttributes = {
-	// ... existing actions
-	[AgentCommonActions.MY_NEW_ACTION]: CommonAnalyticsAttributes;
-};
+export type AgentInteractionsEventPayload =
+  | {
+      // https://data-portal.internal.atlassian.com/analytics/registry/XXXXX
+      actionSubject: 'rovoAgent';
+      action: 'myNewAction';
+      attributes: BaseAgentAnalyticsAttributes & {
+        myCustomField: string;
+      };
+    }
+  | // ... existing variants
 ```
 
-## Defining Custom Attributes Per Action
+That's it — TypeScript will enforce the correct shape when calling `trackAgentEvent()`.
 
-Each action can have its own specific attributes. The `trackAgentAction` function is generic and
-will enforce the correct attributes based on the action you pass.
+### To a new group
 
-### Using CommonAnalyticsAttributes
+If your action doesn't fit any existing group, create a new one:
 
-For actions that only need `touchPoint` and `agentId`:
+1. Create a new file in `src/actions/groups/` following the existing template
+2. Export a discriminated union payload type (e.g. `MyFeatureEventPayload`)
+3. Add the new type to the `EventPayload` union in `src/common/types.ts`:
 
 ```typescript
-type ActionAttributes = {
-	[AgentCommonActions.VIEW]: CommonAnalyticsAttributes;
-};
+import type { MyFeatureEventPayload } from '../actions/groups/my-feature';
+
+export type EventPayload =
+  | EditingEventPayload
+  | AgentInteractionsEventPayload
+  // ... existing types
+  | MyFeatureEventPayload;
 ```
 
-### Using Custom Attributes
+## Defining Custom Attributes
 
-For actions that need additional attributes beyond the common ones:
+Each action variant in a payload type can have its own specific attributes:
 
-```typescript
-type ActionAttributes = {
-	[AgentCommonActions.STAR]: CommonAnalyticsAttributes & { isStarred: boolean };
-};
-```
+### Using BaseAgentAnalyticsAttributes
 
-When calling `trackAgentAction`, TypeScript will enforce the custom attributes:
+For actions that need `touchPoint` and `agentId`:
 
 ```typescript
-// TypeScript will require isStarred to be provided
-trackAgentAction(AgentCommonActions.STAR, { isStarred: true });
+{
+  actionSubject: 'rovoAgent';
+  action: 'view';
+  attributes: BaseAgentAnalyticsAttributes;
+}
 ```
 
-### How Type Inference Works
+### Using Custom Attributes
+
+For actions that need additional attributes:
 
-The `trackAgentAction` function uses generics to infer required attributes:
+```typescript
+{
+  actionSubject: 'rovoAgent';
+  action: 'updated';
+  attributes: BaseAgentAnalyticsAttributes & { 
+    agentType: string; 
+    field: string; 
+  };
+}
+```
 
-1. When you call `trackAgentAction(action, attributes)`, TypeScript infers the action type
-2. It looks up `ActionAttributes[action]` to get the required attributes for that action
-3. It subtracts any attributes already provided in `commonAttributes` (via `RemainingRequired`)
-4. The remaining attributes must be provided in the `attributes` parameter
+## Backwards Compatibility
 
-Example:
+The following exports are **deprecated** but still available for existing consumers:
 
-```typescript
-// If commonAttributes already includes agentId
-const { trackAgentAction } = useRovoAgentActionAnalytics({ agentId: '123' });
+- `trackAgentAction()` — use `trackAgentEvent()` instead
+- `trackAgentActionError()` — use `trackAgentEvent()` instead  
+- Enum exports (e.g. `AgentEditingActions`, `AgentEvalActions`) — use string literals instead
+- `ActionAttributes` type — use `EventPayload` instead
 
-// Only touchPoint is required since agentId was already provided
-trackAgentAction(AgentCommonActions.VIEW, { touchPoint: 'my-touchpoint' });
-```
+These will be removed in a future major version.

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

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

package/actions/agent-interactions/package.json

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

package/actions/create-flow/package.json

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

package/actions/debug/package.json

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

package/actions/editing/package.json

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

package/actions/evaluation/package.json

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

package/actions/tool-actions/package.json

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

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

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AddToolsPromptActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: addToolsPrompt
+ *
+ * Add tools prompt modal — shown when a user tries to activate/publish an agent that has no tools.
+ * The user can browse tools or dismiss and proceed without them.
+ *
+ * This group is intentionally flow-agnostic so the action values stay stable
+ * regardless of whether the prompt fires from the create flow or a future publish flow.
+ *
+ * ## Adding a new action
+ * 1. Add 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 */
+var ACTION_GROUP = exports.ACTION_GROUP = 'addToolsPrompt';
+
+/** @deprecated Use AddToolsPromptEventPayload with trackAgentEvent() instead */
+var AddToolsPromptActions = exports.AddToolsPromptActions = /*#__PURE__*/function (AddToolsPromptActions) {
+  /* Add tools prompt shown (agent has no tools) - https://data-portal.internal.atlassian.com/analytics/registry/98106 */
+  AddToolsPromptActions["SHOWN"] = "addToolsPromptShown";
+  /* User clicked "Browse skills" on the add tools prompt - https://data-portal.internal.atlassian.com/analytics/registry/98107 */
+  AddToolsPromptActions["BROWSE"] = "addToolsPromptBrowse";
+  /* User dismissed the add tools prompt ("No thanks") and proceeded anyway - https://data-portal.internal.atlassian.com/analytics/registry/98108 */
+  AddToolsPromptActions["DISMISS"] = "addToolsPromptDismiss";
+  return AddToolsPromptActions;
+}({});

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

@@ -0,0 +1,55 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AgentInteractionActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: agentInteractions
+ *
+ * User-initiated interactions with an agent — typically from the overflow menu ("...")
+ * or agent profile surfaces (viewing, editing, deleting, duplicating, starring, sharing, verifying).
+ *
+ * NOTE: This is about UI interactions, not backend "actions" (which are being replaced by "tools").
+ *
+ * ## Adding a new action
+ * 1. Add 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/create-flow.js

@@ -0,0 +1,51 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CreateFlowActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: createFlow
+ *
+ * Create agent funnel steps — from clicking "Create agent" through to activation or discard,
+ *
+ * ## Adding a new action
+ * 1. Add 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 */
+var ACTION_GROUP = exports.ACTION_GROUP = 'createFlow';
+
+/** @deprecated Use CreateFlowEventPayload with trackAgentEvent() instead */
+var CreateFlowActions = exports.CreateFlowActions = /*#__PURE__*/function (CreateFlowActions) {
+  /* Start create flow when user clicks on "Create agent" button - https://data-portal.internal.atlassian.com/analytics/registry/97089 */
+  CreateFlowActions["START"] = "createFlowStart";
+  /* Skip natural language - https://data-portal.internal.atlassian.com/analytics/registry/97127 */
+  CreateFlowActions["SKIP_NL"] = "createFlowSkipNL";
+  /* Review natural language - https://data-portal.internal.atlassian.com/analytics/registry/97124 */
+  CreateFlowActions["REVIEW_NL"] = "createFlowReviewNL";
+  /* Activate agent - https://data-portal.internal.atlassian.com/analytics/registry/97123 */
+  CreateFlowActions["ACTIVATE"] = "createFlowActivate";
+  /* Restart create flow - https://data-portal.internal.atlassian.com/analytics/registry/97131 */
+  CreateFlowActions["RESTART"] = "createFlowRestart";
+  /* Error occurred - https://data-portal.internal.atlassian.com/analytics/registry/97132 */
+  CreateFlowActions["ERROR"] = "createFlowError";
+  /* Land in studio - https://data-portal.internal.atlassian.com/analytics/registry/97136 */
+  CreateFlowActions["LAND"] = "createLandInStudio";
+  /* Discard agent - https://data-portal.internal.atlassian.com/analytics/registry/97137 */
+  CreateFlowActions["DISCARD"] = "createDiscard";
+  /* Draft created from solution architect plan card - https://data-portal.internal.atlassian.com/analytics/registry/97924 */
+  CreateFlowActions["SA_DRAFT"] = "saDraft";
+  return CreateFlowActions;
+}({});

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

@@ -0,0 +1,42 @@
+"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 */

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

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AgentEditingActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: editing
+ *
+ * Agent editing/mutation events — fired when an agent's configuration is saved or modified.
+ * Unlike agentInteractions (user clicks), these track actual data changes.
+ *
+ * ## Adding a new action
+ * 1. Add 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/evaluation.js

@@ -0,0 +1 @@
+"use strict";

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

@@ -3,7 +3,27 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.AgentToolActions = void 0;
+exports.AgentToolActions = exports.ACTION_GROUP = void 0;
+/**
+ * Action Group: tools
+ *
+ * Actions related to agent tool execution during chat
+ * (confirming, streaming, viewing results, errors).
+ *
+ * ## Adding a new action
+ * 1. Add 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";
@@ -14,4 +34,7 @@ var AgentToolActions = exports.AgentToolActions = /*#__PURE__*/function (AgentTo
   /* 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 */