@atlaskit/rovo-agent-analytics 0.19.0 → 1.0.0

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

@@ -7,33 +7,49 @@
  * 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
+ * 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)
  */
 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;
+/**
+ * Discriminated union payload type for agent interaction events.
+ * Use with `trackAgentEvent()`.
+ */
+export type AgentInteractionsEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'view';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'edit';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'copyLink';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'delete';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'duplicate';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'star';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'chat';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'verify';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'unverify';
+    attributes: BaseAgentAnalyticsAttributes;
 };

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

@@ -4,27 +4,31 @@
  * 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
+ * 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)
  */
-/** 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]: {
+/**
+ * Discriminated union payload type for debug events.
+ * Use with `trackAgentEvent()`.
+ */
+export type DebugEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'debugView';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'debugCopyAll';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'debugCopy';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'debugToggleSkillInfo';
+    attributes: {
         toolId: string;
         isExpanded: boolean;
     };
-    [AgentDebugActions.VIEW]: EmptyAttributes;
 };
-export {};

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

@@ -5,19 +5,15 @@
  * 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
+ * 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)
  */
 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 & {
+export type EditingEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'updated';
+    attributes: BaseAgentAnalyticsAttributes & {
         agentType: string;
         field: string;
     };

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

@@ -0,0 +1,56 @@
+/**
+ * Action Group: evaluation
+ *
+ * Batch evaluation events — dataset CRUD, job lifecycle, and validation UI events
+ * fired from the shared `agent-evaluation` package.
+ *
+ * ## Adding a new action
+ * 1. Add a new variant to the `EvaluationEventPayload` 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)
+ */
+type EvalAttributesBase = {
+    objectType?: string;
+    objectId?: string;
+    containerType?: string;
+    containerId?: string;
+    actionSubjectId?: string;
+};
+export type EvaluationEventPayload = ({
+    actionSubject: 'batchEvaluationDataset';
+    action: 'created';
+    attributes: {
+        totalQuestions: number;
+    };
+} & EvalAttributesBase) | ({
+    actionSubject: 'batchEvaluationJob';
+    action: 'created';
+    attributes: {
+        datasetSize: number;
+        isDraftAgent: boolean;
+        judgeMode: string | undefined;
+    };
+} & EvalAttributesBase) | ({
+    actionSubject: 'batchEvaluationDataset';
+    action: 'deleted';
+    attributes: {};
+} & EvalAttributesBase) | ({
+    actionSubject: 'batchEvaluationDatasetQuestion';
+    action: 'deleted';
+    attributes: {};
+} & EvalAttributesBase) | ({
+    actionSubject: 'evalResultsModal';
+    action: 'viewed';
+    attributes: {
+        trigger: 'row_action' | 'flag_action';
+    };
+} & EvalAttributesBase) | ({
+    actionSubject: 'batchEvaluationJob';
+    action: 'completed';
+    attributes: {
+        status: string | null;
+        durationMs: number | null;
+        datasetSize: number | null | undefined;
+    };
+} & EvalAttributesBase);
+export {};

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

@@ -5,21 +5,12 @@
  * (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
+ * 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)
  */
 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 & {
+type ToolsExecutionAttributesBase = BaseAgentAnalyticsAttributes & {
     tools: {
         toolId: string;
         toolSource: string;
@@ -27,12 +18,23 @@ export type ToolsExecutionAttributes = BaseAgentAnalyticsAttributes & {
     }[];
     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;
+export type ToolsEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'toolsExecutionConfirmed';
+    attributes: ToolsExecutionAttributesBase;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'toolsExecutionStreamStopped';
+    attributes: ToolsExecutionAttributesBase;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'toolsExecutionResultViewed';
+    attributes: ToolsExecutionAttributesBase & {
+        scenarioId: string | null | undefined;
+    };
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'toolsExecutionResultError';
+    attributes: ToolsExecutionAttributesBase;
 };
+export {};

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

@@ -1,22 +1,4 @@
-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;
+import { type EventPayload } from '../common/types';
 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;
+    trackAgentEvent: (payload: EventPayload) => void;
 };

package/dist/types/common/types.d.ts

@@ -1,5 +1,31 @@
+import type { AgentInteractionsEventPayload } from '../actions/groups/agent-interactions';
+import type { DebugEventPayload } from '../actions/groups/debug';
+import type { EditingEventPayload } from '../actions/groups/editing';
+import type { EvaluationEventPayload } from '../actions/groups/evaluation';
+import type { ToolsEventPayload } from '../actions/groups/tools';
 export type RemainingRequired<T, P extends Partial<T>> = Required<Omit<T, keyof P>>;
 export type BaseAgentAnalyticsAttributes = {
-    touchPoint: string;
-    agentId: string;
+    touchPoint?: string;
+    agentId?: string;
 };
+/** Common library attribute injected into all events */
+export declare const LIBRARY_ATTRIBUTE: "agents-analytics";
+/**
+ * Generic error event payload type.
+ * Use with `trackAgentEvent()` to track error events.
+ */
+export type ErrorEventPayload = {
+    actionSubject: 'rovoAgentError';
+    action: string;
+    attributes: {
+        error: {
+            message: string;
+        };
+        [key: string]: unknown;
+    };
+};
+/**
+ * Union of all event payload types.
+ * Use with `trackAgentEvent()` for typed event tracking.
+ */
+export type EventPayload = EditingEventPayload | AgentInteractionsEventPayload | DebugEventPayload | ToolsEventPayload | EvaluationEventPayload | ErrorEventPayload;

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

@@ -1,24 +1,27 @@
-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;
-};
+/**
+ * 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
+ */
+type AgentCreateAction = 'createFlowStart' | 'createFlowSkipNL' | 'createFlowReviewNL' | 'createFlowActivate' | 'createFlowRestart' | 'createFlowError' | 'createLandInStudio' | 'createDiscard' | 'saDraft' | 'addToolsPromptShown' | 'addToolsPromptBrowse' | 'addToolsPromptDismiss';
 type CommonAnalyticsAttributes = {
     touchPoint?: string;
 } & Record<string, any>;
 export declare const useRovoAgentCreateAnalytics: (commonAttributes: CommonAnalyticsAttributes) => readonly [string | null, {
-    readonly trackCreateSession: (action: (typeof AgentCreateActions)[keyof typeof AgentCreateActions], attributes?: CommonAnalyticsAttributes) => void;
+    readonly trackCreateSession: (action: AgentCreateAction, 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/agent-interactions.d.ts

@@ -7,33 +7,49 @@
  * 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
+ * 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)
  */
 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;
+/**
+ * Discriminated union payload type for agent interaction events.
+ * Use with `trackAgentEvent()`.
+ */
+export type AgentInteractionsEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'view';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'edit';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'copyLink';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'delete';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'duplicate';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'star';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'chat';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'verify';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'unverify';
+    attributes: BaseAgentAnalyticsAttributes;
 };

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

@@ -4,27 +4,31 @@
  * 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
+ * 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)
  */
-/** 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]: {
+/**
+ * Discriminated union payload type for debug events.
+ * Use with `trackAgentEvent()`.
+ */
+export type DebugEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'debugView';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'debugCopyAll';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'debugCopy';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'debugToggleSkillInfo';
+    attributes: {
         toolId: string;
         isExpanded: boolean;
     };
-    [AgentDebugActions.VIEW]: EmptyAttributes;
 };
-export {};

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

@@ -5,19 +5,15 @@
  * 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
+ * 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)
  */
 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 & {
+export type EditingEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'updated';
+    attributes: BaseAgentAnalyticsAttributes & {
         agentType: string;
         field: string;
     };

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

@@ -0,0 +1,56 @@
+/**
+ * Action Group: evaluation
+ *
+ * Batch evaluation events — dataset CRUD, job lifecycle, and validation UI events
+ * fired from the shared `agent-evaluation` package.
+ *
+ * ## Adding a new action
+ * 1. Add a new variant to the `EvaluationEventPayload` 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)
+ */
+type EvalAttributesBase = {
+    objectType?: string;
+    objectId?: string;
+    containerType?: string;
+    containerId?: string;
+    actionSubjectId?: string;
+};
+export type EvaluationEventPayload = ({
+    actionSubject: 'batchEvaluationDataset';
+    action: 'created';
+    attributes: {
+        totalQuestions: number;
+    };
+} & EvalAttributesBase) | ({
+    actionSubject: 'batchEvaluationJob';
+    action: 'created';
+    attributes: {
+        datasetSize: number;
+        isDraftAgent: boolean;
+        judgeMode: string | undefined;
+    };
+} & EvalAttributesBase) | ({
+    actionSubject: 'batchEvaluationDataset';
+    action: 'deleted';
+    attributes: {};
+} & EvalAttributesBase) | ({
+    actionSubject: 'batchEvaluationDatasetQuestion';
+    action: 'deleted';
+    attributes: {};
+} & EvalAttributesBase) | ({
+    actionSubject: 'evalResultsModal';
+    action: 'viewed';
+    attributes: {
+        trigger: 'row_action' | 'flag_action';
+    };
+} & EvalAttributesBase) | ({
+    actionSubject: 'batchEvaluationJob';
+    action: 'completed';
+    attributes: {
+        status: string | null;
+        durationMs: number | null;
+        datasetSize: number | null | undefined;
+    };
+} & EvalAttributesBase);
+export {};

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

@@ -5,21 +5,12 @@
  * (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
+ * 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)
  */
 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 & {
+type ToolsExecutionAttributesBase = BaseAgentAnalyticsAttributes & {
     tools: {
         toolId: string;
         toolSource: string;
@@ -27,12 +18,23 @@ export type ToolsExecutionAttributes = BaseAgentAnalyticsAttributes & {
     }[];
     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;
+export type ToolsEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'toolsExecutionConfirmed';
+    attributes: ToolsExecutionAttributesBase;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'toolsExecutionStreamStopped';
+    attributes: ToolsExecutionAttributesBase;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'toolsExecutionResultViewed';
+    attributes: ToolsExecutionAttributesBase & {
+        scenarioId: string | null | undefined;
+    };
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'toolsExecutionResultError';
+    attributes: ToolsExecutionAttributesBase;
 };
+export {};