react-instantsearch-core 7.45.0 → 7.46.0

package/dist/umd/ReactInstantSearchCore.js

@@ -1,4 +1,4 @@
-/*! React InstantSearch Core 7.45.0 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
+/*! React InstantSearch Core 7.46.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.45.0';
+    var version$2 = '7.46.0';
 
     function _define_property(obj, key, value) {
         if (key in obj) {
@@ -9249,7 +9249,7 @@
         });
     }
 
-    var version = '4.112.0';
+    var version = '4.113.0';
 
     var ANONYMOUS_TOKEN_COOKIE_KEY = '_ALGOLIA';
     function getCookie(name) {
@@ -12451,6 +12451,31 @@
     var isPartTool = function isPartTool(part) {
         return startsWith(part.type, 'tool-');
     };
+    var TOOL_PART_PREFIX = 'tool-';
+    /**
+     * Resolves the tool a message part belongs to, from either a part type
+     * (`tool-algolia_search_index`) or a bare tool name.
+     *
+     * Generic over the tool shape so the renderer, the loader and the connector —
+     * which hold different subsets of the tool contract — all resolve names the same
+     * way.
+     */ var findTool = function findTool(partType, tools) {
+        var toolName = startsWith(partType, TOOL_PART_PREFIX) ? partType.slice(TOOL_PART_PREFIX.length) : partType;
+        if (tools[toolName]) {
+            return tools[toolName];
+        }
+        // Compatibility shim for tool names suffixed by the index name, as the Algolia
+        // MCP Server does (`algolia_search_index_products`). The longest matching key
+        // wins, so registering both `foo` and `foo_bar` resolves `foo_bar_products` to
+        // `foo_bar` — otherwise the winner would depend on registration order.
+        var match;
+        Object.keys(tools).forEach(function(key) {
+            if (startsWith(toolName, "".concat(key, "_")) && (match === undefined || key.length > match.length)) {
+                match = key;
+            }
+        });
+        return match === undefined ? undefined : tools[match];
+    };
 
     var createRecords = function createRecords() {
         return Object.create(null);
@@ -12506,75 +12531,11 @@
         return store;
     }
 
-    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;
-    };
+    function flat(arr) {
+        return arr.reduce(function(acc, array) {
+            return acc.concat(array);
+        }, []);
+    }
 
     /**
      * Stream parser for parsing SSE (Server-Sent Events) streams.
@@ -12863,8 +12824,268 @@
         } catch (unused) {
         // Not JSON — caller falls back to its own default.
         }
-        return undefined;
-    }
+        return undefined;
+    }
+
+    /**
+     * 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() {
+        function HttpChatTransport(param) {
+            var _param_api = param.api, api = _param_api === void 0 ? '/api/chat' : _param_api, credentials = param.credentials, headers = param.headers, body = param.body, customFetch = param.fetch, prepareSendMessagesRequest = param.prepareSendMessagesRequest, prepareReconnectToStreamRequest = param.prepareReconnectToStreamRequest;
+            _class_call_check(this, HttpChatTransport);
+            _define_property(this, "api", void 0);
+            _define_property(this, "credentials", void 0);
+            _define_property(this, "headers", void 0);
+            _define_property(this, "body", void 0);
+            _define_property(this, "fetch", void 0);
+            _define_property(this, "prepareSendMessagesRequest", void 0);
+            _define_property(this, "prepareReconnectToStreamRequest", void 0);
+            this.api = api;
+            this.credentials = credentials;
+            this.headers = headers;
+            this.body = body;
+            this.fetch = customFetch;
+            this.prepareSendMessagesRequest = prepareSendMessagesRequest;
+            this.prepareReconnectToStreamRequest = prepareReconnectToStreamRequest;
+        }
+        _create_class(HttpChatTransport, [
+            {
+                key: "sendMessages",
+                value: function sendMessages(param) {
+                    var _this = this;
+                    var abortSignal = param.abortSignal, chatId = param.chatId, messages = param.messages, requestMetadata = param.requestMetadata, trigger = param.trigger, messageId = param.messageId, requestHeaders = param.headers, requestBody = param.body;
+                    var _this_fetch;
+                    var fetchFn = (_this_fetch = this.fetch) !== null && _this_fetch !== void 0 ? _this_fetch : fetch;
+                    // Resolve configurable values
+                    return Promise.all([
+                        resolveValue(this.credentials),
+                        resolveValue(this.headers),
+                        resolveValue(this.body)
+                    ]).then(function(param) {
+                        var _param = _sliced_to_array(param, 3), resolvedCredentials = _param[0], resolvedHeaders = _param[1], resolvedBody = _param[2];
+                        // Build default request options
+                        var api = _this.api;
+                        var body = _object_spread({
+                            id: chatId,
+                            messages: messages
+                        }, resolvedBody, requestBody);
+                        var headers = _object_spread({
+                            'Content-Type': 'application/json'
+                        }, _instanceof(resolvedHeaders, Headers) ? Object.fromEntries(resolvedHeaders.entries()) : resolvedHeaders, _instanceof(requestHeaders, Headers) ? Object.fromEntries(requestHeaders.entries()) : requestHeaders);
+                        var credentials = resolvedCredentials;
+                        // Apply custom preparation if provided
+                        var prepareRequestBody = _object_spread({}, resolvedBody, requestBody);
+                        var preparePromise = _this.prepareSendMessagesRequest ? Promise.resolve(_this.prepareSendMessagesRequest({
+                            id: chatId,
+                            messages: messages,
+                            requestMetadata: requestMetadata,
+                            body: prepareRequestBody,
+                            credentials: resolvedCredentials,
+                            headers: resolvedHeaders,
+                            api: _this.api,
+                            trigger: trigger,
+                            messageId: messageId
+                        })) : Promise.resolve(null);
+                        return preparePromise.then(function(prepared) {
+                            if (prepared) {
+                                body = prepared.body;
+                                if (prepared.api) api = prepared.api;
+                                if (prepared.headers) {
+                                    headers = _object_spread({
+                                        'Content-Type': 'application/json'
+                                    }, _instanceof(prepared.headers, Headers) ? Object.fromEntries(prepared.headers.entries()) : prepared.headers);
+                                }
+                                if (prepared.credentials) credentials = prepared.credentials;
+                            }
+                            return fetchFn(api, {
+                                method: 'POST',
+                                headers: headers,
+                                body: JSON.stringify(body),
+                                signal: abortSignal,
+                                credentials: credentials
+                            }).then(function(response) {
+                                if (!response.ok) {
+                                    return getHttpErrorMessage(response).then(function(message) {
+                                        throw new Error(message);
+                                    });
+                                }
+                                if (!response.body) {
+                                    throw new Error('Response body is empty');
+                                }
+                                return _this.processResponseStream(response.body);
+                            });
+                        });
+                    });
+                }
+            },
+            {
+                key: "reconnectToStream",
+                value: function reconnectToStream(param) {
+                    var _this = this;
+                    var chatId = param.chatId, requestHeaders = param.headers, requestBody = param.body;
+                    var _this_fetch;
+                    var fetchFn = (_this_fetch = this.fetch) !== null && _this_fetch !== void 0 ? _this_fetch : fetch;
+                    // Resolve configurable values
+                    return Promise.all([
+                        resolveValue(this.credentials),
+                        resolveValue(this.headers),
+                        resolveValue(this.body)
+                    ]).then(function(param) {
+                        var _param = _sliced_to_array(param, 3), resolvedCredentials = _param[0], resolvedHeaders = _param[1], resolvedBody = _param[2];
+                        // Build default request options
+                        var api = _this.api;
+                        var headers = _object_spread({}, _instanceof(resolvedHeaders, Headers) ? Object.fromEntries(resolvedHeaders.entries()) : resolvedHeaders, _instanceof(requestHeaders, Headers) ? Object.fromEntries(requestHeaders.entries()) : requestHeaders);
+                        var credentials = resolvedCredentials;
+                        // Apply custom preparation if provided
+                        var prepareRequestBody = _object_spread({}, resolvedBody, requestBody);
+                        var preparePromise = _this.prepareReconnectToStreamRequest ? Promise.resolve(_this.prepareReconnectToStreamRequest({
+                            id: chatId,
+                            requestMetadata: undefined,
+                            body: prepareRequestBody,
+                            credentials: resolvedCredentials,
+                            headers: resolvedHeaders,
+                            api: _this.api
+                        })) : Promise.resolve(null);
+                        return preparePromise.then(function(prepared) {
+                            if (prepared) {
+                                if (prepared.api) api = prepared.api;
+                                if (prepared.headers) {
+                                    headers = _instanceof(prepared.headers, Headers) ? Object.fromEntries(prepared.headers.entries()) : prepared.headers;
+                                }
+                                if (prepared.credentials) credentials = prepared.credentials;
+                            }
+                            // GET request for reconnection
+                            return fetchFn("".concat(api, "?chatId=").concat(chatId), {
+                                method: 'GET',
+                                headers: headers,
+                                credentials: credentials
+                            }).then(function(response) {
+                                if (!response.ok) {
+                                    // 404 means no stream to reconnect to, which is not an error
+                                    if (response.status === 404) {
+                                        return null;
+                                    }
+                                    return getHttpErrorMessage(response).then(function(message) {
+                                        throw new Error(message);
+                                    });
+                                }
+                                if (!response.body) {
+                                    return null;
+                                }
+                                return _this.processResponseStream(response.body);
+                            });
+                        });
+                    });
+                }
+            }
+        ]);
+        return HttpChatTransport;
+    }();
+    /**
+     * Default chat transport implementation using NDJSON streaming.
+     */ var DefaultChatTransport = /*#__PURE__*/ function(HttpChatTransport) {
+        _inherits(DefaultChatTransport, HttpChatTransport);
+        function DefaultChatTransport() {
+            var options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+            _class_call_check(this, DefaultChatTransport);
+            return _call_super(this, DefaultChatTransport, [
+                options
+            ]);
+        }
+        _create_class(DefaultChatTransport, [
+            {
+                key: "processResponseStream",
+                value: function processResponseStream(stream) {
+                    return parseJsonEventStream(stream);
+                }
+            }
+        ]);
+        return DefaultChatTransport;
+    }(HttpChatTransport);
+
+    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;
+    };
 
     var _computedKey$1;
     var defaultGuardrailFallbackResponse = 'Sorry, we are not able to generate a response at the moment.';
@@ -14327,285 +14548,44 @@
                 key: "messages",
                 get: function get() {
                     return this._messages;
-                },
-                set: function set(newMessages) {
-                    this._messages = _to_consumable_array(newMessages);
-                    this._callMessagesCallbacks();
-                }
-            }
-        ]);
-        return ChatState;
-    }();
-    _computedKey3 = '~registerMessagesCallback', _computedKey4 = '~registerStatusCallback', _computedKey5 = '~registerErrorCallback';
-    var _computedKey9 = _computedKey3, _computedKey10 = _computedKey4, _computedKey11 = _computedKey5;
-    var Chat = /*#__PURE__*/ function(AbstractChat) {
-        _inherits(Chat, AbstractChat);
-        function Chat(_0) {
-            _class_call_check(this, Chat);
-            var _this;
-            var messages = _0.messages, agentId = _0.agentId, _0_persistence = _0.persistence, persistence = _0_persistence === void 0 ? true : _0_persistence, init = _object_without_properties(_0, [
-                "messages",
-                "agentId",
-                "persistence"
-            ]);
-            var state = new ChatState(agentId, messages, persistence);
-            _this = _call_super(this, Chat, [
-                _object_spread_props(_object_spread({}, init), {
-                    state: state
-                })
-            ]), _define_property(_this, "_state", void 0), _define_property(_this, _computedKey9, function(onChange) {
-                return _this._state['~registerMessagesCallback'](onChange);
-            }), _define_property(_this, _computedKey10, function(onChange) {
-                return _this._state['~registerStatusCallback'](onChange);
-            }), _define_property(_this, _computedKey11, function(onChange) {
-                return _this._state['~registerErrorCallback'](onChange);
-            });
-            _this._state = state;
-            return _this;
-        }
-        return Chat;
-    }(AbstractChat);
-
-    // Centralizes the "open the chat from an entry point" behavior shared by the
-    // SearchBox AI button, the Autocomplete AI button, prompt suggestions, and any
-    // future entry point. The chat is always opened; the message is only sent when
-    // 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, turnContext = _ref.turnContext;
-        var _ref1;
-        var _chatRenderState_setOpen;
-        if (!chatRenderState) {
-            return false;
-        }
-        var trimmed = (_ref1 = message === null || message === void 0 ? void 0 : message.trim()) !== null && _ref1 !== void 0 ? _ref1 : '';
-        if (!trimmed) {
-            if (chatRenderState.focusInput) {
-                chatRenderState.focusInput();
-            } else {
-                var _chatRenderState_setOpen1;
-                (_chatRenderState_setOpen1 = chatRenderState.setOpen) === null || _chatRenderState_setOpen1 === void 0 ? void 0 : _chatRenderState_setOpen1.call(chatRenderState, true);
-            }
-            return false;
-        }
-        (_chatRenderState_setOpen = chatRenderState.setOpen) === null || _chatRenderState_setOpen === void 0 ? void 0 : _chatRenderState_setOpen.call(chatRenderState, true);
-        if (isChatBusy(chatRenderState) || !chatRenderState.sendMessage) {
-            return false;
-        }
-        chatRenderState.sendMessage(_object_spread({
-            text: trimmed
-        }, turnContext ? {
-            metadata: {
-                turnContext: turnContext
-            }
-        } : {}), referer ? {
-            headers: {
-                'x-algolia-referer': referer
-            }
-        } : undefined);
-        return true;
-    }
-    function isChatBusy(chatRenderState) {
-        return (chatRenderState === null || chatRenderState === void 0 ? void 0 : chatRenderState.status) === 'submitted' || (chatRenderState === null || chatRenderState === void 0 ? void 0 : chatRenderState.status) === 'streaming';
-    }
-
-    var SearchIndexToolType = 'algolia_search_index';
-
-    function flat(arr) {
-        return arr.reduce(function(acc, array) {
-            return acc.concat(array);
-        }, []);
-    }
-
-    /**
-     * Reads a human-readable message from a failed HTTP response body when the
-     * server returns JSON such as `{ "message": "..." }` (the shared
-     * `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() {
-        function HttpChatTransport(param) {
-            var _param_api = param.api, api = _param_api === void 0 ? '/api/chat' : _param_api, credentials = param.credentials, headers = param.headers, body = param.body, customFetch = param.fetch, prepareSendMessagesRequest = param.prepareSendMessagesRequest, prepareReconnectToStreamRequest = param.prepareReconnectToStreamRequest;
-            _class_call_check(this, HttpChatTransport);
-            _define_property(this, "api", void 0);
-            _define_property(this, "credentials", void 0);
-            _define_property(this, "headers", void 0);
-            _define_property(this, "body", void 0);
-            _define_property(this, "fetch", void 0);
-            _define_property(this, "prepareSendMessagesRequest", void 0);
-            _define_property(this, "prepareReconnectToStreamRequest", void 0);
-            this.api = api;
-            this.credentials = credentials;
-            this.headers = headers;
-            this.body = body;
-            this.fetch = customFetch;
-            this.prepareSendMessagesRequest = prepareSendMessagesRequest;
-            this.prepareReconnectToStreamRequest = prepareReconnectToStreamRequest;
-        }
-        _create_class(HttpChatTransport, [
-            {
-                key: "sendMessages",
-                value: function sendMessages(param) {
-                    var _this = this;
-                    var abortSignal = param.abortSignal, chatId = param.chatId, messages = param.messages, requestMetadata = param.requestMetadata, trigger = param.trigger, messageId = param.messageId, requestHeaders = param.headers, requestBody = param.body;
-                    var _this_fetch;
-                    var fetchFn = (_this_fetch = this.fetch) !== null && _this_fetch !== void 0 ? _this_fetch : fetch;
-                    // Resolve configurable values
-                    return Promise.all([
-                        resolveValue(this.credentials),
-                        resolveValue(this.headers),
-                        resolveValue(this.body)
-                    ]).then(function(param) {
-                        var _param = _sliced_to_array(param, 3), resolvedCredentials = _param[0], resolvedHeaders = _param[1], resolvedBody = _param[2];
-                        // Build default request options
-                        var api = _this.api;
-                        var body = _object_spread({
-                            id: chatId,
-                            messages: messages
-                        }, resolvedBody, requestBody);
-                        var headers = _object_spread({
-                            'Content-Type': 'application/json'
-                        }, _instanceof(resolvedHeaders, Headers) ? Object.fromEntries(resolvedHeaders.entries()) : resolvedHeaders, _instanceof(requestHeaders, Headers) ? Object.fromEntries(requestHeaders.entries()) : requestHeaders);
-                        var credentials = resolvedCredentials;
-                        // Apply custom preparation if provided
-                        var prepareRequestBody = _object_spread({}, resolvedBody, requestBody);
-                        var preparePromise = _this.prepareSendMessagesRequest ? Promise.resolve(_this.prepareSendMessagesRequest({
-                            id: chatId,
-                            messages: messages,
-                            requestMetadata: requestMetadata,
-                            body: prepareRequestBody,
-                            credentials: resolvedCredentials,
-                            headers: resolvedHeaders,
-                            api: _this.api,
-                            trigger: trigger,
-                            messageId: messageId
-                        })) : Promise.resolve(null);
-                        return preparePromise.then(function(prepared) {
-                            if (prepared) {
-                                body = prepared.body;
-                                if (prepared.api) api = prepared.api;
-                                if (prepared.headers) {
-                                    headers = _object_spread({
-                                        'Content-Type': 'application/json'
-                                    }, _instanceof(prepared.headers, Headers) ? Object.fromEntries(prepared.headers.entries()) : prepared.headers);
-                                }
-                                if (prepared.credentials) credentials = prepared.credentials;
-                            }
-                            return fetchFn(api, {
-                                method: 'POST',
-                                headers: headers,
-                                body: JSON.stringify(body),
-                                signal: abortSignal,
-                                credentials: credentials
-                            }).then(function(response) {
-                                if (!response.ok) {
-                                    return getHttpErrorMessage(response).then(function(message) {
-                                        throw new Error(message);
-                                    });
-                                }
-                                if (!response.body) {
-                                    throw new Error('Response body is empty');
-                                }
-                                return _this.processResponseStream(response.body);
-                            });
-                        });
-                    });
-                }
-            },
-            {
-                key: "reconnectToStream",
-                value: function reconnectToStream(param) {
-                    var _this = this;
-                    var chatId = param.chatId, requestHeaders = param.headers, requestBody = param.body;
-                    var _this_fetch;
-                    var fetchFn = (_this_fetch = this.fetch) !== null && _this_fetch !== void 0 ? _this_fetch : fetch;
-                    // Resolve configurable values
-                    return Promise.all([
-                        resolveValue(this.credentials),
-                        resolveValue(this.headers),
-                        resolveValue(this.body)
-                    ]).then(function(param) {
-                        var _param = _sliced_to_array(param, 3), resolvedCredentials = _param[0], resolvedHeaders = _param[1], resolvedBody = _param[2];
-                        // Build default request options
-                        var api = _this.api;
-                        var headers = _object_spread({}, _instanceof(resolvedHeaders, Headers) ? Object.fromEntries(resolvedHeaders.entries()) : resolvedHeaders, _instanceof(requestHeaders, Headers) ? Object.fromEntries(requestHeaders.entries()) : requestHeaders);
-                        var credentials = resolvedCredentials;
-                        // Apply custom preparation if provided
-                        var prepareRequestBody = _object_spread({}, resolvedBody, requestBody);
-                        var preparePromise = _this.prepareReconnectToStreamRequest ? Promise.resolve(_this.prepareReconnectToStreamRequest({
-                            id: chatId,
-                            requestMetadata: undefined,
-                            body: prepareRequestBody,
-                            credentials: resolvedCredentials,
-                            headers: resolvedHeaders,
-                            api: _this.api
-                        })) : Promise.resolve(null);
-                        return preparePromise.then(function(prepared) {
-                            if (prepared) {
-                                if (prepared.api) api = prepared.api;
-                                if (prepared.headers) {
-                                    headers = _instanceof(prepared.headers, Headers) ? Object.fromEntries(prepared.headers.entries()) : prepared.headers;
-                                }
-                                if (prepared.credentials) credentials = prepared.credentials;
-                            }
-                            // GET request for reconnection
-                            return fetchFn("".concat(api, "?chatId=").concat(chatId), {
-                                method: 'GET',
-                                headers: headers,
-                                credentials: credentials
-                            }).then(function(response) {
-                                if (!response.ok) {
-                                    // 404 means no stream to reconnect to, which is not an error
-                                    if (response.status === 404) {
-                                        return null;
-                                    }
-                                    return getHttpErrorMessage(response).then(function(message) {
-                                        throw new Error(message);
-                                    });
-                                }
-                                if (!response.body) {
-                                    return null;
-                                }
-                                return _this.processResponseStream(response.body);
-                            });
-                        });
-                    });
+                },
+                set: function set(newMessages) {
+                    this._messages = _to_consumable_array(newMessages);
+                    this._callMessagesCallbacks();
                 }
             }
         ]);
-        return HttpChatTransport;
+        return ChatState;
     }();
-    /**
-     * Default chat transport implementation using NDJSON streaming.
-     */ var DefaultChatTransport = /*#__PURE__*/ function(HttpChatTransport) {
-        _inherits(DefaultChatTransport, HttpChatTransport);
-        function DefaultChatTransport() {
-            var options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
-            _class_call_check(this, DefaultChatTransport);
-            return _call_super(this, DefaultChatTransport, [
-                options
+    _computedKey3 = '~registerMessagesCallback', _computedKey4 = '~registerStatusCallback', _computedKey5 = '~registerErrorCallback';
+    var _computedKey9 = _computedKey3, _computedKey10 = _computedKey4, _computedKey11 = _computedKey5;
+    var Chat = /*#__PURE__*/ function(AbstractChat) {
+        _inherits(Chat, AbstractChat);
+        function Chat(_0) {
+            _class_call_check(this, Chat);
+            var _this;
+            var messages = _0.messages, agentId = _0.agentId, _0_persistence = _0.persistence, persistence = _0_persistence === void 0 ? true : _0_persistence, init = _object_without_properties(_0, [
+                "messages",
+                "agentId",
+                "persistence"
             ]);
+            var state = new ChatState(agentId, messages, persistence);
+            _this = _call_super(this, Chat, [
+                _object_spread_props(_object_spread({}, init), {
+                    state: state
+                })
+            ]), _define_property(_this, "_state", void 0), _define_property(_this, _computedKey9, function(onChange) {
+                return _this._state['~registerMessagesCallback'](onChange);
+            }), _define_property(_this, _computedKey10, function(onChange) {
+                return _this._state['~registerStatusCallback'](onChange);
+            }), _define_property(_this, _computedKey11, function(onChange) {
+                return _this._state['~registerErrorCallback'](onChange);
+            });
+            _this._state = state;
+            return _this;
         }
-        _create_class(DefaultChatTransport, [
-            {
-                key: "processResponseStream",
-                value: function processResponseStream(stream) {
-                    return parseJsonEventStream(stream);
-                }
-            }
-        ]);
-        return DefaultChatTransport;
-    }(HttpChatTransport);
+        return Chat;
+    }(AbstractChat);
 
     var withUsage$q = createDocumentationMessageGenerator({
         name: 'chat',
@@ -14735,11 +14715,6 @@
                 "requiresSearch"
             ]);
             var normalizedPersistence = normalizePersistence(persistence, 'chat' in options);
-            // Compatibility shim with Algolia MCP Server search tool, which suffixes
-            // the tool name with the index name (`searchIndex_products`).
-            var resolveTool = function resolveTool(toolName) {
-                return tools[toolName] || (toolName.startsWith("".concat(SearchIndexToolType, "_")) ? tools[SearchIndexToolType] : undefined);
-            };
             var _chatInstance;
             var input = '';
             var open = false;
@@ -14767,21 +14742,44 @@
                     return unsubscribe();
                 });
             };
-            // Extract suggestions from the last assistant message's data-suggestions part
-            var getSuggestionsFromMessages = function getSuggestionsFromMessages(messages) {
-                // Find the last assistant message (iterate from end)
-                var lastAssistantMessage = _to_consumable_array(messages).reverse().find(function(message) {
+            var findSuggestionsPart = function findSuggestionsPart(message) {
+                var _message_parts;
+                return message === null || message === void 0 ? void 0 : (_message_parts = message.parts) === null || _message_parts === void 0 ? void 0 : _message_parts.find(function(part) {
+                    var _part_data;
+                    return 'type' in part && part.type === 'data-suggestions' && 'data' in part && Array.isArray((_part_data = part.data) === null || _part_data === void 0 ? void 0 : _part_data.suggestions);
+                });
+            };
+            var findLastAssistantMessage = function findLastAssistantMessage(messages) {
+                return _to_consumable_array(messages).reverse().find(function(message) {
                     return message.role === 'assistant' && message.parts;
                 });
-                if (!(lastAssistantMessage === null || lastAssistantMessage === void 0 ? void 0 : lastAssistantMessage.parts)) {
-                    return undefined;
+            };
+            // Extract suggestions from the last assistant message's data-suggestions part
+            var getSuggestionsFromMessages = function getSuggestionsFromMessages(messages) {
+                var _findSuggestionsPart;
+                return (_findSuggestionsPart = findSuggestionsPart(findLastAssistantMessage(messages))) === null || _findSuggestionsPart === void 0 ? void 0 : _findSuggestionsPart.data.suggestions;
+            };
+            // "Still coming" has to be inferred: the turn is running and has no
+            // `data-suggestions` part yet. Expecting any at all needs evidence, or an
+            // agent that never sends them would sit under a placeholder forever.
+            var getSuggestionsStatus = function getSuggestionsStatus(messages) {
+                var _lastAssistantMessage_metadata;
+                var status = _chatInstance.status;
+                if (status !== 'submitted' && status !== 'streaming') {
+                    return 'idle';
                 }
-                // Find the data-suggestions part
-                var suggestionsPart = lastAssistantMessage.parts.find(function(part) {
-                    var _part_data;
-                    return 'type' in part && part.type === 'data-suggestions' && 'data' in part && Array.isArray((_part_data = part.data) === null || _part_data === void 0 ? void 0 : _part_data.suggestions);
+                var lastAssistantMessage = findLastAssistantMessage(messages);
+                if (findSuggestionsPart(lastAssistantMessage)) {
+                    return 'idle';
+                }
+                var declaresSuggestions = (lastAssistantMessage === null || lastAssistantMessage === void 0 ? void 0 : (_lastAssistantMessage_metadata = lastAssistantMessage.metadata) === null || _lastAssistantMessage_metadata === void 0 ? void 0 : _lastAssistantMessage_metadata.suggestionsEnabled) === true;
+                if (declaresSuggestions) {
+                    return 'loading';
+                }
+                var hasSuggestionsHistory = messages.some(function(message) {
+                    return message !== lastAssistantMessage && message.role === 'assistant' && Boolean(findSuggestionsPart(message));
                 });
-                return suggestionsPart === null || suggestionsPart === void 0 ? void 0 : suggestionsPart.data.suggestions;
+                return hasSuggestionsHistory ? 'loading' : 'idle';
             };
             var setMessages = function setMessages(messagesParam) {
                 if (typeof messagesParam === 'function') {
@@ -14924,14 +14922,14 @@
                     sendAutomaticallyWhen: sendAutomaticallyWhen,
                     transport: transport,
                     shouldRepairToolInput: function shouldRepairToolInput(toolName) {
-                        var tool = resolveTool(toolName);
+                        var tool = findTool(toolName, tools);
                         if (!tool) return true;
                         return Boolean(tool.streamInput);
                     },
                     resolveCancelledToolOutput: function resolveCancelledToolOutput(param) {
                         var toolName = param.toolName, toolCallId = param.toolCallId, input = param.input;
-                        var _resolveTool;
-                        var cancelOutput = (_resolveTool = resolveTool(toolName)) === null || _resolveTool === void 0 ? void 0 : _resolveTool.cancelOutput;
+                        var _findTool;
+                        var cancelOutput = (_findTool = findTool(toolName, tools)) === null || _findTool === void 0 ? void 0 : _findTool.cancelOutput;
                         if (!cancelOutput) return undefined;
                         try {
                             var output = cancelOutput({
@@ -14948,7 +14946,7 @@
                     },
                     onToolCall: function onToolCall(param, submitToolResult) {
                         var toolCall = param.toolCall;
-                        var tool = resolveTool(toolCall.toolName);
+                        var tool = findTool(toolCall.toolName, tools);
                         if (!tool) {
                             return submitToolResult({
                                 output: 'No tool implemented for "'.concat(toolCall.toolName, '".'),
@@ -15178,6 +15176,7 @@
                         '~isOpenStatePersistenceEnabled': normalizedPersistence.open,
                         setMessages: setMessages,
                         suggestions: getSuggestionsFromMessages(_chatInstance.messages),
+                        suggestionsStatus: getSuggestionsStatus(_chatInstance.messages),
                         clearMessages: clearMessages,
                         tools: toolsWithAddToolResult,
                         records: records,
@@ -15281,44 +15280,30 @@
         });
     }
 
-    function buildEndpoint(param) {
-        var appId = param.appId, agentId = param.agentId;
-        return "https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/tasks");
+    function isHeaders$1(headers) {
+        return !Array.isArray(headers) && 'entries' in headers && typeof headers.entries === 'function';
     }
-    function resolveEndpoint(params) {
-        if (params.transport) {
-            return {
-                endpoint: params.transport.api,
-                headers: params.transport.headers || {},
-                prepareSendMessagesRequest: params.transport.prepareSendMessagesRequest
-            };
+    function headersToRecord$1(headers) {
+        if (!headers) {
+            return {};
         }
-        if (!params.appId || !params.apiKey || !params.agentId) {
-            throw new Error('[tasks] Either `transport` or `{ appId, apiKey, agentId }` is required.');
+        if (isHeaders$1(headers)) {
+            return Object.fromEntries(headers.entries());
         }
-        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");
+        if (Array.isArray(headers)) {
+            return Object.fromEntries(headers);
         }
-        return {
-            endpoint: buildEndpoint({
-                appId: params.appId,
-                agentId: params.agentId
-            }),
-            headers: headers
-        };
+        return 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 withJsonContentType(headers) {
+        var merged = _object_spread({}, headersToRecord$1(headers));
+        Object.keys(merged).forEach(function(name) {
+            if (name.toLowerCase() === 'content-type') {
+                delete merged[name];
+            }
+        });
+        merged['Content-Type'] = 'application/json';
+        return merged;
     }
     function withStreamParam(url) {
         return url.includes('?') ? "".concat(url, "&stream=true") : "".concat(url, "?stream=true");
@@ -15326,6 +15311,40 @@
     function resolveStreamedOutput(data, previous) {
         return typeof data === 'string' ? parsePartialJson(data, previous) : data;
     }
+    function createTaskPreparationContext(context) {
+        function hideProperty(key) {
+            var value = context[key];
+            Object.defineProperty(context, key, {
+                configurable: true,
+                enumerable: false,
+                get: function get() {
+                    return value;
+                },
+                set: function set(nextValue) {
+                    Reflect.deleteProperty(context, key);
+                    Object.defineProperty(context, key, {
+                        configurable: true,
+                        enumerable: true,
+                        value: nextValue,
+                        writable: true
+                    });
+                }
+            });
+        }
+        // Rich metadata stays out of legacy body spreads until assigned as payload.
+        hideProperty('stream');
+        hideProperty('body');
+        hideProperty('credentials');
+        hideProperty('headers');
+        hideProperty('api');
+        return context;
+    }
+    function unwrap(envelope) {
+        if ((typeof envelope === "undefined" ? "undefined" : _type_of(envelope)) === 'object' && envelope !== null && 'output' in envelope) {
+            return envelope.output;
+        }
+        return undefined;
+    }
     function consumeTaskStream(body, onData) {
         return new Promise(function(resolve, reject) {
             var chunkStream = parseJsonEventStream(body);
@@ -15334,10 +15353,6 @@
                 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');
                 }
@@ -15353,48 +15368,207 @@
             }, 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);
+    /** Default HTTP transport for named Tasks requests and task-output streams. */ var DefaultTaskTransport = /*#__PURE__*/ function() {
+        function DefaultTaskTransport() {
+            var _ref = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {}, _ref_api = _ref.api, api = _ref_api === void 0 ? '/api/tasks' : _ref_api, credentials = _ref.credentials, headers = _ref.headers, body = _ref.body, customFetch = _ref.fetch, prepareSendMessagesRequest = _ref.prepareSendMessagesRequest;
+            _class_call_check(this, DefaultTaskTransport);
+            _define_property(this, "api", void 0);
+            _define_property(this, "credentials", void 0);
+            _define_property(this, "headers", void 0);
+            _define_property(this, "body", void 0);
+            _define_property(this, "fetch", void 0);
+            _define_property(this, "prepareSendMessagesRequest", void 0);
+            this.api = api;
+            this.credentials = credentials;
+            this.headers = headers;
+            this.body = body;
+            this.fetch = customFetch;
+            this.prepareSendMessagesRequest = prepareSendMessagesRequest;
+        }
+        _create_class(DefaultTaskTransport, [
+            {
+                key: "sendTask",
+                value: function sendTask(param) {
+                    var task = param.task, input = param.input, stream = param.stream, onData = param.onData;
+                    return this.sendTaskRequest({
+                        task: task,
+                        input: input,
+                        stream: stream,
+                        onData: onData ? function(data) {
+                            return onData(unwrap(data));
+                        } : undefined
+                    }).then(unwrap);
+                }
+            },
+            {
+                /** @internal */ key: "sendTaskRequest",
+                value: function sendTaskRequest(param) {
+                    var _this = this;
+                    var task = param.task, input = param.input, stream = param.stream, onData = param.onData;
+                    var _this_fetch;
+                    var fetchFn = (_this_fetch = this.fetch) !== null && _this_fetch !== void 0 ? _this_fetch : fetch;
+                    return Promise.all([
+                        resolveValue(this.credentials),
+                        resolveValue(this.headers),
+                        resolveValue(this.body)
+                    ]).then(function(param) {
+                        var _param = _sliced_to_array(param, 3), resolvedCredentials = _param[0], resolvedHeaders = _param[1], resolvedBody = _param[2];
+                        var api = _this.api;
+                        var credentials = resolvedCredentials;
+                        var headers = withJsonContentType(resolvedHeaders);
+                        var body = _object_spread({
+                            task: task,
+                            input: input
+                        }, resolvedBody);
+                        var preparedBody = resolvedBody ? _object_spread({}, resolvedBody) : undefined;
+                        var preparePromise = _this.prepareSendMessagesRequest ? Promise.resolve(_this.prepareSendMessagesRequest(createTaskPreparationContext({
+                            task: task,
+                            input: input,
+                            stream: stream,
+                            body: preparedBody,
+                            credentials: resolvedCredentials,
+                            headers: resolvedHeaders,
+                            api: _this.api
+                        }))) : Promise.resolve(null);
+                        return preparePromise.then(function(prepared) {
+                            if (prepared) {
+                                body = prepared.body;
+                                if (prepared.api) {
+                                    api = prepared.api;
+                                }
+                                if (prepared.credentials) {
+                                    credentials = prepared.credentials;
+                                }
+                                if (prepared.headers) {
+                                    headers = withJsonContentType(prepared.headers);
+                                }
+                            }
+                            var request = {
+                                method: 'POST',
+                                headers: headers,
+                                body: JSON.stringify(body)
+                            };
+                            if (credentials !== undefined) {
+                                request.credentials = credentials;
+                            }
+                            return fetchFn(stream ? withStreamParam(api) : api, request).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();
+                            });
+                        });
+                    });
+                }
             }
-            return response.json();
+        ]);
+        return DefaultTaskTransport;
+    }();
+
+    function buildEndpoint(param) {
+        var appId = param.appId, agentId = param.agentId;
+        return "https://".concat(appId, ".algolia.net/agent-studio/1/agents/").concat(agentId, "/tasks");
+    }
+    function isHeaders(headers) {
+        return !Array.isArray(headers) && 'entries' in headers && typeof headers.entries === 'function';
+    }
+    function headersToRecord(headers) {
+        if (!headers) {
+            return {};
+        }
+        if (isHeaders(headers)) {
+            return Object.fromEntries(headers.entries());
+        }
+        if (Array.isArray(headers)) {
+            return Object.fromEntries(headers);
+        }
+        return _object_spread({}, headers);
+    }
+    function mergeProtectedHeaders(headers, protectedHeaders) {
+        var merged = headersToRecord(headers);
+        Object.entries(protectedHeaders).forEach(function(param) {
+            var _param = _sliced_to_array(param, 2), protectedName = _param[0], value = _param[1];
+            Object.keys(merged).forEach(function(name) {
+                if (name.toLowerCase() === protectedName.toLowerCase()) {
+                    delete merged[name];
+                }
+            });
+            merged[protectedName] = value;
         });
+        return merged;
     }
-    function unwrap(envelope) {
-        return envelope === null || envelope === void 0 ? void 0 : envelope.output;
+    /** @internal */ function createTaskTransport(param) {
+        var _param_transport = param.transport, transport = _param_transport === void 0 ? {} : _param_transport, appId = param.appId, apiKey = param.apiKey, agentId = param.agentId, algoliaAgent = param.algoliaAgent;
+        var _transport_api;
+        if (!agentId) {
+            return new DefaultTaskTransport(transport);
+        }
+        if (!appId || !apiKey) {
+            throw new Error('[tasks] `appId` and `apiKey` are required when `agentId` is provided.');
+        }
+        var protectedHeaders = {
+            'x-algolia-application-id': appId,
+            'x-algolia-api-key': apiKey
+        };
+        if (algoliaAgent) {
+            protectedHeaders['x-algolia-agent'] = "".concat(algoliaAgent, "; tasks");
+        }
+        var originalPrepare = transport.prepareSendMessagesRequest;
+        var prepareSendMessagesRequest = originalPrepare ? function(request) {
+            return Promise.resolve(originalPrepare(request)).then(function(prepared) {
+                return _object_spread_props(_object_spread({}, prepared), {
+                    headers: prepared.headers ? mergeProtectedHeaders(prepared.headers, protectedHeaders) : undefined
+                });
+            });
+        } : undefined;
+        return new DefaultTaskTransport(_object_spread_props(_object_spread({}, transport), {
+            api: (_transport_api = transport.api) !== null && _transport_api !== void 0 ? _transport_api : buildEndpoint({
+                appId: appId,
+                agentId: agentId
+            }),
+            headers: function headers() {
+                return Promise.resolve(resolveValue(transport.headers)).then(function(headers) {
+                    return mergeProtectedHeaders(headers, protectedHeaders);
+                });
+            },
+            prepareSendMessagesRequest: prepareSendMessagesRequest
+        }));
     }
-    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;
+
+    function createTaskRunner(options) {
+        var task = options.task, _options_stream = options.stream, stream = _options_stream === void 0 ? true : _options_stream;
+        var transport;
+        if (options.transport !== undefined) {
+            transport = options.transport;
+        } else {
+            var prepareRequest = options.prepareRequest;
+            transport = new DefaultTaskTransport({
+                api: options.endpoint,
+                headers: options.headers,
+                fetch: options.fetch,
+                prepareSendMessagesRequest: prepareRequest ? function(param) {
+                    var requestTask = param.task, input = param.input;
+                    return prepareRequest({
+                        task: requestTask,
+                        input: input
+                    });
+                } : undefined
+            });
+        }
         return {
-            submit: function submit(variables) {
+            submit: function submit(input) {
                 var onData = (arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {}).onData;
-                var payload = buildTaskPayload({
+                return transport.sendTask({
                     task: task,
-                    input: variables,
-                    prepareRequest: prepareRequest
-                });
-                return fetchTask({
-                    endpoint: endpoint,
-                    headers: headers,
-                    payload: payload,
+                    input: input,
                     stream: stream,
-                    onData: onData ? function(partial) {
-                        return onData(unwrap(partial));
-                    } : undefined
-                }).then(unwrap);
+                    onData: onData
+                });
             }
         };
     }
@@ -15481,31 +15655,28 @@
                 $$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 {
+                    if (agentId) {
                         var _getAppIdAndApiKey = _sliced_to_array(getAppIdAndApiKey(instantSearchInstance.client), 2), appId = _getAppIdAndApiKey[0], apiKey = _getAppIdAndApiKey[1];
                         if (!appId || !apiKey) {
                             throw new Error(withUsage$p('Could not extract Algolia credentials from the search client.'));
                         }
-                        var resolved1 = resolveEndpoint({
+                        var taskTransport = createTaskTransport({
+                            transport: transport,
                             appId: appId,
                             apiKey: apiKey,
                             agentId: agentId,
                             algoliaAgent: getAlgoliaAgent(instantSearchInstance.client)
                         });
                         runner = createTaskRunner({
-                            endpoint: resolved1.endpoint,
-                            headers: resolved1.headers,
+                            transport: taskTransport,
+                            task: task,
+                            stream: stream
+                        });
+                    } else {
+                        runner = createTaskRunner({
+                            transport: createTaskTransport({
+                                transport: transport
+                            }),
                             task: task,
                             stream: stream
                         });
@@ -15532,6 +15703,49 @@
         };
     };
 
+    // Centralizes the "open the chat from an entry point" behavior shared by the
+    // SearchBox AI button, the Autocomplete AI button, prompt suggestions, and any
+    // future entry point. The chat is always opened; the message is only sent when
+    // 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, turnContext = _ref.turnContext;
+        var _ref1;
+        var _chatRenderState_setOpen;
+        if (!chatRenderState) {
+            return false;
+        }
+        var trimmed = (_ref1 = message === null || message === void 0 ? void 0 : message.trim()) !== null && _ref1 !== void 0 ? _ref1 : '';
+        if (!trimmed) {
+            if (chatRenderState.focusInput) {
+                chatRenderState.focusInput();
+            } else {
+                var _chatRenderState_setOpen1;
+                (_chatRenderState_setOpen1 = chatRenderState.setOpen) === null || _chatRenderState_setOpen1 === void 0 ? void 0 : _chatRenderState_setOpen1.call(chatRenderState, true);
+            }
+            return false;
+        }
+        (_chatRenderState_setOpen = chatRenderState.setOpen) === null || _chatRenderState_setOpen === void 0 ? void 0 : _chatRenderState_setOpen.call(chatRenderState, true);
+        if (isChatBusy(chatRenderState) || !chatRenderState.sendMessage) {
+            return false;
+        }
+        chatRenderState.sendMessage(_object_spread({
+            text: trimmed
+        }, turnContext ? {
+            metadata: {
+                turnContext: turnContext
+            }
+        } : {}), referer ? {
+            headers: {
+                'x-algolia-referer': referer
+            }
+        } : undefined);
+        return true;
+    }
+    function isChatBusy(chatRenderState) {
+        return (chatRenderState === null || chatRenderState === void 0 ? void 0 : chatRenderState.status) === 'submitted' || (chatRenderState === null || chatRenderState === void 0 ? void 0 : chatRenderState.status) === 'streaming';
+    }
+
     var withUsage$o = createDocumentationMessageGenerator({
         name: 'prompt-suggestions',
         connector: true
@@ -15773,14 +15987,24 @@
                 if (!latestRenderOptions) return;
                 renderOutward(latestRenderOptions);
             };
-            var tasksWidget = connectTasks(handleInnerRender, noop)(_object_spread_props(_object_spread({}, transport ? {
-                transport: transport
-            } : {
-                agentId: agentId
-            }), {
-                task: configurationId,
-                stream: true
-            }));
+            var tasksParams;
+            if (agentId) {
+                tasksParams = {
+                    agentId: agentId,
+                    transport: transport,
+                    task: configurationId,
+                    stream: true
+                };
+            } else if (transport) {
+                tasksParams = {
+                    transport: transport,
+                    task: configurationId,
+                    stream: true
+                };
+            } else {
+                throw new Error(withUsage$o('The `agentId` option is required unless a custom `transport` is provided.'));
+            }
+            var tasksWidget = connectTasks(handleInnerRender, noop)(tasksParams);
             return {
                 $$type: 'ais.promptSuggestions',
                 init: function init(initOptions) {