feat: integrate Algolia Agent Studio Ask AI search

Upgrade @docsearch/react to v4.6 for Agent Studio support and add
askAi config with a swizzled SearchBar to inject agentStudio flag
that Docusaurus 3.9.2 validation doesn't yet recognize.

Author: charlypa

docusaurus.config.js

@@ -185,7 +185,12 @@ const config = {
 				// Public API key: it is safe to commit it
 				apiKey: "e988677555350573b539eb974e2b7891",
 				indexName: "phcode",
-				contextualSearch: false
+				contextualSearch: false,
+				askAi: {
+					assistantId: "d43f2205-8075-439d-822b-b3825b74cb49",
+					apiKey: "0c73a640624ba54f777a5491ee884aa3",
+					indexName: "markdown-index",
+				}
 			},
 			// Replace with your project's social card
 			image: "img/socialcard.png",

package-lock.json

@@ -19,6 +19,8 @@
     "serveStatic": "http-server build -p 8001 -c-1"
   },
   "dependencies": {
+    "@docsearch/css": "^4.6.0",
+    "@docsearch/react": "^4.6.0",
     "@docusaurus/core": "^3.7.0",
     "@docusaurus/plugin-client-redirects": "^3.7.0",
     "@docusaurus/plugin-google-gtag": "^3.7.0",
@@ -38,6 +40,7 @@
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.9.2",
     "@docusaurus/types": "3.9.2",
+    "baseline-browser-mapping": "^2.10.10",
     "http-server": "14.1.1",
     "shx": "0.4.0"
   },

package.json

@@ -0,0 +1,14 @@
+import SearchBar from '@theme-original/SearchBar';
+import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
+
+// Wrap SearchBar to inject agentStudio: true into askAi config.
+// Docusaurus 3.9.2's Joi validation doesn't recognize agentStudio yet,
+// but @docsearch/react 4.6+ requires it for Agent Studio assistants.
+export default function SearchBarWrapper(props) {
+  const {siteConfig} = useDocusaurusContext();
+  const askAi = siteConfig.themeConfig.algolia?.askAi;
+  if (askAi && !askAi.agentStudio) {
+    askAi.agentStudio = true;
+  }
+  return <SearchBar {...props} />;
+}