@crestapps/ai-chat-ui 1.0.0-preview.8 → 1.0.0-rc.1

package/dist/ai-chat.js

@@ -3,15 +3,18 @@
 ** Any changes made directly to this file will be overwritten next time its asset group is processed by Gulp.
 */
 
+var _excluded = ["placeholder"];
 function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
 function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
 function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
 function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
-function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
 function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
@@ -52,7 +55,7 @@ window.openAIChatManager = function () {
       minWidth: 320,
       minHeight: 420
     },
-    messageTemplate: "\n        <div class=\"ai-chat-messages\">\n            <div v-for=\"(message, index) in messages\" :key=\"'msg-' + index\" class=\"ai-chat-message-item\">\n                <div>\n                    <div v-if=\"message.role === 'user'\" class=\"ai-chat-msg-role ai-chat-msg-role-user\">{{ userLabel }}</div>\n                    <div v-else-if=\"message.role !== 'indicator'\" :class=\"getAssistantRoleClasses(message)\">\n                        <span :class=\"getAssistantIconClasses(message, index)\"><i :class=\"getAssistantIcon(message)\"></i></span>\n                        {{ getAssistantLabel(message) }}\n                    </div>\n                    <div class=\"ai-chat-message-body lh-base\">\n                        <h4 v-if=\"message.title\">{{ message.title }}</h4>\n                        <div v-html=\"message.htmlContent\"></div>\n                        <span class=\"message-buttons-container\" v-if=\"!isIndicator(message)\">\n                            <template v-if=\"metricsEnabled && message.role === 'assistant'\">\n                                <span class=\"ai-chat-message-assistant-feedback\" :data-message-id=\"message.id\">\n                                    <button class=\"btn btn-sm btn-link text-success p-0 me-2 button-message-toolbox rate-up-btn\" @click=\"rateMessage(message, true, $event)\" :title=\"thumbsUpTitle\">\n                                        <i class=\"fa-regular fa-thumbs-up\"></i>\n                                    </button>\n                                    <button class=\"btn btn-sm btn-link text-danger p-0 me-2 button-message-toolbox rate-down-btn\" @click=\"rateMessage(message, false, $event)\" :title=\"thumbsDownTitle\">\n                                        <i class=\"fa-regular fa-thumbs-down\"></i>\n                                    </button>\n                                </span>\n                            </template>\n                            <button v-if=\"textToSpeechEnabled && !isConversationMode && message.role === 'assistant' && !message.isStreaming\" class=\"btn btn-sm btn-link text-secondary p-0 me-1 button-message-toolbox\" :class=\"{ 'tts-playing': ttsPlayingMessageIndex === index }\" @click=\"toggleMessageTts(message, index)\" :title=\"ttsPlayingMessageIndex === index ? 'Pause audio' : 'Read aloud'\">\n                                <i :class=\"ttsPlayingMessageIndex === index ? 'fa-solid fa-circle-pause' : 'fa-solid fa-circle-play'\"></i>\n                            </button>\n                            <button class=\"btn btn-sm btn-link text-secondary p-0 button-message-toolbox\" @click=\"copyResponse(message.content)\" :title=\"copyTitle\">\n                                <i class=\"fa-solid fa-copy\"></i>\n                            </button>\n                        </span>\n                    </div>\n                </div>\n            </div>\n            <div v-for=\"notification in notifications\" :key=\"'notif-' + notification.type\" class=\"ai-chat-notification\" :class=\"'ai-chat-notification-' + (notification.type || 'info') + ' ' + (notification.cssClass || '')\">\n                <div class=\"ai-chat-notification-content\">\n                    <i v-if=\"notification.icon\" :class=\"notification.icon\" class=\"ai-chat-notification-icon\"></i>\n                    <span class=\"ai-chat-notification-text\">{{ notification.content }}</span>\n                    <button v-if=\"notification.dismissible\" class=\"btn btn-sm btn-link p-0 ms-2 ai-chat-notification-dismiss\" @click=\"dismissNotification(notification.type)\" title=\"Dismiss\">\n                        <i class=\"fa-solid fa-xmark\"></i>\n                    </button>\n                </div>\n                <div v-if=\"notification.actions && notification.actions.length\" class=\"ai-chat-notification-actions\">\n                    <button v-for=\"action in notification.actions\" :key=\"action.name\" class=\"btn btn-sm\" :class=\"action.cssClass || 'btn-outline-secondary'\" @click=\"handleNotificationAction(notification.type, action.name)\">\n                        <i v-if=\"action.icon\" :class=\"action.icon\" class=\"me-1\"></i>\n                        {{ action.label }}\n                    </button>\n                </div>\n            </div>\n        </div>\n    ",
+    messageTemplate: "\n        <div class=\"ai-chat-messages\">\n            <div v-for=\"(message, index) in messages\" :key=\"'msg-' + index\" class=\"ai-chat-message-item\">\n                <div>\n                    <div v-if=\"message.role === 'user'\" class=\"ai-chat-msg-role ai-chat-msg-role-user\">{{ userLabel }}</div>\n                    <div v-else-if=\"message.role !== 'indicator'\" :class=\"getAssistantRoleClasses(message)\">\n                        <span :class=\"getAssistantIconClasses(message, index)\"><i :class=\"getAssistantIcon(message)\"></i></span>\n                        {{ getAssistantLabel(message) }}\n                    </div>\n                    <div class=\"ai-chat-message-body lh-base\">\n                        <h4 v-if=\"message.title\">{{ message.title }}</h4>\n                        <div v-html=\"message.htmlContent\"></div>\n                        <ol v-if=\"message.citationReferences && message.citationReferences.length\" class=\"ai-chat-citation-list\">\n                            <li v-for=\"citation in message.citationReferences\" :key=\"'citation-' + (citation.referenceKey || citation.displayIndex)\" class=\"ai-chat-citation-item\">\n                                <a v-if=\"citation.link\" :href=\"citation.link\" :target=\"citation.isDownload ? null : '_blank'\" :rel=\"citation.isDownload ? null : 'noopener noreferrer'\">{{ citation.label }}</a>\n                                <span v-else>{{ citation.label }}</span>\n                            </li>\n                        </ol>\n                        <span class=\"message-buttons-container\" v-if=\"!isIndicator(message)\">\n                            <template v-if=\"metricsEnabled && message.role === 'assistant'\">\n                                <span class=\"ai-chat-message-assistant-feedback\" :data-message-id=\"message.id\">\n                                    <button class=\"btn btn-sm btn-link text-success p-0 me-2 button-message-toolbox rate-up-btn\" @click=\"rateMessage(message, true, $event)\" :title=\"thumbsUpTitle\">\n                                        <i class=\"fa-regular fa-thumbs-up\"></i>\n                                    </button>\n                                    <button class=\"btn btn-sm btn-link text-danger p-0 me-2 button-message-toolbox rate-down-btn\" @click=\"rateMessage(message, false, $event)\" :title=\"thumbsDownTitle\">\n                                        <i class=\"fa-regular fa-thumbs-down\"></i>\n                                    </button>\n                                </span>\n                            </template>\n                            <button v-if=\"textToSpeechEnabled && !isConversationMode && message.role === 'assistant' && !message.isStreaming\" class=\"btn btn-sm btn-link text-secondary p-0 me-1 button-message-toolbox\" :class=\"{ 'tts-playing': ttsPlayingMessageIndex === index }\" :data-tts-message-index=\"index\" @click=\"toggleMessageTts(message, index)\" :title=\"ttsPlayingMessageIndex === index ? 'Pause audio' : 'Read aloud'\">\n                                <i :class=\"ttsPlayingMessageIndex === index ? 'fa-solid fa-circle-pause' : 'fa-solid fa-circle-play'\"></i>\n                            </button>\n                            <button class=\"btn btn-sm btn-link text-secondary p-0 button-message-toolbox\" @click=\"copyResponse(message)\" :title=\"copyTitle\">\n                                <i class=\"fa-solid fa-copy\"></i>\n                            </button>\n                        </span>\n                    </div>\n                </div>\n            </div>\n            <div v-for=\"notification in notifications\" :key=\"'notif-' + notification.type\" class=\"ai-chat-notification\" :class=\"'ai-chat-notification-' + (notification.type || 'info') + ' ' + (notification.cssClass || '')\">\n                <div class=\"ai-chat-notification-content\">\n                    <i v-if=\"notification.icon\" :class=\"notification.icon\" class=\"ai-chat-notification-icon\"></i>\n                    <span class=\"ai-chat-notification-text\">{{ notification.content }}</span>\n                    <button v-if=\"notification.dismissible\" class=\"btn btn-sm btn-link p-0 ms-2 ai-chat-notification-dismiss\" @click=\"dismissNotification(notification.type)\" title=\"Dismiss\">\n                        <i class=\"fa-solid fa-xmark\"></i>\n                    </button>\n                </div>\n                <div v-if=\"notification.actions && notification.actions.length\" class=\"ai-chat-notification-actions\">\n                    <button v-for=\"action in notification.actions\" :key=\"action.name\" class=\"btn btn-sm\" :class=\"action.cssClass || 'btn-outline-secondary'\" @click=\"handleNotificationAction(notification.type, action.name)\">\n                        <i v-if=\"action.icon\" :class=\"action.icon\" class=\"me-1\"></i>\n                        {{ action.label }}\n                    </button>\n                </div>\n            </div>\n        </div>\n    ",
     indicatorTemplate: "\n        <div class=\"ai-chat-msg-role ai-chat-msg-role-assistant\">\n            <span class=\"ai-streaming-icon\"><i class=\"fa fa-robot\" style=\"display: inline-block;\"></i></span>\n            Assistant\n        </div>\n    "
   };
 
@@ -72,6 +75,42 @@ window.openAIChatManager = function () {
     span.textContent = text;
     return span.innerHTML;
   }
+  function containsFontAwesomePlaceholders(root) {
+    if (!root || root.nodeType !== 1) {
+      return false;
+    }
+    var selector = 'i[class*="fa-"],i.fa,i.fas,i.far,i.fab';
+    if (typeof root.matches === 'function' && root.matches(selector)) {
+      return true;
+    }
+    return typeof root.querySelector === 'function' && !!root.querySelector(selector);
+  }
+  function refreshFontAwesomeIcons(root) {
+    var fontAwesome = window.FontAwesome;
+    if (!containsFontAwesomePlaceholders(root) || !fontAwesome || !fontAwesome.dom || typeof fontAwesome.dom.i2svg !== 'function') {
+      return;
+    }
+    fontAwesome.dom.i2svg({
+      node: root
+    });
+  }
+  function observeFontAwesomeIcons(root) {
+    if (!root || typeof MutationObserver === 'undefined') {
+      return null;
+    }
+    var observer = new MutationObserver(function (mutations) {
+      mutations.forEach(function (mutation) {
+        mutation.addedNodes.forEach(function (node) {
+          refreshFontAwesomeIcons(node);
+        });
+      });
+    });
+    observer.observe(root, {
+      childList: true,
+      subtree: true
+    });
+    return observer;
+  }
   function parsePixelValue(value) {
     if (typeof value === 'number' && Number.isFinite(value)) {
       return value;
@@ -86,16 +125,30 @@ window.openAIChatManager = function () {
     return Math.min(Math.max(value, min), max);
   }
   function normalizeReference(reference) {
-    var _ref, _normalized$index, _ref2, _normalized$text, _ref3, _normalized$link;
+    var _ref, _normalized$index, _ref2, _normalized$text, _ref3, _normalized$title, _ref4, _normalized$link, _ref5, _normalized$reference;
     if (!reference || _typeof(reference) !== 'object') {
       return null;
     }
     var normalized = Object.assign({}, reference);
     normalized.index = (_ref = (_normalized$index = normalized.index) !== null && _normalized$index !== void 0 ? _normalized$index : normalized.Index) !== null && _ref !== void 0 ? _ref : 0;
     normalized.text = (_ref2 = (_normalized$text = normalized.text) !== null && _normalized$text !== void 0 ? _normalized$text : normalized.Text) !== null && _ref2 !== void 0 ? _ref2 : null;
-    normalized.link = (_ref3 = (_normalized$link = normalized.link) !== null && _normalized$link !== void 0 ? _normalized$link : normalized.Link) !== null && _ref3 !== void 0 ? _ref3 : null;
+    normalized.title = (_ref3 = (_normalized$title = normalized.title) !== null && _normalized$title !== void 0 ? _normalized$title : normalized.Title) !== null && _ref3 !== void 0 ? _ref3 : null;
+    normalized.link = sanitizeUrl((_ref4 = (_normalized$link = normalized.link) !== null && _normalized$link !== void 0 ? _normalized$link : normalized.Link) !== null && _ref4 !== void 0 ? _ref4 : null);
+    normalized.referenceType = (_ref5 = (_normalized$reference = normalized.referenceType) !== null && _normalized$reference !== void 0 ? _normalized$reference : normalized.ReferenceType) !== null && _ref5 !== void 0 ? _ref5 : null;
     return normalized;
   }
+  function isDownloadCitationReference(reference) {
+    if (!reference || _typeof(reference) !== 'object') {
+      return false;
+    }
+    if (typeof reference.referenceType === 'string' && reference.referenceType.toLowerCase() === 'document') {
+      return true;
+    }
+    if (typeof reference.link === 'string' && /\/ai\/documents\/.+\/download(?:$|\?)/i.test(reference.link)) {
+      return true;
+    }
+    return false;
+  }
   function normalizeReferences(references) {
     if (!references || _typeof(references) !== 'object') {
       return {};
@@ -110,6 +163,125 @@ window.openAIChatManager = function () {
     }
     return normalized;
   }
+  function getCitationLabel(reference, key) {
+    return reference.title || reference.text || key;
+  }
+  function buildCitationDisplay(content, references) {
+    var processedContent = (content || '').trim();
+    var messageReferences = normalizeReferences(references);
+    if (!processedContent || !Object.keys(messageReferences).length) {
+      return {
+        content: processedContent,
+        citations: []
+      };
+    }
+    var citedRefs = Object.entries(messageReferences).filter(function (_ref6) {
+      var _ref7 = _slicedToArray(_ref6, 1),
+        key = _ref7[0];
+      return processedContent.includes(key);
+    });
+    if (!citedRefs.length) {
+      return {
+        content: processedContent,
+        citations: []
+      };
+    }
+    citedRefs.sort(function (_ref8, _ref9) {
+      var _ref0 = _slicedToArray(_ref8, 2),
+        a = _ref0[1];
+      var _ref1 = _slicedToArray(_ref9, 2),
+        b = _ref1[1];
+      return a.index - b.index;
+    });
+    var citations = [];
+    var displayIndex = 1;
+    var _iterator = _createForOfIteratorHelper(citedRefs),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var _step$value = _slicedToArray(_step.value, 2),
+          key = _step$value[0],
+          value = _step$value[1];
+        var placeholder = "__CITE_".concat(displayIndex, "_").concat(value.index || displayIndex, "__");
+        processedContent = processedContent.replaceAll(key, placeholder);
+        citations.push({
+          referenceKey: key,
+          displayIndex: displayIndex,
+          label: getCitationLabel(value, key),
+          link: value.link || null,
+          isDownload: isDownloadCitationReference(value),
+          placeholder: placeholder
+        });
+        displayIndex++;
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+    for (var _i2 = 0, _citations = citations; _i2 < _citations.length; _i2++) {
+      var citation = _citations[_i2];
+      processedContent = processedContent.replaceAll(citation.placeholder, "<sup>".concat(citation.displayIndex, "</sup>"));
+    }
+    processedContent = processedContent.replaceAll('</sup><sup>', '</sup><sup>,</sup><sup>');
+    return {
+      content: processedContent,
+      citations: citations.map(function (_ref10) {
+        var placeholder = _ref10.placeholder,
+          citation = _objectWithoutProperties(_ref10, _excluded);
+        return citation;
+      })
+    };
+  }
+  function buildCopyContent(content, citations) {
+    var copyContent = (content || '').trim();
+    if (!copyContent || !Array.isArray(citations) || citations.length === 0) {
+      return copyContent;
+    }
+    var _iterator2 = _createForOfIteratorHelper(citations),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var citation = _step2.value;
+        copyContent = copyContent.replaceAll(citation.referenceKey, "[".concat(citation.displayIndex, "]"));
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+    copyContent += '\n\nReferences:\n';
+    var _iterator3 = _createForOfIteratorHelper(citations),
+      _step3;
+    try {
+      for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+        var _citation = _step3.value;
+        copyContent += "".concat(_citation.displayIndex, ". ").concat(_citation.label);
+        if (_citation.link) {
+          copyContent += " - ".concat(_citation.link);
+        }
+        copyContent += '\n';
+      }
+    } catch (err) {
+      _iterator3.e(err);
+    } finally {
+      _iterator3.f();
+    }
+    return copyContent.trimEnd();
+  }
+  function updateMessagePresentation(message, references) {
+    var messageReferences = normalizeReferences(references !== null && references !== void 0 ? references : message.references);
+    var rawContent = typeof message.rawContent === 'string' ? message.rawContent : typeof message.content === 'string' ? message.content : '';
+    var citationDisplay = buildCitationDisplay(rawContent, messageReferences);
+    message.rawContent = rawContent;
+    message.content = rawContent;
+    message.displayContent = citationDisplay.content;
+    message.references = messageReferences;
+    message.citationReferences = citationDisplay.citations;
+    message.copyContent = buildCopyContent(rawContent, citationDisplay.citations);
+    message.htmlContent = parseMarkdownContent(citationDisplay.content, message);
+    return message;
+  }
   var renderer = new marked.Renderer();
 
   // Modify the link rendering to open in a new tab
@@ -275,17 +447,17 @@ window.openAIChatManager = function () {
     // Defer to requestAnimationFrame so the browser has fully laid out the
     // canvas elements before Chart.js reads their dimensions.
     requestAnimationFrame(function () {
-      var _iterator = _createForOfIteratorHelper(charts),
-        _step;
+      var _iterator4 = _createForOfIteratorHelper(charts),
+        _step4;
       try {
-        for (_iterator.s(); !(_step = _iterator.n()).done;) {
-          var c = _step.value;
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var c = _step4.value;
           renderChartOnCanvas(c.chartId, c.config);
         }
       } catch (err) {
-        _iterator.e(err);
+        _iterator4.e(err);
       } finally {
-        _iterator.f();
+        _iterator4.f();
       }
     });
   }
@@ -338,8 +510,8 @@ window.openAIChatManager = function () {
       return;
     }
     requestAnimationFrame(function () {
-      for (var _i2 = 0, _Object$keys = Object.keys(configs); _i2 < _Object$keys.length; _i2++) {
-        var chartId = _Object$keys[_i2];
+      for (var _i3 = 0, _Object$keys = Object.keys(configs); _i3 < _Object$keys.length; _i3++) {
+        var chartId = _Object$keys[_i3];
         renderChartOnCanvas(chartId, configs[chartId]);
       }
     });
@@ -363,6 +535,7 @@ window.openAIChatManager = function () {
     var config = Object.assign({}, defaultConfig, instanceConfig);
     config.widget = Object.assign({}, defaultConfig.widget || {}, instanceConfig && instanceConfig.widget ? instanceConfig.widget : {});
     var hasWidgetConfig = !!(instanceConfig && instanceConfig.widget && instanceConfig.widget.chatWidgetContainer && instanceConfig.widget.chatWidgetStateName);
+    var widgetBehavior = window.openAIChatWidgetBehavior || null;
     // Keep defaultConfig in sync so renderers use overridden values
     defaultConfig = config;
     if (!config.signalRHubUrl) {
@@ -385,7 +558,7 @@ window.openAIChatManager = function () {
       console.error('The sendButtonElementSelector is required.');
       return;
     }
-    var app = Vue.createApp({
+    var appDefinition = {
       data: function data() {
         return {
           inputElement: null,
@@ -394,18 +567,6 @@ window.openAIChatManager = function () {
           placeholder: null,
           isSessionStarted: false,
           isPlaceholderVisible: true,
-          chatWidgetStateName: null,
-          chatWidgetStateSession: null,
-          chatWidgetLayoutKey: null,
-          chatHistorySection: null,
-          widgetContainerElement: null,
-          widgetToggleButtonElement: null,
-          widgetResetSizeButtonElement: null,
-          widgetResizeObserver: null,
-          widgetViewportResizeHandler: null,
-          widgetDefaultWidth: null,
-          widgetDefaultHeight: null,
-          widgetIsInitialized: false,
           isStreaming: false,
           isNavigatingAway: false,
           autoScroll: true,
@@ -415,6 +576,8 @@ window.openAIChatManager = function () {
           prompt: '',
           documents: config.existingDocuments || [],
           isUploading: false,
+          isDocumentOperationPending: false,
+          documentOperationQueue: null,
           uploadErrors: [],
           isDragOver: false,
           documentBar: null,
@@ -444,7 +607,11 @@ window.openAIChatManager = function () {
           conversationModeEnabled: config.chatMode === 'Conversation',
           conversationButton: null,
           isConversationMode: false,
-          notificationDismissTimers: {}
+          notificationDismissTimers: {},
+          pendingSessionPromise: null,
+          pendingSessionResolver: null,
+          pendingSessionRejector: null,
+          pendingSessionTimeoutId: null
         };
       },
       computed: {
@@ -461,336 +628,6 @@ window.openAIChatManager = function () {
         handleBeforeUnload: function handleBeforeUnload() {
           this.isNavigatingAway = true;
         },
-        getStoredWidgetLayout: function getStoredWidgetLayout() {
-          if (!this.chatWidgetLayoutKey || !config.widget.persistLayout) {
-            return {};
-          }
-          try {
-            var storedLayout = localStorage.getItem(this.chatWidgetLayoutKey);
-            return storedLayout ? JSON.parse(storedLayout) || {} : {};
-          } catch (error) {
-            console.warn('Failed to read widget layout state.', error);
-            return {};
-          }
-        },
-        saveStoredWidgetLayout: function saveStoredWidgetLayout(partialLayout) {
-          if (!this.chatWidgetLayoutKey || !config.widget.persistLayout) {
-            return;
-          }
-          var currentLayout = this.getStoredWidgetLayout();
-          var nextLayout = Object.assign({}, currentLayout);
-          if (partialLayout.panel !== undefined) {
-            nextLayout.panel = Object.assign({}, currentLayout.panel || {}, partialLayout.panel || {});
-          }
-          if (partialLayout.position !== undefined) {
-            nextLayout.position = Object.assign({}, currentLayout.position || {}, partialLayout.position || {});
-          }
-          localStorage.setItem(this.chatWidgetLayoutKey, JSON.stringify(nextLayout));
-        },
-        getElementSize: function getElementSize(element, fallbackWidth, fallbackHeight) {
-          if (!element) {
-            return {
-              width: fallbackWidth || 0,
-              height: fallbackHeight || 0
-            };
-          }
-          var rect = element.getBoundingClientRect();
-          var computed = window.getComputedStyle(element);
-          return {
-            width: Math.round(rect.width || parsePixelValue(computed.width) || fallbackWidth || 0),
-            height: Math.round(rect.height || parsePixelValue(computed.height) || fallbackHeight || 0)
-          };
-        },
-        getElementPosition: function getElementPosition(element) {
-          if (!element) {
-            return {
-              left: 0,
-              top: 0
-            };
-          }
-          var rect = element.getBoundingClientRect();
-          var computed = window.getComputedStyle(element);
-          var inlineLeft = parsePixelValue(element.style.left);
-          var inlineTop = parsePixelValue(element.style.top);
-          var computedLeft = parsePixelValue(computed.left);
-          var computedTop = parsePixelValue(computed.top);
-          var isHidden = computed.display === 'none';
-          return {
-            left: Math.round(isHidden && Number.isFinite(inlineLeft) ? inlineLeft : rect.left || inlineLeft || computedLeft || 0),
-            top: Math.round(isHidden && Number.isFinite(inlineTop) ? inlineTop : rect.top || inlineTop || computedTop || 0)
-          };
-        },
-        clampWidgetPosition: function clampWidgetPosition(left, top, width, height) {
-          var viewportPadding = 8;
-          var maxLeft = Math.max(viewportPadding, window.innerWidth - width - viewportPadding);
-          var maxTop = Math.max(viewportPadding, window.innerHeight - height - viewportPadding);
-          return {
-            left: Math.round(clamp(left, viewportPadding, maxLeft)),
-            top: Math.round(clamp(top, viewportPadding, maxTop))
-          };
-        },
-        applyAbsolutePosition: function applyAbsolutePosition(element, left, top) {
-          if (!element) {
-            return;
-          }
-          element.style.left = left + 'px';
-          element.style.top = top + 'px';
-          element.style.right = 'auto';
-          element.style.bottom = 'auto';
-        },
-        getWidgetDefaultSize: function getWidgetDefaultSize() {
-          return {
-            width: this.widgetDefaultWidth || parsePixelValue(config.widget.defaultWidth) || 380,
-            height: this.widgetDefaultHeight || parsePixelValue(config.widget.defaultHeight) || 520
-          };
-        },
-        getWidgetToggleGap: function getWidgetToggleGap() {
-          return 8;
-        },
-        isWidgetPanelVisible: function isWidgetPanelVisible() {
-          if (!this.widgetContainerElement) {
-            return false;
-          }
-          var computed = window.getComputedStyle(this.widgetContainerElement);
-          return this.widgetContainerElement.classList.contains('open') && computed.display !== 'none';
-        },
-        persistWidgetPanelPosition: function persistWidgetPanelPosition() {
-          if (!this.widgetContainerElement || !config.widget.persistLayout) {
-            return;
-          }
-          var panelDefaultSize = this.getWidgetDefaultSize();
-          var panelPosition = this.getElementPosition(this.widgetContainerElement);
-          var panelSize = this.getElementSize(this.widgetContainerElement, panelDefaultSize.width, panelDefaultSize.height);
-          var toggleSize = this.getElementSize(this.widgetToggleButtonElement, 52, 52);
-          var linkedPosition = this.clampWidgetPosition(panelPosition.left + panelSize.width - toggleSize.width, panelPosition.top + panelSize.height + this.getWidgetToggleGap(), toggleSize.width, toggleSize.height);
-          this.saveStoredWidgetLayout({
-            position: {
-              left: linkedPosition.left,
-              top: linkedPosition.top
-            }
-          });
-        },
-        persistWidgetTogglePosition: function persistWidgetTogglePosition() {
-          if (!this.widgetToggleButtonElement || !config.widget.persistLayout) {
-            return;
-          }
-          var toggleRect = this.widgetToggleButtonElement.getBoundingClientRect();
-          this.saveStoredWidgetLayout({
-            position: {
-              left: this.getElementPosition(this.widgetToggleButtonElement).left,
-              top: this.getElementPosition(this.widgetToggleButtonElement).top
-            }
-          });
-        },
-        persistWidgetPanelSize: function persistWidgetPanelSize() {
-          if (!this.widgetContainerElement || !config.widget.enableResizing || !config.widget.persistLayout) {
-            return;
-          }
-          var defaultSize = this.getWidgetDefaultSize();
-          var currentSize = this.getElementSize(this.widgetContainerElement, defaultSize.width, defaultSize.height);
-          this.saveStoredWidgetLayout({
-            panel: {
-              width: Math.abs(currentSize.width - defaultSize.width) <= 1 ? null : currentSize.width,
-              height: Math.abs(currentSize.height - defaultSize.height) <= 1 ? null : currentSize.height
-            }
-          });
-        },
-        syncTogglePositionToPanel: function syncTogglePositionToPanel() {
-          var persistLayout = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
-          if (!this.widgetContainerElement || !this.widgetToggleButtonElement) {
-            return;
-          }
-          var panelDefaultSize = this.getWidgetDefaultSize();
-          var panelSize = this.getElementSize(this.widgetContainerElement, panelDefaultSize.width, panelDefaultSize.height);
-          var toggleSize = this.getElementSize(this.widgetToggleButtonElement, 52, 52);
-          var panelPosition = this.getElementPosition(this.widgetContainerElement);
-          var linkedPosition = this.clampWidgetPosition(panelPosition.left + panelSize.width - toggleSize.width, panelPosition.top + panelSize.height + this.getWidgetToggleGap(), toggleSize.width, toggleSize.height);
-          this.applyAbsolutePosition(this.widgetToggleButtonElement, linkedPosition.left, linkedPosition.top);
-          if (persistLayout && config.widget.persistLayout) {
-            this.persistWidgetTogglePosition();
-          }
-        },
-        syncPanelPositionToToggle: function syncPanelPositionToToggle() {
-          var persistLayout = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
-          if (!this.widgetContainerElement || !this.widgetToggleButtonElement) {
-            return;
-          }
-          var panelDefaultSize = this.getWidgetDefaultSize();
-          var panelSize = this.getElementSize(this.widgetContainerElement, panelDefaultSize.width, panelDefaultSize.height);
-          var toggleSize = this.getElementSize(this.widgetToggleButtonElement, 52, 52);
-          var togglePosition = this.getElementPosition(this.widgetToggleButtonElement);
-          var linkedPosition = this.clampWidgetPosition(togglePosition.left + toggleSize.width - panelSize.width, togglePosition.top - panelSize.height - this.getWidgetToggleGap(), panelSize.width, panelSize.height);
-          this.applyAbsolutePosition(this.widgetContainerElement, linkedPosition.left, linkedPosition.top);
-          if (persistLayout && config.widget.persistLayout) {
-            this.persistWidgetPanelPosition();
-          }
-        },
-        updateWidgetResetSizeButtonVisibility: function updateWidgetResetSizeButtonVisibility() {
-          if (!this.widgetResetSizeButtonElement) {
-            return;
-          }
-          if (!config.widget.enableResizing || !this.widgetContainerElement) {
-            this.widgetResetSizeButtonElement.classList.add('d-none');
-            return;
-          }
-          var defaultSize = this.getWidgetDefaultSize();
-          var currentSize = this.getElementSize(this.widgetContainerElement, defaultSize.width, defaultSize.height);
-          var isResized = Math.abs(currentSize.width - defaultSize.width) > 1 || Math.abs(currentSize.height - defaultSize.height) > 1 || !!this.widgetContainerElement.style.width || !!this.widgetContainerElement.style.height;
-          this.widgetResetSizeButtonElement.classList.toggle('d-none', !isResized);
-        },
-        resetWidgetSize: function resetWidgetSize() {
-          if (!this.widgetContainerElement || !config.widget.enableResizing) {
-            return;
-          }
-          this.widgetContainerElement.style.removeProperty('width');
-          this.widgetContainerElement.style.removeProperty('height');
-          this.persistWidgetPanelSize();
-          this.constrainWidgetElementsToViewport();
-          this.updateWidgetResetSizeButtonVisibility();
-        },
-        restoreWidgetLayout: function restoreWidgetLayout() {
-          var storedLayout = this.getStoredWidgetLayout();
-          if (this.widgetContainerElement && config.widget.enableResizing) {
-            if (Number.isFinite(storedLayout.panel && storedLayout.panel.width)) {
-              this.widgetContainerElement.style.width = storedLayout.panel.width + 'px';
-            } else {
-              this.widgetContainerElement.style.removeProperty('width');
-            }
-            if (Number.isFinite(storedLayout.panel && storedLayout.panel.height)) {
-              this.widgetContainerElement.style.height = storedLayout.panel.height + 'px';
-            } else {
-              this.widgetContainerElement.style.removeProperty('height');
-            }
-          }
-          if (this.widgetToggleButtonElement && config.widget.enableDragging && Number.isFinite(storedLayout.position && storedLayout.position.left) && Number.isFinite(storedLayout.position && storedLayout.position.top)) {
-            this.applyAbsolutePosition(this.widgetToggleButtonElement, storedLayout.position.left, storedLayout.position.top);
-            this.syncPanelPositionToToggle(false);
-          } else if (this.widgetToggleButtonElement && config.widget.enableDragging && Number.isFinite(storedLayout.toggle && storedLayout.toggle.left) && Number.isFinite(storedLayout.toggle && storedLayout.toggle.top)) {
-            this.applyAbsolutePosition(this.widgetToggleButtonElement, storedLayout.toggle.left, storedLayout.toggle.top);
-            this.syncPanelPositionToToggle(false);
-          } else if (this.widgetContainerElement && config.widget.enableDragging && Number.isFinite(storedLayout.panel && storedLayout.panel.left) && Number.isFinite(storedLayout.panel && storedLayout.panel.top)) {
-            this.applyAbsolutePosition(this.widgetContainerElement, storedLayout.panel.left, storedLayout.panel.top);
-            this.syncTogglePositionToPanel(false);
-          }
-          this.constrainWidgetElementsToViewport();
-          this.updateWidgetResetSizeButtonVisibility();
-        },
-        attachDraggableWidgetElement: function attachDraggableWidgetElement(element, handle, layoutKey, suppressClickOnDrag) {
-          var _this = this;
-          if (!element || !handle || !config.widget.enableDragging) {
-            return;
-          }
-          var activePointerId = null;
-          var startX = 0;
-          var startY = 0;
-          var startLeft = 0;
-          var startTop = 0;
-          var dragged = false;
-          var dragThreshold = 4;
-          var interactiveSelector = 'button, a, input, textarea, select, option, label';
-          var _stopDragging = function stopDragging(event) {
-            if (activePointerId === null) {
-              return;
-            }
-            if (event && event.pointerId !== undefined && event.pointerId !== activePointerId) {
-              return;
-            }
-            document.removeEventListener('pointermove', onPointerMove);
-            document.removeEventListener('pointerup', _stopDragging);
-            document.removeEventListener('pointercancel', _stopDragging);
-            element.classList.remove('ai-chat-widget-dragging');
-            activePointerId = null;
-            if (!dragged) {
-              return;
-            }
-            if (layoutKey === 'panel') {
-              _this.syncTogglePositionToPanel(false);
-              _this.persistWidgetPanelPosition();
-            } else if (layoutKey === 'toggle') {
-              _this.syncPanelPositionToToggle(false);
-              _this.persistWidgetTogglePosition();
-            }
-            if (config.widget.persistLayout) {
-              _this.persistWidgetPanelPosition();
-              _this.persistWidgetTogglePosition();
-            }
-            if (suppressClickOnDrag) {
-              element.dataset.dragSuppressClick = 'true';
-              window.setTimeout(function () {
-                if (element.dataset.dragSuppressClick === 'true') {
-                  element.dataset.dragSuppressClick = 'false';
-                }
-              }, 0);
-            }
-          };
-          var onPointerMove = function onPointerMove(event) {
-            if (activePointerId === null || event.pointerId !== activePointerId) {
-              return;
-            }
-            var deltaX = event.clientX - startX;
-            var deltaY = event.clientY - startY;
-            if (!dragged && Math.hypot(deltaX, deltaY) < dragThreshold) {
-              return;
-            }
-            dragged = true;
-            var defaultSize = _this.getWidgetDefaultSize();
-            var currentSize = _this.getElementSize(element, layoutKey === 'panel' ? defaultSize.width : 52, layoutKey === 'panel' ? defaultSize.height : 52);
-            var nextPosition = _this.clampWidgetPosition(startLeft + deltaX, startTop + deltaY, currentSize.width, currentSize.height);
-            _this.applyAbsolutePosition(element, nextPosition.left, nextPosition.top);
-            if (layoutKey === 'panel') {
-              _this.syncTogglePositionToPanel(false);
-            } else if (layoutKey === 'toggle') {
-              _this.syncPanelPositionToToggle(false);
-            }
-          };
-          handle.addEventListener('pointerdown', function (event) {
-            if (event.button !== 0) {
-              return;
-            }
-            if (layoutKey === 'panel' && event.target.closest(interactiveSelector)) {
-              return;
-            }
-            var rect = element.getBoundingClientRect();
-            startX = event.clientX;
-            startY = event.clientY;
-            startLeft = rect.left;
-            startTop = rect.top;
-            dragged = false;
-            activePointerId = event.pointerId;
-            element.classList.add('ai-chat-widget-dragging');
-            if (handle.setPointerCapture) {
-              handle.setPointerCapture(event.pointerId);
-            }
-            document.addEventListener('pointermove', onPointerMove);
-            document.addEventListener('pointerup', _stopDragging);
-            document.addEventListener('pointercancel', _stopDragging);
-            event.preventDefault();
-          });
-        },
-        constrainWidgetElementsToViewport: function constrainWidgetElementsToViewport() {
-          if (this.widgetContainerElement && this.widgetContainerElement.style.left && this.isWidgetPanelVisible()) {
-            var panelDefaultSize = this.getWidgetDefaultSize();
-            var panelSize = this.getElementSize(this.widgetContainerElement, panelDefaultSize.width, panelDefaultSize.height);
-            var panelPosition = this.getElementPosition(this.widgetContainerElement);
-            var clampedPanel = this.clampWidgetPosition(panelPosition.left, panelPosition.top, panelSize.width, panelSize.height);
-            this.applyAbsolutePosition(this.widgetContainerElement, clampedPanel.left, clampedPanel.top);
-            this.syncTogglePositionToPanel(false);
-            if (config.widget.persistLayout) {
-              this.persistWidgetPanelPosition();
-              this.persistWidgetTogglePosition();
-            }
-          } else if (this.widgetToggleButtonElement && this.widgetToggleButtonElement.style.left) {
-            var toggleSize = this.getElementSize(this.widgetToggleButtonElement, 52, 52);
-            var togglePosition = this.getElementPosition(this.widgetToggleButtonElement);
-            var clampedToggle = this.clampWidgetPosition(togglePosition.left, togglePosition.top, toggleSize.width, toggleSize.height);
-            this.applyAbsolutePosition(this.widgetToggleButtonElement, clampedToggle.left, clampedToggle.top);
-            this.syncPanelPositionToToggle(false);
-            if (config.widget.persistLayout) {
-              this.persistWidgetTogglePosition();
-              this.persistWidgetPanelPosition();
-            }
-          }
-        },
         handleDragOver: function handleDragOver(e) {
           if (!config.sessionDocumentsEnabled) return;
           e.preventDefault();
@@ -815,180 +652,272 @@ window.openAIChatManager = function () {
           var inputArea = this.inputElement ? this.inputElement.closest('.ai-admin-widget-input, .text-bg-light') : null;
           if (inputArea) inputArea.classList.remove('ai-chat-drag-over');
           if (e.dataTransfer && e.dataTransfer.files && e.dataTransfer.files.length > 0) {
-            this.uploadFiles(e.dataTransfer.files);
+            this.uploadFiles(Array.from(e.dataTransfer.files));
           }
         },
         triggerFileInput: function triggerFileInput() {
-          if (!config.sessionDocumentsEnabled) return;
+          if (!config.sessionDocumentsEnabled || this.isDocumentOperationPending) return;
           var fileInput = document.getElementById('ai-chat-doc-input');
           if (fileInput) fileInput.click();
         },
         handleFileInputChange: function handleFileInputChange(e) {
-          var files = e.target.files;
+          var files = e.target.files ? Array.from(e.target.files) : [];
           if (files && files.length > 0) {
             this.uploadFiles(files);
           }
           e.target.value = '';
         },
-        uploadFiles: function uploadFiles(files) {
-          var _this2 = this;
-          return _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
-            var sessionId, profileId, formData, i, response, errorText, uploadError, result, j, _t;
+        queueDocumentOperation: function queueDocumentOperation(operation) {
+          var self = this;
+          var previousOperation = this.documentOperationQueue || Promise.resolve();
+          var nextOperation = previousOperation["catch"](function () {}).then(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
             return _regenerator().w(function (_context) {
               while (1) switch (_context.p = _context.n) {
+                case 0:
+                  self.isDocumentOperationPending = true;
+                  _context.p = 1;
+                  _context.n = 2;
+                  return operation();
+                case 2:
+                  return _context.a(2, _context.v);
+                case 3:
+                  _context.p = 3;
+                  self.isDocumentOperationPending = false;
+                  return _context.f(3);
+                case 4:
+                  return _context.a(2);
+              }
+            }, _callee, null, [[1,, 3, 4]]);
+          })));
+          this.documentOperationQueue = nextOperation["finally"](function () {
+            if (self.documentOperationQueue === nextOperation) {
+              self.documentOperationQueue = null;
+            }
+          });
+          return this.documentOperationQueue;
+        },
+        uploadFiles: function uploadFiles(files) {
+          var _this = this;
+          return _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
+            var filesToUpload;
+            return _regenerator().w(function (_context3) {
+              while (1) switch (_context3.n) {
                 case 0:
                   if (config.uploadDocumentUrl) {
-                    _context.n = 1;
+                    _context3.n = 1;
                     break;
                   }
-                  return _context.a(2);
+                  return _context3.a(2);
                 case 1:
-                  sessionId = _this2.getSessionId();
-                  profileId = _this2.getProfileId();
-                  if (!(!sessionId && !profileId)) {
-                    _context.n = 2;
+                  filesToUpload = Array.isArray(files) ? files.slice() : Array.from(files || []);
+                  if (!(filesToUpload.length === 0)) {
+                    _context3.n = 2;
                     break;
                   }
-                  console.warn('Cannot upload documents without a session or profile.');
-                  return _context.a(2);
+                  return _context3.a(2);
                 case 2:
-                  _this2.isUploading = true;
-                  _this2.uploadErrors = [];
-                  _this2.renderDocumentBar();
-                  _context.p = 3;
-                  formData = new FormData();
-                  if (sessionId) {
-                    formData.append('sessionId', sessionId);
-                  } else {
-                    formData.append('profileId', profileId);
-                  }
-                  for (i = 0; i < files.length; i++) {
-                    formData.append('files', files[i]);
-                  }
-                  _context.n = 4;
-                  return fetch(config.uploadDocumentUrl, {
-                    method: 'POST',
-                    body: formData
-                  });
-                case 4:
-                  response = _context.v;
-                  if (response.ok) {
-                    _context.n = 6;
-                    break;
-                  }
-                  _context.n = 5;
-                  return response.text();
-                case 5:
-                  errorText = _context.v;
-                  uploadError = _this2.extractReadableErrorMessage(errorText, 'Upload failed. Please try again.');
-                  console.error('Upload failed:', errorText);
-                  _this2.uploadErrors = [{
-                    fileName: '',
-                    error: uploadError
-                  }];
-                  return _context.a(2);
-                case 6:
-                  _context.n = 7;
-                  return response.json();
-                case 7:
-                  result = _context.v;
-                  // If the server created a new session, initialize it.
-                  if (result.sessionId && !sessionId) {
-                    _this2.initializeSession(result.sessionId);
-                  }
-                  if (result.uploaded && result.uploaded.length > 0) {
-                    for (j = 0; j < result.uploaded.length; j++) {
-                      _this2.documents.push(result.uploaded[j]);
-                    }
-                  }
-                  if (result.failed && result.failed.length > 0) {
-                    _this2.uploadErrors = result.failed;
-                  }
-                  _context.n = 9;
-                  break;
-                case 8:
-                  _context.p = 8;
-                  _t = _context.v;
-                  console.error('Upload error:', _t);
-                  _this2.uploadErrors = [{
-                    fileName: '',
-                    error: 'Upload failed. Please try again.'
-                  }];
-                case 9:
-                  _context.p = 9;
-                  _this2.isUploading = false;
-                  _this2.renderDocumentBar();
-                  return _context.f(9);
-                case 10:
-                  return _context.a(2);
+                  return _context3.a(2, _this.queueDocumentOperation(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2() {
+                    var sessionId, profileId, formData, i, response, errorText, uploadError, result, _t, _t2;
+                    return _regenerator().w(function (_context2) {
+                      while (1) switch (_context2.p = _context2.n) {
+                        case 0:
+                          sessionId = _this.getSessionId();
+                          profileId = _this.getProfileId();
+                          if (sessionId) {
+                            _context2.n = 4;
+                            break;
+                          }
+                          _context2.p = 1;
+                          _context2.n = 2;
+                          return _this.ensureSessionForDocuments(profileId);
+                        case 2:
+                          sessionId = _context2.v;
+                          _context2.n = 4;
+                          break;
+                        case 3:
+                          _context2.p = 3;
+                          _t = _context2.v;
+                          console.error('Failed to create a chat session for document upload:', _t);
+                          _this.uploadErrors = [{
+                            fileName: '',
+                            error: 'Could not create a chat session for the upload.'
+                          }];
+                          _this.renderDocumentBar();
+                          return _context2.a(2);
+                        case 4:
+                          if (sessionId) {
+                            _context2.n = 5;
+                            break;
+                          }
+                          console.warn('Cannot upload documents without a session or profile.');
+                          _this.uploadErrors = [{
+                            fileName: '',
+                            error: 'Could not create a chat session for the upload.'
+                          }];
+                          _this.renderDocumentBar();
+                          return _context2.a(2);
+                        case 5:
+                          _this.isUploading = true;
+                          _this.uploadErrors = [];
+                          _this.renderDocumentBar();
+                          _context2.p = 6;
+                          formData = new FormData();
+                          formData.append('sessionId', sessionId);
+                          for (i = 0; i < filesToUpload.length; i++) {
+                            formData.append('files', filesToUpload[i]);
+                          }
+                          _context2.n = 7;
+                          return fetch(config.uploadDocumentUrl, {
+                            method: 'POST',
+                            body: formData
+                          });
+                        case 7:
+                          response = _context2.v;
+                          if (response.ok) {
+                            _context2.n = 9;
+                            break;
+                          }
+                          _context2.n = 8;
+                          return response.text();
+                        case 8:
+                          errorText = _context2.v;
+                          uploadError = _this.extractReadableErrorMessage(errorText, 'Upload failed. Please try again.');
+                          console.error('Upload failed:', errorText);
+                          _this.uploadErrors = [{
+                            fileName: '',
+                            error: uploadError
+                          }];
+                          return _context2.a(2);
+                        case 9:
+                          _context2.n = 10;
+                          return response.json();
+                        case 10:
+                          result = _context2.v;
+                          if (result.sessionId && result.sessionId !== _this.getSessionId()) {
+                            _this.initializeSession(result.sessionId);
+                          }
+                          if (Array.isArray(result.documents)) {
+                            _this.documents = result.documents;
+                          } else if (result.uploaded && result.uploaded.length > 0) {
+                            _this.documents = _this.documents.concat(result.uploaded);
+                          }
+                          if (result.failed && result.failed.length > 0) {
+                            _this.uploadErrors = result.failed;
+                          }
+                          _context2.n = 12;
+                          break;
+                        case 11:
+                          _context2.p = 11;
+                          _t2 = _context2.v;
+                          console.error('Upload error:', _t2);
+                          _this.uploadErrors = [{
+                            fileName: '',
+                            error: 'Upload failed. Please try again.'
+                          }];
+                          if (_this.getSessionId()) {
+                            _this.reloadCurrentSession();
+                          }
+                        case 12:
+                          _context2.p = 12;
+                          _this.isUploading = false;
+                          _this.renderDocumentBar();
+                          return _context2.f(12);
+                        case 13:
+                          return _context2.a(2);
+                      }
+                    }, _callee2, null, [[6, 11, 12, 13], [1, 3]]);
+                  }))));
               }
-            }, _callee, null, [[3, 8, 9, 10]]);
+            }, _callee3);
           }))();
         },
         removeDocument: function removeDocument(doc) {
-          var _this3 = this;
-          return _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2() {
-            var sessionId, response, idx, errorText, removeError, _t2;
-            return _regenerator().w(function (_context2) {
-              while (1) switch (_context2.p = _context2.n) {
+          var _this2 = this;
+          return _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5() {
+            return _regenerator().w(function (_context5) {
+              while (1) switch (_context5.n) {
                 case 0:
                   if (config.removeDocumentUrl) {
-                    _context2.n = 1;
+                    _context5.n = 1;
                     break;
                   }
-                  return _context2.a(2);
+                  return _context5.a(2);
                 case 1:
-                  _context2.p = 1;
-                  sessionId = _this3.getSessionId();
-                  _context2.n = 2;
-                  return fetch(config.removeDocumentUrl, {
-                    method: 'POST',
-                    headers: {
-                      'Content-Type': 'application/json'
-                    },
-                    body: JSON.stringify({
-                      itemId: sessionId,
-                      documentId: doc.documentId
-                    })
-                  });
-                case 2:
-                  response = _context2.v;
-                  if (!response.ok) {
-                    _context2.n = 3;
-                    break;
-                  }
-                  idx = _this3.documents.indexOf(doc);
-                  if (idx > -1) _this3.documents.splice(idx, 1);
-                  _context2.n = 5;
-                  break;
-                case 3:
-                  _context2.n = 4;
-                  return response.text();
-                case 4:
-                  errorText = _context2.v;
-                  removeError = _this3.extractReadableErrorMessage(errorText, 'Failed to remove document. Please try again.');
-                  console.error('Failed to remove document:', response.status, errorText);
-                  _this3.uploadErrors = [{
-                    fileName: doc.fileName || '',
-                    error: removeError
-                  }];
-                  _this3.renderDocumentBar();
-                case 5:
-                  _context2.n = 7;
-                  break;
-                case 6:
-                  _context2.p = 6;
-                  _t2 = _context2.v;
-                  console.error('Remove document error:', _t2);
-                  _this3.uploadErrors = [{
-                    fileName: doc.fileName || '',
-                    error: 'Failed to remove document. Please try again.'
-                  }];
-                  _this3.renderDocumentBar();
-                case 7:
-                  return _context2.a(2);
+                  return _context5.a(2, _this2.queueDocumentOperation(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
+                    var sessionId, response, result, idx, errorText, removeError, _t3;
+                    return _regenerator().w(function (_context4) {
+                      while (1) switch (_context4.p = _context4.n) {
+                        case 0:
+                          _context4.p = 0;
+                          sessionId = _this2.getSessionId();
+                          _context4.n = 1;
+                          return fetch(config.removeDocumentUrl, {
+                            method: 'POST',
+                            headers: {
+                              'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify({
+                              itemId: sessionId,
+                              documentId: doc.documentId
+                            })
+                          });
+                        case 1:
+                          response = _context4.v;
+                          if (!response.ok) {
+                            _context4.n = 3;
+                            break;
+                          }
+                          _context4.n = 2;
+                          return response.json();
+                        case 2:
+                          result = _context4.v;
+                          if (Array.isArray(result.documents)) {
+                            _this2.documents = result.documents;
+                          } else {
+                            idx = _this2.documents.indexOf(doc);
+                            if (idx > -1) {
+                              _this2.documents.splice(idx, 1);
+                            }
+                          }
+                          _context4.n = 5;
+                          break;
+                        case 3:
+                          _context4.n = 4;
+                          return response.text();
+                        case 4:
+                          errorText = _context4.v;
+                          removeError = _this2.extractReadableErrorMessage(errorText, 'Failed to remove document. Please try again.');
+                          console.error('Failed to remove document:', response.status, errorText);
+                          _this2.uploadErrors = [{
+                            fileName: doc.fileName || '',
+                            error: removeError
+                          }];
+                          if (sessionId) {
+                            _this2.reloadCurrentSession();
+                          }
+                          _this2.renderDocumentBar();
+                        case 5:
+                          _context4.n = 7;
+                          break;
+                        case 6:
+                          _context4.p = 6;
+                          _t3 = _context4.v;
+                          console.error('Remove document error:', _t3);
+                          _this2.uploadErrors = [{
+                            fileName: doc.fileName || '',
+                            error: 'Failed to remove document. Please try again.'
+                          }];
+                          if (_this2.getSessionId()) {
+                            _this2.reloadCurrentSession();
+                          }
+                          _this2.renderDocumentBar();
+                        case 7:
+                          return _context4.a(2);
+                      }
+                    }, _callee4, null, [[0, 6]]);
+                  }))));
               }
-            }, _callee2, null, [[1, 6]]);
+            }, _callee5);
           }))();
         },
         formatFileSize: function formatFileSize(bytes) {
@@ -1012,7 +941,7 @@ window.openAIChatManager = function () {
             html += '<span class="badge bg-secondary bg-opacity-25 text-dark d-inline-flex align-items-center gap-1 px-2 py-1" style="font-size: 0.8rem;" title="' + this.escapeHtml(doc.fileName || '') + '">';
             html += '<i class="fa-solid fa-file-lines" style="font-size: 0.7rem;"></i> ';
             html += this.escapeHtml(name);
-            html += ' <button type="button" class="btn-close btn-close-sm ms-1" style="font-size: 0.5rem;" data-doc-index="' + i + '" aria-label="Remove"></button>';
+            html += ' <button type="button" class="btn-close btn-close-sm ms-1" style="font-size: 0.5rem;" data-doc-index="' + i + '" aria-label="Remove"' + (this.isDocumentOperationPending ? ' disabled' : '') + '></button>';
             html += '</span>';
           }
           for (var m = 0; m < this.uploadErrors.length; m++) {
@@ -1031,7 +960,7 @@ window.openAIChatManager = function () {
             html += '<span class="spinner-border spinner-border-sm" style="width: 0.7rem; height: 0.7rem;"></span> Uploading...';
             html += '</span>';
           }
-          html += '<button type="button" class="btn btn-sm btn-outline-secondary rounded-pill ai-chat-doc-add-btn d-inline-flex align-items-center gap-1" style="font-size: 0.75rem; padding: 0.15rem 0.5rem;" title="Attach documents">';
+          html += '<button type="button" class="btn btn-sm btn-outline-secondary rounded-pill ai-chat-doc-add-btn d-inline-flex align-items-center gap-1" style="font-size: 0.75rem; padding: 0.15rem 0.5rem;" title="Attach documents"' + (this.isDocumentOperationPending ? ' disabled' : '') + '>';
           html += '<i class="fa-solid fa-paperclip"></i>';
           if (this.documents.length === 0 && !this.isUploading) {
             html += ' <span>Attach files</span>';
@@ -1054,6 +983,9 @@ window.openAIChatManager = function () {
               return function (e) {
                 e.preventDefault();
                 e.stopPropagation();
+                if (self.isDocumentOperationPending) {
+                  return;
+                }
                 var docToRemove = self.documents[idx];
                 if (docToRemove) self.removeDocument(docToRemove);
               };
@@ -1078,6 +1010,9 @@ window.openAIChatManager = function () {
           if (addBtn) {
             addBtn.addEventListener('click', function (e) {
               e.preventDefault();
+              if (self.isDocumentOperationPending) {
+                return;
+              }
               self.triggerFileInput();
             });
           }
@@ -1154,139 +1089,135 @@ window.openAIChatManager = function () {
           return !!message && message.isStreaming && index === this.lastAssistantIndex && !(appearance && appearance.disableStreamingAnimation);
         },
         startConnection: function startConnection() {
-          var _this4 = this;
-          return _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
-            var _t3;
-            return _regenerator().w(function (_context3) {
-              while (1) switch (_context3.p = _context3.n) {
+          var _this3 = this;
+          return _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6() {
+            var _t4;
+            return _regenerator().w(function (_context6) {
+              while (1) switch (_context6.p = _context6.n) {
                 case 0:
-                  _this4.connection = new signalR.HubConnectionBuilder().withUrl(config.signalRHubUrl).withAutomaticReconnect().build();
+                  _this3.connection = new signalR.HubConnectionBuilder().withUrl(config.signalRHubUrl).withAutomaticReconnect().build();
 
                   // Allow long-running operations (e.g., multi-step MCP tool calls)
                   // without the client disconnecting prematurely.
-                  _this4.connection.serverTimeoutInMilliseconds = 600000;
-                  _this4.connection.keepAliveIntervalInMilliseconds = 15000;
-                  _this4.connection.on("LoadSession", function (data) {
+                  _this3.connection.serverTimeoutInMilliseconds = 600000;
+                  _this3.connection.keepAliveIntervalInMilliseconds = 15000;
+                  _this3.connection.on("LoadSession", function (data) {
                     var _data$messages;
-                    _this4.initializeSession(data.sessionId, true);
-                    _this4.messages = [];
-                    _this4.documents = data.documents || [];
+                    _this3.initializeSession(data.sessionId, true);
+                    _this3.messages = [];
+                    _this3.documents = data.documents || [];
+                    _this3.uploadErrors = [];
                     ((_data$messages = data.messages) !== null && _data$messages !== void 0 ? _data$messages : []).forEach(function (msg) {
-                      _this4.addMessage(msg);
-                      _this4.$nextTick(function () {
+                      _this3.addMessage(msg);
+                      _this3.$nextTick(function () {
                         renderChartsInMessage(msg);
                       });
                     });
 
                     // Update feedback icons in the DOM after all messages have rendered.
-                    _this4.$nextTick(function () {
-                      _this4.refreshAllFeedbackIcons();
+                    _this3.$nextTick(function () {
+                      _this3.refreshAllFeedbackIcons();
                     });
 
                     // When the session is new (no messages) and an initial prompt is configured,
                     // automatically send it as the first user message to trigger an AI response.
-                    if (_this4.messages.length === 0 && config.initialPrompt) {
-                      _this4.prompt = config.initialPrompt;
-                      _this4.sendMessage();
+                    if (_this3.messages.length === 0 && config.initialPrompt) {
+                      _this3.prompt = config.initialPrompt;
+                      _this3.sendMessage();
                     }
                   });
-                  _this4.connection.on("ReceiveError", function (error) {
+                  _this3.connection.on("ReceiveError", function (error) {
                     console.error("SignalR Error: ", error);
-                    if (_this4.isRecording) {
-                      _this4.stopRecording();
+                    if (_this3.isRecording) {
+                      _this3.stopRecording();
                     }
-
-                    // If this is a widget with a stale cached session (e.g., profile was deleted),
-                    // clear the cached session and start fresh with the current profile.
-                    if (_this4.widgetIsInitialized && !_this4.isSessionStarted && !_this4._attemptedSessionRecovery) {
-                      _this4._attemptedSessionRecovery = true;
-                      localStorage.removeItem(_this4.chatWidgetStateSession);
-                      _this4.startNewSession();
+                    if (widgetBehavior && typeof widgetBehavior.handleReceiveError === 'function') {
+                      widgetBehavior.handleReceiveError(_this3, error, config);
                     }
                   });
-                  _this4.connection.on("MessageRated", function (messageId, userRating) {
-                    var msg = _this4.messages.find(function (m) {
+                  _this3.connection.on("MessageRated", function (messageId, userRating) {
+                    var msg = _this3.messages.find(function (m) {
                       return m.id === messageId;
                     });
                     if (msg) {
                       msg.userRating = userRating;
                     }
                   });
-                  _this4.connection.on("ReceiveTranscript", function (sessionId, text, isFinal) {
-                    if (_this4.isConversationMode) {
+                  _this3.connection.on("ReceiveTranscript", function (sessionId, text, isFinal) {
+                    if (_this3.isConversationMode) {
                       if (!isFinal && text) {
-                        _this4._conversationPartialTranscript = text;
+                        _this3._conversationPartialTranscript = text;
                         var escaped = text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
                         var html = '<p class="ai-partial-transcript">' + escaped + '</p>';
 
                         // Show partial transcript as a live user message.
-                        if (!_this4._conversationPartialMessage) {
-                          _this4.hidePlaceholder();
-                          _this4._conversationPartialMessage = {
+                        if (!_this3._conversationPartialMessage) {
+                          _this3.hidePlaceholder();
+                          _this3._conversationPartialMessage = {
                             role: 'user',
                             content: text,
                             htmlContent: html,
                             isPartial: true
                           };
-                          _this4.messages.push(_this4._conversationPartialMessage);
+                          _this3.messages.push(_this3._conversationPartialMessage);
                         } else {
-                          _this4._conversationPartialMessage.content = text;
-                          _this4._conversationPartialMessage.htmlContent = html;
+                          _this3._conversationPartialMessage.content = text;
+                          _this3._conversationPartialMessage.htmlContent = html;
                         }
-                        _this4.scrollToBottom();
+                        _this3.scrollToBottom();
                       }
                       return;
                     }
-                    if (text && !_this4._audioInputSent) {
-                      _this4.prompt = _this4.preRecordingPrompt + text;
-                      if (_this4.inputElement) {
-                        _this4.inputElement.value = _this4.prompt;
-                        _this4.inputElement.dispatchEvent(new Event('input'));
+                    if (text && !_this3._audioInputSent) {
+                      _this3.prompt = _this3.preRecordingPrompt + text;
+                      if (_this3.inputElement) {
+                        _this3.inputElement.value = _this3.prompt;
+                        _this3.inputElement.dispatchEvent(new Event('input'));
                       }
                     }
                   });
-                  _this4.connection.on("ReceiveConversationUserMessage", function (sessionId, text) {
+                  _this3.connection.on("ReceiveConversationUserMessage", function (sessionId, text) {
                     if (text) {
-                      _this4.stopAudio();
+                      _this3.stopAudio();
 
                       // If there's an interrupted assistant message still streaming,
                       // mark it as done to stop the spinner animation.
-                      if (_this4._conversationAssistantMessage) {
-                        var oldMsg = _this4.messages[_this4._conversationAssistantMessage.index];
+                      if (_this3._conversationAssistantMessage) {
+                        var oldMsg = _this3.messages[_this3._conversationAssistantMessage.index];
                         if (oldMsg) {
                           oldMsg.isStreaming = false;
                         }
-                        _this4._conversationAssistantMessage = null;
+                        _this3._conversationAssistantMessage = null;
                       }
 
                       // Replace the partial transcript message with the final one.
-                      if (_this4._conversationPartialMessage) {
+                      if (_this3._conversationPartialMessage) {
                         var escaped = text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-                        _this4._conversationPartialMessage.content = text;
-                        _this4._conversationPartialMessage.htmlContent = '<p>' + escaped + '</p>';
-                        _this4._conversationPartialMessage.isPartial = false;
-                        _this4._conversationPartialMessage = null;
+                        _this3._conversationPartialMessage.content = text;
+                        _this3._conversationPartialMessage.htmlContent = '<p>' + escaped + '</p>';
+                        _this3._conversationPartialMessage.isPartial = false;
+                        _this3._conversationPartialMessage = null;
                       } else {
-                        _this4.addMessage({
+                        _this3.addMessage({
                           role: 'user',
                           content: text
                         });
                       }
-                      _this4.scrollToBottom();
+                      _this3.scrollToBottom();
                     }
                   });
-                  _this4.connection.on("ReceiveConversationAssistantToken", function (sessionId, messageId, token, responseId, appearance) {
-                    if (!_this4._conversationAssistantMessage) {
-                      _this4.stopAudio();
-                      _this4.hideTypingIndicator();
+                  _this3.connection.on("ReceiveConversationAssistantToken", function (sessionId, messageId, token, responseId, references, appearance) {
+                    if (!_this3._conversationAssistantMessage) {
+                      _this3.stopAudio();
+                      _this3.hideTypingIndicator();
 
                       // Ensure no stale streaming indicators remain from prior messages.
-                      for (var j = 0; j < _this4.messages.length; j++) {
-                        if (_this4.messages[j].isStreaming) {
-                          _this4.messages[j].isStreaming = false;
+                      for (var j = 0; j < _this3.messages.length; j++) {
+                        if (_this3.messages[j].isStreaming) {
+                          _this3.messages[j].isStreaming = false;
                         }
                       }
-                      var msgIndex = _this4.messages.length;
+                      var msgIndex = _this3.messages.length;
                       var newMessage = {
                         id: messageId,
                         role: "assistant",
@@ -1294,96 +1225,100 @@ window.openAIChatManager = function () {
                         htmlContent: "",
                         isStreaming: true,
                         userRating: null,
-                        appearance: _this4.normalizeAssistantAppearance(appearance)
+                        appearance: _this3.normalizeAssistantAppearance(appearance),
+                        references: {}
                       };
-                      _this4.messages.push(newMessage);
-                      _this4._conversationAssistantMessage = {
+                      _this3.messages.push(newMessage);
+                      _this3._conversationAssistantMessage = {
                         index: msgIndex,
                         content: ''
                       };
                     }
-                    _this4._conversationAssistantMessage.content += token;
-                    var msg = _this4.messages[_this4._conversationAssistantMessage.index];
+                    _this3._conversationAssistantMessage.content += token;
+                    var msg = _this3.messages[_this3._conversationAssistantMessage.index];
                     if (msg) {
                       if (!msg.appearance) {
-                        msg.appearance = _this4.normalizeAssistantAppearance(appearance);
+                        msg.appearance = _this3.normalizeAssistantAppearance(appearance);
                       }
-                      msg.content = _this4._conversationAssistantMessage.content;
-                      msg.htmlContent = parseMarkdownContent(msg.content, msg);
-                      _this4.$nextTick(function () {
+                      msg.rawContent = _this3._conversationAssistantMessage.content;
+                      msg.references = normalizeReferences(Object.assign({}, msg.references || {}, references || {}));
+                      updateMessagePresentation(msg, msg.references);
+                      _this3.$nextTick(function () {
                         renderChartsInMessage(msg);
-                        _this4.scrollToBottom();
+                        _this3.scrollToBottom();
                       });
                     }
                   });
-                  _this4.connection.on("ReceiveConversationAssistantComplete", function (sessionId, messageId) {
-                    if (_this4._conversationAssistantMessage) {
-                      var msg = _this4.messages[_this4._conversationAssistantMessage.index];
+                  _this3.connection.on("ReceiveConversationAssistantComplete", function (sessionId, messageId, references) {
+                    if (_this3._conversationAssistantMessage) {
+                      var msg = _this3.messages[_this3._conversationAssistantMessage.index];
                       if (msg) {
                         msg.isStreaming = false;
+                        msg.references = normalizeReferences(Object.assign({}, msg.references || {}, references || {}));
+                        updateMessagePresentation(msg, msg.references);
                       }
-                      _this4._conversationAssistantMessage = null;
+                      _this3._conversationAssistantMessage = null;
                     }
                   });
-                  _this4.connection.on("ReceiveAudioChunk", function (sessionId, base64Audio, contentType) {
+                  _this3.connection.on("ReceiveAudioChunk", function (sessionId, base64Audio, contentType) {
                     if (base64Audio) {
                       var binaryString = atob(base64Audio);
                       var bytes = new Uint8Array(binaryString.length);
                       for (var i = 0; i < binaryString.length; i++) {
                         bytes[i] = binaryString.charCodeAt(i);
                       }
-                      _this4.audioChunks.push(bytes);
+                      _this3.audioChunks.push(bytes);
                     }
                   });
-                  _this4.connection.on("ReceiveAudioComplete", function (sessionId) {
-                    _this4.playCollectedAudio();
+                  _this3.connection.on("ReceiveAudioComplete", function (sessionId) {
+                    _this3.playCollectedAudio();
                   });
-                  _this4.connection.on("ReceiveNotification", function (notification) {
-                    _this4.receiveNotification(notification);
+                  _this3.connection.on("ReceiveNotification", function (notification) {
+                    _this3.receiveNotification(notification);
                   });
-                  _this4.connection.on("UpdateNotification", function (notification) {
-                    _this4.updateNotification(notification);
+                  _this3.connection.on("UpdateNotification", function (notification) {
+                    _this3.updateNotification(notification);
                   });
-                  _this4.connection.on("RemoveNotification", function (notificationType) {
-                    _this4.removeNotification(notificationType);
+                  _this3.connection.on("RemoveNotification", function (notificationType) {
+                    _this3.removeNotification(notificationType);
                   });
-                  _this4.connection.onreconnecting(function () {
+                  _this3.connection.onreconnecting(function () {
                     console.warn("SignalR: reconnecting...");
                   });
-                  _this4.connection.onreconnected(function () {
+                  _this3.connection.onreconnected(function () {
                     console.info("SignalR: reconnected.");
-                    if (_this4.isSessionStarted) {
-                      _this4.reloadCurrentSession();
+                    if (_this3.isSessionStarted) {
+                      _this3.reloadCurrentSession();
                     } else if (config.autoCreateSession) {
-                      _this4.startNewSession();
+                      _this3.startNewSession();
                     }
                   });
-                  _this4.connection.onclose(function (error) {
-                    if (_this4.isNavigatingAway) {
+                  _this3.connection.onclose(function (error) {
+                    if (_this3.isNavigatingAway) {
                       return;
                     }
                     if (error) {
                       console.warn("SignalR connection closed with error:", error.message || error);
                     }
                   });
-                  _context3.p = 1;
-                  _context3.n = 2;
-                  return _this4.connection.start();
+                  _context6.p = 1;
+                  _context6.n = 2;
+                  return _this3.connection.start();
                 case 2:
-                  _context3.n = 4;
+                  _context6.n = 4;
                   break;
                 case 3:
-                  _context3.p = 3;
-                  _t3 = _context3.v;
-                  console.error("SignalR Connection Error: ", _t3);
+                  _context6.p = 3;
+                  _t4 = _context6.v;
+                  console.error("SignalR Connection Error: ", _t4);
                 case 4:
-                  return _context3.a(2);
+                  return _context6.a(2);
               }
-            }, _callee3, null, [[1, 3]]);
+            }, _callee6, null, [[1, 3]]);
           }))();
         },
         addMessageInternal: function addMessageInternal(message) {
-          var _this5 = this;
+          var _this4 = this;
           if (message.role === 'assistant') {
             message.appearance = this.normalizeAssistantAppearance(message.appearance);
           }
@@ -1397,7 +1332,7 @@ window.openAIChatManager = function () {
           }));
           this.messages.push(message);
           this.$nextTick(function () {
-            _this5.fireEvent(new CustomEvent("addedOpenAIPromotMessage", {
+            _this4.fireEvent(new CustomEvent("addedOpenAIPromotMessage", {
               detail: {
                 message: message
               }
@@ -1405,105 +1340,32 @@ window.openAIChatManager = function () {
           });
         },
         addMessage: function addMessage(message) {
-          var _this6 = this;
+          var _this5 = this;
           // Ensure userRating is always defined for Vue reactivity.
           if (message.userRating === undefined) {
             message.userRating = null;
           }
           if (message.content) {
-            var processedContent = message.content.trim();
-            message.references = normalizeReferences(message.references);
-            if (message.references && _typeof(message.references) === "object" && Object.keys(message.references).length) {
-              // Only include references that were actually cited in the response.
-              var citedRefs = Object.entries(message.references).filter(function (_ref4) {
-                var _ref5 = _slicedToArray(_ref4, 1),
-                  key = _ref5[0];
-                return processedContent.includes(key);
-              });
-              if (citedRefs.length) {
-                // Sort by original index so display indices follow a natural order.
-                citedRefs.sort(function (_ref6, _ref7) {
-                  var _ref8 = _slicedToArray(_ref6, 2),
-                    a = _ref8[1];
-                  var _ref9 = _slicedToArray(_ref7, 2),
-                    b = _ref9[1];
-                  return a.index - b.index;
-                });
-
-                // Phase 1: Replace all markers with unique placeholders.
-                var displayIndex = 1;
-                var _iterator2 = _createForOfIteratorHelper(citedRefs),
-                  _step2;
-                try {
-                  for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-                    var _step2$value = _slicedToArray(_step2.value, 2),
-                      key = _step2$value[0],
-                      value = _step2$value[1];
-                    var placeholder = "__CITE_".concat(value.index, "__");
-                    processedContent = processedContent.replaceAll(key, placeholder);
-                    value._displayIndex = displayIndex++;
-                    value._placeholder = placeholder;
-                  }
-
-                  // Phase 2: Replace placeholders with sequential display indices.
-                } catch (err) {
-                  _iterator2.e(err);
-                } finally {
-                  _iterator2.f();
-                }
-                var _iterator3 = _createForOfIteratorHelper(citedRefs),
-                  _step3;
-                try {
-                  for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-                    var _step3$value = _slicedToArray(_step3.value, 2),
-                      _value = _step3$value[1];
-                    processedContent = processedContent.replaceAll(_value._placeholder, "<sup><strong>".concat(_value._displayIndex, "</strong></sup>"));
-                  }
-
-                  // if we have multiple references, add a comma to ensure we don't concatenate numbers.
-                } catch (err) {
-                  _iterator3.e(err);
-                } finally {
-                  _iterator3.f();
-                }
-                processedContent = processedContent.replaceAll('</strong></sup><sup>', '</strong></sup><sup>,</sup><sup>');
-                processedContent += '<br><br>';
-                var _iterator4 = _createForOfIteratorHelper(citedRefs),
-                  _step4;
-                try {
-                  for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
-                    var _step4$value = _slicedToArray(_step4.value, 2),
-                      _key = _step4$value[0],
-                      _value2 = _step4$value[1];
-                    var label = _value2.text || _key;
-                    processedContent += _value2.link ? "**".concat(_value2._displayIndex, "**. [").concat(label, "](").concat(_value2.link, ")<br>") : "**".concat(_value2._displayIndex, "**. ").concat(label, "<br>");
-                  }
-                } catch (err) {
-                  _iterator4.e(err);
-                } finally {
-                  _iterator4.f();
-                }
-              }
-            }
-            message.content = processedContent;
-            message.htmlContent = parseMarkdownContent(processedContent, message);
+            var _message$rawContent;
+            message.rawContent = (_message$rawContent = message.rawContent) !== null && _message$rawContent !== void 0 ? _message$rawContent : message.content;
+            updateMessagePresentation(message, message.references);
           }
           this.addMessageInternal(message);
           this.hidePlaceholder();
           this.$nextTick(function () {
             // Render any pending charts once the DOM is updated
             renderChartsInMessage(message);
-            _this6.scrollToBottom();
+            _this5.scrollToBottom();
           });
         },
         addMessages: function addMessages(messages) {
-          var _this7 = this;
+          var _this6 = this;
           for (var i = 0; i < messages.length; i++) {
             this.addMessageInternal(messages[i]);
           }
           this.hidePlaceholder();
           this.$nextTick(function () {
-            _this7.scrollToBottom();
+            _this6.scrollToBottom();
           });
         },
         hidePlaceholder: function hidePlaceholder() {
@@ -1580,7 +1442,7 @@ window.openAIChatManager = function () {
           this.prompt = '';
         },
         startRecording: function startRecording() {
-          var _this8 = this;
+          var _this7 = this;
           if (this.isRecording || !this.connection) {
             return;
           }
@@ -1592,27 +1454,27 @@ window.openAIChatManager = function () {
             }
           }).then(function (stream) {
             var mimeType = MediaRecorder.isTypeSupported('audio/ogg;codecs=opus') ? 'audio/ogg;codecs=opus' : MediaRecorder.isTypeSupported('audio/webm;codecs=opus') ? 'audio/webm;codecs=opus' : 'audio/webm';
-            _this8.mediaRecorder = new MediaRecorder(stream, {
+            _this7.mediaRecorder = new MediaRecorder(stream, {
               mimeType: mimeType,
               audioBitsPerSecond: 128000
             });
-            _this8.preRecordingPrompt = _this8.prompt;
-            _this8._audioInputSent = false;
+            _this7.preRecordingPrompt = _this7.prompt;
+            _this7._audioInputSent = false;
             var subject = new signalR.Subject();
-            var profileId = _this8.getProfileId();
-            var sessionId = _this8.getSessionId() || '';
+            var profileId = _this7.getProfileId();
+            var sessionId = _this7.getSessionId() || '';
             var pendingChunk = Promise.resolve();
-            _this8.mediaRecorder.addEventListener('dataavailable', function (e) {
+            _this7.mediaRecorder.addEventListener('dataavailable', function (e) {
               if (e.data && e.data.size > 0) {
-                pendingChunk = pendingChunk.then(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
+                pendingChunk = pendingChunk.then(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7() {
                   var data, uint8Array, binaryString, base64;
-                  return _regenerator().w(function (_context4) {
-                    while (1) switch (_context4.n) {
+                  return _regenerator().w(function (_context7) {
+                    while (1) switch (_context7.n) {
                       case 0:
-                        _context4.n = 1;
+                        _context7.n = 1;
                         return e.data.arrayBuffer();
                       case 1:
-                        data = _context4.v;
+                        data = _context7.v;
                         uint8Array = new Uint8Array(data);
                         binaryString = uint8Array.reduce(function (str, _byte) {
                           return str + String.fromCharCode(_byte);
@@ -1620,13 +1482,13 @@ window.openAIChatManager = function () {
                         base64 = btoa(binaryString);
                         subject.next(base64);
                       case 2:
-                        return _context4.a(2);
+                        return _context7.a(2);
                     }
-                  }, _callee4);
+                  }, _callee7);
                 })));
               }
             });
-            _this8.mediaRecorder.addEventListener('stop', function () {
+            _this7.mediaRecorder.addEventListener('stop', function () {
               stream.getTracks().forEach(function (track) {
                 return track.stop();
               });
@@ -1635,10 +1497,10 @@ window.openAIChatManager = function () {
               });
             });
             var language = navigator.language || document.documentElement.lang || 'en-US';
-            _this8.connection.send("SendAudioStream", profileId, sessionId, subject, mimeType, language);
-            _this8.mediaRecorder.start(250);
-            _this8.isRecording = true;
-            _this8.updateMicButton();
+            _this7.connection.send("SendAudioStream", profileId, sessionId, subject, mimeType, language);
+            _this7.mediaRecorder.start(250);
+            _this7.isRecording = true;
+            _this7.updateMicButton();
           })["catch"](function (err) {
             console.error('Microphone access denied:', err);
           });
@@ -1671,7 +1533,7 @@ window.openAIChatManager = function () {
           }
         },
         streamMessage: function streamMessage(profileId, trimmedPrompt, sessionProfileId) {
-          var _this9 = this;
+          var _this8 = this;
           if (this.stream) {
             this.stream.dispose();
             this.stream = null;
@@ -1688,14 +1550,14 @@ window.openAIChatManager = function () {
           var currentSessionId = this.getSessionId();
           this.stream = this.connection.stream("SendMessage", profileId, trimmedPrompt, currentSessionId, sessionProfileId).subscribe({
             next: function next(chunk) {
-              var message = _this9.messages[messageIndex];
+              var message = _this8.messages[messageIndex];
               if (!message) {
                 if (chunk.sessionId && !currentSessionId) {
-                  _this9.initializeSession(chunk.sessionId);
+                  _this8.initializeSession(chunk.sessionId);
                 }
-                _this9.hideTypingIndicator();
+                _this8.hideTypingIndicator();
                 // Re-assign the index after hiding the typing indicator.
-                messageIndex = _this9.messages.length;
+                messageIndex = _this8.messages.length;
                 var newMessage = {
                   id: chunk.messageId,
                   role: "assistant",
@@ -1705,16 +1567,16 @@ window.openAIChatManager = function () {
                   isStreaming: true,
                   userRating: null
                 };
-                _this9.messages.push(newMessage);
+                _this8.messages.push(newMessage);
                 message = newMessage;
               }
               if (chunk.title && (!message.title || message.title !== chunk.title)) {
                 message.title = chunk.title;
               }
               if (chunk.references && _typeof(chunk.references) === "object" && Object.keys(chunk.references).length) {
-                for (var _i3 = 0, _Object$entries2 = Object.entries(chunk.references); _i3 < _Object$entries2.length; _i3++) {
+                for (var _i4 = 0, _Object$entries2 = Object.entries(chunk.references); _i4 < _Object$entries2.length; _i4++) {
                   var _normalizeReference2;
-                  var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i3], 2),
+                  var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i4], 2),
                     key = _Object$entries2$_i[0],
                     value = _Object$entries2$_i[1];
                   references[key] = (_normalizeReference2 = normalizeReference(value)) !== null && _normalizeReference2 !== void 0 ? _normalizeReference2 : {};
@@ -1729,62 +1591,52 @@ window.openAIChatManager = function () {
                 if (chunk.responseId) {
                   lastResponseId = chunk.responseId;
                 }
-                var processedContent = chunk.content;
-                for (var _i4 = 0, _Object$entries3 = Object.entries(references); _i4 < _Object$entries3.length; _i4++) {
-                  var _Object$entries3$_i = _slicedToArray(_Object$entries3[_i4], 2),
-                    _key2 = _Object$entries3$_i[0],
-                    _value3 = _Object$entries3$_i[1];
-                  processedContent = processedContent.replaceAll(_key2, "<sup><strong>".concat(_value3.index, "</strong></sup>"));
-                }
-
-                // Append processed content to the message.
-                // if we have multiple references, add a comma to ensure we don't concatenate numbers.
-                content += processedContent.replaceAll('</strong></sup><sup>', '</strong></sup><sup>,</sup><sup>');
+                content += chunk.content;
               }
 
               // Update the existing message
-              message.content = content;
-              message.htmlContent = parseMarkdownContent(content, message);
-              _this9.messages[messageIndex] = message;
-              _this9.$nextTick(function () {
+              message.rawContent = content;
+              updateMessagePresentation(message, references);
+              _this8.messages[messageIndex] = message;
+              _this8.$nextTick(function () {
                 renderChartsInMessage(message);
-                _this9.scrollToBottom();
+                _this8.scrollToBottom();
               });
             },
             complete: function complete() {
-              var _this9$stream;
-              _this9.processReferences(references, messageIndex);
-              _this9.streamingFinished();
-              var msg = _this9.messages[messageIndex];
+              var _this8$stream;
+              _this8.processReferences(references, messageIndex);
+              _this8.streamingFinished();
+              var msg = _this8.messages[messageIndex];
               if (msg) {
                 msg.isStreaming = false;
               }
               if (!msg || !msg.content) {
                 // No content received at all.
-                _this9.hideTypingIndicator();
+                _this8.hideTypingIndicator();
               }
 
               // Trigger text-to-speech only in conversation mode.
-              if (_this9.isConversationMode && _this9.textToSpeechEnabled && msg && msg.content) {
-                _this9.synthesizeSpeech(msg.content);
+              if (_this8.isConversationMode && _this8.textToSpeechEnabled && msg && msg.content) {
+                _this8.synthesizeSpeech(msg.content);
               }
-              (_this9$stream = _this9.stream) === null || _this9$stream === void 0 || _this9$stream.dispose();
-              _this9.stream = null;
+              (_this8$stream = _this8.stream) === null || _this8$stream === void 0 || _this8$stream.dispose();
+              _this8.stream = null;
             },
             error: function error(err) {
-              var _this9$stream2;
-              _this9.processReferences(references, messageIndex);
-              _this9.streamingFinished();
-              var msg = _this9.messages[messageIndex];
+              var _this8$stream2;
+              _this8.processReferences(references, messageIndex);
+              _this8.streamingFinished();
+              var msg = _this8.messages[messageIndex];
               if (msg) {
                 msg.isStreaming = false;
               }
-              _this9.hideTypingIndicator();
-              if (!_this9.isNavigatingAway) {
-                _this9.addMessage(_this9.getServiceDownMessage());
+              _this8.hideTypingIndicator();
+              if (!_this8.isNavigatingAway) {
+                _this8.addMessage(_this8.getServiceDownMessage());
               }
-              (_this9$stream2 = _this9.stream) === null || _this9$stream2 === void 0 || _this9$stream2.dispose();
-              _this9.stream = null;
+              (_this8$stream2 = _this8.stream) === null || _this8$stream2 === void 0 || _this8$stream2.dispose();
+              _this8.stream = null;
               console.error("Stream error:", err);
             }
           });
@@ -1798,92 +1650,17 @@ window.openAIChatManager = function () {
           return newMessage;
         },
         processReferences: function processReferences(references, messageIndex) {
-          var _this0 = this;
+          var _this9 = this;
           references = normalizeReferences(references);
           if (Object.keys(references).length) {
+            var _ref15, _message$rawContent2;
             var message = this.messages[messageIndex];
-            var content = message.content || '';
-
-            // Only include references that were actually cited in the response.
-            // Check both raw [doc:N] markers and already-rendered <sup> tags from streaming.
-            var citedRefs = Object.entries(references).filter(function (_ref1) {
-              var _ref10 = _slicedToArray(_ref1, 2),
-                key = _ref10[0],
-                value = _ref10[1];
-              return content.includes(key) || content.includes("<sup><strong>".concat(value.index, "</strong></sup>"));
-            });
-            if (!citedRefs.length) {
-              return;
-            }
-
-            // Sort by original index so display indices follow a natural order.
-            citedRefs.sort(function (_ref11, _ref12) {
-              var _ref13 = _slicedToArray(_ref11, 2),
-                a = _ref13[1];
-              var _ref14 = _slicedToArray(_ref12, 2),
-                b = _ref14[1];
-              return a.index - b.index;
-            });
-
-            // Phase 1: Replace all markers with unique placeholders to avoid collisions during remapping.
-            var processed = content.trim();
-            var displayIndex = 1;
-            var _iterator5 = _createForOfIteratorHelper(citedRefs),
-              _step5;
-            try {
-              for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-                var _step5$value = _slicedToArray(_step5.value, 2),
-                  key = _step5$value[0],
-                  value = _step5$value[1];
-                var placeholder = "__CITE_".concat(value.index, "__");
-                processed = processed.replaceAll(key, placeholder);
-                processed = processed.replaceAll("<sup><strong>".concat(value.index, "</strong></sup>"), placeholder);
-                value._displayIndex = displayIndex++;
-                value._placeholder = placeholder;
-              }
-
-              // Phase 2: Replace placeholders with sequential display indices.
-            } catch (err) {
-              _iterator5.e(err);
-            } finally {
-              _iterator5.f();
-            }
-            var _iterator6 = _createForOfIteratorHelper(citedRefs),
-              _step6;
-            try {
-              for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-                var _step6$value = _slicedToArray(_step6.value, 2),
-                  _value4 = _step6$value[1];
-                processed = processed.replaceAll(_value4._placeholder, "<sup><strong>".concat(_value4._displayIndex, "</strong></sup>"));
-              }
-            } catch (err) {
-              _iterator6.e(err);
-            } finally {
-              _iterator6.f();
-            }
-            processed = processed.replaceAll('</strong></sup><sup>', '</strong></sup><sup>,</sup><sup>');
-            processed += '<br><br>';
-            var _iterator7 = _createForOfIteratorHelper(citedRefs),
-              _step7;
-            try {
-              for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
-                var _step7$value = _slicedToArray(_step7.value, 2),
-                  _key3 = _step7$value[0],
-                  _value5 = _step7$value[1];
-                var label = _value5.text || _key3;
-                processed += _value5.link ? "**".concat(_value5._displayIndex, "**. [").concat(label, "](").concat(_value5.link, ")<br>") : "**".concat(_value5._displayIndex, "**. ").concat(label, "<br>");
-              }
-            } catch (err) {
-              _iterator7.e(err);
-            } finally {
-              _iterator7.f();
-            }
-            message.content = processed;
-            message.htmlContent = parseMarkdownContent(processed, message);
+            message.rawContent = (_ref15 = (_message$rawContent2 = message.rawContent) !== null && _message$rawContent2 !== void 0 ? _message$rawContent2 : message.content) !== null && _ref15 !== void 0 ? _ref15 : '';
+            updateMessagePresentation(message, references);
             this.messages[messageIndex] = message;
             this.$nextTick(function () {
               renderChartsInMessage(message);
-              _this0.scrollToBottom();
+              _this9.scrollToBottom();
             });
           }
         },
@@ -1933,6 +1710,23 @@ window.openAIChatManager = function () {
           }
           this.stopAudio(false);
         },
+        updateTtsPlaybackButtons: function updateTtsPlaybackButtons() {
+          var _this0 = this;
+          if (!this.chatContainer) {
+            return;
+          }
+          var buttons = this.chatContainer.querySelectorAll('[data-tts-message-index]');
+          buttons.forEach(function (button) {
+            var buttonIndex = Number(button.getAttribute('data-tts-message-index'));
+            var isPlaying = buttonIndex === _this0.ttsPlayingMessageIndex;
+            var iconHtml = isPlaying ? '<i class="fa-solid fa-circle-pause"></i>' : '<i class="fa-solid fa-circle-play"></i>';
+            button.classList.toggle('tts-playing', isPlaying);
+            button.setAttribute('title', isPlaying ? 'Pause audio' : 'Read aloud');
+            button.replaceChildren(DOMPurify.sanitize(iconHtml, {
+              RETURN_DOM_FRAGMENT: true
+            }));
+          });
+        },
         synthesizeSpeech: function synthesizeSpeech(text, cacheIndex) {
           var _this1 = this;
           if (!this.textToSpeechEnabled || !text || !this.connection) {
@@ -1946,9 +1740,13 @@ window.openAIChatManager = function () {
             _this1.isPlayingAudio = false;
             _this1.ttsPlayingMessageIndex = -1;
             _this1._ttsCacheIndex = -1;
+            _this1.$nextTick(function () {
+              return _this1.updateTtsPlaybackButtons();
+            });
           });
         },
         toggleMessageTts: function toggleMessageTts(message, index) {
+          var _this10 = this;
           if (this.ttsPlayingMessageIndex === index) {
             this.stopAudio();
             return;
@@ -1960,6 +1758,9 @@ window.openAIChatManager = function () {
             }
           }));
           this.ttsPlayingMessageIndex = index;
+          this.$nextTick(function () {
+            return _this10.updateTtsPlaybackButtons();
+          });
           if (this.ttsAudioCache[index]) {
             this.playAudioBlob(this.ttsAudioCache[index]);
             return;
@@ -1967,10 +1768,14 @@ window.openAIChatManager = function () {
           this.synthesizeSpeech(message.content, index);
         },
         playCollectedAudio: function playCollectedAudio() {
+          var _this11 = this;
           if (this.audioChunks.length === 0) {
             if (!this.currentAudioElement && this.audioPlayQueue.length === 0) {
               this.isPlayingAudio = false;
               this.ttsPlayingMessageIndex = -1;
+              this.$nextTick(function () {
+                return _this11.updateTtsPlaybackButtons();
+              });
             }
             return;
           }
@@ -1979,18 +1784,18 @@ window.openAIChatManager = function () {
           }, 0);
           var combined = new Uint8Array(totalLength);
           var offset = 0;
-          var _iterator8 = _createForOfIteratorHelper(this.audioChunks),
-            _step8;
+          var _iterator5 = _createForOfIteratorHelper(this.audioChunks),
+            _step5;
           try {
-            for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
-              var chunk = _step8.value;
+            for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+              var chunk = _step5.value;
               combined.set(chunk, offset);
               offset += chunk.length;
             }
           } catch (err) {
-            _iterator8.e(err);
+            _iterator5.e(err);
           } finally {
-            _iterator8.f();
+            _iterator5.f();
           }
           this.audioChunks = [];
           var blob = new Blob([combined], {
@@ -2009,45 +1814,53 @@ window.openAIChatManager = function () {
           this.playAudioBlob(blob);
         },
         playAudioBlob: function playAudioBlob(blob) {
-          var _this10 = this;
+          var _this12 = this;
           var url = URL.createObjectURL(blob);
           var audio = new Audio(url);
           this.currentAudioUrl = url;
           this.currentAudioElement = audio;
           this.isPlayingAudio = true;
           audio.addEventListener('ended', function () {
-            _this10.currentAudioElement = null;
-            _this10.currentAudioUrl = null;
+            _this12.currentAudioElement = null;
+            _this12.currentAudioUrl = null;
             URL.revokeObjectURL(url);
-            _this10.playNextInQueue();
+            _this12.playNextInQueue();
           });
           audio.addEventListener('error', function () {
-            _this10.currentAudioElement = null;
-            _this10.currentAudioUrl = null;
+            _this12.currentAudioElement = null;
+            _this12.currentAudioUrl = null;
             URL.revokeObjectURL(url);
-            _this10.playNextInQueue();
+            _this12.playNextInQueue();
           });
           audio.play()["catch"](function (err) {
             console.error("Audio playback error:", err);
-            _this10.currentAudioElement = null;
-            _this10.currentAudioUrl = null;
+            _this12.currentAudioElement = null;
+            _this12.currentAudioUrl = null;
             URL.revokeObjectURL(url);
-            _this10.audioPlayQueue = [];
-            _this10.isPlayingAudio = false;
-            _this10.ttsPlayingMessageIndex = -1;
+            _this12.audioPlayQueue = [];
+            _this12.isPlayingAudio = false;
+            _this12.ttsPlayingMessageIndex = -1;
+            _this12.$nextTick(function () {
+              return _this12.updateTtsPlaybackButtons();
+            });
           });
         },
         playNextInQueue: function playNextInQueue() {
+          var _this13 = this;
           if (this.audioPlayQueue.length > 0) {
             var nextBlob = this.audioPlayQueue.shift();
             this.playAudioBlob(nextBlob);
           } else {
             this.isPlayingAudio = false;
             this.ttsPlayingMessageIndex = -1;
+            this.$nextTick(function () {
+              return _this13.updateTtsPlaybackButtons();
+            });
             this.conversationModeOnAudioEnded();
           }
         },
         stopAudio: function stopAudio() {
+          var _this14 = this;
           if (this.currentAudioElement) {
             this.currentAudioElement.pause();
             this.currentAudioElement.currentTime = 0;
@@ -2061,6 +1874,9 @@ window.openAIChatManager = function () {
           this.audioPlayQueue = [];
           this.isPlayingAudio = false;
           this.ttsPlayingMessageIndex = -1;
+          this.$nextTick(function () {
+            return _this14.updateTtsPlaybackButtons();
+          });
         },
         toggleConversationMode: function toggleConversationMode() {
           if (this.isConversationMode) {
@@ -2070,7 +1886,7 @@ window.openAIChatManager = function () {
           }
         },
         startConversationMode: function startConversationMode() {
-          var _this11 = this;
+          var _this15 = this;
           if (!this.conversationModeEnabled || this.isConversationMode || !this.connection) {
             return;
           }
@@ -2090,12 +1906,12 @@ window.openAIChatManager = function () {
             }
           }).then(function (stream) {
             var mimeType = MediaRecorder.isTypeSupported('audio/ogg;codecs=opus') ? 'audio/ogg;codecs=opus' : MediaRecorder.isTypeSupported('audio/webm;codecs=opus') ? 'audio/webm;codecs=opus' : 'audio/webm';
-            _this11.mediaRecorder = new MediaRecorder(stream, {
+            _this15.mediaRecorder = new MediaRecorder(stream, {
               mimeType: mimeType,
               audioBitsPerSecond: 128000
             });
-            _this11._conversationSubject = new signalR.Subject();
-            _this11._conversationStream = stream;
+            _this15._conversationSubject = new signalR.Subject();
+            _this15._conversationStream = stream;
 
             // Create an AnalyserNode for volume-based interrupt detection.
             // During TTS playback, detect when the user speaks above
@@ -2104,20 +1920,20 @@ window.openAIChatManager = function () {
             // speaker echo so the STT stream has no gaps.
             var AudioCtx = window.AudioContext || window.webkitAudioContext;
             if (AudioCtx) {
-              _this11._conversationAudioCtx = new AudioCtx();
-              _this11._conversationAnalyser = _this11._conversationAudioCtx.createAnalyser();
-              _this11._conversationAnalyser.fftSize = 256;
-              var micSource = _this11._conversationAudioCtx.createMediaStreamSource(stream);
-              micSource.connect(_this11._conversationAnalyser);
+              _this15._conversationAudioCtx = new AudioCtx();
+              _this15._conversationAnalyser = _this15._conversationAudioCtx.createAnalyser();
+              _this15._conversationAnalyser.fftSize = 256;
+              var micSource = _this15._conversationAudioCtx.createMediaStreamSource(stream);
+              micSource.connect(_this15._conversationAnalyser);
             }
             var pendingChunk = Promise.resolve();
-            var analyser = _this11._conversationAnalyser;
+            var analyser = _this15._conversationAnalyser;
             var interruptVolumeThreshold = 30;
-            _this11.mediaRecorder.addEventListener('dataavailable', function (e) {
+            _this15.mediaRecorder.addEventListener('dataavailable', function (e) {
               if (e.data && e.data.size > 0) {
                 // During TTS playback, check mic volume to detect
                 // user interruption (speaking above threshold).
-                if (_this11.isPlayingAudio && analyser) {
+                if (_this15.isPlayingAudio && analyser) {
                   var freqData = new Uint8Array(analyser.frequencyBinCount);
                   analyser.getByteFrequencyData(freqData);
                   var sum = 0;
@@ -2127,61 +1943,61 @@ window.openAIChatManager = function () {
                   var avg = sum / freqData.length;
                   if (avg >= interruptVolumeThreshold) {
                     // User is speaking — interrupt TTS playback.
-                    _this11.stopAudio();
+                    _this15.stopAudio();
                   }
                 }
 
                 // Always send audio to STT — browser echo cancellation
                 // handles speaker echo; continuous audio avoids gaps
                 // that increase recognition latency.
-                pendingChunk = pendingChunk.then(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5() {
+                pendingChunk = pendingChunk.then(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8() {
                   var data, uint8Array, binaryString, base64;
-                  return _regenerator().w(function (_context5) {
-                    while (1) switch (_context5.n) {
+                  return _regenerator().w(function (_context8) {
+                    while (1) switch (_context8.n) {
                       case 0:
-                        _context5.n = 1;
+                        _context8.n = 1;
                         return e.data.arrayBuffer();
                       case 1:
-                        data = _context5.v;
+                        data = _context8.v;
                         uint8Array = new Uint8Array(data);
                         binaryString = uint8Array.reduce(function (str, _byte2) {
                           return str + String.fromCharCode(_byte2);
                         }, '');
                         base64 = btoa(binaryString);
                         try {
-                          _this11._conversationSubject.next(base64);
+                          _this15._conversationSubject.next(base64);
                         } catch (err) {
                           // Subject may have been completed already.
                         }
                       case 2:
-                        return _context5.a(2);
+                        return _context8.a(2);
                     }
-                  }, _callee5);
+                  }, _callee8);
                 })));
               }
             });
-            _this11.mediaRecorder.addEventListener('stop', function () {
+            _this15.mediaRecorder.addEventListener('stop', function () {
               stream.getTracks().forEach(function (track) {
                 return track.stop();
               });
               pendingChunk.then(function () {
                 try {
-                  _this11._conversationSubject.complete();
+                  _this15._conversationSubject.complete();
                 } catch (err) {
                   // Already completed.
                 }
               });
             });
-            var profileId = _this11.getProfileId();
-            var sessionId = _this11.getSessionId() || '';
+            var profileId = _this15.getProfileId();
+            var sessionId = _this15.getSessionId() || '';
             var language = navigator.language || document.documentElement.lang || 'en-US';
-            _this11.connection.send("StartConversation", profileId, sessionId, _this11._conversationSubject, mimeType, language);
-            _this11.mediaRecorder.start(250);
-            _this11.isRecording = true;
+            _this15.connection.send("StartConversation", profileId, sessionId, _this15._conversationSubject, mimeType, language);
+            _this15.mediaRecorder.start(250);
+            _this15.isRecording = true;
           })["catch"](function (err) {
             console.error('Microphone access denied:', err);
-            _this11.isConversationMode = false;
-            _this11.updateConversationButton();
+            _this15.isConversationMode = false;
+            _this15.updateConversationButton();
           });
         },
         stopConversationMode: function stopConversationMode() {
@@ -2308,7 +2124,7 @@ window.openAIChatManager = function () {
           return removedCount;
         },
         receiveNotification: function receiveNotification(notification) {
-          var _this12 = this;
+          var _this16 = this;
           if (!notification || !notification.type) {
             return;
           }
@@ -2323,7 +2139,7 @@ window.openAIChatManager = function () {
           }
           this.scheduleNotificationDismiss(notification);
           this.$nextTick(function () {
-            _this12.scrollToBottom();
+            _this16.scrollToBottom();
           });
         },
         updateNotification: function updateNotification(notification) {
@@ -2340,12 +2156,12 @@ window.openAIChatManager = function () {
           }
         },
         scheduleNotificationDismiss: function scheduleNotificationDismiss(notification) {
-          var _this13 = this;
+          var _this17 = this;
           if (!notification || !notification.type || !notification.autoDismissMs || notification.autoDismissMs <= 0) {
             return;
           }
           this.notificationDismissTimers[notification.type] = setTimeout(function () {
-            _this13.removeNotification(notification.type);
+            _this17.removeNotification(notification.type);
           }, notification.autoDismissMs);
         },
         clearNotificationDismiss: function clearNotificationDismiss(notificationType) {
@@ -2375,31 +2191,32 @@ window.openAIChatManager = function () {
           });
         },
         scrollToBottom: function scrollToBottom() {
-          var _this14 = this;
+          var _this18 = this;
           if (!this.autoScroll) {
             return;
           }
           setTimeout(function () {
-            _this14.chatContainer.scrollTop = _this14.chatContainer.scrollHeight - _this14.chatContainer.clientHeight;
+            _this18.chatContainer.scrollTop = _this18.chatContainer.scrollHeight - _this18.chatContainer.clientHeight;
           }, 50);
         },
         handleUserInput: function handleUserInput(event) {
           this.prompt = event.target.value;
         },
         getProfileId: function getProfileId() {
-          return this.inputElement.getAttribute('data-profile-id');
+          return this.inputElement ? this.inputElement.getAttribute('data-profile-id') : null;
         },
         setSessionId: function setSessionId(sessionId) {
+          if (!this.inputElement) {
+            return;
+          }
           this.inputElement.setAttribute('data-session-id', sessionId || '');
         },
         resetSession: function resetSession() {
           this.stopRecording();
+          this.rejectPendingSessionRequest('Session was reset.');
           this.setSessionId('');
           this.isSessionStarted = false;
           this.sessionRating = null;
-          if (this.widgetIsInitialized) {
-            localStorage.removeItem(this.chatWidgetStateSession);
-          }
           this.messages = [];
           this.documents = [];
           if (!config.autoCreateSession) {
@@ -2408,6 +2225,9 @@ window.openAIChatManager = function () {
           if (config.autoCreateSession) {
             this.startNewSession();
           }
+          if (widgetBehavior && typeof widgetBehavior.onSessionReset === 'function') {
+            widgetBehavior.onSessionReset(this, config);
+          }
         },
         startNewSession: function startNewSession() {
           if (!this.applyOrchestratorAvailability()) {
@@ -2417,16 +2237,94 @@ window.openAIChatManager = function () {
           if (!profileId || !this.connection) {
             return;
           }
-          this.connection.invoke("StartSession", profileId, null)["catch"](function (err) {
+          this.requestNewSession(profileId)["catch"](function (err) {
             return console.error(err);
           });
         },
+        ensureSessionForDocuments: function ensureSessionForDocuments(profileId) {
+          var _this19 = this;
+          return _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9() {
+            var sessionId;
+            return _regenerator().w(function (_context9) {
+              while (1) switch (_context9.n) {
+                case 0:
+                  sessionId = _this19.getSessionId();
+                  if (!sessionId) {
+                    _context9.n = 1;
+                    break;
+                  }
+                  return _context9.a(2, sessionId);
+                case 1:
+                  if (!(!profileId || !_this19.connection)) {
+                    _context9.n = 2;
+                    break;
+                  }
+                  return _context9.a(2, null);
+                case 2:
+                  _context9.n = 3;
+                  return _this19.requestNewSession(profileId);
+                case 3:
+                  return _context9.a(2, _context9.v);
+              }
+            }, _callee9);
+          }))();
+        },
+        requestNewSession: function requestNewSession(profileId) {
+          var _this20 = this;
+          if (this.pendingSessionPromise) {
+            return this.pendingSessionPromise;
+          }
+          if (!profileId || !this.connection) {
+            return Promise.resolve(null);
+          }
+          this.pendingSessionPromise = new Promise(function (resolve, reject) {
+            _this20.pendingSessionResolver = resolve;
+            _this20.pendingSessionRejector = reject;
+            _this20.pendingSessionTimeoutId = window.setTimeout(function () {
+              _this20.rejectPendingSessionRequest('Timed out while creating a chat session.');
+            }, 15000);
+          });
+          this.connection.invoke("StartSession", profileId, null)["catch"](function (err) {
+            _this20.rejectPendingSessionRequest(err);
+          });
+          return this.pendingSessionPromise;
+        },
+        resolvePendingSessionRequest: function resolvePendingSessionRequest(sessionId) {
+          if (this.pendingSessionResolver) {
+            this.pendingSessionResolver(sessionId);
+          }
+          this.clearPendingSessionRequest();
+        },
+        rejectPendingSessionRequest: function rejectPendingSessionRequest(error) {
+          if (this.pendingSessionRejector) {
+            this.pendingSessionRejector(error);
+          }
+          this.clearPendingSessionRequest();
+        },
+        clearPendingSessionRequest: function clearPendingSessionRequest() {
+          if (this.pendingSessionTimeoutId) {
+            window.clearTimeout(this.pendingSessionTimeoutId);
+          }
+          this.pendingSessionPromise = null;
+          this.pendingSessionResolver = null;
+          this.pendingSessionRejector = null;
+          this.pendingSessionTimeoutId = null;
+        },
         initializeApp: function initializeApp() {
-          var _this15 = this;
+          var _this21 = this;
           this.inputElement = document.querySelector(config.inputElementSelector);
           this.buttonElement = document.querySelector(config.sendButtonElementSelector);
           this.chatContainer = document.querySelector(config.chatContainerElementSelector);
           this.placeholder = document.querySelector(config.placeholderElementSelector);
+          if (!this.inputElement || !this.buttonElement || !this.chatContainer || !this.placeholder) {
+            console.error('AI chat app could not initialize because one or more required elements were not found.', {
+              inputElementSelector: config.inputElementSelector,
+              sendButtonElementSelector: config.sendButtonElementSelector,
+              chatContainerElementSelector: config.chatContainerElementSelector,
+              placeholderElementSelector: config.placeholderElementSelector
+            });
+            return false;
+          }
           this.applyOrchestratorAvailability();
           var sessionId = this.getSessionId();
           if (!hasWidgetConfig && sessionId) {
@@ -2451,7 +2349,7 @@ window.openAIChatManager = function () {
                 fileInput.accept = config.allowedExtensions;
               }
               fileInput.addEventListener('change', function (e) {
-                return _this15.handleFileInputChange(e);
+                return _this21.handleFileInputChange(e);
               });
               this.documentBar.parentElement.appendChild(fileInput);
 
@@ -2459,13 +2357,13 @@ window.openAIChatManager = function () {
               var inputArea = this.inputElement ? this.inputElement.closest('.ai-admin-widget-input, .text-bg-light') : null;
               if (inputArea) {
                 inputArea.addEventListener('dragover', function (e) {
-                  return _this15.handleDragOver(e);
+                  return _this21.handleDragOver(e);
                 });
                 inputArea.addEventListener('dragleave', function (e) {
-                  return _this15.handleDragLeave(e);
+                  return _this21.handleDragLeave(e);
                 });
                 inputArea.addEventListener('drop', function (e) {
-                  return _this15.handleDrop(e);
+                  return _this21.handleDrop(e);
                 });
               }
             }
@@ -2473,55 +2371,55 @@ window.openAIChatManager = function () {
 
           // Pause auto-scroll when the user manually scrolls up during streaming.
           this.chatContainer.addEventListener('scroll', function () {
-            if (!_this15.stream) {
+            if (!_this21.stream) {
               return;
             }
             var threshold = 30;
-            var atBottom = _this15.chatContainer.scrollHeight - _this15.chatContainer.clientHeight - _this15.chatContainer.scrollTop <= threshold;
-            _this15.autoScroll = atBottom;
+            var atBottom = _this21.chatContainer.scrollHeight - _this21.chatContainer.clientHeight - _this21.chatContainer.scrollTop <= threshold;
+            _this21.autoScroll = atBottom;
           });
           this.inputElement.addEventListener('keydown', function (event) {
-            if (_this15.stream != null) {
+            if (_this21.stream != null) {
               return;
             }
             if (event.key === "Enter" && !event.shiftKey) {
               event.preventDefault();
-              _this15.buttonElement.click();
+              _this21.buttonElement.click();
             }
           });
           this.inputElement.addEventListener('input', function (e) {
-            _this15.handleUserInput(e);
+            _this21.handleUserInput(e);
             if (e.target.value.trim()) {
-              _this15.buttonElement.removeAttribute('disabled');
+              _this21.buttonElement.removeAttribute('disabled');
             } else {
-              _this15.buttonElement.setAttribute('disabled', true);
+              _this21.buttonElement.setAttribute('disabled', true);
             }
           });
           this.buttonElement.addEventListener('click', function () {
-            if (_this15.stream != null) {
-              _this15.stream.dispose();
-              _this15.stream = null;
-              _this15.streamingFinished();
-              _this15.hideTypingIndicator();
+            if (_this21.stream != null) {
+              _this21.stream.dispose();
+              _this21.stream = null;
+              _this21.streamingFinished();
+              _this21.hideTypingIndicator();
 
               // Clean up: remove empty assistant message or stop streaming animation.
-              if (_this15.messages.length > 0) {
-                var lastMsg = _this15.messages[_this15.messages.length - 1];
+              if (_this21.messages.length > 0) {
+                var lastMsg = _this21.messages[_this21.messages.length - 1];
                 if (lastMsg.role === 'assistant' && !lastMsg.content) {
-                  _this15.messages.pop();
+                  _this21.messages.pop();
                 } else if (lastMsg.isStreaming) {
                   lastMsg.isStreaming = false;
                 }
               }
               return;
             }
-            _this15.sendMessage();
+            _this21.sendMessage();
           });
           var promptGenerators = document.getElementsByClassName('profile-generated-prompt');
           for (var i = 0; i < promptGenerators.length; i++) {
             promptGenerators[i].addEventListener('click', function (e) {
               e.preventDefault();
-              _this15.generatePrompt(e.target);
+              _this21.generatePrompt(e.target);
             });
           }
           var chatSessions = document.getElementsByClassName('chat-session-history-item');
@@ -2533,8 +2431,8 @@ window.openAIChatManager = function () {
                 console.error('an element with the class chat-session-history-item with no data-session-id set.');
                 return;
               }
-              _this15.loadSession(sessionId);
-              _this15.showChatScreen();
+              _this21.loadSession(sessionId);
+              _this21.showChatScreen();
             });
           }
           for (var _i5 = 0; _i5 < config.messages.length; _i5++) {
@@ -2543,7 +2441,7 @@ window.openAIChatManager = function () {
 
           // Update feedback icons in the DOM after initial messages have rendered.
           this.$nextTick(function () {
-            _this15.refreshAllFeedbackIcons();
+            _this21.refreshAllFeedbackIcons();
           });
 
           // Delegate click for code block copy buttons.
@@ -2575,7 +2473,7 @@ window.openAIChatManager = function () {
             if (this.micButton) {
               this.micButton.style.display = '';
               this.micButton.addEventListener('click', function () {
-                _this15.toggleRecording();
+                _this21.toggleRecording();
               });
             }
           }
@@ -2585,10 +2483,11 @@ window.openAIChatManager = function () {
             this.conversationButton = document.querySelector(config.conversationButtonElementSelector);
             if (this.conversationButton) {
               this.conversationButton.addEventListener('click', function () {
-                _this15.toggleConversationMode();
+                _this21.toggleConversationMode();
               });
             }
           }
+          return true;
         },
         loadSession: function loadSession(sessionId) {
           this.connection.invoke("LoadSession", sessionId)["catch"](function (err) {
@@ -2603,6 +2502,9 @@ window.openAIChatManager = function () {
         },
         initializeSession: function initializeSession(sessionId, force) {
           if (this.isSessionStarted && !force) {
+            if (sessionId && this.getSessionId() === sessionId) {
+              this.resolvePendingSessionRequest(sessionId);
+            }
             return;
           }
           this.fireEvent(new CustomEvent("initializingSessionOpenAIChat", {
@@ -2612,121 +2514,22 @@ window.openAIChatManager = function () {
           }));
           this.setSessionId(sessionId);
           this.isSessionStarted = true;
-          if (this.widgetIsInitialized) {
-            localStorage.setItem(this.chatWidgetStateSession, sessionId);
+          this.resolvePendingSessionRequest(sessionId);
+          if (widgetBehavior && typeof widgetBehavior.onSessionInitialized === 'function') {
+            widgetBehavior.onSessionInitialized(this, sessionId, config);
           }
         },
-        initializeWidget: function initializeWidget() {
-          var _this16 = this;
-          if (!config.widget.chatWidgetContainer) {
-            console.error('The widget chatWidgetContainer is required.');
-            return;
-          }
-          if (!config.widget.chatWidgetStateName) {
-            console.error('The widget chatWidgetStateName is required.');
-            return;
-          }
-          var chatWidgetContainer = document.querySelector(config.widget.chatWidgetContainer);
-          if (!chatWidgetContainer) {
-            return;
-          }
-          if (config.widget.chatHistorySection) {
-            this.chatHistorySection = document.querySelector(config.widget.chatHistorySection);
-          }
-          this.chatWidgetStateName = config.widget.chatWidgetStateName;
-          this.chatWidgetStateSession = config.widget.chatWidgetStateName + 'Session';
-          this.chatWidgetLayoutKey = config.widget.chatWidgetStateName + 'Layout';
-          this.widgetContainerElement = chatWidgetContainer;
-          this.widgetToggleButtonElement = config.widget.toggleButtonSelector ? document.querySelector(config.widget.toggleButtonSelector) : null;
-          this.widgetResetSizeButtonElement = config.widget.resetSizeButtonSelector ? document.querySelector(config.widget.resetSizeButtonSelector) : null;
-          this.widgetDefaultWidth = parsePixelValue(config.widget.defaultWidth) || parsePixelValue(window.getComputedStyle(chatWidgetContainer).width) || 380;
-          this.widgetDefaultHeight = parsePixelValue(config.widget.defaultHeight) || parsePixelValue(window.getComputedStyle(chatWidgetContainer).height) || 520;
-          this.widgetIsInitialized = true;
-          if (config.widget.enableResizing) {
-            chatWidgetContainer.classList.add('ai-chat-widget-resizable');
-            chatWidgetContainer.style.minWidth = (parsePixelValue(config.widget.minWidth) || 320) + 'px';
-            chatWidgetContainer.style.minHeight = (parsePixelValue(config.widget.minHeight) || 420) + 'px';
-            if (typeof ResizeObserver !== 'undefined') {
-              this.widgetResizeObserver = new ResizeObserver(function () {
-                _this16.persistWidgetPanelSize();
-                _this16.constrainWidgetElementsToViewport();
-                _this16.updateWidgetResetSizeButtonVisibility();
-              });
-              this.widgetResizeObserver.observe(chatWidgetContainer);
-            }
-          }
-          var dragHandleSelector = config.widget.dragHandleSelector || '.ai-chat-widget-header';
-          var dragHandle = chatWidgetContainer.querySelector(dragHandleSelector);
-          if (config.widget.enableDragging && dragHandle) {
-            dragHandle.classList.add('ai-chat-widget-drag-handle');
-            chatWidgetContainer.classList.add('ai-chat-widget-draggable');
-            this.attachDraggableWidgetElement(chatWidgetContainer, dragHandle, 'panel', false);
-          }
-          if (config.widget.enableDragging && this.widgetToggleButtonElement) {
-            this.widgetToggleButtonElement.classList.add('ai-chat-widget-draggable');
-            this.attachDraggableWidgetElement(this.widgetToggleButtonElement, this.widgetToggleButtonElement, 'toggle', true);
-          }
-          if (this.widgetResetSizeButtonElement) {
-            this.widgetResetSizeButtonElement.addEventListener('click', function (event) {
-              event.preventDefault();
-              _this16.resetWidgetSize();
-            });
-          }
-          this.restoreWidgetLayout();
-          if (!this.widgetViewportResizeHandler) {
-            this.widgetViewportResizeHandler = function () {
-              _this16.constrainWidgetElementsToViewport();
-              _this16.updateWidgetResetSizeButtonVisibility();
-            };
-            window.addEventListener('resize', this.widgetViewportResizeHandler);
-          }
-
-          // Auto-load the last session so the user always sees previous chat history.
-          this.reloadCurrentSession();
-          if (config.autoCreateSession && !this.getSessionId()) {
-            this.startNewSession();
-          }
-          if (config.widget.showHistoryButton && this.chatHistorySection) {
-            var showHistoryButton = document.querySelector(config.widget.showHistoryButton);
-            if (showHistoryButton) {
-              showHistoryButton.addEventListener('click', function () {
-                _this16.chatHistorySection.classList.toggle('show');
-              });
-            }
-            if (config.widget.closeHistoryButton) {
-              var closeHistoryButton = document.querySelector(config.widget.closeHistoryButton);
-              if (closeHistoryButton) {
-                closeHistoryButton.addEventListener('click', function () {
-                  _this16.showChatScreen();
-                });
-              }
-            }
-          }
-          if (config.widget.newChatButton) {
-            var newChatButton = document.querySelector(config.widget.newChatButton);
-            if (newChatButton) {
-              newChatButton.addEventListener('click', function () {
-                _this16.resetSession();
-                _this16.showChatScreen();
-              });
-            }
-          }
-        },
-        showChatScreen: function showChatScreen() {
-          if (!this.chatHistorySection) {
-            return;
-          }
-          this.chatHistorySection.classList.remove('show');
-        },
         getSessionId: function getSessionId() {
-          var sessionId = this.inputElement.getAttribute('data-session-id');
-          if (!sessionId && this.widgetIsInitialized) {
-            sessionId = localStorage.getItem(this.chatWidgetStateSession);
+          var sessionId = this.inputElement ? this.inputElement.getAttribute('data-session-id') : null;
+          if (!sessionId && widgetBehavior && typeof widgetBehavior.resolveSessionId === 'function') {
+            sessionId = widgetBehavior.resolveSessionId(this, config);
           }
           return sessionId;
         },
         copyResponse: function copyResponse(message) {
-          navigator.clipboard.writeText(message);
+          var _ref17, _message$copyContent;
+          var text = message && _typeof(message) === 'object' ? (_ref17 = (_message$copyContent = message.copyContent) !== null && _message$copyContent !== void 0 ? _message$copyContent : message.content) !== null && _ref17 !== void 0 ? _ref17 : '' : message !== null && message !== void 0 ? message : '';
+          navigator.clipboard.writeText(text);
         },
         updateFeedbackIcons: function updateFeedbackIcons(container, userRating) {
           if (!container) {
@@ -2735,11 +2538,11 @@ window.openAIChatManager = function () {
           var upBtn = container.querySelector('.rate-up-btn');
           var downBtn = container.querySelector('.rate-down-btn');
 
-          // Font Awesome SVG+JS replaces <i> with <svg>, so we must replace
-          // the entire button content and let Font Awesome re-process.
+          // Keep feedback icons as simple span-based Font Awesome markup so
+          // later state updates do not depend on i2svg replacement.
           if (upBtn) {
             var upClass = userRating === true ? 'fa-solid fa-thumbs-up' : 'fa-regular fa-thumbs-up';
-            var upIcon = document.createElement('i');
+            var upIcon = document.createElement('span');
             upIcon.className = upClass;
             upIcon.style.fontSize = '0.9rem';
             upBtn.textContent = '';
@@ -2747,19 +2550,12 @@ window.openAIChatManager = function () {
           }
           if (downBtn) {
             var downClass = userRating === false ? 'fa-solid fa-thumbs-down' : 'fa-regular fa-thumbs-down';
-            var downIcon = document.createElement('i');
+            var downIcon = document.createElement('span');
             downIcon.className = downClass;
             downIcon.style.fontSize = '0.9rem';
             downBtn.textContent = '';
             downBtn.appendChild(downIcon);
           }
-
-          // Trigger Font Awesome SVG+JS to convert the new <i> elements.
-          if (window.FontAwesome && FontAwesome.dom && FontAwesome.dom.i2svg) {
-            FontAwesome.dom.i2svg({
-              node: container
-            });
-          }
         },
         refreshAllFeedbackIcons: function refreshAllFeedbackIcons() {
           var containers = this.$el.querySelectorAll('.ai-chat-message-assistant-feedback');
@@ -2812,12 +2608,18 @@ window.openAIChatManager = function () {
         documents: {
           handler: function handler() {
             this.renderDocumentBar();
+            if (widgetBehavior && typeof widgetBehavior.onDocumentsChanged === 'function') {
+              widgetBehavior.onDocumentsChanged(this, this.documents, config);
+            }
           },
           deep: true
         },
         isUploading: function isUploading() {
           this.renderDocumentBar();
         },
+        isDocumentOperationPending: function isDocumentOperationPending() {
+          this.renderDocumentBar();
+        },
         isPlayingAudio: function isPlayingAudio() {
           // Reserved for future use — volume-based interrupt detection
           // no longer mutes tracks; browser echo cancellation handles echo.
@@ -2843,22 +2645,27 @@ window.openAIChatManager = function () {
         }
       },
       mounted: function mounted() {
-        var _this17 = this;
-        _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6() {
-          return _regenerator().w(function (_context6) {
-            while (1) switch (_context6.n) {
+        var _this22 = this;
+        _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0() {
+          var isInitialized;
+          return _regenerator().w(function (_context0) {
+            while (1) switch (_context0.n) {
               case 0:
-                _context6.n = 1;
-                return _this17.startConnection();
+                _context0.n = 1;
+                return _this22.startConnection();
               case 1:
-                _this17.initializeApp();
-                if (hasWidgetConfig) {
-                  _this17.initializeWidget();
+                isInitialized = _this22.initializeApp();
+                if (isInitialized && hasWidgetConfig && widgetBehavior && typeof widgetBehavior.onMounted === 'function') {
+                  widgetBehavior.onMounted(_this22, config);
                 }
+                _this22.$nextTick(function () {
+                  refreshFontAwesomeIcons(_this22.$el);
+                  _this22.fontAwesomeObserver = observeFontAwesomeIcons(_this22.$el);
+                });
               case 2:
-                return _context6.a(2);
+                return _context0.a(2);
             }
-          }, _callee6);
+          }, _callee0);
         }))();
         window.addEventListener('beforeunload', this.handleBeforeUnload);
         window.addEventListener('crestapps-ai-chat-stop-tts', this.handleExternalTtsStop);
@@ -2866,6 +2673,10 @@ window.openAIChatManager = function () {
       beforeUnmount: function beforeUnmount() {
         window.removeEventListener('beforeunload', this.handleBeforeUnload);
         window.removeEventListener('crestapps-ai-chat-stop-tts', this.handleExternalTtsStop);
+        if (this.fontAwesomeObserver) {
+          this.fontAwesomeObserver.disconnect();
+          this.fontAwesomeObserver = null;
+        }
         this.stopAudio(false);
         if (this.stream) {
           this.stream.dispose();
@@ -2874,9 +2685,16 @@ window.openAIChatManager = function () {
         if (this.connection) {
           this.connection.stop();
         }
+        if (widgetBehavior && typeof widgetBehavior.onBeforeUnmount === 'function') {
+          widgetBehavior.onBeforeUnmount(this, config);
+        }
       },
       template: config.messageTemplate
-    }).mount(config.appElementSelector);
+    };
+    var app = Vue.createApp(appDefinition).mount(config.appElementSelector);
+    if (widgetBehavior && typeof widgetBehavior.attach === 'function') {
+      widgetBehavior.attach(app, config);
+    }
     return app;
   };
   return {