@atlaskit/rovo-triggers 10.11.0 → 10.12.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @atlaskit/rovo-triggers
 
+## 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/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.12.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": {