@crestapps/ai-chat-ui 1.0.0-preview.10 → 1.0.0-preview.12

package/dist/ai-chat.js

@@ -363,6 +363,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 +386,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 +395,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 +404,8 @@ window.openAIChatManager = function () {
           prompt: '',
           documents: config.existingDocuments || [],
           isUploading: false,
+          isDocumentOperationPending: false,
+          documentOperationQueue: null,
           uploadErrors: [],
           isDragOver: false,
           documentBar: null,
@@ -444,7 +435,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 +456,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 +480,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 +769,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 += '<span class="fa-solid fa-file-lines" style="font-size: 0.7rem;"></span> ';
             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 +788,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 += '<span class="fa-solid fa-paperclip"></span>';
           if (this.documents.length === 0 && !this.isUploading) {
             html += ' <span>Attach files</span>';
@@ -1054,6 +811,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 +838,9 @@ window.openAIChatManager = function () {
           if (addBtn) {
             addBtn.addEventListener('click', function (e) {
               e.preventDefault();
+              if (self.isDocumentOperationPending) {
+                return;
+              }
               self.triggerFileInput();
             });
           }
@@ -1154,139 +917,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, 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 +1053,96 @@ window.openAIChatManager = function () {
                         htmlContent: "",
                         isStreaming: true,
                         userRating: null,
-                        appearance: _this4.normalizeAssistantAppearance(appearance)
+                        appearance: _this3.normalizeAssistantAppearance(appearance)
                       };
-                      _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.content = _this3._conversationAssistantMessage.content;
                       msg.htmlContent = parseMarkdownContent(msg.content, msg);
-                      _this4.$nextTick(function () {
+                      _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) {
+                    if (_this3._conversationAssistantMessage) {
+                      var msg = _this3.messages[_this3._conversationAssistantMessage.index];
                       if (msg) {
                         msg.isStreaming = false;
                       }
-                      _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 +1156,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,7 +1164,7 @@ 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;
@@ -1415,18 +1174,18 @@ window.openAIChatManager = function () {
             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];
+              var citedRefs = Object.entries(message.references).filter(function (_ref7) {
+                var _ref8 = _slicedToArray(_ref7, 1),
+                  key = _ref8[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];
+                citedRefs.sort(function (_ref9, _ref0) {
+                  var _ref1 = _slicedToArray(_ref9, 2),
+                    a = _ref1[1];
+                  var _ref10 = _slicedToArray(_ref0, 2),
+                    b = _ref10[1];
                   return a.index - b.index;
                 });
 
@@ -1493,17 +1252,17 @@ window.openAIChatManager = function () {
           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 +1339,7 @@ window.openAIChatManager = function () {
           this.prompt = '';
         },
         startRecording: function startRecording() {
-          var _this8 = this;
+          var _this7 = this;
           if (this.isRecording || !this.connection) {
             return;
           }
@@ -1592,27 +1351,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 +1379,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 +1394,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 +1430,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 +1447,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,7 +1464,7 @@ 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)) {
@@ -1745,46 +1504,46 @@ window.openAIChatManager = function () {
               // Update the existing message
               message.content = content;
               message.htmlContent = parseMarkdownContent(content, message);
-              _this9.messages[messageIndex] = message;
-              _this9.$nextTick(function () {
+              _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,7 +1557,7 @@ 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 message = this.messages[messageIndex];
@@ -1806,10 +1565,10 @@ window.openAIChatManager = function () {
 
             // 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];
+            var citedRefs = Object.entries(references).filter(function (_ref12) {
+              var _ref13 = _slicedToArray(_ref12, 2),
+                key = _ref13[0],
+                value = _ref13[1];
               return content.includes(key) || content.includes("<sup><strong>".concat(value.index, "</strong></sup>"));
             });
             if (!citedRefs.length) {
@@ -1817,11 +1576,11 @@ window.openAIChatManager = function () {
             }
 
             // 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];
+            citedRefs.sort(function (_ref14, _ref15) {
+              var _ref16 = _slicedToArray(_ref14, 2),
+                a = _ref16[1];
+              var _ref17 = _slicedToArray(_ref15, 2),
+                b = _ref17[1];
               return a.index - b.index;
             });
 
@@ -1883,7 +1642,7 @@ window.openAIChatManager = function () {
             this.messages[messageIndex] = message;
             this.$nextTick(function () {
               renderChartsInMessage(message);
-              _this0.scrollToBottom();
+              _this9.scrollToBottom();
             });
           }
         },
@@ -1934,14 +1693,14 @@ window.openAIChatManager = function () {
           this.stopAudio(false);
         },
         updateTtsPlaybackButtons: function updateTtsPlaybackButtons() {
-          var _this1 = this;
+          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 === _this1.ttsPlayingMessageIndex;
+            var isPlaying = buttonIndex === _this0.ttsPlayingMessageIndex;
             var iconHtml = isPlaying ? '<span class="fa-solid fa-circle-pause"></span>' : '<span class="fa-solid fa-circle-play"></span>';
             button.classList.toggle('tts-playing', isPlaying);
             button.setAttribute('title', isPlaying ? 'Pause audio' : 'Read aloud');
@@ -1951,7 +1710,7 @@ window.openAIChatManager = function () {
           });
         },
         synthesizeSpeech: function synthesizeSpeech(text, cacheIndex) {
-          var _this10 = this;
+          var _this1 = this;
           if (!this.textToSpeechEnabled || !text || !this.connection) {
             return;
           }
@@ -1960,16 +1719,16 @@ window.openAIChatManager = function () {
           this._ttsCacheIndex = cacheIndex !== undefined ? cacheIndex : -1;
           this.connection.invoke("SynthesizeSpeech", this.getProfileId(), this.getSessionId(), text, this.ttsVoiceName)["catch"](function (err) {
             console.error("TTS synthesis error:", err);
-            _this10.isPlayingAudio = false;
-            _this10.ttsPlayingMessageIndex = -1;
-            _this10._ttsCacheIndex = -1;
-            _this10.$nextTick(function () {
-              return _this10.updateTtsPlaybackButtons();
+            _this1.isPlayingAudio = false;
+            _this1.ttsPlayingMessageIndex = -1;
+            _this1._ttsCacheIndex = -1;
+            _this1.$nextTick(function () {
+              return _this1.updateTtsPlaybackButtons();
             });
           });
         },
         toggleMessageTts: function toggleMessageTts(message, index) {
-          var _this11 = this;
+          var _this10 = this;
           if (this.ttsPlayingMessageIndex === index) {
             this.stopAudio();
             return;
@@ -1982,7 +1741,7 @@ window.openAIChatManager = function () {
           }));
           this.ttsPlayingMessageIndex = index;
           this.$nextTick(function () {
-            return _this11.updateTtsPlaybackButtons();
+            return _this10.updateTtsPlaybackButtons();
           });
           if (this.ttsAudioCache[index]) {
             this.playAudioBlob(this.ttsAudioCache[index]);
@@ -1991,13 +1750,13 @@ window.openAIChatManager = function () {
           this.synthesizeSpeech(message.content, index);
         },
         playCollectedAudio: function playCollectedAudio() {
-          var _this12 = this;
+          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 _this12.updateTtsPlaybackButtons();
+                return _this11.updateTtsPlaybackButtons();
               });
             }
             return;
@@ -2037,39 +1796,39 @@ window.openAIChatManager = function () {
           this.playAudioBlob(blob);
         },
         playAudioBlob: function playAudioBlob(blob) {
-          var _this13 = 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 () {
-            _this13.currentAudioElement = null;
-            _this13.currentAudioUrl = null;
+            _this12.currentAudioElement = null;
+            _this12.currentAudioUrl = null;
             URL.revokeObjectURL(url);
-            _this13.playNextInQueue();
+            _this12.playNextInQueue();
           });
           audio.addEventListener('error', function () {
-            _this13.currentAudioElement = null;
-            _this13.currentAudioUrl = null;
+            _this12.currentAudioElement = null;
+            _this12.currentAudioUrl = null;
             URL.revokeObjectURL(url);
-            _this13.playNextInQueue();
+            _this12.playNextInQueue();
           });
           audio.play()["catch"](function (err) {
             console.error("Audio playback error:", err);
-            _this13.currentAudioElement = null;
-            _this13.currentAudioUrl = null;
+            _this12.currentAudioElement = null;
+            _this12.currentAudioUrl = null;
             URL.revokeObjectURL(url);
-            _this13.audioPlayQueue = [];
-            _this13.isPlayingAudio = false;
-            _this13.ttsPlayingMessageIndex = -1;
-            _this13.$nextTick(function () {
-              return _this13.updateTtsPlaybackButtons();
+            _this12.audioPlayQueue = [];
+            _this12.isPlayingAudio = false;
+            _this12.ttsPlayingMessageIndex = -1;
+            _this12.$nextTick(function () {
+              return _this12.updateTtsPlaybackButtons();
             });
           });
         },
         playNextInQueue: function playNextInQueue() {
-          var _this14 = this;
+          var _this13 = this;
           if (this.audioPlayQueue.length > 0) {
             var nextBlob = this.audioPlayQueue.shift();
             this.playAudioBlob(nextBlob);
@@ -2077,13 +1836,13 @@ window.openAIChatManager = function () {
             this.isPlayingAudio = false;
             this.ttsPlayingMessageIndex = -1;
             this.$nextTick(function () {
-              return _this14.updateTtsPlaybackButtons();
+              return _this13.updateTtsPlaybackButtons();
             });
             this.conversationModeOnAudioEnded();
           }
         },
         stopAudio: function stopAudio() {
-          var _this15 = this;
+          var _this14 = this;
           if (this.currentAudioElement) {
             this.currentAudioElement.pause();
             this.currentAudioElement.currentTime = 0;
@@ -2098,7 +1857,7 @@ window.openAIChatManager = function () {
           this.isPlayingAudio = false;
           this.ttsPlayingMessageIndex = -1;
           this.$nextTick(function () {
-            return _this15.updateTtsPlaybackButtons();
+            return _this14.updateTtsPlaybackButtons();
           });
         },
         toggleConversationMode: function toggleConversationMode() {
@@ -2109,7 +1868,7 @@ window.openAIChatManager = function () {
           }
         },
         startConversationMode: function startConversationMode() {
-          var _this16 = this;
+          var _this15 = this;
           if (!this.conversationModeEnabled || this.isConversationMode || !this.connection) {
             return;
           }
@@ -2129,12 +1888,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';
-            _this16.mediaRecorder = new MediaRecorder(stream, {
+            _this15.mediaRecorder = new MediaRecorder(stream, {
               mimeType: mimeType,
               audioBitsPerSecond: 128000
             });
-            _this16._conversationSubject = new signalR.Subject();
-            _this16._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
@@ -2143,20 +1902,20 @@ window.openAIChatManager = function () {
             // speaker echo so the STT stream has no gaps.
             var AudioCtx = window.AudioContext || window.webkitAudioContext;
             if (AudioCtx) {
-              _this16._conversationAudioCtx = new AudioCtx();
-              _this16._conversationAnalyser = _this16._conversationAudioCtx.createAnalyser();
-              _this16._conversationAnalyser.fftSize = 256;
-              var micSource = _this16._conversationAudioCtx.createMediaStreamSource(stream);
-              micSource.connect(_this16._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 = _this16._conversationAnalyser;
+            var analyser = _this15._conversationAnalyser;
             var interruptVolumeThreshold = 30;
-            _this16.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 (_this16.isPlayingAudio && analyser) {
+                if (_this15.isPlayingAudio && analyser) {
                   var freqData = new Uint8Array(analyser.frequencyBinCount);
                   analyser.getByteFrequencyData(freqData);
                   var sum = 0;
@@ -2166,61 +1925,61 @@ window.openAIChatManager = function () {
                   var avg = sum / freqData.length;
                   if (avg >= interruptVolumeThreshold) {
                     // User is speaking — interrupt TTS playback.
-                    _this16.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 {
-                          _this16._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);
                 })));
               }
             });
-            _this16.mediaRecorder.addEventListener('stop', function () {
+            _this15.mediaRecorder.addEventListener('stop', function () {
               stream.getTracks().forEach(function (track) {
                 return track.stop();
               });
               pendingChunk.then(function () {
                 try {
-                  _this16._conversationSubject.complete();
+                  _this15._conversationSubject.complete();
                 } catch (err) {
                   // Already completed.
                 }
               });
             });
-            var profileId = _this16.getProfileId();
-            var sessionId = _this16.getSessionId() || '';
+            var profileId = _this15.getProfileId();
+            var sessionId = _this15.getSessionId() || '';
             var language = navigator.language || document.documentElement.lang || 'en-US';
-            _this16.connection.send("StartConversation", profileId, sessionId, _this16._conversationSubject, mimeType, language);
-            _this16.mediaRecorder.start(250);
-            _this16.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);
-            _this16.isConversationMode = false;
-            _this16.updateConversationButton();
+            _this15.isConversationMode = false;
+            _this15.updateConversationButton();
           });
         },
         stopConversationMode: function stopConversationMode() {
@@ -2347,7 +2106,7 @@ window.openAIChatManager = function () {
           return removedCount;
         },
         receiveNotification: function receiveNotification(notification) {
-          var _this17 = this;
+          var _this16 = this;
           if (!notification || !notification.type) {
             return;
           }
@@ -2362,7 +2121,7 @@ window.openAIChatManager = function () {
           }
           this.scheduleNotificationDismiss(notification);
           this.$nextTick(function () {
-            _this17.scrollToBottom();
+            _this16.scrollToBottom();
           });
         },
         updateNotification: function updateNotification(notification) {
@@ -2379,12 +2138,12 @@ window.openAIChatManager = function () {
           }
         },
         scheduleNotificationDismiss: function scheduleNotificationDismiss(notification) {
-          var _this18 = this;
+          var _this17 = this;
           if (!notification || !notification.type || !notification.autoDismissMs || notification.autoDismissMs <= 0) {
             return;
           }
           this.notificationDismissTimers[notification.type] = setTimeout(function () {
-            _this18.removeNotification(notification.type);
+            _this17.removeNotification(notification.type);
           }, notification.autoDismissMs);
         },
         clearNotificationDismiss: function clearNotificationDismiss(notificationType) {
@@ -2414,31 +2173,32 @@ window.openAIChatManager = function () {
           });
         },
         scrollToBottom: function scrollToBottom() {
-          var _this19 = this;
+          var _this18 = this;
           if (!this.autoScroll) {
             return;
           }
           setTimeout(function () {
-            _this19.chatContainer.scrollTop = _this19.chatContainer.scrollHeight - _this19.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) {
@@ -2447,6 +2207,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()) {
@@ -2456,16 +2219,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);
           });
         },
-        initializeApp: function initializeApp() {
+        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 _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) {
@@ -2490,7 +2331,7 @@ window.openAIChatManager = function () {
                 fileInput.accept = config.allowedExtensions;
               }
               fileInput.addEventListener('change', function (e) {
-                return _this20.handleFileInputChange(e);
+                return _this21.handleFileInputChange(e);
               });
               this.documentBar.parentElement.appendChild(fileInput);
 
@@ -2498,13 +2339,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 _this20.handleDragOver(e);
+                  return _this21.handleDragOver(e);
                 });
                 inputArea.addEventListener('dragleave', function (e) {
-                  return _this20.handleDragLeave(e);
+                  return _this21.handleDragLeave(e);
                 });
                 inputArea.addEventListener('drop', function (e) {
-                  return _this20.handleDrop(e);
+                  return _this21.handleDrop(e);
                 });
               }
             }
@@ -2512,55 +2353,55 @@ window.openAIChatManager = function () {
 
           // Pause auto-scroll when the user manually scrolls up during streaming.
           this.chatContainer.addEventListener('scroll', function () {
-            if (!_this20.stream) {
+            if (!_this21.stream) {
               return;
             }
             var threshold = 30;
-            var atBottom = _this20.chatContainer.scrollHeight - _this20.chatContainer.clientHeight - _this20.chatContainer.scrollTop <= threshold;
-            _this20.autoScroll = atBottom;
+            var atBottom = _this21.chatContainer.scrollHeight - _this21.chatContainer.clientHeight - _this21.chatContainer.scrollTop <= threshold;
+            _this21.autoScroll = atBottom;
           });
           this.inputElement.addEventListener('keydown', function (event) {
-            if (_this20.stream != null) {
+            if (_this21.stream != null) {
               return;
             }
             if (event.key === "Enter" && !event.shiftKey) {
               event.preventDefault();
-              _this20.buttonElement.click();
+              _this21.buttonElement.click();
             }
           });
           this.inputElement.addEventListener('input', function (e) {
-            _this20.handleUserInput(e);
+            _this21.handleUserInput(e);
             if (e.target.value.trim()) {
-              _this20.buttonElement.removeAttribute('disabled');
+              _this21.buttonElement.removeAttribute('disabled');
             } else {
-              _this20.buttonElement.setAttribute('disabled', true);
+              _this21.buttonElement.setAttribute('disabled', true);
             }
           });
           this.buttonElement.addEventListener('click', function () {
-            if (_this20.stream != null) {
-              _this20.stream.dispose();
-              _this20.stream = null;
-              _this20.streamingFinished();
-              _this20.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 (_this20.messages.length > 0) {
-                var lastMsg = _this20.messages[_this20.messages.length - 1];
+              if (_this21.messages.length > 0) {
+                var lastMsg = _this21.messages[_this21.messages.length - 1];
                 if (lastMsg.role === 'assistant' && !lastMsg.content) {
-                  _this20.messages.pop();
+                  _this21.messages.pop();
                 } else if (lastMsg.isStreaming) {
                   lastMsg.isStreaming = false;
                 }
               }
               return;
             }
-            _this20.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();
-              _this20.generatePrompt(e.target);
+              _this21.generatePrompt(e.target);
             });
           }
           var chatSessions = document.getElementsByClassName('chat-session-history-item');
@@ -2572,8 +2413,8 @@ window.openAIChatManager = function () {
                 console.error('an element with the class chat-session-history-item with no data-session-id set.');
                 return;
               }
-              _this20.loadSession(sessionId);
-              _this20.showChatScreen();
+              _this21.loadSession(sessionId);
+              _this21.showChatScreen();
             });
           }
           for (var _i5 = 0; _i5 < config.messages.length; _i5++) {
@@ -2582,7 +2423,7 @@ window.openAIChatManager = function () {
 
           // Update feedback icons in the DOM after initial messages have rendered.
           this.$nextTick(function () {
-            _this20.refreshAllFeedbackIcons();
+            _this21.refreshAllFeedbackIcons();
           });
 
           // Delegate click for code block copy buttons.
@@ -2614,7 +2455,7 @@ window.openAIChatManager = function () {
             if (this.micButton) {
               this.micButton.style.display = '';
               this.micButton.addEventListener('click', function () {
-                _this20.toggleRecording();
+                _this21.toggleRecording();
               });
             }
           }
@@ -2624,10 +2465,11 @@ window.openAIChatManager = function () {
             this.conversationButton = document.querySelector(config.conversationButtonElementSelector);
             if (this.conversationButton) {
               this.conversationButton.addEventListener('click', function () {
-                _this20.toggleConversationMode();
+                _this21.toggleConversationMode();
               });
             }
           }
+          return true;
         },
         loadSession: function loadSession(sessionId) {
           this.connection.invoke("LoadSession", sessionId)["catch"](function (err) {
@@ -2642,6 +2484,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", {
@@ -2651,116 +2496,15 @@ 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 _this21 = 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 () {
-                _this21.persistWidgetPanelSize();
-                _this21.constrainWidgetElementsToViewport();
-                _this21.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();
-              _this21.resetWidgetSize();
-            });
-          }
-          this.restoreWidgetLayout();
-          if (!this.widgetViewportResizeHandler) {
-            this.widgetViewportResizeHandler = function () {
-              _this21.constrainWidgetElementsToViewport();
-              _this21.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 () {
-                _this21.chatHistorySection.classList.toggle('show');
-              });
-            }
-            if (config.widget.closeHistoryButton) {
-              var closeHistoryButton = document.querySelector(config.widget.closeHistoryButton);
-              if (closeHistoryButton) {
-                closeHistoryButton.addEventListener('click', function () {
-                  _this21.showChatScreen();
-                });
-              }
-            }
-          }
-          if (config.widget.newChatButton) {
-            var newChatButton = document.querySelector(config.widget.newChatButton);
-            if (newChatButton) {
-              newChatButton.addEventListener('click', function () {
-                _this21.resetSession();
-                _this21.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;
         },
@@ -2844,12 +2588,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.
@@ -2876,21 +2626,22 @@ window.openAIChatManager = function () {
       },
       mounted: function mounted() {
         var _this22 = this;
-        _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6() {
-          return _regenerator().w(function (_context6) {
-            while (1) switch (_context6.n) {
+        _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0() {
+          var isInitialized;
+          return _regenerator().w(function (_context0) {
+            while (1) switch (_context0.n) {
               case 0:
-                _context6.n = 1;
+                _context0.n = 1;
                 return _this22.startConnection();
               case 1:
-                _this22.initializeApp();
-                if (hasWidgetConfig) {
-                  _this22.initializeWidget();
+                isInitialized = _this22.initializeApp();
+                if (isInitialized && hasWidgetConfig && widgetBehavior && typeof widgetBehavior.onMounted === 'function') {
+                  widgetBehavior.onMounted(_this22, config);
                 }
               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);
@@ -2906,9 +2657,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 {