@atlaskit/rovo-agent-analytics 0.18.0 → 0.20.0

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

@@ -0,0 +1,81 @@
+/**
+ * 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)
+ */
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+/**
+ * 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;
+};
+/** @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

@@ -0,0 +1,65 @@
+/**
+ * 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()`.
+ */
+export type CreateFlowEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'createFlowStart';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'createFlowSkipNL';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'createFlowReviewNL';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'createFlowActivate';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'createFlowRestart';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'createFlowError';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'createLandInStudio';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'createDiscard';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'saDraft';
+    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

@@ -0,0 +1,55 @@
+/**
+ * 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()`.
+ */
+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;
+    };
+};
+/** @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

@@ -0,0 +1,33 @@
+/**
+ * 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)
+ */
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+export type EditingEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'updated';
+    attributes: BaseAgentAnalyticsAttributes & {
+        agentType: string;
+        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/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

@@ -0,0 +1,69 @@
+/**
+ * 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)
+ */
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+type ToolsExecutionAttributesBase = BaseAgentAnalyticsAttributes & {
+    tools: {
+        toolId: string;
+        toolSource: string;
+        resolutionType: string;
+    }[];
+    singleInstrumentationId: string | undefined;
+};
+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;
+};
+/** @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 {};

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

@@ -1,52 +1,23 @@
-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 EventPayload, 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;
+    trackAgentEvent: (payload: EventPayload) => 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,23 @@
+/**
+ * Action Registry (Backwards Compatibility)
+ *
+ * This file contains deprecated exports for backwards compatibility
+ * with consumers using `trackAgentAction()`.
+ *
+ * For new code, use the payload types from each group file directly
+ * with `trackAgentEvent()`.
+ *
+ * @deprecated The registry pattern is deprecated. Use EventPayload from types.ts instead.
+ */
+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';
+export declare const DefaultActionSubject = "rovoAgent";
+/**
+ * Combined attribute map (union of all groups).
+ * Used by the backward-compatible `trackAgentAction` helper.
+ *
+ * @deprecated Use EventPayload with trackAgentEvent() instead
+ */
+export type ActionAttributes = AgentInteractionAttributes & EditingActionAttributes & DebugActionAttributes & ToolsActionAttributes;

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

@@ -1,5 +1,19 @@
+import type { AddToolsPromptEventPayload } from '../actions/groups/add-tools-prompt';
+import type { AgentInteractionsEventPayload } from '../actions/groups/agent-interactions';
+import type { CreateFlowEventPayload } from '../actions/groups/create-flow';
+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;
 };
+/** Common library attribute injected into all events */
+export declare const LIBRARY_ATTRIBUTE: "agents-analytics";
+/**
+ * Union of all event payload types.
+ * Use with `trackAgentEvent()` for typed event tracking.
+ */
+export type EventPayload = EditingEventPayload | AgentInteractionsEventPayload | DebugEventPayload | ToolsEventPayload | EvaluationEventPayload | CreateFlowEventPayload | AddToolsPromptEventPayload;

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,39 @@
+/**
+ * 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()`.
+ */
+export type AddToolsPromptEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'addToolsPromptShown';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'addToolsPromptBrowse';
+    attributes: {};
+} | {
+    actionSubject: 'rovoAgent';
+    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-ts4.5/actions/groups/agent-interactions.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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)
+ */
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+/**
+ * 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;
+};
+/** @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;
+};