Merge branch 'main' into feature/lambda_obs

Author: cotti

.github/actions/aws-auth/action.yml

@@ -37,7 +37,7 @@ runs:
           with open(os.environ["GITHUB_OUTPUT"], "a") as f:
             f.write(f"result=arn:aws:iam::{os.environ["AWS_ACCOUNT_ID"]}:role/{prefix}{hash}")
     - name: Configure AWS Credentials
-      uses: aws-actions/configure-aws-credentials@a03048d87541d1d9fcf2ecf528a4a65ba9bd7838 # v5.0.0
+      uses: aws-actions/configure-aws-credentials@00943011d9042930efac3dcd3a170e4273319bc8 # v5.1.0
       with:
         role-to-assume: ${{ steps.role_arn.outputs.result }}
         aws-region: ${{ inputs.aws_region }}

.github/workflows/deploy-api-lambda.yml

@@ -45,7 +45,7 @@ jobs:
         run: |
           zip -j "${ZIP_FILE}" ./bootstrap
 
-      - uses: aws-actions/configure-aws-credentials@a03048d87541d1d9fcf2ecf528a4a65ba9bd7838 # v5.0.0
+      - uses: aws-actions/configure-aws-credentials@00943011d9042930efac3dcd3a170e4273319bc8 # v5.1.0
         with:
           role-to-assume: arn:aws:iam::197730964718:role/elastic-docs-v3-api-deployer-${{ inputs.environment }}
           aws-region: us-east-1

.github/workflows/release.yml

@@ -110,7 +110,7 @@ jobs:
         run: |
           zip -j "${ZIP_FILE}" ./bootstrap
 
-      - uses: aws-actions/configure-aws-credentials@a03048d87541d1d9fcf2ecf528a4a65ba9bd7838 # v5.0.0
+      - uses: aws-actions/configure-aws-credentials@00943011d9042930efac3dcd3a170e4273319bc8 # v5.1.0
         with:
           role-to-assume: arn:aws:iam::197730964718:role/elastic-docs-v3-link-index-updater-deployer
           aws-region: us-east-2

actions/update-link-index/action.yml

@@ -42,7 +42,7 @@ runs:
           with open(os.environ["GITHUB_OUTPUT"], "a") as f:
             f.write(f"result=arn:aws:iam::{aws_account_id}:role/{prefix}{hash}")
     - name: Configure AWS Credentials
-      uses: aws-actions/configure-aws-credentials@a03048d87541d1d9fcf2ecf528a4a65ba9bd7838 # v5.0.0
+      uses: aws-actions/configure-aws-credentials@00943011d9042930efac3dcd3a170e4273319bc8 # v5.1.0
       with:
         role-to-assume: ${{ steps.role_arn.outputs.result }}
         aws-region: us-east-1

config/versions.yml

@@ -15,7 +15,7 @@ versioning_systems:
   # Ece version updates are manual
   ece:
     base: 4.0
-    current: 4.0.1
+    current: 4.0.2
   ech: *all
   eck:
     base: 3.0

docs/syntax/icons.md

@@ -176,3 +176,6 @@ export function initHighlight() {
         hljs.highlightElement
     )
 }
+
+// Export the configured hljs instance for reuse
+export { hljs }

src/Elastic.Documentation.Site/Assets/hljs.ts

@@ -3,44 +3,66 @@ import { useChatActions } from './chat.store'
 import { EuiButton, useEuiTheme } from '@elastic/eui'
 import { css } from '@emotion/react'
 import * as React from 'react'
-
-const buttonStyles = css`
-    border: none;
-    & > span {
-        justify-content: flex-start;
-    }
-`
+import { useMemo } from 'react'
 
 export interface AskAiSuggestion {
     question: string
 }
 
-interface Props {
-    suggestions: Set<AskAiSuggestion>
-}
+// Comprehensive list of AI suggestion questions
+const ALL_SUGGESTIONS: AskAiSuggestion[] = [
+    { question: 'How do I set up a data stream in Elasticsearch?' },
+    { question: 'What are the best practices for indexing performance?' },
+    { question: 'How can I create a dashboard in Kibana?' },
+    { question: 'What is the difference between a keyword and text field?' },
+    { question: 'How do I configure machine learning jobs?' },
+    { question: 'What are aggregations and how do I use them?' },
+    { question: 'How do I set up Elasticsearch security and authentication?' },
+    { question: 'What are the different types of Elasticsearch queries?' },
+    { question: 'How do I monitor cluster health and performance?' },
+    {
+        question:
+            'What is the Elastic Stack and how do the components work together?',
+    },
+    { question: 'How do I create and manage Elasticsearch indices?' },
+    { question: 'What are the best practices for Elasticsearch mapping?' },
+    { question: 'How do I set up log shipping with Beats?' },
+    { question: 'What is APM and how do I use it for application monitoring?' },
+    { question: 'How do I create custom visualizations in Kibana?' },
+    { question: 'What are Elasticsearch snapshots and how do I use them?' },
+    { question: 'How do I configure cross-cluster search?' },
+    {
+        question:
+            'What are the different Elasticsearch node types and their roles?',
+    },
+]
 
-export const AskAiSuggestions = (props: Props) => {
+export const AskAiSuggestions = () => {
     const { submitQuestion } = useChatActions()
     const { setModalMode } = useModalActions()
     const { euiTheme } = useEuiTheme()
 
-    const dynamicButtonStyles = css`
-        ${buttonStyles}
-        svg {
-            color: ${euiTheme.colors.textSubdued};
-        }
-    `
+    // Randomly select 3 questions from the comprehensive list
+    const selectedSuggestions = useMemo(() => {
+        // Shuffle the array and take first 3
+        const shuffled = [...ALL_SUGGESTIONS].sort(() => Math.random() - 0.5)
+        return shuffled.slice(0, 3)
+    }, [])
 
     return (
         <ul>
-            {Array.from(props.suggestions).map((suggestion) => (
-                <li key={suggestion.question}>
+            {selectedSuggestions.map((suggestion) => (
+                <li
+                    key={suggestion.question}
+                    css={css`
+                        margin-bottom: ${euiTheme.size.s};
+                    `}
+                >
                     <EuiButton
                         iconType="newChat"
-                        color="text"
+                        color="primary"
                         fullWidth
                         size="s"
-                        css={dynamicButtonStyles}
                         onClick={() => {
                             submitQuestion(suggestion.question)
                             setModalMode('askAi')

src/Elastic.Documentation.Site/Assets/web-components/SearchOrAskAi/AskAi/AskAiSuggestions.tsx

@@ -15,7 +15,7 @@ import {
 } from '@elastic/eui'
 import { css } from '@emotion/react'
 import * as React from 'react'
-import { useCallback, useEffect, useRef } from 'react'
+import { useCallback, useEffect, useRef, useState } from 'react'
 
 const containerStyles = css`
     height: 100%;
@@ -66,6 +66,7 @@ export const Chat = () => {
     const inputRef = useRef<HTMLInputElement>(null)
     const scrollRef = useRef<HTMLDivElement>(null)
     const lastMessageStatusRef = useRef<string | null>(null)
+    const [inputValue, setInputValue] = useState('')
 
     const dynamicScrollableStyles = css`
         ${scrollableStyles}
@@ -81,6 +82,7 @@ export const Chat = () => {
             if (inputRef.current) {
                 inputRef.current.value = ''
             }
+            setInputValue('')
 
             // Scroll to bottom after new message
             setTimeout(() => scrollToBottom(scrollRef.current), 100)
@@ -148,36 +150,7 @@ export const Chat = () => {
                                         <h3>Try asking me:</h3>
                                     </EuiTitle>
                                     <EuiSpacer size="s" />
-                                    <AskAiSuggestions
-                                        suggestions={
-                                            new Set([
-                                                {
-                                                    question:
-                                                        'How do I set up a data stream in Elasticsearch?',
-                                                },
-                                                {
-                                                    question:
-                                                        'What are the best practices for indexing performance?',
-                                                },
-                                                {
-                                                    question:
-                                                        'How can I create a dashboard in Kibana?',
-                                                },
-                                                {
-                                                    question:
-                                                        'What is the difference between a keyword and text field?',
-                                                },
-                                                {
-                                                    question:
-                                                        'How do I configure machine learning jobs?',
-                                                },
-                                                {
-                                                    question:
-                                                        'What are aggregations and how do I use them?',
-                                                },
-                                            ])
-                                        }
-                                    />
+                                    <AskAiSuggestions />
                                 </>
                             }
                         />
@@ -202,6 +175,7 @@ export const Chat = () => {
                         inputRef={inputRef}
                         fullWidth
                         placeholder="Ask Elastic Docs AI Assistant"
+                        onChange={(e) => setInputValue(e.target.value)}
                         onKeyDown={(e) => {
                             if (e.key === 'Enter') {
                                 handleSubmit(e.currentTarget.value)
@@ -219,7 +193,7 @@ export const Chat = () => {
                         `}
                         color="primary"
                         iconType="sortUp"
-                        display="base"
+                        display={inputValue.trim() ? 'fill' : 'base'}
                         onClick={() => {
                             if (inputRef.current) {
                                 handleSubmit(inputRef.current.value)