@atlaskit/rovo-agent-analytics 0.18.0 → 0.19.0

package/dist/esm/actions/index.js

@@ -5,40 +5,17 @@ import { useCallback, useContext, useRef } from 'react';
 import { AnalyticsReactContext, useAnalyticsEvents } from '@atlaskit/analytics-next';
 import { ANALYTICS_CHANNEL } from '../common/constants';
 import { getAttributesFromContexts, getDefaultTrackEventConfig } from '../common/utils';
-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;
-}({});
-export var 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 { 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);
@@ -56,7 +33,9 @@ export var useRovoAgentActionAnalytics = function useRovoAgentActionAnalytics(co
     fireAnalyticsEvent({
       actionSubject: 'rovoAgent',
       action: action,
-      attributes: attributes
+      attributes: _objectSpread(_objectSpread({}, attributes), {}, {
+        actionGroup: ACTION_TO_GROUP[action]
+      })
     });
   }, [fireAnalyticsEvent]);
   var trackAgentActionError = useCallback(function (action, error, attributes) {
@@ -64,6 +43,7 @@ export var useRovoAgentActionAnalytics = function useRovoAgentActionAnalytics(co
       actionSubject: 'rovoAgentError',
       action: action,
       attributes: _objectSpread(_objectSpread({}, attributes), {}, {
+        actionGroup: ACTION_TO_GROUP[action],
         error: {
           message: error.message
         }

package/dist/esm/actions/registry.js

@@ -0,0 +1,48 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+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; }
+/**
+ * Action Registry
+ *
+ * Single source of truth for ALL action groups across the library.
+ * This file composes all groups into a type-safe registry and builds the
+ * runtime mapping from action values to their group names, which gets
+ * automatically attached as `attributes.actionGroup` in every fired event.
+ *
+ * Both `useRovoAgentActionAnalytics` and `useRovoAgentCreateAnalytics` hooks
+ * use `ACTION_TO_GROUP` from this registry.
+ *
+ * ## Adding a new action group
+ * 1. Create a new file in ./groups/ following the template of existing group files
+ * 2. Import the group's ACTION_GROUP, action enum, and attribute type below
+ * 3. If the group is used by the actions hook, add the attribute type to `ActionAttributes`
+ * 4. Add the enum + group to `ACTION_TO_GROUP` using `mapActionsToGroup`
+ */
+import { AddToolsPromptActions, ACTION_GROUP as ADD_TOOLS_PROMPT_GROUP } from './groups/add-tools-prompt';
+import { AgentInteractionActions, ACTION_GROUP as AGENT_INTERACTIONS_GROUP } from './groups/agent-interactions';
+import { CreateFlowActions, ACTION_GROUP as CREATE_FLOW_GROUP } from './groups/create-flow';
+import { AgentDebugActions, ACTION_GROUP as DEBUG_GROUP } from './groups/debug';
+import { AgentEditingActions, ACTION_GROUP as EDITING_GROUP } from './groups/editing';
+import { AgentToolActions, ACTION_GROUP as TOOLS_GROUP } from './groups/tools';
+
+/**
+ * Combined attribute map for action-hook groups (type-safe attributes).
+ * Create-flow groups are excluded — they use a looser attribute type via the create hook.
+ */
+
+/**
+ * Helper to build a Record mapping each enum value to its group name.
+ */
+var mapActionsToGroup = function mapActionsToGroup(actionEnum, group) {
+  return Object.fromEntries(Object.values(actionEnum).map(function (action) {
+    return [action, group];
+  }));
+};
+
+/**
+ * Runtime lookup: action value → group name.
+ * Used by ALL analytics hooks to auto-inject `attributes.actionGroup`.
+ *
+ * When you add a new group, add it here too.
+ */
+export var ACTION_TO_GROUP = _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, mapActionsToGroup(AgentInteractionActions, AGENT_INTERACTIONS_GROUP)), mapActionsToGroup(AgentEditingActions, EDITING_GROUP)), mapActionsToGroup(AgentDebugActions, DEBUG_GROUP)), mapActionsToGroup(AgentToolActions, TOOLS_GROUP)), mapActionsToGroup(CreateFlowActions, CREATE_FLOW_GROUP)), mapActionsToGroup(AddToolsPromptActions, ADD_TOOLS_PROMPT_GROUP));

package/dist/esm/create/index.js

@@ -1,39 +1,19 @@
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
 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';
-export var 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
+export var AgentCreateActions = _objectSpread(_objectSpread({}, CreateFlowActions), AddToolsPromptActions);
 var globalEventConfig = getDefaultTrackEventConfig();
 export var useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(commonAttributes) {
   var _useRovoAgentCSID = useRovoAgentCSID(),
@@ -46,7 +26,9 @@ 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],
       csid: csid,
       referrer: referrer
     });
@@ -74,7 +56,7 @@ export var useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(co
   var trackCreateSessionStart = useCallback(function (attributes) {
     fireAnalyticsEvent({
       actionSubject: 'rovoAgent',
-      action: AgentCreateActions.START,
+      action: CreateFlowActions.START,
       attributes: attributes
     });
     refreshCSID();
@@ -82,7 +64,7 @@ export var useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(co
   var trackCreateSessionError = useCallback(function (error, attributes) {
     fireAnalyticsEvent({
       actionSubject: 'rovoAgent',
-      action: AgentCreateActions.ERROR,
+      action: CreateFlowActions.ERROR,
       attributes: _objectSpread({
         error: {
           message: error.message

package/dist/types/actions/groups/add-tools-prompt.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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 the action to the `AddToolsPromptActions` enum below with a data-portal link
+ * 2. Register this group in ../registry.ts (if this is a new group file)
+ *
+ */
+/** The group name sent as `attributes.actionGroup` in analytics events */
+export declare const ACTION_GROUP: "addToolsPrompt";
+export declare enum AddToolsPromptActions {
+    SHOWN = "addToolsPromptShown",
+    BROWSE = "addToolsPromptBrowse",
+    DISMISS = "addToolsPromptDismiss"
+}

package/dist/types/actions/groups/agent-interactions.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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)
+ */
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+/** The group name sent as `attributes.actionGroup` in analytics events */
+export declare const ACTION_GROUP: "agentInteractions";
+export declare enum AgentInteractionActions {
+    VIEW = "view",
+    EDIT = "edit",
+    COPY_LINK = "copyLink",
+    DELETE = "delete",
+    DUPLICATE = "duplicate",
+    STAR = "star",
+    CHAT = "chat",
+    VERIFY = "verify",
+    UNVERIFY = "unverify"
+}
+export type AgentInteractionAttributes = {
+    [AgentInteractionActions.VIEW]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.EDIT]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.COPY_LINK]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.DELETE]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.DUPLICATE]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.STAR]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.CHAT]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.VERIFY]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.UNVERIFY]: BaseAgentAnalyticsAttributes;
+};

package/dist/types/actions/groups/create-flow.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Action Group: createFlow
+ *
+ * Create agent funnel steps — from clicking "Create agent" through to activation or discard,
+ *
+ * ## Adding a new action
+ * 1. Add the action to the `CreateFlowActions` enum below with a data-portal link
+ * 2. Register this group in ../registry.ts (if this is a new group file)
+ */
+/** The group name sent as `attributes.actionGroup` in analytics events */
+export declare const ACTION_GROUP: "createFlow";
+export declare enum CreateFlowActions {
+    START = "createFlowStart",
+    SKIP_NL = "createFlowSkipNL",
+    REVIEW_NL = "createFlowReviewNL",
+    ACTIVATE = "createFlowActivate",
+    RESTART = "createFlowRestart",
+    ERROR = "createFlowError",
+    LAND = "createLandInStudio",
+    DISCARD = "createDiscard",
+    SA_DRAFT = "saDraft"
+}

package/dist/types/actions/groups/debug.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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 declare const ACTION_GROUP: "debug";
+export declare enum AgentDebugActions {
+    VIEW = "debugView",
+    COPY_ALL = "debugCopyAll",
+    COPY = "debugCopy",
+    TOGGLE_SKILL_INFO = "debugToggleSkillInfo"
+}
+type EmptyAttributes = {};
+export type DebugActionAttributes = {
+    [AgentDebugActions.COPY_ALL]: EmptyAttributes;
+    [AgentDebugActions.COPY]: EmptyAttributes;
+    [AgentDebugActions.TOGGLE_SKILL_INFO]: {
+        toolId: string;
+        isExpanded: boolean;
+    };
+    [AgentDebugActions.VIEW]: EmptyAttributes;
+};
+export {};

package/dist/types/actions/groups/editing.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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)
+ */
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+/** The group name sent as `attributes.actionGroup` in analytics events */
+export declare const ACTION_GROUP: "editing";
+export declare enum AgentEditingActions {
+    UPDATED = "updated"
+}
+export type EditingActionAttributes = {
+    [AgentEditingActions.UPDATED]: BaseAgentAnalyticsAttributes & {
+        agentType: string;
+        field: string;
+    };
+};

package/dist/types/actions/groups/tools.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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)
+ */
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+/** The group name sent as `attributes.actionGroup` in analytics events */
+export declare const ACTION_GROUP: "tools";
+export declare enum AgentToolActions {
+    TOOLS_EXECUTION_CONFIRMED = "toolsExecutionConfirmed",
+    TOOLS_EXECUTION_STREAM_STOPPED = "toolsExecutionStreamStopped",
+    TOOLS_EXECUTION_RESULT_VIEWED = "toolsExecutionResultViewed",
+    TOOLS_EXECUTION_RESULT_ERROR = "toolsExecutionResultError"
+}
+export type ToolsExecutionAttributes = BaseAgentAnalyticsAttributes & {
+    tools: {
+        toolId: string;
+        toolSource: string;
+        resolutionType: string;
+    }[];
+    singleInstrumentationId: string | undefined;
+};
+export type ToolsExecutionResultAttributes = ToolsExecutionAttributes & {
+    scenarioId: string | null | undefined;
+};
+export type ToolsActionAttributes = {
+    [AgentToolActions.TOOLS_EXECUTION_CONFIRMED]: ToolsExecutionAttributes;
+    [AgentToolActions.TOOLS_EXECUTION_STREAM_STOPPED]: ToolsExecutionAttributes;
+    [AgentToolActions.TOOLS_EXECUTION_RESULT_VIEWED]: ToolsExecutionResultAttributes;
+    [AgentToolActions.TOOLS_EXECUTION_RESULT_ERROR]: ToolsExecutionAttributes;
+};

package/dist/types/actions/index.d.ts

@@ -1,52 +1,22 @@
-import type { BaseAgentAnalyticsAttributes, RemainingRequired } from '../common/types';
-import type { AgentToolActions, ToolsExecutionAttributes, ToolsExecutionResultAttributes } from './tool-actions';
-export declare enum AgentDebugActions {
-    VIEW = "debugView",
-    COPY_ALL = "debugCopyAll",
-    COPY = "debugCopy",
-    TOGGLE_SKILL_INFO = "debugToggleSkillInfo"
-}
-export declare enum AgentCommonActions {
-    VIEW = "view",
-    EDIT = "edit",
-    UPDATED = "updated",
-    COPY_LINK = "copyLink",
-    DELETE = "delete",
-    DUPLICATE = "duplicate",
-    STAR = "star",
-    CHAT = "chat",
-    VERIFY = "verify",
-    UNVERIFY = "unverify"
-}
-type EmptyAttributes = {};
-type ActionAttributes = {
-    [AgentCommonActions.VIEW]: BaseAgentAnalyticsAttributes;
-    [AgentCommonActions.EDIT]: BaseAgentAnalyticsAttributes;
-    [AgentCommonActions.UPDATED]: BaseAgentAnalyticsAttributes & {
-        agentType: string;
-        field: string;
-    };
-    [AgentCommonActions.COPY_LINK]: BaseAgentAnalyticsAttributes;
-    [AgentCommonActions.DELETE]: BaseAgentAnalyticsAttributes;
-    [AgentCommonActions.DUPLICATE]: BaseAgentAnalyticsAttributes;
-    [AgentCommonActions.STAR]: BaseAgentAnalyticsAttributes;
-    [AgentCommonActions.CHAT]: BaseAgentAnalyticsAttributes;
-    [AgentCommonActions.VERIFY]: BaseAgentAnalyticsAttributes;
-    [AgentCommonActions.UNVERIFY]: BaseAgentAnalyticsAttributes;
-    [AgentDebugActions.COPY_ALL]: EmptyAttributes;
-    [AgentDebugActions.COPY]: EmptyAttributes;
-    [AgentDebugActions.TOGGLE_SKILL_INFO]: {
-        toolId: string;
-        isExpanded: boolean;
-    };
-    [AgentDebugActions.VIEW]: EmptyAttributes;
-    [AgentToolActions.TOOLS_EXECUTION_CONFIRMED]: ToolsExecutionAttributes;
-    [AgentToolActions.TOOLS_EXECUTION_STREAM_STOPPED]: ToolsExecutionAttributes;
-    [AgentToolActions.TOOLS_EXECUTION_RESULT_VIEWED]: ToolsExecutionResultAttributes;
-    [AgentToolActions.TOOLS_EXECUTION_RESULT_ERROR]: ToolsExecutionAttributes;
+import type { RemainingRequired } from '../common/types';
+import { AgentInteractionActions } from './groups/agent-interactions';
+import { AgentDebugActions as AgentDebugActionsEnum } from './groups/debug';
+import { AgentEditingActions } from './groups/editing';
+import type { ActionAttributes } from './registry';
+export declare const AgentCommonActions: {
+    readonly UPDATED: AgentEditingActions.UPDATED;
+    readonly VIEW: AgentInteractionActions.VIEW;
+    readonly EDIT: AgentInteractionActions.EDIT;
+    readonly COPY_LINK: AgentInteractionActions.COPY_LINK;
+    readonly DELETE: AgentInteractionActions.DELETE;
+    readonly DUPLICATE: AgentInteractionActions.DUPLICATE;
+    readonly STAR: AgentInteractionActions.STAR;
+    readonly CHAT: AgentInteractionActions.CHAT;
+    readonly VERIFY: AgentInteractionActions.VERIFY;
+    readonly UNVERIFY: AgentInteractionActions.UNVERIFY;
 };
+export declare const AgentDebugActions: typeof AgentDebugActionsEnum;
 export declare const useRovoAgentActionAnalytics: <T extends {}>(commonAttributes: T) => {
     trackAgentAction: <A extends keyof ActionAttributes>(action: A, attributes: RemainingRequired<ActionAttributes[A], T>) => void;
     trackAgentActionError: <A extends keyof ActionAttributes>(action: A, error: Error, attributes?: RemainingRequired<ActionAttributes[A], T>) => void;
 };
-export {};

package/dist/types/actions/registry.d.ts

@@ -0,0 +1,16 @@
+import { type AgentInteractionAttributes } from './groups/agent-interactions';
+import { type DebugActionAttributes } from './groups/debug';
+import { type EditingActionAttributes } from './groups/editing';
+import { type ToolsActionAttributes } from './groups/tools';
+/**
+ * Combined attribute map for action-hook groups (type-safe attributes).
+ * Create-flow groups are excluded — they use a looser attribute type via the create hook.
+ */
+export type ActionAttributes = AgentInteractionAttributes & EditingActionAttributes & DebugActionAttributes & ToolsActionAttributes;
+/**
+ * Runtime lookup: action value → group name.
+ * Used by ALL analytics hooks to auto-inject `attributes.actionGroup`.
+ *
+ * When you add a new group, add it here too.
+ */
+export declare const ACTION_TO_GROUP: Record<string, string>;

package/dist/types/create/index.d.ts

@@ -1,22 +1,24 @@
+import { AddToolsPromptActions } from '../actions/groups/add-tools-prompt';
+import { CreateFlowActions } from '../actions/groups/create-flow';
+export declare const AgentCreateActions: {
+    readonly SHOWN: AddToolsPromptActions.SHOWN;
+    readonly BROWSE: AddToolsPromptActions.BROWSE;
+    readonly DISMISS: AddToolsPromptActions.DISMISS;
+    readonly START: CreateFlowActions.START;
+    readonly SKIP_NL: CreateFlowActions.SKIP_NL;
+    readonly REVIEW_NL: CreateFlowActions.REVIEW_NL;
+    readonly ACTIVATE: CreateFlowActions.ACTIVATE;
+    readonly RESTART: CreateFlowActions.RESTART;
+    readonly ERROR: CreateFlowActions.ERROR;
+    readonly LAND: CreateFlowActions.LAND;
+    readonly DISCARD: CreateFlowActions.DISCARD;
+    readonly SA_DRAFT: CreateFlowActions.SA_DRAFT;
+};
 type CommonAnalyticsAttributes = {
     touchPoint?: string;
 } & Record<string, any>;
-export declare enum AgentCreateActions {
-    START = "createFlowStart",
-    SKIP_NL = "createFlowSkipNL",
-    REVIEW_NL = "createFlowReviewNL",
-    ACTIVATE = "createFlowActivate",
-    RESTART = "createFlowRestart",
-    ERROR = "createFlowError",
-    LAND = "createLandInStudio",
-    DISCARD = "createDiscard",
-    SHOW_NO_SKILLS_MODAL = "showNoSkillsModal",
-    BROWSE_CLICK_NO_SKILLS_MODAL = "browseClickNoSkillsModal",
-    DISCARD_NO_SKILLS_MODAL = "discardNoSkillsModal",
-    SA_DRAFT = "saDraft"
-}
 export declare const useRovoAgentCreateAnalytics: (commonAttributes: CommonAnalyticsAttributes) => readonly [string | null, {
-    readonly trackCreateSession: (action: Omit<AgentCreateActions, AgentCreateActions.START>, attributes?: CommonAnalyticsAttributes) => void;
+    readonly trackCreateSession: (action: (typeof AgentCreateActions)[keyof typeof AgentCreateActions], attributes?: CommonAnalyticsAttributes) => void;
     readonly trackCreateSessionStart: (attributes?: CommonAnalyticsAttributes) => void;
     readonly trackCreateSessionError: (error: Error, attributes?: CommonAnalyticsAttributes) => void;
     readonly refreshCSID: () => `${string}-${string}-${string}-${string}-${string}`;

package/dist/types-ts4.5/actions/groups/add-tools-prompt.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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 the action to the `AddToolsPromptActions` enum below with a data-portal link
+ * 2. Register this group in ../registry.ts (if this is a new group file)
+ *
+ */
+/** The group name sent as `attributes.actionGroup` in analytics events */
+export declare const ACTION_GROUP: "addToolsPrompt";
+export declare enum AddToolsPromptActions {
+    SHOWN = "addToolsPromptShown",
+    BROWSE = "addToolsPromptBrowse",
+    DISMISS = "addToolsPromptDismiss"
+}

package/dist/types-ts4.5/actions/groups/agent-interactions.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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)
+ */
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+/** The group name sent as `attributes.actionGroup` in analytics events */
+export declare const ACTION_GROUP: "agentInteractions";
+export declare enum AgentInteractionActions {
+    VIEW = "view",
+    EDIT = "edit",
+    COPY_LINK = "copyLink",
+    DELETE = "delete",
+    DUPLICATE = "duplicate",
+    STAR = "star",
+    CHAT = "chat",
+    VERIFY = "verify",
+    UNVERIFY = "unverify"
+}
+export type AgentInteractionAttributes = {
+    [AgentInteractionActions.VIEW]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.EDIT]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.COPY_LINK]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.DELETE]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.DUPLICATE]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.STAR]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.CHAT]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.VERIFY]: BaseAgentAnalyticsAttributes;
+    [AgentInteractionActions.UNVERIFY]: BaseAgentAnalyticsAttributes;
+};

package/dist/types-ts4.5/actions/groups/create-flow.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Action Group: createFlow
+ *
+ * Create agent funnel steps — from clicking "Create agent" through to activation or discard,
+ *
+ * ## Adding a new action
+ * 1. Add the action to the `CreateFlowActions` enum below with a data-portal link
+ * 2. Register this group in ../registry.ts (if this is a new group file)
+ */
+/** The group name sent as `attributes.actionGroup` in analytics events */
+export declare const ACTION_GROUP: "createFlow";
+export declare enum CreateFlowActions {
+    START = "createFlowStart",
+    SKIP_NL = "createFlowSkipNL",
+    REVIEW_NL = "createFlowReviewNL",
+    ACTIVATE = "createFlowActivate",
+    RESTART = "createFlowRestart",
+    ERROR = "createFlowError",
+    LAND = "createLandInStudio",
+    DISCARD = "createDiscard",
+    SA_DRAFT = "saDraft"
+}

package/dist/types-ts4.5/actions/groups/debug.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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 declare const ACTION_GROUP: "debug";
+export declare enum AgentDebugActions {
+    VIEW = "debugView",
+    COPY_ALL = "debugCopyAll",
+    COPY = "debugCopy",
+    TOGGLE_SKILL_INFO = "debugToggleSkillInfo"
+}
+type EmptyAttributes = {};
+export type DebugActionAttributes = {
+    [AgentDebugActions.COPY_ALL]: EmptyAttributes;
+    [AgentDebugActions.COPY]: EmptyAttributes;
+    [AgentDebugActions.TOGGLE_SKILL_INFO]: {
+        toolId: string;
+        isExpanded: boolean;
+    };
+    [AgentDebugActions.VIEW]: EmptyAttributes;
+};
+export {};