@atlaskit/rovo-triggers 10.4.0 → 10.6.0

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @atlaskit/rovo-triggers
 
+## 10.6.0
+
+### Minor Changes
+
+- [`169859ef13e04`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/169859ef13e04) -
+  Add an additive `chatEntryPoint` attribution channel to Rovo Chat, so a product can measure chats
+  that originated from its own surfaces.
+
+  A `chat-new` publisher can now pass a `ChatEntryPoint` enum value to record which surface launched
+  the conversation. New entry points must be added to the enum before use. The value is stored on
+  the conversation record — so it also covers launches that carry no `prompt`, and keeps applying
+  past the first turn — and is reported as a new `chatEntryPoint` attribute on the
+  `aiInteraction initiated` and `aiResult viewed` events.
+
+  ```ts
+  import { ChatEntryPoint } from '@atlaskit/rovo-triggers/chat-entry-point';
+
+  publish({
+  	type: 'chat-new',
+  	data: {
+  		chatEntryPoint: ChatEntryPoint.SEARCH_PAGE_AUTO_OPEN_CHAT,
+  	},
+  });
+  ```
+
+  Purely additive: no existing analytics attribute changes value or value space. `source`,
+  `subjectId`, `interactionSource`, `followUpSource`, `invokedFrom`, `entryPoint` and
+  `proactiveAIGenerated` are untouched.
+
+## 10.5.0
+
+### Minor Changes
+
+- [`71548d5902718`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/71548d5902718) -
+  Allow InContextAifcModal to be programmatically closed via a pubsub event. Mainly intended for use
+  by downstream chat actions.
+
+  Publishers can dismiss an open modal by publishing the new `close-in-context-aifc-modal` payload
+  on the `ai-mate` topic:
+
+  ```ts
+  import { usePublish } from '@atlaskit/rovo-triggers/main';
+
+  const publish = usePublish('ai-mate');
+
+  publish({
+  	type: 'close-in-context-aifc-modal',
+  	source: 'inline-agent-creation',
+  });
+  ```
+
 ## 10.4.0
 
 ### Minor Changes

package/chat-entry-point/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@atlaskit/rovo-triggers/chat-entry-point",
+  "main": "../dist/cjs/chat-entry-point.js",
+  "module": "../dist/esm/chat-entry-point.js",
+  "module:es2019": "../dist/es2019/chat-entry-point.js",
+  "sideEffects": [
+    "*.compiled.css"
+  ],
+  "types": "../dist/types/chat-entry-point.d.ts"
+}

package/dist/cjs/chat-entry-point.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ChatEntryPoint = void 0;
+var ChatEntryPoint = exports.ChatEntryPoint = /*#__PURE__*/function (ChatEntryPoint) {
+  ChatEntryPoint["SEARCH_PAGE_AUTO_OPEN_CHAT"] = "searchPageAutoOpenChat";
+  return ChatEntryPoint;
+}({});

package/dist/cjs/types.js

@@ -105,6 +105,13 @@ var Topics = exports.Topics = {
  * optimistically in the Relay store without refetching.
  */
 
+/**
+ * Requests that the currently mounted in-context AIFC modal close.
+ *
+ * This event is intentionally unscoped because only one such modal
+ * is expected to be open at a time.
+ */
+
 var JIRA_INLINE_AGENT_CREATION_AGENT_ASSIGNED_EVENT = exports.JIRA_INLINE_AGENT_CREATION_AGENT_ASSIGNED_EVENT = 'jira-inline-agent-creation-agent-assigned';
 /**
  * Published right before the `create-work-items` skill calls the bulk-create API, carrying the draft

package/dist/es2019/chat-entry-point.js

@@ -0,0 +1,4 @@
+export let ChatEntryPoint = /*#__PURE__*/function (ChatEntryPoint) {
+  ChatEntryPoint["SEARCH_PAGE_AUTO_OPEN_CHAT"] = "searchPageAutoOpenChat";
+  return ChatEntryPoint;
+}({});

package/dist/es2019/types.js

@@ -99,6 +99,13 @@ export const Topics = {
  * optimistically in the Relay store without refetching.
  */
 
+/**
+ * Requests that the currently mounted in-context AIFC modal close.
+ *
+ * This event is intentionally unscoped because only one such modal
+ * is expected to be open at a time.
+ */
+
 export const JIRA_INLINE_AGENT_CREATION_AGENT_ASSIGNED_EVENT = 'jira-inline-agent-creation-agent-assigned';
 /**
  * Published right before the `create-work-items` skill calls the bulk-create API, carrying the draft

package/dist/esm/chat-entry-point.js

@@ -0,0 +1,4 @@
+export var ChatEntryPoint = /*#__PURE__*/function (ChatEntryPoint) {
+  ChatEntryPoint["SEARCH_PAGE_AUTO_OPEN_CHAT"] = "searchPageAutoOpenChat";
+  return ChatEntryPoint;
+}({});

package/dist/esm/types.js

@@ -99,6 +99,13 @@ export var Topics = {
  * optimistically in the Relay store without refetching.
  */
 
+/**
+ * Requests that the currently mounted in-context AIFC modal close.
+ *
+ * This event is intentionally unscoped because only one such modal
+ * is expected to be open at a time.
+ */
+
 export var JIRA_INLINE_AGENT_CREATION_AGENT_ASSIGNED_EVENT = 'jira-inline-agent-creation-agent-assigned';
 /**
  * Published right before the `create-work-items` skill calls the bulk-create API, carrying the draft

package/dist/types/chat-entry-point.d.ts

@@ -0,0 +1,3 @@
+export declare enum ChatEntryPoint {
+    SEARCH_PAGE_AUTO_OPEN_CHAT = "searchPageAutoOpenChat"
+}

package/dist/types/types.d.ts

@@ -1,4 +1,5 @@
 import type { DocNode } from '@atlaskit/adf-schema/doc';
+import type { ChatEntryPoint } from './chat-entry-point';
 import type { SolutionDraftAgentUpdatePayload } from './common/types/agent';
 import type { JsmJourneyBuilderActionsPayload } from './common/types/jsm-journey-builder';
 import type { SolutionArchitectAgentActivationFlowStoppedPayload, SolutionArchitectAgentActivationPayload, SolutionArchitectAgentActivationFlowStartedPayload, SolutionArchitectHandoffPayload, SolutionPlanStateUpdatePayload, StudioAutomationBuildUpdatePayload, StudioLandingPageRedirectPayload, UpdateAgentConfigurationPayload } from './common/types/solution-architect';
@@ -139,6 +140,8 @@ export type ChatNewPayload = PayloadCore<'chat-new', {
      */
     agentName?: string;
     agentIdentityAccountId?: string;
+    /** Identifies the product surface that launched the conversation for analytics attribution. */
+    chatEntryPoint?: ChatEntryPoint;
 } & Partial<TargetAgentParam> & PlaceholderParam>;
 export type RovoSpaceEntryPoint = 'leftNav' | 'sidebar' | 'zeroQuery' | 'typeahead' | 'inChatRecommendation';
 /**
@@ -594,7 +597,14 @@ export type SmartlinksSubscriptionChangedPayload = PayloadCore<'smartlinks-subsc
     openChat: false;
     isActive: boolean;
 };
-export type Payload = MessageSendPayload | ChatClosePayload | SmartCreationModalOpenPayload | ChatNewPayload | InsightsOpenInChatPayload | InsightsChatExitedPayload | ChatDraftPayload | ChatSmartLink3PPostAuthLaunchPayload | EditorContextPayload | ChatOpenPayload | OpenBrowseAgentPayload | SmartlinksSubscriptionChangedPayload | OpenBrowseAgentSidebarPayload | EditorSuggestionPayload | EditorAgentChangedPayload | BrowserContextPayload | WhiteboardContextPayload | JiraCreateContextPayload | JiraInlineAgentCreationAgentAssignedPayload | JiraWorkItemsCreatingPayload | JiraWorkItemsCreatedPayload | JiraWorkItemsCreateFailedPayload | DatabaseContextPayload | ForgeAppAuthSuccess | ForgeAppAuthFailure | JiraWorkflowWizardActionsPayload | InsertPromptPayload | DashboardInsightsActionsPayload | SetChatContextPayload | InsertUrlsPayload | InsertSkillPayload | SelectActionPayload | AddChartToDashboardPayload | GenericExternalActionErrorPayload | OpenChatDebugModalPayload | OpenChatFeedbackModalPayload | JsmJourneyBuilderActionsPayload | StudioAutomationBuildUpdatePayload | SolutionArchitectHandoffPayload | SolutionPlanStateUpdatePayload | SolutionDraftAgentUpdatePayload | SolutionArchitectAgentActivationPayload | SolutionArchitectAgentActivationFlowStartedPayload | SolutionArchitectAgentActivationFlowStoppedPayload | UpdateAgentConfigurationPayload | StudioLandingPageRedirectPayload | UploadAndInsertMediaPayload | SmartLinksContextPayload | SpaceSelectedPayload | SpaceDeselectedPayload | RecommendedSpacesSelectedPayload | CustomSkillUpdatePayload | TaskPlanConfirmedPayload | TaskAskQuestionRenderedPayload | TaskPlanRenderedPayload | TaskSkipAllQuestionsPayload | TaskCancelPlanPayload | TaskAskQuestionConfirmedPayload | TaskModifyPlanRequestedPayload | TaskModifyPlanSubmittedPayload;
+/**
+ * Requests that the currently mounted in-context AIFC modal close.
+ *
+ * This event is intentionally unscoped because only one such modal
+ * is expected to be open at a time.
+ */
+export type CloseInContextAifcModalPayload = PayloadCore<'close-in-context-aifc-modal'>;
+export type Payload = MessageSendPayload | ChatClosePayload | CloseInContextAifcModalPayload | SmartCreationModalOpenPayload | ChatNewPayload | InsightsOpenInChatPayload | InsightsChatExitedPayload | ChatDraftPayload | ChatSmartLink3PPostAuthLaunchPayload | EditorContextPayload | ChatOpenPayload | OpenBrowseAgentPayload | SmartlinksSubscriptionChangedPayload | OpenBrowseAgentSidebarPayload | EditorSuggestionPayload | EditorAgentChangedPayload | BrowserContextPayload | WhiteboardContextPayload | JiraCreateContextPayload | JiraInlineAgentCreationAgentAssignedPayload | JiraWorkItemsCreatingPayload | JiraWorkItemsCreatedPayload | JiraWorkItemsCreateFailedPayload | DatabaseContextPayload | ForgeAppAuthSuccess | ForgeAppAuthFailure | JiraWorkflowWizardActionsPayload | InsertPromptPayload | DashboardInsightsActionsPayload | SetChatContextPayload | InsertUrlsPayload | InsertSkillPayload | SelectActionPayload | AddChartToDashboardPayload | GenericExternalActionErrorPayload | OpenChatDebugModalPayload | OpenChatFeedbackModalPayload | JsmJourneyBuilderActionsPayload | StudioAutomationBuildUpdatePayload | SolutionArchitectHandoffPayload | SolutionPlanStateUpdatePayload | SolutionDraftAgentUpdatePayload | SolutionArchitectAgentActivationPayload | SolutionArchitectAgentActivationFlowStartedPayload | SolutionArchitectAgentActivationFlowStoppedPayload | UpdateAgentConfigurationPayload | StudioLandingPageRedirectPayload | UploadAndInsertMediaPayload | SmartLinksContextPayload | SpaceSelectedPayload | SpaceDeselectedPayload | RecommendedSpacesSelectedPayload | CustomSkillUpdatePayload | TaskPlanConfirmedPayload | TaskAskQuestionRenderedPayload | TaskPlanRenderedPayload | TaskSkipAllQuestionsPayload | TaskCancelPlanPayload | TaskAskQuestionConfirmedPayload | TaskModifyPlanRequestedPayload | TaskModifyPlanSubmittedPayload;
 export type TaskPlanConfirmedPayload = PayloadCore<'task-plan-confirmed', {
     conversationId: string;
     planTitle: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/rovo-triggers",
-	"version": "10.4.0",
+	"version": "10.6.0",
 	"description": "Provides various trigger events to drive Rovo Chat functionality, such as a publish-subscribe and URL parameter hooks",
 	"author": "Atlassian Pty Ltd",
 	"publishConfig": {
@@ -43,7 +43,7 @@
 		"@atlaskit/css": "^1.0.0",
 		"@atlaskit/primitives": "^22.2.0",
 		"@atlaskit/ssr": "workspace:^",
-		"@atlassian/a11y-jest-testing": "^0.14.0",
+		"@atlassian/a11y-jest-testing": "^0.15.0",
 		"@atlassian/conversation-assistant-service-api": "^15.1.0",
 		"@atlassian/feature-flags-test-utils": "^1.2.0",
 		"@testing-library/react": "^16.3.0",