@atlaskit/rovo-agent-analytics 1.4.0 → 1.6.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @atlaskit/rovo-agent-analytics
 
+## 1.6.0
+
+### Minor Changes
+
+- [`1382e455b2661`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/1382e455b2661) -
+  Add subagent analytics tracking events for create, delete, edit tools and tool configuration
+  actions
+
+## 1.5.0
+
+### Minor Changes
+
+- [`d1b7d4ba4fd6f`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/d1b7d4ba4fd6f) -
+  Implement
+  https://hello.atlassian.net/wiki/spaces/~598965687/pages/6881328891/Tools+attributes+analytics+spec
+
 ## 1.4.0
 
 ### Minor Changes

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

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/es2019/actions/groups/subagent-interactions.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/actions/groups/subagent-interactions.js

@@ -0,0 +1 @@
+export {};

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

@@ -52,4 +52,12 @@ export type AgentInteractionsEventPayload = {
     actionSubject: 'rovoAgent';
     action: 'unverify';
     attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'editTools';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'editToolConfiguration';
+    attributes: BaseAgentAnalyticsAttributes;
 };

package/dist/types/actions/groups/subagent-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 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 SubagentInteractionsEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'subagentCreate';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'subagentEdit';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'subagentDelete';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'subagentEditTools';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'subagentEditToolConfiguration';
+    attributes: BaseAgentAnalyticsAttributes;
+};

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

@@ -13,7 +13,8 @@ import type { BaseAgentAnalyticsAttributes } from '../../common/types';
 type ToolsExecutionAttributesBase = BaseAgentAnalyticsAttributes & {
     tools: {
         toolId: string;
-        toolSource: string;
+        toolKey?: string;
+        toolDefinitionSource: string | null;
         resolutionType: string;
     }[];
     singleInstrumentationId: string | undefined;

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

@@ -3,6 +3,7 @@ import type { DebugEventPayload } from '../actions/groups/debug';
 import type { EditingEventPayload } from '../actions/groups/editing';
 import type { EvaluationEventPayload } from '../actions/groups/evaluation';
 import type { InsightsEventPayload } from '../actions/groups/insights';
+import type { SubagentInteractionsEventPayload } from '../actions/groups/subagent-interactions';
 import type { ToolsEventPayload } from '../actions/groups/tools';
 export type RemainingRequired<T, P extends Partial<T>> = Required<Omit<T, keyof P>>;
 export type BaseAgentAnalyticsAttributes = {
@@ -49,4 +50,4 @@ export type ErrorEventPayload = {
  * Union of all event payload types.
  * Use with `trackAgentEvent()` for typed event tracking.
  */
-export type EventPayload = EditingEventPayload | AgentInteractionsEventPayload | DebugEventPayload | ToolsEventPayload | EvaluationEventPayload | InsightsEventPayload | ErrorEventPayload;
+export type EventPayload = EditingEventPayload | AgentInteractionsEventPayload | SubagentInteractionsEventPayload | DebugEventPayload | ToolsEventPayload | EvaluationEventPayload | InsightsEventPayload | ErrorEventPayload;

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

@@ -52,4 +52,12 @@ export type AgentInteractionsEventPayload = {
     actionSubject: 'rovoAgent';
     action: 'unverify';
     attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'editTools';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'editToolConfiguration';
+    attributes: BaseAgentAnalyticsAttributes;
 };

package/dist/types-ts4.5/actions/groups/subagent-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 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 SubagentInteractionsEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'subagentCreate';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'subagentEdit';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'subagentDelete';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'subagentEditTools';
+    attributes: BaseAgentAnalyticsAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'subagentEditToolConfiguration';
+    attributes: BaseAgentAnalyticsAttributes;
+};

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

@@ -13,7 +13,8 @@ import type { BaseAgentAnalyticsAttributes } from '../../common/types';
 type ToolsExecutionAttributesBase = BaseAgentAnalyticsAttributes & {
     tools: {
         toolId: string;
-        toolSource: string;
+        toolKey?: string;
+        toolDefinitionSource: string | null;
         resolutionType: string;
     }[];
     singleInstrumentationId: string | undefined;

package/dist/types-ts4.5/common/types.d.ts

@@ -3,6 +3,7 @@ import type { DebugEventPayload } from '../actions/groups/debug';
 import type { EditingEventPayload } from '../actions/groups/editing';
 import type { EvaluationEventPayload } from '../actions/groups/evaluation';
 import type { InsightsEventPayload } from '../actions/groups/insights';
+import type { SubagentInteractionsEventPayload } from '../actions/groups/subagent-interactions';
 import type { ToolsEventPayload } from '../actions/groups/tools';
 export type RemainingRequired<T, P extends Partial<T>> = Required<Omit<T, keyof P>>;
 export type BaseAgentAnalyticsAttributes = {
@@ -49,4 +50,4 @@ export type ErrorEventPayload = {
  * Union of all event payload types.
  * Use with `trackAgentEvent()` for typed event tracking.
  */
-export type EventPayload = EditingEventPayload | AgentInteractionsEventPayload | DebugEventPayload | ToolsEventPayload | EvaluationEventPayload | InsightsEventPayload | ErrorEventPayload;
+export type EventPayload = EditingEventPayload | AgentInteractionsEventPayload | SubagentInteractionsEventPayload | DebugEventPayload | ToolsEventPayload | EvaluationEventPayload | InsightsEventPayload | ErrorEventPayload;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/rovo-agent-analytics",
-	"version": "1.4.0",
+	"version": "1.6.0",
 	"description": "Rovo Agents analytics",
 	"repository": "https://bitbucket.org/atlassian/atlassian-frontend-monorepo",
 	"atlassian": {