@atlaskit/rovo-agent-analytics 0.20.0 → 1.1.0

package/dist/esm/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 var ACTION_GROUP = 'agentInteractions';
-
-/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
-export var AgentInteractionActions = /*#__PURE__*/function (AgentInteractionActions) {
-  /* View agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97125 */
-  AgentInteractionActions["VIEW"] = "view";
-  /* Edit agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97126 */
-  AgentInteractionActions["EDIT"] = "edit";
-  /* Copy link clicked - https://data-portal.internal.atlassian.com/analytics/registry/97128 */
-  AgentInteractionActions["COPY_LINK"] = "copyLink";
-  /* Delete agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97129 */
-  AgentInteractionActions["DELETE"] = "delete";
-  /* Duplicate agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97130 */
-  AgentInteractionActions["DUPLICATE"] = "duplicate";
-  /* Star agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97133 */
-  AgentInteractionActions["STAR"] = "star";
-  /* Chat with agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97095 */
-  AgentInteractionActions["CHAT"] = "chat";
-  /* Verify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97134 */
-  AgentInteractionActions["VERIFY"] = "verify";
-  /* Unverify agent clicked - https://data-portal.internal.atlassian.com/analytics/registry/97135 */
-  AgentInteractionActions["UNVERIFY"] = "unverify";
-  return AgentInteractionActions;
-}({});
-
-/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
+export {};

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

@@ -1,45 +0,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 */
-export var ACTION_GROUP = 'createFlow';
-
-/** @deprecated Use CreateFlowEventPayload with trackAgentEvent() instead */
-export var 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/esm/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 var ACTION_GROUP = 'debug';
-
-/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
-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;
-}({});
-
-/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */

package/dist/esm/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 var ACTION_GROUP = 'editing';
-
-/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */
-export var 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/esm/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 var ACTION_GROUP = 'tools';
-
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-export var AgentToolActions = /*#__PURE__*/function (AgentToolActions) {
-  /* When chatting with an agent, and tools confirmation being shown, then user click proceed with the possible actions (e.g. confirm, dismiss etc) https://data-portal.internal.atlassian.com/analytics/registry/97675 */
-  AgentToolActions["TOOLS_EXECUTION_CONFIRMED"] = "toolsExecutionConfirmed";
-  /* When tools execution result is being streamed and user stops the stream e.g. by clicking stop button https://data-portal.internal.atlassian.com/analytics/registry/97750 */
-  AgentToolActions["TOOLS_EXECUTION_STREAM_STOPPED"] = "toolsExecutionStreamStopped";
-  /* When tools execution result is done streaming and user sees the result https://data-portal.internal.atlassian.com/analytics/registry/97751*/
-  AgentToolActions["TOOLS_EXECUTION_RESULT_VIEWED"] = "toolsExecutionResultViewed";
-  /* When tools execution result streaming fails https://data-portal.internal.atlassian.com/analytics/registry/97752 */
-  AgentToolActions["TOOLS_EXECUTION_RESULT_ERROR"] = "toolsExecutionResultError";
-  return AgentToolActions;
-}({});
-
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
+export {};

package/dist/esm/actions/index.js

@@ -8,17 +8,6 @@ import { AnalyticsReactContext, useAnalyticsEvents } from '@atlaskit/analytics-n
 import { ANALYTICS_CHANNEL } from '../common/constants';
 import { LIBRARY_ATTRIBUTE } from '../common/types';
 import { getAttributesFromContexts, getDefaultTrackEventConfig } from '../common/utils';
-import { AgentInteractionActions } from './groups/agent-interactions';
-import { AgentDebugActions as AgentDebugActionsEnum } from './groups/debug';
-import { AgentEditingActions } from './groups/editing';
-import { DefaultActionSubject } 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);
@@ -35,20 +24,6 @@ export var useRovoAgentActionAnalytics = function useRovoAgentActionAnalytics(co
   }, [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 = useCallback(function (action, attributes) {
-    fireAnalyticsEvent({
-      actionSubject: DefaultActionSubject,
-      action: action,
-      attributes: attributes
-    });
-  }, [fireAnalyticsEvent]);
-
   /**
    * Fully-typed event tracking using discriminated union payload types.
    * The payload type enforces correct action, actionSubject, and attributes.
@@ -65,24 +40,7 @@ export var useRovoAgentActionAnalytics = function useRovoAgentActionAnalytics(co
       attributes: attributes
     }));
   }, [fireAnalyticsEvent]);
-
-  /**
-   * @deprecated Use trackAgentEvent() with typed payloads instead
-   */
-  var trackAgentActionError = 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/esm/common/csid/index.js

@@ -1,50 +1,39 @@
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
-import { useEffect, useMemo, useState } from 'react';
+import { useMemo, useState } from 'react';
 import { CSID_QUERY_PARAM } from '../constants';
 var CACHED_CSID = null;
 var generateCSID = function generateCSID() {
   return crypto.randomUUID();
 };
-var retrieveCSID = function retrieveCSID() {
-  if (CACHED_CSID) {
-    return CACHED_CSID;
-  }
-  var queryParams = new URLSearchParams(window.location.search);
-  var querySessionId = queryParams.get(CSID_QUERY_PARAM);
-  return querySessionId !== null && querySessionId !== void 0 ? querySessionId : generateCSID();
-};
 
 /**
- * Hook to get Rovo Agent Create Session ID (CSID) from the query parameters or generate a new one if not found.
- * @returns Rovo Agent CSID as a string.
+ * Hook to manage CSID state for entry point components.
+ * The returned csid is used in href attributes and by trackCreateSessionStart.
+ * After trackCreateSessionStart fires, it calls refresh() to generate a new CSID
+ * for the next session — the component re-renders and the href updates.
  */
 export var useRovoAgentCSID = function useRovoAgentCSID() {
-  var _useState = useState(retrieveCSID()),
+  var _useState = useState(CACHED_CSID || generateCSID()),
     _useState2 = _slicedToArray(_useState, 2),
-    CSID = _useState2[0],
+    csid = _useState2[0],
     setCSID = _useState2[1];
+  var globalCSID = useMemo(function () {
+    var queryParams = new URLSearchParams(window.location.search);
+    return queryParams.get(CSID_QUERY_PARAM);
+  }, []);
   var actions = useMemo(function () {
     return {
       refresh: function refresh() {
         var newCSID = generateCSID();
         setCSID(newCSID);
+        CACHED_CSID = newCSID;
         return newCSID;
-      },
-      clear: function clear() {
-        // remove CSID query parameter
-        var url = new URL(window.location.href);
-        url.searchParams.delete(CSID_QUERY_PARAM);
-        window.history.replaceState({}, '', url.toString());
-
-        // reset state
-        setCSID(null);
-        return null;
       }
     };
   }, []);
-  useEffect(function () {
-    // sync cache on state change
-    CACHED_CSID = CSID;
-  }, [CSID]);
-  return [CSID, actions];
+  return [{
+    csid: csid,
+    // generated CSID to be used in href and createFlowStart events
+    globalCSID: globalCSID // CSID from the URL query parameter
+  }, actions];
 };

package/dist/esm/common/types.js

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

package/dist/esm/create/index.js

@@ -1,24 +1,27 @@
-import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 import { useCallback, useContext, useRef } from 'react';
 import { AnalyticsReactContext, useAnalyticsEvents } from '@atlaskit/analytics-next';
-import { AddToolsPromptActions } from '../actions/groups/add-tools-prompt';
-import { CreateFlowActions } from '../actions/groups/create-flow';
-import { DefaultActionSubject } from '../actions/registry';
 import { ANALYTICS_CHANNEL } from '../common/constants';
 import { useRovoAgentCSID } from '../common/csid';
 import { getAttributesFromContexts, getDefaultTrackEventConfig } from '../common/utils';
+var DefaultActionSubject = 'rovoAgent';
+
+/**
+ * Union of all valid actions for the create agent analytics hook.
+ * Derived from the event payload types in the action group files.
+ * To add a new action, update the payload type in the relevant group file.
+ */
 
-// 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(),
     _useRovoAgentCSID2 = _slicedToArray(_useRovoAgentCSID, 2),
-    csid = _useRovoAgentCSID2[0],
+    _useRovoAgentCSID2$ = _useRovoAgentCSID2[0],
+    csid = _useRovoAgentCSID2$.csid,
+    globalCSID = _useRovoAgentCSID2$.globalCSID,
     refreshCSID = _useRovoAgentCSID2[1].refresh;
   var analyticsContext = useContext(AnalyticsReactContext);
   var _useAnalyticsEvents = useAnalyticsEvents(),
@@ -27,49 +30,56 @@ export var useRovoAgentCreateAnalytics = function useRovoAgentCreateAnalytics(co
   var fireAnalyticsEvent = useCallback(function (event) {
     var referrer = typeof window !== 'undefined' ? window.document.referrer : 'unknown';
     var attributes = _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, getAttributesFromContexts(analyticsContext.getAtlaskitAnalyticsContext())), commonAttributesRef.current), event.attributes), {}, {
-      csid: csid,
+      actionGroup: 'createFlow',
       referrer: referrer
     });
     createAnalyticsEvent(_objectSpread(_objectSpread(_objectSpread({}, globalEventConfig), event), {}, {
       attributes: attributes
     })).fire(ANALYTICS_CHANNEL);
-  }, [createAnalyticsEvent, csid, analyticsContext] // keep number of dependencies minimal to prevent re-rendering
+  }, [createAnalyticsEvent, analyticsContext] // keep number of dependencies minimal to prevent re-rendering
   );
 
   /**
-   * This will fire analytics event for intermediate steps in the create agent flow funnel
-   * To start the create agent flow, use trackCreateSessionStart
+   * Fires an analytics event for a step in the create agent flow funnel.
+   * Uses the CSID from the URL query parameter.
    */
   var trackCreateSession = useCallback(function (action, attributes) {
     fireAnalyticsEvent({
       actionSubject: DefaultActionSubject,
       action: action,
-      attributes: attributes
+      attributes: _objectSpread({
+        csid: globalCSID
+      }, attributes)
     });
-  }, [fireAnalyticsEvent]);
+  }, [fireAnalyticsEvent, globalCSID]);
 
   /**
-   * This should be used ONLY in the beginning of the funnel of create agent flow, it will create a new CSID (CSID = create session ID)
+   * Fires `createFlowStart` with the current CSID (matching the href),
+   * then refreshes the CSID for the next session.
+   * The component re-renders with the new CSID, updating any href attributes.
    */
   var trackCreateSessionStart = useCallback(function (attributes) {
     fireAnalyticsEvent({
       actionSubject: DefaultActionSubject,
-      action: CreateFlowActions.START,
-      attributes: attributes
+      action: 'createFlowStart',
+      attributes: _objectSpread({
+        csid: csid
+      }, attributes)
     });
     refreshCSID();
-  }, [fireAnalyticsEvent, refreshCSID]);
+  }, [fireAnalyticsEvent, refreshCSID, csid]);
   var trackCreateSessionError = useCallback(function (error, attributes) {
     fireAnalyticsEvent({
       actionSubject: DefaultActionSubject,
-      action: CreateFlowActions.ERROR,
+      action: 'createFlowError',
       attributes: _objectSpread({
         error: {
           message: error.message
-        }
+        },
+        csid: globalCSID
       }, attributes)
     });
-  }, [fireAnalyticsEvent]);
+  }, [fireAnalyticsEvent, globalCSID]);
   return [csid, {
     trackCreateSession: trackCreateSession,
     trackCreateSessionStart: trackCreateSessionStart,

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

@@ -1,16 +1,11 @@
 /**
  * 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.
+ * Events related to the "Add Tools" prompt shown during agent creation.
  *
  * ## 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.
@@ -29,11 +24,3 @@ export type AddToolsPromptEventPayload = {
     action: 'addToolsPromptDismiss';
     attributes: {};
 };
-/** @deprecated Use AddToolsPromptEventPayload with trackAgentEvent() instead */
-export declare const ACTION_GROUP: "addToolsPrompt";
-/** @deprecated Use AddToolsPromptEventPayload with trackAgentEvent() instead */
-export declare enum AddToolsPromptActions {
-    SHOWN = "addToolsPromptShown",
-    BROWSE = "addToolsPromptBrowse",
-    DISMISS = "addToolsPromptDismiss"
-}

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

@@ -53,29 +53,3 @@ export type AgentInteractionsEventPayload = {
     action: 'unverify';
     attributes: BaseAgentAnalyticsAttributes;
 };
-/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
-export declare const ACTION_GROUP: "agentInteractions";
-/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
-export declare enum AgentInteractionActions {
-    VIEW = "view",
-    EDIT = "edit",
-    COPY_LINK = "copyLink",
-    DELETE = "delete",
-    DUPLICATE = "duplicate",
-    STAR = "star",
-    CHAT = "chat",
-    VERIFY = "verify",
-    UNVERIFY = "unverify"
-}
-/** @deprecated Use AgentInteractionsEventPayload with trackAgentEvent() instead */
-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

@@ -1,7 +1,23 @@
 /**
  * Action Group: createFlow
  *
- * Create agent funnel steps — from clicking "Create agent" through to activation or discard,
+ * Create agent funnel steps — from clicking "Create agent" through to activation or discard.
+ *
+ * ## Funnel overview
+ *
+ * | Step                  | v1 (NL flow) event     | v2 (SA flow) event     | CSID behavior                    |
+ * |-----------------------|------------------------|------------------------|----------------------------------|
+ * | Intent to create      | createFlowStart        | saDraft                | Uses existing CSID                                        |
+ * | Land in NL page       | createLandInStudio     | (skipped)              | Uses existing CSID               |
+ * | NL interaction        | REVIEW_NL / SKIP_NL    | (skipped)              | Uses existing CSID               |
+ * | Land in configure     | createLandInConfigure  | createLandInConfigure  | Uses existing CSID               |
+ * | Activate agent        | createFlowActivate     | createFlowActivate     | Uses existing CSID               |
+ *
+ * ## CSID (Create Session ID)
+ *
+ * CSID links all events in a single agent creation session.
+ * - `trackCreateSessionStart()` fires `createFlowStart` with the current CSID
+ * - `trackCreateSession()` uses the existing CSID (for all other steps including `saDraft`)
  *
  * ## Adding a new action
  * 1. Add a new variant to the `CreateFlowEventPayload` union type below with a data-portal link
@@ -48,18 +64,8 @@ export type CreateFlowEventPayload = {
     actionSubject: 'rovoAgent';
     action: 'saDraft';
     attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'createLandInConfigure';
+    attributes: {};
 };
-/** @deprecated Use CreateFlowEventPayload with trackAgentEvent() instead */
-export declare const ACTION_GROUP: "createFlow";
-/** @deprecated Use CreateFlowEventPayload with trackAgentEvent() instead */
-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

@@ -32,24 +32,3 @@ export type DebugEventPayload = {
         isExpanded: boolean;
     };
 };
-/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
-export declare const ACTION_GROUP: "debug";
-/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
-export declare enum AgentDebugActions {
-    VIEW = "debugView",
-    COPY_ALL = "debugCopyAll",
-    COPY = "debugCopy",
-    TOGGLE_SKILL_INFO = "debugToggleSkillInfo"
-}
-type EmptyAttributes = {};
-/** @deprecated Use DebugEventPayload with trackAgentEvent() instead */
-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

@@ -18,16 +18,3 @@ export type EditingEventPayload = {
         field: string;
     };
 };
-/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */
-export declare const ACTION_GROUP: "editing";
-/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */
-export declare enum AgentEditingActions {
-    UPDATED = "updated"
-}
-/** @deprecated Use EditingEventPayload with trackAgentEvent() instead */
-export type EditingActionAttributes = {
-    [AgentEditingActions.UPDATED]: BaseAgentAnalyticsAttributes & {
-        agentType: string;
-        field: string;
-    };
-};

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

@@ -37,33 +37,4 @@ export type ToolsEventPayload = {
     action: 'toolsExecutionResultError';
     attributes: ToolsExecutionAttributesBase;
 };
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-export declare const ACTION_GROUP: "tools";
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-export declare enum AgentToolActions {
-    TOOLS_EXECUTION_CONFIRMED = "toolsExecutionConfirmed",
-    TOOLS_EXECUTION_STREAM_STOPPED = "toolsExecutionStreamStopped",
-    TOOLS_EXECUTION_RESULT_VIEWED = "toolsExecutionResultViewed",
-    TOOLS_EXECUTION_RESULT_ERROR = "toolsExecutionResultError"
-}
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-export type ToolsExecutionAttributes = BaseAgentAnalyticsAttributes & {
-    tools: {
-        toolId: string;
-        toolSource: string;
-        resolutionType: string;
-    }[];
-    singleInstrumentationId: string | undefined;
-};
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-export type ToolsExecutionResultAttributes = ToolsExecutionAttributes & {
-    scenarioId: string | null | undefined;
-};
-/** @deprecated Use ToolsEventPayload with trackAgentEvent() instead */
-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;
-};
 export {};