@atlaskit/rovo-triggers 10.11.0 → 10.13.0

package/CHANGELOG.md

@@ -1,5 +1,87 @@
 # @atlaskit/rovo-triggers
 
+## 10.13.0
+
+### Minor Changes
+
+- [`a1e550aeb47f4`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/a1e550aeb47f4) -
+  Add an experiment-gated "Search conversations" entry point next to New chat in the Rovo chat side
+  navigation (both the full-page chat sidebar and the appified Home "Your chats" section) that opens
+  the All Conversations view. Clicking it deselects any active space so the conversation list is
+  shown, opens the list via the live navigation handler (so it works even when the chat app is
+  already mounted), and sets a one-shot intent that focuses the All Conversations search input the
+  next time it mounts. The entry point is behind the `townsquare_rovo_chat_search_button_exp`
+  Statsig experiment, read via `expVal(..., 'isEnabled', false)` so exposure is recorded on
+  evaluation; only the Search conversations entry point and its focus intent are enabled for
+  treatment.
+
+  This adds new public API to four published packages (hence `minor`):
+  - `@atlassian/rovo-navigation` — new optional `onSearchChatsClick` prop on the side navigation.
+    When provided, a search `IconButton` is rendered next to the "New chat" action on the Chats
+    header; when omitted, nothing changes.
+  - `@atlassian/conversation-assistant-store` — new exported `useShouldFocusChatSearchSelector` hook
+    for reading the one-shot "focus the All Conversations search input" intent.
+  - `@atlaskit/rovo-triggers` — new `all-conversations` `RovoChatPathway` value and matching
+    `AllConversationsParams` member of `RovoChatParams`, allowing callers to deep-link to All
+    Conversations.
+  - `@atlassian/conversation-assistant` — new `openAllConversations` navigation action, allowing
+    distinct entry points to retain their own telemetry.
+
+  Usage:
+
+  ```tsx
+  import { RovoSideNavigation } from '@atlassian/rovo-navigation';
+  import { useRovoNavigation } from '@atlassian/conversation-assistant';
+  import {
+  	useShouldFocusChatSearchSelector,
+  	useUIStoreActions,
+  } from '@atlassian/conversation-assistant-store/controllers/ui-store';
+  import type { RovoChatParams } from '@atlaskit/rovo-triggers/params-types';
+
+  const { openAllConversations } = useRovoNavigation({ assistanceServiceParams });
+  const { setShouldFocusChatSearch } = useUIStoreActions();
+  const handleSearchChats = () => {
+  	setShouldFocusChatSearch(true);
+  	openAllConversations();
+  };
+
+  // Render the Search conversations entry point next to New chat:
+  <RovoSideNavigation onSearchChatsClick={handleSearchChats} />;
+
+  // Consume the one-shot focus intent where the search input mounts:
+  const [{ shouldFocusChatSearch }] = useShouldFocusChatSearchSelector();
+
+  // Deep-link into All Conversations:
+  const params: RovoChatParams = { pathway: 'all-conversations' };
+  ```
+
+## 10.12.0
+
+### Minor Changes
+
+- [`6b25a30a1f55f`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/6b25a30a1f55f) -
+  Add the agent-mention run-state bridge (EDITOR-8549): a store, keyed by the run's
+  `conversationId`, that makes live Rovo agent run-state readable outside chat and ties it back to
+  the invoking agent-mention node (whose `localId` rides on the record). It is fed from the existing
+  chat/message stream, with no new connection. A run is only tracked once it has been seeded at send
+  time, which happens only for mention-invoked runs behind the `platform_editor_agent_state_bridge`
+  experiment, so it stays inert otherwise. Adds an optional `invokedByNodeLocalId` to the `chat-new`
+  trigger payload.
+
+  Read run-state from `@atlassian/conversation-assistant-store/controllers/agent-mention-run-state`,
+  keyed by conversation (the run's identity) or by the invoking mention node:
+
+  ```tsx
+  import {
+  	useAgentRunStateForConversation,
+  	useAgentRunStateForNode,
+  } from '@atlassian/conversation-assistant-store/controllers/agent-mention-run-state';
+
+  const byConversation = useAgentRunStateForConversation(conversationId);
+  const byNode = useAgentRunStateForNode(nodeLocalId);
+  // 'thinking' | 'working' | 'editing' | 'needs-input' | 'done' | 'failed' | 'blocked' | undefined
+  ```
+
 ## 10.11.0
 
 ### Minor Changes

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

@@ -1,4 +1,4 @@
-export type RovoChatPathway = 'chat' | 'agents-browse' | 'agents-create' | 'pulse' | 'remix';
+export type RovoChatPathway = 'chat' | 'agents-browse' | 'agents-create' | 'pulse' | 'remix' | 'all-conversations';
 export type RovoChatOpenMode = 'sidebar' | 'mini-modal' | 'full-screen-modal';
 export interface BaseRovoChatParams {
     pathway: RovoChatPathway;
@@ -25,5 +25,6 @@ type AgentBrowseParams = RovoParams<'agents-browse'>;
 type AgentCreateParams = RovoParams<'agents-create'>;
 type PulseParams = RovoParams<'pulse'>;
 type RemixParams = RovoParams<'remix'>;
-export type RovoChatParams = Partial<ChatParams | AgentCreateParams | AgentBrowseParams | PulseParams | RemixParams>;
+type AllConversationsParams = RovoParams<'all-conversations'>;
+export type RovoChatParams = Partial<ChatParams | AgentCreateParams | AgentBrowseParams | PulseParams | RemixParams | AllConversationsParams>;
 export {};

package/dist/types/types.d.ts

@@ -143,6 +143,11 @@ export type ChatNewPayload = PayloadCore<'chat-new', {
     agentIdentityAccountId?: string;
     /** Identifies the product surface that launched the conversation for analytics attribution. */
     chatEntryPoint?: ChatEntryPoint;
+    /**
+     * The `localId` of the agent-mention node that invoked this run. Threaded through so the
+     * agent-run-state bridge can key live run-state back to the node.
+     */
+    invokedByNodeLocalId?: string;
 } & Partial<TargetAgentParam> & PlaceholderParam>;
 export type RovoSpaceEntryPoint = 'leftNav' | 'sidebar' | 'zeroQuery' | 'typeahead' | 'inChatRecommendation';
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/rovo-triggers",
-	"version": "10.11.0",
+	"version": "10.13.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": {