@atlaskit/rovo-triggers 10.2.0 → 10.4.0

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # @atlaskit/rovo-triggers
 
+## 10.4.0
+
+### Minor Changes
+
+- [`d42ba7ed56112`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/d42ba7ed56112) -
+  Add the public and transport contracts for gated Rovo Space source mode.
+
+  ```ts
+  const sourceMode: RovoChatSourceMode = 'STRICT';
+  await assistanceService.sendMessageStream({ sourceMode });
+  ```
+
+## 10.3.0
+
+### Minor Changes
+
+- [`a9757a562bdda`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/a9757a562bdda) -
+  Add optional issue-type information (`id`, `name`, `iconUrl`) to the `jira-work-items-creating`
+  draft payload so subscribers can render the issue-type icon on optimistic rows immediately.
+  Populated behind the `aiwc_add_issuetype_icon_to_optimistic_updates` feature gate;
+
+  `@atlaskit/rovo-triggers`: `JiraWorkItemCreatingDraft` now carries an optional `issueType`.
+  Subscribers can read it to render the icon:
+
+  ```ts
+  import { useSubscribe } from '@atlaskit/rovo-triggers/main';
+  import { JIRA_WORK_ITEMS_CREATING_EVENT } from '@atlaskit/rovo-triggers/types';
+
+  useSubscribe({ topic: 'ai-mate' }, (payload) => {
+  	if (payload.type === JIRA_WORK_ITEMS_CREATING_EVENT) {
+  		payload.data.draftWorkItems.forEach((draft) => {
+  			// `issueType` is only present when the gate is on; always guard for its absence.
+  			if (draft.issueType) {
+  				const { id, name, iconUrl } = draft.issueType;
+  				renderOptimisticRow({
+  					summary: draft.summary,
+  					issueTypeName: name,
+  					issueTypeIcon: iconUrl,
+  				});
+  			}
+  		});
+  	}
+  });
+  ```
+
+  `@atlassian/jira-create-work-items`: `JiraDraftDataForCreateAllCommandResult.context` now also
+  exposes `issueTypeToFieldsConfigMap`, the issue-type metadata resolved during validation (keyed by
+  issue type id):
+
+  ```ts
+  const result = await validateIssuesToCreate({ draftWorkItems });
+  const issueType = result.context.issueTypeToFieldsConfigMap[issueTypeId];
+  // issueType?.name, issueType?.avatarUrl — used to enrich the `creating` draft payload.
+  ```
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 10.2.0
 
 ### Minor Changes

package/dist/cjs/types.js

@@ -14,6 +14,13 @@ var Topics = exports.Topics = {
 
 // Can only specify either `agentId` or `agentExternalConfigReference`, not both
 
+/**
+ * Source-selection behavior requested when opening a chat.
+ *
+ * This public package owns the transport type so consumers do not depend on an internal package.
+ * A test keeps it aligned with the assistance service contract.
+ */
+
 /**
  * Opens the Rovo conversation assistant and seeds a chat from a Rovo Insight,
  * reproducing the same experience as clicking an insight inside the in-panel

package/dist/es2019/types.js

@@ -8,6 +8,13 @@ export const Topics = {
 
 // Can only specify either `agentId` or `agentExternalConfigReference`, not both
 
+/**
+ * Source-selection behavior requested when opening a chat.
+ *
+ * This public package owns the transport type so consumers do not depend on an internal package.
+ * A test keeps it aligned with the assistance service contract.
+ */
+
 /**
  * Opens the Rovo conversation assistant and seeds a chat from a Rovo Insight,
  * reproducing the same experience as clicking an insight inside the in-panel

package/dist/esm/types.js

@@ -8,6 +8,13 @@ export var Topics = {
 
 // Can only specify either `agentId` or `agentExternalConfigReference`, not both
 
+/**
+ * Source-selection behavior requested when opening a chat.
+ *
+ * This public package owns the transport type so consumers do not depend on an internal package.
+ * A test keeps it aligned with the assistance service contract.
+ */
+
 /**
  * Opens the Rovo conversation assistant and seeds a chat from a Rovo Insight,
  * reproducing the same experience as clicking an insight inside the in-panel

package/dist/types/types.d.ts

@@ -5,11 +5,11 @@ import type { SolutionArchitectAgentActivationFlowStoppedPayload, SolutionArchit
 import type { ChatContextPayload } from './common/utils/chat-context/types';
 import type { RovoChatOpenMode } from './common/utils/params/types';
 export declare const Topics: {
-    readonly AI_MATE: "ai-mate";
-    readonly AI_MATE_ACTIONS: "ai-mate-actions";
-    readonly AI_MATE_INSERT_URLS: "ai-mate-chat-inserts";
-    readonly AI_MATE_CHAT_INPUT_OVERLAY: "ai-mate-chat-input-overlay";
-    readonly AVP: "avp";
+    readonly AI_MATE: 'ai-mate';
+    readonly AI_MATE_ACTIONS: 'ai-mate-actions';
+    readonly AI_MATE_INSERT_URLS: 'ai-mate-chat-inserts';
+    readonly AI_MATE_CHAT_INPUT_OVERLAY: 'ai-mate-chat-input-overlay';
+    readonly AVP: 'avp';
 };
 export type Topic = (typeof Topics)[keyof typeof Topics];
 export type PayloadCore<TKey extends string, TData = void> = {
@@ -53,12 +53,20 @@ type TargetAgentParam = {
 type PlaceholderParam = {
     placeholderType?: 'person' | 'link' | 'generic' | 'skill';
 };
+/**
+ * Source-selection behavior requested when opening a chat.
+ *
+ * This public package owns the transport type so consumers do not depend on an internal package.
+ * A test keeps it aligned with the assistance service contract.
+ */
+export type RovoChatSourceMode = 'GENERAL' | 'STRICT';
 type ChatModeParam = {
     deepResearchEnabled?: boolean;
     thinkDeeperEnabled?: boolean;
     fastModeEnabled?: boolean;
     taskModeEnabled?: boolean;
     webSearchEnabled?: boolean;
+    sourceMode?: RovoChatSourceMode;
     useCurrentPageContext?: boolean;
     appFilters?: unknown[];
 };
@@ -124,6 +132,13 @@ export type ChatNewPayload = PayloadCore<'chat-new', {
      * and comment:<commentId> so the backend can create a SessionAssociationPublic record.
      */
     tags?: string[];
+    /**
+     * Optimistic agent metadata for the editor agent mention flow.
+     * Allows showing the agent avatar telepointer immediately during AI streaming
+     * without an extra network round-trip to fetch agent details.
+     */
+    agentName?: string;
+    agentIdentityAccountId?: string;
 } & Partial<TargetAgentParam> & PlaceholderParam>;
 export type RovoSpaceEntryPoint = 'leftNav' | 'sidebar' | 'zeroQuery' | 'typeahead' | 'inChatRecommendation';
 /**
@@ -613,7 +628,7 @@ export type TaskModifyPlanSubmittedPayload = PayloadCore<'task-modify-plan-submi
     invocationId: string;
     prompt: DocNode;
 }>;
-export declare const JIRA_INLINE_AGENT_CREATION_AGENT_ASSIGNED_EVENT: "jira-inline-agent-creation-agent-assigned";
+export declare const JIRA_INLINE_AGENT_CREATION_AGENT_ASSIGNED_EVENT: 'jira-inline-agent-creation-agent-assigned';
 export type JiraInlineAgentCreationAgentAssignedPayload = PayloadCore<typeof JIRA_INLINE_AGENT_CREATION_AGENT_ASSIGNED_EVENT, {
     issueId: string;
 }>;
@@ -624,12 +639,18 @@ export type JiraInlineAgentCreationAgentAssignedPayload = PayloadCore<typeof JIR
  * batch with the follow-up {@link JIRA_WORK_ITEMS_CREATED_EVENT} / {@link JIRA_WORK_ITEMS_CREATE_FAILED_EVENT}
  * via `invocationId`.
  */
-export declare const JIRA_WORK_ITEMS_CREATING_EVENT: "jira-work-items-creating";
+export declare const JIRA_WORK_ITEMS_CREATING_EVENT: 'jira-work-items-creating';
 export type JiraWorkItemCreatingDraft = {
     /** Skill invocation id of this draft; used as the optimistic row's stable id. */
     invocationId: string;
     /** Draft summary, used to render the optimistic row immediately. */
     summary: string;
+    /** Optional Issue type of this draft, used to render the optimistic row's issue-type icon immediately. */
+    issueType?: {
+        id: string;
+        name: string;
+        iconUrl: string;
+    };
 };
 export type JiraWorkItemsCreatingPayload = PayloadCore<typeof JIRA_WORK_ITEMS_CREATING_EVENT, {
     /**
@@ -642,7 +663,7 @@ export type JiraWorkItemsCreatingPayload = PayloadCore<typeof JIRA_WORK_ITEMS_CR
     /** Draft work items submitted for creation (parents and their children, flattened). */
     draftWorkItems: JiraWorkItemCreatingDraft[];
 }>;
-export declare const JIRA_WORK_ITEMS_CREATED_EVENT: "jira-work-items-created";
+export declare const JIRA_WORK_ITEMS_CREATED_EVENT: 'jira-work-items-created';
 export type JiraWorkItemsCreatedPayload = PayloadCore<typeof JIRA_WORK_ITEMS_CREATED_EVENT, {
     /** Identifies the batch; matches the {@link JIRA_WORK_ITEMS_CREATING_EVENT} `invocationId`. */
     invocationId: string;
@@ -654,7 +675,7 @@ export type JiraWorkItemsCreatedPayload = PayloadCore<typeof JIRA_WORK_ITEMS_CRE
  * {@link JIRA_WORK_ITEMS_CREATING_EVENT}. Subscribers use `invocationId` to revert any optimistic
  * rows they rendered for that batch.
  */
-export declare const JIRA_WORK_ITEMS_CREATE_FAILED_EVENT: "jira-work-items-create-failed";
+export declare const JIRA_WORK_ITEMS_CREATE_FAILED_EVENT: 'jira-work-items-create-failed';
 export type JiraWorkItemsCreateFailedPayload = PayloadCore<typeof JIRA_WORK_ITEMS_CREATE_FAILED_EVENT, {
     /** Identifies the batch; matches the {@link JIRA_WORK_ITEMS_CREATING_EVENT} `invocationId` to revert its optimistic rows. */
     invocationId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/rovo-triggers",
-	"version": "10.2.0",
+	"version": "10.4.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": {
@@ -28,7 +28,7 @@
 	],
 	"atlaskit:src": "src/index.ts",
 	"dependencies": {
-		"@atlaskit/adf-schema": "^56.1.0",
+		"@atlaskit/adf-schema": "^56.6.0",
 		"@atlaskit/platform-feature-flags": "^2.1.0",
 		"@atlaskit/react-compiler-gating": "^0.2.0",
 		"@babel/runtime": "^7.0.0",
@@ -41,9 +41,10 @@
 		"@af/integration-testing": "workspace:^",
 		"@af/visual-regression": "workspace:^",
 		"@atlaskit/css": "^1.0.0",
-		"@atlaskit/primitives": "^22.1.0",
+		"@atlaskit/primitives": "^22.2.0",
 		"@atlaskit/ssr": "workspace:^",
-		"@atlassian/a11y-jest-testing": "^0.13.0",
+		"@atlassian/a11y-jest-testing": "^0.14.0",
+		"@atlassian/conversation-assistant-service-api": "^15.1.0",
 		"@atlassian/feature-flags-test-utils": "^1.2.0",
 		"@testing-library/react": "^16.3.0",
 		"react": "^18.2.0",