@atlaskit/ads-mcp 1.10.9 → 1.10.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/dist/cjs/tools/get-all-components/components.codegen.js +3 -3
  3. package/dist/cjs/tools/get-atlaskit-components/atlaskit-components.codegen.js +3 -3
  4. package/dist/cjs/tools/get-atlaskit-hooks/atlaskit-hooks.codegen.js +147 -3
  5. package/dist/cjs/tools/get-atlaskit-utilities/atlaskit-utilities.codegen.js +379 -27
  6. package/dist/cjs/tools/get-guidelines/guidelines-structured-content.codegen.js +7 -7
  7. package/dist/cjs/tools/plan/list-plan-tool.js +1 -1
  8. package/dist/cjs/tools/search-components/list-search-components-tool.js +1 -1
  9. package/dist/es2019/tools/get-all-components/components.codegen.js +3 -3
  10. package/dist/es2019/tools/get-atlaskit-components/atlaskit-components.codegen.js +3 -3
  11. package/dist/es2019/tools/get-atlaskit-hooks/atlaskit-hooks.codegen.js +147 -3
  12. package/dist/es2019/tools/get-atlaskit-utilities/atlaskit-utilities.codegen.js +379 -27
  13. package/dist/es2019/tools/get-guidelines/guidelines-structured-content.codegen.js +7 -7
  14. package/dist/es2019/tools/plan/list-plan-tool.js +1 -1
  15. package/dist/es2019/tools/search-components/list-search-components-tool.js +1 -1
  16. package/dist/esm/tools/get-all-components/components.codegen.js +3 -3
  17. package/dist/esm/tools/get-atlaskit-components/atlaskit-components.codegen.js +3 -3
  18. package/dist/esm/tools/get-atlaskit-hooks/atlaskit-hooks.codegen.js +147 -3
  19. package/dist/esm/tools/get-atlaskit-utilities/atlaskit-utilities.codegen.js +379 -27
  20. package/dist/esm/tools/get-guidelines/guidelines-structured-content.codegen.js +7 -7
  21. package/dist/esm/tools/plan/list-plan-tool.js +1 -1
  22. package/dist/esm/tools/search-components/list-search-components-tool.js +1 -1
  23. package/dist/types/tools/get-all-components/components.codegen.d.ts +2 -2
  24. package/dist/types/tools/get-atlaskit-components/atlaskit-components.codegen.d.ts +2 -2
  25. package/dist/types/tools/get-atlaskit-hooks/atlaskit-hooks.codegen.d.ts +2 -2
  26. package/dist/types/tools/get-atlaskit-utilities/atlaskit-utilities.codegen.d.ts +2 -2
  27. package/dist/types/tools/get-guidelines/guidelines-structured-content.codegen.d.ts +1 -1
  28. package/package.json +3 -3
@@ -3,8 +3,8 @@
3
3
  *
4
4
  * Structured content utilities from design-system *.docs.tsx files
5
5
  *
6
- * @codegen <<SignedSource::6cf2c99c6dc783e5bef5e55ecb2a7efb>>
7
- * @codegenCommand yarn workspace @af/ads-ai-tooling codegen
6
+ * @codegen <<SignedSource::36fe0ac1637d9c74c16bde595a72490a>>
7
+ * @codegenCommand afm workspace @af/ads-ai-tooling codegen
8
8
  */
9
9
  /* eslint-disable @repo/internal/react/boolean-prop-naming-convention -- not our types */
10
10
 
@@ -1130,6 +1130,144 @@ export const atlaskitUtilities = [{
1130
1130
  package: '@atlassian/a2ui-renderer-next',
1131
1131
  examples: [],
1132
1132
  kind: 'type'
1133
+ }, {
1134
+ name: 'buildResumeSessionCommand',
1135
+ description: 'Builds a documented terminal resume command for a local-agent session, when supported.',
1136
+ status: 'general-availability',
1137
+ usageGuidelines: ['Treat null as no documented resume command and do not synthesize a shell command.'],
1138
+ keywords: ['agent sessions', 'local agent', 'resume'],
1139
+ category: 'agents',
1140
+ package: '@atlassian/agent-session-local-agents',
1141
+ examples: [],
1142
+ kind: 'function'
1143
+ }, {
1144
+ name: 'getLocalAgentDesktopApp',
1145
+ description: 'Returns a desktop-app deep-link descriptor for a local session when supported.',
1146
+ status: 'general-availability',
1147
+ usageGuidelines: ['Treat null as no desktop-app continuation option and render returned labels through Intl.'],
1148
+ keywords: ['agent sessions', 'local agent', 'desktop app'],
1149
+ category: 'agents',
1150
+ package: '@atlassian/agent-session-local-agents',
1151
+ examples: [],
1152
+ kind: 'function'
1153
+ }, {
1154
+ name: 'getLocalAgentDisplayName',
1155
+ description: 'Returns the localized display-name descriptor for a known local agent.',
1156
+ status: 'general-availability',
1157
+ usageGuidelines: ['Format the returned MessageDescriptor with the host IntlProvider; preserve null for unknown identifiers.'],
1158
+ keywords: ['agent sessions', 'local agent', 'display name'],
1159
+ category: 'agents',
1160
+ package: '@atlassian/agent-session-local-agents',
1161
+ examples: [],
1162
+ kind: 'function'
1163
+ }, {
1164
+ name: 'getLocalAgentIcon',
1165
+ description: 'Returns logo artwork for a known local agent when artwork is available.',
1166
+ status: 'general-availability',
1167
+ usageGuidelines: ['Use only when rendering artwork because this entrypoint statically imports logo components.'],
1168
+ keywords: ['agent sessions', 'local agent', 'artwork'],
1169
+ category: 'agents',
1170
+ package: '@atlassian/agent-session-local-agents',
1171
+ examples: [],
1172
+ kind: 'function'
1173
+ }, {
1174
+ name: 'isLocalAgentId',
1175
+ description: 'Narrows a raw conversation agent identifier to a known local-agent identifier.',
1176
+ status: 'general-availability',
1177
+ usageGuidelines: ['Use this lightweight entrypoint when only identity classification is needed.'],
1178
+ keywords: ['agent sessions', 'local agent', 'identity'],
1179
+ category: 'agents',
1180
+ package: '@atlassian/agent-session-local-agents',
1181
+ examples: [],
1182
+ kind: 'function'
1183
+ }, {
1184
+ name: 'agentSkillsListEntrypoint',
1185
+ description: 'Relay EntryPoint that preloads and renders skills for one Rovo agent.',
1186
+ status: 'general-availability',
1187
+ usageGuidelines: ['Render through the host EntryPoint API with an agent ID, cloud ID, and touchpoint ID.', 'No standalone example: the entrypoint needs the host Relay environment and query transport.'],
1188
+ keywords: ['rovo', 'agent', 'skill', 'studio'],
1189
+ category: 'agents',
1190
+ package: '@atlassian/agent-studio-skills',
1191
+ examples: [],
1192
+ kind: 'constant',
1193
+ type: 'EntryPoint'
1194
+ }, {
1195
+ name: 'agentStudioSkillDetailEntrypoint',
1196
+ description: 'Relay EntryPoint for a skill detail view owned by the current site.',
1197
+ status: 'general-availability',
1198
+ usageGuidelines: ['Use with the host EntryPoint API and a cloud ID plus skill ARI.', 'No standalone example: it requires its product Relay environment.'],
1199
+ keywords: ['rovo', 'agent', 'skill', 'studio'],
1200
+ category: 'agents',
1201
+ package: '@atlassian/agent-studio-skills',
1202
+ examples: [],
1203
+ kind: 'constant',
1204
+ type: 'EntryPoint'
1205
+ }, {
1206
+ name: 'agentStudioSkillsEntrypoint',
1207
+ description: 'Relay EntryPoint for the Rovo Agent Studio skills surface.',
1208
+ status: 'general-availability',
1209
+ usageGuidelines: ['Render through the host EntryPoint API with a cloud ID and optional capabilities.', 'No standalone example: the entrypoint owns a Relay preload query and feature-gated product context.'],
1210
+ keywords: ['rovo', 'agent', 'skill', 'studio'],
1211
+ category: 'agents',
1212
+ package: '@atlassian/agent-studio-skills',
1213
+ examples: [],
1214
+ kind: 'constant',
1215
+ type: 'EntryPoint'
1216
+ }, {
1217
+ name: 'cloneCandidateSkillDetailEntrypoint',
1218
+ description: 'Relay EntryPoint for a skill detail view authorized by a share-link clone token.',
1219
+ status: 'general-availability',
1220
+ usageGuidelines: ['Use only when the clone token authorizes the requested cloud ID and skill ARI.', 'No standalone example: the entrypoint requires a token-authorized Relay query environment.'],
1221
+ keywords: ['rovo', 'agent', 'skill', 'studio'],
1222
+ category: 'agents',
1223
+ package: '@atlassian/agent-studio-skills',
1224
+ examples: [],
1225
+ kind: 'constant',
1226
+ type: 'EntryPoint'
1227
+ }, {
1228
+ name: 'MAX_SHARE_SKILLS_SELECTION',
1229
+ description: 'Maximum number of skills that can be selected for sharing at once.',
1230
+ status: 'general-availability',
1231
+ keywords: ['rovo', 'agent', 'skill', 'studio'],
1232
+ category: 'agents',
1233
+ package: '@atlassian/agent-studio-skills',
1234
+ examples: [],
1235
+ kind: 'constant',
1236
+ type: 'number',
1237
+ value: '5'
1238
+ }, {
1239
+ name: 'MODAL_HEIGHT',
1240
+ description: 'Standard height used by the Agent Studio skills modal.',
1241
+ status: 'general-availability',
1242
+ keywords: ['rovo', 'agent', 'skill', 'studio'],
1243
+ category: 'agents',
1244
+ package: '@atlassian/agent-studio-skills',
1245
+ examples: [],
1246
+ kind: 'constant',
1247
+ type: 'string',
1248
+ value: '100%'
1249
+ }, {
1250
+ name: 'MODAL_WIDTH',
1251
+ description: 'Standard width used by the Agent Studio skills modal.',
1252
+ status: 'general-availability',
1253
+ keywords: ['rovo', 'agent', 'skill', 'studio'],
1254
+ category: 'agents',
1255
+ package: '@atlassian/agent-studio-skills',
1256
+ examples: [],
1257
+ kind: 'constant',
1258
+ type: 'string',
1259
+ value: '1248px'
1260
+ }, {
1261
+ name: 'STUDIO_EXTERNAL_ALLOWLIST_SKILL_PRODUCTS',
1262
+ description: 'Product keys eligible for externally allowlisted Studio skills.',
1263
+ status: 'general-availability',
1264
+ keywords: ['rovo', 'agent', 'skill', 'studio'],
1265
+ category: 'agents',
1266
+ package: '@atlassian/agent-studio-skills',
1267
+ examples: [],
1268
+ kind: 'constant',
1269
+ type: 'string[]',
1270
+ value: 'jsm, jira, confluence'
1133
1271
  }, {
1134
1272
  name: 'AnimatedIconAnimation',
1135
1273
  description: 'The animation state accepted by the animated icon entry points.',
@@ -3286,7 +3424,7 @@ export const atlaskitUtilities = [{
3286
3424
  package: '@atlassian/conversation-assistant-ui-components',
3287
3425
  examples: [],
3288
3426
  kind: 'type',
3289
- definition: "{ testId?: string; sections: MenuSection[]; isOpen: boolean; placement: PopupProps['placement']; width: string; maxWidth: string; onClose: () => void; trigger: (triggerProps: TriggerProps) => React.ReactNode; zIndex?: number; content: React.ReactNode; popoverAutoFocus?: boolean; shouldRenderToParent?: boolean }"
3427
+ definition: "{ testId?: string; sections: MenuSection[]; isOpen: boolean; placement: PopupProps['placement']; width: string; maxWidth: string; maxHeight?: string; onClose: () => void; trigger: (triggerProps: TriggerProps) => React.ReactNode; zIndex?: number; content: React.ReactNode; popoverAutoFocus?: boolean; shouldRenderToParent?: boolean; shouldFlip?: boolean; menuRef?: RefCallback<HTMLDivElement> }"
3290
3428
  }, {
3291
3429
  name: 'chatHeaderMessages',
3292
3430
  description: 'Localized message descriptors for Rovo Chat header and overflow-menu controls.',
@@ -4110,16 +4248,6 @@ export const atlaskitUtilities = [{
4110
4248
  package: '@atlassian/conversation-assistant-utils',
4111
4249
  examples: [],
4112
4250
  kind: 'function'
4113
- }, {
4114
- name: 'resolveHttpUrl',
4115
- description: 'Resolves absolute or base-relative HTTP(S) URLs and rejects unsupported schemes.',
4116
- status: 'general-availability',
4117
- usageGuidelines: ['Use when a URL may be absolute or relative to a known HTTP(S) base path.'],
4118
- keywords: ['rovo', 'chat', 'source', 'url', 'security'],
4119
- category: 'rovo',
4120
- package: '@atlassian/conversation-assistant-utils',
4121
- examples: [],
4122
- kind: 'function'
4123
4251
  }, {
4124
4252
  name: 'ROVO_AGENT_UUID',
4125
4253
  description: 'Canonical UUID for the default Rovo runtime agent.',
@@ -4540,6 +4668,102 @@ export const atlaskitUtilities = [{
4540
4668
  examples: [],
4541
4669
  kind: 'type',
4542
4670
  definition: '{ site: string; siteId: string; cloudId?: string; widgetId: string; authenticate?: (() => Promise<{ accessToken: string } | { access_token: string } | null | undefined>) | null; userId?: string; conversationContext?: Record<string, unknown>; locale?: string }'
4671
+ }, {
4672
+ name: 'createRovoDevQuickInsertProvider',
4673
+ description: 'Creates the quick-insert provider for Rovo Dev cards.',
4674
+ status: 'general-availability',
4675
+ usageGuidelines: ['Create with the owning editor API and register it with the product quick-insert integration.'],
4676
+ keywords: ['rovodev', 'editor', 'quick insert'],
4677
+ category: 'rovo',
4678
+ package: '@atlassian/editor-plugin-rovodev',
4679
+ examples: [],
4680
+ kind: 'function'
4681
+ }, {
4682
+ name: 'rovodevPlugin',
4683
+ description: 'Adds Rovo Dev file-path cards and quick-insert behaviour to a composable editor.',
4684
+ status: 'general-availability',
4685
+ usageGuidelines: ['Add to the product-owned composable editor preset with the editor APIs required by Rovo Dev cards.'],
4686
+ keywords: ['rovodev', 'editor', 'plugin'],
4687
+ category: 'rovo',
4688
+ package: '@atlassian/editor-plugin-rovodev',
4689
+ examples: [],
4690
+ kind: 'function',
4691
+ signature: 'RovodevPlugin'
4692
+ }, {
4693
+ name: 'convertAdfToText',
4694
+ description: 'Serializes an Atlassian Document Format document into the text used by Rovo Dev editor commands.',
4695
+ status: 'general-availability',
4696
+ usageGuidelines: ['Pass an ADF document from the editor; undefined input deliberately returns null rather than an empty command.'],
4697
+ keywords: ['rovo', 'rovodev', 'editor', 'adf', 'text'],
4698
+ category: 'rovo',
4699
+ package: '@atlassian/editor-plugin-rovodev-node-text-serializer',
4700
+ examples: [],
4701
+ kind: 'function'
4702
+ }, {
4703
+ name: 'rovodevQuickSubmitPlugin',
4704
+ description: 'Adds Enter-key submission behaviour to a Rovo Dev composable editor preset.',
4705
+ status: 'general-availability',
4706
+ usageGuidelines: ['Add the plugin to a composable editor preset and provide an onSubmit callback that handles the current EditorView.', 'Keep media-plugin support in the preset so Enter retains the editor’s media-aware keyboard behaviour.'],
4707
+ keywords: ['rovo', 'rovodev', 'editor', 'plugin', 'submit'],
4708
+ category: 'rovo',
4709
+ package: '@atlassian/editor-plugin-rovodev-quick-submit',
4710
+ examples: [],
4711
+ kind: 'function',
4712
+ signature: 'RovodevQuickSubmitPlugin'
4713
+ }, {
4714
+ name: 'CommandHandler',
4715
+ description: 'Base class for handling a Rovo command lifecycle in an editor.',
4716
+ status: 'general-availability',
4717
+ usageGuidelines: ['Extend only when integrating a new Rovo command contract with the editor bridge.'],
4718
+ keywords: ['rovo', 'editor', 'commands'],
4719
+ category: 'rovo',
4720
+ package: '@atlassian/editor-rovo-bridge',
4721
+ examples: [],
4722
+ kind: 'constant',
4723
+ type: 'abstract class'
4724
+ }, {
4725
+ name: 'DocumentUpdateCommandProcessor',
4726
+ description: 'Applies parsed Rovo document-update commands to an editor document.',
4727
+ status: 'general-availability',
4728
+ usageGuidelines: ['Construct with the editor state dependencies managed by the bridge rather than applying updates independently.'],
4729
+ keywords: ['rovo', 'editor', 'document updates'],
4730
+ category: 'rovo',
4731
+ package: '@atlassian/editor-rovo-bridge',
4732
+ examples: [],
4733
+ kind: 'constant',
4734
+ type: 'class'
4735
+ }, {
4736
+ name: 'PartialStreamParser',
4737
+ description: 'Parses partial Rovo stream payloads into editor command actions.',
4738
+ status: 'general-availability',
4739
+ usageGuidelines: ['Retain one parser for an ordered stream; reset it when a Rovo session ends.'],
4740
+ keywords: ['rovo', 'editor', 'streaming', 'parser'],
4741
+ category: 'rovo',
4742
+ package: '@atlassian/editor-rovo-bridge',
4743
+ examples: [],
4744
+ kind: 'constant',
4745
+ type: 'class'
4746
+ }, {
4747
+ name: 'StreamingCommandHandler',
4748
+ description: 'Base class for Rovo commands that deliver incremental editor updates.',
4749
+ status: 'general-availability',
4750
+ usageGuidelines: ['Use for command implementations that must coordinate start, chunk, completion, and abort events.'],
4751
+ keywords: ['rovo', 'editor', 'streaming'],
4752
+ category: 'rovo',
4753
+ package: '@atlassian/editor-rovo-bridge',
4754
+ examples: [],
4755
+ kind: 'constant',
4756
+ type: 'abstract class'
4757
+ }, {
4758
+ name: 'createRedactionNotifier',
4759
+ description: 'Creates a rate-limited notifier for Guard redaction events.',
4760
+ status: 'general-availability',
4761
+ usageGuidelines: ['Create one notifier for a UI surface and reuse it so notifications remain rate limited.'],
4762
+ keywords: ['rovo chat', 'guard', 'redaction'],
4763
+ category: 'rovo',
4764
+ package: '@atlassian/guard-redaction-ui',
4765
+ examples: [],
4766
+ kind: 'function'
4543
4767
  }, {
4544
4768
  name: 'InContextAifcModalProps',
4545
4769
  description: 'Prompt-input, modal lifecycle, host UI, suggestion, and conversation configuration.',
@@ -4573,6 +4797,16 @@ export const atlaskitUtilities = [{
4573
4797
  examples: [],
4574
4798
  kind: 'type',
4575
4799
  definition: '{ suggestions: Suggestions; promptStarterCards?: never } | { promptStarterCards?: PromptCard[]; suggestions?: never }'
4800
+ }, {
4801
+ name: 'toInferredProjectAri',
4802
+ description: 'Builds the Teamwork Graph ARI for an inferred project in a workspace.',
4803
+ status: 'general-availability',
4804
+ usageGuidelines: ['Use the workspace ID and inferred-project ID returned by the graph-store route or query.'],
4805
+ keywords: ['rovo', 'inferred project', 'ari', 'teamwork graph'],
4806
+ category: 'rovo',
4807
+ package: '@atlassian/inferred-project-page',
4808
+ examples: [],
4809
+ kind: 'function'
4576
4810
  }, {
4577
4811
  name: 'ASSIGNEE_FIELD_ID',
4578
4812
  description: 'Canonical Jira field identifier for the work-item assignee.',
@@ -4814,6 +5048,26 @@ export const atlaskitUtilities = [{
4814
5048
  package: '@atlassian/logo-third-party',
4815
5049
  examples: [],
4816
5050
  kind: 'type'
5051
+ }, {
5052
+ name: 'getSearchFilterInput',
5053
+ description: 'Builds the normalized Rovo search-filter input for a configured third-party connector product.',
5054
+ status: 'general-availability',
5055
+ usageGuidelines: ['Pass the initialized filters state and hydrated connector response; the helper returns undefined for unsupported product keys.'],
5056
+ keywords: ['rovo', 'agents', 'connectors', 'filters', 'search input'],
5057
+ category: 'rovo',
5058
+ package: '@atlassian/rovo-agent-connectors',
5059
+ examples: [],
5060
+ kind: 'function'
5061
+ }, {
5062
+ name: 'parseRawFilters',
5063
+ description: 'Parses a raw Rovo connector filter input into URL query parameters.',
5064
+ status: 'general-availability',
5065
+ usageGuidelines: ['Use to hydrate filter state from a serialized request; malformed or missing input intentionally yields empty query parameters.'],
5066
+ keywords: ['rovo', 'agents', 'connectors', 'filters', 'query parameters'],
5067
+ category: 'rovo',
5068
+ package: '@atlassian/rovo-agent-connectors',
5069
+ examples: [],
5070
+ kind: 'function'
4817
5071
  }, {
4818
5072
  name: 'clearCache',
4819
5073
  description: 'Clears cached shuffled prompt-starter card collections.',
@@ -5747,6 +6001,26 @@ export const atlaskitUtilities = [{
5747
6001
  examples: [],
5748
6002
  kind: 'type',
5749
6003
  definition: '{ query: string; chatMode: string; knowledgeSources: string[]; rovoEnabledConnectors: string[]; conversationId: string; siteId: string; product: string; isChatGPTEligible: boolean }'
6004
+ }, {
6005
+ name: 'connectorsConfig',
6006
+ description: 'Singleton facade for resolving canonical third-party connector configuration and filter metadata.',
6007
+ status: 'general-availability',
6008
+ usageGuidelines: ['Use the facade for read-only connector lookups instead of reaching into per-product configuration registries.', 'Handle absent configuration because product keys and resource types can be unrecognised or disabled.'],
6009
+ keywords: ['rovo', 'connectors', 'configuration', 'facade', 'filters'],
6010
+ category: 'agents',
6011
+ package: '@atlassian/rovo-connectors-config',
6012
+ examples: [],
6013
+ kind: 'constant'
6014
+ }, {
6015
+ name: 'generateSearchInputs',
6016
+ description: 'Generates the Rovo Search filter variables from product, query, and connector configuration.',
6017
+ status: 'general-availability',
6018
+ usageGuidelines: ['Call only in the browser search-query path; this utility is not SSR-safe.', 'Pass connector configuration from the canonical configuration hook so product filters stay consistent with Rovo Chat and Search.'],
6019
+ keywords: ['rovo', 'search', 'filters', 'connectors', 'query'],
6020
+ category: 'agents',
6021
+ package: '@atlassian/rovo-connectors-config',
6022
+ examples: [],
6023
+ kind: 'function'
5750
6024
  }, {
5751
6025
  name: 'BroadcastableCommandConstructor',
5752
6026
  description: 'Command constructor marked as safe for bridge broadcast operations.',
@@ -6551,17 +6825,6 @@ export const atlaskitUtilities = [{
6551
6825
  examples: [],
6552
6826
  kind: 'type',
6553
6827
  definition: '{ id: string; title: string; prompt: string; useCase?: PromptCategory; roles?: PromptRole[]; enableDeepResearch?: boolean; appIds?: string[]; tags?: string[]; isFavorited?: boolean; shareId?: string; isUserGenerated?: boolean; icon?: React.ComponentType; startNewChat?: boolean }'
6554
- }, {
6555
- name: 'PromptCardsMultiselectToolbarProps',
6556
- description: 'Selection state and bulk operation callbacks for the prompt-library toolbar.',
6557
- status: 'general-availability',
6558
- usageGuidelines: ['Prefer the bulk callbacks so a selection is processed and refreshed in one operation.'],
6559
- keywords: ['rovo', 'prompts', 'toolbar', 'bulk actions'],
6560
- category: 'rovo',
6561
- package: '@atlassian/rovo-conversation-actions',
6562
- examples: [],
6563
- kind: 'type',
6564
- definition: '{ selectedCount: number; selectedCards: PromptCard[]; onClearSelection: () => void; onBulkFavorite?: (prompts: BulkFavoriteItem[], systemPromptCount: number) => Promise<void>; onDeletePrompt?: (promptId: string) => Promise<void>; onBulkDelete?: (promptIds: string[], systemPromptCount: number) => Promise<void>; onBulkShare?: (promptIds: string[], systemPromptCount: number) => Promise<void> }'
6565
6828
  }, {
6566
6829
  name: 'PromptCategory',
6567
6830
  description: 'Supported use-case categories for prompt-library cards.',
@@ -6775,7 +7038,7 @@ export const atlaskitUtilities = [{
6775
7038
  package: '@atlassian/rovo-experience-api',
6776
7039
  examples: [],
6777
7040
  kind: 'type',
6778
- definition: '{ mode?: ConversationAssistantUIModes; isMiniModalAvailable: boolean; isSidebarAvailable: boolean; initialPrompt?: string; openWithChatHistory?: boolean; targetConversationId?: string | null; autoFocusInput?: boolean; wasAutoOpened: boolean; editorHadFocusBeforeChatOpen: boolean }'
7041
+ definition: '{ mode?: ConversationAssistantUIModes; isMiniModalAvailable: boolean; isSidebarAvailable: boolean; isFullScreenModalAvailable: boolean; initialPrompt?: string; openWithChatHistory?: boolean; targetConversationId?: string | null; autoFocusInput?: boolean; wasAutoOpened: boolean; editorHadFocusBeforeChatOpen: boolean }'
6779
7042
  }, {
6780
7043
  name: 'RovoExperienceAPIStore',
6781
7044
  description: 'Combined Rovo UI state and commands returned to consuming components.',
@@ -6786,7 +7049,7 @@ export const atlaskitUtilities = [{
6786
7049
  package: '@atlassian/rovo-experience-api',
6787
7050
  examples: [],
6788
7051
  kind: 'type',
6789
- definition: '{ mode?: ConversationAssistantUIModes; initialPrompt?: string; openWithChatHistory?: boolean; targetConversationId?: string | null; autoFocusInput?: boolean; wasAutoOpened?: boolean; editorHadFocusBeforeChatOpen?: boolean; reset: () => void; clearInitialPrompt: () => void; setOpenWithChatHistory?: (openWithChatHistory: boolean) => void; setTargetConversationId?: (targetConversationId: string | null) => void; setWasAutoOpened?: (wasAutoOpened: boolean) => void; setEditorHadFocusBeforeChatOpen?: (editorHadFocusBeforeChatOpen: boolean) => void; toggleConversationAssistantUIMode: (args: { targetMode?: ConversationAssistantUIModes; sidebarApi: RovoExperienceSidebarAPI; initialPrompt?: string; autoFocusInput?: boolean }) => void; openConversationAssistantUIMode: (args: { targetMode: ConversationAssistantUIModes; sidebarApi: RovoExperienceSidebarAPI; initialPrompt?: string; autoFocusInput?: boolean }) => void; setIsMiniModalAvailable: (isMiniModalAvailable: boolean) => void; setIsSidebarAvailable: (isSidebarAvailable: boolean) => void; isMiniModalAvailable: boolean; isSidebarAvailable: boolean }'
7052
+ definition: '{ mode?: ConversationAssistantUIModes; initialPrompt?: string; openWithChatHistory?: boolean; targetConversationId?: string | null; autoFocusInput?: boolean; wasAutoOpened?: boolean; editorHadFocusBeforeChatOpen?: boolean; reset: () => void; clearInitialPrompt: () => void; setOpenWithChatHistory?: (openWithChatHistory: boolean) => void; setTargetConversationId?: (targetConversationId: string | null) => void; setWasAutoOpened?: (wasAutoOpened: boolean) => void; setEditorHadFocusBeforeChatOpen?: (editorHadFocusBeforeChatOpen: boolean) => void; toggleConversationAssistantUIMode: (args: { targetMode?: ConversationAssistantUIModes; sidebarApi: RovoExperienceSidebarAPI; initialPrompt?: string; autoFocusInput?: boolean }) => void; openConversationAssistantUIMode: (args: { targetMode: ConversationAssistantUIModes; sidebarApi: RovoExperienceSidebarAPI; initialPrompt?: string; autoFocusInput?: boolean }) => void; setIsMiniModalAvailable: (isMiniModalAvailable: boolean) => void; setIsSidebarAvailable: (isSidebarAvailable: boolean) => void; setIsFullScreenModalAvailable: (isFullScreenModalAvailable: boolean) => void; isMiniModalAvailable: boolean; isSidebarAvailable: boolean; isFullScreenModalAvailable: boolean }'
6790
7053
  }, {
6791
7054
  name: 'RovoExperienceSidebarAPI',
6792
7055
  description: 'Host adapter for querying, opening, and closing the product sidebar.',
@@ -7438,7 +7701,7 @@ export const atlaskitUtilities = [{
7438
7701
  keywords: ['rovo', 'authority', 'analytics'],
7439
7702
  category: 'analytics',
7440
7703
  package: '@atlassian/rovo-platform-ui-components',
7441
- examples: ["import { IntlProvider } from 'react-intl';\nimport { InsightLinkCardGroup } from '@atlassian/rovo-platform-ui-components/insight-link-card-group';\nconst sourceUrls = [\n\t'https://hello.atlassian.net/wiki/spaces/ENG/pages/handbook',\n\t'https://hello.atlassian.net/wiki/spaces/ENG/pages/release-process',\n];\nexport default function InsightLinkCardGroupExample(): React.JSX.Element {\n\treturn (\n\t\t<IntlProvider locale=\"en\">\n\t\t\t<InsightLinkCardGroup urls={sourceUrls} isFullScreen={false} />\n\t\t</IntlProvider>\n\t);\n}"],
7704
+ examples: [],
7442
7705
  kind: 'function'
7443
7706
  }, {
7444
7707
  name: 'getBorderColor',
@@ -7736,6 +7999,16 @@ export const atlaskitUtilities = [{
7736
7999
  package: '@atlassian/rovo-playground',
7737
8000
  examples: [],
7738
8001
  kind: 'function'
8002
+ }, {
8003
+ name: 'fetchPromptOfTheDay',
8004
+ description: 'Fetches today’s prompt suggestions and returns null instead of rejecting when they cannot be shown.',
8005
+ status: 'general-availability',
8006
+ usageGuidelines: ['Treat null as unavailable and avoid retry loops that would bypass the account-scoped cache policy.'],
8007
+ keywords: ['rovo', 'prompt of the day', 'suggestions', 'request'],
8008
+ category: 'rovo',
8009
+ package: '@atlassian/rovo-prompt-of-the-day',
8010
+ examples: [],
8011
+ kind: 'function'
7739
8012
  }, {
7740
8013
  name: 'Types',
7741
8014
  description: 'Public types entrypoint for @atlassian/rovo-reintroduction-modal.',
@@ -7936,6 +8209,85 @@ export const atlaskitUtilities = [{
7936
8209
  examples: [],
7937
8210
  kind: 'constant',
7938
8211
  type: "Readonly<{ jiraAdminAgentCanvas: 'jira-admin-agent-canvas' }>"
8212
+ }, {
8213
+ name: 'buildRovoDevAiEventsConfig',
8214
+ description: 'Builds the standard client-side AI analytics configuration for a Rovo Dev coding session.',
8215
+ status: 'general-availability',
8216
+ usageGuidelines: ['Use for Rovo Dev session events so Jira Coding Agent identity and session attributes remain consistent.', 'Pass automationRuleId only for automation-platform sessions, and provide mobile explicitly for native clients.'],
8217
+ keywords: ['rovodev', 'jira coding agent', 'analytics', 'instrumentation'],
8218
+ category: 'agents',
8219
+ package: '@atlassian/rovodev-ai-events',
8220
+ examples: [],
8221
+ kind: 'function'
8222
+ }, {
8223
+ name: 'clearSessionSettings',
8224
+ description: 'Clears persisted RovoDev code settings for a session.',
8225
+ status: 'general-availability',
8226
+ usageGuidelines: ['Call during an explicit session reset or disposal flow.'],
8227
+ keywords: ['rovodev', 'session', 'settings'],
8228
+ category: 'agents',
8229
+ package: '@atlassian/rovodev-code-settings',
8230
+ examples: [],
8231
+ kind: 'function'
8232
+ }, {
8233
+ name: 'getSessionSettings',
8234
+ description: 'Reads persisted RovoDev code settings for a session.',
8235
+ status: 'general-availability',
8236
+ usageGuidelines: ['Use only inside the RovoDev host that owns the session-settings persistence boundary.'],
8237
+ keywords: ['rovodev', 'session', 'settings'],
8238
+ category: 'agents',
8239
+ package: '@atlassian/rovodev-code-settings',
8240
+ examples: [],
8241
+ kind: 'function'
8242
+ }, {
8243
+ name: 'setSessionSettings',
8244
+ description: 'Persists RovoDev code settings for a session.',
8245
+ status: 'general-availability',
8246
+ usageGuidelines: ['Persist settings only after the user confirms a controlled settings change.'],
8247
+ keywords: ['rovodev', 'session', 'settings'],
8248
+ category: 'agents',
8249
+ package: '@atlassian/rovodev-code-settings',
8250
+ examples: [],
8251
+ kind: 'function'
8252
+ }, {
8253
+ name: 'validateGitBranchName',
8254
+ description: 'Checks whether a proposed RovoDev branch name is valid.',
8255
+ status: 'general-availability',
8256
+ usageGuidelines: ['Validate user-entered branch names before sending them to a Git operation.'],
8257
+ keywords: ['rovodev', 'git', 'branch'],
8258
+ category: 'agents',
8259
+ package: '@atlassian/rovodev-code-settings',
8260
+ examples: [],
8261
+ kind: 'function',
8262
+ parameters: [{
8263
+ name: 'branchName',
8264
+ type: 'string',
8265
+ description: 'Candidate Git branch name.'
8266
+ }],
8267
+ returns: {
8268
+ type: 'boolean',
8269
+ description: 'Whether the branch name is valid.'
8270
+ }
8271
+ }, {
8272
+ name: 'fetchRovoDevAutomationSettings',
8273
+ description: 'Fetches the persisted Rovo Dev automation setting for a container.',
8274
+ status: 'general-availability',
8275
+ usageGuidelines: ['Handle rejected network requests and use the hook when React loading state is needed.'],
8276
+ keywords: ['rovodev', 'automation', 'settings', 'request'],
8277
+ category: 'agents',
8278
+ package: '@atlassian/rovodev-settings',
8279
+ examples: [],
8280
+ kind: 'function'
8281
+ }, {
8282
+ name: 'setRovoDevAutomationSettingsApi',
8283
+ description: 'Persists the Rovo Dev automation setting for a container.',
8284
+ status: 'general-availability',
8285
+ usageGuidelines: ['Prefer the setter hook in React so loading and error state remains visible to the user.'],
8286
+ keywords: ['rovodev', 'automation', 'settings', 'request'],
8287
+ category: 'agents',
8288
+ package: '@atlassian/rovodev-settings',
8289
+ examples: [],
8290
+ kind: 'function'
7939
8291
  }, {
7940
8292
  name: 'SmartCreateFeedbackVariant',
7941
8293
  description: 'Enumerates the supported product variants for Smart Create feedback.',