@atlaskit/rovo-triggers 7.6.0 → 7.7.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @atlaskit/rovo-triggers
 
+## 7.7.0
+
+### Minor Changes
+
+- [`fabc8bad29d1e`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/fabc8bad29d1e) -
+  Add an `insights-open-in-chat` rovo-trigger so Rovo Insights opened from outside the conversation
+  assistant panel (e.g. the home insights carousel) reuse the same seeded-chat experience as
+  clicking an insight inside the in-panel insights feed.
+  - `@atlaskit/rovo-triggers`: add the `InsightsOpenInChatPayload` event type (carries the insight
+    ADF, conversation title, serializable icon string keys, and follow-ups).
+  - `@atlassian/rovo-growth-pulse`: extract the insight icon/appearance resolvers into a shared
+    `ui/insights-feed/resolveInsightIcon` module (new subpath export) and add optional
+    `iconKey`/`iconColor` raw API string fields to `InsightItem` so consumers can re-resolve icons.
+    `InsightReadyHostMeta.backButtonLabel` is now optional (the host supplies the standardized
+    label).
+  - `@atlassian/conversation-assistant`: extract the insight seeding logic into a shared
+    `useSeedInsightConversation` hook (used by both the in-panel feed and the new trigger) and
+    handle the `insights-open-in-chat` trigger in `PubSubListener`, gated behind the
+    `rovo_growth_chat_pulse` experiment.
+
 ## 7.6.0
 
 ### Minor Changes

package/chat-context/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/common/utils/chat-context/index.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/common/utils/chat-context/index.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/common/utils/chat-context/index.d.ts"
 }

package/chat-context/types/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../../dist/types/common/utils/chat-context/types.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../../dist/types-ts4.5/common/utils/chat-context/types.d.ts"
-      ]
-    }
-  }
+  "types": "../../dist/types/common/utils/chat-context/types.d.ts"
 }

package/dist/cjs/types.js

@@ -14,6 +14,20 @@ var Topics = exports.Topics = {
 
 // Can only specify either `agentId` or `agentExternalConfigReference`, not both
 
+/**
+ * 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
+ * InsightsFeed (seeded ADF agent message, insight header icon/title, seeded
+ * follow-ups, and a back-to-pulse override).
+ *
+ * Published by surfaces that render insights outside the panel (e.g. the home
+ * insights carousel). All fields are serializable: the icon is carried as the
+ * raw API string keys (`iconKey`/`iconColor`) and re-resolved panel-side via
+ * `resolveInsightIcon`/`resolveInsightIconAppearance`, since React components
+ * cannot cross the event bus. The standardized back-button label is owned
+ * panel-side and is intentionally not part of this payload.
+ */
+
 /** Partial database context for iframe updates (e.g. selection-only). */
 
 // Not using the PayloadCore because the `data: type | undefined` is necessary

package/dist/es2019/types.js

@@ -8,6 +8,20 @@ export const Topics = {
 
 // Can only specify either `agentId` or `agentExternalConfigReference`, not both
 
+/**
+ * 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
+ * InsightsFeed (seeded ADF agent message, insight header icon/title, seeded
+ * follow-ups, and a back-to-pulse override).
+ *
+ * Published by surfaces that render insights outside the panel (e.g. the home
+ * insights carousel). All fields are serializable: the icon is carried as the
+ * raw API string keys (`iconKey`/`iconColor`) and re-resolved panel-side via
+ * `resolveInsightIcon`/`resolveInsightIconAppearance`, since React components
+ * cannot cross the event bus. The standardized back-button label is owned
+ * panel-side and is intentionally not part of this payload.
+ */
+
 /** Partial database context for iframe updates (e.g. selection-only). */
 
 // Not using the PayloadCore because the `data: type | undefined` is necessary

package/dist/esm/types.js

@@ -8,6 +8,20 @@ export var Topics = {
 
 // Can only specify either `agentId` or `agentExternalConfigReference`, not both
 
+/**
+ * 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
+ * InsightsFeed (seeded ADF agent message, insight header icon/title, seeded
+ * follow-ups, and a back-to-pulse override).
+ *
+ * Published by surfaces that render insights outside the panel (e.g. the home
+ * insights carousel). All fields are serializable: the icon is carried as the
+ * raw API string keys (`iconKey`/`iconColor`) and re-resolved panel-side via
+ * `resolveInsightIcon`/`resolveInsightIconAppearance`, since React components
+ * cannot cross the event bus. The standardized back-button label is owned
+ * panel-side and is intentionally not part of this payload.
+ */
+
 /** Partial database context for iframe updates (e.g. selection-only). */
 
 // Not using the PayloadCore because the `data: type | undefined` is necessary

package/dist/types/types.d.ts

@@ -107,6 +107,33 @@ export type ChatNewPayload = PayloadCore<'chat-new', {
      */
     tags?: string[];
 } & Partial<TargetAgentParam> & PlaceholderParam>;
+/**
+ * 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
+ * InsightsFeed (seeded ADF agent message, insight header icon/title, seeded
+ * follow-ups, and a back-to-pulse override).
+ *
+ * Published by surfaces that render insights outside the panel (e.g. the home
+ * insights carousel). All fields are serializable: the icon is carried as the
+ * raw API string keys (`iconKey`/`iconColor`) and re-resolved panel-side via
+ * `resolveInsightIcon`/`resolveInsightIconAppearance`, since React components
+ * cannot cross the event bus. The standardized back-button label is owned
+ * panel-side and is intentionally not part of this payload.
+ */
+export type InsightsOpenInChatPayload = PayloadCore<'insights-open-in-chat', {
+    /** Stringified ADF JSON for the insight detail — seeded as the agent message. */
+    adf: string;
+    /** Conversation name / header title. */
+    conversationTitle: string;
+    /** Raw API `icon` string key (e.g. `'lightbulb'`), re-resolved panel-side. */
+    iconKey: string;
+    /** Raw API `color` string key (e.g. `'blueBold'`), re-resolved panel-side. */
+    iconColor: string;
+    /** Insight category (e.g. group category), used for click analytics attribution. */
+    insightCategory: string;
+    /** Follow-up prompt strings to seed into the conversation. */
+    followUps?: string[] | null;
+}>;
 export type EditorContextPayloadData = {
     document: {
         type: 'text/markdown' | 'text/adf';
@@ -485,7 +512,7 @@ export type SmartlinksSubscriptionChangedPayload = PayloadCore<'smartlinks-subsc
     openChat: false;
     isActive: boolean;
 };
-export type Payload = MessageSendPayload | ChatClosePayload | SmartCreationModalOpenPayload | ChatNewPayload | ChatDraftPayload | ChatSmartLink3PPostAuthLaunchPayload | EditorContextPayload | ChatOpenPayload | OpenBrowseAgentPayload | SmartlinksSubscriptionChangedPayload | OpenBrowseAgentSidebarPayload | EditorSuggestionPayload | EditorAgentChangedPayload | BrowserContextPayload | WhiteboardContextPayload | JiraCreateContextPayload | JiraInlineAgentCreationAgentAssignedPayload | DatabaseContextPayload | ForgeAppAuthSuccess | ForgeAppAuthFailure | JiraWorkflowWizardActionsPayload | InsertPromptPayload | DashboardInsightsActionsPayload | SetChatContextPayload | InsertUrlsPayload | SelectActionPayload | AddChartToDashboardPayload | GenericExternalActionErrorPayload | OpenChatDebugModalPayload | OpenChatFeedbackModalPayload | JsmJourneyBuilderActionsPayload | StudioAutomationBuildUpdatePayload | SolutionArchitectHandoffPayload | SolutionPlanStateUpdatePayload | SolutionDraftAgentUpdatePayload | SolutionArchitectAgentActivationPayload | SolutionArchitectAgentActivationFlowStartedPayload | SolutionArchitectAgentActivationFlowStoppedPayload | UpdateAgentConfigurationPayload | StudioLandingPageRedirectPayload | UploadAndInsertMediaPayload | SmartLinksContextPayload | SpaceSelectedPayload | SpaceDeselectedPayload | RecommendedSpacesSelectedPayload | TaskPlanConfirmedPayload | TaskAskQuestionRenderedPayload | TaskPlanRenderedPayload | TaskSkipAllQuestionsPayload | TaskCancelPlanPayload | TaskAskQuestionConfirmedPayload | TaskModifyPlanRequestedPayload | TaskModifyPlanSubmittedPayload;
+export type Payload = MessageSendPayload | ChatClosePayload | SmartCreationModalOpenPayload | ChatNewPayload | InsightsOpenInChatPayload | ChatDraftPayload | ChatSmartLink3PPostAuthLaunchPayload | EditorContextPayload | ChatOpenPayload | OpenBrowseAgentPayload | SmartlinksSubscriptionChangedPayload | OpenBrowseAgentSidebarPayload | EditorSuggestionPayload | EditorAgentChangedPayload | BrowserContextPayload | WhiteboardContextPayload | JiraCreateContextPayload | JiraInlineAgentCreationAgentAssignedPayload | DatabaseContextPayload | ForgeAppAuthSuccess | ForgeAppAuthFailure | JiraWorkflowWizardActionsPayload | InsertPromptPayload | DashboardInsightsActionsPayload | SetChatContextPayload | InsertUrlsPayload | SelectActionPayload | AddChartToDashboardPayload | GenericExternalActionErrorPayload | OpenChatDebugModalPayload | OpenChatFeedbackModalPayload | JsmJourneyBuilderActionsPayload | StudioAutomationBuildUpdatePayload | SolutionArchitectHandoffPayload | SolutionPlanStateUpdatePayload | SolutionDraftAgentUpdatePayload | SolutionArchitectAgentActivationPayload | SolutionArchitectAgentActivationFlowStartedPayload | SolutionArchitectAgentActivationFlowStoppedPayload | UpdateAgentConfigurationPayload | StudioLandingPageRedirectPayload | UploadAndInsertMediaPayload | SmartLinksContextPayload | SpaceSelectedPayload | SpaceDeselectedPayload | RecommendedSpacesSelectedPayload | TaskPlanConfirmedPayload | TaskAskQuestionRenderedPayload | TaskPlanRenderedPayload | TaskSkipAllQuestionsPayload | TaskCancelPlanPayload | TaskAskQuestionConfirmedPayload | TaskModifyPlanRequestedPayload | TaskModifyPlanSubmittedPayload;
 export type TaskPlanConfirmedPayload = PayloadCore<'task-plan-confirmed', {
     conversationId: string;
     planTitle: string;

package/jsm-journey-builder-types/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/common/types/jsm-journey-builder/index.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/common/types/jsm-journey-builder/index.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/common/types/jsm-journey-builder/index.d.ts"
 }

package/main/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/main.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/main.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/main.d.ts"
 }

package/package.json

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

package/params/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/common/utils/params/index.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/common/utils/params/index.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/common/utils/params/index.d.ts"
 }

package/params-types/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/common/utils/params/types.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/common/utils/params/types.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/common/utils/params/types.d.ts"
 }

package/post-message-to-pubsub/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/common/utils/post-message-to-pubsub/index.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/common/utils/post-message-to-pubsub/index.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/common/utils/post-message-to-pubsub/index.d.ts"
 }

package/solution-architect-types/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/common/types/solution-architect/index.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/common/types/solution-architect/index.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/common/types/solution-architect/index.d.ts"
 }

package/types/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/types.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/types.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/types.d.ts"
 }

package/dist/types-ts4.5/common/types/agent/index.d.ts

@@ -1,7 +0,0 @@
-import type { PayloadCore } from '../../../types';
-export type SolutionDraftAgentUpdatePayload = PayloadCore<'solution-draft-agent-update'> & {
-    data: {
-        buildId: string;
-        draftContent: string;
-    };
-};

package/dist/types-ts4.5/common/types/jsm-journey-builder/index.d.ts

@@ -1,11 +0,0 @@
-import type { PayloadCore } from '../../../types';
-export type JsmJourneyBuilderAgentAction = {
-    actionType: 'CREATE_JOURNEY' | 'UPDATE_JOURNEY' | 'DELETE_JOURNEY';
-    journeyId: string;
-    success: boolean;
-};
-export type JsmJourneyBuilderActionsPayload = PayloadCore<'jsm-journey-builder-actions', {
-    invocationId?: string;
-    conversationId?: string;
-    agentActions: JsmJourneyBuilderAgentAction[];
-}>;

package/dist/types-ts4.5/common/types/solution-architect/index.d.ts

@@ -1,59 +0,0 @@
-import type { PayloadCore } from '../../../types';
-type BaseHandoffPayload = {
-    conversationId: string;
-};
-export type AutomationHandoffPayload = BaseHandoffPayload & {
-    type: 'AUTOMATION_RULE';
-    ari?: never;
-    buildId: string;
-    appBuilderAutoStart?: never;
-    shouldActivateAgent?: never;
-};
-export type AgentHandoffPayload = BaseHandoffPayload & {
-    type: 'ROVO_AGENT';
-    ari?: string | null | undefined;
-    buildId: string;
-    appBuilderAutoStart?: never;
-    shouldActivateAgent?: boolean;
-};
-export type AppHandoffPayload = BaseHandoffPayload & {
-    type: 'ECOSYSTEM_APP';
-    ari: string;
-    buildId?: never;
-    appBuilderAutoStart: boolean;
-    shouldActivateAgent?: never;
-};
-export type SolutionArchitectHandoffPayload = PayloadCore<'solution-architect-handoff'> & {
-    data: AutomationHandoffPayload | AppHandoffPayload | AgentHandoffPayload;
-};
-export type SolutionPlanStateUpdatePayload = PayloadCore<'solution-plan-state-updated'>;
-export type SolutionArchitectAgentActivationPayload = PayloadCore<'solution-architect-agent-activation', {
-    draftBuildId: string;
-    ari?: string | null | undefined;
-}>;
-export type SolutionArchitectAgentActivationFlowStartedPayload = PayloadCore<'solution-architect-agent-activation-flow-started', {
-    draftBuildId: string;
-}>;
-export type SolutionArchitectAgentActivationFlowStoppedPayload = PayloadCore<'solution-architect-agent-activation-flow-stopped', {
-    draftBuildId: string;
-}>;
-export type StudioAutomationBuildUpdatePayload = PayloadCore<'studio-automation-build-updated', {
-    buildId: string;
-}>;
-export type AutomationRuleUpdatePayload = PayloadCore<'automation-rule-update'> & {
-    data: {
-        rule: string;
-    };
-};
-export type UpdateAgentConfigurationPayload = PayloadCore<'agent-configuration-update'> & {
-    data: {
-        ari: string;
-    };
-};
-export type StudioLandingPageRedirectPayload = PayloadCore<'studio-landing-page-redirect'> & {
-    data: {
-        ari: string;
-        prompt: string;
-    };
-};
-export {};

package/dist/types-ts4.5/common/utils/chat-context/index.d.ts

@@ -1 +0,0 @@
-export type { ChatContextState, ChatContextPayload } from './types';

package/dist/types-ts4.5/common/utils/chat-context/types.d.ts

@@ -1,7 +0,0 @@
-export type ChatContextState = {
-    [contextKey: string]: unknown;
-};
-export type ChatContextPayload = {
-    contextKey: string;
-    setContext: <T>(chatContext: T) => T;
-};

package/dist/types-ts4.5/common/utils/params/constants.d.ts

@@ -1,3 +0,0 @@
-import { type ValidParam, type ValidPrefix } from './types';
-export declare const ROVO_PARAM_PREFIX: ValidPrefix;
-export declare const ROVO_VALID_PARAMS: ValidParam[];

package/dist/types-ts4.5/common/utils/params/index.d.ts

@@ -1,15 +0,0 @@
-import { type RovoChatParams, type ValidParam } from './types';
-export declare const firstCharUpper: (str: string) => string;
-export declare const firstCharLower: (str: string) => string;
-export declare const addPrefix: (param: ValidParam) => string;
-export declare const removePrefix: (param: string) => string;
-export declare const getRovoParams: (url?: string) => RovoChatParams;
-export declare const updatePageRovoParams: (params: RovoChatParams) => void;
-export declare const addRovoParamsToUrl: (url: string, params: RovoChatParams) => string;
-export declare const encodeRovoParams: (params: RovoChatParams, encodeAsObject?: boolean) => string | {
-    [key: string]: string;
-};
-export declare const assertOnlySpecificFieldsDefined: (params: RovoChatParams, fields: (keyof RovoChatParams)[]) => boolean;
-export declare const getListOfRovoParams: ({ resourceRouterQuery, }?: {
-    resourceRouterQuery?: boolean | undefined;
-}) => string[];

package/dist/types-ts4.5/common/utils/params/types.d.ts

@@ -1,28 +0,0 @@
-export type RovoChatPathway = 'chat' | 'agents-browse' | 'agents-create' | 'pulse';
-export type RovoChatOpenMode = 'sidebar' | 'mini-modal';
-export interface BaseRovoChatParams {
-    pathway: RovoChatPathway;
-    agentId: string;
-    conversationId: string;
-    prompt: string;
-    cloudId: string;
-    triggerOpen: boolean;
-    initiator: string;
-    insertPrompt: 'highlight-action';
-    stagingAreaOpen: boolean;
-    messageIdSelectedForPreview: string;
-    promptLibraryOpen: boolean;
-    openChatMode: RovoChatOpenMode;
-}
-export type ValidPrefix = 'rovoChat';
-export type ValidParam = keyof BaseRovoChatParams;
-export type ValidPrefixedParam = `${ValidPrefix}${ValidParam}`;
-type RovoParams<T extends RovoChatPathway, P = object> = BaseRovoChatParams & {
-    pathway: T;
-} & P;
-type ChatParams = RovoParams<'chat'>;
-type AgentBrowseParams = RovoParams<'agents-browse'>;
-type AgentCreateParams = RovoParams<'agents-create'>;
-type PulseParams = RovoParams<'pulse'>;
-export type RovoChatParams = Partial<ChatParams | AgentCreateParams | AgentBrowseParams | PulseParams>;
-export {};

package/dist/types-ts4.5/common/utils/post-message-to-pubsub/index.d.ts

@@ -1,19 +0,0 @@
-import { type Payload } from '../../../types';
-export declare const ROVO_POST_MESSAGE_EVENT_TYPE = "rovo-post-message";
-export declare const ROVO_POST_MESSAGE_ACK_EVENT_TYPE = "rovo-post-message-ack";
-export declare const isAllowedOrigin: (origin: string | undefined) => boolean;
-export declare const RovoPostMessagePubsubListener: () => null;
-/**
- * Hook to send a publish event to parent iframe using postMessage
- * Only supports 1 pubsub event at a time and waits for acknowledgment or timed out
- */
-export declare const useRovoPostMessageToPubsub: () => {
-    publishWithPostMessage: ({ targetWindow, payload, onAcknowledgeTimeout, }: {
-        targetWindow?: Window;
-        payload: Payload;
-        onAcknowledgeTimeout: (params: {
-            payload: Payload;
-        }) => void;
-    }) => void;
-    isWaitingForAck: boolean;
-};

package/dist/types-ts4.5/index.d.ts

@@ -1,8 +0,0 @@
-export { usePublish, useSubscribe, useSubscribeAll, Subscriber } from './main';
-export type { Payload, Callback, Topic, WorkflowContextPayloadData, EditorContextPayloadData, WhiteboardContextPayloadData, SlidesContextPayloadData, BrowserContextPayloadData, DatabaseContextPayloadData, DatabaseContextUpdatePayloadData, DatabaseContextPayload, AddStatusRovoPayload, UpdateStatusRovoPayload, DeleteStatusRovoPayload, AddNewTransitionRovoPayload, UpdateTransitionRovoPayload, DeleteTransitionRovoPayload, DeleteTransitionRovoPayloadOld, AddRuleRovoPayload, UpdateRuleRovoPayload, DeleteRuleRovoPayload, JiraWorkflowWizardAction, DashboardInsightsActionsPayload, DashboardInsightsActionsPayloadData, OpenChatDebugModalPayload, OpenChatFeedbackModalPayload, SelectActionPayload, SmartLinksContextPayload, } from './types';
-export type { SolutionArchitectHandoffPayload, AutomationHandoffPayload, AgentHandoffPayload, AppHandoffPayload, SolutionArchitectAgentActivationPayload, StudioAutomationBuildUpdatePayload, } from './common/types/solution-architect';
-export type { JsmJourneyBuilderActionsPayload, JsmJourneyBuilderAgentAction, } from './common/types/jsm-journey-builder';
-export { getRovoParams, updatePageRovoParams, addRovoParamsToUrl, assertOnlySpecificFieldsDefined, encodeRovoParams, getListOfRovoParams, } from './common/utils/params';
-export type { RovoChatParams, RovoChatPathway } from './common/utils/params/types';
-export { useRovoPostMessageToPubsub, RovoPostMessagePubsubListener, } from './common/utils/post-message-to-pubsub';
-export type { ChatContextState, ChatContextPayload } from './common/utils/chat-context/types';

package/dist/types-ts4.5/main.d.ts

@@ -1,17 +0,0 @@
-import type { Callback, Payload, Topic } from './types';
-interface SubscribeOptions {
-    topic: Topic;
-    triggerLatest?: boolean;
-    consumeOnceKey?: string;
-}
-export declare const useSubscribe: ({ topic, triggerLatest, consumeOnceKey }: SubscribeOptions, callback: Callback) => void;
-export declare const useSubscribeAll: (callback: Callback) => void;
-export declare const usePublish: (topic: Topic) => ((payload: Payload) => void);
-export declare const Subscriber: ({ topic, triggerLatest, onEvent, flushQueueOnUnmount, consumeOnceKey, }: {
-    topic: Topic;
-    triggerLatest?: boolean;
-    onEvent: Callback;
-    flushQueueOnUnmount?: boolean;
-    consumeOnceKey?: string;
-}) => null;
-export {};

package/dist/types-ts4.5/types.d.ts

@@ -1,555 +0,0 @@
-import type { DocNode } from '@atlaskit/adf-schema';
-import type { CreationContextParams } from '@atlassian/conversation-assistant-external-context/types';
-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';
-import type { ChatContextPayload } from './common/utils/chat-context/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";
-};
-export type Topic = (typeof Topics)[keyof typeof Topics];
-export type PayloadCore<TKey extends string, TData = void> = {
-    type: TKey;
-    source: string;
-    openChat?: boolean;
-    openChatMode?: 'sidebar' | 'mini-modal';
-    product?: string;
-    interactionSource?: string;
-    /**
-     * When true, subscribers that opt into the same consumeOnceKey should process this
-     * logical event once total. The delivery id used for deduplication is internal to
-     * rovo-triggers and is generated for each publish call.
-     */
-    consumeOnce?: boolean;
-} & (TData extends void ? {} : {
-    data: TData;
-});
-export type MessageSendPayload = PayloadCore<'message-send', {
-    prompt: string;
-    productKey?: string;
-    minionAlias?: string;
-    files?: UploadedFile[];
-}>;
-export type ChatClosePayload = PayloadCore<'chat-close', {}>;
-export type SmartCreationModalOpenPayload = PayloadCore<'open-smart-creation-modal', {
-    channelId?: string;
-    entryPoint: string;
-    stagingAreaActive: boolean;
-    isFloating: boolean;
-    shouldShowBackButton: boolean;
-}>;
-type TargetAgentParam = {
-    agentId: string;
-    agentExternalConfigReference?: never;
-} | {
-    agentId?: never;
-    agentExternalConfigReference: string;
-};
-type PlaceholderParam = {
-    placeholderType?: 'person' | 'link' | 'generic' | 'skill';
-};
-type ChatModeParam = {
-    deepResearchEnabled?: boolean;
-    thinkDeeperEnabled?: boolean;
-    fastModeEnabled?: boolean;
-    webSearchEnabled?: boolean;
-    useCurrentPageContext?: boolean;
-    appFilters?: unknown[];
-};
-export type ChatNewPayload = PayloadCore<'chat-new', {
-    name?: string;
-    dialogues: Array<{
-        human_message: {
-            content: string;
-            mimeType?: 'text/markdown' | 'text/adf';
-        };
-        agent_message: {
-            content: string;
-            mimeType?: 'text/markdown' | 'text/adf';
-        };
-    }>;
-    prompt?: string | DocNode;
-    creationContextParams?: CreationContextParams;
-    isPromptPlaceholder?: boolean;
-    files?: UploadedFile[];
-    contentContext?: 'staging-area' | 'global';
-    sourceId?: string;
-    minionAlias?: string;
-    skipCreatingSeededConversation?: boolean;
-    selectedSpace?: {
-        id: string;
-        name: string;
-        emoji?: string;
-    };
-    resetActiveMenu?: boolean;
-    mode?: ChatModeParam;
-    aiFeatureContext?: Record<string, unknown>;
-    agentVersion?: {
-        versionId?: string;
-        versionType?: string;
-        versionNumber?: number;
-    };
-    spaceId?: string;
-    /**
-     * Optional artifact representing the object the user is currently interacting with or
-     * acting on (e.g. 3P forge artifacts that are not resolvable without an ARI).
-     * Sent as `search_artifact` in `body.context`.
-     */
-    searchArtifact?: SendMessageSearchArtifact;
-    /**
-     * Optional conversation-channel tags forwarded to the backend on conversation creation.
-     * Used by the agent-mention-in-comment feature to pass mention-in-comment, page:<pageId>,
-     * and comment:<commentId> so the backend can create a SessionAssociationPublic record.
-     */
-    tags?: string[];
-} & Partial<TargetAgentParam> & PlaceholderParam>;
-export type EditorContextPayloadData = {
-    document: {
-        type: 'text/markdown' | 'text/adf';
-        content: string;
-    };
-    selection: {
-        type: 'text/markdown' | 'text/plain';
-        content: string;
-    };
-    selectionFragment?: string;
-    selectionLocalIds?: string;
-    contentMauiId?: string;
-    mediaFileId?: string;
-    dynamicUiSource?: {
-        contentType: string;
-        startLocalId?: string;
-        endLocalId?: string;
-        startIndex?: number;
-        endIndex?: number;
-        fragmentAdf?: string;
-    };
-    dynamicUiType?: string;
-    isViewMode?: boolean;
-    isDraftLockedForEditing?: boolean;
-    useGenericEditorSkill?: boolean;
-    additionalContext?: Record<string, unknown>;
-} | undefined;
-export type WhiteboardContextPayloadData = {
-    type: 'image/svg+xml' | 'text/plain';
-    content: string;
-    contentId?: string;
-    isViewMode?: boolean;
-} | undefined;
-export type SlidesContextPayloadData = {
-    xml: string;
-    contentId: string;
-    title: string;
-    url: string;
-    selectedSlideIndex: number;
-    selectedElementIds: string[];
-    isViewMode?: boolean;
-} | undefined;
-export type DatabaseContextPayloadData = {
-    contentId: string;
-    csv: string;
-    title: string;
-    url: string;
-    selectedElementIds?: string[];
-    isViewMode?: boolean;
-} | undefined;
-/** Partial database context for iframe updates (e.g. selection-only). */
-export type DatabaseContextUpdatePayloadData = Partial<NonNullable<DatabaseContextPayloadData>>;
-export type DatabaseContextPayload = PayloadCore<'database-context-payload', DatabaseContextUpdatePayloadData>;
-export type BrowserContextPayloadData = {
-    context: {
-        browserUrl: string;
-        htmlBody?: string;
-        canvasText?: string;
-    } | undefined;
-};
-export type WorkflowContextPayloadData = {
-    currentWorkflowDocument?: Record<string, unknown>;
-};
-export type JiraCreateContextPayloadData = {
-    draftWorkItems: {
-        projectIdOrKey: string;
-        issueTypeId: string;
-        summary: string;
-        fields: Record<string, unknown>;
-    }[] | null;
-};
-export type EditorContextPayload = PayloadCore<'editor-context-payload'> & {
-    data: EditorContextPayloadData;
-};
-export type BrowserContextPayload = PayloadCore<'browser-context-payload'> & {
-    data: BrowserContextPayloadData;
-};
-export type WhiteboardContextPayload = PayloadCore<'whiteboard-context-payload'> & {
-    data: WhiteboardContextPayloadData;
-};
-export type JiraCreateContextPayload = PayloadCore<'jira-create-context-payload'> & {
-    data: JiraCreateContextPayloadData;
-};
-export type ChatDraftPayload = PayloadCore<'chat-draft'>;
-export type SmartLink3PProjectContext = {
-    projectId: string;
-    projectName: string;
-    projectUrl: string;
-};
-export type SmartLink3PPostAuthProvider = 'Google Drive';
-/**
- * Experiment-scoped Smart Link post-auth launch event for
- * platform_sl_3p_post_auth_chat_open_fg / platform_sl_3p_post_auth_chat_open_exp.
- *
- * This opens Rovo Chat in mini-modal mode with custom post-auth UI, without sending
- * a prompt. If the experiment does not become permanent, remove this event type as
- * part of the experiment cleanup.
- */
-export type ChatSmartLink3PPostAuthLaunchPayload = PayloadCore<'chat-smartlink-3p-post-auth-launch', {
-    extensionKey: string;
-    provider: SmartLink3PPostAuthProvider;
-    projectContext: SmartLink3PProjectContext;
-}>;
-export type OpenBrowseAgentPayload = PayloadCore<'open-browse-agent-modal'>;
-export type OpenBrowseAgentSidebarPayload = PayloadCore<'open-browse-agent-sidebar'>;
-export type EditorSuggestionPayload = PayloadCore<'editor-suggestion', {
-    mode: 'insert' | 'replace';
-    content: string;
-    agentId?: string;
-}>;
-export type UploadAndInsertMediaPayload = PayloadCore<'upload-and-insert-media', {
-    sourceUrl: string;
-}>;
-export type EditorAgentChangedPayload = PayloadCore<'agent-changed', {
-    agent: {
-        id: string;
-        name: string;
-        identityAccountId?: string | null;
-    } | null;
-}>;
-export type ChatOpenPayload = PayloadCore<'chat-open', {
-    channelId: string;
-    agentId?: string;
-    agentName?: string;
-    agentIdentityAccountId?: string;
-    avatarUrl?: string;
-    resetActiveMenu?: boolean;
-    openAgentSelector?: boolean;
-    aiFeatureContext?: Record<string, unknown>;
-}>;
-export type ForgeAppAuthSuccess = PayloadCore<'forge-auth-success', {
-    is3pActionAuth?: boolean;
-    agentMessageId?: string;
-    authUrl?: string;
-}>;
-export type ForgeAppAuthFailure = PayloadCore<'forge-auth-failure', {
-    is3pActionAuth?: boolean;
-    errorMessage: string | undefined;
-}>;
-/** Inserts a prompt into the chat input - either:
- * - A prompt without a placeholder - sends as a message
- * - A prompt with a placeholder - inserts the prompt into the chat input
- */
-export type InsertPromptPayload = PayloadCore<'insert-prompt', {
-    prompt: string;
-    /**
-     * Optional complete ADF document to seed the chat input with instead of the plain-string
-     * `prompt`. When provided, rich nodes (skill pills, links, inline cards, mentions) are
-     * preserved rather than being flattened to text. `prompt` is still used as a fallback.
-     */
-    promptAdf?: DocNode;
-    /**
-     * Overrides the default auto-send behavior for prompts.
-     * By default, prompts with backticks (`) are inserted as placeholders into the chat input
-     * (backticks indicate a placeholder), while prompts without backticks are sent immediately.
-     * Set this to true to insert prompts not containing backticks into the chat input for dynamic
-     * user completion, rather than sending them immediately.
-     */
-    overrideAutoSend?: boolean;
-    /**
-     * Optional conversation ID to target. When provided, the handler will resume
-     * the specified conversation (setting placeholder agent, opening the channel,
-     * and selecting the conversation) before inserting or sending the prompt.
-     */
-    channelId?: string;
-    agentId?: string;
-    agentName?: string;
-    agentIdentityAccountId?: string;
-    avatarUrl?: string;
-    /**
-     * Optional files to attach to the chat input alongside the prompt.
-     * Gated by the enable_rovo_static_prompt_file_uploads experiment.
-     */
-    files?: UploadedFile[];
-} & PlaceholderParam>;
-/** Inserts URLs as inline nodes into the chat input
- * - URLs are deduplicated against existing content
- * - Formatted as inline card nodes in the editor
- * - Supports multiple card types (Jira, Confluence, Trello, etc.)
- */
-export type InsertUrlsPayload = PayloadCore<'insert-urls-into-prompt-input', {
-    urls: string[];
-}>;
-/** Selects a conversation action by ID
- * - Used to programmatically open a specific action in the conversation actions list
- * - The action screen must be already open, and the actions list populated
- * - The action must exist in the current actions list
- */
-export type SelectActionPayload = PayloadCore<'select-action', {
-    actionId: string;
-}>;
-/**
- * Result shape when a chart is added to an AVP dashboard.
- * Matches the return type of ChartApiService.addChartToDashboard().
- */
-export type AddChartToDashboardResult = {
-    chart: Record<string, unknown> | null;
-    canvasLayout: Record<string, unknown> | null;
-};
-/**
- * Fired when a chart is added to an AVP dashboard from a Rovo generated chart
- */
-export type AddChartToDashboardPayload = PayloadCore<'add-chart-to-dashboard', AddChartToDashboardResult>;
-export type TransitionId = string;
-export type StatusId = string;
-export type StatusCategory = 'TODO' | 'IN_PROGRESS' | 'DONE' | 'UNDEFINED';
-export type RuleConfig = {
-    [key: string]: string;
-};
-export type AddStatusRovoPayload = {
-    statusId: StatusId;
-    statusName: string;
-    statusCategory: StatusCategory;
-};
-export type UpdateStatusRovoPayload = {
-    oldStatusName: string;
-    oldStatusCategory: StatusCategory;
-    newStatusName: string;
-    newStatusCategory: StatusCategory;
-};
-export type DeleteStatusRovoPayload = {
-    statusId: string;
-    statusName: string;
-    statusCategory: StatusCategory;
-};
-export type AddNewTransitionRovoPayload = {
-    id: TransitionId;
-    name: string;
-    toStatusId: StatusId;
-    toStatusName: string;
-    toStatusCategory: StatusCategory;
-    links: {
-        fromStatusId: StatusId;
-        fromStatusName: string;
-        fromStatusCategory: StatusCategory;
-    }[];
-};
-export type UpdateTransitionRovoPayload = {
-    id: TransitionId;
-    name: string;
-    toStatusId: StatusId;
-    toStatusName: string;
-    toStatusCategory: StatusCategory;
-    links: {
-        fromStatusId: StatusId;
-        fromStatusName: string;
-        fromStatusCategory: StatusCategory;
-    }[];
-};
-export type DeleteTransitionRovoPayloadOld = {
-    transitionId: TransitionId;
-    transitionName: string;
-};
-export type DeleteTransitionRovoPayload = {
-    id: TransitionId;
-    name: string;
-    toStatusId: StatusId;
-    toStatusName: string;
-    toStatusCategory: StatusCategory;
-    links: {
-        fromStatusId: StatusId;
-        fromStatusName: string;
-        fromStatusCategory: StatusCategory;
-    }[];
-};
-export type AddRuleRovoPayload = {
-    ruleTemplateKey: string;
-    ruleConfig: RuleConfig;
-    ruleDescription: string;
-    transitionId: TransitionId;
-};
-export type UpdateRuleRovoPayload = {
-    ruleTemplateKey: string;
-    ruleConfig: RuleConfig;
-    transitionId: TransitionId;
-    ruleIdBeingEdited: string;
-    ruleDescription: string;
-};
-export type DeleteRuleRovoPayload = {
-    ruleId: string;
-    ruleTemplateKey: string;
-    ruleDescription: string;
-    transitionId: TransitionId;
-};
-export type RedirectToWorkflowRovoPayload = {
-    conversationId: string;
-    url: string;
-};
-export type JiraWorkflowWizardAction = {
-    operationType: 'ADD_STATUS';
-    payload: AddStatusRovoPayload;
-} | {
-    operationType: 'UPDATE_STATUS';
-    payload: UpdateStatusRovoPayload;
-} | {
-    operationType: 'DELETE_STATUS';
-    payload: DeleteStatusRovoPayload;
-} | {
-    operationType: 'ADD_TRANSITION';
-    payload: AddNewTransitionRovoPayload;
-} | {
-    operationType: 'UPDATE_TRANSITION';
-    payload: UpdateTransitionRovoPayload;
-} | {
-    operationType: 'DELETE_TRANSITION';
-    payload: DeleteTransitionRovoPayloadOld | DeleteTransitionRovoPayload;
-} | {
-    operationType: 'ADD_RULE';
-    payload: AddRuleRovoPayload;
-} | {
-    operationType: 'UPDATE_RULE';
-    payload: UpdateRuleRovoPayload;
-} | {
-    operationType: 'DELETE_RULE';
-    payload: DeleteRuleRovoPayload;
-} | {
-    operationType: 'REDIRECT_TO_WORKFLOW';
-    payload: RedirectToWorkflowRovoPayload;
-};
-export type JiraWorkflowWizardActionsPayload = PayloadCore<'jira-workflow-wizard-actions', {
-    invocationId?: string;
-    operations?: JiraWorkflowWizardAction[];
-    currentWorkflowDocument?: Record<string, unknown>;
-}>;
-type MessageDescriptorWithValues = {
-    id?: string;
-    description?: string | object;
-    defaultMessage?: string;
-    messageValues?: Record<string, string | number | boolean | null | undefined | Date>;
-};
-export type GenericExternalActionErrorPayload = PayloadCore<'generic-external-action-error', {
-    invocationId: string;
-    errors: (string | MessageDescriptorWithValues)[];
-}>;
-export type DashboardInsightsActionsPayload = PayloadCore<'dashboard-insights-actions'> & {
-    data?: DashboardInsightsActionsPayloadData;
-};
-export type DashboardInsightsActionsPayloadData = {
-    content: string;
-} | undefined;
-export type SetChatContextPayload = PayloadCore<'set-message-context', ChatContextPayload>;
-export type OpenChatDebugModalPayload = PayloadCore<'open-chat-debug-modal'>;
-export type OpenChatFeedbackModalPayload = PayloadCore<'open-chat-feedback-modal', {
-    answerQuality: 'good' | 'bad' | 'general';
-}>;
-export type SmartLinksContextPayload = PayloadCore<'smartlinks-context-payload'> & {
-    /** Never opens chat — internal signal only. */
-    openChat: false;
-    data?: Array<{
-        /**
-         * ORS auth key from meta.auth[0].key (e.g. 'gdrive', 'notion', 'miro').
-         * Matches the `serviceKey` query param in Knowledge API outboundAuthUrl,
-         * enabling the chat to cross-reference with Knowledge API without a mapping table.
-         */
-        orsAuthKey: string;
-        /**
-         * Human-readable provider name from ORS generator (e.g. 'Google Drive', 'Slack').
-         * Available regardless of SmartLinks auth state — matched against connector friendlyName.
-         */
-        generatorName?: string;
-        /** Number of occurrences on the page — used for ranking in the banner. */
-        count: number;
-    }>;
-};
-/** Published by the consumer hook to notify the publisher whether it should fetch SmartLinks. */
-export type SpaceSelectedPayload = PayloadCore<'space-selected', {
-    spaceId: string;
-    title: string;
-    emoji: string;
-    description?: string;
-}>;
-export type SpaceDeselectedPayload = PayloadCore<'space-deselected'>;
-export type RecommendedSpacesSelectedPayload = PayloadCore<'recommended-spaces-selected'>;
-export type SmartlinksSubscriptionChangedPayload = PayloadCore<'smartlinks-subscription-changed'> & {
-    /** Never opens chat — internal signal only. */
-    openChat: false;
-    isActive: boolean;
-};
-export type Payload = MessageSendPayload | ChatClosePayload | SmartCreationModalOpenPayload | ChatNewPayload | ChatDraftPayload | ChatSmartLink3PPostAuthLaunchPayload | EditorContextPayload | ChatOpenPayload | OpenBrowseAgentPayload | SmartlinksSubscriptionChangedPayload | OpenBrowseAgentSidebarPayload | EditorSuggestionPayload | EditorAgentChangedPayload | BrowserContextPayload | WhiteboardContextPayload | JiraCreateContextPayload | JiraInlineAgentCreationAgentAssignedPayload | DatabaseContextPayload | ForgeAppAuthSuccess | ForgeAppAuthFailure | JiraWorkflowWizardActionsPayload | InsertPromptPayload | DashboardInsightsActionsPayload | SetChatContextPayload | InsertUrlsPayload | SelectActionPayload | AddChartToDashboardPayload | GenericExternalActionErrorPayload | OpenChatDebugModalPayload | OpenChatFeedbackModalPayload | JsmJourneyBuilderActionsPayload | StudioAutomationBuildUpdatePayload | SolutionArchitectHandoffPayload | SolutionPlanStateUpdatePayload | SolutionDraftAgentUpdatePayload | SolutionArchitectAgentActivationPayload | SolutionArchitectAgentActivationFlowStartedPayload | SolutionArchitectAgentActivationFlowStoppedPayload | UpdateAgentConfigurationPayload | StudioLandingPageRedirectPayload | UploadAndInsertMediaPayload | SmartLinksContextPayload | SpaceSelectedPayload | SpaceDeselectedPayload | RecommendedSpacesSelectedPayload | TaskPlanConfirmedPayload | TaskAskQuestionRenderedPayload | TaskPlanRenderedPayload | TaskSkipAllQuestionsPayload | TaskCancelPlanPayload | TaskAskQuestionConfirmedPayload | TaskModifyPlanRequestedPayload | TaskModifyPlanSubmittedPayload;
-export type TaskPlanConfirmedPayload = PayloadCore<'task-plan-confirmed', {
-    conversationId: string;
-    planTitle: string;
-}>;
-export type TaskAskQuestionRenderedPayload = PayloadCore<'task-ask-question-rendered', {
-    conversationId: string;
-    invocationId: string;
-}>;
-export type TaskPlanRenderedPayload = PayloadCore<'task-plan-rendered', {
-    conversationId: string;
-    invocationId: string;
-}>;
-export type TaskSkipAllQuestionsPayload = PayloadCore<'task-skip-all-questions', {
-    conversationId: string;
-    invocationId: string;
-}>;
-export type TaskAskQuestionConfirmedPayload = PayloadCore<'task-ask-question-confirmed', {
-    conversationId: string;
-    invocationId: string;
-}>;
-export type TaskCancelPlanPayload = PayloadCore<'task-cancel-plan', {
-    conversationId: string;
-    invocationId: string;
-}>;
-export type TaskModifyPlanRequestedPayload = PayloadCore<'task-modify-plan-requested', {
-    conversationId: string;
-    invocationId: string;
-}>;
-export type TaskModifyPlanSubmittedPayload = PayloadCore<'task-modify-plan-submitted', {
-    conversationId: string;
-    invocationId: string;
-    prompt: string;
-}>;
-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;
-}>;
-export type Callback = (payload: Payload) => void;
-export type TopicEvents = {
-    [key in Topic]?: Array<{
-        id: string;
-        callback: Callback;
-    }>;
-};
-export type TopicEventQueue = {
-    [key in Topic]?: Payload;
-};
-export type UploadedFile = {
-    id: string;
-    conversation_channel_id?: string;
-    blob_id?: string;
-    name: string;
-    size?: number;
-    type?: string;
-    created_at?: string;
-    owner?: string;
-    isLoading: boolean;
-    error?: string;
-    fileObject?: File;
-};
-type SendMessageSearchArtifact = {
-    /** The Atlassian Resource Identifier (ARI) of the object. */
-    ari?: string;
-    /** The URL of the object. */
-    url?: string;
-};
-export {};