react-instantsearch 7.49.1 → 7.50.0

package/dist/umd/ReactInstantSearch.js

@@ -1,4 +1,4 @@
-/*! React InstantSearch 7.49.1 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
+/*! React InstantSearch 7.50.0 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('react')) :
     typeof define === 'function' && define.amd ? define(['exports', 'react'], factory) :
@@ -24,7 +24,7 @@
 
     var React__namespace = /*#__PURE__*/_interopNamespaceDefault(React);
 
-    var version$2 = '7.49.1';
+    var version$2 = '7.50.0';
 
     function _define_property(obj, key, value) {
         if (key in obj) {
@@ -5980,7 +5980,7 @@
         }
     }
 
-    var withUsage$x = createDocumentationMessageGenerator({
+    var withUsage$y = createDocumentationMessageGenerator({
         name: 'configure',
         connector: true
     });
@@ -5996,7 +5996,7 @@
         var renderFn = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : noop, unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
         return function(widgetParams) {
             if (!widgetParams || !isPlainObject(widgetParams.searchParameters)) {
-                throw new Error(withUsage$x('The `searchParameters` option expects an object.'));
+                throw new Error(withUsage$y('The `searchParameters` option expects an object.'));
             }
             var connectorState = {};
             function refine(helper) {
@@ -7808,13 +7808,13 @@
         return null;
     }
 
-    var withUsage$w = createDocumentationMessageGenerator({
+    var withUsage$x = createDocumentationMessageGenerator({
         name: 'dynamic-widgets',
         connector: true
     });
     var connectDynamicWidgets = function connectDynamicWidgets(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$w());
+        checkRendering(renderFn, withUsage$x());
         return function(widgetParams) {
             var widgets = widgetParams.widgets, _widgetParams_maxValuesPerFacet = widgetParams.maxValuesPerFacet, maxValuesPerFacet = _widgetParams_maxValuesPerFacet === void 0 ? 20 : _widgetParams_maxValuesPerFacet, _widgetParams_facets = widgetParams.facets, facets = _widgetParams_facets === void 0 ? [
                 '*'
@@ -7824,10 +7824,10 @@
             if (!(widgets && Array.isArray(widgets) && widgets.every(function(widget) {
                 return (typeof widget === "undefined" ? "undefined" : _type_of(widget)) === 'object';
             }))) {
-                throw new Error(withUsage$w('The `widgets` option expects an array of widgets.'));
+                throw new Error(withUsage$x('The `widgets` option expects an array of widgets.'));
             }
             if (!Array.isArray(facets)) {
-                throw new Error(withUsage$w("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
+                throw new Error(withUsage$x("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
             }
             var localWidgets = new Map();
             return {
@@ -7929,7 +7929,7 @@
                         results: results
                     });
                     if (!Array.isArray(attributesToRender)) {
-                        throw new Error(withUsage$w('The `transformItems` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$x('The `transformItems` option expects a function that returns an Array.'));
                     }
                     return {
                         attributesToRender: attributesToRender,
@@ -8319,19 +8319,19 @@
             return toFeedSearchResults(lastResults._state, raw);
         });
     }
-    var withUsage$v = createDocumentationMessageGenerator({
+    var withUsage$w = createDocumentationMessageGenerator({
         name: 'feeds',
         connector: true
     });
     var connectFeeds = function connectFeeds(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$v());
+        checkRendering(renderFn, withUsage$w());
         return function(widgetParams) {
             var isolated = widgetParams.isolated, _widgetParams_transformFeeds = widgetParams.transformFeeds, transformFeeds = _widgetParams_transformFeeds === void 0 ? function(feeds) {
                 return feeds;
             } : _widgetParams_transformFeeds;
             if (isolated !== false) {
-                throw new Error(withUsage$v('The `isolated` option currently only supports `false`.'));
+                throw new Error(withUsage$w('The `isolated` option currently only supports `false`.'));
             }
             return {
                 $$type: 'ais.feeds',
@@ -8339,7 +8339,7 @@
                 init: function init(initOptions) {
                     var instantSearchInstance = initOptions.instantSearchInstance;
                     if (!instantSearchInstance.compositionID) {
-                        throw new Error(withUsage$v('The `feeds` widget requires a composition-based InstantSearch instance (compositionID must be set).'));
+                        throw new Error(withUsage$w('The `feeds` widget requires a composition-based InstantSearch instance (compositionID must be set).'));
                     }
                     hydrateFeedsFromInitialResultsIfNeeded(instantSearchInstance, initOptions.parent);
                     renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(initOptions)), {
@@ -8385,12 +8385,12 @@
                     ];
                     feedIDs = transformFeeds(feedIDs);
                     if (!Array.isArray(feedIDs)) {
-                        throw new Error(withUsage$v('The `transformFeeds` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$w('The `transformFeeds` option expects a function that returns an Array.'));
                     }
                     if (!feedIDs.every(function(feedID) {
                         return typeof feedID === 'string';
                     })) {
-                        throw new Error(withUsage$v('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
+                        throw new Error(withUsage$w('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
                     }
                     return {
                         feedIDs: feedIDs,
@@ -8501,7 +8501,7 @@
         }));
     }
 
-    var withUsage$u = createDocumentationMessageGenerator({
+    var withUsage$v = createDocumentationMessageGenerator({
         name: 'index-widget'
     });
     /**
@@ -8629,7 +8629,7 @@
     var index = function index(widgetParams) {
         var _widgetParams_EXPERIMENTAL_isolated;
         if (widgetParams === undefined || widgetParams.indexName === undefined && !widgetParams.isolated && !widgetParams.EXPERIMENTAL_isolated) {
-            throw new Error(withUsage$u('The `indexName` option is required.'));
+            throw new Error(withUsage$v('The `indexName` option is required.'));
         }
         // When isolated=true, we use an empty string as the default indexName.
         // This is intentional: isolated indices do not require a real index name.
@@ -8727,7 +8727,7 @@
             addWidgets: function addWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$u('The `addWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$v('The `addWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8737,7 +8737,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.init !== 'function' && typeof widget.render !== 'function';
                 })) {
-                    throw new Error(withUsage$u('The widget definition expects a `render` and/or an `init` method.'));
+                    throw new Error(withUsage$v('The widget definition expects a `render` and/or an `init` method.'));
                 }
                 flatWidgets.forEach(function(widget) {
                     widget.parent = _this;
@@ -8787,10 +8787,10 @@
             },
             updateWidget: function updateWidget(previousWidget, nextWidget) {
                 if (typeof previousWidget.dispose !== 'function') {
-                    throw new Error(withUsage$u('The widget definition expects a `dispose` method.'));
+                    throw new Error(withUsage$v('The widget definition expects a `dispose` method.'));
                 }
                 if (typeof nextWidget.init !== 'function' && typeof nextWidget.render !== 'function') {
-                    throw new Error(withUsage$u('The widget definition expects a `render` and/or an `init` method.'));
+                    throw new Error(withUsage$v('The widget definition expects a `render` and/or an `init` method.'));
                 }
                 // The `uiState` as it is before the previous widget is detached, so that
                 // the state it owns can be handed over to the next widget.
@@ -8874,7 +8874,7 @@
             removeWidgets: function removeWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$u('The `removeWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$v('The `removeWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8884,7 +8884,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.dispose !== 'function';
                 })) {
-                    throw new Error(withUsage$u('The widget definition expects a `dispose` method.'));
+                    throw new Error(withUsage$v('The widget definition expects a `dispose` method.'));
                 }
                 localWidgets = localWidgets.filter(function(widget) {
                     return flatWidgets.indexOf(widget) === -1;
@@ -9392,7 +9392,7 @@
         });
     }
 
-    var version = '4.117.0';
+    var version = '4.118.0';
 
     var ANONYMOUS_TOKEN_COOKIE_KEY = '_ALGOLIA';
     function getCookie(name) {
@@ -11254,7 +11254,7 @@
         };
     }
 
-    var withUsage$t = createDocumentationMessageGenerator({
+    var withUsage$u = createDocumentationMessageGenerator({
         name: 'instantsearch'
     });
     function defaultCreateURL() {
@@ -11325,7 +11325,7 @@
             _this.setMaxListeners(100);
             var _options_indexName = options.indexName, indexName = _options_indexName === void 0 ? '' : _options_indexName, compositionID = options.compositionID, numberLocale = options.numberLocale, _options_initialUiState = options.initialUiState, initialUiState = _options_initialUiState === void 0 ? {} : _options_initialUiState, _options_routing = options.routing, routing = _options_routing === void 0 ? null : _options_routing, _options_insights = options.insights, insights = _options_insights === void 0 ? undefined : _options_insights, searchFunction = options.searchFunction, _options_stalledSearchDelay = options.stalledSearchDelay, stalledSearchDelay = _options_stalledSearchDelay === void 0 ? 200 : _options_stalledSearchDelay, _options_searchClient = options.searchClient, searchClient = _options_searchClient === void 0 ? null : _options_searchClient, _options_insightsClient = options.insightsClient, insightsClient = _options_insightsClient === void 0 ? null : _options_insightsClient, _options_onStateChange = options.onStateChange, onStateChange = _options_onStateChange === void 0 ? null : _options_onStateChange, _options_future1 = options.future, future = _options_future1 === void 0 ? _object_spread({}, INSTANTSEARCH_FUTURE_DEFAULTS, options.future || {}) : _options_future1;
             if (searchClient === null) {
-                throw new Error(withUsage$t('The `searchClient` option is required.'));
+                throw new Error(withUsage$u('The `searchClient` option is required.'));
             }
             if (typeof searchClient.search !== 'function') {
                 throw new Error("The `searchClient` must implement a `search` method.\n\nSee: https://www.algolia.com/doc/guides/building-search-ui/going-further/backend-search/in-depth/backend-instantsearch/js/");
@@ -11334,7 +11334,7 @@
                 searchClient.addAlgoliaAgent("instantsearch.js (".concat(version, ")"));
             }
             if (insightsClient && typeof insightsClient !== 'function') {
-                throw new Error(withUsage$t('The `insightsClient` option should be a function.'));
+                throw new Error(withUsage$u('The `insightsClient` option should be a function.'));
             }
             _this._initialOptions = options;
             _this.client = searchClient;
@@ -11483,12 +11483,12 @@
        * @param widgets The array of widgets to add to InstantSearch.
        */ function addWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$t('The `addWidgets` method expects an array of widgets. Please use `addWidget`.'));
+                        throw new Error(withUsage$u('The `addWidgets` method expects an array of widgets. Please use `addWidget`.'));
                     }
                     if (this.compositionID && widgets.some(function(w) {
                         return !Array.isArray(w) && isIndexWidget(w) && !w._isolated;
                     })) {
-                        throw new Error(withUsage$t('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
+                        throw new Error(withUsage$u('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
                     }
                     this.mainIndex.addWidgets(widgets);
                     return this;
@@ -11517,7 +11517,7 @@
        * The widgets must implement a `dispose()` method to clear their states.
        */ function removeWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$t('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
+                        throw new Error(withUsage$u('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
                     }
                     this.mainIndex.removeWidgets(widgets);
                     return this;
@@ -11531,7 +11531,7 @@
        */ function start() {
                     var _this = this;
                     if (this.started) {
-                        throw new Error(withUsage$t('The `start` method has already been called once.'));
+                        throw new Error(withUsage$u('The `start` method has already been called once.'));
                     }
                     // This Helper is used for the queries, we don't care about its state. The
                     // states are managed at the `index` level. We use this Helper to create
@@ -11739,7 +11739,7 @@
                     var _this = this;
                     var callOnStateChange = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$t('The `start` method needs to be called before `setUiState`.'));
+                        throw new Error(withUsage$u('The `start` method needs to be called before `setUiState`.'));
                     }
                     // We refresh the index UI state to update the local UI state that the
                     // main index passes to the function form of `setUiState`.
@@ -11776,7 +11776,7 @@
                 value: function createURL() {
                     var nextState = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
                     if (!this.started) {
-                        throw new Error(withUsage$t('The `start` method needs to be called before `createURL`.'));
+                        throw new Error(withUsage$u('The `start` method needs to be called before `createURL`.'));
                     }
                     return this._createURL(nextState);
                 }
@@ -11785,7 +11785,7 @@
                 key: "refresh",
                 value: function refresh() {
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$t('The `start` method needs to be called before `refresh`.'));
+                        throw new Error(withUsage$u('The `start` method needs to be called before `refresh`.'));
                     }
                     this.mainHelper.clearCache().search();
                 }
@@ -12298,13 +12298,13 @@
         }, children);
     }
 
-    var withUsage$s = createDocumentationMessageGenerator({
+    var withUsage$t = createDocumentationMessageGenerator({
         name: 'autocomplete',
         connector: true
     });
     var connectAutocomplete = function connectAutocomplete(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$s());
+        checkRendering(renderFn, withUsage$t());
         return function(widgetParams) {
             var _ref = widgetParams || {}, _ref_escapeHTML = _ref.escapeHTML, escapeHTML = _ref_escapeHTML === void 0 ? true : _ref_escapeHTML, _ref_transformItems = _ref.transformItems, transformItems = _ref_transformItems === void 0 ? function(indices) {
                 return indices;
@@ -12417,20 +12417,20 @@
         return useConnector(connectAutocomplete, props, additionalWidgetProperties);
     }
 
-    var withUsage$r = createDocumentationMessageGenerator({
+    var withUsage$s = createDocumentationMessageGenerator({
         name: 'breadcrumb',
         connector: true
     });
     var connectBreadcrumb = function connectBreadcrumb(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$r());
+        checkRendering(renderFn, withUsage$s());
         var connectorState = {};
         return function(widgetParams) {
             var _ref = widgetParams || {}, attributes = _ref.attributes, _ref_separator = _ref.separator, separator = _ref_separator === void 0 ? ' > ' : _ref_separator, _ref_rootPath = _ref.rootPath, rootPath = _ref_rootPath === void 0 ? null : _ref_rootPath, _ref_transformItems = _ref.transformItems, transformItems = _ref_transformItems === void 0 ? function(items) {
                 return items;
             } : _ref_transformItems;
             if (!attributes || !Array.isArray(attributes) || attributes.length === 0) {
-                throw new Error(withUsage$r('The `attributes` option expects an array of strings.'));
+                throw new Error(withUsage$s('The `attributes` option expects an array of strings.'));
             }
             var _attributes = _sliced_to_array(attributes, 1), hierarchicalFacetName = _attributes[0];
             function getRefinedState(state, facetValue) {
@@ -14380,6 +14380,26 @@
             facetFilters: getFacetFilters(query)
         };
     };
+    /**
+     * Whether the agent handed the turn to the Grouped Results tool for this
+     * message, i.e. that tool renders the records and the search tool must not.
+     *
+     * The backend sets exactly one of the two flags, depending on which tool name
+     * the agent was configured with: `groupedResultsEnabled` for
+     * `algolia_grouped_results`, `displayResultsEnabled` for agents still on the
+     * legacy `algolia_display_results`.
+     */ var isGroupedResultsEnabled = function isGroupedResultsEnabled(metadata) {
+        var flags = metadata;
+        return (flags === null || flags === void 0 ? void 0 : flags.groupedResultsEnabled) === true || (flags === null || flags === void 0 ? void 0 : flags.displayResultsEnabled) === true;
+    };
+    /**
+     * `shouldRender` for the search tool: it presents its own records only on turns
+     * the agent did not hand to the Grouped Results tool, which would otherwise
+     * present the same records a second time.
+     */ var shouldSearchToolRenderResults = function shouldSearchToolRenderResults(param) {
+        var parentMessage = param.parentMessage;
+        return !isGroupedResultsEnabled(parentMessage.metadata);
+    };
 
     function n(){return n=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var t in r)Object.prototype.hasOwnProperty.call(r,t)&&(e[t]=r[t]);}return e},n.apply(this,arguments)}const t={blockQuote:"0",breakLine:"1",breakThematic:"2",codeBlock:"3",codeFenced:"4",codeInline:"5",footnote:"6",footnoteReference:"7",gfmTask:"8",heading:"9",headingSetext:"10",htmlBlock:"11",htmlComment:"12",htmlSelfClosing:"13",image:"14",link:"15",linkAngleBraceStyleDetector:"16",linkBareUrlDetector:"17",linkMailtoDetector:"18",newlineCoalescer:"19",orderedList:"20",paragraph:"21",ref:"22",refImage:"23",refLink:"24",table:"25",tableSeparator:"26",text:"27",textBolded:"28",textEmphasized:"29",textEscaped:"30",textMarked:"31",textStrikethroughed:"32",unorderedList:"33"},o=["allowFullScreen","allowTransparency","autoComplete","autoFocus","autoPlay","cellPadding","cellSpacing","charSet","classId","colSpan","contentEditable","contextMenu","crossOrigin","encType","formAction","formEncType","formMethod","formNoValidate","formTarget","frameBorder","hrefLang","inputMode","keyParams","keyType","marginHeight","marginWidth","maxLength","mediaGroup","minLength","noValidate","radioGroup","readOnly","rowSpan","spellCheck","srcDoc","srcLang","srcSet","tabIndex","useMap"].reduce((e,n)=>(e[n.toLowerCase()]=n,e),{class:"className",for:"htmlFor"}),a={amp:"&",apos:"'",gt:">",lt:"<",nbsp:" ",quot:"“"},c=["style","script","pre"],i=["src","href","data","formAction","srcDoc","action"],u=/([-A-Z0-9_:]+)(?:\s*=\s*(?:(?:"((?:\\.|[^"])*)")|(?:'((?:\\.|[^'])*)')|(?:\{((?:\\.|{[^}]*?}|[^}])*)\})))?/gi,l=/\n{2,}$/,s=/^(\s*>[\s\S]*?)(?=\n\n|$)/,f=/^ *> ?/gm,_=/^(?:\[!([^\]]*)\]\n)?([\s\S]*)/,d=/^ {2,}\n/,p=/^(?:([-*_])( *\1){2,}) *(?:\n *)+\n/,y=/^(?: {1,3})?(`{3,}|~{3,}) *(\S+)? *([^\n]*?)?\n([\s\S]*?)(?:\1\n?|$)/,h=/^(?: {4}[^\n]+\n*)+(?:\n *)+\n?/,g=/^(`+)((?:\\`|(?!\1)`|[^`])+)\1/,m=/^(?:\n *)*\n/,k=/\r\n?/g,x=/^\[\^([^\]]+)](:(.*)((\n+ {4,}.*)|(\n(?!\[\^).+))*)/,q=/^\[\^([^\]]+)]/,v=/\f/g,b=/^---[ \t]*\n(.|\n)*\n---[ \t]*\n/,$=/^\s*?\[(x|\s)\]/,S=/^ *(#{1,6}) *([^\n]+?)(?: +#*)?(?:\n *)*(?:\n|$)/,z=/^ *(#{1,6}) +([^\n]+?)(?: +#*)?(?:\n *)*(?:\n|$)/,E=/^([^\n]+)\n *(=|-)\2{2,} *\n/,A=/^ *(?!<[a-z][^ >/]* ?\/>)<([a-z][^ >/]*) ?((?:[^>]*[^/])?)>\n?(\s*(?:<\1[^>]*?>[\s\S]*?<\/\1>|(?!<\1\b)[\s\S])*?)<\/\1>(?!<\/\1>)\n*/i,R=/&([a-z0-9]+|#[0-9]{1,6}|#x[0-9a-fA-F]{1,6});/gi,B=/^<!--[\s\S]*?(?:-->)/,L=/^(data|aria|x)-[a-z_][a-z\d_.-]*$/,O=/^ *<([a-z][a-z0-9:]*)(?:\s+((?:<.*?>|[^>])*))?\/?>(?!<\/\1>)(\s*\n)?/i,j=/^\{.*\}$/,C=/^(https?:\/\/[^\s<]+[^<.,:;"')\]\s])/,I=/^<([^ >]+[:@\/][^ >]+)>/,T=/-([a-z])?/gi,M=/^(\|.*)\n(?: *(\|? *[-:]+ *\|[-| :]*)\n((?:.*\|.*\n)*))?\n?/,w=/^[^\n]+(?:  \n|\n{2,})/,D=/^\[([^\]]*)\]:\s+<?([^\s>]+)>?\s*("([^"]*)")?/,F=/^!\[([^\]]*)\] ?\[([^\]]*)\]/,P=/^\[([^\]]*)\] ?\[([^\]]*)\]/,Z=/(\n|^[-*]\s|^#|^ {2,}|^-{2,}|^>\s)/,N=/\t/g,G=/(^ *\||\| *$)/g,U=/^ *:-+: *$/,V=/^ *:-+ *$/,H=/^ *-+: *$/,Q=e=>`(?=[\\s\\S]+?\\1${e?"\\1":""})`,W="((?:\\[.*?\\][([].*?[)\\]]|<.*?>(?:.*?<.*?>)?|`.*?`|\\\\\\1|[\\s\\S])+?)",J=RegExp(`^([*_])\\1${Q(1)}${W}\\1\\1(?!\\1)`),K=RegExp(`^([*_])${Q(0)}${W}\\1(?!\\1)`),X=RegExp(`^(==)${Q(0)}${W}\\1`),Y=RegExp(`^(~~)${Q(0)}${W}\\1`),ee=/^(:[a-zA-Z0-9-_]+:)/,ne=/^\\([^0-9A-Za-z\s])/,re=/\\([^0-9A-Za-z\s])/g,te=/^[\s\S](?:(?!  \n|[0-9]\.|http)[^=*_~\-\n:<`\\\[!])*/,oe=/^\n+/,ae=/^([ \t]*)/,ce=/(?:^|\n)( *)$/,ie="(?:\\d+\\.)",ue="(?:[*+-])";function le(e){return "( *)("+(1===e?ie:ue)+") +"}const se=le(1),fe=le(2);function _e(e){return RegExp("^"+(1===e?se:fe))}const de=_e(1),pe=_e(2);function ye(e){return RegExp("^"+(1===e?se:fe)+"[^\\n]*(?:\\n(?!\\1"+(1===e?ie:ue)+" )[^\\n]*)*(\\n|$)","gm")}const he=ye(1),ge=ye(2);function me(e){const n=1===e?ie:ue;return RegExp("^( *)("+n+") [\\s\\S]+?(?:\\n{2,}(?! )(?!\\1"+n+" (?!"+n+" ))\\n*|\\s*\\n*$)")}const ke=me(1),xe=me(2);function qe(e,n){const r=1===n,t=r?ke:xe,o=r?he:ge,a=r?de:pe;return {t:e=>a.test(e),o:je(function(e,n){const r=ce.exec(n.prevCapture);return r&&(n.list||!n.inline&&!n.simple)?t.exec(e=r[1]+e):null}),i:1,u(e,n,t){const c=r?+e[2]:void 0,i=e[0].replace(l,"\n").match(o);let u=!1;return {items:i.map(function(e,r){const o=a.exec(e)[0].length,c=RegExp("^ {1,"+o+"}","gm"),l=e.replace(c,"").replace(a,""),s=r===i.length-1,f=-1!==l.indexOf("\n\n")||s&&u;u=f;const _=t.inline,d=t.list;let p;t.list=!0,f?(t.inline=!1,p=Se(l)+"\n\n"):(t.inline=!0,p=Se(l));const y=n(p,t);return t.inline=_,t.list=d,y}),ordered:r,start:c}},l:(n,r,t)=>e(n.ordered?"ol":"ul",{key:t.key,start:"20"===n.type?n.start:void 0},n.items.map(function(n,o){return e("li",{key:o},r(n,t))}))}}const ve=RegExp("^\\[((?:\\[[^\\[\\]]*(?:\\[[^\\[\\]]*\\][^\\[\\]]*)*\\]|[^\\[\\]])*)\\]\\(\\s*<?((?:\\([^)]*\\)|[^\\s\\\\]|\\\\.)*?)>?(?:\\s+['\"]([\\s\\S]*?)['\"])?\\s*\\)"),be=/^!\[(.*?)\]\( *((?:\([^)]*\)|[^() ])*) *"?([^)"]*)?"?\)/;function $e(e){return "string"==typeof e}function Se(e){let n=e.length;for(;n>0&&e[n-1]<=" ";)n--;return e.slice(0,n)}function ze(e,n){return e.startsWith(n)}function Ee(e,n,r){if(Array.isArray(r)){for(let n=0;n<r.length;n++)if(ze(e,r[n]))return !0;return !1}return r(e,n)}function Ae(e){return e.replace(/[ÀÁÂÃÄÅàáâãäåæÆ]/g,"a").replace(/[çÇ]/g,"c").replace(/[ðÐ]/g,"d").replace(/[ÈÉÊËéèêë]/g,"e").replace(/[ÏïÎîÍíÌì]/g,"i").replace(/[Ññ]/g,"n").replace(/[øØœŒÕõÔôÓóÒò]/g,"o").replace(/[ÜüÛûÚúÙù]/g,"u").replace(/[ŸÿÝý]/g,"y").replace(/[^a-z0-9- ]/gi,"").replace(/ /gi,"-").toLowerCase()}function Re(e){return H.test(e)?"right":U.test(e)?"center":V.test(e)?"left":null}function Be(e,n,r,t){const o=r.inTable;r.inTable=!0;let a=[[]],c="";function i(){if(!c)return;const e=a[a.length-1];e.push.apply(e,n(c,r)),c="";}return e.trim().split(/(`[^`]*`|\\\||\|)/).filter(Boolean).forEach((e,n,r)=>{"|"===e.trim()&&(i(),t)?0!==n&&n!==r.length-1&&a.push([]):c+=e;}),i(),r.inTable=o,a}function Le(e,n,r){r.inline=!0;const t=e[2]?e[2].replace(G,"").split("|").map(Re):[],o=e[3]?function(e,n,r){return e.trim().split("\n").map(function(e){return Be(e,n,r,!0)})}(e[3],n,r):[],a=Be(e[1],n,r,!!o.length);return r.inline=!1,o.length?{align:t,cells:o,header:a,type:"25"}:{children:a,type:"21"}}function Oe(e,n){return null==e.align[n]?{}:{textAlign:e.align[n]}}function je(e){return e.inline=1,e}function Ce(e){return je(function(n,r){return r.inline?e.exec(n):null})}function Ie(e){return je(function(n,r){return r.inline||r.simple?e.exec(n):null})}function Te(e){return function(n,r){return r.inline||r.simple?null:e.exec(n)}}function Me(e){return je(function(n){return e.exec(n)})}const we=/(javascript|vbscript|data(?!:image)):/i;function De(e){try{const n=decodeURIComponent(e).replace(/[^A-Za-z0-9/:]/g,"");if(we.test(n))return null}catch(e){return null}return e}function Fe(e){return e?e.replace(re,"$1"):e}function Pe(e,n,r){const t=r.inline||!1,o=r.simple||!1;r.inline=!0,r.simple=!0;const a=e(n,r);return r.inline=t,r.simple=o,a}function Ze(e,n,r){const t=r.inline||!1,o=r.simple||!1;r.inline=!1,r.simple=!0;const a=e(n,r);return r.inline=t,r.simple=o,a}function Ne(e,n,r){const t=r.inline||!1;r.inline=!1;const o=e(n,r);return r.inline=t,o}const Ge=(e,n,r)=>({children:Pe(n,e[2],r)});function Ue(){return {}}function Ve(){return null}function He(...e){return e.filter(Boolean).join(" ")}function Qe(e,n,r){let t=e;const o=n.split(".");for(;o.length&&(t=t[o[0]],void 0!==t);)o.shift();return t||r}function We(r="",t={}){t.overrides=t.overrides||{},t.namedCodesToUnicode=t.namedCodesToUnicode?n({},a,t.namedCodesToUnicode):a;const l=t.slugify||Ae,G=t.sanitizer||De,U=t.createElement||React__namespace.createElement,V=[s,y,h,t.enforceAtxHeadings?z:S,E,M,ke,xe],H=[...V,w,A,B,O];function Q(e,n){for(let r=0;r<e.length;r++)if(e[r].test(n))return !0;return !1}function W(e,r,...o){const a=Qe(t.overrides,e+".props",{});return U(function(e,n){const r=Qe(n,e);return r?"function"==typeof r||"object"==typeof r&&"render"in r?r:Qe(n,e+".component",e):e}(e,t.overrides),n({},r,a,{className:He(null==r?void 0:r.className,a.className)||void 0}),...o)}function re(e){e=e.replace(b,"");let n=!1;t.forceInline?n=!0:t.forceBlock||(n=!1===Z.test(e));const r=fe(se(n?e:Se(e).replace(oe,"")+"\n\n",{inline:n}));for(;$e(r[r.length-1])&&!r[r.length-1].trim();)r.pop();if(null===t.wrapper)return r;const o=t.wrapper||(n?"span":"div");let a;if(r.length>1||t.forceWrapper)a=r;else {if(1===r.length)return a=r[0],"string"==typeof a?W("span",{key:"outer"},a):a;a=null;}return U(o,{key:"outer"},a)}function ce(e,n){if(!n||!n.trim())return null;const r=n.match(u);return r?r.reduce(function(n,r){const t=r.indexOf("=");if(-1!==t){const a=function(e){return -1!==e.indexOf("-")&&null===e.match(L)&&(e=e.replace(T,function(e,n){return n.toUpperCase()})),e}(r.slice(0,t)).trim(),c=function(e){const n=e[0];return ('"'===n||"'"===n)&&e.length>=2&&e[e.length-1]===n?e.slice(1,-1):e}(r.slice(t+1).trim()),u=o[a]||a;if("ref"===u)return n;const l=n[u]=function(e,n,r,t){return "style"===n?function(e){const n=[];let r="",t=!1,o=!1,a="";if(!e)return n;for(let c=0;c<e.length;c++){const i=e[c];if('"'!==i&&"'"!==i||t||(o?i===a&&(o=!1,a=""):(o=!0,a=i)),"("===i&&r.endsWith("url")?t=!0:")"===i&&t&&(t=!1),";"!==i||o||t)r+=i;else {const e=r.trim();if(e){const r=e.indexOf(":");if(r>0){const t=e.slice(0,r).trim(),o=e.slice(r+1).trim();n.push([t,o]);}}r="";}}const c=r.trim();if(c){const e=c.indexOf(":");if(e>0){const r=c.slice(0,e).trim(),t=c.slice(e+1).trim();n.push([r,t]);}}return n}(r).reduce(function(n,[r,o]){return n[r.replace(/(-[a-z])/g,e=>e[1].toUpperCase())]=t(o,e,r),n},{}):-1!==i.indexOf(n)?t(Fe(r),e,n):(r.match(j)&&(r=Fe(r.slice(1,r.length-1))),"true"===r||"false"!==r&&r)}(e,a,c,G);"string"==typeof l&&(A.test(l)||O.test(l))&&(n[u]=re(l.trim()));}else "style"!==r&&(n[o[r]||r]=!0);return n},{}):null}const ie=[],ue={},le={0:{t:[">"],o:Te(s),i:1,u(e,n,r){const[,t,o]=e[0].replace(f,"").match(_);return {alert:t,children:n(o,r)}},l(e,n,r){const t={key:r.key};return e.alert&&(t.className="markdown-alert-"+l(e.alert.toLowerCase(),Ae),e.children.unshift({attrs:{},children:[{type:"27",text:e.alert}],noInnerParse:!0,type:"11",tag:"header"})),W("blockquote",t,n(e.children,r))}},1:{t:["  "],o:Me(d),i:1,u:Ue,l:(e,n,r)=>W("br",{key:r.key})},2:{t:["--","__","**","- ","* ","_ "],o:Te(p),i:1,u:Ue,l:(e,n,r)=>W("hr",{key:r.key})},3:{t:["    "],o:Te(h),i:0,u:e=>({lang:void 0,text:Fe(Se(e[0].replace(/^ {4}/gm,"")))}),l:(e,r,t)=>W("pre",{key:t.key},W("code",n({},e.attrs,{className:e.lang?"lang-"+e.lang:""}),e.text))},4:{t:["```","~~~"],o:Te(y),i:0,u:e=>({attrs:ce("code",e[3]||""),lang:e[2]||void 0,text:e[4],type:"3"})},5:{t:["`"],o:Ie(g),i:3,u:e=>({text:Fe(e[2])}),l:(e,n,r)=>W("code",{key:r.key},e.text)},6:{t:["[^"],o:Te(x),i:0,u:e=>(ie.push({footnote:e[2],identifier:e[1]}),{}),l:Ve},7:{t:["[^"],o:Ce(q),i:1,u:e=>({target:"#"+l(e[1],Ae),text:e[1]}),l:(e,n,r)=>W("a",{key:r.key,href:G(e.target,"a","href")},W("sup",{key:r.key},e.text))},8:{t:["[ ]","[x]"],o:Ce($),i:1,u:e=>({completed:"x"===e[1].toLowerCase()}),l:(e,n,r)=>W("input",{checked:e.completed,key:r.key,readOnly:!0,type:"checkbox"})},9:{t:["#"],o:Te(t.enforceAtxHeadings?z:S),i:1,u:(e,n,r)=>({children:Pe(n,e[2],r),id:l(e[2],Ae),level:e[1].length}),l:(e,n,r)=>W("h"+e.level,{id:e.id,key:r.key},n(e.children,r))},10:{t:e=>{const n=e.indexOf("\n");return n>0&&n<e.length-1&&("="===e[n+1]||"-"===e[n+1])},o:Te(E),i:0,u:(e,n,r)=>({children:Pe(n,e[1],r),level:"="===e[2]?1:2,type:"9"})},11:{t:["<"],o:Me(A),i:1,u(e,n,r){const[,t]=e[3].match(ae),o=RegExp("^"+t,"gm"),a=e[3].replace(o,""),i=Q(H,a)?Ne:Pe,u=e[1].toLowerCase(),l=-1!==c.indexOf(u),s=(l?u:e[1]).trim(),f={attrs:ce(s,e[2]),noInnerParse:l,tag:s};if(r.inAnchor=r.inAnchor||"a"===u,l)f.text=e[3];else {const e=r.inHTML;r.inHTML=!0,f.children=i(n,a,r),r.inHTML=e;}return r.inAnchor=!1,f},l:(e,r,t)=>W(e.tag,n({key:t.key},e.attrs),e.text||(e.children?r(e.children,t):""))},13:{t:["<"],o:Me(O),i:1,u(e){const n=e[1].trim();return {attrs:ce(n,e[2]||""),tag:n}},l:(e,r,t)=>W(e.tag,n({},e.attrs,{key:t.key}))},12:{t:["\x3c!--"],o:Me(B),i:1,u:()=>({}),l:Ve},14:{t:["!["],o:Ie(be),i:1,u:e=>({alt:Fe(e[1]),target:Fe(e[2]),title:Fe(e[3])}),l:(e,n,r)=>W("img",{key:r.key,alt:e.alt||void 0,title:e.title||void 0,src:G(e.target,"img","src")})},15:{t:["["],o:Ce(ve),i:3,u:(e,n,r)=>({children:Ze(n,e[1],r),target:Fe(e[2]),title:Fe(e[3])}),l:(e,n,r)=>W("a",{key:r.key,href:G(e.target,"a","href"),title:e.title},n(e.children,r))},16:{t:["<"],o:Ce(I),i:0,u(e){let n=e[1],r=!1;return -1!==n.indexOf("@")&&-1===n.indexOf("//")&&(r=!0,n=n.replace("mailto:","")),{children:[{text:n,type:"27"}],target:r?"mailto:"+n:n,type:"15"}}},17:{t:(e,n)=>!n.inAnchor&&!t.disableAutoLink&&(ze(e,"http://")||ze(e,"https://")),o:Ce(C),i:0,u:e=>({children:[{text:e[1],type:"27"}],target:e[1],title:void 0,type:"15"})},20:qe(W,1),33:qe(W,2),19:{t:["\n"],o:Te(m),i:3,u:Ue,l:()=>"\n"},21:{o:je(function(e,n){if(n.inline||n.simple||n.inHTML&&-1===e.indexOf("\n\n")&&-1===n.prevCapture.indexOf("\n\n"))return null;let r="",t=0;for(;;){const n=e.indexOf("\n",t),o=e.slice(t,-1===n?void 0:n+1);if(Q(V,o))break;if(r+=o,-1===n||!o.trim())break;t=n+1;}const o=Se(r);return ""===o?null:[r,,o]}),i:3,u:Ge,l:(e,n,r)=>W("p",{key:r.key},n(e.children,r))},22:{t:["["],o:Ce(D),i:0,u:e=>(ue[e[1]]={target:e[2],title:e[4]},{}),l:Ve},23:{t:["!["],o:Ie(F),i:0,u:e=>({alt:e[1]?Fe(e[1]):void 0,ref:e[2]}),l:(e,n,r)=>ue[e.ref]?W("img",{key:r.key,alt:e.alt,src:G(ue[e.ref].target,"img","src"),title:ue[e.ref].title}):null},24:{t:e=>"["===e[0]&&-1===e.indexOf("]("),o:Ce(P),i:0,u:(e,n,r)=>({children:n(e[1],r),fallbackChildren:e[0],ref:e[2]}),l:(e,n,r)=>ue[e.ref]?W("a",{key:r.key,href:G(ue[e.ref].target,"a","href"),title:ue[e.ref].title},n(e.children,r)):W("span",{key:r.key},e.fallbackChildren)},25:{t:["|"],o:Te(M),i:1,u:Le,l(e,n,r){const t=e;return W("table",{key:r.key},W("thead",null,W("tr",null,t.header.map(function(e,o){return W("th",{key:o,style:Oe(t,o)},n(e,r))}))),W("tbody",null,t.cells.map(function(e,o){return W("tr",{key:o},e.map(function(e,o){return W("td",{key:o,style:Oe(t,o)},n(e,r))}))})))}},27:{o:je(function(e,n){let r;return ze(e,":")&&(r=ee.exec(e)),r||te.exec(e)}),i:4,u(e){const n=e[0];return {text:-1===n.indexOf("&")?n:n.replace(R,(e,n)=>t.namedCodesToUnicode[n]||e)}},l:e=>e.text},28:{t:["**","__"],o:Ie(J),i:2,u:(e,n,r)=>({children:n(e[2],r)}),l:(e,n,r)=>W("strong",{key:r.key},n(e.children,r))},29:{t:e=>{const n=e[0];return ("*"===n||"_"===n)&&e[1]!==n},o:Ie(K),i:3,u:(e,n,r)=>({children:n(e[2],r)}),l:(e,n,r)=>W("em",{key:r.key},n(e.children,r))},30:{t:["\\"],o:Ie(ne),i:1,u:e=>({text:e[1],type:"27"})},31:{t:["=="],o:Ie(X),i:3,u:Ge,l:(e,n,r)=>W("mark",{key:r.key},n(e.children,r))},32:{t:["~~"],o:Ie(Y),i:3,u:Ge,l:(e,n,r)=>W("del",{key:r.key},n(e.children,r))}};!0===t.disableParsingRawHTML&&(delete le[11],delete le[13]);const se=function(e){var n=Object.keys(e);function r(t,o){var a=[];if(o.prevCapture=o.prevCapture||"",t.trim())for(;t;)for(var c=0;c<n.length;){var i=n[c],u=e[i];if(!u.t||Ee(t,o,u.t)){var l=u.o(t,o);if(l&&l[0]){t=t.substring(l[0].length);var s=u.u(l,r,o);o.prevCapture+=l[0],s.type||(s.type=i),a.push(s);break}c++;}else c++;}return o.prevCapture="",a}return n.sort(function(n,r){return e[n].i-e[r].i||(n<r?-1:1)}),function(e,n){return r(function(e){return e.replace(k,"\n").replace(v,"").replace(N,"    ")}(e),n)}}(le),fe=function(e,n){return function r(t,o={}){if(Array.isArray(t)){const e=o.key,n=[];let a=!1;for(let e=0;e<t.length;e++){o.key=e;const c=r(t[e],o),i=$e(c);i&&a?n[n.length-1]+=c:null!==c&&n.push(c),a=i;}return o.key=e,n}return function(r,t,o){const a=e[r.type].l;return n?n(()=>a(r,t,o),r,t,o):a(r,t,o)}(t,r,o)}}(le,t.renderRule),_e=re(r);return ie.length?W("div",null,_e,W("footer",{key:"footer"},ie.map(function(e){return W("div",{id:l(e.identifier,Ae),key:e.identifier},e.identifier,fe(se(e.footnote,{inline:!0})))}))):_e}
 
@@ -16372,13 +16392,144 @@
         };
     }
 
+    var defaultComparisonTableTranslations = {
+        missingValueLabel: '—',
+        productColumnLabel: 'Product'
+    };
+    /** The display name of a product, sourced ONLY from the catalog record. */ function productLabel(hit) {
+        var _ref, _hit_name;
+        if (!hit) {
+            return undefined;
+        }
+        return (_ref = (_hit_name = hit.name) !== null && _hit_name !== void 0 ? _hit_name : hit.title) !== null && _ref !== void 0 ? _ref : hit.objectID;
+    }
+    /**
+     * Catalog values are arbitrary JSON. Primitives (and arrays of them) have an
+     * obvious textual form; objects (e.g. `price: { value, currency }`) would
+     * stringify to `[object Object]`, so they render as the missing marker
+     * instead — an honest "no displayable value" beats a garbled cell.
+     */ function formatCellValue(value) {
+        if (value === undefined || value === null || value === '') {
+            return undefined;
+        }
+        if (Array.isArray(value)) {
+            var printable = value.filter(function(item) {
+                return typeof item === 'string' && item !== '' || typeof item === 'number' || typeof item === 'boolean';
+            });
+            return printable.length > 0 ? printable.join(', ') : undefined;
+        }
+        if ((typeof value === "undefined" ? "undefined" : _type_of(value)) === 'object') {
+            return undefined;
+        }
+        return String(value);
+    }
+    function createGroundedComparisonTableComponent(param) {
+        var createElement = param.createElement, Fragment = param.Fragment;
+        return function GroundedComparisonTable(props) {
+            var _ref;
+            var intro = props.intro, objectIDs = props.objectIDs, attributes = props.attributes, columns = props.columns, records = props.records;
+            var translations = props.translations;
+            if (objectIDs.length === 0) {
+                return /*#__PURE__*/ createElement(Fragment, null);
+            }
+            // `columns` is model-authored and only trusted when it labels EVERY
+            // column (`[product, ...attributes]`). A shorter list would shift labels
+            // onto the wrong cells — `['Price', 'Rating']` over product/price/rating
+            // puts the product names under "Price". Misaligned input falls back to
+            // the attribute keys: correct data under plain headers.
+            var columnLabels = columns && columns.length === attributes.length + 1 ? columns : undefined;
+            var headerLabels = [
+                (_ref = columnLabels === null || columnLabels === void 0 ? void 0 : columnLabels[0]) !== null && _ref !== void 0 ? _ref : translations.productColumnLabel
+            ].concat(_to_consumable_array(attributes.map(function(attr, index) {
+                var _ref;
+                return (_ref = columnLabels === null || columnLabels === void 0 ? void 0 : columnLabels[index + 1]) !== null && _ref !== void 0 ? _ref : attr;
+            })));
+            return /*#__PURE__*/ createElement("div", {
+                className: "ais-ChatToolComparisonTable"
+            }, intro && /*#__PURE__*/ createElement("div", {
+                className: "ais-ChatToolComparisonTable-intro"
+            }, intro), /*#__PURE__*/ createElement("table", {
+                className: "ais-ChatToolComparisonTable-table"
+            }, /*#__PURE__*/ createElement("thead", null, /*#__PURE__*/ createElement("tr", null, headerLabels.map(function(label, index) {
+                return /*#__PURE__*/ createElement("th", {
+                    key: "h-".concat(index),
+                    scope: "col",
+                    className: "ais-ChatToolComparisonTable-header"
+                }, label);
+            }))), /*#__PURE__*/ createElement("tbody", null, objectIDs.map(function(objectID) {
+                var _formatCellValue;
+                var hit = records === null || records === void 0 ? void 0 : records.get(objectID);
+                var name = productLabel(hit);
+                return /*#__PURE__*/ createElement("tr", {
+                    key: objectID,
+                    "data-object-id": objectID,
+                    className: "ais-ChatToolComparisonTable-row"
+                }, /*#__PURE__*/ createElement("th", {
+                    scope: "row",
+                    "data-testid": "product-".concat(objectID),
+                    className: "ais-ChatToolComparisonTable-product"
+                }, (_formatCellValue = formatCellValue(name)) !== null && _formatCellValue !== void 0 ? _formatCellValue : translations.missingValueLabel), attributes.map(function(attribute) {
+                    // The ONLY source of a cell value is the catalog record.
+                    var value = formatCellValue(hit ? hit[attribute] : undefined);
+                    return /*#__PURE__*/ createElement("td", {
+                        key: "".concat(objectID, "-").concat(attribute),
+                        "data-testid": "cell-".concat(objectID, "-").concat(attribute),
+                        className: "ais-ChatToolComparisonTable-cell"
+                    }, value !== null && value !== void 0 ? value : translations.missingValueLabel);
+                }));
+            }))));
+        };
+    }
+
+    /** Keeps only non-empty string entries, dropping anything else the model sent. */ function stringList(value) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        return value.filter(function(entry) {
+            return typeof entry === 'string' && entry !== '';
+        });
+    }
+    function createCompareProductsToolComponent(param) {
+        var createElement = param.createElement, Fragment = param.Fragment;
+        var GroundedComparisonTable = createGroundedComparisonTableComponent({
+            createElement: createElement,
+            Fragment: Fragment
+        });
+        return function CompareProductsTool(userProps) {
+            var _message_input;
+            var toolProps = userProps.toolProps, userTranslations = userProps.translations;
+            var _toolProps_context = toolProps.context, message = _toolProps_context.message, records = _toolProps_context.records;
+            var translations = _object_spread({}, defaultComparisonTableTranslations, userTranslations);
+            // Wait for the agent's arguments to be complete before rendering.
+            if (!message || message.state !== 'input-available' && message.state !== 'output-available') {
+                return /*#__PURE__*/ createElement(Fragment, null);
+            }
+            var input = (_message_input = message.input) !== null && _message_input !== void 0 ? _message_input : {};
+            var objectIDs = stringList(input.objectIDs);
+            var attributes = stringList(input.attributes);
+            var columns = Array.isArray(input.columns) ? stringList(input.columns) : undefined;
+            var intro = typeof input.intro === 'string' ? input.intro : undefined;
+            if (objectIDs.length === 0) {
+                return /*#__PURE__*/ createElement(Fragment, null);
+            }
+            return /*#__PURE__*/ createElement(GroundedComparisonTable, {
+                intro: intro,
+                objectIDs: objectIDs,
+                attributes: attributes,
+                columns: columns,
+                records: records,
+                translations: translations
+            });
+        };
+    }
+
     var isObject = function isObject(value) {
         return value !== null && (typeof value === "undefined" ? "undefined" : _type_of(value)) === 'object';
     };
     var hasOwn = function hasOwn(value, key) {
         return Object.prototype.hasOwnProperty.call(value, key);
     };
-    var claimsDisplayResultsPayload = function claimsDisplayResultsPayload(value) {
+    var claimsGroupedResultsPayload = function claimsGroupedResultsPayload(value) {
         return isObject(value) && (hasOwn(value, 'intro') || hasOwn(value, 'groups'));
     };
     /**
@@ -16453,21 +16604,21 @@
         }
         return inString && !isKey && ((_frames_ = frames[frames.length - 1]) === null || _frames_ === void 0 ? void 0 : _frames_.lastKey) === 'objectID' && ((_frames_1 = frames[frames.length - 2]) === null || _frames_1 === void 0 ? void 0 : _frames_1.key) === 'results' && ((_frames_2 = frames[frames.length - 4]) === null || _frames_2 === void 0 ? void 0 : _frames_2.key) === 'groups';
     };
-    var DEFAULT_TRANSLATIONS$1 = {
+    var DEFAULT_TRANSLATIONS$2 = {
         streamingLabel: 'Curating results…'
     };
-    function createDisplayResultsToolComponent(param) {
+    function createGroupedResultsToolComponent(param) {
         var createElement = param.createElement, Fragment = param.Fragment, useEffect = param.useEffect, useRef = param.useRef;
-        return function DisplayResultsTool(userProps) {
+        return function GroupedResultsTool(userProps) {
             var _ref;
             var toolProps = userProps.toolProps, renderGroupCarousel = userProps.groupCarouselComponent, userTranslations = userProps.translations;
             var context = toolProps.context;
             var message = context.message, insightsEventContext = context.insightsEventContext, sendEvent = context.sendEvent, messages = context.messages, status = context.status, records = context.records;
             var instantSearchStatus = (_ref = insightsEventContext === null || insightsEventContext === void 0 ? void 0 : insightsEventContext.instantSearchStatus) !== null && _ref !== void 0 ? _ref : 'idle';
-            var translations = _object_spread({}, DEFAULT_TRANSLATIONS$1, userTranslations);
-            var inputClaimsPayload = claimsDisplayResultsPayload(message === null || message === void 0 ? void 0 : message.input);
+            var translations = _object_spread({}, DEFAULT_TRANSLATIONS$2, userTranslations);
+            var inputClaimsPayload = claimsGroupedResultsPayload(message === null || message === void 0 ? void 0 : message.input);
             var legacyOutput = (message === null || message === void 0 ? void 0 : message.state) === 'output-available' && message.preliminary !== true && !inputClaimsPayload ? message.output : undefined;
-            var payload = inputClaimsPayload ? message === null || message === void 0 ? void 0 : message.input : claimsDisplayResultsPayload(legacyOutput) ? legacyOutput : undefined;
+            var payload = inputClaimsPayload ? message === null || message === void 0 ? void 0 : message.input : claimsGroupedResultsPayload(legacyOutput) ? legacyOutput : undefined;
             var intro = typeof (payload === null || payload === void 0 ? void 0 : payload.intro) === 'string' ? payload.intro : undefined;
             var groups = Array.isArray(payload === null || payload === void 0 ? void 0 : payload.groups) ? payload.groups.filter(isObject) : [];
             var latestMessage = messages === null || messages === void 0 ? void 0 : messages[messages.length - 1];
@@ -16493,7 +16644,7 @@
                     renderedItems.push(_object_spread_props(_object_spread({}, hydrated), {
                         objectID: result.objectID,
                         __position: renderedItems.length + 1,
-                        __displayToolResult: result
+                        __groupedToolResult: result
                     }));
                     return renderedItems;
                 }, []);
@@ -16536,27 +16687,112 @@
                 return /*#__PURE__*/ createElement(Fragment, null);
             }
             return /*#__PURE__*/ createElement("div", {
-                className: "ais-ChatToolDisplayResults"
+                className: "ais-ChatToolGroupedResults"
             }, intro && /*#__PURE__*/ createElement("div", {
-                className: "ais-ChatToolDisplayResults-intro"
+                className: "ais-ChatToolGroupedResults-intro"
             }, intro), renderableGroups.map(function(group) {
                 return /*#__PURE__*/ createElement("div", {
                     key: group.key,
-                    className: "ais-ChatToolDisplayResults-group"
+                    className: "ais-ChatToolGroupedResults-group"
                 }, group.title && /*#__PURE__*/ createElement("div", {
-                    className: "ais-ChatToolDisplayResults-groupTitle"
+                    className: "ais-ChatToolGroupedResults-groupTitle"
                 }, group.title), group.why && /*#__PURE__*/ createElement("div", {
-                    className: "ais-ChatToolDisplayResults-groupWhy"
+                    className: "ais-ChatToolGroupedResults-groupWhy"
                 }, group.why), renderGroupCarousel({
                     items: group.items,
                     sendEvent: sendEvent
                 }));
             }), isStreaming && /*#__PURE__*/ createElement("div", {
-                className: "ais-ChatToolDisplayResults-streaming"
+                className: "ais-ChatToolGroupedResults-streaming"
             }, translations.streamingLabel));
         };
     }
 
+    var DEFAULT_TRANSLATIONS$1 = {
+        title: 'Compare',
+        countText: function countText(count, maxItems) {
+            return "".concat(count, " of ").concat(maxItems);
+        },
+        compareButtonText: function compareButtonText(count) {
+            return "Compare ".concat(count);
+        },
+        clearButtonText: 'Clear all',
+        removeItemLabel: function removeItemLabel(itemLabel) {
+            return "Remove ".concat(itemLabel, " from comparison");
+        },
+        minItemsHint: function minItemsHint(minItems) {
+            return "Select at least ".concat(minItems, " products to compare.");
+        },
+        limitReachedHint: 'Compare limit reached — remove a product to add another.'
+    };
+    /** The display label of a selected record. */ function getCompareBarItemLabel(item) {
+        var _item_name;
+        var label = (_item_name = item.name) !== null && _item_name !== void 0 ? _item_name : item.title;
+        return typeof label === 'string' && label !== '' ? label : item.objectID;
+    }
+    function createCompareBarComponent(param) {
+        var createElement = param.createElement;
+        var Button = createButtonComponent({
+            createElement: createElement
+        });
+        return function CompareBar(userProps) {
+            var items = userProps.items, minItems = userProps.minItems, maxItems = userProps.maxItems, canCompare = userProps.canCompare, onCompare = userProps.onCompare, onRemove = userProps.onRemove, onClear = userProps.onClear, ItemComponent = userProps.itemComponent, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, userTranslations = userProps.translations;
+            var translations = _object_spread({}, DEFAULT_TRANSLATIONS$1, userTranslations);
+            if (items.length === 0) {
+                return null;
+            }
+            var hint = items.length < minItems ? translations.minItemsHint(minItems) : items.length >= maxItems ? translations.limitReachedHint : undefined;
+            return /*#__PURE__*/ createElement("section", {
+                className: cx('ais-CompareBar', classNames.root),
+                "aria-label": translations.title
+            }, /*#__PURE__*/ createElement("div", {
+                className: cx('ais-CompareBar-header', classNames.header)
+            }, /*#__PURE__*/ createElement("span", {
+                className: cx('ais-CompareBar-title', classNames.title)
+            }, translations.title), /*#__PURE__*/ createElement("span", {
+                className: cx('ais-CompareBar-count', classNames.count),
+                "aria-live": "polite"
+            }, translations.countText(items.length, maxItems))), /*#__PURE__*/ createElement("ul", {
+                className: cx('ais-CompareBar-list', classNames.list)
+            }, items.map(function(item) {
+                var label = getCompareBarItemLabel(item);
+                return /*#__PURE__*/ createElement("li", {
+                    key: item.objectID,
+                    "data-object-id": item.objectID,
+                    className: cx('ais-CompareBar-item', classNames.item)
+                }, /*#__PURE__*/ createElement("span", {
+                    className: cx('ais-CompareBar-itemLabel', classNames.itemLabel)
+                }, ItemComponent ? /*#__PURE__*/ createElement(ItemComponent, {
+                    item: item
+                }) : label), /*#__PURE__*/ createElement("button", {
+                    type: "button",
+                    className: cx('ais-CompareBar-itemRemove', classNames.itemRemove),
+                    "aria-label": translations.removeItemLabel(label),
+                    onClick: function onClick() {
+                        return onRemove(item);
+                    }
+                }, /*#__PURE__*/ createElement(CloseIcon, {
+                    createElement: createElement
+                })));
+            })), hint && /*#__PURE__*/ createElement("div", {
+                className: cx('ais-CompareBar-hint', classNames.hint)
+            }, hint), /*#__PURE__*/ createElement("div", {
+                className: cx('ais-CompareBar-actions', classNames.actions)
+            }, /*#__PURE__*/ createElement(Button, {
+                variant: "outline",
+                size: "sm",
+                className: cx('ais-CompareBar-clearButton', classNames.clearButton),
+                onClick: onClear
+            }, translations.clearButtonText), /*#__PURE__*/ createElement(Button, {
+                variant: "primary",
+                size: "md",
+                className: cx('ais-CompareBar-compareButton', classNames.compareButton),
+                disabled: !canCompare,
+                onClick: onCompare
+            }, translations.compareButtonText(items.length))));
+        };
+    }
+
     function createDefaultEmptyComponent(param) {
         var createElement = param.createElement, Fragment = param.Fragment;
         return function DefaultEmpty() {
@@ -19581,8 +19817,13 @@
     var MemorizeToolType = 'algolia_memorize';
     var MemorySearchToolType = 'algolia_memory_search';
     var PonderToolType = 'algolia_ponder';
-    var DisplayResultsToolType = 'algolia_display_results';
+    var CompareProductsToolType = 'algolia_compare_products';
     var GroupedResultsToolType = 'algolia_grouped_results';
+    /**
+     * @deprecated The tool is now `algolia_grouped_results`
+     * ({@link GroupedResultsToolType}). This name is still emitted by agents
+     * configured before the rename, and renders the same UI.
+     */ var DisplayResultsToolType = 'algolia_display_results';
     /**
      * Whether `toolName` is the search tool as the Algolia MCP Server exposes it:
      * one tool per index, named after the index it searches
@@ -19787,7 +20028,7 @@
         return DefaultChatTransport;
     }(HttpChatTransport);
 
-    var withUsage$q = createDocumentationMessageGenerator({
+    var withUsage$r = createDocumentationMessageGenerator({
         name: 'chat',
         connector: true
     });
@@ -19918,7 +20159,7 @@
     }
     var connectChat = function connectChat(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$q());
+        checkRendering(renderFn, withUsage$r());
         return function(widgetParams) {
             var _ref = widgetParams || {}, _ref_resume = _ref.resume, resume = _ref_resume === void 0 ? false : _ref_resume, tmp = _ref.tools, tools_ = tmp === void 0 ? {} : tmp, _ref_type = _ref.type, type = _ref_type === void 0 ? 'chat' : _ref_type, persistence = _ref.persistence, context = _ref.context, initialUserMessage = _ref.initialUserMessage, initialMessages = _ref.initialMessages, _ref_disableTriggerValidation = _ref.disableTriggerValidation, disableTriggerValidation = _ref_disableTriggerValidation === void 0 ? false : _ref_disableTriggerValidation, _ref_sendAutomaticallyWhen = _ref.sendAutomaticallyWhen, sendAutomaticallyWhen = _ref_sendAutomaticallyWhen === void 0 ? lastAssistantMessageIsCompleteWithToolCalls : _ref_sendAutomaticallyWhen, _ref_requiresSearch = _ref.requiresSearch, requiresSearch = _ref_requiresSearch === void 0 ? true : _ref_requiresSearch, options = _object_without_properties(_ref, [
                 "resume",
@@ -20078,7 +20319,7 @@
                 if ('agentId' in options && options.agentId) {
                     var _options_requestOptions, _options_requestOptions1;
                     if (!appId || !apiKey) {
-                        throw new Error(withUsage$q('Could not extract Algolia credentials from the search client.'));
+                        throw new Error(withUsage$r('Could not extract Algolia credentials from the search client.'));
                     }
                     var createApi = function createApi() {
                         var bypassCache = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : false;
@@ -20117,7 +20358,7 @@
                     });
                 }
                 if (!transport) {
-                    throw new Error(withUsage$q('You need to provide either an `agentId` or a `transport`.'));
+                    throw new Error(withUsage$r('You need to provide either an `agentId` or a `transport`.'));
                 }
                 var canRepairRestoredPendingToolParts = !resume;
                 var chat = new Chat$1(_object_spread_props(_object_spread({}, options), {
@@ -20307,7 +20548,7 @@
                     if (agentId && feedback) {
                         var _getAppIdAndApiKey = _sliced_to_array(getAppIdAndApiKey(initOptions.instantSearchInstance.client), 2), appId = _getAppIdAndApiKey[0], apiKey = _getAppIdAndApiKey[1];
                         if (!appId || !apiKey) {
-                            throw new Error(withUsage$q('Could not extract Algolia credentials from the search client.'));
+                            throw new Error(withUsage$r('Could not extract Algolia credentials from the search client.'));
                         }
                         feedbackAbortController = new AbortController();
                         _sendChatMessageFeedback = function _sendChatMessageFeedback(messageId, vote) {
@@ -20908,20 +21149,20 @@
         };
     }
 
-    var withUsage$p = createDocumentationMessageGenerator({
+    var withUsage$q = createDocumentationMessageGenerator({
         name: 'tasks',
         connector: true
     });
     var connectTasks = function connectTasks(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$p());
+        checkRendering(renderFn, withUsage$q());
         return function(widgetParams) {
             var agentId = widgetParams.agentId, transport = widgetParams.transport, task = widgetParams.task, kind = widgetParams.kind, _widgetParams_stream = widgetParams.stream, stream = _widgetParams_stream === void 0 ? true : _widgetParams_stream;
             if (!agentId && !transport) {
-                throw new Error(withUsage$p('The `agentId` option is required unless a custom `transport` is provided.'));
+                throw new Error(withUsage$q('The `agentId` option is required unless a custom `transport` is provided.'));
             }
             if (!task && !kind) {
-                throw new Error(withUsage$p('Either the `task` or `kind` option is required.'));
+                throw new Error(withUsage$q('Either the `task` or `kind` option is required.'));
             }
             var runner;
             var output;
@@ -20995,7 +21236,7 @@
                     if (agentId) {
                         var _getAppIdAndApiKey = _sliced_to_array(getAppIdAndApiKey(instantSearchInstance.client), 2), appId = _getAppIdAndApiKey[0], apiKey = _getAppIdAndApiKey[1];
                         if (!appId || !apiKey) {
-                            throw new Error(withUsage$p('Could not extract Algolia credentials from the search client.'));
+                            throw new Error(withUsage$q('Could not extract Algolia credentials from the search client.'));
                         }
                         var taskTransport = createTaskTransport({
                             transport: transport,
@@ -21042,7 +21283,7 @@
         };
     };
 
-    var withUsage$o = createDocumentationMessageGenerator({
+    var withUsage$p = createDocumentationMessageGenerator({
         name: 'prompt-suggestions',
         connector: true
     });
@@ -21139,13 +21380,13 @@
     }
     var connectPromptSuggestions = function connectPromptSuggestions(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$o());
+        checkRendering(renderFn, withUsage$p());
         return function(widgetParams) {
             var agentId = widgetParams.agentId, configurationId = widgetParams.configurationId, _widgetParams_transformHits = widgetParams.transformHits, transformHits = _widgetParams_transformHits === void 0 ? DEFAULT_TRANSFORM_HITS : _widgetParams_transformHits, context = widgetParams.context, _widgetParams_transformItems = widgetParams.transformItems, transformItems = _widgetParams_transformItems === void 0 ? function(items) {
                 return items;
             } : _widgetParams_transformItems, transport = widgetParams.transport;
             if (!agentId && !transport) {
-                throw new Error(withUsage$o('The `agentId` option is required unless a custom `transport` is provided.'));
+                throw new Error(withUsage$p('The `agentId` option is required unless a custom `transport` is provided.'));
             }
             var tasksState;
             var suggestions = [];
@@ -21425,7 +21666,7 @@
                     stream: true
                 };
             } else {
-                throw new Error(withUsage$o('The `agentId` option is required unless a custom `transport` is provided.'));
+                throw new Error(withUsage$p('The `agentId` option is required unless a custom `transport` is provided.'));
             }
             var tasksWidget = connectTasks(handleInnerRender, noop)(tasksParams);
             return {
@@ -21509,14 +21750,14 @@
         return useConnector(connectPromptSuggestions, props, additionalWidgetProperties);
     }
 
-    var withUsage$n = createDocumentationMessageGenerator({
+    var withUsage$o = createDocumentationMessageGenerator({
         name: 'chatTrigger',
         connector: true
     });
     // Reads the sibling chat widget's render state from the live cross-index
     // `instantSearchInstance.renderState` map. We resolve at call time so that
     // `toggleOpen` always sees the latest `open`/`setOpen` values.
-    function getChatRenderState(options) {
+    function getChatRenderState$1(options) {
         var _options_parent, _options_instantSearchInstance_renderState_indexId;
         var indexId = (_options_parent = options.parent) === null || _options_parent === void 0 ? void 0 : _options_parent.getIndexId();
         if (!indexId) return undefined;
@@ -21524,17 +21765,17 @@
     }
     var connectChatTrigger = function connectChatTrigger(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$n());
+        checkRendering(renderFn, withUsage$o());
         return function(widgetParams) {
             var params = widgetParams !== null && widgetParams !== void 0 ? widgetParams : {};
             var lastOptions = null;
             function openChatFromTrigger(options) {
                 if (!lastOptions) return false;
-                return openChat(getChatRenderState(lastOptions), options);
+                return openChat(getChatRenderState$1(lastOptions), options);
             }
             function toggleOpen() {
                 if (!lastOptions) return;
-                var chatState = getChatRenderState(lastOptions);
+                var chatState = getChatRenderState$1(lastOptions);
                 if (!chatState) return;
                 if (chatState.open) {
                     var _chatState_setOpen;
@@ -21564,7 +21805,7 @@
                 },
                 getWidgetRenderState: function getWidgetRenderState(renderOptions) {
                     var _ref;
-                    var chatState = getChatRenderState(renderOptions);
+                    var chatState = getChatRenderState$1(renderOptions);
                     return {
                         open: (_ref = chatState === null || chatState === void 0 ? void 0 : chatState.open) !== null && _ref !== void 0 ? _ref : false,
                         toggleOpen: toggleOpen,
@@ -21590,6 +21831,235 @@
         return useConnector(connectChatTrigger, props, additionalWidgetProperties);
     }
 
+    var withUsage$n = createDocumentationMessageGenerator({
+        name: 'compare',
+        connector: true
+    });
+    /**
+     * Builds the placeholder message for a dashboard-configured comparison. The
+     * Agent Studio backend resolves it against the agent's comparison
+     * configuration: the LLM gets the configured instructions and the transcript
+     * keeps a natural-language message naming the selection.
+     */ function getComparisonPlaceholderMessage(configurationId) {
+        return "__ALGOLIA_COMPARISON_".concat(configurationId, "__");
+    }
+    /**
+     * Builds the default comparison message. It names each selected item so the
+     * agent can ground the comparison: it re-retrieves the records with
+     * `algolia_search_index` and renders them with the builtin
+     * `algolia_compare_products` tool. Works with the default shopping assistant
+     * prompt — no agent configuration required.
+     */ function getDefaultComparisonMessage(items) {
+        var labels = items.map(function(item) {
+            var _item_name;
+            var name = (_item_name = item.name) !== null && _item_name !== void 0 ? _item_name : item.title;
+            return typeof name === 'string' && name !== '' ? '"'.concat(name, '" (objectID: ').concat(item.objectID, ")") : 'the product with objectID "'.concat(item.objectID, '"');
+        });
+        return "Compare these products: ".concat(labels.join(' vs '));
+    }
+    // Turn-context payload for the comparison hand-off, per the Agent Studio
+    // contract: the selection rides `selected_products` (JSON-encoded records,
+    // `_`-prefixed internal metadata stripped) so the agent grounds the comparison
+    // in what the shopper actually selected, and `comparison_configuration_id`
+    // identifies the dashboard configuration when one is set.
+    function buildComparisonTurnContext(items, configurationId) {
+        var records = items.map(function(item) {
+            var clean = {};
+            Object.keys(item).forEach(function(key) {
+                if (!key.startsWith('_')) {
+                    clean[key] = item[key];
+                }
+            });
+            return clean;
+        });
+        return _object_spread({
+            selected_products: JSON.stringify(records)
+        }, configurationId ? {
+            comparison_configuration_id: configurationId
+        } : {});
+    }
+    // The selection is shared by every `compare` widget of the same InstantSearch
+    // instance (per-hit toggles, the compare bar, a picker modal, ...), so it
+    // lives in a store keyed by the instance rather than in any single widget.
+    var compareStores = new WeakMap();
+    function getCompareStore(instantSearchInstance) {
+        var store = compareStores.get(instantSearchInstance);
+        if (!store) {
+            store = {
+                items: [],
+                listeners: new Set()
+            };
+            compareStores.set(instantSearchInstance, store);
+        }
+        return store;
+    }
+    // Reads the sibling chat widget's render state from the live cross-index
+    // `instantSearchInstance.renderState` map. Resolved at call time so that
+    // `compare` always sees the latest `open`/`sendMessage` values.
+    function getChatRenderState(options) {
+        var _options_parent, _options_instantSearchInstance_renderState_indexId;
+        var indexId = (_options_parent = options.parent) === null || _options_parent === void 0 ? void 0 : _options_parent.getIndexId();
+        if (!indexId) return undefined;
+        return (_options_instantSearchInstance_renderState_indexId = options.instantSearchInstance.renderState[indexId]) === null || _options_instantSearchInstance_renderState_indexId === void 0 ? void 0 : _options_instantSearchInstance_renderState_indexId.chat;
+    }
+    /**
+     * Compare connector.
+     *
+     * Owns the "products selected for comparison" state and the hand-off into the
+     * chat: `compare()` opens the sibling `chat` widget and sends a comparison
+     * message naming the selected records, which the agent answers with the
+     * grounded `algolia_compare_products` table.
+     *
+     * The selection is shared across all `compare` widgets mounted on the same
+     * InstantSearch instance, so per-hit "Compare" toggles and the `compareBar`
+     * widget stay in sync. The widget is marked with `opensChat`, so it satisfies
+     * the `chat` widget's entry-point validation.
+     */ var connectCompare = function connectCompare(renderFn) {
+        var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
+        checkRendering(renderFn, withUsage$n());
+        return function(widgetParams) {
+            var _ref = widgetParams || {}, _ref_minItems = _ref.minItems, minItems = _ref_minItems === void 0 ? 2 : _ref_minItems, _ref_maxItems = _ref.maxItems, maxItems = _ref_maxItems === void 0 ? 3 : _ref_maxItems, configurationId = _ref.configurationId, _ref_getComparisonMessage = _ref.getComparisonMessage, getComparisonMessage = _ref_getComparisonMessage === void 0 ? configurationId ? function() {
+                return getComparisonPlaceholderMessage(configurationId);
+            } : getDefaultComparisonMessage : _ref_getComparisonMessage;
+            if (minItems < 2) {
+                throw new Error(withUsage$n('The `minItems` option must be at least 2.'));
+            }
+            if (maxItems < minItems) {
+                throw new Error(withUsage$n('The `maxItems` option must be greater than `minItems`.'));
+            }
+            var lastOptions = null;
+            var unsubscribe = null;
+            function getStore() {
+                if (!lastOptions) return null;
+                return getCompareStore(lastOptions.instantSearchInstance);
+            }
+            // Re-renders every subscribed `compare` widget, then schedules a full
+            // render so anything else reading `renderState.compare` catches up.
+            function notify(store) {
+                store.listeners.forEach(function(listener) {
+                    return listener();
+                });
+                lastOptions === null || lastOptions === void 0 ? void 0 : lastOptions.instantSearchInstance.scheduleRender();
+            }
+            function isSelected(objectID) {
+                var store = getStore();
+                return Boolean(store === null || store === void 0 ? void 0 : store.items.some(function(item) {
+                    return item.objectID === objectID;
+                }));
+            }
+            function addItem(item) {
+                var store = getStore();
+                if (!store || store.items.length >= maxItems || isSelected(item.objectID)) {
+                    return;
+                }
+                store.items = _to_consumable_array(store.items).concat([
+                    item
+                ]);
+                notify(store);
+            }
+            function removeItem(objectID) {
+                var store = getStore();
+                if (!store || !isSelected(objectID)) return;
+                store.items = store.items.filter(function(item) {
+                    return item.objectID !== objectID;
+                });
+                notify(store);
+            }
+            function toggleItem(item) {
+                if (isSelected(item.objectID)) {
+                    removeItem(item.objectID);
+                } else {
+                    addItem(item);
+                }
+            }
+            function clearItems() {
+                var store = getStore();
+                if (!store || store.items.length === 0) return;
+                store.items = [];
+                notify(store);
+            }
+            function compare() {
+                var store = getStore();
+                if (!store || !lastOptions || store.items.length < minItems) {
+                    return false;
+                }
+                return openChat(getChatRenderState(lastOptions), {
+                    message: getComparisonMessage(store.items),
+                    referer: 'compare',
+                    turnContext: buildComparisonTurnContext(store.items, configurationId)
+                });
+            }
+            return {
+                $$type: 'ais.compare',
+                opensChat: true,
+                init: function init(initOptions) {
+                    var _this = this;
+                    lastOptions = initOptions;
+                    var store = getCompareStore(initOptions.instantSearchInstance);
+                    var listener = function listener() {
+                        if (!lastOptions) return;
+                        renderFn(_object_spread_props(_object_spread({}, _this.getWidgetRenderState(lastOptions)), {
+                            instantSearchInstance: lastOptions.instantSearchInstance
+                        }), false);
+                    };
+                    store.listeners.add(listener);
+                    unsubscribe = function unsubscribe() {
+                        return store.listeners.delete(listener);
+                    };
+                    renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(initOptions)), {
+                        instantSearchInstance: initOptions.instantSearchInstance
+                    }), true);
+                },
+                render: function render(renderOptions) {
+                    lastOptions = renderOptions;
+                    renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(renderOptions)), {
+                        instantSearchInstance: renderOptions.instantSearchInstance
+                    }), false);
+                },
+                dispose: function dispose() {
+                    unsubscribe === null || unsubscribe === void 0 ? void 0 : unsubscribe();
+                    unsubscribe = null;
+                    unmountFn();
+                },
+                getWidgetRenderState: function getWidgetRenderState(renderOptions) {
+                    lastOptions = renderOptions;
+                    var store = getCompareStore(renderOptions.instantSearchInstance);
+                    return {
+                        items: store.items,
+                        isSelected: isSelected,
+                        addItem: addItem,
+                        removeItem: removeItem,
+                        toggleItem: toggleItem,
+                        clearItems: clearItems,
+                        canAddItems: store.items.length < maxItems,
+                        canCompare: store.items.length >= minItems,
+                        minItems: minItems,
+                        maxItems: maxItems,
+                        compare: compare,
+                        widgetParams: widgetParams || {}
+                    };
+                },
+                getRenderState: function getRenderState(renderState, renderOptions) {
+                    return _object_spread_props(_object_spread({}, renderState), {
+                        compare: this.getWidgetRenderState(renderOptions)
+                    });
+                }
+            };
+        };
+    };
+
+    /**
+     * Exposes the shared comparison selection and the chat hand-off.
+     *
+     * The selection is shared by every `useCompare` call on the same InstantSearch
+     * instance, so a per-hit "Compare" toggle (`toggleItem`) and the `<CompareBar>`
+     * widget stay in sync. `compare()` opens the `<Chat>` widget and sends the
+     * comparison message for the current selection.
+     */ function useCompare() {
+        var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {}, additionalWidgetProperties = arguments.length > 1 ? arguments[1] : void 0;
+        return useConnector(connectCompare, props, additionalWidgetProperties);
+    }
+
     var withUsage$m = createDocumentationMessageGenerator({
         name: 'clear-refinements',
         connector: true
@@ -26960,6 +27430,43 @@
         useState: React.useState
     });
 
+    /**
+     * Builtin comparison tool (`algolia_compare_products`).
+     *
+     * Registered by default in the chat widget so the agent can trigger a grounded
+     * side-by-side comparison: its tool call names only the product objectIDs and
+     * the attribute keys, and every cell is hydrated client-side from the real
+     * `algolia_search_index` hits. The model never types a value, so it cannot
+     * hallucinate one. See `instantsearch-ui-components` `CompareProductsTool` for
+     * the contract, and `comparison-eval/README.md` for the study behind it.
+     */ function createCompareProductsTool(translations) {
+        var CompareProductsUIComponent = createCompareProductsToolComponent({
+            createElement: React.createElement,
+            Fragment: React.Fragment
+        });
+        var CompareProductsLayoutComponent = function CompareProductsLayoutComponent(toolProps) {
+            return /*#__PURE__*/ React.createElement(CompareProductsUIComponent, {
+                toolProps: toolProps,
+                translations: translations
+            });
+        };
+        return {
+            layoutComponent: CompareProductsLayoutComponent,
+            // Client-side tool: acknowledge the call so the agent's turn can complete.
+            // The table itself is rendered from the call's input + real search hits.
+            onToolCall: function onToolCall(param) {
+                var input = param.input, addToolResult = param.addToolResult;
+                var objectIDs = input === null || input === void 0 ? void 0 : input.objectIDs;
+                addToolResult({
+                    output: {
+                        status: 'displayed',
+                        objectIDs: Array.isArray(objectIDs) ? objectIDs : []
+                    }
+                });
+            }
+        };
+    }
+
     var CarouselUiComponent = createCarouselComponent({
         createElement: React.createElement,
         Fragment: React.Fragment,
@@ -27009,7 +27516,7 @@
     });
 
     function createGroupedResultsTool(itemComponent) {
-        var DisplayResultsUIComponent = createDisplayResultsToolComponent({
+        var GroupedResultsUIComponent = createGroupedResultsToolComponent({
             createElement: React.createElement,
             Fragment: React.Fragment,
             useEffect: React.useEffect,
@@ -27018,14 +27525,14 @@
         var Button = createButtonComponent({
             createElement: React.createElement
         });
-        var DisplayResultsCarouselHeader = function DisplayResultsCarouselHeader(param) {
+        var GroupedResultsCarouselHeader = function GroupedResultsCarouselHeader(param) {
             var nbItems = param.nbItems, canScrollLeft = param.canScrollLeft, canScrollRight = param.canScrollRight, scrollLeft = param.scrollLeft, scrollRight = param.scrollRight;
             return /*#__PURE__*/ React.createElement("div", {
-                className: "ais-ChatToolDisplayResultsCarouselHeader"
+                className: "ais-ChatToolGroupedResultsCarouselHeader"
             }, /*#__PURE__*/ React.createElement("div", {
-                className: "ais-ChatToolDisplayResultsCarouselHeaderCount"
+                className: "ais-ChatToolGroupedResultsCarouselHeaderCount"
             }, nbItems, " result", nbItems > 1 ? 's' : ''), /*#__PURE__*/ React.createElement("div", {
-                className: "ais-ChatToolDisplayResultsCarouselHeaderScrollButtons"
+                className: "ais-ChatToolGroupedResultsCarouselHeaderScrollButtons"
             }, /*#__PURE__*/ React.createElement(Button, {
                 variant: "outline",
                 size: "sm",
@@ -27033,7 +27540,7 @@
                 "aria-label": "Previous",
                 onClick: scrollLeft,
                 disabled: !canScrollLeft,
-                className: "ais-ChatToolDisplayResultsCarouselHeaderScrollButton"
+                className: "ais-ChatToolGroupedResultsCarouselHeaderScrollButton"
             }, /*#__PURE__*/ React.createElement(ChevronLeftIcon, {
                 createElement: React.createElement
             })), /*#__PURE__*/ React.createElement(Button, {
@@ -27043,13 +27550,13 @@
                 "aria-label": "Next",
                 onClick: scrollRight,
                 disabled: !canScrollRight,
-                className: "ais-ChatToolDisplayResultsCarouselHeaderScrollButton"
+                className: "ais-ChatToolGroupedResultsCarouselHeaderScrollButton"
             }, /*#__PURE__*/ React.createElement(ChevronRightIcon, {
                 createElement: React.createElement
             }))));
         };
-        var DisplayResultsLayoutComponent = function DisplayResultsLayoutComponent(toolProps) {
-            return /*#__PURE__*/ React.createElement(DisplayResultsUIComponent, {
+        var GroupedResultsLayoutComponent = function GroupedResultsLayoutComponent(toolProps) {
+            return /*#__PURE__*/ React.createElement(GroupedResultsUIComponent, {
                 toolProps: toolProps,
                 groupCarouselComponent: function groupCarouselComponent(param) {
                     var items = param.items, sendEvent = param.sendEvent;
@@ -27058,13 +27565,13 @@
                         itemComponent: itemComponent,
                         sendEvent: sendEvent,
                         showNavigation: false,
-                        headerComponent: DisplayResultsCarouselHeader
+                        headerComponent: GroupedResultsCarouselHeader
                     });
                 }
             });
         };
         return {
-            layoutComponent: DisplayResultsLayoutComponent,
+            layoutComponent: GroupedResultsLayoutComponent,
             streamInput: true
         };
     }
@@ -27101,20 +27608,15 @@
         useEffect: React.useEffect
     });
     function createDefaultTools(itemComponent, getSearchPageURL) {
+        var groupedResultsTool = createGroupedResultsTool(itemComponent);
         var _obj;
         return _obj = {}, _define_property(_obj, SearchIndexToolType, _object_spread_props(_object_spread({}, createCarouselTool(true, itemComponent, getSearchPageURL)), {
             // The agent decides per turn whether the richer Grouped Results tool
             // takes over the rendering of the search results.
-            shouldRender: isDisplayResultsDisabled
-        })), _define_property(_obj, RecommendToolType, createCarouselTool(false, itemComponent, getSearchPageURL)), _define_property(_obj, DisplayResultsToolType, createGroupedResultsTool(itemComponent)), _define_property(_obj, GroupedResultsToolType, createGroupedResultsTool(itemComponent)), _define_property(_obj, MemorizeToolType, {}), _define_property(_obj, MemorySearchToolType, {}), _define_property(_obj, PonderToolType, {}), _obj;
-    }
-    /**
-     * Whether the search tool renders its own results, i.e. the agent did not hand
-     * the turn to the Grouped Results tool. Set on the message by the backend.
-     */ function isDisplayResultsDisabled(param) {
-        var parentMessage = param.parentMessage;
-        var _parentMessage_metadata;
-        return ((_parentMessage_metadata = parentMessage.metadata) === null || _parentMessage_metadata === void 0 ? void 0 : _parentMessage_metadata.displayResultsEnabled) !== true;
+            shouldRender: shouldSearchToolRenderResults
+        })), _define_property(_obj, RecommendToolType, createCarouselTool(false, itemComponent, getSearchPageURL)), _define_property(_obj, GroupedResultsToolType, groupedResultsTool), // Agents configured before the rename still emit the legacy tool name.
+        // eslint-disable-next-line typescript/no-deprecated
+        _define_property(_obj, DisplayResultsToolType, groupedResultsTool), _define_property(_obj, CompareProductsToolType, createCompareProductsTool()), _define_property(_obj, MemorizeToolType, {}), _define_property(_obj, MemorySearchToolType, {}), _define_property(_obj, PonderToolType, {}), _obj;
     }
     function mergeToolOptions(defaultTools, userTools) {
         if (!userTools) {
@@ -27511,6 +28013,45 @@
         }, props));
     }
 
+    var CompareBarUiComponent = createCompareBarComponent({
+        createElement: React.createElement,
+        Fragment: React.Fragment
+    });
+    /**
+     * Renders the comparison selection bar: the records picked for comparison,
+     * a clear-selection action, and the "Compare" call-to-action that opens the
+     * `<Chat>` widget with the comparison message.
+     *
+     * Select records from your own UI (e.g. a "Compare" button in your hit
+     * component) with `useCompare().toggleItem(hit)` — the selection is shared
+     * with this widget.
+     */ function CompareBar(_0) {
+        var classNames = _0.classNames, translations = _0.translations, itemComponent = _0.itemComponent, props = _object_without_properties(_0, [
+            "classNames",
+            "translations",
+            "itemComponent"
+        ]);
+        var _useCompare = useCompare(props, {
+            $$widgetType: 'ais.compareBar'
+        }), items = _useCompare.items, minItems = _useCompare.minItems, maxItems = _useCompare.maxItems, canCompare = _useCompare.canCompare, removeItem = _useCompare.removeItem, clearItems = _useCompare.clearItems, compare = _useCompare.compare;
+        return /*#__PURE__*/ React.createElement(CompareBarUiComponent, {
+            items: items,
+            minItems: minItems,
+            maxItems: maxItems,
+            canCompare: canCompare,
+            onCompare: function onCompare() {
+                return compare();
+            },
+            onRemove: function onRemove(item) {
+                return removeItem(item.objectID);
+            },
+            onClear: clearItems,
+            itemComponent: itemComponent,
+            classNames: classNames,
+            translations: translations
+        });
+    }
+
     function ClearRefinements$1(_0) {
         var _0_classNames = _0.classNames, classNames = _0_classNames === void 0 ? {} : _0_classNames, _0_disabled = _0.disabled, disabled = _0_disabled === void 0 ? false : _0_disabled, _0_onClick = _0.onClick, onClick = _0_onClick === void 0 ? function() {} : _0_onClick, translations = _0.translations, props = _object_without_properties(_0, [
             "classNames",
@@ -29343,6 +29884,8 @@
     exports.ChatSidePanelLayout = ChatSidePanelLayout;
     exports.ChatTrigger = ChatTrigger;
     exports.ClearRefinements = ClearRefinements;
+    exports.CompareBar = CompareBar;
+    exports.CompareProductsToolType = CompareProductsToolType;
     exports.Configure = Configure;
     exports.CurrentRefinements = CurrentRefinements;
     exports.DisplayResultsToolType = DisplayResultsToolType;
@@ -29391,6 +29934,7 @@
     exports.useChat = useChat;
     exports.useChatTrigger = useChatTrigger;
     exports.useClearRefinements = useClearRefinements;
+    exports.useCompare = useCompare;
     exports.useConfigure = useConfigure;
     exports.useConnector = useConnector;
     exports.useCurrentRefinements = useCurrentRefinements;