feat: add Algolia Ask AI side-panel via DocSearch adapter

- Install @docsearch/docusaurus-adapter to access DocSearch v4.5+ features
- Register the adapter as a plugin and migrate themeConfig.algolia to themeConfig.docsearch
- Add askAi config with dedicated side-panel button (Cmd+I) and Agent Studio backend
- Retrieve from the openchoreo-llm-md index for paragraph-level markdown content

Refs: openchoreo/openchoreo#3194
Signed-off-by: Miraj Abeysekara <miraj@wso2.com>

Author: Mirage20

docusaurus.config.ts

@@ -49,6 +49,7 @@ const config: Config = {
   },
 
   plugins: [
+    '@docsearch/docusaurus-adapter',
     './plugins/docusaurus-plugin-swagger-dark-mode',
     './plugins/docusaurus-plugin-markdown-export',
     './plugins/docusaurus-plugin-docs-scripts',
@@ -147,11 +148,21 @@ const config: Config = {
         '🎉️ OpenChoreo <a target="_blank" rel="noopener noreferrer" href="https://github.com/openchoreo/openchoreo/releases/tag/v1.0.0">v1.0.0</a> has been released! 🎉',
       isCloseable: true,
     },
-    algolia: {
+    docsearch: {
       appId: 'B8ST9KVWVJ',
       // Public API key: it is safe to commit it
       apiKey: '53ad1b2482e937fc0fa7b577236e6d1a',
       indexName: 'openchoreo',
+      askAi: {
+        assistantId: 'a5c29055-7164-4661-b4ac-8d5c28d4d593',
+        // LLM-optimized index (paragraph-level markdown) used for Ask AI retrieval,
+        // separate from the keyword-oriented DocSearch index above.
+        indexName: 'openchoreo-llm-md',
+        sidePanel: true,
+        // Route chat through Agent Studio (the assistant above was created
+        // under Generative AI → Agent Studio). Experimental per DocSearch docs.
+        agentStudio: true,
+      },
     },
     colorMode: {
       respectPrefersColorScheme: true,

package-lock.json

@@ -19,6 +19,7 @@
     "format:check": "prettier --check \"docs/**/*.{md,mdx}\""
   },
   "dependencies": {
+    "@docsearch/docusaurus-adapter": "^4.6.2",
     "@docusaurus/core": "^3.9.2",
     "@docusaurus/preset-classic": "^3.9.2",
     "@docusaurus/theme-mermaid": "^3.9.2",