react-instantsearch-core 7.41.0 → 7.42.0

package/dist/umd/ReactInstantSearchCore.js

@@ -1,4 +1,4 @@
-/*! React InstantSearch Core 7.41.0 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
+/*! React InstantSearch Core 7.42.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.41.0';
+    var version$2 = '7.42.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.2';
+        version$1 = '3.29.3';
         return version$1;
     }
 
@@ -5980,7 +5980,7 @@
         }
     }
 
-    var withUsage$v = createDocumentationMessageGenerator({
+    var withUsage$x = 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$v('The `searchParameters` option expects an object.'));
+                throw new Error(withUsage$x('The `searchParameters` option expects an object.'));
             }
             var connectorState = {};
             function refine(helper) {
@@ -6280,6 +6280,38 @@
         return stableValue;
     }
 
+    /**
+     * Forwards the insights-related search parameters to every Recommend query.
+     *
+     * The insights middleware writes `userToken` and `clickAnalytics` on the main
+     * helper's search state, which only feeds search queries: Recommend queries are
+     * built from their own parameters and never read the search state. Without this,
+     * recommendations can't be personalized, and their responses carry no `queryID`
+     * for the connectors to attribute click and conversion events with.
+     *
+     * Parameters set on a widget win, so an explicit `queryParameters.userToken`
+     * keeps overriding the middleware.
+     */ function addInsightsToRecommendParameters(recommendParameters, param) {
+        var userToken = param.userToken, clickAnalytics = param.clickAnalytics;
+        if (userToken === undefined && clickAnalytics === undefined) {
+            return recommendParameters;
+        }
+        return new algoliasearchHelper.RecommendParameters({
+            params: recommendParameters.params.map(function(params) {
+                // v4 `TrendingFacetsQuery` doesn't include `queryParameters`, but the v5
+                // API and the helper support them, like `connectTrendingFacets` does.
+                var queryParameters = params.queryParameters;
+                return _object_spread_props(_object_spread({}, params), {
+                    queryParameters: _object_spread({}, clickAnalytics === undefined ? {} : {
+                        clickAnalytics: clickAnalytics
+                    }, userToken === undefined ? {} : {
+                        userToken: userToken
+                    }, queryParameters)
+                });
+            })
+        });
+    }
+
     var id = 0;
     function addWidgetId(widget) {
         if (widget.dependsOn !== 'recommend') {
@@ -7788,13 +7820,13 @@
         return null;
     }
 
-    var withUsage$u = createDocumentationMessageGenerator({
+    var withUsage$w = 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$u());
+        checkRendering(renderFn, withUsage$w());
         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 ? [
                 '*'
@@ -7804,10 +7836,10 @@
             if (!(widgets && Array.isArray(widgets) && widgets.every(function(widget) {
                 return (typeof widget === "undefined" ? "undefined" : _type_of(widget)) === 'object';
             }))) {
-                throw new Error(withUsage$u('The `widgets` option expects an array of widgets.'));
+                throw new Error(withUsage$w('The `widgets` option expects an array of widgets.'));
             }
             if (!Array.isArray(facets)) {
-                throw new Error(withUsage$u("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
+                throw new Error(withUsage$w("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
             }
             var localWidgets = new Map();
             return {
@@ -7909,7 +7941,7 @@
                         results: results
                     });
                     if (!Array.isArray(attributesToRender)) {
-                        throw new Error(withUsage$u('The `transformItems` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$w('The `transformItems` option expects a function that returns an Array.'));
                     }
                     return {
                         attributesToRender: attributesToRender,
@@ -8231,19 +8263,19 @@
             return toFeedSearchResults(lastResults._state, raw);
         });
     }
-    var withUsage$t = createDocumentationMessageGenerator({
+    var withUsage$v = 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$t());
+        checkRendering(renderFn, withUsage$v());
         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$t('The `isolated` option currently only supports `false`.'));
+                throw new Error(withUsage$v('The `isolated` option currently only supports `false`.'));
             }
             return {
                 $$type: 'ais.feeds',
@@ -8251,7 +8283,7 @@
                 init: function init(initOptions) {
                     var instantSearchInstance = initOptions.instantSearchInstance;
                     if (!instantSearchInstance.compositionID) {
-                        throw new Error(withUsage$t('The `feeds` widget requires a composition-based InstantSearch instance (compositionID must be set).'));
+                        throw new Error(withUsage$v('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)), {
@@ -8297,12 +8329,12 @@
                     ];
                     feedIDs = transformFeeds(feedIDs);
                     if (!Array.isArray(feedIDs)) {
-                        throw new Error(withUsage$t('The `transformFeeds` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$v('The `transformFeeds` option expects a function that returns an Array.'));
                     }
                     if (!feedIDs.every(function(feedID) {
                         return typeof feedID === 'string';
                     })) {
-                        throw new Error(withUsage$t('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
+                        throw new Error(withUsage$v('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
                     }
                     return {
                         feedIDs: feedIDs,
@@ -8413,7 +8445,7 @@
         }));
     }
 
-    var withUsage$s = createDocumentationMessageGenerator({
+    var withUsage$u = createDocumentationMessageGenerator({
         name: 'index-widget'
     });
     /**
@@ -8541,7 +8573,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$s('The `indexName` option is required.'));
+            throw new Error(withUsage$u('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.
@@ -8634,7 +8666,7 @@
             addWidgets: function addWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$s('The `addWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$u('The `addWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8644,7 +8676,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.init !== 'function' && typeof widget.render !== 'function';
                 })) {
-                    throw new Error(withUsage$s('The widget definition expects a `render` and/or an `init` method.'));
+                    throw new Error(withUsage$u('The widget definition expects a `render` and/or an `init` method.'));
                 }
                 flatWidgets.forEach(function(widget) {
                     widget.parent = _this;
@@ -8695,7 +8727,7 @@
             removeWidgets: function removeWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$s('The `removeWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$u('The `removeWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8705,7 +8737,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.dispose !== 'function';
                 })) {
-                    throw new Error(withUsage$s('The widget definition expects a `dispose` method.'));
+                    throw new Error(withUsage$u('The widget definition expects a `dispose` method.'));
                 }
                 localWidgets = localWidgets.filter(function(widget) {
                     return flatWidgets.indexOf(widget) === -1;
@@ -8833,7 +8865,7 @@
                         mainHelper.state
                     ].concat(_to_consumable_array(resolveSearchParameters(_this))));
                 }, function() {
-                    return _this.getHelper().recommendState;
+                    return addInsightsToRecommendParameters(_this.getHelper().recommendState, mainHelper.state);
                 });
                 var indexInitialResults = (_instantSearchInstance__initialResults = instantSearchInstance._initialResults) === null || _instantSearchInstance__initialResults === void 0 ? void 0 : _instantSearchInstance__initialResults[this.getIndexId()];
                 if (indexInitialResults === null || indexInitialResults === void 0 ? void 0 : indexInitialResults.results) {
@@ -9210,7 +9242,7 @@
         });
     }
 
-    var version = '4.108.0';
+    var version = '4.109.0';
 
     var ANONYMOUS_TOKEN_COOKIE_KEY = '_ALGOLIA';
     function getCookie(name) {
@@ -9440,7 +9472,8 @@
                             helper.overrideStateWithoutTriggeringChangeEvent(_object_spread_props(_object_spread({}, helper.state), {
                                 userToken: normalizedUserToken
                             }));
-                            if (existingToken && existingToken !== userToken) {
+                            if (existingToken && existingToken !== normalizedUserToken) {
+                                helper._recommendCache = {};
                                 instantSearchInstance.scheduleSearch();
                             }
                         }
@@ -9529,14 +9562,17 @@
                         } else if (event.insightsMethod) {
                             if (event.insightsMethod === 'viewedObjectIDs') {
                                 var payload = event.payload;
+                                var getViewEventKey = function getViewEventKey(objectID) {
+                                    return payload.queryID ? "".concat(payload.queryID, ":").concat(objectID) : objectID;
+                                };
                                 var difference = payload.objectIDs.filter(function(objectID) {
-                                    return !viewedObjectIDs.has(objectID);
+                                    return !viewedObjectIDs.has(getViewEventKey(objectID));
                                 });
                                 if (difference.length === 0) {
                                     return;
                                 }
                                 difference.forEach(function(objectID) {
-                                    return viewedObjectIDs.add(objectID);
+                                    return viewedObjectIDs.add(getViewEventKey(objectID));
                                 });
                                 payload.objectIDs = difference;
                             }
@@ -9644,10 +9680,10 @@
      * and the ability to set credentials via extra parameters when sending events.
      */ function isModernInsightsClient(client) {
         var _split_map = _sliced_to_array((client.version || '').split('.').map(Number), 2), major = _split_map[0], minor = _split_map[1];
-        /* eslint-disable instantsearch/naming-convention */ var v3 = major >= 3;
+        /* oxlint-disable instantsearch/naming-convention */ var v3 = major >= 3;
         var v2_6 = major === 2 && minor >= 6;
         var v1_10 = major === 1 && minor >= 10;
-        /* eslint-enable instantsearch/naming-convention */ return v3 || v2_6 || v1_10;
+        /* oxlint-enable instantsearch/naming-convention */ return v3 || v2_6 || v1_10;
     }
     /**
      * While `search-insights` supports both string and number user tokens,
@@ -11068,7 +11104,7 @@
         };
     }
 
-    var withUsage$r = createDocumentationMessageGenerator({
+    var withUsage$t = createDocumentationMessageGenerator({
         name: 'instantsearch'
     });
     function defaultCreateURL() {
@@ -11131,7 +11167,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$r('The `searchClient` option is required.'));
+                throw new Error(withUsage$t('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/");
@@ -11140,7 +11176,7 @@
                 searchClient.addAlgoliaAgent("instantsearch.js (".concat(version, ")"));
             }
             if (insightsClient && typeof insightsClient !== 'function') {
-                throw new Error(withUsage$r('The `insightsClient` option should be a function.'));
+                throw new Error(withUsage$t('The `insightsClient` option should be a function.'));
             }
             _this._initialOptions = options;
             _this.client = searchClient;
@@ -11289,12 +11325,12 @@
        * @param widgets The array of widgets to add to InstantSearch.
        */ function addWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$r('The `addWidgets` method expects an array of widgets. Please use `addWidget`.'));
+                        throw new Error(withUsage$t('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$r('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
+                        throw new Error(withUsage$t('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
                     }
                     this.mainIndex.addWidgets(widgets);
                     return this;
@@ -11323,7 +11359,7 @@
        * The widgets must implement a `dispose()` method to clear their states.
        */ function removeWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$r('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
+                        throw new Error(withUsage$t('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
                     }
                     this.mainIndex.removeWidgets(widgets);
                     return this;
@@ -11337,7 +11373,7 @@
        */ function start() {
                     var _this = this;
                     if (this.started) {
-                        throw new Error(withUsage$r('The `start` method has already been called once.'));
+                        throw new Error(withUsage$t('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
@@ -11545,7 +11581,7 @@
                     var _this = this;
                     var callOnStateChange = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$r('The `start` method needs to be called before `setUiState`.'));
+                        throw new Error(withUsage$t('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`.
@@ -11582,7 +11618,7 @@
                 value: function createURL() {
                     var nextState = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
                     if (!this.started) {
-                        throw new Error(withUsage$r('The `start` method needs to be called before `createURL`.'));
+                        throw new Error(withUsage$t('The `start` method needs to be called before `createURL`.'));
                     }
                     return this._createURL(nextState);
                 }
@@ -11591,7 +11627,7 @@
                 key: "refresh",
                 value: function refresh() {
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$r('The `start` method needs to be called before `refresh`.'));
+                        throw new Error(withUsage$t('The `start` method needs to be called before `refresh`.'));
                     }
                     this.mainHelper.clearCache().search();
                 }
@@ -12117,13 +12153,13 @@
         }, children);
     }
 
-    var withUsage$q = createDocumentationMessageGenerator({
+    var withUsage$s = 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$q());
+        checkRendering(renderFn, withUsage$s());
         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;
@@ -12236,20 +12272,20 @@
         return useConnector(connectAutocomplete, props, additionalWidgetProperties);
     }
 
-    var withUsage$p = createDocumentationMessageGenerator({
+    var withUsage$r = 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$p());
+        checkRendering(renderFn, withUsage$r());
         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$p('The `attributes` option expects an array of strings.'));
+                throw new Error(withUsage$r('The `attributes` option expects an array of strings.'));
             }
             var _attributes = _sliced_to_array(attributes, 1), hierarchicalFacetName = _attributes[0];
             function getRefinedState(state, facetValue) {
@@ -12395,6 +12431,76 @@
         return useConnector(connectBreadcrumb, props, additionalWidgetProperties);
     }
 
+    var tryParseJson = function tryParseJson(value) {
+        try {
+            return JSON.parse(value);
+        } catch (unused) {
+            return undefined;
+        }
+    };
+    var repairPartialJson = function repairPartialJson(value) {
+        var repaired = value.trim();
+        if (!repaired) {
+            return repaired;
+        }
+        var inString = false;
+        var isEscaped = false;
+        var stack = [];
+        for(var index = 0; index < repaired.length; index++){
+            var char = repaired[index];
+            if (inString) {
+                if (isEscaped) {
+                    isEscaped = false;
+                } else if (char === '\\') {
+                    isEscaped = true;
+                } else if (char === '"') {
+                    inString = false;
+                }
+                continue;
+            }
+            if (char === '"') {
+                inString = true;
+                continue;
+            }
+            if (char === '{' || char === '[') {
+                stack.push(char);
+                continue;
+            }
+            if (char === '}' && stack[stack.length - 1] === '{') {
+                stack.pop();
+                continue;
+            }
+            if (char === ']' && stack[stack.length - 1] === '[') {
+                stack.pop();
+            }
+        }
+        if (inString && !isEscaped) {
+            repaired += '"';
+        }
+        repaired = repaired.replace(RegExp(",\\s*$", "u"), '');
+        if (stack.length > 0) {
+            repaired += stack.reverse().map(function(opening) {
+                return opening === '{' ? '}' : ']';
+            }).join('');
+        }
+        return repaired.replace(RegExp(",\\s*([}\\]])", "gu"), '$1');
+    };
+    var parsePartialJson = function parsePartialJson(accumulatedRawJson, fallbackValue) {
+        var normalized = accumulatedRawJson.trim();
+        if (!normalized) {
+            return fallbackValue;
+        }
+        var directParsed = tryParseJson(normalized);
+        if (directParsed !== undefined) {
+            return directParsed;
+        }
+        var repairedParsed = tryParseJson(repairPartialJson(normalized));
+        if (repairedParsed !== undefined) {
+            return repairedParsed;
+        }
+        return fallbackValue;
+    };
+
     /**
      * Stream parser for parsing SSE (Server-Sent Events) streams.
      * The AI SDK 5 format uses SSE with JSON payloads prefixed by "data: ".
@@ -12676,75 +12782,6 @@
     }
 
     var _computedKey$1;
-    var tryParseJson = function tryParseJson(value) {
-        try {
-            return JSON.parse(value);
-        } catch (unused) {
-            return undefined;
-        }
-    };
-    var repairPartialJson = function repairPartialJson(value) {
-        var repaired = value.trim();
-        if (!repaired) {
-            return repaired;
-        }
-        var inString = false;
-        var isEscaped = false;
-        var stack = [];
-        for(var index = 0; index < repaired.length; index++){
-            var char = repaired[index];
-            if (inString) {
-                if (isEscaped) {
-                    isEscaped = false;
-                } else if (char === '\\') {
-                    isEscaped = true;
-                } else if (char === '"') {
-                    inString = false;
-                }
-                continue;
-            }
-            if (char === '"') {
-                inString = true;
-                continue;
-            }
-            if (char === '{' || char === '[') {
-                stack.push(char);
-                continue;
-            }
-            if (char === '}' && stack[stack.length - 1] === '{') {
-                stack.pop();
-                continue;
-            }
-            if (char === ']' && stack[stack.length - 1] === '[') {
-                stack.pop();
-            }
-        }
-        if (inString && !isEscaped) {
-            repaired += '"';
-        }
-        repaired = repaired.replace(RegExp(",\\s*$", "u"), '');
-        if (stack.length > 0) {
-            repaired += stack.reverse().map(function(opening) {
-                return opening === '{' ? '}' : ']';
-            }).join('');
-        }
-        return repaired.replace(RegExp(",\\s*([}\\]])", "gu"), '$1');
-    };
-    var parseToolInputDelta = function parseToolInputDelta(accumulatedRawInput, fallbackInput) {
-        var normalized = accumulatedRawInput.trim();
-        if (!normalized) {
-            return fallbackInput;
-        }
-        var directParsed = tryParseJson(normalized);
-        if (directParsed !== undefined) {
-            return directParsed;
-        }
-        var repairedParsed = tryParseJson(repairPartialJson(normalized));
-        if (repairedParsed !== undefined) {
-            return repairedParsed;
-        }
-        return fallbackInput;
-    };
     var defaultGuardrailFallbackResponse = 'Sorry, we are not able to generate a response at the moment.';
     _computedKey$1 = /** @internal */ '~addToolResultForMessage';
     var _computedKey1$1 = _computedKey$1;
@@ -13578,7 +13615,7 @@
                                         toolRawInputByCallId[chunk.toolCallId] = nextRawInput;
                                         var toolName = (_chunk_toolName = chunk.toolName) !== null && _chunk_toolName !== void 0 ? _chunk_toolName : existingPart === null || existingPart === void 0 ? void 0 : (_existingPart_type = existingPart.type) === null || _existingPart_type === void 0 ? void 0 : _existingPart_type.replace('tool-', '');
                                         var shouldRepair = toolName ? (_ref2 = (_this_shouldRepairToolInput = (_this1 = _this).shouldRepairToolInput) === null || _this_shouldRepairToolInput === void 0 ? void 0 : _this_shouldRepairToolInput.call(_this1, toolName)) !== null && _ref2 !== void 0 ? _ref2 : true : true;
-                                        var parsedInput = shouldRepair ? parseToolInputDelta(nextRawInput, existingPart === null || existingPart === void 0 ? void 0 : existingPart.input) : existingPart === null || existingPart === void 0 ? void 0 : existingPart.input;
+                                        var parsedInput = shouldRepair ? parsePartialJson(nextRawInput, existingPart === null || existingPart === void 0 ? void 0 : existingPart.input) : existingPart === null || existingPart === void 0 ? void 0 : existingPart.input;
                                         var nextToolPart = _object_spread_props(_object_spread({}, existingPart !== null && existingPart !== void 0 ? existingPart : {
                                             type: "tool-".concat(chunk.toolName),
                                             toolCallId: chunk.toolCallId
@@ -13681,7 +13718,7 @@
                                         var previousRawOutput = (_ref3 = (_ref4 = existingPart2 === null || existingPart2 === void 0 ? void 0 : existingPart2.rawOutput) !== null && _ref4 !== void 0 ? _ref4 : toolRawOutputByCallId[toolCallId]) !== null && _ref3 !== void 0 ? _ref3 : '';
                                         var nextRawOutput = "".concat(previousRawOutput).concat(delta);
                                         toolRawOutputByCallId[toolCallId] = nextRawOutput;
-                                        var parsedOutput = parseToolInputDelta(nextRawOutput, existingPart2 === null || existingPart2 === void 0 ? void 0 : existingPart2.output);
+                                        var parsedOutput = parsePartialJson(nextRawOutput, existingPart2 === null || existingPart2 === void 0 ? void 0 : existingPart2.output);
                                         var nextToolPart1 = _object_spread_props(_object_spread({}, existingPart2 !== null && existingPart2 !== void 0 ? existingPart2 : {
                                             type: "tool-".concat(toolName1),
                                             toolCallId: toolCallId,
@@ -13971,9 +14008,25 @@
 
     var _computedKey, _computedKey1, _computedKey2, _computedKey3, _computedKey4, _computedKey5;
     var CACHE_KEY = 'instantsearch-chat-initial-messages';
+    // Message history is a browser concern, and a server render constructs a Chat
+    // too. Reading storage there throws during rendering; the write below only
+    // throws into its own `catch`, so gating it just stops a pointless attempt.
     function getDefaultInitialMessages(id) {
-        var initialMessages = sessionStorage.getItem(CACHE_KEY + (id ? "-".concat(id) : ''));
-        return initialMessages ? JSON.parse(initialMessages) : [];
+        return safelyRunOnBrowser(function() {
+            try {
+                // `sessionStorage` is not available in every environment with a
+                // `window` (e.g. React Native), and some browsers throw on access
+                // when storage is disabled.
+                var initialMessages = sessionStorage.getItem(CACHE_KEY + (id ? "-".concat(id) : ''));
+                return initialMessages ? JSON.parse(initialMessages) : [];
+            } catch (e) {
+                return [];
+            }
+        }, {
+            fallback: function fallback() {
+                return [];
+            }
+        });
     }
     _computedKey = '~registerMessagesCallback', _computedKey1 = '~registerStatusCallback', _computedKey2 = '~registerErrorCallback';
     var _computedKey6 = _computedKey, _computedKey7 = _computedKey1, _computedKey8 = _computedKey2;
@@ -14052,11 +14105,13 @@
             }
             var saveMessagesInLocalStorage = function saveMessagesInLocalStorage() {
                 if (_this.status === 'ready') {
-                    try {
-                        sessionStorage.setItem(CACHE_KEY + (id ? "-".concat(id) : ''), JSON.stringify(_this.messages));
-                    } catch (e) {
-                    // Do nothing if sessionStorage is not available or full
-                    }
+                    safelyRunOnBrowser(function() {
+                        try {
+                            sessionStorage.setItem(CACHE_KEY + (id ? "-".concat(id) : ''), JSON.stringify(_this.messages));
+                        } catch (e) {
+                        // Do nothing if sessionStorage is not available or full
+                        }
+                    });
                 }
             };
             this['~registerMessagesCallback'](saveMessagesInLocalStorage);
@@ -14132,7 +14187,7 @@
     // it is non-empty and the chat is not already processing a message.
     // Returns true when a message was submitted, so callers can clear their input.
     function openChat(chatRenderState) {
-        var _ref = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {}, message = _ref.message, referer = _ref.referer;
+        var _ref = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {}, message = _ref.message, referer = _ref.referer, turnContext = _ref.turnContext;
         var _ref1;
         var _chatRenderState_setOpen;
         if (!chatRenderState) {
@@ -14148,9 +14203,13 @@
         if (isChatBusy(chatRenderState) || !chatRenderState.sendMessage) {
             return false;
         }
-        chatRenderState.sendMessage({
+        chatRenderState.sendMessage(_object_spread({
             text: trimmed
-        }, referer ? {
+        }, turnContext ? {
+            metadata: {
+                turnContext: turnContext
+            }
+        } : {}), referer ? {
             headers: {
                 'x-algolia-referer': referer
             }
@@ -14359,7 +14418,7 @@
         return DefaultChatTransport;
     }(HttpChatTransport);
 
-    var withUsage$o = createDocumentationMessageGenerator({
+    var withUsage$q = createDocumentationMessageGenerator({
         name: 'chat',
         connector: true
     });
@@ -14380,26 +14439,36 @@
             attributesToClear: attributesToClear
         }));
         if (params.facetFilters) {
-            var attributes = flat(params.facetFilters).map(function(filter) {
-                var _filter_split = _sliced_to_array(filter.split(':'), 2), attribute = _filter_split[0], value = _filter_split[1];
-                return {
-                    attribute: attribute,
-                    value: value
-                };
-            });
-            attributes.forEach(function(param) {
+            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;
-                if (!helper.state.isConjunctiveFacet(attribute) && !helper.state.isHierarchicalFacet(attribute) && !helper.state.isDisjunctiveFacet(attribute)) {
-                    var s = helper.state.addDisjunctiveFacet(attribute);
-                    helper.setState(s);
-                    helper.toggleFacetRefinement(attribute, value);
-                } else {
-                    var _helper_state_hierarchicalFacets_find;
-                    var attr = ((_helper_state_hierarchicalFacets_find = helper.state.hierarchicalFacets.find(function(facet) {
-                        return facet.name === attribute;
-                    })) === null || _helper_state_hierarchicalFacets_find === void 0 ? void 0 : _helper_state_hierarchicalFacets_find.name) || attribute;
-                    helper.toggleFacetRefinement(attr, 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.query) {
@@ -14410,7 +14479,7 @@
     }
     var connectChat = function connectChat(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$o());
+        checkRendering(renderFn, withUsage$q());
         return function(widgetParams) {
             var _ref = widgetParams || {}, _ref_resume = _ref.resume, resume = _ref_resume === void 0 ? false : _ref_resume, _ref_tools = _ref.tools, tools = _ref_tools === void 0 ? {} : _ref_tools, _ref_type = _ref.type, type = _ref_type === void 0 ? 'chat' : _ref_type, 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",
@@ -14488,6 +14557,11 @@
                 hasValidatedEntryPoints = true;
             };
             var makeChatInstance = function makeChatInstance(instantSearchInstance) {
+                // A caller supplied `chat` already owns its transport, so it bypasses the
+                // connector's transport construction and validation below.
+                if ('chat' in options) {
+                    return options.chat;
+                }
                 var transport;
                 var client = instantSearchInstance.client;
                 var _getAppIdAndApiKey = _sliced_to_array(getAppIdAndApiKey(client), 2), appId = _getAppIdAndApiKey[0], apiKey = _getAppIdAndApiKey[1];
@@ -14537,7 +14611,7 @@
                 if ('agentId' in options && options.agentId) {
                     var _options_requestOptions, _options_requestOptions1;
                     if (!appId || !apiKey) {
-                        throw new Error(withUsage$o('Could not extract Algolia credentials from the search client.'));
+                        throw new Error(withUsage$q('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;
@@ -14554,7 +14628,7 @@
                     var baseApi = createApi();
                     transport = new DefaultChatTransport({
                         api: baseApi,
-                        headers: _object_spread_props(_object_spread({}, _instanceof((_options_requestOptions = options.requestOptions) === null || _options_requestOptions === void 0 ? void 0 : _options_requestOptions.headers, Headers) ? Object.fromEntries(options.requestOptions.headers.entries()) : (_options_requestOptions1 = options.requestOptions) === null || _options_requestOptions1 === void 0 ? void 0 : _options_requestOptions1.headers), {
+                        headers: _object_spread_props(_object_spread({}, typeof Headers !== 'undefined' && _instanceof((_options_requestOptions = options.requestOptions) === null || _options_requestOptions === void 0 ? void 0 : _options_requestOptions.headers, Headers) ? Object.fromEntries(options.requestOptions.headers.entries()) : (_options_requestOptions1 = options.requestOptions) === null || _options_requestOptions1 === void 0 ? void 0 : _options_requestOptions1.headers), {
                             // Preserve the required Algolia identity headers and chat agent
                             // marker, even when requestOptions.headers contains the same keys.
                             'x-algolia-application-id': appId,
@@ -14576,10 +14650,7 @@
                     });
                 }
                 if (!transport) {
-                    throw new Error(withUsage$o('You need to provide either an `agentId` or a `transport`.'));
-                }
-                if ('chat' in options) {
-                    return options.chat;
+                    throw new Error(withUsage$q('You need to provide either an `agentId` or a `transport`.'));
                 }
                 return new Chat(_object_spread_props(_object_spread({}, options), {
                     sendAutomaticallyWhen: sendAutomaticallyWhen,
@@ -14659,7 +14730,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$o('Could not extract Algolia credentials from the search client.'));
+                            throw new Error(withUsage$q('Could not extract Algolia credentials from the search client.'));
                         }
                         feedbackAbortController = new AbortController();
                         _sendChatMessageFeedback = function _sendChatMessageFeedback(messageId, vote) {
@@ -14680,21 +14751,32 @@
                     }
                     var hasExistingMessages = _chatInstance.messages.length > 0;
                     // Set initialMessages before registering callbacks to avoid
-                    // triggering re-renders during init
-                    if ((initialMessages === null || initialMessages === void 0 ? void 0 : initialMessages.length) && !resume && !hasExistingMessages) {
-                        _chatInstance.messages = initialMessages;
-                    }
-                    _chatInstance['~registerErrorCallback'](render);
-                    _chatInstance['~registerMessagesCallback'](render);
-                    _chatInstance['~registerStatusCallback'](render);
-                    if (resume) {
-                        _chatInstance.resumeStream();
-                    }
-                    if (initialUserMessage && !resume && !hasExistingMessages) {
-                        _chatInstance.sendMessage({
-                            text: initialUserMessage
-                        });
-                    }
+                    // triggering re-renders during init. A server render owns no
+                    // conversation, so it leaves the instance empty.
+                    safelyRunOnBrowser(function() {
+                        if ((initialMessages === null || initialMessages === void 0 ? void 0 : initialMessages.length) && !resume && !hasExistingMessages) {
+                            _chatInstance.messages = initialMessages;
+                        }
+                    });
+                    safelyRunOnBrowser(function() {
+                        _chatInstance['~registerErrorCallback'](render);
+                        _chatInstance['~registerMessagesCallback'](render);
+                        _chatInstance['~registerStatusCallback'](render);
+                    });
+                    // Resuming and sending reach the network, which a server render must
+                    // not: the HTML pass repeats what `getServerState` already rendered, so
+                    // each send happens at least twice, and each failure resolves into chat
+                    // state well after the render that started it has finished.
+                    safelyRunOnBrowser(function() {
+                        if (resume) {
+                            _chatInstance.resumeStream();
+                        }
+                        if (initialUserMessage && !resume && !hasExistingMessages) {
+                            _chatInstance.sendMessage({
+                                text: initialUserMessage
+                            });
+                        }
+                    });
                     renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(initOptions)), {
                         instantSearchInstance: instantSearchInstance
                     }), true);
@@ -14726,6 +14808,10 @@
                     function applyFilters(params) {
                         return updateStateFromSearchToolInput(params, helper);
                     }
+                    var insightsEventContext = {
+                        agentId: agentId,
+                        instantSearchStatus: instantSearchInstance.status
+                    };
                     var toolsWithAddToolResult = {};
                     Object.entries(tools).forEach(function(param) {
                         var _param = _sliced_to_array(param, 2), key = _param[0], tool = _param[1];
@@ -14733,7 +14819,8 @@
                             addToolResult: _chatInstance.addToolResult,
                             '~addToolResultForMessage': _chatInstance['~addToolResultForMessage'],
                             applyFilters: applyFilters,
-                            sendEvent: sendEvent
+                            sendEvent: sendEvent,
+                            insightsEventContext: insightsEventContext
                         });
                         toolsWithAddToolResult[key] = toolWithAddToolResult;
                     });
@@ -14802,8 +14889,625 @@
         };
     };
 
+    var subscribe = function subscribe() {
+        return function() {};
+    };
+    var getClientSnapshot = function getClientSnapshot() {
+        return true;
+    };
+    var getServerSnapshot = function getServerSnapshot() {
+        return false;
+    };
+    function useNativeIsHydrated() {
+        return React__namespace.useSyncExternalStore(subscribe, getClientSnapshot, getServerSnapshot);
+    }
+    // React 16 and 17 have no `useSyncExternalStore`, so the flip waits for an
+    // effect and the render itself cannot tell hydration from a plain mount. These
+    // contexts provide that signal for the supported `getServerState` and
+    // `InstantSearchSSRProvider` flow: the server context covers state collection,
+    // and the SSR context covers HTML rendering and hydration.
+    //
+    // This can cost an extra render: a mount inside a provider that carries server
+    // state is withheld once even when there is no server markup to reproduce. A
+    // mount outside both contexts is never withheld.
+    //
+    // The shim's React 16 and 17 fallback ignores the server snapshot, so using it
+    // here would not change this limitation.
+    function useLegacyIsHydrated() {
+        var serverContext = useInstantSearchServerContext();
+        var ssrContext = useInstantSearchSSRContext();
+        var isServerRendered = serverContext !== null || ssrContext !== null;
+        var _React_useState = _sliced_to_array(React__namespace.useState(!isServerRendered), 2), isHydrated = _React_useState[0], setIsHydrated = _React_useState[1];
+        React__namespace.useEffect(function() {
+            setIsHydrated(true);
+        }, []);
+        return isHydrated;
+    }
+    /**
+     * Whether this render can use browser state, or has to reproduce the markup a
+     * server produced without it.
+     *
+     * @internal
+     */ var useIsHydrated = typeof React__namespace.useSyncExternalStore === 'function' ? useNativeIsHydrated : useLegacyIsHydrated;
+
     function useChat(props, additionalWidgetProperties) {
-        return useConnector(connectChat, props, additionalWidgetProperties);
+        var isHydrated = useIsHydrated();
+        var chatState = useConnector(connectChat, props, additionalWidgetProperties);
+        if (isHydrated) {
+            return chatState;
+        }
+        // Server rendering only promises the closed Chat shell, so a render that has
+        // to reproduce that markup shows no conversation either. `status` is pinned
+        // with `messages` because it diverges two ways: a server render suppresses
+        // `resumeStream()`, which the browser runs synchronously while initialising,
+        // and a caller-owned chat can already be streaming. `error` is pinned because
+        // a caller-owned chat can already have failed, which a connector-built one
+        // cannot, since its failures arrive in a microtask. `suggestions` is pinned
+        // because the connector derives them from those messages. Only an `id` given
+        // as a connector option passes through, because that value is the same on
+        // both sides. Anything else is withheld: the default is random per Chat, and
+        // an `id` carried by a caller-owned instance is no safer, since the server and
+        // the browser each construct their own.
+        return _object_spread_props(_object_spread({}, chatState), {
+            error: undefined,
+            id: 'id' in props && props.id || '',
+            messages: [],
+            status: 'ready',
+            suggestions: undefined
+        });
+    }
+
+    function buildEndpoint(param) {
+        var appId = param.appId, agentId = param.agentId;
+        return "https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/tasks");
+    }
+    function resolveEndpoint(params) {
+        if (params.transport) {
+            return {
+                endpoint: params.transport.api,
+                headers: params.transport.headers || {},
+                prepareSendMessagesRequest: params.transport.prepareSendMessagesRequest
+            };
+        }
+        if (!params.appId || !params.apiKey || !params.agentId) {
+            throw new Error('[tasks] Either `transport` or `{ appId, apiKey, agentId }` is required.');
+        }
+        var headers = {
+            'x-algolia-application-id': params.appId,
+            'x-algolia-api-key': params.apiKey
+        };
+        if (params.algoliaAgent) {
+            headers['x-algolia-agent'] = "".concat(params.algoliaAgent, "; tasks");
+        }
+        return {
+            endpoint: buildEndpoint({
+                appId: params.appId,
+                agentId: params.agentId
+            }),
+            headers: headers
+        };
+    }
+
+    function buildTaskPayload(param) {
+        var task = param.task, input = param.input, prepareRequest = param.prepareRequest;
+        var payload = {
+            task: task,
+            input: input
+        };
+        return prepareRequest ? prepareRequest(payload).body : payload;
+    }
+    function withStreamParam(url) {
+        return url.includes('?') ? "".concat(url, "&stream=true") : "".concat(url, "?stream=true");
+    }
+    function resolveStreamedOutput(data, previous) {
+        return typeof data === 'string' ? parsePartialJson(data, previous) : data;
+    }
+    function consumeTaskStream(body, onData) {
+        return new Promise(function(resolve, reject) {
+            var chunkStream = parseJsonEventStream(body);
+            var latest;
+            processStream(chunkStream, function(chunk) {
+                if (!chunk) {
+                    return;
+                }
+                // A terminal `error` event aborts the task: reject rather than let the
+                // stream close and resolve the last partial snapshot as a success.
+                // Throwing here lets `processStream` release the reader and stop
+                // consuming; the rejection propagates to the caller's `.catch`.
+                if (chunk.type === 'error') {
+                    throw new Error(chunk.errorText || 'Task stream error');
+                }
+                if (chunk.type !== 'data-task-output') {
+                    return;
+                }
+                latest = resolveStreamedOutput(chunk.data, latest);
+                if (onData) {
+                    onData(latest);
+                }
+            }, function() {
+                return resolve(latest);
+            }, reject);
+        });
+    }
+    function fetchTask(param) {
+        var endpoint = param.endpoint, headers = param.headers, payload = param.payload, onData = param.onData, _param_stream = param.stream, stream = _param_stream === void 0 ? true : _param_stream;
+        return fetch(stream ? withStreamParam(endpoint) : endpoint, {
+            method: 'POST',
+            headers: _object_spread_props(_object_spread({}, headers), {
+                'Content-Type': 'application/json'
+            }),
+            body: JSON.stringify(payload)
+        }).then(function(response) {
+            var _response_headers_get, _response_headers;
+            if (!response.ok) {
+                throw new Error("HTTP error ".concat(response.status));
+            }
+            var contentType = ((_response_headers = response.headers) === null || _response_headers === void 0 ? void 0 : (_response_headers_get = _response_headers.get) === null || _response_headers_get === void 0 ? void 0 : _response_headers_get.call(_response_headers, 'content-type')) || '';
+            if (stream && response.body && contentType.includes('text/event-stream')) {
+                return consumeTaskStream(response.body, onData);
+            }
+            return response.json();
+        });
+    }
+    function unwrap(envelope) {
+        return envelope === null || envelope === void 0 ? void 0 : envelope.output;
+    }
+    function createTaskRunner(param) {
+        var endpoint = param.endpoint, headers = param.headers, task = param.task, _param_stream = param.stream, stream = _param_stream === void 0 ? true : _param_stream, prepareRequest = param.prepareRequest;
+        return {
+            submit: function submit(variables) {
+                var onData = (arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {}).onData;
+                var payload = buildTaskPayload({
+                    task: task,
+                    input: variables,
+                    prepareRequest: prepareRequest
+                });
+                return fetchTask({
+                    endpoint: endpoint,
+                    headers: headers,
+                    payload: payload,
+                    stream: stream,
+                    onData: onData ? function(partial) {
+                        return onData(unwrap(partial));
+                    } : undefined
+                }).then(unwrap);
+            }
+        };
+    }
+
+    var withUsage$p = 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());
+        return function(widgetParams) {
+            var agentId = widgetParams.agentId, transport = widgetParams.transport, task = widgetParams.task, _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.'));
+            }
+            if (!task) {
+                throw new Error(withUsage$p('The `task` option is required.'));
+            }
+            var runner;
+            var output;
+            var isLoading = false;
+            var error;
+            var disposed = false;
+            var triggerRender = noop;
+            var requestId = 0;
+            var submit = function submit(variables) {
+                if (disposed) return Promise.resolve(undefined);
+                var currentRequestId = requestId += 1;
+                var isStale = function isStale() {
+                    return disposed || currentRequestId !== requestId;
+                };
+                // Clear the previous output so consumers can show a loading state
+                // rather than stale data while the new request is in flight.
+                output = undefined;
+                error = undefined;
+                isLoading = true;
+                triggerRender();
+                return Promise.resolve().then(function() {
+                    return runner.submit(variables, {
+                        onData: stream ? function(partial) {
+                            if (isStale()) return;
+                            output = partial;
+                            triggerRender();
+                        } : undefined
+                    });
+                }).then(function(next) {
+                    var result = next;
+                    if (!isStale()) {
+                        output = result;
+                    }
+                    return result;
+                }).catch(function(err) {
+                    if (!isStale()) {
+                        output = undefined;
+                        error = _instanceof(err, Error) ? err : new Error(String(err));
+                    }
+                    return undefined;
+                }).finally(function() {
+                    if (isStale()) return;
+                    isLoading = false;
+                    triggerRender();
+                });
+            };
+            var invalidate = function invalidate() {
+                if (disposed) return;
+                // Bump the request id so any in-flight request's callbacks see
+                // `isStale()` and are ignored. The fetch itself is left to complete.
+                requestId += 1;
+                isLoading = false;
+                triggerRender();
+            };
+            var getWidgetRenderState = function getWidgetRenderState() {
+                return {
+                    output: output,
+                    isLoading: isLoading,
+                    error: error,
+                    submit: submit,
+                    invalidate: invalidate,
+                    widgetParams: widgetParams
+                };
+            };
+            return {
+                $$type: 'ais.tasks',
+                init: function init(initOptions) {
+                    var instantSearchInstance = initOptions.instantSearchInstance;
+                    if (transport) {
+                        var resolved = resolveEndpoint({
+                            transport: transport
+                        });
+                        runner = createTaskRunner({
+                            endpoint: resolved.endpoint,
+                            headers: resolved.headers,
+                            task: task,
+                            stream: stream,
+                            prepareRequest: resolved.prepareSendMessagesRequest
+                        });
+                    } else {
+                        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.'));
+                        }
+                        var resolved1 = resolveEndpoint({
+                            appId: appId,
+                            apiKey: apiKey,
+                            agentId: agentId,
+                            algoliaAgent: getAlgoliaAgent(instantSearchInstance.client)
+                        });
+                        runner = createTaskRunner({
+                            endpoint: resolved1.endpoint,
+                            headers: resolved1.headers,
+                            task: task,
+                            stream: stream
+                        });
+                    }
+                    triggerRender = function triggerRender() {
+                        renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState()), {
+                            instantSearchInstance: instantSearchInstance
+                        }), false);
+                    };
+                    renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState()), {
+                        instantSearchInstance: instantSearchInstance
+                    }), true);
+                },
+                render: function render(renderOptions) {
+                    renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState()), {
+                        instantSearchInstance: renderOptions.instantSearchInstance
+                    }), false);
+                },
+                dispose: function dispose() {
+                    disposed = true;
+                    unmountFn();
+                }
+            };
+        };
+    };
+
+    var withUsage$o = createDocumentationMessageGenerator({
+        name: 'prompt-suggestions',
+        connector: true
+    });
+    var RENDER_STATE_KEY = 'promptSuggestions';
+    var CHAT_RENDER_STATE_KEY = 'chat';
+    var DEBOUNCE_MS = 300;
+    function parseSuggestions(data) {
+        var suggestions = data === null || data === void 0 ? void 0 : data.suggestions;
+        if (!Array.isArray(suggestions)) {
+            return [];
+        }
+        return suggestions.filter(function(s) {
+            return typeof s === 'string';
+        });
+    }
+    function buildSuggestionMessage(suggestion) {
+        return "The user clicked this on-page suggestion. Use the current page context first, then search only if needed.\n\nSuggestion: ".concat(suggestion);
+    }
+    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$o());
+        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.'));
+            }
+            if (!configurationId) {
+                throw new Error(withUsage$o('The `configurationId` option is required.'));
+            }
+            var tasksState;
+            var suggestions = [];
+            var isLoading = false;
+            var debounceTimer;
+            var lastStateSignature = null;
+            var latestRenderOptions = null;
+            // Set in `dispose()`. A debounced or in-flight `fetch()` can resolve after
+            // the widget is unmounted; this guard stops those late callbacks from
+            // calling `renderFn` into a torn-down container.
+            var disposed = false;
+            // True between a state-signature change and the debounced refetch that
+            // follows it. While pending, the search state has already moved on, so a
+            // still-in-flight request from the previous state must not paint its
+            // suggestions, its inner render is ignored until the new `submit` starts.
+            var refetchPending = false;
+            var getStateSignature = function getStateSignature(results) {
+                var _buildFilters;
+                if (results.queryID) {
+                    return results.queryID;
+                }
+                var query = results.query || '';
+                var filters = JSON.stringify((_buildFilters = buildFilters(results)) !== null && _buildFilters !== void 0 ? _buildFilters : []);
+                var hitIds = (results.hits || []).map(function(hit) {
+                    return hit.objectID;
+                }).join(',');
+                return "".concat(query, "|").concat(filters, "|").concat(hitIds);
+            };
+            var getChatRenderState = function getChatRenderState(renderOptions) {
+                var _instantSearchInstance_renderState;
+                var instantSearchInstance = renderOptions.instantSearchInstance, parent = renderOptions.parent;
+                var indexId = parent ? parent.getIndexId() : '';
+                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];
+            };
+            var sendToChat = function sendToChat(renderOptions) {
+                return function(prompt) {
+                    var _ref, _ref1;
+                    var chatRenderState = getChatRenderState(renderOptions);
+                    if (!chatRenderState || !chatRenderState.sendMessage) {
+                        return false;
+                    }
+                    var results = (_ref = (_ref1 = latestRenderOptions === null || latestRenderOptions === void 0 ? void 0 : latestRenderOptions.results) !== null && _ref1 !== void 0 ? _ref1 : 'results' in renderOptions ? renderOptions.results : null) !== null && _ref !== void 0 ? _ref : null;
+                    return openChat(chatRenderState, {
+                        message: buildSuggestionMessage(prompt),
+                        referer: 'prompt-suggestions-widget',
+                        turnContext: buildTurnContext(results)
+                    });
+                };
+            };
+            var resolvePageContext = function resolvePageContext(results) {
+                var resolvedContext = typeof context === 'function' ? context() : context;
+                // Explicit context replaces auto-extraction; otherwise derive it from
+                // the current search state. The task's server-owned instructions decide
+                // how to interpret the shape — the client doesn't label it.
+                if (resolvedContext) {
+                    return _object_spread({}, resolvedContext);
+                }
+                if (!results) {
+                    return undefined;
+                }
+                var filters = buildFilters(results);
+                return _object_spread_props(_object_spread({
+                    query: results.query || ''
+                }, filters ? {
+                    filters: filters
+                } : {}), {
+                    hitsSample: transformHits(results.hits)
+                });
+            };
+            var buildInput = function buildInput(results) {
+                var _resolvePageContext;
+                return (_resolvePageContext = resolvePageContext(results)) !== null && _resolvePageContext !== void 0 ? _resolvePageContext : {};
+            };
+            // The same page context, flattened for the chat handoff: `turnContext` is
+            // a flat `Record<string, string>` per the Agent Studio contract, so
+            // non-string values (e.g. `hitsSample`) are serialized.
+            var buildTurnContext = function buildTurnContext(results) {
+                var pageContext = resolvePageContext(results);
+                if (!pageContext) {
+                    return undefined;
+                }
+                var entries = Object.entries(pageContext).map(function(param) {
+                    var _param = _sliced_to_array(param, 2), key = _param[0], value = _param[1];
+                    return [
+                        key,
+                        typeof value === 'string' ? value : JSON.stringify(value)
+                    ];
+                }).filter(function(param) {
+                    var _param = _sliced_to_array(param, 2), value = _param[1];
+                    return value.trim() !== '';
+                });
+                return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+            };
+            var renderOutward = function renderOutward(renderOptions) {
+                if (disposed) return;
+                renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState(renderOptions)), {
+                    instantSearchInstance: renderOptions.instantSearchInstance
+                }), false);
+            };
+            var fetchAndRender = function fetchAndRender(results, renderOptions) {
+                var _results_hits;
+                if (disposed || !tasksState) return;
+                refetchPending = false;
+                var hasContext = context !== undefined;
+                if (!hasContext && !(results === null || results === void 0 ? void 0 : (_results_hits = results.hits) === null || _results_hits === void 0 ? void 0 : _results_hits.length)) {
+                    tasksState.invalidate();
+                    suggestions = [];
+                    isLoading = false;
+                    renderOutward(renderOptions);
+                    return;
+                }
+                tasksState.submit(buildInput(results));
+            };
+            var refresh = function refresh() {
+                if (isLoading) return;
+                var results = latestRenderOptions === null || latestRenderOptions === void 0 ? void 0 : latestRenderOptions.results;
+                if (!results || !latestRenderOptions) return;
+                clearTimeout(debounceTimer);
+                lastStateSignature = getStateSignature(results);
+                fetchAndRender(results, latestRenderOptions);
+            };
+            var getWidgetRenderState = function getWidgetRenderState(renderOptions) {
+                var results = 'results' in renderOptions ? renderOptions.results : undefined;
+                var transformed = transformItems(suggestions, {
+                    query: (results === null || results === void 0 ? void 0 : results.query) || '',
+                    results: results || null
+                });
+                var chatRenderState = getChatRenderState(renderOptions);
+                var isChatBusy$1 = chatRenderState ? !chatRenderState.sendMessage || isChatBusy(chatRenderState) : false;
+                var send = sendToChat(renderOptions);
+                return {
+                    suggestions: transformed,
+                    isLoading: isLoading,
+                    onSuggestionClick: send,
+                    sendToChat: send,
+                    refresh: refresh,
+                    isChatBusy: isChatBusy$1,
+                    widgetParams: widgetParams
+                };
+            };
+            // Mirrors each inner render (submit start → skeleton, stream partials,
+            // resolve/error) into this widget's state and re-renders on the client.
+            var handleInnerRender = function handleInnerRender(renderState) {
+                tasksState = renderState;
+                if (refetchPending) return;
+                if (renderState.error) {
+                    // A failed task (including a mid-stream `error` event) must not leave
+                    // any streamed partial visible. There's no error UI for now, so fall
+                    // back to a blank suggestions state.
+                    suggestions = [];
+                } else if (renderState.isLoading || renderState.output !== undefined) {
+                    // Only adopt the inner output once a request is loading or has
+                    // produced one, so the initial no-op render doesn't clobber pills.
+                    suggestions = parseSuggestions(renderState.output);
+                }
+                isLoading = renderState.isLoading;
+                if (!latestRenderOptions) return;
+                renderOutward(latestRenderOptions);
+            };
+            var tasksWidget = connectTasks(handleInnerRender, noop)(_object_spread_props(_object_spread({}, transport ? {
+                transport: transport
+            } : {
+                agentId: agentId
+            }), {
+                task: configurationId,
+                stream: true
+            }));
+            return {
+                $$type: 'ais.promptSuggestions',
+                init: function init(initOptions) {
+                    var instantSearchInstance = initOptions.instantSearchInstance;
+                    tasksWidget.init(initOptions);
+                    renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState(initOptions)), {
+                        instantSearchInstance: instantSearchInstance
+                    }), true);
+                },
+                render: function render(renderOptions) {
+                    var results = renderOptions.results, instantSearchInstance = renderOptions.instantSearchInstance;
+                    latestRenderOptions = renderOptions;
+                    if (!results) {
+                        renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState(renderOptions)), {
+                            instantSearchInstance: instantSearchInstance
+                        }), false);
+                        return;
+                    }
+                    var stateSignature = getStateSignature(results);
+                    if (stateSignature !== lastStateSignature) {
+                        lastStateSignature = stateSignature;
+                        refetchPending = true;
+                        clearTimeout(debounceTimer);
+                        debounceTimer = setTimeout(function() {
+                            if (latestRenderOptions === null || latestRenderOptions === void 0 ? void 0 : latestRenderOptions.results) {
+                                fetchAndRender(latestRenderOptions.results, latestRenderOptions);
+                            }
+                        }, DEBOUNCE_MS);
+                    }
+                    renderFn(_object_spread_props(_object_spread({}, getWidgetRenderState(renderOptions)), {
+                        instantSearchInstance: instantSearchInstance
+                    }), false);
+                },
+                dispose: function dispose(disposeOptions) {
+                    disposed = true;
+                    clearTimeout(debounceTimer);
+                    tasksWidget.dispose(disposeOptions);
+                    unmountFn();
+                },
+                getRenderState: function getRenderState(renderState, renderOptions) {
+                    return _object_spread_props(_object_spread({}, renderState), _define_property({}, RENDER_STATE_KEY, this.getWidgetRenderState(renderOptions)));
+                },
+                getWidgetRenderState: function getWidgetRenderState1(renderOptions) {
+                    return getWidgetRenderState(renderOptions);
+                }
+            };
+        };
+    };
+
+    function usePromptSuggestions(props, additionalWidgetProperties) {
+        return useConnector(connectPromptSuggestions, props, additionalWidgetProperties);
     }
 
     var withUsage$n = createDocumentationMessageGenerator({
@@ -19048,6 +19752,7 @@
     exports.useNumericMenu = useNumericMenu;
     exports.usePagination = usePagination;
     exports.usePoweredBy = usePoweredBy;
+    exports.usePromptSuggestions = usePromptSuggestions;
     exports.useQueryRules = useQueryRules;
     exports.useRSCContext = useRSCContext;
     exports.useRange = useRange;