@atlaskit/rovo-agent-analytics 1.5.0 → 1.7.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @atlaskit/rovo-agent-analytics
 
+## 1.7.0
+
+### Minor Changes
+
+- [`b72d0152846b8`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b72d0152846b8) -
+  Fire knowledgeFilters analytics events: 'saved' on successful update and 'closed' on cancel from
+  ConnectorFilters; 'updated' from SelectFilter when the selection changes (filterOrControlId as
+  filter id, comma-joined option values).
+
+## 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

package/dist/cjs/actions/groups/knowledge-filters.js

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

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/knowledge-filters.js

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

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

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

package/dist/esm/actions/groups/knowledge-filters.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/knowledge-filters.d.ts

@@ -0,0 +1,33 @@
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+type FilterAttributes = {
+    id: string;
+    selectedOptionsCount: number;
+};
+type KnowledgeSourceAttributes = BaseAgentAnalyticsAttributes & {
+    productKey: string;
+};
+export type KnowledgeFiltersEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'knowledgeFiltersOpened';
+    attributes: KnowledgeSourceAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'knowledgeFiltersClosed';
+    attributes: KnowledgeSourceAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'knowledgeFiltersSaved';
+    attributes: KnowledgeSourceAttributes & {
+        filterCount: number;
+        filters: {
+            [key: string]: Omit<FilterAttributes, 'id'>;
+        };
+    };
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'knowledgeFiltersUpdated';
+    attributes: KnowledgeSourceAttributes & {
+        filter: FilterAttributes;
+    };
+};
+export {};

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/common/types.d.ts

@@ -3,6 +3,8 @@ 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 { KnowledgeFiltersEventPayload } from '../actions/groups/knowledge-filters';
+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 +51,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 | KnowledgeFiltersEventPayload;

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/knowledge-filters.d.ts

@@ -0,0 +1,33 @@
+import type { BaseAgentAnalyticsAttributes } from '../../common/types';
+type FilterAttributes = {
+    id: string;
+    selectedOptionsCount: number;
+};
+type KnowledgeSourceAttributes = BaseAgentAnalyticsAttributes & {
+    productKey: string;
+};
+export type KnowledgeFiltersEventPayload = {
+    actionSubject: 'rovoAgent';
+    action: 'knowledgeFiltersOpened';
+    attributes: KnowledgeSourceAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'knowledgeFiltersClosed';
+    attributes: KnowledgeSourceAttributes;
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'knowledgeFiltersSaved';
+    attributes: KnowledgeSourceAttributes & {
+        filterCount: number;
+        filters: {
+            [key: string]: Omit<FilterAttributes, 'id'>;
+        };
+    };
+} | {
+    actionSubject: 'rovoAgent';
+    action: 'knowledgeFiltersUpdated';
+    attributes: KnowledgeSourceAttributes & {
+        filter: FilterAttributes;
+    };
+};
+export {};

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/common/types.d.ts

@@ -3,6 +3,8 @@ 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 { KnowledgeFiltersEventPayload } from '../actions/groups/knowledge-filters';
+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 +51,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 | KnowledgeFiltersEventPayload;

package/package.json

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