@microsoft/omnichannel-chat-widget 1.8.3-main.ec1328d → 1.8.4-main.7bdb634

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/activities/LoadInlineBannerActivity.js

@@ -0,0 +1,25 @@
+import React, { useMemo } from "react";
+import { defaultInlineBannerStyle } from "../defaultStyles/defaultInLineBannerStyle";
+import { defaultMiddlewareLocalizedTexts } from "../../../../common/defaultProps/defaultMiddlewareLocalizedTexts";
+import { mergeStyles } from "@fluentui/merge-styles";
+const LoadInlineBannerActivity = _ref => {
+  let {
+    webChatContainerProps,
+    persistentChatHistory,
+    id
+  } = _ref;
+  const localizedTexts = useMemo(() => ({
+    ...defaultMiddlewareLocalizedTexts,
+    ...(webChatContainerProps === null || webChatContainerProps === void 0 ? void 0 : webChatContainerProps.localizedTexts)
+  }), [webChatContainerProps === null || webChatContainerProps === void 0 ? void 0 : webChatContainerProps.localizedTexts]);
+  const bannerStyle = mergeStyles(persistentChatHistory === null || persistentChatHistory === void 0 ? void 0 : persistentChatHistory.bannerStyle, defaultInlineBannerStyle);
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", {
+    id: id,
+    className: bannerStyle,
+    role: "status",
+    "aria-live": "polite",
+    "aria-label": localizedTexts.PREVIOUS_MESSAGES_LOADING,
+    "aria-busy": "true"
+  }, localizedTexts.PREVIOUS_MESSAGES_LOADING));
+};
+export default LoadInlineBannerActivity;

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/activityMiddleware.js

@@ -1,3 +1,5 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable react/display-name */
 /******
  * ActivityMiddleware
  * 
@@ -7,8 +9,10 @@
  * 3. Decodes certain html characters that came through from chat services
  ******/
 
+import LazyLoadActivity, { LazyLoadHandler } from "./activities/LazyLoadActivity";
 import { LogLevel, TelemetryEvent } from "../../../../../common/telemetry/TelemetryConstants";
 import { Constants } from "../../../../../common/Constants";
+import ConversationDividerActivity from "./activities/ConversationDividerActivity";
 import { DirectLineActivityType } from "../../enums/DirectLineActivityType";
 import { DirectLineSenderRole } from "../../enums/DirectLineSenderRole";
 import React from "react";
@@ -17,6 +21,7 @@ import { defaultSystemMessageStyles } from "./defaultStyles/defaultSystemMessage
 import { defaultUserMessageStyles } from "./defaultStyles/defaultUserMessageStyles";
 import { escapeHtml } from "../../../../../common/utils";
 const loggedSystemMessages = new Array();
+let lastRenderedAt = 0; // Track last rendered receivedAt timestamp for deduplication
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const handleSystemMessage = (next, args, card, renderMarkdown, systemMessageStyleProps) => {
   var _card$activity, _card$activity$channe, _card$activity$channe2, _card$activity2, _card$activity2$chann, _card$activity3, _card$activity3$chann, _card$activity3$chann2, _card$activity4, _card$activity4$chann, _card$activity5, _card$activity5$chann, _card$nextVisibleActi, _card$nextVisibleActi2, _card$activity6, _card$activity6$chann, _card$activity7, _card$nextVisibleActi3, _card$activity8;
@@ -81,6 +86,43 @@ export const createActivityMiddleware = (renderMarkdown, systemMessageStyleProps
     if (isTagIncluded(card, Constants.systemMessageTag)) {
       return handleSystemMessage(next, args, card, renderMarkdown, systemMessageStyleProps);
     }
+    if (isTagIncluded(card, Constants.persistentChatHistoryMessagePullTriggerTag)) {
+      var _card$activity9, _card$activity9$chann, _card$activity9$chann2;
+      // Safety check: if this is a new chat session and flag is false, auto-correct it
+      if (!LazyLoadHandler.hasMoreHistoryAvailable) {
+        LazyLoadHandler.setHasMoreHistoryAvailable(true);
+      }
+      const receivedAt = card === null || card === void 0 ? void 0 : (_card$activity9 = card.activity) === null || _card$activity9 === void 0 ? void 0 : (_card$activity9$chann = _card$activity9.channelData) === null || _card$activity9$chann === void 0 ? void 0 : (_card$activity9$chann2 = _card$activity9$chann.webChat) === null || _card$activity9$chann2 === void 0 ? void 0 : _card$activity9$chann2.receivedAt;
+      if (receivedAt < lastRenderedAt) {
+        card.activity = null;
+        return () => false;
+      }
+      lastRenderedAt = receivedAt;
+
+      // Return a function that checks availability at render time
+      return () => {
+        // Double-check at render time in case history availability changed
+        if (!LazyLoadHandler.hasMoreHistoryAvailable) {
+          return null;
+        }
+        return /*#__PURE__*/React.createElement(LazyLoadActivity, null);
+      };
+    }
+    if (isTagIncluded(card, Constants.persistentChatHistoryMessageTag)) {
+      const userMessageStyles = {
+        ...defaultUserMessageStyles,
+        ...userMessageStyleProps
+      };
+      return function () {
+        return /*#__PURE__*/React.createElement("div", {
+          className: card.activity.from.role === DirectLineSenderRole.User ? Constants.sentMessageClassName : Constants.receivedMessageClassName,
+          style: userMessageStyles
+        }, next(...args)(...arguments));
+      };
+    }
+    if (isTagIncluded(card, Constants.conversationDividerTag)) {
+      return /*#__PURE__*/React.createElement(ConversationDividerActivity, null);
+    }
     if (card.activity.text && card.activity.type === DirectLineActivityType.Message) {
       if (!card.activity.channelData.isHtmlEncoded && card.activity.channelId === Constants.webchatChannelId) {
         card.activity.text = escapeHtml(card.activity.text);

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/activityStatusMiddleware.js

@@ -1,5 +1,6 @@
 import { Constants, WebChatMiddlewareConstants } from "../../../../../common/Constants";
 import { DeliveredTimestamp } from "./timestamps/DeliveredTimestamp";
+import { HistoryMessageTimestamp } from "./timestamps/HistoryMessageTimestamp";
 import { NotDeliveredTimestamp } from "./timestamps/NotDeliveredTimestamp";
 import React from "react";
 import { SendStatus } from "../../enums/SendStatus";
@@ -26,6 +27,11 @@ export const activityStatusMiddleware = () => next => args => {
     current_role = role,
     current_timestamp = timestamp;
   let sameTimestampGroupTemp = sameTimestampGroup;
+  if (tags !== null && tags !== void 0 && tags.includes(Constants.persistentChatHistoryMessageTag)) {
+    return /*#__PURE__*/React.createElement(HistoryMessageTimestamp, {
+      args: args
+    });
+  }
   if (args[WebChatMiddlewareConstants.nextVisibleActivity]) {
     const {
       nextVisibleActivity: {
@@ -35,6 +41,7 @@ export const activityStatusMiddleware = () => next => args => {
         timestamp
       }
     } = args;
+
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const next_name = name,
       next_timestamp = timestamp;
@@ -61,4 +68,10 @@ export const activityStatusMiddleware = () => next => args => {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ;
   }
+};
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export const createActivityStatusMiddleware = function () {
+  let locale = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "en-us";
+  return activityStatusMiddleware;
 };

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/defaultStyles/defaultAvatarTextStyles.js

@@ -1,6 +1,6 @@
 export const defaultAvatarTextStyles = {
   margin: "0",
-  fontFamily: "\"Segoe UI\", Arial, sans-serif",
+  fontFamily: "'Segoe UI', 'Apple Color Emoji', 'Noto Color Emoji', 'Segoe UI Emoji', Arial, sans-serif",
   fontWeight: 600,
   fontSize: "13px",
   lineHeight: "18px",

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/defaultStyles/defaultInLineBannerStyle.js

@@ -0,0 +1,13 @@
+import { defaultSystemMessageStyles } from "./defaultSystemMessageStyles";
+// Adjust the import path if necessary
+
+export const defaultInlineBannerStyle = {
+  ...defaultSystemMessageStyles,
+  visibility: "visible",
+  height: "20px",
+  display: "flex",
+  justifyContent: "center",
+  alignItems: "center",
+  margin: "5px 10px",
+  cursor: "pointer"
+};

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/defaultStyles/defaultSystemMessageStyles.js

@@ -5,7 +5,7 @@ export const defaultSystemMessageStyles = {
   fontSize: "12px",
   borderRadius: 0,
   minHeight: "auto",
-  fontFamily: "Segoe UI",
+  fontFamily: "'Segoe UI', 'Apple Color Emoji', 'Noto Color Emoji', 'Segoe UI Emoji', Arial, sans-serif",
   lineHeight: "16px",
   padding: "0px 10px 0 10px"
 };

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/timestamps/DeliveredTimestamp.js

@@ -4,7 +4,7 @@ import { Stack } from "@fluentui/react";
 import { defaultMiddlewareLocalizedTexts } from "../../../../common/defaultProps/defaultMiddlewareLocalizedTexts";
 import { defaultTimestampContentStyles } from "../defaultStyles/defaultTimestampContentStyles";
 import { getTimestampHourMinute } from "../../../../../../common/utils";
-import { useChatContextStore } from "../../../../../..";
+import useChatContextStore from "../../../../../../hooks/useChatContextStore";
 
 /* eslint @typescript-eslint/no-explicit-any: "off" */
 export const DeliveredTimestamp = _ref => {

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/timestamps/HistoryMessageTimestamp.js

@@ -0,0 +1,52 @@
+import React from "react";
+import { Stack } from "@fluentui/react";
+import { defaultMiddlewareLocalizedTexts } from "../../../../common/defaultProps/defaultMiddlewareLocalizedTexts";
+import { defaultTimestampContentStyles } from "../defaultStyles/defaultTimestampContentStyles";
+import { getTimestampHourMinute } from "../../../../../../common/utils";
+import useChatContextStore from "../../../../../../hooks/useChatContextStore";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const HistoryMessageTimestamp = _ref => {
+  var _state$domainStates$r, _state$domainStates$r2, _state$domainStates$m;
+  let {
+    args
+  } = _ref;
+  const [state] = useChatContextStore();
+  const dir = ((_state$domainStates$r = state.domainStates.renderingMiddlewareProps) === null || _state$domainStates$r === void 0 ? void 0 : _state$domainStates$r.timestampDir) ?? state.domainStates.globalDir;
+  const {
+    activity: {
+      timestamp,
+      from: {
+        name,
+        role
+      }
+    }
+  } = args;
+  const contentStyles = {
+    ...defaultTimestampContentStyles,
+    ...((_state$domainStates$r2 = state.domainStates.renderingMiddlewareProps) === null || _state$domainStates$r2 === void 0 ? void 0 : _state$domainStates$r2.timestampContentStyleProps)
+  };
+  const getTimeElement = timestamp => {
+    const timeString = getTimestampHourMinute(timestamp);
+    const isAmPmFormat = timeString.toLowerCase().includes("am") || timeString.toLowerCase().includes("pm");
+    if (dir === "rtl" && isAmPmFormat) {
+      return /*#__PURE__*/React.createElement("span", {
+        dir: "ltr"
+      }, timeString);
+    } else {
+      return /*#__PURE__*/React.createElement("span", {
+        dir: dir
+      }, timeString);
+    }
+  };
+  return /*#__PURE__*/React.createElement(Stack, {
+    style: contentStyles,
+    dir: dir
+  }, role === "bot" && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("span", {
+    dir: dir,
+    "aria-hidden": "false"
+  }, name, " : ", getTimeElement(timestamp))), role === "user" && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("span", {
+    "aria-hidden": "false",
+    dir: dir
+  }, " ", getTimeElement(timestamp), " - ", ((_state$domainStates$m = state.domainStates.middlewareLocalizedTexts) === null || _state$domainStates$m === void 0 ? void 0 : _state$domainStates$m.MIDDLEWARE_MESSAGE_DELIVERED) ?? defaultMiddlewareLocalizedTexts.MIDDLEWARE_MESSAGE_DELIVERED), "            "));
+};

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/timestamps/NotDeliveredTimestamp.js

@@ -7,9 +7,9 @@ import { defaultTimestampFailedStyles } from "../defaultStyles/defaultTimestampF
 import { defaultTimestampRetryStyles } from "../defaultStyles/defaultTimestampRetryStyles";
 import { getTimestampHourMinute } from "../../../../../../common/utils";
 import { hooks } from "botframework-webchat";
-import { useChatContextStore } from "../../../../../..";
+import useChatContextStore from "../../../../../../hooks/useChatContextStore";
 
-/* eslint @typescript-eslint/no-explicit-any: "off" */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const NotDeliveredTimestamp = _ref => {
   var _state$domainStates$r, _state$domainStates$r2, _state$domainStates$r3, _state$domainStates$r4, _state$domainStates$m, _state$domainStates$m2;
   let {

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/timestamps/SendingTimestamp.js

@@ -2,7 +2,7 @@ import React from "react";
 import { Stack } from "@fluentui/react";
 import { defaultMiddlewareLocalizedTexts } from "../../../../common/defaultProps/defaultMiddlewareLocalizedTexts";
 import { defaultTimestampContentStyles } from "../defaultStyles/defaultTimestampContentStyles";
-import { useChatContextStore } from "../../../../../..";
+import useChatContextStore from "../../../../../../hooks/useChatContextStore";
 
 /* eslint @typescript-eslint/no-explicit-any: "off" */
 export const SendingTimestamp = () => {

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/citationsMiddleware.js

@@ -1,56 +1,125 @@
 import { LogLevel, TelemetryEvent } from "../../../../../common/telemetry/TelemetryConstants";
+import { LiveChatWidgetActionType } from "../../../../../contexts/common/LiveChatWidgetActionType";
 import { TelemetryHelper } from "../../../../../common/telemetry/TelemetryHelper";
-export const createCitationsMiddleware = _ref => {
-  let {
-    dispatch
-  } = _ref;
-  return next => action => {
-    var _action$payload;
-    if ((_action$payload = action.payload) !== null && _action$payload !== void 0 && _action$payload.activity) {
-      if (isApplicable(action)) {
+import { executeReducer } from "../../../../../contexts/createReducer";
+
+// Middleware that extracts citation metadata from incoming ACS activities and
+// updates in-memory app state with a global citation map. Also rewrites
+// per-message citation labels in the activity text to use a stable,
+// message-scoped prefix when the producer provides a message id.
+
+export const createCitationsMiddleware = (state, dispatch) => () => next => action => {
+  var _action$payload;
+  if ((_action$payload = action.payload) !== null && _action$payload !== void 0 && _action$payload.activity) {
+    if (isApplicable(action)) {
+      try {
+        var _action$payload2, _action$payload2$acti, _gptFeedback$summariz, _gptFeedback$summariz2;
+        const inMemoryState = executeReducer(state, {
+          type: LiveChatWidgetActionType.GET_IN_MEMORY_STATE,
+          payload: null
+        });
+
+        // Use the producer-supplied messageid as a stable per-message prefix
+        // when present. Do not derive a prefix from activity.id or timestamps.
+        const messagePrefix = ((_action$payload2 = action.payload) === null || _action$payload2 === void 0 ? void 0 : (_action$payload2$acti = _action$payload2.activity) === null || _action$payload2$acti === void 0 ? void 0 : _action$payload2$acti.messageid) ?? "";
+        const gptFeedback = JSON.parse(action.payload.activity.channelData.metadata["pva:gpt-feedback"]);
+        // Extract citation objects from the model response
+        const citations = (_gptFeedback$summariz = gptFeedback.summarizationOpenAIResponse) === null || _gptFeedback$summariz === void 0 ? void 0 : (_gptFeedback$summariz2 = _gptFeedback$summariz.result) === null || _gptFeedback$summariz2 === void 0 ? void 0 : _gptFeedback$summariz2.textCitations;
+        // Rewrite inline citation labels in activity.text to match the global map keys
+        const updatedText = replaceCitations(action.payload.activity.text, citations, messagePrefix);
+        action.payload.activity.text = updatedText;
+        // Build a global citation map keyed by the prefixed citation id and
+        // dispatch it to app state so the UI container can render citations.
         try {
-          const gptFeedback = JSON.parse(action.payload.activity.channelData.metadata["pva:gpt-feedback"]);
-          // Replace citations in the text
-          const updatedText = replaceCitations(action.payload.activity.text, gptFeedback.summarizationOpenAIResponse.result.textCitations);
-          action.payload.activity.text = updatedText;
-        } catch (error) {
-          TelemetryHelper.logActionEvent(LogLevel.ERROR, {
+          var _inMemoryState$domain;
+          const citationMap = {};
+          if (citations && Array.isArray(citations)) {
+            citations.forEach(citation => {
+              if (citation !== null && citation !== void 0 && citation.id) {
+                // Preserve the 'cite:' scheme so renderer click handling remains consistent
+                const idWithoutScheme = citation.id.replace(/^cite:/, "");
+                const prefixedId = `cite:${messagePrefix}_${idWithoutScheme}`;
+                citationMap[prefixedId] = citation.text || citation.title || "";
+              }
+            });
+          }
+
+          // Read current in-memory state to merge with existing citations
+          //const inMemoryState = executeReducer(state, { type: LiveChatWidgetActionType.GET_IN_MEMORY_STATE, payload: null });
+          const existingCitations = (inMemoryState === null || inMemoryState === void 0 ? void 0 : (_inMemoryState$domain = inMemoryState.domainStates) === null || _inMemoryState$domain === void 0 ? void 0 : _inMemoryState$domain.citations) || {};
+          const updatedCitations = {
+            ...existingCitations,
+            ...citationMap
+          };
+          // Always dispatch to app state
+          dispatch({
+            type: LiveChatWidgetActionType.SET_CITATIONS,
+            payload: updatedCitations
+          });
+        } catch (innerErr) {
+          TelemetryHelper.logActionEvent(LogLevel.WARN, {
             Event: TelemetryEvent.CitationMiddlewareFailed,
             ExceptionDetails: {
-              ErrorData: "Error while converting citation labels",
-              Exception: error
+              ErrorData: "Error while populating citation map",
+              Exception: innerErr
             }
           });
         }
+      } catch (error) {
+        TelemetryHelper.logActionEvent(LogLevel.ERROR, {
+          Event: TelemetryEvent.CitationMiddlewareFailed,
+          ExceptionDetails: {
+            ErrorData: "Error while converting citation labels",
+            Exception: error
+          }
+        });
       }
     }
-    return next(action);
-  };
+  }
+  return next(action);
 };
 const isApplicable = action => {
-  var _action$payload2, _action$payload2$acti, _action$payload3, _action$payload3$acti;
-  if ((action === null || action === void 0 ? void 0 : (_action$payload2 = action.payload) === null || _action$payload2 === void 0 ? void 0 : (_action$payload2$acti = _action$payload2.activity) === null || _action$payload2$acti === void 0 ? void 0 : _action$payload2$acti.actionType) === "DIRECT_LINE/INCOMING_ACTIVITY" && (action === null || action === void 0 ? void 0 : (_action$payload3 = action.payload) === null || _action$payload3 === void 0 ? void 0 : (_action$payload3$acti = _action$payload3.activity) === null || _action$payload3$acti === void 0 ? void 0 : _action$payload3$acti.channelId) === "ACS_CHANNEL") {
-    var _action$payload4, _action$payload4$acti, _action$payload4$acti2, _action$payload4$acti3;
-    // Validate if pva:gpt-feedback exists and is not null
-    if (action !== null && action !== void 0 && (_action$payload4 = action.payload) !== null && _action$payload4 !== void 0 && (_action$payload4$acti = _action$payload4.activity) !== null && _action$payload4$acti !== void 0 && (_action$payload4$acti2 = _action$payload4$acti.channelData) !== null && _action$payload4$acti2 !== void 0 && (_action$payload4$acti3 = _action$payload4$acti2.metadata) !== null && _action$payload4$acti3 !== void 0 && _action$payload4$acti3["pva:gpt-feedback"]) {
+  var _action$payload3, _action$payload3$acti, _action$payload4, _action$payload4$acti;
+  if ((action === null || action === void 0 ? void 0 : (_action$payload3 = action.payload) === null || _action$payload3 === void 0 ? void 0 : (_action$payload3$acti = _action$payload3.activity) === null || _action$payload3$acti === void 0 ? void 0 : _action$payload3$acti.actionType) === "DIRECT_LINE/INCOMING_ACTIVITY" && (action === null || action === void 0 ? void 0 : (_action$payload4 = action.payload) === null || _action$payload4 === void 0 ? void 0 : (_action$payload4$acti = _action$payload4.activity) === null || _action$payload4$acti === void 0 ? void 0 : _action$payload4$acti.channelId) === "ACS_CHANNEL") {
+    var _action$payload5, _action$payload5$acti, _action$payload5$acti2, _action$payload5$acti3;
+    // Only applicable for ACS incoming activities that include pva:gpt-feedback
+    if (action !== null && action !== void 0 && (_action$payload5 = action.payload) !== null && _action$payload5 !== void 0 && (_action$payload5$acti = _action$payload5.activity) !== null && _action$payload5$acti !== void 0 && (_action$payload5$acti2 = _action$payload5$acti.channelData) !== null && _action$payload5$acti2 !== void 0 && (_action$payload5$acti3 = _action$payload5$acti2.metadata) !== null && _action$payload5$acti3 !== void 0 && _action$payload5$acti3["pva:gpt-feedback"]) {
       return true;
     }
   }
   return false;
 };
-const replaceCitations = (text, citations) => {
+const replaceCitations = (text, citations, messagePrefix) => {
   if (!citations || !Array.isArray(citations)) {
     return text;
   }
   try {
-    return text.replace(/\[(\d+)\]:\s(cite:\d+)\s"([^"]+)"/g, (match, number, citeId) => {
-      const citation = citations.find(c => c.id === citeId);
+    let updatedText = text;
+
+    // First, handle the citation reference definitions at the end (e.g., [1]: cite:1757450535119_1 "index.html")
+    // These should NOT be escaped as they are proper citation definitions
+    updatedText = updatedText.replace(/\[(\d+)\]:\s(cite:\d+)\s"([^\\"]+)"/g, (match, number, citeId) => {
+      // Attempt to find a citation object matching the inline cite id and
+      // update the displayed id/title. When a messagePrefix exists we
+      // rewrite the id to the prefixed form so it aligns with the
+      // global citation map keys.
+      const lookupId = citeId;
+      const citation = citations.find(c => c.id === lookupId);
       if (citation) {
-        // Replace only the citation label while preserving the original format
-        return `[${number}]: ${citeId} "${citation.title}"`;
+        const idWithoutScheme = citeId.replace(/^cite:/, "");
+        const prefixed = messagePrefix ? `cite:${messagePrefix}_${idWithoutScheme}` : citeId;
+        return `[${number}]: ${prefixed} "${citation.title}"`;
       }
-      return match; // Keep the original match if no replacement is found
+      return match;
+    });
+
+    // Second, escape inline citation references that are NOT followed by a colon
+    // This handles cases like "[1][2]"" in the middle of text that should be escaped for markdown
+    updatedText = updatedText.replace(/\[(\d+)\](?!:)/g, (match, number) => {
+      // Escape the brackets to prevent markdown from treating them as incomplete link syntax
+      return `[${number}]`;
     });
+    return updatedText;
   } catch (error) {
     TelemetryHelper.logActionEvent(LogLevel.ERROR, {
       Event: TelemetryEvent.CitationMiddlewareFailed,
@@ -59,7 +128,6 @@ const replaceCitations = (text, citations) => {
         Exception: error
       }
     });
-    // Return the original text in case of issues
     return text;
   }
 };

package/lib/esm/components/webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/queueOverflowHandlerMiddleware.js

@@ -1,7 +1,7 @@
-import { WebChatActionType } from "../../enums/WebChatActionType";
 import { LogLevel, TelemetryEvent } from "../../../../../common/telemetry/TelemetryConstants";
-import { TelemetryHelper } from "../../../../../common/telemetry/TelemetryHelper";
 import { LiveChatWidgetActionType } from "../../../../../contexts/common/LiveChatWidgetActionType";
+import { TelemetryHelper } from "../../../../../common/telemetry/TelemetryHelper";
+import { WebChatActionType } from "../../enums/WebChatActionType";
 import { executeReducer } from "../../../../../contexts/createReducer";
 import { isEndConversationDueToOverflowActivity } from "../../../../../common/utils";
 const queueOverflowHandlingHelper = async (state, dispatch) => {

package/lib/esm/contexts/common/LiveChatWidgetActionType.js

@@ -3,49 +3,50 @@ export let LiveChatWidgetActionType;
   LiveChatWidgetActionType[LiveChatWidgetActionType["SET_WIDGET_ELEMENT_ID"] = 0] = "SET_WIDGET_ELEMENT_ID";
   LiveChatWidgetActionType[LiveChatWidgetActionType["SET_RENDERING_MIDDLEWARE_PROPS"] = 1] = "SET_RENDERING_MIDDLEWARE_PROPS";
   LiveChatWidgetActionType[LiveChatWidgetActionType["SET_MIDDLEWARE_LOCALIZED_TEXTS"] = 2] = "SET_MIDDLEWARE_LOCALIZED_TEXTS";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_GLOBAL_DIR"] = 3] = "SET_GLOBAL_DIR";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_MINIMIZED"] = 4] = "SET_MINIMIZED";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATION_STATE"] = 5] = "SET_CONVERSATION_STATE";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_PREVIOUS_FOCUSED_ELEMENT_ID"] = 6] = "SET_PREVIOUS_FOCUSED_ELEMENT_ID";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_START_CHAT_FAILING"] = 7] = "SET_START_CHAT_FAILING";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_START_CHAT_FAILURE_TYPE"] = 8] = "SET_START_CHAT_FAILURE_TYPE";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_OUTSIDE_OPERATING_HOURS"] = 9] = "SET_OUTSIDE_OPERATING_HOURS";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_PRE_CHAT_SURVEY_RESPONSE"] = 10] = "SET_PRE_CHAT_SURVEY_RESPONSE";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CUSTOM_CONTEXT"] = 11] = "SET_CUSTOM_CONTEXT";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_SHOW_CONFIRMATION"] = 12] = "SET_SHOW_CONFIRMATION";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_SHOW_EMAIL_TRANSCRIPT_PANE"] = 13] = "SET_SHOW_EMAIL_TRANSCRIPT_PANE";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_PRECHAT_RESPONSE_EMAIL"] = 14] = "SET_PRECHAT_RESPONSE_EMAIL";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_AUDIO_NOTIFICATION"] = 15] = "SET_AUDIO_NOTIFICATION";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_E2VV_ENABLED"] = 16] = "SET_E2VV_ENABLED";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_POST_CHAT_CONTEXT"] = 17] = "SET_POST_CHAT_CONTEXT";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SHOW_CALLING_CONTAINER"] = 18] = "SHOW_CALLING_CONTAINER";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_INCOMING_CALL"] = 19] = "SET_INCOMING_CALL";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["DISABLE_VIDEO_CALL"] = 20] = "DISABLE_VIDEO_CALL";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["DISABLE_LOCAL_VIDEO"] = 21] = "DISABLE_LOCAL_VIDEO";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["DISABLE_REMOTE_VIDEO"] = 22] = "DISABLE_REMOTE_VIDEO";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CHAT_TOKEN"] = 23] = "SET_CHAT_TOKEN";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_START_CHAT_BUTTON_DISPLAY"] = 24] = "SET_START_CHAT_BUTTON_DISPLAY";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_PROACTIVE_CHAT_PARAMS"] = 25] = "SET_PROACTIVE_CHAT_PARAMS";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_TELEMETRY_DATA"] = 26] = "SET_TELEMETRY_DATA";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_RECONNECT_ID"] = 27] = "SET_RECONNECT_ID";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_UNREAD_MESSAGE_COUNT"] = 28] = "SET_UNREAD_MESSAGE_COUNT";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_FOCUS_CHAT_BUTTON"] = 29] = "SET_FOCUS_CHAT_BUTTON";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATION_ENDED_BY_AGENT_EVENT_RECEIVED"] = 30] = "SET_CONVERSATION_ENDED_BY_AGENT_EVENT_RECEIVED";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATION_ENDED_BY"] = 31] = "SET_CONVERSATION_ENDED_BY";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_WIDGET_STATE"] = 32] = "SET_WIDGET_STATE";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_LIVE_CHAT_CONTEXT"] = 33] = "SET_LIVE_CHAT_CONTEXT";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_BOT_OAUTH_SIGNIN_ID"] = 34] = "SET_BOT_OAUTH_SIGNIN_ID";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_WIDGET_SIZE"] = 35] = "SET_WIDGET_SIZE";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_WIDGET_INSTANCE_ID"] = 36] = "SET_WIDGET_INSTANCE_ID";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_LIVE_CHAT_CONFIG"] = 37] = "SET_LIVE_CHAT_CONFIG";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_POST_CHAT_WORKFLOW_IN_PROGRESS"] = 38] = "SET_POST_CHAT_WORKFLOW_IN_PROGRESS";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_INITIAL_CHAT_SDK_REQUEST_ID"] = 39] = "SET_INITIAL_CHAT_SDK_REQUEST_ID";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_SHOULD_USE_BOT_SURVEY"] = 40] = "SET_SHOULD_USE_BOT_SURVEY";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CHAT_DISCONNECT_EVENT_RECEIVED"] = 41] = "SET_CHAT_DISCONNECT_EVENT_RECEIVED";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_SURVEY_MODE"] = 42] = "SET_SURVEY_MODE";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONFIRMATION_STATE"] = 43] = "SET_CONFIRMATION_STATE";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_POST_CHAT_PARTICIPANT_TYPE"] = 44] = "SET_POST_CHAT_PARTICIPANT_TYPE";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATIONAL_SURVEY_ENABLED"] = 45] = "SET_CONVERSATIONAL_SURVEY_ENABLED";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATIONAL_SURVEY_DISPLAY"] = 46] = "SET_CONVERSATIONAL_SURVEY_DISPLAY";
-  LiveChatWidgetActionType[LiveChatWidgetActionType["GET_IN_MEMORY_STATE"] = 47] = "GET_IN_MEMORY_STATE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CITATIONS"] = 3] = "SET_CITATIONS";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_GLOBAL_DIR"] = 4] = "SET_GLOBAL_DIR";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_MINIMIZED"] = 5] = "SET_MINIMIZED";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATION_STATE"] = 6] = "SET_CONVERSATION_STATE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_PREVIOUS_FOCUSED_ELEMENT_ID"] = 7] = "SET_PREVIOUS_FOCUSED_ELEMENT_ID";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_START_CHAT_FAILING"] = 8] = "SET_START_CHAT_FAILING";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_START_CHAT_FAILURE_TYPE"] = 9] = "SET_START_CHAT_FAILURE_TYPE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_OUTSIDE_OPERATING_HOURS"] = 10] = "SET_OUTSIDE_OPERATING_HOURS";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_PRE_CHAT_SURVEY_RESPONSE"] = 11] = "SET_PRE_CHAT_SURVEY_RESPONSE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CUSTOM_CONTEXT"] = 12] = "SET_CUSTOM_CONTEXT";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_SHOW_CONFIRMATION"] = 13] = "SET_SHOW_CONFIRMATION";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_SHOW_EMAIL_TRANSCRIPT_PANE"] = 14] = "SET_SHOW_EMAIL_TRANSCRIPT_PANE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_PRECHAT_RESPONSE_EMAIL"] = 15] = "SET_PRECHAT_RESPONSE_EMAIL";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_AUDIO_NOTIFICATION"] = 16] = "SET_AUDIO_NOTIFICATION";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_E2VV_ENABLED"] = 17] = "SET_E2VV_ENABLED";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_POST_CHAT_CONTEXT"] = 18] = "SET_POST_CHAT_CONTEXT";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SHOW_CALLING_CONTAINER"] = 19] = "SHOW_CALLING_CONTAINER";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_INCOMING_CALL"] = 20] = "SET_INCOMING_CALL";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["DISABLE_VIDEO_CALL"] = 21] = "DISABLE_VIDEO_CALL";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["DISABLE_LOCAL_VIDEO"] = 22] = "DISABLE_LOCAL_VIDEO";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["DISABLE_REMOTE_VIDEO"] = 23] = "DISABLE_REMOTE_VIDEO";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CHAT_TOKEN"] = 24] = "SET_CHAT_TOKEN";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_START_CHAT_BUTTON_DISPLAY"] = 25] = "SET_START_CHAT_BUTTON_DISPLAY";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_PROACTIVE_CHAT_PARAMS"] = 26] = "SET_PROACTIVE_CHAT_PARAMS";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_TELEMETRY_DATA"] = 27] = "SET_TELEMETRY_DATA";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_RECONNECT_ID"] = 28] = "SET_RECONNECT_ID";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_UNREAD_MESSAGE_COUNT"] = 29] = "SET_UNREAD_MESSAGE_COUNT";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_FOCUS_CHAT_BUTTON"] = 30] = "SET_FOCUS_CHAT_BUTTON";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATION_ENDED_BY_AGENT_EVENT_RECEIVED"] = 31] = "SET_CONVERSATION_ENDED_BY_AGENT_EVENT_RECEIVED";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATION_ENDED_BY"] = 32] = "SET_CONVERSATION_ENDED_BY";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_WIDGET_STATE"] = 33] = "SET_WIDGET_STATE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_LIVE_CHAT_CONTEXT"] = 34] = "SET_LIVE_CHAT_CONTEXT";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_BOT_OAUTH_SIGNIN_ID"] = 35] = "SET_BOT_OAUTH_SIGNIN_ID";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_WIDGET_SIZE"] = 36] = "SET_WIDGET_SIZE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_WIDGET_INSTANCE_ID"] = 37] = "SET_WIDGET_INSTANCE_ID";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_LIVE_CHAT_CONFIG"] = 38] = "SET_LIVE_CHAT_CONFIG";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_POST_CHAT_WORKFLOW_IN_PROGRESS"] = 39] = "SET_POST_CHAT_WORKFLOW_IN_PROGRESS";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_INITIAL_CHAT_SDK_REQUEST_ID"] = 40] = "SET_INITIAL_CHAT_SDK_REQUEST_ID";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_SHOULD_USE_BOT_SURVEY"] = 41] = "SET_SHOULD_USE_BOT_SURVEY";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CHAT_DISCONNECT_EVENT_RECEIVED"] = 42] = "SET_CHAT_DISCONNECT_EVENT_RECEIVED";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_SURVEY_MODE"] = 43] = "SET_SURVEY_MODE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONFIRMATION_STATE"] = 44] = "SET_CONFIRMATION_STATE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_POST_CHAT_PARTICIPANT_TYPE"] = 45] = "SET_POST_CHAT_PARTICIPANT_TYPE";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATIONAL_SURVEY_ENABLED"] = 46] = "SET_CONVERSATIONAL_SURVEY_ENABLED";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["SET_CONVERSATIONAL_SURVEY_DISPLAY"] = 47] = "SET_CONVERSATIONAL_SURVEY_DISPLAY";
+  LiveChatWidgetActionType[LiveChatWidgetActionType["GET_IN_MEMORY_STATE"] = 48] = "GET_IN_MEMORY_STATE";
 })(LiveChatWidgetActionType || (LiveChatWidgetActionType = {}));

package/lib/esm/contexts/common/LiveChatWidgetContextInitialState.js

@@ -39,6 +39,8 @@ export const getLiveChatWidgetContextInitialState = props => {
     domainStates: {
       liveChatConfig: props.chatConfig,
       widgetElementId: "",
+      // Map of citation id => content injected by citations middleware
+      citations: {},
       renderingMiddlewareProps: (_props$webChatContain = props.webChatContainerProps) === null || _props$webChatContain === void 0 ? void 0 : _props$webChatContain.renderingMiddlewareProps,
       middlewareLocalizedTexts: defaultMiddlewareLocalizedTexts,
       preChatSurveyResponse: "{}",

package/lib/esm/contexts/createReducer.js

@@ -62,6 +62,21 @@ const reducer = (state, action) => {
           middlewareLocalizedTexts: action.payload
         }
       };
+    case LiveChatWidgetActionType.SET_CITATIONS:
+      inMemory = {
+        ...inMemory,
+        domainStates: {
+          ...inMemory.domainStates,
+          citations: action.payload
+        }
+      };
+      return {
+        ...state,
+        domainStates: {
+          ...state.domainStates,
+          citations: action.payload
+        }
+      };
     case LiveChatWidgetActionType.SET_GLOBAL_DIR:
       inMemory = {
         ...inMemory,

package/lib/esm/index.js

@@ -7,5 +7,6 @@ import useFacadeChatSDKStore from "./hooks/useFacadeChatSDKStore";
 export { default as LiveChatWidget } from "./components/livechatwidget/LiveChatWidget";
 export { getMockChatSDKIfApplicable } from "./components/livechatwidget/common/getMockChatSDKIfApplicable";
 export { getWidgetCacheId, getWidgetEndChatEventName, ConversationState };
+export { LiveChatWidgetMockType } from "./components/livechatwidget/interfaces/IMockProps";
 export { encodeComponentString, decodeComponentString, BroadcastService, useChatSDKStore, useChatContextStore, useFacadeChatSDKStore };
 export * from "./components/webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares";

package/lib/types/common/Constants.d.ts

@@ -28,6 +28,9 @@ export declare class Constants {
     static readonly channelIdKey = "ChannelId-";
     static readonly ChannelId = "lcw";
     static readonly CustomerTag = "FromCustomer";
+    static persistentChatHistoryMessageTag: string;
+    static persistentChatHistoryMessagePullTriggerTag: string;
+    static conversationDividerTag: string;
     static readonly GifContentType = "image/gif";
     static readonly video = "video";
     static readonly audio = "audio";
@@ -153,6 +156,8 @@ export declare class HtmlAttributeNames {
     static readonly adaptiveCardTextBlockClassName = "ac-textBlock";
     static readonly adaptiveCardToggleInputClassName = "ac-toggleInput";
     static readonly adaptiveCardActionSetClassName = "ac-actionSet";
+    static readonly ocwCitationPaneClassName = "ocw-citation-pane";
+    static readonly ocwCitationPaneTitle = "Citation";
 }
 export declare class WebChatMiddlewareConstants {
     static readonly nextVisibleActivity = "nextVisibleActivity";