react-instantsearch-core 7.40.0 → 7.42.0

package/dist/umd/ReactInstantSearchCore.js

@@ -1,4 +1,4 @@
-/*! React InstantSearch Core 7.40.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.40.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'
     });
     /**
@@ -8539,12 +8571,13 @@
         instantSearchInstance._hasRecommendWidget = hasRecommendWidget;
     }
     var index = function index(widgetParams) {
-        if (widgetParams === undefined || widgetParams.indexName === undefined && !widgetParams.EXPERIMENTAL_isolated) {
-            throw new Error(withUsage$s('The `indexName` option is required.'));
+        var _widgetParams_EXPERIMENTAL_isolated;
+        if (widgetParams === undefined || widgetParams.indexName === undefined && !widgetParams.isolated && !widgetParams.EXPERIMENTAL_isolated) {
+            throw new Error(withUsage$u('The `indexName` option is required.'));
         }
         // When isolated=true, we use an empty string as the default indexName.
         // This is intentional: isolated indices do not require a real index name.
-        var _widgetParams_indexName = widgetParams.indexName, indexName = _widgetParams_indexName === void 0 ? '' : _widgetParams_indexName, _widgetParams_indexId = widgetParams.indexId, indexId = _widgetParams_indexId === void 0 ? indexName : _widgetParams_indexId, tmp = widgetParams.EXPERIMENTAL_isolated, isolated = tmp === void 0 ? false : tmp;
+        var _widgetParams_indexName = widgetParams.indexName, indexName = _widgetParams_indexName === void 0 ? '' : _widgetParams_indexName, _widgetParams_indexId = widgetParams.indexId, indexId = _widgetParams_indexId === void 0 ? indexName : _widgetParams_indexId, _widgetParams_isolated = widgetParams.isolated, isolated = _widgetParams_isolated === void 0 ? (_widgetParams_EXPERIMENTAL_isolated = widgetParams.EXPERIMENTAL_isolated) !== null && _widgetParams_EXPERIMENTAL_isolated !== void 0 ? _widgetParams_EXPERIMENTAL_isolated : false : _widgetParams_isolated;
         var localWidgets = [];
         var localUiState = {};
         var localInstantSearchInstance = null;
@@ -8633,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 : [
@@ -8643,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;
@@ -8694,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 : [
@@ -8704,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;
@@ -8832,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) {
@@ -9209,7 +9242,7 @@
         });
     }
 
-    var version = '4.107.0';
+    var version = '4.109.0';
 
     var ANONYMOUS_TOKEN_COOKIE_KEY = '_ALGOLIA';
     function getCookie(name) {
@@ -9439,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();
                             }
                         }
@@ -9528,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;
                             }
@@ -9643,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,
@@ -11067,7 +11104,7 @@
         };
     }
 
-    var withUsage$r = createDocumentationMessageGenerator({
+    var withUsage$t = createDocumentationMessageGenerator({
         name: 'instantsearch'
     });
     function defaultCreateURL() {
@@ -11130,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/");
@@ -11139,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;
@@ -11288,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;
@@ -11322,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;
@@ -11336,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
@@ -11544,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`.
@@ -11581,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);
                 }
@@ -11590,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();
                 }
@@ -12116,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;
@@ -12235,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) {
@@ -12394,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: ".
@@ -12674,76 +12781,10 @@
         return undefined;
     }
 
-    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 _computedKey$1;
     var defaultGuardrailFallbackResponse = 'Sorry, we are not able to generate a response at the moment.';
+    _computedKey$1 = /** @internal */ '~addToolResultForMessage';
+    var _computedKey1$1 = _computedKey$1;
     /**
      * Abstract base class for chat implementations.
      */ var AbstractChat = /*#__PURE__*/ function() {
@@ -12763,6 +12804,12 @@
             _define_property(this, "sendAutomaticallyWhen", void 0);
             _define_property(this, "shouldRepairToolInput", void 0);
             _define_property(this, "activeResponse", null);
+            _define_property(this, "latestResponse", null);
+            _define_property(this, "responsesByToolCallId", new Map());
+            _define_property(this, "responseByMessage", new WeakMap());
+            // Once tool ownership is discarded, an identifier-only result cannot prove
+            // which response generation submitted it. Scoped submissions remain safe.
+            _define_property(this, "acceptsIdentifierOnlyToolResults", true);
             _define_property(this, "jobExecutor", new SerialJobExecutor());
             /**
        * Appends or replaces a user message to the chat list. This triggers the API call to fetch
@@ -12848,13 +12895,13 @@
                     // Find the message to regenerate from
                     var targetIndex = -1;
                     if (messageId) {
-                        targetIndex = _this1.state.messages.findIndex(function(m) {
+                        targetIndex = _this1.messages.findIndex(function(m) {
                             return m.id === messageId;
                         });
                     } else {
                         // Find the last assistant message
-                        for(var i = _this1.state.messages.length - 1; i >= 0; i--){
-                            if (_this1.state.messages[i].role === 'assistant') {
+                        for(var i = _this1.messages.length - 1; i >= 0; i--){
+                            if (_this1.messages[i].role === 'assistant') {
                                 targetIndex = i;
                                 break;
                             }
@@ -12862,7 +12909,7 @@
                     }
                     if (targetIndex >= 0) {
                         // Remove the assistant message and all messages after it
-                        _this1.state.messages = _this1.state.messages.slice(0, targetIndex);
+                        _this1.messages = _this1.messages.slice(0, targetIndex);
                     }
                     return _this1.makeRequest(_object_spread({
                         trigger: 'regenerate-message',
@@ -12877,23 +12924,10 @@
                     if (!_this.transport) {
                         return Promise.reject(new Error('Transport is required for resuming stream. Please provide a transport when initializing the chat.'));
                     }
-                    _this.setStatus({
-                        status: 'submitted'
-                    });
-                    return _this.transport.reconnectToStream(_object_spread({
-                        chatId: _this.id
-                    }, options)).then(function(stream) {
-                        if (stream) {
-                            return _this.processStreamWithCallbacks(stream);
-                        } else {
-                            _this.setStatus({
-                                status: 'ready'
-                            });
-                            return Promise.resolve();
-                        }
-                    }, function(error) {
-                        _this.handleError(error);
-                        return Promise.resolve();
+                    return _this.consume(function() {
+                        return _this.transport.reconnectToStream(_object_spread({
+                            chatId: _this.id
+                        }, options));
                     });
                 });
             });
@@ -12909,53 +12943,57 @@
             });
             /**
        * Add a tool result for a tool call.
-       */ _define_property(this, "addToolResult", function(param) {
-                var tool = param.tool, toolCallId = param.toolCallId, output = param.output;
-                return _this.jobExecutor.run(function() {
-                    // Find the message with this tool call
-                    var messageIndex = _this.state.messages.findIndex(function(m) {
-                        var _ref;
-                        var _m_parts;
-                        return (_ref = (_m_parts = m.parts) === null || _m_parts === void 0 ? void 0 : _m_parts.some(function(p) {
-                            return 'toolCallId' in p && p.toolCallId === toolCallId || 'type' in p && p.type === "tool-".concat(String(tool));
-                        })) !== null && _ref !== void 0 ? _ref : false;
-                    });
-                    if (messageIndex === -1) return Promise.resolve();
-                    var message = _this.state.messages[messageIndex];
-                    var updatedParts = message.parts.map(function(part) {
-                        if ('toolCallId' in part && part.toolCallId === toolCallId && 'state' in part) {
-                            return _object_spread_props(_object_spread({}, part), {
-                                state: 'output-available',
-                                output: output
-                            });
-                        }
-                        return part;
-                    });
-                    _this.state.replaceMessage(messageIndex, _object_spread_props(_object_spread({}, message), {
-                        parts: updatedParts
-                    }));
-                    // Check if we should auto-send based on sendAutomaticallyWhen
-                    if (_this.sendAutomaticallyWhen) {
-                        return Promise.resolve(_this.sendAutomaticallyWhen({
-                            messages: _this.state.messages
-                        })).then(function(shouldSend) {
-                            if (shouldSend) {
-                                return _this.makeRequest({
-                                    trigger: 'submit-message'
-                                });
-                            }
-                            return Promise.resolve();
+       */ _define_property(this, "addToolResult", function(options) {
+                if (!_this.acceptsIdentifierOnlyToolResults) {
+                    return Promise.resolve();
+                }
+                var owners = _this.responsesByToolCallId.get(options.toolCallId);
+                var response = (owners === null || owners === void 0 ? void 0 : owners.size) === 1 ? owners.values().next().value : undefined;
+                if (response) return _this.submitToolResult(response, options);
+                var findMatchingMessage = function findMatchingMessage() {
+                    var matchingMessages = _this.messages.filter(function(message) {
+                        var _message_parts;
+                        return (_message_parts = message.parts) === null || _message_parts === void 0 ? void 0 : _message_parts.some(function(part) {
+                            return 'toolCallId' in part && part.toolCallId === options.toolCallId;
                         });
+                    });
+                    return matchingMessages.length === 1 ? matchingMessages[0] : undefined;
+                };
+                if (!findMatchingMessage()) return Promise.resolve();
+                return _this.jobExecutor.run(function() {
+                    if (!_this.acceptsIdentifierOnlyToolResults) return Promise.resolve();
+                    var message = findMatchingMessage();
+                    if (!message || !_this.commit(options.toolCallId, options.output, message.id, undefined, message)) {
+                        return Promise.resolve();
                     }
-                    return Promise.resolve();
+                    return _this.continueResponse();
                 });
             });
+            _define_property(this, _computedKey1$1, function(message, options) {
+                var hasToolCall = function hasToolCall(candidate) {
+                    var _candidate_parts;
+                    return ((_candidate_parts = candidate.parts) === null || _candidate_parts === void 0 ? void 0 : _candidate_parts.some(function(part) {
+                        return 'toolCallId' in part && part.toolCallId === options.toolCallId;
+                    })) === true;
+                };
+                if (!hasToolCall(message)) {
+                    return Promise.resolve();
+                }
+                var response = _this.responseByMessage.get(message);
+                var currentMessage = _this.messages.includes(message) ? message : response && !response.isRetired ? _this.messages.find(function(candidate) {
+                    return candidate.id === message.id && _this.responseByMessage.get(candidate) === response && hasToolCall(candidate);
+                }) : undefined;
+                if (!currentMessage) return Promise.resolve();
+                return _this.submitToolResult(response, options, currentMessage.id, currentMessage);
+            });
             /**
        * Abort the current request immediately, keep the generated tokens if any.
        */ _define_property(this, "stop", function() {
                 if (_this.activeResponse) {
-                    _this.activeResponse.abortController.abort();
+                    var response = _this.activeResponse;
+                    response.outcome = 'aborted';
                     _this.activeResponse = null;
+                    response.abortController.abort();
                 }
                 _this.setStatus({
                     status: 'ready'
@@ -13017,6 +13055,14 @@
        * context.
        */ key: "resetConversationId",
                 value: function resetConversationId() {
+                    if (this.responsesByToolCallId.size > 0 || this.messages.some(function(message) {
+                        var _message_parts;
+                        return (_message_parts = message.parts) === null || _message_parts === void 0 ? void 0 : _message_parts.some(function(part) {
+                            return 'toolCallId' in part;
+                        });
+                    })) {
+                        this.acceptsIdentifierOnlyToolResults = false;
+                    }
                     this.conversationId = this.generateId();
                 }
             },
@@ -13026,7 +13072,93 @@
                     return this.state.messages;
                 },
                 set: function set(messages) {
+                    var _this = this;
+                    var getToolOccurrences = function getToolOccurrences(message) {
+                        return message.parts.filter(function(part) {
+                            return 'toolCallId' in part;
+                        }).map(function(part) {
+                            return {
+                                type: part.type,
+                                toolCallId: part.toolCallId,
+                                state: 'state' in part ? part.state : undefined,
+                                input: 'input' in part ? part.input : undefined,
+                                output: 'output' in part ? part.output : undefined,
+                                errorText: 'errorText' in part ? part.errorText : undefined,
+                                providerExecuted: 'providerExecuted' in part ? part.providerExecuted : undefined
+                            };
+                        });
+                    };
+                    var isEquivalentRehydration = function isEquivalentRehydration(message) {
+                        var replacements = messages.filter(function(candidate) {
+                            return candidate.id === message.id;
+                        });
+                        if (replacements.length !== 1) return false;
+                        var toolOccurrences = getToolOccurrences(message);
+                        var replacementToolOccurrences = getToolOccurrences(replacements[0]);
+                        return toolOccurrences.length > 0 || replacementToolOccurrences.length > 0 ? isEqual(toolOccurrences, replacementToolOccurrences) : isEqual(message.parts, replacements[0].parts);
+                    };
+                    var detachedResponses = new Set();
+                    this.state.messages.forEach(function(message) {
+                        if (!messages.includes(message)) {
+                            var response = _this.responseByMessage.get(message);
+                            if (response && !isEquivalentRehydration(message)) {
+                                detachedResponses.add(response);
+                            }
+                        }
+                    });
+                    var removedToolOwner = this.state.messages.some(function(message) {
+                        var _message_parts;
+                        return ((_message_parts = message.parts) === null || _message_parts === void 0 ? void 0 : _message_parts.some(function(part) {
+                            return 'toolCallId' in part;
+                        })) && !messages.includes(message) && !isEquivalentRehydration(message);
+                    });
+                    var toolCallIds = new Set();
+                    var hasDuplicateToolCallId = messages.some(function(message) {
+                        var _message_parts;
+                        return ((_message_parts = message.parts) === null || _message_parts === void 0 ? void 0 : _message_parts.some(function(part) {
+                            if (!('toolCallId' in part)) {
+                                return false;
+                            }
+                            if (toolCallIds.has(part.toolCallId)) {
+                                return true;
+                            }
+                            toolCallIds.add(part.toolCallId);
+                            return false;
+                        })) === true;
+                    });
+                    if (removedToolOwner || hasDuplicateToolCallId) {
+                        this.acceptsIdentifierOnlyToolResults = false;
+                    }
                     this.state.messages = messages;
+                    var retainedMessageIds = new Set(messages.map(function(message) {
+                        return message.id;
+                    }));
+                    var responses = new Set();
+                    this.responsesByToolCallId.forEach(function(owners) {
+                        owners.forEach(function(response) {
+                            return responses.add(response);
+                        });
+                    });
+                    if (this.activeResponse) {
+                        responses.add(this.activeResponse);
+                    }
+                    detachedResponses.forEach(function(response) {
+                        responses.add(response);
+                        _this.retireResponse(response);
+                    });
+                    responses.forEach(function(response) {
+                        var message = response.messageId ? messages.find(function(candidate) {
+                            return candidate.id === response.messageId;
+                        }) : undefined;
+                        if (message && !response.isRetired && !detachedResponses.has(response)) {
+                            _this.responseByMessage.set(message, response);
+                        }
+                    });
+                    responses.forEach(function(response) {
+                        if (detachedResponses.has(response) || response.messageId && !retainedMessageIds.has(response.messageId)) {
+                            _this.pruneDetachedResponse(response);
+                        }
+                    });
                 }
             },
             {
@@ -13036,76 +13168,363 @@
                 }
             },
             {
-                key: "makeRequest",
-                value: function makeRequest(options) {
-                    var _this = this;
-                    if (!this.transport) {
-                        return Promise.reject(new Error('Transport is required for sending messages. Please provide a transport when initializing the chat.'));
-                    }
-                    // Abort any existing request
-                    if (this.activeResponse) {
-                        this.activeResponse.abortController.abort();
+                key: "replaceMessage",
+                value: function replaceMessage(index, message, response) {
+                    var _this_messages_index;
+                    this.state.replaceMessage(index, message);
+                    var canonicalMessage = (_this_messages_index = this.messages[index]) !== null && _this_messages_index !== void 0 ? _this_messages_index : message;
+                    if (response && this.messages.includes(canonicalMessage)) {
+                        this.responseByMessage.set(canonicalMessage, response);
                     }
-                    var abortController = new AbortController();
-                    this.activeResponse = {
-                        abortController: abortController
+                    return canonicalMessage;
+                }
+            },
+            {
+                key: "commit",
+                value: function commit(toolCallId, output, messageId, response, expectedMessage) {
+                    var isTargetPart = function isTargetPart(part) {
+                        return 'toolCallId' in part && part.toolCallId === toolCallId;
                     };
-                    this.setStatus({
-                        status: 'submitted'
+                    var messageIndex = this.messages.findIndex(function(message) {
+                        return (!messageId || message.id === messageId) && (!expectedMessage || message === expectedMessage) && message.parts.some(isTargetPart);
                     });
-                    return this.transport.sendMessages({
-                        chatId: this.id,
-                        messages: this.state.messages,
-                        abortSignal: abortController.signal,
-                        trigger: options.trigger,
-                        messageId: options.messageId,
-                        headers: options.headers,
-                        body: options.body,
-                        requestMetadata: options.metadata
-                    }).then(function(stream) {
-                        _this.activeResponse.stream = stream;
-                        return _this.processStreamWithCallbacks(stream);
-                    }, function(error) {
-                        if (error.name === 'AbortError') {
-                            // Request was aborted, don't treat as error
+                    if (messageIndex === -1) return false;
+                    var message = this.messages[messageIndex];
+                    var partIndex = message.parts.findIndex(isTargetPart);
+                    var part = message.parts[partIndex];
+                    if (!('state' in part) || part.state === 'output-available' && !part.preliminary || part.state === 'output-error') {
+                        return false;
+                    }
+                    // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
+                    part.preliminary; // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
+                    part.rawOutput;
+                    var committedPart = _object_without_properties(part, [
+                        "preliminary",
+                        "rawOutput"
+                    ]);
+                    var updatedParts = _to_consumable_array(message.parts);
+                    updatedParts[partIndex] = _object_spread_props(_object_spread({}, committedPart), {
+                        state: 'output-available',
+                        output: output
+                    });
+                    var updatedMessage = _object_spread_props(_object_spread({}, message), {
+                        parts: updatedParts
+                    });
+                    this.replaceMessage(messageIndex, updatedMessage, response);
+                    return true;
+                }
+            },
+            {
+                key: "continueResponse",
+                value: function continueResponse(response) {
+                    var _this = this;
+                    if (response) {
+                        this.pruneDetachedResponse(response);
+                        if (response.isRetired || response.outcome !== 'succeeded' || response.requiredToolCallIds.size === 0 || Array.from(response.requiredToolCallIds).some(function(toolCallId) {
+                            return !response.resolvedToolCallIds.has(toolCallId);
+                        }) || !response.didNotifyFinish || response.didEvaluateContinuation) {
                             return Promise.resolve();
                         }
+                        response.didEvaluateContinuation = true;
+                    }
+                    if (!this.sendAutomaticallyWhen) return Promise.resolve();
+                    return Promise.resolve().then(function() {
+                        return _this.sendAutomaticallyWhen({
+                            messages: _this.messages
+                        });
+                    }).then(function(shouldSend) {
+                        if (response) {
+                            _this.pruneDetachedResponse(response);
+                            if (response.isRetired) return undefined;
+                        }
+                        return shouldSend ? _this.makeRequest({
+                            trigger: 'submit-message'
+                        }) : undefined;
+                    }).catch(function(error) {
+                        if (response) {
+                            _this.pruneDetachedResponse(response);
+                            if (response.isRetired) return;
+                            _this.handleError(error, {
+                                updateState: _this.latestResponse === response
+                            });
+                            return;
+                        }
                         _this.handleError(error);
-                        return Promise.resolve();
                     });
                 }
             },
             {
-                key: "processStreamWithCallbacks",
-                value: function processStreamWithCallbacks(stream) {
-                    var _this = this;
-                    this.setStatus({
+                key: "retireResponse",
+                value: function retireResponse(response) {
+                    if (response.isRetired) return;
+                    response.isRetired = true;
+                    response.didEvaluateContinuation = true;
+                    if (this.activeResponse === response) {
+                        response.outcome = 'aborted';
+                        this.activeResponse = null;
+                        response.abortController.abort();
+                        this.setStatus({
+                            status: 'ready'
+                        });
+                    }
+                }
+            },
+            {
+                key: "pruneDetachedResponse",
+                value: function pruneDetachedResponse(response) {
+                    var _this = this;
+                    if (!response.isRetired) {
+                        if (!response.messageId || this.messages.some(function(message) {
+                            return message.id === response.messageId;
+                        })) {
+                            return;
+                        }
+                        this.retireResponse(response);
+                    }
+                    // Keep a routing tombstone while a callback is running so public
+                    // addToolResult calls settle directly instead of entering the executor.
+                    if (response.pendingToolCallbacks > 0) return;
+                    this.responsesByToolCallId.forEach(function(owners, toolCallId) {
+                        owners.delete(response);
+                        if (owners.size === 0) {
+                            _this.responsesByToolCallId.delete(toolCallId);
+                        }
+                    });
+                }
+            },
+            {
+                key: "submitToolResult",
+                value: function submitToolResult(response, param) {
+                    var _this = this;
+                    var toolCallId = param.toolCallId, output = param.output, messageId = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : response === null || response === void 0 ? void 0 : response.messageId, expectedMessage = arguments.length > 3 && arguments[3] !== void 0 ? arguments[3] : messageId ? this.messages.find(function(message) {
+                        return message.id === messageId;
+                    }) : undefined;
+                    if (response === null || response === void 0 ? void 0 : response.isRetired) return Promise.resolve();
+                    var commitResult = function commitResult() {
+                        if (!_this.commit(toolCallId, output, messageId, response, expectedMessage)) {
+                            return Promise.resolve();
+                        }
+                        if (response === null || response === void 0 ? void 0 : response.requiredToolCallIds.has(toolCallId)) {
+                            response.resolvedToolCallIds.add(toolCallId);
+                        }
+                        return _this.continueResponse(response);
+                    };
+                    if (response && (this.activeResponse === response || response.outcome !== 'succeeded' || response.didEvaluateContinuation)) {
+                        return commitResult();
+                    }
+                    return this.jobExecutor.run(commitResult);
+                }
+            },
+            {
+                key: "makeRequest",
+                value: function makeRequest(options) {
+                    var _this = this;
+                    if (!this.transport) {
+                        return Promise.reject(new Error('Transport is required for sending messages. Please provide a transport when initializing the chat.'));
+                    }
+                    return this.consume(function(abortSignal) {
+                        return _this.transport.sendMessages({
+                            chatId: _this.id,
+                            messages: _this.messages,
+                            abortSignal: abortSignal,
+                            trigger: options.trigger,
+                            messageId: options.messageId,
+                            headers: options.headers,
+                            body: options.body,
+                            requestMetadata: options.metadata
+                        });
+                    });
+                }
+            },
+            {
+                key: "consume",
+                value: function consume(createStream) {
+                    var _this = this;
+                    if (this.activeResponse) {
+                        this.activeResponse.outcome = 'aborted';
+                        this.activeResponse.abortController.abort();
+                    }
+                    var response = {
+                        abortController: new AbortController(),
+                        outcome: 'active',
+                        isRetired: false,
+                        requiredToolCallIds: new Set(),
+                        resolvedToolCallIds: new Set(),
+                        returnedToolCallbacks: [],
+                        pendingToolCallbacks: 0,
+                        didNotifyFinish: false,
+                        didEvaluateContinuation: false
+                    };
+                    this.activeResponse = response;
+                    this.latestResponse = response;
+                    this.setStatus({
+                        status: 'submitted'
+                    });
+                    return createStream(response.abortController.signal).then(function(stream) {
+                        if (_this.activeResponse === response) {
+                            if (stream) return _this.processStream(stream, response);
+                            response.outcome = 'succeeded';
+                            _this.activeResponse = null;
+                            _this.setStatus({
+                                status: 'ready'
+                            });
+                        }
+                        return undefined;
+                    }, function(error) {
+                        if (_this.activeResponse !== response) return;
+                        _this.activeResponse = null;
+                        if (error.name === 'AbortError') {
+                            response.outcome = 'aborted';
+                            _this.setStatus({
+                                status: 'ready'
+                            });
+                        } else {
+                            response.outcome = 'failed';
+                            _this.handleError(error);
+                        }
+                    });
+                }
+            },
+            {
+                key: "processStream",
+                value: function processStream1(stream, response) {
+                    var _this = this;
+                    this.setStatus({
                         status: 'streaming'
                     });
                     var currentMessageId;
                     var currentMessage;
                     var currentMessageIndex = -1;
                     var isAbort = false;
-                    var isDisconnect = false;
                     var isError = false;
-                    // Track current text/reasoning part state
-                    var currentTextPartId;
-                    var currentReasoningPartId;
                     var toolRawInputByCallId = {};
                     var toolRawOutputByCallId = {};
-                    // Promise chain for handling tool calls that return promises
-                    var pendingToolCall = Promise.resolve();
+                    var findToolPart = function findToolPart(toolCallId) {
+                        return currentMessage.parts.findIndex(function(part) {
+                            return 'toolCallId' in part && part.toolCallId === toolCallId;
+                        });
+                    };
+                    var setPart = function setPart(index, part) {
+                        var parts = _to_consumable_array(currentMessage.parts);
+                        parts[index < 0 ? parts.length : index] = part;
+                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
+                            parts: parts
+                        });
+                        currentMessage = _this.replaceMessage(currentMessageIndex, currentMessage, response);
+                    };
+                    var mergeCallProviderMetadata = function mergeCallProviderMetadata(toolCallId, metadata) {
+                        var toolIndex = findToolPart(toolCallId);
+                        if (toolIndex < 0) return;
+                        var existingPart = currentMessage.parts[toolIndex];
+                        setPart(toolIndex, _object_spread_props(_object_spread({}, existingPart), {
+                            callProviderMetadata: metadata !== null && metadata !== void 0 ? metadata : existingPart.callProviderMetadata
+                        }));
+                    };
+                    var getCanonicalMessage = function getCanonicalMessage() {
+                        var _this_messages_find;
+                        return response.messageId ? (_this_messages_find = _this.messages.find(function(message) {
+                            return message.id === response.messageId;
+                        })) !== null && _this_messages_find !== void 0 ? _this_messages_find : currentMessage : currentMessage;
+                    };
+                    var notifyFinish = function notifyFinish(param) {
+                        var isAbort = param.isAbort, isDisconnect = param.isDisconnect, isError = param.isError, message = param.message, _param_allowRetired = param.allowRetired, allowRetired = _param_allowRetired === void 0 ? false : _param_allowRetired;
+                        _this.pruneDetachedResponse(response);
+                        if (response.isRetired && !allowRetired || response.didNotifyFinish) {
+                            return;
+                        }
+                        response.didNotifyFinish = true;
+                        var canonicalMessage = message !== null && message !== void 0 ? message : getCanonicalMessage();
+                        if (_this.onFinish && canonicalMessage) {
+                            _this.onFinish({
+                                message: canonicalMessage,
+                                messages: _this.messages,
+                                isAbort: isAbort,
+                                isDisconnect: isDisconnect,
+                                isError: isError
+                            });
+                        }
+                    };
+                    var failToolCall = function failToolCall(reason) {
+                        if (response.outcome !== 'active') return;
+                        var message = getCanonicalMessage();
+                        var wasRetired = response.isRetired;
+                        var error = _instanceof(reason, Error) ? reason : new Error(String(reason));
+                        response.outcome = 'failed';
+                        response.abortController.abort();
+                        if (_this.activeResponse === response) {
+                            _this.activeResponse = null;
+                            _this.handleError(error);
+                        }
+                        notifyFinish({
+                            isAbort: false,
+                            isDisconnect: false,
+                            isError: true,
+                            message: message,
+                            allowRetired: !wasRetired
+                        });
+                    };
+                    var acceptServerToolResult = function acceptServerToolResult(toolCallId) {
+                        if (response.requiredToolCallIds.has(toolCallId)) {
+                            response.resolvedToolCallIds.add(toolCallId);
+                        }
+                    };
                     return new Promise(function(resolve) {
+                        var finish = function finish(error) {
+                            if (response.outcome === 'failed') {
+                                resolve();
+                                return;
+                            }
+                            isAbort || (isAbort = response.outcome === 'aborted' || !!error && error.name === 'AbortError');
+                            response.outcome = isAbort ? 'aborted' : error ? 'failed' : 'succeeded';
+                            if (_this.activeResponse === response) {
+                                _this.activeResponse = null;
+                                if (error && !isAbort) {
+                                    _this.handleError(error);
+                                } else {
+                                    _this.setStatus({
+                                        status: 'ready'
+                                    });
+                                }
+                            }
+                            notifyFinish({
+                                isAbort: isAbort,
+                                isDisconnect: !!error && !isAbort,
+                                isError: isError
+                            });
+                            resolve(isAbort || error ? undefined : _this.continueResponse(response));
+                        };
                         processStream(stream, function(chunk) {
+                            if (_this.activeResponse !== response || response.isRetired) return;
+                            if (currentMessageId) {
+                                var canonicalMessageIndex = _this.messages.findIndex(function(message) {
+                                    return message.id === currentMessageId;
+                                });
+                                if (canonicalMessageIndex === -1) {
+                                    _this.pruneDetachedResponse(response);
+                                    return;
+                                }
+                                currentMessageIndex = canonicalMessageIndex;
+                                currentMessage = _this.messages[canonicalMessageIndex];
+                                _this.responseByMessage.set(currentMessage, response);
+                            }
                             switch(chunk.type){
                                 case 'start':
                                     {
                                         currentMessageId = chunk.messageId || _this.generateId();
+                                        response.messageId = currentMessageId;
                                         // Check if we're continuing an existing message or creating a new one
                                         var lastMessage = _this.lastMessage;
                                         if (lastMessage && lastMessage.role === 'assistant' && lastMessage.id === currentMessageId) {
-                                            currentMessage = lastMessage;
-                                            currentMessageIndex = _this.state.messages.length - 1;
+                                            if (lastMessage.parts.some(function(part) {
+                                                return 'toolCallId' in part;
+                                            })) {
+                                                _this.acceptsIdentifierOnlyToolResults = false;
+                                            }
+                                            currentMessage = _object_spread_props(_object_spread({}, lastMessage), {
+                                                parts: _to_consumable_array(lastMessage.parts)
+                                            });
+                                            currentMessageIndex = _this.messages.length - 1;
+                                            currentMessage = _this.replaceMessage(currentMessageIndex, currentMessage, response);
                                         } else {
                                             currentMessage = {
                                                 id: currentMessageId,
@@ -13114,123 +13533,60 @@
                                                 metadata: chunk.messageMetadata
                                             };
                                             _this.state.pushMessage(currentMessage);
-                                            currentMessageIndex = _this.state.messages.length - 1;
+                                            currentMessageIndex = _this.messages.length - 1;
+                                            _this.responseByMessage.set(currentMessage, response);
                                         }
                                         break;
                                     }
                                 case 'text-start':
+                                case 'reasoning-start':
                                     {
                                         if (!currentMessage) break;
-                                        currentTextPartId = chunk.id;
-                                        var textPart = {
-                                            type: 'text',
+                                        var type = chunk.type === 'text-start' ? 'text' : 'reasoning';
+                                        setPart(-1, {
+                                            type: type,
                                             text: '',
                                             state: 'streaming',
                                             providerMetadata: chunk.providerMetadata
-                                        };
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: _to_consumable_array(currentMessage.parts).concat([
-                                                textPart
-                                            ])
                                         });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
                                         break;
                                     }
                                 case 'text-delta':
+                                case 'reasoning-delta':
                                     {
-                                        if (!currentMessage || !currentTextPartId) break;
-                                        var partIndex = currentMessage.parts.findIndex(function(p) {
-                                            return p.type === 'text' && p.state === 'streaming';
+                                        var type1 = chunk.type === 'text-delta' ? 'text' : 'reasoning';
+                                        if (!currentMessage) break;
+                                        var partIndex = currentMessage.parts.findIndex(function(part) {
+                                            return part.type === type1 && part.state === 'streaming';
                                         });
                                         if (partIndex === -1) break;
-                                        var updatedParts = _to_consumable_array(currentMessage.parts);
-                                        var textPart1 = updatedParts[partIndex];
-                                        updatedParts[partIndex] = _object_spread_props(_object_spread({}, textPart1), {
-                                            text: textPart1.text + chunk.delta
-                                        });
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: updatedParts
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        var part = currentMessage.parts[partIndex];
+                                        setPart(partIndex, _object_spread_props(_object_spread({}, part), {
+                                            text: part.text + chunk.delta
+                                        }));
                                         break;
                                     }
                                 case 'text-end':
-                                    {
-                                        if (!currentMessage) break;
-                                        var partIndex1 = currentMessage.parts.findIndex(function(p) {
-                                            return p.type === 'text' && p.state === 'streaming';
-                                        });
-                                        if (partIndex1 === -1) break;
-                                        var updatedParts1 = _to_consumable_array(currentMessage.parts);
-                                        var textPart2 = updatedParts1[partIndex1];
-                                        updatedParts1[partIndex1] = _object_spread_props(_object_spread({}, textPart2), {
-                                            state: 'done'
-                                        });
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: updatedParts1
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
-                                        currentTextPartId = undefined;
-                                        break;
-                                    }
-                                case 'reasoning-start':
-                                    {
-                                        if (!currentMessage) break;
-                                        currentReasoningPartId = chunk.id;
-                                        var reasoningPart = {
-                                            type: 'reasoning',
-                                            text: '',
-                                            state: 'streaming',
-                                            providerMetadata: chunk.providerMetadata
-                                        };
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: _to_consumable_array(currentMessage.parts).concat([
-                                                reasoningPart
-                                            ])
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
-                                        break;
-                                    }
-                                case 'reasoning-delta':
-                                    {
-                                        if (!currentMessage || !currentReasoningPartId) break;
-                                        var partIndex2 = currentMessage.parts.findIndex(function(p) {
-                                            return p.type === 'reasoning' && p.state === 'streaming';
-                                        });
-                                        if (partIndex2 === -1) break;
-                                        var updatedParts2 = _to_consumable_array(currentMessage.parts);
-                                        var reasoningPart1 = updatedParts2[partIndex2];
-                                        updatedParts2[partIndex2] = _object_spread_props(_object_spread({}, reasoningPart1), {
-                                            text: reasoningPart1.text + chunk.delta
-                                        });
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: updatedParts2
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
-                                        break;
-                                    }
                                 case 'reasoning-end':
                                     {
                                         if (!currentMessage) break;
-                                        var partIndex3 = currentMessage.parts.findIndex(function(p) {
-                                            return p.type === 'reasoning' && p.state === 'streaming';
+                                        var type2 = chunk.type === 'text-end' ? 'text' : 'reasoning';
+                                        var partIndex1 = currentMessage.parts.findIndex(function(part) {
+                                            return part.type === type2 && part.state === 'streaming';
                                         });
-                                        if (partIndex3 === -1) break;
-                                        var updatedParts3 = _to_consumable_array(currentMessage.parts);
-                                        var reasoningPart2 = updatedParts3[partIndex3];
-                                        updatedParts3[partIndex3] = _object_spread_props(_object_spread({}, reasoningPart2), {
+                                        if (partIndex1 === -1) break;
+                                        setPart(partIndex1, _object_spread_props(_object_spread({}, currentMessage.parts[partIndex1]), {
                                             state: 'done'
-                                        });
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: updatedParts3
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
-                                        currentReasoningPartId = undefined;
+                                        }));
                                         break;
                                     }
                                 case 'tool-input-start':
                                     {
                                         if (!currentMessage) break;
+                                        var completedPart = currentMessage.parts.find(function(part) {
+                                            return 'toolCallId' in part && part.toolCallId === chunk.toolCallId && 'state' in part && (part.state === 'output-available' || part.state === 'output-error');
+                                        });
+                                        if (completedPart) break;
                                         var initialRawInput = typeof chunk.input === 'string' ? chunk.input : chunk.input !== undefined ? JSON.stringify(chunk.input) : '';
                                         toolRawInputByCallId[chunk.toolCallId] = initialRawInput;
                                         var toolPart = {
@@ -13241,12 +13597,7 @@
                                             rawInput: initialRawInput || undefined,
                                             providerExecuted: chunk.providerExecuted
                                         };
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: _to_consumable_array(currentMessage.parts).concat([
-                                                toolPart
-                                            ])
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        setPart(-1, toolPart);
                                         break;
                                     }
                                 case 'tool-input-delta':
@@ -13254,16 +13605,17 @@
                                         var _ref, _ref1, _chunk_toolName, _ref2;
                                         var _existingPart_type, _this_shouldRepairToolInput, _this1;
                                         if (!currentMessage) break;
-                                        var toolIndex = currentMessage.parts.findIndex(function(p) {
-                                            return 'toolCallId' in p && p.toolCallId === chunk.toolCallId;
-                                        });
+                                        var toolIndex = findToolPart(chunk.toolCallId);
                                         var existingPart = toolIndex >= 0 ? currentMessage.parts[toolIndex] : null;
+                                        if ((existingPart === null || existingPart === void 0 ? void 0 : existingPart.state) === 'output-available' || (existingPart === null || existingPart === void 0 ? void 0 : existingPart.state) === 'output-error') {
+                                            break;
+                                        }
                                         var previousRawInput = (_ref = (_ref1 = existingPart === null || existingPart === void 0 ? void 0 : existingPart.rawInput) !== null && _ref1 !== void 0 ? _ref1 : toolRawInputByCallId[chunk.toolCallId]) !== null && _ref !== void 0 ? _ref : '';
                                         var nextRawInput = "".concat(previousRawInput).concat(chunk.inputTextDelta);
                                         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
@@ -13272,30 +13624,20 @@
                                             input: parsedInput,
                                             rawInput: nextRawInput
                                         });
-                                        if (toolIndex >= 0) {
-                                            var updatedParts4 = _to_consumable_array(currentMessage.parts);
-                                            updatedParts4[toolIndex] = nextToolPart;
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: updatedParts4
-                                            });
-                                        } else {
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: _to_consumable_array(currentMessage.parts).concat([
-                                                    nextToolPart
-                                                ])
-                                            });
-                                        }
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        setPart(toolIndex, nextToolPart);
                                         break;
                                     }
                                 case 'tool-input-available':
                                     {
                                         if (!currentMessage) break;
+                                        if (response.requiredToolCallIds.has(chunk.toolCallId)) break;
                                         delete toolRawInputByCallId[chunk.toolCallId];
                                         // Find existing tool part or create new one
-                                        var existingIndex = currentMessage.parts.findIndex(function(p) {
-                                            return 'toolCallId' in p && p.toolCallId === chunk.toolCallId;
-                                        });
+                                        var existingIndex = findToolPart(chunk.toolCallId);
+                                        var existingPart1 = existingIndex >= 0 ? currentMessage.parts[existingIndex] : null;
+                                        if ((existingPart1 === null || existingPart1 === void 0 ? void 0 : existingPart1.state) === 'output-available' || (existingPart1 === null || existingPart1 === void 0 ? void 0 : existingPart1.state) === 'output-error') {
+                                            break;
+                                        }
                                         var toolPart1 = {
                                             type: "tool-".concat(chunk.toolName),
                                             toolCallId: chunk.toolCallId,
@@ -13304,35 +13646,63 @@
                                             callProviderMetadata: chunk.callProviderMetadata,
                                             providerExecuted: chunk.providerExecuted
                                         };
-                                        if (existingIndex >= 0) {
-                                            var updatedParts5 = _to_consumable_array(currentMessage.parts);
-                                            updatedParts5[existingIndex] = toolPart1;
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: updatedParts5
-                                            });
-                                        } else {
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: _to_consumable_array(currentMessage.parts).concat([
-                                                    toolPart1
-                                                ])
-                                            });
+                                        setPart(existingIndex, toolPart1);
+                                        if (_this.messages.some(function(message) {
+                                            var _message_parts;
+                                            return message !== currentMessage && ((_message_parts = message.parts) === null || _message_parts === void 0 ? void 0 : _message_parts.some(function(part) {
+                                                return 'toolCallId' in part && part.toolCallId === chunk.toolCallId;
+                                            }));
+                                        })) {
+                                            _this.acceptsIdentifierOnlyToolResults = false;
                                         }
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
                                         // Trigger onToolCall callback only for client-executed tools
                                         // (server-executed tools have providerExecuted: true and don't need client handling)
                                         if (_this.onToolCall && !chunk.providerExecuted) {
-                                            var result = _this.onToolCall({
-                                                toolCall: {
-                                                    toolName: chunk.toolName,
-                                                    toolCallId: chunk.toolCallId,
-                                                    input: chunk.input,
-                                                    dynamic: 'dynamic' in chunk ? chunk.dynamic : undefined
-                                                }
+                                            var _this_responsesByToolCallId_get;
+                                            var owners = (_this_responsesByToolCallId_get = _this.responsesByToolCallId.get(chunk.toolCallId)) !== null && _this_responsesByToolCallId_get !== void 0 ? _this_responsesByToolCallId_get : new Set();
+                                            var existingOwners = Array.from(owners).filter(function(owner) {
+                                                return owner !== response;
                                             });
-                                            if (result && typeof result.then === 'function') {
-                                                pendingToolCall = pendingToolCall.then(function() {
-                                                    return result;
+                                            if (existingOwners.length > 0) {
+                                                _this.acceptsIdentifierOnlyToolResults = false;
+                                                var conflictingOwner = existingOwners.find(function(owner) {
+                                                    return !owner.isRetired && (owner.outcome === 'active' || owner.outcome === 'succeeded' && (!owner.resolvedToolCallIds.has(chunk.toolCallId) || owner.pendingToolCallbacks > 0));
                                                 });
+                                                if (conflictingOwner) {
+                                                    // Neither response may continue once ownership is ambiguous.
+                                                    conflictingOwner.didEvaluateContinuation = true;
+                                                    failToolCall(new Error('Tool call "'.concat(chunk.toolCallId, '" is already owned by another response.')));
+                                                    break;
+                                                }
+                                            }
+                                            response.requiredToolCallIds.add(chunk.toolCallId);
+                                            owners.add(response);
+                                            _this.responsesByToolCallId.set(chunk.toolCallId, owners);
+                                            response.pendingToolCallbacks++;
+                                            try {
+                                                var result = _this.onToolCall({
+                                                    toolCall: {
+                                                        toolName: chunk.toolName,
+                                                        toolCallId: chunk.toolCallId,
+                                                        input: chunk.input,
+                                                        dynamic: 'dynamic' in chunk ? chunk.dynamic : undefined
+                                                    }
+                                                }, function(options) {
+                                                    return response.isRetired ? Promise.resolve() : _this.submitToolResult(response, options);
+                                                });
+                                                if (result) {
+                                                    response.returnedToolCallbacks.push(Promise.resolve(result).catch(failToolCall).then(function() {
+                                                        response.pendingToolCallbacks--;
+                                                        _this.pruneDetachedResponse(response);
+                                                    }));
+                                                } else {
+                                                    response.pendingToolCallbacks--;
+                                                    _this.pruneDetachedResponse(response);
+                                                }
+                                            } catch (error) {
+                                                response.pendingToolCallbacks--;
+                                                failToolCall(error);
+                                                _this.pruneDetachedResponse(response);
                                             }
                                         }
                                         break;
@@ -13342,15 +13712,14 @@
                                         var _ref3, _ref4;
                                         if (!currentMessage) break;
                                         var _chunk_data = chunk.data, toolCallId = _chunk_data.toolCallId, toolName1 = _chunk_data.toolName, delta = _chunk_data.delta;
-                                        var toolIndex1 = currentMessage.parts.findIndex(function(p) {
-                                            return 'toolCallId' in p && p.toolCallId === toolCallId;
-                                        });
-                                        var existingPart1 = toolIndex1 >= 0 ? currentMessage.parts[toolIndex1] : null;
-                                        var previousRawOutput = (_ref3 = (_ref4 = existingPart1 === null || existingPart1 === void 0 ? void 0 : existingPart1.rawOutput) !== null && _ref4 !== void 0 ? _ref4 : toolRawOutputByCallId[toolCallId]) !== null && _ref3 !== void 0 ? _ref3 : '';
+                                        if (response.resolvedToolCallIds.has(toolCallId)) break;
+                                        var toolIndex1 = findToolPart(toolCallId);
+                                        var existingPart2 = toolIndex1 >= 0 ? currentMessage.parts[toolIndex1] : null;
+                                        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, existingPart1 === null || existingPart1 === void 0 ? void 0 : existingPart1.output);
-                                        var nextToolPart1 = _object_spread_props(_object_spread({}, existingPart1 !== null && existingPart1 !== void 0 ? existingPart1 : {
+                                        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,
                                             input: undefined
@@ -13360,47 +13729,34 @@
                                             rawOutput: nextRawOutput,
                                             preliminary: true
                                         });
-                                        if (toolIndex1 >= 0) {
-                                            var updatedParts6 = _to_consumable_array(currentMessage.parts);
-                                            updatedParts6[toolIndex1] = nextToolPart1;
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: updatedParts6
-                                            });
-                                        } else {
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: _to_consumable_array(currentMessage.parts).concat([
-                                                    nextToolPart1
-                                                ])
-                                            });
-                                        }
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        setPart(toolIndex1, nextToolPart1);
                                         break;
                                     }
                                 case 'tool-output-available':
                                     {
                                         if (!currentMessage) break;
-                                        var toolIndex2 = currentMessage.parts.findIndex(function(p) {
-                                            return 'toolCallId' in p && p.toolCallId === chunk.toolCallId;
-                                        });
+                                        var toolIndex2 = findToolPart(chunk.toolCallId);
                                         if (toolIndex2 >= 0) {
                                             delete toolRawInputByCallId[chunk.toolCallId];
                                             delete toolRawOutputByCallId[chunk.toolCallId];
-                                            var updatedParts7 = _to_consumable_array(currentMessage.parts);
-                                            var existingPart2 = updatedParts7[toolIndex2];
+                                            var existingPart3 = currentMessage.parts[toolIndex2];
+                                            if (response.resolvedToolCallIds.has(chunk.toolCallId)) {
+                                                mergeCallProviderMetadata(chunk.toolCallId, chunk.callProviderMetadata);
+                                                break;
+                                            }
                                             // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
-                                            var _ignored = existingPart2.rawOutput, rest = _object_without_properties(existingPart2, [
+                                            var _ignored = existingPart3.rawOutput, rest = _object_without_properties(existingPart3, [
                                                 "rawOutput"
                                             ]);
-                                            updatedParts7[toolIndex2] = _object_spread_props(_object_spread({}, rest), {
+                                            setPart(toolIndex2, _object_spread_props(_object_spread({}, rest), {
                                                 state: 'output-available',
                                                 output: chunk.output,
                                                 callProviderMetadata: chunk.callProviderMetadata,
                                                 preliminary: chunk.preliminary
-                                            });
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: updatedParts7
-                                            });
-                                            _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                            }));
+                                            if (!chunk.preliminary) {
+                                                acceptServerToolResult(chunk.toolCallId);
+                                            }
                                         }
                                         break;
                                     }
@@ -13408,13 +13764,15 @@
                                     {
                                         var _chunk_input, _chunk_providerExecuted, _chunk_providerMetadata;
                                         if (!currentMessage) break;
+                                        if (response.resolvedToolCallIds.has(chunk.toolCallId)) {
+                                            mergeCallProviderMetadata(chunk.toolCallId, chunk.providerMetadata);
+                                            break;
+                                        }
                                         delete toolRawInputByCallId[chunk.toolCallId];
                                         delete toolRawOutputByCallId[chunk.toolCallId];
-                                        var toolIndex3 = currentMessage.parts.findIndex(function(p) {
-                                            return 'toolCallId' in p && p.toolCallId === chunk.toolCallId;
-                                        });
-                                        var existingPart3 = toolIndex3 >= 0 ? currentMessage.parts[toolIndex3] : null;
-                                        var _ref5 = existingPart3 !== null && existingPart3 !== void 0 ? existingPart3 : {}, _ignoredOutput = _ref5.output, _ignoredRawOutput = _ref5.rawOutput, _ignoredPreliminary = _ref5.preliminary, carryOver = _object_without_properties(_ref5, [
+                                        var toolIndex3 = findToolPart(chunk.toolCallId);
+                                        var existingPart4 = toolIndex3 >= 0 ? currentMessage.parts[toolIndex3] : null;
+                                        var _ref5 = existingPart4 !== null && existingPart4 !== void 0 ? existingPart4 : {}, _ignoredOutput = _ref5.output, _ignoredRawOutput = _ref5.rawOutput, _ignoredPreliminary = _ref5.preliminary, carryOver = _object_without_properties(_ref5, [
                                             "output",
                                             "rawOutput",
                                             "preliminary"
@@ -13429,49 +13787,35 @@
                                             providerExecuted: (_chunk_providerExecuted = chunk.providerExecuted) !== null && _chunk_providerExecuted !== void 0 ? _chunk_providerExecuted : carryOver.providerExecuted,
                                             callProviderMetadata: (_chunk_providerMetadata = chunk.providerMetadata) !== null && _chunk_providerMetadata !== void 0 ? _chunk_providerMetadata : carryOver.callProviderMetadata
                                         });
-                                        if (toolIndex3 >= 0) {
-                                            var updatedParts8 = _to_consumable_array(currentMessage.parts);
-                                            updatedParts8[toolIndex3] = nextToolPart2;
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: updatedParts8
-                                            });
-                                        } else {
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: _to_consumable_array(currentMessage.parts).concat([
-                                                    nextToolPart2
-                                                ])
-                                            });
-                                        }
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        setPart(toolIndex3, nextToolPart2);
+                                        acceptServerToolResult(chunk.toolCallId);
                                         break;
                                     }
                                 case 'tool-output-error':
                                     {
                                         var _chunk_providerExecuted1, _chunk_providerMetadata1;
                                         if (!currentMessage) break;
-                                        var toolIndex4 = currentMessage.parts.findIndex(function(p) {
-                                            return 'toolCallId' in p && p.toolCallId === chunk.toolCallId;
-                                        });
+                                        if (response.resolvedToolCallIds.has(chunk.toolCallId)) {
+                                            mergeCallProviderMetadata(chunk.toolCallId, chunk.providerMetadata);
+                                            break;
+                                        }
+                                        var toolIndex4 = findToolPart(chunk.toolCallId);
                                         if (toolIndex4 < 0) break;
                                         delete toolRawInputByCallId[chunk.toolCallId];
                                         delete toolRawOutputByCallId[chunk.toolCallId];
-                                        var updatedParts9 = _to_consumable_array(currentMessage.parts);
-                                        var existingPart4 = updatedParts9[toolIndex4];
-                                        var _ignoredRawOutput1 = existingPart4.rawOutput, _ignoredPreliminary1 = existingPart4.preliminary, _ignoredOutput1 = existingPart4.output, rest1 = _object_without_properties(existingPart4, [
+                                        var existingPart5 = currentMessage.parts[toolIndex4];
+                                        var _ignoredRawOutput1 = existingPart5.rawOutput, _ignoredPreliminary1 = existingPart5.preliminary, _ignoredOutput1 = existingPart5.output, rest1 = _object_without_properties(existingPart5, [
                                             "rawOutput",
                                             "preliminary",
                                             "output"
                                         ]);
-                                        updatedParts9[toolIndex4] = _object_spread_props(_object_spread({}, rest1), {
+                                        setPart(toolIndex4, _object_spread_props(_object_spread({}, rest1), {
                                             state: 'output-error',
                                             errorText: chunk.errorText,
                                             providerExecuted: (_chunk_providerExecuted1 = chunk.providerExecuted) !== null && _chunk_providerExecuted1 !== void 0 ? _chunk_providerExecuted1 : rest1.providerExecuted,
                                             callProviderMetadata: (_chunk_providerMetadata1 = chunk.providerMetadata) !== null && _chunk_providerMetadata1 !== void 0 ? _chunk_providerMetadata1 : rest1.callProviderMetadata
-                                        });
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: updatedParts9
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        }));
+                                        acceptServerToolResult(chunk.toolCallId);
                                         break;
                                     }
                                 case 'source-url':
@@ -13483,12 +13827,7 @@
                                             url: chunk.url,
                                             title: chunk.title
                                         };
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: _to_consumable_array(currentMessage.parts).concat([
-                                                sourcePart
-                                            ])
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        setPart(-1, sourcePart);
                                         break;
                                     }
                                 case 'source-document':
@@ -13502,12 +13841,7 @@
                                             filename: chunk.filename,
                                             providerMetadata: chunk.providerMetadata
                                         };
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: _to_consumable_array(currentMessage.parts).concat([
-                                                docPart
-                                            ])
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        setPart(-1, docPart);
                                         break;
                                     }
                                 case 'file':
@@ -13518,26 +13852,15 @@
                                             url: chunk.url,
                                             mediaType: chunk.mediaType
                                         };
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: _to_consumable_array(currentMessage.parts).concat([
-                                                filePart
-                                            ])
-                                        });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        setPart(-1, filePart);
                                         break;
                                     }
                                 case 'start-step':
                                     {
                                         if (!currentMessage) break;
-                                        var stepPart = {
+                                        setPart(-1, {
                                             type: 'step-start'
-                                        };
-                                        currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                            parts: _to_consumable_array(currentMessage.parts).concat([
-                                                stepPart
-                                            ])
                                         });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
                                         break;
                                     }
                                 case 'message-metadata':
@@ -13546,7 +13869,7 @@
                                         currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
                                             metadata: chunk.messageMetadata
                                         });
-                                        _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                        currentMessage = _this.replaceMessage(currentMessageIndex, currentMessage, response);
                                         break;
                                     }
                                 case 'error':
@@ -13566,7 +13889,7 @@
                                             currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
                                                 metadata: chunk.messageMetadata
                                             });
-                                            _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                            currentMessage = _this.replaceMessage(currentMessageIndex, currentMessage, response);
                                         }
                                         break;
                                     }
@@ -13592,14 +13915,13 @@
                                             ]
                                         };
                                         if (currentMessageIndex >= 0) {
-                                            _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                            currentMessage = _this.replaceMessage(currentMessageIndex, currentMessage, response);
                                         } else {
                                             _this.state.pushMessage(currentMessage);
-                                            currentMessageIndex = _this.state.messages.length - 1;
+                                            currentMessageIndex = _this.messages.length - 1;
+                                            _this.responseByMessage.set(currentMessage, response);
                                         }
                                         currentMessageId = currentMessage.id;
-                                        currentTextPartId = undefined;
-                                        currentReasoningPartId = undefined;
                                         break;
                                     }
                                 default:
@@ -13612,12 +13934,7 @@
                                                 id: chunk.id,
                                                 data: chunk.data
                                             };
-                                            currentMessage = _object_spread_props(_object_spread({}, currentMessage), {
-                                                parts: _to_consumable_array(currentMessage.parts).concat([
-                                                    dataPart
-                                                ])
-                                            });
-                                            _this.state.replaceMessage(currentMessageIndex, currentMessage);
+                                            setPart(-1, dataPart);
                                             // Trigger onData callback
                                             if (_this.onData) {
                                                 _this.onData(dataPart);
@@ -13626,49 +13943,11 @@
                                     }
                             }
                         }, function() {
-                            // Wait for any pending tool calls to complete
-                            pendingToolCall.then(function() {
-                                // Stream finished successfully
-                                _this.setStatus({
-                                    status: 'ready'
-                                });
-                                _this.activeResponse = null;
-                                // Trigger onFinish callback
-                                if (_this.onFinish && currentMessage) {
-                                    _this.onFinish({
-                                        message: currentMessage,
-                                        messages: _this.state.messages,
-                                        isAbort: isAbort,
-                                        isDisconnect: isDisconnect,
-                                        isError: isError
-                                    });
-                                }
-                                // Note: sendAutomaticallyWhen is only checked in addToolResult,
-                                // not here. For server-executed tools, the server continues the
-                                // conversation. For client-executed tools, addToolResult handles it.
-                                resolve();
+                            return Promise.all(response.returnedToolCallbacks).then(function() {
+                                return finish();
                             });
                         }, function(error) {
-                            if (error.name === 'AbortError') {
-                                isAbort = true;
-                                _this.setStatus({
-                                    status: 'ready'
-                                });
-                            } else {
-                                isDisconnect = true;
-                                _this.handleError(error);
-                            }
-                            // Still call onFinish even on error/abort
-                            if (_this.onFinish && currentMessage) {
-                                _this.onFinish({
-                                    message: currentMessage,
-                                    messages: _this.state.messages,
-                                    isAbort: isAbort,
-                                    isDisconnect: isDisconnect,
-                                    isError: isError
-                                });
-                            }
-                            resolve();
+                            return finish(error);
                         });
                     });
                 }
@@ -13676,10 +13955,13 @@
             {
                 key: "handleError",
                 value: function handleError(error) {
-                    this.setStatus({
-                        status: 'error',
-                        error: error
-                    });
+                    var _ref = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {}, _ref_updateState = _ref.updateState, updateState = _ref_updateState === void 0 ? true : _ref_updateState;
+                    if (updateState) {
+                        this.setStatus({
+                            status: 'error',
+                            error: error
+                        });
+                    }
                     if (this.onError) {
                         this.onError(error);
                     }
@@ -13726,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;
@@ -13807,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);
@@ -13887,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) {
@@ -13903,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
             }
@@ -14114,7 +14418,7 @@
         return DefaultChatTransport;
     }(HttpChatTransport);
 
-    var withUsage$o = createDocumentationMessageGenerator({
+    var withUsage$q = createDocumentationMessageGenerator({
         name: 'chat',
         connector: true
     });
@@ -14135,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) {
@@ -14165,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",
@@ -14243,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];
@@ -14292,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;
@@ -14309,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,
@@ -14331,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,
@@ -14347,7 +14663,7 @@
                         if (!tool) return true;
                         return Boolean(tool.streamInput);
                     },
-                    onToolCall: function onToolCall(param) {
+                    onToolCall: function onToolCall(param, submitToolResult) {
                         var toolCall = param.toolCall;
                         var tool = tools[toolCall.toolName];
                         // Compatibility shim with Algolia MCP Server search tool
@@ -14355,7 +14671,7 @@
                             tool = tools[SearchIndexToolType];
                         }
                         if (!tool) {
-                            return _chatInstance.addToolResult({
+                            return submitToolResult({
                                 output: 'No tool implemented for "'.concat(toolCall.toolName, '".'),
                                 tool: toolCall.toolName,
                                 toolCallId: toolCall.toolCallId
@@ -14364,7 +14680,7 @@
                         if (tool.onToolCall) {
                             var addToolResult = function addToolResult(param) {
                                 var output = param.output;
-                                return _chatInstance.addToolResult({
+                                return submitToolResult({
                                     output: output,
                                     tool: toolCall.toolName,
                                     toolCallId: toolCall.toolCallId
@@ -14414,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) {
@@ -14435,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);
@@ -14481,13 +14808,19 @@
                     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];
                         var toolWithAddToolResult = _object_spread_props(_object_spread({}, tool), {
                             addToolResult: _chatInstance.addToolResult,
+                            '~addToolResultForMessage': _chatInstance['~addToolResultForMessage'],
                             applyFilters: applyFilters,
-                            sendEvent: sendEvent
+                            sendEvent: sendEvent,
+                            insightsEventContext: insightsEventContext
                         });
                         toolsWithAddToolResult[key] = toolWithAddToolResult;
                     });
@@ -14556,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({
@@ -18802,6 +19752,7 @@
     exports.useNumericMenu = useNumericMenu;
     exports.usePagination = usePagination;
     exports.usePoweredBy = usePoweredBy;
+    exports.usePromptSuggestions = usePromptSuggestions;
     exports.useQueryRules = useQueryRules;
     exports.useRSCContext = useRSCContext;
     exports.useRange = useRange;