react-instantsearch-core 7.50.1 → 7.51.0

package/dist/umd/ReactInstantSearchCore.js

@@ -1,4 +1,4 @@
-/*! React InstantSearch Core 7.50.1 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
+/*! React InstantSearch Core 7.51.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.50.1';
+    var version$2 = '7.51.0';
 
     function _define_property(obj, key, value) {
         if (key in obj) {
@@ -3919,7 +3919,7 @@
     function requireVersion() {
         if (hasRequiredVersion) return version$1;
         hasRequiredVersion = 1;
-        version$1 = '3.29.4';
+        version$1 = '3.30.0';
         return version$1;
     }
 
@@ -6010,7 +6010,7 @@
         }
     }
 
-    var withUsage$y = createDocumentationMessageGenerator({
+    var withUsage$z = createDocumentationMessageGenerator({
         name: 'configure',
         connector: true
     });
@@ -6026,7 +6026,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$y('The `searchParameters` option expects an object.'));
+                throw new Error(withUsage$z('The `searchParameters` option expects an object.'));
             }
             var connectorState = {};
             function refine(helper) {
@@ -7373,7 +7373,11 @@
             parent: parent,
             instantSearchInstance: instantSearchInstance,
             state: helper.state,
-            renderState: instantSearchInstance.renderState,
+            // Keep renderState live so render options retained by connector closures
+            // don't retain previous renderState snapshots. See #6669.
+            get renderState () {
+                return instantSearchInstance.renderState;
+            },
             templatesConfig: instantSearchInstance.templatesConfig,
             createURL: parent.createURL,
             scopedResults: [],
@@ -7394,7 +7398,10 @@
             results: results,
             scopedResults: parent.getScopedResults(),
             state: results && '_state' in results ? results._state : helper.state,
-            renderState: instantSearchInstance.renderState,
+            // Keep renderState live to avoid retaining previous renderState snapshots.
+            get renderState () {
+                return instantSearchInstance.renderState;
+            },
             templatesConfig: instantSearchInstance.templatesConfig,
             createURL: parent.createURL,
             searchMetadata: {
@@ -7863,13 +7870,13 @@
         return null;
     }
 
-    var withUsage$x = createDocumentationMessageGenerator({
+    var withUsage$y = 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$x());
+        checkRendering(renderFn, withUsage$y());
         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 ? [
                 '*'
@@ -7879,10 +7886,10 @@
             if (!(widgets && Array.isArray(widgets) && widgets.every(function(widget) {
                 return (typeof widget === "undefined" ? "undefined" : _type_of(widget)) === 'object';
             }))) {
-                throw new Error(withUsage$x('The `widgets` option expects an array of widgets.'));
+                throw new Error(withUsage$y('The `widgets` option expects an array of widgets.'));
             }
             if (!Array.isArray(facets)) {
-                throw new Error(withUsage$x("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
+                throw new Error(withUsage$y("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
             }
             var localWidgets = new Map();
             return {
@@ -7984,7 +7991,7 @@
                         results: results
                     });
                     if (!Array.isArray(attributesToRender)) {
-                        throw new Error(withUsage$x('The `transformItems` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$y('The `transformItems` option expects a function that returns an Array.'));
                     }
                     return {
                         attributesToRender: attributesToRender,
@@ -8375,19 +8382,19 @@
             return toFeedSearchResults(lastResults._state, raw);
         });
     }
-    var withUsage$w = createDocumentationMessageGenerator({
+    var withUsage$x = 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$w());
+        checkRendering(renderFn, withUsage$x());
         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$w('The `isolated` option currently only supports `false`.'));
+                throw new Error(withUsage$x('The `isolated` option currently only supports `false`.'));
             }
             return {
                 $$type: 'ais.feeds',
@@ -8395,7 +8402,7 @@
                 init: function init(initOptions) {
                     var instantSearchInstance = initOptions.instantSearchInstance;
                     if (!instantSearchInstance.compositionID) {
-                        throw new Error(withUsage$w('The `feeds` widget requires a composition-based InstantSearch instance (compositionID must be set).'));
+                        throw new Error(withUsage$x('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)), {
@@ -8441,12 +8448,12 @@
                     ];
                     feedIDs = transformFeeds(feedIDs);
                     if (!Array.isArray(feedIDs)) {
-                        throw new Error(withUsage$w('The `transformFeeds` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$x('The `transformFeeds` option expects a function that returns an Array.'));
                     }
                     if (!feedIDs.every(function(feedID) {
                         return typeof feedID === 'string';
                     })) {
-                        throw new Error(withUsage$w('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
+                        throw new Error(withUsage$x('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
                     }
                     return {
                         feedIDs: feedIDs,
@@ -8557,7 +8564,7 @@
         }));
     }
 
-    var withUsage$v = createDocumentationMessageGenerator({
+    var withUsage$w = createDocumentationMessageGenerator({
         name: 'index-widget'
     });
     /**
@@ -8685,7 +8692,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$v('The `indexName` option is required.'));
+            throw new Error(withUsage$w('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.
@@ -8783,7 +8790,7 @@
             addWidgets: function addWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$v('The `addWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$w('The `addWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8793,7 +8800,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.init !== 'function' && typeof widget.render !== 'function';
                 })) {
-                    throw new Error(withUsage$v('The widget definition expects a `render` and/or an `init` method.'));
+                    throw new Error(withUsage$w('The widget definition expects a `render` and/or an `init` method.'));
                 }
                 flatWidgets.forEach(function(widget) {
                     widget.parent = _this;
@@ -8843,10 +8850,10 @@
             },
             updateWidget: function updateWidget(previousWidget, nextWidget) {
                 if (typeof previousWidget.dispose !== 'function') {
-                    throw new Error(withUsage$v('The widget definition expects a `dispose` method.'));
+                    throw new Error(withUsage$w('The widget definition expects a `dispose` method.'));
                 }
                 if (typeof nextWidget.init !== 'function' && typeof nextWidget.render !== 'function') {
-                    throw new Error(withUsage$v('The widget definition expects a `render` and/or an `init` method.'));
+                    throw new Error(withUsage$w('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.
@@ -8930,7 +8937,7 @@
             removeWidgets: function removeWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$v('The `removeWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$w('The `removeWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8940,7 +8947,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.dispose !== 'function';
                 })) {
-                    throw new Error(withUsage$v('The widget definition expects a `dispose` method.'));
+                    throw new Error(withUsage$w('The widget definition expects a `dispose` method.'));
                 }
                 localWidgets = localWidgets.filter(function(widget) {
                     return flatWidgets.indexOf(widget) === -1;
@@ -9448,7 +9455,7 @@
         });
     }
 
-    var version = '4.118.1';
+    var version = '4.119.0';
 
     var ANONYMOUS_TOKEN_COOKIE_KEY = '_ALGOLIA';
     function getCookie(name) {
@@ -11310,7 +11317,7 @@
         };
     }
 
-    var withUsage$u = createDocumentationMessageGenerator({
+    var withUsage$v = createDocumentationMessageGenerator({
         name: 'instantsearch'
     });
     function defaultCreateURL() {
@@ -11381,7 +11388,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$u('The `searchClient` option is required.'));
+                throw new Error(withUsage$v('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/");
@@ -11390,7 +11397,7 @@
                 searchClient.addAlgoliaAgent("instantsearch.js (".concat(version, ")"));
             }
             if (insightsClient && typeof insightsClient !== 'function') {
-                throw new Error(withUsage$u('The `insightsClient` option should be a function.'));
+                throw new Error(withUsage$v('The `insightsClient` option should be a function.'));
             }
             _this._initialOptions = options;
             _this.client = searchClient;
@@ -11539,12 +11546,12 @@
        * @param widgets The array of widgets to add to InstantSearch.
        */ function addWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$u('The `addWidgets` method expects an array of widgets. Please use `addWidget`.'));
+                        throw new Error(withUsage$v('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$u('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
+                        throw new Error(withUsage$v('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
                     }
                     this.mainIndex.addWidgets(widgets);
                     return this;
@@ -11573,7 +11580,7 @@
        * The widgets must implement a `dispose()` method to clear their states.
        */ function removeWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$u('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
+                        throw new Error(withUsage$v('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
                     }
                     this.mainIndex.removeWidgets(widgets);
                     return this;
@@ -11587,7 +11594,7 @@
        */ function start() {
                     var _this = this;
                     if (this.started) {
-                        throw new Error(withUsage$u('The `start` method has already been called once.'));
+                        throw new Error(withUsage$v('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
@@ -11795,7 +11802,7 @@
                     var _this = this;
                     var callOnStateChange = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$u('The `start` method needs to be called before `setUiState`.'));
+                        throw new Error(withUsage$v('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`.
@@ -11832,7 +11839,7 @@
                 value: function createURL() {
                     var nextState = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
                     if (!this.started) {
-                        throw new Error(withUsage$u('The `start` method needs to be called before `createURL`.'));
+                        throw new Error(withUsage$v('The `start` method needs to be called before `createURL`.'));
                     }
                     return this._createURL(nextState);
                 }
@@ -11841,7 +11848,7 @@
                 key: "refresh",
                 value: function refresh() {
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$u('The `start` method needs to be called before `refresh`.'));
+                        throw new Error(withUsage$v('The `start` method needs to be called before `refresh`.'));
                     }
                     this.mainHelper.clearCache().search();
                 }
@@ -12373,13 +12380,13 @@
         }, children);
     }
 
-    var withUsage$t = createDocumentationMessageGenerator({
+    var withUsage$u = 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$t());
+        checkRendering(renderFn, withUsage$u());
         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;
@@ -12492,20 +12499,20 @@
         return useConnector(connectAutocomplete, props, additionalWidgetProperties);
     }
 
-    var withUsage$s = createDocumentationMessageGenerator({
+    var withUsage$t = 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$s());
+        checkRendering(renderFn, withUsage$t());
         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$s('The `attributes` option expects an array of strings.'));
+                throw new Error(withUsage$t('The `attributes` option expects an array of strings.'));
             }
             var _attributes = _sliced_to_array(attributes, 1), hierarchicalFacetName = _attributes[0];
             function getRefinedState(state, facetValue) {
@@ -12720,16 +12727,49 @@
             }
         };
     }
+    /**
+     * Turn-context key under which the compare connector attaches the shopper's
+     * selection to its user message (`metadata.turnContext.selected_products`), as
+     * a JSON-encoded array of records — the Agent Studio comparison contract.
+     */ var SELECTED_PRODUCTS_KEY = 'selected_products';
+    /**
+     * The records a user message carries as a comparison selection, or `[]` when
+     * it carries none. The payload is client-authored, so anything unexpected
+     * (not JSON, not an array) is treated as "no records" rather than thrown.
+     */ function selectedRecords(message) {
+        var _message_metadata;
+        if (message.role !== 'user') {
+            return [];
+        }
+        var turnContext = (_message_metadata = message.metadata) === null || _message_metadata === void 0 ? void 0 : _message_metadata.turnContext;
+        var raw = turnContext === null || turnContext === void 0 ? void 0 : turnContext[SELECTED_PRODUCTS_KEY];
+        if (typeof raw !== 'string') {
+            return [];
+        }
+        try {
+            var parsed = JSON.parse(raw);
+            return Array.isArray(parsed) ? parsed : [];
+        } catch (unused) {
+            return [];
+        }
+    }
     /**
      * Collects into `store` the records of every completed tool call in `messages`
-     * whose output holds `hits`. Matching on the output rather than on a tool name
-     * means any tool that fetches records contributes them by returning them.
+     * whose output holds `hits`, plus the records a user message carries as a
+     * comparison selection. Matching on the output rather than on a tool name
+     * means any tool that fetches records contributes them by returning them; the
+     * selection counts because the compare flow already hands the agent the very
+     * records it is asked to compare, so the table can be built from them without
+     * a search round-trip.
      *
      * Idempotent, so it can re-run over the whole conversation on every update:
      * streaming deltas and a conversation restored from storage are one code path.
+     * Later messages win per `objectID`, so a record the agent re-fetched after the
+     * selection replaces the selected copy.
      */ function collectChatRecords(messages) {
         var store = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : createChatRecordsStore();
         messages === null || messages === void 0 ? void 0 : messages.forEach(function(message) {
+            store.merge(selectedRecords(message));
             message.parts.forEach(function(part) {
                 var _part_output;
                 if (!isPartTool(part) || part.state !== 'output-available') {
@@ -13456,6 +13496,15 @@
                     this.conversationId = this.generateId();
                 }
             },
+            {
+                /**
+       * Continues a conversation started elsewhere (e.g. by a Result Card) under
+       * its server-side id, so the next request carries that thread's context.
+       */ key: "setConversationId",
+                value: function setConversationId(id) {
+                    this.conversationId = id;
+                }
+            },
             {
                 key: "messages",
                 get: function get() {
@@ -14742,7 +14791,154 @@
         return (chatRenderState === null || chatRenderState === void 0 ? void 0 : chatRenderState.status) === 'submitted' || (chatRenderState === null || chatRenderState === void 0 ? void 0 : chatRenderState.status) === 'streaming';
     }
 
+    function flat(arr) {
+        return arr.reduce(function(acc, array) {
+            return acc.concat(array);
+        }, []);
+    }
+
+    /*
+     * The two directions are not inverses: `getAgentFilters` folds numeric
+     * refinements into the facet groups and writes excludes as `attr:-value`,
+     * whereas `applyAgentFilters` reads numeric refinements from `numericFilters`
+     * only and refines on `-value` literally.
+     */ /**
+     * The active refinements as `facetFilters`-style groups: one group per
+     * conjunctive/numeric refinement, disjunctive values of the same attribute
+     * grouped together.
+     */ function getAgentFilters(results) {
+        var state = results._state;
+        if (!state) {
+            return undefined;
+        }
+        var groups = [];
+        var disjunctiveGroups = {};
+        getRefinements(results, state).forEach(function(refinement) {
+            if (refinement.type === 'numeric') {
+                groups.push([
+                    "".concat(refinement.attribute).concat(refinement.operator).concat(refinement.numericValue)
+                ]);
+                return;
+            }
+            var value = refinement.type === 'exclude' ? "".concat(refinement.attribute, ":-").concat(refinement.name) : "".concat(refinement.attribute, ":").concat(refinement.name);
+            if (refinement.type === 'disjunctive') {
+                var group = disjunctiveGroups[refinement.attribute];
+                if (group) {
+                    group.push(value);
+                } else {
+                    var newGroup = [
+                        value
+                    ];
+                    disjunctiveGroups[refinement.attribute] = newGroup;
+                    groups.push(newGroup);
+                }
+                return;
+            }
+            groups.push([
+                value
+            ]);
+        });
+        return groups.length > 0 ? groups : undefined;
+    }
+    function getAttributesToClear$1(param) {
+        var results = param.results, helper = param.helper;
+        return uniq(getRefinements(results, helper.state, true).map(function(refinement) {
+            return refinement.attribute;
+        }));
+    }
+    /**
+     * One Algolia `numericFilters` entry: `'price <= 1500'`. The operators are
+     * exactly the set `helper.addNumericRefinement` accepts, and exactly the set
+     * the Algolia MCP Server emits.
+     */ var NUMERIC_FILTER = /^(.+?)\s*(<=|>=|!=|=|<|>)\s*(-?\d+(?:\.\d+)?)$/;
+    /**
+     * Replaces the helper's refinements and query with the ones a search tool call
+     * searched with, then searches.
+     */ function applyAgentFilters(params, helper) {
+        // clear all filters first
+        var attributesToClear = getAttributesToClear$1({
+            results: helper.lastResults,
+            helper: helper
+        });
+        helper.setState(clearRefinements({
+            helper: helper,
+            attributesToClear: attributesToClear
+        }));
+        if (params.facetFilters) {
+            var refinements = flat(params.facetFilters).reduce(function(acc, filter) {
+                var separatorIndex = filter.indexOf(':');
+                if (separatorIndex > 0) {
+                    acc.push({
+                        attribute: filter.slice(0, separatorIndex),
+                        value: filter.slice(separatorIndex + 1)
+                    });
+                }
+                return acc;
+            }, []);
+            var hierarchicalRefinements = new Map();
+            refinements.forEach(function(param) {
+                var attribute = param.attribute, value = param.value;
+                var hierarchicalFacet = helper.state.hierarchicalFacets.find(function(facet) {
+                    return facet.name === attribute || facet.attributes.includes(attribute);
+                });
+                if (hierarchicalFacet) {
+                    var currentValue = hierarchicalRefinements.get(hierarchicalFacet.name);
+                    if (currentValue === undefined || value.length > currentValue.length) {
+                        hierarchicalRefinements.set(hierarchicalFacet.name, value);
+                    }
+                    return;
+                }
+                if (!helper.state.isConjunctiveFacet(attribute) && !helper.state.isDisjunctiveFacet(attribute)) {
+                    helper.setState(helper.state.addDisjunctiveFacet(attribute));
+                }
+                helper.toggleFacetRefinement(attribute, value);
+            });
+            hierarchicalRefinements.forEach(function(value, name) {
+                helper.toggleFacetRefinement(name, value);
+            });
+        }
+        if (params.numericFilters) {
+            params.numericFilters.forEach(function(filter) {
+                var match = filter.match(NUMERIC_FILTER);
+                if (!match) {
+                    return;
+                }
+                var _match = _sliced_to_array(match, 4), attribute = _match[1], operator = _match[2], value = _match[3];
+                helper.addNumericRefinement(attribute, operator, Number(value));
+            });
+        }
+        if (params.query) {
+            helper.setQuery(params.query);
+        }
+        helper.search();
+        return helper.state;
+    }
+
+    /**
+     * Strips InstantSearch metadata, which is `_`-prefixed (`_highlightResult`,
+     * `_rankingInfo`, `__position`, …), so only record attributes reach the agent.
+     */ function stripInternalHitMetadata(hit) {
+        var clean = {};
+        Object.keys(hit).forEach(function(key) {
+            if (!key.startsWith('_')) {
+                clean[key] = hit[key];
+            }
+        });
+        return clean;
+    }
+
     var SearchIndexToolType = 'algolia_search_index';
+    var RecommendToolType = 'algolia_recommend';
+    var MemorizeToolType = 'algolia_memorize';
+    var MemorySearchToolType = 'algolia_memory_search';
+    var PonderToolType = 'algolia_ponder';
+    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
@@ -14751,12 +14947,6 @@
         return toolName.startsWith("".concat(SearchIndexToolType, "_"));
     };
 
-    function flat(arr) {
-        return arr.reduce(function(acc, array) {
-            return acc.concat(array);
-        }, []);
-    }
-
     /**
      * Reads a human-readable message from a failed HTTP response body when the
      * server returns JSON such as `{ "message": "..." }` (the shared
@@ -14947,7 +15137,7 @@
         return DefaultChatTransport;
     }(HttpChatTransport);
 
-    var withUsage$r = createDocumentationMessageGenerator({
+    var withUsage$s = createDocumentationMessageGenerator({
         name: 'chat',
         connector: true
     });
@@ -15006,79 +15196,9 @@
         // Storage availability must not block the visible state change.
         }
     }
-    function getAttributesToClear$1(param) {
-        var results = param.results, helper = param.helper;
-        return uniq(getRefinements(results, helper.state, true).map(function(refinement) {
-            return refinement.attribute;
-        }));
-    }
-    /**
-     * One Algolia `numericFilters` entry: `'price <= 1500'`. The operators are
-     * exactly the set `helper.addNumericRefinement` accepts, and exactly the set
-     * the Algolia MCP Server emits.
-     */ var NUMERIC_FILTER = /^(.+?)\s*(<=|>=|!=|=|<|>)\s*(-?\d+(?:\.\d+)?)$/;
-    function updateStateFromSearchToolInput(params, helper) {
-        // clear all filters first
-        var attributesToClear = getAttributesToClear$1({
-            results: helper.lastResults,
-            helper: helper
-        });
-        helper.setState(clearRefinements({
-            helper: helper,
-            attributesToClear: attributesToClear
-        }));
-        if (params.facetFilters) {
-            var refinements = flat(params.facetFilters).reduce(function(acc, filter) {
-                var separatorIndex = filter.indexOf(':');
-                if (separatorIndex > 0) {
-                    acc.push({
-                        attribute: filter.slice(0, separatorIndex),
-                        value: filter.slice(separatorIndex + 1)
-                    });
-                }
-                return acc;
-            }, []);
-            var hierarchicalRefinements = new Map();
-            refinements.forEach(function(param) {
-                var attribute = param.attribute, value = param.value;
-                var hierarchicalFacet = helper.state.hierarchicalFacets.find(function(facet) {
-                    return facet.name === attribute || facet.attributes.includes(attribute);
-                });
-                if (hierarchicalFacet) {
-                    var currentValue = hierarchicalRefinements.get(hierarchicalFacet.name);
-                    if (currentValue === undefined || value.length > currentValue.length) {
-                        hierarchicalRefinements.set(hierarchicalFacet.name, value);
-                    }
-                    return;
-                }
-                if (!helper.state.isConjunctiveFacet(attribute) && !helper.state.isDisjunctiveFacet(attribute)) {
-                    helper.setState(helper.state.addDisjunctiveFacet(attribute));
-                }
-                helper.toggleFacetRefinement(attribute, value);
-            });
-            hierarchicalRefinements.forEach(function(value, name) {
-                helper.toggleFacetRefinement(name, value);
-            });
-        }
-        if (params.numericFilters) {
-            params.numericFilters.forEach(function(filter) {
-                var match = filter.match(NUMERIC_FILTER);
-                if (!match) {
-                    return;
-                }
-                var _match = _sliced_to_array(match, 4), attribute = _match[1], operator = _match[2], value = _match[3];
-                helper.addNumericRefinement(attribute, operator, Number(value));
-            });
-        }
-        if (params.query) {
-            helper.setQuery(params.query);
-        }
-        helper.search();
-        return helper.state;
-    }
     var connectChat = function connectChat(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$r());
+        checkRendering(renderFn, withUsage$s());
         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",
@@ -15163,6 +15283,35 @@
                 setMessages([]);
                 _chatInstance.clearError();
             };
+            var adoptConversation = function adoptConversation(param) {
+                var id = param.id, messages = param.messages, source = param.source;
+                var status = _chatInstance.status;
+                if (status === 'submitted' || status === 'streaming') {
+                    return false;
+                }
+                var tagged = messages.map(function(message) {
+                    return _object_spread_props(_object_spread({}, message), {
+                        metadata: _object_spread_props(_object_spread({}, message.metadata), {
+                            source: source
+                        })
+                    });
+                });
+                if (_chatInstance.messages.length === 0) {
+                    _chatInstance.setConversationId(id);
+                    setMessages(tagged);
+                } else {
+                    // The handing-off widget may still be mounted and hand off again
+                    // (e.g. a second follow-up suggestion): only new turns are appended.
+                    var existingIds = new Set(_chatInstance.messages.map(function(message) {
+                        return message.id;
+                    }));
+                    setMessages(_to_consumable_array(_chatInstance.messages).concat(_to_consumable_array(tagged.filter(function(message) {
+                        return !existingIds.has(message.id);
+                    }))));
+                }
+                _chatInstance.clearError();
+                return true;
+            };
             var validateEntryPoints = function validateEntryPoints(instantSearchInstance) {
                 if (disableTriggerValidation || hasValidatedEntryPoints) {
                     return;
@@ -15192,13 +15341,29 @@
                 var transport;
                 var client = instantSearchInstance.client;
                 var _getAppIdAndApiKey = _sliced_to_array(getAppIdAndApiKey(client), 2), appId = _getAppIdAndApiKey[0], apiKey = _getAppIdAndApiKey[1];
-                // Filter out custom data parts (like data-suggestions) that the backend doesn't accept
-                var filterDataParts = function filterDataParts(messages) {
+                // Shapes the local transcript into what the backend accepts: drops the
+                // custom data parts (like data-suggestions) it does not take, and puts a
+                // prompt-shortcut sentinel back on the user message that displays its
+                // resolved text (see `applyPromptShortcutEcho`). The wire always carries
+                // the sentinel, so a regenerate or a follow-up turn still resolves the
+                // configured prompt exactly like the first send did.
+                var prepareOutgoingMessages = function prepareOutgoingMessages(messages) {
                     return messages.map(function(message) {
+                        var _message_metadata;
                         var _message_parts;
-                        return _object_spread_props(_object_spread({}, message), {
+                        var _ref = (_message_metadata = message.metadata) !== null && _message_metadata !== void 0 ? _message_metadata : {}, promptShortcut = _ref.promptShortcut, metadata = _object_without_properties(_ref, [
+                            "promptShortcut"
+                        ]);
+                        var sentinel = typeof (promptShortcut === null || promptShortcut === void 0 ? void 0 : promptShortcut.sentinel) === 'string' ? promptShortcut.sentinel : undefined;
+                        return _object_spread_props(_object_spread({}, message, sentinel ? {
+                            metadata: Object.keys(metadata).length ? metadata : undefined
+                        } : {}), {
                             parts: (_message_parts = message.parts) === null || _message_parts === void 0 ? void 0 : _message_parts.filter(function(part) {
                                 return !('type' in part && part.type.startsWith('data-'));
+                            }).map(function(part) {
+                                return sentinel && part.type === 'text' ? _object_spread_props(_object_spread({}, part), {
+                                    text: sentinel
+                                }) : part;
                             })
                         });
                     });
@@ -15219,11 +15384,11 @@
                                     messages: params.messages
                                 }, params.body)
                             };
-                            // Then filter out data-* parts
+                            // Then shape the messages for the wire
                             var applyFilter = function applyFilter(prepared) {
                                 return _object_spread_props(_object_spread({}, prepared), {
                                     body: _object_spread_props(_object_spread({}, prepared.body), {
-                                        messages: filterDataParts(prepared.body.messages)
+                                        messages: prepareOutgoingMessages(prepared.body.messages)
                                     })
                                 });
                             };
@@ -15235,10 +15400,12 @@
                         }
                     }));
                 }
-                if ('agentId' in options && options.agentId) {
+                // A custom `transport` wins: `agentId` alongside it only serves feedback
+                // (and, for the result card, the Rule context).
+                if (!transport && 'agentId' in options && options.agentId) {
                     var _options_requestOptions, _options_requestOptions1;
                     if (!appId || !apiKey) {
-                        throw new Error(withUsage$r('Could not extract Algolia credentials from the search client.'));
+                        throw new Error(withUsage$s('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;
@@ -15270,17 +15437,74 @@
                                 body: {
                                     id: id,
                                     messageId: messageId,
-                                    messages: filterDataParts(messages)
+                                    messages: prepareOutgoingMessages(messages)
                                 }
                             };
                         }
                     });
                 }
                 if (!transport) {
-                    throw new Error(withUsage$r('You need to provide either an `agentId` or a `transport`.'));
-                }
+                    throw new Error(withUsage$s('You need to provide either an `agentId` or a `transport`.'));
+                }
+                // A prompt-shortcut turn (the `compare` widget's
+                // `__ALGOLIA_COMPARISON_<id>__`) sends a sentinel as the user message,
+                // which Agent Studio resolves into the natural-language text it
+                // persists on that row. The local transcript still holds the sentinel,
+                // so the server echoes the persisted text as a transient
+                // `data-prompt-shortcut` part right after `start`. Swapping it into the
+                // message that sent it keeps the live bubble, the session-restored
+                // transcript and a history reload in agreement, without the client
+                // knowing how shortcuts are configured or rendered. The sentinel moves
+                // to the message metadata so `prepareOutgoingMessages` can put it back
+                // on the wire: the backend resolves the shortcut from the token, not
+                // from its display text.
+                var applyPromptShortcutEcho = function applyPromptShortcutEcho(dataPart) {
+                    if (dataPart.type !== 'data-prompt-shortcut') return;
+                    var data = dataPart.data;
+                    var sentinel = data === null || data === void 0 ? void 0 : data.sentinel;
+                    var displayText = data === null || data === void 0 ? void 0 : data.displayText;
+                    if (typeof sentinel !== 'string' || typeof displayText !== 'string') {
+                        return;
+                    }
+                    setMessages(function(messages) {
+                        // Only the message being answered sent this sentinel: earlier turns
+                        // were rewritten by their own echo, and the same shortcut resolves
+                        // to a different text per selection.
+                        for(var index = messages.length - 1; index >= 0; index--){
+                            var _message_parts;
+                            var message = messages[index];
+                            if (message.role !== 'user' || ((_message_parts = message.parts) === null || _message_parts === void 0 ? void 0 : _message_parts.length) !== 1) {
+                                continue;
+                            }
+                            var part = message.parts[0];
+                            if (part.type !== 'text' || part.text.trim() !== sentinel) {
+                                continue;
+                            }
+                            var updated = _to_consumable_array(messages);
+                            updated[index] = _object_spread_props(_object_spread({}, message), {
+                                parts: [
+                                    _object_spread_props(_object_spread({}, part), {
+                                        text: displayText
+                                    })
+                                ],
+                                metadata: _object_spread_props(_object_spread({}, message.metadata), {
+                                    promptShortcut: {
+                                        sentinel: sentinel
+                                    }
+                                })
+                            });
+                            return updated;
+                        }
+                        return messages;
+                    });
+                };
                 var canRepairRestoredPendingToolParts = !resume;
                 var chat = new Chat(_object_spread_props(_object_spread({}, options), {
+                    onData: function onData(dataPart) {
+                        var _options_onData;
+                        applyPromptShortcutEcho(dataPart);
+                        (_options_onData = options.onData) === null || _options_onData === void 0 ? void 0 : _options_onData.call(options, dataPart);
+                    },
                     persistence: normalizedPersistence.messages,
                     sendAutomaticallyWhen: sendAutomaticallyWhen,
                     transport: transport,
@@ -15467,7 +15691,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$r('Could not extract Algolia credentials from the search client.'));
+                            throw new Error(withUsage$s('Could not extract Algolia credentials from the search client.'));
                         }
                         feedbackAbortController = new AbortController();
                         _sendChatMessageFeedback = function _sendChatMessageFeedback(messageId, vote) {
@@ -15569,7 +15793,7 @@
                         });
                     }
                     function applyFilters(params) {
-                        return updateStateFromSearchToolInput(params, helper);
+                        return applyAgentFilters(params, helper);
                     }
                     // A restored or server-rendered conversation never emitted the messages
                     // callback above; collecting is idempotent, so covering it here is free.
@@ -15604,11 +15828,18 @@
                         }
                         // Resolve once per send; let the server validate the payload and
                         // surface any contract violations.
-                        var turnContext = typeof context === 'function' ? context() : context;
+                        var widgetContext = typeof context === 'function' ? context() : context;
+                        var metadata = message.metadata;
+                        // An entry point (compare bar, prompt suggestions, `openChat`) may
+                        // have attached its own turn context to the message — e.g. the
+                        // selected products of a comparison. Add the ambient widget context
+                        // to it rather than replacing it; on a key both provide, the entry
+                        // point knows the turn better.
+                        var messageTurnContext = (metadata === null || metadata === void 0 ? void 0 : metadata.turnContext) && _type_of(metadata.turnContext) === 'object' && !Array.isArray(metadata.turnContext) ? metadata.turnContext : undefined;
                         return (_chatInstance1 = _chatInstance).sendMessage.apply(_chatInstance1, [
                             _object_spread_props(_object_spread({}, message), {
-                                metadata: _object_spread_props(_object_spread({}, message.metadata), {
-                                    turnContext: turnContext
+                                metadata: _object_spread_props(_object_spread({}, metadata), {
+                                    turnContext: _object_spread({}, widgetContext, messageTurnContext)
                                 })
                             })
                         ].concat(_to_consumable_array(rest)));
@@ -15631,6 +15862,7 @@
                         setMessages: setMessages,
                         suggestions: getSuggestionsFromMessages(_chatInstance.messages),
                         clearMessages: clearMessages,
+                        adoptConversation: adoptConversation,
                         tools: toolsWithAddToolResult,
                         records: records,
                         sendChatMessageFeedback: _sendChatMessageFeedback,
@@ -16103,20 +16335,20 @@
         };
     }
 
-    var withUsage$q = createDocumentationMessageGenerator({
+    var withUsage$r = 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$q());
+        checkRendering(renderFn, withUsage$r());
         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$q('The `agentId` option is required unless a custom `transport` is provided.'));
+                throw new Error(withUsage$r('The `agentId` option is required unless a custom `transport` is provided.'));
             }
             if (!task && !kind) {
-                throw new Error(withUsage$q('Either the `task` or `kind` option is required.'));
+                throw new Error(withUsage$r('Either the `task` or `kind` option is required.'));
             }
             var runner;
             var output;
@@ -16190,7 +16422,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$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 taskTransport = createTaskTransport({
                             transport: transport,
@@ -16237,14 +16469,14 @@
         };
     };
 
-    var withUsage$p = createDocumentationMessageGenerator({
+    var withUsage$q = createDocumentationMessageGenerator({
         name: 'prompt-suggestions',
         connector: true
     });
     var RENDER_STATE_KEY = 'promptSuggestions';
-    var CHAT_RENDER_STATE_KEY = 'chat';
+    var CHAT_RENDER_STATE_KEY$1 = 'chat';
     var PROMPT_SUGGESTIONS_TASK_KIND = 'prompt_suggestions';
-    var DEBOUNCE_MS = 300;
+    var DEBOUNCE_MS$1 = 300;
     function parseSuggestions(data) {
         var suggestions = data === null || data === void 0 ? void 0 : data.suggestions;
         if (!Array.isArray(suggestions)) {
@@ -16284,63 +16516,18 @@
             return null;
         }
     }
-    function stripInternalHitMetadata(hit) {
-        var clean = {};
-        Object.keys(hit).forEach(function(key) {
-            // Strip internal metadata, which is `_`-prefixed
-            // (`_highlightResult`, `_rankingInfo`, `__position`, …).
-            if (!key.startsWith('_')) {
-                clean[key] = hit[key];
-            }
-        });
-        return clean;
-    }
     var DEFAULT_TRANSFORM_HITS = function DEFAULT_TRANSFORM_HITS(hits) {
         return hits.slice(0, 5).map(stripInternalHitMetadata);
     };
-    function buildFilters(results) {
-        var state = results._state;
-        if (!state) {
-            return undefined;
-        }
-        var groups = [];
-        var disjunctiveGroups = {};
-        getRefinements(results, state).forEach(function(refinement) {
-            if (refinement.type === 'numeric') {
-                groups.push([
-                    "".concat(refinement.attribute).concat(refinement.operator).concat(refinement.numericValue)
-                ]);
-                return;
-            }
-            var value = refinement.type === 'exclude' ? "".concat(refinement.attribute, ":-").concat(refinement.name) : "".concat(refinement.attribute, ":").concat(refinement.name);
-            if (refinement.type === 'disjunctive') {
-                var group = disjunctiveGroups[refinement.attribute];
-                if (group) {
-                    group.push(value);
-                } else {
-                    var newGroup = [
-                        value
-                    ];
-                    disjunctiveGroups[refinement.attribute] = newGroup;
-                    groups.push(newGroup);
-                }
-                return;
-            }
-            groups.push([
-                value
-            ]);
-        });
-        return groups.length > 0 ? groups : undefined;
-    }
     var connectPromptSuggestions = function connectPromptSuggestions(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, 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$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.'));
             }
             var tasksState;
             var suggestions = [];
@@ -16370,12 +16557,12 @@
             // out to send nothing, it has to reconcile the dropped state instead.
             var droppedInnerRender = false;
             var getStateSignature = function getStateSignature(results) {
-                var _buildFilters;
+                var _getAgentFilters;
                 if (results.queryID) {
                     return results.queryID;
                 }
                 var query = results.query || '';
-                var filters = JSON.stringify((_buildFilters = buildFilters(results)) !== null && _buildFilters !== void 0 ? _buildFilters : []);
+                var filters = JSON.stringify((_getAgentFilters = getAgentFilters(results)) !== null && _getAgentFilters !== void 0 ? _getAgentFilters : []);
                 var hitIds = (results.hits || []).map(function(hit) {
                     return hit.objectID;
                 }).join(',');
@@ -16388,7 +16575,7 @@
                 if (!indexId || !((_instantSearchInstance_renderState = instantSearchInstance.renderState) === null || _instantSearchInstance_renderState === void 0 ? void 0 : _instantSearchInstance_renderState[indexId])) {
                     return undefined;
                 }
-                return instantSearchInstance.renderState[indexId][CHAT_RENDER_STATE_KEY];
+                return instantSearchInstance.renderState[indexId][CHAT_RENDER_STATE_KEY$1];
             };
             var sendToChat = function sendToChat(renderOptions) {
                 return function(prompt) {
@@ -16421,7 +16608,7 @@
                 if (!results) {
                     return undefined;
                 }
-                var filters = buildFilters(results);
+                var filters = getAgentFilters(results);
                 return _object_spread_props(_object_spread({
                     query: results.query || ''
                 }, filters ? {
@@ -16620,7 +16807,7 @@
                     stream: true
                 };
             } else {
-                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.'));
             }
             var tasksWidget = connectTasks(handleInnerRender, noop)(tasksParams);
             return {
@@ -16677,7 +16864,7 @@
                             if (latestResults && latestRenderOptions) {
                                 fetchAndRender(latestResults, latestRenderOptions);
                             }
-                        }, DEBOUNCE_MS);
+                        }, DEBOUNCE_MS$1);
                     }
                     renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState(renderOptions)), {
                         instantSearchInstance: instantSearchInstance
@@ -16704,6 +16891,363 @@
         return useConnector(connectPromptSuggestions, props, additionalWidgetProperties);
     }
 
+    var withUsage$p = createDocumentationMessageGenerator({
+        name: 'result-card',
+        connector: true
+    });
+    /** `x-algolia-referer` sent with the card's completion requests. */ var RESULT_CARD_REFERER = 'result-card';
+    /** `metadata.source` set on the messages handed off to the chat. */ var RESULT_CARD_SOURCE = 'resultCard';
+    var RULE_CONTEXT_PREFIX = 'agent-studio-result-card-';
+    var CHAT_RENDER_STATE_KEY = 'chat';
+    var DEBOUNCE_MS = 700;
+    var HITS_SAMPLE_SIZE = 5;
+    var MIN_QUERY_WORDS = 2;
+    /**
+     * The Rule context that ties the Rules Agent Studio manages for this agent to
+     * the search. The Dashboard derives the same value, so the two must agree.
+     */ function getResultCardRuleContext(agentId) {
+        return "".concat(RULE_CONTEXT_PREFIX).concat(agentId).replace(/[^A-Za-z0-9_-]/g, '_');
+    }
+    function countWords(query) {
+        return query.trim().split(/\s+/).filter(Boolean).length;
+    }
+    function isActivated(results) {
+        var _results_renderingContent_widgets_resultCard, _results_renderingContent_widgets, _results_renderingContent;
+        return ((_results_renderingContent = results.renderingContent) === null || _results_renderingContent === void 0 ? void 0 : (_results_renderingContent_widgets = _results_renderingContent.widgets) === null || _results_renderingContent_widgets === void 0 ? void 0 : (_results_renderingContent_widgets_resultCard = _results_renderingContent_widgets.resultCard) === null || _results_renderingContent_widgets_resultCard === void 0 ? void 0 : _results_renderingContent_widgets_resultCard.enabled) === true && countWords(results.query || '') >= MIN_QUERY_WORDS;
+    }
+    function computeActivation(results, previous) {
+        var query = results.query || '';
+        var filters = getAgentFilters(results);
+        var base = "".concat(results.index, "|").concat(query, "|").concat(JSON.stringify(filters !== null && filters !== void 0 ? filters : []));
+        // Pagination and "load more" change the hits but not the question, so the
+        // sample settled on the first page is kept and the card stays in place.
+        if (previous && previous.base === base && results.page > 0) {
+            return previous;
+        }
+        // Positions and query ID are attached now: by the time the Insights event
+        // fires, the latest results may be another page of the same question.
+        var hits = addQueryID(addAbsolutePosition(results.hits.slice(0, HITS_SAMPLE_SIZE), results.page, results.hitsPerPage), results.queryID);
+        var hitIds = JSON.stringify(hits.map(function(hit) {
+            return hit.objectID;
+        }));
+        return {
+            base: base,
+            signature: "".concat(base, "|").concat(hitIds),
+            context: {
+                query: query,
+                filters: filters,
+                hits: hits
+            }
+        };
+    }
+    function buildTurnContext(param) {
+        var query = param.query, filters = param.filters, hits = param.hits;
+        // `metadata.turnContext` is a flat string map, so non-string values are
+        // serialized; same keys and shapes as the `promptSuggestions` widget.
+        return _object_spread_props(_object_spread({
+            query: query
+        }, filters ? {
+            filters: JSON.stringify(filters)
+        } : {}), {
+            hitsSample: JSON.stringify(hits.map(stripInternalHitMetadata))
+        });
+    }
+    // Sent as-is, the query reads as a search: the agent re-runs it and answers
+    // "I found…", which the hits below already show. Each clause of the question
+    // heads off a failure mode: "prefer the results provided" answers from
+    // `hitsSample`; "search for better ones" covers a natural-language query that
+    // matched the wrong records; "never display results" stops an agent with that
+    // tool from replying with a `display_results` call and no text, which the
+    // card cannot show. Stopgap until the backend applies a result-card
+    // instruction from the `x-algolia-referer` header.
+    function buildQuestion(query) {
+        return "I'm looking for \"".concat(query, "\". Which of these results would you recommend and why? Prefer the results provided; if they don't answer the question, search for better ones. Always answer in two or three sentences and never display results.");
+    }
+    function hasAssistantMessage(messages) {
+        return Boolean(messages === null || messages === void 0 ? void 0 : messages.some(function(message) {
+            return message.role === 'assistant';
+        }));
+    }
+    var connectResultCard = function connectResultCard(renderFn) {
+        var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
+        checkRendering(renderFn, withUsage$p());
+        return function(widgetParams) {
+            var _ref = widgetParams || {}, agentId = _ref.agentId, transport = _ref.transport, requestOptions = _ref.requestOptions;
+            if (!agentId) {
+                throw new Error(withUsage$p('The `agentId` option is required.'));
+            }
+            if (transport && requestOptions) {
+                throw new Error(withUsage$p('The `transport` and `requestOptions` options are mutually exclusive.'));
+            }
+            var ruleContext = getResultCardRuleContext(agentId);
+            var chatState;
+            var latestRenderOptions = null;
+            var activation = null;
+            var expanded = false;
+            // True between a signature change and the debounced request that follows
+            // it, so the card shows its skeleton rather than the previous answer.
+            var requestPending = false;
+            var debounceTimer;
+            // Set in `dispose()`: a stream can still deliver chunks into the inner
+            // chat afterwards, and those renders must not reach a torn-down container.
+            var disposed = false;
+            var sendEvent;
+            var _obj;
+            var chatParams = _object_spread_props(_object_spread({
+                agentId: agentId
+            }, transport ? {
+                transport: transport
+            } : {
+                requestOptions: requestOptions
+            }), {
+                // The card owns its conversation: nothing shared with the chat panel.
+                persistence: false,
+                type: 'resultCard',
+                disableTriggerValidation: true,
+                // The agent runs its built-in tools server-side and streams their
+                // output. Registering them without `onToolCall` keeps that output; an
+                // unknown tool is answered with "No tool implemented", which drops the
+                // hits the chat's grouped-results needs after the handoff. Same set as
+                // the `chat` widget's defaults.
+                tools: (_obj = {}, _define_property(_obj, SearchIndexToolType, {}), _define_property(_obj, RecommendToolType, {}), _define_property(_obj, GroupedResultsToolType, {}), _define_property(_obj, DisplayResultsToolType, {}), _define_property(_obj, CompareProductsToolType, {}), _define_property(_obj, MemorizeToolType, {}), _define_property(_obj, MemorySearchToolType, {}), _define_property(_obj, PonderToolType, {}), _obj)
+            });
+            var renderOutward = function renderOutward(renderOptions) {
+                if (disposed) return;
+                renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState(renderOptions)), {
+                    instantSearchInstance: renderOptions.instantSearchInstance
+                }), false);
+            };
+            var rerender = function rerender() {
+                if (latestRenderOptions) {
+                    renderOutward(latestRenderOptions);
+                }
+            };
+            // Mirrors every inner render (message deltas, status, errors) into this
+            // widget's own render. The inner widget's `init` render lands before
+            // `latestRenderOptions` is set, so it is stored but not painted.
+            var handleInnerRender = function handleInnerRender(renderState) {
+                chatState = renderState;
+                rerender();
+            };
+            var chatWidget = connectChat(handleInnerRender, noop)(chatParams);
+            var stopGeneration = function stopGeneration() {
+                if (chatState && isChatBusy(chatState)) {
+                    chatState.stop();
+                }
+            };
+            var cancelPendingRequest = function cancelPendingRequest() {
+                clearTimeout(debounceTimer);
+                debounceTimer = undefined;
+                requestPending = false;
+            };
+            var send = function send() {
+                cancelPendingRequest();
+                if (disposed || !chatState || !activation) return;
+                var context = activation.context;
+                chatState.clearMessages();
+                chatState.sendMessage({
+                    text: buildQuestion(context.query),
+                    metadata: {
+                        turnContext: buildTurnContext(context)
+                    }
+                }, {
+                    headers: {
+                        'x-algolia-referer': RESULT_CARD_REFERER
+                    }
+                });
+                if (sendEvent) {
+                    sendEvent('view:internal', context.hits);
+                }
+            };
+            var scheduleRequest = function scheduleRequest() {
+                cancelPendingRequest();
+                requestPending = true;
+                // Generation is a browser concern: a server render shows the skeleton
+                // and the browser starts the request after hydration.
+                safelyRunOnBrowser(function() {
+                    debounceTimer = setTimeout(send, DEBOUNCE_MS);
+                });
+            };
+            // In each transition below the card's own state is settled before
+            // `stopGeneration()`: stopping re-renders synchronously through the inner
+            // chat, and that render must already see the new status.
+            var deactivate = function deactivate() {
+                cancelPendingRequest();
+                activation = null;
+                stopGeneration();
+            };
+            var syncActivation = function syncActivation(results) {
+                if (!isActivated(results)) {
+                    if (activation) deactivate();
+                    return;
+                }
+                var next = computeActivation(results, activation);
+                if (activation && next.signature === activation.signature) {
+                    return;
+                }
+                activation = next;
+                expanded = false;
+                scheduleRequest();
+                stopGeneration();
+            };
+            var retry = function retry() {
+                if (!activation) return;
+                send();
+            };
+            var setExpanded = function setExpanded(nextExpanded) {
+                if (expanded === nextExpanded) return;
+                expanded = nextExpanded;
+                rerender();
+            };
+            var getDefaultChat = function getDefaultChat(renderOptions) {
+                var _instantSearchInstance_renderState_indexId, _instantSearchInstance_renderState, _defaultChat_widgetParams;
+                if (!renderOptions) return undefined;
+                var instantSearchInstance = renderOptions.instantSearchInstance, parent = renderOptions.parent;
+                var indexId = parent ? parent.getIndexId() : '';
+                var defaultChat = (_instantSearchInstance_renderState = instantSearchInstance.renderState) === null || _instantSearchInstance_renderState === void 0 ? void 0 : (_instantSearchInstance_renderState_indexId = _instantSearchInstance_renderState[indexId]) === null || _instantSearchInstance_renderState_indexId === void 0 ? void 0 : _instantSearchInstance_renderState_indexId[CHAT_RENDER_STATE_KEY];
+                // Only the agent is compared: a custom `transport` on either side does
+                // not affect the handoff.
+                if (!(defaultChat === null || defaultChat === void 0 ? void 0 : defaultChat.adoptConversation) || ((_defaultChat_widgetParams = defaultChat.widgetParams) === null || _defaultChat_widgetParams === void 0 ? void 0 : _defaultChat_widgetParams.agentId) !== agentId) {
+                    return undefined;
+                }
+                return defaultChat;
+            };
+            var continueInChat = function continueInChat(message) {
+                var defaultChat = getDefaultChat(latestRenderOptions);
+                if (!defaultChat || !chatState || !activation) return;
+                // Keep the inner prompt's directives private when it becomes chat history.
+                var query = activation.context.query;
+                var messages = chatState.messages.map(function(chatMessage) {
+                    return chatMessage.role === 'user' ? _object_spread_props(_object_spread({}, chatMessage), {
+                        parts: [
+                            {
+                                type: 'text',
+                                text: query
+                            }
+                        ]
+                    }) : chatMessage;
+                });
+                // A chat mid-generation refuses the conversation: opening it anyway
+                // would show an unrelated exchange instead of the card's.
+                var adopted = defaultChat.adoptConversation({
+                    id: chatState.id,
+                    messages: messages,
+                    source: RESULT_CARD_SOURCE
+                });
+                if (!adopted) return;
+                openChat(defaultChat, {
+                    message: message,
+                    referer: RESULT_CARD_REFERER
+                });
+            };
+            var getStatus = function getStatus(currentActivation) {
+                if (!currentActivation) return 'hidden';
+                // Checked before the inner chat's status: until the debounced request
+                // runs, that status (and its error) still belongs to the previous question.
+                if (requestPending) return 'loading';
+                if ((chatState === null || chatState === void 0 ? void 0 : chatState.status) === 'error') return 'failed';
+                if ((chatState === null || chatState === void 0 ? void 0 : chatState.status) === 'streaming') return 'streaming';
+                if ((chatState === null || chatState === void 0 ? void 0 : chatState.status) === 'submitted') return 'loading';
+                return hasAssistantMessage(chatState === null || chatState === void 0 ? void 0 : chatState.messages) ? 'complete' : 'loading';
+            };
+            var getWidgetRenderState = function getWidgetRenderState(renderOptions) {
+                var _ref, _ref1;
+                var instantSearchInstance = renderOptions.instantSearchInstance, helper = renderOptions.helper;
+                var results = 'results' in renderOptions ? renderOptions.results : undefined;
+                if (!sendEvent) {
+                    sendEvent = createSendEventForHits({
+                        instantSearchInstance: instantSearchInstance,
+                        helper: helper,
+                        widgetType: 'ais.resultCard'
+                    });
+                }
+                // Before `render` has run (server render, or React computing its initial
+                // state) the activation is derived from the results at hand, without
+                // scheduling anything.
+                var currentActivation = activation !== null && activation !== void 0 ? activation : results && isActivated(results) ? computeActivation(results, null) : null;
+                var status = getStatus(currentActivation);
+                var canContinueInChat = Boolean(getDefaultChat(renderOptions));
+                return {
+                    status: status,
+                    query: (_ref = currentActivation === null || currentActivation === void 0 ? void 0 : currentActivation.context.query) !== null && _ref !== void 0 ? _ref : '',
+                    // Until the debounced request runs, the inner chat still holds the
+                    // previous question's answer.
+                    messages: requestPending ? [] : (_ref1 = chatState === null || chatState === void 0 ? void 0 : chatState.messages) !== null && _ref1 !== void 0 ? _ref1 : [],
+                    // The inner chat keeps the last error around after recovering.
+                    error: status === 'failed' ? chatState === null || chatState === void 0 ? void 0 : chatState.error : undefined,
+                    suggestions: requestPending ? undefined : chatState === null || chatState === void 0 ? void 0 : chatState.suggestions,
+                    retry: retry,
+                    canContinueInChat: canContinueInChat,
+                    continueInChat: continueInChat,
+                    expanded: expanded,
+                    setExpanded: setExpanded,
+                    sendEvent: sendEvent,
+                    widgetParams: widgetParams
+                };
+            };
+            return {
+                $$type: 'ais.resultCard',
+                // "Continue in chat" opens the chat, so this widget counts as an entry
+                // point for `connectChat`'s trigger validation.
+                opensChat: true,
+                init: function init(initOptions) {
+                    disposed = false;
+                    cancelPendingRequest();
+                    chatState = undefined;
+                    latestRenderOptions = null;
+                    activation = null;
+                    expanded = false;
+                    sendEvent = undefined;
+                    chatWidget.init(initOptions);
+                    // After the inner init so its first render is stored, not painted.
+                    latestRenderOptions = initOptions;
+                    renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState(initOptions)), {
+                        instantSearchInstance: initOptions.instantSearchInstance
+                    }), true);
+                },
+                render: function render(renderOptions) {
+                    latestRenderOptions = renderOptions;
+                    if (renderOptions.results) {
+                        syncActivation(renderOptions.results);
+                    }
+                    renderOutward(renderOptions);
+                },
+                dispose: function dispose(disposeOptions) {
+                    disposed = true;
+                    cancelPendingRequest();
+                    stopGeneration();
+                    chatWidget.dispose();
+                    unmountFn();
+                    var remaining = (disposeOptions.state.ruleContexts || []).filter(function(context) {
+                        return context !== ruleContext;
+                    });
+                    return disposeOptions.state.setQueryParameter('ruleContexts', remaining.length > 0 ? remaining : undefined);
+                },
+                getWidgetSearchParameters: function getWidgetSearchParameters(state) {
+                    var ruleContexts = state.ruleContexts || [];
+                    if (ruleContexts.includes(ruleContext)) {
+                        return state;
+                    }
+                    return state.setQueryParameter('ruleContexts', _to_consumable_array(ruleContexts).concat([
+                        ruleContext
+                    ]));
+                },
+                getRenderState: function getRenderState(renderState, renderOptions) {
+                    return _object_spread_props(_object_spread({}, renderState), {
+                        resultCard: this.getWidgetRenderState(renderOptions)
+                    });
+                },
+                getWidgetRenderState: function getWidgetRenderState1(renderOptions) {
+                    return getWidgetRenderState(renderOptions);
+                }
+            };
+        };
+    };
+
+    function useResultCard(props, additionalWidgetProperties) {
+        return useConnector(connectResultCard, props, additionalWidgetProperties);
+    }
+
     var withUsage$o = createDocumentationMessageGenerator({
         name: 'chatTrigger',
         connector: true
@@ -16798,11 +17342,11 @@
         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.
+     * Builds the default comparison message. It names each selected item; the
+     * records themselves travel in the turn context (`selected_products`), where
+     * both the agent and the builtin `algolia_compare_products` table read them,
+     * so no search round-trip is needed to render the comparison. Works with the
+     * default shopping assistant prompt — no agent configuration required.
      */ function getDefaultComparisonMessage(items) {
         var labels = items.map(function(item) {
             var _item_name;
@@ -18979,16 +19523,23 @@
         return ruleContexts;
     }
     function applyRuleContexts(event) {
-        var _this = this, helper = _this.helper, initialRuleContexts = _this.initialRuleContexts, trackedFilters = _this.trackedFilters, transformRuleContexts = _this.transformRuleContexts;
+        var _this = this;
+        var _this1 = this, helper = _this1.helper, trackedFilters = _this1.trackedFilters, transformRuleContexts = _this1.transformRuleContexts;
         var sharedHelperState = event.state;
         var previousRuleContexts = sharedHelperState.ruleContexts || [];
+        var foreignRuleContexts = previousRuleContexts.filter(function(ruleContext) {
+            return !_this.ownedRuleContexts.includes(ruleContext);
+        });
         var newRuleContexts = getRuleContextsFromTrackedFilters({
             helper: helper,
             sharedHelperState: sharedHelperState,
             trackedFilters: trackedFilters
         });
-        var nextRuleContexts = _to_consumable_array(initialRuleContexts).concat(_to_consumable_array(newRuleContexts));
+        var nextRuleContexts = _to_consumable_array(foreignRuleContexts).concat(_to_consumable_array(newRuleContexts));
         var ruleContexts = transformRuleContexts(nextRuleContexts).slice(0, 10);
+        this.ownedRuleContexts = ruleContexts.filter(function(ruleContext) {
+            return !foreignRuleContexts.includes(ruleContext);
+        });
         if (!isEqual(previousRuleContexts, ruleContexts)) {
             helper.overrideStateWithoutTriggeringChangeEvent(_object_spread_props(_object_spread({}, sharedHelperState), {
                 ruleContexts: ruleContexts
@@ -19010,21 +19561,19 @@
                 }
             });
             var hasTrackedFilters = Object.keys(trackedFilters).length > 0;
-            // We store the initial rule contexts applied before creating the widget
-            // so that we do not override them with the rules created from `trackedFilters`.
-            var initialRuleContexts = [];
+            var tracker;
             var onHelperChange;
             return {
                 $$type: 'ais.queryRules',
                 init: function init(initOptions) {
                     var helper = initOptions.helper, state = initOptions.state, instantSearchInstance = initOptions.instantSearchInstance;
-                    initialRuleContexts = state.ruleContexts || [];
-                    onHelperChange = applyRuleContexts.bind({
+                    tracker = {
                         helper: helper,
-                        initialRuleContexts: initialRuleContexts,
                         trackedFilters: trackedFilters,
-                        transformRuleContexts: transformRuleContexts
-                    });
+                        transformRuleContexts: transformRuleContexts,
+                        ownedRuleContexts: []
+                    };
+                    onHelperChange = applyRuleContexts.bind(tracker);
                     if (hasTrackedFilters) {
                         // We need to apply the `ruleContexts` based on the `trackedFilters`
                         // before the helper changes state in some cases:
@@ -19070,7 +19619,9 @@
                     unmount();
                     if (hasTrackedFilters) {
                         helper.removeListener('change', onHelperChange);
-                        return state.setQueryParameter('ruleContexts', initialRuleContexts);
+                        return state.setQueryParameter('ruleContexts', (state.ruleContexts || []).filter(function(ruleContext) {
+                            return !tracker.ownedRuleContexts.includes(ruleContext);
+                        }));
                     }
                     return state;
                 }
@@ -21188,6 +21739,7 @@
     exports.useRange = useRange;
     exports.useRefinementList = useRefinementList;
     exports.useRelatedProducts = useRelatedProducts;
+    exports.useResultCard = useResultCard;
     exports.useSearchBox = useSearchBox;
     exports.useSortBy = useSortBy;
     exports.useStats = useStats;