react-instantsearch 7.33.1 → 7.35.0

package/dist/umd/ReactInstantSearch.js

@@ -1,4 +1,4 @@
-/*! React InstantSearch 7.33.1 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
+/*! React InstantSearch 7.35.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.33.1';
+    var version$2 = '7.35.0';
 
     function _define_property(obj, key, value) {
         if (key in obj) {
@@ -5980,7 +5980,7 @@
         }
     }
 
-    var withUsage$u = createDocumentationMessageGenerator({
+    var withUsage$v = 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$u('The `searchParameters` option expects an object.'));
+                throw new Error(withUsage$v('The `searchParameters` option expects an object.'));
             }
             var connectorState = {};
             function refine(helper) {
@@ -7620,13 +7620,13 @@
         return null;
     }
 
-    var withUsage$t = createDocumentationMessageGenerator({
+    var withUsage$u = 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$t());
+        checkRendering(renderFn, withUsage$u());
         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 ? [
                 '*'
@@ -7636,10 +7636,10 @@
             if (!(widgets && Array.isArray(widgets) && widgets.every(function(widget) {
                 return (typeof widget === "undefined" ? "undefined" : _type_of(widget)) === 'object';
             }))) {
-                throw new Error(withUsage$t('The `widgets` option expects an array of widgets.'));
+                throw new Error(withUsage$u('The `widgets` option expects an array of widgets.'));
             }
             if (!Array.isArray(facets)) {
-                throw new Error(withUsage$t("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
+                throw new Error(withUsage$u("The `facets` option only accepts an array of facets, you passed ".concat(JSON.stringify(facets))));
             }
             var localWidgets = new Map();
             return {
@@ -7741,7 +7741,7 @@
                         results: results
                     });
                     if (!Array.isArray(attributesToRender)) {
-                        throw new Error(withUsage$t('The `transformItems` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$u('The `transformItems` option expects a function that returns an Array.'));
                     }
                     return {
                         attributesToRender: attributesToRender,
@@ -8062,19 +8062,19 @@
             return toFeedSearchResults(lastResults._state, raw);
         });
     }
-    var withUsage$s = createDocumentationMessageGenerator({
+    var withUsage$t = 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$s());
+        checkRendering(renderFn, withUsage$t());
         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$s('The `isolated` option currently only supports `false`.'));
+                throw new Error(withUsage$t('The `isolated` option currently only supports `false`.'));
             }
             return {
                 $$type: 'ais.feeds',
@@ -8082,7 +8082,7 @@
                 init: function init(initOptions) {
                     var instantSearchInstance = initOptions.instantSearchInstance;
                     if (!instantSearchInstance.compositionID) {
-                        throw new Error(withUsage$s('The `feeds` widget requires a composition-based InstantSearch instance (compositionID must be set).'));
+                        throw new Error(withUsage$t('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)), {
@@ -8128,12 +8128,12 @@
                     ];
                     feedIDs = transformFeeds(feedIDs);
                     if (!Array.isArray(feedIDs)) {
-                        throw new Error(withUsage$s('The `transformFeeds` option expects a function that returns an Array.'));
+                        throw new Error(withUsage$t('The `transformFeeds` option expects a function that returns an Array.'));
                     }
                     if (!feedIDs.every(function(feedID) {
                         return typeof feedID === 'string';
                     })) {
-                        throw new Error(withUsage$s('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
+                        throw new Error(withUsage$t('The `transformFeeds` option expects a function that returns an array of feed IDs (strings).'));
                     }
                     return {
                         feedIDs: feedIDs,
@@ -8244,7 +8244,7 @@
         }));
     }
 
-    var withUsage$r = createDocumentationMessageGenerator({
+    var withUsage$s = createDocumentationMessageGenerator({
         name: 'index-widget'
     });
     /**
@@ -8338,7 +8338,7 @@
     }
     var index = function index(widgetParams) {
         if (widgetParams === undefined || widgetParams.indexName === undefined && !widgetParams.EXPERIMENTAL_isolated) {
-            throw new Error(withUsage$r('The `indexName` option is required.'));
+            throw new Error(withUsage$s('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.
@@ -8428,7 +8428,7 @@
             addWidgets: function addWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$r('The `addWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$s('The `addWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8438,7 +8438,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.init !== 'function' && typeof widget.render !== 'function';
                 })) {
-                    throw new Error(withUsage$r('The widget definition expects a `render` and/or an `init` method.'));
+                    throw new Error(withUsage$s('The widget definition expects a `render` and/or an `init` method.'));
                 }
                 flatWidgets.forEach(function(widget) {
                     widget.parent = _this;
@@ -8498,7 +8498,7 @@
             removeWidgets: function removeWidgets(widgets) {
                 var _this = this;
                 if (!Array.isArray(widgets)) {
-                    throw new Error(withUsage$r('The `removeWidgets` method expects an array of widgets.'));
+                    throw new Error(withUsage$s('The `removeWidgets` method expects an array of widgets.'));
                 }
                 var flatWidgets = widgets.reduce(function(acc, w) {
                     return acc.concat(Array.isArray(w) ? w : [
@@ -8508,7 +8508,7 @@
                 if (flatWidgets.some(function(widget) {
                     return typeof widget.dispose !== 'function';
                 })) {
-                    throw new Error(withUsage$r('The widget definition expects a `dispose` method.'));
+                    throw new Error(withUsage$s('The widget definition expects a `dispose` method.'));
                 }
                 localWidgets = localWidgets.filter(function(widget) {
                     return flatWidgets.indexOf(widget) === -1;
@@ -10821,9 +10821,9 @@
         };
     }
 
-    var version = '4.99.0';
+    var version = '4.101.0';
 
-    var withUsage$q = createDocumentationMessageGenerator({
+    var withUsage$r = createDocumentationMessageGenerator({
         name: 'instantsearch'
     });
     function defaultCreateURL() {
@@ -10879,7 +10879,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$q('The `searchClient` option is required.'));
+                throw new Error(withUsage$r('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/");
@@ -10888,7 +10888,7 @@
                 searchClient.addAlgoliaAgent("instantsearch.js (".concat(version, ")"));
             }
             if (insightsClient && typeof insightsClient !== 'function') {
-                throw new Error(withUsage$q('The `insightsClient` option should be a function.'));
+                throw new Error(withUsage$r('The `insightsClient` option should be a function.'));
             }
             _this.client = searchClient;
             _this.future = future;
@@ -11036,12 +11036,12 @@
        * @param widgets The array of widgets to add to InstantSearch.
        */ function addWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$q('The `addWidgets` method expects an array of widgets. Please use `addWidget`.'));
+                        throw new Error(withUsage$r('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$q('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
+                        throw new Error(withUsage$r('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
                     }
                     this.mainIndex.addWidgets(widgets);
                     return this;
@@ -11070,7 +11070,7 @@
        * The widgets must implement a `dispose()` method to clear their states.
        */ function removeWidgets(widgets) {
                     if (!Array.isArray(widgets)) {
-                        throw new Error(withUsage$q('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
+                        throw new Error(withUsage$r('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
                     }
                     this.mainIndex.removeWidgets(widgets);
                     return this;
@@ -11084,7 +11084,7 @@
        */ function start() {
                     var _this = this;
                     if (this.started) {
-                        throw new Error(withUsage$q('The `start` method has already been called once.'));
+                        throw new Error(withUsage$r('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
@@ -11286,7 +11286,7 @@
                     var _this = this;
                     var callOnStateChange = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$q('The `start` method needs to be called before `setUiState`.'));
+                        throw new Error(withUsage$r('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`.
@@ -11323,7 +11323,7 @@
                 value: function createURL() {
                     var nextState = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
                     if (!this.started) {
-                        throw new Error(withUsage$q('The `start` method needs to be called before `createURL`.'));
+                        throw new Error(withUsage$r('The `start` method needs to be called before `createURL`.'));
                     }
                     return this._createURL(nextState);
                 }
@@ -11332,7 +11332,7 @@
                 key: "refresh",
                 value: function refresh() {
                     if (!this.mainHelper) {
-                        throw new Error(withUsage$q('The `start` method needs to be called before `refresh`.'));
+                        throw new Error(withUsage$r('The `start` method needs to be called before `refresh`.'));
                     }
                     this.mainHelper.clearCache().search();
                 }
@@ -11839,13 +11839,13 @@
         }, children);
     }
 
-    var withUsage$p = createDocumentationMessageGenerator({
+    var withUsage$q = 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$p());
+        checkRendering(renderFn, withUsage$q());
         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;
@@ -11954,20 +11954,20 @@
         return useConnector(connectAutocomplete, props, additionalWidgetProperties);
     }
 
-    var withUsage$o = createDocumentationMessageGenerator({
+    var withUsage$p = 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$o());
+        checkRendering(renderFn, withUsage$p());
         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$o('The `attributes` option expects an array of strings.'));
+                throw new Error(withUsage$p('The `attributes` option expects an array of strings.'));
             }
             var _attributes = _sliced_to_array(attributes, 1), hierarchicalFacetName = _attributes[0];
             function getRefinedState(state, facetValue) {
@@ -12211,16 +12211,21 @@
                     onDone();
                     return;
                 }
-                var result = onChunk(value);
-                if (result && typeof result.then === 'function') {
-                    result.then(function() {
-                        return read();
-                    }, function(error) {
-                        reader.releaseLock();
-                        onError(error);
-                    });
-                } else {
-                    read();
+                try {
+                    var result = onChunk(value);
+                    if (result && typeof result.then === 'function') {
+                        result.then(function() {
+                            return read();
+                        }, function(error) {
+                            reader.releaseLock();
+                            onError(error);
+                        });
+                    } else {
+                        read();
+                    }
+                } catch (error) {
+                    reader.releaseLock();
+                    onError(error);
                 }
             }, function(error) {
                 reader.releaseLock();
@@ -12230,6 +12235,49 @@
         read();
     }
 
+    function _construct(Parent, args, Class) {
+        if (_is_native_reflect_construct()) _construct = Reflect.construct;
+        else {
+            _construct = function construct(Parent, args, Class) {
+                var a = [null];
+                a.push.apply(a, args);
+                var Constructor = Function.bind.apply(Parent, a);
+                var instance = new Constructor();
+
+                if (Class) _set_prototype_of(instance, Class.prototype);
+
+                return instance;
+            };
+        }
+
+        return _construct.apply(null, arguments);
+    }
+
+    function _is_native_function(fn) {
+        return Function.toString.call(fn).indexOf("[native code]") !== -1;
+    }
+
+    function _wrap_native_super(Class) {
+        var _cache = typeof Map === "function" ? new Map() : undefined;
+        _wrap_native_super = function(Class) {
+            if (Class === null || !_is_native_function(Class)) return Class;
+            if (typeof Class !== "function") throw new TypeError("Super expression must either be null or a function");
+            if (typeof _cache !== "undefined") {
+                if (_cache.has(Class)) return _cache.get(Class);
+                _cache.set(Class, Wrapper);
+            }
+
+            function Wrapper() {
+                return _construct(Class, arguments, _get_prototype_of(this).constructor);
+            }
+            Wrapper.prototype = Object.create(Class.prototype, { constructor: { value: Wrapper, enumerable: false, writable: true, configurable: true } });
+
+            return _set_prototype_of(Wrapper, Class);
+        };
+
+        return _wrap_native_super(Class);
+    }
+
     function generateId() {
         return Math.random().toString(36).substring(2, 9);
     }
@@ -12302,6 +12350,49 @@
         }
         return Promise.resolve(value);
     }
+    /**
+     * Error raised when the upstream stream emits a `data-guardrail-violation`
+     * chunk. The `message` carries the service-provided `fallbackResponse`, which
+     * is intentionally surfaced verbatim through the chat error UI (unlike
+     * generic cost-control / 4xx errors, where the raw API message is hidden
+     * behind a friendly default).
+     *
+     * Detection across package boundaries should rely on `error.name` rather than
+     * `instanceof` to avoid issues with mixed module copies in bundled apps.
+     */ var GuardrailViolationError = /*#__PURE__*/ function(Error1) {
+        _inherits(GuardrailViolationError, Error1);
+        function GuardrailViolationError(message) {
+            _class_call_check(this, GuardrailViolationError);
+            var _this;
+            _this = _call_super(this, GuardrailViolationError, [
+                message
+            ]);
+            _this.name = 'GuardrailViolationError';
+            return _this;
+        }
+        return GuardrailViolationError;
+    }(_wrap_native_super(Error));
+    /**
+     * Reads a non-empty `message` field off a JSON-serialized error envelope.
+     *
+     * Both transports backing `AbstractChat` (stream `error` chunks and HTTP error
+     * responses) serialize errors as `{"message": "...", ...}` — the same shape as
+     * the shared `ErrorResponse` on the API side. Returns the trimmed message if
+     * the input is such a JSON object, otherwise `undefined`.
+     */ function tryParseErrorMessage(text) {
+        try {
+            var parsed = JSON.parse(text);
+            if (parsed && (typeof parsed === "undefined" ? "undefined" : _type_of(parsed)) === 'object' && !Array.isArray(parsed) && typeof parsed.message === 'string') {
+                var message = parsed.message.trim();
+                if (message) {
+                    return message;
+                }
+            }
+        } catch (unused) {
+        // Not JSON — caller falls back to its own default.
+        }
+        return undefined;
+    }
 
     var tryParseJson = function tryParseJson(value) {
         try {
@@ -12380,7 +12471,7 @@
             var _param_generateId = param.generateId, generateId$1 = _param_generateId === void 0 ? generateId : _param_generateId, _param_id = param.id, id = _param_id === void 0 ? generateId$1() : _param_id, transport = param.transport, state = param.state, onError = param.onError, onToolCall = param.onToolCall, onFinish = param.onFinish, onData = param.onData, sendAutomaticallyWhen = param.sendAutomaticallyWhen, shouldRepairToolInput = param.shouldRepairToolInput;
             var _this1 = this;
             _class_call_check(this, AbstractChat);
-            _define_property(this, "id", void 0);
+            _define_property(this, "conversationId", void 0);
             _define_property(this, "generateId", void 0);
             _define_property(this, "state", void 0);
             _define_property(this, "transport", void 0);
@@ -12536,12 +12627,6 @@
                 }
             });
             /**
-       * Regenerate the chat id. Use this to start a fresh conversation on the
-       * server while keeping the same Chat instance and its registered listeners.
-       */ _define_property(this, "regenerateId", function() {
-                _this.id = _this.generateId();
-            });
-            /**
        * Add a tool result for a tool call.
        */ _define_property(this, "addToolResult", function(param) {
                 var tool = param.tool, toolCallId = param.toolCallId, output = param.output;
@@ -12596,7 +12681,7 @@
                 });
                 return Promise.resolve();
             });
-            this.id = id;
+            this.conversationId = id;
             this.generateId = generateId$1;
             this.state = state;
             this.transport = transport;
@@ -12608,6 +12693,12 @@
             this.shouldRepairToolInput = shouldRepairToolInput;
         }
         _create_class(AbstractChat, [
+            {
+                key: "id",
+                get: function get() {
+                    return this.conversationId;
+                }
+            },
             {
                 key: "status",
                 get: /**
@@ -12637,6 +12728,17 @@
                     return this.state.error;
                 }
             },
+            {
+                /**
+       * Starts a new server-side conversation thread by rotating the id sent as
+       * `chatId` / `id` on the next request. The InstantSearch connector calls this
+       * after the user clears the transcript so completions are not tied to prior
+       * context.
+       */ key: "resetConversationId",
+                value: function resetConversationId() {
+                    this.conversationId = this.generateId();
+                }
+            },
             {
                 key: "messages",
                 get: function get() {
@@ -13005,8 +13107,7 @@
                                             var updatedParts7 = _to_consumable_array(currentMessage.parts);
                                             var existingPart2 = updatedParts7[toolIndex2];
                                             // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
-                                            existingPart2.rawOutput;
-                                            var rest = _object_without_properties(existingPart2, [
+                                            var _ignored = existingPart2.rawOutput, rest = _object_without_properties(existingPart2, [
                                                 "rawOutput"
                                             ]);
                                             updatedParts7[toolIndex2] = _object_spread_props(_object_spread({}, rest), {
@@ -13034,10 +13135,7 @@
                                             delete toolRawOutputByCallId[chunk.toolCallId];
                                             var updatedParts8 = _to_consumable_array(currentMessage.parts);
                                             var existingPart3 = updatedParts8[toolIndex3];
-                                            // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
-                                            existingPart3.rawOutput; // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
-                                            existingPart3.preliminary;
-                                            var rest1 = _object_without_properties(existingPart3, [
+                                            var _ignoredRawOutput = existingPart3.rawOutput, _ignoredPreliminary = existingPart3.preliminary, rest1 = _object_without_properties(existingPart3, [
                                                 "rawOutput",
                                                 "preliminary"
                                             ]);
@@ -13132,7 +13230,8 @@
                                 case 'error':
                                     {
                                         isError = true;
-                                        throw new Error(chunk.errorText);
+                                        var text = chunk.errorText.trim();
+                                        throw new Error(tryParseErrorMessage(text) || text || 'Unknown error');
                                     }
                                 case 'abort':
                                     {
@@ -13149,9 +13248,32 @@
                                         }
                                         break;
                                     }
+                                // Surface guardrail violations through the error state, but
+                                // distinct from generic cost-control / 4xx errors: throw a
+                                // `GuardrailViolationError` so the UI can render the
+                                // service-provided `fallbackResponse` verbatim (it's authored for
+                                // end-user display) instead of the friendly default used for
+                                // opaque transport errors. Also discard any in-progress assistant
+                                // message so no partial text lingers above the fallback, and
+                                // clear the local cursor so the `onFinish` callback doesn't
+                                // receive a `currentMessage` that no longer exists in state.
+                                case 'data-guardrail-violation':
+                                    {
+                                        isError = true;
+                                        if (currentMessageIndex >= 0) {
+                                            _this.state.messages = _this.state.messages.slice(0, currentMessageIndex);
+                                            currentMessage = undefined;
+                                            currentMessageIndex = -1;
+                                        }
+                                        // `chunk.data` widens to `unknown` here: the chunk union also
+                                        // carries a generic `data-${string}` member, and the literal
+                                        // matches both, so narrowing can't pick the specific shape.
+                                        var fallbackResponse = chunk.data.fallbackResponse;
+                                        throw new GuardrailViolationError(fallbackResponse || 'Sorry, we are not able to generate a response at the moment.');
+                                    }
                                 default:
                                     {
-                                        // Handle data parts (data-*)
+                                        // Handle generic data parts (data-*)
                                         var chunkType = chunk.type;
                                         if ((chunkType === null || chunkType === void 0 ? void 0 : chunkType.startsWith('data-')) && currentMessage) {
                                             var dataPart = {
@@ -13466,6 +13588,20 @@
         }, []);
     }
 
+    /**
+     * Reads a human-readable message from a failed HTTP response body when the
+     * server returns JSON such as `{ "message": "..." }` (the shared
+     * `ErrorResponse` shape used by every status code), falling back to the HTTP
+     * status line when the body is empty or not parseable.
+     */ function getHttpErrorMessage(response) {
+        var fallback = "HTTP error: ".concat(response.status, " ").concat(response.statusText);
+        return response.text().then(function(text) {
+            var _tryParseErrorMessage;
+            return (_tryParseErrorMessage = tryParseErrorMessage(text)) !== null && _tryParseErrorMessage !== void 0 ? _tryParseErrorMessage : fallback;
+        }).catch(function() {
+            return fallback;
+        });
+    }
     /**
      * Abstract base class for HTTP-based chat transports.
      */ var HttpChatTransport = /*#__PURE__*/ function() {
@@ -13544,7 +13680,9 @@
                                 credentials: credentials
                             }).then(function(response) {
                                 if (!response.ok) {
-                                    throw new Error("HTTP error: ".concat(response.status, " ").concat(response.statusText));
+                                    return getHttpErrorMessage(response).then(function(message) {
+                                        throw new Error(message);
+                                    });
                                 }
                                 if (!response.body) {
                                     throw new Error('Response body is empty');
@@ -13602,7 +13740,9 @@
                                     if (response.status === 404) {
                                         return null;
                                     }
-                                    throw new Error("HTTP error: ".concat(response.status, " ").concat(response.statusText));
+                                    return getHttpErrorMessage(response).then(function(message) {
+                                        throw new Error(message);
+                                    });
                                 }
                                 if (!response.body) {
                                     return null;
@@ -13638,7 +13778,7 @@
         return DefaultChatTransport;
     }(HttpChatTransport);
 
-    var withUsage$n = createDocumentationMessageGenerator({
+    var withUsage$o = createDocumentationMessageGenerator({
         name: 'chat',
         connector: true
     });
@@ -13689,15 +13829,16 @@
     }
     var connectChat = function connectChat(renderFn) {
         var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
-        checkRendering(renderFn, withUsage$n());
+        checkRendering(renderFn, withUsage$o());
         return function(widgetParams) {
-            var _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, options = _object_without_properties(_ref, [
+            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, options = _object_without_properties(_ref, [
                 "resume",
                 "tools",
                 "type",
                 "context",
                 "initialUserMessage",
-                "initialMessages"
+                "initialMessages",
+                "disableTriggerValidation"
             ]);
             var _chatInstance;
             var input = '';
@@ -13709,6 +13850,7 @@
             var focusInput;
             var setIsClearing;
             var setFeedbackState;
+            var hasValidatedEntryPoints = false;
             var agentId = 'agentId' in options ? options.agentId : undefined;
             var feedbackState = {};
             var _sendChatMessageFeedback;
@@ -13748,10 +13890,26 @@
             var onClearTransitionEnd = function onClearTransitionEnd() {
                 setMessages([]);
                 _chatInstance.clearError();
-                _chatInstance.regenerateId();
+                _chatInstance.resetConversationId();
                 feedbackState = {};
                 setIsClearing(false);
             };
+            var validateEntryPoints = function validateEntryPoints(instantSearchInstance) {
+                if (disableTriggerValidation || hasValidatedEntryPoints) {
+                    return;
+                }
+                // warning only relevant once mounted
+                if (!instantSearchInstance.mainIndex) {
+                    return;
+                }
+                walkIndex(instantSearchInstance.mainIndex, function(indexWidget) {
+                    var widgets = indexWidget.getWidgets();
+                    if (widgets.some(function(w) {
+                        return w.opensChat === true;
+                    })) ;
+                });
+                hasValidatedEntryPoints = true;
+            };
             var makeChatInstance = function makeChatInstance(instantSearchInstance) {
                 var transport;
                 var client = instantSearchInstance.client;
@@ -13801,7 +13959,7 @@
                 }
                 if ('agentId' in options && options.agentId) {
                     if (!appId || !apiKey) {
-                        throw new Error(withUsage$n('Could not extract Algolia credentials from the search client.'));
+                        throw new Error(withUsage$o('Could not extract Algolia credentials from the search client.'));
                     }
                     var baseApi = "https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/completions?compatibilityMode=ai-sdk-5");
                     transport = new DefaultChatTransport({
@@ -13826,7 +13984,7 @@
                     });
                 }
                 if (!transport) {
-                    throw new Error(withUsage$n('You need to provide either an `agentId` or a `transport`.'));
+                    throw new Error(withUsage$o('You need to provide either an `agentId` or a `transport`.'));
                 }
                 if ('chat' in options) {
                     return options.chat;
@@ -13878,6 +14036,7 @@
                 init: function init(initOptions) {
                     var _this = this;
                     var instantSearchInstance = initOptions.instantSearchInstance;
+                    validateEntryPoints(instantSearchInstance);
                     _chatInstance = makeChatInstance(instantSearchInstance);
                     var render = function render() {
                         renderFn(_object_spread_props(_object_spread({}, _this.getWidgetRenderState(initOptions)), {
@@ -13887,6 +14046,10 @@
                     setOpen = function setOpen(o) {
                         open = o;
                         render();
+                        // `open` is read by sibling widgets (e.g. `chatTrigger`) via the
+                        // shared `renderState`. Schedule a full re-render so they pick up
+                        // the new value instead of staying frozen on their initial state.
+                        initOptions.instantSearchInstance.scheduleRender();
                     };
                     focusInput = function focusInput() {
                         setOpen(true);
@@ -13907,7 +14070,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$n('Could not extract Algolia credentials from the search client.'));
+                            throw new Error(withUsage$o('Could not extract Algolia credentials from the search client.'));
                         }
                         feedbackAbortController = new AbortController();
                         _sendChatMessageFeedback = function _sendChatMessageFeedback(messageId, vote) {
@@ -13948,6 +14111,7 @@
                     }), true);
                 },
                 render: function render(renderOptions) {
+                    validateEntryPoints(renderOptions.instantSearchInstance);
                     renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(renderOptions)), {
                         instantSearchInstance: renderOptions.instantSearchInstance
                     }), false);
@@ -14054,6 +14218,77 @@
         return useConnector(connectChat, props, additionalWidgetProperties);
     }
 
+    var withUsage$n = createDocumentationMessageGenerator({
+        name: 'chatTrigger',
+        connector: true
+    });
+    // Reads the sibling chat widget's render state from the live cross-index
+    // `instantSearchInstance.renderState` map. We resolve at call time so that
+    // `toggleOpen` always sees the latest `open`/`setOpen` values.
+    function getChatRenderState(options) {
+        var _options_parent, _options_instantSearchInstance_renderState_indexId;
+        var indexId = (_options_parent = options.parent) === null || _options_parent === void 0 ? void 0 : _options_parent.getIndexId();
+        if (!indexId) return undefined;
+        return (_options_instantSearchInstance_renderState_indexId = options.instantSearchInstance.renderState[indexId]) === null || _options_instantSearchInstance_renderState_indexId === void 0 ? void 0 : _options_instantSearchInstance_renderState_indexId.chat;
+    }
+    var connectChatTrigger = function connectChatTrigger(renderFn) {
+        var unmountFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : noop;
+        checkRendering(renderFn, withUsage$n());
+        return function(widgetParams) {
+            var params = widgetParams !== null && widgetParams !== void 0 ? widgetParams : {};
+            var lastOptions = null;
+            function toggleOpen() {
+                if (!lastOptions) return;
+                var chatState = getChatRenderState(lastOptions);
+                if (!chatState) return;
+                if (chatState.open) {
+                    var _chatState_setOpen;
+                    (_chatState_setOpen = chatState.setOpen) === null || _chatState_setOpen === void 0 ? void 0 : _chatState_setOpen.call(chatState, false);
+                } else {
+                    openChat(chatState);
+                }
+            }
+            return {
+                $$type: 'ais.chatTrigger',
+                opensChat: true,
+                init: function init(initOptions) {
+                    lastOptions = initOptions;
+                    renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(initOptions)), {
+                        instantSearchInstance: initOptions.instantSearchInstance
+                    }), true);
+                },
+                render: function render(renderOptions) {
+                    lastOptions = renderOptions;
+                    renderFn(_object_spread_props(_object_spread({}, this.getWidgetRenderState(renderOptions)), {
+                        instantSearchInstance: renderOptions.instantSearchInstance
+                    }), false);
+                },
+                dispose: function dispose() {
+                    unmountFn();
+                },
+                getWidgetRenderState: function getWidgetRenderState(renderOptions) {
+                    var _ref;
+                    var chatState = getChatRenderState(renderOptions);
+                    return {
+                        open: (_ref = chatState === null || chatState === void 0 ? void 0 : chatState.open) !== null && _ref !== void 0 ? _ref : false,
+                        toggleOpen: toggleOpen,
+                        widgetParams: params
+                    };
+                },
+                getRenderState: function getRenderState(renderState, renderOptions) {
+                    return _object_spread_props(_object_spread({}, renderState), {
+                        chatTrigger: this.getWidgetRenderState(renderOptions)
+                    });
+                }
+            };
+        };
+    };
+
+    function useChatTrigger() {
+        var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {}, additionalWidgetProperties = arguments.length > 1 ? arguments[1] : void 0;
+        return useConnector(connectChatTrigger, props, additionalWidgetProperties);
+    }
+
     var withUsage$m = createDocumentationMessageGenerator({
         name: 'clear-refinements',
         connector: true
@@ -19813,15 +20048,32 @@
             createElement: createElement
         });
         return function ChatMessageError(userProps) {
-            var onReload = userProps.onReload, actions = userProps.actions, userTranslations = userProps.translations, props = _object_without_properties(userProps, [
+            var _ref, _ref1;
+            var errorMessage = userProps.errorMessage, onReload = userProps.onReload, onNewConversation = userProps.onNewConversation, actions = userProps.actions, userTranslations = userProps.translations, props = _object_without_properties(userProps, [
+                "errorMessage",
                 "onReload",
+                "onNewConversation",
                 "actions",
                 "translations"
             ]);
-            var translations = _object_spread({
-                errorMessage: 'Sorry, we are not able to generate a response at the moment. Please retry or contact support.',
-                retryText: 'Retry'
-            }, userTranslations);
+            var defaultErrorMessage = 'Sorry, we are not able to generate a response at the moment. Please contact support.';
+            var defaultNewConversationText = 'Start a new conversation';
+            var defaultRetryText = 'Retry';
+            var errorMessageTranslation = userTranslations === null || userTranslations === void 0 ? void 0 : userTranslations.errorMessage;
+            var resolvedErrorMessage = typeof errorMessageTranslation === 'function' ? errorMessageTranslation({
+                errorMessage: errorMessage
+            }) : errorMessageTranslation !== null && errorMessageTranslation !== void 0 ? errorMessageTranslation : defaultErrorMessage;
+            var newConversationText = (_ref = userTranslations === null || userTranslations === void 0 ? void 0 : userTranslations.newConversationText) !== null && _ref !== void 0 ? _ref : defaultNewConversationText;
+            var retryText = (_ref1 = userTranslations === null || userTranslations === void 0 ? void 0 : userTranslations.retryText) !== null && _ref1 !== void 0 ? _ref1 : defaultRetryText;
+            // Action precedence:
+            //   1. `actions` (full custom)
+            //   2. `onNewConversation` (recommended for permanent / guardrail errors)
+            //   3. `onReload` (legacy retry, suitable for transient failures)
+            //   4. nothing
+            var hasCustomActions = Boolean(actions);
+            var showNewConversation = !hasCustomActions && Boolean(onNewConversation);
+            var showRetry = !hasCustomActions && !showNewConversation && Boolean(onReload);
+            var hasActions = hasCustomActions || showNewConversation || showRetry;
             return /*#__PURE__*/ createElement("article", _object_spread({
                 className: "ais-ChatMessageError ais-ChatMessage ais-ChatMessage--left ais-ChatMessage--subtle"
             }, props), /*#__PURE__*/ createElement("div", {
@@ -19830,15 +20082,22 @@
                 className: "ais-ChatMessage-content"
             }, /*#__PURE__*/ createElement("div", {
                 className: "ais-ChatMessage-message"
-            }, translations.errorMessage), (actions || onReload) && /*#__PURE__*/ createElement("div", {
+            }, resolvedErrorMessage), hasActions && /*#__PURE__*/ createElement("div", {
                 className: "ais-ChatMessage-actions"
-            }, actions ? actions.map(function(action, index) {
+            }, hasCustomActions ? actions.map(function(action, index) {
                 return /*#__PURE__*/ createElement(Button, _object_spread({
                     key: index,
                     variant: "ghost",
                     className: "ais-ChatMessage-action"
                 }, action), action.children);
-            }) : /*#__PURE__*/ createElement(Button, {
+            }) : showNewConversation ? /*#__PURE__*/ createElement(Button, {
+                variant: "primary",
+                size: "md",
+                className: "ais-ChatMessage-errorAction",
+                onClick: function onClick() {
+                    return onNewConversation === null || onNewConversation === void 0 ? void 0 : onNewConversation();
+                }
+            }, newConversationText) : /*#__PURE__*/ createElement(Button, {
                 variant: "primary",
                 size: "md",
                 className: "ais-ChatMessage-errorAction",
@@ -19847,7 +20106,7 @@
                 }
             }, /*#__PURE__*/ createElement(ReloadIcon, {
                 createElement: createElement
-            }), translations.retryText)))));
+            }), retryText)))));
         };
     }
 
@@ -20011,7 +20270,7 @@
         });
         return function ChatMessages(userProps) {
             var _lastMessage_parts;
-            var _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, _userProps_messageClassNames = userProps.messageClassNames, messageClassNames = _userProps_messageClassNames === void 0 ? {} : _userProps_messageClassNames, messageTranslations = userProps.messageTranslations, _userProps_messages = userProps.messages, messages = _userProps_messages === void 0 ? [] : _userProps_messages, MessageComponent = userProps.messageComponent, LoaderComponent = userProps.loaderComponent, ErrorComponent = userProps.errorComponent, EmptyComponent = userProps.emptyComponent, ActionsComponent = userProps.actionsComponent, tools = userProps.tools, indexUiState = userProps.indexUiState, setIndexUiState = userProps.setIndexUiState, _userProps_status = userProps.status, status = _userProps_status === void 0 ? 'ready' : _userProps_status, _userProps_hideScrollToBottom = userProps.hideScrollToBottom, hideScrollToBottom = _userProps_hideScrollToBottom === void 0 ? false : _userProps_hideScrollToBottom, onReload = userProps.onReload, onClose = userProps.onClose, sendMessage = userProps.sendMessage, setInput = userProps.setInput, userTranslations = userProps.translations, userMessageProps = userProps.userMessageProps, assistantMessageProps = userProps.assistantMessageProps, _userProps_isClearing = userProps.isClearing, isClearing = _userProps_isClearing === void 0 ? false : _userProps_isClearing, onClearTransitionEnd = userProps.onClearTransitionEnd, isScrollAtBottom = userProps.isScrollAtBottom, scrollRef = userProps.scrollRef, contentRef = userProps.contentRef, onScrollToBottom = userProps.onScrollToBottom, suggestionsElement = userProps.suggestionsElement, onFeedback = userProps.onFeedback, feedbackState = userProps.feedbackState, props = _object_without_properties(userProps, [
+            var _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, _userProps_messageClassNames = userProps.messageClassNames, messageClassNames = _userProps_messageClassNames === void 0 ? {} : _userProps_messageClassNames, messageTranslations = userProps.messageTranslations, _userProps_messages = userProps.messages, messages = _userProps_messages === void 0 ? [] : _userProps_messages, MessageComponent = userProps.messageComponent, LoaderComponent = userProps.loaderComponent, ErrorComponent = userProps.errorComponent, EmptyComponent = userProps.emptyComponent, ActionsComponent = userProps.actionsComponent, tools = userProps.tools, indexUiState = userProps.indexUiState, setIndexUiState = userProps.setIndexUiState, _userProps_status = userProps.status, status = _userProps_status === void 0 ? 'ready' : _userProps_status, error = userProps.error, _userProps_hideScrollToBottom = userProps.hideScrollToBottom, hideScrollToBottom = _userProps_hideScrollToBottom === void 0 ? false : _userProps_hideScrollToBottom, onReload = userProps.onReload, onNewConversation = userProps.onNewConversation, onClose = userProps.onClose, sendMessage = userProps.sendMessage, setInput = userProps.setInput, userTranslations = userProps.translations, userMessageProps = userProps.userMessageProps, assistantMessageProps = userProps.assistantMessageProps, _userProps_isClearing = userProps.isClearing, isClearing = _userProps_isClearing === void 0 ? false : _userProps_isClearing, onClearTransitionEnd = userProps.onClearTransitionEnd, isScrollAtBottom = userProps.isScrollAtBottom, scrollRef = userProps.scrollRef, contentRef = userProps.contentRef, onScrollToBottom = userProps.onScrollToBottom, suggestionsElement = userProps.suggestionsElement, onFeedback = userProps.onFeedback, feedbackState = userProps.feedbackState, props = _object_without_properties(userProps, [
                 "classNames",
                 "messageClassNames",
                 "messageTranslations",
@@ -20025,8 +20284,10 @@
                 "indexUiState",
                 "setIndexUiState",
                 "status",
+                "error",
                 "hideScrollToBottom",
                 "onReload",
+                "onNewConversation",
                 "onClose",
                 "sendMessage",
                 "setInput",
@@ -20111,7 +20372,18 @@
                     loaderText: translations.loaderText
                 }
             }), status === 'error' && /*#__PURE__*/ createElement(DefaultError, {
-                onReload: onReload
+                onNewConversation: onNewConversation,
+                errorMessage: error === null || error === void 0 ? void 0 : error.message,
+                translations: // `fallbackResponse` that's safe to display verbatim; for
+                // every other error we keep hiding the raw `error.message`
+                // behind the friendly default. Detection is by `error.name`
+                // to avoid coupling this package to `instantsearch.js`.
+                (error === null || error === void 0 ? void 0 : error.name) === 'GuardrailViolationError' ? {
+                    errorMessage: function errorMessage(param) {
+                        var rawMessage = param.errorMessage;
+                        return rawMessage !== null && rawMessage !== void 0 ? rawMessage : '';
+                    }
+                } : undefined
             }))), /*#__PURE__*/ createElement(Button, {
                 variant: "outline",
                 size: "sm",
@@ -20130,13 +20402,9 @@
         if (status === 'submitted') return true;
         if (!lastPart) return true;
         if (isPartText(lastPart)) return false;
-        if (isPartTool(lastPart)) {
-            if (lastPart.state === 'output-available') return false;
-            if (lastPart.state === 'input-streaming') {
-                var tool = findTool(lastPart.type, tools);
-                return !(tool === null || tool === void 0 ? void 0 : tool.streamInput);
-            }
-            return true;
+        if (isPartTool(lastPart) && lastPart.state === 'input-streaming') {
+            var tool = findTool(lastPart.type, tools);
+            return !(tool === null || tool === void 0 ? void 0 : tool.streamInput);
         }
         return true;
     };
@@ -20144,7 +20412,7 @@
     function createChatOverlayLayoutComponent(param) {
         var createElement = param.createElement;
         return function ChatOverlayLayout(userProps) {
-            var open = userProps.open, maximized = userProps.maximized, headerComponent = userProps.headerComponent, messagesComponent = userProps.messagesComponent, promptComponent = userProps.promptComponent, toggleButtonComponent = userProps.toggleButtonComponent, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, className = userProps.className; // Chat state props (destructured to avoid spreading on div)
+            var open = userProps.open, maximized = userProps.maximized, headerComponent = userProps.headerComponent, messagesComponent = userProps.messagesComponent, promptComponent = userProps.promptComponent, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, className = userProps.className; // Chat state props (destructured to avoid spreading on div)
             userProps.messages;
             userProps.status;
             userProps.isClearing;
@@ -20162,7 +20430,6 @@
                 "headerComponent",
                 "messagesComponent",
                 "promptComponent",
-                "toggleButtonComponent",
                 "classNames",
                 "className",
                 "messages",
@@ -20181,9 +20448,7 @@
                 className: cx('ais-Chat', 'ais-ChatOverlayLayout', maximized && 'ais-ChatOverlayLayout--maximized', classNames.root, className)
             }), /*#__PURE__*/ createElement("div", {
                 className: cx('ais-Chat-container', open && 'ais-Chat-container--open', maximized && 'ais-Chat-container--maximized', classNames.container)
-            }, headerComponent, messagesComponent, promptComponent), /*#__PURE__*/ createElement("div", {
-                className: "ais-Chat-toggleButtonWrapper"
-            }, toggleButtonComponent));
+            }, headerComponent, messagesComponent, promptComponent));
         };
     }
 
@@ -20372,42 +20637,8 @@
         };
     }
 
-    function createChatToggleButtonComponent(param) {
-        var createElement = param.createElement;
-        var Button = createButtonComponent({
-            createElement: createElement
-        });
-        return function ChatToggleButton(userProps) {
-            var open = userProps.open, onClick = userProps.onClick, ToggleIcon = userProps.toggleIconComponent, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, className = userProps.className, props = _object_without_properties(userProps, [
-                "open",
-                "onClick",
-                "toggleIconComponent",
-                "classNames",
-                "className"
-            ]);
-            var defaultIcon = open ? /*#__PURE__*/ createElement(ChevronUpIcon, {
-                createElement: createElement
-            }) : /*#__PURE__*/ createElement(SparklesIcon, {
-                createElement: createElement
-            });
-            return /*#__PURE__*/ createElement(Button, _object_spread({
-                variant: "primary",
-                size: "md",
-                iconOnly: true,
-                className: cx('ais-ChatToggleButton', open && 'ais-ChatToggleButton--open', classNames.root, className),
-                onClick: onClick
-            }, props), ToggleIcon ? /*#__PURE__*/ createElement(ToggleIcon, {
-                isOpen: open
-            }) : defaultIcon);
-        };
-    }
-
     function createChatComponent(param) {
         var createElement = param.createElement, Fragment = param.Fragment;
-        var ChatToggleButton = createChatToggleButtonComponent({
-            createElement: createElement,
-            Fragment: Fragment
-        });
         var ChatHeader = createChatHeaderComponent({
             createElement: createElement,
             Fragment: Fragment
@@ -20429,17 +20660,15 @@
             Fragment: Fragment
         });
         return function Chat(userProps) {
-            var open = userProps.open, _userProps_maximized = userProps.maximized, maximized = _userProps_maximized === void 0 ? false : _userProps_maximized, headerProps = userProps.headerProps, toggleButtonProps = userProps.toggleButtonProps, messagesProps = userProps.messagesProps, suggestionsProps = userProps.suggestionsProps, _userProps_promptProps = userProps.promptProps, promptProps = _userProps_promptProps === void 0 ? {} : _userProps_promptProps, HeaderComponent = userProps.headerComponent, PromptComponent = userProps.promptComponent, ToggleButtonComponent = userProps.toggleButtonComponent, SuggestionsComponent = userProps.suggestionsComponent, tmp = userProps.layoutComponent, LayoutComponent = tmp === void 0 ? OverlayLayout : tmp, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, className = userProps.className, sendMessage = userProps.sendMessage, regenerate = userProps.regenerate, stop = userProps.stop, error = userProps.error, props = _object_without_properties(userProps, [
+            var open = userProps.open, _userProps_maximized = userProps.maximized, maximized = _userProps_maximized === void 0 ? false : _userProps_maximized, headerProps = userProps.headerProps, messagesProps = userProps.messagesProps, suggestionsProps = userProps.suggestionsProps, _userProps_promptProps = userProps.promptProps, promptProps = _userProps_promptProps === void 0 ? {} : _userProps_promptProps, HeaderComponent = userProps.headerComponent, PromptComponent = userProps.promptComponent, SuggestionsComponent = userProps.suggestionsComponent, tmp = userProps.layoutComponent, LayoutComponent = tmp === void 0 ? OverlayLayout : tmp, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, className = userProps.className, sendMessage = userProps.sendMessage, regenerate = userProps.regenerate, stop = userProps.stop, error = userProps.error, props = _object_without_properties(userProps, [
                 "open",
                 "maximized",
                 "headerProps",
-                "toggleButtonProps",
                 "messagesProps",
                 "suggestionsProps",
                 "promptProps",
                 "headerComponent",
                 "promptComponent",
-                "toggleButtonComponent",
                 "suggestionsComponent",
                 "layoutComponent",
                 "classNames",
@@ -20454,6 +20683,7 @@
                 maximized: maximized
             }));
             var messagesComponent = /*#__PURE__*/ createElement(ChatMessages, _object_spread_props(_object_spread({}, messagesProps), {
+                error: error,
                 classNames: classNames.messages,
                 messageClassNames: classNames.message,
                 suggestionsElement: createElement(SuggestionsComponent || ChatPromptSuggestions, _object_spread_props(_object_spread({}, suggestionsProps), {
@@ -20463,24 +20693,12 @@
             var promptComponent = createElement(PromptComponent || ChatPrompt, _object_spread_props(_object_spread({}, promptProps), {
                 classNames: classNames.prompt
             }));
-            var toggleButtonComponent = createElement(ToggleButtonComponent || ChatToggleButton, _object_spread_props(_object_spread({}, toggleButtonProps), {
-                classNames: classNames.toggleButton,
-                onClick: function onClick() {
-                    var _toggleButtonProps_onClick;
-                    (_toggleButtonProps_onClick = toggleButtonProps.onClick) === null || _toggleButtonProps_onClick === void 0 ? void 0 : _toggleButtonProps_onClick.call(toggleButtonProps);
-                    if (!open) {
-                        var _promptProps_promptRef_current, _promptProps_promptRef;
-                        (_promptProps_promptRef = promptProps.promptRef) === null || _promptProps_promptRef === void 0 ? void 0 : (_promptProps_promptRef_current = _promptProps_promptRef.current) === null || _promptProps_promptRef_current === void 0 ? void 0 : _promptProps_promptRef_current.focus();
-                    }
-                }
-            }));
             return /*#__PURE__*/ createElement(LayoutComponent, _object_spread_props(_object_spread({}, props), {
                 open: open,
                 maximized: maximized,
                 headerComponent: headerComponent,
                 messagesComponent: messagesComponent,
                 promptComponent: promptComponent,
-                toggleButtonComponent: toggleButtonComponent,
                 classNames: {
                     root: classNames.root,
                     container: classNames.container
@@ -20506,8 +20724,7 @@
         return function ChatInlineLayout(userProps) {
             var headerComponent = userProps.headerComponent, messagesComponent = userProps.messagesComponent, promptComponent = userProps.promptComponent, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, className = userProps.className;
             userProps.open;
-            userProps.maximized;
-            userProps.toggleButtonComponent; // Chat state props (destructured to avoid spreading on div)
+            userProps.maximized; // Chat state props (destructured to avoid spreading on div)
             userProps.messages;
             userProps.status;
             userProps.isClearing;
@@ -20527,7 +20744,6 @@
                 "className",
                 "open",
                 "maximized",
-                "toggleButtonComponent",
                 "messages",
                 "status",
                 "isClearing",
@@ -20552,7 +20768,7 @@
         var createElement = param.createElement;
         var originalMargins = new WeakMap();
         return function ChatSidePanelLayout(userProps) {
-            var open = userProps.open, maximized = userProps.maximized, headerComponent = userProps.headerComponent, messagesComponent = userProps.messagesComponent, promptComponent = userProps.promptComponent, toggleButtonComponent = userProps.toggleButtonComponent, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, className = userProps.className, parentElement = userProps.parentElement; // Chat state props (destructured to avoid spreading on div)
+            var open = userProps.open, maximized = userProps.maximized, headerComponent = userProps.headerComponent, messagesComponent = userProps.messagesComponent, promptComponent = userProps.promptComponent, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, className = userProps.className, parentElement = userProps.parentElement; // Chat state props (destructured to avoid spreading on div)
             userProps.messages;
             userProps.status;
             userProps.isClearing;
@@ -20570,7 +20786,6 @@
                 "headerComponent",
                 "messagesComponent",
                 "promptComponent",
-                "toggleButtonComponent",
                 "classNames",
                 "className",
                 "parentElement",
@@ -20607,9 +20822,7 @@
                 className: cx('ais-Chat', 'ais-ChatSidePanelLayout', maximized && 'ais-ChatSidePanelLayout--maximized', classNames.root, className)
             }), /*#__PURE__*/ createElement("div", {
                 className: cx('ais-Chat-container', open && 'ais-Chat-container--open', maximized && 'ais-Chat-container--maximized', classNames.container)
-            }, headerComponent, messagesComponent, promptComponent), /*#__PURE__*/ createElement("div", {
-                className: "ais-Chat-toggleButtonWrapper"
-            }, toggleButtonComponent));
+            }, headerComponent, messagesComponent, promptComponent));
         };
     }
 
@@ -20649,6 +20862,36 @@
         };
     }
 
+    function createChatToggleButtonComponent(param) {
+        var createElement = param.createElement;
+        var Button = createButtonComponent({
+            createElement: createElement
+        });
+        return function ChatToggleButton(userProps) {
+            var open = userProps.open, onClick = userProps.onClick, ToggleIcon = userProps.toggleIconComponent, _userProps_classNames = userProps.classNames, classNames = _userProps_classNames === void 0 ? {} : _userProps_classNames, className = userProps.className, props = _object_without_properties(userProps, [
+                "open",
+                "onClick",
+                "toggleIconComponent",
+                "classNames",
+                "className"
+            ]);
+            var defaultIcon = open ? /*#__PURE__*/ createElement(ChevronUpIcon, {
+                createElement: createElement
+            }) : /*#__PURE__*/ createElement(SparklesIcon, {
+                createElement: createElement
+            });
+            return /*#__PURE__*/ createElement(Button, _object_spread({
+                variant: "primary",
+                size: "md",
+                iconOnly: true,
+                className: cx('ais-ChatToggleButton', open && 'ais-ChatToggleButton--open', classNames.root, className),
+                onClick: onClick
+            }, props), ToggleIcon ? /*#__PURE__*/ createElement(ToggleIcon, {
+                isOpen: open
+            }) : defaultIcon);
+        };
+    }
+
     var DEFAULT_TRANSLATIONS$1 = {
         streamingLabel: 'Curating results…'
     };
@@ -22004,22 +22247,25 @@
         };
     }
     function EXPERIMENTAL_Autocomplete(_0) {
-        var _0_indices = _0.indices, indices = _0_indices === void 0 ? [] : _0_indices, showQuerySuggestions = _0.showQuerySuggestions, showPromptSuggestions = _0.showPromptSuggestions, showRecent = _0.showRecent, userSearchParameters = _0.searchParameters, detachedMediaQuery = _0.detachedMediaQuery, tmp = _0.translations, userTranslations = tmp === void 0 ? {} : tmp, props = _object_without_properties(_0, [
+        var _0_indices = _0.indices, indices = _0_indices === void 0 ? [] : _0_indices, showQuerySuggestions = _0.showQuerySuggestions, showPromptSuggestions = _0.showPromptSuggestions, showRecent = _0.showRecent, userSearchParameters = _0.searchParameters, detachedMediaQuery = _0.detachedMediaQuery, tmp = _0.translations, userTranslations = tmp === void 0 ? {} : tmp, aiMode = _0.aiMode, props = _object_without_properties(_0, [
             "indices",
             "showQuerySuggestions",
             "showPromptSuggestions",
             "showRecent",
             "searchParameters",
             "detachedMediaQuery",
-            "translations"
+            "translations",
+            "aiMode"
         ]);
         var _showRecent_classNames, _showRecent_classNames1, _showRecent_classNames2, _showRecent_classNames3;
         var translations = _object_spread({}, DEFAULT_TRANSLATIONS, userTranslations);
         var _useInstantSearch = useInstantSearch(), indexUiState = _useInstantSearch.indexUiState, indexRenderState = _useInstantSearch.indexRenderState, status = _useInstantSearch.status;
-        var refine = useSearchBox({}, {
+        var refine = useSearchBox({}, _object_spread({
             $$type: 'ais.autocomplete',
             $$widgetType: 'ais.autocomplete'
-        }).refine;
+        }, aiMode ? {
+            opensChat: true
+        } : {})).refine;
         var isSearchStalled = status === 'stalled';
         var searchParameters = _object_spread({
             hitsPerPage: 5
@@ -22108,6 +22354,7 @@
                 indexName: index.indexName
             }, /*#__PURE__*/ React.createElement(Configure, index.searchParameters));
         }), /*#__PURE__*/ React.createElement(InnerAutocomplete, _object_spread_props(_object_spread({}, props), {
+            aiMode: aiMode,
             indicesConfig: indicesConfig,
             refineSearchBox: refine,
             isSearchStalled: isSearchStalled,
@@ -22582,6 +22829,9 @@
         createElement: React.createElement,
         Fragment: React.Fragment
     });
+    // Marker used by `<Chat>` to auto-exempt inline layouts from the entry-point
+    // validation, since inline chats are always visible (no trigger needed).
+    ChatInlineLayout.$$inlineLayout = true;
 
     var ChatSidePanelLayout = createChatSidePanelLayoutComponent({
         createElement: React.createElement,
@@ -22751,16 +23001,13 @@
         var _ref = [
             _0,
             _1
-        ], _ref1 = _to_array(_ref), _ref2 = _ref1[0], _rest = _ref1.slice(1), userTools = _ref2.tools, toggleButtonProps = _ref2.toggleButtonProps, headerProps = _ref2.headerProps, messagesProps = _ref2.messagesProps, promptProps = _ref2.promptProps, itemComponent = _ref2.itemComponent, layoutComponent = _ref2.layoutComponent, toggleButtonComponent = _ref2.toggleButtonComponent, toggleButtonIconComponent = _ref2.toggleButtonIconComponent, headerComponent = _ref2.headerComponent, headerTitleIconComponent = _ref2.headerTitleIconComponent, headerCloseIconComponent = _ref2.headerCloseIconComponent, headerMinimizeIconComponent = _ref2.headerMinimizeIconComponent, headerMaximizeIconComponent = _ref2.headerMaximizeIconComponent, loaderComponent = _ref2.loaderComponent, messagesErrorComponent = _ref2.messagesErrorComponent, promptComponent = _ref2.promptComponent, promptHeaderComponent = _ref2.promptHeaderComponent, promptFooterComponent = _ref2.promptFooterComponent, assistantMessageLeadingComponent = _ref2.assistantMessageLeadingComponent, assistantMessageFooterComponent = _ref2.assistantMessageFooterComponent, userMessageLeadingComponent = _ref2.userMessageLeadingComponent, userMessageFooterComponent = _ref2.userMessageFooterComponent, emptyComponent = _ref2.emptyComponent, actionsComponent = _ref2.actionsComponent, suggestionsComponent = _ref2.suggestionsComponent, classNames = _ref2.classNames, _ref_translations = _ref2.translations, translations = _ref_translations === void 0 ? {} : _ref_translations, title = _ref2.title, getSearchPageURL = _ref2.getSearchPageURL, props = _object_without_properties(_ref2, [
+        ], _ref1 = _to_array(_ref), _ref2 = _ref1[0], _rest = _ref1.slice(1), userTools = _ref2.tools, headerProps = _ref2.headerProps, messagesProps = _ref2.messagesProps, promptProps = _ref2.promptProps, itemComponent = _ref2.itemComponent, layoutComponent = _ref2.layoutComponent, headerComponent = _ref2.headerComponent, headerTitleIconComponent = _ref2.headerTitleIconComponent, headerCloseIconComponent = _ref2.headerCloseIconComponent, headerMinimizeIconComponent = _ref2.headerMinimizeIconComponent, headerMaximizeIconComponent = _ref2.headerMaximizeIconComponent, loaderComponent = _ref2.loaderComponent, messagesErrorComponent = _ref2.messagesErrorComponent, promptComponent = _ref2.promptComponent, promptHeaderComponent = _ref2.promptHeaderComponent, promptFooterComponent = _ref2.promptFooterComponent, assistantMessageLeadingComponent = _ref2.assistantMessageLeadingComponent, assistantMessageFooterComponent = _ref2.assistantMessageFooterComponent, userMessageLeadingComponent = _ref2.userMessageLeadingComponent, userMessageFooterComponent = _ref2.userMessageFooterComponent, emptyComponent = _ref2.emptyComponent, actionsComponent = _ref2.actionsComponent, suggestionsComponent = _ref2.suggestionsComponent, classNames = _ref2.classNames, _ref_translations = _ref2.translations, translations = _ref_translations === void 0 ? {} : _ref_translations, title = _ref2.title, getSearchPageURL = _ref2.getSearchPageURL, _ref_disableTriggerValidation = _ref2.disableTriggerValidation, disableTriggerValidation = _ref_disableTriggerValidation === void 0 ? false : _ref_disableTriggerValidation, props = _object_without_properties(_ref2, [
             "tools",
-            "toggleButtonProps",
             "headerProps",
             "messagesProps",
             "promptProps",
             "itemComponent",
             "layoutComponent",
-            "toggleButtonComponent",
-            "toggleButtonIconComponent",
             "headerComponent",
             "headerTitleIconComponent",
             "headerCloseIconComponent",
@@ -22781,7 +23028,8 @@
             "classNames",
             "translations",
             "title",
-            "getSearchPageURL"
+            "getSearchPageURL",
+            "disableTriggerValidation"
         ]), _rest1 = _sliced_to_array(_rest, 1), ref = _rest1[0];
         var promptTranslations = translations.prompt, headerTranslations = translations.header, messageTranslations = translations.message, messagesTranslations = translations.messages;
         var _useInstantSearch = useInstantSearch(), indexUiState = _useInstantSearch.indexUiState, setIndexUiState = _useInstantSearch.setIndexUiState;
@@ -22799,8 +23047,14 @@
             itemComponent,
             userTools
         ]);
+        // Inline layouts are always visible, so they don't require a `<ChatTrigger />`
+        // (or AI mode) to be present. We detect this via a `$$inlineLayout` marker
+        // set on the layout component, which is consistent across flavors.
+        var isInlineLayoutComponent = typeof layoutComponent === 'function' && layoutComponent.$$inlineLayout === true;
+        var effectiveDisableTriggerValidation = disableTriggerValidation || isInlineLayoutComponent;
         var chatState = useChat(_object_spread_props(_object_spread({}, props), {
-            tools: tools
+            tools: tools,
+            disableTriggerValidation: effectiveDisableTriggerValidation
         }));
         var messages = chatState.messages, sendMessage = chatState.sendMessage, status = chatState.status, regenerate = chatState.regenerate, stop = chatState.stop, error = chatState.error, input = chatState.input, setInput = chatState.setInput, open = chatState.open, setOpen = chatState.setOpen, isClearing = chatState.isClearing, clearMessages = chatState.clearMessages, onClearTransitionEnd = chatState.onClearTransitionEnd, toolsFromConnector = chatState.tools, suggestions = chatState.suggestions, onFeedback = chatState.sendChatMessageFeedback, feedbackState = chatState.feedbackState;
         React.useImperativeHandle(ref, function() {
@@ -22839,15 +23093,7 @@
             layoutComponent: layoutComponent,
             headerComponent: headerComponent,
             promptComponent: promptComponent,
-            toggleButtonComponent: toggleButtonComponent,
             suggestionsComponent: suggestionsComponent,
-            toggleButtonProps: _object_spread({
-                open: open,
-                onClick: function onClick() {
-                    return setOpen(!open);
-                },
-                toggleIconComponent: toggleButtonIconComponent
-            }, toggleButtonProps),
             headerProps: _object_spread({
                 onClose: function onClose() {
                     return setOpen(false);
@@ -22864,13 +23110,14 @@
                 maximizeIconComponent: headerMaximizeIconComponent,
                 translations: headerTranslations
             }, headerProps),
-            messagesProps: _object_spread({
+            messagesProps: _object_spread_props(_object_spread({
                 status: status,
                 onReload: function onReload(messageId) {
                     return regenerate({
                         messageId: messageId
                     });
                 },
+                onNewConversation: clearMessages,
                 onClose: function onClose() {
                     return setOpen(false);
                 },
@@ -22902,7 +23149,9 @@
                 }, messagesProps === null || messagesProps === void 0 ? void 0 : messagesProps.userMessageProps),
                 translations: messagesTranslations,
                 messageTranslations: messageTranslations
-            }, messagesProps),
+            }, messagesProps), {
+                error: error
+            }),
             promptProps: _object_spread({
                 promptRef: promptRef,
                 status: status,
@@ -22936,6 +23185,38 @@
     }
     var Chat = /*#__PURE__*/ React.forwardRef(ChatInner);
 
+    var ChatToggleButton = createChatToggleButtonComponent({
+        createElement: React.createElement,
+        Fragment: React.Fragment
+    });
+    function ChatTrigger(_0) {
+        var classNames = _0.classNames, toggleIconComponent = _0.toggleIconComponent, onClick = _0.onClick, _0_floating = _0.floating, floating = _0_floating === void 0 ? true : _0_floating, props = _object_without_properties(_0, [
+            "classNames",
+            "toggleIconComponent",
+            "onClick",
+            "floating"
+        ]);
+        var _useChatTrigger = useChatTrigger({}, {
+            $$widgetType: 'ais.chatTrigger'
+        }), open = _useChatTrigger.open, toggleOpen = _useChatTrigger.toggleOpen;
+        var handleClick = function handleClick() {
+            toggleOpen();
+            onClick === null || onClick === void 0 ? void 0 : onClick();
+        };
+        var rootClassName = [
+            floating && 'ais-ChatToggleButton--floating',
+            classNames === null || classNames === void 0 ? void 0 : classNames.root
+        ].filter(Boolean).flat();
+        return /*#__PURE__*/ React.createElement(ChatToggleButton, _object_spread({
+            open: open,
+            onClick: handleClick,
+            classNames: _object_spread_props(_object_spread({}, classNames), {
+                root: rootClassName
+            }),
+            toggleIconComponent: toggleIconComponent
+        }, props));
+    }
+
     function ClearRefinements$1(_0) {
         var _0_classNames = _0.classNames, classNames = _0_classNames === void 0 ? {} : _0_classNames, _0_disabled = _0.disabled, disabled = _0_disabled === void 0 ? false : _0_disabled, _0_onClick = _0.onClick, onClick = _0_onClick === void 0 ? function() {} : _0_onClick, translations = _0.translations, props = _object_without_properties(_0, [
             "classNames",
@@ -24298,9 +24579,11 @@
         ]);
         var _useSearchBox = useSearchBox({
             queryHook: queryHook
-        }, {
+        }, _object_spread({
             $$widgetType: 'ais.searchBox'
-        }), query = _useSearchBox.query, refine = _useSearchBox.refine, isSearchStalled = _useSearchBox.isSearchStalled;
+        }, aiMode ? {
+            opensChat: true
+        } : {})), query = _useSearchBox.query, refine = _useSearchBox.refine, isSearchStalled = _useSearchBox.isSearchStalled;
         var indexRenderState = useInstantSearch().indexRenderState;
         var _useState = _sliced_to_array(React.useState(query), 2), inputValue = _useState[0], setInputValue = _useState[1];
         var inputRef = React.useRef(null);
@@ -24712,6 +24995,7 @@
     exports.ChatMessageLoader = ChatMessageLoader;
     exports.ChatOverlayLayout = ChatOverlayLayout;
     exports.ChatSidePanelLayout = ChatSidePanelLayout;
+    exports.ChatTrigger = ChatTrigger;
     exports.ClearRefinements = ClearRefinements;
     exports.Configure = Configure;
     exports.CurrentRefinements = CurrentRefinements;
@@ -24757,6 +25041,7 @@
     exports.useAutocomplete = useAutocomplete;
     exports.useBreadcrumb = useBreadcrumb;
     exports.useChat = useChat;
+    exports.useChatTrigger = useChatTrigger;
     exports.useClearRefinements = useClearRefinements;
     exports.useConfigure = useConfigure;
     exports.useConnector = useConnector;